diff --git a/yap_lab_3/.venv/bin/Activate.ps1 b/yap_lab_3/.venv/bin/Activate.ps1 new file mode 100644 index 0000000..b49d77b --- /dev/null +++ b/yap_lab_3/.venv/bin/Activate.ps1 @@ -0,0 +1,247 @@ +<# +.Synopsis +Activate a Python virtual environment for the current PowerShell session. + +.Description +Pushes the python executable for a virtual environment to the front of the +$Env:PATH environment variable and sets the prompt to signify that you are +in a Python virtual environment. Makes use of the command line switches as +well as the `pyvenv.cfg` file values present in the virtual environment. + +.Parameter VenvDir +Path to the directory that contains the virtual environment to activate. The +default value for this is the parent of the directory that the Activate.ps1 +script is located within. + +.Parameter Prompt +The prompt prefix to display when this virtual environment is activated. By +default, this prompt is the name of the virtual environment folder (VenvDir) +surrounded by parentheses and followed by a single space (ie. '(.venv) '). + +.Example +Activate.ps1 +Activates the Python virtual environment that contains the Activate.ps1 script. + +.Example +Activate.ps1 -Verbose +Activates the Python virtual environment that contains the Activate.ps1 script, +and shows extra information about the activation as it executes. + +.Example +Activate.ps1 -VenvDir C:\Users\MyUser\Common\.venv +Activates the Python virtual environment located in the specified location. + +.Example +Activate.ps1 -Prompt "MyPython" +Activates the Python virtual environment that contains the Activate.ps1 script, +and prefixes the current prompt with the specified string (surrounded in +parentheses) while the virtual environment is active. + +.Notes +On Windows, it may be required to enable this Activate.ps1 script by setting the +execution policy for the user. You can do this by issuing the following PowerShell +command: + +PS C:\> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser + +For more information on Execution Policies: +https://go.microsoft.com/fwlink/?LinkID=135170 + +#> +Param( + [Parameter(Mandatory = $false)] + [String] + $VenvDir, + [Parameter(Mandatory = $false)] + [String] + $Prompt +) + +<# Function declarations --------------------------------------------------- #> + +<# +.Synopsis +Remove all shell session elements added by the Activate script, including the +addition of the virtual environment's Python executable from the beginning of +the PATH variable. + +.Parameter NonDestructive +If present, do not remove this function from the global namespace for the +session. + +#> +function global:deactivate ([switch]$NonDestructive) { + # Revert to original values + + # The prior prompt: + if (Test-Path -Path Function:_OLD_VIRTUAL_PROMPT) { + Copy-Item -Path Function:_OLD_VIRTUAL_PROMPT -Destination Function:prompt + Remove-Item -Path Function:_OLD_VIRTUAL_PROMPT + } + + # The prior PYTHONHOME: + if (Test-Path -Path Env:_OLD_VIRTUAL_PYTHONHOME) { + Copy-Item -Path Env:_OLD_VIRTUAL_PYTHONHOME -Destination Env:PYTHONHOME + Remove-Item -Path Env:_OLD_VIRTUAL_PYTHONHOME + } + + # The prior PATH: + if (Test-Path -Path Env:_OLD_VIRTUAL_PATH) { + Copy-Item -Path Env:_OLD_VIRTUAL_PATH -Destination Env:PATH + Remove-Item -Path Env:_OLD_VIRTUAL_PATH + } + + # Just remove the VIRTUAL_ENV altogether: + if (Test-Path -Path Env:VIRTUAL_ENV) { + Remove-Item -Path env:VIRTUAL_ENV + } + + # Just remove VIRTUAL_ENV_PROMPT altogether. + if (Test-Path -Path Env:VIRTUAL_ENV_PROMPT) { + Remove-Item -Path env:VIRTUAL_ENV_PROMPT + } + + # Just remove the _PYTHON_VENV_PROMPT_PREFIX altogether: + if (Get-Variable -Name "_PYTHON_VENV_PROMPT_PREFIX" -ErrorAction SilentlyContinue) { + Remove-Variable -Name _PYTHON_VENV_PROMPT_PREFIX -Scope Global -Force + } + + # Leave deactivate function in the global namespace if requested: + if (-not $NonDestructive) { + Remove-Item -Path function:deactivate + } +} + +<# +.Description +Get-PyVenvConfig parses the values from the pyvenv.cfg file located in the +given folder, and returns them in a map. + +For each line in the pyvenv.cfg file, if that line can be parsed into exactly +two strings separated by `=` (with any amount of whitespace surrounding the =) +then it is considered a `key = value` line. The left hand string is the key, +the right hand is the value. + +If the value starts with a `'` or a `"` then the first and last character is +stripped from the value before being captured. + +.Parameter ConfigDir +Path to the directory that contains the `pyvenv.cfg` file. +#> +function Get-PyVenvConfig( + [String] + $ConfigDir +) { + Write-Verbose "Given ConfigDir=$ConfigDir, obtain values in pyvenv.cfg" + + # Ensure the file exists, and issue a warning if it doesn't (but still allow the function to continue). + $pyvenvConfigPath = Join-Path -Resolve -Path $ConfigDir -ChildPath 'pyvenv.cfg' -ErrorAction Continue + + # An empty map will be returned if no config file is found. + $pyvenvConfig = @{ } + + if ($pyvenvConfigPath) { + + Write-Verbose "File exists, parse `key = value` lines" + $pyvenvConfigContent = Get-Content -Path $pyvenvConfigPath + + $pyvenvConfigContent | ForEach-Object { + $keyval = $PSItem -split "\s*=\s*", 2 + if ($keyval[0] -and $keyval[1]) { + $val = $keyval[1] + + # Remove extraneous quotations around a string value. + if ("'""".Contains($val.Substring(0, 1))) { + $val = $val.Substring(1, $val.Length - 2) + } + + $pyvenvConfig[$keyval[0]] = $val + Write-Verbose "Adding Key: '$($keyval[0])'='$val'" + } + } + } + return $pyvenvConfig +} + + +<# Begin Activate script --------------------------------------------------- #> + +# Determine the containing directory of this script +$VenvExecPath = Split-Path -Parent $MyInvocation.MyCommand.Definition +$VenvExecDir = Get-Item -Path $VenvExecPath + +Write-Verbose "Activation script is located in path: '$VenvExecPath'" +Write-Verbose "VenvExecDir Fullname: '$($VenvExecDir.FullName)" +Write-Verbose "VenvExecDir Name: '$($VenvExecDir.Name)" + +# Set values required in priority: CmdLine, ConfigFile, Default +# First, get the location of the virtual environment, it might not be +# VenvExecDir if specified on the command line. +if ($VenvDir) { + Write-Verbose "VenvDir given as parameter, using '$VenvDir' to determine values" +} +else { + Write-Verbose "VenvDir not given as a parameter, using parent directory name as VenvDir." + $VenvDir = $VenvExecDir.Parent.FullName.TrimEnd("\\/") + Write-Verbose "VenvDir=$VenvDir" +} + +# Next, read the `pyvenv.cfg` file to determine any required value such +# as `prompt`. +$pyvenvCfg = Get-PyVenvConfig -ConfigDir $VenvDir + +# Next, set the prompt from the command line, or the config file, or +# just use the name of the virtual environment folder. +if ($Prompt) { + Write-Verbose "Prompt specified as argument, using '$Prompt'" +} +else { + Write-Verbose "Prompt not specified as argument to script, checking pyvenv.cfg value" + if ($pyvenvCfg -and $pyvenvCfg['prompt']) { + Write-Verbose " Setting based on value in pyvenv.cfg='$($pyvenvCfg['prompt'])'" + $Prompt = $pyvenvCfg['prompt']; + } + else { + Write-Verbose " Setting prompt based on parent's directory's name. (Is the directory name passed to venv module when creating the virtual environment)" + Write-Verbose " Got leaf-name of $VenvDir='$(Split-Path -Path $venvDir -Leaf)'" + $Prompt = Split-Path -Path $venvDir -Leaf + } +} + +Write-Verbose "Prompt = '$Prompt'" +Write-Verbose "VenvDir='$VenvDir'" + +# Deactivate any currently active virtual environment, but leave the +# deactivate function in place. +deactivate -nondestructive + +# Now set the environment variable VIRTUAL_ENV, used by many tools to determine +# that there is an activated venv. +$env:VIRTUAL_ENV = $VenvDir + +if (-not $Env:VIRTUAL_ENV_DISABLE_PROMPT) { + + Write-Verbose "Setting prompt to '$Prompt'" + + # Set the prompt to include the env name + # Make sure _OLD_VIRTUAL_PROMPT is global + function global:_OLD_VIRTUAL_PROMPT { "" } + Copy-Item -Path function:prompt -Destination function:_OLD_VIRTUAL_PROMPT + New-Variable -Name _PYTHON_VENV_PROMPT_PREFIX -Description "Python virtual environment prompt prefix" -Scope Global -Option ReadOnly -Visibility Public -Value $Prompt + + function global:prompt { + Write-Host -NoNewline -ForegroundColor Green "($_PYTHON_VENV_PROMPT_PREFIX) " + _OLD_VIRTUAL_PROMPT + } + $env:VIRTUAL_ENV_PROMPT = $Prompt +} + +# Clear PYTHONHOME +if (Test-Path -Path Env:PYTHONHOME) { + Copy-Item -Path Env:PYTHONHOME -Destination Env:_OLD_VIRTUAL_PYTHONHOME + Remove-Item -Path Env:PYTHONHOME +} + +# Add the venv to the PATH +Copy-Item -Path Env:PATH -Destination Env:_OLD_VIRTUAL_PATH +$Env:PATH = "$VenvExecDir$([System.IO.Path]::PathSeparator)$Env:PATH" diff --git a/yap_lab_3/.venv/bin/activate b/yap_lab_3/.venv/bin/activate new file mode 100644 index 0000000..9990b2c --- /dev/null +++ b/yap_lab_3/.venv/bin/activate @@ -0,0 +1,70 @@ +# This file must be used with "source bin/activate" *from bash* +# You cannot run it directly + +deactivate () { + # reset old environment variables + if [ -n "${_OLD_VIRTUAL_PATH:-}" ] ; then + PATH="${_OLD_VIRTUAL_PATH:-}" + export PATH + unset _OLD_VIRTUAL_PATH + fi + if [ -n "${_OLD_VIRTUAL_PYTHONHOME:-}" ] ; then + PYTHONHOME="${_OLD_VIRTUAL_PYTHONHOME:-}" + export PYTHONHOME + unset _OLD_VIRTUAL_PYTHONHOME + fi + + # Call hash to forget past commands. Without forgetting + # past commands the $PATH changes we made may not be respected + hash -r 2> /dev/null + + if [ -n "${_OLD_VIRTUAL_PS1:-}" ] ; then + PS1="${_OLD_VIRTUAL_PS1:-}" + export PS1 + unset _OLD_VIRTUAL_PS1 + fi + + unset VIRTUAL_ENV + unset VIRTUAL_ENV_PROMPT + if [ ! "${1:-}" = "nondestructive" ] ; then + # Self destruct! + unset -f deactivate + fi +} + +# unset irrelevant variables +deactivate nondestructive + +# on Windows, a path can contain colons and backslashes and has to be converted: +if [ "${OSTYPE:-}" = "cygwin" ] || [ "${OSTYPE:-}" = "msys" ] ; then + # transform D:\path\to\venv to /d/path/to/venv on MSYS + # and to /cygdrive/d/path/to/venv on Cygwin + export VIRTUAL_ENV=$(cygpath "/Users/danilkapnik/yap_lab_3/.venv") +else + # use the path as-is + export VIRTUAL_ENV="/Users/danilkapnik/yap_lab_3/.venv" +fi + +_OLD_VIRTUAL_PATH="$PATH" +PATH="$VIRTUAL_ENV/bin:$PATH" +export PATH + +# unset PYTHONHOME if set +# this will fail if PYTHONHOME is set to the empty string (which is bad anyway) +# could use `if (set -u; : $PYTHONHOME) ;` in bash +if [ -n "${PYTHONHOME:-}" ] ; then + _OLD_VIRTUAL_PYTHONHOME="${PYTHONHOME:-}" + unset PYTHONHOME +fi + +if [ -z "${VIRTUAL_ENV_DISABLE_PROMPT:-}" ] ; then + _OLD_VIRTUAL_PS1="${PS1:-}" + PS1="(.venv) ${PS1:-}" + export PS1 + VIRTUAL_ENV_PROMPT="(.venv) " + export VIRTUAL_ENV_PROMPT +fi + +# Call hash to forget past commands. Without forgetting +# past commands the $PATH changes we made may not be respected +hash -r 2> /dev/null diff --git a/yap_lab_3/.venv/bin/activate.csh b/yap_lab_3/.venv/bin/activate.csh new file mode 100644 index 0000000..ad74f2b --- /dev/null +++ b/yap_lab_3/.venv/bin/activate.csh @@ -0,0 +1,27 @@ +# This file must be used with "source bin/activate.csh" *from csh*. +# You cannot run it directly. + +# Created by Davide Di Blasi . +# Ported to Python 3.3 venv by Andrew Svetlov + +alias deactivate 'test $?_OLD_VIRTUAL_PATH != 0 && setenv PATH "$_OLD_VIRTUAL_PATH" && unset _OLD_VIRTUAL_PATH; rehash; test $?_OLD_VIRTUAL_PROMPT != 0 && set prompt="$_OLD_VIRTUAL_PROMPT" && unset _OLD_VIRTUAL_PROMPT; unsetenv VIRTUAL_ENV; unsetenv VIRTUAL_ENV_PROMPT; test "\!:*" != "nondestructive" && unalias deactivate' + +# Unset irrelevant variables. +deactivate nondestructive + +setenv VIRTUAL_ENV "/Users/danilkapnik/yap_lab_3/.venv" + +set _OLD_VIRTUAL_PATH="$PATH" +setenv PATH "$VIRTUAL_ENV/bin:$PATH" + + +set _OLD_VIRTUAL_PROMPT="$prompt" + +if (! "$?VIRTUAL_ENV_DISABLE_PROMPT") then + set prompt = "(.venv) $prompt" + setenv VIRTUAL_ENV_PROMPT "(.venv) " +endif + +alias pydoc python -m pydoc + +rehash diff --git a/yap_lab_3/.venv/bin/activate.fish b/yap_lab_3/.venv/bin/activate.fish new file mode 100644 index 0000000..4485f49 --- /dev/null +++ b/yap_lab_3/.venv/bin/activate.fish @@ -0,0 +1,69 @@ +# This file must be used with "source /bin/activate.fish" *from fish* +# (https://fishshell.com/). You cannot run it directly. + +function deactivate -d "Exit virtual environment and return to normal shell environment" + # reset old environment variables + if test -n "$_OLD_VIRTUAL_PATH" + set -gx PATH $_OLD_VIRTUAL_PATH + set -e _OLD_VIRTUAL_PATH + end + if test -n "$_OLD_VIRTUAL_PYTHONHOME" + set -gx PYTHONHOME $_OLD_VIRTUAL_PYTHONHOME + set -e _OLD_VIRTUAL_PYTHONHOME + end + + if test -n "$_OLD_FISH_PROMPT_OVERRIDE" + set -e _OLD_FISH_PROMPT_OVERRIDE + # prevents error when using nested fish instances (Issue #93858) + if functions -q _old_fish_prompt + functions -e fish_prompt + functions -c _old_fish_prompt fish_prompt + functions -e _old_fish_prompt + end + end + + set -e VIRTUAL_ENV + set -e VIRTUAL_ENV_PROMPT + if test "$argv[1]" != "nondestructive" + # Self-destruct! + functions -e deactivate + end +end + +# Unset irrelevant variables. +deactivate nondestructive + +set -gx VIRTUAL_ENV "/Users/danilkapnik/yap_lab_3/.venv" + +set -gx _OLD_VIRTUAL_PATH $PATH +set -gx PATH "$VIRTUAL_ENV/bin" $PATH + +# Unset PYTHONHOME if set. +if set -q PYTHONHOME + set -gx _OLD_VIRTUAL_PYTHONHOME $PYTHONHOME + set -e PYTHONHOME +end + +if test -z "$VIRTUAL_ENV_DISABLE_PROMPT" + # fish uses a function instead of an env var to generate the prompt. + + # Save the current fish_prompt function as the function _old_fish_prompt. + functions -c fish_prompt _old_fish_prompt + + # With the original prompt function renamed, we can override with our own. + function fish_prompt + # Save the return status of the last command. + set -l old_status $status + + # Output the venv prompt; color taken from the blue of the Python logo. + printf "%s%s%s" (set_color 4B8BBE) "(.venv) " (set_color normal) + + # Restore the return status of the previous command. + echo "exit $old_status" | . + # Output the original/"old" prompt. + _old_fish_prompt + end + + set -gx _OLD_FISH_PROMPT_OVERRIDE "$VIRTUAL_ENV" + set -gx VIRTUAL_ENV_PROMPT "(.venv) " +end diff --git a/yap_lab_3/.venv/bin/pip b/yap_lab_3/.venv/bin/pip new file mode 100755 index 0000000..4d0d122 --- /dev/null +++ b/yap_lab_3/.venv/bin/pip @@ -0,0 +1,8 @@ +#!/Users/danilkapnik/yap_lab_3/.venv/bin/python +# -*- coding: utf-8 -*- +import re +import sys +from pip._internal.cli.main import main +if __name__ == '__main__': + sys.argv[0] = re.sub(r'(-script\.pyw|\.exe)?$', '', sys.argv[0]) + sys.exit(main()) diff --git a/yap_lab_3/.venv/bin/pip3 b/yap_lab_3/.venv/bin/pip3 new file mode 100755 index 0000000..4d0d122 --- /dev/null +++ b/yap_lab_3/.venv/bin/pip3 @@ -0,0 +1,8 @@ +#!/Users/danilkapnik/yap_lab_3/.venv/bin/python +# -*- coding: utf-8 -*- +import re +import sys +from pip._internal.cli.main import main +if __name__ == '__main__': + sys.argv[0] = re.sub(r'(-script\.pyw|\.exe)?$', '', sys.argv[0]) + sys.exit(main()) diff --git a/yap_lab_3/.venv/bin/pip3.12 b/yap_lab_3/.venv/bin/pip3.12 new file mode 100755 index 0000000..4d0d122 --- /dev/null +++ b/yap_lab_3/.venv/bin/pip3.12 @@ -0,0 +1,8 @@ +#!/Users/danilkapnik/yap_lab_3/.venv/bin/python +# -*- coding: utf-8 -*- +import re +import sys +from pip._internal.cli.main import main +if __name__ == '__main__': + sys.argv[0] = re.sub(r'(-script\.pyw|\.exe)?$', '', sys.argv[0]) + sys.exit(main()) diff --git a/yap_lab_3/.venv/bin/python b/yap_lab_3/.venv/bin/python new file mode 120000 index 0000000..11b9d88 --- /dev/null +++ b/yap_lab_3/.venv/bin/python @@ -0,0 +1 @@ +python3.12 \ No newline at end of file diff --git a/yap_lab_3/.venv/bin/python3 b/yap_lab_3/.venv/bin/python3 new file mode 120000 index 0000000..11b9d88 --- /dev/null +++ b/yap_lab_3/.venv/bin/python3 @@ -0,0 +1 @@ +python3.12 \ No newline at end of file diff --git a/yap_lab_3/.venv/bin/python3.12 b/yap_lab_3/.venv/bin/python3.12 new file mode 120000 index 0000000..a7a5fcc --- /dev/null +++ b/yap_lab_3/.venv/bin/python3.12 @@ -0,0 +1 @@ +/Library/Frameworks/Python.framework/Versions/3.12/bin/python3.12 \ No newline at end of file diff --git a/yap_lab_3/.venv/include/site/python3.12/pygame/_blit_info.h b/yap_lab_3/.venv/include/site/python3.12/pygame/_blit_info.h new file mode 100644 index 0000000..5320d0b --- /dev/null +++ b/yap_lab_3/.venv/include/site/python3.12/pygame/_blit_info.h @@ -0,0 +1,21 @@ +#define NO_PYGAME_C_API +#include "_surface.h" + +/* The structure passed to the low level blit functions */ +typedef struct { + int width; + int height; + Uint8 *s_pixels; + int s_pxskip; + int s_skip; + Uint8 *d_pixels; + int d_pxskip; + int d_skip; + SDL_PixelFormat *src; + SDL_PixelFormat *dst; + Uint8 src_blanket_alpha; + int src_has_colorkey; + Uint32 src_colorkey; + SDL_BlendMode src_blend; + SDL_BlendMode dst_blend; +} SDL_BlitInfo; diff --git a/yap_lab_3/.venv/include/site/python3.12/pygame/_camera.h b/yap_lab_3/.venv/include/site/python3.12/pygame/_camera.h new file mode 100644 index 0000000..075ef6f --- /dev/null +++ b/yap_lab_3/.venv/include/site/python3.12/pygame/_camera.h @@ -0,0 +1,26 @@ +/* + pygame - Python Game Library + + This library is free software; you can redistribute it and/or + modify it under the terms of the GNU Library General Public + License as published by the Free Software Foundation; either + version 2 of the License, or (at your option) any later version. + + This library is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU + Library General Public License for more details. + + You should have received a copy of the GNU Library General Public + License along with this library; if not, write to the Free + Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + +*/ + +#ifndef _CAMERA_H +#define _CAMERA_H + +#include "_pygame.h" +#include "camera.h" + +#endif diff --git a/yap_lab_3/.venv/include/site/python3.12/pygame/_pygame.h b/yap_lab_3/.venv/include/site/python3.12/pygame/_pygame.h new file mode 100644 index 0000000..e3521b3 --- /dev/null +++ b/yap_lab_3/.venv/include/site/python3.12/pygame/_pygame.h @@ -0,0 +1,374 @@ +/* + pygame - Python Game Library + Copyright (C) 2000-2001 Pete Shinners + + This library is free software; you can redistribute it and/or + modify it under the terms of the GNU Library General Public + License as published by the Free Software Foundation; either + version 2 of the License, or (at your option) any later version. + + This library is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU + Library General Public License for more details. + + You should have received a copy of the GNU Library General Public + License along with this library; if not, write to the Free + Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + + Pete Shinners + pete@shinners.org +*/ + +/* This will use PYGAMEAPI_EXTERN_SLOTS instead + * of PYGAMEAPI_DEFINE_SLOTS for base modules. + */ +#ifndef _PYGAME_INTERNAL_H +#define _PYGAME_INTERNAL_H + +#include "pgplatform.h" +/* + If PY_SSIZE_T_CLEAN is defined before including Python.h, length is a + Py_ssize_t rather than an int for all # variants of formats (s#, y#, etc.) +*/ +#define PY_SSIZE_T_CLEAN +#include + +/* Ensure PyPy-specific code is not in use when running on GraalPython (PR + * #2580) */ +#if defined(GRAALVM_PYTHON) && defined(PYPY_VERSION) +#undef PYPY_VERSION +#endif + +#include + +/* SDL 1.2 constants removed from SDL 2 */ +typedef enum { + SDL_HWSURFACE = 0, + SDL_RESIZABLE = SDL_WINDOW_RESIZABLE, + SDL_ASYNCBLIT = 0, + SDL_OPENGL = SDL_WINDOW_OPENGL, + SDL_OPENGLBLIT = 0, + SDL_ANYFORMAT = 0, + SDL_HWPALETTE = 0, + SDL_DOUBLEBUF = 0, + SDL_FULLSCREEN = SDL_WINDOW_FULLSCREEN, + SDL_HWACCEL = 0, + SDL_SRCCOLORKEY = 0, + SDL_RLEACCELOK = 0, + SDL_SRCALPHA = 0, + SDL_NOFRAME = SDL_WINDOW_BORDERLESS, + SDL_GL_SWAP_CONTROL = 0, + TIMER_RESOLUTION = 0 +} PygameVideoFlags; + +/* the wheel button constants were removed from SDL 2 */ +typedef enum { + PGM_BUTTON_LEFT = SDL_BUTTON_LEFT, + PGM_BUTTON_RIGHT = SDL_BUTTON_RIGHT, + PGM_BUTTON_MIDDLE = SDL_BUTTON_MIDDLE, + PGM_BUTTON_WHEELUP = 4, + PGM_BUTTON_WHEELDOWN = 5, + PGM_BUTTON_X1 = SDL_BUTTON_X1 + 2, + PGM_BUTTON_X2 = SDL_BUTTON_X2 + 2, + PGM_BUTTON_KEEP = 0x80 +} PygameMouseFlags; + +typedef enum { + /* Any SDL_* events here are for backward compatibility. */ + SDL_NOEVENT = 0, + + SDL_ACTIVEEVENT = SDL_USEREVENT, + SDL_VIDEORESIZE, + SDL_VIDEOEXPOSE, + + PGE_MIDIIN, + PGE_MIDIOUT, + PGE_KEYREPEAT, /* Special internal pygame event, for managing key-presses + */ + + /* DO NOT CHANGE THE ORDER OF EVENTS HERE */ + PGE_WINDOWSHOWN, + PGE_WINDOWHIDDEN, + PGE_WINDOWEXPOSED, + PGE_WINDOWMOVED, + PGE_WINDOWRESIZED, + PGE_WINDOWSIZECHANGED, + PGE_WINDOWMINIMIZED, + PGE_WINDOWMAXIMIZED, + PGE_WINDOWRESTORED, + PGE_WINDOWENTER, + PGE_WINDOWLEAVE, + PGE_WINDOWFOCUSGAINED, + PGE_WINDOWFOCUSLOST, + PGE_WINDOWCLOSE, + PGE_WINDOWTAKEFOCUS, + PGE_WINDOWHITTEST, + PGE_WINDOWICCPROFCHANGED, + PGE_WINDOWDISPLAYCHANGED, + + /* Here we define PGPOST_* events, events that act as a one-to-one + * proxy for SDL events (and some extra events too!), the proxy is used + * internally when pygame users use event.post() + * + * At a first glance, these may look redundant, but they are really + * important, especially with event blocking. If proxy events are + * not there, blocked events dont make it to our event filter, and + * that can break a lot of stuff. + * + * IMPORTANT NOTE: Do not post events directly with these proxy types, + * use the appropriate functions from event.c, that handle these proxy + * events for you. + * Proxy events are for internal use only */ + PGPOST_EVENTBEGIN, /* mark start of proxy-events */ + PGPOST_ACTIVEEVENT = PGPOST_EVENTBEGIN, + PGPOST_APP_TERMINATING, + PGPOST_APP_LOWMEMORY, + PGPOST_APP_WILLENTERBACKGROUND, + PGPOST_APP_DIDENTERBACKGROUND, + PGPOST_APP_WILLENTERFOREGROUND, + PGPOST_APP_DIDENTERFOREGROUND, + PGPOST_AUDIODEVICEADDED, + PGPOST_AUDIODEVICEREMOVED, + PGPOST_CLIPBOARDUPDATE, + PGPOST_CONTROLLERAXISMOTION, + PGPOST_CONTROLLERBUTTONDOWN, + PGPOST_CONTROLLERBUTTONUP, + PGPOST_CONTROLLERDEVICEADDED, + PGPOST_CONTROLLERDEVICEREMOVED, + PGPOST_CONTROLLERDEVICEREMAPPED, + PGPOST_CONTROLLERTOUCHPADDOWN, + PGPOST_CONTROLLERTOUCHPADMOTION, + PGPOST_CONTROLLERTOUCHPADUP, + PGPOST_CONTROLLERSENSORUPDATE, + PGPOST_DOLLARGESTURE, + PGPOST_DOLLARRECORD, + PGPOST_DROPFILE, + PGPOST_DROPTEXT, + PGPOST_DROPBEGIN, + PGPOST_DROPCOMPLETE, + PGPOST_FINGERMOTION, + PGPOST_FINGERDOWN, + PGPOST_FINGERUP, + PGPOST_KEYDOWN, + PGPOST_KEYMAPCHANGED, + PGPOST_KEYUP, + PGPOST_JOYAXISMOTION, + PGPOST_JOYBALLMOTION, + PGPOST_JOYHATMOTION, + PGPOST_JOYBUTTONDOWN, + PGPOST_JOYBUTTONUP, + PGPOST_JOYDEVICEADDED, + PGPOST_JOYDEVICEREMOVED, + PGPOST_LOCALECHANGED, + PGPOST_MIDIIN, + PGPOST_MIDIOUT, + PGPOST_MOUSEMOTION, + PGPOST_MOUSEBUTTONDOWN, + PGPOST_MOUSEBUTTONUP, + PGPOST_MOUSEWHEEL, + PGPOST_MULTIGESTURE, + PGPOST_NOEVENT, + PGPOST_QUIT, + PGPOST_RENDER_TARGETS_RESET, + PGPOST_RENDER_DEVICE_RESET, + PGPOST_SYSWMEVENT, + PGPOST_TEXTEDITING, + PGPOST_TEXTINPUT, + PGPOST_VIDEORESIZE, + PGPOST_VIDEOEXPOSE, + PGPOST_WINDOWSHOWN, + PGPOST_WINDOWHIDDEN, + PGPOST_WINDOWEXPOSED, + PGPOST_WINDOWMOVED, + PGPOST_WINDOWRESIZED, + PGPOST_WINDOWSIZECHANGED, + PGPOST_WINDOWMINIMIZED, + PGPOST_WINDOWMAXIMIZED, + PGPOST_WINDOWRESTORED, + PGPOST_WINDOWENTER, + PGPOST_WINDOWLEAVE, + PGPOST_WINDOWFOCUSGAINED, + PGPOST_WINDOWFOCUSLOST, + PGPOST_WINDOWCLOSE, + PGPOST_WINDOWTAKEFOCUS, + PGPOST_WINDOWHITTEST, + PGPOST_WINDOWICCPROFCHANGED, + PGPOST_WINDOWDISPLAYCHANGED, + + PGE_USEREVENT, /* this event must stay in this position only */ + + PG_NUMEVENTS = + SDL_LASTEVENT /* Not an event. Indicates end of user events. */ +} PygameEventCode; + +/* SDL1 ACTIVEEVENT state attribute can take the following values */ +/* These constant values are directly picked from SDL1 source */ +#define SDL_APPMOUSEFOCUS 0x01 +#define SDL_APPINPUTFOCUS 0x02 +#define SDL_APPACTIVE 0x04 + +/* Surface flags: based on SDL 1.2 flags */ +typedef enum { + PGS_SWSURFACE = 0x00000000, + PGS_HWSURFACE = 0x00000001, + PGS_ASYNCBLIT = 0x00000004, + + PGS_ANYFORMAT = 0x10000000, + PGS_HWPALETTE = 0x20000000, + PGS_DOUBLEBUF = 0x40000000, + PGS_FULLSCREEN = 0x80000000, + PGS_SCALED = 0x00000200, + + PGS_OPENGL = 0x00000002, + PGS_OPENGLBLIT = 0x0000000A, + PGS_RESIZABLE = 0x00000010, + PGS_NOFRAME = 0x00000020, + PGS_SHOWN = 0x00000040, /* Added from SDL 2 */ + PGS_HIDDEN = 0x00000080, /* Added from SDL 2 */ + + PGS_HWACCEL = 0x00000100, + PGS_SRCCOLORKEY = 0x00001000, + PGS_RLEACCELOK = 0x00002000, + PGS_RLEACCEL = 0x00004000, + PGS_SRCALPHA = 0x00010000, + PGS_PREALLOC = 0x01000000 +} PygameSurfaceFlags; + +// TODO Implement check below in a way that does not break CI +/* New buffer protocol (PEP 3118) implemented on all supported Py versions. +#if !defined(Py_TPFLAGS_HAVE_NEWBUFFER) +#error No support for PEP 3118/Py_TPFLAGS_HAVE_NEWBUFFER. Please use a +supported Python version. #endif */ + +#define RAISE(x, y) (PyErr_SetString((x), (y)), NULL) +#define DEL_ATTR_NOT_SUPPORTED_CHECK(name, value) \ + do { \ + if (!value) { \ + PyErr_Format(PyExc_AttributeError, "Cannot delete attribute %s", \ + name); \ + return -1; \ + } \ + } while (0) + +#define DEL_ATTR_NOT_SUPPORTED_CHECK_NO_NAME(value) \ + do { \ + if (!value) { \ + PyErr_SetString(PyExc_AttributeError, "Cannot delete attribute"); \ + return -1; \ + } \ + } while (0) + +/* + * Initialization checks + */ + +#define VIDEO_INIT_CHECK() \ + if (!SDL_WasInit(SDL_INIT_VIDEO)) \ + return RAISE(pgExc_SDLError, "video system not initialized") + +#define JOYSTICK_INIT_CHECK() \ + if (!SDL_WasInit(SDL_INIT_JOYSTICK)) \ + return RAISE(pgExc_SDLError, "joystick system not initialized") + +/* thread check */ +#ifdef WITH_THREAD +#define PG_CHECK_THREADS() (1) +#else /* ~WITH_THREAD */ +#define PG_CHECK_THREADS() \ + (RAISE(PyExc_NotImplementedError, "Python built without thread support")) +#endif /* ~WITH_THREAD */ + +#define PyType_Init(x) (((x).ob_type) = &PyType_Type) + +/* CPython 3.6 had initial and undocumented FASTCALL support, but we play it + * safe by not relying on implementation details */ +#if PY_VERSION_HEX < 0x03070000 + +/* Macro for naming a pygame fastcall wrapper function */ +#define PG_FASTCALL_NAME(func) _##func##_fastcall_wrap + +/* used to forward declare compat functions */ +#define PG_DECLARE_FASTCALL_FUNC(func, self_type) \ + static PyObject *PG_FASTCALL_NAME(func)(self_type * self, PyObject * args) + +/* Using this macro on a function defined with the FASTCALL calling convention + * adds a wrapper definition that uses regular python VARARGS convention. + * Since it is guaranteed that the 'args' object is a tuple, we can directly + * call PySequence_Fast_ITEMS and PyTuple_GET_SIZE on it (which are macros that + * assume the same, and don't do error checking) */ +#define PG_WRAP_FASTCALL_FUNC(func, self_type) \ + PG_DECLARE_FASTCALL_FUNC(func, self_type) \ + { \ + return func(self, (PyObject *const *)PySequence_Fast_ITEMS(args), \ + PyTuple_GET_SIZE(args)); \ + } + +#define PG_FASTCALL METH_VARARGS + +#else /* PY_VERSION_HEX >= 0x03070000 */ +/* compat macros are no-op on python versions that support fastcall */ +#define PG_FASTCALL_NAME(func) func +#define PG_DECLARE_FASTCALL_FUNC(func, self_type) +#define PG_WRAP_FASTCALL_FUNC(func, self_type) + +#define PG_FASTCALL METH_FASTCALL + +#endif /* PY_VERSION_HEX >= 0x03070000 */ + +/* + * event module internals + */ +struct pgEventObject { + PyObject_HEAD int type; + PyObject *dict; +}; + +/* + * surflock module internals + */ +typedef struct { + PyObject_HEAD PyObject *surface; + PyObject *lockobj; + PyObject *weakrefs; +} pgLifetimeLockObject; + +/* + * surface module internals + */ +struct pgSubSurface_Data { + PyObject *owner; + int pixeloffset; + int offsetx, offsety; +}; + +/* + * color module internals + */ +struct pgColorObject { + PyObject_HEAD Uint8 data[4]; + Uint8 len; +}; + +/* + * include public API + */ +#include "include/_pygame.h" + +/* Slot counts. + * Remember to keep these constants up to date. + */ + +#define PYGAMEAPI_RECT_NUMSLOTS 5 +#define PYGAMEAPI_JOYSTICK_NUMSLOTS 2 +#define PYGAMEAPI_DISPLAY_NUMSLOTS 2 +#define PYGAMEAPI_SURFACE_NUMSLOTS 4 +#define PYGAMEAPI_SURFLOCK_NUMSLOTS 8 +#define PYGAMEAPI_RWOBJECT_NUMSLOTS 6 +#define PYGAMEAPI_PIXELARRAY_NUMSLOTS 2 +#define PYGAMEAPI_COLOR_NUMSLOTS 5 +#define PYGAMEAPI_MATH_NUMSLOTS 2 +#define PYGAMEAPI_BASE_NUMSLOTS 27 +#define PYGAMEAPI_EVENT_NUMSLOTS 6 + +#endif /* _PYGAME_INTERNAL_H */ diff --git a/yap_lab_3/.venv/include/site/python3.12/pygame/_surface.h b/yap_lab_3/.venv/include/site/python3.12/pygame/_surface.h new file mode 100644 index 0000000..b2b4644 --- /dev/null +++ b/yap_lab_3/.venv/include/site/python3.12/pygame/_surface.h @@ -0,0 +1,30 @@ +/* + pygame - Python Game Library + Copyright (C) 2000-2001 Pete Shinners + Copyright (C) 2007 Marcus von Appen + + This library is free software; you can redistribute it and/or + modify it under the terms of the GNU Library General Public + License as published by the Free Software Foundation; either + version 2 of the License, or (at your option) any later version. + + This library is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU + Library General Public License for more details. + + You should have received a copy of the GNU Library General Public + License along with this library; if not, write to the Free + Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + + Pete Shinners + pete@shinners.org +*/ + +#ifndef _SURFACE_H +#define _SURFACE_H + +#include "_pygame.h" +#include "surface.h" + +#endif diff --git a/yap_lab_3/.venv/include/site/python3.12/pygame/camera.h b/yap_lab_3/.venv/include/site/python3.12/pygame/camera.h new file mode 100644 index 0000000..f170b7d --- /dev/null +++ b/yap_lab_3/.venv/include/site/python3.12/pygame/camera.h @@ -0,0 +1,218 @@ +#ifndef CAMERA_H +#define CAMERA_H +/* + pygame - Python Game Library + + This library is free software; you can redistribute it and/or + modify it under the terms of the GNU Library General Public + License as published by the Free Software Foundation; either + version 2 of the License, or (at your option) any later version. + + This library is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU + Library General Public License for more details. + + You should have received a copy of the GNU Library General Public + License along with this library; if not, write to the Free + Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + +*/ + +#include "pygame.h" +#include "pgcompat.h" +#include "doc/camera_doc.h" + +#if defined(__unix__) +#include +#include +#include +#include +#include + +#include /* low-level i/o */ +#include +#include +#include +#include +#include +#include +#include + +/* on freebsd there is no asm/types */ +#ifdef __linux__ +#include /* for videodev2.h */ +#include +#endif + +/* on openbsd and netbsd we need to include videoio.h */ +#if defined(__OpenBSD__) || defined(__NetBSD__) +#include +#endif + +#ifdef __FreeBSD__ +#include +#endif + +#endif /* defined(__unix__) */ + +#if defined(__WIN32__) + +#ifdef __MINGW32__ +#undef WINVER +/** _WIN32_WINNT_WINBLUE sets minimum platform SDK to Windows 8.1. */ +#define WINVER _WIN32_WINNT_WINBLUE +#endif + +#include +#include +#include +#include +#include +#include +#endif + +/* some constants used which are not defined on non-v4l machines. */ +#ifndef V4L2_PIX_FMT_RGB24 +#define V4L2_PIX_FMT_RGB24 'RGB3' +#endif +#ifndef V4L2_PIX_FMT_RGB444 +#define V4L2_PIX_FMT_RGB444 'R444' +#endif +#ifndef V4L2_PIX_FMT_YUYV +#define V4L2_PIX_FMT_YUYV 'YUYV' +#endif +#ifndef V4L2_PIX_FMT_XBGR32 +#define V4L2_PIX_FMT_XBGR32 'XR24' +#endif + +#define CLEAR(x) memset(&(x), 0, sizeof(x)) +#define SAT(c) \ + if (c & (~255)) { \ + if (c < 0) \ + c = 0; \ + else \ + c = 255; \ + } +#define SAT2(c) ((c) & (~255) ? ((c) < 0 ? 0 : 255) : (c)) +#define DEFAULT_WIDTH 640 +#define DEFAULT_HEIGHT 480 +#define RGB_OUT 1 +#define YUV_OUT 2 +#define HSV_OUT 4 +#define CAM_V4L \ + 1 /* deprecated. the incomplete support in pygame was removed */ +#define CAM_V4L2 2 + +struct buffer { + void *start; + size_t length; +}; + +#if defined(__unix__) +typedef struct pgCameraObject { + PyObject_HEAD char *device_name; + int camera_type; + unsigned long pixelformat; + unsigned int color_out; + struct buffer *buffers; + unsigned int n_buffers; + int width; + int height; + int size; + int hflip; + int vflip; + int brightness; + int fd; +} pgCameraObject; +#else +/* generic definition. + */ + +typedef struct pgCameraObject { + PyObject_HEAD char *device_name; + int camera_type; + unsigned long pixelformat; + unsigned int color_out; + struct buffer *buffers; + unsigned int n_buffers; + int width; + int height; + int size; + int hflip; + int vflip; + int brightness; + int fd; +} pgCameraObject; +#endif + +/* internal functions for colorspace conversion */ +void +colorspace(SDL_Surface *src, SDL_Surface *dst, int cspace); +void +rgb24_to_rgb(const void *src, void *dst, int length, SDL_PixelFormat *format); +void +bgr32_to_rgb(const void *src, void *dst, int length, SDL_PixelFormat *format); +void +rgb444_to_rgb(const void *src, void *dst, int length, SDL_PixelFormat *format); +void +rgb_to_yuv(const void *src, void *dst, int length, unsigned long source, + SDL_PixelFormat *format); +void +rgb_to_hsv(const void *src, void *dst, int length, unsigned long source, + SDL_PixelFormat *format); +void +yuyv_to_rgb(const void *src, void *dst, int length, SDL_PixelFormat *format); +void +yuyv_to_yuv(const void *src, void *dst, int length, SDL_PixelFormat *format); +void +uyvy_to_rgb(const void *src, void *dst, int length, SDL_PixelFormat *format); +void +uyvy_to_yuv(const void *src, void *dst, int length, SDL_PixelFormat *format); +void +sbggr8_to_rgb(const void *src, void *dst, int width, int height, + SDL_PixelFormat *format); +void +yuv420_to_rgb(const void *src, void *dst, int width, int height, + SDL_PixelFormat *format); +void +yuv420_to_yuv(const void *src, void *dst, int width, int height, + SDL_PixelFormat *format); + +#if defined(__unix__) +/* internal functions specific to v4l2 */ +char ** +v4l2_list_cameras(int *num_devices); +int +v4l2_get_control(int fd, int id, int *value); +int +v4l2_set_control(int fd, int id, int value); +PyObject * +v4l2_read_raw(pgCameraObject *self); +int +v4l2_xioctl(int fd, int request, void *arg); +int +v4l2_process_image(pgCameraObject *self, const void *image, int buffer_size, + SDL_Surface *surf); +int +v4l2_query_buffer(pgCameraObject *self); +int +v4l2_read_frame(pgCameraObject *self, SDL_Surface *surf, int *errno_code); +int +v4l2_stop_capturing(pgCameraObject *self); +int +v4l2_start_capturing(pgCameraObject *self); +int +v4l2_uninit_device(pgCameraObject *self); +int +v4l2_init_mmap(pgCameraObject *self); +int +v4l2_init_device(pgCameraObject *self); +int +v4l2_close_device(pgCameraObject *self); +int +v4l2_open_device(pgCameraObject *self); + +#endif + +#endif /* !CAMERA_H */ diff --git a/yap_lab_3/.venv/include/site/python3.12/pygame/font.h b/yap_lab_3/.venv/include/site/python3.12/pygame/font.h new file mode 100644 index 0000000..f5eedb2 --- /dev/null +++ b/yap_lab_3/.venv/include/site/python3.12/pygame/font.h @@ -0,0 +1,15 @@ +#ifndef PGFONT_INTERNAL_H +#define PGFONT_INTERNAL_H + +#include + +/* test font initialization */ +#define FONT_INIT_CHECK() \ + if (!(*(int *)PyFONT_C_API[2])) \ + return RAISE(pgExc_SDLError, "font system not initialized") + +#include "include/pygame_font.h" + +#define PYGAMEAPI_FONT_NUMSLOTS 3 + +#endif /* ~PGFONT_INTERNAL_H */ diff --git a/yap_lab_3/.venv/include/site/python3.12/pygame/freetype.h b/yap_lab_3/.venv/include/site/python3.12/pygame/freetype.h new file mode 100644 index 0000000..fd86bc2 --- /dev/null +++ b/yap_lab_3/.venv/include/site/python3.12/pygame/freetype.h @@ -0,0 +1,114 @@ +/* + pygame - Python Game Library + Copyright (C) 2009 Vicent Marti + + This library is free software; you can redistribute it and/or + modify it under the terms of the GNU Library General Public + License as published by the Free Software Foundation; either + version 2 of the License, or (at your option) any later version. + + This library is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU + Library General Public License for more details. + + You should have received a copy of the GNU Library General Public + License along with this library; if not, write to the Free + Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + +*/ +#ifndef _PYGAME_FREETYPE_INTERNAL_H_ +#define _PYGAME_FREETYPE_INTERNAL_H_ + +#include "pgcompat.h" +#include "pgplatform.h" + +#include +#include FT_FREETYPE_H +#include FT_CACHE_H +#include FT_XFREE86_H +#include FT_TRIGONOMETRY_H + +/********************************************************** + * Global module constants + **********************************************************/ + +/* Render styles */ +#define FT_STYLE_NORMAL 0x00 +#define FT_STYLE_STRONG 0x01 +#define FT_STYLE_OBLIQUE 0x02 +#define FT_STYLE_UNDERLINE 0x04 +#define FT_STYLE_WIDE 0x08 +#define FT_STYLE_DEFAULT 0xFF + +/* Bounding box modes */ +#define FT_BBOX_EXACT FT_GLYPH_BBOX_SUBPIXELS +#define FT_BBOX_EXACT_GRIDFIT FT_GLYPH_BBOX_GRIDFIT +#define FT_BBOX_PIXEL FT_GLYPH_BBOX_TRUNCATE +#define FT_BBOX_PIXEL_GRIDFIT FT_GLYPH_BBOX_PIXELS + +/* Rendering flags */ +#define FT_RFLAG_NONE (0) +#define FT_RFLAG_ANTIALIAS (1 << 0) +#define FT_RFLAG_AUTOHINT (1 << 1) +#define FT_RFLAG_VERTICAL (1 << 2) +#define FT_RFLAG_HINTED (1 << 3) +#define FT_RFLAG_KERNING (1 << 4) +#define FT_RFLAG_TRANSFORM (1 << 5) +#define FT_RFLAG_PAD (1 << 6) +#define FT_RFLAG_ORIGIN (1 << 7) +#define FT_RFLAG_UCS4 (1 << 8) +#define FT_RFLAG_USE_BITMAP_STRIKES (1 << 9) +#define FT_RFLAG_DEFAULTS \ + (FT_RFLAG_HINTED | FT_RFLAG_USE_BITMAP_STRIKES | FT_RFLAG_ANTIALIAS) + +#define FT_RENDER_NEWBYTEARRAY 0x0 +#define FT_RENDER_NEWSURFACE 0x1 +#define FT_RENDER_EXISTINGSURFACE 0x2 + +/********************************************************** + * Global module types + **********************************************************/ + +typedef struct _scale_s { + FT_UInt x, y; +} Scale_t; +typedef FT_Angle Angle_t; + +struct fontinternals_; +struct freetypeinstance_; + +typedef struct { + FT_Long font_index; + FT_Open_Args open_args; +} pgFontId; + +typedef struct { + PyObject_HEAD pgFontId id; + PyObject *path; + int is_scalable; + int is_bg_col_set; + + Scale_t face_size; + FT_Int16 style; + FT_Int16 render_flags; + double strength; + double underline_adjustment; + FT_UInt resolution; + Angle_t rotation; + FT_Matrix transform; + FT_Byte fgcolor[4]; + FT_Byte bgcolor[4]; + + struct freetypeinstance_ *freetype; /* Personal reference */ + struct fontinternals_ *_internals; +} pgFontObject; + +#define pgFont_IS_ALIVE(o) (((pgFontObject *)(o))->_internals != 0) + +/* import public API */ +#include "include/pygame_freetype.h" + +#define PYGAMEAPI_FREETYPE_NUMSLOTS 2 + +#endif /* ~_PYGAME_FREETYPE_INTERNAL_H_ */ diff --git a/yap_lab_3/.venv/include/site/python3.12/pygame/include/_pygame.h b/yap_lab_3/.venv/include/site/python3.12/pygame/include/_pygame.h new file mode 100644 index 0000000..f98f3f5 --- /dev/null +++ b/yap_lab_3/.venv/include/site/python3.12/pygame/include/_pygame.h @@ -0,0 +1,949 @@ +/* + pygame - Python Game Library + Copyright (C) 2000-2001 Pete Shinners + + This library is free software; you can redistribute it and/or + modify it under the terms of the GNU Library General Public + License as published by the Free Software Foundation; either + version 2 of the License, or (at your option) any later version. + + This library is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU + Library General Public License for more details. + + You should have received a copy of the GNU Library General Public + License along with this library; if not, write to the Free + Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + + Pete Shinners + pete@shinners.org +*/ + +#ifndef _PYGAME_H +#define _PYGAME_H + +/** This header file includes all the definitions for the + ** base pygame extensions. This header only requires + ** Python includes (and SDL.h for functions that use SDL types). + ** The reason for functions prototyped with #define's is + ** to allow for maximum Python portability. It also uses + ** Python as the runtime linker, which allows for late binding. + '' For more information on this style of development, read + ** the Python docs on this subject. + ** http://www.python.org/doc/current/ext/using-cobjects.html + ** + ** If using this to build your own derived extensions, + ** you'll see that the functions available here are mainly + ** used to help convert between python objects and SDL objects. + ** Since this library doesn't add a lot of functionality to + ** the SDL library, it doesn't need to offer a lot either. + ** + ** When initializing your extension module, you must manually + ** import the modules you want to use. (this is the part about + ** using python as the runtime linker). Each module has its + ** own import_xxx() routine. You need to perform this import + ** after you have initialized your own module, and before + ** you call any routines from that module. Since every module + ** in pygame does this, there are plenty of examples. + ** + ** The base module does include some useful conversion routines + ** that you are free to use in your own extension. + **/ + +#include "pgplatform.h" +#include + +/* version macros (defined since version 1.9.5) */ +#define PG_MAJOR_VERSION 2 +#define PG_MINOR_VERSION 6 +#define PG_PATCH_VERSION 1 +#define PG_VERSIONNUM(MAJOR, MINOR, PATCH) \ + (1000 * (MAJOR) + 100 * (MINOR) + (PATCH)) +#define PG_VERSION_ATLEAST(MAJOR, MINOR, PATCH) \ + (PG_VERSIONNUM(PG_MAJOR_VERSION, PG_MINOR_VERSION, PG_PATCH_VERSION) >= \ + PG_VERSIONNUM(MAJOR, MINOR, PATCH)) + +#include "pgcompat.h" + +/* Flag indicating a pg_buffer; used for assertions within callbacks */ +#ifndef NDEBUG +#define PyBUF_PYGAME 0x4000 +#endif +#define PyBUF_HAS_FLAG(f, F) (((f) & (F)) == (F)) + +/* Array information exchange struct C type; inherits from Py_buffer + * + * Pygame uses its own Py_buffer derived C struct as an internal representation + * of an imported array buffer. The extended Py_buffer allows for a + * per-instance release callback, + */ +typedef void (*pybuffer_releaseproc)(Py_buffer *); + +typedef struct pg_bufferinfo_s { + Py_buffer view; + PyObject *consumer; /* Input: Borrowed reference */ + pybuffer_releaseproc release_buffer; +} pg_buffer; + +#include "pgimport.h" + +/* + * BASE module + */ +#ifndef PYGAMEAPI_BASE_INTERNAL +#define pgExc_SDLError ((PyObject *)PYGAMEAPI_GET_SLOT(base, 0)) + +#define pg_RegisterQuit \ + (*(void (*)(void (*)(void)))PYGAMEAPI_GET_SLOT(base, 1)) + +/** + * \brief Convert number like object *obj* to C int and in *val*. + * + * \param obj The Python object to convert. + * \param val A pointer to the C integer to store the result. + * \returns 1 if the conversion was successful, 0 otherwise. + * + * \note This function will clear any Python errors. + * \note This function will convert floats to integers. + */ +#define pg_IntFromObj \ + (*(int (*)(PyObject *, int *))PYGAMEAPI_GET_SLOT(base, 2)) + +/** + * \brief Convert number like object at position *i* in sequence *obj* + * to C int and place in argument *val*. + * + * \param obj The Python object to convert. + * \param i The index of the object to convert. + * \param val A pointer to the C integer to store the result. + * \returns 1 if the conversion was successful, 0 otherwise. + * + * \note This function will clear any Python errors. + * \note This function will convert floats to integers. + */ +#define pg_IntFromObjIndex \ + (*(int (*)(PyObject *, int, int *))PYGAMEAPI_GET_SLOT(base, 3)) + +/** + * \brief Convert the two number like objects in length 2 sequence *obj* to C + * int and place in arguments *val1* and *val2*. + * + * \param obj The Python two element sequence object to convert. + * \param val A pointer to the C integer to store the result. + * \param val2 A pointer to the C integer to store the result. + * \returns 1 if the conversion was successful, 0 otherwise. + * + * \note This function will clear any Python errors. + * \note This function will convert floats to integers. + */ +#define pg_TwoIntsFromObj \ + (*(int (*)(PyObject *, int *, int *))PYGAMEAPI_GET_SLOT(base, 4)) + +/** + * \brief Convert number like object *obj* to C float and in *val*. + * + * \param obj The Python object to convert. + * \param val A pointer to the C float to store the result. + * \returns 1 if the conversion was successful, 0 otherwise. + * + * \note This function will clear any Python errors. + */ +#define pg_FloatFromObj \ + (*(int (*)(PyObject *, float *))PYGAMEAPI_GET_SLOT(base, 5)) + +/** + * \brief Convert number like object at position *i* in sequence *obj* to C + * float and place in argument *val*. + * + * \param obj The Python object to convert. + * \param i The index of the object to convert. + * \param val A pointer to the C float to store the result. + * \returns 1 if the conversion was successful, 0 otherwise. + * + * \note This function will clear any Python errors. + */ +#define pg_FloatFromObjIndex \ + (*(int (*)(PyObject *, int, float *))PYGAMEAPI_GET_SLOT(base, 6)) + +/** + * \brief Convert the two number like objects in length 2 sequence *obj* to C + * float and place in arguments *val1* and *val2*. + * + * \param obj The Python two element sequence object to convert. + * \param val A pointer to the C float to store the result. + * \param val2 A pointer to the C float to store the result. + * \returns 1 if the conversion was successful, 0 otherwise. + * + * \note This function will clear any Python errors. + */ +#define pg_TwoFloatsFromObj \ + (*(int (*)(PyObject *, float *, float *))PYGAMEAPI_GET_SLOT(base, 7)) + +/** + * \brief Convert number like object *obj* to C Uint32 and in *val*. + * + * \param obj The Python object to convert. + * \param val A pointer to the C int to store the result. + * \returns 1 if the conversion was successful, 0 otherwise. + */ +#define pg_UintFromObj \ + (*(int (*)(PyObject *, Uint32 *))PYGAMEAPI_GET_SLOT(base, 8)) + +/** + * \brief Convert number like object at position *i* in sequence *obj* to C + * Uint32 and place in argument *val*. + * + * \param obj The Python object to convert. + * \param i The index of the object to convert. + * \param val A pointer to the C int to store the result. + * \returns 1 if the conversion was successful, 0 otherwise. + */ +#define pg_UintFromObjIndex \ + (*(int (*)(PyObject *, int, Uint32 *))PYGAMEAPI_GET_SLOT(base, 9)) + +/** + * \brief Initialize all of the pygame modules. + * \returns 1 on success, 0 on failure with PyErr set. + */ +#define pg_mod_autoinit (*(int (*)(const char *))PYGAMEAPI_GET_SLOT(base, 10)) + +/** + * \brief Quit all of the pygame modules. + */ +#define pg_mod_autoquit (*(void (*)(const char *))PYGAMEAPI_GET_SLOT(base, 11)) + +/** + * \brief 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. For a length 3 sequence an alpha value of 255 is + * assumed. + * + * \param obj The Python object to convert. + * \param RGBA A pointer to the C array to store the result. + * \returns 1 if the conversion was successful, 0 otherwise. + */ +#define pg_RGBAFromObj \ + (*(int (*)(PyObject *, Uint8 *))PYGAMEAPI_GET_SLOT(base, 12)) + +/** + * \brief Given a Py_buffer, return a python dictionary representing the array + * interface. + * + * \param view_p A pointer to the Py_buffer to convert to a dictionary. + * + * \returns A Python dictionary representing the array interface of the object. + */ +#define pgBuffer_AsArrayInterface \ + (*(PyObject * (*)(Py_buffer *)) PYGAMEAPI_GET_SLOT(base, 13)) + +/** + * \brief Given a Py_buffer, return a python capsule representing the array + * interface. + * + * \param view_p A pointer to the Py_buffer to convert to a capsule. + * + * \returns A Python capsule representing the array interface of the object. + */ +#define pgBuffer_AsArrayStruct \ + (*(PyObject * (*)(Py_buffer *)) PYGAMEAPI_GET_SLOT(base, 14)) + +/** + * \brief Get a buffer object from a given Python object. + * + * \param obj The Python object to get the buffer from. + * \param pg_view_p A pointer to a pg_buffer struct to store the buffer in. + * \param flags The desired buffer access mode. + * + * \returns 0 on success, -1 on failure. + * + * \note This function attempts to get a buffer object from a given Python + * object. If the object supports the buffer protocol, it will be used to + * create the buffer. If not, it will try to get an array interface or + * dictionary representation of the object and use that to create the buffer. + * If none of these methods work, it will raise a ValueError. + * + */ +#define pgObject_GetBuffer \ + (*(int (*)(PyObject *, pg_buffer *, int))PYGAMEAPI_GET_SLOT(base, 15)) + +/** + * \brief Release a pg_buffer object. + * + * \param pg_view_p The pg_buffer object to release. + * + * \note This function releases a pg_buffer object. + * \note some calls to this function expect this function to not clear + * previously set errors. + */ +#define pgBuffer_Release (*(void (*)(pg_buffer *))PYGAMEAPI_GET_SLOT(base, 16)) + +/** + * \brief Write the array interface dictionary buffer description *dict* into a + * Pygame buffer description struct *pg_view_p*. + * + * \param pg_view_p The Pygame buffer description struct to write into. + * \param dict The array interface dictionary to read from. + * \param flags The PyBUF flags describing the view type requested. + * + * \returns 0 on success, or -1 on failure. + */ +#define pgDict_AsBuffer \ + (*(int (*)(pg_buffer *, PyObject *, int))PYGAMEAPI_GET_SLOT(base, 17)) + +#define pgExc_BufferError ((PyObject *)PYGAMEAPI_GET_SLOT(base, 18)) + +/** + * \brief Get the default SDL window created by a pygame.display.set_mode() + * call, or *NULL*. + * + * \return The default window, or *NULL* if no window has been created. + */ +#define pg_GetDefaultWindow \ + (*(SDL_Window * (*)(void)) PYGAMEAPI_GET_SLOT(base, 19)) + +/** + * \brief Set the default SDL window created by a pygame.display.set_mode() + * call. The previous window, if any, is destroyed. Argument *win* may be + * *NULL*. This function is called by pygame.display.set_mode(). + * + * \param win The new default window. May be NULL. + */ +#define pg_SetDefaultWindow \ + (*(void (*)(SDL_Window *))PYGAMEAPI_GET_SLOT(base, 20)) + +/** + * \brief Return a borrowed reference to the Pygame default window display + * surface, or *NULL* if no default window is open. + * + * \return The default renderer, or *NULL* if no renderer has been created. + */ +#define pg_GetDefaultWindowSurface \ + (*(pgSurfaceObject * (*)(void)) PYGAMEAPI_GET_SLOT(base, 21)) + +/** + * \brief Set the Pygame default window display surface. The previous + * surface, if any, is destroyed. Argument *screen* may be *NULL*. This + * function is called by pygame.display.set_mode(). + * + * \param screen The new default window display surface. May be NULL. + */ +#define pg_SetDefaultWindowSurface \ + (*(void (*)(pgSurfaceObject *))PYGAMEAPI_GET_SLOT(base, 22)) + +/** + * \returns NULL if the environment variable PYGAME_BLEND_ALPHA_SDL2 is not + * set, otherwise returns a pointer to the environment variable. + */ +#define pg_EnvShouldBlendAlphaSDL2 \ + (*(char *(*)(void))PYGAMEAPI_GET_SLOT(base, 23)) + +/** + * \brief Convert number like object *obj* to C double and in *val*. + * + * \param obj The Python object to convert. + * \param val A pointer to the C double to store the result. + * \returns 1 if the conversion was successful, 0 otherwise. + * + * \note This function will clear any Python errors. + */ +#define pg_DoubleFromObj \ + (*(int (*)(PyObject *, double *))PYGAMEAPI_GET_SLOT(base, 24)) + +/** + * \brief Convert number like object at position *i* in sequence *obj* to C + * double and place in argument *val*. + * + * \param obj The Python object to convert. + * \param i The index of the object to convert. + * \param val A pointer to the C double to store the result. + * \returns 1 if the conversion was successful, 0 otherwise. + * + * \note This function will clear any Python errors. + */ +#define pg_DoubleFromObjIndex \ + (*(int (*)(PyObject *, int, double *))PYGAMEAPI_GET_SLOT(base, 25)) + +/** + * \brief Convert the two number like objects in length 2 sequence *obj* to C + * double and place in arguments *val1* and *val2*. + * + * \param obj The Python two element sequence object to convert. + * \param val A pointer to the C double to store the result. + * \param val2 A pointer to the C double to store the result. + * \returns 1 if the conversion was successful, 0 otherwise. + */ +#define pg_TwoDoublesFromObj \ + (*(int (*)(PyObject *, double *, double *))PYGAMEAPI_GET_SLOT(base, 26)) + +#define import_pygame_base() IMPORT_PYGAME_MODULE(base) +#endif /* ~PYGAMEAPI_BASE_INTERNAL */ + +typedef struct { + /** + * \brief The SDL rect wrapped by this object. + */ + PyObject_HEAD SDL_Rect r; + /** + * \brief A list of weak references to this rect. + */ + PyObject *weakreflist; +} pgRectObject; + +/** + * \brief Convert a pgRectObject to an SDL_Rect. + * + * \param obj A pgRectObject instance. + * \returns the SDL_Rect field of *obj*, a pgRect_Type instance. + * + * \note SDL_Rect pgRect_AsRect(PyObject *obj) + */ +#define pgRect_AsRect(x) (((pgRectObject *)x)->r) + +#ifndef PYGAMEAPI_RECT_INTERNAL + +/** + * \brief The Pygame rectangle object type pygame.Rect. + */ +#define pgRect_Type (*(PyTypeObject *)PYGAMEAPI_GET_SLOT(rect, 0)) + +/** + * \brief Check if *obj* is a `pygame.Rect` instance. + * + * \returns true if *obj* is a `pygame.Rect` instance + */ +#define pgRect_Check(obj) ((obj)->ob_type == &pgRect_Type) + +/** + * \brief Create a new `pygame.Rect` instance. + * + * \param r A pointer to an SDL_Rect struct. + * \returns a new `pygame.Rect` object for the SDL_Rect *r*. + * Returns *NULL* on error. + * + * \note PyObject* pgRect_New(SDL_Rect *r) + */ +#define pgRect_New (*(PyObject * (*)(SDL_Rect *)) PYGAMEAPI_GET_SLOT(rect, 1)) + +/** + * \brief Create a new `pygame.Rect` instance from x, y, w, h. + * + * \param x The x coordinate of the rectangle. + * \param y The y coordinate of the rectangle. + * \param w The width of the rectangle. + * \param h The height of the rectangle. + * \returns a new `pygame.Rect` object. Returns *NULL* on error. + * + * \note PyObject* pgRect_New4(int x, int y, int w, int h) + */ +#define pgRect_New4 \ + (*(PyObject * (*)(int, int, int, int)) PYGAMEAPI_GET_SLOT(rect, 2)) + +/** + * \brief Convert a Python object to a `pygame.Rect` instance. + * + * \param obj A Python object. + * A rectangle can be a length 4 sequence integers (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. + * + * \param temp A pointer to an SDL_Rect struct to store the result in. + * \returns a pointer to the SDL_Rect field of the `pygame.Rect` instance + * *obj*. Returns *NULL* on error. + * + * \note This function will clear any Python errors. + * \note SDL_Rect* pgRect_FromObject(PyObject *obj, SDL_Rect *temp) + */ +#define pgRect_FromObject \ + (*(SDL_Rect * (*)(PyObject *, SDL_Rect *)) PYGAMEAPI_GET_SLOT(rect, 3)) + +/** + * \brief Normalize a `pygame.Rect` instance. A rect with a negative size + * (negative width and/or height) will be adjusted to have a positive size. + * + * \param rect A pointer to a `pygame.Rect` instance. + * \returns *rect* normalized with positive values only. + * + * \note void pgRect_Normalize(SDL_Rect *rect) + */ +#define pgRect_Normalize (*(void (*)(SDL_Rect *))PYGAMEAPI_GET_SLOT(rect, 4)) + +#define import_pygame_rect() IMPORT_PYGAME_MODULE(rect) +#endif /* ~PYGAMEAPI_RECT_INTERNAL */ + +/* + * JOYSTICK module + */ +typedef struct pgJoystickObject { + PyObject_HEAD int id; + SDL_Joystick *joy; + + /* Joysticks form an intrusive linked list. + * + * Note that we don't maintain refcounts for these so they are weakrefs + * from the Python side. + */ + struct pgJoystickObject *next; + struct pgJoystickObject *prev; +} pgJoystickObject; + +#define pgJoystick_AsID(x) (((pgJoystickObject *)x)->id) +#define pgJoystick_AsSDL(x) (((pgJoystickObject *)x)->joy) + +#ifndef PYGAMEAPI_JOYSTICK_INTERNAL +#define pgJoystick_Type (*(PyTypeObject *)PYGAMEAPI_GET_SLOT(joystick, 0)) + +#define pgJoystick_Check(x) ((x)->ob_type == &pgJoystick_Type) +#define pgJoystick_New (*(PyObject * (*)(int)) PYGAMEAPI_GET_SLOT(joystick, 1)) + +#define import_pygame_joystick() IMPORT_PYGAME_MODULE(joystick) +#endif + +/* + * DISPLAY module + */ + +typedef struct { + Uint32 hw_available : 1; + Uint32 wm_available : 1; + Uint32 blit_hw : 1; + Uint32 blit_hw_CC : 1; + Uint32 blit_hw_A : 1; + Uint32 blit_sw : 1; + Uint32 blit_sw_CC : 1; + Uint32 blit_sw_A : 1; + Uint32 blit_fill : 1; + Uint32 video_mem; + SDL_PixelFormat *vfmt; + SDL_PixelFormat vfmt_data; + int current_w; + int current_h; +} pg_VideoInfo; + +/** + * A pygame object that wraps an SDL_VideoInfo struct. + * The object returned by `pygame.display.Info()` + */ +typedef struct { + PyObject_HEAD pg_VideoInfo info; +} pgVidInfoObject; + +/** + * \brief Convert a pgVidInfoObject to an SDL_VideoInfo. + * + * \note SDL_VideoInfo pgVidInfo_AsVidInfo(PyObject *obj) + * + * \returns the SDL_VideoInfo field of *obj*, a pgVidInfo_Type instance. + * \param obj A pgVidInfo_Type instance. + * + * \note Does not check that *obj* is not `NULL` or an `pgVidInfoObject` + * object. + */ +#define pgVidInfo_AsVidInfo(x) (((pgVidInfoObject *)x)->info) + +#ifndef PYGAMEAPI_DISPLAY_INTERNAL +/** + * \brief The pgVidInfoObject object Python type. + * \note pgVideoInfo_Type is used for the `pygame.display.Info()` object. + */ +#define pgVidInfo_Type (*(PyTypeObject *)PYGAMEAPI_GET_SLOT(display, 0)) + +/** + * \brief Check if *obj* is a pgVidInfoObject. + * + * \returns true if *x* is a `pgVidInfo_Type` instance + * \note Will return false if *x* is a subclass of `pgVidInfo_Type`. + * \note This macro does not check that *x* is not ``NULL``. + * \note int pgVidInfo_Check(PyObject *x) + */ +#define pgVidInfo_Check(x) ((x)->ob_type == &pgVidInfo_Type) + +/** + * \brief Create a new pgVidInfoObject. + * + * \param i A pointer to an SDL_VideoInfo struct. + * \returns a new `pgVidInfoObject` object for the SDL_VideoInfo *i*. + * + * \note PyObject* pgVidInfo_New(SDL_VideoInfo *i) + * \note On failure, raise a Python exception and return `NULL`. + */ +#define pgVidInfo_New \ + (*(PyObject * (*)(pg_VideoInfo *)) PYGAMEAPI_GET_SLOT(display, 1)) + +#define import_pygame_display() IMPORT_PYGAME_MODULE(display) +#endif /* ~PYGAMEAPI_DISPLAY_INTERNAL */ + +/* + * SURFACE module + */ +struct pgSubSurface_Data; +struct SDL_Surface; + +/** + * \brief A pygame object that wraps an SDL_Surface. A `pygame.Surface` + * instance. + */ +typedef struct { + PyObject_HEAD struct SDL_Surface *surf; + /** + * \brief If true, the surface will be freed when the python object is + * destroyed. + */ + int owner; + /** + * \brief The subsurface data for this surface (if a subsurface). + */ + struct pgSubSurface_Data *subsurface; + /** + * \brief A list of weak references to this surface. + */ + PyObject *weakreflist; + /** + * \brief A list of locks for this surface. + */ + PyObject *locklist; + /** + * \brief Usually a buffer object which the surface gets its data from. + */ + PyObject *dependency; +} pgSurfaceObject; + +/** + * \brief Convert a `pygame.Surface` instance to an SDL_Surface. + * + * \param x A `pygame.Surface` instance. + * \returns the SDL_Surface field of *x*, a `pygame.Surface` instance. + * + * \note SDL_Surface* pgSurface_AsSurface(PyObject *x) + */ +#define pgSurface_AsSurface(x) (((pgSurfaceObject *)x)->surf) + +#ifndef PYGAMEAPI_SURFACE_INTERNAL +/** + * \brief The `pygame.Surface` object Python type. + */ +#define pgSurface_Type (*(PyTypeObject *)PYGAMEAPI_GET_SLOT(surface, 0)) + +/** + * \brief Check if *x* is a `pygame.Surface` instance. + * + * \param x The object to check. + * \returns true if *x* is a `pygame.Surface` instance + * + * \note Will return false if *x* is a subclass of `pygame.Surface`. + * \note This macro does not check that *x* is not ``NULL``. + * \note int pgSurface_Check(PyObject *x) + */ +#define pgSurface_Check(x) \ + (PyObject_IsInstance((x), (PyObject *)&pgSurface_Type)) + +/** + * \brief Create a new `pygame.Surface` instance. + * + * \param s The SDL surface to wrap in a python object. + * \param owner If true, the surface will be freed when the python object is + * destroyed. \returns A new new pygame surface instance for SDL surface *s*. + * Returns *NULL* on error. + * + * \note pgSurfaceObject* pgSurface_New2(SDL_Surface *s, int owner) + */ +#define pgSurface_New2 \ + (*(pgSurfaceObject * (*)(SDL_Surface *, int)) \ + PYGAMEAPI_GET_SLOT(surface, 1)) + +/** + * \brief Sets the SDL surface for a `pygame.Surface` instance. + * + * \param self The `pygame.Surface` instance to set the surface for. + * \param s The SDL surface to set. + * \param owner If true, the surface will be freed when the python object is + * destroyed. \returns 0 on success, -1 on failure. + * + * \note int pgSurface_SetSurface(pgSurfaceObject *self, SDL_Surface *s, int + * owner) + */ +#define pgSurface_SetSurface \ + (*(int (*)(pgSurfaceObject *, SDL_Surface *, int))PYGAMEAPI_GET_SLOT( \ + surface, 3)) + +/** + * \brief Blit one surface onto another. + * + * \param dstobj The destination surface. + * \param srcobj The source surface. + * \param dstrect The destination rectangle. + * \param srcrect The source rectangle. + * \param the_args The blit flags. + * \return 0 for success, -1 or -2 for error. + * + * \note Is accessible through the C api. + * \note int pgSurface_Blit(PyObject *dstobj, PyObject *srcobj, SDL_Rect + * *dstrect, SDL_Rect *srcrect, int the_args) + */ +#define pgSurface_Blit \ + (*(int (*)(pgSurfaceObject *, pgSurfaceObject *, SDL_Rect *, SDL_Rect *, \ + int))PYGAMEAPI_GET_SLOT(surface, 2)) + +#define import_pygame_surface() \ + do { \ + IMPORT_PYGAME_MODULE(surface); \ + if (PyErr_Occurred() != NULL) \ + break; \ + IMPORT_PYGAME_MODULE(surflock); \ + } while (0) + +#define pgSurface_New(surface) pgSurface_New2((surface), 1) +#define pgSurface_NewNoOwn(surface) pgSurface_New2((surface), 0) + +#endif /* ~PYGAMEAPI_SURFACE_INTERNAL */ + +/* + * SURFLOCK module + * auto imported/initialized by surface + */ +#ifndef PYGAMEAPI_SURFLOCK_INTERNAL +#define pgLifetimeLock_Type (*(PyTypeObject *)PYGAMEAPI_GET_SLOT(surflock, 0)) + +#define pgLifetimeLock_Check(x) ((x)->ob_type == &pgLifetimeLock_Type) + +#define pgSurface_Prep(x) \ + if ((x)->subsurface) \ + (*(*(void (*)(pgSurfaceObject *))PYGAMEAPI_GET_SLOT(surflock, 1)))(x) + +#define pgSurface_Unprep(x) \ + if ((x)->subsurface) \ + (*(*(void (*)(pgSurfaceObject *))PYGAMEAPI_GET_SLOT(surflock, 2)))(x) + +#define pgSurface_Lock \ + (*(int (*)(pgSurfaceObject *))PYGAMEAPI_GET_SLOT(surflock, 3)) + +#define pgSurface_Unlock \ + (*(int (*)(pgSurfaceObject *))PYGAMEAPI_GET_SLOT(surflock, 4)) + +#define pgSurface_LockBy \ + (*(int (*)(pgSurfaceObject *, PyObject *))PYGAMEAPI_GET_SLOT(surflock, 5)) + +#define pgSurface_UnlockBy \ + (*(int (*)(pgSurfaceObject *, PyObject *))PYGAMEAPI_GET_SLOT(surflock, 6)) + +#define pgSurface_LockLifetime \ + (*(PyObject * (*)(PyObject *, PyObject *)) PYGAMEAPI_GET_SLOT(surflock, 7)) +#endif + +/* + * EVENT module + */ +typedef struct pgEventObject pgEventObject; + +#ifndef PYGAMEAPI_EVENT_INTERNAL +#define pgEvent_Type (*(PyTypeObject *)PYGAMEAPI_GET_SLOT(event, 0)) + +#define pgEvent_Check(x) ((x)->ob_type == &pgEvent_Type) + +#define pgEvent_New \ + (*(PyObject * (*)(SDL_Event *)) PYGAMEAPI_GET_SLOT(event, 1)) + +#define pgEvent_New2 \ + (*(PyObject * (*)(int, PyObject *)) PYGAMEAPI_GET_SLOT(event, 2)) + +#define pgEvent_FillUserEvent \ + (*(int (*)(pgEventObject *, SDL_Event *))PYGAMEAPI_GET_SLOT(event, 3)) + +#define pg_EnableKeyRepeat (*(int (*)(int, int))PYGAMEAPI_GET_SLOT(event, 4)) + +#define pg_GetKeyRepeat (*(void (*)(int *, int *))PYGAMEAPI_GET_SLOT(event, 5)) + +#define import_pygame_event() IMPORT_PYGAME_MODULE(event) +#endif + +/* + * RWOBJECT module + * the rwobject are only needed for C side work, not accessible from python. + */ +#ifndef PYGAMEAPI_RWOBJECT_INTERNAL +#define pgRWops_FromObject \ + (*(SDL_RWops * (*)(PyObject *, char **)) PYGAMEAPI_GET_SLOT(rwobject, 0)) + +#define pgRWops_IsFileObject \ + (*(int (*)(SDL_RWops *))PYGAMEAPI_GET_SLOT(rwobject, 1)) + +#define pg_EncodeFilePath \ + (*(PyObject * (*)(PyObject *, PyObject *)) PYGAMEAPI_GET_SLOT(rwobject, 2)) + +#define pg_EncodeString \ + (*(PyObject * (*)(PyObject *, const char *, const char *, PyObject *)) \ + PYGAMEAPI_GET_SLOT(rwobject, 3)) + +#define pgRWops_FromFileObject \ + (*(SDL_RWops * (*)(PyObject *)) PYGAMEAPI_GET_SLOT(rwobject, 4)) + +#define pgRWops_ReleaseObject \ + (*(int (*)(SDL_RWops *))PYGAMEAPI_GET_SLOT(rwobject, 5)) + +#define import_pygame_rwobject() IMPORT_PYGAME_MODULE(rwobject) + +#endif + +/* + * PixelArray module + */ +#ifndef PYGAMEAPI_PIXELARRAY_INTERNAL +#define PyPixelArray_Type ((PyTypeObject *)PYGAMEAPI_GET_SLOT(pixelarray, 0)) + +#define PyPixelArray_Check(x) ((x)->ob_type == &PyPixelArray_Type) +#define PyPixelArray_New (*(PyObject * (*)) PYGAMEAPI_GET_SLOT(pixelarray, 1)) + +#define import_pygame_pixelarray() IMPORT_PYGAME_MODULE(pixelarray) +#endif /* PYGAMEAPI_PIXELARRAY_INTERNAL */ + +/* + * Color module + */ +typedef struct pgColorObject pgColorObject; + +#ifndef PYGAMEAPI_COLOR_INTERNAL +#define pgColor_Type (*(PyObject *)PYGAMEAPI_GET_SLOT(color, 0)) + +#define pgColor_Check(x) ((x)->ob_type == &pgColor_Type) +#define pgColor_New (*(PyObject * (*)(Uint8 *)) PYGAMEAPI_GET_SLOT(color, 1)) + +#define pgColor_NewLength \ + (*(PyObject * (*)(Uint8 *, Uint8)) PYGAMEAPI_GET_SLOT(color, 3)) + +#define pg_RGBAFromColorObj \ + (*(int (*)(PyObject *, Uint8 *))PYGAMEAPI_GET_SLOT(color, 2)) + +#define pg_RGBAFromFuzzyColorObj \ + (*(int (*)(PyObject *, Uint8 *))PYGAMEAPI_GET_SLOT(color, 4)) + +#define pgColor_AsArray(x) (((pgColorObject *)x)->data) +#define pgColor_NumComponents(x) (((pgColorObject *)x)->len) + +#define import_pygame_color() IMPORT_PYGAME_MODULE(color) +#endif /* PYGAMEAPI_COLOR_INTERNAL */ + +/* + * Math module + */ +#ifndef PYGAMEAPI_MATH_INTERNAL +#define pgVector2_Check(x) \ + ((x)->ob_type == (PyTypeObject *)PYGAMEAPI_GET_SLOT(math, 0)) + +#define pgVector3_Check(x) \ + ((x)->ob_type == (PyTypeObject *)PYGAMEAPI_GET_SLOT(math, 1)) +/* +#define pgVector2_New \ + (*(PyObject*(*)) \ + PYGAMEAPI_GET_SLOT(PyGAME_C_API, 1)) +*/ +#define import_pygame_math() IMPORT_PYGAME_MODULE(math) +#endif /* PYGAMEAPI_MATH_INTERNAL */ + +#define IMPORT_PYGAME_MODULE _IMPORT_PYGAME_MODULE + +/* + * base pygame API slots + * disable slots with NO_PYGAME_C_API + */ +#ifdef PYGAME_H +PYGAMEAPI_DEFINE_SLOTS(base); +PYGAMEAPI_DEFINE_SLOTS(rect); +PYGAMEAPI_DEFINE_SLOTS(cdrom); +PYGAMEAPI_DEFINE_SLOTS(joystick); +PYGAMEAPI_DEFINE_SLOTS(display); +PYGAMEAPI_DEFINE_SLOTS(surface); +PYGAMEAPI_DEFINE_SLOTS(surflock); +PYGAMEAPI_DEFINE_SLOTS(event); +PYGAMEAPI_DEFINE_SLOTS(rwobject); +PYGAMEAPI_DEFINE_SLOTS(pixelarray); +PYGAMEAPI_DEFINE_SLOTS(color); +PYGAMEAPI_DEFINE_SLOTS(math); +#else /* ~PYGAME_H */ +PYGAMEAPI_EXTERN_SLOTS(base); +PYGAMEAPI_EXTERN_SLOTS(rect); +PYGAMEAPI_EXTERN_SLOTS(cdrom); +PYGAMEAPI_EXTERN_SLOTS(joystick); +PYGAMEAPI_EXTERN_SLOTS(display); +PYGAMEAPI_EXTERN_SLOTS(surface); +PYGAMEAPI_EXTERN_SLOTS(surflock); +PYGAMEAPI_EXTERN_SLOTS(event); +PYGAMEAPI_EXTERN_SLOTS(rwobject); +PYGAMEAPI_EXTERN_SLOTS(pixelarray); +PYGAMEAPI_EXTERN_SLOTS(color); +PYGAMEAPI_EXTERN_SLOTS(math); +#endif /* ~PYGAME_H */ + +#endif /* PYGAME_H */ + +/* Use the end of this file for other cross module inline utility + * functions There seems to be no good reason to stick to macro only + * functions in Python 3. + */ + +static PG_INLINE PyObject * +pg_tuple_couple_from_values_int(int val1, int val2) +{ + /* This function turns two input integers into a python tuple object. + * Currently, 5th November 2022, this is faster than using Py_BuildValue + * to do the same thing. + */ + PyObject *tup = PyTuple_New(2); + if (!tup) { + return NULL; + } + + PyObject *tmp = PyLong_FromLong(val1); + if (!tmp) { + Py_DECREF(tup); + return NULL; + } + PyTuple_SET_ITEM(tup, 0, tmp); + + tmp = PyLong_FromLong(val2); + if (!tmp) { + Py_DECREF(tup); + return NULL; + } + PyTuple_SET_ITEM(tup, 1, tmp); + + return tup; +} + +static PG_INLINE PyObject * +pg_tuple_triple_from_values_int(int val1, int val2, int val3) +{ + /* This function turns three input integers into a python tuple object. + * Currently, 5th November 2022, this is faster than using Py_BuildValue + * to do the same thing. + */ + PyObject *tup = PyTuple_New(3); + if (!tup) { + return NULL; + } + + PyObject *tmp = PyLong_FromLong(val1); + if (!tmp) { + Py_DECREF(tup); + return NULL; + } + PyTuple_SET_ITEM(tup, 0, tmp); + + tmp = PyLong_FromLong(val2); + if (!tmp) { + Py_DECREF(tup); + return NULL; + } + PyTuple_SET_ITEM(tup, 1, tmp); + + tmp = PyLong_FromLong(val3); + if (!tmp) { + Py_DECREF(tup); + return NULL; + } + PyTuple_SET_ITEM(tup, 2, tmp); + + return tup; +} diff --git a/yap_lab_3/.venv/include/site/python3.12/pygame/include/bitmask.h b/yap_lab_3/.venv/include/site/python3.12/pygame/include/bitmask.h new file mode 100644 index 0000000..eee09b7 --- /dev/null +++ b/yap_lab_3/.venv/include/site/python3.12/pygame/include/bitmask.h @@ -0,0 +1,171 @@ +/* + Bitmask 1.7 - A pixel-perfect collision detection library. + + Copyright (C) 2002-2005 Ulf Ekstrom except for the bitcount + function which is copyright (C) Donald W. Gillies, 1992. + + This library is free software; you can redistribute it and/or + modify it under the terms of the GNU Library General Public + License as published by the Free Software Foundation; either + version 2 of the License, or (at your option) any later version. + + This library is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU + Library General Public License for more details. + + You should have received a copy of the GNU Library General Public + License along with this library; if not, write to the Free + Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +#ifndef BITMASK_H +#define BITMASK_H + +#ifdef __cplusplus +extern "C" { +#endif + +#include +/* Define INLINE for different compilers. If your compiler does not + support inlining then there might be a performance hit in + bitmask_overlap_area(). +*/ +#ifndef INLINE +#ifdef __GNUC__ +#define INLINE inline +#else +#ifdef _MSC_VER +#define INLINE __inline +#else +#define INLINE +#endif +#endif +#endif + +#define BITMASK_W unsigned long int +#define BITMASK_W_LEN (sizeof(BITMASK_W) * CHAR_BIT) +#define BITMASK_W_MASK (BITMASK_W_LEN - 1) +#define BITMASK_N(n) ((BITMASK_W)1 << (n)) + +typedef struct bitmask { + int w, h; + BITMASK_W bits[1]; +} bitmask_t; + +/* Creates a bitmask of width w and height h, where + w and h must both be greater than or equal to 0. + The mask is automatically cleared when created. + */ +bitmask_t * +bitmask_create(int w, int h); + +/* Frees all the memory allocated by bitmask_create for m. */ +void +bitmask_free(bitmask_t *m); + +/* Create a copy of the given bitmask. */ +bitmask_t * +bitmask_copy(bitmask_t *m); + +/* Clears all bits in the mask */ +void +bitmask_clear(bitmask_t *m); + +/* Sets all bits in the mask */ +void +bitmask_fill(bitmask_t *m); + +/* Flips all bits in the mask */ +void +bitmask_invert(bitmask_t *m); + +/* Counts the bits in the mask */ +unsigned int +bitmask_count(bitmask_t *m); + +/* Returns nonzero if the bit at (x,y) is set. Coordinates start at + (0,0) */ +static INLINE int +bitmask_getbit(const bitmask_t *m, int x, int y) +{ + return (m->bits[x / BITMASK_W_LEN * m->h + y] & + BITMASK_N(x & BITMASK_W_MASK)) != 0; +} + +/* Sets the bit at (x,y) */ +static INLINE void +bitmask_setbit(bitmask_t *m, int x, int y) +{ + m->bits[x / BITMASK_W_LEN * m->h + y] |= BITMASK_N(x & BITMASK_W_MASK); +} + +/* Clears the bit at (x,y) */ +static INLINE void +bitmask_clearbit(bitmask_t *m, int x, int y) +{ + m->bits[x / BITMASK_W_LEN * m->h + y] &= ~BITMASK_N(x & BITMASK_W_MASK); +} + +/* Returns nonzero if the masks overlap with the given offset. + The overlap tests uses the following offsets (which may be negative): + + +----+----------.. + |A | yoffset + | +-+----------.. + +--|B + |xoffset + | | + : : +*/ +int +bitmask_overlap(const bitmask_t *a, const bitmask_t *b, int xoffset, + int yoffset); + +/* Like bitmask_overlap(), but will also give a point of intersection. + x and y are given in the coordinates of mask a, and are untouched + if there is no overlap. */ +int +bitmask_overlap_pos(const bitmask_t *a, const bitmask_t *b, int xoffset, + int yoffset, int *x, int *y); + +/* Returns the number of overlapping 'pixels' */ +int +bitmask_overlap_area(const bitmask_t *a, const bitmask_t *b, int xoffset, + int yoffset); + +/* Fills a mask with the overlap of two other masks. A bitwise AND. */ +void +bitmask_overlap_mask(const bitmask_t *a, const bitmask_t *b, bitmask_t *c, + int xoffset, int yoffset); + +/* Draws mask b onto mask a (bitwise OR). Can be used to compose large + (game background?) mask from several submasks, which may speed up + the testing. */ + +void +bitmask_draw(bitmask_t *a, const bitmask_t *b, int xoffset, int yoffset); + +void +bitmask_erase(bitmask_t *a, const bitmask_t *b, int xoffset, int yoffset); + +/* Return a new scaled bitmask, with dimensions w*h. The quality of the + scaling may not be perfect for all circumstances, but it should + be reasonable. If either w or h is 0 a clear 1x1 mask is returned. */ +bitmask_t * +bitmask_scale(const bitmask_t *m, int w, int h); + +/* Convolve b into a, drawing the output into o, shifted by offset. If offset + * is 0, then the (x,y) bit will be set if and only if + * bitmask_overlap(a, b, x - b->w - 1, y - b->h - 1) returns true. + * + * Modifies bits o[xoffset ... xoffset + a->w + b->w - 1) + * [yoffset ... yoffset + a->h + b->h - 1). */ +void +bitmask_convolve(const bitmask_t *a, const bitmask_t *b, bitmask_t *o, + int xoffset, int yoffset); + +#ifdef __cplusplus +} /* End of extern "C" { */ +#endif + +#endif diff --git a/yap_lab_3/.venv/include/site/python3.12/pygame/include/pgcompat.h b/yap_lab_3/.venv/include/site/python3.12/pygame/include/pgcompat.h new file mode 100644 index 0000000..3c09099 --- /dev/null +++ b/yap_lab_3/.venv/include/site/python3.12/pygame/include/pgcompat.h @@ -0,0 +1,102 @@ +#if !defined(PGCOMPAT_H) +#define PGCOMPAT_H + +#include + +/* In CPython, Py_Exit finalises the python interpreter before calling C exit() + * This does not exist on PyPy, so use exit() directly here */ +#ifdef PYPY_VERSION +#define PG_EXIT(n) exit(n) +#else +#define PG_EXIT(n) Py_Exit(n) +#endif + +/* define common types where SDL is not included */ +#ifndef SDL_VERSION_ATLEAST +#ifdef _MSC_VER +typedef unsigned __int8 uint8_t; +typedef unsigned __int32 uint32_t; +#else +#include +#endif +typedef uint32_t Uint32; +typedef uint8_t Uint8; +#endif /* no SDL */ + +#if defined(SDL_VERSION_ATLEAST) + +#ifndef SDL_WINDOW_VULKAN +#define SDL_WINDOW_VULKAN 0 +#endif + +#ifndef SDL_WINDOW_ALWAYS_ON_TOP +#define SDL_WINDOW_ALWAYS_ON_TOP 0 +#endif + +#ifndef SDL_WINDOW_SKIP_TASKBAR +#define SDL_WINDOW_SKIP_TASKBAR 0 +#endif + +#ifndef SDL_WINDOW_UTILITY +#define SDL_WINDOW_UTILITY 0 +#endif + +#ifndef SDL_WINDOW_TOOLTIP +#define SDL_WINDOW_TOOLTIP 0 +#endif + +#ifndef SDL_WINDOW_POPUP_MENU +#define SDL_WINDOW_POPUP_MENU 0 +#endif + +#ifndef SDL_WINDOW_INPUT_GRABBED +#define SDL_WINDOW_INPUT_GRABBED 0 +#endif + +#ifndef SDL_WINDOW_INPUT_FOCUS +#define SDL_WINDOW_INPUT_FOCUS 0 +#endif + +#ifndef SDL_WINDOW_MOUSE_FOCUS +#define SDL_WINDOW_MOUSE_FOCUS 0 +#endif + +#ifndef SDL_WINDOW_FOREIGN +#define SDL_WINDOW_FOREIGN 0 +#endif + +#ifndef SDL_WINDOW_ALLOW_HIGHDPI +#define SDL_WINDOW_ALLOW_HIGHDPI 0 +#endif + +#ifndef SDL_WINDOW_MOUSE_CAPTURE +#define SDL_WINDOW_MOUSE_CAPTURE 0 +#endif + +#ifndef SDL_WINDOW_ALWAYS_ON_TOP +#define SDL_WINDOW_ALWAYS_ON_TOP 0 +#endif + +#ifndef SDL_WINDOW_SKIP_TASKBAR +#define SDL_WINDOW_SKIP_TASKBAR 0 +#endif + +#ifndef SDL_WINDOW_UTILITY +#define SDL_WINDOW_UTILITY 0 +#endif + +#ifndef SDL_WINDOW_TOOLTIP +#define SDL_WINDOW_TOOLTIP 0 +#endif + +#ifndef SDL_WINDOW_POPUP_MENU +#define SDL_WINDOW_POPUP_MENU 0 +#endif + +#ifndef SDL_MOUSEWHEEL_FLIPPED +#define NO_SDL_MOUSEWHEEL_FLIPPED +#endif + +#endif /* defined(SDL_VERSION_ATLEAST) */ + +#endif /* ~defined(PGCOMPAT_H) */ diff --git a/yap_lab_3/.venv/include/site/python3.12/pygame/include/pgimport.h b/yap_lab_3/.venv/include/site/python3.12/pygame/include/pgimport.h new file mode 100644 index 0000000..2c2e8cf --- /dev/null +++ b/yap_lab_3/.venv/include/site/python3.12/pygame/include/pgimport.h @@ -0,0 +1,67 @@ +#ifndef PGIMPORT_H +#define PGIMPORT_H + +/* Prefix when importing module */ +#define IMPPREFIX "pygame." + +#include "pgcompat.h" + +#define PYGAMEAPI_LOCAL_ENTRY "_PYGAME_C_API" +#define PG_CAPSULE_NAME(m) (IMPPREFIX m "." PYGAMEAPI_LOCAL_ENTRY) + +/* + * fill API slots defined by PYGAMEAPI_DEFINE_SLOTS/PYGAMEAPI_EXTERN_SLOTS + */ +#define _IMPORT_PYGAME_MODULE(module) \ + { \ + PyObject *_mod_##module = PyImport_ImportModule(IMPPREFIX #module); \ + \ + if (_mod_##module != NULL) { \ + PyObject *_c_api = \ + PyObject_GetAttrString(_mod_##module, PYGAMEAPI_LOCAL_ENTRY); \ + \ + Py_DECREF(_mod_##module); \ + if (_c_api != NULL && PyCapsule_CheckExact(_c_api)) { \ + void **localptr = (void **)PyCapsule_GetPointer( \ + _c_api, PG_CAPSULE_NAME(#module)); \ + _PGSLOTS_##module = localptr; \ + } \ + Py_XDECREF(_c_api); \ + } \ + } + +#define PYGAMEAPI_IS_IMPORTED(module) (_PGSLOTS_##module != NULL) + +/* + * source file must include one of these in order to use _IMPORT_PYGAME_MODULE. + * this is set by import_pygame_*() functions. + * disable with NO_PYGAME_C_API + */ +#define PYGAMEAPI_DEFINE_SLOTS(module) void **_PGSLOTS_##module = NULL +#define PYGAMEAPI_EXTERN_SLOTS(module) extern void **_PGSLOTS_##module +#define PYGAMEAPI_GET_SLOT(module, index) _PGSLOTS_##module[(index)] + +/* + * disabled API with NO_PYGAME_C_API; do nothing instead + */ +#ifdef NO_PYGAME_C_API + +#undef PYGAMEAPI_DEFINE_SLOTS +#undef PYGAMEAPI_EXTERN_SLOTS + +#define PYGAMEAPI_DEFINE_SLOTS(module) +#define PYGAMEAPI_EXTERN_SLOTS(module) + +/* intentionally leave this defined to cause a compiler error * +#define PYGAMEAPI_GET_SLOT(api_root, index) +#undef PYGAMEAPI_GET_SLOT*/ + +#undef _IMPORT_PYGAME_MODULE +#define _IMPORT_PYGAME_MODULE(module) + +#endif /* NO_PYGAME_C_API */ + +#define encapsulate_api(ptr, module) \ + PyCapsule_New(ptr, PG_CAPSULE_NAME(module), NULL) + +#endif /* ~PGIMPORT_H */ diff --git a/yap_lab_3/.venv/include/site/python3.12/pygame/include/pgplatform.h b/yap_lab_3/.venv/include/site/python3.12/pygame/include/pgplatform.h new file mode 100644 index 0000000..9465dc5 --- /dev/null +++ b/yap_lab_3/.venv/include/site/python3.12/pygame/include/pgplatform.h @@ -0,0 +1,83 @@ +/* platform/compiler adjustments */ +#ifndef PG_PLATFORM_H +#define PG_PLATFORM_H + +#if defined(HAVE_SNPRINTF) /* defined in python.h (pyerrors.h) and SDL.h \ + (SDL_config.h) */ +#undef HAVE_SNPRINTF /* remove GCC redefine warning */ +#endif /* HAVE_SNPRINTF */ + +#ifndef PG_INLINE +#if defined(__clang__) +#define PG_INLINE __inline__ __attribute__((__unused__)) +#elif defined(__GNUC__) +#define PG_INLINE __inline__ +#elif defined(_MSC_VER) +#define PG_INLINE __inline +#elif defined(__STDC_VERSION__) && __STDC_VERSION__ >= 199901L +#define PG_INLINE inline +#else +#define PG_INLINE +#endif +#endif /* ~PG_INLINE */ + +// Worth trying this on MSVC/win32 builds to see if provides any speed up +#ifndef PG_FORCEINLINE +#if defined(__clang__) +#define PG_FORCEINLINE __inline__ __attribute__((__unused__)) +#elif defined(__GNUC__) +#define PG_FORCEINLINE __inline__ +#elif defined(_MSC_VER) +#define PG_FORCEINLINE __forceinline +#elif defined(__STDC_VERSION__) && __STDC_VERSION__ >= 199901L +#define PG_FORCEINLINE inline +#else +#define PG_FORCEINLINE +#endif +#endif /* ~PG_FORCEINLINE */ + +/* This is unconditionally defined in Python.h */ +#if defined(_POSIX_C_SOURCE) +#undef _POSIX_C_SOURCE +#endif + +#if defined(HAVE_SNPRINTF) +#undef HAVE_SNPRINTF +#endif + +/* SDL needs WIN32 */ +#if !defined(WIN32) && \ + (defined(MS_WIN32) || defined(_WIN32) || defined(__WIN32) || \ + defined(__WIN32__) || defined(_WINDOWS)) +#define WIN32 +#endif + +#ifndef PG_TARGET_SSE4_2 +#if defined(__clang__) || \ + (defined(__GNUC__) && \ + ((__GNUC__ == 4 && __GNUC_MINOR__ >= 9) || __GNUC__ >= 5)) +// The old gcc 4.8 on centos used by manylinux1 does not seem to get sse4.2 +// intrinsics +#define PG_FUNCTION_TARGET_SSE4_2 __attribute__((target("sse4.2"))) +// No else; we define the fallback later +#endif +#endif /* ~PG_TARGET_SSE4_2 */ + +#ifdef PG_FUNCTION_TARGET_SSE4_2 +#if !defined(__SSE4_2__) && !defined(PG_COMPILE_SSE4_2) +#if defined(__x86_64__) || defined(__i386__) +#define PG_COMPILE_SSE4_2 1 +#endif +#endif +#endif /* ~PG_TARGET_SSE4_2 */ + +/* Fallback definition of target attribute */ +#ifndef PG_FUNCTION_TARGET_SSE4_2 +#define PG_FUNCTION_TARGET_SSE4_2 +#endif + +#ifndef PG_COMPILE_SSE4_2 +#define PG_COMPILE_SSE4_2 0 +#endif + +#endif /* ~PG_PLATFORM_H */ diff --git a/yap_lab_3/.venv/include/site/python3.12/pygame/include/pygame.h b/yap_lab_3/.venv/include/site/python3.12/pygame/include/pygame.h new file mode 100644 index 0000000..3772ae6 --- /dev/null +++ b/yap_lab_3/.venv/include/site/python3.12/pygame/include/pygame.h @@ -0,0 +1,34 @@ +/* + pygame - Python Game Library + Copyright (C) 2000-2001 Pete Shinners + + This library is free software; you can redistribute it and/or + modify it under the terms of the GNU Library General Public + License as published by the Free Software Foundation; either + version 2 of the License, or (at your option) any later version. + + This library is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU + Library General Public License for more details. + + You should have received a copy of the GNU Library General Public + License along with this library; if not, write to the Free + Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + + Pete Shinners + pete@shinners.org +*/ + +/* To allow the Pygame C api to be globally shared by all code within an + * extension module built from multiple C files, only include the pygame.h + * header within the top level C file, the one which calls the + * 'import_pygame_*' macros. All other C source files of the module should + * include _pygame.h instead. + */ +#ifndef PYGAME_H +#define PYGAME_H + +#include "_pygame.h" + +#endif diff --git a/yap_lab_3/.venv/include/site/python3.12/pygame/include/pygame_bufferproxy.h b/yap_lab_3/.venv/include/site/python3.12/pygame/include/pygame_bufferproxy.h new file mode 100644 index 0000000..9284ff2 --- /dev/null +++ b/yap_lab_3/.venv/include/site/python3.12/pygame/include/pygame_bufferproxy.h @@ -0,0 +1,56 @@ +/* + pygame - Python Game Library + Copyright (C) 2000-2001 Pete Shinners + Copyright (C) 2007 Rene Dudfield, Richard Goedeken + + This library is free software; you can redistribute it and/or + modify it under the terms of the GNU Library General Public + License as published by the Free Software Foundation; either + version 2 of the License, or (at your option) any later version. + + This library is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU + Library General Public License for more details. + + You should have received a copy of the GNU Library General Public + License along with this library; if not, write to the Free + Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + + Pete Shinners + pete@shinners.org +*/ + +/* Bufferproxy module C api. */ +#if !defined(PG_BUFPROXY_HEADER) +#define PG_BUFPROXY_HEADER + +#include + +typedef PyObject *(*_pgbufproxy_new_t)(PyObject *, getbufferproc); +typedef PyObject *(*_pgbufproxy_get_obj_t)(PyObject *); +typedef int (*_pgbufproxy_trip_t)(PyObject *); + +#ifndef PYGAMEAPI_BUFPROXY_INTERNAL + +#include "pgimport.h" + +PYGAMEAPI_DEFINE_SLOTS(bufferproxy); + +#define pgBufproxy_Type (*(PyTypeObject *)PYGAMEAPI_GET_SLOT(bufferproxy, 0)) + +#define pgBufproxy_Check(x) ((x)->ob_type == &pgBufproxy_Type) + +#define pgBufproxy_New (*(_pgbufproxy_new_t)PYGAMEAPI_GET_SLOT(bufferproxy, 1)) + +#define pgBufproxy_GetParent \ + (*(_pgbufproxy_get_obj_t)PYGAMEAPI_GET_SLOT(bufferproxy, 2)) + +#define pgBufproxy_Trip \ + (*(_pgbufproxy_trip_t)PYGAMEAPI_GET_SLOT(bufferproxy, 3)) + +#define import_pygame_bufferproxy() _IMPORT_PYGAME_MODULE(bufferproxy) + +#endif /* ~PYGAMEAPI_BUFPROXY_INTERNAL */ + +#endif /* ~defined(PG_BUFPROXY_HEADER) */ diff --git a/yap_lab_3/.venv/include/site/python3.12/pygame/include/pygame_font.h b/yap_lab_3/.venv/include/site/python3.12/pygame/include/pygame_font.h new file mode 100644 index 0000000..aae41bf --- /dev/null +++ b/yap_lab_3/.venv/include/site/python3.12/pygame/include/pygame_font.h @@ -0,0 +1,50 @@ +/* + pygame - Python Game Library + Copyright (C) 2000-2001 Pete Shinners + + This library is free software; you can redistribute it and/or + modify it under the terms of the GNU Library General Public + License as published by the Free Software Foundation; either + version 2 of the License, or (at your option) any later version. + + This library is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU + Library General Public License for more details. + + You should have received a copy of the GNU Library General Public + License along with this library; if not, write to the Free + Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + + Pete Shinners + pete@shinners.org +*/ + +#include +#include "pgplatform.h" + +struct TTF_Font; + +typedef struct { + PyObject_HEAD TTF_Font *font; + PyObject *weakreflist; + unsigned int ttf_init_generation; +} PyFontObject; +#define PyFont_AsFont(x) (((PyFontObject *)x)->font) + +#ifndef PYGAMEAPI_FONT_INTERNAL + +#include "pgimport.h" + +PYGAMEAPI_DEFINE_SLOTS(font); + +#define PyFont_Type (*(PyTypeObject *)PYGAMEAPI_GET_SLOT(font, 0)) +#define PyFont_Check(x) ((x)->ob_type == &PyFont_Type) + +#define PyFont_New (*(PyObject * (*)(TTF_Font *)) PYGAMEAPI_GET_SLOT(font, 1)) + +/*slot 2 taken by FONT_INIT_CHECK*/ + +#define import_pygame_font() _IMPORT_PYGAME_MODULE(font) + +#endif diff --git a/yap_lab_3/.venv/include/site/python3.12/pygame/include/pygame_freetype.h b/yap_lab_3/.venv/include/site/python3.12/pygame/include/pygame_freetype.h new file mode 100644 index 0000000..90172cc --- /dev/null +++ b/yap_lab_3/.venv/include/site/python3.12/pygame/include/pygame_freetype.h @@ -0,0 +1,42 @@ +/* + pygame - Python Game Library + Copyright (C) 2009 Vicent Marti + + This library is free software; you can redistribute it and/or + modify it under the terms of the GNU Library General Public + License as published by the Free Software Foundation; either + version 2 of the License, or (at your option) any later version. + + This library is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU + Library General Public License for more details. + + You should have received a copy of the GNU Library General Public + License along with this library; if not, write to the Free + Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + +*/ +#ifndef PYGAME_FREETYPE_H_ +#define PYGAME_FREETYPE_H_ + +#include "pgplatform.h" +#include "pgimport.h" +#include "pgcompat.h" + +#ifndef PYGAME_FREETYPE_INTERNAL + +PYGAMEAPI_DEFINE_SLOTS(_freetype); + +#define pgFont_Type (*(PyTypeObject *)PYGAMEAPI_GET_SLOT(_freetype, 0)) + +#define pgFont_Check(x) ((x)->ob_type == &pgFont_Type) + +#define pgFont_New \ + (*(PyObject * (*)(const char *, long)) PYGAMEAPI_GET_SLOT(_freetype, 1)) + +#define import_pygame_freetype() _IMPORT_PYGAME_MODULE(_freetype) + +#endif /* PYGAME_FREETYPE_INTERNAL */ + +#endif /* PYGAME_FREETYPE_H_ */ diff --git a/yap_lab_3/.venv/include/site/python3.12/pygame/include/pygame_mask.h b/yap_lab_3/.venv/include/site/python3.12/pygame/include/pygame_mask.h new file mode 100644 index 0000000..8dd8f17 --- /dev/null +++ b/yap_lab_3/.venv/include/site/python3.12/pygame/include/pygame_mask.h @@ -0,0 +1,45 @@ +/* + pygame - Python Game Library + + This library is free software; you can redistribute it and/or + modify it under the terms of the GNU Library General Public + License as published by the Free Software Foundation; either + version 2 of the License, or (at your option) any later version. + + This library is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU + Library General Public License for more details. + + You should have received a copy of the GNU Library General Public + License along with this library; if not, write to the Free + Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA +*/ + +#ifndef PGMASK_H +#define PGMASK_H + +#include +#include "bitmask.h" + +typedef struct { + PyObject_HEAD bitmask_t *mask; + void *bufdata; +} pgMaskObject; + +#define pgMask_AsBitmap(x) (((pgMaskObject *)x)->mask) + +#ifndef PYGAMEAPI_MASK_INTERNAL + +#include "pgimport.h" + +PYGAMEAPI_DEFINE_SLOTS(mask); + +#define pgMask_Type (*(PyTypeObject *)PYGAMEAPI_GET_SLOT(mask, 0)) +#define pgMask_Check(x) ((x)->ob_type == &pgMask_Type) + +#define import_pygame_mask() _IMPORT_PYGAME_MODULE(mask) + +#endif /* ~PYGAMEAPI_MASK_INTERNAL */ + +#endif /* ~PGMASK_H */ diff --git a/yap_lab_3/.venv/include/site/python3.12/pygame/include/pygame_mixer.h b/yap_lab_3/.venv/include/site/python3.12/pygame/include/pygame_mixer.h new file mode 100644 index 0000000..e19d273 --- /dev/null +++ b/yap_lab_3/.venv/include/site/python3.12/pygame/include/pygame_mixer.h @@ -0,0 +1,71 @@ +/* + pygame - Python Game Library + Copyright (C) 2000-2001 Pete Shinners + + This library is free software; you can redistribute it and/or + modify it under the terms of the GNU Library General Public + License as published by the Free Software Foundation; either + version 2 of the License, or (at your option) any later version. + + This library is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU + Library General Public License for more details. + + You should have received a copy of the GNU Library General Public + License along with this library; if not, write to the Free + Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + + Pete Shinners + pete@shinners.org +*/ + +#ifndef PGMIXER_H +#define PGMIXER_H + +#include +#include + +#include "pgcompat.h" + +struct Mix_Chunk; + +typedef struct { + PyObject_HEAD Mix_Chunk *chunk; + Uint8 *mem; + PyObject *weakreflist; +} pgSoundObject; + +typedef struct { + PyObject_HEAD int chan; +} pgChannelObject; + +#define pgSound_AsChunk(x) (((pgSoundObject *)x)->chunk) +#define pgChannel_AsInt(x) (((pgChannelObject *)x)->chan) + +#include "pgimport.h" + +#ifndef PYGAMEAPI_MIXER_INTERNAL + +PYGAMEAPI_DEFINE_SLOTS(mixer); + +#define pgSound_Type (*(PyTypeObject *)PYGAMEAPI_GET_SLOT(mixer, 0)) + +#define pgSound_Check(x) ((x)->ob_type == &pgSound_Type) + +#define pgSound_New \ + (*(PyObject * (*)(Mix_Chunk *)) PYGAMEAPI_GET_SLOT(mixer, 1)) + +#define pgSound_Play \ + (*(PyObject * (*)(PyObject *, PyObject *)) PYGAMEAPI_GET_SLOT(mixer, 2)) + +#define pgChannel_Type (*(PyTypeObject *)PYGAMEAPI_GET_SLOT(mixer, 3)) +#define pgChannel_Check(x) ((x)->ob_type == &pgChannel_Type) + +#define pgChannel_New (*(PyObject * (*)(int)) PYGAMEAPI_GET_SLOT(mixer, 4)) + +#define import_pygame_mixer() _IMPORT_PYGAME_MODULE(mixer) + +#endif /* PYGAMEAPI_MIXER_INTERNAL */ + +#endif /* ~PGMIXER_H */ diff --git a/yap_lab_3/.venv/include/site/python3.12/pygame/include/sse2neon.h b/yap_lab_3/.venv/include/site/python3.12/pygame/include/sse2neon.h new file mode 100644 index 0000000..a3e3ac0 --- /dev/null +++ b/yap_lab_3/.venv/include/site/python3.12/pygame/include/sse2neon.h @@ -0,0 +1,6203 @@ +#ifndef SSE2NEON_H +#define SSE2NEON_H + +// This header file provides a simple API translation layer +// between SSE intrinsics to their corresponding Arm/Aarch64 NEON versions +// +// This header file does not yet translate all of the SSE intrinsics. +// +// Contributors to this work are: +// John W. Ratcliff +// Brandon Rowlett +// Ken Fast +// Eric van Beurden +// Alexander Potylitsin +// Hasindu Gamaarachchi +// Jim Huang +// Mark Cheng +// Malcolm James MacLeod +// Devin Hussey (easyaspi314) +// Sebastian Pop +// Developer Ecosystem Engineering +// Danila Kutenin +// François Turban (JishinMaster) +// Pei-Hsuan Hung +// Yang-Hao Yuan + +/* + * sse2neon is freely redistributable under the MIT License. + * + * 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. + */ + +/* Tunable configurations */ + +/* Enable precise implementation of _mm_min_ps and _mm_max_ps + * This would slow down the computation a bit, but gives consistent result with + * x86 SSE2. (e.g. would solve a hole or NaN pixel in the rendering result) + */ +#ifndef SSE2NEON_PRECISE_MINMAX +#define SSE2NEON_PRECISE_MINMAX (0) +#endif + +#if defined(__GNUC__) || defined(__clang__) +#pragma push_macro("FORCE_INLINE") +#pragma push_macro("ALIGN_STRUCT") +#define FORCE_INLINE static inline __attribute__((always_inline)) +#define ALIGN_STRUCT(x) __attribute__((aligned(x))) +#else +#error "Macro name collisions may happen with unsupported compiler." +#ifdef FORCE_INLINE +#undef FORCE_INLINE +#endif +#define FORCE_INLINE static inline +#ifndef ALIGN_STRUCT +#define ALIGN_STRUCT(x) __declspec(align(x)) +#endif +#endif + +#include +#include + +// These cause the build to fail on raspberry pi with 'unsupported target' +// and don't seem to do anything particularly useful +///* Architecture-specific build options */ +///* FIXME: #pragma GCC push_options is only available on GCC */ +//#if defined(__GNUC__) +//#if defined(__arm__) && __ARM_ARCH == 7 +///* According to ARM C Language Extensions Architecture specification, +// * __ARM_NEON is defined to a value indicating the Advanced SIMD (NEON) +// * architecture supported. +// */ +//#if !defined(__ARM_NEON) || !defined(__ARM_NEON__) +//#error "You must enable NEON instructions (e.g. -mfpu=neon) to use SSE2NEON." +//#endif +//#pragma GCC push_options +//#pragma GCC target("fpu=neon") +//#elif defined(__aarch64__) +//#pragma GCC push_options +//#pragma GCC target("+simd") +//#else +//#error "Unsupported target. Must be either ARMv7-A+NEON or ARMv8-A." +//#endif +//#endif + +#include + +/* Rounding functions require either Aarch64 instructions or libm failback */ +#if !defined(__aarch64__) +#include +#endif + +/* "__has_builtin" can be used to query support for built-in functions + * provided by gcc/clang and other compilers that support it. + */ +#ifndef __has_builtin /* GCC prior to 10 or non-clang compilers */ +/* Compatibility with gcc <= 9 */ +#if __GNUC__ <= 9 +#define __has_builtin(x) HAS##x +#define HAS__builtin_popcount 1 +#define HAS__builtin_popcountll 1 +#else +#define __has_builtin(x) 0 +#endif +#endif + +/** + * MACRO for shuffle parameter for _mm_shuffle_ps(). + * Argument fp3 is a digit[0123] that represents the fp from argument "b" + * of mm_shuffle_ps that will be placed in fp3 of result. fp2 is the same + * for fp2 in result. fp1 is a digit[0123] that represents the fp from + * argument "a" of mm_shuffle_ps that will be places in fp1 of result. + * fp0 is the same for fp0 of result. + */ +#define _MM_SHUFFLE(fp3, fp2, fp1, fp0) \ + (((fp3) << 6) | ((fp2) << 4) | ((fp1) << 2) | ((fp0))) + +/* Rounding mode macros. */ +#define _MM_FROUND_TO_NEAREST_INT 0x00 +#define _MM_FROUND_TO_NEG_INF 0x01 +#define _MM_FROUND_TO_POS_INF 0x02 +#define _MM_FROUND_TO_ZERO 0x03 +#define _MM_FROUND_CUR_DIRECTION 0x04 +#define _MM_FROUND_NO_EXC 0x08 + +/* indicate immediate constant argument in a given range */ +#define __constrange(a, b) const + +/* A few intrinsics accept traditional data types like ints or floats, but + * most operate on data types that are specific to SSE. + * If a vector type ends in d, it contains doubles, and if it does not have + * a suffix, it contains floats. An integer vector type can contain any type + * of integer, from chars to shorts to unsigned long longs. + */ +typedef int64x1_t __m64; +typedef float32x4_t __m128; /* 128-bit vector containing 4 floats */ +// On ARM 32-bit architecture, the float64x2_t is not supported. +// The data type __m128d should be represented in a different way for related +// intrinsic conversion. +#if defined(__aarch64__) +typedef float64x2_t __m128d; /* 128-bit vector containing 2 doubles */ +#else +typedef float32x4_t __m128d; +#endif +typedef int64x2_t __m128i; /* 128-bit vector containing integers */ + +/* type-safe casting between types */ + +#define vreinterpretq_m128_f16(x) vreinterpretq_f32_f16(x) +#define vreinterpretq_m128_f32(x) (x) +#define vreinterpretq_m128_f64(x) vreinterpretq_f32_f64(x) + +#define vreinterpretq_m128_u8(x) vreinterpretq_f32_u8(x) +#define vreinterpretq_m128_u16(x) vreinterpretq_f32_u16(x) +#define vreinterpretq_m128_u32(x) vreinterpretq_f32_u32(x) +#define vreinterpretq_m128_u64(x) vreinterpretq_f32_u64(x) + +#define vreinterpretq_m128_s8(x) vreinterpretq_f32_s8(x) +#define vreinterpretq_m128_s16(x) vreinterpretq_f32_s16(x) +#define vreinterpretq_m128_s32(x) vreinterpretq_f32_s32(x) +#define vreinterpretq_m128_s64(x) vreinterpretq_f32_s64(x) + +#define vreinterpretq_f16_m128(x) vreinterpretq_f16_f32(x) +#define vreinterpretq_f32_m128(x) (x) +#define vreinterpretq_f64_m128(x) vreinterpretq_f64_f32(x) + +#define vreinterpretq_u8_m128(x) vreinterpretq_u8_f32(x) +#define vreinterpretq_u16_m128(x) vreinterpretq_u16_f32(x) +#define vreinterpretq_u32_m128(x) vreinterpretq_u32_f32(x) +#define vreinterpretq_u64_m128(x) vreinterpretq_u64_f32(x) + +#define vreinterpretq_s8_m128(x) vreinterpretq_s8_f32(x) +#define vreinterpretq_s16_m128(x) vreinterpretq_s16_f32(x) +#define vreinterpretq_s32_m128(x) vreinterpretq_s32_f32(x) +#define vreinterpretq_s64_m128(x) vreinterpretq_s64_f32(x) + +#define vreinterpretq_m128i_s8(x) vreinterpretq_s64_s8(x) +#define vreinterpretq_m128i_s16(x) vreinterpretq_s64_s16(x) +#define vreinterpretq_m128i_s32(x) vreinterpretq_s64_s32(x) +#define vreinterpretq_m128i_s64(x) (x) + +#define vreinterpretq_m128i_u8(x) vreinterpretq_s64_u8(x) +#define vreinterpretq_m128i_u16(x) vreinterpretq_s64_u16(x) +#define vreinterpretq_m128i_u32(x) vreinterpretq_s64_u32(x) +#define vreinterpretq_m128i_u64(x) vreinterpretq_s64_u64(x) + +#define vreinterpretq_s8_m128i(x) vreinterpretq_s8_s64(x) +#define vreinterpretq_s16_m128i(x) vreinterpretq_s16_s64(x) +#define vreinterpretq_s32_m128i(x) vreinterpretq_s32_s64(x) +#define vreinterpretq_s64_m128i(x) (x) + +#define vreinterpretq_u8_m128i(x) vreinterpretq_u8_s64(x) +#define vreinterpretq_u16_m128i(x) vreinterpretq_u16_s64(x) +#define vreinterpretq_u32_m128i(x) vreinterpretq_u32_s64(x) +#define vreinterpretq_u64_m128i(x) vreinterpretq_u64_s64(x) + +#define vreinterpret_m64_s8(x) vreinterpret_s64_s8(x) +#define vreinterpret_m64_s16(x) vreinterpret_s64_s16(x) +#define vreinterpret_m64_s32(x) vreinterpret_s64_s32(x) +#define vreinterpret_m64_s64(x) (x) + +#define vreinterpret_m64_u8(x) vreinterpret_s64_u8(x) +#define vreinterpret_m64_u16(x) vreinterpret_s64_u16(x) +#define vreinterpret_m64_u32(x) vreinterpret_s64_u32(x) +#define vreinterpret_m64_u64(x) vreinterpret_s64_u64(x) + +#define vreinterpret_m64_f16(x) vreinterpret_s64_f16(x) +#define vreinterpret_m64_f32(x) vreinterpret_s64_f32(x) +#define vreinterpret_m64_f64(x) vreinterpret_s64_f64(x) + +#define vreinterpret_u8_m64(x) vreinterpret_u8_s64(x) +#define vreinterpret_u16_m64(x) vreinterpret_u16_s64(x) +#define vreinterpret_u32_m64(x) vreinterpret_u32_s64(x) +#define vreinterpret_u64_m64(x) vreinterpret_u64_s64(x) + +#define vreinterpret_s8_m64(x) vreinterpret_s8_s64(x) +#define vreinterpret_s16_m64(x) vreinterpret_s16_s64(x) +#define vreinterpret_s32_m64(x) vreinterpret_s32_s64(x) +#define vreinterpret_s64_m64(x) (x) + +#define vreinterpret_f32_m64(x) vreinterpret_f32_s64(x) + +#if defined(__aarch64__) +#define vreinterpretq_m128d_s32(x) vreinterpretq_f64_s32(x) +#define vreinterpretq_m128d_s64(x) vreinterpretq_f64_s64(x) + +#define vreinterpretq_m128d_f64(x) (x) + +#define vreinterpretq_s64_m128d(x) vreinterpretq_s64_f64(x) + +#define vreinterpretq_f64_m128d(x) (x) +#else +#define vreinterpretq_m128d_s32(x) vreinterpretq_f32_s32(x) +#define vreinterpretq_m128d_s64(x) vreinterpretq_f32_s64(x) + +#define vreinterpretq_m128d_f32(x) (x) + +#define vreinterpretq_s64_m128d(x) vreinterpretq_s64_f32(x) + +#define vreinterpretq_f32_m128d(x) (x) +#endif + +// A struct is defined in this header file called 'SIMDVec' which can be used +// by applications which attempt to access the contents of an _m128 struct +// directly. It is important to note that accessing the __m128 struct directly +// is bad coding practice by Microsoft: @see: +// https://msdn.microsoft.com/en-us/library/ayeb3ayc.aspx +// +// However, some legacy source code may try to access the contents of an __m128 +// struct directly so the developer can use the SIMDVec as an alias for it. Any +// casting must be done manually by the developer, as you cannot cast or +// otherwise alias the base NEON data type for intrinsic operations. +// +// union intended to allow direct access to an __m128 variable using the names +// that the MSVC compiler provides. This union should really only be used when +// trying to access the members of the vector as integer values. GCC/clang +// allow native access to the float members through a simple array access +// operator (in C since 4.6, in C++ since 4.8). +// +// Ideally direct accesses to SIMD vectors should not be used since it can cause +// a performance hit. If it really is needed however, the original __m128 +// variable can be aliased with a pointer to this union and used to access +// individual components. The use of this union should be hidden behind a macro +// that is used throughout the codebase to access the members instead of always +// declaring this type of variable. +typedef union ALIGN_STRUCT(16) SIMDVec { + float m128_f32[4]; // as floats - DON'T USE. Added for convenience. + int8_t m128_i8[16]; // as signed 8-bit integers. + int16_t m128_i16[8]; // as signed 16-bit integers. + int32_t m128_i32[4]; // as signed 32-bit integers. + int64_t m128_i64[2]; // as signed 64-bit integers. + uint8_t m128_u8[16]; // as unsigned 8-bit integers. + uint16_t m128_u16[8]; // as unsigned 16-bit integers. + uint32_t m128_u32[4]; // as unsigned 32-bit integers. + uint64_t m128_u64[2]; // as unsigned 64-bit integers. +} SIMDVec; + +// casting using SIMDVec +#define vreinterpretq_nth_u64_m128i(x, n) (((SIMDVec *) &x)->m128_u64[n]) +#define vreinterpretq_nth_u32_m128i(x, n) (((SIMDVec *) &x)->m128_u32[n]) +#define vreinterpretq_nth_u8_m128i(x, n) (((SIMDVec *) &x)->m128_u8[n]) + +/* Backwards compatibility for compilers with lack of specific type support */ + +// Older gcc does not define vld1q_u8_x4 type +#if defined(__GNUC__) && !defined(__clang__) +#if __GNUC__ <= 9 +FORCE_INLINE uint8x16x4_t vld1q_u8_x4(const uint8_t *p) +{ + uint8x16x4_t ret; + ret.val[0] = vld1q_u8(p + 0); + ret.val[1] = vld1q_u8(p + 16); + ret.val[2] = vld1q_u8(p + 32); + ret.val[3] = vld1q_u8(p + 48); + return ret; +} +#endif +#endif + +/* Function Naming Conventions + * The naming convention of SSE intrinsics is straightforward. A generic SSE + * intrinsic function is given as follows: + * _mm__ + * + * The parts of this format are given as follows: + * 1. describes the operation performed by the intrinsic + * 2. identifies the data type of the function's primary arguments + * + * This last part, , is a little complicated. It identifies the + * content of the input values, and can be set to any of the following values: + * + ps - vectors contain floats (ps stands for packed single-precision) + * + pd - vectors cantain doubles (pd stands for packed double-precision) + * + epi8/epi16/epi32/epi64 - vectors contain 8-bit/16-bit/32-bit/64-bit + * signed integers + * + epu8/epu16/epu32/epu64 - vectors contain 8-bit/16-bit/32-bit/64-bit + * unsigned integers + * + si128 - unspecified 128-bit vector or 256-bit vector + * + m128/m128i/m128d - identifies input vector types when they are different + * than the type of the returned vector + * + * For example, _mm_setzero_ps. The _mm implies that the function returns + * a 128-bit vector. The _ps at the end implies that the argument vectors + * contain floats. + * + * A complete example: Byte Shuffle - pshufb (_mm_shuffle_epi8) + * // Set packed 16-bit integers. 128 bits, 8 short, per 16 bits + * __m128i v_in = _mm_setr_epi16(1, 2, 3, 4, 5, 6, 7, 8); + * // Set packed 8-bit integers + * // 128 bits, 16 chars, per 8 bits + * __m128i v_perm = _mm_setr_epi8(1, 0, 2, 3, 8, 9, 10, 11, + * 4, 5, 12, 13, 6, 7, 14, 15); + * // Shuffle packed 8-bit integers + * __m128i v_out = _mm_shuffle_epi8(v_in, v_perm); // pshufb + * + * Data (Number, Binary, Byte Index): + +------+------+-------------+------+------+-------------+ + | 1 | 2 | 3 | 4 | Number + +------+------+------+------+------+------+------+------+ + | 0000 | 0001 | 0000 | 0010 | 0000 | 0011 | 0000 | 0100 | Binary + +------+------+------+------+------+------+------+------+ + | 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | Index + +------+------+------+------+------+------+------+------+ + + +------+------+------+------+------+------+------+------+ + | 5 | 6 | 7 | 8 | Number + +------+------+------+------+------+------+------+------+ + | 0000 | 0101 | 0000 | 0110 | 0000 | 0111 | 0000 | 1000 | Binary + +------+------+------+------+------+------+------+------+ + | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | Index + +------+------+------+------+------+------+------+------+ + * Index (Byte Index): + +------+------+------+------+------+------+------+------+ + | 1 | 0 | 2 | 3 | 8 | 9 | 10 | 11 | + +------+------+------+------+------+------+------+------+ + + +------+------+------+------+------+------+------+------+ + | 4 | 5 | 12 | 13 | 6 | 7 | 14 | 15 | + +------+------+------+------+------+------+------+------+ + * Result: + +------+------+------+------+------+------+------+------+ + | 1 | 0 | 2 | 3 | 8 | 9 | 10 | 11 | Index + +------+------+------+------+------+------+------+------+ + | 0001 | 0000 | 0000 | 0010 | 0000 | 0101 | 0000 | 0110 | Binary + +------+------+------+------+------+------+------+------+ + | 256 | 2 | 5 | 6 | Number + +------+------+------+------+------+------+------+------+ + + +------+------+------+------+------+------+------+------+ + | 4 | 5 | 12 | 13 | 6 | 7 | 14 | 15 | Index + +------+------+------+------+------+------+------+------+ + | 0000 | 0011 | 0000 | 0111 | 0000 | 0100 | 0000 | 1000 | Binary + +------+------+------+------+------+------+------+------+ + | 3 | 7 | 4 | 8 | Number + +------+------+------+------+------+------+-------------+ + */ + +/* Set/get methods */ + +/* Constants for use with _mm_prefetch. */ +enum _mm_hint { + _MM_HINT_NTA = 0, /* load data to L1 and L2 cache, mark it as NTA */ + _MM_HINT_T0 = 1, /* load data to L1 and L2 cache */ + _MM_HINT_T1 = 2, /* load data to L2 cache only */ + _MM_HINT_T2 = 3, /* load data to L2 cache only, mark it as NTA */ + _MM_HINT_ENTA = 4, /* exclusive version of _MM_HINT_NTA */ + _MM_HINT_ET0 = 5, /* exclusive version of _MM_HINT_T0 */ + _MM_HINT_ET1 = 6, /* exclusive version of _MM_HINT_T1 */ + _MM_HINT_ET2 = 7 /* exclusive version of _MM_HINT_T2 */ +}; + +// Loads one cache line of data from address p to a location closer to the +// processor. https://msdn.microsoft.com/en-us/library/84szxsww(v=vs.100).aspx +FORCE_INLINE void _mm_prefetch(const void *p, int i) +{ + (void) i; + __builtin_prefetch(p); +} + +// Copy the lower single-precision (32-bit) floating-point element of a to dst. +// +// dst[31:0] := a[31:0] +// +// https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=_mm_cvtss_f32 +FORCE_INLINE float _mm_cvtss_f32(__m128 a) +{ + return vgetq_lane_f32(vreinterpretq_f32_m128(a), 0); +} + +// Convert the lower single-precision (32-bit) floating-point element in a to a +// 32-bit integer, and store the result in dst. +// +// dst[31:0] := Convert_FP32_To_Int32(a[31:0]) +// +// https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=_mm_cvtss_si32 +#define _mm_cvtss_si32(a) _mm_cvt_ss2si(a) + +// Convert the lower single-precision (32-bit) floating-point element in a to a +// 64-bit integer, and store the result in dst. +// +// dst[63:0] := Convert_FP32_To_Int64(a[31:0]) +// +// https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=_mm_cvtss_si64 +FORCE_INLINE int _mm_cvtss_si64(__m128 a) +{ +#if defined(__aarch64__) + return vgetq_lane_s64( + vreinterpretq_s64_s32(vcvtnq_s32_f32(vreinterpretq_f32_m128(a))), 0); +#else + float32_t data = vgetq_lane_f32(vreinterpretq_f32_m128(a), 0); + float32_t diff = data - floor(data); + if (diff > 0.5) + return (int64_t) ceil(data); + if (diff == 0.5) { + int64_t f = (int64_t) floor(data); + int64_t c = (int64_t) ceil(data); + return c & 1 ? f : c; + } + return (int64_t) floor(data); +#endif +} + +// Convert packed single-precision (32-bit) floating-point elements in a to +// packed 32-bit integers with truncation, and store the results in dst. +// +// FOR j := 0 to 1 +// i := 32*j +// dst[i+31:i] := Convert_FP32_To_Int32_Truncate(a[i+31:i]) +// ENDFOR +// +// https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=_mm_cvtt_ps2pi +FORCE_INLINE __m64 _mm_cvtt_ps2pi(__m128 a) +{ + return vreinterpret_m64_s32( + vget_low_s32(vcvtq_s32_f32(vreinterpretq_f32_m128(a)))); +} + +// Convert the lower single-precision (32-bit) floating-point element in a to a +// 32-bit integer with truncation, and store the result in dst. +// +// dst[31:0] := Convert_FP32_To_Int32_Truncate(a[31:0]) +// +// https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=_mm_cvtt_ss2si +FORCE_INLINE int _mm_cvtt_ss2si(__m128 a) +{ + return vgetq_lane_s32(vcvtq_s32_f32(vreinterpretq_f32_m128(a)), 0); +} + +// Convert packed single-precision (32-bit) floating-point elements in a to +// packed 32-bit integers with truncation, and store the results in dst. +// +// FOR j := 0 to 1 +// i := 32*j +// dst[i+31:i] := Convert_FP32_To_Int32_Truncate(a[i+31:i]) +// ENDFOR +// +// https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=_mm_cvttps_pi32 +#define _mm_cvttps_pi32(a) _mm_cvtt_ps2pi(a) + +// Convert the lower single-precision (32-bit) floating-point element in a to a +// 32-bit integer with truncation, and store the result in dst. +// +// dst[31:0] := Convert_FP32_To_Int32_Truncate(a[31:0]) +// +// https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=_mm_cvttss_si32 +#define _mm_cvttss_si32(a) _mm_cvtt_ss2si(a) + +// Convert the lower single-precision (32-bit) floating-point element in a to a +// 64-bit integer with truncation, and store the result in dst. +// +// dst[63:0] := Convert_FP32_To_Int64_Truncate(a[31:0]) +// +// https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=_mm_cvttss_si64 +FORCE_INLINE int64_t _mm_cvttss_si64(__m128 a) +{ + return vgetq_lane_s64( + vmovl_s32(vget_low_s32(vcvtq_s32_f32(vreinterpretq_f32_m128(a)))), 0); +} + +// Sets the 128-bit value to zero +// https://msdn.microsoft.com/en-us/library/vstudio/ys7dw0kh(v=vs.100).aspx +FORCE_INLINE __m128i _mm_setzero_si128(void) +{ + return vreinterpretq_m128i_s32(vdupq_n_s32(0)); +} + +// Clears the four single-precision, floating-point values. +// https://msdn.microsoft.com/en-us/library/vstudio/tk1t2tbz(v=vs.100).aspx +FORCE_INLINE __m128 _mm_setzero_ps(void) +{ + return vreinterpretq_m128_f32(vdupq_n_f32(0)); +} + +// Return vector of type __m128d with all elements set to zero. +// https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=_mm_setzero_pd +FORCE_INLINE __m128d _mm_setzero_pd(void) +{ +#if defined(__aarch64__) + return vreinterpretq_m128d_f64(vdupq_n_f64(0)); +#else + return vreinterpretq_m128d_f32(vdupq_n_f32(0)); +#endif +} + +// Sets the four single-precision, floating-point values to w. +// +// r0 := r1 := r2 := r3 := w +// +// https://msdn.microsoft.com/en-us/library/vstudio/2x1se8ha(v=vs.100).aspx +FORCE_INLINE __m128 _mm_set1_ps(float _w) +{ + return vreinterpretq_m128_f32(vdupq_n_f32(_w)); +} + +// Sets the four single-precision, floating-point values to w. +// https://msdn.microsoft.com/en-us/library/vstudio/2x1se8ha(v=vs.100).aspx +FORCE_INLINE __m128 _mm_set_ps1(float _w) +{ + return vreinterpretq_m128_f32(vdupq_n_f32(_w)); +} + +// Sets the four single-precision, floating-point values to the four inputs. +// https://msdn.microsoft.com/en-us/library/vstudio/afh0zf75(v=vs.100).aspx +FORCE_INLINE __m128 _mm_set_ps(float w, float z, float y, float x) +{ + float ALIGN_STRUCT(16) data[4] = {x, y, z, w}; + return vreinterpretq_m128_f32(vld1q_f32(data)); +} + +// Copy single-precision (32-bit) floating-point element a to the lower element +// of dst, and zero the upper 3 elements. +// https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=_mm_set_ss +FORCE_INLINE __m128 _mm_set_ss(float a) +{ + float ALIGN_STRUCT(16) data[4] = {a, 0, 0, 0}; + return vreinterpretq_m128_f32(vld1q_f32(data)); +} + +// Sets the four single-precision, floating-point values to the four inputs in +// reverse order. +// https://msdn.microsoft.com/en-us/library/vstudio/d2172ct3(v=vs.100).aspx +FORCE_INLINE __m128 _mm_setr_ps(float w, float z, float y, float x) +{ + float ALIGN_STRUCT(16) data[4] = {w, z, y, x}; + return vreinterpretq_m128_f32(vld1q_f32(data)); +} + +// Sets the 8 signed 16-bit integer values in reverse order. +// +// Return Value +// r0 := w0 +// r1 := w1 +// ... +// r7 := w7 +FORCE_INLINE __m128i _mm_setr_epi16(short w0, + short w1, + short w2, + short w3, + short w4, + short w5, + short w6, + short w7) +{ + int16_t ALIGN_STRUCT(16) data[8] = {w0, w1, w2, w3, w4, w5, w6, w7}; + return vreinterpretq_m128i_s16(vld1q_s16((int16_t *) data)); +} + +// Sets the 4 signed 32-bit integer values in reverse order +// https://technet.microsoft.com/en-us/library/security/27yb3ee5(v=vs.90).aspx +FORCE_INLINE __m128i _mm_setr_epi32(int i3, int i2, int i1, int i0) +{ + int32_t ALIGN_STRUCT(16) data[4] = {i3, i2, i1, i0}; + return vreinterpretq_m128i_s32(vld1q_s32(data)); +} + +// Set packed 64-bit integers in dst with the supplied values in reverse order. +// https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=_mm_setr_epi64 +FORCE_INLINE __m128i _mm_setr_epi64(__m64 e1, __m64 e0) +{ + return vreinterpretq_m128i_s64(vcombine_s64(e1, e0)); +} + +// Sets the 16 signed 8-bit integer values to b. +// +// r0 := b +// r1 := b +// ... +// r15 := b +// +// https://msdn.microsoft.com/en-us/library/6e14xhyf(v=vs.100).aspx +FORCE_INLINE __m128i _mm_set1_epi8(signed char w) +{ + return vreinterpretq_m128i_s8(vdupq_n_s8(w)); +} + +// Sets the 8 signed 16-bit integer values to w. +// +// r0 := w +// r1 := w +// ... +// r7 := w +// +// https://msdn.microsoft.com/en-us/library/k0ya3x0e(v=vs.90).aspx +FORCE_INLINE __m128i _mm_set1_epi16(short w) +{ + return vreinterpretq_m128i_s16(vdupq_n_s16(w)); +} + +// Sets the 16 signed 8-bit integer values. +// https://msdn.microsoft.com/en-us/library/x0cx8zd3(v=vs.90).aspx +FORCE_INLINE __m128i _mm_set_epi8(signed char b15, + signed char b14, + signed char b13, + signed char b12, + signed char b11, + signed char b10, + signed char b9, + signed char b8, + signed char b7, + signed char b6, + signed char b5, + signed char b4, + signed char b3, + signed char b2, + signed char b1, + signed char b0) +{ + int8_t ALIGN_STRUCT(16) + data[16] = {(int8_t) b0, (int8_t) b1, (int8_t) b2, (int8_t) b3, + (int8_t) b4, (int8_t) b5, (int8_t) b6, (int8_t) b7, + (int8_t) b8, (int8_t) b9, (int8_t) b10, (int8_t) b11, + (int8_t) b12, (int8_t) b13, (int8_t) b14, (int8_t) b15}; + return (__m128i) vld1q_s8(data); +} + +// Sets the 8 signed 16-bit integer values. +// https://msdn.microsoft.com/en-au/library/3e0fek84(v=vs.90).aspx +FORCE_INLINE __m128i _mm_set_epi16(short i7, + short i6, + short i5, + short i4, + short i3, + short i2, + short i1, + short i0) +{ + int16_t ALIGN_STRUCT(16) data[8] = {i0, i1, i2, i3, i4, i5, i6, i7}; + return vreinterpretq_m128i_s16(vld1q_s16(data)); +} + +// Sets the 16 signed 8-bit integer values in reverse order. +// https://msdn.microsoft.com/en-us/library/2khb9c7k(v=vs.90).aspx +FORCE_INLINE __m128i _mm_setr_epi8(signed char b0, + signed char b1, + signed char b2, + signed char b3, + signed char b4, + signed char b5, + signed char b6, + signed char b7, + signed char b8, + signed char b9, + signed char b10, + signed char b11, + signed char b12, + signed char b13, + signed char b14, + signed char b15) +{ + int8_t ALIGN_STRUCT(16) + data[16] = {(int8_t) b0, (int8_t) b1, (int8_t) b2, (int8_t) b3, + (int8_t) b4, (int8_t) b5, (int8_t) b6, (int8_t) b7, + (int8_t) b8, (int8_t) b9, (int8_t) b10, (int8_t) b11, + (int8_t) b12, (int8_t) b13, (int8_t) b14, (int8_t) b15}; + return (__m128i) vld1q_s8(data); +} + +// Sets the 4 signed 32-bit integer values to i. +// +// r0 := i +// r1 := i +// r2 := i +// r3 := I +// +// https://msdn.microsoft.com/en-us/library/vstudio/h4xscxat(v=vs.100).aspx +FORCE_INLINE __m128i _mm_set1_epi32(int _i) +{ + return vreinterpretq_m128i_s32(vdupq_n_s32(_i)); +} + +// Sets the 2 signed 64-bit integer values to i. +// https://docs.microsoft.com/en-us/previous-versions/visualstudio/visual-studio-2010/whtfzhzk(v=vs.100) +FORCE_INLINE __m128i _mm_set1_epi64(__m64 _i) +{ + return vreinterpretq_m128i_s64(vdupq_n_s64((int64_t) _i)); +} + +// Sets the 2 signed 64-bit integer values to i. +// https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=_mm_set1_epi64x +FORCE_INLINE __m128i _mm_set1_epi64x(int64_t _i) +{ + return vreinterpretq_m128i_s64(vdupq_n_s64(_i)); +} + +// Sets the 4 signed 32-bit integer values. +// https://msdn.microsoft.com/en-us/library/vstudio/019beekt(v=vs.100).aspx +FORCE_INLINE __m128i _mm_set_epi32(int i3, int i2, int i1, int i0) +{ + int32_t ALIGN_STRUCT(16) data[4] = {i0, i1, i2, i3}; + return vreinterpretq_m128i_s32(vld1q_s32(data)); +} + +// Returns the __m128i structure with its two 64-bit integer values +// initialized to the values of the two 64-bit integers passed in. +// https://msdn.microsoft.com/en-us/library/dk2sdw0h(v=vs.120).aspx +FORCE_INLINE __m128i _mm_set_epi64x(int64_t i1, int64_t i2) +{ + int64_t ALIGN_STRUCT(16) data[2] = {i2, i1}; + return vreinterpretq_m128i_s64(vld1q_s64(data)); +} + +// Returns the __m128i structure with its two 64-bit integer values +// initialized to the values of the two 64-bit integers passed in. +// https://msdn.microsoft.com/en-us/library/dk2sdw0h(v=vs.120).aspx +FORCE_INLINE __m128i _mm_set_epi64(__m64 i1, __m64 i2) +{ + return _mm_set_epi64x((int64_t) i1, (int64_t) i2); +} + +// Set packed double-precision (64-bit) floating-point elements in dst with the +// supplied values. +// https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=_mm_set_pd +FORCE_INLINE __m128d _mm_set_pd(double e1, double e0) +{ + double ALIGN_STRUCT(16) data[2] = {e0, e1}; +#if defined(__aarch64__) + return vreinterpretq_m128d_f64(vld1q_f64((float64_t *) data)); +#else + return vreinterpretq_m128d_f32(vld1q_f32((float32_t *) data)); +#endif +} + +// Stores four single-precision, floating-point values. +// https://msdn.microsoft.com/en-us/library/vstudio/s3h4ay6y(v=vs.100).aspx +FORCE_INLINE void _mm_store_ps(float *p, __m128 a) +{ + vst1q_f32(p, vreinterpretq_f32_m128(a)); +} + +// Stores four single-precision, floating-point values. +// https://msdn.microsoft.com/en-us/library/44e30x22(v=vs.100).aspx +FORCE_INLINE void _mm_storeu_ps(float *p, __m128 a) +{ + vst1q_f32(p, vreinterpretq_f32_m128(a)); +} + +// Stores four 32-bit integer values as (as a __m128i value) at the address p. +// https://msdn.microsoft.com/en-us/library/vstudio/edk11s13(v=vs.100).aspx +FORCE_INLINE void _mm_store_si128(__m128i *p, __m128i a) +{ + vst1q_s32((int32_t *) p, vreinterpretq_s32_m128i(a)); +} + +// Stores four 32-bit integer values as (as a __m128i value) at the address p. +// https://msdn.microsoft.com/en-us/library/vstudio/edk11s13(v=vs.100).aspx +FORCE_INLINE void _mm_storeu_si128(__m128i *p, __m128i a) +{ + vst1q_s32((int32_t *) p, vreinterpretq_s32_m128i(a)); +} + +// Stores the lower single - precision, floating - point value. +// https://msdn.microsoft.com/en-us/library/tzz10fbx(v=vs.100).aspx +FORCE_INLINE void _mm_store_ss(float *p, __m128 a) +{ + vst1q_lane_f32(p, vreinterpretq_f32_m128(a), 0); +} + +// Store 128-bits (composed of 2 packed double-precision (64-bit) floating-point +// elements) from a into memory. mem_addr must be aligned on a 16-byte boundary +// or a general-protection exception may be generated. +// https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=_mm_store_pd +FORCE_INLINE void _mm_store_pd(double *mem_addr, __m128d a) +{ +#if defined(__aarch64__) + vst1q_f64((float64_t *) mem_addr, vreinterpretq_f64_m128d(a)); +#else + vst1q_f32((float32_t *) mem_addr, vreinterpretq_f32_m128d(a)); +#endif +} + +// Store 128-bits (composed of 2 packed double-precision (64-bit) floating-point +// elements) from a into memory. mem_addr does not need to be aligned on any +// particular boundary. +// https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=_mm_storeu_pd +FORCE_INLINE void _mm_storeu_pd(double *mem_addr, __m128d a) +{ + _mm_store_pd(mem_addr, a); +} + +// Reads the lower 64 bits of b and stores them into the lower 64 bits of a. +// https://msdn.microsoft.com/en-us/library/hhwf428f%28v=vs.90%29.aspx +FORCE_INLINE void _mm_storel_epi64(__m128i *a, __m128i b) +{ + uint64x1_t hi = vget_high_u64(vreinterpretq_u64_m128i(*a)); + uint64x1_t lo = vget_low_u64(vreinterpretq_u64_m128i(b)); + *a = vreinterpretq_m128i_u64(vcombine_u64(lo, hi)); +} + +// Stores the lower two single-precision floating point values of a to the +// address p. +// +// *p0 := a0 +// *p1 := a1 +// +// https://msdn.microsoft.com/en-us/library/h54t98ks(v=vs.90).aspx +FORCE_INLINE void _mm_storel_pi(__m64 *p, __m128 a) +{ + *p = vreinterpret_m64_f32(vget_low_f32(a)); +} + +// Stores the upper two single-precision, floating-point values of a to the +// address p. +// +// *p0 := a2 +// *p1 := a3 +// +// https://msdn.microsoft.com/en-us/library/a7525fs8(v%3dvs.90).aspx +FORCE_INLINE void _mm_storeh_pi(__m64 *p, __m128 a) +{ + *p = vreinterpret_m64_f32(vget_high_f32(a)); +} + +// Loads a single single-precision, floating-point value, copying it into all +// four words +// https://msdn.microsoft.com/en-us/library/vstudio/5cdkf716(v=vs.100).aspx +FORCE_INLINE __m128 _mm_load1_ps(const float *p) +{ + return vreinterpretq_m128_f32(vld1q_dup_f32(p)); +} + +// Load a single-precision (32-bit) floating-point element from memory into all +// elements of dst. +// +// dst[31:0] := MEM[mem_addr+31:mem_addr] +// dst[63:32] := MEM[mem_addr+31:mem_addr] +// dst[95:64] := MEM[mem_addr+31:mem_addr] +// dst[127:96] := MEM[mem_addr+31:mem_addr] +// +// https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=_mm_load_ps1 +#define _mm_load_ps1 _mm_load1_ps + +// Sets the lower two single-precision, floating-point values with 64 +// bits of data loaded from the address p; the upper two values are passed +// through from a. +// +// Return Value +// r0 := *p0 +// r1 := *p1 +// r2 := a2 +// r3 := a3 +// +// https://msdn.microsoft.com/en-us/library/s57cyak2(v=vs.100).aspx +FORCE_INLINE __m128 _mm_loadl_pi(__m128 a, __m64 const *p) +{ + return vreinterpretq_m128_f32( + vcombine_f32(vld1_f32((const float32_t *) p), vget_high_f32(a))); +} + +// Load 4 single-precision (32-bit) floating-point elements from memory into dst +// in reverse order. mem_addr must be aligned on a 16-byte boundary or a +// general-protection exception may be generated. +// +// dst[31:0] := MEM[mem_addr+127:mem_addr+96] +// dst[63:32] := MEM[mem_addr+95:mem_addr+64] +// dst[95:64] := MEM[mem_addr+63:mem_addr+32] +// dst[127:96] := MEM[mem_addr+31:mem_addr] +// +// https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=_mm_loadr_ps +FORCE_INLINE __m128 _mm_loadr_ps(const float *p) +{ + float32x4_t v = vrev64q_f32(vld1q_f32(p)); + return vreinterpretq_m128_f32(vextq_f32(v, v, 2)); +} + +// Sets the upper two single-precision, floating-point values with 64 +// bits of data loaded from the address p; the lower two values are passed +// through from a. +// +// r0 := a0 +// r1 := a1 +// r2 := *p0 +// r3 := *p1 +// +// https://msdn.microsoft.com/en-us/library/w92wta0x(v%3dvs.100).aspx +FORCE_INLINE __m128 _mm_loadh_pi(__m128 a, __m64 const *p) +{ + return vreinterpretq_m128_f32( + vcombine_f32(vget_low_f32(a), vld1_f32((const float32_t *) p))); +} + +// Loads four single-precision, floating-point values. +// https://msdn.microsoft.com/en-us/library/vstudio/zzd50xxt(v=vs.100).aspx +FORCE_INLINE __m128 _mm_load_ps(const float *p) +{ + return vreinterpretq_m128_f32(vld1q_f32(p)); +} + +// Loads four single-precision, floating-point values. +// https://msdn.microsoft.com/en-us/library/x1b16s7z%28v=vs.90%29.aspx +FORCE_INLINE __m128 _mm_loadu_ps(const float *p) +{ + // for neon, alignment doesn't matter, so _mm_load_ps and _mm_loadu_ps are + // equivalent for neon + return vreinterpretq_m128_f32(vld1q_f32(p)); +} + +// Load unaligned 16-bit integer from memory into the first element of dst. +// +// dst[15:0] := MEM[mem_addr+15:mem_addr] +// dst[MAX:16] := 0 +// +// https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=_mm_loadu_si16 +FORCE_INLINE __m128i _mm_loadu_si16(const void *p) +{ + return vreinterpretq_m128i_s16( + vsetq_lane_s16(*(const int16_t *) p, vdupq_n_s16(0), 0)); +} + +// Load unaligned 64-bit integer from memory into the first element of dst. +// +// dst[63:0] := MEM[mem_addr+63:mem_addr] +// dst[MAX:64] := 0 +// +// https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=_mm_loadu_si64 +FORCE_INLINE __m128i _mm_loadu_si64(const void *p) +{ + return vreinterpretq_m128i_s64( + vcombine_s64(vld1_s64((const int64_t *) p), vdup_n_s64(0))); +} + +// Load a double-precision (64-bit) floating-point element from memory into the +// lower of dst, and zero the upper element. mem_addr does not need to be +// aligned on any particular boundary. +// +// dst[63:0] := MEM[mem_addr+63:mem_addr] +// dst[127:64] := 0 +// +// https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=_mm_load_sd +FORCE_INLINE __m128d _mm_load_sd(const double *p) +{ +#if defined(__aarch64__) + return vreinterpretq_m128d_f64(vsetq_lane_f64(*p, vdupq_n_f64(0), 0)); +#else + const float *fp = (const float *) p; + float ALIGN_STRUCT(16) data[4] = {fp[0], fp[1], 0, 0}; + return vreinterpretq_m128d_f32(vld1q_f32(data)); +#endif +} + +// Loads two double-precision from 16-byte aligned memory, floating-point +// values. +// +// dst[127:0] := MEM[mem_addr+127:mem_addr] +// +// https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=_mm_load_pd +FORCE_INLINE __m128d _mm_load_pd(const double *p) +{ +#if defined(__aarch64__) + return vreinterpretq_m128d_f64(vld1q_f64(p)); +#else + const float *fp = (const float *) p; + float ALIGN_STRUCT(16) data[4] = {fp[0], fp[1], fp[2], fp[3]}; + return vreinterpretq_m128d_f32(vld1q_f32(data)); +#endif +} + +// Loads two double-precision from unaligned memory, floating-point values. +// https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=_mm_loadu_pd +FORCE_INLINE __m128d _mm_loadu_pd(const double *p) +{ + return _mm_load_pd(p); +} + +// Loads an single - precision, floating - point value into the low word and +// clears the upper three words. +// https://msdn.microsoft.com/en-us/library/548bb9h4%28v=vs.90%29.aspx +FORCE_INLINE __m128 _mm_load_ss(const float *p) +{ + return vreinterpretq_m128_f32(vsetq_lane_f32(*p, vdupq_n_f32(0), 0)); +} + +FORCE_INLINE __m128i _mm_loadl_epi64(__m128i const *p) +{ + /* Load the lower 64 bits of the value pointed to by p into the + * lower 64 bits of the result, zeroing the upper 64 bits of the result. + */ + return vreinterpretq_m128i_s32( + vcombine_s32(vld1_s32((int32_t const *) p), vcreate_s32(0))); +} + +// Load a double-precision (64-bit) floating-point element from memory into the +// lower element of dst, and copy the upper element from a to dst. mem_addr does +// not need to be aligned on any particular boundary. +// +// dst[63:0] := MEM[mem_addr+63:mem_addr] +// dst[127:64] := a[127:64] +// +// https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=_mm_loadl_pd +FORCE_INLINE __m128d _mm_loadl_pd(__m128d a, const double *p) +{ +#if defined(__aarch64__) + return vreinterpretq_m128d_f64( + vcombine_f64(vld1_f64(p), vget_high_f64(vreinterpretq_f64_m128d(a)))); +#else + return vreinterpretq_m128d_f32( + vcombine_f32(vld1_f32((const float *) p), + vget_high_f32(vreinterpretq_f32_m128d(a)))); +#endif +} + +// Load 2 double-precision (64-bit) floating-point elements from memory into dst +// in reverse order. mem_addr must be aligned on a 16-byte boundary or a +// general-protection exception may be generated. +// +// dst[63:0] := MEM[mem_addr+127:mem_addr+64] +// dst[127:64] := MEM[mem_addr+63:mem_addr] +// +// https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=_mm_loadr_pd +FORCE_INLINE __m128d _mm_loadr_pd(const double *p) +{ +#if defined(__aarch64__) + float64x2_t v = vld1q_f64(p); + return vreinterpretq_m128d_f64(vextq_f64(v, v, 1)); +#else + int64x2_t v = vld1q_s64((const int64_t *) p); + return vreinterpretq_m128d_s64(vextq_s64(v, v, 1)); +#endif +} + +// Sets the low word to the single-precision, floating-point value of b +// https://docs.microsoft.com/en-us/previous-versions/visualstudio/visual-studio-2010/35hdzazd(v=vs.100) +FORCE_INLINE __m128 _mm_move_ss(__m128 a, __m128 b) +{ + return vreinterpretq_m128_f32( + vsetq_lane_f32(vgetq_lane_f32(vreinterpretq_f32_m128(b), 0), + vreinterpretq_f32_m128(a), 0)); +} + +// Copy the lower 64-bit integer in a to the lower element of dst, and zero the +// upper element. +// +// dst[63:0] := a[63:0] +// dst[127:64] := 0 +// +// https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=_mm_move_epi64 +FORCE_INLINE __m128i _mm_move_epi64(__m128i a) +{ + return vreinterpretq_m128i_s64( + vsetq_lane_s64(0, vreinterpretq_s64_m128i(a), 1)); +} + +// Return vector of type __m128 with undefined elements. +// https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=_mm_undefined_ps +FORCE_INLINE __m128 _mm_undefined_ps(void) +{ + __m128 a; + return a; +} + +/* Logic/Binary operations */ + +// Computes the bitwise AND-NOT of the four single-precision, floating-point +// values of a and b. +// +// r0 := ~a0 & b0 +// r1 := ~a1 & b1 +// r2 := ~a2 & b2 +// r3 := ~a3 & b3 +// +// https://msdn.microsoft.com/en-us/library/vstudio/68h7wd02(v=vs.100).aspx +FORCE_INLINE __m128 _mm_andnot_ps(__m128 a, __m128 b) +{ + return vreinterpretq_m128_s32( + vbicq_s32(vreinterpretq_s32_m128(b), + vreinterpretq_s32_m128(a))); // *NOTE* argument swap +} + +// Compute the bitwise NOT of packed double-precision (64-bit) floating-point +// elements in a and then AND with b, and store the results in dst. +// +// FOR j := 0 to 1 +// i := j*64 +// dst[i+63:i] := ((NOT a[i+63:i]) AND b[i+63:i]) +// ENDFOR +// +// https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=_mm_andnot_pd +FORCE_INLINE __m128d _mm_andnot_pd(__m128d a, __m128d b) +{ + // *NOTE* argument swap + return vreinterpretq_m128d_s64( + vbicq_s64(vreinterpretq_s64_m128d(b), vreinterpretq_s64_m128d(a))); +} + +// Computes the bitwise AND of the 128-bit value in b and the bitwise NOT of the +// 128-bit value in a. +// +// r := (~a) & b +// +// https://msdn.microsoft.com/en-us/library/vstudio/1beaceh8(v=vs.100).aspx +FORCE_INLINE __m128i _mm_andnot_si128(__m128i a, __m128i b) +{ + return vreinterpretq_m128i_s32( + vbicq_s32(vreinterpretq_s32_m128i(b), + vreinterpretq_s32_m128i(a))); // *NOTE* argument swap +} + +// Computes the bitwise AND of the 128-bit value in a and the 128-bit value in +// b. +// +// r := a & b +// +// https://msdn.microsoft.com/en-us/library/vstudio/6d1txsa8(v=vs.100).aspx +FORCE_INLINE __m128i _mm_and_si128(__m128i a, __m128i b) +{ + return vreinterpretq_m128i_s32( + vandq_s32(vreinterpretq_s32_m128i(a), vreinterpretq_s32_m128i(b))); +} + +// Computes the bitwise AND of the four single-precision, floating-point values +// of a and b. +// +// r0 := a0 & b0 +// r1 := a1 & b1 +// r2 := a2 & b2 +// r3 := a3 & b3 +// +// https://msdn.microsoft.com/en-us/library/vstudio/73ck1xc5(v=vs.100).aspx +FORCE_INLINE __m128 _mm_and_ps(__m128 a, __m128 b) +{ + return vreinterpretq_m128_s32( + vandq_s32(vreinterpretq_s32_m128(a), vreinterpretq_s32_m128(b))); +} + +// Compute the bitwise AND of packed double-precision (64-bit) floating-point +// elements in a and b, and store the results in dst. +// +// FOR j := 0 to 1 +// i := j*64 +// dst[i+63:i] := a[i+63:i] AND b[i+63:i] +// ENDFOR +// +// https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=_mm_and_pd +FORCE_INLINE __m128d _mm_and_pd(__m128d a, __m128d b) +{ + return vreinterpretq_m128d_s64( + vandq_s64(vreinterpretq_s64_m128d(a), vreinterpretq_s64_m128d(b))); +} + +// Computes the bitwise OR of the four single-precision, floating-point values +// of a and b. +// https://msdn.microsoft.com/en-us/library/vstudio/7ctdsyy0(v=vs.100).aspx +FORCE_INLINE __m128 _mm_or_ps(__m128 a, __m128 b) +{ + return vreinterpretq_m128_s32( + vorrq_s32(vreinterpretq_s32_m128(a), vreinterpretq_s32_m128(b))); +} + +// Computes bitwise EXOR (exclusive-or) of the four single-precision, +// floating-point values of a and b. +// https://msdn.microsoft.com/en-us/library/ss6k3wk8(v=vs.100).aspx +FORCE_INLINE __m128 _mm_xor_ps(__m128 a, __m128 b) +{ + return vreinterpretq_m128_s32( + veorq_s32(vreinterpretq_s32_m128(a), vreinterpretq_s32_m128(b))); +} + +// Compute the bitwise XOR of packed double-precision (64-bit) floating-point +// elements in a and b, and store the results in dst. +// +// FOR j := 0 to 1 +// i := j*64 +// dst[i+63:i] := a[i+63:i] XOR b[i+63:i] +// ENDFOR +// +// https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=_mm_xor_pd +FORCE_INLINE __m128d _mm_xor_pd(__m128d a, __m128d b) +{ + return vreinterpretq_m128d_s64( + veorq_s64(vreinterpretq_s64_m128d(a), vreinterpretq_s64_m128d(b))); +} + +// Computes the bitwise OR of the 128-bit value in a and the 128-bit value in b. +// +// r := a | b +// +// https://msdn.microsoft.com/en-us/library/vstudio/ew8ty0db(v=vs.100).aspx +FORCE_INLINE __m128i _mm_or_si128(__m128i a, __m128i b) +{ + return vreinterpretq_m128i_s32( + vorrq_s32(vreinterpretq_s32_m128i(a), vreinterpretq_s32_m128i(b))); +} + +// Computes the bitwise XOR of the 128-bit value in a and the 128-bit value in +// b. https://msdn.microsoft.com/en-us/library/fzt08www(v=vs.100).aspx +FORCE_INLINE __m128i _mm_xor_si128(__m128i a, __m128i b) +{ + return vreinterpretq_m128i_s32( + veorq_s32(vreinterpretq_s32_m128i(a), vreinterpretq_s32_m128i(b))); +} + +// Duplicate odd-indexed single-precision (32-bit) floating-point elements +// from a, and store the results in dst. +// https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=_mm_movehdup_ps +FORCE_INLINE __m128 _mm_movehdup_ps(__m128 a) +{ +#if __has_builtin(__builtin_shufflevector) + return vreinterpretq_m128_f32(__builtin_shufflevector( + vreinterpretq_f32_m128(a), vreinterpretq_f32_m128(a), 1, 1, 3, 3)); +#else + float32_t a1 = vgetq_lane_f32(vreinterpretq_f32_m128(a), 1); + float32_t a3 = vgetq_lane_f32(vreinterpretq_f32_m128(a), 3); + float ALIGN_STRUCT(16) data[4] = {a1, a1, a3, a3}; + return vreinterpretq_m128_f32(vld1q_f32(data)); +#endif +} + +// Duplicate even-indexed single-precision (32-bit) floating-point elements +// from a, and store the results in dst. +// https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=_mm_moveldup_ps +FORCE_INLINE __m128 _mm_moveldup_ps(__m128 a) +{ +#if __has_builtin(__builtin_shufflevector) + return vreinterpretq_m128_f32(__builtin_shufflevector( + vreinterpretq_f32_m128(a), vreinterpretq_f32_m128(a), 0, 0, 2, 2)); +#else + float32_t a0 = vgetq_lane_f32(vreinterpretq_f32_m128(a), 0); + float32_t a2 = vgetq_lane_f32(vreinterpretq_f32_m128(a), 2); + float ALIGN_STRUCT(16) data[4] = {a0, a0, a2, a2}; + return vreinterpretq_m128_f32(vld1q_f32(data)); +#endif +} + +// Moves the upper two values of B into the lower two values of A. +// +// r3 := a3 +// r2 := a2 +// r1 := b3 +// r0 := b2 +FORCE_INLINE __m128 _mm_movehl_ps(__m128 __A, __m128 __B) +{ + float32x2_t a32 = vget_high_f32(vreinterpretq_f32_m128(__A)); + float32x2_t b32 = vget_high_f32(vreinterpretq_f32_m128(__B)); + return vreinterpretq_m128_f32(vcombine_f32(b32, a32)); +} + +// Moves the lower two values of B into the upper two values of A. +// +// r3 := b1 +// r2 := b0 +// r1 := a1 +// r0 := a0 +FORCE_INLINE __m128 _mm_movelh_ps(__m128 __A, __m128 __B) +{ + float32x2_t a10 = vget_low_f32(vreinterpretq_f32_m128(__A)); + float32x2_t b10 = vget_low_f32(vreinterpretq_f32_m128(__B)); + return vreinterpretq_m128_f32(vcombine_f32(a10, b10)); +} + +// Compute the absolute value of packed signed 32-bit integers in a, and store +// the unsigned results in dst. +// +// FOR j := 0 to 3 +// i := j*32 +// dst[i+31:i] := ABS(a[i+31:i]) +// ENDFOR +// +// https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=_mm_abs_epi32 +FORCE_INLINE __m128i _mm_abs_epi32(__m128i a) +{ + return vreinterpretq_m128i_s32(vabsq_s32(vreinterpretq_s32_m128i(a))); +} + +// Compute the absolute value of packed signed 16-bit integers in a, and store +// the unsigned results in dst. +// +// FOR j := 0 to 7 +// i := j*16 +// dst[i+15:i] := ABS(a[i+15:i]) +// ENDFOR +// +// https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=_mm_abs_epi16 +FORCE_INLINE __m128i _mm_abs_epi16(__m128i a) +{ + return vreinterpretq_m128i_s16(vabsq_s16(vreinterpretq_s16_m128i(a))); +} + +// Compute the absolute value of packed signed 8-bit integers in a, and store +// the unsigned results in dst. +// +// FOR j := 0 to 15 +// i := j*8 +// dst[i+7:i] := ABS(a[i+7:i]) +// ENDFOR +// +// https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=_mm_abs_epi8 +FORCE_INLINE __m128i _mm_abs_epi8(__m128i a) +{ + return vreinterpretq_m128i_s8(vabsq_s8(vreinterpretq_s8_m128i(a))); +} + +// Compute the absolute value of packed signed 32-bit integers in a, and store +// the unsigned results in dst. +// +// FOR j := 0 to 1 +// i := j*32 +// dst[i+31:i] := ABS(a[i+31:i]) +// ENDFOR +// +// https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=_mm_abs_pi32 +FORCE_INLINE __m64 _mm_abs_pi32(__m64 a) +{ + return vreinterpret_m64_s32(vabs_s32(vreinterpret_s32_m64(a))); +} + +// Compute the absolute value of packed signed 16-bit integers in a, and store +// the unsigned results in dst. +// +// FOR j := 0 to 3 +// i := j*16 +// dst[i+15:i] := ABS(a[i+15:i]) +// ENDFOR +// +// https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=_mm_abs_pi16 +FORCE_INLINE __m64 _mm_abs_pi16(__m64 a) +{ + return vreinterpret_m64_s16(vabs_s16(vreinterpret_s16_m64(a))); +} + +// Compute the absolute value of packed signed 8-bit integers in a, and store +// the unsigned results in dst. +// +// FOR j := 0 to 7 +// i := j*8 +// dst[i+7:i] := ABS(a[i+7:i]) +// ENDFOR +// +// https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=_mm_abs_pi8 +FORCE_INLINE __m64 _mm_abs_pi8(__m64 a) +{ + return vreinterpret_m64_s8(vabs_s8(vreinterpret_s8_m64(a))); +} + +// Takes the upper 64 bits of a and places it in the low end of the result +// Takes the lower 64 bits of b and places it into the high end of the result. +FORCE_INLINE __m128 _mm_shuffle_ps_1032(__m128 a, __m128 b) +{ + float32x2_t a32 = vget_high_f32(vreinterpretq_f32_m128(a)); + float32x2_t b10 = vget_low_f32(vreinterpretq_f32_m128(b)); + return vreinterpretq_m128_f32(vcombine_f32(a32, b10)); +} + +// takes the lower two 32-bit values from a and swaps them and places in high +// end of result takes the higher two 32 bit values from b and swaps them and +// places in low end of result. +FORCE_INLINE __m128 _mm_shuffle_ps_2301(__m128 a, __m128 b) +{ + float32x2_t a01 = vrev64_f32(vget_low_f32(vreinterpretq_f32_m128(a))); + float32x2_t b23 = vrev64_f32(vget_high_f32(vreinterpretq_f32_m128(b))); + return vreinterpretq_m128_f32(vcombine_f32(a01, b23)); +} + +FORCE_INLINE __m128 _mm_shuffle_ps_0321(__m128 a, __m128 b) +{ + float32x2_t a21 = vget_high_f32( + vextq_f32(vreinterpretq_f32_m128(a), vreinterpretq_f32_m128(a), 3)); + float32x2_t b03 = vget_low_f32( + vextq_f32(vreinterpretq_f32_m128(b), vreinterpretq_f32_m128(b), 3)); + return vreinterpretq_m128_f32(vcombine_f32(a21, b03)); +} + +FORCE_INLINE __m128 _mm_shuffle_ps_2103(__m128 a, __m128 b) +{ + float32x2_t a03 = vget_low_f32( + vextq_f32(vreinterpretq_f32_m128(a), vreinterpretq_f32_m128(a), 3)); + float32x2_t b21 = vget_high_f32( + vextq_f32(vreinterpretq_f32_m128(b), vreinterpretq_f32_m128(b), 3)); + return vreinterpretq_m128_f32(vcombine_f32(a03, b21)); +} + +FORCE_INLINE __m128 _mm_shuffle_ps_1010(__m128 a, __m128 b) +{ + float32x2_t a10 = vget_low_f32(vreinterpretq_f32_m128(a)); + float32x2_t b10 = vget_low_f32(vreinterpretq_f32_m128(b)); + return vreinterpretq_m128_f32(vcombine_f32(a10, b10)); +} + +FORCE_INLINE __m128 _mm_shuffle_ps_1001(__m128 a, __m128 b) +{ + float32x2_t a01 = vrev64_f32(vget_low_f32(vreinterpretq_f32_m128(a))); + float32x2_t b10 = vget_low_f32(vreinterpretq_f32_m128(b)); + return vreinterpretq_m128_f32(vcombine_f32(a01, b10)); +} + +FORCE_INLINE __m128 _mm_shuffle_ps_0101(__m128 a, __m128 b) +{ + float32x2_t a01 = vrev64_f32(vget_low_f32(vreinterpretq_f32_m128(a))); + float32x2_t b01 = vrev64_f32(vget_low_f32(vreinterpretq_f32_m128(b))); + return vreinterpretq_m128_f32(vcombine_f32(a01, b01)); +} + +// keeps the low 64 bits of b in the low and puts the high 64 bits of a in the +// high +FORCE_INLINE __m128 _mm_shuffle_ps_3210(__m128 a, __m128 b) +{ + float32x2_t a10 = vget_low_f32(vreinterpretq_f32_m128(a)); + float32x2_t b32 = vget_high_f32(vreinterpretq_f32_m128(b)); + return vreinterpretq_m128_f32(vcombine_f32(a10, b32)); +} + +FORCE_INLINE __m128 _mm_shuffle_ps_0011(__m128 a, __m128 b) +{ + float32x2_t a11 = vdup_lane_f32(vget_low_f32(vreinterpretq_f32_m128(a)), 1); + float32x2_t b00 = vdup_lane_f32(vget_low_f32(vreinterpretq_f32_m128(b)), 0); + return vreinterpretq_m128_f32(vcombine_f32(a11, b00)); +} + +FORCE_INLINE __m128 _mm_shuffle_ps_0022(__m128 a, __m128 b) +{ + float32x2_t a22 = + vdup_lane_f32(vget_high_f32(vreinterpretq_f32_m128(a)), 0); + float32x2_t b00 = vdup_lane_f32(vget_low_f32(vreinterpretq_f32_m128(b)), 0); + return vreinterpretq_m128_f32(vcombine_f32(a22, b00)); +} + +FORCE_INLINE __m128 _mm_shuffle_ps_2200(__m128 a, __m128 b) +{ + float32x2_t a00 = vdup_lane_f32(vget_low_f32(vreinterpretq_f32_m128(a)), 0); + float32x2_t b22 = + vdup_lane_f32(vget_high_f32(vreinterpretq_f32_m128(b)), 0); + return vreinterpretq_m128_f32(vcombine_f32(a00, b22)); +} + +FORCE_INLINE __m128 _mm_shuffle_ps_3202(__m128 a, __m128 b) +{ + float32_t a0 = vgetq_lane_f32(vreinterpretq_f32_m128(a), 0); + float32x2_t a22 = + vdup_lane_f32(vget_high_f32(vreinterpretq_f32_m128(a)), 0); + float32x2_t a02 = vset_lane_f32(a0, a22, 1); /* TODO: use vzip ?*/ + float32x2_t b32 = vget_high_f32(vreinterpretq_f32_m128(b)); + return vreinterpretq_m128_f32(vcombine_f32(a02, b32)); +} + +FORCE_INLINE __m128 _mm_shuffle_ps_1133(__m128 a, __m128 b) +{ + float32x2_t a33 = + vdup_lane_f32(vget_high_f32(vreinterpretq_f32_m128(a)), 1); + float32x2_t b11 = vdup_lane_f32(vget_low_f32(vreinterpretq_f32_m128(b)), 1); + return vreinterpretq_m128_f32(vcombine_f32(a33, b11)); +} + +FORCE_INLINE __m128 _mm_shuffle_ps_2010(__m128 a, __m128 b) +{ + float32x2_t a10 = vget_low_f32(vreinterpretq_f32_m128(a)); + float32_t b2 = vgetq_lane_f32(vreinterpretq_f32_m128(b), 2); + float32x2_t b00 = vdup_lane_f32(vget_low_f32(vreinterpretq_f32_m128(b)), 0); + float32x2_t b20 = vset_lane_f32(b2, b00, 1); + return vreinterpretq_m128_f32(vcombine_f32(a10, b20)); +} + +FORCE_INLINE __m128 _mm_shuffle_ps_2001(__m128 a, __m128 b) +{ + float32x2_t a01 = vrev64_f32(vget_low_f32(vreinterpretq_f32_m128(a))); + float32_t b2 = vgetq_lane_f32(b, 2); + float32x2_t b00 = vdup_lane_f32(vget_low_f32(vreinterpretq_f32_m128(b)), 0); + float32x2_t b20 = vset_lane_f32(b2, b00, 1); + return vreinterpretq_m128_f32(vcombine_f32(a01, b20)); +} + +FORCE_INLINE __m128 _mm_shuffle_ps_2032(__m128 a, __m128 b) +{ + float32x2_t a32 = vget_high_f32(vreinterpretq_f32_m128(a)); + float32_t b2 = vgetq_lane_f32(b, 2); + float32x2_t b00 = vdup_lane_f32(vget_low_f32(vreinterpretq_f32_m128(b)), 0); + float32x2_t b20 = vset_lane_f32(b2, b00, 1); + return vreinterpretq_m128_f32(vcombine_f32(a32, b20)); +} + +// NEON does not support a general purpose permute intrinsic +// Selects four specific single-precision, floating-point values from a and b, +// based on the mask i. +// +// C equivalent: +// __m128 _mm_shuffle_ps_default(__m128 a, __m128 b, +// __constrange(0, 255) int imm) { +// __m128 ret; +// ret[0] = a[imm & 0x3]; ret[1] = a[(imm >> 2) & 0x3]; +// ret[2] = b[(imm >> 4) & 0x03]; ret[3] = b[(imm >> 6) & 0x03]; +// return ret; +// } +// +// https://msdn.microsoft.com/en-us/library/vstudio/5f0858x0(v=vs.100).aspx +#define _mm_shuffle_ps_default(a, b, imm) \ + __extension__({ \ + float32x4_t ret; \ + ret = vmovq_n_f32( \ + vgetq_lane_f32(vreinterpretq_f32_m128(a), (imm) & (0x3))); \ + ret = vsetq_lane_f32( \ + vgetq_lane_f32(vreinterpretq_f32_m128(a), ((imm) >> 2) & 0x3), \ + ret, 1); \ + ret = vsetq_lane_f32( \ + vgetq_lane_f32(vreinterpretq_f32_m128(b), ((imm) >> 4) & 0x3), \ + ret, 2); \ + ret = vsetq_lane_f32( \ + vgetq_lane_f32(vreinterpretq_f32_m128(b), ((imm) >> 6) & 0x3), \ + ret, 3); \ + vreinterpretq_m128_f32(ret); \ + }) + +// FORCE_INLINE __m128 _mm_shuffle_ps(__m128 a, __m128 b, __constrange(0,255) +// int imm) +#if __has_builtin(__builtin_shufflevector) +#define _mm_shuffle_ps(a, b, imm) \ + __extension__({ \ + float32x4_t _input1 = vreinterpretq_f32_m128(a); \ + float32x4_t _input2 = vreinterpretq_f32_m128(b); \ + float32x4_t _shuf = __builtin_shufflevector( \ + _input1, _input2, (imm) & (0x3), ((imm) >> 2) & 0x3, \ + (((imm) >> 4) & 0x3) + 4, (((imm) >> 6) & 0x3) + 4); \ + vreinterpretq_m128_f32(_shuf); \ + }) +#else // generic +#define _mm_shuffle_ps(a, b, imm) \ + __extension__({ \ + __m128 ret; \ + switch (imm) { \ + case _MM_SHUFFLE(1, 0, 3, 2): \ + ret = _mm_shuffle_ps_1032((a), (b)); \ + break; \ + case _MM_SHUFFLE(2, 3, 0, 1): \ + ret = _mm_shuffle_ps_2301((a), (b)); \ + break; \ + case _MM_SHUFFLE(0, 3, 2, 1): \ + ret = _mm_shuffle_ps_0321((a), (b)); \ + break; \ + case _MM_SHUFFLE(2, 1, 0, 3): \ + ret = _mm_shuffle_ps_2103((a), (b)); \ + break; \ + case _MM_SHUFFLE(1, 0, 1, 0): \ + ret = _mm_movelh_ps((a), (b)); \ + break; \ + case _MM_SHUFFLE(1, 0, 0, 1): \ + ret = _mm_shuffle_ps_1001((a), (b)); \ + break; \ + case _MM_SHUFFLE(0, 1, 0, 1): \ + ret = _mm_shuffle_ps_0101((a), (b)); \ + break; \ + case _MM_SHUFFLE(3, 2, 1, 0): \ + ret = _mm_shuffle_ps_3210((a), (b)); \ + break; \ + case _MM_SHUFFLE(0, 0, 1, 1): \ + ret = _mm_shuffle_ps_0011((a), (b)); \ + break; \ + case _MM_SHUFFLE(0, 0, 2, 2): \ + ret = _mm_shuffle_ps_0022((a), (b)); \ + break; \ + case _MM_SHUFFLE(2, 2, 0, 0): \ + ret = _mm_shuffle_ps_2200((a), (b)); \ + break; \ + case _MM_SHUFFLE(3, 2, 0, 2): \ + ret = _mm_shuffle_ps_3202((a), (b)); \ + break; \ + case _MM_SHUFFLE(3, 2, 3, 2): \ + ret = _mm_movehl_ps((b), (a)); \ + break; \ + case _MM_SHUFFLE(1, 1, 3, 3): \ + ret = _mm_shuffle_ps_1133((a), (b)); \ + break; \ + case _MM_SHUFFLE(2, 0, 1, 0): \ + ret = _mm_shuffle_ps_2010((a), (b)); \ + break; \ + case _MM_SHUFFLE(2, 0, 0, 1): \ + ret = _mm_shuffle_ps_2001((a), (b)); \ + break; \ + case _MM_SHUFFLE(2, 0, 3, 2): \ + ret = _mm_shuffle_ps_2032((a), (b)); \ + break; \ + default: \ + ret = _mm_shuffle_ps_default((a), (b), (imm)); \ + break; \ + } \ + ret; \ + }) +#endif + +// Takes the upper 64 bits of a and places it in the low end of the result +// Takes the lower 64 bits of a and places it into the high end of the result. +FORCE_INLINE __m128i _mm_shuffle_epi_1032(__m128i a) +{ + int32x2_t a32 = vget_high_s32(vreinterpretq_s32_m128i(a)); + int32x2_t a10 = vget_low_s32(vreinterpretq_s32_m128i(a)); + return vreinterpretq_m128i_s32(vcombine_s32(a32, a10)); +} + +// takes the lower two 32-bit values from a and swaps them and places in low end +// of result takes the higher two 32 bit values from a and swaps them and places +// in high end of result. +FORCE_INLINE __m128i _mm_shuffle_epi_2301(__m128i a) +{ + int32x2_t a01 = vrev64_s32(vget_low_s32(vreinterpretq_s32_m128i(a))); + int32x2_t a23 = vrev64_s32(vget_high_s32(vreinterpretq_s32_m128i(a))); + return vreinterpretq_m128i_s32(vcombine_s32(a01, a23)); +} + +// rotates the least significant 32 bits into the most signficant 32 bits, and +// shifts the rest down +FORCE_INLINE __m128i _mm_shuffle_epi_0321(__m128i a) +{ + return vreinterpretq_m128i_s32( + vextq_s32(vreinterpretq_s32_m128i(a), vreinterpretq_s32_m128i(a), 1)); +} + +// rotates the most significant 32 bits into the least signficant 32 bits, and +// shifts the rest up +FORCE_INLINE __m128i _mm_shuffle_epi_2103(__m128i a) +{ + return vreinterpretq_m128i_s32( + vextq_s32(vreinterpretq_s32_m128i(a), vreinterpretq_s32_m128i(a), 3)); +} + +// gets the lower 64 bits of a, and places it in the upper 64 bits +// gets the lower 64 bits of a and places it in the lower 64 bits +FORCE_INLINE __m128i _mm_shuffle_epi_1010(__m128i a) +{ + int32x2_t a10 = vget_low_s32(vreinterpretq_s32_m128i(a)); + return vreinterpretq_m128i_s32(vcombine_s32(a10, a10)); +} + +// gets the lower 64 bits of a, swaps the 0 and 1 elements, and places it in the +// lower 64 bits gets the lower 64 bits of a, and places it in the upper 64 bits +FORCE_INLINE __m128i _mm_shuffle_epi_1001(__m128i a) +{ + int32x2_t a01 = vrev64_s32(vget_low_s32(vreinterpretq_s32_m128i(a))); + int32x2_t a10 = vget_low_s32(vreinterpretq_s32_m128i(a)); + return vreinterpretq_m128i_s32(vcombine_s32(a01, a10)); +} + +// gets the lower 64 bits of a, swaps the 0 and 1 elements and places it in the +// upper 64 bits gets the lower 64 bits of a, swaps the 0 and 1 elements, and +// places it in the lower 64 bits +FORCE_INLINE __m128i _mm_shuffle_epi_0101(__m128i a) +{ + int32x2_t a01 = vrev64_s32(vget_low_s32(vreinterpretq_s32_m128i(a))); + return vreinterpretq_m128i_s32(vcombine_s32(a01, a01)); +} + +FORCE_INLINE __m128i _mm_shuffle_epi_2211(__m128i a) +{ + int32x2_t a11 = vdup_lane_s32(vget_low_s32(vreinterpretq_s32_m128i(a)), 1); + int32x2_t a22 = vdup_lane_s32(vget_high_s32(vreinterpretq_s32_m128i(a)), 0); + return vreinterpretq_m128i_s32(vcombine_s32(a11, a22)); +} + +FORCE_INLINE __m128i _mm_shuffle_epi_0122(__m128i a) +{ + int32x2_t a22 = vdup_lane_s32(vget_high_s32(vreinterpretq_s32_m128i(a)), 0); + int32x2_t a01 = vrev64_s32(vget_low_s32(vreinterpretq_s32_m128i(a))); + return vreinterpretq_m128i_s32(vcombine_s32(a22, a01)); +} + +FORCE_INLINE __m128i _mm_shuffle_epi_3332(__m128i a) +{ + int32x2_t a32 = vget_high_s32(vreinterpretq_s32_m128i(a)); + int32x2_t a33 = vdup_lane_s32(vget_high_s32(vreinterpretq_s32_m128i(a)), 1); + return vreinterpretq_m128i_s32(vcombine_s32(a32, a33)); +} + +// Shuffle packed 8-bit integers in a according to shuffle control mask in the +// corresponding 8-bit element of b, and store the results in dst. +// https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=_mm_shuffle_epi8 +FORCE_INLINE __m128i _mm_shuffle_epi8(__m128i a, __m128i b) +{ + int8x16_t tbl = vreinterpretq_s8_m128i(a); // input a + uint8x16_t idx = vreinterpretq_u8_m128i(b); // input b + uint8x16_t idx_masked = + vandq_u8(idx, vdupq_n_u8(0x8F)); // avoid using meaningless bits +#if defined(__aarch64__) + return vreinterpretq_m128i_s8(vqtbl1q_s8(tbl, idx_masked)); +#elif defined(__GNUC__) + int8x16_t ret; + // %e and %f represent the even and odd D registers + // respectively. + __asm__ __volatile__( + "vtbl.8 %e[ret], {%e[tbl], %f[tbl]}, %e[idx]\n" + "vtbl.8 %f[ret], {%e[tbl], %f[tbl]}, %f[idx]\n" + : [ret] "=&w"(ret) + : [tbl] "w"(tbl), [idx] "w"(idx_masked)); + return vreinterpretq_m128i_s8(ret); +#else + // use this line if testing on aarch64 + int8x8x2_t a_split = {vget_low_s8(tbl), vget_high_s8(tbl)}; + return vreinterpretq_m128i_s8( + vcombine_s8(vtbl2_s8(a_split, vget_low_u8(idx_masked)), + vtbl2_s8(a_split, vget_high_u8(idx_masked)))); +#endif +} + +// C equivalent: +// __m128i _mm_shuffle_epi32_default(__m128i a, +// __constrange(0, 255) int imm) { +// __m128i ret; +// ret[0] = a[imm & 0x3]; ret[1] = a[(imm >> 2) & 0x3]; +// ret[2] = a[(imm >> 4) & 0x03]; ret[3] = a[(imm >> 6) & 0x03]; +// return ret; +// } +#define _mm_shuffle_epi32_default(a, imm) \ + __extension__({ \ + int32x4_t ret; \ + ret = vmovq_n_s32( \ + vgetq_lane_s32(vreinterpretq_s32_m128i(a), (imm) & (0x3))); \ + ret = vsetq_lane_s32( \ + vgetq_lane_s32(vreinterpretq_s32_m128i(a), ((imm) >> 2) & 0x3), \ + ret, 1); \ + ret = vsetq_lane_s32( \ + vgetq_lane_s32(vreinterpretq_s32_m128i(a), ((imm) >> 4) & 0x3), \ + ret, 2); \ + ret = vsetq_lane_s32( \ + vgetq_lane_s32(vreinterpretq_s32_m128i(a), ((imm) >> 6) & 0x3), \ + ret, 3); \ + vreinterpretq_m128i_s32(ret); \ + }) + +// FORCE_INLINE __m128i _mm_shuffle_epi32_splat(__m128i a, __constrange(0,255) +// int imm) +#if defined(__aarch64__) +#define _mm_shuffle_epi32_splat(a, imm) \ + __extension__({ \ + vreinterpretq_m128i_s32( \ + vdupq_laneq_s32(vreinterpretq_s32_m128i(a), (imm))); \ + }) +#else +#define _mm_shuffle_epi32_splat(a, imm) \ + __extension__({ \ + vreinterpretq_m128i_s32( \ + vdupq_n_s32(vgetq_lane_s32(vreinterpretq_s32_m128i(a), (imm)))); \ + }) +#endif + +// Shuffles the 4 signed or unsigned 32-bit integers in a as specified by imm. +// https://msdn.microsoft.com/en-us/library/56f67xbk%28v=vs.90%29.aspx +// FORCE_INLINE __m128i _mm_shuffle_epi32(__m128i a, +// __constrange(0,255) int imm) +#if __has_builtin(__builtin_shufflevector) +#define _mm_shuffle_epi32(a, imm) \ + __extension__({ \ + int32x4_t _input = vreinterpretq_s32_m128i(a); \ + int32x4_t _shuf = __builtin_shufflevector( \ + _input, _input, (imm) & (0x3), ((imm) >> 2) & 0x3, \ + ((imm) >> 4) & 0x3, ((imm) >> 6) & 0x3); \ + vreinterpretq_m128i_s32(_shuf); \ + }) +#else // generic +#define _mm_shuffle_epi32(a, imm) \ + __extension__({ \ + __m128i ret; \ + switch (imm) { \ + case _MM_SHUFFLE(1, 0, 3, 2): \ + ret = _mm_shuffle_epi_1032((a)); \ + break; \ + case _MM_SHUFFLE(2, 3, 0, 1): \ + ret = _mm_shuffle_epi_2301((a)); \ + break; \ + case _MM_SHUFFLE(0, 3, 2, 1): \ + ret = _mm_shuffle_epi_0321((a)); \ + break; \ + case _MM_SHUFFLE(2, 1, 0, 3): \ + ret = _mm_shuffle_epi_2103((a)); \ + break; \ + case _MM_SHUFFLE(1, 0, 1, 0): \ + ret = _mm_shuffle_epi_1010((a)); \ + break; \ + case _MM_SHUFFLE(1, 0, 0, 1): \ + ret = _mm_shuffle_epi_1001((a)); \ + break; \ + case _MM_SHUFFLE(0, 1, 0, 1): \ + ret = _mm_shuffle_epi_0101((a)); \ + break; \ + case _MM_SHUFFLE(2, 2, 1, 1): \ + ret = _mm_shuffle_epi_2211((a)); \ + break; \ + case _MM_SHUFFLE(0, 1, 2, 2): \ + ret = _mm_shuffle_epi_0122((a)); \ + break; \ + case _MM_SHUFFLE(3, 3, 3, 2): \ + ret = _mm_shuffle_epi_3332((a)); \ + break; \ + case _MM_SHUFFLE(0, 0, 0, 0): \ + ret = _mm_shuffle_epi32_splat((a), 0); \ + break; \ + case _MM_SHUFFLE(1, 1, 1, 1): \ + ret = _mm_shuffle_epi32_splat((a), 1); \ + break; \ + case _MM_SHUFFLE(2, 2, 2, 2): \ + ret = _mm_shuffle_epi32_splat((a), 2); \ + break; \ + case _MM_SHUFFLE(3, 3, 3, 3): \ + ret = _mm_shuffle_epi32_splat((a), 3); \ + break; \ + default: \ + ret = _mm_shuffle_epi32_default((a), (imm)); \ + break; \ + } \ + ret; \ + }) +#endif + +// Shuffles the lower 4 signed or unsigned 16-bit integers in a as specified +// by imm. +// https://docs.microsoft.com/en-us/previous-versions/visualstudio/visual-studio-2010/y41dkk37(v=vs.100) +// FORCE_INLINE __m128i _mm_shufflelo_epi16_function(__m128i a, +// __constrange(0,255) int +// imm) +#define _mm_shufflelo_epi16_function(a, imm) \ + __extension__({ \ + int16x8_t ret = vreinterpretq_s16_m128i(a); \ + int16x4_t lowBits = vget_low_s16(ret); \ + ret = vsetq_lane_s16(vget_lane_s16(lowBits, (imm) & (0x3)), ret, 0); \ + ret = vsetq_lane_s16(vget_lane_s16(lowBits, ((imm) >> 2) & 0x3), ret, \ + 1); \ + ret = vsetq_lane_s16(vget_lane_s16(lowBits, ((imm) >> 4) & 0x3), ret, \ + 2); \ + ret = vsetq_lane_s16(vget_lane_s16(lowBits, ((imm) >> 6) & 0x3), ret, \ + 3); \ + vreinterpretq_m128i_s16(ret); \ + }) + +// FORCE_INLINE __m128i _mm_shufflelo_epi16(__m128i a, +// __constrange(0,255) int imm) +#if __has_builtin(__builtin_shufflevector) +#define _mm_shufflelo_epi16(a, imm) \ + __extension__({ \ + int16x8_t _input = vreinterpretq_s16_m128i(a); \ + int16x8_t _shuf = __builtin_shufflevector( \ + _input, _input, ((imm) & (0x3)), (((imm) >> 2) & 0x3), \ + (((imm) >> 4) & 0x3), (((imm) >> 6) & 0x3), 4, 5, 6, 7); \ + vreinterpretq_m128i_s16(_shuf); \ + }) +#else // generic +#define _mm_shufflelo_epi16(a, imm) _mm_shufflelo_epi16_function((a), (imm)) +#endif + +// Shuffles the upper 4 signed or unsigned 16-bit integers in a as specified +// by imm. +// https://msdn.microsoft.com/en-us/library/13ywktbs(v=vs.100).aspx +// FORCE_INLINE __m128i _mm_shufflehi_epi16_function(__m128i a, +// __constrange(0,255) int +// imm) +#define _mm_shufflehi_epi16_function(a, imm) \ + __extension__({ \ + int16x8_t ret = vreinterpretq_s16_m128i(a); \ + int16x4_t highBits = vget_high_s16(ret); \ + ret = vsetq_lane_s16(vget_lane_s16(highBits, (imm) & (0x3)), ret, 4); \ + ret = vsetq_lane_s16(vget_lane_s16(highBits, ((imm) >> 2) & 0x3), ret, \ + 5); \ + ret = vsetq_lane_s16(vget_lane_s16(highBits, ((imm) >> 4) & 0x3), ret, \ + 6); \ + ret = vsetq_lane_s16(vget_lane_s16(highBits, ((imm) >> 6) & 0x3), ret, \ + 7); \ + vreinterpretq_m128i_s16(ret); \ + }) + +// FORCE_INLINE __m128i _mm_shufflehi_epi16(__m128i a, +// __constrange(0,255) int imm) +#if __has_builtin(__builtin_shufflevector) +#define _mm_shufflehi_epi16(a, imm) \ + __extension__({ \ + int16x8_t _input = vreinterpretq_s16_m128i(a); \ + int16x8_t _shuf = __builtin_shufflevector( \ + _input, _input, 0, 1, 2, 3, ((imm) & (0x3)) + 4, \ + (((imm) >> 2) & 0x3) + 4, (((imm) >> 4) & 0x3) + 4, \ + (((imm) >> 6) & 0x3) + 4); \ + vreinterpretq_m128i_s16(_shuf); \ + }) +#else // generic +#define _mm_shufflehi_epi16(a, imm) _mm_shufflehi_epi16_function((a), (imm)) +#endif + +// Blend packed 16-bit integers from a and b using control mask imm8, and store +// the results in dst. +// +// FOR j := 0 to 7 +// i := j*16 +// IF imm8[j] +// dst[i+15:i] := b[i+15:i] +// ELSE +// dst[i+15:i] := a[i+15:i] +// FI +// ENDFOR +// FORCE_INLINE __m128i _mm_blend_epi16(__m128i a, __m128i b, +// __constrange(0,255) int imm) +#define _mm_blend_epi16(a, b, imm) \ + __extension__({ \ + const uint16_t _mask[8] = {((imm) & (1 << 0)) ? 0xFFFF : 0x0000, \ + ((imm) & (1 << 1)) ? 0xFFFF : 0x0000, \ + ((imm) & (1 << 2)) ? 0xFFFF : 0x0000, \ + ((imm) & (1 << 3)) ? 0xFFFF : 0x0000, \ + ((imm) & (1 << 4)) ? 0xFFFF : 0x0000, \ + ((imm) & (1 << 5)) ? 0xFFFF : 0x0000, \ + ((imm) & (1 << 6)) ? 0xFFFF : 0x0000, \ + ((imm) & (1 << 7)) ? 0xFFFF : 0x0000}; \ + uint16x8_t _mask_vec = vld1q_u16(_mask); \ + uint16x8_t _a = vreinterpretq_u16_m128i(a); \ + uint16x8_t _b = vreinterpretq_u16_m128i(b); \ + vreinterpretq_m128i_u16(vbslq_u16(_mask_vec, _b, _a)); \ + }) + +// Blend packed 8-bit integers from a and b using mask, and store the results in +// dst. +// +// FOR j := 0 to 15 +// i := j*8 +// IF mask[i+7] +// dst[i+7:i] := b[i+7:i] +// ELSE +// dst[i+7:i] := a[i+7:i] +// FI +// ENDFOR +FORCE_INLINE __m128i _mm_blendv_epi8(__m128i _a, __m128i _b, __m128i _mask) +{ + // Use a signed shift right to create a mask with the sign bit + uint8x16_t mask = + vreinterpretq_u8_s8(vshrq_n_s8(vreinterpretq_s8_m128i(_mask), 7)); + uint8x16_t a = vreinterpretq_u8_m128i(_a); + uint8x16_t b = vreinterpretq_u8_m128i(_b); + return vreinterpretq_m128i_u8(vbslq_u8(mask, b, a)); +} + +/* Shifts */ + + +// Shift packed 16-bit integers in a right by imm while shifting in sign +// bits, and store the results in dst. +// https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=_mm_srai_epi16 +FORCE_INLINE __m128i _mm_srai_epi16(__m128i a, int imm) +{ + const int count = (imm & ~15) ? 15 : imm; + return (__m128i) vshlq_s16((int16x8_t) a, vdupq_n_s16(-count)); +} + +// Shifts the 8 signed or unsigned 16-bit integers in a left by count bits while +// shifting in zeros. +// +// r0 := a0 << count +// r1 := a1 << count +// ... +// r7 := a7 << count +// +// https://msdn.microsoft.com/en-us/library/es73bcsy(v=vs.90).aspx +#define _mm_slli_epi16(a, imm) \ + __extension__({ \ + __m128i ret; \ + if ((imm) <= 0) { \ + ret = a; \ + } else if ((imm) > 15) { \ + ret = _mm_setzero_si128(); \ + } else { \ + ret = vreinterpretq_m128i_s16( \ + vshlq_n_s16(vreinterpretq_s16_m128i(a), (imm))); \ + } \ + ret; \ + }) + +// Shifts the 4 signed or unsigned 32-bit integers in a left by count bits while +// shifting in zeros. : +// https://msdn.microsoft.com/en-us/library/z2k3bbtb%28v=vs.90%29.aspx +// FORCE_INLINE __m128i _mm_slli_epi32(__m128i a, __constrange(0,255) int imm) +FORCE_INLINE __m128i _mm_slli_epi32(__m128i a, int imm) +{ + if (imm <= 0) /* TODO: add constant range macro: [0, 255] */ + return a; + if (imm > 31) /* TODO: add unlikely macro */ + return _mm_setzero_si128(); + return vreinterpretq_m128i_s32( + vshlq_s32(vreinterpretq_s32_m128i(a), vdupq_n_s32(imm))); +} + +// Shift packed 64-bit integers in a left by imm8 while shifting in zeros, and +// store the results in dst. +FORCE_INLINE __m128i _mm_slli_epi64(__m128i a, int imm) +{ + if (imm <= 0) /* TODO: add constant range macro: [0, 255] */ + return a; + if (imm > 63) /* TODO: add unlikely macro */ + return _mm_setzero_si128(); + return vreinterpretq_m128i_s64( + vshlq_s64(vreinterpretq_s64_m128i(a), vdupq_n_s64(imm))); +} + +// Shift packed 16-bit integers in a right by imm8 while shifting in zeros, and +// store the results in dst. +// +// FOR j := 0 to 7 +// i := j*16 +// IF imm8[7:0] > 15 +// dst[i+15:i] := 0 +// ELSE +// dst[i+15:i] := ZeroExtend16(a[i+15:i] >> imm8[7:0]) +// FI +// ENDFOR +// +// https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=_mm_srli_epi16 +#define _mm_srli_epi16(a, imm) \ + __extension__({ \ + __m128i ret; \ + if ((imm) == 0) { \ + ret = a; \ + } else if (0 < (imm) && (imm) < 16) { \ + ret = vreinterpretq_m128i_u16( \ + vshlq_u16(vreinterpretq_u16_m128i(a), vdupq_n_s16(-imm))); \ + } else { \ + ret = _mm_setzero_si128(); \ + } \ + ret; \ + }) + +// Shift packed 32-bit integers in a right by imm8 while shifting in zeros, and +// store the results in dst. +// +// FOR j := 0 to 3 +// i := j*32 +// IF imm8[7:0] > 31 +// dst[i+31:i] := 0 +// ELSE +// dst[i+31:i] := ZeroExtend32(a[i+31:i] >> imm8[7:0]) +// FI +// ENDFOR +// +// https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=_mm_srli_epi32 +// FORCE_INLINE __m128i _mm_srli_epi32(__m128i a, __constrange(0,255) int imm) +#define _mm_srli_epi32(a, imm) \ + __extension__({ \ + __m128i ret; \ + if ((imm) == 0) { \ + ret = a; \ + } else if (0 < (imm) && (imm) < 32) { \ + ret = vreinterpretq_m128i_u32( \ + vshlq_u32(vreinterpretq_u32_m128i(a), vdupq_n_s32(-imm))); \ + } else { \ + ret = _mm_setzero_si128(); \ + } \ + ret; \ + }) + +// Shift packed 64-bit integers in a right by imm8 while shifting in zeros, and +// store the results in dst. +// +// FOR j := 0 to 1 +// i := j*64 +// IF imm8[7:0] > 63 +// dst[i+63:i] := 0 +// ELSE +// dst[i+63:i] := ZeroExtend64(a[i+63:i] >> imm8[7:0]) +// FI +// ENDFOR +// +// https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=_mm_srli_epi64 +#define _mm_srli_epi64(a, imm) \ + __extension__({ \ + __m128i ret; \ + if ((imm) == 0) { \ + ret = a; \ + } else if (0 < (imm) && (imm) < 64) { \ + ret = vreinterpretq_m128i_u64( \ + vshlq_u64(vreinterpretq_u64_m128i(a), vdupq_n_s64(-imm))); \ + } else { \ + ret = _mm_setzero_si128(); \ + } \ + ret; \ + }) + +// Shift packed 32-bit integers in a right by imm8 while shifting in sign bits, +// and store the results in dst. +// +// FOR j := 0 to 3 +// i := j*32 +// IF imm8[7:0] > 31 +// dst[i+31:i] := (a[i+31] ? 0xFFFFFFFF : 0x0) +// ELSE +// dst[i+31:i] := SignExtend32(a[i+31:i] >> imm8[7:0]) +// FI +// ENDFOR +// +// https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=_mm_srai_epi32 +// FORCE_INLINE __m128i _mm_srai_epi32(__m128i a, __constrange(0,255) int imm) +#define _mm_srai_epi32(a, imm) \ + __extension__({ \ + __m128i ret; \ + if ((imm) == 0) { \ + ret = a; \ + } else if (0 < (imm) && (imm) < 32) { \ + ret = vreinterpretq_m128i_s32( \ + vshlq_s32(vreinterpretq_s32_m128i(a), vdupq_n_s32(-imm))); \ + } else { \ + ret = vreinterpretq_m128i_s32( \ + vshrq_n_s32(vreinterpretq_s32_m128i(a), 31)); \ + } \ + ret; \ + }) + +// Shifts the 128 - bit value in a right by imm bytes while shifting in +// zeros.imm must be an immediate. +// +// r := srl(a, imm*8) +// +// https://msdn.microsoft.com/en-us/library/305w28yz(v=vs.100).aspx +// FORCE_INLINE _mm_srli_si128(__m128i a, __constrange(0,255) int imm) +#define _mm_srli_si128(a, imm) \ + __extension__({ \ + __m128i ret; \ + if ((imm) <= 0) { \ + ret = a; \ + } else if ((imm) > 15) { \ + ret = _mm_setzero_si128(); \ + } else { \ + ret = vreinterpretq_m128i_s8( \ + vextq_s8(vreinterpretq_s8_m128i(a), vdupq_n_s8(0), (imm))); \ + } \ + ret; \ + }) + +// Shifts the 128-bit value in a left by imm bytes while shifting in zeros. imm +// must be an immediate. +// +// r := a << (imm * 8) +// +// https://msdn.microsoft.com/en-us/library/34d3k2kt(v=vs.100).aspx +// FORCE_INLINE __m128i _mm_slli_si128(__m128i a, __constrange(0,255) int imm) +#define _mm_slli_si128(a, imm) \ + __extension__({ \ + __m128i ret; \ + if ((imm) <= 0) { \ + ret = a; \ + } else if ((imm) > 15) { \ + ret = _mm_setzero_si128(); \ + } else { \ + ret = vreinterpretq_m128i_s8(vextq_s8( \ + vdupq_n_s8(0), vreinterpretq_s8_m128i(a), 16 - (imm))); \ + } \ + ret; \ + }) + +// Shifts the 8 signed or unsigned 16-bit integers in a left by count bits while +// shifting in zeros. +// +// r0 := a0 << count +// r1 := a1 << count +// ... +// r7 := a7 << count +// +// https://msdn.microsoft.com/en-us/library/c79w388h(v%3dvs.90).aspx +FORCE_INLINE __m128i _mm_sll_epi16(__m128i a, __m128i count) +{ + uint64_t c = vreinterpretq_nth_u64_m128i(count, 0); + if (c > 15) + return _mm_setzero_si128(); + + int16x8_t vc = vdupq_n_s16((int16_t) c); + return vreinterpretq_m128i_s16(vshlq_s16(vreinterpretq_s16_m128i(a), vc)); +} + +// Shifts the 4 signed or unsigned 32-bit integers in a left by count bits while +// shifting in zeros. +// +// r0 := a0 << count +// r1 := a1 << count +// r2 := a2 << count +// r3 := a3 << count +// +// https://msdn.microsoft.com/en-us/library/6fe5a6s9(v%3dvs.90).aspx +FORCE_INLINE __m128i _mm_sll_epi32(__m128i a, __m128i count) +{ + uint64_t c = vreinterpretq_nth_u64_m128i(count, 0); + if (c > 31) + return _mm_setzero_si128(); + + int32x4_t vc = vdupq_n_s32((int32_t) c); + return vreinterpretq_m128i_s32(vshlq_s32(vreinterpretq_s32_m128i(a), vc)); +} + +// Shifts the 2 signed or unsigned 64-bit integers in a left by count bits while +// shifting in zeros. +// +// r0 := a0 << count +// r1 := a1 << count +// +// https://msdn.microsoft.com/en-us/library/6ta9dffd(v%3dvs.90).aspx +FORCE_INLINE __m128i _mm_sll_epi64(__m128i a, __m128i count) +{ + uint64_t c = vreinterpretq_nth_u64_m128i(count, 0); + if (c > 63) + return _mm_setzero_si128(); + + int64x2_t vc = vdupq_n_s64((int64_t) c); + return vreinterpretq_m128i_s64(vshlq_s64(vreinterpretq_s64_m128i(a), vc)); +} + +// Shifts the 8 signed or unsigned 16-bit integers in a right by count bits +// while shifting in zeros. +// +// r0 := srl(a0, count) +// r1 := srl(a1, count) +// ... +// r7 := srl(a7, count) +// +// https://msdn.microsoft.com/en-us/library/wd5ax830(v%3dvs.90).aspx +FORCE_INLINE __m128i _mm_srl_epi16(__m128i a, __m128i count) +{ + uint64_t c = vreinterpretq_nth_u64_m128i(count, 0); + if (c > 15) + return _mm_setzero_si128(); + + int16x8_t vc = vdupq_n_s16(-(int16_t) c); + return vreinterpretq_m128i_u16(vshlq_u16(vreinterpretq_u16_m128i(a), vc)); +} + +// Shifts the 4 signed or unsigned 32-bit integers in a right by count bits +// while shifting in zeros. +// +// r0 := srl(a0, count) +// r1 := srl(a1, count) +// r2 := srl(a2, count) +// r3 := srl(a3, count) +// +// https://msdn.microsoft.com/en-us/library/a9cbttf4(v%3dvs.90).aspx +FORCE_INLINE __m128i _mm_srl_epi32(__m128i a, __m128i count) +{ + uint64_t c = vreinterpretq_nth_u64_m128i(count, 0); + if (c > 31) + return _mm_setzero_si128(); + + int32x4_t vc = vdupq_n_s32(-(int32_t) c); + return vreinterpretq_m128i_u32(vshlq_u32(vreinterpretq_u32_m128i(a), vc)); +} + +// Shifts the 2 signed or unsigned 64-bit integers in a right by count bits +// while shifting in zeros. +// +// r0 := srl(a0, count) +// r1 := srl(a1, count) +// +// https://msdn.microsoft.com/en-us/library/yf6cf9k8(v%3dvs.90).aspx +FORCE_INLINE __m128i _mm_srl_epi64(__m128i a, __m128i count) +{ + uint64_t c = vreinterpretq_nth_u64_m128i(count, 0); + if (c > 63) + return _mm_setzero_si128(); + + int64x2_t vc = vdupq_n_s64(-(int64_t) c); + return vreinterpretq_m128i_u64(vshlq_u64(vreinterpretq_u64_m128i(a), vc)); +} + +// NEON does not provide a version of this function. +// Creates a 16-bit mask from the most significant bits of the 16 signed or +// unsigned 8-bit integers in a and zero extends the upper bits. +// https://msdn.microsoft.com/en-us/library/vstudio/s090c8fk(v=vs.100).aspx +FORCE_INLINE int _mm_movemask_epi8(__m128i a) +{ +#if defined(__aarch64__) + uint8x16_t input = vreinterpretq_u8_m128i(a); + const int8_t ALIGN_STRUCT(16) + xr[16] = {-7, -6, -5, -4, -3, -2, -1, 0, -7, -6, -5, -4, -3, -2, -1, 0}; + const uint8x16_t mask_and = vdupq_n_u8(0x80); + const int8x16_t mask_shift = vld1q_s8(xr); + const uint8x16_t mask_result = + vshlq_u8(vandq_u8(input, mask_and), mask_shift); + uint8x8_t lo = vget_low_u8(mask_result); + uint8x8_t hi = vget_high_u8(mask_result); + + return vaddv_u8(lo) + (vaddv_u8(hi) << 8); +#else + // Use increasingly wide shifts+adds to collect the sign bits + // together. + // Since the widening shifts would be rather confusing to follow in little + // endian, everything will be illustrated in big endian order instead. This + // has a different result - the bits would actually be reversed on a big + // endian machine. + + // Starting input (only half the elements are shown): + // 89 ff 1d c0 00 10 99 33 + uint8x16_t input = vreinterpretq_u8_m128i(a); + + // Shift out everything but the sign bits with an unsigned shift right. + // + // Bytes of the vector:: + // 89 ff 1d c0 00 10 99 33 + // \ \ \ \ \ \ \ \ high_bits = (uint16x4_t)(input >> 7) + // | | | | | | | | + // 01 01 00 01 00 00 01 00 + // + // Bits of first important lane(s): + // 10001001 (89) + // \______ + // | + // 00000001 (01) + uint16x8_t high_bits = vreinterpretq_u16_u8(vshrq_n_u8(input, 7)); + + // Merge the even lanes together with a 16-bit unsigned shift right + add. + // 'xx' represents garbage data which will be ignored in the final result. + // In the important bytes, the add functions like a binary OR. + // + // 01 01 00 01 00 00 01 00 + // \_ | \_ | \_ | \_ | paired16 = (uint32x4_t)(input + (input >> 7)) + // \| \| \| \| + // xx 03 xx 01 xx 00 xx 02 + // + // 00000001 00000001 (01 01) + // \_______ | + // \| + // xxxxxxxx xxxxxx11 (xx 03) + uint32x4_t paired16 = + vreinterpretq_u32_u16(vsraq_n_u16(high_bits, high_bits, 7)); + + // Repeat with a wider 32-bit shift + add. + // xx 03 xx 01 xx 00 xx 02 + // \____ | \____ | paired32 = (uint64x1_t)(paired16 + (paired16 >> + // 14)) + // \| \| + // xx xx xx 0d xx xx xx 02 + // + // 00000011 00000001 (03 01) + // \\_____ || + // '----.\|| + // xxxxxxxx xxxx1101 (xx 0d) + uint64x2_t paired32 = + vreinterpretq_u64_u32(vsraq_n_u32(paired16, paired16, 14)); + + // Last, an even wider 64-bit shift + add to get our result in the low 8 bit + // lanes. xx xx xx 0d xx xx xx 02 + // \_________ | paired64 = (uint8x8_t)(paired32 + (paired32 >> + // 28)) + // \| + // xx xx xx xx xx xx xx d2 + // + // 00001101 00000010 (0d 02) + // \ \___ | | + // '---. \| | + // xxxxxxxx 11010010 (xx d2) + uint8x16_t paired64 = + vreinterpretq_u8_u64(vsraq_n_u64(paired32, paired32, 28)); + + // Extract the low 8 bits from each 64-bit lane with 2 8-bit extracts. + // xx xx xx xx xx xx xx d2 + // || return paired64[0] + // d2 + // Note: Little endian would return the correct value 4b (01001011) instead. + return vgetq_lane_u8(paired64, 0) | ((int) vgetq_lane_u8(paired64, 8) << 8); +#endif +} + +// Copy the lower 64-bit integer in a to dst. +// +// dst[63:0] := a[63:0] +// +// https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=_mm_movepi64_pi64 +FORCE_INLINE __m64 _mm_movepi64_pi64(__m128i a) +{ + return vreinterpret_m64_s64(vget_low_s64(vreinterpretq_s64_m128i(a))); +} + +// Copy the 64-bit integer a to the lower element of dst, and zero the upper +// element. +// +// dst[63:0] := a[63:0] +// dst[127:64] := 0 +// +// https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=_mm_movpi64_epi64 +FORCE_INLINE __m128i _mm_movpi64_epi64(__m64 a) +{ + return vreinterpretq_m128i_s64( + vcombine_s64(vreinterpret_s64_m64(a), vdup_n_s64(0))); +} + +// NEON does not provide this method +// Creates a 4-bit mask from the most significant bits of the four +// single-precision, floating-point values. +// https://msdn.microsoft.com/en-us/library/vstudio/4490ys29(v=vs.100).aspx +FORCE_INLINE int _mm_movemask_ps(__m128 a) +{ + uint32x4_t input = vreinterpretq_u32_m128(a); +#if defined(__aarch64__) + static const int32x4_t shift = {0, 1, 2, 3}; + uint32x4_t tmp = vshrq_n_u32(input, 31); + return vaddvq_u32(vshlq_u32(tmp, shift)); +#else + // Uses the exact same method as _mm_movemask_epi8, see that for details. + // Shift out everything but the sign bits with a 32-bit unsigned shift + // right. + uint64x2_t high_bits = vreinterpretq_u64_u32(vshrq_n_u32(input, 31)); + // Merge the two pairs together with a 64-bit unsigned shift right + add. + uint8x16_t paired = + vreinterpretq_u8_u64(vsraq_n_u64(high_bits, high_bits, 31)); + // Extract the result. + return vgetq_lane_u8(paired, 0) | (vgetq_lane_u8(paired, 8) << 2); +#endif +} + +// Compute the bitwise NOT of a and then AND with a 128-bit vector containing +// all 1's, and return 1 if the result is zero, otherwise return 0. +// https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=_mm_test_all_ones +FORCE_INLINE int _mm_test_all_ones(__m128i a) +{ + return (uint64_t)(vgetq_lane_s64(a, 0) & vgetq_lane_s64(a, 1)) == + ~(uint64_t) 0; +} + +// Compute the bitwise AND of 128 bits (representing integer data) in a and +// mask, and return 1 if the result is zero, otherwise return 0. +// https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=_mm_test_all_zeros +FORCE_INLINE int _mm_test_all_zeros(__m128i a, __m128i mask) +{ + int64x2_t a_and_mask = + vandq_s64(vreinterpretq_s64_m128i(a), vreinterpretq_s64_m128i(mask)); + return (vgetq_lane_s64(a_and_mask, 0) | vgetq_lane_s64(a_and_mask, 1)) ? 0 + : 1; +} + +/* Math operations */ + +// Subtracts the four single-precision, floating-point values of a and b. +// +// r0 := a0 - b0 +// r1 := a1 - b1 +// r2 := a2 - b2 +// r3 := a3 - b3 +// +// https://msdn.microsoft.com/en-us/library/vstudio/1zad2k61(v=vs.100).aspx +FORCE_INLINE __m128 _mm_sub_ps(__m128 a, __m128 b) +{ + return vreinterpretq_m128_f32( + vsubq_f32(vreinterpretq_f32_m128(a), vreinterpretq_f32_m128(b))); +} + +// Subtract the lower single-precision (32-bit) floating-point element in b from +// the lower single-precision (32-bit) floating-point element in a, store the +// result in the lower element of dst, and copy the upper 3 packed elements from +// a to the upper elements of dst. +// +// dst[31:0] := a[31:0] - b[31:0] +// dst[127:32] := a[127:32] +// +// https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=_mm_sub_ss +FORCE_INLINE __m128 _mm_sub_ss(__m128 a, __m128 b) +{ + return _mm_move_ss(a, _mm_sub_ps(a, b)); +} + +// Subtract 2 packed 64-bit integers in b from 2 packed 64-bit integers in a, +// and store the results in dst. +// r0 := a0 - b0 +// r1 := a1 - b1 +FORCE_INLINE __m128i _mm_sub_epi64(__m128i a, __m128i b) +{ + return vreinterpretq_m128i_s64( + vsubq_s64(vreinterpretq_s64_m128i(a), vreinterpretq_s64_m128i(b))); +} + +// Subtracts the 4 signed or unsigned 32-bit integers of b from the 4 signed or +// unsigned 32-bit integers of a. +// +// r0 := a0 - b0 +// r1 := a1 - b1 +// r2 := a2 - b2 +// r3 := a3 - b3 +// +// https://msdn.microsoft.com/en-us/library/vstudio/fhh866h0(v=vs.100).aspx +FORCE_INLINE __m128i _mm_sub_epi32(__m128i a, __m128i b) +{ + return vreinterpretq_m128i_s32( + vsubq_s32(vreinterpretq_s32_m128i(a), vreinterpretq_s32_m128i(b))); +} + +FORCE_INLINE __m128i _mm_sub_epi16(__m128i a, __m128i b) +{ + return vreinterpretq_m128i_s16( + vsubq_s16(vreinterpretq_s16_m128i(a), vreinterpretq_s16_m128i(b))); +} + +FORCE_INLINE __m128i _mm_sub_epi8(__m128i a, __m128i b) +{ + return vreinterpretq_m128i_s8( + vsubq_s8(vreinterpretq_s8_m128i(a), vreinterpretq_s8_m128i(b))); +} + +// Subtract 64-bit integer b from 64-bit integer a, and store the result in dst. +// +// dst[63:0] := a[63:0] - b[63:0] +// +// https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=_mm_sub_si64 +FORCE_INLINE __m64 _mm_sub_si64(__m64 a, __m64 b) +{ + return vreinterpret_m64_s64( + vsub_s64(vreinterpret_s64_m64(a), vreinterpret_s64_m64(b))); +} + +// Subtracts the 8 unsigned 16-bit integers of bfrom the 8 unsigned 16-bit +// integers of a and saturates.. +// https://technet.microsoft.com/en-us/subscriptions/index/f44y0s19(v=vs.90).aspx +FORCE_INLINE __m128i _mm_subs_epu16(__m128i a, __m128i b) +{ + return vreinterpretq_m128i_u16( + vqsubq_u16(vreinterpretq_u16_m128i(a), vreinterpretq_u16_m128i(b))); +} + +// Subtracts the 16 unsigned 8-bit integers of b from the 16 unsigned 8-bit +// integers of a and saturates. +// +// r0 := UnsignedSaturate(a0 - b0) +// r1 := UnsignedSaturate(a1 - b1) +// ... +// r15 := UnsignedSaturate(a15 - b15) +// +// https://technet.microsoft.com/en-us/subscriptions/yadkxc18(v=vs.90) +FORCE_INLINE __m128i _mm_subs_epu8(__m128i a, __m128i b) +{ + return vreinterpretq_m128i_u8( + vqsubq_u8(vreinterpretq_u8_m128i(a), vreinterpretq_u8_m128i(b))); +} + +// Subtracts the 16 signed 8-bit integers of b from the 16 signed 8-bit integers +// of a and saturates. +// +// r0 := SignedSaturate(a0 - b0) +// r1 := SignedSaturate(a1 - b1) +// ... +// r15 := SignedSaturate(a15 - b15) +// +// https://technet.microsoft.com/en-us/subscriptions/by7kzks1(v=vs.90) +FORCE_INLINE __m128i _mm_subs_epi8(__m128i a, __m128i b) +{ + return vreinterpretq_m128i_s8( + vqsubq_s8(vreinterpretq_s8_m128i(a), vreinterpretq_s8_m128i(b))); +} + +// Subtracts the 8 signed 16-bit integers of b from the 8 signed 16-bit integers +// of a and saturates. +// +// r0 := SignedSaturate(a0 - b0) +// r1 := SignedSaturate(a1 - b1) +// ... +// r7 := SignedSaturate(a7 - b7) +// +// https://technet.microsoft.com/en-us/subscriptions/3247z5b8(v=vs.90) +FORCE_INLINE __m128i _mm_subs_epi16(__m128i a, __m128i b) +{ + return vreinterpretq_m128i_s16( + vqsubq_s16(vreinterpretq_s16_m128i(a), vreinterpretq_s16_m128i(b))); +} + +FORCE_INLINE __m128i _mm_adds_epu16(__m128i a, __m128i b) +{ + return vreinterpretq_m128i_u16( + vqaddq_u16(vreinterpretq_u16_m128i(a), vreinterpretq_u16_m128i(b))); +} + +// Negate packed 8-bit integers in a when the corresponding signed +// 8-bit integer in b is negative, and store the results in dst. +// Element in dst are zeroed out when the corresponding element +// in b is zero. +// +// for i in 0..15 +// if b[i] < 0 +// r[i] := -a[i] +// else if b[i] == 0 +// r[i] := 0 +// else +// r[i] := a[i] +// fi +// done +FORCE_INLINE __m128i _mm_sign_epi8(__m128i _a, __m128i _b) +{ + int8x16_t a = vreinterpretq_s8_m128i(_a); + int8x16_t b = vreinterpretq_s8_m128i(_b); + + // signed shift right: faster than vclt + // (b < 0) ? 0xFF : 0 + uint8x16_t ltMask = vreinterpretq_u8_s8(vshrq_n_s8(b, 7)); + + // (b == 0) ? 0xFF : 0 +#if defined(__aarch64__) + int8x16_t zeroMask = vreinterpretq_s8_u8(vceqzq_s8(b)); +#else + int8x16_t zeroMask = vreinterpretq_s8_u8(vceqq_s8(b, vdupq_n_s8(0))); +#endif + + // bitwise select either a or nagative 'a' (vnegq_s8(a) return nagative 'a') + // based on ltMask + int8x16_t masked = vbslq_s8(ltMask, vnegq_s8(a), a); + // res = masked & (~zeroMask) + int8x16_t res = vbicq_s8(masked, zeroMask); + + return vreinterpretq_m128i_s8(res); +} + +// Negate packed 16-bit integers in a when the corresponding signed +// 16-bit integer in b is negative, and store the results in dst. +// Element in dst are zeroed out when the corresponding element +// in b is zero. +// +// for i in 0..7 +// if b[i] < 0 +// r[i] := -a[i] +// else if b[i] == 0 +// r[i] := 0 +// else +// r[i] := a[i] +// fi +// done +FORCE_INLINE __m128i _mm_sign_epi16(__m128i _a, __m128i _b) +{ + int16x8_t a = vreinterpretq_s16_m128i(_a); + int16x8_t b = vreinterpretq_s16_m128i(_b); + + // signed shift right: faster than vclt + // (b < 0) ? 0xFFFF : 0 + uint16x8_t ltMask = vreinterpretq_u16_s16(vshrq_n_s16(b, 15)); + // (b == 0) ? 0xFFFF : 0 +#if defined(__aarch64__) + int16x8_t zeroMask = vreinterpretq_s16_u16(vceqzq_s16(b)); +#else + int16x8_t zeroMask = vreinterpretq_s16_u16(vceqq_s16(b, vdupq_n_s16(0))); +#endif + + // bitwise select either a or negative 'a' (vnegq_s16(a) equals to negative + // 'a') based on ltMask + int16x8_t masked = vbslq_s16(ltMask, vnegq_s16(a), a); + // res = masked & (~zeroMask) + int16x8_t res = vbicq_s16(masked, zeroMask); + return vreinterpretq_m128i_s16(res); +} + +// Negate packed 32-bit integers in a when the corresponding signed +// 32-bit integer in b is negative, and store the results in dst. +// Element in dst are zeroed out when the corresponding element +// in b is zero. +// +// for i in 0..3 +// if b[i] < 0 +// r[i] := -a[i] +// else if b[i] == 0 +// r[i] := 0 +// else +// r[i] := a[i] +// fi +// done +FORCE_INLINE __m128i _mm_sign_epi32(__m128i _a, __m128i _b) +{ + int32x4_t a = vreinterpretq_s32_m128i(_a); + int32x4_t b = vreinterpretq_s32_m128i(_b); + + // signed shift right: faster than vclt + // (b < 0) ? 0xFFFFFFFF : 0 + uint32x4_t ltMask = vreinterpretq_u32_s32(vshrq_n_s32(b, 31)); + + // (b == 0) ? 0xFFFFFFFF : 0 +#if defined(__aarch64__) + int32x4_t zeroMask = vreinterpretq_s32_u32(vceqzq_s32(b)); +#else + int32x4_t zeroMask = vreinterpretq_s32_u32(vceqq_s32(b, vdupq_n_s32(0))); +#endif + + // bitwise select either a or negative 'a' (vnegq_s32(a) equals to negative + // 'a') based on ltMask + int32x4_t masked = vbslq_s32(ltMask, vnegq_s32(a), a); + // res = masked & (~zeroMask) + int32x4_t res = vbicq_s32(masked, zeroMask); + return vreinterpretq_m128i_s32(res); +} + +// Negate packed 16-bit integers in a when the corresponding signed 16-bit +// integer in b is negative, and store the results in dst. Element in dst are +// zeroed out when the corresponding element in b is zero. +// +// FOR j := 0 to 3 +// i := j*16 +// IF b[i+15:i] < 0 +// dst[i+15:i] := -(a[i+15:i]) +// ELSE IF b[i+15:i] == 0 +// dst[i+15:i] := 0 +// ELSE +// dst[i+15:i] := a[i+15:i] +// FI +// ENDFOR +// +// https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=_mm_sign_pi16 +FORCE_INLINE __m64 _mm_sign_pi16(__m64 _a, __m64 _b) +{ + int16x4_t a = vreinterpret_s16_m64(_a); + int16x4_t b = vreinterpret_s16_m64(_b); + + // signed shift right: faster than vclt + // (b < 0) ? 0xFFFF : 0 + uint16x4_t ltMask = vreinterpret_u16_s16(vshr_n_s16(b, 15)); + + // (b == 0) ? 0xFFFF : 0 +#if defined(__aarch64__) + int16x4_t zeroMask = vreinterpret_s16_u16(vceqz_s16(b)); +#else + int16x4_t zeroMask = vreinterpret_s16_u16(vceq_s16(b, vdup_n_s16(0))); +#endif + + // bitwise select either a or nagative 'a' (vneg_s16(a) return nagative 'a') + // based on ltMask + int16x4_t masked = vbsl_s16(ltMask, vneg_s16(a), a); + // res = masked & (~zeroMask) + int16x4_t res = vbic_s16(masked, zeroMask); + + return vreinterpret_m64_s16(res); +} + +// Negate packed 32-bit integers in a when the corresponding signed 32-bit +// integer in b is negative, and store the results in dst. Element in dst are +// zeroed out when the corresponding element in b is zero. +// +// FOR j := 0 to 1 +// i := j*32 +// IF b[i+31:i] < 0 +// dst[i+31:i] := -(a[i+31:i]) +// ELSE IF b[i+31:i] == 0 +// dst[i+31:i] := 0 +// ELSE +// dst[i+31:i] := a[i+31:i] +// FI +// ENDFOR +// +// https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=_mm_sign_pi32 +FORCE_INLINE __m64 _mm_sign_pi32(__m64 _a, __m64 _b) +{ + int32x2_t a = vreinterpret_s32_m64(_a); + int32x2_t b = vreinterpret_s32_m64(_b); + + // signed shift right: faster than vclt + // (b < 0) ? 0xFFFFFFFF : 0 + uint32x2_t ltMask = vreinterpret_u32_s32(vshr_n_s32(b, 31)); + + // (b == 0) ? 0xFFFFFFFF : 0 +#if defined(__aarch64__) + int32x2_t zeroMask = vreinterpret_s32_u32(vceqz_s32(b)); +#else + int32x2_t zeroMask = vreinterpret_s32_u32(vceq_s32(b, vdup_n_s32(0))); +#endif + + // bitwise select either a or nagative 'a' (vneg_s32(a) return nagative 'a') + // based on ltMask + int32x2_t masked = vbsl_s32(ltMask, vneg_s32(a), a); + // res = masked & (~zeroMask) + int32x2_t res = vbic_s32(masked, zeroMask); + + return vreinterpret_m64_s32(res); +} + +// Negate packed 8-bit integers in a when the corresponding signed 8-bit integer +// in b is negative, and store the results in dst. Element in dst are zeroed out +// when the corresponding element in b is zero. +// +// FOR j := 0 to 7 +// i := j*8 +// IF b[i+7:i] < 0 +// dst[i+7:i] := -(a[i+7:i]) +// ELSE IF b[i+7:i] == 0 +// dst[i+7:i] := 0 +// ELSE +// dst[i+7:i] := a[i+7:i] +// FI +// ENDFOR +// +// https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=_mm_sign_pi8 +FORCE_INLINE __m64 _mm_sign_pi8(__m64 _a, __m64 _b) +{ + int8x8_t a = vreinterpret_s8_m64(_a); + int8x8_t b = vreinterpret_s8_m64(_b); + + // signed shift right: faster than vclt + // (b < 0) ? 0xFF : 0 + uint8x8_t ltMask = vreinterpret_u8_s8(vshr_n_s8(b, 7)); + + // (b == 0) ? 0xFF : 0 +#if defined(__aarch64__) + int8x8_t zeroMask = vreinterpret_s8_u8(vceqz_s8(b)); +#else + int8x8_t zeroMask = vreinterpret_s8_u8(vceq_s8(b, vdup_n_s8(0))); +#endif + + // bitwise select either a or nagative 'a' (vneg_s8(a) return nagative 'a') + // based on ltMask + int8x8_t masked = vbsl_s8(ltMask, vneg_s8(a), a); + // res = masked & (~zeroMask) + int8x8_t res = vbic_s8(masked, zeroMask); + + return vreinterpret_m64_s8(res); +} + +// Average packed unsigned 16-bit integers in a and b, and store the results in +// dst. +// +// FOR j := 0 to 3 +// i := j*16 +// dst[i+15:i] := (a[i+15:i] + b[i+15:i] + 1) >> 1 +// ENDFOR +// +// https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=_mm_avg_pu16 +FORCE_INLINE __m64 _mm_avg_pu16(__m64 a, __m64 b) +{ + return vreinterpret_m64_u16( + vrhadd_u16(vreinterpret_u16_m64(a), vreinterpret_u16_m64(b))); +} + +// Average packed unsigned 8-bit integers in a and b, and store the results in +// dst. +// +// FOR j := 0 to 7 +// i := j*8 +// dst[i+7:i] := (a[i+7:i] + b[i+7:i] + 1) >> 1 +// ENDFOR +// +// https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=_mm_avg_pu8 +FORCE_INLINE __m64 _mm_avg_pu8(__m64 a, __m64 b) +{ + return vreinterpret_m64_u8( + vrhadd_u8(vreinterpret_u8_m64(a), vreinterpret_u8_m64(b))); +} + +// Average packed unsigned 8-bit integers in a and b, and store the results in +// dst. +// +// FOR j := 0 to 7 +// i := j*8 +// dst[i+7:i] := (a[i+7:i] + b[i+7:i] + 1) >> 1 +// ENDFOR +// +// https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=_m_pavgb +#define _m_pavgb(a, b) _mm_avg_pu8(a, b) + +// Average packed unsigned 16-bit integers in a and b, and store the results in +// dst. +// +// FOR j := 0 to 3 +// i := j*16 +// dst[i+15:i] := (a[i+15:i] + b[i+15:i] + 1) >> 1 +// ENDFOR +// +// https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=_m_pavgw +#define _m_pavgw(a, b) _mm_avg_pu16(a, b) + +// Computes the average of the 16 unsigned 8-bit integers in a and the 16 +// unsigned 8-bit integers in b and rounds. +// +// r0 := (a0 + b0) / 2 +// r1 := (a1 + b1) / 2 +// ... +// r15 := (a15 + b15) / 2 +// +// https://msdn.microsoft.com/en-us/library/vstudio/8zwh554a(v%3dvs.90).aspx +FORCE_INLINE __m128i _mm_avg_epu8(__m128i a, __m128i b) +{ + return vreinterpretq_m128i_u8( + vrhaddq_u8(vreinterpretq_u8_m128i(a), vreinterpretq_u8_m128i(b))); +} + +// Computes the average of the 8 unsigned 16-bit integers in a and the 8 +// unsigned 16-bit integers in b and rounds. +// +// r0 := (a0 + b0) / 2 +// r1 := (a1 + b1) / 2 +// ... +// r7 := (a7 + b7) / 2 +// +// https://msdn.microsoft.com/en-us/library/vstudio/y13ca3c8(v=vs.90).aspx +FORCE_INLINE __m128i _mm_avg_epu16(__m128i a, __m128i b) +{ + return (__m128i) vrhaddq_u16(vreinterpretq_u16_m128i(a), + vreinterpretq_u16_m128i(b)); +} + +// Adds the four single-precision, floating-point values of a and b. +// +// r0 := a0 + b0 +// r1 := a1 + b1 +// r2 := a2 + b2 +// r3 := a3 + b3 +// +// https://msdn.microsoft.com/en-us/library/vstudio/c9848chc(v=vs.100).aspx +FORCE_INLINE __m128 _mm_add_ps(__m128 a, __m128 b) +{ + return vreinterpretq_m128_f32( + vaddq_f32(vreinterpretq_f32_m128(a), vreinterpretq_f32_m128(b))); +} + +// Add packed double-precision (64-bit) floating-point elements in a and b, and +// store the results in dst. +// https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=_mm_add_pd +FORCE_INLINE __m128d _mm_add_pd(__m128d a, __m128d b) +{ +#if defined(__aarch64__) + return vreinterpretq_m128d_f64( + vaddq_f64(vreinterpretq_f64_m128d(a), vreinterpretq_f64_m128d(b))); +#else + double *da = (double *) &a; + double *db = (double *) &b; + double c[2]; + c[0] = da[0] + db[0]; + c[1] = da[1] + db[1]; + return vld1q_f32((float32_t *) c); +#endif +} + +// Add 64-bit integers a and b, and store the result in dst. +// +// dst[63:0] := a[63:0] + b[63:0] +// +// https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=_mm_add_si64 +FORCE_INLINE __m64 _mm_add_si64(__m64 a, __m64 b) +{ + return vreinterpret_m64_s64( + vadd_s64(vreinterpret_s64_m64(a), vreinterpret_s64_m64(b))); +} + +// adds the scalar single-precision floating point values of a and b. +// https://msdn.microsoft.com/en-us/library/be94x2y6(v=vs.100).aspx +FORCE_INLINE __m128 _mm_add_ss(__m128 a, __m128 b) +{ + float32_t b0 = vgetq_lane_f32(vreinterpretq_f32_m128(b), 0); + float32x4_t value = vsetq_lane_f32(b0, vdupq_n_f32(0), 0); + // the upper values in the result must be the remnants of . + return vreinterpretq_m128_f32(vaddq_f32(a, value)); +} + +// Adds the 4 signed or unsigned 64-bit integers in a to the 4 signed or +// unsigned 32-bit integers in b. +// https://msdn.microsoft.com/en-us/library/vstudio/09xs4fkk(v=vs.100).aspx +FORCE_INLINE __m128i _mm_add_epi64(__m128i a, __m128i b) +{ + return vreinterpretq_m128i_s64( + vaddq_s64(vreinterpretq_s64_m128i(a), vreinterpretq_s64_m128i(b))); +} + +// Adds the 4 signed or unsigned 32-bit integers in a to the 4 signed or +// unsigned 32-bit integers in b. +// +// r0 := a0 + b0 +// r1 := a1 + b1 +// r2 := a2 + b2 +// r3 := a3 + b3 +// +// https://msdn.microsoft.com/en-us/library/vstudio/09xs4fkk(v=vs.100).aspx +FORCE_INLINE __m128i _mm_add_epi32(__m128i a, __m128i b) +{ + return vreinterpretq_m128i_s32( + vaddq_s32(vreinterpretq_s32_m128i(a), vreinterpretq_s32_m128i(b))); +} + +// Adds the 8 signed or unsigned 16-bit integers in a to the 8 signed or +// unsigned 16-bit integers in b. +// https://msdn.microsoft.com/en-us/library/fceha5k4(v=vs.100).aspx +FORCE_INLINE __m128i _mm_add_epi16(__m128i a, __m128i b) +{ + return vreinterpretq_m128i_s16( + vaddq_s16(vreinterpretq_s16_m128i(a), vreinterpretq_s16_m128i(b))); +} + +// Adds the 16 signed or unsigned 8-bit integers in a to the 16 signed or +// unsigned 8-bit integers in b. +// https://technet.microsoft.com/en-us/subscriptions/yc7tcyzs(v=vs.90) +FORCE_INLINE __m128i _mm_add_epi8(__m128i a, __m128i b) +{ + return vreinterpretq_m128i_s8( + vaddq_s8(vreinterpretq_s8_m128i(a), vreinterpretq_s8_m128i(b))); +} + +// Adds the 8 signed 16-bit integers in a to the 8 signed 16-bit integers in b +// and saturates. +// +// r0 := SignedSaturate(a0 + b0) +// r1 := SignedSaturate(a1 + b1) +// ... +// r7 := SignedSaturate(a7 + b7) +// +// https://msdn.microsoft.com/en-us/library/1a306ef8(v=vs.100).aspx +FORCE_INLINE __m128i _mm_adds_epi16(__m128i a, __m128i b) +{ + return vreinterpretq_m128i_s16( + vqaddq_s16(vreinterpretq_s16_m128i(a), vreinterpretq_s16_m128i(b))); +} + +// Add packed signed 8-bit integers in a and b using saturation, and store the +// results in dst. +// +// FOR j := 0 to 15 +// i := j*8 +// dst[i+7:i] := Saturate8( a[i+7:i] + b[i+7:i] ) +// ENDFOR +// +// https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=_mm_adds_epi8 +FORCE_INLINE __m128i _mm_adds_epi8(__m128i a, __m128i b) +{ + return vreinterpretq_m128i_s8( + vqaddq_s8(vreinterpretq_s8_m128i(a), vreinterpretq_s8_m128i(b))); +} + +// Adds the 16 unsigned 8-bit integers in a to the 16 unsigned 8-bit integers in +// b and saturates.. +// https://msdn.microsoft.com/en-us/library/9hahyddy(v=vs.100).aspx +FORCE_INLINE __m128i _mm_adds_epu8(__m128i a, __m128i b) +{ + return vreinterpretq_m128i_u8( + vqaddq_u8(vreinterpretq_u8_m128i(a), vreinterpretq_u8_m128i(b))); +} + +// Multiplies the 8 signed or unsigned 16-bit integers from a by the 8 signed or +// unsigned 16-bit integers from b. +// +// r0 := (a0 * b0)[15:0] +// r1 := (a1 * b1)[15:0] +// ... +// r7 := (a7 * b7)[15:0] +// +// https://msdn.microsoft.com/en-us/library/vstudio/9ks1472s(v=vs.100).aspx +FORCE_INLINE __m128i _mm_mullo_epi16(__m128i a, __m128i b) +{ + return vreinterpretq_m128i_s16( + vmulq_s16(vreinterpretq_s16_m128i(a), vreinterpretq_s16_m128i(b))); +} + +// Multiplies the 4 signed or unsigned 32-bit integers from a by the 4 signed or +// unsigned 32-bit integers from b. +// https://msdn.microsoft.com/en-us/library/vstudio/bb531409(v=vs.100).aspx +FORCE_INLINE __m128i _mm_mullo_epi32(__m128i a, __m128i b) +{ + return vreinterpretq_m128i_s32( + vmulq_s32(vreinterpretq_s32_m128i(a), vreinterpretq_s32_m128i(b))); +} + +// Multiply the packed unsigned 16-bit integers in a and b, producing +// intermediate 32-bit integers, and store the high 16 bits of the intermediate +// integers in dst. +// +// FOR j := 0 to 3 +// i := j*16 +// tmp[31:0] := a[i+15:i] * b[i+15:i] +// dst[i+15:i] := tmp[31:16] +// ENDFOR +// +// https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=_m_pmulhuw +#define _m_pmulhuw(a, b) _mm_mulhi_pu16(a, b) + +// Multiplies the four single-precision, floating-point values of a and b. +// +// r0 := a0 * b0 +// r1 := a1 * b1 +// r2 := a2 * b2 +// r3 := a3 * b3 +// +// https://msdn.microsoft.com/en-us/library/vstudio/22kbk6t9(v=vs.100).aspx +FORCE_INLINE __m128 _mm_mul_ps(__m128 a, __m128 b) +{ + return vreinterpretq_m128_f32( + vmulq_f32(vreinterpretq_f32_m128(a), vreinterpretq_f32_m128(b))); +} + +// Multiply packed double-precision (64-bit) floating-point elements in a and b, +// and store the results in dst. +// https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=_mm_mul_pd +FORCE_INLINE __m128d _mm_mul_pd(__m128d a, __m128d b) +{ +#if defined(__aarch64__) + return vreinterpretq_m128d_f64( + vmulq_f64(vreinterpretq_f64_m128d(a), vreinterpretq_f64_m128d(b))); +#else + double *da = (double *) &a; + double *db = (double *) &b; + double c[2]; + c[0] = da[0] * db[0]; + c[1] = da[1] * db[1]; + return vld1q_f32((float32_t *) c); +#endif +} + +// Multiply the lower single-precision (32-bit) floating-point element in a and +// b, store the result in the lower element of dst, and copy the upper 3 packed +// elements from a to the upper elements of dst. +// +// dst[31:0] := a[31:0] * b[31:0] +// dst[127:32] := a[127:32] +// +// https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=_mm_mul_ss +FORCE_INLINE __m128 _mm_mul_ss(__m128 a, __m128 b) +{ + return _mm_move_ss(a, _mm_mul_ps(a, b)); +} + +// Multiply the low unsigned 32-bit integers from each packed 64-bit element in +// a and b, and store the unsigned 64-bit results in dst. +// +// r0 := (a0 & 0xFFFFFFFF) * (b0 & 0xFFFFFFFF) +// r1 := (a2 & 0xFFFFFFFF) * (b2 & 0xFFFFFFFF) +FORCE_INLINE __m128i _mm_mul_epu32(__m128i a, __m128i b) +{ + // vmull_u32 upcasts instead of masking, so we downcast. + uint32x2_t a_lo = vmovn_u64(vreinterpretq_u64_m128i(a)); + uint32x2_t b_lo = vmovn_u64(vreinterpretq_u64_m128i(b)); + return vreinterpretq_m128i_u64(vmull_u32(a_lo, b_lo)); +} + +// Multiply the low unsigned 32-bit integers from a and b, and store the +// unsigned 64-bit result in dst. +// +// dst[63:0] := a[31:0] * b[31:0] +// +// https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=_mm_mul_su32 +FORCE_INLINE __m64 _mm_mul_su32(__m64 a, __m64 b) +{ + return vreinterpret_m64_u64(vget_low_u64( + vmull_u32(vreinterpret_u32_m64(a), vreinterpret_u32_m64(b)))); +} + +// Multiply the low signed 32-bit integers from each packed 64-bit element in +// a and b, and store the signed 64-bit results in dst. +// +// r0 := (int64_t)(int32_t)a0 * (int64_t)(int32_t)b0 +// r1 := (int64_t)(int32_t)a2 * (int64_t)(int32_t)b2 +FORCE_INLINE __m128i _mm_mul_epi32(__m128i a, __m128i b) +{ + // vmull_s32 upcasts instead of masking, so we downcast. + int32x2_t a_lo = vmovn_s64(vreinterpretq_s64_m128i(a)); + int32x2_t b_lo = vmovn_s64(vreinterpretq_s64_m128i(b)); + return vreinterpretq_m128i_s64(vmull_s32(a_lo, b_lo)); +} + +// Multiplies the 8 signed 16-bit integers from a by the 8 signed 16-bit +// integers from b. +// +// r0 := (a0 * b0) + (a1 * b1) +// r1 := (a2 * b2) + (a3 * b3) +// r2 := (a4 * b4) + (a5 * b5) +// r3 := (a6 * b6) + (a7 * b7) +// https://msdn.microsoft.com/en-us/library/yht36sa6(v=vs.90).aspx +FORCE_INLINE __m128i _mm_madd_epi16(__m128i a, __m128i b) +{ + int32x4_t low = vmull_s16(vget_low_s16(vreinterpretq_s16_m128i(a)), + vget_low_s16(vreinterpretq_s16_m128i(b))); + int32x4_t high = vmull_s16(vget_high_s16(vreinterpretq_s16_m128i(a)), + vget_high_s16(vreinterpretq_s16_m128i(b))); + + int32x2_t low_sum = vpadd_s32(vget_low_s32(low), vget_high_s32(low)); + int32x2_t high_sum = vpadd_s32(vget_low_s32(high), vget_high_s32(high)); + + return vreinterpretq_m128i_s32(vcombine_s32(low_sum, high_sum)); +} + +// Multiply packed signed 16-bit integers in a and b, producing intermediate +// signed 32-bit integers. Shift right by 15 bits while rounding up, and store +// the packed 16-bit integers in dst. +// +// r0 := Round(((int32_t)a0 * (int32_t)b0) >> 15) +// r1 := Round(((int32_t)a1 * (int32_t)b1) >> 15) +// r2 := Round(((int32_t)a2 * (int32_t)b2) >> 15) +// ... +// r7 := Round(((int32_t)a7 * (int32_t)b7) >> 15) +FORCE_INLINE __m128i _mm_mulhrs_epi16(__m128i a, __m128i b) +{ + // Has issues due to saturation + // return vreinterpretq_m128i_s16(vqrdmulhq_s16(a, b)); + + // Multiply + int32x4_t mul_lo = vmull_s16(vget_low_s16(vreinterpretq_s16_m128i(a)), + vget_low_s16(vreinterpretq_s16_m128i(b))); + int32x4_t mul_hi = vmull_s16(vget_high_s16(vreinterpretq_s16_m128i(a)), + vget_high_s16(vreinterpretq_s16_m128i(b))); + + // Rounding narrowing shift right + // narrow = (int16_t)((mul + 16384) >> 15); + int16x4_t narrow_lo = vrshrn_n_s32(mul_lo, 15); + int16x4_t narrow_hi = vrshrn_n_s32(mul_hi, 15); + + // Join together + return vreinterpretq_m128i_s16(vcombine_s16(narrow_lo, narrow_hi)); +} + +// Vertically multiply each unsigned 8-bit integer from a with the corresponding +// signed 8-bit integer from b, producing intermediate signed 16-bit integers. +// Horizontally add adjacent pairs of intermediate signed 16-bit integers, +// and pack the saturated results in dst. +// +// FOR j := 0 to 7 +// i := j*16 +// dst[i+15:i] := Saturate_To_Int16( a[i+15:i+8]*b[i+15:i+8] + +// a[i+7:i]*b[i+7:i] ) +// ENDFOR +FORCE_INLINE __m128i _mm_maddubs_epi16(__m128i _a, __m128i _b) +{ +#if defined(__aarch64__) + uint8x16_t a = vreinterpretq_u8_m128i(_a); + int8x16_t b = vreinterpretq_s8_m128i(_b); + int16x8_t tl = vmulq_s16(vreinterpretq_s16_u16(vmovl_u8(vget_low_u8(a))), + vmovl_s8(vget_low_s8(b))); + int16x8_t th = vmulq_s16(vreinterpretq_s16_u16(vmovl_u8(vget_high_u8(a))), + vmovl_s8(vget_high_s8(b))); + return vreinterpretq_m128i_s16( + vqaddq_s16(vuzp1q_s16(tl, th), vuzp2q_s16(tl, th))); +#else + // This would be much simpler if x86 would choose to zero extend OR sign + // extend, not both. This could probably be optimized better. + uint16x8_t a = vreinterpretq_u16_m128i(_a); + int16x8_t b = vreinterpretq_s16_m128i(_b); + + // Zero extend a + int16x8_t a_odd = vreinterpretq_s16_u16(vshrq_n_u16(a, 8)); + int16x8_t a_even = vreinterpretq_s16_u16(vbicq_u16(a, vdupq_n_u16(0xff00))); + + // Sign extend by shifting left then shifting right. + int16x8_t b_even = vshrq_n_s16(vshlq_n_s16(b, 8), 8); + int16x8_t b_odd = vshrq_n_s16(b, 8); + + // multiply + int16x8_t prod1 = vmulq_s16(a_even, b_even); + int16x8_t prod2 = vmulq_s16(a_odd, b_odd); + + // saturated add + return vreinterpretq_m128i_s16(vqaddq_s16(prod1, prod2)); +#endif +} + +// Computes the fused multiple add product of 32-bit floating point numbers. +// +// Return Value +// Multiplies A and B, and adds C to the temporary result before returning it. +// https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=_mm_fmadd +FORCE_INLINE __m128 _mm_fmadd_ps(__m128 a, __m128 b, __m128 c) +{ +#if defined(__aarch64__) + return vreinterpretq_m128_f32(vfmaq_f32(vreinterpretq_f32_m128(c), + vreinterpretq_f32_m128(b), + vreinterpretq_f32_m128(a))); +#else + return _mm_add_ps(_mm_mul_ps(a, b), c); +#endif +} + +// Alternatively add and subtract packed single-precision (32-bit) +// floating-point elements in a to/from packed elements in b, and store the +// results in dst. +// +// https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=addsub_ps +FORCE_INLINE __m128 _mm_addsub_ps(__m128 a, __m128 b) +{ + __m128 mask = {-1.0f, 1.0f, -1.0f, 1.0f}; + return _mm_fmadd_ps(b, mask, a); +} + +// Compute the absolute differences of packed unsigned 8-bit integers in a and +// b, then horizontally sum each consecutive 8 differences to produce two +// unsigned 16-bit integers, and pack these unsigned 16-bit integers in the low +// 16 bits of 64-bit elements in dst. +// https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=_mm_sad_epu8 +FORCE_INLINE __m128i _mm_sad_epu8(__m128i a, __m128i b) +{ + uint16x8_t t = vpaddlq_u8(vabdq_u8((uint8x16_t) a, (uint8x16_t) b)); + uint16_t r0 = t[0] + t[1] + t[2] + t[3]; + uint16_t r4 = t[4] + t[5] + t[6] + t[7]; + uint16x8_t r = vsetq_lane_u16(r0, vdupq_n_u16(0), 0); + return (__m128i) vsetq_lane_u16(r4, r, 4); +} + +// Compute the absolute differences of packed unsigned 8-bit integers in a and +// b, then horizontally sum each consecutive 8 differences to produce four +// unsigned 16-bit integers, and pack these unsigned 16-bit integers in the low +// 16 bits of dst. +// https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=_mm_sad_pu8 +FORCE_INLINE __m64 _mm_sad_pu8(__m64 a, __m64 b) +{ + uint16x4_t t = + vpaddl_u8(vabd_u8(vreinterpret_u8_m64(a), vreinterpret_u8_m64(b))); + uint16_t r0 = t[0] + t[1] + t[2] + t[3]; + return vreinterpret_m64_u16(vset_lane_u16(r0, vdup_n_u16(0), 0)); +} + +// Compute the absolute differences of packed unsigned 8-bit integers in a and +// b, then horizontally sum each consecutive 8 differences to produce four +// unsigned 16-bit integers, and pack these unsigned 16-bit integers in the low +// 16 bits of dst. +// +// FOR j := 0 to 7 +// i := j*8 +// tmp[i+7:i] := ABS(a[i+7:i] - b[i+7:i]) +// ENDFOR +// dst[15:0] := tmp[7:0] + tmp[15:8] + tmp[23:16] + tmp[31:24] + tmp[39:32] + +// tmp[47:40] + tmp[55:48] + tmp[63:56] dst[63:16] := 0 +// +// https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=_m_psadbw +#define _m_psadbw(a, b) _mm_sad_pu8(a, b) + +// Divides the four single-precision, floating-point values of a and b. +// +// r0 := a0 / b0 +// r1 := a1 / b1 +// r2 := a2 / b2 +// r3 := a3 / b3 +// +// https://msdn.microsoft.com/en-us/library/edaw8147(v=vs.100).aspx +FORCE_INLINE __m128 _mm_div_ps(__m128 a, __m128 b) +{ +#if defined(__aarch64__) + return vreinterpretq_m128_f32( + vdivq_f32(vreinterpretq_f32_m128(a), vreinterpretq_f32_m128(b))); +#else + float32x4_t recip0 = vrecpeq_f32(vreinterpretq_f32_m128(b)); + float32x4_t recip1 = + vmulq_f32(recip0, vrecpsq_f32(recip0, vreinterpretq_f32_m128(b))); + return vreinterpretq_m128_f32(vmulq_f32(vreinterpretq_f32_m128(a), recip1)); +#endif +} + +// Divides the scalar single-precision floating point value of a by b. +// https://msdn.microsoft.com/en-us/library/4y73xa49(v=vs.100).aspx +FORCE_INLINE __m128 _mm_div_ss(__m128 a, __m128 b) +{ + float32_t value = + vgetq_lane_f32(vreinterpretq_f32_m128(_mm_div_ps(a, b)), 0); + return vreinterpretq_m128_f32( + vsetq_lane_f32(value, vreinterpretq_f32_m128(a), 0)); +} + +// Compute the approximate reciprocal of packed single-precision (32-bit) +// floating-point elements in a, and store the results in dst. The maximum +// relative error for this approximation is less than 1.5*2^-12. +// https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=_mm_rcp_ps +FORCE_INLINE __m128 _mm_rcp_ps(__m128 in) +{ +#if defined(__aarch64__) + return vreinterpretq_m128_f32( + vdivq_f32(vdupq_n_f32(1.0f), vreinterpretq_f32_m128(in))); +#else + float32x4_t recip = vrecpeq_f32(vreinterpretq_f32_m128(in)); + recip = vmulq_f32(recip, vrecpsq_f32(recip, vreinterpretq_f32_m128(in))); + return vreinterpretq_m128_f32(recip); +#endif +} + +// Compute the approximate reciprocal of the lower single-precision (32-bit) +// floating-point element in a, store the result in the lower element of dst, +// and copy the upper 3 packed elements from a to the upper elements of dst. The +// maximum relative error for this approximation is less than 1.5*2^-12. +// +// dst[31:0] := (1.0 / a[31:0]) +// dst[127:32] := a[127:32] +// +// https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=_mm_rcp_ss +FORCE_INLINE __m128 _mm_rcp_ss(__m128 a) +{ + return _mm_move_ss(a, _mm_rcp_ps(a)); +} + +// Computes the approximations of square roots of the four single-precision, +// floating-point values of a. First computes reciprocal square roots and then +// reciprocals of the four values. +// +// r0 := sqrt(a0) +// r1 := sqrt(a1) +// r2 := sqrt(a2) +// r3 := sqrt(a3) +// +// https://msdn.microsoft.com/en-us/library/vstudio/8z67bwwk(v=vs.100).aspx +FORCE_INLINE __m128 _mm_sqrt_ps(__m128 in) +{ +#if defined(__aarch64__) + return vreinterpretq_m128_f32(vsqrtq_f32(vreinterpretq_f32_m128(in))); +#else + float32x4_t recipsq = vrsqrteq_f32(vreinterpretq_f32_m128(in)); + float32x4_t sq = vrecpeq_f32(recipsq); + // ??? use step versions of both sqrt and recip for better accuracy? + return vreinterpretq_m128_f32(sq); +#endif +} + +// Computes the approximation of the square root of the scalar single-precision +// floating point value of in. +// https://msdn.microsoft.com/en-us/library/ahfsc22d(v=vs.100).aspx +FORCE_INLINE __m128 _mm_sqrt_ss(__m128 in) +{ + float32_t value = + vgetq_lane_f32(vreinterpretq_f32_m128(_mm_sqrt_ps(in)), 0); + return vreinterpretq_m128_f32( + vsetq_lane_f32(value, vreinterpretq_f32_m128(in), 0)); +} + +// Computes the approximations of the reciprocal square roots of the four +// single-precision floating point values of in. +// https://msdn.microsoft.com/en-us/library/22hfsh53(v=vs.100).aspx +FORCE_INLINE __m128 _mm_rsqrt_ps(__m128 in) +{ + return vreinterpretq_m128_f32(vrsqrteq_f32(vreinterpretq_f32_m128(in))); +} + +// Compute the approximate reciprocal square root of the lower single-precision +// (32-bit) floating-point element in a, store the result in the lower element +// of dst, and copy the upper 3 packed elements from a to the upper elements of +// dst. +// https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=_mm_rsqrt_ss +FORCE_INLINE __m128 _mm_rsqrt_ss(__m128 in) +{ + return vsetq_lane_f32(vgetq_lane_f32(_mm_rsqrt_ps(in), 0), in, 0); +} + +// Compare packed signed 16-bit integers in a and b, and store packed maximum +// values in dst. +// +// FOR j := 0 to 3 +// i := j*16 +// dst[i+15:i] := MAX(a[i+15:i], b[i+15:i]) +// ENDFOR +// +// https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=_mm_max_pi16 +FORCE_INLINE __m64 _mm_max_pi16(__m64 a, __m64 b) +{ + return vreinterpret_m64_s16( + vmax_s16(vreinterpret_s16_m64(a), vreinterpret_s16_m64(b))); +} + +// Compare packed signed 16-bit integers in a and b, and store packed maximum +// values in dst. +// +// FOR j := 0 to 3 +// i := j*16 +// dst[i+15:i] := MAX(a[i+15:i], b[i+15:i]) +// ENDFOR +// +// https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=_mm_max_pi16 +#define _m_pmaxsw(a, b) _mm_max_pi16(a, b) + +// Computes the maximums of the four single-precision, floating-point values of +// a and b. +// https://msdn.microsoft.com/en-us/library/vstudio/ff5d607a(v=vs.100).aspx +FORCE_INLINE __m128 _mm_max_ps(__m128 a, __m128 b) +{ +#if SSE2NEON_PRECISE_MINMAX + float32x4_t _a = vreinterpretq_f32_m128(a); + float32x4_t _b = vreinterpretq_f32_m128(b); + return vbslq_f32(vcltq_f32(_b, _a), _a, _b); +#else + return vreinterpretq_m128_f32( + vmaxq_f32(vreinterpretq_f32_m128(a), vreinterpretq_f32_m128(b))); +#endif +} + +// Compare packed unsigned 8-bit integers in a and b, and store packed maximum +// values in dst. +// +// FOR j := 0 to 7 +// i := j*8 +// dst[i+7:i] := MAX(a[i+7:i], b[i+7:i]) +// ENDFOR +// +// https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=_mm_max_pu8 +FORCE_INLINE __m64 _mm_max_pu8(__m64 a, __m64 b) +{ + return vreinterpret_m64_u8( + vmax_u8(vreinterpret_u8_m64(a), vreinterpret_u8_m64(b))); +} + +// Compare packed unsigned 8-bit integers in a and b, and store packed maximum +// values in dst. +// +// FOR j := 0 to 7 +// i := j*8 +// dst[i+7:i] := MAX(a[i+7:i], b[i+7:i]) +// ENDFOR +// +// https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=_mm_max_pu8 +#define _m_pmaxub(a, b) _mm_max_pu8(a, b) + +// Compare packed signed 16-bit integers in a and b, and store packed minimum +// values in dst. +// +// FOR j := 0 to 3 +// i := j*16 +// dst[i+15:i] := MIN(a[i+15:i], b[i+15:i]) +// ENDFOR +// +// https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=_mm_min_pi16 +FORCE_INLINE __m64 _mm_min_pi16(__m64 a, __m64 b) +{ + return vreinterpret_m64_s16( + vmin_s16(vreinterpret_s16_m64(a), vreinterpret_s16_m64(b))); +} + +// Compare packed signed 16-bit integers in a and b, and store packed minimum +// values in dst. +// +// FOR j := 0 to 3 +// i := j*16 +// dst[i+15:i] := MIN(a[i+15:i], b[i+15:i]) +// ENDFOR +// +// https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=_mm_min_pi16 +#define _m_pminsw(a, b) _mm_min_pi16(a, b) + +// Computes the minima of the four single-precision, floating-point values of a +// and b. +// https://msdn.microsoft.com/en-us/library/vstudio/wh13kadz(v=vs.100).aspx +FORCE_INLINE __m128 _mm_min_ps(__m128 a, __m128 b) +{ +#if SSE2NEON_PRECISE_MINMAX + float32x4_t _a = vreinterpretq_f32_m128(a); + float32x4_t _b = vreinterpretq_f32_m128(b); + return vbslq_f32(vcltq_f32(_a, _b), _a, _b); +#else + return vreinterpretq_m128_f32( + vminq_f32(vreinterpretq_f32_m128(a), vreinterpretq_f32_m128(b))); +#endif +} + +// Compare packed unsigned 8-bit integers in a and b, and store packed minimum +// values in dst. +// +// FOR j := 0 to 7 +// i := j*8 +// dst[i+7:i] := MIN(a[i+7:i], b[i+7:i]) +// ENDFOR +// +// https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=_mm_min_pu8 +FORCE_INLINE __m64 _mm_min_pu8(__m64 a, __m64 b) +{ + return vreinterpret_m64_u8( + vmin_u8(vreinterpret_u8_m64(a), vreinterpret_u8_m64(b))); +} + +// Compare packed unsigned 8-bit integers in a and b, and store packed minimum +// values in dst. +// +// FOR j := 0 to 7 +// i := j*8 +// dst[i+7:i] := MIN(a[i+7:i], b[i+7:i]) +// ENDFOR +// +// https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=_mm_min_pu8 +#define _m_pminub(a, b) _mm_min_pu8(a, b) + +// Computes the maximum of the two lower scalar single-precision floating point +// values of a and b. +// https://msdn.microsoft.com/en-us/library/s6db5esz(v=vs.100).aspx +FORCE_INLINE __m128 _mm_max_ss(__m128 a, __m128 b) +{ + float32_t value = vgetq_lane_f32(_mm_max_ps(a, b), 0); + return vreinterpretq_m128_f32( + vsetq_lane_f32(value, vreinterpretq_f32_m128(a), 0)); +} + +// Computes the minimum of the two lower scalar single-precision floating point +// values of a and b. +// https://msdn.microsoft.com/en-us/library/0a9y7xaa(v=vs.100).aspx +FORCE_INLINE __m128 _mm_min_ss(__m128 a, __m128 b) +{ + float32_t value = vgetq_lane_f32(_mm_min_ps(a, b), 0); + return vreinterpretq_m128_f32( + vsetq_lane_f32(value, vreinterpretq_f32_m128(a), 0)); +} + +// Computes the pairwise maxima of the 16 unsigned 8-bit integers from a and the +// 16 unsigned 8-bit integers from b. +// https://msdn.microsoft.com/en-us/library/st6634za(v=vs.100).aspx +FORCE_INLINE __m128i _mm_max_epu8(__m128i a, __m128i b) +{ + return vreinterpretq_m128i_u8( + vmaxq_u8(vreinterpretq_u8_m128i(a), vreinterpretq_u8_m128i(b))); +} + +// Computes the pairwise minima of the 16 unsigned 8-bit integers from a and the +// 16 unsigned 8-bit integers from b. +// https://msdn.microsoft.com/ko-kr/library/17k8cf58(v=vs.100).aspxx +FORCE_INLINE __m128i _mm_min_epu8(__m128i a, __m128i b) +{ + return vreinterpretq_m128i_u8( + vminq_u8(vreinterpretq_u8_m128i(a), vreinterpretq_u8_m128i(b))); +} + +// Computes the pairwise minima of the 8 signed 16-bit integers from a and the 8 +// signed 16-bit integers from b. +// https://msdn.microsoft.com/en-us/library/vstudio/6te997ew(v=vs.100).aspx +FORCE_INLINE __m128i _mm_min_epi16(__m128i a, __m128i b) +{ + return vreinterpretq_m128i_s16( + vminq_s16(vreinterpretq_s16_m128i(a), vreinterpretq_s16_m128i(b))); +} + +// Compare packed signed 8-bit integers in a and b, and store packed maximum +// values in dst. +// https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=_mm_max_epi8 +FORCE_INLINE __m128i _mm_max_epi8(__m128i a, __m128i b) +{ + return vreinterpretq_m128i_s8( + vmaxq_s8(vreinterpretq_s8_m128i(a), vreinterpretq_s8_m128i(b))); +} + +// Compare packed unsigned 16-bit integers in a and b, and store packed maximum +// values in dst. +// https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=_mm_max_epu16 +FORCE_INLINE __m128i _mm_max_epu16(__m128i a, __m128i b) +{ + return vreinterpretq_m128i_u16( + vmaxq_u16(vreinterpretq_u16_m128i(a), vreinterpretq_u16_m128i(b))); +} + +// Compare packed signed 8-bit integers in a and b, and store packed minimum +// values in dst. +// https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=_mm_min_epi8 +FORCE_INLINE __m128i _mm_min_epi8(__m128i a, __m128i b) +{ + return vreinterpretq_m128i_s8( + vminq_s8(vreinterpretq_s8_m128i(a), vreinterpretq_s8_m128i(b))); +} + +// Compare packed unsigned 16-bit integers in a and b, and store packed minimum +// values in dst. +// https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=_mm_min_epu16 +FORCE_INLINE __m128i _mm_min_epu16(__m128i a, __m128i b) +{ + return vreinterpretq_m128i_u16( + vminq_u16(vreinterpretq_u16_m128i(a), vreinterpretq_u16_m128i(b))); +} + +// Computes the pairwise maxima of the 8 signed 16-bit integers from a and the 8 +// signed 16-bit integers from b. +// https://msdn.microsoft.com/en-us/LIBRary/3x060h7c(v=vs.100).aspx +FORCE_INLINE __m128i _mm_max_epi16(__m128i a, __m128i b) +{ + return vreinterpretq_m128i_s16( + vmaxq_s16(vreinterpretq_s16_m128i(a), vreinterpretq_s16_m128i(b))); +} + +// epi versions of min/max +// Computes the pariwise maximums of the four signed 32-bit integer values of a +// and b. +// +// A 128-bit parameter that can be defined with the following equations: +// r0 := (a0 > b0) ? a0 : b0 +// r1 := (a1 > b1) ? a1 : b1 +// r2 := (a2 > b2) ? a2 : b2 +// r3 := (a3 > b3) ? a3 : b3 +// +// https://msdn.microsoft.com/en-us/library/vstudio/bb514055(v=vs.100).aspx +FORCE_INLINE __m128i _mm_max_epi32(__m128i a, __m128i b) +{ + return vreinterpretq_m128i_s32( + vmaxq_s32(vreinterpretq_s32_m128i(a), vreinterpretq_s32_m128i(b))); +} + +// Computes the pariwise minima of the four signed 32-bit integer values of a +// and b. +// +// A 128-bit parameter that can be defined with the following equations: +// r0 := (a0 < b0) ? a0 : b0 +// r1 := (a1 < b1) ? a1 : b1 +// r2 := (a2 < b2) ? a2 : b2 +// r3 := (a3 < b3) ? a3 : b3 +// +// https://msdn.microsoft.com/en-us/library/vstudio/bb531476(v=vs.100).aspx +FORCE_INLINE __m128i _mm_min_epi32(__m128i a, __m128i b) +{ + return vreinterpretq_m128i_s32( + vminq_s32(vreinterpretq_s32_m128i(a), vreinterpretq_s32_m128i(b))); +} + +// Compare packed unsigned 32-bit integers in a and b, and store packed maximum +// values in dst. +// https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=_mm_max_epu32 +FORCE_INLINE __m128i _mm_max_epu32(__m128i a, __m128i b) +{ + return vreinterpretq_m128i_u32( + vmaxq_u32(vreinterpretq_u32_m128i(a), vreinterpretq_u32_m128i(b))); +} + +// Compare packed unsigned 32-bit integers in a and b, and store packed minimum +// values in dst. +// https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=_mm_max_epu32 +FORCE_INLINE __m128i _mm_min_epu32(__m128i a, __m128i b) +{ + return vreinterpretq_m128i_u32( + vminq_u32(vreinterpretq_u32_m128i(a), vreinterpretq_u32_m128i(b))); +} + +// Multiply the packed unsigned 16-bit integers in a and b, producing +// intermediate 32-bit integers, and store the high 16 bits of the intermediate +// integers in dst. +// https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=_mm_mulhi_pu16 +FORCE_INLINE __m64 _mm_mulhi_pu16(__m64 a, __m64 b) +{ + return vreinterpret_m64_u16(vshrn_n_u32( + vmull_u16(vreinterpret_u16_m64(a), vreinterpret_u16_m64(b)), 16)); +} + +// Multiplies the 8 signed 16-bit integers from a by the 8 signed 16-bit +// integers from b. +// +// r0 := (a0 * b0)[31:16] +// r1 := (a1 * b1)[31:16] +// ... +// r7 := (a7 * b7)[31:16] +// +// https://msdn.microsoft.com/en-us/library/vstudio/59hddw1d(v=vs.100).aspx +FORCE_INLINE __m128i _mm_mulhi_epi16(__m128i a, __m128i b) +{ + /* FIXME: issue with large values because of result saturation */ + // int16x8_t ret = vqdmulhq_s16(vreinterpretq_s16_m128i(a), + // vreinterpretq_s16_m128i(b)); /* =2*a*b */ return + // vreinterpretq_m128i_s16(vshrq_n_s16(ret, 1)); + int16x4_t a3210 = vget_low_s16(vreinterpretq_s16_m128i(a)); + int16x4_t b3210 = vget_low_s16(vreinterpretq_s16_m128i(b)); + int32x4_t ab3210 = vmull_s16(a3210, b3210); /* 3333222211110000 */ + int16x4_t a7654 = vget_high_s16(vreinterpretq_s16_m128i(a)); + int16x4_t b7654 = vget_high_s16(vreinterpretq_s16_m128i(b)); + int32x4_t ab7654 = vmull_s16(a7654, b7654); /* 7777666655554444 */ + uint16x8x2_t r = + vuzpq_u16(vreinterpretq_u16_s32(ab3210), vreinterpretq_u16_s32(ab7654)); + return vreinterpretq_m128i_u16(r.val[1]); +} + +// Multiply the packed unsigned 16-bit integers in a and b, producing +// intermediate 32-bit integers, and store the high 16 bits of the intermediate +// integers in dst. +// https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=_mm_mulhi_epu16 +FORCE_INLINE __m128i _mm_mulhi_epu16(__m128i a, __m128i b) +{ + uint16x4_t a3210 = vget_low_u16(vreinterpretq_u16_m128i(a)); + uint16x4_t b3210 = vget_low_u16(vreinterpretq_u16_m128i(b)); + uint32x4_t ab3210 = vmull_u16(a3210, b3210); +#if defined(__aarch64__) + uint32x4_t ab7654 = + vmull_high_u16(vreinterpretq_u16_m128i(a), vreinterpretq_u16_m128i(b)); + uint16x8_t r = vuzp2q_u16(vreinterpretq_u16_u32(ab3210), + vreinterpretq_u16_u32(ab7654)); + return vreinterpretq_m128i_u16(r); +#else + uint16x4_t a7654 = vget_high_u16(vreinterpretq_u16_m128i(a)); + uint16x4_t b7654 = vget_high_u16(vreinterpretq_u16_m128i(b)); + uint32x4_t ab7654 = vmull_u16(a7654, b7654); + uint16x8x2_t r = + vuzpq_u16(vreinterpretq_u16_u32(ab3210), vreinterpretq_u16_u32(ab7654)); + return vreinterpretq_m128i_u16(r.val[1]); +#endif +} + +// Computes pairwise add of each argument as single-precision, floating-point +// values a and b. +// https://msdn.microsoft.com/en-us/library/yd9wecaa.aspx +FORCE_INLINE __m128 _mm_hadd_ps(__m128 a, __m128 b) +{ +#if defined(__aarch64__) + return vreinterpretq_m128_f32( + vpaddq_f32(vreinterpretq_f32_m128(a), vreinterpretq_f32_m128(b))); +#else + float32x2_t a10 = vget_low_f32(vreinterpretq_f32_m128(a)); + float32x2_t a32 = vget_high_f32(vreinterpretq_f32_m128(a)); + float32x2_t b10 = vget_low_f32(vreinterpretq_f32_m128(b)); + float32x2_t b32 = vget_high_f32(vreinterpretq_f32_m128(b)); + return vreinterpretq_m128_f32( + vcombine_f32(vpadd_f32(a10, a32), vpadd_f32(b10, b32))); +#endif +} + +// Computes pairwise add of each argument as a 16-bit signed or unsigned integer +// values a and b. +FORCE_INLINE __m128i _mm_hadd_epi16(__m128i _a, __m128i _b) +{ + int16x8_t a = vreinterpretq_s16_m128i(_a); + int16x8_t b = vreinterpretq_s16_m128i(_b); +#if defined(__aarch64__) + return vreinterpretq_m128i_s16(vpaddq_s16(a, b)); +#else + return vreinterpretq_m128i_s16( + vcombine_s16(vpadd_s16(vget_low_s16(a), vget_high_s16(a)), + vpadd_s16(vget_low_s16(b), vget_high_s16(b)))); +#endif +} + +// Horizontally substract adjacent pairs of single-precision (32-bit) +// floating-point elements in a and b, and pack the results in dst. +// https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=_mm_hsub_ps +FORCE_INLINE __m128 _mm_hsub_ps(__m128 _a, __m128 _b) +{ +#if defined(__aarch64__) + return vreinterpretq_m128_f32(vsubq_f32( + vuzp1q_f32(vreinterpretq_f32_m128(_a), vreinterpretq_f32_m128(_b)), + vuzp2q_f32(vreinterpretq_f32_m128(_a), vreinterpretq_f32_m128(_b)))); +#else + float32x4x2_t c = + vuzpq_f32(vreinterpretq_f32_m128(_a), vreinterpretq_f32_m128(_b)); + return vreinterpretq_m128_f32(vsubq_f32(c.val[0], c.val[1])); +#endif +} + +// Horizontally add adjacent pairs of 16-bit integers in a and b, and pack the +// signed 16-bit results in dst. +// https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=_mm_hadd_pi16 +FORCE_INLINE __m64 _mm_hadd_pi16(__m64 a, __m64 b) +{ + return vreinterpret_m64_s16( + vpadd_s16(vreinterpret_s16_m64(a), vreinterpret_s16_m64(b))); +} + +// Horizontally add adjacent pairs of 32-bit integers in a and b, and pack the +// signed 32-bit results in dst. +// https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=_mm_hadd_pi32 +FORCE_INLINE __m64 _mm_hadd_pi32(__m64 a, __m64 b) +{ + return vreinterpret_m64_s32( + vpadd_s32(vreinterpret_s32_m64(a), vreinterpret_s32_m64(b))); +} + +// Computes pairwise difference of each argument as a 16-bit signed or unsigned +// integer values a and b. +FORCE_INLINE __m128i _mm_hsub_epi16(__m128i _a, __m128i _b) +{ + int32x4_t a = vreinterpretq_s32_m128i(_a); + int32x4_t b = vreinterpretq_s32_m128i(_b); + // Interleave using vshrn/vmovn + // [a0|a2|a4|a6|b0|b2|b4|b6] + // [a1|a3|a5|a7|b1|b3|b5|b7] + int16x8_t ab0246 = vcombine_s16(vmovn_s32(a), vmovn_s32(b)); + int16x8_t ab1357 = vcombine_s16(vshrn_n_s32(a, 16), vshrn_n_s32(b, 16)); + // Subtract + return vreinterpretq_m128i_s16(vsubq_s16(ab0246, ab1357)); +} + +// Computes saturated pairwise sub of each argument as a 16-bit signed +// integer values a and b. +FORCE_INLINE __m128i _mm_hadds_epi16(__m128i _a, __m128i _b) +{ +#if defined(__aarch64__) + int16x8_t a = vreinterpretq_s16_m128i(_a); + int16x8_t b = vreinterpretq_s16_m128i(_b); + return vreinterpretq_s64_s16( + vqaddq_s16(vuzp1q_s16(a, b), vuzp2q_s16(a, b))); +#else + int32x4_t a = vreinterpretq_s32_m128i(_a); + int32x4_t b = vreinterpretq_s32_m128i(_b); + // Interleave using vshrn/vmovn + // [a0|a2|a4|a6|b0|b2|b4|b6] + // [a1|a3|a5|a7|b1|b3|b5|b7] + int16x8_t ab0246 = vcombine_s16(vmovn_s32(a), vmovn_s32(b)); + int16x8_t ab1357 = vcombine_s16(vshrn_n_s32(a, 16), vshrn_n_s32(b, 16)); + // Saturated add + return vreinterpretq_m128i_s16(vqaddq_s16(ab0246, ab1357)); +#endif +} + +// Computes saturated pairwise difference of each argument as a 16-bit signed +// integer values a and b. +// https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=_mm_hsubs_epi16 +FORCE_INLINE __m128i _mm_hsubs_epi16(__m128i _a, __m128i _b) +{ +#if defined(__aarch64__) + int16x8_t a = vreinterpretq_s16_m128i(_a); + int16x8_t b = vreinterpretq_s16_m128i(_b); + return vreinterpretq_s64_s16( + vqsubq_s16(vuzp1q_s16(a, b), vuzp2q_s16(a, b))); +#else + int32x4_t a = vreinterpretq_s32_m128i(_a); + int32x4_t b = vreinterpretq_s32_m128i(_b); + // Interleave using vshrn/vmovn + // [a0|a2|a4|a6|b0|b2|b4|b6] + // [a1|a3|a5|a7|b1|b3|b5|b7] + int16x8_t ab0246 = vcombine_s16(vmovn_s32(a), vmovn_s32(b)); + int16x8_t ab1357 = vcombine_s16(vshrn_n_s32(a, 16), vshrn_n_s32(b, 16)); + // Saturated subtract + return vreinterpretq_m128i_s16(vqsubq_s16(ab0246, ab1357)); +#endif +} + +// Computes pairwise add of each argument as a 32-bit signed or unsigned integer +// values a and b. +FORCE_INLINE __m128i _mm_hadd_epi32(__m128i _a, __m128i _b) +{ + int32x4_t a = vreinterpretq_s32_m128i(_a); + int32x4_t b = vreinterpretq_s32_m128i(_b); + return vreinterpretq_m128i_s32( + vcombine_s32(vpadd_s32(vget_low_s32(a), vget_high_s32(a)), + vpadd_s32(vget_low_s32(b), vget_high_s32(b)))); +} + +// Computes pairwise difference of each argument as a 32-bit signed or unsigned +// integer values a and b. +FORCE_INLINE __m128i _mm_hsub_epi32(__m128i _a, __m128i _b) +{ + int64x2_t a = vreinterpretq_s64_m128i(_a); + int64x2_t b = vreinterpretq_s64_m128i(_b); + // Interleave using vshrn/vmovn + // [a0|a2|b0|b2] + // [a1|a2|b1|b3] + int32x4_t ab02 = vcombine_s32(vmovn_s64(a), vmovn_s64(b)); + int32x4_t ab13 = vcombine_s32(vshrn_n_s64(a, 32), vshrn_n_s64(b, 32)); + // Subtract + return vreinterpretq_m128i_s32(vsubq_s32(ab02, ab13)); +} + +// Kahan summation for accurate summation of floating-point numbers. +// http://blog.zachbjornson.com/2019/08/11/fast-float-summation.html +FORCE_INLINE void sse2neon_kadd_f32(float *sum, float *c, float y) +{ + y -= *c; + float t = *sum + y; + *c = (t - *sum) - y; + *sum = t; +} + +// Conditionally multiply the packed single-precision (32-bit) floating-point +// elements in a and b using the high 4 bits in imm8, sum the four products, +// and conditionally store the sum in dst using the low 4 bits of imm. +// https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=_mm_dp_ps +FORCE_INLINE __m128 _mm_dp_ps(__m128 a, __m128 b, const int imm) +{ +#if defined(__aarch64__) + /* shortcuts */ + if (imm == 0xFF) { + return _mm_set1_ps(vaddvq_f32(_mm_mul_ps(a, b))); + } + if (imm == 0x7F) { + float32x4_t m = _mm_mul_ps(a, b); + m[3] = 0; + return _mm_set1_ps(vaddvq_f32(m)); + } +#endif + + float s = 0, c = 0; + float32x4_t f32a = vreinterpretq_f32_m128(a); + float32x4_t f32b = vreinterpretq_f32_m128(b); + + /* To improve the accuracy of floating-point summation, Kahan algorithm + * is used for each operation. + */ + if (imm & (1 << 4)) + sse2neon_kadd_f32(&s, &c, f32a[0] * f32b[0]); + if (imm & (1 << 5)) + sse2neon_kadd_f32(&s, &c, f32a[1] * f32b[1]); + if (imm & (1 << 6)) + sse2neon_kadd_f32(&s, &c, f32a[2] * f32b[2]); + if (imm & (1 << 7)) + sse2neon_kadd_f32(&s, &c, f32a[3] * f32b[3]); + s += c; + + float32x4_t res = { + (imm & 0x1) ? s : 0, + (imm & 0x2) ? s : 0, + (imm & 0x4) ? s : 0, + (imm & 0x8) ? s : 0, + }; + return vreinterpretq_m128_f32(res); +} + +/* Compare operations */ + +// Compares for less than +// https://msdn.microsoft.com/en-us/library/vstudio/f330yhc8(v=vs.100).aspx +FORCE_INLINE __m128 _mm_cmplt_ps(__m128 a, __m128 b) +{ + return vreinterpretq_m128_u32( + vcltq_f32(vreinterpretq_f32_m128(a), vreinterpretq_f32_m128(b))); +} + +// Compares for less than +// https://docs.microsoft.com/en-us/previous-versions/visualstudio/visual-studio-2010/fy94wye7(v=vs.100) +FORCE_INLINE __m128 _mm_cmplt_ss(__m128 a, __m128 b) +{ + return _mm_move_ss(a, _mm_cmplt_ps(a, b)); +} + +// Compares for greater than. +// +// r0 := (a0 > b0) ? 0xffffffff : 0x0 +// r1 := (a1 > b1) ? 0xffffffff : 0x0 +// r2 := (a2 > b2) ? 0xffffffff : 0x0 +// r3 := (a3 > b3) ? 0xffffffff : 0x0 +// +// https://msdn.microsoft.com/en-us/library/vstudio/11dy102s(v=vs.100).aspx +FORCE_INLINE __m128 _mm_cmpgt_ps(__m128 a, __m128 b) +{ + return vreinterpretq_m128_u32( + vcgtq_f32(vreinterpretq_f32_m128(a), vreinterpretq_f32_m128(b))); +} + +// Compares for greater than. +// https://docs.microsoft.com/en-us/previous-versions/visualstudio/visual-studio-2010/1xyyyy9e(v=vs.100) +FORCE_INLINE __m128 _mm_cmpgt_ss(__m128 a, __m128 b) +{ + return _mm_move_ss(a, _mm_cmpgt_ps(a, b)); +} + +// Compares for greater than or equal. +// https://msdn.microsoft.com/en-us/library/vstudio/fs813y2t(v=vs.100).aspx +FORCE_INLINE __m128 _mm_cmpge_ps(__m128 a, __m128 b) +{ + return vreinterpretq_m128_u32( + vcgeq_f32(vreinterpretq_f32_m128(a), vreinterpretq_f32_m128(b))); +} + +// Compares for greater than or equal. +// https://docs.microsoft.com/en-us/previous-versions/visualstudio/visual-studio-2010/kesh3ddc(v=vs.100) +FORCE_INLINE __m128 _mm_cmpge_ss(__m128 a, __m128 b) +{ + return _mm_move_ss(a, _mm_cmpge_ps(a, b)); +} + +// Compares for less than or equal. +// +// r0 := (a0 <= b0) ? 0xffffffff : 0x0 +// r1 := (a1 <= b1) ? 0xffffffff : 0x0 +// r2 := (a2 <= b2) ? 0xffffffff : 0x0 +// r3 := (a3 <= b3) ? 0xffffffff : 0x0 +// +// https://msdn.microsoft.com/en-us/library/vstudio/1s75w83z(v=vs.100).aspx +FORCE_INLINE __m128 _mm_cmple_ps(__m128 a, __m128 b) +{ + return vreinterpretq_m128_u32( + vcleq_f32(vreinterpretq_f32_m128(a), vreinterpretq_f32_m128(b))); +} + +// Compares for less than or equal. +// https://docs.microsoft.com/en-us/previous-versions/visualstudio/visual-studio-2010/a7x0hbhw(v=vs.100) +FORCE_INLINE __m128 _mm_cmple_ss(__m128 a, __m128 b) +{ + return _mm_move_ss(a, _mm_cmple_ps(a, b)); +} + +// Compares for equality. +// https://msdn.microsoft.com/en-us/library/vstudio/36aectz5(v=vs.100).aspx +FORCE_INLINE __m128 _mm_cmpeq_ps(__m128 a, __m128 b) +{ + return vreinterpretq_m128_u32( + vceqq_f32(vreinterpretq_f32_m128(a), vreinterpretq_f32_m128(b))); +} + +// Compares for equality. +// https://docs.microsoft.com/en-us/previous-versions/visualstudio/visual-studio-2010/k423z28e(v=vs.100) +FORCE_INLINE __m128 _mm_cmpeq_ss(__m128 a, __m128 b) +{ + return _mm_move_ss(a, _mm_cmpeq_ps(a, b)); +} + +// Compares for inequality. +// https://msdn.microsoft.com/en-us/library/sf44thbx(v=vs.100).aspx +FORCE_INLINE __m128 _mm_cmpneq_ps(__m128 a, __m128 b) +{ + return vreinterpretq_m128_u32(vmvnq_u32( + vceqq_f32(vreinterpretq_f32_m128(a), vreinterpretq_f32_m128(b)))); +} + +// Compares for inequality. +// https://docs.microsoft.com/en-us/previous-versions/visualstudio/visual-studio-2010/ekya8fh4(v=vs.100) +FORCE_INLINE __m128 _mm_cmpneq_ss(__m128 a, __m128 b) +{ + return _mm_move_ss(a, _mm_cmpneq_ps(a, b)); +} + +// Compares for not greater than or equal. +// https://docs.microsoft.com/en-us/previous-versions/visualstudio/visual-studio-2010/wsexys62(v=vs.100) +FORCE_INLINE __m128 _mm_cmpnge_ps(__m128 a, __m128 b) +{ + return _mm_cmplt_ps(a, b); +} + +// Compares for not greater than or equal. +// https://docs.microsoft.com/en-us/previous-versions/visualstudio/visual-studio-2010/fk2y80s8(v=vs.100) +FORCE_INLINE __m128 _mm_cmpnge_ss(__m128 a, __m128 b) +{ + return _mm_cmplt_ss(a, b); +} + +// Compares for not greater than. +// https://docs.microsoft.com/en-us/previous-versions/visualstudio/visual-studio-2010/d0xh7w0s(v=vs.100) +FORCE_INLINE __m128 _mm_cmpngt_ps(__m128 a, __m128 b) +{ + return _mm_cmple_ps(a, b); +} + +// Compares for not greater than. +// https://docs.microsoft.com/en-us/previous-versions/visualstudio/visual-studio-2010/z7x9ydwh(v=vs.100) +FORCE_INLINE __m128 _mm_cmpngt_ss(__m128 a, __m128 b) +{ + return _mm_cmple_ss(a, b); +} + +// Compares for not less than or equal. +// https://docs.microsoft.com/en-us/previous-versions/visualstudio/visual-studio-2010/6a330kxw(v=vs.100) +FORCE_INLINE __m128 _mm_cmpnle_ps(__m128 a, __m128 b) +{ + return _mm_cmpgt_ps(a, b); +} + +// Compares for not less than or equal. +// https://docs.microsoft.com/en-us/previous-versions/visualstudio/visual-studio-2010/z7x9ydwh(v=vs.100) +FORCE_INLINE __m128 _mm_cmpnle_ss(__m128 a, __m128 b) +{ + return _mm_cmpgt_ss(a, b); +} + +// Compares for not less than. +// https://docs.microsoft.com/en-us/previous-versions/visualstudio/visual-studio-2010/4686bbdw(v=vs.100) +FORCE_INLINE __m128 _mm_cmpnlt_ps(__m128 a, __m128 b) +{ + return _mm_cmpge_ps(a, b); +} + +// Compares for not less than. +// https://docs.microsoft.com/en-us/previous-versions/visualstudio/visual-studio-2010/56b9z2wf(v=vs.100) +FORCE_INLINE __m128 _mm_cmpnlt_ss(__m128 a, __m128 b) +{ + return _mm_cmpge_ss(a, b); +} + +// Compares the 16 signed or unsigned 8-bit integers in a and the 16 signed or +// unsigned 8-bit integers in b for equality. +// https://msdn.microsoft.com/en-us/library/windows/desktop/bz5xk21a(v=vs.90).aspx +FORCE_INLINE __m128i _mm_cmpeq_epi8(__m128i a, __m128i b) +{ + return vreinterpretq_m128i_u8( + vceqq_s8(vreinterpretq_s8_m128i(a), vreinterpretq_s8_m128i(b))); +} + +// Compares the 8 signed or unsigned 16-bit integers in a and the 8 signed or +// unsigned 16-bit integers in b for equality. +// https://msdn.microsoft.com/en-us/library/2ay060te(v=vs.100).aspx +FORCE_INLINE __m128i _mm_cmpeq_epi16(__m128i a, __m128i b) +{ + return vreinterpretq_m128i_u16( + vceqq_s16(vreinterpretq_s16_m128i(a), vreinterpretq_s16_m128i(b))); +} + +// Compare packed 32-bit integers in a and b for equality, and store the results +// in dst +FORCE_INLINE __m128i _mm_cmpeq_epi32(__m128i a, __m128i b) +{ + return vreinterpretq_m128i_u32( + vceqq_s32(vreinterpretq_s32_m128i(a), vreinterpretq_s32_m128i(b))); +} + +// Compare packed 64-bit integers in a and b for equality, and store the results +// in dst +FORCE_INLINE __m128i _mm_cmpeq_epi64(__m128i a, __m128i b) +{ +#if defined(__aarch64__) + return vreinterpretq_m128i_u64( + vceqq_u64(vreinterpretq_u64_m128i(a), vreinterpretq_u64_m128i(b))); +#else + // ARMv7 lacks vceqq_u64 + // (a == b) -> (a_lo == b_lo) && (a_hi == b_hi) + uint32x4_t cmp = + vceqq_u32(vreinterpretq_u32_m128i(a), vreinterpretq_u32_m128i(b)); + uint32x4_t swapped = vrev64q_u32(cmp); + return vreinterpretq_m128i_u32(vandq_u32(cmp, swapped)); +#endif +} + +// Compares the 16 signed 8-bit integers in a and the 16 signed 8-bit integers +// in b for lesser than. +// https://msdn.microsoft.com/en-us/library/windows/desktop/9s46csht(v=vs.90).aspx +FORCE_INLINE __m128i _mm_cmplt_epi8(__m128i a, __m128i b) +{ + return vreinterpretq_m128i_u8( + vcltq_s8(vreinterpretq_s8_m128i(a), vreinterpretq_s8_m128i(b))); +} + +// Compares the 16 signed 8-bit integers in a and the 16 signed 8-bit integers +// in b for greater than. +// +// r0 := (a0 > b0) ? 0xff : 0x0 +// r1 := (a1 > b1) ? 0xff : 0x0 +// ... +// r15 := (a15 > b15) ? 0xff : 0x0 +// +// https://msdn.microsoft.com/zh-tw/library/wf45zt2b(v=vs.100).aspx +FORCE_INLINE __m128i _mm_cmpgt_epi8(__m128i a, __m128i b) +{ + return vreinterpretq_m128i_u8( + vcgtq_s8(vreinterpretq_s8_m128i(a), vreinterpretq_s8_m128i(b))); +} + +// Compares the 8 signed 16-bit integers in a and the 8 signed 16-bit integers +// in b for less than. +// +// r0 := (a0 < b0) ? 0xffff : 0x0 +// r1 := (a1 < b1) ? 0xffff : 0x0 +// ... +// r7 := (a7 < b7) ? 0xffff : 0x0 +// +// https://technet.microsoft.com/en-us/library/t863edb2(v=vs.100).aspx +FORCE_INLINE __m128i _mm_cmplt_epi16(__m128i a, __m128i b) +{ + return vreinterpretq_m128i_u16( + vcltq_s16(vreinterpretq_s16_m128i(a), vreinterpretq_s16_m128i(b))); +} + +// Compares the 8 signed 16-bit integers in a and the 8 signed 16-bit integers +// in b for greater than. +// +// r0 := (a0 > b0) ? 0xffff : 0x0 +// r1 := (a1 > b1) ? 0xffff : 0x0 +// ... +// r7 := (a7 > b7) ? 0xffff : 0x0 +// +// https://technet.microsoft.com/en-us/library/xd43yfsa(v=vs.100).aspx +FORCE_INLINE __m128i _mm_cmpgt_epi16(__m128i a, __m128i b) +{ + return vreinterpretq_m128i_u16( + vcgtq_s16(vreinterpretq_s16_m128i(a), vreinterpretq_s16_m128i(b))); +} + + +// Compares the 4 signed 32-bit integers in a and the 4 signed 32-bit integers +// in b for less than. +// https://msdn.microsoft.com/en-us/library/vstudio/4ak0bf5d(v=vs.100).aspx +FORCE_INLINE __m128i _mm_cmplt_epi32(__m128i a, __m128i b) +{ + return vreinterpretq_m128i_u32( + vcltq_s32(vreinterpretq_s32_m128i(a), vreinterpretq_s32_m128i(b))); +} + +// Compares the 4 signed 32-bit integers in a and the 4 signed 32-bit integers +// in b for greater than. +// https://msdn.microsoft.com/en-us/library/vstudio/1s9f2z0y(v=vs.100).aspx +FORCE_INLINE __m128i _mm_cmpgt_epi32(__m128i a, __m128i b) +{ + return vreinterpretq_m128i_u32( + vcgtq_s32(vreinterpretq_s32_m128i(a), vreinterpretq_s32_m128i(b))); +} + +// Compares the 2 signed 64-bit integers in a and the 2 signed 64-bit integers +// in b for greater than. +FORCE_INLINE __m128i _mm_cmpgt_epi64(__m128i a, __m128i b) +{ +#if defined(__aarch64__) + return vreinterpretq_m128i_u64( + vcgtq_s64(vreinterpretq_s64_m128i(a), vreinterpretq_s64_m128i(b))); +#else + // ARMv7 lacks vcgtq_s64. + // This is based off of Clang's SSE2 polyfill: + // (a > b) -> ((a_hi > b_hi) || (a_lo > b_lo && a_hi == b_hi)) + + // Mask the sign bit out since we need a signed AND an unsigned comparison + // and it is ugly to try and split them. + int32x4_t mask = vreinterpretq_s32_s64(vdupq_n_s64(0x80000000ull)); + int32x4_t a_mask = veorq_s32(vreinterpretq_s32_m128i(a), mask); + int32x4_t b_mask = veorq_s32(vreinterpretq_s32_m128i(b), mask); + // Check if a > b + int64x2_t greater = vreinterpretq_s64_u32(vcgtq_s32(a_mask, b_mask)); + // Copy upper mask to lower mask + // a_hi > b_hi + int64x2_t gt_hi = vshrq_n_s64(greater, 63); + // Copy lower mask to upper mask + // a_lo > b_lo + int64x2_t gt_lo = vsliq_n_s64(greater, greater, 32); + // Compare for equality + int64x2_t equal = vreinterpretq_s64_u32(vceqq_s32(a_mask, b_mask)); + // Copy upper mask to lower mask + // a_hi == b_hi + int64x2_t eq_hi = vshrq_n_s64(equal, 63); + // a_hi > b_hi || (a_lo > b_lo && a_hi == b_hi) + int64x2_t ret = vorrq_s64(gt_hi, vandq_s64(gt_lo, eq_hi)); + return vreinterpretq_m128i_s64(ret); +#endif +} + +// Compares the four 32-bit floats in a and b to check if any values are NaN. +// Ordered compare between each value returns true for "orderable" and false for +// "not orderable" (NaN). +// https://msdn.microsoft.com/en-us/library/vstudio/0h9w00fx(v=vs.100).aspx see +// also: +// http://stackoverflow.com/questions/8627331/what-does-ordered-unordered-comparison-mean +// http://stackoverflow.com/questions/29349621/neon-isnanval-intrinsics +FORCE_INLINE __m128 _mm_cmpord_ps(__m128 a, __m128 b) +{ + // Note: NEON does not have ordered compare builtin + // Need to compare a eq a and b eq b to check for NaN + // Do AND of results to get final + uint32x4_t ceqaa = + vceqq_f32(vreinterpretq_f32_m128(a), vreinterpretq_f32_m128(a)); + uint32x4_t ceqbb = + vceqq_f32(vreinterpretq_f32_m128(b), vreinterpretq_f32_m128(b)); + return vreinterpretq_m128_u32(vandq_u32(ceqaa, ceqbb)); +} + +// Compares for ordered. +// https://docs.microsoft.com/en-us/previous-versions/visualstudio/visual-studio-2010/343t62da(v=vs.100) +FORCE_INLINE __m128 _mm_cmpord_ss(__m128 a, __m128 b) +{ + return _mm_move_ss(a, _mm_cmpord_ps(a, b)); +} + +// Compares for unordered. +// https://docs.microsoft.com/en-us/previous-versions/visualstudio/visual-studio-2010/khy6fk1t(v=vs.100) +FORCE_INLINE __m128 _mm_cmpunord_ps(__m128 a, __m128 b) +{ + uint32x4_t f32a = + vceqq_f32(vreinterpretq_f32_m128(a), vreinterpretq_f32_m128(a)); + uint32x4_t f32b = + vceqq_f32(vreinterpretq_f32_m128(b), vreinterpretq_f32_m128(b)); + return vreinterpretq_m128_u32(vmvnq_u32(vandq_u32(f32a, f32b))); +} + +// Compares for unordered. +// https://docs.microsoft.com/en-us/previous-versions/visualstudio/visual-studio-2010/2as2387b(v=vs.100) +FORCE_INLINE __m128 _mm_cmpunord_ss(__m128 a, __m128 b) +{ + return _mm_move_ss(a, _mm_cmpunord_ps(a, b)); +} + +// Compares the lower single-precision floating point scalar values of a and b +// using a less than operation. : +// https://msdn.microsoft.com/en-us/library/2kwe606b(v=vs.90).aspx Important +// note!! The documentation on MSDN is incorrect! If either of the values is a +// NAN the docs say you will get a one, but in fact, it will return a zero!! +FORCE_INLINE int _mm_comilt_ss(__m128 a, __m128 b) +{ + uint32x4_t a_not_nan = + vceqq_f32(vreinterpretq_f32_m128(a), vreinterpretq_f32_m128(a)); + uint32x4_t b_not_nan = + vceqq_f32(vreinterpretq_f32_m128(b), vreinterpretq_f32_m128(b)); + uint32x4_t a_and_b_not_nan = vandq_u32(a_not_nan, b_not_nan); + uint32x4_t a_lt_b = + vcltq_f32(vreinterpretq_f32_m128(a), vreinterpretq_f32_m128(b)); + return (vgetq_lane_u32(vandq_u32(a_and_b_not_nan, a_lt_b), 0) != 0) ? 1 : 0; +} + +// Compares the lower single-precision floating point scalar values of a and b +// using a greater than operation. : +// https://msdn.microsoft.com/en-us/library/b0738e0t(v=vs.100).aspx +FORCE_INLINE int _mm_comigt_ss(__m128 a, __m128 b) +{ + // return vgetq_lane_u32(vcgtq_f32(vreinterpretq_f32_m128(a), + // vreinterpretq_f32_m128(b)), 0); + uint32x4_t a_not_nan = + vceqq_f32(vreinterpretq_f32_m128(a), vreinterpretq_f32_m128(a)); + uint32x4_t b_not_nan = + vceqq_f32(vreinterpretq_f32_m128(b), vreinterpretq_f32_m128(b)); + uint32x4_t a_and_b_not_nan = vandq_u32(a_not_nan, b_not_nan); + uint32x4_t a_gt_b = + vcgtq_f32(vreinterpretq_f32_m128(a), vreinterpretq_f32_m128(b)); + return (vgetq_lane_u32(vandq_u32(a_and_b_not_nan, a_gt_b), 0) != 0) ? 1 : 0; +} + +// Compares the lower single-precision floating point scalar values of a and b +// using a less than or equal operation. : +// https://msdn.microsoft.com/en-us/library/1w4t7c57(v=vs.90).aspx +FORCE_INLINE int _mm_comile_ss(__m128 a, __m128 b) +{ + // return vgetq_lane_u32(vcleq_f32(vreinterpretq_f32_m128(a), + // vreinterpretq_f32_m128(b)), 0); + uint32x4_t a_not_nan = + vceqq_f32(vreinterpretq_f32_m128(a), vreinterpretq_f32_m128(a)); + uint32x4_t b_not_nan = + vceqq_f32(vreinterpretq_f32_m128(b), vreinterpretq_f32_m128(b)); + uint32x4_t a_and_b_not_nan = vandq_u32(a_not_nan, b_not_nan); + uint32x4_t a_le_b = + vcleq_f32(vreinterpretq_f32_m128(a), vreinterpretq_f32_m128(b)); + return (vgetq_lane_u32(vandq_u32(a_and_b_not_nan, a_le_b), 0) != 0) ? 1 : 0; +} + +// Compares the lower single-precision floating point scalar values of a and b +// using a greater than or equal operation. : +// https://msdn.microsoft.com/en-us/library/8t80des6(v=vs.100).aspx +FORCE_INLINE int _mm_comige_ss(__m128 a, __m128 b) +{ + // return vgetq_lane_u32(vcgeq_f32(vreinterpretq_f32_m128(a), + // vreinterpretq_f32_m128(b)), 0); + uint32x4_t a_not_nan = + vceqq_f32(vreinterpretq_f32_m128(a), vreinterpretq_f32_m128(a)); + uint32x4_t b_not_nan = + vceqq_f32(vreinterpretq_f32_m128(b), vreinterpretq_f32_m128(b)); + uint32x4_t a_and_b_not_nan = vandq_u32(a_not_nan, b_not_nan); + uint32x4_t a_ge_b = + vcgeq_f32(vreinterpretq_f32_m128(a), vreinterpretq_f32_m128(b)); + return (vgetq_lane_u32(vandq_u32(a_and_b_not_nan, a_ge_b), 0) != 0) ? 1 : 0; +} + +// Compares the lower single-precision floating point scalar values of a and b +// using an equality operation. : +// https://msdn.microsoft.com/en-us/library/93yx2h2b(v=vs.100).aspx +FORCE_INLINE int _mm_comieq_ss(__m128 a, __m128 b) +{ + // return vgetq_lane_u32(vceqq_f32(vreinterpretq_f32_m128(a), + // vreinterpretq_f32_m128(b)), 0); + uint32x4_t a_not_nan = + vceqq_f32(vreinterpretq_f32_m128(a), vreinterpretq_f32_m128(a)); + uint32x4_t b_not_nan = + vceqq_f32(vreinterpretq_f32_m128(b), vreinterpretq_f32_m128(b)); + uint32x4_t a_and_b_not_nan = vandq_u32(a_not_nan, b_not_nan); + uint32x4_t a_eq_b = + vceqq_f32(vreinterpretq_f32_m128(a), vreinterpretq_f32_m128(b)); + return (vgetq_lane_u32(vandq_u32(a_and_b_not_nan, a_eq_b), 0) != 0) ? 1 : 0; +} + +// Compares the lower single-precision floating point scalar values of a and b +// using an inequality operation. : +// https://msdn.microsoft.com/en-us/library/bafh5e0a(v=vs.90).aspx +FORCE_INLINE int _mm_comineq_ss(__m128 a, __m128 b) +{ + // return !vgetq_lane_u32(vceqq_f32(vreinterpretq_f32_m128(a), + // vreinterpretq_f32_m128(b)), 0); + uint32x4_t a_not_nan = + vceqq_f32(vreinterpretq_f32_m128(a), vreinterpretq_f32_m128(a)); + uint32x4_t b_not_nan = + vceqq_f32(vreinterpretq_f32_m128(b), vreinterpretq_f32_m128(b)); + uint32x4_t a_or_b_nan = vmvnq_u32(vandq_u32(a_not_nan, b_not_nan)); + uint32x4_t a_neq_b = vmvnq_u32( + vceqq_f32(vreinterpretq_f32_m128(a), vreinterpretq_f32_m128(b))); + return (vgetq_lane_u32(vorrq_u32(a_or_b_nan, a_neq_b), 0) != 0) ? 1 : 0; +} + +// according to the documentation, these intrinsics behave the same as the +// non-'u' versions. We'll just alias them here. +#define _mm_ucomilt_ss _mm_comilt_ss +#define _mm_ucomile_ss _mm_comile_ss +#define _mm_ucomigt_ss _mm_comigt_ss +#define _mm_ucomige_ss _mm_comige_ss +#define _mm_ucomieq_ss _mm_comieq_ss +#define _mm_ucomineq_ss _mm_comineq_ss + +/* Conversions */ + +// Convert packed signed 32-bit integers in b to packed single-precision +// (32-bit) floating-point elements, store the results in the lower 2 elements +// of dst, and copy the upper 2 packed elements from a to the upper elements of +// dst. +// +// dst[31:0] := Convert_Int32_To_FP32(b[31:0]) +// dst[63:32] := Convert_Int32_To_FP32(b[63:32]) +// dst[95:64] := a[95:64] +// dst[127:96] := a[127:96] +// +// https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=_mm_cvt_pi2ps +FORCE_INLINE __m128 _mm_cvt_pi2ps(__m128 a, __m64 b) +{ + return vreinterpretq_m128_f32( + vcombine_f32(vcvt_f32_s32(vreinterpret_s32_m64(b)), + vget_high_f32(vreinterpretq_f32_m128(a)))); +} + +// Convert the signed 32-bit integer b to a single-precision (32-bit) +// floating-point element, store the result in the lower element of dst, and +// copy the upper 3 packed elements from a to the upper elements of dst. +// +// dst[31:0] := Convert_Int32_To_FP32(b[31:0]) +// dst[127:32] := a[127:32] +// +// https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=_mm_cvt_si2ss +FORCE_INLINE __m128 _mm_cvt_si2ss(__m128 a, int b) +{ + return vreinterpretq_m128_f32( + vsetq_lane_f32((float) b, vreinterpretq_f32_m128(a), 0)); +} + +// Convert the signed 32-bit integer b to a single-precision (32-bit) +// floating-point element, store the result in the lower element of dst, and +// copy the upper 3 packed elements from a to the upper elements of dst. +// +// dst[31:0] := Convert_Int32_To_FP32(b[31:0]) +// dst[127:32] := a[127:32] +// +// https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=_mm_cvtsi32_ss +#define _mm_cvtsi32_ss(a, b) _mm_cvt_si2ss(a, b) + +// Convert the signed 64-bit integer b to a single-precision (32-bit) +// floating-point element, store the result in the lower element of dst, and +// copy the upper 3 packed elements from a to the upper elements of dst. +// +// dst[31:0] := Convert_Int64_To_FP32(b[63:0]) +// dst[127:32] := a[127:32] +// +// https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=_mm_cvtsi64_ss +FORCE_INLINE __m128 _mm_cvtsi64_ss(__m128 a, int64_t b) +{ + return vreinterpretq_m128_f32( + vsetq_lane_f32((float) b, vreinterpretq_f32_m128(a), 0)); +} + +// Convert the lower single-precision (32-bit) floating-point element in a to a +// 32-bit integer, and store the result in dst. +// https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=_mm_cvt_ss2si +FORCE_INLINE int _mm_cvt_ss2si(__m128 a) +{ +#if defined(__aarch64__) + return vgetq_lane_s32(vcvtnq_s32_f32(vreinterpretq_f32_m128(a)), 0); +#else + float32_t data = vgetq_lane_f32(vreinterpretq_f32_m128(a), 0); + float32_t diff = data - floor(data); + if (diff > 0.5) + return (int32_t) ceil(data); + if (diff == 0.5) { + int32_t f = (int32_t) floor(data); + int32_t c = (int32_t) ceil(data); + return c & 1 ? f : c; + } + return (int32_t) floor(data); +#endif +} + +// Convert packed 16-bit integers in a to packed single-precision (32-bit) +// floating-point elements, and store the results in dst. +// +// FOR j := 0 to 3 +// i := j*16 +// m := j*32 +// dst[m+31:m] := Convert_Int16_To_FP32(a[i+15:i]) +// ENDFOR +// +// https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=_mm_cvtpi16_ps +FORCE_INLINE __m128 _mm_cvtpi16_ps(__m64 a) +{ + return vreinterpretq_m128_f32( + vcvtq_f32_s32(vmovl_s16(vreinterpret_s16_m64(a)))); +} + +// Convert packed 32-bit integers in b to packed single-precision (32-bit) +// floating-point elements, store the results in the lower 2 elements of dst, +// and copy the upper 2 packed elements from a to the upper elements of dst. +// +// dst[31:0] := Convert_Int32_To_FP32(b[31:0]) +// dst[63:32] := Convert_Int32_To_FP32(b[63:32]) +// dst[95:64] := a[95:64] +// dst[127:96] := a[127:96] +// +// https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=_mm_cvtpi32_ps +FORCE_INLINE __m128 _mm_cvtpi32_ps(__m128 a, __m64 b) +{ + return vreinterpretq_m128_f32( + vcombine_f32(vcvt_f32_s32(vreinterpret_s32_m64(b)), + vget_high_f32(vreinterpretq_f32_m128(a)))); +} + +// Convert packed signed 32-bit integers in a to packed single-precision +// (32-bit) floating-point elements, store the results in the lower 2 elements +// of dst, then covert the packed signed 32-bit integers in b to +// single-precision (32-bit) floating-point element, and store the results in +// the upper 2 elements of dst. +// +// dst[31:0] := Convert_Int32_To_FP32(a[31:0]) +// dst[63:32] := Convert_Int32_To_FP32(a[63:32]) +// dst[95:64] := Convert_Int32_To_FP32(b[31:0]) +// dst[127:96] := Convert_Int32_To_FP32(b[63:32]) +// +// https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=_mm_cvtpi32x2_ps +FORCE_INLINE __m128 _mm_cvtpi32x2_ps(__m64 a, __m64 b) +{ + return vreinterpretq_m128_f32(vcvtq_f32_s32( + vcombine_s32(vreinterpret_s32_m64(a), vreinterpret_s32_m64(b)))); +} + +// Convert the lower packed 8-bit integers in a to packed single-precision +// (32-bit) floating-point elements, and store the results in dst. +// +// FOR j := 0 to 3 +// i := j*8 +// m := j*32 +// dst[m+31:m] := Convert_Int8_To_FP32(a[i+7:i]) +// ENDFOR +// +// https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=_mm_cvtpi8_ps +FORCE_INLINE __m128 _mm_cvtpi8_ps(__m64 a) +{ + return vreinterpretq_m128_f32(vcvtq_f32_s32( + vmovl_s16(vget_low_s16(vmovl_s8(vreinterpret_s8_m64(a)))))); +} + +// Convert packed unsigned 16-bit integers in a to packed single-precision +// (32-bit) floating-point elements, and store the results in dst. +// +// FOR j := 0 to 3 +// i := j*16 +// m := j*32 +// dst[m+31:m] := Convert_UInt16_To_FP32(a[i+15:i]) +// ENDFOR +// +// https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=_mm_cvtpu16_ps +FORCE_INLINE __m128 _mm_cvtpu16_ps(__m64 a) +{ + return vreinterpretq_m128_f32( + vcvtq_f32_u32(vmovl_u16(vreinterpret_u16_m64(a)))); +} + +// Convert the lower packed unsigned 8-bit integers in a to packed +// single-precision (32-bit) floating-point elements, and store the results in +// dst. +// +// FOR j := 0 to 3 +// i := j*8 +// m := j*32 +// dst[m+31:m] := Convert_UInt8_To_FP32(a[i+7:i]) +// ENDFOR +// +// https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=_mm_cvtpu8_ps +FORCE_INLINE __m128 _mm_cvtpu8_ps(__m64 a) +{ + return vreinterpretq_m128_f32(vcvtq_f32_u32( + vmovl_u16(vget_low_u16(vmovl_u8(vreinterpret_u8_m64(a)))))); +} + +// Converts the four single-precision, floating-point values of a to signed +// 32-bit integer values using truncate. +// https://msdn.microsoft.com/en-us/library/vstudio/1h005y6x(v=vs.100).aspx +FORCE_INLINE __m128i _mm_cvttps_epi32(__m128 a) +{ + return vreinterpretq_m128i_s32(vcvtq_s32_f32(vreinterpretq_f32_m128(a))); +} + +// Convert the lower double-precision (64-bit) floating-point element in a to a +// 64-bit integer with truncation, and store the result in dst. +// +// dst[63:0] := Convert_FP64_To_Int64_Truncate(a[63:0]) +// +// https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=_mm_cvttsd_si64 +FORCE_INLINE int64_t _mm_cvttsd_si64(__m128d a) +{ +#if defined(__aarch64__) + return vgetq_lane_s64(vcvtq_s64_f64(vreinterpretq_f64_m128d(a)), 0); +#else + double ret = *((double *) &a); + return (int64_t) ret; +#endif +} + +// Convert the lower double-precision (64-bit) floating-point element in a to a +// 64-bit integer with truncation, and store the result in dst. +// +// dst[63:0] := Convert_FP64_To_Int64_Truncate(a[63:0]) +// +// https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=_mm_cvttsd_si64x +#define _mm_cvttsd_si64x(a) _mm_cvttsd_si64(a) + +// Converts the four signed 32-bit integer values of a to single-precision, +// floating-point values +// https://msdn.microsoft.com/en-us/library/vstudio/36bwxcx5(v=vs.100).aspx +FORCE_INLINE __m128 _mm_cvtepi32_ps(__m128i a) +{ + return vreinterpretq_m128_f32(vcvtq_f32_s32(vreinterpretq_s32_m128i(a))); +} + +// Converts the four unsigned 8-bit integers in the lower 16 bits to four +// unsigned 32-bit integers. +FORCE_INLINE __m128i _mm_cvtepu8_epi16(__m128i a) +{ + uint8x16_t u8x16 = vreinterpretq_u8_m128i(a); /* xxxx xxxx xxxx DCBA */ + uint16x8_t u16x8 = vmovl_u8(vget_low_u8(u8x16)); /* 0x0x 0x0x 0D0C 0B0A */ + return vreinterpretq_m128i_u16(u16x8); +} + +// Converts the four unsigned 8-bit integers in the lower 32 bits to four +// unsigned 32-bit integers. +// https://msdn.microsoft.com/en-us/library/bb531467%28v=vs.100%29.aspx +FORCE_INLINE __m128i _mm_cvtepu8_epi32(__m128i a) +{ + uint8x16_t u8x16 = vreinterpretq_u8_m128i(a); /* xxxx xxxx xxxx DCBA */ + uint16x8_t u16x8 = vmovl_u8(vget_low_u8(u8x16)); /* 0x0x 0x0x 0D0C 0B0A */ + uint32x4_t u32x4 = vmovl_u16(vget_low_u16(u16x8)); /* 000D 000C 000B 000A */ + return vreinterpretq_m128i_u32(u32x4); +} + +// Converts the two unsigned 8-bit integers in the lower 16 bits to two +// unsigned 64-bit integers. +FORCE_INLINE __m128i _mm_cvtepu8_epi64(__m128i a) +{ + uint8x16_t u8x16 = vreinterpretq_u8_m128i(a); /* xxxx xxxx xxxx xxBA */ + uint16x8_t u16x8 = vmovl_u8(vget_low_u8(u8x16)); /* 0x0x 0x0x 0x0x 0B0A */ + uint32x4_t u32x4 = vmovl_u16(vget_low_u16(u16x8)); /* 000x 000x 000B 000A */ + uint64x2_t u64x2 = vmovl_u32(vget_low_u32(u32x4)); /* 0000 000B 0000 000A */ + return vreinterpretq_m128i_u64(u64x2); +} + +// Converts the four unsigned 8-bit integers in the lower 16 bits to four +// unsigned 32-bit integers. +FORCE_INLINE __m128i _mm_cvtepi8_epi16(__m128i a) +{ + int8x16_t s8x16 = vreinterpretq_s8_m128i(a); /* xxxx xxxx xxxx DCBA */ + int16x8_t s16x8 = vmovl_s8(vget_low_s8(s8x16)); /* 0x0x 0x0x 0D0C 0B0A */ + return vreinterpretq_m128i_s16(s16x8); +} + +// Converts the four unsigned 8-bit integers in the lower 32 bits to four +// unsigned 32-bit integers. +FORCE_INLINE __m128i _mm_cvtepi8_epi32(__m128i a) +{ + int8x16_t s8x16 = vreinterpretq_s8_m128i(a); /* xxxx xxxx xxxx DCBA */ + int16x8_t s16x8 = vmovl_s8(vget_low_s8(s8x16)); /* 0x0x 0x0x 0D0C 0B0A */ + int32x4_t s32x4 = vmovl_s16(vget_low_s16(s16x8)); /* 000D 000C 000B 000A */ + return vreinterpretq_m128i_s32(s32x4); +} + +// Converts the two signed 8-bit integers in the lower 32 bits to four +// signed 64-bit integers. +FORCE_INLINE __m128i _mm_cvtepi8_epi64(__m128i a) +{ + int8x16_t s8x16 = vreinterpretq_s8_m128i(a); /* xxxx xxxx xxxx xxBA */ + int16x8_t s16x8 = vmovl_s8(vget_low_s8(s8x16)); /* 0x0x 0x0x 0x0x 0B0A */ + int32x4_t s32x4 = vmovl_s16(vget_low_s16(s16x8)); /* 000x 000x 000B 000A */ + int64x2_t s64x2 = vmovl_s32(vget_low_s32(s32x4)); /* 0000 000B 0000 000A */ + return vreinterpretq_m128i_s64(s64x2); +} + +// Converts the four signed 16-bit integers in the lower 64 bits to four signed +// 32-bit integers. +FORCE_INLINE __m128i _mm_cvtepi16_epi32(__m128i a) +{ + return vreinterpretq_m128i_s32( + vmovl_s16(vget_low_s16(vreinterpretq_s16_m128i(a)))); +} + +// Converts the two signed 16-bit integers in the lower 32 bits two signed +// 32-bit integers. +FORCE_INLINE __m128i _mm_cvtepi16_epi64(__m128i a) +{ + int16x8_t s16x8 = vreinterpretq_s16_m128i(a); /* xxxx xxxx xxxx 0B0A */ + int32x4_t s32x4 = vmovl_s16(vget_low_s16(s16x8)); /* 000x 000x 000B 000A */ + int64x2_t s64x2 = vmovl_s32(vget_low_s32(s32x4)); /* 0000 000B 0000 000A */ + return vreinterpretq_m128i_s64(s64x2); +} + +// Converts the four unsigned 16-bit integers in the lower 64 bits to four +// unsigned 32-bit integers. +FORCE_INLINE __m128i _mm_cvtepu16_epi32(__m128i a) +{ + return vreinterpretq_m128i_u32( + vmovl_u16(vget_low_u16(vreinterpretq_u16_m128i(a)))); +} + +// Converts the two unsigned 16-bit integers in the lower 32 bits to two +// unsigned 64-bit integers. +FORCE_INLINE __m128i _mm_cvtepu16_epi64(__m128i a) +{ + uint16x8_t u16x8 = vreinterpretq_u16_m128i(a); /* xxxx xxxx xxxx 0B0A */ + uint32x4_t u32x4 = vmovl_u16(vget_low_u16(u16x8)); /* 000x 000x 000B 000A */ + uint64x2_t u64x2 = vmovl_u32(vget_low_u32(u32x4)); /* 0000 000B 0000 000A */ + return vreinterpretq_m128i_u64(u64x2); +} + +// Converts the two unsigned 32-bit integers in the lower 64 bits to two +// unsigned 64-bit integers. +FORCE_INLINE __m128i _mm_cvtepu32_epi64(__m128i a) +{ + return vreinterpretq_m128i_u64( + vmovl_u32(vget_low_u32(vreinterpretq_u32_m128i(a)))); +} + +// Converts the two signed 32-bit integers in the lower 64 bits to two signed +// 64-bit integers. +FORCE_INLINE __m128i _mm_cvtepi32_epi64(__m128i a) +{ + return vreinterpretq_m128i_s64( + vmovl_s32(vget_low_s32(vreinterpretq_s32_m128i(a)))); +} + +// Converts the four single-precision, floating-point values of a to signed +// 32-bit integer values. +// +// r0 := (int) a0 +// r1 := (int) a1 +// r2 := (int) a2 +// r3 := (int) a3 +// +// https://msdn.microsoft.com/en-us/library/vstudio/xdc42k5e(v=vs.100).aspx +// *NOTE*. The default rounding mode on SSE is 'round to even', which ARMv7-A +// does not support! It is supported on ARMv8-A however. +FORCE_INLINE __m128i _mm_cvtps_epi32(__m128 a) +{ +#if defined(__aarch64__) + return vreinterpretq_m128i_s32(vcvtnq_s32_f32(a)); +#else + uint32x4_t signmask = vdupq_n_u32(0x80000000); + float32x4_t half = vbslq_f32(signmask, vreinterpretq_f32_m128(a), + vdupq_n_f32(0.5f)); /* +/- 0.5 */ + int32x4_t r_normal = vcvtq_s32_f32(vaddq_f32( + vreinterpretq_f32_m128(a), half)); /* round to integer: [a + 0.5]*/ + int32x4_t r_trunc = + vcvtq_s32_f32(vreinterpretq_f32_m128(a)); /* truncate to integer: [a] */ + int32x4_t plusone = vreinterpretq_s32_u32(vshrq_n_u32( + vreinterpretq_u32_s32(vnegq_s32(r_trunc)), 31)); /* 1 or 0 */ + int32x4_t r_even = vbicq_s32(vaddq_s32(r_trunc, plusone), + vdupq_n_s32(1)); /* ([a] + {0,1}) & ~1 */ + float32x4_t delta = vsubq_f32( + vreinterpretq_f32_m128(a), + vcvtq_f32_s32(r_trunc)); /* compute delta: delta = (a - [a]) */ + uint32x4_t is_delta_half = vceqq_f32(delta, half); /* delta == +/- 0.5 */ + return vreinterpretq_m128i_s32(vbslq_s32(is_delta_half, r_even, r_normal)); +#endif +} + +// Copy the lower 32-bit integer in a to dst. +// +// dst[31:0] := a[31:0] +// +// https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=_mm_cvtsi128_si32 +FORCE_INLINE int _mm_cvtsi128_si32(__m128i a) +{ + return vgetq_lane_s32(vreinterpretq_s32_m128i(a), 0); +} + +// Copy the lower 64-bit integer in a to dst. +// +// dst[63:0] := a[63:0] +// +// https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=_mm_cvtsi128_si64 +FORCE_INLINE int64_t _mm_cvtsi128_si64(__m128i a) +{ + return vgetq_lane_s64(vreinterpretq_s64_m128i(a), 0); +} + +// Copy the lower 64-bit integer in a to dst. +// +// dst[63:0] := a[63:0] +// +// https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=_mm_cvtsi128_si64x +#define _mm_cvtsi128_si64x(a) _mm_cvtsi128_si64(a) + +// Moves 32-bit integer a to the least significant 32 bits of an __m128 object, +// zero extending the upper bits. +// +// r0 := a +// r1 := 0x0 +// r2 := 0x0 +// r3 := 0x0 +// +// https://msdn.microsoft.com/en-us/library/ct3539ha%28v=vs.90%29.aspx +FORCE_INLINE __m128i _mm_cvtsi32_si128(int a) +{ + return vreinterpretq_m128i_s32(vsetq_lane_s32(a, vdupq_n_s32(0), 0)); +} + +// Moves 64-bit integer a to the least significant 64 bits of an __m128 object, +// zero extending the upper bits. +// +// r0 := a +// r1 := 0x0 +FORCE_INLINE __m128i _mm_cvtsi64_si128(int64_t a) +{ + return vreinterpretq_m128i_s64(vsetq_lane_s64(a, vdupq_n_s64(0), 0)); +} + +// Cast vector of type __m128 to type __m128d. This intrinsic is only used for +// compilation and does not generate any instructions, thus it has zero latency. +// https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=_mm_castps_pd +FORCE_INLINE __m128d _mm_castps_pd(__m128 a) +{ + return vreinterpretq_m128d_s32(vreinterpretq_s32_m128(a)); +} + +// Applies a type cast to reinterpret four 32-bit floating point values passed +// in as a 128-bit parameter as packed 32-bit integers. +// https://msdn.microsoft.com/en-us/library/bb514099.aspx +FORCE_INLINE __m128i _mm_castps_si128(__m128 a) +{ + return vreinterpretq_m128i_s32(vreinterpretq_s32_m128(a)); +} + +// Applies a type cast to reinterpret four 32-bit integers passed in as a +// 128-bit parameter as packed 32-bit floating point values. +// https://msdn.microsoft.com/en-us/library/bb514029.aspx +FORCE_INLINE __m128 _mm_castsi128_ps(__m128i a) +{ + return vreinterpretq_m128_s32(vreinterpretq_s32_m128i(a)); +} + +// Loads 128-bit value. : +// https://msdn.microsoft.com/en-us/library/atzzad1h(v=vs.80).aspx +FORCE_INLINE __m128i _mm_load_si128(const __m128i *p) +{ + return vreinterpretq_m128i_s32(vld1q_s32((const int32_t *) p)); +} + +// Load a double-precision (64-bit) floating-point element from memory into both +// elements of dst. +// +// dst[63:0] := MEM[mem_addr+63:mem_addr] +// dst[127:64] := MEM[mem_addr+63:mem_addr] +// +// https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=_mm_load1_pd +FORCE_INLINE __m128d _mm_load1_pd(const double *p) +{ +#if defined(__aarch64__) + return vreinterpretq_m128d_f64(vld1q_dup_f64(p)); +#else + return vreinterpretq_m128d_s64(vdupq_n_s64(*(const int64_t *) p)); +#endif +} + +// Load a double-precision (64-bit) floating-point element from memory into the +// upper element of dst, and copy the lower element from a to dst. mem_addr does +// not need to be aligned on any particular boundary. +// +// dst[63:0] := a[63:0] +// dst[127:64] := MEM[mem_addr+63:mem_addr] +// +// https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=_mm_loadh_pd +FORCE_INLINE __m128d _mm_loadh_pd(__m128d a, const double *p) +{ +#if defined(__aarch64__) + return vreinterpretq_m128d_f64( + vcombine_f64(vget_low_f64(vreinterpretq_f64_m128d(a)), vld1_f64(p))); +#else + return vreinterpretq_m128d_f32(vcombine_f32( + vget_low_f32(vreinterpretq_f32_m128d(a)), vld1_f32((const float *) p))); +#endif +} + +// Load a double-precision (64-bit) floating-point element from memory into both +// elements of dst. +// +// dst[63:0] := MEM[mem_addr+63:mem_addr] +// dst[127:64] := MEM[mem_addr+63:mem_addr] +// +// https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=_mm_load_pd1 +#define _mm_load_pd1 _mm_load1_pd + +// Load a double-precision (64-bit) floating-point element from memory into both +// elements of dst. +// +// dst[63:0] := MEM[mem_addr+63:mem_addr] +// dst[127:64] := MEM[mem_addr+63:mem_addr] +// +// https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=_mm_loaddup_pd +#define _mm_loaddup_pd _mm_load1_pd + +// Loads 128-bit value. : +// https://msdn.microsoft.com/zh-cn/library/f4k12ae8(v=vs.90).aspx +FORCE_INLINE __m128i _mm_loadu_si128(const __m128i *p) +{ + return vreinterpretq_m128i_s32(vld1q_s32((const int32_t *) p)); +} + +// Load unaligned 32-bit integer from memory into the first element of dst. +// +// dst[31:0] := MEM[mem_addr+31:mem_addr] +// dst[MAX:32] := 0 +// +// https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=_mm_loadu_si32 +FORCE_INLINE __m128i _mm_loadu_si32(const void *p) +{ + return vreinterpretq_m128i_s32( + vsetq_lane_s32(*(const int32_t *) p, vdupq_n_s32(0), 0)); +} + +// Convert packed double-precision (64-bit) floating-point elements in a to +// packed single-precision (32-bit) floating-point elements, and store the +// results in dst. +// +// FOR j := 0 to 1 +// i := 32*j +// k := 64*j +// dst[i+31:i] := Convert_FP64_To_FP32(a[k+64:k]) +// ENDFOR +// dst[127:64] := 0 +// +// https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=_mm_cvtpd_ps +FORCE_INLINE __m128 _mm_cvtpd_ps(__m128d a) +{ +#if defined(__aarch64__) + float32x2_t tmp = vcvt_f32_f64(vreinterpretq_f64_m128d(a)); + return vreinterpretq_m128_f32(vcombine_f32(tmp, vdup_n_f32(0))); +#else + float a0 = (float) ((double *) &a)[0]; + float a1 = (float) ((double *) &a)[1]; + return _mm_set_ps(0, 0, a1, a0); +#endif +} + +// Copy the lower double-precision (64-bit) floating-point element of a to dst. +// +// dst[63:0] := a[63:0] +// +// https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=_mm_cvtsd_f64 +FORCE_INLINE double _mm_cvtsd_f64(__m128d a) +{ +#if defined(__aarch64__) + return (double) vgetq_lane_f64(vreinterpretq_f64_m128d(a), 0); +#else + return ((double *) &a)[0]; +#endif +} + +// Convert packed single-precision (32-bit) floating-point elements in a to +// packed double-precision (64-bit) floating-point elements, and store the +// results in dst. +// +// FOR j := 0 to 1 +// i := 64*j +// k := 32*j +// dst[i+63:i] := Convert_FP32_To_FP64(a[k+31:k]) +// ENDFOR +// +// https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=_mm_cvtps_pd +FORCE_INLINE __m128d _mm_cvtps_pd(__m128 a) +{ +#if defined(__aarch64__) + return vreinterpretq_m128d_f64( + vcvt_f64_f32(vget_low_f32(vreinterpretq_f32_m128(a)))); +#else + double a0 = (double) vgetq_lane_f32(vreinterpretq_f32_m128(a), 0); + double a1 = (double) vgetq_lane_f32(vreinterpretq_f32_m128(a), 1); + return _mm_set_pd(a1, a0); +#endif +} + +// Cast vector of type __m128d to type __m128i. This intrinsic is only used for +// compilation and does not generate any instructions, thus it has zero latency. +// https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=_mm_castpd_si128 +FORCE_INLINE __m128i _mm_castpd_si128(__m128d a) +{ + return vreinterpretq_m128i_s64(vreinterpretq_s64_m128d(a)); +} + +// Blend packed single-precision (32-bit) floating-point elements from a and b +// using mask, and store the results in dst. +// https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=_mm_blendv_ps +FORCE_INLINE __m128 _mm_blendv_ps(__m128 a, __m128 b, __m128 mask) +{ + return vreinterpretq_m128_f32(vbslq_f32(vreinterpretq_u32_m128(mask), + vreinterpretq_f32_m128(b), + vreinterpretq_f32_m128(a))); +} + +// Round the packed single-precision (32-bit) floating-point elements in a using +// the rounding parameter, and store the results as packed single-precision +// floating-point elements in dst. +// software.intel.com/sites/landingpage/IntrinsicsGuide/#text=_mm_round_ps +FORCE_INLINE __m128 _mm_round_ps(__m128 a, int rounding) +{ +#if defined(__aarch64__) + switch (rounding) { + case (_MM_FROUND_TO_NEAREST_INT | _MM_FROUND_NO_EXC): + return vreinterpretq_m128_f32(vrndnq_f32(vreinterpretq_f32_m128(a))); + case (_MM_FROUND_TO_NEG_INF | _MM_FROUND_NO_EXC): + return vreinterpretq_m128_f32(vrndmq_f32(vreinterpretq_f32_m128(a))); + case (_MM_FROUND_TO_POS_INF | _MM_FROUND_NO_EXC): + return vreinterpretq_m128_f32(vrndpq_f32(vreinterpretq_f32_m128(a))); + case (_MM_FROUND_TO_ZERO | _MM_FROUND_NO_EXC): + return vreinterpretq_m128_f32(vrndq_f32(vreinterpretq_f32_m128(a))); + default: //_MM_FROUND_CUR_DIRECTION + return vreinterpretq_m128_f32(vrndiq_f32(vreinterpretq_f32_m128(a))); + } +#else + float *v_float = (float *) &a; + __m128 zero, neg_inf, pos_inf; + + switch (rounding) { + case (_MM_FROUND_TO_NEAREST_INT | _MM_FROUND_NO_EXC): + return _mm_cvtepi32_ps(_mm_cvtps_epi32(a)); + case (_MM_FROUND_TO_NEG_INF | _MM_FROUND_NO_EXC): + return (__m128){floorf(v_float[0]), floorf(v_float[1]), + floorf(v_float[2]), floorf(v_float[3])}; + case (_MM_FROUND_TO_POS_INF | _MM_FROUND_NO_EXC): + return (__m128){ceilf(v_float[0]), ceilf(v_float[1]), ceilf(v_float[2]), + ceilf(v_float[3])}; + case (_MM_FROUND_TO_ZERO | _MM_FROUND_NO_EXC): + zero = _mm_set_ps(0.0f, 0.0f, 0.0f, 0.0f); + neg_inf = _mm_set_ps(floorf(v_float[0]), floorf(v_float[1]), + floorf(v_float[2]), floorf(v_float[3])); + pos_inf = _mm_set_ps(ceilf(v_float[0]), ceilf(v_float[1]), + ceilf(v_float[2]), ceilf(v_float[3])); + return _mm_blendv_ps(pos_inf, neg_inf, _mm_cmple_ps(a, zero)); + default: //_MM_FROUND_CUR_DIRECTION + return (__m128){roundf(v_float[0]), roundf(v_float[1]), + roundf(v_float[2]), roundf(v_float[3])}; + } +#endif +} + +// Convert packed single-precision (32-bit) floating-point elements in a to +// packed 32-bit integers, and store the results in dst. +// +// FOR j := 0 to 1 +// i := 32*j +// dst[i+31:i] := Convert_FP32_To_Int32(a[i+31:i]) +// ENDFOR +// +// https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=_mm_cvt_ps2pi +FORCE_INLINE __m64 _mm_cvt_ps2pi(__m128 a) +{ +#if defined(__aarch64__) + return vreinterpret_m64_s32( + vget_low_s32(vcvtnq_s32_f32(vreinterpretq_f32_m128(a)))); +#else + return vreinterpret_m64_s32( + vcvt_s32_f32(vget_low_f32(vreinterpretq_f32_m128( + _mm_round_ps(a, _MM_FROUND_TO_NEAREST_INT | _MM_FROUND_NO_EXC))))); +#endif +} + +// Round the packed single-precision (32-bit) floating-point elements in a up to +// an integer value, and store the results as packed single-precision +// floating-point elements in dst. +// https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=_mm_ceil_ps +FORCE_INLINE __m128 _mm_ceil_ps(__m128 a) +{ + return _mm_round_ps(a, _MM_FROUND_TO_POS_INF | _MM_FROUND_NO_EXC); +} + +// Round the packed single-precision (32-bit) floating-point elements in a down +// to an integer value, and store the results as packed single-precision +// floating-point elements in dst. +// https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=_mm_floor_ps +FORCE_INLINE __m128 _mm_floor_ps(__m128 a) +{ + return _mm_round_ps(a, _MM_FROUND_TO_NEG_INF | _MM_FROUND_NO_EXC); +} + + +// Load 128-bits of integer data from unaligned memory into dst. This intrinsic +// may perform better than _mm_loadu_si128 when the data crosses a cache line +// boundary. +// +// dst[127:0] := MEM[mem_addr+127:mem_addr] +// +// https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=_mm_lddqu_si128 +#define _mm_lddqu_si128 _mm_loadu_si128 + +/* Miscellaneous Operations */ + +// Shifts the 8 signed 16-bit integers in a right by count bits while shifting +// in the sign bit. +// +// r0 := a0 >> count +// r1 := a1 >> count +// ... +// r7 := a7 >> count +// +// https://msdn.microsoft.com/en-us/library/3c9997dk(v%3dvs.90).aspx +FORCE_INLINE __m128i _mm_sra_epi16(__m128i a, __m128i count) +{ + int64_t c = (int64_t) vget_low_s64((int64x2_t) count); + if (c > 15) + return _mm_cmplt_epi16(a, _mm_setzero_si128()); + return vreinterpretq_m128i_s16(vshlq_s16((int16x8_t) a, vdupq_n_s16(-c))); +} + +// Shifts the 4 signed 32-bit integers in a right by count bits while shifting +// in the sign bit. +// +// r0 := a0 >> count +// r1 := a1 >> count +// r2 := a2 >> count +// r3 := a3 >> count +// +// https://msdn.microsoft.com/en-us/library/ce40009e(v%3dvs.100).aspx +FORCE_INLINE __m128i _mm_sra_epi32(__m128i a, __m128i count) +{ + int64_t c = (int64_t) vget_low_s64((int64x2_t) count); + if (c > 31) + return _mm_cmplt_epi32(a, _mm_setzero_si128()); + return vreinterpretq_m128i_s32(vshlq_s32((int32x4_t) a, vdupq_n_s32(-c))); +} + +// Packs the 16 signed 16-bit integers from a and b into 8-bit integers and +// saturates. +// https://msdn.microsoft.com/en-us/library/k4y4f7w5%28v=vs.90%29.aspx +FORCE_INLINE __m128i _mm_packs_epi16(__m128i a, __m128i b) +{ + return vreinterpretq_m128i_s8( + vcombine_s8(vqmovn_s16(vreinterpretq_s16_m128i(a)), + vqmovn_s16(vreinterpretq_s16_m128i(b)))); +} + +// Packs the 16 signed 16 - bit integers from a and b into 8 - bit unsigned +// integers and saturates. +// +// r0 := UnsignedSaturate(a0) +// r1 := UnsignedSaturate(a1) +// ... +// r7 := UnsignedSaturate(a7) +// r8 := UnsignedSaturate(b0) +// r9 := UnsignedSaturate(b1) +// ... +// r15 := UnsignedSaturate(b7) +// +// https://msdn.microsoft.com/en-us/library/07ad1wx4(v=vs.100).aspx +FORCE_INLINE __m128i _mm_packus_epi16(const __m128i a, const __m128i b) +{ + return vreinterpretq_m128i_u8( + vcombine_u8(vqmovun_s16(vreinterpretq_s16_m128i(a)), + vqmovun_s16(vreinterpretq_s16_m128i(b)))); +} + +// Packs the 8 signed 32-bit integers from a and b into signed 16-bit integers +// and saturates. +// +// r0 := SignedSaturate(a0) +// r1 := SignedSaturate(a1) +// r2 := SignedSaturate(a2) +// r3 := SignedSaturate(a3) +// r4 := SignedSaturate(b0) +// r5 := SignedSaturate(b1) +// r6 := SignedSaturate(b2) +// r7 := SignedSaturate(b3) +// +// https://msdn.microsoft.com/en-us/library/393t56f9%28v=vs.90%29.aspx +FORCE_INLINE __m128i _mm_packs_epi32(__m128i a, __m128i b) +{ + return vreinterpretq_m128i_s16( + vcombine_s16(vqmovn_s32(vreinterpretq_s32_m128i(a)), + vqmovn_s32(vreinterpretq_s32_m128i(b)))); +} + +// Packs the 8 unsigned 32-bit integers from a and b into unsigned 16-bit +// integers and saturates. +// +// r0 := UnsignedSaturate(a0) +// r1 := UnsignedSaturate(a1) +// r2 := UnsignedSaturate(a2) +// r3 := UnsignedSaturate(a3) +// r4 := UnsignedSaturate(b0) +// r5 := UnsignedSaturate(b1) +// r6 := UnsignedSaturate(b2) +// r7 := UnsignedSaturate(b3) +FORCE_INLINE __m128i _mm_packus_epi32(__m128i a, __m128i b) +{ + return vreinterpretq_m128i_u16( + vcombine_u16(vqmovun_s32(vreinterpretq_s32_m128i(a)), + vqmovun_s32(vreinterpretq_s32_m128i(b)))); +} + +// Interleaves the lower 8 signed or unsigned 8-bit integers in a with the lower +// 8 signed or unsigned 8-bit integers in b. +// +// r0 := a0 +// r1 := b0 +// r2 := a1 +// r3 := b1 +// ... +// r14 := a7 +// r15 := b7 +// +// https://msdn.microsoft.com/en-us/library/xf7k860c%28v=vs.90%29.aspx +FORCE_INLINE __m128i _mm_unpacklo_epi8(__m128i a, __m128i b) +{ +#if defined(__aarch64__) + return vreinterpretq_m128i_s8( + vzip1q_s8(vreinterpretq_s8_m128i(a), vreinterpretq_s8_m128i(b))); +#else + int8x8_t a1 = vreinterpret_s8_s16(vget_low_s16(vreinterpretq_s16_m128i(a))); + int8x8_t b1 = vreinterpret_s8_s16(vget_low_s16(vreinterpretq_s16_m128i(b))); + int8x8x2_t result = vzip_s8(a1, b1); + return vreinterpretq_m128i_s8(vcombine_s8(result.val[0], result.val[1])); +#endif +} + +// Interleaves the lower 4 signed or unsigned 16-bit integers in a with the +// lower 4 signed or unsigned 16-bit integers in b. +// +// r0 := a0 +// r1 := b0 +// r2 := a1 +// r3 := b1 +// r4 := a2 +// r5 := b2 +// r6 := a3 +// r7 := b3 +// +// https://msdn.microsoft.com/en-us/library/btxb17bw%28v=vs.90%29.aspx +FORCE_INLINE __m128i _mm_unpacklo_epi16(__m128i a, __m128i b) +{ +#if defined(__aarch64__) + return vreinterpretq_m128i_s16( + vzip1q_s16(vreinterpretq_s16_m128i(a), vreinterpretq_s16_m128i(b))); +#else + int16x4_t a1 = vget_low_s16(vreinterpretq_s16_m128i(a)); + int16x4_t b1 = vget_low_s16(vreinterpretq_s16_m128i(b)); + int16x4x2_t result = vzip_s16(a1, b1); + return vreinterpretq_m128i_s16(vcombine_s16(result.val[0], result.val[1])); +#endif +} + +// Interleaves the lower 2 signed or unsigned 32 - bit integers in a with the +// lower 2 signed or unsigned 32 - bit integers in b. +// +// r0 := a0 +// r1 := b0 +// r2 := a1 +// r3 := b1 +// +// https://msdn.microsoft.com/en-us/library/x8atst9d(v=vs.100).aspx +FORCE_INLINE __m128i _mm_unpacklo_epi32(__m128i a, __m128i b) +{ +#if defined(__aarch64__) + return vreinterpretq_m128i_s32( + vzip1q_s32(vreinterpretq_s32_m128i(a), vreinterpretq_s32_m128i(b))); +#else + int32x2_t a1 = vget_low_s32(vreinterpretq_s32_m128i(a)); + int32x2_t b1 = vget_low_s32(vreinterpretq_s32_m128i(b)); + int32x2x2_t result = vzip_s32(a1, b1); + return vreinterpretq_m128i_s32(vcombine_s32(result.val[0], result.val[1])); +#endif +} + +FORCE_INLINE __m128i _mm_unpacklo_epi64(__m128i a, __m128i b) +{ + int64x1_t a_l = vget_low_s64(vreinterpretq_s64_m128i(a)); + int64x1_t b_l = vget_low_s64(vreinterpretq_s64_m128i(b)); + return vreinterpretq_m128i_s64(vcombine_s64(a_l, b_l)); +} + +// Selects and interleaves the lower two single-precision, floating-point values +// from a and b. +// +// r0 := a0 +// r1 := b0 +// r2 := a1 +// r3 := b1 +// +// https://msdn.microsoft.com/en-us/library/25st103b%28v=vs.90%29.aspx +FORCE_INLINE __m128 _mm_unpacklo_ps(__m128 a, __m128 b) +{ +#if defined(__aarch64__) + return vreinterpretq_m128_f32( + vzip1q_f32(vreinterpretq_f32_m128(a), vreinterpretq_f32_m128(b))); +#else + float32x2_t a1 = vget_low_f32(vreinterpretq_f32_m128(a)); + float32x2_t b1 = vget_low_f32(vreinterpretq_f32_m128(b)); + float32x2x2_t result = vzip_f32(a1, b1); + return vreinterpretq_m128_f32(vcombine_f32(result.val[0], result.val[1])); +#endif +} + +// Selects and interleaves the upper two single-precision, floating-point values +// from a and b. +// +// r0 := a2 +// r1 := b2 +// r2 := a3 +// r3 := b3 +// +// https://msdn.microsoft.com/en-us/library/skccxx7d%28v=vs.90%29.aspx +FORCE_INLINE __m128 _mm_unpackhi_ps(__m128 a, __m128 b) +{ +#if defined(__aarch64__) + return vreinterpretq_m128_f32( + vzip2q_f32(vreinterpretq_f32_m128(a), vreinterpretq_f32_m128(b))); +#else + float32x2_t a1 = vget_high_f32(vreinterpretq_f32_m128(a)); + float32x2_t b1 = vget_high_f32(vreinterpretq_f32_m128(b)); + float32x2x2_t result = vzip_f32(a1, b1); + return vreinterpretq_m128_f32(vcombine_f32(result.val[0], result.val[1])); +#endif +} + +// Interleaves the upper 8 signed or unsigned 8-bit integers in a with the upper +// 8 signed or unsigned 8-bit integers in b. +// +// r0 := a8 +// r1 := b8 +// r2 := a9 +// r3 := b9 +// ... +// r14 := a15 +// r15 := b15 +// +// https://msdn.microsoft.com/en-us/library/t5h7783k(v=vs.100).aspx +FORCE_INLINE __m128i _mm_unpackhi_epi8(__m128i a, __m128i b) +{ +#if defined(__aarch64__) + return vreinterpretq_m128i_s8( + vzip2q_s8(vreinterpretq_s8_m128i(a), vreinterpretq_s8_m128i(b))); +#else + int8x8_t a1 = + vreinterpret_s8_s16(vget_high_s16(vreinterpretq_s16_m128i(a))); + int8x8_t b1 = + vreinterpret_s8_s16(vget_high_s16(vreinterpretq_s16_m128i(b))); + int8x8x2_t result = vzip_s8(a1, b1); + return vreinterpretq_m128i_s8(vcombine_s8(result.val[0], result.val[1])); +#endif +} + +// Interleaves the upper 4 signed or unsigned 16-bit integers in a with the +// upper 4 signed or unsigned 16-bit integers in b. +// +// r0 := a4 +// r1 := b4 +// r2 := a5 +// r3 := b5 +// r4 := a6 +// r5 := b6 +// r6 := a7 +// r7 := b7 +// +// https://msdn.microsoft.com/en-us/library/03196cz7(v=vs.100).aspx +FORCE_INLINE __m128i _mm_unpackhi_epi16(__m128i a, __m128i b) +{ +#if defined(__aarch64__) + return vreinterpretq_m128i_s16( + vzip2q_s16(vreinterpretq_s16_m128i(a), vreinterpretq_s16_m128i(b))); +#else + int16x4_t a1 = vget_high_s16(vreinterpretq_s16_m128i(a)); + int16x4_t b1 = vget_high_s16(vreinterpretq_s16_m128i(b)); + int16x4x2_t result = vzip_s16(a1, b1); + return vreinterpretq_m128i_s16(vcombine_s16(result.val[0], result.val[1])); +#endif +} + +// Interleaves the upper 2 signed or unsigned 32-bit integers in a with the +// upper 2 signed or unsigned 32-bit integers in b. +// https://msdn.microsoft.com/en-us/library/65sa7cbs(v=vs.100).aspx +FORCE_INLINE __m128i _mm_unpackhi_epi32(__m128i a, __m128i b) +{ +#if defined(__aarch64__) + return vreinterpretq_m128i_s32( + vzip2q_s32(vreinterpretq_s32_m128i(a), vreinterpretq_s32_m128i(b))); +#else + int32x2_t a1 = vget_high_s32(vreinterpretq_s32_m128i(a)); + int32x2_t b1 = vget_high_s32(vreinterpretq_s32_m128i(b)); + int32x2x2_t result = vzip_s32(a1, b1); + return vreinterpretq_m128i_s32(vcombine_s32(result.val[0], result.val[1])); +#endif +} + +// Interleaves the upper signed or unsigned 64-bit integer in a with the +// upper signed or unsigned 64-bit integer in b. +// +// r0 := a1 +// r1 := b1 +FORCE_INLINE __m128i _mm_unpackhi_epi64(__m128i a, __m128i b) +{ + int64x1_t a_h = vget_high_s64(vreinterpretq_s64_m128i(a)); + int64x1_t b_h = vget_high_s64(vreinterpretq_s64_m128i(b)); + return vreinterpretq_m128i_s64(vcombine_s64(a_h, b_h)); +} + +// Horizontally compute the minimum amongst the packed unsigned 16-bit integers +// in a, store the minimum and index in dst, and zero the remaining bits in dst. +// +// index[2:0] := 0 +// min[15:0] := a[15:0] +// FOR j := 0 to 7 +// i := j*16 +// IF a[i+15:i] < min[15:0] +// index[2:0] := j +// min[15:0] := a[i+15:i] +// FI +// ENDFOR +// dst[15:0] := min[15:0] +// dst[18:16] := index[2:0] +// dst[127:19] := 0 +// +// https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=_mm_minpos_epu16 +FORCE_INLINE __m128i _mm_minpos_epu16(__m128i a) +{ + __m128i dst; + uint16_t min, idx = 0; + // Find the minimum value +#if defined(__aarch64__) + min = vminvq_u16(vreinterpretq_u16_m128i(a)); +#else + __m64 tmp; + tmp = vreinterpret_m64_u16( + vmin_u16(vget_low_u16(vreinterpretq_u16_m128i(a)), + vget_high_u16(vreinterpretq_u16_m128i(a)))); + tmp = vreinterpret_m64_u16( + vpmin_u16(vreinterpret_u16_m64(tmp), vreinterpret_u16_m64(tmp))); + tmp = vreinterpret_m64_u16( + vpmin_u16(vreinterpret_u16_m64(tmp), vreinterpret_u16_m64(tmp))); + min = vget_lane_u16(vreinterpret_u16_m64(tmp), 0); +#endif + // Get the index of the minimum value + int i; + for (i = 0; i < 8; i++) { + if (min == vgetq_lane_u16(vreinterpretq_u16_m128i(a), 0)) { + idx = (uint16_t) i; + break; + } + a = _mm_srli_si128(a, 2); + } + // Generate result + dst = _mm_setzero_si128(); + dst = vreinterpretq_m128i_u16( + vsetq_lane_u16(min, vreinterpretq_u16_m128i(dst), 0)); + dst = vreinterpretq_m128i_u16( + vsetq_lane_u16(idx, vreinterpretq_u16_m128i(dst), 1)); + return dst; +} + +// shift to right +// https://msdn.microsoft.com/en-us/library/bb514041(v=vs.120).aspx +// http://blog.csdn.net/hemmingway/article/details/44828303 +// Clang requires a macro here, as it is extremely picky about c being a +// literal. +#define _mm_alignr_epi8(a, b, c) \ + ((__m128i) vextq_s8((int8x16_t)(b), (int8x16_t)(a), (c))) + +// Compute the bitwise AND of 128 bits (representing integer data) in a and b, +// and set ZF to 1 if the result is zero, otherwise set ZF to 0. Compute the +// bitwise NOT of a and then AND with b, and set CF to 1 if the result is zero, +// otherwise set CF to 0. Return the CF value. +// https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=_mm_testc_si128 +FORCE_INLINE int _mm_testc_si128(__m128i a, __m128i b) +{ + int64x2_t s64 = + vandq_s64(vreinterpretq_s64_s32(vmvnq_s32(vreinterpretq_s32_m128i(a))), + vreinterpretq_s64_m128i(b)); + return !(vgetq_lane_s64(s64, 0) | vgetq_lane_s64(s64, 1)); +} + +// Compute the bitwise AND of 128 bits (representing integer data) in a and b, +// and set ZF to 1 if the result is zero, otherwise set ZF to 0. Compute the +// bitwise NOT of a and then AND with b, and set CF to 1 if the result is zero, +// otherwise set CF to 0. Return the ZF value. +// https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=_mm_testz_si128 +FORCE_INLINE int _mm_testz_si128(__m128i a, __m128i b) +{ + int64x2_t s64 = + vandq_s64(vreinterpretq_s64_m128i(a), vreinterpretq_s64_m128i(b)); + return !(vgetq_lane_s64(s64, 0) | vgetq_lane_s64(s64, 1)); +} + +// Extracts the selected signed or unsigned 8-bit integer from a and zero +// extends. +// FORCE_INLINE int _mm_extract_epi8(__m128i a, __constrange(0,16) int imm) +#define _mm_extract_epi8(a, imm) vgetq_lane_u8(vreinterpretq_u8_m128i(a), (imm)) + +// Inserts the least significant 8 bits of b into the selected 8-bit integer +// of a. +// FORCE_INLINE __m128i _mm_insert_epi8(__m128i a, int b, +// __constrange(0,16) int imm) +#define _mm_insert_epi8(a, b, imm) \ + __extension__({ \ + vreinterpretq_m128i_s8( \ + vsetq_lane_s8((b), vreinterpretq_s8_m128i(a), (imm))); \ + }) + +// Extracts the selected signed or unsigned 16-bit integer from a and zero +// extends. +// https://msdn.microsoft.com/en-us/library/6dceta0c(v=vs.100).aspx +// FORCE_INLINE int _mm_extract_epi16(__m128i a, __constrange(0,8) int imm) +#define _mm_extract_epi16(a, imm) \ + vgetq_lane_u16(vreinterpretq_u16_m128i(a), (imm)) + +// Inserts the least significant 16 bits of b into the selected 16-bit integer +// of a. +// https://msdn.microsoft.com/en-us/library/kaze8hz1%28v=vs.100%29.aspx +// FORCE_INLINE __m128i _mm_insert_epi16(__m128i a, int b, +// __constrange(0,8) int imm) +#define _mm_insert_epi16(a, b, imm) \ + __extension__({ \ + vreinterpretq_m128i_s16( \ + vsetq_lane_s16((b), vreinterpretq_s16_m128i(a), (imm))); \ + }) + +// Extracts the selected signed or unsigned 32-bit integer from a and zero +// extends. +// FORCE_INLINE int _mm_extract_epi32(__m128i a, __constrange(0,4) int imm) +#define _mm_extract_epi32(a, imm) \ + vgetq_lane_s32(vreinterpretq_s32_m128i(a), (imm)) + +// Extracts the selected single-precision (32-bit) floating-point from a. +// FORCE_INLINE int _mm_extract_ps(__m128 a, __constrange(0,4) int imm) +#define _mm_extract_ps(a, imm) vgetq_lane_s32(vreinterpretq_s32_m128(a), (imm)) + +// Inserts the least significant 32 bits of b into the selected 32-bit integer +// of a. +// FORCE_INLINE __m128i _mm_insert_epi32(__m128i a, int b, +// __constrange(0,4) int imm) +#define _mm_insert_epi32(a, b, imm) \ + __extension__({ \ + vreinterpretq_m128i_s32( \ + vsetq_lane_s32((b), vreinterpretq_s32_m128i(a), (imm))); \ + }) + +// Extracts the selected signed or unsigned 64-bit integer from a and zero +// extends. +// FORCE_INLINE __int64 _mm_extract_epi64(__m128i a, __constrange(0,2) int imm) +#define _mm_extract_epi64(a, imm) \ + vgetq_lane_s64(vreinterpretq_s64_m128i(a), (imm)) + +// Inserts the least significant 64 bits of b into the selected 64-bit integer +// of a. +// FORCE_INLINE __m128i _mm_insert_epi64(__m128i a, __int64 b, +// __constrange(0,2) int imm) +#define _mm_insert_epi64(a, b, imm) \ + __extension__({ \ + vreinterpretq_m128i_s64( \ + vsetq_lane_s64((b), vreinterpretq_s64_m128i(a), (imm))); \ + }) + +// Count the number of bits set to 1 in unsigned 32-bit integer a, and +// return that count in dst. +// https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=_mm_popcnt_u32 +FORCE_INLINE int _mm_popcnt_u32(unsigned int a) +{ +#if defined(__aarch64__) +#if __has_builtin(__builtin_popcount) + return __builtin_popcount(a); +#else + return (int) vaddlv_u8(vcnt_u8(vcreate_u8((uint64_t) a))); +#endif +#else + uint32_t count = 0; + uint8x8_t input_val, count8x8_val; + uint16x4_t count16x4_val; + uint32x2_t count32x2_val; + + input_val = vld1_u8((uint8_t *) &a); + count8x8_val = vcnt_u8(input_val); + count16x4_val = vpaddl_u8(count8x8_val); + count32x2_val = vpaddl_u16(count16x4_val); + + vst1_u32(&count, count32x2_val); + return count; +#endif +} + +// Count the number of bits set to 1 in unsigned 64-bit integer a, and +// return that count in dst. +// https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=_mm_popcnt_u64 +FORCE_INLINE int64_t _mm_popcnt_u64(uint64_t a) +{ +#if defined(__aarch64__) +#if __has_builtin(__builtin_popcountll) + return __builtin_popcountll(a); +#else + return (int64_t) vaddlv_u8(vcnt_u8(vcreate_u8(a))); +#endif +#else + uint64_t count = 0; + uint8x8_t input_val, count8x8_val; + uint16x4_t count16x4_val; + uint32x2_t count32x2_val; + uint64x1_t count64x1_val; + + input_val = vld1_u8((uint8_t *) &a); + count8x8_val = vcnt_u8(input_val); + count16x4_val = vpaddl_u8(count8x8_val); + count32x2_val = vpaddl_u16(count16x4_val); + count64x1_val = vpaddl_u32(count32x2_val); + vst1_u64(&count, count64x1_val); + return count; +#endif +} + +// Macro: Transpose the 4x4 matrix formed by the 4 rows of single-precision +// (32-bit) floating-point elements in row0, row1, row2, and row3, and store the +// transposed matrix in these vectors (row0 now contains column 0, etc.). +// https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=MM_TRANSPOSE4_PS +#define _MM_TRANSPOSE4_PS(row0, row1, row2, row3) \ + do { \ + float32x4x2_t ROW01 = vtrnq_f32(row0, row1); \ + float32x4x2_t ROW23 = vtrnq_f32(row2, row3); \ + row0 = vcombine_f32(vget_low_f32(ROW01.val[0]), \ + vget_low_f32(ROW23.val[0])); \ + row1 = vcombine_f32(vget_low_f32(ROW01.val[1]), \ + vget_low_f32(ROW23.val[1])); \ + row2 = vcombine_f32(vget_high_f32(ROW01.val[0]), \ + vget_high_f32(ROW23.val[0])); \ + row3 = vcombine_f32(vget_high_f32(ROW01.val[1]), \ + vget_high_f32(ROW23.val[1])); \ + } while (0) + +/* Crypto Extensions */ + +#if defined(__ARM_FEATURE_CRYPTO) +// Wraps vmull_p64 +FORCE_INLINE uint64x2_t _sse2neon_vmull_p64(uint64x1_t _a, uint64x1_t _b) +{ + poly64_t a = vget_lane_p64(vreinterpret_p64_u64(_a), 0); + poly64_t b = vget_lane_p64(vreinterpret_p64_u64(_b), 0); + return vreinterpretq_u64_p128(vmull_p64(a, b)); +} +#else // ARMv7 polyfill +// ARMv7/some A64 lacks vmull_p64, but it has vmull_p8. +// +// vmull_p8 calculates 8 8-bit->16-bit polynomial multiplies, but we need a +// 64-bit->128-bit polynomial multiply. +// +// It needs some work and is somewhat slow, but it is still faster than all +// known scalar methods. +// +// Algorithm adapted to C from +// https://www.workofard.com/2017/07/ghash-for-low-end-cores/, which is adapted +// from "Fast Software Polynomial Multiplication on ARM Processors Using the +// NEON Engine" by Danilo Camara, Conrado Gouvea, Julio Lopez and Ricardo Dahab +// (https://hal.inria.fr/hal-01506572) +static uint64x2_t _sse2neon_vmull_p64(uint64x1_t _a, uint64x1_t _b) +{ + poly8x8_t a = vreinterpret_p8_u64(_a); + poly8x8_t b = vreinterpret_p8_u64(_b); + + // Masks + uint8x16_t k48_32 = vcombine_u8(vcreate_u8(0x0000ffffffffffff), + vcreate_u8(0x00000000ffffffff)); + uint8x16_t k16_00 = vcombine_u8(vcreate_u8(0x000000000000ffff), + vcreate_u8(0x0000000000000000)); + + // Do the multiplies, rotating with vext to get all combinations + uint8x16_t d = vreinterpretq_u8_p16(vmull_p8(a, b)); // D = A0 * B0 + uint8x16_t e = + vreinterpretq_u8_p16(vmull_p8(a, vext_p8(b, b, 1))); // E = A0 * B1 + uint8x16_t f = + vreinterpretq_u8_p16(vmull_p8(vext_p8(a, a, 1), b)); // F = A1 * B0 + uint8x16_t g = + vreinterpretq_u8_p16(vmull_p8(a, vext_p8(b, b, 2))); // G = A0 * B2 + uint8x16_t h = + vreinterpretq_u8_p16(vmull_p8(vext_p8(a, a, 2), b)); // H = A2 * B0 + uint8x16_t i = + vreinterpretq_u8_p16(vmull_p8(a, vext_p8(b, b, 3))); // I = A0 * B3 + uint8x16_t j = + vreinterpretq_u8_p16(vmull_p8(vext_p8(a, a, 3), b)); // J = A3 * B0 + uint8x16_t k = + vreinterpretq_u8_p16(vmull_p8(a, vext_p8(b, b, 4))); // L = A0 * B4 + + // Add cross products + uint8x16_t l = veorq_u8(e, f); // L = E + F + uint8x16_t m = veorq_u8(g, h); // M = G + H + uint8x16_t n = veorq_u8(i, j); // N = I + J + + // Interleave. Using vzip1 and vzip2 prevents Clang from emitting TBL + // instructions. +#if defined(__aarch64__) + uint8x16_t lm_p0 = vreinterpretq_u8_u64( + vzip1q_u64(vreinterpretq_u64_u8(l), vreinterpretq_u64_u8(m))); + uint8x16_t lm_p1 = vreinterpretq_u8_u64( + vzip2q_u64(vreinterpretq_u64_u8(l), vreinterpretq_u64_u8(m))); + uint8x16_t nk_p0 = vreinterpretq_u8_u64( + vzip1q_u64(vreinterpretq_u64_u8(n), vreinterpretq_u64_u8(k))); + uint8x16_t nk_p1 = vreinterpretq_u8_u64( + vzip2q_u64(vreinterpretq_u64_u8(n), vreinterpretq_u64_u8(k))); +#else + uint8x16_t lm_p0 = vcombine_u8(vget_low_u8(l), vget_low_u8(m)); + uint8x16_t lm_p1 = vcombine_u8(vget_high_u8(l), vget_high_u8(m)); + uint8x16_t nk_p0 = vcombine_u8(vget_low_u8(n), vget_low_u8(k)); + uint8x16_t nk_p1 = vcombine_u8(vget_high_u8(n), vget_high_u8(k)); +#endif + // t0 = (L) (P0 + P1) << 8 + // t1 = (M) (P2 + P3) << 16 + uint8x16_t t0t1_tmp = veorq_u8(lm_p0, lm_p1); + uint8x16_t t0t1_h = vandq_u8(lm_p1, k48_32); + uint8x16_t t0t1_l = veorq_u8(t0t1_tmp, t0t1_h); + + // t2 = (N) (P4 + P5) << 24 + // t3 = (K) (P6 + P7) << 32 + uint8x16_t t2t3_tmp = veorq_u8(nk_p0, nk_p1); + uint8x16_t t2t3_h = vandq_u8(nk_p1, k16_00); + uint8x16_t t2t3_l = veorq_u8(t2t3_tmp, t2t3_h); + + // De-interleave +#if defined(__aarch64__) + uint8x16_t t0 = vreinterpretq_u8_u64( + vuzp1q_u64(vreinterpretq_u64_u8(t0t1_l), vreinterpretq_u64_u8(t0t1_h))); + uint8x16_t t1 = vreinterpretq_u8_u64( + vuzp2q_u64(vreinterpretq_u64_u8(t0t1_l), vreinterpretq_u64_u8(t0t1_h))); + uint8x16_t t2 = vreinterpretq_u8_u64( + vuzp1q_u64(vreinterpretq_u64_u8(t2t3_l), vreinterpretq_u64_u8(t2t3_h))); + uint8x16_t t3 = vreinterpretq_u8_u64( + vuzp2q_u64(vreinterpretq_u64_u8(t2t3_l), vreinterpretq_u64_u8(t2t3_h))); +#else + uint8x16_t t1 = vcombine_u8(vget_high_u8(t0t1_l), vget_high_u8(t0t1_h)); + uint8x16_t t0 = vcombine_u8(vget_low_u8(t0t1_l), vget_low_u8(t0t1_h)); + uint8x16_t t3 = vcombine_u8(vget_high_u8(t2t3_l), vget_high_u8(t2t3_h)); + uint8x16_t t2 = vcombine_u8(vget_low_u8(t2t3_l), vget_low_u8(t2t3_h)); +#endif + // Shift the cross products + uint8x16_t t0_shift = vextq_u8(t0, t0, 15); // t0 << 8 + uint8x16_t t1_shift = vextq_u8(t1, t1, 14); // t1 << 16 + uint8x16_t t2_shift = vextq_u8(t2, t2, 13); // t2 << 24 + uint8x16_t t3_shift = vextq_u8(t3, t3, 12); // t3 << 32 + + // Accumulate the products + uint8x16_t cross1 = veorq_u8(t0_shift, t1_shift); + uint8x16_t cross2 = veorq_u8(t2_shift, t3_shift); + uint8x16_t mix = veorq_u8(d, cross1); + uint8x16_t r = veorq_u8(mix, cross2); + return vreinterpretq_u64_u8(r); +} +#endif // ARMv7 polyfill + +FORCE_INLINE __m128i _mm_clmulepi64_si128(__m128i _a, __m128i _b, const int imm) +{ + uint64x2_t a = vreinterpretq_u64_m128i(_a); + uint64x2_t b = vreinterpretq_u64_m128i(_b); + switch (imm & 0x11) { + case 0x00: + return vreinterpretq_m128i_u64( + _sse2neon_vmull_p64(vget_low_u64(a), vget_low_u64(b))); + case 0x01: + return vreinterpretq_m128i_u64( + _sse2neon_vmull_p64(vget_high_u64(a), vget_low_u64(b))); + case 0x10: + return vreinterpretq_m128i_u64( + _sse2neon_vmull_p64(vget_low_u64(a), vget_high_u64(b))); + case 0x11: + return vreinterpretq_m128i_u64( + _sse2neon_vmull_p64(vget_high_u64(a), vget_high_u64(b))); + default: + abort(); + } +} + +#if !defined(__ARM_FEATURE_CRYPTO) +/* clang-format off */ +#define SSE2NEON_AES_DATA(w) \ + { \ + w(0x63), w(0x7c), w(0x77), w(0x7b), w(0xf2), w(0x6b), w(0x6f), \ + w(0xc5), w(0x30), w(0x01), w(0x67), w(0x2b), w(0xfe), w(0xd7), \ + w(0xab), w(0x76), w(0xca), w(0x82), w(0xc9), w(0x7d), w(0xfa), \ + w(0x59), w(0x47), w(0xf0), w(0xad), w(0xd4), w(0xa2), w(0xaf), \ + w(0x9c), w(0xa4), w(0x72), w(0xc0), w(0xb7), w(0xfd), w(0x93), \ + w(0x26), w(0x36), w(0x3f), w(0xf7), w(0xcc), w(0x34), w(0xa5), \ + w(0xe5), w(0xf1), w(0x71), w(0xd8), w(0x31), w(0x15), w(0x04), \ + w(0xc7), w(0x23), w(0xc3), w(0x18), w(0x96), w(0x05), w(0x9a), \ + w(0x07), w(0x12), w(0x80), w(0xe2), w(0xeb), w(0x27), w(0xb2), \ + w(0x75), w(0x09), w(0x83), w(0x2c), w(0x1a), w(0x1b), w(0x6e), \ + w(0x5a), w(0xa0), w(0x52), w(0x3b), w(0xd6), w(0xb3), w(0x29), \ + w(0xe3), w(0x2f), w(0x84), w(0x53), w(0xd1), w(0x00), w(0xed), \ + w(0x20), w(0xfc), w(0xb1), w(0x5b), w(0x6a), w(0xcb), w(0xbe), \ + w(0x39), w(0x4a), w(0x4c), w(0x58), w(0xcf), w(0xd0), w(0xef), \ + w(0xaa), w(0xfb), w(0x43), w(0x4d), w(0x33), w(0x85), w(0x45), \ + w(0xf9), w(0x02), w(0x7f), w(0x50), w(0x3c), w(0x9f), w(0xa8), \ + w(0x51), w(0xa3), w(0x40), w(0x8f), w(0x92), w(0x9d), w(0x38), \ + w(0xf5), w(0xbc), w(0xb6), w(0xda), w(0x21), w(0x10), w(0xff), \ + w(0xf3), w(0xd2), w(0xcd), w(0x0c), w(0x13), w(0xec), w(0x5f), \ + w(0x97), w(0x44), w(0x17), w(0xc4), w(0xa7), w(0x7e), w(0x3d), \ + w(0x64), w(0x5d), w(0x19), w(0x73), w(0x60), w(0x81), w(0x4f), \ + w(0xdc), w(0x22), w(0x2a), w(0x90), w(0x88), w(0x46), w(0xee), \ + w(0xb8), w(0x14), w(0xde), w(0x5e), w(0x0b), w(0xdb), w(0xe0), \ + w(0x32), w(0x3a), w(0x0a), w(0x49), w(0x06), w(0x24), w(0x5c), \ + w(0xc2), w(0xd3), w(0xac), w(0x62), w(0x91), w(0x95), w(0xe4), \ + w(0x79), w(0xe7), w(0xc8), w(0x37), w(0x6d), w(0x8d), w(0xd5), \ + w(0x4e), w(0xa9), w(0x6c), w(0x56), w(0xf4), w(0xea), w(0x65), \ + w(0x7a), w(0xae), w(0x08), w(0xba), w(0x78), w(0x25), w(0x2e), \ + w(0x1c), w(0xa6), w(0xb4), w(0xc6), w(0xe8), w(0xdd), w(0x74), \ + w(0x1f), w(0x4b), w(0xbd), w(0x8b), w(0x8a), w(0x70), w(0x3e), \ + w(0xb5), w(0x66), w(0x48), w(0x03), w(0xf6), w(0x0e), w(0x61), \ + w(0x35), w(0x57), w(0xb9), w(0x86), w(0xc1), w(0x1d), w(0x9e), \ + w(0xe1), w(0xf8), w(0x98), w(0x11), w(0x69), w(0xd9), w(0x8e), \ + w(0x94), w(0x9b), w(0x1e), w(0x87), w(0xe9), w(0xce), w(0x55), \ + w(0x28), w(0xdf), w(0x8c), w(0xa1), w(0x89), w(0x0d), w(0xbf), \ + w(0xe6), w(0x42), w(0x68), w(0x41), w(0x99), w(0x2d), w(0x0f), \ + w(0xb0), w(0x54), w(0xbb), w(0x16) \ + } +/* clang-format on */ + +/* X Macro trick. See https://en.wikipedia.org/wiki/X_Macro */ +#define SSE2NEON_AES_H0(x) (x) +static const uint8_t SSE2NEON_sbox[256] = SSE2NEON_AES_DATA(SSE2NEON_AES_H0); +#undef SSE2NEON_AES_H0 + +// In the absence of crypto extensions, implement aesenc using regular neon +// intrinsics instead. See: +// https://www.workofard.com/2017/01/accelerated-aes-for-the-arm64-linux-kernel/ +// https://www.workofard.com/2017/07/ghash-for-low-end-cores/ and +// https://github.com/ColinIanKing/linux-next-mirror/blob/b5f466091e130caaf0735976648f72bd5e09aa84/crypto/aegis128-neon-inner.c#L52 +// for more information Reproduced with permission of the author. +FORCE_INLINE __m128i _mm_aesenc_si128(__m128i EncBlock, __m128i RoundKey) +{ +#if defined(__aarch64__) + static const uint8_t shift_rows[] = {0x0, 0x5, 0xa, 0xf, 0x4, 0x9, + 0xe, 0x3, 0x8, 0xd, 0x2, 0x7, + 0xc, 0x1, 0x6, 0xb}; + static const uint8_t ror32by8[] = {0x1, 0x2, 0x3, 0x0, 0x5, 0x6, 0x7, 0x4, + 0x9, 0xa, 0xb, 0x8, 0xd, 0xe, 0xf, 0xc}; + + uint8x16_t v; + uint8x16_t w = vreinterpretq_u8_m128i(EncBlock); + + // shift rows + w = vqtbl1q_u8(w, vld1q_u8(shift_rows)); + + // sub bytes + v = vqtbl4q_u8(vld1q_u8_x4(SSE2NEON_sbox), w); + v = vqtbx4q_u8(v, vld1q_u8_x4(SSE2NEON_sbox + 0x40), w - 0x40); + v = vqtbx4q_u8(v, vld1q_u8_x4(SSE2NEON_sbox + 0x80), w - 0x80); + v = vqtbx4q_u8(v, vld1q_u8_x4(SSE2NEON_sbox + 0xc0), w - 0xc0); + + // mix columns + w = (v << 1) ^ (uint8x16_t)(((int8x16_t) v >> 7) & 0x1b); + w ^= (uint8x16_t) vrev32q_u16((uint16x8_t) v); + w ^= vqtbl1q_u8(v ^ w, vld1q_u8(ror32by8)); + + // add round key + return vreinterpretq_m128i_u8(w) ^ RoundKey; + +#else /* ARMv7-A NEON implementation */ +#define SSE2NEON_AES_B2W(b0, b1, b2, b3) \ + (((uint32_t)(b3) << 24) | ((uint32_t)(b2) << 16) | ((uint32_t)(b1) << 8) | \ + (b0)) +#define SSE2NEON_AES_F2(x) ((x << 1) ^ (((x >> 7) & 1) * 0x011b /* WPOLY */)) +#define SSE2NEON_AES_F3(x) (SSE2NEON_AES_F2(x) ^ x) +#define SSE2NEON_AES_U0(p) \ + SSE2NEON_AES_B2W(SSE2NEON_AES_F2(p), p, p, SSE2NEON_AES_F3(p)) +#define SSE2NEON_AES_U1(p) \ + SSE2NEON_AES_B2W(SSE2NEON_AES_F3(p), SSE2NEON_AES_F2(p), p, p) +#define SSE2NEON_AES_U2(p) \ + SSE2NEON_AES_B2W(p, SSE2NEON_AES_F3(p), SSE2NEON_AES_F2(p), p) +#define SSE2NEON_AES_U3(p) \ + SSE2NEON_AES_B2W(p, p, SSE2NEON_AES_F3(p), SSE2NEON_AES_F2(p)) + static const uint32_t ALIGN_STRUCT(16) aes_table[4][256] = { + SSE2NEON_AES_DATA(SSE2NEON_AES_U0), + SSE2NEON_AES_DATA(SSE2NEON_AES_U1), + SSE2NEON_AES_DATA(SSE2NEON_AES_U2), + SSE2NEON_AES_DATA(SSE2NEON_AES_U3), + }; +#undef SSE2NEON_AES_B2W +#undef SSE2NEON_AES_F2 +#undef SSE2NEON_AES_F3 +#undef SSE2NEON_AES_U0 +#undef SSE2NEON_AES_U1 +#undef SSE2NEON_AES_U2 +#undef SSE2NEON_AES_U3 + + uint32_t x0 = _mm_cvtsi128_si32(EncBlock); + uint32_t x1 = _mm_cvtsi128_si32(_mm_shuffle_epi32(EncBlock, 0x55)); + uint32_t x2 = _mm_cvtsi128_si32(_mm_shuffle_epi32(EncBlock, 0xAA)); + uint32_t x3 = _mm_cvtsi128_si32(_mm_shuffle_epi32(EncBlock, 0xFF)); + + __m128i out = _mm_set_epi32( + (aes_table[0][x3 & 0xff] ^ aes_table[1][(x0 >> 8) & 0xff] ^ + aes_table[2][(x1 >> 16) & 0xff] ^ aes_table[3][x2 >> 24]), + (aes_table[0][x2 & 0xff] ^ aes_table[1][(x3 >> 8) & 0xff] ^ + aes_table[2][(x0 >> 16) & 0xff] ^ aes_table[3][x1 >> 24]), + (aes_table[0][x1 & 0xff] ^ aes_table[1][(x2 >> 8) & 0xff] ^ + aes_table[2][(x3 >> 16) & 0xff] ^ aes_table[3][x0 >> 24]), + (aes_table[0][x0 & 0xff] ^ aes_table[1][(x1 >> 8) & 0xff] ^ + aes_table[2][(x2 >> 16) & 0xff] ^ aes_table[3][x3 >> 24])); + + return _mm_xor_si128(out, RoundKey); +#endif +} + +FORCE_INLINE __m128i _mm_aesenclast_si128(__m128i a, __m128i RoundKey) +{ + /* FIXME: optimized for NEON */ + uint8_t v[4][4] = { + [0] = {SSE2NEON_sbox[vreinterpretq_nth_u8_m128i(a, 0)], + SSE2NEON_sbox[vreinterpretq_nth_u8_m128i(a, 5)], + SSE2NEON_sbox[vreinterpretq_nth_u8_m128i(a, 10)], + SSE2NEON_sbox[vreinterpretq_nth_u8_m128i(a, 15)]}, + [1] = {SSE2NEON_sbox[vreinterpretq_nth_u8_m128i(a, 4)], + SSE2NEON_sbox[vreinterpretq_nth_u8_m128i(a, 9)], + SSE2NEON_sbox[vreinterpretq_nth_u8_m128i(a, 14)], + SSE2NEON_sbox[vreinterpretq_nth_u8_m128i(a, 3)]}, + [2] = {SSE2NEON_sbox[vreinterpretq_nth_u8_m128i(a, 8)], + SSE2NEON_sbox[vreinterpretq_nth_u8_m128i(a, 13)], + SSE2NEON_sbox[vreinterpretq_nth_u8_m128i(a, 2)], + SSE2NEON_sbox[vreinterpretq_nth_u8_m128i(a, 7)]}, + [3] = {SSE2NEON_sbox[vreinterpretq_nth_u8_m128i(a, 12)], + SSE2NEON_sbox[vreinterpretq_nth_u8_m128i(a, 1)], + SSE2NEON_sbox[vreinterpretq_nth_u8_m128i(a, 6)], + SSE2NEON_sbox[vreinterpretq_nth_u8_m128i(a, 11)]}, + }; + for (int i = 0; i < 16; i++) + vreinterpretq_nth_u8_m128i(a, i) = + v[i / 4][i % 4] ^ vreinterpretq_nth_u8_m128i(RoundKey, i); + return a; +} + +// Emits the Advanced Encryption Standard (AES) instruction aeskeygenassist. +// This instruction generates a round key for AES encryption. See +// https://kazakov.life/2017/11/01/cryptocurrency-mining-on-ios-devices/ +// for details. +// +// https://msdn.microsoft.com/en-us/library/cc714138(v=vs.120).aspx +FORCE_INLINE __m128i _mm_aeskeygenassist_si128(__m128i key, const int rcon) +{ + uint32_t X1 = _mm_cvtsi128_si32(_mm_shuffle_epi32(key, 0x55)); + uint32_t X3 = _mm_cvtsi128_si32(_mm_shuffle_epi32(key, 0xFF)); + for (int i = 0; i < 4; ++i) { + ((uint8_t *) &X1)[i] = SSE2NEON_sbox[((uint8_t *) &X1)[i]]; + ((uint8_t *) &X3)[i] = SSE2NEON_sbox[((uint8_t *) &X3)[i]]; + } + return _mm_set_epi32(((X3 >> 8) | (X3 << 24)) ^ rcon, X3, + ((X1 >> 8) | (X1 << 24)) ^ rcon, X1); +} +#undef SSE2NEON_AES_DATA + +#else /* __ARM_FEATURE_CRYPTO */ +// Implements equivalent of 'aesenc' by combining AESE (with an empty key) and +// AESMC and then manually applying the real key as an xor operation. This +// unfortunately means an additional xor op; the compiler should be able to +// optimize this away for repeated calls however. See +// https://blog.michaelbrase.com/2018/05/08/emulating-x86-aes-intrinsics-on-armv8-a +// for more details. +FORCE_INLINE __m128i _mm_aesenc_si128(__m128i a, __m128i b) +{ + return vreinterpretq_m128i_u8( + vaesmcq_u8(vaeseq_u8(vreinterpretq_u8_m128i(a), vdupq_n_u8(0))) ^ + vreinterpretq_u8_m128i(b)); +} + +// https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=_mm_aesenclast_si128 +FORCE_INLINE __m128i _mm_aesenclast_si128(__m128i a, __m128i RoundKey) +{ + return _mm_xor_si128(vreinterpretq_m128i_u8(vaeseq_u8( + vreinterpretq_u8_m128i(a), vdupq_n_u8(0))), + RoundKey); +} + +FORCE_INLINE __m128i _mm_aeskeygenassist_si128(__m128i a, const int rcon) +{ + // AESE does ShiftRows and SubBytes on A + uint8x16_t u8 = vaeseq_u8(vreinterpretq_u8_m128i(a), vdupq_n_u8(0)); + + uint8x16_t dest = { + // Undo ShiftRows step from AESE and extract X1 and X3 + u8[0x4], u8[0x1], u8[0xE], u8[0xB], // SubBytes(X1) + u8[0x1], u8[0xE], u8[0xB], u8[0x4], // ROT(SubBytes(X1)) + u8[0xC], u8[0x9], u8[0x6], u8[0x3], // SubBytes(X3) + u8[0x9], u8[0x6], u8[0x3], u8[0xC], // ROT(SubBytes(X3)) + }; + uint32x4_t r = {0, (unsigned) rcon, 0, (unsigned) rcon}; + return vreinterpretq_m128i_u8(dest) ^ vreinterpretq_m128i_u32(r); +} +#endif + +/* Streaming Extensions */ + +// Guarantees that every preceding store is globally visible before any +// subsequent store. +// https://msdn.microsoft.com/en-us/library/5h2w73d1%28v=vs.90%29.aspx +FORCE_INLINE void _mm_sfence(void) +{ + __sync_synchronize(); +} + +// Store 128-bits (composed of 4 packed single-precision (32-bit) floating- +// point elements) from a into memory using a non-temporal memory hint. +// https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=_mm_stream_ps +FORCE_INLINE void _mm_stream_ps(float *p, __m128 a) +{ +#if __has_builtin(__builtin_nontemporal_store) + __builtin_nontemporal_store(a, (float32x4_t *) p); +#else + vst1q_f32(p, vreinterpretq_f32_m128(a)); +#endif +} + +// Stores the data in a to the address p without polluting the caches. If the +// cache line containing address p is already in the cache, the cache will be +// updated. +// https://msdn.microsoft.com/en-us/library/ba08y07y%28v=vs.90%29.aspx +FORCE_INLINE void _mm_stream_si128(__m128i *p, __m128i a) +{ +#if __has_builtin(__builtin_nontemporal_store) + __builtin_nontemporal_store(a, p); +#else + vst1q_s64((int64_t *) p, vreinterpretq_s64_m128i(a)); +#endif +} + +// Load 128-bits of integer data from memory into dst using a non-temporal +// memory hint. mem_addr must be aligned on a 16-byte boundary or a +// general-protection exception may be generated. +// +// dst[127:0] := MEM[mem_addr+127:mem_addr] +// +// https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=_mm_stream_load_si128 +FORCE_INLINE __m128i _mm_stream_load_si128(__m128i *p) +{ +#if __has_builtin(__builtin_nontemporal_store) + return __builtin_nontemporal_load(p); +#else + return vreinterpretq_m128i_s64(vld1q_s64((int64_t *) p)); +#endif +} + +// Cache line containing p is flushed and invalidated from all caches in the +// coherency domain. : +// https://msdn.microsoft.com/en-us/library/ba08y07y(v=vs.100).aspx +FORCE_INLINE void _mm_clflush(void const *p) +{ + (void) p; + // no corollary for Neon? +} + +// Allocate aligned blocks of memory. +// https://software.intel.com/en-us/ +// cpp-compiler-developer-guide-and-reference-allocating-and-freeing-aligned-memory-blocks +FORCE_INLINE void *_mm_malloc(size_t size, size_t align) +{ + void *ptr; + if (align == 1) + return malloc(size); + if (align == 2 || (sizeof(void *) == 8 && align == 4)) + align = sizeof(void *); + if (!posix_memalign(&ptr, align, size)) + return ptr; + return NULL; +} + +FORCE_INLINE void _mm_free(void *addr) +{ + free(addr); +} + +// Starting with the initial value in crc, accumulates a CRC32 value for +// unsigned 8-bit integer v. +// https://msdn.microsoft.com/en-us/library/bb514036(v=vs.100) +FORCE_INLINE uint32_t _mm_crc32_u8(uint32_t crc, uint8_t v) +{ +#if defined(__aarch64__) && defined(__ARM_FEATURE_CRC32) + __asm__ __volatile__("crc32cb %w[c], %w[c], %w[v]\n\t" + : [c] "+r"(crc) + : [v] "r"(v)); +#else + crc ^= v; + for (int bit = 0; bit < 8; bit++) { + if (crc & 1) + crc = (crc >> 1) ^ UINT32_C(0x82f63b78); + else + crc = (crc >> 1); + } +#endif + return crc; +} + +// Starting with the initial value in crc, accumulates a CRC32 value for +// unsigned 16-bit integer v. +// https://msdn.microsoft.com/en-us/library/bb531411(v=vs.100) +FORCE_INLINE uint32_t _mm_crc32_u16(uint32_t crc, uint16_t v) +{ +#if defined(__aarch64__) && defined(__ARM_FEATURE_CRC32) + __asm__ __volatile__("crc32ch %w[c], %w[c], %w[v]\n\t" + : [c] "+r"(crc) + : [v] "r"(v)); +#else + crc = _mm_crc32_u8(crc, v & 0xff); + crc = _mm_crc32_u8(crc, (v >> 8) & 0xff); +#endif + return crc; +} + +// Starting with the initial value in crc, accumulates a CRC32 value for +// unsigned 32-bit integer v. +// https://msdn.microsoft.com/en-us/library/bb531394(v=vs.100) +FORCE_INLINE uint32_t _mm_crc32_u32(uint32_t crc, uint32_t v) +{ +#if defined(__aarch64__) && defined(__ARM_FEATURE_CRC32) + __asm__ __volatile__("crc32cw %w[c], %w[c], %w[v]\n\t" + : [c] "+r"(crc) + : [v] "r"(v)); +#else + crc = _mm_crc32_u16(crc, v & 0xffff); + crc = _mm_crc32_u16(crc, (v >> 16) & 0xffff); +#endif + return crc; +} + +// Starting with the initial value in crc, accumulates a CRC32 value for +// unsigned 64-bit integer v. +// https://msdn.microsoft.com/en-us/library/bb514033(v=vs.100) +FORCE_INLINE uint64_t _mm_crc32_u64(uint64_t crc, uint64_t v) +{ +#if defined(__aarch64__) && defined(__ARM_FEATURE_CRC32) + __asm__ __volatile__("crc32cx %w[c], %w[c], %x[v]\n\t" + : [c] "+r"(crc) + : [v] "r"(v)); +#else + crc = _mm_crc32_u32((uint32_t)(crc), v & 0xffffffff); + crc = _mm_crc32_u32((uint32_t)(crc), (v >> 32) & 0xffffffff); +#endif + return crc; +} + +#if defined(__GNUC__) || defined(__clang__) +#pragma pop_macro("ALIGN_STRUCT") +#pragma pop_macro("FORCE_INLINE") +#endif + +#if defined(__GNUC__) +#pragma GCC pop_options +#endif + +#endif diff --git a/yap_lab_3/.venv/include/site/python3.12/pygame/mask.h b/yap_lab_3/.venv/include/site/python3.12/pygame/mask.h new file mode 100644 index 0000000..45ad8c5 --- /dev/null +++ b/yap_lab_3/.venv/include/site/python3.12/pygame/mask.h @@ -0,0 +1,7 @@ +#ifndef PGMASK_INTERNAL_H +#define PGMASK_INTERNAL_H + +#include "include/pygame_mask.h" +#define PYGAMEAPI_MASK_NUMSLOTS 1 + +#endif /* ~PGMASK_INTERNAL_H */ diff --git a/yap_lab_3/.venv/include/site/python3.12/pygame/mixer.h b/yap_lab_3/.venv/include/site/python3.12/pygame/mixer.h new file mode 100644 index 0000000..97f5a0f --- /dev/null +++ b/yap_lab_3/.venv/include/site/python3.12/pygame/mixer.h @@ -0,0 +1,14 @@ +#ifndef MIXER_INTERNAL_H +#define MIXER_INTERNAL_H + +#include + +/* test mixer initializations */ +#define MIXER_INIT_CHECK() \ + if (!SDL_WasInit(SDL_INIT_AUDIO)) \ + return RAISE(pgExc_SDLError, "mixer not initialized") + +#define PYGAMEAPI_MIXER_NUMSLOTS 5 +#include "include/pygame_mixer.h" + +#endif /* ~MIXER_INTERNAL_H */ diff --git a/yap_lab_3/.venv/include/site/python3.12/pygame/palette.h b/yap_lab_3/.venv/include/site/python3.12/pygame/palette.h new file mode 100644 index 0000000..1ae4cf6 --- /dev/null +++ b/yap_lab_3/.venv/include/site/python3.12/pygame/palette.h @@ -0,0 +1,123 @@ +/* + pygame - Python Game Library + Copyright (C) 2000-2001 Pete Shinners + + This library is free software; you can redistribute it and/or + modify it under the terms of the GNU Library General Public + License as published by the Free Software Foundation; either + version 2 of the License, or (at your option) any later version. + + This library is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU + Library General Public License for more details. + + You should have received a copy of the GNU Library General Public + License along with this library; if not, write to the Free + Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + + Pete Shinners + pete@shinners.org +*/ + +#ifndef PALETTE_H +#define PALETTE_H + +#include + +/* SDL 2 does not assign a default palette color scheme to a new 8 bit + * surface. Instead, the palette is set all white. This defines the SDL 1.2 + * default palette. + */ +static const SDL_Color default_palette_colors[] = { + {0, 0, 0, 255}, {0, 0, 85, 255}, {0, 0, 170, 255}, + {0, 0, 255, 255}, {0, 36, 0, 255}, {0, 36, 85, 255}, + {0, 36, 170, 255}, {0, 36, 255, 255}, {0, 73, 0, 255}, + {0, 73, 85, 255}, {0, 73, 170, 255}, {0, 73, 255, 255}, + {0, 109, 0, 255}, {0, 109, 85, 255}, {0, 109, 170, 255}, + {0, 109, 255, 255}, {0, 146, 0, 255}, {0, 146, 85, 255}, + {0, 146, 170, 255}, {0, 146, 255, 255}, {0, 182, 0, 255}, + {0, 182, 85, 255}, {0, 182, 170, 255}, {0, 182, 255, 255}, + {0, 219, 0, 255}, {0, 219, 85, 255}, {0, 219, 170, 255}, + {0, 219, 255, 255}, {0, 255, 0, 255}, {0, 255, 85, 255}, + {0, 255, 170, 255}, {0, 255, 255, 255}, {85, 0, 0, 255}, + {85, 0, 85, 255}, {85, 0, 170, 255}, {85, 0, 255, 255}, + {85, 36, 0, 255}, {85, 36, 85, 255}, {85, 36, 170, 255}, + {85, 36, 255, 255}, {85, 73, 0, 255}, {85, 73, 85, 255}, + {85, 73, 170, 255}, {85, 73, 255, 255}, {85, 109, 0, 255}, + {85, 109, 85, 255}, {85, 109, 170, 255}, {85, 109, 255, 255}, + {85, 146, 0, 255}, {85, 146, 85, 255}, {85, 146, 170, 255}, + {85, 146, 255, 255}, {85, 182, 0, 255}, {85, 182, 85, 255}, + {85, 182, 170, 255}, {85, 182, 255, 255}, {85, 219, 0, 255}, + {85, 219, 85, 255}, {85, 219, 170, 255}, {85, 219, 255, 255}, + {85, 255, 0, 255}, {85, 255, 85, 255}, {85, 255, 170, 255}, + {85, 255, 255, 255}, {170, 0, 0, 255}, {170, 0, 85, 255}, + {170, 0, 170, 255}, {170, 0, 255, 255}, {170, 36, 0, 255}, + {170, 36, 85, 255}, {170, 36, 170, 255}, {170, 36, 255, 255}, + {170, 73, 0, 255}, {170, 73, 85, 255}, {170, 73, 170, 255}, + {170, 73, 255, 255}, {170, 109, 0, 255}, {170, 109, 85, 255}, + {170, 109, 170, 255}, {170, 109, 255, 255}, {170, 146, 0, 255}, + {170, 146, 85, 255}, {170, 146, 170, 255}, {170, 146, 255, 255}, + {170, 182, 0, 255}, {170, 182, 85, 255}, {170, 182, 170, 255}, + {170, 182, 255, 255}, {170, 219, 0, 255}, {170, 219, 85, 255}, + {170, 219, 170, 255}, {170, 219, 255, 255}, {170, 255, 0, 255}, + {170, 255, 85, 255}, {170, 255, 170, 255}, {170, 255, 255, 255}, + {255, 0, 0, 255}, {255, 0, 85, 255}, {255, 0, 170, 255}, + {255, 0, 255, 255}, {255, 36, 0, 255}, {255, 36, 85, 255}, + {255, 36, 170, 255}, {255, 36, 255, 255}, {255, 73, 0, 255}, + {255, 73, 85, 255}, {255, 73, 170, 255}, {255, 73, 255, 255}, + {255, 109, 0, 255}, {255, 109, 85, 255}, {255, 109, 170, 255}, + {255, 109, 255, 255}, {255, 146, 0, 255}, {255, 146, 85, 255}, + {255, 146, 170, 255}, {255, 146, 255, 255}, {255, 182, 0, 255}, + {255, 182, 85, 255}, {255, 182, 170, 255}, {255, 182, 255, 255}, + {255, 219, 0, 255}, {255, 219, 85, 255}, {255, 219, 170, 255}, + {255, 219, 255, 255}, {255, 255, 0, 255}, {255, 255, 85, 255}, + {255, 255, 170, 255}, {255, 255, 255, 255}, {0, 0, 0, 255}, + {0, 0, 85, 255}, {0, 0, 170, 255}, {0, 0, 255, 255}, + {0, 36, 0, 255}, {0, 36, 85, 255}, {0, 36, 170, 255}, + {0, 36, 255, 255}, {0, 73, 0, 255}, {0, 73, 85, 255}, + {0, 73, 170, 255}, {0, 73, 255, 255}, {0, 109, 0, 255}, + {0, 109, 85, 255}, {0, 109, 170, 255}, {0, 109, 255, 255}, + {0, 146, 0, 255}, {0, 146, 85, 255}, {0, 146, 170, 255}, + {0, 146, 255, 255}, {0, 182, 0, 255}, {0, 182, 85, 255}, + {0, 182, 170, 255}, {0, 182, 255, 255}, {0, 219, 0, 255}, + {0, 219, 85, 255}, {0, 219, 170, 255}, {0, 219, 255, 255}, + {0, 255, 0, 255}, {0, 255, 85, 255}, {0, 255, 170, 255}, + {0, 255, 255, 255}, {85, 0, 0, 255}, {85, 0, 85, 255}, + {85, 0, 170, 255}, {85, 0, 255, 255}, {85, 36, 0, 255}, + {85, 36, 85, 255}, {85, 36, 170, 255}, {85, 36, 255, 255}, + {85, 73, 0, 255}, {85, 73, 85, 255}, {85, 73, 170, 255}, + {85, 73, 255, 255}, {85, 109, 0, 255}, {85, 109, 85, 255}, + {85, 109, 170, 255}, {85, 109, 255, 255}, {85, 146, 0, 255}, + {85, 146, 85, 255}, {85, 146, 170, 255}, {85, 146, 255, 255}, + {85, 182, 0, 255}, {85, 182, 85, 255}, {85, 182, 170, 255}, + {85, 182, 255, 255}, {85, 219, 0, 255}, {85, 219, 85, 255}, + {85, 219, 170, 255}, {85, 219, 255, 255}, {85, 255, 0, 255}, + {85, 255, 85, 255}, {85, 255, 170, 255}, {85, 255, 255, 255}, + {170, 0, 0, 255}, {170, 0, 85, 255}, {170, 0, 170, 255}, + {170, 0, 255, 255}, {170, 36, 0, 255}, {170, 36, 85, 255}, + {170, 36, 170, 255}, {170, 36, 255, 255}, {170, 73, 0, 255}, + {170, 73, 85, 255}, {170, 73, 170, 255}, {170, 73, 255, 255}, + {170, 109, 0, 255}, {170, 109, 85, 255}, {170, 109, 170, 255}, + {170, 109, 255, 255}, {170, 146, 0, 255}, {170, 146, 85, 255}, + {170, 146, 170, 255}, {170, 146, 255, 255}, {170, 182, 0, 255}, + {170, 182, 85, 255}, {170, 182, 170, 255}, {170, 182, 255, 255}, + {170, 219, 0, 255}, {170, 219, 85, 255}, {170, 219, 170, 255}, + {170, 219, 255, 255}, {170, 255, 0, 255}, {170, 255, 85, 255}, + {170, 255, 170, 255}, {170, 255, 255, 255}, {255, 0, 0, 255}, + {255, 0, 85, 255}, {255, 0, 170, 255}, {255, 0, 255, 255}, + {255, 36, 0, 255}, {255, 36, 85, 255}, {255, 36, 170, 255}, + {255, 36, 255, 255}, {255, 73, 0, 255}, {255, 73, 85, 255}, + {255, 73, 170, 255}, {255, 73, 255, 255}, {255, 109, 0, 255}, + {255, 109, 85, 255}, {255, 109, 170, 255}, {255, 109, 255, 255}, + {255, 146, 0, 255}, {255, 146, 85, 255}, {255, 146, 170, 255}, + {255, 146, 255, 255}, {255, 182, 0, 255}, {255, 182, 85, 255}, + {255, 182, 170, 255}, {255, 182, 255, 255}, {255, 219, 0, 255}, + {255, 219, 85, 255}, {255, 219, 170, 255}, {255, 219, 255, 255}, + {255, 255, 0, 255}, {255, 255, 85, 255}, {255, 255, 170, 255}, + {255, 255, 255, 255}}; + +static const int default_palette_size = + (int)(sizeof(default_palette_colors) / sizeof(SDL_Color)); + +#endif diff --git a/yap_lab_3/.venv/include/site/python3.12/pygame/pgarrinter.h b/yap_lab_3/.venv/include/site/python3.12/pygame/pgarrinter.h new file mode 100644 index 0000000..5ba096b --- /dev/null +++ b/yap_lab_3/.venv/include/site/python3.12/pygame/pgarrinter.h @@ -0,0 +1,26 @@ +/* array structure interface version 3 declarations */ + +#if !defined(PG_ARRAYINTER_HEADER) +#define PG_ARRAYINTER_HEADER + +static const int PAI_CONTIGUOUS = 0x01; +static const int PAI_FORTRAN = 0x02; +static const int PAI_ALIGNED = 0x100; +static const int PAI_NOTSWAPPED = 0x200; +static const int PAI_WRITEABLE = 0x400; +static const int PAI_ARR_HAS_DESCR = 0x800; + +typedef struct { + int two; /* contains the integer 2 -- simple sanity check */ + int nd; /* number of dimensions */ + char typekind; /* kind in array -- character code of typestr */ + int itemsize; /* size of each element */ + int flags; /* flags indicating how the data should be */ + /* interpreted */ + Py_intptr_t *shape; /* A length-nd array of shape information */ + Py_intptr_t *strides; /* A length-nd array of stride information */ + void *data; /* A pointer to the first element of the array */ + PyObject *descr; /* NULL or a data-description */ +} PyArrayInterface; + +#endif diff --git a/yap_lab_3/.venv/include/site/python3.12/pygame/pgbufferproxy.h b/yap_lab_3/.venv/include/site/python3.12/pygame/pgbufferproxy.h new file mode 100644 index 0000000..1507608 --- /dev/null +++ b/yap_lab_3/.venv/include/site/python3.12/pygame/pgbufferproxy.h @@ -0,0 +1,7 @@ +#ifndef PG_BUFPROXY_INTERNAL_H +#define PG_BUFPROXY_INTERNAL_H + +#include "include/pygame_bufferproxy.h" +#define PYGAMEAPI_BUFPROXY_NUMSLOTS 4 + +#endif /* ~PG_BUFPROXY_INTERNAL_H */ diff --git a/yap_lab_3/.venv/include/site/python3.12/pygame/pgcompat.h b/yap_lab_3/.venv/include/site/python3.12/pygame/pgcompat.h new file mode 100644 index 0000000..1bc0d24 --- /dev/null +++ b/yap_lab_3/.venv/include/site/python3.12/pygame/pgcompat.h @@ -0,0 +1,27 @@ +/* Python 2.x/3.x compatibility tools (internal) + */ +#ifndef PGCOMPAT_INTERNAL_H +#define PGCOMPAT_INTERNAL_H + +#include "include/pgcompat.h" + +/* Module init function returns new module instance. */ +#define MODINIT_DEFINE(mod_name) PyMODINIT_FUNC PyInit_##mod_name(void) + +/* Defaults for unicode file path encoding */ +#if defined(MS_WIN32) +#define UNICODE_DEF_FS_ERROR "replace" +#else +#define UNICODE_DEF_FS_ERROR "surrogateescape" +#endif + +#define RELATIVE_MODULE(m) ("." m) + +#ifndef Py_TPFLAGS_HAVE_NEWBUFFER +#define Py_TPFLAGS_HAVE_NEWBUFFER 0 +#endif + +#define Slice_GET_INDICES_EX(slice, length, start, stop, step, slicelength) \ + PySlice_GetIndicesEx(slice, length, start, stop, step, slicelength) + +#endif /* ~PGCOMPAT_INTERNAL_H */ diff --git a/yap_lab_3/.venv/include/site/python3.12/pygame/pgopengl.h b/yap_lab_3/.venv/include/site/python3.12/pygame/pgopengl.h new file mode 100644 index 0000000..a845cbf --- /dev/null +++ b/yap_lab_3/.venv/include/site/python3.12/pygame/pgopengl.h @@ -0,0 +1,20 @@ +#if !defined(PGOPENGL_H) +#define PGOPENGL_H + +/** This header includes definitions of Opengl functions as pointer types for + ** use with the SDL function SDL_GL_GetProcAddress. + **/ + +#if defined(_WIN32) +#define GL_APIENTRY __stdcall +#else +#define GL_APIENTRY +#endif + +typedef void(GL_APIENTRY *GL_glReadPixels_Func)(int, int, int, int, + unsigned int, unsigned int, + void *); + +typedef void(GL_APIENTRY *GL_glViewport_Func)(int, int, unsigned int, + unsigned int); +#endif diff --git a/yap_lab_3/.venv/include/site/python3.12/pygame/pgplatform.h b/yap_lab_3/.venv/include/site/python3.12/pygame/pgplatform.h new file mode 100644 index 0000000..54310eb --- /dev/null +++ b/yap_lab_3/.venv/include/site/python3.12/pygame/pgplatform.h @@ -0,0 +1,23 @@ +/* platform/compiler adjustments (internal) */ +#ifndef PG_PLATFORM_INTERNAL_H +#define PG_PLATFORM_INTERNAL_H + +#include "include/pgplatform.h" + +#ifndef MIN +#define MIN(a, b) ((a) < (b) ? (a) : (b)) +#endif +#ifndef MAX +#define MAX(a, b) ((a) > (b) ? (a) : (b)) +#endif +#ifndef ABS +#define ABS(a) (((a) < 0) ? -(a) : (a)) +#endif + +/* warnings */ +#define PG_STRINGIZE_HELPER(x) #x +#define PG_STRINGIZE(x) PG_STRINGIZE_HELPER(x) +#define PG_WARN(desc) \ + message(__FILE__ "(" PG_STRINGIZE(__LINE__) "): WARNING: " #desc) + +#endif /* ~PG_PLATFORM_INTERNAL_H */ diff --git a/yap_lab_3/.venv/include/site/python3.12/pygame/pygame.h b/yap_lab_3/.venv/include/site/python3.12/pygame/pygame.h new file mode 100644 index 0000000..d7eaf73 --- /dev/null +++ b/yap_lab_3/.venv/include/site/python3.12/pygame/pygame.h @@ -0,0 +1,32 @@ +/* + pygame - Python Game Library + Copyright (C) 2000-2001 Pete Shinners + + This library is free software; you can redistribute it and/or + modify it under the terms of the GNU Library General Public + License as published by the Free Software Foundation; either + version 2 of the License, or (at your option) any later version. + + This library is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU + Library General Public License for more details. + + You should have received a copy of the GNU Library General Public + License along with this library; if not, write to the Free + Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + + Pete Shinners + pete@shinners.org +*/ + +/* This will use PYGAMEAPI_DEFINE_SLOTS instead + * of PYGAMEAPI_EXTERN_SLOTS for base modules. + */ +#ifndef PYGAME_INTERNAL_H +#define PYGAME_INTERNAL_H + +#define PYGAME_H +#include "_pygame.h" + +#endif /* ~PYGAME_INTERNAL_H */ diff --git a/yap_lab_3/.venv/include/site/python3.12/pygame/scrap.h b/yap_lab_3/.venv/include/site/python3.12/pygame/scrap.h new file mode 100644 index 0000000..5866b56 --- /dev/null +++ b/yap_lab_3/.venv/include/site/python3.12/pygame/scrap.h @@ -0,0 +1,147 @@ +/* + pygame - Python Game Library + Copyright (C) 2006, 2007 Rene Dudfield, Marcus von Appen + + Originally put in the public domain by Sam Lantinga. + + This library is free software; you can redistribute it and/or + modify it under the terms of the GNU Library General Public + License as published by the Free Software Foundation; either + version 2 of the License, or (at your option) any later version. + + This library is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU + Library General Public License for more details. + + You should have received a copy of the GNU Library General Public + License along with this library; if not, write to the Free + Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA +*/ + +#ifndef SCRAP_H +#define SCRAP_H + +/* This is unconditionally defined in Python.h */ +#if defined(_POSIX_C_SOURCE) +#undef _POSIX_C_SOURCE +#endif + +#include + +/* Handle clipboard text and data in arbitrary formats */ + +/** + * Predefined supported pygame scrap types. + */ +#define PYGAME_SCRAP_TEXT "text/plain" +#define PYGAME_SCRAP_BMP "image/bmp" +#define PYGAME_SCRAP_PPM "image/ppm" +#define PYGAME_SCRAP_PBM "image/pbm" + +/** + * The supported scrap clipboard types. + * + * This is only relevant in a X11 environment, which supports mouse + * selections as well. For Win32 and MacOS environments the default + * clipboard is used, no matter what value is passed. + */ +typedef enum { + SCRAP_CLIPBOARD, + SCRAP_SELECTION /* only supported in X11 environments. */ +} ScrapClipType; + +/** + * Macro for initialization checks. + */ +#define PYGAME_SCRAP_INIT_CHECK() \ + if (!pygame_scrap_initialized()) \ + return (PyErr_SetString(pgExc_SDLError, "scrap system not initialized."), \ + NULL) + +/** + * \brief Checks, whether the pygame scrap module was initialized. + * + * \return 1 if the modules was initialized, 0 otherwise. + */ +extern int +pygame_scrap_initialized(void); + +/** + * \brief Initializes the pygame scrap module internals. Call this before any + * other method. + * + * \return 1 on successful initialization, 0 otherwise. + */ +extern int +pygame_scrap_init(void); + +/** + * \brief Checks, whether the pygame window lost the clipboard focus or not. + * + * \return 1 if the window lost the focus, 0 otherwise. + */ +extern int +pygame_scrap_lost(void); + +/** + * \brief Places content of a specific type into the clipboard. + * + * \note For X11 the following notes are important: The following types + * are reserved for internal usage and thus will throw an error on + * setting them: "TIMESTAMP", "TARGETS", "SDL_SELECTION". + * Setting PYGAME_SCRAP_TEXT ("text/plain") will also automatically + * set the X11 types "STRING" (XA_STRING), "TEXT" and "UTF8_STRING". + * + * For Win32 the following notes are important: Setting + * PYGAME_SCRAP_TEXT ("text/plain") will also automatically set + * the Win32 type "TEXT" (CF_TEXT). + * + * For QNX the following notes are important: Setting + * PYGAME_SCRAP_TEXT ("text/plain") will also automatically set + * the QNX type "TEXT" (Ph_CL_TEXT). + * + * \param type The type of the content. + * \param srclen The length of the content. + * \param src The NULL terminated content. + * \return 1, if the content could be successfully pasted into the clipboard, + * 0 otherwise. + */ +extern int +pygame_scrap_put(char *type, Py_ssize_t srclen, char *src); + +/** + * \brief Gets the current content from the clipboard. + * + * \note The received content does not need to be the content previously + * placed in the clipboard using pygame_put_scrap(). See the + * pygame_put_scrap() notes for more details. + * + * \param type The type of the content to receive. + * \param count The size of the returned content. + * \return The content or NULL in case of an error or if no content of the + * specified type was available. + */ +extern char * +pygame_scrap_get(char *type, size_t *count); + +/** + * \brief Gets the currently available content types from the clipboard. + * + * \return The different available content types or NULL in case of an + * error or if no content type is available. + */ +extern char ** +pygame_scrap_get_types(void); + +/** + * \brief Checks whether content for the specified scrap type is currently + * available in the clipboard. + * + * \param type The type to check for. + * \return 1, if there is content and 0 otherwise. + */ +extern int +pygame_scrap_contains(char *type); + +#endif /* SCRAP_H */ diff --git a/yap_lab_3/.venv/include/site/python3.12/pygame/simd_blitters.h b/yap_lab_3/.venv/include/site/python3.12/pygame/simd_blitters.h new file mode 100644 index 0000000..da0ecbb --- /dev/null +++ b/yap_lab_3/.venv/include/site/python3.12/pygame/simd_blitters.h @@ -0,0 +1,84 @@ +#define NO_PYGAME_C_API +#include "_surface.h" +#include "_blit_info.h" + +#if !defined(PG_ENABLE_ARM_NEON) && defined(__aarch64__) +// arm64 has neon optimisations enabled by default, even when fpu=neon is not +// passed +#define PG_ENABLE_ARM_NEON 1 +#endif + +int +pg_sse2_at_runtime_but_uncompiled(); +int +pg_neon_at_runtime_but_uncompiled(); +int +pg_avx2_at_runtime_but_uncompiled(); + +#if (defined(__SSE2__) || defined(PG_ENABLE_ARM_NEON)) +void +alphablit_alpha_sse2_argb_surf_alpha(SDL_BlitInfo *info); +void +alphablit_alpha_sse2_argb_no_surf_alpha(SDL_BlitInfo *info); +void +alphablit_alpha_sse2_argb_no_surf_alpha_opaque_dst(SDL_BlitInfo *info); +void +blit_blend_rgba_mul_sse2(SDL_BlitInfo *info); +void +blit_blend_rgb_mul_sse2(SDL_BlitInfo *info); +void +blit_blend_rgba_add_sse2(SDL_BlitInfo *info); +void +blit_blend_rgb_add_sse2(SDL_BlitInfo *info); +void +blit_blend_rgba_sub_sse2(SDL_BlitInfo *info); +void +blit_blend_rgb_sub_sse2(SDL_BlitInfo *info); +void +blit_blend_rgba_max_sse2(SDL_BlitInfo *info); +void +blit_blend_rgb_max_sse2(SDL_BlitInfo *info); +void +blit_blend_rgba_min_sse2(SDL_BlitInfo *info); +void +blit_blend_rgb_min_sse2(SDL_BlitInfo *info); +void +blit_blend_premultiplied_sse2(SDL_BlitInfo *info); +#endif /* (defined(__SSE2__) || defined(PG_ENABLE_ARM_NEON)) */ + +/* Deliberately putting these outside of the preprocessor guards as I want to + move to a system of trusting the runtime checks to head to the right + function and having a fallback function there if pygame is not compiled + with the right stuff (this is the strategy used for AVX2 right now. + Potentially I might want to shift both these into a slightly different + file as they are not exactly blits (though v. similar) - or I could rename + the SIMD trilogy of files to replace the word blit with something more + generic like surface_ops*/ + +void +premul_surf_color_by_alpha_non_simd(SDL_Surface *src, SDL_Surface *dst); +void +premul_surf_color_by_alpha_sse2(SDL_Surface *src, SDL_Surface *dst); + +int +pg_has_avx2(); +void +blit_blend_rgba_mul_avx2(SDL_BlitInfo *info); +void +blit_blend_rgb_mul_avx2(SDL_BlitInfo *info); +void +blit_blend_rgba_add_avx2(SDL_BlitInfo *info); +void +blit_blend_rgb_add_avx2(SDL_BlitInfo *info); +void +blit_blend_rgba_sub_avx2(SDL_BlitInfo *info); +void +blit_blend_rgb_sub_avx2(SDL_BlitInfo *info); +void +blit_blend_rgba_max_avx2(SDL_BlitInfo *info); +void +blit_blend_rgb_max_avx2(SDL_BlitInfo *info); +void +blit_blend_rgba_min_avx2(SDL_BlitInfo *info); +void +blit_blend_rgb_min_avx2(SDL_BlitInfo *info); diff --git a/yap_lab_3/.venv/include/site/python3.12/pygame/surface.h b/yap_lab_3/.venv/include/site/python3.12/pygame/surface.h new file mode 100644 index 0000000..21508c6 --- /dev/null +++ b/yap_lab_3/.venv/include/site/python3.12/pygame/surface.h @@ -0,0 +1,361 @@ +/* + pygame - Python Game Library + Copyright (C) 2000-2001 Pete Shinners + Copyright (C) 2007 Marcus von Appen + + This library is free software; you can redistribute it and/or + modify it under the terms of the GNU Library General Public + License as published by the Free Software Foundation; either + version 2 of the License, or (at your option) any later version. + + This library is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU + Library General Public License for more details. + + You should have received a copy of the GNU Library General Public + License along with this library; if not, write to the Free + Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + + Pete Shinners + pete@shinners.org +*/ + +#ifndef SURFACE_H +#define SURFACE_H + +/* This is defined in SDL.h */ +#if defined(_POSIX_C_SOURCE) +#undef _POSIX_C_SOURCE +#endif + +#include +#include "pygame.h" + +/* Blend modes */ +#define PYGAME_BLEND_ADD 0x1 +#define PYGAME_BLEND_SUB 0x2 +#define PYGAME_BLEND_MULT 0x3 +#define PYGAME_BLEND_MIN 0x4 +#define PYGAME_BLEND_MAX 0x5 + +#define PYGAME_BLEND_RGB_ADD 0x1 +#define PYGAME_BLEND_RGB_SUB 0x2 +#define PYGAME_BLEND_RGB_MULT 0x3 +#define PYGAME_BLEND_RGB_MIN 0x4 +#define PYGAME_BLEND_RGB_MAX 0x5 + +#define PYGAME_BLEND_RGBA_ADD 0x6 +#define PYGAME_BLEND_RGBA_SUB 0x7 +#define PYGAME_BLEND_RGBA_MULT 0x8 +#define PYGAME_BLEND_RGBA_MIN 0x9 +#define PYGAME_BLEND_RGBA_MAX 0x10 +#define PYGAME_BLEND_PREMULTIPLIED 0x11 +#define PYGAME_BLEND_ALPHA_SDL2 0x12 + +#if SDL_BYTEORDER == SDL_LIL_ENDIAN +#define GET_PIXEL_24(b) (b[0] + (b[1] << 8) + (b[2] << 16)) +#else +#define GET_PIXEL_24(b) (b[2] + (b[1] << 8) + (b[0] << 16)) +#endif + +#define GET_PIXEL(pxl, bpp, source) \ + switch (bpp) { \ + case 2: \ + pxl = *((Uint16 *)(source)); \ + break; \ + case 4: \ + pxl = *((Uint32 *)(source)); \ + break; \ + default: { \ + Uint8 *b = (Uint8 *)source; \ + pxl = GET_PIXEL_24(b); \ + } break; \ + } + +#define GET_PIXELVALS(_sR, _sG, _sB, _sA, px, fmt, ppa) \ + SDL_GetRGBA(px, fmt, &(_sR), &(_sG), &(_sB), &(_sA)); \ + if (!ppa) { \ + _sA = 255; \ + } + +#define GET_PIXELVALS_1(sr, sg, sb, sa, _src, _fmt) \ + sr = _fmt->palette->colors[*((Uint8 *)(_src))].r; \ + sg = _fmt->palette->colors[*((Uint8 *)(_src))].g; \ + sb = _fmt->palette->colors[*((Uint8 *)(_src))].b; \ + sa = 255; + +/* For 1 byte palette pixels */ +#define SET_PIXELVAL(px, fmt, _dR, _dG, _dB, _dA) \ + *(px) = (Uint8)SDL_MapRGBA(fmt, _dR, _dG, _dB, _dA) + +#if SDL_BYTEORDER == SDL_LIL_ENDIAN +#define SET_OFFSETS_24(or, og, ob, fmt) \ + { \ + or = (fmt->Rshift == 0 ? 0 : fmt->Rshift == 8 ? 1 : 2); \ + og = (fmt->Gshift == 0 ? 0 : fmt->Gshift == 8 ? 1 : 2); \ + ob = (fmt->Bshift == 0 ? 0 : fmt->Bshift == 8 ? 1 : 2); \ + } + +#define SET_OFFSETS_32(or, og, ob, fmt) \ + { \ + or = (fmt->Rshift == 0 ? 0 \ + : fmt->Rshift == 8 ? 1 \ + : fmt->Rshift == 16 ? 2 \ + : 3); \ + og = (fmt->Gshift == 0 ? 0 \ + : fmt->Gshift == 8 ? 1 \ + : fmt->Gshift == 16 ? 2 \ + : 3); \ + ob = (fmt->Bshift == 0 ? 0 \ + : fmt->Bshift == 8 ? 1 \ + : fmt->Bshift == 16 ? 2 \ + : 3); \ + } +#else +#define SET_OFFSETS_24(or, og, ob, fmt) \ + { \ + or = (fmt->Rshift == 0 ? 2 : fmt->Rshift == 8 ? 1 : 0); \ + og = (fmt->Gshift == 0 ? 2 : fmt->Gshift == 8 ? 1 : 0); \ + ob = (fmt->Bshift == 0 ? 2 : fmt->Bshift == 8 ? 1 : 0); \ + } + +#define SET_OFFSETS_32(or, og, ob, fmt) \ + { \ + or = (fmt->Rshift == 0 ? 3 \ + : fmt->Rshift == 8 ? 2 \ + : fmt->Rshift == 16 ? 1 \ + : 0); \ + og = (fmt->Gshift == 0 ? 3 \ + : fmt->Gshift == 8 ? 2 \ + : fmt->Gshift == 16 ? 1 \ + : 0); \ + ob = (fmt->Bshift == 0 ? 3 \ + : fmt->Bshift == 8 ? 2 \ + : fmt->Bshift == 16 ? 1 \ + : 0); \ + } +#endif + +#define CREATE_PIXEL(buf, r, g, b, a, bp, ft) \ + switch (bp) { \ + case 2: \ + *((Uint16 *)(buf)) = ((r >> ft->Rloss) << ft->Rshift) | \ + ((g >> ft->Gloss) << ft->Gshift) | \ + ((b >> ft->Bloss) << ft->Bshift) | \ + ((a >> ft->Aloss) << ft->Ashift); \ + break; \ + case 4: \ + *((Uint32 *)(buf)) = ((r >> ft->Rloss) << ft->Rshift) | \ + ((g >> ft->Gloss) << ft->Gshift) | \ + ((b >> ft->Bloss) << ft->Bshift) | \ + ((a >> ft->Aloss) << ft->Ashift); \ + break; \ + } + +/* Pretty good idea from Tom Duff :-). */ +#define LOOP_UNROLLED4(code, n, width) \ + n = (width + 3) / 4; \ + switch (width & 3) { \ + case 0: \ + do { \ + code; \ + case 3: \ + code; \ + case 2: \ + code; \ + case 1: \ + code; \ + } while (--n > 0); \ + } + +/* Used in the srcbpp == dstbpp == 1 blend functions */ +#define REPEAT_3(code) \ + code; \ + code; \ + code; + +#define REPEAT_4(code) \ + code; \ + code; \ + code; \ + code; + +#define BLEND_ADD(tmp, sR, sG, sB, sA, dR, dG, dB, dA) \ + tmp = dR + sR; \ + dR = (tmp <= 255 ? tmp : 255); \ + tmp = dG + sG; \ + dG = (tmp <= 255 ? tmp : 255); \ + tmp = dB + sB; \ + dB = (tmp <= 255 ? tmp : 255); + +#define BLEND_SUB(tmp, sR, sG, sB, sA, dR, dG, dB, dA) \ + tmp = dR - sR; \ + dR = (tmp >= 0 ? tmp : 0); \ + tmp = dG - sG; \ + dG = (tmp >= 0 ? tmp : 0); \ + tmp = dB - sB; \ + dB = (tmp >= 0 ? tmp : 0); + +#define BLEND_MULT(sR, sG, sB, sA, dR, dG, dB, dA) \ + dR = (dR && sR) ? ((dR * sR) + 255) >> 8 : 0; \ + dG = (dG && sG) ? ((dG * sG) + 255) >> 8 : 0; \ + dB = (dB && sB) ? ((dB * sB) + 255) >> 8 : 0; + +#define BLEND_MIN(sR, sG, sB, sA, dR, dG, dB, dA) \ + if (sR < dR) { \ + dR = sR; \ + } \ + if (sG < dG) { \ + dG = sG; \ + } \ + if (sB < dB) { \ + dB = sB; \ + } + +#define BLEND_MAX(sR, sG, sB, sA, dR, dG, dB, dA) \ + if (sR > dR) { \ + dR = sR; \ + } \ + if (sG > dG) { \ + dG = sG; \ + } \ + if (sB > dB) { \ + dB = sB; \ + } + +#define BLEND_RGBA_ADD(tmp, sR, sG, sB, sA, dR, dG, dB, dA) \ + tmp = dR + sR; \ + dR = (tmp <= 255 ? tmp : 255); \ + tmp = dG + sG; \ + dG = (tmp <= 255 ? tmp : 255); \ + tmp = dB + sB; \ + dB = (tmp <= 255 ? tmp : 255); \ + tmp = dA + sA; \ + dA = (tmp <= 255 ? tmp : 255); + +#define BLEND_RGBA_SUB(tmp, sR, sG, sB, sA, dR, dG, dB, dA) \ + tmp = dR - sR; \ + dR = (tmp >= 0 ? tmp : 0); \ + tmp = dG - sG; \ + dG = (tmp >= 0 ? tmp : 0); \ + tmp = dB - sB; \ + dB = (tmp >= 0 ? tmp : 0); \ + tmp = dA - sA; \ + dA = (tmp >= 0 ? tmp : 0); + +#define BLEND_RGBA_MULT(sR, sG, sB, sA, dR, dG, dB, dA) \ + dR = (dR && sR) ? ((dR * sR) + 255) >> 8 : 0; \ + dG = (dG && sG) ? ((dG * sG) + 255) >> 8 : 0; \ + dB = (dB && sB) ? ((dB * sB) + 255) >> 8 : 0; \ + dA = (dA && sA) ? ((dA * sA) + 255) >> 8 : 0; + +#define BLEND_RGBA_MIN(sR, sG, sB, sA, dR, dG, dB, dA) \ + if (sR < dR) { \ + dR = sR; \ + } \ + if (sG < dG) { \ + dG = sG; \ + } \ + if (sB < dB) { \ + dB = sB; \ + } \ + if (sA < dA) { \ + dA = sA; \ + } + +#define BLEND_RGBA_MAX(sR, sG, sB, sA, dR, dG, dB, dA) \ + if (sR > dR) { \ + dR = sR; \ + } \ + if (sG > dG) { \ + dG = sG; \ + } \ + if (sB > dB) { \ + dB = sB; \ + } \ + if (sA > dA) { \ + dA = sA; \ + } + +#if 1 +/* Choose an alpha blend equation. If the sign is preserved on a right shift + * then use a specialized, faster, equation. Otherwise a more general form, + * where all additions are done before the shift, is needed. + */ +#if (-1 >> 1) < 0 +#define ALPHA_BLEND_COMP(sC, dC, sA) ((((sC - dC) * sA + sC) >> 8) + dC) +#else +#define ALPHA_BLEND_COMP(sC, dC, sA) (((dC << 8) + (sC - dC) * sA + sC) >> 8) +#endif + +#define ALPHA_BLEND(sR, sG, sB, sA, dR, dG, dB, dA) \ + do { \ + if (dA) { \ + dR = ALPHA_BLEND_COMP(sR, dR, sA); \ + dG = ALPHA_BLEND_COMP(sG, dG, sA); \ + dB = ALPHA_BLEND_COMP(sB, dB, sA); \ + dA = sA + dA - ((sA * dA) / 255); \ + } \ + else { \ + dR = sR; \ + dG = sG; \ + dB = sB; \ + dA = sA; \ + } \ + } while (0) + +#define ALPHA_BLEND_PREMULTIPLIED_COMP(sC, dC, sA) \ + (sC + dC - ((dC + 1) * sA >> 8)) + +#define ALPHA_BLEND_PREMULTIPLIED(tmp, sR, sG, sB, sA, dR, dG, dB, dA) \ + do { \ + dR = ALPHA_BLEND_PREMULTIPLIED_COMP(sR, dR, sA); \ + dG = ALPHA_BLEND_PREMULTIPLIED_COMP(sG, dG, sA); \ + dB = ALPHA_BLEND_PREMULTIPLIED_COMP(sB, dB, sA); \ + dA = ALPHA_BLEND_PREMULTIPLIED_COMP(sA, dA, sA); \ + } while (0) +#elif 0 + +#define ALPHA_BLEND(sR, sG, sB, sA, dR, dG, dB, dA) \ + do { \ + if (sA) { \ + if (dA && sA < 255) { \ + int dContrib = dA * (255 - sA) / 255; \ + dA = sA + dA - ((sA * dA) / 255); \ + dR = (dR * dContrib + sR * sA) / dA; \ + dG = (dG * dContrib + sG * sA) / dA; \ + dB = (dB * dContrib + sB * sA) / dA; \ + } \ + else { \ + dR = sR; \ + dG = sG; \ + dB = sB; \ + dA = sA; \ + } \ + } \ + } while (0) +#endif + +int +surface_fill_blend(SDL_Surface *surface, SDL_Rect *rect, Uint32 color, + int blendargs); + +void +surface_respect_clip_rect(SDL_Surface *surface, SDL_Rect *rect); + +int +pygame_AlphaBlit(SDL_Surface *src, SDL_Rect *srcrect, SDL_Surface *dst, + SDL_Rect *dstrect, int the_args); + +int +pygame_Blit(SDL_Surface *src, SDL_Rect *srcrect, SDL_Surface *dst, + SDL_Rect *dstrect, int the_args); + +int +premul_surf_color_by_alpha(SDL_Surface *src, SDL_Surface *dst); + +int +pg_warn_simd_at_runtime_but_uncompiled(); + +#endif /* SURFACE_H */ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip-25.0.1.dist-info/AUTHORS.txt b/yap_lab_3/.venv/lib/python3.12/site-packages/pip-25.0.1.dist-info/AUTHORS.txt new file mode 100644 index 0000000..f42daec --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip-25.0.1.dist-info/AUTHORS.txt @@ -0,0 +1,806 @@ +@Switch01 +A_Rog +Aakanksha Agrawal +Abhinav Sagar +ABHYUDAY PRATAP SINGH +abs51295 +AceGentile +Adam Chainz +Adam Tse +Adam Wentz +admin +Adolfo Ochagavía +Adrien Morison +Agus +ahayrapetyan +Ahilya +AinsworthK +Akash Srivastava +Alan Yee +Albert Tugushev +Albert-Guan +albertg +Alberto Sottile +Aleks Bunin +Ales Erjavec +Alethea Flowers +Alex Gaynor +Alex Grönholm +Alex Hedges +Alex Loosley +Alex Morega +Alex Stachowiak +Alexander Shtyrov +Alexandre Conrad +Alexey Popravka +Aleš Erjavec +Alli +Ami Fischman +Ananya Maiti +Anatoly Techtonik +Anders Kaseorg +Andre Aguiar +Andreas Lutro +Andrei Geacar +Andrew Gaul +Andrew Shymanel +Andrey Bienkowski +Andrey Bulgakov +Andrés Delfino +Andy Freeland +Andy Kluger +Ani Hayrapetyan +Aniruddha Basak +Anish Tambe +Anrs Hu +Anthony Sottile +Antoine Musso +Anton Ovchinnikov +Anton Patrushev +Anton Zelenov +Antonio Alvarado Hernandez +Antony Lee +Antti Kaihola +Anubhav Patel +Anudit Nagar +Anuj Godase +AQNOUCH Mohammed +AraHaan +arena +arenasys +Arindam Choudhury +Armin Ronacher +Arnon Yaari +Artem +Arun Babu Neelicattu +Ashley Manton +Ashwin Ramaswami +atse +Atsushi Odagiri +Avinash Karhana +Avner Cohen +Awit (Ah-Wit) Ghirmai +Baptiste Mispelon +Barney Gale +barneygale +Bartek Ogryczak +Bastian Venthur +Ben Bodenmiller +Ben Darnell +Ben Hoyt +Ben Mares +Ben Rosser +Bence Nagy +Benjamin Peterson +Benjamin VanEvery +Benoit Pierre +Berker Peksag +Bernard +Bernard Tyers +Bernardo B. Marques +Bernhard M. Wiedemann +Bertil Hatt +Bhavam Vidyarthi +Blazej Michalik +Bogdan Opanchuk +BorisZZZ +Brad Erickson +Bradley Ayers +Branch Vincent +Brandon L. Reiss +Brandt Bucher +Brannon Dorsey +Brett Randall +Brett Rosen +Brian Cristante +Brian Rosner +briantracy +BrownTruck +Bruno Oliveira +Bruno Renié +Bruno S +Bstrdsmkr +Buck Golemon +burrows +Bussonnier Matthias +bwoodsend +c22 +Caleb Brown +Caleb Martinez +Calvin Smith +Carl Meyer +Carlos Liam +Carol Willing +Carter Thayer +Cass +Chandrasekhar Atina +Charlie Marsh +charwick +Chih-Hsuan Yen +Chris Brinker +Chris Hunt +Chris Jerdonek +Chris Kuehl +Chris Markiewicz +Chris McDonough +Chris Pawley +Chris Pryer +Chris Wolfe +Christian Clauss +Christian Heimes +Christian Oudard +Christoph Reiter +Christopher Hunt +Christopher Snyder +chrysle +cjc7373 +Clark Boylan +Claudio Jolowicz +Clay McClure +Cody +Cody Soyland +Colin Watson +Collin Anderson +Connor Osborn +Cooper Lees +Cooper Ry Lees +Cory Benfield +Cory Wright +Craig Kerstiens +Cristian Sorinel +Cristina +Cristina Muñoz +ctg123 +Curtis Doty +cytolentino +Daan De Meyer +Dale +Damian +Damian Quiroga +Damian Shaw +Dan Black +Dan Savilonis +Dan Sully +Dane Hillard +daniel +Daniel Collins +Daniel Hahler +Daniel Holth +Daniel Jost +Daniel Katz +Daniel Shaulov +Daniele Esposti +Daniele Nicolodi +Daniele Procida +Daniil Konovalenko +Danny Hermes +Danny McClanahan +Darren Kavanagh +Dav Clark +Dave Abrahams +Dave Jones +David Aguilar +David Black +David Bordeynik +David Caro +David D Lowe +David Evans +David Hewitt +David Linke +David Poggi +David Poznik +David Pursehouse +David Runge +David Tucker +David Wales +Davidovich +ddelange +Deepak Sharma +Deepyaman Datta +Denise Yu +dependabot[bot] +derwolfe +Desetude +Devesh Kumar Singh +devsagul +Diego Caraballo +Diego Ramirez +DiegoCaraballo +Dimitri Merejkowsky +Dimitri Papadopoulos +Dimitri Papadopoulos Orfanos +Dirk Stolle +Dmitry Gladkov +Dmitry Volodin +Domen Kožar +Dominic Davis-Foster +Donald Stufft +Dongweiming +doron zarhi +Dos Moonen +Douglas Thor +DrFeathers +Dustin Ingram +Dustin Rodrigues +Dwayne Bailey +Ed Morley +Edgar Ramírez +Edgar Ramírez Mondragón +Ee Durbin +Efflam Lemaillet +efflamlemaillet +Eitan Adler +ekristina +elainechan +Eli Schwartz +Elisha Hollander +Ellen Marie Dash +Emil Burzo +Emil Styrke +Emmanuel Arias +Endoh Takanao +enoch +Erdinc Mutlu +Eric Cousineau +Eric Gillingham +Eric Hanchrow +Eric Hopper +Erik M. Bray +Erik Rose +Erwin Janssen +Eugene Vereshchagin +everdimension +Federico +Felipe Peter +Felix Yan +fiber-space +Filip Kokosiński +Filipe Laíns +Finn Womack +finnagin +Flavio Amurrio +Florian Briand +Florian Rathgeber +Francesco +Francesco Montesano +Fredrik Orderud +Frost Ming +Gabriel Curio +Gabriel de Perthuis +Garry Polley +gavin +gdanielson +Geoffrey Sneddon +George Song +Georgi Valkov +Georgy Pchelkin +ghost +Giftlin Rajaiah +gizmoguy1 +gkdoc +Godefroid Chapelle +Gopinath M +GOTO Hayato +gousaiyang +gpiks +Greg Roodt +Greg Ward +Guilherme Espada +Guillaume Seguin +gutsytechster +Guy Rozendorn +Guy Tuval +gzpan123 +Hanjun Kim +Hari Charan +Harsh Vardhan +harupy +Harutaka Kawamura +hauntsaninja +Henrich Hartzer +Henry Schreiner +Herbert Pfennig +Holly Stotelmyer +Honnix +Hsiaoming Yang +Hugo Lopes Tavares +Hugo van Kemenade +Hugues Bruant +Hynek Schlawack +Ian Bicking +Ian Cordasco +Ian Lee +Ian Stapleton Cordasco +Ian Wienand +Igor Kuzmitshov +Igor Sobreira +Ikko Ashimine +Ilan Schnell +Illia Volochii +Ilya Baryshev +Inada Naoki +Ionel Cristian Mărieș +Ionel Maries Cristian +Itamar Turner-Trauring +Ivan Pozdeev +J. Nick Koston +Jacob Kim +Jacob Walls +Jaime Sanz +jakirkham +Jakub Kuczys +Jakub Stasiak +Jakub Vysoky +Jakub Wilk +James Cleveland +James Curtin +James Firth +James Gerity +James Polley +Jan Pokorný +Jannis Leidel +Jarek Potiuk +jarondl +Jason Curtis +Jason R. Coombs +JasonMo +JasonMo1 +Jay Graves +Jean Abou Samra +Jean-Christophe Fillion-Robin +Jeff Barber +Jeff Dairiki +Jeff Widman +Jelmer Vernooij +jenix21 +Jeremy Fleischman +Jeremy Stanley +Jeremy Zafran +Jesse Rittner +Jiashuo Li +Jim Fisher +Jim Garrison +Jinzhe Zeng +Jiun Bae +Jivan Amara +Joe Bylund +Joe Michelini +John Paton +John Sirois +John T. Wodder II +John-Scott Atlakson +johnthagen +Jon Banafato +Jon Dufresne +Jon Parise +Jonas Nockert +Jonathan Herbert +Joonatan Partanen +Joost Molenaar +Jorge Niedbalski +Joseph Bylund +Joseph Long +Josh Bronson +Josh Cannon +Josh Hansen +Josh Schneier +Joshua +JoshuaPerdue +Juan Luis Cano Rodríguez +Juanjo Bazán +Judah Rand +Julian Berman +Julian Gethmann +Julien Demoor +July Tikhonov +Jussi Kukkonen +Justin van Heek +jwg4 +Jyrki Pulliainen +Kai Chen +Kai Mueller +Kamal Bin Mustafa +Karolina Surma +kasium +kaustav haldar +keanemind +Keith Maxwell +Kelsey Hightower +Kenneth Belitzky +Kenneth Reitz +Kevin Burke +Kevin Carter +Kevin Frommelt +Kevin R Patterson +Kexuan Sun +Kit Randel +Klaas van Schelven +KOLANICH +konstin +kpinc +Krishna Oza +Kumar McMillan +Kuntal Majumder +Kurt McKee +Kyle Persohn +lakshmanaram +Laszlo Kiss-Kollar +Laurent Bristiel +Laurent LAPORTE +Laurie O +Laurie Opperman +layday +Leon Sasson +Lev Givon +Lincoln de Sousa +Lipis +lorddavidiii +Loren Carvalho +Lucas Cimon +Ludovic Gasc +Luis Medel +Lukas Geiger +Lukas Juhrich +Luke Macken +Luo Jiebin +luojiebin +luz.paz +László Kiss Kollár +M00nL1ght +Marc Abramowitz +Marc Tamlyn +Marcus Smith +Mariatta +Mark Kohler +Mark McLoughlin +Mark Williams +Markus Hametner +Martey Dodoo +Martin Fischer +Martin Häcker +Martin Pavlasek +Masaki +Masklinn +Matej Stuchlik +Mathew Jennings +Mathieu Bridon +Mathieu Kniewallner +Matt Bacchi +Matt Good +Matt Maker +Matt Robenolt +Matt Wozniski +matthew +Matthew Einhorn +Matthew Feickert +Matthew Gilliard +Matthew Hughes +Matthew Iversen +Matthew Treinish +Matthew Trumbell +Matthew Willson +Matthias Bussonnier +mattip +Maurits van Rees +Max W Chase +Maxim Kurnikov +Maxime Rouyrre +mayeut +mbaluna +mdebi +memoselyk +meowmeowcat +Michael +Michael Aquilina +Michael E. Karpeles +Michael Klich +Michael Mintz +Michael Williamson +michaelpacer +Michał Górny +Mickaël Schoentgen +Miguel Araujo Perez +Mihir Singh +Mike +Mike Hendricks +Min RK +MinRK +Miro Hrončok +Monica Baluna +montefra +Monty Taylor +morotti +mrKazzila +Muha Ajjan +Nadav Wexler +Nahuel Ambrosini +Nate Coraor +Nate Prewitt +Nathan Houghton +Nathaniel J. Smith +Nehal J Wani +Neil Botelho +Nguyễn Gia Phong +Nicholas Serra +Nick Coghlan +Nick Stenning +Nick Timkovich +Nicolas Bock +Nicole Harris +Nikhil Benesch +Nikhil Ladha +Nikita Chepanov +Nikolay Korolev +Nipunn Koorapati +Nitesh Sharma +Niyas Sait +Noah +Noah Gorny +Nowell Strite +NtaleGrey +nvdv +OBITORASU +Ofek Lev +ofrinevo +Oliver Freund +Oliver Jeeves +Oliver Mannion +Oliver Tonnhofer +Olivier Girardot +Olivier Grisel +Ollie Rutherfurd +OMOTO Kenji +Omry Yadan +onlinejudge95 +Oren Held +Oscar Benjamin +Oz N Tiram +Pachwenko +Patrick Dubroy +Patrick Jenkins +Patrick Lawson +patricktokeeffe +Patrik Kopkan +Paul Ganssle +Paul Kehrer +Paul Moore +Paul Nasrat +Paul Oswald +Paul van der Linden +Paulus Schoutsen +Pavel Safronov +Pavithra Eswaramoorthy +Pawel Jasinski +Paweł Szramowski +Pekka Klärck +Peter Gessler +Peter Lisák +Peter Shen +Peter Waller +Petr Viktorin +petr-tik +Phaneendra Chiruvella +Phil Elson +Phil Freo +Phil Pennock +Phil Whelan +Philip Jägenstedt +Philip Molloy +Philippe Ombredanne +Pi Delport +Pierre-Yves Rofes +Pieter Degroote +pip +Prabakaran Kumaresshan +Prabhjyotsing Surjit Singh Sodhi +Prabhu Marappan +Pradyun Gedam +Prashant Sharma +Pratik Mallya +pre-commit-ci[bot] +Preet Thakkar +Preston Holmes +Przemek Wrzos +Pulkit Goyal +q0w +Qiangning Hong +Qiming Xu +Quentin Lee +Quentin Pradet +R. David Murray +Rafael Caricio +Ralf Schmitt +Ran Benita +Randy Döring +Razzi Abuissa +rdb +Reece Dunham +Remi Rampin +Rene Dudfield +Riccardo Magliocchetti +Riccardo Schirone +Richard Jones +Richard Si +Ricky Ng-Adam +Rishi +rmorotti +RobberPhex +Robert Collins +Robert McGibbon +Robert Pollak +Robert T. McGibbon +robin elisha robinson +Roey Berman +Rohan Jain +Roman Bogorodskiy +Roman Donchenko +Romuald Brunet +ronaudinho +Ronny Pfannschmidt +Rory McCann +Ross Brattain +Roy Wellington Ⅳ +Ruairidh MacLeod +Russell Keith-Magee +Ryan Shepherd +Ryan Wooden +ryneeverett +S. Guliaev +Sachi King +Salvatore Rinchiera +sandeepkiran-js +Sander Van Balen +Savio Jomton +schlamar +Scott Kitterman +Sean +seanj +Sebastian Jordan +Sebastian Schaetz +Segev Finer +SeongSoo Cho +Sergey Vasilyev +Seth Michael Larson +Seth Woodworth +Shahar Epstein +Shantanu +shenxianpeng +shireenrao +Shivansh-007 +Shixian Sheng +Shlomi Fish +Shovan Maity +Simeon Visser +Simon Cross +Simon Pichugin +sinoroc +sinscary +snook92 +socketubs +Sorin Sbarnea +Srinivas Nyayapati +Srishti Hegde +Stavros Korokithakis +Stefan Scherfke +Stefano Rivera +Stephan Erb +Stephen Rosen +stepshal +Steve (Gadget) Barnes +Steve Barnes +Steve Dower +Steve Kowalik +Steven Myint +Steven Silvester +stonebig +studioj +Stéphane Bidoul +Stéphane Bidoul (ACSONE) +Stéphane Klein +Sumana Harihareswara +Surbhi Sharma +Sviatoslav Sydorenko +Sviatoslav Sydorenko (Святослав Сидоренко) +Swat009 +Sylvain +Takayuki SHIMIZUKAWA +Taneli Hukkinen +tbeswick +Thiago +Thijs Triemstra +Thomas Fenzl +Thomas Grainger +Thomas Guettler +Thomas Johansson +Thomas Kluyver +Thomas Smith +Thomas VINCENT +Tim D. Smith +Tim Gates +Tim Harder +Tim Heap +tim smith +tinruufu +Tobias Hermann +Tom Forbes +Tom Freudenheim +Tom V +Tomas Hrnciar +Tomas Orsava +Tomer Chachamu +Tommi Enenkel | AnB +Tomáš Hrnčiar +Tony Beswick +Tony Narlock +Tony Zhaocheng Tan +TonyBeswick +toonarmycaptain +Toshio Kuratomi +toxinu +Travis Swicegood +Tushar Sadhwani +Tzu-ping Chung +Valentin Haenel +Victor Stinner +victorvpaulo +Vikram - Google +Viktor Szépe +Ville Skyttä +Vinay Sajip +Vincent Philippon +Vinicyus Macedo +Vipul Kumar +Vitaly Babiy +Vladimir Fokow +Vladimir Rutsky +W. Trevor King +Wil Tan +Wilfred Hughes +William Edwards +William ML Leslie +William T Olson +William Woodruff +Wilson Mo +wim glenn +Winson Luk +Wolfgang Maier +Wu Zhenyu +XAMES3 +Xavier Fernandez +Xianpeng Shen +xoviat +xtreak +YAMAMOTO Takashi +Yen Chi Hsuan +Yeray Diaz Diaz +Yoval P +Yu Jian +Yuan Jing Vincent Yan +Yusuke Hayashi +Zearin +Zhiping Deng +ziebam +Zvezdan Petkovic +Łukasz Langa +Роман Донченко +Семён Марьясин diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip-25.0.1.dist-info/INSTALLER b/yap_lab_3/.venv/lib/python3.12/site-packages/pip-25.0.1.dist-info/INSTALLER new file mode 100644 index 0000000..a1b589e --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip-25.0.1.dist-info/INSTALLER @@ -0,0 +1 @@ +pip diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip-25.0.1.dist-info/LICENSE.txt b/yap_lab_3/.venv/lib/python3.12/site-packages/pip-25.0.1.dist-info/LICENSE.txt new file mode 100644 index 0000000..8e7b65e --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip-25.0.1.dist-info/LICENSE.txt @@ -0,0 +1,20 @@ +Copyright (c) 2008-present The pip developers (see AUTHORS.txt file) + +Permission is hereby granted, free of charge, to any person obtaining +a copy of this software and associated documentation files (the +"Software"), to deal in the Software without restriction, including +without limitation the rights to use, copy, modify, merge, publish, +distribute, sublicense, and/or sell copies of the Software, and to +permit persons to whom the Software is furnished to do so, subject to +the following conditions: + +The above copyright notice and this permission notice shall be +included in all copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, +EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF +MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND +NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE +LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION +OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION +WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip-25.0.1.dist-info/METADATA b/yap_lab_3/.venv/lib/python3.12/site-packages/pip-25.0.1.dist-info/METADATA new file mode 100644 index 0000000..3315c06 --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip-25.0.1.dist-info/METADATA @@ -0,0 +1,90 @@ +Metadata-Version: 2.2 +Name: pip +Version: 25.0.1 +Summary: The PyPA recommended tool for installing Python packages. +Author-email: The pip developers +License: MIT +Project-URL: Homepage, https://pip.pypa.io/ +Project-URL: Documentation, https://pip.pypa.io +Project-URL: Source, https://github.com/pypa/pip +Project-URL: Changelog, https://pip.pypa.io/en/stable/news/ +Classifier: Development Status :: 5 - Production/Stable +Classifier: Intended Audience :: Developers +Classifier: License :: OSI Approved :: MIT License +Classifier: Topic :: Software Development :: Build Tools +Classifier: Programming Language :: Python +Classifier: Programming Language :: Python :: 3 +Classifier: Programming Language :: Python :: 3 :: Only +Classifier: Programming Language :: Python :: 3.8 +Classifier: Programming Language :: Python :: 3.9 +Classifier: Programming Language :: Python :: 3.10 +Classifier: Programming Language :: Python :: 3.11 +Classifier: Programming Language :: Python :: 3.12 +Classifier: Programming Language :: Python :: 3.13 +Classifier: Programming Language :: Python :: Implementation :: CPython +Classifier: Programming Language :: Python :: Implementation :: PyPy +Requires-Python: >=3.8 +Description-Content-Type: text/x-rst +License-File: LICENSE.txt +License-File: AUTHORS.txt + +pip - The Python Package Installer +================================== + +.. |pypi-version| image:: https://img.shields.io/pypi/v/pip.svg + :target: https://pypi.org/project/pip/ + :alt: PyPI + +.. |python-versions| image:: https://img.shields.io/pypi/pyversions/pip + :target: https://pypi.org/project/pip + :alt: PyPI - Python Version + +.. |docs-badge| image:: https://readthedocs.org/projects/pip/badge/?version=latest + :target: https://pip.pypa.io/en/latest + :alt: Documentation + +|pypi-version| |python-versions| |docs-badge| + +pip is the `package installer`_ for Python. You can use pip to install packages from the `Python Package Index`_ and other indexes. + +Please take a look at our documentation for how to install and use pip: + +* `Installation`_ +* `Usage`_ + +We release updates regularly, with a new version every 3 months. Find more details in our documentation: + +* `Release notes`_ +* `Release process`_ + +If you find bugs, need help, or want to talk to the developers, please use our mailing lists or chat rooms: + +* `Issue tracking`_ +* `Discourse channel`_ +* `User IRC`_ + +If you want to get involved head over to GitHub to get the source code, look at our development documentation and feel free to jump on the developer mailing lists and chat rooms: + +* `GitHub page`_ +* `Development documentation`_ +* `Development IRC`_ + +Code of Conduct +--------------- + +Everyone interacting in the pip project's codebases, issue trackers, chat +rooms, and mailing lists is expected to follow the `PSF Code of Conduct`_. + +.. _package installer: https://packaging.python.org/guides/tool-recommendations/ +.. _Python Package Index: https://pypi.org +.. _Installation: https://pip.pypa.io/en/stable/installation/ +.. _Usage: https://pip.pypa.io/en/stable/ +.. _Release notes: https://pip.pypa.io/en/stable/news.html +.. _Release process: https://pip.pypa.io/en/latest/development/release-process/ +.. _GitHub page: https://github.com/pypa/pip +.. _Development documentation: https://pip.pypa.io/en/latest/development +.. _Issue tracking: https://github.com/pypa/pip/issues +.. _Discourse channel: https://discuss.python.org/c/packaging +.. _User IRC: https://kiwiirc.com/nextclient/#ircs://irc.libera.chat:+6697/pypa +.. _Development IRC: https://kiwiirc.com/nextclient/#ircs://irc.libera.chat:+6697/pypa-dev +.. _PSF Code of Conduct: https://github.com/pypa/.github/blob/main/CODE_OF_CONDUCT.md diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip-25.0.1.dist-info/RECORD b/yap_lab_3/.venv/lib/python3.12/site-packages/pip-25.0.1.dist-info/RECORD new file mode 100644 index 0000000..a92da68 --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip-25.0.1.dist-info/RECORD @@ -0,0 +1,854 @@ +../../../bin/pip,sha256=iec0Raz2U_4FII4y6z-SS49PiW89VLSyhWw_ylpTqag,250 +../../../bin/pip3,sha256=iec0Raz2U_4FII4y6z-SS49PiW89VLSyhWw_ylpTqag,250 +../../../bin/pip3.12,sha256=iec0Raz2U_4FII4y6z-SS49PiW89VLSyhWw_ylpTqag,250 +pip-25.0.1.dist-info/AUTHORS.txt,sha256=HqzpBVLfT1lBthqQfiDlVeFkg65hJ7ZQvvWhoq-BAsA,11018 +pip-25.0.1.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4 +pip-25.0.1.dist-info/LICENSE.txt,sha256=Y0MApmnUmurmWxLGxIySTFGkzfPR_whtw0VtyLyqIQQ,1093 +pip-25.0.1.dist-info/METADATA,sha256=T6cxjPMPl523zsRcEsu8K0-IoV8S7vv1mmKR0KA6-SY,3677 +pip-25.0.1.dist-info/RECORD,, +pip-25.0.1.dist-info/REQUESTED,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +pip-25.0.1.dist-info/WHEEL,sha256=In9FTNxeP60KnTkGw7wk6mJPYd_dQSjEZmXdBdMCI-8,91 +pip-25.0.1.dist-info/entry_points.txt,sha256=eeIjuzfnfR2PrhbjnbzFU6MnSS70kZLxwaHHq6M-bD0,87 +pip-25.0.1.dist-info/top_level.txt,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4 +pip/__init__.py,sha256=aKiv_sTe7UbE7qmtCinJutFjqN0MndZQZ1fKLNwFFLE,357 +pip/__main__.py,sha256=WzbhHXTbSE6gBY19mNN9m4s5o_365LOvTYSgqgbdBhE,854 +pip/__pip-runner__.py,sha256=cPPWuJ6NK_k-GzfvlejLFgwzmYUROmpAR6QC3Q-vkXQ,1450 +pip/__pycache__/__init__.cpython-312.pyc,, +pip/__pycache__/__main__.cpython-312.pyc,, +pip/__pycache__/__pip-runner__.cpython-312.pyc,, +pip/_internal/__init__.py,sha256=MfcoOluDZ8QMCFYal04IqOJ9q6m2V7a0aOsnI-WOxUo,513 +pip/_internal/__pycache__/__init__.cpython-312.pyc,, +pip/_internal/__pycache__/build_env.cpython-312.pyc,, +pip/_internal/__pycache__/cache.cpython-312.pyc,, +pip/_internal/__pycache__/configuration.cpython-312.pyc,, +pip/_internal/__pycache__/exceptions.cpython-312.pyc,, +pip/_internal/__pycache__/main.cpython-312.pyc,, +pip/_internal/__pycache__/pyproject.cpython-312.pyc,, +pip/_internal/__pycache__/self_outdated_check.cpython-312.pyc,, +pip/_internal/__pycache__/wheel_builder.cpython-312.pyc,, +pip/_internal/build_env.py,sha256=Dv4UCClSg4uNaal_hL-trg5-zl3Is9CuIDxkChCkXF4,10700 +pip/_internal/cache.py,sha256=Jb698p5PNigRtpW5o26wQNkkUv4MnQ94mc471wL63A0,10369 +pip/_internal/cli/__init__.py,sha256=FkHBgpxxb-_gd6r1FjnNhfMOzAUYyXoXKJ6abijfcFU,132 +pip/_internal/cli/__pycache__/__init__.cpython-312.pyc,, +pip/_internal/cli/__pycache__/autocompletion.cpython-312.pyc,, +pip/_internal/cli/__pycache__/base_command.cpython-312.pyc,, +pip/_internal/cli/__pycache__/cmdoptions.cpython-312.pyc,, +pip/_internal/cli/__pycache__/command_context.cpython-312.pyc,, +pip/_internal/cli/__pycache__/index_command.cpython-312.pyc,, +pip/_internal/cli/__pycache__/main.cpython-312.pyc,, +pip/_internal/cli/__pycache__/main_parser.cpython-312.pyc,, +pip/_internal/cli/__pycache__/parser.cpython-312.pyc,, +pip/_internal/cli/__pycache__/progress_bars.cpython-312.pyc,, +pip/_internal/cli/__pycache__/req_command.cpython-312.pyc,, +pip/_internal/cli/__pycache__/spinners.cpython-312.pyc,, +pip/_internal/cli/__pycache__/status_codes.cpython-312.pyc,, +pip/_internal/cli/autocompletion.py,sha256=Lli3Mr6aDNu7ZkJJFFvwD2-hFxNI6Avz8OwMyS5TVrs,6865 +pip/_internal/cli/base_command.py,sha256=NZin6KMzW9NSYzKk4Tc8isb_TQYKR4CKd5j9mSm46PI,8625 +pip/_internal/cli/cmdoptions.py,sha256=V3BB22F4_v_RkHaZ5onWnszhbBtjYZvNhbn9M0NO0HI,30116 +pip/_internal/cli/command_context.py,sha256=RHgIPwtObh5KhMrd3YZTkl8zbVG-6Okml7YbFX4Ehg0,774 +pip/_internal/cli/index_command.py,sha256=i_sgNlPmXC5iHUaY-dmmrHKKTgc5O4hWzisr5Al1rr0,5677 +pip/_internal/cli/main.py,sha256=BDZef-bWe9g9Jpr4OVs4dDf-845HJsKw835T7AqEnAc,2817 +pip/_internal/cli/main_parser.py,sha256=laDpsuBDl6kyfywp9eMMA9s84jfH2TJJn-vmL0GG90w,4338 +pip/_internal/cli/parser.py,sha256=VCMtduzECUV87KaHNu-xJ-wLNL82yT3x16V4XBxOAqI,10825 +pip/_internal/cli/progress_bars.py,sha256=9GcgusWtwfqou2zhAQp1XNbQHIDslqyyz9UwLzw7Jgc,2717 +pip/_internal/cli/req_command.py,sha256=DqeFhmUMs6o6Ev8qawAcOoYNdAZsfyKS0MZI5jsJYwQ,12250 +pip/_internal/cli/spinners.py,sha256=hIJ83GerdFgFCdobIA23Jggetegl_uC4Sp586nzFbPE,5118 +pip/_internal/cli/status_codes.py,sha256=sEFHUaUJbqv8iArL3HAtcztWZmGOFX01hTesSytDEh0,116 +pip/_internal/commands/__init__.py,sha256=5oRO9O3dM2vGuh0bFw4HOVletryrz5HHMmmPWwJrH9U,3882 +pip/_internal/commands/__pycache__/__init__.cpython-312.pyc,, +pip/_internal/commands/__pycache__/cache.cpython-312.pyc,, +pip/_internal/commands/__pycache__/check.cpython-312.pyc,, +pip/_internal/commands/__pycache__/completion.cpython-312.pyc,, +pip/_internal/commands/__pycache__/configuration.cpython-312.pyc,, +pip/_internal/commands/__pycache__/debug.cpython-312.pyc,, +pip/_internal/commands/__pycache__/download.cpython-312.pyc,, +pip/_internal/commands/__pycache__/freeze.cpython-312.pyc,, +pip/_internal/commands/__pycache__/hash.cpython-312.pyc,, +pip/_internal/commands/__pycache__/help.cpython-312.pyc,, +pip/_internal/commands/__pycache__/index.cpython-312.pyc,, +pip/_internal/commands/__pycache__/inspect.cpython-312.pyc,, +pip/_internal/commands/__pycache__/install.cpython-312.pyc,, +pip/_internal/commands/__pycache__/list.cpython-312.pyc,, +pip/_internal/commands/__pycache__/search.cpython-312.pyc,, +pip/_internal/commands/__pycache__/show.cpython-312.pyc,, +pip/_internal/commands/__pycache__/uninstall.cpython-312.pyc,, +pip/_internal/commands/__pycache__/wheel.cpython-312.pyc,, +pip/_internal/commands/cache.py,sha256=IOezTicHjGE5sWdBx2nwPVgbjuJHM3s-BZEkpZLemuY,8107 +pip/_internal/commands/check.py,sha256=Hr_4eiMd9cgVDgEvjtIdw915NmL7ROIWW8enkr8slPQ,2268 +pip/_internal/commands/completion.py,sha256=HT4lD0bgsflHq2IDgYfiEdp7IGGtE7s6MgI3xn0VQEw,4287 +pip/_internal/commands/configuration.py,sha256=n98enwp6y0b5G6fiRQjaZo43FlJKYve_daMhN-4BRNc,9766 +pip/_internal/commands/debug.py,sha256=DNDRgE9YsKrbYzU0s3VKi8rHtKF4X13CJ_br_8PUXO0,6797 +pip/_internal/commands/download.py,sha256=0qB0nys6ZEPsog451lDsjL5Bx7Z97t-B80oFZKhpzKM,5273 +pip/_internal/commands/freeze.py,sha256=2Vt72BYTSm9rzue6d8dNzt8idxWK4Db6Hd-anq7GQ80,3203 +pip/_internal/commands/hash.py,sha256=EVVOuvGtoPEdFi8SNnmdqlCQrhCxV-kJsdwtdcCnXGQ,1703 +pip/_internal/commands/help.py,sha256=gcc6QDkcgHMOuAn5UxaZwAStsRBrnGSn_yxjS57JIoM,1132 +pip/_internal/commands/index.py,sha256=RAXxmJwFhVb5S1BYzb5ifX3sn9Na8v2CCVYwSMP8pao,4731 +pip/_internal/commands/inspect.py,sha256=PGrY9TRTRCM3y5Ml8Bdk8DEOXquWRfscr4DRo1LOTPc,3189 +pip/_internal/commands/install.py,sha256=r3yHQUxvxt7gD5j9n6zRDslAvtx9CT_whLuQJcktp6M,29390 +pip/_internal/commands/list.py,sha256=oiIzSjLP6__d7dIS3q0Xb5ywsaOThBWRqMyjjKzkPdM,12769 +pip/_internal/commands/search.py,sha256=fWkUQVx_gm8ebbFAlCgqtxKXT9rNahpJ-BI__3HNZpg,5626 +pip/_internal/commands/show.py,sha256=0YBhCga3PAd81vT3l7UWflktSpB5-aYqQcJxBVPazVM,7857 +pip/_internal/commands/uninstall.py,sha256=7pOR7enK76gimyxQbzxcG1OsyLXL3DvX939xmM8Fvtg,3892 +pip/_internal/commands/wheel.py,sha256=eJRhr_qoNNxWAkkdJCNiQM7CXd4E1_YyQhsqJnBPGGg,6414 +pip/_internal/configuration.py,sha256=-KOok6jh3hFzXMPQFPJ1_EFjBpAsge-RSreQuLHLmzo,14005 +pip/_internal/distributions/__init__.py,sha256=Hq6kt6gXBgjNit5hTTWLAzeCNOKoB-N0pGYSqehrli8,858 +pip/_internal/distributions/__pycache__/__init__.cpython-312.pyc,, +pip/_internal/distributions/__pycache__/base.cpython-312.pyc,, +pip/_internal/distributions/__pycache__/installed.cpython-312.pyc,, +pip/_internal/distributions/__pycache__/sdist.cpython-312.pyc,, +pip/_internal/distributions/__pycache__/wheel.cpython-312.pyc,, +pip/_internal/distributions/base.py,sha256=QeB9qvKXDIjLdPBDE5fMgpfGqMMCr-govnuoQnGuiF8,1783 +pip/_internal/distributions/installed.py,sha256=QinHFbWAQ8oE0pbD8MFZWkwlnfU1QYTccA1vnhrlYOU,842 +pip/_internal/distributions/sdist.py,sha256=PlcP4a6-R6c98XnOM-b6Lkb3rsvh9iG4ok8shaanrzs,6751 +pip/_internal/distributions/wheel.py,sha256=THBYfnv7VVt8mYhMYUtH13S1E7FDwtDyDfmUcl8ai0E,1317 +pip/_internal/exceptions.py,sha256=2_byISIv3kSnI_9T-Esfxrt0LnTRgcUHyxu0twsHjQY,26481 +pip/_internal/index/__init__.py,sha256=vpt-JeTZefh8a-FC22ZeBSXFVbuBcXSGiILhQZJaNpQ,30 +pip/_internal/index/__pycache__/__init__.cpython-312.pyc,, +pip/_internal/index/__pycache__/collector.cpython-312.pyc,, +pip/_internal/index/__pycache__/package_finder.cpython-312.pyc,, +pip/_internal/index/__pycache__/sources.cpython-312.pyc,, +pip/_internal/index/collector.py,sha256=RdPO0JLAlmyBWPAWYHPyRoGjz3GNAeTngCNkbGey_mE,16265 +pip/_internal/index/package_finder.py,sha256=mJHAljlHeHuclyuxtjvBZO6DtovKjsZjF_tCh_wux5E,38076 +pip/_internal/index/sources.py,sha256=lPBLK5Xiy8Q6IQMio26Wl7ocfZOKkgGklIBNyUJ23fI,8632 +pip/_internal/locations/__init__.py,sha256=UaAxeZ_f93FyouuFf4p7SXYF-4WstXuEvd3LbmPCAno,14925 +pip/_internal/locations/__pycache__/__init__.cpython-312.pyc,, +pip/_internal/locations/__pycache__/_distutils.cpython-312.pyc,, +pip/_internal/locations/__pycache__/_sysconfig.cpython-312.pyc,, +pip/_internal/locations/__pycache__/base.cpython-312.pyc,, +pip/_internal/locations/_distutils.py,sha256=x6nyVLj7X11Y4khIdf-mFlxMl2FWadtVEgeb8upc_WI,6013 +pip/_internal/locations/_sysconfig.py,sha256=IGzds60qsFneRogC-oeBaY7bEh3lPt_v47kMJChQXsU,7724 +pip/_internal/locations/base.py,sha256=RQiPi1d4FVM2Bxk04dQhXZ2PqkeljEL2fZZ9SYqIQ78,2556 +pip/_internal/main.py,sha256=r-UnUe8HLo5XFJz8inTcOOTiu_sxNhgHb6VwlGUllOI,340 +pip/_internal/metadata/__init__.py,sha256=CU8jK1TZso7jOLdr0sX9xDjrcs5iy8d7IRK-hvaIO5Y,4337 +pip/_internal/metadata/__pycache__/__init__.cpython-312.pyc,, +pip/_internal/metadata/__pycache__/_json.cpython-312.pyc,, +pip/_internal/metadata/__pycache__/base.cpython-312.pyc,, +pip/_internal/metadata/__pycache__/pkg_resources.cpython-312.pyc,, +pip/_internal/metadata/_json.py,sha256=ezrIYazHCINM2QUk1eA9wEAMj3aeGWeDVgGalgUzKpc,2707 +pip/_internal/metadata/base.py,sha256=ft0K5XNgI4ETqZnRv2-CtvgYiMOMAeGMAzxT-f6VLJA,25298 +pip/_internal/metadata/importlib/__init__.py,sha256=jUUidoxnHcfITHHaAWG1G2i5fdBYklv_uJcjo2x7VYE,135 +pip/_internal/metadata/importlib/__pycache__/__init__.cpython-312.pyc,, +pip/_internal/metadata/importlib/__pycache__/_compat.cpython-312.pyc,, +pip/_internal/metadata/importlib/__pycache__/_dists.cpython-312.pyc,, +pip/_internal/metadata/importlib/__pycache__/_envs.cpython-312.pyc,, +pip/_internal/metadata/importlib/_compat.py,sha256=c6av8sP8BBjAZuFSJow1iWfygUXNM3xRTCn5nqw6B9M,2796 +pip/_internal/metadata/importlib/_dists.py,sha256=ftmYiyfUGUIjnVwt6W-Ijsimy5c28KgmXly5Q5IQ2P4,8279 +pip/_internal/metadata/importlib/_envs.py,sha256=UUB980XSrDWrMpQ1_G45i0r8Hqlg_tg3IPQ63mEqbNc,7431 +pip/_internal/metadata/pkg_resources.py,sha256=U07ETAINSGeSRBfWUG93E4tZZbaW_f7PGzEqZN0hulc,10542 +pip/_internal/models/__init__.py,sha256=3DHUd_qxpPozfzouoqa9g9ts1Czr5qaHfFxbnxriepM,63 +pip/_internal/models/__pycache__/__init__.cpython-312.pyc,, +pip/_internal/models/__pycache__/candidate.cpython-312.pyc,, +pip/_internal/models/__pycache__/direct_url.cpython-312.pyc,, +pip/_internal/models/__pycache__/format_control.cpython-312.pyc,, +pip/_internal/models/__pycache__/index.cpython-312.pyc,, +pip/_internal/models/__pycache__/installation_report.cpython-312.pyc,, +pip/_internal/models/__pycache__/link.cpython-312.pyc,, +pip/_internal/models/__pycache__/scheme.cpython-312.pyc,, +pip/_internal/models/__pycache__/search_scope.cpython-312.pyc,, +pip/_internal/models/__pycache__/selection_prefs.cpython-312.pyc,, +pip/_internal/models/__pycache__/target_python.cpython-312.pyc,, +pip/_internal/models/__pycache__/wheel.cpython-312.pyc,, +pip/_internal/models/candidate.py,sha256=zzgFRuw_kWPjKpGw7LC0ZUMD2CQ2EberUIYs8izjdCA,753 +pip/_internal/models/direct_url.py,sha256=uBtY2HHd3TO9cKQJWh0ThvE5FRr-MWRYChRU4IG9HZE,6578 +pip/_internal/models/format_control.py,sha256=wtsQqSK9HaUiNxQEuB-C62eVimw6G4_VQFxV9-_KDBE,2486 +pip/_internal/models/index.py,sha256=tYnL8oxGi4aSNWur0mG8DAP7rC6yuha_MwJO8xw0crI,1030 +pip/_internal/models/installation_report.py,sha256=zRVZoaz-2vsrezj_H3hLOhMZCK9c7TbzWgC-jOalD00,2818 +pip/_internal/models/link.py,sha256=GQ8hq7x-FDFPv25Nbn2veIM-MlBrGZDGLd7aZeF4Xrg,21448 +pip/_internal/models/scheme.py,sha256=PakmHJM3e8OOWSZFtfz1Az7f1meONJnkGuQxFlt3wBE,575 +pip/_internal/models/search_scope.py,sha256=67NEnsYY84784S-MM7ekQuo9KXLH-7MzFntXjapvAo0,4531 +pip/_internal/models/selection_prefs.py,sha256=qaFfDs3ciqoXPg6xx45N1jPLqccLJw4N0s4P0PyHTQ8,2015 +pip/_internal/models/target_python.py,sha256=2XaH2rZ5ZF-K5wcJbEMGEl7SqrTToDDNkrtQ2v_v_-Q,4271 +pip/_internal/models/wheel.py,sha256=G7dND_s4ebPkEL7RJ1qCY0QhUUWIIK6AnjWgRATF5no,4539 +pip/_internal/network/__init__.py,sha256=jf6Tt5nV_7zkARBrKojIXItgejvoegVJVKUbhAa5Ioc,50 +pip/_internal/network/__pycache__/__init__.cpython-312.pyc,, +pip/_internal/network/__pycache__/auth.cpython-312.pyc,, +pip/_internal/network/__pycache__/cache.cpython-312.pyc,, +pip/_internal/network/__pycache__/download.cpython-312.pyc,, +pip/_internal/network/__pycache__/lazy_wheel.cpython-312.pyc,, +pip/_internal/network/__pycache__/session.cpython-312.pyc,, +pip/_internal/network/__pycache__/utils.cpython-312.pyc,, +pip/_internal/network/__pycache__/xmlrpc.cpython-312.pyc,, +pip/_internal/network/auth.py,sha256=D4gASjUrqoDFlSt6gQ767KAAjv6PUyJU0puDlhXNVRE,20809 +pip/_internal/network/cache.py,sha256=0yGMA3Eet59xBSLtbPAenvI53dl29oUOeqZ2c0QL2Ss,4614 +pip/_internal/network/download.py,sha256=FLOP29dPYECBiAi7eEjvAbNkyzaKNqbyjOT2m8HPW8U,6048 +pip/_internal/network/lazy_wheel.py,sha256=PBdoMoNQQIA84Fhgne38jWF52W4x_KtsHjxgv4dkRKA,7622 +pip/_internal/network/session.py,sha256=msM4es16LmmNEYNkrYyg8fTc7gAHbKFltawfKP27LOI,18771 +pip/_internal/network/utils.py,sha256=Inaxel-NxBu4PQWkjyErdnfewsFCcgHph7dzR1-FboY,4088 +pip/_internal/network/xmlrpc.py,sha256=sAxzOacJ-N1NXGPvap9jC3zuYWSnnv3GXtgR2-E2APA,1838 +pip/_internal/operations/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +pip/_internal/operations/__pycache__/__init__.cpython-312.pyc,, +pip/_internal/operations/__pycache__/check.cpython-312.pyc,, +pip/_internal/operations/__pycache__/freeze.cpython-312.pyc,, +pip/_internal/operations/__pycache__/prepare.cpython-312.pyc,, +pip/_internal/operations/build/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +pip/_internal/operations/build/__pycache__/__init__.cpython-312.pyc,, +pip/_internal/operations/build/__pycache__/build_tracker.cpython-312.pyc,, +pip/_internal/operations/build/__pycache__/metadata.cpython-312.pyc,, +pip/_internal/operations/build/__pycache__/metadata_editable.cpython-312.pyc,, +pip/_internal/operations/build/__pycache__/metadata_legacy.cpython-312.pyc,, +pip/_internal/operations/build/__pycache__/wheel.cpython-312.pyc,, +pip/_internal/operations/build/__pycache__/wheel_editable.cpython-312.pyc,, +pip/_internal/operations/build/__pycache__/wheel_legacy.cpython-312.pyc,, +pip/_internal/operations/build/build_tracker.py,sha256=-ARW_TcjHCOX7D2NUOGntB4Fgc6b4aolsXkAK6BWL7w,4774 +pip/_internal/operations/build/metadata.py,sha256=9S0CUD8U3QqZeXp-Zyt8HxwU90lE4QrnYDgrqZDzBnc,1422 +pip/_internal/operations/build/metadata_editable.py,sha256=xlAwcP9q_8_fmv_3I39w9EZ7SQV9hnJZr9VuTsq2Y68,1510 +pip/_internal/operations/build/metadata_legacy.py,sha256=8i6i1QZX9m_lKPStEFsHKM0MT4a-CD408JOw99daLmo,2190 +pip/_internal/operations/build/wheel.py,sha256=sT12FBLAxDC6wyrDorh8kvcZ1jG5qInCRWzzP-UkJiQ,1075 +pip/_internal/operations/build/wheel_editable.py,sha256=yOtoH6zpAkoKYEUtr8FhzrYnkNHQaQBjWQ2HYae1MQg,1417 +pip/_internal/operations/build/wheel_legacy.py,sha256=K-6kNhmj-1xDF45ny1yheMerF0ui4EoQCLzEoHh6-tc,3045 +pip/_internal/operations/check.py,sha256=L24vRL8VWbyywdoeAhM89WCd8zLTnjIbULlKelUgIec,5912 +pip/_internal/operations/freeze.py,sha256=1_M79jAQKnCxWr-KCCmHuVXOVFGaUJHmoWLfFzgh7K4,9843 +pip/_internal/operations/install/__init__.py,sha256=mX7hyD2GNBO2mFGokDQ30r_GXv7Y_PLdtxcUv144e-s,51 +pip/_internal/operations/install/__pycache__/__init__.cpython-312.pyc,, +pip/_internal/operations/install/__pycache__/editable_legacy.cpython-312.pyc,, +pip/_internal/operations/install/__pycache__/wheel.cpython-312.pyc,, +pip/_internal/operations/install/editable_legacy.py,sha256=PoEsNEPGbIZ2yQphPsmYTKLOCMs4gv5OcCdzW124NcA,1283 +pip/_internal/operations/install/wheel.py,sha256=X5Iz9yUg5LlK5VNQ9g2ikc6dcRu8EPi_SUi5iuEDRgo,27615 +pip/_internal/operations/prepare.py,sha256=joWJwPkuqGscQgVNImLK71e9hRapwKvRCM8HclysmvU,28118 +pip/_internal/pyproject.py,sha256=GLJ6rWRS5_2noKdajohoLyDty57Z7QXhcUAYghmTnWc,7286 +pip/_internal/req/__init__.py,sha256=HxBFtZy_BbCclLgr26waMtpzYdO5T3vxePvpGAXSt5s,2653 +pip/_internal/req/__pycache__/__init__.cpython-312.pyc,, +pip/_internal/req/__pycache__/constructors.cpython-312.pyc,, +pip/_internal/req/__pycache__/req_file.cpython-312.pyc,, +pip/_internal/req/__pycache__/req_install.cpython-312.pyc,, +pip/_internal/req/__pycache__/req_set.cpython-312.pyc,, +pip/_internal/req/__pycache__/req_uninstall.cpython-312.pyc,, +pip/_internal/req/constructors.py,sha256=v1qzCN1mIldwx-nCrPc8JO4lxkm3Fv8M5RWvt8LISjc,18430 +pip/_internal/req/req_file.py,sha256=eys82McgaICOGic2UZRHjD720piKJPwmeSYdXlWwl6w,20234 +pip/_internal/req/req_install.py,sha256=BMptxHYg2uG_b-7HFEULPb3nuw0FMAbuea8zTq2rE7w,35786 +pip/_internal/req/req_set.py,sha256=j3esG0s6SzoVReX9rWn4rpYNtyET_fwxbwJPRimvRxo,2858 +pip/_internal/req/req_uninstall.py,sha256=qzDIxJo-OETWqGais7tSMCDcWbATYABT-Tid3ityF0s,23853 +pip/_internal/resolution/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +pip/_internal/resolution/__pycache__/__init__.cpython-312.pyc,, +pip/_internal/resolution/__pycache__/base.cpython-312.pyc,, +pip/_internal/resolution/base.py,sha256=qlmh325SBVfvG6Me9gc5Nsh5sdwHBwzHBq6aEXtKsLA,583 +pip/_internal/resolution/legacy/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +pip/_internal/resolution/legacy/__pycache__/__init__.cpython-312.pyc,, +pip/_internal/resolution/legacy/__pycache__/resolver.cpython-312.pyc,, +pip/_internal/resolution/legacy/resolver.py,sha256=3HZiJBRd1FTN6jQpI4qRO8-TbLYeIbUTS6PFvXnXs2w,24068 +pip/_internal/resolution/resolvelib/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +pip/_internal/resolution/resolvelib/__pycache__/__init__.cpython-312.pyc,, +pip/_internal/resolution/resolvelib/__pycache__/base.cpython-312.pyc,, +pip/_internal/resolution/resolvelib/__pycache__/candidates.cpython-312.pyc,, +pip/_internal/resolution/resolvelib/__pycache__/factory.cpython-312.pyc,, +pip/_internal/resolution/resolvelib/__pycache__/found_candidates.cpython-312.pyc,, +pip/_internal/resolution/resolvelib/__pycache__/provider.cpython-312.pyc,, +pip/_internal/resolution/resolvelib/__pycache__/reporter.cpython-312.pyc,, +pip/_internal/resolution/resolvelib/__pycache__/requirements.cpython-312.pyc,, +pip/_internal/resolution/resolvelib/__pycache__/resolver.cpython-312.pyc,, +pip/_internal/resolution/resolvelib/base.py,sha256=DCf669FsqyQY5uqXeePDHQY1e4QO-pBzWH8O0s9-K94,5023 +pip/_internal/resolution/resolvelib/candidates.py,sha256=5UZ1upNnmqsP-nmEZaDYxaBgCoejw_e2WVGmmAvBxXc,20001 +pip/_internal/resolution/resolvelib/factory.py,sha256=MJOLSZJY8_28PPdcutoQ6gjJ_1eBDt6Z1edtfTJyR4E,32659 +pip/_internal/resolution/resolvelib/found_candidates.py,sha256=9hrTyQqFvl9I7Tji79F1AxHv39Qh1rkJ_7deSHSMfQc,6383 +pip/_internal/resolution/resolvelib/provider.py,sha256=bcsFnYvlmtB80cwVdW1fIwgol8ZNr1f1VHyRTkz47SM,9935 +pip/_internal/resolution/resolvelib/reporter.py,sha256=00JtoXEkTlw0-rl_sl54d71avwOsJHt9GGHcrj5Sza0,3168 +pip/_internal/resolution/resolvelib/requirements.py,sha256=7JG4Z72e5Yk4vU0S5ulGvbqTy4FMQGYhY5zQhX9zTtY,8065 +pip/_internal/resolution/resolvelib/resolver.py,sha256=nLJOsVMEVi2gQUVJoUFKMZAeu2f7GRMjGMvNSWyz0Bc,12592 +pip/_internal/self_outdated_check.py,sha256=1PFtttvLAeyCVR3tPoBq2sOlPD0IJ-KSqU6bc1HUk9c,8318 +pip/_internal/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +pip/_internal/utils/__pycache__/__init__.cpython-312.pyc,, +pip/_internal/utils/__pycache__/_jaraco_text.cpython-312.pyc,, +pip/_internal/utils/__pycache__/_log.cpython-312.pyc,, +pip/_internal/utils/__pycache__/appdirs.cpython-312.pyc,, +pip/_internal/utils/__pycache__/compat.cpython-312.pyc,, +pip/_internal/utils/__pycache__/compatibility_tags.cpython-312.pyc,, +pip/_internal/utils/__pycache__/datetime.cpython-312.pyc,, +pip/_internal/utils/__pycache__/deprecation.cpython-312.pyc,, +pip/_internal/utils/__pycache__/direct_url_helpers.cpython-312.pyc,, +pip/_internal/utils/__pycache__/egg_link.cpython-312.pyc,, +pip/_internal/utils/__pycache__/entrypoints.cpython-312.pyc,, +pip/_internal/utils/__pycache__/filesystem.cpython-312.pyc,, +pip/_internal/utils/__pycache__/filetypes.cpython-312.pyc,, +pip/_internal/utils/__pycache__/glibc.cpython-312.pyc,, +pip/_internal/utils/__pycache__/hashes.cpython-312.pyc,, +pip/_internal/utils/__pycache__/logging.cpython-312.pyc,, +pip/_internal/utils/__pycache__/misc.cpython-312.pyc,, +pip/_internal/utils/__pycache__/packaging.cpython-312.pyc,, +pip/_internal/utils/__pycache__/retry.cpython-312.pyc,, +pip/_internal/utils/__pycache__/setuptools_build.cpython-312.pyc,, +pip/_internal/utils/__pycache__/subprocess.cpython-312.pyc,, +pip/_internal/utils/__pycache__/temp_dir.cpython-312.pyc,, +pip/_internal/utils/__pycache__/unpacking.cpython-312.pyc,, +pip/_internal/utils/__pycache__/urls.cpython-312.pyc,, +pip/_internal/utils/__pycache__/virtualenv.cpython-312.pyc,, +pip/_internal/utils/__pycache__/wheel.cpython-312.pyc,, +pip/_internal/utils/_jaraco_text.py,sha256=M15uUPIh5NpP1tdUGBxRau6q1ZAEtI8-XyLEETscFfE,3350 +pip/_internal/utils/_log.py,sha256=-jHLOE_THaZz5BFcCnoSL9EYAtJ0nXem49s9of4jvKw,1015 +pip/_internal/utils/appdirs.py,sha256=swgcTKOm3daLeXTW6v5BUS2Ti2RvEnGRQYH_yDXklAo,1665 +pip/_internal/utils/compat.py,sha256=ckkFveBiYQjRWjkNsajt_oWPS57tJvE8XxoC4OIYgCY,2399 +pip/_internal/utils/compatibility_tags.py,sha256=OWq5axHpW-MEEPztGdvgADrgJPAcV9a88Rxm4Z8VBs8,6272 +pip/_internal/utils/datetime.py,sha256=m21Y3wAtQc-ji6Veb6k_M5g6A0ZyFI4egchTdnwh-pQ,242 +pip/_internal/utils/deprecation.py,sha256=k7Qg_UBAaaTdyq82YVARA6D7RmcGTXGv7fnfcgigj4Q,3707 +pip/_internal/utils/direct_url_helpers.py,sha256=r2MRtkVDACv9AGqYODBUC9CjwgtsUU1s68hmgfCJMtA,3196 +pip/_internal/utils/egg_link.py,sha256=0FePZoUYKv4RGQ2t6x7w5Z427wbA_Uo3WZnAkrgsuqo,2463 +pip/_internal/utils/entrypoints.py,sha256=YlhLTRl2oHBAuqhc-zmL7USS67TPWVHImjeAQHreZTQ,3064 +pip/_internal/utils/filesystem.py,sha256=ajvA-q4ocliW9kPp8Yquh-4vssXbu-UKbo5FV9V4X64,4950 +pip/_internal/utils/filetypes.py,sha256=i8XAQ0eFCog26Fw9yV0Yb1ygAqKYB1w9Cz9n0fj8gZU,716 +pip/_internal/utils/glibc.py,sha256=vUkWq_1pJuzcYNcGKLlQmABoUiisK8noYY1yc8Wq4w4,3734 +pip/_internal/utils/hashes.py,sha256=XGGLL0AG8-RhWnyz87xF6MFZ--BKadHU35D47eApCKI,4972 +pip/_internal/utils/logging.py,sha256=ONfbrhaD248akkosK79if97n20EABxwjOxp5dE5RCRY,11845 +pip/_internal/utils/misc.py,sha256=DWnYxBUItjRp7hhxEg4ih6P6YpKrykM86dbi_EcU8SQ,23450 +pip/_internal/utils/packaging.py,sha256=cm-X_0HVHV_jRwUVZh6AuEWqSitzf8EpaJ7Uv2UGu6A,2142 +pip/_internal/utils/retry.py,sha256=mhFbykXjhTnZfgzeuy-vl9c8nECnYn_CMtwNJX2tYzQ,1392 +pip/_internal/utils/setuptools_build.py,sha256=ouXpud-jeS8xPyTPsXJ-m34NPvK5os45otAzdSV_IJE,4435 +pip/_internal/utils/subprocess.py,sha256=EsvqSRiSMHF98T8Txmu6NLU3U--MpTTQjtNgKP0P--M,8988 +pip/_internal/utils/temp_dir.py,sha256=5qOXe8M4JeY6vaFQM867d5zkp1bSwMZ-KT5jymmP0Zg,9310 +pip/_internal/utils/unpacking.py,sha256=_gVdyzTRDMYktpnYljn4OoxrZTtMCf4xknSm4rK0WaA,11967 +pip/_internal/utils/urls.py,sha256=qceSOZb5lbNDrHNsv7_S4L4Ytszja5NwPKUMnZHbYnM,1599 +pip/_internal/utils/virtualenv.py,sha256=S6f7csYorRpiD6cvn3jISZYc3I8PJC43H5iMFpRAEDU,3456 +pip/_internal/utils/wheel.py,sha256=b442jkydFHjXzDy6cMR7MpzWBJ1Q82hR5F33cmcHV3g,4494 +pip/_internal/vcs/__init__.py,sha256=UAqvzpbi0VbZo3Ub6skEeZAw-ooIZR-zX_WpCbxyCoU,596 +pip/_internal/vcs/__pycache__/__init__.cpython-312.pyc,, +pip/_internal/vcs/__pycache__/bazaar.cpython-312.pyc,, +pip/_internal/vcs/__pycache__/git.cpython-312.pyc,, +pip/_internal/vcs/__pycache__/mercurial.cpython-312.pyc,, +pip/_internal/vcs/__pycache__/subversion.cpython-312.pyc,, +pip/_internal/vcs/__pycache__/versioncontrol.cpython-312.pyc,, +pip/_internal/vcs/bazaar.py,sha256=EKStcQaKpNu0NK4p5Q10Oc4xb3DUxFw024XrJy40bFQ,3528 +pip/_internal/vcs/git.py,sha256=3tpc9LQA_J4IVW5r5NvWaaSeDzcmJOrSFZN0J8vIKfU,18177 +pip/_internal/vcs/mercurial.py,sha256=oULOhzJ2Uie-06d1omkL-_Gc6meGaUkyogvqG9ZCyPs,5249 +pip/_internal/vcs/subversion.py,sha256=ddTugHBqHzV3ebKlU5QXHPN4gUqlyXbOx8q8NgXKvs8,11735 +pip/_internal/vcs/versioncontrol.py,sha256=cvf_-hnTAjQLXJ3d17FMNhQfcO1AcKWUF10tfrYyP-c,22440 +pip/_internal/wheel_builder.py,sha256=DL3A8LKeRj_ACp11WS5wSgASgPFqeyAeXJKdXfmaWXU,11799 +pip/_vendor/__init__.py,sha256=JYuAXvClhInxIrA2FTp5p-uuWVL7WV6-vEpTs46-Qh4,4873 +pip/_vendor/__pycache__/__init__.cpython-312.pyc,, +pip/_vendor/__pycache__/typing_extensions.cpython-312.pyc,, +pip/_vendor/cachecontrol/__init__.py,sha256=LMC5CBe94ZRL5xhlzwyPDmHXvBD0p7lT4R3Z73D6a_I,677 +pip/_vendor/cachecontrol/__pycache__/__init__.cpython-312.pyc,, +pip/_vendor/cachecontrol/__pycache__/_cmd.cpython-312.pyc,, +pip/_vendor/cachecontrol/__pycache__/adapter.cpython-312.pyc,, +pip/_vendor/cachecontrol/__pycache__/cache.cpython-312.pyc,, +pip/_vendor/cachecontrol/__pycache__/controller.cpython-312.pyc,, +pip/_vendor/cachecontrol/__pycache__/filewrapper.cpython-312.pyc,, +pip/_vendor/cachecontrol/__pycache__/heuristics.cpython-312.pyc,, +pip/_vendor/cachecontrol/__pycache__/serialize.cpython-312.pyc,, +pip/_vendor/cachecontrol/__pycache__/wrapper.cpython-312.pyc,, +pip/_vendor/cachecontrol/_cmd.py,sha256=iist2EpzJvDVIhMAxXq8iFnTBsiZAd6iplxfmNboNyk,1737 +pip/_vendor/cachecontrol/adapter.py,sha256=febjY4LV87iiCIK3jcl8iH58iaSA7b9WkovsByIDK0Y,6348 +pip/_vendor/cachecontrol/cache.py,sha256=OXwv7Fn2AwnKNiahJHnjtvaKLndvVLv_-zO-ltlV9qI,1953 +pip/_vendor/cachecontrol/caches/__init__.py,sha256=dtrrroK5BnADR1GWjCZ19aZ0tFsMfvFBtLQQU1sp_ag,303 +pip/_vendor/cachecontrol/caches/__pycache__/__init__.cpython-312.pyc,, +pip/_vendor/cachecontrol/caches/__pycache__/file_cache.cpython-312.pyc,, +pip/_vendor/cachecontrol/caches/__pycache__/redis_cache.cpython-312.pyc,, +pip/_vendor/cachecontrol/caches/file_cache.py,sha256=b7oMgsRSqPmEsonVJw6uFEYUlFgD6GF8TyacOGG1x3M,5399 +pip/_vendor/cachecontrol/caches/redis_cache.py,sha256=9rmqwtYu_ljVkW6_oLqbC7EaX_a8YT_yLuna-eS0dgo,1386 +pip/_vendor/cachecontrol/controller.py,sha256=glbPj2iZlGqdBg8z09D2DtQOzoOGXnWvy7K2LEyBsEQ,18576 +pip/_vendor/cachecontrol/filewrapper.py,sha256=2ktXNPE0KqnyzF24aOsKCA58HQq1xeC6l2g6_zwjghc,4291 +pip/_vendor/cachecontrol/heuristics.py,sha256=gqMXU8w0gQuEQiSdu3Yg-0vd9kW7nrWKbLca75rheGE,4881 +pip/_vendor/cachecontrol/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +pip/_vendor/cachecontrol/serialize.py,sha256=HQd2IllQ05HzPkVLMXTF2uX5mjEQjDBkxCqUJUODpZk,5163 +pip/_vendor/cachecontrol/wrapper.py,sha256=hsGc7g8QGQTT-4f8tgz3AM5qwScg6FO0BSdLSRdEvpU,1417 +pip/_vendor/certifi/__init__.py,sha256=p_GYZrjUwPBUhpLlCZoGb0miKBKSqDAyZC5DvIuqbHQ,94 +pip/_vendor/certifi/__main__.py,sha256=1k3Cr95vCxxGRGDljrW3wMdpZdL3Nhf0u1n-k2qdsCY,255 +pip/_vendor/certifi/__pycache__/__init__.cpython-312.pyc,, +pip/_vendor/certifi/__pycache__/__main__.cpython-312.pyc,, +pip/_vendor/certifi/__pycache__/core.cpython-312.pyc,, +pip/_vendor/certifi/cacert.pem,sha256=lO3rZukXdPyuk6BWUJFOKQliWaXH6HGh9l1GGrUgG0c,299427 +pip/_vendor/certifi/core.py,sha256=2SRT5rIcQChFDbe37BQa-kULxAgJ8qN6l1jfqTp4HIs,4486 +pip/_vendor/certifi/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +pip/_vendor/distlib/__init__.py,sha256=dcwgYGYGQqAEawBXPDtIx80DO_3cOmFv8HTc8JMzknQ,625 +pip/_vendor/distlib/__pycache__/__init__.cpython-312.pyc,, +pip/_vendor/distlib/__pycache__/compat.cpython-312.pyc,, +pip/_vendor/distlib/__pycache__/database.cpython-312.pyc,, +pip/_vendor/distlib/__pycache__/index.cpython-312.pyc,, +pip/_vendor/distlib/__pycache__/locators.cpython-312.pyc,, +pip/_vendor/distlib/__pycache__/manifest.cpython-312.pyc,, +pip/_vendor/distlib/__pycache__/markers.cpython-312.pyc,, +pip/_vendor/distlib/__pycache__/metadata.cpython-312.pyc,, +pip/_vendor/distlib/__pycache__/resources.cpython-312.pyc,, +pip/_vendor/distlib/__pycache__/scripts.cpython-312.pyc,, +pip/_vendor/distlib/__pycache__/util.cpython-312.pyc,, +pip/_vendor/distlib/__pycache__/version.cpython-312.pyc,, +pip/_vendor/distlib/__pycache__/wheel.cpython-312.pyc,, +pip/_vendor/distlib/compat.py,sha256=2jRSjRI4o-vlXeTK2BCGIUhkc6e9ZGhSsacRM5oseTw,41467 +pip/_vendor/distlib/database.py,sha256=mHy_LxiXIsIVRb-T0-idBrVLw3Ffij5teHCpbjmJ9YU,51160 +pip/_vendor/distlib/index.py,sha256=lTbw268rRhj8dw1sib3VZ_0EhSGgoJO3FKJzSFMOaeA,20797 +pip/_vendor/distlib/locators.py,sha256=oBeAZpFuPQSY09MgNnLfQGGAXXvVO96BFpZyKMuK4tM,51026 +pip/_vendor/distlib/manifest.py,sha256=3qfmAmVwxRqU1o23AlfXrQGZzh6g_GGzTAP_Hb9C5zQ,14168 +pip/_vendor/distlib/markers.py,sha256=X6sDvkFGcYS8gUW8hfsWuKEKAqhQZAJ7iXOMLxRYjYk,5164 +pip/_vendor/distlib/metadata.py,sha256=zil3sg2EUfLXVigljY2d_03IJt-JSs7nX-73fECMX2s,38724 +pip/_vendor/distlib/resources.py,sha256=LwbPksc0A1JMbi6XnuPdMBUn83X7BPuFNWqPGEKI698,10820 +pip/_vendor/distlib/scripts.py,sha256=BJliaDAZaVB7WAkwokgC3HXwLD2iWiHaVI50H7C6eG8,18608 +pip/_vendor/distlib/t32.exe,sha256=a0GV5kCoWsMutvliiCKmIgV98eRZ33wXoS-XrqvJQVs,97792 +pip/_vendor/distlib/t64-arm.exe,sha256=68TAa32V504xVBnufojh0PcenpR3U4wAqTqf-MZqbPw,182784 +pip/_vendor/distlib/t64.exe,sha256=gaYY8hy4fbkHYTTnA4i26ct8IQZzkBG2pRdy0iyuBrc,108032 +pip/_vendor/distlib/util.py,sha256=vMPGvsS4j9hF6Y9k3Tyom1aaHLb0rFmZAEyzeAdel9w,66682 +pip/_vendor/distlib/version.py,sha256=s5VIs8wBn0fxzGxWM_aA2ZZyx525HcZbMvcTlTyZ3Rg,23727 +pip/_vendor/distlib/w32.exe,sha256=R4csx3-OGM9kL4aPIzQKRo5TfmRSHZo6QWyLhDhNBks,91648 +pip/_vendor/distlib/w64-arm.exe,sha256=xdyYhKj0WDcVUOCb05blQYvzdYIKMbmJn2SZvzkcey4,168448 +pip/_vendor/distlib/w64.exe,sha256=ejGf-rojoBfXseGLpya6bFTFPWRG21X5KvU8J5iU-K0,101888 +pip/_vendor/distlib/wheel.py,sha256=DFIVguEQHCdxnSdAO0dfFsgMcvVZitg7bCOuLwZ7A_s,43979 +pip/_vendor/distro/__init__.py,sha256=2fHjF-SfgPvjyNZ1iHh_wjqWdR_Yo5ODHwZC0jLBPhc,981 +pip/_vendor/distro/__main__.py,sha256=bu9d3TifoKciZFcqRBuygV3GSuThnVD_m2IK4cz96Vs,64 +pip/_vendor/distro/__pycache__/__init__.cpython-312.pyc,, +pip/_vendor/distro/__pycache__/__main__.cpython-312.pyc,, +pip/_vendor/distro/__pycache__/distro.cpython-312.pyc,, +pip/_vendor/distro/distro.py,sha256=XqbefacAhDT4zr_trnbA15eY8vdK4GTghgmvUGrEM_4,49430 +pip/_vendor/distro/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +pip/_vendor/idna/__init__.py,sha256=MPqNDLZbXqGaNdXxAFhiqFPKEQXju2jNQhCey6-5eJM,868 +pip/_vendor/idna/__pycache__/__init__.cpython-312.pyc,, +pip/_vendor/idna/__pycache__/codec.cpython-312.pyc,, +pip/_vendor/idna/__pycache__/compat.cpython-312.pyc,, +pip/_vendor/idna/__pycache__/core.cpython-312.pyc,, +pip/_vendor/idna/__pycache__/idnadata.cpython-312.pyc,, +pip/_vendor/idna/__pycache__/intranges.cpython-312.pyc,, +pip/_vendor/idna/__pycache__/package_data.cpython-312.pyc,, +pip/_vendor/idna/__pycache__/uts46data.cpython-312.pyc,, +pip/_vendor/idna/codec.py,sha256=PEew3ItwzjW4hymbasnty2N2OXvNcgHB-JjrBuxHPYY,3422 +pip/_vendor/idna/compat.py,sha256=RzLy6QQCdl9784aFhb2EX9EKGCJjg0P3PilGdeXXcx8,316 +pip/_vendor/idna/core.py,sha256=YJYyAMnwiQEPjVC4-Fqu_p4CJ6yKKuDGmppBNQNQpFs,13239 +pip/_vendor/idna/idnadata.py,sha256=W30GcIGvtOWYwAjZj4ZjuouUutC6ffgNuyjJy7fZ-lo,78306 +pip/_vendor/idna/intranges.py,sha256=amUtkdhYcQG8Zr-CoMM_kVRacxkivC1WgxN1b63KKdU,1898 +pip/_vendor/idna/package_data.py,sha256=q59S3OXsc5VI8j6vSD0sGBMyk6zZ4vWFREE88yCJYKs,21 +pip/_vendor/idna/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +pip/_vendor/idna/uts46data.py,sha256=rt90K9J40gUSwppDPCrhjgi5AA6pWM65dEGRSf6rIhM,239289 +pip/_vendor/msgpack/__init__.py,sha256=reRaiOtEzSjPnr7TpxjgIvbfln5pV66FhricAs2eC-g,1109 +pip/_vendor/msgpack/__pycache__/__init__.cpython-312.pyc,, +pip/_vendor/msgpack/__pycache__/exceptions.cpython-312.pyc,, +pip/_vendor/msgpack/__pycache__/ext.cpython-312.pyc,, +pip/_vendor/msgpack/__pycache__/fallback.cpython-312.pyc,, +pip/_vendor/msgpack/exceptions.py,sha256=dCTWei8dpkrMsQDcjQk74ATl9HsIBH0ybt8zOPNqMYc,1081 +pip/_vendor/msgpack/ext.py,sha256=kteJv03n9tYzd5oo3xYopVTo4vRaAxonBQQJhXohZZo,5726 +pip/_vendor/msgpack/fallback.py,sha256=0g1Pzp0vtmBEmJ5w9F3s_-JMVURP8RS4G1cc5TRaAsI,32390 +pip/_vendor/packaging/__init__.py,sha256=dk4Ta_vmdVJxYHDcfyhvQNw8V3PgSBomKNXqg-D2JDY,494 +pip/_vendor/packaging/__pycache__/__init__.cpython-312.pyc,, +pip/_vendor/packaging/__pycache__/_elffile.cpython-312.pyc,, +pip/_vendor/packaging/__pycache__/_manylinux.cpython-312.pyc,, +pip/_vendor/packaging/__pycache__/_musllinux.cpython-312.pyc,, +pip/_vendor/packaging/__pycache__/_parser.cpython-312.pyc,, +pip/_vendor/packaging/__pycache__/_structures.cpython-312.pyc,, +pip/_vendor/packaging/__pycache__/_tokenizer.cpython-312.pyc,, +pip/_vendor/packaging/__pycache__/markers.cpython-312.pyc,, +pip/_vendor/packaging/__pycache__/metadata.cpython-312.pyc,, +pip/_vendor/packaging/__pycache__/requirements.cpython-312.pyc,, +pip/_vendor/packaging/__pycache__/specifiers.cpython-312.pyc,, +pip/_vendor/packaging/__pycache__/tags.cpython-312.pyc,, +pip/_vendor/packaging/__pycache__/utils.cpython-312.pyc,, +pip/_vendor/packaging/__pycache__/version.cpython-312.pyc,, +pip/_vendor/packaging/_elffile.py,sha256=cflAQAkE25tzhYmq_aCi72QfbT_tn891tPzfpbeHOwE,3306 +pip/_vendor/packaging/_manylinux.py,sha256=vl5OCoz4kx80H5rwXKeXWjl9WNISGmr4ZgTpTP9lU9c,9612 +pip/_vendor/packaging/_musllinux.py,sha256=p9ZqNYiOItGee8KcZFeHF_YcdhVwGHdK6r-8lgixvGQ,2694 +pip/_vendor/packaging/_parser.py,sha256=s_TvTvDNK0NrM2QB3VKThdWFM4Nc0P6JnkObkl3MjpM,10236 +pip/_vendor/packaging/_structures.py,sha256=q3eVNmbWJGG_S0Dit_S3Ao8qQqz_5PYTXFAKBZe5yr4,1431 +pip/_vendor/packaging/_tokenizer.py,sha256=J6v5H7Jzvb-g81xp_2QACKwO7LxHQA6ikryMU7zXwN8,5273 +pip/_vendor/packaging/licenses/__init__.py,sha256=A116-FU49_Dz4162M4y1uAiZN4Rgdc83FxNd8EjlfqI,5727 +pip/_vendor/packaging/licenses/__pycache__/__init__.cpython-312.pyc,, +pip/_vendor/packaging/licenses/__pycache__/_spdx.cpython-312.pyc,, +pip/_vendor/packaging/licenses/_spdx.py,sha256=oAm1ztPFwlsmCKe7lAAsv_OIOfS1cWDu9bNBkeu-2ns,48398 +pip/_vendor/packaging/markers.py,sha256=c89TNzB7ZdGYhkovm6PYmqGyHxXlYVaLW591PHUNKD8,10561 +pip/_vendor/packaging/metadata.py,sha256=YJibM7GYe4re8-0a3OlXmGS-XDgTEoO4tlBt2q25Bng,34762 +pip/_vendor/packaging/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +pip/_vendor/packaging/requirements.py,sha256=gYyRSAdbrIyKDY66ugIDUQjRMvxkH2ALioTmX3tnL6o,2947 +pip/_vendor/packaging/specifiers.py,sha256=hGU6kuCd77bL-msIL6yLCp6MNT75RSMUKZDuju26c8U,40098 +pip/_vendor/packaging/tags.py,sha256=CFqrJzAzc2XNGexerH__T-Y5Iwq7WbsYXsiLERLWxY0,21014 +pip/_vendor/packaging/utils.py,sha256=0F3Hh9OFuRgrhTgGZUl5K22Fv1YP2tZl1z_2gO6kJiA,5050 +pip/_vendor/packaging/version.py,sha256=oiHqzTUv_p12hpjgsLDVcaF5hT7pDaSOViUNMD4GTW0,16688 +pip/_vendor/pkg_resources/__init__.py,sha256=jrhDRbOubP74QuPXxd7U7Po42PH2l-LZ2XfcO7llpZ4,124463 +pip/_vendor/pkg_resources/__pycache__/__init__.cpython-312.pyc,, +pip/_vendor/platformdirs/__init__.py,sha256=JueR2cRLkxY7iwik-qNWJCwKOrAlBgVgcZ_IHQzqGLE,22344 +pip/_vendor/platformdirs/__main__.py,sha256=jBJ8zb7Mpx5ebcqF83xrpO94MaeCpNGHVf9cvDN2JLg,1505 +pip/_vendor/platformdirs/__pycache__/__init__.cpython-312.pyc,, +pip/_vendor/platformdirs/__pycache__/__main__.cpython-312.pyc,, +pip/_vendor/platformdirs/__pycache__/android.cpython-312.pyc,, +pip/_vendor/platformdirs/__pycache__/api.cpython-312.pyc,, +pip/_vendor/platformdirs/__pycache__/macos.cpython-312.pyc,, +pip/_vendor/platformdirs/__pycache__/unix.cpython-312.pyc,, +pip/_vendor/platformdirs/__pycache__/version.cpython-312.pyc,, +pip/_vendor/platformdirs/__pycache__/windows.cpython-312.pyc,, +pip/_vendor/platformdirs/android.py,sha256=kV5oL3V3DZ6WZKu9yFiQupv18yp_jlSV2ChH1TmPcds,9007 +pip/_vendor/platformdirs/api.py,sha256=2dfUDNbEXeDhDKarqtR5NY7oUikUZ4RZhs3ozstmhBQ,9246 +pip/_vendor/platformdirs/macos.py,sha256=UlbyFZ8Rzu3xndCqQEHrfsYTeHwYdFap1Ioz-yxveT4,6154 +pip/_vendor/platformdirs/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +pip/_vendor/platformdirs/unix.py,sha256=uRPJWRyQEtv7yOSvU94rUmsblo5XKDLA1SzFg55kbK0,10393 +pip/_vendor/platformdirs/version.py,sha256=oH4KgTfK4AklbTYVcV_yynvJ9JLI3pyvDVay0hRsLCs,411 +pip/_vendor/platformdirs/windows.py,sha256=IFpiohUBwxPtCzlyKwNtxyW4Jk8haa6W8o59mfrDXVo,10125 +pip/_vendor/pygments/__init__.py,sha256=7N1oiaWulw_nCsTY4EEixYLz15pWY5u4uPAFFi-ielU,2983 +pip/_vendor/pygments/__main__.py,sha256=isIhBxLg65nLlXukG4VkMuPfNdd7gFzTZ_R_z3Q8diY,353 +pip/_vendor/pygments/__pycache__/__init__.cpython-312.pyc,, +pip/_vendor/pygments/__pycache__/__main__.cpython-312.pyc,, +pip/_vendor/pygments/__pycache__/cmdline.cpython-312.pyc,, +pip/_vendor/pygments/__pycache__/console.cpython-312.pyc,, +pip/_vendor/pygments/__pycache__/filter.cpython-312.pyc,, +pip/_vendor/pygments/__pycache__/formatter.cpython-312.pyc,, +pip/_vendor/pygments/__pycache__/lexer.cpython-312.pyc,, +pip/_vendor/pygments/__pycache__/modeline.cpython-312.pyc,, +pip/_vendor/pygments/__pycache__/plugin.cpython-312.pyc,, +pip/_vendor/pygments/__pycache__/regexopt.cpython-312.pyc,, +pip/_vendor/pygments/__pycache__/scanner.cpython-312.pyc,, +pip/_vendor/pygments/__pycache__/sphinxext.cpython-312.pyc,, +pip/_vendor/pygments/__pycache__/style.cpython-312.pyc,, +pip/_vendor/pygments/__pycache__/token.cpython-312.pyc,, +pip/_vendor/pygments/__pycache__/unistring.cpython-312.pyc,, +pip/_vendor/pygments/__pycache__/util.cpython-312.pyc,, +pip/_vendor/pygments/cmdline.py,sha256=LIVzmAunlk9sRJJp54O4KRy9GDIN4Wu13v9p9QzfGPM,23656 +pip/_vendor/pygments/console.py,sha256=yhP9UsLAVmWKVQf2446JJewkA7AiXeeTf4Ieg3Oi2fU,1718 +pip/_vendor/pygments/filter.py,sha256=_ADNPCskD8_GmodHi6_LoVgPU3Zh336aBCT5cOeTMs0,1910 +pip/_vendor/pygments/filters/__init__.py,sha256=RdedK2KWKXlKwR7cvkfr3NUj9YiZQgMgilRMFUg2jPA,40392 +pip/_vendor/pygments/filters/__pycache__/__init__.cpython-312.pyc,, +pip/_vendor/pygments/formatter.py,sha256=jDWBTndlBH2Z5IYZFVDnP0qn1CaTQjTWt7iAGtCnJEg,4390 +pip/_vendor/pygments/formatters/__init__.py,sha256=8No-NUs8rBTSSBJIv4hSEQt2M0cFB4hwAT0snVc2QGE,5385 +pip/_vendor/pygments/formatters/__pycache__/__init__.cpython-312.pyc,, +pip/_vendor/pygments/formatters/__pycache__/_mapping.cpython-312.pyc,, +pip/_vendor/pygments/formatters/__pycache__/bbcode.cpython-312.pyc,, +pip/_vendor/pygments/formatters/__pycache__/groff.cpython-312.pyc,, +pip/_vendor/pygments/formatters/__pycache__/html.cpython-312.pyc,, +pip/_vendor/pygments/formatters/__pycache__/img.cpython-312.pyc,, +pip/_vendor/pygments/formatters/__pycache__/irc.cpython-312.pyc,, +pip/_vendor/pygments/formatters/__pycache__/latex.cpython-312.pyc,, +pip/_vendor/pygments/formatters/__pycache__/other.cpython-312.pyc,, +pip/_vendor/pygments/formatters/__pycache__/pangomarkup.cpython-312.pyc,, +pip/_vendor/pygments/formatters/__pycache__/rtf.cpython-312.pyc,, +pip/_vendor/pygments/formatters/__pycache__/svg.cpython-312.pyc,, +pip/_vendor/pygments/formatters/__pycache__/terminal.cpython-312.pyc,, +pip/_vendor/pygments/formatters/__pycache__/terminal256.cpython-312.pyc,, +pip/_vendor/pygments/formatters/_mapping.py,sha256=1Cw37FuQlNacnxRKmtlPX4nyLoX9_ttko5ZwscNUZZ4,4176 +pip/_vendor/pygments/formatters/bbcode.py,sha256=3JQLI45tcrQ_kRUMjuab6C7Hb0XUsbVWqqbSn9cMjkI,3320 +pip/_vendor/pygments/formatters/groff.py,sha256=M39k0PaSSZRnxWjqBSVPkF0mu1-Vr7bm6RsFvs-CNN4,5106 +pip/_vendor/pygments/formatters/html.py,sha256=SE2jc3YCqbMS3rZW9EAmDlAUhdVxJ52gA4dileEvCGU,35669 +pip/_vendor/pygments/formatters/img.py,sha256=MwA4xWPLOwh6j7Yc6oHzjuqSPt0M1fh5r-5BTIIUfsU,23287 +pip/_vendor/pygments/formatters/irc.py,sha256=dp1Z0l_ObJ5NFh9MhqLGg5ptG5hgJqedT2Vkutt9v0M,4981 +pip/_vendor/pygments/formatters/latex.py,sha256=XMmhOCqUKDBQtG5mGJNAFYxApqaC5puo5cMmPfK3944,19306 +pip/_vendor/pygments/formatters/other.py,sha256=56PMJOliin-rAUdnRM0i1wsV1GdUPd_dvQq0_UPfF9c,5034 +pip/_vendor/pygments/formatters/pangomarkup.py,sha256=y16U00aVYYEFpeCfGXlYBSMacG425CbfoG8oKbKegIg,2218 +pip/_vendor/pygments/formatters/rtf.py,sha256=ZT90dmcKyJboIB0mArhL7IhE467GXRN0G7QAUgG03To,11957 +pip/_vendor/pygments/formatters/svg.py,sha256=KKsiophPupHuxm0So-MsbQEWOT54IAiSF7hZPmxtKXE,7174 +pip/_vendor/pygments/formatters/terminal.py,sha256=AojNG4MlKq2L6IsC_VnXHu4AbHCBn9Otog6u45XvxeI,4674 +pip/_vendor/pygments/formatters/terminal256.py,sha256=kGkNUVo3FpwjytIDS0if79EuUoroAprcWt3igrcIqT0,11753 +pip/_vendor/pygments/lexer.py,sha256=TYHDt___gNW4axTl2zvPZff-VQi8fPaIh5OKRcVSjUM,35349 +pip/_vendor/pygments/lexers/__init__.py,sha256=pIlxyQJuu_syh9lE080cq8ceVbEVcKp0osAFU5fawJU,12115 +pip/_vendor/pygments/lexers/__pycache__/__init__.cpython-312.pyc,, +pip/_vendor/pygments/lexers/__pycache__/_mapping.cpython-312.pyc,, +pip/_vendor/pygments/lexers/__pycache__/python.cpython-312.pyc,, +pip/_vendor/pygments/lexers/_mapping.py,sha256=61-h3zr103m01OS5BUq_AfUiL9YI06Ves9ipQ7k4vr4,76097 +pip/_vendor/pygments/lexers/python.py,sha256=2J_YJrPTr_A6fJY_qKiKv0GpgPwHMrlMSeo59qN3fe4,53687 +pip/_vendor/pygments/modeline.py,sha256=gtRYZBS-CKOCDXHhGZqApboHBaZwGH8gznN3O6nuxj4,1005 +pip/_vendor/pygments/plugin.py,sha256=ioeJ3QeoJ-UQhZpY9JL7vbxsTVuwwM7BCu-Jb8nN0AU,1891 +pip/_vendor/pygments/regexopt.py,sha256=Hky4EB13rIXEHQUNkwmCrYqtIlnXDehNR3MztafZ43w,3072 +pip/_vendor/pygments/scanner.py,sha256=NDy3ofK_fHRFK4hIDvxpamG871aewqcsIb6sgTi7Fhk,3092 +pip/_vendor/pygments/sphinxext.py,sha256=iOptJBcqOGPwMEJ2p70PvwpZPIGdvdZ8dxvq6kzxDgA,7981 +pip/_vendor/pygments/style.py,sha256=rSCZWFpg1_DwFMXDU0nEVmAcBHpuQGf9RxvOPPQvKLQ,6420 +pip/_vendor/pygments/styles/__init__.py,sha256=qUk6_1z5KmT8EdJFZYgESmG6P_HJF_2vVrDD7HSCGYY,2042 +pip/_vendor/pygments/styles/__pycache__/__init__.cpython-312.pyc,, +pip/_vendor/pygments/styles/__pycache__/_mapping.cpython-312.pyc,, +pip/_vendor/pygments/styles/_mapping.py,sha256=6lovFUE29tz6EsV3XYY4hgozJ7q1JL7cfO3UOlgnS8w,3312 +pip/_vendor/pygments/token.py,sha256=qZwT7LSPy5YBY3JgDjut642CCy7JdQzAfmqD9NmT5j0,6226 +pip/_vendor/pygments/unistring.py,sha256=p5c1i-HhoIhWemy9CUsaN9o39oomYHNxXll0Xfw6tEA,63208 +pip/_vendor/pygments/util.py,sha256=2tj2nS1X9_OpcuSjf8dOET2bDVZhs8cEKd_uT6-Fgg8,10031 +pip/_vendor/pyproject_hooks/__init__.py,sha256=cPB_a9LXz5xvsRbX1o2qyAdjLatZJdQ_Lc5McNX-X7Y,691 +pip/_vendor/pyproject_hooks/__pycache__/__init__.cpython-312.pyc,, +pip/_vendor/pyproject_hooks/__pycache__/_impl.cpython-312.pyc,, +pip/_vendor/pyproject_hooks/_impl.py,sha256=jY-raxnmyRyB57ruAitrJRUzEexuAhGTpgMygqx67Z4,14936 +pip/_vendor/pyproject_hooks/_in_process/__init__.py,sha256=MJNPpfIxcO-FghxpBbxkG1rFiQf6HOUbV4U5mq0HFns,557 +pip/_vendor/pyproject_hooks/_in_process/__pycache__/__init__.cpython-312.pyc,, +pip/_vendor/pyproject_hooks/_in_process/__pycache__/_in_process.cpython-312.pyc,, +pip/_vendor/pyproject_hooks/_in_process/_in_process.py,sha256=qcXMhmx__MIJq10gGHW3mA4Tl8dy8YzHMccwnNoKlw0,12216 +pip/_vendor/pyproject_hooks/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +pip/_vendor/requests/__init__.py,sha256=HlB_HzhrzGtfD_aaYUwUh1zWXLZ75_YCLyit75d0Vz8,5057 +pip/_vendor/requests/__pycache__/__init__.cpython-312.pyc,, +pip/_vendor/requests/__pycache__/__version__.cpython-312.pyc,, +pip/_vendor/requests/__pycache__/_internal_utils.cpython-312.pyc,, +pip/_vendor/requests/__pycache__/adapters.cpython-312.pyc,, +pip/_vendor/requests/__pycache__/api.cpython-312.pyc,, +pip/_vendor/requests/__pycache__/auth.cpython-312.pyc,, +pip/_vendor/requests/__pycache__/certs.cpython-312.pyc,, +pip/_vendor/requests/__pycache__/compat.cpython-312.pyc,, +pip/_vendor/requests/__pycache__/cookies.cpython-312.pyc,, +pip/_vendor/requests/__pycache__/exceptions.cpython-312.pyc,, +pip/_vendor/requests/__pycache__/help.cpython-312.pyc,, +pip/_vendor/requests/__pycache__/hooks.cpython-312.pyc,, +pip/_vendor/requests/__pycache__/models.cpython-312.pyc,, +pip/_vendor/requests/__pycache__/packages.cpython-312.pyc,, +pip/_vendor/requests/__pycache__/sessions.cpython-312.pyc,, +pip/_vendor/requests/__pycache__/status_codes.cpython-312.pyc,, +pip/_vendor/requests/__pycache__/structures.cpython-312.pyc,, +pip/_vendor/requests/__pycache__/utils.cpython-312.pyc,, +pip/_vendor/requests/__version__.py,sha256=FVfglgZmNQnmYPXpOohDU58F5EUb_-VnSTaAesS187g,435 +pip/_vendor/requests/_internal_utils.py,sha256=nMQymr4hs32TqVo5AbCrmcJEhvPUh7xXlluyqwslLiQ,1495 +pip/_vendor/requests/adapters.py,sha256=J7VeVxKBvawbtlX2DERVo05J9BXTcWYLMHNd1Baa-bk,27607 +pip/_vendor/requests/api.py,sha256=_Zb9Oa7tzVIizTKwFrPjDEY9ejtm_OnSRERnADxGsQs,6449 +pip/_vendor/requests/auth.py,sha256=kF75tqnLctZ9Mf_hm9TZIj4cQWnN5uxRz8oWsx5wmR0,10186 +pip/_vendor/requests/certs.py,sha256=kHDlkK_beuHXeMPc5jta2wgl8gdKeUWt5f2nTDVrvt8,441 +pip/_vendor/requests/compat.py,sha256=Mo9f9xZpefod8Zm-n9_StJcVTmwSukXR2p3IQyyVXvU,1485 +pip/_vendor/requests/cookies.py,sha256=bNi-iqEj4NPZ00-ob-rHvzkvObzN3lEpgw3g6paS3Xw,18590 +pip/_vendor/requests/exceptions.py,sha256=D1wqzYWne1mS2rU43tP9CeN1G7QAy7eqL9o1god6Ejw,4272 +pip/_vendor/requests/help.py,sha256=hRKaf9u0G7fdwrqMHtF3oG16RKktRf6KiwtSq2Fo1_0,3813 +pip/_vendor/requests/hooks.py,sha256=CiuysiHA39V5UfcCBXFIx83IrDpuwfN9RcTUgv28ftQ,733 +pip/_vendor/requests/models.py,sha256=x4K4CmH-lC0l2Kb-iPfMN4dRXxHEcbOaEWBL_i09AwI,35483 +pip/_vendor/requests/packages.py,sha256=_ZQDCJTJ8SP3kVWunSqBsRZNPzj2c1WFVqbdr08pz3U,1057 +pip/_vendor/requests/sessions.py,sha256=ykTI8UWGSltOfH07HKollH7kTBGw4WhiBVaQGmckTw4,30495 +pip/_vendor/requests/status_codes.py,sha256=iJUAeA25baTdw-6PfD0eF4qhpINDJRJI-yaMqxs4LEI,4322 +pip/_vendor/requests/structures.py,sha256=-IbmhVz06S-5aPSZuUthZ6-6D9XOjRuTXHOabY041XM,2912 +pip/_vendor/requests/utils.py,sha256=L79vnFbzJ3SFLKtJwpoWe41Tozi3RlZv94pY1TFIyow,33631 +pip/_vendor/resolvelib/__init__.py,sha256=h509TdEcpb5-44JonaU3ex2TM15GVBLjM9CNCPwnTTs,537 +pip/_vendor/resolvelib/__pycache__/__init__.cpython-312.pyc,, +pip/_vendor/resolvelib/__pycache__/providers.cpython-312.pyc,, +pip/_vendor/resolvelib/__pycache__/reporters.cpython-312.pyc,, +pip/_vendor/resolvelib/__pycache__/resolvers.cpython-312.pyc,, +pip/_vendor/resolvelib/__pycache__/structs.cpython-312.pyc,, +pip/_vendor/resolvelib/compat/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +pip/_vendor/resolvelib/compat/__pycache__/__init__.cpython-312.pyc,, +pip/_vendor/resolvelib/compat/__pycache__/collections_abc.cpython-312.pyc,, +pip/_vendor/resolvelib/compat/collections_abc.py,sha256=uy8xUZ-NDEw916tugUXm8HgwCGiMO0f-RcdnpkfXfOs,156 +pip/_vendor/resolvelib/providers.py,sha256=fuuvVrCetu5gsxPB43ERyjfO8aReS3rFQHpDgiItbs4,5871 +pip/_vendor/resolvelib/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +pip/_vendor/resolvelib/reporters.py,sha256=TSbRmWzTc26w0ggsV1bxVpeWDB8QNIre6twYl7GIZBE,1601 +pip/_vendor/resolvelib/resolvers.py,sha256=G8rsLZSq64g5VmIq-lB7UcIJ1gjAxIQJmTF4REZleQ0,20511 +pip/_vendor/resolvelib/structs.py,sha256=0_1_XO8z_CLhegP3Vpf9VJ3zJcfLm0NOHRM-i0Ykz3o,4963 +pip/_vendor/rich/__init__.py,sha256=dRxjIL-SbFVY0q3IjSMrfgBTHrm1LZDgLOygVBwiYZc,6090 +pip/_vendor/rich/__main__.py,sha256=eO7Cq8JnrgG8zVoeImiAs92q3hXNMIfp0w5lMsO7Q2Y,8477 +pip/_vendor/rich/__pycache__/__init__.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/__main__.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/_cell_widths.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/_emoji_codes.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/_emoji_replace.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/_export_format.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/_extension.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/_fileno.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/_inspect.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/_log_render.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/_loop.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/_null_file.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/_palettes.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/_pick.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/_ratio.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/_spinners.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/_stack.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/_timer.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/_win32_console.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/_windows.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/_windows_renderer.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/_wrap.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/abc.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/align.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/ansi.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/bar.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/box.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/cells.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/color.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/color_triplet.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/columns.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/console.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/constrain.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/containers.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/control.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/default_styles.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/diagnose.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/emoji.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/errors.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/file_proxy.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/filesize.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/highlighter.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/json.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/jupyter.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/layout.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/live.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/live_render.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/logging.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/markup.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/measure.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/padding.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/pager.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/palette.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/panel.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/pretty.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/progress.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/progress_bar.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/prompt.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/protocol.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/region.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/repr.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/rule.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/scope.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/screen.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/segment.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/spinner.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/status.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/style.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/styled.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/syntax.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/table.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/terminal_theme.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/text.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/theme.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/themes.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/traceback.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/tree.cpython-312.pyc,, +pip/_vendor/rich/_cell_widths.py,sha256=fbmeyetEdHjzE_Vx2l1uK7tnPOhMs2X1lJfO3vsKDpA,10209 +pip/_vendor/rich/_emoji_codes.py,sha256=hu1VL9nbVdppJrVoijVshRlcRRe_v3dju3Mmd2sKZdY,140235 +pip/_vendor/rich/_emoji_replace.py,sha256=n-kcetsEUx2ZUmhQrfeMNc-teeGhpuSQ5F8VPBsyvDo,1064 +pip/_vendor/rich/_export_format.py,sha256=RI08pSrm5tBSzPMvnbTqbD9WIalaOoN5d4M1RTmLq1Y,2128 +pip/_vendor/rich/_extension.py,sha256=Xt47QacCKwYruzjDi-gOBq724JReDj9Cm9xUi5fr-34,265 +pip/_vendor/rich/_fileno.py,sha256=HWZxP5C2ajMbHryvAQZseflVfQoGzsKOHzKGsLD8ynQ,799 +pip/_vendor/rich/_inspect.py,sha256=QM05lEFnFoTaFqpnbx-zBEI6k8oIKrD3cvjEOQNhKig,9655 +pip/_vendor/rich/_log_render.py,sha256=1ByI0PA1ZpxZY3CGJOK54hjlq4X-Bz_boIjIqCd8Kns,3225 +pip/_vendor/rich/_loop.py,sha256=hV_6CLdoPm0va22Wpw4zKqM0RYsz3TZxXj0PoS-9eDQ,1236 +pip/_vendor/rich/_null_file.py,sha256=ADGKp1yt-k70FMKV6tnqCqecB-rSJzp-WQsD7LPL-kg,1394 +pip/_vendor/rich/_palettes.py,sha256=cdev1JQKZ0JvlguV9ipHgznTdnvlIzUFDBb0It2PzjI,7063 +pip/_vendor/rich/_pick.py,sha256=evDt8QN4lF5CiwrUIXlOJCntitBCOsI3ZLPEIAVRLJU,423 +pip/_vendor/rich/_ratio.py,sha256=Zt58apszI6hAAcXPpgdWKpu3c31UBWebOeR4mbyptvU,5471 +pip/_vendor/rich/_spinners.py,sha256=U2r1_g_1zSjsjiUdAESc2iAMc3i4ri_S8PYP6kQ5z1I,19919 +pip/_vendor/rich/_stack.py,sha256=-C8OK7rxn3sIUdVwxZBBpeHhIzX0eI-VM3MemYfaXm0,351 +pip/_vendor/rich/_timer.py,sha256=zelxbT6oPFZnNrwWPpc1ktUeAT-Vc4fuFcRZLQGLtMI,417 +pip/_vendor/rich/_win32_console.py,sha256=BSaDRIMwBLITn_m0mTRLPqME5q-quGdSMuYMpYeYJwc,22755 +pip/_vendor/rich/_windows.py,sha256=aBwaD_S56SbgopIvayVmpk0Y28uwY2C5Bab1wl3Bp-I,1925 +pip/_vendor/rich/_windows_renderer.py,sha256=t74ZL3xuDCP3nmTp9pH1L5LiI2cakJuQRQleHCJerlk,2783 +pip/_vendor/rich/_wrap.py,sha256=FlSsom5EX0LVkA3KWy34yHnCfLtqX-ZIepXKh-70rpc,3404 +pip/_vendor/rich/abc.py,sha256=ON-E-ZqSSheZ88VrKX2M3PXpFbGEUUZPMa_Af0l-4f0,890 +pip/_vendor/rich/align.py,sha256=Rh-3adnDaN1Ao07EjR2PhgE62PGLPgO8SMwJBku1urQ,10469 +pip/_vendor/rich/ansi.py,sha256=Avs1LHbSdcyOvDOdpELZUoULcBiYewY76eNBp6uFBhs,6921 +pip/_vendor/rich/bar.py,sha256=ldbVHOzKJOnflVNuv1xS7g6dLX2E3wMnXkdPbpzJTcs,3263 +pip/_vendor/rich/box.py,sha256=nr5fYIUghB_iUCEq6y0Z3LlCT8gFPDrzN9u2kn7tJl4,10831 +pip/_vendor/rich/cells.py,sha256=KrQkj5-LghCCpJLSNQIyAZjndc4bnEqOEmi5YuZ9UCY,5130 +pip/_vendor/rich/color.py,sha256=3HSULVDj7qQkXUdFWv78JOiSZzfy5y1nkcYhna296V0,18211 +pip/_vendor/rich/color_triplet.py,sha256=3lhQkdJbvWPoLDO-AnYImAWmJvV5dlgYNCVZ97ORaN4,1054 +pip/_vendor/rich/columns.py,sha256=HUX0KcMm9dsKNi11fTbiM_h2iDtl8ySCaVcxlalEzq8,7131 +pip/_vendor/rich/console.py,sha256=nKjrEx_7xy8KGmDVT-BgNII0R5hm1cexhAHDwdwNVqg,100156 +pip/_vendor/rich/constrain.py,sha256=1VIPuC8AgtKWrcncQrjBdYqA3JVWysu6jZo1rrh7c7Q,1288 +pip/_vendor/rich/containers.py,sha256=c_56TxcedGYqDepHBMTuZdUIijitAQgnox-Qde0Z1qo,5502 +pip/_vendor/rich/control.py,sha256=DSkHTUQLorfSERAKE_oTAEUFefZnZp4bQb4q8rHbKws,6630 +pip/_vendor/rich/default_styles.py,sha256=dZxgaSD9VUy7SXQShO33aLYiAWspCr2sCQZFX_JK1j4,8159 +pip/_vendor/rich/diagnose.py,sha256=an6uouwhKPAlvQhYpNNpGq9EJysfMIOvvCbO3oSoR24,972 +pip/_vendor/rich/emoji.py,sha256=omTF9asaAnsM4yLY94eR_9dgRRSm1lHUszX20D1yYCQ,2501 +pip/_vendor/rich/errors.py,sha256=5pP3Kc5d4QJ_c0KFsxrfyhjiPVe7J1zOqSFbFAzcV-Y,642 +pip/_vendor/rich/file_proxy.py,sha256=Tl9THMDZ-Pk5Wm8sI1gGg_U5DhusmxD-FZ0fUbcU0W0,1683 +pip/_vendor/rich/filesize.py,sha256=_iz9lIpRgvW7MNSeCZnLg-HwzbP4GETg543WqD8SFs0,2484 +pip/_vendor/rich/highlighter.py,sha256=G_sn-8DKjM1sEjLG_oc4ovkWmiUpWvj8bXi0yed2LnY,9586 +pip/_vendor/rich/json.py,sha256=vVEoKdawoJRjAFayPwXkMBPLy7RSTs-f44wSQDR2nJ0,5031 +pip/_vendor/rich/jupyter.py,sha256=QyoKoE_8IdCbrtiSHp9TsTSNyTHY0FO5whE7jOTd9UE,3252 +pip/_vendor/rich/layout.py,sha256=ajkSFAtEVv9EFTcFs-w4uZfft7nEXhNzL7ZVdgrT5rI,14004 +pip/_vendor/rich/live.py,sha256=DhzAPEnjTxQuq9_0Y2xh2MUwQcP_aGPkenLfKETslwM,14270 +pip/_vendor/rich/live_render.py,sha256=zJtB471jGziBtEwxc54x12wEQtH4BuQr1SA8v9kU82w,3666 +pip/_vendor/rich/logging.py,sha256=ZgpKMMBY_BuMAI_BYzo-UtXak6t5oH9VK8m9Q2Lm0f4,12458 +pip/_vendor/rich/markup.py,sha256=3euGKP5s41NCQwaSjTnJxus5iZMHjxpIM0W6fCxra38,8451 +pip/_vendor/rich/measure.py,sha256=HmrIJX8sWRTHbgh8MxEay_83VkqNW_70s8aKP5ZcYI8,5305 +pip/_vendor/rich/padding.py,sha256=KVEI3tOwo9sgK1YNSuH__M1_jUWmLZwRVV_KmOtVzyM,4908 +pip/_vendor/rich/pager.py,sha256=SO_ETBFKbg3n_AgOzXm41Sv36YxXAyI3_R-KOY2_uSc,828 +pip/_vendor/rich/palette.py,sha256=lInvR1ODDT2f3UZMfL1grq7dY_pDdKHw4bdUgOGaM4Y,3396 +pip/_vendor/rich/panel.py,sha256=fFRHcviXvWhk3V3zx5Zwmsb_RL9KJ3esD-sU0NYEVyw,11235 +pip/_vendor/rich/pretty.py,sha256=gy3S72u4FRg2ytoo7N1ZDWDIvB4unbzd5iUGdgm-8fc,36391 +pip/_vendor/rich/progress.py,sha256=MtmCjTk5zYU_XtRHxRHTAEHG6hF9PeF7EMWbEPleIC0,60357 +pip/_vendor/rich/progress_bar.py,sha256=mZTPpJUwcfcdgQCTTz3kyY-fc79ddLwtx6Ghhxfo064,8162 +pip/_vendor/rich/prompt.py,sha256=l0RhQU-0UVTV9e08xW1BbIj0Jq2IXyChX4lC0lFNzt4,12447 +pip/_vendor/rich/protocol.py,sha256=5hHHDDNHckdk8iWH5zEbi-zuIVSF5hbU2jIo47R7lTE,1391 +pip/_vendor/rich/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +pip/_vendor/rich/region.py,sha256=rNT9xZrVZTYIXZC0NYn41CJQwYNbR-KecPOxTgQvB8Y,166 +pip/_vendor/rich/repr.py,sha256=5MZJZmONgC6kud-QW-_m1okXwL2aR6u6y-pUcUCJz28,4431 +pip/_vendor/rich/rule.py,sha256=0fNaS_aERa3UMRc3T5WMpN_sumtDxfaor2y3of1ftBk,4602 +pip/_vendor/rich/scope.py,sha256=TMUU8qo17thyqQCPqjDLYpg_UU1k5qVd-WwiJvnJVas,2843 +pip/_vendor/rich/screen.py,sha256=YoeReESUhx74grqb0mSSb9lghhysWmFHYhsbMVQjXO8,1591 +pip/_vendor/rich/segment.py,sha256=otnKeKGEV-WRlQVosfJVeFDcDxAKHpvJ_hLzSu5lumM,24743 +pip/_vendor/rich/spinner.py,sha256=PT5qgXPG3ZpqRj7n3EZQ6NW56mx3ldZqZCU7gEMyZk4,4364 +pip/_vendor/rich/status.py,sha256=kkPph3YeAZBo-X-4wPp8gTqZyU466NLwZBA4PZTTewo,4424 +pip/_vendor/rich/style.py,sha256=aSoUNbVgfP1PAnduAqgbbl4AMQy668qs2S1FEwr3Oqs,27067 +pip/_vendor/rich/styled.py,sha256=eZNnzGrI4ki_54pgY3Oj0T-x3lxdXTYh4_ryDB24wBU,1258 +pip/_vendor/rich/syntax.py,sha256=qqAnEUZ4K57Po81_5RBxnsuU4KRzSdvDPAhKw8ma_3E,35763 +pip/_vendor/rich/table.py,sha256=yXYUr0YsPpG466N50HCAw2bpb5ZUuuzdc-G66Zk-oTc,40103 +pip/_vendor/rich/terminal_theme.py,sha256=1j5-ufJfnvlAo5Qsi_ACZiXDmwMXzqgmFByObT9-yJY,3370 +pip/_vendor/rich/text.py,sha256=AO7JPCz6-gaN1thVLXMBntEmDPVYFgFNG1oM61_sanU,47552 +pip/_vendor/rich/theme.py,sha256=oNyhXhGagtDlbDye3tVu3esWOWk0vNkuxFw-_unlaK0,3771 +pip/_vendor/rich/themes.py,sha256=0xgTLozfabebYtcJtDdC5QkX5IVUEaviqDUJJh4YVFk,102 +pip/_vendor/rich/traceback.py,sha256=z8UoN7NbTQKW6YDDUVwOh7F8snZf6gYnUWtOrKsLE1w,31797 +pip/_vendor/rich/tree.py,sha256=yWnQ6rAvRGJ3qZGqBrxS2SW2TKBTNrP0SdY8QxOFPuw,9451 +pip/_vendor/tomli/__init__.py,sha256=PhNw_eyLgdn7McJ6nrAN8yIm3dXC75vr1sVGVVwDSpA,314 +pip/_vendor/tomli/__pycache__/__init__.cpython-312.pyc,, +pip/_vendor/tomli/__pycache__/_parser.cpython-312.pyc,, +pip/_vendor/tomli/__pycache__/_re.cpython-312.pyc,, +pip/_vendor/tomli/__pycache__/_types.cpython-312.pyc,, +pip/_vendor/tomli/_parser.py,sha256=9w8LG0jB7fwmZZWB0vVXbeejDHcl4ANIJxB2scEnDlA,25591 +pip/_vendor/tomli/_re.py,sha256=sh4sBDRgO94KJZwNIrgdcyV_qQast50YvzOAUGpRDKA,3171 +pip/_vendor/tomli/_types.py,sha256=-GTG2VUqkpxwMqzmVO4F7ybKddIbAnuAHXfmWQcTi3Q,254 +pip/_vendor/tomli/py.typed,sha256=8PjyZ1aVoQpRVvt71muvuq5qE-jTFZkK-GLHkhdebmc,26 +pip/_vendor/truststore/__init__.py,sha256=WIDeyzWm7EVX44g354M25vpRXbeY1lsPH6EmUJUcq4o,1264 +pip/_vendor/truststore/__pycache__/__init__.cpython-312.pyc,, +pip/_vendor/truststore/__pycache__/_api.cpython-312.pyc,, +pip/_vendor/truststore/__pycache__/_macos.cpython-312.pyc,, +pip/_vendor/truststore/__pycache__/_openssl.cpython-312.pyc,, +pip/_vendor/truststore/__pycache__/_ssl_constants.cpython-312.pyc,, +pip/_vendor/truststore/__pycache__/_windows.cpython-312.pyc,, +pip/_vendor/truststore/_api.py,sha256=GeXRNTlxPZ3kif4kNoh6JY0oE4QRzTGcgXr6l_X_Gk0,10555 +pip/_vendor/truststore/_macos.py,sha256=nZlLkOmszUE0g6ryRwBVGY5COzPyudcsiJtDWarM5LQ,20503 +pip/_vendor/truststore/_openssl.py,sha256=LLUZ7ZGaio-i5dpKKjKCSeSufmn6T8pi9lDcFnvSyq0,2324 +pip/_vendor/truststore/_ssl_constants.py,sha256=NUD4fVKdSD02ri7-db0tnO0VqLP9aHuzmStcW7tAl08,1130 +pip/_vendor/truststore/_windows.py,sha256=rAHyKYD8M7t-bXfG8VgOVa3TpfhVhbt4rZQlO45YuP8,17993 +pip/_vendor/truststore/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +pip/_vendor/typing_extensions.py,sha256=78hFl0HpDY-ylHUVCnWdU5nTHxUP2-S-3wEZk6CQmLk,134499 +pip/_vendor/urllib3/__init__.py,sha256=iXLcYiJySn0GNbWOOZDDApgBL1JgP44EZ8i1760S8Mc,3333 +pip/_vendor/urllib3/__pycache__/__init__.cpython-312.pyc,, +pip/_vendor/urllib3/__pycache__/_collections.cpython-312.pyc,, +pip/_vendor/urllib3/__pycache__/_version.cpython-312.pyc,, +pip/_vendor/urllib3/__pycache__/connection.cpython-312.pyc,, +pip/_vendor/urllib3/__pycache__/connectionpool.cpython-312.pyc,, +pip/_vendor/urllib3/__pycache__/exceptions.cpython-312.pyc,, +pip/_vendor/urllib3/__pycache__/fields.cpython-312.pyc,, +pip/_vendor/urllib3/__pycache__/filepost.cpython-312.pyc,, +pip/_vendor/urllib3/__pycache__/poolmanager.cpython-312.pyc,, +pip/_vendor/urllib3/__pycache__/request.cpython-312.pyc,, +pip/_vendor/urllib3/__pycache__/response.cpython-312.pyc,, +pip/_vendor/urllib3/_collections.py,sha256=pyASJJhW7wdOpqJj9QJA8FyGRfr8E8uUUhqUvhF0728,11372 +pip/_vendor/urllib3/_version.py,sha256=t9wGB6ooOTXXgiY66K1m6BZS1CJyXHAU8EoWDTe6Shk,64 +pip/_vendor/urllib3/connection.py,sha256=ttIA909BrbTUzwkqEe_TzZVh4JOOj7g61Ysei2mrwGg,20314 +pip/_vendor/urllib3/connectionpool.py,sha256=e2eiAwNbFNCKxj4bwDKNK-w7HIdSz3OmMxU_TIt-evQ,40408 +pip/_vendor/urllib3/contrib/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +pip/_vendor/urllib3/contrib/__pycache__/__init__.cpython-312.pyc,, +pip/_vendor/urllib3/contrib/__pycache__/_appengine_environ.cpython-312.pyc,, +pip/_vendor/urllib3/contrib/__pycache__/appengine.cpython-312.pyc,, +pip/_vendor/urllib3/contrib/__pycache__/ntlmpool.cpython-312.pyc,, +pip/_vendor/urllib3/contrib/__pycache__/pyopenssl.cpython-312.pyc,, +pip/_vendor/urllib3/contrib/__pycache__/securetransport.cpython-312.pyc,, +pip/_vendor/urllib3/contrib/__pycache__/socks.cpython-312.pyc,, +pip/_vendor/urllib3/contrib/_appengine_environ.py,sha256=bDbyOEhW2CKLJcQqAKAyrEHN-aklsyHFKq6vF8ZFsmk,957 +pip/_vendor/urllib3/contrib/_securetransport/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +pip/_vendor/urllib3/contrib/_securetransport/__pycache__/__init__.cpython-312.pyc,, +pip/_vendor/urllib3/contrib/_securetransport/__pycache__/bindings.cpython-312.pyc,, +pip/_vendor/urllib3/contrib/_securetransport/__pycache__/low_level.cpython-312.pyc,, +pip/_vendor/urllib3/contrib/_securetransport/bindings.py,sha256=4Xk64qIkPBt09A5q-RIFUuDhNc9mXilVapm7WnYnzRw,17632 +pip/_vendor/urllib3/contrib/_securetransport/low_level.py,sha256=B2JBB2_NRP02xK6DCa1Pa9IuxrPwxzDzZbixQkb7U9M,13922 +pip/_vendor/urllib3/contrib/appengine.py,sha256=VR68eAVE137lxTgjBDwCna5UiBZTOKa01Aj_-5BaCz4,11036 +pip/_vendor/urllib3/contrib/ntlmpool.py,sha256=NlfkW7WMdW8ziqudopjHoW299og1BTWi0IeIibquFwk,4528 +pip/_vendor/urllib3/contrib/pyopenssl.py,sha256=hDJh4MhyY_p-oKlFcYcQaVQRDv6GMmBGuW9yjxyeejM,17081 +pip/_vendor/urllib3/contrib/securetransport.py,sha256=Fef1IIUUFHqpevzXiDPbIGkDKchY2FVKeVeLGR1Qq3g,34446 +pip/_vendor/urllib3/contrib/socks.py,sha256=aRi9eWXo9ZEb95XUxef4Z21CFlnnjbEiAo9HOseoMt4,7097 +pip/_vendor/urllib3/exceptions.py,sha256=0Mnno3KHTNfXRfY7638NufOPkUb6mXOm-Lqj-4x2w8A,8217 +pip/_vendor/urllib3/fields.py,sha256=kvLDCg_JmH1lLjUUEY_FLS8UhY7hBvDPuVETbY8mdrM,8579 +pip/_vendor/urllib3/filepost.py,sha256=5b_qqgRHVlL7uLtdAYBzBh-GHmU5AfJVt_2N0XS3PeY,2440 +pip/_vendor/urllib3/packages/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +pip/_vendor/urllib3/packages/__pycache__/__init__.cpython-312.pyc,, +pip/_vendor/urllib3/packages/__pycache__/six.cpython-312.pyc,, +pip/_vendor/urllib3/packages/backports/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +pip/_vendor/urllib3/packages/backports/__pycache__/__init__.cpython-312.pyc,, +pip/_vendor/urllib3/packages/backports/__pycache__/makefile.cpython-312.pyc,, +pip/_vendor/urllib3/packages/backports/__pycache__/weakref_finalize.cpython-312.pyc,, +pip/_vendor/urllib3/packages/backports/makefile.py,sha256=nbzt3i0agPVP07jqqgjhaYjMmuAi_W5E0EywZivVO8E,1417 +pip/_vendor/urllib3/packages/backports/weakref_finalize.py,sha256=tRCal5OAhNSRyb0DhHp-38AtIlCsRP8BxF3NX-6rqIA,5343 +pip/_vendor/urllib3/packages/six.py,sha256=b9LM0wBXv7E7SrbCjAm4wwN-hrH-iNxv18LgWNMMKPo,34665 +pip/_vendor/urllib3/poolmanager.py,sha256=aWyhXRtNO4JUnCSVVqKTKQd8EXTvUm1VN9pgs2bcONo,19990 +pip/_vendor/urllib3/request.py,sha256=YTWFNr7QIwh7E1W9dde9LM77v2VWTJ5V78XuTTw7D1A,6691 +pip/_vendor/urllib3/response.py,sha256=fmDJAFkG71uFTn-sVSTh2Iw0WmcXQYqkbRjihvwBjU8,30641 +pip/_vendor/urllib3/util/__init__.py,sha256=JEmSmmqqLyaw8P51gUImZh8Gwg9i1zSe-DoqAitn2nc,1155 +pip/_vendor/urllib3/util/__pycache__/__init__.cpython-312.pyc,, +pip/_vendor/urllib3/util/__pycache__/connection.cpython-312.pyc,, +pip/_vendor/urllib3/util/__pycache__/proxy.cpython-312.pyc,, +pip/_vendor/urllib3/util/__pycache__/queue.cpython-312.pyc,, +pip/_vendor/urllib3/util/__pycache__/request.cpython-312.pyc,, +pip/_vendor/urllib3/util/__pycache__/response.cpython-312.pyc,, +pip/_vendor/urllib3/util/__pycache__/retry.cpython-312.pyc,, +pip/_vendor/urllib3/util/__pycache__/ssl_.cpython-312.pyc,, +pip/_vendor/urllib3/util/__pycache__/ssl_match_hostname.cpython-312.pyc,, +pip/_vendor/urllib3/util/__pycache__/ssltransport.cpython-312.pyc,, +pip/_vendor/urllib3/util/__pycache__/timeout.cpython-312.pyc,, +pip/_vendor/urllib3/util/__pycache__/url.cpython-312.pyc,, +pip/_vendor/urllib3/util/__pycache__/wait.cpython-312.pyc,, +pip/_vendor/urllib3/util/connection.py,sha256=5Lx2B1PW29KxBn2T0xkN1CBgRBa3gGVJBKoQoRogEVk,4901 +pip/_vendor/urllib3/util/proxy.py,sha256=zUvPPCJrp6dOF0N4GAVbOcl6o-4uXKSrGiTkkr5vUS4,1605 +pip/_vendor/urllib3/util/queue.py,sha256=nRgX8_eX-_VkvxoX096QWoz8Ps0QHUAExILCY_7PncM,498 +pip/_vendor/urllib3/util/request.py,sha256=C0OUt2tcU6LRiQJ7YYNP9GvPrSvl7ziIBekQ-5nlBZk,3997 +pip/_vendor/urllib3/util/response.py,sha256=GJpg3Egi9qaJXRwBh5wv-MNuRWan5BIu40oReoxWP28,3510 +pip/_vendor/urllib3/util/retry.py,sha256=6ENvOZ8PBDzh8kgixpql9lIrb2dxH-k7ZmBanJF2Ng4,22050 +pip/_vendor/urllib3/util/ssl_.py,sha256=QDuuTxPSCj1rYtZ4xpD7Ux-r20TD50aHyqKyhQ7Bq4A,17460 +pip/_vendor/urllib3/util/ssl_match_hostname.py,sha256=Ir4cZVEjmAk8gUAIHWSi7wtOO83UCYABY2xFD1Ql_WA,5758 +pip/_vendor/urllib3/util/ssltransport.py,sha256=NA-u5rMTrDFDFC8QzRKUEKMG0561hOD4qBTr3Z4pv6E,6895 +pip/_vendor/urllib3/util/timeout.py,sha256=cwq4dMk87mJHSBktK1miYJ-85G-3T3RmT20v7SFCpno,10168 +pip/_vendor/urllib3/util/url.py,sha256=lCAE7M5myA8EDdW0sJuyyZhVB9K_j38ljWhHAnFaWoE,14296 +pip/_vendor/urllib3/util/wait.py,sha256=fOX0_faozG2P7iVojQoE1mbydweNyTcm-hXEfFrTtLI,5403 +pip/_vendor/vendor.txt,sha256=EW-E3cE5XEAtVFzGInikArOMDxGP0DLUWzXpY4RZfFY,333 +pip/py.typed,sha256=EBVvvPRTn_eIpz5e5QztSCdrMX7Qwd7VP93RSoIlZ2I,286 diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip-25.0.1.dist-info/REQUESTED b/yap_lab_3/.venv/lib/python3.12/site-packages/pip-25.0.1.dist-info/REQUESTED new file mode 100644 index 0000000..e69de29 diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip-25.0.1.dist-info/WHEEL b/yap_lab_3/.venv/lib/python3.12/site-packages/pip-25.0.1.dist-info/WHEEL new file mode 100644 index 0000000..505164b --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip-25.0.1.dist-info/WHEEL @@ -0,0 +1,5 @@ +Wheel-Version: 1.0 +Generator: setuptools (75.8.0) +Root-Is-Purelib: true +Tag: py3-none-any + diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip-25.0.1.dist-info/entry_points.txt b/yap_lab_3/.venv/lib/python3.12/site-packages/pip-25.0.1.dist-info/entry_points.txt new file mode 100644 index 0000000..25fcf7e --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip-25.0.1.dist-info/entry_points.txt @@ -0,0 +1,3 @@ +[console_scripts] +pip = pip._internal.cli.main:main +pip3 = pip._internal.cli.main:main diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip-25.0.1.dist-info/top_level.txt b/yap_lab_3/.venv/lib/python3.12/site-packages/pip-25.0.1.dist-info/top_level.txt new file mode 100644 index 0000000..a1b589e --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip-25.0.1.dist-info/top_level.txt @@ -0,0 +1 @@ +pip diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/__init__.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/__init__.py new file mode 100644 index 0000000..d628f93 --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/__init__.py @@ -0,0 +1,13 @@ +from typing import List, Optional + +__version__ = "25.0.1" + + +def main(args: Optional[List[str]] = None) -> int: + """This is an internal API only meant for use by pip's own console scripts. + + For additional details, see https://github.com/pypa/pip/issues/7498. + """ + from pip._internal.utils.entrypoints import _wrapper + + return _wrapper(args) diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/__main__.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/__main__.py new file mode 100644 index 0000000..5991326 --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/__main__.py @@ -0,0 +1,24 @@ +import os +import sys + +# Remove '' and current working directory from the first entry +# of sys.path, if present to avoid using current directory +# in pip commands check, freeze, install, list and show, +# when invoked as python -m pip +if sys.path[0] in ("", os.getcwd()): + sys.path.pop(0) + +# If we are running from a wheel, add the wheel to sys.path +# This allows the usage python pip-*.whl/pip install pip-*.whl +if __package__ == "": + # __file__ is pip-*.whl/pip/__main__.py + # first dirname call strips of '/__main__.py', second strips off '/pip' + # Resulting path is the name of the wheel itself + # Add that to sys.path so we can import pip + path = os.path.dirname(os.path.dirname(__file__)) + sys.path.insert(0, path) + +if __name__ == "__main__": + from pip._internal.cli.main import main as _main + + sys.exit(_main()) diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/__pip-runner__.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/__pip-runner__.py new file mode 100644 index 0000000..c633787 --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/__pip-runner__.py @@ -0,0 +1,50 @@ +"""Execute exactly this copy of pip, within a different environment. + +This file is named as it is, to ensure that this module can't be imported via +an import statement. +""" + +# /!\ This version compatibility check section must be Python 2 compatible. /!\ + +import sys + +# Copied from pyproject.toml +PYTHON_REQUIRES = (3, 8) + + +def version_str(version): # type: ignore + return ".".join(str(v) for v in version) + + +if sys.version_info[:2] < PYTHON_REQUIRES: + raise SystemExit( + "This version of pip does not support python {} (requires >={}).".format( + version_str(sys.version_info[:2]), version_str(PYTHON_REQUIRES) + ) + ) + +# From here on, we can use Python 3 features, but the syntax must remain +# Python 2 compatible. + +import runpy # noqa: E402 +from importlib.machinery import PathFinder # noqa: E402 +from os.path import dirname # noqa: E402 + +PIP_SOURCES_ROOT = dirname(dirname(__file__)) + + +class PipImportRedirectingFinder: + @classmethod + def find_spec(self, fullname, path=None, target=None): # type: ignore + if fullname != "pip": + return None + + spec = PathFinder.find_spec(fullname, [PIP_SOURCES_ROOT], target) + assert spec, (PIP_SOURCES_ROOT, fullname) + return spec + + +sys.meta_path.insert(0, PipImportRedirectingFinder()) + +assert __name__ == "__main__", "Cannot run __pip-runner__.py as a non-main module" +runpy.run_module("pip", run_name="__main__", alter_sys=True) diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/__pycache__/__init__.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000..8bb458b Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/__pycache__/__init__.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/__pycache__/__main__.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/__pycache__/__main__.cpython-312.pyc new file mode 100644 index 0000000..eea1ca4 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/__pycache__/__main__.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/__pycache__/__pip-runner__.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/__pycache__/__pip-runner__.cpython-312.pyc new file mode 100644 index 0000000..a5276d3 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/__pycache__/__pip-runner__.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/__init__.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/__init__.py new file mode 100644 index 0000000..1a5b7f8 --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/__init__.py @@ -0,0 +1,18 @@ +from typing import List, Optional + +from pip._internal.utils import _log + +# init_logging() must be called before any call to logging.getLogger() +# which happens at import of most modules. +_log.init_logging() + + +def main(args: Optional[List[str]] = None) -> int: + """This is preserved for old console scripts that may still be referencing + it. + + For additional details, see https://github.com/pypa/pip/issues/7498. + """ + from pip._internal.utils.entrypoints import _wrapper + + return _wrapper(args) diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/__pycache__/__init__.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000..ef4b11b Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/__pycache__/__init__.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/__pycache__/build_env.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/__pycache__/build_env.cpython-312.pyc new file mode 100644 index 0000000..a08657f Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/__pycache__/build_env.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/__pycache__/cache.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/__pycache__/cache.cpython-312.pyc new file mode 100644 index 0000000..c1249d7 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/__pycache__/cache.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/__pycache__/configuration.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/__pycache__/configuration.cpython-312.pyc new file mode 100644 index 0000000..738aaee Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/__pycache__/configuration.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/__pycache__/exceptions.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/__pycache__/exceptions.cpython-312.pyc new file mode 100644 index 0000000..0b5ba3e Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/__pycache__/exceptions.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/__pycache__/main.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/__pycache__/main.cpython-312.pyc new file mode 100644 index 0000000..97bf70c Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/__pycache__/main.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/__pycache__/pyproject.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/__pycache__/pyproject.cpython-312.pyc new file mode 100644 index 0000000..e6dd368 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/__pycache__/pyproject.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/__pycache__/self_outdated_check.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/__pycache__/self_outdated_check.cpython-312.pyc new file mode 100644 index 0000000..8a5de63 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/__pycache__/self_outdated_check.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/__pycache__/wheel_builder.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/__pycache__/wheel_builder.cpython-312.pyc new file mode 100644 index 0000000..df4f8f2 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/__pycache__/wheel_builder.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/build_env.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/build_env.py new file mode 100644 index 0000000..e8d1aca --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/build_env.py @@ -0,0 +1,322 @@ +"""Build Environment used for isolation during sdist building +""" + +import logging +import os +import pathlib +import site +import sys +import textwrap +from collections import OrderedDict +from types import TracebackType +from typing import TYPE_CHECKING, Iterable, List, Optional, Set, Tuple, Type, Union + +from pip._vendor.packaging.version import Version + +from pip import __file__ as pip_location +from pip._internal.cli.spinners import open_spinner +from pip._internal.locations import get_platlib, get_purelib, get_scheme +from pip._internal.metadata import get_default_environment, get_environment +from pip._internal.utils.logging import VERBOSE +from pip._internal.utils.packaging import get_requirement +from pip._internal.utils.subprocess import call_subprocess +from pip._internal.utils.temp_dir import TempDirectory, tempdir_kinds + +if TYPE_CHECKING: + from pip._internal.index.package_finder import PackageFinder + +logger = logging.getLogger(__name__) + + +def _dedup(a: str, b: str) -> Union[Tuple[str], Tuple[str, str]]: + return (a, b) if a != b else (a,) + + +class _Prefix: + def __init__(self, path: str) -> None: + self.path = path + self.setup = False + scheme = get_scheme("", prefix=path) + self.bin_dir = scheme.scripts + self.lib_dirs = _dedup(scheme.purelib, scheme.platlib) + + +def get_runnable_pip() -> str: + """Get a file to pass to a Python executable, to run the currently-running pip. + + This is used to run a pip subprocess, for installing requirements into the build + environment. + """ + source = pathlib.Path(pip_location).resolve().parent + + if not source.is_dir(): + # This would happen if someone is using pip from inside a zip file. In that + # case, we can use that directly. + return str(source) + + return os.fsdecode(source / "__pip-runner__.py") + + +def _get_system_sitepackages() -> Set[str]: + """Get system site packages + + Usually from site.getsitepackages, + but fallback on `get_purelib()/get_platlib()` if unavailable + (e.g. in a virtualenv created by virtualenv<20) + + Returns normalized set of strings. + """ + if hasattr(site, "getsitepackages"): + system_sites = site.getsitepackages() + else: + # virtualenv < 20 overwrites site.py without getsitepackages + # fallback on get_purelib/get_platlib. + # this is known to miss things, but shouldn't in the cases + # where getsitepackages() has been removed (inside a virtualenv) + system_sites = [get_purelib(), get_platlib()] + return {os.path.normcase(path) for path in system_sites} + + +class BuildEnvironment: + """Creates and manages an isolated environment to install build deps""" + + def __init__(self) -> None: + temp_dir = TempDirectory(kind=tempdir_kinds.BUILD_ENV, globally_managed=True) + + self._prefixes = OrderedDict( + (name, _Prefix(os.path.join(temp_dir.path, name))) + for name in ("normal", "overlay") + ) + + self._bin_dirs: List[str] = [] + self._lib_dirs: List[str] = [] + for prefix in reversed(list(self._prefixes.values())): + self._bin_dirs.append(prefix.bin_dir) + self._lib_dirs.extend(prefix.lib_dirs) + + # Customize site to: + # - ensure .pth files are honored + # - prevent access to system site packages + system_sites = _get_system_sitepackages() + + self._site_dir = os.path.join(temp_dir.path, "site") + if not os.path.exists(self._site_dir): + os.mkdir(self._site_dir) + with open( + os.path.join(self._site_dir, "sitecustomize.py"), "w", encoding="utf-8" + ) as fp: + fp.write( + textwrap.dedent( + """ + import os, site, sys + + # First, drop system-sites related paths. + original_sys_path = sys.path[:] + known_paths = set() + for path in {system_sites!r}: + site.addsitedir(path, known_paths=known_paths) + system_paths = set( + os.path.normcase(path) + for path in sys.path[len(original_sys_path):] + ) + original_sys_path = [ + path for path in original_sys_path + if os.path.normcase(path) not in system_paths + ] + sys.path = original_sys_path + + # Second, add lib directories. + # ensuring .pth file are processed. + for path in {lib_dirs!r}: + assert not path in sys.path + site.addsitedir(path) + """ + ).format(system_sites=system_sites, lib_dirs=self._lib_dirs) + ) + + def __enter__(self) -> None: + self._save_env = { + name: os.environ.get(name, None) + for name in ("PATH", "PYTHONNOUSERSITE", "PYTHONPATH") + } + + path = self._bin_dirs[:] + old_path = self._save_env["PATH"] + if old_path: + path.extend(old_path.split(os.pathsep)) + + pythonpath = [self._site_dir] + + os.environ.update( + { + "PATH": os.pathsep.join(path), + "PYTHONNOUSERSITE": "1", + "PYTHONPATH": os.pathsep.join(pythonpath), + } + ) + + def __exit__( + self, + exc_type: Optional[Type[BaseException]], + exc_val: Optional[BaseException], + exc_tb: Optional[TracebackType], + ) -> None: + for varname, old_value in self._save_env.items(): + if old_value is None: + os.environ.pop(varname, None) + else: + os.environ[varname] = old_value + + def check_requirements( + self, reqs: Iterable[str] + ) -> Tuple[Set[Tuple[str, str]], Set[str]]: + """Return 2 sets: + - conflicting requirements: set of (installed, wanted) reqs tuples + - missing requirements: set of reqs + """ + missing = set() + conflicting = set() + if reqs: + env = ( + get_environment(self._lib_dirs) + if hasattr(self, "_lib_dirs") + else get_default_environment() + ) + for req_str in reqs: + req = get_requirement(req_str) + # We're explicitly evaluating with an empty extra value, since build + # environments are not provided any mechanism to select specific extras. + if req.marker is not None and not req.marker.evaluate({"extra": ""}): + continue + dist = env.get_distribution(req.name) + if not dist: + missing.add(req_str) + continue + if isinstance(dist.version, Version): + installed_req_str = f"{req.name}=={dist.version}" + else: + installed_req_str = f"{req.name}==={dist.version}" + if not req.specifier.contains(dist.version, prereleases=True): + conflicting.add((installed_req_str, req_str)) + # FIXME: Consider direct URL? + return conflicting, missing + + def install_requirements( + self, + finder: "PackageFinder", + requirements: Iterable[str], + prefix_as_string: str, + *, + kind: str, + ) -> None: + prefix = self._prefixes[prefix_as_string] + assert not prefix.setup + prefix.setup = True + if not requirements: + return + self._install_requirements( + get_runnable_pip(), + finder, + requirements, + prefix, + kind=kind, + ) + + @staticmethod + def _install_requirements( + pip_runnable: str, + finder: "PackageFinder", + requirements: Iterable[str], + prefix: _Prefix, + *, + kind: str, + ) -> None: + args: List[str] = [ + sys.executable, + pip_runnable, + "install", + "--ignore-installed", + "--no-user", + "--prefix", + prefix.path, + "--no-warn-script-location", + "--disable-pip-version-check", + # The prefix specified two lines above, thus + # target from config file or env var should be ignored + "--target", + "", + ] + if logger.getEffectiveLevel() <= logging.DEBUG: + args.append("-vv") + elif logger.getEffectiveLevel() <= VERBOSE: + args.append("-v") + for format_control in ("no_binary", "only_binary"): + formats = getattr(finder.format_control, format_control) + args.extend( + ( + "--" + format_control.replace("_", "-"), + ",".join(sorted(formats or {":none:"})), + ) + ) + + index_urls = finder.index_urls + if index_urls: + args.extend(["-i", index_urls[0]]) + for extra_index in index_urls[1:]: + args.extend(["--extra-index-url", extra_index]) + else: + args.append("--no-index") + for link in finder.find_links: + args.extend(["--find-links", link]) + + if finder.proxy: + args.extend(["--proxy", finder.proxy]) + for host in finder.trusted_hosts: + args.extend(["--trusted-host", host]) + if finder.custom_cert: + args.extend(["--cert", finder.custom_cert]) + if finder.client_cert: + args.extend(["--client-cert", finder.client_cert]) + if finder.allow_all_prereleases: + args.append("--pre") + if finder.prefer_binary: + args.append("--prefer-binary") + args.append("--") + args.extend(requirements) + with open_spinner(f"Installing {kind}") as spinner: + call_subprocess( + args, + command_desc=f"pip subprocess to install {kind}", + spinner=spinner, + ) + + +class NoOpBuildEnvironment(BuildEnvironment): + """A no-op drop-in replacement for BuildEnvironment""" + + def __init__(self) -> None: + pass + + def __enter__(self) -> None: + pass + + def __exit__( + self, + exc_type: Optional[Type[BaseException]], + exc_val: Optional[BaseException], + exc_tb: Optional[TracebackType], + ) -> None: + pass + + def cleanup(self) -> None: + pass + + def install_requirements( + self, + finder: "PackageFinder", + requirements: Iterable[str], + prefix_as_string: str, + *, + kind: str, + ) -> None: + raise NotImplementedError() diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/cache.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/cache.py new file mode 100644 index 0000000..6b45126 --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/cache.py @@ -0,0 +1,290 @@ +"""Cache Management +""" + +import hashlib +import json +import logging +import os +from pathlib import Path +from typing import Any, Dict, List, Optional + +from pip._vendor.packaging.tags import Tag, interpreter_name, interpreter_version +from pip._vendor.packaging.utils import canonicalize_name + +from pip._internal.exceptions import InvalidWheelFilename +from pip._internal.models.direct_url import DirectUrl +from pip._internal.models.link import Link +from pip._internal.models.wheel import Wheel +from pip._internal.utils.temp_dir import TempDirectory, tempdir_kinds +from pip._internal.utils.urls import path_to_url + +logger = logging.getLogger(__name__) + +ORIGIN_JSON_NAME = "origin.json" + + +def _hash_dict(d: Dict[str, str]) -> str: + """Return a stable sha224 of a dictionary.""" + s = json.dumps(d, sort_keys=True, separators=(",", ":"), ensure_ascii=True) + return hashlib.sha224(s.encode("ascii")).hexdigest() + + +class Cache: + """An abstract class - provides cache directories for data from links + + :param cache_dir: The root of the cache. + """ + + def __init__(self, cache_dir: str) -> None: + super().__init__() + assert not cache_dir or os.path.isabs(cache_dir) + self.cache_dir = cache_dir or None + + def _get_cache_path_parts(self, link: Link) -> List[str]: + """Get parts of part that must be os.path.joined with cache_dir""" + + # We want to generate an url to use as our cache key, we don't want to + # just reuse the URL because it might have other items in the fragment + # and we don't care about those. + key_parts = {"url": link.url_without_fragment} + if link.hash_name is not None and link.hash is not None: + key_parts[link.hash_name] = link.hash + if link.subdirectory_fragment: + key_parts["subdirectory"] = link.subdirectory_fragment + + # Include interpreter name, major and minor version in cache key + # to cope with ill-behaved sdists that build a different wheel + # depending on the python version their setup.py is being run on, + # and don't encode the difference in compatibility tags. + # https://github.com/pypa/pip/issues/7296 + key_parts["interpreter_name"] = interpreter_name() + key_parts["interpreter_version"] = interpreter_version() + + # Encode our key url with sha224, we'll use this because it has similar + # security properties to sha256, but with a shorter total output (and + # thus less secure). However the differences don't make a lot of + # difference for our use case here. + hashed = _hash_dict(key_parts) + + # We want to nest the directories some to prevent having a ton of top + # level directories where we might run out of sub directories on some + # FS. + parts = [hashed[:2], hashed[2:4], hashed[4:6], hashed[6:]] + + return parts + + def _get_candidates(self, link: Link, canonical_package_name: str) -> List[Any]: + can_not_cache = not self.cache_dir or not canonical_package_name or not link + if can_not_cache: + return [] + + path = self.get_path_for_link(link) + if os.path.isdir(path): + return [(candidate, path) for candidate in os.listdir(path)] + return [] + + def get_path_for_link(self, link: Link) -> str: + """Return a directory to store cached items in for link.""" + raise NotImplementedError() + + def get( + self, + link: Link, + package_name: Optional[str], + supported_tags: List[Tag], + ) -> Link: + """Returns a link to a cached item if it exists, otherwise returns the + passed link. + """ + raise NotImplementedError() + + +class SimpleWheelCache(Cache): + """A cache of wheels for future installs.""" + + def __init__(self, cache_dir: str) -> None: + super().__init__(cache_dir) + + def get_path_for_link(self, link: Link) -> str: + """Return a directory to store cached wheels for link + + Because there are M wheels for any one sdist, we provide a directory + to cache them in, and then consult that directory when looking up + cache hits. + + We only insert things into the cache if they have plausible version + numbers, so that we don't contaminate the cache with things that were + not unique. E.g. ./package might have dozens of installs done for it + and build a version of 0.0...and if we built and cached a wheel, we'd + end up using the same wheel even if the source has been edited. + + :param link: The link of the sdist for which this will cache wheels. + """ + parts = self._get_cache_path_parts(link) + assert self.cache_dir + # Store wheels within the root cache_dir + return os.path.join(self.cache_dir, "wheels", *parts) + + def get( + self, + link: Link, + package_name: Optional[str], + supported_tags: List[Tag], + ) -> Link: + candidates = [] + + if not package_name: + return link + + canonical_package_name = canonicalize_name(package_name) + for wheel_name, wheel_dir in self._get_candidates(link, canonical_package_name): + try: + wheel = Wheel(wheel_name) + except InvalidWheelFilename: + continue + if canonicalize_name(wheel.name) != canonical_package_name: + logger.debug( + "Ignoring cached wheel %s for %s as it " + "does not match the expected distribution name %s.", + wheel_name, + link, + package_name, + ) + continue + if not wheel.supported(supported_tags): + # Built for a different python/arch/etc + continue + candidates.append( + ( + wheel.support_index_min(supported_tags), + wheel_name, + wheel_dir, + ) + ) + + if not candidates: + return link + + _, wheel_name, wheel_dir = min(candidates) + return Link(path_to_url(os.path.join(wheel_dir, wheel_name))) + + +class EphemWheelCache(SimpleWheelCache): + """A SimpleWheelCache that creates it's own temporary cache directory""" + + def __init__(self) -> None: + self._temp_dir = TempDirectory( + kind=tempdir_kinds.EPHEM_WHEEL_CACHE, + globally_managed=True, + ) + + super().__init__(self._temp_dir.path) + + +class CacheEntry: + def __init__( + self, + link: Link, + persistent: bool, + ): + self.link = link + self.persistent = persistent + self.origin: Optional[DirectUrl] = None + origin_direct_url_path = Path(self.link.file_path).parent / ORIGIN_JSON_NAME + if origin_direct_url_path.exists(): + try: + self.origin = DirectUrl.from_json( + origin_direct_url_path.read_text(encoding="utf-8") + ) + except Exception as e: + logger.warning( + "Ignoring invalid cache entry origin file %s for %s (%s)", + origin_direct_url_path, + link.filename, + e, + ) + + +class WheelCache(Cache): + """Wraps EphemWheelCache and SimpleWheelCache into a single Cache + + This Cache allows for gracefully degradation, using the ephem wheel cache + when a certain link is not found in the simple wheel cache first. + """ + + def __init__(self, cache_dir: str) -> None: + super().__init__(cache_dir) + self._wheel_cache = SimpleWheelCache(cache_dir) + self._ephem_cache = EphemWheelCache() + + def get_path_for_link(self, link: Link) -> str: + return self._wheel_cache.get_path_for_link(link) + + def get_ephem_path_for_link(self, link: Link) -> str: + return self._ephem_cache.get_path_for_link(link) + + def get( + self, + link: Link, + package_name: Optional[str], + supported_tags: List[Tag], + ) -> Link: + cache_entry = self.get_cache_entry(link, package_name, supported_tags) + if cache_entry is None: + return link + return cache_entry.link + + def get_cache_entry( + self, + link: Link, + package_name: Optional[str], + supported_tags: List[Tag], + ) -> Optional[CacheEntry]: + """Returns a CacheEntry with a link to a cached item if it exists or + None. The cache entry indicates if the item was found in the persistent + or ephemeral cache. + """ + retval = self._wheel_cache.get( + link=link, + package_name=package_name, + supported_tags=supported_tags, + ) + if retval is not link: + return CacheEntry(retval, persistent=True) + + retval = self._ephem_cache.get( + link=link, + package_name=package_name, + supported_tags=supported_tags, + ) + if retval is not link: + return CacheEntry(retval, persistent=False) + + return None + + @staticmethod + def record_download_origin(cache_dir: str, download_info: DirectUrl) -> None: + origin_path = Path(cache_dir) / ORIGIN_JSON_NAME + if origin_path.exists(): + try: + origin = DirectUrl.from_json(origin_path.read_text(encoding="utf-8")) + except Exception as e: + logger.warning( + "Could not read origin file %s in cache entry (%s). " + "Will attempt to overwrite it.", + origin_path, + e, + ) + else: + # TODO: use DirectUrl.equivalent when + # https://github.com/pypa/pip/pull/10564 is merged. + if origin.url != download_info.url: + logger.warning( + "Origin URL %s in cache entry %s does not match download URL " + "%s. This is likely a pip bug or a cache corruption issue. " + "Will overwrite it with the new value.", + origin.url, + cache_dir, + download_info.url, + ) + origin_path.write_text(download_info.to_json(), encoding="utf-8") diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/cli/__init__.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/cli/__init__.py new file mode 100644 index 0000000..e589bb9 --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/cli/__init__.py @@ -0,0 +1,4 @@ +"""Subpackage containing all of pip's command line interface related code +""" + +# This file intentionally does not import submodules diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/cli/__pycache__/__init__.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/cli/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000..c97b2c9 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/cli/__pycache__/__init__.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/cli/__pycache__/autocompletion.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/cli/__pycache__/autocompletion.cpython-312.pyc new file mode 100644 index 0000000..edda59f Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/cli/__pycache__/autocompletion.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/cli/__pycache__/base_command.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/cli/__pycache__/base_command.cpython-312.pyc new file mode 100644 index 0000000..2e245e0 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/cli/__pycache__/base_command.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/cli/__pycache__/cmdoptions.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/cli/__pycache__/cmdoptions.cpython-312.pyc new file mode 100644 index 0000000..57aa67e Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/cli/__pycache__/cmdoptions.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/cli/__pycache__/command_context.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/cli/__pycache__/command_context.cpython-312.pyc new file mode 100644 index 0000000..fbe1d8c Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/cli/__pycache__/command_context.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/cli/__pycache__/index_command.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/cli/__pycache__/index_command.cpython-312.pyc new file mode 100644 index 0000000..471f2da Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/cli/__pycache__/index_command.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/cli/__pycache__/main.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/cli/__pycache__/main.cpython-312.pyc new file mode 100644 index 0000000..6339c6b Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/cli/__pycache__/main.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/cli/__pycache__/main_parser.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/cli/__pycache__/main_parser.cpython-312.pyc new file mode 100644 index 0000000..d99c211 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/cli/__pycache__/main_parser.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/cli/__pycache__/parser.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/cli/__pycache__/parser.cpython-312.pyc new file mode 100644 index 0000000..9d20492 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/cli/__pycache__/parser.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/cli/__pycache__/progress_bars.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/cli/__pycache__/progress_bars.cpython-312.pyc new file mode 100644 index 0000000..0ffeb9f Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/cli/__pycache__/progress_bars.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/cli/__pycache__/req_command.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/cli/__pycache__/req_command.cpython-312.pyc new file mode 100644 index 0000000..7c88e70 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/cli/__pycache__/req_command.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/cli/__pycache__/spinners.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/cli/__pycache__/spinners.cpython-312.pyc new file mode 100644 index 0000000..df8761e Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/cli/__pycache__/spinners.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/cli/__pycache__/status_codes.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/cli/__pycache__/status_codes.cpython-312.pyc new file mode 100644 index 0000000..510092c Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/cli/__pycache__/status_codes.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/cli/autocompletion.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/cli/autocompletion.py new file mode 100644 index 0000000..f3f70ac --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/cli/autocompletion.py @@ -0,0 +1,176 @@ +"""Logic that powers autocompletion installed by ``pip completion``. +""" + +import optparse +import os +import sys +from itertools import chain +from typing import Any, Iterable, List, Optional + +from pip._internal.cli.main_parser import create_main_parser +from pip._internal.commands import commands_dict, create_command +from pip._internal.metadata import get_default_environment + + +def autocomplete() -> None: + """Entry Point for completion of main and subcommand options.""" + # Don't complete if user hasn't sourced bash_completion file. + if "PIP_AUTO_COMPLETE" not in os.environ: + return + # Don't complete if autocompletion environment variables + # are not present + if not os.environ.get("COMP_WORDS") or not os.environ.get("COMP_CWORD"): + return + cwords = os.environ["COMP_WORDS"].split()[1:] + cword = int(os.environ["COMP_CWORD"]) + try: + current = cwords[cword - 1] + except IndexError: + current = "" + + parser = create_main_parser() + subcommands = list(commands_dict) + options = [] + + # subcommand + subcommand_name: Optional[str] = None + for word in cwords: + if word in subcommands: + subcommand_name = word + break + # subcommand options + if subcommand_name is not None: + # special case: 'help' subcommand has no options + if subcommand_name == "help": + sys.exit(1) + # special case: list locally installed dists for show and uninstall + should_list_installed = not current.startswith("-") and subcommand_name in [ + "show", + "uninstall", + ] + if should_list_installed: + env = get_default_environment() + lc = current.lower() + installed = [ + dist.canonical_name + for dist in env.iter_installed_distributions(local_only=True) + if dist.canonical_name.startswith(lc) + and dist.canonical_name not in cwords[1:] + ] + # if there are no dists installed, fall back to option completion + if installed: + for dist in installed: + print(dist) + sys.exit(1) + + should_list_installables = ( + not current.startswith("-") and subcommand_name == "install" + ) + if should_list_installables: + for path in auto_complete_paths(current, "path"): + print(path) + sys.exit(1) + + subcommand = create_command(subcommand_name) + + for opt in subcommand.parser.option_list_all: + if opt.help != optparse.SUPPRESS_HELP: + options += [ + (opt_str, opt.nargs) for opt_str in opt._long_opts + opt._short_opts + ] + + # filter out previously specified options from available options + prev_opts = [x.split("=")[0] for x in cwords[1 : cword - 1]] + options = [(x, v) for (x, v) in options if x not in prev_opts] + # filter options by current input + options = [(k, v) for k, v in options if k.startswith(current)] + # get completion type given cwords and available subcommand options + completion_type = get_path_completion_type( + cwords, + cword, + subcommand.parser.option_list_all, + ) + # get completion files and directories if ``completion_type`` is + # ````, ```` or ```` + if completion_type: + paths = auto_complete_paths(current, completion_type) + options = [(path, 0) for path in paths] + for option in options: + opt_label = option[0] + # append '=' to options which require args + if option[1] and option[0][:2] == "--": + opt_label += "=" + print(opt_label) + else: + # show main parser options only when necessary + + opts = [i.option_list for i in parser.option_groups] + opts.append(parser.option_list) + flattened_opts = chain.from_iterable(opts) + if current.startswith("-"): + for opt in flattened_opts: + if opt.help != optparse.SUPPRESS_HELP: + subcommands += opt._long_opts + opt._short_opts + else: + # get completion type given cwords and all available options + completion_type = get_path_completion_type(cwords, cword, flattened_opts) + if completion_type: + subcommands = list(auto_complete_paths(current, completion_type)) + + print(" ".join([x for x in subcommands if x.startswith(current)])) + sys.exit(1) + + +def get_path_completion_type( + cwords: List[str], cword: int, opts: Iterable[Any] +) -> Optional[str]: + """Get the type of path completion (``file``, ``dir``, ``path`` or None) + + :param cwords: same as the environmental variable ``COMP_WORDS`` + :param cword: same as the environmental variable ``COMP_CWORD`` + :param opts: The available options to check + :return: path completion type (``file``, ``dir``, ``path`` or None) + """ + if cword < 2 or not cwords[cword - 2].startswith("-"): + return None + for opt in opts: + if opt.help == optparse.SUPPRESS_HELP: + continue + for o in str(opt).split("/"): + if cwords[cword - 2].split("=")[0] == o: + if not opt.metavar or any( + x in ("path", "file", "dir") for x in opt.metavar.split("/") + ): + return opt.metavar + return None + + +def auto_complete_paths(current: str, completion_type: str) -> Iterable[str]: + """If ``completion_type`` is ``file`` or ``path``, list all regular files + and directories starting with ``current``; otherwise only list directories + starting with ``current``. + + :param current: The word to be completed + :param completion_type: path completion type(``file``, ``path`` or ``dir``) + :return: A generator of regular files and/or directories + """ + directory, filename = os.path.split(current) + current_path = os.path.abspath(directory) + # Don't complete paths if they can't be accessed + if not os.access(current_path, os.R_OK): + return + filename = os.path.normcase(filename) + # list all files that start with ``filename`` + file_list = ( + x for x in os.listdir(current_path) if os.path.normcase(x).startswith(filename) + ) + for f in file_list: + opt = os.path.join(current_path, f) + comp_file = os.path.normcase(os.path.join(directory, f)) + # complete regular files when there is not ```` after option + # complete directories when there is ````, ```` or + # ````after option + if completion_type != "dir" and os.path.isfile(opt): + yield comp_file + elif os.path.isdir(opt): + yield os.path.join(comp_file, "") diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/cli/base_command.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/cli/base_command.py new file mode 100644 index 0000000..362f84b --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/cli/base_command.py @@ -0,0 +1,240 @@ +"""Base Command class, and related routines""" + +import logging +import logging.config +import optparse +import os +import sys +import traceback +from optparse import Values +from typing import List, Optional, Tuple + +from pip._vendor.rich import reconfigure +from pip._vendor.rich import traceback as rich_traceback + +from pip._internal.cli import cmdoptions +from pip._internal.cli.command_context import CommandContextMixIn +from pip._internal.cli.parser import ConfigOptionParser, UpdatingDefaultsHelpFormatter +from pip._internal.cli.status_codes import ( + ERROR, + PREVIOUS_BUILD_DIR_ERROR, + UNKNOWN_ERROR, + VIRTUALENV_NOT_FOUND, +) +from pip._internal.exceptions import ( + BadCommand, + CommandError, + DiagnosticPipError, + InstallationError, + NetworkConnectionError, + PreviousBuildDirError, +) +from pip._internal.utils.deprecation import deprecated +from pip._internal.utils.filesystem import check_path_owner +from pip._internal.utils.logging import BrokenStdoutLoggingError, setup_logging +from pip._internal.utils.misc import get_prog, normalize_path +from pip._internal.utils.temp_dir import TempDirectoryTypeRegistry as TempDirRegistry +from pip._internal.utils.temp_dir import global_tempdir_manager, tempdir_registry +from pip._internal.utils.virtualenv import running_under_virtualenv + +__all__ = ["Command"] + +logger = logging.getLogger(__name__) + + +class Command(CommandContextMixIn): + usage: str = "" + ignore_require_venv: bool = False + + def __init__(self, name: str, summary: str, isolated: bool = False) -> None: + super().__init__() + + self.name = name + self.summary = summary + self.parser = ConfigOptionParser( + usage=self.usage, + prog=f"{get_prog()} {name}", + formatter=UpdatingDefaultsHelpFormatter(), + add_help_option=False, + name=name, + description=self.__doc__, + isolated=isolated, + ) + + self.tempdir_registry: Optional[TempDirRegistry] = None + + # Commands should add options to this option group + optgroup_name = f"{self.name.capitalize()} Options" + self.cmd_opts = optparse.OptionGroup(self.parser, optgroup_name) + + # Add the general options + gen_opts = cmdoptions.make_option_group( + cmdoptions.general_group, + self.parser, + ) + self.parser.add_option_group(gen_opts) + + self.add_options() + + def add_options(self) -> None: + pass + + def handle_pip_version_check(self, options: Values) -> None: + """ + This is a no-op so that commands by default do not do the pip version + check. + """ + # Make sure we do the pip version check if the index_group options + # are present. + assert not hasattr(options, "no_index") + + def run(self, options: Values, args: List[str]) -> int: + raise NotImplementedError + + def _run_wrapper(self, level_number: int, options: Values, args: List[str]) -> int: + def _inner_run() -> int: + try: + return self.run(options, args) + finally: + self.handle_pip_version_check(options) + + if options.debug_mode: + rich_traceback.install(show_locals=True) + return _inner_run() + + try: + status = _inner_run() + assert isinstance(status, int) + return status + except DiagnosticPipError as exc: + logger.error("%s", exc, extra={"rich": True}) + logger.debug("Exception information:", exc_info=True) + + return ERROR + except PreviousBuildDirError as exc: + logger.critical(str(exc)) + logger.debug("Exception information:", exc_info=True) + + return PREVIOUS_BUILD_DIR_ERROR + except ( + InstallationError, + BadCommand, + NetworkConnectionError, + ) as exc: + logger.critical(str(exc)) + logger.debug("Exception information:", exc_info=True) + + return ERROR + except CommandError as exc: + logger.critical("%s", exc) + logger.debug("Exception information:", exc_info=True) + + return ERROR + except BrokenStdoutLoggingError: + # Bypass our logger and write any remaining messages to + # stderr because stdout no longer works. + print("ERROR: Pipe to stdout was broken", file=sys.stderr) + if level_number <= logging.DEBUG: + traceback.print_exc(file=sys.stderr) + + return ERROR + except KeyboardInterrupt: + logger.critical("Operation cancelled by user") + logger.debug("Exception information:", exc_info=True) + + return ERROR + except BaseException: + logger.critical("Exception:", exc_info=True) + + return UNKNOWN_ERROR + + def parse_args(self, args: List[str]) -> Tuple[Values, List[str]]: + # factored out for testability + return self.parser.parse_args(args) + + def main(self, args: List[str]) -> int: + try: + with self.main_context(): + return self._main(args) + finally: + logging.shutdown() + + def _main(self, args: List[str]) -> int: + # We must initialize this before the tempdir manager, otherwise the + # configuration would not be accessible by the time we clean up the + # tempdir manager. + self.tempdir_registry = self.enter_context(tempdir_registry()) + # Intentionally set as early as possible so globally-managed temporary + # directories are available to the rest of the code. + self.enter_context(global_tempdir_manager()) + + options, args = self.parse_args(args) + + # Set verbosity so that it can be used elsewhere. + self.verbosity = options.verbose - options.quiet + + reconfigure(no_color=options.no_color) + level_number = setup_logging( + verbosity=self.verbosity, + no_color=options.no_color, + user_log_file=options.log, + ) + + always_enabled_features = set(options.features_enabled) & set( + cmdoptions.ALWAYS_ENABLED_FEATURES + ) + if always_enabled_features: + logger.warning( + "The following features are always enabled: %s. ", + ", ".join(sorted(always_enabled_features)), + ) + + # Make sure that the --python argument isn't specified after the + # subcommand. We can tell, because if --python was specified, + # we should only reach this point if we're running in the created + # subprocess, which has the _PIP_RUNNING_IN_SUBPROCESS environment + # variable set. + if options.python and "_PIP_RUNNING_IN_SUBPROCESS" not in os.environ: + logger.critical( + "The --python option must be placed before the pip subcommand name" + ) + sys.exit(ERROR) + + # TODO: Try to get these passing down from the command? + # without resorting to os.environ to hold these. + # This also affects isolated builds and it should. + + if options.no_input: + os.environ["PIP_NO_INPUT"] = "1" + + if options.exists_action: + os.environ["PIP_EXISTS_ACTION"] = " ".join(options.exists_action) + + if options.require_venv and not self.ignore_require_venv: + # If a venv is required check if it can really be found + if not running_under_virtualenv(): + logger.critical("Could not find an activated virtualenv (required).") + sys.exit(VIRTUALENV_NOT_FOUND) + + if options.cache_dir: + options.cache_dir = normalize_path(options.cache_dir) + if not check_path_owner(options.cache_dir): + logger.warning( + "The directory '%s' or its parent directory is not owned " + "or is not writable by the current user. The cache " + "has been disabled. Check the permissions and owner of " + "that directory. If executing pip with sudo, you should " + "use sudo's -H flag.", + options.cache_dir, + ) + options.cache_dir = None + + if options.no_python_version_warning: + deprecated( + reason="--no-python-version-warning is deprecated.", + replacement="to remove the flag as it's a no-op", + gone_in="25.1", + issue=13154, + ) + + return self._run_wrapper(level_number, options, args) diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/cli/cmdoptions.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/cli/cmdoptions.py new file mode 100644 index 0000000..eeb7e65 --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/cli/cmdoptions.py @@ -0,0 +1,1075 @@ +""" +shared options and groups + +The principle here is to define options once, but *not* instantiate them +globally. One reason being that options with action='append' can carry state +between parses. pip parses general options twice internally, and shouldn't +pass on state. To be consistent, all options will follow this design. +""" + +# The following comment should be removed at some point in the future. +# mypy: strict-optional=False + +import importlib.util +import logging +import os +import textwrap +from functools import partial +from optparse import SUPPRESS_HELP, Option, OptionGroup, OptionParser, Values +from textwrap import dedent +from typing import Any, Callable, Dict, Optional, Tuple + +from pip._vendor.packaging.utils import canonicalize_name + +from pip._internal.cli.parser import ConfigOptionParser +from pip._internal.exceptions import CommandError +from pip._internal.locations import USER_CACHE_DIR, get_src_prefix +from pip._internal.models.format_control import FormatControl +from pip._internal.models.index import PyPI +from pip._internal.models.target_python import TargetPython +from pip._internal.utils.hashes import STRONG_HASHES +from pip._internal.utils.misc import strtobool + +logger = logging.getLogger(__name__) + + +def raise_option_error(parser: OptionParser, option: Option, msg: str) -> None: + """ + Raise an option parsing error using parser.error(). + + Args: + parser: an OptionParser instance. + option: an Option instance. + msg: the error text. + """ + msg = f"{option} error: {msg}" + msg = textwrap.fill(" ".join(msg.split())) + parser.error(msg) + + +def make_option_group(group: Dict[str, Any], parser: ConfigOptionParser) -> OptionGroup: + """ + Return an OptionGroup object + group -- assumed to be dict with 'name' and 'options' keys + parser -- an optparse Parser + """ + option_group = OptionGroup(parser, group["name"]) + for option in group["options"]: + option_group.add_option(option()) + return option_group + + +def check_dist_restriction(options: Values, check_target: bool = False) -> None: + """Function for determining if custom platform options are allowed. + + :param options: The OptionParser options. + :param check_target: Whether or not to check if --target is being used. + """ + dist_restriction_set = any( + [ + options.python_version, + options.platforms, + options.abis, + options.implementation, + ] + ) + + binary_only = FormatControl(set(), {":all:"}) + sdist_dependencies_allowed = ( + options.format_control != binary_only and not options.ignore_dependencies + ) + + # Installations or downloads using dist restrictions must not combine + # source distributions and dist-specific wheels, as they are not + # guaranteed to be locally compatible. + if dist_restriction_set and sdist_dependencies_allowed: + raise CommandError( + "When restricting platform and interpreter constraints using " + "--python-version, --platform, --abi, or --implementation, " + "either --no-deps must be set, or --only-binary=:all: must be " + "set and --no-binary must not be set (or must be set to " + ":none:)." + ) + + if check_target: + if not options.dry_run and dist_restriction_set and not options.target_dir: + raise CommandError( + "Can not use any platform or abi specific options unless " + "installing via '--target' or using '--dry-run'" + ) + + +def _path_option_check(option: Option, opt: str, value: str) -> str: + return os.path.expanduser(value) + + +def _package_name_option_check(option: Option, opt: str, value: str) -> str: + return canonicalize_name(value) + + +class PipOption(Option): + TYPES = Option.TYPES + ("path", "package_name") + TYPE_CHECKER = Option.TYPE_CHECKER.copy() + TYPE_CHECKER["package_name"] = _package_name_option_check + TYPE_CHECKER["path"] = _path_option_check + + +########### +# options # +########### + +help_: Callable[..., Option] = partial( + Option, + "-h", + "--help", + dest="help", + action="help", + help="Show help.", +) + +debug_mode: Callable[..., Option] = partial( + Option, + "--debug", + dest="debug_mode", + action="store_true", + default=False, + help=( + "Let unhandled exceptions propagate outside the main subroutine, " + "instead of logging them to stderr." + ), +) + +isolated_mode: Callable[..., Option] = partial( + Option, + "--isolated", + dest="isolated_mode", + action="store_true", + default=False, + help=( + "Run pip in an isolated mode, ignoring environment variables and user " + "configuration." + ), +) + +require_virtualenv: Callable[..., Option] = partial( + Option, + "--require-virtualenv", + "--require-venv", + dest="require_venv", + action="store_true", + default=False, + help=( + "Allow pip to only run in a virtual environment; " + "exit with an error otherwise." + ), +) + +override_externally_managed: Callable[..., Option] = partial( + Option, + "--break-system-packages", + dest="override_externally_managed", + action="store_true", + help="Allow pip to modify an EXTERNALLY-MANAGED Python installation", +) + +python: Callable[..., Option] = partial( + Option, + "--python", + dest="python", + help="Run pip with the specified Python interpreter.", +) + +verbose: Callable[..., Option] = partial( + Option, + "-v", + "--verbose", + dest="verbose", + action="count", + default=0, + help="Give more output. Option is additive, and can be used up to 3 times.", +) + +no_color: Callable[..., Option] = partial( + Option, + "--no-color", + dest="no_color", + action="store_true", + default=False, + help="Suppress colored output.", +) + +version: Callable[..., Option] = partial( + Option, + "-V", + "--version", + dest="version", + action="store_true", + help="Show version and exit.", +) + +quiet: Callable[..., Option] = partial( + Option, + "-q", + "--quiet", + dest="quiet", + action="count", + default=0, + help=( + "Give less output. Option is additive, and can be used up to 3" + " times (corresponding to WARNING, ERROR, and CRITICAL logging" + " levels)." + ), +) + +progress_bar: Callable[..., Option] = partial( + Option, + "--progress-bar", + dest="progress_bar", + type="choice", + choices=["on", "off", "raw"], + default="on", + help="Specify whether the progress bar should be used [on, off, raw] (default: on)", +) + +log: Callable[..., Option] = partial( + PipOption, + "--log", + "--log-file", + "--local-log", + dest="log", + metavar="path", + type="path", + help="Path to a verbose appending log.", +) + +no_input: Callable[..., Option] = partial( + Option, + # Don't ask for input + "--no-input", + dest="no_input", + action="store_true", + default=False, + help="Disable prompting for input.", +) + +keyring_provider: Callable[..., Option] = partial( + Option, + "--keyring-provider", + dest="keyring_provider", + choices=["auto", "disabled", "import", "subprocess"], + default="auto", + help=( + "Enable the credential lookup via the keyring library if user input is allowed." + " Specify which mechanism to use [auto, disabled, import, subprocess]." + " (default: %default)" + ), +) + +proxy: Callable[..., Option] = partial( + Option, + "--proxy", + dest="proxy", + type="str", + default="", + help="Specify a proxy in the form scheme://[user:passwd@]proxy.server:port.", +) + +retries: Callable[..., Option] = partial( + Option, + "--retries", + dest="retries", + type="int", + default=5, + help="Maximum number of retries each connection should attempt " + "(default %default times).", +) + +timeout: Callable[..., Option] = partial( + Option, + "--timeout", + "--default-timeout", + metavar="sec", + dest="timeout", + type="float", + default=15, + help="Set the socket timeout (default %default seconds).", +) + + +def exists_action() -> Option: + return Option( + # Option when path already exist + "--exists-action", + dest="exists_action", + type="choice", + choices=["s", "i", "w", "b", "a"], + default=[], + action="append", + metavar="action", + help="Default action when a path already exists: " + "(s)witch, (i)gnore, (w)ipe, (b)ackup, (a)bort.", + ) + + +cert: Callable[..., Option] = partial( + PipOption, + "--cert", + dest="cert", + type="path", + metavar="path", + help=( + "Path to PEM-encoded CA certificate bundle. " + "If provided, overrides the default. " + "See 'SSL Certificate Verification' in pip documentation " + "for more information." + ), +) + +client_cert: Callable[..., Option] = partial( + PipOption, + "--client-cert", + dest="client_cert", + type="path", + default=None, + metavar="path", + help="Path to SSL client certificate, a single file containing the " + "private key and the certificate in PEM format.", +) + +index_url: Callable[..., Option] = partial( + Option, + "-i", + "--index-url", + "--pypi-url", + dest="index_url", + metavar="URL", + default=PyPI.simple_url, + help="Base URL of the Python Package Index (default %default). " + "This should point to a repository compliant with PEP 503 " + "(the simple repository API) or a local directory laid out " + "in the same format.", +) + + +def extra_index_url() -> Option: + return Option( + "--extra-index-url", + dest="extra_index_urls", + metavar="URL", + action="append", + default=[], + help="Extra URLs of package indexes to use in addition to " + "--index-url. Should follow the same rules as " + "--index-url.", + ) + + +no_index: Callable[..., Option] = partial( + Option, + "--no-index", + dest="no_index", + action="store_true", + default=False, + help="Ignore package index (only looking at --find-links URLs instead).", +) + + +def find_links() -> Option: + return Option( + "-f", + "--find-links", + dest="find_links", + action="append", + default=[], + metavar="url", + help="If a URL or path to an html file, then parse for links to " + "archives such as sdist (.tar.gz) or wheel (.whl) files. " + "If a local path or file:// URL that's a directory, " + "then look for archives in the directory listing. " + "Links to VCS project URLs are not supported.", + ) + + +def trusted_host() -> Option: + return Option( + "--trusted-host", + dest="trusted_hosts", + action="append", + metavar="HOSTNAME", + default=[], + help="Mark this host or host:port pair as trusted, even though it " + "does not have valid or any HTTPS.", + ) + + +def constraints() -> Option: + return Option( + "-c", + "--constraint", + dest="constraints", + action="append", + default=[], + metavar="file", + help="Constrain versions using the given constraints file. " + "This option can be used multiple times.", + ) + + +def requirements() -> Option: + return Option( + "-r", + "--requirement", + dest="requirements", + action="append", + default=[], + metavar="file", + help="Install from the given requirements file. " + "This option can be used multiple times.", + ) + + +def editable() -> Option: + return Option( + "-e", + "--editable", + dest="editables", + action="append", + default=[], + metavar="path/url", + help=( + "Install a project in editable mode (i.e. setuptools " + '"develop mode") from a local project path or a VCS url.' + ), + ) + + +def _handle_src(option: Option, opt_str: str, value: str, parser: OptionParser) -> None: + value = os.path.abspath(value) + setattr(parser.values, option.dest, value) + + +src: Callable[..., Option] = partial( + PipOption, + "--src", + "--source", + "--source-dir", + "--source-directory", + dest="src_dir", + type="path", + metavar="dir", + default=get_src_prefix(), + action="callback", + callback=_handle_src, + help="Directory to check out editable projects into. " + 'The default in a virtualenv is "/src". ' + 'The default for global installs is "/src".', +) + + +def _get_format_control(values: Values, option: Option) -> Any: + """Get a format_control object.""" + return getattr(values, option.dest) + + +def _handle_no_binary( + option: Option, opt_str: str, value: str, parser: OptionParser +) -> None: + existing = _get_format_control(parser.values, option) + FormatControl.handle_mutual_excludes( + value, + existing.no_binary, + existing.only_binary, + ) + + +def _handle_only_binary( + option: Option, opt_str: str, value: str, parser: OptionParser +) -> None: + existing = _get_format_control(parser.values, option) + FormatControl.handle_mutual_excludes( + value, + existing.only_binary, + existing.no_binary, + ) + + +def no_binary() -> Option: + format_control = FormatControl(set(), set()) + return Option( + "--no-binary", + dest="format_control", + action="callback", + callback=_handle_no_binary, + type="str", + default=format_control, + help="Do not use binary packages. Can be supplied multiple times, and " + 'each time adds to the existing value. Accepts either ":all:" to ' + 'disable all binary packages, ":none:" to empty the set (notice ' + "the colons), or one or more package names with commas between " + "them (no colons). Note that some packages are tricky to compile " + "and may fail to install when this option is used on them.", + ) + + +def only_binary() -> Option: + format_control = FormatControl(set(), set()) + return Option( + "--only-binary", + dest="format_control", + action="callback", + callback=_handle_only_binary, + type="str", + default=format_control, + help="Do not use source packages. Can be supplied multiple times, and " + 'each time adds to the existing value. Accepts either ":all:" to ' + 'disable all source packages, ":none:" to empty the set, or one ' + "or more package names with commas between them. Packages " + "without binary distributions will fail to install when this " + "option is used on them.", + ) + + +platforms: Callable[..., Option] = partial( + Option, + "--platform", + dest="platforms", + metavar="platform", + action="append", + default=None, + help=( + "Only use wheels compatible with . Defaults to the " + "platform of the running system. Use this option multiple times to " + "specify multiple platforms supported by the target interpreter." + ), +) + + +# This was made a separate function for unit-testing purposes. +def _convert_python_version(value: str) -> Tuple[Tuple[int, ...], Optional[str]]: + """ + Convert a version string like "3", "37", or "3.7.3" into a tuple of ints. + + :return: A 2-tuple (version_info, error_msg), where `error_msg` is + non-None if and only if there was a parsing error. + """ + if not value: + # The empty string is the same as not providing a value. + return (None, None) + + parts = value.split(".") + if len(parts) > 3: + return ((), "at most three version parts are allowed") + + if len(parts) == 1: + # Then we are in the case of "3" or "37". + value = parts[0] + if len(value) > 1: + parts = [value[0], value[1:]] + + try: + version_info = tuple(int(part) for part in parts) + except ValueError: + return ((), "each version part must be an integer") + + return (version_info, None) + + +def _handle_python_version( + option: Option, opt_str: str, value: str, parser: OptionParser +) -> None: + """ + Handle a provided --python-version value. + """ + version_info, error_msg = _convert_python_version(value) + if error_msg is not None: + msg = f"invalid --python-version value: {value!r}: {error_msg}" + raise_option_error(parser, option=option, msg=msg) + + parser.values.python_version = version_info + + +python_version: Callable[..., Option] = partial( + Option, + "--python-version", + dest="python_version", + metavar="python_version", + action="callback", + callback=_handle_python_version, + type="str", + default=None, + help=dedent( + """\ + The Python interpreter version to use for wheel and "Requires-Python" + compatibility checks. Defaults to a version derived from the running + interpreter. The version can be specified using up to three dot-separated + integers (e.g. "3" for 3.0.0, "3.7" for 3.7.0, or "3.7.3"). A major-minor + version can also be given as a string without dots (e.g. "37" for 3.7.0). + """ + ), +) + + +implementation: Callable[..., Option] = partial( + Option, + "--implementation", + dest="implementation", + metavar="implementation", + default=None, + help=( + "Only use wheels compatible with Python " + "implementation , e.g. 'pp', 'jy', 'cp', " + " or 'ip'. If not specified, then the current " + "interpreter implementation is used. Use 'py' to force " + "implementation-agnostic wheels." + ), +) + + +abis: Callable[..., Option] = partial( + Option, + "--abi", + dest="abis", + metavar="abi", + action="append", + default=None, + help=( + "Only use wheels compatible with Python abi , e.g. 'pypy_41'. " + "If not specified, then the current interpreter abi tag is used. " + "Use this option multiple times to specify multiple abis supported " + "by the target interpreter. Generally you will need to specify " + "--implementation, --platform, and --python-version when using this " + "option." + ), +) + + +def add_target_python_options(cmd_opts: OptionGroup) -> None: + cmd_opts.add_option(platforms()) + cmd_opts.add_option(python_version()) + cmd_opts.add_option(implementation()) + cmd_opts.add_option(abis()) + + +def make_target_python(options: Values) -> TargetPython: + target_python = TargetPython( + platforms=options.platforms, + py_version_info=options.python_version, + abis=options.abis, + implementation=options.implementation, + ) + + return target_python + + +def prefer_binary() -> Option: + return Option( + "--prefer-binary", + dest="prefer_binary", + action="store_true", + default=False, + help=( + "Prefer binary packages over source packages, even if the " + "source packages are newer." + ), + ) + + +cache_dir: Callable[..., Option] = partial( + PipOption, + "--cache-dir", + dest="cache_dir", + default=USER_CACHE_DIR, + metavar="dir", + type="path", + help="Store the cache data in .", +) + + +def _handle_no_cache_dir( + option: Option, opt: str, value: str, parser: OptionParser +) -> None: + """ + Process a value provided for the --no-cache-dir option. + + This is an optparse.Option callback for the --no-cache-dir option. + """ + # The value argument will be None if --no-cache-dir is passed via the + # command-line, since the option doesn't accept arguments. However, + # the value can be non-None if the option is triggered e.g. by an + # environment variable, like PIP_NO_CACHE_DIR=true. + if value is not None: + # Then parse the string value to get argument error-checking. + try: + strtobool(value) + except ValueError as exc: + raise_option_error(parser, option=option, msg=str(exc)) + + # Originally, setting PIP_NO_CACHE_DIR to a value that strtobool() + # converted to 0 (like "false" or "no") caused cache_dir to be disabled + # rather than enabled (logic would say the latter). Thus, we disable + # the cache directory not just on values that parse to True, but (for + # backwards compatibility reasons) also on values that parse to False. + # In other words, always set it to False if the option is provided in + # some (valid) form. + parser.values.cache_dir = False + + +no_cache: Callable[..., Option] = partial( + Option, + "--no-cache-dir", + dest="cache_dir", + action="callback", + callback=_handle_no_cache_dir, + help="Disable the cache.", +) + +no_deps: Callable[..., Option] = partial( + Option, + "--no-deps", + "--no-dependencies", + dest="ignore_dependencies", + action="store_true", + default=False, + help="Don't install package dependencies.", +) + +ignore_requires_python: Callable[..., Option] = partial( + Option, + "--ignore-requires-python", + dest="ignore_requires_python", + action="store_true", + help="Ignore the Requires-Python information.", +) + +no_build_isolation: Callable[..., Option] = partial( + Option, + "--no-build-isolation", + dest="build_isolation", + action="store_false", + default=True, + help="Disable isolation when building a modern source distribution. " + "Build dependencies specified by PEP 518 must be already installed " + "if this option is used.", +) + +check_build_deps: Callable[..., Option] = partial( + Option, + "--check-build-dependencies", + dest="check_build_deps", + action="store_true", + default=False, + help="Check the build dependencies when PEP517 is used.", +) + + +def _handle_no_use_pep517( + option: Option, opt: str, value: str, parser: OptionParser +) -> None: + """ + Process a value provided for the --no-use-pep517 option. + + This is an optparse.Option callback for the no_use_pep517 option. + """ + # Since --no-use-pep517 doesn't accept arguments, the value argument + # will be None if --no-use-pep517 is passed via the command-line. + # However, the value can be non-None if the option is triggered e.g. + # by an environment variable, for example "PIP_NO_USE_PEP517=true". + if value is not None: + msg = """A value was passed for --no-use-pep517, + probably using either the PIP_NO_USE_PEP517 environment variable + or the "no-use-pep517" config file option. Use an appropriate value + of the PIP_USE_PEP517 environment variable or the "use-pep517" + config file option instead. + """ + raise_option_error(parser, option=option, msg=msg) + + # If user doesn't wish to use pep517, we check if setuptools and wheel are installed + # and raise error if it is not. + packages = ("setuptools", "wheel") + if not all(importlib.util.find_spec(package) for package in packages): + msg = ( + f"It is not possible to use --no-use-pep517 " + f"without {' and '.join(packages)} installed." + ) + raise_option_error(parser, option=option, msg=msg) + + # Otherwise, --no-use-pep517 was passed via the command-line. + parser.values.use_pep517 = False + + +use_pep517: Any = partial( + Option, + "--use-pep517", + dest="use_pep517", + action="store_true", + default=None, + help="Use PEP 517 for building source distributions " + "(use --no-use-pep517 to force legacy behaviour).", +) + +no_use_pep517: Any = partial( + Option, + "--no-use-pep517", + dest="use_pep517", + action="callback", + callback=_handle_no_use_pep517, + default=None, + help=SUPPRESS_HELP, +) + + +def _handle_config_settings( + option: Option, opt_str: str, value: str, parser: OptionParser +) -> None: + key, sep, val = value.partition("=") + if sep != "=": + parser.error(f"Arguments to {opt_str} must be of the form KEY=VAL") + dest = getattr(parser.values, option.dest) + if dest is None: + dest = {} + setattr(parser.values, option.dest, dest) + if key in dest: + if isinstance(dest[key], list): + dest[key].append(val) + else: + dest[key] = [dest[key], val] + else: + dest[key] = val + + +config_settings: Callable[..., Option] = partial( + Option, + "-C", + "--config-settings", + dest="config_settings", + type=str, + action="callback", + callback=_handle_config_settings, + metavar="settings", + help="Configuration settings to be passed to the PEP 517 build backend. " + "Settings take the form KEY=VALUE. Use multiple --config-settings options " + "to pass multiple keys to the backend.", +) + +build_options: Callable[..., Option] = partial( + Option, + "--build-option", + dest="build_options", + metavar="options", + action="append", + help="Extra arguments to be supplied to 'setup.py bdist_wheel'.", +) + +global_options: Callable[..., Option] = partial( + Option, + "--global-option", + dest="global_options", + action="append", + metavar="options", + help="Extra global options to be supplied to the setup.py " + "call before the install or bdist_wheel command.", +) + +no_clean: Callable[..., Option] = partial( + Option, + "--no-clean", + action="store_true", + default=False, + help="Don't clean up build directories.", +) + +pre: Callable[..., Option] = partial( + Option, + "--pre", + action="store_true", + default=False, + help="Include pre-release and development versions. By default, " + "pip only finds stable versions.", +) + +disable_pip_version_check: Callable[..., Option] = partial( + Option, + "--disable-pip-version-check", + dest="disable_pip_version_check", + action="store_true", + default=False, + help="Don't periodically check PyPI to determine whether a new version " + "of pip is available for download. Implied with --no-index.", +) + +root_user_action: Callable[..., Option] = partial( + Option, + "--root-user-action", + dest="root_user_action", + default="warn", + choices=["warn", "ignore"], + help="Action if pip is run as a root user [warn, ignore] (default: warn)", +) + + +def _handle_merge_hash( + option: Option, opt_str: str, value: str, parser: OptionParser +) -> None: + """Given a value spelled "algo:digest", append the digest to a list + pointed to in a dict by the algo name.""" + if not parser.values.hashes: + parser.values.hashes = {} + try: + algo, digest = value.split(":", 1) + except ValueError: + parser.error( + f"Arguments to {opt_str} must be a hash name " + "followed by a value, like --hash=sha256:" + "abcde..." + ) + if algo not in STRONG_HASHES: + parser.error( + "Allowed hash algorithms for {} are {}.".format( + opt_str, ", ".join(STRONG_HASHES) + ) + ) + parser.values.hashes.setdefault(algo, []).append(digest) + + +hash: Callable[..., Option] = partial( + Option, + "--hash", + # Hash values eventually end up in InstallRequirement.hashes due to + # __dict__ copying in process_line(). + dest="hashes", + action="callback", + callback=_handle_merge_hash, + type="string", + help="Verify that the package's archive matches this " + "hash before installing. Example: --hash=sha256:abcdef...", +) + + +require_hashes: Callable[..., Option] = partial( + Option, + "--require-hashes", + dest="require_hashes", + action="store_true", + default=False, + help="Require a hash to check each requirement against, for " + "repeatable installs. This option is implied when any package in a " + "requirements file has a --hash option.", +) + + +list_path: Callable[..., Option] = partial( + PipOption, + "--path", + dest="path", + type="path", + action="append", + help="Restrict to the specified installation path for listing " + "packages (can be used multiple times).", +) + + +def check_list_path_option(options: Values) -> None: + if options.path and (options.user or options.local): + raise CommandError("Cannot combine '--path' with '--user' or '--local'") + + +list_exclude: Callable[..., Option] = partial( + PipOption, + "--exclude", + dest="excludes", + action="append", + metavar="package", + type="package_name", + help="Exclude specified package from the output", +) + + +no_python_version_warning: Callable[..., Option] = partial( + Option, + "--no-python-version-warning", + dest="no_python_version_warning", + action="store_true", + default=False, + help="Silence deprecation warnings for upcoming unsupported Pythons.", +) + + +# Features that are now always on. A warning is printed if they are used. +ALWAYS_ENABLED_FEATURES = [ + "truststore", # always on since 24.2 + "no-binary-enable-wheel-cache", # always on since 23.1 +] + +use_new_feature: Callable[..., Option] = partial( + Option, + "--use-feature", + dest="features_enabled", + metavar="feature", + action="append", + default=[], + choices=[ + "fast-deps", + ] + + ALWAYS_ENABLED_FEATURES, + help="Enable new functionality, that may be backward incompatible.", +) + +use_deprecated_feature: Callable[..., Option] = partial( + Option, + "--use-deprecated", + dest="deprecated_features_enabled", + metavar="feature", + action="append", + default=[], + choices=[ + "legacy-resolver", + "legacy-certs", + ], + help=("Enable deprecated functionality, that will be removed in the future."), +) + + +########## +# groups # +########## + +general_group: Dict[str, Any] = { + "name": "General Options", + "options": [ + help_, + debug_mode, + isolated_mode, + require_virtualenv, + python, + verbose, + version, + quiet, + log, + no_input, + keyring_provider, + proxy, + retries, + timeout, + exists_action, + trusted_host, + cert, + client_cert, + cache_dir, + no_cache, + disable_pip_version_check, + no_color, + no_python_version_warning, + use_new_feature, + use_deprecated_feature, + ], +} + +index_group: Dict[str, Any] = { + "name": "Package Index Options", + "options": [ + index_url, + extra_index_url, + no_index, + find_links, + ], +} diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/cli/command_context.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/cli/command_context.py new file mode 100644 index 0000000..139995a --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/cli/command_context.py @@ -0,0 +1,27 @@ +from contextlib import ExitStack, contextmanager +from typing import ContextManager, Generator, TypeVar + +_T = TypeVar("_T", covariant=True) + + +class CommandContextMixIn: + def __init__(self) -> None: + super().__init__() + self._in_main_context = False + self._main_context = ExitStack() + + @contextmanager + def main_context(self) -> Generator[None, None, None]: + assert not self._in_main_context + + self._in_main_context = True + try: + with self._main_context: + yield + finally: + self._in_main_context = False + + def enter_context(self, context_provider: ContextManager[_T]) -> _T: + assert self._in_main_context + + return self._main_context.enter_context(context_provider) diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/cli/index_command.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/cli/index_command.py new file mode 100644 index 0000000..295108e --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/cli/index_command.py @@ -0,0 +1,171 @@ +""" +Contains command classes which may interact with an index / the network. + +Unlike its sister module, req_command, this module still uses lazy imports +so commands which don't always hit the network (e.g. list w/o --outdated or +--uptodate) don't need waste time importing PipSession and friends. +""" + +import logging +import os +import sys +from optparse import Values +from typing import TYPE_CHECKING, List, Optional + +from pip._vendor import certifi + +from pip._internal.cli.base_command import Command +from pip._internal.cli.command_context import CommandContextMixIn + +if TYPE_CHECKING: + from ssl import SSLContext + + from pip._internal.network.session import PipSession + +logger = logging.getLogger(__name__) + + +def _create_truststore_ssl_context() -> Optional["SSLContext"]: + if sys.version_info < (3, 10): + logger.debug("Disabling truststore because Python version isn't 3.10+") + return None + + try: + import ssl + except ImportError: + logger.warning("Disabling truststore since ssl support is missing") + return None + + try: + from pip._vendor import truststore + except ImportError: + logger.warning("Disabling truststore because platform isn't supported") + return None + + ctx = truststore.SSLContext(ssl.PROTOCOL_TLS_CLIENT) + ctx.load_verify_locations(certifi.where()) + return ctx + + +class SessionCommandMixin(CommandContextMixIn): + """ + A class mixin for command classes needing _build_session(). + """ + + def __init__(self) -> None: + super().__init__() + self._session: Optional[PipSession] = None + + @classmethod + def _get_index_urls(cls, options: Values) -> Optional[List[str]]: + """Return a list of index urls from user-provided options.""" + index_urls = [] + if not getattr(options, "no_index", False): + url = getattr(options, "index_url", None) + if url: + index_urls.append(url) + urls = getattr(options, "extra_index_urls", None) + if urls: + index_urls.extend(urls) + # Return None rather than an empty list + return index_urls or None + + def get_default_session(self, options: Values) -> "PipSession": + """Get a default-managed session.""" + if self._session is None: + self._session = self.enter_context(self._build_session(options)) + # there's no type annotation on requests.Session, so it's + # automatically ContextManager[Any] and self._session becomes Any, + # then https://github.com/python/mypy/issues/7696 kicks in + assert self._session is not None + return self._session + + def _build_session( + self, + options: Values, + retries: Optional[int] = None, + timeout: Optional[int] = None, + ) -> "PipSession": + from pip._internal.network.session import PipSession + + cache_dir = options.cache_dir + assert not cache_dir or os.path.isabs(cache_dir) + + if "legacy-certs" not in options.deprecated_features_enabled: + ssl_context = _create_truststore_ssl_context() + else: + ssl_context = None + + session = PipSession( + cache=os.path.join(cache_dir, "http-v2") if cache_dir else None, + retries=retries if retries is not None else options.retries, + trusted_hosts=options.trusted_hosts, + index_urls=self._get_index_urls(options), + ssl_context=ssl_context, + ) + + # Handle custom ca-bundles from the user + if options.cert: + session.verify = options.cert + + # Handle SSL client certificate + if options.client_cert: + session.cert = options.client_cert + + # Handle timeouts + if options.timeout or timeout: + session.timeout = timeout if timeout is not None else options.timeout + + # Handle configured proxies + if options.proxy: + session.proxies = { + "http": options.proxy, + "https": options.proxy, + } + session.trust_env = False + session.pip_proxy = options.proxy + + # Determine if we can prompt the user for authentication or not + session.auth.prompting = not options.no_input + session.auth.keyring_provider = options.keyring_provider + + return session + + +def _pip_self_version_check(session: "PipSession", options: Values) -> None: + from pip._internal.self_outdated_check import pip_self_version_check as check + + check(session, options) + + +class IndexGroupCommand(Command, SessionCommandMixin): + """ + Abstract base class for commands with the index_group options. + + This also corresponds to the commands that permit the pip version check. + """ + + def handle_pip_version_check(self, options: Values) -> None: + """ + Do the pip version check if not disabled. + + This overrides the default behavior of not doing the check. + """ + # Make sure the index_group options are present. + assert hasattr(options, "no_index") + + if options.disable_pip_version_check or options.no_index: + return + + try: + # Otherwise, check if we're using the latest version of pip available. + session = self._build_session( + options, + retries=0, + timeout=min(5, options.timeout), + ) + with session: + _pip_self_version_check(session, options) + except Exception: + logger.warning("There was an error checking the latest version of pip.") + logger.debug("See below for error", exc_info=True) diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/cli/main.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/cli/main.py new file mode 100644 index 0000000..563ac79 --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/cli/main.py @@ -0,0 +1,80 @@ +"""Primary application entrypoint. +""" + +import locale +import logging +import os +import sys +import warnings +from typing import List, Optional + +from pip._internal.cli.autocompletion import autocomplete +from pip._internal.cli.main_parser import parse_command +from pip._internal.commands import create_command +from pip._internal.exceptions import PipError +from pip._internal.utils import deprecation + +logger = logging.getLogger(__name__) + + +# Do not import and use main() directly! Using it directly is actively +# discouraged by pip's maintainers. The name, location and behavior of +# this function is subject to change, so calling it directly is not +# portable across different pip versions. + +# In addition, running pip in-process is unsupported and unsafe. This is +# elaborated in detail at +# https://pip.pypa.io/en/stable/user_guide/#using-pip-from-your-program. +# That document also provides suggestions that should work for nearly +# all users that are considering importing and using main() directly. + +# However, we know that certain users will still want to invoke pip +# in-process. If you understand and accept the implications of using pip +# in an unsupported manner, the best approach is to use runpy to avoid +# depending on the exact location of this entry point. + +# The following example shows how to use runpy to invoke pip in that +# case: +# +# sys.argv = ["pip", your, args, here] +# runpy.run_module("pip", run_name="__main__") +# +# Note that this will exit the process after running, unlike a direct +# call to main. As it is not safe to do any processing after calling +# main, this should not be an issue in practice. + + +def main(args: Optional[List[str]] = None) -> int: + if args is None: + args = sys.argv[1:] + + # Suppress the pkg_resources deprecation warning + # Note - we use a module of .*pkg_resources to cover + # the normal case (pip._vendor.pkg_resources) and the + # devendored case (a bare pkg_resources) + warnings.filterwarnings( + action="ignore", category=DeprecationWarning, module=".*pkg_resources" + ) + + # Configure our deprecation warnings to be sent through loggers + deprecation.install_warning_logger() + + autocomplete() + + try: + cmd_name, cmd_args = parse_command(args) + except PipError as exc: + sys.stderr.write(f"ERROR: {exc}") + sys.stderr.write(os.linesep) + sys.exit(1) + + # Needed for locale.getpreferredencoding(False) to work + # in pip._internal.utils.encoding.auto_decode + try: + locale.setlocale(locale.LC_ALL, "") + except locale.Error as e: + # setlocale can apparently crash if locale are uninitialized + logger.debug("Ignoring error %s when setting locale", e) + command = create_command(cmd_name, isolated=("--isolated" in cmd_args)) + + return command.main(cmd_args) diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/cli/main_parser.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/cli/main_parser.py new file mode 100644 index 0000000..5ade356 --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/cli/main_parser.py @@ -0,0 +1,134 @@ +"""A single place for constructing and exposing the main parser +""" + +import os +import subprocess +import sys +from typing import List, Optional, Tuple + +from pip._internal.build_env import get_runnable_pip +from pip._internal.cli import cmdoptions +from pip._internal.cli.parser import ConfigOptionParser, UpdatingDefaultsHelpFormatter +from pip._internal.commands import commands_dict, get_similar_commands +from pip._internal.exceptions import CommandError +from pip._internal.utils.misc import get_pip_version, get_prog + +__all__ = ["create_main_parser", "parse_command"] + + +def create_main_parser() -> ConfigOptionParser: + """Creates and returns the main parser for pip's CLI""" + + parser = ConfigOptionParser( + usage="\n%prog [options]", + add_help_option=False, + formatter=UpdatingDefaultsHelpFormatter(), + name="global", + prog=get_prog(), + ) + parser.disable_interspersed_args() + + parser.version = get_pip_version() + + # add the general options + gen_opts = cmdoptions.make_option_group(cmdoptions.general_group, parser) + parser.add_option_group(gen_opts) + + # so the help formatter knows + parser.main = True # type: ignore + + # create command listing for description + description = [""] + [ + f"{name:27} {command_info.summary}" + for name, command_info in commands_dict.items() + ] + parser.description = "\n".join(description) + + return parser + + +def identify_python_interpreter(python: str) -> Optional[str]: + # If the named file exists, use it. + # If it's a directory, assume it's a virtual environment and + # look for the environment's Python executable. + if os.path.exists(python): + if os.path.isdir(python): + # bin/python for Unix, Scripts/python.exe for Windows + # Try both in case of odd cases like cygwin. + for exe in ("bin/python", "Scripts/python.exe"): + py = os.path.join(python, exe) + if os.path.exists(py): + return py + else: + return python + + # Could not find the interpreter specified + return None + + +def parse_command(args: List[str]) -> Tuple[str, List[str]]: + parser = create_main_parser() + + # Note: parser calls disable_interspersed_args(), so the result of this + # call is to split the initial args into the general options before the + # subcommand and everything else. + # For example: + # args: ['--timeout=5', 'install', '--user', 'INITools'] + # general_options: ['--timeout==5'] + # args_else: ['install', '--user', 'INITools'] + general_options, args_else = parser.parse_args(args) + + # --python + if general_options.python and "_PIP_RUNNING_IN_SUBPROCESS" not in os.environ: + # Re-invoke pip using the specified Python interpreter + interpreter = identify_python_interpreter(general_options.python) + if interpreter is None: + raise CommandError( + f"Could not locate Python interpreter {general_options.python}" + ) + + pip_cmd = [ + interpreter, + get_runnable_pip(), + ] + pip_cmd.extend(args) + + # Set a flag so the child doesn't re-invoke itself, causing + # an infinite loop. + os.environ["_PIP_RUNNING_IN_SUBPROCESS"] = "1" + returncode = 0 + try: + proc = subprocess.run(pip_cmd) + returncode = proc.returncode + except (subprocess.SubprocessError, OSError) as exc: + raise CommandError(f"Failed to run pip under {interpreter}: {exc}") + sys.exit(returncode) + + # --version + if general_options.version: + sys.stdout.write(parser.version) + sys.stdout.write(os.linesep) + sys.exit() + + # pip || pip help -> print_help() + if not args_else or (args_else[0] == "help" and len(args_else) == 1): + parser.print_help() + sys.exit() + + # the subcommand name + cmd_name = args_else[0] + + if cmd_name not in commands_dict: + guess = get_similar_commands(cmd_name) + + msg = [f'unknown command "{cmd_name}"'] + if guess: + msg.append(f'maybe you meant "{guess}"') + + raise CommandError(" - ".join(msg)) + + # all the args without the subcommand + cmd_args = args[:] + cmd_args.remove(cmd_name) + + return cmd_name, cmd_args diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/cli/parser.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/cli/parser.py new file mode 100644 index 0000000..bc4aca0 --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/cli/parser.py @@ -0,0 +1,294 @@ +"""Base option parser setup""" + +import logging +import optparse +import shutil +import sys +import textwrap +from contextlib import suppress +from typing import Any, Dict, Generator, List, NoReturn, Optional, Tuple + +from pip._internal.cli.status_codes import UNKNOWN_ERROR +from pip._internal.configuration import Configuration, ConfigurationError +from pip._internal.utils.misc import redact_auth_from_url, strtobool + +logger = logging.getLogger(__name__) + + +class PrettyHelpFormatter(optparse.IndentedHelpFormatter): + """A prettier/less verbose help formatter for optparse.""" + + def __init__(self, *args: Any, **kwargs: Any) -> None: + # help position must be aligned with __init__.parseopts.description + kwargs["max_help_position"] = 30 + kwargs["indent_increment"] = 1 + kwargs["width"] = shutil.get_terminal_size()[0] - 2 + super().__init__(*args, **kwargs) + + def format_option_strings(self, option: optparse.Option) -> str: + return self._format_option_strings(option) + + def _format_option_strings( + self, option: optparse.Option, mvarfmt: str = " <{}>", optsep: str = ", " + ) -> str: + """ + Return a comma-separated list of option strings and metavars. + + :param option: tuple of (short opt, long opt), e.g: ('-f', '--format') + :param mvarfmt: metavar format string + :param optsep: separator + """ + opts = [] + + if option._short_opts: + opts.append(option._short_opts[0]) + if option._long_opts: + opts.append(option._long_opts[0]) + if len(opts) > 1: + opts.insert(1, optsep) + + if option.takes_value(): + assert option.dest is not None + metavar = option.metavar or option.dest.lower() + opts.append(mvarfmt.format(metavar.lower())) + + return "".join(opts) + + def format_heading(self, heading: str) -> str: + if heading == "Options": + return "" + return heading + ":\n" + + def format_usage(self, usage: str) -> str: + """ + Ensure there is only one newline between usage and the first heading + if there is no description. + """ + msg = "\nUsage: {}\n".format(self.indent_lines(textwrap.dedent(usage), " ")) + return msg + + def format_description(self, description: Optional[str]) -> str: + # leave full control over description to us + if description: + if hasattr(self.parser, "main"): + label = "Commands" + else: + label = "Description" + # some doc strings have initial newlines, some don't + description = description.lstrip("\n") + # some doc strings have final newlines and spaces, some don't + description = description.rstrip() + # dedent, then reindent + description = self.indent_lines(textwrap.dedent(description), " ") + description = f"{label}:\n{description}\n" + return description + else: + return "" + + def format_epilog(self, epilog: Optional[str]) -> str: + # leave full control over epilog to us + if epilog: + return epilog + else: + return "" + + def indent_lines(self, text: str, indent: str) -> str: + new_lines = [indent + line for line in text.split("\n")] + return "\n".join(new_lines) + + +class UpdatingDefaultsHelpFormatter(PrettyHelpFormatter): + """Custom help formatter for use in ConfigOptionParser. + + This is updates the defaults before expanding them, allowing + them to show up correctly in the help listing. + + Also redact auth from url type options + """ + + def expand_default(self, option: optparse.Option) -> str: + default_values = None + if self.parser is not None: + assert isinstance(self.parser, ConfigOptionParser) + self.parser._update_defaults(self.parser.defaults) + assert option.dest is not None + default_values = self.parser.defaults.get(option.dest) + help_text = super().expand_default(option) + + if default_values and option.metavar == "URL": + if isinstance(default_values, str): + default_values = [default_values] + + # If its not a list, we should abort and just return the help text + if not isinstance(default_values, list): + default_values = [] + + for val in default_values: + help_text = help_text.replace(val, redact_auth_from_url(val)) + + return help_text + + +class CustomOptionParser(optparse.OptionParser): + def insert_option_group( + self, idx: int, *args: Any, **kwargs: Any + ) -> optparse.OptionGroup: + """Insert an OptionGroup at a given position.""" + group = self.add_option_group(*args, **kwargs) + + self.option_groups.pop() + self.option_groups.insert(idx, group) + + return group + + @property + def option_list_all(self) -> List[optparse.Option]: + """Get a list of all options, including those in option groups.""" + res = self.option_list[:] + for i in self.option_groups: + res.extend(i.option_list) + + return res + + +class ConfigOptionParser(CustomOptionParser): + """Custom option parser which updates its defaults by checking the + configuration files and environmental variables""" + + def __init__( + self, + *args: Any, + name: str, + isolated: bool = False, + **kwargs: Any, + ) -> None: + self.name = name + self.config = Configuration(isolated) + + assert self.name + super().__init__(*args, **kwargs) + + def check_default(self, option: optparse.Option, key: str, val: Any) -> Any: + try: + return option.check_value(key, val) + except optparse.OptionValueError as exc: + print(f"An error occurred during configuration: {exc}") + sys.exit(3) + + def _get_ordered_configuration_items( + self, + ) -> Generator[Tuple[str, Any], None, None]: + # Configuration gives keys in an unordered manner. Order them. + override_order = ["global", self.name, ":env:"] + + # Pool the options into different groups + section_items: Dict[str, List[Tuple[str, Any]]] = { + name: [] for name in override_order + } + for section_key, val in self.config.items(): + # ignore empty values + if not val: + logger.debug( + "Ignoring configuration key '%s' as it's value is empty.", + section_key, + ) + continue + + section, key = section_key.split(".", 1) + if section in override_order: + section_items[section].append((key, val)) + + # Yield each group in their override order + for section in override_order: + for key, val in section_items[section]: + yield key, val + + def _update_defaults(self, defaults: Dict[str, Any]) -> Dict[str, Any]: + """Updates the given defaults with values from the config files and + the environ. Does a little special handling for certain types of + options (lists).""" + + # Accumulate complex default state. + self.values = optparse.Values(self.defaults) + late_eval = set() + # Then set the options with those values + for key, val in self._get_ordered_configuration_items(): + # '--' because configuration supports only long names + option = self.get_option("--" + key) + + # Ignore options not present in this parser. E.g. non-globals put + # in [global] by users that want them to apply to all applicable + # commands. + if option is None: + continue + + assert option.dest is not None + + if option.action in ("store_true", "store_false"): + try: + val = strtobool(val) + except ValueError: + self.error( + f"{val} is not a valid value for {key} option, " + "please specify a boolean value like yes/no, " + "true/false or 1/0 instead." + ) + elif option.action == "count": + with suppress(ValueError): + val = strtobool(val) + with suppress(ValueError): + val = int(val) + if not isinstance(val, int) or val < 0: + self.error( + f"{val} is not a valid value for {key} option, " + "please instead specify either a non-negative integer " + "or a boolean value like yes/no or false/true " + "which is equivalent to 1/0." + ) + elif option.action == "append": + val = val.split() + val = [self.check_default(option, key, v) for v in val] + elif option.action == "callback": + assert option.callback is not None + late_eval.add(option.dest) + opt_str = option.get_opt_string() + val = option.convert_value(opt_str, val) + # From take_action + args = option.callback_args or () + kwargs = option.callback_kwargs or {} + option.callback(option, opt_str, val, self, *args, **kwargs) + else: + val = self.check_default(option, key, val) + + defaults[option.dest] = val + + for key in late_eval: + defaults[key] = getattr(self.values, key) + self.values = None + return defaults + + def get_default_values(self) -> optparse.Values: + """Overriding to make updating the defaults after instantiation of + the option parser possible, _update_defaults() does the dirty work.""" + if not self.process_default_values: + # Old, pre-Optik 1.5 behaviour. + return optparse.Values(self.defaults) + + # Load the configuration, or error out in case of an error + try: + self.config.load() + except ConfigurationError as err: + self.exit(UNKNOWN_ERROR, str(err)) + + defaults = self._update_defaults(self.defaults.copy()) # ours + for option in self._get_all_options(): + assert option.dest is not None + default = defaults.get(option.dest) + if isinstance(default, str): + opt_str = option.get_opt_string() + defaults[option.dest] = option.check_value(opt_str, default) + return optparse.Values(defaults) + + def error(self, msg: str) -> NoReturn: + self.print_usage(sys.stderr) + self.exit(UNKNOWN_ERROR, f"{msg}\n") diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/cli/progress_bars.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/cli/progress_bars.py new file mode 100644 index 0000000..3d9dde8 --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/cli/progress_bars.py @@ -0,0 +1,94 @@ +import functools +import sys +from typing import Callable, Generator, Iterable, Iterator, Optional, Tuple + +from pip._vendor.rich.progress import ( + BarColumn, + DownloadColumn, + FileSizeColumn, + Progress, + ProgressColumn, + SpinnerColumn, + TextColumn, + TimeElapsedColumn, + TimeRemainingColumn, + TransferSpeedColumn, +) + +from pip._internal.cli.spinners import RateLimiter +from pip._internal.utils.logging import get_indentation + +DownloadProgressRenderer = Callable[[Iterable[bytes]], Iterator[bytes]] + + +def _rich_progress_bar( + iterable: Iterable[bytes], + *, + bar_type: str, + size: Optional[int], +) -> Generator[bytes, None, None]: + assert bar_type == "on", "This should only be used in the default mode." + + if not size: + total = float("inf") + columns: Tuple[ProgressColumn, ...] = ( + TextColumn("[progress.description]{task.description}"), + SpinnerColumn("line", speed=1.5), + FileSizeColumn(), + TransferSpeedColumn(), + TimeElapsedColumn(), + ) + else: + total = size + columns = ( + TextColumn("[progress.description]{task.description}"), + BarColumn(), + DownloadColumn(), + TransferSpeedColumn(), + TextColumn("eta"), + TimeRemainingColumn(), + ) + + progress = Progress(*columns, refresh_per_second=5) + task_id = progress.add_task(" " * (get_indentation() + 2), total=total) + with progress: + for chunk in iterable: + yield chunk + progress.update(task_id, advance=len(chunk)) + + +def _raw_progress_bar( + iterable: Iterable[bytes], + *, + size: Optional[int], +) -> Generator[bytes, None, None]: + def write_progress(current: int, total: int) -> None: + sys.stdout.write(f"Progress {current} of {total}\n") + sys.stdout.flush() + + current = 0 + total = size or 0 + rate_limiter = RateLimiter(0.25) + + write_progress(current, total) + for chunk in iterable: + current += len(chunk) + if rate_limiter.ready() or current == total: + write_progress(current, total) + rate_limiter.reset() + yield chunk + + +def get_download_progress_renderer( + *, bar_type: str, size: Optional[int] = None +) -> DownloadProgressRenderer: + """Get an object that can be used to render the download progress. + + Returns a callable, that takes an iterable to "wrap". + """ + if bar_type == "on": + return functools.partial(_rich_progress_bar, bar_type=bar_type, size=size) + elif bar_type == "raw": + return functools.partial(_raw_progress_bar, size=size) + else: + return iter # no-op, when passed an iterator diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/cli/req_command.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/cli/req_command.py new file mode 100644 index 0000000..92900f9 --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/cli/req_command.py @@ -0,0 +1,329 @@ +"""Contains the RequirementCommand base class. + +This class is in a separate module so the commands that do not always +need PackageFinder capability don't unnecessarily import the +PackageFinder machinery and all its vendored dependencies, etc. +""" + +import logging +from functools import partial +from optparse import Values +from typing import Any, List, Optional, Tuple + +from pip._internal.cache import WheelCache +from pip._internal.cli import cmdoptions +from pip._internal.cli.index_command import IndexGroupCommand +from pip._internal.cli.index_command import SessionCommandMixin as SessionCommandMixin +from pip._internal.exceptions import CommandError, PreviousBuildDirError +from pip._internal.index.collector import LinkCollector +from pip._internal.index.package_finder import PackageFinder +from pip._internal.models.selection_prefs import SelectionPreferences +from pip._internal.models.target_python import TargetPython +from pip._internal.network.session import PipSession +from pip._internal.operations.build.build_tracker import BuildTracker +from pip._internal.operations.prepare import RequirementPreparer +from pip._internal.req.constructors import ( + install_req_from_editable, + install_req_from_line, + install_req_from_parsed_requirement, + install_req_from_req_string, +) +from pip._internal.req.req_file import parse_requirements +from pip._internal.req.req_install import InstallRequirement +from pip._internal.resolution.base import BaseResolver +from pip._internal.utils.temp_dir import ( + TempDirectory, + TempDirectoryTypeRegistry, + tempdir_kinds, +) + +logger = logging.getLogger(__name__) + + +KEEPABLE_TEMPDIR_TYPES = [ + tempdir_kinds.BUILD_ENV, + tempdir_kinds.EPHEM_WHEEL_CACHE, + tempdir_kinds.REQ_BUILD, +] + + +def with_cleanup(func: Any) -> Any: + """Decorator for common logic related to managing temporary + directories. + """ + + def configure_tempdir_registry(registry: TempDirectoryTypeRegistry) -> None: + for t in KEEPABLE_TEMPDIR_TYPES: + registry.set_delete(t, False) + + def wrapper( + self: RequirementCommand, options: Values, args: List[Any] + ) -> Optional[int]: + assert self.tempdir_registry is not None + if options.no_clean: + configure_tempdir_registry(self.tempdir_registry) + + try: + return func(self, options, args) + except PreviousBuildDirError: + # This kind of conflict can occur when the user passes an explicit + # build directory with a pre-existing folder. In that case we do + # not want to accidentally remove it. + configure_tempdir_registry(self.tempdir_registry) + raise + + return wrapper + + +class RequirementCommand(IndexGroupCommand): + def __init__(self, *args: Any, **kw: Any) -> None: + super().__init__(*args, **kw) + + self.cmd_opts.add_option(cmdoptions.no_clean()) + + @staticmethod + def determine_resolver_variant(options: Values) -> str: + """Determines which resolver should be used, based on the given options.""" + if "legacy-resolver" in options.deprecated_features_enabled: + return "legacy" + + return "resolvelib" + + @classmethod + def make_requirement_preparer( + cls, + temp_build_dir: TempDirectory, + options: Values, + build_tracker: BuildTracker, + session: PipSession, + finder: PackageFinder, + use_user_site: bool, + download_dir: Optional[str] = None, + verbosity: int = 0, + ) -> RequirementPreparer: + """ + Create a RequirementPreparer instance for the given parameters. + """ + temp_build_dir_path = temp_build_dir.path + assert temp_build_dir_path is not None + legacy_resolver = False + + resolver_variant = cls.determine_resolver_variant(options) + if resolver_variant == "resolvelib": + lazy_wheel = "fast-deps" in options.features_enabled + if lazy_wheel: + logger.warning( + "pip is using lazily downloaded wheels using HTTP " + "range requests to obtain dependency information. " + "This experimental feature is enabled through " + "--use-feature=fast-deps and it is not ready for " + "production." + ) + else: + legacy_resolver = True + lazy_wheel = False + if "fast-deps" in options.features_enabled: + logger.warning( + "fast-deps has no effect when used with the legacy resolver." + ) + + return RequirementPreparer( + build_dir=temp_build_dir_path, + src_dir=options.src_dir, + download_dir=download_dir, + build_isolation=options.build_isolation, + check_build_deps=options.check_build_deps, + build_tracker=build_tracker, + session=session, + progress_bar=options.progress_bar, + finder=finder, + require_hashes=options.require_hashes, + use_user_site=use_user_site, + lazy_wheel=lazy_wheel, + verbosity=verbosity, + legacy_resolver=legacy_resolver, + ) + + @classmethod + def make_resolver( + cls, + preparer: RequirementPreparer, + finder: PackageFinder, + options: Values, + wheel_cache: Optional[WheelCache] = None, + use_user_site: bool = False, + ignore_installed: bool = True, + ignore_requires_python: bool = False, + force_reinstall: bool = False, + upgrade_strategy: str = "to-satisfy-only", + use_pep517: Optional[bool] = None, + py_version_info: Optional[Tuple[int, ...]] = None, + ) -> BaseResolver: + """ + Create a Resolver instance for the given parameters. + """ + make_install_req = partial( + install_req_from_req_string, + isolated=options.isolated_mode, + use_pep517=use_pep517, + ) + resolver_variant = cls.determine_resolver_variant(options) + # The long import name and duplicated invocation is needed to convince + # Mypy into correctly typechecking. Otherwise it would complain the + # "Resolver" class being redefined. + if resolver_variant == "resolvelib": + import pip._internal.resolution.resolvelib.resolver + + return pip._internal.resolution.resolvelib.resolver.Resolver( + preparer=preparer, + finder=finder, + wheel_cache=wheel_cache, + make_install_req=make_install_req, + use_user_site=use_user_site, + ignore_dependencies=options.ignore_dependencies, + ignore_installed=ignore_installed, + ignore_requires_python=ignore_requires_python, + force_reinstall=force_reinstall, + upgrade_strategy=upgrade_strategy, + py_version_info=py_version_info, + ) + import pip._internal.resolution.legacy.resolver + + return pip._internal.resolution.legacy.resolver.Resolver( + preparer=preparer, + finder=finder, + wheel_cache=wheel_cache, + make_install_req=make_install_req, + use_user_site=use_user_site, + ignore_dependencies=options.ignore_dependencies, + ignore_installed=ignore_installed, + ignore_requires_python=ignore_requires_python, + force_reinstall=force_reinstall, + upgrade_strategy=upgrade_strategy, + py_version_info=py_version_info, + ) + + def get_requirements( + self, + args: List[str], + options: Values, + finder: PackageFinder, + session: PipSession, + ) -> List[InstallRequirement]: + """ + Parse command-line arguments into the corresponding requirements. + """ + requirements: List[InstallRequirement] = [] + for filename in options.constraints: + for parsed_req in parse_requirements( + filename, + constraint=True, + finder=finder, + options=options, + session=session, + ): + req_to_add = install_req_from_parsed_requirement( + parsed_req, + isolated=options.isolated_mode, + user_supplied=False, + ) + requirements.append(req_to_add) + + for req in args: + req_to_add = install_req_from_line( + req, + comes_from=None, + isolated=options.isolated_mode, + use_pep517=options.use_pep517, + user_supplied=True, + config_settings=getattr(options, "config_settings", None), + ) + requirements.append(req_to_add) + + for req in options.editables: + req_to_add = install_req_from_editable( + req, + user_supplied=True, + isolated=options.isolated_mode, + use_pep517=options.use_pep517, + config_settings=getattr(options, "config_settings", None), + ) + requirements.append(req_to_add) + + # NOTE: options.require_hashes may be set if --require-hashes is True + for filename in options.requirements: + for parsed_req in parse_requirements( + filename, finder=finder, options=options, session=session + ): + req_to_add = install_req_from_parsed_requirement( + parsed_req, + isolated=options.isolated_mode, + use_pep517=options.use_pep517, + user_supplied=True, + config_settings=( + parsed_req.options.get("config_settings") + if parsed_req.options + else None + ), + ) + requirements.append(req_to_add) + + # If any requirement has hash options, enable hash checking. + if any(req.has_hash_options for req in requirements): + options.require_hashes = True + + if not (args or options.editables or options.requirements): + opts = {"name": self.name} + if options.find_links: + raise CommandError( + "You must give at least one requirement to {name} " + '(maybe you meant "pip {name} {links}"?)'.format( + **dict(opts, links=" ".join(options.find_links)) + ) + ) + else: + raise CommandError( + "You must give at least one requirement to {name} " + '(see "pip help {name}")'.format(**opts) + ) + + return requirements + + @staticmethod + def trace_basic_info(finder: PackageFinder) -> None: + """ + Trace basic information about the provided objects. + """ + # Display where finder is looking for packages + search_scope = finder.search_scope + locations = search_scope.get_formatted_locations() + if locations: + logger.info(locations) + + def _build_package_finder( + self, + options: Values, + session: PipSession, + target_python: Optional[TargetPython] = None, + ignore_requires_python: Optional[bool] = None, + ) -> PackageFinder: + """ + Create a package finder appropriate to this requirement command. + + :param ignore_requires_python: Whether to ignore incompatible + "Requires-Python" values in links. Defaults to False. + """ + link_collector = LinkCollector.create(session, options=options) + selection_prefs = SelectionPreferences( + allow_yanked=True, + format_control=options.format_control, + allow_all_prereleases=options.pre, + prefer_binary=options.prefer_binary, + ignore_requires_python=ignore_requires_python, + ) + + return PackageFinder.create( + link_collector=link_collector, + selection_prefs=selection_prefs, + target_python=target_python, + ) diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/cli/spinners.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/cli/spinners.py new file mode 100644 index 0000000..cf2b976 --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/cli/spinners.py @@ -0,0 +1,159 @@ +import contextlib +import itertools +import logging +import sys +import time +from typing import IO, Generator, Optional + +from pip._internal.utils.compat import WINDOWS +from pip._internal.utils.logging import get_indentation + +logger = logging.getLogger(__name__) + + +class SpinnerInterface: + def spin(self) -> None: + raise NotImplementedError() + + def finish(self, final_status: str) -> None: + raise NotImplementedError() + + +class InteractiveSpinner(SpinnerInterface): + def __init__( + self, + message: str, + file: Optional[IO[str]] = None, + spin_chars: str = "-\\|/", + # Empirically, 8 updates/second looks nice + min_update_interval_seconds: float = 0.125, + ): + self._message = message + if file is None: + file = sys.stdout + self._file = file + self._rate_limiter = RateLimiter(min_update_interval_seconds) + self._finished = False + + self._spin_cycle = itertools.cycle(spin_chars) + + self._file.write(" " * get_indentation() + self._message + " ... ") + self._width = 0 + + def _write(self, status: str) -> None: + assert not self._finished + # Erase what we wrote before by backspacing to the beginning, writing + # spaces to overwrite the old text, and then backspacing again + backup = "\b" * self._width + self._file.write(backup + " " * self._width + backup) + # Now we have a blank slate to add our status + self._file.write(status) + self._width = len(status) + self._file.flush() + self._rate_limiter.reset() + + def spin(self) -> None: + if self._finished: + return + if not self._rate_limiter.ready(): + return + self._write(next(self._spin_cycle)) + + def finish(self, final_status: str) -> None: + if self._finished: + return + self._write(final_status) + self._file.write("\n") + self._file.flush() + self._finished = True + + +# Used for dumb terminals, non-interactive installs (no tty), etc. +# We still print updates occasionally (once every 60 seconds by default) to +# act as a keep-alive for systems like Travis-CI that take lack-of-output as +# an indication that a task has frozen. +class NonInteractiveSpinner(SpinnerInterface): + def __init__(self, message: str, min_update_interval_seconds: float = 60.0) -> None: + self._message = message + self._finished = False + self._rate_limiter = RateLimiter(min_update_interval_seconds) + self._update("started") + + def _update(self, status: str) -> None: + assert not self._finished + self._rate_limiter.reset() + logger.info("%s: %s", self._message, status) + + def spin(self) -> None: + if self._finished: + return + if not self._rate_limiter.ready(): + return + self._update("still running...") + + def finish(self, final_status: str) -> None: + if self._finished: + return + self._update(f"finished with status '{final_status}'") + self._finished = True + + +class RateLimiter: + def __init__(self, min_update_interval_seconds: float) -> None: + self._min_update_interval_seconds = min_update_interval_seconds + self._last_update: float = 0 + + def ready(self) -> bool: + now = time.time() + delta = now - self._last_update + return delta >= self._min_update_interval_seconds + + def reset(self) -> None: + self._last_update = time.time() + + +@contextlib.contextmanager +def open_spinner(message: str) -> Generator[SpinnerInterface, None, None]: + # Interactive spinner goes directly to sys.stdout rather than being routed + # through the logging system, but it acts like it has level INFO, + # i.e. it's only displayed if we're at level INFO or better. + # Non-interactive spinner goes through the logging system, so it is always + # in sync with logging configuration. + if sys.stdout.isatty() and logger.getEffectiveLevel() <= logging.INFO: + spinner: SpinnerInterface = InteractiveSpinner(message) + else: + spinner = NonInteractiveSpinner(message) + try: + with hidden_cursor(sys.stdout): + yield spinner + except KeyboardInterrupt: + spinner.finish("canceled") + raise + except Exception: + spinner.finish("error") + raise + else: + spinner.finish("done") + + +HIDE_CURSOR = "\x1b[?25l" +SHOW_CURSOR = "\x1b[?25h" + + +@contextlib.contextmanager +def hidden_cursor(file: IO[str]) -> Generator[None, None, None]: + # The Windows terminal does not support the hide/show cursor ANSI codes, + # even via colorama. So don't even try. + if WINDOWS: + yield + # We don't want to clutter the output with control characters if we're + # writing to a file, or if the user is running with --quiet. + # See https://github.com/pypa/pip/issues/3418 + elif not file.isatty() or logger.getEffectiveLevel() > logging.INFO: + yield + else: + file.write(HIDE_CURSOR) + try: + yield + finally: + file.write(SHOW_CURSOR) diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/cli/status_codes.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/cli/status_codes.py new file mode 100644 index 0000000..5e29502 --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/cli/status_codes.py @@ -0,0 +1,6 @@ +SUCCESS = 0 +ERROR = 1 +UNKNOWN_ERROR = 2 +VIRTUALENV_NOT_FOUND = 3 +PREVIOUS_BUILD_DIR_ERROR = 4 +NO_MATCHES_FOUND = 23 diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/commands/__init__.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/commands/__init__.py new file mode 100644 index 0000000..858a410 --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/commands/__init__.py @@ -0,0 +1,132 @@ +""" +Package containing all pip commands +""" + +import importlib +from collections import namedtuple +from typing import Any, Dict, Optional + +from pip._internal.cli.base_command import Command + +CommandInfo = namedtuple("CommandInfo", "module_path, class_name, summary") + +# This dictionary does a bunch of heavy lifting for help output: +# - Enables avoiding additional (costly) imports for presenting `--help`. +# - The ordering matters for help display. +# +# Even though the module path starts with the same "pip._internal.commands" +# prefix, the full path makes testing easier (specifically when modifying +# `commands_dict` in test setup / teardown). +commands_dict: Dict[str, CommandInfo] = { + "install": CommandInfo( + "pip._internal.commands.install", + "InstallCommand", + "Install packages.", + ), + "download": CommandInfo( + "pip._internal.commands.download", + "DownloadCommand", + "Download packages.", + ), + "uninstall": CommandInfo( + "pip._internal.commands.uninstall", + "UninstallCommand", + "Uninstall packages.", + ), + "freeze": CommandInfo( + "pip._internal.commands.freeze", + "FreezeCommand", + "Output installed packages in requirements format.", + ), + "inspect": CommandInfo( + "pip._internal.commands.inspect", + "InspectCommand", + "Inspect the python environment.", + ), + "list": CommandInfo( + "pip._internal.commands.list", + "ListCommand", + "List installed packages.", + ), + "show": CommandInfo( + "pip._internal.commands.show", + "ShowCommand", + "Show information about installed packages.", + ), + "check": CommandInfo( + "pip._internal.commands.check", + "CheckCommand", + "Verify installed packages have compatible dependencies.", + ), + "config": CommandInfo( + "pip._internal.commands.configuration", + "ConfigurationCommand", + "Manage local and global configuration.", + ), + "search": CommandInfo( + "pip._internal.commands.search", + "SearchCommand", + "Search PyPI for packages.", + ), + "cache": CommandInfo( + "pip._internal.commands.cache", + "CacheCommand", + "Inspect and manage pip's wheel cache.", + ), + "index": CommandInfo( + "pip._internal.commands.index", + "IndexCommand", + "Inspect information available from package indexes.", + ), + "wheel": CommandInfo( + "pip._internal.commands.wheel", + "WheelCommand", + "Build wheels from your requirements.", + ), + "hash": CommandInfo( + "pip._internal.commands.hash", + "HashCommand", + "Compute hashes of package archives.", + ), + "completion": CommandInfo( + "pip._internal.commands.completion", + "CompletionCommand", + "A helper command used for command completion.", + ), + "debug": CommandInfo( + "pip._internal.commands.debug", + "DebugCommand", + "Show information useful for debugging.", + ), + "help": CommandInfo( + "pip._internal.commands.help", + "HelpCommand", + "Show help for commands.", + ), +} + + +def create_command(name: str, **kwargs: Any) -> Command: + """ + Create an instance of the Command class with the given name. + """ + module_path, class_name, summary = commands_dict[name] + module = importlib.import_module(module_path) + command_class = getattr(module, class_name) + command = command_class(name=name, summary=summary, **kwargs) + + return command + + +def get_similar_commands(name: str) -> Optional[str]: + """Command name auto-correct.""" + from difflib import get_close_matches + + name = name.lower() + + close_commands = get_close_matches(name, commands_dict.keys()) + + if close_commands: + return close_commands[0] + else: + return None diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/commands/__pycache__/__init__.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/commands/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000..ddae105 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/commands/__pycache__/__init__.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/commands/__pycache__/cache.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/commands/__pycache__/cache.cpython-312.pyc new file mode 100644 index 0000000..4a43727 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/commands/__pycache__/cache.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/commands/__pycache__/check.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/commands/__pycache__/check.cpython-312.pyc new file mode 100644 index 0000000..e552fb8 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/commands/__pycache__/check.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/commands/__pycache__/completion.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/commands/__pycache__/completion.cpython-312.pyc new file mode 100644 index 0000000..4084196 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/commands/__pycache__/completion.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/commands/__pycache__/configuration.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/commands/__pycache__/configuration.cpython-312.pyc new file mode 100644 index 0000000..f8db1f0 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/commands/__pycache__/configuration.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/commands/__pycache__/debug.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/commands/__pycache__/debug.cpython-312.pyc new file mode 100644 index 0000000..005e826 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/commands/__pycache__/debug.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/commands/__pycache__/download.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/commands/__pycache__/download.cpython-312.pyc new file mode 100644 index 0000000..77a386e Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/commands/__pycache__/download.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/commands/__pycache__/freeze.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/commands/__pycache__/freeze.cpython-312.pyc new file mode 100644 index 0000000..1f4d64f Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/commands/__pycache__/freeze.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/commands/__pycache__/hash.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/commands/__pycache__/hash.cpython-312.pyc new file mode 100644 index 0000000..d2df4e1 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/commands/__pycache__/hash.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/commands/__pycache__/help.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/commands/__pycache__/help.cpython-312.pyc new file mode 100644 index 0000000..c4d62be Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/commands/__pycache__/help.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/commands/__pycache__/index.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/commands/__pycache__/index.cpython-312.pyc new file mode 100644 index 0000000..f82751d Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/commands/__pycache__/index.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/commands/__pycache__/inspect.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/commands/__pycache__/inspect.cpython-312.pyc new file mode 100644 index 0000000..892abd9 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/commands/__pycache__/inspect.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/commands/__pycache__/install.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/commands/__pycache__/install.cpython-312.pyc new file mode 100644 index 0000000..9c72c3d Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/commands/__pycache__/install.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/commands/__pycache__/list.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/commands/__pycache__/list.cpython-312.pyc new file mode 100644 index 0000000..b60eb63 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/commands/__pycache__/list.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/commands/__pycache__/search.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/commands/__pycache__/search.cpython-312.pyc new file mode 100644 index 0000000..1f0bf38 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/commands/__pycache__/search.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/commands/__pycache__/show.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/commands/__pycache__/show.cpython-312.pyc new file mode 100644 index 0000000..6312964 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/commands/__pycache__/show.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/commands/__pycache__/uninstall.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/commands/__pycache__/uninstall.cpython-312.pyc new file mode 100644 index 0000000..55fe115 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/commands/__pycache__/uninstall.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/commands/__pycache__/wheel.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/commands/__pycache__/wheel.cpython-312.pyc new file mode 100644 index 0000000..0db12bc Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/commands/__pycache__/wheel.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/commands/cache.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/commands/cache.py new file mode 100644 index 0000000..ad65641 --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/commands/cache.py @@ -0,0 +1,228 @@ +import os +import textwrap +from optparse import Values +from typing import Any, List + +from pip._internal.cli.base_command import Command +from pip._internal.cli.status_codes import ERROR, SUCCESS +from pip._internal.exceptions import CommandError, PipError +from pip._internal.utils import filesystem +from pip._internal.utils.logging import getLogger +from pip._internal.utils.misc import format_size + +logger = getLogger(__name__) + + +class CacheCommand(Command): + """ + Inspect and manage pip's wheel cache. + + Subcommands: + + - dir: Show the cache directory. + - info: Show information about the cache. + - list: List filenames of packages stored in the cache. + - remove: Remove one or more package from the cache. + - purge: Remove all items from the cache. + + ```` can be a glob expression or a package name. + """ + + ignore_require_venv = True + usage = """ + %prog dir + %prog info + %prog list [] [--format=[human, abspath]] + %prog remove + %prog purge + """ + + def add_options(self) -> None: + self.cmd_opts.add_option( + "--format", + action="store", + dest="list_format", + default="human", + choices=("human", "abspath"), + help="Select the output format among: human (default) or abspath", + ) + + self.parser.insert_option_group(0, self.cmd_opts) + + def run(self, options: Values, args: List[str]) -> int: + handlers = { + "dir": self.get_cache_dir, + "info": self.get_cache_info, + "list": self.list_cache_items, + "remove": self.remove_cache_items, + "purge": self.purge_cache, + } + + if not options.cache_dir: + logger.error("pip cache commands can not function since cache is disabled.") + return ERROR + + # Determine action + if not args or args[0] not in handlers: + logger.error( + "Need an action (%s) to perform.", + ", ".join(sorted(handlers)), + ) + return ERROR + + action = args[0] + + # Error handling happens here, not in the action-handlers. + try: + handlers[action](options, args[1:]) + except PipError as e: + logger.error(e.args[0]) + return ERROR + + return SUCCESS + + def get_cache_dir(self, options: Values, args: List[Any]) -> None: + if args: + raise CommandError("Too many arguments") + + logger.info(options.cache_dir) + + def get_cache_info(self, options: Values, args: List[Any]) -> None: + if args: + raise CommandError("Too many arguments") + + num_http_files = len(self._find_http_files(options)) + num_packages = len(self._find_wheels(options, "*")) + + http_cache_location = self._cache_dir(options, "http-v2") + old_http_cache_location = self._cache_dir(options, "http") + wheels_cache_location = self._cache_dir(options, "wheels") + http_cache_size = filesystem.format_size( + filesystem.directory_size(http_cache_location) + + filesystem.directory_size(old_http_cache_location) + ) + wheels_cache_size = filesystem.format_directory_size(wheels_cache_location) + + message = ( + textwrap.dedent( + """ + Package index page cache location (pip v23.3+): {http_cache_location} + Package index page cache location (older pips): {old_http_cache_location} + Package index page cache size: {http_cache_size} + Number of HTTP files: {num_http_files} + Locally built wheels location: {wheels_cache_location} + Locally built wheels size: {wheels_cache_size} + Number of locally built wheels: {package_count} + """ # noqa: E501 + ) + .format( + http_cache_location=http_cache_location, + old_http_cache_location=old_http_cache_location, + http_cache_size=http_cache_size, + num_http_files=num_http_files, + wheels_cache_location=wheels_cache_location, + package_count=num_packages, + wheels_cache_size=wheels_cache_size, + ) + .strip() + ) + + logger.info(message) + + def list_cache_items(self, options: Values, args: List[Any]) -> None: + if len(args) > 1: + raise CommandError("Too many arguments") + + if args: + pattern = args[0] + else: + pattern = "*" + + files = self._find_wheels(options, pattern) + if options.list_format == "human": + self.format_for_human(files) + else: + self.format_for_abspath(files) + + def format_for_human(self, files: List[str]) -> None: + if not files: + logger.info("No locally built wheels cached.") + return + + results = [] + for filename in files: + wheel = os.path.basename(filename) + size = filesystem.format_file_size(filename) + results.append(f" - {wheel} ({size})") + logger.info("Cache contents:\n") + logger.info("\n".join(sorted(results))) + + def format_for_abspath(self, files: List[str]) -> None: + if files: + logger.info("\n".join(sorted(files))) + + def remove_cache_items(self, options: Values, args: List[Any]) -> None: + if len(args) > 1: + raise CommandError("Too many arguments") + + if not args: + raise CommandError("Please provide a pattern") + + files = self._find_wheels(options, args[0]) + + no_matching_msg = "No matching packages" + if args[0] == "*": + # Only fetch http files if no specific pattern given + files += self._find_http_files(options) + else: + # Add the pattern to the log message + no_matching_msg += f' for pattern "{args[0]}"' + + if not files: + logger.warning(no_matching_msg) + + bytes_removed = 0 + for filename in files: + bytes_removed += os.stat(filename).st_size + os.unlink(filename) + logger.verbose("Removed %s", filename) + logger.info("Files removed: %s (%s)", len(files), format_size(bytes_removed)) + + def purge_cache(self, options: Values, args: List[Any]) -> None: + if args: + raise CommandError("Too many arguments") + + return self.remove_cache_items(options, ["*"]) + + def _cache_dir(self, options: Values, subdir: str) -> str: + return os.path.join(options.cache_dir, subdir) + + def _find_http_files(self, options: Values) -> List[str]: + old_http_dir = self._cache_dir(options, "http") + new_http_dir = self._cache_dir(options, "http-v2") + return filesystem.find_files(old_http_dir, "*") + filesystem.find_files( + new_http_dir, "*" + ) + + def _find_wheels(self, options: Values, pattern: str) -> List[str]: + wheel_dir = self._cache_dir(options, "wheels") + + # The wheel filename format, as specified in PEP 427, is: + # {distribution}-{version}(-{build})?-{python}-{abi}-{platform}.whl + # + # Additionally, non-alphanumeric values in the distribution are + # normalized to underscores (_), meaning hyphens can never occur + # before `-{version}`. + # + # Given that information: + # - If the pattern we're given contains a hyphen (-), the user is + # providing at least the version. Thus, we can just append `*.whl` + # to match the rest of it. + # - If the pattern we're given doesn't contain a hyphen (-), the + # user is only providing the name. Thus, we append `-*.whl` to + # match the hyphen before the version, followed by anything else. + # + # PEP 427: https://www.python.org/dev/peps/pep-0427/ + pattern = pattern + ("*.whl" if "-" in pattern else "-*.whl") + + return filesystem.find_files(wheel_dir, pattern) diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/commands/check.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/commands/check.py new file mode 100644 index 0000000..f54a16d --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/commands/check.py @@ -0,0 +1,67 @@ +import logging +from optparse import Values +from typing import List + +from pip._internal.cli.base_command import Command +from pip._internal.cli.status_codes import ERROR, SUCCESS +from pip._internal.metadata import get_default_environment +from pip._internal.operations.check import ( + check_package_set, + check_unsupported, + create_package_set_from_installed, +) +from pip._internal.utils.compatibility_tags import get_supported +from pip._internal.utils.misc import write_output + +logger = logging.getLogger(__name__) + + +class CheckCommand(Command): + """Verify installed packages have compatible dependencies.""" + + ignore_require_venv = True + usage = """ + %prog [options]""" + + def run(self, options: Values, args: List[str]) -> int: + package_set, parsing_probs = create_package_set_from_installed() + missing, conflicting = check_package_set(package_set) + unsupported = list( + check_unsupported( + get_default_environment().iter_installed_distributions(), + get_supported(), + ) + ) + + for project_name in missing: + version = package_set[project_name].version + for dependency in missing[project_name]: + write_output( + "%s %s requires %s, which is not installed.", + project_name, + version, + dependency[0], + ) + + for project_name in conflicting: + version = package_set[project_name].version + for dep_name, dep_version, req in conflicting[project_name]: + write_output( + "%s %s has requirement %s, but you have %s %s.", + project_name, + version, + req, + dep_name, + dep_version, + ) + for package in unsupported: + write_output( + "%s %s is not supported on this platform", + package.raw_name, + package.version, + ) + if missing or conflicting or parsing_probs or unsupported: + return ERROR + else: + write_output("No broken requirements found.") + return SUCCESS diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/commands/completion.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/commands/completion.py new file mode 100644 index 0000000..9e89e27 --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/commands/completion.py @@ -0,0 +1,130 @@ +import sys +import textwrap +from optparse import Values +from typing import List + +from pip._internal.cli.base_command import Command +from pip._internal.cli.status_codes import SUCCESS +from pip._internal.utils.misc import get_prog + +BASE_COMPLETION = """ +# pip {shell} completion start{script}# pip {shell} completion end +""" + +COMPLETION_SCRIPTS = { + "bash": """ + _pip_completion() + {{ + COMPREPLY=( $( COMP_WORDS="${{COMP_WORDS[*]}}" \\ + COMP_CWORD=$COMP_CWORD \\ + PIP_AUTO_COMPLETE=1 $1 2>/dev/null ) ) + }} + complete -o default -F _pip_completion {prog} + """, + "zsh": """ + #compdef -P pip[0-9.]# + __pip() {{ + compadd $( COMP_WORDS="$words[*]" \\ + COMP_CWORD=$((CURRENT-1)) \\ + PIP_AUTO_COMPLETE=1 $words[1] 2>/dev/null ) + }} + if [[ $zsh_eval_context[-1] == loadautofunc ]]; then + # autoload from fpath, call function directly + __pip "$@" + else + # eval/source/. command, register function for later + compdef __pip -P 'pip[0-9.]#' + fi + """, + "fish": """ + function __fish_complete_pip + set -lx COMP_WORDS (commandline -o) "" + set -lx COMP_CWORD ( \\ + math (contains -i -- (commandline -t) $COMP_WORDS)-1 \\ + ) + set -lx PIP_AUTO_COMPLETE 1 + string split \\ -- (eval $COMP_WORDS[1]) + end + complete -fa "(__fish_complete_pip)" -c {prog} + """, + "powershell": """ + if ((Test-Path Function:\\TabExpansion) -and -not ` + (Test-Path Function:\\_pip_completeBackup)) {{ + Rename-Item Function:\\TabExpansion _pip_completeBackup + }} + function TabExpansion($line, $lastWord) {{ + $lastBlock = [regex]::Split($line, '[|;]')[-1].TrimStart() + if ($lastBlock.StartsWith("{prog} ")) {{ + $Env:COMP_WORDS=$lastBlock + $Env:COMP_CWORD=$lastBlock.Split().Length - 1 + $Env:PIP_AUTO_COMPLETE=1 + (& {prog}).Split() + Remove-Item Env:COMP_WORDS + Remove-Item Env:COMP_CWORD + Remove-Item Env:PIP_AUTO_COMPLETE + }} + elseif (Test-Path Function:\\_pip_completeBackup) {{ + # Fall back on existing tab expansion + _pip_completeBackup $line $lastWord + }} + }} + """, +} + + +class CompletionCommand(Command): + """A helper command to be used for command completion.""" + + ignore_require_venv = True + + def add_options(self) -> None: + self.cmd_opts.add_option( + "--bash", + "-b", + action="store_const", + const="bash", + dest="shell", + help="Emit completion code for bash", + ) + self.cmd_opts.add_option( + "--zsh", + "-z", + action="store_const", + const="zsh", + dest="shell", + help="Emit completion code for zsh", + ) + self.cmd_opts.add_option( + "--fish", + "-f", + action="store_const", + const="fish", + dest="shell", + help="Emit completion code for fish", + ) + self.cmd_opts.add_option( + "--powershell", + "-p", + action="store_const", + const="powershell", + dest="shell", + help="Emit completion code for powershell", + ) + + self.parser.insert_option_group(0, self.cmd_opts) + + def run(self, options: Values, args: List[str]) -> int: + """Prints the completion code of the given shell""" + shells = COMPLETION_SCRIPTS.keys() + shell_options = ["--" + shell for shell in sorted(shells)] + if options.shell in shells: + script = textwrap.dedent( + COMPLETION_SCRIPTS.get(options.shell, "").format(prog=get_prog()) + ) + print(BASE_COMPLETION.format(script=script, shell=options.shell)) + return SUCCESS + else: + sys.stderr.write( + "ERROR: You must pass {}\n".format(" or ".join(shell_options)) + ) + return SUCCESS diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/commands/configuration.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/commands/configuration.py new file mode 100644 index 0000000..1a1dc6b --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/commands/configuration.py @@ -0,0 +1,280 @@ +import logging +import os +import subprocess +from optparse import Values +from typing import Any, List, Optional + +from pip._internal.cli.base_command import Command +from pip._internal.cli.status_codes import ERROR, SUCCESS +from pip._internal.configuration import ( + Configuration, + Kind, + get_configuration_files, + kinds, +) +from pip._internal.exceptions import PipError +from pip._internal.utils.logging import indent_log +from pip._internal.utils.misc import get_prog, write_output + +logger = logging.getLogger(__name__) + + +class ConfigurationCommand(Command): + """ + Manage local and global configuration. + + Subcommands: + + - list: List the active configuration (or from the file specified) + - edit: Edit the configuration file in an editor + - get: Get the value associated with command.option + - set: Set the command.option=value + - unset: Unset the value associated with command.option + - debug: List the configuration files and values defined under them + + Configuration keys should be dot separated command and option name, + with the special prefix "global" affecting any command. For example, + "pip config set global.index-url https://example.org/" would configure + the index url for all commands, but "pip config set download.timeout 10" + would configure a 10 second timeout only for "pip download" commands. + + If none of --user, --global and --site are passed, a virtual + environment configuration file is used if one is active and the file + exists. Otherwise, all modifications happen to the user file by + default. + """ + + ignore_require_venv = True + usage = """ + %prog [] list + %prog [] [--editor ] edit + + %prog [] get command.option + %prog [] set command.option value + %prog [] unset command.option + %prog [] debug + """ + + def add_options(self) -> None: + self.cmd_opts.add_option( + "--editor", + dest="editor", + action="store", + default=None, + help=( + "Editor to use to edit the file. Uses VISUAL or EDITOR " + "environment variables if not provided." + ), + ) + + self.cmd_opts.add_option( + "--global", + dest="global_file", + action="store_true", + default=False, + help="Use the system-wide configuration file only", + ) + + self.cmd_opts.add_option( + "--user", + dest="user_file", + action="store_true", + default=False, + help="Use the user configuration file only", + ) + + self.cmd_opts.add_option( + "--site", + dest="site_file", + action="store_true", + default=False, + help="Use the current environment configuration file only", + ) + + self.parser.insert_option_group(0, self.cmd_opts) + + def run(self, options: Values, args: List[str]) -> int: + handlers = { + "list": self.list_values, + "edit": self.open_in_editor, + "get": self.get_name, + "set": self.set_name_value, + "unset": self.unset_name, + "debug": self.list_config_values, + } + + # Determine action + if not args or args[0] not in handlers: + logger.error( + "Need an action (%s) to perform.", + ", ".join(sorted(handlers)), + ) + return ERROR + + action = args[0] + + # Determine which configuration files are to be loaded + # Depends on whether the command is modifying. + try: + load_only = self._determine_file( + options, need_value=(action in ["get", "set", "unset", "edit"]) + ) + except PipError as e: + logger.error(e.args[0]) + return ERROR + + # Load a new configuration + self.configuration = Configuration( + isolated=options.isolated_mode, load_only=load_only + ) + self.configuration.load() + + # Error handling happens here, not in the action-handlers. + try: + handlers[action](options, args[1:]) + except PipError as e: + logger.error(e.args[0]) + return ERROR + + return SUCCESS + + def _determine_file(self, options: Values, need_value: bool) -> Optional[Kind]: + file_options = [ + key + for key, value in ( + (kinds.USER, options.user_file), + (kinds.GLOBAL, options.global_file), + (kinds.SITE, options.site_file), + ) + if value + ] + + if not file_options: + if not need_value: + return None + # Default to user, unless there's a site file. + elif any( + os.path.exists(site_config_file) + for site_config_file in get_configuration_files()[kinds.SITE] + ): + return kinds.SITE + else: + return kinds.USER + elif len(file_options) == 1: + return file_options[0] + + raise PipError( + "Need exactly one file to operate upon " + "(--user, --site, --global) to perform." + ) + + def list_values(self, options: Values, args: List[str]) -> None: + self._get_n_args(args, "list", n=0) + + for key, value in sorted(self.configuration.items()): + write_output("%s=%r", key, value) + + def get_name(self, options: Values, args: List[str]) -> None: + key = self._get_n_args(args, "get [name]", n=1) + value = self.configuration.get_value(key) + + write_output("%s", value) + + def set_name_value(self, options: Values, args: List[str]) -> None: + key, value = self._get_n_args(args, "set [name] [value]", n=2) + self.configuration.set_value(key, value) + + self._save_configuration() + + def unset_name(self, options: Values, args: List[str]) -> None: + key = self._get_n_args(args, "unset [name]", n=1) + self.configuration.unset_value(key) + + self._save_configuration() + + def list_config_values(self, options: Values, args: List[str]) -> None: + """List config key-value pairs across different config files""" + self._get_n_args(args, "debug", n=0) + + self.print_env_var_values() + # Iterate over config files and print if they exist, and the + # key-value pairs present in them if they do + for variant, files in sorted(self.configuration.iter_config_files()): + write_output("%s:", variant) + for fname in files: + with indent_log(): + file_exists = os.path.exists(fname) + write_output("%s, exists: %r", fname, file_exists) + if file_exists: + self.print_config_file_values(variant) + + def print_config_file_values(self, variant: Kind) -> None: + """Get key-value pairs from the file of a variant""" + for name, value in self.configuration.get_values_in_config(variant).items(): + with indent_log(): + write_output("%s: %s", name, value) + + def print_env_var_values(self) -> None: + """Get key-values pairs present as environment variables""" + write_output("%s:", "env_var") + with indent_log(): + for key, value in sorted(self.configuration.get_environ_vars()): + env_var = f"PIP_{key.upper()}" + write_output("%s=%r", env_var, value) + + def open_in_editor(self, options: Values, args: List[str]) -> None: + editor = self._determine_editor(options) + + fname = self.configuration.get_file_to_edit() + if fname is None: + raise PipError("Could not determine appropriate file.") + elif '"' in fname: + # This shouldn't happen, unless we see a username like that. + # If that happens, we'd appreciate a pull request fixing this. + raise PipError( + f'Can not open an editor for a file name containing "\n{fname}' + ) + + try: + subprocess.check_call(f'{editor} "{fname}"', shell=True) + except FileNotFoundError as e: + if not e.filename: + e.filename = editor + raise + except subprocess.CalledProcessError as e: + raise PipError(f"Editor Subprocess exited with exit code {e.returncode}") + + def _get_n_args(self, args: List[str], example: str, n: int) -> Any: + """Helper to make sure the command got the right number of arguments""" + if len(args) != n: + msg = ( + f"Got unexpected number of arguments, expected {n}. " + f'(example: "{get_prog()} config {example}")' + ) + raise PipError(msg) + + if n == 1: + return args[0] + else: + return args + + def _save_configuration(self) -> None: + # We successfully ran a modifying command. Need to save the + # configuration. + try: + self.configuration.save() + except Exception: + logger.exception( + "Unable to save configuration. Please report this as a bug." + ) + raise PipError("Internal Error.") + + def _determine_editor(self, options: Values) -> str: + if options.editor is not None: + return options.editor + elif "VISUAL" in os.environ: + return os.environ["VISUAL"] + elif "EDITOR" in os.environ: + return os.environ["EDITOR"] + else: + raise PipError("Could not determine editor to use.") diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/commands/debug.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/commands/debug.py new file mode 100644 index 0000000..567ca96 --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/commands/debug.py @@ -0,0 +1,201 @@ +import locale +import logging +import os +import sys +from optparse import Values +from types import ModuleType +from typing import Any, Dict, List, Optional + +import pip._vendor +from pip._vendor.certifi import where +from pip._vendor.packaging.version import parse as parse_version + +from pip._internal.cli import cmdoptions +from pip._internal.cli.base_command import Command +from pip._internal.cli.cmdoptions import make_target_python +from pip._internal.cli.status_codes import SUCCESS +from pip._internal.configuration import Configuration +from pip._internal.metadata import get_environment +from pip._internal.utils.compat import open_text_resource +from pip._internal.utils.logging import indent_log +from pip._internal.utils.misc import get_pip_version + +logger = logging.getLogger(__name__) + + +def show_value(name: str, value: Any) -> None: + logger.info("%s: %s", name, value) + + +def show_sys_implementation() -> None: + logger.info("sys.implementation:") + implementation_name = sys.implementation.name + with indent_log(): + show_value("name", implementation_name) + + +def create_vendor_txt_map() -> Dict[str, str]: + with open_text_resource("pip._vendor", "vendor.txt") as f: + # Purge non version specifying lines. + # Also, remove any space prefix or suffixes (including comments). + lines = [ + line.strip().split(" ", 1)[0] for line in f.readlines() if "==" in line + ] + + # Transform into "module" -> version dict. + return dict(line.split("==", 1) for line in lines) + + +def get_module_from_module_name(module_name: str) -> Optional[ModuleType]: + # Module name can be uppercase in vendor.txt for some reason... + module_name = module_name.lower().replace("-", "_") + # PATCH: setuptools is actually only pkg_resources. + if module_name == "setuptools": + module_name = "pkg_resources" + + try: + __import__(f"pip._vendor.{module_name}", globals(), locals(), level=0) + return getattr(pip._vendor, module_name) + except ImportError: + # We allow 'truststore' to fail to import due + # to being unavailable on Python 3.9 and earlier. + if module_name == "truststore" and sys.version_info < (3, 10): + return None + raise + + +def get_vendor_version_from_module(module_name: str) -> Optional[str]: + module = get_module_from_module_name(module_name) + version = getattr(module, "__version__", None) + + if module and not version: + # Try to find version in debundled module info. + assert module.__file__ is not None + env = get_environment([os.path.dirname(module.__file__)]) + dist = env.get_distribution(module_name) + if dist: + version = str(dist.version) + + return version + + +def show_actual_vendor_versions(vendor_txt_versions: Dict[str, str]) -> None: + """Log the actual version and print extra info if there is + a conflict or if the actual version could not be imported. + """ + for module_name, expected_version in vendor_txt_versions.items(): + extra_message = "" + actual_version = get_vendor_version_from_module(module_name) + if not actual_version: + extra_message = ( + " (Unable to locate actual module version, using" + " vendor.txt specified version)" + ) + actual_version = expected_version + elif parse_version(actual_version) != parse_version(expected_version): + extra_message = ( + " (CONFLICT: vendor.txt suggests version should" + f" be {expected_version})" + ) + logger.info("%s==%s%s", module_name, actual_version, extra_message) + + +def show_vendor_versions() -> None: + logger.info("vendored library versions:") + + vendor_txt_versions = create_vendor_txt_map() + with indent_log(): + show_actual_vendor_versions(vendor_txt_versions) + + +def show_tags(options: Values) -> None: + tag_limit = 10 + + target_python = make_target_python(options) + tags = target_python.get_sorted_tags() + + # Display the target options that were explicitly provided. + formatted_target = target_python.format_given() + suffix = "" + if formatted_target: + suffix = f" (target: {formatted_target})" + + msg = f"Compatible tags: {len(tags)}{suffix}" + logger.info(msg) + + if options.verbose < 1 and len(tags) > tag_limit: + tags_limited = True + tags = tags[:tag_limit] + else: + tags_limited = False + + with indent_log(): + for tag in tags: + logger.info(str(tag)) + + if tags_limited: + msg = f"...\n[First {tag_limit} tags shown. Pass --verbose to show all.]" + logger.info(msg) + + +def ca_bundle_info(config: Configuration) -> str: + levels = {key.split(".", 1)[0] for key, _ in config.items()} + if not levels: + return "Not specified" + + levels_that_override_global = ["install", "wheel", "download"] + global_overriding_level = [ + level for level in levels if level in levels_that_override_global + ] + if not global_overriding_level: + return "global" + + if "global" in levels: + levels.remove("global") + return ", ".join(levels) + + +class DebugCommand(Command): + """ + Display debug information. + """ + + usage = """ + %prog """ + ignore_require_venv = True + + def add_options(self) -> None: + cmdoptions.add_target_python_options(self.cmd_opts) + self.parser.insert_option_group(0, self.cmd_opts) + self.parser.config.load() + + def run(self, options: Values, args: List[str]) -> int: + logger.warning( + "This command is only meant for debugging. " + "Do not use this with automation for parsing and getting these " + "details, since the output and options of this command may " + "change without notice." + ) + show_value("pip version", get_pip_version()) + show_value("sys.version", sys.version) + show_value("sys.executable", sys.executable) + show_value("sys.getdefaultencoding", sys.getdefaultencoding()) + show_value("sys.getfilesystemencoding", sys.getfilesystemencoding()) + show_value( + "locale.getpreferredencoding", + locale.getpreferredencoding(), + ) + show_value("sys.platform", sys.platform) + show_sys_implementation() + + show_value("'cert' config value", ca_bundle_info(self.parser.config)) + show_value("REQUESTS_CA_BUNDLE", os.environ.get("REQUESTS_CA_BUNDLE")) + show_value("CURL_CA_BUNDLE", os.environ.get("CURL_CA_BUNDLE")) + show_value("pip._vendor.certifi.where()", where()) + show_value("pip._vendor.DEBUNDLED", pip._vendor.DEBUNDLED) + + show_vendor_versions() + + show_tags(options) + + return SUCCESS diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/commands/download.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/commands/download.py new file mode 100644 index 0000000..917bbb9 --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/commands/download.py @@ -0,0 +1,146 @@ +import logging +import os +from optparse import Values +from typing import List + +from pip._internal.cli import cmdoptions +from pip._internal.cli.cmdoptions import make_target_python +from pip._internal.cli.req_command import RequirementCommand, with_cleanup +from pip._internal.cli.status_codes import SUCCESS +from pip._internal.operations.build.build_tracker import get_build_tracker +from pip._internal.req.req_install import check_legacy_setup_py_options +from pip._internal.utils.misc import ensure_dir, normalize_path, write_output +from pip._internal.utils.temp_dir import TempDirectory + +logger = logging.getLogger(__name__) + + +class DownloadCommand(RequirementCommand): + """ + Download packages from: + + - PyPI (and other indexes) using requirement specifiers. + - VCS project urls. + - Local project directories. + - Local or remote source archives. + + pip also supports downloading from "requirements files", which provide + an easy way to specify a whole environment to be downloaded. + """ + + usage = """ + %prog [options] [package-index-options] ... + %prog [options] -r [package-index-options] ... + %prog [options] ... + %prog [options] ... + %prog [options] ...""" + + def add_options(self) -> None: + self.cmd_opts.add_option(cmdoptions.constraints()) + self.cmd_opts.add_option(cmdoptions.requirements()) + self.cmd_opts.add_option(cmdoptions.no_deps()) + self.cmd_opts.add_option(cmdoptions.global_options()) + self.cmd_opts.add_option(cmdoptions.no_binary()) + self.cmd_opts.add_option(cmdoptions.only_binary()) + self.cmd_opts.add_option(cmdoptions.prefer_binary()) + self.cmd_opts.add_option(cmdoptions.src()) + self.cmd_opts.add_option(cmdoptions.pre()) + self.cmd_opts.add_option(cmdoptions.require_hashes()) + self.cmd_opts.add_option(cmdoptions.progress_bar()) + self.cmd_opts.add_option(cmdoptions.no_build_isolation()) + self.cmd_opts.add_option(cmdoptions.use_pep517()) + self.cmd_opts.add_option(cmdoptions.no_use_pep517()) + self.cmd_opts.add_option(cmdoptions.check_build_deps()) + self.cmd_opts.add_option(cmdoptions.ignore_requires_python()) + + self.cmd_opts.add_option( + "-d", + "--dest", + "--destination-dir", + "--destination-directory", + dest="download_dir", + metavar="dir", + default=os.curdir, + help="Download packages into .", + ) + + cmdoptions.add_target_python_options(self.cmd_opts) + + index_opts = cmdoptions.make_option_group( + cmdoptions.index_group, + self.parser, + ) + + self.parser.insert_option_group(0, index_opts) + self.parser.insert_option_group(0, self.cmd_opts) + + @with_cleanup + def run(self, options: Values, args: List[str]) -> int: + options.ignore_installed = True + # editable doesn't really make sense for `pip download`, but the bowels + # of the RequirementSet code require that property. + options.editables = [] + + cmdoptions.check_dist_restriction(options) + + options.download_dir = normalize_path(options.download_dir) + ensure_dir(options.download_dir) + + session = self.get_default_session(options) + + target_python = make_target_python(options) + finder = self._build_package_finder( + options=options, + session=session, + target_python=target_python, + ignore_requires_python=options.ignore_requires_python, + ) + + build_tracker = self.enter_context(get_build_tracker()) + + directory = TempDirectory( + delete=not options.no_clean, + kind="download", + globally_managed=True, + ) + + reqs = self.get_requirements(args, options, finder, session) + check_legacy_setup_py_options(options, reqs) + + preparer = self.make_requirement_preparer( + temp_build_dir=directory, + options=options, + build_tracker=build_tracker, + session=session, + finder=finder, + download_dir=options.download_dir, + use_user_site=False, + verbosity=self.verbosity, + ) + + resolver = self.make_resolver( + preparer=preparer, + finder=finder, + options=options, + ignore_requires_python=options.ignore_requires_python, + use_pep517=options.use_pep517, + py_version_info=options.python_version, + ) + + self.trace_basic_info(finder) + + requirement_set = resolver.resolve(reqs, check_supported_wheels=True) + + downloaded: List[str] = [] + for req in requirement_set.requirements.values(): + if req.satisfied_by is None: + assert req.name is not None + preparer.save_linked_requirement(req) + downloaded.append(req.name) + + preparer.prepare_linked_requirements_more(requirement_set.requirements.values()) + + if downloaded: + write_output("Successfully downloaded %s", " ".join(downloaded)) + + return SUCCESS diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/commands/freeze.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/commands/freeze.py new file mode 100644 index 0000000..885fdfe --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/commands/freeze.py @@ -0,0 +1,109 @@ +import sys +from optparse import Values +from typing import AbstractSet, List + +from pip._internal.cli import cmdoptions +from pip._internal.cli.base_command import Command +from pip._internal.cli.status_codes import SUCCESS +from pip._internal.operations.freeze import freeze +from pip._internal.utils.compat import stdlib_pkgs + + +def _should_suppress_build_backends() -> bool: + return sys.version_info < (3, 12) + + +def _dev_pkgs() -> AbstractSet[str]: + pkgs = {"pip"} + + if _should_suppress_build_backends(): + pkgs |= {"setuptools", "distribute", "wheel"} + + return pkgs + + +class FreezeCommand(Command): + """ + Output installed packages in requirements format. + + packages are listed in a case-insensitive sorted order. + """ + + ignore_require_venv = True + usage = """ + %prog [options]""" + log_streams = ("ext://sys.stderr", "ext://sys.stderr") + + def add_options(self) -> None: + self.cmd_opts.add_option( + "-r", + "--requirement", + dest="requirements", + action="append", + default=[], + metavar="file", + help=( + "Use the order in the given requirements file and its " + "comments when generating output. This option can be " + "used multiple times." + ), + ) + self.cmd_opts.add_option( + "-l", + "--local", + dest="local", + action="store_true", + default=False, + help=( + "If in a virtualenv that has global access, do not output " + "globally-installed packages." + ), + ) + self.cmd_opts.add_option( + "--user", + dest="user", + action="store_true", + default=False, + help="Only output packages installed in user-site.", + ) + self.cmd_opts.add_option(cmdoptions.list_path()) + self.cmd_opts.add_option( + "--all", + dest="freeze_all", + action="store_true", + help=( + "Do not skip these packages in the output:" + " {}".format(", ".join(_dev_pkgs())) + ), + ) + self.cmd_opts.add_option( + "--exclude-editable", + dest="exclude_editable", + action="store_true", + help="Exclude editable package from output.", + ) + self.cmd_opts.add_option(cmdoptions.list_exclude()) + + self.parser.insert_option_group(0, self.cmd_opts) + + def run(self, options: Values, args: List[str]) -> int: + skip = set(stdlib_pkgs) + if not options.freeze_all: + skip.update(_dev_pkgs()) + + if options.excludes: + skip.update(options.excludes) + + cmdoptions.check_list_path_option(options) + + for line in freeze( + requirement=options.requirements, + local_only=options.local, + user_only=options.user, + paths=options.path, + isolated=options.isolated_mode, + skip=skip, + exclude_editable=options.exclude_editable, + ): + sys.stdout.write(line + "\n") + return SUCCESS diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/commands/hash.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/commands/hash.py new file mode 100644 index 0000000..042dac8 --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/commands/hash.py @@ -0,0 +1,59 @@ +import hashlib +import logging +import sys +from optparse import Values +from typing import List + +from pip._internal.cli.base_command import Command +from pip._internal.cli.status_codes import ERROR, SUCCESS +from pip._internal.utils.hashes import FAVORITE_HASH, STRONG_HASHES +from pip._internal.utils.misc import read_chunks, write_output + +logger = logging.getLogger(__name__) + + +class HashCommand(Command): + """ + Compute a hash of a local package archive. + + These can be used with --hash in a requirements file to do repeatable + installs. + """ + + usage = "%prog [options] ..." + ignore_require_venv = True + + def add_options(self) -> None: + self.cmd_opts.add_option( + "-a", + "--algorithm", + dest="algorithm", + choices=STRONG_HASHES, + action="store", + default=FAVORITE_HASH, + help="The hash algorithm to use: one of {}".format( + ", ".join(STRONG_HASHES) + ), + ) + self.parser.insert_option_group(0, self.cmd_opts) + + def run(self, options: Values, args: List[str]) -> int: + if not args: + self.parser.print_usage(sys.stderr) + return ERROR + + algorithm = options.algorithm + for path in args: + write_output( + "%s:\n--hash=%s:%s", path, algorithm, _hash_of_file(path, algorithm) + ) + return SUCCESS + + +def _hash_of_file(path: str, algorithm: str) -> str: + """Return the hash digest of a file.""" + with open(path, "rb") as archive: + hash = hashlib.new(algorithm) + for chunk in read_chunks(archive): + hash.update(chunk) + return hash.hexdigest() diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/commands/help.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/commands/help.py new file mode 100644 index 0000000..6206631 --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/commands/help.py @@ -0,0 +1,41 @@ +from optparse import Values +from typing import List + +from pip._internal.cli.base_command import Command +from pip._internal.cli.status_codes import SUCCESS +from pip._internal.exceptions import CommandError + + +class HelpCommand(Command): + """Show help for commands""" + + usage = """ + %prog """ + ignore_require_venv = True + + def run(self, options: Values, args: List[str]) -> int: + from pip._internal.commands import ( + commands_dict, + create_command, + get_similar_commands, + ) + + try: + # 'pip help' with no args is handled by pip.__init__.parseopt() + cmd_name = args[0] # the command we need help for + except IndexError: + return SUCCESS + + if cmd_name not in commands_dict: + guess = get_similar_commands(cmd_name) + + msg = [f'unknown command "{cmd_name}"'] + if guess: + msg.append(f'maybe you meant "{guess}"') + + raise CommandError(" - ".join(msg)) + + command = create_command(cmd_name) + command.parser.print_help() + + return SUCCESS diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/commands/index.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/commands/index.py new file mode 100644 index 0000000..2e2661b --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/commands/index.py @@ -0,0 +1,139 @@ +import logging +from optparse import Values +from typing import Any, Iterable, List, Optional + +from pip._vendor.packaging.version import Version + +from pip._internal.cli import cmdoptions +from pip._internal.cli.req_command import IndexGroupCommand +from pip._internal.cli.status_codes import ERROR, SUCCESS +from pip._internal.commands.search import print_dist_installation_info +from pip._internal.exceptions import CommandError, DistributionNotFound, PipError +from pip._internal.index.collector import LinkCollector +from pip._internal.index.package_finder import PackageFinder +from pip._internal.models.selection_prefs import SelectionPreferences +from pip._internal.models.target_python import TargetPython +from pip._internal.network.session import PipSession +from pip._internal.utils.misc import write_output + +logger = logging.getLogger(__name__) + + +class IndexCommand(IndexGroupCommand): + """ + Inspect information available from package indexes. + """ + + ignore_require_venv = True + usage = """ + %prog versions + """ + + def add_options(self) -> None: + cmdoptions.add_target_python_options(self.cmd_opts) + + self.cmd_opts.add_option(cmdoptions.ignore_requires_python()) + self.cmd_opts.add_option(cmdoptions.pre()) + self.cmd_opts.add_option(cmdoptions.no_binary()) + self.cmd_opts.add_option(cmdoptions.only_binary()) + + index_opts = cmdoptions.make_option_group( + cmdoptions.index_group, + self.parser, + ) + + self.parser.insert_option_group(0, index_opts) + self.parser.insert_option_group(0, self.cmd_opts) + + def run(self, options: Values, args: List[str]) -> int: + handlers = { + "versions": self.get_available_package_versions, + } + + logger.warning( + "pip index is currently an experimental command. " + "It may be removed/changed in a future release " + "without prior warning." + ) + + # Determine action + if not args or args[0] not in handlers: + logger.error( + "Need an action (%s) to perform.", + ", ".join(sorted(handlers)), + ) + return ERROR + + action = args[0] + + # Error handling happens here, not in the action-handlers. + try: + handlers[action](options, args[1:]) + except PipError as e: + logger.error(e.args[0]) + return ERROR + + return SUCCESS + + def _build_package_finder( + self, + options: Values, + session: PipSession, + target_python: Optional[TargetPython] = None, + ignore_requires_python: Optional[bool] = None, + ) -> PackageFinder: + """ + Create a package finder appropriate to the index command. + """ + link_collector = LinkCollector.create(session, options=options) + + # Pass allow_yanked=False to ignore yanked versions. + selection_prefs = SelectionPreferences( + allow_yanked=False, + allow_all_prereleases=options.pre, + ignore_requires_python=ignore_requires_python, + ) + + return PackageFinder.create( + link_collector=link_collector, + selection_prefs=selection_prefs, + target_python=target_python, + ) + + def get_available_package_versions(self, options: Values, args: List[Any]) -> None: + if len(args) != 1: + raise CommandError("You need to specify exactly one argument") + + target_python = cmdoptions.make_target_python(options) + query = args[0] + + with self._build_session(options) as session: + finder = self._build_package_finder( + options=options, + session=session, + target_python=target_python, + ignore_requires_python=options.ignore_requires_python, + ) + + versions: Iterable[Version] = ( + candidate.version for candidate in finder.find_all_candidates(query) + ) + + if not options.pre: + # Remove prereleases + versions = ( + version for version in versions if not version.is_prerelease + ) + versions = set(versions) + + if not versions: + raise DistributionNotFound( + f"No matching distribution found for {query}" + ) + + formatted_versions = [str(ver) for ver in sorted(versions, reverse=True)] + latest = formatted_versions[0] + + write_output(f"{query} ({latest})") + write_output("Available versions: {}".format(", ".join(formatted_versions))) + print_dist_installation_info(query, latest) diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/commands/inspect.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/commands/inspect.py new file mode 100644 index 0000000..e810c13 --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/commands/inspect.py @@ -0,0 +1,92 @@ +import logging +from optparse import Values +from typing import Any, Dict, List + +from pip._vendor.packaging.markers import default_environment +from pip._vendor.rich import print_json + +from pip import __version__ +from pip._internal.cli import cmdoptions +from pip._internal.cli.base_command import Command +from pip._internal.cli.status_codes import SUCCESS +from pip._internal.metadata import BaseDistribution, get_environment +from pip._internal.utils.compat import stdlib_pkgs +from pip._internal.utils.urls import path_to_url + +logger = logging.getLogger(__name__) + + +class InspectCommand(Command): + """ + Inspect the content of a Python environment and produce a report in JSON format. + """ + + ignore_require_venv = True + usage = """ + %prog [options]""" + + def add_options(self) -> None: + self.cmd_opts.add_option( + "--local", + action="store_true", + default=False, + help=( + "If in a virtualenv that has global access, do not list " + "globally-installed packages." + ), + ) + self.cmd_opts.add_option( + "--user", + dest="user", + action="store_true", + default=False, + help="Only output packages installed in user-site.", + ) + self.cmd_opts.add_option(cmdoptions.list_path()) + self.parser.insert_option_group(0, self.cmd_opts) + + def run(self, options: Values, args: List[str]) -> int: + cmdoptions.check_list_path_option(options) + dists = get_environment(options.path).iter_installed_distributions( + local_only=options.local, + user_only=options.user, + skip=set(stdlib_pkgs), + ) + output = { + "version": "1", + "pip_version": __version__, + "installed": [self._dist_to_dict(dist) for dist in dists], + "environment": default_environment(), + # TODO tags? scheme? + } + print_json(data=output) + return SUCCESS + + def _dist_to_dict(self, dist: BaseDistribution) -> Dict[str, Any]: + res: Dict[str, Any] = { + "metadata": dist.metadata_dict, + "metadata_location": dist.info_location, + } + # direct_url. Note that we don't have download_info (as in the installation + # report) since it is not recorded in installed metadata. + direct_url = dist.direct_url + if direct_url is not None: + res["direct_url"] = direct_url.to_dict() + else: + # Emulate direct_url for legacy editable installs. + editable_project_location = dist.editable_project_location + if editable_project_location is not None: + res["direct_url"] = { + "url": path_to_url(editable_project_location), + "dir_info": { + "editable": True, + }, + } + # installer + installer = dist.installer + if dist.installer: + res["installer"] = installer + # requested + if dist.installed_with_dist_info: + res["requested"] = dist.requested + return res diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/commands/install.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/commands/install.py new file mode 100644 index 0000000..232a34a --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/commands/install.py @@ -0,0 +1,784 @@ +import errno +import json +import operator +import os +import shutil +import site +from optparse import SUPPRESS_HELP, Values +from typing import List, Optional + +from pip._vendor.packaging.utils import canonicalize_name +from pip._vendor.rich import print_json + +# Eagerly import self_outdated_check to avoid crashes. Otherwise, +# this module would be imported *after* pip was replaced, resulting +# in crashes if the new self_outdated_check module was incompatible +# with the rest of pip that's already imported, or allowing a +# wheel to execute arbitrary code on install by replacing +# self_outdated_check. +import pip._internal.self_outdated_check # noqa: F401 +from pip._internal.cache import WheelCache +from pip._internal.cli import cmdoptions +from pip._internal.cli.cmdoptions import make_target_python +from pip._internal.cli.req_command import ( + RequirementCommand, + with_cleanup, +) +from pip._internal.cli.status_codes import ERROR, SUCCESS +from pip._internal.exceptions import CommandError, InstallationError +from pip._internal.locations import get_scheme +from pip._internal.metadata import get_environment +from pip._internal.models.installation_report import InstallationReport +from pip._internal.operations.build.build_tracker import get_build_tracker +from pip._internal.operations.check import ConflictDetails, check_install_conflicts +from pip._internal.req import install_given_reqs +from pip._internal.req.req_install import ( + InstallRequirement, + check_legacy_setup_py_options, +) +from pip._internal.utils.compat import WINDOWS +from pip._internal.utils.filesystem import test_writable_dir +from pip._internal.utils.logging import getLogger +from pip._internal.utils.misc import ( + check_externally_managed, + ensure_dir, + get_pip_version, + protect_pip_from_modification_on_windows, + warn_if_run_as_root, + write_output, +) +from pip._internal.utils.temp_dir import TempDirectory +from pip._internal.utils.virtualenv import ( + running_under_virtualenv, + virtualenv_no_global, +) +from pip._internal.wheel_builder import build, should_build_for_install_command + +logger = getLogger(__name__) + + +class InstallCommand(RequirementCommand): + """ + Install packages from: + + - PyPI (and other indexes) using requirement specifiers. + - VCS project urls. + - Local project directories. + - Local or remote source archives. + + pip also supports installing from "requirements files", which provide + an easy way to specify a whole environment to be installed. + """ + + usage = """ + %prog [options] [package-index-options] ... + %prog [options] -r [package-index-options] ... + %prog [options] [-e] ... + %prog [options] [-e] ... + %prog [options] ...""" + + def add_options(self) -> None: + self.cmd_opts.add_option(cmdoptions.requirements()) + self.cmd_opts.add_option(cmdoptions.constraints()) + self.cmd_opts.add_option(cmdoptions.no_deps()) + self.cmd_opts.add_option(cmdoptions.pre()) + + self.cmd_opts.add_option(cmdoptions.editable()) + self.cmd_opts.add_option( + "--dry-run", + action="store_true", + dest="dry_run", + default=False, + help=( + "Don't actually install anything, just print what would be. " + "Can be used in combination with --ignore-installed " + "to 'resolve' the requirements." + ), + ) + self.cmd_opts.add_option( + "-t", + "--target", + dest="target_dir", + metavar="dir", + default=None, + help=( + "Install packages into . " + "By default this will not replace existing files/folders in " + ". Use --upgrade to replace existing packages in " + "with new versions." + ), + ) + cmdoptions.add_target_python_options(self.cmd_opts) + + self.cmd_opts.add_option( + "--user", + dest="use_user_site", + action="store_true", + help=( + "Install to the Python user install directory for your " + "platform. Typically ~/.local/, or %APPDATA%\\Python on " + "Windows. (See the Python documentation for site.USER_BASE " + "for full details.)" + ), + ) + self.cmd_opts.add_option( + "--no-user", + dest="use_user_site", + action="store_false", + help=SUPPRESS_HELP, + ) + self.cmd_opts.add_option( + "--root", + dest="root_path", + metavar="dir", + default=None, + help="Install everything relative to this alternate root directory.", + ) + self.cmd_opts.add_option( + "--prefix", + dest="prefix_path", + metavar="dir", + default=None, + help=( + "Installation prefix where lib, bin and other top-level " + "folders are placed. Note that the resulting installation may " + "contain scripts and other resources which reference the " + "Python interpreter of pip, and not that of ``--prefix``. " + "See also the ``--python`` option if the intention is to " + "install packages into another (possibly pip-free) " + "environment." + ), + ) + + self.cmd_opts.add_option(cmdoptions.src()) + + self.cmd_opts.add_option( + "-U", + "--upgrade", + dest="upgrade", + action="store_true", + help=( + "Upgrade all specified packages to the newest available " + "version. The handling of dependencies depends on the " + "upgrade-strategy used." + ), + ) + + self.cmd_opts.add_option( + "--upgrade-strategy", + dest="upgrade_strategy", + default="only-if-needed", + choices=["only-if-needed", "eager"], + help=( + "Determines how dependency upgrading should be handled " + "[default: %default]. " + '"eager" - dependencies are upgraded regardless of ' + "whether the currently installed version satisfies the " + "requirements of the upgraded package(s). " + '"only-if-needed" - are upgraded only when they do not ' + "satisfy the requirements of the upgraded package(s)." + ), + ) + + self.cmd_opts.add_option( + "--force-reinstall", + dest="force_reinstall", + action="store_true", + help="Reinstall all packages even if they are already up-to-date.", + ) + + self.cmd_opts.add_option( + "-I", + "--ignore-installed", + dest="ignore_installed", + action="store_true", + help=( + "Ignore the installed packages, overwriting them. " + "This can break your system if the existing package " + "is of a different version or was installed " + "with a different package manager!" + ), + ) + + self.cmd_opts.add_option(cmdoptions.ignore_requires_python()) + self.cmd_opts.add_option(cmdoptions.no_build_isolation()) + self.cmd_opts.add_option(cmdoptions.use_pep517()) + self.cmd_opts.add_option(cmdoptions.no_use_pep517()) + self.cmd_opts.add_option(cmdoptions.check_build_deps()) + self.cmd_opts.add_option(cmdoptions.override_externally_managed()) + + self.cmd_opts.add_option(cmdoptions.config_settings()) + self.cmd_opts.add_option(cmdoptions.global_options()) + + self.cmd_opts.add_option( + "--compile", + action="store_true", + dest="compile", + default=True, + help="Compile Python source files to bytecode", + ) + + self.cmd_opts.add_option( + "--no-compile", + action="store_false", + dest="compile", + help="Do not compile Python source files to bytecode", + ) + + self.cmd_opts.add_option( + "--no-warn-script-location", + action="store_false", + dest="warn_script_location", + default=True, + help="Do not warn when installing scripts outside PATH", + ) + self.cmd_opts.add_option( + "--no-warn-conflicts", + action="store_false", + dest="warn_about_conflicts", + default=True, + help="Do not warn about broken dependencies", + ) + self.cmd_opts.add_option(cmdoptions.no_binary()) + self.cmd_opts.add_option(cmdoptions.only_binary()) + self.cmd_opts.add_option(cmdoptions.prefer_binary()) + self.cmd_opts.add_option(cmdoptions.require_hashes()) + self.cmd_opts.add_option(cmdoptions.progress_bar()) + self.cmd_opts.add_option(cmdoptions.root_user_action()) + + index_opts = cmdoptions.make_option_group( + cmdoptions.index_group, + self.parser, + ) + + self.parser.insert_option_group(0, index_opts) + self.parser.insert_option_group(0, self.cmd_opts) + + self.cmd_opts.add_option( + "--report", + dest="json_report_file", + metavar="file", + default=None, + help=( + "Generate a JSON file describing what pip did to install " + "the provided requirements. " + "Can be used in combination with --dry-run and --ignore-installed " + "to 'resolve' the requirements. " + "When - is used as file name it writes to stdout. " + "When writing to stdout, please combine with the --quiet option " + "to avoid mixing pip logging output with JSON output." + ), + ) + + @with_cleanup + def run(self, options: Values, args: List[str]) -> int: + if options.use_user_site and options.target_dir is not None: + raise CommandError("Can not combine '--user' and '--target'") + + # Check whether the environment we're installing into is externally + # managed, as specified in PEP 668. Specifying --root, --target, or + # --prefix disables the check, since there's no reliable way to locate + # the EXTERNALLY-MANAGED file for those cases. An exception is also + # made specifically for "--dry-run --report" for convenience. + installing_into_current_environment = ( + not (options.dry_run and options.json_report_file) + and options.root_path is None + and options.target_dir is None + and options.prefix_path is None + ) + if ( + installing_into_current_environment + and not options.override_externally_managed + ): + check_externally_managed() + + upgrade_strategy = "to-satisfy-only" + if options.upgrade: + upgrade_strategy = options.upgrade_strategy + + cmdoptions.check_dist_restriction(options, check_target=True) + + logger.verbose("Using %s", get_pip_version()) + options.use_user_site = decide_user_install( + options.use_user_site, + prefix_path=options.prefix_path, + target_dir=options.target_dir, + root_path=options.root_path, + isolated_mode=options.isolated_mode, + ) + + target_temp_dir: Optional[TempDirectory] = None + target_temp_dir_path: Optional[str] = None + if options.target_dir: + options.ignore_installed = True + options.target_dir = os.path.abspath(options.target_dir) + if ( + # fmt: off + os.path.exists(options.target_dir) and + not os.path.isdir(options.target_dir) + # fmt: on + ): + raise CommandError( + "Target path exists but is not a directory, will not continue." + ) + + # Create a target directory for using with the target option + target_temp_dir = TempDirectory(kind="target") + target_temp_dir_path = target_temp_dir.path + self.enter_context(target_temp_dir) + + global_options = options.global_options or [] + + session = self.get_default_session(options) + + target_python = make_target_python(options) + finder = self._build_package_finder( + options=options, + session=session, + target_python=target_python, + ignore_requires_python=options.ignore_requires_python, + ) + build_tracker = self.enter_context(get_build_tracker()) + + directory = TempDirectory( + delete=not options.no_clean, + kind="install", + globally_managed=True, + ) + + try: + reqs = self.get_requirements(args, options, finder, session) + check_legacy_setup_py_options(options, reqs) + + wheel_cache = WheelCache(options.cache_dir) + + # Only when installing is it permitted to use PEP 660. + # In other circumstances (pip wheel, pip download) we generate + # regular (i.e. non editable) metadata and wheels. + for req in reqs: + req.permit_editable_wheels = True + + preparer = self.make_requirement_preparer( + temp_build_dir=directory, + options=options, + build_tracker=build_tracker, + session=session, + finder=finder, + use_user_site=options.use_user_site, + verbosity=self.verbosity, + ) + resolver = self.make_resolver( + preparer=preparer, + finder=finder, + options=options, + wheel_cache=wheel_cache, + use_user_site=options.use_user_site, + ignore_installed=options.ignore_installed, + ignore_requires_python=options.ignore_requires_python, + force_reinstall=options.force_reinstall, + upgrade_strategy=upgrade_strategy, + use_pep517=options.use_pep517, + py_version_info=options.python_version, + ) + + self.trace_basic_info(finder) + + requirement_set = resolver.resolve( + reqs, check_supported_wheels=not options.target_dir + ) + + if options.json_report_file: + report = InstallationReport(requirement_set.requirements_to_install) + if options.json_report_file == "-": + print_json(data=report.to_dict()) + else: + with open(options.json_report_file, "w", encoding="utf-8") as f: + json.dump(report.to_dict(), f, indent=2, ensure_ascii=False) + + if options.dry_run: + would_install_items = sorted( + (r.metadata["name"], r.metadata["version"]) + for r in requirement_set.requirements_to_install + ) + if would_install_items: + write_output( + "Would install %s", + " ".join("-".join(item) for item in would_install_items), + ) + return SUCCESS + + try: + pip_req = requirement_set.get_requirement("pip") + except KeyError: + modifying_pip = False + else: + # If we're not replacing an already installed pip, + # we're not modifying it. + modifying_pip = pip_req.satisfied_by is None + protect_pip_from_modification_on_windows(modifying_pip=modifying_pip) + + reqs_to_build = [ + r + for r in requirement_set.requirements.values() + if should_build_for_install_command(r) + ] + + _, build_failures = build( + reqs_to_build, + wheel_cache=wheel_cache, + verify=True, + build_options=[], + global_options=global_options, + ) + + if build_failures: + raise InstallationError( + "Failed to build installable wheels for some " + "pyproject.toml based projects ({})".format( + ", ".join(r.name for r in build_failures) # type: ignore + ) + ) + + to_install = resolver.get_installation_order(requirement_set) + + # Check for conflicts in the package set we're installing. + conflicts: Optional[ConflictDetails] = None + should_warn_about_conflicts = ( + not options.ignore_dependencies and options.warn_about_conflicts + ) + if should_warn_about_conflicts: + conflicts = self._determine_conflicts(to_install) + + # Don't warn about script install locations if + # --target or --prefix has been specified + warn_script_location = options.warn_script_location + if options.target_dir or options.prefix_path: + warn_script_location = False + + installed = install_given_reqs( + to_install, + global_options, + root=options.root_path, + home=target_temp_dir_path, + prefix=options.prefix_path, + warn_script_location=warn_script_location, + use_user_site=options.use_user_site, + pycompile=options.compile, + ) + + lib_locations = get_lib_location_guesses( + user=options.use_user_site, + home=target_temp_dir_path, + root=options.root_path, + prefix=options.prefix_path, + isolated=options.isolated_mode, + ) + env = get_environment(lib_locations) + + # Display a summary of installed packages, with extra care to + # display a package name as it was requested by the user. + installed.sort(key=operator.attrgetter("name")) + summary = [] + installed_versions = {} + for distribution in env.iter_all_distributions(): + installed_versions[distribution.canonical_name] = distribution.version + for package in installed: + display_name = package.name + version = installed_versions.get(canonicalize_name(display_name), None) + if version: + text = f"{display_name}-{version}" + else: + text = display_name + summary.append(text) + + if conflicts is not None: + self._warn_about_conflicts( + conflicts, + resolver_variant=self.determine_resolver_variant(options), + ) + + installed_desc = " ".join(summary) + if installed_desc: + write_output( + "Successfully installed %s", + installed_desc, + ) + except OSError as error: + show_traceback = self.verbosity >= 1 + + message = create_os_error_message( + error, + show_traceback, + options.use_user_site, + ) + logger.error(message, exc_info=show_traceback) + + return ERROR + + if options.target_dir: + assert target_temp_dir + self._handle_target_dir( + options.target_dir, target_temp_dir, options.upgrade + ) + if options.root_user_action == "warn": + warn_if_run_as_root() + return SUCCESS + + def _handle_target_dir( + self, target_dir: str, target_temp_dir: TempDirectory, upgrade: bool + ) -> None: + ensure_dir(target_dir) + + # Checking both purelib and platlib directories for installed + # packages to be moved to target directory + lib_dir_list = [] + + # Checking both purelib and platlib directories for installed + # packages to be moved to target directory + scheme = get_scheme("", home=target_temp_dir.path) + purelib_dir = scheme.purelib + platlib_dir = scheme.platlib + data_dir = scheme.data + + if os.path.exists(purelib_dir): + lib_dir_list.append(purelib_dir) + if os.path.exists(platlib_dir) and platlib_dir != purelib_dir: + lib_dir_list.append(platlib_dir) + if os.path.exists(data_dir): + lib_dir_list.append(data_dir) + + for lib_dir in lib_dir_list: + for item in os.listdir(lib_dir): + if lib_dir == data_dir: + ddir = os.path.join(data_dir, item) + if any(s.startswith(ddir) for s in lib_dir_list[:-1]): + continue + target_item_dir = os.path.join(target_dir, item) + if os.path.exists(target_item_dir): + if not upgrade: + logger.warning( + "Target directory %s already exists. Specify " + "--upgrade to force replacement.", + target_item_dir, + ) + continue + if os.path.islink(target_item_dir): + logger.warning( + "Target directory %s already exists and is " + "a link. pip will not automatically replace " + "links, please remove if replacement is " + "desired.", + target_item_dir, + ) + continue + if os.path.isdir(target_item_dir): + shutil.rmtree(target_item_dir) + else: + os.remove(target_item_dir) + + shutil.move(os.path.join(lib_dir, item), target_item_dir) + + def _determine_conflicts( + self, to_install: List[InstallRequirement] + ) -> Optional[ConflictDetails]: + try: + return check_install_conflicts(to_install) + except Exception: + logger.exception( + "Error while checking for conflicts. Please file an issue on " + "pip's issue tracker: https://github.com/pypa/pip/issues/new" + ) + return None + + def _warn_about_conflicts( + self, conflict_details: ConflictDetails, resolver_variant: str + ) -> None: + package_set, (missing, conflicting) = conflict_details + if not missing and not conflicting: + return + + parts: List[str] = [] + if resolver_variant == "legacy": + parts.append( + "pip's legacy dependency resolver does not consider dependency " + "conflicts when selecting packages. This behaviour is the " + "source of the following dependency conflicts." + ) + else: + assert resolver_variant == "resolvelib" + parts.append( + "pip's dependency resolver does not currently take into account " + "all the packages that are installed. This behaviour is the " + "source of the following dependency conflicts." + ) + + # NOTE: There is some duplication here, with commands/check.py + for project_name in missing: + version = package_set[project_name][0] + for dependency in missing[project_name]: + message = ( + f"{project_name} {version} requires {dependency[1]}, " + "which is not installed." + ) + parts.append(message) + + for project_name in conflicting: + version = package_set[project_name][0] + for dep_name, dep_version, req in conflicting[project_name]: + message = ( + "{name} {version} requires {requirement}, but {you} have " + "{dep_name} {dep_version} which is incompatible." + ).format( + name=project_name, + version=version, + requirement=req, + dep_name=dep_name, + dep_version=dep_version, + you=("you" if resolver_variant == "resolvelib" else "you'll"), + ) + parts.append(message) + + logger.critical("\n".join(parts)) + + +def get_lib_location_guesses( + user: bool = False, + home: Optional[str] = None, + root: Optional[str] = None, + isolated: bool = False, + prefix: Optional[str] = None, +) -> List[str]: + scheme = get_scheme( + "", + user=user, + home=home, + root=root, + isolated=isolated, + prefix=prefix, + ) + return [scheme.purelib, scheme.platlib] + + +def site_packages_writable(root: Optional[str], isolated: bool) -> bool: + return all( + test_writable_dir(d) + for d in set(get_lib_location_guesses(root=root, isolated=isolated)) + ) + + +def decide_user_install( + use_user_site: Optional[bool], + prefix_path: Optional[str] = None, + target_dir: Optional[str] = None, + root_path: Optional[str] = None, + isolated_mode: bool = False, +) -> bool: + """Determine whether to do a user install based on the input options. + + If use_user_site is False, no additional checks are done. + If use_user_site is True, it is checked for compatibility with other + options. + If use_user_site is None, the default behaviour depends on the environment, + which is provided by the other arguments. + """ + # In some cases (config from tox), use_user_site can be set to an integer + # rather than a bool, which 'use_user_site is False' wouldn't catch. + if (use_user_site is not None) and (not use_user_site): + logger.debug("Non-user install by explicit request") + return False + + if use_user_site: + if prefix_path: + raise CommandError( + "Can not combine '--user' and '--prefix' as they imply " + "different installation locations" + ) + if virtualenv_no_global(): + raise InstallationError( + "Can not perform a '--user' install. User site-packages " + "are not visible in this virtualenv." + ) + logger.debug("User install by explicit request") + return True + + # If we are here, user installs have not been explicitly requested/avoided + assert use_user_site is None + + # user install incompatible with --prefix/--target + if prefix_path or target_dir: + logger.debug("Non-user install due to --prefix or --target option") + return False + + # If user installs are not enabled, choose a non-user install + if not site.ENABLE_USER_SITE: + logger.debug("Non-user install because user site-packages disabled") + return False + + # If we have permission for a non-user install, do that, + # otherwise do a user install. + if site_packages_writable(root=root_path, isolated=isolated_mode): + logger.debug("Non-user install because site-packages writeable") + return False + + logger.info( + "Defaulting to user installation because normal site-packages " + "is not writeable" + ) + return True + + +def create_os_error_message( + error: OSError, show_traceback: bool, using_user_site: bool +) -> str: + """Format an error message for an OSError + + It may occur anytime during the execution of the install command. + """ + parts = [] + + # Mention the error if we are not going to show a traceback + parts.append("Could not install packages due to an OSError") + if not show_traceback: + parts.append(": ") + parts.append(str(error)) + else: + parts.append(".") + + # Spilt the error indication from a helper message (if any) + parts[-1] += "\n" + + # Suggest useful actions to the user: + # (1) using user site-packages or (2) verifying the permissions + if error.errno == errno.EACCES: + user_option_part = "Consider using the `--user` option" + permissions_part = "Check the permissions" + + if not running_under_virtualenv() and not using_user_site: + parts.extend( + [ + user_option_part, + " or ", + permissions_part.lower(), + ] + ) + else: + parts.append(permissions_part) + parts.append(".\n") + + # Suggest the user to enable Long Paths if path length is + # more than 260 + if ( + WINDOWS + and error.errno == errno.ENOENT + and error.filename + and len(error.filename) > 260 + ): + parts.append( + "HINT: This error might have occurred since " + "this system does not have Windows Long Path " + "support enabled. You can find information on " + "how to enable this at " + "https://pip.pypa.io/warnings/enable-long-paths\n" + ) + + return "".join(parts).strip() + "\n" diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/commands/list.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/commands/list.py new file mode 100644 index 0000000..8494370 --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/commands/list.py @@ -0,0 +1,375 @@ +import json +import logging +from optparse import Values +from typing import TYPE_CHECKING, Generator, List, Optional, Sequence, Tuple, cast + +from pip._vendor.packaging.utils import canonicalize_name +from pip._vendor.packaging.version import Version + +from pip._internal.cli import cmdoptions +from pip._internal.cli.index_command import IndexGroupCommand +from pip._internal.cli.status_codes import SUCCESS +from pip._internal.exceptions import CommandError +from pip._internal.metadata import BaseDistribution, get_environment +from pip._internal.models.selection_prefs import SelectionPreferences +from pip._internal.utils.compat import stdlib_pkgs +from pip._internal.utils.misc import tabulate, write_output + +if TYPE_CHECKING: + from pip._internal.index.package_finder import PackageFinder + from pip._internal.network.session import PipSession + + class _DistWithLatestInfo(BaseDistribution): + """Give the distribution object a couple of extra fields. + + These will be populated during ``get_outdated()``. This is dirty but + makes the rest of the code much cleaner. + """ + + latest_version: Version + latest_filetype: str + + _ProcessedDists = Sequence[_DistWithLatestInfo] + + +logger = logging.getLogger(__name__) + + +class ListCommand(IndexGroupCommand): + """ + List installed packages, including editables. + + Packages are listed in a case-insensitive sorted order. + """ + + ignore_require_venv = True + usage = """ + %prog [options]""" + + def add_options(self) -> None: + self.cmd_opts.add_option( + "-o", + "--outdated", + action="store_true", + default=False, + help="List outdated packages", + ) + self.cmd_opts.add_option( + "-u", + "--uptodate", + action="store_true", + default=False, + help="List uptodate packages", + ) + self.cmd_opts.add_option( + "-e", + "--editable", + action="store_true", + default=False, + help="List editable projects.", + ) + self.cmd_opts.add_option( + "-l", + "--local", + action="store_true", + default=False, + help=( + "If in a virtualenv that has global access, do not list " + "globally-installed packages." + ), + ) + self.cmd_opts.add_option( + "--user", + dest="user", + action="store_true", + default=False, + help="Only output packages installed in user-site.", + ) + self.cmd_opts.add_option(cmdoptions.list_path()) + self.cmd_opts.add_option( + "--pre", + action="store_true", + default=False, + help=( + "Include pre-release and development versions. By default, " + "pip only finds stable versions." + ), + ) + + self.cmd_opts.add_option( + "--format", + action="store", + dest="list_format", + default="columns", + choices=("columns", "freeze", "json"), + help=( + "Select the output format among: columns (default), freeze, or json. " + "The 'freeze' format cannot be used with the --outdated option." + ), + ) + + self.cmd_opts.add_option( + "--not-required", + action="store_true", + dest="not_required", + help="List packages that are not dependencies of installed packages.", + ) + + self.cmd_opts.add_option( + "--exclude-editable", + action="store_false", + dest="include_editable", + help="Exclude editable package from output.", + ) + self.cmd_opts.add_option( + "--include-editable", + action="store_true", + dest="include_editable", + help="Include editable package from output.", + default=True, + ) + self.cmd_opts.add_option(cmdoptions.list_exclude()) + index_opts = cmdoptions.make_option_group(cmdoptions.index_group, self.parser) + + self.parser.insert_option_group(0, index_opts) + self.parser.insert_option_group(0, self.cmd_opts) + + def handle_pip_version_check(self, options: Values) -> None: + if options.outdated or options.uptodate: + super().handle_pip_version_check(options) + + def _build_package_finder( + self, options: Values, session: "PipSession" + ) -> "PackageFinder": + """ + Create a package finder appropriate to this list command. + """ + # Lazy import the heavy index modules as most list invocations won't need 'em. + from pip._internal.index.collector import LinkCollector + from pip._internal.index.package_finder import PackageFinder + + link_collector = LinkCollector.create(session, options=options) + + # Pass allow_yanked=False to ignore yanked versions. + selection_prefs = SelectionPreferences( + allow_yanked=False, + allow_all_prereleases=options.pre, + ) + + return PackageFinder.create( + link_collector=link_collector, + selection_prefs=selection_prefs, + ) + + def run(self, options: Values, args: List[str]) -> int: + if options.outdated and options.uptodate: + raise CommandError("Options --outdated and --uptodate cannot be combined.") + + if options.outdated and options.list_format == "freeze": + raise CommandError( + "List format 'freeze' cannot be used with the --outdated option." + ) + + cmdoptions.check_list_path_option(options) + + skip = set(stdlib_pkgs) + if options.excludes: + skip.update(canonicalize_name(n) for n in options.excludes) + + packages: _ProcessedDists = [ + cast("_DistWithLatestInfo", d) + for d in get_environment(options.path).iter_installed_distributions( + local_only=options.local, + user_only=options.user, + editables_only=options.editable, + include_editables=options.include_editable, + skip=skip, + ) + ] + + # get_not_required must be called firstly in order to find and + # filter out all dependencies correctly. Otherwise a package + # can't be identified as requirement because some parent packages + # could be filtered out before. + if options.not_required: + packages = self.get_not_required(packages, options) + + if options.outdated: + packages = self.get_outdated(packages, options) + elif options.uptodate: + packages = self.get_uptodate(packages, options) + + self.output_package_listing(packages, options) + return SUCCESS + + def get_outdated( + self, packages: "_ProcessedDists", options: Values + ) -> "_ProcessedDists": + return [ + dist + for dist in self.iter_packages_latest_infos(packages, options) + if dist.latest_version > dist.version + ] + + def get_uptodate( + self, packages: "_ProcessedDists", options: Values + ) -> "_ProcessedDists": + return [ + dist + for dist in self.iter_packages_latest_infos(packages, options) + if dist.latest_version == dist.version + ] + + def get_not_required( + self, packages: "_ProcessedDists", options: Values + ) -> "_ProcessedDists": + dep_keys = { + canonicalize_name(dep.name) + for dist in packages + for dep in (dist.iter_dependencies() or ()) + } + + # Create a set to remove duplicate packages, and cast it to a list + # to keep the return type consistent with get_outdated and + # get_uptodate + return list({pkg for pkg in packages if pkg.canonical_name not in dep_keys}) + + def iter_packages_latest_infos( + self, packages: "_ProcessedDists", options: Values + ) -> Generator["_DistWithLatestInfo", None, None]: + with self._build_session(options) as session: + finder = self._build_package_finder(options, session) + + def latest_info( + dist: "_DistWithLatestInfo", + ) -> Optional["_DistWithLatestInfo"]: + all_candidates = finder.find_all_candidates(dist.canonical_name) + if not options.pre: + # Remove prereleases + all_candidates = [ + candidate + for candidate in all_candidates + if not candidate.version.is_prerelease + ] + + evaluator = finder.make_candidate_evaluator( + project_name=dist.canonical_name, + ) + best_candidate = evaluator.sort_best_candidate(all_candidates) + if best_candidate is None: + return None + + remote_version = best_candidate.version + if best_candidate.link.is_wheel: + typ = "wheel" + else: + typ = "sdist" + dist.latest_version = remote_version + dist.latest_filetype = typ + return dist + + for dist in map(latest_info, packages): + if dist is not None: + yield dist + + def output_package_listing( + self, packages: "_ProcessedDists", options: Values + ) -> None: + packages = sorted( + packages, + key=lambda dist: dist.canonical_name, + ) + if options.list_format == "columns" and packages: + data, header = format_for_columns(packages, options) + self.output_package_listing_columns(data, header) + elif options.list_format == "freeze": + for dist in packages: + if options.verbose >= 1: + write_output( + "%s==%s (%s)", dist.raw_name, dist.version, dist.location + ) + else: + write_output("%s==%s", dist.raw_name, dist.version) + elif options.list_format == "json": + write_output(format_for_json(packages, options)) + + def output_package_listing_columns( + self, data: List[List[str]], header: List[str] + ) -> None: + # insert the header first: we need to know the size of column names + if len(data) > 0: + data.insert(0, header) + + pkg_strings, sizes = tabulate(data) + + # Create and add a separator. + if len(data) > 0: + pkg_strings.insert(1, " ".join("-" * x for x in sizes)) + + for val in pkg_strings: + write_output(val) + + +def format_for_columns( + pkgs: "_ProcessedDists", options: Values +) -> Tuple[List[List[str]], List[str]]: + """ + Convert the package data into something usable + by output_package_listing_columns. + """ + header = ["Package", "Version"] + + running_outdated = options.outdated + if running_outdated: + header.extend(["Latest", "Type"]) + + has_editables = any(x.editable for x in pkgs) + if has_editables: + header.append("Editable project location") + + if options.verbose >= 1: + header.append("Location") + if options.verbose >= 1: + header.append("Installer") + + data = [] + for proj in pkgs: + # if we're working on the 'outdated' list, separate out the + # latest_version and type + row = [proj.raw_name, proj.raw_version] + + if running_outdated: + row.append(str(proj.latest_version)) + row.append(proj.latest_filetype) + + if has_editables: + row.append(proj.editable_project_location or "") + + if options.verbose >= 1: + row.append(proj.location or "") + if options.verbose >= 1: + row.append(proj.installer) + + data.append(row) + + return data, header + + +def format_for_json(packages: "_ProcessedDists", options: Values) -> str: + data = [] + for dist in packages: + info = { + "name": dist.raw_name, + "version": str(dist.version), + } + if options.verbose >= 1: + info["location"] = dist.location or "" + info["installer"] = dist.installer + if options.outdated: + info["latest_version"] = str(dist.latest_version) + info["latest_filetype"] = dist.latest_filetype + editable_project_location = dist.editable_project_location + if editable_project_location: + info["editable_project_location"] = editable_project_location + data.append(info) + return json.dumps(data) diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/commands/search.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/commands/search.py new file mode 100644 index 0000000..74b8d65 --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/commands/search.py @@ -0,0 +1,172 @@ +import logging +import shutil +import sys +import textwrap +import xmlrpc.client +from collections import OrderedDict +from optparse import Values +from typing import TYPE_CHECKING, Dict, List, Optional, TypedDict + +from pip._vendor.packaging.version import parse as parse_version + +from pip._internal.cli.base_command import Command +from pip._internal.cli.req_command import SessionCommandMixin +from pip._internal.cli.status_codes import NO_MATCHES_FOUND, SUCCESS +from pip._internal.exceptions import CommandError +from pip._internal.metadata import get_default_environment +from pip._internal.models.index import PyPI +from pip._internal.network.xmlrpc import PipXmlrpcTransport +from pip._internal.utils.logging import indent_log +from pip._internal.utils.misc import write_output + +if TYPE_CHECKING: + + class TransformedHit(TypedDict): + name: str + summary: str + versions: List[str] + + +logger = logging.getLogger(__name__) + + +class SearchCommand(Command, SessionCommandMixin): + """Search for PyPI packages whose name or summary contains .""" + + usage = """ + %prog [options] """ + ignore_require_venv = True + + def add_options(self) -> None: + self.cmd_opts.add_option( + "-i", + "--index", + dest="index", + metavar="URL", + default=PyPI.pypi_url, + help="Base URL of Python Package Index (default %default)", + ) + + self.parser.insert_option_group(0, self.cmd_opts) + + def run(self, options: Values, args: List[str]) -> int: + if not args: + raise CommandError("Missing required argument (search query).") + query = args + pypi_hits = self.search(query, options) + hits = transform_hits(pypi_hits) + + terminal_width = None + if sys.stdout.isatty(): + terminal_width = shutil.get_terminal_size()[0] + + print_results(hits, terminal_width=terminal_width) + if pypi_hits: + return SUCCESS + return NO_MATCHES_FOUND + + def search(self, query: List[str], options: Values) -> List[Dict[str, str]]: + index_url = options.index + + session = self.get_default_session(options) + + transport = PipXmlrpcTransport(index_url, session) + pypi = xmlrpc.client.ServerProxy(index_url, transport) + try: + hits = pypi.search({"name": query, "summary": query}, "or") + except xmlrpc.client.Fault as fault: + message = ( + f"XMLRPC request failed [code: {fault.faultCode}]\n{fault.faultString}" + ) + raise CommandError(message) + assert isinstance(hits, list) + return hits + + +def transform_hits(hits: List[Dict[str, str]]) -> List["TransformedHit"]: + """ + The list from pypi is really a list of versions. We want a list of + packages with the list of versions stored inline. This converts the + list from pypi into one we can use. + """ + packages: Dict[str, TransformedHit] = OrderedDict() + for hit in hits: + name = hit["name"] + summary = hit["summary"] + version = hit["version"] + + if name not in packages.keys(): + packages[name] = { + "name": name, + "summary": summary, + "versions": [version], + } + else: + packages[name]["versions"].append(version) + + # if this is the highest version, replace summary and score + if version == highest_version(packages[name]["versions"]): + packages[name]["summary"] = summary + + return list(packages.values()) + + +def print_dist_installation_info(name: str, latest: str) -> None: + env = get_default_environment() + dist = env.get_distribution(name) + if dist is not None: + with indent_log(): + if dist.version == latest: + write_output("INSTALLED: %s (latest)", dist.version) + else: + write_output("INSTALLED: %s", dist.version) + if parse_version(latest).pre: + write_output( + "LATEST: %s (pre-release; install" + " with `pip install --pre`)", + latest, + ) + else: + write_output("LATEST: %s", latest) + + +def print_results( + hits: List["TransformedHit"], + name_column_width: Optional[int] = None, + terminal_width: Optional[int] = None, +) -> None: + if not hits: + return + if name_column_width is None: + name_column_width = ( + max( + [ + len(hit["name"]) + len(highest_version(hit.get("versions", ["-"]))) + for hit in hits + ] + ) + + 4 + ) + + for hit in hits: + name = hit["name"] + summary = hit["summary"] or "" + latest = highest_version(hit.get("versions", ["-"])) + if terminal_width is not None: + target_width = terminal_width - name_column_width - 5 + if target_width > 10: + # wrap and indent summary to fit terminal + summary_lines = textwrap.wrap(summary, target_width) + summary = ("\n" + " " * (name_column_width + 3)).join(summary_lines) + + name_latest = f"{name} ({latest})" + line = f"{name_latest:{name_column_width}} - {summary}" + try: + write_output(line) + print_dist_installation_info(name, latest) + except UnicodeEncodeError: + pass + + +def highest_version(versions: List[str]) -> str: + return max(versions, key=parse_version) diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/commands/show.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/commands/show.py new file mode 100644 index 0000000..b47500c --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/commands/show.py @@ -0,0 +1,224 @@ +import logging +from optparse import Values +from typing import Generator, Iterable, Iterator, List, NamedTuple, Optional + +from pip._vendor.packaging.requirements import InvalidRequirement +from pip._vendor.packaging.utils import canonicalize_name + +from pip._internal.cli.base_command import Command +from pip._internal.cli.status_codes import ERROR, SUCCESS +from pip._internal.metadata import BaseDistribution, get_default_environment +from pip._internal.utils.misc import write_output + +logger = logging.getLogger(__name__) + + +class ShowCommand(Command): + """ + Show information about one or more installed packages. + + The output is in RFC-compliant mail header format. + """ + + usage = """ + %prog [options] ...""" + ignore_require_venv = True + + def add_options(self) -> None: + self.cmd_opts.add_option( + "-f", + "--files", + dest="files", + action="store_true", + default=False, + help="Show the full list of installed files for each package.", + ) + + self.parser.insert_option_group(0, self.cmd_opts) + + def run(self, options: Values, args: List[str]) -> int: + if not args: + logger.warning("ERROR: Please provide a package name or names.") + return ERROR + query = args + + results = search_packages_info(query) + if not print_results( + results, list_files=options.files, verbose=options.verbose + ): + return ERROR + return SUCCESS + + +class _PackageInfo(NamedTuple): + name: str + version: str + location: str + editable_project_location: Optional[str] + requires: List[str] + required_by: List[str] + installer: str + metadata_version: str + classifiers: List[str] + summary: str + homepage: str + project_urls: List[str] + author: str + author_email: str + license: str + license_expression: str + entry_points: List[str] + files: Optional[List[str]] + + +def search_packages_info(query: List[str]) -> Generator[_PackageInfo, None, None]: + """ + Gather details from installed distributions. Print distribution name, + version, location, and installed files. Installed files requires a + pip generated 'installed-files.txt' in the distributions '.egg-info' + directory. + """ + env = get_default_environment() + + installed = {dist.canonical_name: dist for dist in env.iter_all_distributions()} + query_names = [canonicalize_name(name) for name in query] + missing = sorted( + [name for name, pkg in zip(query, query_names) if pkg not in installed] + ) + if missing: + logger.warning("Package(s) not found: %s", ", ".join(missing)) + + def _get_requiring_packages(current_dist: BaseDistribution) -> Iterator[str]: + return ( + dist.metadata["Name"] or "UNKNOWN" + for dist in installed.values() + if current_dist.canonical_name + in {canonicalize_name(d.name) for d in dist.iter_dependencies()} + ) + + for query_name in query_names: + try: + dist = installed[query_name] + except KeyError: + continue + + try: + requires = sorted( + # Avoid duplicates in requirements (e.g. due to environment markers). + {req.name for req in dist.iter_dependencies()}, + key=str.lower, + ) + except InvalidRequirement: + requires = sorted(dist.iter_raw_dependencies(), key=str.lower) + + try: + required_by = sorted(_get_requiring_packages(dist), key=str.lower) + except InvalidRequirement: + required_by = ["#N/A"] + + try: + entry_points_text = dist.read_text("entry_points.txt") + entry_points = entry_points_text.splitlines(keepends=False) + except FileNotFoundError: + entry_points = [] + + files_iter = dist.iter_declared_entries() + if files_iter is None: + files: Optional[List[str]] = None + else: + files = sorted(files_iter) + + metadata = dist.metadata + + project_urls = metadata.get_all("Project-URL", []) + homepage = metadata.get("Home-page", "") + if not homepage: + # It's common that there is a "homepage" Project-URL, but Home-page + # remains unset (especially as PEP 621 doesn't surface the field). + # + # This logic was taken from PyPI's codebase. + for url in project_urls: + url_label, url = url.split(",", maxsplit=1) + normalized_label = ( + url_label.casefold().replace("-", "").replace("_", "").strip() + ) + if normalized_label == "homepage": + homepage = url.strip() + break + + yield _PackageInfo( + name=dist.raw_name, + version=dist.raw_version, + location=dist.location or "", + editable_project_location=dist.editable_project_location, + requires=requires, + required_by=required_by, + installer=dist.installer, + metadata_version=dist.metadata_version or "", + classifiers=metadata.get_all("Classifier", []), + summary=metadata.get("Summary", ""), + homepage=homepage, + project_urls=project_urls, + author=metadata.get("Author", ""), + author_email=metadata.get("Author-email", ""), + license=metadata.get("License", ""), + license_expression=metadata.get("License-Expression", ""), + entry_points=entry_points, + files=files, + ) + + +def print_results( + distributions: Iterable[_PackageInfo], + list_files: bool, + verbose: bool, +) -> bool: + """ + Print the information from installed distributions found. + """ + results_printed = False + for i, dist in enumerate(distributions): + results_printed = True + if i > 0: + write_output("---") + + metadata_version_tuple = tuple(map(int, dist.metadata_version.split("."))) + + write_output("Name: %s", dist.name) + write_output("Version: %s", dist.version) + write_output("Summary: %s", dist.summary) + write_output("Home-page: %s", dist.homepage) + write_output("Author: %s", dist.author) + write_output("Author-email: %s", dist.author_email) + if metadata_version_tuple >= (2, 4) and dist.license_expression: + write_output("License-Expression: %s", dist.license_expression) + else: + write_output("License: %s", dist.license) + write_output("Location: %s", dist.location) + if dist.editable_project_location is not None: + write_output( + "Editable project location: %s", dist.editable_project_location + ) + write_output("Requires: %s", ", ".join(dist.requires)) + write_output("Required-by: %s", ", ".join(dist.required_by)) + + if verbose: + write_output("Metadata-Version: %s", dist.metadata_version) + write_output("Installer: %s", dist.installer) + write_output("Classifiers:") + for classifier in dist.classifiers: + write_output(" %s", classifier) + write_output("Entry-points:") + for entry in dist.entry_points: + write_output(" %s", entry.strip()) + write_output("Project-URLs:") + for project_url in dist.project_urls: + write_output(" %s", project_url) + if list_files: + write_output("Files:") + if dist.files is None: + write_output("Cannot locate RECORD or installed-files.txt") + else: + for line in dist.files: + write_output(" %s", line.strip()) + return results_printed diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/commands/uninstall.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/commands/uninstall.py new file mode 100644 index 0000000..bc0edea --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/commands/uninstall.py @@ -0,0 +1,114 @@ +import logging +from optparse import Values +from typing import List + +from pip._vendor.packaging.utils import canonicalize_name + +from pip._internal.cli import cmdoptions +from pip._internal.cli.base_command import Command +from pip._internal.cli.index_command import SessionCommandMixin +from pip._internal.cli.status_codes import SUCCESS +from pip._internal.exceptions import InstallationError +from pip._internal.req import parse_requirements +from pip._internal.req.constructors import ( + install_req_from_line, + install_req_from_parsed_requirement, +) +from pip._internal.utils.misc import ( + check_externally_managed, + protect_pip_from_modification_on_windows, + warn_if_run_as_root, +) + +logger = logging.getLogger(__name__) + + +class UninstallCommand(Command, SessionCommandMixin): + """ + Uninstall packages. + + pip is able to uninstall most installed packages. Known exceptions are: + + - Pure distutils packages installed with ``python setup.py install``, which + leave behind no metadata to determine what files were installed. + - Script wrappers installed by ``python setup.py develop``. + """ + + usage = """ + %prog [options] ... + %prog [options] -r ...""" + + def add_options(self) -> None: + self.cmd_opts.add_option( + "-r", + "--requirement", + dest="requirements", + action="append", + default=[], + metavar="file", + help=( + "Uninstall all the packages listed in the given requirements " + "file. This option can be used multiple times." + ), + ) + self.cmd_opts.add_option( + "-y", + "--yes", + dest="yes", + action="store_true", + help="Don't ask for confirmation of uninstall deletions.", + ) + self.cmd_opts.add_option(cmdoptions.root_user_action()) + self.cmd_opts.add_option(cmdoptions.override_externally_managed()) + self.parser.insert_option_group(0, self.cmd_opts) + + def run(self, options: Values, args: List[str]) -> int: + session = self.get_default_session(options) + + reqs_to_uninstall = {} + for name in args: + req = install_req_from_line( + name, + isolated=options.isolated_mode, + ) + if req.name: + reqs_to_uninstall[canonicalize_name(req.name)] = req + else: + logger.warning( + "Invalid requirement: %r ignored -" + " the uninstall command expects named" + " requirements.", + name, + ) + for filename in options.requirements: + for parsed_req in parse_requirements( + filename, options=options, session=session + ): + req = install_req_from_parsed_requirement( + parsed_req, isolated=options.isolated_mode + ) + if req.name: + reqs_to_uninstall[canonicalize_name(req.name)] = req + if not reqs_to_uninstall: + raise InstallationError( + f"You must give at least one requirement to {self.name} (see " + f'"pip help {self.name}")' + ) + + if not options.override_externally_managed: + check_externally_managed() + + protect_pip_from_modification_on_windows( + modifying_pip="pip" in reqs_to_uninstall + ) + + for req in reqs_to_uninstall.values(): + uninstall_pathset = req.uninstall( + auto_confirm=options.yes, + verbose=self.verbosity > 0, + ) + if uninstall_pathset: + uninstall_pathset.commit() + if options.root_user_action == "warn": + warn_if_run_as_root() + return SUCCESS diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/commands/wheel.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/commands/wheel.py new file mode 100644 index 0000000..278719f --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/commands/wheel.py @@ -0,0 +1,182 @@ +import logging +import os +import shutil +from optparse import Values +from typing import List + +from pip._internal.cache import WheelCache +from pip._internal.cli import cmdoptions +from pip._internal.cli.req_command import RequirementCommand, with_cleanup +from pip._internal.cli.status_codes import SUCCESS +from pip._internal.exceptions import CommandError +from pip._internal.operations.build.build_tracker import get_build_tracker +from pip._internal.req.req_install import ( + InstallRequirement, + check_legacy_setup_py_options, +) +from pip._internal.utils.misc import ensure_dir, normalize_path +from pip._internal.utils.temp_dir import TempDirectory +from pip._internal.wheel_builder import build, should_build_for_wheel_command + +logger = logging.getLogger(__name__) + + +class WheelCommand(RequirementCommand): + """ + Build Wheel archives for your requirements and dependencies. + + Wheel is a built-package format, and offers the advantage of not + recompiling your software during every install. For more details, see the + wheel docs: https://wheel.readthedocs.io/en/latest/ + + 'pip wheel' uses the build system interface as described here: + https://pip.pypa.io/en/stable/reference/build-system/ + + """ + + usage = """ + %prog [options] ... + %prog [options] -r ... + %prog [options] [-e] ... + %prog [options] [-e] ... + %prog [options] ...""" + + def add_options(self) -> None: + self.cmd_opts.add_option( + "-w", + "--wheel-dir", + dest="wheel_dir", + metavar="dir", + default=os.curdir, + help=( + "Build wheels into , where the default is the " + "current working directory." + ), + ) + self.cmd_opts.add_option(cmdoptions.no_binary()) + self.cmd_opts.add_option(cmdoptions.only_binary()) + self.cmd_opts.add_option(cmdoptions.prefer_binary()) + self.cmd_opts.add_option(cmdoptions.no_build_isolation()) + self.cmd_opts.add_option(cmdoptions.use_pep517()) + self.cmd_opts.add_option(cmdoptions.no_use_pep517()) + self.cmd_opts.add_option(cmdoptions.check_build_deps()) + self.cmd_opts.add_option(cmdoptions.constraints()) + self.cmd_opts.add_option(cmdoptions.editable()) + self.cmd_opts.add_option(cmdoptions.requirements()) + self.cmd_opts.add_option(cmdoptions.src()) + self.cmd_opts.add_option(cmdoptions.ignore_requires_python()) + self.cmd_opts.add_option(cmdoptions.no_deps()) + self.cmd_opts.add_option(cmdoptions.progress_bar()) + + self.cmd_opts.add_option( + "--no-verify", + dest="no_verify", + action="store_true", + default=False, + help="Don't verify if built wheel is valid.", + ) + + self.cmd_opts.add_option(cmdoptions.config_settings()) + self.cmd_opts.add_option(cmdoptions.build_options()) + self.cmd_opts.add_option(cmdoptions.global_options()) + + self.cmd_opts.add_option( + "--pre", + action="store_true", + default=False, + help=( + "Include pre-release and development versions. By default, " + "pip only finds stable versions." + ), + ) + + self.cmd_opts.add_option(cmdoptions.require_hashes()) + + index_opts = cmdoptions.make_option_group( + cmdoptions.index_group, + self.parser, + ) + + self.parser.insert_option_group(0, index_opts) + self.parser.insert_option_group(0, self.cmd_opts) + + @with_cleanup + def run(self, options: Values, args: List[str]) -> int: + session = self.get_default_session(options) + + finder = self._build_package_finder(options, session) + + options.wheel_dir = normalize_path(options.wheel_dir) + ensure_dir(options.wheel_dir) + + build_tracker = self.enter_context(get_build_tracker()) + + directory = TempDirectory( + delete=not options.no_clean, + kind="wheel", + globally_managed=True, + ) + + reqs = self.get_requirements(args, options, finder, session) + check_legacy_setup_py_options(options, reqs) + + wheel_cache = WheelCache(options.cache_dir) + + preparer = self.make_requirement_preparer( + temp_build_dir=directory, + options=options, + build_tracker=build_tracker, + session=session, + finder=finder, + download_dir=options.wheel_dir, + use_user_site=False, + verbosity=self.verbosity, + ) + + resolver = self.make_resolver( + preparer=preparer, + finder=finder, + options=options, + wheel_cache=wheel_cache, + ignore_requires_python=options.ignore_requires_python, + use_pep517=options.use_pep517, + ) + + self.trace_basic_info(finder) + + requirement_set = resolver.resolve(reqs, check_supported_wheels=True) + + reqs_to_build: List[InstallRequirement] = [] + for req in requirement_set.requirements.values(): + if req.is_wheel: + preparer.save_linked_requirement(req) + elif should_build_for_wheel_command(req): + reqs_to_build.append(req) + + preparer.prepare_linked_requirements_more(requirement_set.requirements.values()) + + # build wheels + build_successes, build_failures = build( + reqs_to_build, + wheel_cache=wheel_cache, + verify=(not options.no_verify), + build_options=options.build_options or [], + global_options=options.global_options or [], + ) + for req in build_successes: + assert req.link and req.link.is_wheel + assert req.local_file_path + # copy from cache to target directory + try: + shutil.copy(req.local_file_path, options.wheel_dir) + except OSError as e: + logger.warning( + "Building wheel for %s failed: %s", + req.name, + e, + ) + build_failures.append(req) + if len(build_failures) != 0: + raise CommandError("Failed to build one or more wheels") + + return SUCCESS diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/configuration.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/configuration.py new file mode 100644 index 0000000..ffeda1d --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/configuration.py @@ -0,0 +1,383 @@ +"""Configuration management setup + +Some terminology: +- name + As written in config files. +- value + Value associated with a name +- key + Name combined with it's section (section.name) +- variant + A single word describing where the configuration key-value pair came from +""" + +import configparser +import locale +import os +import sys +from typing import Any, Dict, Iterable, List, NewType, Optional, Tuple + +from pip._internal.exceptions import ( + ConfigurationError, + ConfigurationFileCouldNotBeLoaded, +) +from pip._internal.utils import appdirs +from pip._internal.utils.compat import WINDOWS +from pip._internal.utils.logging import getLogger +from pip._internal.utils.misc import ensure_dir, enum + +RawConfigParser = configparser.RawConfigParser # Shorthand +Kind = NewType("Kind", str) + +CONFIG_BASENAME = "pip.ini" if WINDOWS else "pip.conf" +ENV_NAMES_IGNORED = "version", "help" + +# The kinds of configurations there are. +kinds = enum( + USER="user", # User Specific + GLOBAL="global", # System Wide + SITE="site", # [Virtual] Environment Specific + ENV="env", # from PIP_CONFIG_FILE + ENV_VAR="env-var", # from Environment Variables +) +OVERRIDE_ORDER = kinds.GLOBAL, kinds.USER, kinds.SITE, kinds.ENV, kinds.ENV_VAR +VALID_LOAD_ONLY = kinds.USER, kinds.GLOBAL, kinds.SITE + +logger = getLogger(__name__) + + +# NOTE: Maybe use the optionx attribute to normalize keynames. +def _normalize_name(name: str) -> str: + """Make a name consistent regardless of source (environment or file)""" + name = name.lower().replace("_", "-") + if name.startswith("--"): + name = name[2:] # only prefer long opts + return name + + +def _disassemble_key(name: str) -> List[str]: + if "." not in name: + error_message = ( + "Key does not contain dot separated section and key. " + f"Perhaps you wanted to use 'global.{name}' instead?" + ) + raise ConfigurationError(error_message) + return name.split(".", 1) + + +def get_configuration_files() -> Dict[Kind, List[str]]: + global_config_files = [ + os.path.join(path, CONFIG_BASENAME) for path in appdirs.site_config_dirs("pip") + ] + + site_config_file = os.path.join(sys.prefix, CONFIG_BASENAME) + legacy_config_file = os.path.join( + os.path.expanduser("~"), + "pip" if WINDOWS else ".pip", + CONFIG_BASENAME, + ) + new_config_file = os.path.join(appdirs.user_config_dir("pip"), CONFIG_BASENAME) + return { + kinds.GLOBAL: global_config_files, + kinds.SITE: [site_config_file], + kinds.USER: [legacy_config_file, new_config_file], + } + + +class Configuration: + """Handles management of configuration. + + Provides an interface to accessing and managing configuration files. + + This class converts provides an API that takes "section.key-name" style + keys and stores the value associated with it as "key-name" under the + section "section". + + This allows for a clean interface wherein the both the section and the + key-name are preserved in an easy to manage form in the configuration files + and the data stored is also nice. + """ + + def __init__(self, isolated: bool, load_only: Optional[Kind] = None) -> None: + super().__init__() + + if load_only is not None and load_only not in VALID_LOAD_ONLY: + raise ConfigurationError( + "Got invalid value for load_only - should be one of {}".format( + ", ".join(map(repr, VALID_LOAD_ONLY)) + ) + ) + self.isolated = isolated + self.load_only = load_only + + # Because we keep track of where we got the data from + self._parsers: Dict[Kind, List[Tuple[str, RawConfigParser]]] = { + variant: [] for variant in OVERRIDE_ORDER + } + self._config: Dict[Kind, Dict[str, Any]] = { + variant: {} for variant in OVERRIDE_ORDER + } + self._modified_parsers: List[Tuple[str, RawConfigParser]] = [] + + def load(self) -> None: + """Loads configuration from configuration files and environment""" + self._load_config_files() + if not self.isolated: + self._load_environment_vars() + + def get_file_to_edit(self) -> Optional[str]: + """Returns the file with highest priority in configuration""" + assert self.load_only is not None, "Need to be specified a file to be editing" + + try: + return self._get_parser_to_modify()[0] + except IndexError: + return None + + def items(self) -> Iterable[Tuple[str, Any]]: + """Returns key-value pairs like dict.items() representing the loaded + configuration + """ + return self._dictionary.items() + + def get_value(self, key: str) -> Any: + """Get a value from the configuration.""" + orig_key = key + key = _normalize_name(key) + try: + return self._dictionary[key] + except KeyError: + # disassembling triggers a more useful error message than simply + # "No such key" in the case that the key isn't in the form command.option + _disassemble_key(key) + raise ConfigurationError(f"No such key - {orig_key}") + + def set_value(self, key: str, value: Any) -> None: + """Modify a value in the configuration.""" + key = _normalize_name(key) + self._ensure_have_load_only() + + assert self.load_only + fname, parser = self._get_parser_to_modify() + + if parser is not None: + section, name = _disassemble_key(key) + + # Modify the parser and the configuration + if not parser.has_section(section): + parser.add_section(section) + parser.set(section, name, value) + + self._config[self.load_only][key] = value + self._mark_as_modified(fname, parser) + + def unset_value(self, key: str) -> None: + """Unset a value in the configuration.""" + orig_key = key + key = _normalize_name(key) + self._ensure_have_load_only() + + assert self.load_only + if key not in self._config[self.load_only]: + raise ConfigurationError(f"No such key - {orig_key}") + + fname, parser = self._get_parser_to_modify() + + if parser is not None: + section, name = _disassemble_key(key) + if not ( + parser.has_section(section) and parser.remove_option(section, name) + ): + # The option was not removed. + raise ConfigurationError( + "Fatal Internal error [id=1]. Please report as a bug." + ) + + # The section may be empty after the option was removed. + if not parser.items(section): + parser.remove_section(section) + self._mark_as_modified(fname, parser) + + del self._config[self.load_only][key] + + def save(self) -> None: + """Save the current in-memory state.""" + self._ensure_have_load_only() + + for fname, parser in self._modified_parsers: + logger.info("Writing to %s", fname) + + # Ensure directory exists. + ensure_dir(os.path.dirname(fname)) + + # Ensure directory's permission(need to be writeable) + try: + with open(fname, "w") as f: + parser.write(f) + except OSError as error: + raise ConfigurationError( + f"An error occurred while writing to the configuration file " + f"{fname}: {error}" + ) + + # + # Private routines + # + + def _ensure_have_load_only(self) -> None: + if self.load_only is None: + raise ConfigurationError("Needed a specific file to be modifying.") + logger.debug("Will be working with %s variant only", self.load_only) + + @property + def _dictionary(self) -> Dict[str, Any]: + """A dictionary representing the loaded configuration.""" + # NOTE: Dictionaries are not populated if not loaded. So, conditionals + # are not needed here. + retval = {} + + for variant in OVERRIDE_ORDER: + retval.update(self._config[variant]) + + return retval + + def _load_config_files(self) -> None: + """Loads configuration from configuration files""" + config_files = dict(self.iter_config_files()) + if config_files[kinds.ENV][0:1] == [os.devnull]: + logger.debug( + "Skipping loading configuration files due to " + "environment's PIP_CONFIG_FILE being os.devnull" + ) + return + + for variant, files in config_files.items(): + for fname in files: + # If there's specific variant set in `load_only`, load only + # that variant, not the others. + if self.load_only is not None and variant != self.load_only: + logger.debug("Skipping file '%s' (variant: %s)", fname, variant) + continue + + parser = self._load_file(variant, fname) + + # Keeping track of the parsers used + self._parsers[variant].append((fname, parser)) + + def _load_file(self, variant: Kind, fname: str) -> RawConfigParser: + logger.verbose("For variant '%s', will try loading '%s'", variant, fname) + parser = self._construct_parser(fname) + + for section in parser.sections(): + items = parser.items(section) + self._config[variant].update(self._normalized_keys(section, items)) + + return parser + + def _construct_parser(self, fname: str) -> RawConfigParser: + parser = configparser.RawConfigParser() + # If there is no such file, don't bother reading it but create the + # parser anyway, to hold the data. + # Doing this is useful when modifying and saving files, where we don't + # need to construct a parser. + if os.path.exists(fname): + locale_encoding = locale.getpreferredencoding(False) + try: + parser.read(fname, encoding=locale_encoding) + except UnicodeDecodeError: + # See https://github.com/pypa/pip/issues/4963 + raise ConfigurationFileCouldNotBeLoaded( + reason=f"contains invalid {locale_encoding} characters", + fname=fname, + ) + except configparser.Error as error: + # See https://github.com/pypa/pip/issues/4893 + raise ConfigurationFileCouldNotBeLoaded(error=error) + return parser + + def _load_environment_vars(self) -> None: + """Loads configuration from environment variables""" + self._config[kinds.ENV_VAR].update( + self._normalized_keys(":env:", self.get_environ_vars()) + ) + + def _normalized_keys( + self, section: str, items: Iterable[Tuple[str, Any]] + ) -> Dict[str, Any]: + """Normalizes items to construct a dictionary with normalized keys. + + This routine is where the names become keys and are made the same + regardless of source - configuration files or environment. + """ + normalized = {} + for name, val in items: + key = section + "." + _normalize_name(name) + normalized[key] = val + return normalized + + def get_environ_vars(self) -> Iterable[Tuple[str, str]]: + """Returns a generator with all environmental vars with prefix PIP_""" + for key, val in os.environ.items(): + if key.startswith("PIP_"): + name = key[4:].lower() + if name not in ENV_NAMES_IGNORED: + yield name, val + + # XXX: This is patched in the tests. + def iter_config_files(self) -> Iterable[Tuple[Kind, List[str]]]: + """Yields variant and configuration files associated with it. + + This should be treated like items of a dictionary. The order + here doesn't affect what gets overridden. That is controlled + by OVERRIDE_ORDER. However this does control the order they are + displayed to the user. It's probably most ergonomic to display + things in the same order as OVERRIDE_ORDER + """ + # SMELL: Move the conditions out of this function + + env_config_file = os.environ.get("PIP_CONFIG_FILE", None) + config_files = get_configuration_files() + + yield kinds.GLOBAL, config_files[kinds.GLOBAL] + + # per-user config is not loaded when env_config_file exists + should_load_user_config = not self.isolated and not ( + env_config_file and os.path.exists(env_config_file) + ) + if should_load_user_config: + # The legacy config file is overridden by the new config file + yield kinds.USER, config_files[kinds.USER] + + # virtualenv config + yield kinds.SITE, config_files[kinds.SITE] + + if env_config_file is not None: + yield kinds.ENV, [env_config_file] + else: + yield kinds.ENV, [] + + def get_values_in_config(self, variant: Kind) -> Dict[str, Any]: + """Get values present in a config file""" + return self._config[variant] + + def _get_parser_to_modify(self) -> Tuple[str, RawConfigParser]: + # Determine which parser to modify + assert self.load_only + parsers = self._parsers[self.load_only] + if not parsers: + # This should not happen if everything works correctly. + raise ConfigurationError( + "Fatal Internal error [id=2]. Please report as a bug." + ) + + # Use the highest priority parser. + return parsers[-1] + + # XXX: This is patched in the tests. + def _mark_as_modified(self, fname: str, parser: RawConfigParser) -> None: + file_parser_tuple = (fname, parser) + if file_parser_tuple not in self._modified_parsers: + self._modified_parsers.append(file_parser_tuple) + + def __repr__(self) -> str: + return f"{self.__class__.__name__}({self._dictionary!r})" diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/distributions/__init__.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/distributions/__init__.py new file mode 100644 index 0000000..9a89a83 --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/distributions/__init__.py @@ -0,0 +1,21 @@ +from pip._internal.distributions.base import AbstractDistribution +from pip._internal.distributions.sdist import SourceDistribution +from pip._internal.distributions.wheel import WheelDistribution +from pip._internal.req.req_install import InstallRequirement + + +def make_distribution_for_install_requirement( + install_req: InstallRequirement, +) -> AbstractDistribution: + """Returns a Distribution for the given InstallRequirement""" + # Editable requirements will always be source distributions. They use the + # legacy logic until we create a modern standard for them. + if install_req.editable: + return SourceDistribution(install_req) + + # If it's a wheel, it's a WheelDistribution + if install_req.is_wheel: + return WheelDistribution(install_req) + + # Otherwise, a SourceDistribution + return SourceDistribution(install_req) diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/distributions/__pycache__/__init__.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/distributions/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000..2cdee95 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/distributions/__pycache__/__init__.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/distributions/__pycache__/base.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/distributions/__pycache__/base.cpython-312.pyc new file mode 100644 index 0000000..60bfe18 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/distributions/__pycache__/base.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/distributions/__pycache__/installed.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/distributions/__pycache__/installed.cpython-312.pyc new file mode 100644 index 0000000..2387374 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/distributions/__pycache__/installed.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/distributions/__pycache__/sdist.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/distributions/__pycache__/sdist.cpython-312.pyc new file mode 100644 index 0000000..40f2a01 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/distributions/__pycache__/sdist.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/distributions/__pycache__/wheel.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/distributions/__pycache__/wheel.cpython-312.pyc new file mode 100644 index 0000000..1882bd5 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/distributions/__pycache__/wheel.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/distributions/base.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/distributions/base.py new file mode 100644 index 0000000..6e4d0c9 --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/distributions/base.py @@ -0,0 +1,53 @@ +import abc +from typing import TYPE_CHECKING, Optional + +from pip._internal.metadata.base import BaseDistribution +from pip._internal.req import InstallRequirement + +if TYPE_CHECKING: + from pip._internal.index.package_finder import PackageFinder + + +class AbstractDistribution(metaclass=abc.ABCMeta): + """A base class for handling installable artifacts. + + The requirements for anything installable are as follows: + + - we must be able to determine the requirement name + (or we can't correctly handle the non-upgrade case). + + - for packages with setup requirements, we must also be able + to determine their requirements without installing additional + packages (for the same reason as run-time dependencies) + + - we must be able to create a Distribution object exposing the + above metadata. + + - if we need to do work in the build tracker, we must be able to generate a unique + string to identify the requirement in the build tracker. + """ + + def __init__(self, req: InstallRequirement) -> None: + super().__init__() + self.req = req + + @abc.abstractproperty + def build_tracker_id(self) -> Optional[str]: + """A string that uniquely identifies this requirement to the build tracker. + + If None, then this dist has no work to do in the build tracker, and + ``.prepare_distribution_metadata()`` will not be called.""" + raise NotImplementedError() + + @abc.abstractmethod + def get_metadata_distribution(self) -> BaseDistribution: + raise NotImplementedError() + + @abc.abstractmethod + def prepare_distribution_metadata( + self, + finder: "PackageFinder", + build_isolation: bool, + check_build_deps: bool, + ) -> None: + raise NotImplementedError() diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/distributions/installed.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/distributions/installed.py new file mode 100644 index 0000000..ab8d53b --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/distributions/installed.py @@ -0,0 +1,29 @@ +from typing import Optional + +from pip._internal.distributions.base import AbstractDistribution +from pip._internal.index.package_finder import PackageFinder +from pip._internal.metadata import BaseDistribution + + +class InstalledDistribution(AbstractDistribution): + """Represents an installed package. + + This does not need any preparation as the required information has already + been computed. + """ + + @property + def build_tracker_id(self) -> Optional[str]: + return None + + def get_metadata_distribution(self) -> BaseDistribution: + assert self.req.satisfied_by is not None, "not actually installed" + return self.req.satisfied_by + + def prepare_distribution_metadata( + self, + finder: PackageFinder, + build_isolation: bool, + check_build_deps: bool, + ) -> None: + pass diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/distributions/sdist.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/distributions/sdist.py new file mode 100644 index 0000000..28ea5ce --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/distributions/sdist.py @@ -0,0 +1,158 @@ +import logging +from typing import TYPE_CHECKING, Iterable, Optional, Set, Tuple + +from pip._internal.build_env import BuildEnvironment +from pip._internal.distributions.base import AbstractDistribution +from pip._internal.exceptions import InstallationError +from pip._internal.metadata import BaseDistribution +from pip._internal.utils.subprocess import runner_with_spinner_message + +if TYPE_CHECKING: + from pip._internal.index.package_finder import PackageFinder + +logger = logging.getLogger(__name__) + + +class SourceDistribution(AbstractDistribution): + """Represents a source distribution. + + The preparation step for these needs metadata for the packages to be + generated, either using PEP 517 or using the legacy `setup.py egg_info`. + """ + + @property + def build_tracker_id(self) -> Optional[str]: + """Identify this requirement uniquely by its link.""" + assert self.req.link + return self.req.link.url_without_fragment + + def get_metadata_distribution(self) -> BaseDistribution: + return self.req.get_dist() + + def prepare_distribution_metadata( + self, + finder: "PackageFinder", + build_isolation: bool, + check_build_deps: bool, + ) -> None: + # Load pyproject.toml, to determine whether PEP 517 is to be used + self.req.load_pyproject_toml() + + # Set up the build isolation, if this requirement should be isolated + should_isolate = self.req.use_pep517 and build_isolation + if should_isolate: + # Setup an isolated environment and install the build backend static + # requirements in it. + self._prepare_build_backend(finder) + # Check that if the requirement is editable, it either supports PEP 660 or + # has a setup.py or a setup.cfg. This cannot be done earlier because we need + # to setup the build backend to verify it supports build_editable, nor can + # it be done later, because we want to avoid installing build requirements + # needlessly. Doing it here also works around setuptools generating + # UNKNOWN.egg-info when running get_requires_for_build_wheel on a directory + # without setup.py nor setup.cfg. + self.req.isolated_editable_sanity_check() + # Install the dynamic build requirements. + self._install_build_reqs(finder) + # Check if the current environment provides build dependencies + should_check_deps = self.req.use_pep517 and check_build_deps + if should_check_deps: + pyproject_requires = self.req.pyproject_requires + assert pyproject_requires is not None + conflicting, missing = self.req.build_env.check_requirements( + pyproject_requires + ) + if conflicting: + self._raise_conflicts("the backend dependencies", conflicting) + if missing: + self._raise_missing_reqs(missing) + self.req.prepare_metadata() + + def _prepare_build_backend(self, finder: "PackageFinder") -> None: + # Isolate in a BuildEnvironment and install the build-time + # requirements. + pyproject_requires = self.req.pyproject_requires + assert pyproject_requires is not None + + self.req.build_env = BuildEnvironment() + self.req.build_env.install_requirements( + finder, pyproject_requires, "overlay", kind="build dependencies" + ) + conflicting, missing = self.req.build_env.check_requirements( + self.req.requirements_to_check + ) + if conflicting: + self._raise_conflicts("PEP 517/518 supported requirements", conflicting) + if missing: + logger.warning( + "Missing build requirements in pyproject.toml for %s.", + self.req, + ) + logger.warning( + "The project does not specify a build backend, and " + "pip cannot fall back to setuptools without %s.", + " and ".join(map(repr, sorted(missing))), + ) + + def _get_build_requires_wheel(self) -> Iterable[str]: + with self.req.build_env: + runner = runner_with_spinner_message("Getting requirements to build wheel") + backend = self.req.pep517_backend + assert backend is not None + with backend.subprocess_runner(runner): + return backend.get_requires_for_build_wheel() + + def _get_build_requires_editable(self) -> Iterable[str]: + with self.req.build_env: + runner = runner_with_spinner_message( + "Getting requirements to build editable" + ) + backend = self.req.pep517_backend + assert backend is not None + with backend.subprocess_runner(runner): + return backend.get_requires_for_build_editable() + + def _install_build_reqs(self, finder: "PackageFinder") -> None: + # Install any extra build dependencies that the backend requests. + # This must be done in a second pass, as the pyproject.toml + # dependencies must be installed before we can call the backend. + if ( + self.req.editable + and self.req.permit_editable_wheels + and self.req.supports_pyproject_editable + ): + build_reqs = self._get_build_requires_editable() + else: + build_reqs = self._get_build_requires_wheel() + conflicting, missing = self.req.build_env.check_requirements(build_reqs) + if conflicting: + self._raise_conflicts("the backend dependencies", conflicting) + self.req.build_env.install_requirements( + finder, missing, "normal", kind="backend dependencies" + ) + + def _raise_conflicts( + self, conflicting_with: str, conflicting_reqs: Set[Tuple[str, str]] + ) -> None: + format_string = ( + "Some build dependencies for {requirement} " + "conflict with {conflicting_with}: {description}." + ) + error_message = format_string.format( + requirement=self.req, + conflicting_with=conflicting_with, + description=", ".join( + f"{installed} is incompatible with {wanted}" + for installed, wanted in sorted(conflicting_reqs) + ), + ) + raise InstallationError(error_message) + + def _raise_missing_reqs(self, missing: Set[str]) -> None: + format_string = ( + "Some build dependencies for {requirement} are missing: {missing}." + ) + error_message = format_string.format( + requirement=self.req, missing=", ".join(map(repr, sorted(missing))) + ) + raise InstallationError(error_message) diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/distributions/wheel.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/distributions/wheel.py new file mode 100644 index 0000000..bfadd39 --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/distributions/wheel.py @@ -0,0 +1,42 @@ +from typing import TYPE_CHECKING, Optional + +from pip._vendor.packaging.utils import canonicalize_name + +from pip._internal.distributions.base import AbstractDistribution +from pip._internal.metadata import ( + BaseDistribution, + FilesystemWheel, + get_wheel_distribution, +) + +if TYPE_CHECKING: + from pip._internal.index.package_finder import PackageFinder + + +class WheelDistribution(AbstractDistribution): + """Represents a wheel distribution. + + This does not need any preparation as wheels can be directly unpacked. + """ + + @property + def build_tracker_id(self) -> Optional[str]: + return None + + def get_metadata_distribution(self) -> BaseDistribution: + """Loads the metadata from the wheel file into memory and returns a + Distribution that uses it, not relying on the wheel file or + requirement. + """ + assert self.req.local_file_path, "Set as part of preparation during download" + assert self.req.name, "Wheels are never unnamed" + wheel = FilesystemWheel(self.req.local_file_path) + return get_wheel_distribution(wheel, canonicalize_name(self.req.name)) + + def prepare_distribution_metadata( + self, + finder: "PackageFinder", + build_isolation: bool, + check_build_deps: bool, + ) -> None: + pass diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/exceptions.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/exceptions.py new file mode 100644 index 0000000..45a876a --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/exceptions.py @@ -0,0 +1,809 @@ +"""Exceptions used throughout package. + +This module MUST NOT try to import from anything within `pip._internal` to +operate. This is expected to be importable from any/all files within the +subpackage and, thus, should not depend on them. +""" + +import configparser +import contextlib +import locale +import logging +import pathlib +import re +import sys +from itertools import chain, groupby, repeat +from typing import TYPE_CHECKING, Dict, Iterator, List, Literal, Optional, Union + +from pip._vendor.packaging.requirements import InvalidRequirement +from pip._vendor.packaging.version import InvalidVersion +from pip._vendor.rich.console import Console, ConsoleOptions, RenderResult +from pip._vendor.rich.markup import escape +from pip._vendor.rich.text import Text + +if TYPE_CHECKING: + from hashlib import _Hash + + from pip._vendor.requests.models import Request, Response + + from pip._internal.metadata import BaseDistribution + from pip._internal.req.req_install import InstallRequirement + +logger = logging.getLogger(__name__) + + +# +# Scaffolding +# +def _is_kebab_case(s: str) -> bool: + return re.match(r"^[a-z]+(-[a-z]+)*$", s) is not None + + +def _prefix_with_indent( + s: Union[Text, str], + console: Console, + *, + prefix: str, + indent: str, +) -> Text: + if isinstance(s, Text): + text = s + else: + text = console.render_str(s) + + return console.render_str(prefix, overflow="ignore") + console.render_str( + f"\n{indent}", overflow="ignore" + ).join(text.split(allow_blank=True)) + + +class PipError(Exception): + """The base pip error.""" + + +class DiagnosticPipError(PipError): + """An error, that presents diagnostic information to the user. + + This contains a bunch of logic, to enable pretty presentation of our error + messages. Each error gets a unique reference. Each error can also include + additional context, a hint and/or a note -- which are presented with the + main error message in a consistent style. + + This is adapted from the error output styling in `sphinx-theme-builder`. + """ + + reference: str + + def __init__( + self, + *, + kind: 'Literal["error", "warning"]' = "error", + reference: Optional[str] = None, + message: Union[str, Text], + context: Optional[Union[str, Text]], + hint_stmt: Optional[Union[str, Text]], + note_stmt: Optional[Union[str, Text]] = None, + link: Optional[str] = None, + ) -> None: + # Ensure a proper reference is provided. + if reference is None: + assert hasattr(self, "reference"), "error reference not provided!" + reference = self.reference + assert _is_kebab_case(reference), "error reference must be kebab-case!" + + self.kind = kind + self.reference = reference + + self.message = message + self.context = context + + self.note_stmt = note_stmt + self.hint_stmt = hint_stmt + + self.link = link + + super().__init__(f"<{self.__class__.__name__}: {self.reference}>") + + def __repr__(self) -> str: + return ( + f"<{self.__class__.__name__}(" + f"reference={self.reference!r}, " + f"message={self.message!r}, " + f"context={self.context!r}, " + f"note_stmt={self.note_stmt!r}, " + f"hint_stmt={self.hint_stmt!r}" + ")>" + ) + + def __rich_console__( + self, + console: Console, + options: ConsoleOptions, + ) -> RenderResult: + colour = "red" if self.kind == "error" else "yellow" + + yield f"[{colour} bold]{self.kind}[/]: [bold]{self.reference}[/]" + yield "" + + if not options.ascii_only: + # Present the main message, with relevant context indented. + if self.context is not None: + yield _prefix_with_indent( + self.message, + console, + prefix=f"[{colour}]×[/] ", + indent=f"[{colour}]│[/] ", + ) + yield _prefix_with_indent( + self.context, + console, + prefix=f"[{colour}]╰─>[/] ", + indent=f"[{colour}] [/] ", + ) + else: + yield _prefix_with_indent( + self.message, + console, + prefix="[red]×[/] ", + indent=" ", + ) + else: + yield self.message + if self.context is not None: + yield "" + yield self.context + + if self.note_stmt is not None or self.hint_stmt is not None: + yield "" + + if self.note_stmt is not None: + yield _prefix_with_indent( + self.note_stmt, + console, + prefix="[magenta bold]note[/]: ", + indent=" ", + ) + if self.hint_stmt is not None: + yield _prefix_with_indent( + self.hint_stmt, + console, + prefix="[cyan bold]hint[/]: ", + indent=" ", + ) + + if self.link is not None: + yield "" + yield f"Link: {self.link}" + + +# +# Actual Errors +# +class ConfigurationError(PipError): + """General exception in configuration""" + + +class InstallationError(PipError): + """General exception during installation""" + + +class MissingPyProjectBuildRequires(DiagnosticPipError): + """Raised when pyproject.toml has `build-system`, but no `build-system.requires`.""" + + reference = "missing-pyproject-build-system-requires" + + def __init__(self, *, package: str) -> None: + super().__init__( + message=f"Can not process {escape(package)}", + context=Text( + "This package has an invalid pyproject.toml file.\n" + "The [build-system] table is missing the mandatory `requires` key." + ), + note_stmt="This is an issue with the package mentioned above, not pip.", + hint_stmt=Text("See PEP 518 for the detailed specification."), + ) + + +class InvalidPyProjectBuildRequires(DiagnosticPipError): + """Raised when pyproject.toml an invalid `build-system.requires`.""" + + reference = "invalid-pyproject-build-system-requires" + + def __init__(self, *, package: str, reason: str) -> None: + super().__init__( + message=f"Can not process {escape(package)}", + context=Text( + "This package has an invalid `build-system.requires` key in " + f"pyproject.toml.\n{reason}" + ), + note_stmt="This is an issue with the package mentioned above, not pip.", + hint_stmt=Text("See PEP 518 for the detailed specification."), + ) + + +class NoneMetadataError(PipError): + """Raised when accessing a Distribution's "METADATA" or "PKG-INFO". + + This signifies an inconsistency, when the Distribution claims to have + the metadata file (if not, raise ``FileNotFoundError`` instead), but is + not actually able to produce its content. This may be due to permission + errors. + """ + + def __init__( + self, + dist: "BaseDistribution", + metadata_name: str, + ) -> None: + """ + :param dist: A Distribution object. + :param metadata_name: The name of the metadata being accessed + (can be "METADATA" or "PKG-INFO"). + """ + self.dist = dist + self.metadata_name = metadata_name + + def __str__(self) -> str: + # Use `dist` in the error message because its stringification + # includes more information, like the version and location. + return f"None {self.metadata_name} metadata found for distribution: {self.dist}" + + +class UserInstallationInvalid(InstallationError): + """A --user install is requested on an environment without user site.""" + + def __str__(self) -> str: + return "User base directory is not specified" + + +class InvalidSchemeCombination(InstallationError): + def __str__(self) -> str: + before = ", ".join(str(a) for a in self.args[:-1]) + return f"Cannot set {before} and {self.args[-1]} together" + + +class DistributionNotFound(InstallationError): + """Raised when a distribution cannot be found to satisfy a requirement""" + + +class RequirementsFileParseError(InstallationError): + """Raised when a general error occurs parsing a requirements file line.""" + + +class BestVersionAlreadyInstalled(PipError): + """Raised when the most up-to-date version of a package is already + installed.""" + + +class BadCommand(PipError): + """Raised when virtualenv or a command is not found""" + + +class CommandError(PipError): + """Raised when there is an error in command-line arguments""" + + +class PreviousBuildDirError(PipError): + """Raised when there's a previous conflicting build directory""" + + +class NetworkConnectionError(PipError): + """HTTP connection error""" + + def __init__( + self, + error_msg: str, + response: Optional["Response"] = None, + request: Optional["Request"] = None, + ) -> None: + """ + Initialize NetworkConnectionError with `request` and `response` + objects. + """ + self.response = response + self.request = request + self.error_msg = error_msg + if ( + self.response is not None + and not self.request + and hasattr(response, "request") + ): + self.request = self.response.request + super().__init__(error_msg, response, request) + + def __str__(self) -> str: + return str(self.error_msg) + + +class InvalidWheelFilename(InstallationError): + """Invalid wheel filename.""" + + +class UnsupportedWheel(InstallationError): + """Unsupported wheel.""" + + +class InvalidWheel(InstallationError): + """Invalid (e.g. corrupt) wheel.""" + + def __init__(self, location: str, name: str): + self.location = location + self.name = name + + def __str__(self) -> str: + return f"Wheel '{self.name}' located at {self.location} is invalid." + + +class MetadataInconsistent(InstallationError): + """Built metadata contains inconsistent information. + + This is raised when the metadata contains values (e.g. name and version) + that do not match the information previously obtained from sdist filename, + user-supplied ``#egg=`` value, or an install requirement name. + """ + + def __init__( + self, ireq: "InstallRequirement", field: str, f_val: str, m_val: str + ) -> None: + self.ireq = ireq + self.field = field + self.f_val = f_val + self.m_val = m_val + + def __str__(self) -> str: + return ( + f"Requested {self.ireq} has inconsistent {self.field}: " + f"expected {self.f_val!r}, but metadata has {self.m_val!r}" + ) + + +class MetadataInvalid(InstallationError): + """Metadata is invalid.""" + + def __init__(self, ireq: "InstallRequirement", error: str) -> None: + self.ireq = ireq + self.error = error + + def __str__(self) -> str: + return f"Requested {self.ireq} has invalid metadata: {self.error}" + + +class InstallationSubprocessError(DiagnosticPipError, InstallationError): + """A subprocess call failed.""" + + reference = "subprocess-exited-with-error" + + def __init__( + self, + *, + command_description: str, + exit_code: int, + output_lines: Optional[List[str]], + ) -> None: + if output_lines is None: + output_prompt = Text("See above for output.") + else: + output_prompt = ( + Text.from_markup(f"[red][{len(output_lines)} lines of output][/]\n") + + Text("".join(output_lines)) + + Text.from_markup(R"[red]\[end of output][/]") + ) + + super().__init__( + message=( + f"[green]{escape(command_description)}[/] did not run successfully.\n" + f"exit code: {exit_code}" + ), + context=output_prompt, + hint_stmt=None, + note_stmt=( + "This error originates from a subprocess, and is likely not a " + "problem with pip." + ), + ) + + self.command_description = command_description + self.exit_code = exit_code + + def __str__(self) -> str: + return f"{self.command_description} exited with {self.exit_code}" + + +class MetadataGenerationFailed(InstallationSubprocessError, InstallationError): + reference = "metadata-generation-failed" + + def __init__( + self, + *, + package_details: str, + ) -> None: + super(InstallationSubprocessError, self).__init__( + message="Encountered error while generating package metadata.", + context=escape(package_details), + hint_stmt="See above for details.", + note_stmt="This is an issue with the package mentioned above, not pip.", + ) + + def __str__(self) -> str: + return "metadata generation failed" + + +class HashErrors(InstallationError): + """Multiple HashError instances rolled into one for reporting""" + + def __init__(self) -> None: + self.errors: List[HashError] = [] + + def append(self, error: "HashError") -> None: + self.errors.append(error) + + def __str__(self) -> str: + lines = [] + self.errors.sort(key=lambda e: e.order) + for cls, errors_of_cls in groupby(self.errors, lambda e: e.__class__): + lines.append(cls.head) + lines.extend(e.body() for e in errors_of_cls) + if lines: + return "\n".join(lines) + return "" + + def __bool__(self) -> bool: + return bool(self.errors) + + +class HashError(InstallationError): + """ + A failure to verify a package against known-good hashes + + :cvar order: An int sorting hash exception classes by difficulty of + recovery (lower being harder), so the user doesn't bother fretting + about unpinned packages when he has deeper issues, like VCS + dependencies, to deal with. Also keeps error reports in a + deterministic order. + :cvar head: A section heading for display above potentially many + exceptions of this kind + :ivar req: The InstallRequirement that triggered this error. This is + pasted on after the exception is instantiated, because it's not + typically available earlier. + + """ + + req: Optional["InstallRequirement"] = None + head = "" + order: int = -1 + + def body(self) -> str: + """Return a summary of me for display under the heading. + + This default implementation simply prints a description of the + triggering requirement. + + :param req: The InstallRequirement that provoked this error, with + its link already populated by the resolver's _populate_link(). + + """ + return f" {self._requirement_name()}" + + def __str__(self) -> str: + return f"{self.head}\n{self.body()}" + + def _requirement_name(self) -> str: + """Return a description of the requirement that triggered me. + + This default implementation returns long description of the req, with + line numbers + + """ + return str(self.req) if self.req else "unknown package" + + +class VcsHashUnsupported(HashError): + """A hash was provided for a version-control-system-based requirement, but + we don't have a method for hashing those.""" + + order = 0 + head = ( + "Can't verify hashes for these requirements because we don't " + "have a way to hash version control repositories:" + ) + + +class DirectoryUrlHashUnsupported(HashError): + """A hash was provided for a version-control-system-based requirement, but + we don't have a method for hashing those.""" + + order = 1 + head = ( + "Can't verify hashes for these file:// requirements because they " + "point to directories:" + ) + + +class HashMissing(HashError): + """A hash was needed for a requirement but is absent.""" + + order = 2 + head = ( + "Hashes are required in --require-hashes mode, but they are " + "missing from some requirements. Here is a list of those " + "requirements along with the hashes their downloaded archives " + "actually had. Add lines like these to your requirements files to " + "prevent tampering. (If you did not enable --require-hashes " + "manually, note that it turns on automatically when any package " + "has a hash.)" + ) + + def __init__(self, gotten_hash: str) -> None: + """ + :param gotten_hash: The hash of the (possibly malicious) archive we + just downloaded + """ + self.gotten_hash = gotten_hash + + def body(self) -> str: + # Dodge circular import. + from pip._internal.utils.hashes import FAVORITE_HASH + + package = None + if self.req: + # In the case of URL-based requirements, display the original URL + # seen in the requirements file rather than the package name, + # so the output can be directly copied into the requirements file. + package = ( + self.req.original_link + if self.req.is_direct + # In case someone feeds something downright stupid + # to InstallRequirement's constructor. + else getattr(self.req, "req", None) + ) + return " {} --hash={}:{}".format( + package or "unknown package", FAVORITE_HASH, self.gotten_hash + ) + + +class HashUnpinned(HashError): + """A requirement had a hash specified but was not pinned to a specific + version.""" + + order = 3 + head = ( + "In --require-hashes mode, all requirements must have their " + "versions pinned with ==. These do not:" + ) + + +class HashMismatch(HashError): + """ + Distribution file hash values don't match. + + :ivar package_name: The name of the package that triggered the hash + mismatch. Feel free to write to this after the exception is raise to + improve its error message. + + """ + + order = 4 + head = ( + "THESE PACKAGES DO NOT MATCH THE HASHES FROM THE REQUIREMENTS " + "FILE. If you have updated the package versions, please update " + "the hashes. Otherwise, examine the package contents carefully; " + "someone may have tampered with them." + ) + + def __init__(self, allowed: Dict[str, List[str]], gots: Dict[str, "_Hash"]) -> None: + """ + :param allowed: A dict of algorithm names pointing to lists of allowed + hex digests + :param gots: A dict of algorithm names pointing to hashes we + actually got from the files under suspicion + """ + self.allowed = allowed + self.gots = gots + + def body(self) -> str: + return f" {self._requirement_name()}:\n{self._hash_comparison()}" + + def _hash_comparison(self) -> str: + """ + Return a comparison of actual and expected hash values. + + Example:: + + Expected sha256 abcdeabcdeabcdeabcdeabcdeabcdeabcdeabcdeabcde + or 123451234512345123451234512345123451234512345 + Got bcdefbcdefbcdefbcdefbcdefbcdefbcdefbcdefbcdef + + """ + + def hash_then_or(hash_name: str) -> "chain[str]": + # For now, all the decent hashes have 6-char names, so we can get + # away with hard-coding space literals. + return chain([hash_name], repeat(" or")) + + lines: List[str] = [] + for hash_name, expecteds in self.allowed.items(): + prefix = hash_then_or(hash_name) + lines.extend((f" Expected {next(prefix)} {e}") for e in expecteds) + lines.append( + f" Got {self.gots[hash_name].hexdigest()}\n" + ) + return "\n".join(lines) + + +class UnsupportedPythonVersion(InstallationError): + """Unsupported python version according to Requires-Python package + metadata.""" + + +class ConfigurationFileCouldNotBeLoaded(ConfigurationError): + """When there are errors while loading a configuration file""" + + def __init__( + self, + reason: str = "could not be loaded", + fname: Optional[str] = None, + error: Optional[configparser.Error] = None, + ) -> None: + super().__init__(error) + self.reason = reason + self.fname = fname + self.error = error + + def __str__(self) -> str: + if self.fname is not None: + message_part = f" in {self.fname}." + else: + assert self.error is not None + message_part = f".\n{self.error}\n" + return f"Configuration file {self.reason}{message_part}" + + +_DEFAULT_EXTERNALLY_MANAGED_ERROR = f"""\ +The Python environment under {sys.prefix} is managed externally, and may not be +manipulated by the user. Please use specific tooling from the distributor of +the Python installation to interact with this environment instead. +""" + + +class ExternallyManagedEnvironment(DiagnosticPipError): + """The current environment is externally managed. + + This is raised when the current environment is externally managed, as + defined by `PEP 668`_. The ``EXTERNALLY-MANAGED`` configuration is checked + and displayed when the error is bubbled up to the user. + + :param error: The error message read from ``EXTERNALLY-MANAGED``. + """ + + reference = "externally-managed-environment" + + def __init__(self, error: Optional[str]) -> None: + if error is None: + context = Text(_DEFAULT_EXTERNALLY_MANAGED_ERROR) + else: + context = Text(error) + super().__init__( + message="This environment is externally managed", + context=context, + note_stmt=( + "If you believe this is a mistake, please contact your " + "Python installation or OS distribution provider. " + "You can override this, at the risk of breaking your Python " + "installation or OS, by passing --break-system-packages." + ), + hint_stmt=Text("See PEP 668 for the detailed specification."), + ) + + @staticmethod + def _iter_externally_managed_error_keys() -> Iterator[str]: + # LC_MESSAGES is in POSIX, but not the C standard. The most common + # platform that does not implement this category is Windows, where + # using other categories for console message localization is equally + # unreliable, so we fall back to the locale-less vendor message. This + # can always be re-evaluated when a vendor proposes a new alternative. + try: + category = locale.LC_MESSAGES + except AttributeError: + lang: Optional[str] = None + else: + lang, _ = locale.getlocale(category) + if lang is not None: + yield f"Error-{lang}" + for sep in ("-", "_"): + before, found, _ = lang.partition(sep) + if not found: + continue + yield f"Error-{before}" + yield "Error" + + @classmethod + def from_config( + cls, + config: Union[pathlib.Path, str], + ) -> "ExternallyManagedEnvironment": + parser = configparser.ConfigParser(interpolation=None) + try: + parser.read(config, encoding="utf-8") + section = parser["externally-managed"] + for key in cls._iter_externally_managed_error_keys(): + with contextlib.suppress(KeyError): + return cls(section[key]) + except KeyError: + pass + except (OSError, UnicodeDecodeError, configparser.ParsingError): + from pip._internal.utils._log import VERBOSE + + exc_info = logger.isEnabledFor(VERBOSE) + logger.warning("Failed to read %s", config, exc_info=exc_info) + return cls(None) + + +class UninstallMissingRecord(DiagnosticPipError): + reference = "uninstall-no-record-file" + + def __init__(self, *, distribution: "BaseDistribution") -> None: + installer = distribution.installer + if not installer or installer == "pip": + dep = f"{distribution.raw_name}=={distribution.version}" + hint = Text.assemble( + "You might be able to recover from this via: ", + (f"pip install --force-reinstall --no-deps {dep}", "green"), + ) + else: + hint = Text( + f"The package was installed by {installer}. " + "You should check if it can uninstall the package." + ) + + super().__init__( + message=Text(f"Cannot uninstall {distribution}"), + context=( + "The package's contents are unknown: " + f"no RECORD file was found for {distribution.raw_name}." + ), + hint_stmt=hint, + ) + + +class LegacyDistutilsInstall(DiagnosticPipError): + reference = "uninstall-distutils-installed-package" + + def __init__(self, *, distribution: "BaseDistribution") -> None: + super().__init__( + message=Text(f"Cannot uninstall {distribution}"), + context=( + "It is a distutils installed project and thus we cannot accurately " + "determine which files belong to it which would lead to only a partial " + "uninstall." + ), + hint_stmt=None, + ) + + +class InvalidInstalledPackage(DiagnosticPipError): + reference = "invalid-installed-package" + + def __init__( + self, + *, + dist: "BaseDistribution", + invalid_exc: Union[InvalidRequirement, InvalidVersion], + ) -> None: + installed_location = dist.installed_location + + if isinstance(invalid_exc, InvalidRequirement): + invalid_type = "requirement" + else: + invalid_type = "version" + + super().__init__( + message=Text( + f"Cannot process installed package {dist} " + + (f"in {installed_location!r} " if installed_location else "") + + f"because it has an invalid {invalid_type}:\n{invalid_exc.args[0]}" + ), + context=( + "Starting with pip 24.1, packages with invalid " + f"{invalid_type}s can not be processed." + ), + hint_stmt="To proceed this package must be uninstalled.", + ) diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/index/__init__.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/index/__init__.py new file mode 100644 index 0000000..7a17b7b --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/index/__init__.py @@ -0,0 +1,2 @@ +"""Index interaction code +""" diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/index/__pycache__/__init__.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/index/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000..0b1c1ae Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/index/__pycache__/__init__.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/index/__pycache__/collector.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/index/__pycache__/collector.cpython-312.pyc new file mode 100644 index 0000000..35b01bc Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/index/__pycache__/collector.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/index/__pycache__/package_finder.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/index/__pycache__/package_finder.cpython-312.pyc new file mode 100644 index 0000000..213fe8a Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/index/__pycache__/package_finder.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/index/__pycache__/sources.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/index/__pycache__/sources.cpython-312.pyc new file mode 100644 index 0000000..fc21c64 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/index/__pycache__/sources.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/index/collector.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/index/collector.py new file mode 100644 index 0000000..5f8fdee --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/index/collector.py @@ -0,0 +1,494 @@ +""" +The main purpose of this module is to expose LinkCollector.collect_sources(). +""" + +import collections +import email.message +import functools +import itertools +import json +import logging +import os +import urllib.parse +import urllib.request +from dataclasses import dataclass +from html.parser import HTMLParser +from optparse import Values +from typing import ( + Callable, + Dict, + Iterable, + List, + MutableMapping, + NamedTuple, + Optional, + Protocol, + Sequence, + Tuple, + Union, +) + +from pip._vendor import requests +from pip._vendor.requests import Response +from pip._vendor.requests.exceptions import RetryError, SSLError + +from pip._internal.exceptions import NetworkConnectionError +from pip._internal.models.link import Link +from pip._internal.models.search_scope import SearchScope +from pip._internal.network.session import PipSession +from pip._internal.network.utils import raise_for_status +from pip._internal.utils.filetypes import is_archive_file +from pip._internal.utils.misc import redact_auth_from_url +from pip._internal.vcs import vcs + +from .sources import CandidatesFromPage, LinkSource, build_source + +logger = logging.getLogger(__name__) + +ResponseHeaders = MutableMapping[str, str] + + +def _match_vcs_scheme(url: str) -> Optional[str]: + """Look for VCS schemes in the URL. + + Returns the matched VCS scheme, or None if there's no match. + """ + for scheme in vcs.schemes: + if url.lower().startswith(scheme) and url[len(scheme)] in "+:": + return scheme + return None + + +class _NotAPIContent(Exception): + def __init__(self, content_type: str, request_desc: str) -> None: + super().__init__(content_type, request_desc) + self.content_type = content_type + self.request_desc = request_desc + + +def _ensure_api_header(response: Response) -> None: + """ + Check the Content-Type header to ensure the response contains a Simple + API Response. + + Raises `_NotAPIContent` if the content type is not a valid content-type. + """ + content_type = response.headers.get("Content-Type", "Unknown") + + content_type_l = content_type.lower() + if content_type_l.startswith( + ( + "text/html", + "application/vnd.pypi.simple.v1+html", + "application/vnd.pypi.simple.v1+json", + ) + ): + return + + raise _NotAPIContent(content_type, response.request.method) + + +class _NotHTTP(Exception): + pass + + +def _ensure_api_response(url: str, session: PipSession) -> None: + """ + Send a HEAD request to the URL, and ensure the response contains a simple + API Response. + + Raises `_NotHTTP` if the URL is not available for a HEAD request, or + `_NotAPIContent` if the content type is not a valid content type. + """ + scheme, netloc, path, query, fragment = urllib.parse.urlsplit(url) + if scheme not in {"http", "https"}: + raise _NotHTTP() + + resp = session.head(url, allow_redirects=True) + raise_for_status(resp) + + _ensure_api_header(resp) + + +def _get_simple_response(url: str, session: PipSession) -> Response: + """Access an Simple API response with GET, and return the response. + + This consists of three parts: + + 1. If the URL looks suspiciously like an archive, send a HEAD first to + check the Content-Type is HTML or Simple API, to avoid downloading a + large file. Raise `_NotHTTP` if the content type cannot be determined, or + `_NotAPIContent` if it is not HTML or a Simple API. + 2. Actually perform the request. Raise HTTP exceptions on network failures. + 3. Check the Content-Type header to make sure we got a Simple API response, + and raise `_NotAPIContent` otherwise. + """ + if is_archive_file(Link(url).filename): + _ensure_api_response(url, session=session) + + logger.debug("Getting page %s", redact_auth_from_url(url)) + + resp = session.get( + url, + headers={ + "Accept": ", ".join( + [ + "application/vnd.pypi.simple.v1+json", + "application/vnd.pypi.simple.v1+html; q=0.1", + "text/html; q=0.01", + ] + ), + # We don't want to blindly returned cached data for + # /simple/, because authors generally expecting that + # twine upload && pip install will function, but if + # they've done a pip install in the last ~10 minutes + # it won't. Thus by setting this to zero we will not + # blindly use any cached data, however the benefit of + # using max-age=0 instead of no-cache, is that we will + # still support conditional requests, so we will still + # minimize traffic sent in cases where the page hasn't + # changed at all, we will just always incur the round + # trip for the conditional GET now instead of only + # once per 10 minutes. + # For more information, please see pypa/pip#5670. + "Cache-Control": "max-age=0", + }, + ) + raise_for_status(resp) + + # The check for archives above only works if the url ends with + # something that looks like an archive. However that is not a + # requirement of an url. Unless we issue a HEAD request on every + # url we cannot know ahead of time for sure if something is a + # Simple API response or not. However we can check after we've + # downloaded it. + _ensure_api_header(resp) + + logger.debug( + "Fetched page %s as %s", + redact_auth_from_url(url), + resp.headers.get("Content-Type", "Unknown"), + ) + + return resp + + +def _get_encoding_from_headers(headers: ResponseHeaders) -> Optional[str]: + """Determine if we have any encoding information in our headers.""" + if headers and "Content-Type" in headers: + m = email.message.Message() + m["content-type"] = headers["Content-Type"] + charset = m.get_param("charset") + if charset: + return str(charset) + return None + + +class CacheablePageContent: + def __init__(self, page: "IndexContent") -> None: + assert page.cache_link_parsing + self.page = page + + def __eq__(self, other: object) -> bool: + return isinstance(other, type(self)) and self.page.url == other.page.url + + def __hash__(self) -> int: + return hash(self.page.url) + + +class ParseLinks(Protocol): + def __call__(self, page: "IndexContent") -> Iterable[Link]: ... + + +def with_cached_index_content(fn: ParseLinks) -> ParseLinks: + """ + Given a function that parses an Iterable[Link] from an IndexContent, cache the + function's result (keyed by CacheablePageContent), unless the IndexContent + `page` has `page.cache_link_parsing == False`. + """ + + @functools.lru_cache(maxsize=None) + def wrapper(cacheable_page: CacheablePageContent) -> List[Link]: + return list(fn(cacheable_page.page)) + + @functools.wraps(fn) + def wrapper_wrapper(page: "IndexContent") -> List[Link]: + if page.cache_link_parsing: + return wrapper(CacheablePageContent(page)) + return list(fn(page)) + + return wrapper_wrapper + + +@with_cached_index_content +def parse_links(page: "IndexContent") -> Iterable[Link]: + """ + Parse a Simple API's Index Content, and yield its anchor elements as Link objects. + """ + + content_type_l = page.content_type.lower() + if content_type_l.startswith("application/vnd.pypi.simple.v1+json"): + data = json.loads(page.content) + for file in data.get("files", []): + link = Link.from_json(file, page.url) + if link is None: + continue + yield link + return + + parser = HTMLLinkParser(page.url) + encoding = page.encoding or "utf-8" + parser.feed(page.content.decode(encoding)) + + url = page.url + base_url = parser.base_url or url + for anchor in parser.anchors: + link = Link.from_element(anchor, page_url=url, base_url=base_url) + if link is None: + continue + yield link + + +@dataclass(frozen=True) +class IndexContent: + """Represents one response (or page), along with its URL. + + :param encoding: the encoding to decode the given content. + :param url: the URL from which the HTML was downloaded. + :param cache_link_parsing: whether links parsed from this page's url + should be cached. PyPI index urls should + have this set to False, for example. + """ + + content: bytes + content_type: str + encoding: Optional[str] + url: str + cache_link_parsing: bool = True + + def __str__(self) -> str: + return redact_auth_from_url(self.url) + + +class HTMLLinkParser(HTMLParser): + """ + HTMLParser that keeps the first base HREF and a list of all anchor + elements' attributes. + """ + + def __init__(self, url: str) -> None: + super().__init__(convert_charrefs=True) + + self.url: str = url + self.base_url: Optional[str] = None + self.anchors: List[Dict[str, Optional[str]]] = [] + + def handle_starttag(self, tag: str, attrs: List[Tuple[str, Optional[str]]]) -> None: + if tag == "base" and self.base_url is None: + href = self.get_href(attrs) + if href is not None: + self.base_url = href + elif tag == "a": + self.anchors.append(dict(attrs)) + + def get_href(self, attrs: List[Tuple[str, Optional[str]]]) -> Optional[str]: + for name, value in attrs: + if name == "href": + return value + return None + + +def _handle_get_simple_fail( + link: Link, + reason: Union[str, Exception], + meth: Optional[Callable[..., None]] = None, +) -> None: + if meth is None: + meth = logger.debug + meth("Could not fetch URL %s: %s - skipping", link, reason) + + +def _make_index_content( + response: Response, cache_link_parsing: bool = True +) -> IndexContent: + encoding = _get_encoding_from_headers(response.headers) + return IndexContent( + response.content, + response.headers["Content-Type"], + encoding=encoding, + url=response.url, + cache_link_parsing=cache_link_parsing, + ) + + +def _get_index_content(link: Link, *, session: PipSession) -> Optional["IndexContent"]: + url = link.url.split("#", 1)[0] + + # Check for VCS schemes that do not support lookup as web pages. + vcs_scheme = _match_vcs_scheme(url) + if vcs_scheme: + logger.warning( + "Cannot look at %s URL %s because it does not support lookup as web pages.", + vcs_scheme, + link, + ) + return None + + # Tack index.html onto file:// URLs that point to directories + scheme, _, path, _, _, _ = urllib.parse.urlparse(url) + if scheme == "file" and os.path.isdir(urllib.request.url2pathname(path)): + # add trailing slash if not present so urljoin doesn't trim + # final segment + if not url.endswith("/"): + url += "/" + # TODO: In the future, it would be nice if pip supported PEP 691 + # style responses in the file:// URLs, however there's no + # standard file extension for application/vnd.pypi.simple.v1+json + # so we'll need to come up with something on our own. + url = urllib.parse.urljoin(url, "index.html") + logger.debug(" file: URL is directory, getting %s", url) + + try: + resp = _get_simple_response(url, session=session) + except _NotHTTP: + logger.warning( + "Skipping page %s because it looks like an archive, and cannot " + "be checked by a HTTP HEAD request.", + link, + ) + except _NotAPIContent as exc: + logger.warning( + "Skipping page %s because the %s request got Content-Type: %s. " + "The only supported Content-Types are application/vnd.pypi.simple.v1+json, " + "application/vnd.pypi.simple.v1+html, and text/html", + link, + exc.request_desc, + exc.content_type, + ) + except NetworkConnectionError as exc: + _handle_get_simple_fail(link, exc) + except RetryError as exc: + _handle_get_simple_fail(link, exc) + except SSLError as exc: + reason = "There was a problem confirming the ssl certificate: " + reason += str(exc) + _handle_get_simple_fail(link, reason, meth=logger.info) + except requests.ConnectionError as exc: + _handle_get_simple_fail(link, f"connection error: {exc}") + except requests.Timeout: + _handle_get_simple_fail(link, "timed out") + else: + return _make_index_content(resp, cache_link_parsing=link.cache_link_parsing) + return None + + +class CollectedSources(NamedTuple): + find_links: Sequence[Optional[LinkSource]] + index_urls: Sequence[Optional[LinkSource]] + + +class LinkCollector: + """ + Responsible for collecting Link objects from all configured locations, + making network requests as needed. + + The class's main method is its collect_sources() method. + """ + + def __init__( + self, + session: PipSession, + search_scope: SearchScope, + ) -> None: + self.search_scope = search_scope + self.session = session + + @classmethod + def create( + cls, + session: PipSession, + options: Values, + suppress_no_index: bool = False, + ) -> "LinkCollector": + """ + :param session: The Session to use to make requests. + :param suppress_no_index: Whether to ignore the --no-index option + when constructing the SearchScope object. + """ + index_urls = [options.index_url] + options.extra_index_urls + if options.no_index and not suppress_no_index: + logger.debug( + "Ignoring indexes: %s", + ",".join(redact_auth_from_url(url) for url in index_urls), + ) + index_urls = [] + + # Make sure find_links is a list before passing to create(). + find_links = options.find_links or [] + + search_scope = SearchScope.create( + find_links=find_links, + index_urls=index_urls, + no_index=options.no_index, + ) + link_collector = LinkCollector( + session=session, + search_scope=search_scope, + ) + return link_collector + + @property + def find_links(self) -> List[str]: + return self.search_scope.find_links + + def fetch_response(self, location: Link) -> Optional[IndexContent]: + """ + Fetch an HTML page containing package links. + """ + return _get_index_content(location, session=self.session) + + def collect_sources( + self, + project_name: str, + candidates_from_page: CandidatesFromPage, + ) -> CollectedSources: + # The OrderedDict calls deduplicate sources by URL. + index_url_sources = collections.OrderedDict( + build_source( + loc, + candidates_from_page=candidates_from_page, + page_validator=self.session.is_secure_origin, + expand_dir=False, + cache_link_parsing=False, + project_name=project_name, + ) + for loc in self.search_scope.get_index_urls_locations(project_name) + ).values() + find_links_sources = collections.OrderedDict( + build_source( + loc, + candidates_from_page=candidates_from_page, + page_validator=self.session.is_secure_origin, + expand_dir=True, + cache_link_parsing=True, + project_name=project_name, + ) + for loc in self.find_links + ).values() + + if logger.isEnabledFor(logging.DEBUG): + lines = [ + f"* {s.link}" + for s in itertools.chain(find_links_sources, index_url_sources) + if s is not None and s.link is not None + ] + lines = [ + f"{len(lines)} location(s) to search " + f"for versions of {project_name}:" + ] + lines + logger.debug("\n".join(lines)) + + return CollectedSources( + find_links=list(find_links_sources), + index_urls=list(index_url_sources), + ) diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/index/package_finder.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/index/package_finder.py new file mode 100644 index 0000000..85628ee --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/index/package_finder.py @@ -0,0 +1,1029 @@ +"""Routines related to PyPI, indexes""" + +import enum +import functools +import itertools +import logging +import re +from dataclasses import dataclass +from typing import TYPE_CHECKING, FrozenSet, Iterable, List, Optional, Set, Tuple, Union + +from pip._vendor.packaging import specifiers +from pip._vendor.packaging.tags import Tag +from pip._vendor.packaging.utils import canonicalize_name +from pip._vendor.packaging.version import InvalidVersion, _BaseVersion +from pip._vendor.packaging.version import parse as parse_version + +from pip._internal.exceptions import ( + BestVersionAlreadyInstalled, + DistributionNotFound, + InvalidWheelFilename, + UnsupportedWheel, +) +from pip._internal.index.collector import LinkCollector, parse_links +from pip._internal.models.candidate import InstallationCandidate +from pip._internal.models.format_control import FormatControl +from pip._internal.models.link import Link +from pip._internal.models.search_scope import SearchScope +from pip._internal.models.selection_prefs import SelectionPreferences +from pip._internal.models.target_python import TargetPython +from pip._internal.models.wheel import Wheel +from pip._internal.req import InstallRequirement +from pip._internal.utils._log import getLogger +from pip._internal.utils.filetypes import WHEEL_EXTENSION +from pip._internal.utils.hashes import Hashes +from pip._internal.utils.logging import indent_log +from pip._internal.utils.misc import build_netloc +from pip._internal.utils.packaging import check_requires_python +from pip._internal.utils.unpacking import SUPPORTED_EXTENSIONS + +if TYPE_CHECKING: + from pip._vendor.typing_extensions import TypeGuard + +__all__ = ["FormatControl", "BestCandidateResult", "PackageFinder"] + + +logger = getLogger(__name__) + +BuildTag = Union[Tuple[()], Tuple[int, str]] +CandidateSortingKey = Tuple[int, int, int, _BaseVersion, Optional[int], BuildTag] + + +def _check_link_requires_python( + link: Link, + version_info: Tuple[int, int, int], + ignore_requires_python: bool = False, +) -> bool: + """ + Return whether the given Python version is compatible with a link's + "Requires-Python" value. + + :param version_info: A 3-tuple of ints representing the Python + major-minor-micro version to check. + :param ignore_requires_python: Whether to ignore the "Requires-Python" + value if the given Python version isn't compatible. + """ + try: + is_compatible = check_requires_python( + link.requires_python, + version_info=version_info, + ) + except specifiers.InvalidSpecifier: + logger.debug( + "Ignoring invalid Requires-Python (%r) for link: %s", + link.requires_python, + link, + ) + else: + if not is_compatible: + version = ".".join(map(str, version_info)) + if not ignore_requires_python: + logger.verbose( + "Link requires a different Python (%s not in: %r): %s", + version, + link.requires_python, + link, + ) + return False + + logger.debug( + "Ignoring failed Requires-Python check (%s not in: %r) for link: %s", + version, + link.requires_python, + link, + ) + + return True + + +class LinkType(enum.Enum): + candidate = enum.auto() + different_project = enum.auto() + yanked = enum.auto() + format_unsupported = enum.auto() + format_invalid = enum.auto() + platform_mismatch = enum.auto() + requires_python_mismatch = enum.auto() + + +class LinkEvaluator: + """ + Responsible for evaluating links for a particular project. + """ + + _py_version_re = re.compile(r"-py([123]\.?[0-9]?)$") + + # Don't include an allow_yanked default value to make sure each call + # site considers whether yanked releases are allowed. This also causes + # that decision to be made explicit in the calling code, which helps + # people when reading the code. + def __init__( + self, + project_name: str, + canonical_name: str, + formats: FrozenSet[str], + target_python: TargetPython, + allow_yanked: bool, + ignore_requires_python: Optional[bool] = None, + ) -> None: + """ + :param project_name: The user supplied package name. + :param canonical_name: The canonical package name. + :param formats: The formats allowed for this package. Should be a set + with 'binary' or 'source' or both in it. + :param target_python: The target Python interpreter to use when + evaluating link compatibility. This is used, for example, to + check wheel compatibility, as well as when checking the Python + version, e.g. the Python version embedded in a link filename + (or egg fragment) and against an HTML link's optional PEP 503 + "data-requires-python" attribute. + :param allow_yanked: Whether files marked as yanked (in the sense + of PEP 592) are permitted to be candidates for install. + :param ignore_requires_python: Whether to ignore incompatible + PEP 503 "data-requires-python" values in HTML links. Defaults + to False. + """ + if ignore_requires_python is None: + ignore_requires_python = False + + self._allow_yanked = allow_yanked + self._canonical_name = canonical_name + self._ignore_requires_python = ignore_requires_python + self._formats = formats + self._target_python = target_python + + self.project_name = project_name + + def evaluate_link(self, link: Link) -> Tuple[LinkType, str]: + """ + Determine whether a link is a candidate for installation. + + :return: A tuple (result, detail), where *result* is an enum + representing whether the evaluation found a candidate, or the reason + why one is not found. If a candidate is found, *detail* will be the + candidate's version string; if one is not found, it contains the + reason the link fails to qualify. + """ + version = None + if link.is_yanked and not self._allow_yanked: + reason = link.yanked_reason or "" + return (LinkType.yanked, f"yanked for reason: {reason}") + + if link.egg_fragment: + egg_info = link.egg_fragment + ext = link.ext + else: + egg_info, ext = link.splitext() + if not ext: + return (LinkType.format_unsupported, "not a file") + if ext not in SUPPORTED_EXTENSIONS: + return ( + LinkType.format_unsupported, + f"unsupported archive format: {ext}", + ) + if "binary" not in self._formats and ext == WHEEL_EXTENSION: + reason = f"No binaries permitted for {self.project_name}" + return (LinkType.format_unsupported, reason) + if "macosx10" in link.path and ext == ".zip": + return (LinkType.format_unsupported, "macosx10 one") + if ext == WHEEL_EXTENSION: + try: + wheel = Wheel(link.filename) + except InvalidWheelFilename: + return ( + LinkType.format_invalid, + "invalid wheel filename", + ) + if canonicalize_name(wheel.name) != self._canonical_name: + reason = f"wrong project name (not {self.project_name})" + return (LinkType.different_project, reason) + + supported_tags = self._target_python.get_unsorted_tags() + if not wheel.supported(supported_tags): + # Include the wheel's tags in the reason string to + # simplify troubleshooting compatibility issues. + file_tags = ", ".join(wheel.get_formatted_file_tags()) + reason = ( + f"none of the wheel's tags ({file_tags}) are compatible " + f"(run pip debug --verbose to show compatible tags)" + ) + return (LinkType.platform_mismatch, reason) + + version = wheel.version + + # This should be up by the self.ok_binary check, but see issue 2700. + if "source" not in self._formats and ext != WHEEL_EXTENSION: + reason = f"No sources permitted for {self.project_name}" + return (LinkType.format_unsupported, reason) + + if not version: + version = _extract_version_from_fragment( + egg_info, + self._canonical_name, + ) + if not version: + reason = f"Missing project version for {self.project_name}" + return (LinkType.format_invalid, reason) + + match = self._py_version_re.search(version) + if match: + version = version[: match.start()] + py_version = match.group(1) + if py_version != self._target_python.py_version: + return ( + LinkType.platform_mismatch, + "Python version is incorrect", + ) + + supports_python = _check_link_requires_python( + link, + version_info=self._target_python.py_version_info, + ignore_requires_python=self._ignore_requires_python, + ) + if not supports_python: + reason = f"{version} Requires-Python {link.requires_python}" + return (LinkType.requires_python_mismatch, reason) + + logger.debug("Found link %s, version: %s", link, version) + + return (LinkType.candidate, version) + + +def filter_unallowed_hashes( + candidates: List[InstallationCandidate], + hashes: Optional[Hashes], + project_name: str, +) -> List[InstallationCandidate]: + """ + Filter out candidates whose hashes aren't allowed, and return a new + list of candidates. + + If at least one candidate has an allowed hash, then all candidates with + either an allowed hash or no hash specified are returned. Otherwise, + the given candidates are returned. + + Including the candidates with no hash specified when there is a match + allows a warning to be logged if there is a more preferred candidate + with no hash specified. Returning all candidates in the case of no + matches lets pip report the hash of the candidate that would otherwise + have been installed (e.g. permitting the user to more easily update + their requirements file with the desired hash). + """ + if not hashes: + logger.debug( + "Given no hashes to check %s links for project %r: " + "discarding no candidates", + len(candidates), + project_name, + ) + # Make sure we're not returning back the given value. + return list(candidates) + + matches_or_no_digest = [] + # Collect the non-matches for logging purposes. + non_matches = [] + match_count = 0 + for candidate in candidates: + link = candidate.link + if not link.has_hash: + pass + elif link.is_hash_allowed(hashes=hashes): + match_count += 1 + else: + non_matches.append(candidate) + continue + + matches_or_no_digest.append(candidate) + + if match_count: + filtered = matches_or_no_digest + else: + # Make sure we're not returning back the given value. + filtered = list(candidates) + + if len(filtered) == len(candidates): + discard_message = "discarding no candidates" + else: + discard_message = "discarding {} non-matches:\n {}".format( + len(non_matches), + "\n ".join(str(candidate.link) for candidate in non_matches), + ) + + logger.debug( + "Checked %s links for project %r against %s hashes " + "(%s matches, %s no digest): %s", + len(candidates), + project_name, + hashes.digest_count, + match_count, + len(matches_or_no_digest) - match_count, + discard_message, + ) + + return filtered + + +@dataclass +class CandidatePreferences: + """ + Encapsulates some of the preferences for filtering and sorting + InstallationCandidate objects. + """ + + prefer_binary: bool = False + allow_all_prereleases: bool = False + + +@dataclass(frozen=True) +class BestCandidateResult: + """A collection of candidates, returned by `PackageFinder.find_best_candidate`. + + This class is only intended to be instantiated by CandidateEvaluator's + `compute_best_candidate()` method. + + :param all_candidates: A sequence of all available candidates found. + :param applicable_candidates: The applicable candidates. + :param best_candidate: The most preferred candidate found, or None + if no applicable candidates were found. + """ + + all_candidates: List[InstallationCandidate] + applicable_candidates: List[InstallationCandidate] + best_candidate: Optional[InstallationCandidate] + + def __post_init__(self) -> None: + assert set(self.applicable_candidates) <= set(self.all_candidates) + + if self.best_candidate is None: + assert not self.applicable_candidates + else: + assert self.best_candidate in self.applicable_candidates + + +class CandidateEvaluator: + """ + Responsible for filtering and sorting candidates for installation based + on what tags are valid. + """ + + @classmethod + def create( + cls, + project_name: str, + target_python: Optional[TargetPython] = None, + prefer_binary: bool = False, + allow_all_prereleases: bool = False, + specifier: Optional[specifiers.BaseSpecifier] = None, + hashes: Optional[Hashes] = None, + ) -> "CandidateEvaluator": + """Create a CandidateEvaluator object. + + :param target_python: The target Python interpreter to use when + checking compatibility. If None (the default), a TargetPython + object will be constructed from the running Python. + :param specifier: An optional object implementing `filter` + (e.g. `packaging.specifiers.SpecifierSet`) to filter applicable + versions. + :param hashes: An optional collection of allowed hashes. + """ + if target_python is None: + target_python = TargetPython() + if specifier is None: + specifier = specifiers.SpecifierSet() + + supported_tags = target_python.get_sorted_tags() + + return cls( + project_name=project_name, + supported_tags=supported_tags, + specifier=specifier, + prefer_binary=prefer_binary, + allow_all_prereleases=allow_all_prereleases, + hashes=hashes, + ) + + def __init__( + self, + project_name: str, + supported_tags: List[Tag], + specifier: specifiers.BaseSpecifier, + prefer_binary: bool = False, + allow_all_prereleases: bool = False, + hashes: Optional[Hashes] = None, + ) -> None: + """ + :param supported_tags: The PEP 425 tags supported by the target + Python in order of preference (most preferred first). + """ + self._allow_all_prereleases = allow_all_prereleases + self._hashes = hashes + self._prefer_binary = prefer_binary + self._project_name = project_name + self._specifier = specifier + self._supported_tags = supported_tags + # Since the index of the tag in the _supported_tags list is used + # as a priority, precompute a map from tag to index/priority to be + # used in wheel.find_most_preferred_tag. + self._wheel_tag_preferences = { + tag: idx for idx, tag in enumerate(supported_tags) + } + + def get_applicable_candidates( + self, + candidates: List[InstallationCandidate], + ) -> List[InstallationCandidate]: + """ + Return the applicable candidates from a list of candidates. + """ + # Using None infers from the specifier instead. + allow_prereleases = self._allow_all_prereleases or None + specifier = self._specifier + + # We turn the version object into a str here because otherwise + # when we're debundled but setuptools isn't, Python will see + # packaging.version.Version and + # pkg_resources._vendor.packaging.version.Version as different + # types. This way we'll use a str as a common data interchange + # format. If we stop using the pkg_resources provided specifier + # and start using our own, we can drop the cast to str(). + candidates_and_versions = [(c, str(c.version)) for c in candidates] + versions = set( + specifier.filter( + (v for _, v in candidates_and_versions), + prereleases=allow_prereleases, + ) + ) + + applicable_candidates = [c for c, v in candidates_and_versions if v in versions] + filtered_applicable_candidates = filter_unallowed_hashes( + candidates=applicable_candidates, + hashes=self._hashes, + project_name=self._project_name, + ) + + return sorted(filtered_applicable_candidates, key=self._sort_key) + + def _sort_key(self, candidate: InstallationCandidate) -> CandidateSortingKey: + """ + Function to pass as the `key` argument to a call to sorted() to sort + InstallationCandidates by preference. + + Returns a tuple such that tuples sorting as greater using Python's + default comparison operator are more preferred. + + The preference is as follows: + + First and foremost, candidates with allowed (matching) hashes are + always preferred over candidates without matching hashes. This is + because e.g. if the only candidate with an allowed hash is yanked, + we still want to use that candidate. + + Second, excepting hash considerations, candidates that have been + yanked (in the sense of PEP 592) are always less preferred than + candidates that haven't been yanked. Then: + + If not finding wheels, they are sorted by version only. + If finding wheels, then the sort order is by version, then: + 1. existing installs + 2. wheels ordered via Wheel.support_index_min(self._supported_tags) + 3. source archives + If prefer_binary was set, then all wheels are sorted above sources. + + Note: it was considered to embed this logic into the Link + comparison operators, but then different sdist links + with the same version, would have to be considered equal + """ + valid_tags = self._supported_tags + support_num = len(valid_tags) + build_tag: BuildTag = () + binary_preference = 0 + link = candidate.link + if link.is_wheel: + # can raise InvalidWheelFilename + wheel = Wheel(link.filename) + try: + pri = -( + wheel.find_most_preferred_tag( + valid_tags, self._wheel_tag_preferences + ) + ) + except ValueError: + raise UnsupportedWheel( + f"{wheel.filename} is not a supported wheel for this platform. It " + "can't be sorted." + ) + if self._prefer_binary: + binary_preference = 1 + if wheel.build_tag is not None: + match = re.match(r"^(\d+)(.*)$", wheel.build_tag) + assert match is not None, "guaranteed by filename validation" + build_tag_groups = match.groups() + build_tag = (int(build_tag_groups[0]), build_tag_groups[1]) + else: # sdist + pri = -(support_num) + has_allowed_hash = int(link.is_hash_allowed(self._hashes)) + yank_value = -1 * int(link.is_yanked) # -1 for yanked. + return ( + has_allowed_hash, + yank_value, + binary_preference, + candidate.version, + pri, + build_tag, + ) + + def sort_best_candidate( + self, + candidates: List[InstallationCandidate], + ) -> Optional[InstallationCandidate]: + """ + Return the best candidate per the instance's sort order, or None if + no candidate is acceptable. + """ + if not candidates: + return None + best_candidate = max(candidates, key=self._sort_key) + return best_candidate + + def compute_best_candidate( + self, + candidates: List[InstallationCandidate], + ) -> BestCandidateResult: + """ + Compute and return a `BestCandidateResult` instance. + """ + applicable_candidates = self.get_applicable_candidates(candidates) + + best_candidate = self.sort_best_candidate(applicable_candidates) + + return BestCandidateResult( + candidates, + applicable_candidates=applicable_candidates, + best_candidate=best_candidate, + ) + + +class PackageFinder: + """This finds packages. + + This is meant to match easy_install's technique for looking for + packages, by reading pages and looking for appropriate links. + """ + + def __init__( + self, + link_collector: LinkCollector, + target_python: TargetPython, + allow_yanked: bool, + format_control: Optional[FormatControl] = None, + candidate_prefs: Optional[CandidatePreferences] = None, + ignore_requires_python: Optional[bool] = None, + ) -> None: + """ + This constructor is primarily meant to be used by the create() class + method and from tests. + + :param format_control: A FormatControl object, used to control + the selection of source packages / binary packages when consulting + the index and links. + :param candidate_prefs: Options to use when creating a + CandidateEvaluator object. + """ + if candidate_prefs is None: + candidate_prefs = CandidatePreferences() + + format_control = format_control or FormatControl(set(), set()) + + self._allow_yanked = allow_yanked + self._candidate_prefs = candidate_prefs + self._ignore_requires_python = ignore_requires_python + self._link_collector = link_collector + self._target_python = target_python + + self.format_control = format_control + + # These are boring links that have already been logged somehow. + self._logged_links: Set[Tuple[Link, LinkType, str]] = set() + + # Don't include an allow_yanked default value to make sure each call + # site considers whether yanked releases are allowed. This also causes + # that decision to be made explicit in the calling code, which helps + # people when reading the code. + @classmethod + def create( + cls, + link_collector: LinkCollector, + selection_prefs: SelectionPreferences, + target_python: Optional[TargetPython] = None, + ) -> "PackageFinder": + """Create a PackageFinder. + + :param selection_prefs: The candidate selection preferences, as a + SelectionPreferences object. + :param target_python: The target Python interpreter to use when + checking compatibility. If None (the default), a TargetPython + object will be constructed from the running Python. + """ + if target_python is None: + target_python = TargetPython() + + candidate_prefs = CandidatePreferences( + prefer_binary=selection_prefs.prefer_binary, + allow_all_prereleases=selection_prefs.allow_all_prereleases, + ) + + return cls( + candidate_prefs=candidate_prefs, + link_collector=link_collector, + target_python=target_python, + allow_yanked=selection_prefs.allow_yanked, + format_control=selection_prefs.format_control, + ignore_requires_python=selection_prefs.ignore_requires_python, + ) + + @property + def target_python(self) -> TargetPython: + return self._target_python + + @property + def search_scope(self) -> SearchScope: + return self._link_collector.search_scope + + @search_scope.setter + def search_scope(self, search_scope: SearchScope) -> None: + self._link_collector.search_scope = search_scope + + @property + def find_links(self) -> List[str]: + return self._link_collector.find_links + + @property + def index_urls(self) -> List[str]: + return self.search_scope.index_urls + + @property + def proxy(self) -> Optional[str]: + return self._link_collector.session.pip_proxy + + @property + def trusted_hosts(self) -> Iterable[str]: + for host_port in self._link_collector.session.pip_trusted_origins: + yield build_netloc(*host_port) + + @property + def custom_cert(self) -> Optional[str]: + # session.verify is either a boolean (use default bundle/no SSL + # verification) or a string path to a custom CA bundle to use. We only + # care about the latter. + verify = self._link_collector.session.verify + return verify if isinstance(verify, str) else None + + @property + def client_cert(self) -> Optional[str]: + cert = self._link_collector.session.cert + assert not isinstance(cert, tuple), "pip only supports PEM client certs" + return cert + + @property + def allow_all_prereleases(self) -> bool: + return self._candidate_prefs.allow_all_prereleases + + def set_allow_all_prereleases(self) -> None: + self._candidate_prefs.allow_all_prereleases = True + + @property + def prefer_binary(self) -> bool: + return self._candidate_prefs.prefer_binary + + def set_prefer_binary(self) -> None: + self._candidate_prefs.prefer_binary = True + + def requires_python_skipped_reasons(self) -> List[str]: + reasons = { + detail + for _, result, detail in self._logged_links + if result == LinkType.requires_python_mismatch + } + return sorted(reasons) + + def make_link_evaluator(self, project_name: str) -> LinkEvaluator: + canonical_name = canonicalize_name(project_name) + formats = self.format_control.get_allowed_formats(canonical_name) + + return LinkEvaluator( + project_name=project_name, + canonical_name=canonical_name, + formats=formats, + target_python=self._target_python, + allow_yanked=self._allow_yanked, + ignore_requires_python=self._ignore_requires_python, + ) + + def _sort_links(self, links: Iterable[Link]) -> List[Link]: + """ + Returns elements of links in order, non-egg links first, egg links + second, while eliminating duplicates + """ + eggs, no_eggs = [], [] + seen: Set[Link] = set() + for link in links: + if link not in seen: + seen.add(link) + if link.egg_fragment: + eggs.append(link) + else: + no_eggs.append(link) + return no_eggs + eggs + + def _log_skipped_link(self, link: Link, result: LinkType, detail: str) -> None: + # This is a hot method so don't waste time hashing links unless we're + # actually going to log 'em. + if not logger.isEnabledFor(logging.DEBUG): + return + + entry = (link, result, detail) + if entry not in self._logged_links: + # Put the link at the end so the reason is more visible and because + # the link string is usually very long. + logger.debug("Skipping link: %s: %s", detail, link) + self._logged_links.add(entry) + + def get_install_candidate( + self, link_evaluator: LinkEvaluator, link: Link + ) -> Optional[InstallationCandidate]: + """ + If the link is a candidate for install, convert it to an + InstallationCandidate and return it. Otherwise, return None. + """ + result, detail = link_evaluator.evaluate_link(link) + if result != LinkType.candidate: + self._log_skipped_link(link, result, detail) + return None + + try: + return InstallationCandidate( + name=link_evaluator.project_name, + link=link, + version=detail, + ) + except InvalidVersion: + return None + + def evaluate_links( + self, link_evaluator: LinkEvaluator, links: Iterable[Link] + ) -> List[InstallationCandidate]: + """ + Convert links that are candidates to InstallationCandidate objects. + """ + candidates = [] + for link in self._sort_links(links): + candidate = self.get_install_candidate(link_evaluator, link) + if candidate is not None: + candidates.append(candidate) + + return candidates + + def process_project_url( + self, project_url: Link, link_evaluator: LinkEvaluator + ) -> List[InstallationCandidate]: + logger.debug( + "Fetching project page and analyzing links: %s", + project_url, + ) + index_response = self._link_collector.fetch_response(project_url) + if index_response is None: + return [] + + page_links = list(parse_links(index_response)) + + with indent_log(): + package_links = self.evaluate_links( + link_evaluator, + links=page_links, + ) + + return package_links + + @functools.lru_cache(maxsize=None) + def find_all_candidates(self, project_name: str) -> List[InstallationCandidate]: + """Find all available InstallationCandidate for project_name + + This checks index_urls and find_links. + All versions found are returned as an InstallationCandidate list. + + See LinkEvaluator.evaluate_link() for details on which files + are accepted. + """ + link_evaluator = self.make_link_evaluator(project_name) + + collected_sources = self._link_collector.collect_sources( + project_name=project_name, + candidates_from_page=functools.partial( + self.process_project_url, + link_evaluator=link_evaluator, + ), + ) + + page_candidates_it = itertools.chain.from_iterable( + source.page_candidates() + for sources in collected_sources + for source in sources + if source is not None + ) + page_candidates = list(page_candidates_it) + + file_links_it = itertools.chain.from_iterable( + source.file_links() + for sources in collected_sources + for source in sources + if source is not None + ) + file_candidates = self.evaluate_links( + link_evaluator, + sorted(file_links_it, reverse=True), + ) + + if logger.isEnabledFor(logging.DEBUG) and file_candidates: + paths = [] + for candidate in file_candidates: + assert candidate.link.url # we need to have a URL + try: + paths.append(candidate.link.file_path) + except Exception: + paths.append(candidate.link.url) # it's not a local file + + logger.debug("Local files found: %s", ", ".join(paths)) + + # This is an intentional priority ordering + return file_candidates + page_candidates + + def make_candidate_evaluator( + self, + project_name: str, + specifier: Optional[specifiers.BaseSpecifier] = None, + hashes: Optional[Hashes] = None, + ) -> CandidateEvaluator: + """Create a CandidateEvaluator object to use.""" + candidate_prefs = self._candidate_prefs + return CandidateEvaluator.create( + project_name=project_name, + target_python=self._target_python, + prefer_binary=candidate_prefs.prefer_binary, + allow_all_prereleases=candidate_prefs.allow_all_prereleases, + specifier=specifier, + hashes=hashes, + ) + + @functools.lru_cache(maxsize=None) + def find_best_candidate( + self, + project_name: str, + specifier: Optional[specifiers.BaseSpecifier] = None, + hashes: Optional[Hashes] = None, + ) -> BestCandidateResult: + """Find matches for the given project and specifier. + + :param specifier: An optional object implementing `filter` + (e.g. `packaging.specifiers.SpecifierSet`) to filter applicable + versions. + + :return: A `BestCandidateResult` instance. + """ + candidates = self.find_all_candidates(project_name) + candidate_evaluator = self.make_candidate_evaluator( + project_name=project_name, + specifier=specifier, + hashes=hashes, + ) + return candidate_evaluator.compute_best_candidate(candidates) + + def find_requirement( + self, req: InstallRequirement, upgrade: bool + ) -> Optional[InstallationCandidate]: + """Try to find a Link matching req + + Expects req, an InstallRequirement and upgrade, a boolean + Returns a InstallationCandidate if found, + Raises DistributionNotFound or BestVersionAlreadyInstalled otherwise + """ + hashes = req.hashes(trust_internet=False) + best_candidate_result = self.find_best_candidate( + req.name, + specifier=req.specifier, + hashes=hashes, + ) + best_candidate = best_candidate_result.best_candidate + + installed_version: Optional[_BaseVersion] = None + if req.satisfied_by is not None: + installed_version = req.satisfied_by.version + + def _format_versions(cand_iter: Iterable[InstallationCandidate]) -> str: + # This repeated parse_version and str() conversion is needed to + # handle different vendoring sources from pip and pkg_resources. + # If we stop using the pkg_resources provided specifier and start + # using our own, we can drop the cast to str(). + return ( + ", ".join( + sorted( + {str(c.version) for c in cand_iter}, + key=parse_version, + ) + ) + or "none" + ) + + if installed_version is None and best_candidate is None: + logger.critical( + "Could not find a version that satisfies the requirement %s " + "(from versions: %s)", + req, + _format_versions(best_candidate_result.all_candidates), + ) + + raise DistributionNotFound(f"No matching distribution found for {req}") + + def _should_install_candidate( + candidate: Optional[InstallationCandidate], + ) -> "TypeGuard[InstallationCandidate]": + if installed_version is None: + return True + if best_candidate is None: + return False + return best_candidate.version > installed_version + + if not upgrade and installed_version is not None: + if _should_install_candidate(best_candidate): + logger.debug( + "Existing installed version (%s) satisfies requirement " + "(most up-to-date version is %s)", + installed_version, + best_candidate.version, + ) + else: + logger.debug( + "Existing installed version (%s) is most up-to-date and " + "satisfies requirement", + installed_version, + ) + return None + + if _should_install_candidate(best_candidate): + logger.debug( + "Using version %s (newest of versions: %s)", + best_candidate.version, + _format_versions(best_candidate_result.applicable_candidates), + ) + return best_candidate + + # We have an existing version, and its the best version + logger.debug( + "Installed version (%s) is most up-to-date (past versions: %s)", + installed_version, + _format_versions(best_candidate_result.applicable_candidates), + ) + raise BestVersionAlreadyInstalled + + +def _find_name_version_sep(fragment: str, canonical_name: str) -> int: + """Find the separator's index based on the package's canonical name. + + :param fragment: A + filename "fragment" (stem) or + egg fragment. + :param canonical_name: The package's canonical name. + + This function is needed since the canonicalized name does not necessarily + have the same length as the egg info's name part. An example:: + + >>> fragment = 'foo__bar-1.0' + >>> canonical_name = 'foo-bar' + >>> _find_name_version_sep(fragment, canonical_name) + 8 + """ + # Project name and version must be separated by one single dash. Find all + # occurrences of dashes; if the string in front of it matches the canonical + # name, this is the one separating the name and version parts. + for i, c in enumerate(fragment): + if c != "-": + continue + if canonicalize_name(fragment[:i]) == canonical_name: + return i + raise ValueError(f"{fragment} does not match {canonical_name}") + + +def _extract_version_from_fragment(fragment: str, canonical_name: str) -> Optional[str]: + """Parse the version string from a + filename + "fragment" (stem) or egg fragment. + + :param fragment: The string to parse. E.g. foo-2.1 + :param canonical_name: The canonicalized name of the package this + belongs to. + """ + try: + version_start = _find_name_version_sep(fragment, canonical_name) + 1 + except ValueError: + return None + version = fragment[version_start:] + if not version: + return None + return version diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/index/sources.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/index/sources.py new file mode 100644 index 0000000..3dafb30 --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/index/sources.py @@ -0,0 +1,284 @@ +import logging +import mimetypes +import os +from collections import defaultdict +from typing import Callable, Dict, Iterable, List, Optional, Tuple + +from pip._vendor.packaging.utils import ( + InvalidSdistFilename, + InvalidWheelFilename, + canonicalize_name, + parse_sdist_filename, + parse_wheel_filename, +) + +from pip._internal.models.candidate import InstallationCandidate +from pip._internal.models.link import Link +from pip._internal.utils.urls import path_to_url, url_to_path +from pip._internal.vcs import is_url + +logger = logging.getLogger(__name__) + +FoundCandidates = Iterable[InstallationCandidate] +FoundLinks = Iterable[Link] +CandidatesFromPage = Callable[[Link], Iterable[InstallationCandidate]] +PageValidator = Callable[[Link], bool] + + +class LinkSource: + @property + def link(self) -> Optional[Link]: + """Returns the underlying link, if there's one.""" + raise NotImplementedError() + + def page_candidates(self) -> FoundCandidates: + """Candidates found by parsing an archive listing HTML file.""" + raise NotImplementedError() + + def file_links(self) -> FoundLinks: + """Links found by specifying archives directly.""" + raise NotImplementedError() + + +def _is_html_file(file_url: str) -> bool: + return mimetypes.guess_type(file_url, strict=False)[0] == "text/html" + + +class _FlatDirectoryToUrls: + """Scans directory and caches results""" + + def __init__(self, path: str) -> None: + self._path = path + self._page_candidates: List[str] = [] + self._project_name_to_urls: Dict[str, List[str]] = defaultdict(list) + self._scanned_directory = False + + def _scan_directory(self) -> None: + """Scans directory once and populates both page_candidates + and project_name_to_urls at the same time + """ + for entry in os.scandir(self._path): + url = path_to_url(entry.path) + if _is_html_file(url): + self._page_candidates.append(url) + continue + + # File must have a valid wheel or sdist name, + # otherwise not worth considering as a package + try: + project_filename = parse_wheel_filename(entry.name)[0] + except InvalidWheelFilename: + try: + project_filename = parse_sdist_filename(entry.name)[0] + except InvalidSdistFilename: + continue + + self._project_name_to_urls[project_filename].append(url) + self._scanned_directory = True + + @property + def page_candidates(self) -> List[str]: + if not self._scanned_directory: + self._scan_directory() + + return self._page_candidates + + @property + def project_name_to_urls(self) -> Dict[str, List[str]]: + if not self._scanned_directory: + self._scan_directory() + + return self._project_name_to_urls + + +class _FlatDirectorySource(LinkSource): + """Link source specified by ``--find-links=``. + + This looks the content of the directory, and returns: + + * ``page_candidates``: Links listed on each HTML file in the directory. + * ``file_candidates``: Archives in the directory. + """ + + _paths_to_urls: Dict[str, _FlatDirectoryToUrls] = {} + + def __init__( + self, + candidates_from_page: CandidatesFromPage, + path: str, + project_name: str, + ) -> None: + self._candidates_from_page = candidates_from_page + self._project_name = canonicalize_name(project_name) + + # Get existing instance of _FlatDirectoryToUrls if it exists + if path in self._paths_to_urls: + self._path_to_urls = self._paths_to_urls[path] + else: + self._path_to_urls = _FlatDirectoryToUrls(path=path) + self._paths_to_urls[path] = self._path_to_urls + + @property + def link(self) -> Optional[Link]: + return None + + def page_candidates(self) -> FoundCandidates: + for url in self._path_to_urls.page_candidates: + yield from self._candidates_from_page(Link(url)) + + def file_links(self) -> FoundLinks: + for url in self._path_to_urls.project_name_to_urls[self._project_name]: + yield Link(url) + + +class _LocalFileSource(LinkSource): + """``--find-links=`` or ``--[extra-]index-url=``. + + If a URL is supplied, it must be a ``file:`` URL. If a path is supplied to + the option, it is converted to a URL first. This returns: + + * ``page_candidates``: Links listed on an HTML file. + * ``file_candidates``: The non-HTML file. + """ + + def __init__( + self, + candidates_from_page: CandidatesFromPage, + link: Link, + ) -> None: + self._candidates_from_page = candidates_from_page + self._link = link + + @property + def link(self) -> Optional[Link]: + return self._link + + def page_candidates(self) -> FoundCandidates: + if not _is_html_file(self._link.url): + return + yield from self._candidates_from_page(self._link) + + def file_links(self) -> FoundLinks: + if _is_html_file(self._link.url): + return + yield self._link + + +class _RemoteFileSource(LinkSource): + """``--find-links=`` or ``--[extra-]index-url=``. + + This returns: + + * ``page_candidates``: Links listed on an HTML file. + * ``file_candidates``: The non-HTML file. + """ + + def __init__( + self, + candidates_from_page: CandidatesFromPage, + page_validator: PageValidator, + link: Link, + ) -> None: + self._candidates_from_page = candidates_from_page + self._page_validator = page_validator + self._link = link + + @property + def link(self) -> Optional[Link]: + return self._link + + def page_candidates(self) -> FoundCandidates: + if not self._page_validator(self._link): + return + yield from self._candidates_from_page(self._link) + + def file_links(self) -> FoundLinks: + yield self._link + + +class _IndexDirectorySource(LinkSource): + """``--[extra-]index-url=``. + + This is treated like a remote URL; ``candidates_from_page`` contains logic + for this by appending ``index.html`` to the link. + """ + + def __init__( + self, + candidates_from_page: CandidatesFromPage, + link: Link, + ) -> None: + self._candidates_from_page = candidates_from_page + self._link = link + + @property + def link(self) -> Optional[Link]: + return self._link + + def page_candidates(self) -> FoundCandidates: + yield from self._candidates_from_page(self._link) + + def file_links(self) -> FoundLinks: + return () + + +def build_source( + location: str, + *, + candidates_from_page: CandidatesFromPage, + page_validator: PageValidator, + expand_dir: bool, + cache_link_parsing: bool, + project_name: str, +) -> Tuple[Optional[str], Optional[LinkSource]]: + path: Optional[str] = None + url: Optional[str] = None + if os.path.exists(location): # Is a local path. + url = path_to_url(location) + path = location + elif location.startswith("file:"): # A file: URL. + url = location + path = url_to_path(location) + elif is_url(location): + url = location + + if url is None: + msg = ( + "Location '%s' is ignored: " + "it is either a non-existing path or lacks a specific scheme." + ) + logger.warning(msg, location) + return (None, None) + + if path is None: + source: LinkSource = _RemoteFileSource( + candidates_from_page=candidates_from_page, + page_validator=page_validator, + link=Link(url, cache_link_parsing=cache_link_parsing), + ) + return (url, source) + + if os.path.isdir(path): + if expand_dir: + source = _FlatDirectorySource( + candidates_from_page=candidates_from_page, + path=path, + project_name=project_name, + ) + else: + source = _IndexDirectorySource( + candidates_from_page=candidates_from_page, + link=Link(url, cache_link_parsing=cache_link_parsing), + ) + return (url, source) + elif os.path.isfile(path): + source = _LocalFileSource( + candidates_from_page=candidates_from_page, + link=Link(url, cache_link_parsing=cache_link_parsing), + ) + return (url, source) + logger.warning( + "Location '%s' is ignored: it is neither a file nor a directory.", + location, + ) + return (url, None) diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/locations/__init__.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/locations/__init__.py new file mode 100644 index 0000000..32382be --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/locations/__init__.py @@ -0,0 +1,456 @@ +import functools +import logging +import os +import pathlib +import sys +import sysconfig +from typing import Any, Dict, Generator, Optional, Tuple + +from pip._internal.models.scheme import SCHEME_KEYS, Scheme +from pip._internal.utils.compat import WINDOWS +from pip._internal.utils.deprecation import deprecated +from pip._internal.utils.virtualenv import running_under_virtualenv + +from . import _sysconfig +from .base import ( + USER_CACHE_DIR, + get_major_minor_version, + get_src_prefix, + is_osx_framework, + site_packages, + user_site, +) + +__all__ = [ + "USER_CACHE_DIR", + "get_bin_prefix", + "get_bin_user", + "get_major_minor_version", + "get_platlib", + "get_purelib", + "get_scheme", + "get_src_prefix", + "site_packages", + "user_site", +] + + +logger = logging.getLogger(__name__) + + +_PLATLIBDIR: str = getattr(sys, "platlibdir", "lib") + +_USE_SYSCONFIG_DEFAULT = sys.version_info >= (3, 10) + + +def _should_use_sysconfig() -> bool: + """This function determines the value of _USE_SYSCONFIG. + + By default, pip uses sysconfig on Python 3.10+. + But Python distributors can override this decision by setting: + sysconfig._PIP_USE_SYSCONFIG = True / False + Rationale in https://github.com/pypa/pip/issues/10647 + + This is a function for testability, but should be constant during any one + run. + """ + return bool(getattr(sysconfig, "_PIP_USE_SYSCONFIG", _USE_SYSCONFIG_DEFAULT)) + + +_USE_SYSCONFIG = _should_use_sysconfig() + +if not _USE_SYSCONFIG: + # Import distutils lazily to avoid deprecation warnings, + # but import it soon enough that it is in memory and available during + # a pip reinstall. + from . import _distutils + +# Be noisy about incompatibilities if this platforms "should" be using +# sysconfig, but is explicitly opting out and using distutils instead. +if _USE_SYSCONFIG_DEFAULT and not _USE_SYSCONFIG: + _MISMATCH_LEVEL = logging.WARNING +else: + _MISMATCH_LEVEL = logging.DEBUG + + +def _looks_like_bpo_44860() -> bool: + """The resolution to bpo-44860 will change this incorrect platlib. + + See . + """ + from distutils.command.install import INSTALL_SCHEMES + + try: + unix_user_platlib = INSTALL_SCHEMES["unix_user"]["platlib"] + except KeyError: + return False + return unix_user_platlib == "$usersite" + + +def _looks_like_red_hat_patched_platlib_purelib(scheme: Dict[str, str]) -> bool: + platlib = scheme["platlib"] + if "/$platlibdir/" in platlib: + platlib = platlib.replace("/$platlibdir/", f"/{_PLATLIBDIR}/") + if "/lib64/" not in platlib: + return False + unpatched = platlib.replace("/lib64/", "/lib/") + return unpatched.replace("$platbase/", "$base/") == scheme["purelib"] + + +@functools.lru_cache(maxsize=None) +def _looks_like_red_hat_lib() -> bool: + """Red Hat patches platlib in unix_prefix and unix_home, but not purelib. + + This is the only way I can see to tell a Red Hat-patched Python. + """ + from distutils.command.install import INSTALL_SCHEMES + + return all( + k in INSTALL_SCHEMES + and _looks_like_red_hat_patched_platlib_purelib(INSTALL_SCHEMES[k]) + for k in ("unix_prefix", "unix_home") + ) + + +@functools.lru_cache(maxsize=None) +def _looks_like_debian_scheme() -> bool: + """Debian adds two additional schemes.""" + from distutils.command.install import INSTALL_SCHEMES + + return "deb_system" in INSTALL_SCHEMES and "unix_local" in INSTALL_SCHEMES + + +@functools.lru_cache(maxsize=None) +def _looks_like_red_hat_scheme() -> bool: + """Red Hat patches ``sys.prefix`` and ``sys.exec_prefix``. + + Red Hat's ``00251-change-user-install-location.patch`` changes the install + command's ``prefix`` and ``exec_prefix`` to append ``"/local"``. This is + (fortunately?) done quite unconditionally, so we create a default command + object without any configuration to detect this. + """ + from distutils.command.install import install + from distutils.dist import Distribution + + cmd: Any = install(Distribution()) + cmd.finalize_options() + return ( + cmd.exec_prefix == f"{os.path.normpath(sys.exec_prefix)}/local" + and cmd.prefix == f"{os.path.normpath(sys.prefix)}/local" + ) + + +@functools.lru_cache(maxsize=None) +def _looks_like_slackware_scheme() -> bool: + """Slackware patches sysconfig but fails to patch distutils and site. + + Slackware changes sysconfig's user scheme to use ``"lib64"`` for the lib + path, but does not do the same to the site module. + """ + if user_site is None: # User-site not available. + return False + try: + paths = sysconfig.get_paths(scheme="posix_user", expand=False) + except KeyError: # User-site not available. + return False + return "/lib64/" in paths["purelib"] and "/lib64/" not in user_site + + +@functools.lru_cache(maxsize=None) +def _looks_like_msys2_mingw_scheme() -> bool: + """MSYS2 patches distutils and sysconfig to use a UNIX-like scheme. + + However, MSYS2 incorrectly patches sysconfig ``nt`` scheme. The fix is + likely going to be included in their 3.10 release, so we ignore the warning. + See msys2/MINGW-packages#9319. + + MSYS2 MINGW's patch uses lowercase ``"lib"`` instead of the usual uppercase, + and is missing the final ``"site-packages"``. + """ + paths = sysconfig.get_paths("nt", expand=False) + return all( + "Lib" not in p and "lib" in p and not p.endswith("site-packages") + for p in (paths[key] for key in ("platlib", "purelib")) + ) + + +def _fix_abiflags(parts: Tuple[str]) -> Generator[str, None, None]: + ldversion = sysconfig.get_config_var("LDVERSION") + abiflags = getattr(sys, "abiflags", None) + + # LDVERSION does not end with sys.abiflags. Just return the path unchanged. + if not ldversion or not abiflags or not ldversion.endswith(abiflags): + yield from parts + return + + # Strip sys.abiflags from LDVERSION-based path components. + for part in parts: + if part.endswith(ldversion): + part = part[: (0 - len(abiflags))] + yield part + + +@functools.lru_cache(maxsize=None) +def _warn_mismatched(old: pathlib.Path, new: pathlib.Path, *, key: str) -> None: + issue_url = "https://github.com/pypa/pip/issues/10151" + message = ( + "Value for %s does not match. Please report this to <%s>" + "\ndistutils: %s" + "\nsysconfig: %s" + ) + logger.log(_MISMATCH_LEVEL, message, key, issue_url, old, new) + + +def _warn_if_mismatch(old: pathlib.Path, new: pathlib.Path, *, key: str) -> bool: + if old == new: + return False + _warn_mismatched(old, new, key=key) + return True + + +@functools.lru_cache(maxsize=None) +def _log_context( + *, + user: bool = False, + home: Optional[str] = None, + root: Optional[str] = None, + prefix: Optional[str] = None, +) -> None: + parts = [ + "Additional context:", + "user = %r", + "home = %r", + "root = %r", + "prefix = %r", + ] + + logger.log(_MISMATCH_LEVEL, "\n".join(parts), user, home, root, prefix) + + +def get_scheme( + dist_name: str, + user: bool = False, + home: Optional[str] = None, + root: Optional[str] = None, + isolated: bool = False, + prefix: Optional[str] = None, +) -> Scheme: + new = _sysconfig.get_scheme( + dist_name, + user=user, + home=home, + root=root, + isolated=isolated, + prefix=prefix, + ) + if _USE_SYSCONFIG: + return new + + old = _distutils.get_scheme( + dist_name, + user=user, + home=home, + root=root, + isolated=isolated, + prefix=prefix, + ) + + warning_contexts = [] + for k in SCHEME_KEYS: + old_v = pathlib.Path(getattr(old, k)) + new_v = pathlib.Path(getattr(new, k)) + + if old_v == new_v: + continue + + # distutils incorrectly put PyPy packages under ``site-packages/python`` + # in the ``posix_home`` scheme, but PyPy devs said they expect the + # directory name to be ``pypy`` instead. So we treat this as a bug fix + # and not warn about it. See bpo-43307 and python/cpython#24628. + skip_pypy_special_case = ( + sys.implementation.name == "pypy" + and home is not None + and k in ("platlib", "purelib") + and old_v.parent == new_v.parent + and old_v.name.startswith("python") + and new_v.name.startswith("pypy") + ) + if skip_pypy_special_case: + continue + + # sysconfig's ``osx_framework_user`` does not include ``pythonX.Y`` in + # the ``include`` value, but distutils's ``headers`` does. We'll let + # CPython decide whether this is a bug or feature. See bpo-43948. + skip_osx_framework_user_special_case = ( + user + and is_osx_framework() + and k == "headers" + and old_v.parent.parent == new_v.parent + and old_v.parent.name.startswith("python") + ) + if skip_osx_framework_user_special_case: + continue + + # On Red Hat and derived Linux distributions, distutils is patched to + # use "lib64" instead of "lib" for platlib. + if k == "platlib" and _looks_like_red_hat_lib(): + continue + + # On Python 3.9+, sysconfig's posix_user scheme sets platlib against + # sys.platlibdir, but distutils's unix_user incorrectly coninutes + # using the same $usersite for both platlib and purelib. This creates a + # mismatch when sys.platlibdir is not "lib". + skip_bpo_44860 = ( + user + and k == "platlib" + and not WINDOWS + and sys.version_info >= (3, 9) + and _PLATLIBDIR != "lib" + and _looks_like_bpo_44860() + ) + if skip_bpo_44860: + continue + + # Slackware incorrectly patches posix_user to use lib64 instead of lib, + # but not usersite to match the location. + skip_slackware_user_scheme = ( + user + and k in ("platlib", "purelib") + and not WINDOWS + and _looks_like_slackware_scheme() + ) + if skip_slackware_user_scheme: + continue + + # Both Debian and Red Hat patch Python to place the system site under + # /usr/local instead of /usr. Debian also places lib in dist-packages + # instead of site-packages, but the /usr/local check should cover it. + skip_linux_system_special_case = ( + not (user or home or prefix or running_under_virtualenv()) + and old_v.parts[1:3] == ("usr", "local") + and len(new_v.parts) > 1 + and new_v.parts[1] == "usr" + and (len(new_v.parts) < 3 or new_v.parts[2] != "local") + and (_looks_like_red_hat_scheme() or _looks_like_debian_scheme()) + ) + if skip_linux_system_special_case: + continue + + # MSYS2 MINGW's sysconfig patch does not include the "site-packages" + # part of the path. This is incorrect and will be fixed in MSYS. + skip_msys2_mingw_bug = ( + WINDOWS and k in ("platlib", "purelib") and _looks_like_msys2_mingw_scheme() + ) + if skip_msys2_mingw_bug: + continue + + # CPython's POSIX install script invokes pip (via ensurepip) against the + # interpreter located in the source tree, not the install site. This + # triggers special logic in sysconfig that's not present in distutils. + # https://github.com/python/cpython/blob/8c21941ddaf/Lib/sysconfig.py#L178-L194 + skip_cpython_build = ( + sysconfig.is_python_build(check_home=True) + and not WINDOWS + and k in ("headers", "include", "platinclude") + ) + if skip_cpython_build: + continue + + warning_contexts.append((old_v, new_v, f"scheme.{k}")) + + if not warning_contexts: + return old + + # Check if this path mismatch is caused by distutils config files. Those + # files will no longer work once we switch to sysconfig, so this raises a + # deprecation message for them. + default_old = _distutils.distutils_scheme( + dist_name, + user, + home, + root, + isolated, + prefix, + ignore_config_files=True, + ) + if any(default_old[k] != getattr(old, k) for k in SCHEME_KEYS): + deprecated( + reason=( + "Configuring installation scheme with distutils config files " + "is deprecated and will no longer work in the near future. If you " + "are using a Homebrew or Linuxbrew Python, please see discussion " + "at https://github.com/Homebrew/homebrew-core/issues/76621" + ), + replacement=None, + gone_in=None, + ) + return old + + # Post warnings about this mismatch so user can report them back. + for old_v, new_v, key in warning_contexts: + _warn_mismatched(old_v, new_v, key=key) + _log_context(user=user, home=home, root=root, prefix=prefix) + + return old + + +def get_bin_prefix() -> str: + new = _sysconfig.get_bin_prefix() + if _USE_SYSCONFIG: + return new + + old = _distutils.get_bin_prefix() + if _warn_if_mismatch(pathlib.Path(old), pathlib.Path(new), key="bin_prefix"): + _log_context() + return old + + +def get_bin_user() -> str: + return _sysconfig.get_scheme("", user=True).scripts + + +def _looks_like_deb_system_dist_packages(value: str) -> bool: + """Check if the value is Debian's APT-controlled dist-packages. + + Debian's ``distutils.sysconfig.get_python_lib()`` implementation returns the + default package path controlled by APT, but does not patch ``sysconfig`` to + do the same. This is similar to the bug worked around in ``get_scheme()``, + but here the default is ``deb_system`` instead of ``unix_local``. Ultimately + we can't do anything about this Debian bug, and this detection allows us to + skip the warning when needed. + """ + if not _looks_like_debian_scheme(): + return False + if value == "/usr/lib/python3/dist-packages": + return True + return False + + +def get_purelib() -> str: + """Return the default pure-Python lib location.""" + new = _sysconfig.get_purelib() + if _USE_SYSCONFIG: + return new + + old = _distutils.get_purelib() + if _looks_like_deb_system_dist_packages(old): + return old + if _warn_if_mismatch(pathlib.Path(old), pathlib.Path(new), key="purelib"): + _log_context() + return old + + +def get_platlib() -> str: + """Return the default platform-shared lib location.""" + new = _sysconfig.get_platlib() + if _USE_SYSCONFIG: + return new + + from . import _distutils + + old = _distutils.get_platlib() + if _looks_like_deb_system_dist_packages(old): + return old + if _warn_if_mismatch(pathlib.Path(old), pathlib.Path(new), key="platlib"): + _log_context() + return old diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/locations/__pycache__/__init__.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/locations/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000..9b3c1c2 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/locations/__pycache__/__init__.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/locations/__pycache__/_distutils.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/locations/__pycache__/_distutils.cpython-312.pyc new file mode 100644 index 0000000..2613992 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/locations/__pycache__/_distutils.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/locations/__pycache__/_sysconfig.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/locations/__pycache__/_sysconfig.cpython-312.pyc new file mode 100644 index 0000000..e6bc573 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/locations/__pycache__/_sysconfig.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/locations/__pycache__/base.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/locations/__pycache__/base.cpython-312.pyc new file mode 100644 index 0000000..62c4ebc Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/locations/__pycache__/base.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/locations/_distutils.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/locations/_distutils.py new file mode 100644 index 0000000..3d85625 --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/locations/_distutils.py @@ -0,0 +1,172 @@ +"""Locations where we look for configs, install stuff, etc""" + +# The following comment should be removed at some point in the future. +# mypy: strict-optional=False + +# If pip's going to use distutils, it should not be using the copy that setuptools +# might have injected into the environment. This is done by removing the injected +# shim, if it's injected. +# +# See https://github.com/pypa/pip/issues/8761 for the original discussion and +# rationale for why this is done within pip. +try: + __import__("_distutils_hack").remove_shim() +except (ImportError, AttributeError): + pass + +import logging +import os +import sys +from distutils.cmd import Command as DistutilsCommand +from distutils.command.install import SCHEME_KEYS +from distutils.command.install import install as distutils_install_command +from distutils.sysconfig import get_python_lib +from typing import Dict, List, Optional, Union + +from pip._internal.models.scheme import Scheme +from pip._internal.utils.compat import WINDOWS +from pip._internal.utils.virtualenv import running_under_virtualenv + +from .base import get_major_minor_version + +logger = logging.getLogger(__name__) + + +def distutils_scheme( + dist_name: str, + user: bool = False, + home: Optional[str] = None, + root: Optional[str] = None, + isolated: bool = False, + prefix: Optional[str] = None, + *, + ignore_config_files: bool = False, +) -> Dict[str, str]: + """ + Return a distutils install scheme + """ + from distutils.dist import Distribution + + dist_args: Dict[str, Union[str, List[str]]] = {"name": dist_name} + if isolated: + dist_args["script_args"] = ["--no-user-cfg"] + + d = Distribution(dist_args) + if not ignore_config_files: + try: + d.parse_config_files() + except UnicodeDecodeError: + paths = d.find_config_files() + logger.warning( + "Ignore distutils configs in %s due to encoding errors.", + ", ".join(os.path.basename(p) for p in paths), + ) + obj: Optional[DistutilsCommand] = None + obj = d.get_command_obj("install", create=True) + assert obj is not None + i: distutils_install_command = obj + # NOTE: setting user or home has the side-effect of creating the home dir + # or user base for installations during finalize_options() + # ideally, we'd prefer a scheme class that has no side-effects. + assert not (user and prefix), f"user={user} prefix={prefix}" + assert not (home and prefix), f"home={home} prefix={prefix}" + i.user = user or i.user + if user or home: + i.prefix = "" + i.prefix = prefix or i.prefix + i.home = home or i.home + i.root = root or i.root + i.finalize_options() + + scheme: Dict[str, str] = {} + for key in SCHEME_KEYS: + scheme[key] = getattr(i, "install_" + key) + + # install_lib specified in setup.cfg should install *everything* + # into there (i.e. it takes precedence over both purelib and + # platlib). Note, i.install_lib is *always* set after + # finalize_options(); we only want to override here if the user + # has explicitly requested it hence going back to the config + if "install_lib" in d.get_option_dict("install"): + scheme.update({"purelib": i.install_lib, "platlib": i.install_lib}) + + if running_under_virtualenv(): + if home: + prefix = home + elif user: + prefix = i.install_userbase + else: + prefix = i.prefix + scheme["headers"] = os.path.join( + prefix, + "include", + "site", + f"python{get_major_minor_version()}", + dist_name, + ) + + if root is not None: + path_no_drive = os.path.splitdrive(os.path.abspath(scheme["headers"]))[1] + scheme["headers"] = os.path.join(root, path_no_drive[1:]) + + return scheme + + +def get_scheme( + dist_name: str, + user: bool = False, + home: Optional[str] = None, + root: Optional[str] = None, + isolated: bool = False, + prefix: Optional[str] = None, +) -> Scheme: + """ + Get the "scheme" corresponding to the input parameters. The distutils + documentation provides the context for the available schemes: + https://docs.python.org/3/install/index.html#alternate-installation + + :param dist_name: the name of the package to retrieve the scheme for, used + in the headers scheme path + :param user: indicates to use the "user" scheme + :param home: indicates to use the "home" scheme and provides the base + directory for the same + :param root: root under which other directories are re-based + :param isolated: equivalent to --no-user-cfg, i.e. do not consider + ~/.pydistutils.cfg (posix) or ~/pydistutils.cfg (non-posix) for + scheme paths + :param prefix: indicates to use the "prefix" scheme and provides the + base directory for the same + """ + scheme = distutils_scheme(dist_name, user, home, root, isolated, prefix) + return Scheme( + platlib=scheme["platlib"], + purelib=scheme["purelib"], + headers=scheme["headers"], + scripts=scheme["scripts"], + data=scheme["data"], + ) + + +def get_bin_prefix() -> str: + # XXX: In old virtualenv versions, sys.prefix can contain '..' components, + # so we need to call normpath to eliminate them. + prefix = os.path.normpath(sys.prefix) + if WINDOWS: + bin_py = os.path.join(prefix, "Scripts") + # buildout uses 'bin' on Windows too? + if not os.path.exists(bin_py): + bin_py = os.path.join(prefix, "bin") + return bin_py + # Forcing to use /usr/local/bin for standard macOS framework installs + # Also log to ~/Library/Logs/ for use with the Console.app log viewer + if sys.platform[:6] == "darwin" and prefix[:16] == "/System/Library/": + return "/usr/local/bin" + return os.path.join(prefix, "bin") + + +def get_purelib() -> str: + return get_python_lib(plat_specific=False) + + +def get_platlib() -> str: + return get_python_lib(plat_specific=True) diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/locations/_sysconfig.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/locations/_sysconfig.py new file mode 100644 index 0000000..ca860ea --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/locations/_sysconfig.py @@ -0,0 +1,214 @@ +import logging +import os +import sys +import sysconfig +import typing + +from pip._internal.exceptions import InvalidSchemeCombination, UserInstallationInvalid +from pip._internal.models.scheme import SCHEME_KEYS, Scheme +from pip._internal.utils.virtualenv import running_under_virtualenv + +from .base import change_root, get_major_minor_version, is_osx_framework + +logger = logging.getLogger(__name__) + + +# Notes on _infer_* functions. +# Unfortunately ``get_default_scheme()`` didn't exist before 3.10, so there's no +# way to ask things like "what is the '_prefix' scheme on this platform". These +# functions try to answer that with some heuristics while accounting for ad-hoc +# platforms not covered by CPython's default sysconfig implementation. If the +# ad-hoc implementation does not fully implement sysconfig, we'll fall back to +# a POSIX scheme. + +_AVAILABLE_SCHEMES = set(sysconfig.get_scheme_names()) + +_PREFERRED_SCHEME_API = getattr(sysconfig, "get_preferred_scheme", None) + + +def _should_use_osx_framework_prefix() -> bool: + """Check for Apple's ``osx_framework_library`` scheme. + + Python distributed by Apple's Command Line Tools has this special scheme + that's used when: + + * This is a framework build. + * We are installing into the system prefix. + + This does not account for ``pip install --prefix`` (also means we're not + installing to the system prefix), which should use ``posix_prefix``, but + logic here means ``_infer_prefix()`` outputs ``osx_framework_library``. But + since ``prefix`` is not available for ``sysconfig.get_default_scheme()``, + which is the stdlib replacement for ``_infer_prefix()``, presumably Apple + wouldn't be able to magically switch between ``osx_framework_library`` and + ``posix_prefix``. ``_infer_prefix()`` returning ``osx_framework_library`` + means its behavior is consistent whether we use the stdlib implementation + or our own, and we deal with this special case in ``get_scheme()`` instead. + """ + return ( + "osx_framework_library" in _AVAILABLE_SCHEMES + and not running_under_virtualenv() + and is_osx_framework() + ) + + +def _infer_prefix() -> str: + """Try to find a prefix scheme for the current platform. + + This tries: + + * A special ``osx_framework_library`` for Python distributed by Apple's + Command Line Tools, when not running in a virtual environment. + * Implementation + OS, used by PyPy on Windows (``pypy_nt``). + * Implementation without OS, used by PyPy on POSIX (``pypy``). + * OS + "prefix", used by CPython on POSIX (``posix_prefix``). + * Just the OS name, used by CPython on Windows (``nt``). + + If none of the above works, fall back to ``posix_prefix``. + """ + if _PREFERRED_SCHEME_API: + return _PREFERRED_SCHEME_API("prefix") + if _should_use_osx_framework_prefix(): + return "osx_framework_library" + implementation_suffixed = f"{sys.implementation.name}_{os.name}" + if implementation_suffixed in _AVAILABLE_SCHEMES: + return implementation_suffixed + if sys.implementation.name in _AVAILABLE_SCHEMES: + return sys.implementation.name + suffixed = f"{os.name}_prefix" + if suffixed in _AVAILABLE_SCHEMES: + return suffixed + if os.name in _AVAILABLE_SCHEMES: # On Windows, prefx is just called "nt". + return os.name + return "posix_prefix" + + +def _infer_user() -> str: + """Try to find a user scheme for the current platform.""" + if _PREFERRED_SCHEME_API: + return _PREFERRED_SCHEME_API("user") + if is_osx_framework() and not running_under_virtualenv(): + suffixed = "osx_framework_user" + else: + suffixed = f"{os.name}_user" + if suffixed in _AVAILABLE_SCHEMES: + return suffixed + if "posix_user" not in _AVAILABLE_SCHEMES: # User scheme unavailable. + raise UserInstallationInvalid() + return "posix_user" + + +def _infer_home() -> str: + """Try to find a home for the current platform.""" + if _PREFERRED_SCHEME_API: + return _PREFERRED_SCHEME_API("home") + suffixed = f"{os.name}_home" + if suffixed in _AVAILABLE_SCHEMES: + return suffixed + return "posix_home" + + +# Update these keys if the user sets a custom home. +_HOME_KEYS = [ + "installed_base", + "base", + "installed_platbase", + "platbase", + "prefix", + "exec_prefix", +] +if sysconfig.get_config_var("userbase") is not None: + _HOME_KEYS.append("userbase") + + +def get_scheme( + dist_name: str, + user: bool = False, + home: typing.Optional[str] = None, + root: typing.Optional[str] = None, + isolated: bool = False, + prefix: typing.Optional[str] = None, +) -> Scheme: + """ + Get the "scheme" corresponding to the input parameters. + + :param dist_name: the name of the package to retrieve the scheme for, used + in the headers scheme path + :param user: indicates to use the "user" scheme + :param home: indicates to use the "home" scheme + :param root: root under which other directories are re-based + :param isolated: ignored, but kept for distutils compatibility (where + this controls whether the user-site pydistutils.cfg is honored) + :param prefix: indicates to use the "prefix" scheme and provides the + base directory for the same + """ + if user and prefix: + raise InvalidSchemeCombination("--user", "--prefix") + if home and prefix: + raise InvalidSchemeCombination("--home", "--prefix") + + if home is not None: + scheme_name = _infer_home() + elif user: + scheme_name = _infer_user() + else: + scheme_name = _infer_prefix() + + # Special case: When installing into a custom prefix, use posix_prefix + # instead of osx_framework_library. See _should_use_osx_framework_prefix() + # docstring for details. + if prefix is not None and scheme_name == "osx_framework_library": + scheme_name = "posix_prefix" + + if home is not None: + variables = {k: home for k in _HOME_KEYS} + elif prefix is not None: + variables = {k: prefix for k in _HOME_KEYS} + else: + variables = {} + + paths = sysconfig.get_paths(scheme=scheme_name, vars=variables) + + # Logic here is very arbitrary, we're doing it for compatibility, don't ask. + # 1. Pip historically uses a special header path in virtual environments. + # 2. If the distribution name is not known, distutils uses 'UNKNOWN'. We + # only do the same when not running in a virtual environment because + # pip's historical header path logic (see point 1) did not do this. + if running_under_virtualenv(): + if user: + base = variables.get("userbase", sys.prefix) + else: + base = variables.get("base", sys.prefix) + python_xy = f"python{get_major_minor_version()}" + paths["include"] = os.path.join(base, "include", "site", python_xy) + elif not dist_name: + dist_name = "UNKNOWN" + + scheme = Scheme( + platlib=paths["platlib"], + purelib=paths["purelib"], + headers=os.path.join(paths["include"], dist_name), + scripts=paths["scripts"], + data=paths["data"], + ) + if root is not None: + converted_keys = {} + for key in SCHEME_KEYS: + converted_keys[key] = change_root(root, getattr(scheme, key)) + scheme = Scheme(**converted_keys) + return scheme + + +def get_bin_prefix() -> str: + # Forcing to use /usr/local/bin for standard macOS framework installs. + if sys.platform[:6] == "darwin" and sys.prefix[:16] == "/System/Library/": + return "/usr/local/bin" + return sysconfig.get_paths()["scripts"] + + +def get_purelib() -> str: + return sysconfig.get_paths()["purelib"] + + +def get_platlib() -> str: + return sysconfig.get_paths()["platlib"] diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/locations/base.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/locations/base.py new file mode 100644 index 0000000..3f9f896 --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/locations/base.py @@ -0,0 +1,81 @@ +import functools +import os +import site +import sys +import sysconfig +import typing + +from pip._internal.exceptions import InstallationError +from pip._internal.utils import appdirs +from pip._internal.utils.virtualenv import running_under_virtualenv + +# Application Directories +USER_CACHE_DIR = appdirs.user_cache_dir("pip") + +# FIXME doesn't account for venv linked to global site-packages +site_packages: str = sysconfig.get_path("purelib") + + +def get_major_minor_version() -> str: + """ + Return the major-minor version of the current Python as a string, e.g. + "3.7" or "3.10". + """ + return "{}.{}".format(*sys.version_info) + + +def change_root(new_root: str, pathname: str) -> str: + """Return 'pathname' with 'new_root' prepended. + + If 'pathname' is relative, this is equivalent to os.path.join(new_root, pathname). + Otherwise, it requires making 'pathname' relative and then joining the + two, which is tricky on DOS/Windows and Mac OS. + + This is borrowed from Python's standard library's distutils module. + """ + if os.name == "posix": + if not os.path.isabs(pathname): + return os.path.join(new_root, pathname) + else: + return os.path.join(new_root, pathname[1:]) + + elif os.name == "nt": + (drive, path) = os.path.splitdrive(pathname) + if path[0] == "\\": + path = path[1:] + return os.path.join(new_root, path) + + else: + raise InstallationError( + f"Unknown platform: {os.name}\n" + "Can not change root path prefix on unknown platform." + ) + + +def get_src_prefix() -> str: + if running_under_virtualenv(): + src_prefix = os.path.join(sys.prefix, "src") + else: + # FIXME: keep src in cwd for now (it is not a temporary folder) + try: + src_prefix = os.path.join(os.getcwd(), "src") + except OSError: + # In case the current working directory has been renamed or deleted + sys.exit("The folder you are executing pip from can no longer be found.") + + # under macOS + virtualenv sys.prefix is not properly resolved + # it is something like /path/to/python/bin/.. + return os.path.abspath(src_prefix) + + +try: + # Use getusersitepackages if this is present, as it ensures that the + # value is initialised properly. + user_site: typing.Optional[str] = site.getusersitepackages() +except AttributeError: + user_site = site.USER_SITE + + +@functools.lru_cache(maxsize=None) +def is_osx_framework() -> bool: + return bool(sysconfig.get_config_var("PYTHONFRAMEWORK")) diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/main.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/main.py new file mode 100644 index 0000000..33c6d24 --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/main.py @@ -0,0 +1,12 @@ +from typing import List, Optional + + +def main(args: Optional[List[str]] = None) -> int: + """This is preserved for old console scripts that may still be referencing + it. + + For additional details, see https://github.com/pypa/pip/issues/7498. + """ + from pip._internal.utils.entrypoints import _wrapper + + return _wrapper(args) diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/metadata/__init__.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/metadata/__init__.py new file mode 100644 index 0000000..1ea1e7f --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/metadata/__init__.py @@ -0,0 +1,128 @@ +import contextlib +import functools +import os +import sys +from typing import TYPE_CHECKING, List, Optional, Type, cast + +from pip._internal.utils.misc import strtobool + +from .base import BaseDistribution, BaseEnvironment, FilesystemWheel, MemoryWheel, Wheel + +if TYPE_CHECKING: + from typing import Literal, Protocol +else: + Protocol = object + +__all__ = [ + "BaseDistribution", + "BaseEnvironment", + "FilesystemWheel", + "MemoryWheel", + "Wheel", + "get_default_environment", + "get_environment", + "get_wheel_distribution", + "select_backend", +] + + +def _should_use_importlib_metadata() -> bool: + """Whether to use the ``importlib.metadata`` or ``pkg_resources`` backend. + + By default, pip uses ``importlib.metadata`` on Python 3.11+, and + ``pkg_resources`` otherwise. This can be overridden by a couple of ways: + + * If environment variable ``_PIP_USE_IMPORTLIB_METADATA`` is set, it + dictates whether ``importlib.metadata`` is used, regardless of Python + version. + * On Python 3.11+, Python distributors can patch ``importlib.metadata`` + to add a global constant ``_PIP_USE_IMPORTLIB_METADATA = False``. This + makes pip use ``pkg_resources`` (unless the user set the aforementioned + environment variable to *True*). + """ + with contextlib.suppress(KeyError, ValueError): + return bool(strtobool(os.environ["_PIP_USE_IMPORTLIB_METADATA"])) + if sys.version_info < (3, 11): + return False + import importlib.metadata + + return bool(getattr(importlib.metadata, "_PIP_USE_IMPORTLIB_METADATA", True)) + + +class Backend(Protocol): + NAME: 'Literal["importlib", "pkg_resources"]' + Distribution: Type[BaseDistribution] + Environment: Type[BaseEnvironment] + + +@functools.lru_cache(maxsize=None) +def select_backend() -> Backend: + if _should_use_importlib_metadata(): + from . import importlib + + return cast(Backend, importlib) + from . import pkg_resources + + return cast(Backend, pkg_resources) + + +def get_default_environment() -> BaseEnvironment: + """Get the default representation for the current environment. + + This returns an Environment instance from the chosen backend. The default + Environment instance should be built from ``sys.path`` and may use caching + to share instance state across calls. + """ + return select_backend().Environment.default() + + +def get_environment(paths: Optional[List[str]]) -> BaseEnvironment: + """Get a representation of the environment specified by ``paths``. + + This returns an Environment instance from the chosen backend based on the + given import paths. The backend must build a fresh instance representing + the state of installed distributions when this function is called. + """ + return select_backend().Environment.from_paths(paths) + + +def get_directory_distribution(directory: str) -> BaseDistribution: + """Get the distribution metadata representation in the specified directory. + + This returns a Distribution instance from the chosen backend based on + the given on-disk ``.dist-info`` directory. + """ + return select_backend().Distribution.from_directory(directory) + + +def get_wheel_distribution(wheel: Wheel, canonical_name: str) -> BaseDistribution: + """Get the representation of the specified wheel's distribution metadata. + + This returns a Distribution instance from the chosen backend based on + the given wheel's ``.dist-info`` directory. + + :param canonical_name: Normalized project name of the given wheel. + """ + return select_backend().Distribution.from_wheel(wheel, canonical_name) + + +def get_metadata_distribution( + metadata_contents: bytes, + filename: str, + canonical_name: str, +) -> BaseDistribution: + """Get the dist representation of the specified METADATA file contents. + + This returns a Distribution instance from the chosen backend sourced from the data + in `metadata_contents`. + + :param metadata_contents: Contents of a METADATA file within a dist, or one served + via PEP 658. + :param filename: Filename for the dist this metadata represents. + :param canonical_name: Normalized project name of the given dist. + """ + return select_backend().Distribution.from_metadata_file_contents( + metadata_contents, + filename, + canonical_name, + ) diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/metadata/__pycache__/__init__.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/metadata/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000..8835d2e Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/metadata/__pycache__/__init__.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/metadata/__pycache__/_json.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/metadata/__pycache__/_json.cpython-312.pyc new file mode 100644 index 0000000..42e3210 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/metadata/__pycache__/_json.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/metadata/__pycache__/base.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/metadata/__pycache__/base.cpython-312.pyc new file mode 100644 index 0000000..6a27787 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/metadata/__pycache__/base.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/metadata/__pycache__/pkg_resources.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/metadata/__pycache__/pkg_resources.cpython-312.pyc new file mode 100644 index 0000000..904fd44 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/metadata/__pycache__/pkg_resources.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/metadata/_json.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/metadata/_json.py new file mode 100644 index 0000000..f3aeab3 --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/metadata/_json.py @@ -0,0 +1,86 @@ +# Extracted from https://github.com/pfmoore/pkg_metadata + +from email.header import Header, decode_header, make_header +from email.message import Message +from typing import Any, Dict, List, Union, cast + +METADATA_FIELDS = [ + # Name, Multiple-Use + ("Metadata-Version", False), + ("Name", False), + ("Version", False), + ("Dynamic", True), + ("Platform", True), + ("Supported-Platform", True), + ("Summary", False), + ("Description", False), + ("Description-Content-Type", False), + ("Keywords", False), + ("Home-page", False), + ("Download-URL", False), + ("Author", False), + ("Author-email", False), + ("Maintainer", False), + ("Maintainer-email", False), + ("License", False), + ("License-Expression", False), + ("License-File", True), + ("Classifier", True), + ("Requires-Dist", True), + ("Requires-Python", False), + ("Requires-External", True), + ("Project-URL", True), + ("Provides-Extra", True), + ("Provides-Dist", True), + ("Obsoletes-Dist", True), +] + + +def json_name(field: str) -> str: + return field.lower().replace("-", "_") + + +def msg_to_json(msg: Message) -> Dict[str, Any]: + """Convert a Message object into a JSON-compatible dictionary.""" + + def sanitise_header(h: Union[Header, str]) -> str: + if isinstance(h, Header): + chunks = [] + for bytes, encoding in decode_header(h): + if encoding == "unknown-8bit": + try: + # See if UTF-8 works + bytes.decode("utf-8") + encoding = "utf-8" + except UnicodeDecodeError: + # If not, latin1 at least won't fail + encoding = "latin1" + chunks.append((bytes, encoding)) + return str(make_header(chunks)) + return str(h) + + result = {} + for field, multi in METADATA_FIELDS: + if field not in msg: + continue + key = json_name(field) + if multi: + value: Union[str, List[str]] = [ + sanitise_header(v) for v in msg.get_all(field) # type: ignore + ] + else: + value = sanitise_header(msg.get(field)) # type: ignore + if key == "keywords": + # Accept both comma-separated and space-separated + # forms, for better compatibility with old data. + if "," in value: + value = [v.strip() for v in value.split(",")] + else: + value = value.split() + result[key] = value + + payload = cast(str, msg.get_payload()) + if payload: + result["description"] = payload + + return result diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/metadata/base.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/metadata/base.py new file mode 100644 index 0000000..9eabcdb --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/metadata/base.py @@ -0,0 +1,688 @@ +import csv +import email.message +import functools +import json +import logging +import pathlib +import re +import zipfile +from typing import ( + IO, + Any, + Collection, + Container, + Dict, + Iterable, + Iterator, + List, + NamedTuple, + Optional, + Protocol, + Tuple, + Union, +) + +from pip._vendor.packaging.requirements import Requirement +from pip._vendor.packaging.specifiers import InvalidSpecifier, SpecifierSet +from pip._vendor.packaging.utils import NormalizedName, canonicalize_name +from pip._vendor.packaging.version import Version + +from pip._internal.exceptions import NoneMetadataError +from pip._internal.locations import site_packages, user_site +from pip._internal.models.direct_url import ( + DIRECT_URL_METADATA_NAME, + DirectUrl, + DirectUrlValidationError, +) +from pip._internal.utils.compat import stdlib_pkgs # TODO: Move definition here. +from pip._internal.utils.egg_link import egg_link_path_from_sys_path +from pip._internal.utils.misc import is_local, normalize_path +from pip._internal.utils.urls import url_to_path + +from ._json import msg_to_json + +InfoPath = Union[str, pathlib.PurePath] + +logger = logging.getLogger(__name__) + + +class BaseEntryPoint(Protocol): + @property + def name(self) -> str: + raise NotImplementedError() + + @property + def value(self) -> str: + raise NotImplementedError() + + @property + def group(self) -> str: + raise NotImplementedError() + + +def _convert_installed_files_path( + entry: Tuple[str, ...], + info: Tuple[str, ...], +) -> str: + """Convert a legacy installed-files.txt path into modern RECORD path. + + The legacy format stores paths relative to the info directory, while the + modern format stores paths relative to the package root, e.g. the + site-packages directory. + + :param entry: Path parts of the installed-files.txt entry. + :param info: Path parts of the egg-info directory relative to package root. + :returns: The converted entry. + + For best compatibility with symlinks, this does not use ``abspath()`` or + ``Path.resolve()``, but tries to work with path parts: + + 1. While ``entry`` starts with ``..``, remove the equal amounts of parts + from ``info``; if ``info`` is empty, start appending ``..`` instead. + 2. Join the two directly. + """ + while entry and entry[0] == "..": + if not info or info[-1] == "..": + info += ("..",) + else: + info = info[:-1] + entry = entry[1:] + return str(pathlib.Path(*info, *entry)) + + +class RequiresEntry(NamedTuple): + requirement: str + extra: str + marker: str + + +class BaseDistribution(Protocol): + @classmethod + def from_directory(cls, directory: str) -> "BaseDistribution": + """Load the distribution from a metadata directory. + + :param directory: Path to a metadata directory, e.g. ``.dist-info``. + """ + raise NotImplementedError() + + @classmethod + def from_metadata_file_contents( + cls, + metadata_contents: bytes, + filename: str, + project_name: str, + ) -> "BaseDistribution": + """Load the distribution from the contents of a METADATA file. + + This is used to implement PEP 658 by generating a "shallow" dist object that can + be used for resolution without downloading or building the actual dist yet. + + :param metadata_contents: The contents of a METADATA file. + :param filename: File name for the dist with this metadata. + :param project_name: Name of the project this dist represents. + """ + raise NotImplementedError() + + @classmethod + def from_wheel(cls, wheel: "Wheel", name: str) -> "BaseDistribution": + """Load the distribution from a given wheel. + + :param wheel: A concrete wheel definition. + :param name: File name of the wheel. + + :raises InvalidWheel: Whenever loading of the wheel causes a + :py:exc:`zipfile.BadZipFile` exception to be thrown. + :raises UnsupportedWheel: If the wheel is a valid zip, but malformed + internally. + """ + raise NotImplementedError() + + def __repr__(self) -> str: + return f"{self.raw_name} {self.raw_version} ({self.location})" + + def __str__(self) -> str: + return f"{self.raw_name} {self.raw_version}" + + @property + def location(self) -> Optional[str]: + """Where the distribution is loaded from. + + A string value is not necessarily a filesystem path, since distributions + can be loaded from other sources, e.g. arbitrary zip archives. ``None`` + means the distribution is created in-memory. + + Do not canonicalize this value with e.g. ``pathlib.Path.resolve()``. If + this is a symbolic link, we want to preserve the relative path between + it and files in the distribution. + """ + raise NotImplementedError() + + @property + def editable_project_location(self) -> Optional[str]: + """The project location for editable distributions. + + This is the directory where pyproject.toml or setup.py is located. + None if the distribution is not installed in editable mode. + """ + # TODO: this property is relatively costly to compute, memoize it ? + direct_url = self.direct_url + if direct_url: + if direct_url.is_local_editable(): + return url_to_path(direct_url.url) + else: + # Search for an .egg-link file by walking sys.path, as it was + # done before by dist_is_editable(). + egg_link_path = egg_link_path_from_sys_path(self.raw_name) + if egg_link_path: + # TODO: get project location from second line of egg_link file + # (https://github.com/pypa/pip/issues/10243) + return self.location + return None + + @property + def installed_location(self) -> Optional[str]: + """The distribution's "installed" location. + + This should generally be a ``site-packages`` directory. This is + usually ``dist.location``, except for legacy develop-installed packages, + where ``dist.location`` is the source code location, and this is where + the ``.egg-link`` file is. + + The returned location is normalized (in particular, with symlinks removed). + """ + raise NotImplementedError() + + @property + def info_location(self) -> Optional[str]: + """Location of the .[egg|dist]-info directory or file. + + Similarly to ``location``, a string value is not necessarily a + filesystem path. ``None`` means the distribution is created in-memory. + + For a modern .dist-info installation on disk, this should be something + like ``{location}/{raw_name}-{version}.dist-info``. + + Do not canonicalize this value with e.g. ``pathlib.Path.resolve()``. If + this is a symbolic link, we want to preserve the relative path between + it and other files in the distribution. + """ + raise NotImplementedError() + + @property + def installed_by_distutils(self) -> bool: + """Whether this distribution is installed with legacy distutils format. + + A distribution installed with "raw" distutils not patched by setuptools + uses one single file at ``info_location`` to store metadata. We need to + treat this specially on uninstallation. + """ + info_location = self.info_location + if not info_location: + return False + return pathlib.Path(info_location).is_file() + + @property + def installed_as_egg(self) -> bool: + """Whether this distribution is installed as an egg. + + This usually indicates the distribution was installed by (older versions + of) easy_install. + """ + location = self.location + if not location: + return False + return location.endswith(".egg") + + @property + def installed_with_setuptools_egg_info(self) -> bool: + """Whether this distribution is installed with the ``.egg-info`` format. + + This usually indicates the distribution was installed with setuptools + with an old pip version or with ``single-version-externally-managed``. + + Note that this ensure the metadata store is a directory. distutils can + also installs an ``.egg-info``, but as a file, not a directory. This + property is *False* for that case. Also see ``installed_by_distutils``. + """ + info_location = self.info_location + if not info_location: + return False + if not info_location.endswith(".egg-info"): + return False + return pathlib.Path(info_location).is_dir() + + @property + def installed_with_dist_info(self) -> bool: + """Whether this distribution is installed with the "modern format". + + This indicates a "modern" installation, e.g. storing metadata in the + ``.dist-info`` directory. This applies to installations made by + setuptools (but through pip, not directly), or anything using the + standardized build backend interface (PEP 517). + """ + info_location = self.info_location + if not info_location: + return False + if not info_location.endswith(".dist-info"): + return False + return pathlib.Path(info_location).is_dir() + + @property + def canonical_name(self) -> NormalizedName: + raise NotImplementedError() + + @property + def version(self) -> Version: + raise NotImplementedError() + + @property + def raw_version(self) -> str: + raise NotImplementedError() + + @property + def setuptools_filename(self) -> str: + """Convert a project name to its setuptools-compatible filename. + + This is a copy of ``pkg_resources.to_filename()`` for compatibility. + """ + return self.raw_name.replace("-", "_") + + @property + def direct_url(self) -> Optional[DirectUrl]: + """Obtain a DirectUrl from this distribution. + + Returns None if the distribution has no `direct_url.json` metadata, + or if `direct_url.json` is invalid. + """ + try: + content = self.read_text(DIRECT_URL_METADATA_NAME) + except FileNotFoundError: + return None + try: + return DirectUrl.from_json(content) + except ( + UnicodeDecodeError, + json.JSONDecodeError, + DirectUrlValidationError, + ) as e: + logger.warning( + "Error parsing %s for %s: %s", + DIRECT_URL_METADATA_NAME, + self.canonical_name, + e, + ) + return None + + @property + def installer(self) -> str: + try: + installer_text = self.read_text("INSTALLER") + except (OSError, ValueError, NoneMetadataError): + return "" # Fail silently if the installer file cannot be read. + for line in installer_text.splitlines(): + cleaned_line = line.strip() + if cleaned_line: + return cleaned_line + return "" + + @property + def requested(self) -> bool: + return self.is_file("REQUESTED") + + @property + def editable(self) -> bool: + return bool(self.editable_project_location) + + @property + def local(self) -> bool: + """If distribution is installed in the current virtual environment. + + Always True if we're not in a virtualenv. + """ + if self.installed_location is None: + return False + return is_local(self.installed_location) + + @property + def in_usersite(self) -> bool: + if self.installed_location is None or user_site is None: + return False + return self.installed_location.startswith(normalize_path(user_site)) + + @property + def in_site_packages(self) -> bool: + if self.installed_location is None or site_packages is None: + return False + return self.installed_location.startswith(normalize_path(site_packages)) + + def is_file(self, path: InfoPath) -> bool: + """Check whether an entry in the info directory is a file.""" + raise NotImplementedError() + + def iter_distutils_script_names(self) -> Iterator[str]: + """Find distutils 'scripts' entries metadata. + + If 'scripts' is supplied in ``setup.py``, distutils records those in the + installed distribution's ``scripts`` directory, a file for each script. + """ + raise NotImplementedError() + + def read_text(self, path: InfoPath) -> str: + """Read a file in the info directory. + + :raise FileNotFoundError: If ``path`` does not exist in the directory. + :raise NoneMetadataError: If ``path`` exists in the info directory, but + cannot be read. + """ + raise NotImplementedError() + + def iter_entry_points(self) -> Iterable[BaseEntryPoint]: + raise NotImplementedError() + + def _metadata_impl(self) -> email.message.Message: + raise NotImplementedError() + + @functools.cached_property + def metadata(self) -> email.message.Message: + """Metadata of distribution parsed from e.g. METADATA or PKG-INFO. + + This should return an empty message if the metadata file is unavailable. + + :raises NoneMetadataError: If the metadata file is available, but does + not contain valid metadata. + """ + metadata = self._metadata_impl() + self._add_egg_info_requires(metadata) + return metadata + + @property + def metadata_dict(self) -> Dict[str, Any]: + """PEP 566 compliant JSON-serializable representation of METADATA or PKG-INFO. + + This should return an empty dict if the metadata file is unavailable. + + :raises NoneMetadataError: If the metadata file is available, but does + not contain valid metadata. + """ + return msg_to_json(self.metadata) + + @property + def metadata_version(self) -> Optional[str]: + """Value of "Metadata-Version:" in distribution metadata, if available.""" + return self.metadata.get("Metadata-Version") + + @property + def raw_name(self) -> str: + """Value of "Name:" in distribution metadata.""" + # The metadata should NEVER be missing the Name: key, but if it somehow + # does, fall back to the known canonical name. + return self.metadata.get("Name", self.canonical_name) + + @property + def requires_python(self) -> SpecifierSet: + """Value of "Requires-Python:" in distribution metadata. + + If the key does not exist or contains an invalid value, an empty + SpecifierSet should be returned. + """ + value = self.metadata.get("Requires-Python") + if value is None: + return SpecifierSet() + try: + # Convert to str to satisfy the type checker; this can be a Header object. + spec = SpecifierSet(str(value)) + except InvalidSpecifier as e: + message = "Package %r has an invalid Requires-Python: %s" + logger.warning(message, self.raw_name, e) + return SpecifierSet() + return spec + + def iter_dependencies(self, extras: Collection[str] = ()) -> Iterable[Requirement]: + """Dependencies of this distribution. + + For modern .dist-info distributions, this is the collection of + "Requires-Dist:" entries in distribution metadata. + """ + raise NotImplementedError() + + def iter_raw_dependencies(self) -> Iterable[str]: + """Raw Requires-Dist metadata.""" + return self.metadata.get_all("Requires-Dist", []) + + def iter_provided_extras(self) -> Iterable[NormalizedName]: + """Extras provided by this distribution. + + For modern .dist-info distributions, this is the collection of + "Provides-Extra:" entries in distribution metadata. + + The return value of this function is expected to be normalised names, + per PEP 685, with the returned value being handled appropriately by + `iter_dependencies`. + """ + raise NotImplementedError() + + def _iter_declared_entries_from_record(self) -> Optional[Iterator[str]]: + try: + text = self.read_text("RECORD") + except FileNotFoundError: + return None + # This extra Path-str cast normalizes entries. + return (str(pathlib.Path(row[0])) for row in csv.reader(text.splitlines())) + + def _iter_declared_entries_from_legacy(self) -> Optional[Iterator[str]]: + try: + text = self.read_text("installed-files.txt") + except FileNotFoundError: + return None + paths = (p for p in text.splitlines(keepends=False) if p) + root = self.location + info = self.info_location + if root is None or info is None: + return paths + try: + info_rel = pathlib.Path(info).relative_to(root) + except ValueError: # info is not relative to root. + return paths + if not info_rel.parts: # info *is* root. + return paths + return ( + _convert_installed_files_path(pathlib.Path(p).parts, info_rel.parts) + for p in paths + ) + + def iter_declared_entries(self) -> Optional[Iterator[str]]: + """Iterate through file entries declared in this distribution. + + For modern .dist-info distributions, this is the files listed in the + ``RECORD`` metadata file. For legacy setuptools distributions, this + comes from ``installed-files.txt``, with entries normalized to be + compatible with the format used by ``RECORD``. + + :return: An iterator for listed entries, or None if the distribution + contains neither ``RECORD`` nor ``installed-files.txt``. + """ + return ( + self._iter_declared_entries_from_record() + or self._iter_declared_entries_from_legacy() + ) + + def _iter_requires_txt_entries(self) -> Iterator[RequiresEntry]: + """Parse a ``requires.txt`` in an egg-info directory. + + This is an INI-ish format where an egg-info stores dependencies. A + section name describes extra other environment markers, while each entry + is an arbitrary string (not a key-value pair) representing a dependency + as a requirement string (no markers). + + There is a construct in ``importlib.metadata`` called ``Sectioned`` that + does mostly the same, but the format is currently considered private. + """ + try: + content = self.read_text("requires.txt") + except FileNotFoundError: + return + extra = marker = "" # Section-less entries don't have markers. + for line in content.splitlines(): + line = line.strip() + if not line or line.startswith("#"): # Comment; ignored. + continue + if line.startswith("[") and line.endswith("]"): # A section header. + extra, _, marker = line.strip("[]").partition(":") + continue + yield RequiresEntry(requirement=line, extra=extra, marker=marker) + + def _iter_egg_info_extras(self) -> Iterable[str]: + """Get extras from the egg-info directory.""" + known_extras = {""} + for entry in self._iter_requires_txt_entries(): + extra = canonicalize_name(entry.extra) + if extra in known_extras: + continue + known_extras.add(extra) + yield extra + + def _iter_egg_info_dependencies(self) -> Iterable[str]: + """Get distribution dependencies from the egg-info directory. + + To ease parsing, this converts a legacy dependency entry into a PEP 508 + requirement string. Like ``_iter_requires_txt_entries()``, there is code + in ``importlib.metadata`` that does mostly the same, but not do exactly + what we need. + + Namely, ``importlib.metadata`` does not normalize the extra name before + putting it into the requirement string, which causes marker comparison + to fail because the dist-info format do normalize. This is consistent in + all currently available PEP 517 backends, although not standardized. + """ + for entry in self._iter_requires_txt_entries(): + extra = canonicalize_name(entry.extra) + if extra and entry.marker: + marker = f'({entry.marker}) and extra == "{extra}"' + elif extra: + marker = f'extra == "{extra}"' + elif entry.marker: + marker = entry.marker + else: + marker = "" + if marker: + yield f"{entry.requirement} ; {marker}" + else: + yield entry.requirement + + def _add_egg_info_requires(self, metadata: email.message.Message) -> None: + """Add egg-info requires.txt information to the metadata.""" + if not metadata.get_all("Requires-Dist"): + for dep in self._iter_egg_info_dependencies(): + metadata["Requires-Dist"] = dep + if not metadata.get_all("Provides-Extra"): + for extra in self._iter_egg_info_extras(): + metadata["Provides-Extra"] = extra + + +class BaseEnvironment: + """An environment containing distributions to introspect.""" + + @classmethod + def default(cls) -> "BaseEnvironment": + raise NotImplementedError() + + @classmethod + def from_paths(cls, paths: Optional[List[str]]) -> "BaseEnvironment": + raise NotImplementedError() + + def get_distribution(self, name: str) -> Optional["BaseDistribution"]: + """Given a requirement name, return the installed distributions. + + The name may not be normalized. The implementation must canonicalize + it for lookup. + """ + raise NotImplementedError() + + def _iter_distributions(self) -> Iterator["BaseDistribution"]: + """Iterate through installed distributions. + + This function should be implemented by subclass, but never called + directly. Use the public ``iter_distribution()`` instead, which + implements additional logic to make sure the distributions are valid. + """ + raise NotImplementedError() + + def iter_all_distributions(self) -> Iterator[BaseDistribution]: + """Iterate through all installed distributions without any filtering.""" + for dist in self._iter_distributions(): + # Make sure the distribution actually comes from a valid Python + # packaging distribution. Pip's AdjacentTempDirectory leaves folders + # e.g. ``~atplotlib.dist-info`` if cleanup was interrupted. The + # valid project name pattern is taken from PEP 508. + project_name_valid = re.match( + r"^([A-Z0-9]|[A-Z0-9][A-Z0-9._-]*[A-Z0-9])$", + dist.canonical_name, + flags=re.IGNORECASE, + ) + if not project_name_valid: + logger.warning( + "Ignoring invalid distribution %s (%s)", + dist.canonical_name, + dist.location, + ) + continue + yield dist + + def iter_installed_distributions( + self, + local_only: bool = True, + skip: Container[str] = stdlib_pkgs, + include_editables: bool = True, + editables_only: bool = False, + user_only: bool = False, + ) -> Iterator[BaseDistribution]: + """Return a list of installed distributions. + + This is based on ``iter_all_distributions()`` with additional filtering + options. Note that ``iter_installed_distributions()`` without arguments + is *not* equal to ``iter_all_distributions()``, since some of the + configurations exclude packages by default. + + :param local_only: If True (default), only return installations + local to the current virtualenv, if in a virtualenv. + :param skip: An iterable of canonicalized project names to ignore; + defaults to ``stdlib_pkgs``. + :param include_editables: If False, don't report editables. + :param editables_only: If True, only report editables. + :param user_only: If True, only report installations in the user + site directory. + """ + it = self.iter_all_distributions() + if local_only: + it = (d for d in it if d.local) + if not include_editables: + it = (d for d in it if not d.editable) + if editables_only: + it = (d for d in it if d.editable) + if user_only: + it = (d for d in it if d.in_usersite) + return (d for d in it if d.canonical_name not in skip) + + +class Wheel(Protocol): + location: str + + def as_zipfile(self) -> zipfile.ZipFile: + raise NotImplementedError() + + +class FilesystemWheel(Wheel): + def __init__(self, location: str) -> None: + self.location = location + + def as_zipfile(self) -> zipfile.ZipFile: + return zipfile.ZipFile(self.location, allowZip64=True) + + +class MemoryWheel(Wheel): + def __init__(self, location: str, stream: IO[bytes]) -> None: + self.location = location + self.stream = stream + + def as_zipfile(self) -> zipfile.ZipFile: + return zipfile.ZipFile(self.stream, allowZip64=True) diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/metadata/importlib/__init__.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/metadata/importlib/__init__.py new file mode 100644 index 0000000..a779138 --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/metadata/importlib/__init__.py @@ -0,0 +1,6 @@ +from ._dists import Distribution +from ._envs import Environment + +__all__ = ["NAME", "Distribution", "Environment"] + +NAME = "importlib" diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/metadata/importlib/__pycache__/__init__.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/metadata/importlib/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000..a310752 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/metadata/importlib/__pycache__/__init__.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/metadata/importlib/__pycache__/_compat.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/metadata/importlib/__pycache__/_compat.cpython-312.pyc new file mode 100644 index 0000000..b5794df Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/metadata/importlib/__pycache__/_compat.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/metadata/importlib/__pycache__/_dists.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/metadata/importlib/__pycache__/_dists.cpython-312.pyc new file mode 100644 index 0000000..c8ccd1b Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/metadata/importlib/__pycache__/_dists.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/metadata/importlib/__pycache__/_envs.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/metadata/importlib/__pycache__/_envs.cpython-312.pyc new file mode 100644 index 0000000..b4f88bf Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/metadata/importlib/__pycache__/_envs.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/metadata/importlib/_compat.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/metadata/importlib/_compat.py new file mode 100644 index 0000000..ec1e815 --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/metadata/importlib/_compat.py @@ -0,0 +1,85 @@ +import importlib.metadata +import os +from typing import Any, Optional, Protocol, Tuple, cast + +from pip._vendor.packaging.utils import NormalizedName, canonicalize_name + + +class BadMetadata(ValueError): + def __init__(self, dist: importlib.metadata.Distribution, *, reason: str) -> None: + self.dist = dist + self.reason = reason + + def __str__(self) -> str: + return f"Bad metadata in {self.dist} ({self.reason})" + + +class BasePath(Protocol): + """A protocol that various path objects conform. + + This exists because importlib.metadata uses both ``pathlib.Path`` and + ``zipfile.Path``, and we need a common base for type hints (Union does not + work well since ``zipfile.Path`` is too new for our linter setup). + + This does not mean to be exhaustive, but only contains things that present + in both classes *that we need*. + """ + + @property + def name(self) -> str: + raise NotImplementedError() + + @property + def parent(self) -> "BasePath": + raise NotImplementedError() + + +def get_info_location(d: importlib.metadata.Distribution) -> Optional[BasePath]: + """Find the path to the distribution's metadata directory. + + HACK: This relies on importlib.metadata's private ``_path`` attribute. Not + all distributions exist on disk, so importlib.metadata is correct to not + expose the attribute as public. But pip's code base is old and not as clean, + so we do this to avoid having to rewrite too many things. Hopefully we can + eliminate this some day. + """ + return getattr(d, "_path", None) + + +def parse_name_and_version_from_info_directory( + dist: importlib.metadata.Distribution, +) -> Tuple[Optional[str], Optional[str]]: + """Get a name and version from the metadata directory name. + + This is much faster than reading distribution metadata. + """ + info_location = get_info_location(dist) + if info_location is None: + return None, None + + stem, suffix = os.path.splitext(info_location.name) + if suffix == ".dist-info": + name, sep, version = stem.partition("-") + if sep: + return name, version + + if suffix == ".egg-info": + name = stem.split("-", 1)[0] + return name, None + + return None, None + + +def get_dist_canonical_name(dist: importlib.metadata.Distribution) -> NormalizedName: + """Get the distribution's normalized name. + + The ``name`` attribute is only available in Python 3.10 or later. We are + targeting exactly that, but Mypy does not know this. + """ + if name := parse_name_and_version_from_info_directory(dist)[0]: + return canonicalize_name(name) + + name = cast(Any, dist).name + if not isinstance(name, str): + raise BadMetadata(dist, reason="invalid metadata entry 'name'") + return canonicalize_name(name) diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/metadata/importlib/_dists.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/metadata/importlib/_dists.py new file mode 100644 index 0000000..d220b61 --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/metadata/importlib/_dists.py @@ -0,0 +1,228 @@ +import email.message +import importlib.metadata +import pathlib +import zipfile +from os import PathLike +from typing import ( + Collection, + Dict, + Iterable, + Iterator, + Mapping, + Optional, + Sequence, + Union, + cast, +) + +from pip._vendor.packaging.requirements import Requirement +from pip._vendor.packaging.utils import NormalizedName, canonicalize_name +from pip._vendor.packaging.version import Version +from pip._vendor.packaging.version import parse as parse_version + +from pip._internal.exceptions import InvalidWheel, UnsupportedWheel +from pip._internal.metadata.base import ( + BaseDistribution, + BaseEntryPoint, + InfoPath, + Wheel, +) +from pip._internal.utils.misc import normalize_path +from pip._internal.utils.packaging import get_requirement +from pip._internal.utils.temp_dir import TempDirectory +from pip._internal.utils.wheel import parse_wheel, read_wheel_metadata_file + +from ._compat import ( + BasePath, + get_dist_canonical_name, + parse_name_and_version_from_info_directory, +) + + +class WheelDistribution(importlib.metadata.Distribution): + """An ``importlib.metadata.Distribution`` read from a wheel. + + Although ``importlib.metadata.PathDistribution`` accepts ``zipfile.Path``, + its implementation is too "lazy" for pip's needs (we can't keep the ZipFile + handle open for the entire lifetime of the distribution object). + + This implementation eagerly reads the entire metadata directory into the + memory instead, and operates from that. + """ + + def __init__( + self, + files: Mapping[pathlib.PurePosixPath, bytes], + info_location: pathlib.PurePosixPath, + ) -> None: + self._files = files + self.info_location = info_location + + @classmethod + def from_zipfile( + cls, + zf: zipfile.ZipFile, + name: str, + location: str, + ) -> "WheelDistribution": + info_dir, _ = parse_wheel(zf, name) + paths = ( + (name, pathlib.PurePosixPath(name.split("/", 1)[-1])) + for name in zf.namelist() + if name.startswith(f"{info_dir}/") + ) + files = { + relpath: read_wheel_metadata_file(zf, fullpath) + for fullpath, relpath in paths + } + info_location = pathlib.PurePosixPath(location, info_dir) + return cls(files, info_location) + + def iterdir(self, path: InfoPath) -> Iterator[pathlib.PurePosixPath]: + # Only allow iterating through the metadata directory. + if pathlib.PurePosixPath(str(path)) in self._files: + return iter(self._files) + raise FileNotFoundError(path) + + def read_text(self, filename: str) -> Optional[str]: + try: + data = self._files[pathlib.PurePosixPath(filename)] + except KeyError: + return None + try: + text = data.decode("utf-8") + except UnicodeDecodeError as e: + wheel = self.info_location.parent + error = f"Error decoding metadata for {wheel}: {e} in {filename} file" + raise UnsupportedWheel(error) + return text + + def locate_file(self, path: Union[str, "PathLike[str]"]) -> pathlib.Path: + # This method doesn't make sense for our in-memory wheel, but the API + # requires us to define it. + raise NotImplementedError + + +class Distribution(BaseDistribution): + def __init__( + self, + dist: importlib.metadata.Distribution, + info_location: Optional[BasePath], + installed_location: Optional[BasePath], + ) -> None: + self._dist = dist + self._info_location = info_location + self._installed_location = installed_location + + @classmethod + def from_directory(cls, directory: str) -> BaseDistribution: + info_location = pathlib.Path(directory) + dist = importlib.metadata.Distribution.at(info_location) + return cls(dist, info_location, info_location.parent) + + @classmethod + def from_metadata_file_contents( + cls, + metadata_contents: bytes, + filename: str, + project_name: str, + ) -> BaseDistribution: + # Generate temp dir to contain the metadata file, and write the file contents. + temp_dir = pathlib.Path( + TempDirectory(kind="metadata", globally_managed=True).path + ) + metadata_path = temp_dir / "METADATA" + metadata_path.write_bytes(metadata_contents) + # Construct dist pointing to the newly created directory. + dist = importlib.metadata.Distribution.at(metadata_path.parent) + return cls(dist, metadata_path.parent, None) + + @classmethod + def from_wheel(cls, wheel: Wheel, name: str) -> BaseDistribution: + try: + with wheel.as_zipfile() as zf: + dist = WheelDistribution.from_zipfile(zf, name, wheel.location) + except zipfile.BadZipFile as e: + raise InvalidWheel(wheel.location, name) from e + return cls(dist, dist.info_location, pathlib.PurePosixPath(wheel.location)) + + @property + def location(self) -> Optional[str]: + if self._info_location is None: + return None + return str(self._info_location.parent) + + @property + def info_location(self) -> Optional[str]: + if self._info_location is None: + return None + return str(self._info_location) + + @property + def installed_location(self) -> Optional[str]: + if self._installed_location is None: + return None + return normalize_path(str(self._installed_location)) + + @property + def canonical_name(self) -> NormalizedName: + return get_dist_canonical_name(self._dist) + + @property + def version(self) -> Version: + if version := parse_name_and_version_from_info_directory(self._dist)[1]: + return parse_version(version) + return parse_version(self._dist.version) + + @property + def raw_version(self) -> str: + return self._dist.version + + def is_file(self, path: InfoPath) -> bool: + return self._dist.read_text(str(path)) is not None + + def iter_distutils_script_names(self) -> Iterator[str]: + # A distutils installation is always "flat" (not in e.g. egg form), so + # if this distribution's info location is NOT a pathlib.Path (but e.g. + # zipfile.Path), it can never contain any distutils scripts. + if not isinstance(self._info_location, pathlib.Path): + return + for child in self._info_location.joinpath("scripts").iterdir(): + yield child.name + + def read_text(self, path: InfoPath) -> str: + content = self._dist.read_text(str(path)) + if content is None: + raise FileNotFoundError(path) + return content + + def iter_entry_points(self) -> Iterable[BaseEntryPoint]: + # importlib.metadata's EntryPoint structure satisfies BaseEntryPoint. + return self._dist.entry_points + + def _metadata_impl(self) -> email.message.Message: + # From Python 3.10+, importlib.metadata declares PackageMetadata as the + # return type. This protocol is unfortunately a disaster now and misses + # a ton of fields that we need, including get() and get_payload(). We + # rely on the implementation that the object is actually a Message now, + # until upstream can improve the protocol. (python/cpython#94952) + return cast(email.message.Message, self._dist.metadata) + + def iter_provided_extras(self) -> Iterable[NormalizedName]: + return [ + canonicalize_name(extra) + for extra in self.metadata.get_all("Provides-Extra", []) + ] + + def iter_dependencies(self, extras: Collection[str] = ()) -> Iterable[Requirement]: + contexts: Sequence[Dict[str, str]] = [{"extra": e} for e in extras] + for req_string in self.metadata.get_all("Requires-Dist", []): + # strip() because email.message.Message.get_all() may return a leading \n + # in case a long header was wrapped. + req = get_requirement(req_string.strip()) + if not req.marker: + yield req + elif not extras and req.marker.evaluate({"extra": ""}): + yield req + elif any(req.marker.evaluate(context) for context in contexts): + yield req diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/metadata/importlib/_envs.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/metadata/importlib/_envs.py new file mode 100644 index 0000000..4d906fd --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/metadata/importlib/_envs.py @@ -0,0 +1,189 @@ +import functools +import importlib.metadata +import logging +import os +import pathlib +import sys +import zipfile +import zipimport +from typing import Iterator, List, Optional, Sequence, Set, Tuple + +from pip._vendor.packaging.utils import NormalizedName, canonicalize_name + +from pip._internal.metadata.base import BaseDistribution, BaseEnvironment +from pip._internal.models.wheel import Wheel +from pip._internal.utils.deprecation import deprecated +from pip._internal.utils.filetypes import WHEEL_EXTENSION + +from ._compat import BadMetadata, BasePath, get_dist_canonical_name, get_info_location +from ._dists import Distribution + +logger = logging.getLogger(__name__) + + +def _looks_like_wheel(location: str) -> bool: + if not location.endswith(WHEEL_EXTENSION): + return False + if not os.path.isfile(location): + return False + if not Wheel.wheel_file_re.match(os.path.basename(location)): + return False + return zipfile.is_zipfile(location) + + +class _DistributionFinder: + """Finder to locate distributions. + + The main purpose of this class is to memoize found distributions' names, so + only one distribution is returned for each package name. At lot of pip code + assumes this (because it is setuptools's behavior), and not doing the same + can potentially cause a distribution in lower precedence path to override a + higher precedence one if the caller is not careful. + + Eventually we probably want to make it possible to see lower precedence + installations as well. It's useful feature, after all. + """ + + FoundResult = Tuple[importlib.metadata.Distribution, Optional[BasePath]] + + def __init__(self) -> None: + self._found_names: Set[NormalizedName] = set() + + def _find_impl(self, location: str) -> Iterator[FoundResult]: + """Find distributions in a location.""" + # Skip looking inside a wheel. Since a package inside a wheel is not + # always valid (due to .data directories etc.), its .dist-info entry + # should not be considered an installed distribution. + if _looks_like_wheel(location): + return + # To know exactly where we find a distribution, we have to feed in the + # paths one by one, instead of dumping the list to importlib.metadata. + for dist in importlib.metadata.distributions(path=[location]): + info_location = get_info_location(dist) + try: + name = get_dist_canonical_name(dist) + except BadMetadata as e: + logger.warning("Skipping %s due to %s", info_location, e.reason) + continue + if name in self._found_names: + continue + self._found_names.add(name) + yield dist, info_location + + def find(self, location: str) -> Iterator[BaseDistribution]: + """Find distributions in a location. + + The path can be either a directory, or a ZIP archive. + """ + for dist, info_location in self._find_impl(location): + if info_location is None: + installed_location: Optional[BasePath] = None + else: + installed_location = info_location.parent + yield Distribution(dist, info_location, installed_location) + + def find_linked(self, location: str) -> Iterator[BaseDistribution]: + """Read location in egg-link files and return distributions in there. + + The path should be a directory; otherwise this returns nothing. This + follows how setuptools does this for compatibility. The first non-empty + line in the egg-link is read as a path (resolved against the egg-link's + containing directory if relative). Distributions found at that linked + location are returned. + """ + path = pathlib.Path(location) + if not path.is_dir(): + return + for child in path.iterdir(): + if child.suffix != ".egg-link": + continue + with child.open() as f: + lines = (line.strip() for line in f) + target_rel = next((line for line in lines if line), "") + if not target_rel: + continue + target_location = str(path.joinpath(target_rel)) + for dist, info_location in self._find_impl(target_location): + yield Distribution(dist, info_location, path) + + def _find_eggs_in_dir(self, location: str) -> Iterator[BaseDistribution]: + from pip._vendor.pkg_resources import find_distributions + + from pip._internal.metadata import pkg_resources as legacy + + with os.scandir(location) as it: + for entry in it: + if not entry.name.endswith(".egg"): + continue + for dist in find_distributions(entry.path): + yield legacy.Distribution(dist) + + def _find_eggs_in_zip(self, location: str) -> Iterator[BaseDistribution]: + from pip._vendor.pkg_resources import find_eggs_in_zip + + from pip._internal.metadata import pkg_resources as legacy + + try: + importer = zipimport.zipimporter(location) + except zipimport.ZipImportError: + return + for dist in find_eggs_in_zip(importer, location): + yield legacy.Distribution(dist) + + def find_eggs(self, location: str) -> Iterator[BaseDistribution]: + """Find eggs in a location. + + This actually uses the old *pkg_resources* backend. We likely want to + deprecate this so we can eventually remove the *pkg_resources* + dependency entirely. Before that, this should first emit a deprecation + warning for some versions when using the fallback since importing + *pkg_resources* is slow for those who don't need it. + """ + if os.path.isdir(location): + yield from self._find_eggs_in_dir(location) + if zipfile.is_zipfile(location): + yield from self._find_eggs_in_zip(location) + + +@functools.lru_cache(maxsize=None) # Warn a distribution exactly once. +def _emit_egg_deprecation(location: Optional[str]) -> None: + deprecated( + reason=f"Loading egg at {location} is deprecated.", + replacement="to use pip for package installation", + gone_in="25.1", + issue=12330, + ) + + +class Environment(BaseEnvironment): + def __init__(self, paths: Sequence[str]) -> None: + self._paths = paths + + @classmethod + def default(cls) -> BaseEnvironment: + return cls(sys.path) + + @classmethod + def from_paths(cls, paths: Optional[List[str]]) -> BaseEnvironment: + if paths is None: + return cls(sys.path) + return cls(paths) + + def _iter_distributions(self) -> Iterator[BaseDistribution]: + finder = _DistributionFinder() + for location in self._paths: + yield from finder.find(location) + for dist in finder.find_eggs(location): + _emit_egg_deprecation(dist.location) + yield dist + # This must go last because that's how pkg_resources tie-breaks. + yield from finder.find_linked(location) + + def get_distribution(self, name: str) -> Optional[BaseDistribution]: + canonical_name = canonicalize_name(name) + matches = ( + distribution + for distribution in self.iter_all_distributions() + if distribution.canonical_name == canonical_name + ) + return next(matches, None) diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/metadata/pkg_resources.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/metadata/pkg_resources.py new file mode 100644 index 0000000..4ea84f9 --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/metadata/pkg_resources.py @@ -0,0 +1,301 @@ +import email.message +import email.parser +import logging +import os +import zipfile +from typing import ( + Collection, + Iterable, + Iterator, + List, + Mapping, + NamedTuple, + Optional, +) + +from pip._vendor import pkg_resources +from pip._vendor.packaging.requirements import Requirement +from pip._vendor.packaging.utils import NormalizedName, canonicalize_name +from pip._vendor.packaging.version import Version +from pip._vendor.packaging.version import parse as parse_version + +from pip._internal.exceptions import InvalidWheel, NoneMetadataError, UnsupportedWheel +from pip._internal.utils.egg_link import egg_link_path_from_location +from pip._internal.utils.misc import display_path, normalize_path +from pip._internal.utils.wheel import parse_wheel, read_wheel_metadata_file + +from .base import ( + BaseDistribution, + BaseEntryPoint, + BaseEnvironment, + InfoPath, + Wheel, +) + +__all__ = ["NAME", "Distribution", "Environment"] + +logger = logging.getLogger(__name__) + +NAME = "pkg_resources" + + +class EntryPoint(NamedTuple): + name: str + value: str + group: str + + +class InMemoryMetadata: + """IMetadataProvider that reads metadata files from a dictionary. + + This also maps metadata decoding exceptions to our internal exception type. + """ + + def __init__(self, metadata: Mapping[str, bytes], wheel_name: str) -> None: + self._metadata = metadata + self._wheel_name = wheel_name + + def has_metadata(self, name: str) -> bool: + return name in self._metadata + + def get_metadata(self, name: str) -> str: + try: + return self._metadata[name].decode() + except UnicodeDecodeError as e: + # Augment the default error with the origin of the file. + raise UnsupportedWheel( + f"Error decoding metadata for {self._wheel_name}: {e} in {name} file" + ) + + def get_metadata_lines(self, name: str) -> Iterable[str]: + return pkg_resources.yield_lines(self.get_metadata(name)) + + def metadata_isdir(self, name: str) -> bool: + return False + + def metadata_listdir(self, name: str) -> List[str]: + return [] + + def run_script(self, script_name: str, namespace: str) -> None: + pass + + +class Distribution(BaseDistribution): + def __init__(self, dist: pkg_resources.Distribution) -> None: + self._dist = dist + # This is populated lazily, to avoid loading metadata for all possible + # distributions eagerly. + self.__extra_mapping: Optional[Mapping[NormalizedName, str]] = None + + @property + def _extra_mapping(self) -> Mapping[NormalizedName, str]: + if self.__extra_mapping is None: + self.__extra_mapping = { + canonicalize_name(extra): extra for extra in self._dist.extras + } + + return self.__extra_mapping + + @classmethod + def from_directory(cls, directory: str) -> BaseDistribution: + dist_dir = directory.rstrip(os.sep) + + # Build a PathMetadata object, from path to metadata. :wink: + base_dir, dist_dir_name = os.path.split(dist_dir) + metadata = pkg_resources.PathMetadata(base_dir, dist_dir) + + # Determine the correct Distribution object type. + if dist_dir.endswith(".egg-info"): + dist_cls = pkg_resources.Distribution + dist_name = os.path.splitext(dist_dir_name)[0] + else: + assert dist_dir.endswith(".dist-info") + dist_cls = pkg_resources.DistInfoDistribution + dist_name = os.path.splitext(dist_dir_name)[0].split("-")[0] + + dist = dist_cls(base_dir, project_name=dist_name, metadata=metadata) + return cls(dist) + + @classmethod + def from_metadata_file_contents( + cls, + metadata_contents: bytes, + filename: str, + project_name: str, + ) -> BaseDistribution: + metadata_dict = { + "METADATA": metadata_contents, + } + dist = pkg_resources.DistInfoDistribution( + location=filename, + metadata=InMemoryMetadata(metadata_dict, filename), + project_name=project_name, + ) + return cls(dist) + + @classmethod + def from_wheel(cls, wheel: Wheel, name: str) -> BaseDistribution: + try: + with wheel.as_zipfile() as zf: + info_dir, _ = parse_wheel(zf, name) + metadata_dict = { + path.split("/", 1)[-1]: read_wheel_metadata_file(zf, path) + for path in zf.namelist() + if path.startswith(f"{info_dir}/") + } + except zipfile.BadZipFile as e: + raise InvalidWheel(wheel.location, name) from e + except UnsupportedWheel as e: + raise UnsupportedWheel(f"{name} has an invalid wheel, {e}") + dist = pkg_resources.DistInfoDistribution( + location=wheel.location, + metadata=InMemoryMetadata(metadata_dict, wheel.location), + project_name=name, + ) + return cls(dist) + + @property + def location(self) -> Optional[str]: + return self._dist.location + + @property + def installed_location(self) -> Optional[str]: + egg_link = egg_link_path_from_location(self.raw_name) + if egg_link: + location = egg_link + elif self.location: + location = self.location + else: + return None + return normalize_path(location) + + @property + def info_location(self) -> Optional[str]: + return self._dist.egg_info + + @property + def installed_by_distutils(self) -> bool: + # A distutils-installed distribution is provided by FileMetadata. This + # provider has a "path" attribute not present anywhere else. Not the + # best introspection logic, but pip has been doing this for a long time. + try: + return bool(self._dist._provider.path) + except AttributeError: + return False + + @property + def canonical_name(self) -> NormalizedName: + return canonicalize_name(self._dist.project_name) + + @property + def version(self) -> Version: + return parse_version(self._dist.version) + + @property + def raw_version(self) -> str: + return self._dist.version + + def is_file(self, path: InfoPath) -> bool: + return self._dist.has_metadata(str(path)) + + def iter_distutils_script_names(self) -> Iterator[str]: + yield from self._dist.metadata_listdir("scripts") + + def read_text(self, path: InfoPath) -> str: + name = str(path) + if not self._dist.has_metadata(name): + raise FileNotFoundError(name) + content = self._dist.get_metadata(name) + if content is None: + raise NoneMetadataError(self, name) + return content + + def iter_entry_points(self) -> Iterable[BaseEntryPoint]: + for group, entries in self._dist.get_entry_map().items(): + for name, entry_point in entries.items(): + name, _, value = str(entry_point).partition("=") + yield EntryPoint(name=name.strip(), value=value.strip(), group=group) + + def _metadata_impl(self) -> email.message.Message: + """ + :raises NoneMetadataError: if the distribution reports `has_metadata()` + True but `get_metadata()` returns None. + """ + if isinstance(self._dist, pkg_resources.DistInfoDistribution): + metadata_name = "METADATA" + else: + metadata_name = "PKG-INFO" + try: + metadata = self.read_text(metadata_name) + except FileNotFoundError: + if self.location: + displaying_path = display_path(self.location) + else: + displaying_path = repr(self.location) + logger.warning("No metadata found in %s", displaying_path) + metadata = "" + feed_parser = email.parser.FeedParser() + feed_parser.feed(metadata) + return feed_parser.close() + + def iter_dependencies(self, extras: Collection[str] = ()) -> Iterable[Requirement]: + if extras: + relevant_extras = set(self._extra_mapping) & set( + map(canonicalize_name, extras) + ) + extras = [self._extra_mapping[extra] for extra in relevant_extras] + return self._dist.requires(extras) + + def iter_provided_extras(self) -> Iterable[NormalizedName]: + return self._extra_mapping.keys() + + +class Environment(BaseEnvironment): + def __init__(self, ws: pkg_resources.WorkingSet) -> None: + self._ws = ws + + @classmethod + def default(cls) -> BaseEnvironment: + return cls(pkg_resources.working_set) + + @classmethod + def from_paths(cls, paths: Optional[List[str]]) -> BaseEnvironment: + return cls(pkg_resources.WorkingSet(paths)) + + def _iter_distributions(self) -> Iterator[BaseDistribution]: + for dist in self._ws: + yield Distribution(dist) + + def _search_distribution(self, name: str) -> Optional[BaseDistribution]: + """Find a distribution matching the ``name`` in the environment. + + This searches from *all* distributions available in the environment, to + match the behavior of ``pkg_resources.get_distribution()``. + """ + canonical_name = canonicalize_name(name) + for dist in self.iter_all_distributions(): + if dist.canonical_name == canonical_name: + return dist + return None + + def get_distribution(self, name: str) -> Optional[BaseDistribution]: + # Search the distribution by looking through the working set. + dist = self._search_distribution(name) + if dist: + return dist + + # If distribution could not be found, call working_set.require to + # update the working set, and try to find the distribution again. + # This might happen for e.g. when you install a package twice, once + # using setup.py develop and again using setup.py install. Now when + # running pip uninstall twice, the package gets removed from the + # working set in the first uninstall, so we have to populate the + # working set again so that pip knows about it and the packages gets + # picked up and is successfully uninstalled the second time too. + try: + # We didn't pass in any version specifiers, so this can never + # raise pkg_resources.VersionConflict. + self._ws.require(name) + except pkg_resources.DistributionNotFound: + return None + return self._search_distribution(name) diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/models/__init__.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/models/__init__.py new file mode 100644 index 0000000..7855226 --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/models/__init__.py @@ -0,0 +1,2 @@ +"""A package that contains models that represent entities. +""" diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/models/__pycache__/__init__.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/models/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000..8da3c24 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/models/__pycache__/__init__.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/models/__pycache__/candidate.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/models/__pycache__/candidate.cpython-312.pyc new file mode 100644 index 0000000..3d7dd1d Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/models/__pycache__/candidate.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/models/__pycache__/direct_url.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/models/__pycache__/direct_url.cpython-312.pyc new file mode 100644 index 0000000..d826987 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/models/__pycache__/direct_url.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/models/__pycache__/format_control.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/models/__pycache__/format_control.cpython-312.pyc new file mode 100644 index 0000000..85d44c6 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/models/__pycache__/format_control.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/models/__pycache__/index.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/models/__pycache__/index.cpython-312.pyc new file mode 100644 index 0000000..586cf37 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/models/__pycache__/index.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/models/__pycache__/installation_report.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/models/__pycache__/installation_report.cpython-312.pyc new file mode 100644 index 0000000..cb2d2bb Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/models/__pycache__/installation_report.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/models/__pycache__/link.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/models/__pycache__/link.cpython-312.pyc new file mode 100644 index 0000000..37dc656 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/models/__pycache__/link.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/models/__pycache__/scheme.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/models/__pycache__/scheme.cpython-312.pyc new file mode 100644 index 0000000..66a6c1c Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/models/__pycache__/scheme.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/models/__pycache__/search_scope.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/models/__pycache__/search_scope.cpython-312.pyc new file mode 100644 index 0000000..15ca7c2 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/models/__pycache__/search_scope.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/models/__pycache__/selection_prefs.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/models/__pycache__/selection_prefs.cpython-312.pyc new file mode 100644 index 0000000..d506b68 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/models/__pycache__/selection_prefs.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/models/__pycache__/target_python.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/models/__pycache__/target_python.cpython-312.pyc new file mode 100644 index 0000000..77bd599 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/models/__pycache__/target_python.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/models/__pycache__/wheel.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/models/__pycache__/wheel.cpython-312.pyc new file mode 100644 index 0000000..cc2092b Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/models/__pycache__/wheel.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/models/candidate.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/models/candidate.py new file mode 100644 index 0000000..f27f283 --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/models/candidate.py @@ -0,0 +1,25 @@ +from dataclasses import dataclass + +from pip._vendor.packaging.version import Version +from pip._vendor.packaging.version import parse as parse_version + +from pip._internal.models.link import Link + + +@dataclass(frozen=True) +class InstallationCandidate: + """Represents a potential "candidate" for installation.""" + + __slots__ = ["name", "version", "link"] + + name: str + version: Version + link: Link + + def __init__(self, name: str, version: str, link: Link) -> None: + object.__setattr__(self, "name", name) + object.__setattr__(self, "version", parse_version(version)) + object.__setattr__(self, "link", link) + + def __str__(self) -> str: + return f"{self.name!r} candidate (version {self.version} at {self.link})" diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/models/direct_url.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/models/direct_url.py new file mode 100644 index 0000000..fc5ec8d --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/models/direct_url.py @@ -0,0 +1,224 @@ +""" PEP 610 """ + +import json +import re +import urllib.parse +from dataclasses import dataclass +from typing import Any, ClassVar, Dict, Iterable, Optional, Type, TypeVar, Union + +__all__ = [ + "DirectUrl", + "DirectUrlValidationError", + "DirInfo", + "ArchiveInfo", + "VcsInfo", +] + +T = TypeVar("T") + +DIRECT_URL_METADATA_NAME = "direct_url.json" +ENV_VAR_RE = re.compile(r"^\$\{[A-Za-z0-9-_]+\}(:\$\{[A-Za-z0-9-_]+\})?$") + + +class DirectUrlValidationError(Exception): + pass + + +def _get( + d: Dict[str, Any], expected_type: Type[T], key: str, default: Optional[T] = None +) -> Optional[T]: + """Get value from dictionary and verify expected type.""" + if key not in d: + return default + value = d[key] + if not isinstance(value, expected_type): + raise DirectUrlValidationError( + f"{value!r} has unexpected type for {key} (expected {expected_type})" + ) + return value + + +def _get_required( + d: Dict[str, Any], expected_type: Type[T], key: str, default: Optional[T] = None +) -> T: + value = _get(d, expected_type, key, default) + if value is None: + raise DirectUrlValidationError(f"{key} must have a value") + return value + + +def _exactly_one_of(infos: Iterable[Optional["InfoType"]]) -> "InfoType": + infos = [info for info in infos if info is not None] + if not infos: + raise DirectUrlValidationError( + "missing one of archive_info, dir_info, vcs_info" + ) + if len(infos) > 1: + raise DirectUrlValidationError( + "more than one of archive_info, dir_info, vcs_info" + ) + assert infos[0] is not None + return infos[0] + + +def _filter_none(**kwargs: Any) -> Dict[str, Any]: + """Make dict excluding None values.""" + return {k: v for k, v in kwargs.items() if v is not None} + + +@dataclass +class VcsInfo: + name: ClassVar = "vcs_info" + + vcs: str + commit_id: str + requested_revision: Optional[str] = None + + @classmethod + def _from_dict(cls, d: Optional[Dict[str, Any]]) -> Optional["VcsInfo"]: + if d is None: + return None + return cls( + vcs=_get_required(d, str, "vcs"), + commit_id=_get_required(d, str, "commit_id"), + requested_revision=_get(d, str, "requested_revision"), + ) + + def _to_dict(self) -> Dict[str, Any]: + return _filter_none( + vcs=self.vcs, + requested_revision=self.requested_revision, + commit_id=self.commit_id, + ) + + +class ArchiveInfo: + name = "archive_info" + + def __init__( + self, + hash: Optional[str] = None, + hashes: Optional[Dict[str, str]] = None, + ) -> None: + # set hashes before hash, since the hash setter will further populate hashes + self.hashes = hashes + self.hash = hash + + @property + def hash(self) -> Optional[str]: + return self._hash + + @hash.setter + def hash(self, value: Optional[str]) -> None: + if value is not None: + # Auto-populate the hashes key to upgrade to the new format automatically. + # We don't back-populate the legacy hash key from hashes. + try: + hash_name, hash_value = value.split("=", 1) + except ValueError: + raise DirectUrlValidationError( + f"invalid archive_info.hash format: {value!r}" + ) + if self.hashes is None: + self.hashes = {hash_name: hash_value} + elif hash_name not in self.hashes: + self.hashes = self.hashes.copy() + self.hashes[hash_name] = hash_value + self._hash = value + + @classmethod + def _from_dict(cls, d: Optional[Dict[str, Any]]) -> Optional["ArchiveInfo"]: + if d is None: + return None + return cls(hash=_get(d, str, "hash"), hashes=_get(d, dict, "hashes")) + + def _to_dict(self) -> Dict[str, Any]: + return _filter_none(hash=self.hash, hashes=self.hashes) + + +@dataclass +class DirInfo: + name: ClassVar = "dir_info" + + editable: bool = False + + @classmethod + def _from_dict(cls, d: Optional[Dict[str, Any]]) -> Optional["DirInfo"]: + if d is None: + return None + return cls(editable=_get_required(d, bool, "editable", default=False)) + + def _to_dict(self) -> Dict[str, Any]: + return _filter_none(editable=self.editable or None) + + +InfoType = Union[ArchiveInfo, DirInfo, VcsInfo] + + +@dataclass +class DirectUrl: + url: str + info: InfoType + subdirectory: Optional[str] = None + + def _remove_auth_from_netloc(self, netloc: str) -> str: + if "@" not in netloc: + return netloc + user_pass, netloc_no_user_pass = netloc.split("@", 1) + if ( + isinstance(self.info, VcsInfo) + and self.info.vcs == "git" + and user_pass == "git" + ): + return netloc + if ENV_VAR_RE.match(user_pass): + return netloc + return netloc_no_user_pass + + @property + def redacted_url(self) -> str: + """url with user:password part removed unless it is formed with + environment variables as specified in PEP 610, or it is ``git`` + in the case of a git URL. + """ + purl = urllib.parse.urlsplit(self.url) + netloc = self._remove_auth_from_netloc(purl.netloc) + surl = urllib.parse.urlunsplit( + (purl.scheme, netloc, purl.path, purl.query, purl.fragment) + ) + return surl + + def validate(self) -> None: + self.from_dict(self.to_dict()) + + @classmethod + def from_dict(cls, d: Dict[str, Any]) -> "DirectUrl": + return DirectUrl( + url=_get_required(d, str, "url"), + subdirectory=_get(d, str, "subdirectory"), + info=_exactly_one_of( + [ + ArchiveInfo._from_dict(_get(d, dict, "archive_info")), + DirInfo._from_dict(_get(d, dict, "dir_info")), + VcsInfo._from_dict(_get(d, dict, "vcs_info")), + ] + ), + ) + + def to_dict(self) -> Dict[str, Any]: + res = _filter_none( + url=self.redacted_url, + subdirectory=self.subdirectory, + ) + res[self.info.name] = self.info._to_dict() + return res + + @classmethod + def from_json(cls, s: str) -> "DirectUrl": + return cls.from_dict(json.loads(s)) + + def to_json(self) -> str: + return json.dumps(self.to_dict(), sort_keys=True) + + def is_local_editable(self) -> bool: + return isinstance(self.info, DirInfo) and self.info.editable diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/models/format_control.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/models/format_control.py new file mode 100644 index 0000000..ccd1127 --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/models/format_control.py @@ -0,0 +1,78 @@ +from typing import FrozenSet, Optional, Set + +from pip._vendor.packaging.utils import canonicalize_name + +from pip._internal.exceptions import CommandError + + +class FormatControl: + """Helper for managing formats from which a package can be installed.""" + + __slots__ = ["no_binary", "only_binary"] + + def __init__( + self, + no_binary: Optional[Set[str]] = None, + only_binary: Optional[Set[str]] = None, + ) -> None: + if no_binary is None: + no_binary = set() + if only_binary is None: + only_binary = set() + + self.no_binary = no_binary + self.only_binary = only_binary + + def __eq__(self, other: object) -> bool: + if not isinstance(other, self.__class__): + return NotImplemented + + if self.__slots__ != other.__slots__: + return False + + return all(getattr(self, k) == getattr(other, k) for k in self.__slots__) + + def __repr__(self) -> str: + return f"{self.__class__.__name__}({self.no_binary}, {self.only_binary})" + + @staticmethod + def handle_mutual_excludes(value: str, target: Set[str], other: Set[str]) -> None: + if value.startswith("-"): + raise CommandError( + "--no-binary / --only-binary option requires 1 argument." + ) + new = value.split(",") + while ":all:" in new: + other.clear() + target.clear() + target.add(":all:") + del new[: new.index(":all:") + 1] + # Without a none, we want to discard everything as :all: covers it + if ":none:" not in new: + return + for name in new: + if name == ":none:": + target.clear() + continue + name = canonicalize_name(name) + other.discard(name) + target.add(name) + + def get_allowed_formats(self, canonical_name: str) -> FrozenSet[str]: + result = {"binary", "source"} + if canonical_name in self.only_binary: + result.discard("source") + elif canonical_name in self.no_binary: + result.discard("binary") + elif ":all:" in self.only_binary: + result.discard("source") + elif ":all:" in self.no_binary: + result.discard("binary") + return frozenset(result) + + def disallow_binaries(self) -> None: + self.handle_mutual_excludes( + ":all:", + self.no_binary, + self.only_binary, + ) diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/models/index.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/models/index.py new file mode 100644 index 0000000..b94c325 --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/models/index.py @@ -0,0 +1,28 @@ +import urllib.parse + + +class PackageIndex: + """Represents a Package Index and provides easier access to endpoints""" + + __slots__ = ["url", "netloc", "simple_url", "pypi_url", "file_storage_domain"] + + def __init__(self, url: str, file_storage_domain: str) -> None: + super().__init__() + self.url = url + self.netloc = urllib.parse.urlsplit(url).netloc + self.simple_url = self._url_for_path("simple") + self.pypi_url = self._url_for_path("pypi") + + # This is part of a temporary hack used to block installs of PyPI + # packages which depend on external urls only necessary until PyPI can + # block such packages themselves + self.file_storage_domain = file_storage_domain + + def _url_for_path(self, path: str) -> str: + return urllib.parse.urljoin(self.url, path) + + +PyPI = PackageIndex("https://pypi.org/", file_storage_domain="files.pythonhosted.org") +TestPyPI = PackageIndex( + "https://test.pypi.org/", file_storage_domain="test-files.pythonhosted.org" +) diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/models/installation_report.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/models/installation_report.py new file mode 100644 index 0000000..b9c6330 --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/models/installation_report.py @@ -0,0 +1,56 @@ +from typing import Any, Dict, Sequence + +from pip._vendor.packaging.markers import default_environment + +from pip import __version__ +from pip._internal.req.req_install import InstallRequirement + + +class InstallationReport: + def __init__(self, install_requirements: Sequence[InstallRequirement]): + self._install_requirements = install_requirements + + @classmethod + def _install_req_to_dict(cls, ireq: InstallRequirement) -> Dict[str, Any]: + assert ireq.download_info, f"No download_info for {ireq}" + res = { + # PEP 610 json for the download URL. download_info.archive_info.hashes may + # be absent when the requirement was installed from the wheel cache + # and the cache entry was populated by an older pip version that did not + # record origin.json. + "download_info": ireq.download_info.to_dict(), + # is_direct is true if the requirement was a direct URL reference (which + # includes editable requirements), and false if the requirement was + # downloaded from a PEP 503 index or --find-links. + "is_direct": ireq.is_direct, + # is_yanked is true if the requirement was yanked from the index, but + # was still selected by pip to conform to PEP 592. + "is_yanked": ireq.link.is_yanked if ireq.link else False, + # requested is true if the requirement was specified by the user (aka + # top level requirement), and false if it was installed as a dependency of a + # requirement. https://peps.python.org/pep-0376/#requested + "requested": ireq.user_supplied, + # PEP 566 json encoding for metadata + # https://www.python.org/dev/peps/pep-0566/#json-compatible-metadata + "metadata": ireq.get_dist().metadata_dict, + } + if ireq.user_supplied and ireq.extras: + # For top level requirements, the list of requested extras, if any. + res["requested_extras"] = sorted(ireq.extras) + return res + + def to_dict(self) -> Dict[str, Any]: + return { + "version": "1", + "pip_version": __version__, + "install": [ + self._install_req_to_dict(ireq) for ireq in self._install_requirements + ], + # https://peps.python.org/pep-0508/#environment-markers + # TODO: currently, the resolver uses the default environment to evaluate + # environment markers, so that is what we report here. In the future, it + # should also take into account options such as --python-version or + # --platform, perhaps under the form of an environment_override field? + # https://github.com/pypa/pip/issues/11198 + "environment": default_environment(), + } diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/models/link.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/models/link.py new file mode 100644 index 0000000..27ad016 --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/models/link.py @@ -0,0 +1,604 @@ +import functools +import itertools +import logging +import os +import posixpath +import re +import urllib.parse +from dataclasses import dataclass +from typing import ( + TYPE_CHECKING, + Any, + Dict, + List, + Mapping, + NamedTuple, + Optional, + Tuple, + Union, +) + +from pip._internal.utils.deprecation import deprecated +from pip._internal.utils.filetypes import WHEEL_EXTENSION +from pip._internal.utils.hashes import Hashes +from pip._internal.utils.misc import ( + pairwise, + redact_auth_from_url, + split_auth_from_netloc, + splitext, +) +from pip._internal.utils.urls import path_to_url, url_to_path + +if TYPE_CHECKING: + from pip._internal.index.collector import IndexContent + +logger = logging.getLogger(__name__) + + +# Order matters, earlier hashes have a precedence over later hashes for what +# we will pick to use. +_SUPPORTED_HASHES = ("sha512", "sha384", "sha256", "sha224", "sha1", "md5") + + +@dataclass(frozen=True) +class LinkHash: + """Links to content may have embedded hash values. This class parses those. + + `name` must be any member of `_SUPPORTED_HASHES`. + + This class can be converted to and from `ArchiveInfo`. While ArchiveInfo intends to + be JSON-serializable to conform to PEP 610, this class contains the logic for + parsing a hash name and value for correctness, and then checking whether that hash + conforms to a schema with `.is_hash_allowed()`.""" + + name: str + value: str + + _hash_url_fragment_re = re.compile( + # NB: we do not validate that the second group (.*) is a valid hex + # digest. Instead, we simply keep that string in this class, and then check it + # against Hashes when hash-checking is needed. This is easier to debug than + # proactively discarding an invalid hex digest, as we handle incorrect hashes + # and malformed hashes in the same place. + r"[#&]({choices})=([^&]*)".format( + choices="|".join(re.escape(hash_name) for hash_name in _SUPPORTED_HASHES) + ), + ) + + def __post_init__(self) -> None: + assert self.name in _SUPPORTED_HASHES + + @classmethod + @functools.lru_cache(maxsize=None) + def find_hash_url_fragment(cls, url: str) -> Optional["LinkHash"]: + """Search a string for a checksum algorithm name and encoded output value.""" + match = cls._hash_url_fragment_re.search(url) + if match is None: + return None + name, value = match.groups() + return cls(name=name, value=value) + + def as_dict(self) -> Dict[str, str]: + return {self.name: self.value} + + def as_hashes(self) -> Hashes: + """Return a Hashes instance which checks only for the current hash.""" + return Hashes({self.name: [self.value]}) + + def is_hash_allowed(self, hashes: Optional[Hashes]) -> bool: + """ + Return True if the current hash is allowed by `hashes`. + """ + if hashes is None: + return False + return hashes.is_hash_allowed(self.name, hex_digest=self.value) + + +@dataclass(frozen=True) +class MetadataFile: + """Information about a core metadata file associated with a distribution.""" + + hashes: Optional[Dict[str, str]] + + def __post_init__(self) -> None: + if self.hashes is not None: + assert all(name in _SUPPORTED_HASHES for name in self.hashes) + + +def supported_hashes(hashes: Optional[Dict[str, str]]) -> Optional[Dict[str, str]]: + # Remove any unsupported hash types from the mapping. If this leaves no + # supported hashes, return None + if hashes is None: + return None + hashes = {n: v for n, v in hashes.items() if n in _SUPPORTED_HASHES} + if not hashes: + return None + return hashes + + +def _clean_url_path_part(part: str) -> str: + """ + Clean a "part" of a URL path (i.e. after splitting on "@" characters). + """ + # We unquote prior to quoting to make sure nothing is double quoted. + return urllib.parse.quote(urllib.parse.unquote(part)) + + +def _clean_file_url_path(part: str) -> str: + """ + Clean the first part of a URL path that corresponds to a local + filesystem path (i.e. the first part after splitting on "@" characters). + """ + # We unquote prior to quoting to make sure nothing is double quoted. + # Also, on Windows the path part might contain a drive letter which + # should not be quoted. On Linux where drive letters do not + # exist, the colon should be quoted. We rely on urllib.request + # to do the right thing here. + return urllib.request.pathname2url(urllib.request.url2pathname(part)) + + +# percent-encoded: / +_reserved_chars_re = re.compile("(@|%2F)", re.IGNORECASE) + + +def _clean_url_path(path: str, is_local_path: bool) -> str: + """ + Clean the path portion of a URL. + """ + if is_local_path: + clean_func = _clean_file_url_path + else: + clean_func = _clean_url_path_part + + # Split on the reserved characters prior to cleaning so that + # revision strings in VCS URLs are properly preserved. + parts = _reserved_chars_re.split(path) + + cleaned_parts = [] + for to_clean, reserved in pairwise(itertools.chain(parts, [""])): + cleaned_parts.append(clean_func(to_clean)) + # Normalize %xx escapes (e.g. %2f -> %2F) + cleaned_parts.append(reserved.upper()) + + return "".join(cleaned_parts) + + +def _ensure_quoted_url(url: str) -> str: + """ + Make sure a link is fully quoted. + For example, if ' ' occurs in the URL, it will be replaced with "%20", + and without double-quoting other characters. + """ + # Split the URL into parts according to the general structure + # `scheme://netloc/path?query#fragment`. + result = urllib.parse.urlsplit(url) + # If the netloc is empty, then the URL refers to a local filesystem path. + is_local_path = not result.netloc + path = _clean_url_path(result.path, is_local_path=is_local_path) + return urllib.parse.urlunsplit(result._replace(path=path)) + + +def _absolute_link_url(base_url: str, url: str) -> str: + """ + A faster implementation of urllib.parse.urljoin with a shortcut + for absolute http/https URLs. + """ + if url.startswith(("https://", "http://")): + return url + else: + return urllib.parse.urljoin(base_url, url) + + +@functools.total_ordering +class Link: + """Represents a parsed link from a Package Index's simple URL""" + + __slots__ = [ + "_parsed_url", + "_url", + "_path", + "_hashes", + "comes_from", + "requires_python", + "yanked_reason", + "metadata_file_data", + "cache_link_parsing", + "egg_fragment", + ] + + def __init__( + self, + url: str, + comes_from: Optional[Union[str, "IndexContent"]] = None, + requires_python: Optional[str] = None, + yanked_reason: Optional[str] = None, + metadata_file_data: Optional[MetadataFile] = None, + cache_link_parsing: bool = True, + hashes: Optional[Mapping[str, str]] = None, + ) -> None: + """ + :param url: url of the resource pointed to (href of the link) + :param comes_from: instance of IndexContent where the link was found, + or string. + :param requires_python: String containing the `Requires-Python` + metadata field, specified in PEP 345. This may be specified by + a data-requires-python attribute in the HTML link tag, as + described in PEP 503. + :param yanked_reason: the reason the file has been yanked, if the + file has been yanked, or None if the file hasn't been yanked. + This is the value of the "data-yanked" attribute, if present, in + a simple repository HTML link. If the file has been yanked but + no reason was provided, this should be the empty string. See + PEP 592 for more information and the specification. + :param metadata_file_data: the metadata attached to the file, or None if + no such metadata is provided. This argument, if not None, indicates + that a separate metadata file exists, and also optionally supplies + hashes for that file. + :param cache_link_parsing: A flag that is used elsewhere to determine + whether resources retrieved from this link should be cached. PyPI + URLs should generally have this set to False, for example. + :param hashes: A mapping of hash names to digests to allow us to + determine the validity of a download. + """ + + # The comes_from, requires_python, and metadata_file_data arguments are + # only used by classmethods of this class, and are not used in client + # code directly. + + # url can be a UNC windows share + if url.startswith("\\\\"): + url = path_to_url(url) + + self._parsed_url = urllib.parse.urlsplit(url) + # Store the url as a private attribute to prevent accidentally + # trying to set a new value. + self._url = url + # The .path property is hot, so calculate its value ahead of time. + self._path = urllib.parse.unquote(self._parsed_url.path) + + link_hash = LinkHash.find_hash_url_fragment(url) + hashes_from_link = {} if link_hash is None else link_hash.as_dict() + if hashes is None: + self._hashes = hashes_from_link + else: + self._hashes = {**hashes, **hashes_from_link} + + self.comes_from = comes_from + self.requires_python = requires_python if requires_python else None + self.yanked_reason = yanked_reason + self.metadata_file_data = metadata_file_data + + self.cache_link_parsing = cache_link_parsing + self.egg_fragment = self._egg_fragment() + + @classmethod + def from_json( + cls, + file_data: Dict[str, Any], + page_url: str, + ) -> Optional["Link"]: + """ + Convert an pypi json document from a simple repository page into a Link. + """ + file_url = file_data.get("url") + if file_url is None: + return None + + url = _ensure_quoted_url(_absolute_link_url(page_url, file_url)) + pyrequire = file_data.get("requires-python") + yanked_reason = file_data.get("yanked") + hashes = file_data.get("hashes", {}) + + # PEP 714: Indexes must use the name core-metadata, but + # clients should support the old name as a fallback for compatibility. + metadata_info = file_data.get("core-metadata") + if metadata_info is None: + metadata_info = file_data.get("dist-info-metadata") + + # The metadata info value may be a boolean, or a dict of hashes. + if isinstance(metadata_info, dict): + # The file exists, and hashes have been supplied + metadata_file_data = MetadataFile(supported_hashes(metadata_info)) + elif metadata_info: + # The file exists, but there are no hashes + metadata_file_data = MetadataFile(None) + else: + # False or not present: the file does not exist + metadata_file_data = None + + # The Link.yanked_reason expects an empty string instead of a boolean. + if yanked_reason and not isinstance(yanked_reason, str): + yanked_reason = "" + # The Link.yanked_reason expects None instead of False. + elif not yanked_reason: + yanked_reason = None + + return cls( + url, + comes_from=page_url, + requires_python=pyrequire, + yanked_reason=yanked_reason, + hashes=hashes, + metadata_file_data=metadata_file_data, + ) + + @classmethod + def from_element( + cls, + anchor_attribs: Dict[str, Optional[str]], + page_url: str, + base_url: str, + ) -> Optional["Link"]: + """ + Convert an anchor element's attributes in a simple repository page to a Link. + """ + href = anchor_attribs.get("href") + if not href: + return None + + url = _ensure_quoted_url(_absolute_link_url(base_url, href)) + pyrequire = anchor_attribs.get("data-requires-python") + yanked_reason = anchor_attribs.get("data-yanked") + + # PEP 714: Indexes must use the name data-core-metadata, but + # clients should support the old name as a fallback for compatibility. + metadata_info = anchor_attribs.get("data-core-metadata") + if metadata_info is None: + metadata_info = anchor_attribs.get("data-dist-info-metadata") + # The metadata info value may be the string "true", or a string of + # the form "hashname=hashval" + if metadata_info == "true": + # The file exists, but there are no hashes + metadata_file_data = MetadataFile(None) + elif metadata_info is None: + # The file does not exist + metadata_file_data = None + else: + # The file exists, and hashes have been supplied + hashname, sep, hashval = metadata_info.partition("=") + if sep == "=": + metadata_file_data = MetadataFile(supported_hashes({hashname: hashval})) + else: + # Error - data is wrong. Treat as no hashes supplied. + logger.debug( + "Index returned invalid data-dist-info-metadata value: %s", + metadata_info, + ) + metadata_file_data = MetadataFile(None) + + return cls( + url, + comes_from=page_url, + requires_python=pyrequire, + yanked_reason=yanked_reason, + metadata_file_data=metadata_file_data, + ) + + def __str__(self) -> str: + if self.requires_python: + rp = f" (requires-python:{self.requires_python})" + else: + rp = "" + if self.comes_from: + return f"{redact_auth_from_url(self._url)} (from {self.comes_from}){rp}" + else: + return redact_auth_from_url(str(self._url)) + + def __repr__(self) -> str: + return f"" + + def __hash__(self) -> int: + return hash(self.url) + + def __eq__(self, other: Any) -> bool: + if not isinstance(other, Link): + return NotImplemented + return self.url == other.url + + def __lt__(self, other: Any) -> bool: + if not isinstance(other, Link): + return NotImplemented + return self.url < other.url + + @property + def url(self) -> str: + return self._url + + @property + def filename(self) -> str: + path = self.path.rstrip("/") + name = posixpath.basename(path) + if not name: + # Make sure we don't leak auth information if the netloc + # includes a username and password. + netloc, user_pass = split_auth_from_netloc(self.netloc) + return netloc + + name = urllib.parse.unquote(name) + assert name, f"URL {self._url!r} produced no filename" + return name + + @property + def file_path(self) -> str: + return url_to_path(self.url) + + @property + def scheme(self) -> str: + return self._parsed_url.scheme + + @property + def netloc(self) -> str: + """ + This can contain auth information. + """ + return self._parsed_url.netloc + + @property + def path(self) -> str: + return self._path + + def splitext(self) -> Tuple[str, str]: + return splitext(posixpath.basename(self.path.rstrip("/"))) + + @property + def ext(self) -> str: + return self.splitext()[1] + + @property + def url_without_fragment(self) -> str: + scheme, netloc, path, query, fragment = self._parsed_url + return urllib.parse.urlunsplit((scheme, netloc, path, query, "")) + + _egg_fragment_re = re.compile(r"[#&]egg=([^&]*)") + + # Per PEP 508. + _project_name_re = re.compile( + r"^([A-Z0-9]|[A-Z0-9][A-Z0-9._-]*[A-Z0-9])$", re.IGNORECASE + ) + + def _egg_fragment(self) -> Optional[str]: + match = self._egg_fragment_re.search(self._url) + if not match: + return None + + # An egg fragment looks like a PEP 508 project name, along with + # an optional extras specifier. Anything else is invalid. + project_name = match.group(1) + if not self._project_name_re.match(project_name): + deprecated( + reason=f"{self} contains an egg fragment with a non-PEP 508 name.", + replacement="to use the req @ url syntax, and remove the egg fragment", + gone_in="25.1", + issue=13157, + ) + + return project_name + + _subdirectory_fragment_re = re.compile(r"[#&]subdirectory=([^&]*)") + + @property + def subdirectory_fragment(self) -> Optional[str]: + match = self._subdirectory_fragment_re.search(self._url) + if not match: + return None + return match.group(1) + + def metadata_link(self) -> Optional["Link"]: + """Return a link to the associated core metadata file (if any).""" + if self.metadata_file_data is None: + return None + metadata_url = f"{self.url_without_fragment}.metadata" + if self.metadata_file_data.hashes is None: + return Link(metadata_url) + return Link(metadata_url, hashes=self.metadata_file_data.hashes) + + def as_hashes(self) -> Hashes: + return Hashes({k: [v] for k, v in self._hashes.items()}) + + @property + def hash(self) -> Optional[str]: + return next(iter(self._hashes.values()), None) + + @property + def hash_name(self) -> Optional[str]: + return next(iter(self._hashes), None) + + @property + def show_url(self) -> str: + return posixpath.basename(self._url.split("#", 1)[0].split("?", 1)[0]) + + @property + def is_file(self) -> bool: + return self.scheme == "file" + + def is_existing_dir(self) -> bool: + return self.is_file and os.path.isdir(self.file_path) + + @property + def is_wheel(self) -> bool: + return self.ext == WHEEL_EXTENSION + + @property + def is_vcs(self) -> bool: + from pip._internal.vcs import vcs + + return self.scheme in vcs.all_schemes + + @property + def is_yanked(self) -> bool: + return self.yanked_reason is not None + + @property + def has_hash(self) -> bool: + return bool(self._hashes) + + def is_hash_allowed(self, hashes: Optional[Hashes]) -> bool: + """ + Return True if the link has a hash and it is allowed by `hashes`. + """ + if hashes is None: + return False + return any(hashes.is_hash_allowed(k, v) for k, v in self._hashes.items()) + + +class _CleanResult(NamedTuple): + """Convert link for equivalency check. + + This is used in the resolver to check whether two URL-specified requirements + likely point to the same distribution and can be considered equivalent. This + equivalency logic avoids comparing URLs literally, which can be too strict + (e.g. "a=1&b=2" vs "b=2&a=1") and produce conflicts unexpecting to users. + + Currently this does three things: + + 1. Drop the basic auth part. This is technically wrong since a server can + serve different content based on auth, but if it does that, it is even + impossible to guarantee two URLs without auth are equivalent, since + the user can input different auth information when prompted. So the + practical solution is to assume the auth doesn't affect the response. + 2. Parse the query to avoid the ordering issue. Note that ordering under the + same key in the query are NOT cleaned; i.e. "a=1&a=2" and "a=2&a=1" are + still considered different. + 3. Explicitly drop most of the fragment part, except ``subdirectory=`` and + hash values, since it should have no impact the downloaded content. Note + that this drops the "egg=" part historically used to denote the requested + project (and extras), which is wrong in the strictest sense, but too many + people are supplying it inconsistently to cause superfluous resolution + conflicts, so we choose to also ignore them. + """ + + parsed: urllib.parse.SplitResult + query: Dict[str, List[str]] + subdirectory: str + hashes: Dict[str, str] + + +def _clean_link(link: Link) -> _CleanResult: + parsed = link._parsed_url + netloc = parsed.netloc.rsplit("@", 1)[-1] + # According to RFC 8089, an empty host in file: means localhost. + if parsed.scheme == "file" and not netloc: + netloc = "localhost" + fragment = urllib.parse.parse_qs(parsed.fragment) + if "egg" in fragment: + logger.debug("Ignoring egg= fragment in %s", link) + try: + # If there are multiple subdirectory values, use the first one. + # This matches the behavior of Link.subdirectory_fragment. + subdirectory = fragment["subdirectory"][0] + except (IndexError, KeyError): + subdirectory = "" + # If there are multiple hash values under the same algorithm, use the + # first one. This matches the behavior of Link.hash_value. + hashes = {k: fragment[k][0] for k in _SUPPORTED_HASHES if k in fragment} + return _CleanResult( + parsed=parsed._replace(netloc=netloc, query="", fragment=""), + query=urllib.parse.parse_qs(parsed.query), + subdirectory=subdirectory, + hashes=hashes, + ) + + +@functools.lru_cache(maxsize=None) +def links_equivalent(link1: Link, link2: Link) -> bool: + return _clean_link(link1) == _clean_link(link2) diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/models/scheme.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/models/scheme.py new file mode 100644 index 0000000..06a9a55 --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/models/scheme.py @@ -0,0 +1,25 @@ +""" +For types associated with installation schemes. + +For a general overview of available schemes and their context, see +https://docs.python.org/3/install/index.html#alternate-installation. +""" + +from dataclasses import dataclass + +SCHEME_KEYS = ["platlib", "purelib", "headers", "scripts", "data"] + + +@dataclass(frozen=True) +class Scheme: + """A Scheme holds paths which are used as the base directories for + artifacts associated with a Python package. + """ + + __slots__ = SCHEME_KEYS + + platlib: str + purelib: str + headers: str + scripts: str + data: str diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/models/search_scope.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/models/search_scope.py new file mode 100644 index 0000000..ee7bc86 --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/models/search_scope.py @@ -0,0 +1,127 @@ +import itertools +import logging +import os +import posixpath +import urllib.parse +from dataclasses import dataclass +from typing import List + +from pip._vendor.packaging.utils import canonicalize_name + +from pip._internal.models.index import PyPI +from pip._internal.utils.compat import has_tls +from pip._internal.utils.misc import normalize_path, redact_auth_from_url + +logger = logging.getLogger(__name__) + + +@dataclass(frozen=True) +class SearchScope: + """ + Encapsulates the locations that pip is configured to search. + """ + + __slots__ = ["find_links", "index_urls", "no_index"] + + find_links: List[str] + index_urls: List[str] + no_index: bool + + @classmethod + def create( + cls, + find_links: List[str], + index_urls: List[str], + no_index: bool, + ) -> "SearchScope": + """ + Create a SearchScope object after normalizing the `find_links`. + """ + # Build find_links. If an argument starts with ~, it may be + # a local file relative to a home directory. So try normalizing + # it and if it exists, use the normalized version. + # This is deliberately conservative - it might be fine just to + # blindly normalize anything starting with a ~... + built_find_links: List[str] = [] + for link in find_links: + if link.startswith("~"): + new_link = normalize_path(link) + if os.path.exists(new_link): + link = new_link + built_find_links.append(link) + + # If we don't have TLS enabled, then WARN if anyplace we're looking + # relies on TLS. + if not has_tls(): + for link in itertools.chain(index_urls, built_find_links): + parsed = urllib.parse.urlparse(link) + if parsed.scheme == "https": + logger.warning( + "pip is configured with locations that require " + "TLS/SSL, however the ssl module in Python is not " + "available." + ) + break + + return cls( + find_links=built_find_links, + index_urls=index_urls, + no_index=no_index, + ) + + def get_formatted_locations(self) -> str: + lines = [] + redacted_index_urls = [] + if self.index_urls and self.index_urls != [PyPI.simple_url]: + for url in self.index_urls: + redacted_index_url = redact_auth_from_url(url) + + # Parse the URL + purl = urllib.parse.urlsplit(redacted_index_url) + + # URL is generally invalid if scheme and netloc is missing + # there are issues with Python and URL parsing, so this test + # is a bit crude. See bpo-20271, bpo-23505. Python doesn't + # always parse invalid URLs correctly - it should raise + # exceptions for malformed URLs + if not purl.scheme and not purl.netloc: + logger.warning( + 'The index url "%s" seems invalid, please provide a scheme.', + redacted_index_url, + ) + + redacted_index_urls.append(redacted_index_url) + + lines.append( + "Looking in indexes: {}".format(", ".join(redacted_index_urls)) + ) + + if self.find_links: + lines.append( + "Looking in links: {}".format( + ", ".join(redact_auth_from_url(url) for url in self.find_links) + ) + ) + return "\n".join(lines) + + def get_index_urls_locations(self, project_name: str) -> List[str]: + """Returns the locations found via self.index_urls + + Checks the url_name on the main (first in the list) index and + use this url_name to produce all locations + """ + + def mkurl_pypi_url(url: str) -> str: + loc = posixpath.join( + url, urllib.parse.quote(canonicalize_name(project_name)) + ) + # For maximum compatibility with easy_install, ensure the path + # ends in a trailing slash. Although this isn't in the spec + # (and PyPI can handle it without the slash) some other index + # implementations might break if they relied on easy_install's + # behavior. + if not loc.endswith("/"): + loc = loc + "/" + return loc + + return [mkurl_pypi_url(url) for url in self.index_urls] diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/models/selection_prefs.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/models/selection_prefs.py new file mode 100644 index 0000000..e9b50aa --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/models/selection_prefs.py @@ -0,0 +1,53 @@ +from typing import Optional + +from pip._internal.models.format_control import FormatControl + + +# TODO: This needs Python 3.10's improved slots support for dataclasses +# to be converted into a dataclass. +class SelectionPreferences: + """ + Encapsulates the candidate selection preferences for downloading + and installing files. + """ + + __slots__ = [ + "allow_yanked", + "allow_all_prereleases", + "format_control", + "prefer_binary", + "ignore_requires_python", + ] + + # Don't include an allow_yanked default value to make sure each call + # site considers whether yanked releases are allowed. This also causes + # that decision to be made explicit in the calling code, which helps + # people when reading the code. + def __init__( + self, + allow_yanked: bool, + allow_all_prereleases: bool = False, + format_control: Optional[FormatControl] = None, + prefer_binary: bool = False, + ignore_requires_python: Optional[bool] = None, + ) -> None: + """Create a SelectionPreferences object. + + :param allow_yanked: Whether files marked as yanked (in the sense + of PEP 592) are permitted to be candidates for install. + :param format_control: A FormatControl object or None. Used to control + the selection of source packages / binary packages when consulting + the index and links. + :param prefer_binary: Whether to prefer an old, but valid, binary + dist over a new source dist. + :param ignore_requires_python: Whether to ignore incompatible + "Requires-Python" values in links. Defaults to False. + """ + if ignore_requires_python is None: + ignore_requires_python = False + + self.allow_yanked = allow_yanked + self.allow_all_prereleases = allow_all_prereleases + self.format_control = format_control + self.prefer_binary = prefer_binary + self.ignore_requires_python = ignore_requires_python diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/models/target_python.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/models/target_python.py new file mode 100644 index 0000000..88925a9 --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/models/target_python.py @@ -0,0 +1,121 @@ +import sys +from typing import List, Optional, Set, Tuple + +from pip._vendor.packaging.tags import Tag + +from pip._internal.utils.compatibility_tags import get_supported, version_info_to_nodot +from pip._internal.utils.misc import normalize_version_info + + +class TargetPython: + """ + Encapsulates the properties of a Python interpreter one is targeting + for a package install, download, etc. + """ + + __slots__ = [ + "_given_py_version_info", + "abis", + "implementation", + "platforms", + "py_version", + "py_version_info", + "_valid_tags", + "_valid_tags_set", + ] + + def __init__( + self, + platforms: Optional[List[str]] = None, + py_version_info: Optional[Tuple[int, ...]] = None, + abis: Optional[List[str]] = None, + implementation: Optional[str] = None, + ) -> None: + """ + :param platforms: A list of strings or None. If None, searches for + packages that are supported by the current system. Otherwise, will + find packages that can be built on the platforms passed in. These + packages will only be downloaded for distribution: they will + not be built locally. + :param py_version_info: An optional tuple of ints representing the + Python version information to use (e.g. `sys.version_info[:3]`). + This can have length 1, 2, or 3 when provided. + :param abis: A list of strings or None. This is passed to + compatibility_tags.py's get_supported() function as is. + :param implementation: A string or None. This is passed to + compatibility_tags.py's get_supported() function as is. + """ + # Store the given py_version_info for when we call get_supported(). + self._given_py_version_info = py_version_info + + if py_version_info is None: + py_version_info = sys.version_info[:3] + else: + py_version_info = normalize_version_info(py_version_info) + + py_version = ".".join(map(str, py_version_info[:2])) + + self.abis = abis + self.implementation = implementation + self.platforms = platforms + self.py_version = py_version + self.py_version_info = py_version_info + + # This is used to cache the return value of get_(un)sorted_tags. + self._valid_tags: Optional[List[Tag]] = None + self._valid_tags_set: Optional[Set[Tag]] = None + + def format_given(self) -> str: + """ + Format the given, non-None attributes for display. + """ + display_version = None + if self._given_py_version_info is not None: + display_version = ".".join( + str(part) for part in self._given_py_version_info + ) + + key_values = [ + ("platforms", self.platforms), + ("version_info", display_version), + ("abis", self.abis), + ("implementation", self.implementation), + ] + return " ".join( + f"{key}={value!r}" for key, value in key_values if value is not None + ) + + def get_sorted_tags(self) -> List[Tag]: + """ + Return the supported PEP 425 tags to check wheel candidates against. + + The tags are returned in order of preference (most preferred first). + """ + if self._valid_tags is None: + # Pass versions=None if no py_version_info was given since + # versions=None uses special default logic. + py_version_info = self._given_py_version_info + if py_version_info is None: + version = None + else: + version = version_info_to_nodot(py_version_info) + + tags = get_supported( + version=version, + platforms=self.platforms, + abis=self.abis, + impl=self.implementation, + ) + self._valid_tags = tags + + return self._valid_tags + + def get_unsorted_tags(self) -> Set[Tag]: + """Exactly the same as get_sorted_tags, but returns a set. + + This is important for performance. + """ + if self._valid_tags_set is None: + self._valid_tags_set = set(self.get_sorted_tags()) + + return self._valid_tags_set diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/models/wheel.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/models/wheel.py new file mode 100644 index 0000000..ea85600 --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/models/wheel.py @@ -0,0 +1,118 @@ +"""Represents a wheel file and provides access to the various parts of the +name that have meaning. +""" + +import re +from typing import Dict, Iterable, List + +from pip._vendor.packaging.tags import Tag +from pip._vendor.packaging.utils import ( + InvalidWheelFilename as PackagingInvalidWheelName, +) +from pip._vendor.packaging.utils import parse_wheel_filename + +from pip._internal.exceptions import InvalidWheelFilename +from pip._internal.utils.deprecation import deprecated + + +class Wheel: + """A wheel file""" + + wheel_file_re = re.compile( + r"""^(?P(?P[^\s-]+?)-(?P[^\s-]*?)) + ((-(?P\d[^-]*?))?-(?P[^\s-]+?)-(?P[^\s-]+?)-(?P[^\s-]+?) + \.whl|\.dist-info)$""", + re.VERBOSE, + ) + + def __init__(self, filename: str) -> None: + """ + :raises InvalidWheelFilename: when the filename is invalid for a wheel + """ + wheel_info = self.wheel_file_re.match(filename) + if not wheel_info: + raise InvalidWheelFilename(f"{filename} is not a valid wheel filename.") + self.filename = filename + self.name = wheel_info.group("name").replace("_", "-") + _version = wheel_info.group("ver") + if "_" in _version: + try: + parse_wheel_filename(filename) + except PackagingInvalidWheelName as e: + deprecated( + reason=( + f"Wheel filename {filename!r} is not correctly normalised. " + "Future versions of pip will raise the following error:\n" + f"{e.args[0]}\n\n" + ), + replacement=( + "to rename the wheel to use a correctly normalised " + "name (this may require updating the version in " + "the project metadata)" + ), + gone_in="25.1", + issue=12938, + ) + + _version = _version.replace("_", "-") + + self.version = _version + self.build_tag = wheel_info.group("build") + self.pyversions = wheel_info.group("pyver").split(".") + self.abis = wheel_info.group("abi").split(".") + self.plats = wheel_info.group("plat").split(".") + + # All the tag combinations from this file + self.file_tags = { + Tag(x, y, z) for x in self.pyversions for y in self.abis for z in self.plats + } + + def get_formatted_file_tags(self) -> List[str]: + """Return the wheel's tags as a sorted list of strings.""" + return sorted(str(tag) for tag in self.file_tags) + + def support_index_min(self, tags: List[Tag]) -> int: + """Return the lowest index that one of the wheel's file_tag combinations + achieves in the given list of supported tags. + + For example, if there are 8 supported tags and one of the file tags + is first in the list, then return 0. + + :param tags: the PEP 425 tags to check the wheel against, in order + with most preferred first. + + :raises ValueError: If none of the wheel's file tags match one of + the supported tags. + """ + try: + return next(i for i, t in enumerate(tags) if t in self.file_tags) + except StopIteration: + raise ValueError() + + def find_most_preferred_tag( + self, tags: List[Tag], tag_to_priority: Dict[Tag, int] + ) -> int: + """Return the priority of the most preferred tag that one of the wheel's file + tag combinations achieves in the given list of supported tags using the given + tag_to_priority mapping, where lower priorities are more-preferred. + + This is used in place of support_index_min in some cases in order to avoid + an expensive linear scan of a large list of tags. + + :param tags: the PEP 425 tags to check the wheel against. + :param tag_to_priority: a mapping from tag to priority of that tag, where + lower is more preferred. + + :raises ValueError: If none of the wheel's file tags match one of + the supported tags. + """ + return min( + tag_to_priority[tag] for tag in self.file_tags if tag in tag_to_priority + ) + + def supported(self, tags: Iterable[Tag]) -> bool: + """Return whether the wheel is compatible with one of the given tags. + + :param tags: the PEP 425 tags to check the wheel against. + """ + return not self.file_tags.isdisjoint(tags) diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/network/__init__.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/network/__init__.py new file mode 100644 index 0000000..b51bde9 --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/network/__init__.py @@ -0,0 +1,2 @@ +"""Contains purely network-related utilities. +""" diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/network/__pycache__/__init__.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/network/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000..a8a9a48 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/network/__pycache__/__init__.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/network/__pycache__/auth.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/network/__pycache__/auth.cpython-312.pyc new file mode 100644 index 0000000..1d38677 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/network/__pycache__/auth.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/network/__pycache__/cache.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/network/__pycache__/cache.cpython-312.pyc new file mode 100644 index 0000000..626ff94 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/network/__pycache__/cache.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/network/__pycache__/download.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/network/__pycache__/download.cpython-312.pyc new file mode 100644 index 0000000..31a9bc1 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/network/__pycache__/download.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/network/__pycache__/lazy_wheel.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/network/__pycache__/lazy_wheel.cpython-312.pyc new file mode 100644 index 0000000..dc2e27e Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/network/__pycache__/lazy_wheel.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/network/__pycache__/session.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/network/__pycache__/session.cpython-312.pyc new file mode 100644 index 0000000..fdc4423 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/network/__pycache__/session.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/network/__pycache__/utils.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/network/__pycache__/utils.cpython-312.pyc new file mode 100644 index 0000000..92cef20 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/network/__pycache__/utils.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/network/__pycache__/xmlrpc.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/network/__pycache__/xmlrpc.cpython-312.pyc new file mode 100644 index 0000000..cf5f4d7 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/network/__pycache__/xmlrpc.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/network/auth.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/network/auth.py new file mode 100644 index 0000000..1a2606e --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/network/auth.py @@ -0,0 +1,566 @@ +"""Network Authentication Helpers + +Contains interface (MultiDomainBasicAuth) and associated glue code for +providing credentials in the context of network requests. +""" + +import logging +import os +import shutil +import subprocess +import sysconfig +import typing +import urllib.parse +from abc import ABC, abstractmethod +from functools import lru_cache +from os.path import commonprefix +from pathlib import Path +from typing import Any, Dict, List, NamedTuple, Optional, Tuple + +from pip._vendor.requests.auth import AuthBase, HTTPBasicAuth +from pip._vendor.requests.models import Request, Response +from pip._vendor.requests.utils import get_netrc_auth + +from pip._internal.utils.logging import getLogger +from pip._internal.utils.misc import ( + ask, + ask_input, + ask_password, + remove_auth_from_url, + split_auth_netloc_from_url, +) +from pip._internal.vcs.versioncontrol import AuthInfo + +logger = getLogger(__name__) + +KEYRING_DISABLED = False + + +class Credentials(NamedTuple): + url: str + username: str + password: str + + +class KeyRingBaseProvider(ABC): + """Keyring base provider interface""" + + has_keyring: bool + + @abstractmethod + def get_auth_info( + self, url: str, username: Optional[str] + ) -> Optional[AuthInfo]: ... + + @abstractmethod + def save_auth_info(self, url: str, username: str, password: str) -> None: ... + + +class KeyRingNullProvider(KeyRingBaseProvider): + """Keyring null provider""" + + has_keyring = False + + def get_auth_info(self, url: str, username: Optional[str]) -> Optional[AuthInfo]: + return None + + def save_auth_info(self, url: str, username: str, password: str) -> None: + return None + + +class KeyRingPythonProvider(KeyRingBaseProvider): + """Keyring interface which uses locally imported `keyring`""" + + has_keyring = True + + def __init__(self) -> None: + import keyring + + self.keyring = keyring + + def get_auth_info(self, url: str, username: Optional[str]) -> Optional[AuthInfo]: + # Support keyring's get_credential interface which supports getting + # credentials without a username. This is only available for + # keyring>=15.2.0. + if hasattr(self.keyring, "get_credential"): + logger.debug("Getting credentials from keyring for %s", url) + cred = self.keyring.get_credential(url, username) + if cred is not None: + return cred.username, cred.password + return None + + if username is not None: + logger.debug("Getting password from keyring for %s", url) + password = self.keyring.get_password(url, username) + if password: + return username, password + return None + + def save_auth_info(self, url: str, username: str, password: str) -> None: + self.keyring.set_password(url, username, password) + + +class KeyRingCliProvider(KeyRingBaseProvider): + """Provider which uses `keyring` cli + + Instead of calling the keyring package installed alongside pip + we call keyring on the command line which will enable pip to + use which ever installation of keyring is available first in + PATH. + """ + + has_keyring = True + + def __init__(self, cmd: str) -> None: + self.keyring = cmd + + def get_auth_info(self, url: str, username: Optional[str]) -> Optional[AuthInfo]: + # This is the default implementation of keyring.get_credential + # https://github.com/jaraco/keyring/blob/97689324abcf01bd1793d49063e7ca01e03d7d07/keyring/backend.py#L134-L139 + if username is not None: + password = self._get_password(url, username) + if password is not None: + return username, password + return None + + def save_auth_info(self, url: str, username: str, password: str) -> None: + return self._set_password(url, username, password) + + def _get_password(self, service_name: str, username: str) -> Optional[str]: + """Mirror the implementation of keyring.get_password using cli""" + if self.keyring is None: + return None + + cmd = [self.keyring, "get", service_name, username] + env = os.environ.copy() + env["PYTHONIOENCODING"] = "utf-8" + res = subprocess.run( + cmd, + stdin=subprocess.DEVNULL, + stdout=subprocess.PIPE, + env=env, + ) + if res.returncode: + return None + return res.stdout.decode("utf-8").strip(os.linesep) + + def _set_password(self, service_name: str, username: str, password: str) -> None: + """Mirror the implementation of keyring.set_password using cli""" + if self.keyring is None: + return None + env = os.environ.copy() + env["PYTHONIOENCODING"] = "utf-8" + subprocess.run( + [self.keyring, "set", service_name, username], + input=f"{password}{os.linesep}".encode(), + env=env, + check=True, + ) + return None + + +@lru_cache(maxsize=None) +def get_keyring_provider(provider: str) -> KeyRingBaseProvider: + logger.verbose("Keyring provider requested: %s", provider) + + # keyring has previously failed and been disabled + if KEYRING_DISABLED: + provider = "disabled" + if provider in ["import", "auto"]: + try: + impl = KeyRingPythonProvider() + logger.verbose("Keyring provider set: import") + return impl + except ImportError: + pass + except Exception as exc: + # In the event of an unexpected exception + # we should warn the user + msg = "Installed copy of keyring fails with exception %s" + if provider == "auto": + msg = msg + ", trying to find a keyring executable as a fallback" + logger.warning(msg, exc, exc_info=logger.isEnabledFor(logging.DEBUG)) + if provider in ["subprocess", "auto"]: + cli = shutil.which("keyring") + if cli and cli.startswith(sysconfig.get_path("scripts")): + # all code within this function is stolen from shutil.which implementation + @typing.no_type_check + def PATH_as_shutil_which_determines_it() -> str: + path = os.environ.get("PATH", None) + if path is None: + try: + path = os.confstr("CS_PATH") + except (AttributeError, ValueError): + # os.confstr() or CS_PATH is not available + path = os.defpath + # bpo-35755: Don't use os.defpath if the PATH environment variable is + # set to an empty string + + return path + + scripts = Path(sysconfig.get_path("scripts")) + + paths = [] + for path in PATH_as_shutil_which_determines_it().split(os.pathsep): + p = Path(path) + try: + if not p.samefile(scripts): + paths.append(path) + except FileNotFoundError: + pass + + path = os.pathsep.join(paths) + + cli = shutil.which("keyring", path=path) + + if cli: + logger.verbose("Keyring provider set: subprocess with executable %s", cli) + return KeyRingCliProvider(cli) + + logger.verbose("Keyring provider set: disabled") + return KeyRingNullProvider() + + +class MultiDomainBasicAuth(AuthBase): + def __init__( + self, + prompting: bool = True, + index_urls: Optional[List[str]] = None, + keyring_provider: str = "auto", + ) -> None: + self.prompting = prompting + self.index_urls = index_urls + self.keyring_provider = keyring_provider # type: ignore[assignment] + self.passwords: Dict[str, AuthInfo] = {} + # When the user is prompted to enter credentials and keyring is + # available, we will offer to save them. If the user accepts, + # this value is set to the credentials they entered. After the + # request authenticates, the caller should call + # ``save_credentials`` to save these. + self._credentials_to_save: Optional[Credentials] = None + + @property + def keyring_provider(self) -> KeyRingBaseProvider: + return get_keyring_provider(self._keyring_provider) + + @keyring_provider.setter + def keyring_provider(self, provider: str) -> None: + # The free function get_keyring_provider has been decorated with + # functools.cache. If an exception occurs in get_keyring_auth that + # cache will be cleared and keyring disabled, take that into account + # if you want to remove this indirection. + self._keyring_provider = provider + + @property + def use_keyring(self) -> bool: + # We won't use keyring when --no-input is passed unless + # a specific provider is requested because it might require + # user interaction + return self.prompting or self._keyring_provider not in ["auto", "disabled"] + + def _get_keyring_auth( + self, + url: Optional[str], + username: Optional[str], + ) -> Optional[AuthInfo]: + """Return the tuple auth for a given url from keyring.""" + # Do nothing if no url was provided + if not url: + return None + + try: + return self.keyring_provider.get_auth_info(url, username) + except Exception as exc: + # Log the full exception (with stacktrace) at debug, so it'll only + # show up when running in verbose mode. + logger.debug("Keyring is skipped due to an exception", exc_info=True) + # Always log a shortened version of the exception. + logger.warning( + "Keyring is skipped due to an exception: %s", + str(exc), + ) + global KEYRING_DISABLED + KEYRING_DISABLED = True + get_keyring_provider.cache_clear() + return None + + def _get_index_url(self, url: str) -> Optional[str]: + """Return the original index URL matching the requested URL. + + Cached or dynamically generated credentials may work against + the original index URL rather than just the netloc. + + The provided url should have had its username and password + removed already. If the original index url had credentials then + they will be included in the return value. + + Returns None if no matching index was found, or if --no-index + was specified by the user. + """ + if not url or not self.index_urls: + return None + + url = remove_auth_from_url(url).rstrip("/") + "/" + parsed_url = urllib.parse.urlsplit(url) + + candidates = [] + + for index in self.index_urls: + index = index.rstrip("/") + "/" + parsed_index = urllib.parse.urlsplit(remove_auth_from_url(index)) + if parsed_url == parsed_index: + return index + + if parsed_url.netloc != parsed_index.netloc: + continue + + candidate = urllib.parse.urlsplit(index) + candidates.append(candidate) + + if not candidates: + return None + + candidates.sort( + reverse=True, + key=lambda candidate: commonprefix( + [ + parsed_url.path, + candidate.path, + ] + ).rfind("/"), + ) + + return urllib.parse.urlunsplit(candidates[0]) + + def _get_new_credentials( + self, + original_url: str, + *, + allow_netrc: bool = True, + allow_keyring: bool = False, + ) -> AuthInfo: + """Find and return credentials for the specified URL.""" + # Split the credentials and netloc from the url. + url, netloc, url_user_password = split_auth_netloc_from_url( + original_url, + ) + + # Start with the credentials embedded in the url + username, password = url_user_password + if username is not None and password is not None: + logger.debug("Found credentials in url for %s", netloc) + return url_user_password + + # Find a matching index url for this request + index_url = self._get_index_url(url) + if index_url: + # Split the credentials from the url. + index_info = split_auth_netloc_from_url(index_url) + if index_info: + index_url, _, index_url_user_password = index_info + logger.debug("Found index url %s", index_url) + + # If an index URL was found, try its embedded credentials + if index_url and index_url_user_password[0] is not None: + username, password = index_url_user_password + if username is not None and password is not None: + logger.debug("Found credentials in index url for %s", netloc) + return index_url_user_password + + # Get creds from netrc if we still don't have them + if allow_netrc: + netrc_auth = get_netrc_auth(original_url) + if netrc_auth: + logger.debug("Found credentials in netrc for %s", netloc) + return netrc_auth + + # If we don't have a password and keyring is available, use it. + if allow_keyring: + # The index url is more specific than the netloc, so try it first + # fmt: off + kr_auth = ( + self._get_keyring_auth(index_url, username) or + self._get_keyring_auth(netloc, username) + ) + # fmt: on + if kr_auth: + logger.debug("Found credentials in keyring for %s", netloc) + return kr_auth + + return username, password + + def _get_url_and_credentials( + self, original_url: str + ) -> Tuple[str, Optional[str], Optional[str]]: + """Return the credentials to use for the provided URL. + + If allowed, netrc and keyring may be used to obtain the + correct credentials. + + Returns (url_without_credentials, username, password). Note + that even if the original URL contains credentials, this + function may return a different username and password. + """ + url, netloc, _ = split_auth_netloc_from_url(original_url) + + # Try to get credentials from original url + username, password = self._get_new_credentials(original_url) + + # If credentials not found, use any stored credentials for this netloc. + # Do this if either the username or the password is missing. + # This accounts for the situation in which the user has specified + # the username in the index url, but the password comes from keyring. + if (username is None or password is None) and netloc in self.passwords: + un, pw = self.passwords[netloc] + # It is possible that the cached credentials are for a different username, + # in which case the cache should be ignored. + if username is None or username == un: + username, password = un, pw + + if username is not None or password is not None: + # Convert the username and password if they're None, so that + # this netloc will show up as "cached" in the conditional above. + # Further, HTTPBasicAuth doesn't accept None, so it makes sense to + # cache the value that is going to be used. + username = username or "" + password = password or "" + + # Store any acquired credentials. + self.passwords[netloc] = (username, password) + + assert ( + # Credentials were found + (username is not None and password is not None) + # Credentials were not found + or (username is None and password is None) + ), f"Could not load credentials from url: {original_url}" + + return url, username, password + + def __call__(self, req: Request) -> Request: + # Get credentials for this request + url, username, password = self._get_url_and_credentials(req.url) + + # Set the url of the request to the url without any credentials + req.url = url + + if username is not None and password is not None: + # Send the basic auth with this request + req = HTTPBasicAuth(username, password)(req) + + # Attach a hook to handle 401 responses + req.register_hook("response", self.handle_401) + + return req + + # Factored out to allow for easy patching in tests + def _prompt_for_password( + self, netloc: str + ) -> Tuple[Optional[str], Optional[str], bool]: + username = ask_input(f"User for {netloc}: ") if self.prompting else None + if not username: + return None, None, False + if self.use_keyring: + auth = self._get_keyring_auth(netloc, username) + if auth and auth[0] is not None and auth[1] is not None: + return auth[0], auth[1], False + password = ask_password("Password: ") + return username, password, True + + # Factored out to allow for easy patching in tests + def _should_save_password_to_keyring(self) -> bool: + if ( + not self.prompting + or not self.use_keyring + or not self.keyring_provider.has_keyring + ): + return False + return ask("Save credentials to keyring [y/N]: ", ["y", "n"]) == "y" + + def handle_401(self, resp: Response, **kwargs: Any) -> Response: + # We only care about 401 responses, anything else we want to just + # pass through the actual response + if resp.status_code != 401: + return resp + + username, password = None, None + + # Query the keyring for credentials: + if self.use_keyring: + username, password = self._get_new_credentials( + resp.url, + allow_netrc=False, + allow_keyring=True, + ) + + # We are not able to prompt the user so simply return the response + if not self.prompting and not username and not password: + return resp + + parsed = urllib.parse.urlparse(resp.url) + + # Prompt the user for a new username and password + save = False + if not username and not password: + username, password, save = self._prompt_for_password(parsed.netloc) + + # Store the new username and password to use for future requests + self._credentials_to_save = None + if username is not None and password is not None: + self.passwords[parsed.netloc] = (username, password) + + # Prompt to save the password to keyring + if save and self._should_save_password_to_keyring(): + self._credentials_to_save = Credentials( + url=parsed.netloc, + username=username, + password=password, + ) + + # Consume content and release the original connection to allow our new + # request to reuse the same one. + # The result of the assignment isn't used, it's just needed to consume + # the content. + _ = resp.content + resp.raw.release_conn() + + # Add our new username and password to the request + req = HTTPBasicAuth(username or "", password or "")(resp.request) + req.register_hook("response", self.warn_on_401) + + # On successful request, save the credentials that were used to + # keyring. (Note that if the user responded "no" above, this member + # is not set and nothing will be saved.) + if self._credentials_to_save: + req.register_hook("response", self.save_credentials) + + # Send our new request + new_resp = resp.connection.send(req, **kwargs) + new_resp.history.append(resp) + + return new_resp + + def warn_on_401(self, resp: Response, **kwargs: Any) -> None: + """Response callback to warn about incorrect credentials.""" + if resp.status_code == 401: + logger.warning( + "401 Error, Credentials not correct for %s", + resp.request.url, + ) + + def save_credentials(self, resp: Response, **kwargs: Any) -> None: + """Response callback to save credentials on success.""" + assert ( + self.keyring_provider.has_keyring + ), "should never reach here without keyring" + + creds = self._credentials_to_save + self._credentials_to_save = None + if creds and resp.status_code < 400: + try: + logger.info("Saving credentials to keyring") + self.keyring_provider.save_auth_info( + creds.url, creds.username, creds.password + ) + except Exception: + logger.exception("Failed to save credentials") diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/network/cache.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/network/cache.py new file mode 100644 index 0000000..fca04e6 --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/network/cache.py @@ -0,0 +1,118 @@ +"""HTTP cache implementation. +""" + +import os +from contextlib import contextmanager +from datetime import datetime +from typing import BinaryIO, Generator, Optional, Union + +from pip._vendor.cachecontrol.cache import SeparateBodyBaseCache +from pip._vendor.cachecontrol.caches import SeparateBodyFileCache +from pip._vendor.requests.models import Response + +from pip._internal.utils.filesystem import adjacent_tmp_file, replace +from pip._internal.utils.misc import ensure_dir + + +def is_from_cache(response: Response) -> bool: + return getattr(response, "from_cache", False) + + +@contextmanager +def suppressed_cache_errors() -> Generator[None, None, None]: + """If we can't access the cache then we can just skip caching and process + requests as if caching wasn't enabled. + """ + try: + yield + except OSError: + pass + + +class SafeFileCache(SeparateBodyBaseCache): + """ + A file based cache which is safe to use even when the target directory may + not be accessible or writable. + + There is a race condition when two processes try to write and/or read the + same entry at the same time, since each entry consists of two separate + files (https://github.com/psf/cachecontrol/issues/324). We therefore have + additional logic that makes sure that both files to be present before + returning an entry; this fixes the read side of the race condition. + + For the write side, we assume that the server will only ever return the + same data for the same URL, which ought to be the case for files pip is + downloading. PyPI does not have a mechanism to swap out a wheel for + another wheel, for example. If this assumption is not true, the + CacheControl issue will need to be fixed. + """ + + def __init__(self, directory: str) -> None: + assert directory is not None, "Cache directory must not be None." + super().__init__() + self.directory = directory + + def _get_cache_path(self, name: str) -> str: + # From cachecontrol.caches.file_cache.FileCache._fn, brought into our + # class for backwards-compatibility and to avoid using a non-public + # method. + hashed = SeparateBodyFileCache.encode(name) + parts = list(hashed[:5]) + [hashed] + return os.path.join(self.directory, *parts) + + def get(self, key: str) -> Optional[bytes]: + # The cache entry is only valid if both metadata and body exist. + metadata_path = self._get_cache_path(key) + body_path = metadata_path + ".body" + if not (os.path.exists(metadata_path) and os.path.exists(body_path)): + return None + with suppressed_cache_errors(): + with open(metadata_path, "rb") as f: + return f.read() + + def _write(self, path: str, data: bytes) -> None: + with suppressed_cache_errors(): + ensure_dir(os.path.dirname(path)) + + with adjacent_tmp_file(path) as f: + f.write(data) + # Inherit the read/write permissions of the cache directory + # to enable multi-user cache use-cases. + mode = ( + os.stat(self.directory).st_mode + & 0o666 # select read/write permissions of cache directory + | 0o600 # set owner read/write permissions + ) + # Change permissions only if there is no risk of following a symlink. + if os.chmod in os.supports_fd: + os.chmod(f.fileno(), mode) + elif os.chmod in os.supports_follow_symlinks: + os.chmod(f.name, mode, follow_symlinks=False) + + replace(f.name, path) + + def set( + self, key: str, value: bytes, expires: Union[int, datetime, None] = None + ) -> None: + path = self._get_cache_path(key) + self._write(path, value) + + def delete(self, key: str) -> None: + path = self._get_cache_path(key) + with suppressed_cache_errors(): + os.remove(path) + with suppressed_cache_errors(): + os.remove(path + ".body") + + def get_body(self, key: str) -> Optional[BinaryIO]: + # The cache entry is only valid if both metadata and body exist. + metadata_path = self._get_cache_path(key) + body_path = metadata_path + ".body" + if not (os.path.exists(metadata_path) and os.path.exists(body_path)): + return None + with suppressed_cache_errors(): + return open(body_path, "rb") + + def set_body(self, key: str, body: bytes) -> None: + path = self._get_cache_path(key) + ".body" + self._write(path, body) diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/network/download.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/network/download.py new file mode 100644 index 0000000..5c3bce3 --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/network/download.py @@ -0,0 +1,187 @@ +"""Download files with progress indicators. +""" + +import email.message +import logging +import mimetypes +import os +from typing import Iterable, Optional, Tuple + +from pip._vendor.requests.models import Response + +from pip._internal.cli.progress_bars import get_download_progress_renderer +from pip._internal.exceptions import NetworkConnectionError +from pip._internal.models.index import PyPI +from pip._internal.models.link import Link +from pip._internal.network.cache import is_from_cache +from pip._internal.network.session import PipSession +from pip._internal.network.utils import HEADERS, raise_for_status, response_chunks +from pip._internal.utils.misc import format_size, redact_auth_from_url, splitext + +logger = logging.getLogger(__name__) + + +def _get_http_response_size(resp: Response) -> Optional[int]: + try: + return int(resp.headers["content-length"]) + except (ValueError, KeyError, TypeError): + return None + + +def _prepare_download( + resp: Response, + link: Link, + progress_bar: str, +) -> Iterable[bytes]: + total_length = _get_http_response_size(resp) + + if link.netloc == PyPI.file_storage_domain: + url = link.show_url + else: + url = link.url_without_fragment + + logged_url = redact_auth_from_url(url) + + if total_length: + logged_url = f"{logged_url} ({format_size(total_length)})" + + if is_from_cache(resp): + logger.info("Using cached %s", logged_url) + else: + logger.info("Downloading %s", logged_url) + + if logger.getEffectiveLevel() > logging.INFO: + show_progress = False + elif is_from_cache(resp): + show_progress = False + elif not total_length: + show_progress = True + elif total_length > (512 * 1024): + show_progress = True + else: + show_progress = False + + chunks = response_chunks(resp) + + if not show_progress: + return chunks + + renderer = get_download_progress_renderer(bar_type=progress_bar, size=total_length) + return renderer(chunks) + + +def sanitize_content_filename(filename: str) -> str: + """ + Sanitize the "filename" value from a Content-Disposition header. + """ + return os.path.basename(filename) + + +def parse_content_disposition(content_disposition: str, default_filename: str) -> str: + """ + Parse the "filename" value from a Content-Disposition header, and + return the default filename if the result is empty. + """ + m = email.message.Message() + m["content-type"] = content_disposition + filename = m.get_param("filename") + if filename: + # We need to sanitize the filename to prevent directory traversal + # in case the filename contains ".." path parts. + filename = sanitize_content_filename(str(filename)) + return filename or default_filename + + +def _get_http_response_filename(resp: Response, link: Link) -> str: + """Get an ideal filename from the given HTTP response, falling back to + the link filename if not provided. + """ + filename = link.filename # fallback + # Have a look at the Content-Disposition header for a better guess + content_disposition = resp.headers.get("content-disposition") + if content_disposition: + filename = parse_content_disposition(content_disposition, filename) + ext: Optional[str] = splitext(filename)[1] + if not ext: + ext = mimetypes.guess_extension(resp.headers.get("content-type", "")) + if ext: + filename += ext + if not ext and link.url != resp.url: + ext = os.path.splitext(resp.url)[1] + if ext: + filename += ext + return filename + + +def _http_get_download(session: PipSession, link: Link) -> Response: + target_url = link.url.split("#", 1)[0] + resp = session.get(target_url, headers=HEADERS, stream=True) + raise_for_status(resp) + return resp + + +class Downloader: + def __init__( + self, + session: PipSession, + progress_bar: str, + ) -> None: + self._session = session + self._progress_bar = progress_bar + + def __call__(self, link: Link, location: str) -> Tuple[str, str]: + """Download the file given by link into location.""" + try: + resp = _http_get_download(self._session, link) + except NetworkConnectionError as e: + assert e.response is not None + logger.critical( + "HTTP error %s while getting %s", e.response.status_code, link + ) + raise + + filename = _get_http_response_filename(resp, link) + filepath = os.path.join(location, filename) + + chunks = _prepare_download(resp, link, self._progress_bar) + with open(filepath, "wb") as content_file: + for chunk in chunks: + content_file.write(chunk) + content_type = resp.headers.get("Content-Type", "") + return filepath, content_type + + +class BatchDownloader: + def __init__( + self, + session: PipSession, + progress_bar: str, + ) -> None: + self._session = session + self._progress_bar = progress_bar + + def __call__( + self, links: Iterable[Link], location: str + ) -> Iterable[Tuple[Link, Tuple[str, str]]]: + """Download the files given by links into location.""" + for link in links: + try: + resp = _http_get_download(self._session, link) + except NetworkConnectionError as e: + assert e.response is not None + logger.critical( + "HTTP error %s while getting %s", + e.response.status_code, + link, + ) + raise + + filename = _get_http_response_filename(resp, link) + filepath = os.path.join(location, filename) + + chunks = _prepare_download(resp, link, self._progress_bar) + with open(filepath, "wb") as content_file: + for chunk in chunks: + content_file.write(chunk) + content_type = resp.headers.get("Content-Type", "") + yield link, (filepath, content_type) diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/network/lazy_wheel.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/network/lazy_wheel.py new file mode 100644 index 0000000..03f883c --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/network/lazy_wheel.py @@ -0,0 +1,210 @@ +"""Lazy ZIP over HTTP""" + +__all__ = ["HTTPRangeRequestUnsupported", "dist_from_wheel_url"] + +from bisect import bisect_left, bisect_right +from contextlib import contextmanager +from tempfile import NamedTemporaryFile +from typing import Any, Dict, Generator, List, Optional, Tuple +from zipfile import BadZipFile, ZipFile + +from pip._vendor.packaging.utils import canonicalize_name +from pip._vendor.requests.models import CONTENT_CHUNK_SIZE, Response + +from pip._internal.metadata import BaseDistribution, MemoryWheel, get_wheel_distribution +from pip._internal.network.session import PipSession +from pip._internal.network.utils import HEADERS, raise_for_status, response_chunks + + +class HTTPRangeRequestUnsupported(Exception): + pass + + +def dist_from_wheel_url(name: str, url: str, session: PipSession) -> BaseDistribution: + """Return a distribution object from the given wheel URL. + + This uses HTTP range requests to only fetch the portion of the wheel + containing metadata, just enough for the object to be constructed. + If such requests are not supported, HTTPRangeRequestUnsupported + is raised. + """ + with LazyZipOverHTTP(url, session) as zf: + # For read-only ZIP files, ZipFile only needs methods read, + # seek, seekable and tell, not the whole IO protocol. + wheel = MemoryWheel(zf.name, zf) # type: ignore + # After context manager exit, wheel.name + # is an invalid file by intention. + return get_wheel_distribution(wheel, canonicalize_name(name)) + + +class LazyZipOverHTTP: + """File-like object mapped to a ZIP file over HTTP. + + This uses HTTP range requests to lazily fetch the file's content, + which is supposed to be fed to ZipFile. If such requests are not + supported by the server, raise HTTPRangeRequestUnsupported + during initialization. + """ + + def __init__( + self, url: str, session: PipSession, chunk_size: int = CONTENT_CHUNK_SIZE + ) -> None: + head = session.head(url, headers=HEADERS) + raise_for_status(head) + assert head.status_code == 200 + self._session, self._url, self._chunk_size = session, url, chunk_size + self._length = int(head.headers["Content-Length"]) + self._file = NamedTemporaryFile() + self.truncate(self._length) + self._left: List[int] = [] + self._right: List[int] = [] + if "bytes" not in head.headers.get("Accept-Ranges", "none"): + raise HTTPRangeRequestUnsupported("range request is not supported") + self._check_zip() + + @property + def mode(self) -> str: + """Opening mode, which is always rb.""" + return "rb" + + @property + def name(self) -> str: + """Path to the underlying file.""" + return self._file.name + + def seekable(self) -> bool: + """Return whether random access is supported, which is True.""" + return True + + def close(self) -> None: + """Close the file.""" + self._file.close() + + @property + def closed(self) -> bool: + """Whether the file is closed.""" + return self._file.closed + + def read(self, size: int = -1) -> bytes: + """Read up to size bytes from the object and return them. + + As a convenience, if size is unspecified or -1, + all bytes until EOF are returned. Fewer than + size bytes may be returned if EOF is reached. + """ + download_size = max(size, self._chunk_size) + start, length = self.tell(), self._length + stop = length if size < 0 else min(start + download_size, length) + start = max(0, stop - download_size) + self._download(start, stop - 1) + return self._file.read(size) + + def readable(self) -> bool: + """Return whether the file is readable, which is True.""" + return True + + def seek(self, offset: int, whence: int = 0) -> int: + """Change stream position and return the new absolute position. + + Seek to offset relative position indicated by whence: + * 0: Start of stream (the default). pos should be >= 0; + * 1: Current position - pos may be negative; + * 2: End of stream - pos usually negative. + """ + return self._file.seek(offset, whence) + + def tell(self) -> int: + """Return the current position.""" + return self._file.tell() + + def truncate(self, size: Optional[int] = None) -> int: + """Resize the stream to the given size in bytes. + + If size is unspecified resize to the current position. + The current stream position isn't changed. + + Return the new file size. + """ + return self._file.truncate(size) + + def writable(self) -> bool: + """Return False.""" + return False + + def __enter__(self) -> "LazyZipOverHTTP": + self._file.__enter__() + return self + + def __exit__(self, *exc: Any) -> None: + self._file.__exit__(*exc) + + @contextmanager + def _stay(self) -> Generator[None, None, None]: + """Return a context manager keeping the position. + + At the end of the block, seek back to original position. + """ + pos = self.tell() + try: + yield + finally: + self.seek(pos) + + def _check_zip(self) -> None: + """Check and download until the file is a valid ZIP.""" + end = self._length - 1 + for start in reversed(range(0, end, self._chunk_size)): + self._download(start, end) + with self._stay(): + try: + # For read-only ZIP files, ZipFile only needs + # methods read, seek, seekable and tell. + ZipFile(self) + except BadZipFile: + pass + else: + break + + def _stream_response( + self, start: int, end: int, base_headers: Dict[str, str] = HEADERS + ) -> Response: + """Return HTTP response to a range request from start to end.""" + headers = base_headers.copy() + headers["Range"] = f"bytes={start}-{end}" + # TODO: Get range requests to be correctly cached + headers["Cache-Control"] = "no-cache" + return self._session.get(self._url, headers=headers, stream=True) + + def _merge( + self, start: int, end: int, left: int, right: int + ) -> Generator[Tuple[int, int], None, None]: + """Return a generator of intervals to be fetched. + + Args: + start (int): Start of needed interval + end (int): End of needed interval + left (int): Index of first overlapping downloaded data + right (int): Index after last overlapping downloaded data + """ + lslice, rslice = self._left[left:right], self._right[left:right] + i = start = min([start] + lslice[:1]) + end = max([end] + rslice[-1:]) + for j, k in zip(lslice, rslice): + if j > i: + yield i, j - 1 + i = k + 1 + if i <= end: + yield i, end + self._left[left:right], self._right[left:right] = [start], [end] + + def _download(self, start: int, end: int) -> None: + """Download bytes from start to end inclusively.""" + with self._stay(): + left = bisect_left(self._right, start) + right = bisect_right(self._left, end) + for start, end in self._merge(start, end, left, right): + response = self._stream_response(start, end) + response.raise_for_status() + self.seek(start) + for chunk in response_chunks(response, self._chunk_size): + self._file.write(chunk) diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/network/session.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/network/session.py new file mode 100644 index 0000000..5e10f8f --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/network/session.py @@ -0,0 +1,523 @@ +"""PipSession and supporting code, containing all pip-specific +network request configuration and behavior. +""" + +import email.utils +import functools +import io +import ipaddress +import json +import logging +import mimetypes +import os +import platform +import shutil +import subprocess +import sys +import urllib.parse +import warnings +from typing import ( + TYPE_CHECKING, + Any, + Dict, + Generator, + List, + Mapping, + Optional, + Sequence, + Tuple, + Union, +) + +from pip._vendor import requests, urllib3 +from pip._vendor.cachecontrol import CacheControlAdapter as _BaseCacheControlAdapter +from pip._vendor.requests.adapters import DEFAULT_POOLBLOCK, BaseAdapter +from pip._vendor.requests.adapters import HTTPAdapter as _BaseHTTPAdapter +from pip._vendor.requests.models import PreparedRequest, Response +from pip._vendor.requests.structures import CaseInsensitiveDict +from pip._vendor.urllib3.connectionpool import ConnectionPool +from pip._vendor.urllib3.exceptions import InsecureRequestWarning + +from pip import __version__ +from pip._internal.metadata import get_default_environment +from pip._internal.models.link import Link +from pip._internal.network.auth import MultiDomainBasicAuth +from pip._internal.network.cache import SafeFileCache + +# Import ssl from compat so the initial import occurs in only one place. +from pip._internal.utils.compat import has_tls +from pip._internal.utils.glibc import libc_ver +from pip._internal.utils.misc import build_url_from_netloc, parse_netloc +from pip._internal.utils.urls import url_to_path + +if TYPE_CHECKING: + from ssl import SSLContext + + from pip._vendor.urllib3.poolmanager import PoolManager + + +logger = logging.getLogger(__name__) + +SecureOrigin = Tuple[str, str, Optional[Union[int, str]]] + + +# Ignore warning raised when using --trusted-host. +warnings.filterwarnings("ignore", category=InsecureRequestWarning) + + +SECURE_ORIGINS: List[SecureOrigin] = [ + # protocol, hostname, port + # Taken from Chrome's list of secure origins (See: http://bit.ly/1qrySKC) + ("https", "*", "*"), + ("*", "localhost", "*"), + ("*", "127.0.0.0/8", "*"), + ("*", "::1/128", "*"), + ("file", "*", None), + # ssh is always secure. + ("ssh", "*", "*"), +] + + +# These are environment variables present when running under various +# CI systems. For each variable, some CI systems that use the variable +# are indicated. The collection was chosen so that for each of a number +# of popular systems, at least one of the environment variables is used. +# This list is used to provide some indication of and lower bound for +# CI traffic to PyPI. Thus, it is okay if the list is not comprehensive. +# For more background, see: https://github.com/pypa/pip/issues/5499 +CI_ENVIRONMENT_VARIABLES = ( + # Azure Pipelines + "BUILD_BUILDID", + # Jenkins + "BUILD_ID", + # AppVeyor, CircleCI, Codeship, Gitlab CI, Shippable, Travis CI + "CI", + # Explicit environment variable. + "PIP_IS_CI", +) + + +def looks_like_ci() -> bool: + """ + Return whether it looks like pip is running under CI. + """ + # We don't use the method of checking for a tty (e.g. using isatty()) + # because some CI systems mimic a tty (e.g. Travis CI). Thus that + # method doesn't provide definitive information in either direction. + return any(name in os.environ for name in CI_ENVIRONMENT_VARIABLES) + + +@functools.lru_cache(maxsize=1) +def user_agent() -> str: + """ + Return a string representing the user agent. + """ + data: Dict[str, Any] = { + "installer": {"name": "pip", "version": __version__}, + "python": platform.python_version(), + "implementation": { + "name": platform.python_implementation(), + }, + } + + if data["implementation"]["name"] == "CPython": + data["implementation"]["version"] = platform.python_version() + elif data["implementation"]["name"] == "PyPy": + pypy_version_info = sys.pypy_version_info # type: ignore + if pypy_version_info.releaselevel == "final": + pypy_version_info = pypy_version_info[:3] + data["implementation"]["version"] = ".".join( + [str(x) for x in pypy_version_info] + ) + elif data["implementation"]["name"] == "Jython": + # Complete Guess + data["implementation"]["version"] = platform.python_version() + elif data["implementation"]["name"] == "IronPython": + # Complete Guess + data["implementation"]["version"] = platform.python_version() + + if sys.platform.startswith("linux"): + from pip._vendor import distro + + linux_distribution = distro.name(), distro.version(), distro.codename() + distro_infos: Dict[str, Any] = dict( + filter( + lambda x: x[1], + zip(["name", "version", "id"], linux_distribution), + ) + ) + libc = dict( + filter( + lambda x: x[1], + zip(["lib", "version"], libc_ver()), + ) + ) + if libc: + distro_infos["libc"] = libc + if distro_infos: + data["distro"] = distro_infos + + if sys.platform.startswith("darwin") and platform.mac_ver()[0]: + data["distro"] = {"name": "macOS", "version": platform.mac_ver()[0]} + + if platform.system(): + data.setdefault("system", {})["name"] = platform.system() + + if platform.release(): + data.setdefault("system", {})["release"] = platform.release() + + if platform.machine(): + data["cpu"] = platform.machine() + + if has_tls(): + import _ssl as ssl + + data["openssl_version"] = ssl.OPENSSL_VERSION + + setuptools_dist = get_default_environment().get_distribution("setuptools") + if setuptools_dist is not None: + data["setuptools_version"] = str(setuptools_dist.version) + + if shutil.which("rustc") is not None: + # If for any reason `rustc --version` fails, silently ignore it + try: + rustc_output = subprocess.check_output( + ["rustc", "--version"], stderr=subprocess.STDOUT, timeout=0.5 + ) + except Exception: + pass + else: + if rustc_output.startswith(b"rustc "): + # The format of `rustc --version` is: + # `b'rustc 1.52.1 (9bc8c42bb 2021-05-09)\n'` + # We extract just the middle (1.52.1) part + data["rustc_version"] = rustc_output.split(b" ")[1].decode() + + # Use None rather than False so as not to give the impression that + # pip knows it is not being run under CI. Rather, it is a null or + # inconclusive result. Also, we include some value rather than no + # value to make it easier to know that the check has been run. + data["ci"] = True if looks_like_ci() else None + + user_data = os.environ.get("PIP_USER_AGENT_USER_DATA") + if user_data is not None: + data["user_data"] = user_data + + return "{data[installer][name]}/{data[installer][version]} {json}".format( + data=data, + json=json.dumps(data, separators=(",", ":"), sort_keys=True), + ) + + +class LocalFSAdapter(BaseAdapter): + def send( + self, + request: PreparedRequest, + stream: bool = False, + timeout: Optional[Union[float, Tuple[float, float]]] = None, + verify: Union[bool, str] = True, + cert: Optional[Union[str, Tuple[str, str]]] = None, + proxies: Optional[Mapping[str, str]] = None, + ) -> Response: + pathname = url_to_path(request.url) + + resp = Response() + resp.status_code = 200 + resp.url = request.url + + try: + stats = os.stat(pathname) + except OSError as exc: + # format the exception raised as a io.BytesIO object, + # to return a better error message: + resp.status_code = 404 + resp.reason = type(exc).__name__ + resp.raw = io.BytesIO(f"{resp.reason}: {exc}".encode()) + else: + modified = email.utils.formatdate(stats.st_mtime, usegmt=True) + content_type = mimetypes.guess_type(pathname)[0] or "text/plain" + resp.headers = CaseInsensitiveDict( + { + "Content-Type": content_type, + "Content-Length": stats.st_size, + "Last-Modified": modified, + } + ) + + resp.raw = open(pathname, "rb") + resp.close = resp.raw.close + + return resp + + def close(self) -> None: + pass + + +class _SSLContextAdapterMixin: + """Mixin to add the ``ssl_context`` constructor argument to HTTP adapters. + + The additional argument is forwarded directly to the pool manager. This allows us + to dynamically decide what SSL store to use at runtime, which is used to implement + the optional ``truststore`` backend. + """ + + def __init__( + self, + *, + ssl_context: Optional["SSLContext"] = None, + **kwargs: Any, + ) -> None: + self._ssl_context = ssl_context + super().__init__(**kwargs) + + def init_poolmanager( + self, + connections: int, + maxsize: int, + block: bool = DEFAULT_POOLBLOCK, + **pool_kwargs: Any, + ) -> "PoolManager": + if self._ssl_context is not None: + pool_kwargs.setdefault("ssl_context", self._ssl_context) + return super().init_poolmanager( # type: ignore[misc] + connections=connections, + maxsize=maxsize, + block=block, + **pool_kwargs, + ) + + +class HTTPAdapter(_SSLContextAdapterMixin, _BaseHTTPAdapter): + pass + + +class CacheControlAdapter(_SSLContextAdapterMixin, _BaseCacheControlAdapter): + pass + + +class InsecureHTTPAdapter(HTTPAdapter): + def cert_verify( + self, + conn: ConnectionPool, + url: str, + verify: Union[bool, str], + cert: Optional[Union[str, Tuple[str, str]]], + ) -> None: + super().cert_verify(conn=conn, url=url, verify=False, cert=cert) + + +class InsecureCacheControlAdapter(CacheControlAdapter): + def cert_verify( + self, + conn: ConnectionPool, + url: str, + verify: Union[bool, str], + cert: Optional[Union[str, Tuple[str, str]]], + ) -> None: + super().cert_verify(conn=conn, url=url, verify=False, cert=cert) + + +class PipSession(requests.Session): + timeout: Optional[int] = None + + def __init__( + self, + *args: Any, + retries: int = 0, + cache: Optional[str] = None, + trusted_hosts: Sequence[str] = (), + index_urls: Optional[List[str]] = None, + ssl_context: Optional["SSLContext"] = None, + **kwargs: Any, + ) -> None: + """ + :param trusted_hosts: Domains not to emit warnings for when not using + HTTPS. + """ + super().__init__(*args, **kwargs) + + # Namespace the attribute with "pip_" just in case to prevent + # possible conflicts with the base class. + self.pip_trusted_origins: List[Tuple[str, Optional[int]]] = [] + self.pip_proxy = None + + # Attach our User Agent to the request + self.headers["User-Agent"] = user_agent() + + # Attach our Authentication handler to the session + self.auth = MultiDomainBasicAuth(index_urls=index_urls) + + # Create our urllib3.Retry instance which will allow us to customize + # how we handle retries. + retries = urllib3.Retry( + # Set the total number of retries that a particular request can + # have. + total=retries, + # A 503 error from PyPI typically means that the Fastly -> Origin + # connection got interrupted in some way. A 503 error in general + # is typically considered a transient error so we'll go ahead and + # retry it. + # A 500 may indicate transient error in Amazon S3 + # A 502 may be a transient error from a CDN like CloudFlare or CloudFront + # A 520 or 527 - may indicate transient error in CloudFlare + status_forcelist=[500, 502, 503, 520, 527], + # Add a small amount of back off between failed requests in + # order to prevent hammering the service. + backoff_factor=0.25, + ) # type: ignore + + # Our Insecure HTTPAdapter disables HTTPS validation. It does not + # support caching so we'll use it for all http:// URLs. + # If caching is disabled, we will also use it for + # https:// hosts that we've marked as ignoring + # TLS errors for (trusted-hosts). + insecure_adapter = InsecureHTTPAdapter(max_retries=retries) + + # We want to _only_ cache responses on securely fetched origins or when + # the host is specified as trusted. We do this because + # we can't validate the response of an insecurely/untrusted fetched + # origin, and we don't want someone to be able to poison the cache and + # require manual eviction from the cache to fix it. + if cache: + secure_adapter = CacheControlAdapter( + cache=SafeFileCache(cache), + max_retries=retries, + ssl_context=ssl_context, + ) + self._trusted_host_adapter = InsecureCacheControlAdapter( + cache=SafeFileCache(cache), + max_retries=retries, + ) + else: + secure_adapter = HTTPAdapter(max_retries=retries, ssl_context=ssl_context) + self._trusted_host_adapter = insecure_adapter + + self.mount("https://", secure_adapter) + self.mount("http://", insecure_adapter) + + # Enable file:// urls + self.mount("file://", LocalFSAdapter()) + + for host in trusted_hosts: + self.add_trusted_host(host, suppress_logging=True) + + def update_index_urls(self, new_index_urls: List[str]) -> None: + """ + :param new_index_urls: New index urls to update the authentication + handler with. + """ + self.auth.index_urls = new_index_urls + + def add_trusted_host( + self, host: str, source: Optional[str] = None, suppress_logging: bool = False + ) -> None: + """ + :param host: It is okay to provide a host that has previously been + added. + :param source: An optional source string, for logging where the host + string came from. + """ + if not suppress_logging: + msg = f"adding trusted host: {host!r}" + if source is not None: + msg += f" (from {source})" + logger.info(msg) + + parsed_host, parsed_port = parse_netloc(host) + if parsed_host is None: + raise ValueError(f"Trusted host URL must include a host part: {host!r}") + if (parsed_host, parsed_port) not in self.pip_trusted_origins: + self.pip_trusted_origins.append((parsed_host, parsed_port)) + + self.mount( + build_url_from_netloc(host, scheme="http") + "/", self._trusted_host_adapter + ) + self.mount(build_url_from_netloc(host) + "/", self._trusted_host_adapter) + if not parsed_port: + self.mount( + build_url_from_netloc(host, scheme="http") + ":", + self._trusted_host_adapter, + ) + # Mount wildcard ports for the same host. + self.mount(build_url_from_netloc(host) + ":", self._trusted_host_adapter) + + def iter_secure_origins(self) -> Generator[SecureOrigin, None, None]: + yield from SECURE_ORIGINS + for host, port in self.pip_trusted_origins: + yield ("*", host, "*" if port is None else port) + + def is_secure_origin(self, location: Link) -> bool: + # Determine if this url used a secure transport mechanism + parsed = urllib.parse.urlparse(str(location)) + origin_protocol, origin_host, origin_port = ( + parsed.scheme, + parsed.hostname, + parsed.port, + ) + + # The protocol to use to see if the protocol matches. + # Don't count the repository type as part of the protocol: in + # cases such as "git+ssh", only use "ssh". (I.e., Only verify against + # the last scheme.) + origin_protocol = origin_protocol.rsplit("+", 1)[-1] + + # Determine if our origin is a secure origin by looking through our + # hardcoded list of secure origins, as well as any additional ones + # configured on this PackageFinder instance. + for secure_origin in self.iter_secure_origins(): + secure_protocol, secure_host, secure_port = secure_origin + if origin_protocol != secure_protocol and secure_protocol != "*": + continue + + try: + addr = ipaddress.ip_address(origin_host or "") + network = ipaddress.ip_network(secure_host) + except ValueError: + # We don't have both a valid address or a valid network, so + # we'll check this origin against hostnames. + if ( + origin_host + and origin_host.lower() != secure_host.lower() + and secure_host != "*" + ): + continue + else: + # We have a valid address and network, so see if the address + # is contained within the network. + if addr not in network: + continue + + # Check to see if the port matches. + if ( + origin_port != secure_port + and secure_port != "*" + and secure_port is not None + ): + continue + + # If we've gotten here, then this origin matches the current + # secure origin and we should return True + return True + + # If we've gotten to this point, then the origin isn't secure and we + # will not accept it as a valid location to search. We will however + # log a warning that we are ignoring it. + logger.warning( + "The repository located at %s is not a trusted or secure host and " + "is being ignored. If this repository is available via HTTPS we " + "recommend you use HTTPS instead, otherwise you may silence " + "this warning and allow it anyway with '--trusted-host %s'.", + origin_host, + origin_host, + ) + + return False + + def request(self, method: str, url: str, *args: Any, **kwargs: Any) -> Response: + # Allow setting a default timeout on a session + kwargs.setdefault("timeout", self.timeout) + # Allow setting a default proxies on a session + kwargs.setdefault("proxies", self.proxies) + + # Dispatch the actual request + return super().request(method, url, *args, **kwargs) diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/network/utils.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/network/utils.py new file mode 100644 index 0000000..bba4c26 --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/network/utils.py @@ -0,0 +1,98 @@ +from typing import Dict, Generator + +from pip._vendor.requests.models import Response + +from pip._internal.exceptions import NetworkConnectionError + +# The following comments and HTTP headers were originally added by +# Donald Stufft in git commit 22c562429a61bb77172039e480873fb239dd8c03. +# +# We use Accept-Encoding: identity here because requests defaults to +# accepting compressed responses. This breaks in a variety of ways +# depending on how the server is configured. +# - Some servers will notice that the file isn't a compressible file +# and will leave the file alone and with an empty Content-Encoding +# - Some servers will notice that the file is already compressed and +# will leave the file alone, adding a Content-Encoding: gzip header +# - Some servers won't notice anything at all and will take a file +# that's already been compressed and compress it again, and set +# the Content-Encoding: gzip header +# By setting this to request only the identity encoding we're hoping +# to eliminate the third case. Hopefully there does not exist a server +# which when given a file will notice it is already compressed and that +# you're not asking for a compressed file and will then decompress it +# before sending because if that's the case I don't think it'll ever be +# possible to make this work. +HEADERS: Dict[str, str] = {"Accept-Encoding": "identity"} + +DOWNLOAD_CHUNK_SIZE = 256 * 1024 + + +def raise_for_status(resp: Response) -> None: + http_error_msg = "" + if isinstance(resp.reason, bytes): + # We attempt to decode utf-8 first because some servers + # choose to localize their reason strings. If the string + # isn't utf-8, we fall back to iso-8859-1 for all other + # encodings. + try: + reason = resp.reason.decode("utf-8") + except UnicodeDecodeError: + reason = resp.reason.decode("iso-8859-1") + else: + reason = resp.reason + + if 400 <= resp.status_code < 500: + http_error_msg = ( + f"{resp.status_code} Client Error: {reason} for url: {resp.url}" + ) + + elif 500 <= resp.status_code < 600: + http_error_msg = ( + f"{resp.status_code} Server Error: {reason} for url: {resp.url}" + ) + + if http_error_msg: + raise NetworkConnectionError(http_error_msg, response=resp) + + +def response_chunks( + response: Response, chunk_size: int = DOWNLOAD_CHUNK_SIZE +) -> Generator[bytes, None, None]: + """Given a requests Response, provide the data chunks.""" + try: + # Special case for urllib3. + for chunk in response.raw.stream( + chunk_size, + # We use decode_content=False here because we don't + # want urllib3 to mess with the raw bytes we get + # from the server. If we decompress inside of + # urllib3 then we cannot verify the checksum + # because the checksum will be of the compressed + # file. This breakage will only occur if the + # server adds a Content-Encoding header, which + # depends on how the server was configured: + # - Some servers will notice that the file isn't a + # compressible file and will leave the file alone + # and with an empty Content-Encoding + # - Some servers will notice that the file is + # already compressed and will leave the file + # alone and will add a Content-Encoding: gzip + # header + # - Some servers won't notice anything at all and + # will take a file that's already been compressed + # and compress it again and set the + # Content-Encoding: gzip header + # + # By setting this not to decode automatically we + # hope to eliminate problems with the second case. + decode_content=False, + ): + yield chunk + except AttributeError: + # Standard file-like object. + while True: + chunk = response.raw.read(chunk_size) + if not chunk: + break + yield chunk diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/network/xmlrpc.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/network/xmlrpc.py new file mode 100644 index 0000000..22ec8d2 --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/network/xmlrpc.py @@ -0,0 +1,62 @@ +"""xmlrpclib.Transport implementation +""" + +import logging +import urllib.parse +import xmlrpc.client +from typing import TYPE_CHECKING, Tuple + +from pip._internal.exceptions import NetworkConnectionError +from pip._internal.network.session import PipSession +from pip._internal.network.utils import raise_for_status + +if TYPE_CHECKING: + from xmlrpc.client import _HostType, _Marshallable + + from _typeshed import SizedBuffer + +logger = logging.getLogger(__name__) + + +class PipXmlrpcTransport(xmlrpc.client.Transport): + """Provide a `xmlrpclib.Transport` implementation via a `PipSession` + object. + """ + + def __init__( + self, index_url: str, session: PipSession, use_datetime: bool = False + ) -> None: + super().__init__(use_datetime) + index_parts = urllib.parse.urlparse(index_url) + self._scheme = index_parts.scheme + self._session = session + + def request( + self, + host: "_HostType", + handler: str, + request_body: "SizedBuffer", + verbose: bool = False, + ) -> Tuple["_Marshallable", ...]: + assert isinstance(host, str) + parts = (self._scheme, host, handler, None, None, None) + url = urllib.parse.urlunparse(parts) + try: + headers = {"Content-Type": "text/xml"} + response = self._session.post( + url, + data=request_body, + headers=headers, + stream=True, + ) + raise_for_status(response) + self.verbose = verbose + return self.parse_response(response.raw) + except NetworkConnectionError as exc: + assert exc.response + logger.critical( + "HTTP error %s while getting %s", + exc.response.status_code, + url, + ) + raise diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/operations/__init__.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/operations/__init__.py new file mode 100644 index 0000000..e69de29 diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/operations/__pycache__/__init__.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/operations/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000..a8a375e Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/operations/__pycache__/__init__.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/operations/__pycache__/check.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/operations/__pycache__/check.cpython-312.pyc new file mode 100644 index 0000000..b4e3bf4 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/operations/__pycache__/check.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/operations/__pycache__/freeze.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/operations/__pycache__/freeze.cpython-312.pyc new file mode 100644 index 0000000..70cc3cd Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/operations/__pycache__/freeze.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/operations/__pycache__/prepare.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/operations/__pycache__/prepare.cpython-312.pyc new file mode 100644 index 0000000..b9e08a4 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/operations/__pycache__/prepare.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/operations/build/__init__.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/operations/build/__init__.py new file mode 100644 index 0000000..e69de29 diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/operations/build/__pycache__/__init__.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/operations/build/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000..dae739a Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/operations/build/__pycache__/__init__.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/operations/build/__pycache__/build_tracker.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/operations/build/__pycache__/build_tracker.cpython-312.pyc new file mode 100644 index 0000000..70cb497 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/operations/build/__pycache__/build_tracker.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/operations/build/__pycache__/metadata.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/operations/build/__pycache__/metadata.cpython-312.pyc new file mode 100644 index 0000000..671ddd9 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/operations/build/__pycache__/metadata.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/operations/build/__pycache__/metadata_editable.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/operations/build/__pycache__/metadata_editable.cpython-312.pyc new file mode 100644 index 0000000..0134916 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/operations/build/__pycache__/metadata_editable.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/operations/build/__pycache__/metadata_legacy.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/operations/build/__pycache__/metadata_legacy.cpython-312.pyc new file mode 100644 index 0000000..59825c4 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/operations/build/__pycache__/metadata_legacy.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/operations/build/__pycache__/wheel.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/operations/build/__pycache__/wheel.cpython-312.pyc new file mode 100644 index 0000000..08d7900 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/operations/build/__pycache__/wheel.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/operations/build/__pycache__/wheel_editable.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/operations/build/__pycache__/wheel_editable.cpython-312.pyc new file mode 100644 index 0000000..4f83239 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/operations/build/__pycache__/wheel_editable.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/operations/build/__pycache__/wheel_legacy.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/operations/build/__pycache__/wheel_legacy.cpython-312.pyc new file mode 100644 index 0000000..e69d746 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/operations/build/__pycache__/wheel_legacy.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/operations/build/build_tracker.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/operations/build/build_tracker.py new file mode 100644 index 0000000..0ed8dd2 --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/operations/build/build_tracker.py @@ -0,0 +1,138 @@ +import contextlib +import hashlib +import logging +import os +from types import TracebackType +from typing import Dict, Generator, Optional, Type, Union + +from pip._internal.req.req_install import InstallRequirement +from pip._internal.utils.temp_dir import TempDirectory + +logger = logging.getLogger(__name__) + + +@contextlib.contextmanager +def update_env_context_manager(**changes: str) -> Generator[None, None, None]: + target = os.environ + + # Save values from the target and change them. + non_existent_marker = object() + saved_values: Dict[str, Union[object, str]] = {} + for name, new_value in changes.items(): + try: + saved_values[name] = target[name] + except KeyError: + saved_values[name] = non_existent_marker + target[name] = new_value + + try: + yield + finally: + # Restore original values in the target. + for name, original_value in saved_values.items(): + if original_value is non_existent_marker: + del target[name] + else: + assert isinstance(original_value, str) # for mypy + target[name] = original_value + + +@contextlib.contextmanager +def get_build_tracker() -> Generator["BuildTracker", None, None]: + root = os.environ.get("PIP_BUILD_TRACKER") + with contextlib.ExitStack() as ctx: + if root is None: + root = ctx.enter_context(TempDirectory(kind="build-tracker")).path + ctx.enter_context(update_env_context_manager(PIP_BUILD_TRACKER=root)) + logger.debug("Initialized build tracking at %s", root) + + with BuildTracker(root) as tracker: + yield tracker + + +class TrackerId(str): + """Uniquely identifying string provided to the build tracker.""" + + +class BuildTracker: + """Ensure that an sdist cannot request itself as a setup requirement. + + When an sdist is prepared, it identifies its setup requirements in the + context of ``BuildTracker.track()``. If a requirement shows up recursively, this + raises an exception. + + This stops fork bombs embedded in malicious packages.""" + + def __init__(self, root: str) -> None: + self._root = root + self._entries: Dict[TrackerId, InstallRequirement] = {} + logger.debug("Created build tracker: %s", self._root) + + def __enter__(self) -> "BuildTracker": + logger.debug("Entered build tracker: %s", self._root) + return self + + def __exit__( + self, + exc_type: Optional[Type[BaseException]], + exc_val: Optional[BaseException], + exc_tb: Optional[TracebackType], + ) -> None: + self.cleanup() + + def _entry_path(self, key: TrackerId) -> str: + hashed = hashlib.sha224(key.encode()).hexdigest() + return os.path.join(self._root, hashed) + + def add(self, req: InstallRequirement, key: TrackerId) -> None: + """Add an InstallRequirement to build tracking.""" + + # Get the file to write information about this requirement. + entry_path = self._entry_path(key) + + # Try reading from the file. If it exists and can be read from, a build + # is already in progress, so a LookupError is raised. + try: + with open(entry_path) as fp: + contents = fp.read() + except FileNotFoundError: + pass + else: + message = f"{req.link} is already being built: {contents}" + raise LookupError(message) + + # If we're here, req should really not be building already. + assert key not in self._entries + + # Start tracking this requirement. + with open(entry_path, "w", encoding="utf-8") as fp: + fp.write(str(req)) + self._entries[key] = req + + logger.debug("Added %s to build tracker %r", req, self._root) + + def remove(self, req: InstallRequirement, key: TrackerId) -> None: + """Remove an InstallRequirement from build tracking.""" + + # Delete the created file and the corresponding entry. + os.unlink(self._entry_path(key)) + del self._entries[key] + + logger.debug("Removed %s from build tracker %r", req, self._root) + + def cleanup(self) -> None: + for key, req in list(self._entries.items()): + self.remove(req, key) + + logger.debug("Removed build tracker: %r", self._root) + + @contextlib.contextmanager + def track(self, req: InstallRequirement, key: str) -> Generator[None, None, None]: + """Ensure that `key` cannot install itself as a setup requirement. + + :raises LookupError: If `key` was already provided in a parent invocation of + the context introduced by this method.""" + tracker_id = TrackerId(key) + self.add(req, tracker_id) + yield + self.remove(req, tracker_id) diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/operations/build/metadata.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/operations/build/metadata.py new file mode 100644 index 0000000..c66ac35 --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/operations/build/metadata.py @@ -0,0 +1,39 @@ +"""Metadata generation logic for source distributions. +""" + +import os + +from pip._vendor.pyproject_hooks import BuildBackendHookCaller + +from pip._internal.build_env import BuildEnvironment +from pip._internal.exceptions import ( + InstallationSubprocessError, + MetadataGenerationFailed, +) +from pip._internal.utils.subprocess import runner_with_spinner_message +from pip._internal.utils.temp_dir import TempDirectory + + +def generate_metadata( + build_env: BuildEnvironment, backend: BuildBackendHookCaller, details: str +) -> str: + """Generate metadata using mechanisms described in PEP 517. + + Returns the generated metadata directory. + """ + metadata_tmpdir = TempDirectory(kind="modern-metadata", globally_managed=True) + + metadata_dir = metadata_tmpdir.path + + with build_env: + # Note that BuildBackendHookCaller implements a fallback for + # prepare_metadata_for_build_wheel, so we don't have to + # consider the possibility that this hook doesn't exist. + runner = runner_with_spinner_message("Preparing metadata (pyproject.toml)") + with backend.subprocess_runner(runner): + try: + distinfo_dir = backend.prepare_metadata_for_build_wheel(metadata_dir) + except InstallationSubprocessError as error: + raise MetadataGenerationFailed(package_details=details) from error + + return os.path.join(metadata_dir, distinfo_dir) diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/operations/build/metadata_editable.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/operations/build/metadata_editable.py new file mode 100644 index 0000000..3397ccf --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/operations/build/metadata_editable.py @@ -0,0 +1,42 @@ +"""Metadata generation logic for source distributions. +""" + +import os + +from pip._vendor.pyproject_hooks import BuildBackendHookCaller + +from pip._internal.build_env import BuildEnvironment +from pip._internal.exceptions import ( + InstallationSubprocessError, + MetadataGenerationFailed, +) +from pip._internal.utils.subprocess import runner_with_spinner_message +from pip._internal.utils.temp_dir import TempDirectory + + +def generate_editable_metadata( + build_env: BuildEnvironment, backend: BuildBackendHookCaller, details: str +) -> str: + """Generate metadata using mechanisms described in PEP 660. + + Returns the generated metadata directory. + """ + metadata_tmpdir = TempDirectory(kind="modern-metadata", globally_managed=True) + + metadata_dir = metadata_tmpdir.path + + with build_env: + # Note that BuildBackendHookCaller implements a fallback for + # prepare_metadata_for_build_wheel/editable, so we don't have to + # consider the possibility that this hook doesn't exist. + runner = runner_with_spinner_message( + "Preparing editable metadata (pyproject.toml)" + ) + with backend.subprocess_runner(runner): + try: + distinfo_dir = backend.prepare_metadata_for_build_editable(metadata_dir) + except InstallationSubprocessError as error: + raise MetadataGenerationFailed(package_details=details) from error + + assert distinfo_dir is not None + return os.path.join(metadata_dir, distinfo_dir) diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/operations/build/metadata_legacy.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/operations/build/metadata_legacy.py new file mode 100644 index 0000000..c01dd1c --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/operations/build/metadata_legacy.py @@ -0,0 +1,74 @@ +"""Metadata generation logic for legacy source distributions. +""" + +import logging +import os + +from pip._internal.build_env import BuildEnvironment +from pip._internal.cli.spinners import open_spinner +from pip._internal.exceptions import ( + InstallationError, + InstallationSubprocessError, + MetadataGenerationFailed, +) +from pip._internal.utils.setuptools_build import make_setuptools_egg_info_args +from pip._internal.utils.subprocess import call_subprocess +from pip._internal.utils.temp_dir import TempDirectory + +logger = logging.getLogger(__name__) + + +def _find_egg_info(directory: str) -> str: + """Find an .egg-info subdirectory in `directory`.""" + filenames = [f for f in os.listdir(directory) if f.endswith(".egg-info")] + + if not filenames: + raise InstallationError(f"No .egg-info directory found in {directory}") + + if len(filenames) > 1: + raise InstallationError( + f"More than one .egg-info directory found in {directory}" + ) + + return os.path.join(directory, filenames[0]) + + +def generate_metadata( + build_env: BuildEnvironment, + setup_py_path: str, + source_dir: str, + isolated: bool, + details: str, +) -> str: + """Generate metadata using setup.py-based defacto mechanisms. + + Returns the generated metadata directory. + """ + logger.debug( + "Running setup.py (path:%s) egg_info for package %s", + setup_py_path, + details, + ) + + egg_info_dir = TempDirectory(kind="pip-egg-info", globally_managed=True).path + + args = make_setuptools_egg_info_args( + setup_py_path, + egg_info_dir=egg_info_dir, + no_user_config=isolated, + ) + + with build_env: + with open_spinner("Preparing metadata (setup.py)") as spinner: + try: + call_subprocess( + args, + cwd=source_dir, + command_desc="python setup.py egg_info", + spinner=spinner, + ) + except InstallationSubprocessError as error: + raise MetadataGenerationFailed(package_details=details) from error + + # Return the .egg-info directory. + return _find_egg_info(egg_info_dir) diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/operations/build/wheel.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/operations/build/wheel.py new file mode 100644 index 0000000..064811a --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/operations/build/wheel.py @@ -0,0 +1,37 @@ +import logging +import os +from typing import Optional + +from pip._vendor.pyproject_hooks import BuildBackendHookCaller + +from pip._internal.utils.subprocess import runner_with_spinner_message + +logger = logging.getLogger(__name__) + + +def build_wheel_pep517( + name: str, + backend: BuildBackendHookCaller, + metadata_directory: str, + tempd: str, +) -> Optional[str]: + """Build one InstallRequirement using the PEP 517 build process. + + Returns path to wheel if successfully built. Otherwise, returns None. + """ + assert metadata_directory is not None + try: + logger.debug("Destination directory: %s", tempd) + + runner = runner_with_spinner_message( + f"Building wheel for {name} (pyproject.toml)" + ) + with backend.subprocess_runner(runner): + wheel_name = backend.build_wheel( + tempd, + metadata_directory=metadata_directory, + ) + except Exception: + logger.error("Failed building wheel for %s", name) + return None + return os.path.join(tempd, wheel_name) diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/operations/build/wheel_editable.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/operations/build/wheel_editable.py new file mode 100644 index 0000000..719d69d --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/operations/build/wheel_editable.py @@ -0,0 +1,46 @@ +import logging +import os +from typing import Optional + +from pip._vendor.pyproject_hooks import BuildBackendHookCaller, HookMissing + +from pip._internal.utils.subprocess import runner_with_spinner_message + +logger = logging.getLogger(__name__) + + +def build_wheel_editable( + name: str, + backend: BuildBackendHookCaller, + metadata_directory: str, + tempd: str, +) -> Optional[str]: + """Build one InstallRequirement using the PEP 660 build process. + + Returns path to wheel if successfully built. Otherwise, returns None. + """ + assert metadata_directory is not None + try: + logger.debug("Destination directory: %s", tempd) + + runner = runner_with_spinner_message( + f"Building editable for {name} (pyproject.toml)" + ) + with backend.subprocess_runner(runner): + try: + wheel_name = backend.build_editable( + tempd, + metadata_directory=metadata_directory, + ) + except HookMissing as e: + logger.error( + "Cannot build editable %s because the build " + "backend does not have the %s hook", + name, + e, + ) + return None + except Exception: + logger.error("Failed building editable for %s", name) + return None + return os.path.join(tempd, wheel_name) diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/operations/build/wheel_legacy.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/operations/build/wheel_legacy.py new file mode 100644 index 0000000..3ee2a70 --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/operations/build/wheel_legacy.py @@ -0,0 +1,102 @@ +import logging +import os.path +from typing import List, Optional + +from pip._internal.cli.spinners import open_spinner +from pip._internal.utils.setuptools_build import make_setuptools_bdist_wheel_args +from pip._internal.utils.subprocess import call_subprocess, format_command_args + +logger = logging.getLogger(__name__) + + +def format_command_result( + command_args: List[str], + command_output: str, +) -> str: + """Format command information for logging.""" + command_desc = format_command_args(command_args) + text = f"Command arguments: {command_desc}\n" + + if not command_output: + text += "Command output: None" + elif logger.getEffectiveLevel() > logging.DEBUG: + text += "Command output: [use --verbose to show]" + else: + if not command_output.endswith("\n"): + command_output += "\n" + text += f"Command output:\n{command_output}" + + return text + + +def get_legacy_build_wheel_path( + names: List[str], + temp_dir: str, + name: str, + command_args: List[str], + command_output: str, +) -> Optional[str]: + """Return the path to the wheel in the temporary build directory.""" + # Sort for determinism. + names = sorted(names) + if not names: + msg = f"Legacy build of wheel for {name!r} created no files.\n" + msg += format_command_result(command_args, command_output) + logger.warning(msg) + return None + + if len(names) > 1: + msg = ( + f"Legacy build of wheel for {name!r} created more than one file.\n" + f"Filenames (choosing first): {names}\n" + ) + msg += format_command_result(command_args, command_output) + logger.warning(msg) + + return os.path.join(temp_dir, names[0]) + + +def build_wheel_legacy( + name: str, + setup_py_path: str, + source_dir: str, + global_options: List[str], + build_options: List[str], + tempd: str, +) -> Optional[str]: + """Build one unpacked package using the "legacy" build process. + + Returns path to wheel if successfully built. Otherwise, returns None. + """ + wheel_args = make_setuptools_bdist_wheel_args( + setup_py_path, + global_options=global_options, + build_options=build_options, + destination_dir=tempd, + ) + + spin_message = f"Building wheel for {name} (setup.py)" + with open_spinner(spin_message) as spinner: + logger.debug("Destination directory: %s", tempd) + + try: + output = call_subprocess( + wheel_args, + command_desc="python setup.py bdist_wheel", + cwd=source_dir, + spinner=spinner, + ) + except Exception: + spinner.finish("error") + logger.error("Failed building wheel for %s", name) + return None + + names = os.listdir(tempd) + wheel_path = get_legacy_build_wheel_path( + names=names, + temp_dir=tempd, + name=name, + command_args=wheel_args, + command_output=output, + ) + return wheel_path diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/operations/check.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/operations/check.py new file mode 100644 index 0000000..4b6fbc4 --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/operations/check.py @@ -0,0 +1,181 @@ +"""Validation of dependencies of packages +""" + +import logging +from contextlib import suppress +from email.parser import Parser +from functools import reduce +from typing import ( + Callable, + Dict, + FrozenSet, + Generator, + Iterable, + List, + NamedTuple, + Optional, + Set, + Tuple, +) + +from pip._vendor.packaging.requirements import Requirement +from pip._vendor.packaging.tags import Tag, parse_tag +from pip._vendor.packaging.utils import NormalizedName, canonicalize_name +from pip._vendor.packaging.version import Version + +from pip._internal.distributions import make_distribution_for_install_requirement +from pip._internal.metadata import get_default_environment +from pip._internal.metadata.base import BaseDistribution +from pip._internal.req.req_install import InstallRequirement + +logger = logging.getLogger(__name__) + + +class PackageDetails(NamedTuple): + version: Version + dependencies: List[Requirement] + + +# Shorthands +PackageSet = Dict[NormalizedName, PackageDetails] +Missing = Tuple[NormalizedName, Requirement] +Conflicting = Tuple[NormalizedName, Version, Requirement] + +MissingDict = Dict[NormalizedName, List[Missing]] +ConflictingDict = Dict[NormalizedName, List[Conflicting]] +CheckResult = Tuple[MissingDict, ConflictingDict] +ConflictDetails = Tuple[PackageSet, CheckResult] + + +def create_package_set_from_installed() -> Tuple[PackageSet, bool]: + """Converts a list of distributions into a PackageSet.""" + package_set = {} + problems = False + env = get_default_environment() + for dist in env.iter_installed_distributions(local_only=False, skip=()): + name = dist.canonical_name + try: + dependencies = list(dist.iter_dependencies()) + package_set[name] = PackageDetails(dist.version, dependencies) + except (OSError, ValueError) as e: + # Don't crash on unreadable or broken metadata. + logger.warning("Error parsing dependencies of %s: %s", name, e) + problems = True + return package_set, problems + + +def check_package_set( + package_set: PackageSet, should_ignore: Optional[Callable[[str], bool]] = None +) -> CheckResult: + """Check if a package set is consistent + + If should_ignore is passed, it should be a callable that takes a + package name and returns a boolean. + """ + + missing = {} + conflicting = {} + + for package_name, package_detail in package_set.items(): + # Info about dependencies of package_name + missing_deps: Set[Missing] = set() + conflicting_deps: Set[Conflicting] = set() + + if should_ignore and should_ignore(package_name): + continue + + for req in package_detail.dependencies: + name = canonicalize_name(req.name) + + # Check if it's missing + if name not in package_set: + missed = True + if req.marker is not None: + missed = req.marker.evaluate({"extra": ""}) + if missed: + missing_deps.add((name, req)) + continue + + # Check if there's a conflict + version = package_set[name].version + if not req.specifier.contains(version, prereleases=True): + conflicting_deps.add((name, version, req)) + + if missing_deps: + missing[package_name] = sorted(missing_deps, key=str) + if conflicting_deps: + conflicting[package_name] = sorted(conflicting_deps, key=str) + + return missing, conflicting + + +def check_install_conflicts(to_install: List[InstallRequirement]) -> ConflictDetails: + """For checking if the dependency graph would be consistent after \ + installing given requirements + """ + # Start from the current state + package_set, _ = create_package_set_from_installed() + # Install packages + would_be_installed = _simulate_installation_of(to_install, package_set) + + # Only warn about directly-dependent packages; create a whitelist of them + whitelist = _create_whitelist(would_be_installed, package_set) + + return ( + package_set, + check_package_set( + package_set, should_ignore=lambda name: name not in whitelist + ), + ) + + +def check_unsupported( + packages: Iterable[BaseDistribution], + supported_tags: Iterable[Tag], +) -> Generator[BaseDistribution, None, None]: + for p in packages: + with suppress(FileNotFoundError): + wheel_file = p.read_text("WHEEL") + wheel_tags: FrozenSet[Tag] = reduce( + frozenset.union, + map(parse_tag, Parser().parsestr(wheel_file).get_all("Tag", [])), + frozenset(), + ) + if wheel_tags.isdisjoint(supported_tags): + yield p + + +def _simulate_installation_of( + to_install: List[InstallRequirement], package_set: PackageSet +) -> Set[NormalizedName]: + """Computes the version of packages after installing to_install.""" + # Keep track of packages that were installed + installed = set() + + # Modify it as installing requirement_set would (assuming no errors) + for inst_req in to_install: + abstract_dist = make_distribution_for_install_requirement(inst_req) + dist = abstract_dist.get_metadata_distribution() + name = dist.canonical_name + package_set[name] = PackageDetails(dist.version, list(dist.iter_dependencies())) + + installed.add(name) + + return installed + + +def _create_whitelist( + would_be_installed: Set[NormalizedName], package_set: PackageSet +) -> Set[NormalizedName]: + packages_affected = set(would_be_installed) + + for package_name in package_set: + if package_name in packages_affected: + continue + + for req in package_set[package_name].dependencies: + if canonicalize_name(req.name) in packages_affected: + packages_affected.add(package_name) + break + + return packages_affected diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/operations/freeze.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/operations/freeze.py new file mode 100644 index 0000000..ae5dd37 --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/operations/freeze.py @@ -0,0 +1,256 @@ +import collections +import logging +import os +from dataclasses import dataclass, field +from typing import Container, Dict, Generator, Iterable, List, NamedTuple, Optional, Set + +from pip._vendor.packaging.utils import NormalizedName, canonicalize_name +from pip._vendor.packaging.version import InvalidVersion + +from pip._internal.exceptions import BadCommand, InstallationError +from pip._internal.metadata import BaseDistribution, get_environment +from pip._internal.req.constructors import ( + install_req_from_editable, + install_req_from_line, +) +from pip._internal.req.req_file import COMMENT_RE +from pip._internal.utils.direct_url_helpers import direct_url_as_pep440_direct_reference + +logger = logging.getLogger(__name__) + + +class _EditableInfo(NamedTuple): + requirement: str + comments: List[str] + + +def freeze( + requirement: Optional[List[str]] = None, + local_only: bool = False, + user_only: bool = False, + paths: Optional[List[str]] = None, + isolated: bool = False, + exclude_editable: bool = False, + skip: Container[str] = (), +) -> Generator[str, None, None]: + installations: Dict[str, FrozenRequirement] = {} + + dists = get_environment(paths).iter_installed_distributions( + local_only=local_only, + skip=(), + user_only=user_only, + ) + for dist in dists: + req = FrozenRequirement.from_dist(dist) + if exclude_editable and req.editable: + continue + installations[req.canonical_name] = req + + if requirement: + # the options that don't get turned into an InstallRequirement + # should only be emitted once, even if the same option is in multiple + # requirements files, so we need to keep track of what has been emitted + # so that we don't emit it again if it's seen again + emitted_options: Set[str] = set() + # keep track of which files a requirement is in so that we can + # give an accurate warning if a requirement appears multiple times. + req_files: Dict[str, List[str]] = collections.defaultdict(list) + for req_file_path in requirement: + with open(req_file_path) as req_file: + for line in req_file: + if ( + not line.strip() + or line.strip().startswith("#") + or line.startswith( + ( + "-r", + "--requirement", + "-f", + "--find-links", + "-i", + "--index-url", + "--pre", + "--trusted-host", + "--process-dependency-links", + "--extra-index-url", + "--use-feature", + ) + ) + ): + line = line.rstrip() + if line not in emitted_options: + emitted_options.add(line) + yield line + continue + + if line.startswith("-e") or line.startswith("--editable"): + if line.startswith("-e"): + line = line[2:].strip() + else: + line = line[len("--editable") :].strip().lstrip("=") + line_req = install_req_from_editable( + line, + isolated=isolated, + ) + else: + line_req = install_req_from_line( + COMMENT_RE.sub("", line).strip(), + isolated=isolated, + ) + + if not line_req.name: + logger.info( + "Skipping line in requirement file [%s] because " + "it's not clear what it would install: %s", + req_file_path, + line.strip(), + ) + logger.info( + " (add #egg=PackageName to the URL to avoid" + " this warning)" + ) + else: + line_req_canonical_name = canonicalize_name(line_req.name) + if line_req_canonical_name not in installations: + # either it's not installed, or it is installed + # but has been processed already + if not req_files[line_req.name]: + logger.warning( + "Requirement file [%s] contains %s, but " + "package %r is not installed", + req_file_path, + COMMENT_RE.sub("", line).strip(), + line_req.name, + ) + else: + req_files[line_req.name].append(req_file_path) + else: + yield str(installations[line_req_canonical_name]).rstrip() + del installations[line_req_canonical_name] + req_files[line_req.name].append(req_file_path) + + # Warn about requirements that were included multiple times (in a + # single requirements file or in different requirements files). + for name, files in req_files.items(): + if len(files) > 1: + logger.warning( + "Requirement %s included multiple times [%s]", + name, + ", ".join(sorted(set(files))), + ) + + yield ("## The following requirements were added by pip freeze:") + for installation in sorted(installations.values(), key=lambda x: x.name.lower()): + if installation.canonical_name not in skip: + yield str(installation).rstrip() + + +def _format_as_name_version(dist: BaseDistribution) -> str: + try: + dist_version = dist.version + except InvalidVersion: + # legacy version + return f"{dist.raw_name}==={dist.raw_version}" + else: + return f"{dist.raw_name}=={dist_version}" + + +def _get_editable_info(dist: BaseDistribution) -> _EditableInfo: + """ + Compute and return values (req, comments) for use in + FrozenRequirement.from_dist(). + """ + editable_project_location = dist.editable_project_location + assert editable_project_location + location = os.path.normcase(os.path.abspath(editable_project_location)) + + from pip._internal.vcs import RemoteNotFoundError, RemoteNotValidError, vcs + + vcs_backend = vcs.get_backend_for_dir(location) + + if vcs_backend is None: + display = _format_as_name_version(dist) + logger.debug( + 'No VCS found for editable requirement "%s" in: %r', + display, + location, + ) + return _EditableInfo( + requirement=location, + comments=[f"# Editable install with no version control ({display})"], + ) + + vcs_name = type(vcs_backend).__name__ + + try: + req = vcs_backend.get_src_requirement(location, dist.raw_name) + except RemoteNotFoundError: + display = _format_as_name_version(dist) + return _EditableInfo( + requirement=location, + comments=[f"# Editable {vcs_name} install with no remote ({display})"], + ) + except RemoteNotValidError as ex: + display = _format_as_name_version(dist) + return _EditableInfo( + requirement=location, + comments=[ + f"# Editable {vcs_name} install ({display}) with either a deleted " + f"local remote or invalid URI:", + f"# '{ex.url}'", + ], + ) + except BadCommand: + logger.warning( + "cannot determine version of editable source in %s " + "(%s command not found in path)", + location, + vcs_backend.name, + ) + return _EditableInfo(requirement=location, comments=[]) + except InstallationError as exc: + logger.warning("Error when trying to get requirement for VCS system %s", exc) + else: + return _EditableInfo(requirement=req, comments=[]) + + logger.warning("Could not determine repository location of %s", location) + + return _EditableInfo( + requirement=location, + comments=["## !! Could not determine repository location"], + ) + + +@dataclass(frozen=True) +class FrozenRequirement: + name: str + req: str + editable: bool + comments: Iterable[str] = field(default_factory=tuple) + + @property + def canonical_name(self) -> NormalizedName: + return canonicalize_name(self.name) + + @classmethod + def from_dist(cls, dist: BaseDistribution) -> "FrozenRequirement": + editable = dist.editable + if editable: + req, comments = _get_editable_info(dist) + else: + comments = [] + direct_url = dist.direct_url + if direct_url: + # if PEP 610 metadata is present, use it + req = direct_url_as_pep440_direct_reference(direct_url, dist.raw_name) + else: + # name==version requirement + req = _format_as_name_version(dist) + + return cls(dist.raw_name, req, editable, comments=comments) + + def __str__(self) -> str: + req = self.req + if self.editable: + req = f"-e {req}" + return "\n".join(list(self.comments) + [str(req)]) + "\n" diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/operations/install/__init__.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/operations/install/__init__.py new file mode 100644 index 0000000..24d6a5d --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/operations/install/__init__.py @@ -0,0 +1,2 @@ +"""For modules related to installing packages. +""" diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/operations/install/__pycache__/__init__.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/operations/install/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000..3d9ca35 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/operations/install/__pycache__/__init__.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/operations/install/__pycache__/editable_legacy.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/operations/install/__pycache__/editable_legacy.cpython-312.pyc new file mode 100644 index 0000000..02926e1 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/operations/install/__pycache__/editable_legacy.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/operations/install/__pycache__/wheel.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/operations/install/__pycache__/wheel.cpython-312.pyc new file mode 100644 index 0000000..1fa80c3 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/operations/install/__pycache__/wheel.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/operations/install/editable_legacy.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/operations/install/editable_legacy.py new file mode 100644 index 0000000..9aaa699 --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/operations/install/editable_legacy.py @@ -0,0 +1,47 @@ +"""Legacy editable installation process, i.e. `setup.py develop`. +""" + +import logging +from typing import Optional, Sequence + +from pip._internal.build_env import BuildEnvironment +from pip._internal.utils.logging import indent_log +from pip._internal.utils.setuptools_build import make_setuptools_develop_args +from pip._internal.utils.subprocess import call_subprocess + +logger = logging.getLogger(__name__) + + +def install_editable( + *, + global_options: Sequence[str], + prefix: Optional[str], + home: Optional[str], + use_user_site: bool, + name: str, + setup_py_path: str, + isolated: bool, + build_env: BuildEnvironment, + unpacked_source_directory: str, +) -> None: + """Install a package in editable mode. Most arguments are pass-through + to setuptools. + """ + logger.info("Running setup.py develop for %s", name) + + args = make_setuptools_develop_args( + setup_py_path, + global_options=global_options, + no_user_config=isolated, + prefix=prefix, + home=home, + use_user_site=use_user_site, + ) + + with indent_log(): + with build_env: + call_subprocess( + args, + command_desc="python setup.py develop", + cwd=unpacked_source_directory, + ) diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/operations/install/wheel.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/operations/install/wheel.py new file mode 100644 index 0000000..aef42aa --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/operations/install/wheel.py @@ -0,0 +1,741 @@ +"""Support for installing and building the "wheel" binary package format. +""" + +import collections +import compileall +import contextlib +import csv +import importlib +import logging +import os.path +import re +import shutil +import sys +import warnings +from base64 import urlsafe_b64encode +from email.message import Message +from itertools import chain, filterfalse, starmap +from typing import ( + IO, + TYPE_CHECKING, + Any, + BinaryIO, + Callable, + Dict, + Generator, + Iterable, + Iterator, + List, + NewType, + Optional, + Protocol, + Sequence, + Set, + Tuple, + Union, + cast, +) +from zipfile import ZipFile, ZipInfo + +from pip._vendor.distlib.scripts import ScriptMaker +from pip._vendor.distlib.util import get_export_entry +from pip._vendor.packaging.utils import canonicalize_name + +from pip._internal.exceptions import InstallationError +from pip._internal.locations import get_major_minor_version +from pip._internal.metadata import ( + BaseDistribution, + FilesystemWheel, + get_wheel_distribution, +) +from pip._internal.models.direct_url import DIRECT_URL_METADATA_NAME, DirectUrl +from pip._internal.models.scheme import SCHEME_KEYS, Scheme +from pip._internal.utils.filesystem import adjacent_tmp_file, replace +from pip._internal.utils.misc import StreamWrapper, ensure_dir, hash_file, partition +from pip._internal.utils.unpacking import ( + current_umask, + is_within_directory, + set_extracted_file_to_default_mode_plus_executable, + zip_item_is_executable, +) +from pip._internal.utils.wheel import parse_wheel + +if TYPE_CHECKING: + + class File(Protocol): + src_record_path: "RecordPath" + dest_path: str + changed: bool + + def save(self) -> None: + pass + + +logger = logging.getLogger(__name__) + +RecordPath = NewType("RecordPath", str) +InstalledCSVRow = Tuple[RecordPath, str, Union[int, str]] + + +def rehash(path: str, blocksize: int = 1 << 20) -> Tuple[str, str]: + """Return (encoded_digest, length) for path using hashlib.sha256()""" + h, length = hash_file(path, blocksize) + digest = "sha256=" + urlsafe_b64encode(h.digest()).decode("latin1").rstrip("=") + return (digest, str(length)) + + +def csv_io_kwargs(mode: str) -> Dict[str, Any]: + """Return keyword arguments to properly open a CSV file + in the given mode. + """ + return {"mode": mode, "newline": "", "encoding": "utf-8"} + + +def fix_script(path: str) -> bool: + """Replace #!python with #!/path/to/python + Return True if file was changed. + """ + # XXX RECORD hashes will need to be updated + assert os.path.isfile(path) + + with open(path, "rb") as script: + firstline = script.readline() + if not firstline.startswith(b"#!python"): + return False + exename = sys.executable.encode(sys.getfilesystemencoding()) + firstline = b"#!" + exename + os.linesep.encode("ascii") + rest = script.read() + with open(path, "wb") as script: + script.write(firstline) + script.write(rest) + return True + + +def wheel_root_is_purelib(metadata: Message) -> bool: + return metadata.get("Root-Is-Purelib", "").lower() == "true" + + +def get_entrypoints(dist: BaseDistribution) -> Tuple[Dict[str, str], Dict[str, str]]: + console_scripts = {} + gui_scripts = {} + for entry_point in dist.iter_entry_points(): + if entry_point.group == "console_scripts": + console_scripts[entry_point.name] = entry_point.value + elif entry_point.group == "gui_scripts": + gui_scripts[entry_point.name] = entry_point.value + return console_scripts, gui_scripts + + +def message_about_scripts_not_on_PATH(scripts: Sequence[str]) -> Optional[str]: + """Determine if any scripts are not on PATH and format a warning. + Returns a warning message if one or more scripts are not on PATH, + otherwise None. + """ + if not scripts: + return None + + # Group scripts by the path they were installed in + grouped_by_dir: Dict[str, Set[str]] = collections.defaultdict(set) + for destfile in scripts: + parent_dir = os.path.dirname(destfile) + script_name = os.path.basename(destfile) + grouped_by_dir[parent_dir].add(script_name) + + # We don't want to warn for directories that are on PATH. + not_warn_dirs = [ + os.path.normcase(os.path.normpath(i)).rstrip(os.sep) + for i in os.environ.get("PATH", "").split(os.pathsep) + ] + # If an executable sits with sys.executable, we don't warn for it. + # This covers the case of venv invocations without activating the venv. + not_warn_dirs.append( + os.path.normcase(os.path.normpath(os.path.dirname(sys.executable))) + ) + warn_for: Dict[str, Set[str]] = { + parent_dir: scripts + for parent_dir, scripts in grouped_by_dir.items() + if os.path.normcase(os.path.normpath(parent_dir)) not in not_warn_dirs + } + if not warn_for: + return None + + # Format a message + msg_lines = [] + for parent_dir, dir_scripts in warn_for.items(): + sorted_scripts: List[str] = sorted(dir_scripts) + if len(sorted_scripts) == 1: + start_text = f"script {sorted_scripts[0]} is" + else: + start_text = "scripts {} are".format( + ", ".join(sorted_scripts[:-1]) + " and " + sorted_scripts[-1] + ) + + msg_lines.append( + f"The {start_text} installed in '{parent_dir}' which is not on PATH." + ) + + last_line_fmt = ( + "Consider adding {} to PATH or, if you prefer " + "to suppress this warning, use --no-warn-script-location." + ) + if len(msg_lines) == 1: + msg_lines.append(last_line_fmt.format("this directory")) + else: + msg_lines.append(last_line_fmt.format("these directories")) + + # Add a note if any directory starts with ~ + warn_for_tilde = any( + i[0] == "~" for i in os.environ.get("PATH", "").split(os.pathsep) if i + ) + if warn_for_tilde: + tilde_warning_msg = ( + "NOTE: The current PATH contains path(s) starting with `~`, " + "which may not be expanded by all applications." + ) + msg_lines.append(tilde_warning_msg) + + # Returns the formatted multiline message + return "\n".join(msg_lines) + + +def _normalized_outrows( + outrows: Iterable[InstalledCSVRow], +) -> List[Tuple[str, str, str]]: + """Normalize the given rows of a RECORD file. + + Items in each row are converted into str. Rows are then sorted to make + the value more predictable for tests. + + Each row is a 3-tuple (path, hash, size) and corresponds to a record of + a RECORD file (see PEP 376 and PEP 427 for details). For the rows + passed to this function, the size can be an integer as an int or string, + or the empty string. + """ + # Normally, there should only be one row per path, in which case the + # second and third elements don't come into play when sorting. + # However, in cases in the wild where a path might happen to occur twice, + # we don't want the sort operation to trigger an error (but still want + # determinism). Since the third element can be an int or string, we + # coerce each element to a string to avoid a TypeError in this case. + # For additional background, see-- + # https://github.com/pypa/pip/issues/5868 + return sorted( + (record_path, hash_, str(size)) for record_path, hash_, size in outrows + ) + + +def _record_to_fs_path(record_path: RecordPath, lib_dir: str) -> str: + return os.path.join(lib_dir, record_path) + + +def _fs_to_record_path(path: str, lib_dir: str) -> RecordPath: + # On Windows, do not handle relative paths if they belong to different + # logical disks + if os.path.splitdrive(path)[0].lower() == os.path.splitdrive(lib_dir)[0].lower(): + path = os.path.relpath(path, lib_dir) + + path = path.replace(os.path.sep, "/") + return cast("RecordPath", path) + + +def get_csv_rows_for_installed( + old_csv_rows: List[List[str]], + installed: Dict[RecordPath, RecordPath], + changed: Set[RecordPath], + generated: List[str], + lib_dir: str, +) -> List[InstalledCSVRow]: + """ + :param installed: A map from archive RECORD path to installation RECORD + path. + """ + installed_rows: List[InstalledCSVRow] = [] + for row in old_csv_rows: + if len(row) > 3: + logger.warning("RECORD line has more than three elements: %s", row) + old_record_path = cast("RecordPath", row[0]) + new_record_path = installed.pop(old_record_path, old_record_path) + if new_record_path in changed: + digest, length = rehash(_record_to_fs_path(new_record_path, lib_dir)) + else: + digest = row[1] if len(row) > 1 else "" + length = row[2] if len(row) > 2 else "" + installed_rows.append((new_record_path, digest, length)) + for f in generated: + path = _fs_to_record_path(f, lib_dir) + digest, length = rehash(f) + installed_rows.append((path, digest, length)) + return installed_rows + [ + (installed_record_path, "", "") for installed_record_path in installed.values() + ] + + +def get_console_script_specs(console: Dict[str, str]) -> List[str]: + """ + Given the mapping from entrypoint name to callable, return the relevant + console script specs. + """ + # Don't mutate caller's version + console = console.copy() + + scripts_to_generate = [] + + # Special case pip and setuptools to generate versioned wrappers + # + # The issue is that some projects (specifically, pip and setuptools) use + # code in setup.py to create "versioned" entry points - pip2.7 on Python + # 2.7, pip3.3 on Python 3.3, etc. But these entry points are baked into + # the wheel metadata at build time, and so if the wheel is installed with + # a *different* version of Python the entry points will be wrong. The + # correct fix for this is to enhance the metadata to be able to describe + # such versioned entry points. + # Currently, projects using versioned entry points will either have + # incorrect versioned entry points, or they will not be able to distribute + # "universal" wheels (i.e., they will need a wheel per Python version). + # + # Because setuptools and pip are bundled with _ensurepip and virtualenv, + # we need to use universal wheels. As a workaround, we + # override the versioned entry points in the wheel and generate the + # correct ones. + # + # To add the level of hack in this section of code, in order to support + # ensurepip this code will look for an ``ENSUREPIP_OPTIONS`` environment + # variable which will control which version scripts get installed. + # + # ENSUREPIP_OPTIONS=altinstall + # - Only pipX.Y and easy_install-X.Y will be generated and installed + # ENSUREPIP_OPTIONS=install + # - pipX.Y, pipX, easy_install-X.Y will be generated and installed. Note + # that this option is technically if ENSUREPIP_OPTIONS is set and is + # not altinstall + # DEFAULT + # - The default behavior is to install pip, pipX, pipX.Y, easy_install + # and easy_install-X.Y. + pip_script = console.pop("pip", None) + if pip_script: + if "ENSUREPIP_OPTIONS" not in os.environ: + scripts_to_generate.append("pip = " + pip_script) + + if os.environ.get("ENSUREPIP_OPTIONS", "") != "altinstall": + scripts_to_generate.append(f"pip{sys.version_info[0]} = {pip_script}") + + scripts_to_generate.append(f"pip{get_major_minor_version()} = {pip_script}") + # Delete any other versioned pip entry points + pip_ep = [k for k in console if re.match(r"pip(\d+(\.\d+)?)?$", k)] + for k in pip_ep: + del console[k] + easy_install_script = console.pop("easy_install", None) + if easy_install_script: + if "ENSUREPIP_OPTIONS" not in os.environ: + scripts_to_generate.append("easy_install = " + easy_install_script) + + scripts_to_generate.append( + f"easy_install-{get_major_minor_version()} = {easy_install_script}" + ) + # Delete any other versioned easy_install entry points + easy_install_ep = [ + k for k in console if re.match(r"easy_install(-\d+\.\d+)?$", k) + ] + for k in easy_install_ep: + del console[k] + + # Generate the console entry points specified in the wheel + scripts_to_generate.extend(starmap("{} = {}".format, console.items())) + + return scripts_to_generate + + +class ZipBackedFile: + def __init__( + self, src_record_path: RecordPath, dest_path: str, zip_file: ZipFile + ) -> None: + self.src_record_path = src_record_path + self.dest_path = dest_path + self._zip_file = zip_file + self.changed = False + + def _getinfo(self) -> ZipInfo: + return self._zip_file.getinfo(self.src_record_path) + + def save(self) -> None: + # When we open the output file below, any existing file is truncated + # before we start writing the new contents. This is fine in most + # cases, but can cause a segfault if pip has loaded a shared + # object (e.g. from pyopenssl through its vendored urllib3) + # Since the shared object is mmap'd an attempt to call a + # symbol in it will then cause a segfault. Unlinking the file + # allows writing of new contents while allowing the process to + # continue to use the old copy. + if os.path.exists(self.dest_path): + os.unlink(self.dest_path) + + zipinfo = self._getinfo() + + # optimization: the file is created by open(), + # skip the decompression when there is 0 bytes to decompress. + with open(self.dest_path, "wb") as dest: + if zipinfo.file_size > 0: + with self._zip_file.open(zipinfo) as f: + blocksize = min(zipinfo.file_size, 1024 * 1024) + shutil.copyfileobj(f, dest, blocksize) + + if zip_item_is_executable(zipinfo): + set_extracted_file_to_default_mode_plus_executable(self.dest_path) + + +class ScriptFile: + def __init__(self, file: "File") -> None: + self._file = file + self.src_record_path = self._file.src_record_path + self.dest_path = self._file.dest_path + self.changed = False + + def save(self) -> None: + self._file.save() + self.changed = fix_script(self.dest_path) + + +class MissingCallableSuffix(InstallationError): + def __init__(self, entry_point: str) -> None: + super().__init__( + f"Invalid script entry point: {entry_point} - A callable " + "suffix is required. Cf https://packaging.python.org/" + "specifications/entry-points/#use-for-scripts for more " + "information." + ) + + +def _raise_for_invalid_entrypoint(specification: str) -> None: + entry = get_export_entry(specification) + if entry is not None and entry.suffix is None: + raise MissingCallableSuffix(str(entry)) + + +class PipScriptMaker(ScriptMaker): + def make( + self, specification: str, options: Optional[Dict[str, Any]] = None + ) -> List[str]: + _raise_for_invalid_entrypoint(specification) + return super().make(specification, options) + + +def _install_wheel( # noqa: C901, PLR0915 function is too long + name: str, + wheel_zip: ZipFile, + wheel_path: str, + scheme: Scheme, + pycompile: bool = True, + warn_script_location: bool = True, + direct_url: Optional[DirectUrl] = None, + requested: bool = False, +) -> None: + """Install a wheel. + + :param name: Name of the project to install + :param wheel_zip: open ZipFile for wheel being installed + :param scheme: Distutils scheme dictating the install directories + :param req_description: String used in place of the requirement, for + logging + :param pycompile: Whether to byte-compile installed Python files + :param warn_script_location: Whether to check that scripts are installed + into a directory on PATH + :raises UnsupportedWheel: + * when the directory holds an unpacked wheel with incompatible + Wheel-Version + * when the .dist-info dir does not match the wheel + """ + info_dir, metadata = parse_wheel(wheel_zip, name) + + if wheel_root_is_purelib(metadata): + lib_dir = scheme.purelib + else: + lib_dir = scheme.platlib + + # Record details of the files moved + # installed = files copied from the wheel to the destination + # changed = files changed while installing (scripts #! line typically) + # generated = files newly generated during the install (script wrappers) + installed: Dict[RecordPath, RecordPath] = {} + changed: Set[RecordPath] = set() + generated: List[str] = [] + + def record_installed( + srcfile: RecordPath, destfile: str, modified: bool = False + ) -> None: + """Map archive RECORD paths to installation RECORD paths.""" + newpath = _fs_to_record_path(destfile, lib_dir) + installed[srcfile] = newpath + if modified: + changed.add(newpath) + + def is_dir_path(path: RecordPath) -> bool: + return path.endswith("/") + + def assert_no_path_traversal(dest_dir_path: str, target_path: str) -> None: + if not is_within_directory(dest_dir_path, target_path): + message = ( + "The wheel {!r} has a file {!r} trying to install" + " outside the target directory {!r}" + ) + raise InstallationError( + message.format(wheel_path, target_path, dest_dir_path) + ) + + def root_scheme_file_maker( + zip_file: ZipFile, dest: str + ) -> Callable[[RecordPath], "File"]: + def make_root_scheme_file(record_path: RecordPath) -> "File": + normed_path = os.path.normpath(record_path) + dest_path = os.path.join(dest, normed_path) + assert_no_path_traversal(dest, dest_path) + return ZipBackedFile(record_path, dest_path, zip_file) + + return make_root_scheme_file + + def data_scheme_file_maker( + zip_file: ZipFile, scheme: Scheme + ) -> Callable[[RecordPath], "File"]: + scheme_paths = {key: getattr(scheme, key) for key in SCHEME_KEYS} + + def make_data_scheme_file(record_path: RecordPath) -> "File": + normed_path = os.path.normpath(record_path) + try: + _, scheme_key, dest_subpath = normed_path.split(os.path.sep, 2) + except ValueError: + message = ( + f"Unexpected file in {wheel_path}: {record_path!r}. .data directory" + " contents should be named like: '/'." + ) + raise InstallationError(message) + + try: + scheme_path = scheme_paths[scheme_key] + except KeyError: + valid_scheme_keys = ", ".join(sorted(scheme_paths)) + message = ( + f"Unknown scheme key used in {wheel_path}: {scheme_key} " + f"(for file {record_path!r}). .data directory contents " + f"should be in subdirectories named with a valid scheme " + f"key ({valid_scheme_keys})" + ) + raise InstallationError(message) + + dest_path = os.path.join(scheme_path, dest_subpath) + assert_no_path_traversal(scheme_path, dest_path) + return ZipBackedFile(record_path, dest_path, zip_file) + + return make_data_scheme_file + + def is_data_scheme_path(path: RecordPath) -> bool: + return path.split("/", 1)[0].endswith(".data") + + paths = cast(List[RecordPath], wheel_zip.namelist()) + file_paths = filterfalse(is_dir_path, paths) + root_scheme_paths, data_scheme_paths = partition(is_data_scheme_path, file_paths) + + make_root_scheme_file = root_scheme_file_maker(wheel_zip, lib_dir) + files: Iterator[File] = map(make_root_scheme_file, root_scheme_paths) + + def is_script_scheme_path(path: RecordPath) -> bool: + parts = path.split("/", 2) + return len(parts) > 2 and parts[0].endswith(".data") and parts[1] == "scripts" + + other_scheme_paths, script_scheme_paths = partition( + is_script_scheme_path, data_scheme_paths + ) + + make_data_scheme_file = data_scheme_file_maker(wheel_zip, scheme) + other_scheme_files = map(make_data_scheme_file, other_scheme_paths) + files = chain(files, other_scheme_files) + + # Get the defined entry points + distribution = get_wheel_distribution( + FilesystemWheel(wheel_path), + canonicalize_name(name), + ) + console, gui = get_entrypoints(distribution) + + def is_entrypoint_wrapper(file: "File") -> bool: + # EP, EP.exe and EP-script.py are scripts generated for + # entry point EP by setuptools + path = file.dest_path + name = os.path.basename(path) + if name.lower().endswith(".exe"): + matchname = name[:-4] + elif name.lower().endswith("-script.py"): + matchname = name[:-10] + elif name.lower().endswith(".pya"): + matchname = name[:-4] + else: + matchname = name + # Ignore setuptools-generated scripts + return matchname in console or matchname in gui + + script_scheme_files: Iterator[File] = map( + make_data_scheme_file, script_scheme_paths + ) + script_scheme_files = filterfalse(is_entrypoint_wrapper, script_scheme_files) + script_scheme_files = map(ScriptFile, script_scheme_files) + files = chain(files, script_scheme_files) + + existing_parents = set() + for file in files: + # directory creation is lazy and after file filtering + # to ensure we don't install empty dirs; empty dirs can't be + # uninstalled. + parent_dir = os.path.dirname(file.dest_path) + if parent_dir not in existing_parents: + ensure_dir(parent_dir) + existing_parents.add(parent_dir) + file.save() + record_installed(file.src_record_path, file.dest_path, file.changed) + + def pyc_source_file_paths() -> Generator[str, None, None]: + # We de-duplicate installation paths, since there can be overlap (e.g. + # file in .data maps to same location as file in wheel root). + # Sorting installation paths makes it easier to reproduce and debug + # issues related to permissions on existing files. + for installed_path in sorted(set(installed.values())): + full_installed_path = os.path.join(lib_dir, installed_path) + if not os.path.isfile(full_installed_path): + continue + if not full_installed_path.endswith(".py"): + continue + yield full_installed_path + + def pyc_output_path(path: str) -> str: + """Return the path the pyc file would have been written to.""" + return importlib.util.cache_from_source(path) + + # Compile all of the pyc files for the installed files + if pycompile: + with contextlib.redirect_stdout( + StreamWrapper.from_stream(sys.stdout) + ) as stdout: + with warnings.catch_warnings(): + warnings.filterwarnings("ignore") + for path in pyc_source_file_paths(): + success = compileall.compile_file(path, force=True, quiet=True) + if success: + pyc_path = pyc_output_path(path) + assert os.path.exists(pyc_path) + pyc_record_path = cast( + "RecordPath", pyc_path.replace(os.path.sep, "/") + ) + record_installed(pyc_record_path, pyc_path) + logger.debug(stdout.getvalue()) + + maker = PipScriptMaker(None, scheme.scripts) + + # Ensure old scripts are overwritten. + # See https://github.com/pypa/pip/issues/1800 + maker.clobber = True + + # Ensure we don't generate any variants for scripts because this is almost + # never what somebody wants. + # See https://bitbucket.org/pypa/distlib/issue/35/ + maker.variants = {""} + + # This is required because otherwise distlib creates scripts that are not + # executable. + # See https://bitbucket.org/pypa/distlib/issue/32/ + maker.set_mode = True + + # Generate the console and GUI entry points specified in the wheel + scripts_to_generate = get_console_script_specs(console) + + gui_scripts_to_generate = list(starmap("{} = {}".format, gui.items())) + + generated_console_scripts = maker.make_multiple(scripts_to_generate) + generated.extend(generated_console_scripts) + + generated.extend(maker.make_multiple(gui_scripts_to_generate, {"gui": True})) + + if warn_script_location: + msg = message_about_scripts_not_on_PATH(generated_console_scripts) + if msg is not None: + logger.warning(msg) + + generated_file_mode = 0o666 & ~current_umask() + + @contextlib.contextmanager + def _generate_file(path: str, **kwargs: Any) -> Generator[BinaryIO, None, None]: + with adjacent_tmp_file(path, **kwargs) as f: + yield f + os.chmod(f.name, generated_file_mode) + replace(f.name, path) + + dest_info_dir = os.path.join(lib_dir, info_dir) + + # Record pip as the installer + installer_path = os.path.join(dest_info_dir, "INSTALLER") + with _generate_file(installer_path) as installer_file: + installer_file.write(b"pip\n") + generated.append(installer_path) + + # Record the PEP 610 direct URL reference + if direct_url is not None: + direct_url_path = os.path.join(dest_info_dir, DIRECT_URL_METADATA_NAME) + with _generate_file(direct_url_path) as direct_url_file: + direct_url_file.write(direct_url.to_json().encode("utf-8")) + generated.append(direct_url_path) + + # Record the REQUESTED file + if requested: + requested_path = os.path.join(dest_info_dir, "REQUESTED") + with open(requested_path, "wb"): + pass + generated.append(requested_path) + + record_text = distribution.read_text("RECORD") + record_rows = list(csv.reader(record_text.splitlines())) + + rows = get_csv_rows_for_installed( + record_rows, + installed=installed, + changed=changed, + generated=generated, + lib_dir=lib_dir, + ) + + # Record details of all files installed + record_path = os.path.join(dest_info_dir, "RECORD") + + with _generate_file(record_path, **csv_io_kwargs("w")) as record_file: + # Explicitly cast to typing.IO[str] as a workaround for the mypy error: + # "writer" has incompatible type "BinaryIO"; expected "_Writer" + writer = csv.writer(cast("IO[str]", record_file)) + writer.writerows(_normalized_outrows(rows)) + + +@contextlib.contextmanager +def req_error_context(req_description: str) -> Generator[None, None, None]: + try: + yield + except InstallationError as e: + message = f"For req: {req_description}. {e.args[0]}" + raise InstallationError(message) from e + + +def install_wheel( + name: str, + wheel_path: str, + scheme: Scheme, + req_description: str, + pycompile: bool = True, + warn_script_location: bool = True, + direct_url: Optional[DirectUrl] = None, + requested: bool = False, +) -> None: + with ZipFile(wheel_path, allowZip64=True) as z: + with req_error_context(req_description): + _install_wheel( + name=name, + wheel_zip=z, + wheel_path=wheel_path, + scheme=scheme, + pycompile=pycompile, + warn_script_location=warn_script_location, + direct_url=direct_url, + requested=requested, + ) diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/operations/prepare.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/operations/prepare.py new file mode 100644 index 0000000..e6aa344 --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/operations/prepare.py @@ -0,0 +1,732 @@ +"""Prepares a distribution for installation +""" + +# The following comment should be removed at some point in the future. +# mypy: strict-optional=False + +import mimetypes +import os +import shutil +from dataclasses import dataclass +from pathlib import Path +from typing import Dict, Iterable, List, Optional + +from pip._vendor.packaging.utils import canonicalize_name + +from pip._internal.distributions import make_distribution_for_install_requirement +from pip._internal.distributions.installed import InstalledDistribution +from pip._internal.exceptions import ( + DirectoryUrlHashUnsupported, + HashMismatch, + HashUnpinned, + InstallationError, + MetadataInconsistent, + NetworkConnectionError, + VcsHashUnsupported, +) +from pip._internal.index.package_finder import PackageFinder +from pip._internal.metadata import BaseDistribution, get_metadata_distribution +from pip._internal.models.direct_url import ArchiveInfo +from pip._internal.models.link import Link +from pip._internal.models.wheel import Wheel +from pip._internal.network.download import BatchDownloader, Downloader +from pip._internal.network.lazy_wheel import ( + HTTPRangeRequestUnsupported, + dist_from_wheel_url, +) +from pip._internal.network.session import PipSession +from pip._internal.operations.build.build_tracker import BuildTracker +from pip._internal.req.req_install import InstallRequirement +from pip._internal.utils._log import getLogger +from pip._internal.utils.direct_url_helpers import ( + direct_url_for_editable, + direct_url_from_link, +) +from pip._internal.utils.hashes import Hashes, MissingHashes +from pip._internal.utils.logging import indent_log +from pip._internal.utils.misc import ( + display_path, + hash_file, + hide_url, + redact_auth_from_requirement, +) +from pip._internal.utils.temp_dir import TempDirectory +from pip._internal.utils.unpacking import unpack_file +from pip._internal.vcs import vcs + +logger = getLogger(__name__) + + +def _get_prepared_distribution( + req: InstallRequirement, + build_tracker: BuildTracker, + finder: PackageFinder, + build_isolation: bool, + check_build_deps: bool, +) -> BaseDistribution: + """Prepare a distribution for installation.""" + abstract_dist = make_distribution_for_install_requirement(req) + tracker_id = abstract_dist.build_tracker_id + if tracker_id is not None: + with build_tracker.track(req, tracker_id): + abstract_dist.prepare_distribution_metadata( + finder, build_isolation, check_build_deps + ) + return abstract_dist.get_metadata_distribution() + + +def unpack_vcs_link(link: Link, location: str, verbosity: int) -> None: + vcs_backend = vcs.get_backend_for_scheme(link.scheme) + assert vcs_backend is not None + vcs_backend.unpack(location, url=hide_url(link.url), verbosity=verbosity) + + +@dataclass +class File: + path: str + content_type: Optional[str] = None + + def __post_init__(self) -> None: + if self.content_type is None: + self.content_type = mimetypes.guess_type(self.path)[0] + + +def get_http_url( + link: Link, + download: Downloader, + download_dir: Optional[str] = None, + hashes: Optional[Hashes] = None, +) -> File: + temp_dir = TempDirectory(kind="unpack", globally_managed=True) + # If a download dir is specified, is the file already downloaded there? + already_downloaded_path = None + if download_dir: + already_downloaded_path = _check_download_dir(link, download_dir, hashes) + + if already_downloaded_path: + from_path = already_downloaded_path + content_type = None + else: + # let's download to a tmp dir + from_path, content_type = download(link, temp_dir.path) + if hashes: + hashes.check_against_path(from_path) + + return File(from_path, content_type) + + +def get_file_url( + link: Link, download_dir: Optional[str] = None, hashes: Optional[Hashes] = None +) -> File: + """Get file and optionally check its hash.""" + # If a download dir is specified, is the file already there and valid? + already_downloaded_path = None + if download_dir: + already_downloaded_path = _check_download_dir(link, download_dir, hashes) + + if already_downloaded_path: + from_path = already_downloaded_path + else: + from_path = link.file_path + + # If --require-hashes is off, `hashes` is either empty, the + # link's embedded hash, or MissingHashes; it is required to + # match. If --require-hashes is on, we are satisfied by any + # hash in `hashes` matching: a URL-based or an option-based + # one; no internet-sourced hash will be in `hashes`. + if hashes: + hashes.check_against_path(from_path) + return File(from_path, None) + + +def unpack_url( + link: Link, + location: str, + download: Downloader, + verbosity: int, + download_dir: Optional[str] = None, + hashes: Optional[Hashes] = None, +) -> Optional[File]: + """Unpack link into location, downloading if required. + + :param hashes: A Hashes object, one of whose embedded hashes must match, + or HashMismatch will be raised. If the Hashes is empty, no matches are + required, and unhashable types of requirements (like VCS ones, which + would ordinarily raise HashUnsupported) are allowed. + """ + # non-editable vcs urls + if link.is_vcs: + unpack_vcs_link(link, location, verbosity=verbosity) + return None + + assert not link.is_existing_dir() + + # file urls + if link.is_file: + file = get_file_url(link, download_dir, hashes=hashes) + + # http urls + else: + file = get_http_url( + link, + download, + download_dir, + hashes=hashes, + ) + + # unpack the archive to the build dir location. even when only downloading + # archives, they have to be unpacked to parse dependencies, except wheels + if not link.is_wheel: + unpack_file(file.path, location, file.content_type) + + return file + + +def _check_download_dir( + link: Link, + download_dir: str, + hashes: Optional[Hashes], + warn_on_hash_mismatch: bool = True, +) -> Optional[str]: + """Check download_dir for previously downloaded file with correct hash + If a correct file is found return its path else None + """ + download_path = os.path.join(download_dir, link.filename) + + if not os.path.exists(download_path): + return None + + # If already downloaded, does its hash match? + logger.info("File was already downloaded %s", download_path) + if hashes: + try: + hashes.check_against_path(download_path) + except HashMismatch: + if warn_on_hash_mismatch: + logger.warning( + "Previously-downloaded file %s has bad hash. Re-downloading.", + download_path, + ) + os.unlink(download_path) + return None + return download_path + + +class RequirementPreparer: + """Prepares a Requirement""" + + def __init__( + self, + build_dir: str, + download_dir: Optional[str], + src_dir: str, + build_isolation: bool, + check_build_deps: bool, + build_tracker: BuildTracker, + session: PipSession, + progress_bar: str, + finder: PackageFinder, + require_hashes: bool, + use_user_site: bool, + lazy_wheel: bool, + verbosity: int, + legacy_resolver: bool, + ) -> None: + super().__init__() + + self.src_dir = src_dir + self.build_dir = build_dir + self.build_tracker = build_tracker + self._session = session + self._download = Downloader(session, progress_bar) + self._batch_download = BatchDownloader(session, progress_bar) + self.finder = finder + + # Where still-packed archives should be written to. If None, they are + # not saved, and are deleted immediately after unpacking. + self.download_dir = download_dir + + # Is build isolation allowed? + self.build_isolation = build_isolation + + # Should check build dependencies? + self.check_build_deps = check_build_deps + + # Should hash-checking be required? + self.require_hashes = require_hashes + + # Should install in user site-packages? + self.use_user_site = use_user_site + + # Should wheels be downloaded lazily? + self.use_lazy_wheel = lazy_wheel + + # How verbose should underlying tooling be? + self.verbosity = verbosity + + # Are we using the legacy resolver? + self.legacy_resolver = legacy_resolver + + # Memoized downloaded files, as mapping of url: path. + self._downloaded: Dict[str, str] = {} + + # Previous "header" printed for a link-based InstallRequirement + self._previous_requirement_header = ("", "") + + def _log_preparing_link(self, req: InstallRequirement) -> None: + """Provide context for the requirement being prepared.""" + if req.link.is_file and not req.is_wheel_from_cache: + message = "Processing %s" + information = str(display_path(req.link.file_path)) + else: + message = "Collecting %s" + information = redact_auth_from_requirement(req.req) if req.req else str(req) + + # If we used req.req, inject requirement source if available (this + # would already be included if we used req directly) + if req.req and req.comes_from: + if isinstance(req.comes_from, str): + comes_from: Optional[str] = req.comes_from + else: + comes_from = req.comes_from.from_path() + if comes_from: + information += f" (from {comes_from})" + + if (message, information) != self._previous_requirement_header: + self._previous_requirement_header = (message, information) + logger.info(message, information) + + if req.is_wheel_from_cache: + with indent_log(): + logger.info("Using cached %s", req.link.filename) + + def _ensure_link_req_src_dir( + self, req: InstallRequirement, parallel_builds: bool + ) -> None: + """Ensure source_dir of a linked InstallRequirement.""" + # Since source_dir is only set for editable requirements. + if req.link.is_wheel: + # We don't need to unpack wheels, so no need for a source + # directory. + return + assert req.source_dir is None + if req.link.is_existing_dir(): + # build local directories in-tree + req.source_dir = req.link.file_path + return + + # We always delete unpacked sdists after pip runs. + req.ensure_has_source_dir( + self.build_dir, + autodelete=True, + parallel_builds=parallel_builds, + ) + req.ensure_pristine_source_checkout() + + def _get_linked_req_hashes(self, req: InstallRequirement) -> Hashes: + # By the time this is called, the requirement's link should have + # been checked so we can tell what kind of requirements req is + # and raise some more informative errors than otherwise. + # (For example, we can raise VcsHashUnsupported for a VCS URL + # rather than HashMissing.) + if not self.require_hashes: + return req.hashes(trust_internet=True) + + # We could check these first 2 conditions inside unpack_url + # and save repetition of conditions, but then we would + # report less-useful error messages for unhashable + # requirements, complaining that there's no hash provided. + if req.link.is_vcs: + raise VcsHashUnsupported() + if req.link.is_existing_dir(): + raise DirectoryUrlHashUnsupported() + + # Unpinned packages are asking for trouble when a new version + # is uploaded. This isn't a security check, but it saves users + # a surprising hash mismatch in the future. + # file:/// URLs aren't pinnable, so don't complain about them + # not being pinned. + if not req.is_direct and not req.is_pinned: + raise HashUnpinned() + + # If known-good hashes are missing for this requirement, + # shim it with a facade object that will provoke hash + # computation and then raise a HashMissing exception + # showing the user what the hash should be. + return req.hashes(trust_internet=False) or MissingHashes() + + def _fetch_metadata_only( + self, + req: InstallRequirement, + ) -> Optional[BaseDistribution]: + if self.legacy_resolver: + logger.debug( + "Metadata-only fetching is not used in the legacy resolver", + ) + return None + if self.require_hashes: + logger.debug( + "Metadata-only fetching is not used as hash checking is required", + ) + return None + # Try PEP 658 metadata first, then fall back to lazy wheel if unavailable. + return self._fetch_metadata_using_link_data_attr( + req + ) or self._fetch_metadata_using_lazy_wheel(req.link) + + def _fetch_metadata_using_link_data_attr( + self, + req: InstallRequirement, + ) -> Optional[BaseDistribution]: + """Fetch metadata from the data-dist-info-metadata attribute, if possible.""" + # (1) Get the link to the metadata file, if provided by the backend. + metadata_link = req.link.metadata_link() + if metadata_link is None: + return None + assert req.req is not None + logger.verbose( + "Obtaining dependency information for %s from %s", + req.req, + metadata_link, + ) + # (2) Download the contents of the METADATA file, separate from the dist itself. + metadata_file = get_http_url( + metadata_link, + self._download, + hashes=metadata_link.as_hashes(), + ) + with open(metadata_file.path, "rb") as f: + metadata_contents = f.read() + # (3) Generate a dist just from those file contents. + metadata_dist = get_metadata_distribution( + metadata_contents, + req.link.filename, + req.req.name, + ) + # (4) Ensure the Name: field from the METADATA file matches the name from the + # install requirement. + # + # NB: raw_name will fall back to the name from the install requirement if + # the Name: field is not present, but it's noted in the raw_name docstring + # that that should NEVER happen anyway. + if canonicalize_name(metadata_dist.raw_name) != canonicalize_name(req.req.name): + raise MetadataInconsistent( + req, "Name", req.req.name, metadata_dist.raw_name + ) + return metadata_dist + + def _fetch_metadata_using_lazy_wheel( + self, + link: Link, + ) -> Optional[BaseDistribution]: + """Fetch metadata using lazy wheel, if possible.""" + # --use-feature=fast-deps must be provided. + if not self.use_lazy_wheel: + return None + if link.is_file or not link.is_wheel: + logger.debug( + "Lazy wheel is not used as %r does not point to a remote wheel", + link, + ) + return None + + wheel = Wheel(link.filename) + name = canonicalize_name(wheel.name) + logger.info( + "Obtaining dependency information from %s %s", + name, + wheel.version, + ) + url = link.url.split("#", 1)[0] + try: + return dist_from_wheel_url(name, url, self._session) + except HTTPRangeRequestUnsupported: + logger.debug("%s does not support range requests", url) + return None + + def _complete_partial_requirements( + self, + partially_downloaded_reqs: Iterable[InstallRequirement], + parallel_builds: bool = False, + ) -> None: + """Download any requirements which were only fetched by metadata.""" + # Download to a temporary directory. These will be copied over as + # needed for downstream 'download', 'wheel', and 'install' commands. + temp_dir = TempDirectory(kind="unpack", globally_managed=True).path + + # Map each link to the requirement that owns it. This allows us to set + # `req.local_file_path` on the appropriate requirement after passing + # all the links at once into BatchDownloader. + links_to_fully_download: Dict[Link, InstallRequirement] = {} + for req in partially_downloaded_reqs: + assert req.link + links_to_fully_download[req.link] = req + + batch_download = self._batch_download( + links_to_fully_download.keys(), + temp_dir, + ) + for link, (filepath, _) in batch_download: + logger.debug("Downloading link %s to %s", link, filepath) + req = links_to_fully_download[link] + # Record the downloaded file path so wheel reqs can extract a Distribution + # in .get_dist(). + req.local_file_path = filepath + # Record that the file is downloaded so we don't do it again in + # _prepare_linked_requirement(). + self._downloaded[req.link.url] = filepath + + # If this is an sdist, we need to unpack it after downloading, but the + # .source_dir won't be set up until we are in _prepare_linked_requirement(). + # Add the downloaded archive to the install requirement to unpack after + # preparing the source dir. + if not req.is_wheel: + req.needs_unpacked_archive(Path(filepath)) + + # This step is necessary to ensure all lazy wheels are processed + # successfully by the 'download', 'wheel', and 'install' commands. + for req in partially_downloaded_reqs: + self._prepare_linked_requirement(req, parallel_builds) + + def prepare_linked_requirement( + self, req: InstallRequirement, parallel_builds: bool = False + ) -> BaseDistribution: + """Prepare a requirement to be obtained from req.link.""" + assert req.link + self._log_preparing_link(req) + with indent_log(): + # Check if the relevant file is already available + # in the download directory + file_path = None + if self.download_dir is not None and req.link.is_wheel: + hashes = self._get_linked_req_hashes(req) + file_path = _check_download_dir( + req.link, + self.download_dir, + hashes, + # When a locally built wheel has been found in cache, we don't warn + # about re-downloading when the already downloaded wheel hash does + # not match. This is because the hash must be checked against the + # original link, not the cached link. It that case the already + # downloaded file will be removed and re-fetched from cache (which + # implies a hash check against the cache entry's origin.json). + warn_on_hash_mismatch=not req.is_wheel_from_cache, + ) + + if file_path is not None: + # The file is already available, so mark it as downloaded + self._downloaded[req.link.url] = file_path + else: + # The file is not available, attempt to fetch only metadata + metadata_dist = self._fetch_metadata_only(req) + if metadata_dist is not None: + req.needs_more_preparation = True + return metadata_dist + + # None of the optimizations worked, fully prepare the requirement + return self._prepare_linked_requirement(req, parallel_builds) + + def prepare_linked_requirements_more( + self, reqs: Iterable[InstallRequirement], parallel_builds: bool = False + ) -> None: + """Prepare linked requirements more, if needed.""" + reqs = [req for req in reqs if req.needs_more_preparation] + for req in reqs: + # Determine if any of these requirements were already downloaded. + if self.download_dir is not None and req.link.is_wheel: + hashes = self._get_linked_req_hashes(req) + file_path = _check_download_dir(req.link, self.download_dir, hashes) + if file_path is not None: + self._downloaded[req.link.url] = file_path + req.needs_more_preparation = False + + # Prepare requirements we found were already downloaded for some + # reason. The other downloads will be completed separately. + partially_downloaded_reqs: List[InstallRequirement] = [] + for req in reqs: + if req.needs_more_preparation: + partially_downloaded_reqs.append(req) + else: + self._prepare_linked_requirement(req, parallel_builds) + + # TODO: separate this part out from RequirementPreparer when the v1 + # resolver can be removed! + self._complete_partial_requirements( + partially_downloaded_reqs, + parallel_builds=parallel_builds, + ) + + def _prepare_linked_requirement( + self, req: InstallRequirement, parallel_builds: bool + ) -> BaseDistribution: + assert req.link + link = req.link + + hashes = self._get_linked_req_hashes(req) + + if hashes and req.is_wheel_from_cache: + assert req.download_info is not None + assert link.is_wheel + assert link.is_file + # We need to verify hashes, and we have found the requirement in the cache + # of locally built wheels. + if ( + isinstance(req.download_info.info, ArchiveInfo) + and req.download_info.info.hashes + and hashes.has_one_of(req.download_info.info.hashes) + ): + # At this point we know the requirement was built from a hashable source + # artifact, and we verified that the cache entry's hash of the original + # artifact matches one of the hashes we expect. We don't verify hashes + # against the cached wheel, because the wheel is not the original. + hashes = None + else: + logger.warning( + "The hashes of the source archive found in cache entry " + "don't match, ignoring cached built wheel " + "and re-downloading source." + ) + req.link = req.cached_wheel_source_link + link = req.link + + self._ensure_link_req_src_dir(req, parallel_builds) + + if link.is_existing_dir(): + local_file = None + elif link.url not in self._downloaded: + try: + local_file = unpack_url( + link, + req.source_dir, + self._download, + self.verbosity, + self.download_dir, + hashes, + ) + except NetworkConnectionError as exc: + raise InstallationError( + f"Could not install requirement {req} because of HTTP " + f"error {exc} for URL {link}" + ) + else: + file_path = self._downloaded[link.url] + if hashes: + hashes.check_against_path(file_path) + local_file = File(file_path, content_type=None) + + # If download_info is set, we got it from the wheel cache. + if req.download_info is None: + # Editables don't go through this function (see + # prepare_editable_requirement). + assert not req.editable + req.download_info = direct_url_from_link(link, req.source_dir) + # Make sure we have a hash in download_info. If we got it as part of the + # URL, it will have been verified and we can rely on it. Otherwise we + # compute it from the downloaded file. + # FIXME: https://github.com/pypa/pip/issues/11943 + if ( + isinstance(req.download_info.info, ArchiveInfo) + and not req.download_info.info.hashes + and local_file + ): + hash = hash_file(local_file.path)[0].hexdigest() + # We populate info.hash for backward compatibility. + # This will automatically populate info.hashes. + req.download_info.info.hash = f"sha256={hash}" + + # For use in later processing, + # preserve the file path on the requirement. + if local_file: + req.local_file_path = local_file.path + + dist = _get_prepared_distribution( + req, + self.build_tracker, + self.finder, + self.build_isolation, + self.check_build_deps, + ) + return dist + + def save_linked_requirement(self, req: InstallRequirement) -> None: + assert self.download_dir is not None + assert req.link is not None + link = req.link + if link.is_vcs or (link.is_existing_dir() and req.editable): + # Make a .zip of the source_dir we already created. + req.archive(self.download_dir) + return + + if link.is_existing_dir(): + logger.debug( + "Not copying link to destination directory " + "since it is a directory: %s", + link, + ) + return + if req.local_file_path is None: + # No distribution was downloaded for this requirement. + return + + download_location = os.path.join(self.download_dir, link.filename) + if not os.path.exists(download_location): + shutil.copy(req.local_file_path, download_location) + download_path = display_path(download_location) + logger.info("Saved %s", download_path) + + def prepare_editable_requirement( + self, + req: InstallRequirement, + ) -> BaseDistribution: + """Prepare an editable requirement.""" + assert req.editable, "cannot prepare a non-editable req as editable" + + logger.info("Obtaining %s", req) + + with indent_log(): + if self.require_hashes: + raise InstallationError( + f"The editable requirement {req} cannot be installed when " + "requiring hashes, because there is no single file to " + "hash." + ) + req.ensure_has_source_dir(self.src_dir) + req.update_editable() + assert req.source_dir + req.download_info = direct_url_for_editable(req.unpacked_source_directory) + + dist = _get_prepared_distribution( + req, + self.build_tracker, + self.finder, + self.build_isolation, + self.check_build_deps, + ) + + req.check_if_exists(self.use_user_site) + + return dist + + def prepare_installed_requirement( + self, + req: InstallRequirement, + skip_reason: str, + ) -> BaseDistribution: + """Prepare an already-installed requirement.""" + assert req.satisfied_by, "req should have been satisfied but isn't" + assert skip_reason is not None, ( + "did not get skip reason skipped but req.satisfied_by " + f"is set to {req.satisfied_by}" + ) + logger.info( + "Requirement %s: %s (%s)", skip_reason, req, req.satisfied_by.version + ) + with indent_log(): + if self.require_hashes: + logger.debug( + "Since it is already installed, we are trusting this " + "package without checking its hash. To ensure a " + "completely repeatable environment, install into an " + "empty virtualenv." + ) + return InstalledDistribution(req).get_metadata_distribution() diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/pyproject.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/pyproject.py new file mode 100644 index 0000000..0e8452f --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/pyproject.py @@ -0,0 +1,185 @@ +import importlib.util +import os +import sys +from collections import namedtuple +from typing import Any, List, Optional + +if sys.version_info >= (3, 11): + import tomllib +else: + from pip._vendor import tomli as tomllib + +from pip._vendor.packaging.requirements import InvalidRequirement + +from pip._internal.exceptions import ( + InstallationError, + InvalidPyProjectBuildRequires, + MissingPyProjectBuildRequires, +) +from pip._internal.utils.packaging import get_requirement + + +def _is_list_of_str(obj: Any) -> bool: + return isinstance(obj, list) and all(isinstance(item, str) for item in obj) + + +def make_pyproject_path(unpacked_source_directory: str) -> str: + return os.path.join(unpacked_source_directory, "pyproject.toml") + + +BuildSystemDetails = namedtuple( + "BuildSystemDetails", ["requires", "backend", "check", "backend_path"] +) + + +def load_pyproject_toml( + use_pep517: Optional[bool], pyproject_toml: str, setup_py: str, req_name: str +) -> Optional[BuildSystemDetails]: + """Load the pyproject.toml file. + + Parameters: + use_pep517 - Has the user requested PEP 517 processing? None + means the user hasn't explicitly specified. + pyproject_toml - Location of the project's pyproject.toml file + setup_py - Location of the project's setup.py file + req_name - The name of the requirement we're processing (for + error reporting) + + Returns: + None if we should use the legacy code path, otherwise a tuple + ( + requirements from pyproject.toml, + name of PEP 517 backend, + requirements we should check are installed after setting + up the build environment + directory paths to import the backend from (backend-path), + relative to the project root. + ) + """ + has_pyproject = os.path.isfile(pyproject_toml) + has_setup = os.path.isfile(setup_py) + + if not has_pyproject and not has_setup: + raise InstallationError( + f"{req_name} does not appear to be a Python project: " + f"neither 'setup.py' nor 'pyproject.toml' found." + ) + + if has_pyproject: + with open(pyproject_toml, encoding="utf-8") as f: + pp_toml = tomllib.loads(f.read()) + build_system = pp_toml.get("build-system") + else: + build_system = None + + # The following cases must use PEP 517 + # We check for use_pep517 being non-None and falsy because that means + # the user explicitly requested --no-use-pep517. The value 0 as + # opposed to False can occur when the value is provided via an + # environment variable or config file option (due to the quirk of + # strtobool() returning an integer in pip's configuration code). + if has_pyproject and not has_setup: + if use_pep517 is not None and not use_pep517: + raise InstallationError( + "Disabling PEP 517 processing is invalid: " + "project does not have a setup.py" + ) + use_pep517 = True + elif build_system and "build-backend" in build_system: + if use_pep517 is not None and not use_pep517: + raise InstallationError( + "Disabling PEP 517 processing is invalid: " + "project specifies a build backend of {} " + "in pyproject.toml".format(build_system["build-backend"]) + ) + use_pep517 = True + + # If we haven't worked out whether to use PEP 517 yet, + # and the user hasn't explicitly stated a preference, + # we do so if the project has a pyproject.toml file + # or if we cannot import setuptools or wheels. + + # We fallback to PEP 517 when without setuptools or without the wheel package, + # so setuptools can be installed as a default build backend. + # For more info see: + # https://discuss.python.org/t/pip-without-setuptools-could-the-experience-be-improved/11810/9 + # https://github.com/pypa/pip/issues/8559 + elif use_pep517 is None: + use_pep517 = ( + has_pyproject + or not importlib.util.find_spec("setuptools") + or not importlib.util.find_spec("wheel") + ) + + # At this point, we know whether we're going to use PEP 517. + assert use_pep517 is not None + + # If we're using the legacy code path, there is nothing further + # for us to do here. + if not use_pep517: + return None + + if build_system is None: + # Either the user has a pyproject.toml with no build-system + # section, or the user has no pyproject.toml, but has opted in + # explicitly via --use-pep517. + # In the absence of any explicit backend specification, we + # assume the setuptools backend that most closely emulates the + # traditional direct setup.py execution, and require wheel and + # a version of setuptools that supports that backend. + + build_system = { + "requires": ["setuptools>=40.8.0"], + "build-backend": "setuptools.build_meta:__legacy__", + } + + # If we're using PEP 517, we have build system information (either + # from pyproject.toml, or defaulted by the code above). + # Note that at this point, we do not know if the user has actually + # specified a backend, though. + assert build_system is not None + + # Ensure that the build-system section in pyproject.toml conforms + # to PEP 518. + + # Specifying the build-system table but not the requires key is invalid + if "requires" not in build_system: + raise MissingPyProjectBuildRequires(package=req_name) + + # Error out if requires is not a list of strings + requires = build_system["requires"] + if not _is_list_of_str(requires): + raise InvalidPyProjectBuildRequires( + package=req_name, + reason="It is not a list of strings.", + ) + + # Each requirement must be valid as per PEP 508 + for requirement in requires: + try: + get_requirement(requirement) + except InvalidRequirement as error: + raise InvalidPyProjectBuildRequires( + package=req_name, + reason=f"It contains an invalid requirement: {requirement!r}", + ) from error + + backend = build_system.get("build-backend") + backend_path = build_system.get("backend-path", []) + check: List[str] = [] + if backend is None: + # If the user didn't specify a backend, we assume they want to use + # the setuptools backend. But we can't be sure they have included + # a version of setuptools which supplies the backend. So we + # make a note to check that this requirement is present once + # we have set up the environment. + # This is quite a lot of work to check for a very specific case. But + # the problem is, that case is potentially quite common - projects that + # adopted PEP 518 early for the ability to specify requirements to + # execute setup.py, but never considered needing to mention the build + # tools themselves. The original PEP 518 code had a similar check (but + # implemented in a different way). + backend = "setuptools.build_meta:__legacy__" + check = ["setuptools>=40.8.0"] + + return BuildSystemDetails(requires, backend, check, backend_path) diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/req/__init__.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/req/__init__.py new file mode 100644 index 0000000..422d851 --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/req/__init__.py @@ -0,0 +1,90 @@ +import collections +import logging +from dataclasses import dataclass +from typing import Generator, List, Optional, Sequence, Tuple + +from pip._internal.utils.logging import indent_log + +from .req_file import parse_requirements +from .req_install import InstallRequirement +from .req_set import RequirementSet + +__all__ = [ + "RequirementSet", + "InstallRequirement", + "parse_requirements", + "install_given_reqs", +] + +logger = logging.getLogger(__name__) + + +@dataclass(frozen=True) +class InstallationResult: + name: str + + +def _validate_requirements( + requirements: List[InstallRequirement], +) -> Generator[Tuple[str, InstallRequirement], None, None]: + for req in requirements: + assert req.name, f"invalid to-be-installed requirement: {req}" + yield req.name, req + + +def install_given_reqs( + requirements: List[InstallRequirement], + global_options: Sequence[str], + root: Optional[str], + home: Optional[str], + prefix: Optional[str], + warn_script_location: bool, + use_user_site: bool, + pycompile: bool, +) -> List[InstallationResult]: + """ + Install everything in the given list. + + (to be called after having downloaded and unpacked the packages) + """ + to_install = collections.OrderedDict(_validate_requirements(requirements)) + + if to_install: + logger.info( + "Installing collected packages: %s", + ", ".join(to_install.keys()), + ) + + installed = [] + + with indent_log(): + for req_name, requirement in to_install.items(): + if requirement.should_reinstall: + logger.info("Attempting uninstall: %s", req_name) + with indent_log(): + uninstalled_pathset = requirement.uninstall(auto_confirm=True) + else: + uninstalled_pathset = None + + try: + requirement.install( + global_options, + root=root, + home=home, + prefix=prefix, + warn_script_location=warn_script_location, + use_user_site=use_user_site, + pycompile=pycompile, + ) + except Exception: + # if install did not succeed, rollback previous uninstall + if uninstalled_pathset and not requirement.install_succeeded: + uninstalled_pathset.rollback() + raise + else: + if uninstalled_pathset and requirement.install_succeeded: + uninstalled_pathset.commit() + + installed.append(InstallationResult(req_name)) + + return installed diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/req/__pycache__/__init__.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/req/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000..cdca72d Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/req/__pycache__/__init__.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/req/__pycache__/constructors.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/req/__pycache__/constructors.cpython-312.pyc new file mode 100644 index 0000000..e86afb1 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/req/__pycache__/constructors.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/req/__pycache__/req_file.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/req/__pycache__/req_file.cpython-312.pyc new file mode 100644 index 0000000..5af6771 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/req/__pycache__/req_file.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/req/__pycache__/req_install.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/req/__pycache__/req_install.cpython-312.pyc new file mode 100644 index 0000000..a21d8f1 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/req/__pycache__/req_install.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/req/__pycache__/req_set.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/req/__pycache__/req_set.cpython-312.pyc new file mode 100644 index 0000000..34fb752 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/req/__pycache__/req_set.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/req/__pycache__/req_uninstall.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/req/__pycache__/req_uninstall.cpython-312.pyc new file mode 100644 index 0000000..90c6bc1 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/req/__pycache__/req_uninstall.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/req/constructors.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/req/constructors.py new file mode 100644 index 0000000..56a964f --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/req/constructors.py @@ -0,0 +1,560 @@ +"""Backing implementation for InstallRequirement's various constructors + +The idea here is that these formed a major chunk of InstallRequirement's size +so, moving them and support code dedicated to them outside of that class +helps creates for better understandability for the rest of the code. + +These are meant to be used elsewhere within pip to create instances of +InstallRequirement. +""" + +import copy +import logging +import os +import re +from dataclasses import dataclass +from typing import Collection, Dict, List, Optional, Set, Tuple, Union + +from pip._vendor.packaging.markers import Marker +from pip._vendor.packaging.requirements import InvalidRequirement, Requirement +from pip._vendor.packaging.specifiers import Specifier + +from pip._internal.exceptions import InstallationError +from pip._internal.models.index import PyPI, TestPyPI +from pip._internal.models.link import Link +from pip._internal.models.wheel import Wheel +from pip._internal.req.req_file import ParsedRequirement +from pip._internal.req.req_install import InstallRequirement +from pip._internal.utils.filetypes import is_archive_file +from pip._internal.utils.misc import is_installable_dir +from pip._internal.utils.packaging import get_requirement +from pip._internal.utils.urls import path_to_url +from pip._internal.vcs import is_url, vcs + +__all__ = [ + "install_req_from_editable", + "install_req_from_line", + "parse_editable", +] + +logger = logging.getLogger(__name__) +operators = Specifier._operators.keys() + + +def _strip_extras(path: str) -> Tuple[str, Optional[str]]: + m = re.match(r"^(.+)(\[[^\]]+\])$", path) + extras = None + if m: + path_no_extras = m.group(1) + extras = m.group(2) + else: + path_no_extras = path + + return path_no_extras, extras + + +def convert_extras(extras: Optional[str]) -> Set[str]: + if not extras: + return set() + return get_requirement("placeholder" + extras.lower()).extras + + +def _set_requirement_extras(req: Requirement, new_extras: Set[str]) -> Requirement: + """ + Returns a new requirement based on the given one, with the supplied extras. If the + given requirement already has extras those are replaced (or dropped if no new extras + are given). + """ + match: Optional[re.Match[str]] = re.fullmatch( + # see https://peps.python.org/pep-0508/#complete-grammar + r"([\w\t .-]+)(\[[^\]]*\])?(.*)", + str(req), + flags=re.ASCII, + ) + # ireq.req is a valid requirement so the regex should always match + assert ( + match is not None + ), f"regex match on requirement {req} failed, this should never happen" + pre: Optional[str] = match.group(1) + post: Optional[str] = match.group(3) + assert ( + pre is not None and post is not None + ), f"regex group selection for requirement {req} failed, this should never happen" + extras: str = "[{}]".format(",".join(sorted(new_extras)) if new_extras else "") + return get_requirement(f"{pre}{extras}{post}") + + +def parse_editable(editable_req: str) -> Tuple[Optional[str], str, Set[str]]: + """Parses an editable requirement into: + - a requirement name + - an URL + - extras + - editable options + Accepted requirements: + svn+http://blahblah@rev#egg=Foobar[baz]&subdirectory=version_subdir + .[some_extra] + """ + + url = editable_req + + # If a file path is specified with extras, strip off the extras. + url_no_extras, extras = _strip_extras(url) + + if os.path.isdir(url_no_extras): + # Treating it as code that has already been checked out + url_no_extras = path_to_url(url_no_extras) + + if url_no_extras.lower().startswith("file:"): + package_name = Link(url_no_extras).egg_fragment + if extras: + return ( + package_name, + url_no_extras, + get_requirement("placeholder" + extras.lower()).extras, + ) + else: + return package_name, url_no_extras, set() + + for version_control in vcs: + if url.lower().startswith(f"{version_control}:"): + url = f"{version_control}+{url}" + break + + link = Link(url) + + if not link.is_vcs: + backends = ", ".join(vcs.all_schemes) + raise InstallationError( + f"{editable_req} is not a valid editable requirement. " + f"It should either be a path to a local project or a VCS URL " + f"(beginning with {backends})." + ) + + package_name = link.egg_fragment + if not package_name: + raise InstallationError( + f"Could not detect requirement name for '{editable_req}', " + "please specify one with #egg=your_package_name" + ) + return package_name, url, set() + + +def check_first_requirement_in_file(filename: str) -> None: + """Check if file is parsable as a requirements file. + + This is heavily based on ``pkg_resources.parse_requirements``, but + simplified to just check the first meaningful line. + + :raises InvalidRequirement: If the first meaningful line cannot be parsed + as an requirement. + """ + with open(filename, encoding="utf-8", errors="ignore") as f: + # Create a steppable iterator, so we can handle \-continuations. + lines = ( + line + for line in (line.strip() for line in f) + if line and not line.startswith("#") # Skip blank lines/comments. + ) + + for line in lines: + # Drop comments -- a hash without a space may be in a URL. + if " #" in line: + line = line[: line.find(" #")] + # If there is a line continuation, drop it, and append the next line. + if line.endswith("\\"): + line = line[:-2].strip() + next(lines, "") + get_requirement(line) + return + + +def deduce_helpful_msg(req: str) -> str: + """Returns helpful msg in case requirements file does not exist, + or cannot be parsed. + + :params req: Requirements file path + """ + if not os.path.exists(req): + return f" File '{req}' does not exist." + msg = " The path does exist. " + # Try to parse and check if it is a requirements file. + try: + check_first_requirement_in_file(req) + except InvalidRequirement: + logger.debug("Cannot parse '%s' as requirements file", req) + else: + msg += ( + f"The argument you provided " + f"({req}) appears to be a" + f" requirements file. If that is the" + f" case, use the '-r' flag to install" + f" the packages specified within it." + ) + return msg + + +@dataclass(frozen=True) +class RequirementParts: + requirement: Optional[Requirement] + link: Optional[Link] + markers: Optional[Marker] + extras: Set[str] + + +def parse_req_from_editable(editable_req: str) -> RequirementParts: + name, url, extras_override = parse_editable(editable_req) + + if name is not None: + try: + req: Optional[Requirement] = get_requirement(name) + except InvalidRequirement as exc: + raise InstallationError(f"Invalid requirement: {name!r}: {exc}") + else: + req = None + + link = Link(url) + + return RequirementParts(req, link, None, extras_override) + + +# ---- The actual constructors follow ---- + + +def install_req_from_editable( + editable_req: str, + comes_from: Optional[Union[InstallRequirement, str]] = None, + *, + use_pep517: Optional[bool] = None, + isolated: bool = False, + global_options: Optional[List[str]] = None, + hash_options: Optional[Dict[str, List[str]]] = None, + constraint: bool = False, + user_supplied: bool = False, + permit_editable_wheels: bool = False, + config_settings: Optional[Dict[str, Union[str, List[str]]]] = None, +) -> InstallRequirement: + parts = parse_req_from_editable(editable_req) + + return InstallRequirement( + parts.requirement, + comes_from=comes_from, + user_supplied=user_supplied, + editable=True, + permit_editable_wheels=permit_editable_wheels, + link=parts.link, + constraint=constraint, + use_pep517=use_pep517, + isolated=isolated, + global_options=global_options, + hash_options=hash_options, + config_settings=config_settings, + extras=parts.extras, + ) + + +def _looks_like_path(name: str) -> bool: + """Checks whether the string "looks like" a path on the filesystem. + + This does not check whether the target actually exists, only judge from the + appearance. + + Returns true if any of the following conditions is true: + * a path separator is found (either os.path.sep or os.path.altsep); + * a dot is found (which represents the current directory). + """ + if os.path.sep in name: + return True + if os.path.altsep is not None and os.path.altsep in name: + return True + if name.startswith("."): + return True + return False + + +def _get_url_from_path(path: str, name: str) -> Optional[str]: + """ + First, it checks whether a provided path is an installable directory. If it + is, returns the path. + + If false, check if the path is an archive file (such as a .whl). + The function checks if the path is a file. If false, if the path has + an @, it will treat it as a PEP 440 URL requirement and return the path. + """ + if _looks_like_path(name) and os.path.isdir(path): + if is_installable_dir(path): + return path_to_url(path) + # TODO: The is_installable_dir test here might not be necessary + # now that it is done in load_pyproject_toml too. + raise InstallationError( + f"Directory {name!r} is not installable. Neither 'setup.py' " + "nor 'pyproject.toml' found." + ) + if not is_archive_file(path): + return None + if os.path.isfile(path): + return path_to_url(path) + urlreq_parts = name.split("@", 1) + if len(urlreq_parts) >= 2 and not _looks_like_path(urlreq_parts[0]): + # If the path contains '@' and the part before it does not look + # like a path, try to treat it as a PEP 440 URL req instead. + return None + logger.warning( + "Requirement %r looks like a filename, but the file does not exist", + name, + ) + return path_to_url(path) + + +def parse_req_from_line(name: str, line_source: Optional[str]) -> RequirementParts: + if is_url(name): + marker_sep = "; " + else: + marker_sep = ";" + if marker_sep in name: + name, markers_as_string = name.split(marker_sep, 1) + markers_as_string = markers_as_string.strip() + if not markers_as_string: + markers = None + else: + markers = Marker(markers_as_string) + else: + markers = None + name = name.strip() + req_as_string = None + path = os.path.normpath(os.path.abspath(name)) + link = None + extras_as_string = None + + if is_url(name): + link = Link(name) + else: + p, extras_as_string = _strip_extras(path) + url = _get_url_from_path(p, name) + if url is not None: + link = Link(url) + + # it's a local file, dir, or url + if link: + # Handle relative file URLs + if link.scheme == "file" and re.search(r"\.\./", link.url): + link = Link(path_to_url(os.path.normpath(os.path.abspath(link.path)))) + # wheel file + if link.is_wheel: + wheel = Wheel(link.filename) # can raise InvalidWheelFilename + req_as_string = f"{wheel.name}=={wheel.version}" + else: + # set the req to the egg fragment. when it's not there, this + # will become an 'unnamed' requirement + req_as_string = link.egg_fragment + + # a requirement specifier + else: + req_as_string = name + + extras = convert_extras(extras_as_string) + + def with_source(text: str) -> str: + if not line_source: + return text + return f"{text} (from {line_source})" + + def _parse_req_string(req_as_string: str) -> Requirement: + try: + return get_requirement(req_as_string) + except InvalidRequirement as exc: + if os.path.sep in req_as_string: + add_msg = "It looks like a path." + add_msg += deduce_helpful_msg(req_as_string) + elif "=" in req_as_string and not any( + op in req_as_string for op in operators + ): + add_msg = "= is not a valid operator. Did you mean == ?" + else: + add_msg = "" + msg = with_source(f"Invalid requirement: {req_as_string!r}: {exc}") + if add_msg: + msg += f"\nHint: {add_msg}" + raise InstallationError(msg) + + if req_as_string is not None: + req: Optional[Requirement] = _parse_req_string(req_as_string) + else: + req = None + + return RequirementParts(req, link, markers, extras) + + +def install_req_from_line( + name: str, + comes_from: Optional[Union[str, InstallRequirement]] = None, + *, + use_pep517: Optional[bool] = None, + isolated: bool = False, + global_options: Optional[List[str]] = None, + hash_options: Optional[Dict[str, List[str]]] = None, + constraint: bool = False, + line_source: Optional[str] = None, + user_supplied: bool = False, + config_settings: Optional[Dict[str, Union[str, List[str]]]] = None, +) -> InstallRequirement: + """Creates an InstallRequirement from a name, which might be a + requirement, directory containing 'setup.py', filename, or URL. + + :param line_source: An optional string describing where the line is from, + for logging purposes in case of an error. + """ + parts = parse_req_from_line(name, line_source) + + return InstallRequirement( + parts.requirement, + comes_from, + link=parts.link, + markers=parts.markers, + use_pep517=use_pep517, + isolated=isolated, + global_options=global_options, + hash_options=hash_options, + config_settings=config_settings, + constraint=constraint, + extras=parts.extras, + user_supplied=user_supplied, + ) + + +def install_req_from_req_string( + req_string: str, + comes_from: Optional[InstallRequirement] = None, + isolated: bool = False, + use_pep517: Optional[bool] = None, + user_supplied: bool = False, +) -> InstallRequirement: + try: + req = get_requirement(req_string) + except InvalidRequirement as exc: + raise InstallationError(f"Invalid requirement: {req_string!r}: {exc}") + + domains_not_allowed = [ + PyPI.file_storage_domain, + TestPyPI.file_storage_domain, + ] + if ( + req.url + and comes_from + and comes_from.link + and comes_from.link.netloc in domains_not_allowed + ): + # Explicitly disallow pypi packages that depend on external urls + raise InstallationError( + "Packages installed from PyPI cannot depend on packages " + "which are not also hosted on PyPI.\n" + f"{comes_from.name} depends on {req} " + ) + + return InstallRequirement( + req, + comes_from, + isolated=isolated, + use_pep517=use_pep517, + user_supplied=user_supplied, + ) + + +def install_req_from_parsed_requirement( + parsed_req: ParsedRequirement, + isolated: bool = False, + use_pep517: Optional[bool] = None, + user_supplied: bool = False, + config_settings: Optional[Dict[str, Union[str, List[str]]]] = None, +) -> InstallRequirement: + if parsed_req.is_editable: + req = install_req_from_editable( + parsed_req.requirement, + comes_from=parsed_req.comes_from, + use_pep517=use_pep517, + constraint=parsed_req.constraint, + isolated=isolated, + user_supplied=user_supplied, + config_settings=config_settings, + ) + + else: + req = install_req_from_line( + parsed_req.requirement, + comes_from=parsed_req.comes_from, + use_pep517=use_pep517, + isolated=isolated, + global_options=( + parsed_req.options.get("global_options", []) + if parsed_req.options + else [] + ), + hash_options=( + parsed_req.options.get("hashes", {}) if parsed_req.options else {} + ), + constraint=parsed_req.constraint, + line_source=parsed_req.line_source, + user_supplied=user_supplied, + config_settings=config_settings, + ) + return req + + +def install_req_from_link_and_ireq( + link: Link, ireq: InstallRequirement +) -> InstallRequirement: + return InstallRequirement( + req=ireq.req, + comes_from=ireq.comes_from, + editable=ireq.editable, + link=link, + markers=ireq.markers, + use_pep517=ireq.use_pep517, + isolated=ireq.isolated, + global_options=ireq.global_options, + hash_options=ireq.hash_options, + config_settings=ireq.config_settings, + user_supplied=ireq.user_supplied, + ) + + +def install_req_drop_extras(ireq: InstallRequirement) -> InstallRequirement: + """ + Creates a new InstallationRequirement using the given template but without + any extras. Sets the original requirement as the new one's parent + (comes_from). + """ + return InstallRequirement( + req=( + _set_requirement_extras(ireq.req, set()) if ireq.req is not None else None + ), + comes_from=ireq, + editable=ireq.editable, + link=ireq.link, + markers=ireq.markers, + use_pep517=ireq.use_pep517, + isolated=ireq.isolated, + global_options=ireq.global_options, + hash_options=ireq.hash_options, + constraint=ireq.constraint, + extras=[], + config_settings=ireq.config_settings, + user_supplied=ireq.user_supplied, + permit_editable_wheels=ireq.permit_editable_wheels, + ) + + +def install_req_extend_extras( + ireq: InstallRequirement, + extras: Collection[str], +) -> InstallRequirement: + """ + Returns a copy of an installation requirement with some additional extras. + Makes a shallow copy of the ireq object. + """ + result = copy.copy(ireq) + result.extras = {*ireq.extras, *extras} + result.req = ( + _set_requirement_extras(ireq.req, result.extras) + if ireq.req is not None + else None + ) + return result diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/req/req_file.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/req/req_file.py new file mode 100644 index 0000000..f6ba70f --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/req/req_file.py @@ -0,0 +1,623 @@ +""" +Requirements file parsing +""" + +import codecs +import locale +import logging +import optparse +import os +import re +import shlex +import sys +import urllib.parse +from dataclasses import dataclass +from optparse import Values +from typing import ( + TYPE_CHECKING, + Any, + Callable, + Dict, + Generator, + Iterable, + List, + NoReturn, + Optional, + Tuple, +) + +from pip._internal.cli import cmdoptions +from pip._internal.exceptions import InstallationError, RequirementsFileParseError +from pip._internal.models.search_scope import SearchScope + +if TYPE_CHECKING: + from pip._internal.index.package_finder import PackageFinder + from pip._internal.network.session import PipSession + +__all__ = ["parse_requirements"] + +ReqFileLines = Iterable[Tuple[int, str]] + +LineParser = Callable[[str], Tuple[str, Values]] + +SCHEME_RE = re.compile(r"^(http|https|file):", re.I) +COMMENT_RE = re.compile(r"(^|\s+)#.*$") + +# Matches environment variable-style values in '${MY_VARIABLE_1}' with the +# variable name consisting of only uppercase letters, digits or the '_' +# (underscore). This follows the POSIX standard defined in IEEE Std 1003.1, +# 2013 Edition. +ENV_VAR_RE = re.compile(r"(?P\$\{(?P[A-Z0-9_]+)\})") + +SUPPORTED_OPTIONS: List[Callable[..., optparse.Option]] = [ + cmdoptions.index_url, + cmdoptions.extra_index_url, + cmdoptions.no_index, + cmdoptions.constraints, + cmdoptions.requirements, + cmdoptions.editable, + cmdoptions.find_links, + cmdoptions.no_binary, + cmdoptions.only_binary, + cmdoptions.prefer_binary, + cmdoptions.require_hashes, + cmdoptions.pre, + cmdoptions.trusted_host, + cmdoptions.use_new_feature, +] + +# options to be passed to requirements +SUPPORTED_OPTIONS_REQ: List[Callable[..., optparse.Option]] = [ + cmdoptions.global_options, + cmdoptions.hash, + cmdoptions.config_settings, +] + +SUPPORTED_OPTIONS_EDITABLE_REQ: List[Callable[..., optparse.Option]] = [ + cmdoptions.config_settings, +] + + +# the 'dest' string values +SUPPORTED_OPTIONS_REQ_DEST = [str(o().dest) for o in SUPPORTED_OPTIONS_REQ] +SUPPORTED_OPTIONS_EDITABLE_REQ_DEST = [ + str(o().dest) for o in SUPPORTED_OPTIONS_EDITABLE_REQ +] + +# order of BOMS is important: codecs.BOM_UTF16_LE is a prefix of codecs.BOM_UTF32_LE +# so data.startswith(BOM_UTF16_LE) would be true for UTF32_LE data +BOMS: List[Tuple[bytes, str]] = [ + (codecs.BOM_UTF8, "utf-8"), + (codecs.BOM_UTF32, "utf-32"), + (codecs.BOM_UTF32_BE, "utf-32-be"), + (codecs.BOM_UTF32_LE, "utf-32-le"), + (codecs.BOM_UTF16, "utf-16"), + (codecs.BOM_UTF16_BE, "utf-16-be"), + (codecs.BOM_UTF16_LE, "utf-16-le"), +] + +PEP263_ENCODING_RE = re.compile(rb"coding[:=]\s*([-\w.]+)") +DEFAULT_ENCODING = "utf-8" + +logger = logging.getLogger(__name__) + + +@dataclass(frozen=True) +class ParsedRequirement: + # TODO: replace this with slots=True when dropping Python 3.9 support. + __slots__ = ( + "requirement", + "is_editable", + "comes_from", + "constraint", + "options", + "line_source", + ) + + requirement: str + is_editable: bool + comes_from: str + constraint: bool + options: Optional[Dict[str, Any]] + line_source: Optional[str] + + +@dataclass(frozen=True) +class ParsedLine: + __slots__ = ("filename", "lineno", "args", "opts", "constraint") + + filename: str + lineno: int + args: str + opts: Values + constraint: bool + + @property + def is_editable(self) -> bool: + return bool(self.opts.editables) + + @property + def requirement(self) -> Optional[str]: + if self.args: + return self.args + elif self.is_editable: + # We don't support multiple -e on one line + return self.opts.editables[0] + return None + + +def parse_requirements( + filename: str, + session: "PipSession", + finder: Optional["PackageFinder"] = None, + options: Optional[optparse.Values] = None, + constraint: bool = False, +) -> Generator[ParsedRequirement, None, None]: + """Parse a requirements file and yield ParsedRequirement instances. + + :param filename: Path or url of requirements file. + :param session: PipSession instance. + :param finder: Instance of pip.index.PackageFinder. + :param options: cli options. + :param constraint: If true, parsing a constraint file rather than + requirements file. + """ + line_parser = get_line_parser(finder) + parser = RequirementsFileParser(session, line_parser) + + for parsed_line in parser.parse(filename, constraint): + parsed_req = handle_line( + parsed_line, options=options, finder=finder, session=session + ) + if parsed_req is not None: + yield parsed_req + + +def preprocess(content: str) -> ReqFileLines: + """Split, filter, and join lines, and return a line iterator + + :param content: the content of the requirements file + """ + lines_enum: ReqFileLines = enumerate(content.splitlines(), start=1) + lines_enum = join_lines(lines_enum) + lines_enum = ignore_comments(lines_enum) + lines_enum = expand_env_variables(lines_enum) + return lines_enum + + +def handle_requirement_line( + line: ParsedLine, + options: Optional[optparse.Values] = None, +) -> ParsedRequirement: + # preserve for the nested code path + line_comes_from = "{} {} (line {})".format( + "-c" if line.constraint else "-r", + line.filename, + line.lineno, + ) + + assert line.requirement is not None + + # get the options that apply to requirements + if line.is_editable: + supported_dest = SUPPORTED_OPTIONS_EDITABLE_REQ_DEST + else: + supported_dest = SUPPORTED_OPTIONS_REQ_DEST + req_options = {} + for dest in supported_dest: + if dest in line.opts.__dict__ and line.opts.__dict__[dest]: + req_options[dest] = line.opts.__dict__[dest] + + line_source = f"line {line.lineno} of {line.filename}" + return ParsedRequirement( + requirement=line.requirement, + is_editable=line.is_editable, + comes_from=line_comes_from, + constraint=line.constraint, + options=req_options, + line_source=line_source, + ) + + +def handle_option_line( + opts: Values, + filename: str, + lineno: int, + finder: Optional["PackageFinder"] = None, + options: Optional[optparse.Values] = None, + session: Optional["PipSession"] = None, +) -> None: + if opts.hashes: + logger.warning( + "%s line %s has --hash but no requirement, and will be ignored.", + filename, + lineno, + ) + + if options: + # percolate options upward + if opts.require_hashes: + options.require_hashes = opts.require_hashes + if opts.features_enabled: + options.features_enabled.extend( + f for f in opts.features_enabled if f not in options.features_enabled + ) + + # set finder options + if finder: + find_links = finder.find_links + index_urls = finder.index_urls + no_index = finder.search_scope.no_index + if opts.no_index is True: + no_index = True + index_urls = [] + if opts.index_url and not no_index: + index_urls = [opts.index_url] + if opts.extra_index_urls and not no_index: + index_urls.extend(opts.extra_index_urls) + if opts.find_links: + # FIXME: it would be nice to keep track of the source + # of the find_links: support a find-links local path + # relative to a requirements file. + value = opts.find_links[0] + req_dir = os.path.dirname(os.path.abspath(filename)) + relative_to_reqs_file = os.path.join(req_dir, value) + if os.path.exists(relative_to_reqs_file): + value = relative_to_reqs_file + find_links.append(value) + + if session: + # We need to update the auth urls in session + session.update_index_urls(index_urls) + + search_scope = SearchScope( + find_links=find_links, + index_urls=index_urls, + no_index=no_index, + ) + finder.search_scope = search_scope + + if opts.pre: + finder.set_allow_all_prereleases() + + if opts.prefer_binary: + finder.set_prefer_binary() + + if session: + for host in opts.trusted_hosts or []: + source = f"line {lineno} of {filename}" + session.add_trusted_host(host, source=source) + + +def handle_line( + line: ParsedLine, + options: Optional[optparse.Values] = None, + finder: Optional["PackageFinder"] = None, + session: Optional["PipSession"] = None, +) -> Optional[ParsedRequirement]: + """Handle a single parsed requirements line; This can result in + creating/yielding requirements, or updating the finder. + + :param line: The parsed line to be processed. + :param options: CLI options. + :param finder: The finder - updated by non-requirement lines. + :param session: The session - updated by non-requirement lines. + + Returns a ParsedRequirement object if the line is a requirement line, + otherwise returns None. + + For lines that contain requirements, the only options that have an effect + are from SUPPORTED_OPTIONS_REQ, and they are scoped to the + requirement. Other options from SUPPORTED_OPTIONS may be present, but are + ignored. + + For lines that do not contain requirements, the only options that have an + effect are from SUPPORTED_OPTIONS. Options from SUPPORTED_OPTIONS_REQ may + be present, but are ignored. These lines may contain multiple options + (although our docs imply only one is supported), and all our parsed and + affect the finder. + """ + + if line.requirement is not None: + parsed_req = handle_requirement_line(line, options) + return parsed_req + else: + handle_option_line( + line.opts, + line.filename, + line.lineno, + finder, + options, + session, + ) + return None + + +class RequirementsFileParser: + def __init__( + self, + session: "PipSession", + line_parser: LineParser, + ) -> None: + self._session = session + self._line_parser = line_parser + + def parse( + self, filename: str, constraint: bool + ) -> Generator[ParsedLine, None, None]: + """Parse a given file, yielding parsed lines.""" + yield from self._parse_and_recurse( + filename, constraint, [{os.path.abspath(filename): None}] + ) + + def _parse_and_recurse( + self, + filename: str, + constraint: bool, + parsed_files_stack: List[Dict[str, Optional[str]]], + ) -> Generator[ParsedLine, None, None]: + for line in self._parse_file(filename, constraint): + if line.requirement is None and ( + line.opts.requirements or line.opts.constraints + ): + # parse a nested requirements file + if line.opts.requirements: + req_path = line.opts.requirements[0] + nested_constraint = False + else: + req_path = line.opts.constraints[0] + nested_constraint = True + + # original file is over http + if SCHEME_RE.search(filename): + # do a url join so relative paths work + req_path = urllib.parse.urljoin(filename, req_path) + # original file and nested file are paths + elif not SCHEME_RE.search(req_path): + # do a join so relative paths work + # and then abspath so that we can identify recursive references + req_path = os.path.abspath( + os.path.join( + os.path.dirname(filename), + req_path, + ) + ) + parsed_files = parsed_files_stack[0] + if req_path in parsed_files: + initial_file = parsed_files[req_path] + tail = ( + f" and again in {initial_file}" + if initial_file is not None + else "" + ) + raise RequirementsFileParseError( + f"{req_path} recursively references itself in {filename}{tail}" + ) + # Keeping a track where was each file first included in + new_parsed_files = parsed_files.copy() + new_parsed_files[req_path] = filename + yield from self._parse_and_recurse( + req_path, nested_constraint, [new_parsed_files, *parsed_files_stack] + ) + else: + yield line + + def _parse_file( + self, filename: str, constraint: bool + ) -> Generator[ParsedLine, None, None]: + _, content = get_file_content(filename, self._session) + + lines_enum = preprocess(content) + + for line_number, line in lines_enum: + try: + args_str, opts = self._line_parser(line) + except OptionParsingError as e: + # add offending line + msg = f"Invalid requirement: {line}\n{e.msg}" + raise RequirementsFileParseError(msg) + + yield ParsedLine( + filename, + line_number, + args_str, + opts, + constraint, + ) + + +def get_line_parser(finder: Optional["PackageFinder"]) -> LineParser: + def parse_line(line: str) -> Tuple[str, Values]: + # Build new parser for each line since it accumulates appendable + # options. + parser = build_parser() + defaults = parser.get_default_values() + defaults.index_url = None + if finder: + defaults.format_control = finder.format_control + + args_str, options_str = break_args_options(line) + + try: + options = shlex.split(options_str) + except ValueError as e: + raise OptionParsingError(f"Could not split options: {options_str}") from e + + opts, _ = parser.parse_args(options, defaults) + + return args_str, opts + + return parse_line + + +def break_args_options(line: str) -> Tuple[str, str]: + """Break up the line into an args and options string. We only want to shlex + (and then optparse) the options, not the args. args can contain markers + which are corrupted by shlex. + """ + tokens = line.split(" ") + args = [] + options = tokens[:] + for token in tokens: + if token.startswith("-") or token.startswith("--"): + break + else: + args.append(token) + options.pop(0) + return " ".join(args), " ".join(options) + + +class OptionParsingError(Exception): + def __init__(self, msg: str) -> None: + self.msg = msg + + +def build_parser() -> optparse.OptionParser: + """ + Return a parser for parsing requirement lines + """ + parser = optparse.OptionParser(add_help_option=False) + + option_factories = SUPPORTED_OPTIONS + SUPPORTED_OPTIONS_REQ + for option_factory in option_factories: + option = option_factory() + parser.add_option(option) + + # By default optparse sys.exits on parsing errors. We want to wrap + # that in our own exception. + def parser_exit(self: Any, msg: str) -> "NoReturn": + raise OptionParsingError(msg) + + # NOTE: mypy disallows assigning to a method + # https://github.com/python/mypy/issues/2427 + parser.exit = parser_exit # type: ignore + + return parser + + +def join_lines(lines_enum: ReqFileLines) -> ReqFileLines: + """Joins a line ending in '\' with the previous line (except when following + comments). The joined line takes on the index of the first line. + """ + primary_line_number = None + new_line: List[str] = [] + for line_number, line in lines_enum: + if not line.endswith("\\") or COMMENT_RE.match(line): + if COMMENT_RE.match(line): + # this ensures comments are always matched later + line = " " + line + if new_line: + new_line.append(line) + assert primary_line_number is not None + yield primary_line_number, "".join(new_line) + new_line = [] + else: + yield line_number, line + else: + if not new_line: + primary_line_number = line_number + new_line.append(line.strip("\\")) + + # last line contains \ + if new_line: + assert primary_line_number is not None + yield primary_line_number, "".join(new_line) + + # TODO: handle space after '\'. + + +def ignore_comments(lines_enum: ReqFileLines) -> ReqFileLines: + """ + Strips comments and filter empty lines. + """ + for line_number, line in lines_enum: + line = COMMENT_RE.sub("", line) + line = line.strip() + if line: + yield line_number, line + + +def expand_env_variables(lines_enum: ReqFileLines) -> ReqFileLines: + """Replace all environment variables that can be retrieved via `os.getenv`. + + The only allowed format for environment variables defined in the + requirement file is `${MY_VARIABLE_1}` to ensure two things: + + 1. Strings that contain a `$` aren't accidentally (partially) expanded. + 2. Ensure consistency across platforms for requirement files. + + These points are the result of a discussion on the `github pull + request #3514 `_. + + Valid characters in variable names follow the `POSIX standard + `_ and are limited + to uppercase letter, digits and the `_` (underscore). + """ + for line_number, line in lines_enum: + for env_var, var_name in ENV_VAR_RE.findall(line): + value = os.getenv(var_name) + if not value: + continue + + line = line.replace(env_var, value) + + yield line_number, line + + +def get_file_content(url: str, session: "PipSession") -> Tuple[str, str]: + """Gets the content of a file; it may be a filename, file: URL, or + http: URL. Returns (location, content). Content is unicode. + Respects # -*- coding: declarations on the retrieved files. + + :param url: File path or url. + :param session: PipSession instance. + """ + scheme = urllib.parse.urlsplit(url).scheme + # Pip has special support for file:// URLs (LocalFSAdapter). + if scheme in ["http", "https", "file"]: + # Delay importing heavy network modules until absolutely necessary. + from pip._internal.network.utils import raise_for_status + + resp = session.get(url) + raise_for_status(resp) + return resp.url, resp.text + + # Assume this is a bare path. + try: + with open(url, "rb") as f: + raw_content = f.read() + except OSError as exc: + raise InstallationError(f"Could not open requirements file: {exc}") + + content = _decode_req_file(raw_content, url) + + return url, content + + +def _decode_req_file(data: bytes, url: str) -> str: + for bom, encoding in BOMS: + if data.startswith(bom): + return data[len(bom) :].decode(encoding) + + for line in data.split(b"\n")[:2]: + if line[0:1] == b"#": + result = PEP263_ENCODING_RE.search(line) + if result is not None: + encoding = result.groups()[0].decode("ascii") + return data.decode(encoding) + + try: + return data.decode(DEFAULT_ENCODING) + except UnicodeDecodeError: + locale_encoding = locale.getpreferredencoding(False) or sys.getdefaultencoding() + logging.warning( + "unable to decode data from %s with default encoding %s, " + "falling back to encoding from locale: %s. " + "If this is intentional you should specify the encoding with a " + "PEP-263 style comment, e.g. '# -*- coding: %s -*-'", + url, + DEFAULT_ENCODING, + locale_encoding, + locale_encoding, + ) + return data.decode(locale_encoding) diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/req/req_install.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/req/req_install.py new file mode 100644 index 0000000..3262d82 --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/req/req_install.py @@ -0,0 +1,934 @@ +import functools +import logging +import os +import shutil +import sys +import uuid +import zipfile +from optparse import Values +from pathlib import Path +from typing import Any, Collection, Dict, Iterable, List, Optional, Sequence, Union + +from pip._vendor.packaging.markers import Marker +from pip._vendor.packaging.requirements import Requirement +from pip._vendor.packaging.specifiers import SpecifierSet +from pip._vendor.packaging.utils import canonicalize_name +from pip._vendor.packaging.version import Version +from pip._vendor.packaging.version import parse as parse_version +from pip._vendor.pyproject_hooks import BuildBackendHookCaller + +from pip._internal.build_env import BuildEnvironment, NoOpBuildEnvironment +from pip._internal.exceptions import InstallationError, PreviousBuildDirError +from pip._internal.locations import get_scheme +from pip._internal.metadata import ( + BaseDistribution, + get_default_environment, + get_directory_distribution, + get_wheel_distribution, +) +from pip._internal.metadata.base import FilesystemWheel +from pip._internal.models.direct_url import DirectUrl +from pip._internal.models.link import Link +from pip._internal.operations.build.metadata import generate_metadata +from pip._internal.operations.build.metadata_editable import generate_editable_metadata +from pip._internal.operations.build.metadata_legacy import ( + generate_metadata as generate_metadata_legacy, +) +from pip._internal.operations.install.editable_legacy import ( + install_editable as install_editable_legacy, +) +from pip._internal.operations.install.wheel import install_wheel +from pip._internal.pyproject import load_pyproject_toml, make_pyproject_path +from pip._internal.req.req_uninstall import UninstallPathSet +from pip._internal.utils.deprecation import deprecated +from pip._internal.utils.hashes import Hashes +from pip._internal.utils.misc import ( + ConfiguredBuildBackendHookCaller, + ask_path_exists, + backup_dir, + display_path, + hide_url, + is_installable_dir, + redact_auth_from_requirement, + redact_auth_from_url, +) +from pip._internal.utils.packaging import get_requirement +from pip._internal.utils.subprocess import runner_with_spinner_message +from pip._internal.utils.temp_dir import TempDirectory, tempdir_kinds +from pip._internal.utils.unpacking import unpack_file +from pip._internal.utils.virtualenv import running_under_virtualenv +from pip._internal.vcs import vcs + +logger = logging.getLogger(__name__) + + +class InstallRequirement: + """ + Represents something that may be installed later on, may have information + about where to fetch the relevant requirement and also contains logic for + installing the said requirement. + """ + + def __init__( + self, + req: Optional[Requirement], + comes_from: Optional[Union[str, "InstallRequirement"]], + editable: bool = False, + link: Optional[Link] = None, + markers: Optional[Marker] = None, + use_pep517: Optional[bool] = None, + isolated: bool = False, + *, + global_options: Optional[List[str]] = None, + hash_options: Optional[Dict[str, List[str]]] = None, + config_settings: Optional[Dict[str, Union[str, List[str]]]] = None, + constraint: bool = False, + extras: Collection[str] = (), + user_supplied: bool = False, + permit_editable_wheels: bool = False, + ) -> None: + assert req is None or isinstance(req, Requirement), req + self.req = req + self.comes_from = comes_from + self.constraint = constraint + self.editable = editable + self.permit_editable_wheels = permit_editable_wheels + + # source_dir is the local directory where the linked requirement is + # located, or unpacked. In case unpacking is needed, creating and + # populating source_dir is done by the RequirementPreparer. Note this + # is not necessarily the directory where pyproject.toml or setup.py is + # located - that one is obtained via unpacked_source_directory. + self.source_dir: Optional[str] = None + if self.editable: + assert link + if link.is_file: + self.source_dir = os.path.normpath(os.path.abspath(link.file_path)) + + # original_link is the direct URL that was provided by the user for the + # requirement, either directly or via a constraints file. + if link is None and req and req.url: + # PEP 508 URL requirement + link = Link(req.url) + self.link = self.original_link = link + + # When this InstallRequirement is a wheel obtained from the cache of locally + # built wheels, this is the source link corresponding to the cache entry, which + # was used to download and build the cached wheel. + self.cached_wheel_source_link: Optional[Link] = None + + # Information about the location of the artifact that was downloaded . This + # property is guaranteed to be set in resolver results. + self.download_info: Optional[DirectUrl] = None + + # Path to any downloaded or already-existing package. + self.local_file_path: Optional[str] = None + if self.link and self.link.is_file: + self.local_file_path = self.link.file_path + + if extras: + self.extras = extras + elif req: + self.extras = req.extras + else: + self.extras = set() + if markers is None and req: + markers = req.marker + self.markers = markers + + # This holds the Distribution object if this requirement is already installed. + self.satisfied_by: Optional[BaseDistribution] = None + # Whether the installation process should try to uninstall an existing + # distribution before installing this requirement. + self.should_reinstall = False + # Temporary build location + self._temp_build_dir: Optional[TempDirectory] = None + # Set to True after successful installation + self.install_succeeded: Optional[bool] = None + # Supplied options + self.global_options = global_options if global_options else [] + self.hash_options = hash_options if hash_options else {} + self.config_settings = config_settings + # Set to True after successful preparation of this requirement + self.prepared = False + # User supplied requirement are explicitly requested for installation + # by the user via CLI arguments or requirements files, as opposed to, + # e.g. dependencies, extras or constraints. + self.user_supplied = user_supplied + + self.isolated = isolated + self.build_env: BuildEnvironment = NoOpBuildEnvironment() + + # For PEP 517, the directory where we request the project metadata + # gets stored. We need this to pass to build_wheel, so the backend + # can ensure that the wheel matches the metadata (see the PEP for + # details). + self.metadata_directory: Optional[str] = None + + # The static build requirements (from pyproject.toml) + self.pyproject_requires: Optional[List[str]] = None + + # Build requirements that we will check are available + self.requirements_to_check: List[str] = [] + + # The PEP 517 backend we should use to build the project + self.pep517_backend: Optional[BuildBackendHookCaller] = None + + # Are we using PEP 517 for this requirement? + # After pyproject.toml has been loaded, the only valid values are True + # and False. Before loading, None is valid (meaning "use the default"). + # Setting an explicit value before loading pyproject.toml is supported, + # but after loading this flag should be treated as read only. + self.use_pep517 = use_pep517 + + # If config settings are provided, enforce PEP 517. + if self.config_settings: + if self.use_pep517 is False: + logger.warning( + "--no-use-pep517 ignored for %s " + "because --config-settings are specified.", + self, + ) + self.use_pep517 = True + + # This requirement needs more preparation before it can be built + self.needs_more_preparation = False + + # This requirement needs to be unpacked before it can be installed. + self._archive_source: Optional[Path] = None + + def __str__(self) -> str: + if self.req: + s = redact_auth_from_requirement(self.req) + if self.link: + s += f" from {redact_auth_from_url(self.link.url)}" + elif self.link: + s = redact_auth_from_url(self.link.url) + else: + s = "" + if self.satisfied_by is not None: + if self.satisfied_by.location is not None: + location = display_path(self.satisfied_by.location) + else: + location = "" + s += f" in {location}" + if self.comes_from: + if isinstance(self.comes_from, str): + comes_from: Optional[str] = self.comes_from + else: + comes_from = self.comes_from.from_path() + if comes_from: + s += f" (from {comes_from})" + return s + + def __repr__(self) -> str: + return ( + f"<{self.__class__.__name__} object: " + f"{str(self)} editable={self.editable!r}>" + ) + + def format_debug(self) -> str: + """An un-tested helper for getting state, for debugging.""" + attributes = vars(self) + names = sorted(attributes) + + state = (f"{attr}={attributes[attr]!r}" for attr in sorted(names)) + return "<{name} object: {{{state}}}>".format( + name=self.__class__.__name__, + state=", ".join(state), + ) + + # Things that are valid for all kinds of requirements? + @property + def name(self) -> Optional[str]: + if self.req is None: + return None + return self.req.name + + @functools.cached_property + def supports_pyproject_editable(self) -> bool: + if not self.use_pep517: + return False + assert self.pep517_backend + with self.build_env: + runner = runner_with_spinner_message( + "Checking if build backend supports build_editable" + ) + with self.pep517_backend.subprocess_runner(runner): + return "build_editable" in self.pep517_backend._supported_features() + + @property + def specifier(self) -> SpecifierSet: + assert self.req is not None + return self.req.specifier + + @property + def is_direct(self) -> bool: + """Whether this requirement was specified as a direct URL.""" + return self.original_link is not None + + @property + def is_pinned(self) -> bool: + """Return whether I am pinned to an exact version. + + For example, some-package==1.2 is pinned; some-package>1.2 is not. + """ + assert self.req is not None + specifiers = self.req.specifier + return len(specifiers) == 1 and next(iter(specifiers)).operator in {"==", "==="} + + def match_markers(self, extras_requested: Optional[Iterable[str]] = None) -> bool: + if not extras_requested: + # Provide an extra to safely evaluate the markers + # without matching any extra + extras_requested = ("",) + if self.markers is not None: + return any( + self.markers.evaluate({"extra": extra}) for extra in extras_requested + ) + else: + return True + + @property + def has_hash_options(self) -> bool: + """Return whether any known-good hashes are specified as options. + + These activate --require-hashes mode; hashes specified as part of a + URL do not. + + """ + return bool(self.hash_options) + + def hashes(self, trust_internet: bool = True) -> Hashes: + """Return a hash-comparer that considers my option- and URL-based + hashes to be known-good. + + Hashes in URLs--ones embedded in the requirements file, not ones + downloaded from an index server--are almost peers with ones from + flags. They satisfy --require-hashes (whether it was implicitly or + explicitly activated) but do not activate it. md5 and sha224 are not + allowed in flags, which should nudge people toward good algos. We + always OR all hashes together, even ones from URLs. + + :param trust_internet: Whether to trust URL-based (#md5=...) hashes + downloaded from the internet, as by populate_link() + + """ + good_hashes = self.hash_options.copy() + if trust_internet: + link = self.link + elif self.is_direct and self.user_supplied: + link = self.original_link + else: + link = None + if link and link.hash: + assert link.hash_name is not None + good_hashes.setdefault(link.hash_name, []).append(link.hash) + return Hashes(good_hashes) + + def from_path(self) -> Optional[str]: + """Format a nice indicator to show where this "comes from" """ + if self.req is None: + return None + s = str(self.req) + if self.comes_from: + comes_from: Optional[str] + if isinstance(self.comes_from, str): + comes_from = self.comes_from + else: + comes_from = self.comes_from.from_path() + if comes_from: + s += "->" + comes_from + return s + + def ensure_build_location( + self, build_dir: str, autodelete: bool, parallel_builds: bool + ) -> str: + assert build_dir is not None + if self._temp_build_dir is not None: + assert self._temp_build_dir.path + return self._temp_build_dir.path + if self.req is None: + # Some systems have /tmp as a symlink which confuses custom + # builds (such as numpy). Thus, we ensure that the real path + # is returned. + self._temp_build_dir = TempDirectory( + kind=tempdir_kinds.REQ_BUILD, globally_managed=True + ) + + return self._temp_build_dir.path + + # This is the only remaining place where we manually determine the path + # for the temporary directory. It is only needed for editables where + # it is the value of the --src option. + + # When parallel builds are enabled, add a UUID to the build directory + # name so multiple builds do not interfere with each other. + dir_name: str = canonicalize_name(self.req.name) + if parallel_builds: + dir_name = f"{dir_name}_{uuid.uuid4().hex}" + + # FIXME: Is there a better place to create the build_dir? (hg and bzr + # need this) + if not os.path.exists(build_dir): + logger.debug("Creating directory %s", build_dir) + os.makedirs(build_dir) + actual_build_dir = os.path.join(build_dir, dir_name) + # `None` indicates that we respect the globally-configured deletion + # settings, which is what we actually want when auto-deleting. + delete_arg = None if autodelete else False + return TempDirectory( + path=actual_build_dir, + delete=delete_arg, + kind=tempdir_kinds.REQ_BUILD, + globally_managed=True, + ).path + + def _set_requirement(self) -> None: + """Set requirement after generating metadata.""" + assert self.req is None + assert self.metadata is not None + assert self.source_dir is not None + + # Construct a Requirement object from the generated metadata + if isinstance(parse_version(self.metadata["Version"]), Version): + op = "==" + else: + op = "===" + + self.req = get_requirement( + "".join( + [ + self.metadata["Name"], + op, + self.metadata["Version"], + ] + ) + ) + + def warn_on_mismatching_name(self) -> None: + assert self.req is not None + metadata_name = canonicalize_name(self.metadata["Name"]) + if canonicalize_name(self.req.name) == metadata_name: + # Everything is fine. + return + + # If we're here, there's a mismatch. Log a warning about it. + logger.warning( + "Generating metadata for package %s " + "produced metadata for project name %s. Fix your " + "#egg=%s fragments.", + self.name, + metadata_name, + self.name, + ) + self.req = get_requirement(metadata_name) + + def check_if_exists(self, use_user_site: bool) -> None: + """Find an installed distribution that satisfies or conflicts + with this requirement, and set self.satisfied_by or + self.should_reinstall appropriately. + """ + if self.req is None: + return + existing_dist = get_default_environment().get_distribution(self.req.name) + if not existing_dist: + return + + version_compatible = self.req.specifier.contains( + existing_dist.version, + prereleases=True, + ) + if not version_compatible: + self.satisfied_by = None + if use_user_site: + if existing_dist.in_usersite: + self.should_reinstall = True + elif running_under_virtualenv() and existing_dist.in_site_packages: + raise InstallationError( + f"Will not install to the user site because it will " + f"lack sys.path precedence to {existing_dist.raw_name} " + f"in {existing_dist.location}" + ) + else: + self.should_reinstall = True + else: + if self.editable: + self.should_reinstall = True + # when installing editables, nothing pre-existing should ever + # satisfy + self.satisfied_by = None + else: + self.satisfied_by = existing_dist + + # Things valid for wheels + @property + def is_wheel(self) -> bool: + if not self.link: + return False + return self.link.is_wheel + + @property + def is_wheel_from_cache(self) -> bool: + # When True, it means that this InstallRequirement is a local wheel file in the + # cache of locally built wheels. + return self.cached_wheel_source_link is not None + + # Things valid for sdists + @property + def unpacked_source_directory(self) -> str: + assert self.source_dir, f"No source dir for {self}" + return os.path.join( + self.source_dir, self.link and self.link.subdirectory_fragment or "" + ) + + @property + def setup_py_path(self) -> str: + assert self.source_dir, f"No source dir for {self}" + setup_py = os.path.join(self.unpacked_source_directory, "setup.py") + + return setup_py + + @property + def setup_cfg_path(self) -> str: + assert self.source_dir, f"No source dir for {self}" + setup_cfg = os.path.join(self.unpacked_source_directory, "setup.cfg") + + return setup_cfg + + @property + def pyproject_toml_path(self) -> str: + assert self.source_dir, f"No source dir for {self}" + return make_pyproject_path(self.unpacked_source_directory) + + def load_pyproject_toml(self) -> None: + """Load the pyproject.toml file. + + After calling this routine, all of the attributes related to PEP 517 + processing for this requirement have been set. In particular, the + use_pep517 attribute can be used to determine whether we should + follow the PEP 517 or legacy (setup.py) code path. + """ + pyproject_toml_data = load_pyproject_toml( + self.use_pep517, self.pyproject_toml_path, self.setup_py_path, str(self) + ) + + if pyproject_toml_data is None: + assert not self.config_settings + self.use_pep517 = False + return + + self.use_pep517 = True + requires, backend, check, backend_path = pyproject_toml_data + self.requirements_to_check = check + self.pyproject_requires = requires + self.pep517_backend = ConfiguredBuildBackendHookCaller( + self, + self.unpacked_source_directory, + backend, + backend_path=backend_path, + ) + + def isolated_editable_sanity_check(self) -> None: + """Check that an editable requirement if valid for use with PEP 517/518. + + This verifies that an editable that has a pyproject.toml either supports PEP 660 + or as a setup.py or a setup.cfg + """ + if ( + self.editable + and self.use_pep517 + and not self.supports_pyproject_editable + and not os.path.isfile(self.setup_py_path) + and not os.path.isfile(self.setup_cfg_path) + ): + raise InstallationError( + f"Project {self} has a 'pyproject.toml' and its build " + f"backend is missing the 'build_editable' hook. Since it does not " + f"have a 'setup.py' nor a 'setup.cfg', " + f"it cannot be installed in editable mode. " + f"Consider using a build backend that supports PEP 660." + ) + + def prepare_metadata(self) -> None: + """Ensure that project metadata is available. + + Under PEP 517 and PEP 660, call the backend hook to prepare the metadata. + Under legacy processing, call setup.py egg-info. + """ + assert self.source_dir, f"No source dir for {self}" + details = self.name or f"from {self.link}" + + if self.use_pep517: + assert self.pep517_backend is not None + if ( + self.editable + and self.permit_editable_wheels + and self.supports_pyproject_editable + ): + self.metadata_directory = generate_editable_metadata( + build_env=self.build_env, + backend=self.pep517_backend, + details=details, + ) + else: + self.metadata_directory = generate_metadata( + build_env=self.build_env, + backend=self.pep517_backend, + details=details, + ) + else: + self.metadata_directory = generate_metadata_legacy( + build_env=self.build_env, + setup_py_path=self.setup_py_path, + source_dir=self.unpacked_source_directory, + isolated=self.isolated, + details=details, + ) + + # Act on the newly generated metadata, based on the name and version. + if not self.name: + self._set_requirement() + else: + self.warn_on_mismatching_name() + + self.assert_source_matches_version() + + @property + def metadata(self) -> Any: + if not hasattr(self, "_metadata"): + self._metadata = self.get_dist().metadata + + return self._metadata + + def get_dist(self) -> BaseDistribution: + if self.metadata_directory: + return get_directory_distribution(self.metadata_directory) + elif self.local_file_path and self.is_wheel: + assert self.req is not None + return get_wheel_distribution( + FilesystemWheel(self.local_file_path), + canonicalize_name(self.req.name), + ) + raise AssertionError( + f"InstallRequirement {self} has no metadata directory and no wheel: " + f"can't make a distribution." + ) + + def assert_source_matches_version(self) -> None: + assert self.source_dir, f"No source dir for {self}" + version = self.metadata["version"] + if self.req and self.req.specifier and version not in self.req.specifier: + logger.warning( + "Requested %s, but installing version %s", + self, + version, + ) + else: + logger.debug( + "Source in %s has version %s, which satisfies requirement %s", + display_path(self.source_dir), + version, + self, + ) + + # For both source distributions and editables + def ensure_has_source_dir( + self, + parent_dir: str, + autodelete: bool = False, + parallel_builds: bool = False, + ) -> None: + """Ensure that a source_dir is set. + + This will create a temporary build dir if the name of the requirement + isn't known yet. + + :param parent_dir: The ideal pip parent_dir for the source_dir. + Generally src_dir for editables and build_dir for sdists. + :return: self.source_dir + """ + if self.source_dir is None: + self.source_dir = self.ensure_build_location( + parent_dir, + autodelete=autodelete, + parallel_builds=parallel_builds, + ) + + def needs_unpacked_archive(self, archive_source: Path) -> None: + assert self._archive_source is None + self._archive_source = archive_source + + def ensure_pristine_source_checkout(self) -> None: + """Ensure the source directory has not yet been built in.""" + assert self.source_dir is not None + if self._archive_source is not None: + unpack_file(str(self._archive_source), self.source_dir) + elif is_installable_dir(self.source_dir): + # If a checkout exists, it's unwise to keep going. + # version inconsistencies are logged later, but do not fail + # the installation. + raise PreviousBuildDirError( + f"pip can't proceed with requirements '{self}' due to a " + f"pre-existing build directory ({self.source_dir}). This is likely " + "due to a previous installation that failed . pip is " + "being responsible and not assuming it can delete this. " + "Please delete it and try again." + ) + + # For editable installations + def update_editable(self) -> None: + if not self.link: + logger.debug( + "Cannot update repository at %s; repository location is unknown", + self.source_dir, + ) + return + assert self.editable + assert self.source_dir + if self.link.scheme == "file": + # Static paths don't get updated + return + vcs_backend = vcs.get_backend_for_scheme(self.link.scheme) + # Editable requirements are validated in Requirement constructors. + # So here, if it's neither a path nor a valid VCS URL, it's a bug. + assert vcs_backend, f"Unsupported VCS URL {self.link.url}" + hidden_url = hide_url(self.link.url) + vcs_backend.obtain(self.source_dir, url=hidden_url, verbosity=0) + + # Top-level Actions + def uninstall( + self, auto_confirm: bool = False, verbose: bool = False + ) -> Optional[UninstallPathSet]: + """ + Uninstall the distribution currently satisfying this requirement. + + Prompts before removing or modifying files unless + ``auto_confirm`` is True. + + Refuses to delete or modify files outside of ``sys.prefix`` - + thus uninstallation within a virtual environment can only + modify that virtual environment, even if the virtualenv is + linked to global site-packages. + + """ + assert self.req + dist = get_default_environment().get_distribution(self.req.name) + if not dist: + logger.warning("Skipping %s as it is not installed.", self.name) + return None + logger.info("Found existing installation: %s", dist) + + uninstalled_pathset = UninstallPathSet.from_dist(dist) + uninstalled_pathset.remove(auto_confirm, verbose) + return uninstalled_pathset + + def _get_archive_name(self, path: str, parentdir: str, rootdir: str) -> str: + def _clean_zip_name(name: str, prefix: str) -> str: + assert name.startswith( + prefix + os.path.sep + ), f"name {name!r} doesn't start with prefix {prefix!r}" + name = name[len(prefix) + 1 :] + name = name.replace(os.path.sep, "/") + return name + + assert self.req is not None + path = os.path.join(parentdir, path) + name = _clean_zip_name(path, rootdir) + return self.req.name + "/" + name + + def archive(self, build_dir: Optional[str]) -> None: + """Saves archive to provided build_dir. + + Used for saving downloaded VCS requirements as part of `pip download`. + """ + assert self.source_dir + if build_dir is None: + return + + create_archive = True + archive_name = "{}-{}.zip".format(self.name, self.metadata["version"]) + archive_path = os.path.join(build_dir, archive_name) + + if os.path.exists(archive_path): + response = ask_path_exists( + f"The file {display_path(archive_path)} exists. (i)gnore, (w)ipe, " + "(b)ackup, (a)bort ", + ("i", "w", "b", "a"), + ) + if response == "i": + create_archive = False + elif response == "w": + logger.warning("Deleting %s", display_path(archive_path)) + os.remove(archive_path) + elif response == "b": + dest_file = backup_dir(archive_path) + logger.warning( + "Backing up %s to %s", + display_path(archive_path), + display_path(dest_file), + ) + shutil.move(archive_path, dest_file) + elif response == "a": + sys.exit(-1) + + if not create_archive: + return + + zip_output = zipfile.ZipFile( + archive_path, + "w", + zipfile.ZIP_DEFLATED, + allowZip64=True, + ) + with zip_output: + dir = os.path.normcase(os.path.abspath(self.unpacked_source_directory)) + for dirpath, dirnames, filenames in os.walk(dir): + for dirname in dirnames: + dir_arcname = self._get_archive_name( + dirname, + parentdir=dirpath, + rootdir=dir, + ) + zipdir = zipfile.ZipInfo(dir_arcname + "/") + zipdir.external_attr = 0x1ED << 16 # 0o755 + zip_output.writestr(zipdir, "") + for filename in filenames: + file_arcname = self._get_archive_name( + filename, + parentdir=dirpath, + rootdir=dir, + ) + filename = os.path.join(dirpath, filename) + zip_output.write(filename, file_arcname) + + logger.info("Saved %s", display_path(archive_path)) + + def install( + self, + global_options: Optional[Sequence[str]] = None, + root: Optional[str] = None, + home: Optional[str] = None, + prefix: Optional[str] = None, + warn_script_location: bool = True, + use_user_site: bool = False, + pycompile: bool = True, + ) -> None: + assert self.req is not None + scheme = get_scheme( + self.req.name, + user=use_user_site, + home=home, + root=root, + isolated=self.isolated, + prefix=prefix, + ) + + if self.editable and not self.is_wheel: + deprecated( + reason=( + f"Legacy editable install of {self} (setup.py develop) " + "is deprecated." + ), + replacement=( + "to add a pyproject.toml or enable --use-pep517, " + "and use setuptools >= 64. " + "If the resulting installation is not behaving as expected, " + "try using --config-settings editable_mode=compat. " + "Please consult the setuptools documentation for more information" + ), + gone_in="25.1", + issue=11457, + ) + if self.config_settings: + logger.warning( + "--config-settings ignored for legacy editable install of %s. " + "Consider upgrading to a version of setuptools " + "that supports PEP 660 (>= 64).", + self, + ) + install_editable_legacy( + global_options=global_options if global_options is not None else [], + prefix=prefix, + home=home, + use_user_site=use_user_site, + name=self.req.name, + setup_py_path=self.setup_py_path, + isolated=self.isolated, + build_env=self.build_env, + unpacked_source_directory=self.unpacked_source_directory, + ) + self.install_succeeded = True + return + + assert self.is_wheel + assert self.local_file_path + + install_wheel( + self.req.name, + self.local_file_path, + scheme=scheme, + req_description=str(self.req), + pycompile=pycompile, + warn_script_location=warn_script_location, + direct_url=self.download_info if self.is_direct else None, + requested=self.user_supplied, + ) + self.install_succeeded = True + + +def check_invalid_constraint_type(req: InstallRequirement) -> str: + # Check for unsupported forms + problem = "" + if not req.name: + problem = "Unnamed requirements are not allowed as constraints" + elif req.editable: + problem = "Editable requirements are not allowed as constraints" + elif req.extras: + problem = "Constraints cannot have extras" + + if problem: + deprecated( + reason=( + "Constraints are only allowed to take the form of a package " + "name and a version specifier. Other forms were originally " + "permitted as an accident of the implementation, but were " + "undocumented. The new implementation of the resolver no " + "longer supports these forms." + ), + replacement="replacing the constraint with a requirement", + # No plan yet for when the new resolver becomes default + gone_in=None, + issue=8210, + ) + + return problem + + +def _has_option(options: Values, reqs: List[InstallRequirement], option: str) -> bool: + if getattr(options, option, None): + return True + for req in reqs: + if getattr(req, option, None): + return True + return False + + +def check_legacy_setup_py_options( + options: Values, + reqs: List[InstallRequirement], +) -> None: + has_build_options = _has_option(options, reqs, "build_options") + has_global_options = _has_option(options, reqs, "global_options") + if has_build_options or has_global_options: + deprecated( + reason="--build-option and --global-option are deprecated.", + issue=11859, + replacement="to use --config-settings", + gone_in=None, + ) + logger.warning( + "Implying --no-binary=:all: due to the presence of " + "--build-option / --global-option. " + ) + options.format_control.disallow_binaries() diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/req/req_set.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/req/req_set.py new file mode 100644 index 0000000..ec7a6e0 --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/req/req_set.py @@ -0,0 +1,82 @@ +import logging +from collections import OrderedDict +from typing import Dict, List + +from pip._vendor.packaging.utils import canonicalize_name + +from pip._internal.req.req_install import InstallRequirement + +logger = logging.getLogger(__name__) + + +class RequirementSet: + def __init__(self, check_supported_wheels: bool = True) -> None: + """Create a RequirementSet.""" + + self.requirements: Dict[str, InstallRequirement] = OrderedDict() + self.check_supported_wheels = check_supported_wheels + + self.unnamed_requirements: List[InstallRequirement] = [] + + def __str__(self) -> str: + requirements = sorted( + (req for req in self.requirements.values() if not req.comes_from), + key=lambda req: canonicalize_name(req.name or ""), + ) + return " ".join(str(req.req) for req in requirements) + + def __repr__(self) -> str: + requirements = sorted( + self.requirements.values(), + key=lambda req: canonicalize_name(req.name or ""), + ) + + format_string = "<{classname} object; {count} requirement(s): {reqs}>" + return format_string.format( + classname=self.__class__.__name__, + count=len(requirements), + reqs=", ".join(str(req.req) for req in requirements), + ) + + def add_unnamed_requirement(self, install_req: InstallRequirement) -> None: + assert not install_req.name + self.unnamed_requirements.append(install_req) + + def add_named_requirement(self, install_req: InstallRequirement) -> None: + assert install_req.name + + project_name = canonicalize_name(install_req.name) + self.requirements[project_name] = install_req + + def has_requirement(self, name: str) -> bool: + project_name = canonicalize_name(name) + + return ( + project_name in self.requirements + and not self.requirements[project_name].constraint + ) + + def get_requirement(self, name: str) -> InstallRequirement: + project_name = canonicalize_name(name) + + if project_name in self.requirements: + return self.requirements[project_name] + + raise KeyError(f"No project with the name {name!r}") + + @property + def all_requirements(self) -> List[InstallRequirement]: + return self.unnamed_requirements + list(self.requirements.values()) + + @property + def requirements_to_install(self) -> List[InstallRequirement]: + """Return the list of requirements that need to be installed. + + TODO remove this property together with the legacy resolver, since the new + resolver only returns requirements that need to be installed. + """ + return [ + install_req + for install_req in self.all_requirements + if not install_req.constraint and not install_req.satisfied_by + ] diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/req/req_uninstall.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/req/req_uninstall.py new file mode 100644 index 0000000..26df208 --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/req/req_uninstall.py @@ -0,0 +1,633 @@ +import functools +import os +import sys +import sysconfig +from importlib.util import cache_from_source +from typing import Any, Callable, Dict, Generator, Iterable, List, Optional, Set, Tuple + +from pip._internal.exceptions import LegacyDistutilsInstall, UninstallMissingRecord +from pip._internal.locations import get_bin_prefix, get_bin_user +from pip._internal.metadata import BaseDistribution +from pip._internal.utils.compat import WINDOWS +from pip._internal.utils.egg_link import egg_link_path_from_location +from pip._internal.utils.logging import getLogger, indent_log +from pip._internal.utils.misc import ask, normalize_path, renames, rmtree +from pip._internal.utils.temp_dir import AdjacentTempDirectory, TempDirectory +from pip._internal.utils.virtualenv import running_under_virtualenv + +logger = getLogger(__name__) + + +def _script_names( + bin_dir: str, script_name: str, is_gui: bool +) -> Generator[str, None, None]: + """Create the fully qualified name of the files created by + {console,gui}_scripts for the given ``dist``. + Returns the list of file names + """ + exe_name = os.path.join(bin_dir, script_name) + yield exe_name + if not WINDOWS: + return + yield f"{exe_name}.exe" + yield f"{exe_name}.exe.manifest" + if is_gui: + yield f"{exe_name}-script.pyw" + else: + yield f"{exe_name}-script.py" + + +def _unique( + fn: Callable[..., Generator[Any, None, None]] +) -> Callable[..., Generator[Any, None, None]]: + @functools.wraps(fn) + def unique(*args: Any, **kw: Any) -> Generator[Any, None, None]: + seen: Set[Any] = set() + for item in fn(*args, **kw): + if item not in seen: + seen.add(item) + yield item + + return unique + + +@_unique +def uninstallation_paths(dist: BaseDistribution) -> Generator[str, None, None]: + """ + Yield all the uninstallation paths for dist based on RECORD-without-.py[co] + + Yield paths to all the files in RECORD. For each .py file in RECORD, add + the .pyc and .pyo in the same directory. + + UninstallPathSet.add() takes care of the __pycache__ .py[co]. + + If RECORD is not found, raises an error, + with possible information from the INSTALLER file. + + https://packaging.python.org/specifications/recording-installed-packages/ + """ + location = dist.location + assert location is not None, "not installed" + + entries = dist.iter_declared_entries() + if entries is None: + raise UninstallMissingRecord(distribution=dist) + + for entry in entries: + path = os.path.join(location, entry) + yield path + if path.endswith(".py"): + dn, fn = os.path.split(path) + base = fn[:-3] + path = os.path.join(dn, base + ".pyc") + yield path + path = os.path.join(dn, base + ".pyo") + yield path + + +def compact(paths: Iterable[str]) -> Set[str]: + """Compact a path set to contain the minimal number of paths + necessary to contain all paths in the set. If /a/path/ and + /a/path/to/a/file.txt are both in the set, leave only the + shorter path.""" + + sep = os.path.sep + short_paths: Set[str] = set() + for path in sorted(paths, key=len): + should_skip = any( + path.startswith(shortpath.rstrip("*")) + and path[len(shortpath.rstrip("*").rstrip(sep))] == sep + for shortpath in short_paths + ) + if not should_skip: + short_paths.add(path) + return short_paths + + +def compress_for_rename(paths: Iterable[str]) -> Set[str]: + """Returns a set containing the paths that need to be renamed. + + This set may include directories when the original sequence of paths + included every file on disk. + """ + case_map = {os.path.normcase(p): p for p in paths} + remaining = set(case_map) + unchecked = sorted({os.path.split(p)[0] for p in case_map.values()}, key=len) + wildcards: Set[str] = set() + + def norm_join(*a: str) -> str: + return os.path.normcase(os.path.join(*a)) + + for root in unchecked: + if any(os.path.normcase(root).startswith(w) for w in wildcards): + # This directory has already been handled. + continue + + all_files: Set[str] = set() + all_subdirs: Set[str] = set() + for dirname, subdirs, files in os.walk(root): + all_subdirs.update(norm_join(root, dirname, d) for d in subdirs) + all_files.update(norm_join(root, dirname, f) for f in files) + # If all the files we found are in our remaining set of files to + # remove, then remove them from the latter set and add a wildcard + # for the directory. + if not (all_files - remaining): + remaining.difference_update(all_files) + wildcards.add(root + os.sep) + + return set(map(case_map.__getitem__, remaining)) | wildcards + + +def compress_for_output_listing(paths: Iterable[str]) -> Tuple[Set[str], Set[str]]: + """Returns a tuple of 2 sets of which paths to display to user + + The first set contains paths that would be deleted. Files of a package + are not added and the top-level directory of the package has a '*' added + at the end - to signify that all it's contents are removed. + + The second set contains files that would have been skipped in the above + folders. + """ + + will_remove = set(paths) + will_skip = set() + + # Determine folders and files + folders = set() + files = set() + for path in will_remove: + if path.endswith(".pyc"): + continue + if path.endswith("__init__.py") or ".dist-info" in path: + folders.add(os.path.dirname(path)) + files.add(path) + + _normcased_files = set(map(os.path.normcase, files)) + + folders = compact(folders) + + # This walks the tree using os.walk to not miss extra folders + # that might get added. + for folder in folders: + for dirpath, _, dirfiles in os.walk(folder): + for fname in dirfiles: + if fname.endswith(".pyc"): + continue + + file_ = os.path.join(dirpath, fname) + if ( + os.path.isfile(file_) + and os.path.normcase(file_) not in _normcased_files + ): + # We are skipping this file. Add it to the set. + will_skip.add(file_) + + will_remove = files | {os.path.join(folder, "*") for folder in folders} + + return will_remove, will_skip + + +class StashedUninstallPathSet: + """A set of file rename operations to stash files while + tentatively uninstalling them.""" + + def __init__(self) -> None: + # Mapping from source file root to [Adjacent]TempDirectory + # for files under that directory. + self._save_dirs: Dict[str, TempDirectory] = {} + # (old path, new path) tuples for each move that may need + # to be undone. + self._moves: List[Tuple[str, str]] = [] + + def _get_directory_stash(self, path: str) -> str: + """Stashes a directory. + + Directories are stashed adjacent to their original location if + possible, or else moved/copied into the user's temp dir.""" + + try: + save_dir: TempDirectory = AdjacentTempDirectory(path) + except OSError: + save_dir = TempDirectory(kind="uninstall") + self._save_dirs[os.path.normcase(path)] = save_dir + + return save_dir.path + + def _get_file_stash(self, path: str) -> str: + """Stashes a file. + + If no root has been provided, one will be created for the directory + in the user's temp directory.""" + path = os.path.normcase(path) + head, old_head = os.path.dirname(path), None + save_dir = None + + while head != old_head: + try: + save_dir = self._save_dirs[head] + break + except KeyError: + pass + head, old_head = os.path.dirname(head), head + else: + # Did not find any suitable root + head = os.path.dirname(path) + save_dir = TempDirectory(kind="uninstall") + self._save_dirs[head] = save_dir + + relpath = os.path.relpath(path, head) + if relpath and relpath != os.path.curdir: + return os.path.join(save_dir.path, relpath) + return save_dir.path + + def stash(self, path: str) -> str: + """Stashes the directory or file and returns its new location. + Handle symlinks as files to avoid modifying the symlink targets. + """ + path_is_dir = os.path.isdir(path) and not os.path.islink(path) + if path_is_dir: + new_path = self._get_directory_stash(path) + else: + new_path = self._get_file_stash(path) + + self._moves.append((path, new_path)) + if path_is_dir and os.path.isdir(new_path): + # If we're moving a directory, we need to + # remove the destination first or else it will be + # moved to inside the existing directory. + # We just created new_path ourselves, so it will + # be removable. + os.rmdir(new_path) + renames(path, new_path) + return new_path + + def commit(self) -> None: + """Commits the uninstall by removing stashed files.""" + for save_dir in self._save_dirs.values(): + save_dir.cleanup() + self._moves = [] + self._save_dirs = {} + + def rollback(self) -> None: + """Undoes the uninstall by moving stashed files back.""" + for p in self._moves: + logger.info("Moving to %s\n from %s", *p) + + for new_path, path in self._moves: + try: + logger.debug("Replacing %s from %s", new_path, path) + if os.path.isfile(new_path) or os.path.islink(new_path): + os.unlink(new_path) + elif os.path.isdir(new_path): + rmtree(new_path) + renames(path, new_path) + except OSError as ex: + logger.error("Failed to restore %s", new_path) + logger.debug("Exception: %s", ex) + + self.commit() + + @property + def can_rollback(self) -> bool: + return bool(self._moves) + + +class UninstallPathSet: + """A set of file paths to be removed in the uninstallation of a + requirement.""" + + def __init__(self, dist: BaseDistribution) -> None: + self._paths: Set[str] = set() + self._refuse: Set[str] = set() + self._pth: Dict[str, UninstallPthEntries] = {} + self._dist = dist + self._moved_paths = StashedUninstallPathSet() + # Create local cache of normalize_path results. Creating an UninstallPathSet + # can result in hundreds/thousands of redundant calls to normalize_path with + # the same args, which hurts performance. + self._normalize_path_cached = functools.lru_cache(normalize_path) + + def _permitted(self, path: str) -> bool: + """ + Return True if the given path is one we are permitted to + remove/modify, False otherwise. + + """ + # aka is_local, but caching normalized sys.prefix + if not running_under_virtualenv(): + return True + return path.startswith(self._normalize_path_cached(sys.prefix)) + + def add(self, path: str) -> None: + head, tail = os.path.split(path) + + # we normalize the head to resolve parent directory symlinks, but not + # the tail, since we only want to uninstall symlinks, not their targets + path = os.path.join(self._normalize_path_cached(head), os.path.normcase(tail)) + + if not os.path.exists(path): + return + if self._permitted(path): + self._paths.add(path) + else: + self._refuse.add(path) + + # __pycache__ files can show up after 'installed-files.txt' is created, + # due to imports + if os.path.splitext(path)[1] == ".py": + self.add(cache_from_source(path)) + + def add_pth(self, pth_file: str, entry: str) -> None: + pth_file = self._normalize_path_cached(pth_file) + if self._permitted(pth_file): + if pth_file not in self._pth: + self._pth[pth_file] = UninstallPthEntries(pth_file) + self._pth[pth_file].add(entry) + else: + self._refuse.add(pth_file) + + def remove(self, auto_confirm: bool = False, verbose: bool = False) -> None: + """Remove paths in ``self._paths`` with confirmation (unless + ``auto_confirm`` is True).""" + + if not self._paths: + logger.info( + "Can't uninstall '%s'. No files were found to uninstall.", + self._dist.raw_name, + ) + return + + dist_name_version = f"{self._dist.raw_name}-{self._dist.raw_version}" + logger.info("Uninstalling %s:", dist_name_version) + + with indent_log(): + if auto_confirm or self._allowed_to_proceed(verbose): + moved = self._moved_paths + + for_rename = compress_for_rename(self._paths) + + for path in sorted(compact(for_rename)): + moved.stash(path) + logger.verbose("Removing file or directory %s", path) + + for pth in self._pth.values(): + pth.remove() + + logger.info("Successfully uninstalled %s", dist_name_version) + + def _allowed_to_proceed(self, verbose: bool) -> bool: + """Display which files would be deleted and prompt for confirmation""" + + def _display(msg: str, paths: Iterable[str]) -> None: + if not paths: + return + + logger.info(msg) + with indent_log(): + for path in sorted(compact(paths)): + logger.info(path) + + if not verbose: + will_remove, will_skip = compress_for_output_listing(self._paths) + else: + # In verbose mode, display all the files that are going to be + # deleted. + will_remove = set(self._paths) + will_skip = set() + + _display("Would remove:", will_remove) + _display("Would not remove (might be manually added):", will_skip) + _display("Would not remove (outside of prefix):", self._refuse) + if verbose: + _display("Will actually move:", compress_for_rename(self._paths)) + + return ask("Proceed (Y/n)? ", ("y", "n", "")) != "n" + + def rollback(self) -> None: + """Rollback the changes previously made by remove().""" + if not self._moved_paths.can_rollback: + logger.error( + "Can't roll back %s; was not uninstalled", + self._dist.raw_name, + ) + return + logger.info("Rolling back uninstall of %s", self._dist.raw_name) + self._moved_paths.rollback() + for pth in self._pth.values(): + pth.rollback() + + def commit(self) -> None: + """Remove temporary save dir: rollback will no longer be possible.""" + self._moved_paths.commit() + + @classmethod + def from_dist(cls, dist: BaseDistribution) -> "UninstallPathSet": + dist_location = dist.location + info_location = dist.info_location + if dist_location is None: + logger.info( + "Not uninstalling %s since it is not installed", + dist.canonical_name, + ) + return cls(dist) + + normalized_dist_location = normalize_path(dist_location) + if not dist.local: + logger.info( + "Not uninstalling %s at %s, outside environment %s", + dist.canonical_name, + normalized_dist_location, + sys.prefix, + ) + return cls(dist) + + if normalized_dist_location in { + p + for p in {sysconfig.get_path("stdlib"), sysconfig.get_path("platstdlib")} + if p + }: + logger.info( + "Not uninstalling %s at %s, as it is in the standard library.", + dist.canonical_name, + normalized_dist_location, + ) + return cls(dist) + + paths_to_remove = cls(dist) + develop_egg_link = egg_link_path_from_location(dist.raw_name) + + # Distribution is installed with metadata in a "flat" .egg-info + # directory. This means it is not a modern .dist-info installation, an + # egg, or legacy editable. + setuptools_flat_installation = ( + dist.installed_with_setuptools_egg_info + and info_location is not None + and os.path.exists(info_location) + # If dist is editable and the location points to a ``.egg-info``, + # we are in fact in the legacy editable case. + and not info_location.endswith(f"{dist.setuptools_filename}.egg-info") + ) + + # Uninstall cases order do matter as in the case of 2 installs of the + # same package, pip needs to uninstall the currently detected version + if setuptools_flat_installation: + if info_location is not None: + paths_to_remove.add(info_location) + installed_files = dist.iter_declared_entries() + if installed_files is not None: + for installed_file in installed_files: + paths_to_remove.add(os.path.join(dist_location, installed_file)) + # FIXME: need a test for this elif block + # occurs with --single-version-externally-managed/--record outside + # of pip + elif dist.is_file("top_level.txt"): + try: + namespace_packages = dist.read_text("namespace_packages.txt") + except FileNotFoundError: + namespaces = [] + else: + namespaces = namespace_packages.splitlines(keepends=False) + for top_level_pkg in [ + p + for p in dist.read_text("top_level.txt").splitlines() + if p and p not in namespaces + ]: + path = os.path.join(dist_location, top_level_pkg) + paths_to_remove.add(path) + paths_to_remove.add(f"{path}.py") + paths_to_remove.add(f"{path}.pyc") + paths_to_remove.add(f"{path}.pyo") + + elif dist.installed_by_distutils: + raise LegacyDistutilsInstall(distribution=dist) + + elif dist.installed_as_egg: + # package installed by easy_install + # We cannot match on dist.egg_name because it can slightly vary + # i.e. setuptools-0.6c11-py2.6.egg vs setuptools-0.6rc11-py2.6.egg + paths_to_remove.add(dist_location) + easy_install_egg = os.path.split(dist_location)[1] + easy_install_pth = os.path.join( + os.path.dirname(dist_location), + "easy-install.pth", + ) + paths_to_remove.add_pth(easy_install_pth, "./" + easy_install_egg) + + elif dist.installed_with_dist_info: + for path in uninstallation_paths(dist): + paths_to_remove.add(path) + + elif develop_egg_link: + # PEP 660 modern editable is handled in the ``.dist-info`` case + # above, so this only covers the setuptools-style editable. + with open(develop_egg_link) as fh: + link_pointer = os.path.normcase(fh.readline().strip()) + normalized_link_pointer = paths_to_remove._normalize_path_cached( + link_pointer + ) + assert os.path.samefile( + normalized_link_pointer, normalized_dist_location + ), ( + f"Egg-link {develop_egg_link} (to {link_pointer}) does not match " + f"installed location of {dist.raw_name} (at {dist_location})" + ) + paths_to_remove.add(develop_egg_link) + easy_install_pth = os.path.join( + os.path.dirname(develop_egg_link), "easy-install.pth" + ) + paths_to_remove.add_pth(easy_install_pth, dist_location) + + else: + logger.debug( + "Not sure how to uninstall: %s - Check: %s", + dist, + dist_location, + ) + + if dist.in_usersite: + bin_dir = get_bin_user() + else: + bin_dir = get_bin_prefix() + + # find distutils scripts= scripts + try: + for script in dist.iter_distutils_script_names(): + paths_to_remove.add(os.path.join(bin_dir, script)) + if WINDOWS: + paths_to_remove.add(os.path.join(bin_dir, f"{script}.bat")) + except (FileNotFoundError, NotADirectoryError): + pass + + # find console_scripts and gui_scripts + def iter_scripts_to_remove( + dist: BaseDistribution, + bin_dir: str, + ) -> Generator[str, None, None]: + for entry_point in dist.iter_entry_points(): + if entry_point.group == "console_scripts": + yield from _script_names(bin_dir, entry_point.name, False) + elif entry_point.group == "gui_scripts": + yield from _script_names(bin_dir, entry_point.name, True) + + for s in iter_scripts_to_remove(dist, bin_dir): + paths_to_remove.add(s) + + return paths_to_remove + + +class UninstallPthEntries: + def __init__(self, pth_file: str) -> None: + self.file = pth_file + self.entries: Set[str] = set() + self._saved_lines: Optional[List[bytes]] = None + + def add(self, entry: str) -> None: + entry = os.path.normcase(entry) + # On Windows, os.path.normcase converts the entry to use + # backslashes. This is correct for entries that describe absolute + # paths outside of site-packages, but all the others use forward + # slashes. + # os.path.splitdrive is used instead of os.path.isabs because isabs + # treats non-absolute paths with drive letter markings like c:foo\bar + # as absolute paths. It also does not recognize UNC paths if they don't + # have more than "\\sever\share". Valid examples: "\\server\share\" or + # "\\server\share\folder". + if WINDOWS and not os.path.splitdrive(entry)[0]: + entry = entry.replace("\\", "/") + self.entries.add(entry) + + def remove(self) -> None: + logger.verbose("Removing pth entries from %s:", self.file) + + # If the file doesn't exist, log a warning and return + if not os.path.isfile(self.file): + logger.warning("Cannot remove entries from nonexistent file %s", self.file) + return + with open(self.file, "rb") as fh: + # windows uses '\r\n' with py3k, but uses '\n' with py2.x + lines = fh.readlines() + self._saved_lines = lines + if any(b"\r\n" in line for line in lines): + endline = "\r\n" + else: + endline = "\n" + # handle missing trailing newline + if lines and not lines[-1].endswith(endline.encode("utf-8")): + lines[-1] = lines[-1] + endline.encode("utf-8") + for entry in self.entries: + try: + logger.verbose("Removing entry: %s", entry) + lines.remove((entry + endline).encode("utf-8")) + except ValueError: + pass + with open(self.file, "wb") as fh: + fh.writelines(lines) + + def rollback(self) -> bool: + if self._saved_lines is None: + logger.error("Cannot roll back changes to %s, none were made", self.file) + return False + logger.debug("Rolling %s back to previous state", self.file) + with open(self.file, "wb") as fh: + fh.writelines(self._saved_lines) + return True diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/resolution/__init__.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/resolution/__init__.py new file mode 100644 index 0000000..e69de29 diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/resolution/__pycache__/__init__.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/resolution/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000..442d76d Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/resolution/__pycache__/__init__.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/resolution/__pycache__/base.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/resolution/__pycache__/base.cpython-312.pyc new file mode 100644 index 0000000..ee84b3b Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/resolution/__pycache__/base.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/resolution/base.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/resolution/base.py new file mode 100644 index 0000000..42dade1 --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/resolution/base.py @@ -0,0 +1,20 @@ +from typing import Callable, List, Optional + +from pip._internal.req.req_install import InstallRequirement +from pip._internal.req.req_set import RequirementSet + +InstallRequirementProvider = Callable[ + [str, Optional[InstallRequirement]], InstallRequirement +] + + +class BaseResolver: + def resolve( + self, root_reqs: List[InstallRequirement], check_supported_wheels: bool + ) -> RequirementSet: + raise NotImplementedError() + + def get_installation_order( + self, req_set: RequirementSet + ) -> List[InstallRequirement]: + raise NotImplementedError() diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/resolution/legacy/__init__.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/resolution/legacy/__init__.py new file mode 100644 index 0000000..e69de29 diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/resolution/legacy/__pycache__/__init__.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/resolution/legacy/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000..1bf6abf Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/resolution/legacy/__pycache__/__init__.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/resolution/legacy/__pycache__/resolver.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/resolution/legacy/__pycache__/resolver.cpython-312.pyc new file mode 100644 index 0000000..735db94 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/resolution/legacy/__pycache__/resolver.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/resolution/legacy/resolver.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/resolution/legacy/resolver.py new file mode 100644 index 0000000..1dd0d70 --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/resolution/legacy/resolver.py @@ -0,0 +1,597 @@ +"""Dependency Resolution + +The dependency resolution in pip is performed as follows: + +for top-level requirements: + a. only one spec allowed per project, regardless of conflicts or not. + otherwise a "double requirement" exception is raised + b. they override sub-dependency requirements. +for sub-dependencies + a. "first found, wins" (where the order is breadth first) +""" + +import logging +import sys +from collections import defaultdict +from itertools import chain +from typing import DefaultDict, Iterable, List, Optional, Set, Tuple + +from pip._vendor.packaging import specifiers +from pip._vendor.packaging.requirements import Requirement + +from pip._internal.cache import WheelCache +from pip._internal.exceptions import ( + BestVersionAlreadyInstalled, + DistributionNotFound, + HashError, + HashErrors, + InstallationError, + NoneMetadataError, + UnsupportedPythonVersion, +) +from pip._internal.index.package_finder import PackageFinder +from pip._internal.metadata import BaseDistribution +from pip._internal.models.link import Link +from pip._internal.models.wheel import Wheel +from pip._internal.operations.prepare import RequirementPreparer +from pip._internal.req.req_install import ( + InstallRequirement, + check_invalid_constraint_type, +) +from pip._internal.req.req_set import RequirementSet +from pip._internal.resolution.base import BaseResolver, InstallRequirementProvider +from pip._internal.utils import compatibility_tags +from pip._internal.utils.compatibility_tags import get_supported +from pip._internal.utils.direct_url_helpers import direct_url_from_link +from pip._internal.utils.logging import indent_log +from pip._internal.utils.misc import normalize_version_info +from pip._internal.utils.packaging import check_requires_python + +logger = logging.getLogger(__name__) + +DiscoveredDependencies = DefaultDict[Optional[str], List[InstallRequirement]] + + +def _check_dist_requires_python( + dist: BaseDistribution, + version_info: Tuple[int, int, int], + ignore_requires_python: bool = False, +) -> None: + """ + Check whether the given Python version is compatible with a distribution's + "Requires-Python" value. + + :param version_info: A 3-tuple of ints representing the Python + major-minor-micro version to check. + :param ignore_requires_python: Whether to ignore the "Requires-Python" + value if the given Python version isn't compatible. + + :raises UnsupportedPythonVersion: When the given Python version isn't + compatible. + """ + # This idiosyncratically converts the SpecifierSet to str and let + # check_requires_python then parse it again into SpecifierSet. But this + # is the legacy resolver so I'm just not going to bother refactoring. + try: + requires_python = str(dist.requires_python) + except FileNotFoundError as e: + raise NoneMetadataError(dist, str(e)) + try: + is_compatible = check_requires_python( + requires_python, + version_info=version_info, + ) + except specifiers.InvalidSpecifier as exc: + logger.warning( + "Package %r has an invalid Requires-Python: %s", dist.raw_name, exc + ) + return + + if is_compatible: + return + + version = ".".join(map(str, version_info)) + if ignore_requires_python: + logger.debug( + "Ignoring failed Requires-Python check for package %r: %s not in %r", + dist.raw_name, + version, + requires_python, + ) + return + + raise UnsupportedPythonVersion( + f"Package {dist.raw_name!r} requires a different Python: " + f"{version} not in {requires_python!r}" + ) + + +class Resolver(BaseResolver): + """Resolves which packages need to be installed/uninstalled to perform \ + the requested operation without breaking the requirements of any package. + """ + + _allowed_strategies = {"eager", "only-if-needed", "to-satisfy-only"} + + def __init__( + self, + preparer: RequirementPreparer, + finder: PackageFinder, + wheel_cache: Optional[WheelCache], + make_install_req: InstallRequirementProvider, + use_user_site: bool, + ignore_dependencies: bool, + ignore_installed: bool, + ignore_requires_python: bool, + force_reinstall: bool, + upgrade_strategy: str, + py_version_info: Optional[Tuple[int, ...]] = None, + ) -> None: + super().__init__() + assert upgrade_strategy in self._allowed_strategies + + if py_version_info is None: + py_version_info = sys.version_info[:3] + else: + py_version_info = normalize_version_info(py_version_info) + + self._py_version_info = py_version_info + + self.preparer = preparer + self.finder = finder + self.wheel_cache = wheel_cache + + self.upgrade_strategy = upgrade_strategy + self.force_reinstall = force_reinstall + self.ignore_dependencies = ignore_dependencies + self.ignore_installed = ignore_installed + self.ignore_requires_python = ignore_requires_python + self.use_user_site = use_user_site + self._make_install_req = make_install_req + + self._discovered_dependencies: DiscoveredDependencies = defaultdict(list) + + def resolve( + self, root_reqs: List[InstallRequirement], check_supported_wheels: bool + ) -> RequirementSet: + """Resolve what operations need to be done + + As a side-effect of this method, the packages (and their dependencies) + are downloaded, unpacked and prepared for installation. This + preparation is done by ``pip.operations.prepare``. + + Once PyPI has static dependency metadata available, it would be + possible to move the preparation to become a step separated from + dependency resolution. + """ + requirement_set = RequirementSet(check_supported_wheels=check_supported_wheels) + for req in root_reqs: + if req.constraint: + check_invalid_constraint_type(req) + self._add_requirement_to_set(requirement_set, req) + + # Actually prepare the files, and collect any exceptions. Most hash + # exceptions cannot be checked ahead of time, because + # _populate_link() needs to be called before we can make decisions + # based on link type. + discovered_reqs: List[InstallRequirement] = [] + hash_errors = HashErrors() + for req in chain(requirement_set.all_requirements, discovered_reqs): + try: + discovered_reqs.extend(self._resolve_one(requirement_set, req)) + except HashError as exc: + exc.req = req + hash_errors.append(exc) + + if hash_errors: + raise hash_errors + + return requirement_set + + def _add_requirement_to_set( + self, + requirement_set: RequirementSet, + install_req: InstallRequirement, + parent_req_name: Optional[str] = None, + extras_requested: Optional[Iterable[str]] = None, + ) -> Tuple[List[InstallRequirement], Optional[InstallRequirement]]: + """Add install_req as a requirement to install. + + :param parent_req_name: The name of the requirement that needed this + added. The name is used because when multiple unnamed requirements + resolve to the same name, we could otherwise end up with dependency + links that point outside the Requirements set. parent_req must + already be added. Note that None implies that this is a user + supplied requirement, vs an inferred one. + :param extras_requested: an iterable of extras used to evaluate the + environment markers. + :return: Additional requirements to scan. That is either [] if + the requirement is not applicable, or [install_req] if the + requirement is applicable and has just been added. + """ + # If the markers do not match, ignore this requirement. + if not install_req.match_markers(extras_requested): + logger.info( + "Ignoring %s: markers '%s' don't match your environment", + install_req.name, + install_req.markers, + ) + return [], None + + # If the wheel is not supported, raise an error. + # Should check this after filtering out based on environment markers to + # allow specifying different wheels based on the environment/OS, in a + # single requirements file. + if install_req.link and install_req.link.is_wheel: + wheel = Wheel(install_req.link.filename) + tags = compatibility_tags.get_supported() + if requirement_set.check_supported_wheels and not wheel.supported(tags): + raise InstallationError( + f"{wheel.filename} is not a supported wheel on this platform." + ) + + # This next bit is really a sanity check. + assert ( + not install_req.user_supplied or parent_req_name is None + ), "a user supplied req shouldn't have a parent" + + # Unnamed requirements are scanned again and the requirement won't be + # added as a dependency until after scanning. + if not install_req.name: + requirement_set.add_unnamed_requirement(install_req) + return [install_req], None + + try: + existing_req: Optional[InstallRequirement] = ( + requirement_set.get_requirement(install_req.name) + ) + except KeyError: + existing_req = None + + has_conflicting_requirement = ( + parent_req_name is None + and existing_req + and not existing_req.constraint + and existing_req.extras == install_req.extras + and existing_req.req + and install_req.req + and existing_req.req.specifier != install_req.req.specifier + ) + if has_conflicting_requirement: + raise InstallationError( + f"Double requirement given: {install_req} " + f"(already in {existing_req}, name={install_req.name!r})" + ) + + # When no existing requirement exists, add the requirement as a + # dependency and it will be scanned again after. + if not existing_req: + requirement_set.add_named_requirement(install_req) + # We'd want to rescan this requirement later + return [install_req], install_req + + # Assume there's no need to scan, and that we've already + # encountered this for scanning. + if install_req.constraint or not existing_req.constraint: + return [], existing_req + + does_not_satisfy_constraint = install_req.link and not ( + existing_req.link and install_req.link.path == existing_req.link.path + ) + if does_not_satisfy_constraint: + raise InstallationError( + f"Could not satisfy constraints for '{install_req.name}': " + "installation from path or url cannot be " + "constrained to a version" + ) + # If we're now installing a constraint, mark the existing + # object for real installation. + existing_req.constraint = False + # If we're now installing a user supplied requirement, + # mark the existing object as such. + if install_req.user_supplied: + existing_req.user_supplied = True + existing_req.extras = tuple( + sorted(set(existing_req.extras) | set(install_req.extras)) + ) + logger.debug( + "Setting %s extras to: %s", + existing_req, + existing_req.extras, + ) + # Return the existing requirement for addition to the parent and + # scanning again. + return [existing_req], existing_req + + def _is_upgrade_allowed(self, req: InstallRequirement) -> bool: + if self.upgrade_strategy == "to-satisfy-only": + return False + elif self.upgrade_strategy == "eager": + return True + else: + assert self.upgrade_strategy == "only-if-needed" + return req.user_supplied or req.constraint + + def _set_req_to_reinstall(self, req: InstallRequirement) -> None: + """ + Set a requirement to be installed. + """ + # Don't uninstall the conflict if doing a user install and the + # conflict is not a user install. + assert req.satisfied_by is not None + if not self.use_user_site or req.satisfied_by.in_usersite: + req.should_reinstall = True + req.satisfied_by = None + + def _check_skip_installed( + self, req_to_install: InstallRequirement + ) -> Optional[str]: + """Check if req_to_install should be skipped. + + This will check if the req is installed, and whether we should upgrade + or reinstall it, taking into account all the relevant user options. + + After calling this req_to_install will only have satisfied_by set to + None if the req_to_install is to be upgraded/reinstalled etc. Any + other value will be a dist recording the current thing installed that + satisfies the requirement. + + Note that for vcs urls and the like we can't assess skipping in this + routine - we simply identify that we need to pull the thing down, + then later on it is pulled down and introspected to assess upgrade/ + reinstalls etc. + + :return: A text reason for why it was skipped, or None. + """ + if self.ignore_installed: + return None + + req_to_install.check_if_exists(self.use_user_site) + if not req_to_install.satisfied_by: + return None + + if self.force_reinstall: + self._set_req_to_reinstall(req_to_install) + return None + + if not self._is_upgrade_allowed(req_to_install): + if self.upgrade_strategy == "only-if-needed": + return "already satisfied, skipping upgrade" + return "already satisfied" + + # Check for the possibility of an upgrade. For link-based + # requirements we have to pull the tree down and inspect to assess + # the version #, so it's handled way down. + if not req_to_install.link: + try: + self.finder.find_requirement(req_to_install, upgrade=True) + except BestVersionAlreadyInstalled: + # Then the best version is installed. + return "already up-to-date" + except DistributionNotFound: + # No distribution found, so we squash the error. It will + # be raised later when we re-try later to do the install. + # Why don't we just raise here? + pass + + self._set_req_to_reinstall(req_to_install) + return None + + def _find_requirement_link(self, req: InstallRequirement) -> Optional[Link]: + upgrade = self._is_upgrade_allowed(req) + best_candidate = self.finder.find_requirement(req, upgrade) + if not best_candidate: + return None + + # Log a warning per PEP 592 if necessary before returning. + link = best_candidate.link + if link.is_yanked: + reason = link.yanked_reason or "" + msg = ( + # Mark this as a unicode string to prevent + # "UnicodeEncodeError: 'ascii' codec can't encode character" + # in Python 2 when the reason contains non-ascii characters. + "The candidate selected for download or install is a " + f"yanked version: {best_candidate}\n" + f"Reason for being yanked: {reason}" + ) + logger.warning(msg) + + return link + + def _populate_link(self, req: InstallRequirement) -> None: + """Ensure that if a link can be found for this, that it is found. + + Note that req.link may still be None - if the requirement is already + installed and not needed to be upgraded based on the return value of + _is_upgrade_allowed(). + + If preparer.require_hashes is True, don't use the wheel cache, because + cached wheels, always built locally, have different hashes than the + files downloaded from the index server and thus throw false hash + mismatches. Furthermore, cached wheels at present have undeterministic + contents due to file modification times. + """ + if req.link is None: + req.link = self._find_requirement_link(req) + + if self.wheel_cache is None or self.preparer.require_hashes: + return + + assert req.link is not None, "_find_requirement_link unexpectedly returned None" + cache_entry = self.wheel_cache.get_cache_entry( + link=req.link, + package_name=req.name, + supported_tags=get_supported(), + ) + if cache_entry is not None: + logger.debug("Using cached wheel link: %s", cache_entry.link) + if req.link is req.original_link and cache_entry.persistent: + req.cached_wheel_source_link = req.link + if cache_entry.origin is not None: + req.download_info = cache_entry.origin + else: + # Legacy cache entry that does not have origin.json. + # download_info may miss the archive_info.hashes field. + req.download_info = direct_url_from_link( + req.link, link_is_in_wheel_cache=cache_entry.persistent + ) + req.link = cache_entry.link + + def _get_dist_for(self, req: InstallRequirement) -> BaseDistribution: + """Takes a InstallRequirement and returns a single AbstractDist \ + representing a prepared variant of the same. + """ + if req.editable: + return self.preparer.prepare_editable_requirement(req) + + # satisfied_by is only evaluated by calling _check_skip_installed, + # so it must be None here. + assert req.satisfied_by is None + skip_reason = self._check_skip_installed(req) + + if req.satisfied_by: + return self.preparer.prepare_installed_requirement(req, skip_reason) + + # We eagerly populate the link, since that's our "legacy" behavior. + self._populate_link(req) + dist = self.preparer.prepare_linked_requirement(req) + + # NOTE + # The following portion is for determining if a certain package is + # going to be re-installed/upgraded or not and reporting to the user. + # This should probably get cleaned up in a future refactor. + + # req.req is only avail after unpack for URL + # pkgs repeat check_if_exists to uninstall-on-upgrade + # (#14) + if not self.ignore_installed: + req.check_if_exists(self.use_user_site) + + if req.satisfied_by: + should_modify = ( + self.upgrade_strategy != "to-satisfy-only" + or self.force_reinstall + or self.ignore_installed + or req.link.scheme == "file" + ) + if should_modify: + self._set_req_to_reinstall(req) + else: + logger.info( + "Requirement already satisfied (use --upgrade to upgrade): %s", + req, + ) + return dist + + def _resolve_one( + self, + requirement_set: RequirementSet, + req_to_install: InstallRequirement, + ) -> List[InstallRequirement]: + """Prepare a single requirements file. + + :return: A list of additional InstallRequirements to also install. + """ + # Tell user what we are doing for this requirement: + # obtain (editable), skipping, processing (local url), collecting + # (remote url or package name) + if req_to_install.constraint or req_to_install.prepared: + return [] + + req_to_install.prepared = True + + # Parse and return dependencies + dist = self._get_dist_for(req_to_install) + # This will raise UnsupportedPythonVersion if the given Python + # version isn't compatible with the distribution's Requires-Python. + _check_dist_requires_python( + dist, + version_info=self._py_version_info, + ignore_requires_python=self.ignore_requires_python, + ) + + more_reqs: List[InstallRequirement] = [] + + def add_req(subreq: Requirement, extras_requested: Iterable[str]) -> None: + # This idiosyncratically converts the Requirement to str and let + # make_install_req then parse it again into Requirement. But this is + # the legacy resolver so I'm just not going to bother refactoring. + sub_install_req = self._make_install_req(str(subreq), req_to_install) + parent_req_name = req_to_install.name + to_scan_again, add_to_parent = self._add_requirement_to_set( + requirement_set, + sub_install_req, + parent_req_name=parent_req_name, + extras_requested=extras_requested, + ) + if parent_req_name and add_to_parent: + self._discovered_dependencies[parent_req_name].append(add_to_parent) + more_reqs.extend(to_scan_again) + + with indent_log(): + # We add req_to_install before its dependencies, so that we + # can refer to it when adding dependencies. + assert req_to_install.name is not None + if not requirement_set.has_requirement(req_to_install.name): + # 'unnamed' requirements will get added here + # 'unnamed' requirements can only come from being directly + # provided by the user. + assert req_to_install.user_supplied + self._add_requirement_to_set( + requirement_set, req_to_install, parent_req_name=None + ) + + if not self.ignore_dependencies: + if req_to_install.extras: + logger.debug( + "Installing extra requirements: %r", + ",".join(req_to_install.extras), + ) + missing_requested = sorted( + set(req_to_install.extras) - set(dist.iter_provided_extras()) + ) + for missing in missing_requested: + logger.warning( + "%s %s does not provide the extra '%s'", + dist.raw_name, + dist.version, + missing, + ) + + available_requested = sorted( + set(dist.iter_provided_extras()) & set(req_to_install.extras) + ) + for subreq in dist.iter_dependencies(available_requested): + add_req(subreq, extras_requested=available_requested) + + return more_reqs + + def get_installation_order( + self, req_set: RequirementSet + ) -> List[InstallRequirement]: + """Create the installation order. + + The installation order is topological - requirements are installed + before the requiring thing. We break cycles at an arbitrary point, + and make no other guarantees. + """ + # The current implementation, which we may change at any point + # installs the user specified things in the order given, except when + # dependencies must come earlier to achieve topological order. + order = [] + ordered_reqs: Set[InstallRequirement] = set() + + def schedule(req: InstallRequirement) -> None: + if req.satisfied_by or req in ordered_reqs: + return + if req.constraint: + return + ordered_reqs.add(req) + for dep in self._discovered_dependencies[req.name]: + schedule(dep) + order.append(req) + + for install_req in req_set.requirements.values(): + schedule(install_req) + return order diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/__init__.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/__init__.py new file mode 100644 index 0000000..e69de29 diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/__pycache__/__init__.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000..a10efd3 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/__pycache__/__init__.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/__pycache__/base.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/__pycache__/base.cpython-312.pyc new file mode 100644 index 0000000..fb7ca47 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/__pycache__/base.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/__pycache__/candidates.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/__pycache__/candidates.cpython-312.pyc new file mode 100644 index 0000000..b9e49e1 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/__pycache__/candidates.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/__pycache__/factory.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/__pycache__/factory.cpython-312.pyc new file mode 100644 index 0000000..55e5542 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/__pycache__/factory.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/__pycache__/found_candidates.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/__pycache__/found_candidates.cpython-312.pyc new file mode 100644 index 0000000..24f2c78 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/__pycache__/found_candidates.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/__pycache__/provider.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/__pycache__/provider.cpython-312.pyc new file mode 100644 index 0000000..9cce357 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/__pycache__/provider.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/__pycache__/reporter.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/__pycache__/reporter.cpython-312.pyc new file mode 100644 index 0000000..973ff53 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/__pycache__/reporter.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/__pycache__/requirements.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/__pycache__/requirements.cpython-312.pyc new file mode 100644 index 0000000..b0023ca Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/__pycache__/requirements.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/__pycache__/resolver.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/__pycache__/resolver.cpython-312.pyc new file mode 100644 index 0000000..6213fb6 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/__pycache__/resolver.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/base.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/base.py new file mode 100644 index 0000000..0f31dc9 --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/base.py @@ -0,0 +1,139 @@ +from dataclasses import dataclass +from typing import FrozenSet, Iterable, Optional, Tuple + +from pip._vendor.packaging.specifiers import SpecifierSet +from pip._vendor.packaging.utils import NormalizedName +from pip._vendor.packaging.version import Version + +from pip._internal.models.link import Link, links_equivalent +from pip._internal.req.req_install import InstallRequirement +from pip._internal.utils.hashes import Hashes + +CandidateLookup = Tuple[Optional["Candidate"], Optional[InstallRequirement]] + + +def format_name(project: NormalizedName, extras: FrozenSet[NormalizedName]) -> str: + if not extras: + return project + extras_expr = ",".join(sorted(extras)) + return f"{project}[{extras_expr}]" + + +@dataclass(frozen=True) +class Constraint: + specifier: SpecifierSet + hashes: Hashes + links: FrozenSet[Link] + + @classmethod + def empty(cls) -> "Constraint": + return Constraint(SpecifierSet(), Hashes(), frozenset()) + + @classmethod + def from_ireq(cls, ireq: InstallRequirement) -> "Constraint": + links = frozenset([ireq.link]) if ireq.link else frozenset() + return Constraint(ireq.specifier, ireq.hashes(trust_internet=False), links) + + def __bool__(self) -> bool: + return bool(self.specifier) or bool(self.hashes) or bool(self.links) + + def __and__(self, other: InstallRequirement) -> "Constraint": + if not isinstance(other, InstallRequirement): + return NotImplemented + specifier = self.specifier & other.specifier + hashes = self.hashes & other.hashes(trust_internet=False) + links = self.links + if other.link: + links = links.union([other.link]) + return Constraint(specifier, hashes, links) + + def is_satisfied_by(self, candidate: "Candidate") -> bool: + # Reject if there are any mismatched URL constraints on this package. + if self.links and not all(_match_link(link, candidate) for link in self.links): + return False + # We can safely always allow prereleases here since PackageFinder + # already implements the prerelease logic, and would have filtered out + # prerelease candidates if the user does not expect them. + return self.specifier.contains(candidate.version, prereleases=True) + + +class Requirement: + @property + def project_name(self) -> NormalizedName: + """The "project name" of a requirement. + + This is different from ``name`` if this requirement contains extras, + in which case ``name`` would contain the ``[...]`` part, while this + refers to the name of the project. + """ + raise NotImplementedError("Subclass should override") + + @property + def name(self) -> str: + """The name identifying this requirement in the resolver. + + This is different from ``project_name`` if this requirement contains + extras, where ``project_name`` would not contain the ``[...]`` part. + """ + raise NotImplementedError("Subclass should override") + + def is_satisfied_by(self, candidate: "Candidate") -> bool: + return False + + def get_candidate_lookup(self) -> CandidateLookup: + raise NotImplementedError("Subclass should override") + + def format_for_error(self) -> str: + raise NotImplementedError("Subclass should override") + + +def _match_link(link: Link, candidate: "Candidate") -> bool: + if candidate.source_link: + return links_equivalent(link, candidate.source_link) + return False + + +class Candidate: + @property + def project_name(self) -> NormalizedName: + """The "project name" of the candidate. + + This is different from ``name`` if this candidate contains extras, + in which case ``name`` would contain the ``[...]`` part, while this + refers to the name of the project. + """ + raise NotImplementedError("Override in subclass") + + @property + def name(self) -> str: + """The name identifying this candidate in the resolver. + + This is different from ``project_name`` if this candidate contains + extras, where ``project_name`` would not contain the ``[...]`` part. + """ + raise NotImplementedError("Override in subclass") + + @property + def version(self) -> Version: + raise NotImplementedError("Override in subclass") + + @property + def is_installed(self) -> bool: + raise NotImplementedError("Override in subclass") + + @property + def is_editable(self) -> bool: + raise NotImplementedError("Override in subclass") + + @property + def source_link(self) -> Optional[Link]: + raise NotImplementedError("Override in subclass") + + def iter_dependencies(self, with_requires: bool) -> Iterable[Optional[Requirement]]: + raise NotImplementedError("Override in subclass") + + def get_install_requirement(self) -> Optional[InstallRequirement]: + raise NotImplementedError("Override in subclass") + + def format_for_error(self) -> str: + raise NotImplementedError("Subclass should override") diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/candidates.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/candidates.py new file mode 100644 index 0000000..6617644 --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/candidates.py @@ -0,0 +1,574 @@ +import logging +import sys +from typing import TYPE_CHECKING, Any, FrozenSet, Iterable, Optional, Tuple, Union, cast + +from pip._vendor.packaging.requirements import InvalidRequirement +from pip._vendor.packaging.utils import NormalizedName, canonicalize_name +from pip._vendor.packaging.version import Version + +from pip._internal.exceptions import ( + HashError, + InstallationSubprocessError, + InvalidInstalledPackage, + MetadataInconsistent, + MetadataInvalid, +) +from pip._internal.metadata import BaseDistribution +from pip._internal.models.link import Link, links_equivalent +from pip._internal.models.wheel import Wheel +from pip._internal.req.constructors import ( + install_req_from_editable, + install_req_from_line, +) +from pip._internal.req.req_install import InstallRequirement +from pip._internal.utils.direct_url_helpers import direct_url_from_link +from pip._internal.utils.misc import normalize_version_info + +from .base import Candidate, Requirement, format_name + +if TYPE_CHECKING: + from .factory import Factory + +logger = logging.getLogger(__name__) + +BaseCandidate = Union[ + "AlreadyInstalledCandidate", + "EditableCandidate", + "LinkCandidate", +] + +# Avoid conflicting with the PyPI package "Python". +REQUIRES_PYTHON_IDENTIFIER = cast(NormalizedName, "") + + +def as_base_candidate(candidate: Candidate) -> Optional[BaseCandidate]: + """The runtime version of BaseCandidate.""" + base_candidate_classes = ( + AlreadyInstalledCandidate, + EditableCandidate, + LinkCandidate, + ) + if isinstance(candidate, base_candidate_classes): + return candidate + return None + + +def make_install_req_from_link( + link: Link, template: InstallRequirement +) -> InstallRequirement: + assert not template.editable, "template is editable" + if template.req: + line = str(template.req) + else: + line = link.url + ireq = install_req_from_line( + line, + user_supplied=template.user_supplied, + comes_from=template.comes_from, + use_pep517=template.use_pep517, + isolated=template.isolated, + constraint=template.constraint, + global_options=template.global_options, + hash_options=template.hash_options, + config_settings=template.config_settings, + ) + ireq.original_link = template.original_link + ireq.link = link + ireq.extras = template.extras + return ireq + + +def make_install_req_from_editable( + link: Link, template: InstallRequirement +) -> InstallRequirement: + assert template.editable, "template not editable" + ireq = install_req_from_editable( + link.url, + user_supplied=template.user_supplied, + comes_from=template.comes_from, + use_pep517=template.use_pep517, + isolated=template.isolated, + constraint=template.constraint, + permit_editable_wheels=template.permit_editable_wheels, + global_options=template.global_options, + hash_options=template.hash_options, + config_settings=template.config_settings, + ) + ireq.extras = template.extras + return ireq + + +def _make_install_req_from_dist( + dist: BaseDistribution, template: InstallRequirement +) -> InstallRequirement: + if template.req: + line = str(template.req) + elif template.link: + line = f"{dist.canonical_name} @ {template.link.url}" + else: + line = f"{dist.canonical_name}=={dist.version}" + ireq = install_req_from_line( + line, + user_supplied=template.user_supplied, + comes_from=template.comes_from, + use_pep517=template.use_pep517, + isolated=template.isolated, + constraint=template.constraint, + global_options=template.global_options, + hash_options=template.hash_options, + config_settings=template.config_settings, + ) + ireq.satisfied_by = dist + return ireq + + +class _InstallRequirementBackedCandidate(Candidate): + """A candidate backed by an ``InstallRequirement``. + + This represents a package request with the target not being already + in the environment, and needs to be fetched and installed. The backing + ``InstallRequirement`` is responsible for most of the leg work; this + class exposes appropriate information to the resolver. + + :param link: The link passed to the ``InstallRequirement``. The backing + ``InstallRequirement`` will use this link to fetch the distribution. + :param source_link: The link this candidate "originates" from. This is + different from ``link`` when the link is found in the wheel cache. + ``link`` would point to the wheel cache, while this points to the + found remote link (e.g. from pypi.org). + """ + + dist: BaseDistribution + is_installed = False + + def __init__( + self, + link: Link, + source_link: Link, + ireq: InstallRequirement, + factory: "Factory", + name: Optional[NormalizedName] = None, + version: Optional[Version] = None, + ) -> None: + self._link = link + self._source_link = source_link + self._factory = factory + self._ireq = ireq + self._name = name + self._version = version + self.dist = self._prepare() + self._hash: Optional[int] = None + + def __str__(self) -> str: + return f"{self.name} {self.version}" + + def __repr__(self) -> str: + return f"{self.__class__.__name__}({str(self._link)!r})" + + def __hash__(self) -> int: + if self._hash is not None: + return self._hash + + self._hash = hash((self.__class__, self._link)) + return self._hash + + def __eq__(self, other: Any) -> bool: + if isinstance(other, self.__class__): + return links_equivalent(self._link, other._link) + return False + + @property + def source_link(self) -> Optional[Link]: + return self._source_link + + @property + def project_name(self) -> NormalizedName: + """The normalised name of the project the candidate refers to""" + if self._name is None: + self._name = self.dist.canonical_name + return self._name + + @property + def name(self) -> str: + return self.project_name + + @property + def version(self) -> Version: + if self._version is None: + self._version = self.dist.version + return self._version + + def format_for_error(self) -> str: + return ( + f"{self.name} {self.version} " + f"(from {self._link.file_path if self._link.is_file else self._link})" + ) + + def _prepare_distribution(self) -> BaseDistribution: + raise NotImplementedError("Override in subclass") + + def _check_metadata_consistency(self, dist: BaseDistribution) -> None: + """Check for consistency of project name and version of dist.""" + if self._name is not None and self._name != dist.canonical_name: + raise MetadataInconsistent( + self._ireq, + "name", + self._name, + dist.canonical_name, + ) + if self._version is not None and self._version != dist.version: + raise MetadataInconsistent( + self._ireq, + "version", + str(self._version), + str(dist.version), + ) + # check dependencies are valid + # TODO performance: this means we iterate the dependencies at least twice, + # we may want to cache parsed Requires-Dist + try: + list(dist.iter_dependencies(list(dist.iter_provided_extras()))) + except InvalidRequirement as e: + raise MetadataInvalid(self._ireq, str(e)) + + def _prepare(self) -> BaseDistribution: + try: + dist = self._prepare_distribution() + except HashError as e: + # Provide HashError the underlying ireq that caused it. This + # provides context for the resulting error message to show the + # offending line to the user. + e.req = self._ireq + raise + except InstallationSubprocessError as exc: + # The output has been presented already, so don't duplicate it. + exc.context = "See above for output." + raise + + self._check_metadata_consistency(dist) + return dist + + def iter_dependencies(self, with_requires: bool) -> Iterable[Optional[Requirement]]: + requires = self.dist.iter_dependencies() if with_requires else () + for r in requires: + yield from self._factory.make_requirements_from_spec(str(r), self._ireq) + yield self._factory.make_requires_python_requirement(self.dist.requires_python) + + def get_install_requirement(self) -> Optional[InstallRequirement]: + return self._ireq + + +class LinkCandidate(_InstallRequirementBackedCandidate): + is_editable = False + + def __init__( + self, + link: Link, + template: InstallRequirement, + factory: "Factory", + name: Optional[NormalizedName] = None, + version: Optional[Version] = None, + ) -> None: + source_link = link + cache_entry = factory.get_wheel_cache_entry(source_link, name) + if cache_entry is not None: + logger.debug("Using cached wheel link: %s", cache_entry.link) + link = cache_entry.link + ireq = make_install_req_from_link(link, template) + assert ireq.link == link + if ireq.link.is_wheel and not ireq.link.is_file: + wheel = Wheel(ireq.link.filename) + wheel_name = canonicalize_name(wheel.name) + assert name == wheel_name, f"{name!r} != {wheel_name!r} for wheel" + # Version may not be present for PEP 508 direct URLs + if version is not None: + wheel_version = Version(wheel.version) + assert ( + version == wheel_version + ), f"{version!r} != {wheel_version!r} for wheel {name}" + + if cache_entry is not None: + assert ireq.link.is_wheel + assert ireq.link.is_file + if cache_entry.persistent and template.link is template.original_link: + ireq.cached_wheel_source_link = source_link + if cache_entry.origin is not None: + ireq.download_info = cache_entry.origin + else: + # Legacy cache entry that does not have origin.json. + # download_info may miss the archive_info.hashes field. + ireq.download_info = direct_url_from_link( + source_link, link_is_in_wheel_cache=cache_entry.persistent + ) + + super().__init__( + link=link, + source_link=source_link, + ireq=ireq, + factory=factory, + name=name, + version=version, + ) + + def _prepare_distribution(self) -> BaseDistribution: + preparer = self._factory.preparer + return preparer.prepare_linked_requirement(self._ireq, parallel_builds=True) + + +class EditableCandidate(_InstallRequirementBackedCandidate): + is_editable = True + + def __init__( + self, + link: Link, + template: InstallRequirement, + factory: "Factory", + name: Optional[NormalizedName] = None, + version: Optional[Version] = None, + ) -> None: + super().__init__( + link=link, + source_link=link, + ireq=make_install_req_from_editable(link, template), + factory=factory, + name=name, + version=version, + ) + + def _prepare_distribution(self) -> BaseDistribution: + return self._factory.preparer.prepare_editable_requirement(self._ireq) + + +class AlreadyInstalledCandidate(Candidate): + is_installed = True + source_link = None + + def __init__( + self, + dist: BaseDistribution, + template: InstallRequirement, + factory: "Factory", + ) -> None: + self.dist = dist + self._ireq = _make_install_req_from_dist(dist, template) + self._factory = factory + self._version = None + + # This is just logging some messages, so we can do it eagerly. + # The returned dist would be exactly the same as self.dist because we + # set satisfied_by in _make_install_req_from_dist. + # TODO: Supply reason based on force_reinstall and upgrade_strategy. + skip_reason = "already satisfied" + factory.preparer.prepare_installed_requirement(self._ireq, skip_reason) + + def __str__(self) -> str: + return str(self.dist) + + def __repr__(self) -> str: + return f"{self.__class__.__name__}({self.dist!r})" + + def __eq__(self, other: object) -> bool: + if not isinstance(other, AlreadyInstalledCandidate): + return NotImplemented + return self.name == other.name and self.version == other.version + + def __hash__(self) -> int: + return hash((self.name, self.version)) + + @property + def project_name(self) -> NormalizedName: + return self.dist.canonical_name + + @property + def name(self) -> str: + return self.project_name + + @property + def version(self) -> Version: + if self._version is None: + self._version = self.dist.version + return self._version + + @property + def is_editable(self) -> bool: + return self.dist.editable + + def format_for_error(self) -> str: + return f"{self.name} {self.version} (Installed)" + + def iter_dependencies(self, with_requires: bool) -> Iterable[Optional[Requirement]]: + if not with_requires: + return + + try: + for r in self.dist.iter_dependencies(): + yield from self._factory.make_requirements_from_spec(str(r), self._ireq) + except InvalidRequirement as exc: + raise InvalidInstalledPackage(dist=self.dist, invalid_exc=exc) from None + + def get_install_requirement(self) -> Optional[InstallRequirement]: + return None + + +class ExtrasCandidate(Candidate): + """A candidate that has 'extras', indicating additional dependencies. + + Requirements can be for a project with dependencies, something like + foo[extra]. The extras don't affect the project/version being installed + directly, but indicate that we need additional dependencies. We model that + by having an artificial ExtrasCandidate that wraps the "base" candidate. + + The ExtrasCandidate differs from the base in the following ways: + + 1. It has a unique name, of the form foo[extra]. This causes the resolver + to treat it as a separate node in the dependency graph. + 2. When we're getting the candidate's dependencies, + a) We specify that we want the extra dependencies as well. + b) We add a dependency on the base candidate. + See below for why this is needed. + 3. We return None for the underlying InstallRequirement, as the base + candidate will provide it, and we don't want to end up with duplicates. + + The dependency on the base candidate is needed so that the resolver can't + decide that it should recommend foo[extra1] version 1.0 and foo[extra2] + version 2.0. Having those candidates depend on foo=1.0 and foo=2.0 + respectively forces the resolver to recognise that this is a conflict. + """ + + def __init__( + self, + base: BaseCandidate, + extras: FrozenSet[str], + *, + comes_from: Optional[InstallRequirement] = None, + ) -> None: + """ + :param comes_from: the InstallRequirement that led to this candidate if it + differs from the base's InstallRequirement. This will often be the + case in the sense that this candidate's requirement has the extras + while the base's does not. Unlike the InstallRequirement backed + candidates, this requirement is used solely for reporting purposes, + it does not do any leg work. + """ + self.base = base + self.extras = frozenset(canonicalize_name(e) for e in extras) + self._comes_from = comes_from if comes_from is not None else self.base._ireq + + def __str__(self) -> str: + name, rest = str(self.base).split(" ", 1) + return "{}[{}] {}".format(name, ",".join(self.extras), rest) + + def __repr__(self) -> str: + return f"{self.__class__.__name__}(base={self.base!r}, extras={self.extras!r})" + + def __hash__(self) -> int: + return hash((self.base, self.extras)) + + def __eq__(self, other: Any) -> bool: + if isinstance(other, self.__class__): + return self.base == other.base and self.extras == other.extras + return False + + @property + def project_name(self) -> NormalizedName: + return self.base.project_name + + @property + def name(self) -> str: + """The normalised name of the project the candidate refers to""" + return format_name(self.base.project_name, self.extras) + + @property + def version(self) -> Version: + return self.base.version + + def format_for_error(self) -> str: + return "{} [{}]".format( + self.base.format_for_error(), ", ".join(sorted(self.extras)) + ) + + @property + def is_installed(self) -> bool: + return self.base.is_installed + + @property + def is_editable(self) -> bool: + return self.base.is_editable + + @property + def source_link(self) -> Optional[Link]: + return self.base.source_link + + def iter_dependencies(self, with_requires: bool) -> Iterable[Optional[Requirement]]: + factory = self.base._factory + + # Add a dependency on the exact base + # (See note 2b in the class docstring) + yield factory.make_requirement_from_candidate(self.base) + if not with_requires: + return + + # The user may have specified extras that the candidate doesn't + # support. We ignore any unsupported extras here. + valid_extras = self.extras.intersection(self.base.dist.iter_provided_extras()) + invalid_extras = self.extras.difference(self.base.dist.iter_provided_extras()) + for extra in sorted(invalid_extras): + logger.warning( + "%s %s does not provide the extra '%s'", + self.base.name, + self.version, + extra, + ) + + for r in self.base.dist.iter_dependencies(valid_extras): + yield from factory.make_requirements_from_spec( + str(r), + self._comes_from, + valid_extras, + ) + + def get_install_requirement(self) -> Optional[InstallRequirement]: + # We don't return anything here, because we always + # depend on the base candidate, and we'll get the + # install requirement from that. + return None + + +class RequiresPythonCandidate(Candidate): + is_installed = False + source_link = None + + def __init__(self, py_version_info: Optional[Tuple[int, ...]]) -> None: + if py_version_info is not None: + version_info = normalize_version_info(py_version_info) + else: + version_info = sys.version_info[:3] + self._version = Version(".".join(str(c) for c in version_info)) + + # We don't need to implement __eq__() and __ne__() since there is always + # only one RequiresPythonCandidate in a resolution, i.e. the host Python. + # The built-in object.__eq__() and object.__ne__() do exactly what we want. + + def __str__(self) -> str: + return f"Python {self._version}" + + @property + def project_name(self) -> NormalizedName: + return REQUIRES_PYTHON_IDENTIFIER + + @property + def name(self) -> str: + return REQUIRES_PYTHON_IDENTIFIER + + @property + def version(self) -> Version: + return self._version + + def format_for_error(self) -> str: + return f"Python {self.version}" + + def iter_dependencies(self, with_requires: bool) -> Iterable[Optional[Requirement]]: + return () + + def get_install_requirement(self) -> Optional[InstallRequirement]: + return None diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/factory.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/factory.py new file mode 100644 index 0000000..6c273eb --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/factory.py @@ -0,0 +1,823 @@ +import contextlib +import functools +import logging +from typing import ( + TYPE_CHECKING, + Callable, + Dict, + FrozenSet, + Iterable, + Iterator, + List, + Mapping, + NamedTuple, + Optional, + Protocol, + Sequence, + Set, + Tuple, + TypeVar, + cast, +) + +from pip._vendor.packaging.requirements import InvalidRequirement +from pip._vendor.packaging.specifiers import SpecifierSet +from pip._vendor.packaging.utils import NormalizedName, canonicalize_name +from pip._vendor.packaging.version import InvalidVersion, Version +from pip._vendor.resolvelib import ResolutionImpossible + +from pip._internal.cache import CacheEntry, WheelCache +from pip._internal.exceptions import ( + DistributionNotFound, + InstallationError, + InvalidInstalledPackage, + MetadataInconsistent, + MetadataInvalid, + UnsupportedPythonVersion, + UnsupportedWheel, +) +from pip._internal.index.package_finder import PackageFinder +from pip._internal.metadata import BaseDistribution, get_default_environment +from pip._internal.models.link import Link +from pip._internal.models.wheel import Wheel +from pip._internal.operations.prepare import RequirementPreparer +from pip._internal.req.constructors import ( + install_req_drop_extras, + install_req_from_link_and_ireq, +) +from pip._internal.req.req_install import ( + InstallRequirement, + check_invalid_constraint_type, +) +from pip._internal.resolution.base import InstallRequirementProvider +from pip._internal.utils.compatibility_tags import get_supported +from pip._internal.utils.hashes import Hashes +from pip._internal.utils.packaging import get_requirement +from pip._internal.utils.virtualenv import running_under_virtualenv + +from .base import Candidate, Constraint, Requirement +from .candidates import ( + AlreadyInstalledCandidate, + BaseCandidate, + EditableCandidate, + ExtrasCandidate, + LinkCandidate, + RequiresPythonCandidate, + as_base_candidate, +) +from .found_candidates import FoundCandidates, IndexCandidateInfo +from .requirements import ( + ExplicitRequirement, + RequiresPythonRequirement, + SpecifierRequirement, + SpecifierWithoutExtrasRequirement, + UnsatisfiableRequirement, +) + +if TYPE_CHECKING: + + class ConflictCause(Protocol): + requirement: RequiresPythonRequirement + parent: Candidate + + +logger = logging.getLogger(__name__) + +C = TypeVar("C") +Cache = Dict[Link, C] + + +class CollectedRootRequirements(NamedTuple): + requirements: List[Requirement] + constraints: Dict[str, Constraint] + user_requested: Dict[str, int] + + +class Factory: + def __init__( + self, + finder: PackageFinder, + preparer: RequirementPreparer, + make_install_req: InstallRequirementProvider, + wheel_cache: Optional[WheelCache], + use_user_site: bool, + force_reinstall: bool, + ignore_installed: bool, + ignore_requires_python: bool, + py_version_info: Optional[Tuple[int, ...]] = None, + ) -> None: + self._finder = finder + self.preparer = preparer + self._wheel_cache = wheel_cache + self._python_candidate = RequiresPythonCandidate(py_version_info) + self._make_install_req_from_spec = make_install_req + self._use_user_site = use_user_site + self._force_reinstall = force_reinstall + self._ignore_requires_python = ignore_requires_python + + self._build_failures: Cache[InstallationError] = {} + self._link_candidate_cache: Cache[LinkCandidate] = {} + self._editable_candidate_cache: Cache[EditableCandidate] = {} + self._installed_candidate_cache: Dict[str, AlreadyInstalledCandidate] = {} + self._extras_candidate_cache: Dict[ + Tuple[int, FrozenSet[NormalizedName]], ExtrasCandidate + ] = {} + self._supported_tags_cache = get_supported() + + if not ignore_installed: + env = get_default_environment() + self._installed_dists = { + dist.canonical_name: dist + for dist in env.iter_installed_distributions(local_only=False) + } + else: + self._installed_dists = {} + + @property + def force_reinstall(self) -> bool: + return self._force_reinstall + + def _fail_if_link_is_unsupported_wheel(self, link: Link) -> None: + if not link.is_wheel: + return + wheel = Wheel(link.filename) + if wheel.supported(self._finder.target_python.get_unsorted_tags()): + return + msg = f"{link.filename} is not a supported wheel on this platform." + raise UnsupportedWheel(msg) + + def _make_extras_candidate( + self, + base: BaseCandidate, + extras: FrozenSet[str], + *, + comes_from: Optional[InstallRequirement] = None, + ) -> ExtrasCandidate: + cache_key = (id(base), frozenset(canonicalize_name(e) for e in extras)) + try: + candidate = self._extras_candidate_cache[cache_key] + except KeyError: + candidate = ExtrasCandidate(base, extras, comes_from=comes_from) + self._extras_candidate_cache[cache_key] = candidate + return candidate + + def _make_candidate_from_dist( + self, + dist: BaseDistribution, + extras: FrozenSet[str], + template: InstallRequirement, + ) -> Candidate: + try: + base = self._installed_candidate_cache[dist.canonical_name] + except KeyError: + base = AlreadyInstalledCandidate(dist, template, factory=self) + self._installed_candidate_cache[dist.canonical_name] = base + if not extras: + return base + return self._make_extras_candidate(base, extras, comes_from=template) + + def _make_candidate_from_link( + self, + link: Link, + extras: FrozenSet[str], + template: InstallRequirement, + name: Optional[NormalizedName], + version: Optional[Version], + ) -> Optional[Candidate]: + base: Optional[BaseCandidate] = self._make_base_candidate_from_link( + link, template, name, version + ) + if not extras or base is None: + return base + return self._make_extras_candidate(base, extras, comes_from=template) + + def _make_base_candidate_from_link( + self, + link: Link, + template: InstallRequirement, + name: Optional[NormalizedName], + version: Optional[Version], + ) -> Optional[BaseCandidate]: + # TODO: Check already installed candidate, and use it if the link and + # editable flag match. + + if link in self._build_failures: + # We already tried this candidate before, and it does not build. + # Don't bother trying again. + return None + + if template.editable: + if link not in self._editable_candidate_cache: + try: + self._editable_candidate_cache[link] = EditableCandidate( + link, + template, + factory=self, + name=name, + version=version, + ) + except (MetadataInconsistent, MetadataInvalid) as e: + logger.info( + "Discarding [blue underline]%s[/]: [yellow]%s[reset]", + link, + e, + extra={"markup": True}, + ) + self._build_failures[link] = e + return None + + return self._editable_candidate_cache[link] + else: + if link not in self._link_candidate_cache: + try: + self._link_candidate_cache[link] = LinkCandidate( + link, + template, + factory=self, + name=name, + version=version, + ) + except MetadataInconsistent as e: + logger.info( + "Discarding [blue underline]%s[/]: [yellow]%s[reset]", + link, + e, + extra={"markup": True}, + ) + self._build_failures[link] = e + return None + return self._link_candidate_cache[link] + + def _iter_found_candidates( + self, + ireqs: Sequence[InstallRequirement], + specifier: SpecifierSet, + hashes: Hashes, + prefers_installed: bool, + incompatible_ids: Set[int], + ) -> Iterable[Candidate]: + if not ireqs: + return () + + # The InstallRequirement implementation requires us to give it a + # "template". Here we just choose the first requirement to represent + # all of them. + # Hopefully the Project model can correct this mismatch in the future. + template = ireqs[0] + assert template.req, "Candidates found on index must be PEP 508" + name = canonicalize_name(template.req.name) + + extras: FrozenSet[str] = frozenset() + for ireq in ireqs: + assert ireq.req, "Candidates found on index must be PEP 508" + specifier &= ireq.req.specifier + hashes &= ireq.hashes(trust_internet=False) + extras |= frozenset(ireq.extras) + + def _get_installed_candidate() -> Optional[Candidate]: + """Get the candidate for the currently-installed version.""" + # If --force-reinstall is set, we want the version from the index + # instead, so we "pretend" there is nothing installed. + if self._force_reinstall: + return None + try: + installed_dist = self._installed_dists[name] + except KeyError: + return None + + try: + # Don't use the installed distribution if its version + # does not fit the current dependency graph. + if not specifier.contains(installed_dist.version, prereleases=True): + return None + except InvalidVersion as e: + raise InvalidInstalledPackage(dist=installed_dist, invalid_exc=e) + + candidate = self._make_candidate_from_dist( + dist=installed_dist, + extras=extras, + template=template, + ) + # The candidate is a known incompatibility. Don't use it. + if id(candidate) in incompatible_ids: + return None + return candidate + + def iter_index_candidate_infos() -> Iterator[IndexCandidateInfo]: + result = self._finder.find_best_candidate( + project_name=name, + specifier=specifier, + hashes=hashes, + ) + icans = result.applicable_candidates + + # PEP 592: Yanked releases are ignored unless the specifier + # explicitly pins a version (via '==' or '===') that can be + # solely satisfied by a yanked release. + all_yanked = all(ican.link.is_yanked for ican in icans) + + def is_pinned(specifier: SpecifierSet) -> bool: + for sp in specifier: + if sp.operator == "===": + return True + if sp.operator != "==": + continue + if sp.version.endswith(".*"): + continue + return True + return False + + pinned = is_pinned(specifier) + + # PackageFinder returns earlier versions first, so we reverse. + for ican in reversed(icans): + if not (all_yanked and pinned) and ican.link.is_yanked: + continue + func = functools.partial( + self._make_candidate_from_link, + link=ican.link, + extras=extras, + template=template, + name=name, + version=ican.version, + ) + yield ican.version, func + + return FoundCandidates( + iter_index_candidate_infos, + _get_installed_candidate(), + prefers_installed, + incompatible_ids, + ) + + def _iter_explicit_candidates_from_base( + self, + base_requirements: Iterable[Requirement], + extras: FrozenSet[str], + ) -> Iterator[Candidate]: + """Produce explicit candidates from the base given an extra-ed package. + + :param base_requirements: Requirements known to the resolver. The + requirements are guaranteed to not have extras. + :param extras: The extras to inject into the explicit requirements' + candidates. + """ + for req in base_requirements: + lookup_cand, _ = req.get_candidate_lookup() + if lookup_cand is None: # Not explicit. + continue + # We've stripped extras from the identifier, and should always + # get a BaseCandidate here, unless there's a bug elsewhere. + base_cand = as_base_candidate(lookup_cand) + assert base_cand is not None, "no extras here" + yield self._make_extras_candidate(base_cand, extras) + + def _iter_candidates_from_constraints( + self, + identifier: str, + constraint: Constraint, + template: InstallRequirement, + ) -> Iterator[Candidate]: + """Produce explicit candidates from constraints. + + This creates "fake" InstallRequirement objects that are basically clones + of what "should" be the template, but with original_link set to link. + """ + for link in constraint.links: + self._fail_if_link_is_unsupported_wheel(link) + candidate = self._make_base_candidate_from_link( + link, + template=install_req_from_link_and_ireq(link, template), + name=canonicalize_name(identifier), + version=None, + ) + if candidate: + yield candidate + + def find_candidates( + self, + identifier: str, + requirements: Mapping[str, Iterable[Requirement]], + incompatibilities: Mapping[str, Iterator[Candidate]], + constraint: Constraint, + prefers_installed: bool, + is_satisfied_by: Callable[[Requirement, Candidate], bool], + ) -> Iterable[Candidate]: + # Collect basic lookup information from the requirements. + explicit_candidates: Set[Candidate] = set() + ireqs: List[InstallRequirement] = [] + for req in requirements[identifier]: + cand, ireq = req.get_candidate_lookup() + if cand is not None: + explicit_candidates.add(cand) + if ireq is not None: + ireqs.append(ireq) + + # If the current identifier contains extras, add requires and explicit + # candidates from entries from extra-less identifier. + with contextlib.suppress(InvalidRequirement): + parsed_requirement = get_requirement(identifier) + if parsed_requirement.name != identifier: + explicit_candidates.update( + self._iter_explicit_candidates_from_base( + requirements.get(parsed_requirement.name, ()), + frozenset(parsed_requirement.extras), + ), + ) + for req in requirements.get(parsed_requirement.name, []): + _, ireq = req.get_candidate_lookup() + if ireq is not None: + ireqs.append(ireq) + + # Add explicit candidates from constraints. We only do this if there are + # known ireqs, which represent requirements not already explicit. If + # there are no ireqs, we're constraining already-explicit requirements, + # which is handled later when we return the explicit candidates. + if ireqs: + try: + explicit_candidates.update( + self._iter_candidates_from_constraints( + identifier, + constraint, + template=ireqs[0], + ), + ) + except UnsupportedWheel: + # If we're constrained to install a wheel incompatible with the + # target architecture, no candidates will ever be valid. + return () + + # Since we cache all the candidates, incompatibility identification + # can be made quicker by comparing only the id() values. + incompat_ids = {id(c) for c in incompatibilities.get(identifier, ())} + + # If none of the requirements want an explicit candidate, we can ask + # the finder for candidates. + if not explicit_candidates: + return self._iter_found_candidates( + ireqs, + constraint.specifier, + constraint.hashes, + prefers_installed, + incompat_ids, + ) + + return ( + c + for c in explicit_candidates + if id(c) not in incompat_ids + and constraint.is_satisfied_by(c) + and all(is_satisfied_by(req, c) for req in requirements[identifier]) + ) + + def _make_requirements_from_install_req( + self, ireq: InstallRequirement, requested_extras: Iterable[str] + ) -> Iterator[Requirement]: + """ + Returns requirement objects associated with the given InstallRequirement. In + most cases this will be a single object but the following special cases exist: + - the InstallRequirement has markers that do not apply -> result is empty + - the InstallRequirement has both a constraint (or link) and extras + -> result is split in two requirement objects: one with the constraint + (or link) and one with the extra. This allows centralized constraint + handling for the base, resulting in fewer candidate rejections. + """ + if not ireq.match_markers(requested_extras): + logger.info( + "Ignoring %s: markers '%s' don't match your environment", + ireq.name, + ireq.markers, + ) + elif not ireq.link: + if ireq.extras and ireq.req is not None and ireq.req.specifier: + yield SpecifierWithoutExtrasRequirement(ireq) + yield SpecifierRequirement(ireq) + else: + self._fail_if_link_is_unsupported_wheel(ireq.link) + # Always make the link candidate for the base requirement to make it + # available to `find_candidates` for explicit candidate lookup for any + # set of extras. + # The extras are required separately via a second requirement. + cand = self._make_base_candidate_from_link( + ireq.link, + template=install_req_drop_extras(ireq) if ireq.extras else ireq, + name=canonicalize_name(ireq.name) if ireq.name else None, + version=None, + ) + if cand is None: + # There's no way we can satisfy a URL requirement if the underlying + # candidate fails to build. An unnamed URL must be user-supplied, so + # we fail eagerly. If the URL is named, an unsatisfiable requirement + # can make the resolver do the right thing, either backtrack (and + # maybe find some other requirement that's buildable) or raise a + # ResolutionImpossible eventually. + if not ireq.name: + raise self._build_failures[ireq.link] + yield UnsatisfiableRequirement(canonicalize_name(ireq.name)) + else: + # require the base from the link + yield self.make_requirement_from_candidate(cand) + if ireq.extras: + # require the extras on top of the base candidate + yield self.make_requirement_from_candidate( + self._make_extras_candidate(cand, frozenset(ireq.extras)) + ) + + def collect_root_requirements( + self, root_ireqs: List[InstallRequirement] + ) -> CollectedRootRequirements: + collected = CollectedRootRequirements([], {}, {}) + for i, ireq in enumerate(root_ireqs): + if ireq.constraint: + # Ensure we only accept valid constraints + problem = check_invalid_constraint_type(ireq) + if problem: + raise InstallationError(problem) + if not ireq.match_markers(): + continue + assert ireq.name, "Constraint must be named" + name = canonicalize_name(ireq.name) + if name in collected.constraints: + collected.constraints[name] &= ireq + else: + collected.constraints[name] = Constraint.from_ireq(ireq) + else: + reqs = list( + self._make_requirements_from_install_req( + ireq, + requested_extras=(), + ) + ) + if not reqs: + continue + template = reqs[0] + if ireq.user_supplied and template.name not in collected.user_requested: + collected.user_requested[template.name] = i + collected.requirements.extend(reqs) + # Put requirements with extras at the end of the root requires. This does not + # affect resolvelib's picking preference but it does affect its initial criteria + # population: by putting extras at the end we enable the candidate finder to + # present resolvelib with a smaller set of candidates to resolvelib, already + # taking into account any non-transient constraints on the associated base. This + # means resolvelib will have fewer candidates to visit and reject. + # Python's list sort is stable, meaning relative order is kept for objects with + # the same key. + collected.requirements.sort(key=lambda r: r.name != r.project_name) + return collected + + def make_requirement_from_candidate( + self, candidate: Candidate + ) -> ExplicitRequirement: + return ExplicitRequirement(candidate) + + def make_requirements_from_spec( + self, + specifier: str, + comes_from: Optional[InstallRequirement], + requested_extras: Iterable[str] = (), + ) -> Iterator[Requirement]: + """ + Returns requirement objects associated with the given specifier. In most cases + this will be a single object but the following special cases exist: + - the specifier has markers that do not apply -> result is empty + - the specifier has both a constraint and extras -> result is split + in two requirement objects: one with the constraint and one with the + extra. This allows centralized constraint handling for the base, + resulting in fewer candidate rejections. + """ + ireq = self._make_install_req_from_spec(specifier, comes_from) + return self._make_requirements_from_install_req(ireq, requested_extras) + + def make_requires_python_requirement( + self, + specifier: SpecifierSet, + ) -> Optional[Requirement]: + if self._ignore_requires_python: + return None + # Don't bother creating a dependency for an empty Requires-Python. + if not str(specifier): + return None + return RequiresPythonRequirement(specifier, self._python_candidate) + + def get_wheel_cache_entry( + self, link: Link, name: Optional[str] + ) -> Optional[CacheEntry]: + """Look up the link in the wheel cache. + + If ``preparer.require_hashes`` is True, don't use the wheel cache, + because cached wheels, always built locally, have different hashes + than the files downloaded from the index server and thus throw false + hash mismatches. Furthermore, cached wheels at present have + nondeterministic contents due to file modification times. + """ + if self._wheel_cache is None: + return None + return self._wheel_cache.get_cache_entry( + link=link, + package_name=name, + supported_tags=self._supported_tags_cache, + ) + + def get_dist_to_uninstall(self, candidate: Candidate) -> Optional[BaseDistribution]: + # TODO: Are there more cases this needs to return True? Editable? + dist = self._installed_dists.get(candidate.project_name) + if dist is None: # Not installed, no uninstallation required. + return None + + # We're installing into global site. The current installation must + # be uninstalled, no matter it's in global or user site, because the + # user site installation has precedence over global. + if not self._use_user_site: + return dist + + # We're installing into user site. Remove the user site installation. + if dist.in_usersite: + return dist + + # We're installing into user site, but the installed incompatible + # package is in global site. We can't uninstall that, and would let + # the new user installation to "shadow" it. But shadowing won't work + # in virtual environments, so we error out. + if running_under_virtualenv() and dist.in_site_packages: + message = ( + f"Will not install to the user site because it will lack " + f"sys.path precedence to {dist.raw_name} in {dist.location}" + ) + raise InstallationError(message) + return None + + def _report_requires_python_error( + self, causes: Sequence["ConflictCause"] + ) -> UnsupportedPythonVersion: + assert causes, "Requires-Python error reported with no cause" + + version = self._python_candidate.version + + if len(causes) == 1: + specifier = str(causes[0].requirement.specifier) + message = ( + f"Package {causes[0].parent.name!r} requires a different " + f"Python: {version} not in {specifier!r}" + ) + return UnsupportedPythonVersion(message) + + message = f"Packages require a different Python. {version} not in:" + for cause in causes: + package = cause.parent.format_for_error() + specifier = str(cause.requirement.specifier) + message += f"\n{specifier!r} (required by {package})" + return UnsupportedPythonVersion(message) + + def _report_single_requirement_conflict( + self, req: Requirement, parent: Optional[Candidate] + ) -> DistributionNotFound: + if parent is None: + req_disp = str(req) + else: + req_disp = f"{req} (from {parent.name})" + + cands = self._finder.find_all_candidates(req.project_name) + skipped_by_requires_python = self._finder.requires_python_skipped_reasons() + + versions_set: Set[Version] = set() + yanked_versions_set: Set[Version] = set() + for c in cands: + is_yanked = c.link.is_yanked if c.link else False + if is_yanked: + yanked_versions_set.add(c.version) + else: + versions_set.add(c.version) + + versions = [str(v) for v in sorted(versions_set)] + yanked_versions = [str(v) for v in sorted(yanked_versions_set)] + + if yanked_versions: + # Saying "version X is yanked" isn't entirely accurate. + # https://github.com/pypa/pip/issues/11745#issuecomment-1402805842 + logger.critical( + "Ignored the following yanked versions: %s", + ", ".join(yanked_versions) or "none", + ) + if skipped_by_requires_python: + logger.critical( + "Ignored the following versions that require a different python " + "version: %s", + "; ".join(skipped_by_requires_python) or "none", + ) + logger.critical( + "Could not find a version that satisfies the requirement %s " + "(from versions: %s)", + req_disp, + ", ".join(versions) or "none", + ) + if str(req) == "requirements.txt": + logger.info( + "HINT: You are attempting to install a package literally " + 'named "requirements.txt" (which cannot exist). Consider ' + "using the '-r' flag to install the packages listed in " + "requirements.txt" + ) + + return DistributionNotFound(f"No matching distribution found for {req}") + + def get_installation_error( + self, + e: "ResolutionImpossible[Requirement, Candidate]", + constraints: Dict[str, Constraint], + ) -> InstallationError: + assert e.causes, "Installation error reported with no cause" + + # If one of the things we can't solve is "we need Python X.Y", + # that is what we report. + requires_python_causes = [ + cause + for cause in e.causes + if isinstance(cause.requirement, RequiresPythonRequirement) + and not cause.requirement.is_satisfied_by(self._python_candidate) + ] + if requires_python_causes: + # The comprehension above makes sure all Requirement instances are + # RequiresPythonRequirement, so let's cast for convenience. + return self._report_requires_python_error( + cast("Sequence[ConflictCause]", requires_python_causes), + ) + + # Otherwise, we have a set of causes which can't all be satisfied + # at once. + + # The simplest case is when we have *one* cause that can't be + # satisfied. We just report that case. + if len(e.causes) == 1: + req, parent = e.causes[0] + if req.name not in constraints: + return self._report_single_requirement_conflict(req, parent) + + # OK, we now have a list of requirements that can't all be + # satisfied at once. + + # A couple of formatting helpers + def text_join(parts: List[str]) -> str: + if len(parts) == 1: + return parts[0] + + return ", ".join(parts[:-1]) + " and " + parts[-1] + + def describe_trigger(parent: Candidate) -> str: + ireq = parent.get_install_requirement() + if not ireq or not ireq.comes_from: + return f"{parent.name}=={parent.version}" + if isinstance(ireq.comes_from, InstallRequirement): + return str(ireq.comes_from.name) + return str(ireq.comes_from) + + triggers = set() + for req, parent in e.causes: + if parent is None: + # This is a root requirement, so we can report it directly + trigger = req.format_for_error() + else: + trigger = describe_trigger(parent) + triggers.add(trigger) + + if triggers: + info = text_join(sorted(triggers)) + else: + info = "the requested packages" + + msg = ( + f"Cannot install {info} because these package versions " + "have conflicting dependencies." + ) + logger.critical(msg) + msg = "\nThe conflict is caused by:" + + relevant_constraints = set() + for req, parent in e.causes: + if req.name in constraints: + relevant_constraints.add(req.name) + msg = msg + "\n " + if parent: + msg = msg + f"{parent.name} {parent.version} depends on " + else: + msg = msg + "The user requested " + msg = msg + req.format_for_error() + for key in relevant_constraints: + spec = constraints[key].specifier + msg += f"\n The user requested (constraint) {key}{spec}" + + msg = ( + msg + + "\n\n" + + "To fix this you could try to:\n" + + "1. loosen the range of package versions you've specified\n" + + "2. remove package versions to allow pip to attempt to solve " + + "the dependency conflict\n" + ) + + logger.info(msg) + + return DistributionNotFound( + "ResolutionImpossible: for help visit " + "https://pip.pypa.io/en/latest/topics/dependency-resolution/" + "#dealing-with-dependency-conflicts" + ) diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/found_candidates.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/found_candidates.py new file mode 100644 index 0000000..a1d57e0 --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/found_candidates.py @@ -0,0 +1,174 @@ +"""Utilities to lazily create and visit candidates found. + +Creating and visiting a candidate is a *very* costly operation. It involves +fetching, extracting, potentially building modules from source, and verifying +distribution metadata. It is therefore crucial for performance to keep +everything here lazy all the way down, so we only touch candidates that we +absolutely need, and not "download the world" when we only need one version of +something. +""" + +import functools +import logging +from collections.abc import Sequence +from typing import TYPE_CHECKING, Any, Callable, Iterator, Optional, Set, Tuple + +from pip._vendor.packaging.version import _BaseVersion + +from pip._internal.exceptions import MetadataInvalid + +from .base import Candidate + +logger = logging.getLogger(__name__) + +IndexCandidateInfo = Tuple[_BaseVersion, Callable[[], Optional[Candidate]]] + +if TYPE_CHECKING: + SequenceCandidate = Sequence[Candidate] +else: + # For compatibility: Python before 3.9 does not support using [] on the + # Sequence class. + # + # >>> from collections.abc import Sequence + # >>> Sequence[str] + # Traceback (most recent call last): + # File "", line 1, in + # TypeError: 'ABCMeta' object is not subscriptable + # + # TODO: Remove this block after dropping Python 3.8 support. + SequenceCandidate = Sequence + + +def _iter_built(infos: Iterator[IndexCandidateInfo]) -> Iterator[Candidate]: + """Iterator for ``FoundCandidates``. + + This iterator is used when the package is not already installed. Candidates + from index come later in their normal ordering. + """ + versions_found: Set[_BaseVersion] = set() + for version, func in infos: + if version in versions_found: + continue + try: + candidate = func() + except MetadataInvalid as e: + logger.warning( + "Ignoring version %s of %s since it has invalid metadata:\n" + "%s\n" + "Please use pip<24.1 if you need to use this version.", + version, + e.ireq.name, + e, + ) + # Mark version as found to avoid trying other candidates with the same + # version, since they most likely have invalid metadata as well. + versions_found.add(version) + else: + if candidate is None: + continue + yield candidate + versions_found.add(version) + + +def _iter_built_with_prepended( + installed: Candidate, infos: Iterator[IndexCandidateInfo] +) -> Iterator[Candidate]: + """Iterator for ``FoundCandidates``. + + This iterator is used when the resolver prefers the already-installed + candidate and NOT to upgrade. The installed candidate is therefore + always yielded first, and candidates from index come later in their + normal ordering, except skipped when the version is already installed. + """ + yield installed + versions_found: Set[_BaseVersion] = {installed.version} + for version, func in infos: + if version in versions_found: + continue + candidate = func() + if candidate is None: + continue + yield candidate + versions_found.add(version) + + +def _iter_built_with_inserted( + installed: Candidate, infos: Iterator[IndexCandidateInfo] +) -> Iterator[Candidate]: + """Iterator for ``FoundCandidates``. + + This iterator is used when the resolver prefers to upgrade an + already-installed package. Candidates from index are returned in their + normal ordering, except replaced when the version is already installed. + + The implementation iterates through and yields other candidates, inserting + the installed candidate exactly once before we start yielding older or + equivalent candidates, or after all other candidates if they are all newer. + """ + versions_found: Set[_BaseVersion] = set() + for version, func in infos: + if version in versions_found: + continue + # If the installed candidate is better, yield it first. + if installed.version >= version: + yield installed + versions_found.add(installed.version) + candidate = func() + if candidate is None: + continue + yield candidate + versions_found.add(version) + + # If the installed candidate is older than all other candidates. + if installed.version not in versions_found: + yield installed + + +class FoundCandidates(SequenceCandidate): + """A lazy sequence to provide candidates to the resolver. + + The intended usage is to return this from `find_matches()` so the resolver + can iterate through the sequence multiple times, but only access the index + page when remote packages are actually needed. This improve performances + when suitable candidates are already installed on disk. + """ + + def __init__( + self, + get_infos: Callable[[], Iterator[IndexCandidateInfo]], + installed: Optional[Candidate], + prefers_installed: bool, + incompatible_ids: Set[int], + ): + self._get_infos = get_infos + self._installed = installed + self._prefers_installed = prefers_installed + self._incompatible_ids = incompatible_ids + + def __getitem__(self, index: Any) -> Any: + # Implemented to satisfy the ABC check. This is not needed by the + # resolver, and should not be used by the provider either (for + # performance reasons). + raise NotImplementedError("don't do this") + + def __iter__(self) -> Iterator[Candidate]: + infos = self._get_infos() + if not self._installed: + iterator = _iter_built(infos) + elif self._prefers_installed: + iterator = _iter_built_with_prepended(self._installed, infos) + else: + iterator = _iter_built_with_inserted(self._installed, infos) + return (c for c in iterator if id(c) not in self._incompatible_ids) + + def __len__(self) -> int: + # Implemented to satisfy the ABC check. This is not needed by the + # resolver, and should not be used by the provider either (for + # performance reasons). + raise NotImplementedError("don't do this") + + @functools.lru_cache(maxsize=1) + def __bool__(self) -> bool: + if self._prefers_installed and self._installed: + return True + return any(self) diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/provider.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/provider.py new file mode 100644 index 0000000..fb0dd85 --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/provider.py @@ -0,0 +1,258 @@ +import collections +import math +from functools import lru_cache +from typing import ( + TYPE_CHECKING, + Dict, + Iterable, + Iterator, + Mapping, + Sequence, + TypeVar, + Union, +) + +from pip._vendor.resolvelib.providers import AbstractProvider + +from .base import Candidate, Constraint, Requirement +from .candidates import REQUIRES_PYTHON_IDENTIFIER +from .factory import Factory + +if TYPE_CHECKING: + from pip._vendor.resolvelib.providers import Preference + from pip._vendor.resolvelib.resolvers import RequirementInformation + + PreferenceInformation = RequirementInformation[Requirement, Candidate] + + _ProviderBase = AbstractProvider[Requirement, Candidate, str] +else: + _ProviderBase = AbstractProvider + +# Notes on the relationship between the provider, the factory, and the +# candidate and requirement classes. +# +# The provider is a direct implementation of the resolvelib class. Its role +# is to deliver the API that resolvelib expects. +# +# Rather than work with completely abstract "requirement" and "candidate" +# concepts as resolvelib does, pip has concrete classes implementing these two +# ideas. The API of Requirement and Candidate objects are defined in the base +# classes, but essentially map fairly directly to the equivalent provider +# methods. In particular, `find_matches` and `is_satisfied_by` are +# requirement methods, and `get_dependencies` is a candidate method. +# +# The factory is the interface to pip's internal mechanisms. It is stateless, +# and is created by the resolver and held as a property of the provider. It is +# responsible for creating Requirement and Candidate objects, and provides +# services to those objects (access to pip's finder and preparer). + + +D = TypeVar("D") +V = TypeVar("V") + + +def _get_with_identifier( + mapping: Mapping[str, V], + identifier: str, + default: D, +) -> Union[D, V]: + """Get item from a package name lookup mapping with a resolver identifier. + + This extra logic is needed when the target mapping is keyed by package + name, which cannot be directly looked up with an identifier (which may + contain requested extras). Additional logic is added to also look up a value + by "cleaning up" the extras from the identifier. + """ + if identifier in mapping: + return mapping[identifier] + # HACK: Theoretically we should check whether this identifier is a valid + # "NAME[EXTRAS]" format, and parse out the name part with packaging or + # some regular expression. But since pip's resolver only spits out three + # kinds of identifiers: normalized PEP 503 names, normalized names plus + # extras, and Requires-Python, we can cheat a bit here. + name, open_bracket, _ = identifier.partition("[") + if open_bracket and name in mapping: + return mapping[name] + return default + + +class PipProvider(_ProviderBase): + """Pip's provider implementation for resolvelib. + + :params constraints: A mapping of constraints specified by the user. Keys + are canonicalized project names. + :params ignore_dependencies: Whether the user specified ``--no-deps``. + :params upgrade_strategy: The user-specified upgrade strategy. + :params user_requested: A set of canonicalized package names that the user + supplied for pip to install/upgrade. + """ + + def __init__( + self, + factory: Factory, + constraints: Dict[str, Constraint], + ignore_dependencies: bool, + upgrade_strategy: str, + user_requested: Dict[str, int], + ) -> None: + self._factory = factory + self._constraints = constraints + self._ignore_dependencies = ignore_dependencies + self._upgrade_strategy = upgrade_strategy + self._user_requested = user_requested + self._known_depths: Dict[str, float] = collections.defaultdict(lambda: math.inf) + + def identify(self, requirement_or_candidate: Union[Requirement, Candidate]) -> str: + return requirement_or_candidate.name + + def get_preference( + self, + identifier: str, + resolutions: Mapping[str, Candidate], + candidates: Mapping[str, Iterator[Candidate]], + information: Mapping[str, Iterable["PreferenceInformation"]], + backtrack_causes: Sequence["PreferenceInformation"], + ) -> "Preference": + """Produce a sort key for given requirement based on preference. + + The lower the return value is, the more preferred this group of + arguments is. + + Currently pip considers the following in order: + + * Prefer if any of the known requirements is "direct", e.g. points to an + explicit URL. + * If equal, prefer if any requirement is "pinned", i.e. contains + operator ``===`` or ``==``. + * If equal, calculate an approximate "depth" and resolve requirements + closer to the user-specified requirements first. If the depth cannot + by determined (eg: due to no matching parents), it is considered + infinite. + * Order user-specified requirements by the order they are specified. + * If equal, prefers "non-free" requirements, i.e. contains at least one + operator, such as ``>=`` or ``<``. + * If equal, order alphabetically for consistency (helps debuggability). + """ + try: + next(iter(information[identifier])) + except StopIteration: + # There is no information for this identifier, so there's no known + # candidates. + has_information = False + else: + has_information = True + + if has_information: + lookups = (r.get_candidate_lookup() for r, _ in information[identifier]) + candidate, ireqs = zip(*lookups) + else: + candidate, ireqs = None, () + + operators = [ + specifier.operator + for specifier_set in (ireq.specifier for ireq in ireqs if ireq) + for specifier in specifier_set + ] + + direct = candidate is not None + pinned = any(op[:2] == "==" for op in operators) + unfree = bool(operators) + + try: + requested_order: Union[int, float] = self._user_requested[identifier] + except KeyError: + requested_order = math.inf + if has_information: + parent_depths = ( + self._known_depths[parent.name] if parent is not None else 0.0 + for _, parent in information[identifier] + ) + inferred_depth = min(d for d in parent_depths) + 1.0 + else: + inferred_depth = math.inf + else: + inferred_depth = 1.0 + self._known_depths[identifier] = inferred_depth + + requested_order = self._user_requested.get(identifier, math.inf) + + # Requires-Python has only one candidate and the check is basically + # free, so we always do it first to avoid needless work if it fails. + requires_python = identifier == REQUIRES_PYTHON_IDENTIFIER + + # Prefer the causes of backtracking on the assumption that the problem + # resolving the dependency tree is related to the failures that caused + # the backtracking + backtrack_cause = self.is_backtrack_cause(identifier, backtrack_causes) + + return ( + not requires_python, + not direct, + not pinned, + not backtrack_cause, + inferred_depth, + requested_order, + not unfree, + identifier, + ) + + def find_matches( + self, + identifier: str, + requirements: Mapping[str, Iterator[Requirement]], + incompatibilities: Mapping[str, Iterator[Candidate]], + ) -> Iterable[Candidate]: + def _eligible_for_upgrade(identifier: str) -> bool: + """Are upgrades allowed for this project? + + This checks the upgrade strategy, and whether the project was one + that the user specified in the command line, in order to decide + whether we should upgrade if there's a newer version available. + + (Note that we don't need access to the `--upgrade` flag, because + an upgrade strategy of "to-satisfy-only" means that `--upgrade` + was not specified). + """ + if self._upgrade_strategy == "eager": + return True + elif self._upgrade_strategy == "only-if-needed": + user_order = _get_with_identifier( + self._user_requested, + identifier, + default=None, + ) + return user_order is not None + return False + + constraint = _get_with_identifier( + self._constraints, + identifier, + default=Constraint.empty(), + ) + return self._factory.find_candidates( + identifier=identifier, + requirements=requirements, + constraint=constraint, + prefers_installed=(not _eligible_for_upgrade(identifier)), + incompatibilities=incompatibilities, + is_satisfied_by=self.is_satisfied_by, + ) + + @lru_cache(maxsize=None) + def is_satisfied_by(self, requirement: Requirement, candidate: Candidate) -> bool: + return requirement.is_satisfied_by(candidate) + + def get_dependencies(self, candidate: Candidate) -> Sequence[Requirement]: + with_requires = not self._ignore_dependencies + return [r for r in candidate.iter_dependencies(with_requires) if r is not None] + + @staticmethod + def is_backtrack_cause( + identifier: str, backtrack_causes: Sequence["PreferenceInformation"] + ) -> bool: + for backtrack_cause in backtrack_causes: + if identifier == backtrack_cause.requirement.name: + return True + if backtrack_cause.parent and identifier == backtrack_cause.parent.name: + return True + return False diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/reporter.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/reporter.py new file mode 100644 index 0000000..0594569 --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/reporter.py @@ -0,0 +1,81 @@ +from collections import defaultdict +from logging import getLogger +from typing import Any, DefaultDict + +from pip._vendor.resolvelib.reporters import BaseReporter + +from .base import Candidate, Requirement + +logger = getLogger(__name__) + + +class PipReporter(BaseReporter): + def __init__(self) -> None: + self.reject_count_by_package: DefaultDict[str, int] = defaultdict(int) + + self._messages_at_reject_count = { + 1: ( + "pip is looking at multiple versions of {package_name} to " + "determine which version is compatible with other " + "requirements. This could take a while." + ), + 8: ( + "pip is still looking at multiple versions of {package_name} to " + "determine which version is compatible with other " + "requirements. This could take a while." + ), + 13: ( + "This is taking longer than usual. You might need to provide " + "the dependency resolver with stricter constraints to reduce " + "runtime. See https://pip.pypa.io/warnings/backtracking for " + "guidance. If you want to abort this run, press Ctrl + C." + ), + } + + def rejecting_candidate(self, criterion: Any, candidate: Candidate) -> None: + self.reject_count_by_package[candidate.name] += 1 + + count = self.reject_count_by_package[candidate.name] + if count not in self._messages_at_reject_count: + return + + message = self._messages_at_reject_count[count] + logger.info("INFO: %s", message.format(package_name=candidate.name)) + + msg = "Will try a different candidate, due to conflict:" + for req_info in criterion.information: + req, parent = req_info.requirement, req_info.parent + # Inspired by Factory.get_installation_error + msg += "\n " + if parent: + msg += f"{parent.name} {parent.version} depends on " + else: + msg += "The user requested " + msg += req.format_for_error() + logger.debug(msg) + + +class PipDebuggingReporter(BaseReporter): + """A reporter that does an info log for every event it sees.""" + + def starting(self) -> None: + logger.info("Reporter.starting()") + + def starting_round(self, index: int) -> None: + logger.info("Reporter.starting_round(%r)", index) + + def ending_round(self, index: int, state: Any) -> None: + logger.info("Reporter.ending_round(%r, state)", index) + logger.debug("Reporter.ending_round(%r, %r)", index, state) + + def ending(self, state: Any) -> None: + logger.info("Reporter.ending(%r)", state) + + def adding_requirement(self, requirement: Requirement, parent: Candidate) -> None: + logger.info("Reporter.adding_requirement(%r, %r)", requirement, parent) + + def rejecting_candidate(self, criterion: Any, candidate: Candidate) -> None: + logger.info("Reporter.rejecting_candidate(%r, %r)", criterion, candidate) + + def pinning(self, candidate: Candidate) -> None: + logger.info("Reporter.pinning(%r)", candidate) diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/requirements.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/requirements.py new file mode 100644 index 0000000..b04f41b --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/requirements.py @@ -0,0 +1,245 @@ +from typing import Any, Optional + +from pip._vendor.packaging.specifiers import SpecifierSet +from pip._vendor.packaging.utils import NormalizedName, canonicalize_name + +from pip._internal.req.constructors import install_req_drop_extras +from pip._internal.req.req_install import InstallRequirement + +from .base import Candidate, CandidateLookup, Requirement, format_name + + +class ExplicitRequirement(Requirement): + def __init__(self, candidate: Candidate) -> None: + self.candidate = candidate + + def __str__(self) -> str: + return str(self.candidate) + + def __repr__(self) -> str: + return f"{self.__class__.__name__}({self.candidate!r})" + + def __hash__(self) -> int: + return hash(self.candidate) + + def __eq__(self, other: Any) -> bool: + if not isinstance(other, ExplicitRequirement): + return False + return self.candidate == other.candidate + + @property + def project_name(self) -> NormalizedName: + # No need to canonicalize - the candidate did this + return self.candidate.project_name + + @property + def name(self) -> str: + # No need to canonicalize - the candidate did this + return self.candidate.name + + def format_for_error(self) -> str: + return self.candidate.format_for_error() + + def get_candidate_lookup(self) -> CandidateLookup: + return self.candidate, None + + def is_satisfied_by(self, candidate: Candidate) -> bool: + return candidate == self.candidate + + +class SpecifierRequirement(Requirement): + def __init__(self, ireq: InstallRequirement) -> None: + assert ireq.link is None, "This is a link, not a specifier" + self._ireq = ireq + self._equal_cache: Optional[str] = None + self._hash: Optional[int] = None + self._extras = frozenset(canonicalize_name(e) for e in self._ireq.extras) + + @property + def _equal(self) -> str: + if self._equal_cache is not None: + return self._equal_cache + + self._equal_cache = str(self._ireq) + return self._equal_cache + + def __str__(self) -> str: + return str(self._ireq.req) + + def __repr__(self) -> str: + return f"{self.__class__.__name__}({str(self._ireq.req)!r})" + + def __eq__(self, other: object) -> bool: + if not isinstance(other, SpecifierRequirement): + return NotImplemented + return self._equal == other._equal + + def __hash__(self) -> int: + if self._hash is not None: + return self._hash + + self._hash = hash(self._equal) + return self._hash + + @property + def project_name(self) -> NormalizedName: + assert self._ireq.req, "Specifier-backed ireq is always PEP 508" + return canonicalize_name(self._ireq.req.name) + + @property + def name(self) -> str: + return format_name(self.project_name, self._extras) + + def format_for_error(self) -> str: + # Convert comma-separated specifiers into "A, B, ..., F and G" + # This makes the specifier a bit more "human readable", without + # risking a change in meaning. (Hopefully! Not all edge cases have + # been checked) + parts = [s.strip() for s in str(self).split(",")] + if len(parts) == 0: + return "" + elif len(parts) == 1: + return parts[0] + + return ", ".join(parts[:-1]) + " and " + parts[-1] + + def get_candidate_lookup(self) -> CandidateLookup: + return None, self._ireq + + def is_satisfied_by(self, candidate: Candidate) -> bool: + assert candidate.name == self.name, ( + f"Internal issue: Candidate is not for this requirement " + f"{candidate.name} vs {self.name}" + ) + # We can safely always allow prereleases here since PackageFinder + # already implements the prerelease logic, and would have filtered out + # prerelease candidates if the user does not expect them. + assert self._ireq.req, "Specifier-backed ireq is always PEP 508" + spec = self._ireq.req.specifier + return spec.contains(candidate.version, prereleases=True) + + +class SpecifierWithoutExtrasRequirement(SpecifierRequirement): + """ + Requirement backed by an install requirement on a base package. + Trims extras from its install requirement if there are any. + """ + + def __init__(self, ireq: InstallRequirement) -> None: + assert ireq.link is None, "This is a link, not a specifier" + self._ireq = install_req_drop_extras(ireq) + self._equal_cache: Optional[str] = None + self._hash: Optional[int] = None + self._extras = frozenset(canonicalize_name(e) for e in self._ireq.extras) + + @property + def _equal(self) -> str: + if self._equal_cache is not None: + return self._equal_cache + + self._equal_cache = str(self._ireq) + return self._equal_cache + + def __eq__(self, other: object) -> bool: + if not isinstance(other, SpecifierWithoutExtrasRequirement): + return NotImplemented + return self._equal == other._equal + + def __hash__(self) -> int: + if self._hash is not None: + return self._hash + + self._hash = hash(self._equal) + return self._hash + + +class RequiresPythonRequirement(Requirement): + """A requirement representing Requires-Python metadata.""" + + def __init__(self, specifier: SpecifierSet, match: Candidate) -> None: + self.specifier = specifier + self._specifier_string = str(specifier) # for faster __eq__ + self._hash: Optional[int] = None + self._candidate = match + + def __str__(self) -> str: + return f"Python {self.specifier}" + + def __repr__(self) -> str: + return f"{self.__class__.__name__}({str(self.specifier)!r})" + + def __hash__(self) -> int: + if self._hash is not None: + return self._hash + + self._hash = hash((self._specifier_string, self._candidate)) + return self._hash + + def __eq__(self, other: Any) -> bool: + if not isinstance(other, RequiresPythonRequirement): + return False + return ( + self._specifier_string == other._specifier_string + and self._candidate == other._candidate + ) + + @property + def project_name(self) -> NormalizedName: + return self._candidate.project_name + + @property + def name(self) -> str: + return self._candidate.name + + def format_for_error(self) -> str: + return str(self) + + def get_candidate_lookup(self) -> CandidateLookup: + if self.specifier.contains(self._candidate.version, prereleases=True): + return self._candidate, None + return None, None + + def is_satisfied_by(self, candidate: Candidate) -> bool: + assert candidate.name == self._candidate.name, "Not Python candidate" + # We can safely always allow prereleases here since PackageFinder + # already implements the prerelease logic, and would have filtered out + # prerelease candidates if the user does not expect them. + return self.specifier.contains(candidate.version, prereleases=True) + + +class UnsatisfiableRequirement(Requirement): + """A requirement that cannot be satisfied.""" + + def __init__(self, name: NormalizedName) -> None: + self._name = name + + def __str__(self) -> str: + return f"{self._name} (unavailable)" + + def __repr__(self) -> str: + return f"{self.__class__.__name__}({str(self._name)!r})" + + def __eq__(self, other: object) -> bool: + if not isinstance(other, UnsatisfiableRequirement): + return NotImplemented + return self._name == other._name + + def __hash__(self) -> int: + return hash(self._name) + + @property + def project_name(self) -> NormalizedName: + return self._name + + @property + def name(self) -> str: + return self._name + + def format_for_error(self) -> str: + return str(self) + + def get_candidate_lookup(self) -> CandidateLookup: + return None, None + + def is_satisfied_by(self, candidate: Candidate) -> bool: + return False diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/resolver.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/resolver.py new file mode 100644 index 0000000..c12beef --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/resolver.py @@ -0,0 +1,317 @@ +import contextlib +import functools +import logging +import os +from typing import TYPE_CHECKING, Dict, List, Optional, Set, Tuple, cast + +from pip._vendor.packaging.utils import canonicalize_name +from pip._vendor.resolvelib import BaseReporter, ResolutionImpossible +from pip._vendor.resolvelib import Resolver as RLResolver +from pip._vendor.resolvelib.structs import DirectedGraph + +from pip._internal.cache import WheelCache +from pip._internal.index.package_finder import PackageFinder +from pip._internal.operations.prepare import RequirementPreparer +from pip._internal.req.constructors import install_req_extend_extras +from pip._internal.req.req_install import InstallRequirement +from pip._internal.req.req_set import RequirementSet +from pip._internal.resolution.base import BaseResolver, InstallRequirementProvider +from pip._internal.resolution.resolvelib.provider import PipProvider +from pip._internal.resolution.resolvelib.reporter import ( + PipDebuggingReporter, + PipReporter, +) +from pip._internal.utils.packaging import get_requirement + +from .base import Candidate, Requirement +from .factory import Factory + +if TYPE_CHECKING: + from pip._vendor.resolvelib.resolvers import Result as RLResult + + Result = RLResult[Requirement, Candidate, str] + + +logger = logging.getLogger(__name__) + + +class Resolver(BaseResolver): + _allowed_strategies = {"eager", "only-if-needed", "to-satisfy-only"} + + def __init__( + self, + preparer: RequirementPreparer, + finder: PackageFinder, + wheel_cache: Optional[WheelCache], + make_install_req: InstallRequirementProvider, + use_user_site: bool, + ignore_dependencies: bool, + ignore_installed: bool, + ignore_requires_python: bool, + force_reinstall: bool, + upgrade_strategy: str, + py_version_info: Optional[Tuple[int, ...]] = None, + ): + super().__init__() + assert upgrade_strategy in self._allowed_strategies + + self.factory = Factory( + finder=finder, + preparer=preparer, + make_install_req=make_install_req, + wheel_cache=wheel_cache, + use_user_site=use_user_site, + force_reinstall=force_reinstall, + ignore_installed=ignore_installed, + ignore_requires_python=ignore_requires_python, + py_version_info=py_version_info, + ) + self.ignore_dependencies = ignore_dependencies + self.upgrade_strategy = upgrade_strategy + self._result: Optional[Result] = None + + def resolve( + self, root_reqs: List[InstallRequirement], check_supported_wheels: bool + ) -> RequirementSet: + collected = self.factory.collect_root_requirements(root_reqs) + provider = PipProvider( + factory=self.factory, + constraints=collected.constraints, + ignore_dependencies=self.ignore_dependencies, + upgrade_strategy=self.upgrade_strategy, + user_requested=collected.user_requested, + ) + if "PIP_RESOLVER_DEBUG" in os.environ: + reporter: BaseReporter = PipDebuggingReporter() + else: + reporter = PipReporter() + resolver: RLResolver[Requirement, Candidate, str] = RLResolver( + provider, + reporter, + ) + + try: + limit_how_complex_resolution_can_be = 200000 + result = self._result = resolver.resolve( + collected.requirements, max_rounds=limit_how_complex_resolution_can_be + ) + + except ResolutionImpossible as e: + error = self.factory.get_installation_error( + cast("ResolutionImpossible[Requirement, Candidate]", e), + collected.constraints, + ) + raise error from e + + req_set = RequirementSet(check_supported_wheels=check_supported_wheels) + # process candidates with extras last to ensure their base equivalent is + # already in the req_set if appropriate. + # Python's sort is stable so using a binary key function keeps relative order + # within both subsets. + for candidate in sorted( + result.mapping.values(), key=lambda c: c.name != c.project_name + ): + ireq = candidate.get_install_requirement() + if ireq is None: + if candidate.name != candidate.project_name: + # extend existing req's extras + with contextlib.suppress(KeyError): + req = req_set.get_requirement(candidate.project_name) + req_set.add_named_requirement( + install_req_extend_extras( + req, get_requirement(candidate.name).extras + ) + ) + continue + + # Check if there is already an installation under the same name, + # and set a flag for later stages to uninstall it, if needed. + installed_dist = self.factory.get_dist_to_uninstall(candidate) + if installed_dist is None: + # There is no existing installation -- nothing to uninstall. + ireq.should_reinstall = False + elif self.factory.force_reinstall: + # The --force-reinstall flag is set -- reinstall. + ireq.should_reinstall = True + elif installed_dist.version != candidate.version: + # The installation is different in version -- reinstall. + ireq.should_reinstall = True + elif candidate.is_editable or installed_dist.editable: + # The incoming distribution is editable, or different in + # editable-ness to installation -- reinstall. + ireq.should_reinstall = True + elif candidate.source_link and candidate.source_link.is_file: + # The incoming distribution is under file:// + if candidate.source_link.is_wheel: + # is a local wheel -- do nothing. + logger.info( + "%s is already installed with the same version as the " + "provided wheel. Use --force-reinstall to force an " + "installation of the wheel.", + ireq.name, + ) + continue + + # is a local sdist or path -- reinstall + ireq.should_reinstall = True + else: + continue + + link = candidate.source_link + if link and link.is_yanked: + # The reason can contain non-ASCII characters, Unicode + # is required for Python 2. + msg = ( + "The candidate selected for download or install is a " + "yanked version: {name!r} candidate (version {version} " + "at {link})\nReason for being yanked: {reason}" + ).format( + name=candidate.name, + version=candidate.version, + link=link, + reason=link.yanked_reason or "", + ) + logger.warning(msg) + + req_set.add_named_requirement(ireq) + + reqs = req_set.all_requirements + self.factory.preparer.prepare_linked_requirements_more(reqs) + for req in reqs: + req.prepared = True + req.needs_more_preparation = False + return req_set + + def get_installation_order( + self, req_set: RequirementSet + ) -> List[InstallRequirement]: + """Get order for installation of requirements in RequirementSet. + + The returned list contains a requirement before another that depends on + it. This helps ensure that the environment is kept consistent as they + get installed one-by-one. + + The current implementation creates a topological ordering of the + dependency graph, giving more weight to packages with less + or no dependencies, while breaking any cycles in the graph at + arbitrary points. We make no guarantees about where the cycle + would be broken, other than it *would* be broken. + """ + assert self._result is not None, "must call resolve() first" + + if not req_set.requirements: + # Nothing is left to install, so we do not need an order. + return [] + + graph = self._result.graph + weights = get_topological_weights(graph, set(req_set.requirements.keys())) + + sorted_items = sorted( + req_set.requirements.items(), + key=functools.partial(_req_set_item_sorter, weights=weights), + reverse=True, + ) + return [ireq for _, ireq in sorted_items] + + +def get_topological_weights( + graph: "DirectedGraph[Optional[str]]", requirement_keys: Set[str] +) -> Dict[Optional[str], int]: + """Assign weights to each node based on how "deep" they are. + + This implementation may change at any point in the future without prior + notice. + + We first simplify the dependency graph by pruning any leaves and giving them + the highest weight: a package without any dependencies should be installed + first. This is done again and again in the same way, giving ever less weight + to the newly found leaves. The loop stops when no leaves are left: all + remaining packages have at least one dependency left in the graph. + + Then we continue with the remaining graph, by taking the length for the + longest path to any node from root, ignoring any paths that contain a single + node twice (i.e. cycles). This is done through a depth-first search through + the graph, while keeping track of the path to the node. + + Cycles in the graph result would result in node being revisited while also + being on its own path. In this case, take no action. This helps ensure we + don't get stuck in a cycle. + + When assigning weight, the longer path (i.e. larger length) is preferred. + + We are only interested in the weights of packages that are in the + requirement_keys. + """ + path: Set[Optional[str]] = set() + weights: Dict[Optional[str], int] = {} + + def visit(node: Optional[str]) -> None: + if node in path: + # We hit a cycle, so we'll break it here. + return + + # Time to visit the children! + path.add(node) + for child in graph.iter_children(node): + visit(child) + path.remove(node) + + if node not in requirement_keys: + return + + last_known_parent_count = weights.get(node, 0) + weights[node] = max(last_known_parent_count, len(path)) + + # Simplify the graph, pruning leaves that have no dependencies. + # This is needed for large graphs (say over 200 packages) because the + # `visit` function is exponentially slower then, taking minutes. + # See https://github.com/pypa/pip/issues/10557 + # We will loop until we explicitly break the loop. + while True: + leaves = set() + for key in graph: + if key is None: + continue + for _child in graph.iter_children(key): + # This means we have at least one child + break + else: + # No child. + leaves.add(key) + if not leaves: + # We are done simplifying. + break + # Calculate the weight for the leaves. + weight = len(graph) - 1 + for leaf in leaves: + if leaf not in requirement_keys: + continue + weights[leaf] = weight + # Remove the leaves from the graph, making it simpler. + for leaf in leaves: + graph.remove(leaf) + + # Visit the remaining graph. + # `None` is guaranteed to be the root node by resolvelib. + visit(None) + + # Sanity check: all requirement keys should be in the weights, + # and no other keys should be in the weights. + difference = set(weights.keys()).difference(requirement_keys) + assert not difference, difference + + return weights + + +def _req_set_item_sorter( + item: Tuple[str, InstallRequirement], + weights: Dict[Optional[str], int], +) -> Tuple[int, str]: + """Key function used to sort install requirements for installation. + + Based on the "weight" mapping calculated in ``get_installation_order()``. + The canonical package name is returned as the second member as a tie- + breaker to ensure the result is predictable, which is useful in tests. + """ + name = canonicalize_name(item[0]) + return weights[name], name diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/self_outdated_check.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/self_outdated_check.py new file mode 100644 index 0000000..2e0e3df --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/self_outdated_check.py @@ -0,0 +1,252 @@ +import datetime +import functools +import hashlib +import json +import logging +import optparse +import os.path +import sys +from dataclasses import dataclass +from typing import Any, Callable, Dict, Optional + +from pip._vendor.packaging.version import Version +from pip._vendor.packaging.version import parse as parse_version +from pip._vendor.rich.console import Group +from pip._vendor.rich.markup import escape +from pip._vendor.rich.text import Text + +from pip._internal.index.collector import LinkCollector +from pip._internal.index.package_finder import PackageFinder +from pip._internal.metadata import get_default_environment +from pip._internal.models.selection_prefs import SelectionPreferences +from pip._internal.network.session import PipSession +from pip._internal.utils.compat import WINDOWS +from pip._internal.utils.entrypoints import ( + get_best_invocation_for_this_pip, + get_best_invocation_for_this_python, +) +from pip._internal.utils.filesystem import adjacent_tmp_file, check_path_owner, replace +from pip._internal.utils.misc import ( + ExternallyManagedEnvironment, + check_externally_managed, + ensure_dir, +) + +_WEEK = datetime.timedelta(days=7) + +logger = logging.getLogger(__name__) + + +def _get_statefile_name(key: str) -> str: + key_bytes = key.encode() + name = hashlib.sha224(key_bytes).hexdigest() + return name + + +def _convert_date(isodate: str) -> datetime.datetime: + """Convert an ISO format string to a date. + + Handles the format 2020-01-22T14:24:01Z (trailing Z) + which is not supported by older versions of fromisoformat. + """ + return datetime.datetime.fromisoformat(isodate.replace("Z", "+00:00")) + + +class SelfCheckState: + def __init__(self, cache_dir: str) -> None: + self._state: Dict[str, Any] = {} + self._statefile_path = None + + # Try to load the existing state + if cache_dir: + self._statefile_path = os.path.join( + cache_dir, "selfcheck", _get_statefile_name(self.key) + ) + try: + with open(self._statefile_path, encoding="utf-8") as statefile: + self._state = json.load(statefile) + except (OSError, ValueError, KeyError): + # Explicitly suppressing exceptions, since we don't want to + # error out if the cache file is invalid. + pass + + @property + def key(self) -> str: + return sys.prefix + + def get(self, current_time: datetime.datetime) -> Optional[str]: + """Check if we have a not-outdated version loaded already.""" + if not self._state: + return None + + if "last_check" not in self._state: + return None + + if "pypi_version" not in self._state: + return None + + # Determine if we need to refresh the state + last_check = _convert_date(self._state["last_check"]) + time_since_last_check = current_time - last_check + if time_since_last_check > _WEEK: + return None + + return self._state["pypi_version"] + + def set(self, pypi_version: str, current_time: datetime.datetime) -> None: + # If we do not have a path to cache in, don't bother saving. + if not self._statefile_path: + return + + # Check to make sure that we own the directory + if not check_path_owner(os.path.dirname(self._statefile_path)): + return + + # Now that we've ensured the directory is owned by this user, we'll go + # ahead and make sure that all our directories are created. + ensure_dir(os.path.dirname(self._statefile_path)) + + state = { + # Include the key so it's easy to tell which pip wrote the + # file. + "key": self.key, + "last_check": current_time.isoformat(), + "pypi_version": pypi_version, + } + + text = json.dumps(state, sort_keys=True, separators=(",", ":")) + + with adjacent_tmp_file(self._statefile_path) as f: + f.write(text.encode()) + + try: + # Since we have a prefix-specific state file, we can just + # overwrite whatever is there, no need to check. + replace(f.name, self._statefile_path) + except OSError: + # Best effort. + pass + + +@dataclass +class UpgradePrompt: + old: str + new: str + + def __rich__(self) -> Group: + if WINDOWS: + pip_cmd = f"{get_best_invocation_for_this_python()} -m pip" + else: + pip_cmd = get_best_invocation_for_this_pip() + + notice = "[bold][[reset][blue]notice[reset][bold]][reset]" + return Group( + Text(), + Text.from_markup( + f"{notice} A new release of pip is available: " + f"[red]{self.old}[reset] -> [green]{self.new}[reset]" + ), + Text.from_markup( + f"{notice} To update, run: " + f"[green]{escape(pip_cmd)} install --upgrade pip" + ), + ) + + +def was_installed_by_pip(pkg: str) -> bool: + """Checks whether pkg was installed by pip + + This is used not to display the upgrade message when pip is in fact + installed by system package manager, such as dnf on Fedora. + """ + dist = get_default_environment().get_distribution(pkg) + return dist is not None and "pip" == dist.installer + + +def _get_current_remote_pip_version( + session: PipSession, options: optparse.Values +) -> Optional[str]: + # Lets use PackageFinder to see what the latest pip version is + link_collector = LinkCollector.create( + session, + options=options, + suppress_no_index=True, + ) + + # Pass allow_yanked=False so we don't suggest upgrading to a + # yanked version. + selection_prefs = SelectionPreferences( + allow_yanked=False, + allow_all_prereleases=False, # Explicitly set to False + ) + + finder = PackageFinder.create( + link_collector=link_collector, + selection_prefs=selection_prefs, + ) + best_candidate = finder.find_best_candidate("pip").best_candidate + if best_candidate is None: + return None + + return str(best_candidate.version) + + +def _self_version_check_logic( + *, + state: SelfCheckState, + current_time: datetime.datetime, + local_version: Version, + get_remote_version: Callable[[], Optional[str]], +) -> Optional[UpgradePrompt]: + remote_version_str = state.get(current_time) + if remote_version_str is None: + remote_version_str = get_remote_version() + if remote_version_str is None: + logger.debug("No remote pip version found") + return None + state.set(remote_version_str, current_time) + + remote_version = parse_version(remote_version_str) + logger.debug("Remote version of pip: %s", remote_version) + logger.debug("Local version of pip: %s", local_version) + + pip_installed_by_pip = was_installed_by_pip("pip") + logger.debug("Was pip installed by pip? %s", pip_installed_by_pip) + if not pip_installed_by_pip: + return None # Only suggest upgrade if pip is installed by pip. + + local_version_is_older = ( + local_version < remote_version + and local_version.base_version != remote_version.base_version + ) + if local_version_is_older: + return UpgradePrompt(old=str(local_version), new=remote_version_str) + + return None + + +def pip_self_version_check(session: PipSession, options: optparse.Values) -> None: + """Check for an update for pip. + + Limit the frequency of checks to once per week. State is stored either in + the active virtualenv or in the user's USER_CACHE_DIR keyed off the prefix + of the pip script path. + """ + installed_dist = get_default_environment().get_distribution("pip") + if not installed_dist: + return + try: + check_externally_managed() + except ExternallyManagedEnvironment: + return + + upgrade_prompt = _self_version_check_logic( + state=SelfCheckState(cache_dir=options.cache_dir), + current_time=datetime.datetime.now(datetime.timezone.utc), + local_version=installed_dist.version, + get_remote_version=functools.partial( + _get_current_remote_pip_version, session, options + ), + ) + if upgrade_prompt is not None: + logger.warning("%s", upgrade_prompt, extra={"rich": True}) diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/__init__.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/__init__.py new file mode 100644 index 0000000..e69de29 diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/__init__.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000..e0dd887 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/__init__.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/_jaraco_text.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/_jaraco_text.cpython-312.pyc new file mode 100644 index 0000000..40c6c43 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/_jaraco_text.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/_log.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/_log.cpython-312.pyc new file mode 100644 index 0000000..24a0953 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/_log.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/appdirs.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/appdirs.cpython-312.pyc new file mode 100644 index 0000000..e0a922b Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/appdirs.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/compat.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/compat.cpython-312.pyc new file mode 100644 index 0000000..08ac017 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/compat.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/compatibility_tags.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/compatibility_tags.cpython-312.pyc new file mode 100644 index 0000000..8961d0b Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/compatibility_tags.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/datetime.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/datetime.cpython-312.pyc new file mode 100644 index 0000000..eb60d8b Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/datetime.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/deprecation.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/deprecation.cpython-312.pyc new file mode 100644 index 0000000..b3aabe8 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/deprecation.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/direct_url_helpers.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/direct_url_helpers.cpython-312.pyc new file mode 100644 index 0000000..7dbe45d Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/direct_url_helpers.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/egg_link.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/egg_link.cpython-312.pyc new file mode 100644 index 0000000..8daa2b4 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/egg_link.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/entrypoints.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/entrypoints.cpython-312.pyc new file mode 100644 index 0000000..f28a8e8 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/entrypoints.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/filesystem.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/filesystem.cpython-312.pyc new file mode 100644 index 0000000..ad7ad13 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/filesystem.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/filetypes.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/filetypes.cpython-312.pyc new file mode 100644 index 0000000..780ac0d Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/filetypes.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/glibc.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/glibc.cpython-312.pyc new file mode 100644 index 0000000..6f13e2c Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/glibc.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/hashes.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/hashes.cpython-312.pyc new file mode 100644 index 0000000..2a7613d Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/hashes.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/logging.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/logging.cpython-312.pyc new file mode 100644 index 0000000..e26ff4f Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/logging.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/misc.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/misc.cpython-312.pyc new file mode 100644 index 0000000..201695f Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/misc.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/packaging.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/packaging.cpython-312.pyc new file mode 100644 index 0000000..63f9304 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/packaging.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/retry.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/retry.cpython-312.pyc new file mode 100644 index 0000000..75cd841 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/retry.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/setuptools_build.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/setuptools_build.cpython-312.pyc new file mode 100644 index 0000000..928e663 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/setuptools_build.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/subprocess.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/subprocess.cpython-312.pyc new file mode 100644 index 0000000..885a04c Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/subprocess.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/temp_dir.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/temp_dir.cpython-312.pyc new file mode 100644 index 0000000..75490b7 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/temp_dir.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/unpacking.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/unpacking.cpython-312.pyc new file mode 100644 index 0000000..c7bc0dc Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/unpacking.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/urls.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/urls.cpython-312.pyc new file mode 100644 index 0000000..35e3f85 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/urls.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/virtualenv.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/virtualenv.cpython-312.pyc new file mode 100644 index 0000000..525b74c Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/virtualenv.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/wheel.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/wheel.cpython-312.pyc new file mode 100644 index 0000000..7ca4b4a Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/wheel.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/_jaraco_text.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/_jaraco_text.py new file mode 100644 index 0000000..6ccf53b --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/_jaraco_text.py @@ -0,0 +1,109 @@ +"""Functions brought over from jaraco.text. + +These functions are not supposed to be used within `pip._internal`. These are +helper functions brought over from `jaraco.text` to enable vendoring newer +copies of `pkg_resources` without having to vendor `jaraco.text` and its entire +dependency cone; something that our vendoring setup is not currently capable of +handling. + +License reproduced from original source below: + +Copyright Jason R. Coombs + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to +deal in the Software without restriction, including without limitation the +rights to use, copy, modify, merge, publish, distribute, sublicense, and/or +sell copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in +all copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING +FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS +IN THE SOFTWARE. +""" + +import functools +import itertools + + +def _nonblank(str): + return str and not str.startswith("#") + + +@functools.singledispatch +def yield_lines(iterable): + r""" + Yield valid lines of a string or iterable. + + >>> list(yield_lines('')) + [] + >>> list(yield_lines(['foo', 'bar'])) + ['foo', 'bar'] + >>> list(yield_lines('foo\nbar')) + ['foo', 'bar'] + >>> list(yield_lines('\nfoo\n#bar\nbaz #comment')) + ['foo', 'baz #comment'] + >>> list(yield_lines(['foo\nbar', 'baz', 'bing\n\n\n'])) + ['foo', 'bar', 'baz', 'bing'] + """ + return itertools.chain.from_iterable(map(yield_lines, iterable)) + + +@yield_lines.register(str) +def _(text): + return filter(_nonblank, map(str.strip, text.splitlines())) + + +def drop_comment(line): + """ + Drop comments. + + >>> drop_comment('foo # bar') + 'foo' + + A hash without a space may be in a URL. + + >>> drop_comment('http://example.com/foo#bar') + 'http://example.com/foo#bar' + """ + return line.partition(" #")[0] + + +def join_continuation(lines): + r""" + Join lines continued by a trailing backslash. + + >>> list(join_continuation(['foo \\', 'bar', 'baz'])) + ['foobar', 'baz'] + >>> list(join_continuation(['foo \\', 'bar', 'baz'])) + ['foobar', 'baz'] + >>> list(join_continuation(['foo \\', 'bar \\', 'baz'])) + ['foobarbaz'] + + Not sure why, but... + The character preceding the backslash is also elided. + + >>> list(join_continuation(['goo\\', 'dly'])) + ['godly'] + + A terrible idea, but... + If no line is available to continue, suppress the lines. + + >>> list(join_continuation(['foo', 'bar\\', 'baz\\'])) + ['foo'] + """ + lines = iter(lines) + for item in lines: + while item.endswith("\\"): + try: + item = item[:-2].strip() + next(lines) + except StopIteration: + return + yield item diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/_log.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/_log.py new file mode 100644 index 0000000..92c4c6a --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/_log.py @@ -0,0 +1,38 @@ +"""Customize logging + +Defines custom logger class for the `logger.verbose(...)` method. + +init_logging() must be called before any other modules that call logging.getLogger. +""" + +import logging +from typing import Any, cast + +# custom log level for `--verbose` output +# between DEBUG and INFO +VERBOSE = 15 + + +class VerboseLogger(logging.Logger): + """Custom Logger, defining a verbose log-level + + VERBOSE is between INFO and DEBUG. + """ + + def verbose(self, msg: str, *args: Any, **kwargs: Any) -> None: + return self.log(VERBOSE, msg, *args, **kwargs) + + +def getLogger(name: str) -> VerboseLogger: + """logging.getLogger, but ensures our VerboseLogger class is returned""" + return cast(VerboseLogger, logging.getLogger(name)) + + +def init_logging() -> None: + """Register our VerboseLogger and VERBOSE log level. + + Should be called before any calls to getLogger(), + i.e. in pip._internal.__init__ + """ + logging.setLoggerClass(VerboseLogger) + logging.addLevelName(VERBOSE, "VERBOSE") diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/appdirs.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/appdirs.py new file mode 100644 index 0000000..16933bf --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/appdirs.py @@ -0,0 +1,52 @@ +""" +This code wraps the vendored appdirs module to so the return values are +compatible for the current pip code base. + +The intention is to rewrite current usages gradually, keeping the tests pass, +and eventually drop this after all usages are changed. +""" + +import os +import sys +from typing import List + +from pip._vendor import platformdirs as _appdirs + + +def user_cache_dir(appname: str) -> str: + return _appdirs.user_cache_dir(appname, appauthor=False) + + +def _macos_user_config_dir(appname: str, roaming: bool = True) -> str: + # Use ~/Application Support/pip, if the directory exists. + path = _appdirs.user_data_dir(appname, appauthor=False, roaming=roaming) + if os.path.isdir(path): + return path + + # Use a Linux-like ~/.config/pip, by default. + linux_like_path = "~/.config/" + if appname: + linux_like_path = os.path.join(linux_like_path, appname) + + return os.path.expanduser(linux_like_path) + + +def user_config_dir(appname: str, roaming: bool = True) -> str: + if sys.platform == "darwin": + return _macos_user_config_dir(appname, roaming) + + return _appdirs.user_config_dir(appname, appauthor=False, roaming=roaming) + + +# for the discussion regarding site_config_dir locations +# see +def site_config_dirs(appname: str) -> List[str]: + if sys.platform == "darwin": + return [_appdirs.site_data_dir(appname, appauthor=False, multipath=True)] + + dirval = _appdirs.site_config_dir(appname, appauthor=False, multipath=True) + if sys.platform == "win32": + return [dirval] + + # Unix-y system. Look in /etc as well. + return dirval.split(os.pathsep) + ["/etc"] diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/compat.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/compat.py new file mode 100644 index 0000000..d8b54e4 --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/compat.py @@ -0,0 +1,79 @@ +"""Stuff that differs in different Python versions and platform +distributions.""" + +import importlib.resources +import logging +import os +import sys +from typing import IO + +__all__ = ["get_path_uid", "stdlib_pkgs", "WINDOWS"] + + +logger = logging.getLogger(__name__) + + +def has_tls() -> bool: + try: + import _ssl # noqa: F401 # ignore unused + + return True + except ImportError: + pass + + from pip._vendor.urllib3.util import IS_PYOPENSSL + + return IS_PYOPENSSL + + +def get_path_uid(path: str) -> int: + """ + Return path's uid. + + Does not follow symlinks: + https://github.com/pypa/pip/pull/935#discussion_r5307003 + + Placed this function in compat due to differences on AIX and + Jython, that should eventually go away. + + :raises OSError: When path is a symlink or can't be read. + """ + if hasattr(os, "O_NOFOLLOW"): + fd = os.open(path, os.O_RDONLY | os.O_NOFOLLOW) + file_uid = os.fstat(fd).st_uid + os.close(fd) + else: # AIX and Jython + # WARNING: time of check vulnerability, but best we can do w/o NOFOLLOW + if not os.path.islink(path): + # older versions of Jython don't have `os.fstat` + file_uid = os.stat(path).st_uid + else: + # raise OSError for parity with os.O_NOFOLLOW above + raise OSError(f"{path} is a symlink; Will not return uid for symlinks") + return file_uid + + +# The importlib.resources.open_text function was deprecated in 3.11 with suggested +# replacement we use below. +if sys.version_info < (3, 11): + open_text_resource = importlib.resources.open_text +else: + + def open_text_resource( + package: str, resource: str, encoding: str = "utf-8", errors: str = "strict" + ) -> IO[str]: + return (importlib.resources.files(package) / resource).open( + "r", encoding=encoding, errors=errors + ) + + +# packages in the stdlib that may have installation metadata, but should not be +# considered 'installed'. this theoretically could be determined based on +# dist.location (py27:`sysconfig.get_paths()['stdlib']`, +# py26:sysconfig.get_config_vars('LIBDEST')), but fear platform variation may +# make this ineffective, so hard-coding +stdlib_pkgs = {"python", "wsgiref", "argparse"} + + +# windows detection, covers cpython and ironpython +WINDOWS = sys.platform.startswith("win") or (sys.platform == "cli" and os.name == "nt") diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/compatibility_tags.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/compatibility_tags.py new file mode 100644 index 0000000..2e7b745 --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/compatibility_tags.py @@ -0,0 +1,188 @@ +"""Generate and work with PEP 425 Compatibility Tags. +""" + +import re +from typing import List, Optional, Tuple + +from pip._vendor.packaging.tags import ( + PythonVersion, + Tag, + compatible_tags, + cpython_tags, + generic_tags, + interpreter_name, + interpreter_version, + ios_platforms, + mac_platforms, +) + +_apple_arch_pat = re.compile(r"(.+)_(\d+)_(\d+)_(.+)") + + +def version_info_to_nodot(version_info: Tuple[int, ...]) -> str: + # Only use up to the first two numbers. + return "".join(map(str, version_info[:2])) + + +def _mac_platforms(arch: str) -> List[str]: + match = _apple_arch_pat.match(arch) + if match: + name, major, minor, actual_arch = match.groups() + mac_version = (int(major), int(minor)) + arches = [ + # Since we have always only checked that the platform starts + # with "macosx", for backwards-compatibility we extract the + # actual prefix provided by the user in case they provided + # something like "macosxcustom_". It may be good to remove + # this as undocumented or deprecate it in the future. + "{}_{}".format(name, arch[len("macosx_") :]) + for arch in mac_platforms(mac_version, actual_arch) + ] + else: + # arch pattern didn't match (?!) + arches = [arch] + return arches + + +def _ios_platforms(arch: str) -> List[str]: + match = _apple_arch_pat.match(arch) + if match: + name, major, minor, actual_multiarch = match.groups() + ios_version = (int(major), int(minor)) + arches = [ + # Since we have always only checked that the platform starts + # with "ios", for backwards-compatibility we extract the + # actual prefix provided by the user in case they provided + # something like "ioscustom_". It may be good to remove + # this as undocumented or deprecate it in the future. + "{}_{}".format(name, arch[len("ios_") :]) + for arch in ios_platforms(ios_version, actual_multiarch) + ] + else: + # arch pattern didn't match (?!) + arches = [arch] + return arches + + +def _custom_manylinux_platforms(arch: str) -> List[str]: + arches = [arch] + arch_prefix, arch_sep, arch_suffix = arch.partition("_") + if arch_prefix == "manylinux2014": + # manylinux1/manylinux2010 wheels run on most manylinux2014 systems + # with the exception of wheels depending on ncurses. PEP 599 states + # manylinux1/manylinux2010 wheels should be considered + # manylinux2014 wheels: + # https://www.python.org/dev/peps/pep-0599/#backwards-compatibility-with-manylinux2010-wheels + if arch_suffix in {"i686", "x86_64"}: + arches.append("manylinux2010" + arch_sep + arch_suffix) + arches.append("manylinux1" + arch_sep + arch_suffix) + elif arch_prefix == "manylinux2010": + # manylinux1 wheels run on most manylinux2010 systems with the + # exception of wheels depending on ncurses. PEP 571 states + # manylinux1 wheels should be considered manylinux2010 wheels: + # https://www.python.org/dev/peps/pep-0571/#backwards-compatibility-with-manylinux1-wheels + arches.append("manylinux1" + arch_sep + arch_suffix) + return arches + + +def _get_custom_platforms(arch: str) -> List[str]: + arch_prefix, arch_sep, arch_suffix = arch.partition("_") + if arch.startswith("macosx"): + arches = _mac_platforms(arch) + elif arch.startswith("ios"): + arches = _ios_platforms(arch) + elif arch_prefix in ["manylinux2014", "manylinux2010"]: + arches = _custom_manylinux_platforms(arch) + else: + arches = [arch] + return arches + + +def _expand_allowed_platforms(platforms: Optional[List[str]]) -> Optional[List[str]]: + if not platforms: + return None + + seen = set() + result = [] + + for p in platforms: + if p in seen: + continue + additions = [c for c in _get_custom_platforms(p) if c not in seen] + seen.update(additions) + result.extend(additions) + + return result + + +def _get_python_version(version: str) -> PythonVersion: + if len(version) > 1: + return int(version[0]), int(version[1:]) + else: + return (int(version[0]),) + + +def _get_custom_interpreter( + implementation: Optional[str] = None, version: Optional[str] = None +) -> str: + if implementation is None: + implementation = interpreter_name() + if version is None: + version = interpreter_version() + return f"{implementation}{version}" + + +def get_supported( + version: Optional[str] = None, + platforms: Optional[List[str]] = None, + impl: Optional[str] = None, + abis: Optional[List[str]] = None, +) -> List[Tag]: + """Return a list of supported tags for each version specified in + `versions`. + + :param version: a string version, of the form "33" or "32", + or None. The version will be assumed to support our ABI. + :param platform: specify a list of platforms you want valid + tags for, or None. If None, use the local system platform. + :param impl: specify the exact implementation you want valid + tags for, or None. If None, use the local interpreter impl. + :param abis: specify a list of abis you want valid + tags for, or None. If None, use the local interpreter abi. + """ + supported: List[Tag] = [] + + python_version: Optional[PythonVersion] = None + if version is not None: + python_version = _get_python_version(version) + + interpreter = _get_custom_interpreter(impl, version) + + platforms = _expand_allowed_platforms(platforms) + + is_cpython = (impl or interpreter_name()) == "cp" + if is_cpython: + supported.extend( + cpython_tags( + python_version=python_version, + abis=abis, + platforms=platforms, + ) + ) + else: + supported.extend( + generic_tags( + interpreter=interpreter, + abis=abis, + platforms=platforms, + ) + ) + supported.extend( + compatible_tags( + python_version=python_version, + interpreter=interpreter, + platforms=platforms, + ) + ) + + return supported diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/datetime.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/datetime.py new file mode 100644 index 0000000..8668b3b --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/datetime.py @@ -0,0 +1,11 @@ +"""For when pip wants to check the date or time. +""" + +import datetime + + +def today_is_later_than(year: int, month: int, day: int) -> bool: + today = datetime.date.today() + given = datetime.date(year, month, day) + + return today > given diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/deprecation.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/deprecation.py new file mode 100644 index 0000000..0911147 --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/deprecation.py @@ -0,0 +1,124 @@ +""" +A module that implements tooling to enable easy warnings about deprecations. +""" + +import logging +import warnings +from typing import Any, Optional, TextIO, Type, Union + +from pip._vendor.packaging.version import parse + +from pip import __version__ as current_version # NOTE: tests patch this name. + +DEPRECATION_MSG_PREFIX = "DEPRECATION: " + + +class PipDeprecationWarning(Warning): + pass + + +_original_showwarning: Any = None + + +# Warnings <-> Logging Integration +def _showwarning( + message: Union[Warning, str], + category: Type[Warning], + filename: str, + lineno: int, + file: Optional[TextIO] = None, + line: Optional[str] = None, +) -> None: + if file is not None: + if _original_showwarning is not None: + _original_showwarning(message, category, filename, lineno, file, line) + elif issubclass(category, PipDeprecationWarning): + # We use a specially named logger which will handle all of the + # deprecation messages for pip. + logger = logging.getLogger("pip._internal.deprecations") + logger.warning(message) + else: + _original_showwarning(message, category, filename, lineno, file, line) + + +def install_warning_logger() -> None: + # Enable our Deprecation Warnings + warnings.simplefilter("default", PipDeprecationWarning, append=True) + + global _original_showwarning + + if _original_showwarning is None: + _original_showwarning = warnings.showwarning + warnings.showwarning = _showwarning + + +def deprecated( + *, + reason: str, + replacement: Optional[str], + gone_in: Optional[str], + feature_flag: Optional[str] = None, + issue: Optional[int] = None, +) -> None: + """Helper to deprecate existing functionality. + + reason: + Textual reason shown to the user about why this functionality has + been deprecated. Should be a complete sentence. + replacement: + Textual suggestion shown to the user about what alternative + functionality they can use. + gone_in: + The version of pip does this functionality should get removed in. + Raises an error if pip's current version is greater than or equal to + this. + feature_flag: + Command-line flag of the form --use-feature={feature_flag} for testing + upcoming functionality. + issue: + Issue number on the tracker that would serve as a useful place for + users to find related discussion and provide feedback. + """ + + # Determine whether or not the feature is already gone in this version. + is_gone = gone_in is not None and parse(current_version) >= parse(gone_in) + + message_parts = [ + (reason, f"{DEPRECATION_MSG_PREFIX}{{}}"), + ( + gone_in, + ( + "pip {} will enforce this behaviour change." + if not is_gone + else "Since pip {}, this is no longer supported." + ), + ), + ( + replacement, + "A possible replacement is {}.", + ), + ( + feature_flag, + ( + "You can use the flag --use-feature={} to test the upcoming behaviour." + if not is_gone + else None + ), + ), + ( + issue, + "Discussion can be found at https://github.com/pypa/pip/issues/{}", + ), + ] + + message = " ".join( + format_str.format(value) + for value, format_str in message_parts + if format_str is not None and value is not None + ) + + # Raise as an error if this behaviour is deprecated. + if is_gone: + raise PipDeprecationWarning(message) + + warnings.warn(message, category=PipDeprecationWarning, stacklevel=2) diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/direct_url_helpers.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/direct_url_helpers.py new file mode 100644 index 0000000..66020d3 --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/direct_url_helpers.py @@ -0,0 +1,87 @@ +from typing import Optional + +from pip._internal.models.direct_url import ArchiveInfo, DirectUrl, DirInfo, VcsInfo +from pip._internal.models.link import Link +from pip._internal.utils.urls import path_to_url +from pip._internal.vcs import vcs + + +def direct_url_as_pep440_direct_reference(direct_url: DirectUrl, name: str) -> str: + """Convert a DirectUrl to a pip requirement string.""" + direct_url.validate() # if invalid, this is a pip bug + requirement = name + " @ " + fragments = [] + if isinstance(direct_url.info, VcsInfo): + requirement += ( + f"{direct_url.info.vcs}+{direct_url.url}@{direct_url.info.commit_id}" + ) + elif isinstance(direct_url.info, ArchiveInfo): + requirement += direct_url.url + if direct_url.info.hash: + fragments.append(direct_url.info.hash) + else: + assert isinstance(direct_url.info, DirInfo) + requirement += direct_url.url + if direct_url.subdirectory: + fragments.append("subdirectory=" + direct_url.subdirectory) + if fragments: + requirement += "#" + "&".join(fragments) + return requirement + + +def direct_url_for_editable(source_dir: str) -> DirectUrl: + return DirectUrl( + url=path_to_url(source_dir), + info=DirInfo(editable=True), + ) + + +def direct_url_from_link( + link: Link, source_dir: Optional[str] = None, link_is_in_wheel_cache: bool = False +) -> DirectUrl: + if link.is_vcs: + vcs_backend = vcs.get_backend_for_scheme(link.scheme) + assert vcs_backend + url, requested_revision, _ = vcs_backend.get_url_rev_and_auth( + link.url_without_fragment + ) + # For VCS links, we need to find out and add commit_id. + if link_is_in_wheel_cache: + # If the requested VCS link corresponds to a cached + # wheel, it means the requested revision was an + # immutable commit hash, otherwise it would not have + # been cached. In that case we don't have a source_dir + # with the VCS checkout. + assert requested_revision + commit_id = requested_revision + else: + # If the wheel was not in cache, it means we have + # had to checkout from VCS to build and we have a source_dir + # which we can inspect to find out the commit id. + assert source_dir + commit_id = vcs_backend.get_revision(source_dir) + return DirectUrl( + url=url, + info=VcsInfo( + vcs=vcs_backend.name, + commit_id=commit_id, + requested_revision=requested_revision, + ), + subdirectory=link.subdirectory_fragment, + ) + elif link.is_existing_dir(): + return DirectUrl( + url=link.url_without_fragment, + info=DirInfo(), + subdirectory=link.subdirectory_fragment, + ) + else: + hash = None + hash_name = link.hash_name + if hash_name: + hash = f"{hash_name}={link.hash}" + return DirectUrl( + url=link.url_without_fragment, + info=ArchiveInfo(hash=hash), + subdirectory=link.subdirectory_fragment, + ) diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/egg_link.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/egg_link.py new file mode 100644 index 0000000..4a384a6 --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/egg_link.py @@ -0,0 +1,80 @@ +import os +import re +import sys +from typing import List, Optional + +from pip._internal.locations import site_packages, user_site +from pip._internal.utils.virtualenv import ( + running_under_virtualenv, + virtualenv_no_global, +) + +__all__ = [ + "egg_link_path_from_sys_path", + "egg_link_path_from_location", +] + + +def _egg_link_names(raw_name: str) -> List[str]: + """ + Convert a Name metadata value to a .egg-link name, by applying + the same substitution as pkg_resources's safe_name function. + Note: we cannot use canonicalize_name because it has a different logic. + + We also look for the raw name (without normalization) as setuptools 69 changed + the way it names .egg-link files (https://github.com/pypa/setuptools/issues/4167). + """ + return [ + re.sub("[^A-Za-z0-9.]+", "-", raw_name) + ".egg-link", + f"{raw_name}.egg-link", + ] + + +def egg_link_path_from_sys_path(raw_name: str) -> Optional[str]: + """ + Look for a .egg-link file for project name, by walking sys.path. + """ + egg_link_names = _egg_link_names(raw_name) + for path_item in sys.path: + for egg_link_name in egg_link_names: + egg_link = os.path.join(path_item, egg_link_name) + if os.path.isfile(egg_link): + return egg_link + return None + + +def egg_link_path_from_location(raw_name: str) -> Optional[str]: + """ + Return the path for the .egg-link file if it exists, otherwise, None. + + There's 3 scenarios: + 1) not in a virtualenv + try to find in site.USER_SITE, then site_packages + 2) in a no-global virtualenv + try to find in site_packages + 3) in a yes-global virtualenv + try to find in site_packages, then site.USER_SITE + (don't look in global location) + + For #1 and #3, there could be odd cases, where there's an egg-link in 2 + locations. + + This method will just return the first one found. + """ + sites: List[str] = [] + if running_under_virtualenv(): + sites.append(site_packages) + if not virtualenv_no_global() and user_site: + sites.append(user_site) + else: + if user_site: + sites.append(user_site) + sites.append(site_packages) + + egg_link_names = _egg_link_names(raw_name) + for site in sites: + for egg_link_name in egg_link_names: + egglink = os.path.join(site, egg_link_name) + if os.path.isfile(egglink): + return egglink + return None diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/entrypoints.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/entrypoints.py new file mode 100644 index 0000000..1501369 --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/entrypoints.py @@ -0,0 +1,84 @@ +import itertools +import os +import shutil +import sys +from typing import List, Optional + +from pip._internal.cli.main import main +from pip._internal.utils.compat import WINDOWS + +_EXECUTABLE_NAMES = [ + "pip", + f"pip{sys.version_info.major}", + f"pip{sys.version_info.major}.{sys.version_info.minor}", +] +if WINDOWS: + _allowed_extensions = {"", ".exe"} + _EXECUTABLE_NAMES = [ + "".join(parts) + for parts in itertools.product(_EXECUTABLE_NAMES, _allowed_extensions) + ] + + +def _wrapper(args: Optional[List[str]] = None) -> int: + """Central wrapper for all old entrypoints. + + Historically pip has had several entrypoints defined. Because of issues + arising from PATH, sys.path, multiple Pythons, their interactions, and most + of them having a pip installed, users suffer every time an entrypoint gets + moved. + + To alleviate this pain, and provide a mechanism for warning users and + directing them to an appropriate place for help, we now define all of + our old entrypoints as wrappers for the current one. + """ + sys.stderr.write( + "WARNING: pip is being invoked by an old script wrapper. This will " + "fail in a future version of pip.\n" + "Please see https://github.com/pypa/pip/issues/5599 for advice on " + "fixing the underlying issue.\n" + "To avoid this problem you can invoke Python with '-m pip' instead of " + "running pip directly.\n" + ) + return main(args) + + +def get_best_invocation_for_this_pip() -> str: + """Try to figure out the best way to invoke pip in the current environment.""" + binary_directory = "Scripts" if WINDOWS else "bin" + binary_prefix = os.path.join(sys.prefix, binary_directory) + + # Try to use pip[X[.Y]] names, if those executables for this environment are + # the first on PATH with that name. + path_parts = os.path.normcase(os.environ.get("PATH", "")).split(os.pathsep) + exe_are_in_PATH = os.path.normcase(binary_prefix) in path_parts + if exe_are_in_PATH: + for exe_name in _EXECUTABLE_NAMES: + found_executable = shutil.which(exe_name) + binary_executable = os.path.join(binary_prefix, exe_name) + if ( + found_executable + and os.path.exists(binary_executable) + and os.path.samefile( + found_executable, + binary_executable, + ) + ): + return exe_name + + # Use the `-m` invocation, if there's no "nice" invocation. + return f"{get_best_invocation_for_this_python()} -m pip" + + +def get_best_invocation_for_this_python() -> str: + """Try to figure out the best way to invoke the current Python.""" + exe = sys.executable + exe_name = os.path.basename(exe) + + # Try to use the basename, if it's the first executable. + found_executable = shutil.which(exe_name) + if found_executable and os.path.samefile(found_executable, exe): + return exe_name + + # Use the full executable name, because we couldn't find something simpler. + return exe diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/filesystem.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/filesystem.py new file mode 100644 index 0000000..22e356c --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/filesystem.py @@ -0,0 +1,149 @@ +import fnmatch +import os +import os.path +import random +import sys +from contextlib import contextmanager +from tempfile import NamedTemporaryFile +from typing import Any, BinaryIO, Generator, List, Union, cast + +from pip._internal.utils.compat import get_path_uid +from pip._internal.utils.misc import format_size +from pip._internal.utils.retry import retry + + +def check_path_owner(path: str) -> bool: + # If we don't have a way to check the effective uid of this process, then + # we'll just assume that we own the directory. + if sys.platform == "win32" or not hasattr(os, "geteuid"): + return True + + assert os.path.isabs(path) + + previous = None + while path != previous: + if os.path.lexists(path): + # Check if path is writable by current user. + if os.geteuid() == 0: + # Special handling for root user in order to handle properly + # cases where users use sudo without -H flag. + try: + path_uid = get_path_uid(path) + except OSError: + return False + return path_uid == 0 + else: + return os.access(path, os.W_OK) + else: + previous, path = path, os.path.dirname(path) + return False # assume we don't own the path + + +@contextmanager +def adjacent_tmp_file(path: str, **kwargs: Any) -> Generator[BinaryIO, None, None]: + """Return a file-like object pointing to a tmp file next to path. + + The file is created securely and is ensured to be written to disk + after the context reaches its end. + + kwargs will be passed to tempfile.NamedTemporaryFile to control + the way the temporary file will be opened. + """ + with NamedTemporaryFile( + delete=False, + dir=os.path.dirname(path), + prefix=os.path.basename(path), + suffix=".tmp", + **kwargs, + ) as f: + result = cast(BinaryIO, f) + try: + yield result + finally: + result.flush() + os.fsync(result.fileno()) + + +replace = retry(stop_after_delay=1, wait=0.25)(os.replace) + + +# test_writable_dir and _test_writable_dir_win are copied from Flit, +# with the author's agreement to also place them under pip's license. +def test_writable_dir(path: str) -> bool: + """Check if a directory is writable. + + Uses os.access() on POSIX, tries creating files on Windows. + """ + # If the directory doesn't exist, find the closest parent that does. + while not os.path.isdir(path): + parent = os.path.dirname(path) + if parent == path: + break # Should never get here, but infinite loops are bad + path = parent + + if os.name == "posix": + return os.access(path, os.W_OK) + + return _test_writable_dir_win(path) + + +def _test_writable_dir_win(path: str) -> bool: + # os.access doesn't work on Windows: http://bugs.python.org/issue2528 + # and we can't use tempfile: http://bugs.python.org/issue22107 + basename = "accesstest_deleteme_fishfingers_custard_" + alphabet = "abcdefghijklmnopqrstuvwxyz0123456789" + for _ in range(10): + name = basename + "".join(random.choice(alphabet) for _ in range(6)) + file = os.path.join(path, name) + try: + fd = os.open(file, os.O_RDWR | os.O_CREAT | os.O_EXCL) + except FileExistsError: + pass + except PermissionError: + # This could be because there's a directory with the same name. + # But it's highly unlikely there's a directory called that, + # so we'll assume it's because the parent dir is not writable. + # This could as well be because the parent dir is not readable, + # due to non-privileged user access. + return False + else: + os.close(fd) + os.unlink(file) + return True + + # This should never be reached + raise OSError("Unexpected condition testing for writable directory") + + +def find_files(path: str, pattern: str) -> List[str]: + """Returns a list of absolute paths of files beneath path, recursively, + with filenames which match the UNIX-style shell glob pattern.""" + result: List[str] = [] + for root, _, files in os.walk(path): + matches = fnmatch.filter(files, pattern) + result.extend(os.path.join(root, f) for f in matches) + return result + + +def file_size(path: str) -> Union[int, float]: + # If it's a symlink, return 0. + if os.path.islink(path): + return 0 + return os.path.getsize(path) + + +def format_file_size(path: str) -> str: + return format_size(file_size(path)) + + +def directory_size(path: str) -> Union[int, float]: + size = 0.0 + for root, _dirs, files in os.walk(path): + for filename in files: + file_path = os.path.join(root, filename) + size += file_size(file_path) + return size + + +def format_directory_size(path: str) -> str: + return format_size(directory_size(path)) diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/filetypes.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/filetypes.py new file mode 100644 index 0000000..5948570 --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/filetypes.py @@ -0,0 +1,27 @@ +"""Filetype information. +""" + +from typing import Tuple + +from pip._internal.utils.misc import splitext + +WHEEL_EXTENSION = ".whl" +BZ2_EXTENSIONS: Tuple[str, ...] = (".tar.bz2", ".tbz") +XZ_EXTENSIONS: Tuple[str, ...] = ( + ".tar.xz", + ".txz", + ".tlz", + ".tar.lz", + ".tar.lzma", +) +ZIP_EXTENSIONS: Tuple[str, ...] = (".zip", WHEEL_EXTENSION) +TAR_EXTENSIONS: Tuple[str, ...] = (".tar.gz", ".tgz", ".tar") +ARCHIVE_EXTENSIONS = ZIP_EXTENSIONS + BZ2_EXTENSIONS + TAR_EXTENSIONS + XZ_EXTENSIONS + + +def is_archive_file(name: str) -> bool: + """Return True if `name` is a considered as an archive file.""" + ext = splitext(name)[1].lower() + if ext in ARCHIVE_EXTENSIONS: + return True + return False diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/glibc.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/glibc.py new file mode 100644 index 0000000..998868f --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/glibc.py @@ -0,0 +1,101 @@ +import os +import sys +from typing import Optional, Tuple + + +def glibc_version_string() -> Optional[str]: + "Returns glibc version string, or None if not using glibc." + return glibc_version_string_confstr() or glibc_version_string_ctypes() + + +def glibc_version_string_confstr() -> Optional[str]: + "Primary implementation of glibc_version_string using os.confstr." + # os.confstr is quite a bit faster than ctypes.DLL. It's also less likely + # to be broken or missing. This strategy is used in the standard library + # platform module: + # https://github.com/python/cpython/blob/fcf1d003bf4f0100c9d0921ff3d70e1127ca1b71/Lib/platform.py#L175-L183 + if sys.platform == "win32": + return None + try: + gnu_libc_version = os.confstr("CS_GNU_LIBC_VERSION") + if gnu_libc_version is None: + return None + # os.confstr("CS_GNU_LIBC_VERSION") returns a string like "glibc 2.17": + _, version = gnu_libc_version.split() + except (AttributeError, OSError, ValueError): + # os.confstr() or CS_GNU_LIBC_VERSION not available (or a bad value)... + return None + return version + + +def glibc_version_string_ctypes() -> Optional[str]: + "Fallback implementation of glibc_version_string using ctypes." + + try: + import ctypes + except ImportError: + return None + + # ctypes.CDLL(None) internally calls dlopen(NULL), and as the dlopen + # manpage says, "If filename is NULL, then the returned handle is for the + # main program". This way we can let the linker do the work to figure out + # which libc our process is actually using. + # + # We must also handle the special case where the executable is not a + # dynamically linked executable. This can occur when using musl libc, + # for example. In this situation, dlopen() will error, leading to an + # OSError. Interestingly, at least in the case of musl, there is no + # errno set on the OSError. The single string argument used to construct + # OSError comes from libc itself and is therefore not portable to + # hard code here. In any case, failure to call dlopen() means we + # can't proceed, so we bail on our attempt. + try: + process_namespace = ctypes.CDLL(None) + except OSError: + return None + + try: + gnu_get_libc_version = process_namespace.gnu_get_libc_version + except AttributeError: + # Symbol doesn't exist -> therefore, we are not linked to + # glibc. + return None + + # Call gnu_get_libc_version, which returns a string like "2.5" + gnu_get_libc_version.restype = ctypes.c_char_p + version_str: str = gnu_get_libc_version() + # py2 / py3 compatibility: + if not isinstance(version_str, str): + version_str = version_str.decode("ascii") + + return version_str + + +# platform.libc_ver regularly returns completely nonsensical glibc +# versions. E.g. on my computer, platform says: +# +# ~$ python2.7 -c 'import platform; print(platform.libc_ver())' +# ('glibc', '2.7') +# ~$ python3.5 -c 'import platform; print(platform.libc_ver())' +# ('glibc', '2.9') +# +# But the truth is: +# +# ~$ ldd --version +# ldd (Debian GLIBC 2.22-11) 2.22 +# +# This is unfortunate, because it means that the linehaul data on libc +# versions that was generated by pip 8.1.2 and earlier is useless and +# misleading. Solution: instead of using platform, use our code that actually +# works. +def libc_ver() -> Tuple[str, str]: + """Try to determine the glibc version + + Returns a tuple of strings (lib, version) which default to empty strings + in case the lookup fails. + """ + glibc_version = glibc_version_string() + if glibc_version is None: + return ("", "") + else: + return ("glibc", glibc_version) diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/hashes.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/hashes.py new file mode 100644 index 0000000..535e94f --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/hashes.py @@ -0,0 +1,147 @@ +import hashlib +from typing import TYPE_CHECKING, BinaryIO, Dict, Iterable, List, NoReturn, Optional + +from pip._internal.exceptions import HashMismatch, HashMissing, InstallationError +from pip._internal.utils.misc import read_chunks + +if TYPE_CHECKING: + from hashlib import _Hash + + +# The recommended hash algo of the moment. Change this whenever the state of +# the art changes; it won't hurt backward compatibility. +FAVORITE_HASH = "sha256" + + +# Names of hashlib algorithms allowed by the --hash option and ``pip hash`` +# Currently, those are the ones at least as collision-resistant as sha256. +STRONG_HASHES = ["sha256", "sha384", "sha512"] + + +class Hashes: + """A wrapper that builds multiple hashes at once and checks them against + known-good values + + """ + + def __init__(self, hashes: Optional[Dict[str, List[str]]] = None) -> None: + """ + :param hashes: A dict of algorithm names pointing to lists of allowed + hex digests + """ + allowed = {} + if hashes is not None: + for alg, keys in hashes.items(): + # Make sure values are always sorted (to ease equality checks) + allowed[alg] = [k.lower() for k in sorted(keys)] + self._allowed = allowed + + def __and__(self, other: "Hashes") -> "Hashes": + if not isinstance(other, Hashes): + return NotImplemented + + # If either of the Hashes object is entirely empty (i.e. no hash + # specified at all), all hashes from the other object are allowed. + if not other: + return self + if not self: + return other + + # Otherwise only hashes that present in both objects are allowed. + new = {} + for alg, values in other._allowed.items(): + if alg not in self._allowed: + continue + new[alg] = [v for v in values if v in self._allowed[alg]] + return Hashes(new) + + @property + def digest_count(self) -> int: + return sum(len(digests) for digests in self._allowed.values()) + + def is_hash_allowed(self, hash_name: str, hex_digest: str) -> bool: + """Return whether the given hex digest is allowed.""" + return hex_digest in self._allowed.get(hash_name, []) + + def check_against_chunks(self, chunks: Iterable[bytes]) -> None: + """Check good hashes against ones built from iterable of chunks of + data. + + Raise HashMismatch if none match. + + """ + gots = {} + for hash_name in self._allowed.keys(): + try: + gots[hash_name] = hashlib.new(hash_name) + except (ValueError, TypeError): + raise InstallationError(f"Unknown hash name: {hash_name}") + + for chunk in chunks: + for hash in gots.values(): + hash.update(chunk) + + for hash_name, got in gots.items(): + if got.hexdigest() in self._allowed[hash_name]: + return + self._raise(gots) + + def _raise(self, gots: Dict[str, "_Hash"]) -> "NoReturn": + raise HashMismatch(self._allowed, gots) + + def check_against_file(self, file: BinaryIO) -> None: + """Check good hashes against a file-like object + + Raise HashMismatch if none match. + + """ + return self.check_against_chunks(read_chunks(file)) + + def check_against_path(self, path: str) -> None: + with open(path, "rb") as file: + return self.check_against_file(file) + + def has_one_of(self, hashes: Dict[str, str]) -> bool: + """Return whether any of the given hashes are allowed.""" + for hash_name, hex_digest in hashes.items(): + if self.is_hash_allowed(hash_name, hex_digest): + return True + return False + + def __bool__(self) -> bool: + """Return whether I know any known-good hashes.""" + return bool(self._allowed) + + def __eq__(self, other: object) -> bool: + if not isinstance(other, Hashes): + return NotImplemented + return self._allowed == other._allowed + + def __hash__(self) -> int: + return hash( + ",".join( + sorted( + ":".join((alg, digest)) + for alg, digest_list in self._allowed.items() + for digest in digest_list + ) + ) + ) + + +class MissingHashes(Hashes): + """A workalike for Hashes used when we're missing a hash for a requirement + + It computes the actual hash of the requirement and raises a HashMissing + exception showing it to the user. + + """ + + def __init__(self) -> None: + """Don't offer the ``hashes`` kwarg.""" + # Pass our favorite hash in to generate a "gotten hash". With the + # empty list, it will never match, so an error will always raise. + super().__init__(hashes={FAVORITE_HASH: []}) + + def _raise(self, gots: Dict[str, "_Hash"]) -> "NoReturn": + raise HashMissing(gots[FAVORITE_HASH].hexdigest()) diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/logging.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/logging.py new file mode 100644 index 0000000..62035fc --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/logging.py @@ -0,0 +1,354 @@ +import contextlib +import errno +import logging +import logging.handlers +import os +import sys +import threading +from dataclasses import dataclass +from io import TextIOWrapper +from logging import Filter +from typing import Any, ClassVar, Generator, List, Optional, TextIO, Type + +from pip._vendor.rich.console import ( + Console, + ConsoleOptions, + ConsoleRenderable, + RenderableType, + RenderResult, + RichCast, +) +from pip._vendor.rich.highlighter import NullHighlighter +from pip._vendor.rich.logging import RichHandler +from pip._vendor.rich.segment import Segment +from pip._vendor.rich.style import Style + +from pip._internal.utils._log import VERBOSE, getLogger +from pip._internal.utils.compat import WINDOWS +from pip._internal.utils.deprecation import DEPRECATION_MSG_PREFIX +from pip._internal.utils.misc import ensure_dir + +_log_state = threading.local() +subprocess_logger = getLogger("pip.subprocessor") + + +class BrokenStdoutLoggingError(Exception): + """ + Raised if BrokenPipeError occurs for the stdout stream while logging. + """ + + +def _is_broken_pipe_error(exc_class: Type[BaseException], exc: BaseException) -> bool: + if exc_class is BrokenPipeError: + return True + + # On Windows, a broken pipe can show up as EINVAL rather than EPIPE: + # https://bugs.python.org/issue19612 + # https://bugs.python.org/issue30418 + if not WINDOWS: + return False + + return isinstance(exc, OSError) and exc.errno in (errno.EINVAL, errno.EPIPE) + + +@contextlib.contextmanager +def indent_log(num: int = 2) -> Generator[None, None, None]: + """ + A context manager which will cause the log output to be indented for any + log messages emitted inside it. + """ + # For thread-safety + _log_state.indentation = get_indentation() + _log_state.indentation += num + try: + yield + finally: + _log_state.indentation -= num + + +def get_indentation() -> int: + return getattr(_log_state, "indentation", 0) + + +class IndentingFormatter(logging.Formatter): + default_time_format = "%Y-%m-%dT%H:%M:%S" + + def __init__( + self, + *args: Any, + add_timestamp: bool = False, + **kwargs: Any, + ) -> None: + """ + A logging.Formatter that obeys the indent_log() context manager. + + :param add_timestamp: A bool indicating output lines should be prefixed + with their record's timestamp. + """ + self.add_timestamp = add_timestamp + super().__init__(*args, **kwargs) + + def get_message_start(self, formatted: str, levelno: int) -> str: + """ + Return the start of the formatted log message (not counting the + prefix to add to each line). + """ + if levelno < logging.WARNING: + return "" + if formatted.startswith(DEPRECATION_MSG_PREFIX): + # Then the message already has a prefix. We don't want it to + # look like "WARNING: DEPRECATION: ...." + return "" + if levelno < logging.ERROR: + return "WARNING: " + + return "ERROR: " + + def format(self, record: logging.LogRecord) -> str: + """ + Calls the standard formatter, but will indent all of the log message + lines by our current indentation level. + """ + formatted = super().format(record) + message_start = self.get_message_start(formatted, record.levelno) + formatted = message_start + formatted + + prefix = "" + if self.add_timestamp: + prefix = f"{self.formatTime(record)} " + prefix += " " * get_indentation() + formatted = "".join([prefix + line for line in formatted.splitlines(True)]) + return formatted + + +@dataclass +class IndentedRenderable: + renderable: RenderableType + indent: int + + def __rich_console__( + self, console: Console, options: ConsoleOptions + ) -> RenderResult: + segments = console.render(self.renderable, options) + lines = Segment.split_lines(segments) + for line in lines: + yield Segment(" " * self.indent) + yield from line + yield Segment("\n") + + +class PipConsole(Console): + def on_broken_pipe(self) -> None: + # Reraise the original exception, rich 13.8.0+ exits by default + # instead, preventing our handler from firing. + raise BrokenPipeError() from None + + +class RichPipStreamHandler(RichHandler): + KEYWORDS: ClassVar[Optional[List[str]]] = [] + + def __init__(self, stream: Optional[TextIO], no_color: bool) -> None: + super().__init__( + console=PipConsole(file=stream, no_color=no_color, soft_wrap=True), + show_time=False, + show_level=False, + show_path=False, + highlighter=NullHighlighter(), + ) + + # Our custom override on Rich's logger, to make things work as we need them to. + def emit(self, record: logging.LogRecord) -> None: + style: Optional[Style] = None + + # If we are given a diagnostic error to present, present it with indentation. + if getattr(record, "rich", False): + assert isinstance(record.args, tuple) + (rich_renderable,) = record.args + assert isinstance( + rich_renderable, (ConsoleRenderable, RichCast, str) + ), f"{rich_renderable} is not rich-console-renderable" + + renderable: RenderableType = IndentedRenderable( + rich_renderable, indent=get_indentation() + ) + else: + message = self.format(record) + renderable = self.render_message(record, message) + if record.levelno is not None: + if record.levelno >= logging.ERROR: + style = Style(color="red") + elif record.levelno >= logging.WARNING: + style = Style(color="yellow") + + try: + self.console.print(renderable, overflow="ignore", crop=False, style=style) + except Exception: + self.handleError(record) + + def handleError(self, record: logging.LogRecord) -> None: + """Called when logging is unable to log some output.""" + + exc_class, exc = sys.exc_info()[:2] + # If a broken pipe occurred while calling write() or flush() on the + # stdout stream in logging's Handler.emit(), then raise our special + # exception so we can handle it in main() instead of logging the + # broken pipe error and continuing. + if ( + exc_class + and exc + and self.console.file is sys.stdout + and _is_broken_pipe_error(exc_class, exc) + ): + raise BrokenStdoutLoggingError() + + return super().handleError(record) + + +class BetterRotatingFileHandler(logging.handlers.RotatingFileHandler): + def _open(self) -> TextIOWrapper: + ensure_dir(os.path.dirname(self.baseFilename)) + return super()._open() + + +class MaxLevelFilter(Filter): + def __init__(self, level: int) -> None: + self.level = level + + def filter(self, record: logging.LogRecord) -> bool: + return record.levelno < self.level + + +class ExcludeLoggerFilter(Filter): + """ + A logging Filter that excludes records from a logger (or its children). + """ + + def filter(self, record: logging.LogRecord) -> bool: + # The base Filter class allows only records from a logger (or its + # children). + return not super().filter(record) + + +def setup_logging(verbosity: int, no_color: bool, user_log_file: Optional[str]) -> int: + """Configures and sets up all of the logging + + Returns the requested logging level, as its integer value. + """ + + # Determine the level to be logging at. + if verbosity >= 2: + level_number = logging.DEBUG + elif verbosity == 1: + level_number = VERBOSE + elif verbosity == -1: + level_number = logging.WARNING + elif verbosity == -2: + level_number = logging.ERROR + elif verbosity <= -3: + level_number = logging.CRITICAL + else: + level_number = logging.INFO + + level = logging.getLevelName(level_number) + + # The "root" logger should match the "console" level *unless* we also need + # to log to a user log file. + include_user_log = user_log_file is not None + if include_user_log: + additional_log_file = user_log_file + root_level = "DEBUG" + else: + additional_log_file = "/dev/null" + root_level = level + + # Disable any logging besides WARNING unless we have DEBUG level logging + # enabled for vendored libraries. + vendored_log_level = "WARNING" if level in ["INFO", "ERROR"] else "DEBUG" + + # Shorthands for clarity + log_streams = { + "stdout": "ext://sys.stdout", + "stderr": "ext://sys.stderr", + } + handler_classes = { + "stream": "pip._internal.utils.logging.RichPipStreamHandler", + "file": "pip._internal.utils.logging.BetterRotatingFileHandler", + } + handlers = ["console", "console_errors", "console_subprocess"] + ( + ["user_log"] if include_user_log else [] + ) + + logging.config.dictConfig( + { + "version": 1, + "disable_existing_loggers": False, + "filters": { + "exclude_warnings": { + "()": "pip._internal.utils.logging.MaxLevelFilter", + "level": logging.WARNING, + }, + "restrict_to_subprocess": { + "()": "logging.Filter", + "name": subprocess_logger.name, + }, + "exclude_subprocess": { + "()": "pip._internal.utils.logging.ExcludeLoggerFilter", + "name": subprocess_logger.name, + }, + }, + "formatters": { + "indent": { + "()": IndentingFormatter, + "format": "%(message)s", + }, + "indent_with_timestamp": { + "()": IndentingFormatter, + "format": "%(message)s", + "add_timestamp": True, + }, + }, + "handlers": { + "console": { + "level": level, + "class": handler_classes["stream"], + "no_color": no_color, + "stream": log_streams["stdout"], + "filters": ["exclude_subprocess", "exclude_warnings"], + "formatter": "indent", + }, + "console_errors": { + "level": "WARNING", + "class": handler_classes["stream"], + "no_color": no_color, + "stream": log_streams["stderr"], + "filters": ["exclude_subprocess"], + "formatter": "indent", + }, + # A handler responsible for logging to the console messages + # from the "subprocessor" logger. + "console_subprocess": { + "level": level, + "class": handler_classes["stream"], + "stream": log_streams["stderr"], + "no_color": no_color, + "filters": ["restrict_to_subprocess"], + "formatter": "indent", + }, + "user_log": { + "level": "DEBUG", + "class": handler_classes["file"], + "filename": additional_log_file, + "encoding": "utf-8", + "delay": True, + "formatter": "indent_with_timestamp", + }, + }, + "root": { + "level": root_level, + "handlers": handlers, + }, + "loggers": {"pip._vendor": {"level": vendored_log_level}}, + } + ) + + return level_number diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/misc.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/misc.py new file mode 100644 index 0000000..44f6a05 --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/misc.py @@ -0,0 +1,773 @@ +import errno +import getpass +import hashlib +import logging +import os +import posixpath +import shutil +import stat +import sys +import sysconfig +import urllib.parse +from dataclasses import dataclass +from functools import partial +from io import StringIO +from itertools import filterfalse, tee, zip_longest +from pathlib import Path +from types import FunctionType, TracebackType +from typing import ( + Any, + BinaryIO, + Callable, + Generator, + Iterable, + Iterator, + List, + Mapping, + Optional, + Sequence, + TextIO, + Tuple, + Type, + TypeVar, + Union, + cast, +) + +from pip._vendor.packaging.requirements import Requirement +from pip._vendor.pyproject_hooks import BuildBackendHookCaller + +from pip import __version__ +from pip._internal.exceptions import CommandError, ExternallyManagedEnvironment +from pip._internal.locations import get_major_minor_version +from pip._internal.utils.compat import WINDOWS +from pip._internal.utils.retry import retry +from pip._internal.utils.virtualenv import running_under_virtualenv + +__all__ = [ + "rmtree", + "display_path", + "backup_dir", + "ask", + "splitext", + "format_size", + "is_installable_dir", + "normalize_path", + "renames", + "get_prog", + "ensure_dir", + "remove_auth_from_url", + "check_externally_managed", + "ConfiguredBuildBackendHookCaller", +] + +logger = logging.getLogger(__name__) + +T = TypeVar("T") +ExcInfo = Tuple[Type[BaseException], BaseException, TracebackType] +VersionInfo = Tuple[int, int, int] +NetlocTuple = Tuple[str, Tuple[Optional[str], Optional[str]]] +OnExc = Callable[[FunctionType, Path, BaseException], Any] +OnErr = Callable[[FunctionType, Path, ExcInfo], Any] + +FILE_CHUNK_SIZE = 1024 * 1024 + + +def get_pip_version() -> str: + pip_pkg_dir = os.path.join(os.path.dirname(__file__), "..", "..") + pip_pkg_dir = os.path.abspath(pip_pkg_dir) + + return f"pip {__version__} from {pip_pkg_dir} (python {get_major_minor_version()})" + + +def normalize_version_info(py_version_info: Tuple[int, ...]) -> Tuple[int, int, int]: + """ + Convert a tuple of ints representing a Python version to one of length + three. + + :param py_version_info: a tuple of ints representing a Python version, + or None to specify no version. The tuple can have any length. + + :return: a tuple of length three if `py_version_info` is non-None. + Otherwise, return `py_version_info` unchanged (i.e. None). + """ + if len(py_version_info) < 3: + py_version_info += (3 - len(py_version_info)) * (0,) + elif len(py_version_info) > 3: + py_version_info = py_version_info[:3] + + return cast("VersionInfo", py_version_info) + + +def ensure_dir(path: str) -> None: + """os.path.makedirs without EEXIST.""" + try: + os.makedirs(path) + except OSError as e: + # Windows can raise spurious ENOTEMPTY errors. See #6426. + if e.errno != errno.EEXIST and e.errno != errno.ENOTEMPTY: + raise + + +def get_prog() -> str: + try: + prog = os.path.basename(sys.argv[0]) + if prog in ("__main__.py", "-c"): + return f"{sys.executable} -m pip" + else: + return prog + except (AttributeError, TypeError, IndexError): + pass + return "pip" + + +# Retry every half second for up to 3 seconds +@retry(stop_after_delay=3, wait=0.5) +def rmtree( + dir: str, ignore_errors: bool = False, onexc: Optional[OnExc] = None +) -> None: + if ignore_errors: + onexc = _onerror_ignore + if onexc is None: + onexc = _onerror_reraise + handler: OnErr = partial(rmtree_errorhandler, onexc=onexc) + if sys.version_info >= (3, 12): + # See https://docs.python.org/3.12/whatsnew/3.12.html#shutil. + shutil.rmtree(dir, onexc=handler) # type: ignore + else: + shutil.rmtree(dir, onerror=handler) # type: ignore + + +def _onerror_ignore(*_args: Any) -> None: + pass + + +def _onerror_reraise(*_args: Any) -> None: + raise # noqa: PLE0704 - Bare exception used to reraise existing exception + + +def rmtree_errorhandler( + func: FunctionType, + path: Path, + exc_info: Union[ExcInfo, BaseException], + *, + onexc: OnExc = _onerror_reraise, +) -> None: + """ + `rmtree` error handler to 'force' a file remove (i.e. like `rm -f`). + + * If a file is readonly then it's write flag is set and operation is + retried. + + * `onerror` is the original callback from `rmtree(... onerror=onerror)` + that is chained at the end if the "rm -f" still fails. + """ + try: + st_mode = os.stat(path).st_mode + except OSError: + # it's equivalent to os.path.exists + return + + if not st_mode & stat.S_IWRITE: + # convert to read/write + try: + os.chmod(path, st_mode | stat.S_IWRITE) + except OSError: + pass + else: + # use the original function to repeat the operation + try: + func(path) + return + except OSError: + pass + + if not isinstance(exc_info, BaseException): + _, exc_info, _ = exc_info + onexc(func, path, exc_info) + + +def display_path(path: str) -> str: + """Gives the display value for a given path, making it relative to cwd + if possible.""" + path = os.path.normcase(os.path.abspath(path)) + if path.startswith(os.getcwd() + os.path.sep): + path = "." + path[len(os.getcwd()) :] + return path + + +def backup_dir(dir: str, ext: str = ".bak") -> str: + """Figure out the name of a directory to back up the given dir to + (adding .bak, .bak2, etc)""" + n = 1 + extension = ext + while os.path.exists(dir + extension): + n += 1 + extension = ext + str(n) + return dir + extension + + +def ask_path_exists(message: str, options: Iterable[str]) -> str: + for action in os.environ.get("PIP_EXISTS_ACTION", "").split(): + if action in options: + return action + return ask(message, options) + + +def _check_no_input(message: str) -> None: + """Raise an error if no input is allowed.""" + if os.environ.get("PIP_NO_INPUT"): + raise Exception( + f"No input was expected ($PIP_NO_INPUT set); question: {message}" + ) + + +def ask(message: str, options: Iterable[str]) -> str: + """Ask the message interactively, with the given possible responses""" + while 1: + _check_no_input(message) + response = input(message) + response = response.strip().lower() + if response not in options: + print( + "Your response ({!r}) was not one of the expected responses: " + "{}".format(response, ", ".join(options)) + ) + else: + return response + + +def ask_input(message: str) -> str: + """Ask for input interactively.""" + _check_no_input(message) + return input(message) + + +def ask_password(message: str) -> str: + """Ask for a password interactively.""" + _check_no_input(message) + return getpass.getpass(message) + + +def strtobool(val: str) -> int: + """Convert a string representation of truth to true (1) or false (0). + + True values are 'y', 'yes', 't', 'true', 'on', and '1'; false values + are 'n', 'no', 'f', 'false', 'off', and '0'. Raises ValueError if + 'val' is anything else. + """ + val = val.lower() + if val in ("y", "yes", "t", "true", "on", "1"): + return 1 + elif val in ("n", "no", "f", "false", "off", "0"): + return 0 + else: + raise ValueError(f"invalid truth value {val!r}") + + +def format_size(bytes: float) -> str: + if bytes > 1000 * 1000: + return f"{bytes / 1000.0 / 1000:.1f} MB" + elif bytes > 10 * 1000: + return f"{int(bytes / 1000)} kB" + elif bytes > 1000: + return f"{bytes / 1000.0:.1f} kB" + else: + return f"{int(bytes)} bytes" + + +def tabulate(rows: Iterable[Iterable[Any]]) -> Tuple[List[str], List[int]]: + """Return a list of formatted rows and a list of column sizes. + + For example:: + + >>> tabulate([['foobar', 2000], [0xdeadbeef]]) + (['foobar 2000', '3735928559'], [10, 4]) + """ + rows = [tuple(map(str, row)) for row in rows] + sizes = [max(map(len, col)) for col in zip_longest(*rows, fillvalue="")] + table = [" ".join(map(str.ljust, row, sizes)).rstrip() for row in rows] + return table, sizes + + +def is_installable_dir(path: str) -> bool: + """Is path is a directory containing pyproject.toml or setup.py? + + If pyproject.toml exists, this is a PEP 517 project. Otherwise we look for + a legacy setuptools layout by identifying setup.py. We don't check for the + setup.cfg because using it without setup.py is only available for PEP 517 + projects, which are already covered by the pyproject.toml check. + """ + if not os.path.isdir(path): + return False + if os.path.isfile(os.path.join(path, "pyproject.toml")): + return True + if os.path.isfile(os.path.join(path, "setup.py")): + return True + return False + + +def read_chunks( + file: BinaryIO, size: int = FILE_CHUNK_SIZE +) -> Generator[bytes, None, None]: + """Yield pieces of data from a file-like object until EOF.""" + while True: + chunk = file.read(size) + if not chunk: + break + yield chunk + + +def normalize_path(path: str, resolve_symlinks: bool = True) -> str: + """ + Convert a path to its canonical, case-normalized, absolute version. + + """ + path = os.path.expanduser(path) + if resolve_symlinks: + path = os.path.realpath(path) + else: + path = os.path.abspath(path) + return os.path.normcase(path) + + +def splitext(path: str) -> Tuple[str, str]: + """Like os.path.splitext, but take off .tar too""" + base, ext = posixpath.splitext(path) + if base.lower().endswith(".tar"): + ext = base[-4:] + ext + base = base[:-4] + return base, ext + + +def renames(old: str, new: str) -> None: + """Like os.renames(), but handles renaming across devices.""" + # Implementation borrowed from os.renames(). + head, tail = os.path.split(new) + if head and tail and not os.path.exists(head): + os.makedirs(head) + + shutil.move(old, new) + + head, tail = os.path.split(old) + if head and tail: + try: + os.removedirs(head) + except OSError: + pass + + +def is_local(path: str) -> bool: + """ + Return True if path is within sys.prefix, if we're running in a virtualenv. + + If we're not in a virtualenv, all paths are considered "local." + + Caution: this function assumes the head of path has been normalized + with normalize_path. + """ + if not running_under_virtualenv(): + return True + return path.startswith(normalize_path(sys.prefix)) + + +def write_output(msg: Any, *args: Any) -> None: + logger.info(msg, *args) + + +class StreamWrapper(StringIO): + orig_stream: TextIO + + @classmethod + def from_stream(cls, orig_stream: TextIO) -> "StreamWrapper": + ret = cls() + ret.orig_stream = orig_stream + return ret + + # compileall.compile_dir() needs stdout.encoding to print to stdout + # type ignore is because TextIOBase.encoding is writeable + @property + def encoding(self) -> str: # type: ignore + return self.orig_stream.encoding + + +# Simulates an enum +def enum(*sequential: Any, **named: Any) -> Type[Any]: + enums = dict(zip(sequential, range(len(sequential))), **named) + reverse = {value: key for key, value in enums.items()} + enums["reverse_mapping"] = reverse + return type("Enum", (), enums) + + +def build_netloc(host: str, port: Optional[int]) -> str: + """ + Build a netloc from a host-port pair + """ + if port is None: + return host + if ":" in host: + # Only wrap host with square brackets when it is IPv6 + host = f"[{host}]" + return f"{host}:{port}" + + +def build_url_from_netloc(netloc: str, scheme: str = "https") -> str: + """ + Build a full URL from a netloc. + """ + if netloc.count(":") >= 2 and "@" not in netloc and "[" not in netloc: + # It must be a bare IPv6 address, so wrap it with brackets. + netloc = f"[{netloc}]" + return f"{scheme}://{netloc}" + + +def parse_netloc(netloc: str) -> Tuple[Optional[str], Optional[int]]: + """ + Return the host-port pair from a netloc. + """ + url = build_url_from_netloc(netloc) + parsed = urllib.parse.urlparse(url) + return parsed.hostname, parsed.port + + +def split_auth_from_netloc(netloc: str) -> NetlocTuple: + """ + Parse out and remove the auth information from a netloc. + + Returns: (netloc, (username, password)). + """ + if "@" not in netloc: + return netloc, (None, None) + + # Split from the right because that's how urllib.parse.urlsplit() + # behaves if more than one @ is present (which can be checked using + # the password attribute of urlsplit()'s return value). + auth, netloc = netloc.rsplit("@", 1) + pw: Optional[str] = None + if ":" in auth: + # Split from the left because that's how urllib.parse.urlsplit() + # behaves if more than one : is present (which again can be checked + # using the password attribute of the return value) + user, pw = auth.split(":", 1) + else: + user, pw = auth, None + + user = urllib.parse.unquote(user) + if pw is not None: + pw = urllib.parse.unquote(pw) + + return netloc, (user, pw) + + +def redact_netloc(netloc: str) -> str: + """ + Replace the sensitive data in a netloc with "****", if it exists. + + For example: + - "user:pass@example.com" returns "user:****@example.com" + - "accesstoken@example.com" returns "****@example.com" + """ + netloc, (user, password) = split_auth_from_netloc(netloc) + if user is None: + return netloc + if password is None: + user = "****" + password = "" + else: + user = urllib.parse.quote(user) + password = ":****" + return f"{user}{password}@{netloc}" + + +def _transform_url( + url: str, transform_netloc: Callable[[str], Tuple[Any, ...]] +) -> Tuple[str, NetlocTuple]: + """Transform and replace netloc in a url. + + transform_netloc is a function taking the netloc and returning a + tuple. The first element of this tuple is the new netloc. The + entire tuple is returned. + + Returns a tuple containing the transformed url as item 0 and the + original tuple returned by transform_netloc as item 1. + """ + purl = urllib.parse.urlsplit(url) + netloc_tuple = transform_netloc(purl.netloc) + # stripped url + url_pieces = (purl.scheme, netloc_tuple[0], purl.path, purl.query, purl.fragment) + surl = urllib.parse.urlunsplit(url_pieces) + return surl, cast("NetlocTuple", netloc_tuple) + + +def _get_netloc(netloc: str) -> NetlocTuple: + return split_auth_from_netloc(netloc) + + +def _redact_netloc(netloc: str) -> Tuple[str]: + return (redact_netloc(netloc),) + + +def split_auth_netloc_from_url( + url: str, +) -> Tuple[str, str, Tuple[Optional[str], Optional[str]]]: + """ + Parse a url into separate netloc, auth, and url with no auth. + + Returns: (url_without_auth, netloc, (username, password)) + """ + url_without_auth, (netloc, auth) = _transform_url(url, _get_netloc) + return url_without_auth, netloc, auth + + +def remove_auth_from_url(url: str) -> str: + """Return a copy of url with 'username:password@' removed.""" + # username/pass params are passed to subversion through flags + # and are not recognized in the url. + return _transform_url(url, _get_netloc)[0] + + +def redact_auth_from_url(url: str) -> str: + """Replace the password in a given url with ****.""" + return _transform_url(url, _redact_netloc)[0] + + +def redact_auth_from_requirement(req: Requirement) -> str: + """Replace the password in a given requirement url with ****.""" + if not req.url: + return str(req) + return str(req).replace(req.url, redact_auth_from_url(req.url)) + + +@dataclass(frozen=True) +class HiddenText: + secret: str + redacted: str + + def __repr__(self) -> str: + return f"" + + def __str__(self) -> str: + return self.redacted + + # This is useful for testing. + def __eq__(self, other: Any) -> bool: + if type(self) is not type(other): + return False + + # The string being used for redaction doesn't also have to match, + # just the raw, original string. + return self.secret == other.secret + + +def hide_value(value: str) -> HiddenText: + return HiddenText(value, redacted="****") + + +def hide_url(url: str) -> HiddenText: + redacted = redact_auth_from_url(url) + return HiddenText(url, redacted=redacted) + + +def protect_pip_from_modification_on_windows(modifying_pip: bool) -> None: + """Protection of pip.exe from modification on Windows + + On Windows, any operation modifying pip should be run as: + python -m pip ... + """ + pip_names = [ + "pip", + f"pip{sys.version_info.major}", + f"pip{sys.version_info.major}.{sys.version_info.minor}", + ] + + # See https://github.com/pypa/pip/issues/1299 for more discussion + should_show_use_python_msg = ( + modifying_pip and WINDOWS and os.path.basename(sys.argv[0]) in pip_names + ) + + if should_show_use_python_msg: + new_command = [sys.executable, "-m", "pip"] + sys.argv[1:] + raise CommandError( + "To modify pip, please run the following command:\n{}".format( + " ".join(new_command) + ) + ) + + +def check_externally_managed() -> None: + """Check whether the current environment is externally managed. + + If the ``EXTERNALLY-MANAGED`` config file is found, the current environment + is considered externally managed, and an ExternallyManagedEnvironment is + raised. + """ + if running_under_virtualenv(): + return + marker = os.path.join(sysconfig.get_path("stdlib"), "EXTERNALLY-MANAGED") + if not os.path.isfile(marker): + return + raise ExternallyManagedEnvironment.from_config(marker) + + +def is_console_interactive() -> bool: + """Is this console interactive?""" + return sys.stdin is not None and sys.stdin.isatty() + + +def hash_file(path: str, blocksize: int = 1 << 20) -> Tuple[Any, int]: + """Return (hash, length) for path using hashlib.sha256()""" + + h = hashlib.sha256() + length = 0 + with open(path, "rb") as f: + for block in read_chunks(f, size=blocksize): + length += len(block) + h.update(block) + return h, length + + +def pairwise(iterable: Iterable[Any]) -> Iterator[Tuple[Any, Any]]: + """ + Return paired elements. + + For example: + s -> (s0, s1), (s2, s3), (s4, s5), ... + """ + iterable = iter(iterable) + return zip_longest(iterable, iterable) + + +def partition( + pred: Callable[[T], bool], iterable: Iterable[T] +) -> Tuple[Iterable[T], Iterable[T]]: + """ + Use a predicate to partition entries into false entries and true entries, + like + + partition(is_odd, range(10)) --> 0 2 4 6 8 and 1 3 5 7 9 + """ + t1, t2 = tee(iterable) + return filterfalse(pred, t1), filter(pred, t2) + + +class ConfiguredBuildBackendHookCaller(BuildBackendHookCaller): + def __init__( + self, + config_holder: Any, + source_dir: str, + build_backend: str, + backend_path: Optional[str] = None, + runner: Optional[Callable[..., None]] = None, + python_executable: Optional[str] = None, + ): + super().__init__( + source_dir, build_backend, backend_path, runner, python_executable + ) + self.config_holder = config_holder + + def build_wheel( + self, + wheel_directory: str, + config_settings: Optional[Mapping[str, Any]] = None, + metadata_directory: Optional[str] = None, + ) -> str: + cs = self.config_holder.config_settings + return super().build_wheel( + wheel_directory, config_settings=cs, metadata_directory=metadata_directory + ) + + def build_sdist( + self, + sdist_directory: str, + config_settings: Optional[Mapping[str, Any]] = None, + ) -> str: + cs = self.config_holder.config_settings + return super().build_sdist(sdist_directory, config_settings=cs) + + def build_editable( + self, + wheel_directory: str, + config_settings: Optional[Mapping[str, Any]] = None, + metadata_directory: Optional[str] = None, + ) -> str: + cs = self.config_holder.config_settings + return super().build_editable( + wheel_directory, config_settings=cs, metadata_directory=metadata_directory + ) + + def get_requires_for_build_wheel( + self, config_settings: Optional[Mapping[str, Any]] = None + ) -> Sequence[str]: + cs = self.config_holder.config_settings + return super().get_requires_for_build_wheel(config_settings=cs) + + def get_requires_for_build_sdist( + self, config_settings: Optional[Mapping[str, Any]] = None + ) -> Sequence[str]: + cs = self.config_holder.config_settings + return super().get_requires_for_build_sdist(config_settings=cs) + + def get_requires_for_build_editable( + self, config_settings: Optional[Mapping[str, Any]] = None + ) -> Sequence[str]: + cs = self.config_holder.config_settings + return super().get_requires_for_build_editable(config_settings=cs) + + def prepare_metadata_for_build_wheel( + self, + metadata_directory: str, + config_settings: Optional[Mapping[str, Any]] = None, + _allow_fallback: bool = True, + ) -> str: + cs = self.config_holder.config_settings + return super().prepare_metadata_for_build_wheel( + metadata_directory=metadata_directory, + config_settings=cs, + _allow_fallback=_allow_fallback, + ) + + def prepare_metadata_for_build_editable( + self, + metadata_directory: str, + config_settings: Optional[Mapping[str, Any]] = None, + _allow_fallback: bool = True, + ) -> Optional[str]: + cs = self.config_holder.config_settings + return super().prepare_metadata_for_build_editable( + metadata_directory=metadata_directory, + config_settings=cs, + _allow_fallback=_allow_fallback, + ) + + +def warn_if_run_as_root() -> None: + """Output a warning for sudo users on Unix. + + In a virtual environment, sudo pip still writes to virtualenv. + On Windows, users may run pip as Administrator without issues. + This warning only applies to Unix root users outside of virtualenv. + """ + if running_under_virtualenv(): + return + if not hasattr(os, "getuid"): + return + # On Windows, there are no "system managed" Python packages. Installing as + # Administrator via pip is the correct way of updating system environments. + # + # We choose sys.platform over utils.compat.WINDOWS here to enable Mypy platform + # checks: https://mypy.readthedocs.io/en/stable/common_issues.html + if sys.platform == "win32" or sys.platform == "cygwin": + return + + if os.getuid() != 0: + return + + logger.warning( + "Running pip as the 'root' user can result in broken permissions and " + "conflicting behaviour with the system package manager, possibly " + "rendering your system unusable. " + "It is recommended to use a virtual environment instead: " + "https://pip.pypa.io/warnings/venv. " + "Use the --root-user-action option if you know what you are doing and " + "want to suppress this warning." + ) diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/packaging.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/packaging.py new file mode 100644 index 0000000..caad70f --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/packaging.py @@ -0,0 +1,58 @@ +import functools +import logging +import re +from typing import NewType, Optional, Tuple, cast + +from pip._vendor.packaging import specifiers, version +from pip._vendor.packaging.requirements import Requirement + +NormalizedExtra = NewType("NormalizedExtra", str) + +logger = logging.getLogger(__name__) + + +@functools.lru_cache(maxsize=32) +def check_requires_python( + requires_python: Optional[str], version_info: Tuple[int, ...] +) -> bool: + """ + Check if the given Python version matches a "Requires-Python" specifier. + + :param version_info: A 3-tuple of ints representing a Python + major-minor-micro version to check (e.g. `sys.version_info[:3]`). + + :return: `True` if the given Python version satisfies the requirement. + Otherwise, return `False`. + + :raises InvalidSpecifier: If `requires_python` has an invalid format. + """ + if requires_python is None: + # The package provides no information + return True + requires_python_specifier = specifiers.SpecifierSet(requires_python) + + python_version = version.parse(".".join(map(str, version_info))) + return python_version in requires_python_specifier + + +@functools.lru_cache(maxsize=2048) +def get_requirement(req_string: str) -> Requirement: + """Construct a packaging.Requirement object with caching""" + # Parsing requirement strings is expensive, and is also expected to happen + # with a low diversity of different arguments (at least relative the number + # constructed). This method adds a cache to requirement object creation to + # minimize repeated parsing of the same string to construct equivalent + # Requirement objects. + return Requirement(req_string) + + +def safe_extra(extra: str) -> NormalizedExtra: + """Convert an arbitrary string to a standard 'extra' name + + Any runs of non-alphanumeric characters are replaced with a single '_', + and the result is always lowercased. + + This function is duplicated from ``pkg_resources``. Note that this is not + the same to either ``canonicalize_name`` or ``_egg_link_name``. + """ + return cast(NormalizedExtra, re.sub("[^A-Za-z0-9.-]+", "_", extra).lower()) diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/retry.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/retry.py new file mode 100644 index 0000000..abfe072 --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/retry.py @@ -0,0 +1,42 @@ +import functools +from time import perf_counter, sleep +from typing import Callable, TypeVar + +from pip._vendor.typing_extensions import ParamSpec + +T = TypeVar("T") +P = ParamSpec("P") + + +def retry( + wait: float, stop_after_delay: float +) -> Callable[[Callable[P, T]], Callable[P, T]]: + """Decorator to automatically retry a function on error. + + If the function raises, the function is recalled with the same arguments + until it returns or the time limit is reached. When the time limit is + surpassed, the last exception raised is reraised. + + :param wait: The time to wait after an error before retrying, in seconds. + :param stop_after_delay: The time limit after which retries will cease, + in seconds. + """ + + def wrapper(func: Callable[P, T]) -> Callable[P, T]: + + @functools.wraps(func) + def retry_wrapped(*args: P.args, **kwargs: P.kwargs) -> T: + # The performance counter is monotonic on all platforms we care + # about and has much better resolution than time.monotonic(). + start_time = perf_counter() + while True: + try: + return func(*args, **kwargs) + except Exception: + if perf_counter() - start_time > stop_after_delay: + raise + sleep(wait) + + return retry_wrapped + + return wrapper diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/setuptools_build.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/setuptools_build.py new file mode 100644 index 0000000..96d1b24 --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/setuptools_build.py @@ -0,0 +1,146 @@ +import sys +import textwrap +from typing import List, Optional, Sequence + +# Shim to wrap setup.py invocation with setuptools +# Note that __file__ is handled via two {!r} *and* %r, to ensure that paths on +# Windows are correctly handled (it should be "C:\\Users" not "C:\Users"). +_SETUPTOOLS_SHIM = textwrap.dedent( + """ + exec(compile(''' + # This is -- a caller that pip uses to run setup.py + # + # - It imports setuptools before invoking setup.py, to enable projects that directly + # import from `distutils.core` to work with newer packaging standards. + # - It provides a clear error message when setuptools is not installed. + # - It sets `sys.argv[0]` to the underlying `setup.py`, when invoking `setup.py` so + # setuptools doesn't think the script is `-c`. This avoids the following warning: + # manifest_maker: standard file '-c' not found". + # - It generates a shim setup.py, for handling setup.cfg-only projects. + import os, sys, tokenize + + try: + import setuptools + except ImportError as error: + print( + "ERROR: Can not execute `setup.py` since setuptools is not available in " + "the build environment.", + file=sys.stderr, + ) + sys.exit(1) + + __file__ = %r + sys.argv[0] = __file__ + + if os.path.exists(__file__): + filename = __file__ + with tokenize.open(__file__) as f: + setup_py_code = f.read() + else: + filename = "" + setup_py_code = "from setuptools import setup; setup()" + + exec(compile(setup_py_code, filename, "exec")) + ''' % ({!r},), "", "exec")) + """ +).rstrip() + + +def make_setuptools_shim_args( + setup_py_path: str, + global_options: Optional[Sequence[str]] = None, + no_user_config: bool = False, + unbuffered_output: bool = False, +) -> List[str]: + """ + Get setuptools command arguments with shim wrapped setup file invocation. + + :param setup_py_path: The path to setup.py to be wrapped. + :param global_options: Additional global options. + :param no_user_config: If True, disables personal user configuration. + :param unbuffered_output: If True, adds the unbuffered switch to the + argument list. + """ + args = [sys.executable] + if unbuffered_output: + args += ["-u"] + args += ["-c", _SETUPTOOLS_SHIM.format(setup_py_path)] + if global_options: + args += global_options + if no_user_config: + args += ["--no-user-cfg"] + return args + + +def make_setuptools_bdist_wheel_args( + setup_py_path: str, + global_options: Sequence[str], + build_options: Sequence[str], + destination_dir: str, +) -> List[str]: + # NOTE: Eventually, we'd want to also -S to the flags here, when we're + # isolating. Currently, it breaks Python in virtualenvs, because it + # relies on site.py to find parts of the standard library outside the + # virtualenv. + args = make_setuptools_shim_args( + setup_py_path, global_options=global_options, unbuffered_output=True + ) + args += ["bdist_wheel", "-d", destination_dir] + args += build_options + return args + + +def make_setuptools_clean_args( + setup_py_path: str, + global_options: Sequence[str], +) -> List[str]: + args = make_setuptools_shim_args( + setup_py_path, global_options=global_options, unbuffered_output=True + ) + args += ["clean", "--all"] + return args + + +def make_setuptools_develop_args( + setup_py_path: str, + *, + global_options: Sequence[str], + no_user_config: bool, + prefix: Optional[str], + home: Optional[str], + use_user_site: bool, +) -> List[str]: + assert not (use_user_site and prefix) + + args = make_setuptools_shim_args( + setup_py_path, + global_options=global_options, + no_user_config=no_user_config, + ) + + args += ["develop", "--no-deps"] + + if prefix: + args += ["--prefix", prefix] + if home is not None: + args += ["--install-dir", home] + + if use_user_site: + args += ["--user", "--prefix="] + + return args + + +def make_setuptools_egg_info_args( + setup_py_path: str, + egg_info_dir: Optional[str], + no_user_config: bool, +) -> List[str]: + args = make_setuptools_shim_args(setup_py_path, no_user_config=no_user_config) + + args += ["egg_info"] + + if egg_info_dir: + args += ["--egg-base", egg_info_dir] + + return args diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/subprocess.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/subprocess.py new file mode 100644 index 0000000..cb2e23f --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/subprocess.py @@ -0,0 +1,245 @@ +import logging +import os +import shlex +import subprocess +from typing import Any, Callable, Iterable, List, Literal, Mapping, Optional, Union + +from pip._vendor.rich.markup import escape + +from pip._internal.cli.spinners import SpinnerInterface, open_spinner +from pip._internal.exceptions import InstallationSubprocessError +from pip._internal.utils.logging import VERBOSE, subprocess_logger +from pip._internal.utils.misc import HiddenText + +CommandArgs = List[Union[str, HiddenText]] + + +def make_command(*args: Union[str, HiddenText, CommandArgs]) -> CommandArgs: + """ + Create a CommandArgs object. + """ + command_args: CommandArgs = [] + for arg in args: + # Check for list instead of CommandArgs since CommandArgs is + # only known during type-checking. + if isinstance(arg, list): + command_args.extend(arg) + else: + # Otherwise, arg is str or HiddenText. + command_args.append(arg) + + return command_args + + +def format_command_args(args: Union[List[str], CommandArgs]) -> str: + """ + Format command arguments for display. + """ + # For HiddenText arguments, display the redacted form by calling str(). + # Also, we don't apply str() to arguments that aren't HiddenText since + # this can trigger a UnicodeDecodeError in Python 2 if the argument + # has type unicode and includes a non-ascii character. (The type + # checker doesn't ensure the annotations are correct in all cases.) + return " ".join( + shlex.quote(str(arg)) if isinstance(arg, HiddenText) else shlex.quote(arg) + for arg in args + ) + + +def reveal_command_args(args: Union[List[str], CommandArgs]) -> List[str]: + """ + Return the arguments in their raw, unredacted form. + """ + return [arg.secret if isinstance(arg, HiddenText) else arg for arg in args] + + +def call_subprocess( + cmd: Union[List[str], CommandArgs], + show_stdout: bool = False, + cwd: Optional[str] = None, + on_returncode: 'Literal["raise", "warn", "ignore"]' = "raise", + extra_ok_returncodes: Optional[Iterable[int]] = None, + extra_environ: Optional[Mapping[str, Any]] = None, + unset_environ: Optional[Iterable[str]] = None, + spinner: Optional[SpinnerInterface] = None, + log_failed_cmd: Optional[bool] = True, + stdout_only: Optional[bool] = False, + *, + command_desc: str, +) -> str: + """ + Args: + show_stdout: if true, use INFO to log the subprocess's stderr and + stdout streams. Otherwise, use DEBUG. Defaults to False. + extra_ok_returncodes: an iterable of integer return codes that are + acceptable, in addition to 0. Defaults to None, which means []. + unset_environ: an iterable of environment variable names to unset + prior to calling subprocess.Popen(). + log_failed_cmd: if false, failed commands are not logged, only raised. + stdout_only: if true, return only stdout, else return both. When true, + logging of both stdout and stderr occurs when the subprocess has + terminated, else logging occurs as subprocess output is produced. + """ + if extra_ok_returncodes is None: + extra_ok_returncodes = [] + if unset_environ is None: + unset_environ = [] + # Most places in pip use show_stdout=False. What this means is-- + # + # - We connect the child's output (combined stderr and stdout) to a + # single pipe, which we read. + # - We log this output to stderr at DEBUG level as it is received. + # - If DEBUG logging isn't enabled (e.g. if --verbose logging wasn't + # requested), then we show a spinner so the user can still see the + # subprocess is in progress. + # - If the subprocess exits with an error, we log the output to stderr + # at ERROR level if it hasn't already been displayed to the console + # (e.g. if --verbose logging wasn't enabled). This way we don't log + # the output to the console twice. + # + # If show_stdout=True, then the above is still done, but with DEBUG + # replaced by INFO. + if show_stdout: + # Then log the subprocess output at INFO level. + log_subprocess: Callable[..., None] = subprocess_logger.info + used_level = logging.INFO + else: + # Then log the subprocess output using VERBOSE. This also ensures + # it will be logged to the log file (aka user_log), if enabled. + log_subprocess = subprocess_logger.verbose + used_level = VERBOSE + + # Whether the subprocess will be visible in the console. + showing_subprocess = subprocess_logger.getEffectiveLevel() <= used_level + + # Only use the spinner if we're not showing the subprocess output + # and we have a spinner. + use_spinner = not showing_subprocess and spinner is not None + + log_subprocess("Running command %s", command_desc) + env = os.environ.copy() + if extra_environ: + env.update(extra_environ) + for name in unset_environ: + env.pop(name, None) + try: + proc = subprocess.Popen( + # Convert HiddenText objects to the underlying str. + reveal_command_args(cmd), + stdin=subprocess.PIPE, + stdout=subprocess.PIPE, + stderr=subprocess.STDOUT if not stdout_only else subprocess.PIPE, + cwd=cwd, + env=env, + errors="backslashreplace", + ) + except Exception as exc: + if log_failed_cmd: + subprocess_logger.critical( + "Error %s while executing command %s", + exc, + command_desc, + ) + raise + all_output = [] + if not stdout_only: + assert proc.stdout + assert proc.stdin + proc.stdin.close() + # In this mode, stdout and stderr are in the same pipe. + while True: + line: str = proc.stdout.readline() + if not line: + break + line = line.rstrip() + all_output.append(line + "\n") + + # Show the line immediately. + log_subprocess(line) + # Update the spinner. + if use_spinner: + assert spinner + spinner.spin() + try: + proc.wait() + finally: + if proc.stdout: + proc.stdout.close() + output = "".join(all_output) + else: + # In this mode, stdout and stderr are in different pipes. + # We must use communicate() which is the only safe way to read both. + out, err = proc.communicate() + # log line by line to preserve pip log indenting + for out_line in out.splitlines(): + log_subprocess(out_line) + all_output.append(out) + for err_line in err.splitlines(): + log_subprocess(err_line) + all_output.append(err) + output = out + + proc_had_error = proc.returncode and proc.returncode not in extra_ok_returncodes + if use_spinner: + assert spinner + if proc_had_error: + spinner.finish("error") + else: + spinner.finish("done") + if proc_had_error: + if on_returncode == "raise": + error = InstallationSubprocessError( + command_description=command_desc, + exit_code=proc.returncode, + output_lines=all_output if not showing_subprocess else None, + ) + if log_failed_cmd: + subprocess_logger.error("%s", error, extra={"rich": True}) + subprocess_logger.verbose( + "[bold magenta]full command[/]: [blue]%s[/]", + escape(format_command_args(cmd)), + extra={"markup": True}, + ) + subprocess_logger.verbose( + "[bold magenta]cwd[/]: %s", + escape(cwd or "[inherit]"), + extra={"markup": True}, + ) + + raise error + elif on_returncode == "warn": + subprocess_logger.warning( + 'Command "%s" had error code %s in %s', + command_desc, + proc.returncode, + cwd, + ) + elif on_returncode == "ignore": + pass + else: + raise ValueError(f"Invalid value: on_returncode={on_returncode!r}") + return output + + +def runner_with_spinner_message(message: str) -> Callable[..., None]: + """Provide a subprocess_runner that shows a spinner message. + + Intended for use with for BuildBackendHookCaller. Thus, the runner has + an API that matches what's expected by BuildBackendHookCaller.subprocess_runner. + """ + + def runner( + cmd: List[str], + cwd: Optional[str] = None, + extra_environ: Optional[Mapping[str, Any]] = None, + ) -> None: + with open_spinner(message) as spinner: + call_subprocess( + cmd, + command_desc=message, + cwd=cwd, + extra_environ=extra_environ, + spinner=spinner, + ) + + return runner diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/temp_dir.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/temp_dir.py new file mode 100644 index 0000000..06668e8 --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/temp_dir.py @@ -0,0 +1,296 @@ +import errno +import itertools +import logging +import os.path +import tempfile +import traceback +from contextlib import ExitStack, contextmanager +from pathlib import Path +from typing import ( + Any, + Callable, + Dict, + Generator, + List, + Optional, + TypeVar, + Union, +) + +from pip._internal.utils.misc import enum, rmtree + +logger = logging.getLogger(__name__) + +_T = TypeVar("_T", bound="TempDirectory") + + +# Kinds of temporary directories. Only needed for ones that are +# globally-managed. +tempdir_kinds = enum( + BUILD_ENV="build-env", + EPHEM_WHEEL_CACHE="ephem-wheel-cache", + REQ_BUILD="req-build", +) + + +_tempdir_manager: Optional[ExitStack] = None + + +@contextmanager +def global_tempdir_manager() -> Generator[None, None, None]: + global _tempdir_manager + with ExitStack() as stack: + old_tempdir_manager, _tempdir_manager = _tempdir_manager, stack + try: + yield + finally: + _tempdir_manager = old_tempdir_manager + + +class TempDirectoryTypeRegistry: + """Manages temp directory behavior""" + + def __init__(self) -> None: + self._should_delete: Dict[str, bool] = {} + + def set_delete(self, kind: str, value: bool) -> None: + """Indicate whether a TempDirectory of the given kind should be + auto-deleted. + """ + self._should_delete[kind] = value + + def get_delete(self, kind: str) -> bool: + """Get configured auto-delete flag for a given TempDirectory type, + default True. + """ + return self._should_delete.get(kind, True) + + +_tempdir_registry: Optional[TempDirectoryTypeRegistry] = None + + +@contextmanager +def tempdir_registry() -> Generator[TempDirectoryTypeRegistry, None, None]: + """Provides a scoped global tempdir registry that can be used to dictate + whether directories should be deleted. + """ + global _tempdir_registry + old_tempdir_registry = _tempdir_registry + _tempdir_registry = TempDirectoryTypeRegistry() + try: + yield _tempdir_registry + finally: + _tempdir_registry = old_tempdir_registry + + +class _Default: + pass + + +_default = _Default() + + +class TempDirectory: + """Helper class that owns and cleans up a temporary directory. + + This class can be used as a context manager or as an OO representation of a + temporary directory. + + Attributes: + path + Location to the created temporary directory + delete + Whether the directory should be deleted when exiting + (when used as a contextmanager) + + Methods: + cleanup() + Deletes the temporary directory + + When used as a context manager, if the delete attribute is True, on + exiting the context the temporary directory is deleted. + """ + + def __init__( + self, + path: Optional[str] = None, + delete: Union[bool, None, _Default] = _default, + kind: str = "temp", + globally_managed: bool = False, + ignore_cleanup_errors: bool = True, + ): + super().__init__() + + if delete is _default: + if path is not None: + # If we were given an explicit directory, resolve delete option + # now. + delete = False + else: + # Otherwise, we wait until cleanup and see what + # tempdir_registry says. + delete = None + + # The only time we specify path is in for editables where it + # is the value of the --src option. + if path is None: + path = self._create(kind) + + self._path = path + self._deleted = False + self.delete = delete + self.kind = kind + self.ignore_cleanup_errors = ignore_cleanup_errors + + if globally_managed: + assert _tempdir_manager is not None + _tempdir_manager.enter_context(self) + + @property + def path(self) -> str: + assert not self._deleted, f"Attempted to access deleted path: {self._path}" + return self._path + + def __repr__(self) -> str: + return f"<{self.__class__.__name__} {self.path!r}>" + + def __enter__(self: _T) -> _T: + return self + + def __exit__(self, exc: Any, value: Any, tb: Any) -> None: + if self.delete is not None: + delete = self.delete + elif _tempdir_registry: + delete = _tempdir_registry.get_delete(self.kind) + else: + delete = True + + if delete: + self.cleanup() + + def _create(self, kind: str) -> str: + """Create a temporary directory and store its path in self.path""" + # We realpath here because some systems have their default tmpdir + # symlinked to another directory. This tends to confuse build + # scripts, so we canonicalize the path by traversing potential + # symlinks here. + path = os.path.realpath(tempfile.mkdtemp(prefix=f"pip-{kind}-")) + logger.debug("Created temporary directory: %s", path) + return path + + def cleanup(self) -> None: + """Remove the temporary directory created and reset state""" + self._deleted = True + if not os.path.exists(self._path): + return + + errors: List[BaseException] = [] + + def onerror( + func: Callable[..., Any], + path: Path, + exc_val: BaseException, + ) -> None: + """Log a warning for a `rmtree` error and continue""" + formatted_exc = "\n".join( + traceback.format_exception_only(type(exc_val), exc_val) + ) + formatted_exc = formatted_exc.rstrip() # remove trailing new line + if func in (os.unlink, os.remove, os.rmdir): + logger.debug( + "Failed to remove a temporary file '%s' due to %s.\n", + path, + formatted_exc, + ) + else: + logger.debug("%s failed with %s.", func.__qualname__, formatted_exc) + errors.append(exc_val) + + if self.ignore_cleanup_errors: + try: + # first try with @retry; retrying to handle ephemeral errors + rmtree(self._path, ignore_errors=False) + except OSError: + # last pass ignore/log all errors + rmtree(self._path, onexc=onerror) + if errors: + logger.warning( + "Failed to remove contents in a temporary directory '%s'.\n" + "You can safely remove it manually.", + self._path, + ) + else: + rmtree(self._path) + + +class AdjacentTempDirectory(TempDirectory): + """Helper class that creates a temporary directory adjacent to a real one. + + Attributes: + original + The original directory to create a temp directory for. + path + After calling create() or entering, contains the full + path to the temporary directory. + delete + Whether the directory should be deleted when exiting + (when used as a contextmanager) + + """ + + # The characters that may be used to name the temp directory + # We always prepend a ~ and then rotate through these until + # a usable name is found. + # pkg_resources raises a different error for .dist-info folder + # with leading '-' and invalid metadata + LEADING_CHARS = "-~.=%0123456789" + + def __init__(self, original: str, delete: Optional[bool] = None) -> None: + self.original = original.rstrip("/\\") + super().__init__(delete=delete) + + @classmethod + def _generate_names(cls, name: str) -> Generator[str, None, None]: + """Generates a series of temporary names. + + The algorithm replaces the leading characters in the name + with ones that are valid filesystem characters, but are not + valid package names (for both Python and pip definitions of + package). + """ + for i in range(1, len(name)): + for candidate in itertools.combinations_with_replacement( + cls.LEADING_CHARS, i - 1 + ): + new_name = "~" + "".join(candidate) + name[i:] + if new_name != name: + yield new_name + + # If we make it this far, we will have to make a longer name + for i in range(len(cls.LEADING_CHARS)): + for candidate in itertools.combinations_with_replacement( + cls.LEADING_CHARS, i + ): + new_name = "~" + "".join(candidate) + name + if new_name != name: + yield new_name + + def _create(self, kind: str) -> str: + root, name = os.path.split(self.original) + for candidate in self._generate_names(name): + path = os.path.join(root, candidate) + try: + os.mkdir(path) + except OSError as ex: + # Continue if the name exists already + if ex.errno != errno.EEXIST: + raise + else: + path = os.path.realpath(path) + break + else: + # Final fallback on the default behavior. + path = os.path.realpath(tempfile.mkdtemp(prefix=f"pip-{kind}-")) + + logger.debug("Created temporary directory: %s", path) + return path diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/unpacking.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/unpacking.py new file mode 100644 index 0000000..87a6d19 --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/unpacking.py @@ -0,0 +1,337 @@ +"""Utilities related archives. +""" + +import logging +import os +import shutil +import stat +import sys +import tarfile +import zipfile +from typing import Iterable, List, Optional +from zipfile import ZipInfo + +from pip._internal.exceptions import InstallationError +from pip._internal.utils.filetypes import ( + BZ2_EXTENSIONS, + TAR_EXTENSIONS, + XZ_EXTENSIONS, + ZIP_EXTENSIONS, +) +from pip._internal.utils.misc import ensure_dir + +logger = logging.getLogger(__name__) + + +SUPPORTED_EXTENSIONS = ZIP_EXTENSIONS + TAR_EXTENSIONS + +try: + import bz2 # noqa + + SUPPORTED_EXTENSIONS += BZ2_EXTENSIONS +except ImportError: + logger.debug("bz2 module is not available") + +try: + # Only for Python 3.3+ + import lzma # noqa + + SUPPORTED_EXTENSIONS += XZ_EXTENSIONS +except ImportError: + logger.debug("lzma module is not available") + + +def current_umask() -> int: + """Get the current umask which involves having to set it temporarily.""" + mask = os.umask(0) + os.umask(mask) + return mask + + +def split_leading_dir(path: str) -> List[str]: + path = path.lstrip("/").lstrip("\\") + if "/" in path and ( + ("\\" in path and path.find("/") < path.find("\\")) or "\\" not in path + ): + return path.split("/", 1) + elif "\\" in path: + return path.split("\\", 1) + else: + return [path, ""] + + +def has_leading_dir(paths: Iterable[str]) -> bool: + """Returns true if all the paths have the same leading path name + (i.e., everything is in one subdirectory in an archive)""" + common_prefix = None + for path in paths: + prefix, rest = split_leading_dir(path) + if not prefix: + return False + elif common_prefix is None: + common_prefix = prefix + elif prefix != common_prefix: + return False + return True + + +def is_within_directory(directory: str, target: str) -> bool: + """ + Return true if the absolute path of target is within the directory + """ + abs_directory = os.path.abspath(directory) + abs_target = os.path.abspath(target) + + prefix = os.path.commonprefix([abs_directory, abs_target]) + return prefix == abs_directory + + +def _get_default_mode_plus_executable() -> int: + return 0o777 & ~current_umask() | 0o111 + + +def set_extracted_file_to_default_mode_plus_executable(path: str) -> None: + """ + Make file present at path have execute for user/group/world + (chmod +x) is no-op on windows per python docs + """ + os.chmod(path, _get_default_mode_plus_executable()) + + +def zip_item_is_executable(info: ZipInfo) -> bool: + mode = info.external_attr >> 16 + # if mode and regular file and any execute permissions for + # user/group/world? + return bool(mode and stat.S_ISREG(mode) and mode & 0o111) + + +def unzip_file(filename: str, location: str, flatten: bool = True) -> None: + """ + Unzip the file (with path `filename`) to the destination `location`. All + files are written based on system defaults and umask (i.e. permissions are + not preserved), except that regular file members with any execute + permissions (user, group, or world) have "chmod +x" applied after being + written. Note that for windows, any execute changes using os.chmod are + no-ops per the python docs. + """ + ensure_dir(location) + zipfp = open(filename, "rb") + try: + zip = zipfile.ZipFile(zipfp, allowZip64=True) + leading = has_leading_dir(zip.namelist()) and flatten + for info in zip.infolist(): + name = info.filename + fn = name + if leading: + fn = split_leading_dir(name)[1] + fn = os.path.join(location, fn) + dir = os.path.dirname(fn) + if not is_within_directory(location, fn): + message = ( + "The zip file ({}) has a file ({}) trying to install " + "outside target directory ({})" + ) + raise InstallationError(message.format(filename, fn, location)) + if fn.endswith("/") or fn.endswith("\\"): + # A directory + ensure_dir(fn) + else: + ensure_dir(dir) + # Don't use read() to avoid allocating an arbitrarily large + # chunk of memory for the file's content + fp = zip.open(name) + try: + with open(fn, "wb") as destfp: + shutil.copyfileobj(fp, destfp) + finally: + fp.close() + if zip_item_is_executable(info): + set_extracted_file_to_default_mode_plus_executable(fn) + finally: + zipfp.close() + + +def untar_file(filename: str, location: str) -> None: + """ + Untar the file (with path `filename`) to the destination `location`. + All files are written based on system defaults and umask (i.e. permissions + are not preserved), except that regular file members with any execute + permissions (user, group, or world) have "chmod +x" applied on top of the + default. Note that for windows, any execute changes using os.chmod are + no-ops per the python docs. + """ + ensure_dir(location) + if filename.lower().endswith(".gz") or filename.lower().endswith(".tgz"): + mode = "r:gz" + elif filename.lower().endswith(BZ2_EXTENSIONS): + mode = "r:bz2" + elif filename.lower().endswith(XZ_EXTENSIONS): + mode = "r:xz" + elif filename.lower().endswith(".tar"): + mode = "r" + else: + logger.warning( + "Cannot determine compression type for file %s", + filename, + ) + mode = "r:*" + + tar = tarfile.open(filename, mode, encoding="utf-8") # type: ignore + try: + leading = has_leading_dir([member.name for member in tar.getmembers()]) + + # PEP 706 added `tarfile.data_filter`, and made some other changes to + # Python's tarfile module (see below). The features were backported to + # security releases. + try: + data_filter = tarfile.data_filter + except AttributeError: + _untar_without_filter(filename, location, tar, leading) + else: + default_mode_plus_executable = _get_default_mode_plus_executable() + + if leading: + # Strip the leading directory from all files in the archive, + # including hardlink targets (which are relative to the + # unpack location). + for member in tar.getmembers(): + name_lead, name_rest = split_leading_dir(member.name) + member.name = name_rest + if member.islnk(): + lnk_lead, lnk_rest = split_leading_dir(member.linkname) + if lnk_lead == name_lead: + member.linkname = lnk_rest + + def pip_filter(member: tarfile.TarInfo, path: str) -> tarfile.TarInfo: + orig_mode = member.mode + try: + try: + member = data_filter(member, location) + except tarfile.LinkOutsideDestinationError: + if sys.version_info[:3] in { + (3, 8, 17), + (3, 9, 17), + (3, 10, 12), + (3, 11, 4), + }: + # The tarfile filter in specific Python versions + # raises LinkOutsideDestinationError on valid input + # (https://github.com/python/cpython/issues/107845) + # Ignore the error there, but do use the + # more lax `tar_filter` + member = tarfile.tar_filter(member, location) + else: + raise + except tarfile.TarError as exc: + message = "Invalid member in the tar file {}: {}" + # Filter error messages mention the member name. + # No need to add it here. + raise InstallationError( + message.format( + filename, + exc, + ) + ) + if member.isfile() and orig_mode & 0o111: + member.mode = default_mode_plus_executable + else: + # See PEP 706 note above. + # The PEP changed this from `int` to `Optional[int]`, + # where None means "use the default". Mypy doesn't + # know this yet. + member.mode = None # type: ignore [assignment] + return member + + tar.extractall(location, filter=pip_filter) + + finally: + tar.close() + + +def _untar_without_filter( + filename: str, + location: str, + tar: tarfile.TarFile, + leading: bool, +) -> None: + """Fallback for Python without tarfile.data_filter""" + for member in tar.getmembers(): + fn = member.name + if leading: + fn = split_leading_dir(fn)[1] + path = os.path.join(location, fn) + if not is_within_directory(location, path): + message = ( + "The tar file ({}) has a file ({}) trying to install " + "outside target directory ({})" + ) + raise InstallationError(message.format(filename, path, location)) + if member.isdir(): + ensure_dir(path) + elif member.issym(): + try: + tar._extract_member(member, path) + except Exception as exc: + # Some corrupt tar files seem to produce this + # (specifically bad symlinks) + logger.warning( + "In the tar file %s the member %s is invalid: %s", + filename, + member.name, + exc, + ) + continue + else: + try: + fp = tar.extractfile(member) + except (KeyError, AttributeError) as exc: + # Some corrupt tar files seem to produce this + # (specifically bad symlinks) + logger.warning( + "In the tar file %s the member %s is invalid: %s", + filename, + member.name, + exc, + ) + continue + ensure_dir(os.path.dirname(path)) + assert fp is not None + with open(path, "wb") as destfp: + shutil.copyfileobj(fp, destfp) + fp.close() + # Update the timestamp (useful for cython compiled files) + tar.utime(member, path) + # member have any execute permissions for user/group/world? + if member.mode & 0o111: + set_extracted_file_to_default_mode_plus_executable(path) + + +def unpack_file( + filename: str, + location: str, + content_type: Optional[str] = None, +) -> None: + filename = os.path.realpath(filename) + if ( + content_type == "application/zip" + or filename.lower().endswith(ZIP_EXTENSIONS) + or zipfile.is_zipfile(filename) + ): + unzip_file(filename, location, flatten=not filename.endswith(".whl")) + elif ( + content_type == "application/x-gzip" + or tarfile.is_tarfile(filename) + or filename.lower().endswith(TAR_EXTENSIONS + BZ2_EXTENSIONS + XZ_EXTENSIONS) + ): + untar_file(filename, location) + else: + # FIXME: handle? + # FIXME: magic signatures? + logger.critical( + "Cannot unpack file %s (downloaded from %s, content-type: %s); " + "cannot detect archive format", + filename, + location, + content_type, + ) + raise InstallationError(f"Cannot determine archive format of {location}") diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/urls.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/urls.py new file mode 100644 index 0000000..9f34f88 --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/urls.py @@ -0,0 +1,55 @@ +import os +import string +import urllib.parse +import urllib.request + +from .compat import WINDOWS + + +def path_to_url(path: str) -> str: + """ + Convert a path to a file: URL. The path will be made absolute and have + quoted path parts. + """ + path = os.path.normpath(os.path.abspath(path)) + url = urllib.parse.urljoin("file:", urllib.request.pathname2url(path)) + return url + + +def url_to_path(url: str) -> str: + """ + Convert a file: URL to a path. + """ + assert url.startswith( + "file:" + ), f"You can only turn file: urls into filenames (not {url!r})" + + _, netloc, path, _, _ = urllib.parse.urlsplit(url) + + if not netloc or netloc == "localhost": + # According to RFC 8089, same as empty authority. + netloc = "" + elif WINDOWS: + # If we have a UNC path, prepend UNC share notation. + netloc = "\\\\" + netloc + else: + raise ValueError( + f"non-local file URIs are not supported on this platform: {url!r}" + ) + + path = urllib.request.url2pathname(netloc + path) + + # On Windows, urlsplit parses the path as something like "/C:/Users/foo". + # This creates issues for path-related functions like io.open(), so we try + # to detect and strip the leading slash. + if ( + WINDOWS + and not netloc # Not UNC. + and len(path) >= 3 + and path[0] == "/" # Leading slash to strip. + and path[1] in string.ascii_letters # Drive letter. + and path[2:4] in (":", ":/") # Colon + end of string, or colon + absolute path. + ): + path = path[1:] + + return path diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/virtualenv.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/virtualenv.py new file mode 100644 index 0000000..882e36f --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/virtualenv.py @@ -0,0 +1,104 @@ +import logging +import os +import re +import site +import sys +from typing import List, Optional + +logger = logging.getLogger(__name__) +_INCLUDE_SYSTEM_SITE_PACKAGES_REGEX = re.compile( + r"include-system-site-packages\s*=\s*(?Ptrue|false)" +) + + +def _running_under_venv() -> bool: + """Checks if sys.base_prefix and sys.prefix match. + + This handles PEP 405 compliant virtual environments. + """ + return sys.prefix != getattr(sys, "base_prefix", sys.prefix) + + +def _running_under_legacy_virtualenv() -> bool: + """Checks if sys.real_prefix is set. + + This handles virtual environments created with pypa's virtualenv. + """ + # pypa/virtualenv case + return hasattr(sys, "real_prefix") + + +def running_under_virtualenv() -> bool: + """True if we're running inside a virtual environment, False otherwise.""" + return _running_under_venv() or _running_under_legacy_virtualenv() + + +def _get_pyvenv_cfg_lines() -> Optional[List[str]]: + """Reads {sys.prefix}/pyvenv.cfg and returns its contents as list of lines + + Returns None, if it could not read/access the file. + """ + pyvenv_cfg_file = os.path.join(sys.prefix, "pyvenv.cfg") + try: + # Although PEP 405 does not specify, the built-in venv module always + # writes with UTF-8. (pypa/pip#8717) + with open(pyvenv_cfg_file, encoding="utf-8") as f: + return f.read().splitlines() # avoids trailing newlines + except OSError: + return None + + +def _no_global_under_venv() -> bool: + """Check `{sys.prefix}/pyvenv.cfg` for system site-packages inclusion + + PEP 405 specifies that when system site-packages are not supposed to be + visible from a virtual environment, `pyvenv.cfg` must contain the following + line: + + include-system-site-packages = false + + Additionally, log a warning if accessing the file fails. + """ + cfg_lines = _get_pyvenv_cfg_lines() + if cfg_lines is None: + # We're not in a "sane" venv, so assume there is no system + # site-packages access (since that's PEP 405's default state). + logger.warning( + "Could not access 'pyvenv.cfg' despite a virtual environment " + "being active. Assuming global site-packages is not accessible " + "in this environment." + ) + return True + + for line in cfg_lines: + match = _INCLUDE_SYSTEM_SITE_PACKAGES_REGEX.match(line) + if match is not None and match.group("value") == "false": + return True + return False + + +def _no_global_under_legacy_virtualenv() -> bool: + """Check if "no-global-site-packages.txt" exists beside site.py + + This mirrors logic in pypa/virtualenv for determining whether system + site-packages are visible in the virtual environment. + """ + site_mod_dir = os.path.dirname(os.path.abspath(site.__file__)) + no_global_site_packages_file = os.path.join( + site_mod_dir, + "no-global-site-packages.txt", + ) + return os.path.exists(no_global_site_packages_file) + + +def virtualenv_no_global() -> bool: + """Returns a boolean, whether running in venv with no system site-packages.""" + # PEP 405 compliance needs to be checked first since virtualenv >=20 would + # return True for both checks, but is only able to use the PEP 405 config. + if _running_under_venv(): + return _no_global_under_venv() + + if _running_under_legacy_virtualenv(): + return _no_global_under_legacy_virtualenv() + + return False diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/wheel.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/wheel.py new file mode 100644 index 0000000..f85aee8 --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/utils/wheel.py @@ -0,0 +1,134 @@ +"""Support functions for working with wheel files. +""" + +import logging +from email.message import Message +from email.parser import Parser +from typing import Tuple +from zipfile import BadZipFile, ZipFile + +from pip._vendor.packaging.utils import canonicalize_name + +from pip._internal.exceptions import UnsupportedWheel + +VERSION_COMPATIBLE = (1, 0) + + +logger = logging.getLogger(__name__) + + +def parse_wheel(wheel_zip: ZipFile, name: str) -> Tuple[str, Message]: + """Extract information from the provided wheel, ensuring it meets basic + standards. + + Returns the name of the .dist-info directory and the parsed WHEEL metadata. + """ + try: + info_dir = wheel_dist_info_dir(wheel_zip, name) + metadata = wheel_metadata(wheel_zip, info_dir) + version = wheel_version(metadata) + except UnsupportedWheel as e: + raise UnsupportedWheel(f"{name} has an invalid wheel, {e}") + + check_compatibility(version, name) + + return info_dir, metadata + + +def wheel_dist_info_dir(source: ZipFile, name: str) -> str: + """Returns the name of the contained .dist-info directory. + + Raises AssertionError or UnsupportedWheel if not found, >1 found, or + it doesn't match the provided name. + """ + # Zip file path separators must be / + subdirs = {p.split("/", 1)[0] for p in source.namelist()} + + info_dirs = [s for s in subdirs if s.endswith(".dist-info")] + + if not info_dirs: + raise UnsupportedWheel(".dist-info directory not found") + + if len(info_dirs) > 1: + raise UnsupportedWheel( + "multiple .dist-info directories found: {}".format(", ".join(info_dirs)) + ) + + info_dir = info_dirs[0] + + info_dir_name = canonicalize_name(info_dir) + canonical_name = canonicalize_name(name) + if not info_dir_name.startswith(canonical_name): + raise UnsupportedWheel( + f".dist-info directory {info_dir!r} does not start with {canonical_name!r}" + ) + + return info_dir + + +def read_wheel_metadata_file(source: ZipFile, path: str) -> bytes: + try: + return source.read(path) + # BadZipFile for general corruption, KeyError for missing entry, + # and RuntimeError for password-protected files + except (BadZipFile, KeyError, RuntimeError) as e: + raise UnsupportedWheel(f"could not read {path!r} file: {e!r}") + + +def wheel_metadata(source: ZipFile, dist_info_dir: str) -> Message: + """Return the WHEEL metadata of an extracted wheel, if possible. + Otherwise, raise UnsupportedWheel. + """ + path = f"{dist_info_dir}/WHEEL" + # Zip file path separators must be / + wheel_contents = read_wheel_metadata_file(source, path) + + try: + wheel_text = wheel_contents.decode() + except UnicodeDecodeError as e: + raise UnsupportedWheel(f"error decoding {path!r}: {e!r}") + + # FeedParser (used by Parser) does not raise any exceptions. The returned + # message may have .defects populated, but for backwards-compatibility we + # currently ignore them. + return Parser().parsestr(wheel_text) + + +def wheel_version(wheel_data: Message) -> Tuple[int, ...]: + """Given WHEEL metadata, return the parsed Wheel-Version. + Otherwise, raise UnsupportedWheel. + """ + version_text = wheel_data["Wheel-Version"] + if version_text is None: + raise UnsupportedWheel("WHEEL is missing Wheel-Version") + + version = version_text.strip() + + try: + return tuple(map(int, version.split("."))) + except ValueError: + raise UnsupportedWheel(f"invalid Wheel-Version: {version!r}") + + +def check_compatibility(version: Tuple[int, ...], name: str) -> None: + """Raises errors or warns if called with an incompatible Wheel-Version. + + pip should refuse to install a Wheel-Version that's a major series + ahead of what it's compatible with (e.g 2.0 > 1.1); and warn when + installing a version only minor version ahead (e.g 1.2 > 1.1). + + version: a 2-tuple representing a Wheel-Version (Major, Minor) + name: name of wheel or package to raise exception about + + :raises UnsupportedWheel: when an incompatible Wheel-Version is given + """ + if version[0] > VERSION_COMPATIBLE[0]: + raise UnsupportedWheel( + "{}'s Wheel-Version ({}) is not compatible with this version " + "of pip".format(name, ".".join(map(str, version))) + ) + elif version > VERSION_COMPATIBLE: + logger.warning( + "Installing from a newer Wheel-Version (%s)", + ".".join(map(str, version)), + ) diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/vcs/__init__.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/vcs/__init__.py new file mode 100644 index 0000000..b6beddb --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/vcs/__init__.py @@ -0,0 +1,15 @@ +# Expose a limited set of classes and functions so callers outside of +# the vcs package don't need to import deeper than `pip._internal.vcs`. +# (The test directory may still need to import from a vcs sub-package.) +# Import all vcs modules to register each VCS in the VcsSupport object. +import pip._internal.vcs.bazaar +import pip._internal.vcs.git +import pip._internal.vcs.mercurial +import pip._internal.vcs.subversion # noqa: F401 +from pip._internal.vcs.versioncontrol import ( # noqa: F401 + RemoteNotFoundError, + RemoteNotValidError, + is_url, + make_vcs_requirement_url, + vcs, +) diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/vcs/__pycache__/__init__.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/vcs/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000..0bae1a8 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/vcs/__pycache__/__init__.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/vcs/__pycache__/bazaar.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/vcs/__pycache__/bazaar.cpython-312.pyc new file mode 100644 index 0000000..555f5ef Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/vcs/__pycache__/bazaar.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/vcs/__pycache__/git.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/vcs/__pycache__/git.cpython-312.pyc new file mode 100644 index 0000000..dc7e8c2 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/vcs/__pycache__/git.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/vcs/__pycache__/mercurial.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/vcs/__pycache__/mercurial.cpython-312.pyc new file mode 100644 index 0000000..2775fb5 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/vcs/__pycache__/mercurial.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/vcs/__pycache__/subversion.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/vcs/__pycache__/subversion.cpython-312.pyc new file mode 100644 index 0000000..4245b35 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/vcs/__pycache__/subversion.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/vcs/__pycache__/versioncontrol.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/vcs/__pycache__/versioncontrol.cpython-312.pyc new file mode 100644 index 0000000..9e46ef0 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/vcs/__pycache__/versioncontrol.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/vcs/bazaar.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/vcs/bazaar.py new file mode 100644 index 0000000..c754b7c --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/vcs/bazaar.py @@ -0,0 +1,112 @@ +import logging +from typing import List, Optional, Tuple + +from pip._internal.utils.misc import HiddenText, display_path +from pip._internal.utils.subprocess import make_command +from pip._internal.utils.urls import path_to_url +from pip._internal.vcs.versioncontrol import ( + AuthInfo, + RemoteNotFoundError, + RevOptions, + VersionControl, + vcs, +) + +logger = logging.getLogger(__name__) + + +class Bazaar(VersionControl): + name = "bzr" + dirname = ".bzr" + repo_name = "branch" + schemes = ( + "bzr+http", + "bzr+https", + "bzr+ssh", + "bzr+sftp", + "bzr+ftp", + "bzr+lp", + "bzr+file", + ) + + @staticmethod + def get_base_rev_args(rev: str) -> List[str]: + return ["-r", rev] + + def fetch_new( + self, dest: str, url: HiddenText, rev_options: RevOptions, verbosity: int + ) -> None: + rev_display = rev_options.to_display() + logger.info( + "Checking out %s%s to %s", + url, + rev_display, + display_path(dest), + ) + if verbosity <= 0: + flags = ["--quiet"] + elif verbosity == 1: + flags = [] + else: + flags = [f"-{'v'*verbosity}"] + cmd_args = make_command( + "checkout", "--lightweight", *flags, rev_options.to_args(), url, dest + ) + self.run_command(cmd_args) + + def switch(self, dest: str, url: HiddenText, rev_options: RevOptions) -> None: + self.run_command(make_command("switch", url), cwd=dest) + + def update(self, dest: str, url: HiddenText, rev_options: RevOptions) -> None: + output = self.run_command( + make_command("info"), show_stdout=False, stdout_only=True, cwd=dest + ) + if output.startswith("Standalone "): + # Older versions of pip used to create standalone branches. + # Convert the standalone branch to a checkout by calling "bzr bind". + cmd_args = make_command("bind", "-q", url) + self.run_command(cmd_args, cwd=dest) + + cmd_args = make_command("update", "-q", rev_options.to_args()) + self.run_command(cmd_args, cwd=dest) + + @classmethod + def get_url_rev_and_auth(cls, url: str) -> Tuple[str, Optional[str], AuthInfo]: + # hotfix the URL scheme after removing bzr+ from bzr+ssh:// re-add it + url, rev, user_pass = super().get_url_rev_and_auth(url) + if url.startswith("ssh://"): + url = "bzr+" + url + return url, rev, user_pass + + @classmethod + def get_remote_url(cls, location: str) -> str: + urls = cls.run_command( + ["info"], show_stdout=False, stdout_only=True, cwd=location + ) + for line in urls.splitlines(): + line = line.strip() + for x in ("checkout of branch: ", "parent branch: "): + if line.startswith(x): + repo = line.split(x)[1] + if cls._is_local_repository(repo): + return path_to_url(repo) + return repo + raise RemoteNotFoundError + + @classmethod + def get_revision(cls, location: str) -> str: + revision = cls.run_command( + ["revno"], + show_stdout=False, + stdout_only=True, + cwd=location, + ) + return revision.splitlines()[-1] + + @classmethod + def is_commit_id_equal(cls, dest: str, name: Optional[str]) -> bool: + """Always assume the versions don't match""" + return False + + +vcs.register(Bazaar) diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/vcs/git.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/vcs/git.py new file mode 100644 index 0000000..0425deb --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/vcs/git.py @@ -0,0 +1,527 @@ +import logging +import os.path +import pathlib +import re +import urllib.parse +import urllib.request +from dataclasses import replace +from typing import List, Optional, Tuple + +from pip._internal.exceptions import BadCommand, InstallationError +from pip._internal.utils.misc import HiddenText, display_path, hide_url +from pip._internal.utils.subprocess import make_command +from pip._internal.vcs.versioncontrol import ( + AuthInfo, + RemoteNotFoundError, + RemoteNotValidError, + RevOptions, + VersionControl, + find_path_to_project_root_from_repo_root, + vcs, +) + +urlsplit = urllib.parse.urlsplit +urlunsplit = urllib.parse.urlunsplit + + +logger = logging.getLogger(__name__) + + +GIT_VERSION_REGEX = re.compile( + r"^git version " # Prefix. + r"(\d+)" # Major. + r"\.(\d+)" # Dot, minor. + r"(?:\.(\d+))?" # Optional dot, patch. + r".*$" # Suffix, including any pre- and post-release segments we don't care about. +) + +HASH_REGEX = re.compile("^[a-fA-F0-9]{40}$") + +# SCP (Secure copy protocol) shorthand. e.g. 'git@example.com:foo/bar.git' +SCP_REGEX = re.compile( + r"""^ + # Optional user, e.g. 'git@' + (\w+@)? + # Server, e.g. 'github.com'. + ([^/:]+): + # The server-side path. e.g. 'user/project.git'. Must start with an + # alphanumeric character so as not to be confusable with a Windows paths + # like 'C:/foo/bar' or 'C:\foo\bar'. + (\w[^:]*) + $""", + re.VERBOSE, +) + + +def looks_like_hash(sha: str) -> bool: + return bool(HASH_REGEX.match(sha)) + + +class Git(VersionControl): + name = "git" + dirname = ".git" + repo_name = "clone" + schemes = ( + "git+http", + "git+https", + "git+ssh", + "git+git", + "git+file", + ) + # Prevent the user's environment variables from interfering with pip: + # https://github.com/pypa/pip/issues/1130 + unset_environ = ("GIT_DIR", "GIT_WORK_TREE") + default_arg_rev = "HEAD" + + @staticmethod + def get_base_rev_args(rev: str) -> List[str]: + return [rev] + + def is_immutable_rev_checkout(self, url: str, dest: str) -> bool: + _, rev_options = self.get_url_rev_options(hide_url(url)) + if not rev_options.rev: + return False + if not self.is_commit_id_equal(dest, rev_options.rev): + # the current commit is different from rev, + # which means rev was something else than a commit hash + return False + # return False in the rare case rev is both a commit hash + # and a tag or a branch; we don't want to cache in that case + # because that branch/tag could point to something else in the future + is_tag_or_branch = bool(self.get_revision_sha(dest, rev_options.rev)[0]) + return not is_tag_or_branch + + def get_git_version(self) -> Tuple[int, ...]: + version = self.run_command( + ["version"], + command_desc="git version", + show_stdout=False, + stdout_only=True, + ) + match = GIT_VERSION_REGEX.match(version) + if not match: + logger.warning("Can't parse git version: %s", version) + return () + return (int(match.group(1)), int(match.group(2))) + + @classmethod + def get_current_branch(cls, location: str) -> Optional[str]: + """ + Return the current branch, or None if HEAD isn't at a branch + (e.g. detached HEAD). + """ + # git-symbolic-ref exits with empty stdout if "HEAD" is a detached + # HEAD rather than a symbolic ref. In addition, the -q causes the + # command to exit with status code 1 instead of 128 in this case + # and to suppress the message to stderr. + args = ["symbolic-ref", "-q", "HEAD"] + output = cls.run_command( + args, + extra_ok_returncodes=(1,), + show_stdout=False, + stdout_only=True, + cwd=location, + ) + ref = output.strip() + + if ref.startswith("refs/heads/"): + return ref[len("refs/heads/") :] + + return None + + @classmethod + def get_revision_sha(cls, dest: str, rev: str) -> Tuple[Optional[str], bool]: + """ + Return (sha_or_none, is_branch), where sha_or_none is a commit hash + if the revision names a remote branch or tag, otherwise None. + + Args: + dest: the repository directory. + rev: the revision name. + """ + # Pass rev to pre-filter the list. + output = cls.run_command( + ["show-ref", rev], + cwd=dest, + show_stdout=False, + stdout_only=True, + on_returncode="ignore", + ) + refs = {} + # NOTE: We do not use splitlines here since that would split on other + # unicode separators, which can be maliciously used to install a + # different revision. + for line in output.strip().split("\n"): + line = line.rstrip("\r") + if not line: + continue + try: + ref_sha, ref_name = line.split(" ", maxsplit=2) + except ValueError: + # Include the offending line to simplify troubleshooting if + # this error ever occurs. + raise ValueError(f"unexpected show-ref line: {line!r}") + + refs[ref_name] = ref_sha + + branch_ref = f"refs/remotes/origin/{rev}" + tag_ref = f"refs/tags/{rev}" + + sha = refs.get(branch_ref) + if sha is not None: + return (sha, True) + + sha = refs.get(tag_ref) + + return (sha, False) + + @classmethod + def _should_fetch(cls, dest: str, rev: str) -> bool: + """ + Return true if rev is a ref or is a commit that we don't have locally. + + Branches and tags are not considered in this method because they are + assumed to be always available locally (which is a normal outcome of + ``git clone`` and ``git fetch --tags``). + """ + if rev.startswith("refs/"): + # Always fetch remote refs. + return True + + if not looks_like_hash(rev): + # Git fetch would fail with abbreviated commits. + return False + + if cls.has_commit(dest, rev): + # Don't fetch if we have the commit locally. + return False + + return True + + @classmethod + def resolve_revision( + cls, dest: str, url: HiddenText, rev_options: RevOptions + ) -> RevOptions: + """ + Resolve a revision to a new RevOptions object with the SHA1 of the + branch, tag, or ref if found. + + Args: + rev_options: a RevOptions object. + """ + rev = rev_options.arg_rev + # The arg_rev property's implementation for Git ensures that the + # rev return value is always non-None. + assert rev is not None + + sha, is_branch = cls.get_revision_sha(dest, rev) + + if sha is not None: + rev_options = rev_options.make_new(sha) + rev_options = replace(rev_options, branch_name=(rev if is_branch else None)) + + return rev_options + + # Do not show a warning for the common case of something that has + # the form of a Git commit hash. + if not looks_like_hash(rev): + logger.warning( + "Did not find branch or tag '%s', assuming revision or ref.", + rev, + ) + + if not cls._should_fetch(dest, rev): + return rev_options + + # fetch the requested revision + cls.run_command( + make_command("fetch", "-q", url, rev_options.to_args()), + cwd=dest, + ) + # Change the revision to the SHA of the ref we fetched + sha = cls.get_revision(dest, rev="FETCH_HEAD") + rev_options = rev_options.make_new(sha) + + return rev_options + + @classmethod + def is_commit_id_equal(cls, dest: str, name: Optional[str]) -> bool: + """ + Return whether the current commit hash equals the given name. + + Args: + dest: the repository directory. + name: a string name. + """ + if not name: + # Then avoid an unnecessary subprocess call. + return False + + return cls.get_revision(dest) == name + + def fetch_new( + self, dest: str, url: HiddenText, rev_options: RevOptions, verbosity: int + ) -> None: + rev_display = rev_options.to_display() + logger.info("Cloning %s%s to %s", url, rev_display, display_path(dest)) + if verbosity <= 0: + flags: Tuple[str, ...] = ("--quiet",) + elif verbosity == 1: + flags = () + else: + flags = ("--verbose", "--progress") + if self.get_git_version() >= (2, 17): + # Git added support for partial clone in 2.17 + # https://git-scm.com/docs/partial-clone + # Speeds up cloning by functioning without a complete copy of repository + self.run_command( + make_command( + "clone", + "--filter=blob:none", + *flags, + url, + dest, + ) + ) + else: + self.run_command(make_command("clone", *flags, url, dest)) + + if rev_options.rev: + # Then a specific revision was requested. + rev_options = self.resolve_revision(dest, url, rev_options) + branch_name = getattr(rev_options, "branch_name", None) + logger.debug("Rev options %s, branch_name %s", rev_options, branch_name) + if branch_name is None: + # Only do a checkout if the current commit id doesn't match + # the requested revision. + if not self.is_commit_id_equal(dest, rev_options.rev): + cmd_args = make_command( + "checkout", + "-q", + rev_options.to_args(), + ) + self.run_command(cmd_args, cwd=dest) + elif self.get_current_branch(dest) != branch_name: + # Then a specific branch was requested, and that branch + # is not yet checked out. + track_branch = f"origin/{branch_name}" + cmd_args = [ + "checkout", + "-b", + branch_name, + "--track", + track_branch, + ] + self.run_command(cmd_args, cwd=dest) + else: + sha = self.get_revision(dest) + rev_options = rev_options.make_new(sha) + + logger.info("Resolved %s to commit %s", url, rev_options.rev) + + #: repo may contain submodules + self.update_submodules(dest) + + def switch(self, dest: str, url: HiddenText, rev_options: RevOptions) -> None: + self.run_command( + make_command("config", "remote.origin.url", url), + cwd=dest, + ) + cmd_args = make_command("checkout", "-q", rev_options.to_args()) + self.run_command(cmd_args, cwd=dest) + + self.update_submodules(dest) + + def update(self, dest: str, url: HiddenText, rev_options: RevOptions) -> None: + # First fetch changes from the default remote + if self.get_git_version() >= (1, 9): + # fetch tags in addition to everything else + self.run_command(["fetch", "-q", "--tags"], cwd=dest) + else: + self.run_command(["fetch", "-q"], cwd=dest) + # Then reset to wanted revision (maybe even origin/master) + rev_options = self.resolve_revision(dest, url, rev_options) + cmd_args = make_command("reset", "--hard", "-q", rev_options.to_args()) + self.run_command(cmd_args, cwd=dest) + #: update submodules + self.update_submodules(dest) + + @classmethod + def get_remote_url(cls, location: str) -> str: + """ + Return URL of the first remote encountered. + + Raises RemoteNotFoundError if the repository does not have a remote + url configured. + """ + # We need to pass 1 for extra_ok_returncodes since the command + # exits with return code 1 if there are no matching lines. + stdout = cls.run_command( + ["config", "--get-regexp", r"remote\..*\.url"], + extra_ok_returncodes=(1,), + show_stdout=False, + stdout_only=True, + cwd=location, + ) + remotes = stdout.splitlines() + try: + found_remote = remotes[0] + except IndexError: + raise RemoteNotFoundError + + for remote in remotes: + if remote.startswith("remote.origin.url "): + found_remote = remote + break + url = found_remote.split(" ")[1] + return cls._git_remote_to_pip_url(url.strip()) + + @staticmethod + def _git_remote_to_pip_url(url: str) -> str: + """ + Convert a remote url from what git uses to what pip accepts. + + There are 3 legal forms **url** may take: + + 1. A fully qualified url: ssh://git@example.com/foo/bar.git + 2. A local project.git folder: /path/to/bare/repository.git + 3. SCP shorthand for form 1: git@example.com:foo/bar.git + + Form 1 is output as-is. Form 2 must be converted to URI and form 3 must + be converted to form 1. + + See the corresponding test test_git_remote_url_to_pip() for examples of + sample inputs/outputs. + """ + if re.match(r"\w+://", url): + # This is already valid. Pass it though as-is. + return url + if os.path.exists(url): + # A local bare remote (git clone --mirror). + # Needs a file:// prefix. + return pathlib.PurePath(url).as_uri() + scp_match = SCP_REGEX.match(url) + if scp_match: + # Add an ssh:// prefix and replace the ':' with a '/'. + return scp_match.expand(r"ssh://\1\2/\3") + # Otherwise, bail out. + raise RemoteNotValidError(url) + + @classmethod + def has_commit(cls, location: str, rev: str) -> bool: + """ + Check if rev is a commit that is available in the local repository. + """ + try: + cls.run_command( + ["rev-parse", "-q", "--verify", "sha^" + rev], + cwd=location, + log_failed_cmd=False, + ) + except InstallationError: + return False + else: + return True + + @classmethod + def get_revision(cls, location: str, rev: Optional[str] = None) -> str: + if rev is None: + rev = "HEAD" + current_rev = cls.run_command( + ["rev-parse", rev], + show_stdout=False, + stdout_only=True, + cwd=location, + ) + return current_rev.strip() + + @classmethod + def get_subdirectory(cls, location: str) -> Optional[str]: + """ + Return the path to Python project root, relative to the repo root. + Return None if the project root is in the repo root. + """ + # find the repo root + git_dir = cls.run_command( + ["rev-parse", "--git-dir"], + show_stdout=False, + stdout_only=True, + cwd=location, + ).strip() + if not os.path.isabs(git_dir): + git_dir = os.path.join(location, git_dir) + repo_root = os.path.abspath(os.path.join(git_dir, "..")) + return find_path_to_project_root_from_repo_root(location, repo_root) + + @classmethod + def get_url_rev_and_auth(cls, url: str) -> Tuple[str, Optional[str], AuthInfo]: + """ + Prefixes stub URLs like 'user@hostname:user/repo.git' with 'ssh://'. + That's required because although they use SSH they sometimes don't + work with a ssh:// scheme (e.g. GitHub). But we need a scheme for + parsing. Hence we remove it again afterwards and return it as a stub. + """ + # Works around an apparent Git bug + # (see https://article.gmane.org/gmane.comp.version-control.git/146500) + scheme, netloc, path, query, fragment = urlsplit(url) + if scheme.endswith("file"): + initial_slashes = path[: -len(path.lstrip("/"))] + newpath = initial_slashes + urllib.request.url2pathname(path).replace( + "\\", "/" + ).lstrip("/") + after_plus = scheme.find("+") + 1 + url = scheme[:after_plus] + urlunsplit( + (scheme[after_plus:], netloc, newpath, query, fragment), + ) + + if "://" not in url: + assert "file:" not in url + url = url.replace("git+", "git+ssh://") + url, rev, user_pass = super().get_url_rev_and_auth(url) + url = url.replace("ssh://", "") + else: + url, rev, user_pass = super().get_url_rev_and_auth(url) + + return url, rev, user_pass + + @classmethod + def update_submodules(cls, location: str) -> None: + if not os.path.exists(os.path.join(location, ".gitmodules")): + return + cls.run_command( + ["submodule", "update", "--init", "--recursive", "-q"], + cwd=location, + ) + + @classmethod + def get_repository_root(cls, location: str) -> Optional[str]: + loc = super().get_repository_root(location) + if loc: + return loc + try: + r = cls.run_command( + ["rev-parse", "--show-toplevel"], + cwd=location, + show_stdout=False, + stdout_only=True, + on_returncode="raise", + log_failed_cmd=False, + ) + except BadCommand: + logger.debug( + "could not determine if %s is under git control " + "because git is not available", + location, + ) + return None + except InstallationError: + return None + return os.path.normpath(r.rstrip("\r\n")) + + @staticmethod + def should_add_vcs_url_prefix(repo_url: str) -> bool: + """In either https or ssh form, requirements must be prefixed with git+.""" + return True + + +vcs.register(Git) diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/vcs/mercurial.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/vcs/mercurial.py new file mode 100644 index 0000000..c183d41 --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/vcs/mercurial.py @@ -0,0 +1,163 @@ +import configparser +import logging +import os +from typing import List, Optional, Tuple + +from pip._internal.exceptions import BadCommand, InstallationError +from pip._internal.utils.misc import HiddenText, display_path +from pip._internal.utils.subprocess import make_command +from pip._internal.utils.urls import path_to_url +from pip._internal.vcs.versioncontrol import ( + RevOptions, + VersionControl, + find_path_to_project_root_from_repo_root, + vcs, +) + +logger = logging.getLogger(__name__) + + +class Mercurial(VersionControl): + name = "hg" + dirname = ".hg" + repo_name = "clone" + schemes = ( + "hg+file", + "hg+http", + "hg+https", + "hg+ssh", + "hg+static-http", + ) + + @staticmethod + def get_base_rev_args(rev: str) -> List[str]: + return [f"--rev={rev}"] + + def fetch_new( + self, dest: str, url: HiddenText, rev_options: RevOptions, verbosity: int + ) -> None: + rev_display = rev_options.to_display() + logger.info( + "Cloning hg %s%s to %s", + url, + rev_display, + display_path(dest), + ) + if verbosity <= 0: + flags: Tuple[str, ...] = ("--quiet",) + elif verbosity == 1: + flags = () + elif verbosity == 2: + flags = ("--verbose",) + else: + flags = ("--verbose", "--debug") + self.run_command(make_command("clone", "--noupdate", *flags, url, dest)) + self.run_command( + make_command("update", *flags, rev_options.to_args()), + cwd=dest, + ) + + def switch(self, dest: str, url: HiddenText, rev_options: RevOptions) -> None: + repo_config = os.path.join(dest, self.dirname, "hgrc") + config = configparser.RawConfigParser() + try: + config.read(repo_config) + config.set("paths", "default", url.secret) + with open(repo_config, "w") as config_file: + config.write(config_file) + except (OSError, configparser.NoSectionError) as exc: + logger.warning("Could not switch Mercurial repository to %s: %s", url, exc) + else: + cmd_args = make_command("update", "-q", rev_options.to_args()) + self.run_command(cmd_args, cwd=dest) + + def update(self, dest: str, url: HiddenText, rev_options: RevOptions) -> None: + self.run_command(["pull", "-q"], cwd=dest) + cmd_args = make_command("update", "-q", rev_options.to_args()) + self.run_command(cmd_args, cwd=dest) + + @classmethod + def get_remote_url(cls, location: str) -> str: + url = cls.run_command( + ["showconfig", "paths.default"], + show_stdout=False, + stdout_only=True, + cwd=location, + ).strip() + if cls._is_local_repository(url): + url = path_to_url(url) + return url.strip() + + @classmethod + def get_revision(cls, location: str) -> str: + """ + Return the repository-local changeset revision number, as an integer. + """ + current_revision = cls.run_command( + ["parents", "--template={rev}"], + show_stdout=False, + stdout_only=True, + cwd=location, + ).strip() + return current_revision + + @classmethod + def get_requirement_revision(cls, location: str) -> str: + """ + Return the changeset identification hash, as a 40-character + hexadecimal string + """ + current_rev_hash = cls.run_command( + ["parents", "--template={node}"], + show_stdout=False, + stdout_only=True, + cwd=location, + ).strip() + return current_rev_hash + + @classmethod + def is_commit_id_equal(cls, dest: str, name: Optional[str]) -> bool: + """Always assume the versions don't match""" + return False + + @classmethod + def get_subdirectory(cls, location: str) -> Optional[str]: + """ + Return the path to Python project root, relative to the repo root. + Return None if the project root is in the repo root. + """ + # find the repo root + repo_root = cls.run_command( + ["root"], show_stdout=False, stdout_only=True, cwd=location + ).strip() + if not os.path.isabs(repo_root): + repo_root = os.path.abspath(os.path.join(location, repo_root)) + return find_path_to_project_root_from_repo_root(location, repo_root) + + @classmethod + def get_repository_root(cls, location: str) -> Optional[str]: + loc = super().get_repository_root(location) + if loc: + return loc + try: + r = cls.run_command( + ["root"], + cwd=location, + show_stdout=False, + stdout_only=True, + on_returncode="raise", + log_failed_cmd=False, + ) + except BadCommand: + logger.debug( + "could not determine if %s is under hg control " + "because hg is not available", + location, + ) + return None + except InstallationError: + return None + return os.path.normpath(r.rstrip("\r\n")) + + +vcs.register(Mercurial) diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/vcs/subversion.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/vcs/subversion.py new file mode 100644 index 0000000..f359266 --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/vcs/subversion.py @@ -0,0 +1,324 @@ +import logging +import os +import re +from typing import List, Optional, Tuple + +from pip._internal.utils.misc import ( + HiddenText, + display_path, + is_console_interactive, + is_installable_dir, + split_auth_from_netloc, +) +from pip._internal.utils.subprocess import CommandArgs, make_command +from pip._internal.vcs.versioncontrol import ( + AuthInfo, + RemoteNotFoundError, + RevOptions, + VersionControl, + vcs, +) + +logger = logging.getLogger(__name__) + +_svn_xml_url_re = re.compile('url="([^"]+)"') +_svn_rev_re = re.compile(r'committed-rev="(\d+)"') +_svn_info_xml_rev_re = re.compile(r'\s*revision="(\d+)"') +_svn_info_xml_url_re = re.compile(r"(.*)") + + +class Subversion(VersionControl): + name = "svn" + dirname = ".svn" + repo_name = "checkout" + schemes = ("svn+ssh", "svn+http", "svn+https", "svn+svn", "svn+file") + + @classmethod + def should_add_vcs_url_prefix(cls, remote_url: str) -> bool: + return True + + @staticmethod + def get_base_rev_args(rev: str) -> List[str]: + return ["-r", rev] + + @classmethod + def get_revision(cls, location: str) -> str: + """ + Return the maximum revision for all files under a given location + """ + # Note: taken from setuptools.command.egg_info + revision = 0 + + for base, dirs, _ in os.walk(location): + if cls.dirname not in dirs: + dirs[:] = [] + continue # no sense walking uncontrolled subdirs + dirs.remove(cls.dirname) + entries_fn = os.path.join(base, cls.dirname, "entries") + if not os.path.exists(entries_fn): + # FIXME: should we warn? + continue + + dirurl, localrev = cls._get_svn_url_rev(base) + + if base == location: + assert dirurl is not None + base = dirurl + "/" # save the root url + elif not dirurl or not dirurl.startswith(base): + dirs[:] = [] + continue # not part of the same svn tree, skip it + revision = max(revision, localrev) + return str(revision) + + @classmethod + def get_netloc_and_auth( + cls, netloc: str, scheme: str + ) -> Tuple[str, Tuple[Optional[str], Optional[str]]]: + """ + This override allows the auth information to be passed to svn via the + --username and --password options instead of via the URL. + """ + if scheme == "ssh": + # The --username and --password options can't be used for + # svn+ssh URLs, so keep the auth information in the URL. + return super().get_netloc_and_auth(netloc, scheme) + + return split_auth_from_netloc(netloc) + + @classmethod + def get_url_rev_and_auth(cls, url: str) -> Tuple[str, Optional[str], AuthInfo]: + # hotfix the URL scheme after removing svn+ from svn+ssh:// re-add it + url, rev, user_pass = super().get_url_rev_and_auth(url) + if url.startswith("ssh://"): + url = "svn+" + url + return url, rev, user_pass + + @staticmethod + def make_rev_args( + username: Optional[str], password: Optional[HiddenText] + ) -> CommandArgs: + extra_args: CommandArgs = [] + if username: + extra_args += ["--username", username] + if password: + extra_args += ["--password", password] + + return extra_args + + @classmethod + def get_remote_url(cls, location: str) -> str: + # In cases where the source is in a subdirectory, we have to look up in + # the location until we find a valid project root. + orig_location = location + while not is_installable_dir(location): + last_location = location + location = os.path.dirname(location) + if location == last_location: + # We've traversed up to the root of the filesystem without + # finding a Python project. + logger.warning( + "Could not find Python project for directory %s (tried all " + "parent directories)", + orig_location, + ) + raise RemoteNotFoundError + + url, _rev = cls._get_svn_url_rev(location) + if url is None: + raise RemoteNotFoundError + + return url + + @classmethod + def _get_svn_url_rev(cls, location: str) -> Tuple[Optional[str], int]: + from pip._internal.exceptions import InstallationError + + entries_path = os.path.join(location, cls.dirname, "entries") + if os.path.exists(entries_path): + with open(entries_path) as f: + data = f.read() + else: # subversion >= 1.7 does not have the 'entries' file + data = "" + + url = None + if data.startswith("8") or data.startswith("9") or data.startswith("10"): + entries = list(map(str.splitlines, data.split("\n\x0c\n"))) + del entries[0][0] # get rid of the '8' + url = entries[0][3] + revs = [int(d[9]) for d in entries if len(d) > 9 and d[9]] + [0] + elif data.startswith("= 1.7 + # Note that using get_remote_call_options is not necessary here + # because `svn info` is being run against a local directory. + # We don't need to worry about making sure interactive mode + # is being used to prompt for passwords, because passwords + # are only potentially needed for remote server requests. + xml = cls.run_command( + ["info", "--xml", location], + show_stdout=False, + stdout_only=True, + ) + match = _svn_info_xml_url_re.search(xml) + assert match is not None + url = match.group(1) + revs = [int(m.group(1)) for m in _svn_info_xml_rev_re.finditer(xml)] + except InstallationError: + url, revs = None, [] + + if revs: + rev = max(revs) + else: + rev = 0 + + return url, rev + + @classmethod + def is_commit_id_equal(cls, dest: str, name: Optional[str]) -> bool: + """Always assume the versions don't match""" + return False + + def __init__(self, use_interactive: Optional[bool] = None) -> None: + if use_interactive is None: + use_interactive = is_console_interactive() + self.use_interactive = use_interactive + + # This member is used to cache the fetched version of the current + # ``svn`` client. + # Special value definitions: + # None: Not evaluated yet. + # Empty tuple: Could not parse version. + self._vcs_version: Optional[Tuple[int, ...]] = None + + super().__init__() + + def call_vcs_version(self) -> Tuple[int, ...]: + """Query the version of the currently installed Subversion client. + + :return: A tuple containing the parts of the version information or + ``()`` if the version returned from ``svn`` could not be parsed. + :raises: BadCommand: If ``svn`` is not installed. + """ + # Example versions: + # svn, version 1.10.3 (r1842928) + # compiled Feb 25 2019, 14:20:39 on x86_64-apple-darwin17.0.0 + # svn, version 1.7.14 (r1542130) + # compiled Mar 28 2018, 08:49:13 on x86_64-pc-linux-gnu + # svn, version 1.12.0-SlikSvn (SlikSvn/1.12.0) + # compiled May 28 2019, 13:44:56 on x86_64-microsoft-windows6.2 + version_prefix = "svn, version " + version = self.run_command(["--version"], show_stdout=False, stdout_only=True) + if not version.startswith(version_prefix): + return () + + version = version[len(version_prefix) :].split()[0] + version_list = version.partition("-")[0].split(".") + try: + parsed_version = tuple(map(int, version_list)) + except ValueError: + return () + + return parsed_version + + def get_vcs_version(self) -> Tuple[int, ...]: + """Return the version of the currently installed Subversion client. + + If the version of the Subversion client has already been queried, + a cached value will be used. + + :return: A tuple containing the parts of the version information or + ``()`` if the version returned from ``svn`` could not be parsed. + :raises: BadCommand: If ``svn`` is not installed. + """ + if self._vcs_version is not None: + # Use cached version, if available. + # If parsing the version failed previously (empty tuple), + # do not attempt to parse it again. + return self._vcs_version + + vcs_version = self.call_vcs_version() + self._vcs_version = vcs_version + return vcs_version + + def get_remote_call_options(self) -> CommandArgs: + """Return options to be used on calls to Subversion that contact the server. + + These options are applicable for the following ``svn`` subcommands used + in this class. + + - checkout + - switch + - update + + :return: A list of command line arguments to pass to ``svn``. + """ + if not self.use_interactive: + # --non-interactive switch is available since Subversion 0.14.4. + # Subversion < 1.8 runs in interactive mode by default. + return ["--non-interactive"] + + svn_version = self.get_vcs_version() + # By default, Subversion >= 1.8 runs in non-interactive mode if + # stdin is not a TTY. Since that is how pip invokes SVN, in + # call_subprocess(), pip must pass --force-interactive to ensure + # the user can be prompted for a password, if required. + # SVN added the --force-interactive option in SVN 1.8. Since + # e.g. RHEL/CentOS 7, which is supported until 2024, ships with + # SVN 1.7, pip should continue to support SVN 1.7. Therefore, pip + # can't safely add the option if the SVN version is < 1.8 (or unknown). + if svn_version >= (1, 8): + return ["--force-interactive"] + + return [] + + def fetch_new( + self, dest: str, url: HiddenText, rev_options: RevOptions, verbosity: int + ) -> None: + rev_display = rev_options.to_display() + logger.info( + "Checking out %s%s to %s", + url, + rev_display, + display_path(dest), + ) + if verbosity <= 0: + flags = ["--quiet"] + else: + flags = [] + cmd_args = make_command( + "checkout", + *flags, + self.get_remote_call_options(), + rev_options.to_args(), + url, + dest, + ) + self.run_command(cmd_args) + + def switch(self, dest: str, url: HiddenText, rev_options: RevOptions) -> None: + cmd_args = make_command( + "switch", + self.get_remote_call_options(), + rev_options.to_args(), + url, + dest, + ) + self.run_command(cmd_args) + + def update(self, dest: str, url: HiddenText, rev_options: RevOptions) -> None: + cmd_args = make_command( + "update", + self.get_remote_call_options(), + rev_options.to_args(), + dest, + ) + self.run_command(cmd_args) + + +vcs.register(Subversion) diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/vcs/versioncontrol.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/vcs/versioncontrol.py new file mode 100644 index 0000000..a413316 --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/vcs/versioncontrol.py @@ -0,0 +1,688 @@ +"""Handles all VCS (version control) support""" + +import logging +import os +import shutil +import sys +import urllib.parse +from dataclasses import dataclass, field +from typing import ( + Any, + Dict, + Iterable, + Iterator, + List, + Literal, + Mapping, + Optional, + Tuple, + Type, + Union, +) + +from pip._internal.cli.spinners import SpinnerInterface +from pip._internal.exceptions import BadCommand, InstallationError +from pip._internal.utils.misc import ( + HiddenText, + ask_path_exists, + backup_dir, + display_path, + hide_url, + hide_value, + is_installable_dir, + rmtree, +) +from pip._internal.utils.subprocess import ( + CommandArgs, + call_subprocess, + format_command_args, + make_command, +) + +__all__ = ["vcs"] + + +logger = logging.getLogger(__name__) + +AuthInfo = Tuple[Optional[str], Optional[str]] + + +def is_url(name: str) -> bool: + """ + Return true if the name looks like a URL. + """ + scheme = urllib.parse.urlsplit(name).scheme + if not scheme: + return False + return scheme in ["http", "https", "file", "ftp"] + vcs.all_schemes + + +def make_vcs_requirement_url( + repo_url: str, rev: str, project_name: str, subdir: Optional[str] = None +) -> str: + """ + Return the URL for a VCS requirement. + + Args: + repo_url: the remote VCS url, with any needed VCS prefix (e.g. "git+"). + project_name: the (unescaped) project name. + """ + egg_project_name = project_name.replace("-", "_") + req = f"{repo_url}@{rev}#egg={egg_project_name}" + if subdir: + req += f"&subdirectory={subdir}" + + return req + + +def find_path_to_project_root_from_repo_root( + location: str, repo_root: str +) -> Optional[str]: + """ + Find the the Python project's root by searching up the filesystem from + `location`. Return the path to project root relative to `repo_root`. + Return None if the project root is `repo_root`, or cannot be found. + """ + # find project root. + orig_location = location + while not is_installable_dir(location): + last_location = location + location = os.path.dirname(location) + if location == last_location: + # We've traversed up to the root of the filesystem without + # finding a Python project. + logger.warning( + "Could not find a Python project for directory %s (tried all " + "parent directories)", + orig_location, + ) + return None + + if os.path.samefile(repo_root, location): + return None + + return os.path.relpath(location, repo_root) + + +class RemoteNotFoundError(Exception): + pass + + +class RemoteNotValidError(Exception): + def __init__(self, url: str): + super().__init__(url) + self.url = url + + +@dataclass(frozen=True) +class RevOptions: + """ + Encapsulates a VCS-specific revision to install, along with any VCS + install options. + + Args: + vc_class: a VersionControl subclass. + rev: the name of the revision to install. + extra_args: a list of extra options. + """ + + vc_class: Type["VersionControl"] + rev: Optional[str] = None + extra_args: CommandArgs = field(default_factory=list) + branch_name: Optional[str] = None + + def __repr__(self) -> str: + return f"" + + @property + def arg_rev(self) -> Optional[str]: + if self.rev is None: + return self.vc_class.default_arg_rev + + return self.rev + + def to_args(self) -> CommandArgs: + """ + Return the VCS-specific command arguments. + """ + args: CommandArgs = [] + rev = self.arg_rev + if rev is not None: + args += self.vc_class.get_base_rev_args(rev) + args += self.extra_args + + return args + + def to_display(self) -> str: + if not self.rev: + return "" + + return f" (to revision {self.rev})" + + def make_new(self, rev: str) -> "RevOptions": + """ + Make a copy of the current instance, but with a new rev. + + Args: + rev: the name of the revision for the new object. + """ + return self.vc_class.make_rev_options(rev, extra_args=self.extra_args) + + +class VcsSupport: + _registry: Dict[str, "VersionControl"] = {} + schemes = ["ssh", "git", "hg", "bzr", "sftp", "svn"] + + def __init__(self) -> None: + # Register more schemes with urlparse for various version control + # systems + urllib.parse.uses_netloc.extend(self.schemes) + super().__init__() + + def __iter__(self) -> Iterator[str]: + return self._registry.__iter__() + + @property + def backends(self) -> List["VersionControl"]: + return list(self._registry.values()) + + @property + def dirnames(self) -> List[str]: + return [backend.dirname for backend in self.backends] + + @property + def all_schemes(self) -> List[str]: + schemes: List[str] = [] + for backend in self.backends: + schemes.extend(backend.schemes) + return schemes + + def register(self, cls: Type["VersionControl"]) -> None: + if not hasattr(cls, "name"): + logger.warning("Cannot register VCS %s", cls.__name__) + return + if cls.name not in self._registry: + self._registry[cls.name] = cls() + logger.debug("Registered VCS backend: %s", cls.name) + + def unregister(self, name: str) -> None: + if name in self._registry: + del self._registry[name] + + def get_backend_for_dir(self, location: str) -> Optional["VersionControl"]: + """ + Return a VersionControl object if a repository of that type is found + at the given directory. + """ + vcs_backends = {} + for vcs_backend in self._registry.values(): + repo_path = vcs_backend.get_repository_root(location) + if not repo_path: + continue + logger.debug("Determine that %s uses VCS: %s", location, vcs_backend.name) + vcs_backends[repo_path] = vcs_backend + + if not vcs_backends: + return None + + # Choose the VCS in the inner-most directory. Since all repository + # roots found here would be either `location` or one of its + # parents, the longest path should have the most path components, + # i.e. the backend representing the inner-most repository. + inner_most_repo_path = max(vcs_backends, key=len) + return vcs_backends[inner_most_repo_path] + + def get_backend_for_scheme(self, scheme: str) -> Optional["VersionControl"]: + """ + Return a VersionControl object or None. + """ + for vcs_backend in self._registry.values(): + if scheme in vcs_backend.schemes: + return vcs_backend + return None + + def get_backend(self, name: str) -> Optional["VersionControl"]: + """ + Return a VersionControl object or None. + """ + name = name.lower() + return self._registry.get(name) + + +vcs = VcsSupport() + + +class VersionControl: + name = "" + dirname = "" + repo_name = "" + # List of supported schemes for this Version Control + schemes: Tuple[str, ...] = () + # Iterable of environment variable names to pass to call_subprocess(). + unset_environ: Tuple[str, ...] = () + default_arg_rev: Optional[str] = None + + @classmethod + def should_add_vcs_url_prefix(cls, remote_url: str) -> bool: + """ + Return whether the vcs prefix (e.g. "git+") should be added to a + repository's remote url when used in a requirement. + """ + return not remote_url.lower().startswith(f"{cls.name}:") + + @classmethod + def get_subdirectory(cls, location: str) -> Optional[str]: + """ + Return the path to Python project root, relative to the repo root. + Return None if the project root is in the repo root. + """ + return None + + @classmethod + def get_requirement_revision(cls, repo_dir: str) -> str: + """ + Return the revision string that should be used in a requirement. + """ + return cls.get_revision(repo_dir) + + @classmethod + def get_src_requirement(cls, repo_dir: str, project_name: str) -> str: + """ + Return the requirement string to use to redownload the files + currently at the given repository directory. + + Args: + project_name: the (unescaped) project name. + + The return value has a form similar to the following: + + {repository_url}@{revision}#egg={project_name} + """ + repo_url = cls.get_remote_url(repo_dir) + + if cls.should_add_vcs_url_prefix(repo_url): + repo_url = f"{cls.name}+{repo_url}" + + revision = cls.get_requirement_revision(repo_dir) + subdir = cls.get_subdirectory(repo_dir) + req = make_vcs_requirement_url(repo_url, revision, project_name, subdir=subdir) + + return req + + @staticmethod + def get_base_rev_args(rev: str) -> List[str]: + """ + Return the base revision arguments for a vcs command. + + Args: + rev: the name of a revision to install. Cannot be None. + """ + raise NotImplementedError + + def is_immutable_rev_checkout(self, url: str, dest: str) -> bool: + """ + Return true if the commit hash checked out at dest matches + the revision in url. + + Always return False, if the VCS does not support immutable commit + hashes. + + This method does not check if there are local uncommitted changes + in dest after checkout, as pip currently has no use case for that. + """ + return False + + @classmethod + def make_rev_options( + cls, rev: Optional[str] = None, extra_args: Optional[CommandArgs] = None + ) -> RevOptions: + """ + Return a RevOptions object. + + Args: + rev: the name of a revision to install. + extra_args: a list of extra options. + """ + return RevOptions(cls, rev, extra_args=extra_args or []) + + @classmethod + def _is_local_repository(cls, repo: str) -> bool: + """ + posix absolute paths start with os.path.sep, + win32 ones start with drive (like c:\\folder) + """ + drive, tail = os.path.splitdrive(repo) + return repo.startswith(os.path.sep) or bool(drive) + + @classmethod + def get_netloc_and_auth( + cls, netloc: str, scheme: str + ) -> Tuple[str, Tuple[Optional[str], Optional[str]]]: + """ + Parse the repository URL's netloc, and return the new netloc to use + along with auth information. + + Args: + netloc: the original repository URL netloc. + scheme: the repository URL's scheme without the vcs prefix. + + This is mainly for the Subversion class to override, so that auth + information can be provided via the --username and --password options + instead of through the URL. For other subclasses like Git without + such an option, auth information must stay in the URL. + + Returns: (netloc, (username, password)). + """ + return netloc, (None, None) + + @classmethod + def get_url_rev_and_auth(cls, url: str) -> Tuple[str, Optional[str], AuthInfo]: + """ + Parse the repository URL to use, and return the URL, revision, + and auth info to use. + + Returns: (url, rev, (username, password)). + """ + scheme, netloc, path, query, frag = urllib.parse.urlsplit(url) + if "+" not in scheme: + raise ValueError( + f"Sorry, {url!r} is a malformed VCS url. " + "The format is +://, " + "e.g. svn+http://myrepo/svn/MyApp#egg=MyApp" + ) + # Remove the vcs prefix. + scheme = scheme.split("+", 1)[1] + netloc, user_pass = cls.get_netloc_and_auth(netloc, scheme) + rev = None + if "@" in path: + path, rev = path.rsplit("@", 1) + if not rev: + raise InstallationError( + f"The URL {url!r} has an empty revision (after @) " + "which is not supported. Include a revision after @ " + "or remove @ from the URL." + ) + url = urllib.parse.urlunsplit((scheme, netloc, path, query, "")) + return url, rev, user_pass + + @staticmethod + def make_rev_args( + username: Optional[str], password: Optional[HiddenText] + ) -> CommandArgs: + """ + Return the RevOptions "extra arguments" to use in obtain(). + """ + return [] + + def get_url_rev_options(self, url: HiddenText) -> Tuple[HiddenText, RevOptions]: + """ + Return the URL and RevOptions object to use in obtain(), + as a tuple (url, rev_options). + """ + secret_url, rev, user_pass = self.get_url_rev_and_auth(url.secret) + username, secret_password = user_pass + password: Optional[HiddenText] = None + if secret_password is not None: + password = hide_value(secret_password) + extra_args = self.make_rev_args(username, password) + rev_options = self.make_rev_options(rev, extra_args=extra_args) + + return hide_url(secret_url), rev_options + + @staticmethod + def normalize_url(url: str) -> str: + """ + Normalize a URL for comparison by unquoting it and removing any + trailing slash. + """ + return urllib.parse.unquote(url).rstrip("/") + + @classmethod + def compare_urls(cls, url1: str, url2: str) -> bool: + """ + Compare two repo URLs for identity, ignoring incidental differences. + """ + return cls.normalize_url(url1) == cls.normalize_url(url2) + + def fetch_new( + self, dest: str, url: HiddenText, rev_options: RevOptions, verbosity: int + ) -> None: + """ + Fetch a revision from a repository, in the case that this is the + first fetch from the repository. + + Args: + dest: the directory to fetch the repository to. + rev_options: a RevOptions object. + verbosity: verbosity level. + """ + raise NotImplementedError + + def switch(self, dest: str, url: HiddenText, rev_options: RevOptions) -> None: + """ + Switch the repo at ``dest`` to point to ``URL``. + + Args: + rev_options: a RevOptions object. + """ + raise NotImplementedError + + def update(self, dest: str, url: HiddenText, rev_options: RevOptions) -> None: + """ + Update an already-existing repo to the given ``rev_options``. + + Args: + rev_options: a RevOptions object. + """ + raise NotImplementedError + + @classmethod + def is_commit_id_equal(cls, dest: str, name: Optional[str]) -> bool: + """ + Return whether the id of the current commit equals the given name. + + Args: + dest: the repository directory. + name: a string name. + """ + raise NotImplementedError + + def obtain(self, dest: str, url: HiddenText, verbosity: int) -> None: + """ + Install or update in editable mode the package represented by this + VersionControl object. + + :param dest: the repository directory in which to install or update. + :param url: the repository URL starting with a vcs prefix. + :param verbosity: verbosity level. + """ + url, rev_options = self.get_url_rev_options(url) + + if not os.path.exists(dest): + self.fetch_new(dest, url, rev_options, verbosity=verbosity) + return + + rev_display = rev_options.to_display() + if self.is_repository_directory(dest): + existing_url = self.get_remote_url(dest) + if self.compare_urls(existing_url, url.secret): + logger.debug( + "%s in %s exists, and has correct URL (%s)", + self.repo_name.title(), + display_path(dest), + url, + ) + if not self.is_commit_id_equal(dest, rev_options.rev): + logger.info( + "Updating %s %s%s", + display_path(dest), + self.repo_name, + rev_display, + ) + self.update(dest, url, rev_options) + else: + logger.info("Skipping because already up-to-date.") + return + + logger.warning( + "%s %s in %s exists with URL %s", + self.name, + self.repo_name, + display_path(dest), + existing_url, + ) + prompt = ("(s)witch, (i)gnore, (w)ipe, (b)ackup ", ("s", "i", "w", "b")) + else: + logger.warning( + "Directory %s already exists, and is not a %s %s.", + dest, + self.name, + self.repo_name, + ) + # https://github.com/python/mypy/issues/1174 + prompt = ("(i)gnore, (w)ipe, (b)ackup ", ("i", "w", "b")) # type: ignore + + logger.warning( + "The plan is to install the %s repository %s", + self.name, + url, + ) + response = ask_path_exists(f"What to do? {prompt[0]}", prompt[1]) + + if response == "a": + sys.exit(-1) + + if response == "w": + logger.warning("Deleting %s", display_path(dest)) + rmtree(dest) + self.fetch_new(dest, url, rev_options, verbosity=verbosity) + return + + if response == "b": + dest_dir = backup_dir(dest) + logger.warning("Backing up %s to %s", display_path(dest), dest_dir) + shutil.move(dest, dest_dir) + self.fetch_new(dest, url, rev_options, verbosity=verbosity) + return + + # Do nothing if the response is "i". + if response == "s": + logger.info( + "Switching %s %s to %s%s", + self.repo_name, + display_path(dest), + url, + rev_display, + ) + self.switch(dest, url, rev_options) + + def unpack(self, location: str, url: HiddenText, verbosity: int) -> None: + """ + Clean up current location and download the url repository + (and vcs infos) into location + + :param url: the repository URL starting with a vcs prefix. + :param verbosity: verbosity level. + """ + if os.path.exists(location): + rmtree(location) + self.obtain(location, url=url, verbosity=verbosity) + + @classmethod + def get_remote_url(cls, location: str) -> str: + """ + Return the url used at location + + Raises RemoteNotFoundError if the repository does not have a remote + url configured. + """ + raise NotImplementedError + + @classmethod + def get_revision(cls, location: str) -> str: + """ + Return the current commit id of the files at the given location. + """ + raise NotImplementedError + + @classmethod + def run_command( + cls, + cmd: Union[List[str], CommandArgs], + show_stdout: bool = True, + cwd: Optional[str] = None, + on_returncode: 'Literal["raise", "warn", "ignore"]' = "raise", + extra_ok_returncodes: Optional[Iterable[int]] = None, + command_desc: Optional[str] = None, + extra_environ: Optional[Mapping[str, Any]] = None, + spinner: Optional[SpinnerInterface] = None, + log_failed_cmd: bool = True, + stdout_only: bool = False, + ) -> str: + """ + Run a VCS subcommand + This is simply a wrapper around call_subprocess that adds the VCS + command name, and checks that the VCS is available + """ + cmd = make_command(cls.name, *cmd) + if command_desc is None: + command_desc = format_command_args(cmd) + try: + return call_subprocess( + cmd, + show_stdout, + cwd, + on_returncode=on_returncode, + extra_ok_returncodes=extra_ok_returncodes, + command_desc=command_desc, + extra_environ=extra_environ, + unset_environ=cls.unset_environ, + spinner=spinner, + log_failed_cmd=log_failed_cmd, + stdout_only=stdout_only, + ) + except NotADirectoryError: + raise BadCommand(f"Cannot find command {cls.name!r} - invalid PATH") + except FileNotFoundError: + # errno.ENOENT = no such file or directory + # In other words, the VCS executable isn't available + raise BadCommand( + f"Cannot find command {cls.name!r} - do you have " + f"{cls.name!r} installed and in your PATH?" + ) + except PermissionError: + # errno.EACCES = Permission denied + # This error occurs, for instance, when the command is installed + # only for another user. So, the current user don't have + # permission to call the other user command. + raise BadCommand( + f"No permission to execute {cls.name!r} - install it " + f"locally, globally (ask admin), or check your PATH. " + f"See possible solutions at " + f"https://pip.pypa.io/en/latest/reference/pip_freeze/" + f"#fixing-permission-denied." + ) + + @classmethod + def is_repository_directory(cls, path: str) -> bool: + """ + Return whether a directory path is a repository directory. + """ + logger.debug("Checking in %s for %s (%s)...", path, cls.dirname, cls.name) + return os.path.exists(os.path.join(path, cls.dirname)) + + @classmethod + def get_repository_root(cls, location: str) -> Optional[str]: + """ + Return the "root" (top-level) directory controlled by the vcs, + or `None` if the directory is not in any. + + It is meant to be overridden to implement smarter detection + mechanisms for specific vcs. + + This can do more than is_repository_directory() alone. For + example, the Git override checks that Git is actually available. + """ + if cls.is_repository_directory(location): + return location + return None diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/wheel_builder.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/wheel_builder.py new file mode 100644 index 0000000..93f8e1f --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_internal/wheel_builder.py @@ -0,0 +1,354 @@ +"""Orchestrator for building wheels from InstallRequirements. +""" + +import logging +import os.path +import re +import shutil +from typing import Iterable, List, Optional, Tuple + +from pip._vendor.packaging.utils import canonicalize_name, canonicalize_version +from pip._vendor.packaging.version import InvalidVersion, Version + +from pip._internal.cache import WheelCache +from pip._internal.exceptions import InvalidWheelFilename, UnsupportedWheel +from pip._internal.metadata import FilesystemWheel, get_wheel_distribution +from pip._internal.models.link import Link +from pip._internal.models.wheel import Wheel +from pip._internal.operations.build.wheel import build_wheel_pep517 +from pip._internal.operations.build.wheel_editable import build_wheel_editable +from pip._internal.operations.build.wheel_legacy import build_wheel_legacy +from pip._internal.req.req_install import InstallRequirement +from pip._internal.utils.logging import indent_log +from pip._internal.utils.misc import ensure_dir, hash_file +from pip._internal.utils.setuptools_build import make_setuptools_clean_args +from pip._internal.utils.subprocess import call_subprocess +from pip._internal.utils.temp_dir import TempDirectory +from pip._internal.utils.urls import path_to_url +from pip._internal.vcs import vcs + +logger = logging.getLogger(__name__) + +_egg_info_re = re.compile(r"([a-z0-9_.]+)-([a-z0-9_.!+-]+)", re.IGNORECASE) + +BuildResult = Tuple[List[InstallRequirement], List[InstallRequirement]] + + +def _contains_egg_info(s: str) -> bool: + """Determine whether the string looks like an egg_info. + + :param s: The string to parse. E.g. foo-2.1 + """ + return bool(_egg_info_re.search(s)) + + +def _should_build( + req: InstallRequirement, + need_wheel: bool, +) -> bool: + """Return whether an InstallRequirement should be built into a wheel.""" + if req.constraint: + # never build requirements that are merely constraints + return False + if req.is_wheel: + if need_wheel: + logger.info( + "Skipping %s, due to already being wheel.", + req.name, + ) + return False + + if need_wheel: + # i.e. pip wheel, not pip install + return True + + # From this point, this concerns the pip install command only + # (need_wheel=False). + + if not req.source_dir: + return False + + if req.editable: + # we only build PEP 660 editable requirements + return req.supports_pyproject_editable + + return True + + +def should_build_for_wheel_command( + req: InstallRequirement, +) -> bool: + return _should_build(req, need_wheel=True) + + +def should_build_for_install_command( + req: InstallRequirement, +) -> bool: + return _should_build(req, need_wheel=False) + + +def _should_cache( + req: InstallRequirement, +) -> Optional[bool]: + """ + Return whether a built InstallRequirement can be stored in the persistent + wheel cache, assuming the wheel cache is available, and _should_build() + has determined a wheel needs to be built. + """ + if req.editable or not req.source_dir: + # never cache editable requirements + return False + + if req.link and req.link.is_vcs: + # VCS checkout. Do not cache + # unless it points to an immutable commit hash. + assert not req.editable + assert req.source_dir + vcs_backend = vcs.get_backend_for_scheme(req.link.scheme) + assert vcs_backend + if vcs_backend.is_immutable_rev_checkout(req.link.url, req.source_dir): + return True + return False + + assert req.link + base, ext = req.link.splitext() + if _contains_egg_info(base): + return True + + # Otherwise, do not cache. + return False + + +def _get_cache_dir( + req: InstallRequirement, + wheel_cache: WheelCache, +) -> str: + """Return the persistent or temporary cache directory where the built + wheel need to be stored. + """ + cache_available = bool(wheel_cache.cache_dir) + assert req.link + if cache_available and _should_cache(req): + cache_dir = wheel_cache.get_path_for_link(req.link) + else: + cache_dir = wheel_cache.get_ephem_path_for_link(req.link) + return cache_dir + + +def _verify_one(req: InstallRequirement, wheel_path: str) -> None: + canonical_name = canonicalize_name(req.name or "") + w = Wheel(os.path.basename(wheel_path)) + if canonicalize_name(w.name) != canonical_name: + raise InvalidWheelFilename( + f"Wheel has unexpected file name: expected {canonical_name!r}, " + f"got {w.name!r}", + ) + dist = get_wheel_distribution(FilesystemWheel(wheel_path), canonical_name) + dist_verstr = str(dist.version) + if canonicalize_version(dist_verstr) != canonicalize_version(w.version): + raise InvalidWheelFilename( + f"Wheel has unexpected file name: expected {dist_verstr!r}, " + f"got {w.version!r}", + ) + metadata_version_value = dist.metadata_version + if metadata_version_value is None: + raise UnsupportedWheel("Missing Metadata-Version") + try: + metadata_version = Version(metadata_version_value) + except InvalidVersion: + msg = f"Invalid Metadata-Version: {metadata_version_value}" + raise UnsupportedWheel(msg) + if metadata_version >= Version("1.2") and not isinstance(dist.version, Version): + raise UnsupportedWheel( + f"Metadata 1.2 mandates PEP 440 version, but {dist_verstr!r} is not" + ) + + +def _build_one( + req: InstallRequirement, + output_dir: str, + verify: bool, + build_options: List[str], + global_options: List[str], + editable: bool, +) -> Optional[str]: + """Build one wheel. + + :return: The filename of the built wheel, or None if the build failed. + """ + artifact = "editable" if editable else "wheel" + try: + ensure_dir(output_dir) + except OSError as e: + logger.warning( + "Building %s for %s failed: %s", + artifact, + req.name, + e, + ) + return None + + # Install build deps into temporary directory (PEP 518) + with req.build_env: + wheel_path = _build_one_inside_env( + req, output_dir, build_options, global_options, editable + ) + if wheel_path and verify: + try: + _verify_one(req, wheel_path) + except (InvalidWheelFilename, UnsupportedWheel) as e: + logger.warning("Built %s for %s is invalid: %s", artifact, req.name, e) + return None + return wheel_path + + +def _build_one_inside_env( + req: InstallRequirement, + output_dir: str, + build_options: List[str], + global_options: List[str], + editable: bool, +) -> Optional[str]: + with TempDirectory(kind="wheel") as temp_dir: + assert req.name + if req.use_pep517: + assert req.metadata_directory + assert req.pep517_backend + if global_options: + logger.warning( + "Ignoring --global-option when building %s using PEP 517", req.name + ) + if build_options: + logger.warning( + "Ignoring --build-option when building %s using PEP 517", req.name + ) + if editable: + wheel_path = build_wheel_editable( + name=req.name, + backend=req.pep517_backend, + metadata_directory=req.metadata_directory, + tempd=temp_dir.path, + ) + else: + wheel_path = build_wheel_pep517( + name=req.name, + backend=req.pep517_backend, + metadata_directory=req.metadata_directory, + tempd=temp_dir.path, + ) + else: + wheel_path = build_wheel_legacy( + name=req.name, + setup_py_path=req.setup_py_path, + source_dir=req.unpacked_source_directory, + global_options=global_options, + build_options=build_options, + tempd=temp_dir.path, + ) + + if wheel_path is not None: + wheel_name = os.path.basename(wheel_path) + dest_path = os.path.join(output_dir, wheel_name) + try: + wheel_hash, length = hash_file(wheel_path) + shutil.move(wheel_path, dest_path) + logger.info( + "Created wheel for %s: filename=%s size=%d sha256=%s", + req.name, + wheel_name, + length, + wheel_hash.hexdigest(), + ) + logger.info("Stored in directory: %s", output_dir) + return dest_path + except Exception as e: + logger.warning( + "Building wheel for %s failed: %s", + req.name, + e, + ) + # Ignore return, we can't do anything else useful. + if not req.use_pep517: + _clean_one_legacy(req, global_options) + return None + + +def _clean_one_legacy(req: InstallRequirement, global_options: List[str]) -> bool: + clean_args = make_setuptools_clean_args( + req.setup_py_path, + global_options=global_options, + ) + + logger.info("Running setup.py clean for %s", req.name) + try: + call_subprocess( + clean_args, command_desc="python setup.py clean", cwd=req.source_dir + ) + return True + except Exception: + logger.error("Failed cleaning build dir for %s", req.name) + return False + + +def build( + requirements: Iterable[InstallRequirement], + wheel_cache: WheelCache, + verify: bool, + build_options: List[str], + global_options: List[str], +) -> BuildResult: + """Build wheels. + + :return: The list of InstallRequirement that succeeded to build and + the list of InstallRequirement that failed to build. + """ + if not requirements: + return [], [] + + # Build the wheels. + logger.info( + "Building wheels for collected packages: %s", + ", ".join(req.name for req in requirements), # type: ignore + ) + + with indent_log(): + build_successes, build_failures = [], [] + for req in requirements: + assert req.name + cache_dir = _get_cache_dir(req, wheel_cache) + wheel_file = _build_one( + req, + cache_dir, + verify, + build_options, + global_options, + req.editable and req.permit_editable_wheels, + ) + if wheel_file: + # Record the download origin in the cache + if req.download_info is not None: + # download_info is guaranteed to be set because when we build an + # InstallRequirement it has been through the preparer before, but + # let's be cautious. + wheel_cache.record_download_origin(cache_dir, req.download_info) + # Update the link for this. + req.link = Link(path_to_url(wheel_file)) + req.local_file_path = req.link.file_path + assert req.link.is_wheel + build_successes.append(req) + else: + build_failures.append(req) + + # notify success/failure + if build_successes: + logger.info( + "Successfully built %s", + " ".join([req.name for req in build_successes]), # type: ignore + ) + if build_failures: + logger.info( + "Failed to build %s", + " ".join([req.name for req in build_failures]), # type: ignore + ) + # Return a list of requirements that failed to build + return build_successes, build_failures diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/__init__.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/__init__.py new file mode 100644 index 0000000..561089c --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/__init__.py @@ -0,0 +1,116 @@ +""" +pip._vendor is for vendoring dependencies of pip to prevent needing pip to +depend on something external. + +Files inside of pip._vendor should be considered immutable and should only be +updated to versions from upstream. +""" +from __future__ import absolute_import + +import glob +import os.path +import sys + +# Downstream redistributors which have debundled our dependencies should also +# patch this value to be true. This will trigger the additional patching +# to cause things like "six" to be available as pip. +DEBUNDLED = False + +# By default, look in this directory for a bunch of .whl files which we will +# add to the beginning of sys.path before attempting to import anything. This +# is done to support downstream re-distributors like Debian and Fedora who +# wish to create their own Wheels for our dependencies to aid in debundling. +WHEEL_DIR = os.path.abspath(os.path.dirname(__file__)) + + +# Define a small helper function to alias our vendored modules to the real ones +# if the vendored ones do not exist. This idea of this was taken from +# https://github.com/kennethreitz/requests/pull/2567. +def vendored(modulename): + vendored_name = "{0}.{1}".format(__name__, modulename) + + try: + __import__(modulename, globals(), locals(), level=0) + except ImportError: + # We can just silently allow import failures to pass here. If we + # got to this point it means that ``import pip._vendor.whatever`` + # failed and so did ``import whatever``. Since we're importing this + # upfront in an attempt to alias imports, not erroring here will + # just mean we get a regular import error whenever pip *actually* + # tries to import one of these modules to use it, which actually + # gives us a better error message than we would have otherwise + # gotten. + pass + else: + sys.modules[vendored_name] = sys.modules[modulename] + base, head = vendored_name.rsplit(".", 1) + setattr(sys.modules[base], head, sys.modules[modulename]) + + +# If we're operating in a debundled setup, then we want to go ahead and trigger +# the aliasing of our vendored libraries as well as looking for wheels to add +# to our sys.path. This will cause all of this code to be a no-op typically +# however downstream redistributors can enable it in a consistent way across +# all platforms. +if DEBUNDLED: + # Actually look inside of WHEEL_DIR to find .whl files and add them to the + # front of our sys.path. + sys.path[:] = glob.glob(os.path.join(WHEEL_DIR, "*.whl")) + sys.path + + # Actually alias all of our vendored dependencies. + vendored("cachecontrol") + vendored("certifi") + vendored("distlib") + vendored("distro") + vendored("packaging") + vendored("packaging.version") + vendored("packaging.specifiers") + vendored("pkg_resources") + vendored("platformdirs") + vendored("progress") + vendored("pyproject_hooks") + vendored("requests") + vendored("requests.exceptions") + vendored("requests.packages") + vendored("requests.packages.urllib3") + vendored("requests.packages.urllib3._collections") + vendored("requests.packages.urllib3.connection") + vendored("requests.packages.urllib3.connectionpool") + vendored("requests.packages.urllib3.contrib") + vendored("requests.packages.urllib3.contrib.ntlmpool") + vendored("requests.packages.urllib3.contrib.pyopenssl") + vendored("requests.packages.urllib3.exceptions") + vendored("requests.packages.urllib3.fields") + vendored("requests.packages.urllib3.filepost") + vendored("requests.packages.urllib3.packages") + vendored("requests.packages.urllib3.packages.ordered_dict") + vendored("requests.packages.urllib3.packages.six") + vendored("requests.packages.urllib3.packages.ssl_match_hostname") + vendored("requests.packages.urllib3.packages.ssl_match_hostname." + "_implementation") + vendored("requests.packages.urllib3.poolmanager") + vendored("requests.packages.urllib3.request") + vendored("requests.packages.urllib3.response") + vendored("requests.packages.urllib3.util") + vendored("requests.packages.urllib3.util.connection") + vendored("requests.packages.urllib3.util.request") + vendored("requests.packages.urllib3.util.response") + vendored("requests.packages.urllib3.util.retry") + vendored("requests.packages.urllib3.util.ssl_") + vendored("requests.packages.urllib3.util.timeout") + vendored("requests.packages.urllib3.util.url") + vendored("resolvelib") + vendored("rich") + vendored("rich.console") + vendored("rich.highlighter") + vendored("rich.logging") + vendored("rich.markup") + vendored("rich.progress") + vendored("rich.segment") + vendored("rich.style") + vendored("rich.text") + vendored("rich.traceback") + if sys.version_info < (3, 11): + vendored("tomli") + vendored("truststore") + vendored("urllib3") diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/__pycache__/__init__.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000..3e0ac24 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/__pycache__/__init__.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/__pycache__/typing_extensions.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/__pycache__/typing_extensions.cpython-312.pyc new file mode 100644 index 0000000..1e0c5b3 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/__pycache__/typing_extensions.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/__init__.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/__init__.py new file mode 100644 index 0000000..2191624 --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/__init__.py @@ -0,0 +1,29 @@ +# SPDX-FileCopyrightText: 2015 Eric Larson +# +# SPDX-License-Identifier: Apache-2.0 + +"""CacheControl import Interface. + +Make it easy to import from cachecontrol without long namespaces. +""" + +__author__ = "Eric Larson" +__email__ = "eric@ionrock.org" +__version__ = "0.14.1" + +from pip._vendor.cachecontrol.adapter import CacheControlAdapter +from pip._vendor.cachecontrol.controller import CacheController +from pip._vendor.cachecontrol.wrapper import CacheControl + +__all__ = [ + "__author__", + "__email__", + "__version__", + "CacheControlAdapter", + "CacheController", + "CacheControl", +] + +import logging + +logging.getLogger(__name__).addHandler(logging.NullHandler()) diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/__pycache__/__init__.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000..15725c1 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/__pycache__/__init__.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/__pycache__/_cmd.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/__pycache__/_cmd.cpython-312.pyc new file mode 100644 index 0000000..d48dbd5 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/__pycache__/_cmd.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/__pycache__/adapter.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/__pycache__/adapter.cpython-312.pyc new file mode 100644 index 0000000..dcb5b48 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/__pycache__/adapter.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/__pycache__/cache.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/__pycache__/cache.cpython-312.pyc new file mode 100644 index 0000000..acc0847 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/__pycache__/cache.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/__pycache__/controller.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/__pycache__/controller.cpython-312.pyc new file mode 100644 index 0000000..31dd83e Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/__pycache__/controller.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/__pycache__/filewrapper.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/__pycache__/filewrapper.cpython-312.pyc new file mode 100644 index 0000000..6249a53 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/__pycache__/filewrapper.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/__pycache__/heuristics.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/__pycache__/heuristics.cpython-312.pyc new file mode 100644 index 0000000..be0e4c3 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/__pycache__/heuristics.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/__pycache__/serialize.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/__pycache__/serialize.cpython-312.pyc new file mode 100644 index 0000000..08073bf Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/__pycache__/serialize.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/__pycache__/wrapper.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/__pycache__/wrapper.cpython-312.pyc new file mode 100644 index 0000000..6296971 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/__pycache__/wrapper.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/_cmd.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/_cmd.py new file mode 100644 index 0000000..2c84208 --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/_cmd.py @@ -0,0 +1,70 @@ +# SPDX-FileCopyrightText: 2015 Eric Larson +# +# SPDX-License-Identifier: Apache-2.0 +from __future__ import annotations + +import logging +from argparse import ArgumentParser +from typing import TYPE_CHECKING + +from pip._vendor import requests + +from pip._vendor.cachecontrol.adapter import CacheControlAdapter +from pip._vendor.cachecontrol.cache import DictCache +from pip._vendor.cachecontrol.controller import logger + +if TYPE_CHECKING: + from argparse import Namespace + + from pip._vendor.cachecontrol.controller import CacheController + + +def setup_logging() -> None: + logger.setLevel(logging.DEBUG) + handler = logging.StreamHandler() + logger.addHandler(handler) + + +def get_session() -> requests.Session: + adapter = CacheControlAdapter( + DictCache(), cache_etags=True, serializer=None, heuristic=None + ) + sess = requests.Session() + sess.mount("http://", adapter) + sess.mount("https://", adapter) + + sess.cache_controller = adapter.controller # type: ignore[attr-defined] + return sess + + +def get_args() -> Namespace: + parser = ArgumentParser() + parser.add_argument("url", help="The URL to try and cache") + return parser.parse_args() + + +def main() -> None: + args = get_args() + sess = get_session() + + # Make a request to get a response + resp = sess.get(args.url) + + # Turn on logging + setup_logging() + + # try setting the cache + cache_controller: CacheController = ( + sess.cache_controller # type: ignore[attr-defined] + ) + cache_controller.cache_response(resp.request, resp.raw) + + # Now try to get it + if cache_controller.cached_request(resp.request): + print("Cached!") + else: + print("Not cached :(") + + +if __name__ == "__main__": + main() diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/adapter.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/adapter.py new file mode 100644 index 0000000..34a9eb8 --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/adapter.py @@ -0,0 +1,161 @@ +# SPDX-FileCopyrightText: 2015 Eric Larson +# +# SPDX-License-Identifier: Apache-2.0 +from __future__ import annotations + +import functools +import types +import zlib +from typing import TYPE_CHECKING, Any, Collection, Mapping + +from pip._vendor.requests.adapters import HTTPAdapter + +from pip._vendor.cachecontrol.cache import DictCache +from pip._vendor.cachecontrol.controller import PERMANENT_REDIRECT_STATUSES, CacheController +from pip._vendor.cachecontrol.filewrapper import CallbackFileWrapper + +if TYPE_CHECKING: + from pip._vendor.requests import PreparedRequest, Response + from pip._vendor.urllib3 import HTTPResponse + + from pip._vendor.cachecontrol.cache import BaseCache + from pip._vendor.cachecontrol.heuristics import BaseHeuristic + from pip._vendor.cachecontrol.serialize import Serializer + + +class CacheControlAdapter(HTTPAdapter): + invalidating_methods = {"PUT", "PATCH", "DELETE"} + + def __init__( + self, + cache: BaseCache | None = None, + cache_etags: bool = True, + controller_class: type[CacheController] | None = None, + serializer: Serializer | None = None, + heuristic: BaseHeuristic | None = None, + cacheable_methods: Collection[str] | None = None, + *args: Any, + **kw: Any, + ) -> None: + super().__init__(*args, **kw) + self.cache = DictCache() if cache is None else cache + self.heuristic = heuristic + self.cacheable_methods = cacheable_methods or ("GET",) + + controller_factory = controller_class or CacheController + self.controller = controller_factory( + self.cache, cache_etags=cache_etags, serializer=serializer + ) + + def send( + self, + request: PreparedRequest, + stream: bool = False, + timeout: None | float | tuple[float, float] | tuple[float, None] = None, + verify: bool | str = True, + cert: (None | bytes | str | tuple[bytes | str, bytes | str]) = None, + proxies: Mapping[str, str] | None = None, + cacheable_methods: Collection[str] | None = None, + ) -> Response: + """ + Send a request. Use the request information to see if it + exists in the cache and cache the response if we need to and can. + """ + cacheable = cacheable_methods or self.cacheable_methods + if request.method in cacheable: + try: + cached_response = self.controller.cached_request(request) + except zlib.error: + cached_response = None + if cached_response: + return self.build_response(request, cached_response, from_cache=True) + + # check for etags and add headers if appropriate + request.headers.update(self.controller.conditional_headers(request)) + + resp = super().send(request, stream, timeout, verify, cert, proxies) + + return resp + + def build_response( # type: ignore[override] + self, + request: PreparedRequest, + response: HTTPResponse, + from_cache: bool = False, + cacheable_methods: Collection[str] | None = None, + ) -> Response: + """ + Build a response by making a request or using the cache. + + This will end up calling send and returning a potentially + cached response + """ + cacheable = cacheable_methods or self.cacheable_methods + if not from_cache and request.method in cacheable: + # Check for any heuristics that might update headers + # before trying to cache. + if self.heuristic: + response = self.heuristic.apply(response) + + # apply any expiration heuristics + if response.status == 304: + # We must have sent an ETag request. This could mean + # that we've been expired already or that we simply + # have an etag. In either case, we want to try and + # update the cache if that is the case. + cached_response = self.controller.update_cached_response( + request, response + ) + + if cached_response is not response: + from_cache = True + + # We are done with the server response, read a + # possible response body (compliant servers will + # not return one, but we cannot be 100% sure) and + # release the connection back to the pool. + response.read(decode_content=False) + response.release_conn() + + response = cached_response + + # We always cache the 301 responses + elif int(response.status) in PERMANENT_REDIRECT_STATUSES: + self.controller.cache_response(request, response) + else: + # Wrap the response file with a wrapper that will cache the + # response when the stream has been consumed. + response._fp = CallbackFileWrapper( # type: ignore[assignment] + response._fp, # type: ignore[arg-type] + functools.partial( + self.controller.cache_response, request, response + ), + ) + if response.chunked: + super_update_chunk_length = response._update_chunk_length + + def _update_chunk_length(self: HTTPResponse) -> None: + super_update_chunk_length() + if self.chunk_left == 0: + self._fp._close() # type: ignore[union-attr] + + response._update_chunk_length = types.MethodType( # type: ignore[method-assign] + _update_chunk_length, response + ) + + resp: Response = super().build_response(request, response) + + # See if we should invalidate the cache. + if request.method in self.invalidating_methods and resp.ok: + assert request.url is not None + cache_url = self.controller.cache_url(request.url) + self.cache.delete(cache_url) + + # Give the request a from_cache attr to let people use it + resp.from_cache = from_cache # type: ignore[attr-defined] + + return resp + + def close(self) -> None: + self.cache.close() + super().close() # type: ignore[no-untyped-call] diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/cache.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/cache.py new file mode 100644 index 0000000..91598e9 --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/cache.py @@ -0,0 +1,75 @@ +# SPDX-FileCopyrightText: 2015 Eric Larson +# +# SPDX-License-Identifier: Apache-2.0 + +""" +The cache object API for implementing caches. The default is a thread +safe in-memory dictionary. +""" + +from __future__ import annotations + +from threading import Lock +from typing import IO, TYPE_CHECKING, MutableMapping + +if TYPE_CHECKING: + from datetime import datetime + + +class BaseCache: + def get(self, key: str) -> bytes | None: + raise NotImplementedError() + + def set( + self, key: str, value: bytes, expires: int | datetime | None = None + ) -> None: + raise NotImplementedError() + + def delete(self, key: str) -> None: + raise NotImplementedError() + + def close(self) -> None: + pass + + +class DictCache(BaseCache): + def __init__(self, init_dict: MutableMapping[str, bytes] | None = None) -> None: + self.lock = Lock() + self.data = init_dict or {} + + def get(self, key: str) -> bytes | None: + return self.data.get(key, None) + + def set( + self, key: str, value: bytes, expires: int | datetime | None = None + ) -> None: + with self.lock: + self.data.update({key: value}) + + def delete(self, key: str) -> None: + with self.lock: + if key in self.data: + self.data.pop(key) + + +class SeparateBodyBaseCache(BaseCache): + """ + In this variant, the body is not stored mixed in with the metadata, but is + passed in (as a bytes-like object) in a separate call to ``set_body()``. + + That is, the expected interaction pattern is:: + + cache.set(key, serialized_metadata) + cache.set_body(key) + + Similarly, the body should be loaded separately via ``get_body()``. + """ + + def set_body(self, key: str, body: bytes) -> None: + raise NotImplementedError() + + def get_body(self, key: str) -> IO[bytes] | None: + """ + Return the body as file-like object. + """ + raise NotImplementedError() diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/caches/__init__.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/caches/__init__.py new file mode 100644 index 0000000..24ff469 --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/caches/__init__.py @@ -0,0 +1,8 @@ +# SPDX-FileCopyrightText: 2015 Eric Larson +# +# SPDX-License-Identifier: Apache-2.0 + +from pip._vendor.cachecontrol.caches.file_cache import FileCache, SeparateBodyFileCache +from pip._vendor.cachecontrol.caches.redis_cache import RedisCache + +__all__ = ["FileCache", "SeparateBodyFileCache", "RedisCache"] diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/caches/__pycache__/__init__.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/caches/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000..f649eab Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/caches/__pycache__/__init__.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/caches/__pycache__/file_cache.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/caches/__pycache__/file_cache.cpython-312.pyc new file mode 100644 index 0000000..d38ee46 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/caches/__pycache__/file_cache.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/caches/__pycache__/redis_cache.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/caches/__pycache__/redis_cache.cpython-312.pyc new file mode 100644 index 0000000..705bea6 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/caches/__pycache__/redis_cache.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/caches/file_cache.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/caches/file_cache.py new file mode 100644 index 0000000..81d2ef4 --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/caches/file_cache.py @@ -0,0 +1,182 @@ +# SPDX-FileCopyrightText: 2015 Eric Larson +# +# SPDX-License-Identifier: Apache-2.0 +from __future__ import annotations + +import hashlib +import os +from textwrap import dedent +from typing import IO, TYPE_CHECKING +from pathlib import Path + +from pip._vendor.cachecontrol.cache import BaseCache, SeparateBodyBaseCache +from pip._vendor.cachecontrol.controller import CacheController + +if TYPE_CHECKING: + from datetime import datetime + + from filelock import BaseFileLock + + +def _secure_open_write(filename: str, fmode: int) -> IO[bytes]: + # We only want to write to this file, so open it in write only mode + flags = os.O_WRONLY + + # os.O_CREAT | os.O_EXCL will fail if the file already exists, so we only + # will open *new* files. + # We specify this because we want to ensure that the mode we pass is the + # mode of the file. + flags |= os.O_CREAT | os.O_EXCL + + # Do not follow symlinks to prevent someone from making a symlink that + # we follow and insecurely open a cache file. + if hasattr(os, "O_NOFOLLOW"): + flags |= os.O_NOFOLLOW + + # On Windows we'll mark this file as binary + if hasattr(os, "O_BINARY"): + flags |= os.O_BINARY + + # Before we open our file, we want to delete any existing file that is + # there + try: + os.remove(filename) + except OSError: + # The file must not exist already, so we can just skip ahead to opening + pass + + # Open our file, the use of os.O_CREAT | os.O_EXCL will ensure that if a + # race condition happens between the os.remove and this line, that an + # error will be raised. Because we utilize a lockfile this should only + # happen if someone is attempting to attack us. + fd = os.open(filename, flags, fmode) + try: + return os.fdopen(fd, "wb") + + except: + # An error occurred wrapping our FD in a file object + os.close(fd) + raise + + +class _FileCacheMixin: + """Shared implementation for both FileCache variants.""" + + def __init__( + self, + directory: str | Path, + forever: bool = False, + filemode: int = 0o0600, + dirmode: int = 0o0700, + lock_class: type[BaseFileLock] | None = None, + ) -> None: + try: + if lock_class is None: + from filelock import FileLock + + lock_class = FileLock + except ImportError: + notice = dedent( + """ + NOTE: In order to use the FileCache you must have + filelock installed. You can install it via pip: + pip install cachecontrol[filecache] + """ + ) + raise ImportError(notice) + + self.directory = directory + self.forever = forever + self.filemode = filemode + self.dirmode = dirmode + self.lock_class = lock_class + + @staticmethod + def encode(x: str) -> str: + return hashlib.sha224(x.encode()).hexdigest() + + def _fn(self, name: str) -> str: + # NOTE: This method should not change as some may depend on it. + # See: https://github.com/ionrock/cachecontrol/issues/63 + hashed = self.encode(name) + parts = list(hashed[:5]) + [hashed] + return os.path.join(self.directory, *parts) + + def get(self, key: str) -> bytes | None: + name = self._fn(key) + try: + with open(name, "rb") as fh: + return fh.read() + + except FileNotFoundError: + return None + + def set( + self, key: str, value: bytes, expires: int | datetime | None = None + ) -> None: + name = self._fn(key) + self._write(name, value) + + def _write(self, path: str, data: bytes) -> None: + """ + Safely write the data to the given path. + """ + # Make sure the directory exists + try: + os.makedirs(os.path.dirname(path), self.dirmode) + except OSError: + pass + + with self.lock_class(path + ".lock"): + # Write our actual file + with _secure_open_write(path, self.filemode) as fh: + fh.write(data) + + def _delete(self, key: str, suffix: str) -> None: + name = self._fn(key) + suffix + if not self.forever: + try: + os.remove(name) + except FileNotFoundError: + pass + + +class FileCache(_FileCacheMixin, BaseCache): + """ + Traditional FileCache: body is stored in memory, so not suitable for large + downloads. + """ + + def delete(self, key: str) -> None: + self._delete(key, "") + + +class SeparateBodyFileCache(_FileCacheMixin, SeparateBodyBaseCache): + """ + Memory-efficient FileCache: body is stored in a separate file, reducing + peak memory usage. + """ + + def get_body(self, key: str) -> IO[bytes] | None: + name = self._fn(key) + ".body" + try: + return open(name, "rb") + except FileNotFoundError: + return None + + def set_body(self, key: str, body: bytes) -> None: + name = self._fn(key) + ".body" + self._write(name, body) + + def delete(self, key: str) -> None: + self._delete(key, "") + self._delete(key, ".body") + + +def url_to_file_path(url: str, filecache: FileCache) -> str: + """Return the file cache path based on the URL. + + This does not ensure the file exists! + """ + key = CacheController.cache_url(url) + return filecache._fn(key) diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/caches/redis_cache.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/caches/redis_cache.py new file mode 100644 index 0000000..f4f68c4 --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/caches/redis_cache.py @@ -0,0 +1,48 @@ +# SPDX-FileCopyrightText: 2015 Eric Larson +# +# SPDX-License-Identifier: Apache-2.0 +from __future__ import annotations + + +from datetime import datetime, timezone +from typing import TYPE_CHECKING + +from pip._vendor.cachecontrol.cache import BaseCache + +if TYPE_CHECKING: + from redis import Redis + + +class RedisCache(BaseCache): + def __init__(self, conn: Redis[bytes]) -> None: + self.conn = conn + + def get(self, key: str) -> bytes | None: + return self.conn.get(key) + + def set( + self, key: str, value: bytes, expires: int | datetime | None = None + ) -> None: + if not expires: + self.conn.set(key, value) + elif isinstance(expires, datetime): + now_utc = datetime.now(timezone.utc) + if expires.tzinfo is None: + now_utc = now_utc.replace(tzinfo=None) + delta = expires - now_utc + self.conn.setex(key, int(delta.total_seconds()), value) + else: + self.conn.setex(key, expires, value) + + def delete(self, key: str) -> None: + self.conn.delete(key) + + def clear(self) -> None: + """Helper for clearing all the keys in a database. Use with + caution!""" + for key in self.conn.keys(): + self.conn.delete(key) + + def close(self) -> None: + """Redis uses connection pooling, no need to close the connection.""" + pass diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/controller.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/controller.py new file mode 100644 index 0000000..f0ff6e1 --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/controller.py @@ -0,0 +1,500 @@ +# SPDX-FileCopyrightText: 2015 Eric Larson +# +# SPDX-License-Identifier: Apache-2.0 + +""" +The httplib2 algorithms ported for use with requests. +""" + +from __future__ import annotations + +import calendar +import logging +import re +import time +from email.utils import parsedate_tz +from typing import TYPE_CHECKING, Collection, Mapping + +from pip._vendor.requests.structures import CaseInsensitiveDict + +from pip._vendor.cachecontrol.cache import DictCache, SeparateBodyBaseCache +from pip._vendor.cachecontrol.serialize import Serializer + +if TYPE_CHECKING: + from typing import Literal + + from pip._vendor.requests import PreparedRequest + from pip._vendor.urllib3 import HTTPResponse + + from pip._vendor.cachecontrol.cache import BaseCache + +logger = logging.getLogger(__name__) + +URI = re.compile(r"^(([^:/?#]+):)?(//([^/?#]*))?([^?#]*)(\?([^#]*))?(#(.*))?") + +PERMANENT_REDIRECT_STATUSES = (301, 308) + + +def parse_uri(uri: str) -> tuple[str, str, str, str, str]: + """Parses a URI using the regex given in Appendix B of RFC 3986. + + (scheme, authority, path, query, fragment) = parse_uri(uri) + """ + match = URI.match(uri) + assert match is not None + groups = match.groups() + return (groups[1], groups[3], groups[4], groups[6], groups[8]) + + +class CacheController: + """An interface to see if request should cached or not.""" + + def __init__( + self, + cache: BaseCache | None = None, + cache_etags: bool = True, + serializer: Serializer | None = None, + status_codes: Collection[int] | None = None, + ): + self.cache = DictCache() if cache is None else cache + self.cache_etags = cache_etags + self.serializer = serializer or Serializer() + self.cacheable_status_codes = status_codes or (200, 203, 300, 301, 308) + + @classmethod + def _urlnorm(cls, uri: str) -> str: + """Normalize the URL to create a safe key for the cache""" + (scheme, authority, path, query, fragment) = parse_uri(uri) + if not scheme or not authority: + raise Exception("Only absolute URIs are allowed. uri = %s" % uri) + + scheme = scheme.lower() + authority = authority.lower() + + if not path: + path = "/" + + # Could do syntax based normalization of the URI before + # computing the digest. See Section 6.2.2 of Std 66. + request_uri = query and "?".join([path, query]) or path + defrag_uri = scheme + "://" + authority + request_uri + + return defrag_uri + + @classmethod + def cache_url(cls, uri: str) -> str: + return cls._urlnorm(uri) + + def parse_cache_control(self, headers: Mapping[str, str]) -> dict[str, int | None]: + known_directives = { + # https://tools.ietf.org/html/rfc7234#section-5.2 + "max-age": (int, True), + "max-stale": (int, False), + "min-fresh": (int, True), + "no-cache": (None, False), + "no-store": (None, False), + "no-transform": (None, False), + "only-if-cached": (None, False), + "must-revalidate": (None, False), + "public": (None, False), + "private": (None, False), + "proxy-revalidate": (None, False), + "s-maxage": (int, True), + } + + cc_headers = headers.get("cache-control", headers.get("Cache-Control", "")) + + retval: dict[str, int | None] = {} + + for cc_directive in cc_headers.split(","): + if not cc_directive.strip(): + continue + + parts = cc_directive.split("=", 1) + directive = parts[0].strip() + + try: + typ, required = known_directives[directive] + except KeyError: + logger.debug("Ignoring unknown cache-control directive: %s", directive) + continue + + if not typ or not required: + retval[directive] = None + if typ: + try: + retval[directive] = typ(parts[1].strip()) + except IndexError: + if required: + logger.debug( + "Missing value for cache-control " "directive: %s", + directive, + ) + except ValueError: + logger.debug( + "Invalid value for cache-control directive " "%s, must be %s", + directive, + typ.__name__, + ) + + return retval + + def _load_from_cache(self, request: PreparedRequest) -> HTTPResponse | None: + """ + Load a cached response, or return None if it's not available. + """ + # We do not support caching of partial content: so if the request contains a + # Range header then we don't want to load anything from the cache. + if "Range" in request.headers: + return None + + cache_url = request.url + assert cache_url is not None + cache_data = self.cache.get(cache_url) + if cache_data is None: + logger.debug("No cache entry available") + return None + + if isinstance(self.cache, SeparateBodyBaseCache): + body_file = self.cache.get_body(cache_url) + else: + body_file = None + + result = self.serializer.loads(request, cache_data, body_file) + if result is None: + logger.warning("Cache entry deserialization failed, entry ignored") + return result + + def cached_request(self, request: PreparedRequest) -> HTTPResponse | Literal[False]: + """ + Return a cached response if it exists in the cache, otherwise + return False. + """ + assert request.url is not None + cache_url = self.cache_url(request.url) + logger.debug('Looking up "%s" in the cache', cache_url) + cc = self.parse_cache_control(request.headers) + + # Bail out if the request insists on fresh data + if "no-cache" in cc: + logger.debug('Request header has "no-cache", cache bypassed') + return False + + if "max-age" in cc and cc["max-age"] == 0: + logger.debug('Request header has "max_age" as 0, cache bypassed') + return False + + # Check whether we can load the response from the cache: + resp = self._load_from_cache(request) + if not resp: + return False + + # If we have a cached permanent redirect, return it immediately. We + # don't need to test our response for other headers b/c it is + # intrinsically "cacheable" as it is Permanent. + # + # See: + # https://tools.ietf.org/html/rfc7231#section-6.4.2 + # + # Client can try to refresh the value by repeating the request + # with cache busting headers as usual (ie no-cache). + if int(resp.status) in PERMANENT_REDIRECT_STATUSES: + msg = ( + "Returning cached permanent redirect response " + "(ignoring date and etag information)" + ) + logger.debug(msg) + return resp + + headers: CaseInsensitiveDict[str] = CaseInsensitiveDict(resp.headers) + if not headers or "date" not in headers: + if "etag" not in headers: + # Without date or etag, the cached response can never be used + # and should be deleted. + logger.debug("Purging cached response: no date or etag") + self.cache.delete(cache_url) + logger.debug("Ignoring cached response: no date") + return False + + now = time.time() + time_tuple = parsedate_tz(headers["date"]) + assert time_tuple is not None + date = calendar.timegm(time_tuple[:6]) + current_age = max(0, now - date) + logger.debug("Current age based on date: %i", current_age) + + # TODO: There is an assumption that the result will be a + # urllib3 response object. This may not be best since we + # could probably avoid instantiating or constructing the + # response until we know we need it. + resp_cc = self.parse_cache_control(headers) + + # determine freshness + freshness_lifetime = 0 + + # Check the max-age pragma in the cache control header + max_age = resp_cc.get("max-age") + if max_age is not None: + freshness_lifetime = max_age + logger.debug("Freshness lifetime from max-age: %i", freshness_lifetime) + + # If there isn't a max-age, check for an expires header + elif "expires" in headers: + expires = parsedate_tz(headers["expires"]) + if expires is not None: + expire_time = calendar.timegm(expires[:6]) - date + freshness_lifetime = max(0, expire_time) + logger.debug("Freshness lifetime from expires: %i", freshness_lifetime) + + # Determine if we are setting freshness limit in the + # request. Note, this overrides what was in the response. + max_age = cc.get("max-age") + if max_age is not None: + freshness_lifetime = max_age + logger.debug( + "Freshness lifetime from request max-age: %i", freshness_lifetime + ) + + min_fresh = cc.get("min-fresh") + if min_fresh is not None: + # adjust our current age by our min fresh + current_age += min_fresh + logger.debug("Adjusted current age from min-fresh: %i", current_age) + + # Return entry if it is fresh enough + if freshness_lifetime > current_age: + logger.debug('The response is "fresh", returning cached response') + logger.debug("%i > %i", freshness_lifetime, current_age) + return resp + + # we're not fresh. If we don't have an Etag, clear it out + if "etag" not in headers: + logger.debug('The cached response is "stale" with no etag, purging') + self.cache.delete(cache_url) + + # return the original handler + return False + + def conditional_headers(self, request: PreparedRequest) -> dict[str, str]: + resp = self._load_from_cache(request) + new_headers = {} + + if resp: + headers: CaseInsensitiveDict[str] = CaseInsensitiveDict(resp.headers) + + if "etag" in headers: + new_headers["If-None-Match"] = headers["ETag"] + + if "last-modified" in headers: + new_headers["If-Modified-Since"] = headers["Last-Modified"] + + return new_headers + + def _cache_set( + self, + cache_url: str, + request: PreparedRequest, + response: HTTPResponse, + body: bytes | None = None, + expires_time: int | None = None, + ) -> None: + """ + Store the data in the cache. + """ + if isinstance(self.cache, SeparateBodyBaseCache): + # We pass in the body separately; just put a placeholder empty + # string in the metadata. + self.cache.set( + cache_url, + self.serializer.dumps(request, response, b""), + expires=expires_time, + ) + # body is None can happen when, for example, we're only updating + # headers, as is the case in update_cached_response(). + if body is not None: + self.cache.set_body(cache_url, body) + else: + self.cache.set( + cache_url, + self.serializer.dumps(request, response, body), + expires=expires_time, + ) + + def cache_response( + self, + request: PreparedRequest, + response: HTTPResponse, + body: bytes | None = None, + status_codes: Collection[int] | None = None, + ) -> None: + """ + Algorithm for caching requests. + + This assumes a requests Response object. + """ + # From httplib2: Don't cache 206's since we aren't going to + # handle byte range requests + cacheable_status_codes = status_codes or self.cacheable_status_codes + if response.status not in cacheable_status_codes: + logger.debug( + "Status code %s not in %s", response.status, cacheable_status_codes + ) + return + + response_headers: CaseInsensitiveDict[str] = CaseInsensitiveDict( + response.headers + ) + + if "date" in response_headers: + time_tuple = parsedate_tz(response_headers["date"]) + assert time_tuple is not None + date = calendar.timegm(time_tuple[:6]) + else: + date = 0 + + # If we've been given a body, our response has a Content-Length, that + # Content-Length is valid then we can check to see if the body we've + # been given matches the expected size, and if it doesn't we'll just + # skip trying to cache it. + if ( + body is not None + and "content-length" in response_headers + and response_headers["content-length"].isdigit() + and int(response_headers["content-length"]) != len(body) + ): + return + + cc_req = self.parse_cache_control(request.headers) + cc = self.parse_cache_control(response_headers) + + assert request.url is not None + cache_url = self.cache_url(request.url) + logger.debug('Updating cache with response from "%s"', cache_url) + + # Delete it from the cache if we happen to have it stored there + no_store = False + if "no-store" in cc: + no_store = True + logger.debug('Response header has "no-store"') + if "no-store" in cc_req: + no_store = True + logger.debug('Request header has "no-store"') + if no_store and self.cache.get(cache_url): + logger.debug('Purging existing cache entry to honor "no-store"') + self.cache.delete(cache_url) + if no_store: + return + + # https://tools.ietf.org/html/rfc7234#section-4.1: + # A Vary header field-value of "*" always fails to match. + # Storing such a response leads to a deserialization warning + # during cache lookup and is not allowed to ever be served, + # so storing it can be avoided. + if "*" in response_headers.get("vary", ""): + logger.debug('Response header has "Vary: *"') + return + + # If we've been given an etag, then keep the response + if self.cache_etags and "etag" in response_headers: + expires_time = 0 + if response_headers.get("expires"): + expires = parsedate_tz(response_headers["expires"]) + if expires is not None: + expires_time = calendar.timegm(expires[:6]) - date + + expires_time = max(expires_time, 14 * 86400) + + logger.debug(f"etag object cached for {expires_time} seconds") + logger.debug("Caching due to etag") + self._cache_set(cache_url, request, response, body, expires_time) + + # Add to the cache any permanent redirects. We do this before looking + # that the Date headers. + elif int(response.status) in PERMANENT_REDIRECT_STATUSES: + logger.debug("Caching permanent redirect") + self._cache_set(cache_url, request, response, b"") + + # Add to the cache if the response headers demand it. If there + # is no date header then we can't do anything about expiring + # the cache. + elif "date" in response_headers: + time_tuple = parsedate_tz(response_headers["date"]) + assert time_tuple is not None + date = calendar.timegm(time_tuple[:6]) + # cache when there is a max-age > 0 + max_age = cc.get("max-age") + if max_age is not None and max_age > 0: + logger.debug("Caching b/c date exists and max-age > 0") + expires_time = max_age + self._cache_set( + cache_url, + request, + response, + body, + expires_time, + ) + + # If the request can expire, it means we should cache it + # in the meantime. + elif "expires" in response_headers: + if response_headers["expires"]: + expires = parsedate_tz(response_headers["expires"]) + if expires is not None: + expires_time = calendar.timegm(expires[:6]) - date + else: + expires_time = None + + logger.debug( + "Caching b/c of expires header. expires in {} seconds".format( + expires_time + ) + ) + self._cache_set( + cache_url, + request, + response, + body, + expires_time, + ) + + def update_cached_response( + self, request: PreparedRequest, response: HTTPResponse + ) -> HTTPResponse: + """On a 304 we will get a new set of headers that we want to + update our cached value with, assuming we have one. + + This should only ever be called when we've sent an ETag and + gotten a 304 as the response. + """ + assert request.url is not None + cache_url = self.cache_url(request.url) + cached_response = self._load_from_cache(request) + + if not cached_response: + # we didn't have a cached response + return response + + # Lets update our headers with the headers from the new request: + # http://tools.ietf.org/html/draft-ietf-httpbis-p4-conditional-26#section-4.1 + # + # The server isn't supposed to send headers that would make + # the cached body invalid. But... just in case, we'll be sure + # to strip out ones we know that might be problmatic due to + # typical assumptions. + excluded_headers = ["content-length"] + + cached_response.headers.update( + { + k: v + for k, v in response.headers.items() + if k.lower() not in excluded_headers + } + ) + + # we want a 200 b/c we have content via the cache + cached_response.status = 200 + + # update our cache + self._cache_set(cache_url, request, cached_response) + + return cached_response diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/filewrapper.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/filewrapper.py new file mode 100644 index 0000000..37d2fa5 --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/filewrapper.py @@ -0,0 +1,119 @@ +# SPDX-FileCopyrightText: 2015 Eric Larson +# +# SPDX-License-Identifier: Apache-2.0 +from __future__ import annotations + +import mmap +from tempfile import NamedTemporaryFile +from typing import TYPE_CHECKING, Any, Callable + +if TYPE_CHECKING: + from http.client import HTTPResponse + + +class CallbackFileWrapper: + """ + Small wrapper around a fp object which will tee everything read into a + buffer, and when that file is closed it will execute a callback with the + contents of that buffer. + + All attributes are proxied to the underlying file object. + + This class uses members with a double underscore (__) leading prefix so as + not to accidentally shadow an attribute. + + The data is stored in a temporary file until it is all available. As long + as the temporary files directory is disk-based (sometimes it's a + memory-backed-``tmpfs`` on Linux), data will be unloaded to disk if memory + pressure is high. For small files the disk usually won't be used at all, + it'll all be in the filesystem memory cache, so there should be no + performance impact. + """ + + def __init__( + self, fp: HTTPResponse, callback: Callable[[bytes], None] | None + ) -> None: + self.__buf = NamedTemporaryFile("rb+", delete=True) + self.__fp = fp + self.__callback = callback + + def __getattr__(self, name: str) -> Any: + # The vagaries of garbage collection means that self.__fp is + # not always set. By using __getattribute__ and the private + # name[0] allows looking up the attribute value and raising an + # AttributeError when it doesn't exist. This stop things from + # infinitely recursing calls to getattr in the case where + # self.__fp hasn't been set. + # + # [0] https://docs.python.org/2/reference/expressions.html#atom-identifiers + fp = self.__getattribute__("_CallbackFileWrapper__fp") + return getattr(fp, name) + + def __is_fp_closed(self) -> bool: + try: + return self.__fp.fp is None + + except AttributeError: + pass + + try: + closed: bool = self.__fp.closed + return closed + + except AttributeError: + pass + + # We just don't cache it then. + # TODO: Add some logging here... + return False + + def _close(self) -> None: + if self.__callback: + if self.__buf.tell() == 0: + # Empty file: + result = b"" + else: + # Return the data without actually loading it into memory, + # relying on Python's buffer API and mmap(). mmap() just gives + # a view directly into the filesystem's memory cache, so it + # doesn't result in duplicate memory use. + self.__buf.seek(0, 0) + result = memoryview( + mmap.mmap(self.__buf.fileno(), 0, access=mmap.ACCESS_READ) + ) + self.__callback(result) + + # We assign this to None here, because otherwise we can get into + # really tricky problems where the CPython interpreter dead locks + # because the callback is holding a reference to something which + # has a __del__ method. Setting this to None breaks the cycle + # and allows the garbage collector to do it's thing normally. + self.__callback = None + + # Closing the temporary file releases memory and frees disk space. + # Important when caching big files. + self.__buf.close() + + def read(self, amt: int | None = None) -> bytes: + data: bytes = self.__fp.read(amt) + if data: + # We may be dealing with b'', a sign that things are over: + # it's passed e.g. after we've already closed self.__buf. + self.__buf.write(data) + if self.__is_fp_closed(): + self._close() + + return data + + def _safe_read(self, amt: int) -> bytes: + data: bytes = self.__fp._safe_read(amt) # type: ignore[attr-defined] + if amt == 2 and data == b"\r\n": + # urllib executes this read to toss the CRLF at the end + # of the chunk. + return data + + self.__buf.write(data) + if self.__is_fp_closed(): + self._close() + + return data diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/heuristics.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/heuristics.py new file mode 100644 index 0000000..b778c4f --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/heuristics.py @@ -0,0 +1,157 @@ +# SPDX-FileCopyrightText: 2015 Eric Larson +# +# SPDX-License-Identifier: Apache-2.0 +from __future__ import annotations + +import calendar +import time +from datetime import datetime, timedelta, timezone +from email.utils import formatdate, parsedate, parsedate_tz +from typing import TYPE_CHECKING, Any, Mapping + +if TYPE_CHECKING: + from pip._vendor.urllib3 import HTTPResponse + +TIME_FMT = "%a, %d %b %Y %H:%M:%S GMT" + + +def expire_after(delta: timedelta, date: datetime | None = None) -> datetime: + date = date or datetime.now(timezone.utc) + return date + delta + + +def datetime_to_header(dt: datetime) -> str: + return formatdate(calendar.timegm(dt.timetuple())) + + +class BaseHeuristic: + def warning(self, response: HTTPResponse) -> str | None: + """ + Return a valid 1xx warning header value describing the cache + adjustments. + + The response is provided too allow warnings like 113 + http://tools.ietf.org/html/rfc7234#section-5.5.4 where we need + to explicitly say response is over 24 hours old. + """ + return '110 - "Response is Stale"' + + def update_headers(self, response: HTTPResponse) -> dict[str, str]: + """Update the response headers with any new headers. + + NOTE: This SHOULD always include some Warning header to + signify that the response was cached by the client, not + by way of the provided headers. + """ + return {} + + def apply(self, response: HTTPResponse) -> HTTPResponse: + updated_headers = self.update_headers(response) + + if updated_headers: + response.headers.update(updated_headers) + warning_header_value = self.warning(response) + if warning_header_value is not None: + response.headers.update({"Warning": warning_header_value}) + + return response + + +class OneDayCache(BaseHeuristic): + """ + Cache the response by providing an expires 1 day in the + future. + """ + + def update_headers(self, response: HTTPResponse) -> dict[str, str]: + headers = {} + + if "expires" not in response.headers: + date = parsedate(response.headers["date"]) + expires = expire_after( + timedelta(days=1), + date=datetime(*date[:6], tzinfo=timezone.utc), # type: ignore[index,misc] + ) + headers["expires"] = datetime_to_header(expires) + headers["cache-control"] = "public" + return headers + + +class ExpiresAfter(BaseHeuristic): + """ + Cache **all** requests for a defined time period. + """ + + def __init__(self, **kw: Any) -> None: + self.delta = timedelta(**kw) + + def update_headers(self, response: HTTPResponse) -> dict[str, str]: + expires = expire_after(self.delta) + return {"expires": datetime_to_header(expires), "cache-control": "public"} + + def warning(self, response: HTTPResponse) -> str | None: + tmpl = "110 - Automatically cached for %s. Response might be stale" + return tmpl % self.delta + + +class LastModified(BaseHeuristic): + """ + If there is no Expires header already, fall back on Last-Modified + using the heuristic from + http://tools.ietf.org/html/rfc7234#section-4.2.2 + to calculate a reasonable value. + + Firefox also does something like this per + https://developer.mozilla.org/en-US/docs/Web/HTTP/Caching_FAQ + http://lxr.mozilla.org/mozilla-release/source/netwerk/protocol/http/nsHttpResponseHead.cpp#397 + Unlike mozilla we limit this to 24-hr. + """ + + cacheable_by_default_statuses = { + 200, + 203, + 204, + 206, + 300, + 301, + 404, + 405, + 410, + 414, + 501, + } + + def update_headers(self, resp: HTTPResponse) -> dict[str, str]: + headers: Mapping[str, str] = resp.headers + + if "expires" in headers: + return {} + + if "cache-control" in headers and headers["cache-control"] != "public": + return {} + + if resp.status not in self.cacheable_by_default_statuses: + return {} + + if "date" not in headers or "last-modified" not in headers: + return {} + + time_tuple = parsedate_tz(headers["date"]) + assert time_tuple is not None + date = calendar.timegm(time_tuple[:6]) + last_modified = parsedate(headers["last-modified"]) + if last_modified is None: + return {} + + now = time.time() + current_age = max(0, now - date) + delta = date - calendar.timegm(last_modified) + freshness_lifetime = max(0, min(delta / 10, 24 * 3600)) + if freshness_lifetime <= current_age: + return {} + + expires = date + freshness_lifetime + return {"expires": time.strftime(TIME_FMT, time.gmtime(expires))} + + def warning(self, resp: HTTPResponse) -> str | None: + return None diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/py.typed b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/py.typed new file mode 100644 index 0000000..e69de29 diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/serialize.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/serialize.py new file mode 100644 index 0000000..a49487a --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/serialize.py @@ -0,0 +1,146 @@ +# SPDX-FileCopyrightText: 2015 Eric Larson +# +# SPDX-License-Identifier: Apache-2.0 +from __future__ import annotations + +import io +from typing import IO, TYPE_CHECKING, Any, Mapping, cast + +from pip._vendor import msgpack +from pip._vendor.requests.structures import CaseInsensitiveDict +from pip._vendor.urllib3 import HTTPResponse + +if TYPE_CHECKING: + from pip._vendor.requests import PreparedRequest + + +class Serializer: + serde_version = "4" + + def dumps( + self, + request: PreparedRequest, + response: HTTPResponse, + body: bytes | None = None, + ) -> bytes: + response_headers: CaseInsensitiveDict[str] = CaseInsensitiveDict( + response.headers + ) + + if body is None: + # When a body isn't passed in, we'll read the response. We + # also update the response with a new file handler to be + # sure it acts as though it was never read. + body = response.read(decode_content=False) + response._fp = io.BytesIO(body) # type: ignore[assignment] + response.length_remaining = len(body) + + data = { + "response": { + "body": body, # Empty bytestring if body is stored separately + "headers": {str(k): str(v) for k, v in response.headers.items()}, + "status": response.status, + "version": response.version, + "reason": str(response.reason), + "decode_content": response.decode_content, + } + } + + # Construct our vary headers + data["vary"] = {} + if "vary" in response_headers: + varied_headers = response_headers["vary"].split(",") + for header in varied_headers: + header = str(header).strip() + header_value = request.headers.get(header, None) + if header_value is not None: + header_value = str(header_value) + data["vary"][header] = header_value + + return b",".join([f"cc={self.serde_version}".encode(), self.serialize(data)]) + + def serialize(self, data: dict[str, Any]) -> bytes: + return cast(bytes, msgpack.dumps(data, use_bin_type=True)) + + def loads( + self, + request: PreparedRequest, + data: bytes, + body_file: IO[bytes] | None = None, + ) -> HTTPResponse | None: + # Short circuit if we've been given an empty set of data + if not data: + return None + + # Previous versions of this library supported other serialization + # formats, but these have all been removed. + if not data.startswith(f"cc={self.serde_version},".encode()): + return None + + data = data[5:] + return self._loads_v4(request, data, body_file) + + def prepare_response( + self, + request: PreparedRequest, + cached: Mapping[str, Any], + body_file: IO[bytes] | None = None, + ) -> HTTPResponse | None: + """Verify our vary headers match and construct a real urllib3 + HTTPResponse object. + """ + # Special case the '*' Vary value as it means we cannot actually + # determine if the cached response is suitable for this request. + # This case is also handled in the controller code when creating + # a cache entry, but is left here for backwards compatibility. + if "*" in cached.get("vary", {}): + return None + + # Ensure that the Vary headers for the cached response match our + # request + for header, value in cached.get("vary", {}).items(): + if request.headers.get(header, None) != value: + return None + + body_raw = cached["response"].pop("body") + + headers: CaseInsensitiveDict[str] = CaseInsensitiveDict( + data=cached["response"]["headers"] + ) + if headers.get("transfer-encoding", "") == "chunked": + headers.pop("transfer-encoding") + + cached["response"]["headers"] = headers + + try: + body: IO[bytes] + if body_file is None: + body = io.BytesIO(body_raw) + else: + body = body_file + except TypeError: + # This can happen if cachecontrol serialized to v1 format (pickle) + # using Python 2. A Python 2 str(byte string) will be unpickled as + # a Python 3 str (unicode string), which will cause the above to + # fail with: + # + # TypeError: 'str' does not support the buffer interface + body = io.BytesIO(body_raw.encode("utf8")) + + # Discard any `strict` parameter serialized by older version of cachecontrol. + cached["response"].pop("strict", None) + + return HTTPResponse(body=body, preload_content=False, **cached["response"]) + + def _loads_v4( + self, + request: PreparedRequest, + data: bytes, + body_file: IO[bytes] | None = None, + ) -> HTTPResponse | None: + try: + cached = msgpack.loads(data, raw=False) + except ValueError: + return None + + return self.prepare_response(request, cached, body_file) diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/wrapper.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/wrapper.py new file mode 100644 index 0000000..f618bc3 --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/wrapper.py @@ -0,0 +1,43 @@ +# SPDX-FileCopyrightText: 2015 Eric Larson +# +# SPDX-License-Identifier: Apache-2.0 +from __future__ import annotations + +from typing import TYPE_CHECKING, Collection + +from pip._vendor.cachecontrol.adapter import CacheControlAdapter +from pip._vendor.cachecontrol.cache import DictCache + +if TYPE_CHECKING: + from pip._vendor import requests + + from pip._vendor.cachecontrol.cache import BaseCache + from pip._vendor.cachecontrol.controller import CacheController + from pip._vendor.cachecontrol.heuristics import BaseHeuristic + from pip._vendor.cachecontrol.serialize import Serializer + + +def CacheControl( + sess: requests.Session, + cache: BaseCache | None = None, + cache_etags: bool = True, + serializer: Serializer | None = None, + heuristic: BaseHeuristic | None = None, + controller_class: type[CacheController] | None = None, + adapter_class: type[CacheControlAdapter] | None = None, + cacheable_methods: Collection[str] | None = None, +) -> requests.Session: + cache = DictCache() if cache is None else cache + adapter_class = adapter_class or CacheControlAdapter + adapter = adapter_class( + cache, + cache_etags=cache_etags, + serializer=serializer, + heuristic=heuristic, + controller_class=controller_class, + cacheable_methods=cacheable_methods, + ) + sess.mount("http://", adapter) + sess.mount("https://", adapter) + + return sess diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/certifi/__init__.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/certifi/__init__.py new file mode 100644 index 0000000..f61d77f --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/certifi/__init__.py @@ -0,0 +1,4 @@ +from .core import contents, where + +__all__ = ["contents", "where"] +__version__ = "2024.08.30" diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/certifi/__main__.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/certifi/__main__.py new file mode 100644 index 0000000..0037634 --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/certifi/__main__.py @@ -0,0 +1,12 @@ +import argparse + +from pip._vendor.certifi import contents, where + +parser = argparse.ArgumentParser() +parser.add_argument("-c", "--contents", action="store_true") +args = parser.parse_args() + +if args.contents: + print(contents()) +else: + print(where()) diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/certifi/__pycache__/__init__.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/certifi/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000..c89c00c Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/certifi/__pycache__/__init__.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/certifi/__pycache__/__main__.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/certifi/__pycache__/__main__.cpython-312.pyc new file mode 100644 index 0000000..264edcb Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/certifi/__pycache__/__main__.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/certifi/__pycache__/core.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/certifi/__pycache__/core.cpython-312.pyc new file mode 100644 index 0000000..df956c8 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/certifi/__pycache__/core.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/certifi/cacert.pem b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/certifi/cacert.pem new file mode 100644 index 0000000..3c165a1 --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/certifi/cacert.pem @@ -0,0 +1,4929 @@ + +# Issuer: CN=GlobalSign Root CA O=GlobalSign nv-sa OU=Root CA +# Subject: CN=GlobalSign Root CA O=GlobalSign nv-sa OU=Root CA +# Label: "GlobalSign Root CA" +# Serial: 4835703278459707669005204 +# MD5 Fingerprint: 3e:45:52:15:09:51:92:e1:b7:5d:37:9f:b1:87:29:8a +# SHA1 Fingerprint: b1:bc:96:8b:d4:f4:9d:62:2a:a8:9a:81:f2:15:01:52:a4:1d:82:9c +# SHA256 Fingerprint: eb:d4:10:40:e4:bb:3e:c7:42:c9:e3:81:d3:1e:f2:a4:1a:48:b6:68:5c:96:e7:ce:f3:c1:df:6c:d4:33:1c:99 +-----BEGIN CERTIFICATE----- +MIIDdTCCAl2gAwIBAgILBAAAAAABFUtaw5QwDQYJKoZIhvcNAQEFBQAwVzELMAkG +A1UEBhMCQkUxGTAXBgNVBAoTEEdsb2JhbFNpZ24gbnYtc2ExEDAOBgNVBAsTB1Jv +b3QgQ0ExGzAZBgNVBAMTEkdsb2JhbFNpZ24gUm9vdCBDQTAeFw05ODA5MDExMjAw +MDBaFw0yODAxMjgxMjAwMDBaMFcxCzAJBgNVBAYTAkJFMRkwFwYDVQQKExBHbG9i +YWxTaWduIG52LXNhMRAwDgYDVQQLEwdSb290IENBMRswGQYDVQQDExJHbG9iYWxT +aWduIFJvb3QgQ0EwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQDaDuaZ +jc6j40+Kfvvxi4Mla+pIH/EqsLmVEQS98GPR4mdmzxzdzxtIK+6NiY6arymAZavp +xy0Sy6scTHAHoT0KMM0VjU/43dSMUBUc71DuxC73/OlS8pF94G3VNTCOXkNz8kHp +1Wrjsok6Vjk4bwY8iGlbKk3Fp1S4bInMm/k8yuX9ifUSPJJ4ltbcdG6TRGHRjcdG +snUOhugZitVtbNV4FpWi6cgKOOvyJBNPc1STE4U6G7weNLWLBYy5d4ux2x8gkasJ +U26Qzns3dLlwR5EiUWMWea6xrkEmCMgZK9FGqkjWZCrXgzT/LCrBbBlDSgeF59N8 +9iFo7+ryUp9/k5DPAgMBAAGjQjBAMA4GA1UdDwEB/wQEAwIBBjAPBgNVHRMBAf8E +BTADAQH/MB0GA1UdDgQWBBRge2YaRQ2XyolQL30EzTSo//z9SzANBgkqhkiG9w0B +AQUFAAOCAQEA1nPnfE920I2/7LqivjTFKDK1fPxsnCwrvQmeU79rXqoRSLblCKOz +yj1hTdNGCbM+w6DjY1Ub8rrvrTnhQ7k4o+YviiY776BQVvnGCv04zcQLcFGUl5gE +38NflNUVyRRBnMRddWQVDf9VMOyGj/8N7yy5Y0b2qvzfvGn9LhJIZJrglfCm7ymP +AbEVtQwdpf5pLGkkeB6zpxxxYu7KyJesF12KwvhHhm4qxFYxldBniYUr+WymXUad +DKqC5JlR3XC321Y9YeRq4VzW9v493kHMB65jUr9TU/Qr6cf9tveCX4XSQRjbgbME +HMUfpIBvFSDJ3gyICh3WZlXi/EjJKSZp4A== +-----END CERTIFICATE----- + +# Issuer: CN=Entrust.net Certification Authority (2048) O=Entrust.net OU=www.entrust.net/CPS_2048 incorp. by ref. (limits liab.)/(c) 1999 Entrust.net Limited +# Subject: CN=Entrust.net Certification Authority (2048) O=Entrust.net OU=www.entrust.net/CPS_2048 incorp. by ref. (limits liab.)/(c) 1999 Entrust.net Limited +# Label: "Entrust.net Premium 2048 Secure Server CA" +# Serial: 946069240 +# MD5 Fingerprint: ee:29:31:bc:32:7e:9a:e6:e8:b5:f7:51:b4:34:71:90 +# SHA1 Fingerprint: 50:30:06:09:1d:97:d4:f5:ae:39:f7:cb:e7:92:7d:7d:65:2d:34:31 +# SHA256 Fingerprint: 6d:c4:71:72:e0:1c:bc:b0:bf:62:58:0d:89:5f:e2:b8:ac:9a:d4:f8:73:80:1e:0c:10:b9:c8:37:d2:1e:b1:77 +-----BEGIN CERTIFICATE----- +MIIEKjCCAxKgAwIBAgIEOGPe+DANBgkqhkiG9w0BAQUFADCBtDEUMBIGA1UEChML +RW50cnVzdC5uZXQxQDA+BgNVBAsUN3d3dy5lbnRydXN0Lm5ldC9DUFNfMjA0OCBp +bmNvcnAuIGJ5IHJlZi4gKGxpbWl0cyBsaWFiLikxJTAjBgNVBAsTHChjKSAxOTk5 +IEVudHJ1c3QubmV0IExpbWl0ZWQxMzAxBgNVBAMTKkVudHJ1c3QubmV0IENlcnRp +ZmljYXRpb24gQXV0aG9yaXR5ICgyMDQ4KTAeFw05OTEyMjQxNzUwNTFaFw0yOTA3 +MjQxNDE1MTJaMIG0MRQwEgYDVQQKEwtFbnRydXN0Lm5ldDFAMD4GA1UECxQ3d3d3 +LmVudHJ1c3QubmV0L0NQU18yMDQ4IGluY29ycC4gYnkgcmVmLiAobGltaXRzIGxp +YWIuKTElMCMGA1UECxMcKGMpIDE5OTkgRW50cnVzdC5uZXQgTGltaXRlZDEzMDEG +A1UEAxMqRW50cnVzdC5uZXQgQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkgKDIwNDgp +MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEArU1LqRKGsuqjIAcVFmQq +K0vRvwtKTY7tgHalZ7d4QMBzQshowNtTK91euHaYNZOLGp18EzoOH1u3Hs/lJBQe +sYGpjX24zGtLA/ECDNyrpUAkAH90lKGdCCmziAv1h3edVc3kw37XamSrhRSGlVuX +MlBvPci6Zgzj/L24ScF2iUkZ/cCovYmjZy/Gn7xxGWC4LeksyZB2ZnuU4q941mVT +XTzWnLLPKQP5L6RQstRIzgUyVYr9smRMDuSYB3Xbf9+5CFVghTAp+XtIpGmG4zU/ +HoZdenoVve8AjhUiVBcAkCaTvA5JaJG/+EfTnZVCwQ5N328mz8MYIWJmQ3DW1cAH +4QIDAQABo0IwQDAOBgNVHQ8BAf8EBAMCAQYwDwYDVR0TAQH/BAUwAwEB/zAdBgNV +HQ4EFgQUVeSB0RGAvtiJuQijMfmhJAkWuXAwDQYJKoZIhvcNAQEFBQADggEBADub +j1abMOdTmXx6eadNl9cZlZD7Bh/KM3xGY4+WZiT6QBshJ8rmcnPyT/4xmf3IDExo +U8aAghOY+rat2l098c5u9hURlIIM7j+VrxGrD9cv3h8Dj1csHsm7mhpElesYT6Yf +zX1XEC+bBAlahLVu2B064dae0Wx5XnkcFMXj0EyTO2U87d89vqbllRrDtRnDvV5b +u/8j72gZyxKTJ1wDLW8w0B62GqzeWvfRqqgnpv55gcR5mTNXuhKwqeBCbJPKVt7+ +bYQLCIt+jerXmCHG8+c8eS9enNFMFY3h7CI3zJpDC5fcgJCNs2ebb0gIFVbPv/Er +fF6adulZkMV8gzURZVE= +-----END CERTIFICATE----- + +# Issuer: CN=Baltimore CyberTrust Root O=Baltimore OU=CyberTrust +# Subject: CN=Baltimore CyberTrust Root O=Baltimore OU=CyberTrust +# Label: "Baltimore CyberTrust Root" +# Serial: 33554617 +# MD5 Fingerprint: ac:b6:94:a5:9c:17:e0:d7:91:52:9b:b1:97:06:a6:e4 +# SHA1 Fingerprint: d4:de:20:d0:5e:66:fc:53:fe:1a:50:88:2c:78:db:28:52:ca:e4:74 +# SHA256 Fingerprint: 16:af:57:a9:f6:76:b0:ab:12:60:95:aa:5e:ba:de:f2:2a:b3:11:19:d6:44:ac:95:cd:4b:93:db:f3:f2:6a:eb +-----BEGIN CERTIFICATE----- +MIIDdzCCAl+gAwIBAgIEAgAAuTANBgkqhkiG9w0BAQUFADBaMQswCQYDVQQGEwJJ +RTESMBAGA1UEChMJQmFsdGltb3JlMRMwEQYDVQQLEwpDeWJlclRydXN0MSIwIAYD +VQQDExlCYWx0aW1vcmUgQ3liZXJUcnVzdCBSb290MB4XDTAwMDUxMjE4NDYwMFoX +DTI1MDUxMjIzNTkwMFowWjELMAkGA1UEBhMCSUUxEjAQBgNVBAoTCUJhbHRpbW9y +ZTETMBEGA1UECxMKQ3liZXJUcnVzdDEiMCAGA1UEAxMZQmFsdGltb3JlIEN5YmVy +VHJ1c3QgUm9vdDCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAKMEuyKr +mD1X6CZymrV51Cni4eiVgLGw41uOKymaZN+hXe2wCQVt2yguzmKiYv60iNoS6zjr +IZ3AQSsBUnuId9Mcj8e6uYi1agnnc+gRQKfRzMpijS3ljwumUNKoUMMo6vWrJYeK +mpYcqWe4PwzV9/lSEy/CG9VwcPCPwBLKBsua4dnKM3p31vjsufFoREJIE9LAwqSu +XmD+tqYF/LTdB1kC1FkYmGP1pWPgkAx9XbIGevOF6uvUA65ehD5f/xXtabz5OTZy +dc93Uk3zyZAsuT3lySNTPx8kmCFcB5kpvcY67Oduhjprl3RjM71oGDHweI12v/ye +jl0qhqdNkNwnGjkCAwEAAaNFMEMwHQYDVR0OBBYEFOWdWTCCR1jMrPoIVDaGezq1 +BE3wMBIGA1UdEwEB/wQIMAYBAf8CAQMwDgYDVR0PAQH/BAQDAgEGMA0GCSqGSIb3 +DQEBBQUAA4IBAQCFDF2O5G9RaEIFoN27TyclhAO992T9Ldcw46QQF+vaKSm2eT92 +9hkTI7gQCvlYpNRhcL0EYWoSihfVCr3FvDB81ukMJY2GQE/szKN+OMY3EU/t3Wgx +jkzSswF07r51XgdIGn9w/xZchMB5hbgF/X++ZRGjD8ACtPhSNzkE1akxehi/oCr0 +Epn3o0WC4zxe9Z2etciefC7IpJ5OCBRLbf1wbWsaY71k5h+3zvDyny67G7fyUIhz +ksLi4xaNmjICq44Y3ekQEe5+NauQrz4wlHrQMz2nZQ/1/I6eYs9HRCwBXbsdtTLS +R9I4LtD+gdwyah617jzV/OeBHRnDJELqYzmp +-----END CERTIFICATE----- + +# Issuer: CN=Entrust Root Certification Authority O=Entrust, Inc. OU=www.entrust.net/CPS is incorporated by reference/(c) 2006 Entrust, Inc. +# Subject: CN=Entrust Root Certification Authority O=Entrust, Inc. OU=www.entrust.net/CPS is incorporated by reference/(c) 2006 Entrust, Inc. +# Label: "Entrust Root Certification Authority" +# Serial: 1164660820 +# MD5 Fingerprint: d6:a5:c3:ed:5d:dd:3e:00:c1:3d:87:92:1f:1d:3f:e4 +# SHA1 Fingerprint: b3:1e:b1:b7:40:e3:6c:84:02:da:dc:37:d4:4d:f5:d4:67:49:52:f9 +# SHA256 Fingerprint: 73:c1:76:43:4f:1b:c6:d5:ad:f4:5b:0e:76:e7:27:28:7c:8d:e5:76:16:c1:e6:e6:14:1a:2b:2c:bc:7d:8e:4c +-----BEGIN CERTIFICATE----- +MIIEkTCCA3mgAwIBAgIERWtQVDANBgkqhkiG9w0BAQUFADCBsDELMAkGA1UEBhMC +VVMxFjAUBgNVBAoTDUVudHJ1c3QsIEluYy4xOTA3BgNVBAsTMHd3dy5lbnRydXN0 +Lm5ldC9DUFMgaXMgaW5jb3Jwb3JhdGVkIGJ5IHJlZmVyZW5jZTEfMB0GA1UECxMW +KGMpIDIwMDYgRW50cnVzdCwgSW5jLjEtMCsGA1UEAxMkRW50cnVzdCBSb290IENl +cnRpZmljYXRpb24gQXV0aG9yaXR5MB4XDTA2MTEyNzIwMjM0MloXDTI2MTEyNzIw +NTM0MlowgbAxCzAJBgNVBAYTAlVTMRYwFAYDVQQKEw1FbnRydXN0LCBJbmMuMTkw +NwYDVQQLEzB3d3cuZW50cnVzdC5uZXQvQ1BTIGlzIGluY29ycG9yYXRlZCBieSBy +ZWZlcmVuY2UxHzAdBgNVBAsTFihjKSAyMDA2IEVudHJ1c3QsIEluYy4xLTArBgNV +BAMTJEVudHJ1c3QgUm9vdCBDZXJ0aWZpY2F0aW9uIEF1dGhvcml0eTCCASIwDQYJ +KoZIhvcNAQEBBQADggEPADCCAQoCggEBALaVtkNC+sZtKm9I35RMOVcF7sN5EUFo +Nu3s/poBj6E4KPz3EEZmLk0eGrEaTsbRwJWIsMn/MYszA9u3g3s+IIRe7bJWKKf4 +4LlAcTfFy0cOlypowCKVYhXbR9n10Cv/gkvJrT7eTNuQgFA/CYqEAOwwCj0Yzfv9 +KlmaI5UXLEWeH25DeW0MXJj+SKfFI0dcXv1u5x609mhF0YaDW6KKjbHjKYD+JXGI +rb68j6xSlkuqUY3kEzEZ6E5Nn9uss2rVvDlUccp6en+Q3X0dgNmBu1kmwhH+5pPi +94DkZfs0Nw4pgHBNrziGLp5/V6+eF67rHMsoIV+2HNjnogQi+dPa2MsCAwEAAaOB +sDCBrTAOBgNVHQ8BAf8EBAMCAQYwDwYDVR0TAQH/BAUwAwEB/zArBgNVHRAEJDAi +gA8yMDA2MTEyNzIwMjM0MlqBDzIwMjYxMTI3MjA1MzQyWjAfBgNVHSMEGDAWgBRo +kORnpKZTgMeGZqTx90tD+4S9bTAdBgNVHQ4EFgQUaJDkZ6SmU4DHhmak8fdLQ/uE +vW0wHQYJKoZIhvZ9B0EABBAwDhsIVjcuMTo0LjADAgSQMA0GCSqGSIb3DQEBBQUA +A4IBAQCT1DCw1wMgKtD5Y+iRDAUgqV8ZyntyTtSx29CW+1RaGSwMCPeyvIWonX9t +O1KzKtvn1ISMY/YPyyYBkVBs9F8U4pN0wBOeMDpQ47RgxRzwIkSNcUesyBrJ6Zua +AGAT/3B+XxFNSRuzFVJ7yVTav52Vr2ua2J7p8eRDjeIRRDq/r72DQnNSi6q7pynP +9WQcCk3RvKqsnyrQ/39/2n3qse0wJcGE2jTSW3iDVuycNsMm4hH2Z0kdkquM++v/ +eu6FSqdQgPCnXEqULl8FmTxSQeDNtGPPAUO6nIPcj2A781q0tHuu2guQOHXvgR1m +0vdXcDazv/wor3ElhVsT/h5/WrQ8 +-----END CERTIFICATE----- + +# Issuer: CN=AAA Certificate Services O=Comodo CA Limited +# Subject: CN=AAA Certificate Services O=Comodo CA Limited +# Label: "Comodo AAA Services root" +# Serial: 1 +# MD5 Fingerprint: 49:79:04:b0:eb:87:19:ac:47:b0:bc:11:51:9b:74:d0 +# SHA1 Fingerprint: d1:eb:23:a4:6d:17:d6:8f:d9:25:64:c2:f1:f1:60:17:64:d8:e3:49 +# SHA256 Fingerprint: d7:a7:a0:fb:5d:7e:27:31:d7:71:e9:48:4e:bc:de:f7:1d:5f:0c:3e:0a:29:48:78:2b:c8:3e:e0:ea:69:9e:f4 +-----BEGIN CERTIFICATE----- +MIIEMjCCAxqgAwIBAgIBATANBgkqhkiG9w0BAQUFADB7MQswCQYDVQQGEwJHQjEb +MBkGA1UECAwSR3JlYXRlciBNYW5jaGVzdGVyMRAwDgYDVQQHDAdTYWxmb3JkMRow +GAYDVQQKDBFDb21vZG8gQ0EgTGltaXRlZDEhMB8GA1UEAwwYQUFBIENlcnRpZmlj +YXRlIFNlcnZpY2VzMB4XDTA0MDEwMTAwMDAwMFoXDTI4MTIzMTIzNTk1OVowezEL +MAkGA1UEBhMCR0IxGzAZBgNVBAgMEkdyZWF0ZXIgTWFuY2hlc3RlcjEQMA4GA1UE +BwwHU2FsZm9yZDEaMBgGA1UECgwRQ29tb2RvIENBIExpbWl0ZWQxITAfBgNVBAMM +GEFBQSBDZXJ0aWZpY2F0ZSBTZXJ2aWNlczCCASIwDQYJKoZIhvcNAQEBBQADggEP +ADCCAQoCggEBAL5AnfRu4ep2hxxNRUSOvkbIgwadwSr+GB+O5AL686tdUIoWMQua +BtDFcCLNSS1UY8y2bmhGC1Pqy0wkwLxyTurxFa70VJoSCsN6sjNg4tqJVfMiWPPe +3M/vg4aijJRPn2jymJBGhCfHdr/jzDUsi14HZGWCwEiwqJH5YZ92IFCokcdmtet4 +YgNW8IoaE+oxox6gmf049vYnMlhvB/VruPsUK6+3qszWY19zjNoFmag4qMsXeDZR +rOme9Hg6jc8P2ULimAyrL58OAd7vn5lJ8S3frHRNG5i1R8XlKdH5kBjHYpy+g8cm +ez6KJcfA3Z3mNWgQIJ2P2N7Sw4ScDV7oL8kCAwEAAaOBwDCBvTAdBgNVHQ4EFgQU +oBEKIz6W8Qfs4q8p74Klf9AwpLQwDgYDVR0PAQH/BAQDAgEGMA8GA1UdEwEB/wQF +MAMBAf8wewYDVR0fBHQwcjA4oDagNIYyaHR0cDovL2NybC5jb21vZG9jYS5jb20v +QUFBQ2VydGlmaWNhdGVTZXJ2aWNlcy5jcmwwNqA0oDKGMGh0dHA6Ly9jcmwuY29t +b2RvLm5ldC9BQUFDZXJ0aWZpY2F0ZVNlcnZpY2VzLmNybDANBgkqhkiG9w0BAQUF +AAOCAQEACFb8AvCb6P+k+tZ7xkSAzk/ExfYAWMymtrwUSWgEdujm7l3sAg9g1o1Q +GE8mTgHj5rCl7r+8dFRBv/38ErjHT1r0iWAFf2C3BUrz9vHCv8S5dIa2LX1rzNLz +Rt0vxuBqw8M0Ayx9lt1awg6nCpnBBYurDC/zXDrPbDdVCYfeU0BsWO/8tqtlbgT2 +G9w84FoVxp7Z8VlIMCFlA2zs6SFz7JsDoeA3raAVGI/6ugLOpyypEBMs1OUIJqsi +l2D4kF501KKaU73yqWjgom7C12yxow+ev+to51byrvLjKzg6CYG1a4XXvi3tPxq3 +smPi9WIsgtRqAEFQ8TmDn5XpNpaYbg== +-----END CERTIFICATE----- + +# Issuer: CN=QuoVadis Root CA 2 O=QuoVadis Limited +# Subject: CN=QuoVadis Root CA 2 O=QuoVadis Limited +# Label: "QuoVadis Root CA 2" +# Serial: 1289 +# MD5 Fingerprint: 5e:39:7b:dd:f8:ba:ec:82:e9:ac:62:ba:0c:54:00:2b +# SHA1 Fingerprint: ca:3a:fb:cf:12:40:36:4b:44:b2:16:20:88:80:48:39:19:93:7c:f7 +# SHA256 Fingerprint: 85:a0:dd:7d:d7:20:ad:b7:ff:05:f8:3d:54:2b:20:9d:c7:ff:45:28:f7:d6:77:b1:83:89:fe:a5:e5:c4:9e:86 +-----BEGIN CERTIFICATE----- +MIIFtzCCA5+gAwIBAgICBQkwDQYJKoZIhvcNAQEFBQAwRTELMAkGA1UEBhMCQk0x +GTAXBgNVBAoTEFF1b1ZhZGlzIExpbWl0ZWQxGzAZBgNVBAMTElF1b1ZhZGlzIFJv +b3QgQ0EgMjAeFw0wNjExMjQxODI3MDBaFw0zMTExMjQxODIzMzNaMEUxCzAJBgNV +BAYTAkJNMRkwFwYDVQQKExBRdW9WYWRpcyBMaW1pdGVkMRswGQYDVQQDExJRdW9W +YWRpcyBSb290IENBIDIwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQCa +GMpLlA0ALa8DKYrwD4HIrkwZhR0In6spRIXzL4GtMh6QRr+jhiYaHv5+HBg6XJxg +Fyo6dIMzMH1hVBHL7avg5tKifvVrbxi3Cgst/ek+7wrGsxDp3MJGF/hd/aTa/55J +WpzmM+Yklvc/ulsrHHo1wtZn/qtmUIttKGAr79dgw8eTvI02kfN/+NsRE8Scd3bB +rrcCaoF6qUWD4gXmuVbBlDePSHFjIuwXZQeVikvfj8ZaCuWw419eaxGrDPmF60Tp ++ARz8un+XJiM9XOva7R+zdRcAitMOeGylZUtQofX1bOQQ7dsE/He3fbE+Ik/0XX1 +ksOR1YqI0JDs3G3eicJlcZaLDQP9nL9bFqyS2+r+eXyt66/3FsvbzSUr5R/7mp/i +Ucw6UwxI5g69ybR2BlLmEROFcmMDBOAENisgGQLodKcftslWZvB1JdxnwQ5hYIiz +PtGo/KPaHbDRsSNU30R2be1B2MGyIrZTHN81Hdyhdyox5C315eXbyOD/5YDXC2Og +/zOhD7osFRXql7PSorW+8oyWHhqPHWykYTe5hnMz15eWniN9gqRMgeKh0bpnX5UH +oycR7hYQe7xFSkyyBNKr79X9DFHOUGoIMfmR2gyPZFwDwzqLID9ujWc9Otb+fVuI +yV77zGHcizN300QyNQliBJIWENieJ0f7OyHj+OsdWwIDAQABo4GwMIGtMA8GA1Ud +EwEB/wQFMAMBAf8wCwYDVR0PBAQDAgEGMB0GA1UdDgQWBBQahGK8SEwzJQTU7tD2 +A8QZRtGUazBuBgNVHSMEZzBlgBQahGK8SEwzJQTU7tD2A8QZRtGUa6FJpEcwRTEL +MAkGA1UEBhMCQk0xGTAXBgNVBAoTEFF1b1ZhZGlzIExpbWl0ZWQxGzAZBgNVBAMT +ElF1b1ZhZGlzIFJvb3QgQ0EgMoICBQkwDQYJKoZIhvcNAQEFBQADggIBAD4KFk2f +BluornFdLwUvZ+YTRYPENvbzwCYMDbVHZF34tHLJRqUDGCdViXh9duqWNIAXINzn +g/iN/Ae42l9NLmeyhP3ZRPx3UIHmfLTJDQtyU/h2BwdBR5YM++CCJpNVjP4iH2Bl +fF/nJrP3MpCYUNQ3cVX2kiF495V5+vgtJodmVjB3pjd4M1IQWK4/YY7yarHvGH5K +WWPKjaJW1acvvFYfzznB4vsKqBUsfU16Y8Zsl0Q80m/DShcK+JDSV6IZUaUtl0Ha +B0+pUNqQjZRG4T7wlP0QADj1O+hA4bRuVhogzG9Yje0uRY/W6ZM/57Es3zrWIozc +hLsib9D45MY56QSIPMO661V6bYCZJPVsAfv4l7CUW+v90m/xd2gNNWQjrLhVoQPR +TUIZ3Ph1WVaj+ahJefivDrkRoHy3au000LYmYjgahwz46P0u05B/B5EqHdZ+XIWD +mbA4CD/pXvk1B+TJYm5Xf6dQlfe6yJvmjqIBxdZmv3lh8zwc4bmCXF2gw+nYSL0Z +ohEUGW6yhhtoPkg3Goi3XZZenMfvJ2II4pEZXNLxId26F0KCl3GBUzGpn/Z9Yr9y +4aOTHcyKJloJONDO1w2AFrR4pTqHTI2KpdVGl/IsELm8VCLAAVBpQ570su9t+Oza +8eOx79+Rj1QqCyXBJhnEUhAFZdWCEOrCMc0u +-----END CERTIFICATE----- + +# Issuer: CN=QuoVadis Root CA 3 O=QuoVadis Limited +# Subject: CN=QuoVadis Root CA 3 O=QuoVadis Limited +# Label: "QuoVadis Root CA 3" +# Serial: 1478 +# MD5 Fingerprint: 31:85:3c:62:94:97:63:b9:aa:fd:89:4e:af:6f:e0:cf +# SHA1 Fingerprint: 1f:49:14:f7:d8:74:95:1d:dd:ae:02:c0:be:fd:3a:2d:82:75:51:85 +# SHA256 Fingerprint: 18:f1:fc:7f:20:5d:f8:ad:dd:eb:7f:e0:07:dd:57:e3:af:37:5a:9c:4d:8d:73:54:6b:f4:f1:fe:d1:e1:8d:35 +-----BEGIN CERTIFICATE----- +MIIGnTCCBIWgAwIBAgICBcYwDQYJKoZIhvcNAQEFBQAwRTELMAkGA1UEBhMCQk0x +GTAXBgNVBAoTEFF1b1ZhZGlzIExpbWl0ZWQxGzAZBgNVBAMTElF1b1ZhZGlzIFJv +b3QgQ0EgMzAeFw0wNjExMjQxOTExMjNaFw0zMTExMjQxOTA2NDRaMEUxCzAJBgNV +BAYTAkJNMRkwFwYDVQQKExBRdW9WYWRpcyBMaW1pdGVkMRswGQYDVQQDExJRdW9W +YWRpcyBSb290IENBIDMwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQDM +V0IWVJzmmNPTTe7+7cefQzlKZbPoFog02w1ZkXTPkrgEQK0CSzGrvI2RaNggDhoB +4hp7Thdd4oq3P5kazethq8Jlph+3t723j/z9cI8LoGe+AaJZz3HmDyl2/7FWeUUr +H556VOijKTVopAFPD6QuN+8bv+OPEKhyq1hX51SGyMnzW9os2l2ObjyjPtr7guXd +8lyyBTNvijbO0BNO/79KDDRMpsMhvVAEVeuxu537RR5kFd5VAYwCdrXLoT9Cabwv +vWhDFlaJKjdhkf2mrk7AyxRllDdLkgbvBNDInIjbC3uBr7E9KsRlOni27tyAsdLT +mZw67mtaa7ONt9XOnMK+pUsvFrGeaDsGb659n/je7Mwpp5ijJUMv7/FfJuGITfhe +btfZFG4ZM2mnO4SJk8RTVROhUXhA+LjJou57ulJCg54U7QVSWllWp5f8nT8KKdjc +T5EOE7zelaTfi5m+rJsziO+1ga8bxiJTyPbH7pcUsMV8eFLI8M5ud2CEpukqdiDt +WAEXMJPpGovgc2PZapKUSU60rUqFxKMiMPwJ7Wgic6aIDFUhWMXhOp8q3crhkODZ +c6tsgLjoC2SToJyMGf+z0gzskSaHirOi4XCPLArlzW1oUevaPwV/izLmE1xr/l9A +4iLItLRkT9a6fUg+qGkM17uGcclzuD87nSVL2v9A6wIDAQABo4IBlTCCAZEwDwYD +VR0TAQH/BAUwAwEB/zCB4QYDVR0gBIHZMIHWMIHTBgkrBgEEAb5YAAMwgcUwgZMG +CCsGAQUFBwICMIGGGoGDQW55IHVzZSBvZiB0aGlzIENlcnRpZmljYXRlIGNvbnN0 +aXR1dGVzIGFjY2VwdGFuY2Ugb2YgdGhlIFF1b1ZhZGlzIFJvb3QgQ0EgMyBDZXJ0 +aWZpY2F0ZSBQb2xpY3kgLyBDZXJ0aWZpY2F0aW9uIFByYWN0aWNlIFN0YXRlbWVu +dC4wLQYIKwYBBQUHAgEWIWh0dHA6Ly93d3cucXVvdmFkaXNnbG9iYWwuY29tL2Nw +czALBgNVHQ8EBAMCAQYwHQYDVR0OBBYEFPLAE+CCQz777i9nMpY1XNu4ywLQMG4G +A1UdIwRnMGWAFPLAE+CCQz777i9nMpY1XNu4ywLQoUmkRzBFMQswCQYDVQQGEwJC +TTEZMBcGA1UEChMQUXVvVmFkaXMgTGltaXRlZDEbMBkGA1UEAxMSUXVvVmFkaXMg +Um9vdCBDQSAzggIFxjANBgkqhkiG9w0BAQUFAAOCAgEAT62gLEz6wPJv92ZVqyM0 +7ucp2sNbtrCD2dDQ4iH782CnO11gUyeim/YIIirnv6By5ZwkajGxkHon24QRiSem +d1o417+shvzuXYO8BsbRd2sPbSQvS3pspweWyuOEn62Iix2rFo1bZhfZFvSLgNLd ++LJ2w/w4E6oM3kJpK27zPOuAJ9v1pkQNn1pVWQvVDVJIxa6f8i+AxeoyUDUSly7B +4f/xI4hROJ/yZlZ25w9Rl6VSDE1JUZU2Pb+iSwwQHYaZTKrzchGT5Or2m9qoXadN +t54CrnMAyNojA+j56hl0YgCUyyIgvpSnWbWCar6ZeXqp8kokUvd0/bpO5qgdAm6x +DYBEwa7TIzdfu4V8K5Iu6H6li92Z4b8nby1dqnuH/grdS/yO9SbkbnBCbjPsMZ57 +k8HkyWkaPcBrTiJt7qtYTcbQQcEr6k8Sh17rRdhs9ZgC06DYVYoGmRmioHfRMJ6s +zHXug/WwYjnPbFfiTNKRCw51KBuav/0aQ/HKd/s7j2G4aSgWQgRecCocIdiP4b0j +Wy10QJLZYxkNc91pvGJHvOB0K7Lrfb5BG7XARsWhIstfTsEokt4YutUqKLsRixeT +mJlglFwjz1onl14LBQaTNx47aTbrqZ5hHY8y2o4M1nQ+ewkk2gF3R8Q7zTSMmfXK +4SVhM7JZG+Ju1zdXtg2pEto= +-----END CERTIFICATE----- + +# Issuer: CN=XRamp Global Certification Authority O=XRamp Security Services Inc OU=www.xrampsecurity.com +# Subject: CN=XRamp Global Certification Authority O=XRamp Security Services Inc OU=www.xrampsecurity.com +# Label: "XRamp Global CA Root" +# Serial: 107108908803651509692980124233745014957 +# MD5 Fingerprint: a1:0b:44:b3:ca:10:d8:00:6e:9d:0f:d8:0f:92:0a:d1 +# SHA1 Fingerprint: b8:01:86:d1:eb:9c:86:a5:41:04:cf:30:54:f3:4c:52:b7:e5:58:c6 +# SHA256 Fingerprint: ce:cd:dc:90:50:99:d8:da:df:c5:b1:d2:09:b7:37:cb:e2:c1:8c:fb:2c:10:c0:ff:0b:cf:0d:32:86:fc:1a:a2 +-----BEGIN CERTIFICATE----- +MIIEMDCCAxigAwIBAgIQUJRs7Bjq1ZxN1ZfvdY+grTANBgkqhkiG9w0BAQUFADCB +gjELMAkGA1UEBhMCVVMxHjAcBgNVBAsTFXd3dy54cmFtcHNlY3VyaXR5LmNvbTEk +MCIGA1UEChMbWFJhbXAgU2VjdXJpdHkgU2VydmljZXMgSW5jMS0wKwYDVQQDEyRY +UmFtcCBHbG9iYWwgQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkwHhcNMDQxMTAxMTcx +NDA0WhcNMzUwMTAxMDUzNzE5WjCBgjELMAkGA1UEBhMCVVMxHjAcBgNVBAsTFXd3 +dy54cmFtcHNlY3VyaXR5LmNvbTEkMCIGA1UEChMbWFJhbXAgU2VjdXJpdHkgU2Vy +dmljZXMgSW5jMS0wKwYDVQQDEyRYUmFtcCBHbG9iYWwgQ2VydGlmaWNhdGlvbiBB +dXRob3JpdHkwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQCYJB69FbS6 +38eMpSe2OAtp87ZOqCwuIR1cRN8hXX4jdP5efrRKt6atH67gBhbim1vZZ3RrXYCP +KZ2GG9mcDZhtdhAoWORlsH9KmHmf4MMxfoArtYzAQDsRhtDLooY2YKTVMIJt2W7Q +DxIEM5dfT2Fa8OT5kavnHTu86M/0ay00fOJIYRyO82FEzG+gSqmUsE3a56k0enI4 +qEHMPJQRfevIpoy3hsvKMzvZPTeL+3o+hiznc9cKV6xkmxnr9A8ECIqsAxcZZPRa +JSKNNCyy9mgdEm3Tih4U2sSPpuIjhdV6Db1q4Ons7Be7QhtnqiXtRYMh/MHJfNVi +PvryxS3T/dRlAgMBAAGjgZ8wgZwwEwYJKwYBBAGCNxQCBAYeBABDAEEwCwYDVR0P +BAQDAgGGMA8GA1UdEwEB/wQFMAMBAf8wHQYDVR0OBBYEFMZPoj0GY4QJnM5i5ASs +jVy16bYbMDYGA1UdHwQvMC0wK6ApoCeGJWh0dHA6Ly9jcmwueHJhbXBzZWN1cml0 +eS5jb20vWEdDQS5jcmwwEAYJKwYBBAGCNxUBBAMCAQEwDQYJKoZIhvcNAQEFBQAD +ggEBAJEVOQMBG2f7Shz5CmBbodpNl2L5JFMn14JkTpAuw0kbK5rc/Kh4ZzXxHfAR +vbdI4xD2Dd8/0sm2qlWkSLoC295ZLhVbO50WfUfXN+pfTXYSNrsf16GBBEYgoyxt +qZ4Bfj8pzgCT3/3JknOJiWSe5yvkHJEs0rnOfc5vMZnT5r7SHpDwCRR5XCOrTdLa +IR9NmXmd4c8nnxCbHIgNsIpkQTG4DmyQJKSbXHGPurt+HBvbaoAPIbzp26a3QPSy +i6mx5O+aGtA9aZnuqCij4Tyz8LIRnM98QObd50N9otg6tamN8jSZxNQQ4Qb9CYQQ +O+7ETPTsJ3xCwnR8gooJybQDJbw= +-----END CERTIFICATE----- + +# Issuer: O=The Go Daddy Group, Inc. OU=Go Daddy Class 2 Certification Authority +# Subject: O=The Go Daddy Group, Inc. OU=Go Daddy Class 2 Certification Authority +# Label: "Go Daddy Class 2 CA" +# Serial: 0 +# MD5 Fingerprint: 91:de:06:25:ab:da:fd:32:17:0c:bb:25:17:2a:84:67 +# SHA1 Fingerprint: 27:96:ba:e6:3f:18:01:e2:77:26:1b:a0:d7:77:70:02:8f:20:ee:e4 +# SHA256 Fingerprint: c3:84:6b:f2:4b:9e:93:ca:64:27:4c:0e:c6:7c:1e:cc:5e:02:4f:fc:ac:d2:d7:40:19:35:0e:81:fe:54:6a:e4 +-----BEGIN CERTIFICATE----- +MIIEADCCAuigAwIBAgIBADANBgkqhkiG9w0BAQUFADBjMQswCQYDVQQGEwJVUzEh +MB8GA1UEChMYVGhlIEdvIERhZGR5IEdyb3VwLCBJbmMuMTEwLwYDVQQLEyhHbyBE +YWRkeSBDbGFzcyAyIENlcnRpZmljYXRpb24gQXV0aG9yaXR5MB4XDTA0MDYyOTE3 +MDYyMFoXDTM0MDYyOTE3MDYyMFowYzELMAkGA1UEBhMCVVMxITAfBgNVBAoTGFRo +ZSBHbyBEYWRkeSBHcm91cCwgSW5jLjExMC8GA1UECxMoR28gRGFkZHkgQ2xhc3Mg +MiBDZXJ0aWZpY2F0aW9uIEF1dGhvcml0eTCCASAwDQYJKoZIhvcNAQEBBQADggEN +ADCCAQgCggEBAN6d1+pXGEmhW+vXX0iG6r7d/+TvZxz0ZWizV3GgXne77ZtJ6XCA +PVYYYwhv2vLM0D9/AlQiVBDYsoHUwHU9S3/Hd8M+eKsaA7Ugay9qK7HFiH7Eux6w +wdhFJ2+qN1j3hybX2C32qRe3H3I2TqYXP2WYktsqbl2i/ojgC95/5Y0V4evLOtXi +EqITLdiOr18SPaAIBQi2XKVlOARFmR6jYGB0xUGlcmIbYsUfb18aQr4CUWWoriMY +avx4A6lNf4DD+qta/KFApMoZFv6yyO9ecw3ud72a9nmYvLEHZ6IVDd2gWMZEewo+ +YihfukEHU1jPEX44dMX4/7VpkI+EdOqXG68CAQOjgcAwgb0wHQYDVR0OBBYEFNLE +sNKR1EwRcbNhyz2h/t2oatTjMIGNBgNVHSMEgYUwgYKAFNLEsNKR1EwRcbNhyz2h +/t2oatTjoWekZTBjMQswCQYDVQQGEwJVUzEhMB8GA1UEChMYVGhlIEdvIERhZGR5 +IEdyb3VwLCBJbmMuMTEwLwYDVQQLEyhHbyBEYWRkeSBDbGFzcyAyIENlcnRpZmlj +YXRpb24gQXV0aG9yaXR5ggEAMAwGA1UdEwQFMAMBAf8wDQYJKoZIhvcNAQEFBQAD +ggEBADJL87LKPpH8EsahB4yOd6AzBhRckB4Y9wimPQoZ+YeAEW5p5JYXMP80kWNy +OO7MHAGjHZQopDH2esRU1/blMVgDoszOYtuURXO1v0XJJLXVggKtI3lpjbi2Tc7P +TMozI+gciKqdi0FuFskg5YmezTvacPd+mSYgFFQlq25zheabIZ0KbIIOqPjCDPoQ +HmyW74cNxA9hi63ugyuV+I6ShHI56yDqg+2DzZduCLzrTia2cyvk0/ZM/iZx4mER +dEr/VxqHD3VILs9RaRegAhJhldXRQLIQTO7ErBBDpqWeCtWVYpoNz4iCxTIM5Cuf +ReYNnyicsbkqWletNw+vHX/bvZ8= +-----END CERTIFICATE----- + +# Issuer: O=Starfield Technologies, Inc. OU=Starfield Class 2 Certification Authority +# Subject: O=Starfield Technologies, Inc. OU=Starfield Class 2 Certification Authority +# Label: "Starfield Class 2 CA" +# Serial: 0 +# MD5 Fingerprint: 32:4a:4b:bb:c8:63:69:9b:be:74:9a:c6:dd:1d:46:24 +# SHA1 Fingerprint: ad:7e:1c:28:b0:64:ef:8f:60:03:40:20:14:c3:d0:e3:37:0e:b5:8a +# SHA256 Fingerprint: 14:65:fa:20:53:97:b8:76:fa:a6:f0:a9:95:8e:55:90:e4:0f:cc:7f:aa:4f:b7:c2:c8:67:75:21:fb:5f:b6:58 +-----BEGIN CERTIFICATE----- +MIIEDzCCAvegAwIBAgIBADANBgkqhkiG9w0BAQUFADBoMQswCQYDVQQGEwJVUzEl +MCMGA1UEChMcU3RhcmZpZWxkIFRlY2hub2xvZ2llcywgSW5jLjEyMDAGA1UECxMp +U3RhcmZpZWxkIENsYXNzIDIgQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkwHhcNMDQw +NjI5MTczOTE2WhcNMzQwNjI5MTczOTE2WjBoMQswCQYDVQQGEwJVUzElMCMGA1UE +ChMcU3RhcmZpZWxkIFRlY2hub2xvZ2llcywgSW5jLjEyMDAGA1UECxMpU3RhcmZp +ZWxkIENsYXNzIDIgQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkwggEgMA0GCSqGSIb3 +DQEBAQUAA4IBDQAwggEIAoIBAQC3Msj+6XGmBIWtDBFk385N78gDGIc/oav7PKaf +8MOh2tTYbitTkPskpD6E8J7oX+zlJ0T1KKY/e97gKvDIr1MvnsoFAZMej2YcOadN ++lq2cwQlZut3f+dZxkqZJRRU6ybH838Z1TBwj6+wRir/resp7defqgSHo9T5iaU0 +X9tDkYI22WY8sbi5gv2cOj4QyDvvBmVmepsZGD3/cVE8MC5fvj13c7JdBmzDI1aa +K4UmkhynArPkPw2vCHmCuDY96pzTNbO8acr1zJ3o/WSNF4Azbl5KXZnJHoe0nRrA +1W4TNSNe35tfPe/W93bC6j67eA0cQmdrBNj41tpvi/JEoAGrAgEDo4HFMIHCMB0G +A1UdDgQWBBS/X7fRzt0fhvRbVazc1xDCDqmI5zCBkgYDVR0jBIGKMIGHgBS/X7fR +zt0fhvRbVazc1xDCDqmI56FspGowaDELMAkGA1UEBhMCVVMxJTAjBgNVBAoTHFN0 +YXJmaWVsZCBUZWNobm9sb2dpZXMsIEluYy4xMjAwBgNVBAsTKVN0YXJmaWVsZCBD +bGFzcyAyIENlcnRpZmljYXRpb24gQXV0aG9yaXR5ggEAMAwGA1UdEwQFMAMBAf8w +DQYJKoZIhvcNAQEFBQADggEBAAWdP4id0ckaVaGsafPzWdqbAYcaT1epoXkJKtv3 +L7IezMdeatiDh6GX70k1PncGQVhiv45YuApnP+yz3SFmH8lU+nLMPUxA2IGvd56D +eruix/U0F47ZEUD0/CwqTRV/p2JdLiXTAAsgGh1o+Re49L2L7ShZ3U0WixeDyLJl +xy16paq8U4Zt3VekyvggQQto8PT7dL5WXXp59fkdheMtlb71cZBDzI0fmgAKhynp +VSJYACPq4xJDKVtHCN2MQWplBqjlIapBtJUhlbl90TSrE9atvNziPTnNvT51cKEY +WQPJIrSPnNVeKtelttQKbfi3QBFGmh95DmK/D5fs4C8fF5Q= +-----END CERTIFICATE----- + +# Issuer: CN=DigiCert Assured ID Root CA O=DigiCert Inc OU=www.digicert.com +# Subject: CN=DigiCert Assured ID Root CA O=DigiCert Inc OU=www.digicert.com +# Label: "DigiCert Assured ID Root CA" +# Serial: 17154717934120587862167794914071425081 +# MD5 Fingerprint: 87:ce:0b:7b:2a:0e:49:00:e1:58:71:9b:37:a8:93:72 +# SHA1 Fingerprint: 05:63:b8:63:0d:62:d7:5a:bb:c8:ab:1e:4b:df:b5:a8:99:b2:4d:43 +# SHA256 Fingerprint: 3e:90:99:b5:01:5e:8f:48:6c:00:bc:ea:9d:11:1e:e7:21:fa:ba:35:5a:89:bc:f1:df:69:56:1e:3d:c6:32:5c +-----BEGIN CERTIFICATE----- +MIIDtzCCAp+gAwIBAgIQDOfg5RfYRv6P5WD8G/AwOTANBgkqhkiG9w0BAQUFADBl +MQswCQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3 +d3cuZGlnaWNlcnQuY29tMSQwIgYDVQQDExtEaWdpQ2VydCBBc3N1cmVkIElEIFJv +b3QgQ0EwHhcNMDYxMTEwMDAwMDAwWhcNMzExMTEwMDAwMDAwWjBlMQswCQYDVQQG +EwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3d3cuZGlnaWNl +cnQuY29tMSQwIgYDVQQDExtEaWdpQ2VydCBBc3N1cmVkIElEIFJvb3QgQ0EwggEi +MA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQCtDhXO5EOAXLGH87dg+XESpa7c +JpSIqvTO9SA5KFhgDPiA2qkVlTJhPLWxKISKityfCgyDF3qPkKyK53lTXDGEKvYP +mDI2dsze3Tyoou9q+yHyUmHfnyDXH+Kx2f4YZNISW1/5WBg1vEfNoTb5a3/UsDg+ +wRvDjDPZ2C8Y/igPs6eD1sNuRMBhNZYW/lmci3Zt1/GiSw0r/wty2p5g0I6QNcZ4 +VYcgoc/lbQrISXwxmDNsIumH0DJaoroTghHtORedmTpyoeb6pNnVFzF1roV9Iq4/ +AUaG9ih5yLHa5FcXxH4cDrC0kqZWs72yl+2qp/C3xag/lRbQ/6GW6whfGHdPAgMB +AAGjYzBhMA4GA1UdDwEB/wQEAwIBhjAPBgNVHRMBAf8EBTADAQH/MB0GA1UdDgQW +BBRF66Kv9JLLgjEtUYunpyGd823IDzAfBgNVHSMEGDAWgBRF66Kv9JLLgjEtUYun +pyGd823IDzANBgkqhkiG9w0BAQUFAAOCAQEAog683+Lt8ONyc3pklL/3cmbYMuRC +dWKuh+vy1dneVrOfzM4UKLkNl2BcEkxY5NM9g0lFWJc1aRqoR+pWxnmrEthngYTf +fwk8lOa4JiwgvT2zKIn3X/8i4peEH+ll74fg38FnSbNd67IJKusm7Xi+fT8r87cm +NW1fiQG2SVufAQWbqz0lwcy2f8Lxb4bG+mRo64EtlOtCt/qMHt1i8b5QZ7dsvfPx +H2sMNgcWfzd8qVttevESRmCD1ycEvkvOl77DZypoEd+A5wwzZr8TDRRu838fYxAe ++o0bJW1sj6W3YQGx0qMmoRBxna3iw/nDmVG3KwcIzi7mULKn+gpFL6Lw8g== +-----END CERTIFICATE----- + +# Issuer: CN=DigiCert Global Root CA O=DigiCert Inc OU=www.digicert.com +# Subject: CN=DigiCert Global Root CA O=DigiCert Inc OU=www.digicert.com +# Label: "DigiCert Global Root CA" +# Serial: 10944719598952040374951832963794454346 +# MD5 Fingerprint: 79:e4:a9:84:0d:7d:3a:96:d7:c0:4f:e2:43:4c:89:2e +# SHA1 Fingerprint: a8:98:5d:3a:65:e5:e5:c4:b2:d7:d6:6d:40:c6:dd:2f:b1:9c:54:36 +# SHA256 Fingerprint: 43:48:a0:e9:44:4c:78:cb:26:5e:05:8d:5e:89:44:b4:d8:4f:96:62:bd:26:db:25:7f:89:34:a4:43:c7:01:61 +-----BEGIN CERTIFICATE----- +MIIDrzCCApegAwIBAgIQCDvgVpBCRrGhdWrJWZHHSjANBgkqhkiG9w0BAQUFADBh +MQswCQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3 +d3cuZGlnaWNlcnQuY29tMSAwHgYDVQQDExdEaWdpQ2VydCBHbG9iYWwgUm9vdCBD +QTAeFw0wNjExMTAwMDAwMDBaFw0zMTExMTAwMDAwMDBaMGExCzAJBgNVBAYTAlVT +MRUwEwYDVQQKEwxEaWdpQ2VydCBJbmMxGTAXBgNVBAsTEHd3dy5kaWdpY2VydC5j +b20xIDAeBgNVBAMTF0RpZ2lDZXJ0IEdsb2JhbCBSb290IENBMIIBIjANBgkqhkiG +9w0BAQEFAAOCAQ8AMIIBCgKCAQEA4jvhEXLeqKTTo1eqUKKPC3eQyaKl7hLOllsB +CSDMAZOnTjC3U/dDxGkAV53ijSLdhwZAAIEJzs4bg7/fzTtxRuLWZscFs3YnFo97 +nh6Vfe63SKMI2tavegw5BmV/Sl0fvBf4q77uKNd0f3p4mVmFaG5cIzJLv07A6Fpt +43C/dxC//AH2hdmoRBBYMql1GNXRor5H4idq9Joz+EkIYIvUX7Q6hL+hqkpMfT7P +T19sdl6gSzeRntwi5m3OFBqOasv+zbMUZBfHWymeMr/y7vrTC0LUq7dBMtoM1O/4 +gdW7jVg/tRvoSSiicNoxBN33shbyTApOB6jtSj1etX+jkMOvJwIDAQABo2MwYTAO +BgNVHQ8BAf8EBAMCAYYwDwYDVR0TAQH/BAUwAwEB/zAdBgNVHQ4EFgQUA95QNVbR +TLtm8KPiGxvDl7I90VUwHwYDVR0jBBgwFoAUA95QNVbRTLtm8KPiGxvDl7I90VUw +DQYJKoZIhvcNAQEFBQADggEBAMucN6pIExIK+t1EnE9SsPTfrgT1eXkIoyQY/Esr +hMAtudXH/vTBH1jLuG2cenTnmCmrEbXjcKChzUyImZOMkXDiqw8cvpOp/2PV5Adg +06O/nVsJ8dWO41P0jmP6P6fbtGbfYmbW0W5BjfIttep3Sp+dWOIrWcBAI+0tKIJF +PnlUkiaY4IBIqDfv8NZ5YBberOgOzW6sRBc4L0na4UU+Krk2U886UAb3LujEV0ls +YSEY1QSteDwsOoBrp+uvFRTp2InBuThs4pFsiv9kuXclVzDAGySj4dzp30d8tbQk +CAUw7C29C79Fv1C5qfPrmAESrciIxpg0X40KPMbp1ZWVbd4= +-----END CERTIFICATE----- + +# Issuer: CN=DigiCert High Assurance EV Root CA O=DigiCert Inc OU=www.digicert.com +# Subject: CN=DigiCert High Assurance EV Root CA O=DigiCert Inc OU=www.digicert.com +# Label: "DigiCert High Assurance EV Root CA" +# Serial: 3553400076410547919724730734378100087 +# MD5 Fingerprint: d4:74:de:57:5c:39:b2:d3:9c:85:83:c5:c0:65:49:8a +# SHA1 Fingerprint: 5f:b7:ee:06:33:e2:59:db:ad:0c:4c:9a:e6:d3:8f:1a:61:c7:dc:25 +# SHA256 Fingerprint: 74:31:e5:f4:c3:c1:ce:46:90:77:4f:0b:61:e0:54:40:88:3b:a9:a0:1e:d0:0b:a6:ab:d7:80:6e:d3:b1:18:cf +-----BEGIN CERTIFICATE----- +MIIDxTCCAq2gAwIBAgIQAqxcJmoLQJuPC3nyrkYldzANBgkqhkiG9w0BAQUFADBs +MQswCQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3 +d3cuZGlnaWNlcnQuY29tMSswKQYDVQQDEyJEaWdpQ2VydCBIaWdoIEFzc3VyYW5j +ZSBFViBSb290IENBMB4XDTA2MTExMDAwMDAwMFoXDTMxMTExMDAwMDAwMFowbDEL +MAkGA1UEBhMCVVMxFTATBgNVBAoTDERpZ2lDZXJ0IEluYzEZMBcGA1UECxMQd3d3 +LmRpZ2ljZXJ0LmNvbTErMCkGA1UEAxMiRGlnaUNlcnQgSGlnaCBBc3N1cmFuY2Ug +RVYgUm9vdCBDQTCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAMbM5XPm ++9S75S0tMqbf5YE/yc0lSbZxKsPVlDRnogocsF9ppkCxxLeyj9CYpKlBWTrT3JTW +PNt0OKRKzE0lgvdKpVMSOO7zSW1xkX5jtqumX8OkhPhPYlG++MXs2ziS4wblCJEM +xChBVfvLWokVfnHoNb9Ncgk9vjo4UFt3MRuNs8ckRZqnrG0AFFoEt7oT61EKmEFB +Ik5lYYeBQVCmeVyJ3hlKV9Uu5l0cUyx+mM0aBhakaHPQNAQTXKFx01p8VdteZOE3 +hzBWBOURtCmAEvF5OYiiAhF8J2a3iLd48soKqDirCmTCv2ZdlYTBoSUeh10aUAsg +EsxBu24LUTi4S8sCAwEAAaNjMGEwDgYDVR0PAQH/BAQDAgGGMA8GA1UdEwEB/wQF +MAMBAf8wHQYDVR0OBBYEFLE+w2kD+L9HAdSYJhoIAu9jZCvDMB8GA1UdIwQYMBaA +FLE+w2kD+L9HAdSYJhoIAu9jZCvDMA0GCSqGSIb3DQEBBQUAA4IBAQAcGgaX3Nec +nzyIZgYIVyHbIUf4KmeqvxgydkAQV8GK83rZEWWONfqe/EW1ntlMMUu4kehDLI6z +eM7b41N5cdblIZQB2lWHmiRk9opmzN6cN82oNLFpmyPInngiK3BD41VHMWEZ71jF +hS9OMPagMRYjyOfiZRYzy78aG6A9+MpeizGLYAiJLQwGXFK3xPkKmNEVX58Svnw2 +Yzi9RKR/5CYrCsSXaQ3pjOLAEFe4yHYSkVXySGnYvCoCWw9E1CAx2/S6cCZdkGCe +vEsXCS+0yx5DaMkHJ8HSXPfqIbloEpw8nL+e/IBcm2PN7EeqJSdnoDfzAIJ9VNep ++OkuE6N36B9K +-----END CERTIFICATE----- + +# Issuer: CN=SwissSign Gold CA - G2 O=SwissSign AG +# Subject: CN=SwissSign Gold CA - G2 O=SwissSign AG +# Label: "SwissSign Gold CA - G2" +# Serial: 13492815561806991280 +# MD5 Fingerprint: 24:77:d9:a8:91:d1:3b:fa:88:2d:c2:ff:f8:cd:33:93 +# SHA1 Fingerprint: d8:c5:38:8a:b7:30:1b:1b:6e:d4:7a:e6:45:25:3a:6f:9f:1a:27:61 +# SHA256 Fingerprint: 62:dd:0b:e9:b9:f5:0a:16:3e:a0:f8:e7:5c:05:3b:1e:ca:57:ea:55:c8:68:8f:64:7c:68:81:f2:c8:35:7b:95 +-----BEGIN CERTIFICATE----- +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=SwissSign Silver CA - G2 O=SwissSign AG +# Subject: CN=SwissSign Silver CA - G2 O=SwissSign AG +# Label: "SwissSign Silver CA - G2" +# Serial: 5700383053117599563 +# MD5 Fingerprint: e0:06:a1:c9:7d:cf:c9:fc:0d:c0:56:75:96:d8:62:13 +# SHA1 Fingerprint: 9b:aa:e5:9f:56:ee:21:cb:43:5a:be:25:93:df:a7:f0:40:d1:1d:cb +# SHA256 Fingerprint: be:6c:4d:a2:bb:b9:ba:59:b6:f3:93:97:68:37:42:46:c3:c0:05:99:3f:a9:8f:02:0d:1d:ed:be:d4:8a:81:d5 +-----BEGIN CERTIFICATE----- +MIIFvTCCA6WgAwIBAgIITxvUL1S7L0swDQYJKoZIhvcNAQEFBQAwRzELMAkGA1UE +BhMCQ0gxFTATBgNVBAoTDFN3aXNzU2lnbiBBRzEhMB8GA1UEAxMYU3dpc3NTaWdu +IFNpbHZlciBDQSAtIEcyMB4XDTA2MTAyNTA4MzI0NloXDTM2MTAyNTA4MzI0Nlow +RzELMAkGA1UEBhMCQ0gxFTATBgNVBAoTDFN3aXNzU2lnbiBBRzEhMB8GA1UEAxMY +U3dpc3NTaWduIFNpbHZlciBDQSAtIEcyMIICIjANBgkqhkiG9w0BAQEFAAOCAg8A +MIICCgKCAgEAxPGHf9N4Mfc4yfjDmUO8x/e8N+dOcbpLj6VzHVxumK4DV644N0Mv +Fz0fyM5oEMF4rhkDKxD6LHmD9ui5aLlV8gREpzn5/ASLHvGiTSf5YXu6t+WiE7br +YT7QbNHm+/pe7R20nqA1W6GSy/BJkv6FCgU+5tkL4k+73JU3/JHpMjUi0R86TieF +nbAVlDLaYQ1HTWBCrpJH6INaUFjpiou5XaHc3ZlKHzZnu0jkg7Y360g6rw9njxcH +6ATK72oxh9TAtvmUcXtnZLi2kUpCe2UuMGoM9ZDulebyzYLs2aFK7PayS+VFheZt +eJMELpyCbTapxDFkH4aDCyr0NQp4yVXPQbBH6TCfmb5hqAaEuSh6XzjZG6k4sIN/ +c8HDO0gqgg8hm7jMqDXDhBuDsz6+pJVpATqJAHgE2cn0mRmrVn5bi4Y5FZGkECwJ +MoBgs5PAKrYYC51+jUnyEEp/+dVGLxmSo5mnJqy7jDzmDrxHB9xzUfFwZC8I+bRH +HTBsROopN4WSaGa8gzj+ezku01DwH/teYLappvonQfGbGHLy9YR0SslnxFSuSGTf +jNFusB3hB48IHpmccelM2KX3RxIfdNFRnobzwqIjQAtz20um53MGjMGg6cFZrEb6 +5i/4z3GcRm25xBWNOHkDRUjvxF3XCO6HOSKGsg0PWEP3calILv3q1h8CAwEAAaOB +rDCBqTAOBgNVHQ8BAf8EBAMCAQYwDwYDVR0TAQH/BAUwAwEB/zAdBgNVHQ4EFgQU +F6DNweRBtjpbO8tFnb0cwpj6hlgwHwYDVR0jBBgwFoAUF6DNweRBtjpbO8tFnb0c +wpj6hlgwRgYDVR0gBD8wPTA7BglghXQBWQEDAQEwLjAsBggrBgEFBQcCARYgaHR0 +cDovL3JlcG9zaXRvcnkuc3dpc3NzaWduLmNvbS8wDQYJKoZIhvcNAQEFBQADggIB +AHPGgeAn0i0P4JUw4ppBf1AsX19iYamGamkYDHRJ1l2E6kFSGG9YrVBWIGrGvShp +WJHckRE1qTodvBqlYJ7YH39FkWnZfrt4csEGDyrOj4VwYaygzQu4OSlWhDJOhrs9 +xCrZ1x9y7v5RoSJBsXECYxqCsGKrXlcSH9/L3XWgwF15kIwb4FDm3jH+mHtwX6WQ +2K34ArZv02DdQEsixT2tOnqfGhpHkXkzuoLcMmkDlm4fS/Bx/uNncqCxv1yL5PqZ +IseEuRuNI5c/7SXgz2W79WEE790eslpBIlqhn10s6FvJbakMDHiqYMZWjwFaDGi8 +aRl5xB9+lwW/xekkUV7U1UtT7dkjWjYDZaPBA61BMPNGG4WQr2W11bHkFlt4dR2X +em1ZqSqPe97Dh4kQmUlzeMg9vVE1dCrV8X5pGyq7O70luJpaPXJhkGaH7gzWTdQR +dAtq/gsD/KNVV4n+SsuuWxcFyPKNIzFTONItaj+CuY0IavdeQXRuwxF+B6wpYJE/ +OMpXEA29MC/HpeZBoNquBYeaoKRlbEwJDIm6uNO5wJOKMPqN5ZprFQFOZ6raYlY+ +hAhm0sQ2fac+EPyI4NSA5QC9qvNOBqN6avlicuMJT+ubDgEj8Z+7fNzcbBGXJbLy +tGMU0gYqZ4yD9c7qB9iaah7s5Aq7KkzrCWA5zspi2C5u +-----END CERTIFICATE----- + +# Issuer: CN=SecureTrust CA O=SecureTrust Corporation +# Subject: CN=SecureTrust CA O=SecureTrust Corporation +# Label: "SecureTrust CA" +# Serial: 17199774589125277788362757014266862032 +# MD5 Fingerprint: dc:32:c3:a7:6d:25:57:c7:68:09:9d:ea:2d:a9:a2:d1 +# SHA1 Fingerprint: 87:82:c6:c3:04:35:3b:cf:d2:96:92:d2:59:3e:7d:44:d9:34:ff:11 +# SHA256 Fingerprint: f1:c1:b5:0a:e5:a2:0d:d8:03:0e:c9:f6:bc:24:82:3d:d3:67:b5:25:57:59:b4:e7:1b:61:fc:e9:f7:37:5d:73 +-----BEGIN CERTIFICATE----- +MIIDuDCCAqCgAwIBAgIQDPCOXAgWpa1Cf/DrJxhZ0DANBgkqhkiG9w0BAQUFADBI +MQswCQYDVQQGEwJVUzEgMB4GA1UEChMXU2VjdXJlVHJ1c3QgQ29ycG9yYXRpb24x +FzAVBgNVBAMTDlNlY3VyZVRydXN0IENBMB4XDTA2MTEwNzE5MzExOFoXDTI5MTIz +MTE5NDA1NVowSDELMAkGA1UEBhMCVVMxIDAeBgNVBAoTF1NlY3VyZVRydXN0IENv +cnBvcmF0aW9uMRcwFQYDVQQDEw5TZWN1cmVUcnVzdCBDQTCCASIwDQYJKoZIhvcN +AQEBBQADggEPADCCAQoCggEBAKukgeWVzfX2FI7CT8rU4niVWJxB4Q2ZQCQXOZEz +Zum+4YOvYlyJ0fwkW2Gz4BERQRwdbvC4u/jep4G6pkjGnx29vo6pQT64lO0pGtSO +0gMdA+9tDWccV9cGrcrI9f4Or2YlSASWC12juhbDCE/RRvgUXPLIXgGZbf2IzIao +wW8xQmxSPmjL8xk037uHGFaAJsTQ3MBv396gwpEWoGQRS0S8Hvbn+mPeZqx2pHGj +7DaUaHp3pLHnDi+BeuK1cobvomuL8A/b01k/unK8RCSc43Oz969XL0Imnal0ugBS +8kvNU3xHCzaFDmapCJcWNFfBZveA4+1wVMeT4C4oFVmHursCAwEAAaOBnTCBmjAT +BgkrBgEEAYI3FAIEBh4EAEMAQTALBgNVHQ8EBAMCAYYwDwYDVR0TAQH/BAUwAwEB +/zAdBgNVHQ4EFgQUQjK2FvoE/f5dS3rD/fdMQB1aQ68wNAYDVR0fBC0wKzApoCeg +JYYjaHR0cDovL2NybC5zZWN1cmV0cnVzdC5jb20vU1RDQS5jcmwwEAYJKwYBBAGC +NxUBBAMCAQAwDQYJKoZIhvcNAQEFBQADggEBADDtT0rhWDpSclu1pqNlGKa7UTt3 +6Z3q059c4EVlew3KW+JwULKUBRSuSceNQQcSc5R+DCMh/bwQf2AQWnL1mA6s7Ll/ +3XpvXdMc9P+IBWlCqQVxyLesJugutIxq/3HcuLHfmbx8IVQr5Fiiu1cprp6poxkm +D5kuCLDv/WnPmRoJjeOnnyvJNjR7JLN4TJUXpAYmHrZkUjZfYGfZnMUFdAvnZyPS +CPyI6a6Lf+Ew9Dd+/cYy2i2eRDAwbO4H3tI0/NL/QPZL9GZGBlSm8jIKYyYwa5vR +3ItHuuG51WLQoqD0ZwV4KWMabwTW+MZMo5qxN7SN5ShLHZ4swrhovO0C7jE= +-----END CERTIFICATE----- + +# Issuer: CN=Secure Global CA O=SecureTrust Corporation +# Subject: CN=Secure Global CA O=SecureTrust Corporation +# Label: "Secure Global CA" +# Serial: 9751836167731051554232119481456978597 +# MD5 Fingerprint: cf:f4:27:0d:d4:ed:dc:65:16:49:6d:3d:da:bf:6e:de +# SHA1 Fingerprint: 3a:44:73:5a:e5:81:90:1f:24:86:61:46:1e:3b:9c:c4:5f:f5:3a:1b +# SHA256 Fingerprint: 42:00:f5:04:3a:c8:59:0e:bb:52:7d:20:9e:d1:50:30:29:fb:cb:d4:1c:a1:b5:06:ec:27:f1:5a:de:7d:ac:69 +-----BEGIN CERTIFICATE----- +MIIDvDCCAqSgAwIBAgIQB1YipOjUiolN9BPI8PjqpTANBgkqhkiG9w0BAQUFADBK +MQswCQYDVQQGEwJVUzEgMB4GA1UEChMXU2VjdXJlVHJ1c3QgQ29ycG9yYXRpb24x +GTAXBgNVBAMTEFNlY3VyZSBHbG9iYWwgQ0EwHhcNMDYxMTA3MTk0MjI4WhcNMjkx +MjMxMTk1MjA2WjBKMQswCQYDVQQGEwJVUzEgMB4GA1UEChMXU2VjdXJlVHJ1c3Qg +Q29ycG9yYXRpb24xGTAXBgNVBAMTEFNlY3VyZSBHbG9iYWwgQ0EwggEiMA0GCSqG +SIb3DQEBAQUAA4IBDwAwggEKAoIBAQCvNS7YrGxVaQZx5RNoJLNP2MwhR/jxYDiJ +iQPpvepeRlMJ3Fz1Wuj3RSoC6zFh1ykzTM7HfAo3fg+6MpjhHZevj8fcyTiW89sa +/FHtaMbQbqR8JNGuQsiWUGMu4P51/pinX0kuleM5M2SOHqRfkNJnPLLZ/kG5VacJ +jnIFHovdRIWCQtBJwB1g8NEXLJXr9qXBkqPFwqcIYA1gBBCWeZ4WNOaptvolRTnI +HmX5k/Wq8VLcmZg9pYYaDDUz+kulBAYVHDGA76oYa8J719rO+TMg1fW9ajMtgQT7 +sFzUnKPiXB3jqUJ1XnvUd+85VLrJChgbEplJL4hL/VBi0XPnj3pDAgMBAAGjgZ0w +gZowEwYJKwYBBAGCNxQCBAYeBABDAEEwCwYDVR0PBAQDAgGGMA8GA1UdEwEB/wQF +MAMBAf8wHQYDVR0OBBYEFK9EBMJBfkiD2045AuzshHrmzsmkMDQGA1UdHwQtMCsw +KaAnoCWGI2h0dHA6Ly9jcmwuc2VjdXJldHJ1c3QuY29tL1NHQ0EuY3JsMBAGCSsG +AQQBgjcVAQQDAgEAMA0GCSqGSIb3DQEBBQUAA4IBAQBjGghAfaReUw132HquHw0L +URYD7xh8yOOvaliTFGCRsoTciE6+OYo68+aCiV0BN7OrJKQVDpI1WkpEXk5X+nXO +H0jOZvQ8QCaSmGwb7iRGDBezUqXbpZGRzzfTb+cnCDpOGR86p1hcF895P4vkp9Mm +I50mD1hp/Ed+stCNi5O/KU9DaXR2Z0vPB4zmAve14bRDtUstFJ/53CYNv6ZHdAbY +iNE6KTCEztI5gGIbqMdXSbxqVVFnFUq+NQfk1XWYN3kwFNspnWzFacxHVaIw98xc +f8LDmBxrThaA63p4ZUWiABqvDA1VZDRIuJK58bRQKfJPIx/abKwfROHdI3hRW8cW +-----END CERTIFICATE----- + +# Issuer: CN=COMODO Certification Authority O=COMODO CA Limited +# Subject: CN=COMODO Certification Authority O=COMODO CA Limited +# Label: "COMODO Certification Authority" +# Serial: 104350513648249232941998508985834464573 +# MD5 Fingerprint: 5c:48:dc:f7:42:72:ec:56:94:6d:1c:cc:71:35:80:75 +# SHA1 Fingerprint: 66:31:bf:9e:f7:4f:9e:b6:c9:d5:a6:0c:ba:6a:be:d1:f7:bd:ef:7b +# SHA256 Fingerprint: 0c:2c:d6:3d:f7:80:6f:a3:99:ed:e8:09:11:6b:57:5b:f8:79:89:f0:65:18:f9:80:8c:86:05:03:17:8b:af:66 +-----BEGIN CERTIFICATE----- +MIIEHTCCAwWgAwIBAgIQToEtioJl4AsC7j41AkblPTANBgkqhkiG9w0BAQUFADCB +gTELMAkGA1UEBhMCR0IxGzAZBgNVBAgTEkdyZWF0ZXIgTWFuY2hlc3RlcjEQMA4G +A1UEBxMHU2FsZm9yZDEaMBgGA1UEChMRQ09NT0RPIENBIExpbWl0ZWQxJzAlBgNV +BAMTHkNPTU9ETyBDZXJ0aWZpY2F0aW9uIEF1dGhvcml0eTAeFw0wNjEyMDEwMDAw +MDBaFw0yOTEyMzEyMzU5NTlaMIGBMQswCQYDVQQGEwJHQjEbMBkGA1UECBMSR3Jl +YXRlciBNYW5jaGVzdGVyMRAwDgYDVQQHEwdTYWxmb3JkMRowGAYDVQQKExFDT01P +RE8gQ0EgTGltaXRlZDEnMCUGA1UEAxMeQ09NT0RPIENlcnRpZmljYXRpb24gQXV0 +aG9yaXR5MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA0ECLi3LjkRv3 +UcEbVASY06m/weaKXTuH+7uIzg3jLz8GlvCiKVCZrts7oVewdFFxze1CkU1B/qnI +2GqGd0S7WWaXUF601CxwRM/aN5VCaTwwxHGzUvAhTaHYujl8HJ6jJJ3ygxaYqhZ8 +Q5sVW7euNJH+1GImGEaaP+vB+fGQV+useg2L23IwambV4EajcNxo2f8ESIl33rXp ++2dtQem8Ob0y2WIC8bGoPW43nOIv4tOiJovGuFVDiOEjPqXSJDlqR6sA1KGzqSX+ +DT+nHbrTUcELpNqsOO9VUCQFZUaTNE8tja3G1CEZ0o7KBWFxB3NH5YoZEr0ETc5O +nKVIrLsm9wIDAQABo4GOMIGLMB0GA1UdDgQWBBQLWOWLxkwVN6RAqTCpIb5HNlpW +/zAOBgNVHQ8BAf8EBAMCAQYwDwYDVR0TAQH/BAUwAwEB/zBJBgNVHR8EQjBAMD6g +PKA6hjhodHRwOi8vY3JsLmNvbW9kb2NhLmNvbS9DT01PRE9DZXJ0aWZpY2F0aW9u +QXV0aG9yaXR5LmNybDANBgkqhkiG9w0BAQUFAAOCAQEAPpiem/Yb6dc5t3iuHXIY +SdOH5EOC6z/JqvWote9VfCFSZfnVDeFs9D6Mk3ORLgLETgdxb8CPOGEIqB6BCsAv +IC9Bi5HcSEW88cbeunZrM8gALTFGTO3nnc+IlP8zwFboJIYmuNg4ON8qa90SzMc/ +RxdMosIGlgnW2/4/PEZB31jiVg88O8EckzXZOFKs7sjsLjBOlDW0JB9LeGna8gI4 +zJVSk/BwJVmcIGfE7vmLV2H0knZ9P4SNVbfo5azV8fUZVqZa+5Acr5Pr5RzUZ5dd +BA6+C4OmF4O5MBKgxTMVBbkN+8cFduPYSo38NBejxiEovjBFMR7HeL5YYTisO+IB +ZQ== +-----END CERTIFICATE----- + +# Issuer: CN=COMODO ECC Certification Authority O=COMODO CA Limited +# Subject: CN=COMODO ECC Certification Authority O=COMODO CA Limited +# Label: "COMODO ECC Certification Authority" +# Serial: 41578283867086692638256921589707938090 +# MD5 Fingerprint: 7c:62:ff:74:9d:31:53:5e:68:4a:d5:78:aa:1e:bf:23 +# SHA1 Fingerprint: 9f:74:4e:9f:2b:4d:ba:ec:0f:31:2c:50:b6:56:3b:8e:2d:93:c3:11 +# SHA256 Fingerprint: 17:93:92:7a:06:14:54:97:89:ad:ce:2f:8f:34:f7:f0:b6:6d:0f:3a:e3:a3:b8:4d:21:ec:15:db:ba:4f:ad:c7 +-----BEGIN CERTIFICATE----- +MIICiTCCAg+gAwIBAgIQH0evqmIAcFBUTAGem2OZKjAKBggqhkjOPQQDAzCBhTEL +MAkGA1UEBhMCR0IxGzAZBgNVBAgTEkdyZWF0ZXIgTWFuY2hlc3RlcjEQMA4GA1UE +BxMHU2FsZm9yZDEaMBgGA1UEChMRQ09NT0RPIENBIExpbWl0ZWQxKzApBgNVBAMT +IkNPTU9ETyBFQ0MgQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkwHhcNMDgwMzA2MDAw +MDAwWhcNMzgwMTE4MjM1OTU5WjCBhTELMAkGA1UEBhMCR0IxGzAZBgNVBAgTEkdy +ZWF0ZXIgTWFuY2hlc3RlcjEQMA4GA1UEBxMHU2FsZm9yZDEaMBgGA1UEChMRQ09N +T0RPIENBIExpbWl0ZWQxKzApBgNVBAMTIkNPTU9ETyBFQ0MgQ2VydGlmaWNhdGlv +biBBdXRob3JpdHkwdjAQBgcqhkjOPQIBBgUrgQQAIgNiAAQDR3svdcmCFYX7deSR +FtSrYpn1PlILBs5BAH+X4QokPB0BBO490o0JlwzgdeT6+3eKKvUDYEs2ixYjFq0J +cfRK9ChQtP6IHG4/bC8vCVlbpVsLM5niwz2J+Wos77LTBumjQjBAMB0GA1UdDgQW +BBR1cacZSBm8nZ3qQUfflMRId5nTeTAOBgNVHQ8BAf8EBAMCAQYwDwYDVR0TAQH/ +BAUwAwEB/zAKBggqhkjOPQQDAwNoADBlAjEA7wNbeqy3eApyt4jf/7VGFAkK+qDm +fQjGGoe9GKhzvSbKYAydzpmfz1wPMOG+FDHqAjAU9JM8SaczepBGR7NjfRObTrdv +GDeAU/7dIOA1mjbRxwG55tzd8/8dLDoWV9mSOdY= +-----END CERTIFICATE----- + +# Issuer: CN=Certigna O=Dhimyotis +# Subject: CN=Certigna O=Dhimyotis +# Label: "Certigna" +# Serial: 18364802974209362175 +# MD5 Fingerprint: ab:57:a6:5b:7d:42:82:19:b5:d8:58:26:28:5e:fd:ff +# SHA1 Fingerprint: b1:2e:13:63:45:86:a4:6f:1a:b2:60:68:37:58:2d:c4:ac:fd:94:97 +# SHA256 Fingerprint: e3:b6:a2:db:2e:d7:ce:48:84:2f:7a:c5:32:41:c7:b7:1d:54:14:4b:fb:40:c1:1f:3f:1d:0b:42:f5:ee:a1:2d +-----BEGIN CERTIFICATE----- +MIIDqDCCApCgAwIBAgIJAP7c4wEPyUj/MA0GCSqGSIb3DQEBBQUAMDQxCzAJBgNV +BAYTAkZSMRIwEAYDVQQKDAlEaGlteW90aXMxETAPBgNVBAMMCENlcnRpZ25hMB4X +DTA3MDYyOTE1MTMwNVoXDTI3MDYyOTE1MTMwNVowNDELMAkGA1UEBhMCRlIxEjAQ +BgNVBAoMCURoaW15b3RpczERMA8GA1UEAwwIQ2VydGlnbmEwggEiMA0GCSqGSIb3 +DQEBAQUAA4IBDwAwggEKAoIBAQDIaPHJ1tazNHUmgh7stL7qXOEm7RFHYeGifBZ4 +QCHkYJ5ayGPhxLGWkv8YbWkj4Sti993iNi+RB7lIzw7sebYs5zRLcAglozyHGxny +gQcPOJAZ0xH+hrTy0V4eHpbNgGzOOzGTtvKg0KmVEn2lmsxryIRWijOp5yIVUxbw +zBfsV1/pogqYCd7jX5xv3EjjhQsVWqa6n6xI4wmy9/Qy3l40vhx4XUJbzg4ij02Q +130yGLMLLGq/jj8UEYkgDncUtT2UCIf3JR7VsmAA7G8qKCVuKj4YYxclPz5EIBb2 +JsglrgVKtOdjLPOMFlN+XPsRGgjBRmKfIrjxwo1p3Po6WAbfAgMBAAGjgbwwgbkw +DwYDVR0TAQH/BAUwAwEB/zAdBgNVHQ4EFgQUGu3+QTmQtCRZvgHyUtVF9lo53BEw +ZAYDVR0jBF0wW4AUGu3+QTmQtCRZvgHyUtVF9lo53BGhOKQ2MDQxCzAJBgNVBAYT +AkZSMRIwEAYDVQQKDAlEaGlteW90aXMxETAPBgNVBAMMCENlcnRpZ25hggkA/tzj +AQ/JSP8wDgYDVR0PAQH/BAQDAgEGMBEGCWCGSAGG+EIBAQQEAwIABzANBgkqhkiG +9w0BAQUFAAOCAQEAhQMeknH2Qq/ho2Ge6/PAD/Kl1NqV5ta+aDY9fm4fTIrv0Q8h +bV6lUmPOEvjvKtpv6zf+EwLHyzs+ImvaYS5/1HI93TDhHkxAGYwP15zRgzB7mFnc +fca5DClMoTOi62c6ZYTTluLtdkVwj7Ur3vkj1kluPBS1xp81HlDQwY9qcEQCYsuu +HWhBp6pX6FOqB9IG9tUUBguRA3UsbHK1YZWaDYu5Def131TN3ubY1gkIl2PlwS6w +t0QmwCbAr1UwnjvVNioZBPRcHv/PLLf/0P2HQBHVESO7SMAhqaQoLf0V+LBOK/Qw +WyH8EZE0vkHve52Xdf+XlcCWWC/qu0bXu+TZLg== +-----END CERTIFICATE----- + +# Issuer: O=Chunghwa Telecom Co., Ltd. OU=ePKI Root Certification Authority +# Subject: O=Chunghwa Telecom Co., Ltd. OU=ePKI Root Certification Authority +# Label: "ePKI Root Certification Authority" +# Serial: 28956088682735189655030529057352760477 +# MD5 Fingerprint: 1b:2e:00:ca:26:06:90:3d:ad:fe:6f:15:68:d3:6b:b3 +# SHA1 Fingerprint: 67:65:0d:f1:7e:8e:7e:5b:82:40:a4:f4:56:4b:cf:e2:3d:69:c6:f0 +# SHA256 Fingerprint: c0:a6:f4:dc:63:a2:4b:fd:cf:54:ef:2a:6a:08:2a:0a:72:de:35:80:3e:2f:f5:ff:52:7a:e5:d8:72:06:df:d5 +-----BEGIN CERTIFICATE----- +MIIFsDCCA5igAwIBAgIQFci9ZUdcr7iXAF7kBtK8nTANBgkqhkiG9w0BAQUFADBe +MQswCQYDVQQGEwJUVzEjMCEGA1UECgwaQ2h1bmdod2EgVGVsZWNvbSBDby4sIEx0 +ZC4xKjAoBgNVBAsMIWVQS0kgUm9vdCBDZXJ0aWZpY2F0aW9uIEF1dGhvcml0eTAe +Fw0wNDEyMjAwMjMxMjdaFw0zNDEyMjAwMjMxMjdaMF4xCzAJBgNVBAYTAlRXMSMw +IQYDVQQKDBpDaHVuZ2h3YSBUZWxlY29tIENvLiwgTHRkLjEqMCgGA1UECwwhZVBL +SSBSb290IENlcnRpZmljYXRpb24gQXV0aG9yaXR5MIICIjANBgkqhkiG9w0BAQEF +AAOCAg8AMIICCgKCAgEA4SUP7o3biDN1Z82tH306Tm2d0y8U82N0ywEhajfqhFAH +SyZbCUNsIZ5qyNUD9WBpj8zwIuQf5/dqIjG3LBXy4P4AakP/h2XGtRrBp0xtInAh +ijHyl3SJCRImHJ7K2RKilTza6We/CKBk49ZCt0Xvl/T29de1ShUCWH2YWEtgvM3X +DZoTM1PRYfl61dd4s5oz9wCGzh1NlDivqOx4UXCKXBCDUSH3ET00hl7lSM2XgYI1 +TBnsZfZrxQWh7kcT1rMhJ5QQCtkkO7q+RBNGMD+XPNjX12ruOzjjK9SXDrkb5wdJ +fzcq+Xd4z1TtW0ado4AOkUPB1ltfFLqfpo0kR0BZv3I4sjZsN/+Z0V0OWQqraffA +sgRFelQArr5T9rXn4fg8ozHSqf4hUmTFpmfwdQcGlBSBVcYn5AGPF8Fqcde+S/uU +WH1+ETOxQvdibBjWzwloPn9s9h6PYq2lY9sJpx8iQkEeb5mKPtf5P0B6ebClAZLS +nT0IFaUQAS2zMnaolQ2zepr7BxB4EW/hj8e6DyUadCrlHJhBmd8hh+iVBmoKs2pH +dmX2Os+PYhcZewoozRrSgx4hxyy/vv9haLdnG7t4TY3OZ+XkwY63I2binZB1NJip +NiuKmpS5nezMirH4JYlcWrYvjB9teSSnUmjDhDXiZo1jDiVN1Rmy5nk3pyKdVDEC +AwEAAaNqMGgwHQYDVR0OBBYEFB4M97Zn8uGSJglFwFU5Lnc/QkqiMAwGA1UdEwQF +MAMBAf8wOQYEZyoHAAQxMC8wLQIBADAJBgUrDgMCGgUAMAcGBWcqAwAABBRFsMLH +ClZ87lt4DJX5GFPBphzYEDANBgkqhkiG9w0BAQUFAAOCAgEACbODU1kBPpVJufGB +uvl2ICO1J2B01GqZNF5sAFPZn/KmsSQHRGoqxqWOeBLoR9lYGxMqXnmbnwoqZ6Yl +PwZpVnPDimZI+ymBV3QGypzqKOg4ZyYr8dW1P2WT+DZdjo2NQCCHGervJ8A9tDkP +JXtoUHRVnAxZfVo9QZQlUgjgRywVMRnVvwdVxrsStZf0X4OFunHB2WyBEXYKCrC/ +gpf36j36+uwtqSiUO1bd0lEursC9CBWMd1I0ltabrNMdjmEPNXubrjlpC2JgQCA2 +j6/7Nu4tCEoduL+bXPjqpRugc6bY+G7gMwRfaKonh+3ZwZCc7b3jajWvY9+rGNm6 +5ulK6lCKD2GTHuItGeIwlDWSXQ62B68ZgI9HkFFLLk3dheLSClIKF5r8GrBQAuUB +o2M3IUxExJtRmREOc5wGj1QupyheRDmHVi03vYVElOEMSyycw5KFNGHLD7ibSkNS +/jQ6fbjpKdx2qcgw+BRxgMYeNkh0IkFch4LoGHGLQYlE535YW6i4jRPpp2zDR+2z +Gp1iro2C6pSe3VkQw63d4k3jMdXH7OjysP6SHhYKGvzZ8/gntsm+HbRsZJB/9OTE +W9c3rkIO3aQab3yIVMUWbuF6aC74Or8NpDyJO3inTmODBCEIZ43ygknQW/2xzQ+D +hNQ+IIX3Sj0rnP0qCglN6oH4EZw= +-----END CERTIFICATE----- + +# Issuer: O=certSIGN OU=certSIGN ROOT CA +# Subject: O=certSIGN OU=certSIGN ROOT CA +# Label: "certSIGN ROOT CA" +# Serial: 35210227249154 +# MD5 Fingerprint: 18:98:c0:d6:e9:3a:fc:f9:b0:f5:0c:f7:4b:01:44:17 +# SHA1 Fingerprint: fa:b7:ee:36:97:26:62:fb:2d:b0:2a:f6:bf:03:fd:e8:7c:4b:2f:9b +# SHA256 Fingerprint: ea:a9:62:c4:fa:4a:6b:af:eb:e4:15:19:6d:35:1c:cd:88:8d:4f:53:f3:fa:8a:e6:d7:c4:66:a9:4e:60:42:bb +-----BEGIN CERTIFICATE----- +MIIDODCCAiCgAwIBAgIGIAYFFnACMA0GCSqGSIb3DQEBBQUAMDsxCzAJBgNVBAYT +AlJPMREwDwYDVQQKEwhjZXJ0U0lHTjEZMBcGA1UECxMQY2VydFNJR04gUk9PVCBD +QTAeFw0wNjA3MDQxNzIwMDRaFw0zMTA3MDQxNzIwMDRaMDsxCzAJBgNVBAYTAlJP +MREwDwYDVQQKEwhjZXJ0U0lHTjEZMBcGA1UECxMQY2VydFNJR04gUk9PVCBDQTCC +ASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBALczuX7IJUqOtdu0KBuqV5Do +0SLTZLrTk+jUrIZhQGpgV2hUhE28alQCBf/fm5oqrl0Hj0rDKH/v+yv6efHHrfAQ +UySQi2bJqIirr1qjAOm+ukbuW3N7LBeCgV5iLKECZbO9xSsAfsT8AzNXDe3i+s5d +RdY4zTW2ssHQnIFKquSyAVwdj1+ZxLGt24gh65AIgoDzMKND5pCCrlUoSe1b16kQ +OA7+j0xbm0bqQfWwCHTD0IgztnzXdN/chNFDDnU5oSVAKOp4yw4sLjmdjItuFhwv +JoIQ4uNllAoEwF73XVv4EOLQunpL+943AAAaWyjj0pxzPjKHmKHJUS/X3qwzs08C +AwEAAaNCMEAwDwYDVR0TAQH/BAUwAwEB/zAOBgNVHQ8BAf8EBAMCAcYwHQYDVR0O +BBYEFOCMm9slSbPxfIbWskKHC9BroNnkMA0GCSqGSIb3DQEBBQUAA4IBAQA+0hyJ +LjX8+HXd5n9liPRyTMks1zJO890ZeUe9jjtbkw9QSSQTaxQGcu8J06Gh40CEyecY +MnQ8SG4Pn0vU9x7Tk4ZkVJdjclDVVc/6IJMCopvDI5NOFlV2oHB5bc0hH88vLbwZ +44gx+FkagQnIl6Z0x2DEW8xXjrJ1/RsCCdtZb3KTafcxQdaIOL+Hsr0Wefmq5L6I +Jd1hJyMctTEHBDa0GpC9oHRxUIltvBTjD4au8as+x6AJzKNI0eDbZOeStc+vckNw +i/nDhDwTqn6Sm1dTk/pwwpEOMfmbZ13pljheX7NzTogVZ96edhBiIL5VaZVDADlN +9u6wWk5JRFRYX0KD +-----END CERTIFICATE----- + +# Issuer: CN=NetLock Arany (Class Gold) F\u0151tan\xfas\xedtv\xe1ny O=NetLock Kft. OU=Tan\xfas\xedtv\xe1nykiad\xf3k (Certification Services) +# Subject: CN=NetLock Arany (Class Gold) F\u0151tan\xfas\xedtv\xe1ny O=NetLock Kft. OU=Tan\xfas\xedtv\xe1nykiad\xf3k (Certification Services) +# Label: "NetLock Arany (Class Gold) F\u0151tan\xfas\xedtv\xe1ny" +# Serial: 80544274841616 +# MD5 Fingerprint: c5:a1:b7:ff:73:dd:d6:d7:34:32:18:df:fc:3c:ad:88 +# SHA1 Fingerprint: 06:08:3f:59:3f:15:a1:04:a0:69:a4:6b:a9:03:d0:06:b7:97:09:91 +# SHA256 Fingerprint: 6c:61:da:c3:a2:de:f0:31:50:6b:e0:36:d2:a6:fe:40:19:94:fb:d1:3d:f9:c8:d4:66:59:92:74:c4:46:ec:98 +-----BEGIN CERTIFICATE----- +MIIEFTCCAv2gAwIBAgIGSUEs5AAQMA0GCSqGSIb3DQEBCwUAMIGnMQswCQYDVQQG +EwJIVTERMA8GA1UEBwwIQnVkYXBlc3QxFTATBgNVBAoMDE5ldExvY2sgS2Z0LjE3 +MDUGA1UECwwuVGFuw7pzw610dsOhbnlraWFkw7NrIChDZXJ0aWZpY2F0aW9uIFNl +cnZpY2VzKTE1MDMGA1UEAwwsTmV0TG9jayBBcmFueSAoQ2xhc3MgR29sZCkgRsWR +dGFuw7pzw610dsOhbnkwHhcNMDgxMjExMTUwODIxWhcNMjgxMjA2MTUwODIxWjCB +pzELMAkGA1UEBhMCSFUxETAPBgNVBAcMCEJ1ZGFwZXN0MRUwEwYDVQQKDAxOZXRM +b2NrIEtmdC4xNzA1BgNVBAsMLlRhbsO6c8OtdHbDoW55a2lhZMOzayAoQ2VydGlm +aWNhdGlvbiBTZXJ2aWNlcykxNTAzBgNVBAMMLE5ldExvY2sgQXJhbnkgKENsYXNz +IEdvbGQpIEbFkXRhbsO6c8OtdHbDoW55MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8A +MIIBCgKCAQEAxCRec75LbRTDofTjl5Bu0jBFHjzuZ9lk4BqKf8owyoPjIMHj9DrT +lF8afFttvzBPhCf2nx9JvMaZCpDyD/V/Q4Q3Y1GLeqVw/HpYzY6b7cNGbIRwXdrz +AZAj/E4wqX7hJ2Pn7WQ8oLjJM2P+FpD/sLj916jAwJRDC7bVWaaeVtAkH3B5r9s5 +VA1lddkVQZQBr17s9o3x/61k/iCa11zr/qYfCGSji3ZVrR47KGAuhyXoqq8fxmRG +ILdwfzzeSNuWU7c5d+Qa4scWhHaXWy+7GRWF+GmF9ZmnqfI0p6m2pgP8b4Y9VHx2 +BJtr+UBdADTHLpl1neWIA6pN+APSQnbAGwIDAKiLo0UwQzASBgNVHRMBAf8ECDAG +AQH/AgEEMA4GA1UdDwEB/wQEAwIBBjAdBgNVHQ4EFgQUzPpnk/C2uNClwB7zU/2M +U9+D15YwDQYJKoZIhvcNAQELBQADggEBAKt/7hwWqZw8UQCgwBEIBaeZ5m8BiFRh +bvG5GK1Krf6BQCOUL/t1fC8oS2IkgYIL9WHxHG64YTjrgfpioTtaYtOUZcTh5m2C ++C8lcLIhJsFyUR+MLMOEkMNaj7rP9KdlpeuY0fsFskZ1FSNqb4VjMIDw1Z4fKRzC +bLBQWV2QWzuoDTDPv31/zvGdg73JRm4gpvlhUbohL3u+pRVjodSVh/GeufOJ8z2F +uLjbvrW5KfnaNwUASZQDhETnv0Mxz3WLJdH0pmT1kvarBes96aULNmLazAZfNou2 +XjG4Kvte9nHfRCaexOYNkbQudZWAUWpLMKawYqGT8ZvYzsRjdT9ZR7E= +-----END CERTIFICATE----- + +# Issuer: CN=SecureSign RootCA11 O=Japan Certification Services, Inc. +# Subject: CN=SecureSign RootCA11 O=Japan Certification Services, Inc. +# Label: "SecureSign RootCA11" +# Serial: 1 +# MD5 Fingerprint: b7:52:74:e2:92:b4:80:93:f2:75:e4:cc:d7:f2:ea:26 +# SHA1 Fingerprint: 3b:c4:9f:48:f8:f3:73:a0:9c:1e:bd:f8:5b:b1:c3:65:c7:d8:11:b3 +# SHA256 Fingerprint: bf:0f:ee:fb:9e:3a:58:1a:d5:f9:e9:db:75:89:98:57:43:d2:61:08:5c:4d:31:4f:6f:5d:72:59:aa:42:16:12 +-----BEGIN CERTIFICATE----- +MIIDbTCCAlWgAwIBAgIBATANBgkqhkiG9w0BAQUFADBYMQswCQYDVQQGEwJKUDEr +MCkGA1UEChMiSmFwYW4gQ2VydGlmaWNhdGlvbiBTZXJ2aWNlcywgSW5jLjEcMBoG +A1UEAxMTU2VjdXJlU2lnbiBSb290Q0ExMTAeFw0wOTA0MDgwNDU2NDdaFw0yOTA0 +MDgwNDU2NDdaMFgxCzAJBgNVBAYTAkpQMSswKQYDVQQKEyJKYXBhbiBDZXJ0aWZp +Y2F0aW9uIFNlcnZpY2VzLCBJbmMuMRwwGgYDVQQDExNTZWN1cmVTaWduIFJvb3RD +QTExMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA/XeqpRyQBTvLTJsz +i1oURaTnkBbR31fSIRCkF/3frNYfp+TbfPfs37gD2pRY/V1yfIw/XwFndBWW4wI8 +h9uuywGOwvNmxoVF9ALGOrVisq/6nL+k5tSAMJjzDbaTj6nU2DbysPyKyiyhFTOV +MdrAG/LuYpmGYz+/3ZMqg6h2uRMft85OQoWPIucuGvKVCbIFtUROd6EgvanyTgp9 +UK31BQ1FT0Zx/Sg+U/sE2C3XZR1KG/rPO7AxmjVuyIsG0wCR8pQIZUyxNAYAeoni +8McDWc/V1uinMrPmmECGxc0nEovMe863ETxiYAcjPitAbpSACW22s293bzUIUPsC +h8U+iQIDAQABo0IwQDAdBgNVHQ4EFgQUW/hNT7KlhtQ60vFjmqC+CfZXt94wDgYD +VR0PAQH/BAQDAgEGMA8GA1UdEwEB/wQFMAMBAf8wDQYJKoZIhvcNAQEFBQADggEB +AKChOBZmLqdWHyGcBvod7bkixTgm2E5P7KN/ed5GIaGHd48HCJqypMWvDzKYC3xm +KbabfSVSSUOrTC4rbnpwrxYO4wJs+0LmGJ1F2FXI6Dvd5+H0LgscNFxsWEr7jIhQ +X5Ucv+2rIrVls4W6ng+4reV6G4pQOh29Dbx7VFALuUKvVaAYga1lme++5Jy/xIWr +QbJUb9wlze144o4MjQlJ3WN7WmmWAiGovVJZ6X01y8hSyn+B/tlr0/cR7SXf+Of5 +pPpyl4RTDaXQMhhRdlkUbA/r7F+AjHVDg8OFmP9Mni0N5HeDk061lgeLKBObjBmN +QSdJQO7e5iNEOdyhIta6A/I= +-----END CERTIFICATE----- + +# Issuer: CN=Microsec e-Szigno Root CA 2009 O=Microsec Ltd. +# Subject: CN=Microsec e-Szigno Root CA 2009 O=Microsec Ltd. +# Label: "Microsec e-Szigno Root CA 2009" +# Serial: 14014712776195784473 +# MD5 Fingerprint: f8:49:f4:03:bc:44:2d:83:be:48:69:7d:29:64:fc:b1 +# SHA1 Fingerprint: 89:df:74:fe:5c:f4:0f:4a:80:f9:e3:37:7d:54:da:91:e1:01:31:8e +# SHA256 Fingerprint: 3c:5f:81:fe:a5:fa:b8:2c:64:bf:a2:ea:ec:af:cd:e8:e0:77:fc:86:20:a7:ca:e5:37:16:3d:f3:6e:db:f3:78 +-----BEGIN CERTIFICATE----- +MIIECjCCAvKgAwIBAgIJAMJ+QwRORz8ZMA0GCSqGSIb3DQEBCwUAMIGCMQswCQYD +VQQGEwJIVTERMA8GA1UEBwwIQnVkYXBlc3QxFjAUBgNVBAoMDU1pY3Jvc2VjIEx0 +ZC4xJzAlBgNVBAMMHk1pY3Jvc2VjIGUtU3ppZ25vIFJvb3QgQ0EgMjAwOTEfMB0G +CSqGSIb3DQEJARYQaW5mb0BlLXN6aWduby5odTAeFw0wOTA2MTYxMTMwMThaFw0y +OTEyMzAxMTMwMThaMIGCMQswCQYDVQQGEwJIVTERMA8GA1UEBwwIQnVkYXBlc3Qx +FjAUBgNVBAoMDU1pY3Jvc2VjIEx0ZC4xJzAlBgNVBAMMHk1pY3Jvc2VjIGUtU3pp +Z25vIFJvb3QgQ0EgMjAwOTEfMB0GCSqGSIb3DQEJARYQaW5mb0BlLXN6aWduby5o +dTCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAOn4j/NjrdqG2KfgQvvP +kd6mJviZpWNwrZuuyjNAfW2WbqEORO7hE52UQlKavXWFdCyoDh2Tthi3jCyoz/tc +cbna7P7ofo/kLx2yqHWH2Leh5TvPmUpG0IMZfcChEhyVbUr02MelTTMuhTlAdX4U +fIASmFDHQWe4oIBhVKZsTh/gnQ4H6cm6M+f+wFUoLAKApxn1ntxVUwOXewdI/5n7 +N4okxFnMUBBjjqqpGrCEGob5X7uxUG6k0QrM1XF+H6cbfPVTbiJfyyvm1HxdrtbC +xkzlBQHZ7Vf8wSN5/PrIJIOV87VqUQHQd9bpEqH5GoP7ghu5sJf0dgYzQ0mg/wu1 ++rUCAwEAAaOBgDB+MA8GA1UdEwEB/wQFMAMBAf8wDgYDVR0PAQH/BAQDAgEGMB0G +A1UdDgQWBBTLD8bfQkPMPcu1SCOhGnqmKrs0aDAfBgNVHSMEGDAWgBTLD8bfQkPM +Pcu1SCOhGnqmKrs0aDAbBgNVHREEFDASgRBpbmZvQGUtc3ppZ25vLmh1MA0GCSqG +SIb3DQEBCwUAA4IBAQDJ0Q5eLtXMs3w+y/w9/w0olZMEyL/azXm4Q5DwpL7v8u8h +mLzU1F0G9u5C7DBsoKqpyvGvivo/C3NqPuouQH4frlRheesuCDfXI/OMn74dseGk +ddug4lQUsbocKaQY9hK6ohQU4zE1yED/t+AFdlfBHFny+L/k7SViXITwfn4fs775 +tyERzAMBVnCnEJIeGzSBHq2cGsMEPO0CYdYeBvNfOofyK/FFh+U9rNHHV4S9a67c +2Pm2G2JwCz02yULyMtd6YebS2z3PyKnJm9zbWETXbzivf3jTo60adbocwTZ8jx5t +HMN1Rq41Bab2XD0h7lbwyYIiLXpUq3DDfSJlgnCW +-----END CERTIFICATE----- + +# Issuer: CN=GlobalSign O=GlobalSign OU=GlobalSign Root CA - R3 +# Subject: CN=GlobalSign O=GlobalSign OU=GlobalSign Root CA - R3 +# Label: "GlobalSign Root CA - R3" +# Serial: 4835703278459759426209954 +# MD5 Fingerprint: c5:df:b8:49:ca:05:13:55:ee:2d:ba:1a:c3:3e:b0:28 +# SHA1 Fingerprint: d6:9b:56:11:48:f0:1c:77:c5:45:78:c1:09:26:df:5b:85:69:76:ad +# SHA256 Fingerprint: cb:b5:22:d7:b7:f1:27:ad:6a:01:13:86:5b:df:1c:d4:10:2e:7d:07:59:af:63:5a:7c:f4:72:0d:c9:63:c5:3b +-----BEGIN CERTIFICATE----- +MIIDXzCCAkegAwIBAgILBAAAAAABIVhTCKIwDQYJKoZIhvcNAQELBQAwTDEgMB4G +A1UECxMXR2xvYmFsU2lnbiBSb290IENBIC0gUjMxEzARBgNVBAoTCkdsb2JhbFNp +Z24xEzARBgNVBAMTCkdsb2JhbFNpZ24wHhcNMDkwMzE4MTAwMDAwWhcNMjkwMzE4 +MTAwMDAwWjBMMSAwHgYDVQQLExdHbG9iYWxTaWduIFJvb3QgQ0EgLSBSMzETMBEG +A1UEChMKR2xvYmFsU2lnbjETMBEGA1UEAxMKR2xvYmFsU2lnbjCCASIwDQYJKoZI +hvcNAQEBBQADggEPADCCAQoCggEBAMwldpB5BngiFvXAg7aEyiie/QV2EcWtiHL8 +RgJDx7KKnQRfJMsuS+FggkbhUqsMgUdwbN1k0ev1LKMPgj0MK66X17YUhhB5uzsT +gHeMCOFJ0mpiLx9e+pZo34knlTifBtc+ycsmWQ1z3rDI6SYOgxXG71uL0gRgykmm +KPZpO/bLyCiR5Z2KYVc3rHQU3HTgOu5yLy6c+9C7v/U9AOEGM+iCK65TpjoWc4zd +QQ4gOsC0p6Hpsk+QLjJg6VfLuQSSaGjlOCZgdbKfd/+RFO+uIEn8rUAVSNECMWEZ +XriX7613t2Saer9fwRPvm2L7DWzgVGkWqQPabumDk3F2xmmFghcCAwEAAaNCMEAw +DgYDVR0PAQH/BAQDAgEGMA8GA1UdEwEB/wQFMAMBAf8wHQYDVR0OBBYEFI/wS3+o +LkUkrk1Q+mOai97i3Ru8MA0GCSqGSIb3DQEBCwUAA4IBAQBLQNvAUKr+yAzv95ZU +RUm7lgAJQayzE4aGKAczymvmdLm6AC2upArT9fHxD4q/c2dKg8dEe3jgr25sbwMp +jjM5RcOO5LlXbKr8EpbsU8Yt5CRsuZRj+9xTaGdWPoO4zzUhw8lo/s7awlOqzJCK +6fBdRoyV3XpYKBovHd7NADdBj+1EbddTKJd+82cEHhXXipa0095MJ6RMG3NzdvQX +mcIfeg7jLQitChws/zyrVQ4PkX4268NXSb7hLi18YIvDQVETI53O9zJrlAGomecs +Mx86OyXShkDOOyyGeMlhLxS67ttVb9+E7gUJTb0o2HLO02JQZR7rkpeDMdmztcpH +WD9f +-----END CERTIFICATE----- + +# Issuer: CN=Izenpe.com O=IZENPE S.A. +# Subject: CN=Izenpe.com O=IZENPE S.A. +# Label: "Izenpe.com" +# Serial: 917563065490389241595536686991402621 +# MD5 Fingerprint: a6:b0:cd:85:80:da:5c:50:34:a3:39:90:2f:55:67:73 +# SHA1 Fingerprint: 2f:78:3d:25:52:18:a7:4a:65:39:71:b5:2c:a2:9c:45:15:6f:e9:19 +# SHA256 Fingerprint: 25:30:cc:8e:98:32:15:02:ba:d9:6f:9b:1f:ba:1b:09:9e:2d:29:9e:0f:45:48:bb:91:4f:36:3b:c0:d4:53:1f +-----BEGIN CERTIFICATE----- +MIIF8TCCA9mgAwIBAgIQALC3WhZIX7/hy/WL1xnmfTANBgkqhkiG9w0BAQsFADA4 +MQswCQYDVQQGEwJFUzEUMBIGA1UECgwLSVpFTlBFIFMuQS4xEzARBgNVBAMMCkl6 +ZW5wZS5jb20wHhcNMDcxMjEzMTMwODI4WhcNMzcxMjEzMDgyNzI1WjA4MQswCQYD +VQQGEwJFUzEUMBIGA1UECgwLSVpFTlBFIFMuQS4xEzARBgNVBAMMCkl6ZW5wZS5j +b20wggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQDJ03rKDx6sp4boFmVq +scIbRTJxldn+EFvMr+eleQGPicPK8lVx93e+d5TzcqQsRNiekpsUOqHnJJAKClaO +xdgmlOHZSOEtPtoKct2jmRXagaKH9HtuJneJWK3W6wyyQXpzbm3benhB6QiIEn6H +LmYRY2xU+zydcsC8Lv/Ct90NduM61/e0aL6i9eOBbsFGb12N4E3GVFWJGjMxCrFX +uaOKmMPsOzTFlUFpfnXCPCDFYbpRR6AgkJOhkEvzTnyFRVSa0QUmQbC1TR0zvsQD +yCV8wXDbO/QJLVQnSKwv4cSsPsjLkkxTOTcj7NMB+eAJRE1NZMDhDVqHIrytG6P+ +JrUV86f8hBnp7KGItERphIPzidF0BqnMC9bC3ieFUCbKF7jJeodWLBoBHmy+E60Q +rLUk9TiRodZL2vG70t5HtfG8gfZZa88ZU+mNFctKy6lvROUbQc/hhqfK0GqfvEyN +BjNaooXlkDWgYlwWTvDjovoDGrQscbNYLN57C9saD+veIR8GdwYDsMnvmfzAuU8L +hij+0rnq49qlw0dpEuDb8PYZi+17cNcC1u2HGCgsBCRMd+RIihrGO5rUD8r6ddIB +QFqNeb+Lz0vPqhbBleStTIo+F5HUsWLlguWABKQDfo2/2n+iD5dPDNMN+9fR5XJ+ +HMh3/1uaD7euBUbl8agW7EekFwIDAQABo4H2MIHzMIGwBgNVHREEgagwgaWBD2lu +Zm9AaXplbnBlLmNvbaSBkTCBjjFHMEUGA1UECgw+SVpFTlBFIFMuQS4gLSBDSUYg +QTAxMzM3MjYwLVJNZXJjLlZpdG9yaWEtR2FzdGVpeiBUMTA1NSBGNjIgUzgxQzBB +BgNVBAkMOkF2ZGEgZGVsIE1lZGl0ZXJyYW5lbyBFdG9yYmlkZWEgMTQgLSAwMTAx +MCBWaXRvcmlhLUdhc3RlaXowDwYDVR0TAQH/BAUwAwEB/zAOBgNVHQ8BAf8EBAMC +AQYwHQYDVR0OBBYEFB0cZQ6o8iV7tJHP5LGx5r1VdGwFMA0GCSqGSIb3DQEBCwUA +A4ICAQB4pgwWSp9MiDrAyw6lFn2fuUhfGI8NYjb2zRlrrKvV9pF9rnHzP7MOeIWb +laQnIUdCSnxIOvVFfLMMjlF4rJUT3sb9fbgakEyrkgPH7UIBzg/YsfqikuFgba56 +awmqxinuaElnMIAkejEWOVt+8Rwu3WwJrfIxwYJOubv5vr8qhT/AQKM6WfxZSzwo +JNu0FXWuDYi6LnPAvViH5ULy617uHjAimcs30cQhbIHsvm0m5hzkQiCeR7Csg1lw +LDXWrzY0tM07+DKo7+N4ifuNRSzanLh+QBxh5z6ikixL8s36mLYp//Pye6kfLqCT +VyvehQP5aTfLnnhqBbTFMXiJ7HqnheG5ezzevh55hM6fcA5ZwjUukCox2eRFekGk +LhObNA5me0mrZJfQRsN5nXJQY6aYWwa9SG3YOYNw6DXwBdGqvOPbyALqfP2C2sJb +UjWumDqtujWTI6cfSN01RpiyEGjkpTHCClguGYEQyVB1/OpaFs4R1+7vUIgtYf8/ +QnMFlEPVjjxOAToZpR9GTnfQXeWBIiGH/pR9hNiTrdZoQ0iy2+tzJOeRf1SktoA+ +naM8THLCV8Sg1Mw4J87VBp6iSNnpn86CcDaTmjvfliHjWbcM2pE38P1ZWrOZyGls +QyYBNWNgVYkDOnXYukrZVP/u3oDYLdE41V4tC5h9Pmzb/CaIxw== +-----END CERTIFICATE----- + +# Issuer: CN=Go Daddy Root Certificate Authority - G2 O=GoDaddy.com, Inc. +# Subject: CN=Go Daddy Root Certificate Authority - G2 O=GoDaddy.com, Inc. +# Label: "Go Daddy Root Certificate Authority - G2" +# Serial: 0 +# MD5 Fingerprint: 80:3a:bc:22:c1:e6:fb:8d:9b:3b:27:4a:32:1b:9a:01 +# SHA1 Fingerprint: 47:be:ab:c9:22:ea:e8:0e:78:78:34:62:a7:9f:45:c2:54:fd:e6:8b +# SHA256 Fingerprint: 45:14:0b:32:47:eb:9c:c8:c5:b4:f0:d7:b5:30:91:f7:32:92:08:9e:6e:5a:63:e2:74:9d:d3:ac:a9:19:8e:da +-----BEGIN CERTIFICATE----- +MIIDxTCCAq2gAwIBAgIBADANBgkqhkiG9w0BAQsFADCBgzELMAkGA1UEBhMCVVMx +EDAOBgNVBAgTB0FyaXpvbmExEzARBgNVBAcTClNjb3R0c2RhbGUxGjAYBgNVBAoT +EUdvRGFkZHkuY29tLCBJbmMuMTEwLwYDVQQDEyhHbyBEYWRkeSBSb290IENlcnRp +ZmljYXRlIEF1dGhvcml0eSAtIEcyMB4XDTA5MDkwMTAwMDAwMFoXDTM3MTIzMTIz +NTk1OVowgYMxCzAJBgNVBAYTAlVTMRAwDgYDVQQIEwdBcml6b25hMRMwEQYDVQQH +EwpTY290dHNkYWxlMRowGAYDVQQKExFHb0RhZGR5LmNvbSwgSW5jLjExMC8GA1UE +AxMoR28gRGFkZHkgUm9vdCBDZXJ0aWZpY2F0ZSBBdXRob3JpdHkgLSBHMjCCASIw +DQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAL9xYgjx+lk09xvJGKP3gElY6SKD +E6bFIEMBO4Tx5oVJnyfq9oQbTqC023CYxzIBsQU+B07u9PpPL1kwIuerGVZr4oAH +/PMWdYA5UXvl+TW2dE6pjYIT5LY/qQOD+qK+ihVqf94Lw7YZFAXK6sOoBJQ7Rnwy +DfMAZiLIjWltNowRGLfTshxgtDj6AozO091GB94KPutdfMh8+7ArU6SSYmlRJQVh +GkSBjCypQ5Yj36w6gZoOKcUcqeldHraenjAKOc7xiID7S13MMuyFYkMlNAJWJwGR +tDtwKj9useiciAF9n9T521NtYJ2/LOdYq7hfRvzOxBsDPAnrSTFcaUaz4EcCAwEA +AaNCMEAwDwYDVR0TAQH/BAUwAwEB/zAOBgNVHQ8BAf8EBAMCAQYwHQYDVR0OBBYE +FDqahQcQZyi27/a9BUFuIMGU2g/eMA0GCSqGSIb3DQEBCwUAA4IBAQCZ21151fmX +WWcDYfF+OwYxdS2hII5PZYe096acvNjpL9DbWu7PdIxztDhC2gV7+AJ1uP2lsdeu +9tfeE8tTEH6KRtGX+rcuKxGrkLAngPnon1rpN5+r5N9ss4UXnT3ZJE95kTXWXwTr +gIOrmgIttRD02JDHBHNA7XIloKmf7J6raBKZV8aPEjoJpL1E/QYVN8Gb5DKj7Tjo +2GTzLH4U/ALqn83/B2gX2yKQOC16jdFU8WnjXzPKej17CuPKf1855eJ1usV2GDPO +LPAvTK33sefOT6jEm0pUBsV/fdUID+Ic/n4XuKxe9tQWskMJDE32p2u0mYRlynqI +4uJEvlz36hz1 +-----END CERTIFICATE----- + +# Issuer: CN=Starfield Root Certificate Authority - G2 O=Starfield Technologies, Inc. +# Subject: CN=Starfield Root Certificate Authority - G2 O=Starfield Technologies, Inc. +# Label: "Starfield Root Certificate Authority - G2" +# Serial: 0 +# MD5 Fingerprint: d6:39:81:c6:52:7e:96:69:fc:fc:ca:66:ed:05:f2:96 +# SHA1 Fingerprint: b5:1c:06:7c:ee:2b:0c:3d:f8:55:ab:2d:92:f4:fe:39:d4:e7:0f:0e +# SHA256 Fingerprint: 2c:e1:cb:0b:f9:d2:f9:e1:02:99:3f:be:21:51:52:c3:b2:dd:0c:ab:de:1c:68:e5:31:9b:83:91:54:db:b7:f5 +-----BEGIN CERTIFICATE----- +MIID3TCCAsWgAwIBAgIBADANBgkqhkiG9w0BAQsFADCBjzELMAkGA1UEBhMCVVMx +EDAOBgNVBAgTB0FyaXpvbmExEzARBgNVBAcTClNjb3R0c2RhbGUxJTAjBgNVBAoT +HFN0YXJmaWVsZCBUZWNobm9sb2dpZXMsIEluYy4xMjAwBgNVBAMTKVN0YXJmaWVs +ZCBSb290IENlcnRpZmljYXRlIEF1dGhvcml0eSAtIEcyMB4XDTA5MDkwMTAwMDAw +MFoXDTM3MTIzMTIzNTk1OVowgY8xCzAJBgNVBAYTAlVTMRAwDgYDVQQIEwdBcml6 +b25hMRMwEQYDVQQHEwpTY290dHNkYWxlMSUwIwYDVQQKExxTdGFyZmllbGQgVGVj +aG5vbG9naWVzLCBJbmMuMTIwMAYDVQQDEylTdGFyZmllbGQgUm9vdCBDZXJ0aWZp +Y2F0ZSBBdXRob3JpdHkgLSBHMjCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoC +ggEBAL3twQP89o/8ArFvW59I2Z154qK3A2FWGMNHttfKPTUuiUP3oWmb3ooa/RMg +nLRJdzIpVv257IzdIvpy3Cdhl+72WoTsbhm5iSzchFvVdPtrX8WJpRBSiUZV9Lh1 +HOZ/5FSuS/hVclcCGfgXcVnrHigHdMWdSL5stPSksPNkN3mSwOxGXn/hbVNMYq/N +Hwtjuzqd+/x5AJhhdM8mgkBj87JyahkNmcrUDnXMN/uLicFZ8WJ/X7NfZTD4p7dN +dloedl40wOiWVpmKs/B/pM293DIxfJHP4F8R+GuqSVzRmZTRouNjWwl2tVZi4Ut0 +HZbUJtQIBFnQmA4O5t78w+wfkPECAwEAAaNCMEAwDwYDVR0TAQH/BAUwAwEB/zAO +BgNVHQ8BAf8EBAMCAQYwHQYDVR0OBBYEFHwMMh+n2TB/xH1oo2Kooc6rB1snMA0G +CSqGSIb3DQEBCwUAA4IBAQARWfolTwNvlJk7mh+ChTnUdgWUXuEok21iXQnCoKjU +sHU48TRqneSfioYmUeYs0cYtbpUgSpIB7LiKZ3sx4mcujJUDJi5DnUox9g61DLu3 +4jd/IroAow57UvtruzvE03lRTs2Q9GcHGcg8RnoNAX3FWOdt5oUwF5okxBDgBPfg +8n/Uqgr/Qh037ZTlZFkSIHc40zI+OIF1lnP6aI+xy84fxez6nH7PfrHxBy22/L/K +pL/QlwVKvOoYKAKQvVR4CSFx09F9HdkWsKlhPdAKACL8x3vLCWRFCztAgfd9fDL1 +mMpYjn0q7pBZc2T5NnReJaH1ZgUufzkVqSr7UIuOhWn0 +-----END CERTIFICATE----- + +# Issuer: CN=Starfield Services Root Certificate Authority - G2 O=Starfield Technologies, Inc. +# Subject: CN=Starfield Services Root Certificate Authority - G2 O=Starfield Technologies, Inc. +# Label: "Starfield Services Root Certificate Authority - G2" +# Serial: 0 +# MD5 Fingerprint: 17:35:74:af:7b:61:1c:eb:f4:f9:3c:e2:ee:40:f9:a2 +# SHA1 Fingerprint: 92:5a:8f:8d:2c:6d:04:e0:66:5f:59:6a:ff:22:d8:63:e8:25:6f:3f +# SHA256 Fingerprint: 56:8d:69:05:a2:c8:87:08:a4:b3:02:51:90:ed:cf:ed:b1:97:4a:60:6a:13:c6:e5:29:0f:cb:2a:e6:3e:da:b5 +-----BEGIN CERTIFICATE----- +MIID7zCCAtegAwIBAgIBADANBgkqhkiG9w0BAQsFADCBmDELMAkGA1UEBhMCVVMx +EDAOBgNVBAgTB0FyaXpvbmExEzARBgNVBAcTClNjb3R0c2RhbGUxJTAjBgNVBAoT +HFN0YXJmaWVsZCBUZWNobm9sb2dpZXMsIEluYy4xOzA5BgNVBAMTMlN0YXJmaWVs +ZCBTZXJ2aWNlcyBSb290IENlcnRpZmljYXRlIEF1dGhvcml0eSAtIEcyMB4XDTA5 +MDkwMTAwMDAwMFoXDTM3MTIzMTIzNTk1OVowgZgxCzAJBgNVBAYTAlVTMRAwDgYD +VQQIEwdBcml6b25hMRMwEQYDVQQHEwpTY290dHNkYWxlMSUwIwYDVQQKExxTdGFy +ZmllbGQgVGVjaG5vbG9naWVzLCBJbmMuMTswOQYDVQQDEzJTdGFyZmllbGQgU2Vy +dmljZXMgUm9vdCBDZXJ0aWZpY2F0ZSBBdXRob3JpdHkgLSBHMjCCASIwDQYJKoZI +hvcNAQEBBQADggEPADCCAQoCggEBANUMOsQq+U7i9b4Zl1+OiFOxHz/Lz58gE20p +OsgPfTz3a3Y4Y9k2YKibXlwAgLIvWX/2h/klQ4bnaRtSmpDhcePYLQ1Ob/bISdm2 +8xpWriu2dBTrz/sm4xq6HZYuajtYlIlHVv8loJNwU4PahHQUw2eeBGg6345AWh1K +Ts9DkTvnVtYAcMtS7nt9rjrnvDH5RfbCYM8TWQIrgMw0R9+53pBlbQLPLJGmpufe +hRhJfGZOozptqbXuNC66DQO4M99H67FrjSXZm86B0UVGMpZwh94CDklDhbZsc7tk +6mFBrMnUVN+HL8cisibMn1lUaJ/8viovxFUcdUBgF4UCVTmLfwUCAwEAAaNCMEAw +DwYDVR0TAQH/BAUwAwEB/zAOBgNVHQ8BAf8EBAMCAQYwHQYDVR0OBBYEFJxfAN+q +AdcwKziIorhtSpzyEZGDMA0GCSqGSIb3DQEBCwUAA4IBAQBLNqaEd2ndOxmfZyMI +bw5hyf2E3F/YNoHN2BtBLZ9g3ccaaNnRbobhiCPPE95Dz+I0swSdHynVv/heyNXB +ve6SbzJ08pGCL72CQnqtKrcgfU28elUSwhXqvfdqlS5sdJ/PHLTyxQGjhdByPq1z +qwubdQxtRbeOlKyWN7Wg0I8VRw7j6IPdj/3vQQF3zCepYoUz8jcI73HPdwbeyBkd +iEDPfUYd/x7H4c7/I9vG+o1VTqkC50cRRj70/b17KSa7qWFiNyi2LSr2EIZkyXCn +0q23KXB56jzaYyWf/Wi3MOxw+3WKt21gZ7IeyLnp2KhvAotnDU0mV3HaIPzBSlCN +sSi6 +-----END CERTIFICATE----- + +# Issuer: CN=AffirmTrust Commercial O=AffirmTrust +# Subject: CN=AffirmTrust Commercial O=AffirmTrust +# Label: "AffirmTrust Commercial" +# Serial: 8608355977964138876 +# MD5 Fingerprint: 82:92:ba:5b:ef:cd:8a:6f:a6:3d:55:f9:84:f6:d6:b7 +# SHA1 Fingerprint: f9:b5:b6:32:45:5f:9c:be:ec:57:5f:80:dc:e9:6e:2c:c7:b2:78:b7 +# SHA256 Fingerprint: 03:76:ab:1d:54:c5:f9:80:3c:e4:b2:e2:01:a0:ee:7e:ef:7b:57:b6:36:e8:a9:3c:9b:8d:48:60:c9:6f:5f:a7 +-----BEGIN CERTIFICATE----- +MIIDTDCCAjSgAwIBAgIId3cGJyapsXwwDQYJKoZIhvcNAQELBQAwRDELMAkGA1UE +BhMCVVMxFDASBgNVBAoMC0FmZmlybVRydXN0MR8wHQYDVQQDDBZBZmZpcm1UcnVz +dCBDb21tZXJjaWFsMB4XDTEwMDEyOTE0MDYwNloXDTMwMTIzMTE0MDYwNlowRDEL +MAkGA1UEBhMCVVMxFDASBgNVBAoMC0FmZmlybVRydXN0MR8wHQYDVQQDDBZBZmZp +cm1UcnVzdCBDb21tZXJjaWFsMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKC +AQEA9htPZwcroRX1BiLLHwGy43NFBkRJLLtJJRTWzsO3qyxPxkEylFf6EqdbDuKP +Hx6GGaeqtS25Xw2Kwq+FNXkyLbscYjfysVtKPcrNcV/pQr6U6Mje+SJIZMblq8Yr +ba0F8PrVC8+a5fBQpIs7R6UjW3p6+DM/uO+Zl+MgwdYoic+U+7lF7eNAFxHUdPAL +MeIrJmqbTFeurCA+ukV6BfO9m2kVrn1OIGPENXY6BwLJN/3HR+7o8XYdcxXyl6S1 +yHp52UKqK39c/s4mT6NmgTWvRLpUHhwwMmWd5jyTXlBOeuM61G7MGvv50jeuJCqr +VwMiKA1JdX+3KNp1v47j3A55MQIDAQABo0IwQDAdBgNVHQ4EFgQUnZPGU4teyq8/ +nx4P5ZmVvCT2lI8wDwYDVR0TAQH/BAUwAwEB/zAOBgNVHQ8BAf8EBAMCAQYwDQYJ +KoZIhvcNAQELBQADggEBAFis9AQOzcAN/wr91LoWXym9e2iZWEnStB03TX8nfUYG +XUPGhi4+c7ImfU+TqbbEKpqrIZcUsd6M06uJFdhrJNTxFq7YpFzUf1GO7RgBsZNj +vbz4YYCanrHOQnDiqX0GJX0nof5v7LMeJNrjS1UaADs1tDvZ110w/YETifLCBivt +Z8SOyUOyXGsViQK8YvxO8rUzqrJv0wqiUOP2O+guRMLbZjipM1ZI8W0bM40NjD9g +N53Tym1+NH4Nn3J2ixufcv1SNUFFApYvHLKac0khsUlHRUe072o0EclNmsxZt9YC +nlpOZbWUrhvfKbAW8b8Angc6F2S1BLUjIZkKlTuXfO8= +-----END CERTIFICATE----- + +# Issuer: CN=AffirmTrust Networking O=AffirmTrust +# Subject: CN=AffirmTrust Networking O=AffirmTrust +# Label: "AffirmTrust Networking" +# Serial: 8957382827206547757 +# MD5 Fingerprint: 42:65:ca:be:01:9a:9a:4c:a9:8c:41:49:cd:c0:d5:7f +# SHA1 Fingerprint: 29:36:21:02:8b:20:ed:02:f5:66:c5:32:d1:d6:ed:90:9f:45:00:2f +# SHA256 Fingerprint: 0a:81:ec:5a:92:97:77:f1:45:90:4a:f3:8d:5d:50:9f:66:b5:e2:c5:8f:cd:b5:31:05:8b:0e:17:f3:f0:b4:1b +-----BEGIN CERTIFICATE----- +MIIDTDCCAjSgAwIBAgIIfE8EORzUmS0wDQYJKoZIhvcNAQEFBQAwRDELMAkGA1UE +BhMCVVMxFDASBgNVBAoMC0FmZmlybVRydXN0MR8wHQYDVQQDDBZBZmZpcm1UcnVz +dCBOZXR3b3JraW5nMB4XDTEwMDEyOTE0MDgyNFoXDTMwMTIzMTE0MDgyNFowRDEL +MAkGA1UEBhMCVVMxFDASBgNVBAoMC0FmZmlybVRydXN0MR8wHQYDVQQDDBZBZmZp +cm1UcnVzdCBOZXR3b3JraW5nMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKC +AQEAtITMMxcua5Rsa2FSoOujz3mUTOWUgJnLVWREZY9nZOIG41w3SfYvm4SEHi3y +YJ0wTsyEheIszx6e/jarM3c1RNg1lho9Nuh6DtjVR6FqaYvZ/Ls6rnla1fTWcbua +kCNrmreIdIcMHl+5ni36q1Mr3Lt2PpNMCAiMHqIjHNRqrSK6mQEubWXLviRmVSRL +QESxG9fhwoXA3hA/Pe24/PHxI1Pcv2WXb9n5QHGNfb2V1M6+oF4nI979ptAmDgAp +6zxG8D1gvz9Q0twmQVGeFDdCBKNwV6gbh+0t+nvujArjqWaJGctB+d1ENmHP4ndG +yH329JKBNv3bNPFyfvMMFr20FQIDAQABo0IwQDAdBgNVHQ4EFgQUBx/S55zawm6i +QLSwelAQUHTEyL0wDwYDVR0TAQH/BAUwAwEB/zAOBgNVHQ8BAf8EBAMCAQYwDQYJ +KoZIhvcNAQEFBQADggEBAIlXshZ6qML91tmbmzTCnLQyFE2npN/svqe++EPbkTfO +tDIuUFUaNU52Q3Eg75N3ThVwLofDwR1t3Mu1J9QsVtFSUzpE0nPIxBsFZVpikpzu +QY0x2+c06lkh1QF612S4ZDnNye2v7UsDSKegmQGA3GWjNq5lWUhPgkvIZfFXHeVZ +Lgo/bNjR9eUJtGxUAArgFU2HdW23WJZa3W3SAKD0m0i+wzekujbgfIeFlxoVot4u +olu9rxj5kFDNcFn4J2dHy8egBzp90SxdbBk6ZrV9/ZFvgrG+CJPbFEfxojfHRZ48 +x3evZKiT3/Zpg4Jg8klCNO1aAFSFHBY2kgxc+qatv9s= +-----END CERTIFICATE----- + +# Issuer: CN=AffirmTrust Premium O=AffirmTrust +# Subject: CN=AffirmTrust Premium O=AffirmTrust +# Label: "AffirmTrust Premium" +# Serial: 7893706540734352110 +# MD5 Fingerprint: c4:5d:0e:48:b6:ac:28:30:4e:0a:bc:f9:38:16:87:57 +# SHA1 Fingerprint: d8:a6:33:2c:e0:03:6f:b1:85:f6:63:4f:7d:6a:06:65:26:32:28:27 +# SHA256 Fingerprint: 70:a7:3f:7f:37:6b:60:07:42:48:90:45:34:b1:14:82:d5:bf:0e:69:8e:cc:49:8d:f5:25:77:eb:f2:e9:3b:9a +-----BEGIN CERTIFICATE----- +MIIFRjCCAy6gAwIBAgIIbYwURrGmCu4wDQYJKoZIhvcNAQEMBQAwQTELMAkGA1UE +BhMCVVMxFDASBgNVBAoMC0FmZmlybVRydXN0MRwwGgYDVQQDDBNBZmZpcm1UcnVz +dCBQcmVtaXVtMB4XDTEwMDEyOTE0MTAzNloXDTQwMTIzMTE0MTAzNlowQTELMAkG +A1UEBhMCVVMxFDASBgNVBAoMC0FmZmlybVRydXN0MRwwGgYDVQQDDBNBZmZpcm1U +cnVzdCBQcmVtaXVtMIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEAxBLf +qV/+Qd3d9Z+K4/as4Tx4mrzY8H96oDMq3I0gW64tb+eT2TZwamjPjlGjhVtnBKAQ +JG9dKILBl1fYSCkTtuG+kU3fhQxTGJoeJKJPj/CihQvL9Cl/0qRY7iZNyaqoe5rZ ++jjeRFcV5fiMyNlI4g0WJx0eyIOFJbe6qlVBzAMiSy2RjYvmia9mx+n/K+k8rNrS +s8PhaJyJ+HoAVt70VZVs+7pk3WKL3wt3MutizCaam7uqYoNMtAZ6MMgpv+0GTZe5 +HMQxK9VfvFMSF5yZVylmd2EhMQcuJUmdGPLu8ytxjLW6OQdJd/zvLpKQBY0tL3d7 +70O/Nbua2Plzpyzy0FfuKE4mX4+QaAkvuPjcBukumj5Rp9EixAqnOEhss/n/fauG +V+O61oV4d7pD6kh/9ti+I20ev9E2bFhc8e6kGVQa9QPSdubhjL08s9NIS+LI+H+S +qHZGnEJlPqQewQcDWkYtuJfzt9WyVSHvutxMAJf7FJUnM7/oQ0dG0giZFmA7mn7S +5u046uwBHjxIVkkJx0w3AJ6IDsBz4W9m6XJHMD4Q5QsDyZpCAGzFlH5hxIrff4Ia +C1nEWTJ3s7xgaVY5/bQGeyzWZDbZvUjthB9+pSKPKrhC9IK31FOQeE4tGv2Bb0TX +OwF0lkLgAOIua+rF7nKsu7/+6qqo+Nz2snmKtmcCAwEAAaNCMEAwHQYDVR0OBBYE +FJ3AZ6YMItkm9UWrpmVSESfYRaxjMA8GA1UdEwEB/wQFMAMBAf8wDgYDVR0PAQH/ +BAQDAgEGMA0GCSqGSIb3DQEBDAUAA4ICAQCzV00QYk465KzquByvMiPIs0laUZx2 +KI15qldGF9X1Uva3ROgIRL8YhNILgM3FEv0AVQVhh0HctSSePMTYyPtwni94loMg +Nt58D2kTiKV1NpgIpsbfrM7jWNa3Pt668+s0QNiigfV4Py/VpfzZotReBA4Xrf5B +8OWycvpEgjNC6C1Y91aMYj+6QrCcDFx+LmUmXFNPALJ4fqENmS2NuB2OosSw/WDQ +MKSOyARiqcTtNd56l+0OOF6SL5Nwpamcb6d9Ex1+xghIsV5n61EIJenmJWtSKZGc +0jlzCFfemQa0W50QBuHCAKi4HEoCChTQwUHK+4w1IX2COPKpVJEZNZOUbWo6xbLQ +u4mGk+ibyQ86p3q4ofB4Rvr8Ny/lioTz3/4E2aFooC8k4gmVBtWVyuEklut89pMF +u+1z6S3RdTnX5yTb2E5fQ4+e0BQ5v1VwSJlXMbSc7kqYA5YwH2AG7hsj/oFgIxpH +YoWlzBk0gG+zrBrjn/B7SK3VAdlntqlyk+otZrWyuOQ9PLLvTIzq6we/qzWaVYa8 +GKa1qF60g2xraUDTn9zxw2lrueFtCfTxqlB2Cnp9ehehVZZCmTEJ3WARjQUwfuaO +RtGdFNrHF+QFlozEJLUbzxQHskD4o55BhrwE0GuWyCqANP2/7waj3VjFhT0+j/6e +KeC2uAloGRwYQw== +-----END CERTIFICATE----- + +# Issuer: CN=AffirmTrust Premium ECC O=AffirmTrust +# Subject: CN=AffirmTrust Premium ECC O=AffirmTrust +# Label: "AffirmTrust Premium ECC" +# Serial: 8401224907861490260 +# MD5 Fingerprint: 64:b0:09:55:cf:b1:d5:99:e2:be:13:ab:a6:5d:ea:4d +# SHA1 Fingerprint: b8:23:6b:00:2f:1d:16:86:53:01:55:6c:11:a4:37:ca:eb:ff:c3:bb +# SHA256 Fingerprint: bd:71:fd:f6:da:97:e4:cf:62:d1:64:7a:dd:25:81:b0:7d:79:ad:f8:39:7e:b4:ec:ba:9c:5e:84:88:82:14:23 +-----BEGIN CERTIFICATE----- +MIIB/jCCAYWgAwIBAgIIdJclisc/elQwCgYIKoZIzj0EAwMwRTELMAkGA1UEBhMC +VVMxFDASBgNVBAoMC0FmZmlybVRydXN0MSAwHgYDVQQDDBdBZmZpcm1UcnVzdCBQ +cmVtaXVtIEVDQzAeFw0xMDAxMjkxNDIwMjRaFw00MDEyMzExNDIwMjRaMEUxCzAJ +BgNVBAYTAlVTMRQwEgYDVQQKDAtBZmZpcm1UcnVzdDEgMB4GA1UEAwwXQWZmaXJt +VHJ1c3QgUHJlbWl1bSBFQ0MwdjAQBgcqhkjOPQIBBgUrgQQAIgNiAAQNMF4bFZ0D +0KF5Nbc6PJJ6yhUczWLznCZcBz3lVPqj1swS6vQUX+iOGasvLkjmrBhDeKzQN8O9 +ss0s5kfiGuZjuD0uL3jET9v0D6RoTFVya5UdThhClXjMNzyR4ptlKymjQjBAMB0G +A1UdDgQWBBSaryl6wBE1NSZRMADDav5A1a7WPDAPBgNVHRMBAf8EBTADAQH/MA4G +A1UdDwEB/wQEAwIBBjAKBggqhkjOPQQDAwNnADBkAjAXCfOHiFBar8jAQr9HX/Vs +aobgxCd05DhT1wV/GzTjxi+zygk8N53X57hG8f2h4nECMEJZh0PUUd+60wkyWs6I +flc9nF9Ca/UHLbXwgpP5WW+uZPpY5Yse42O+tYHNbwKMeQ== +-----END CERTIFICATE----- + +# Issuer: CN=Certum Trusted Network CA O=Unizeto Technologies S.A. OU=Certum Certification Authority +# Subject: CN=Certum Trusted Network CA O=Unizeto Technologies S.A. OU=Certum Certification Authority +# Label: "Certum Trusted Network CA" +# Serial: 279744 +# MD5 Fingerprint: d5:e9:81:40:c5:18:69:fc:46:2c:89:75:62:0f:aa:78 +# SHA1 Fingerprint: 07:e0:32:e0:20:b7:2c:3f:19:2f:06:28:a2:59:3a:19:a7:0f:06:9e +# SHA256 Fingerprint: 5c:58:46:8d:55:f5:8e:49:7e:74:39:82:d2:b5:00:10:b6:d1:65:37:4a:cf:83:a7:d4:a3:2d:b7:68:c4:40:8e +-----BEGIN CERTIFICATE----- +MIIDuzCCAqOgAwIBAgIDBETAMA0GCSqGSIb3DQEBBQUAMH4xCzAJBgNVBAYTAlBM +MSIwIAYDVQQKExlVbml6ZXRvIFRlY2hub2xvZ2llcyBTLkEuMScwJQYDVQQLEx5D +ZXJ0dW0gQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkxIjAgBgNVBAMTGUNlcnR1bSBU +cnVzdGVkIE5ldHdvcmsgQ0EwHhcNMDgxMDIyMTIwNzM3WhcNMjkxMjMxMTIwNzM3 +WjB+MQswCQYDVQQGEwJQTDEiMCAGA1UEChMZVW5pemV0byBUZWNobm9sb2dpZXMg +Uy5BLjEnMCUGA1UECxMeQ2VydHVtIENlcnRpZmljYXRpb24gQXV0aG9yaXR5MSIw +IAYDVQQDExlDZXJ0dW0gVHJ1c3RlZCBOZXR3b3JrIENBMIIBIjANBgkqhkiG9w0B +AQEFAAOCAQ8AMIIBCgKCAQEA4/t9o3K6wvDJFIf1awFO4W5AB7ptJ11/91sts1rH +UV+rpDKmYYe2bg+G0jACl/jXaVehGDldamR5xgFZrDwxSjh80gTSSyjoIF87B6LM +TXPb865Px1bVWqeWifrzq2jUI4ZZJ88JJ7ysbnKDHDBy3+Ci6dLhdHUZvSqeexVU +BBvXQzmtVSjF4hq79MDkrjhJM8x2hZ85RdKknvISjFH4fOQtf/WsX+sWn7Et0brM +kUJ3TCXJkDhv2/DM+44el1k+1WBO5gUo7Ul5E0u6SNsv+XLTOcr+H9g0cvW0QM8x +AcPs3hEtF10fuFDRXhmnad4HMyjKUJX5p1TLVIZQRan5SQIDAQABo0IwQDAPBgNV +HRMBAf8EBTADAQH/MB0GA1UdDgQWBBQIds3LB/8k9sXN7buQvOKEN0Z19zAOBgNV +HQ8BAf8EBAMCAQYwDQYJKoZIhvcNAQEFBQADggEBAKaorSLOAT2mo/9i0Eidi15y +sHhE49wcrwn9I0j6vSrEuVUEtRCjjSfeC4Jj0O7eDDd5QVsisrCaQVymcODU0HfL +I9MA4GxWL+FpDQ3Zqr8hgVDZBqWo/5U30Kr+4rP1mS1FhIrlQgnXdAIv94nYmem8 +J9RHjboNRhx3zxSkHLmkMcScKHQDNP8zGSal6Q10tz6XxnboJ5ajZt3hrvJBW8qY +VoNzcOSGGtIxQbovvi0TWnZvTuhOgQ4/WwMioBK+ZlgRSssDxLQqKi2WF+A5VLxI +03YnnZotBqbJ7DnSq9ufmgsnAjUpsUCV5/nonFWIGUbWtzT1fs45mtk48VH3Tyw= +-----END CERTIFICATE----- + +# Issuer: CN=TWCA Root Certification Authority O=TAIWAN-CA OU=Root CA +# Subject: CN=TWCA Root Certification Authority O=TAIWAN-CA OU=Root CA +# Label: "TWCA Root Certification Authority" +# Serial: 1 +# MD5 Fingerprint: aa:08:8f:f6:f9:7b:b7:f2:b1:a7:1e:9b:ea:ea:bd:79 +# SHA1 Fingerprint: cf:9e:87:6d:d3:eb:fc:42:26:97:a3:b5:a3:7a:a0:76:a9:06:23:48 +# SHA256 Fingerprint: bf:d8:8f:e1:10:1c:41:ae:3e:80:1b:f8:be:56:35:0e:e9:ba:d1:a6:b9:bd:51:5e:dc:5c:6d:5b:87:11:ac:44 +-----BEGIN CERTIFICATE----- +MIIDezCCAmOgAwIBAgIBATANBgkqhkiG9w0BAQUFADBfMQswCQYDVQQGEwJUVzES +MBAGA1UECgwJVEFJV0FOLUNBMRAwDgYDVQQLDAdSb290IENBMSowKAYDVQQDDCFU +V0NBIFJvb3QgQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkwHhcNMDgwODI4MDcyNDMz +WhcNMzAxMjMxMTU1OTU5WjBfMQswCQYDVQQGEwJUVzESMBAGA1UECgwJVEFJV0FO +LUNBMRAwDgYDVQQLDAdSb290IENBMSowKAYDVQQDDCFUV0NBIFJvb3QgQ2VydGlm +aWNhdGlvbiBBdXRob3JpdHkwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIB +AQCwfnK4pAOU5qfeCTiRShFAh6d8WWQUe7UREN3+v9XAu1bihSX0NXIP+FPQQeFE +AcK0HMMxQhZHhTMidrIKbw/lJVBPhYa+v5guEGcevhEFhgWQxFnQfHgQsIBct+HH +K3XLfJ+utdGdIzdjp9xCoi2SBBtQwXu4PhvJVgSLL1KbralW6cH/ralYhzC2gfeX +RfwZVzsrb+RH9JlF/h3x+JejiB03HFyP4HYlmlD4oFT/RJB2I9IyxsOrBr/8+7/z +rX2SYgJbKdM1o5OaQ2RgXbL6Mv87BK9NQGr5x+PvI/1ry+UPizgN7gr8/g+YnzAx +3WxSZfmLgb4i4RxYA7qRG4kHAgMBAAGjQjBAMA4GA1UdDwEB/wQEAwIBBjAPBgNV +HRMBAf8EBTADAQH/MB0GA1UdDgQWBBRqOFsmjd6LWvJPelSDGRjjCDWmujANBgkq +hkiG9w0BAQUFAAOCAQEAPNV3PdrfibqHDAhUaiBQkr6wQT25JmSDCi/oQMCXKCeC +MErJk/9q56YAf4lCmtYR5VPOL8zy2gXE/uJQxDqGfczafhAJO5I1KlOy/usrBdls +XebQ79NqZp4VKIV66IIArB6nCWlWQtNoURi+VJq/REG6Sb4gumlc7rh3zc5sH62D +lhh9DrUUOYTxKOkto557HnpyWoOzeW/vtPzQCqVYT0bf+215WfKEIlKuD8z7fDvn +aspHYcN6+NOSBB+4IIThNlQWx0DeO4pz3N/GCUzf7Nr/1FNCocnyYh0igzyXxfkZ +YiesZSLX0zzG5Y6yU8xJzrww/nsOM5D77dIUkR8Hrw== +-----END CERTIFICATE----- + +# Issuer: O=SECOM Trust Systems CO.,LTD. OU=Security Communication RootCA2 +# Subject: O=SECOM Trust Systems CO.,LTD. OU=Security Communication RootCA2 +# Label: "Security Communication RootCA2" +# Serial: 0 +# MD5 Fingerprint: 6c:39:7d:a4:0e:55:59:b2:3f:d6:41:b1:12:50:de:43 +# SHA1 Fingerprint: 5f:3b:8c:f2:f8:10:b3:7d:78:b4:ce:ec:19:19:c3:73:34:b9:c7:74 +# SHA256 Fingerprint: 51:3b:2c:ec:b8:10:d4:cd:e5:dd:85:39:1a:df:c6:c2:dd:60:d8:7b:b7:36:d2:b5:21:48:4a:a4:7a:0e:be:f6 +-----BEGIN CERTIFICATE----- +MIIDdzCCAl+gAwIBAgIBADANBgkqhkiG9w0BAQsFADBdMQswCQYDVQQGEwJKUDEl +MCMGA1UEChMcU0VDT00gVHJ1c3QgU3lzdGVtcyBDTy4sTFRELjEnMCUGA1UECxMe +U2VjdXJpdHkgQ29tbXVuaWNhdGlvbiBSb290Q0EyMB4XDTA5MDUyOTA1MDAzOVoX +DTI5MDUyOTA1MDAzOVowXTELMAkGA1UEBhMCSlAxJTAjBgNVBAoTHFNFQ09NIFRy +dXN0IFN5c3RlbXMgQ08uLExURC4xJzAlBgNVBAsTHlNlY3VyaXR5IENvbW11bmlj +YXRpb24gUm9vdENBMjCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBANAV +OVKxUrO6xVmCxF1SrjpDZYBLx/KWvNs2l9amZIyoXvDjChz335c9S672XewhtUGr +zbl+dp+++T42NKA7wfYxEUV0kz1XgMX5iZnK5atq1LXaQZAQwdbWQonCv/Q4EpVM +VAX3NuRFg3sUZdbcDE3R3n4MqzvEFb46VqZab3ZpUql6ucjrappdUtAtCms1FgkQ +hNBqyjoGADdH5H5XTz+L62e4iKrFvlNVspHEfbmwhRkGeC7bYRr6hfVKkaHnFtWO +ojnflLhwHyg/i/xAXmODPIMqGplrz95Zajv8bxbXH/1KEOtOghY6rCcMU/Gt1SSw +awNQwS08Ft1ENCcadfsCAwEAAaNCMEAwHQYDVR0OBBYEFAqFqXdlBZh8QIH4D5cs +OPEK7DzPMA4GA1UdDwEB/wQEAwIBBjAPBgNVHRMBAf8EBTADAQH/MA0GCSqGSIb3 +DQEBCwUAA4IBAQBMOqNErLlFsceTfsgLCkLfZOoc7llsCLqJX2rKSpWeeo8HxdpF +coJxDjrSzG+ntKEju/Ykn8sX/oymzsLS28yN/HH8AynBbF0zX2S2ZTuJbxh2ePXc +okgfGT+Ok+vx+hfuzU7jBBJV1uXk3fs+BXziHV7Gp7yXT2g69ekuCkO2r1dcYmh8 +t/2jioSgrGK+KwmHNPBqAbubKVY8/gA3zyNs8U6qtnRGEmyR7jTV7JqR50S+kDFy +1UkC9gLl9B/rfNmWVan/7Ir5mUf/NVoCqgTLiluHcSmRvaS0eg29mvVXIwAHIRc/ +SjnRBUkLp7Y3gaVdjKozXoEofKd9J+sAro03 +-----END CERTIFICATE----- + +# Issuer: CN=Actalis Authentication Root CA O=Actalis S.p.A./03358520967 +# Subject: CN=Actalis Authentication Root CA O=Actalis S.p.A./03358520967 +# Label: "Actalis Authentication Root CA" +# Serial: 6271844772424770508 +# MD5 Fingerprint: 69:c1:0d:4f:07:a3:1b:c3:fe:56:3d:04:bc:11:f6:a6 +# SHA1 Fingerprint: f3:73:b3:87:06:5a:28:84:8a:f2:f3:4a:ce:19:2b:dd:c7:8e:9c:ac +# SHA256 Fingerprint: 55:92:60:84:ec:96:3a:64:b9:6e:2a:be:01:ce:0b:a8:6a:64:fb:fe:bc:c7:aa:b5:af:c1:55:b3:7f:d7:60:66 +-----BEGIN CERTIFICATE----- +MIIFuzCCA6OgAwIBAgIIVwoRl0LE48wwDQYJKoZIhvcNAQELBQAwazELMAkGA1UE +BhMCSVQxDjAMBgNVBAcMBU1pbGFuMSMwIQYDVQQKDBpBY3RhbGlzIFMucC5BLi8w +MzM1ODUyMDk2NzEnMCUGA1UEAwweQWN0YWxpcyBBdXRoZW50aWNhdGlvbiBSb290 +IENBMB4XDTExMDkyMjExMjIwMloXDTMwMDkyMjExMjIwMlowazELMAkGA1UEBhMC +SVQxDjAMBgNVBAcMBU1pbGFuMSMwIQYDVQQKDBpBY3RhbGlzIFMucC5BLi8wMzM1 +ODUyMDk2NzEnMCUGA1UEAwweQWN0YWxpcyBBdXRoZW50aWNhdGlvbiBSb290IENB +MIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEAp8bEpSmkLO/lGMWwUKNv +UTufClrJwkg4CsIcoBh/kbWHuUA/3R1oHwiD1S0eiKD4j1aPbZkCkpAW1V8IbInX +4ay8IMKx4INRimlNAJZaby/ARH6jDuSRzVju3PvHHkVH3Se5CAGfpiEd9UEtL0z9 +KK3giq0itFZljoZUj5NDKd45RnijMCO6zfB9E1fAXdKDa0hMxKufgFpbOr3JpyI/ +gCczWw63igxdBzcIy2zSekciRDXFzMwujt0q7bd9Zg1fYVEiVRvjRuPjPdA1Yprb +rxTIW6HMiRvhMCb8oJsfgadHHwTrozmSBp+Z07/T6k9QnBn+locePGX2oxgkg4YQ +51Q+qDp2JE+BIcXjDwL4k5RHILv+1A7TaLndxHqEguNTVHnd25zS8gebLra8Pu2F +be8lEfKXGkJh90qX6IuxEAf6ZYGyojnP9zz/GPvG8VqLWeICrHuS0E4UT1lF9gxe +KF+w6D9Fz8+vm2/7hNN3WpVvrJSEnu68wEqPSpP4RCHiMUVhUE4Q2OM1fEwZtN4F +v6MGn8i1zeQf1xcGDXqVdFUNaBr8EBtiZJ1t4JWgw5QHVw0U5r0F+7if5t+L4sbn +fpb2U8WANFAoWPASUHEXMLrmeGO89LKtmyuy/uE5jF66CyCU3nuDuP/jVo23Eek7 +jPKxwV2dpAtMK9myGPW1n0sCAwEAAaNjMGEwHQYDVR0OBBYEFFLYiDrIn3hm7Ynz +ezhwlMkCAjbQMA8GA1UdEwEB/wQFMAMBAf8wHwYDVR0jBBgwFoAUUtiIOsifeGbt +ifN7OHCUyQICNtAwDgYDVR0PAQH/BAQDAgEGMA0GCSqGSIb3DQEBCwUAA4ICAQAL +e3KHwGCmSUyIWOYdiPcUZEim2FgKDk8TNd81HdTtBjHIgT5q1d07GjLukD0R0i70 +jsNjLiNmsGe+b7bAEzlgqqI0JZN1Ut6nna0Oh4lScWoWPBkdg/iaKWW+9D+a2fDz +WochcYBNy+A4mz+7+uAwTc+G02UQGRjRlwKxK3JCaKygvU5a2hi/a5iB0P2avl4V +SM0RFbnAKVy06Ij3Pjaut2L9HmLecHgQHEhb2rykOLpn7VU+Xlff1ANATIGk0k9j +pwlCCRT8AKnCgHNPLsBA2RF7SOp6AsDT6ygBJlh0wcBzIm2Tlf05fbsq4/aC4yyX +X04fkZT6/iyj2HYauE2yOE+b+h1IYHkm4vP9qdCa6HCPSXrW5b0KDtst842/6+Ok +fcvHlXHo2qN8xcL4dJIEG4aspCJTQLas/kx2z/uUMsA1n3Y/buWQbqCmJqK4LL7R +K4X9p2jIugErsWx0Hbhzlefut8cl8ABMALJ+tguLHPPAUJ4lueAI3jZm/zel0btU +ZCzJJ7VLkn5l/9Mt4blOvH+kQSGQQXemOR/qnuOf0GZvBeyqdn6/axag67XH/JJU +LysRJyU3eExRarDzzFhdFPFqSBX/wge2sY0PjlxQRrM9vwGYT7JZVEc+NHt4bVaT +LnPqZih4zR0Uv6CPLy64Lo7yFIrM6bV8+2ydDKXhlg== +-----END CERTIFICATE----- + +# Issuer: CN=Buypass Class 2 Root CA O=Buypass AS-983163327 +# Subject: CN=Buypass Class 2 Root CA O=Buypass AS-983163327 +# Label: "Buypass Class 2 Root CA" +# Serial: 2 +# MD5 Fingerprint: 46:a7:d2:fe:45:fb:64:5a:a8:59:90:9b:78:44:9b:29 +# SHA1 Fingerprint: 49:0a:75:74:de:87:0a:47:fe:58:ee:f6:c7:6b:eb:c6:0b:12:40:99 +# SHA256 Fingerprint: 9a:11:40:25:19:7c:5b:b9:5d:94:e6:3d:55:cd:43:79:08:47:b6:46:b2:3c:df:11:ad:a4:a0:0e:ff:15:fb:48 +-----BEGIN CERTIFICATE----- +MIIFWTCCA0GgAwIBAgIBAjANBgkqhkiG9w0BAQsFADBOMQswCQYDVQQGEwJOTzEd +MBsGA1UECgwUQnV5cGFzcyBBUy05ODMxNjMzMjcxIDAeBgNVBAMMF0J1eXBhc3Mg +Q2xhc3MgMiBSb290IENBMB4XDTEwMTAyNjA4MzgwM1oXDTQwMTAyNjA4MzgwM1ow +TjELMAkGA1UEBhMCTk8xHTAbBgNVBAoMFEJ1eXBhc3MgQVMtOTgzMTYzMzI3MSAw +HgYDVQQDDBdCdXlwYXNzIENsYXNzIDIgUm9vdCBDQTCCAiIwDQYJKoZIhvcNAQEB +BQADggIPADCCAgoCggIBANfHXvfBB9R3+0Mh9PT1aeTuMgHbo4Yf5FkNuud1g1Lr +6hxhFUi7HQfKjK6w3Jad6sNgkoaCKHOcVgb/S2TwDCo3SbXlzwx87vFKu3MwZfPV +L4O2fuPn9Z6rYPnT8Z2SdIrkHJasW4DptfQxh6NR/Md+oW+OU3fUl8FVM5I+GC91 +1K2GScuVr1QGbNgGE41b/+EmGVnAJLqBcXmQRFBoJJRfuLMR8SlBYaNByyM21cHx +MlAQTn/0hpPshNOOvEu/XAFOBz3cFIqUCqTqc/sLUegTBxj6DvEr0VQVfTzh97QZ +QmdiXnfgolXsttlpF9U6r0TtSsWe5HonfOV116rLJeffawrbD02TTqigzXsu8lkB +arcNuAeBfos4GzjmCleZPe4h6KP1DBbdi+w0jpwqHAAVF41og9JwnxgIzRFo1clr +Us3ERo/ctfPYV3Me6ZQ5BL/T3jjetFPsaRyifsSP5BtwrfKi+fv3FmRmaZ9JUaLi +FRhnBkp/1Wy1TbMz4GHrXb7pmA8y1x1LPC5aAVKRCfLf6o3YBkBjqhHk/sM3nhRS +P/TizPJhk9H9Z2vXUq6/aKtAQ6BXNVN48FP4YUIHZMbXb5tMOA1jrGKvNouicwoN +9SG9dKpN6nIDSdvHXx1iY8f93ZHsM+71bbRuMGjeyNYmsHVee7QHIJihdjK4TWxP +AgMBAAGjQjBAMA8GA1UdEwEB/wQFMAMBAf8wHQYDVR0OBBYEFMmAd+BikoL1Rpzz +uvdMw964o605MA4GA1UdDwEB/wQEAwIBBjANBgkqhkiG9w0BAQsFAAOCAgEAU18h +9bqwOlI5LJKwbADJ784g7wbylp7ppHR/ehb8t/W2+xUbP6umwHJdELFx7rxP462s +A20ucS6vxOOto70MEae0/0qyexAQH6dXQbLArvQsWdZHEIjzIVEpMMpghq9Gqx3t +OluwlN5E40EIosHsHdb9T7bWR9AUC8rmyrV7d35BH16Dx7aMOZawP5aBQW9gkOLo ++fsicdl9sz1Gv7SEr5AcD48Saq/v7h56rgJKihcrdv6sVIkkLE8/trKnToyokZf7 +KcZ7XC25y2a2t6hbElGFtQl+Ynhw/qlqYLYdDnkM/crqJIByw5c/8nerQyIKx+u2 +DISCLIBrQYoIwOula9+ZEsuK1V6ADJHgJgg2SMX6OBE1/yWDLfJ6v9r9jv6ly0Us +H8SIU653DtmadsWOLB2jutXsMq7Aqqz30XpN69QH4kj3Io6wpJ9qzo6ysmD0oyLQ +I+uUWnpp3Q+/QFesa1lQ2aOZ4W7+jQF5JyMV3pKdewlNWudLSDBaGOYKbeaP4NK7 +5t98biGCwWg5TbSYWGZizEqQXsP6JwSxeRV0mcy+rSDeJmAc61ZRpqPq5KM/p/9h +3PFaTWwyI0PurKju7koSCTxdccK+efrCh2gdC/1cacwG0Jp9VJkqyTkaGa9LKkPz +Y11aWOIv4x3kqdbQCtCev9eBCfHJxyYNrJgWVqA= +-----END CERTIFICATE----- + +# Issuer: CN=Buypass Class 3 Root CA O=Buypass AS-983163327 +# Subject: CN=Buypass Class 3 Root CA O=Buypass AS-983163327 +# Label: "Buypass Class 3 Root CA" +# Serial: 2 +# MD5 Fingerprint: 3d:3b:18:9e:2c:64:5a:e8:d5:88:ce:0e:f9:37:c2:ec +# SHA1 Fingerprint: da:fa:f7:fa:66:84:ec:06:8f:14:50:bd:c7:c2:81:a5:bc:a9:64:57 +# SHA256 Fingerprint: ed:f7:eb:bc:a2:7a:2a:38:4d:38:7b:7d:40:10:c6:66:e2:ed:b4:84:3e:4c:29:b4:ae:1d:5b:93:32:e6:b2:4d +-----BEGIN CERTIFICATE----- +MIIFWTCCA0GgAwIBAgIBAjANBgkqhkiG9w0BAQsFADBOMQswCQYDVQQGEwJOTzEd +MBsGA1UECgwUQnV5cGFzcyBBUy05ODMxNjMzMjcxIDAeBgNVBAMMF0J1eXBhc3Mg +Q2xhc3MgMyBSb290IENBMB4XDTEwMTAyNjA4Mjg1OFoXDTQwMTAyNjA4Mjg1OFow +TjELMAkGA1UEBhMCTk8xHTAbBgNVBAoMFEJ1eXBhc3MgQVMtOTgzMTYzMzI3MSAw +HgYDVQQDDBdCdXlwYXNzIENsYXNzIDMgUm9vdCBDQTCCAiIwDQYJKoZIhvcNAQEB +BQADggIPADCCAgoCggIBAKXaCpUWUOOV8l6ddjEGMnqb8RB2uACatVI2zSRHsJ8Y +ZLya9vrVediQYkwiL944PdbgqOkcLNt4EemOaFEVcsfzM4fkoF0LXOBXByow9c3E +N3coTRiR5r/VUv1xLXA+58bEiuPwKAv0dpihi4dVsjoT/Lc+JzeOIuOoTyrvYLs9 +tznDDgFHmV0ST9tD+leh7fmdvhFHJlsTmKtdFoqwNxxXnUX/iJY2v7vKB3tvh2PX +0DJq1l1sDPGzbjniazEuOQAnFN44wOwZZoYS6J1yFhNkUsepNxz9gjDthBgd9K5c +/3ATAOux9TN6S9ZV+AWNS2mw9bMoNlwUxFFzTWsL8TQH2xc519woe2v1n/MuwU8X +KhDzzMro6/1rqy6any2CbgTUUgGTLT2G/H783+9CHaZr77kgxve9oKeV/afmiSTY +zIw0bOIjL9kSGiG5VZFvC5F5GQytQIgLcOJ60g7YaEi7ghM5EFjp2CoHxhLbWNvS +O1UQRwUVZ2J+GGOmRj8JDlQyXr8NYnon74Do29lLBlo3WiXQCBJ31G8JUJc9yB3D +34xFMFbG02SrZvPAXpacw8Tvw3xrizp5f7NJzz3iiZ+gMEuFuZyUJHmPfWupRWgP +K9Dx2hzLabjKSWJtyNBjYt1gD1iqj6G8BaVmos8bdrKEZLFMOVLAMLrwjEsCsLa3 +AgMBAAGjQjBAMA8GA1UdEwEB/wQFMAMBAf8wHQYDVR0OBBYEFEe4zf/lb+74suwv +Tg75JbCOPGvDMA4GA1UdDwEB/wQEAwIBBjANBgkqhkiG9w0BAQsFAAOCAgEAACAj +QTUEkMJAYmDv4jVM1z+s4jSQuKFvdvoWFqRINyzpkMLyPPgKn9iB5btb2iUspKdV +cSQy9sgL8rxq+JOssgfCX5/bzMiKqr5qb+FJEMwx14C7u8jYog5kV+qi9cKpMRXS +IGrs/CIBKM+GuIAeqcwRpTzyFrNHnfzSgCHEy9BHcEGhyoMZCCxt8l13nIoUE9Q2 +HJLw5QY33KbmkJs4j1xrG0aGQ0JfPgEHU1RdZX33inOhmlRaHylDFCfChQ+1iHsa +O5S3HWCntZznKWlXWpuTekMwGwPXYshApqr8ZORK15FTAaggiG6cX0S5y2CBNOxv +033aSF/rtJC8LakcC6wc1aJoIIAE1vyxjy+7SjENSoYc6+I2KSb12tjE8nVhz36u +dmNKekBlk4f4HoCMhuWG1o8O/FMsYOgWYRqiPkN7zTlgVGr18okmAWiDSKIz6MkE +kbIRNBE+6tBDGR8Dk5AM/1E9V/RBbuHLoL7ryWPNbczk+DaqaJ3tvV2XcEQNtg41 +3OEMXbugUZTLfhbrES+jkkXITHHZvMmZUldGL1DPvTVp9D0VzgalLA8+9oG6lLvD +u79leNKGef9JOxqDDPDeeOzI8k1MGt6CKfjBWtrt7uYnXuhF0J0cUahoq0Tj0Itq +4/g7u9xN12TyUb7mqqta6THuBrxzvxNiCp/HuZc= +-----END CERTIFICATE----- + +# Issuer: CN=T-TeleSec GlobalRoot Class 3 O=T-Systems Enterprise Services GmbH OU=T-Systems Trust Center +# Subject: CN=T-TeleSec GlobalRoot Class 3 O=T-Systems Enterprise Services GmbH OU=T-Systems Trust Center +# Label: "T-TeleSec GlobalRoot Class 3" +# Serial: 1 +# MD5 Fingerprint: ca:fb:40:a8:4e:39:92:8a:1d:fe:8e:2f:c4:27:ea:ef +# SHA1 Fingerprint: 55:a6:72:3e:cb:f2:ec:cd:c3:23:74:70:19:9d:2a:be:11:e3:81:d1 +# SHA256 Fingerprint: fd:73:da:d3:1c:64:4f:f1:b4:3b:ef:0c:cd:da:96:71:0b:9c:d9:87:5e:ca:7e:31:70:7a:f3:e9:6d:52:2b:bd +-----BEGIN CERTIFICATE----- +MIIDwzCCAqugAwIBAgIBATANBgkqhkiG9w0BAQsFADCBgjELMAkGA1UEBhMCREUx +KzApBgNVBAoMIlQtU3lzdGVtcyBFbnRlcnByaXNlIFNlcnZpY2VzIEdtYkgxHzAd +BgNVBAsMFlQtU3lzdGVtcyBUcnVzdCBDZW50ZXIxJTAjBgNVBAMMHFQtVGVsZVNl +YyBHbG9iYWxSb290IENsYXNzIDMwHhcNMDgxMDAxMTAyOTU2WhcNMzMxMDAxMjM1 +OTU5WjCBgjELMAkGA1UEBhMCREUxKzApBgNVBAoMIlQtU3lzdGVtcyBFbnRlcnBy +aXNlIFNlcnZpY2VzIEdtYkgxHzAdBgNVBAsMFlQtU3lzdGVtcyBUcnVzdCBDZW50 +ZXIxJTAjBgNVBAMMHFQtVGVsZVNlYyBHbG9iYWxSb290IENsYXNzIDMwggEiMA0G +CSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQC9dZPwYiJvJK7genasfb3ZJNW4t/zN +8ELg63iIVl6bmlQdTQyK9tPPcPRStdiTBONGhnFBSivwKixVA9ZIw+A5OO3yXDw/ +RLyTPWGrTs0NvvAgJ1gORH8EGoel15YUNpDQSXuhdfsaa3Ox+M6pCSzyU9XDFES4 +hqX2iys52qMzVNn6chr3IhUciJFrf2blw2qAsCTz34ZFiP0Zf3WHHx+xGwpzJFu5 +ZeAsVMhg02YXP+HMVDNzkQI6pn97djmiH5a2OK61yJN0HZ65tOVgnS9W0eDrXltM +EnAMbEQgqxHY9Bn20pxSN+f6tsIxO0rUFJmtxxr1XV/6B7h8DR/Wgx6zAgMBAAGj +QjBAMA8GA1UdEwEB/wQFMAMBAf8wDgYDVR0PAQH/BAQDAgEGMB0GA1UdDgQWBBS1 +A/d2O2GCahKqGFPrAyGUv/7OyjANBgkqhkiG9w0BAQsFAAOCAQEAVj3vlNW92nOy +WL6ukK2YJ5f+AbGwUgC4TeQbIXQbfsDuXmkqJa9c1h3a0nnJ85cp4IaH3gRZD/FZ +1GSFS5mvJQQeyUapl96Cshtwn5z2r3Ex3XsFpSzTucpH9sry9uetuUg/vBa3wW30 +6gmv7PO15wWeph6KU1HWk4HMdJP2udqmJQV0eVp+QD6CSyYRMG7hP0HHRwA11fXT +91Q+gT3aSWqas+8QPebrb9HIIkfLzM8BMZLZGOMivgkeGj5asuRrDFR6fUNOuIml +e9eiPZaGzPImNC1qkp2aGtAw4l1OBLBfiyB+d8E9lYLRRpo7PHi4b6HQDWSieB4p +TpPDpFQUWw== +-----END CERTIFICATE----- + +# Issuer: CN=D-TRUST Root Class 3 CA 2 2009 O=D-Trust GmbH +# Subject: CN=D-TRUST Root Class 3 CA 2 2009 O=D-Trust GmbH +# Label: "D-TRUST Root Class 3 CA 2 2009" +# Serial: 623603 +# MD5 Fingerprint: cd:e0:25:69:8d:47:ac:9c:89:35:90:f7:fd:51:3d:2f +# SHA1 Fingerprint: 58:e8:ab:b0:36:15:33:fb:80:f7:9b:1b:6d:29:d3:ff:8d:5f:00:f0 +# SHA256 Fingerprint: 49:e7:a4:42:ac:f0:ea:62:87:05:00:54:b5:25:64:b6:50:e4:f4:9e:42:e3:48:d6:aa:38:e0:39:e9:57:b1:c1 +-----BEGIN CERTIFICATE----- +MIIEMzCCAxugAwIBAgIDCYPzMA0GCSqGSIb3DQEBCwUAME0xCzAJBgNVBAYTAkRF +MRUwEwYDVQQKDAxELVRydXN0IEdtYkgxJzAlBgNVBAMMHkQtVFJVU1QgUm9vdCBD +bGFzcyAzIENBIDIgMjAwOTAeFw0wOTExMDUwODM1NThaFw0yOTExMDUwODM1NTha +ME0xCzAJBgNVBAYTAkRFMRUwEwYDVQQKDAxELVRydXN0IEdtYkgxJzAlBgNVBAMM +HkQtVFJVU1QgUm9vdCBDbGFzcyAzIENBIDIgMjAwOTCCASIwDQYJKoZIhvcNAQEB +BQADggEPADCCAQoCggEBANOySs96R+91myP6Oi/WUEWJNTrGa9v+2wBoqOADER03 +UAifTUpolDWzU9GUY6cgVq/eUXjsKj3zSEhQPgrfRlWLJ23DEE0NkVJD2IfgXU42 +tSHKXzlABF9bfsyjxiupQB7ZNoTWSPOSHjRGICTBpFGOShrvUD9pXRl/RcPHAY9R +ySPocq60vFYJfxLLHLGvKZAKyVXMD9O0Gu1HNVpK7ZxzBCHQqr0ME7UAyiZsxGsM +lFqVlNpQmvH/pStmMaTJOKDfHR+4CS7zp+hnUquVH+BGPtikw8paxTGA6Eian5Rp +/hnd2HN8gcqW3o7tszIFZYQ05ub9VxC1X3a/L7AQDcUCAwEAAaOCARowggEWMA8G +A1UdEwEB/wQFMAMBAf8wHQYDVR0OBBYEFP3aFMSfMN4hvR5COfyrYyNJ4PGEMA4G +A1UdDwEB/wQEAwIBBjCB0wYDVR0fBIHLMIHIMIGAoH6gfIZ6bGRhcDovL2RpcmVj +dG9yeS5kLXRydXN0Lm5ldC9DTj1ELVRSVVNUJTIwUm9vdCUyMENsYXNzJTIwMyUy +MENBJTIwMiUyMDIwMDksTz1ELVRydXN0JTIwR21iSCxDPURFP2NlcnRpZmljYXRl +cmV2b2NhdGlvbmxpc3QwQ6BBoD+GPWh0dHA6Ly93d3cuZC10cnVzdC5uZXQvY3Js +L2QtdHJ1c3Rfcm9vdF9jbGFzc18zX2NhXzJfMjAwOS5jcmwwDQYJKoZIhvcNAQEL +BQADggEBAH+X2zDI36ScfSF6gHDOFBJpiBSVYEQBrLLpME+bUMJm2H6NMLVwMeni +acfzcNsgFYbQDfC+rAF1hM5+n02/t2A7nPPKHeJeaNijnZflQGDSNiH+0LS4F9p0 +o3/U37CYAqxva2ssJSRyoWXuJVrl5jLn8t+rSfrzkGkj2wTZ51xY/GXUl77M/C4K +zCUqNQT4YJEVdT1B/yMfGchs64JTBKbkTCJNjYy6zltz7GRUUG3RnFX7acM2w4y8 +PIWmawomDeCTmGCufsYkl4phX5GOZpIJhzbNi5stPvZR1FDUWSi9g/LMKHtThm3Y +Johw1+qRzT65ysCQblrGXnRl11z+o+I= +-----END CERTIFICATE----- + +# Issuer: CN=D-TRUST Root Class 3 CA 2 EV 2009 O=D-Trust GmbH +# Subject: CN=D-TRUST Root Class 3 CA 2 EV 2009 O=D-Trust GmbH +# Label: "D-TRUST Root Class 3 CA 2 EV 2009" +# Serial: 623604 +# MD5 Fingerprint: aa:c6:43:2c:5e:2d:cd:c4:34:c0:50:4f:11:02:4f:b6 +# SHA1 Fingerprint: 96:c9:1b:0b:95:b4:10:98:42:fa:d0:d8:22:79:fe:60:fa:b9:16:83 +# SHA256 Fingerprint: ee:c5:49:6b:98:8c:e9:86:25:b9:34:09:2e:ec:29:08:be:d0:b0:f3:16:c2:d4:73:0c:84:ea:f1:f3:d3:48:81 +-----BEGIN CERTIFICATE----- +MIIEQzCCAyugAwIBAgIDCYP0MA0GCSqGSIb3DQEBCwUAMFAxCzAJBgNVBAYTAkRF +MRUwEwYDVQQKDAxELVRydXN0IEdtYkgxKjAoBgNVBAMMIUQtVFJVU1QgUm9vdCBD +bGFzcyAzIENBIDIgRVYgMjAwOTAeFw0wOTExMDUwODUwNDZaFw0yOTExMDUwODUw +NDZaMFAxCzAJBgNVBAYTAkRFMRUwEwYDVQQKDAxELVRydXN0IEdtYkgxKjAoBgNV +BAMMIUQtVFJVU1QgUm9vdCBDbGFzcyAzIENBIDIgRVYgMjAwOTCCASIwDQYJKoZI +hvcNAQEBBQADggEPADCCAQoCggEBAJnxhDRwui+3MKCOvXwEz75ivJn9gpfSegpn +ljgJ9hBOlSJzmY3aFS3nBfwZcyK3jpgAvDw9rKFs+9Z5JUut8Mxk2og+KbgPCdM0 +3TP1YtHhzRnp7hhPTFiu4h7WDFsVWtg6uMQYZB7jM7K1iXdODL/ZlGsTl28So/6Z +qQTMFexgaDbtCHu39b+T7WYxg4zGcTSHThfqr4uRjRxWQa4iN1438h3Z0S0NL2lR +p75mpoo6Kr3HGrHhFPC+Oh25z1uxav60sUYgovseO3Dvk5h9jHOW8sXvhXCtKSb8 +HgQ+HKDYD8tSg2J87otTlZCpV6LqYQXY+U3EJ/pure3511H3a6UCAwEAAaOCASQw +ggEgMA8GA1UdEwEB/wQFMAMBAf8wHQYDVR0OBBYEFNOUikxiEyoZLsyvcop9Ntea +HNxnMA4GA1UdDwEB/wQEAwIBBjCB3QYDVR0fBIHVMIHSMIGHoIGEoIGBhn9sZGFw +Oi8vZGlyZWN0b3J5LmQtdHJ1c3QubmV0L0NOPUQtVFJVU1QlMjBSb290JTIwQ2xh +c3MlMjAzJTIwQ0ElMjAyJTIwRVYlMjAyMDA5LE89RC1UcnVzdCUyMEdtYkgsQz1E +RT9jZXJ0aWZpY2F0ZXJldm9jYXRpb25saXN0MEagRKBChkBodHRwOi8vd3d3LmQt +dHJ1c3QubmV0L2NybC9kLXRydXN0X3Jvb3RfY2xhc3NfM19jYV8yX2V2XzIwMDku +Y3JsMA0GCSqGSIb3DQEBCwUAA4IBAQA07XtaPKSUiO8aEXUHL7P+PPoeUSbrh/Yp +3uDx1MYkCenBz1UbtDDZzhr+BlGmFaQt77JLvyAoJUnRpjZ3NOhk31KxEcdzes05 +nsKtjHEh8lprr988TlWvsoRlFIm5d8sqMb7Po23Pb0iUMkZv53GMoKaEGTcH8gNF +CSuGdXzfX2lXANtu2KZyIktQ1HWYVt+3GP9DQ1CuekR78HlR10M9p9OB0/DJT7na +xpeG0ILD5EJt/rDiZE4OJudANCa1CInXCGNjOCd1HjPqbqjdn5lPdE2BiYBL3ZqX +KVwvvoFBuYz/6n1gBp7N1z3TLqMVvKjmJuVvw9y4AyHqnxbxLFS1 +-----END CERTIFICATE----- + +# Issuer: CN=CA Disig Root R2 O=Disig a.s. +# Subject: CN=CA Disig Root R2 O=Disig a.s. +# Label: "CA Disig Root R2" +# Serial: 10572350602393338211 +# MD5 Fingerprint: 26:01:fb:d8:27:a7:17:9a:45:54:38:1a:43:01:3b:03 +# SHA1 Fingerprint: b5:61:eb:ea:a4:de:e4:25:4b:69:1a:98:a5:57:47:c2:34:c7:d9:71 +# SHA256 Fingerprint: e2:3d:4a:03:6d:7b:70:e9:f5:95:b1:42:20:79:d2:b9:1e:df:bb:1f:b6:51:a0:63:3e:aa:8a:9d:c5:f8:07:03 +-----BEGIN CERTIFICATE----- +MIIFaTCCA1GgAwIBAgIJAJK4iNuwisFjMA0GCSqGSIb3DQEBCwUAMFIxCzAJBgNV +BAYTAlNLMRMwEQYDVQQHEwpCcmF0aXNsYXZhMRMwEQYDVQQKEwpEaXNpZyBhLnMu +MRkwFwYDVQQDExBDQSBEaXNpZyBSb290IFIyMB4XDTEyMDcxOTA5MTUzMFoXDTQy +MDcxOTA5MTUzMFowUjELMAkGA1UEBhMCU0sxEzARBgNVBAcTCkJyYXRpc2xhdmEx +EzARBgNVBAoTCkRpc2lnIGEucy4xGTAXBgNVBAMTEENBIERpc2lnIFJvb3QgUjIw +ggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQCio8QACdaFXS1tFPbCw3Oe +NcJxVX6B+6tGUODBfEl45qt5WDza/3wcn9iXAng+a0EE6UG9vgMsRfYvZNSrXaNH +PWSb6WiaxswbP7q+sos0Ai6YVRn8jG+qX9pMzk0DIaPY0jSTVpbLTAwAFjxfGs3I +x2ymrdMxp7zo5eFm1tL7A7RBZckQrg4FY8aAamkw/dLukO8NJ9+flXP04SXabBbe +QTg06ov80egEFGEtQX6sx3dOy1FU+16SGBsEWmjGycT6txOgmLcRK7fWV8x8nhfR +yyX+hk4kLlYMeE2eARKmK6cBZW58Yh2EhN/qwGu1pSqVg8NTEQxzHQuyRpDRQjrO +QG6Vrf/GlK1ul4SOfW+eioANSW1z4nuSHsPzwfPrLgVv2RvPN3YEyLRa5Beny912 +H9AZdugsBbPWnDTYltxhh5EF5EQIM8HauQhl1K6yNg3ruji6DOWbnuuNZt2Zz9aJ +QfYEkoopKW1rOhzndX0CcQ7zwOe9yxndnWCywmZgtrEE7snmhrmaZkCo5xHtgUUD +i/ZnWejBBhG93c+AAk9lQHhcR1DIm+YfgXvkRKhbhZri3lrVx/k6RGZL5DJUfORs +nLMOPReisjQS1n6yqEm70XooQL6iFh/f5DcfEXP7kAplQ6INfPgGAVUzfbANuPT1 +rqVCV3w2EYx7XsQDnYx5nQIDAQABo0IwQDAPBgNVHRMBAf8EBTADAQH/MA4GA1Ud +DwEB/wQEAwIBBjAdBgNVHQ4EFgQUtZn4r7CU9eMg1gqtzk5WpC5uQu0wDQYJKoZI +hvcNAQELBQADggIBACYGXnDnZTPIgm7ZnBc6G3pmsgH2eDtpXi/q/075KMOYKmFM +tCQSin1tERT3nLXK5ryeJ45MGcipvXrA1zYObYVybqjGom32+nNjf7xueQgcnYqf +GopTpti72TVVsRHFqQOzVju5hJMiXn7B9hJSi+osZ7z+Nkz1uM/Rs0mSO9MpDpkb +lvdhuDvEK7Z4bLQjb/D907JedR+Zlais9trhxTF7+9FGs9K8Z7RiVLoJ92Owk6Ka ++elSLotgEqv89WBW7xBci8QaQtyDW2QOy7W81k/BfDxujRNt+3vrMNDcTa/F1bal +TFtxyegxvug4BkihGuLq0t4SOVga/4AOgnXmt8kHbA7v/zjxmHHEt38OFdAlab0i +nSvtBfZGR6ztwPDUO+Ls7pZbkBNOHlY667DvlruWIxG68kOGdGSVyCh13x01utI3 +gzhTODY7z2zp+WsO0PsE6E9312UBeIYMej4hYvF/Y3EMyZ9E26gnonW+boE+18Dr +G5gPcFw0sorMwIUY6256s/daoQe/qUKS82Ail+QUoQebTnbAjn39pCXHR+3/H3Os +zMOl6W8KjptlwlCFtaOgUxLMVYdh84GuEEZhvUQhuMI9dM9+JDX6HAcOmz0iyu8x +L4ysEr3vQCj8KWefshNPZiTEUxnpHikV7+ZtsH8tZ/3zbBt1RqPlShfppNcL +-----END CERTIFICATE----- + +# Issuer: CN=ACCVRAIZ1 O=ACCV OU=PKIACCV +# Subject: CN=ACCVRAIZ1 O=ACCV OU=PKIACCV +# Label: "ACCVRAIZ1" +# Serial: 6828503384748696800 +# MD5 Fingerprint: d0:a0:5a:ee:05:b6:09:94:21:a1:7d:f1:b2:29:82:02 +# SHA1 Fingerprint: 93:05:7a:88:15:c6:4f:ce:88:2f:fa:91:16:52:28:78:bc:53:64:17 +# SHA256 Fingerprint: 9a:6e:c0:12:e1:a7:da:9d:be:34:19:4d:47:8a:d7:c0:db:18:22:fb:07:1d:f1:29:81:49:6e:d1:04:38:41:13 +-----BEGIN CERTIFICATE----- +MIIH0zCCBbugAwIBAgIIXsO3pkN/pOAwDQYJKoZIhvcNAQEFBQAwQjESMBAGA1UE +AwwJQUNDVlJBSVoxMRAwDgYDVQQLDAdQS0lBQ0NWMQ0wCwYDVQQKDARBQ0NWMQsw +CQYDVQQGEwJFUzAeFw0xMTA1MDUwOTM3MzdaFw0zMDEyMzEwOTM3MzdaMEIxEjAQ +BgNVBAMMCUFDQ1ZSQUlaMTEQMA4GA1UECwwHUEtJQUNDVjENMAsGA1UECgwEQUND +VjELMAkGA1UEBhMCRVMwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQCb +qau/YUqXry+XZpp0X9DZlv3P4uRm7x8fRzPCRKPfmt4ftVTdFXxpNRFvu8gMjmoY +HtiP2Ra8EEg2XPBjs5BaXCQ316PWywlxufEBcoSwfdtNgM3802/J+Nq2DoLSRYWo +G2ioPej0RGy9ocLLA76MPhMAhN9KSMDjIgro6TenGEyxCQ0jVn8ETdkXhBilyNpA +lHPrzg5XPAOBOp0KoVdDaaxXbXmQeOW1tDvYvEyNKKGno6e6Ak4l0Squ7a4DIrhr +IA8wKFSVf+DuzgpmndFALW4ir50awQUZ0m/A8p/4e7MCQvtQqR0tkw8jq8bBD5L/ +0KIV9VMJcRz/RROE5iZe+OCIHAr8Fraocwa48GOEAqDGWuzndN9wrqODJerWx5eH +k6fGioozl2A3ED6XPm4pFdahD9GILBKfb6qkxkLrQaLjlUPTAYVtjrs78yM2x/47 +4KElB0iryYl0/wiPgL/AlmXz7uxLaL2diMMxs0Dx6M/2OLuc5NF/1OVYm3z61PMO +m3WR5LpSLhl+0fXNWhn8ugb2+1KoS5kE3fj5tItQo05iifCHJPqDQsGH+tUtKSpa +cXpkatcnYGMN285J9Y0fkIkyF/hzQ7jSWpOGYdbhdQrqeWZ2iE9x6wQl1gpaepPl +uUsXQA+xtrn13k/c4LOsOxFwYIRKQ26ZIMApcQrAZQIDAQABo4ICyzCCAscwfQYI +KwYBBQUHAQEEcTBvMEwGCCsGAQUFBzAChkBodHRwOi8vd3d3LmFjY3YuZXMvZmls +ZWFkbWluL0FyY2hpdm9zL2NlcnRpZmljYWRvcy9yYWl6YWNjdjEuY3J0MB8GCCsG +AQUFBzABhhNodHRwOi8vb2NzcC5hY2N2LmVzMB0GA1UdDgQWBBTSh7Tj3zcnk1X2 +VuqB5TbMjB4/vTAPBgNVHRMBAf8EBTADAQH/MB8GA1UdIwQYMBaAFNKHtOPfNyeT +VfZW6oHlNsyMHj+9MIIBcwYDVR0gBIIBajCCAWYwggFiBgRVHSAAMIIBWDCCASIG +CCsGAQUFBwICMIIBFB6CARAAQQB1AHQAbwByAGkAZABhAGQAIABkAGUAIABDAGUA +cgB0AGkAZgBpAGMAYQBjAGkA8wBuACAAUgBhAO0AegAgAGQAZQAgAGwAYQAgAEEA +QwBDAFYAIAAoAEEAZwBlAG4AYwBpAGEAIABkAGUAIABUAGUAYwBuAG8AbABvAGcA +7QBhACAAeQAgAEMAZQByAHQAaQBmAGkAYwBhAGMAaQDzAG4AIABFAGwAZQBjAHQA +cgDzAG4AaQBjAGEALAAgAEMASQBGACAAUQA0ADYAMAAxADEANQA2AEUAKQAuACAA +QwBQAFMAIABlAG4AIABoAHQAdABwADoALwAvAHcAdwB3AC4AYQBjAGMAdgAuAGUA +czAwBggrBgEFBQcCARYkaHR0cDovL3d3dy5hY2N2LmVzL2xlZ2lzbGFjaW9uX2Mu +aHRtMFUGA1UdHwROMEwwSqBIoEaGRGh0dHA6Ly93d3cuYWNjdi5lcy9maWxlYWRt +aW4vQXJjaGl2b3MvY2VydGlmaWNhZG9zL3JhaXphY2N2MV9kZXIuY3JsMA4GA1Ud +DwEB/wQEAwIBBjAXBgNVHREEEDAOgQxhY2N2QGFjY3YuZXMwDQYJKoZIhvcNAQEF +BQADggIBAJcxAp/n/UNnSEQU5CmH7UwoZtCPNdpNYbdKl02125DgBS4OxnnQ8pdp +D70ER9m+27Up2pvZrqmZ1dM8MJP1jaGo/AaNRPTKFpV8M9xii6g3+CfYCS0b78gU +JyCpZET/LtZ1qmxNYEAZSUNUY9rizLpm5U9EelvZaoErQNV/+QEnWCzI7UiRfD+m +AM/EKXMRNt6GGT6d7hmKG9Ww7Y49nCrADdg9ZuM8Db3VlFzi4qc1GwQA9j9ajepD +vV+JHanBsMyZ4k0ACtrJJ1vnE5Bc5PUzolVt3OAJTS+xJlsndQAJxGJ3KQhfnlms +tn6tn1QwIgPBHnFk/vk4CpYY3QIUrCPLBhwepH2NDd4nQeit2hW3sCPdK6jT2iWH +7ehVRE2I9DZ+hJp4rPcOVkkO1jMl1oRQQmwgEh0q1b688nCBpHBgvgW1m54ERL5h +I6zppSSMEYCUWqKiuUnSwdzRp+0xESyeGabu4VXhwOrPDYTkF7eifKXeVSUG7szA +h1xA2syVP1XgNce4hL60Xc16gwFy7ofmXx2utYXGJt/mwZrpHgJHnyqobalbz+xF +d3+YJ5oyXSrjhO7FmGYvliAd3djDJ9ew+f7Zfc3Qn48LFFhRny+Lwzgt3uiP1o2H +pPVWQxaZLPSkVrQ0uGE3ycJYgBugl6H8WY3pEfbRD0tVNEYqi4Y7 +-----END CERTIFICATE----- + +# Issuer: CN=TWCA Global Root CA O=TAIWAN-CA OU=Root CA +# Subject: CN=TWCA Global Root CA O=TAIWAN-CA OU=Root CA +# Label: "TWCA Global Root CA" +# Serial: 3262 +# MD5 Fingerprint: f9:03:7e:cf:e6:9e:3c:73:7a:2a:90:07:69:ff:2b:96 +# SHA1 Fingerprint: 9c:bb:48:53:f6:a4:f6:d3:52:a4:e8:32:52:55:60:13:f5:ad:af:65 +# SHA256 Fingerprint: 59:76:90:07:f7:68:5d:0f:cd:50:87:2f:9f:95:d5:75:5a:5b:2b:45:7d:81:f3:69:2b:61:0a:98:67:2f:0e:1b +-----BEGIN CERTIFICATE----- +MIIFQTCCAymgAwIBAgICDL4wDQYJKoZIhvcNAQELBQAwUTELMAkGA1UEBhMCVFcx +EjAQBgNVBAoTCVRBSVdBTi1DQTEQMA4GA1UECxMHUm9vdCBDQTEcMBoGA1UEAxMT +VFdDQSBHbG9iYWwgUm9vdCBDQTAeFw0xMjA2MjcwNjI4MzNaFw0zMDEyMzExNTU5 +NTlaMFExCzAJBgNVBAYTAlRXMRIwEAYDVQQKEwlUQUlXQU4tQ0ExEDAOBgNVBAsT +B1Jvb3QgQ0ExHDAaBgNVBAMTE1RXQ0EgR2xvYmFsIFJvb3QgQ0EwggIiMA0GCSqG +SIb3DQEBAQUAA4ICDwAwggIKAoICAQCwBdvI64zEbooh745NnHEKH1Jw7W2CnJfF +10xORUnLQEK1EjRsGcJ0pDFfhQKX7EMzClPSnIyOt7h52yvVavKOZsTuKwEHktSz +0ALfUPZVr2YOy+BHYC8rMjk1Ujoog/h7FsYYuGLWRyWRzvAZEk2tY/XTP3VfKfCh +MBwqoJimFb3u/Rk28OKRQ4/6ytYQJ0lM793B8YVwm8rqqFpD/G2Gb3PpN0Wp8DbH +zIh1HrtsBv+baz4X7GGqcXzGHaL3SekVtTzWoWH1EfcFbx39Eb7QMAfCKbAJTibc +46KokWofwpFFiFzlmLhxpRUZyXx1EcxwdE8tmx2RRP1WKKD+u4ZqyPpcC1jcxkt2 +yKsi2XMPpfRaAok/T54igu6idFMqPVMnaR1sjjIsZAAmY2E2TqNGtz99sy2sbZCi +laLOz9qC5wc0GZbpuCGqKX6mOL6OKUohZnkfs8O1CWfe1tQHRvMq2uYiN2DLgbYP +oA/pyJV/v1WRBXrPPRXAb94JlAGD1zQbzECl8LibZ9WYkTunhHiVJqRaCPgrdLQA +BDzfuBSO6N+pjWxnkjMdwLfS7JLIvgm/LCkFbwJrnu+8vyq8W8BQj0FwcYeyTbcE +qYSjMq+u7msXi7Kx/mzhkIyIqJdIzshNy/MGz19qCkKxHh53L46g5pIOBvwFItIm +4TFRfTLcDwIDAQABoyMwITAOBgNVHQ8BAf8EBAMCAQYwDwYDVR0TAQH/BAUwAwEB +/zANBgkqhkiG9w0BAQsFAAOCAgEAXzSBdu+WHdXltdkCY4QWwa6gcFGn90xHNcgL +1yg9iXHZqjNB6hQbbCEAwGxCGX6faVsgQt+i0trEfJdLjbDorMjupWkEmQqSpqsn +LhpNgb+E1HAerUf+/UqdM+DyucRFCCEK2mlpc3INvjT+lIutwx4116KD7+U4x6WF +H6vPNOw/KP4M8VeGTslV9xzU2KV9Bnpv1d8Q34FOIWWxtuEXeZVFBs5fzNxGiWNo +RI2T9GRwoD2dKAXDOXC4Ynsg/eTb6QihuJ49CcdP+yz4k3ZB3lLg4VfSnQO8d57+ +nile98FRYB/e2guyLXW3Q0iT5/Z5xoRdgFlglPx4mI88k1HtQJAH32RjJMtOcQWh +15QaiDLxInQirqWm2BJpTGCjAu4r7NRjkgtevi92a6O2JryPA9gK8kxkRr05YuWW +6zRjESjMlfGt7+/cgFhI6Uu46mWs6fyAtbXIRfmswZ/ZuepiiI7E8UuDEq3mi4TW +nsLrgxifarsbJGAzcMzs9zLzXNl5fe+epP7JI8Mk7hWSsT2RTyaGvWZzJBPqpK5j +wa19hAM8EHiGG3njxPPyBJUgriOCxLM6AGK/5jYk4Ve6xx6QddVfP5VhK8E7zeWz +aGHQRiapIVJpLesux+t3zqY6tQMzT3bR51xUAV3LePTJDL/PEo4XLSNolOer/qmy +KwbQBM0= +-----END CERTIFICATE----- + +# Issuer: CN=TeliaSonera Root CA v1 O=TeliaSonera +# Subject: CN=TeliaSonera Root CA v1 O=TeliaSonera +# Label: "TeliaSonera Root CA v1" +# Serial: 199041966741090107964904287217786801558 +# MD5 Fingerprint: 37:41:49:1b:18:56:9a:26:f5:ad:c2:66:fb:40:a5:4c +# SHA1 Fingerprint: 43:13:bb:96:f1:d5:86:9b:c1:4e:6a:92:f6:cf:f6:34:69:87:82:37 +# SHA256 Fingerprint: dd:69:36:fe:21:f8:f0:77:c1:23:a1:a5:21:c1:22:24:f7:22:55:b7:3e:03:a7:26:06:93:e8:a2:4b:0f:a3:89 +-----BEGIN CERTIFICATE----- +MIIFODCCAyCgAwIBAgIRAJW+FqD3LkbxezmCcvqLzZYwDQYJKoZIhvcNAQEFBQAw +NzEUMBIGA1UECgwLVGVsaWFTb25lcmExHzAdBgNVBAMMFlRlbGlhU29uZXJhIFJv +b3QgQ0EgdjEwHhcNMDcxMDE4MTIwMDUwWhcNMzIxMDE4MTIwMDUwWjA3MRQwEgYD +VQQKDAtUZWxpYVNvbmVyYTEfMB0GA1UEAwwWVGVsaWFTb25lcmEgUm9vdCBDQSB2 +MTCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBAMK+6yfwIaPzaSZVfp3F +VRaRXP3vIb9TgHot0pGMYzHw7CTww6XScnwQbfQ3t+XmfHnqjLWCi65ItqwA3GV1 +7CpNX8GH9SBlK4GoRz6JI5UwFpB/6FcHSOcZrr9FZ7E3GwYq/t75rH2D+1665I+X +Z75Ljo1kB1c4VWk0Nj0TSO9P4tNmHqTPGrdeNjPUtAa9GAH9d4RQAEX1jF3oI7x+ +/jXh7VB7qTCNGdMJjmhnXb88lxhTuylixcpecsHHltTbLaC0H2kD7OriUPEMPPCs +81Mt8Bz17Ww5OXOAFshSsCPN4D7c3TxHoLs1iuKYaIu+5b9y7tL6pe0S7fyYGKkm +dtwoSxAgHNN/Fnct7W+A90m7UwW7XWjH1Mh1Fj+JWov3F0fUTPHSiXk+TT2YqGHe +Oh7S+F4D4MHJHIzTjU3TlTazN19jY5szFPAtJmtTfImMMsJu7D0hADnJoWjiUIMu +sDor8zagrC/kb2HCUQk5PotTubtn2txTuXZZNp1D5SDgPTJghSJRt8czu90VL6R4 +pgd7gUY2BIbdeTXHlSw7sKMXNeVzH7RcWe/a6hBle3rQf5+ztCo3O3CLm1u5K7fs +slESl1MpWtTwEhDcTwK7EpIvYtQ/aUN8Ddb8WHUBiJ1YFkveupD/RwGJBmr2X7KQ +arMCpgKIv7NHfirZ1fpoeDVNAgMBAAGjPzA9MA8GA1UdEwEB/wQFMAMBAf8wCwYD +VR0PBAQDAgEGMB0GA1UdDgQWBBTwj1k4ALP1j5qWDNXr+nuqF+gTEjANBgkqhkiG +9w0BAQUFAAOCAgEAvuRcYk4k9AwI//DTDGjkk0kiP0Qnb7tt3oNmzqjMDfz1mgbl +dxSR651Be5kqhOX//CHBXfDkH1e3damhXwIm/9fH907eT/j3HEbAek9ALCI18Bmx +0GtnLLCo4MBANzX2hFxc469CeP6nyQ1Q6g2EdvZR74NTxnr/DlZJLo961gzmJ1Tj +TQpgcmLNkQfWpb/ImWvtxBnmq0wROMVvMeJuScg/doAmAyYp4Db29iBT4xdwNBed +Y2gea+zDTYa4EzAvXUYNR0PVG6pZDrlcjQZIrXSHX8f8MVRBE+LHIQ6e4B4N4cB7 +Q4WQxYpYxmUKeFfyxiMPAdkgS94P+5KFdSpcc41teyWRyu5FrgZLAMzTsVlQ2jqI +OylDRl6XK1TOU2+NSueW+r9xDkKLfP0ooNBIytrEgUy7onOTJsjrDNYmiLbAJM+7 +vVvrdX3pCI6GMyx5dwlppYn8s3CQh3aP0yK7Qs69cwsgJirQmz1wHiRszYd2qReW +t88NkvuOGKmYSdGe/mBEciG5Ge3C9THxOUiIkCR1VBatzvT4aRRkOfujuLpwQMcn +HL/EVlP6Y2XQ8xwOFvVrhlhNGNTkDY6lnVuR3HYkUD/GKvvZt5y11ubQ2egZixVx +SK236thZiNSQvxaz2emsWWFUyBy6ysHK4bkgTI86k4mloMy/0/Z1pHWWbVY= +-----END CERTIFICATE----- + +# Issuer: CN=T-TeleSec GlobalRoot Class 2 O=T-Systems Enterprise Services GmbH OU=T-Systems Trust Center +# Subject: CN=T-TeleSec GlobalRoot Class 2 O=T-Systems Enterprise Services GmbH OU=T-Systems Trust Center +# Label: "T-TeleSec GlobalRoot Class 2" +# Serial: 1 +# MD5 Fingerprint: 2b:9b:9e:e4:7b:6c:1f:00:72:1a:cc:c1:77:79:df:6a +# SHA1 Fingerprint: 59:0d:2d:7d:88:4f:40:2e:61:7e:a5:62:32:17:65:cf:17:d8:94:e9 +# SHA256 Fingerprint: 91:e2:f5:78:8d:58:10:eb:a7:ba:58:73:7d:e1:54:8a:8e:ca:cd:01:45:98:bc:0b:14:3e:04:1b:17:05:25:52 +-----BEGIN CERTIFICATE----- +MIIDwzCCAqugAwIBAgIBATANBgkqhkiG9w0BAQsFADCBgjELMAkGA1UEBhMCREUx +KzApBgNVBAoMIlQtU3lzdGVtcyBFbnRlcnByaXNlIFNlcnZpY2VzIEdtYkgxHzAd +BgNVBAsMFlQtU3lzdGVtcyBUcnVzdCBDZW50ZXIxJTAjBgNVBAMMHFQtVGVsZVNl +YyBHbG9iYWxSb290IENsYXNzIDIwHhcNMDgxMDAxMTA0MDE0WhcNMzMxMDAxMjM1 +OTU5WjCBgjELMAkGA1UEBhMCREUxKzApBgNVBAoMIlQtU3lzdGVtcyBFbnRlcnBy +aXNlIFNlcnZpY2VzIEdtYkgxHzAdBgNVBAsMFlQtU3lzdGVtcyBUcnVzdCBDZW50 +ZXIxJTAjBgNVBAMMHFQtVGVsZVNlYyBHbG9iYWxSb290IENsYXNzIDIwggEiMA0G +CSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQCqX9obX+hzkeXaXPSi5kfl82hVYAUd +AqSzm1nzHoqvNK38DcLZSBnuaY/JIPwhqgcZ7bBcrGXHX+0CfHt8LRvWurmAwhiC +FoT6ZrAIxlQjgeTNuUk/9k9uN0goOA/FvudocP05l03Sx5iRUKrERLMjfTlH6VJi +1hKTXrcxlkIF+3anHqP1wvzpesVsqXFP6st4vGCvx9702cu+fjOlbpSD8DT6Iavq +jnKgP6TeMFvvhk1qlVtDRKgQFRzlAVfFmPHmBiiRqiDFt1MmUUOyCxGVWOHAD3bZ +wI18gfNycJ5v/hqO2V81xrJvNHy+SE/iWjnX2J14np+GPgNeGYtEotXHAgMBAAGj +QjBAMA8GA1UdEwEB/wQFMAMBAf8wDgYDVR0PAQH/BAQDAgEGMB0GA1UdDgQWBBS/ +WSA2AHmgoCJrjNXyYdK4LMuCSjANBgkqhkiG9w0BAQsFAAOCAQEAMQOiYQsfdOhy +NsZt+U2e+iKo4YFWz827n+qrkRk4r6p8FU3ztqONpfSO9kSpp+ghla0+AGIWiPAC +uvxhI+YzmzB6azZie60EI4RYZeLbK4rnJVM3YlNfvNoBYimipidx5joifsFvHZVw +IEoHNN/q/xWA5brXethbdXwFeilHfkCoMRN3zUA7tFFHei4R40cR3p1m0IvVVGb6 +g1XqfMIpiRvpb7PO4gWEyS8+eIVibslfwXhjdFjASBgMmTnrpMwatXlajRWc2BQN +9noHV8cigwUtPJslJj0Ys6lDfMjIq2SPDqO/nBudMNva0Bkuqjzx+zOAduTNrRlP +BSeOE6Fuwg== +-----END CERTIFICATE----- + +# Issuer: CN=Atos TrustedRoot 2011 O=Atos +# Subject: CN=Atos TrustedRoot 2011 O=Atos +# Label: "Atos TrustedRoot 2011" +# Serial: 6643877497813316402 +# MD5 Fingerprint: ae:b9:c4:32:4b:ac:7f:5d:66:cc:77:94:bb:2a:77:56 +# SHA1 Fingerprint: 2b:b1:f5:3e:55:0c:1d:c5:f1:d4:e6:b7:6a:46:4b:55:06:02:ac:21 +# SHA256 Fingerprint: f3:56:be:a2:44:b7:a9:1e:b3:5d:53:ca:9a:d7:86:4a:ce:01:8e:2d:35:d5:f8:f9:6d:df:68:a6:f4:1a:a4:74 +-----BEGIN CERTIFICATE----- +MIIDdzCCAl+gAwIBAgIIXDPLYixfszIwDQYJKoZIhvcNAQELBQAwPDEeMBwGA1UE +AwwVQXRvcyBUcnVzdGVkUm9vdCAyMDExMQ0wCwYDVQQKDARBdG9zMQswCQYDVQQG +EwJERTAeFw0xMTA3MDcxNDU4MzBaFw0zMDEyMzEyMzU5NTlaMDwxHjAcBgNVBAMM +FUF0b3MgVHJ1c3RlZFJvb3QgMjAxMTENMAsGA1UECgwEQXRvczELMAkGA1UEBhMC +REUwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQCVhTuXbyo7LjvPpvMp +Nb7PGKw+qtn4TaA+Gke5vJrf8v7MPkfoepbCJI419KkM/IL9bcFyYie96mvr54rM +VD6QUM+A1JX76LWC1BTFtqlVJVfbsVD2sGBkWXppzwO3bw2+yj5vdHLqqjAqc2K+ +SZFhyBH+DgMq92og3AIVDV4VavzjgsG1xZ1kCWyjWZgHJ8cblithdHFsQ/H3NYkQ +4J7sVaE3IqKHBAUsR320HLliKWYoyrfhk/WklAOZuXCFteZI6o1Q/NnezG8HDt0L +cp2AMBYHlT8oDv3FdU9T1nSatCQujgKRz3bFmx5VdJx4IbHwLfELn8LVlhgf8FQi +eowHAgMBAAGjfTB7MB0GA1UdDgQWBBSnpQaxLKYJYO7Rl+lwrrw7GWzbITAPBgNV +HRMBAf8EBTADAQH/MB8GA1UdIwQYMBaAFKelBrEspglg7tGX6XCuvDsZbNshMBgG +A1UdIAQRMA8wDQYLKwYBBAGwLQMEAQEwDgYDVR0PAQH/BAQDAgGGMA0GCSqGSIb3 +DQEBCwUAA4IBAQAmdzTblEiGKkGdLD4GkGDEjKwLVLgfuXvTBznk+j57sj1O7Z8j +vZfza1zv7v1Apt+hk6EKhqzvINB5Ab149xnYJDE0BAGmuhWawyfc2E8PzBhj/5kP +DpFrdRbhIfzYJsdHt6bPWHJxfrrhTZVHO8mvbaG0weyJ9rQPOLXiZNwlz6bb65pc +maHFCN795trV1lpFDMS3wrUU77QR/w4VtfX128a961qn8FYiqTxlVMYVqL2Gns2D +lmh6cYGJ4Qvh6hEbaAjMaZ7snkGeRDImeuKHCnE96+RapNLbxc3G3mB/ufNPRJLv +KrcYPqcZ2Qt9sTdBQrC6YB3y/gkRsPCHe6ed +-----END CERTIFICATE----- + +# Issuer: CN=QuoVadis Root CA 1 G3 O=QuoVadis Limited +# Subject: CN=QuoVadis Root CA 1 G3 O=QuoVadis Limited +# Label: "QuoVadis Root CA 1 G3" +# Serial: 687049649626669250736271037606554624078720034195 +# MD5 Fingerprint: a4:bc:5b:3f:fe:37:9a:fa:64:f0:e2:fa:05:3d:0b:ab +# SHA1 Fingerprint: 1b:8e:ea:57:96:29:1a:c9:39:ea:b8:0a:81:1a:73:73:c0:93:79:67 +# SHA256 Fingerprint: 8a:86:6f:d1:b2:76:b5:7e:57:8e:92:1c:65:82:8a:2b:ed:58:e9:f2:f2:88:05:41:34:b7:f1:f4:bf:c9:cc:74 +-----BEGIN CERTIFICATE----- +MIIFYDCCA0igAwIBAgIUeFhfLq0sGUvjNwc1NBMotZbUZZMwDQYJKoZIhvcNAQEL +BQAwSDELMAkGA1UEBhMCQk0xGTAXBgNVBAoTEFF1b1ZhZGlzIExpbWl0ZWQxHjAc +BgNVBAMTFVF1b1ZhZGlzIFJvb3QgQ0EgMSBHMzAeFw0xMjAxMTIxNzI3NDRaFw00 +MjAxMTIxNzI3NDRaMEgxCzAJBgNVBAYTAkJNMRkwFwYDVQQKExBRdW9WYWRpcyBM +aW1pdGVkMR4wHAYDVQQDExVRdW9WYWRpcyBSb290IENBIDEgRzMwggIiMA0GCSqG +SIb3DQEBAQUAA4ICDwAwggIKAoICAQCgvlAQjunybEC0BJyFuTHK3C3kEakEPBtV +wedYMB0ktMPvhd6MLOHBPd+C5k+tR4ds7FtJwUrVu4/sh6x/gpqG7D0DmVIB0jWe +rNrwU8lmPNSsAgHaJNM7qAJGr6Qc4/hzWHa39g6QDbXwz8z6+cZM5cOGMAqNF341 +68Xfuw6cwI2H44g4hWf6Pser4BOcBRiYz5P1sZK0/CPTz9XEJ0ngnjybCKOLXSoh +4Pw5qlPafX7PGglTvF0FBM+hSo+LdoINofjSxxR3W5A2B4GbPgb6Ul5jxaYA/qXp +UhtStZI5cgMJYr2wYBZupt0lwgNm3fME0UDiTouG9G/lg6AnhF4EwfWQvTA9xO+o +abw4m6SkltFi2mnAAZauy8RRNOoMqv8hjlmPSlzkYZqn0ukqeI1RPToV7qJZjqlc +3sX5kCLliEVx3ZGZbHqfPT2YfF72vhZooF6uCyP8Wg+qInYtyaEQHeTTRCOQiJ/G +KubX9ZqzWB4vMIkIG1SitZgj7Ah3HJVdYdHLiZxfokqRmu8hqkkWCKi9YSgxyXSt +hfbZxbGL0eUQMk1fiyA6PEkfM4VZDdvLCXVDaXP7a3F98N/ETH3Goy7IlXnLc6KO +Tk0k+17kBL5yG6YnLUlamXrXXAkgt3+UuU/xDRxeiEIbEbfnkduebPRq34wGmAOt +zCjvpUfzUwIDAQABo0IwQDAPBgNVHRMBAf8EBTADAQH/MA4GA1UdDwEB/wQEAwIB +BjAdBgNVHQ4EFgQUo5fW816iEOGrRZ88F2Q87gFwnMwwDQYJKoZIhvcNAQELBQAD +ggIBABj6W3X8PnrHX3fHyt/PX8MSxEBd1DKquGrX1RUVRpgjpeaQWxiZTOOtQqOC +MTaIzen7xASWSIsBx40Bz1szBpZGZnQdT+3Btrm0DWHMY37XLneMlhwqI2hrhVd2 +cDMT/uFPpiN3GPoajOi9ZcnPP/TJF9zrx7zABC4tRi9pZsMbj/7sPtPKlL92CiUN +qXsCHKnQO18LwIE6PWThv6ctTr1NxNgpxiIY0MWscgKCP6o6ojoilzHdCGPDdRS5 +YCgtW2jgFqlmgiNR9etT2DGbe+m3nUvriBbP+V04ikkwj+3x6xn0dxoxGE1nVGwv +b2X52z3sIexe9PSLymBlVNFxZPT5pqOBMzYzcfCkeF9OrYMh3jRJjehZrJ3ydlo2 +8hP0r+AJx2EqbPfgna67hkooby7utHnNkDPDs3b69fBsnQGQ+p6Q9pxyz0fawx/k +NSBT8lTR32GDpgLiJTjehTItXnOQUl1CxM49S+H5GYQd1aJQzEH7QRTDvdbJWqNj +ZgKAvQU6O0ec7AAmTPWIUb+oI38YB7AL7YsmoWTTYUrrXJ/es69nA7Mf3W1daWhp +q1467HxpvMc7hU6eFbm0FU/DlXpY18ls6Wy58yljXrQs8C097Vpl4KlbQMJImYFt +nh8GKjwStIsPm6Ik8KaN1nrgS7ZklmOVhMJKzRwuJIczYOXD +-----END CERTIFICATE----- + +# Issuer: CN=QuoVadis Root CA 2 G3 O=QuoVadis Limited +# Subject: CN=QuoVadis Root CA 2 G3 O=QuoVadis Limited +# Label: "QuoVadis Root CA 2 G3" +# Serial: 390156079458959257446133169266079962026824725800 +# MD5 Fingerprint: af:0c:86:6e:bf:40:2d:7f:0b:3e:12:50:ba:12:3d:06 +# SHA1 Fingerprint: 09:3c:61:f3:8b:8b:dc:7d:55:df:75:38:02:05:00:e1:25:f5:c8:36 +# SHA256 Fingerprint: 8f:e4:fb:0a:f9:3a:4d:0d:67:db:0b:eb:b2:3e:37:c7:1b:f3:25:dc:bc:dd:24:0e:a0:4d:af:58:b4:7e:18:40 +-----BEGIN CERTIFICATE----- +MIIFYDCCA0igAwIBAgIURFc0JFuBiZs18s64KztbpybwdSgwDQYJKoZIhvcNAQEL +BQAwSDELMAkGA1UEBhMCQk0xGTAXBgNVBAoTEFF1b1ZhZGlzIExpbWl0ZWQxHjAc +BgNVBAMTFVF1b1ZhZGlzIFJvb3QgQ0EgMiBHMzAeFw0xMjAxMTIxODU5MzJaFw00 +MjAxMTIxODU5MzJaMEgxCzAJBgNVBAYTAkJNMRkwFwYDVQQKExBRdW9WYWRpcyBM +aW1pdGVkMR4wHAYDVQQDExVRdW9WYWRpcyBSb290IENBIDIgRzMwggIiMA0GCSqG +SIb3DQEBAQUAA4ICDwAwggIKAoICAQChriWyARjcV4g/Ruv5r+LrI3HimtFhZiFf +qq8nUeVuGxbULX1QsFN3vXg6YOJkApt8hpvWGo6t/x8Vf9WVHhLL5hSEBMHfNrMW +n4rjyduYNM7YMxcoRvynyfDStNVNCXJJ+fKH46nafaF9a7I6JaltUkSs+L5u+9ym +c5GQYaYDFCDy54ejiK2toIz/pgslUiXnFgHVy7g1gQyjO/Dh4fxaXc6AcW34Sas+ +O7q414AB+6XrW7PFXmAqMaCvN+ggOp+oMiwMzAkd056OXbxMmO7FGmh77FOm6RQ1 +o9/NgJ8MSPsc9PG/Srj61YxxSscfrf5BmrODXfKEVu+lV0POKa2Mq1W/xPtbAd0j +IaFYAI7D0GoT7RPjEiuA3GfmlbLNHiJuKvhB1PLKFAeNilUSxmn1uIZoL1NesNKq +IcGY5jDjZ1XHm26sGahVpkUG0CM62+tlXSoREfA7T8pt9DTEceT/AFr2XK4jYIVz +8eQQsSWu1ZK7E8EM4DnatDlXtas1qnIhO4M15zHfeiFuuDIIfR0ykRVKYnLP43eh +vNURG3YBZwjgQQvD6xVu+KQZ2aKrr+InUlYrAoosFCT5v0ICvybIxo/gbjh9Uy3l +7ZizlWNof/k19N+IxWA1ksB8aRxhlRbQ694Lrz4EEEVlWFA4r0jyWbYW8jwNkALG +cC4BrTwV1wIDAQABo0IwQDAPBgNVHRMBAf8EBTADAQH/MA4GA1UdDwEB/wQEAwIB +BjAdBgNVHQ4EFgQU7edvdlq/YOxJW8ald7tyFnGbxD0wDQYJKoZIhvcNAQELBQAD +ggIBAJHfgD9DCX5xwvfrs4iP4VGyvD11+ShdyLyZm3tdquXK4Qr36LLTn91nMX66 +AarHakE7kNQIXLJgapDwyM4DYvmL7ftuKtwGTTwpD4kWilhMSA/ohGHqPHKmd+RC +roijQ1h5fq7KpVMNqT1wvSAZYaRsOPxDMuHBR//47PERIjKWnML2W2mWeyAMQ0Ga +W/ZZGYjeVYg3UQt4XAoeo0L9x52ID8DyeAIkVJOviYeIyUqAHerQbj5hLja7NQ4n +lv1mNDthcnPxFlxHBlRJAHpYErAK74X9sbgzdWqTHBLmYF5vHX/JHyPLhGGfHoJE ++V+tYlUkmlKY7VHnoX6XOuYvHxHaU4AshZ6rNRDbIl9qxV6XU/IyAgkwo1jwDQHV +csaxfGl7w/U2Rcxhbl5MlMVerugOXou/983g7aEOGzPuVBj+D77vfoRrQ+NwmNtd +dbINWQeFFSM51vHfqSYP1kjHs6Yi9TM3WpVHn3u6GBVv/9YUZINJ0gpnIdsPNWNg +KCLjsZWDzYWm3S8P52dSbrsvhXz1SnPnxT7AvSESBT/8twNJAlvIJebiVDj1eYeM +HVOyToV7BjjHLPj4sHKNJeV3UvQDHEimUF+IIDBu8oJDqz2XhOdT+yHBTw8imoa4 +WSr2Rz0ZiC3oheGe7IUIarFsNMkd7EgrO3jtZsSOeWmD3n+M +-----END CERTIFICATE----- + +# Issuer: CN=QuoVadis Root CA 3 G3 O=QuoVadis Limited +# Subject: CN=QuoVadis Root CA 3 G3 O=QuoVadis Limited +# Label: "QuoVadis Root CA 3 G3" +# Serial: 268090761170461462463995952157327242137089239581 +# MD5 Fingerprint: df:7d:b9:ad:54:6f:68:a1:df:89:57:03:97:43:b0:d7 +# SHA1 Fingerprint: 48:12:bd:92:3c:a8:c4:39:06:e7:30:6d:27:96:e6:a4:cf:22:2e:7d +# SHA256 Fingerprint: 88:ef:81:de:20:2e:b0:18:45:2e:43:f8:64:72:5c:ea:5f:bd:1f:c2:d9:d2:05:73:07:09:c5:d8:b8:69:0f:46 +-----BEGIN CERTIFICATE----- +MIIFYDCCA0igAwIBAgIULvWbAiin23r/1aOp7r0DoM8Sah0wDQYJKoZIhvcNAQEL +BQAwSDELMAkGA1UEBhMCQk0xGTAXBgNVBAoTEFF1b1ZhZGlzIExpbWl0ZWQxHjAc +BgNVBAMTFVF1b1ZhZGlzIFJvb3QgQ0EgMyBHMzAeFw0xMjAxMTIyMDI2MzJaFw00 +MjAxMTIyMDI2MzJaMEgxCzAJBgNVBAYTAkJNMRkwFwYDVQQKExBRdW9WYWRpcyBM +aW1pdGVkMR4wHAYDVQQDExVRdW9WYWRpcyBSb290IENBIDMgRzMwggIiMA0GCSqG +SIb3DQEBAQUAA4ICDwAwggIKAoICAQCzyw4QZ47qFJenMioKVjZ/aEzHs286IxSR +/xl/pcqs7rN2nXrpixurazHb+gtTTK/FpRp5PIpM/6zfJd5O2YIyC0TeytuMrKNu +FoM7pmRLMon7FhY4futD4tN0SsJiCnMK3UmzV9KwCoWdcTzeo8vAMvMBOSBDGzXR +U7Ox7sWTaYI+FrUoRqHe6okJ7UO4BUaKhvVZR74bbwEhELn9qdIoyhA5CcoTNs+c +ra1AdHkrAj80//ogaX3T7mH1urPnMNA3I4ZyYUUpSFlob3emLoG+B01vr87ERROR +FHAGjx+f+IdpsQ7vw4kZ6+ocYfx6bIrc1gMLnia6Et3UVDmrJqMz6nWB2i3ND0/k +A9HvFZcba5DFApCTZgIhsUfei5pKgLlVj7WiL8DWM2fafsSntARE60f75li59wzw +eyuxwHApw0BiLTtIadwjPEjrewl5qW3aqDCYz4ByA4imW0aucnl8CAMhZa634Ryl +sSqiMd5mBPfAdOhx3v89WcyWJhKLhZVXGqtrdQtEPREoPHtht+KPZ0/l7DxMYIBp +VzgeAVuNVejH38DMdyM0SXV89pgR6y3e7UEuFAUCf+D+IOs15xGsIs5XPd7JMG0Q +A4XN8f+MFrXBsj6IbGB/kE+V9/YtrQE5BwT6dYB9v0lQ7e/JxHwc64B+27bQ3RP+ +ydOc17KXqQIDAQABo0IwQDAPBgNVHRMBAf8EBTADAQH/MA4GA1UdDwEB/wQEAwIB +BjAdBgNVHQ4EFgQUxhfQvKjqAkPyGwaZXSuQILnXnOQwDQYJKoZIhvcNAQELBQAD +ggIBADRh2Va1EodVTd2jNTFGu6QHcrxfYWLopfsLN7E8trP6KZ1/AvWkyaiTt3px +KGmPc+FSkNrVvjrlt3ZqVoAh313m6Tqe5T72omnHKgqwGEfcIHB9UqM+WXzBusnI +FUBhynLWcKzSt/Ac5IYp8M7vaGPQtSCKFWGafoaYtMnCdvvMujAWzKNhxnQT5Wvv +oxXqA/4Ti2Tk08HS6IT7SdEQTXlm66r99I0xHnAUrdzeZxNMgRVhvLfZkXdxGYFg +u/BYpbWcC/ePIlUnwEsBbTuZDdQdm2NnL9DuDcpmvJRPpq3t/O5jrFc/ZSXPsoaP +0Aj/uHYUbt7lJ+yreLVTubY/6CD50qi+YUbKh4yE8/nxoGibIh6BJpsQBJFxwAYf +3KDTuVan45gtf4Od34wrnDKOMpTwATwiKp9Dwi7DmDkHOHv8XgBCH/MyJnmDhPbl +8MFREsALHgQjDFSlTC9JxUrRtm5gDWv8a4uFJGS3iQ6rJUdbPM9+Sb3H6QrG2vd+ +DhcI00iX0HGS8A85PjRqHH3Y8iKuu2n0M7SmSFXRDw4m6Oy2Cy2nhTXN/VnIn9HN +PlopNLk9hM6xZdRZkZFWdSHBd575euFgndOtBBj0fOtek49TSiIp+EgrPk2GrFt/ +ywaZWWDYWGWVjUTR939+J399roD1B0y2PpxxVJkES/1Y+Zj0 +-----END CERTIFICATE----- + +# Issuer: CN=DigiCert Assured ID Root G2 O=DigiCert Inc OU=www.digicert.com +# Subject: CN=DigiCert Assured ID Root G2 O=DigiCert Inc OU=www.digicert.com +# Label: "DigiCert Assured ID Root G2" +# Serial: 15385348160840213938643033620894905419 +# MD5 Fingerprint: 92:38:b9:f8:63:24:82:65:2c:57:33:e6:fe:81:8f:9d +# SHA1 Fingerprint: a1:4b:48:d9:43:ee:0a:0e:40:90:4f:3c:e0:a4:c0:91:93:51:5d:3f +# SHA256 Fingerprint: 7d:05:eb:b6:82:33:9f:8c:94:51:ee:09:4e:eb:fe:fa:79:53:a1:14:ed:b2:f4:49:49:45:2f:ab:7d:2f:c1:85 +-----BEGIN CERTIFICATE----- +MIIDljCCAn6gAwIBAgIQC5McOtY5Z+pnI7/Dr5r0SzANBgkqhkiG9w0BAQsFADBl +MQswCQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3 +d3cuZGlnaWNlcnQuY29tMSQwIgYDVQQDExtEaWdpQ2VydCBBc3N1cmVkIElEIFJv +b3QgRzIwHhcNMTMwODAxMTIwMDAwWhcNMzgwMTE1MTIwMDAwWjBlMQswCQYDVQQG +EwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3d3cuZGlnaWNl +cnQuY29tMSQwIgYDVQQDExtEaWdpQ2VydCBBc3N1cmVkIElEIFJvb3QgRzIwggEi +MA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQDZ5ygvUj82ckmIkzTz+GoeMVSA +n61UQbVH35ao1K+ALbkKz3X9iaV9JPrjIgwrvJUXCzO/GU1BBpAAvQxNEP4Htecc +biJVMWWXvdMX0h5i89vqbFCMP4QMls+3ywPgym2hFEwbid3tALBSfK+RbLE4E9Hp +EgjAALAcKxHad3A2m67OeYfcgnDmCXRwVWmvo2ifv922ebPynXApVfSr/5Vh88lA +bx3RvpO704gqu52/clpWcTs/1PPRCv4o76Pu2ZmvA9OPYLfykqGxvYmJHzDNw6Yu +YjOuFgJ3RFrngQo8p0Quebg/BLxcoIfhG69Rjs3sLPr4/m3wOnyqi+RnlTGNAgMB +AAGjQjBAMA8GA1UdEwEB/wQFMAMBAf8wDgYDVR0PAQH/BAQDAgGGMB0GA1UdDgQW +BBTOw0q5mVXyuNtgv6l+vVa1lzan1jANBgkqhkiG9w0BAQsFAAOCAQEAyqVVjOPI +QW5pJ6d1Ee88hjZv0p3GeDgdaZaikmkuOGybfQTUiaWxMTeKySHMq2zNixya1r9I +0jJmwYrA8y8678Dj1JGG0VDjA9tzd29KOVPt3ibHtX2vK0LRdWLjSisCx1BL4Gni +lmwORGYQRI+tBev4eaymG+g3NJ1TyWGqolKvSnAWhsI6yLETcDbYz+70CjTVW0z9 +B5yiutkBclzzTcHdDrEcDcRjvq30FPuJ7KJBDkzMyFdA0G4Dqs0MjomZmWzwPDCv +ON9vvKO+KSAnq3T/EyJ43pdSVR6DtVQgA+6uwE9W3jfMw3+qBCe703e4YtsXfJwo +IhNzbM8m9Yop5w== +-----END CERTIFICATE----- + +# Issuer: CN=DigiCert Assured ID Root G3 O=DigiCert Inc OU=www.digicert.com +# Subject: CN=DigiCert Assured ID Root G3 O=DigiCert Inc OU=www.digicert.com +# Label: "DigiCert Assured ID Root G3" +# Serial: 15459312981008553731928384953135426796 +# MD5 Fingerprint: 7c:7f:65:31:0c:81:df:8d:ba:3e:99:e2:5c:ad:6e:fb +# SHA1 Fingerprint: f5:17:a2:4f:9a:48:c6:c9:f8:a2:00:26:9f:dc:0f:48:2c:ab:30:89 +# SHA256 Fingerprint: 7e:37:cb:8b:4c:47:09:0c:ab:36:55:1b:a6:f4:5d:b8:40:68:0f:ba:16:6a:95:2d:b1:00:71:7f:43:05:3f:c2 +-----BEGIN CERTIFICATE----- +MIICRjCCAc2gAwIBAgIQC6Fa+h3foLVJRK/NJKBs7DAKBggqhkjOPQQDAzBlMQsw +CQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3d3cu +ZGlnaWNlcnQuY29tMSQwIgYDVQQDExtEaWdpQ2VydCBBc3N1cmVkIElEIFJvb3Qg +RzMwHhcNMTMwODAxMTIwMDAwWhcNMzgwMTE1MTIwMDAwWjBlMQswCQYDVQQGEwJV +UzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3d3cuZGlnaWNlcnQu +Y29tMSQwIgYDVQQDExtEaWdpQ2VydCBBc3N1cmVkIElEIFJvb3QgRzMwdjAQBgcq +hkjOPQIBBgUrgQQAIgNiAAQZ57ysRGXtzbg/WPuNsVepRC0FFfLvC/8QdJ+1YlJf +Zn4f5dwbRXkLzMZTCp2NXQLZqVneAlr2lSoOjThKiknGvMYDOAdfVdp+CW7if17Q +RSAPWXYQ1qAk8C3eNvJsKTmjQjBAMA8GA1UdEwEB/wQFMAMBAf8wDgYDVR0PAQH/ +BAQDAgGGMB0GA1UdDgQWBBTL0L2p4ZgFUaFNN6KDec6NHSrkhDAKBggqhkjOPQQD +AwNnADBkAjAlpIFFAmsSS3V0T8gj43DydXLefInwz5FyYZ5eEJJZVrmDxxDnOOlY +JjZ91eQ0hjkCMHw2U/Aw5WJjOpnitqM7mzT6HtoQknFekROn3aRukswy1vUhZscv +6pZjamVFkpUBtA== +-----END CERTIFICATE----- + +# Issuer: CN=DigiCert Global Root G2 O=DigiCert Inc OU=www.digicert.com +# Subject: CN=DigiCert Global Root G2 O=DigiCert Inc OU=www.digicert.com +# Label: "DigiCert Global Root G2" +# Serial: 4293743540046975378534879503202253541 +# MD5 Fingerprint: e4:a6:8a:c8:54:ac:52:42:46:0a:fd:72:48:1b:2a:44 +# SHA1 Fingerprint: df:3c:24:f9:bf:d6:66:76:1b:26:80:73:fe:06:d1:cc:8d:4f:82:a4 +# SHA256 Fingerprint: cb:3c:cb:b7:60:31:e5:e0:13:8f:8d:d3:9a:23:f9:de:47:ff:c3:5e:43:c1:14:4c:ea:27:d4:6a:5a:b1:cb:5f +-----BEGIN CERTIFICATE----- +MIIDjjCCAnagAwIBAgIQAzrx5qcRqaC7KGSxHQn65TANBgkqhkiG9w0BAQsFADBh +MQswCQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3 +d3cuZGlnaWNlcnQuY29tMSAwHgYDVQQDExdEaWdpQ2VydCBHbG9iYWwgUm9vdCBH +MjAeFw0xMzA4MDExMjAwMDBaFw0zODAxMTUxMjAwMDBaMGExCzAJBgNVBAYTAlVT +MRUwEwYDVQQKEwxEaWdpQ2VydCBJbmMxGTAXBgNVBAsTEHd3dy5kaWdpY2VydC5j +b20xIDAeBgNVBAMTF0RpZ2lDZXJ0IEdsb2JhbCBSb290IEcyMIIBIjANBgkqhkiG +9w0BAQEFAAOCAQ8AMIIBCgKCAQEAuzfNNNx7a8myaJCtSnX/RrohCgiN9RlUyfuI +2/Ou8jqJkTx65qsGGmvPrC3oXgkkRLpimn7Wo6h+4FR1IAWsULecYxpsMNzaHxmx +1x7e/dfgy5SDN67sH0NO3Xss0r0upS/kqbitOtSZpLYl6ZtrAGCSYP9PIUkY92eQ +q2EGnI/yuum06ZIya7XzV+hdG82MHauVBJVJ8zUtluNJbd134/tJS7SsVQepj5Wz +tCO7TG1F8PapspUwtP1MVYwnSlcUfIKdzXOS0xZKBgyMUNGPHgm+F6HmIcr9g+UQ +vIOlCsRnKPZzFBQ9RnbDhxSJITRNrw9FDKZJobq7nMWxM4MphQIDAQABo0IwQDAP +BgNVHRMBAf8EBTADAQH/MA4GA1UdDwEB/wQEAwIBhjAdBgNVHQ4EFgQUTiJUIBiV +5uNu5g/6+rkS7QYXjzkwDQYJKoZIhvcNAQELBQADggEBAGBnKJRvDkhj6zHd6mcY +1Yl9PMWLSn/pvtsrF9+wX3N3KjITOYFnQoQj8kVnNeyIv/iPsGEMNKSuIEyExtv4 +NeF22d+mQrvHRAiGfzZ0JFrabA0UWTW98kndth/Jsw1HKj2ZL7tcu7XUIOGZX1NG +Fdtom/DzMNU+MeKNhJ7jitralj41E6Vf8PlwUHBHQRFXGU7Aj64GxJUTFy8bJZ91 +8rGOmaFvE7FBcf6IKshPECBV1/MUReXgRPTqh5Uykw7+U0b6LJ3/iyK5S9kJRaTe +pLiaWN0bfVKfjllDiIGknibVb63dDcY3fe0Dkhvld1927jyNxF1WW6LZZm6zNTfl +MrY= +-----END CERTIFICATE----- + +# Issuer: CN=DigiCert Global Root G3 O=DigiCert Inc OU=www.digicert.com +# Subject: CN=DigiCert Global Root G3 O=DigiCert Inc OU=www.digicert.com +# Label: "DigiCert Global Root G3" +# Serial: 7089244469030293291760083333884364146 +# MD5 Fingerprint: f5:5d:a4:50:a5:fb:28:7e:1e:0f:0d:cc:96:57:56:ca +# SHA1 Fingerprint: 7e:04:de:89:6a:3e:66:6d:00:e6:87:d3:3f:fa:d9:3b:e8:3d:34:9e +# SHA256 Fingerprint: 31:ad:66:48:f8:10:41:38:c7:38:f3:9e:a4:32:01:33:39:3e:3a:18:cc:02:29:6e:f9:7c:2a:c9:ef:67:31:d0 +-----BEGIN CERTIFICATE----- +MIICPzCCAcWgAwIBAgIQBVVWvPJepDU1w6QP1atFcjAKBggqhkjOPQQDAzBhMQsw +CQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3d3cu +ZGlnaWNlcnQuY29tMSAwHgYDVQQDExdEaWdpQ2VydCBHbG9iYWwgUm9vdCBHMzAe +Fw0xMzA4MDExMjAwMDBaFw0zODAxMTUxMjAwMDBaMGExCzAJBgNVBAYTAlVTMRUw +EwYDVQQKEwxEaWdpQ2VydCBJbmMxGTAXBgNVBAsTEHd3dy5kaWdpY2VydC5jb20x +IDAeBgNVBAMTF0RpZ2lDZXJ0IEdsb2JhbCBSb290IEczMHYwEAYHKoZIzj0CAQYF +K4EEACIDYgAE3afZu4q4C/sLfyHS8L6+c/MzXRq8NOrexpu80JX28MzQC7phW1FG +fp4tn+6OYwwX7Adw9c+ELkCDnOg/QW07rdOkFFk2eJ0DQ+4QE2xy3q6Ip6FrtUPO +Z9wj/wMco+I+o0IwQDAPBgNVHRMBAf8EBTADAQH/MA4GA1UdDwEB/wQEAwIBhjAd +BgNVHQ4EFgQUs9tIpPmhxdiuNkHMEWNpYim8S8YwCgYIKoZIzj0EAwMDaAAwZQIx +AK288mw/EkrRLTnDCgmXc/SINoyIJ7vmiI1Qhadj+Z4y3maTD/HMsQmP3Wyr+mt/ +oAIwOWZbwmSNuJ5Q3KjVSaLtx9zRSX8XAbjIho9OjIgrqJqpisXRAL34VOKa5Vt8 +sycX +-----END CERTIFICATE----- + +# Issuer: CN=DigiCert Trusted Root G4 O=DigiCert Inc OU=www.digicert.com +# Subject: CN=DigiCert Trusted Root G4 O=DigiCert Inc OU=www.digicert.com +# Label: "DigiCert Trusted Root G4" +# Serial: 7451500558977370777930084869016614236 +# MD5 Fingerprint: 78:f2:fc:aa:60:1f:2f:b4:eb:c9:37:ba:53:2e:75:49 +# SHA1 Fingerprint: dd:fb:16:cd:49:31:c9:73:a2:03:7d:3f:c8:3a:4d:7d:77:5d:05:e4 +# SHA256 Fingerprint: 55:2f:7b:dc:f1:a7:af:9e:6c:e6:72:01:7f:4f:12:ab:f7:72:40:c7:8e:76:1a:c2:03:d1:d9:d2:0a:c8:99:88 +-----BEGIN CERTIFICATE----- +MIIFkDCCA3igAwIBAgIQBZsbV56OITLiOQe9p3d1XDANBgkqhkiG9w0BAQwFADBi +MQswCQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3 +d3cuZGlnaWNlcnQuY29tMSEwHwYDVQQDExhEaWdpQ2VydCBUcnVzdGVkIFJvb3Qg +RzQwHhcNMTMwODAxMTIwMDAwWhcNMzgwMTE1MTIwMDAwWjBiMQswCQYDVQQGEwJV +UzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3d3cuZGlnaWNlcnQu +Y29tMSEwHwYDVQQDExhEaWdpQ2VydCBUcnVzdGVkIFJvb3QgRzQwggIiMA0GCSqG +SIb3DQEBAQUAA4ICDwAwggIKAoICAQC/5pBzaN675F1KPDAiMGkz7MKnJS7JIT3y +ithZwuEppz1Yq3aaza57G4QNxDAf8xukOBbrVsaXbR2rsnnyyhHS5F/WBTxSD1If +xp4VpX6+n6lXFllVcq9ok3DCsrp1mWpzMpTREEQQLt+C8weE5nQ7bXHiLQwb7iDV +ySAdYyktzuxeTsiT+CFhmzTrBcZe7FsavOvJz82sNEBfsXpm7nfISKhmV1efVFiO +DCu3T6cw2Vbuyntd463JT17lNecxy9qTXtyOj4DatpGYQJB5w3jHtrHEtWoYOAMQ +jdjUN6QuBX2I9YI+EJFwq1WCQTLX2wRzKm6RAXwhTNS8rhsDdV14Ztk6MUSaM0C/ +CNdaSaTC5qmgZ92kJ7yhTzm1EVgX9yRcRo9k98FpiHaYdj1ZXUJ2h4mXaXpI8OCi +EhtmmnTK3kse5w5jrubU75KSOp493ADkRSWJtppEGSt+wJS00mFt6zPZxd9LBADM +fRyVw4/3IbKyEbe7f/LVjHAsQWCqsWMYRJUadmJ+9oCw++hkpjPRiQfhvbfmQ6QY +uKZ3AeEPlAwhHbJUKSWJbOUOUlFHdL4mrLZBdd56rF+NP8m800ERElvlEFDrMcXK +chYiCd98THU/Y+whX8QgUWtvsauGi0/C1kVfnSD8oR7FwI+isX4KJpn15GkvmB0t +9dmpsh3lGwIDAQABo0IwQDAPBgNVHRMBAf8EBTADAQH/MA4GA1UdDwEB/wQEAwIB +hjAdBgNVHQ4EFgQU7NfjgtJxXWRM3y5nP+e6mK4cD08wDQYJKoZIhvcNAQEMBQAD +ggIBALth2X2pbL4XxJEbw6GiAI3jZGgPVs93rnD5/ZpKmbnJeFwMDF/k5hQpVgs2 +SV1EY+CtnJYYZhsjDT156W1r1lT40jzBQ0CuHVD1UvyQO7uYmWlrx8GnqGikJ9yd ++SeuMIW59mdNOj6PWTkiU0TryF0Dyu1Qen1iIQqAyHNm0aAFYF/opbSnr6j3bTWc +fFqK1qI4mfN4i/RN0iAL3gTujJtHgXINwBQy7zBZLq7gcfJW5GqXb5JQbZaNaHqa +sjYUegbyJLkJEVDXCLG4iXqEI2FCKeWjzaIgQdfRnGTZ6iahixTXTBmyUEFxPT9N +cCOGDErcgdLMMpSEDQgJlxxPwO5rIHQw0uA5NBCFIRUBCOhVMt5xSdkoF1BN5r5N +0XWs0Mr7QbhDparTwwVETyw2m+L64kW4I1NsBm9nVX9GtUw/bihaeSbSpKhil9Ie +4u1Ki7wb/UdKDd9nZn6yW0HQO+T0O/QEY+nvwlQAUaCKKsnOeMzV6ocEGLPOr0mI +r/OSmbaz5mEP0oUA51Aa5BuVnRmhuZyxm7EAHu/QD09CbMkKvO5D+jpxpchNJqU1 +/YldvIViHTLSoCtU7ZpXwdv6EM8Zt4tKG48BtieVU+i2iW1bvGjUI+iLUaJW+fCm +gKDWHrO8Dw9TdSmq6hN35N6MgSGtBxBHEa2HPQfRdbzP82Z+ +-----END CERTIFICATE----- + +# Issuer: CN=COMODO RSA Certification Authority O=COMODO CA Limited +# Subject: CN=COMODO RSA Certification Authority O=COMODO CA Limited +# Label: "COMODO RSA Certification Authority" +# Serial: 101909084537582093308941363524873193117 +# MD5 Fingerprint: 1b:31:b0:71:40:36:cc:14:36:91:ad:c4:3e:fd:ec:18 +# SHA1 Fingerprint: af:e5:d2:44:a8:d1:19:42:30:ff:47:9f:e2:f8:97:bb:cd:7a:8c:b4 +# SHA256 Fingerprint: 52:f0:e1:c4:e5:8e:c6:29:29:1b:60:31:7f:07:46:71:b8:5d:7e:a8:0d:5b:07:27:34:63:53:4b:32:b4:02:34 +-----BEGIN CERTIFICATE----- +MIIF2DCCA8CgAwIBAgIQTKr5yttjb+Af907YWwOGnTANBgkqhkiG9w0BAQwFADCB +hTELMAkGA1UEBhMCR0IxGzAZBgNVBAgTEkdyZWF0ZXIgTWFuY2hlc3RlcjEQMA4G +A1UEBxMHU2FsZm9yZDEaMBgGA1UEChMRQ09NT0RPIENBIExpbWl0ZWQxKzApBgNV +BAMTIkNPTU9ETyBSU0EgQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkwHhcNMTAwMTE5 +MDAwMDAwWhcNMzgwMTE4MjM1OTU5WjCBhTELMAkGA1UEBhMCR0IxGzAZBgNVBAgT +EkdyZWF0ZXIgTWFuY2hlc3RlcjEQMA4GA1UEBxMHU2FsZm9yZDEaMBgGA1UEChMR +Q09NT0RPIENBIExpbWl0ZWQxKzApBgNVBAMTIkNPTU9ETyBSU0EgQ2VydGlmaWNh +dGlvbiBBdXRob3JpdHkwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQCR +6FSS0gpWsawNJN3Fz0RndJkrN6N9I3AAcbxT38T6KhKPS38QVr2fcHK3YX/JSw8X +pz3jsARh7v8Rl8f0hj4K+j5c+ZPmNHrZFGvnnLOFoIJ6dq9xkNfs/Q36nGz637CC +9BR++b7Epi9Pf5l/tfxnQ3K9DADWietrLNPtj5gcFKt+5eNu/Nio5JIk2kNrYrhV +/erBvGy2i/MOjZrkm2xpmfh4SDBF1a3hDTxFYPwyllEnvGfDyi62a+pGx8cgoLEf +Zd5ICLqkTqnyg0Y3hOvozIFIQ2dOciqbXL1MGyiKXCJ7tKuY2e7gUYPDCUZObT6Z ++pUX2nwzV0E8jVHtC7ZcryxjGt9XyD+86V3Em69FmeKjWiS0uqlWPc9vqv9JWL7w +qP/0uK3pN/u6uPQLOvnoQ0IeidiEyxPx2bvhiWC4jChWrBQdnArncevPDt09qZah +SL0896+1DSJMwBGB7FY79tOi4lu3sgQiUpWAk2nojkxl8ZEDLXB0AuqLZxUpaVIC +u9ffUGpVRr+goyhhf3DQw6KqLCGqR84onAZFdr+CGCe01a60y1Dma/RMhnEw6abf +Fobg2P9A3fvQQoh/ozM6LlweQRGBY84YcWsr7KaKtzFcOmpH4MN5WdYgGq/yapiq +crxXStJLnbsQ/LBMQeXtHT1eKJ2czL+zUdqnR+WEUwIDAQABo0IwQDAdBgNVHQ4E +FgQUu69+Aj36pvE8hI6t7jiY7NkyMtQwDgYDVR0PAQH/BAQDAgEGMA8GA1UdEwEB +/wQFMAMBAf8wDQYJKoZIhvcNAQEMBQADggIBAArx1UaEt65Ru2yyTUEUAJNMnMvl +wFTPoCWOAvn9sKIN9SCYPBMtrFaisNZ+EZLpLrqeLppysb0ZRGxhNaKatBYSaVqM +4dc+pBroLwP0rmEdEBsqpIt6xf4FpuHA1sj+nq6PK7o9mfjYcwlYRm6mnPTXJ9OV +2jeDchzTc+CiR5kDOF3VSXkAKRzH7JsgHAckaVd4sjn8OoSgtZx8jb8uk2Intzna +FxiuvTwJaP+EmzzV1gsD41eeFPfR60/IvYcjt7ZJQ3mFXLrrkguhxuhoqEwWsRqZ +CuhTLJK7oQkYdQxlqHvLI7cawiiFwxv/0Cti76R7CZGYZ4wUAc1oBmpjIXUDgIiK +boHGhfKppC3n9KUkEEeDys30jXlYsQab5xoq2Z0B15R97QNKyvDb6KkBPvVWmcke +jkk9u+UJueBPSZI9FoJAzMxZxuY67RIuaTxslbH9qh17f4a+Hg4yRvv7E491f0yL +S0Zj/gA0QHDBw7mh3aZw4gSzQbzpgJHqZJx64SIDqZxubw5lT2yHh17zbqD5daWb +QOhTsiedSrnAdyGN/4fy3ryM7xfft0kL0fJuMAsaDk527RH89elWsn2/x20Kk4yl +0MC2Hb46TpSi125sC8KKfPog88Tk5c0NqMuRkrF8hey1FGlmDoLnzc7ILaZRfyHB +NVOFBkpdn627G190 +-----END CERTIFICATE----- + +# Issuer: CN=USERTrust RSA Certification Authority O=The USERTRUST Network +# Subject: CN=USERTrust RSA Certification Authority O=The USERTRUST Network +# Label: "USERTrust RSA Certification Authority" +# Serial: 2645093764781058787591871645665788717 +# MD5 Fingerprint: 1b:fe:69:d1:91:b7:19:33:a3:72:a8:0f:e1:55:e5:b5 +# SHA1 Fingerprint: 2b:8f:1b:57:33:0d:bb:a2:d0:7a:6c:51:f7:0e:e9:0d:da:b9:ad:8e +# SHA256 Fingerprint: e7:93:c9:b0:2f:d8:aa:13:e2:1c:31:22:8a:cc:b0:81:19:64:3b:74:9c:89:89:64:b1:74:6d:46:c3:d4:cb:d2 +-----BEGIN CERTIFICATE----- +MIIF3jCCA8agAwIBAgIQAf1tMPyjylGoG7xkDjUDLTANBgkqhkiG9w0BAQwFADCB +iDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCk5ldyBKZXJzZXkxFDASBgNVBAcTC0pl +cnNleSBDaXR5MR4wHAYDVQQKExVUaGUgVVNFUlRSVVNUIE5ldHdvcmsxLjAsBgNV +BAMTJVVTRVJUcnVzdCBSU0EgQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkwHhcNMTAw +MjAxMDAwMDAwWhcNMzgwMTE4MjM1OTU5WjCBiDELMAkGA1UEBhMCVVMxEzARBgNV +BAgTCk5ldyBKZXJzZXkxFDASBgNVBAcTC0plcnNleSBDaXR5MR4wHAYDVQQKExVU +aGUgVVNFUlRSVVNUIE5ldHdvcmsxLjAsBgNVBAMTJVVTRVJUcnVzdCBSU0EgQ2Vy +dGlmaWNhdGlvbiBBdXRob3JpdHkwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIK +AoICAQCAEmUXNg7D2wiz0KxXDXbtzSfTTK1Qg2HiqiBNCS1kCdzOiZ/MPans9s/B +3PHTsdZ7NygRK0faOca8Ohm0X6a9fZ2jY0K2dvKpOyuR+OJv0OwWIJAJPuLodMkY +tJHUYmTbf6MG8YgYapAiPLz+E/CHFHv25B+O1ORRxhFnRghRy4YUVD+8M/5+bJz/ +Fp0YvVGONaanZshyZ9shZrHUm3gDwFA66Mzw3LyeTP6vBZY1H1dat//O+T23LLb2 +VN3I5xI6Ta5MirdcmrS3ID3KfyI0rn47aGYBROcBTkZTmzNg95S+UzeQc0PzMsNT +79uq/nROacdrjGCT3sTHDN/hMq7MkztReJVni+49Vv4M0GkPGw/zJSZrM233bkf6 +c0Plfg6lZrEpfDKEY1WJxA3Bk1QwGROs0303p+tdOmw1XNtB1xLaqUkL39iAigmT +Yo61Zs8liM2EuLE/pDkP2QKe6xJMlXzzawWpXhaDzLhn4ugTncxbgtNMs+1b/97l +c6wjOy0AvzVVdAlJ2ElYGn+SNuZRkg7zJn0cTRe8yexDJtC/QV9AqURE9JnnV4ee +UB9XVKg+/XRjL7FQZQnmWEIuQxpMtPAlR1n6BB6T1CZGSlCBst6+eLf8ZxXhyVeE +Hg9j1uliutZfVS7qXMYoCAQlObgOK6nyTJccBz8NUvXt7y+CDwIDAQABo0IwQDAd +BgNVHQ4EFgQUU3m/WqorSs9UgOHYm8Cd8rIDZsswDgYDVR0PAQH/BAQDAgEGMA8G +A1UdEwEB/wQFMAMBAf8wDQYJKoZIhvcNAQEMBQADggIBAFzUfA3P9wF9QZllDHPF +Up/L+M+ZBn8b2kMVn54CVVeWFPFSPCeHlCjtHzoBN6J2/FNQwISbxmtOuowhT6KO +VWKR82kV2LyI48SqC/3vqOlLVSoGIG1VeCkZ7l8wXEskEVX/JJpuXior7gtNn3/3 +ATiUFJVDBwn7YKnuHKsSjKCaXqeYalltiz8I+8jRRa8YFWSQEg9zKC7F4iRO/Fjs +8PRF/iKz6y+O0tlFYQXBl2+odnKPi4w2r78NBc5xjeambx9spnFixdjQg3IM8WcR +iQycE0xyNN+81XHfqnHd4blsjDwSXWXavVcStkNr/+XeTWYRUc+ZruwXtuhxkYze +Sf7dNXGiFSeUHM9h4ya7b6NnJSFd5t0dCy5oGzuCr+yDZ4XUmFF0sbmZgIn/f3gZ +XHlKYC6SQK5MNyosycdiyA5d9zZbyuAlJQG03RoHnHcAP9Dc1ew91Pq7P8yF1m9/ +qS3fuQL39ZeatTXaw2ewh0qpKJ4jjv9cJ2vhsE/zB+4ALtRZh8tSQZXq9EfX7mRB +VXyNWQKV3WKdwrnuWih0hKWbt5DHDAff9Yk2dDLWKMGwsAvgnEzDHNb842m1R0aB +L6KCq9NjRHDEjf8tM7qtj3u1cIiuPhnPQCjY/MiQu12ZIvVS5ljFH4gxQ+6IHdfG +jjxDah2nGN59PRbxYvnKkKj9 +-----END CERTIFICATE----- + +# Issuer: CN=USERTrust ECC Certification Authority O=The USERTRUST Network +# Subject: CN=USERTrust ECC Certification Authority O=The USERTRUST Network +# Label: "USERTrust ECC Certification Authority" +# Serial: 123013823720199481456569720443997572134 +# MD5 Fingerprint: fa:68:bc:d9:b5:7f:ad:fd:c9:1d:06:83:28:cc:24:c1 +# SHA1 Fingerprint: d1:cb:ca:5d:b2:d5:2a:7f:69:3b:67:4d:e5:f0:5a:1d:0c:95:7d:f0 +# SHA256 Fingerprint: 4f:f4:60:d5:4b:9c:86:da:bf:bc:fc:57:12:e0:40:0d:2b:ed:3f:bc:4d:4f:bd:aa:86:e0:6a:dc:d2:a9:ad:7a +-----BEGIN CERTIFICATE----- +MIICjzCCAhWgAwIBAgIQXIuZxVqUxdJxVt7NiYDMJjAKBggqhkjOPQQDAzCBiDEL +MAkGA1UEBhMCVVMxEzARBgNVBAgTCk5ldyBKZXJzZXkxFDASBgNVBAcTC0plcnNl +eSBDaXR5MR4wHAYDVQQKExVUaGUgVVNFUlRSVVNUIE5ldHdvcmsxLjAsBgNVBAMT +JVVTRVJUcnVzdCBFQ0MgQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkwHhcNMTAwMjAx +MDAwMDAwWhcNMzgwMTE4MjM1OTU5WjCBiDELMAkGA1UEBhMCVVMxEzARBgNVBAgT +Ck5ldyBKZXJzZXkxFDASBgNVBAcTC0plcnNleSBDaXR5MR4wHAYDVQQKExVUaGUg +VVNFUlRSVVNUIE5ldHdvcmsxLjAsBgNVBAMTJVVTRVJUcnVzdCBFQ0MgQ2VydGlm +aWNhdGlvbiBBdXRob3JpdHkwdjAQBgcqhkjOPQIBBgUrgQQAIgNiAAQarFRaqflo +I+d61SRvU8Za2EurxtW20eZzca7dnNYMYf3boIkDuAUU7FfO7l0/4iGzzvfUinng +o4N+LZfQYcTxmdwlkWOrfzCjtHDix6EznPO/LlxTsV+zfTJ/ijTjeXmjQjBAMB0G +A1UdDgQWBBQ64QmG1M8ZwpZ2dEl23OA1xmNjmjAOBgNVHQ8BAf8EBAMCAQYwDwYD +VR0TAQH/BAUwAwEB/zAKBggqhkjOPQQDAwNoADBlAjA2Z6EWCNzklwBBHU6+4WMB +zzuqQhFkoJ2UOQIReVx7Hfpkue4WQrO/isIJxOzksU0CMQDpKmFHjFJKS04YcPbW +RNZu9YO6bVi9JNlWSOrvxKJGgYhqOkbRqZtNyWHa0V1Xahg= +-----END CERTIFICATE----- + +# Issuer: CN=GlobalSign O=GlobalSign OU=GlobalSign ECC Root CA - R5 +# Subject: CN=GlobalSign O=GlobalSign OU=GlobalSign ECC Root CA - R5 +# Label: "GlobalSign ECC Root CA - R5" +# Serial: 32785792099990507226680698011560947931244 +# MD5 Fingerprint: 9f:ad:3b:1c:02:1e:8a:ba:17:74:38:81:0c:a2:bc:08 +# SHA1 Fingerprint: 1f:24:c6:30:cd:a4:18:ef:20:69:ff:ad:4f:dd:5f:46:3a:1b:69:aa +# SHA256 Fingerprint: 17:9f:bc:14:8a:3d:d0:0f:d2:4e:a1:34:58:cc:43:bf:a7:f5:9c:81:82:d7:83:a5:13:f6:eb:ec:10:0c:89:24 +-----BEGIN CERTIFICATE----- +MIICHjCCAaSgAwIBAgIRYFlJ4CYuu1X5CneKcflK2GwwCgYIKoZIzj0EAwMwUDEk +MCIGA1UECxMbR2xvYmFsU2lnbiBFQ0MgUm9vdCBDQSAtIFI1MRMwEQYDVQQKEwpH +bG9iYWxTaWduMRMwEQYDVQQDEwpHbG9iYWxTaWduMB4XDTEyMTExMzAwMDAwMFoX +DTM4MDExOTAzMTQwN1owUDEkMCIGA1UECxMbR2xvYmFsU2lnbiBFQ0MgUm9vdCBD +QSAtIFI1MRMwEQYDVQQKEwpHbG9iYWxTaWduMRMwEQYDVQQDEwpHbG9iYWxTaWdu +MHYwEAYHKoZIzj0CAQYFK4EEACIDYgAER0UOlvt9Xb/pOdEh+J8LttV7HpI6SFkc +8GIxLcB6KP4ap1yztsyX50XUWPrRd21DosCHZTQKH3rd6zwzocWdTaRvQZU4f8ke +hOvRnkmSh5SHDDqFSmafnVmTTZdhBoZKo0IwQDAOBgNVHQ8BAf8EBAMCAQYwDwYD +VR0TAQH/BAUwAwEB/zAdBgNVHQ4EFgQUPeYpSJvqB8ohREom3m7e0oPQn1kwCgYI +KoZIzj0EAwMDaAAwZQIxAOVpEslu28YxuglB4Zf4+/2a4n0Sye18ZNPLBSWLVtmg +515dTguDnFt2KaAJJiFqYgIwcdK1j1zqO+F4CYWodZI7yFz9SO8NdCKoCOJuxUnO +xwy8p2Fp8fc74SrL+SvzZpA3 +-----END CERTIFICATE----- + +# Issuer: CN=IdenTrust Commercial Root CA 1 O=IdenTrust +# Subject: CN=IdenTrust Commercial Root CA 1 O=IdenTrust +# Label: "IdenTrust Commercial Root CA 1" +# Serial: 13298821034946342390520003877796839426 +# MD5 Fingerprint: b3:3e:77:73:75:ee:a0:d3:e3:7e:49:63:49:59:bb:c7 +# SHA1 Fingerprint: df:71:7e:aa:4a:d9:4e:c9:55:84:99:60:2d:48:de:5f:bc:f0:3a:25 +# SHA256 Fingerprint: 5d:56:49:9b:e4:d2:e0:8b:cf:ca:d0:8a:3e:38:72:3d:50:50:3b:de:70:69:48:e4:2f:55:60:30:19:e5:28:ae +-----BEGIN CERTIFICATE----- +MIIFYDCCA0igAwIBAgIQCgFCgAAAAUUjyES1AAAAAjANBgkqhkiG9w0BAQsFADBK +MQswCQYDVQQGEwJVUzESMBAGA1UEChMJSWRlblRydXN0MScwJQYDVQQDEx5JZGVu +VHJ1c3QgQ29tbWVyY2lhbCBSb290IENBIDEwHhcNMTQwMTE2MTgxMjIzWhcNMzQw +MTE2MTgxMjIzWjBKMQswCQYDVQQGEwJVUzESMBAGA1UEChMJSWRlblRydXN0MScw +JQYDVQQDEx5JZGVuVHJ1c3QgQ29tbWVyY2lhbCBSb290IENBIDEwggIiMA0GCSqG +SIb3DQEBAQUAA4ICDwAwggIKAoICAQCnUBneP5k91DNG8W9RYYKyqU+PZ4ldhNlT +3Qwo2dfw/66VQ3KZ+bVdfIrBQuExUHTRgQ18zZshq0PirK1ehm7zCYofWjK9ouuU ++ehcCuz/mNKvcbO0U59Oh++SvL3sTzIwiEsXXlfEU8L2ApeN2WIrvyQfYo3fw7gp +S0l4PJNgiCL8mdo2yMKi1CxUAGc1bnO/AljwpN3lsKImesrgNqUZFvX9t++uP0D1 +bVoE/c40yiTcdCMbXTMTEl3EASX2MN0CXZ/g1Ue9tOsbobtJSdifWwLziuQkkORi +T0/Br4sOdBeo0XKIanoBScy0RnnGF7HamB4HWfp1IYVl3ZBWzvurpWCdxJ35UrCL +vYf5jysjCiN2O/cz4ckA82n5S6LgTrx+kzmEB/dEcH7+B1rlsazRGMzyNeVJSQjK +Vsk9+w8YfYs7wRPCTY/JTw436R+hDmrfYi7LNQZReSzIJTj0+kuniVyc0uMNOYZK +dHzVWYfCP04MXFL0PfdSgvHqo6z9STQaKPNBiDoT7uje/5kdX7rL6B7yuVBgwDHT +c+XvvqDtMwt0viAgxGds8AgDelWAf0ZOlqf0Hj7h9tgJ4TNkK2PXMl6f+cB7D3hv +l7yTmvmcEpB4eoCHFddydJxVdHixuuFucAS6T6C6aMN7/zHwcz09lCqxC0EOoP5N +iGVreTO01wIDAQABo0IwQDAOBgNVHQ8BAf8EBAMCAQYwDwYDVR0TAQH/BAUwAwEB +/zAdBgNVHQ4EFgQU7UQZwNPwBovupHu+QucmVMiONnYwDQYJKoZIhvcNAQELBQAD +ggIBAA2ukDL2pkt8RHYZYR4nKM1eVO8lvOMIkPkp165oCOGUAFjvLi5+U1KMtlwH +6oi6mYtQlNeCgN9hCQCTrQ0U5s7B8jeUeLBfnLOic7iPBZM4zY0+sLj7wM+x8uwt +LRvM7Kqas6pgghstO8OEPVeKlh6cdbjTMM1gCIOQ045U8U1mwF10A0Cj7oV+wh93 +nAbowacYXVKV7cndJZ5t+qntozo00Fl72u1Q8zW/7esUTTHHYPTa8Yec4kjixsU3 ++wYQ+nVZZjFHKdp2mhzpgq7vmrlR94gjmmmVYjzlVYA211QC//G5Xc7UI2/YRYRK +W2XviQzdFKcgyxilJbQN+QHwotL0AMh0jqEqSI5l2xPE4iUXfeu+h1sXIFRRk0pT +AwvsXcoz7WL9RccvW9xYoIA55vrX/hMUpu09lEpCdNTDd1lzzY9GvlU47/rokTLq +l1gEIt44w8y8bckzOmoKaT+gyOpyj4xjhiO9bTyWnpXgSUyqorkqG5w2gXjtw+hG +4iZZRHUe2XWJUc0QhJ1hYMtd+ZciTY6Y5uN/9lu7rs3KSoFrXgvzUeF0K+l+J6fZ +mUlO+KWA2yUPHGNiiskzZ2s8EIPGrd6ozRaOjfAHN3Gf8qv8QfXBi+wAN10J5U6A +7/qxXDgGpRtK4dw4LTzcqx+QGtVKnO7RcGzM7vRX+Bi6hG6H +-----END CERTIFICATE----- + +# Issuer: CN=IdenTrust Public Sector Root CA 1 O=IdenTrust +# Subject: CN=IdenTrust Public Sector Root CA 1 O=IdenTrust +# Label: "IdenTrust Public Sector Root CA 1" +# Serial: 13298821034946342390521976156843933698 +# MD5 Fingerprint: 37:06:a5:b0:fc:89:9d:ba:f4:6b:8c:1a:64:cd:d5:ba +# SHA1 Fingerprint: ba:29:41:60:77:98:3f:f4:f3:ef:f2:31:05:3b:2e:ea:6d:4d:45:fd +# SHA256 Fingerprint: 30:d0:89:5a:9a:44:8a:26:20:91:63:55:22:d1:f5:20:10:b5:86:7a:ca:e1:2c:78:ef:95:8f:d4:f4:38:9f:2f +-----BEGIN CERTIFICATE----- +MIIFZjCCA06gAwIBAgIQCgFCgAAAAUUjz0Z8AAAAAjANBgkqhkiG9w0BAQsFADBN +MQswCQYDVQQGEwJVUzESMBAGA1UEChMJSWRlblRydXN0MSowKAYDVQQDEyFJZGVu +VHJ1c3QgUHVibGljIFNlY3RvciBSb290IENBIDEwHhcNMTQwMTE2MTc1MzMyWhcN +MzQwMTE2MTc1MzMyWjBNMQswCQYDVQQGEwJVUzESMBAGA1UEChMJSWRlblRydXN0 +MSowKAYDVQQDEyFJZGVuVHJ1c3QgUHVibGljIFNlY3RvciBSb290IENBIDEwggIi +MA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQC2IpT8pEiv6EdrCvsnduTyP4o7 +ekosMSqMjbCpwzFrqHd2hCa2rIFCDQjrVVi7evi8ZX3yoG2LqEfpYnYeEe4IFNGy +RBb06tD6Hi9e28tzQa68ALBKK0CyrOE7S8ItneShm+waOh7wCLPQ5CQ1B5+ctMlS +bdsHyo+1W/CD80/HLaXIrcuVIKQxKFdYWuSNG5qrng0M8gozOSI5Cpcu81N3uURF +/YTLNiCBWS2ab21ISGHKTN9T0a9SvESfqy9rg3LvdYDaBjMbXcjaY8ZNzaxmMc3R +3j6HEDbhuaR672BQssvKplbgN6+rNBM5Jeg5ZuSYeqoSmJxZZoY+rfGwyj4GD3vw +EUs3oERte8uojHH01bWRNszwFcYr3lEXsZdMUD2xlVl8BX0tIdUAvwFnol57plzy +9yLxkA2T26pEUWbMfXYD62qoKjgZl3YNa4ph+bz27nb9cCvdKTz4Ch5bQhyLVi9V +GxyhLrXHFub4qjySjmm2AcG1hp2JDws4lFTo6tyePSW8Uybt1as5qsVATFSrsrTZ +2fjXctscvG29ZV/viDUqZi/u9rNl8DONfJhBaUYPQxxp+pu10GFqzcpL2UyQRqsV +WaFHVCkugyhfHMKiq3IXAAaOReyL4jM9f9oZRORicsPfIsbyVtTdX5Vy7W1f90gD +W/3FKqD2cyOEEBsB5wIDAQABo0IwQDAOBgNVHQ8BAf8EBAMCAQYwDwYDVR0TAQH/ +BAUwAwEB/zAdBgNVHQ4EFgQU43HgntinQtnbcZFrlJPrw6PRFKMwDQYJKoZIhvcN +AQELBQADggIBAEf63QqwEZE4rU1d9+UOl1QZgkiHVIyqZJnYWv6IAcVYpZmxI1Qj +t2odIFflAWJBF9MJ23XLblSQdf4an4EKwt3X9wnQW3IV5B4Jaj0z8yGa5hV+rVHV +DRDtfULAj+7AmgjVQdZcDiFpboBhDhXAuM/FSRJSzL46zNQuOAXeNf0fb7iAaJg9 +TaDKQGXSc3z1i9kKlT/YPyNtGtEqJBnZhbMX73huqVjRI9PHE+1yJX9dsXNw0H8G +lwmEKYBhHfpe/3OsoOOJuBxxFcbeMX8S3OFtm6/n6J91eEyrRjuazr8FGF1NFTwW +mhlQBJqymm9li1JfPFgEKCXAZmExfrngdbkaqIHWchezxQMxNRF4eKLg6TCMf4Df +WN88uieW4oA0beOY02QnrEh+KHdcxiVhJfiFDGX6xDIvpZgF5PgLZxYWxoK4Mhn5 ++bl53B/N66+rDt0b20XkeucC4pVd/GnwU2lhlXV5C15V5jgclKlZM57IcXR5f1GJ +tshquDDIajjDbp7hNxbqBWJMWxJH7ae0s1hWx0nzfxJoCTFx8G34Tkf71oXuxVhA +GaQdp/lLQzfcaFpPz+vCZHTetBXZ9FRUGi8c15dxVJCO2SCdUyt/q4/i6jC8UDfv +8Ue1fXwsBOxonbRJRBD0ckscZOf85muQ3Wl9af0AVqW3rLatt8o+Ae+c +-----END CERTIFICATE----- + +# Issuer: CN=Entrust Root Certification Authority - G2 O=Entrust, Inc. OU=See www.entrust.net/legal-terms/(c) 2009 Entrust, Inc. - for authorized use only +# Subject: CN=Entrust Root Certification Authority - G2 O=Entrust, Inc. OU=See www.entrust.net/legal-terms/(c) 2009 Entrust, Inc. - for authorized use only +# Label: "Entrust Root Certification Authority - G2" +# Serial: 1246989352 +# MD5 Fingerprint: 4b:e2:c9:91:96:65:0c:f4:0e:5a:93:92:a0:0a:fe:b2 +# SHA1 Fingerprint: 8c:f4:27:fd:79:0c:3a:d1:66:06:8d:e8:1e:57:ef:bb:93:22:72:d4 +# SHA256 Fingerprint: 43:df:57:74:b0:3e:7f:ef:5f:e4:0d:93:1a:7b:ed:f1:bb:2e:6b:42:73:8c:4e:6d:38:41:10:3d:3a:a7:f3:39 +-----BEGIN CERTIFICATE----- +MIIEPjCCAyagAwIBAgIESlOMKDANBgkqhkiG9w0BAQsFADCBvjELMAkGA1UEBhMC +VVMxFjAUBgNVBAoTDUVudHJ1c3QsIEluYy4xKDAmBgNVBAsTH1NlZSB3d3cuZW50 +cnVzdC5uZXQvbGVnYWwtdGVybXMxOTA3BgNVBAsTMChjKSAyMDA5IEVudHJ1c3Qs +IEluYy4gLSBmb3IgYXV0aG9yaXplZCB1c2Ugb25seTEyMDAGA1UEAxMpRW50cnVz +dCBSb290IENlcnRpZmljYXRpb24gQXV0aG9yaXR5IC0gRzIwHhcNMDkwNzA3MTcy +NTU0WhcNMzAxMjA3MTc1NTU0WjCBvjELMAkGA1UEBhMCVVMxFjAUBgNVBAoTDUVu +dHJ1c3QsIEluYy4xKDAmBgNVBAsTH1NlZSB3d3cuZW50cnVzdC5uZXQvbGVnYWwt +dGVybXMxOTA3BgNVBAsTMChjKSAyMDA5IEVudHJ1c3QsIEluYy4gLSBmb3IgYXV0 +aG9yaXplZCB1c2Ugb25seTEyMDAGA1UEAxMpRW50cnVzdCBSb290IENlcnRpZmlj +YXRpb24gQXV0aG9yaXR5IC0gRzIwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEK +AoIBAQC6hLZy254Ma+KZ6TABp3bqMriVQRrJ2mFOWHLP/vaCeb9zYQYKpSfYs1/T +RU4cctZOMvJyig/3gxnQaoCAAEUesMfnmr8SVycco2gvCoe9amsOXmXzHHfV1IWN +cCG0szLni6LVhjkCsbjSR87kyUnEO6fe+1R9V77w6G7CebI6C1XiUJgWMhNcL3hW +wcKUs/Ja5CeanyTXxuzQmyWC48zCxEXFjJd6BmsqEZ+pCm5IO2/b1BEZQvePB7/1 +U1+cPvQXLOZprE4yTGJ36rfo5bs0vBmLrpxR57d+tVOxMyLlbc9wPBr64ptntoP0 +jaWvYkxN4FisZDQSA/i2jZRjJKRxAgMBAAGjQjBAMA4GA1UdDwEB/wQEAwIBBjAP +BgNVHRMBAf8EBTADAQH/MB0GA1UdDgQWBBRqciZ60B7vfec7aVHUbI2fkBJmqzAN +BgkqhkiG9w0BAQsFAAOCAQEAeZ8dlsa2eT8ijYfThwMEYGprmi5ZiXMRrEPR9RP/ +jTkrwPK9T3CMqS/qF8QLVJ7UG5aYMzyorWKiAHarWWluBh1+xLlEjZivEtRh2woZ +Rkfz6/djwUAFQKXSt/S1mja/qYh2iARVBCuch38aNzx+LaUa2NSJXsq9rD1s2G2v +1fN2D807iDginWyTmsQ9v4IbZT+mD12q/OWyFcq1rca8PdCE6OoGcrBNOTJ4vz4R +nAuknZoh8/CbCzB428Hch0P+vGOaysXCHMnHjf87ElgI5rY97HosTvuDls4MPGmH +VHOkc8KT/1EQrBVUAdj8BbGJoX90g5pJ19xOe4pIb4tF9g== +-----END CERTIFICATE----- + +# Issuer: CN=Entrust Root Certification Authority - EC1 O=Entrust, Inc. OU=See www.entrust.net/legal-terms/(c) 2012 Entrust, Inc. - for authorized use only +# Subject: CN=Entrust Root Certification Authority - EC1 O=Entrust, Inc. OU=See www.entrust.net/legal-terms/(c) 2012 Entrust, Inc. - for authorized use only +# Label: "Entrust Root Certification Authority - EC1" +# Serial: 51543124481930649114116133369 +# MD5 Fingerprint: b6:7e:1d:f0:58:c5:49:6c:24:3b:3d:ed:98:18:ed:bc +# SHA1 Fingerprint: 20:d8:06:40:df:9b:25:f5:12:25:3a:11:ea:f7:59:8a:eb:14:b5:47 +# SHA256 Fingerprint: 02:ed:0e:b2:8c:14:da:45:16:5c:56:67:91:70:0d:64:51:d7:fb:56:f0:b2:ab:1d:3b:8e:b0:70:e5:6e:df:f5 +-----BEGIN CERTIFICATE----- +MIIC+TCCAoCgAwIBAgINAKaLeSkAAAAAUNCR+TAKBggqhkjOPQQDAzCBvzELMAkG +A1UEBhMCVVMxFjAUBgNVBAoTDUVudHJ1c3QsIEluYy4xKDAmBgNVBAsTH1NlZSB3 +d3cuZW50cnVzdC5uZXQvbGVnYWwtdGVybXMxOTA3BgNVBAsTMChjKSAyMDEyIEVu +dHJ1c3QsIEluYy4gLSBmb3IgYXV0aG9yaXplZCB1c2Ugb25seTEzMDEGA1UEAxMq +RW50cnVzdCBSb290IENlcnRpZmljYXRpb24gQXV0aG9yaXR5IC0gRUMxMB4XDTEy +MTIxODE1MjUzNloXDTM3MTIxODE1NTUzNlowgb8xCzAJBgNVBAYTAlVTMRYwFAYD +VQQKEw1FbnRydXN0LCBJbmMuMSgwJgYDVQQLEx9TZWUgd3d3LmVudHJ1c3QubmV0 +L2xlZ2FsLXRlcm1zMTkwNwYDVQQLEzAoYykgMjAxMiBFbnRydXN0LCBJbmMuIC0g +Zm9yIGF1dGhvcml6ZWQgdXNlIG9ubHkxMzAxBgNVBAMTKkVudHJ1c3QgUm9vdCBD +ZXJ0aWZpY2F0aW9uIEF1dGhvcml0eSAtIEVDMTB2MBAGByqGSM49AgEGBSuBBAAi +A2IABIQTydC6bUF74mzQ61VfZgIaJPRbiWlH47jCffHyAsWfoPZb1YsGGYZPUxBt +ByQnoaD41UcZYUx9ypMn6nQM72+WCf5j7HBdNq1nd67JnXxVRDqiY1Ef9eNi1KlH +Bz7MIKNCMEAwDgYDVR0PAQH/BAQDAgEGMA8GA1UdEwEB/wQFMAMBAf8wHQYDVR0O +BBYEFLdj5xrdjekIplWDpOBqUEFlEUJJMAoGCCqGSM49BAMDA2cAMGQCMGF52OVC +R98crlOZF7ZvHH3hvxGU0QOIdeSNiaSKd0bebWHvAvX7td/M/k7//qnmpwIwW5nX +hTcGtXsI/esni0qU+eH6p44mCOh8kmhtc9hvJqwhAriZtyZBWyVgrtBIGu4G +-----END CERTIFICATE----- + +# Issuer: CN=CFCA EV ROOT O=China Financial Certification Authority +# Subject: CN=CFCA EV ROOT O=China Financial Certification Authority +# Label: "CFCA EV ROOT" +# Serial: 407555286 +# MD5 Fingerprint: 74:e1:b6:ed:26:7a:7a:44:30:33:94:ab:7b:27:81:30 +# SHA1 Fingerprint: e2:b8:29:4b:55:84:ab:6b:58:c2:90:46:6c:ac:3f:b8:39:8f:84:83 +# SHA256 Fingerprint: 5c:c3:d7:8e:4e:1d:5e:45:54:7a:04:e6:87:3e:64:f9:0c:f9:53:6d:1c:cc:2e:f8:00:f3:55:c4:c5:fd:70:fd +-----BEGIN CERTIFICATE----- +MIIFjTCCA3WgAwIBAgIEGErM1jANBgkqhkiG9w0BAQsFADBWMQswCQYDVQQGEwJD +TjEwMC4GA1UECgwnQ2hpbmEgRmluYW5jaWFsIENlcnRpZmljYXRpb24gQXV0aG9y +aXR5MRUwEwYDVQQDDAxDRkNBIEVWIFJPT1QwHhcNMTIwODA4MDMwNzAxWhcNMjkx +MjMxMDMwNzAxWjBWMQswCQYDVQQGEwJDTjEwMC4GA1UECgwnQ2hpbmEgRmluYW5j +aWFsIENlcnRpZmljYXRpb24gQXV0aG9yaXR5MRUwEwYDVQQDDAxDRkNBIEVWIFJP +T1QwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQDXXWvNED8fBVnVBU03 +sQ7smCuOFR36k0sXgiFxEFLXUWRwFsJVaU2OFW2fvwwbwuCjZ9YMrM8irq93VCpL +TIpTUnrD7i7es3ElweldPe6hL6P3KjzJIx1qqx2hp/Hz7KDVRM8Vz3IvHWOX6Jn5 +/ZOkVIBMUtRSqy5J35DNuF++P96hyk0g1CXohClTt7GIH//62pCfCqktQT+x8Rgp +7hZZLDRJGqgG16iI0gNyejLi6mhNbiyWZXvKWfry4t3uMCz7zEasxGPrb382KzRz +EpR/38wmnvFyXVBlWY9ps4deMm/DGIq1lY+wejfeWkU7xzbh72fROdOXW3NiGUgt +hxwG+3SYIElz8AXSG7Ggo7cbcNOIabla1jj0Ytwli3i/+Oh+uFzJlU9fpy25IGvP +a931DfSCt/SyZi4QKPaXWnuWFo8BGS1sbn85WAZkgwGDg8NNkt0yxoekN+kWzqot +aK8KgWU6cMGbrU1tVMoqLUuFG7OA5nBFDWteNfB/O7ic5ARwiRIlk9oKmSJgamNg +TnYGmE69g60dWIolhdLHZR4tjsbftsbhf4oEIRUpdPA+nJCdDC7xij5aqgwJHsfV +PKPtl8MeNPo4+QgO48BdK4PRVmrJtqhUUy54Mmc9gn900PvhtgVguXDbjgv5E1hv +cWAQUhC5wUEJ73IfZzF4/5YFjQIDAQABo2MwYTAfBgNVHSMEGDAWgBTj/i39KNAL +tbq2osS/BqoFjJP7LzAPBgNVHRMBAf8EBTADAQH/MA4GA1UdDwEB/wQEAwIBBjAd +BgNVHQ4EFgQU4/4t/SjQC7W6tqLEvwaqBYyT+y8wDQYJKoZIhvcNAQELBQADggIB +ACXGumvrh8vegjmWPfBEp2uEcwPenStPuiB/vHiyz5ewG5zz13ku9Ui20vsXiObT +ej/tUxPQ4i9qecsAIyjmHjdXNYmEwnZPNDatZ8POQQaIxffu2Bq41gt/UP+TqhdL +jOztUmCypAbqTuv0axn96/Ua4CUqmtzHQTb3yHQFhDmVOdYLO6Qn+gjYXB74BGBS +ESgoA//vU2YApUo0FmZ8/Qmkrp5nGm9BC2sGE5uPhnEFtC+NiWYzKXZUmhH4J/qy +P5Hgzg0b8zAarb8iXRvTvyUFTeGSGn+ZnzxEk8rUQElsgIfXBDrDMlI1Dlb4pd19 +xIsNER9Tyx6yF7Zod1rg1MvIB671Oi6ON7fQAUtDKXeMOZePglr4UeWJoBjnaH9d +Ci77o0cOPaYjesYBx4/IXr9tgFa+iiS6M+qf4TIRnvHST4D2G0CvOJ4RUHlzEhLN +5mydLIhyPDCBBpEi6lmt2hkuIsKNuYyH4Ga8cyNfIWRjgEj1oDwYPZTISEEdQLpe +/v5WOaHIz16eGWRGENoXkbcFgKyLmZJ956LYBws2J+dIeWCKw9cTXPhyQN9Ky8+Z +AAoACxGV2lZFA4gKn2fQ1XmxqI1AbQ3CekD6819kR5LLU7m7Wc5P/dAVUwHY3+vZ +5nbv0CO7O6l5s9UCKc2Jo5YPSjXnTkLAdc0Hz+Ys63su +-----END CERTIFICATE----- + +# Issuer: CN=OISTE WISeKey Global Root GB CA O=WISeKey OU=OISTE Foundation Endorsed +# Subject: CN=OISTE WISeKey Global Root GB CA O=WISeKey OU=OISTE Foundation Endorsed +# Label: "OISTE WISeKey Global Root GB CA" +# Serial: 157768595616588414422159278966750757568 +# MD5 Fingerprint: a4:eb:b9:61:28:2e:b7:2f:98:b0:35:26:90:99:51:1d +# SHA1 Fingerprint: 0f:f9:40:76:18:d3:d7:6a:4b:98:f0:a8:35:9e:0c:fd:27:ac:cc:ed +# SHA256 Fingerprint: 6b:9c:08:e8:6e:b0:f7:67:cf:ad:65:cd:98:b6:21:49:e5:49:4a:67:f5:84:5e:7b:d1:ed:01:9f:27:b8:6b:d6 +-----BEGIN CERTIFICATE----- +MIIDtTCCAp2gAwIBAgIQdrEgUnTwhYdGs/gjGvbCwDANBgkqhkiG9w0BAQsFADBt +MQswCQYDVQQGEwJDSDEQMA4GA1UEChMHV0lTZUtleTEiMCAGA1UECxMZT0lTVEUg +Rm91bmRhdGlvbiBFbmRvcnNlZDEoMCYGA1UEAxMfT0lTVEUgV0lTZUtleSBHbG9i +YWwgUm9vdCBHQiBDQTAeFw0xNDEyMDExNTAwMzJaFw0zOTEyMDExNTEwMzFaMG0x +CzAJBgNVBAYTAkNIMRAwDgYDVQQKEwdXSVNlS2V5MSIwIAYDVQQLExlPSVNURSBG +b3VuZGF0aW9uIEVuZG9yc2VkMSgwJgYDVQQDEx9PSVNURSBXSVNlS2V5IEdsb2Jh +bCBSb290IEdCIENBMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA2Be3 +HEokKtaXscriHvt9OO+Y9bI5mE4nuBFde9IllIiCFSZqGzG7qFshISvYD06fWvGx +WuR51jIjK+FTzJlFXHtPrby/h0oLS5daqPZI7H17Dc0hBt+eFf1Biki3IPShehtX +1F1Q/7pn2COZH8g/497/b1t3sWtuuMlk9+HKQUYOKXHQuSP8yYFfTvdv37+ErXNk +u7dCjmn21HYdfp2nuFeKUWdy19SouJVUQHMD9ur06/4oQnc/nSMbsrY9gBQHTC5P +99UKFg29ZkM3fiNDecNAhvVMKdqOmq0NpQSHiB6F4+lT1ZvIiwNjeOvgGUpuuy9r +M2RYk61pv48b74JIxwIDAQABo1EwTzALBgNVHQ8EBAMCAYYwDwYDVR0TAQH/BAUw +AwEB/zAdBgNVHQ4EFgQUNQ/INmNe4qPs+TtmFc5RUuORmj0wEAYJKwYBBAGCNxUB +BAMCAQAwDQYJKoZIhvcNAQELBQADggEBAEBM+4eymYGQfp3FsLAmzYh7KzKNbrgh +cViXfa43FK8+5/ea4n32cZiZBKpDdHij40lhPnOMTZTg+XHEthYOU3gf1qKHLwI5 +gSk8rxWYITD+KJAAjNHhy/peyP34EEY7onhCkRd0VQreUGdNZtGn//3ZwLWoo4rO +ZvUPQ82nK1d7Y0Zqqi5S2PTt4W2tKZB4SLrhI6qjiey1q5bAtEuiHZeeevJuQHHf +aPFlTc58Bd9TZaml8LGXBHAVRgOY1NK/VLSgWH1Sb9pWJmLU2NuJMW8c8CLC02Ic +Nc1MaRVUGpCY3useX8p3x8uOPUNpnJpY0CQ73xtAln41rYHHTnG6iBM= +-----END CERTIFICATE----- + +# Issuer: CN=SZAFIR ROOT CA2 O=Krajowa Izba Rozliczeniowa S.A. +# Subject: CN=SZAFIR ROOT CA2 O=Krajowa Izba Rozliczeniowa S.A. +# Label: "SZAFIR ROOT CA2" +# Serial: 357043034767186914217277344587386743377558296292 +# MD5 Fingerprint: 11:64:c1:89:b0:24:b1:8c:b1:07:7e:89:9e:51:9e:99 +# SHA1 Fingerprint: e2:52:fa:95:3f:ed:db:24:60:bd:6e:28:f3:9c:cc:cf:5e:b3:3f:de +# SHA256 Fingerprint: a1:33:9d:33:28:1a:0b:56:e5:57:d3:d3:2b:1c:e7:f9:36:7e:b0:94:bd:5f:a7:2a:7e:50:04:c8:de:d7:ca:fe +-----BEGIN CERTIFICATE----- +MIIDcjCCAlqgAwIBAgIUPopdB+xV0jLVt+O2XwHrLdzk1uQwDQYJKoZIhvcNAQEL +BQAwUTELMAkGA1UEBhMCUEwxKDAmBgNVBAoMH0tyYWpvd2EgSXpiYSBSb3psaWN6 +ZW5pb3dhIFMuQS4xGDAWBgNVBAMMD1NaQUZJUiBST09UIENBMjAeFw0xNTEwMTkw +NzQzMzBaFw0zNTEwMTkwNzQzMzBaMFExCzAJBgNVBAYTAlBMMSgwJgYDVQQKDB9L +cmFqb3dhIEl6YmEgUm96bGljemVuaW93YSBTLkEuMRgwFgYDVQQDDA9TWkFGSVIg +Uk9PVCBDQTIwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQC3vD5QqEvN +QLXOYeeWyrSh2gwisPq1e3YAd4wLz32ohswmUeQgPYUM1ljj5/QqGJ3a0a4m7utT +3PSQ1hNKDJA8w/Ta0o4NkjrcsbH/ON7Dui1fgLkCvUqdGw+0w8LBZwPd3BucPbOw +3gAeqDRHu5rr/gsUvTaE2g0gv/pby6kWIK05YO4vdbbnl5z5Pv1+TW9NL++IDWr6 +3fE9biCloBK0TXC5ztdyO4mTp4CEHCdJckm1/zuVnsHMyAHs6A6KCpbns6aH5db5 +BSsNl0BwPLqsdVqc1U2dAgrSS5tmS0YHF2Wtn2yIANwiieDhZNRnvDF5YTy7ykHN +XGoAyDw4jlivAgMBAAGjQjBAMA8GA1UdEwEB/wQFMAMBAf8wDgYDVR0PAQH/BAQD +AgEGMB0GA1UdDgQWBBQuFqlKGLXLzPVvUPMjX/hd56zwyDANBgkqhkiG9w0BAQsF +AAOCAQEAtXP4A9xZWx126aMqe5Aosk3AM0+qmrHUuOQn/6mWmc5G4G18TKI4pAZw +8PRBEew/R40/cof5O/2kbytTAOD/OblqBw7rHRz2onKQy4I9EYKL0rufKq8h5mOG +nXkZ7/e7DDWQw4rtTw/1zBLZpD67oPwglV9PJi8RI4NOdQcPv5vRtB3pEAT+ymCP +oky4rc/hkA/NrgrHXXu3UNLUYfrVFdvXn4dRVOul4+vJhaAlIDf7js4MNIThPIGy +d05DpYhfhmehPea0XGG2Ptv+tyjFogeutcrKjSoS75ftwjCkySp6+/NNIxuZMzSg +LvWpCz/UXeHPhJ/iGcJfitYgHuNztw== +-----END CERTIFICATE----- + +# Issuer: CN=Certum Trusted Network CA 2 O=Unizeto Technologies S.A. OU=Certum Certification Authority +# Subject: CN=Certum Trusted Network CA 2 O=Unizeto Technologies S.A. OU=Certum Certification Authority +# Label: "Certum Trusted Network CA 2" +# Serial: 44979900017204383099463764357512596969 +# MD5 Fingerprint: 6d:46:9e:d9:25:6d:08:23:5b:5e:74:7d:1e:27:db:f2 +# SHA1 Fingerprint: d3:dd:48:3e:2b:bf:4c:05:e8:af:10:f5:fa:76:26:cf:d3:dc:30:92 +# SHA256 Fingerprint: b6:76:f2:ed:da:e8:77:5c:d3:6c:b0:f6:3c:d1:d4:60:39:61:f4:9e:62:65:ba:01:3a:2f:03:07:b6:d0:b8:04 +-----BEGIN CERTIFICATE----- +MIIF0jCCA7qgAwIBAgIQIdbQSk8lD8kyN/yqXhKN6TANBgkqhkiG9w0BAQ0FADCB +gDELMAkGA1UEBhMCUEwxIjAgBgNVBAoTGVVuaXpldG8gVGVjaG5vbG9naWVzIFMu +QS4xJzAlBgNVBAsTHkNlcnR1bSBDZXJ0aWZpY2F0aW9uIEF1dGhvcml0eTEkMCIG +A1UEAxMbQ2VydHVtIFRydXN0ZWQgTmV0d29yayBDQSAyMCIYDzIwMTExMDA2MDgz +OTU2WhgPMjA0NjEwMDYwODM5NTZaMIGAMQswCQYDVQQGEwJQTDEiMCAGA1UEChMZ +VW5pemV0byBUZWNobm9sb2dpZXMgUy5BLjEnMCUGA1UECxMeQ2VydHVtIENlcnRp +ZmljYXRpb24gQXV0aG9yaXR5MSQwIgYDVQQDExtDZXJ0dW0gVHJ1c3RlZCBOZXR3 +b3JrIENBIDIwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQC9+Xj45tWA +DGSdhhuWZGc/IjoedQF97/tcZ4zJzFxrqZHmuULlIEub2pt7uZld2ZuAS9eEQCsn +0+i6MLs+CRqnSZXvK0AkwpfHp+6bJe+oCgCXhVqqndwpyeI1B+twTUrWwbNWuKFB +OJvR+zF/j+Bf4bE/D44WSWDXBo0Y+aomEKsq09DRZ40bRr5HMNUuctHFY9rnY3lE +fktjJImGLjQ/KUxSiyqnwOKRKIm5wFv5HdnnJ63/mgKXwcZQkpsCLL2puTRZCr+E +Sv/f/rOf69me4Jgj7KZrdxYq28ytOxykh9xGc14ZYmhFV+SQgkK7QtbwYeDBoz1m +o130GO6IyY0XRSmZMnUCMe4pJshrAua1YkV/NxVaI2iJ1D7eTiew8EAMvE0Xy02i +sx7QBlrd9pPPV3WZ9fqGGmd4s7+W/jTcvedSVuWz5XV710GRBdxdaeOVDUO5/IOW +OZV7bIBaTxNyxtd9KXpEulKkKtVBRgkg/iKgtlswjbyJDNXXcPiHUv3a76xRLgez +Tv7QCdpw75j6VuZt27VXS9zlLCUVyJ4ueE742pyehizKV/Ma5ciSixqClnrDvFAS +adgOWkaLOusm+iPJtrCBvkIApPjW/jAux9JG9uWOdf3yzLnQh1vMBhBgu4M1t15n +3kfsmUjxpKEV/q2MYo45VU85FrmxY53/twIDAQABo0IwQDAPBgNVHRMBAf8EBTAD +AQH/MB0GA1UdDgQWBBS2oVQ5AsOgP46KvPrU+Bym0ToO/TAOBgNVHQ8BAf8EBAMC +AQYwDQYJKoZIhvcNAQENBQADggIBAHGlDs7k6b8/ONWJWsQCYftMxRQXLYtPU2sQ +F/xlhMcQSZDe28cmk4gmb3DWAl45oPePq5a1pRNcgRRtDoGCERuKTsZPpd1iHkTf +CVn0W3cLN+mLIMb4Ck4uWBzrM9DPhmDJ2vuAL55MYIR4PSFk1vtBHxgP58l1cb29 +XN40hz5BsA72udY/CROWFC/emh1auVbONTqwX3BNXuMp8SMoclm2q8KMZiYcdywm +djWLKKdpoPk79SPdhRB0yZADVpHnr7pH1BKXESLjokmUbOe3lEu6LaTaM4tMpkT/ +WjzGHWTYtTHkpjx6qFcL2+1hGsvxznN3Y6SHb0xRONbkX8eftoEq5IVIeVheO/jb +AoJnwTnbw3RLPTYe+SmTiGhbqEQZIfCn6IENLOiTNrQ3ssqwGyZ6miUfmpqAnksq +P/ujmv5zMnHCnsZy4YpoJ/HkD7TETKVhk/iXEAcqMCWpuchxuO9ozC1+9eB+D4Ko +b7a6bINDd82Kkhehnlt4Fj1F4jNy3eFmypnTycUm/Q1oBEauttmbjL4ZvrHG8hnj +XALKLNhvSgfZyTXaQHXyxKcZb55CEJh15pWLYLztxRLXis7VmFxWlgPF7ncGNf/P +5O4/E2Hu29othfDNrp2yGAlFw5Khchf8R7agCyzxxN5DaAhqXzvwdmP7zAYspsbi +DrW5viSP +-----END CERTIFICATE----- + +# Issuer: CN=Hellenic Academic and Research Institutions RootCA 2015 O=Hellenic Academic and Research Institutions Cert. Authority +# Subject: CN=Hellenic Academic and Research Institutions RootCA 2015 O=Hellenic Academic and Research Institutions Cert. Authority +# Label: "Hellenic Academic and Research Institutions RootCA 2015" +# Serial: 0 +# MD5 Fingerprint: ca:ff:e2:db:03:d9:cb:4b:e9:0f:ad:84:fd:7b:18:ce +# SHA1 Fingerprint: 01:0c:06:95:a6:98:19:14:ff:bf:5f:c6:b0:b6:95:ea:29:e9:12:a6 +# SHA256 Fingerprint: a0:40:92:9a:02:ce:53:b4:ac:f4:f2:ff:c6:98:1c:e4:49:6f:75:5e:6d:45:fe:0b:2a:69:2b:cd:52:52:3f:36 +-----BEGIN CERTIFICATE----- +MIIGCzCCA/OgAwIBAgIBADANBgkqhkiG9w0BAQsFADCBpjELMAkGA1UEBhMCR1Ix +DzANBgNVBAcTBkF0aGVuczFEMEIGA1UEChM7SGVsbGVuaWMgQWNhZGVtaWMgYW5k +IFJlc2VhcmNoIEluc3RpdHV0aW9ucyBDZXJ0LiBBdXRob3JpdHkxQDA+BgNVBAMT +N0hlbGxlbmljIEFjYWRlbWljIGFuZCBSZXNlYXJjaCBJbnN0aXR1dGlvbnMgUm9v +dENBIDIwMTUwHhcNMTUwNzA3MTAxMTIxWhcNNDAwNjMwMTAxMTIxWjCBpjELMAkG +A1UEBhMCR1IxDzANBgNVBAcTBkF0aGVuczFEMEIGA1UEChM7SGVsbGVuaWMgQWNh +ZGVtaWMgYW5kIFJlc2VhcmNoIEluc3RpdHV0aW9ucyBDZXJ0LiBBdXRob3JpdHkx +QDA+BgNVBAMTN0hlbGxlbmljIEFjYWRlbWljIGFuZCBSZXNlYXJjaCBJbnN0aXR1 +dGlvbnMgUm9vdENBIDIwMTUwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoIC +AQDC+Kk/G4n8PDwEXT2QNrCROnk8ZlrvbTkBSRq0t89/TSNTt5AA4xMqKKYx8ZEA +4yjsriFBzh/a/X0SWwGDD7mwX5nh8hKDgE0GPt+sr+ehiGsxr/CL0BgzuNtFajT0 +AoAkKAoCFZVedioNmToUW/bLy1O8E00BiDeUJRtCvCLYjqOWXjrZMts+6PAQZe10 +4S+nfK8nNLspfZu2zwnI5dMK/IhlZXQK3HMcXM1AsRzUtoSMTFDPaI6oWa7CJ06C +ojXdFPQf/7J31Ycvqm59JCfnxssm5uX+Zwdj2EUN3TpZZTlYepKZcj2chF6IIbjV +9Cz82XBST3i4vTwri5WY9bPRaM8gFH5MXF/ni+X1NYEZN9cRCLdmvtNKzoNXADrD +gfgXy5I2XdGj2HUb4Ysn6npIQf1FGQatJ5lOwXBH3bWfgVMS5bGMSF0xQxfjjMZ6 +Y5ZLKTBOhE5iGV48zpeQpX8B653g+IuJ3SWYPZK2fu/Z8VFRfS0myGlZYeCsargq +NhEEelC9MoS+L9xy1dcdFkfkR2YgP/SWxa+OAXqlD3pk9Q0Yh9muiNX6hME6wGko +LfINaFGq46V3xqSQDqE3izEjR8EJCOtu93ib14L8hCCZSRm2Ekax+0VVFqmjZayc +Bw/qa9wfLgZy7IaIEuQt218FL+TwA9MmM+eAws1CoRc0CwIDAQABo0IwQDAPBgNV +HRMBAf8EBTADAQH/MA4GA1UdDwEB/wQEAwIBBjAdBgNVHQ4EFgQUcRVnyMjJvXVd +ctA4GGqd83EkVAswDQYJKoZIhvcNAQELBQADggIBAHW7bVRLqhBYRjTyYtcWNl0I +XtVsyIe9tC5G8jH4fOpCtZMWVdyhDBKg2mF+D1hYc2Ryx+hFjtyp8iY/xnmMsVMI +M4GwVhO+5lFc2JsKT0ucVlMC6U/2DWDqTUJV6HwbISHTGzrMd/K4kPFox/la/vot +9L/J9UUbzjgQKjeKeaO04wlshYaT/4mWJ3iBj2fjRnRUjtkNaeJK9E10A/+yd+2V +Z5fkscWrv2oj6NSU4kQoYsRL4vDY4ilrGnB+JGGTe08DMiUNRSQrlrRGar9KC/ea +j8GsGsVn82800vpzY4zvFrCopEYq+OsS7HK07/grfoxSwIuEVPkvPuNVqNxmsdnh +X9izjFk0WaSrT2y7HxjbdavYy5LNlDhhDgcGH0tGEPEVvo2FXDtKK4F5D7Rpn0lQ +l033DlZdwJVqwjbDG2jJ9SrcR5q+ss7FJej6A7na+RZukYT1HCjI/CbM1xyQVqdf +bzoEvM14iQuODy+jqk+iGxI9FghAD/FGTNeqewjBCvVtJ94Cj8rDtSvK6evIIVM4 +pcw72Hc3MKJP2W/R8kCtQXoXxdZKNYm3QdV8hn9VTYNKpXMgwDqvkPGaJI7ZjnHK +e7iG2rKPmT4dEw0SEe7Uq/DpFXYC5ODfqiAeW2GFZECpkJcNrVPSWh2HagCXZWK0 +vm9qp/UsQu0yrbYhnr68 +-----END CERTIFICATE----- + +# Issuer: CN=Hellenic Academic and Research Institutions ECC RootCA 2015 O=Hellenic Academic and Research Institutions Cert. Authority +# Subject: CN=Hellenic Academic and Research Institutions ECC RootCA 2015 O=Hellenic Academic and Research Institutions Cert. Authority +# Label: "Hellenic Academic and Research Institutions ECC RootCA 2015" +# Serial: 0 +# MD5 Fingerprint: 81:e5:b4:17:eb:c2:f5:e1:4b:0d:41:7b:49:92:fe:ef +# SHA1 Fingerprint: 9f:f1:71:8d:92:d5:9a:f3:7d:74:97:b4:bc:6f:84:68:0b:ba:b6:66 +# SHA256 Fingerprint: 44:b5:45:aa:8a:25:e6:5a:73:ca:15:dc:27:fc:36:d2:4c:1c:b9:95:3a:06:65:39:b1:15:82:dc:48:7b:48:33 +-----BEGIN CERTIFICATE----- +MIICwzCCAkqgAwIBAgIBADAKBggqhkjOPQQDAjCBqjELMAkGA1UEBhMCR1IxDzAN +BgNVBAcTBkF0aGVuczFEMEIGA1UEChM7SGVsbGVuaWMgQWNhZGVtaWMgYW5kIFJl +c2VhcmNoIEluc3RpdHV0aW9ucyBDZXJ0LiBBdXRob3JpdHkxRDBCBgNVBAMTO0hl +bGxlbmljIEFjYWRlbWljIGFuZCBSZXNlYXJjaCBJbnN0aXR1dGlvbnMgRUNDIFJv +b3RDQSAyMDE1MB4XDTE1MDcwNzEwMzcxMloXDTQwMDYzMDEwMzcxMlowgaoxCzAJ +BgNVBAYTAkdSMQ8wDQYDVQQHEwZBdGhlbnMxRDBCBgNVBAoTO0hlbGxlbmljIEFj +YWRlbWljIGFuZCBSZXNlYXJjaCBJbnN0aXR1dGlvbnMgQ2VydC4gQXV0aG9yaXR5 +MUQwQgYDVQQDEztIZWxsZW5pYyBBY2FkZW1pYyBhbmQgUmVzZWFyY2ggSW5zdGl0 +dXRpb25zIEVDQyBSb290Q0EgMjAxNTB2MBAGByqGSM49AgEGBSuBBAAiA2IABJKg +QehLgoRc4vgxEZmGZE4JJS+dQS8KrjVPdJWyUWRrjWvmP3CV8AVER6ZyOFB2lQJa +jq4onvktTpnvLEhvTCUp6NFxW98dwXU3tNf6e3pCnGoKVlp8aQuqgAkkbH7BRqNC +MEAwDwYDVR0TAQH/BAUwAwEB/zAOBgNVHQ8BAf8EBAMCAQYwHQYDVR0OBBYEFLQi +C4KZJAEOnLvkDv2/+5cgk5kqMAoGCCqGSM49BAMCA2cAMGQCMGfOFmI4oqxiRaep +lSTAGiecMjvAwNW6qef4BENThe5SId6d9SWDPp5YSy/XZxMOIQIwBeF1Ad5o7Sof +TUwJCA3sS61kFyjndc5FZXIhF8siQQ6ME5g4mlRtm8rifOoCWCKR +-----END CERTIFICATE----- + +# Issuer: CN=ISRG Root X1 O=Internet Security Research Group +# Subject: CN=ISRG Root X1 O=Internet Security Research Group +# Label: "ISRG Root X1" +# Serial: 172886928669790476064670243504169061120 +# MD5 Fingerprint: 0c:d2:f9:e0:da:17:73:e9:ed:86:4d:a5:e3:70:e7:4e +# SHA1 Fingerprint: ca:bd:2a:79:a1:07:6a:31:f2:1d:25:36:35:cb:03:9d:43:29:a5:e8 +# SHA256 Fingerprint: 96:bc:ec:06:26:49:76:f3:74:60:77:9a:cf:28:c5:a7:cf:e8:a3:c0:aa:e1:1a:8f:fc:ee:05:c0:bd:df:08:c6 +-----BEGIN CERTIFICATE----- +MIIFazCCA1OgAwIBAgIRAIIQz7DSQONZRGPgu2OCiwAwDQYJKoZIhvcNAQELBQAw +TzELMAkGA1UEBhMCVVMxKTAnBgNVBAoTIEludGVybmV0IFNlY3VyaXR5IFJlc2Vh +cmNoIEdyb3VwMRUwEwYDVQQDEwxJU1JHIFJvb3QgWDEwHhcNMTUwNjA0MTEwNDM4 +WhcNMzUwNjA0MTEwNDM4WjBPMQswCQYDVQQGEwJVUzEpMCcGA1UEChMgSW50ZXJu +ZXQgU2VjdXJpdHkgUmVzZWFyY2ggR3JvdXAxFTATBgNVBAMTDElTUkcgUm9vdCBY +MTCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBAK3oJHP0FDfzm54rVygc +h77ct984kIxuPOZXoHj3dcKi/vVqbvYATyjb3miGbESTtrFj/RQSa78f0uoxmyF+ +0TM8ukj13Xnfs7j/EvEhmkvBioZxaUpmZmyPfjxwv60pIgbz5MDmgK7iS4+3mX6U +A5/TR5d8mUgjU+g4rk8Kb4Mu0UlXjIB0ttov0DiNewNwIRt18jA8+o+u3dpjq+sW +T8KOEUt+zwvo/7V3LvSye0rgTBIlDHCNAymg4VMk7BPZ7hm/ELNKjD+Jo2FR3qyH +B5T0Y3HsLuJvW5iB4YlcNHlsdu87kGJ55tukmi8mxdAQ4Q7e2RCOFvu396j3x+UC +B5iPNgiV5+I3lg02dZ77DnKxHZu8A/lJBdiB3QW0KtZB6awBdpUKD9jf1b0SHzUv +KBds0pjBqAlkd25HN7rOrFleaJ1/ctaJxQZBKT5ZPt0m9STJEadao0xAH0ahmbWn +OlFuhjuefXKnEgV4We0+UXgVCwOPjdAvBbI+e0ocS3MFEvzG6uBQE3xDk3SzynTn +jh8BCNAw1FtxNrQHusEwMFxIt4I7mKZ9YIqioymCzLq9gwQbooMDQaHWBfEbwrbw +qHyGO0aoSCqI3Haadr8faqU9GY/rOPNk3sgrDQoo//fb4hVC1CLQJ13hef4Y53CI +rU7m2Ys6xt0nUW7/vGT1M0NPAgMBAAGjQjBAMA4GA1UdDwEB/wQEAwIBBjAPBgNV +HRMBAf8EBTADAQH/MB0GA1UdDgQWBBR5tFnme7bl5AFzgAiIyBpY9umbbjANBgkq +hkiG9w0BAQsFAAOCAgEAVR9YqbyyqFDQDLHYGmkgJykIrGF1XIpu+ILlaS/V9lZL +ubhzEFnTIZd+50xx+7LSYK05qAvqFyFWhfFQDlnrzuBZ6brJFe+GnY+EgPbk6ZGQ +3BebYhtF8GaV0nxvwuo77x/Py9auJ/GpsMiu/X1+mvoiBOv/2X/qkSsisRcOj/KK +NFtY2PwByVS5uCbMiogziUwthDyC3+6WVwW6LLv3xLfHTjuCvjHIInNzktHCgKQ5 +ORAzI4JMPJ+GslWYHb4phowim57iaztXOoJwTdwJx4nLCgdNbOhdjsnvzqvHu7Ur +TkXWStAmzOVyyghqpZXjFaH3pO3JLF+l+/+sKAIuvtd7u+Nxe5AW0wdeRlN8NwdC +jNPElpzVmbUq4JUagEiuTDkHzsxHpFKVK7q4+63SM1N95R1NbdWhscdCb+ZAJzVc +oyi3B43njTOQ5yOf+1CceWxG1bQVs5ZufpsMljq4Ui0/1lvh+wjChP4kqKOJ2qxq +4RgqsahDYVvTH9w7jXbyLeiNdd8XM2w9U/t7y0Ff/9yi0GE44Za4rF2LN9d11TPA +mRGunUHBcnWEvgJBQl9nJEiU0Zsnvgc/ubhPgXRR4Xq37Z0j4r7g1SgEEzwxA57d +emyPxgcYxn/eR44/KJ4EBs+lVDR3veyJm+kXQ99b21/+jh5Xos1AnX5iItreGCc= +-----END CERTIFICATE----- + +# Issuer: O=FNMT-RCM OU=AC RAIZ FNMT-RCM +# Subject: O=FNMT-RCM OU=AC RAIZ FNMT-RCM +# Label: "AC RAIZ FNMT-RCM" +# Serial: 485876308206448804701554682760554759 +# MD5 Fingerprint: e2:09:04:b4:d3:bd:d1:a0:14:fd:1a:d2:47:c4:57:1d +# SHA1 Fingerprint: ec:50:35:07:b2:15:c4:95:62:19:e2:a8:9a:5b:42:99:2c:4c:2c:20 +# SHA256 Fingerprint: eb:c5:57:0c:29:01:8c:4d:67:b1:aa:12:7b:af:12:f7:03:b4:61:1e:bc:17:b7:da:b5:57:38:94:17:9b:93:fa +-----BEGIN CERTIFICATE----- +MIIFgzCCA2ugAwIBAgIPXZONMGc2yAYdGsdUhGkHMA0GCSqGSIb3DQEBCwUAMDsx +CzAJBgNVBAYTAkVTMREwDwYDVQQKDAhGTk1ULVJDTTEZMBcGA1UECwwQQUMgUkFJ +WiBGTk1ULVJDTTAeFw0wODEwMjkxNTU5NTZaFw0zMDAxMDEwMDAwMDBaMDsxCzAJ +BgNVBAYTAkVTMREwDwYDVQQKDAhGTk1ULVJDTTEZMBcGA1UECwwQQUMgUkFJWiBG +Tk1ULVJDTTCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBALpxgHpMhm5/ +yBNtwMZ9HACXjywMI7sQmkCpGreHiPibVmr75nuOi5KOpyVdWRHbNi63URcfqQgf +BBckWKo3Shjf5TnUV/3XwSyRAZHiItQDwFj8d0fsjz50Q7qsNI1NOHZnjrDIbzAz +WHFctPVrbtQBULgTfmxKo0nRIBnuvMApGGWn3v7v3QqQIecaZ5JCEJhfTzC8PhxF +tBDXaEAUwED653cXeuYLj2VbPNmaUtu1vZ5Gzz3rkQUCwJaydkxNEJY7kvqcfw+Z +374jNUUeAlz+taibmSXaXvMiwzn15Cou08YfxGyqxRxqAQVKL9LFwag0Jl1mpdIC +IfkYtwb1TplvqKtMUejPUBjFd8g5CSxJkjKZqLsXF3mwWsXmo8RZZUc1g16p6DUL +mbvkzSDGm0oGObVo/CK67lWMK07q87Hj/LaZmtVC+nFNCM+HHmpxffnTtOmlcYF7 +wk5HlqX2doWjKI/pgG6BU6VtX7hI+cL5NqYuSf+4lsKMB7ObiFj86xsc3i1w4peS +MKGJ47xVqCfWS+2QrYv6YyVZLag13cqXM7zlzced0ezvXg5KkAYmY6252TUtB7p2 +ZSysV4999AeU14ECll2jB0nVetBX+RvnU0Z1qrB5QstocQjpYL05ac70r8NWQMet +UqIJ5G+GR4of6ygnXYMgrwTJbFaai0b1AgMBAAGjgYMwgYAwDwYDVR0TAQH/BAUw +AwEB/zAOBgNVHQ8BAf8EBAMCAQYwHQYDVR0OBBYEFPd9xf3E6Jobd2Sn9R2gzL+H +YJptMD4GA1UdIAQ3MDUwMwYEVR0gADArMCkGCCsGAQUFBwIBFh1odHRwOi8vd3d3 +LmNlcnQuZm5tdC5lcy9kcGNzLzANBgkqhkiG9w0BAQsFAAOCAgEAB5BK3/MjTvDD +nFFlm5wioooMhfNzKWtN/gHiqQxjAb8EZ6WdmF/9ARP67Jpi6Yb+tmLSbkyU+8B1 +RXxlDPiyN8+sD8+Nb/kZ94/sHvJwnvDKuO+3/3Y3dlv2bojzr2IyIpMNOmqOFGYM +LVN0V2Ue1bLdI4E7pWYjJ2cJj+F3qkPNZVEI7VFY/uY5+ctHhKQV8Xa7pO6kO8Rf +77IzlhEYt8llvhjho6Tc+hj507wTmzl6NLrTQfv6MooqtyuGC2mDOL7Nii4LcK2N +JpLuHvUBKwrZ1pebbuCoGRw6IYsMHkCtA+fdZn71uSANA+iW+YJF1DngoABd15jm +fZ5nc8OaKveri6E6FO80vFIOiZiaBECEHX5FaZNXzuvO+FB8TxxuBEOb+dY7Ixjp +6o7RTUaN8Tvkasq6+yO3m/qZASlaWFot4/nUbQ4mrcFuNLwy+AwF+mWj2zs3gyLp +1txyM/1d8iC9djwj2ij3+RvrWWTV3F9yfiD8zYm1kGdNYno/Tq0dwzn+evQoFt9B +9kiABdcPUXmsEKvU7ANm5mqwujGSQkBqvjrTcuFqN1W8rB2Vt2lh8kORdOag0wok +RqEIr9baRRmW1FMdW4R58MD3R++Lj8UGrp1MYp3/RgT408m2ECVAdf4WqslKYIYv +uu8wd+RU4riEmViAqhOLUTpPSPaLtrM= +-----END CERTIFICATE----- + +# Issuer: CN=Amazon Root CA 1 O=Amazon +# Subject: CN=Amazon Root CA 1 O=Amazon +# Label: "Amazon Root CA 1" +# Serial: 143266978916655856878034712317230054538369994 +# MD5 Fingerprint: 43:c6:bf:ae:ec:fe:ad:2f:18:c6:88:68:30:fc:c8:e6 +# SHA1 Fingerprint: 8d:a7:f9:65:ec:5e:fc:37:91:0f:1c:6e:59:fd:c1:cc:6a:6e:de:16 +# SHA256 Fingerprint: 8e:cd:e6:88:4f:3d:87:b1:12:5b:a3:1a:c3:fc:b1:3d:70:16:de:7f:57:cc:90:4f:e1:cb:97:c6:ae:98:19:6e +-----BEGIN CERTIFICATE----- +MIIDQTCCAimgAwIBAgITBmyfz5m/jAo54vB4ikPmljZbyjANBgkqhkiG9w0BAQsF +ADA5MQswCQYDVQQGEwJVUzEPMA0GA1UEChMGQW1hem9uMRkwFwYDVQQDExBBbWF6 +b24gUm9vdCBDQSAxMB4XDTE1MDUyNjAwMDAwMFoXDTM4MDExNzAwMDAwMFowOTEL +MAkGA1UEBhMCVVMxDzANBgNVBAoTBkFtYXpvbjEZMBcGA1UEAxMQQW1hem9uIFJv +b3QgQ0EgMTCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBALJ4gHHKeNXj +ca9HgFB0fW7Y14h29Jlo91ghYPl0hAEvrAIthtOgQ3pOsqTQNroBvo3bSMgHFzZM +9O6II8c+6zf1tRn4SWiw3te5djgdYZ6k/oI2peVKVuRF4fn9tBb6dNqcmzU5L/qw +IFAGbHrQgLKm+a/sRxmPUDgH3KKHOVj4utWp+UhnMJbulHheb4mjUcAwhmahRWa6 +VOujw5H5SNz/0egwLX0tdHA114gk957EWW67c4cX8jJGKLhD+rcdqsq08p8kDi1L +93FcXmn/6pUCyziKrlA4b9v7LWIbxcceVOF34GfID5yHI9Y/QCB/IIDEgEw+OyQm +jgSubJrIqg0CAwEAAaNCMEAwDwYDVR0TAQH/BAUwAwEB/zAOBgNVHQ8BAf8EBAMC +AYYwHQYDVR0OBBYEFIQYzIU07LwMlJQuCFmcx7IQTgoIMA0GCSqGSIb3DQEBCwUA +A4IBAQCY8jdaQZChGsV2USggNiMOruYou6r4lK5IpDB/G/wkjUu0yKGX9rbxenDI +U5PMCCjjmCXPI6T53iHTfIUJrU6adTrCC2qJeHZERxhlbI1Bjjt/msv0tadQ1wUs +N+gDS63pYaACbvXy8MWy7Vu33PqUXHeeE6V/Uq2V8viTO96LXFvKWlJbYK8U90vv +o/ufQJVtMVT8QtPHRh8jrdkPSHCa2XV4cdFyQzR1bldZwgJcJmApzyMZFo6IQ6XU +5MsI+yMRQ+hDKXJioaldXgjUkK642M4UwtBV8ob2xJNDd2ZhwLnoQdeXeGADbkpy +rqXRfboQnoZsG4q5WTP468SQvvG5 +-----END CERTIFICATE----- + +# Issuer: CN=Amazon Root CA 2 O=Amazon +# Subject: CN=Amazon Root CA 2 O=Amazon +# Label: "Amazon Root CA 2" +# Serial: 143266982885963551818349160658925006970653239 +# MD5 Fingerprint: c8:e5:8d:ce:a8:42:e2:7a:c0:2a:5c:7c:9e:26:bf:66 +# SHA1 Fingerprint: 5a:8c:ef:45:d7:a6:98:59:76:7a:8c:8b:44:96:b5:78:cf:47:4b:1a +# SHA256 Fingerprint: 1b:a5:b2:aa:8c:65:40:1a:82:96:01:18:f8:0b:ec:4f:62:30:4d:83:ce:c4:71:3a:19:c3:9c:01:1e:a4:6d:b4 +-----BEGIN CERTIFICATE----- +MIIFQTCCAymgAwIBAgITBmyf0pY1hp8KD+WGePhbJruKNzANBgkqhkiG9w0BAQwF +ADA5MQswCQYDVQQGEwJVUzEPMA0GA1UEChMGQW1hem9uMRkwFwYDVQQDExBBbWF6 +b24gUm9vdCBDQSAyMB4XDTE1MDUyNjAwMDAwMFoXDTQwMDUyNjAwMDAwMFowOTEL +MAkGA1UEBhMCVVMxDzANBgNVBAoTBkFtYXpvbjEZMBcGA1UEAxMQQW1hem9uIFJv +b3QgQ0EgMjCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBAK2Wny2cSkxK +gXlRmeyKy2tgURO8TW0G/LAIjd0ZEGrHJgw12MBvIITplLGbhQPDW9tK6Mj4kHbZ +W0/jTOgGNk3Mmqw9DJArktQGGWCsN0R5hYGCrVo34A3MnaZMUnbqQ523BNFQ9lXg +1dKmSYXpN+nKfq5clU1Imj+uIFptiJXZNLhSGkOQsL9sBbm2eLfq0OQ6PBJTYv9K +8nu+NQWpEjTj82R0Yiw9AElaKP4yRLuH3WUnAnE72kr3H9rN9yFVkE8P7K6C4Z9r +2UXTu/Bfh+08LDmG2j/e7HJV63mjrdvdfLC6HM783k81ds8P+HgfajZRRidhW+me +z/CiVX18JYpvL7TFz4QuK/0NURBs+18bvBt+xa47mAExkv8LV/SasrlX6avvDXbR +8O70zoan4G7ptGmh32n2M8ZpLpcTnqWHsFcQgTfJU7O7f/aS0ZzQGPSSbtqDT6Zj +mUyl+17vIWR6IF9sZIUVyzfpYgwLKhbcAS4y2j5L9Z469hdAlO+ekQiG+r5jqFoz +7Mt0Q5X5bGlSNscpb/xVA1wf+5+9R+vnSUeVC06JIglJ4PVhHvG/LopyboBZ/1c6 ++XUyo05f7O0oYtlNc/LMgRdg7c3r3NunysV+Ar3yVAhU/bQtCSwXVEqY0VThUWcI +0u1ufm8/0i2BWSlmy5A5lREedCf+3euvAgMBAAGjQjBAMA8GA1UdEwEB/wQFMAMB +Af8wDgYDVR0PAQH/BAQDAgGGMB0GA1UdDgQWBBSwDPBMMPQFWAJI/TPlUq9LhONm +UjANBgkqhkiG9w0BAQwFAAOCAgEAqqiAjw54o+Ci1M3m9Zh6O+oAA7CXDpO8Wqj2 +LIxyh6mx/H9z/WNxeKWHWc8w4Q0QshNabYL1auaAn6AFC2jkR2vHat+2/XcycuUY ++gn0oJMsXdKMdYV2ZZAMA3m3MSNjrXiDCYZohMr/+c8mmpJ5581LxedhpxfL86kS +k5Nrp+gvU5LEYFiwzAJRGFuFjWJZY7attN6a+yb3ACfAXVU3dJnJUH/jWS5E4ywl +7uxMMne0nxrpS10gxdr9HIcWxkPo1LsmmkVwXqkLN1PiRnsn/eBG8om3zEK2yygm +btmlyTrIQRNg91CMFa6ybRoVGld45pIq2WWQgj9sAq+uEjonljYE1x2igGOpm/Hl +urR8FLBOybEfdF849lHqm/osohHUqS0nGkWxr7JOcQ3AWEbWaQbLU8uz/mtBzUF+ +fUwPfHJ5elnNXkoOrJupmHN5fLT0zLm4BwyydFy4x2+IoZCn9Kr5v2c69BoVYh63 +n749sSmvZ6ES8lgQGVMDMBu4Gon2nL2XA46jCfMdiyHxtN/kHNGfZQIG6lzWE7OE +76KlXIx3KadowGuuQNKotOrN8I1LOJwZmhsoVLiJkO/KdYE+HvJkJMcYr07/R54H +9jVlpNMKVv/1F2Rs76giJUmTtt8AF9pYfl3uxRuw0dFfIRDH+fO6AgonB8Xx1sfT +4PsJYGw= +-----END CERTIFICATE----- + +# Issuer: CN=Amazon Root CA 3 O=Amazon +# Subject: CN=Amazon Root CA 3 O=Amazon +# Label: "Amazon Root CA 3" +# Serial: 143266986699090766294700635381230934788665930 +# MD5 Fingerprint: a0:d4:ef:0b:f7:b5:d8:49:95:2a:ec:f5:c4:fc:81:87 +# SHA1 Fingerprint: 0d:44:dd:8c:3c:8c:1a:1a:58:75:64:81:e9:0f:2e:2a:ff:b3:d2:6e +# SHA256 Fingerprint: 18:ce:6c:fe:7b:f1:4e:60:b2:e3:47:b8:df:e8:68:cb:31:d0:2e:bb:3a:da:27:15:69:f5:03:43:b4:6d:b3:a4 +-----BEGIN CERTIFICATE----- +MIIBtjCCAVugAwIBAgITBmyf1XSXNmY/Owua2eiedgPySjAKBggqhkjOPQQDAjA5 +MQswCQYDVQQGEwJVUzEPMA0GA1UEChMGQW1hem9uMRkwFwYDVQQDExBBbWF6b24g +Um9vdCBDQSAzMB4XDTE1MDUyNjAwMDAwMFoXDTQwMDUyNjAwMDAwMFowOTELMAkG +A1UEBhMCVVMxDzANBgNVBAoTBkFtYXpvbjEZMBcGA1UEAxMQQW1hem9uIFJvb3Qg +Q0EgMzBZMBMGByqGSM49AgEGCCqGSM49AwEHA0IABCmXp8ZBf8ANm+gBG1bG8lKl +ui2yEujSLtf6ycXYqm0fc4E7O5hrOXwzpcVOho6AF2hiRVd9RFgdszflZwjrZt6j +QjBAMA8GA1UdEwEB/wQFMAMBAf8wDgYDVR0PAQH/BAQDAgGGMB0GA1UdDgQWBBSr +ttvXBp43rDCGB5Fwx5zEGbF4wDAKBggqhkjOPQQDAgNJADBGAiEA4IWSoxe3jfkr +BqWTrBqYaGFy+uGh0PsceGCmQ5nFuMQCIQCcAu/xlJyzlvnrxir4tiz+OpAUFteM +YyRIHN8wfdVoOw== +-----END CERTIFICATE----- + +# Issuer: CN=Amazon Root CA 4 O=Amazon +# Subject: CN=Amazon Root CA 4 O=Amazon +# Label: "Amazon Root CA 4" +# Serial: 143266989758080763974105200630763877849284878 +# MD5 Fingerprint: 89:bc:27:d5:eb:17:8d:06:6a:69:d5:fd:89:47:b4:cd +# SHA1 Fingerprint: f6:10:84:07:d6:f8:bb:67:98:0c:c2:e2:44:c2:eb:ae:1c:ef:63:be +# SHA256 Fingerprint: e3:5d:28:41:9e:d0:20:25:cf:a6:90:38:cd:62:39:62:45:8d:a5:c6:95:fb:de:a3:c2:2b:0b:fb:25:89:70:92 +-----BEGIN CERTIFICATE----- +MIIB8jCCAXigAwIBAgITBmyf18G7EEwpQ+Vxe3ssyBrBDjAKBggqhkjOPQQDAzA5 +MQswCQYDVQQGEwJVUzEPMA0GA1UEChMGQW1hem9uMRkwFwYDVQQDExBBbWF6b24g +Um9vdCBDQSA0MB4XDTE1MDUyNjAwMDAwMFoXDTQwMDUyNjAwMDAwMFowOTELMAkG +A1UEBhMCVVMxDzANBgNVBAoTBkFtYXpvbjEZMBcGA1UEAxMQQW1hem9uIFJvb3Qg +Q0EgNDB2MBAGByqGSM49AgEGBSuBBAAiA2IABNKrijdPo1MN/sGKe0uoe0ZLY7Bi +9i0b2whxIdIA6GO9mif78DluXeo9pcmBqqNbIJhFXRbb/egQbeOc4OO9X4Ri83Bk +M6DLJC9wuoihKqB1+IGuYgbEgds5bimwHvouXKNCMEAwDwYDVR0TAQH/BAUwAwEB +/zAOBgNVHQ8BAf8EBAMCAYYwHQYDVR0OBBYEFNPsxzplbszh2naaVvuc84ZtV+WB +MAoGCCqGSM49BAMDA2gAMGUCMDqLIfG9fhGt0O9Yli/W651+kI0rz2ZVwyzjKKlw +CkcO8DdZEv8tmZQoTipPNU0zWgIxAOp1AE47xDqUEpHJWEadIRNyp4iciuRMStuW +1KyLa2tJElMzrdfkviT8tQp21KW8EA== +-----END CERTIFICATE----- + +# Issuer: CN=TUBITAK Kamu SM SSL Kok Sertifikasi - Surum 1 O=Turkiye Bilimsel ve Teknolojik Arastirma Kurumu - TUBITAK OU=Kamu Sertifikasyon Merkezi - Kamu SM +# Subject: CN=TUBITAK Kamu SM SSL Kok Sertifikasi - Surum 1 O=Turkiye Bilimsel ve Teknolojik Arastirma Kurumu - TUBITAK OU=Kamu Sertifikasyon Merkezi - Kamu SM +# Label: "TUBITAK Kamu SM SSL Kok Sertifikasi - Surum 1" +# Serial: 1 +# MD5 Fingerprint: dc:00:81:dc:69:2f:3e:2f:b0:3b:f6:3d:5a:91:8e:49 +# SHA1 Fingerprint: 31:43:64:9b:ec:ce:27:ec:ed:3a:3f:0b:8f:0d:e4:e8:91:dd:ee:ca +# SHA256 Fingerprint: 46:ed:c3:68:90:46:d5:3a:45:3f:b3:10:4a:b8:0d:ca:ec:65:8b:26:60:ea:16:29:dd:7e:86:79:90:64:87:16 +-----BEGIN CERTIFICATE----- +MIIEYzCCA0ugAwIBAgIBATANBgkqhkiG9w0BAQsFADCB0jELMAkGA1UEBhMCVFIx +GDAWBgNVBAcTD0dlYnplIC0gS29jYWVsaTFCMEAGA1UEChM5VHVya2l5ZSBCaWxp +bXNlbCB2ZSBUZWtub2xvamlrIEFyYXN0aXJtYSBLdXJ1bXUgLSBUVUJJVEFLMS0w +KwYDVQQLEyRLYW11IFNlcnRpZmlrYXN5b24gTWVya2V6aSAtIEthbXUgU00xNjA0 +BgNVBAMTLVRVQklUQUsgS2FtdSBTTSBTU0wgS29rIFNlcnRpZmlrYXNpIC0gU3Vy +dW0gMTAeFw0xMzExMjUwODI1NTVaFw00MzEwMjUwODI1NTVaMIHSMQswCQYDVQQG +EwJUUjEYMBYGA1UEBxMPR2ViemUgLSBLb2NhZWxpMUIwQAYDVQQKEzlUdXJraXll +IEJpbGltc2VsIHZlIFRla25vbG9qaWsgQXJhc3Rpcm1hIEt1cnVtdSAtIFRVQklU +QUsxLTArBgNVBAsTJEthbXUgU2VydGlmaWthc3lvbiBNZXJrZXppIC0gS2FtdSBT +TTE2MDQGA1UEAxMtVFVCSVRBSyBLYW11IFNNIFNTTCBLb2sgU2VydGlmaWthc2kg +LSBTdXJ1bSAxMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAr3UwM6q7 +a9OZLBI3hNmNe5eA027n/5tQlT6QlVZC1xl8JoSNkvoBHToP4mQ4t4y86Ij5iySr +LqP1N+RAjhgleYN1Hzv/bKjFxlb4tO2KRKOrbEz8HdDc72i9z+SqzvBV96I01INr +N3wcwv61A+xXzry0tcXtAA9TNypN9E8Mg/uGz8v+jE69h/mniyFXnHrfA2eJLJ2X +YacQuFWQfw4tJzh03+f92k4S400VIgLI4OD8D62K18lUUMw7D8oWgITQUVbDjlZ/ +iSIzL+aFCr2lqBs23tPcLG07xxO9WSMs5uWk99gL7eqQQESolbuT1dCANLZGeA4f +AJNG4e7p+exPFwIDAQABo0IwQDAdBgNVHQ4EFgQUZT/HiobGPN08VFw1+DrtUgxH +V8gwDgYDVR0PAQH/BAQDAgEGMA8GA1UdEwEB/wQFMAMBAf8wDQYJKoZIhvcNAQEL +BQADggEBACo/4fEyjq7hmFxLXs9rHmoJ0iKpEsdeV31zVmSAhHqT5Am5EM2fKifh +AHe+SMg1qIGf5LgsyX8OsNJLN13qudULXjS99HMpw+0mFZx+CFOKWI3QSyjfwbPf +IPP54+M638yclNhOT8NrF7f3cuitZjO1JVOr4PhMqZ398g26rrnZqsZr+ZO7rqu4 +lzwDGrpDxpa5RXI4s6ehlj2Re37AIVNMh+3yC1SVUZPVIqUNivGTDj5UDrDYyU7c +8jEyVupk+eq1nRZmQnLzf9OxMUP8pI4X8W0jq5Rm+K37DwhuJi1/FwcJsoz7UMCf +lo3Ptv0AnVoUmr8CRPXBwp8iXqIPoeM= +-----END CERTIFICATE----- + +# Issuer: CN=GDCA TrustAUTH R5 ROOT O=GUANG DONG CERTIFICATE AUTHORITY CO.,LTD. +# Subject: CN=GDCA TrustAUTH R5 ROOT O=GUANG DONG CERTIFICATE AUTHORITY CO.,LTD. +# Label: "GDCA TrustAUTH R5 ROOT" +# Serial: 9009899650740120186 +# MD5 Fingerprint: 63:cc:d9:3d:34:35:5c:6f:53:a3:e2:08:70:48:1f:b4 +# SHA1 Fingerprint: 0f:36:38:5b:81:1a:25:c3:9b:31:4e:83:ca:e9:34:66:70:cc:74:b4 +# SHA256 Fingerprint: bf:ff:8f:d0:44:33:48:7d:6a:8a:a6:0c:1a:29:76:7a:9f:c2:bb:b0:5e:42:0f:71:3a:13:b9:92:89:1d:38:93 +-----BEGIN CERTIFICATE----- +MIIFiDCCA3CgAwIBAgIIfQmX/vBH6nowDQYJKoZIhvcNAQELBQAwYjELMAkGA1UE +BhMCQ04xMjAwBgNVBAoMKUdVQU5HIERPTkcgQ0VSVElGSUNBVEUgQVVUSE9SSVRZ +IENPLixMVEQuMR8wHQYDVQQDDBZHRENBIFRydXN0QVVUSCBSNSBST09UMB4XDTE0 +MTEyNjA1MTMxNVoXDTQwMTIzMTE1NTk1OVowYjELMAkGA1UEBhMCQ04xMjAwBgNV +BAoMKUdVQU5HIERPTkcgQ0VSVElGSUNBVEUgQVVUSE9SSVRZIENPLixMVEQuMR8w +HQYDVQQDDBZHRENBIFRydXN0QVVUSCBSNSBST09UMIICIjANBgkqhkiG9w0BAQEF +AAOCAg8AMIICCgKCAgEA2aMW8Mh0dHeb7zMNOwZ+Vfy1YI92hhJCfVZmPoiC7XJj +Dp6L3TQsAlFRwxn9WVSEyfFrs0yw6ehGXTjGoqcuEVe6ghWinI9tsJlKCvLriXBj +TnnEt1u9ol2x8kECK62pOqPseQrsXzrj/e+APK00mxqriCZ7VqKChh/rNYmDf1+u +KU49tm7srsHwJ5uu4/Ts765/94Y9cnrrpftZTqfrlYwiOXnhLQiPzLyRuEH3FMEj +qcOtmkVEs7LXLM3GKeJQEK5cy4KOFxg2fZfmiJqwTTQJ9Cy5WmYqsBebnh52nUpm +MUHfP/vFBu8btn4aRjb3ZGM74zkYI+dndRTVdVeSN72+ahsmUPI2JgaQxXABZG12 +ZuGR224HwGGALrIuL4xwp9E7PLOR5G62xDtw8mySlwnNR30YwPO7ng/Wi64HtloP +zgsMR6flPri9fcebNaBhlzpBdRfMK5Z3KpIhHtmVdiBnaM8Nvd/WHwlqmuLMc3Gk +L30SgLdTMEZeS1SZD2fJpcjyIMGC7J0R38IC+xo70e0gmu9lZJIQDSri3nDxGGeC +jGHeuLzRL5z7D9Ar7Rt2ueQ5Vfj4oR24qoAATILnsn8JuLwwoC8N9VKejveSswoA +HQBUlwbgsQfZxw9cZX08bVlX5O2ljelAU58VS6Bx9hoh49pwBiFYFIeFd3mqgnkC +AwEAAaNCMEAwHQYDVR0OBBYEFOLJQJ9NzuiaoXzPDj9lxSmIahlRMA8GA1UdEwEB +/wQFMAMBAf8wDgYDVR0PAQH/BAQDAgGGMA0GCSqGSIb3DQEBCwUAA4ICAQDRSVfg +p8xoWLoBDysZzY2wYUWsEe1jUGn4H3++Fo/9nesLqjJHdtJnJO29fDMylyrHBYZm +DRd9FBUb1Ov9H5r2XpdptxolpAqzkT9fNqyL7FeoPueBihhXOYV0GkLH6VsTX4/5 +COmSdI31R9KrO9b7eGZONn356ZLpBN79SWP8bfsUcZNnL0dKt7n/HipzcEYwv1ry +L3ml4Y0M2fmyYzeMN2WFcGpcWwlyua1jPLHd+PwyvzeG5LuOmCd+uh8W4XAR8gPf +JWIyJyYYMoSf/wA6E7qaTfRPuBRwIrHKK5DOKcFw9C+df/KQHtZa37dG/OaG+svg +IHZ6uqbL9XzeYqWxi+7egmaKTjowHz+Ay60nugxe19CxVsp3cbK1daFQqUBDF8Io +2c9Si1vIY9RCPqAzekYu9wogRlR+ak8x8YF+QnQ4ZXMn7sZ8uI7XpTrXmKGcjBBV +09tL7ECQ8s1uV9JiDnxXk7Gnbc2dg7sq5+W2O3FYrf3RRbxake5TFW/TRQl1brqQ +XR4EzzffHqhmsYzmIGrv/EhOdJhCrylvLmrH+33RZjEizIYAfmaDDEL0vTSSwxrq +T8p+ck0LcIymSLumoRT2+1hEmRSuqguTaaApJUqlyyvdimYHFngVV3Eb7PVHhPOe +MTd61X8kreS8/f3MboPoDKi3QWwH3b08hpcv0g== +-----END CERTIFICATE----- + +# Issuer: CN=SSL.com Root Certification Authority RSA O=SSL Corporation +# Subject: CN=SSL.com Root Certification Authority RSA O=SSL Corporation +# Label: "SSL.com Root Certification Authority RSA" +# Serial: 8875640296558310041 +# MD5 Fingerprint: 86:69:12:c0:70:f1:ec:ac:ac:c2:d5:bc:a5:5b:a1:29 +# SHA1 Fingerprint: b7:ab:33:08:d1:ea:44:77:ba:14:80:12:5a:6f:bd:a9:36:49:0c:bb +# SHA256 Fingerprint: 85:66:6a:56:2e:e0:be:5c:e9:25:c1:d8:89:0a:6f:76:a8:7e:c1:6d:4d:7d:5f:29:ea:74:19:cf:20:12:3b:69 +-----BEGIN CERTIFICATE----- +MIIF3TCCA8WgAwIBAgIIeyyb0xaAMpkwDQYJKoZIhvcNAQELBQAwfDELMAkGA1UE +BhMCVVMxDjAMBgNVBAgMBVRleGFzMRAwDgYDVQQHDAdIb3VzdG9uMRgwFgYDVQQK +DA9TU0wgQ29ycG9yYXRpb24xMTAvBgNVBAMMKFNTTC5jb20gUm9vdCBDZXJ0aWZp +Y2F0aW9uIEF1dGhvcml0eSBSU0EwHhcNMTYwMjEyMTczOTM5WhcNNDEwMjEyMTcz +OTM5WjB8MQswCQYDVQQGEwJVUzEOMAwGA1UECAwFVGV4YXMxEDAOBgNVBAcMB0hv +dXN0b24xGDAWBgNVBAoMD1NTTCBDb3Jwb3JhdGlvbjExMC8GA1UEAwwoU1NMLmNv +bSBSb290IENlcnRpZmljYXRpb24gQXV0aG9yaXR5IFJTQTCCAiIwDQYJKoZIhvcN +AQEBBQADggIPADCCAgoCggIBAPkP3aMrfcvQKv7sZ4Wm5y4bunfh4/WvpOz6Sl2R +xFdHaxh3a3by/ZPkPQ/CFp4LZsNWlJ4Xg4XOVu/yFv0AYvUiCVToZRdOQbngT0aX +qhvIuG5iXmmxX9sqAn78bMrzQdjt0Oj8P2FI7bADFB0QDksZ4LtO7IZl/zbzXmcC +C52GVWH9ejjt/uIZALdvoVBidXQ8oPrIJZK0bnoix/geoeOy3ZExqysdBP+lSgQ3 +6YWkMyv94tZVNHwZpEpox7Ko07fKoZOI68GXvIz5HdkihCR0xwQ9aqkpk8zruFvh +/l8lqjRYyMEjVJ0bmBHDOJx+PYZspQ9AhnwC9FwCTyjLrnGfDzrIM/4RJTXq/LrF +YD3ZfBjVsqnTdXgDciLKOsMf7yzlLqn6niy2UUb9rwPW6mBo6oUWNmuF6R7As93E +JNyAKoFBbZQ+yODJgUEAnl6/f8UImKIYLEJAs/lvOCdLToD0PYFH4Ih86hzOtXVc +US4cK38acijnALXRdMbX5J+tB5O2UzU1/Dfkw/ZdFr4hc96SCvigY2q8lpJqPvi8 +ZVWb3vUNiSYE/CUapiVpy8JtynziWV+XrOvvLsi81xtZPCvM8hnIk2snYxnP/Okm ++Mpxm3+T/jRnhE6Z6/yzeAkzcLpmpnbtG3PrGqUNxCITIJRWCk4sbE6x/c+cCbqi +M+2HAgMBAAGjYzBhMB0GA1UdDgQWBBTdBAkHovV6fVJTEpKV7jiAJQ2mWTAPBgNV +HRMBAf8EBTADAQH/MB8GA1UdIwQYMBaAFN0ECQei9Xp9UlMSkpXuOIAlDaZZMA4G +A1UdDwEB/wQEAwIBhjANBgkqhkiG9w0BAQsFAAOCAgEAIBgRlCn7Jp0cHh5wYfGV +cpNxJK1ok1iOMq8bs3AD/CUrdIWQPXhq9LmLpZc7tRiRux6n+UBbkflVma8eEdBc +Hadm47GUBwwyOabqG7B52B2ccETjit3E+ZUfijhDPwGFpUenPUayvOUiaPd7nNgs +PgohyC0zrL/FgZkxdMF1ccW+sfAjRfSda/wZY52jvATGGAslu1OJD7OAUN5F7kR/ +q5R4ZJjT9ijdh9hwZXT7DrkT66cPYakylszeu+1jTBi7qUD3oFRuIIhxdRjqerQ0 +cuAjJ3dctpDqhiVAq+8zD8ufgr6iIPv2tS0a5sKFsXQP+8hlAqRSAUfdSSLBv9jr +a6x+3uxjMxW3IwiPxg+NQVrdjsW5j+VFP3jbutIbQLH+cU0/4IGiul607BXgk90I +H37hVZkLId6Tngr75qNJvTYw/ud3sqB1l7UtgYgXZSD32pAAn8lSzDLKNXz1PQ/Y +K9f1JmzJBjSWFupwWRoyeXkLtoh/D1JIPb9s2KJELtFOt3JY04kTlf5Eq/jXixtu +nLwsoFvVagCvXzfh1foQC5ichucmj87w7G6KVwuA406ywKBjYZC6VWg3dGq2ktuf +oYYitmUnDuy2n0Jg5GfCtdpBC8TTi2EbvPofkSvXRAdeuims2cXp71NIWuuA8ShY +Ic2wBlX7Jz9TkHCpBB5XJ7k= +-----END CERTIFICATE----- + +# Issuer: CN=SSL.com Root Certification Authority ECC O=SSL Corporation +# Subject: CN=SSL.com Root Certification Authority ECC O=SSL Corporation +# Label: "SSL.com Root Certification Authority ECC" +# Serial: 8495723813297216424 +# MD5 Fingerprint: 2e:da:e4:39:7f:9c:8f:37:d1:70:9f:26:17:51:3a:8e +# SHA1 Fingerprint: c3:19:7c:39:24:e6:54:af:1b:c4:ab:20:95:7a:e2:c3:0e:13:02:6a +# SHA256 Fingerprint: 34:17:bb:06:cc:60:07:da:1b:96:1c:92:0b:8a:b4:ce:3f:ad:82:0e:4a:a3:0b:9a:cb:c4:a7:4e:bd:ce:bc:65 +-----BEGIN CERTIFICATE----- +MIICjTCCAhSgAwIBAgIIdebfy8FoW6gwCgYIKoZIzj0EAwIwfDELMAkGA1UEBhMC +VVMxDjAMBgNVBAgMBVRleGFzMRAwDgYDVQQHDAdIb3VzdG9uMRgwFgYDVQQKDA9T +U0wgQ29ycG9yYXRpb24xMTAvBgNVBAMMKFNTTC5jb20gUm9vdCBDZXJ0aWZpY2F0 +aW9uIEF1dGhvcml0eSBFQ0MwHhcNMTYwMjEyMTgxNDAzWhcNNDEwMjEyMTgxNDAz +WjB8MQswCQYDVQQGEwJVUzEOMAwGA1UECAwFVGV4YXMxEDAOBgNVBAcMB0hvdXN0 +b24xGDAWBgNVBAoMD1NTTCBDb3Jwb3JhdGlvbjExMC8GA1UEAwwoU1NMLmNvbSBS +b290IENlcnRpZmljYXRpb24gQXV0aG9yaXR5IEVDQzB2MBAGByqGSM49AgEGBSuB +BAAiA2IABEVuqVDEpiM2nl8ojRfLliJkP9x6jh3MCLOicSS6jkm5BBtHllirLZXI +7Z4INcgn64mMU1jrYor+8FsPazFSY0E7ic3s7LaNGdM0B9y7xgZ/wkWV7Mt/qCPg +CemB+vNH06NjMGEwHQYDVR0OBBYEFILRhXMw5zUE044CkvvlpNHEIejNMA8GA1Ud +EwEB/wQFMAMBAf8wHwYDVR0jBBgwFoAUgtGFczDnNQTTjgKS++Wk0cQh6M0wDgYD +VR0PAQH/BAQDAgGGMAoGCCqGSM49BAMCA2cAMGQCMG/n61kRpGDPYbCWe+0F+S8T +kdzt5fxQaxFGRrMcIQBiu77D5+jNB5n5DQtdcj7EqgIwH7y6C+IwJPt8bYBVCpk+ +gA0z5Wajs6O7pdWLjwkspl1+4vAHCGht0nxpbl/f5Wpl +-----END CERTIFICATE----- + +# Issuer: CN=SSL.com EV Root Certification Authority RSA R2 O=SSL Corporation +# Subject: CN=SSL.com EV Root Certification Authority RSA R2 O=SSL Corporation +# Label: "SSL.com EV Root Certification Authority RSA R2" +# Serial: 6248227494352943350 +# MD5 Fingerprint: e1:1e:31:58:1a:ae:54:53:02:f6:17:6a:11:7b:4d:95 +# SHA1 Fingerprint: 74:3a:f0:52:9b:d0:32:a0:f4:4a:83:cd:d4:ba:a9:7b:7c:2e:c4:9a +# SHA256 Fingerprint: 2e:7b:f1:6c:c2:24:85:a7:bb:e2:aa:86:96:75:07:61:b0:ae:39:be:3b:2f:e9:d0:cc:6d:4e:f7:34:91:42:5c +-----BEGIN CERTIFICATE----- +MIIF6zCCA9OgAwIBAgIIVrYpzTS8ePYwDQYJKoZIhvcNAQELBQAwgYIxCzAJBgNV +BAYTAlVTMQ4wDAYDVQQIDAVUZXhhczEQMA4GA1UEBwwHSG91c3RvbjEYMBYGA1UE +CgwPU1NMIENvcnBvcmF0aW9uMTcwNQYDVQQDDC5TU0wuY29tIEVWIFJvb3QgQ2Vy +dGlmaWNhdGlvbiBBdXRob3JpdHkgUlNBIFIyMB4XDTE3MDUzMTE4MTQzN1oXDTQy +MDUzMDE4MTQzN1owgYIxCzAJBgNVBAYTAlVTMQ4wDAYDVQQIDAVUZXhhczEQMA4G +A1UEBwwHSG91c3RvbjEYMBYGA1UECgwPU1NMIENvcnBvcmF0aW9uMTcwNQYDVQQD +DC5TU0wuY29tIEVWIFJvb3QgQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkgUlNBIFIy +MIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEAjzZlQOHWTcDXtOlG2mvq +M0fNTPl9fb69LT3w23jhhqXZuglXaO1XPqDQCEGD5yhBJB/jchXQARr7XnAjssuf +OePPxU7Gkm0mxnu7s9onnQqG6YE3Bf7wcXHswxzpY6IXFJ3vG2fThVUCAtZJycxa +4bH3bzKfydQ7iEGonL3Lq9ttewkfokxykNorCPzPPFTOZw+oz12WGQvE43LrrdF9 +HSfvkusQv1vrO6/PgN3B0pYEW3p+pKk8OHakYo6gOV7qd89dAFmPZiw+B6KjBSYR +aZfqhbcPlgtLyEDhULouisv3D5oi53+aNxPN8k0TayHRwMwi8qFG9kRpnMphNQcA +b9ZhCBHqurj26bNg5U257J8UZslXWNvNh2n4ioYSA0e/ZhN2rHd9NCSFg83XqpyQ +Gp8hLH94t2S42Oim9HizVcuE0jLEeK6jj2HdzghTreyI/BXkmg3mnxp3zkyPuBQV +PWKchjgGAGYS5Fl2WlPAApiiECtoRHuOec4zSnaqW4EWG7WK2NAAe15itAnWhmMO +pgWVSbooi4iTsjQc2KRVbrcc0N6ZVTsj9CLg+SlmJuwgUHfbSguPvuUCYHBBXtSu +UDkiFCbLsjtzdFVHB3mBOagwE0TlBIqulhMlQg+5U8Sb/M3kHN48+qvWBkofZ6aY +MBzdLNvcGJVXZsb/XItW9XcCAwEAAaNjMGEwDwYDVR0TAQH/BAUwAwEB/zAfBgNV +HSMEGDAWgBT5YLvU49U09rj1BoAlp3PbRmmonjAdBgNVHQ4EFgQU+WC71OPVNPa4 +9QaAJadz20ZpqJ4wDgYDVR0PAQH/BAQDAgGGMA0GCSqGSIb3DQEBCwUAA4ICAQBW +s47LCp1Jjr+kxJG7ZhcFUZh1++VQLHqe8RT6q9OKPv+RKY9ji9i0qVQBDb6Thi/5 +Sm3HXvVX+cpVHBK+Rw82xd9qt9t1wkclf7nxY/hoLVUE0fKNsKTPvDxeH3jnpaAg +cLAExbf3cqfeIg29MyVGjGSSJuM+LmOW2puMPfgYCdcDzH2GguDKBAdRUNf/ktUM +79qGn5nX67evaOI5JpS6aLe/g9Pqemc9YmeuJeVy6OLk7K4S9ksrPJ/psEDzOFSz +/bdoyNrGj1E8svuR3Bznm53htw1yj+KkxKl4+esUrMZDBcJlOSgYAsOCsp0FvmXt +ll9ldDz7CTUue5wT/RsPXcdtgTpWD8w74a8CLyKsRspGPKAcTNZEtF4uXBVmCeEm +Kf7GUmG6sXP/wwyc5WxqlD8UykAWlYTzWamsX0xhk23RO8yilQwipmdnRC652dKK +QbNmC1r7fSOl8hqw/96bg5Qu0T/fkreRrwU7ZcegbLHNYhLDkBvjJc40vG93drEQ +w/cFGsDWr3RiSBd3kmmQYRzelYB0VI8YHMPzA9C/pEN1hlMYegouCRw2n5H9gooi +S9EOUCXdywMMF8mDAAhONU2Ki+3wApRmLER/y5UnlhetCTCstnEXbosX9hwJ1C07 +mKVx01QT2WDz9UtmT/rx7iASjbSsV7FFY6GsdqnC+w== +-----END CERTIFICATE----- + +# Issuer: CN=SSL.com EV Root Certification Authority ECC O=SSL Corporation +# Subject: CN=SSL.com EV Root Certification Authority ECC O=SSL Corporation +# Label: "SSL.com EV Root Certification Authority ECC" +# Serial: 3182246526754555285 +# MD5 Fingerprint: 59:53:22:65:83:42:01:54:c0:ce:42:b9:5a:7c:f2:90 +# SHA1 Fingerprint: 4c:dd:51:a3:d1:f5:20:32:14:b0:c6:c5:32:23:03:91:c7:46:42:6d +# SHA256 Fingerprint: 22:a2:c1:f7:bd:ed:70:4c:c1:e7:01:b5:f4:08:c3:10:88:0f:e9:56:b5:de:2a:4a:44:f9:9c:87:3a:25:a7:c8 +-----BEGIN CERTIFICATE----- +MIIClDCCAhqgAwIBAgIILCmcWxbtBZUwCgYIKoZIzj0EAwIwfzELMAkGA1UEBhMC +VVMxDjAMBgNVBAgMBVRleGFzMRAwDgYDVQQHDAdIb3VzdG9uMRgwFgYDVQQKDA9T +U0wgQ29ycG9yYXRpb24xNDAyBgNVBAMMK1NTTC5jb20gRVYgUm9vdCBDZXJ0aWZp +Y2F0aW9uIEF1dGhvcml0eSBFQ0MwHhcNMTYwMjEyMTgxNTIzWhcNNDEwMjEyMTgx +NTIzWjB/MQswCQYDVQQGEwJVUzEOMAwGA1UECAwFVGV4YXMxEDAOBgNVBAcMB0hv +dXN0b24xGDAWBgNVBAoMD1NTTCBDb3Jwb3JhdGlvbjE0MDIGA1UEAwwrU1NMLmNv +bSBFViBSb290IENlcnRpZmljYXRpb24gQXV0aG9yaXR5IEVDQzB2MBAGByqGSM49 +AgEGBSuBBAAiA2IABKoSR5CYG/vvw0AHgyBO8TCCogbR8pKGYfL2IWjKAMTH6kMA +VIbc/R/fALhBYlzccBYy3h+Z1MzFB8gIH2EWB1E9fVwHU+M1OIzfzZ/ZLg1Kthku +WnBaBu2+8KGwytAJKaNjMGEwHQYDVR0OBBYEFFvKXuXe0oGqzagtZFG22XKbl+ZP +MA8GA1UdEwEB/wQFMAMBAf8wHwYDVR0jBBgwFoAUW8pe5d7SgarNqC1kUbbZcpuX +5k8wDgYDVR0PAQH/BAQDAgGGMAoGCCqGSM49BAMCA2gAMGUCMQCK5kCJN+vp1RPZ +ytRrJPOwPYdGWBrssd9v+1a6cGvHOMzosYxPD/fxZ3YOg9AeUY8CMD32IygmTMZg +h5Mmm7I1HrrW9zzRHM76JTymGoEVW/MSD2zuZYrJh6j5B+BimoxcSg== +-----END CERTIFICATE----- + +# Issuer: CN=GlobalSign O=GlobalSign OU=GlobalSign Root CA - R6 +# Subject: CN=GlobalSign O=GlobalSign OU=GlobalSign Root CA - R6 +# Label: "GlobalSign Root CA - R6" +# Serial: 1417766617973444989252670301619537 +# MD5 Fingerprint: 4f:dd:07:e4:d4:22:64:39:1e:0c:37:42:ea:d1:c6:ae +# SHA1 Fingerprint: 80:94:64:0e:b5:a7:a1:ca:11:9c:1f:dd:d5:9f:81:02:63:a7:fb:d1 +# SHA256 Fingerprint: 2c:ab:ea:fe:37:d0:6c:a2:2a:ba:73:91:c0:03:3d:25:98:29:52:c4:53:64:73:49:76:3a:3a:b5:ad:6c:cf:69 +-----BEGIN CERTIFICATE----- +MIIFgzCCA2ugAwIBAgIORea7A4Mzw4VlSOb/RVEwDQYJKoZIhvcNAQEMBQAwTDEg +MB4GA1UECxMXR2xvYmFsU2lnbiBSb290IENBIC0gUjYxEzARBgNVBAoTCkdsb2Jh +bFNpZ24xEzARBgNVBAMTCkdsb2JhbFNpZ24wHhcNMTQxMjEwMDAwMDAwWhcNMzQx +MjEwMDAwMDAwWjBMMSAwHgYDVQQLExdHbG9iYWxTaWduIFJvb3QgQ0EgLSBSNjET +MBEGA1UEChMKR2xvYmFsU2lnbjETMBEGA1UEAxMKR2xvYmFsU2lnbjCCAiIwDQYJ +KoZIhvcNAQEBBQADggIPADCCAgoCggIBAJUH6HPKZvnsFMp7PPcNCPG0RQssgrRI +xutbPK6DuEGSMxSkb3/pKszGsIhrxbaJ0cay/xTOURQh7ErdG1rG1ofuTToVBu1k +ZguSgMpE3nOUTvOniX9PeGMIyBJQbUJmL025eShNUhqKGoC3GYEOfsSKvGRMIRxD +aNc9PIrFsmbVkJq3MQbFvuJtMgamHvm566qjuL++gmNQ0PAYid/kD3n16qIfKtJw +LnvnvJO7bVPiSHyMEAc4/2ayd2F+4OqMPKq0pPbzlUoSB239jLKJz9CgYXfIWHSw +1CM69106yqLbnQneXUQtkPGBzVeS+n68UARjNN9rkxi+azayOeSsJDa38O+2HBNX +k7besvjihbdzorg1qkXy4J02oW9UivFyVm4uiMVRQkQVlO6jxTiWm05OWgtH8wY2 +SXcwvHE35absIQh1/OZhFj931dmRl4QKbNQCTXTAFO39OfuD8l4UoQSwC+n+7o/h +bguyCLNhZglqsQY6ZZZZwPA1/cnaKI0aEYdwgQqomnUdnjqGBQCe24DWJfncBZ4n +WUx2OVvq+aWh2IMP0f/fMBH5hc8zSPXKbWQULHpYT9NLCEnFlWQaYw55PfWzjMpY +rZxCRXluDocZXFSxZba/jJvcE+kNb7gu3GduyYsRtYQUigAZcIN5kZeR1Bonvzce +MgfYFGM8KEyvAgMBAAGjYzBhMA4GA1UdDwEB/wQEAwIBBjAPBgNVHRMBAf8EBTAD +AQH/MB0GA1UdDgQWBBSubAWjkxPioufi1xzWx/B/yGdToDAfBgNVHSMEGDAWgBSu +bAWjkxPioufi1xzWx/B/yGdToDANBgkqhkiG9w0BAQwFAAOCAgEAgyXt6NH9lVLN +nsAEoJFp5lzQhN7craJP6Ed41mWYqVuoPId8AorRbrcWc+ZfwFSY1XS+wc3iEZGt +Ixg93eFyRJa0lV7Ae46ZeBZDE1ZXs6KzO7V33EByrKPrmzU+sQghoefEQzd5Mr61 +55wsTLxDKZmOMNOsIeDjHfrYBzN2VAAiKrlNIC5waNrlU/yDXNOd8v9EDERm8tLj +vUYAGm0CuiVdjaExUd1URhxN25mW7xocBFymFe944Hn+Xds+qkxV/ZoVqW/hpvvf +cDDpw+5CRu3CkwWJ+n1jez/QcYF8AOiYrg54NMMl+68KnyBr3TsTjxKM4kEaSHpz +oHdpx7Zcf4LIHv5YGygrqGytXm3ABdJ7t+uA/iU3/gKbaKxCXcPu9czc8FB10jZp +nOZ7BN9uBmm23goJSFmH63sUYHpkqmlD75HHTOwY3WzvUy2MmeFe8nI+z1TIvWfs +pA9MRf/TuTAjB0yPEL+GltmZWrSZVxykzLsViVO6LAUP5MSeGbEYNNVMnbrt9x+v +JJUEeKgDu+6B5dpffItKoZB0JaezPkvILFa9x8jvOOJckvB595yEunQtYQEgfn7R +8k8HWV+LLUNS60YMlOH1Zkd5d9VUWx+tJDfLRVpOoERIyNiwmcUVhAn21klJwGW4 +5hpxbqCo8YLoRT5s1gLXCmeDBVrJpBA= +-----END CERTIFICATE----- + +# Issuer: CN=OISTE WISeKey Global Root GC CA O=WISeKey OU=OISTE Foundation Endorsed +# Subject: CN=OISTE WISeKey Global Root GC CA O=WISeKey OU=OISTE Foundation Endorsed +# Label: "OISTE WISeKey Global Root GC CA" +# Serial: 44084345621038548146064804565436152554 +# MD5 Fingerprint: a9:d6:b9:2d:2f:93:64:f8:a5:69:ca:91:e9:68:07:23 +# SHA1 Fingerprint: e0:11:84:5e:34:de:be:88:81:b9:9c:f6:16:26:d1:96:1f:c3:b9:31 +# SHA256 Fingerprint: 85:60:f9:1c:36:24:da:ba:95:70:b5:fe:a0:db:e3:6f:f1:1a:83:23:be:94:86:85:4f:b3:f3:4a:55:71:19:8d +-----BEGIN CERTIFICATE----- +MIICaTCCAe+gAwIBAgIQISpWDK7aDKtARb8roi066jAKBggqhkjOPQQDAzBtMQsw +CQYDVQQGEwJDSDEQMA4GA1UEChMHV0lTZUtleTEiMCAGA1UECxMZT0lTVEUgRm91 +bmRhdGlvbiBFbmRvcnNlZDEoMCYGA1UEAxMfT0lTVEUgV0lTZUtleSBHbG9iYWwg +Um9vdCBHQyBDQTAeFw0xNzA1MDkwOTQ4MzRaFw00MjA1MDkwOTU4MzNaMG0xCzAJ +BgNVBAYTAkNIMRAwDgYDVQQKEwdXSVNlS2V5MSIwIAYDVQQLExlPSVNURSBGb3Vu +ZGF0aW9uIEVuZG9yc2VkMSgwJgYDVQQDEx9PSVNURSBXSVNlS2V5IEdsb2JhbCBS +b290IEdDIENBMHYwEAYHKoZIzj0CAQYFK4EEACIDYgAETOlQwMYPchi82PG6s4ni +eUqjFqdrVCTbUf/q9Akkwwsin8tqJ4KBDdLArzHkdIJuyiXZjHWd8dvQmqJLIX4W +p2OQ0jnUsYd4XxiWD1AbNTcPasbc2RNNpI6QN+a9WzGRo1QwUjAOBgNVHQ8BAf8E +BAMCAQYwDwYDVR0TAQH/BAUwAwEB/zAdBgNVHQ4EFgQUSIcUrOPDnpBgOtfKie7T +rYy0UGYwEAYJKwYBBAGCNxUBBAMCAQAwCgYIKoZIzj0EAwMDaAAwZQIwJsdpW9zV +57LnyAyMjMPdeYwbY9XJUpROTYJKcx6ygISpJcBMWm1JKWB4E+J+SOtkAjEA2zQg +Mgj/mkkCtojeFK9dbJlxjRo/i9fgojaGHAeCOnZT/cKi7e97sIBPWA9LUzm9 +-----END CERTIFICATE----- + +# Issuer: CN=UCA Global G2 Root O=UniTrust +# Subject: CN=UCA Global G2 Root O=UniTrust +# Label: "UCA Global G2 Root" +# Serial: 124779693093741543919145257850076631279 +# MD5 Fingerprint: 80:fe:f0:c4:4a:f0:5c:62:32:9f:1c:ba:78:a9:50:f8 +# SHA1 Fingerprint: 28:f9:78:16:19:7a:ff:18:25:18:aa:44:fe:c1:a0:ce:5c:b6:4c:8a +# SHA256 Fingerprint: 9b:ea:11:c9:76:fe:01:47:64:c1:be:56:a6:f9:14:b5:a5:60:31:7a:bd:99:88:39:33:82:e5:16:1a:a0:49:3c +-----BEGIN CERTIFICATE----- +MIIFRjCCAy6gAwIBAgIQXd+x2lqj7V2+WmUgZQOQ7zANBgkqhkiG9w0BAQsFADA9 +MQswCQYDVQQGEwJDTjERMA8GA1UECgwIVW5pVHJ1c3QxGzAZBgNVBAMMElVDQSBH +bG9iYWwgRzIgUm9vdDAeFw0xNjAzMTEwMDAwMDBaFw00MDEyMzEwMDAwMDBaMD0x +CzAJBgNVBAYTAkNOMREwDwYDVQQKDAhVbmlUcnVzdDEbMBkGA1UEAwwSVUNBIEds +b2JhbCBHMiBSb290MIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEAxeYr +b3zvJgUno4Ek2m/LAfmZmqkywiKHYUGRO8vDaBsGxUypK8FnFyIdK+35KYmToni9 +kmugow2ifsqTs6bRjDXVdfkX9s9FxeV67HeToI8jrg4aA3++1NDtLnurRiNb/yzm +VHqUwCoV8MmNsHo7JOHXaOIxPAYzRrZUEaalLyJUKlgNAQLx+hVRZ2zA+te2G3/R +VogvGjqNO7uCEeBHANBSh6v7hn4PJGtAnTRnvI3HLYZveT6OqTwXS3+wmeOwcWDc +C/Vkw85DvG1xudLeJ1uK6NjGruFZfc8oLTW4lVYa8bJYS7cSN8h8s+1LgOGN+jIj +tm+3SJUIsUROhYw6AlQgL9+/V087OpAh18EmNVQg7Mc/R+zvWr9LesGtOxdQXGLY +D0tK3Cv6brxzks3sx1DoQZbXqX5t2Okdj4q1uViSukqSKwxW/YDrCPBeKW4bHAyv +j5OJrdu9o54hyokZ7N+1wxrrFv54NkzWbtA+FxyQF2smuvt6L78RHBgOLXMDj6Dl +NaBa4kx1HXHhOThTeEDMg5PXCp6dW4+K5OXgSORIskfNTip1KnvyIvbJvgmRlld6 +iIis7nCs+dwp4wwcOxJORNanTrAmyPPZGpeRaOrvjUYG0lZFWJo8DA+DuAUlwznP +O6Q0ibd5Ei9Hxeepl2n8pndntd978XplFeRhVmUCAwEAAaNCMEAwDgYDVR0PAQH/ +BAQDAgEGMA8GA1UdEwEB/wQFMAMBAf8wHQYDVR0OBBYEFIHEjMz15DD/pQwIX4wV +ZyF0Ad/fMA0GCSqGSIb3DQEBCwUAA4ICAQATZSL1jiutROTL/7lo5sOASD0Ee/oj +L3rtNtqyzm325p7lX1iPyzcyochltq44PTUbPrw7tgTQvPlJ9Zv3hcU2tsu8+Mg5 +1eRfB70VVJd0ysrtT7q6ZHafgbiERUlMjW+i67HM0cOU2kTC5uLqGOiiHycFutfl +1qnN3e92mI0ADs0b+gO3joBYDic/UvuUospeZcnWhNq5NXHzJsBPd+aBJ9J3O5oU +b3n09tDh05S60FdRvScFDcH9yBIw7m+NESsIndTUv4BFFJqIRNow6rSn4+7vW4LV +PtateJLbXDzz2K36uGt/xDYotgIVilQsnLAXc47QN6MUPJiVAAwpBVueSUmxX8fj +y88nZY41F7dXyDDZQVu5FLbowg+UMaeUmMxq67XhJ/UQqAHojhJi6IjMtX9Gl8Cb +EGY4GjZGXyJoPd/JxhMnq1MGrKI8hgZlb7F+sSlEmqO6SWkoaY/X5V+tBIZkbxqg +DMUIYs6Ao9Dz7GjevjPHF1t/gMRMTLGmhIrDO7gJzRSBuhjjVFc2/tsvfEehOjPI ++Vg7RE+xygKJBJYoaMVLuCaJu9YzL1DV/pqJuhgyklTGW+Cd+V7lDSKb9triyCGy +YiGqhkCyLmTTX8jjfhFnRR8F/uOi77Oos/N9j/gMHyIfLXC0uAE0djAA5SN4p1bX +UB+K+wb1whnw0A== +-----END CERTIFICATE----- + +# Issuer: CN=UCA Extended Validation Root O=UniTrust +# Subject: CN=UCA Extended Validation Root O=UniTrust +# Label: "UCA Extended Validation Root" +# Serial: 106100277556486529736699587978573607008 +# MD5 Fingerprint: a1:f3:5f:43:c6:34:9b:da:bf:8c:7e:05:53:ad:96:e2 +# SHA1 Fingerprint: a3:a1:b0:6f:24:61:23:4a:e3:36:a5:c2:37:fc:a6:ff:dd:f0:d7:3a +# SHA256 Fingerprint: d4:3a:f9:b3:54:73:75:5c:96:84:fc:06:d7:d8:cb:70:ee:5c:28:e7:73:fb:29:4e:b4:1e:e7:17:22:92:4d:24 +-----BEGIN CERTIFICATE----- +MIIFWjCCA0KgAwIBAgIQT9Irj/VkyDOeTzRYZiNwYDANBgkqhkiG9w0BAQsFADBH +MQswCQYDVQQGEwJDTjERMA8GA1UECgwIVW5pVHJ1c3QxJTAjBgNVBAMMHFVDQSBF +eHRlbmRlZCBWYWxpZGF0aW9uIFJvb3QwHhcNMTUwMzEzMDAwMDAwWhcNMzgxMjMx +MDAwMDAwWjBHMQswCQYDVQQGEwJDTjERMA8GA1UECgwIVW5pVHJ1c3QxJTAjBgNV +BAMMHFVDQSBFeHRlbmRlZCBWYWxpZGF0aW9uIFJvb3QwggIiMA0GCSqGSIb3DQEB +AQUAA4ICDwAwggIKAoICAQCpCQcoEwKwmeBkqh5DFnpzsZGgdT6o+uM4AHrsiWog +D4vFsJszA1qGxliG1cGFu0/GnEBNyr7uaZa4rYEwmnySBesFK5pI0Lh2PpbIILvS +sPGP2KxFRv+qZ2C0d35qHzwaUnoEPQc8hQ2E0B92CvdqFN9y4zR8V05WAT558aop +O2z6+I9tTcg1367r3CTueUWnhbYFiN6IXSV8l2RnCdm/WhUFhvMJHuxYMjMR83dk +sHYf5BA1FxvyDrFspCqjc/wJHx4yGVMR59mzLC52LqGj3n5qiAno8geK+LLNEOfi +c0CTuwjRP+H8C5SzJe98ptfRr5//lpr1kXuYC3fUfugH0mK1lTnj8/FtDw5lhIpj +VMWAtuCeS31HJqcBCF3RiJ7XwzJE+oJKCmhUfzhTA8ykADNkUVkLo4KRel7sFsLz +KuZi2irbWWIQJUoqgQtHB0MGcIfS+pMRKXpITeuUx3BNr2fVUbGAIAEBtHoIppB/ +TuDvB0GHr2qlXov7z1CymlSvw4m6WC31MJixNnI5fkkE/SmnTHnkBVfblLkWU41G +sx2VYVdWf6/wFlthWG82UBEL2KwrlRYaDh8IzTY0ZRBiZtWAXxQgXy0MoHgKaNYs +1+lvK9JKBZP8nm9rZ/+I8U6laUpSNwXqxhaN0sSZ0YIrO7o1dfdRUVjzyAfd5LQD +fwIDAQABo0IwQDAdBgNVHQ4EFgQU2XQ65DA9DfcS3H5aBZ8eNJr34RQwDwYDVR0T +AQH/BAUwAwEB/zAOBgNVHQ8BAf8EBAMCAYYwDQYJKoZIhvcNAQELBQADggIBADaN +l8xCFWQpN5smLNb7rhVpLGsaGvdftvkHTFnq88nIua7Mui563MD1sC3AO6+fcAUR +ap8lTwEpcOPlDOHqWnzcSbvBHiqB9RZLcpHIojG5qtr8nR/zXUACE/xOHAbKsxSQ +VBcZEhrxH9cMaVr2cXj0lH2RC47skFSOvG+hTKv8dGT9cZr4QQehzZHkPJrgmzI5 +c6sq1WnIeJEmMX3ixzDx/BR4dxIOE/TdFpS/S2d7cFOFyrC78zhNLJA5wA3CXWvp +4uXViI3WLL+rG761KIcSF3Ru/H38j9CHJrAb+7lsq+KePRXBOy5nAliRn+/4Qh8s +t2j1da3Ptfb/EX3C8CSlrdP6oDyp+l3cpaDvRKS+1ujl5BOWF3sGPjLtx7dCvHaj +2GU4Kzg1USEODm8uNBNA4StnDG1KQTAYI1oyVZnJF+A83vbsea0rWBmirSwiGpWO +vpaQXUJXxPkUAzUrHC1RVwinOt4/5Mi0A3PCwSaAuwtCH60NryZy2sy+s6ODWA2C +xR9GUeOcGMyNm43sSet1UNWMKFnKdDTajAshqx7qG+XH/RU+wBeq+yNuJkbL+vmx +cmtpzyKEC2IPrNkZAJSidjzULZrtBJ4tBmIQN1IchXIbJ+XMxjHsN+xjWZsLHXbM +fjKaiJUINlK73nZfdklJrX+9ZSCyycErdhh2n1ax +-----END CERTIFICATE----- + +# Issuer: CN=Certigna Root CA O=Dhimyotis OU=0002 48146308100036 +# Subject: CN=Certigna Root CA O=Dhimyotis OU=0002 48146308100036 +# Label: "Certigna Root CA" +# Serial: 269714418870597844693661054334862075617 +# MD5 Fingerprint: 0e:5c:30:62:27:eb:5b:bc:d7:ae:62:ba:e9:d5:df:77 +# SHA1 Fingerprint: 2d:0d:52:14:ff:9e:ad:99:24:01:74:20:47:6e:6c:85:27:27:f5:43 +# SHA256 Fingerprint: d4:8d:3d:23:ee:db:50:a4:59:e5:51:97:60:1c:27:77:4b:9d:7b:18:c9:4d:5a:05:95:11:a1:02:50:b9:31:68 +-----BEGIN CERTIFICATE----- +MIIGWzCCBEOgAwIBAgIRAMrpG4nxVQMNo+ZBbcTjpuEwDQYJKoZIhvcNAQELBQAw +WjELMAkGA1UEBhMCRlIxEjAQBgNVBAoMCURoaW15b3RpczEcMBoGA1UECwwTMDAw +MiA0ODE0NjMwODEwMDAzNjEZMBcGA1UEAwwQQ2VydGlnbmEgUm9vdCBDQTAeFw0x +MzEwMDEwODMyMjdaFw0zMzEwMDEwODMyMjdaMFoxCzAJBgNVBAYTAkZSMRIwEAYD +VQQKDAlEaGlteW90aXMxHDAaBgNVBAsMEzAwMDIgNDgxNDYzMDgxMDAwMzYxGTAX +BgNVBAMMEENlcnRpZ25hIFJvb3QgQ0EwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAw +ggIKAoICAQDNGDllGlmx6mQWDoyUJJV8g9PFOSbcDO8WV43X2KyjQn+Cyu3NW9sO +ty3tRQgXstmzy9YXUnIo245Onoq2C/mehJpNdt4iKVzSs9IGPjA5qXSjklYcoW9M +CiBtnyN6tMbaLOQdLNyzKNAT8kxOAkmhVECe5uUFoC2EyP+YbNDrihqECB63aCPu +I9Vwzm1RaRDuoXrC0SIxwoKF0vJVdlB8JXrJhFwLrN1CTivngqIkicuQstDuI7pm +TLtipPlTWmR7fJj6o0ieD5Wupxj0auwuA0Wv8HT4Ks16XdG+RCYyKfHx9WzMfgIh +C59vpD++nVPiz32pLHxYGpfhPTc3GGYo0kDFUYqMwy3OU4gkWGQwFsWq4NYKpkDf +ePb1BHxpE4S80dGnBs8B92jAqFe7OmGtBIyT46388NtEbVncSVmurJqZNjBBe3Yz +IoejwpKGbvlw7q6Hh5UbxHq9MfPU0uWZ/75I7HX1eBYdpnDBfzwboZL7z8g81sWT +Co/1VTp2lc5ZmIoJlXcymoO6LAQ6l73UL77XbJuiyn1tJslV1c/DeVIICZkHJC1k +JWumIWmbat10TWuXekG9qxf5kBdIjzb5LdXF2+6qhUVB+s06RbFo5jZMm5BX7CO5 +hwjCxAnxl4YqKE3idMDaxIzb3+KhF1nOJFl0Mdp//TBt2dzhauH8XwIDAQABo4IB +GjCCARYwDwYDVR0TAQH/BAUwAwEB/zAOBgNVHQ8BAf8EBAMCAQYwHQYDVR0OBBYE +FBiHVuBud+4kNTxOc5of1uHieX4rMB8GA1UdIwQYMBaAFBiHVuBud+4kNTxOc5of +1uHieX4rMEQGA1UdIAQ9MDswOQYEVR0gADAxMC8GCCsGAQUFBwIBFiNodHRwczov +L3d3d3cuY2VydGlnbmEuZnIvYXV0b3JpdGVzLzBtBgNVHR8EZjBkMC+gLaArhilo +dHRwOi8vY3JsLmNlcnRpZ25hLmZyL2NlcnRpZ25hcm9vdGNhLmNybDAxoC+gLYYr +aHR0cDovL2NybC5kaGlteW90aXMuY29tL2NlcnRpZ25hcm9vdGNhLmNybDANBgkq +hkiG9w0BAQsFAAOCAgEAlLieT/DjlQgi581oQfccVdV8AOItOoldaDgvUSILSo3L +6btdPrtcPbEo/uRTVRPPoZAbAh1fZkYJMyjhDSSXcNMQH+pkV5a7XdrnxIxPTGRG +HVyH41neQtGbqH6mid2PHMkwgu07nM3A6RngatgCdTer9zQoKJHyBApPNeNgJgH6 +0BGM+RFq7q89w1DTj18zeTyGqHNFkIwgtnJzFyO+B2XleJINugHA64wcZr+shncB +lA2c5uk5jR+mUYyZDDl34bSb+hxnV29qao6pK0xXeXpXIs/NX2NGjVxZOob4Mkdi +o2cNGJHc+6Zr9UhhcyNZjgKnvETq9Emd8VRY+WCv2hikLyhF3HqgiIZd8zvn/yk1 +gPxkQ5Tm4xxvvq0OKmOZK8l+hfZx6AYDlf7ej0gcWtSS6Cvu5zHbugRqh5jnxV/v +faci9wHYTfmJ0A6aBVmknpjZbyvKcL5kwlWj9Omvw5Ip3IgWJJk8jSaYtlu3zM63 +Nwf9JtmYhST/WSMDmu2dnajkXjjO11INb9I/bbEFa0nOipFGc/T2L/Coc3cOZayh +jWZSaX5LaAzHHjcng6WMxwLkFM1JAbBzs/3GkDpv0mztO+7skb6iQ12LAEpmJURw +3kAP+HwV96LOPNdeE4yBFxgX0b3xdxA61GU5wSesVywlVP+i2k+KYTlerj1KjL0= +-----END CERTIFICATE----- + +# Issuer: CN=emSign Root CA - G1 O=eMudhra Technologies Limited OU=emSign PKI +# Subject: CN=emSign Root CA - G1 O=eMudhra Technologies Limited OU=emSign PKI +# Label: "emSign Root CA - G1" +# Serial: 235931866688319308814040 +# MD5 Fingerprint: 9c:42:84:57:dd:cb:0b:a7:2e:95:ad:b6:f3:da:bc:ac +# SHA1 Fingerprint: 8a:c7:ad:8f:73:ac:4e:c1:b5:75:4d:a5:40:f4:fc:cf:7c:b5:8e:8c +# SHA256 Fingerprint: 40:f6:af:03:46:a9:9a:a1:cd:1d:55:5a:4e:9c:ce:62:c7:f9:63:46:03:ee:40:66:15:83:3d:c8:c8:d0:03:67 +-----BEGIN CERTIFICATE----- +MIIDlDCCAnygAwIBAgIKMfXkYgxsWO3W2DANBgkqhkiG9w0BAQsFADBnMQswCQYD +VQQGEwJJTjETMBEGA1UECxMKZW1TaWduIFBLSTElMCMGA1UEChMcZU11ZGhyYSBU +ZWNobm9sb2dpZXMgTGltaXRlZDEcMBoGA1UEAxMTZW1TaWduIFJvb3QgQ0EgLSBH +MTAeFw0xODAyMTgxODMwMDBaFw00MzAyMTgxODMwMDBaMGcxCzAJBgNVBAYTAklO +MRMwEQYDVQQLEwplbVNpZ24gUEtJMSUwIwYDVQQKExxlTXVkaHJhIFRlY2hub2xv +Z2llcyBMaW1pdGVkMRwwGgYDVQQDExNlbVNpZ24gUm9vdCBDQSAtIEcxMIIBIjAN +BgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAk0u76WaK7p1b1TST0Bsew+eeuGQz +f2N4aLTNLnF115sgxk0pvLZoYIr3IZpWNVrzdr3YzZr/k1ZLpVkGoZM0Kd0WNHVO +8oG0x5ZOrRkVUkr+PHB1cM2vK6sVmjM8qrOLqs1D/fXqcP/tzxE7lM5OMhbTI0Aq +d7OvPAEsbO2ZLIvZTmmYsvePQbAyeGHWDV/D+qJAkh1cF+ZwPjXnorfCYuKrpDhM +tTk1b+oDafo6VGiFbdbyL0NVHpENDtjVaqSW0RM8LHhQ6DqS0hdW5TUaQBw+jSzt +Od9C4INBdN+jzcKGYEho42kLVACL5HZpIQ15TjQIXhTCzLG3rdd8cIrHhQIDAQAB +o0IwQDAdBgNVHQ4EFgQU++8Nhp6w492pufEhF38+/PB3KxowDgYDVR0PAQH/BAQD +AgEGMA8GA1UdEwEB/wQFMAMBAf8wDQYJKoZIhvcNAQELBQADggEBAFn/8oz1h31x +PaOfG1vR2vjTnGs2vZupYeveFix0PZ7mddrXuqe8QhfnPZHr5X3dPpzxz5KsbEjM +wiI/aTvFthUvozXGaCocV685743QNcMYDHsAVhzNixl03r4PEuDQqqE/AjSxcM6d +GNYIAwlG7mDgfrbESQRRfXBgvKqy/3lyeqYdPV8q+Mri/Tm3R7nrft8EI6/6nAYH +6ftjk4BAtcZsCjEozgyfz7MjNYBBjWzEN3uBL4ChQEKF6dk4jeihU80Bv2noWgby +RQuQ+q7hv53yrlc8pa6yVvSLZUDp/TGBLPQ5Cdjua6e0ph0VpZj3AYHYhX3zUVxx +iN66zB+Afko= +-----END CERTIFICATE----- + +# Issuer: CN=emSign ECC Root CA - G3 O=eMudhra Technologies Limited OU=emSign PKI +# Subject: CN=emSign ECC Root CA - G3 O=eMudhra Technologies Limited OU=emSign PKI +# Label: "emSign ECC Root CA - G3" +# Serial: 287880440101571086945156 +# MD5 Fingerprint: ce:0b:72:d1:9f:88:8e:d0:50:03:e8:e3:b8:8b:67:40 +# SHA1 Fingerprint: 30:43:fa:4f:f2:57:dc:a0:c3:80:ee:2e:58:ea:78:b2:3f:e6:bb:c1 +# SHA256 Fingerprint: 86:a1:ec:ba:08:9c:4a:8d:3b:be:27:34:c6:12:ba:34:1d:81:3e:04:3c:f9:e8:a8:62:cd:5c:57:a3:6b:be:6b +-----BEGIN CERTIFICATE----- +MIICTjCCAdOgAwIBAgIKPPYHqWhwDtqLhDAKBggqhkjOPQQDAzBrMQswCQYDVQQG +EwJJTjETMBEGA1UECxMKZW1TaWduIFBLSTElMCMGA1UEChMcZU11ZGhyYSBUZWNo +bm9sb2dpZXMgTGltaXRlZDEgMB4GA1UEAxMXZW1TaWduIEVDQyBSb290IENBIC0g +RzMwHhcNMTgwMjE4MTgzMDAwWhcNNDMwMjE4MTgzMDAwWjBrMQswCQYDVQQGEwJJ +TjETMBEGA1UECxMKZW1TaWduIFBLSTElMCMGA1UEChMcZU11ZGhyYSBUZWNobm9s +b2dpZXMgTGltaXRlZDEgMB4GA1UEAxMXZW1TaWduIEVDQyBSb290IENBIC0gRzMw +djAQBgcqhkjOPQIBBgUrgQQAIgNiAAQjpQy4LRL1KPOxst3iAhKAnjlfSU2fySU0 +WXTsuwYc58Byr+iuL+FBVIcUqEqy6HyC5ltqtdyzdc6LBtCGI79G1Y4PPwT01xyS +fvalY8L1X44uT6EYGQIrMgqCZH0Wk9GjQjBAMB0GA1UdDgQWBBR8XQKEE9TMipuB +zhccLikenEhjQjAOBgNVHQ8BAf8EBAMCAQYwDwYDVR0TAQH/BAUwAwEB/zAKBggq +hkjOPQQDAwNpADBmAjEAvvNhzwIQHWSVB7gYboiFBS+DCBeQyh+KTOgNG3qxrdWB +CUfvO6wIBHxcmbHtRwfSAjEAnbpV/KlK6O3t5nYBQnvI+GDZjVGLVTv7jHvrZQnD ++JbNR6iC8hZVdyR+EhCVBCyj +-----END CERTIFICATE----- + +# Issuer: CN=emSign Root CA - C1 O=eMudhra Inc OU=emSign PKI +# Subject: CN=emSign Root CA - C1 O=eMudhra Inc OU=emSign PKI +# Label: "emSign Root CA - C1" +# Serial: 825510296613316004955058 +# MD5 Fingerprint: d8:e3:5d:01:21:fa:78:5a:b0:df:ba:d2:ee:2a:5f:68 +# SHA1 Fingerprint: e7:2e:f1:df:fc:b2:09:28:cf:5d:d4:d5:67:37:b1:51:cb:86:4f:01 +# SHA256 Fingerprint: 12:56:09:aa:30:1d:a0:a2:49:b9:7a:82:39:cb:6a:34:21:6f:44:dc:ac:9f:39:54:b1:42:92:f2:e8:c8:60:8f +-----BEGIN CERTIFICATE----- +MIIDczCCAlugAwIBAgILAK7PALrEzzL4Q7IwDQYJKoZIhvcNAQELBQAwVjELMAkG +A1UEBhMCVVMxEzARBgNVBAsTCmVtU2lnbiBQS0kxFDASBgNVBAoTC2VNdWRocmEg +SW5jMRwwGgYDVQQDExNlbVNpZ24gUm9vdCBDQSAtIEMxMB4XDTE4MDIxODE4MzAw +MFoXDTQzMDIxODE4MzAwMFowVjELMAkGA1UEBhMCVVMxEzARBgNVBAsTCmVtU2ln +biBQS0kxFDASBgNVBAoTC2VNdWRocmEgSW5jMRwwGgYDVQQDExNlbVNpZ24gUm9v +dCBDQSAtIEMxMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAz+upufGZ +BczYKCFK83M0UYRWEPWgTywS4/oTmifQz/l5GnRfHXk5/Fv4cI7gklL35CX5VIPZ +HdPIWoU/Xse2B+4+wM6ar6xWQio5JXDWv7V7Nq2s9nPczdcdioOl+yuQFTdrHCZH +3DspVpNqs8FqOp099cGXOFgFixwR4+S0uF2FHYP+eF8LRWgYSKVGczQ7/g/IdrvH +GPMF0Ybzhe3nudkyrVWIzqa2kbBPrH4VI5b2P/AgNBbeCsbEBEV5f6f9vtKppa+c +xSMq9zwhbL2vj07FOrLzNBL834AaSaTUqZX3noleoomslMuoaJuvimUnzYnu3Yy1 +aylwQ6BpC+S5DwIDAQABo0IwQDAdBgNVHQ4EFgQU/qHgcB4qAzlSWkK+XJGFehiq +TbUwDgYDVR0PAQH/BAQDAgEGMA8GA1UdEwEB/wQFMAMBAf8wDQYJKoZIhvcNAQEL +BQADggEBAMJKVvoVIXsoounlHfv4LcQ5lkFMOycsxGwYFYDGrK9HWS8mC+M2sO87 +/kOXSTKZEhVb3xEp/6tT+LvBeA+snFOvV71ojD1pM/CjoCNjO2RnIkSt1XHLVip4 +kqNPEjE2NuLe/gDEo2APJ62gsIq1NnpSob0n9CAnYuhNlCQT5AoE6TyrLshDCUrG +YQTlSTR+08TI9Q/Aqum6VF7zYytPT1DU/rl7mYw9wC68AivTxEDkigcxHpvOJpkT ++xHqmiIMERnHXhuBUDDIlhJu58tBf5E7oke3VIAb3ADMmpDqw8NQBmIMMMAVSKeo +WXzhriKi4gp6D/piq1JM4fHfyr6DDUI= +-----END CERTIFICATE----- + +# Issuer: CN=emSign ECC Root CA - C3 O=eMudhra Inc OU=emSign PKI +# Subject: CN=emSign ECC Root CA - C3 O=eMudhra Inc OU=emSign PKI +# Label: "emSign ECC Root CA - C3" +# Serial: 582948710642506000014504 +# MD5 Fingerprint: 3e:53:b3:a3:81:ee:d7:10:f8:d3:b0:1d:17:92:f5:d5 +# SHA1 Fingerprint: b6:af:43:c2:9b:81:53:7d:f6:ef:6b:c3:1f:1f:60:15:0c:ee:48:66 +# SHA256 Fingerprint: bc:4d:80:9b:15:18:9d:78:db:3e:1d:8c:f4:f9:72:6a:79:5d:a1:64:3c:a5:f1:35:8e:1d:db:0e:dc:0d:7e:b3 +-----BEGIN CERTIFICATE----- +MIICKzCCAbGgAwIBAgIKe3G2gla4EnycqDAKBggqhkjOPQQDAzBaMQswCQYDVQQG +EwJVUzETMBEGA1UECxMKZW1TaWduIFBLSTEUMBIGA1UEChMLZU11ZGhyYSBJbmMx +IDAeBgNVBAMTF2VtU2lnbiBFQ0MgUm9vdCBDQSAtIEMzMB4XDTE4MDIxODE4MzAw +MFoXDTQzMDIxODE4MzAwMFowWjELMAkGA1UEBhMCVVMxEzARBgNVBAsTCmVtU2ln +biBQS0kxFDASBgNVBAoTC2VNdWRocmEgSW5jMSAwHgYDVQQDExdlbVNpZ24gRUND +IFJvb3QgQ0EgLSBDMzB2MBAGByqGSM49AgEGBSuBBAAiA2IABP2lYa57JhAd6bci +MK4G9IGzsUJxlTm801Ljr6/58pc1kjZGDoeVjbk5Wum739D+yAdBPLtVb4Ojavti +sIGJAnB9SMVK4+kiVCJNk7tCDK93nCOmfddhEc5lx/h//vXyqaNCMEAwHQYDVR0O +BBYEFPtaSNCAIEDyqOkAB2kZd6fmw/TPMA4GA1UdDwEB/wQEAwIBBjAPBgNVHRMB +Af8EBTADAQH/MAoGCCqGSM49BAMDA2gAMGUCMQC02C8Cif22TGK6Q04ThHK1rt0c +3ta13FaPWEBaLd4gTCKDypOofu4SQMfWh0/434UCMBwUZOR8loMRnLDRWmFLpg9J +0wD8ofzkpf9/rdcw0Md3f76BB1UwUCAU9Vc4CqgxUQ== +-----END CERTIFICATE----- + +# Issuer: CN=Hongkong Post Root CA 3 O=Hongkong Post +# Subject: CN=Hongkong Post Root CA 3 O=Hongkong Post +# Label: "Hongkong Post Root CA 3" +# Serial: 46170865288971385588281144162979347873371282084 +# MD5 Fingerprint: 11:fc:9f:bd:73:30:02:8a:fd:3f:f3:58:b9:cb:20:f0 +# SHA1 Fingerprint: 58:a2:d0:ec:20:52:81:5b:c1:f3:f8:64:02:24:4e:c2:8e:02:4b:02 +# SHA256 Fingerprint: 5a:2f:c0:3f:0c:83:b0:90:bb:fa:40:60:4b:09:88:44:6c:76:36:18:3d:f9:84:6e:17:10:1a:44:7f:b8:ef:d6 +-----BEGIN CERTIFICATE----- +MIIFzzCCA7egAwIBAgIUCBZfikyl7ADJk0DfxMauI7gcWqQwDQYJKoZIhvcNAQEL +BQAwbzELMAkGA1UEBhMCSEsxEjAQBgNVBAgTCUhvbmcgS29uZzESMBAGA1UEBxMJ +SG9uZyBLb25nMRYwFAYDVQQKEw1Ib25na29uZyBQb3N0MSAwHgYDVQQDExdIb25n +a29uZyBQb3N0IFJvb3QgQ0EgMzAeFw0xNzA2MDMwMjI5NDZaFw00MjA2MDMwMjI5 +NDZaMG8xCzAJBgNVBAYTAkhLMRIwEAYDVQQIEwlIb25nIEtvbmcxEjAQBgNVBAcT +CUhvbmcgS29uZzEWMBQGA1UEChMNSG9uZ2tvbmcgUG9zdDEgMB4GA1UEAxMXSG9u +Z2tvbmcgUG9zdCBSb290IENBIDMwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIK +AoICAQCziNfqzg8gTr7m1gNt7ln8wlffKWihgw4+aMdoWJwcYEuJQwy51BWy7sFO +dem1p+/l6TWZ5Mwc50tfjTMwIDNT2aa71T4Tjukfh0mtUC1Qyhi+AViiE3CWu4mI +VoBc+L0sPOFMV4i707mV78vH9toxdCim5lSJ9UExyuUmGs2C4HDaOym71QP1mbpV +9WTRYA6ziUm4ii8F0oRFKHyPaFASePwLtVPLwpgchKOesL4jpNrcyCse2m5FHomY +2vkALgbpDDtw1VAliJnLzXNg99X/NWfFobxeq81KuEXryGgeDQ0URhLj0mRiikKY +vLTGCAj4/ahMZJx2Ab0vqWwzD9g/KLg8aQFChn5pwckGyuV6RmXpwtZQQS4/t+Tt +bNe/JgERohYpSms0BpDsE9K2+2p20jzt8NYt3eEV7KObLyzJPivkaTv/ciWxNoZb +x39ri1UbSsUgYT2uy1DhCDq+sI9jQVMwCFk8mB13umOResoQUGC/8Ne8lYePl8X+ +l2oBlKN8W4UdKjk60FSh0Tlxnf0h+bV78OLgAo9uliQlLKAeLKjEiafv7ZkGL7YK +TE/bosw3Gq9HhS2KX8Q0NEwA/RiTZxPRN+ZItIsGxVd7GYYKecsAyVKvQv83j+Gj +Hno9UKtjBucVtT+2RTeUN7F+8kjDf8V1/peNRY8apxpyKBpADwIDAQABo2MwYTAP +BgNVHRMBAf8EBTADAQH/MA4GA1UdDwEB/wQEAwIBBjAfBgNVHSMEGDAWgBQXnc0e +i9Y5K3DTXNSguB+wAPzFYTAdBgNVHQ4EFgQUF53NHovWOStw01zUoLgfsAD8xWEw +DQYJKoZIhvcNAQELBQADggIBAFbVe27mIgHSQpsY1Q7XZiNc4/6gx5LS6ZStS6LG +7BJ8dNVI0lkUmcDrudHr9EgwW62nV3OZqdPlt9EuWSRY3GguLmLYauRwCy0gUCCk +MpXRAJi70/33MvJJrsZ64Ee+bs7Lo3I6LWldy8joRTnU+kLBEUx3XZL7av9YROXr +gZ6voJmtvqkBZss4HTzfQx/0TW60uhdG/H39h4F5ag0zD/ov+BS5gLNdTaqX4fnk +GMX41TiMJjz98iji7lpJiCzfeT2OnpA8vUFKOt1b9pq0zj8lMH8yfaIDlNDceqFS +3m6TjRgm/VWsvY+b0s+v54Ysyx8Jb6NvqYTUc79NoXQbTiNg8swOqn+knEwlqLJm +Ozj/2ZQw9nKEvmhVEA/GcywWaZMH/rFF7buiVWqw2rVKAiUnhde3t4ZEFolsgCs+ +l6mc1X5VTMbeRRAc6uk7nwNT7u56AQIWeNTowr5GdogTPyK7SBIdUgC0An4hGh6c +JfTzPV4e0hz5sy229zdcxsshTrD3mUcYhcErulWuBurQB7Lcq9CClnXO0lD+mefP +L5/ndtFhKvshuzHQqp9HpLIiyhY6UFfEW0NnxWViA0kB60PZ2Pierc+xYw5F9KBa +LJstxabArahH9CdMOA0uG0k7UvToiIMrVCjU8jVStDKDYmlkDJGcn5fqdBb9HxEG +mpv0 +-----END CERTIFICATE----- + +# Issuer: CN=Entrust Root Certification Authority - G4 O=Entrust, Inc. OU=See www.entrust.net/legal-terms/(c) 2015 Entrust, Inc. - for authorized use only +# Subject: CN=Entrust Root Certification Authority - G4 O=Entrust, Inc. OU=See www.entrust.net/legal-terms/(c) 2015 Entrust, Inc. - for authorized use only +# Label: "Entrust Root Certification Authority - G4" +# Serial: 289383649854506086828220374796556676440 +# MD5 Fingerprint: 89:53:f1:83:23:b7:7c:8e:05:f1:8c:71:38:4e:1f:88 +# SHA1 Fingerprint: 14:88:4e:86:26:37:b0:26:af:59:62:5c:40:77:ec:35:29:ba:96:01 +# SHA256 Fingerprint: db:35:17:d1:f6:73:2a:2d:5a:b9:7c:53:3e:c7:07:79:ee:32:70:a6:2f:b4:ac:42:38:37:24:60:e6:f0:1e:88 +-----BEGIN CERTIFICATE----- +MIIGSzCCBDOgAwIBAgIRANm1Q3+vqTkPAAAAAFVlrVgwDQYJKoZIhvcNAQELBQAw +gb4xCzAJBgNVBAYTAlVTMRYwFAYDVQQKEw1FbnRydXN0LCBJbmMuMSgwJgYDVQQL +Ex9TZWUgd3d3LmVudHJ1c3QubmV0L2xlZ2FsLXRlcm1zMTkwNwYDVQQLEzAoYykg +MjAxNSBFbnRydXN0LCBJbmMuIC0gZm9yIGF1dGhvcml6ZWQgdXNlIG9ubHkxMjAw +BgNVBAMTKUVudHJ1c3QgUm9vdCBDZXJ0aWZpY2F0aW9uIEF1dGhvcml0eSAtIEc0 +MB4XDTE1MDUyNzExMTExNloXDTM3MTIyNzExNDExNlowgb4xCzAJBgNVBAYTAlVT +MRYwFAYDVQQKEw1FbnRydXN0LCBJbmMuMSgwJgYDVQQLEx9TZWUgd3d3LmVudHJ1 +c3QubmV0L2xlZ2FsLXRlcm1zMTkwNwYDVQQLEzAoYykgMjAxNSBFbnRydXN0LCBJ +bmMuIC0gZm9yIGF1dGhvcml6ZWQgdXNlIG9ubHkxMjAwBgNVBAMTKUVudHJ1c3Qg +Um9vdCBDZXJ0aWZpY2F0aW9uIEF1dGhvcml0eSAtIEc0MIICIjANBgkqhkiG9w0B +AQEFAAOCAg8AMIICCgKCAgEAsewsQu7i0TD/pZJH4i3DumSXbcr3DbVZwbPLqGgZ +2K+EbTBwXX7zLtJTmeH+H17ZSK9dE43b/2MzTdMAArzE+NEGCJR5WIoV3imz/f3E +T+iq4qA7ec2/a0My3dl0ELn39GjUu9CH1apLiipvKgS1sqbHoHrmSKvS0VnM1n4j +5pds8ELl3FFLFUHtSUrJ3hCX1nbB76W1NhSXNdh4IjVS70O92yfbYVaCNNzLiGAM +C1rlLAHGVK/XqsEQe9IFWrhAnoanw5CGAlZSCXqc0ieCU0plUmr1POeo8pyvi73T +DtTUXm6Hnmo9RR3RXRv06QqsYJn7ibT/mCzPfB3pAqoEmh643IhuJbNsZvc8kPNX +wbMv9W3y+8qh+CmdRouzavbmZwe+LGcKKh9asj5XxNMhIWNlUpEbsZmOeX7m640A +2Vqq6nPopIICR5b+W45UYaPrL0swsIsjdXJ8ITzI9vF01Bx7owVV7rtNOzK+mndm +nqxpkCIHH2E6lr7lmk/MBTwoWdPBDFSoWWG9yHJM6Nyfh3+9nEg2XpWjDrk4JFX8 +dWbrAuMINClKxuMrLzOg2qOGpRKX/YAr2hRC45K9PvJdXmd0LhyIRyk0X+IyqJwl +N4y6mACXi0mWHv0liqzc2thddG5msP9E36EYxr5ILzeUePiVSj9/E15dWf10hkNj +c0kCAwEAAaNCMEAwDwYDVR0TAQH/BAUwAwEB/zAOBgNVHQ8BAf8EBAMCAQYwHQYD +VR0OBBYEFJ84xFYjwznooHFs6FRM5Og6sb9nMA0GCSqGSIb3DQEBCwUAA4ICAQAS +5UKme4sPDORGpbZgQIeMJX6tuGguW8ZAdjwD+MlZ9POrYs4QjbRaZIxowLByQzTS +Gwv2LFPSypBLhmb8qoMi9IsabyZIrHZ3CL/FmFz0Jomee8O5ZDIBf9PD3Vht7LGr +hFV0d4QEJ1JrhkzO3bll/9bGXp+aEJlLdWr+aumXIOTkdnrG0CSqkM0gkLpHZPt/ +B7NTeLUKYvJzQ85BK4FqLoUWlFPUa19yIqtRLULVAJyZv967lDtX/Zr1hstWO1uI +AeV8KEsD+UmDfLJ/fOPtjqF/YFOOVZ1QNBIPt5d7bIdKROf1beyAN/BYGW5KaHbw +H5Lk6rWS02FREAutp9lfx1/cH6NcjKF+m7ee01ZvZl4HliDtC3T7Zk6LERXpgUl+ +b7DUUH8i119lAg2m9IUe2K4GS0qn0jFmwvjO5QimpAKWRGhXxNUzzxkvFMSUHHuk +2fCfDrGA4tGeEWSpiBE6doLlYsKA2KSD7ZPvfC+QsDJMlhVoSFLUmQjAJOgc47Ol +IQ6SwJAfzyBfyjs4x7dtOvPmRLgOMWuIjnDrnBdSqEGULoe256YSxXXfW8AKbnuk +5F6G+TaU33fD6Q3AOfF5u0aOq0NZJ7cguyPpVkAh7DE9ZapD8j3fcEThuk0mEDuY +n/PIjhs4ViFqUZPTkcpG2om3PVODLAgfi49T3f+sHw== +-----END CERTIFICATE----- + +# Issuer: CN=Microsoft ECC Root Certificate Authority 2017 O=Microsoft Corporation +# Subject: CN=Microsoft ECC Root Certificate Authority 2017 O=Microsoft Corporation +# Label: "Microsoft ECC Root Certificate Authority 2017" +# Serial: 136839042543790627607696632466672567020 +# MD5 Fingerprint: dd:a1:03:e6:4a:93:10:d1:bf:f0:19:42:cb:fe:ed:67 +# SHA1 Fingerprint: 99:9a:64:c3:7f:f4:7d:9f:ab:95:f1:47:69:89:14:60:ee:c4:c3:c5 +# SHA256 Fingerprint: 35:8d:f3:9d:76:4a:f9:e1:b7:66:e9:c9:72:df:35:2e:e1:5c:fa:c2:27:af:6a:d1:d7:0e:8e:4a:6e:dc:ba:02 +-----BEGIN CERTIFICATE----- +MIICWTCCAd+gAwIBAgIQZvI9r4fei7FK6gxXMQHC7DAKBggqhkjOPQQDAzBlMQsw +CQYDVQQGEwJVUzEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMTYwNAYD +VQQDEy1NaWNyb3NvZnQgRUNDIFJvb3QgQ2VydGlmaWNhdGUgQXV0aG9yaXR5IDIw +MTcwHhcNMTkxMjE4MjMwNjQ1WhcNNDIwNzE4MjMxNjA0WjBlMQswCQYDVQQGEwJV +UzEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMTYwNAYDVQQDEy1NaWNy +b3NvZnQgRUNDIFJvb3QgQ2VydGlmaWNhdGUgQXV0aG9yaXR5IDIwMTcwdjAQBgcq +hkjOPQIBBgUrgQQAIgNiAATUvD0CQnVBEyPNgASGAlEvaqiBYgtlzPbKnR5vSmZR +ogPZnZH6thaxjG7efM3beaYvzrvOcS/lpaso7GMEZpn4+vKTEAXhgShC48Zo9OYb +hGBKia/teQ87zvH2RPUBeMCjVDBSMA4GA1UdDwEB/wQEAwIBhjAPBgNVHRMBAf8E +BTADAQH/MB0GA1UdDgQWBBTIy5lycFIM+Oa+sgRXKSrPQhDtNTAQBgkrBgEEAYI3 +FQEEAwIBADAKBggqhkjOPQQDAwNoADBlAjBY8k3qDPlfXu5gKcs68tvWMoQZP3zV +L8KxzJOuULsJMsbG7X7JNpQS5GiFBqIb0C8CMQCZ6Ra0DvpWSNSkMBaReNtUjGUB +iudQZsIxtzm6uBoiB078a1QWIP8rtedMDE2mT3M= +-----END CERTIFICATE----- + +# Issuer: CN=Microsoft RSA Root Certificate Authority 2017 O=Microsoft Corporation +# Subject: CN=Microsoft RSA Root Certificate Authority 2017 O=Microsoft Corporation +# Label: "Microsoft RSA Root Certificate Authority 2017" +# Serial: 40975477897264996090493496164228220339 +# MD5 Fingerprint: 10:ff:00:ff:cf:c9:f8:c7:7a:c0:ee:35:8e:c9:0f:47 +# SHA1 Fingerprint: 73:a5:e6:4a:3b:ff:83:16:ff:0e:dc:cc:61:8a:90:6e:4e:ae:4d:74 +# SHA256 Fingerprint: c7:41:f7:0f:4b:2a:8d:88:bf:2e:71:c1:41:22:ef:53:ef:10:eb:a0:cf:a5:e6:4c:fa:20:f4:18:85:30:73:e0 +-----BEGIN CERTIFICATE----- +MIIFqDCCA5CgAwIBAgIQHtOXCV/YtLNHcB6qvn9FszANBgkqhkiG9w0BAQwFADBl +MQswCQYDVQQGEwJVUzEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMTYw +NAYDVQQDEy1NaWNyb3NvZnQgUlNBIFJvb3QgQ2VydGlmaWNhdGUgQXV0aG9yaXR5 +IDIwMTcwHhcNMTkxMjE4MjI1MTIyWhcNNDIwNzE4MjMwMDIzWjBlMQswCQYDVQQG +EwJVUzEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMTYwNAYDVQQDEy1N +aWNyb3NvZnQgUlNBIFJvb3QgQ2VydGlmaWNhdGUgQXV0aG9yaXR5IDIwMTcwggIi +MA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQDKW76UM4wplZEWCpW9R2LBifOZ +Nt9GkMml7Xhqb0eRaPgnZ1AzHaGm++DlQ6OEAlcBXZxIQIJTELy/xztokLaCLeX0 +ZdDMbRnMlfl7rEqUrQ7eS0MdhweSE5CAg2Q1OQT85elss7YfUJQ4ZVBcF0a5toW1 +HLUX6NZFndiyJrDKxHBKrmCk3bPZ7Pw71VdyvD/IybLeS2v4I2wDwAW9lcfNcztm +gGTjGqwu+UcF8ga2m3P1eDNbx6H7JyqhtJqRjJHTOoI+dkC0zVJhUXAoP8XFWvLJ +jEm7FFtNyP9nTUwSlq31/niol4fX/V4ggNyhSyL71Imtus5Hl0dVe49FyGcohJUc +aDDv70ngNXtk55iwlNpNhTs+VcQor1fznhPbRiefHqJeRIOkpcrVE7NLP8TjwuaG +YaRSMLl6IE9vDzhTyzMMEyuP1pq9KsgtsRx9S1HKR9FIJ3Jdh+vVReZIZZ2vUpC6 +W6IYZVcSn2i51BVrlMRpIpj0M+Dt+VGOQVDJNE92kKz8OMHY4Xu54+OU4UZpyw4K +UGsTuqwPN1q3ErWQgR5WrlcihtnJ0tHXUeOrO8ZV/R4O03QK0dqq6mm4lyiPSMQH ++FJDOvTKVTUssKZqwJz58oHhEmrARdlns87/I6KJClTUFLkqqNfs+avNJVgyeY+Q +W5g5xAgGwax/Dj0ApQIDAQABo1QwUjAOBgNVHQ8BAf8EBAMCAYYwDwYDVR0TAQH/ +BAUwAwEB/zAdBgNVHQ4EFgQUCctZf4aycI8awznjwNnpv7tNsiMwEAYJKwYBBAGC +NxUBBAMCAQAwDQYJKoZIhvcNAQEMBQADggIBAKyvPl3CEZaJjqPnktaXFbgToqZC +LgLNFgVZJ8og6Lq46BrsTaiXVq5lQ7GPAJtSzVXNUzltYkyLDVt8LkS/gxCP81OC +gMNPOsduET/m4xaRhPtthH80dK2Jp86519efhGSSvpWhrQlTM93uCupKUY5vVau6 +tZRGrox/2KJQJWVggEbbMwSubLWYdFQl3JPk+ONVFT24bcMKpBLBaYVu32TxU5nh +SnUgnZUP5NbcA/FZGOhHibJXWpS2qdgXKxdJ5XbLwVaZOjex/2kskZGT4d9Mozd2 +TaGf+G0eHdP67Pv0RR0Tbc/3WeUiJ3IrhvNXuzDtJE3cfVa7o7P4NHmJweDyAmH3 +pvwPuxwXC65B2Xy9J6P9LjrRk5Sxcx0ki69bIImtt2dmefU6xqaWM/5TkshGsRGR +xpl/j8nWZjEgQRCHLQzWwa80mMpkg/sTV9HB8Dx6jKXB/ZUhoHHBk2dxEuqPiApp +GWSZI1b7rCoucL5mxAyE7+WL85MB+GqQk2dLsmijtWKP6T+MejteD+eMuMZ87zf9 +dOLITzNy4ZQ5bb0Sr74MTnB8G2+NszKTc0QWbej09+CVgI+WXTik9KveCjCHk9hN +AHFiRSdLOkKEW39lt2c0Ui2cFmuqqNh7o0JMcccMyj6D5KbvtwEwXlGjefVwaaZB +RA+GsCyRxj3qrg+E +-----END CERTIFICATE----- + +# Issuer: CN=e-Szigno Root CA 2017 O=Microsec Ltd. +# Subject: CN=e-Szigno Root CA 2017 O=Microsec Ltd. +# Label: "e-Szigno Root CA 2017" +# Serial: 411379200276854331539784714 +# MD5 Fingerprint: de:1f:f6:9e:84:ae:a7:b4:21:ce:1e:58:7d:d1:84:98 +# SHA1 Fingerprint: 89:d4:83:03:4f:9e:9a:48:80:5f:72:37:d4:a9:a6:ef:cb:7c:1f:d1 +# SHA256 Fingerprint: be:b0:0b:30:83:9b:9b:c3:2c:32:e4:44:79:05:95:06:41:f2:64:21:b1:5e:d0:89:19:8b:51:8a:e2:ea:1b:99 +-----BEGIN CERTIFICATE----- +MIICQDCCAeWgAwIBAgIMAVRI7yH9l1kN9QQKMAoGCCqGSM49BAMCMHExCzAJBgNV +BAYTAkhVMREwDwYDVQQHDAhCdWRhcGVzdDEWMBQGA1UECgwNTWljcm9zZWMgTHRk +LjEXMBUGA1UEYQwOVkFUSFUtMjM1ODQ0OTcxHjAcBgNVBAMMFWUtU3ppZ25vIFJv +b3QgQ0EgMjAxNzAeFw0xNzA4MjIxMjA3MDZaFw00MjA4MjIxMjA3MDZaMHExCzAJ +BgNVBAYTAkhVMREwDwYDVQQHDAhCdWRhcGVzdDEWMBQGA1UECgwNTWljcm9zZWMg +THRkLjEXMBUGA1UEYQwOVkFUSFUtMjM1ODQ0OTcxHjAcBgNVBAMMFWUtU3ppZ25v +IFJvb3QgQ0EgMjAxNzBZMBMGByqGSM49AgEGCCqGSM49AwEHA0IABJbcPYrYsHtv +xie+RJCxs1YVe45DJH0ahFnuY2iyxl6H0BVIHqiQrb1TotreOpCmYF9oMrWGQd+H +Wyx7xf58etqjYzBhMA8GA1UdEwEB/wQFMAMBAf8wDgYDVR0PAQH/BAQDAgEGMB0G +A1UdDgQWBBSHERUI0arBeAyxr87GyZDvvzAEwDAfBgNVHSMEGDAWgBSHERUI0arB +eAyxr87GyZDvvzAEwDAKBggqhkjOPQQDAgNJADBGAiEAtVfd14pVCzbhhkT61Nlo +jbjcI4qKDdQvfepz7L9NbKgCIQDLpbQS+ue16M9+k/zzNY9vTlp8tLxOsvxyqltZ ++efcMQ== +-----END CERTIFICATE----- + +# Issuer: O=CERTSIGN SA OU=certSIGN ROOT CA G2 +# Subject: O=CERTSIGN SA OU=certSIGN ROOT CA G2 +# Label: "certSIGN Root CA G2" +# Serial: 313609486401300475190 +# MD5 Fingerprint: 8c:f1:75:8a:c6:19:cf:94:b7:f7:65:20:87:c3:97:c7 +# SHA1 Fingerprint: 26:f9:93:b4:ed:3d:28:27:b0:b9:4b:a7:e9:15:1d:a3:8d:92:e5:32 +# SHA256 Fingerprint: 65:7c:fe:2f:a7:3f:aa:38:46:25:71:f3:32:a2:36:3a:46:fc:e7:02:09:51:71:07:02:cd:fb:b6:ee:da:33:05 +-----BEGIN CERTIFICATE----- +MIIFRzCCAy+gAwIBAgIJEQA0tk7GNi02MA0GCSqGSIb3DQEBCwUAMEExCzAJBgNV +BAYTAlJPMRQwEgYDVQQKEwtDRVJUU0lHTiBTQTEcMBoGA1UECxMTY2VydFNJR04g +Uk9PVCBDQSBHMjAeFw0xNzAyMDYwOTI3MzVaFw00MjAyMDYwOTI3MzVaMEExCzAJ +BgNVBAYTAlJPMRQwEgYDVQQKEwtDRVJUU0lHTiBTQTEcMBoGA1UECxMTY2VydFNJ +R04gUk9PVCBDQSBHMjCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBAMDF +dRmRfUR0dIf+DjuW3NgBFszuY5HnC2/OOwppGnzC46+CjobXXo9X69MhWf05N0Iw +vlDqtg+piNguLWkh59E3GE59kdUWX2tbAMI5Qw02hVK5U2UPHULlj88F0+7cDBrZ +uIt4ImfkabBoxTzkbFpG583H+u/E7Eu9aqSs/cwoUe+StCmrqzWaTOTECMYmzPhp +n+Sc8CnTXPnGFiWeI8MgwT0PPzhAsP6CRDiqWhqKa2NYOLQV07YRaXseVO6MGiKs +cpc/I1mbySKEwQdPzH/iV8oScLumZfNpdWO9lfsbl83kqK/20U6o2YpxJM02PbyW +xPFsqa7lzw1uKA2wDrXKUXt4FMMgL3/7FFXhEZn91QqhngLjYl/rNUssuHLoPj1P +rCy7Lobio3aP5ZMqz6WryFyNSwb/EkaseMsUBzXgqd+L6a8VTxaJW732jcZZroiF +DsGJ6x9nxUWO/203Nit4ZoORUSs9/1F3dmKh7Gc+PoGD4FapUB8fepmrY7+EF3fx +DTvf95xhszWYijqy7DwaNz9+j5LP2RIUZNoQAhVB/0/E6xyjyfqZ90bp4RjZsbgy +LcsUDFDYg2WD7rlcz8sFWkz6GZdr1l0T08JcVLwyc6B49fFtHsufpaafItzRUZ6C +eWRgKRM+o/1Pcmqr4tTluCRVLERLiohEnMqE0yo7AgMBAAGjQjBAMA8GA1UdEwEB +/wQFMAMBAf8wDgYDVR0PAQH/BAQDAgEGMB0GA1UdDgQWBBSCIS1mxteg4BXrzkwJ +d8RgnlRuAzANBgkqhkiG9w0BAQsFAAOCAgEAYN4auOfyYILVAzOBywaK8SJJ6ejq +kX/GM15oGQOGO0MBzwdw5AgeZYWR5hEit/UCI46uuR59H35s5r0l1ZUa8gWmr4UC +b6741jH/JclKyMeKqdmfS0mbEVeZkkMR3rYzpMzXjWR91M08KCy0mpbqTfXERMQl +qiCA2ClV9+BB/AYm/7k29UMUA2Z44RGx2iBfRgB4ACGlHgAoYXhvqAEBj500mv/0 +OJD7uNGzcgbJceaBxXntC6Z58hMLnPddDnskk7RI24Zf3lCGeOdA5jGokHZwYa+c +NywRtYK3qq4kNFtyDGkNzVmf9nGvnAvRCjj5BiKDUyUM/FHE5r7iOZULJK2v0ZXk +ltd0ZGtxTgI8qoXzIKNDOXZbbFD+mpwUHmUUihW9o4JFWklWatKcsWMy5WHgUyIO +pwpJ6st+H6jiYoD2EEVSmAYY3qXNL3+q1Ok+CHLsIwMCPKaq2LxndD0UF/tUSxfj +03k9bWtJySgOLnRQvwzZRjoQhsmnP+mg7H/rpXdYaXHmgwo38oZJar55CJD2AhZk +PuXaTH4MNMn5X7azKFGnpyuqSfqNZSlO42sTp5SjLVFteAxEy9/eCG/Oo2Sr05WE +1LlSVHJ7liXMvGnjSG4N0MedJ5qq+BOS3R7fY581qRY27Iy4g/Q9iY/NtBde17MX +QRBdJ3NghVdJIgc= +-----END CERTIFICATE----- + +# Issuer: CN=Trustwave Global Certification Authority O=Trustwave Holdings, Inc. +# Subject: CN=Trustwave Global Certification Authority O=Trustwave Holdings, Inc. +# Label: "Trustwave Global Certification Authority" +# Serial: 1846098327275375458322922162 +# MD5 Fingerprint: f8:1c:18:2d:2f:ba:5f:6d:a1:6c:bc:c7:ab:91:c7:0e +# SHA1 Fingerprint: 2f:8f:36:4f:e1:58:97:44:21:59:87:a5:2a:9a:d0:69:95:26:7f:b5 +# SHA256 Fingerprint: 97:55:20:15:f5:dd:fc:3c:87:88:c0:06:94:45:55:40:88:94:45:00:84:f1:00:86:70:86:bc:1a:2b:b5:8d:c8 +-----BEGIN CERTIFICATE----- +MIIF2jCCA8KgAwIBAgIMBfcOhtpJ80Y1LrqyMA0GCSqGSIb3DQEBCwUAMIGIMQsw +CQYDVQQGEwJVUzERMA8GA1UECAwISWxsaW5vaXMxEDAOBgNVBAcMB0NoaWNhZ28x +ITAfBgNVBAoMGFRydXN0d2F2ZSBIb2xkaW5ncywgSW5jLjExMC8GA1UEAwwoVHJ1 +c3R3YXZlIEdsb2JhbCBDZXJ0aWZpY2F0aW9uIEF1dGhvcml0eTAeFw0xNzA4MjMx +OTM0MTJaFw00MjA4MjMxOTM0MTJaMIGIMQswCQYDVQQGEwJVUzERMA8GA1UECAwI +SWxsaW5vaXMxEDAOBgNVBAcMB0NoaWNhZ28xITAfBgNVBAoMGFRydXN0d2F2ZSBI +b2xkaW5ncywgSW5jLjExMC8GA1UEAwwoVHJ1c3R3YXZlIEdsb2JhbCBDZXJ0aWZp +Y2F0aW9uIEF1dGhvcml0eTCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIB +ALldUShLPDeS0YLOvR29zd24q88KPuFd5dyqCblXAj7mY2Hf8g+CY66j96xz0Xzn +swuvCAAJWX/NKSqIk4cXGIDtiLK0thAfLdZfVaITXdHG6wZWiYj+rDKd/VzDBcdu +7oaJuogDnXIhhpCujwOl3J+IKMujkkkP7NAP4m1ET4BqstTnoApTAbqOl5F2brz8 +1Ws25kCI1nsvXwXoLG0R8+eyvpJETNKXpP7ScoFDB5zpET71ixpZfR9oWN0EACyW +80OzfpgZdNmcc9kYvkHHNHnZ9GLCQ7mzJ7Aiy/k9UscwR7PJPrhq4ufogXBeQotP +JqX+OsIgbrv4Fo7NDKm0G2x2EOFYeUY+VM6AqFcJNykbmROPDMjWLBz7BegIlT1l +RtzuzWniTY+HKE40Cz7PFNm73bZQmq131BnW2hqIyE4bJ3XYsgjxroMwuREOzYfw +hI0Vcnyh78zyiGG69Gm7DIwLdVcEuE4qFC49DxweMqZiNu5m4iK4BUBjECLzMx10 +coos9TkpoNPnG4CELcU9402x/RpvumUHO1jsQkUm+9jaJXLE9gCxInm943xZYkqc +BW89zubWR2OZxiRvchLIrH+QtAuRcOi35hYQcRfO3gZPSEF9NUqjifLJS3tBEW1n +twiYTOURGa5CgNz7kAXU+FDKvuStx8KU1xad5hePrzb7AgMBAAGjQjBAMA8GA1Ud +EwEB/wQFMAMBAf8wHQYDVR0OBBYEFJngGWcNYtt2s9o9uFvo/ULSMQ6HMA4GA1Ud +DwEB/wQEAwIBBjANBgkqhkiG9w0BAQsFAAOCAgEAmHNw4rDT7TnsTGDZqRKGFx6W +0OhUKDtkLSGm+J1WE2pIPU/HPinbbViDVD2HfSMF1OQc3Og4ZYbFdada2zUFvXfe +uyk3QAUHw5RSn8pk3fEbK9xGChACMf1KaA0HZJDmHvUqoai7PF35owgLEQzxPy0Q +lG/+4jSHg9bP5Rs1bdID4bANqKCqRieCNqcVtgimQlRXtpla4gt5kNdXElE1GYhB +aCXUNxeEFfsBctyV3lImIJgm4nb1J2/6ADtKYdkNy1GTKv0WBpanI5ojSP5RvbbE +sLFUzt5sQa0WZ37b/TjNuThOssFgy50X31ieemKyJo90lZvkWx3SD92YHJtZuSPT +MaCm/zjdzyBP6VhWOmfD0faZmZ26NraAL4hHT4a/RDqA5Dccprrql5gR0IRiR2Qe +qu5AvzSxnI9O4fKSTx+O856X3vOmeWqJcU9LJxdI/uz0UA9PSX3MReO9ekDFQdxh +VicGaeVyQYHTtgGJoC86cnn+OjC/QezHYj6RS8fZMXZC+fc8Y+wmjHMMfRod6qh8 +h6jCJ3zhM0EPz8/8AKAigJ5Kp28AsEFFtyLKaEjFQqKu3R3y4G5OBVixwJAWKqQ9 +EEC+j2Jjg6mcgn0tAumDMHzLJ8n9HmYAsC7TIS+OMxZsmO0QqAfWzJPP29FpHOTK +yeC2nOnOcXHebD8WpHk= +-----END CERTIFICATE----- + +# Issuer: CN=Trustwave Global ECC P256 Certification Authority O=Trustwave Holdings, Inc. +# Subject: CN=Trustwave Global ECC P256 Certification Authority O=Trustwave Holdings, Inc. +# Label: "Trustwave Global ECC P256 Certification Authority" +# Serial: 4151900041497450638097112925 +# MD5 Fingerprint: 5b:44:e3:8d:5d:36:86:26:e8:0d:05:d2:59:a7:83:54 +# SHA1 Fingerprint: b4:90:82:dd:45:0c:be:8b:5b:b1:66:d3:e2:a4:08:26:cd:ed:42:cf +# SHA256 Fingerprint: 94:5b:bc:82:5e:a5:54:f4:89:d1:fd:51:a7:3d:df:2e:a6:24:ac:70:19:a0:52:05:22:5c:22:a7:8c:cf:a8:b4 +-----BEGIN CERTIFICATE----- +MIICYDCCAgegAwIBAgIMDWpfCD8oXD5Rld9dMAoGCCqGSM49BAMCMIGRMQswCQYD +VQQGEwJVUzERMA8GA1UECBMISWxsaW5vaXMxEDAOBgNVBAcTB0NoaWNhZ28xITAf +BgNVBAoTGFRydXN0d2F2ZSBIb2xkaW5ncywgSW5jLjE6MDgGA1UEAxMxVHJ1c3R3 +YXZlIEdsb2JhbCBFQ0MgUDI1NiBDZXJ0aWZpY2F0aW9uIEF1dGhvcml0eTAeFw0x +NzA4MjMxOTM1MTBaFw00MjA4MjMxOTM1MTBaMIGRMQswCQYDVQQGEwJVUzERMA8G +A1UECBMISWxsaW5vaXMxEDAOBgNVBAcTB0NoaWNhZ28xITAfBgNVBAoTGFRydXN0 +d2F2ZSBIb2xkaW5ncywgSW5jLjE6MDgGA1UEAxMxVHJ1c3R3YXZlIEdsb2JhbCBF +Q0MgUDI1NiBDZXJ0aWZpY2F0aW9uIEF1dGhvcml0eTBZMBMGByqGSM49AgEGCCqG +SM49AwEHA0IABH77bOYj43MyCMpg5lOcunSNGLB4kFKA3TjASh3RqMyTpJcGOMoN +FWLGjgEqZZ2q3zSRLoHB5DOSMcT9CTqmP62jQzBBMA8GA1UdEwEB/wQFMAMBAf8w +DwYDVR0PAQH/BAUDAwcGADAdBgNVHQ4EFgQUo0EGrJBt0UrrdaVKEJmzsaGLSvcw +CgYIKoZIzj0EAwIDRwAwRAIgB+ZU2g6gWrKuEZ+Hxbb/ad4lvvigtwjzRM4q3wgh +DDcCIC0mA6AFvWvR9lz4ZcyGbbOcNEhjhAnFjXca4syc4XR7 +-----END CERTIFICATE----- + +# Issuer: CN=Trustwave Global ECC P384 Certification Authority O=Trustwave Holdings, Inc. +# Subject: CN=Trustwave Global ECC P384 Certification Authority O=Trustwave Holdings, Inc. +# Label: "Trustwave Global ECC P384 Certification Authority" +# Serial: 2704997926503831671788816187 +# MD5 Fingerprint: ea:cf:60:c4:3b:b9:15:29:40:a1:97:ed:78:27:93:d6 +# SHA1 Fingerprint: e7:f3:a3:c8:cf:6f:c3:04:2e:6d:0e:67:32:c5:9e:68:95:0d:5e:d2 +# SHA256 Fingerprint: 55:90:38:59:c8:c0:c3:eb:b8:75:9e:ce:4e:25:57:22:5f:f5:75:8b:bd:38:eb:d4:82:76:60:1e:1b:d5:80:97 +-----BEGIN CERTIFICATE----- +MIICnTCCAiSgAwIBAgIMCL2Fl2yZJ6SAaEc7MAoGCCqGSM49BAMDMIGRMQswCQYD +VQQGEwJVUzERMA8GA1UECBMISWxsaW5vaXMxEDAOBgNVBAcTB0NoaWNhZ28xITAf +BgNVBAoTGFRydXN0d2F2ZSBIb2xkaW5ncywgSW5jLjE6MDgGA1UEAxMxVHJ1c3R3 +YXZlIEdsb2JhbCBFQ0MgUDM4NCBDZXJ0aWZpY2F0aW9uIEF1dGhvcml0eTAeFw0x +NzA4MjMxOTM2NDNaFw00MjA4MjMxOTM2NDNaMIGRMQswCQYDVQQGEwJVUzERMA8G +A1UECBMISWxsaW5vaXMxEDAOBgNVBAcTB0NoaWNhZ28xITAfBgNVBAoTGFRydXN0 +d2F2ZSBIb2xkaW5ncywgSW5jLjE6MDgGA1UEAxMxVHJ1c3R3YXZlIEdsb2JhbCBF +Q0MgUDM4NCBDZXJ0aWZpY2F0aW9uIEF1dGhvcml0eTB2MBAGByqGSM49AgEGBSuB +BAAiA2IABGvaDXU1CDFHBa5FmVXxERMuSvgQMSOjfoPTfygIOiYaOs+Xgh+AtycJ +j9GOMMQKmw6sWASr9zZ9lCOkmwqKi6vr/TklZvFe/oyujUF5nQlgziip04pt89ZF +1PKYhDhloKNDMEEwDwYDVR0TAQH/BAUwAwEB/zAPBgNVHQ8BAf8EBQMDBwYAMB0G +A1UdDgQWBBRVqYSJ0sEyvRjLbKYHTsjnnb6CkDAKBggqhkjOPQQDAwNnADBkAjA3 +AZKXRRJ+oPM+rRk6ct30UJMDEr5E0k9BpIycnR+j9sKS50gU/k6bpZFXrsY3crsC +MGclCrEMXu6pY5Jv5ZAL/mYiykf9ijH3g/56vxC+GCsej/YpHpRZ744hN8tRmKVu +Sw== +-----END CERTIFICATE----- + +# Issuer: CN=NAVER Global Root Certification Authority O=NAVER BUSINESS PLATFORM Corp. +# Subject: CN=NAVER Global Root Certification Authority O=NAVER BUSINESS PLATFORM Corp. +# Label: "NAVER Global Root Certification Authority" +# Serial: 9013692873798656336226253319739695165984492813 +# MD5 Fingerprint: c8:7e:41:f6:25:3b:f5:09:b3:17:e8:46:3d:bf:d0:9b +# SHA1 Fingerprint: 8f:6b:f2:a9:27:4a:da:14:a0:c4:f4:8e:61:27:f9:c0:1e:78:5d:d1 +# SHA256 Fingerprint: 88:f4:38:dc:f8:ff:d1:fa:8f:42:91:15:ff:e5:f8:2a:e1:e0:6e:0c:70:c3:75:fa:ad:71:7b:34:a4:9e:72:65 +-----BEGIN CERTIFICATE----- +MIIFojCCA4qgAwIBAgIUAZQwHqIL3fXFMyqxQ0Rx+NZQTQ0wDQYJKoZIhvcNAQEM +BQAwaTELMAkGA1UEBhMCS1IxJjAkBgNVBAoMHU5BVkVSIEJVU0lORVNTIFBMQVRG +T1JNIENvcnAuMTIwMAYDVQQDDClOQVZFUiBHbG9iYWwgUm9vdCBDZXJ0aWZpY2F0 +aW9uIEF1dGhvcml0eTAeFw0xNzA4MTgwODU4NDJaFw0zNzA4MTgyMzU5NTlaMGkx +CzAJBgNVBAYTAktSMSYwJAYDVQQKDB1OQVZFUiBCVVNJTkVTUyBQTEFURk9STSBD +b3JwLjEyMDAGA1UEAwwpTkFWRVIgR2xvYmFsIFJvb3QgQ2VydGlmaWNhdGlvbiBB +dXRob3JpdHkwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQC21PGTXLVA +iQqrDZBbUGOukJR0F0Vy1ntlWilLp1agS7gvQnXp2XskWjFlqxcX0TM62RHcQDaH +38dq6SZeWYp34+hInDEW+j6RscrJo+KfziFTowI2MMtSAuXaMl3Dxeb57hHHi8lE +HoSTGEq0n+USZGnQJoViAbbJAh2+g1G7XNr4rRVqmfeSVPc0W+m/6imBEtRTkZaz +kVrd/pBzKPswRrXKCAfHcXLJZtM0l/aM9BhK4dA9WkW2aacp+yPOiNgSnABIqKYP +szuSjXEOdMWLyEz59JuOuDxp7W87UC9Y7cSw0BwbagzivESq2M0UXZR4Yb8Obtoq +vC8MC3GmsxY/nOb5zJ9TNeIDoKAYv7vxvvTWjIcNQvcGufFt7QSUqP620wbGQGHf +nZ3zVHbOUzoBppJB7ASjjw2i1QnK1sua8e9DXcCrpUHPXFNwcMmIpi3Ua2FzUCaG +YQ5fG8Ir4ozVu53BA0K6lNpfqbDKzE0K70dpAy8i+/Eozr9dUGWokG2zdLAIx6yo +0es+nPxdGoMuK8u180SdOqcXYZaicdNwlhVNt0xz7hlcxVs+Qf6sdWA7G2POAN3a +CJBitOUt7kinaxeZVL6HSuOpXgRM6xBtVNbv8ejyYhbLgGvtPe31HzClrkvJE+2K +AQHJuFFYwGY6sWZLxNUxAmLpdIQM201GLQIDAQABo0IwQDAdBgNVHQ4EFgQU0p+I +36HNLL3s9TsBAZMzJ7LrYEswDgYDVR0PAQH/BAQDAgEGMA8GA1UdEwEB/wQFMAMB +Af8wDQYJKoZIhvcNAQEMBQADggIBADLKgLOdPVQG3dLSLvCkASELZ0jKbY7gyKoN +qo0hV4/GPnrK21HUUrPUloSlWGB/5QuOH/XcChWB5Tu2tyIvCZwTFrFsDDUIbatj +cu3cvuzHV+YwIHHW1xDBE1UBjCpD5EHxzzp6U5LOogMFDTjfArsQLtk70pt6wKGm ++LUx5vR1yblTmXVHIloUFcd4G7ad6Qz4G3bxhYTeodoS76TiEJd6eN4MUZeoIUCL +hr0N8F5OSza7OyAfikJW4Qsav3vQIkMsRIz75Sq0bBwcupTgE34h5prCy8VCZLQe +lHsIJchxzIdFV4XTnyliIoNRlwAYl3dqmJLJfGBs32x9SuRwTMKeuB330DTHD8z7 +p/8Dvq1wkNoL3chtl1+afwkyQf3NosxabUzyqkn+Zvjp2DXrDige7kgvOtB5CTh8 +piKCk5XQA76+AqAF3SAi428diDRgxuYKuQl1C/AH6GmWNcf7I4GOODm4RStDeKLR +LBT/DShycpWbXgnbiUSYqqFJu3FS8r/2/yehNq+4tneI3TqkbZs0kNwUXTC/t+sX +5Ie3cdCh13cV1ELX8vMxmV2b3RZtP+oGI/hGoiLtk/bdmuYqh7GYVPEi92tF4+KO +dh2ajcQGjTa3FPOdVGm3jjzVpG2Tgbet9r1ke8LJaDmgkpzNNIaRkPpkUZ3+/uul +9XXeifdy +-----END CERTIFICATE----- + +# Issuer: CN=AC RAIZ FNMT-RCM SERVIDORES SEGUROS O=FNMT-RCM OU=Ceres +# Subject: CN=AC RAIZ FNMT-RCM SERVIDORES SEGUROS O=FNMT-RCM OU=Ceres +# Label: "AC RAIZ FNMT-RCM SERVIDORES SEGUROS" +# Serial: 131542671362353147877283741781055151509 +# MD5 Fingerprint: 19:36:9c:52:03:2f:d2:d1:bb:23:cc:dd:1e:12:55:bb +# SHA1 Fingerprint: 62:ff:d9:9e:c0:65:0d:03:ce:75:93:d2:ed:3f:2d:32:c9:e3:e5:4a +# SHA256 Fingerprint: 55:41:53:b1:3d:2c:f9:dd:b7:53:bf:be:1a:4e:0a:e0:8d:0a:a4:18:70:58:fe:60:a2:b8:62:b2:e4:b8:7b:cb +-----BEGIN CERTIFICATE----- +MIICbjCCAfOgAwIBAgIQYvYybOXE42hcG2LdnC6dlTAKBggqhkjOPQQDAzB4MQsw +CQYDVQQGEwJFUzERMA8GA1UECgwIRk5NVC1SQ00xDjAMBgNVBAsMBUNlcmVzMRgw +FgYDVQRhDA9WQVRFUy1RMjgyNjAwNEoxLDAqBgNVBAMMI0FDIFJBSVogRk5NVC1S +Q00gU0VSVklET1JFUyBTRUdVUk9TMB4XDTE4MTIyMDA5MzczM1oXDTQzMTIyMDA5 +MzczM1oweDELMAkGA1UEBhMCRVMxETAPBgNVBAoMCEZOTVQtUkNNMQ4wDAYDVQQL +DAVDZXJlczEYMBYGA1UEYQwPVkFURVMtUTI4MjYwMDRKMSwwKgYDVQQDDCNBQyBS +QUlaIEZOTVQtUkNNIFNFUlZJRE9SRVMgU0VHVVJPUzB2MBAGByqGSM49AgEGBSuB +BAAiA2IABPa6V1PIyqvfNkpSIeSX0oNnnvBlUdBeh8dHsVnyV0ebAAKTRBdp20LH +sbI6GA60XYyzZl2hNPk2LEnb80b8s0RpRBNm/dfF/a82Tc4DTQdxz69qBdKiQ1oK +Um8BA06Oi6NCMEAwDwYDVR0TAQH/BAUwAwEB/zAOBgNVHQ8BAf8EBAMCAQYwHQYD +VR0OBBYEFAG5L++/EYZg8k/QQW6rcx/n0m5JMAoGCCqGSM49BAMDA2kAMGYCMQCu +SuMrQMN0EfKVrRYj3k4MGuZdpSRea0R7/DjiT8ucRRcRTBQnJlU5dUoDzBOQn5IC +MQD6SmxgiHPz7riYYqnOK8LZiqZwMR2vsJRM60/G49HzYqc8/5MuB1xJAWdpEgJy +v+c= +-----END CERTIFICATE----- + +# Issuer: CN=GlobalSign Root R46 O=GlobalSign nv-sa +# Subject: CN=GlobalSign Root R46 O=GlobalSign nv-sa +# Label: "GlobalSign Root R46" +# Serial: 1552617688466950547958867513931858518042577 +# MD5 Fingerprint: c4:14:30:e4:fa:66:43:94:2a:6a:1b:24:5f:19:d0:ef +# SHA1 Fingerprint: 53:a2:b0:4b:ca:6b:d6:45:e6:39:8a:8e:c4:0d:d2:bf:77:c3:a2:90 +# SHA256 Fingerprint: 4f:a3:12:6d:8d:3a:11:d1:c4:85:5a:4f:80:7c:ba:d6:cf:91:9d:3a:5a:88:b0:3b:ea:2c:63:72:d9:3c:40:c9 +-----BEGIN CERTIFICATE----- +MIIFWjCCA0KgAwIBAgISEdK7udcjGJ5AXwqdLdDfJWfRMA0GCSqGSIb3DQEBDAUA +MEYxCzAJBgNVBAYTAkJFMRkwFwYDVQQKExBHbG9iYWxTaWduIG52LXNhMRwwGgYD +VQQDExNHbG9iYWxTaWduIFJvb3QgUjQ2MB4XDTE5MDMyMDAwMDAwMFoXDTQ2MDMy +MDAwMDAwMFowRjELMAkGA1UEBhMCQkUxGTAXBgNVBAoTEEdsb2JhbFNpZ24gbnYt +c2ExHDAaBgNVBAMTE0dsb2JhbFNpZ24gUm9vdCBSNDYwggIiMA0GCSqGSIb3DQEB +AQUAA4ICDwAwggIKAoICAQCsrHQy6LNl5brtQyYdpokNRbopiLKkHWPd08EsCVeJ +OaFV6Wc0dwxu5FUdUiXSE2te4R2pt32JMl8Nnp8semNgQB+msLZ4j5lUlghYruQG +vGIFAha/r6gjA7aUD7xubMLL1aa7DOn2wQL7Id5m3RerdELv8HQvJfTqa1VbkNud +316HCkD7rRlr+/fKYIje2sGP1q7Vf9Q8g+7XFkyDRTNrJ9CG0Bwta/OrffGFqfUo +0q3v84RLHIf8E6M6cqJaESvWJ3En7YEtbWaBkoe0G1h6zD8K+kZPTXhc+CtI4wSE +y132tGqzZfxCnlEmIyDLPRT5ge1lFgBPGmSXZgjPjHvjK8Cd+RTyG/FWaha/LIWF +zXg4mutCagI0GIMXTpRW+LaCtfOW3T3zvn8gdz57GSNrLNRyc0NXfeD412lPFzYE ++cCQYDdF3uYM2HSNrpyibXRdQr4G9dlkbgIQrImwTDsHTUB+JMWKmIJ5jqSngiCN +I/onccnfxkF0oE32kRbcRoxfKWMxWXEM2G/CtjJ9++ZdU6Z+Ffy7dXxd7Pj2Fxzs +x2sZy/N78CsHpdlseVR2bJ0cpm4O6XkMqCNqo98bMDGfsVR7/mrLZqrcZdCinkqa +ByFrgY/bxFn63iLABJzjqls2k+g9vXqhnQt2sQvHnf3PmKgGwvgqo6GDoLclcqUC +4wIDAQABo0IwQDAOBgNVHQ8BAf8EBAMCAYYwDwYDVR0TAQH/BAUwAwEB/zAdBgNV +HQ4EFgQUA1yrc4GHqMywptWU4jaWSf8FmSwwDQYJKoZIhvcNAQEMBQADggIBAHx4 +7PYCLLtbfpIrXTncvtgdokIzTfnvpCo7RGkerNlFo048p9gkUbJUHJNOxO97k4Vg +JuoJSOD1u8fpaNK7ajFxzHmuEajwmf3lH7wvqMxX63bEIaZHU1VNaL8FpO7XJqti +2kM3S+LGteWygxk6x9PbTZ4IevPuzz5i+6zoYMzRx6Fcg0XERczzF2sUyQQCPtIk +pnnpHs6i58FZFZ8d4kuaPp92CC1r2LpXFNqD6v6MVenQTqnMdzGxRBF6XLE+0xRF +FRhiJBPSy03OXIPBNvIQtQ6IbbjhVp+J3pZmOUdkLG5NrmJ7v2B0GbhWrJKsFjLt +rWhV/pi60zTe9Mlhww6G9kuEYO4Ne7UyWHmRVSyBQ7N0H3qqJZ4d16GLuc1CLgSk +ZoNNiTW2bKg2SnkheCLQQrzRQDGQob4Ez8pn7fXwgNNgyYMqIgXQBztSvwyeqiv5 +u+YfjyW6hY0XHgL+XVAEV8/+LbzvXMAaq7afJMbfc2hIkCwU9D9SGuTSyxTDYWnP +4vkYxboznxSjBF25cfe1lNj2M8FawTSLfJvdkzrnE6JwYZ+vj+vYxXX4M2bUdGc6 +N3ec592kD3ZDZopD8p/7DEJ4Y9HiD2971KE9dJeFt0g5QdYg/NA6s/rob8SKunE3 +vouXsXgxT7PntgMTzlSdriVZzH81Xwj3QEUxeCp6 +-----END CERTIFICATE----- + +# Issuer: CN=GlobalSign Root E46 O=GlobalSign nv-sa +# Subject: CN=GlobalSign Root E46 O=GlobalSign nv-sa +# Label: "GlobalSign Root E46" +# Serial: 1552617690338932563915843282459653771421763 +# MD5 Fingerprint: b5:b8:66:ed:de:08:83:e3:c9:e2:01:34:06:ac:51:6f +# SHA1 Fingerprint: 39:b4:6c:d5:fe:80:06:eb:e2:2f:4a:bb:08:33:a0:af:db:b9:dd:84 +# SHA256 Fingerprint: cb:b9:c4:4d:84:b8:04:3e:10:50:ea:31:a6:9f:51:49:55:d7:bf:d2:e2:c6:b4:93:01:01:9a:d6:1d:9f:50:58 +-----BEGIN CERTIFICATE----- +MIICCzCCAZGgAwIBAgISEdK7ujNu1LzmJGjFDYQdmOhDMAoGCCqGSM49BAMDMEYx +CzAJBgNVBAYTAkJFMRkwFwYDVQQKExBHbG9iYWxTaWduIG52LXNhMRwwGgYDVQQD +ExNHbG9iYWxTaWduIFJvb3QgRTQ2MB4XDTE5MDMyMDAwMDAwMFoXDTQ2MDMyMDAw +MDAwMFowRjELMAkGA1UEBhMCQkUxGTAXBgNVBAoTEEdsb2JhbFNpZ24gbnYtc2Ex +HDAaBgNVBAMTE0dsb2JhbFNpZ24gUm9vdCBFNDYwdjAQBgcqhkjOPQIBBgUrgQQA +IgNiAAScDrHPt+ieUnd1NPqlRqetMhkytAepJ8qUuwzSChDH2omwlwxwEwkBjtjq +R+q+soArzfwoDdusvKSGN+1wCAB16pMLey5SnCNoIwZD7JIvU4Tb+0cUB+hflGdd +yXqBPCCjQjBAMA4GA1UdDwEB/wQEAwIBhjAPBgNVHRMBAf8EBTADAQH/MB0GA1Ud +DgQWBBQxCpCPtsad0kRLgLWi5h+xEk8blTAKBggqhkjOPQQDAwNoADBlAjEA31SQ +7Zvvi5QCkxeCmb6zniz2C5GMn0oUsfZkvLtoURMMA/cVi4RguYv/Uo7njLwcAjA8 ++RHUjE7AwWHCFUyqqx0LMV87HOIAl0Qx5v5zli/altP+CAezNIm8BZ/3Hobui3A= +-----END CERTIFICATE----- + +# Issuer: CN=ANF Secure Server Root CA O=ANF Autoridad de Certificacion OU=ANF CA Raiz +# Subject: CN=ANF Secure Server Root CA O=ANF Autoridad de Certificacion OU=ANF CA Raiz +# Label: "ANF Secure Server Root CA" +# Serial: 996390341000653745 +# MD5 Fingerprint: 26:a6:44:5a:d9:af:4e:2f:b2:1d:b6:65:b0:4e:e8:96 +# SHA1 Fingerprint: 5b:6e:68:d0:cc:15:b6:a0:5f:1e:c1:5f:ae:02:fc:6b:2f:5d:6f:74 +# SHA256 Fingerprint: fb:8f:ec:75:91:69:b9:10:6b:1e:51:16:44:c6:18:c5:13:04:37:3f:6c:06:43:08:8d:8b:ef:fd:1b:99:75:99 +-----BEGIN CERTIFICATE----- +MIIF7zCCA9egAwIBAgIIDdPjvGz5a7EwDQYJKoZIhvcNAQELBQAwgYQxEjAQBgNV +BAUTCUc2MzI4NzUxMDELMAkGA1UEBhMCRVMxJzAlBgNVBAoTHkFORiBBdXRvcmlk +YWQgZGUgQ2VydGlmaWNhY2lvbjEUMBIGA1UECxMLQU5GIENBIFJhaXoxIjAgBgNV +BAMTGUFORiBTZWN1cmUgU2VydmVyIFJvb3QgQ0EwHhcNMTkwOTA0MTAwMDM4WhcN +MzkwODMwMTAwMDM4WjCBhDESMBAGA1UEBRMJRzYzMjg3NTEwMQswCQYDVQQGEwJF +UzEnMCUGA1UEChMeQU5GIEF1dG9yaWRhZCBkZSBDZXJ0aWZpY2FjaW9uMRQwEgYD +VQQLEwtBTkYgQ0EgUmFpejEiMCAGA1UEAxMZQU5GIFNlY3VyZSBTZXJ2ZXIgUm9v +dCBDQTCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBANvrayvmZFSVgpCj +cqQZAZ2cC4Ffc0m6p6zzBE57lgvsEeBbphzOG9INgxwruJ4dfkUyYA8H6XdYfp9q +yGFOtibBTI3/TO80sh9l2Ll49a2pcbnvT1gdpd50IJeh7WhM3pIXS7yr/2WanvtH +2Vdy8wmhrnZEE26cLUQ5vPnHO6RYPUG9tMJJo8gN0pcvB2VSAKduyK9o7PQUlrZX +H1bDOZ8rbeTzPvY1ZNoMHKGESy9LS+IsJJ1tk0DrtSOOMspvRdOoiXsezx76W0OL +zc2oD2rKDF65nkeP8Nm2CgtYZRczuSPkdxl9y0oukntPLxB3sY0vaJxizOBQ+OyR +p1RMVwnVdmPF6GUe7m1qzwmd+nxPrWAI/VaZDxUse6mAq4xhj0oHdkLePfTdsiQz +W7i1o0TJrH93PB0j7IKppuLIBkwC/qxcmZkLLxCKpvR/1Yd0DVlJRfbwcVw5Kda/ +SiOL9V8BY9KHcyi1Swr1+KuCLH5zJTIdC2MKF4EA/7Z2Xue0sUDKIbvVgFHlSFJn +LNJhiQcND85Cd8BEc5xEUKDbEAotlRyBr+Qc5RQe8TZBAQIvfXOn3kLMTOmJDVb3 +n5HUA8ZsyY/b2BzgQJhdZpmYgG4t/wHFzstGH6wCxkPmrqKEPMVOHj1tyRRM4y5B +u8o5vzY8KhmqQYdOpc5LMnndkEl/AgMBAAGjYzBhMB8GA1UdIwQYMBaAFJxf0Gxj +o1+TypOYCK2Mh6UsXME3MB0GA1UdDgQWBBScX9BsY6Nfk8qTmAitjIelLFzBNzAO +BgNVHQ8BAf8EBAMCAYYwDwYDVR0TAQH/BAUwAwEB/zANBgkqhkiG9w0BAQsFAAOC +AgEATh65isagmD9uw2nAalxJUqzLK114OMHVVISfk/CHGT0sZonrDUL8zPB1hT+L +9IBdeeUXZ701guLyPI59WzbLWoAAKfLOKyzxj6ptBZNscsdW699QIyjlRRA96Gej +rw5VD5AJYu9LWaL2U/HANeQvwSS9eS9OICI7/RogsKQOLHDtdD+4E5UGUcjohybK +pFtqFiGS3XNgnhAY3jyB6ugYw3yJ8otQPr0R4hUDqDZ9MwFsSBXXiJCZBMXM5gf0 +vPSQ7RPi6ovDj6MzD8EpTBNO2hVWcXNyglD2mjN8orGoGjR0ZVzO0eurU+AagNjq +OknkJjCb5RyKqKkVMoaZkgoQI1YS4PbOTOK7vtuNknMBZi9iPrJyJ0U27U1W45eZ +/zo1PqVUSlJZS2Db7v54EX9K3BR5YLZrZAPbFYPhor72I5dQ8AkzNqdxliXzuUJ9 +2zg/LFis6ELhDtjTO0wugumDLmsx2d1Hhk9tl5EuT+IocTUW0fJz/iUrB0ckYyfI ++PbZa/wSMVYIwFNCr5zQM378BvAxRAMU8Vjq8moNqRGyg77FGr8H6lnco4g175x2 +MjxNBiLOFeXdntiP2t7SxDnlF4HPOEfrf4htWRvfn0IUrn7PqLBmZdo3r5+qPeoo +tt7VMVgWglvquxl1AnMaykgaIZOQCo6ThKd9OyMYkomgjaw= +-----END CERTIFICATE----- + +# Issuer: CN=Certum EC-384 CA O=Asseco Data Systems S.A. OU=Certum Certification Authority +# Subject: CN=Certum EC-384 CA O=Asseco Data Systems S.A. OU=Certum Certification Authority +# Label: "Certum EC-384 CA" +# Serial: 160250656287871593594747141429395092468 +# MD5 Fingerprint: b6:65:b3:96:60:97:12:a1:ec:4e:e1:3d:a3:c6:c9:f1 +# SHA1 Fingerprint: f3:3e:78:3c:ac:df:f4:a2:cc:ac:67:55:69:56:d7:e5:16:3c:e1:ed +# SHA256 Fingerprint: 6b:32:80:85:62:53:18:aa:50:d1:73:c9:8d:8b:da:09:d5:7e:27:41:3d:11:4c:f7:87:a0:f5:d0:6c:03:0c:f6 +-----BEGIN CERTIFICATE----- +MIICZTCCAeugAwIBAgIQeI8nXIESUiClBNAt3bpz9DAKBggqhkjOPQQDAzB0MQsw +CQYDVQQGEwJQTDEhMB8GA1UEChMYQXNzZWNvIERhdGEgU3lzdGVtcyBTLkEuMScw +JQYDVQQLEx5DZXJ0dW0gQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkxGTAXBgNVBAMT +EENlcnR1bSBFQy0zODQgQ0EwHhcNMTgwMzI2MDcyNDU0WhcNNDMwMzI2MDcyNDU0 +WjB0MQswCQYDVQQGEwJQTDEhMB8GA1UEChMYQXNzZWNvIERhdGEgU3lzdGVtcyBT +LkEuMScwJQYDVQQLEx5DZXJ0dW0gQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkxGTAX +BgNVBAMTEENlcnR1bSBFQy0zODQgQ0EwdjAQBgcqhkjOPQIBBgUrgQQAIgNiAATE +KI6rGFtqvm5kN2PkzeyrOvfMobgOgknXhimfoZTy42B4mIF4Bk3y7JoOV2CDn7Tm +Fy8as10CW4kjPMIRBSqniBMY81CE1700LCeJVf/OTOffph8oxPBUw7l8t1Ot68Kj +QjBAMA8GA1UdEwEB/wQFMAMBAf8wHQYDVR0OBBYEFI0GZnQkdjrzife81r1HfS+8 +EF9LMA4GA1UdDwEB/wQEAwIBBjAKBggqhkjOPQQDAwNoADBlAjADVS2m5hjEfO/J +UG7BJw+ch69u1RsIGL2SKcHvlJF40jocVYli5RsJHrpka/F2tNQCMQC0QoSZ/6vn +nvuRlydd3LBbMHHOXjgaatkl5+r3YZJW+OraNsKHZZYuciUvf9/DE8k= +-----END CERTIFICATE----- + +# Issuer: CN=Certum Trusted Root CA O=Asseco Data Systems S.A. OU=Certum Certification Authority +# Subject: CN=Certum Trusted Root CA O=Asseco Data Systems S.A. OU=Certum Certification Authority +# Label: "Certum Trusted Root CA" +# Serial: 40870380103424195783807378461123655149 +# MD5 Fingerprint: 51:e1:c2:e7:fe:4c:84:af:59:0e:2f:f4:54:6f:ea:29 +# SHA1 Fingerprint: c8:83:44:c0:18:ae:9f:cc:f1:87:b7:8f:22:d1:c5:d7:45:84:ba:e5 +# SHA256 Fingerprint: fe:76:96:57:38:55:77:3e:37:a9:5e:7a:d4:d9:cc:96:c3:01:57:c1:5d:31:76:5b:a9:b1:57:04:e1:ae:78:fd +-----BEGIN CERTIFICATE----- +MIIFwDCCA6igAwIBAgIQHr9ZULjJgDdMBvfrVU+17TANBgkqhkiG9w0BAQ0FADB6 +MQswCQYDVQQGEwJQTDEhMB8GA1UEChMYQXNzZWNvIERhdGEgU3lzdGVtcyBTLkEu +MScwJQYDVQQLEx5DZXJ0dW0gQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkxHzAdBgNV +BAMTFkNlcnR1bSBUcnVzdGVkIFJvb3QgQ0EwHhcNMTgwMzE2MTIxMDEzWhcNNDMw +MzE2MTIxMDEzWjB6MQswCQYDVQQGEwJQTDEhMB8GA1UEChMYQXNzZWNvIERhdGEg +U3lzdGVtcyBTLkEuMScwJQYDVQQLEx5DZXJ0dW0gQ2VydGlmaWNhdGlvbiBBdXRo +b3JpdHkxHzAdBgNVBAMTFkNlcnR1bSBUcnVzdGVkIFJvb3QgQ0EwggIiMA0GCSqG +SIb3DQEBAQUAA4ICDwAwggIKAoICAQDRLY67tzbqbTeRn06TpwXkKQMlzhyC93yZ +n0EGze2jusDbCSzBfN8pfktlL5On1AFrAygYo9idBcEq2EXxkd7fO9CAAozPOA/q +p1x4EaTByIVcJdPTsuclzxFUl6s1wB52HO8AU5853BSlLCIls3Jy/I2z5T4IHhQq +NwuIPMqw9MjCoa68wb4pZ1Xi/K1ZXP69VyywkI3C7Te2fJmItdUDmj0VDT06qKhF +8JVOJVkdzZhpu9PMMsmN74H+rX2Ju7pgE8pllWeg8xn2A1bUatMn4qGtg/BKEiJ3 +HAVz4hlxQsDsdUaakFjgao4rpUYwBI4Zshfjvqm6f1bxJAPXsiEodg42MEx51UGa +mqi4NboMOvJEGyCI98Ul1z3G4z5D3Yf+xOr1Uz5MZf87Sst4WmsXXw3Hw09Omiqi +7VdNIuJGmj8PkTQkfVXjjJU30xrwCSss0smNtA0Aq2cpKNgB9RkEth2+dv5yXMSF +ytKAQd8FqKPVhJBPC/PgP5sZ0jeJP/J7UhyM9uH3PAeXjA6iWYEMspA90+NZRu0P +qafegGtaqge2Gcu8V/OXIXoMsSt0Puvap2ctTMSYnjYJdmZm/Bo/6khUHL4wvYBQ +v3y1zgD2DGHZ5yQD4OMBgQ692IU0iL2yNqh7XAjlRICMb/gv1SHKHRzQ+8S1h9E6 +Tsd2tTVItQIDAQABo0IwQDAPBgNVHRMBAf8EBTADAQH/MB0GA1UdDgQWBBSM+xx1 +vALTn04uSNn5YFSqxLNP+jAOBgNVHQ8BAf8EBAMCAQYwDQYJKoZIhvcNAQENBQAD +ggIBAEii1QALLtA/vBzVtVRJHlpr9OTy4EA34MwUe7nJ+jW1dReTagVphZzNTxl4 +WxmB82M+w85bj/UvXgF2Ez8sALnNllI5SW0ETsXpD4YN4fqzX4IS8TrOZgYkNCvo +zMrnadyHncI013nR03e4qllY/p0m+jiGPp2Kh2RX5Rc64vmNueMzeMGQ2Ljdt4NR +5MTMI9UGfOZR0800McD2RrsLrfw9EAUqO0qRJe6M1ISHgCq8CYyqOhNf6DR5UMEQ +GfnTKB7U0VEwKbOukGfWHwpjscWpxkIxYxeU72nLL/qMFH3EQxiJ2fAyQOaA4kZf +5ePBAFmo+eggvIksDkc0C+pXwlM2/KfUrzHN/gLldfq5Jwn58/U7yn2fqSLLiMmq +0Uc9NneoWWRrJ8/vJ8HjJLWG965+Mk2weWjROeiQWMODvA8s1pfrzgzhIMfatz7D +P78v3DSk+yshzWePS/Tj6tQ/50+6uaWTRRxmHyH6ZF5v4HaUMst19W7l9o/HuKTM +qJZ9ZPskWkoDbGs4xugDQ5r3V7mzKWmTOPQD8rv7gmsHINFSH5pkAnuYZttcTVoP +0ISVoDwUQwbKytu4QTbaakRnh6+v40URFWkIsr4WOZckbxJF0WddCajJFdr60qZf +E2Efv4WstK2tBZQIgx51F9NxO5NQI1mg7TyRVJ12AMXDuDjb +-----END CERTIFICATE----- + +# Issuer: CN=TunTrust Root CA O=Agence Nationale de Certification Electronique +# Subject: CN=TunTrust Root CA O=Agence Nationale de Certification Electronique +# Label: "TunTrust Root CA" +# Serial: 108534058042236574382096126452369648152337120275 +# MD5 Fingerprint: 85:13:b9:90:5b:36:5c:b6:5e:b8:5a:f8:e0:31:57:b4 +# SHA1 Fingerprint: cf:e9:70:84:0f:e0:73:0f:9d:f6:0c:7f:2c:4b:ee:20:46:34:9c:bb +# SHA256 Fingerprint: 2e:44:10:2a:b5:8c:b8:54:19:45:1c:8e:19:d9:ac:f3:66:2c:af:bc:61:4b:6a:53:96:0a:30:f7:d0:e2:eb:41 +-----BEGIN CERTIFICATE----- +MIIFszCCA5ugAwIBAgIUEwLV4kBMkkaGFmddtLu7sms+/BMwDQYJKoZIhvcNAQEL +BQAwYTELMAkGA1UEBhMCVE4xNzA1BgNVBAoMLkFnZW5jZSBOYXRpb25hbGUgZGUg +Q2VydGlmaWNhdGlvbiBFbGVjdHJvbmlxdWUxGTAXBgNVBAMMEFR1blRydXN0IFJv +b3QgQ0EwHhcNMTkwNDI2MDg1NzU2WhcNNDQwNDI2MDg1NzU2WjBhMQswCQYDVQQG +EwJUTjE3MDUGA1UECgwuQWdlbmNlIE5hdGlvbmFsZSBkZSBDZXJ0aWZpY2F0aW9u +IEVsZWN0cm9uaXF1ZTEZMBcGA1UEAwwQVHVuVHJ1c3QgUm9vdCBDQTCCAiIwDQYJ +KoZIhvcNAQEBBQADggIPADCCAgoCggIBAMPN0/y9BFPdDCA61YguBUtB9YOCfvdZ +n56eY+hz2vYGqU8ftPkLHzmMmiDQfgbU7DTZhrx1W4eI8NLZ1KMKsmwb60ksPqxd +2JQDoOw05TDENX37Jk0bbjBU2PWARZw5rZzJJQRNmpA+TkBuimvNKWfGzC3gdOgF +VwpIUPp6Q9p+7FuaDmJ2/uqdHYVy7BG7NegfJ7/Boce7SBbdVtfMTqDhuazb1YMZ +GoXRlJfXyqNlC/M4+QKu3fZnz8k/9YosRxqZbwUN/dAdgjH8KcwAWJeRTIAAHDOF +li/LQcKLEITDCSSJH7UP2dl3RxiSlGBcx5kDPP73lad9UKGAwqmDrViWVSHbhlnU +r8a83YFuB9tgYv7sEG7aaAH0gxupPqJbI9dkxt/con3YS7qC0lH4Zr8GRuR5KiY2 +eY8fTpkdso8MDhz/yV3A/ZAQprE38806JG60hZC/gLkMjNWb1sjxVj8agIl6qeIb +MlEsPvLfe/ZdeikZjuXIvTZxi11Mwh0/rViizz1wTaZQmCXcI/m4WEEIcb9PuISg +jwBUFfyRbVinljvrS5YnzWuioYasDXxU5mZMZl+QviGaAkYt5IPCgLnPSz7ofzwB +7I9ezX/SKEIBlYrilz0QIX32nRzFNKHsLA4KUiwSVXAkPcvCFDVDXSdOvsC9qnyW +5/yeYa1E0wCXAgMBAAGjYzBhMB0GA1UdDgQWBBQGmpsfU33x9aTI04Y+oXNZtPdE +ITAPBgNVHRMBAf8EBTADAQH/MB8GA1UdIwQYMBaAFAaamx9TffH1pMjThj6hc1m0 +90QhMA4GA1UdDwEB/wQEAwIBBjANBgkqhkiG9w0BAQsFAAOCAgEAqgVutt0Vyb+z +xiD2BkewhpMl0425yAA/l/VSJ4hxyXT968pk21vvHl26v9Hr7lxpuhbI87mP0zYu +QEkHDVneixCwSQXi/5E/S7fdAo74gShczNxtr18UnH1YeA32gAm56Q6XKRm4t+v4 +FstVEuTGfbvE7Pi1HE4+Z7/FXxttbUcoqgRYYdZ2vyJ/0Adqp2RT8JeNnYA/u8EH +22Wv5psymsNUk8QcCMNE+3tjEUPRahphanltkE8pjkcFwRJpadbGNjHh/PqAulxP +xOu3Mqz4dWEX1xAZufHSCe96Qp1bWgvUxpVOKs7/B9dPfhgGiPEZtdmYu65xxBzn +dFlY7wyJz4sfdZMaBBSSSFCp61cpABbjNhzI+L/wM9VBD8TMPN3pM0MBkRArHtG5 +Xc0yGYuPjCB31yLEQtyEFpslbei0VXF/sHyz03FJuc9SpAQ/3D2gu68zngowYI7b +nV2UqL1g52KAdoGDDIzMMEZJ4gzSqK/rYXHv5yJiqfdcZGyfFoxnNidF9Ql7v/YQ +CvGwjVRDjAS6oz/v4jXH+XTgbzRB0L9zZVcg+ZtnemZoJE6AZb0QmQZZ8mWvuMZH +u/2QeItBcy6vVR/cO5JyboTT0GFMDcx2V+IthSIVNg3rAZ3r2OvEhJn7wAzMMujj +d9qDRIueVSjAi1jTkD5OGwDxFa2DK5o= +-----END CERTIFICATE----- + +# Issuer: CN=HARICA TLS RSA Root CA 2021 O=Hellenic Academic and Research Institutions CA +# Subject: CN=HARICA TLS RSA Root CA 2021 O=Hellenic Academic and Research Institutions CA +# Label: "HARICA TLS RSA Root CA 2021" +# Serial: 76817823531813593706434026085292783742 +# MD5 Fingerprint: 65:47:9b:58:86:dd:2c:f0:fc:a2:84:1f:1e:96:c4:91 +# SHA1 Fingerprint: 02:2d:05:82:fa:88:ce:14:0c:06:79:de:7f:14:10:e9:45:d7:a5:6d +# SHA256 Fingerprint: d9:5d:0e:8e:da:79:52:5b:f9:be:b1:1b:14:d2:10:0d:32:94:98:5f:0c:62:d9:fa:bd:9c:d9:99:ec:cb:7b:1d +-----BEGIN CERTIFICATE----- +MIIFpDCCA4ygAwIBAgIQOcqTHO9D88aOk8f0ZIk4fjANBgkqhkiG9w0BAQsFADBs +MQswCQYDVQQGEwJHUjE3MDUGA1UECgwuSGVsbGVuaWMgQWNhZGVtaWMgYW5kIFJl +c2VhcmNoIEluc3RpdHV0aW9ucyBDQTEkMCIGA1UEAwwbSEFSSUNBIFRMUyBSU0Eg +Um9vdCBDQSAyMDIxMB4XDTIxMDIxOTEwNTUzOFoXDTQ1MDIxMzEwNTUzN1owbDEL +MAkGA1UEBhMCR1IxNzA1BgNVBAoMLkhlbGxlbmljIEFjYWRlbWljIGFuZCBSZXNl +YXJjaCBJbnN0aXR1dGlvbnMgQ0ExJDAiBgNVBAMMG0hBUklDQSBUTFMgUlNBIFJv +b3QgQ0EgMjAyMTCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBAIvC569l +mwVnlskNJLnQDmT8zuIkGCyEf3dRywQRNrhe7Wlxp57kJQmXZ8FHws+RFjZiPTgE +4VGC/6zStGndLuwRo0Xua2s7TL+MjaQenRG56Tj5eg4MmOIjHdFOY9TnuEFE+2uv +a9of08WRiFukiZLRgeaMOVig1mlDqa2YUlhu2wr7a89o+uOkXjpFc5gH6l8Cct4M +pbOfrqkdtx2z/IpZ525yZa31MJQjB/OCFks1mJxTuy/K5FrZx40d/JiZ+yykgmvw +Kh+OC19xXFyuQnspiYHLA6OZyoieC0AJQTPb5lh6/a6ZcMBaD9YThnEvdmn8kN3b +LW7R8pv1GmuebxWMevBLKKAiOIAkbDakO/IwkfN4E8/BPzWr8R0RI7VDIp4BkrcY +AuUR0YLbFQDMYTfBKnya4dC6s1BG7oKsnTH4+yPiAwBIcKMJJnkVU2DzOFytOOqB +AGMUuTNe3QvboEUHGjMJ+E20pwKmafTCWQWIZYVWrkvL4N48fS0ayOn7H6NhStYq +E613TBoYm5EPWNgGVMWX+Ko/IIqmhaZ39qb8HOLubpQzKoNQhArlT4b4UEV4AIHr +W2jjJo3Me1xR9BQsQL4aYB16cmEdH2MtiKrOokWQCPxrvrNQKlr9qEgYRtaQQJKQ +CoReaDH46+0N0x3GfZkYVVYnZS6NRcUk7M7jAgMBAAGjQjBAMA8GA1UdEwEB/wQF +MAMBAf8wHQYDVR0OBBYEFApII6ZgpJIKM+qTW8VX6iVNvRLuMA4GA1UdDwEB/wQE +AwIBhjANBgkqhkiG9w0BAQsFAAOCAgEAPpBIqm5iFSVmewzVjIuJndftTgfvnNAU +X15QvWiWkKQUEapobQk1OUAJ2vQJLDSle1mESSmXdMgHHkdt8s4cUCbjnj1AUz/3 +f5Z2EMVGpdAgS1D0NTsY9FVqQRtHBmg8uwkIYtlfVUKqrFOFrJVWNlar5AWMxaja +H6NpvVMPxP/cyuN+8kyIhkdGGvMA9YCRotxDQpSbIPDRzbLrLFPCU3hKTwSUQZqP +JzLB5UkZv/HywouoCjkxKLR9YjYsTewfM7Z+d21+UPCfDtcRj88YxeMn/ibvBZ3P +zzfF0HvaO7AWhAw6k9a+F9sPPg4ZeAnHqQJyIkv3N3a6dcSFA1pj1bF1BcK5vZSt +jBWZp5N99sXzqnTPBIWUmAD04vnKJGW/4GKvyMX6ssmeVkjaef2WdhW+o45WxLM0 +/L5H9MG0qPzVMIho7suuyWPEdr6sOBjhXlzPrjoiUevRi7PzKzMHVIf6tLITe7pT +BGIBnfHAT+7hOtSLIBD6Alfm78ELt5BGnBkpjNxvoEppaZS3JGWg/6w/zgH7IS79 +aPib8qXPMThcFarmlwDB31qlpzmq6YR/PFGoOtmUW4y/Twhx5duoXNTSpv4Ao8YW +xw/ogM4cKGR0GQjTQuPOAF1/sdwTsOEFy9EgqoZ0njnnkf3/W9b3raYvAwtt41dU +63ZTGI0RmLo= +-----END CERTIFICATE----- + +# Issuer: CN=HARICA TLS ECC Root CA 2021 O=Hellenic Academic and Research Institutions CA +# Subject: CN=HARICA TLS ECC Root CA 2021 O=Hellenic Academic and Research Institutions CA +# Label: "HARICA TLS ECC Root CA 2021" +# Serial: 137515985548005187474074462014555733966 +# MD5 Fingerprint: ae:f7:4c:e5:66:35:d1:b7:9b:8c:22:93:74:d3:4b:b0 +# SHA1 Fingerprint: bc:b0:c1:9d:e9:98:92:70:19:38:57:e9:8d:a7:b4:5d:6e:ee:01:48 +# SHA256 Fingerprint: 3f:99:cc:47:4a:cf:ce:4d:fe:d5:87:94:66:5e:47:8d:15:47:73:9f:2e:78:0f:1b:b4:ca:9b:13:30:97:d4:01 +-----BEGIN CERTIFICATE----- +MIICVDCCAdugAwIBAgIQZ3SdjXfYO2rbIvT/WeK/zjAKBggqhkjOPQQDAzBsMQsw +CQYDVQQGEwJHUjE3MDUGA1UECgwuSGVsbGVuaWMgQWNhZGVtaWMgYW5kIFJlc2Vh +cmNoIEluc3RpdHV0aW9ucyBDQTEkMCIGA1UEAwwbSEFSSUNBIFRMUyBFQ0MgUm9v +dCBDQSAyMDIxMB4XDTIxMDIxOTExMDExMFoXDTQ1MDIxMzExMDEwOVowbDELMAkG +A1UEBhMCR1IxNzA1BgNVBAoMLkhlbGxlbmljIEFjYWRlbWljIGFuZCBSZXNlYXJj +aCBJbnN0aXR1dGlvbnMgQ0ExJDAiBgNVBAMMG0hBUklDQSBUTFMgRUNDIFJvb3Qg +Q0EgMjAyMTB2MBAGByqGSM49AgEGBSuBBAAiA2IABDgI/rGgltJ6rK9JOtDA4MM7 +KKrxcm1lAEeIhPyaJmuqS7psBAqIXhfyVYf8MLA04jRYVxqEU+kw2anylnTDUR9Y +STHMmE5gEYd103KUkE+bECUqqHgtvpBBWJAVcqeht6NCMEAwDwYDVR0TAQH/BAUw +AwEB/zAdBgNVHQ4EFgQUyRtTgRL+BNUW0aq8mm+3oJUZbsowDgYDVR0PAQH/BAQD +AgGGMAoGCCqGSM49BAMDA2cAMGQCMBHervjcToiwqfAircJRQO9gcS3ujwLEXQNw +SaSS6sUUiHCm0w2wqsosQJz76YJumgIwK0eaB8bRwoF8yguWGEEbo/QwCZ61IygN +nxS2PFOiTAZpffpskcYqSUXm7LcT4Tps +-----END CERTIFICATE----- + +# Issuer: CN=Autoridad de Certificacion Firmaprofesional CIF A62634068 +# Subject: CN=Autoridad de Certificacion Firmaprofesional CIF A62634068 +# Label: "Autoridad de Certificacion Firmaprofesional CIF A62634068" +# Serial: 1977337328857672817 +# MD5 Fingerprint: 4e:6e:9b:54:4c:ca:b7:fa:48:e4:90:b1:15:4b:1c:a3 +# SHA1 Fingerprint: 0b:be:c2:27:22:49:cb:39:aa:db:35:5c:53:e3:8c:ae:78:ff:b6:fe +# SHA256 Fingerprint: 57:de:05:83:ef:d2:b2:6e:03:61:da:99:da:9d:f4:64:8d:ef:7e:e8:44:1c:3b:72:8a:fa:9b:cd:e0:f9:b2:6a +-----BEGIN CERTIFICATE----- +MIIGFDCCA/ygAwIBAgIIG3Dp0v+ubHEwDQYJKoZIhvcNAQELBQAwUTELMAkGA1UE +BhMCRVMxQjBABgNVBAMMOUF1dG9yaWRhZCBkZSBDZXJ0aWZpY2FjaW9uIEZpcm1h +cHJvZmVzaW9uYWwgQ0lGIEE2MjYzNDA2ODAeFw0xNDA5MjMxNTIyMDdaFw0zNjA1 +MDUxNTIyMDdaMFExCzAJBgNVBAYTAkVTMUIwQAYDVQQDDDlBdXRvcmlkYWQgZGUg +Q2VydGlmaWNhY2lvbiBGaXJtYXByb2Zlc2lvbmFsIENJRiBBNjI2MzQwNjgwggIi +MA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQDKlmuO6vj78aI14H9M2uDDUtd9 +thDIAl6zQyrET2qyyhxdKJp4ERppWVevtSBC5IsP5t9bpgOSL/UR5GLXMnE42QQM +cas9UX4PB99jBVzpv5RvwSmCwLTaUbDBPLutN0pcyvFLNg4kq7/DhHf9qFD0sefG +L9ItWY16Ck6WaVICqjaY7Pz6FIMMNx/Jkjd/14Et5cS54D40/mf0PmbR0/RAz15i +NA9wBj4gGFrO93IbJWyTdBSTo3OxDqqHECNZXyAFGUftaI6SEspd/NYrspI8IM/h +X68gvqB2f3bl7BqGYTM+53u0P6APjqK5am+5hyZvQWyIplD9amML9ZMWGxmPsu2b +m8mQ9QEM3xk9Dz44I8kvjwzRAv4bVdZO0I08r0+k8/6vKtMFnXkIoctXMbScyJCy +Z/QYFpM6/EfY0XiWMR+6KwxfXZmtY4laJCB22N/9q06mIqqdXuYnin1oKaPnirja +EbsXLZmdEyRG98Xi2J+Of8ePdG1asuhy9azuJBCtLxTa/y2aRnFHvkLfuwHb9H/T +KI8xWVvTyQKmtFLKbpf7Q8UIJm+K9Lv9nyiqDdVF8xM6HdjAeI9BZzwelGSuewvF +6NkBiDkal4ZkQdU7hwxu+g/GvUgUvzlN1J5Bto+WHWOWk9mVBngxaJ43BjuAiUVh +OSPHG0SjFeUc+JIwuwIDAQABo4HvMIHsMB0GA1UdDgQWBBRlzeurNR4APn7VdMAc +tHNHDhpkLzASBgNVHRMBAf8ECDAGAQH/AgEBMIGmBgNVHSAEgZ4wgZswgZgGBFUd +IAAwgY8wLwYIKwYBBQUHAgEWI2h0dHA6Ly93d3cuZmlybWFwcm9mZXNpb25hbC5j +b20vY3BzMFwGCCsGAQUFBwICMFAeTgBQAGEAcwBlAG8AIABkAGUAIABsAGEAIABC +AG8AbgBhAG4AbwB2AGEAIAA0ADcAIABCAGEAcgBjAGUAbABvAG4AYQAgADAAOAAw +ADEANzAOBgNVHQ8BAf8EBAMCAQYwDQYJKoZIhvcNAQELBQADggIBAHSHKAIrdx9m +iWTtj3QuRhy7qPj4Cx2Dtjqn6EWKB7fgPiDL4QjbEwj4KKE1soCzC1HA01aajTNF +Sa9J8OA9B3pFE1r/yJfY0xgsfZb43aJlQ3CTkBW6kN/oGbDbLIpgD7dvlAceHabJ +hfa9NPhAeGIQcDq+fUs5gakQ1JZBu/hfHAsdCPKxsIl68veg4MSPi3i1O1ilI45P +Vf42O+AMt8oqMEEgtIDNrvx2ZnOorm7hfNoD6JQg5iKj0B+QXSBTFCZX2lSX3xZE +EAEeiGaPcjiT3SC3NL7X8e5jjkd5KAb881lFJWAiMxujX6i6KtoaPc1A6ozuBRWV +1aUsIC+nmCjuRfzxuIgALI9C2lHVnOUTaHFFQ4ueCyE8S1wF3BqfmI7avSKecs2t +CsvMo2ebKHTEm9caPARYpoKdrcd7b/+Alun4jWq9GJAd/0kakFI3ky88Al2CdgtR +5xbHV/g4+afNmyJU72OwFW1TZQNKXkqgsqeOSQBZONXH9IBk9W6VULgRfhVwOEqw +f9DEMnDAGf/JOC0ULGb0QkTmVXYbgBVX/8Cnp6o5qtjTcNAuuuuUavpfNIbnYrX9 +ivAwhZTJryQCL2/W3Wf+47BVTwSYT6RBVuKT0Gro1vP7ZeDOdcQxWQzugsgMYDNK +GbqEZycPvEJdvSRUDewdcAZfpLz6IHxV +-----END CERTIFICATE----- + +# Issuer: CN=vTrus ECC Root CA O=iTrusChina Co.,Ltd. +# Subject: CN=vTrus ECC Root CA O=iTrusChina Co.,Ltd. +# Label: "vTrus ECC Root CA" +# Serial: 630369271402956006249506845124680065938238527194 +# MD5 Fingerprint: de:4b:c1:f5:52:8c:9b:43:e1:3e:8f:55:54:17:8d:85 +# SHA1 Fingerprint: f6:9c:db:b0:fc:f6:02:13:b6:52:32:a6:a3:91:3f:16:70:da:c3:e1 +# SHA256 Fingerprint: 30:fb:ba:2c:32:23:8e:2a:98:54:7a:f9:79:31:e5:50:42:8b:9b:3f:1c:8e:eb:66:33:dc:fa:86:c5:b2:7d:d3 +-----BEGIN CERTIFICATE----- +MIICDzCCAZWgAwIBAgIUbmq8WapTvpg5Z6LSa6Q75m0c1towCgYIKoZIzj0EAwMw +RzELMAkGA1UEBhMCQ04xHDAaBgNVBAoTE2lUcnVzQ2hpbmEgQ28uLEx0ZC4xGjAY +BgNVBAMTEXZUcnVzIEVDQyBSb290IENBMB4XDTE4MDczMTA3MjY0NFoXDTQzMDcz +MTA3MjY0NFowRzELMAkGA1UEBhMCQ04xHDAaBgNVBAoTE2lUcnVzQ2hpbmEgQ28u +LEx0ZC4xGjAYBgNVBAMTEXZUcnVzIEVDQyBSb290IENBMHYwEAYHKoZIzj0CAQYF +K4EEACIDYgAEZVBKrox5lkqqHAjDo6LN/llWQXf9JpRCux3NCNtzslt188+cToL0 +v/hhJoVs1oVbcnDS/dtitN9Ti72xRFhiQgnH+n9bEOf+QP3A2MMrMudwpremIFUd +e4BdS49nTPEQo0IwQDAdBgNVHQ4EFgQUmDnNvtiyjPeyq+GtJK97fKHbH88wDwYD +VR0TAQH/BAUwAwEB/zAOBgNVHQ8BAf8EBAMCAQYwCgYIKoZIzj0EAwMDaAAwZQIw +V53dVvHH4+m4SVBrm2nDb+zDfSXkV5UTQJtS0zvzQBm8JsctBp61ezaf9SXUY2sA +AjEA6dPGnlaaKsyh2j/IZivTWJwghfqrkYpwcBE4YGQLYgmRWAD5Tfs0aNoJrSEG +GJTO +-----END CERTIFICATE----- + +# Issuer: CN=vTrus Root CA O=iTrusChina Co.,Ltd. +# Subject: CN=vTrus Root CA O=iTrusChina Co.,Ltd. +# Label: "vTrus Root CA" +# Serial: 387574501246983434957692974888460947164905180485 +# MD5 Fingerprint: b8:c9:37:df:fa:6b:31:84:64:c5:ea:11:6a:1b:75:fc +# SHA1 Fingerprint: 84:1a:69:fb:f5:cd:1a:25:34:13:3d:e3:f8:fc:b8:99:d0:c9:14:b7 +# SHA256 Fingerprint: 8a:71:de:65:59:33:6f:42:6c:26:e5:38:80:d0:0d:88:a1:8d:a4:c6:a9:1f:0d:cb:61:94:e2:06:c5:c9:63:87 +-----BEGIN CERTIFICATE----- +MIIFVjCCAz6gAwIBAgIUQ+NxE9izWRRdt86M/TX9b7wFjUUwDQYJKoZIhvcNAQEL +BQAwQzELMAkGA1UEBhMCQ04xHDAaBgNVBAoTE2lUcnVzQ2hpbmEgQ28uLEx0ZC4x +FjAUBgNVBAMTDXZUcnVzIFJvb3QgQ0EwHhcNMTgwNzMxMDcyNDA1WhcNNDMwNzMx +MDcyNDA1WjBDMQswCQYDVQQGEwJDTjEcMBoGA1UEChMTaVRydXNDaGluYSBDby4s +THRkLjEWMBQGA1UEAxMNdlRydXMgUm9vdCBDQTCCAiIwDQYJKoZIhvcNAQEBBQAD +ggIPADCCAgoCggIBAL1VfGHTuB0EYgWgrmy3cLRB6ksDXhA/kFocizuwZotsSKYc +IrrVQJLuM7IjWcmOvFjai57QGfIvWcaMY1q6n6MLsLOaXLoRuBLpDLvPbmyAhykU +AyyNJJrIZIO1aqwTLDPxn9wsYTwaP3BVm60AUn/PBLn+NvqcwBauYv6WTEN+VRS+ +GrPSbcKvdmaVayqwlHeFXgQPYh1jdfdr58tbmnDsPmcF8P4HCIDPKNsFxhQnL4Z9 +8Cfe/+Z+M0jnCx5Y0ScrUw5XSmXX+6KAYPxMvDVTAWqXcoKv8R1w6Jz1717CbMdH +flqUhSZNO7rrTOiwCcJlwp2dCZtOtZcFrPUGoPc2BX70kLJrxLT5ZOrpGgrIDajt +J8nU57O5q4IikCc9Kuh8kO+8T/3iCiSn3mUkpF3qwHYw03dQ+A0Em5Q2AXPKBlim +0zvc+gRGE1WKyURHuFE5Gi7oNOJ5y1lKCn+8pu8fA2dqWSslYpPZUxlmPCdiKYZN +pGvu/9ROutW04o5IWgAZCfEF2c6Rsffr6TlP9m8EQ5pV9T4FFL2/s1m02I4zhKOQ +UqqzApVg+QxMaPnu1RcN+HFXtSXkKe5lXa/R7jwXC1pDxaWG6iSe4gUH3DRCEpHW +OXSuTEGC2/KmSNGzm/MzqvOmwMVO9fSddmPmAsYiS8GVP1BkLFTltvA8Kc9XAgMB +AAGjQjBAMB0GA1UdDgQWBBRUYnBj8XWEQ1iO0RYgscasGrz2iTAPBgNVHRMBAf8E +BTADAQH/MA4GA1UdDwEB/wQEAwIBBjANBgkqhkiG9w0BAQsFAAOCAgEAKbqSSaet +8PFww+SX8J+pJdVrnjT+5hpk9jprUrIQeBqfTNqK2uwcN1LgQkv7bHbKJAs5EhWd +nxEt/Hlk3ODg9d3gV8mlsnZwUKT+twpw1aA08XXXTUm6EdGz2OyC/+sOxL9kLX1j +bhd47F18iMjrjld22VkE+rxSH0Ws8HqA7Oxvdq6R2xCOBNyS36D25q5J08FsEhvM +Kar5CKXiNxTKsbhm7xqC5PD48acWabfbqWE8n/Uxy+QARsIvdLGx14HuqCaVvIiv +TDUHKgLKeBRtRytAVunLKmChZwOgzoy8sHJnxDHO2zTlJQNgJXtxmOTAGytfdELS +S8VZCAeHvsXDf+eW2eHcKJfWjwXj9ZtOyh1QRwVTsMo554WgicEFOwE30z9J4nfr +I8iIZjs9OXYhRvHsXyO466JmdXTBQPfYaJqT4i2pLr0cox7IdMakLXogqzu4sEb9 +b91fUlV1YvCXoHzXOP0l382gmxDPi7g4Xl7FtKYCNqEeXxzP4padKar9mK5S4fNB +UvupLnKWnyfjqnN9+BojZns7q2WwMgFLFT49ok8MKzWixtlnEjUwzXYuFrOZnk1P +Ti07NEPhmg4NpGaXutIcSkwsKouLgU9xGqndXHt7CMUADTdA43x7VF8vhV929ven +sBxXVsFy6K2ir40zSbofitzmdHxghm+Hl3s= +-----END CERTIFICATE----- + +# Issuer: CN=ISRG Root X2 O=Internet Security Research Group +# Subject: CN=ISRG Root X2 O=Internet Security Research Group +# Label: "ISRG Root X2" +# Serial: 87493402998870891108772069816698636114 +# MD5 Fingerprint: d3:9e:c4:1e:23:3c:a6:df:cf:a3:7e:6d:e0:14:e6:e5 +# SHA1 Fingerprint: bd:b1:b9:3c:d5:97:8d:45:c6:26:14:55:f8:db:95:c7:5a:d1:53:af +# SHA256 Fingerprint: 69:72:9b:8e:15:a8:6e:fc:17:7a:57:af:b7:17:1d:fc:64:ad:d2:8c:2f:ca:8c:f1:50:7e:34:45:3c:cb:14:70 +-----BEGIN CERTIFICATE----- +MIICGzCCAaGgAwIBAgIQQdKd0XLq7qeAwSxs6S+HUjAKBggqhkjOPQQDAzBPMQsw +CQYDVQQGEwJVUzEpMCcGA1UEChMgSW50ZXJuZXQgU2VjdXJpdHkgUmVzZWFyY2gg +R3JvdXAxFTATBgNVBAMTDElTUkcgUm9vdCBYMjAeFw0yMDA5MDQwMDAwMDBaFw00 +MDA5MTcxNjAwMDBaME8xCzAJBgNVBAYTAlVTMSkwJwYDVQQKEyBJbnRlcm5ldCBT +ZWN1cml0eSBSZXNlYXJjaCBHcm91cDEVMBMGA1UEAxMMSVNSRyBSb290IFgyMHYw +EAYHKoZIzj0CAQYFK4EEACIDYgAEzZvVn4CDCuwJSvMWSj5cz3es3mcFDR0HttwW ++1qLFNvicWDEukWVEYmO6gbf9yoWHKS5xcUy4APgHoIYOIvXRdgKam7mAHf7AlF9 +ItgKbppbd9/w+kHsOdx1ymgHDB/qo0IwQDAOBgNVHQ8BAf8EBAMCAQYwDwYDVR0T +AQH/BAUwAwEB/zAdBgNVHQ4EFgQUfEKWrt5LSDv6kviejM9ti6lyN5UwCgYIKoZI +zj0EAwMDaAAwZQIwe3lORlCEwkSHRhtFcP9Ymd70/aTSVaYgLXTWNLxBo1BfASdW +tL4ndQavEi51mI38AjEAi/V3bNTIZargCyzuFJ0nN6T5U6VR5CmD1/iQMVtCnwr1 +/q4AaOeMSQ+2b1tbFfLn +-----END CERTIFICATE----- + +# Issuer: CN=HiPKI Root CA - G1 O=Chunghwa Telecom Co., Ltd. +# Subject: CN=HiPKI Root CA - G1 O=Chunghwa Telecom Co., Ltd. +# Label: "HiPKI Root CA - G1" +# Serial: 60966262342023497858655262305426234976 +# MD5 Fingerprint: 69:45:df:16:65:4b:e8:68:9a:8f:76:5f:ff:80:9e:d3 +# SHA1 Fingerprint: 6a:92:e4:a8:ee:1b:ec:96:45:37:e3:29:57:49:cd:96:e3:e5:d2:60 +# SHA256 Fingerprint: f0:15:ce:3c:c2:39:bf:ef:06:4b:e9:f1:d2:c4:17:e1:a0:26:4a:0a:94:be:1f:0c:8d:12:18:64:eb:69:49:cc +-----BEGIN CERTIFICATE----- +MIIFajCCA1KgAwIBAgIQLd2szmKXlKFD6LDNdmpeYDANBgkqhkiG9w0BAQsFADBP +MQswCQYDVQQGEwJUVzEjMCEGA1UECgwaQ2h1bmdod2EgVGVsZWNvbSBDby4sIEx0 +ZC4xGzAZBgNVBAMMEkhpUEtJIFJvb3QgQ0EgLSBHMTAeFw0xOTAyMjIwOTQ2MDRa +Fw0zNzEyMzExNTU5NTlaME8xCzAJBgNVBAYTAlRXMSMwIQYDVQQKDBpDaHVuZ2h3 +YSBUZWxlY29tIENvLiwgTHRkLjEbMBkGA1UEAwwSSGlQS0kgUm9vdCBDQSAtIEcx +MIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEA9B5/UnMyDHPkvRN0o9Qw +qNCuS9i233VHZvR85zkEHmpwINJaR3JnVfSl6J3VHiGh8Ge6zCFovkRTv4354twv +Vcg3Px+kwJyz5HdcoEb+d/oaoDjq7Zpy3iu9lFc6uux55199QmQ5eiY29yTw1S+6 +lZgRZq2XNdZ1AYDgr/SEYYwNHl98h5ZeQa/rh+r4XfEuiAU+TCK72h8q3VJGZDnz +Qs7ZngyzsHeXZJzA9KMuH5UHsBffMNsAGJZMoYFL3QRtU6M9/Aes1MU3guvklQgZ +KILSQjqj2FPseYlgSGDIcpJQ3AOPgz+yQlda22rpEZfdhSi8MEyr48KxRURHH+CK +FgeW0iEPU8DtqX7UTuybCeyvQqww1r/REEXgphaypcXTT3OUM3ECoWqj1jOXTyFj +HluP2cFeRXF3D4FdXyGarYPM+l7WjSNfGz1BryB1ZlpK9p/7qxj3ccC2HTHsOyDr +y+K49a6SsvfhhEvyovKTmiKe0xRvNlS9H15ZFblzqMF8b3ti6RZsR1pl8w4Rm0bZ +/W3c1pzAtH2lsN0/Vm+h+fbkEkj9Bn8SV7apI09bA8PgcSojt/ewsTu8mL3WmKgM +a/aOEmem8rJY5AIJEzypuxC00jBF8ez3ABHfZfjcK0NVvxaXxA/VLGGEqnKG/uY6 +fsI/fe78LxQ+5oXdUG+3Se0CAwEAAaNCMEAwDwYDVR0TAQH/BAUwAwEB/zAdBgNV +HQ4EFgQU8ncX+l6o/vY9cdVouslGDDjYr7AwDgYDVR0PAQH/BAQDAgGGMA0GCSqG +SIb3DQEBCwUAA4ICAQBQUfB13HAE4/+qddRxosuej6ip0691x1TPOhwEmSKsxBHi +7zNKpiMdDg1H2DfHb680f0+BazVP6XKlMeJ45/dOlBhbQH3PayFUhuaVevvGyuqc +SE5XCV0vrPSltJczWNWseanMX/mF+lLFjfiRFOs6DRfQUsJ748JzjkZ4Bjgs6Fza +ZsT0pPBWGTMpWmWSBUdGSquEwx4noR8RkpkndZMPvDY7l1ePJlsMu5wP1G4wB9Tc +XzZoZjmDlicmisjEOf6aIW/Vcobpf2Lll07QJNBAsNB1CI69aO4I1258EHBGG3zg +iLKecoaZAeO/n0kZtCW+VmWuF2PlHt/o/0elv+EmBYTksMCv5wiZqAxeJoBF1Pho +L5aPruJKHJwWDBNvOIf2u8g0X5IDUXlwpt/L9ZlNec1OvFefQ05rLisY+GpzjLrF +Ne85akEez3GoorKGB1s6yeHvP2UEgEcyRHCVTjFnanRbEEV16rCf0OY1/k6fi8wr +kkVbbiVghUbN0aqwdmaTd5a+g744tiROJgvM7XpWGuDpWsZkrUx6AEhEL7lAuxM+ +vhV4nYWBSipX3tUZQ9rbyltHhoMLP7YNdnhzeSJesYAfz77RP1YQmCuVh6EfnWQU +YDksswBVLuT1sw5XxJFBAJw/6KXf6vb/yPCtbVKoF6ubYfwSUTXkJf2vqmqGOQ== +-----END CERTIFICATE----- + +# Issuer: CN=GlobalSign O=GlobalSign OU=GlobalSign ECC Root CA - R4 +# Subject: CN=GlobalSign O=GlobalSign OU=GlobalSign ECC Root CA - R4 +# Label: "GlobalSign ECC Root CA - R4" +# Serial: 159662223612894884239637590694 +# MD5 Fingerprint: 26:29:f8:6d:e1:88:bf:a2:65:7f:aa:c4:cd:0f:7f:fc +# SHA1 Fingerprint: 6b:a0:b0:98:e1:71:ef:5a:ad:fe:48:15:80:77:10:f4:bd:6f:0b:28 +# SHA256 Fingerprint: b0:85:d7:0b:96:4f:19:1a:73:e4:af:0d:54:ae:7a:0e:07:aa:fd:af:9b:71:dd:08:62:13:8a:b7:32:5a:24:a2 +-----BEGIN CERTIFICATE----- +MIIB3DCCAYOgAwIBAgINAgPlfvU/k/2lCSGypjAKBggqhkjOPQQDAjBQMSQwIgYD +VQQLExtHbG9iYWxTaWduIEVDQyBSb290IENBIC0gUjQxEzARBgNVBAoTCkdsb2Jh +bFNpZ24xEzARBgNVBAMTCkdsb2JhbFNpZ24wHhcNMTIxMTEzMDAwMDAwWhcNMzgw +MTE5MDMxNDA3WjBQMSQwIgYDVQQLExtHbG9iYWxTaWduIEVDQyBSb290IENBIC0g +UjQxEzARBgNVBAoTCkdsb2JhbFNpZ24xEzARBgNVBAMTCkdsb2JhbFNpZ24wWTAT +BgcqhkjOPQIBBggqhkjOPQMBBwNCAAS4xnnTj2wlDp8uORkcA6SumuU5BwkWymOx +uYb4ilfBV85C+nOh92VC/x7BALJucw7/xyHlGKSq2XE/qNS5zowdo0IwQDAOBgNV +HQ8BAf8EBAMCAYYwDwYDVR0TAQH/BAUwAwEB/zAdBgNVHQ4EFgQUVLB7rUW44kB/ ++wpu+74zyTyjhNUwCgYIKoZIzj0EAwIDRwAwRAIgIk90crlgr/HmnKAWBVBfw147 +bmF0774BxL4YSFlhgjICICadVGNA3jdgUM/I2O2dgq43mLyjj0xMqTQrbO/7lZsm +-----END CERTIFICATE----- + +# Issuer: CN=GTS Root R1 O=Google Trust Services LLC +# Subject: CN=GTS Root R1 O=Google Trust Services LLC +# Label: "GTS Root R1" +# Serial: 159662320309726417404178440727 +# MD5 Fingerprint: 05:fe:d0:bf:71:a8:a3:76:63:da:01:e0:d8:52:dc:40 +# SHA1 Fingerprint: e5:8c:1c:c4:91:3b:38:63:4b:e9:10:6e:e3:ad:8e:6b:9d:d9:81:4a +# SHA256 Fingerprint: d9:47:43:2a:bd:e7:b7:fa:90:fc:2e:6b:59:10:1b:12:80:e0:e1:c7:e4:e4:0f:a3:c6:88:7f:ff:57:a7:f4:cf +-----BEGIN CERTIFICATE----- +MIIFVzCCAz+gAwIBAgINAgPlk28xsBNJiGuiFzANBgkqhkiG9w0BAQwFADBHMQsw +CQYDVQQGEwJVUzEiMCAGA1UEChMZR29vZ2xlIFRydXN0IFNlcnZpY2VzIExMQzEU +MBIGA1UEAxMLR1RTIFJvb3QgUjEwHhcNMTYwNjIyMDAwMDAwWhcNMzYwNjIyMDAw +MDAwWjBHMQswCQYDVQQGEwJVUzEiMCAGA1UEChMZR29vZ2xlIFRydXN0IFNlcnZp +Y2VzIExMQzEUMBIGA1UEAxMLR1RTIFJvb3QgUjEwggIiMA0GCSqGSIb3DQEBAQUA +A4ICDwAwggIKAoICAQC2EQKLHuOhd5s73L+UPreVp0A8of2C+X0yBoJx9vaMf/vo +27xqLpeXo4xL+Sv2sfnOhB2x+cWX3u+58qPpvBKJXqeqUqv4IyfLpLGcY9vXmX7w +Cl7raKb0xlpHDU0QM+NOsROjyBhsS+z8CZDfnWQpJSMHobTSPS5g4M/SCYe7zUjw +TcLCeoiKu7rPWRnWr4+wB7CeMfGCwcDfLqZtbBkOtdh+JhpFAz2weaSUKK0Pfybl +qAj+lug8aJRT7oM6iCsVlgmy4HqMLnXWnOunVmSPlk9orj2XwoSPwLxAwAtcvfaH +szVsrBhQf4TgTM2S0yDpM7xSma8ytSmzJSq0SPly4cpk9+aCEI3oncKKiPo4Zor8 +Y/kB+Xj9e1x3+naH+uzfsQ55lVe0vSbv1gHR6xYKu44LtcXFilWr06zqkUspzBmk +MiVOKvFlRNACzqrOSbTqn3yDsEB750Orp2yjj32JgfpMpf/VjsPOS+C12LOORc92 +wO1AK/1TD7Cn1TsNsYqiA94xrcx36m97PtbfkSIS5r762DL8EGMUUXLeXdYWk70p +aDPvOmbsB4om3xPXV2V4J95eSRQAogB/mqghtqmxlbCluQ0WEdrHbEg8QOB+DVrN +VjzRlwW5y0vtOUucxD/SVRNuJLDWcfr0wbrM7Rv1/oFB2ACYPTrIrnqYNxgFlQID +AQABo0IwQDAOBgNVHQ8BAf8EBAMCAYYwDwYDVR0TAQH/BAUwAwEB/zAdBgNVHQ4E +FgQU5K8rJnEaK0gnhS9SZizv8IkTcT4wDQYJKoZIhvcNAQEMBQADggIBAJ+qQibb +C5u+/x6Wki4+omVKapi6Ist9wTrYggoGxval3sBOh2Z5ofmmWJyq+bXmYOfg6LEe +QkEzCzc9zolwFcq1JKjPa7XSQCGYzyI0zzvFIoTgxQ6KfF2I5DUkzps+GlQebtuy +h6f88/qBVRRiClmpIgUxPoLW7ttXNLwzldMXG+gnoot7TiYaelpkttGsN/H9oPM4 +7HLwEXWdyzRSjeZ2axfG34arJ45JK3VmgRAhpuo+9K4l/3wV3s6MJT/KYnAK9y8J +ZgfIPxz88NtFMN9iiMG1D53Dn0reWVlHxYciNuaCp+0KueIHoI17eko8cdLiA6Ef +MgfdG+RCzgwARWGAtQsgWSl4vflVy2PFPEz0tv/bal8xa5meLMFrUKTX5hgUvYU/ +Z6tGn6D/Qqc6f1zLXbBwHSs09dR2CQzreExZBfMzQsNhFRAbd03OIozUhfJFfbdT +6u9AWpQKXCBfTkBdYiJ23//OYb2MI3jSNwLgjt7RETeJ9r/tSQdirpLsQBqvFAnZ +0E6yove+7u7Y/9waLd64NnHi/Hm3lCXRSHNboTXns5lndcEZOitHTtNCjv0xyBZm +2tIMPNuzjsmhDYAPexZ3FL//2wmUspO8IFgV6dtxQ/PeEMMA3KgqlbbC1j+Qa3bb +bP6MvPJwNQzcmRk13NfIRmPVNnGuV/u3gm3c +-----END CERTIFICATE----- + +# Issuer: CN=GTS Root R2 O=Google Trust Services LLC +# Subject: CN=GTS Root R2 O=Google Trust Services LLC +# Label: "GTS Root R2" +# Serial: 159662449406622349769042896298 +# MD5 Fingerprint: 1e:39:c0:53:e6:1e:29:82:0b:ca:52:55:36:5d:57:dc +# SHA1 Fingerprint: 9a:44:49:76:32:db:de:fa:d0:bc:fb:5a:7b:17:bd:9e:56:09:24:94 +# SHA256 Fingerprint: 8d:25:cd:97:22:9d:bf:70:35:6b:da:4e:b3:cc:73:40:31:e2:4c:f0:0f:af:cf:d3:2d:c7:6e:b5:84:1c:7e:a8 +-----BEGIN CERTIFICATE----- +MIIFVzCCAz+gAwIBAgINAgPlrsWNBCUaqxElqjANBgkqhkiG9w0BAQwFADBHMQsw +CQYDVQQGEwJVUzEiMCAGA1UEChMZR29vZ2xlIFRydXN0IFNlcnZpY2VzIExMQzEU +MBIGA1UEAxMLR1RTIFJvb3QgUjIwHhcNMTYwNjIyMDAwMDAwWhcNMzYwNjIyMDAw +MDAwWjBHMQswCQYDVQQGEwJVUzEiMCAGA1UEChMZR29vZ2xlIFRydXN0IFNlcnZp +Y2VzIExMQzEUMBIGA1UEAxMLR1RTIFJvb3QgUjIwggIiMA0GCSqGSIb3DQEBAQUA +A4ICDwAwggIKAoICAQDO3v2m++zsFDQ8BwZabFn3GTXd98GdVarTzTukk3LvCvpt +nfbwhYBboUhSnznFt+4orO/LdmgUud+tAWyZH8QiHZ/+cnfgLFuv5AS/T3KgGjSY +6Dlo7JUle3ah5mm5hRm9iYz+re026nO8/4Piy33B0s5Ks40FnotJk9/BW9BuXvAu +MC6C/Pq8tBcKSOWIm8Wba96wyrQD8Nr0kLhlZPdcTK3ofmZemde4wj7I0BOdre7k +RXuJVfeKH2JShBKzwkCX44ofR5GmdFrS+LFjKBC4swm4VndAoiaYecb+3yXuPuWg +f9RhD1FLPD+M2uFwdNjCaKH5wQzpoeJ/u1U8dgbuak7MkogwTZq9TwtImoS1mKPV ++3PBV2HdKFZ1E66HjucMUQkQdYhMvI35ezzUIkgfKtzra7tEscszcTJGr61K8Yzo +dDqs5xoic4DSMPclQsciOzsSrZYuxsN2B6ogtzVJV+mSSeh2FnIxZyuWfoqjx5RW +Ir9qS34BIbIjMt/kmkRtWVtd9QCgHJvGeJeNkP+byKq0rxFROV7Z+2et1VsRnTKa +G73VululycslaVNVJ1zgyjbLiGH7HrfQy+4W+9OmTN6SpdTi3/UGVN4unUu0kzCq +gc7dGtxRcw1PcOnlthYhGXmy5okLdWTK1au8CcEYof/UVKGFPP0UJAOyh9OktwID +AQABo0IwQDAOBgNVHQ8BAf8EBAMCAYYwDwYDVR0TAQH/BAUwAwEB/zAdBgNVHQ4E +FgQUu//KjiOfT5nK2+JopqUVJxce2Q4wDQYJKoZIhvcNAQEMBQADggIBAB/Kzt3H +vqGf2SdMC9wXmBFqiN495nFWcrKeGk6c1SuYJF2ba3uwM4IJvd8lRuqYnrYb/oM8 +0mJhwQTtzuDFycgTE1XnqGOtjHsB/ncw4c5omwX4Eu55MaBBRTUoCnGkJE+M3DyC +B19m3H0Q/gxhswWV7uGugQ+o+MePTagjAiZrHYNSVc61LwDKgEDg4XSsYPWHgJ2u +NmSRXbBoGOqKYcl3qJfEycel/FVL8/B/uWU9J2jQzGv6U53hkRrJXRqWbTKH7QMg +yALOWr7Z6v2yTcQvG99fevX4i8buMTolUVVnjWQye+mew4K6Ki3pHrTgSAai/Gev +HyICc/sgCq+dVEuhzf9gR7A/Xe8bVr2XIZYtCtFenTgCR2y59PYjJbigapordwj6 +xLEokCZYCDzifqrXPW+6MYgKBesntaFJ7qBFVHvmJ2WZICGoo7z7GJa7Um8M7YNR +TOlZ4iBgxcJlkoKM8xAfDoqXvneCbT+PHV28SSe9zE8P4c52hgQjxcCMElv924Sg +JPFI/2R80L5cFtHvma3AH/vLrrw4IgYmZNralw4/KBVEqE8AyvCazM90arQ+POuV +7LXTWtiBmelDGDfrs7vRWGJB82bSj6p4lVQgw1oudCvV0b4YacCs1aTPObpRhANl +6WLAYv7YTVWW4tAR+kg0Eeye7QUd5MjWHYbL +-----END CERTIFICATE----- + +# Issuer: CN=GTS Root R3 O=Google Trust Services LLC +# Subject: CN=GTS Root R3 O=Google Trust Services LLC +# Label: "GTS Root R3" +# Serial: 159662495401136852707857743206 +# MD5 Fingerprint: 3e:e7:9d:58:02:94:46:51:94:e5:e0:22:4a:8b:e7:73 +# SHA1 Fingerprint: ed:e5:71:80:2b:c8:92:b9:5b:83:3c:d2:32:68:3f:09:cd:a0:1e:46 +# SHA256 Fingerprint: 34:d8:a7:3e:e2:08:d9:bc:db:0d:95:65:20:93:4b:4e:40:e6:94:82:59:6e:8b:6f:73:c8:42:6b:01:0a:6f:48 +-----BEGIN CERTIFICATE----- +MIICCTCCAY6gAwIBAgINAgPluILrIPglJ209ZjAKBggqhkjOPQQDAzBHMQswCQYD +VQQGEwJVUzEiMCAGA1UEChMZR29vZ2xlIFRydXN0IFNlcnZpY2VzIExMQzEUMBIG +A1UEAxMLR1RTIFJvb3QgUjMwHhcNMTYwNjIyMDAwMDAwWhcNMzYwNjIyMDAwMDAw +WjBHMQswCQYDVQQGEwJVUzEiMCAGA1UEChMZR29vZ2xlIFRydXN0IFNlcnZpY2Vz +IExMQzEUMBIGA1UEAxMLR1RTIFJvb3QgUjMwdjAQBgcqhkjOPQIBBgUrgQQAIgNi +AAQfTzOHMymKoYTey8chWEGJ6ladK0uFxh1MJ7x/JlFyb+Kf1qPKzEUURout736G +jOyxfi//qXGdGIRFBEFVbivqJn+7kAHjSxm65FSWRQmx1WyRRK2EE46ajA2ADDL2 +4CejQjBAMA4GA1UdDwEB/wQEAwIBhjAPBgNVHRMBAf8EBTADAQH/MB0GA1UdDgQW +BBTB8Sa6oC2uhYHP0/EqEr24Cmf9vDAKBggqhkjOPQQDAwNpADBmAjEA9uEglRR7 +VKOQFhG/hMjqb2sXnh5GmCCbn9MN2azTL818+FsuVbu/3ZL3pAzcMeGiAjEA/Jdm +ZuVDFhOD3cffL74UOO0BzrEXGhF16b0DjyZ+hOXJYKaV11RZt+cRLInUue4X +-----END CERTIFICATE----- + +# Issuer: CN=GTS Root R4 O=Google Trust Services LLC +# Subject: CN=GTS Root R4 O=Google Trust Services LLC +# Label: "GTS Root R4" +# Serial: 159662532700760215368942768210 +# MD5 Fingerprint: 43:96:83:77:19:4d:76:b3:9d:65:52:e4:1d:22:a5:e8 +# SHA1 Fingerprint: 77:d3:03:67:b5:e0:0c:15:f6:0c:38:61:df:7c:e1:3b:92:46:4d:47 +# SHA256 Fingerprint: 34:9d:fa:40:58:c5:e2:63:12:3b:39:8a:e7:95:57:3c:4e:13:13:c8:3f:e6:8f:93:55:6c:d5:e8:03:1b:3c:7d +-----BEGIN CERTIFICATE----- +MIICCTCCAY6gAwIBAgINAgPlwGjvYxqccpBQUjAKBggqhkjOPQQDAzBHMQswCQYD +VQQGEwJVUzEiMCAGA1UEChMZR29vZ2xlIFRydXN0IFNlcnZpY2VzIExMQzEUMBIG +A1UEAxMLR1RTIFJvb3QgUjQwHhcNMTYwNjIyMDAwMDAwWhcNMzYwNjIyMDAwMDAw +WjBHMQswCQYDVQQGEwJVUzEiMCAGA1UEChMZR29vZ2xlIFRydXN0IFNlcnZpY2Vz +IExMQzEUMBIGA1UEAxMLR1RTIFJvb3QgUjQwdjAQBgcqhkjOPQIBBgUrgQQAIgNi +AATzdHOnaItgrkO4NcWBMHtLSZ37wWHO5t5GvWvVYRg1rkDdc/eJkTBa6zzuhXyi +QHY7qca4R9gq55KRanPpsXI5nymfopjTX15YhmUPoYRlBtHci8nHc8iMai/lxKvR +HYqjQjBAMA4GA1UdDwEB/wQEAwIBhjAPBgNVHRMBAf8EBTADAQH/MB0GA1UdDgQW +BBSATNbrdP9JNqPV2Py1PsVq8JQdjDAKBggqhkjOPQQDAwNpADBmAjEA6ED/g94D +9J+uHXqnLrmvT/aDHQ4thQEd0dlq7A/Cr8deVl5c1RxYIigL9zC2L7F8AjEA8GE8 +p/SgguMh1YQdc4acLa/KNJvxn7kjNuK8YAOdgLOaVsjh4rsUecrNIdSUtUlD +-----END CERTIFICATE----- + +# Issuer: CN=Telia Root CA v2 O=Telia Finland Oyj +# Subject: CN=Telia Root CA v2 O=Telia Finland Oyj +# Label: "Telia Root CA v2" +# Serial: 7288924052977061235122729490515358 +# MD5 Fingerprint: 0e:8f:ac:aa:82:df:85:b1:f4:dc:10:1c:fc:99:d9:48 +# SHA1 Fingerprint: b9:99:cd:d1:73:50:8a:c4:47:05:08:9c:8c:88:fb:be:a0:2b:40:cd +# SHA256 Fingerprint: 24:2b:69:74:2f:cb:1e:5b:2a:bf:98:89:8b:94:57:21:87:54:4e:5b:4d:99:11:78:65:73:62:1f:6a:74:b8:2c +-----BEGIN CERTIFICATE----- +MIIFdDCCA1ygAwIBAgIPAWdfJ9b+euPkrL4JWwWeMA0GCSqGSIb3DQEBCwUAMEQx +CzAJBgNVBAYTAkZJMRowGAYDVQQKDBFUZWxpYSBGaW5sYW5kIE95ajEZMBcGA1UE +AwwQVGVsaWEgUm9vdCBDQSB2MjAeFw0xODExMjkxMTU1NTRaFw00MzExMjkxMTU1 +NTRaMEQxCzAJBgNVBAYTAkZJMRowGAYDVQQKDBFUZWxpYSBGaW5sYW5kIE95ajEZ +MBcGA1UEAwwQVGVsaWEgUm9vdCBDQSB2MjCCAiIwDQYJKoZIhvcNAQEBBQADggIP +ADCCAgoCggIBALLQPwe84nvQa5n44ndp586dpAO8gm2h/oFlH0wnrI4AuhZ76zBq +AMCzdGh+sq/H1WKzej9Qyow2RCRj0jbpDIX2Q3bVTKFgcmfiKDOlyzG4OiIjNLh9 +vVYiQJ3q9HsDrWj8soFPmNB06o3lfc1jw6P23pLCWBnglrvFxKk9pXSW/q/5iaq9 +lRdU2HhE8Qx3FZLgmEKnpNaqIJLNwaCzlrI6hEKNfdWV5Nbb6WLEWLN5xYzTNTOD +n3WhUidhOPFZPY5Q4L15POdslv5e2QJltI5c0BE0312/UqeBAMN/mUWZFdUXyApT +7GPzmX3MaRKGwhfwAZ6/hLzRUssbkmbOpFPlob/E2wnW5olWK8jjfN7j/4nlNW4o +6GwLI1GpJQXrSPjdscr6bAhR77cYbETKJuFzxokGgeWKrLDiKca5JLNrRBH0pUPC +TEPlcDaMtjNXepUugqD0XBCzYYP2AgWGLnwtbNwDRm41k9V6lS/eINhbfpSQBGq6 +WT0EBXWdN6IOLj3rwaRSg/7Qa9RmjtzG6RJOHSpXqhC8fF6CfaamyfItufUXJ63R +DolUK5X6wK0dmBR4M0KGCqlztft0DbcbMBnEWg4cJ7faGND/isgFuvGqHKI3t+ZI +pEYslOqodmJHixBTB0hXbOKSTbauBcvcwUpej6w9GU7C7WB1K9vBykLVAgMBAAGj +YzBhMB8GA1UdIwQYMBaAFHKs5DN5qkWH9v2sHZ7Wxy+G2CQ5MB0GA1UdDgQWBBRy +rOQzeapFh/b9rB2e1scvhtgkOTAOBgNVHQ8BAf8EBAMCAQYwDwYDVR0TAQH/BAUw +AwEB/zANBgkqhkiG9w0BAQsFAAOCAgEAoDtZpwmUPjaE0n4vOaWWl/oRrfxn83EJ +8rKJhGdEr7nv7ZbsnGTbMjBvZ5qsfl+yqwE2foH65IRe0qw24GtixX1LDoJt0nZi +0f6X+J8wfBj5tFJ3gh1229MdqfDBmgC9bXXYfef6xzijnHDoRnkDry5023X4blMM +A8iZGok1GTzTyVR8qPAs5m4HeW9q4ebqkYJpCh3DflminmtGFZhb069GHWLIzoBS +SRE/yQQSwxN8PzuKlts8oB4KtItUsiRnDe+Cy748fdHif64W1lZYudogsYMVoe+K +TTJvQS8TUoKU1xrBeKJR3Stwbbca+few4GeXVtt8YVMJAygCQMez2P2ccGrGKMOF +6eLtGpOg3kuYooQ+BXcBlj37tCAPnHICehIv1aO6UXivKitEZU61/Qrowc15h2Er +3oBXRb9n8ZuRXqWk7FlIEA04x7D6w0RtBPV4UBySllva9bguulvP5fBqnUsvWHMt +Ty3EHD70sz+rFQ47GUGKpMFXEmZxTPpT41frYpUJnlTd0cI8Vzy9OK2YZLe4A5pT +VmBds9hCG1xLEooc6+t9xnppxyd/pPiL8uSUZodL6ZQHCRJ5irLrdATczvREWeAW +ysUsWNc8e89ihmpQfTU2Zqf7N+cox9jQraVplI/owd8k+BsHMYeB2F326CjYSlKA +rBPuUBQemMc= +-----END CERTIFICATE----- + +# Issuer: CN=D-TRUST BR Root CA 1 2020 O=D-Trust GmbH +# Subject: CN=D-TRUST BR Root CA 1 2020 O=D-Trust GmbH +# Label: "D-TRUST BR Root CA 1 2020" +# Serial: 165870826978392376648679885835942448534 +# MD5 Fingerprint: b5:aa:4b:d5:ed:f7:e3:55:2e:8f:72:0a:f3:75:b8:ed +# SHA1 Fingerprint: 1f:5b:98:f0:e3:b5:f7:74:3c:ed:e6:b0:36:7d:32:cd:f4:09:41:67 +# SHA256 Fingerprint: e5:9a:aa:81:60:09:c2:2b:ff:5b:25:ba:d3:7d:f3:06:f0:49:79:7c:1f:81:d8:5a:b0:89:e6:57:bd:8f:00:44 +-----BEGIN CERTIFICATE----- +MIIC2zCCAmCgAwIBAgIQfMmPK4TX3+oPyWWa00tNljAKBggqhkjOPQQDAzBIMQsw +CQYDVQQGEwJERTEVMBMGA1UEChMMRC1UcnVzdCBHbWJIMSIwIAYDVQQDExlELVRS +VVNUIEJSIFJvb3QgQ0EgMSAyMDIwMB4XDTIwMDIxMTA5NDUwMFoXDTM1MDIxMTA5 +NDQ1OVowSDELMAkGA1UEBhMCREUxFTATBgNVBAoTDEQtVHJ1c3QgR21iSDEiMCAG +A1UEAxMZRC1UUlVTVCBCUiBSb290IENBIDEgMjAyMDB2MBAGByqGSM49AgEGBSuB +BAAiA2IABMbLxyjR+4T1mu9CFCDhQ2tuda38KwOE1HaTJddZO0Flax7mNCq7dPYS +zuht56vkPE4/RAiLzRZxy7+SmfSk1zxQVFKQhYN4lGdnoxwJGT11NIXe7WB9xwy0 +QVK5buXuQqOCAQ0wggEJMA8GA1UdEwEB/wQFMAMBAf8wHQYDVR0OBBYEFHOREKv/ +VbNafAkl1bK6CKBrqx9tMA4GA1UdDwEB/wQEAwIBBjCBxgYDVR0fBIG+MIG7MD6g +PKA6hjhodHRwOi8vY3JsLmQtdHJ1c3QubmV0L2NybC9kLXRydXN0X2JyX3Jvb3Rf +Y2FfMV8yMDIwLmNybDB5oHegdYZzbGRhcDovL2RpcmVjdG9yeS5kLXRydXN0Lm5l +dC9DTj1ELVRSVVNUJTIwQlIlMjBSb290JTIwQ0ElMjAxJTIwMjAyMCxPPUQtVHJ1 +c3QlMjBHbWJILEM9REU/Y2VydGlmaWNhdGVyZXZvY2F0aW9ubGlzdDAKBggqhkjO +PQQDAwNpADBmAjEAlJAtE/rhY/hhY+ithXhUkZy4kzg+GkHaQBZTQgjKL47xPoFW +wKrY7RjEsK70PvomAjEA8yjixtsrmfu3Ubgko6SUeho/5jbiA1czijDLgsfWFBHV +dWNbFJWcHwHP2NVypw87 +-----END CERTIFICATE----- + +# Issuer: CN=D-TRUST EV Root CA 1 2020 O=D-Trust GmbH +# Subject: CN=D-TRUST EV Root CA 1 2020 O=D-Trust GmbH +# Label: "D-TRUST EV Root CA 1 2020" +# Serial: 126288379621884218666039612629459926992 +# MD5 Fingerprint: 8c:2d:9d:70:9f:48:99:11:06:11:fb:e9:cb:30:c0:6e +# SHA1 Fingerprint: 61:db:8c:21:59:69:03:90:d8:7c:9c:12:86:54:cf:9d:3d:f4:dd:07 +# SHA256 Fingerprint: 08:17:0d:1a:a3:64:53:90:1a:2f:95:92:45:e3:47:db:0c:8d:37:ab:aa:bc:56:b8:1a:a1:00:dc:95:89:70:db +-----BEGIN CERTIFICATE----- +MIIC2zCCAmCgAwIBAgIQXwJB13qHfEwDo6yWjfv/0DAKBggqhkjOPQQDAzBIMQsw +CQYDVQQGEwJERTEVMBMGA1UEChMMRC1UcnVzdCBHbWJIMSIwIAYDVQQDExlELVRS +VVNUIEVWIFJvb3QgQ0EgMSAyMDIwMB4XDTIwMDIxMTEwMDAwMFoXDTM1MDIxMTA5 +NTk1OVowSDELMAkGA1UEBhMCREUxFTATBgNVBAoTDEQtVHJ1c3QgR21iSDEiMCAG +A1UEAxMZRC1UUlVTVCBFViBSb290IENBIDEgMjAyMDB2MBAGByqGSM49AgEGBSuB +BAAiA2IABPEL3YZDIBnfl4XoIkqbz52Yv7QFJsnL46bSj8WeeHsxiamJrSc8ZRCC +/N/DnU7wMyPE0jL1HLDfMxddxfCxivnvubcUyilKwg+pf3VlSSowZ/Rk99Yad9rD +wpdhQntJraOCAQ0wggEJMA8GA1UdEwEB/wQFMAMBAf8wHQYDVR0OBBYEFH8QARY3 +OqQo5FD4pPfsazK2/umLMA4GA1UdDwEB/wQEAwIBBjCBxgYDVR0fBIG+MIG7MD6g +PKA6hjhodHRwOi8vY3JsLmQtdHJ1c3QubmV0L2NybC9kLXRydXN0X2V2X3Jvb3Rf +Y2FfMV8yMDIwLmNybDB5oHegdYZzbGRhcDovL2RpcmVjdG9yeS5kLXRydXN0Lm5l +dC9DTj1ELVRSVVNUJTIwRVYlMjBSb290JTIwQ0ElMjAxJTIwMjAyMCxPPUQtVHJ1 +c3QlMjBHbWJILEM9REU/Y2VydGlmaWNhdGVyZXZvY2F0aW9ubGlzdDAKBggqhkjO +PQQDAwNpADBmAjEAyjzGKnXCXnViOTYAYFqLwZOZzNnbQTs7h5kXO9XMT8oi96CA +y/m0sRtW9XLS/BnRAjEAkfcwkz8QRitxpNA7RJvAKQIFskF3UfN5Wp6OFKBOQtJb +gfM0agPnIjhQW+0ZT0MW +-----END CERTIFICATE----- + +# Issuer: CN=DigiCert TLS ECC P384 Root G5 O=DigiCert, Inc. +# Subject: CN=DigiCert TLS ECC P384 Root G5 O=DigiCert, Inc. +# Label: "DigiCert TLS ECC P384 Root G5" +# Serial: 13129116028163249804115411775095713523 +# MD5 Fingerprint: d3:71:04:6a:43:1c:db:a6:59:e1:a8:a3:aa:c5:71:ed +# SHA1 Fingerprint: 17:f3:de:5e:9f:0f:19:e9:8e:f6:1f:32:26:6e:20:c4:07:ae:30:ee +# SHA256 Fingerprint: 01:8e:13:f0:77:25:32:cf:80:9b:d1:b1:72:81:86:72:83:fc:48:c6:e1:3b:e9:c6:98:12:85:4a:49:0c:1b:05 +-----BEGIN CERTIFICATE----- +MIICGTCCAZ+gAwIBAgIQCeCTZaz32ci5PhwLBCou8zAKBggqhkjOPQQDAzBOMQsw +CQYDVQQGEwJVUzEXMBUGA1UEChMORGlnaUNlcnQsIEluYy4xJjAkBgNVBAMTHURp +Z2lDZXJ0IFRMUyBFQ0MgUDM4NCBSb290IEc1MB4XDTIxMDExNTAwMDAwMFoXDTQ2 +MDExNDIzNTk1OVowTjELMAkGA1UEBhMCVVMxFzAVBgNVBAoTDkRpZ2lDZXJ0LCBJ +bmMuMSYwJAYDVQQDEx1EaWdpQ2VydCBUTFMgRUNDIFAzODQgUm9vdCBHNTB2MBAG +ByqGSM49AgEGBSuBBAAiA2IABMFEoc8Rl1Ca3iOCNQfN0MsYndLxf3c1TzvdlHJS +7cI7+Oz6e2tYIOyZrsn8aLN1udsJ7MgT9U7GCh1mMEy7H0cKPGEQQil8pQgO4CLp +0zVozptjn4S1mU1YoI71VOeVyaNCMEAwHQYDVR0OBBYEFMFRRVBZqz7nLFr6ICIS +B4CIfBFqMA4GA1UdDwEB/wQEAwIBhjAPBgNVHRMBAf8EBTADAQH/MAoGCCqGSM49 +BAMDA2gAMGUCMQCJao1H5+z8blUD2WdsJk6Dxv3J+ysTvLd6jLRl0mlpYxNjOyZQ +LgGheQaRnUi/wr4CMEfDFXuxoJGZSZOoPHzoRgaLLPIxAJSdYsiJvRmEFOml+wG4 +DXZDjC5Ty3zfDBeWUA== +-----END CERTIFICATE----- + +# Issuer: CN=DigiCert TLS RSA4096 Root G5 O=DigiCert, Inc. +# Subject: CN=DigiCert TLS RSA4096 Root G5 O=DigiCert, Inc. +# Label: "DigiCert TLS RSA4096 Root G5" +# Serial: 11930366277458970227240571539258396554 +# MD5 Fingerprint: ac:fe:f7:34:96:a9:f2:b3:b4:12:4b:e4:27:41:6f:e1 +# SHA1 Fingerprint: a7:88:49:dc:5d:7c:75:8c:8c:de:39:98:56:b3:aa:d0:b2:a5:71:35 +# SHA256 Fingerprint: 37:1a:00:dc:05:33:b3:72:1a:7e:eb:40:e8:41:9e:70:79:9d:2b:0a:0f:2c:1d:80:69:31:65:f7:ce:c4:ad:75 +-----BEGIN CERTIFICATE----- +MIIFZjCCA06gAwIBAgIQCPm0eKj6ftpqMzeJ3nzPijANBgkqhkiG9w0BAQwFADBN +MQswCQYDVQQGEwJVUzEXMBUGA1UEChMORGlnaUNlcnQsIEluYy4xJTAjBgNVBAMT +HERpZ2lDZXJ0IFRMUyBSU0E0MDk2IFJvb3QgRzUwHhcNMjEwMTE1MDAwMDAwWhcN +NDYwMTE0MjM1OTU5WjBNMQswCQYDVQQGEwJVUzEXMBUGA1UEChMORGlnaUNlcnQs +IEluYy4xJTAjBgNVBAMTHERpZ2lDZXJ0IFRMUyBSU0E0MDk2IFJvb3QgRzUwggIi +MA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQCz0PTJeRGd/fxmgefM1eS87IE+ +ajWOLrfn3q/5B03PMJ3qCQuZvWxX2hhKuHisOjmopkisLnLlvevxGs3npAOpPxG0 +2C+JFvuUAT27L/gTBaF4HI4o4EXgg/RZG5Wzrn4DReW+wkL+7vI8toUTmDKdFqgp +wgscONyfMXdcvyej/Cestyu9dJsXLfKB2l2w4SMXPohKEiPQ6s+d3gMXsUJKoBZM +pG2T6T867jp8nVid9E6P/DsjyG244gXazOvswzH016cpVIDPRFtMbzCe88zdH5RD +nU1/cHAN1DrRN/BsnZvAFJNY781BOHW8EwOVfH/jXOnVDdXifBBiqmvwPXbzP6Po +sMH976pXTayGpxi0KcEsDr9kvimM2AItzVwv8n/vFfQMFawKsPHTDU9qTXeXAaDx +Zre3zu/O7Oyldcqs4+Fj97ihBMi8ez9dLRYiVu1ISf6nL3kwJZu6ay0/nTvEF+cd +Lvvyz6b84xQslpghjLSR6Rlgg/IwKwZzUNWYOwbpx4oMYIwo+FKbbuH2TbsGJJvX +KyY//SovcfXWJL5/MZ4PbeiPT02jP/816t9JXkGPhvnxd3lLG7SjXi/7RgLQZhNe +XoVPzthwiHvOAbWWl9fNff2C+MIkwcoBOU+NosEUQB+cZtUMCUbW8tDRSHZWOkPL +tgoRObqME2wGtZ7P6wIDAQABo0IwQDAdBgNVHQ4EFgQUUTMc7TZArxfTJc1paPKv +TiM+s0EwDgYDVR0PAQH/BAQDAgGGMA8GA1UdEwEB/wQFMAMBAf8wDQYJKoZIhvcN +AQEMBQADggIBAGCmr1tfV9qJ20tQqcQjNSH/0GEwhJG3PxDPJY7Jv0Y02cEhJhxw +GXIeo8mH/qlDZJY6yFMECrZBu8RHANmfGBg7sg7zNOok992vIGCukihfNudd5N7H +PNtQOa27PShNlnx2xlv0wdsUpasZYgcYQF+Xkdycx6u1UQ3maVNVzDl92sURVXLF +O4uJ+DQtpBflF+aZfTCIITfNMBc9uPK8qHWgQ9w+iUuQrm0D4ByjoJYJu32jtyoQ +REtGBzRj7TG5BO6jm5qu5jF49OokYTurWGT/u4cnYiWB39yhL/btp/96j1EuMPik +AdKFOV8BmZZvWltwGUb+hmA+rYAQCd05JS9Yf7vSdPD3Rh9GOUrYU9DzLjtxpdRv +/PNn5AeP3SYZ4Y1b+qOTEZvpyDrDVWiakuFSdjjo4bq9+0/V77PnSIMx8IIh47a+ +p6tv75/fTM8BuGJqIz3nCU2AG3swpMPdB380vqQmsvZB6Akd4yCYqjdP//fx4ilw +MUc/dNAUFvohigLVigmUdy7yWSiLfFCSCmZ4OIN1xLVaqBHG5cGdZlXPU8Sv13WF +qUITVuwhd4GTWgzqltlJyqEI8pc7bZsEGCREjnwB8twl2F6GmrE52/WRMmrRpnCK +ovfepEWFJqgejF0pW8hL2JpqA15w8oVPbEtoL8pU9ozaMv7Da4M/OMZ+ +-----END CERTIFICATE----- + +# Issuer: CN=Certainly Root R1 O=Certainly +# Subject: CN=Certainly Root R1 O=Certainly +# Label: "Certainly Root R1" +# Serial: 188833316161142517227353805653483829216 +# MD5 Fingerprint: 07:70:d4:3e:82:87:a0:fa:33:36:13:f4:fa:33:e7:12 +# SHA1 Fingerprint: a0:50:ee:0f:28:71:f4:27:b2:12:6d:6f:50:96:25:ba:cc:86:42:af +# SHA256 Fingerprint: 77:b8:2c:d8:64:4c:43:05:f7:ac:c5:cb:15:6b:45:67:50:04:03:3d:51:c6:0c:62:02:a8:e0:c3:34:67:d3:a0 +-----BEGIN CERTIFICATE----- +MIIFRzCCAy+gAwIBAgIRAI4P+UuQcWhlM1T01EQ5t+AwDQYJKoZIhvcNAQELBQAw +PTELMAkGA1UEBhMCVVMxEjAQBgNVBAoTCUNlcnRhaW5seTEaMBgGA1UEAxMRQ2Vy +dGFpbmx5IFJvb3QgUjEwHhcNMjEwNDAxMDAwMDAwWhcNNDYwNDAxMDAwMDAwWjA9 +MQswCQYDVQQGEwJVUzESMBAGA1UEChMJQ2VydGFpbmx5MRowGAYDVQQDExFDZXJ0 +YWlubHkgUm9vdCBSMTCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBANA2 +1B/q3avk0bbm+yLA3RMNansiExyXPGhjZjKcA7WNpIGD2ngwEc/csiu+kr+O5MQT +vqRoTNoCaBZ0vrLdBORrKt03H2As2/X3oXyVtwxwhi7xOu9S98zTm/mLvg7fMbed +aFySpvXl8wo0tf97ouSHocavFwDvA5HtqRxOcT3Si2yJ9HiG5mpJoM610rCrm/b0 +1C7jcvk2xusVtyWMOvwlDbMicyF0yEqWYZL1LwsYpfSt4u5BvQF5+paMjRcCMLT5 +r3gajLQ2EBAHBXDQ9DGQilHFhiZ5shGIXsXwClTNSaa/ApzSRKft43jvRl5tcdF5 +cBxGX1HpyTfcX35pe0HfNEXgO4T0oYoKNp43zGJS4YkNKPl6I7ENPT2a/Z2B7yyQ +wHtETrtJ4A5KVpK8y7XdeReJkd5hiXSSqOMyhb5OhaRLWcsrxXiOcVTQAjeZjOVJ +6uBUcqQRBi8LjMFbvrWhsFNunLhgkR9Za/kt9JQKl7XsxXYDVBtlUrpMklZRNaBA +2CnbrlJ2Oy0wQJuK0EJWtLeIAaSHO1OWzaMWj/Nmqhexx2DgwUMFDO6bW2BvBlyH +Wyf5QBGenDPBt+U1VwV/J84XIIwc/PH72jEpSe31C4SnT8H2TsIonPru4K8H+zMR +eiFPCyEQtkA6qyI6BJyLm4SGcprSp6XEtHWRqSsjAgMBAAGjQjBAMA4GA1UdDwEB +/wQEAwIBBjAPBgNVHRMBAf8EBTADAQH/MB0GA1UdDgQWBBTgqj8ljZ9EXME66C6u +d0yEPmcM9DANBgkqhkiG9w0BAQsFAAOCAgEAuVevuBLaV4OPaAszHQNTVfSVcOQr +PbA56/qJYv331hgELyE03fFo8NWWWt7CgKPBjcZq91l3rhVkz1t5BXdm6ozTaw3d +8VkswTOlMIAVRQdFGjEitpIAq5lNOo93r6kiyi9jyhXWx8bwPWz8HA2YEGGeEaIi +1wrykXprOQ4vMMM2SZ/g6Q8CRFA3lFV96p/2O7qUpUzpvD5RtOjKkjZUbVwlKNrd +rRT90+7iIgXr0PK3aBLXWopBGsaSpVo7Y0VPv+E6dyIvXL9G+VoDhRNCX8reU9di +taY1BMJH/5n9hN9czulegChB8n3nHpDYT3Y+gjwN/KUD+nsa2UUeYNrEjvn8K8l7 +lcUq/6qJ34IxD3L/DCfXCh5WAFAeDJDBlrXYFIW7pw0WwfgHJBu6haEaBQmAupVj +yTrsJZ9/nbqkRxWbRHDxakvWOF5D8xh+UG7pWijmZeZ3Gzr9Hb4DJqPb1OG7fpYn +Kx3upPvaJVQTA945xsMfTZDsjxtK0hzthZU4UHlG1sGQUDGpXJpuHfUzVounmdLy +yCwzk5Iwx06MZTMQZBf9JBeW0Y3COmor6xOLRPIh80oat3df1+2IpHLlOR+Vnb5n +wXARPbv0+Em34yaXOp/SX3z7wJl8OSngex2/DaeP0ik0biQVy96QXr8axGbqwua6 +OV+KmalBWQewLK8= +-----END CERTIFICATE----- + +# Issuer: CN=Certainly Root E1 O=Certainly +# Subject: CN=Certainly Root E1 O=Certainly +# Label: "Certainly Root E1" +# Serial: 8168531406727139161245376702891150584 +# MD5 Fingerprint: 0a:9e:ca:cd:3e:52:50:c6:36:f3:4b:a3:ed:a7:53:e9 +# SHA1 Fingerprint: f9:e1:6d:dc:01:89:cf:d5:82:45:63:3e:c5:37:7d:c2:eb:93:6f:2b +# SHA256 Fingerprint: b4:58:5f:22:e4:ac:75:6a:4e:86:12:a1:36:1c:5d:9d:03:1a:93:fd:84:fe:bb:77:8f:a3:06:8b:0f:c4:2d:c2 +-----BEGIN CERTIFICATE----- +MIIB9zCCAX2gAwIBAgIQBiUzsUcDMydc+Y2aub/M+DAKBggqhkjOPQQDAzA9MQsw +CQYDVQQGEwJVUzESMBAGA1UEChMJQ2VydGFpbmx5MRowGAYDVQQDExFDZXJ0YWlu +bHkgUm9vdCBFMTAeFw0yMTA0MDEwMDAwMDBaFw00NjA0MDEwMDAwMDBaMD0xCzAJ +BgNVBAYTAlVTMRIwEAYDVQQKEwlDZXJ0YWlubHkxGjAYBgNVBAMTEUNlcnRhaW5s +eSBSb290IEUxMHYwEAYHKoZIzj0CAQYFK4EEACIDYgAE3m/4fxzf7flHh4axpMCK ++IKXgOqPyEpeKn2IaKcBYhSRJHpcnqMXfYqGITQYUBsQ3tA3SybHGWCA6TS9YBk2 +QNYphwk8kXr2vBMj3VlOBF7PyAIcGFPBMdjaIOlEjeR2o0IwQDAOBgNVHQ8BAf8E +BAMCAQYwDwYDVR0TAQH/BAUwAwEB/zAdBgNVHQ4EFgQU8ygYy2R17ikq6+2uI1g4 +hevIIgcwCgYIKoZIzj0EAwMDaAAwZQIxALGOWiDDshliTd6wT99u0nCK8Z9+aozm +ut6Dacpps6kFtZaSF4fC0urQe87YQVt8rgIwRt7qy12a7DLCZRawTDBcMPPaTnOG +BtjOiQRINzf43TNRnXCve1XYAS59BWQOhriR +-----END CERTIFICATE----- + +# Issuer: CN=Security Communication RootCA3 O=SECOM Trust Systems CO.,LTD. +# Subject: CN=Security Communication RootCA3 O=SECOM Trust Systems CO.,LTD. +# Label: "Security Communication RootCA3" +# Serial: 16247922307909811815 +# MD5 Fingerprint: 1c:9a:16:ff:9e:5c:e0:4d:8a:14:01:f4:35:5d:29:26 +# SHA1 Fingerprint: c3:03:c8:22:74:92:e5:61:a2:9c:5f:79:91:2b:1e:44:13:91:30:3a +# SHA256 Fingerprint: 24:a5:5c:2a:b0:51:44:2d:06:17:76:65:41:23:9a:4a:d0:32:d7:c5:51:75:aa:34:ff:de:2f:bc:4f:5c:52:94 +-----BEGIN CERTIFICATE----- +MIIFfzCCA2egAwIBAgIJAOF8N0D9G/5nMA0GCSqGSIb3DQEBDAUAMF0xCzAJBgNV +BAYTAkpQMSUwIwYDVQQKExxTRUNPTSBUcnVzdCBTeXN0ZW1zIENPLixMVEQuMScw +JQYDVQQDEx5TZWN1cml0eSBDb21tdW5pY2F0aW9uIFJvb3RDQTMwHhcNMTYwNjE2 +MDYxNzE2WhcNMzgwMTE4MDYxNzE2WjBdMQswCQYDVQQGEwJKUDElMCMGA1UEChMc +U0VDT00gVHJ1c3QgU3lzdGVtcyBDTy4sTFRELjEnMCUGA1UEAxMeU2VjdXJpdHkg +Q29tbXVuaWNhdGlvbiBSb290Q0EzMIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIIC +CgKCAgEA48lySfcw3gl8qUCBWNO0Ot26YQ+TUG5pPDXC7ltzkBtnTCHsXzW7OT4r +CmDvu20rhvtxosis5FaU+cmvsXLUIKx00rgVrVH+hXShuRD+BYD5UpOzQD11EKzA +lrenfna84xtSGc4RHwsENPXY9Wk8d/Nk9A2qhd7gCVAEF5aEt8iKvE1y/By7z/MG +TfmfZPd+pmaGNXHIEYBMwXFAWB6+oHP2/D5Q4eAvJj1+XCO1eXDe+uDRpdYMQXF7 +9+qMHIjH7Iv10S9VlkZ8WjtYO/u62C21Jdp6Ts9EriGmnpjKIG58u4iFW/vAEGK7 +8vknR+/RiTlDxN/e4UG/VHMgly1s2vPUB6PmudhvrvyMGS7TZ2crldtYXLVqAvO4 +g160a75BflcJdURQVc1aEWEhCmHCqYj9E7wtiS/NYeCVvsq1e+F7NGcLH7YMx3we +GVPKp7FKFSBWFHA9K4IsD50VHUeAR/94mQ4xr28+j+2GaR57GIgUssL8gjMunEst ++3A7caoreyYn8xrC3PsXuKHqy6C0rtOUfnrQq8PsOC0RLoi/1D+tEjtCrI8Cbn3M +0V9hvqG8OmpI6iZVIhZdXw3/JzOfGAN0iltSIEdrRU0id4xVJ/CvHozJgyJUt5rQ +T9nO/NkuHJYosQLTA70lUhw0Zk8jq/R3gpYd0VcwCBEF/VfR2ccCAwEAAaNCMEAw +HQYDVR0OBBYEFGQUfPxYchamCik0FW8qy7z8r6irMA4GA1UdDwEB/wQEAwIBBjAP +BgNVHRMBAf8EBTADAQH/MA0GCSqGSIb3DQEBDAUAA4ICAQDcAiMI4u8hOscNtybS +YpOnpSNyByCCYN8Y11StaSWSntkUz5m5UoHPrmyKO1o5yGwBQ8IibQLwYs1OY0PA +FNr0Y/Dq9HHuTofjcan0yVflLl8cebsjqodEV+m9NU1Bu0soo5iyG9kLFwfl9+qd +9XbXv8S2gVj/yP9kaWJ5rW4OH3/uHWnlt3Jxs/6lATWUVCvAUm2PVcTJ0rjLyjQI +UYWg9by0F1jqClx6vWPGOi//lkkZhOpn2ASxYfQAW0q3nHE3GYV5v4GwxxMOdnE+ +OoAGrgYWp421wsTL/0ClXI2lyTrtcoHKXJg80jQDdwj98ClZXSEIx2C/pHF7uNke +gr4Jr2VvKKu/S7XuPghHJ6APbw+LP6yVGPO5DtxnVW5inkYO0QR4ynKudtml+LLf +iAlhi+8kTtFZP1rUPcmTPCtk9YENFpb3ksP+MW/oKjJ0DvRMmEoYDjBU1cXrvMUV +nuiZIesnKwkK2/HmcBhWuwzkvvnoEKQTkrgc4NtnHVMDpCKn3F2SEDzq//wbEBrD +2NCcnWXL0CsnMQMeNuE9dnUM/0Umud1RvCPHX9jYhxBAEg09ODfnRDwYwFMJZI// +1ZqmfHAuc1Uh6N//g7kdPjIe1qZ9LPFm6Vwdp6POXiUyK+OVrCoHzrQoeIY8Laad +TdJ0MN1kURXbg4NR16/9M51NZg== +-----END CERTIFICATE----- + +# Issuer: CN=Security Communication ECC RootCA1 O=SECOM Trust Systems CO.,LTD. +# Subject: CN=Security Communication ECC RootCA1 O=SECOM Trust Systems CO.,LTD. +# Label: "Security Communication ECC RootCA1" +# Serial: 15446673492073852651 +# MD5 Fingerprint: 7e:43:b0:92:68:ec:05:43:4c:98:ab:5d:35:2e:7e:86 +# SHA1 Fingerprint: b8:0e:26:a9:bf:d2:b2:3b:c0:ef:46:c9:ba:c7:bb:f6:1d:0d:41:41 +# SHA256 Fingerprint: e7:4f:bd:a5:5b:d5:64:c4:73:a3:6b:44:1a:a7:99:c8:a6:8e:07:74:40:e8:28:8b:9f:a1:e5:0e:4b:ba:ca:11 +-----BEGIN CERTIFICATE----- +MIICODCCAb6gAwIBAgIJANZdm7N4gS7rMAoGCCqGSM49BAMDMGExCzAJBgNVBAYT +AkpQMSUwIwYDVQQKExxTRUNPTSBUcnVzdCBTeXN0ZW1zIENPLixMVEQuMSswKQYD +VQQDEyJTZWN1cml0eSBDb21tdW5pY2F0aW9uIEVDQyBSb290Q0ExMB4XDTE2MDYx +NjA1MTUyOFoXDTM4MDExODA1MTUyOFowYTELMAkGA1UEBhMCSlAxJTAjBgNVBAoT +HFNFQ09NIFRydXN0IFN5c3RlbXMgQ08uLExURC4xKzApBgNVBAMTIlNlY3VyaXR5 +IENvbW11bmljYXRpb24gRUNDIFJvb3RDQTEwdjAQBgcqhkjOPQIBBgUrgQQAIgNi +AASkpW9gAwPDvTH00xecK4R1rOX9PVdu12O/5gSJko6BnOPpR27KkBLIE+Cnnfdl +dB9sELLo5OnvbYUymUSxXv3MdhDYW72ixvnWQuRXdtyQwjWpS4g8EkdtXP9JTxpK +ULGjQjBAMB0GA1UdDgQWBBSGHOf+LaVKiwj+KBH6vqNm+GBZLzAOBgNVHQ8BAf8E +BAMCAQYwDwYDVR0TAQH/BAUwAwEB/zAKBggqhkjOPQQDAwNoADBlAjAVXUI9/Lbu +9zuxNuie9sRGKEkz0FhDKmMpzE2xtHqiuQ04pV1IKv3LsnNdo4gIxwwCMQDAqy0O +be0YottT6SXbVQjgUMzfRGEWgqtJsLKB7HOHeLRMsmIbEvoWTSVLY70eN9k= +-----END CERTIFICATE----- + +# Issuer: CN=BJCA Global Root CA1 O=BEIJING CERTIFICATE AUTHORITY +# Subject: CN=BJCA Global Root CA1 O=BEIJING CERTIFICATE AUTHORITY +# Label: "BJCA Global Root CA1" +# Serial: 113562791157148395269083148143378328608 +# MD5 Fingerprint: 42:32:99:76:43:33:36:24:35:07:82:9b:28:f9:d0:90 +# SHA1 Fingerprint: d5:ec:8d:7b:4c:ba:79:f4:e7:e8:cb:9d:6b:ae:77:83:10:03:21:6a +# SHA256 Fingerprint: f3:89:6f:88:fe:7c:0a:88:27:66:a7:fa:6a:d2:74:9f:b5:7a:7f:3e:98:fb:76:9c:1f:a7:b0:9c:2c:44:d5:ae +-----BEGIN CERTIFICATE----- +MIIFdDCCA1ygAwIBAgIQVW9l47TZkGobCdFsPsBsIDANBgkqhkiG9w0BAQsFADBU +MQswCQYDVQQGEwJDTjEmMCQGA1UECgwdQkVJSklORyBDRVJUSUZJQ0FURSBBVVRI +T1JJVFkxHTAbBgNVBAMMFEJKQ0EgR2xvYmFsIFJvb3QgQ0ExMB4XDTE5MTIxOTAz +MTYxN1oXDTQ0MTIxMjAzMTYxN1owVDELMAkGA1UEBhMCQ04xJjAkBgNVBAoMHUJF +SUpJTkcgQ0VSVElGSUNBVEUgQVVUSE9SSVRZMR0wGwYDVQQDDBRCSkNBIEdsb2Jh +bCBSb290IENBMTCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBAPFmCL3Z +xRVhy4QEQaVpN3cdwbB7+sN3SJATcmTRuHyQNZ0YeYjjlwE8R4HyDqKYDZ4/N+AZ +spDyRhySsTphzvq3Rp4Dhtczbu33RYx2N95ulpH3134rhxfVizXuhJFyV9xgw8O5 +58dnJCNPYwpj9mZ9S1WnP3hkSWkSl+BMDdMJoDIwOvqfwPKcxRIqLhy1BDPapDgR +at7GGPZHOiJBhyL8xIkoVNiMpTAK+BcWyqw3/XmnkRd4OJmtWO2y3syJfQOcs4ll +5+M7sSKGjwZteAf9kRJ/sGsciQ35uMt0WwfCyPQ10WRjeulumijWML3mG90Vr4Tq +nMfK9Q7q8l0ph49pczm+LiRvRSGsxdRpJQaDrXpIhRMsDQa4bHlW/KNnMoH1V6XK +V0Jp6VwkYe/iMBhORJhVb3rCk9gZtt58R4oRTklH2yiUAguUSiz5EtBP6DF+bHq/ +pj+bOT0CFqMYs2esWz8sgytnOYFcuX6U1WTdno9uruh8W7TXakdI136z1C2OVnZO +z2nxbkRs1CTqjSShGL+9V/6pmTW12xB3uD1IutbB5/EjPtffhZ0nPNRAvQoMvfXn +jSXWgXSHRtQpdaJCbPdzied9v3pKH9MiyRVVz99vfFXQpIsHETdfg6YmV6YBW37+ +WGgHqel62bno/1Afq8K0wM7o6v0PvY1NuLxxAgMBAAGjQjBAMB0GA1UdDgQWBBTF +7+3M2I0hxkjk49cULqcWk+WYATAPBgNVHRMBAf8EBTADAQH/MA4GA1UdDwEB/wQE +AwIBBjANBgkqhkiG9w0BAQsFAAOCAgEAUoKsITQfI/Ki2Pm4rzc2IInRNwPWaZ+4 +YRC6ojGYWUfo0Q0lHhVBDOAqVdVXUsv45Mdpox1NcQJeXyFFYEhcCY5JEMEE3Kli +awLwQ8hOnThJdMkycFRtwUf8jrQ2ntScvd0g1lPJGKm1Vrl2i5VnZu69mP6u775u ++2D2/VnGKhs/I0qUJDAnyIm860Qkmss9vk/Ves6OF8tiwdneHg56/0OGNFK8YT88 +X7vZdrRTvJez/opMEi4r89fO4aL/3Xtw+zuhTaRjAv04l5U/BXCga99igUOLtFkN +SoxUnMW7gZ/NfaXvCyUeOiDbHPwfmGcCCtRzRBPbUYQaVQNW4AB+dAb/OMRyHdOo +P2gxXdMJxy6MW2Pg6Nwe0uxhHvLe5e/2mXZgLR6UcnHGCyoyx5JO1UbXHfmpGQrI ++pXObSOYqgs4rZpWDW+N8TEAiMEXnM0ZNjX+VVOg4DwzX5Ze4jLp3zO7Bkqp2IRz +znfSxqxx4VyjHQy7Ct9f4qNx2No3WqB4K/TUfet27fJhcKVlmtOJNBir+3I+17Q9 +eVzYH6Eze9mCUAyTF6ps3MKCuwJXNq+YJyo5UOGwifUll35HaBC07HPKs5fRJNz2 +YqAo07WjuGS3iGJCz51TzZm+ZGiPTx4SSPfSKcOYKMryMguTjClPPGAyzQWWYezy +r/6zcCwupvI= +-----END CERTIFICATE----- + +# Issuer: CN=BJCA Global Root CA2 O=BEIJING CERTIFICATE AUTHORITY +# Subject: CN=BJCA Global Root CA2 O=BEIJING CERTIFICATE AUTHORITY +# Label: "BJCA Global Root CA2" +# Serial: 58605626836079930195615843123109055211 +# MD5 Fingerprint: 5e:0a:f6:47:5f:a6:14:e8:11:01:95:3f:4d:01:eb:3c +# SHA1 Fingerprint: f4:27:86:eb:6e:b8:6d:88:31:67:02:fb:ba:66:a4:53:00:aa:7a:a6 +# SHA256 Fingerprint: 57:4d:f6:93:1e:27:80:39:66:7b:72:0a:fd:c1:60:0f:c2:7e:b6:6d:d3:09:29:79:fb:73:85:64:87:21:28:82 +-----BEGIN CERTIFICATE----- +MIICJTCCAaugAwIBAgIQLBcIfWQqwP6FGFkGz7RK6zAKBggqhkjOPQQDAzBUMQsw +CQYDVQQGEwJDTjEmMCQGA1UECgwdQkVJSklORyBDRVJUSUZJQ0FURSBBVVRIT1JJ +VFkxHTAbBgNVBAMMFEJKQ0EgR2xvYmFsIFJvb3QgQ0EyMB4XDTE5MTIxOTAzMTgy +MVoXDTQ0MTIxMjAzMTgyMVowVDELMAkGA1UEBhMCQ04xJjAkBgNVBAoMHUJFSUpJ +TkcgQ0VSVElGSUNBVEUgQVVUSE9SSVRZMR0wGwYDVQQDDBRCSkNBIEdsb2JhbCBS +b290IENBMjB2MBAGByqGSM49AgEGBSuBBAAiA2IABJ3LgJGNU2e1uVCxA/jlSR9B +IgmwUVJY1is0j8USRhTFiy8shP8sbqjV8QnjAyEUxEM9fMEsxEtqSs3ph+B99iK+ ++kpRuDCK/eHeGBIK9ke35xe/J4rUQUyWPGCWwf0VHKNCMEAwHQYDVR0OBBYEFNJK +sVF/BvDRgh9Obl+rg/xI1LCRMA8GA1UdEwEB/wQFMAMBAf8wDgYDVR0PAQH/BAQD +AgEGMAoGCCqGSM49BAMDA2gAMGUCMBq8W9f+qdJUDkpd0m2xQNz0Q9XSSpkZElaA +94M04TVOSG0ED1cxMDAtsaqdAzjbBgIxAMvMh1PLet8gUXOQwKhbYdDFUDn9hf7B +43j4ptZLvZuHjw/l1lOWqzzIQNph91Oj9w== +-----END CERTIFICATE----- + +# Issuer: CN=Sectigo Public Server Authentication Root E46 O=Sectigo Limited +# Subject: CN=Sectigo Public Server Authentication Root E46 O=Sectigo Limited +# Label: "Sectigo Public Server Authentication Root E46" +# Serial: 88989738453351742415770396670917916916 +# MD5 Fingerprint: 28:23:f8:b2:98:5c:37:16:3b:3e:46:13:4e:b0:b3:01 +# SHA1 Fingerprint: ec:8a:39:6c:40:f0:2e:bc:42:75:d4:9f:ab:1c:1a:5b:67:be:d2:9a +# SHA256 Fingerprint: c9:0f:26:f0:fb:1b:40:18:b2:22:27:51:9b:5c:a2:b5:3e:2c:a5:b3:be:5c:f1:8e:fe:1b:ef:47:38:0c:53:83 +-----BEGIN CERTIFICATE----- +MIICOjCCAcGgAwIBAgIQQvLM2htpN0RfFf51KBC49DAKBggqhkjOPQQDAzBfMQsw +CQYDVQQGEwJHQjEYMBYGA1UEChMPU2VjdGlnbyBMaW1pdGVkMTYwNAYDVQQDEy1T +ZWN0aWdvIFB1YmxpYyBTZXJ2ZXIgQXV0aGVudGljYXRpb24gUm9vdCBFNDYwHhcN +MjEwMzIyMDAwMDAwWhcNNDYwMzIxMjM1OTU5WjBfMQswCQYDVQQGEwJHQjEYMBYG +A1UEChMPU2VjdGlnbyBMaW1pdGVkMTYwNAYDVQQDEy1TZWN0aWdvIFB1YmxpYyBT +ZXJ2ZXIgQXV0aGVudGljYXRpb24gUm9vdCBFNDYwdjAQBgcqhkjOPQIBBgUrgQQA +IgNiAAR2+pmpbiDt+dd34wc7qNs9Xzjoq1WmVk/WSOrsfy2qw7LFeeyZYX8QeccC +WvkEN/U0NSt3zn8gj1KjAIns1aeibVvjS5KToID1AZTc8GgHHs3u/iVStSBDHBv+ +6xnOQ6OjQjBAMB0GA1UdDgQWBBTRItpMWfFLXyY4qp3W7usNw/upYTAOBgNVHQ8B +Af8EBAMCAYYwDwYDVR0TAQH/BAUwAwEB/zAKBggqhkjOPQQDAwNnADBkAjAn7qRa +qCG76UeXlImldCBteU/IvZNeWBj7LRoAasm4PdCkT0RHlAFWovgzJQxC36oCMB3q +4S6ILuH5px0CMk7yn2xVdOOurvulGu7t0vzCAxHrRVxgED1cf5kDW21USAGKcw== +-----END CERTIFICATE----- + +# Issuer: CN=Sectigo Public Server Authentication Root R46 O=Sectigo Limited +# Subject: CN=Sectigo Public Server Authentication Root R46 O=Sectigo Limited +# Label: "Sectigo Public Server Authentication Root R46" +# Serial: 156256931880233212765902055439220583700 +# MD5 Fingerprint: 32:10:09:52:00:d5:7e:6c:43:df:15:c0:b1:16:93:e5 +# SHA1 Fingerprint: ad:98:f9:f3:e4:7d:75:3b:65:d4:82:b3:a4:52:17:bb:6e:f5:e4:38 +# SHA256 Fingerprint: 7b:b6:47:a6:2a:ee:ac:88:bf:25:7a:a5:22:d0:1f:fe:a3:95:e0:ab:45:c7:3f:93:f6:56:54:ec:38:f2:5a:06 +-----BEGIN CERTIFICATE----- +MIIFijCCA3KgAwIBAgIQdY39i658BwD6qSWn4cetFDANBgkqhkiG9w0BAQwFADBf +MQswCQYDVQQGEwJHQjEYMBYGA1UEChMPU2VjdGlnbyBMaW1pdGVkMTYwNAYDVQQD +Ey1TZWN0aWdvIFB1YmxpYyBTZXJ2ZXIgQXV0aGVudGljYXRpb24gUm9vdCBSNDYw +HhcNMjEwMzIyMDAwMDAwWhcNNDYwMzIxMjM1OTU5WjBfMQswCQYDVQQGEwJHQjEY +MBYGA1UEChMPU2VjdGlnbyBMaW1pdGVkMTYwNAYDVQQDEy1TZWN0aWdvIFB1Ymxp +YyBTZXJ2ZXIgQXV0aGVudGljYXRpb24gUm9vdCBSNDYwggIiMA0GCSqGSIb3DQEB +AQUAA4ICDwAwggIKAoICAQCTvtU2UnXYASOgHEdCSe5jtrch/cSV1UgrJnwUUxDa +ef0rty2k1Cz66jLdScK5vQ9IPXtamFSvnl0xdE8H/FAh3aTPaE8bEmNtJZlMKpnz +SDBh+oF8HqcIStw+KxwfGExxqjWMrfhu6DtK2eWUAtaJhBOqbchPM8xQljeSM9xf +iOefVNlI8JhD1mb9nxc4Q8UBUQvX4yMPFF1bFOdLvt30yNoDN9HWOaEhUTCDsG3X +ME6WW5HwcCSrv0WBZEMNvSE6Lzzpng3LILVCJ8zab5vuZDCQOc2TZYEhMbUjUDM3 +IuM47fgxMMxF/mL50V0yeUKH32rMVhlATc6qu/m1dkmU8Sf4kaWD5QazYw6A3OAS +VYCmO2a0OYctyPDQ0RTp5A1NDvZdV3LFOxxHVp3i1fuBYYzMTYCQNFu31xR13NgE +SJ/AwSiItOkcyqex8Va3e0lMWeUgFaiEAin6OJRpmkkGj80feRQXEgyDet4fsZfu ++Zd4KKTIRJLpfSYFplhym3kT2BFfrsU4YjRosoYwjviQYZ4ybPUHNs2iTG7sijbt +8uaZFURww3y8nDnAtOFr94MlI1fZEoDlSfB1D++N6xybVCi0ITz8fAr/73trdf+L +HaAZBav6+CuBQug4urv7qv094PPK306Xlynt8xhW6aWWrL3DkJiy4Pmi1KZHQ3xt +zwIDAQABo0IwQDAdBgNVHQ4EFgQUVnNYZJX5khqwEioEYnmhQBWIIUkwDgYDVR0P +AQH/BAQDAgGGMA8GA1UdEwEB/wQFMAMBAf8wDQYJKoZIhvcNAQEMBQADggIBAC9c +mTz8Bl6MlC5w6tIyMY208FHVvArzZJ8HXtXBc2hkeqK5Duj5XYUtqDdFqij0lgVQ +YKlJfp/imTYpE0RHap1VIDzYm/EDMrraQKFz6oOht0SmDpkBm+S8f74TlH7Kph52 +gDY9hAaLMyZlbcp+nv4fjFg4exqDsQ+8FxG75gbMY/qB8oFM2gsQa6H61SilzwZA +Fv97fRheORKkU55+MkIQpiGRqRxOF3yEvJ+M0ejf5lG5Nkc/kLnHvALcWxxPDkjB +JYOcCj+esQMzEhonrPcibCTRAUH4WAP+JWgiH5paPHxsnnVI84HxZmduTILA7rpX +DhjvLpr3Etiga+kFpaHpaPi8TD8SHkXoUsCjvxInebnMMTzD9joiFgOgyY9mpFui +TdaBJQbpdqQACj7LzTWb4OE4y2BThihCQRxEV+ioratF4yUQvNs+ZUH7G6aXD+u5 +dHn5HrwdVw1Hr8Mvn4dGp+smWg9WY7ViYG4A++MnESLn/pmPNPW56MORcr3Ywx65 +LvKRRFHQV80MNNVIIb/bE/FmJUNS0nAiNs2fxBx1IK1jcmMGDw4nztJqDby1ORrp +0XZ60Vzk50lJLVU3aPAaOpg+VBeHVOmmJ1CJeyAvP/+/oYtKR5j/K3tJPsMpRmAY +QqszKbrAKbkTidOIijlBO8n9pu0f9GBj39ItVQGL +-----END CERTIFICATE----- + +# Issuer: CN=SSL.com TLS RSA Root CA 2022 O=SSL Corporation +# Subject: CN=SSL.com TLS RSA Root CA 2022 O=SSL Corporation +# Label: "SSL.com TLS RSA Root CA 2022" +# Serial: 148535279242832292258835760425842727825 +# MD5 Fingerprint: d8:4e:c6:59:30:d8:fe:a0:d6:7a:5a:2c:2c:69:78:da +# SHA1 Fingerprint: ec:2c:83:40:72:af:26:95:10:ff:0e:f2:03:ee:31:70:f6:78:9d:ca +# SHA256 Fingerprint: 8f:af:7d:2e:2c:b4:70:9b:b8:e0:b3:36:66:bf:75:a5:dd:45:b5:de:48:0f:8e:a8:d4:bf:e6:be:bc:17:f2:ed +-----BEGIN CERTIFICATE----- +MIIFiTCCA3GgAwIBAgIQb77arXO9CEDii02+1PdbkTANBgkqhkiG9w0BAQsFADBO +MQswCQYDVQQGEwJVUzEYMBYGA1UECgwPU1NMIENvcnBvcmF0aW9uMSUwIwYDVQQD +DBxTU0wuY29tIFRMUyBSU0EgUm9vdCBDQSAyMDIyMB4XDTIyMDgyNTE2MzQyMloX +DTQ2MDgxOTE2MzQyMVowTjELMAkGA1UEBhMCVVMxGDAWBgNVBAoMD1NTTCBDb3Jw +b3JhdGlvbjElMCMGA1UEAwwcU1NMLmNvbSBUTFMgUlNBIFJvb3QgQ0EgMjAyMjCC +AiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBANCkCXJPQIgSYT41I57u9nTP +L3tYPc48DRAokC+X94xI2KDYJbFMsBFMF3NQ0CJKY7uB0ylu1bUJPiYYf7ISf5OY +t6/wNr/y7hienDtSxUcZXXTzZGbVXcdotL8bHAajvI9AI7YexoS9UcQbOcGV0ins +S657Lb85/bRi3pZ7QcacoOAGcvvwB5cJOYF0r/c0WRFXCsJbwST0MXMwgsadugL3 +PnxEX4MN8/HdIGkWCVDi1FW24IBydm5MR7d1VVm0U3TZlMZBrViKMWYPHqIbKUBO +L9975hYsLfy/7PO0+r4Y9ptJ1O4Fbtk085zx7AGL0SDGD6C1vBdOSHtRwvzpXGk3 +R2azaPgVKPC506QVzFpPulJwoxJF3ca6TvvC0PeoUidtbnm1jPx7jMEWTO6Af77w +dr5BUxIzrlo4QqvXDz5BjXYHMtWrifZOZ9mxQnUjbvPNQrL8VfVThxc7wDNY8VLS ++YCk8OjwO4s4zKTGkH8PnP2L0aPP2oOnaclQNtVcBdIKQXTbYxE3waWglksejBYS +d66UNHsef8JmAOSqg+qKkK3ONkRN0VHpvB/zagX9wHQfJRlAUW7qglFA35u5CCoG +AtUjHBPW6dvbxrB6y3snm/vg1UYk7RBLY0ulBY+6uB0rpvqR4pJSvezrZ5dtmi2f +gTIFZzL7SAg/2SW4BCUvAgMBAAGjYzBhMA8GA1UdEwEB/wQFMAMBAf8wHwYDVR0j +BBgwFoAU+y437uOEeicuzRk1sTN8/9REQrkwHQYDVR0OBBYEFPsuN+7jhHonLs0Z +NbEzfP/UREK5MA4GA1UdDwEB/wQEAwIBhjANBgkqhkiG9w0BAQsFAAOCAgEAjYlt +hEUY8U+zoO9opMAdrDC8Z2awms22qyIZZtM7QbUQnRC6cm4pJCAcAZli05bg4vsM +QtfhWsSWTVTNj8pDU/0quOr4ZcoBwq1gaAafORpR2eCNJvkLTqVTJXojpBzOCBvf +R4iyrT7gJ4eLSYwfqUdYe5byiB0YrrPRpgqU+tvT5TgKa3kSM/tKWTcWQA673vWJ +DPFs0/dRa1419dvAJuoSc06pkZCmF8NsLzjUo3KUQyxi4U5cMj29TH0ZR6LDSeeW +P4+a0zvkEdiLA9z2tmBVGKaBUfPhqBVq6+AL8BQx1rmMRTqoENjwuSfr98t67wVy +lrXEj5ZzxOhWc5y8aVFjvO9nHEMaX3cZHxj4HCUp+UmZKbaSPaKDN7EgkaibMOlq +bLQjk2UEqxHzDh1TJElTHaE/nUiSEeJ9DU/1172iWD54nR4fK/4huxoTtrEoZP2w +AgDHbICivRZQIA9ygV/MlP+7mea6kMvq+cYMwq7FGc4zoWtcu358NFcXrfA/rs3q +r5nsLFR+jM4uElZI7xc7P0peYNLcdDa8pUNjyw9bowJWCZ4kLOGGgYz+qxcs+sji +Mho6/4UIyYOf8kpIEFR3N+2ivEC+5BB09+Rbu7nzifmPQdjH5FCQNYA+HLhNkNPU +98OwoX6EyneSMSy4kLGCenROmxMmtNVQZlR4rmA= +-----END CERTIFICATE----- + +# Issuer: CN=SSL.com TLS ECC Root CA 2022 O=SSL Corporation +# Subject: CN=SSL.com TLS ECC Root CA 2022 O=SSL Corporation +# Label: "SSL.com TLS ECC Root CA 2022" +# Serial: 26605119622390491762507526719404364228 +# MD5 Fingerprint: 99:d7:5c:f1:51:36:cc:e9:ce:d9:19:2e:77:71:56:c5 +# SHA1 Fingerprint: 9f:5f:d9:1a:54:6d:f5:0c:71:f0:ee:7a:bd:17:49:98:84:73:e2:39 +# SHA256 Fingerprint: c3:2f:fd:9f:46:f9:36:d1:6c:36:73:99:09:59:43:4b:9a:d6:0a:af:bb:9e:7c:f3:36:54:f1:44:cc:1b:a1:43 +-----BEGIN CERTIFICATE----- +MIICOjCCAcCgAwIBAgIQFAP1q/s3ixdAW+JDsqXRxDAKBggqhkjOPQQDAzBOMQsw +CQYDVQQGEwJVUzEYMBYGA1UECgwPU1NMIENvcnBvcmF0aW9uMSUwIwYDVQQDDBxT +U0wuY29tIFRMUyBFQ0MgUm9vdCBDQSAyMDIyMB4XDTIyMDgyNTE2MzM0OFoXDTQ2 +MDgxOTE2MzM0N1owTjELMAkGA1UEBhMCVVMxGDAWBgNVBAoMD1NTTCBDb3Jwb3Jh +dGlvbjElMCMGA1UEAwwcU1NMLmNvbSBUTFMgRUNDIFJvb3QgQ0EgMjAyMjB2MBAG +ByqGSM49AgEGBSuBBAAiA2IABEUpNXP6wrgjzhR9qLFNoFs27iosU8NgCTWyJGYm +acCzldZdkkAZDsalE3D07xJRKF3nzL35PIXBz5SQySvOkkJYWWf9lCcQZIxPBLFN +SeR7T5v15wj4A4j3p8OSSxlUgaNjMGEwDwYDVR0TAQH/BAUwAwEB/zAfBgNVHSME +GDAWgBSJjy+j6CugFFR781a4Jl9nOAuc0DAdBgNVHQ4EFgQUiY8vo+groBRUe/NW +uCZfZzgLnNAwDgYDVR0PAQH/BAQDAgGGMAoGCCqGSM49BAMDA2gAMGUCMFXjIlbp +15IkWE8elDIPDAI2wv2sdDJO4fscgIijzPvX6yv/N33w7deedWo1dlJF4AIxAMeN +b0Igj762TVntd00pxCAgRWSGOlDGxK0tk/UYfXLtqc/ErFc2KAhl3zx5Zn6g6g== +-----END CERTIFICATE----- + +# Issuer: CN=Atos TrustedRoot Root CA ECC TLS 2021 O=Atos +# Subject: CN=Atos TrustedRoot Root CA ECC TLS 2021 O=Atos +# Label: "Atos TrustedRoot Root CA ECC TLS 2021" +# Serial: 81873346711060652204712539181482831616 +# MD5 Fingerprint: 16:9f:ad:f1:70:ad:79:d6:ed:29:b4:d1:c5:79:70:a8 +# SHA1 Fingerprint: 9e:bc:75:10:42:b3:02:f3:81:f4:f7:30:62:d4:8f:c3:a7:51:b2:dd +# SHA256 Fingerprint: b2:fa:e5:3e:14:cc:d7:ab:92:12:06:47:01:ae:27:9c:1d:89:88:fa:cb:77:5f:a8:a0:08:91:4e:66:39:88:a8 +-----BEGIN CERTIFICATE----- +MIICFTCCAZugAwIBAgIQPZg7pmY9kGP3fiZXOATvADAKBggqhkjOPQQDAzBMMS4w +LAYDVQQDDCVBdG9zIFRydXN0ZWRSb290IFJvb3QgQ0EgRUNDIFRMUyAyMDIxMQ0w +CwYDVQQKDARBdG9zMQswCQYDVQQGEwJERTAeFw0yMTA0MjIwOTI2MjNaFw00MTA0 +MTcwOTI2MjJaMEwxLjAsBgNVBAMMJUF0b3MgVHJ1c3RlZFJvb3QgUm9vdCBDQSBF +Q0MgVExTIDIwMjExDTALBgNVBAoMBEF0b3MxCzAJBgNVBAYTAkRFMHYwEAYHKoZI +zj0CAQYFK4EEACIDYgAEloZYKDcKZ9Cg3iQZGeHkBQcfl+3oZIK59sRxUM6KDP/X +tXa7oWyTbIOiaG6l2b4siJVBzV3dscqDY4PMwL502eCdpO5KTlbgmClBk1IQ1SQ4 +AjJn8ZQSb+/Xxd4u/RmAo0IwQDAPBgNVHRMBAf8EBTADAQH/MB0GA1UdDgQWBBR2 +KCXWfeBmmnoJsmo7jjPXNtNPojAOBgNVHQ8BAf8EBAMCAYYwCgYIKoZIzj0EAwMD +aAAwZQIwW5kp85wxtolrbNa9d+F851F+uDrNozZffPc8dz7kUK2o59JZDCaOMDtu +CCrCp1rIAjEAmeMM56PDr9NJLkaCI2ZdyQAUEv049OGYa3cpetskz2VAv9LcjBHo +9H1/IISpQuQo +-----END CERTIFICATE----- + +# Issuer: CN=Atos TrustedRoot Root CA RSA TLS 2021 O=Atos +# Subject: CN=Atos TrustedRoot Root CA RSA TLS 2021 O=Atos +# Label: "Atos TrustedRoot Root CA RSA TLS 2021" +# Serial: 111436099570196163832749341232207667876 +# MD5 Fingerprint: d4:d3:46:b8:9a:c0:9c:76:5d:9e:3a:c3:b9:99:31:d2 +# SHA1 Fingerprint: 18:52:3b:0d:06:37:e4:d6:3a:df:23:e4:98:fb:5b:16:fb:86:74:48 +# SHA256 Fingerprint: 81:a9:08:8e:a5:9f:b3:64:c5:48:a6:f8:55:59:09:9b:6f:04:05:ef:bf:18:e5:32:4e:c9:f4:57:ba:00:11:2f +-----BEGIN CERTIFICATE----- +MIIFZDCCA0ygAwIBAgIQU9XP5hmTC/srBRLYwiqipDANBgkqhkiG9w0BAQwFADBM +MS4wLAYDVQQDDCVBdG9zIFRydXN0ZWRSb290IFJvb3QgQ0EgUlNBIFRMUyAyMDIx +MQ0wCwYDVQQKDARBdG9zMQswCQYDVQQGEwJERTAeFw0yMTA0MjIwOTIxMTBaFw00 +MTA0MTcwOTIxMDlaMEwxLjAsBgNVBAMMJUF0b3MgVHJ1c3RlZFJvb3QgUm9vdCBD +QSBSU0EgVExTIDIwMjExDTALBgNVBAoMBEF0b3MxCzAJBgNVBAYTAkRFMIICIjAN +BgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEAtoAOxHm9BYx9sKOdTSJNy/BBl01Z +4NH+VoyX8te9j2y3I49f1cTYQcvyAh5x5en2XssIKl4w8i1mx4QbZFc4nXUtVsYv +Ye+W/CBGvevUez8/fEc4BKkbqlLfEzfTFRVOvV98r61jx3ncCHvVoOX3W3WsgFWZ +kmGbzSoXfduP9LVq6hdKZChmFSlsAvFr1bqjM9xaZ6cF4r9lthawEO3NUDPJcFDs +GY6wx/J0W2tExn2WuZgIWWbeKQGb9Cpt0xU6kGpn8bRrZtkh68rZYnxGEFzedUln +nkL5/nWpo63/dgpnQOPF943HhZpZnmKaau1Fh5hnstVKPNe0OwANwI8f4UDErmwh +3El+fsqyjW22v5MvoVw+j8rtgI5Y4dtXz4U2OLJxpAmMkokIiEjxQGMYsluMWuPD +0xeqqxmjLBvk1cbiZnrXghmmOxYsL3GHX0WelXOTwkKBIROW1527k2gV+p2kHYzy +geBYBr3JtuP2iV2J+axEoctr+hbxx1A9JNr3w+SH1VbxT5Aw+kUJWdo0zuATHAR8 +ANSbhqRAvNncTFd+rrcztl524WWLZt+NyteYr842mIycg5kDcPOvdO3GDjbnvezB +c6eUWsuSZIKmAMFwoW4sKeFYV+xafJlrJaSQOoD0IJ2azsct+bJLKZWD6TWNp0lI +pw9MGZHQ9b8Q4HECAwEAAaNCMEAwDwYDVR0TAQH/BAUwAwEB/zAdBgNVHQ4EFgQU +dEmZ0f+0emhFdcN+tNzMzjkz2ggwDgYDVR0PAQH/BAQDAgGGMA0GCSqGSIb3DQEB +DAUAA4ICAQAjQ1MkYlxt/T7Cz1UAbMVWiLkO3TriJQ2VSpfKgInuKs1l+NsW4AmS +4BjHeJi78+xCUvuppILXTdiK/ORO/auQxDh1MoSf/7OwKwIzNsAQkG8dnK/haZPs +o0UvFJ/1TCplQ3IM98P4lYsU84UgYt1UU90s3BiVaU+DR3BAM1h3Egyi61IxHkzJ +qM7F78PRreBrAwA0JrRUITWXAdxfG/F851X6LWh3e9NpzNMOa7pNdkTWwhWaJuyw +xfW70Xp0wmzNxbVe9kzmWy2B27O3Opee7c9GslA9hGCZcbUztVdF5kJHdWoOsAgM +rr3e97sPWD2PAzHoPYJQyi9eDF20l74gNAf0xBLh7tew2VktafcxBPTy+av5EzH4 +AXcOPUIjJsyacmdRIXrMPIWo6iFqO9taPKU0nprALN+AnCng33eU0aKAQv9qTFsR +0PXNor6uzFFcw9VUewyu1rkGd4Di7wcaaMxZUa1+XGdrudviB0JbuAEFWDlN5LuY +o7Ey7Nmj1m+UI/87tyll5gfp77YZ6ufCOB0yiJA8EytuzO+rdwY0d4RPcuSBhPm5 +dDTedk+SKlOxJTnbPP/lPqYO5Wue/9vsL3SD3460s6neFE3/MaNFcyT6lSnMEpcE +oji2jbDwN/zIIX8/syQbPYtuzE2wFg2WHYMfRsCbvUOZ58SWLs5fyQ== +-----END CERTIFICATE----- + +# Issuer: CN=TrustAsia Global Root CA G3 O=TrustAsia Technologies, Inc. +# Subject: CN=TrustAsia Global Root CA G3 O=TrustAsia Technologies, Inc. +# Label: "TrustAsia Global Root CA G3" +# Serial: 576386314500428537169965010905813481816650257167 +# MD5 Fingerprint: 30:42:1b:b7:bb:81:75:35:e4:16:4f:53:d2:94:de:04 +# SHA1 Fingerprint: 63:cf:b6:c1:27:2b:56:e4:88:8e:1c:23:9a:b6:2e:81:47:24:c3:c7 +# SHA256 Fingerprint: e0:d3:22:6a:eb:11:63:c2:e4:8f:f9:be:3b:50:b4:c6:43:1b:e7:bb:1e:ac:c5:c3:6b:5d:5e:c5:09:03:9a:08 +-----BEGIN CERTIFICATE----- +MIIFpTCCA42gAwIBAgIUZPYOZXdhaqs7tOqFhLuxibhxkw8wDQYJKoZIhvcNAQEM +BQAwWjELMAkGA1UEBhMCQ04xJTAjBgNVBAoMHFRydXN0QXNpYSBUZWNobm9sb2dp +ZXMsIEluYy4xJDAiBgNVBAMMG1RydXN0QXNpYSBHbG9iYWwgUm9vdCBDQSBHMzAe +Fw0yMTA1MjAwMjEwMTlaFw00NjA1MTkwMjEwMTlaMFoxCzAJBgNVBAYTAkNOMSUw +IwYDVQQKDBxUcnVzdEFzaWEgVGVjaG5vbG9naWVzLCBJbmMuMSQwIgYDVQQDDBtU +cnVzdEFzaWEgR2xvYmFsIFJvb3QgQ0EgRzMwggIiMA0GCSqGSIb3DQEBAQUAA4IC +DwAwggIKAoICAQDAMYJhkuSUGwoqZdC+BqmHO1ES6nBBruL7dOoKjbmzTNyPtxNS +T1QY4SxzlZHFZjtqz6xjbYdT8PfxObegQ2OwxANdV6nnRM7EoYNl9lA+sX4WuDqK +AtCWHwDNBSHvBm3dIZwZQ0WhxeiAysKtQGIXBsaqvPPW5vxQfmZCHzyLpnl5hkA1 +nyDvP+uLRx+PjsXUjrYsyUQE49RDdT/VP68czH5GX6zfZBCK70bwkPAPLfSIC7Ep +qq+FqklYqL9joDiR5rPmd2jE+SoZhLsO4fWvieylL1AgdB4SQXMeJNnKziyhWTXA +yB1GJ2Faj/lN03J5Zh6fFZAhLf3ti1ZwA0pJPn9pMRJpxx5cynoTi+jm9WAPzJMs +hH/x/Gr8m0ed262IPfN2dTPXS6TIi/n1Q1hPy8gDVI+lhXgEGvNz8teHHUGf59gX +zhqcD0r83ERoVGjiQTz+LISGNzzNPy+i2+f3VANfWdP3kXjHi3dqFuVJhZBFcnAv +kV34PmVACxmZySYgWmjBNb9Pp1Hx2BErW+Canig7CjoKH8GB5S7wprlppYiU5msT +f9FkPz2ccEblooV7WIQn3MSAPmeamseaMQ4w7OYXQJXZRe0Blqq/DPNL0WP3E1jA +uPP6Z92bfW1K/zJMtSU7/xxnD4UiWQWRkUF3gdCFTIcQcf+eQxuulXUtgQIDAQAB +o2MwYTAPBgNVHRMBAf8EBTADAQH/MB8GA1UdIwQYMBaAFEDk5PIj7zjKsK5Xf/Ih +MBY027ySMB0GA1UdDgQWBBRA5OTyI+84yrCuV3/yITAWNNu8kjAOBgNVHQ8BAf8E +BAMCAQYwDQYJKoZIhvcNAQEMBQADggIBACY7UeFNOPMyGLS0XuFlXsSUT9SnYaP4 +wM8zAQLpw6o1D/GUE3d3NZ4tVlFEbuHGLige/9rsR82XRBf34EzC4Xx8MnpmyFq2 +XFNFV1pF1AWZLy4jVe5jaN/TG3inEpQGAHUNcoTpLrxaatXeL1nHo+zSh2bbt1S1 +JKv0Q3jbSwTEb93mPmY+KfJLaHEih6D4sTNjduMNhXJEIlU/HHzp/LgV6FL6qj6j +ITk1dImmasI5+njPtqzn59ZW/yOSLlALqbUHM/Q4X6RJpstlcHboCoWASzY9M/eV +VHUl2qzEc4Jl6VL1XP04lQJqaTDFHApXB64ipCz5xUG3uOyfT0gA+QEEVcys+TIx +xHWVBqB/0Y0n3bOppHKH/lmLmnp0Ft0WpWIp6zqW3IunaFnT63eROfjXy9mPX1on +AX1daBli2MjN9LdyR75bl87yraKZk62Uy5P2EgmVtqvXO9A/EcswFi55gORngS1d +7XB4tmBZrOFdRWOPyN9yaFvqHbgB8X7754qz41SgOAngPN5C8sLtLpvzHzW2Ntjj +gKGLzZlkD8Kqq7HK9W+eQ42EVJmzbsASZthwEPEGNTNDqJwuuhQxzhB/HIbjj9LV ++Hfsm6vxL2PZQl/gZ4FkkfGXL/xuJvYz+NO1+MRiqzFRJQJ6+N1rZdVtTTDIZbpo +FGWsJwt0ivKH +-----END CERTIFICATE----- + +# Issuer: CN=TrustAsia Global Root CA G4 O=TrustAsia Technologies, Inc. +# Subject: CN=TrustAsia Global Root CA G4 O=TrustAsia Technologies, Inc. +# Label: "TrustAsia Global Root CA G4" +# Serial: 451799571007117016466790293371524403291602933463 +# MD5 Fingerprint: 54:dd:b2:d7:5f:d8:3e:ed:7c:e0:0b:2e:cc:ed:eb:eb +# SHA1 Fingerprint: 57:73:a5:61:5d:80:b2:e6:ac:38:82:fc:68:07:31:ac:9f:b5:92:5a +# SHA256 Fingerprint: be:4b:56:cb:50:56:c0:13:6a:52:6d:f4:44:50:8d:aa:36:a0:b5:4f:42:e4:ac:38:f7:2a:f4:70:e4:79:65:4c +-----BEGIN CERTIFICATE----- +MIICVTCCAdygAwIBAgIUTyNkuI6XY57GU4HBdk7LKnQV1tcwCgYIKoZIzj0EAwMw +WjELMAkGA1UEBhMCQ04xJTAjBgNVBAoMHFRydXN0QXNpYSBUZWNobm9sb2dpZXMs +IEluYy4xJDAiBgNVBAMMG1RydXN0QXNpYSBHbG9iYWwgUm9vdCBDQSBHNDAeFw0y +MTA1MjAwMjEwMjJaFw00NjA1MTkwMjEwMjJaMFoxCzAJBgNVBAYTAkNOMSUwIwYD +VQQKDBxUcnVzdEFzaWEgVGVjaG5vbG9naWVzLCBJbmMuMSQwIgYDVQQDDBtUcnVz +dEFzaWEgR2xvYmFsIFJvb3QgQ0EgRzQwdjAQBgcqhkjOPQIBBgUrgQQAIgNiAATx +s8045CVD5d4ZCbuBeaIVXxVjAd7Cq92zphtnS4CDr5nLrBfbK5bKfFJV4hrhPVbw +LxYI+hW8m7tH5j/uqOFMjPXTNvk4XatwmkcN4oFBButJ+bAp3TPsUKV/eSm4IJij +YzBhMA8GA1UdEwEB/wQFMAMBAf8wHwYDVR0jBBgwFoAUpbtKl86zK3+kMd6Xg1mD +pm9xy94wHQYDVR0OBBYEFKW7SpfOsyt/pDHel4NZg6ZvccveMA4GA1UdDwEB/wQE +AwIBBjAKBggqhkjOPQQDAwNnADBkAjBe8usGzEkxn0AAbbd+NvBNEU/zy4k6LHiR +UKNbwMp1JvK/kF0LgoxgKJ/GcJpo5PECMFxYDlZ2z1jD1xCMuo6u47xkdUfFVZDj +/bpV6wfEU6s3qe4hsiFbYI89MvHVI5TWWA== +-----END CERTIFICATE----- + +# Issuer: CN=CommScope Public Trust ECC Root-01 O=CommScope +# Subject: CN=CommScope Public Trust ECC Root-01 O=CommScope +# Label: "CommScope Public Trust ECC Root-01" +# Serial: 385011430473757362783587124273108818652468453534 +# MD5 Fingerprint: 3a:40:a7:fc:03:8c:9c:38:79:2f:3a:a2:6c:b6:0a:16 +# SHA1 Fingerprint: 07:86:c0:d8:dd:8e:c0:80:98:06:98:d0:58:7a:ef:de:a6:cc:a2:5d +# SHA256 Fingerprint: 11:43:7c:da:7b:b4:5e:41:36:5f:45:b3:9a:38:98:6b:0d:e0:0d:ef:34:8e:0c:7b:b0:87:36:33:80:0b:c3:8b +-----BEGIN CERTIFICATE----- +MIICHTCCAaOgAwIBAgIUQ3CCd89NXTTxyq4yLzf39H91oJ4wCgYIKoZIzj0EAwMw +TjELMAkGA1UEBhMCVVMxEjAQBgNVBAoMCUNvbW1TY29wZTErMCkGA1UEAwwiQ29t +bVNjb3BlIFB1YmxpYyBUcnVzdCBFQ0MgUm9vdC0wMTAeFw0yMTA0MjgxNzM1NDNa +Fw00NjA0MjgxNzM1NDJaME4xCzAJBgNVBAYTAlVTMRIwEAYDVQQKDAlDb21tU2Nv +cGUxKzApBgNVBAMMIkNvbW1TY29wZSBQdWJsaWMgVHJ1c3QgRUNDIFJvb3QtMDEw +djAQBgcqhkjOPQIBBgUrgQQAIgNiAARLNumuV16ocNfQj3Rid8NeeqrltqLxeP0C +flfdkXmcbLlSiFS8LwS+uM32ENEp7LXQoMPwiXAZu1FlxUOcw5tjnSCDPgYLpkJE +hRGnSjot6dZoL0hOUysHP029uax3OVejQjBAMA8GA1UdEwEB/wQFMAMBAf8wDgYD +VR0PAQH/BAQDAgEGMB0GA1UdDgQWBBSOB2LAUN3GGQYARnQE9/OufXVNMDAKBggq +hkjOPQQDAwNoADBlAjEAnDPfQeMjqEI2Jpc1XHvr20v4qotzVRVcrHgpD7oh2MSg +2NED3W3ROT3Ek2DS43KyAjB8xX6I01D1HiXo+k515liWpDVfG2XqYZpwI7UNo5uS +Um9poIyNStDuiw7LR47QjRE= +-----END CERTIFICATE----- + +# Issuer: CN=CommScope Public Trust ECC Root-02 O=CommScope +# Subject: CN=CommScope Public Trust ECC Root-02 O=CommScope +# Label: "CommScope Public Trust ECC Root-02" +# Serial: 234015080301808452132356021271193974922492992893 +# MD5 Fingerprint: 59:b0:44:d5:65:4d:b8:5c:55:19:92:02:b6:d1:94:b2 +# SHA1 Fingerprint: 3c:3f:ef:57:0f:fe:65:93:86:9e:a0:fe:b0:f6:ed:8e:d1:13:c7:e5 +# SHA256 Fingerprint: 2f:fb:7f:81:3b:bb:b3:c8:9a:b4:e8:16:2d:0f:16:d7:15:09:a8:30:cc:9d:73:c2:62:e5:14:08:75:d1:ad:4a +-----BEGIN CERTIFICATE----- +MIICHDCCAaOgAwIBAgIUKP2ZYEFHpgE6yhR7H+/5aAiDXX0wCgYIKoZIzj0EAwMw +TjELMAkGA1UEBhMCVVMxEjAQBgNVBAoMCUNvbW1TY29wZTErMCkGA1UEAwwiQ29t +bVNjb3BlIFB1YmxpYyBUcnVzdCBFQ0MgUm9vdC0wMjAeFw0yMTA0MjgxNzQ0NTRa +Fw00NjA0MjgxNzQ0NTNaME4xCzAJBgNVBAYTAlVTMRIwEAYDVQQKDAlDb21tU2Nv +cGUxKzApBgNVBAMMIkNvbW1TY29wZSBQdWJsaWMgVHJ1c3QgRUNDIFJvb3QtMDIw +djAQBgcqhkjOPQIBBgUrgQQAIgNiAAR4MIHoYx7l63FRD/cHB8o5mXxO1Q/MMDAL +j2aTPs+9xYa9+bG3tD60B8jzljHz7aRP+KNOjSkVWLjVb3/ubCK1sK9IRQq9qEmU +v4RDsNuESgMjGWdqb8FuvAY5N9GIIvejQjBAMA8GA1UdEwEB/wQFMAMBAf8wDgYD +VR0PAQH/BAQDAgEGMB0GA1UdDgQWBBTmGHX/72DehKT1RsfeSlXjMjZ59TAKBggq +hkjOPQQDAwNnADBkAjAmc0l6tqvmSfR9Uj/UQQSugEODZXW5hYA4O9Zv5JOGq4/n +ich/m35rChJVYaoR4HkCMHfoMXGsPHED1oQmHhS48zs73u1Z/GtMMH9ZzkXpc2AV +mkzw5l4lIhVtwodZ0LKOag== +-----END CERTIFICATE----- + +# Issuer: CN=CommScope Public Trust RSA Root-01 O=CommScope +# Subject: CN=CommScope Public Trust RSA Root-01 O=CommScope +# Label: "CommScope Public Trust RSA Root-01" +# Serial: 354030733275608256394402989253558293562031411421 +# MD5 Fingerprint: 0e:b4:15:bc:87:63:5d:5d:02:73:d4:26:38:68:73:d8 +# SHA1 Fingerprint: 6d:0a:5f:f7:b4:23:06:b4:85:b3:b7:97:64:fc:ac:75:f5:33:f2:93 +# SHA256 Fingerprint: 02:bd:f9:6e:2a:45:dd:9b:f1:8f:c7:e1:db:df:21:a0:37:9b:a3:c9:c2:61:03:44:cf:d8:d6:06:fe:c1:ed:81 +-----BEGIN CERTIFICATE----- +MIIFbDCCA1SgAwIBAgIUPgNJgXUWdDGOTKvVxZAplsU5EN0wDQYJKoZIhvcNAQEL +BQAwTjELMAkGA1UEBhMCVVMxEjAQBgNVBAoMCUNvbW1TY29wZTErMCkGA1UEAwwi +Q29tbVNjb3BlIFB1YmxpYyBUcnVzdCBSU0EgUm9vdC0wMTAeFw0yMTA0MjgxNjQ1 +NTRaFw00NjA0MjgxNjQ1NTNaME4xCzAJBgNVBAYTAlVTMRIwEAYDVQQKDAlDb21t +U2NvcGUxKzApBgNVBAMMIkNvbW1TY29wZSBQdWJsaWMgVHJ1c3QgUlNBIFJvb3Qt +MDEwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQCwSGWjDR1C45FtnYSk +YZYSwu3D2iM0GXb26v1VWvZVAVMP8syMl0+5UMuzAURWlv2bKOx7dAvnQmtVzslh +suitQDy6uUEKBU8bJoWPQ7VAtYXR1HHcg0Hz9kXHgKKEUJdGzqAMxGBWBB0HW0al +DrJLpA6lfO741GIDuZNqihS4cPgugkY4Iw50x2tBt9Apo52AsH53k2NC+zSDO3Oj +WiE260f6GBfZumbCk6SP/F2krfxQapWsvCQz0b2If4b19bJzKo98rwjyGpg/qYFl +P8GMicWWMJoKz/TUyDTtnS+8jTiGU+6Xn6myY5QXjQ/cZip8UlF1y5mO6D1cv547 +KI2DAg+pn3LiLCuz3GaXAEDQpFSOm117RTYm1nJD68/A6g3czhLmfTifBSeolz7p +UcZsBSjBAg/pGG3svZwG1KdJ9FQFa2ww8esD1eo9anbCyxooSU1/ZOD6K9pzg4H/ +kQO9lLvkuI6cMmPNn7togbGEW682v3fuHX/3SZtS7NJ3Wn2RnU3COS3kuoL4b/JO +Hg9O5j9ZpSPcPYeoKFgo0fEbNttPxP/hjFtyjMcmAyejOQoBqsCyMWCDIqFPEgkB +Ea801M/XrmLTBQe0MXXgDW1XT2mH+VepuhX2yFJtocucH+X8eKg1mp9BFM6ltM6U +CBwJrVbl2rZJmkrqYxhTnCwuwwIDAQABo0IwQDAPBgNVHRMBAf8EBTADAQH/MA4G +A1UdDwEB/wQEAwIBBjAdBgNVHQ4EFgQUN12mmnQywsL5x6YVEFm45P3luG0wDQYJ +KoZIhvcNAQELBQADggIBAK+nz97/4L1CjU3lIpbfaOp9TSp90K09FlxD533Ahuh6 +NWPxzIHIxgvoLlI1pKZJkGNRrDSsBTtXAOnTYtPZKdVUvhwQkZyybf5Z/Xn36lbQ +nmhUQo8mUuJM3y+Xpi/SB5io82BdS5pYV4jvguX6r2yBS5KPQJqTRlnLX3gWsWc+ +QgvfKNmwrZggvkN80V4aCRckjXtdlemrwWCrWxhkgPut4AZ9HcpZuPN4KWfGVh2v +trV0KnahP/t1MJ+UXjulYPPLXAziDslg+MkfFoom3ecnf+slpoq9uC02EJqxWE2a +aE9gVOX2RhOOiKy8IUISrcZKiX2bwdgt6ZYD9KJ0DLwAHb/WNyVntHKLr4W96ioD +j8z7PEQkguIBpQtZtjSNMgsSDesnwv1B10A8ckYpwIzqug/xBpMu95yo9GA+o/E4 +Xo4TwbM6l4c/ksp4qRyv0LAbJh6+cOx69TOY6lz/KwsETkPdY34Op054A5U+1C0w +lREQKC6/oAI+/15Z0wUOlV9TRe9rh9VIzRamloPh37MG88EU26fsHItdkJANclHn +YfkUyq+Dj7+vsQpZXdxc1+SWrVtgHdqul7I52Qb1dgAT+GhMIbA1xNxVssnBQVoc +icCMb3SgazNNtQEo/a2tiRc7ppqEvOuM6sRxJKi6KfkIsidWNTJf6jn7MZrVGczw +-----END CERTIFICATE----- + +# Issuer: CN=CommScope Public Trust RSA Root-02 O=CommScope +# Subject: CN=CommScope Public Trust RSA Root-02 O=CommScope +# Label: "CommScope Public Trust RSA Root-02" +# Serial: 480062499834624527752716769107743131258796508494 +# MD5 Fingerprint: e1:29:f9:62:7b:76:e2:96:6d:f3:d4:d7:0f:ae:1f:aa +# SHA1 Fingerprint: ea:b0:e2:52:1b:89:93:4c:11:68:f2:d8:9a:ac:22:4c:a3:8a:57:ae +# SHA256 Fingerprint: ff:e9:43:d7:93:42:4b:4f:7c:44:0c:1c:3d:64:8d:53:63:f3:4b:82:dc:87:aa:7a:9f:11:8f:c5:de:e1:01:f1 +-----BEGIN CERTIFICATE----- +MIIFbDCCA1SgAwIBAgIUVBa/O345lXGN0aoApYYNK496BU4wDQYJKoZIhvcNAQEL +BQAwTjELMAkGA1UEBhMCVVMxEjAQBgNVBAoMCUNvbW1TY29wZTErMCkGA1UEAwwi +Q29tbVNjb3BlIFB1YmxpYyBUcnVzdCBSU0EgUm9vdC0wMjAeFw0yMTA0MjgxNzE2 +NDNaFw00NjA0MjgxNzE2NDJaME4xCzAJBgNVBAYTAlVTMRIwEAYDVQQKDAlDb21t +U2NvcGUxKzApBgNVBAMMIkNvbW1TY29wZSBQdWJsaWMgVHJ1c3QgUlNBIFJvb3Qt +MDIwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQDh+g77aAASyE3VrCLE +NQE7xVTlWXZjpX/rwcRqmL0yjReA61260WI9JSMZNRTpf4mnG2I81lDnNJUDMrG0 +kyI9p+Kx7eZ7Ti6Hmw0zdQreqjXnfuU2mKKuJZ6VszKWpCtYHu8//mI0SFHRtI1C +rWDaSWqVcN3SAOLMV2MCe5bdSZdbkk6V0/nLKR8YSvgBKtJjCW4k6YnS5cciTNxz +hkcAqg2Ijq6FfUrpuzNPDlJwnZXjfG2WWy09X6GDRl224yW4fKcZgBzqZUPckXk2 +LHR88mcGyYnJ27/aaL8j7dxrrSiDeS/sOKUNNwFnJ5rpM9kzXzehxfCrPfp4sOcs +n/Y+n2Dg70jpkEUeBVF4GiwSLFworA2iI540jwXmojPOEXcT1A6kHkIfhs1w/tku +FT0du7jyU1fbzMZ0KZwYszZ1OC4PVKH4kh+Jlk+71O6d6Ts2QrUKOyrUZHk2EOH5 +kQMreyBUzQ0ZGshBMjTRsJnhkB4BQDa1t/qp5Xd1pCKBXbCL5CcSD1SIxtuFdOa3 +wNemKfrb3vOTlycEVS8KbzfFPROvCgCpLIscgSjX74Yxqa7ybrjKaixUR9gqiC6v +wQcQeKwRoi9C8DfF8rhW3Q5iLc4tVn5V8qdE9isy9COoR+jUKgF4z2rDN6ieZdIs +5fq6M8EGRPbmz6UNp2YINIos8wIDAQABo0IwQDAPBgNVHRMBAf8EBTADAQH/MA4G +A1UdDwEB/wQEAwIBBjAdBgNVHQ4EFgQUR9DnsSL/nSz12Vdgs7GxcJXvYXowDQYJ +KoZIhvcNAQELBQADggIBAIZpsU0v6Z9PIpNojuQhmaPORVMbc0RTAIFhzTHjCLqB +KCh6krm2qMhDnscTJk3C2OVVnJJdUNjCK9v+5qiXz1I6JMNlZFxHMaNlNRPDk7n3 ++VGXu6TwYofF1gbTl4MgqX67tiHCpQ2EAOHyJxCDut0DgdXdaMNmEMjRdrSzbyme +APnCKfWxkxlSaRosTKCL4BWaMS/TiJVZbuXEs1DIFAhKm4sTg7GkcrI7djNB3Nyq +pgdvHSQSn8h2vS/ZjvQs7rfSOBAkNlEv41xdgSGn2rtO/+YHqP65DSdsu3BaVXoT +6fEqSWnHX4dXTEN5bTpl6TBcQe7rd6VzEojov32u5cSoHw2OHG1QAk8mGEPej1WF +sQs3BWDJVTkSBKEqz3EWnzZRSb9wO55nnPt7eck5HHisd5FUmrh1CoFSl+NmYWvt +PjgelmFV4ZFUjO2MJB+ByRCac5krFk5yAD9UG/iNuovnFNa2RU9g7Jauwy8CTl2d +lklyALKrdVwPaFsdZcJfMw8eD/A7hvWwTruc9+olBdytoptLFwG+Qt81IR2tq670 +v64fG9PiO/yzcnMcmyiQiRM9HcEARwmWmjgb3bHPDcK0RPOWlc4yOo80nOAXx17O +rg3bhzjlP1v9mxnhMUF6cKojawHhRUzNlM47ni3niAIi9G7oyOzWPPO5std3eqx7 +-----END CERTIFICATE----- + +# Issuer: CN=Telekom Security TLS ECC Root 2020 O=Deutsche Telekom Security GmbH +# Subject: CN=Telekom Security TLS ECC Root 2020 O=Deutsche Telekom Security GmbH +# Label: "Telekom Security TLS ECC Root 2020" +# Serial: 72082518505882327255703894282316633856 +# MD5 Fingerprint: c1:ab:fe:6a:10:2c:03:8d:bc:1c:22:32:c0:85:a7:fd +# SHA1 Fingerprint: c0:f8:96:c5:a9:3b:01:06:21:07:da:18:42:48:bc:e9:9d:88:d5:ec +# SHA256 Fingerprint: 57:8a:f4:de:d0:85:3f:4e:59:98:db:4a:ea:f9:cb:ea:8d:94:5f:60:b6:20:a3:8d:1a:3c:13:b2:bc:7b:a8:e1 +-----BEGIN CERTIFICATE----- +MIICQjCCAcmgAwIBAgIQNjqWjMlcsljN0AFdxeVXADAKBggqhkjOPQQDAzBjMQsw +CQYDVQQGEwJERTEnMCUGA1UECgweRGV1dHNjaGUgVGVsZWtvbSBTZWN1cml0eSBH +bWJIMSswKQYDVQQDDCJUZWxla29tIFNlY3VyaXR5IFRMUyBFQ0MgUm9vdCAyMDIw +MB4XDTIwMDgyNTA3NDgyMFoXDTQ1MDgyNTIzNTk1OVowYzELMAkGA1UEBhMCREUx +JzAlBgNVBAoMHkRldXRzY2hlIFRlbGVrb20gU2VjdXJpdHkgR21iSDErMCkGA1UE +AwwiVGVsZWtvbSBTZWN1cml0eSBUTFMgRUNDIFJvb3QgMjAyMDB2MBAGByqGSM49 +AgEGBSuBBAAiA2IABM6//leov9Wq9xCazbzREaK9Z0LMkOsVGJDZos0MKiXrPk/O +tdKPD/M12kOLAoC+b1EkHQ9rK8qfwm9QMuU3ILYg/4gND21Ju9sGpIeQkpT0CdDP +f8iAC8GXs7s1J8nCG6NCMEAwHQYDVR0OBBYEFONyzG6VmUex5rNhTNHLq+O6zd6f +MA8GA1UdEwEB/wQFMAMBAf8wDgYDVR0PAQH/BAQDAgEGMAoGCCqGSM49BAMDA2cA +MGQCMHVSi7ekEE+uShCLsoRbQuHmKjYC2qBuGT8lv9pZMo7k+5Dck2TOrbRBR2Di +z6fLHgIwN0GMZt9Ba9aDAEH9L1r3ULRn0SyocddDypwnJJGDSA3PzfdUga/sf+Rn +27iQ7t0l +-----END CERTIFICATE----- + +# Issuer: CN=Telekom Security TLS RSA Root 2023 O=Deutsche Telekom Security GmbH +# Subject: CN=Telekom Security TLS RSA Root 2023 O=Deutsche Telekom Security GmbH +# Label: "Telekom Security TLS RSA Root 2023" +# Serial: 44676229530606711399881795178081572759 +# MD5 Fingerprint: bf:5b:eb:54:40:cd:48:71:c4:20:8d:7d:de:0a:42:f2 +# SHA1 Fingerprint: 54:d3:ac:b3:bd:57:56:f6:85:9d:ce:e5:c3:21:e2:d4:ad:83:d0:93 +# SHA256 Fingerprint: ef:c6:5c:ad:bb:59:ad:b6:ef:e8:4d:a2:23:11:b3:56:24:b7:1b:3b:1e:a0:da:8b:66:55:17:4e:c8:97:86:46 +-----BEGIN CERTIFICATE----- +MIIFszCCA5ugAwIBAgIQIZxULej27HF3+k7ow3BXlzANBgkqhkiG9w0BAQwFADBj +MQswCQYDVQQGEwJERTEnMCUGA1UECgweRGV1dHNjaGUgVGVsZWtvbSBTZWN1cml0 +eSBHbWJIMSswKQYDVQQDDCJUZWxla29tIFNlY3VyaXR5IFRMUyBSU0EgUm9vdCAy +MDIzMB4XDTIzMDMyODEyMTY0NVoXDTQ4MDMyNzIzNTk1OVowYzELMAkGA1UEBhMC +REUxJzAlBgNVBAoMHkRldXRzY2hlIFRlbGVrb20gU2VjdXJpdHkgR21iSDErMCkG +A1UEAwwiVGVsZWtvbSBTZWN1cml0eSBUTFMgUlNBIFJvb3QgMjAyMzCCAiIwDQYJ +KoZIhvcNAQEBBQADggIPADCCAgoCggIBAO01oYGA88tKaVvC+1GDrib94W7zgRJ9 +cUD/h3VCKSHtgVIs3xLBGYSJwb3FKNXVS2xE1kzbB5ZKVXrKNoIENqil/Cf2SfHV +cp6R+SPWcHu79ZvB7JPPGeplfohwoHP89v+1VmLhc2o0mD6CuKyVU/QBoCcHcqMA +U6DksquDOFczJZSfvkgdmOGjup5czQRxUX11eKvzWarE4GC+j4NSuHUaQTXtvPM6 +Y+mpFEXX5lLRbtLevOP1Czvm4MS9Q2QTps70mDdsipWol8hHD/BeEIvnHRz+sTug +BTNoBUGCwQMrAcjnj02r6LX2zWtEtefdi+zqJbQAIldNsLGyMcEWzv/9FIS3R/qy +8XDe24tsNlikfLMR0cN3f1+2JeANxdKz+bi4d9s3cXFH42AYTyS2dTd4uaNir73J +co4vzLuu2+QVUhkHM/tqty1LkCiCc/4YizWN26cEar7qwU02OxY2kTLvtkCJkUPg +8qKrBC7m8kwOFjQgrIfBLX7JZkcXFBGk8/ehJImr2BrIoVyxo/eMbcgByU/J7MT8 +rFEz0ciD0cmfHdRHNCk+y7AO+oMLKFjlKdw/fKifybYKu6boRhYPluV75Gp6SG12 +mAWl3G0eQh5C2hrgUve1g8Aae3g1LDj1H/1Joy7SWWO/gLCMk3PLNaaZlSJhZQNg ++y+TS/qanIA7AgMBAAGjYzBhMA4GA1UdDwEB/wQEAwIBBjAdBgNVHQ4EFgQUtqeX +gj10hZv3PJ+TmpV5dVKMbUcwDwYDVR0TAQH/BAUwAwEB/zAfBgNVHSMEGDAWgBS2 +p5eCPXSFm/c8n5OalXl1UoxtRzANBgkqhkiG9w0BAQwFAAOCAgEAqMxhpr51nhVQ +pGv7qHBFfLp+sVr8WyP6Cnf4mHGCDG3gXkaqk/QeoMPhk9tLrbKmXauw1GLLXrtm +9S3ul0A8Yute1hTWjOKWi0FpkzXmuZlrYrShF2Y0pmtjxrlO8iLpWA1WQdH6DErw +M807u20hOq6OcrXDSvvpfeWxm4bu4uB9tPcy/SKE8YXJN3nptT+/XOR0so8RYgDd +GGah2XsjX/GO1WfoVNpbOms2b/mBsTNHM3dA+VKq3dSDz4V4mZqTuXNnQkYRIer+ +CqkbGmVps4+uFrb2S1ayLfmlyOw7YqPta9BO1UAJpB+Y1zqlklkg5LB9zVtzaL1t +xKITDmcZuI1CfmwMmm6gJC3VRRvcxAIU/oVbZZfKTpBQCHpCNfnqwmbU+AGuHrS+ +w6jv/naaoqYfRvaE7fzbzsQCzndILIyy7MMAo+wsVRjBfhnu4S/yrYObnqsZ38aK +L4x35bcF7DvB7L6Gs4a8wPfc5+pbrrLMtTWGS9DiP7bY+A4A7l3j941Y/8+LN+lj +X273CXE2whJdV/LItM3z7gLfEdxquVeEHVlNjM7IDiPCtyaaEBRx/pOyiriA8A4Q +ntOoUAw3gi/q4Iqd4Sw5/7W0cwDk90imc6y/st53BIe0o82bNSQ3+pCTE4FCxpgm +dTdmQRCsu/WU48IxK63nI1bMNSWSs1A= +-----END CERTIFICATE----- + +# Issuer: CN=FIRMAPROFESIONAL CA ROOT-A WEB O=Firmaprofesional SA +# Subject: CN=FIRMAPROFESIONAL CA ROOT-A WEB O=Firmaprofesional SA +# Label: "FIRMAPROFESIONAL CA ROOT-A WEB" +# Serial: 65916896770016886708751106294915943533 +# MD5 Fingerprint: 82:b2:ad:45:00:82:b0:66:63:f8:5f:c3:67:4e:ce:a3 +# SHA1 Fingerprint: a8:31:11:74:a6:14:15:0d:ca:77:dd:0e:e4:0c:5d:58:fc:a0:72:a5 +# SHA256 Fingerprint: be:f2:56:da:f2:6e:9c:69:bd:ec:16:02:35:97:98:f3:ca:f7:18:21:a0:3e:01:82:57:c5:3c:65:61:7f:3d:4a +-----BEGIN CERTIFICATE----- +MIICejCCAgCgAwIBAgIQMZch7a+JQn81QYehZ1ZMbTAKBggqhkjOPQQDAzBuMQsw +CQYDVQQGEwJFUzEcMBoGA1UECgwTRmlybWFwcm9mZXNpb25hbCBTQTEYMBYGA1UE +YQwPVkFURVMtQTYyNjM0MDY4MScwJQYDVQQDDB5GSVJNQVBST0ZFU0lPTkFMIENB +IFJPT1QtQSBXRUIwHhcNMjIwNDA2MDkwMTM2WhcNNDcwMzMxMDkwMTM2WjBuMQsw +CQYDVQQGEwJFUzEcMBoGA1UECgwTRmlybWFwcm9mZXNpb25hbCBTQTEYMBYGA1UE +YQwPVkFURVMtQTYyNjM0MDY4MScwJQYDVQQDDB5GSVJNQVBST0ZFU0lPTkFMIENB +IFJPT1QtQSBXRUIwdjAQBgcqhkjOPQIBBgUrgQQAIgNiAARHU+osEaR3xyrq89Zf +e9MEkVz6iMYiuYMQYneEMy3pA4jU4DP37XcsSmDq5G+tbbT4TIqk5B/K6k84Si6C +cyvHZpsKjECcfIr28jlgst7L7Ljkb+qbXbdTkBgyVcUgt5SjYzBhMA8GA1UdEwEB +/wQFMAMBAf8wHwYDVR0jBBgwFoAUk+FDY1w8ndYn81LsF7Kpryz3dvgwHQYDVR0O +BBYEFJPhQ2NcPJ3WJ/NS7Beyqa8s93b4MA4GA1UdDwEB/wQEAwIBBjAKBggqhkjO +PQQDAwNoADBlAjAdfKR7w4l1M+E7qUW/Runpod3JIha3RxEL2Jq68cgLcFBTApFw +hVmpHqTm6iMxoAACMQD94vizrxa5HnPEluPBMBnYfubDl94cT7iJLzPrSA8Z94dG +XSaQpYXFuXqUPoeovQA= +-----END CERTIFICATE----- + +# Issuer: CN=TWCA CYBER Root CA O=TAIWAN-CA OU=Root CA +# Subject: CN=TWCA CYBER Root CA O=TAIWAN-CA OU=Root CA +# Label: "TWCA CYBER Root CA" +# Serial: 85076849864375384482682434040119489222 +# MD5 Fingerprint: 0b:33:a0:97:52:95:d4:a9:fd:bb:db:6e:a3:55:5b:51 +# SHA1 Fingerprint: f6:b1:1c:1a:83:38:e9:7b:db:b3:a8:c8:33:24:e0:2d:9c:7f:26:66 +# SHA256 Fingerprint: 3f:63:bb:28:14:be:17:4e:c8:b6:43:9c:f0:8d:6d:56:f0:b7:c4:05:88:3a:56:48:a3:34:42:4d:6b:3e:c5:58 +-----BEGIN CERTIFICATE----- +MIIFjTCCA3WgAwIBAgIQQAE0jMIAAAAAAAAAATzyxjANBgkqhkiG9w0BAQwFADBQ +MQswCQYDVQQGEwJUVzESMBAGA1UEChMJVEFJV0FOLUNBMRAwDgYDVQQLEwdSb290 +IENBMRswGQYDVQQDExJUV0NBIENZQkVSIFJvb3QgQ0EwHhcNMjIxMTIyMDY1NDI5 +WhcNNDcxMTIyMTU1OTU5WjBQMQswCQYDVQQGEwJUVzESMBAGA1UEChMJVEFJV0FO +LUNBMRAwDgYDVQQLEwdSb290IENBMRswGQYDVQQDExJUV0NBIENZQkVSIFJvb3Qg +Q0EwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQDG+Moe2Qkgfh1sTs6P +40czRJzHyWmqOlt47nDSkvgEs1JSHWdyKKHfi12VCv7qze33Kc7wb3+szT3vsxxF +avcokPFhV8UMxKNQXd7UtcsZyoC5dc4pztKFIuwCY8xEMCDa6pFbVuYdHNWdZsc/ +34bKS1PE2Y2yHer43CdTo0fhYcx9tbD47nORxc5zb87uEB8aBs/pJ2DFTxnk684i +JkXXYJndzk834H/nY62wuFm40AZoNWDTNq5xQwTxaWV4fPMf88oon1oglWa0zbfu +j3ikRRjpJi+NmykosaS3Om251Bw4ckVYsV7r8Cibt4LK/c/WMw+f+5eesRycnupf +Xtuq3VTpMCEobY5583WSjCb+3MX2w7DfRFlDo7YDKPYIMKoNM+HvnKkHIuNZW0CP +2oi3aQiotyMuRAlZN1vH4xfyIutuOVLF3lSnmMlLIJXcRolftBL5hSmO68gnFSDA +S9TMfAxsNAwmmyYxpjyn9tnQS6Jk/zuZQXLB4HCX8SS7K8R0IrGsayIyJNN4KsDA +oS/xUgXJP+92ZuJF2A09rZXIx4kmyA+upwMu+8Ff+iDhcK2wZSA3M2Cw1a/XDBzC +kHDXShi8fgGwsOsVHkQGzaRP6AzRwyAQ4VRlnrZR0Bp2a0JaWHY06rc3Ga4udfmW +5cFZ95RXKSWNOkyrTZpB0F8mAwIDAQABo2MwYTAOBgNVHQ8BAf8EBAMCAQYwDwYD +VR0TAQH/BAUwAwEB/zAfBgNVHSMEGDAWgBSdhWEUfMFib5do5E83QOGt4A1WNzAd +BgNVHQ4EFgQUnYVhFHzBYm+XaORPN0DhreANVjcwDQYJKoZIhvcNAQEMBQADggIB +AGSPesRiDrWIzLjHhg6hShbNcAu3p4ULs3a2D6f/CIsLJc+o1IN1KriWiLb73y0t +tGlTITVX1olNc79pj3CjYcya2x6a4CD4bLubIp1dhDGaLIrdaqHXKGnK/nZVekZn +68xDiBaiA9a5F/gZbG0jAn/xX9AKKSM70aoK7akXJlQKTcKlTfjF/biBzysseKNn +TKkHmvPfXvt89YnNdJdhEGoHK4Fa0o635yDRIG4kqIQnoVesqlVYL9zZyvpoBJ7t +RCT5dEA7IzOrg1oYJkK2bVS1FmAwbLGg+LhBoF1JSdJlBTrq/p1hvIbZv97Tujqx +f36SNI7JAG7cmL3c7IAFrQI932XtCwP39xaEBDG6k5TY8hL4iuO/Qq+n1M0RFxbI +Qh0UqEL20kCGoE8jypZFVmAGzbdVAaYBlGX+bgUJurSkquLvWL69J1bY73NxW0Qz +8ppy6rBePm6pUlvscG21h483XjyMnM7k8M4MZ0HMzvaAq07MTFb1wWFZk7Q+ptq4 +NxKfKjLji7gh7MMrZQzvIt6IKTtM1/r+t+FHvpw+PoP7UV31aPcuIYXcv/Fa4nzX +xeSDwWrruoBa3lwtcHb4yOWHh8qgnaHlIhInD0Q9HWzq1MKLL295q39QpsQZp6F6 +t5b5wR9iWqJDB0BeJsas7a5wFsWqynKKTbDPAYsDP27X +-----END CERTIFICATE----- + +# Issuer: CN=SecureSign Root CA12 O=Cybertrust Japan Co., Ltd. +# Subject: CN=SecureSign Root CA12 O=Cybertrust Japan Co., Ltd. +# Label: "SecureSign Root CA12" +# Serial: 587887345431707215246142177076162061960426065942 +# MD5 Fingerprint: c6:89:ca:64:42:9b:62:08:49:0b:1e:7f:e9:07:3d:e8 +# SHA1 Fingerprint: 7a:22:1e:3d:de:1b:06:ac:9e:c8:47:70:16:8e:3c:e5:f7:6b:06:f4 +# SHA256 Fingerprint: 3f:03:4b:b5:70:4d:44:b2:d0:85:45:a0:20:57:de:93:eb:f3:90:5f:ce:72:1a:cb:c7:30:c0:6d:da:ee:90:4e +-----BEGIN CERTIFICATE----- +MIIDcjCCAlqgAwIBAgIUZvnHwa/swlG07VOX5uaCwysckBYwDQYJKoZIhvcNAQEL +BQAwUTELMAkGA1UEBhMCSlAxIzAhBgNVBAoTGkN5YmVydHJ1c3QgSmFwYW4gQ28u +LCBMdGQuMR0wGwYDVQQDExRTZWN1cmVTaWduIFJvb3QgQ0ExMjAeFw0yMDA0MDgw +NTM2NDZaFw00MDA0MDgwNTM2NDZaMFExCzAJBgNVBAYTAkpQMSMwIQYDVQQKExpD +eWJlcnRydXN0IEphcGFuIENvLiwgTHRkLjEdMBsGA1UEAxMUU2VjdXJlU2lnbiBS +b290IENBMTIwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQC6OcE3emhF +KxS06+QT61d1I02PJC0W6K6OyX2kVzsqdiUzg2zqMoqUm048luT9Ub+ZyZN+v/mt +p7JIKwccJ/VMvHASd6SFVLX9kHrko+RRWAPNEHl57muTH2SOa2SroxPjcf59q5zd +J1M3s6oYwlkm7Fsf0uZlfO+TvdhYXAvA42VvPMfKWeP+bl+sg779XSVOKik71gur +FzJ4pOE+lEa+Ym6b3kaosRbnhW70CEBFEaCeVESE99g2zvVQR9wsMJvuwPWW0v4J +hscGWa5Pro4RmHvzC1KqYiaqId+OJTN5lxZJjfU+1UefNzFJM3IFTQy2VYzxV4+K +h9GtxRESOaCtAgMBAAGjQjBAMA8GA1UdEwEB/wQFMAMBAf8wDgYDVR0PAQH/BAQD +AgEGMB0GA1UdDgQWBBRXNPN0zwRL1SXm8UC2LEzZLemgrTANBgkqhkiG9w0BAQsF +AAOCAQEAPrvbFxbS8hQBICw4g0utvsqFepq2m2um4fylOqyttCg6r9cBg0krY6Ld +mmQOmFxv3Y67ilQiLUoT865AQ9tPkbeGGuwAtEGBpE/6aouIs3YIcipJQMPTw4WJ +mBClnW8Zt7vPemVV2zfrPIpyMpcemik+rY3moxtt9XUa5rBouVui7mlHJzWhhpmA +8zNL4WukJsPvdFlseqJkth5Ew1DgDzk9qTPxpfPSvWKErI4cqc1avTc7bgoitPQV +55FYxTpE05Uo2cBl6XLK0A+9H7MV2anjpEcJnuDLN/v9vZfVvhgaaaI5gdka9at/ +yOPiZwud9AzqVN/Ssq+xIvEg37xEHA== +-----END CERTIFICATE----- + +# Issuer: CN=SecureSign Root CA14 O=Cybertrust Japan Co., Ltd. +# Subject: CN=SecureSign Root CA14 O=Cybertrust Japan Co., Ltd. +# Label: "SecureSign Root CA14" +# Serial: 575790784512929437950770173562378038616896959179 +# MD5 Fingerprint: 71:0d:72:fa:92:19:65:5e:89:04:ac:16:33:f0:bc:d5 +# SHA1 Fingerprint: dd:50:c0:f7:79:b3:64:2e:74:a2:b8:9d:9f:d3:40:dd:bb:f0:f2:4f +# SHA256 Fingerprint: 4b:00:9c:10:34:49:4f:9a:b5:6b:ba:3b:a1:d6:27:31:fc:4d:20:d8:95:5a:dc:ec:10:a9:25:60:72:61:e3:38 +-----BEGIN CERTIFICATE----- +MIIFcjCCA1qgAwIBAgIUZNtaDCBO6Ncpd8hQJ6JaJ90t8sswDQYJKoZIhvcNAQEM +BQAwUTELMAkGA1UEBhMCSlAxIzAhBgNVBAoTGkN5YmVydHJ1c3QgSmFwYW4gQ28u +LCBMdGQuMR0wGwYDVQQDExRTZWN1cmVTaWduIFJvb3QgQ0ExNDAeFw0yMDA0MDgw +NzA2MTlaFw00NTA0MDgwNzA2MTlaMFExCzAJBgNVBAYTAkpQMSMwIQYDVQQKExpD +eWJlcnRydXN0IEphcGFuIENvLiwgTHRkLjEdMBsGA1UEAxMUU2VjdXJlU2lnbiBS +b290IENBMTQwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQDF0nqh1oq/ +FjHQmNE6lPxauG4iwWL3pwon71D2LrGeaBLwbCRjOfHw3xDG3rdSINVSW0KZnvOg +vlIfX8xnbacuUKLBl422+JX1sLrcneC+y9/3OPJH9aaakpUqYllQC6KxNedlsmGy +6pJxaeQp8E+BgQQ8sqVb1MWoWWd7VRxJq3qdwudzTe/NCcLEVxLbAQ4jeQkHO6Lo +/IrPj8BGJJw4J+CDnRugv3gVEOuGTgpa/d/aLIJ+7sr2KeH6caH3iGicnPCNvg9J +kdjqOvn90Ghx2+m1K06Ckm9mH+Dw3EzsytHqunQG+bOEkJTRX45zGRBdAuVwpcAQ +0BB8b8VYSbSwbprafZX1zNoCr7gsfXmPvkPx+SgojQlD+Ajda8iLLCSxjVIHvXib +y8posqTdDEx5YMaZ0ZPxMBoH064iwurO8YQJzOAUbn8/ftKChazcqRZOhaBgy/ac +18izju3Gm5h1DVXoX+WViwKkrkMpKBGk5hIwAUt1ax5mnXkvpXYvHUC0bcl9eQjs +0Wq2XSqypWa9a4X0dFbD9ed1Uigspf9mR6XU/v6eVL9lfgHWMI+lNpyiUBzuOIAB +SMbHdPTGrMNASRZhdCyvjG817XsYAFs2PJxQDcqSMxDxJklt33UkN4Ii1+iW/RVL +ApY+B3KVfqs9TC7XyvDf4Fg/LS8EmjijAQIDAQABo0IwQDAPBgNVHRMBAf8EBTAD +AQH/MA4GA1UdDwEB/wQEAwIBBjAdBgNVHQ4EFgQUBpOjCl4oaTeqYR3r6/wtbyPk +86AwDQYJKoZIhvcNAQEMBQADggIBAJaAcgkGfpzMkwQWu6A6jZJOtxEaCnFxEM0E +rX+lRVAQZk5KQaID2RFPeje5S+LGjzJmdSX7684/AykmjbgWHfYfM25I5uj4V7Ib +ed87hwriZLoAymzvftAj63iP/2SbNDefNWWipAA9EiOWWF3KY4fGoweITedpdopT +zfFP7ELyk+OZpDc8h7hi2/DsHzc/N19DzFGdtfCXwreFamgLRB7lUe6TzktuhsHS +DCRZNhqfLJGP4xjblJUK7ZGqDpncllPjYYPGFrojutzdfhrGe0K22VoF3Jpf1d+4 +2kd92jjbrDnVHmtsKheMYc2xbXIBw8MgAGJoFjHVdqqGuw6qnsb58Nn4DSEC5MUo +FlkRudlpcyqSeLiSV5sI8jrlL5WwWLdrIBRtFO8KvH7YVdiI2i/6GaX7i+B/OfVy +K4XELKzvGUWSTLNhB9xNH27SgRNcmvMSZ4PPmz+Ln52kuaiWA3rF7iDeM9ovnhp6 +dB7h7sxaOgTdsxoEqBRjrLdHEoOabPXm6RUVkRqEGQ6UROcSjiVbgGcZ3GOTEAtl +Lor6CZpO2oYofaphNdgOpygau1LgePhsumywbrmHXumZNTfxPWQrqaA0k89jL9WB +365jJ6UeTo3cKXhZ+PmhIIynJkBugnLNeLLIjzwec+fBH7/PzqUqm9tEZDKgu39c +JRNItX+S +-----END CERTIFICATE----- + +# Issuer: CN=SecureSign Root CA15 O=Cybertrust Japan Co., Ltd. +# Subject: CN=SecureSign Root CA15 O=Cybertrust Japan Co., Ltd. +# Label: "SecureSign Root CA15" +# Serial: 126083514594751269499665114766174399806381178503 +# MD5 Fingerprint: 13:30:fc:c4:62:a6:a9:de:b5:c1:68:af:b5:d2:31:47 +# SHA1 Fingerprint: cb:ba:83:c8:c1:5a:5d:f1:f9:73:6f:ca:d7:ef:28:13:06:4a:07:7d +# SHA256 Fingerprint: e7:78:f0:f0:95:fe:84:37:29:cd:1a:00:82:17:9e:53:14:a9:c2:91:44:28:05:e1:fb:1d:8f:b6:b8:88:6c:3a +-----BEGIN CERTIFICATE----- +MIICIzCCAamgAwIBAgIUFhXHw9hJp75pDIqI7fBw+d23PocwCgYIKoZIzj0EAwMw +UTELMAkGA1UEBhMCSlAxIzAhBgNVBAoTGkN5YmVydHJ1c3QgSmFwYW4gQ28uLCBM +dGQuMR0wGwYDVQQDExRTZWN1cmVTaWduIFJvb3QgQ0ExNTAeFw0yMDA0MDgwODMy +NTZaFw00NTA0MDgwODMyNTZaMFExCzAJBgNVBAYTAkpQMSMwIQYDVQQKExpDeWJl +cnRydXN0IEphcGFuIENvLiwgTHRkLjEdMBsGA1UEAxMUU2VjdXJlU2lnbiBSb290 +IENBMTUwdjAQBgcqhkjOPQIBBgUrgQQAIgNiAAQLUHSNZDKZmbPSYAi4Io5GdCx4 +wCtELW1fHcmuS1Iggz24FG1Th2CeX2yF2wYUleDHKP+dX+Sq8bOLbe1PL0vJSpSR +ZHX+AezB2Ot6lHhWGENfa4HL9rzatAy2KZMIaY+jQjBAMA8GA1UdEwEB/wQFMAMB +Af8wDgYDVR0PAQH/BAQDAgEGMB0GA1UdDgQWBBTrQciu/NWeUUj1vYv0hyCTQSvT +9DAKBggqhkjOPQQDAwNoADBlAjEA2S6Jfl5OpBEHvVnCB96rMjhTKkZEBhd6zlHp +4P9mLQlO4E/0BdGF9jVg3PVys0Z9AjBEmEYagoUeYWmJSwdLZrWeqrqgHkHZAXQ6 +bkU6iYAZezKYVWOr62Nuk22rGwlgMU4= +-----END CERTIFICATE----- diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/certifi/core.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/certifi/core.py new file mode 100644 index 0000000..70e0c3b --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/certifi/core.py @@ -0,0 +1,114 @@ +""" +certifi.py +~~~~~~~~~~ + +This module returns the installation location of cacert.pem or its contents. +""" +import sys +import atexit + +def exit_cacert_ctx() -> None: + _CACERT_CTX.__exit__(None, None, None) # type: ignore[union-attr] + + +if sys.version_info >= (3, 11): + + from importlib.resources import as_file, files + + _CACERT_CTX = None + _CACERT_PATH = None + + def where() -> str: + # This is slightly terrible, but we want to delay extracting the file + # in cases where we're inside of a zipimport situation until someone + # actually calls where(), but we don't want to re-extract the file + # on every call of where(), so we'll do it once then store it in a + # global variable. + global _CACERT_CTX + global _CACERT_PATH + if _CACERT_PATH is None: + # This is slightly janky, the importlib.resources API wants you to + # manage the cleanup of this file, so it doesn't actually return a + # path, it returns a context manager that will give you the path + # when you enter it and will do any cleanup when you leave it. In + # the common case of not needing a temporary file, it will just + # return the file system location and the __exit__() is a no-op. + # + # We also have to hold onto the actual context manager, because + # it will do the cleanup whenever it gets garbage collected, so + # we will also store that at the global level as well. + _CACERT_CTX = as_file(files("pip._vendor.certifi").joinpath("cacert.pem")) + _CACERT_PATH = str(_CACERT_CTX.__enter__()) + atexit.register(exit_cacert_ctx) + + return _CACERT_PATH + + def contents() -> str: + return files("pip._vendor.certifi").joinpath("cacert.pem").read_text(encoding="ascii") + +elif sys.version_info >= (3, 7): + + from importlib.resources import path as get_path, read_text + + _CACERT_CTX = None + _CACERT_PATH = None + + def where() -> str: + # This is slightly terrible, but we want to delay extracting the + # file in cases where we're inside of a zipimport situation until + # someone actually calls where(), but we don't want to re-extract + # the file on every call of where(), so we'll do it once then store + # it in a global variable. + global _CACERT_CTX + global _CACERT_PATH + if _CACERT_PATH is None: + # This is slightly janky, the importlib.resources API wants you + # to manage the cleanup of this file, so it doesn't actually + # return a path, it returns a context manager that will give + # you the path when you enter it and will do any cleanup when + # you leave it. In the common case of not needing a temporary + # file, it will just return the file system location and the + # __exit__() is a no-op. + # + # We also have to hold onto the actual context manager, because + # it will do the cleanup whenever it gets garbage collected, so + # we will also store that at the global level as well. + _CACERT_CTX = get_path("pip._vendor.certifi", "cacert.pem") + _CACERT_PATH = str(_CACERT_CTX.__enter__()) + atexit.register(exit_cacert_ctx) + + return _CACERT_PATH + + def contents() -> str: + return read_text("pip._vendor.certifi", "cacert.pem", encoding="ascii") + +else: + import os + import types + from typing import Union + + Package = Union[types.ModuleType, str] + Resource = Union[str, "os.PathLike"] + + # This fallback will work for Python versions prior to 3.7 that lack the + # importlib.resources module but relies on the existing `where` function + # so won't address issues with environments like PyOxidizer that don't set + # __file__ on modules. + def read_text( + package: Package, + resource: Resource, + encoding: str = 'utf-8', + errors: str = 'strict' + ) -> str: + with open(where(), encoding=encoding) as data: + return data.read() + + # If we don't have importlib.resources, then we will just do the old logic + # of assuming we're on the filesystem and munge the path directly. + def where() -> str: + f = os.path.dirname(__file__) + + return os.path.join(f, "cacert.pem") + + def contents() -> str: + return read_text("pip._vendor.certifi", "cacert.pem", encoding="ascii") diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/certifi/py.typed b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/certifi/py.typed new file mode 100644 index 0000000..e69de29 diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/__init__.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/__init__.py new file mode 100644 index 0000000..bf0d6c6 --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/__init__.py @@ -0,0 +1,33 @@ +# -*- coding: utf-8 -*- +# +# Copyright (C) 2012-2023 Vinay Sajip. +# Licensed to the Python Software Foundation under a contributor agreement. +# See LICENSE.txt and CONTRIBUTORS.txt. +# +import logging + +__version__ = '0.3.9' + + +class DistlibException(Exception): + pass + + +try: + from logging import NullHandler +except ImportError: # pragma: no cover + + class NullHandler(logging.Handler): + + def handle(self, record): + pass + + def emit(self, record): + pass + + def createLock(self): + self.lock = None + + +logger = logging.getLogger(__name__) +logger.addHandler(NullHandler()) diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/__pycache__/__init__.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000..857ab38 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/__pycache__/__init__.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/__pycache__/compat.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/__pycache__/compat.cpython-312.pyc new file mode 100644 index 0000000..d013d42 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/__pycache__/compat.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/__pycache__/database.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/__pycache__/database.cpython-312.pyc new file mode 100644 index 0000000..a9150d2 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/__pycache__/database.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/__pycache__/index.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/__pycache__/index.cpython-312.pyc new file mode 100644 index 0000000..f9e7ce1 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/__pycache__/index.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/__pycache__/locators.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/__pycache__/locators.cpython-312.pyc new file mode 100644 index 0000000..b3c154f Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/__pycache__/locators.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/__pycache__/manifest.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/__pycache__/manifest.cpython-312.pyc new file mode 100644 index 0000000..a9f9ccf Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/__pycache__/manifest.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/__pycache__/markers.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/__pycache__/markers.cpython-312.pyc new file mode 100644 index 0000000..3d7fba8 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/__pycache__/markers.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/__pycache__/metadata.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/__pycache__/metadata.cpython-312.pyc new file mode 100644 index 0000000..36b95da Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/__pycache__/metadata.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/__pycache__/resources.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/__pycache__/resources.cpython-312.pyc new file mode 100644 index 0000000..a775e10 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/__pycache__/resources.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/__pycache__/scripts.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/__pycache__/scripts.cpython-312.pyc new file mode 100644 index 0000000..02ed3a9 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/__pycache__/scripts.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/__pycache__/util.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/__pycache__/util.cpython-312.pyc new file mode 100644 index 0000000..2cbcd94 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/__pycache__/util.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/__pycache__/version.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/__pycache__/version.cpython-312.pyc new file mode 100644 index 0000000..4d6a38c Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/__pycache__/version.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/__pycache__/wheel.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/__pycache__/wheel.cpython-312.pyc new file mode 100644 index 0000000..4d57602 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/__pycache__/wheel.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/compat.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/compat.py new file mode 100644 index 0000000..ca561dd --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/compat.py @@ -0,0 +1,1137 @@ +# -*- coding: utf-8 -*- +# +# Copyright (C) 2013-2017 Vinay Sajip. +# Licensed to the Python Software Foundation under a contributor agreement. +# See LICENSE.txt and CONTRIBUTORS.txt. +# +from __future__ import absolute_import + +import os +import re +import shutil +import sys + +try: + import ssl +except ImportError: # pragma: no cover + ssl = None + +if sys.version_info[0] < 3: # pragma: no cover + from StringIO import StringIO + string_types = basestring, + text_type = unicode + from types import FileType as file_type + import __builtin__ as builtins + import ConfigParser as configparser + from urlparse import urlparse, urlunparse, urljoin, urlsplit, urlunsplit + from urllib import (urlretrieve, quote as _quote, unquote, url2pathname, + pathname2url, ContentTooShortError, splittype) + + def quote(s): + if isinstance(s, unicode): + s = s.encode('utf-8') + return _quote(s) + + import urllib2 + from urllib2 import (Request, urlopen, URLError, HTTPError, + HTTPBasicAuthHandler, HTTPPasswordMgr, HTTPHandler, + HTTPRedirectHandler, build_opener) + if ssl: + from urllib2 import HTTPSHandler + import httplib + import xmlrpclib + import Queue as queue + from HTMLParser import HTMLParser + import htmlentitydefs + raw_input = raw_input + from itertools import ifilter as filter + from itertools import ifilterfalse as filterfalse + + # Leaving this around for now, in case it needs resurrecting in some way + # _userprog = None + # def splituser(host): + # """splituser('user[:passwd]@host[:port]') --> 'user[:passwd]', 'host[:port]'.""" + # global _userprog + # if _userprog is None: + # import re + # _userprog = re.compile('^(.*)@(.*)$') + + # match = _userprog.match(host) + # if match: return match.group(1, 2) + # return None, host + +else: # pragma: no cover + from io import StringIO + string_types = str, + text_type = str + from io import TextIOWrapper as file_type + import builtins + import configparser + from urllib.parse import (urlparse, urlunparse, urljoin, quote, unquote, + urlsplit, urlunsplit, splittype) + from urllib.request import (urlopen, urlretrieve, Request, url2pathname, + pathname2url, HTTPBasicAuthHandler, + HTTPPasswordMgr, HTTPHandler, + HTTPRedirectHandler, build_opener) + if ssl: + from urllib.request import HTTPSHandler + from urllib.error import HTTPError, URLError, ContentTooShortError + import http.client as httplib + import urllib.request as urllib2 + import xmlrpc.client as xmlrpclib + import queue + from html.parser import HTMLParser + import html.entities as htmlentitydefs + raw_input = input + from itertools import filterfalse + filter = filter + +try: + from ssl import match_hostname, CertificateError +except ImportError: # pragma: no cover + + class CertificateError(ValueError): + pass + + def _dnsname_match(dn, hostname, max_wildcards=1): + """Matching according to RFC 6125, section 6.4.3 + + http://tools.ietf.org/html/rfc6125#section-6.4.3 + """ + pats = [] + if not dn: + return False + + parts = dn.split('.') + leftmost, remainder = parts[0], parts[1:] + + wildcards = leftmost.count('*') + if wildcards > max_wildcards: + # Issue #17980: avoid denials of service by refusing more + # than one wildcard per fragment. A survey of established + # policy among SSL implementations showed it to be a + # reasonable choice. + raise CertificateError( + "too many wildcards in certificate DNS name: " + repr(dn)) + + # speed up common case w/o wildcards + if not wildcards: + return dn.lower() == hostname.lower() + + # RFC 6125, section 6.4.3, subitem 1. + # The client SHOULD NOT attempt to match a presented identifier in which + # the wildcard character comprises a label other than the left-most label. + if leftmost == '*': + # When '*' is a fragment by itself, it matches a non-empty dotless + # fragment. + pats.append('[^.]+') + elif leftmost.startswith('xn--') or hostname.startswith('xn--'): + # RFC 6125, section 6.4.3, subitem 3. + # The client SHOULD NOT attempt to match a presented identifier + # where the wildcard character is embedded within an A-label or + # U-label of an internationalized domain name. + pats.append(re.escape(leftmost)) + else: + # Otherwise, '*' matches any dotless string, e.g. www* + pats.append(re.escape(leftmost).replace(r'\*', '[^.]*')) + + # add the remaining fragments, ignore any wildcards + for frag in remainder: + pats.append(re.escape(frag)) + + pat = re.compile(r'\A' + r'\.'.join(pats) + r'\Z', re.IGNORECASE) + return pat.match(hostname) + + def match_hostname(cert, hostname): + """Verify that *cert* (in decoded format as returned by + SSLSocket.getpeercert()) matches the *hostname*. RFC 2818 and RFC 6125 + rules are followed, but IP addresses are not accepted for *hostname*. + + CertificateError is raised on failure. On success, the function + returns nothing. + """ + if not cert: + raise ValueError("empty or no certificate, match_hostname needs a " + "SSL socket or SSL context with either " + "CERT_OPTIONAL or CERT_REQUIRED") + dnsnames = [] + san = cert.get('subjectAltName', ()) + for key, value in san: + if key == 'DNS': + if _dnsname_match(value, hostname): + return + dnsnames.append(value) + if not dnsnames: + # The subject is only checked when there is no dNSName entry + # in subjectAltName + for sub in cert.get('subject', ()): + for key, value in sub: + # XXX according to RFC 2818, the most specific Common Name + # must be used. + if key == 'commonName': + if _dnsname_match(value, hostname): + return + dnsnames.append(value) + if len(dnsnames) > 1: + raise CertificateError("hostname %r " + "doesn't match either of %s" % + (hostname, ', '.join(map(repr, dnsnames)))) + elif len(dnsnames) == 1: + raise CertificateError("hostname %r " + "doesn't match %r" % + (hostname, dnsnames[0])) + else: + raise CertificateError("no appropriate commonName or " + "subjectAltName fields were found") + + +try: + from types import SimpleNamespace as Container +except ImportError: # pragma: no cover + + class Container(object): + """ + A generic container for when multiple values need to be returned + """ + + def __init__(self, **kwargs): + self.__dict__.update(kwargs) + + +try: + from shutil import which +except ImportError: # pragma: no cover + # Implementation from Python 3.3 + def which(cmd, mode=os.F_OK | os.X_OK, path=None): + """Given a command, mode, and a PATH string, return the path which + conforms to the given mode on the PATH, or None if there is no such + file. + + `mode` defaults to os.F_OK | os.X_OK. `path` defaults to the result + of os.environ.get("PATH"), or can be overridden with a custom search + path. + + """ + + # Check that a given file can be accessed with the correct mode. + # Additionally check that `file` is not a directory, as on Windows + # directories pass the os.access check. + def _access_check(fn, mode): + return (os.path.exists(fn) and os.access(fn, mode) and not os.path.isdir(fn)) + + # If we're given a path with a directory part, look it up directly rather + # than referring to PATH directories. This includes checking relative to the + # current directory, e.g. ./script + if os.path.dirname(cmd): + if _access_check(cmd, mode): + return cmd + return None + + if path is None: + path = os.environ.get("PATH", os.defpath) + if not path: + return None + path = path.split(os.pathsep) + + if sys.platform == "win32": + # The current directory takes precedence on Windows. + if os.curdir not in path: + path.insert(0, os.curdir) + + # PATHEXT is necessary to check on Windows. + pathext = os.environ.get("PATHEXT", "").split(os.pathsep) + # See if the given file matches any of the expected path extensions. + # This will allow us to short circuit when given "python.exe". + # If it does match, only test that one, otherwise we have to try + # others. + if any(cmd.lower().endswith(ext.lower()) for ext in pathext): + files = [cmd] + else: + files = [cmd + ext for ext in pathext] + else: + # On other platforms you don't have things like PATHEXT to tell you + # what file suffixes are executable, so just pass on cmd as-is. + files = [cmd] + + seen = set() + for dir in path: + normdir = os.path.normcase(dir) + if normdir not in seen: + seen.add(normdir) + for thefile in files: + name = os.path.join(dir, thefile) + if _access_check(name, mode): + return name + return None + + +# ZipFile is a context manager in 2.7, but not in 2.6 + +from zipfile import ZipFile as BaseZipFile + +if hasattr(BaseZipFile, '__enter__'): # pragma: no cover + ZipFile = BaseZipFile +else: # pragma: no cover + from zipfile import ZipExtFile as BaseZipExtFile + + class ZipExtFile(BaseZipExtFile): + + def __init__(self, base): + self.__dict__.update(base.__dict__) + + def __enter__(self): + return self + + def __exit__(self, *exc_info): + self.close() + # return None, so if an exception occurred, it will propagate + + class ZipFile(BaseZipFile): + + def __enter__(self): + return self + + def __exit__(self, *exc_info): + self.close() + # return None, so if an exception occurred, it will propagate + + def open(self, *args, **kwargs): + base = BaseZipFile.open(self, *args, **kwargs) + return ZipExtFile(base) + + +try: + from platform import python_implementation +except ImportError: # pragma: no cover + + def python_implementation(): + """Return a string identifying the Python implementation.""" + if 'PyPy' in sys.version: + return 'PyPy' + if os.name == 'java': + return 'Jython' + if sys.version.startswith('IronPython'): + return 'IronPython' + return 'CPython' + + +import sysconfig + +try: + callable = callable +except NameError: # pragma: no cover + from collections.abc import Callable + + def callable(obj): + return isinstance(obj, Callable) + + +try: + fsencode = os.fsencode + fsdecode = os.fsdecode +except AttributeError: # pragma: no cover + # Issue #99: on some systems (e.g. containerised), + # sys.getfilesystemencoding() returns None, and we need a real value, + # so fall back to utf-8. From the CPython 2.7 docs relating to Unix and + # sys.getfilesystemencoding(): the return value is "the user’s preference + # according to the result of nl_langinfo(CODESET), or None if the + # nl_langinfo(CODESET) failed." + _fsencoding = sys.getfilesystemencoding() or 'utf-8' + if _fsencoding == 'mbcs': + _fserrors = 'strict' + else: + _fserrors = 'surrogateescape' + + def fsencode(filename): + if isinstance(filename, bytes): + return filename + elif isinstance(filename, text_type): + return filename.encode(_fsencoding, _fserrors) + else: + raise TypeError("expect bytes or str, not %s" % + type(filename).__name__) + + def fsdecode(filename): + if isinstance(filename, text_type): + return filename + elif isinstance(filename, bytes): + return filename.decode(_fsencoding, _fserrors) + else: + raise TypeError("expect bytes or str, not %s" % + type(filename).__name__) + + +try: + from tokenize import detect_encoding +except ImportError: # pragma: no cover + from codecs import BOM_UTF8, lookup + + cookie_re = re.compile(r"coding[:=]\s*([-\w.]+)") + + def _get_normal_name(orig_enc): + """Imitates get_normal_name in tokenizer.c.""" + # Only care about the first 12 characters. + enc = orig_enc[:12].lower().replace("_", "-") + if enc == "utf-8" or enc.startswith("utf-8-"): + return "utf-8" + if enc in ("latin-1", "iso-8859-1", "iso-latin-1") or \ + enc.startswith(("latin-1-", "iso-8859-1-", "iso-latin-1-")): + return "iso-8859-1" + return orig_enc + + def detect_encoding(readline): + """ + The detect_encoding() function is used to detect the encoding that should + be used to decode a Python source file. It requires one argument, readline, + in the same way as the tokenize() generator. + + It will call readline a maximum of twice, and return the encoding used + (as a string) and a list of any lines (left as bytes) it has read in. + + It detects the encoding from the presence of a utf-8 bom or an encoding + cookie as specified in pep-0263. If both a bom and a cookie are present, + but disagree, a SyntaxError will be raised. If the encoding cookie is an + invalid charset, raise a SyntaxError. Note that if a utf-8 bom is found, + 'utf-8-sig' is returned. + + If no encoding is specified, then the default of 'utf-8' will be returned. + """ + try: + filename = readline.__self__.name + except AttributeError: + filename = None + bom_found = False + encoding = None + default = 'utf-8' + + def read_or_stop(): + try: + return readline() + except StopIteration: + return b'' + + def find_cookie(line): + try: + # Decode as UTF-8. Either the line is an encoding declaration, + # in which case it should be pure ASCII, or it must be UTF-8 + # per default encoding. + line_string = line.decode('utf-8') + except UnicodeDecodeError: + msg = "invalid or missing encoding declaration" + if filename is not None: + msg = '{} for {!r}'.format(msg, filename) + raise SyntaxError(msg) + + matches = cookie_re.findall(line_string) + if not matches: + return None + encoding = _get_normal_name(matches[0]) + try: + codec = lookup(encoding) + except LookupError: + # This behaviour mimics the Python interpreter + if filename is None: + msg = "unknown encoding: " + encoding + else: + msg = "unknown encoding for {!r}: {}".format( + filename, encoding) + raise SyntaxError(msg) + + if bom_found: + if codec.name != 'utf-8': + # This behaviour mimics the Python interpreter + if filename is None: + msg = 'encoding problem: utf-8' + else: + msg = 'encoding problem for {!r}: utf-8'.format( + filename) + raise SyntaxError(msg) + encoding += '-sig' + return encoding + + first = read_or_stop() + if first.startswith(BOM_UTF8): + bom_found = True + first = first[3:] + default = 'utf-8-sig' + if not first: + return default, [] + + encoding = find_cookie(first) + if encoding: + return encoding, [first] + + second = read_or_stop() + if not second: + return default, [first] + + encoding = find_cookie(second) + if encoding: + return encoding, [first, second] + + return default, [first, second] + + +# For converting & <-> & etc. +try: + from html import escape +except ImportError: + from cgi import escape +if sys.version_info[:2] < (3, 4): + unescape = HTMLParser().unescape +else: + from html import unescape + +try: + from collections import ChainMap +except ImportError: # pragma: no cover + from collections import MutableMapping + + try: + from reprlib import recursive_repr as _recursive_repr + except ImportError: + + def _recursive_repr(fillvalue='...'): + ''' + Decorator to make a repr function return fillvalue for a recursive + call + ''' + + def decorating_function(user_function): + repr_running = set() + + def wrapper(self): + key = id(self), get_ident() + if key in repr_running: + return fillvalue + repr_running.add(key) + try: + result = user_function(self) + finally: + repr_running.discard(key) + return result + + # Can't use functools.wraps() here because of bootstrap issues + wrapper.__module__ = getattr(user_function, '__module__') + wrapper.__doc__ = getattr(user_function, '__doc__') + wrapper.__name__ = getattr(user_function, '__name__') + wrapper.__annotations__ = getattr(user_function, + '__annotations__', {}) + return wrapper + + return decorating_function + + class ChainMap(MutableMapping): + ''' + A ChainMap groups multiple dicts (or other mappings) together + to create a single, updateable view. + + The underlying mappings are stored in a list. That list is public and can + accessed or updated using the *maps* attribute. There is no other state. + + Lookups search the underlying mappings successively until a key is found. + In contrast, writes, updates, and deletions only operate on the first + mapping. + ''' + + def __init__(self, *maps): + '''Initialize a ChainMap by setting *maps* to the given mappings. + If no mappings are provided, a single empty dictionary is used. + + ''' + self.maps = list(maps) or [{}] # always at least one map + + def __missing__(self, key): + raise KeyError(key) + + def __getitem__(self, key): + for mapping in self.maps: + try: + return mapping[ + key] # can't use 'key in mapping' with defaultdict + except KeyError: + pass + return self.__missing__( + key) # support subclasses that define __missing__ + + def get(self, key, default=None): + return self[key] if key in self else default + + def __len__(self): + return len(set().union( + *self.maps)) # reuses stored hash values if possible + + def __iter__(self): + return iter(set().union(*self.maps)) + + def __contains__(self, key): + return any(key in m for m in self.maps) + + def __bool__(self): + return any(self.maps) + + @_recursive_repr() + def __repr__(self): + return '{0.__class__.__name__}({1})'.format( + self, ', '.join(map(repr, self.maps))) + + @classmethod + def fromkeys(cls, iterable, *args): + 'Create a ChainMap with a single dict created from the iterable.' + return cls(dict.fromkeys(iterable, *args)) + + def copy(self): + 'New ChainMap or subclass with a new copy of maps[0] and refs to maps[1:]' + return self.__class__(self.maps[0].copy(), *self.maps[1:]) + + __copy__ = copy + + def new_child(self): # like Django's Context.push() + 'New ChainMap with a new dict followed by all previous maps.' + return self.__class__({}, *self.maps) + + @property + def parents(self): # like Django's Context.pop() + 'New ChainMap from maps[1:].' + return self.__class__(*self.maps[1:]) + + def __setitem__(self, key, value): + self.maps[0][key] = value + + def __delitem__(self, key): + try: + del self.maps[0][key] + except KeyError: + raise KeyError( + 'Key not found in the first mapping: {!r}'.format(key)) + + def popitem(self): + 'Remove and return an item pair from maps[0]. Raise KeyError is maps[0] is empty.' + try: + return self.maps[0].popitem() + except KeyError: + raise KeyError('No keys found in the first mapping.') + + def pop(self, key, *args): + 'Remove *key* from maps[0] and return its value. Raise KeyError if *key* not in maps[0].' + try: + return self.maps[0].pop(key, *args) + except KeyError: + raise KeyError( + 'Key not found in the first mapping: {!r}'.format(key)) + + def clear(self): + 'Clear maps[0], leaving maps[1:] intact.' + self.maps[0].clear() + + +try: + from importlib.util import cache_from_source # Python >= 3.4 +except ImportError: # pragma: no cover + + def cache_from_source(path, debug_override=None): + assert path.endswith('.py') + if debug_override is None: + debug_override = __debug__ + if debug_override: + suffix = 'c' + else: + suffix = 'o' + return path + suffix + + +try: + from collections import OrderedDict +except ImportError: # pragma: no cover + # {{{ http://code.activestate.com/recipes/576693/ (r9) + # Backport of OrderedDict() class that runs on Python 2.4, 2.5, 2.6, 2.7 and pypy. + # Passes Python2.7's test suite and incorporates all the latest updates. + try: + from thread import get_ident as _get_ident + except ImportError: + from dummy_thread import get_ident as _get_ident + + try: + from _abcoll import KeysView, ValuesView, ItemsView + except ImportError: + pass + + class OrderedDict(dict): + 'Dictionary that remembers insertion order' + + # An inherited dict maps keys to values. + # The inherited dict provides __getitem__, __len__, __contains__, and get. + # The remaining methods are order-aware. + # Big-O running times for all methods are the same as for regular dictionaries. + + # The internal self.__map dictionary maps keys to links in a doubly linked list. + # The circular doubly linked list starts and ends with a sentinel element. + # The sentinel element never gets deleted (this simplifies the algorithm). + # Each link is stored as a list of length three: [PREV, NEXT, KEY]. + + def __init__(self, *args, **kwds): + '''Initialize an ordered dictionary. Signature is the same as for + regular dictionaries, but keyword arguments are not recommended + because their insertion order is arbitrary. + + ''' + if len(args) > 1: + raise TypeError('expected at most 1 arguments, got %d' % + len(args)) + try: + self.__root + except AttributeError: + self.__root = root = [] # sentinel node + root[:] = [root, root, None] + self.__map = {} + self.__update(*args, **kwds) + + def __setitem__(self, key, value, dict_setitem=dict.__setitem__): + 'od.__setitem__(i, y) <==> od[i]=y' + # Setting a new item creates a new link which goes at the end of the linked + # list, and the inherited dictionary is updated with the new key/value pair. + if key not in self: + root = self.__root + last = root[0] + last[1] = root[0] = self.__map[key] = [last, root, key] + dict_setitem(self, key, value) + + def __delitem__(self, key, dict_delitem=dict.__delitem__): + 'od.__delitem__(y) <==> del od[y]' + # Deleting an existing item uses self.__map to find the link which is + # then removed by updating the links in the predecessor and successor nodes. + dict_delitem(self, key) + link_prev, link_next, key = self.__map.pop(key) + link_prev[1] = link_next + link_next[0] = link_prev + + def __iter__(self): + 'od.__iter__() <==> iter(od)' + root = self.__root + curr = root[1] + while curr is not root: + yield curr[2] + curr = curr[1] + + def __reversed__(self): + 'od.__reversed__() <==> reversed(od)' + root = self.__root + curr = root[0] + while curr is not root: + yield curr[2] + curr = curr[0] + + def clear(self): + 'od.clear() -> None. Remove all items from od.' + try: + for node in self.__map.itervalues(): + del node[:] + root = self.__root + root[:] = [root, root, None] + self.__map.clear() + except AttributeError: + pass + dict.clear(self) + + def popitem(self, last=True): + '''od.popitem() -> (k, v), return and remove a (key, value) pair. + Pairs are returned in LIFO order if last is true or FIFO order if false. + + ''' + if not self: + raise KeyError('dictionary is empty') + root = self.__root + if last: + link = root[0] + link_prev = link[0] + link_prev[1] = root + root[0] = link_prev + else: + link = root[1] + link_next = link[1] + root[1] = link_next + link_next[0] = root + key = link[2] + del self.__map[key] + value = dict.pop(self, key) + return key, value + + # -- the following methods do not depend on the internal structure -- + + def keys(self): + 'od.keys() -> list of keys in od' + return list(self) + + def values(self): + 'od.values() -> list of values in od' + return [self[key] for key in self] + + def items(self): + 'od.items() -> list of (key, value) pairs in od' + return [(key, self[key]) for key in self] + + def iterkeys(self): + 'od.iterkeys() -> an iterator over the keys in od' + return iter(self) + + def itervalues(self): + 'od.itervalues -> an iterator over the values in od' + for k in self: + yield self[k] + + def iteritems(self): + 'od.iteritems -> an iterator over the (key, value) items in od' + for k in self: + yield (k, self[k]) + + def update(*args, **kwds): + '''od.update(E, **F) -> None. Update od from dict/iterable E and F. + + If E is a dict instance, does: for k in E: od[k] = E[k] + If E has a .keys() method, does: for k in E.keys(): od[k] = E[k] + Or if E is an iterable of items, does: for k, v in E: od[k] = v + In either case, this is followed by: for k, v in F.items(): od[k] = v + + ''' + if len(args) > 2: + raise TypeError('update() takes at most 2 positional ' + 'arguments (%d given)' % (len(args), )) + elif not args: + raise TypeError('update() takes at least 1 argument (0 given)') + self = args[0] + # Make progressively weaker assumptions about "other" + other = () + if len(args) == 2: + other = args[1] + if isinstance(other, dict): + for key in other: + self[key] = other[key] + elif hasattr(other, 'keys'): + for key in other.keys(): + self[key] = other[key] + else: + for key, value in other: + self[key] = value + for key, value in kwds.items(): + self[key] = value + + __update = update # let subclasses override update without breaking __init__ + + __marker = object() + + def pop(self, key, default=__marker): + '''od.pop(k[,d]) -> v, remove specified key and return the corresponding value. + If key is not found, d is returned if given, otherwise KeyError is raised. + + ''' + if key in self: + result = self[key] + del self[key] + return result + if default is self.__marker: + raise KeyError(key) + return default + + def setdefault(self, key, default=None): + 'od.setdefault(k[,d]) -> od.get(k,d), also set od[k]=d if k not in od' + if key in self: + return self[key] + self[key] = default + return default + + def __repr__(self, _repr_running=None): + 'od.__repr__() <==> repr(od)' + if not _repr_running: + _repr_running = {} + call_key = id(self), _get_ident() + if call_key in _repr_running: + return '...' + _repr_running[call_key] = 1 + try: + if not self: + return '%s()' % (self.__class__.__name__, ) + return '%s(%r)' % (self.__class__.__name__, self.items()) + finally: + del _repr_running[call_key] + + def __reduce__(self): + 'Return state information for pickling' + items = [[k, self[k]] for k in self] + inst_dict = vars(self).copy() + for k in vars(OrderedDict()): + inst_dict.pop(k, None) + if inst_dict: + return (self.__class__, (items, ), inst_dict) + return self.__class__, (items, ) + + def copy(self): + 'od.copy() -> a shallow copy of od' + return self.__class__(self) + + @classmethod + def fromkeys(cls, iterable, value=None): + '''OD.fromkeys(S[, v]) -> New ordered dictionary with keys from S + and values equal to v (which defaults to None). + + ''' + d = cls() + for key in iterable: + d[key] = value + return d + + def __eq__(self, other): + '''od.__eq__(y) <==> od==y. Comparison to another OD is order-sensitive + while comparison to a regular mapping is order-insensitive. + + ''' + if isinstance(other, OrderedDict): + return len(self) == len( + other) and self.items() == other.items() + return dict.__eq__(self, other) + + def __ne__(self, other): + return not self == other + + # -- the following methods are only used in Python 2.7 -- + + def viewkeys(self): + "od.viewkeys() -> a set-like object providing a view on od's keys" + return KeysView(self) + + def viewvalues(self): + "od.viewvalues() -> an object providing a view on od's values" + return ValuesView(self) + + def viewitems(self): + "od.viewitems() -> a set-like object providing a view on od's items" + return ItemsView(self) + + +try: + from logging.config import BaseConfigurator, valid_ident +except ImportError: # pragma: no cover + IDENTIFIER = re.compile('^[a-z_][a-z0-9_]*$', re.I) + + def valid_ident(s): + m = IDENTIFIER.match(s) + if not m: + raise ValueError('Not a valid Python identifier: %r' % s) + return True + + # The ConvertingXXX classes are wrappers around standard Python containers, + # and they serve to convert any suitable values in the container. The + # conversion converts base dicts, lists and tuples to their wrapped + # equivalents, whereas strings which match a conversion format are converted + # appropriately. + # + # Each wrapper should have a configurator attribute holding the actual + # configurator to use for conversion. + + class ConvertingDict(dict): + """A converting dictionary wrapper.""" + + def __getitem__(self, key): + value = dict.__getitem__(self, key) + result = self.configurator.convert(value) + # If the converted value is different, save for next time + if value is not result: + self[key] = result + if type(result) in (ConvertingDict, ConvertingList, + ConvertingTuple): + result.parent = self + result.key = key + return result + + def get(self, key, default=None): + value = dict.get(self, key, default) + result = self.configurator.convert(value) + # If the converted value is different, save for next time + if value is not result: + self[key] = result + if type(result) in (ConvertingDict, ConvertingList, + ConvertingTuple): + result.parent = self + result.key = key + return result + + def pop(self, key, default=None): + value = dict.pop(self, key, default) + result = self.configurator.convert(value) + if value is not result: + if type(result) in (ConvertingDict, ConvertingList, + ConvertingTuple): + result.parent = self + result.key = key + return result + + class ConvertingList(list): + """A converting list wrapper.""" + + def __getitem__(self, key): + value = list.__getitem__(self, key) + result = self.configurator.convert(value) + # If the converted value is different, save for next time + if value is not result: + self[key] = result + if type(result) in (ConvertingDict, ConvertingList, + ConvertingTuple): + result.parent = self + result.key = key + return result + + def pop(self, idx=-1): + value = list.pop(self, idx) + result = self.configurator.convert(value) + if value is not result: + if type(result) in (ConvertingDict, ConvertingList, + ConvertingTuple): + result.parent = self + return result + + class ConvertingTuple(tuple): + """A converting tuple wrapper.""" + + def __getitem__(self, key): + value = tuple.__getitem__(self, key) + result = self.configurator.convert(value) + if value is not result: + if type(result) in (ConvertingDict, ConvertingList, + ConvertingTuple): + result.parent = self + result.key = key + return result + + class BaseConfigurator(object): + """ + The configurator base class which defines some useful defaults. + """ + + CONVERT_PATTERN = re.compile(r'^(?P[a-z]+)://(?P.*)$') + + WORD_PATTERN = re.compile(r'^\s*(\w+)\s*') + DOT_PATTERN = re.compile(r'^\.\s*(\w+)\s*') + INDEX_PATTERN = re.compile(r'^\[\s*(\w+)\s*\]\s*') + DIGIT_PATTERN = re.compile(r'^\d+$') + + value_converters = { + 'ext': 'ext_convert', + 'cfg': 'cfg_convert', + } + + # We might want to use a different one, e.g. importlib + importer = staticmethod(__import__) + + def __init__(self, config): + self.config = ConvertingDict(config) + self.config.configurator = self + + def resolve(self, s): + """ + Resolve strings to objects using standard import and attribute + syntax. + """ + name = s.split('.') + used = name.pop(0) + try: + found = self.importer(used) + for frag in name: + used += '.' + frag + try: + found = getattr(found, frag) + except AttributeError: + self.importer(used) + found = getattr(found, frag) + return found + except ImportError: + e, tb = sys.exc_info()[1:] + v = ValueError('Cannot resolve %r: %s' % (s, e)) + v.__cause__, v.__traceback__ = e, tb + raise v + + def ext_convert(self, value): + """Default converter for the ext:// protocol.""" + return self.resolve(value) + + def cfg_convert(self, value): + """Default converter for the cfg:// protocol.""" + rest = value + m = self.WORD_PATTERN.match(rest) + if m is None: + raise ValueError("Unable to convert %r" % value) + else: + rest = rest[m.end():] + d = self.config[m.groups()[0]] + while rest: + m = self.DOT_PATTERN.match(rest) + if m: + d = d[m.groups()[0]] + else: + m = self.INDEX_PATTERN.match(rest) + if m: + idx = m.groups()[0] + if not self.DIGIT_PATTERN.match(idx): + d = d[idx] + else: + try: + n = int( + idx + ) # try as number first (most likely) + d = d[n] + except TypeError: + d = d[idx] + if m: + rest = rest[m.end():] + else: + raise ValueError('Unable to convert ' + '%r at %r' % (value, rest)) + # rest should be empty + return d + + def convert(self, value): + """ + Convert values to an appropriate type. dicts, lists and tuples are + replaced by their converting alternatives. Strings are checked to + see if they have a conversion format and are converted if they do. + """ + if not isinstance(value, ConvertingDict) and isinstance( + value, dict): + value = ConvertingDict(value) + value.configurator = self + elif not isinstance(value, ConvertingList) and isinstance( + value, list): + value = ConvertingList(value) + value.configurator = self + elif not isinstance(value, ConvertingTuple) and isinstance(value, tuple): + value = ConvertingTuple(value) + value.configurator = self + elif isinstance(value, string_types): + m = self.CONVERT_PATTERN.match(value) + if m: + d = m.groupdict() + prefix = d['prefix'] + converter = self.value_converters.get(prefix, None) + if converter: + suffix = d['suffix'] + converter = getattr(self, converter) + value = converter(suffix) + return value + + def configure_custom(self, config): + """Configure an object with a user-supplied factory.""" + c = config.pop('()') + if not callable(c): + c = self.resolve(c) + props = config.pop('.', None) + # Check for valid identifiers + kwargs = dict([(k, config[k]) for k in config if valid_ident(k)]) + result = c(**kwargs) + if props: + for name, value in props.items(): + setattr(result, name, value) + return result + + def as_tuple(self, value): + """Utility function which converts lists to tuples.""" + if isinstance(value, list): + value = tuple(value) + return value diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/database.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/database.py new file mode 100644 index 0000000..c0f896a --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/database.py @@ -0,0 +1,1329 @@ +# -*- coding: utf-8 -*- +# +# Copyright (C) 2012-2023 The Python Software Foundation. +# See LICENSE.txt and CONTRIBUTORS.txt. +# +"""PEP 376 implementation.""" + +from __future__ import unicode_literals + +import base64 +import codecs +import contextlib +import hashlib +import logging +import os +import posixpath +import sys +import zipimport + +from . import DistlibException, resources +from .compat import StringIO +from .version import get_scheme, UnsupportedVersionError +from .metadata import (Metadata, METADATA_FILENAME, WHEEL_METADATA_FILENAME, LEGACY_METADATA_FILENAME) +from .util import (parse_requirement, cached_property, parse_name_and_version, read_exports, write_exports, CSVReader, + CSVWriter) + +__all__ = [ + 'Distribution', 'BaseInstalledDistribution', 'InstalledDistribution', 'EggInfoDistribution', 'DistributionPath' +] + +logger = logging.getLogger(__name__) + +EXPORTS_FILENAME = 'pydist-exports.json' +COMMANDS_FILENAME = 'pydist-commands.json' + +DIST_FILES = ('INSTALLER', METADATA_FILENAME, 'RECORD', 'REQUESTED', 'RESOURCES', EXPORTS_FILENAME, 'SHARED') + +DISTINFO_EXT = '.dist-info' + + +class _Cache(object): + """ + A simple cache mapping names and .dist-info paths to distributions + """ + + def __init__(self): + """ + Initialise an instance. There is normally one for each DistributionPath. + """ + self.name = {} + self.path = {} + self.generated = False + + def clear(self): + """ + Clear the cache, setting it to its initial state. + """ + self.name.clear() + self.path.clear() + self.generated = False + + def add(self, dist): + """ + Add a distribution to the cache. + :param dist: The distribution to add. + """ + if dist.path not in self.path: + self.path[dist.path] = dist + self.name.setdefault(dist.key, []).append(dist) + + +class DistributionPath(object): + """ + Represents a set of distributions installed on a path (typically sys.path). + """ + + def __init__(self, path=None, include_egg=False): + """ + Create an instance from a path, optionally including legacy (distutils/ + setuptools/distribute) distributions. + :param path: The path to use, as a list of directories. If not specified, + sys.path is used. + :param include_egg: If True, this instance will look for and return legacy + distributions as well as those based on PEP 376. + """ + if path is None: + path = sys.path + self.path = path + self._include_dist = True + self._include_egg = include_egg + + self._cache = _Cache() + self._cache_egg = _Cache() + self._cache_enabled = True + self._scheme = get_scheme('default') + + def _get_cache_enabled(self): + return self._cache_enabled + + def _set_cache_enabled(self, value): + self._cache_enabled = value + + cache_enabled = property(_get_cache_enabled, _set_cache_enabled) + + def clear_cache(self): + """ + Clears the internal cache. + """ + self._cache.clear() + self._cache_egg.clear() + + def _yield_distributions(self): + """ + Yield .dist-info and/or .egg(-info) distributions. + """ + # We need to check if we've seen some resources already, because on + # some Linux systems (e.g. some Debian/Ubuntu variants) there are + # symlinks which alias other files in the environment. + seen = set() + for path in self.path: + finder = resources.finder_for_path(path) + if finder is None: + continue + r = finder.find('') + if not r or not r.is_container: + continue + rset = sorted(r.resources) + for entry in rset: + r = finder.find(entry) + if not r or r.path in seen: + continue + try: + if self._include_dist and entry.endswith(DISTINFO_EXT): + possible_filenames = [METADATA_FILENAME, WHEEL_METADATA_FILENAME, LEGACY_METADATA_FILENAME] + for metadata_filename in possible_filenames: + metadata_path = posixpath.join(entry, metadata_filename) + pydist = finder.find(metadata_path) + if pydist: + break + else: + continue + + with contextlib.closing(pydist.as_stream()) as stream: + metadata = Metadata(fileobj=stream, scheme='legacy') + logger.debug('Found %s', r.path) + seen.add(r.path) + yield new_dist_class(r.path, metadata=metadata, env=self) + elif self._include_egg and entry.endswith(('.egg-info', '.egg')): + logger.debug('Found %s', r.path) + seen.add(r.path) + yield old_dist_class(r.path, self) + except Exception as e: + msg = 'Unable to read distribution at %s, perhaps due to bad metadata: %s' + logger.warning(msg, r.path, e) + import warnings + warnings.warn(msg % (r.path, e), stacklevel=2) + + def _generate_cache(self): + """ + Scan the path for distributions and populate the cache with + those that are found. + """ + gen_dist = not self._cache.generated + gen_egg = self._include_egg and not self._cache_egg.generated + if gen_dist or gen_egg: + for dist in self._yield_distributions(): + if isinstance(dist, InstalledDistribution): + self._cache.add(dist) + else: + self._cache_egg.add(dist) + + if gen_dist: + self._cache.generated = True + if gen_egg: + self._cache_egg.generated = True + + @classmethod + def distinfo_dirname(cls, name, version): + """ + The *name* and *version* parameters are converted into their + filename-escaped form, i.e. any ``'-'`` characters are replaced + with ``'_'`` other than the one in ``'dist-info'`` and the one + separating the name from the version number. + + :parameter name: is converted to a standard distribution name by replacing + any runs of non- alphanumeric characters with a single + ``'-'``. + :type name: string + :parameter version: is converted to a standard version string. Spaces + become dots, and all other non-alphanumeric characters + (except dots) become dashes, with runs of multiple + dashes condensed to a single dash. + :type version: string + :returns: directory name + :rtype: string""" + name = name.replace('-', '_') + return '-'.join([name, version]) + DISTINFO_EXT + + def get_distributions(self): + """ + Provides an iterator that looks for distributions and returns + :class:`InstalledDistribution` or + :class:`EggInfoDistribution` instances for each one of them. + + :rtype: iterator of :class:`InstalledDistribution` and + :class:`EggInfoDistribution` instances + """ + if not self._cache_enabled: + for dist in self._yield_distributions(): + yield dist + else: + self._generate_cache() + + for dist in self._cache.path.values(): + yield dist + + if self._include_egg: + for dist in self._cache_egg.path.values(): + yield dist + + def get_distribution(self, name): + """ + Looks for a named distribution on the path. + + This function only returns the first result found, as no more than one + value is expected. If nothing is found, ``None`` is returned. + + :rtype: :class:`InstalledDistribution`, :class:`EggInfoDistribution` + or ``None`` + """ + result = None + name = name.lower() + if not self._cache_enabled: + for dist in self._yield_distributions(): + if dist.key == name: + result = dist + break + else: + self._generate_cache() + + if name in self._cache.name: + result = self._cache.name[name][0] + elif self._include_egg and name in self._cache_egg.name: + result = self._cache_egg.name[name][0] + return result + + def provides_distribution(self, name, version=None): + """ + Iterates over all distributions to find which distributions provide *name*. + If a *version* is provided, it will be used to filter the results. + + This function only returns the first result found, since no more than + one values are expected. If the directory is not found, returns ``None``. + + :parameter version: a version specifier that indicates the version + required, conforming to the format in ``PEP-345`` + + :type name: string + :type version: string + """ + matcher = None + if version is not None: + try: + matcher = self._scheme.matcher('%s (%s)' % (name, version)) + except ValueError: + raise DistlibException('invalid name or version: %r, %r' % (name, version)) + + for dist in self.get_distributions(): + # We hit a problem on Travis where enum34 was installed and doesn't + # have a provides attribute ... + if not hasattr(dist, 'provides'): + logger.debug('No "provides": %s', dist) + else: + provided = dist.provides + + for p in provided: + p_name, p_ver = parse_name_and_version(p) + if matcher is None: + if p_name == name: + yield dist + break + else: + if p_name == name and matcher.match(p_ver): + yield dist + break + + def get_file_path(self, name, relative_path): + """ + Return the path to a resource file. + """ + dist = self.get_distribution(name) + if dist is None: + raise LookupError('no distribution named %r found' % name) + return dist.get_resource_path(relative_path) + + def get_exported_entries(self, category, name=None): + """ + Return all of the exported entries in a particular category. + + :param category: The category to search for entries. + :param name: If specified, only entries with that name are returned. + """ + for dist in self.get_distributions(): + r = dist.exports + if category in r: + d = r[category] + if name is not None: + if name in d: + yield d[name] + else: + for v in d.values(): + yield v + + +class Distribution(object): + """ + A base class for distributions, whether installed or from indexes. + Either way, it must have some metadata, so that's all that's needed + for construction. + """ + + build_time_dependency = False + """ + Set to True if it's known to be only a build-time dependency (i.e. + not needed after installation). + """ + + requested = False + """A boolean that indicates whether the ``REQUESTED`` metadata file is + present (in other words, whether the package was installed by user + request or it was installed as a dependency).""" + + def __init__(self, metadata): + """ + Initialise an instance. + :param metadata: The instance of :class:`Metadata` describing this + distribution. + """ + self.metadata = metadata + self.name = metadata.name + self.key = self.name.lower() # for case-insensitive comparisons + self.version = metadata.version + self.locator = None + self.digest = None + self.extras = None # additional features requested + self.context = None # environment marker overrides + self.download_urls = set() + self.digests = {} + + @property + def source_url(self): + """ + The source archive download URL for this distribution. + """ + return self.metadata.source_url + + download_url = source_url # Backward compatibility + + @property + def name_and_version(self): + """ + A utility property which displays the name and version in parentheses. + """ + return '%s (%s)' % (self.name, self.version) + + @property + def provides(self): + """ + A set of distribution names and versions provided by this distribution. + :return: A set of "name (version)" strings. + """ + plist = self.metadata.provides + s = '%s (%s)' % (self.name, self.version) + if s not in plist: + plist.append(s) + return plist + + def _get_requirements(self, req_attr): + md = self.metadata + reqts = getattr(md, req_attr) + logger.debug('%s: got requirements %r from metadata: %r', self.name, req_attr, reqts) + return set(md.get_requirements(reqts, extras=self.extras, env=self.context)) + + @property + def run_requires(self): + return self._get_requirements('run_requires') + + @property + def meta_requires(self): + return self._get_requirements('meta_requires') + + @property + def build_requires(self): + return self._get_requirements('build_requires') + + @property + def test_requires(self): + return self._get_requirements('test_requires') + + @property + def dev_requires(self): + return self._get_requirements('dev_requires') + + def matches_requirement(self, req): + """ + Say if this instance matches (fulfills) a requirement. + :param req: The requirement to match. + :rtype req: str + :return: True if it matches, else False. + """ + # Requirement may contain extras - parse to lose those + # from what's passed to the matcher + r = parse_requirement(req) + scheme = get_scheme(self.metadata.scheme) + try: + matcher = scheme.matcher(r.requirement) + except UnsupportedVersionError: + # XXX compat-mode if cannot read the version + logger.warning('could not read version %r - using name only', req) + name = req.split()[0] + matcher = scheme.matcher(name) + + name = matcher.key # case-insensitive + + result = False + for p in self.provides: + p_name, p_ver = parse_name_and_version(p) + if p_name != name: + continue + try: + result = matcher.match(p_ver) + break + except UnsupportedVersionError: + pass + return result + + def __repr__(self): + """ + Return a textual representation of this instance, + """ + if self.source_url: + suffix = ' [%s]' % self.source_url + else: + suffix = '' + return '' % (self.name, self.version, suffix) + + def __eq__(self, other): + """ + See if this distribution is the same as another. + :param other: The distribution to compare with. To be equal to one + another. distributions must have the same type, name, + version and source_url. + :return: True if it is the same, else False. + """ + if type(other) is not type(self): + result = False + else: + result = (self.name == other.name and self.version == other.version and self.source_url == other.source_url) + return result + + def __hash__(self): + """ + Compute hash in a way which matches the equality test. + """ + return hash(self.name) + hash(self.version) + hash(self.source_url) + + +class BaseInstalledDistribution(Distribution): + """ + This is the base class for installed distributions (whether PEP 376 or + legacy). + """ + + hasher = None + + def __init__(self, metadata, path, env=None): + """ + Initialise an instance. + :param metadata: An instance of :class:`Metadata` which describes the + distribution. This will normally have been initialised + from a metadata file in the ``path``. + :param path: The path of the ``.dist-info`` or ``.egg-info`` + directory for the distribution. + :param env: This is normally the :class:`DistributionPath` + instance where this distribution was found. + """ + super(BaseInstalledDistribution, self).__init__(metadata) + self.path = path + self.dist_path = env + + def get_hash(self, data, hasher=None): + """ + Get the hash of some data, using a particular hash algorithm, if + specified. + + :param data: The data to be hashed. + :type data: bytes + :param hasher: The name of a hash implementation, supported by hashlib, + or ``None``. Examples of valid values are ``'sha1'``, + ``'sha224'``, ``'sha384'``, '``sha256'``, ``'md5'`` and + ``'sha512'``. If no hasher is specified, the ``hasher`` + attribute of the :class:`InstalledDistribution` instance + is used. If the hasher is determined to be ``None``, MD5 + is used as the hashing algorithm. + :returns: The hash of the data. If a hasher was explicitly specified, + the returned hash will be prefixed with the specified hasher + followed by '='. + :rtype: str + """ + if hasher is None: + hasher = self.hasher + if hasher is None: + hasher = hashlib.md5 + prefix = '' + else: + hasher = getattr(hashlib, hasher) + prefix = '%s=' % self.hasher + digest = hasher(data).digest() + digest = base64.urlsafe_b64encode(digest).rstrip(b'=').decode('ascii') + return '%s%s' % (prefix, digest) + + +class InstalledDistribution(BaseInstalledDistribution): + """ + Created with the *path* of the ``.dist-info`` directory provided to the + constructor. It reads the metadata contained in ``pydist.json`` when it is + instantiated., or uses a passed in Metadata instance (useful for when + dry-run mode is being used). + """ + + hasher = 'sha256' + + def __init__(self, path, metadata=None, env=None): + self.modules = [] + self.finder = finder = resources.finder_for_path(path) + if finder is None: + raise ValueError('finder unavailable for %s' % path) + if env and env._cache_enabled and path in env._cache.path: + metadata = env._cache.path[path].metadata + elif metadata is None: + r = finder.find(METADATA_FILENAME) + # Temporary - for Wheel 0.23 support + if r is None: + r = finder.find(WHEEL_METADATA_FILENAME) + # Temporary - for legacy support + if r is None: + r = finder.find(LEGACY_METADATA_FILENAME) + if r is None: + raise ValueError('no %s found in %s' % (METADATA_FILENAME, path)) + with contextlib.closing(r.as_stream()) as stream: + metadata = Metadata(fileobj=stream, scheme='legacy') + + super(InstalledDistribution, self).__init__(metadata, path, env) + + if env and env._cache_enabled: + env._cache.add(self) + + r = finder.find('REQUESTED') + self.requested = r is not None + p = os.path.join(path, 'top_level.txt') + if os.path.exists(p): + with open(p, 'rb') as f: + data = f.read().decode('utf-8') + self.modules = data.splitlines() + + def __repr__(self): + return '' % (self.name, self.version, self.path) + + def __str__(self): + return "%s %s" % (self.name, self.version) + + def _get_records(self): + """ + Get the list of installed files for the distribution + :return: A list of tuples of path, hash and size. Note that hash and + size might be ``None`` for some entries. The path is exactly + as stored in the file (which is as in PEP 376). + """ + results = [] + r = self.get_distinfo_resource('RECORD') + with contextlib.closing(r.as_stream()) as stream: + with CSVReader(stream=stream) as record_reader: + # Base location is parent dir of .dist-info dir + # base_location = os.path.dirname(self.path) + # base_location = os.path.abspath(base_location) + for row in record_reader: + missing = [None for i in range(len(row), 3)] + path, checksum, size = row + missing + # if not os.path.isabs(path): + # path = path.replace('/', os.sep) + # path = os.path.join(base_location, path) + results.append((path, checksum, size)) + return results + + @cached_property + def exports(self): + """ + Return the information exported by this distribution. + :return: A dictionary of exports, mapping an export category to a dict + of :class:`ExportEntry` instances describing the individual + export entries, and keyed by name. + """ + result = {} + r = self.get_distinfo_resource(EXPORTS_FILENAME) + if r: + result = self.read_exports() + return result + + def read_exports(self): + """ + Read exports data from a file in .ini format. + + :return: A dictionary of exports, mapping an export category to a list + of :class:`ExportEntry` instances describing the individual + export entries. + """ + result = {} + r = self.get_distinfo_resource(EXPORTS_FILENAME) + if r: + with contextlib.closing(r.as_stream()) as stream: + result = read_exports(stream) + return result + + def write_exports(self, exports): + """ + Write a dictionary of exports to a file in .ini format. + :param exports: A dictionary of exports, mapping an export category to + a list of :class:`ExportEntry` instances describing the + individual export entries. + """ + rf = self.get_distinfo_file(EXPORTS_FILENAME) + with open(rf, 'w') as f: + write_exports(exports, f) + + def get_resource_path(self, relative_path): + """ + NOTE: This API may change in the future. + + Return the absolute path to a resource file with the given relative + path. + + :param relative_path: The path, relative to .dist-info, of the resource + of interest. + :return: The absolute path where the resource is to be found. + """ + r = self.get_distinfo_resource('RESOURCES') + with contextlib.closing(r.as_stream()) as stream: + with CSVReader(stream=stream) as resources_reader: + for relative, destination in resources_reader: + if relative == relative_path: + return destination + raise KeyError('no resource file with relative path %r ' + 'is installed' % relative_path) + + def list_installed_files(self): + """ + Iterates over the ``RECORD`` entries and returns a tuple + ``(path, hash, size)`` for each line. + + :returns: iterator of (path, hash, size) + """ + for result in self._get_records(): + yield result + + def write_installed_files(self, paths, prefix, dry_run=False): + """ + Writes the ``RECORD`` file, using the ``paths`` iterable passed in. Any + existing ``RECORD`` file is silently overwritten. + + prefix is used to determine when to write absolute paths. + """ + prefix = os.path.join(prefix, '') + base = os.path.dirname(self.path) + base_under_prefix = base.startswith(prefix) + base = os.path.join(base, '') + record_path = self.get_distinfo_file('RECORD') + logger.info('creating %s', record_path) + if dry_run: + return None + with CSVWriter(record_path) as writer: + for path in paths: + if os.path.isdir(path) or path.endswith(('.pyc', '.pyo')): + # do not put size and hash, as in PEP-376 + hash_value = size = '' + else: + size = '%d' % os.path.getsize(path) + with open(path, 'rb') as fp: + hash_value = self.get_hash(fp.read()) + if path.startswith(base) or (base_under_prefix and path.startswith(prefix)): + path = os.path.relpath(path, base) + writer.writerow((path, hash_value, size)) + + # add the RECORD file itself + if record_path.startswith(base): + record_path = os.path.relpath(record_path, base) + writer.writerow((record_path, '', '')) + return record_path + + def check_installed_files(self): + """ + Checks that the hashes and sizes of the files in ``RECORD`` are + matched by the files themselves. Returns a (possibly empty) list of + mismatches. Each entry in the mismatch list will be a tuple consisting + of the path, 'exists', 'size' or 'hash' according to what didn't match + (existence is checked first, then size, then hash), the expected + value and the actual value. + """ + mismatches = [] + base = os.path.dirname(self.path) + record_path = self.get_distinfo_file('RECORD') + for path, hash_value, size in self.list_installed_files(): + if not os.path.isabs(path): + path = os.path.join(base, path) + if path == record_path: + continue + if not os.path.exists(path): + mismatches.append((path, 'exists', True, False)) + elif os.path.isfile(path): + actual_size = str(os.path.getsize(path)) + if size and actual_size != size: + mismatches.append((path, 'size', size, actual_size)) + elif hash_value: + if '=' in hash_value: + hasher = hash_value.split('=', 1)[0] + else: + hasher = None + + with open(path, 'rb') as f: + actual_hash = self.get_hash(f.read(), hasher) + if actual_hash != hash_value: + mismatches.append((path, 'hash', hash_value, actual_hash)) + return mismatches + + @cached_property + def shared_locations(self): + """ + A dictionary of shared locations whose keys are in the set 'prefix', + 'purelib', 'platlib', 'scripts', 'headers', 'data' and 'namespace'. + The corresponding value is the absolute path of that category for + this distribution, and takes into account any paths selected by the + user at installation time (e.g. via command-line arguments). In the + case of the 'namespace' key, this would be a list of absolute paths + for the roots of namespace packages in this distribution. + + The first time this property is accessed, the relevant information is + read from the SHARED file in the .dist-info directory. + """ + result = {} + shared_path = os.path.join(self.path, 'SHARED') + if os.path.isfile(shared_path): + with codecs.open(shared_path, 'r', encoding='utf-8') as f: + lines = f.read().splitlines() + for line in lines: + key, value = line.split('=', 1) + if key == 'namespace': + result.setdefault(key, []).append(value) + else: + result[key] = value + return result + + def write_shared_locations(self, paths, dry_run=False): + """ + Write shared location information to the SHARED file in .dist-info. + :param paths: A dictionary as described in the documentation for + :meth:`shared_locations`. + :param dry_run: If True, the action is logged but no file is actually + written. + :return: The path of the file written to. + """ + shared_path = os.path.join(self.path, 'SHARED') + logger.info('creating %s', shared_path) + if dry_run: + return None + lines = [] + for key in ('prefix', 'lib', 'headers', 'scripts', 'data'): + path = paths[key] + if os.path.isdir(paths[key]): + lines.append('%s=%s' % (key, path)) + for ns in paths.get('namespace', ()): + lines.append('namespace=%s' % ns) + + with codecs.open(shared_path, 'w', encoding='utf-8') as f: + f.write('\n'.join(lines)) + return shared_path + + def get_distinfo_resource(self, path): + if path not in DIST_FILES: + raise DistlibException('invalid path for a dist-info file: ' + '%r at %r' % (path, self.path)) + finder = resources.finder_for_path(self.path) + if finder is None: + raise DistlibException('Unable to get a finder for %s' % self.path) + return finder.find(path) + + def get_distinfo_file(self, path): + """ + Returns a path located under the ``.dist-info`` directory. Returns a + string representing the path. + + :parameter path: a ``'/'``-separated path relative to the + ``.dist-info`` directory or an absolute path; + If *path* is an absolute path and doesn't start + with the ``.dist-info`` directory path, + a :class:`DistlibException` is raised + :type path: str + :rtype: str + """ + # Check if it is an absolute path # XXX use relpath, add tests + if path.find(os.sep) >= 0: + # it's an absolute path? + distinfo_dirname, path = path.split(os.sep)[-2:] + if distinfo_dirname != self.path.split(os.sep)[-1]: + raise DistlibException('dist-info file %r does not belong to the %r %s ' + 'distribution' % (path, self.name, self.version)) + + # The file must be relative + if path not in DIST_FILES: + raise DistlibException('invalid path for a dist-info file: ' + '%r at %r' % (path, self.path)) + + return os.path.join(self.path, path) + + def list_distinfo_files(self): + """ + Iterates over the ``RECORD`` entries and returns paths for each line if + the path is pointing to a file located in the ``.dist-info`` directory + or one of its subdirectories. + + :returns: iterator of paths + """ + base = os.path.dirname(self.path) + for path, checksum, size in self._get_records(): + # XXX add separator or use real relpath algo + if not os.path.isabs(path): + path = os.path.join(base, path) + if path.startswith(self.path): + yield path + + def __eq__(self, other): + return (isinstance(other, InstalledDistribution) and self.path == other.path) + + # See http://docs.python.org/reference/datamodel#object.__hash__ + __hash__ = object.__hash__ + + +class EggInfoDistribution(BaseInstalledDistribution): + """Created with the *path* of the ``.egg-info`` directory or file provided + to the constructor. It reads the metadata contained in the file itself, or + if the given path happens to be a directory, the metadata is read from the + file ``PKG-INFO`` under that directory.""" + + requested = True # as we have no way of knowing, assume it was + shared_locations = {} + + def __init__(self, path, env=None): + + def set_name_and_version(s, n, v): + s.name = n + s.key = n.lower() # for case-insensitive comparisons + s.version = v + + self.path = path + self.dist_path = env + if env and env._cache_enabled and path in env._cache_egg.path: + metadata = env._cache_egg.path[path].metadata + set_name_and_version(self, metadata.name, metadata.version) + else: + metadata = self._get_metadata(path) + + # Need to be set before caching + set_name_and_version(self, metadata.name, metadata.version) + + if env and env._cache_enabled: + env._cache_egg.add(self) + super(EggInfoDistribution, self).__init__(metadata, path, env) + + def _get_metadata(self, path): + requires = None + + def parse_requires_data(data): + """Create a list of dependencies from a requires.txt file. + + *data*: the contents of a setuptools-produced requires.txt file. + """ + reqs = [] + lines = data.splitlines() + for line in lines: + line = line.strip() + # sectioned files have bare newlines (separating sections) + if not line: # pragma: no cover + continue + if line.startswith('['): # pragma: no cover + logger.warning('Unexpected line: quitting requirement scan: %r', line) + break + r = parse_requirement(line) + if not r: # pragma: no cover + logger.warning('Not recognised as a requirement: %r', line) + continue + if r.extras: # pragma: no cover + logger.warning('extra requirements in requires.txt are ' + 'not supported') + if not r.constraints: + reqs.append(r.name) + else: + cons = ', '.join('%s%s' % c for c in r.constraints) + reqs.append('%s (%s)' % (r.name, cons)) + return reqs + + def parse_requires_path(req_path): + """Create a list of dependencies from a requires.txt file. + + *req_path*: the path to a setuptools-produced requires.txt file. + """ + + reqs = [] + try: + with codecs.open(req_path, 'r', 'utf-8') as fp: + reqs = parse_requires_data(fp.read()) + except IOError: + pass + return reqs + + tl_path = tl_data = None + if path.endswith('.egg'): + if os.path.isdir(path): + p = os.path.join(path, 'EGG-INFO') + meta_path = os.path.join(p, 'PKG-INFO') + metadata = Metadata(path=meta_path, scheme='legacy') + req_path = os.path.join(p, 'requires.txt') + tl_path = os.path.join(p, 'top_level.txt') + requires = parse_requires_path(req_path) + else: + # FIXME handle the case where zipfile is not available + zipf = zipimport.zipimporter(path) + fileobj = StringIO(zipf.get_data('EGG-INFO/PKG-INFO').decode('utf8')) + metadata = Metadata(fileobj=fileobj, scheme='legacy') + try: + data = zipf.get_data('EGG-INFO/requires.txt') + tl_data = zipf.get_data('EGG-INFO/top_level.txt').decode('utf-8') + requires = parse_requires_data(data.decode('utf-8')) + except IOError: + requires = None + elif path.endswith('.egg-info'): + if os.path.isdir(path): + req_path = os.path.join(path, 'requires.txt') + requires = parse_requires_path(req_path) + path = os.path.join(path, 'PKG-INFO') + tl_path = os.path.join(path, 'top_level.txt') + metadata = Metadata(path=path, scheme='legacy') + else: + raise DistlibException('path must end with .egg-info or .egg, ' + 'got %r' % path) + + if requires: + metadata.add_requirements(requires) + # look for top-level modules in top_level.txt, if present + if tl_data is None: + if tl_path is not None and os.path.exists(tl_path): + with open(tl_path, 'rb') as f: + tl_data = f.read().decode('utf-8') + if not tl_data: + tl_data = [] + else: + tl_data = tl_data.splitlines() + self.modules = tl_data + return metadata + + def __repr__(self): + return '' % (self.name, self.version, self.path) + + def __str__(self): + return "%s %s" % (self.name, self.version) + + def check_installed_files(self): + """ + Checks that the hashes and sizes of the files in ``RECORD`` are + matched by the files themselves. Returns a (possibly empty) list of + mismatches. Each entry in the mismatch list will be a tuple consisting + of the path, 'exists', 'size' or 'hash' according to what didn't match + (existence is checked first, then size, then hash), the expected + value and the actual value. + """ + mismatches = [] + record_path = os.path.join(self.path, 'installed-files.txt') + if os.path.exists(record_path): + for path, _, _ in self.list_installed_files(): + if path == record_path: + continue + if not os.path.exists(path): + mismatches.append((path, 'exists', True, False)) + return mismatches + + def list_installed_files(self): + """ + Iterates over the ``installed-files.txt`` entries and returns a tuple + ``(path, hash, size)`` for each line. + + :returns: a list of (path, hash, size) + """ + + def _md5(path): + f = open(path, 'rb') + try: + content = f.read() + finally: + f.close() + return hashlib.md5(content).hexdigest() + + def _size(path): + return os.stat(path).st_size + + record_path = os.path.join(self.path, 'installed-files.txt') + result = [] + if os.path.exists(record_path): + with codecs.open(record_path, 'r', encoding='utf-8') as f: + for line in f: + line = line.strip() + p = os.path.normpath(os.path.join(self.path, line)) + # "./" is present as a marker between installed files + # and installation metadata files + if not os.path.exists(p): + logger.warning('Non-existent file: %s', p) + if p.endswith(('.pyc', '.pyo')): + continue + # otherwise fall through and fail + if not os.path.isdir(p): + result.append((p, _md5(p), _size(p))) + result.append((record_path, None, None)) + return result + + def list_distinfo_files(self, absolute=False): + """ + Iterates over the ``installed-files.txt`` entries and returns paths for + each line if the path is pointing to a file located in the + ``.egg-info`` directory or one of its subdirectories. + + :parameter absolute: If *absolute* is ``True``, each returned path is + transformed into a local absolute path. Otherwise the + raw value from ``installed-files.txt`` is returned. + :type absolute: boolean + :returns: iterator of paths + """ + record_path = os.path.join(self.path, 'installed-files.txt') + if os.path.exists(record_path): + skip = True + with codecs.open(record_path, 'r', encoding='utf-8') as f: + for line in f: + line = line.strip() + if line == './': + skip = False + continue + if not skip: + p = os.path.normpath(os.path.join(self.path, line)) + if p.startswith(self.path): + if absolute: + yield p + else: + yield line + + def __eq__(self, other): + return (isinstance(other, EggInfoDistribution) and self.path == other.path) + + # See http://docs.python.org/reference/datamodel#object.__hash__ + __hash__ = object.__hash__ + + +new_dist_class = InstalledDistribution +old_dist_class = EggInfoDistribution + + +class DependencyGraph(object): + """ + Represents a dependency graph between distributions. + + The dependency relationships are stored in an ``adjacency_list`` that maps + distributions to a list of ``(other, label)`` tuples where ``other`` + is a distribution and the edge is labeled with ``label`` (i.e. the version + specifier, if such was provided). Also, for more efficient traversal, for + every distribution ``x``, a list of predecessors is kept in + ``reverse_list[x]``. An edge from distribution ``a`` to + distribution ``b`` means that ``a`` depends on ``b``. If any missing + dependencies are found, they are stored in ``missing``, which is a + dictionary that maps distributions to a list of requirements that were not + provided by any other distributions. + """ + + def __init__(self): + self.adjacency_list = {} + self.reverse_list = {} + self.missing = {} + + def add_distribution(self, distribution): + """Add the *distribution* to the graph. + + :type distribution: :class:`distutils2.database.InstalledDistribution` + or :class:`distutils2.database.EggInfoDistribution` + """ + self.adjacency_list[distribution] = [] + self.reverse_list[distribution] = [] + # self.missing[distribution] = [] + + def add_edge(self, x, y, label=None): + """Add an edge from distribution *x* to distribution *y* with the given + *label*. + + :type x: :class:`distutils2.database.InstalledDistribution` or + :class:`distutils2.database.EggInfoDistribution` + :type y: :class:`distutils2.database.InstalledDistribution` or + :class:`distutils2.database.EggInfoDistribution` + :type label: ``str`` or ``None`` + """ + self.adjacency_list[x].append((y, label)) + # multiple edges are allowed, so be careful + if x not in self.reverse_list[y]: + self.reverse_list[y].append(x) + + def add_missing(self, distribution, requirement): + """ + Add a missing *requirement* for the given *distribution*. + + :type distribution: :class:`distutils2.database.InstalledDistribution` + or :class:`distutils2.database.EggInfoDistribution` + :type requirement: ``str`` + """ + logger.debug('%s missing %r', distribution, requirement) + self.missing.setdefault(distribution, []).append(requirement) + + def _repr_dist(self, dist): + return '%s %s' % (dist.name, dist.version) + + def repr_node(self, dist, level=1): + """Prints only a subgraph""" + output = [self._repr_dist(dist)] + for other, label in self.adjacency_list[dist]: + dist = self._repr_dist(other) + if label is not None: + dist = '%s [%s]' % (dist, label) + output.append(' ' * level + str(dist)) + suboutput = self.repr_node(other, level + 1) + subs = suboutput.split('\n') + output.extend(subs[1:]) + return '\n'.join(output) + + def to_dot(self, f, skip_disconnected=True): + """Writes a DOT output for the graph to the provided file *f*. + + If *skip_disconnected* is set to ``True``, then all distributions + that are not dependent on any other distribution are skipped. + + :type f: has to support ``file``-like operations + :type skip_disconnected: ``bool`` + """ + disconnected = [] + + f.write("digraph dependencies {\n") + for dist, adjs in self.adjacency_list.items(): + if len(adjs) == 0 and not skip_disconnected: + disconnected.append(dist) + for other, label in adjs: + if label is not None: + f.write('"%s" -> "%s" [label="%s"]\n' % (dist.name, other.name, label)) + else: + f.write('"%s" -> "%s"\n' % (dist.name, other.name)) + if not skip_disconnected and len(disconnected) > 0: + f.write('subgraph disconnected {\n') + f.write('label = "Disconnected"\n') + f.write('bgcolor = red\n') + + for dist in disconnected: + f.write('"%s"' % dist.name) + f.write('\n') + f.write('}\n') + f.write('}\n') + + def topological_sort(self): + """ + Perform a topological sort of the graph. + :return: A tuple, the first element of which is a topologically sorted + list of distributions, and the second element of which is a + list of distributions that cannot be sorted because they have + circular dependencies and so form a cycle. + """ + result = [] + # Make a shallow copy of the adjacency list + alist = {} + for k, v in self.adjacency_list.items(): + alist[k] = v[:] + while True: + # See what we can remove in this run + to_remove = [] + for k, v in list(alist.items())[:]: + if not v: + to_remove.append(k) + del alist[k] + if not to_remove: + # What's left in alist (if anything) is a cycle. + break + # Remove from the adjacency list of others + for k, v in alist.items(): + alist[k] = [(d, r) for d, r in v if d not in to_remove] + logger.debug('Moving to result: %s', ['%s (%s)' % (d.name, d.version) for d in to_remove]) + result.extend(to_remove) + return result, list(alist.keys()) + + def __repr__(self): + """Representation of the graph""" + output = [] + for dist, adjs in self.adjacency_list.items(): + output.append(self.repr_node(dist)) + return '\n'.join(output) + + +def make_graph(dists, scheme='default'): + """Makes a dependency graph from the given distributions. + + :parameter dists: a list of distributions + :type dists: list of :class:`distutils2.database.InstalledDistribution` and + :class:`distutils2.database.EggInfoDistribution` instances + :rtype: a :class:`DependencyGraph` instance + """ + scheme = get_scheme(scheme) + graph = DependencyGraph() + provided = {} # maps names to lists of (version, dist) tuples + + # first, build the graph and find out what's provided + for dist in dists: + graph.add_distribution(dist) + + for p in dist.provides: + name, version = parse_name_and_version(p) + logger.debug('Add to provided: %s, %s, %s', name, version, dist) + provided.setdefault(name, []).append((version, dist)) + + # now make the edges + for dist in dists: + requires = (dist.run_requires | dist.meta_requires | dist.build_requires | dist.dev_requires) + for req in requires: + try: + matcher = scheme.matcher(req) + except UnsupportedVersionError: + # XXX compat-mode if cannot read the version + logger.warning('could not read version %r - using name only', req) + name = req.split()[0] + matcher = scheme.matcher(name) + + name = matcher.key # case-insensitive + + matched = False + if name in provided: + for version, provider in provided[name]: + try: + match = matcher.match(version) + except UnsupportedVersionError: + match = False + + if match: + graph.add_edge(dist, provider, req) + matched = True + break + if not matched: + graph.add_missing(dist, req) + return graph + + +def get_dependent_dists(dists, dist): + """Recursively generate a list of distributions from *dists* that are + dependent on *dist*. + + :param dists: a list of distributions + :param dist: a distribution, member of *dists* for which we are interested + """ + if dist not in dists: + raise DistlibException('given distribution %r is not a member ' + 'of the list' % dist.name) + graph = make_graph(dists) + + dep = [dist] # dependent distributions + todo = graph.reverse_list[dist] # list of nodes we should inspect + + while todo: + d = todo.pop() + dep.append(d) + for succ in graph.reverse_list[d]: + if succ not in dep: + todo.append(succ) + + dep.pop(0) # remove dist from dep, was there to prevent infinite loops + return dep + + +def get_required_dists(dists, dist): + """Recursively generate a list of distributions from *dists* that are + required by *dist*. + + :param dists: a list of distributions + :param dist: a distribution, member of *dists* for which we are interested + in finding the dependencies. + """ + if dist not in dists: + raise DistlibException('given distribution %r is not a member ' + 'of the list' % dist.name) + graph = make_graph(dists) + + req = set() # required distributions + todo = graph.adjacency_list[dist] # list of nodes we should inspect + seen = set(t[0] for t in todo) # already added to todo + + while todo: + d = todo.pop()[0] + req.add(d) + pred_list = graph.adjacency_list[d] + for pred in pred_list: + d = pred[0] + if d not in req and d not in seen: + seen.add(d) + todo.append(pred) + return req + + +def make_dist(name, version, **kwargs): + """ + A convenience method for making a dist given just a name and version. + """ + summary = kwargs.pop('summary', 'Placeholder for summary') + md = Metadata(**kwargs) + md.name = name + md.version = version + md.summary = summary or 'Placeholder for summary' + return Distribution(md) diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/index.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/index.py new file mode 100644 index 0000000..56cd286 --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/index.py @@ -0,0 +1,508 @@ +# -*- coding: utf-8 -*- +# +# Copyright (C) 2013-2023 Vinay Sajip. +# Licensed to the Python Software Foundation under a contributor agreement. +# See LICENSE.txt and CONTRIBUTORS.txt. +# +import hashlib +import logging +import os +import shutil +import subprocess +import tempfile +try: + from threading import Thread +except ImportError: # pragma: no cover + from dummy_threading import Thread + +from . import DistlibException +from .compat import (HTTPBasicAuthHandler, Request, HTTPPasswordMgr, + urlparse, build_opener, string_types) +from .util import zip_dir, ServerProxy + +logger = logging.getLogger(__name__) + +DEFAULT_INDEX = 'https://pypi.org/pypi' +DEFAULT_REALM = 'pypi' + + +class PackageIndex(object): + """ + This class represents a package index compatible with PyPI, the Python + Package Index. + """ + + boundary = b'----------ThIs_Is_tHe_distlib_index_bouNdaRY_$' + + def __init__(self, url=None): + """ + Initialise an instance. + + :param url: The URL of the index. If not specified, the URL for PyPI is + used. + """ + self.url = url or DEFAULT_INDEX + self.read_configuration() + scheme, netloc, path, params, query, frag = urlparse(self.url) + if params or query or frag or scheme not in ('http', 'https'): + raise DistlibException('invalid repository: %s' % self.url) + self.password_handler = None + self.ssl_verifier = None + self.gpg = None + self.gpg_home = None + with open(os.devnull, 'w') as sink: + # Use gpg by default rather than gpg2, as gpg2 insists on + # prompting for passwords + for s in ('gpg', 'gpg2'): + try: + rc = subprocess.check_call([s, '--version'], stdout=sink, + stderr=sink) + if rc == 0: + self.gpg = s + break + except OSError: + pass + + def _get_pypirc_command(self): + """ + Get the distutils command for interacting with PyPI configurations. + :return: the command. + """ + from .util import _get_pypirc_command as cmd + return cmd() + + def read_configuration(self): + """ + Read the PyPI access configuration as supported by distutils. This populates + ``username``, ``password``, ``realm`` and ``url`` attributes from the + configuration. + """ + from .util import _load_pypirc + cfg = _load_pypirc(self) + self.username = cfg.get('username') + self.password = cfg.get('password') + self.realm = cfg.get('realm', 'pypi') + self.url = cfg.get('repository', self.url) + + def save_configuration(self): + """ + Save the PyPI access configuration. You must have set ``username`` and + ``password`` attributes before calling this method. + """ + self.check_credentials() + from .util import _store_pypirc + _store_pypirc(self) + + def check_credentials(self): + """ + Check that ``username`` and ``password`` have been set, and raise an + exception if not. + """ + if self.username is None or self.password is None: + raise DistlibException('username and password must be set') + pm = HTTPPasswordMgr() + _, netloc, _, _, _, _ = urlparse(self.url) + pm.add_password(self.realm, netloc, self.username, self.password) + self.password_handler = HTTPBasicAuthHandler(pm) + + def register(self, metadata): # pragma: no cover + """ + Register a distribution on PyPI, using the provided metadata. + + :param metadata: A :class:`Metadata` instance defining at least a name + and version number for the distribution to be + registered. + :return: The HTTP response received from PyPI upon submission of the + request. + """ + self.check_credentials() + metadata.validate() + d = metadata.todict() + d[':action'] = 'verify' + request = self.encode_request(d.items(), []) + self.send_request(request) + d[':action'] = 'submit' + request = self.encode_request(d.items(), []) + return self.send_request(request) + + def _reader(self, name, stream, outbuf): + """ + Thread runner for reading lines of from a subprocess into a buffer. + + :param name: The logical name of the stream (used for logging only). + :param stream: The stream to read from. This will typically a pipe + connected to the output stream of a subprocess. + :param outbuf: The list to append the read lines to. + """ + while True: + s = stream.readline() + if not s: + break + s = s.decode('utf-8').rstrip() + outbuf.append(s) + logger.debug('%s: %s' % (name, s)) + stream.close() + + def get_sign_command(self, filename, signer, sign_password, keystore=None): # pragma: no cover + """ + Return a suitable command for signing a file. + + :param filename: The pathname to the file to be signed. + :param signer: The identifier of the signer of the file. + :param sign_password: The passphrase for the signer's + private key used for signing. + :param keystore: The path to a directory which contains the keys + used in verification. If not specified, the + instance's ``gpg_home`` attribute is used instead. + :return: The signing command as a list suitable to be + passed to :class:`subprocess.Popen`. + """ + cmd = [self.gpg, '--status-fd', '2', '--no-tty'] + if keystore is None: + keystore = self.gpg_home + if keystore: + cmd.extend(['--homedir', keystore]) + if sign_password is not None: + cmd.extend(['--batch', '--passphrase-fd', '0']) + td = tempfile.mkdtemp() + sf = os.path.join(td, os.path.basename(filename) + '.asc') + cmd.extend(['--detach-sign', '--armor', '--local-user', + signer, '--output', sf, filename]) + logger.debug('invoking: %s', ' '.join(cmd)) + return cmd, sf + + def run_command(self, cmd, input_data=None): + """ + Run a command in a child process , passing it any input data specified. + + :param cmd: The command to run. + :param input_data: If specified, this must be a byte string containing + data to be sent to the child process. + :return: A tuple consisting of the subprocess' exit code, a list of + lines read from the subprocess' ``stdout``, and a list of + lines read from the subprocess' ``stderr``. + """ + kwargs = { + 'stdout': subprocess.PIPE, + 'stderr': subprocess.PIPE, + } + if input_data is not None: + kwargs['stdin'] = subprocess.PIPE + stdout = [] + stderr = [] + p = subprocess.Popen(cmd, **kwargs) + # We don't use communicate() here because we may need to + # get clever with interacting with the command + t1 = Thread(target=self._reader, args=('stdout', p.stdout, stdout)) + t1.start() + t2 = Thread(target=self._reader, args=('stderr', p.stderr, stderr)) + t2.start() + if input_data is not None: + p.stdin.write(input_data) + p.stdin.close() + + p.wait() + t1.join() + t2.join() + return p.returncode, stdout, stderr + + def sign_file(self, filename, signer, sign_password, keystore=None): # pragma: no cover + """ + Sign a file. + + :param filename: The pathname to the file to be signed. + :param signer: The identifier of the signer of the file. + :param sign_password: The passphrase for the signer's + private key used for signing. + :param keystore: The path to a directory which contains the keys + used in signing. If not specified, the instance's + ``gpg_home`` attribute is used instead. + :return: The absolute pathname of the file where the signature is + stored. + """ + cmd, sig_file = self.get_sign_command(filename, signer, sign_password, + keystore) + rc, stdout, stderr = self.run_command(cmd, + sign_password.encode('utf-8')) + if rc != 0: + raise DistlibException('sign command failed with error ' + 'code %s' % rc) + return sig_file + + def upload_file(self, metadata, filename, signer=None, sign_password=None, + filetype='sdist', pyversion='source', keystore=None): + """ + Upload a release file to the index. + + :param metadata: A :class:`Metadata` instance defining at least a name + and version number for the file to be uploaded. + :param filename: The pathname of the file to be uploaded. + :param signer: The identifier of the signer of the file. + :param sign_password: The passphrase for the signer's + private key used for signing. + :param filetype: The type of the file being uploaded. This is the + distutils command which produced that file, e.g. + ``sdist`` or ``bdist_wheel``. + :param pyversion: The version of Python which the release relates + to. For code compatible with any Python, this would + be ``source``, otherwise it would be e.g. ``3.2``. + :param keystore: The path to a directory which contains the keys + used in signing. If not specified, the instance's + ``gpg_home`` attribute is used instead. + :return: The HTTP response received from PyPI upon submission of the + request. + """ + self.check_credentials() + if not os.path.exists(filename): + raise DistlibException('not found: %s' % filename) + metadata.validate() + d = metadata.todict() + sig_file = None + if signer: + if not self.gpg: + logger.warning('no signing program available - not signed') + else: + sig_file = self.sign_file(filename, signer, sign_password, + keystore) + with open(filename, 'rb') as f: + file_data = f.read() + md5_digest = hashlib.md5(file_data).hexdigest() + sha256_digest = hashlib.sha256(file_data).hexdigest() + d.update({ + ':action': 'file_upload', + 'protocol_version': '1', + 'filetype': filetype, + 'pyversion': pyversion, + 'md5_digest': md5_digest, + 'sha256_digest': sha256_digest, + }) + files = [('content', os.path.basename(filename), file_data)] + if sig_file: + with open(sig_file, 'rb') as f: + sig_data = f.read() + files.append(('gpg_signature', os.path.basename(sig_file), + sig_data)) + shutil.rmtree(os.path.dirname(sig_file)) + request = self.encode_request(d.items(), files) + return self.send_request(request) + + def upload_documentation(self, metadata, doc_dir): # pragma: no cover + """ + Upload documentation to the index. + + :param metadata: A :class:`Metadata` instance defining at least a name + and version number for the documentation to be + uploaded. + :param doc_dir: The pathname of the directory which contains the + documentation. This should be the directory that + contains the ``index.html`` for the documentation. + :return: The HTTP response received from PyPI upon submission of the + request. + """ + self.check_credentials() + if not os.path.isdir(doc_dir): + raise DistlibException('not a directory: %r' % doc_dir) + fn = os.path.join(doc_dir, 'index.html') + if not os.path.exists(fn): + raise DistlibException('not found: %r' % fn) + metadata.validate() + name, version = metadata.name, metadata.version + zip_data = zip_dir(doc_dir).getvalue() + fields = [(':action', 'doc_upload'), + ('name', name), ('version', version)] + files = [('content', name, zip_data)] + request = self.encode_request(fields, files) + return self.send_request(request) + + def get_verify_command(self, signature_filename, data_filename, + keystore=None): + """ + Return a suitable command for verifying a file. + + :param signature_filename: The pathname to the file containing the + signature. + :param data_filename: The pathname to the file containing the + signed data. + :param keystore: The path to a directory which contains the keys + used in verification. If not specified, the + instance's ``gpg_home`` attribute is used instead. + :return: The verifying command as a list suitable to be + passed to :class:`subprocess.Popen`. + """ + cmd = [self.gpg, '--status-fd', '2', '--no-tty'] + if keystore is None: + keystore = self.gpg_home + if keystore: + cmd.extend(['--homedir', keystore]) + cmd.extend(['--verify', signature_filename, data_filename]) + logger.debug('invoking: %s', ' '.join(cmd)) + return cmd + + def verify_signature(self, signature_filename, data_filename, + keystore=None): + """ + Verify a signature for a file. + + :param signature_filename: The pathname to the file containing the + signature. + :param data_filename: The pathname to the file containing the + signed data. + :param keystore: The path to a directory which contains the keys + used in verification. If not specified, the + instance's ``gpg_home`` attribute is used instead. + :return: True if the signature was verified, else False. + """ + if not self.gpg: + raise DistlibException('verification unavailable because gpg ' + 'unavailable') + cmd = self.get_verify_command(signature_filename, data_filename, + keystore) + rc, stdout, stderr = self.run_command(cmd) + if rc not in (0, 1): + raise DistlibException('verify command failed with error code %s' % rc) + return rc == 0 + + def download_file(self, url, destfile, digest=None, reporthook=None): + """ + This is a convenience method for downloading a file from an URL. + Normally, this will be a file from the index, though currently + no check is made for this (i.e. a file can be downloaded from + anywhere). + + The method is just like the :func:`urlretrieve` function in the + standard library, except that it allows digest computation to be + done during download and checking that the downloaded data + matched any expected value. + + :param url: The URL of the file to be downloaded (assumed to be + available via an HTTP GET request). + :param destfile: The pathname where the downloaded file is to be + saved. + :param digest: If specified, this must be a (hasher, value) + tuple, where hasher is the algorithm used (e.g. + ``'md5'``) and ``value`` is the expected value. + :param reporthook: The same as for :func:`urlretrieve` in the + standard library. + """ + if digest is None: + digester = None + logger.debug('No digest specified') + else: + if isinstance(digest, (list, tuple)): + hasher, digest = digest + else: + hasher = 'md5' + digester = getattr(hashlib, hasher)() + logger.debug('Digest specified: %s' % digest) + # The following code is equivalent to urlretrieve. + # We need to do it this way so that we can compute the + # digest of the file as we go. + with open(destfile, 'wb') as dfp: + # addinfourl is not a context manager on 2.x + # so we have to use try/finally + sfp = self.send_request(Request(url)) + try: + headers = sfp.info() + blocksize = 8192 + size = -1 + read = 0 + blocknum = 0 + if "content-length" in headers: + size = int(headers["Content-Length"]) + if reporthook: + reporthook(blocknum, blocksize, size) + while True: + block = sfp.read(blocksize) + if not block: + break + read += len(block) + dfp.write(block) + if digester: + digester.update(block) + blocknum += 1 + if reporthook: + reporthook(blocknum, blocksize, size) + finally: + sfp.close() + + # check that we got the whole file, if we can + if size >= 0 and read < size: + raise DistlibException( + 'retrieval incomplete: got only %d out of %d bytes' + % (read, size)) + # if we have a digest, it must match. + if digester: + actual = digester.hexdigest() + if digest != actual: + raise DistlibException('%s digest mismatch for %s: expected ' + '%s, got %s' % (hasher, destfile, + digest, actual)) + logger.debug('Digest verified: %s', digest) + + def send_request(self, req): + """ + Send a standard library :class:`Request` to PyPI and return its + response. + + :param req: The request to send. + :return: The HTTP response from PyPI (a standard library HTTPResponse). + """ + handlers = [] + if self.password_handler: + handlers.append(self.password_handler) + if self.ssl_verifier: + handlers.append(self.ssl_verifier) + opener = build_opener(*handlers) + return opener.open(req) + + def encode_request(self, fields, files): + """ + Encode fields and files for posting to an HTTP server. + + :param fields: The fields to send as a list of (fieldname, value) + tuples. + :param files: The files to send as a list of (fieldname, filename, + file_bytes) tuple. + """ + # Adapted from packaging, which in turn was adapted from + # http://code.activestate.com/recipes/146306 + + parts = [] + boundary = self.boundary + for k, values in fields: + if not isinstance(values, (list, tuple)): + values = [values] + + for v in values: + parts.extend(( + b'--' + boundary, + ('Content-Disposition: form-data; name="%s"' % + k).encode('utf-8'), + b'', + v.encode('utf-8'))) + for key, filename, value in files: + parts.extend(( + b'--' + boundary, + ('Content-Disposition: form-data; name="%s"; filename="%s"' % + (key, filename)).encode('utf-8'), + b'', + value)) + + parts.extend((b'--' + boundary + b'--', b'')) + + body = b'\r\n'.join(parts) + ct = b'multipart/form-data; boundary=' + boundary + headers = { + 'Content-type': ct, + 'Content-length': str(len(body)) + } + return Request(self.url, body, headers) + + def search(self, terms, operator=None): # pragma: no cover + if isinstance(terms, string_types): + terms = {'name': terms} + rpc_proxy = ServerProxy(self.url, timeout=3.0) + try: + return rpc_proxy.search(terms, operator or 'and') + finally: + rpc_proxy('close')() diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/locators.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/locators.py new file mode 100644 index 0000000..222c1bf --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/locators.py @@ -0,0 +1,1295 @@ +# -*- coding: utf-8 -*- +# +# Copyright (C) 2012-2023 Vinay Sajip. +# Licensed to the Python Software Foundation under a contributor agreement. +# See LICENSE.txt and CONTRIBUTORS.txt. +# + +import gzip +from io import BytesIO +import json +import logging +import os +import posixpath +import re +try: + import threading +except ImportError: # pragma: no cover + import dummy_threading as threading +import zlib + +from . import DistlibException +from .compat import (urljoin, urlparse, urlunparse, url2pathname, pathname2url, queue, quote, unescape, build_opener, + HTTPRedirectHandler as BaseRedirectHandler, text_type, Request, HTTPError, URLError) +from .database import Distribution, DistributionPath, make_dist +from .metadata import Metadata, MetadataInvalidError +from .util import (cached_property, ensure_slash, split_filename, get_project_data, parse_requirement, + parse_name_and_version, ServerProxy, normalize_name) +from .version import get_scheme, UnsupportedVersionError +from .wheel import Wheel, is_compatible + +logger = logging.getLogger(__name__) + +HASHER_HASH = re.compile(r'^(\w+)=([a-f0-9]+)') +CHARSET = re.compile(r';\s*charset\s*=\s*(.*)\s*$', re.I) +HTML_CONTENT_TYPE = re.compile('text/html|application/x(ht)?ml') +DEFAULT_INDEX = 'https://pypi.org/pypi' + + +def get_all_distribution_names(url=None): + """ + Return all distribution names known by an index. + :param url: The URL of the index. + :return: A list of all known distribution names. + """ + if url is None: + url = DEFAULT_INDEX + client = ServerProxy(url, timeout=3.0) + try: + return client.list_packages() + finally: + client('close')() + + +class RedirectHandler(BaseRedirectHandler): + """ + A class to work around a bug in some Python 3.2.x releases. + """ + + # There's a bug in the base version for some 3.2.x + # (e.g. 3.2.2 on Ubuntu Oneiric). If a Location header + # returns e.g. /abc, it bails because it says the scheme '' + # is bogus, when actually it should use the request's + # URL for the scheme. See Python issue #13696. + def http_error_302(self, req, fp, code, msg, headers): + # Some servers (incorrectly) return multiple Location headers + # (so probably same goes for URI). Use first header. + newurl = None + for key in ('location', 'uri'): + if key in headers: + newurl = headers[key] + break + if newurl is None: # pragma: no cover + return + urlparts = urlparse(newurl) + if urlparts.scheme == '': + newurl = urljoin(req.get_full_url(), newurl) + if hasattr(headers, 'replace_header'): + headers.replace_header(key, newurl) + else: + headers[key] = newurl + return BaseRedirectHandler.http_error_302(self, req, fp, code, msg, headers) + + http_error_301 = http_error_303 = http_error_307 = http_error_302 + + +class Locator(object): + """ + A base class for locators - things that locate distributions. + """ + source_extensions = ('.tar.gz', '.tar.bz2', '.tar', '.zip', '.tgz', '.tbz') + binary_extensions = ('.egg', '.exe', '.whl') + excluded_extensions = ('.pdf', ) + + # A list of tags indicating which wheels you want to match. The default + # value of None matches against the tags compatible with the running + # Python. If you want to match other values, set wheel_tags on a locator + # instance to a list of tuples (pyver, abi, arch) which you want to match. + wheel_tags = None + + downloadable_extensions = source_extensions + ('.whl', ) + + def __init__(self, scheme='default'): + """ + Initialise an instance. + :param scheme: Because locators look for most recent versions, they + need to know the version scheme to use. This specifies + the current PEP-recommended scheme - use ``'legacy'`` + if you need to support existing distributions on PyPI. + """ + self._cache = {} + self.scheme = scheme + # Because of bugs in some of the handlers on some of the platforms, + # we use our own opener rather than just using urlopen. + self.opener = build_opener(RedirectHandler()) + # If get_project() is called from locate(), the matcher instance + # is set from the requirement passed to locate(). See issue #18 for + # why this can be useful to know. + self.matcher = None + self.errors = queue.Queue() + + def get_errors(self): + """ + Return any errors which have occurred. + """ + result = [] + while not self.errors.empty(): # pragma: no cover + try: + e = self.errors.get(False) + result.append(e) + except self.errors.Empty: + continue + self.errors.task_done() + return result + + def clear_errors(self): + """ + Clear any errors which may have been logged. + """ + # Just get the errors and throw them away + self.get_errors() + + def clear_cache(self): + self._cache.clear() + + def _get_scheme(self): + return self._scheme + + def _set_scheme(self, value): + self._scheme = value + + scheme = property(_get_scheme, _set_scheme) + + def _get_project(self, name): + """ + For a given project, get a dictionary mapping available versions to Distribution + instances. + + This should be implemented in subclasses. + + If called from a locate() request, self.matcher will be set to a + matcher for the requirement to satisfy, otherwise it will be None. + """ + raise NotImplementedError('Please implement in the subclass') + + def get_distribution_names(self): + """ + Return all the distribution names known to this locator. + """ + raise NotImplementedError('Please implement in the subclass') + + def get_project(self, name): + """ + For a given project, get a dictionary mapping available versions to Distribution + instances. + + This calls _get_project to do all the work, and just implements a caching layer on top. + """ + if self._cache is None: # pragma: no cover + result = self._get_project(name) + elif name in self._cache: + result = self._cache[name] + else: + self.clear_errors() + result = self._get_project(name) + self._cache[name] = result + return result + + def score_url(self, url): + """ + Give an url a score which can be used to choose preferred URLs + for a given project release. + """ + t = urlparse(url) + basename = posixpath.basename(t.path) + compatible = True + is_wheel = basename.endswith('.whl') + is_downloadable = basename.endswith(self.downloadable_extensions) + if is_wheel: + compatible = is_compatible(Wheel(basename), self.wheel_tags) + return (t.scheme == 'https', 'pypi.org' in t.netloc, is_downloadable, is_wheel, compatible, basename) + + def prefer_url(self, url1, url2): + """ + Choose one of two URLs where both are candidates for distribution + archives for the same version of a distribution (for example, + .tar.gz vs. zip). + + The current implementation favours https:// URLs over http://, archives + from PyPI over those from other locations, wheel compatibility (if a + wheel) and then the archive name. + """ + result = url2 + if url1: + s1 = self.score_url(url1) + s2 = self.score_url(url2) + if s1 > s2: + result = url1 + if result != url2: + logger.debug('Not replacing %r with %r', url1, url2) + else: + logger.debug('Replacing %r with %r', url1, url2) + return result + + def split_filename(self, filename, project_name): + """ + Attempt to split a filename in project name, version and Python version. + """ + return split_filename(filename, project_name) + + def convert_url_to_download_info(self, url, project_name): + """ + See if a URL is a candidate for a download URL for a project (the URL + has typically been scraped from an HTML page). + + If it is, a dictionary is returned with keys "name", "version", + "filename" and "url"; otherwise, None is returned. + """ + + def same_project(name1, name2): + return normalize_name(name1) == normalize_name(name2) + + result = None + scheme, netloc, path, params, query, frag = urlparse(url) + if frag.lower().startswith('egg='): # pragma: no cover + logger.debug('%s: version hint in fragment: %r', project_name, frag) + m = HASHER_HASH.match(frag) + if m: + algo, digest = m.groups() + else: + algo, digest = None, None + origpath = path + if path and path[-1] == '/': # pragma: no cover + path = path[:-1] + if path.endswith('.whl'): + try: + wheel = Wheel(path) + if not is_compatible(wheel, self.wheel_tags): + logger.debug('Wheel not compatible: %s', path) + else: + if project_name is None: + include = True + else: + include = same_project(wheel.name, project_name) + if include: + result = { + 'name': wheel.name, + 'version': wheel.version, + 'filename': wheel.filename, + 'url': urlunparse((scheme, netloc, origpath, params, query, '')), + 'python-version': ', '.join(['.'.join(list(v[2:])) for v in wheel.pyver]), + } + except Exception: # pragma: no cover + logger.warning('invalid path for wheel: %s', path) + elif not path.endswith(self.downloadable_extensions): # pragma: no cover + logger.debug('Not downloadable: %s', path) + else: # downloadable extension + path = filename = posixpath.basename(path) + for ext in self.downloadable_extensions: + if path.endswith(ext): + path = path[:-len(ext)] + t = self.split_filename(path, project_name) + if not t: # pragma: no cover + logger.debug('No match for project/version: %s', path) + else: + name, version, pyver = t + if not project_name or same_project(project_name, name): + result = { + 'name': name, + 'version': version, + 'filename': filename, + 'url': urlunparse((scheme, netloc, origpath, params, query, '')), + } + if pyver: # pragma: no cover + result['python-version'] = pyver + break + if result and algo: + result['%s_digest' % algo] = digest + return result + + def _get_digest(self, info): + """ + Get a digest from a dictionary by looking at a "digests" dictionary + or keys of the form 'algo_digest'. + + Returns a 2-tuple (algo, digest) if found, else None. Currently + looks only for SHA256, then MD5. + """ + result = None + if 'digests' in info: + digests = info['digests'] + for algo in ('sha256', 'md5'): + if algo in digests: + result = (algo, digests[algo]) + break + if not result: + for algo in ('sha256', 'md5'): + key = '%s_digest' % algo + if key in info: + result = (algo, info[key]) + break + return result + + def _update_version_data(self, result, info): + """ + Update a result dictionary (the final result from _get_project) with a + dictionary for a specific version, which typically holds information + gleaned from a filename or URL for an archive for the distribution. + """ + name = info.pop('name') + version = info.pop('version') + if version in result: + dist = result[version] + md = dist.metadata + else: + dist = make_dist(name, version, scheme=self.scheme) + md = dist.metadata + dist.digest = digest = self._get_digest(info) + url = info['url'] + result['digests'][url] = digest + if md.source_url != info['url']: + md.source_url = self.prefer_url(md.source_url, url) + result['urls'].setdefault(version, set()).add(url) + dist.locator = self + result[version] = dist + + def locate(self, requirement, prereleases=False): + """ + Find the most recent distribution which matches the given + requirement. + + :param requirement: A requirement of the form 'foo (1.0)' or perhaps + 'foo (>= 1.0, < 2.0, != 1.3)' + :param prereleases: If ``True``, allow pre-release versions + to be located. Otherwise, pre-release versions + are not returned. + :return: A :class:`Distribution` instance, or ``None`` if no such + distribution could be located. + """ + result = None + r = parse_requirement(requirement) + if r is None: # pragma: no cover + raise DistlibException('Not a valid requirement: %r' % requirement) + scheme = get_scheme(self.scheme) + self.matcher = matcher = scheme.matcher(r.requirement) + logger.debug('matcher: %s (%s)', matcher, type(matcher).__name__) + versions = self.get_project(r.name) + if len(versions) > 2: # urls and digests keys are present + # sometimes, versions are invalid + slist = [] + vcls = matcher.version_class + for k in versions: + if k in ('urls', 'digests'): + continue + try: + if not matcher.match(k): + pass # logger.debug('%s did not match %r', matcher, k) + else: + if prereleases or not vcls(k).is_prerelease: + slist.append(k) + except Exception: # pragma: no cover + logger.warning('error matching %s with %r', matcher, k) + pass # slist.append(k) + if len(slist) > 1: + slist = sorted(slist, key=scheme.key) + if slist: + logger.debug('sorted list: %s', slist) + version = slist[-1] + result = versions[version] + if result: + if r.extras: + result.extras = r.extras + result.download_urls = versions.get('urls', {}).get(version, set()) + d = {} + sd = versions.get('digests', {}) + for url in result.download_urls: + if url in sd: # pragma: no cover + d[url] = sd[url] + result.digests = d + self.matcher = None + return result + + +class PyPIRPCLocator(Locator): + """ + This locator uses XML-RPC to locate distributions. It therefore + cannot be used with simple mirrors (that only mirror file content). + """ + + def __init__(self, url, **kwargs): + """ + Initialise an instance. + + :param url: The URL to use for XML-RPC. + :param kwargs: Passed to the superclass constructor. + """ + super(PyPIRPCLocator, self).__init__(**kwargs) + self.base_url = url + self.client = ServerProxy(url, timeout=3.0) + + def get_distribution_names(self): + """ + Return all the distribution names known to this locator. + """ + return set(self.client.list_packages()) + + def _get_project(self, name): + result = {'urls': {}, 'digests': {}} + versions = self.client.package_releases(name, True) + for v in versions: + urls = self.client.release_urls(name, v) + data = self.client.release_data(name, v) + metadata = Metadata(scheme=self.scheme) + metadata.name = data['name'] + metadata.version = data['version'] + metadata.license = data.get('license') + metadata.keywords = data.get('keywords', []) + metadata.summary = data.get('summary') + dist = Distribution(metadata) + if urls: + info = urls[0] + metadata.source_url = info['url'] + dist.digest = self._get_digest(info) + dist.locator = self + result[v] = dist + for info in urls: + url = info['url'] + digest = self._get_digest(info) + result['urls'].setdefault(v, set()).add(url) + result['digests'][url] = digest + return result + + +class PyPIJSONLocator(Locator): + """ + This locator uses PyPI's JSON interface. It's very limited in functionality + and probably not worth using. + """ + + def __init__(self, url, **kwargs): + super(PyPIJSONLocator, self).__init__(**kwargs) + self.base_url = ensure_slash(url) + + def get_distribution_names(self): + """ + Return all the distribution names known to this locator. + """ + raise NotImplementedError('Not available from this locator') + + def _get_project(self, name): + result = {'urls': {}, 'digests': {}} + url = urljoin(self.base_url, '%s/json' % quote(name)) + try: + resp = self.opener.open(url) + data = resp.read().decode() # for now + d = json.loads(data) + md = Metadata(scheme=self.scheme) + data = d['info'] + md.name = data['name'] + md.version = data['version'] + md.license = data.get('license') + md.keywords = data.get('keywords', []) + md.summary = data.get('summary') + dist = Distribution(md) + dist.locator = self + # urls = d['urls'] + result[md.version] = dist + for info in d['urls']: + url = info['url'] + dist.download_urls.add(url) + dist.digests[url] = self._get_digest(info) + result['urls'].setdefault(md.version, set()).add(url) + result['digests'][url] = self._get_digest(info) + # Now get other releases + for version, infos in d['releases'].items(): + if version == md.version: + continue # already done + omd = Metadata(scheme=self.scheme) + omd.name = md.name + omd.version = version + odist = Distribution(omd) + odist.locator = self + result[version] = odist + for info in infos: + url = info['url'] + odist.download_urls.add(url) + odist.digests[url] = self._get_digest(info) + result['urls'].setdefault(version, set()).add(url) + result['digests'][url] = self._get_digest(info) + + +# for info in urls: +# md.source_url = info['url'] +# dist.digest = self._get_digest(info) +# dist.locator = self +# for info in urls: +# url = info['url'] +# result['urls'].setdefault(md.version, set()).add(url) +# result['digests'][url] = self._get_digest(info) + except Exception as e: + self.errors.put(text_type(e)) + logger.exception('JSON fetch failed: %s', e) + return result + + +class Page(object): + """ + This class represents a scraped HTML page. + """ + # The following slightly hairy-looking regex just looks for the contents of + # an anchor link, which has an attribute "href" either immediately preceded + # or immediately followed by a "rel" attribute. The attribute values can be + # declared with double quotes, single quotes or no quotes - which leads to + # the length of the expression. + _href = re.compile( + """ +(rel\\s*=\\s*(?:"(?P[^"]*)"|'(?P[^']*)'|(?P[^>\\s\n]*))\\s+)? +href\\s*=\\s*(?:"(?P[^"]*)"|'(?P[^']*)'|(?P[^>\\s\n]*)) +(\\s+rel\\s*=\\s*(?:"(?P[^"]*)"|'(?P[^']*)'|(?P[^>\\s\n]*)))? +""", re.I | re.S | re.X) + _base = re.compile(r"""]+)""", re.I | re.S) + + def __init__(self, data, url): + """ + Initialise an instance with the Unicode page contents and the URL they + came from. + """ + self.data = data + self.base_url = self.url = url + m = self._base.search(self.data) + if m: + self.base_url = m.group(1) + + _clean_re = re.compile(r'[^a-z0-9$&+,/:;=?@.#%_\\|-]', re.I) + + @cached_property + def links(self): + """ + Return the URLs of all the links on a page together with information + about their "rel" attribute, for determining which ones to treat as + downloads and which ones to queue for further scraping. + """ + + def clean(url): + "Tidy up an URL." + scheme, netloc, path, params, query, frag = urlparse(url) + return urlunparse((scheme, netloc, quote(path), params, query, frag)) + + result = set() + for match in self._href.finditer(self.data): + d = match.groupdict('') + rel = (d['rel1'] or d['rel2'] or d['rel3'] or d['rel4'] or d['rel5'] or d['rel6']) + url = d['url1'] or d['url2'] or d['url3'] + url = urljoin(self.base_url, url) + url = unescape(url) + url = self._clean_re.sub(lambda m: '%%%2x' % ord(m.group(0)), url) + result.add((url, rel)) + # We sort the result, hoping to bring the most recent versions + # to the front + result = sorted(result, key=lambda t: t[0], reverse=True) + return result + + +class SimpleScrapingLocator(Locator): + """ + A locator which scrapes HTML pages to locate downloads for a distribution. + This runs multiple threads to do the I/O; performance is at least as good + as pip's PackageFinder, which works in an analogous fashion. + """ + + # These are used to deal with various Content-Encoding schemes. + decoders = { + 'deflate': zlib.decompress, + 'gzip': lambda b: gzip.GzipFile(fileobj=BytesIO(b)).read(), + 'none': lambda b: b, + } + + def __init__(self, url, timeout=None, num_workers=10, **kwargs): + """ + Initialise an instance. + :param url: The root URL to use for scraping. + :param timeout: The timeout, in seconds, to be applied to requests. + This defaults to ``None`` (no timeout specified). + :param num_workers: The number of worker threads you want to do I/O, + This defaults to 10. + :param kwargs: Passed to the superclass. + """ + super(SimpleScrapingLocator, self).__init__(**kwargs) + self.base_url = ensure_slash(url) + self.timeout = timeout + self._page_cache = {} + self._seen = set() + self._to_fetch = queue.Queue() + self._bad_hosts = set() + self.skip_externals = False + self.num_workers = num_workers + self._lock = threading.RLock() + # See issue #45: we need to be resilient when the locator is used + # in a thread, e.g. with concurrent.futures. We can't use self._lock + # as it is for coordinating our internal threads - the ones created + # in _prepare_threads. + self._gplock = threading.RLock() + self.platform_check = False # See issue #112 + + def _prepare_threads(self): + """ + Threads are created only when get_project is called, and terminate + before it returns. They are there primarily to parallelise I/O (i.e. + fetching web pages). + """ + self._threads = [] + for i in range(self.num_workers): + t = threading.Thread(target=self._fetch) + t.daemon = True + t.start() + self._threads.append(t) + + def _wait_threads(self): + """ + Tell all the threads to terminate (by sending a sentinel value) and + wait for them to do so. + """ + # Note that you need two loops, since you can't say which + # thread will get each sentinel + for t in self._threads: + self._to_fetch.put(None) # sentinel + for t in self._threads: + t.join() + self._threads = [] + + def _get_project(self, name): + result = {'urls': {}, 'digests': {}} + with self._gplock: + self.result = result + self.project_name = name + url = urljoin(self.base_url, '%s/' % quote(name)) + self._seen.clear() + self._page_cache.clear() + self._prepare_threads() + try: + logger.debug('Queueing %s', url) + self._to_fetch.put(url) + self._to_fetch.join() + finally: + self._wait_threads() + del self.result + return result + + platform_dependent = re.compile(r'\b(linux_(i\d86|x86_64|arm\w+)|' + r'win(32|_amd64)|macosx_?\d+)\b', re.I) + + def _is_platform_dependent(self, url): + """ + Does an URL refer to a platform-specific download? + """ + return self.platform_dependent.search(url) + + def _process_download(self, url): + """ + See if an URL is a suitable download for a project. + + If it is, register information in the result dictionary (for + _get_project) about the specific version it's for. + + Note that the return value isn't actually used other than as a boolean + value. + """ + if self.platform_check and self._is_platform_dependent(url): + info = None + else: + info = self.convert_url_to_download_info(url, self.project_name) + logger.debug('process_download: %s -> %s', url, info) + if info: + with self._lock: # needed because self.result is shared + self._update_version_data(self.result, info) + return info + + def _should_queue(self, link, referrer, rel): + """ + Determine whether a link URL from a referring page and with a + particular "rel" attribute should be queued for scraping. + """ + scheme, netloc, path, _, _, _ = urlparse(link) + if path.endswith(self.source_extensions + self.binary_extensions + self.excluded_extensions): + result = False + elif self.skip_externals and not link.startswith(self.base_url): + result = False + elif not referrer.startswith(self.base_url): + result = False + elif rel not in ('homepage', 'download'): + result = False + elif scheme not in ('http', 'https', 'ftp'): + result = False + elif self._is_platform_dependent(link): + result = False + else: + host = netloc.split(':', 1)[0] + if host.lower() == 'localhost': + result = False + else: + result = True + logger.debug('should_queue: %s (%s) from %s -> %s', link, rel, referrer, result) + return result + + def _fetch(self): + """ + Get a URL to fetch from the work queue, get the HTML page, examine its + links for download candidates and candidates for further scraping. + + This is a handy method to run in a thread. + """ + while True: + url = self._to_fetch.get() + try: + if url: + page = self.get_page(url) + if page is None: # e.g. after an error + continue + for link, rel in page.links: + if link not in self._seen: + try: + self._seen.add(link) + if (not self._process_download(link) and self._should_queue(link, url, rel)): + logger.debug('Queueing %s from %s', link, url) + self._to_fetch.put(link) + except MetadataInvalidError: # e.g. invalid versions + pass + except Exception as e: # pragma: no cover + self.errors.put(text_type(e)) + finally: + # always do this, to avoid hangs :-) + self._to_fetch.task_done() + if not url: + # logger.debug('Sentinel seen, quitting.') + break + + def get_page(self, url): + """ + Get the HTML for an URL, possibly from an in-memory cache. + + XXX TODO Note: this cache is never actually cleared. It's assumed that + the data won't get stale over the lifetime of a locator instance (not + necessarily true for the default_locator). + """ + # http://peak.telecommunity.com/DevCenter/EasyInstall#package-index-api + scheme, netloc, path, _, _, _ = urlparse(url) + if scheme == 'file' and os.path.isdir(url2pathname(path)): + url = urljoin(ensure_slash(url), 'index.html') + + if url in self._page_cache: + result = self._page_cache[url] + logger.debug('Returning %s from cache: %s', url, result) + else: + host = netloc.split(':', 1)[0] + result = None + if host in self._bad_hosts: + logger.debug('Skipping %s due to bad host %s', url, host) + else: + req = Request(url, headers={'Accept-encoding': 'identity'}) + try: + logger.debug('Fetching %s', url) + resp = self.opener.open(req, timeout=self.timeout) + logger.debug('Fetched %s', url) + headers = resp.info() + content_type = headers.get('Content-Type', '') + if HTML_CONTENT_TYPE.match(content_type): + final_url = resp.geturl() + data = resp.read() + encoding = headers.get('Content-Encoding') + if encoding: + decoder = self.decoders[encoding] # fail if not found + data = decoder(data) + encoding = 'utf-8' + m = CHARSET.search(content_type) + if m: + encoding = m.group(1) + try: + data = data.decode(encoding) + except UnicodeError: # pragma: no cover + data = data.decode('latin-1') # fallback + result = Page(data, final_url) + self._page_cache[final_url] = result + except HTTPError as e: + if e.code != 404: + logger.exception('Fetch failed: %s: %s', url, e) + except URLError as e: # pragma: no cover + logger.exception('Fetch failed: %s: %s', url, e) + with self._lock: + self._bad_hosts.add(host) + except Exception as e: # pragma: no cover + logger.exception('Fetch failed: %s: %s', url, e) + finally: + self._page_cache[url] = result # even if None (failure) + return result + + _distname_re = re.compile(']*>([^<]+)<') + + def get_distribution_names(self): + """ + Return all the distribution names known to this locator. + """ + result = set() + page = self.get_page(self.base_url) + if not page: + raise DistlibException('Unable to get %s' % self.base_url) + for match in self._distname_re.finditer(page.data): + result.add(match.group(1)) + return result + + +class DirectoryLocator(Locator): + """ + This class locates distributions in a directory tree. + """ + + def __init__(self, path, **kwargs): + """ + Initialise an instance. + :param path: The root of the directory tree to search. + :param kwargs: Passed to the superclass constructor, + except for: + * recursive - if True (the default), subdirectories are + recursed into. If False, only the top-level directory + is searched, + """ + self.recursive = kwargs.pop('recursive', True) + super(DirectoryLocator, self).__init__(**kwargs) + path = os.path.abspath(path) + if not os.path.isdir(path): # pragma: no cover + raise DistlibException('Not a directory: %r' % path) + self.base_dir = path + + def should_include(self, filename, parent): + """ + Should a filename be considered as a candidate for a distribution + archive? As well as the filename, the directory which contains it + is provided, though not used by the current implementation. + """ + return filename.endswith(self.downloadable_extensions) + + def _get_project(self, name): + result = {'urls': {}, 'digests': {}} + for root, dirs, files in os.walk(self.base_dir): + for fn in files: + if self.should_include(fn, root): + fn = os.path.join(root, fn) + url = urlunparse(('file', '', pathname2url(os.path.abspath(fn)), '', '', '')) + info = self.convert_url_to_download_info(url, name) + if info: + self._update_version_data(result, info) + if not self.recursive: + break + return result + + def get_distribution_names(self): + """ + Return all the distribution names known to this locator. + """ + result = set() + for root, dirs, files in os.walk(self.base_dir): + for fn in files: + if self.should_include(fn, root): + fn = os.path.join(root, fn) + url = urlunparse(('file', '', pathname2url(os.path.abspath(fn)), '', '', '')) + info = self.convert_url_to_download_info(url, None) + if info: + result.add(info['name']) + if not self.recursive: + break + return result + + +class JSONLocator(Locator): + """ + This locator uses special extended metadata (not available on PyPI) and is + the basis of performant dependency resolution in distlib. Other locators + require archive downloads before dependencies can be determined! As you + might imagine, that can be slow. + """ + + def get_distribution_names(self): + """ + Return all the distribution names known to this locator. + """ + raise NotImplementedError('Not available from this locator') + + def _get_project(self, name): + result = {'urls': {}, 'digests': {}} + data = get_project_data(name) + if data: + for info in data.get('files', []): + if info['ptype'] != 'sdist' or info['pyversion'] != 'source': + continue + # We don't store summary in project metadata as it makes + # the data bigger for no benefit during dependency + # resolution + dist = make_dist(data['name'], + info['version'], + summary=data.get('summary', 'Placeholder for summary'), + scheme=self.scheme) + md = dist.metadata + md.source_url = info['url'] + # TODO SHA256 digest + if 'digest' in info and info['digest']: + dist.digest = ('md5', info['digest']) + md.dependencies = info.get('requirements', {}) + dist.exports = info.get('exports', {}) + result[dist.version] = dist + result['urls'].setdefault(dist.version, set()).add(info['url']) + return result + + +class DistPathLocator(Locator): + """ + This locator finds installed distributions in a path. It can be useful for + adding to an :class:`AggregatingLocator`. + """ + + def __init__(self, distpath, **kwargs): + """ + Initialise an instance. + + :param distpath: A :class:`DistributionPath` instance to search. + """ + super(DistPathLocator, self).__init__(**kwargs) + assert isinstance(distpath, DistributionPath) + self.distpath = distpath + + def _get_project(self, name): + dist = self.distpath.get_distribution(name) + if dist is None: + result = {'urls': {}, 'digests': {}} + else: + result = { + dist.version: dist, + 'urls': { + dist.version: set([dist.source_url]) + }, + 'digests': { + dist.version: set([None]) + } + } + return result + + +class AggregatingLocator(Locator): + """ + This class allows you to chain and/or merge a list of locators. + """ + + def __init__(self, *locators, **kwargs): + """ + Initialise an instance. + + :param locators: The list of locators to search. + :param kwargs: Passed to the superclass constructor, + except for: + * merge - if False (the default), the first successful + search from any of the locators is returned. If True, + the results from all locators are merged (this can be + slow). + """ + self.merge = kwargs.pop('merge', False) + self.locators = locators + super(AggregatingLocator, self).__init__(**kwargs) + + def clear_cache(self): + super(AggregatingLocator, self).clear_cache() + for locator in self.locators: + locator.clear_cache() + + def _set_scheme(self, value): + self._scheme = value + for locator in self.locators: + locator.scheme = value + + scheme = property(Locator.scheme.fget, _set_scheme) + + def _get_project(self, name): + result = {} + for locator in self.locators: + d = locator.get_project(name) + if d: + if self.merge: + files = result.get('urls', {}) + digests = result.get('digests', {}) + # next line could overwrite result['urls'], result['digests'] + result.update(d) + df = result.get('urls') + if files and df: + for k, v in files.items(): + if k in df: + df[k] |= v + else: + df[k] = v + dd = result.get('digests') + if digests and dd: + dd.update(digests) + else: + # See issue #18. If any dists are found and we're looking + # for specific constraints, we only return something if + # a match is found. For example, if a DirectoryLocator + # returns just foo (1.0) while we're looking for + # foo (>= 2.0), we'll pretend there was nothing there so + # that subsequent locators can be queried. Otherwise we + # would just return foo (1.0) which would then lead to a + # failure to find foo (>= 2.0), because other locators + # weren't searched. Note that this only matters when + # merge=False. + if self.matcher is None: + found = True + else: + found = False + for k in d: + if self.matcher.match(k): + found = True + break + if found: + result = d + break + return result + + def get_distribution_names(self): + """ + Return all the distribution names known to this locator. + """ + result = set() + for locator in self.locators: + try: + result |= locator.get_distribution_names() + except NotImplementedError: + pass + return result + + +# We use a legacy scheme simply because most of the dists on PyPI use legacy +# versions which don't conform to PEP 440. +default_locator = AggregatingLocator( + # JSONLocator(), # don't use as PEP 426 is withdrawn + SimpleScrapingLocator('https://pypi.org/simple/', timeout=3.0), + scheme='legacy') + +locate = default_locator.locate + + +class DependencyFinder(object): + """ + Locate dependencies for distributions. + """ + + def __init__(self, locator=None): + """ + Initialise an instance, using the specified locator + to locate distributions. + """ + self.locator = locator or default_locator + self.scheme = get_scheme(self.locator.scheme) + + def add_distribution(self, dist): + """ + Add a distribution to the finder. This will update internal information + about who provides what. + :param dist: The distribution to add. + """ + logger.debug('adding distribution %s', dist) + name = dist.key + self.dists_by_name[name] = dist + self.dists[(name, dist.version)] = dist + for p in dist.provides: + name, version = parse_name_and_version(p) + logger.debug('Add to provided: %s, %s, %s', name, version, dist) + self.provided.setdefault(name, set()).add((version, dist)) + + def remove_distribution(self, dist): + """ + Remove a distribution from the finder. This will update internal + information about who provides what. + :param dist: The distribution to remove. + """ + logger.debug('removing distribution %s', dist) + name = dist.key + del self.dists_by_name[name] + del self.dists[(name, dist.version)] + for p in dist.provides: + name, version = parse_name_and_version(p) + logger.debug('Remove from provided: %s, %s, %s', name, version, dist) + s = self.provided[name] + s.remove((version, dist)) + if not s: + del self.provided[name] + + def get_matcher(self, reqt): + """ + Get a version matcher for a requirement. + :param reqt: The requirement + :type reqt: str + :return: A version matcher (an instance of + :class:`distlib.version.Matcher`). + """ + try: + matcher = self.scheme.matcher(reqt) + except UnsupportedVersionError: # pragma: no cover + # XXX compat-mode if cannot read the version + name = reqt.split()[0] + matcher = self.scheme.matcher(name) + return matcher + + def find_providers(self, reqt): + """ + Find the distributions which can fulfill a requirement. + + :param reqt: The requirement. + :type reqt: str + :return: A set of distribution which can fulfill the requirement. + """ + matcher = self.get_matcher(reqt) + name = matcher.key # case-insensitive + result = set() + provided = self.provided + if name in provided: + for version, provider in provided[name]: + try: + match = matcher.match(version) + except UnsupportedVersionError: + match = False + + if match: + result.add(provider) + break + return result + + def try_to_replace(self, provider, other, problems): + """ + Attempt to replace one provider with another. This is typically used + when resolving dependencies from multiple sources, e.g. A requires + (B >= 1.0) while C requires (B >= 1.1). + + For successful replacement, ``provider`` must meet all the requirements + which ``other`` fulfills. + + :param provider: The provider we are trying to replace with. + :param other: The provider we're trying to replace. + :param problems: If False is returned, this will contain what + problems prevented replacement. This is currently + a tuple of the literal string 'cantreplace', + ``provider``, ``other`` and the set of requirements + that ``provider`` couldn't fulfill. + :return: True if we can replace ``other`` with ``provider``, else + False. + """ + rlist = self.reqts[other] + unmatched = set() + for s in rlist: + matcher = self.get_matcher(s) + if not matcher.match(provider.version): + unmatched.add(s) + if unmatched: + # can't replace other with provider + problems.add(('cantreplace', provider, other, frozenset(unmatched))) + result = False + else: + # can replace other with provider + self.remove_distribution(other) + del self.reqts[other] + for s in rlist: + self.reqts.setdefault(provider, set()).add(s) + self.add_distribution(provider) + result = True + return result + + def find(self, requirement, meta_extras=None, prereleases=False): + """ + Find a distribution and all distributions it depends on. + + :param requirement: The requirement specifying the distribution to + find, or a Distribution instance. + :param meta_extras: A list of meta extras such as :test:, :build: and + so on. + :param prereleases: If ``True``, allow pre-release versions to be + returned - otherwise, don't return prereleases + unless they're all that's available. + + Return a set of :class:`Distribution` instances and a set of + problems. + + The distributions returned should be such that they have the + :attr:`required` attribute set to ``True`` if they were + from the ``requirement`` passed to ``find()``, and they have the + :attr:`build_time_dependency` attribute set to ``True`` unless they + are post-installation dependencies of the ``requirement``. + + The problems should be a tuple consisting of the string + ``'unsatisfied'`` and the requirement which couldn't be satisfied + by any distribution known to the locator. + """ + + self.provided = {} + self.dists = {} + self.dists_by_name = {} + self.reqts = {} + + meta_extras = set(meta_extras or []) + if ':*:' in meta_extras: + meta_extras.remove(':*:') + # :meta: and :run: are implicitly included + meta_extras |= set([':test:', ':build:', ':dev:']) + + if isinstance(requirement, Distribution): + dist = odist = requirement + logger.debug('passed %s as requirement', odist) + else: + dist = odist = self.locator.locate(requirement, prereleases=prereleases) + if dist is None: + raise DistlibException('Unable to locate %r' % requirement) + logger.debug('located %s', odist) + dist.requested = True + problems = set() + todo = set([dist]) + install_dists = set([odist]) + while todo: + dist = todo.pop() + name = dist.key # case-insensitive + if name not in self.dists_by_name: + self.add_distribution(dist) + else: + # import pdb; pdb.set_trace() + other = self.dists_by_name[name] + if other != dist: + self.try_to_replace(dist, other, problems) + + ireqts = dist.run_requires | dist.meta_requires + sreqts = dist.build_requires + ereqts = set() + if meta_extras and dist in install_dists: + for key in ('test', 'build', 'dev'): + e = ':%s:' % key + if e in meta_extras: + ereqts |= getattr(dist, '%s_requires' % key) + all_reqts = ireqts | sreqts | ereqts + for r in all_reqts: + providers = self.find_providers(r) + if not providers: + logger.debug('No providers found for %r', r) + provider = self.locator.locate(r, prereleases=prereleases) + # If no provider is found and we didn't consider + # prereleases, consider them now. + if provider is None and not prereleases: + provider = self.locator.locate(r, prereleases=True) + if provider is None: + logger.debug('Cannot satisfy %r', r) + problems.add(('unsatisfied', r)) + else: + n, v = provider.key, provider.version + if (n, v) not in self.dists: + todo.add(provider) + providers.add(provider) + if r in ireqts and dist in install_dists: + install_dists.add(provider) + logger.debug('Adding %s to install_dists', provider.name_and_version) + for p in providers: + name = p.key + if name not in self.dists_by_name: + self.reqts.setdefault(p, set()).add(r) + else: + other = self.dists_by_name[name] + if other != p: + # see if other can be replaced by p + self.try_to_replace(p, other, problems) + + dists = set(self.dists.values()) + for dist in dists: + dist.build_time_dependency = dist not in install_dists + if dist.build_time_dependency: + logger.debug('%s is a build-time dependency only.', dist.name_and_version) + logger.debug('find done for %s', odist) + return dists, problems diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/manifest.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/manifest.py new file mode 100644 index 0000000..420dcf1 --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/manifest.py @@ -0,0 +1,384 @@ +# -*- coding: utf-8 -*- +# +# Copyright (C) 2012-2023 Python Software Foundation. +# See LICENSE.txt and CONTRIBUTORS.txt. +# +""" +Class representing the list of files in a distribution. + +Equivalent to distutils.filelist, but fixes some problems. +""" +import fnmatch +import logging +import os +import re +import sys + +from . import DistlibException +from .compat import fsdecode +from .util import convert_path + + +__all__ = ['Manifest'] + +logger = logging.getLogger(__name__) + +# a \ followed by some spaces + EOL +_COLLAPSE_PATTERN = re.compile('\\\\w*\n', re.M) +_COMMENTED_LINE = re.compile('#.*?(?=\n)|\n(?=$)', re.M | re.S) + +# +# Due to the different results returned by fnmatch.translate, we need +# to do slightly different processing for Python 2.7 and 3.2 ... this needed +# to be brought in for Python 3.6 onwards. +# +_PYTHON_VERSION = sys.version_info[:2] + + +class Manifest(object): + """ + A list of files built by exploring the filesystem and filtered by applying various + patterns to what we find there. + """ + + def __init__(self, base=None): + """ + Initialise an instance. + + :param base: The base directory to explore under. + """ + self.base = os.path.abspath(os.path.normpath(base or os.getcwd())) + self.prefix = self.base + os.sep + self.allfiles = None + self.files = set() + + # + # Public API + # + + def findall(self): + """Find all files under the base and set ``allfiles`` to the absolute + pathnames of files found. + """ + from stat import S_ISREG, S_ISDIR, S_ISLNK + + self.allfiles = allfiles = [] + root = self.base + stack = [root] + pop = stack.pop + push = stack.append + + while stack: + root = pop() + names = os.listdir(root) + + for name in names: + fullname = os.path.join(root, name) + + # Avoid excess stat calls -- just one will do, thank you! + stat = os.stat(fullname) + mode = stat.st_mode + if S_ISREG(mode): + allfiles.append(fsdecode(fullname)) + elif S_ISDIR(mode) and not S_ISLNK(mode): + push(fullname) + + def add(self, item): + """ + Add a file to the manifest. + + :param item: The pathname to add. This can be relative to the base. + """ + if not item.startswith(self.prefix): + item = os.path.join(self.base, item) + self.files.add(os.path.normpath(item)) + + def add_many(self, items): + """ + Add a list of files to the manifest. + + :param items: The pathnames to add. These can be relative to the base. + """ + for item in items: + self.add(item) + + def sorted(self, wantdirs=False): + """ + Return sorted files in directory order + """ + + def add_dir(dirs, d): + dirs.add(d) + logger.debug('add_dir added %s', d) + if d != self.base: + parent, _ = os.path.split(d) + assert parent not in ('', '/') + add_dir(dirs, parent) + + result = set(self.files) # make a copy! + if wantdirs: + dirs = set() + for f in result: + add_dir(dirs, os.path.dirname(f)) + result |= dirs + return [os.path.join(*path_tuple) for path_tuple in + sorted(os.path.split(path) for path in result)] + + def clear(self): + """Clear all collected files.""" + self.files = set() + self.allfiles = [] + + def process_directive(self, directive): + """ + Process a directive which either adds some files from ``allfiles`` to + ``files``, or removes some files from ``files``. + + :param directive: The directive to process. This should be in a format + compatible with distutils ``MANIFEST.in`` files: + + http://docs.python.org/distutils/sourcedist.html#commands + """ + # Parse the line: split it up, make sure the right number of words + # is there, and return the relevant words. 'action' is always + # defined: it's the first word of the line. Which of the other + # three are defined depends on the action; it'll be either + # patterns, (dir and patterns), or (dirpattern). + action, patterns, thedir, dirpattern = self._parse_directive(directive) + + # OK, now we know that the action is valid and we have the + # right number of words on the line for that action -- so we + # can proceed with minimal error-checking. + if action == 'include': + for pattern in patterns: + if not self._include_pattern(pattern, anchor=True): + logger.warning('no files found matching %r', pattern) + + elif action == 'exclude': + for pattern in patterns: + self._exclude_pattern(pattern, anchor=True) + + elif action == 'global-include': + for pattern in patterns: + if not self._include_pattern(pattern, anchor=False): + logger.warning('no files found matching %r ' + 'anywhere in distribution', pattern) + + elif action == 'global-exclude': + for pattern in patterns: + self._exclude_pattern(pattern, anchor=False) + + elif action == 'recursive-include': + for pattern in patterns: + if not self._include_pattern(pattern, prefix=thedir): + logger.warning('no files found matching %r ' + 'under directory %r', pattern, thedir) + + elif action == 'recursive-exclude': + for pattern in patterns: + self._exclude_pattern(pattern, prefix=thedir) + + elif action == 'graft': + if not self._include_pattern(None, prefix=dirpattern): + logger.warning('no directories found matching %r', + dirpattern) + + elif action == 'prune': + if not self._exclude_pattern(None, prefix=dirpattern): + logger.warning('no previously-included directories found ' + 'matching %r', dirpattern) + else: # pragma: no cover + # This should never happen, as it should be caught in + # _parse_template_line + raise DistlibException( + 'invalid action %r' % action) + + # + # Private API + # + + def _parse_directive(self, directive): + """ + Validate a directive. + :param directive: The directive to validate. + :return: A tuple of action, patterns, thedir, dir_patterns + """ + words = directive.split() + if len(words) == 1 and words[0] not in ('include', 'exclude', + 'global-include', + 'global-exclude', + 'recursive-include', + 'recursive-exclude', + 'graft', 'prune'): + # no action given, let's use the default 'include' + words.insert(0, 'include') + + action = words[0] + patterns = thedir = dir_pattern = None + + if action in ('include', 'exclude', + 'global-include', 'global-exclude'): + if len(words) < 2: + raise DistlibException( + '%r expects ...' % action) + + patterns = [convert_path(word) for word in words[1:]] + + elif action in ('recursive-include', 'recursive-exclude'): + if len(words) < 3: + raise DistlibException( + '%r expects ...' % action) + + thedir = convert_path(words[1]) + patterns = [convert_path(word) for word in words[2:]] + + elif action in ('graft', 'prune'): + if len(words) != 2: + raise DistlibException( + '%r expects a single ' % action) + + dir_pattern = convert_path(words[1]) + + else: + raise DistlibException('unknown action %r' % action) + + return action, patterns, thedir, dir_pattern + + def _include_pattern(self, pattern, anchor=True, prefix=None, + is_regex=False): + """Select strings (presumably filenames) from 'self.files' that + match 'pattern', a Unix-style wildcard (glob) pattern. + + Patterns are not quite the same as implemented by the 'fnmatch' + module: '*' and '?' match non-special characters, where "special" + is platform-dependent: slash on Unix; colon, slash, and backslash on + DOS/Windows; and colon on Mac OS. + + If 'anchor' is true (the default), then the pattern match is more + stringent: "*.py" will match "foo.py" but not "foo/bar.py". If + 'anchor' is false, both of these will match. + + If 'prefix' is supplied, then only filenames starting with 'prefix' + (itself a pattern) and ending with 'pattern', with anything in between + them, will match. 'anchor' is ignored in this case. + + If 'is_regex' is true, 'anchor' and 'prefix' are ignored, and + 'pattern' is assumed to be either a string containing a regex or a + regex object -- no translation is done, the regex is just compiled + and used as-is. + + Selected strings will be added to self.files. + + Return True if files are found. + """ + # XXX docstring lying about what the special chars are? + found = False + pattern_re = self._translate_pattern(pattern, anchor, prefix, is_regex) + + # delayed loading of allfiles list + if self.allfiles is None: + self.findall() + + for name in self.allfiles: + if pattern_re.search(name): + self.files.add(name) + found = True + return found + + def _exclude_pattern(self, pattern, anchor=True, prefix=None, + is_regex=False): + """Remove strings (presumably filenames) from 'files' that match + 'pattern'. + + Other parameters are the same as for 'include_pattern()', above. + The list 'self.files' is modified in place. Return True if files are + found. + + This API is public to allow e.g. exclusion of SCM subdirs, e.g. when + packaging source distributions + """ + found = False + pattern_re = self._translate_pattern(pattern, anchor, prefix, is_regex) + for f in list(self.files): + if pattern_re.search(f): + self.files.remove(f) + found = True + return found + + def _translate_pattern(self, pattern, anchor=True, prefix=None, + is_regex=False): + """Translate a shell-like wildcard pattern to a compiled regular + expression. + + Return the compiled regex. If 'is_regex' true, + then 'pattern' is directly compiled to a regex (if it's a string) + or just returned as-is (assumes it's a regex object). + """ + if is_regex: + if isinstance(pattern, str): + return re.compile(pattern) + else: + return pattern + + if _PYTHON_VERSION > (3, 2): + # ditch start and end characters + start, _, end = self._glob_to_re('_').partition('_') + + if pattern: + pattern_re = self._glob_to_re(pattern) + if _PYTHON_VERSION > (3, 2): + assert pattern_re.startswith(start) and pattern_re.endswith(end) + else: + pattern_re = '' + + base = re.escape(os.path.join(self.base, '')) + if prefix is not None: + # ditch end of pattern character + if _PYTHON_VERSION <= (3, 2): + empty_pattern = self._glob_to_re('') + prefix_re = self._glob_to_re(prefix)[:-len(empty_pattern)] + else: + prefix_re = self._glob_to_re(prefix) + assert prefix_re.startswith(start) and prefix_re.endswith(end) + prefix_re = prefix_re[len(start): len(prefix_re) - len(end)] + sep = os.sep + if os.sep == '\\': + sep = r'\\' + if _PYTHON_VERSION <= (3, 2): + pattern_re = '^' + base + sep.join((prefix_re, + '.*' + pattern_re)) + else: + pattern_re = pattern_re[len(start): len(pattern_re) - len(end)] + pattern_re = r'%s%s%s%s.*%s%s' % (start, base, prefix_re, sep, + pattern_re, end) + else: # no prefix -- respect anchor flag + if anchor: + if _PYTHON_VERSION <= (3, 2): + pattern_re = '^' + base + pattern_re + else: + pattern_re = r'%s%s%s' % (start, base, pattern_re[len(start):]) + + return re.compile(pattern_re) + + def _glob_to_re(self, pattern): + """Translate a shell-like glob pattern to a regular expression. + + Return a string containing the regex. Differs from + 'fnmatch.translate()' in that '*' does not match "special characters" + (which are platform-specific). + """ + pattern_re = fnmatch.translate(pattern) + + # '?' and '*' in the glob pattern become '.' and '.*' in the RE, which + # IMHO is wrong -- '?' and '*' aren't supposed to match slash in Unix, + # and by extension they shouldn't match such "special characters" under + # any OS. So change all non-escaped dots in the RE to match any + # character except the special characters (currently: just os.sep). + sep = os.sep + if os.sep == '\\': + # we're using a regex to manipulate a regex, so we need + # to escape the backslash twice + sep = r'\\\\' + escaped = r'\1[^%s]' % sep + pattern_re = re.sub(r'((? y, + '!=': lambda x, y: x != y, + '<': lambda x, y: x < y, + '<=': lambda x, y: x == y or x < y, + '>': lambda x, y: x > y, + '>=': lambda x, y: x == y or x > y, + 'and': lambda x, y: x and y, + 'or': lambda x, y: x or y, + 'in': lambda x, y: x in y, + 'not in': lambda x, y: x not in y, + } + + def evaluate(self, expr, context): + """ + Evaluate a marker expression returned by the :func:`parse_requirement` + function in the specified context. + """ + if isinstance(expr, string_types): + if expr[0] in '\'"': + result = expr[1:-1] + else: + if expr not in context: + raise SyntaxError('unknown variable: %s' % expr) + result = context[expr] + else: + assert isinstance(expr, dict) + op = expr['op'] + if op not in self.operations: + raise NotImplementedError('op not implemented: %s' % op) + elhs = expr['lhs'] + erhs = expr['rhs'] + if _is_literal(expr['lhs']) and _is_literal(expr['rhs']): + raise SyntaxError('invalid comparison: %s %s %s' % (elhs, op, erhs)) + + lhs = self.evaluate(elhs, context) + rhs = self.evaluate(erhs, context) + if ((_is_version_marker(elhs) or _is_version_marker(erhs)) and + op in ('<', '<=', '>', '>=', '===', '==', '!=', '~=')): + lhs = LV(lhs) + rhs = LV(rhs) + elif _is_version_marker(elhs) and op in ('in', 'not in'): + lhs = LV(lhs) + rhs = _get_versions(rhs) + result = self.operations[op](lhs, rhs) + return result + + +_DIGITS = re.compile(r'\d+\.\d+') + + +def default_context(): + + def format_full_version(info): + version = '%s.%s.%s' % (info.major, info.minor, info.micro) + kind = info.releaselevel + if kind != 'final': + version += kind[0] + str(info.serial) + return version + + if hasattr(sys, 'implementation'): + implementation_version = format_full_version(sys.implementation.version) + implementation_name = sys.implementation.name + else: + implementation_version = '0' + implementation_name = '' + + ppv = platform.python_version() + m = _DIGITS.match(ppv) + pv = m.group(0) + result = { + 'implementation_name': implementation_name, + 'implementation_version': implementation_version, + 'os_name': os.name, + 'platform_machine': platform.machine(), + 'platform_python_implementation': platform.python_implementation(), + 'platform_release': platform.release(), + 'platform_system': platform.system(), + 'platform_version': platform.version(), + 'platform_in_venv': str(in_venv()), + 'python_full_version': ppv, + 'python_version': pv, + 'sys_platform': sys.platform, + } + return result + + +DEFAULT_CONTEXT = default_context() +del default_context + +evaluator = Evaluator() + + +def interpret(marker, execution_context=None): + """ + Interpret a marker and return a result depending on environment. + + :param marker: The marker to interpret. + :type marker: str + :param execution_context: The context used for name lookup. + :type execution_context: mapping + """ + try: + expr, rest = parse_marker(marker) + except Exception as e: + raise SyntaxError('Unable to interpret marker syntax: %s: %s' % (marker, e)) + if rest and rest[0] != '#': + raise SyntaxError('unexpected trailing data in marker: %s: %s' % (marker, rest)) + context = dict(DEFAULT_CONTEXT) + if execution_context: + context.update(execution_context) + return evaluator.evaluate(expr, context) diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/metadata.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/metadata.py new file mode 100644 index 0000000..ce9a34b --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/metadata.py @@ -0,0 +1,1031 @@ +# -*- coding: utf-8 -*- +# +# Copyright (C) 2012 The Python Software Foundation. +# See LICENSE.txt and CONTRIBUTORS.txt. +# +"""Implementation of the Metadata for Python packages PEPs. + +Supports all metadata formats (1.0, 1.1, 1.2, 1.3/2.1 and 2.2). +""" +from __future__ import unicode_literals + +import codecs +from email import message_from_file +import json +import logging +import re + +from . import DistlibException, __version__ +from .compat import StringIO, string_types, text_type +from .markers import interpret +from .util import extract_by_key, get_extras +from .version import get_scheme, PEP440_VERSION_RE + +logger = logging.getLogger(__name__) + + +class MetadataMissingError(DistlibException): + """A required metadata is missing""" + + +class MetadataConflictError(DistlibException): + """Attempt to read or write metadata fields that are conflictual.""" + + +class MetadataUnrecognizedVersionError(DistlibException): + """Unknown metadata version number.""" + + +class MetadataInvalidError(DistlibException): + """A metadata value is invalid""" + + +# public API of this module +__all__ = ['Metadata', 'PKG_INFO_ENCODING', 'PKG_INFO_PREFERRED_VERSION'] + +# Encoding used for the PKG-INFO files +PKG_INFO_ENCODING = 'utf-8' + +# preferred version. Hopefully will be changed +# to 1.2 once PEP 345 is supported everywhere +PKG_INFO_PREFERRED_VERSION = '1.1' + +_LINE_PREFIX_1_2 = re.compile('\n \\|') +_LINE_PREFIX_PRE_1_2 = re.compile('\n ') +_241_FIELDS = ('Metadata-Version', 'Name', 'Version', 'Platform', 'Summary', 'Description', 'Keywords', 'Home-page', + 'Author', 'Author-email', 'License') + +_314_FIELDS = ('Metadata-Version', 'Name', 'Version', 'Platform', 'Supported-Platform', 'Summary', 'Description', + 'Keywords', 'Home-page', 'Author', 'Author-email', 'License', 'Classifier', 'Download-URL', 'Obsoletes', + 'Provides', 'Requires') + +_314_MARKERS = ('Obsoletes', 'Provides', 'Requires', 'Classifier', 'Download-URL') + +_345_FIELDS = ('Metadata-Version', 'Name', 'Version', 'Platform', 'Supported-Platform', 'Summary', 'Description', + 'Keywords', 'Home-page', 'Author', 'Author-email', 'Maintainer', 'Maintainer-email', 'License', + 'Classifier', 'Download-URL', 'Obsoletes-Dist', 'Project-URL', 'Provides-Dist', 'Requires-Dist', + 'Requires-Python', 'Requires-External') + +_345_MARKERS = ('Provides-Dist', 'Requires-Dist', 'Requires-Python', 'Obsoletes-Dist', 'Requires-External', + 'Maintainer', 'Maintainer-email', 'Project-URL') + +_426_FIELDS = ('Metadata-Version', 'Name', 'Version', 'Platform', 'Supported-Platform', 'Summary', 'Description', + 'Keywords', 'Home-page', 'Author', 'Author-email', 'Maintainer', 'Maintainer-email', 'License', + 'Classifier', 'Download-URL', 'Obsoletes-Dist', 'Project-URL', 'Provides-Dist', 'Requires-Dist', + 'Requires-Python', 'Requires-External', 'Private-Version', 'Obsoleted-By', 'Setup-Requires-Dist', + 'Extension', 'Provides-Extra') + +_426_MARKERS = ('Private-Version', 'Provides-Extra', 'Obsoleted-By', 'Setup-Requires-Dist', 'Extension') + +# See issue #106: Sometimes 'Requires' and 'Provides' occur wrongly in +# the metadata. Include them in the tuple literal below to allow them +# (for now). +# Ditto for Obsoletes - see issue #140. +_566_FIELDS = _426_FIELDS + ('Description-Content-Type', 'Requires', 'Provides', 'Obsoletes') + +_566_MARKERS = ('Description-Content-Type', ) + +_643_MARKERS = ('Dynamic', 'License-File') + +_643_FIELDS = _566_FIELDS + _643_MARKERS + +_ALL_FIELDS = set() +_ALL_FIELDS.update(_241_FIELDS) +_ALL_FIELDS.update(_314_FIELDS) +_ALL_FIELDS.update(_345_FIELDS) +_ALL_FIELDS.update(_426_FIELDS) +_ALL_FIELDS.update(_566_FIELDS) +_ALL_FIELDS.update(_643_FIELDS) + +EXTRA_RE = re.compile(r'''extra\s*==\s*("([^"]+)"|'([^']+)')''') + + +def _version2fieldlist(version): + if version == '1.0': + return _241_FIELDS + elif version == '1.1': + return _314_FIELDS + elif version == '1.2': + return _345_FIELDS + elif version in ('1.3', '2.1'): + # avoid adding field names if already there + return _345_FIELDS + tuple(f for f in _566_FIELDS if f not in _345_FIELDS) + elif version == '2.0': + raise ValueError('Metadata 2.0 is withdrawn and not supported') + # return _426_FIELDS + elif version == '2.2': + return _643_FIELDS + raise MetadataUnrecognizedVersionError(version) + + +def _best_version(fields): + """Detect the best version depending on the fields used.""" + + def _has_marker(keys, markers): + return any(marker in keys for marker in markers) + + keys = [key for key, value in fields.items() if value not in ([], 'UNKNOWN', None)] + possible_versions = ['1.0', '1.1', '1.2', '1.3', '2.1', '2.2'] # 2.0 removed + + # first let's try to see if a field is not part of one of the version + for key in keys: + if key not in _241_FIELDS and '1.0' in possible_versions: + possible_versions.remove('1.0') + logger.debug('Removed 1.0 due to %s', key) + if key not in _314_FIELDS and '1.1' in possible_versions: + possible_versions.remove('1.1') + logger.debug('Removed 1.1 due to %s', key) + if key not in _345_FIELDS and '1.2' in possible_versions: + possible_versions.remove('1.2') + logger.debug('Removed 1.2 due to %s', key) + if key not in _566_FIELDS and '1.3' in possible_versions: + possible_versions.remove('1.3') + logger.debug('Removed 1.3 due to %s', key) + if key not in _566_FIELDS and '2.1' in possible_versions: + if key != 'Description': # In 2.1, description allowed after headers + possible_versions.remove('2.1') + logger.debug('Removed 2.1 due to %s', key) + if key not in _643_FIELDS and '2.2' in possible_versions: + possible_versions.remove('2.2') + logger.debug('Removed 2.2 due to %s', key) + # if key not in _426_FIELDS and '2.0' in possible_versions: + # possible_versions.remove('2.0') + # logger.debug('Removed 2.0 due to %s', key) + + # possible_version contains qualified versions + if len(possible_versions) == 1: + return possible_versions[0] # found ! + elif len(possible_versions) == 0: + logger.debug('Out of options - unknown metadata set: %s', fields) + raise MetadataConflictError('Unknown metadata set') + + # let's see if one unique marker is found + is_1_1 = '1.1' in possible_versions and _has_marker(keys, _314_MARKERS) + is_1_2 = '1.2' in possible_versions and _has_marker(keys, _345_MARKERS) + is_2_1 = '2.1' in possible_versions and _has_marker(keys, _566_MARKERS) + # is_2_0 = '2.0' in possible_versions and _has_marker(keys, _426_MARKERS) + is_2_2 = '2.2' in possible_versions and _has_marker(keys, _643_MARKERS) + if int(is_1_1) + int(is_1_2) + int(is_2_1) + int(is_2_2) > 1: + raise MetadataConflictError('You used incompatible 1.1/1.2/2.1/2.2 fields') + + # we have the choice, 1.0, or 1.2, 2.1 or 2.2 + # - 1.0 has a broken Summary field but works with all tools + # - 1.1 is to avoid + # - 1.2 fixes Summary but has little adoption + # - 2.1 adds more features + # - 2.2 is the latest + if not is_1_1 and not is_1_2 and not is_2_1 and not is_2_2: + # we couldn't find any specific marker + if PKG_INFO_PREFERRED_VERSION in possible_versions: + return PKG_INFO_PREFERRED_VERSION + if is_1_1: + return '1.1' + if is_1_2: + return '1.2' + if is_2_1: + return '2.1' + # if is_2_2: + # return '2.2' + + return '2.2' + + +# This follows the rules about transforming keys as described in +# https://www.python.org/dev/peps/pep-0566/#id17 +_ATTR2FIELD = {name.lower().replace("-", "_"): name for name in _ALL_FIELDS} +_FIELD2ATTR = {field: attr for attr, field in _ATTR2FIELD.items()} + +_PREDICATE_FIELDS = ('Requires-Dist', 'Obsoletes-Dist', 'Provides-Dist') +_VERSIONS_FIELDS = ('Requires-Python', ) +_VERSION_FIELDS = ('Version', ) +_LISTFIELDS = ('Platform', 'Classifier', 'Obsoletes', 'Requires', 'Provides', 'Obsoletes-Dist', 'Provides-Dist', + 'Requires-Dist', 'Requires-External', 'Project-URL', 'Supported-Platform', 'Setup-Requires-Dist', + 'Provides-Extra', 'Extension', 'License-File') +_LISTTUPLEFIELDS = ('Project-URL', ) + +_ELEMENTSFIELD = ('Keywords', ) + +_UNICODEFIELDS = ('Author', 'Maintainer', 'Summary', 'Description') + +_MISSING = object() + +_FILESAFE = re.compile('[^A-Za-z0-9.]+') + + +def _get_name_and_version(name, version, for_filename=False): + """Return the distribution name with version. + + If for_filename is true, return a filename-escaped form.""" + if for_filename: + # For both name and version any runs of non-alphanumeric or '.' + # characters are replaced with a single '-'. Additionally any + # spaces in the version string become '.' + name = _FILESAFE.sub('-', name) + version = _FILESAFE.sub('-', version.replace(' ', '.')) + return '%s-%s' % (name, version) + + +class LegacyMetadata(object): + """The legacy metadata of a release. + + Supports versions 1.0, 1.1, 1.2, 2.0 and 1.3/2.1 (auto-detected). You can + instantiate the class with one of these arguments (or none): + - *path*, the path to a metadata file + - *fileobj* give a file-like object with metadata as content + - *mapping* is a dict-like object + - *scheme* is a version scheme name + """ + + # TODO document the mapping API and UNKNOWN default key + + def __init__(self, path=None, fileobj=None, mapping=None, scheme='default'): + if [path, fileobj, mapping].count(None) < 2: + raise TypeError('path, fileobj and mapping are exclusive') + self._fields = {} + self.requires_files = [] + self._dependencies = None + self.scheme = scheme + if path is not None: + self.read(path) + elif fileobj is not None: + self.read_file(fileobj) + elif mapping is not None: + self.update(mapping) + self.set_metadata_version() + + def set_metadata_version(self): + self._fields['Metadata-Version'] = _best_version(self._fields) + + def _write_field(self, fileobj, name, value): + fileobj.write('%s: %s\n' % (name, value)) + + def __getitem__(self, name): + return self.get(name) + + def __setitem__(self, name, value): + return self.set(name, value) + + def __delitem__(self, name): + field_name = self._convert_name(name) + try: + del self._fields[field_name] + except KeyError: + raise KeyError(name) + + def __contains__(self, name): + return (name in self._fields or self._convert_name(name) in self._fields) + + def _convert_name(self, name): + if name in _ALL_FIELDS: + return name + name = name.replace('-', '_').lower() + return _ATTR2FIELD.get(name, name) + + def _default_value(self, name): + if name in _LISTFIELDS or name in _ELEMENTSFIELD: + return [] + return 'UNKNOWN' + + def _remove_line_prefix(self, value): + if self.metadata_version in ('1.0', '1.1'): + return _LINE_PREFIX_PRE_1_2.sub('\n', value) + else: + return _LINE_PREFIX_1_2.sub('\n', value) + + def __getattr__(self, name): + if name in _ATTR2FIELD: + return self[name] + raise AttributeError(name) + + # + # Public API + # + + def get_fullname(self, filesafe=False): + """ + Return the distribution name with version. + + If filesafe is true, return a filename-escaped form. + """ + return _get_name_and_version(self['Name'], self['Version'], filesafe) + + def is_field(self, name): + """return True if name is a valid metadata key""" + name = self._convert_name(name) + return name in _ALL_FIELDS + + def is_multi_field(self, name): + name = self._convert_name(name) + return name in _LISTFIELDS + + def read(self, filepath): + """Read the metadata values from a file path.""" + fp = codecs.open(filepath, 'r', encoding='utf-8') + try: + self.read_file(fp) + finally: + fp.close() + + def read_file(self, fileob): + """Read the metadata values from a file object.""" + msg = message_from_file(fileob) + self._fields['Metadata-Version'] = msg['metadata-version'] + + # When reading, get all the fields we can + for field in _ALL_FIELDS: + if field not in msg: + continue + if field in _LISTFIELDS: + # we can have multiple lines + values = msg.get_all(field) + if field in _LISTTUPLEFIELDS and values is not None: + values = [tuple(value.split(',')) for value in values] + self.set(field, values) + else: + # single line + value = msg[field] + if value is not None and value != 'UNKNOWN': + self.set(field, value) + + # PEP 566 specifies that the body be used for the description, if + # available + body = msg.get_payload() + self["Description"] = body if body else self["Description"] + # logger.debug('Attempting to set metadata for %s', self) + # self.set_metadata_version() + + def write(self, filepath, skip_unknown=False): + """Write the metadata fields to filepath.""" + fp = codecs.open(filepath, 'w', encoding='utf-8') + try: + self.write_file(fp, skip_unknown) + finally: + fp.close() + + def write_file(self, fileobject, skip_unknown=False): + """Write the PKG-INFO format data to a file object.""" + self.set_metadata_version() + + for field in _version2fieldlist(self['Metadata-Version']): + values = self.get(field) + if skip_unknown and values in ('UNKNOWN', [], ['UNKNOWN']): + continue + if field in _ELEMENTSFIELD: + self._write_field(fileobject, field, ','.join(values)) + continue + if field not in _LISTFIELDS: + if field == 'Description': + if self.metadata_version in ('1.0', '1.1'): + values = values.replace('\n', '\n ') + else: + values = values.replace('\n', '\n |') + values = [values] + + if field in _LISTTUPLEFIELDS: + values = [','.join(value) for value in values] + + for value in values: + self._write_field(fileobject, field, value) + + def update(self, other=None, **kwargs): + """Set metadata values from the given iterable `other` and kwargs. + + Behavior is like `dict.update`: If `other` has a ``keys`` method, + they are looped over and ``self[key]`` is assigned ``other[key]``. + Else, ``other`` is an iterable of ``(key, value)`` iterables. + + Keys that don't match a metadata field or that have an empty value are + dropped. + """ + + def _set(key, value): + if key in _ATTR2FIELD and value: + self.set(self._convert_name(key), value) + + if not other: + # other is None or empty container + pass + elif hasattr(other, 'keys'): + for k in other.keys(): + _set(k, other[k]) + else: + for k, v in other: + _set(k, v) + + if kwargs: + for k, v in kwargs.items(): + _set(k, v) + + def set(self, name, value): + """Control then set a metadata field.""" + name = self._convert_name(name) + + if ((name in _ELEMENTSFIELD or name == 'Platform') and not isinstance(value, (list, tuple))): + if isinstance(value, string_types): + value = [v.strip() for v in value.split(',')] + else: + value = [] + elif (name in _LISTFIELDS and not isinstance(value, (list, tuple))): + if isinstance(value, string_types): + value = [value] + else: + value = [] + + if logger.isEnabledFor(logging.WARNING): + project_name = self['Name'] + + scheme = get_scheme(self.scheme) + if name in _PREDICATE_FIELDS and value is not None: + for v in value: + # check that the values are valid + if not scheme.is_valid_matcher(v.split(';')[0]): + logger.warning("'%s': '%s' is not valid (field '%s')", project_name, v, name) + # FIXME this rejects UNKNOWN, is that right? + elif name in _VERSIONS_FIELDS and value is not None: + if not scheme.is_valid_constraint_list(value): + logger.warning("'%s': '%s' is not a valid version (field '%s')", project_name, value, name) + elif name in _VERSION_FIELDS and value is not None: + if not scheme.is_valid_version(value): + logger.warning("'%s': '%s' is not a valid version (field '%s')", project_name, value, name) + + if name in _UNICODEFIELDS: + if name == 'Description': + value = self._remove_line_prefix(value) + + self._fields[name] = value + + def get(self, name, default=_MISSING): + """Get a metadata field.""" + name = self._convert_name(name) + if name not in self._fields: + if default is _MISSING: + default = self._default_value(name) + return default + if name in _UNICODEFIELDS: + value = self._fields[name] + return value + elif name in _LISTFIELDS: + value = self._fields[name] + if value is None: + return [] + res = [] + for val in value: + if name not in _LISTTUPLEFIELDS: + res.append(val) + else: + # That's for Project-URL + res.append((val[0], val[1])) + return res + + elif name in _ELEMENTSFIELD: + value = self._fields[name] + if isinstance(value, string_types): + return value.split(',') + return self._fields[name] + + def check(self, strict=False): + """Check if the metadata is compliant. If strict is True then raise if + no Name or Version are provided""" + self.set_metadata_version() + + # XXX should check the versions (if the file was loaded) + missing, warnings = [], [] + + for attr in ('Name', 'Version'): # required by PEP 345 + if attr not in self: + missing.append(attr) + + if strict and missing != []: + msg = 'missing required metadata: %s' % ', '.join(missing) + raise MetadataMissingError(msg) + + for attr in ('Home-page', 'Author'): + if attr not in self: + missing.append(attr) + + # checking metadata 1.2 (XXX needs to check 1.1, 1.0) + if self['Metadata-Version'] != '1.2': + return missing, warnings + + scheme = get_scheme(self.scheme) + + def are_valid_constraints(value): + for v in value: + if not scheme.is_valid_matcher(v.split(';')[0]): + return False + return True + + for fields, controller in ((_PREDICATE_FIELDS, are_valid_constraints), + (_VERSIONS_FIELDS, scheme.is_valid_constraint_list), (_VERSION_FIELDS, + scheme.is_valid_version)): + for field in fields: + value = self.get(field, None) + if value is not None and not controller(value): + warnings.append("Wrong value for '%s': %s" % (field, value)) + + return missing, warnings + + def todict(self, skip_missing=False): + """Return fields as a dict. + + Field names will be converted to use the underscore-lowercase style + instead of hyphen-mixed case (i.e. home_page instead of Home-page). + This is as per https://www.python.org/dev/peps/pep-0566/#id17. + """ + self.set_metadata_version() + + fields = _version2fieldlist(self['Metadata-Version']) + + data = {} + + for field_name in fields: + if not skip_missing or field_name in self._fields: + key = _FIELD2ATTR[field_name] + if key != 'project_url': + data[key] = self[field_name] + else: + data[key] = [','.join(u) for u in self[field_name]] + + return data + + def add_requirements(self, requirements): + if self['Metadata-Version'] == '1.1': + # we can't have 1.1 metadata *and* Setuptools requires + for field in ('Obsoletes', 'Requires', 'Provides'): + if field in self: + del self[field] + self['Requires-Dist'] += requirements + + # Mapping API + # TODO could add iter* variants + + def keys(self): + return list(_version2fieldlist(self['Metadata-Version'])) + + def __iter__(self): + for key in self.keys(): + yield key + + def values(self): + return [self[key] for key in self.keys()] + + def items(self): + return [(key, self[key]) for key in self.keys()] + + def __repr__(self): + return '<%s %s %s>' % (self.__class__.__name__, self.name, self.version) + + +METADATA_FILENAME = 'pydist.json' +WHEEL_METADATA_FILENAME = 'metadata.json' +LEGACY_METADATA_FILENAME = 'METADATA' + + +class Metadata(object): + """ + The metadata of a release. This implementation uses 2.1 + metadata where possible. If not possible, it wraps a LegacyMetadata + instance which handles the key-value metadata format. + """ + + METADATA_VERSION_MATCHER = re.compile(r'^\d+(\.\d+)*$') + + NAME_MATCHER = re.compile('^[0-9A-Z]([0-9A-Z_.-]*[0-9A-Z])?$', re.I) + + FIELDNAME_MATCHER = re.compile('^[A-Z]([0-9A-Z-]*[0-9A-Z])?$', re.I) + + VERSION_MATCHER = PEP440_VERSION_RE + + SUMMARY_MATCHER = re.compile('.{1,2047}') + + METADATA_VERSION = '2.0' + + GENERATOR = 'distlib (%s)' % __version__ + + MANDATORY_KEYS = { + 'name': (), + 'version': (), + 'summary': ('legacy', ), + } + + INDEX_KEYS = ('name version license summary description author ' + 'author_email keywords platform home_page classifiers ' + 'download_url') + + DEPENDENCY_KEYS = ('extras run_requires test_requires build_requires ' + 'dev_requires provides meta_requires obsoleted_by ' + 'supports_environments') + + SYNTAX_VALIDATORS = { + 'metadata_version': (METADATA_VERSION_MATCHER, ()), + 'name': (NAME_MATCHER, ('legacy', )), + 'version': (VERSION_MATCHER, ('legacy', )), + 'summary': (SUMMARY_MATCHER, ('legacy', )), + 'dynamic': (FIELDNAME_MATCHER, ('legacy', )), + } + + __slots__ = ('_legacy', '_data', 'scheme') + + def __init__(self, path=None, fileobj=None, mapping=None, scheme='default'): + if [path, fileobj, mapping].count(None) < 2: + raise TypeError('path, fileobj and mapping are exclusive') + self._legacy = None + self._data = None + self.scheme = scheme + # import pdb; pdb.set_trace() + if mapping is not None: + try: + self._validate_mapping(mapping, scheme) + self._data = mapping + except MetadataUnrecognizedVersionError: + self._legacy = LegacyMetadata(mapping=mapping, scheme=scheme) + self.validate() + else: + data = None + if path: + with open(path, 'rb') as f: + data = f.read() + elif fileobj: + data = fileobj.read() + if data is None: + # Initialised with no args - to be added + self._data = { + 'metadata_version': self.METADATA_VERSION, + 'generator': self.GENERATOR, + } + else: + if not isinstance(data, text_type): + data = data.decode('utf-8') + try: + self._data = json.loads(data) + self._validate_mapping(self._data, scheme) + except ValueError: + # Note: MetadataUnrecognizedVersionError does not + # inherit from ValueError (it's a DistlibException, + # which should not inherit from ValueError). + # The ValueError comes from the json.load - if that + # succeeds and we get a validation error, we want + # that to propagate + self._legacy = LegacyMetadata(fileobj=StringIO(data), scheme=scheme) + self.validate() + + common_keys = set(('name', 'version', 'license', 'keywords', 'summary')) + + none_list = (None, list) + none_dict = (None, dict) + + mapped_keys = { + 'run_requires': ('Requires-Dist', list), + 'build_requires': ('Setup-Requires-Dist', list), + 'dev_requires': none_list, + 'test_requires': none_list, + 'meta_requires': none_list, + 'extras': ('Provides-Extra', list), + 'modules': none_list, + 'namespaces': none_list, + 'exports': none_dict, + 'commands': none_dict, + 'classifiers': ('Classifier', list), + 'source_url': ('Download-URL', None), + 'metadata_version': ('Metadata-Version', None), + } + + del none_list, none_dict + + def __getattribute__(self, key): + common = object.__getattribute__(self, 'common_keys') + mapped = object.__getattribute__(self, 'mapped_keys') + if key in mapped: + lk, maker = mapped[key] + if self._legacy: + if lk is None: + result = None if maker is None else maker() + else: + result = self._legacy.get(lk) + else: + value = None if maker is None else maker() + if key not in ('commands', 'exports', 'modules', 'namespaces', 'classifiers'): + result = self._data.get(key, value) + else: + # special cases for PEP 459 + sentinel = object() + result = sentinel + d = self._data.get('extensions') + if d: + if key == 'commands': + result = d.get('python.commands', value) + elif key == 'classifiers': + d = d.get('python.details') + if d: + result = d.get(key, value) + else: + d = d.get('python.exports') + if not d: + d = self._data.get('python.exports') + if d: + result = d.get(key, value) + if result is sentinel: + result = value + elif key not in common: + result = object.__getattribute__(self, key) + elif self._legacy: + result = self._legacy.get(key) + else: + result = self._data.get(key) + return result + + def _validate_value(self, key, value, scheme=None): + if key in self.SYNTAX_VALIDATORS: + pattern, exclusions = self.SYNTAX_VALIDATORS[key] + if (scheme or self.scheme) not in exclusions: + m = pattern.match(value) + if not m: + raise MetadataInvalidError("'%s' is an invalid value for " + "the '%s' property" % (value, key)) + + def __setattr__(self, key, value): + self._validate_value(key, value) + common = object.__getattribute__(self, 'common_keys') + mapped = object.__getattribute__(self, 'mapped_keys') + if key in mapped: + lk, _ = mapped[key] + if self._legacy: + if lk is None: + raise NotImplementedError + self._legacy[lk] = value + elif key not in ('commands', 'exports', 'modules', 'namespaces', 'classifiers'): + self._data[key] = value + else: + # special cases for PEP 459 + d = self._data.setdefault('extensions', {}) + if key == 'commands': + d['python.commands'] = value + elif key == 'classifiers': + d = d.setdefault('python.details', {}) + d[key] = value + else: + d = d.setdefault('python.exports', {}) + d[key] = value + elif key not in common: + object.__setattr__(self, key, value) + else: + if key == 'keywords': + if isinstance(value, string_types): + value = value.strip() + if value: + value = value.split() + else: + value = [] + if self._legacy: + self._legacy[key] = value + else: + self._data[key] = value + + @property + def name_and_version(self): + return _get_name_and_version(self.name, self.version, True) + + @property + def provides(self): + if self._legacy: + result = self._legacy['Provides-Dist'] + else: + result = self._data.setdefault('provides', []) + s = '%s (%s)' % (self.name, self.version) + if s not in result: + result.append(s) + return result + + @provides.setter + def provides(self, value): + if self._legacy: + self._legacy['Provides-Dist'] = value + else: + self._data['provides'] = value + + def get_requirements(self, reqts, extras=None, env=None): + """ + Base method to get dependencies, given a set of extras + to satisfy and an optional environment context. + :param reqts: A list of sometimes-wanted dependencies, + perhaps dependent on extras and environment. + :param extras: A list of optional components being requested. + :param env: An optional environment for marker evaluation. + """ + if self._legacy: + result = reqts + else: + result = [] + extras = get_extras(extras or [], self.extras) + for d in reqts: + if 'extra' not in d and 'environment' not in d: + # unconditional + include = True + else: + if 'extra' not in d: + # Not extra-dependent - only environment-dependent + include = True + else: + include = d.get('extra') in extras + if include: + # Not excluded because of extras, check environment + marker = d.get('environment') + if marker: + include = interpret(marker, env) + if include: + result.extend(d['requires']) + for key in ('build', 'dev', 'test'): + e = ':%s:' % key + if e in extras: + extras.remove(e) + # A recursive call, but it should terminate since 'test' + # has been removed from the extras + reqts = self._data.get('%s_requires' % key, []) + result.extend(self.get_requirements(reqts, extras=extras, env=env)) + return result + + @property + def dictionary(self): + if self._legacy: + return self._from_legacy() + return self._data + + @property + def dependencies(self): + if self._legacy: + raise NotImplementedError + else: + return extract_by_key(self._data, self.DEPENDENCY_KEYS) + + @dependencies.setter + def dependencies(self, value): + if self._legacy: + raise NotImplementedError + else: + self._data.update(value) + + def _validate_mapping(self, mapping, scheme): + if mapping.get('metadata_version') != self.METADATA_VERSION: + raise MetadataUnrecognizedVersionError() + missing = [] + for key, exclusions in self.MANDATORY_KEYS.items(): + if key not in mapping: + if scheme not in exclusions: + missing.append(key) + if missing: + msg = 'Missing metadata items: %s' % ', '.join(missing) + raise MetadataMissingError(msg) + for k, v in mapping.items(): + self._validate_value(k, v, scheme) + + def validate(self): + if self._legacy: + missing, warnings = self._legacy.check(True) + if missing or warnings: + logger.warning('Metadata: missing: %s, warnings: %s', missing, warnings) + else: + self._validate_mapping(self._data, self.scheme) + + def todict(self): + if self._legacy: + return self._legacy.todict(True) + else: + result = extract_by_key(self._data, self.INDEX_KEYS) + return result + + def _from_legacy(self): + assert self._legacy and not self._data + result = { + 'metadata_version': self.METADATA_VERSION, + 'generator': self.GENERATOR, + } + lmd = self._legacy.todict(True) # skip missing ones + for k in ('name', 'version', 'license', 'summary', 'description', 'classifier'): + if k in lmd: + if k == 'classifier': + nk = 'classifiers' + else: + nk = k + result[nk] = lmd[k] + kw = lmd.get('Keywords', []) + if kw == ['']: + kw = [] + result['keywords'] = kw + keys = (('requires_dist', 'run_requires'), ('setup_requires_dist', 'build_requires')) + for ok, nk in keys: + if ok in lmd and lmd[ok]: + result[nk] = [{'requires': lmd[ok]}] + result['provides'] = self.provides + # author = {} + # maintainer = {} + return result + + LEGACY_MAPPING = { + 'name': 'Name', + 'version': 'Version', + ('extensions', 'python.details', 'license'): 'License', + 'summary': 'Summary', + 'description': 'Description', + ('extensions', 'python.project', 'project_urls', 'Home'): 'Home-page', + ('extensions', 'python.project', 'contacts', 0, 'name'): 'Author', + ('extensions', 'python.project', 'contacts', 0, 'email'): 'Author-email', + 'source_url': 'Download-URL', + ('extensions', 'python.details', 'classifiers'): 'Classifier', + } + + def _to_legacy(self): + + def process_entries(entries): + reqts = set() + for e in entries: + extra = e.get('extra') + env = e.get('environment') + rlist = e['requires'] + for r in rlist: + if not env and not extra: + reqts.add(r) + else: + marker = '' + if extra: + marker = 'extra == "%s"' % extra + if env: + if marker: + marker = '(%s) and %s' % (env, marker) + else: + marker = env + reqts.add(';'.join((r, marker))) + return reqts + + assert self._data and not self._legacy + result = LegacyMetadata() + nmd = self._data + # import pdb; pdb.set_trace() + for nk, ok in self.LEGACY_MAPPING.items(): + if not isinstance(nk, tuple): + if nk in nmd: + result[ok] = nmd[nk] + else: + d = nmd + found = True + for k in nk: + try: + d = d[k] + except (KeyError, IndexError): + found = False + break + if found: + result[ok] = d + r1 = process_entries(self.run_requires + self.meta_requires) + r2 = process_entries(self.build_requires + self.dev_requires) + if self.extras: + result['Provides-Extra'] = sorted(self.extras) + result['Requires-Dist'] = sorted(r1) + result['Setup-Requires-Dist'] = sorted(r2) + # TODO: any other fields wanted + return result + + def write(self, path=None, fileobj=None, legacy=False, skip_unknown=True): + if [path, fileobj].count(None) != 1: + raise ValueError('Exactly one of path and fileobj is needed') + self.validate() + if legacy: + if self._legacy: + legacy_md = self._legacy + else: + legacy_md = self._to_legacy() + if path: + legacy_md.write(path, skip_unknown=skip_unknown) + else: + legacy_md.write_file(fileobj, skip_unknown=skip_unknown) + else: + if self._legacy: + d = self._from_legacy() + else: + d = self._data + if fileobj: + json.dump(d, fileobj, ensure_ascii=True, indent=2, sort_keys=True) + else: + with codecs.open(path, 'w', 'utf-8') as f: + json.dump(d, f, ensure_ascii=True, indent=2, sort_keys=True) + + def add_requirements(self, requirements): + if self._legacy: + self._legacy.add_requirements(requirements) + else: + run_requires = self._data.setdefault('run_requires', []) + always = None + for entry in run_requires: + if 'environment' not in entry and 'extra' not in entry: + always = entry + break + if always is None: + always = {'requires': requirements} + run_requires.insert(0, always) + else: + rset = set(always['requires']) | set(requirements) + always['requires'] = sorted(rset) + + def __repr__(self): + name = self.name or '(no name)' + version = self.version or 'no version' + return '<%s %s %s (%s)>' % (self.__class__.__name__, self.metadata_version, name, version) diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/resources.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/resources.py new file mode 100644 index 0000000..fef52aa --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/resources.py @@ -0,0 +1,358 @@ +# -*- coding: utf-8 -*- +# +# Copyright (C) 2013-2017 Vinay Sajip. +# Licensed to the Python Software Foundation under a contributor agreement. +# See LICENSE.txt and CONTRIBUTORS.txt. +# +from __future__ import unicode_literals + +import bisect +import io +import logging +import os +import pkgutil +import sys +import types +import zipimport + +from . import DistlibException +from .util import cached_property, get_cache_base, Cache + +logger = logging.getLogger(__name__) + + +cache = None # created when needed + + +class ResourceCache(Cache): + def __init__(self, base=None): + if base is None: + # Use native string to avoid issues on 2.x: see Python #20140. + base = os.path.join(get_cache_base(), str('resource-cache')) + super(ResourceCache, self).__init__(base) + + def is_stale(self, resource, path): + """ + Is the cache stale for the given resource? + + :param resource: The :class:`Resource` being cached. + :param path: The path of the resource in the cache. + :return: True if the cache is stale. + """ + # Cache invalidation is a hard problem :-) + return True + + def get(self, resource): + """ + Get a resource into the cache, + + :param resource: A :class:`Resource` instance. + :return: The pathname of the resource in the cache. + """ + prefix, path = resource.finder.get_cache_info(resource) + if prefix is None: + result = path + else: + result = os.path.join(self.base, self.prefix_to_dir(prefix), path) + dirname = os.path.dirname(result) + if not os.path.isdir(dirname): + os.makedirs(dirname) + if not os.path.exists(result): + stale = True + else: + stale = self.is_stale(resource, path) + if stale: + # write the bytes of the resource to the cache location + with open(result, 'wb') as f: + f.write(resource.bytes) + return result + + +class ResourceBase(object): + def __init__(self, finder, name): + self.finder = finder + self.name = name + + +class Resource(ResourceBase): + """ + A class representing an in-package resource, such as a data file. This is + not normally instantiated by user code, but rather by a + :class:`ResourceFinder` which manages the resource. + """ + is_container = False # Backwards compatibility + + def as_stream(self): + """ + Get the resource as a stream. + + This is not a property to make it obvious that it returns a new stream + each time. + """ + return self.finder.get_stream(self) + + @cached_property + def file_path(self): + global cache + if cache is None: + cache = ResourceCache() + return cache.get(self) + + @cached_property + def bytes(self): + return self.finder.get_bytes(self) + + @cached_property + def size(self): + return self.finder.get_size(self) + + +class ResourceContainer(ResourceBase): + is_container = True # Backwards compatibility + + @cached_property + def resources(self): + return self.finder.get_resources(self) + + +class ResourceFinder(object): + """ + Resource finder for file system resources. + """ + + if sys.platform.startswith('java'): + skipped_extensions = ('.pyc', '.pyo', '.class') + else: + skipped_extensions = ('.pyc', '.pyo') + + def __init__(self, module): + self.module = module + self.loader = getattr(module, '__loader__', None) + self.base = os.path.dirname(getattr(module, '__file__', '')) + + def _adjust_path(self, path): + return os.path.realpath(path) + + def _make_path(self, resource_name): + # Issue #50: need to preserve type of path on Python 2.x + # like os.path._get_sep + if isinstance(resource_name, bytes): # should only happen on 2.x + sep = b'/' + else: + sep = '/' + parts = resource_name.split(sep) + parts.insert(0, self.base) + result = os.path.join(*parts) + return self._adjust_path(result) + + def _find(self, path): + return os.path.exists(path) + + def get_cache_info(self, resource): + return None, resource.path + + def find(self, resource_name): + path = self._make_path(resource_name) + if not self._find(path): + result = None + else: + if self._is_directory(path): + result = ResourceContainer(self, resource_name) + else: + result = Resource(self, resource_name) + result.path = path + return result + + def get_stream(self, resource): + return open(resource.path, 'rb') + + def get_bytes(self, resource): + with open(resource.path, 'rb') as f: + return f.read() + + def get_size(self, resource): + return os.path.getsize(resource.path) + + def get_resources(self, resource): + def allowed(f): + return (f != '__pycache__' and not + f.endswith(self.skipped_extensions)) + return set([f for f in os.listdir(resource.path) if allowed(f)]) + + def is_container(self, resource): + return self._is_directory(resource.path) + + _is_directory = staticmethod(os.path.isdir) + + def iterator(self, resource_name): + resource = self.find(resource_name) + if resource is not None: + todo = [resource] + while todo: + resource = todo.pop(0) + yield resource + if resource.is_container: + rname = resource.name + for name in resource.resources: + if not rname: + new_name = name + else: + new_name = '/'.join([rname, name]) + child = self.find(new_name) + if child.is_container: + todo.append(child) + else: + yield child + + +class ZipResourceFinder(ResourceFinder): + """ + Resource finder for resources in .zip files. + """ + def __init__(self, module): + super(ZipResourceFinder, self).__init__(module) + archive = self.loader.archive + self.prefix_len = 1 + len(archive) + # PyPy doesn't have a _files attr on zipimporter, and you can't set one + if hasattr(self.loader, '_files'): + self._files = self.loader._files + else: + self._files = zipimport._zip_directory_cache[archive] + self.index = sorted(self._files) + + def _adjust_path(self, path): + return path + + def _find(self, path): + path = path[self.prefix_len:] + if path in self._files: + result = True + else: + if path and path[-1] != os.sep: + path = path + os.sep + i = bisect.bisect(self.index, path) + try: + result = self.index[i].startswith(path) + except IndexError: + result = False + if not result: + logger.debug('_find failed: %r %r', path, self.loader.prefix) + else: + logger.debug('_find worked: %r %r', path, self.loader.prefix) + return result + + def get_cache_info(self, resource): + prefix = self.loader.archive + path = resource.path[1 + len(prefix):] + return prefix, path + + def get_bytes(self, resource): + return self.loader.get_data(resource.path) + + def get_stream(self, resource): + return io.BytesIO(self.get_bytes(resource)) + + def get_size(self, resource): + path = resource.path[self.prefix_len:] + return self._files[path][3] + + def get_resources(self, resource): + path = resource.path[self.prefix_len:] + if path and path[-1] != os.sep: + path += os.sep + plen = len(path) + result = set() + i = bisect.bisect(self.index, path) + while i < len(self.index): + if not self.index[i].startswith(path): + break + s = self.index[i][plen:] + result.add(s.split(os.sep, 1)[0]) # only immediate children + i += 1 + return result + + def _is_directory(self, path): + path = path[self.prefix_len:] + if path and path[-1] != os.sep: + path += os.sep + i = bisect.bisect(self.index, path) + try: + result = self.index[i].startswith(path) + except IndexError: + result = False + return result + + +_finder_registry = { + type(None): ResourceFinder, + zipimport.zipimporter: ZipResourceFinder +} + +try: + # In Python 3.6, _frozen_importlib -> _frozen_importlib_external + try: + import _frozen_importlib_external as _fi + except ImportError: + import _frozen_importlib as _fi + _finder_registry[_fi.SourceFileLoader] = ResourceFinder + _finder_registry[_fi.FileFinder] = ResourceFinder + # See issue #146 + _finder_registry[_fi.SourcelessFileLoader] = ResourceFinder + del _fi +except (ImportError, AttributeError): + pass + + +def register_finder(loader, finder_maker): + _finder_registry[type(loader)] = finder_maker + + +_finder_cache = {} + + +def finder(package): + """ + Return a resource finder for a package. + :param package: The name of the package. + :return: A :class:`ResourceFinder` instance for the package. + """ + if package in _finder_cache: + result = _finder_cache[package] + else: + if package not in sys.modules: + __import__(package) + module = sys.modules[package] + path = getattr(module, '__path__', None) + if path is None: + raise DistlibException('You cannot get a finder for a module, ' + 'only for a package') + loader = getattr(module, '__loader__', None) + finder_maker = _finder_registry.get(type(loader)) + if finder_maker is None: + raise DistlibException('Unable to locate finder for %r' % package) + result = finder_maker(module) + _finder_cache[package] = result + return result + + +_dummy_module = types.ModuleType(str('__dummy__')) + + +def finder_for_path(path): + """ + Return a resource finder for a path, which should represent a container. + + :param path: The path. + :return: A :class:`ResourceFinder` instance for the path. + """ + result = None + # calls any path hooks, gets importer into cache + pkgutil.get_importer(path) + loader = sys.path_importer_cache.get(path) + finder = _finder_registry.get(type(loader)) + if finder: + module = _dummy_module + module.__file__ = os.path.join(path, '') + module.__loader__ = loader + result = finder(module) + return result diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/scripts.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/scripts.py new file mode 100644 index 0000000..b1fc705 --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/scripts.py @@ -0,0 +1,447 @@ +# -*- coding: utf-8 -*- +# +# Copyright (C) 2013-2023 Vinay Sajip. +# Licensed to the Python Software Foundation under a contributor agreement. +# See LICENSE.txt and CONTRIBUTORS.txt. +# +from io import BytesIO +import logging +import os +import re +import struct +import sys +import time +from zipfile import ZipInfo + +from .compat import sysconfig, detect_encoding, ZipFile +from .resources import finder +from .util import (FileOperator, get_export_entry, convert_path, get_executable, get_platform, in_venv) + +logger = logging.getLogger(__name__) + +_DEFAULT_MANIFEST = ''' + + + + + + + + + + + + +'''.strip() + +# check if Python is called on the first line with this expression +FIRST_LINE_RE = re.compile(b'^#!.*pythonw?[0-9.]*([ \t].*)?$') +SCRIPT_TEMPLATE = r'''# -*- coding: utf-8 -*- +import re +import sys +from %(module)s import %(import_name)s +if __name__ == '__main__': + sys.argv[0] = re.sub(r'(-script\.pyw|\.exe)?$', '', sys.argv[0]) + sys.exit(%(func)s()) +''' + +# Pre-fetch the contents of all executable wrapper stubs. +# This is to address https://github.com/pypa/pip/issues/12666. +# When updating pip, we rename the old pip in place before installing the +# new version. If we try to fetch a wrapper *after* that rename, the finder +# machinery will be confused as the package is no longer available at the +# location where it was imported from. So we load everything into memory in +# advance. + +if os.name == 'nt' or (os.name == 'java' and os._name == 'nt'): + # Issue 31: don't hardcode an absolute package name, but + # determine it relative to the current package + DISTLIB_PACKAGE = __name__.rsplit('.', 1)[0] + + WRAPPERS = { + r.name: r.bytes + for r in finder(DISTLIB_PACKAGE).iterator("") + if r.name.endswith(".exe") + } + + +def enquote_executable(executable): + if ' ' in executable: + # make sure we quote only the executable in case of env + # for example /usr/bin/env "/dir with spaces/bin/jython" + # instead of "/usr/bin/env /dir with spaces/bin/jython" + # otherwise whole + if executable.startswith('/usr/bin/env '): + env, _executable = executable.split(' ', 1) + if ' ' in _executable and not _executable.startswith('"'): + executable = '%s "%s"' % (env, _executable) + else: + if not executable.startswith('"'): + executable = '"%s"' % executable + return executable + + +# Keep the old name around (for now), as there is at least one project using it! +_enquote_executable = enquote_executable + + +class ScriptMaker(object): + """ + A class to copy or create scripts from source scripts or callable + specifications. + """ + script_template = SCRIPT_TEMPLATE + + executable = None # for shebangs + + def __init__(self, source_dir, target_dir, add_launchers=True, dry_run=False, fileop=None): + self.source_dir = source_dir + self.target_dir = target_dir + self.add_launchers = add_launchers + self.force = False + self.clobber = False + # It only makes sense to set mode bits on POSIX. + self.set_mode = (os.name == 'posix') or (os.name == 'java' and os._name == 'posix') + self.variants = set(('', 'X.Y')) + self._fileop = fileop or FileOperator(dry_run) + + self._is_nt = os.name == 'nt' or (os.name == 'java' and os._name == 'nt') + self.version_info = sys.version_info + + def _get_alternate_executable(self, executable, options): + if options.get('gui', False) and self._is_nt: # pragma: no cover + dn, fn = os.path.split(executable) + fn = fn.replace('python', 'pythonw') + executable = os.path.join(dn, fn) + return executable + + if sys.platform.startswith('java'): # pragma: no cover + + def _is_shell(self, executable): + """ + Determine if the specified executable is a script + (contains a #! line) + """ + try: + with open(executable) as fp: + return fp.read(2) == '#!' + except (OSError, IOError): + logger.warning('Failed to open %s', executable) + return False + + def _fix_jython_executable(self, executable): + if self._is_shell(executable): + # Workaround for Jython is not needed on Linux systems. + import java + + if java.lang.System.getProperty('os.name') == 'Linux': + return executable + elif executable.lower().endswith('jython.exe'): + # Use wrapper exe for Jython on Windows + return executable + return '/usr/bin/env %s' % executable + + def _build_shebang(self, executable, post_interp): + """ + Build a shebang line. In the simple case (on Windows, or a shebang line + which is not too long or contains spaces) use a simple formulation for + the shebang. Otherwise, use /bin/sh as the executable, with a contrived + shebang which allows the script to run either under Python or sh, using + suitable quoting. Thanks to Harald Nordgren for his input. + + See also: http://www.in-ulm.de/~mascheck/various/shebang/#length + https://hg.mozilla.org/mozilla-central/file/tip/mach + """ + if os.name != 'posix': + simple_shebang = True + elif getattr(sys, "cross_compiling", False): + # In a cross-compiling environment, the shebang will likely be a + # script; this *must* be invoked with the "safe" version of the + # shebang, or else using os.exec() to run the entry script will + # fail, raising "OSError 8 [Errno 8] Exec format error". + simple_shebang = False + else: + # Add 3 for '#!' prefix and newline suffix. + shebang_length = len(executable) + len(post_interp) + 3 + if sys.platform == 'darwin': + max_shebang_length = 512 + else: + max_shebang_length = 127 + simple_shebang = ((b' ' not in executable) and (shebang_length <= max_shebang_length)) + + if simple_shebang: + result = b'#!' + executable + post_interp + b'\n' + else: + result = b'#!/bin/sh\n' + result += b"'''exec' " + executable + post_interp + b' "$0" "$@"\n' + result += b"' '''\n" + return result + + def _get_shebang(self, encoding, post_interp=b'', options=None): + enquote = True + if self.executable: + executable = self.executable + enquote = False # assume this will be taken care of + elif not sysconfig.is_python_build(): + executable = get_executable() + elif in_venv(): # pragma: no cover + executable = os.path.join(sysconfig.get_path('scripts'), 'python%s' % sysconfig.get_config_var('EXE')) + else: # pragma: no cover + if os.name == 'nt': + # for Python builds from source on Windows, no Python executables with + # a version suffix are created, so we use python.exe + executable = os.path.join(sysconfig.get_config_var('BINDIR'), + 'python%s' % (sysconfig.get_config_var('EXE'))) + else: + executable = os.path.join( + sysconfig.get_config_var('BINDIR'), + 'python%s%s' % (sysconfig.get_config_var('VERSION'), sysconfig.get_config_var('EXE'))) + if options: + executable = self._get_alternate_executable(executable, options) + + if sys.platform.startswith('java'): # pragma: no cover + executable = self._fix_jython_executable(executable) + + # Normalise case for Windows - COMMENTED OUT + # executable = os.path.normcase(executable) + # N.B. The normalising operation above has been commented out: See + # issue #124. Although paths in Windows are generally case-insensitive, + # they aren't always. For example, a path containing a ẞ (which is a + # LATIN CAPITAL LETTER SHARP S - U+1E9E) is normcased to ß (which is a + # LATIN SMALL LETTER SHARP S' - U+00DF). The two are not considered by + # Windows as equivalent in path names. + + # If the user didn't specify an executable, it may be necessary to + # cater for executable paths with spaces (not uncommon on Windows) + if enquote: + executable = enquote_executable(executable) + # Issue #51: don't use fsencode, since we later try to + # check that the shebang is decodable using utf-8. + executable = executable.encode('utf-8') + # in case of IronPython, play safe and enable frames support + if (sys.platform == 'cli' and '-X:Frames' not in post_interp and + '-X:FullFrames' not in post_interp): # pragma: no cover + post_interp += b' -X:Frames' + shebang = self._build_shebang(executable, post_interp) + # Python parser starts to read a script using UTF-8 until + # it gets a #coding:xxx cookie. The shebang has to be the + # first line of a file, the #coding:xxx cookie cannot be + # written before. So the shebang has to be decodable from + # UTF-8. + try: + shebang.decode('utf-8') + except UnicodeDecodeError: # pragma: no cover + raise ValueError('The shebang (%r) is not decodable from utf-8' % shebang) + # If the script is encoded to a custom encoding (use a + # #coding:xxx cookie), the shebang has to be decodable from + # the script encoding too. + if encoding != 'utf-8': + try: + shebang.decode(encoding) + except UnicodeDecodeError: # pragma: no cover + raise ValueError('The shebang (%r) is not decodable ' + 'from the script encoding (%r)' % (shebang, encoding)) + return shebang + + def _get_script_text(self, entry): + return self.script_template % dict( + module=entry.prefix, import_name=entry.suffix.split('.')[0], func=entry.suffix) + + manifest = _DEFAULT_MANIFEST + + def get_manifest(self, exename): + base = os.path.basename(exename) + return self.manifest % base + + def _write_script(self, names, shebang, script_bytes, filenames, ext): + use_launcher = self.add_launchers and self._is_nt + if not use_launcher: + script_bytes = shebang + script_bytes + else: # pragma: no cover + if ext == 'py': + launcher = self._get_launcher('t') + else: + launcher = self._get_launcher('w') + stream = BytesIO() + with ZipFile(stream, 'w') as zf: + source_date_epoch = os.environ.get('SOURCE_DATE_EPOCH') + if source_date_epoch: + date_time = time.gmtime(int(source_date_epoch))[:6] + zinfo = ZipInfo(filename='__main__.py', date_time=date_time) + zf.writestr(zinfo, script_bytes) + else: + zf.writestr('__main__.py', script_bytes) + zip_data = stream.getvalue() + script_bytes = launcher + shebang + zip_data + for name in names: + outname = os.path.join(self.target_dir, name) + if use_launcher: # pragma: no cover + n, e = os.path.splitext(outname) + if e.startswith('.py'): + outname = n + outname = '%s.exe' % outname + try: + self._fileop.write_binary_file(outname, script_bytes) + except Exception: + # Failed writing an executable - it might be in use. + logger.warning('Failed to write executable - trying to ' + 'use .deleteme logic') + dfname = '%s.deleteme' % outname + if os.path.exists(dfname): + os.remove(dfname) # Not allowed to fail here + os.rename(outname, dfname) # nor here + self._fileop.write_binary_file(outname, script_bytes) + logger.debug('Able to replace executable using ' + '.deleteme logic') + try: + os.remove(dfname) + except Exception: + pass # still in use - ignore error + else: + if self._is_nt and not outname.endswith('.' + ext): # pragma: no cover + outname = '%s.%s' % (outname, ext) + if os.path.exists(outname) and not self.clobber: + logger.warning('Skipping existing file %s', outname) + continue + self._fileop.write_binary_file(outname, script_bytes) + if self.set_mode: + self._fileop.set_executable_mode([outname]) + filenames.append(outname) + + variant_separator = '-' + + def get_script_filenames(self, name): + result = set() + if '' in self.variants: + result.add(name) + if 'X' in self.variants: + result.add('%s%s' % (name, self.version_info[0])) + if 'X.Y' in self.variants: + result.add('%s%s%s.%s' % (name, self.variant_separator, self.version_info[0], self.version_info[1])) + return result + + def _make_script(self, entry, filenames, options=None): + post_interp = b'' + if options: + args = options.get('interpreter_args', []) + if args: + args = ' %s' % ' '.join(args) + post_interp = args.encode('utf-8') + shebang = self._get_shebang('utf-8', post_interp, options=options) + script = self._get_script_text(entry).encode('utf-8') + scriptnames = self.get_script_filenames(entry.name) + if options and options.get('gui', False): + ext = 'pyw' + else: + ext = 'py' + self._write_script(scriptnames, shebang, script, filenames, ext) + + def _copy_script(self, script, filenames): + adjust = False + script = os.path.join(self.source_dir, convert_path(script)) + outname = os.path.join(self.target_dir, os.path.basename(script)) + if not self.force and not self._fileop.newer(script, outname): + logger.debug('not copying %s (up-to-date)', script) + return + + # Always open the file, but ignore failures in dry-run mode -- + # that way, we'll get accurate feedback if we can read the + # script. + try: + f = open(script, 'rb') + except IOError: # pragma: no cover + if not self.dry_run: + raise + f = None + else: + first_line = f.readline() + if not first_line: # pragma: no cover + logger.warning('%s is an empty file (skipping)', script) + return + + match = FIRST_LINE_RE.match(first_line.replace(b'\r\n', b'\n')) + if match: + adjust = True + post_interp = match.group(1) or b'' + + if not adjust: + if f: + f.close() + self._fileop.copy_file(script, outname) + if self.set_mode: + self._fileop.set_executable_mode([outname]) + filenames.append(outname) + else: + logger.info('copying and adjusting %s -> %s', script, self.target_dir) + if not self._fileop.dry_run: + encoding, lines = detect_encoding(f.readline) + f.seek(0) + shebang = self._get_shebang(encoding, post_interp) + if b'pythonw' in first_line: # pragma: no cover + ext = 'pyw' + else: + ext = 'py' + n = os.path.basename(outname) + self._write_script([n], shebang, f.read(), filenames, ext) + if f: + f.close() + + @property + def dry_run(self): + return self._fileop.dry_run + + @dry_run.setter + def dry_run(self, value): + self._fileop.dry_run = value + + if os.name == 'nt' or (os.name == 'java' and os._name == 'nt'): # pragma: no cover + # Executable launcher support. + # Launchers are from https://bitbucket.org/vinay.sajip/simple_launcher/ + + def _get_launcher(self, kind): + if struct.calcsize('P') == 8: # 64-bit + bits = '64' + else: + bits = '32' + platform_suffix = '-arm' if get_platform() == 'win-arm64' else '' + name = '%s%s%s.exe' % (kind, bits, platform_suffix) + if name not in WRAPPERS: + msg = ('Unable to find resource %s in package %s' % + (name, DISTLIB_PACKAGE)) + raise ValueError(msg) + return WRAPPERS[name] + + # Public API follows + + def make(self, specification, options=None): + """ + Make a script. + + :param specification: The specification, which is either a valid export + entry specification (to make a script from a + callable) or a filename (to make a script by + copying from a source location). + :param options: A dictionary of options controlling script generation. + :return: A list of all absolute pathnames written to. + """ + filenames = [] + entry = get_export_entry(specification) + if entry is None: + self._copy_script(specification, filenames) + else: + self._make_script(entry, filenames, options=options) + return filenames + + def make_multiple(self, specifications, options=None): + """ + Take a list of specifications and make scripts from them, + :param specifications: A list of specifications. + :return: A list of all absolute pathnames written to, + """ + filenames = [] + for specification in specifications: + filenames.extend(self.make(specification, options)) + return filenames diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/t32.exe b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/t32.exe new file mode 100644 index 0000000..52154f0 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/t32.exe differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/t64-arm.exe b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/t64-arm.exe new file mode 100644 index 0000000..e1ab8f8 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/t64-arm.exe differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/t64.exe b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/t64.exe new file mode 100644 index 0000000..e8bebdb Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/t64.exe differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/util.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/util.py new file mode 100644 index 0000000..0d5bd7a --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/util.py @@ -0,0 +1,1984 @@ +# +# Copyright (C) 2012-2023 The Python Software Foundation. +# See LICENSE.txt and CONTRIBUTORS.txt. +# +import codecs +from collections import deque +import contextlib +import csv +from glob import iglob as std_iglob +import io +import json +import logging +import os +import py_compile +import re +import socket +try: + import ssl +except ImportError: # pragma: no cover + ssl = None +import subprocess +import sys +import tarfile +import tempfile +import textwrap + +try: + import threading +except ImportError: # pragma: no cover + import dummy_threading as threading +import time + +from . import DistlibException +from .compat import (string_types, text_type, shutil, raw_input, StringIO, cache_from_source, urlopen, urljoin, httplib, + xmlrpclib, HTTPHandler, BaseConfigurator, valid_ident, Container, configparser, URLError, ZipFile, + fsdecode, unquote, urlparse) + +logger = logging.getLogger(__name__) + +# +# Requirement parsing code as per PEP 508 +# + +IDENTIFIER = re.compile(r'^([\w\.-]+)\s*') +VERSION_IDENTIFIER = re.compile(r'^([\w\.*+-]+)\s*') +COMPARE_OP = re.compile(r'^(<=?|>=?|={2,3}|[~!]=)\s*') +MARKER_OP = re.compile(r'^((<=?)|(>=?)|={2,3}|[~!]=|in|not\s+in)\s*') +OR = re.compile(r'^or\b\s*') +AND = re.compile(r'^and\b\s*') +NON_SPACE = re.compile(r'(\S+)\s*') +STRING_CHUNK = re.compile(r'([\s\w\.{}()*+#:;,/?!~`@$%^&=|<>\[\]-]+)') + + +def parse_marker(marker_string): + """ + Parse a marker string and return a dictionary containing a marker expression. + + The dictionary will contain keys "op", "lhs" and "rhs" for non-terminals in + the expression grammar, or strings. A string contained in quotes is to be + interpreted as a literal string, and a string not contained in quotes is a + variable (such as os_name). + """ + + def marker_var(remaining): + # either identifier, or literal string + m = IDENTIFIER.match(remaining) + if m: + result = m.groups()[0] + remaining = remaining[m.end():] + elif not remaining: + raise SyntaxError('unexpected end of input') + else: + q = remaining[0] + if q not in '\'"': + raise SyntaxError('invalid expression: %s' % remaining) + oq = '\'"'.replace(q, '') + remaining = remaining[1:] + parts = [q] + while remaining: + # either a string chunk, or oq, or q to terminate + if remaining[0] == q: + break + elif remaining[0] == oq: + parts.append(oq) + remaining = remaining[1:] + else: + m = STRING_CHUNK.match(remaining) + if not m: + raise SyntaxError('error in string literal: %s' % remaining) + parts.append(m.groups()[0]) + remaining = remaining[m.end():] + else: + s = ''.join(parts) + raise SyntaxError('unterminated string: %s' % s) + parts.append(q) + result = ''.join(parts) + remaining = remaining[1:].lstrip() # skip past closing quote + return result, remaining + + def marker_expr(remaining): + if remaining and remaining[0] == '(': + result, remaining = marker(remaining[1:].lstrip()) + if remaining[0] != ')': + raise SyntaxError('unterminated parenthesis: %s' % remaining) + remaining = remaining[1:].lstrip() + else: + lhs, remaining = marker_var(remaining) + while remaining: + m = MARKER_OP.match(remaining) + if not m: + break + op = m.groups()[0] + remaining = remaining[m.end():] + rhs, remaining = marker_var(remaining) + lhs = {'op': op, 'lhs': lhs, 'rhs': rhs} + result = lhs + return result, remaining + + def marker_and(remaining): + lhs, remaining = marker_expr(remaining) + while remaining: + m = AND.match(remaining) + if not m: + break + remaining = remaining[m.end():] + rhs, remaining = marker_expr(remaining) + lhs = {'op': 'and', 'lhs': lhs, 'rhs': rhs} + return lhs, remaining + + def marker(remaining): + lhs, remaining = marker_and(remaining) + while remaining: + m = OR.match(remaining) + if not m: + break + remaining = remaining[m.end():] + rhs, remaining = marker_and(remaining) + lhs = {'op': 'or', 'lhs': lhs, 'rhs': rhs} + return lhs, remaining + + return marker(marker_string) + + +def parse_requirement(req): + """ + Parse a requirement passed in as a string. Return a Container + whose attributes contain the various parts of the requirement. + """ + remaining = req.strip() + if not remaining or remaining.startswith('#'): + return None + m = IDENTIFIER.match(remaining) + if not m: + raise SyntaxError('name expected: %s' % remaining) + distname = m.groups()[0] + remaining = remaining[m.end():] + extras = mark_expr = versions = uri = None + if remaining and remaining[0] == '[': + i = remaining.find(']', 1) + if i < 0: + raise SyntaxError('unterminated extra: %s' % remaining) + s = remaining[1:i] + remaining = remaining[i + 1:].lstrip() + extras = [] + while s: + m = IDENTIFIER.match(s) + if not m: + raise SyntaxError('malformed extra: %s' % s) + extras.append(m.groups()[0]) + s = s[m.end():] + if not s: + break + if s[0] != ',': + raise SyntaxError('comma expected in extras: %s' % s) + s = s[1:].lstrip() + if not extras: + extras = None + if remaining: + if remaining[0] == '@': + # it's a URI + remaining = remaining[1:].lstrip() + m = NON_SPACE.match(remaining) + if not m: + raise SyntaxError('invalid URI: %s' % remaining) + uri = m.groups()[0] + t = urlparse(uri) + # there are issues with Python and URL parsing, so this test + # is a bit crude. See bpo-20271, bpo-23505. Python doesn't + # always parse invalid URLs correctly - it should raise + # exceptions for malformed URLs + if not (t.scheme and t.netloc): + raise SyntaxError('Invalid URL: %s' % uri) + remaining = remaining[m.end():].lstrip() + else: + + def get_versions(ver_remaining): + """ + Return a list of operator, version tuples if any are + specified, else None. + """ + m = COMPARE_OP.match(ver_remaining) + versions = None + if m: + versions = [] + while True: + op = m.groups()[0] + ver_remaining = ver_remaining[m.end():] + m = VERSION_IDENTIFIER.match(ver_remaining) + if not m: + raise SyntaxError('invalid version: %s' % ver_remaining) + v = m.groups()[0] + versions.append((op, v)) + ver_remaining = ver_remaining[m.end():] + if not ver_remaining or ver_remaining[0] != ',': + break + ver_remaining = ver_remaining[1:].lstrip() + # Some packages have a trailing comma which would break things + # See issue #148 + if not ver_remaining: + break + m = COMPARE_OP.match(ver_remaining) + if not m: + raise SyntaxError('invalid constraint: %s' % ver_remaining) + if not versions: + versions = None + return versions, ver_remaining + + if remaining[0] != '(': + versions, remaining = get_versions(remaining) + else: + i = remaining.find(')', 1) + if i < 0: + raise SyntaxError('unterminated parenthesis: %s' % remaining) + s = remaining[1:i] + remaining = remaining[i + 1:].lstrip() + # As a special diversion from PEP 508, allow a version number + # a.b.c in parentheses as a synonym for ~= a.b.c (because this + # is allowed in earlier PEPs) + if COMPARE_OP.match(s): + versions, _ = get_versions(s) + else: + m = VERSION_IDENTIFIER.match(s) + if not m: + raise SyntaxError('invalid constraint: %s' % s) + v = m.groups()[0] + s = s[m.end():].lstrip() + if s: + raise SyntaxError('invalid constraint: %s' % s) + versions = [('~=', v)] + + if remaining: + if remaining[0] != ';': + raise SyntaxError('invalid requirement: %s' % remaining) + remaining = remaining[1:].lstrip() + + mark_expr, remaining = parse_marker(remaining) + + if remaining and remaining[0] != '#': + raise SyntaxError('unexpected trailing data: %s' % remaining) + + if not versions: + rs = distname + else: + rs = '%s %s' % (distname, ', '.join(['%s %s' % con for con in versions])) + return Container(name=distname, extras=extras, constraints=versions, marker=mark_expr, url=uri, requirement=rs) + + +def get_resources_dests(resources_root, rules): + """Find destinations for resources files""" + + def get_rel_path(root, path): + # normalizes and returns a lstripped-/-separated path + root = root.replace(os.path.sep, '/') + path = path.replace(os.path.sep, '/') + assert path.startswith(root) + return path[len(root):].lstrip('/') + + destinations = {} + for base, suffix, dest in rules: + prefix = os.path.join(resources_root, base) + for abs_base in iglob(prefix): + abs_glob = os.path.join(abs_base, suffix) + for abs_path in iglob(abs_glob): + resource_file = get_rel_path(resources_root, abs_path) + if dest is None: # remove the entry if it was here + destinations.pop(resource_file, None) + else: + rel_path = get_rel_path(abs_base, abs_path) + rel_dest = dest.replace(os.path.sep, '/').rstrip('/') + destinations[resource_file] = rel_dest + '/' + rel_path + return destinations + + +def in_venv(): + if hasattr(sys, 'real_prefix'): + # virtualenv venvs + result = True + else: + # PEP 405 venvs + result = sys.prefix != getattr(sys, 'base_prefix', sys.prefix) + return result + + +def get_executable(): + # The __PYVENV_LAUNCHER__ dance is apparently no longer needed, as + # changes to the stub launcher mean that sys.executable always points + # to the stub on OS X + # if sys.platform == 'darwin' and ('__PYVENV_LAUNCHER__' + # in os.environ): + # result = os.environ['__PYVENV_LAUNCHER__'] + # else: + # result = sys.executable + # return result + # Avoid normcasing: see issue #143 + # result = os.path.normcase(sys.executable) + result = sys.executable + if not isinstance(result, text_type): + result = fsdecode(result) + return result + + +def proceed(prompt, allowed_chars, error_prompt=None, default=None): + p = prompt + while True: + s = raw_input(p) + p = prompt + if not s and default: + s = default + if s: + c = s[0].lower() + if c in allowed_chars: + break + if error_prompt: + p = '%c: %s\n%s' % (c, error_prompt, prompt) + return c + + +def extract_by_key(d, keys): + if isinstance(keys, string_types): + keys = keys.split() + result = {} + for key in keys: + if key in d: + result[key] = d[key] + return result + + +def read_exports(stream): + if sys.version_info[0] >= 3: + # needs to be a text stream + stream = codecs.getreader('utf-8')(stream) + # Try to load as JSON, falling back on legacy format + data = stream.read() + stream = StringIO(data) + try: + jdata = json.load(stream) + result = jdata['extensions']['python.exports']['exports'] + for group, entries in result.items(): + for k, v in entries.items(): + s = '%s = %s' % (k, v) + entry = get_export_entry(s) + assert entry is not None + entries[k] = entry + return result + except Exception: + stream.seek(0, 0) + + def read_stream(cp, stream): + if hasattr(cp, 'read_file'): + cp.read_file(stream) + else: + cp.readfp(stream) + + cp = configparser.ConfigParser() + try: + read_stream(cp, stream) + except configparser.MissingSectionHeaderError: + stream.close() + data = textwrap.dedent(data) + stream = StringIO(data) + read_stream(cp, stream) + + result = {} + for key in cp.sections(): + result[key] = entries = {} + for name, value in cp.items(key): + s = '%s = %s' % (name, value) + entry = get_export_entry(s) + assert entry is not None + # entry.dist = self + entries[name] = entry + return result + + +def write_exports(exports, stream): + if sys.version_info[0] >= 3: + # needs to be a text stream + stream = codecs.getwriter('utf-8')(stream) + cp = configparser.ConfigParser() + for k, v in exports.items(): + # TODO check k, v for valid values + cp.add_section(k) + for entry in v.values(): + if entry.suffix is None: + s = entry.prefix + else: + s = '%s:%s' % (entry.prefix, entry.suffix) + if entry.flags: + s = '%s [%s]' % (s, ', '.join(entry.flags)) + cp.set(k, entry.name, s) + cp.write(stream) + + +@contextlib.contextmanager +def tempdir(): + td = tempfile.mkdtemp() + try: + yield td + finally: + shutil.rmtree(td) + + +@contextlib.contextmanager +def chdir(d): + cwd = os.getcwd() + try: + os.chdir(d) + yield + finally: + os.chdir(cwd) + + +@contextlib.contextmanager +def socket_timeout(seconds=15): + cto = socket.getdefaulttimeout() + try: + socket.setdefaulttimeout(seconds) + yield + finally: + socket.setdefaulttimeout(cto) + + +class cached_property(object): + + def __init__(self, func): + self.func = func + # for attr in ('__name__', '__module__', '__doc__'): + # setattr(self, attr, getattr(func, attr, None)) + + def __get__(self, obj, cls=None): + if obj is None: + return self + value = self.func(obj) + object.__setattr__(obj, self.func.__name__, value) + # obj.__dict__[self.func.__name__] = value = self.func(obj) + return value + + +def convert_path(pathname): + """Return 'pathname' as a name that will work on the native filesystem. + + The path is split on '/' and put back together again using the current + directory separator. Needed because filenames in the setup script are + always supplied in Unix style, and have to be converted to the local + convention before we can actually use them in the filesystem. Raises + ValueError on non-Unix-ish systems if 'pathname' either starts or + ends with a slash. + """ + if os.sep == '/': + return pathname + if not pathname: + return pathname + if pathname[0] == '/': + raise ValueError("path '%s' cannot be absolute" % pathname) + if pathname[-1] == '/': + raise ValueError("path '%s' cannot end with '/'" % pathname) + + paths = pathname.split('/') + while os.curdir in paths: + paths.remove(os.curdir) + if not paths: + return os.curdir + return os.path.join(*paths) + + +class FileOperator(object): + + def __init__(self, dry_run=False): + self.dry_run = dry_run + self.ensured = set() + self._init_record() + + def _init_record(self): + self.record = False + self.files_written = set() + self.dirs_created = set() + + def record_as_written(self, path): + if self.record: + self.files_written.add(path) + + def newer(self, source, target): + """Tell if the target is newer than the source. + + Returns true if 'source' exists and is more recently modified than + 'target', or if 'source' exists and 'target' doesn't. + + Returns false if both exist and 'target' is the same age or younger + than 'source'. Raise PackagingFileError if 'source' does not exist. + + Note that this test is not very accurate: files created in the same + second will have the same "age". + """ + if not os.path.exists(source): + raise DistlibException("file '%r' does not exist" % os.path.abspath(source)) + if not os.path.exists(target): + return True + + return os.stat(source).st_mtime > os.stat(target).st_mtime + + def copy_file(self, infile, outfile, check=True): + """Copy a file respecting dry-run and force flags. + """ + self.ensure_dir(os.path.dirname(outfile)) + logger.info('Copying %s to %s', infile, outfile) + if not self.dry_run: + msg = None + if check: + if os.path.islink(outfile): + msg = '%s is a symlink' % outfile + elif os.path.exists(outfile) and not os.path.isfile(outfile): + msg = '%s is a non-regular file' % outfile + if msg: + raise ValueError(msg + ' which would be overwritten') + shutil.copyfile(infile, outfile) + self.record_as_written(outfile) + + def copy_stream(self, instream, outfile, encoding=None): + assert not os.path.isdir(outfile) + self.ensure_dir(os.path.dirname(outfile)) + logger.info('Copying stream %s to %s', instream, outfile) + if not self.dry_run: + if encoding is None: + outstream = open(outfile, 'wb') + else: + outstream = codecs.open(outfile, 'w', encoding=encoding) + try: + shutil.copyfileobj(instream, outstream) + finally: + outstream.close() + self.record_as_written(outfile) + + def write_binary_file(self, path, data): + self.ensure_dir(os.path.dirname(path)) + if not self.dry_run: + if os.path.exists(path): + os.remove(path) + with open(path, 'wb') as f: + f.write(data) + self.record_as_written(path) + + def write_text_file(self, path, data, encoding): + self.write_binary_file(path, data.encode(encoding)) + + def set_mode(self, bits, mask, files): + if os.name == 'posix' or (os.name == 'java' and os._name == 'posix'): + # Set the executable bits (owner, group, and world) on + # all the files specified. + for f in files: + if self.dry_run: + logger.info("changing mode of %s", f) + else: + mode = (os.stat(f).st_mode | bits) & mask + logger.info("changing mode of %s to %o", f, mode) + os.chmod(f, mode) + + set_executable_mode = lambda s, f: s.set_mode(0o555, 0o7777, f) + + def ensure_dir(self, path): + path = os.path.abspath(path) + if path not in self.ensured and not os.path.exists(path): + self.ensured.add(path) + d, f = os.path.split(path) + self.ensure_dir(d) + logger.info('Creating %s' % path) + if not self.dry_run: + os.mkdir(path) + if self.record: + self.dirs_created.add(path) + + def byte_compile(self, path, optimize=False, force=False, prefix=None, hashed_invalidation=False): + dpath = cache_from_source(path, not optimize) + logger.info('Byte-compiling %s to %s', path, dpath) + if not self.dry_run: + if force or self.newer(path, dpath): + if not prefix: + diagpath = None + else: + assert path.startswith(prefix) + diagpath = path[len(prefix):] + compile_kwargs = {} + if hashed_invalidation and hasattr(py_compile, 'PycInvalidationMode'): + if not isinstance(hashed_invalidation, py_compile.PycInvalidationMode): + hashed_invalidation = py_compile.PycInvalidationMode.CHECKED_HASH + compile_kwargs['invalidation_mode'] = hashed_invalidation + py_compile.compile(path, dpath, diagpath, True, **compile_kwargs) # raise error + self.record_as_written(dpath) + return dpath + + def ensure_removed(self, path): + if os.path.exists(path): + if os.path.isdir(path) and not os.path.islink(path): + logger.debug('Removing directory tree at %s', path) + if not self.dry_run: + shutil.rmtree(path) + if self.record: + if path in self.dirs_created: + self.dirs_created.remove(path) + else: + if os.path.islink(path): + s = 'link' + else: + s = 'file' + logger.debug('Removing %s %s', s, path) + if not self.dry_run: + os.remove(path) + if self.record: + if path in self.files_written: + self.files_written.remove(path) + + def is_writable(self, path): + result = False + while not result: + if os.path.exists(path): + result = os.access(path, os.W_OK) + break + parent = os.path.dirname(path) + if parent == path: + break + path = parent + return result + + def commit(self): + """ + Commit recorded changes, turn off recording, return + changes. + """ + assert self.record + result = self.files_written, self.dirs_created + self._init_record() + return result + + def rollback(self): + if not self.dry_run: + for f in list(self.files_written): + if os.path.exists(f): + os.remove(f) + # dirs should all be empty now, except perhaps for + # __pycache__ subdirs + # reverse so that subdirs appear before their parents + dirs = sorted(self.dirs_created, reverse=True) + for d in dirs: + flist = os.listdir(d) + if flist: + assert flist == ['__pycache__'] + sd = os.path.join(d, flist[0]) + os.rmdir(sd) + os.rmdir(d) # should fail if non-empty + self._init_record() + + +def resolve(module_name, dotted_path): + if module_name in sys.modules: + mod = sys.modules[module_name] + else: + mod = __import__(module_name) + if dotted_path is None: + result = mod + else: + parts = dotted_path.split('.') + result = getattr(mod, parts.pop(0)) + for p in parts: + result = getattr(result, p) + return result + + +class ExportEntry(object): + + def __init__(self, name, prefix, suffix, flags): + self.name = name + self.prefix = prefix + self.suffix = suffix + self.flags = flags + + @cached_property + def value(self): + return resolve(self.prefix, self.suffix) + + def __repr__(self): # pragma: no cover + return '' % (self.name, self.prefix, self.suffix, self.flags) + + def __eq__(self, other): + if not isinstance(other, ExportEntry): + result = False + else: + result = (self.name == other.name and self.prefix == other.prefix and self.suffix == other.suffix and + self.flags == other.flags) + return result + + __hash__ = object.__hash__ + + +ENTRY_RE = re.compile( + r'''(?P([^\[]\S*)) + \s*=\s*(?P(\w+)([:\.]\w+)*) + \s*(\[\s*(?P[\w-]+(=\w+)?(,\s*\w+(=\w+)?)*)\s*\])? + ''', re.VERBOSE) + + +def get_export_entry(specification): + m = ENTRY_RE.search(specification) + if not m: + result = None + if '[' in specification or ']' in specification: + raise DistlibException("Invalid specification " + "'%s'" % specification) + else: + d = m.groupdict() + name = d['name'] + path = d['callable'] + colons = path.count(':') + if colons == 0: + prefix, suffix = path, None + else: + if colons != 1: + raise DistlibException("Invalid specification " + "'%s'" % specification) + prefix, suffix = path.split(':') + flags = d['flags'] + if flags is None: + if '[' in specification or ']' in specification: + raise DistlibException("Invalid specification " + "'%s'" % specification) + flags = [] + else: + flags = [f.strip() for f in flags.split(',')] + result = ExportEntry(name, prefix, suffix, flags) + return result + + +def get_cache_base(suffix=None): + """ + Return the default base location for distlib caches. If the directory does + not exist, it is created. Use the suffix provided for the base directory, + and default to '.distlib' if it isn't provided. + + On Windows, if LOCALAPPDATA is defined in the environment, then it is + assumed to be a directory, and will be the parent directory of the result. + On POSIX, and on Windows if LOCALAPPDATA is not defined, the user's home + directory - using os.expanduser('~') - will be the parent directory of + the result. + + The result is just the directory '.distlib' in the parent directory as + determined above, or with the name specified with ``suffix``. + """ + if suffix is None: + suffix = '.distlib' + if os.name == 'nt' and 'LOCALAPPDATA' in os.environ: + result = os.path.expandvars('$localappdata') + else: + # Assume posix, or old Windows + result = os.path.expanduser('~') + # we use 'isdir' instead of 'exists', because we want to + # fail if there's a file with that name + if os.path.isdir(result): + usable = os.access(result, os.W_OK) + if not usable: + logger.warning('Directory exists but is not writable: %s', result) + else: + try: + os.makedirs(result) + usable = True + except OSError: + logger.warning('Unable to create %s', result, exc_info=True) + usable = False + if not usable: + result = tempfile.mkdtemp() + logger.warning('Default location unusable, using %s', result) + return os.path.join(result, suffix) + + +def path_to_cache_dir(path, use_abspath=True): + """ + Convert an absolute path to a directory name for use in a cache. + + The algorithm used is: + + #. On Windows, any ``':'`` in the drive is replaced with ``'---'``. + #. Any occurrence of ``os.sep`` is replaced with ``'--'``. + #. ``'.cache'`` is appended. + """ + d, p = os.path.splitdrive(os.path.abspath(path) if use_abspath else path) + if d: + d = d.replace(':', '---') + p = p.replace(os.sep, '--') + return d + p + '.cache' + + +def ensure_slash(s): + if not s.endswith('/'): + return s + '/' + return s + + +def parse_credentials(netloc): + username = password = None + if '@' in netloc: + prefix, netloc = netloc.rsplit('@', 1) + if ':' not in prefix: + username = prefix + else: + username, password = prefix.split(':', 1) + if username: + username = unquote(username) + if password: + password = unquote(password) + return username, password, netloc + + +def get_process_umask(): + result = os.umask(0o22) + os.umask(result) + return result + + +def is_string_sequence(seq): + result = True + i = None + for i, s in enumerate(seq): + if not isinstance(s, string_types): + result = False + break + assert i is not None + return result + + +PROJECT_NAME_AND_VERSION = re.compile('([a-z0-9_]+([.-][a-z_][a-z0-9_]*)*)-' + '([a-z0-9_.+-]+)', re.I) +PYTHON_VERSION = re.compile(r'-py(\d\.?\d?)') + + +def split_filename(filename, project_name=None): + """ + Extract name, version, python version from a filename (no extension) + + Return name, version, pyver or None + """ + result = None + pyver = None + filename = unquote(filename).replace(' ', '-') + m = PYTHON_VERSION.search(filename) + if m: + pyver = m.group(1) + filename = filename[:m.start()] + if project_name and len(filename) > len(project_name) + 1: + m = re.match(re.escape(project_name) + r'\b', filename) + if m: + n = m.end() + result = filename[:n], filename[n + 1:], pyver + if result is None: + m = PROJECT_NAME_AND_VERSION.match(filename) + if m: + result = m.group(1), m.group(3), pyver + return result + + +# Allow spaces in name because of legacy dists like "Twisted Core" +NAME_VERSION_RE = re.compile(r'(?P[\w .-]+)\s*' + r'\(\s*(?P[^\s)]+)\)$') + + +def parse_name_and_version(p): + """ + A utility method used to get name and version from a string. + + From e.g. a Provides-Dist value. + + :param p: A value in a form 'foo (1.0)' + :return: The name and version as a tuple. + """ + m = NAME_VERSION_RE.match(p) + if not m: + raise DistlibException('Ill-formed name/version string: \'%s\'' % p) + d = m.groupdict() + return d['name'].strip().lower(), d['ver'] + + +def get_extras(requested, available): + result = set() + requested = set(requested or []) + available = set(available or []) + if '*' in requested: + requested.remove('*') + result |= available + for r in requested: + if r == '-': + result.add(r) + elif r.startswith('-'): + unwanted = r[1:] + if unwanted not in available: + logger.warning('undeclared extra: %s' % unwanted) + if unwanted in result: + result.remove(unwanted) + else: + if r not in available: + logger.warning('undeclared extra: %s' % r) + result.add(r) + return result + + +# +# Extended metadata functionality +# + + +def _get_external_data(url): + result = {} + try: + # urlopen might fail if it runs into redirections, + # because of Python issue #13696. Fixed in locators + # using a custom redirect handler. + resp = urlopen(url) + headers = resp.info() + ct = headers.get('Content-Type') + if not ct.startswith('application/json'): + logger.debug('Unexpected response for JSON request: %s', ct) + else: + reader = codecs.getreader('utf-8')(resp) + # data = reader.read().decode('utf-8') + # result = json.loads(data) + result = json.load(reader) + except Exception as e: + logger.exception('Failed to get external data for %s: %s', url, e) + return result + + +_external_data_base_url = 'https://www.red-dove.com/pypi/projects/' + + +def get_project_data(name): + url = '%s/%s/project.json' % (name[0].upper(), name) + url = urljoin(_external_data_base_url, url) + result = _get_external_data(url) + return result + + +def get_package_data(name, version): + url = '%s/%s/package-%s.json' % (name[0].upper(), name, version) + url = urljoin(_external_data_base_url, url) + return _get_external_data(url) + + +class Cache(object): + """ + A class implementing a cache for resources that need to live in the file system + e.g. shared libraries. This class was moved from resources to here because it + could be used by other modules, e.g. the wheel module. + """ + + def __init__(self, base): + """ + Initialise an instance. + + :param base: The base directory where the cache should be located. + """ + # we use 'isdir' instead of 'exists', because we want to + # fail if there's a file with that name + if not os.path.isdir(base): # pragma: no cover + os.makedirs(base) + if (os.stat(base).st_mode & 0o77) != 0: + logger.warning('Directory \'%s\' is not private', base) + self.base = os.path.abspath(os.path.normpath(base)) + + def prefix_to_dir(self, prefix, use_abspath=True): + """ + Converts a resource prefix to a directory name in the cache. + """ + return path_to_cache_dir(prefix, use_abspath=use_abspath) + + def clear(self): + """ + Clear the cache. + """ + not_removed = [] + for fn in os.listdir(self.base): + fn = os.path.join(self.base, fn) + try: + if os.path.islink(fn) or os.path.isfile(fn): + os.remove(fn) + elif os.path.isdir(fn): + shutil.rmtree(fn) + except Exception: + not_removed.append(fn) + return not_removed + + +class EventMixin(object): + """ + A very simple publish/subscribe system. + """ + + def __init__(self): + self._subscribers = {} + + def add(self, event, subscriber, append=True): + """ + Add a subscriber for an event. + + :param event: The name of an event. + :param subscriber: The subscriber to be added (and called when the + event is published). + :param append: Whether to append or prepend the subscriber to an + existing subscriber list for the event. + """ + subs = self._subscribers + if event not in subs: + subs[event] = deque([subscriber]) + else: + sq = subs[event] + if append: + sq.append(subscriber) + else: + sq.appendleft(subscriber) + + def remove(self, event, subscriber): + """ + Remove a subscriber for an event. + + :param event: The name of an event. + :param subscriber: The subscriber to be removed. + """ + subs = self._subscribers + if event not in subs: + raise ValueError('No subscribers: %r' % event) + subs[event].remove(subscriber) + + def get_subscribers(self, event): + """ + Return an iterator for the subscribers for an event. + :param event: The event to return subscribers for. + """ + return iter(self._subscribers.get(event, ())) + + def publish(self, event, *args, **kwargs): + """ + Publish a event and return a list of values returned by its + subscribers. + + :param event: The event to publish. + :param args: The positional arguments to pass to the event's + subscribers. + :param kwargs: The keyword arguments to pass to the event's + subscribers. + """ + result = [] + for subscriber in self.get_subscribers(event): + try: + value = subscriber(event, *args, **kwargs) + except Exception: + logger.exception('Exception during event publication') + value = None + result.append(value) + logger.debug('publish %s: args = %s, kwargs = %s, result = %s', event, args, kwargs, result) + return result + + +# +# Simple sequencing +# +class Sequencer(object): + + def __init__(self): + self._preds = {} + self._succs = {} + self._nodes = set() # nodes with no preds/succs + + def add_node(self, node): + self._nodes.add(node) + + def remove_node(self, node, edges=False): + if node in self._nodes: + self._nodes.remove(node) + if edges: + for p in set(self._preds.get(node, ())): + self.remove(p, node) + for s in set(self._succs.get(node, ())): + self.remove(node, s) + # Remove empties + for k, v in list(self._preds.items()): + if not v: + del self._preds[k] + for k, v in list(self._succs.items()): + if not v: + del self._succs[k] + + def add(self, pred, succ): + assert pred != succ + self._preds.setdefault(succ, set()).add(pred) + self._succs.setdefault(pred, set()).add(succ) + + def remove(self, pred, succ): + assert pred != succ + try: + preds = self._preds[succ] + succs = self._succs[pred] + except KeyError: # pragma: no cover + raise ValueError('%r not a successor of anything' % succ) + try: + preds.remove(pred) + succs.remove(succ) + except KeyError: # pragma: no cover + raise ValueError('%r not a successor of %r' % (succ, pred)) + + def is_step(self, step): + return (step in self._preds or step in self._succs or step in self._nodes) + + def get_steps(self, final): + if not self.is_step(final): + raise ValueError('Unknown: %r' % final) + result = [] + todo = [] + seen = set() + todo.append(final) + while todo: + step = todo.pop(0) + if step in seen: + # if a step was already seen, + # move it to the end (so it will appear earlier + # when reversed on return) ... but not for the + # final step, as that would be confusing for + # users + if step != final: + result.remove(step) + result.append(step) + else: + seen.add(step) + result.append(step) + preds = self._preds.get(step, ()) + todo.extend(preds) + return reversed(result) + + @property + def strong_connections(self): + # http://en.wikipedia.org/wiki/Tarjan%27s_strongly_connected_components_algorithm + index_counter = [0] + stack = [] + lowlinks = {} + index = {} + result = [] + + graph = self._succs + + def strongconnect(node): + # set the depth index for this node to the smallest unused index + index[node] = index_counter[0] + lowlinks[node] = index_counter[0] + index_counter[0] += 1 + stack.append(node) + + # Consider successors + try: + successors = graph[node] + except Exception: + successors = [] + for successor in successors: + if successor not in lowlinks: + # Successor has not yet been visited + strongconnect(successor) + lowlinks[node] = min(lowlinks[node], lowlinks[successor]) + elif successor in stack: + # the successor is in the stack and hence in the current + # strongly connected component (SCC) + lowlinks[node] = min(lowlinks[node], index[successor]) + + # If `node` is a root node, pop the stack and generate an SCC + if lowlinks[node] == index[node]: + connected_component = [] + + while True: + successor = stack.pop() + connected_component.append(successor) + if successor == node: + break + component = tuple(connected_component) + # storing the result + result.append(component) + + for node in graph: + if node not in lowlinks: + strongconnect(node) + + return result + + @property + def dot(self): + result = ['digraph G {'] + for succ in self._preds: + preds = self._preds[succ] + for pred in preds: + result.append(' %s -> %s;' % (pred, succ)) + for node in self._nodes: + result.append(' %s;' % node) + result.append('}') + return '\n'.join(result) + + +# +# Unarchiving functionality for zip, tar, tgz, tbz, whl +# + +ARCHIVE_EXTENSIONS = ('.tar.gz', '.tar.bz2', '.tar', '.zip', '.tgz', '.tbz', '.whl') + + +def unarchive(archive_filename, dest_dir, format=None, check=True): + + def check_path(path): + if not isinstance(path, text_type): + path = path.decode('utf-8') + p = os.path.abspath(os.path.join(dest_dir, path)) + if not p.startswith(dest_dir) or p[plen] != os.sep: + raise ValueError('path outside destination: %r' % p) + + dest_dir = os.path.abspath(dest_dir) + plen = len(dest_dir) + archive = None + if format is None: + if archive_filename.endswith(('.zip', '.whl')): + format = 'zip' + elif archive_filename.endswith(('.tar.gz', '.tgz')): + format = 'tgz' + mode = 'r:gz' + elif archive_filename.endswith(('.tar.bz2', '.tbz')): + format = 'tbz' + mode = 'r:bz2' + elif archive_filename.endswith('.tar'): + format = 'tar' + mode = 'r' + else: # pragma: no cover + raise ValueError('Unknown format for %r' % archive_filename) + try: + if format == 'zip': + archive = ZipFile(archive_filename, 'r') + if check: + names = archive.namelist() + for name in names: + check_path(name) + else: + archive = tarfile.open(archive_filename, mode) + if check: + names = archive.getnames() + for name in names: + check_path(name) + if format != 'zip' and sys.version_info[0] < 3: + # See Python issue 17153. If the dest path contains Unicode, + # tarfile extraction fails on Python 2.x if a member path name + # contains non-ASCII characters - it leads to an implicit + # bytes -> unicode conversion using ASCII to decode. + for tarinfo in archive.getmembers(): + if not isinstance(tarinfo.name, text_type): + tarinfo.name = tarinfo.name.decode('utf-8') + + # Limit extraction of dangerous items, if this Python + # allows it easily. If not, just trust the input. + # See: https://docs.python.org/3/library/tarfile.html#extraction-filters + def extraction_filter(member, path): + """Run tarfile.tar_filter, but raise the expected ValueError""" + # This is only called if the current Python has tarfile filters + try: + return tarfile.tar_filter(member, path) + except tarfile.FilterError as exc: + raise ValueError(str(exc)) + + archive.extraction_filter = extraction_filter + + archive.extractall(dest_dir) + + finally: + if archive: + archive.close() + + +def zip_dir(directory): + """zip a directory tree into a BytesIO object""" + result = io.BytesIO() + dlen = len(directory) + with ZipFile(result, "w") as zf: + for root, dirs, files in os.walk(directory): + for name in files: + full = os.path.join(root, name) + rel = root[dlen:] + dest = os.path.join(rel, name) + zf.write(full, dest) + return result + + +# +# Simple progress bar +# + +UNITS = ('', 'K', 'M', 'G', 'T', 'P') + + +class Progress(object): + unknown = 'UNKNOWN' + + def __init__(self, minval=0, maxval=100): + assert maxval is None or maxval >= minval + self.min = self.cur = minval + self.max = maxval + self.started = None + self.elapsed = 0 + self.done = False + + def update(self, curval): + assert self.min <= curval + assert self.max is None or curval <= self.max + self.cur = curval + now = time.time() + if self.started is None: + self.started = now + else: + self.elapsed = now - self.started + + def increment(self, incr): + assert incr >= 0 + self.update(self.cur + incr) + + def start(self): + self.update(self.min) + return self + + def stop(self): + if self.max is not None: + self.update(self.max) + self.done = True + + @property + def maximum(self): + return self.unknown if self.max is None else self.max + + @property + def percentage(self): + if self.done: + result = '100 %' + elif self.max is None: + result = ' ?? %' + else: + v = 100.0 * (self.cur - self.min) / (self.max - self.min) + result = '%3d %%' % v + return result + + def format_duration(self, duration): + if (duration <= 0) and self.max is None or self.cur == self.min: + result = '??:??:??' + # elif duration < 1: + # result = '--:--:--' + else: + result = time.strftime('%H:%M:%S', time.gmtime(duration)) + return result + + @property + def ETA(self): + if self.done: + prefix = 'Done' + t = self.elapsed + # import pdb; pdb.set_trace() + else: + prefix = 'ETA ' + if self.max is None: + t = -1 + elif self.elapsed == 0 or (self.cur == self.min): + t = 0 + else: + # import pdb; pdb.set_trace() + t = float(self.max - self.min) + t /= self.cur - self.min + t = (t - 1) * self.elapsed + return '%s: %s' % (prefix, self.format_duration(t)) + + @property + def speed(self): + if self.elapsed == 0: + result = 0.0 + else: + result = (self.cur - self.min) / self.elapsed + for unit in UNITS: + if result < 1000: + break + result /= 1000.0 + return '%d %sB/s' % (result, unit) + + +# +# Glob functionality +# + +RICH_GLOB = re.compile(r'\{([^}]*)\}') +_CHECK_RECURSIVE_GLOB = re.compile(r'[^/\\,{]\*\*|\*\*[^/\\,}]') +_CHECK_MISMATCH_SET = re.compile(r'^[^{]*\}|\{[^}]*$') + + +def iglob(path_glob): + """Extended globbing function that supports ** and {opt1,opt2,opt3}.""" + if _CHECK_RECURSIVE_GLOB.search(path_glob): + msg = """invalid glob %r: recursive glob "**" must be used alone""" + raise ValueError(msg % path_glob) + if _CHECK_MISMATCH_SET.search(path_glob): + msg = """invalid glob %r: mismatching set marker '{' or '}'""" + raise ValueError(msg % path_glob) + return _iglob(path_glob) + + +def _iglob(path_glob): + rich_path_glob = RICH_GLOB.split(path_glob, 1) + if len(rich_path_glob) > 1: + assert len(rich_path_glob) == 3, rich_path_glob + prefix, set, suffix = rich_path_glob + for item in set.split(','): + for path in _iglob(''.join((prefix, item, suffix))): + yield path + else: + if '**' not in path_glob: + for item in std_iglob(path_glob): + yield item + else: + prefix, radical = path_glob.split('**', 1) + if prefix == '': + prefix = '.' + if radical == '': + radical = '*' + else: + # we support both + radical = radical.lstrip('/') + radical = radical.lstrip('\\') + for path, dir, files in os.walk(prefix): + path = os.path.normpath(path) + for fn in _iglob(os.path.join(path, radical)): + yield fn + + +if ssl: + from .compat import (HTTPSHandler as BaseHTTPSHandler, match_hostname, CertificateError) + + # + # HTTPSConnection which verifies certificates/matches domains + # + + class HTTPSConnection(httplib.HTTPSConnection): + ca_certs = None # set this to the path to the certs file (.pem) + check_domain = True # only used if ca_certs is not None + + # noinspection PyPropertyAccess + def connect(self): + sock = socket.create_connection((self.host, self.port), self.timeout) + if getattr(self, '_tunnel_host', False): + self.sock = sock + self._tunnel() + + context = ssl.SSLContext(ssl.PROTOCOL_SSLv23) + if hasattr(ssl, 'OP_NO_SSLv2'): + context.options |= ssl.OP_NO_SSLv2 + if getattr(self, 'cert_file', None): + context.load_cert_chain(self.cert_file, self.key_file) + kwargs = {} + if self.ca_certs: + context.verify_mode = ssl.CERT_REQUIRED + context.load_verify_locations(cafile=self.ca_certs) + if getattr(ssl, 'HAS_SNI', False): + kwargs['server_hostname'] = self.host + + self.sock = context.wrap_socket(sock, **kwargs) + if self.ca_certs and self.check_domain: + try: + match_hostname(self.sock.getpeercert(), self.host) + logger.debug('Host verified: %s', self.host) + except CertificateError: # pragma: no cover + self.sock.shutdown(socket.SHUT_RDWR) + self.sock.close() + raise + + class HTTPSHandler(BaseHTTPSHandler): + + def __init__(self, ca_certs, check_domain=True): + BaseHTTPSHandler.__init__(self) + self.ca_certs = ca_certs + self.check_domain = check_domain + + def _conn_maker(self, *args, **kwargs): + """ + This is called to create a connection instance. Normally you'd + pass a connection class to do_open, but it doesn't actually check for + a class, and just expects a callable. As long as we behave just as a + constructor would have, we should be OK. If it ever changes so that + we *must* pass a class, we'll create an UnsafeHTTPSConnection class + which just sets check_domain to False in the class definition, and + choose which one to pass to do_open. + """ + result = HTTPSConnection(*args, **kwargs) + if self.ca_certs: + result.ca_certs = self.ca_certs + result.check_domain = self.check_domain + return result + + def https_open(self, req): + try: + return self.do_open(self._conn_maker, req) + except URLError as e: + if 'certificate verify failed' in str(e.reason): + raise CertificateError('Unable to verify server certificate ' + 'for %s' % req.host) + else: + raise + + # + # To prevent against mixing HTTP traffic with HTTPS (examples: A Man-In-The- + # Middle proxy using HTTP listens on port 443, or an index mistakenly serves + # HTML containing a http://xyz link when it should be https://xyz), + # you can use the following handler class, which does not allow HTTP traffic. + # + # It works by inheriting from HTTPHandler - so build_opener won't add a + # handler for HTTP itself. + # + class HTTPSOnlyHandler(HTTPSHandler, HTTPHandler): + + def http_open(self, req): + raise URLError('Unexpected HTTP request on what should be a secure ' + 'connection: %s' % req) + + +# +# XML-RPC with timeouts +# +class Transport(xmlrpclib.Transport): + + def __init__(self, timeout, use_datetime=0): + self.timeout = timeout + xmlrpclib.Transport.__init__(self, use_datetime) + + def make_connection(self, host): + h, eh, x509 = self.get_host_info(host) + if not self._connection or host != self._connection[0]: + self._extra_headers = eh + self._connection = host, httplib.HTTPConnection(h) + return self._connection[1] + + +if ssl: + + class SafeTransport(xmlrpclib.SafeTransport): + + def __init__(self, timeout, use_datetime=0): + self.timeout = timeout + xmlrpclib.SafeTransport.__init__(self, use_datetime) + + def make_connection(self, host): + h, eh, kwargs = self.get_host_info(host) + if not kwargs: + kwargs = {} + kwargs['timeout'] = self.timeout + if not self._connection or host != self._connection[0]: + self._extra_headers = eh + self._connection = host, httplib.HTTPSConnection(h, None, **kwargs) + return self._connection[1] + + +class ServerProxy(xmlrpclib.ServerProxy): + + def __init__(self, uri, **kwargs): + self.timeout = timeout = kwargs.pop('timeout', None) + # The above classes only come into play if a timeout + # is specified + if timeout is not None: + # scheme = splittype(uri) # deprecated as of Python 3.8 + scheme = urlparse(uri)[0] + use_datetime = kwargs.get('use_datetime', 0) + if scheme == 'https': + tcls = SafeTransport + else: + tcls = Transport + kwargs['transport'] = t = tcls(timeout, use_datetime=use_datetime) + self.transport = t + xmlrpclib.ServerProxy.__init__(self, uri, **kwargs) + + +# +# CSV functionality. This is provided because on 2.x, the csv module can't +# handle Unicode. However, we need to deal with Unicode in e.g. RECORD files. +# + + +def _csv_open(fn, mode, **kwargs): + if sys.version_info[0] < 3: + mode += 'b' + else: + kwargs['newline'] = '' + # Python 3 determines encoding from locale. Force 'utf-8' + # file encoding to match other forced utf-8 encoding + kwargs['encoding'] = 'utf-8' + return open(fn, mode, **kwargs) + + +class CSVBase(object): + defaults = { + 'delimiter': str(','), # The strs are used because we need native + 'quotechar': str('"'), # str in the csv API (2.x won't take + 'lineterminator': str('\n') # Unicode) + } + + def __enter__(self): + return self + + def __exit__(self, *exc_info): + self.stream.close() + + +class CSVReader(CSVBase): + + def __init__(self, **kwargs): + if 'stream' in kwargs: + stream = kwargs['stream'] + if sys.version_info[0] >= 3: + # needs to be a text stream + stream = codecs.getreader('utf-8')(stream) + self.stream = stream + else: + self.stream = _csv_open(kwargs['path'], 'r') + self.reader = csv.reader(self.stream, **self.defaults) + + def __iter__(self): + return self + + def next(self): + result = next(self.reader) + if sys.version_info[0] < 3: + for i, item in enumerate(result): + if not isinstance(item, text_type): + result[i] = item.decode('utf-8') + return result + + __next__ = next + + +class CSVWriter(CSVBase): + + def __init__(self, fn, **kwargs): + self.stream = _csv_open(fn, 'w') + self.writer = csv.writer(self.stream, **self.defaults) + + def writerow(self, row): + if sys.version_info[0] < 3: + r = [] + for item in row: + if isinstance(item, text_type): + item = item.encode('utf-8') + r.append(item) + row = r + self.writer.writerow(row) + + +# +# Configurator functionality +# + + +class Configurator(BaseConfigurator): + + value_converters = dict(BaseConfigurator.value_converters) + value_converters['inc'] = 'inc_convert' + + def __init__(self, config, base=None): + super(Configurator, self).__init__(config) + self.base = base or os.getcwd() + + def configure_custom(self, config): + + def convert(o): + if isinstance(o, (list, tuple)): + result = type(o)([convert(i) for i in o]) + elif isinstance(o, dict): + if '()' in o: + result = self.configure_custom(o) + else: + result = {} + for k in o: + result[k] = convert(o[k]) + else: + result = self.convert(o) + return result + + c = config.pop('()') + if not callable(c): + c = self.resolve(c) + props = config.pop('.', None) + # Check for valid identifiers + args = config.pop('[]', ()) + if args: + args = tuple([convert(o) for o in args]) + items = [(k, convert(config[k])) for k in config if valid_ident(k)] + kwargs = dict(items) + result = c(*args, **kwargs) + if props: + for n, v in props.items(): + setattr(result, n, convert(v)) + return result + + def __getitem__(self, key): + result = self.config[key] + if isinstance(result, dict) and '()' in result: + self.config[key] = result = self.configure_custom(result) + return result + + def inc_convert(self, value): + """Default converter for the inc:// protocol.""" + if not os.path.isabs(value): + value = os.path.join(self.base, value) + with codecs.open(value, 'r', encoding='utf-8') as f: + result = json.load(f) + return result + + +class SubprocessMixin(object): + """ + Mixin for running subprocesses and capturing their output + """ + + def __init__(self, verbose=False, progress=None): + self.verbose = verbose + self.progress = progress + + def reader(self, stream, context): + """ + Read lines from a subprocess' output stream and either pass to a progress + callable (if specified) or write progress information to sys.stderr. + """ + progress = self.progress + verbose = self.verbose + while True: + s = stream.readline() + if not s: + break + if progress is not None: + progress(s, context) + else: + if not verbose: + sys.stderr.write('.') + else: + sys.stderr.write(s.decode('utf-8')) + sys.stderr.flush() + stream.close() + + def run_command(self, cmd, **kwargs): + p = subprocess.Popen(cmd, stdout=subprocess.PIPE, stderr=subprocess.PIPE, **kwargs) + t1 = threading.Thread(target=self.reader, args=(p.stdout, 'stdout')) + t1.start() + t2 = threading.Thread(target=self.reader, args=(p.stderr, 'stderr')) + t2.start() + p.wait() + t1.join() + t2.join() + if self.progress is not None: + self.progress('done.', 'main') + elif self.verbose: + sys.stderr.write('done.\n') + return p + + +def normalize_name(name): + """Normalize a python package name a la PEP 503""" + # https://www.python.org/dev/peps/pep-0503/#normalized-names + return re.sub('[-_.]+', '-', name).lower() + + +# def _get_pypirc_command(): +# """ +# Get the distutils command for interacting with PyPI configurations. +# :return: the command. +# """ +# from distutils.core import Distribution +# from distutils.config import PyPIRCCommand +# d = Distribution() +# return PyPIRCCommand(d) + + +class PyPIRCFile(object): + + DEFAULT_REPOSITORY = 'https://upload.pypi.org/legacy/' + DEFAULT_REALM = 'pypi' + + def __init__(self, fn=None, url=None): + if fn is None: + fn = os.path.join(os.path.expanduser('~'), '.pypirc') + self.filename = fn + self.url = url + + def read(self): + result = {} + + if os.path.exists(self.filename): + repository = self.url or self.DEFAULT_REPOSITORY + + config = configparser.RawConfigParser() + config.read(self.filename) + sections = config.sections() + if 'distutils' in sections: + # let's get the list of servers + index_servers = config.get('distutils', 'index-servers') + _servers = [server.strip() for server in index_servers.split('\n') if server.strip() != ''] + if _servers == []: + # nothing set, let's try to get the default pypi + if 'pypi' in sections: + _servers = ['pypi'] + else: + for server in _servers: + result = {'server': server} + result['username'] = config.get(server, 'username') + + # optional params + for key, default in (('repository', self.DEFAULT_REPOSITORY), ('realm', self.DEFAULT_REALM), + ('password', None)): + if config.has_option(server, key): + result[key] = config.get(server, key) + else: + result[key] = default + + # work around people having "repository" for the "pypi" + # section of their config set to the HTTP (rather than + # HTTPS) URL + if (server == 'pypi' and repository in (self.DEFAULT_REPOSITORY, 'pypi')): + result['repository'] = self.DEFAULT_REPOSITORY + elif (result['server'] != repository and result['repository'] != repository): + result = {} + elif 'server-login' in sections: + # old format + server = 'server-login' + if config.has_option(server, 'repository'): + repository = config.get(server, 'repository') + else: + repository = self.DEFAULT_REPOSITORY + result = { + 'username': config.get(server, 'username'), + 'password': config.get(server, 'password'), + 'repository': repository, + 'server': server, + 'realm': self.DEFAULT_REALM + } + return result + + def update(self, username, password): + # import pdb; pdb.set_trace() + config = configparser.RawConfigParser() + fn = self.filename + config.read(fn) + if not config.has_section('pypi'): + config.add_section('pypi') + config.set('pypi', 'username', username) + config.set('pypi', 'password', password) + with open(fn, 'w') as f: + config.write(f) + + +def _load_pypirc(index): + """ + Read the PyPI access configuration as supported by distutils. + """ + return PyPIRCFile(url=index.url).read() + + +def _store_pypirc(index): + PyPIRCFile().update(index.username, index.password) + + +# +# get_platform()/get_host_platform() copied from Python 3.10.a0 source, with some minor +# tweaks +# + + +def get_host_platform(): + """Return a string that identifies the current platform. This is used mainly to + distinguish platform-specific build directories and platform-specific built + distributions. Typically includes the OS name and version and the + architecture (as supplied by 'os.uname()'), although the exact information + included depends on the OS; eg. on Linux, the kernel version isn't + particularly important. + + Examples of returned values: + linux-i586 + linux-alpha (?) + solaris-2.6-sun4u + + Windows will return one of: + win-amd64 (64bit Windows on AMD64 (aka x86_64, Intel64, EM64T, etc) + win32 (all others - specifically, sys.platform is returned) + + For other non-POSIX platforms, currently just returns 'sys.platform'. + + """ + if os.name == 'nt': + if 'amd64' in sys.version.lower(): + return 'win-amd64' + if '(arm)' in sys.version.lower(): + return 'win-arm32' + if '(arm64)' in sys.version.lower(): + return 'win-arm64' + return sys.platform + + # Set for cross builds explicitly + if "_PYTHON_HOST_PLATFORM" in os.environ: + return os.environ["_PYTHON_HOST_PLATFORM"] + + if os.name != 'posix' or not hasattr(os, 'uname'): + # XXX what about the architecture? NT is Intel or Alpha, + # Mac OS is M68k or PPC, etc. + return sys.platform + + # Try to distinguish various flavours of Unix + + (osname, host, release, version, machine) = os.uname() + + # Convert the OS name to lowercase, remove '/' characters, and translate + # spaces (for "Power Macintosh") + osname = osname.lower().replace('/', '') + machine = machine.replace(' ', '_').replace('/', '-') + + if osname[:5] == 'linux': + # At least on Linux/Intel, 'machine' is the processor -- + # i386, etc. + # XXX what about Alpha, SPARC, etc? + return "%s-%s" % (osname, machine) + + elif osname[:5] == 'sunos': + if release[0] >= '5': # SunOS 5 == Solaris 2 + osname = 'solaris' + release = '%d.%s' % (int(release[0]) - 3, release[2:]) + # We can't use 'platform.architecture()[0]' because a + # bootstrap problem. We use a dict to get an error + # if some suspicious happens. + bitness = {2147483647: '32bit', 9223372036854775807: '64bit'} + machine += '.%s' % bitness[sys.maxsize] + # fall through to standard osname-release-machine representation + elif osname[:3] == 'aix': + from _aix_support import aix_platform + return aix_platform() + elif osname[:6] == 'cygwin': + osname = 'cygwin' + rel_re = re.compile(r'[\d.]+', re.ASCII) + m = rel_re.match(release) + if m: + release = m.group() + elif osname[:6] == 'darwin': + import _osx_support + try: + from distutils import sysconfig + except ImportError: + import sysconfig + osname, release, machine = _osx_support.get_platform_osx(sysconfig.get_config_vars(), osname, release, machine) + + return '%s-%s-%s' % (osname, release, machine) + + +_TARGET_TO_PLAT = { + 'x86': 'win32', + 'x64': 'win-amd64', + 'arm': 'win-arm32', +} + + +def get_platform(): + if os.name != 'nt': + return get_host_platform() + cross_compilation_target = os.environ.get('VSCMD_ARG_TGT_ARCH') + if cross_compilation_target not in _TARGET_TO_PLAT: + return get_host_platform() + return _TARGET_TO_PLAT[cross_compilation_target] diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/version.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/version.py new file mode 100644 index 0000000..d70a96e --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/version.py @@ -0,0 +1,750 @@ +# -*- coding: utf-8 -*- +# +# Copyright (C) 2012-2023 The Python Software Foundation. +# See LICENSE.txt and CONTRIBUTORS.txt. +# +""" +Implementation of a flexible versioning scheme providing support for PEP-440, +setuptools-compatible and semantic versioning. +""" + +import logging +import re + +from .compat import string_types +from .util import parse_requirement + +__all__ = ['NormalizedVersion', 'NormalizedMatcher', + 'LegacyVersion', 'LegacyMatcher', + 'SemanticVersion', 'SemanticMatcher', + 'UnsupportedVersionError', 'get_scheme'] + +logger = logging.getLogger(__name__) + + +class UnsupportedVersionError(ValueError): + """This is an unsupported version.""" + pass + + +class Version(object): + def __init__(self, s): + self._string = s = s.strip() + self._parts = parts = self.parse(s) + assert isinstance(parts, tuple) + assert len(parts) > 0 + + def parse(self, s): + raise NotImplementedError('please implement in a subclass') + + def _check_compatible(self, other): + if type(self) != type(other): + raise TypeError('cannot compare %r and %r' % (self, other)) + + def __eq__(self, other): + self._check_compatible(other) + return self._parts == other._parts + + def __ne__(self, other): + return not self.__eq__(other) + + def __lt__(self, other): + self._check_compatible(other) + return self._parts < other._parts + + def __gt__(self, other): + return not (self.__lt__(other) or self.__eq__(other)) + + def __le__(self, other): + return self.__lt__(other) or self.__eq__(other) + + def __ge__(self, other): + return self.__gt__(other) or self.__eq__(other) + + # See http://docs.python.org/reference/datamodel#object.__hash__ + def __hash__(self): + return hash(self._parts) + + def __repr__(self): + return "%s('%s')" % (self.__class__.__name__, self._string) + + def __str__(self): + return self._string + + @property + def is_prerelease(self): + raise NotImplementedError('Please implement in subclasses.') + + +class Matcher(object): + version_class = None + + # value is either a callable or the name of a method + _operators = { + '<': lambda v, c, p: v < c, + '>': lambda v, c, p: v > c, + '<=': lambda v, c, p: v == c or v < c, + '>=': lambda v, c, p: v == c or v > c, + '==': lambda v, c, p: v == c, + '===': lambda v, c, p: v == c, + # by default, compatible => >=. + '~=': lambda v, c, p: v == c or v > c, + '!=': lambda v, c, p: v != c, + } + + # this is a method only to support alternative implementations + # via overriding + def parse_requirement(self, s): + return parse_requirement(s) + + def __init__(self, s): + if self.version_class is None: + raise ValueError('Please specify a version class') + self._string = s = s.strip() + r = self.parse_requirement(s) + if not r: + raise ValueError('Not valid: %r' % s) + self.name = r.name + self.key = self.name.lower() # for case-insensitive comparisons + clist = [] + if r.constraints: + # import pdb; pdb.set_trace() + for op, s in r.constraints: + if s.endswith('.*'): + if op not in ('==', '!='): + raise ValueError('\'.*\' not allowed for ' + '%r constraints' % op) + # Could be a partial version (e.g. for '2.*') which + # won't parse as a version, so keep it as a string + vn, prefix = s[:-2], True + # Just to check that vn is a valid version + self.version_class(vn) + else: + # Should parse as a version, so we can create an + # instance for the comparison + vn, prefix = self.version_class(s), False + clist.append((op, vn, prefix)) + self._parts = tuple(clist) + + def match(self, version): + """ + Check if the provided version matches the constraints. + + :param version: The version to match against this instance. + :type version: String or :class:`Version` instance. + """ + if isinstance(version, string_types): + version = self.version_class(version) + for operator, constraint, prefix in self._parts: + f = self._operators.get(operator) + if isinstance(f, string_types): + f = getattr(self, f) + if not f: + msg = ('%r not implemented ' + 'for %s' % (operator, self.__class__.__name__)) + raise NotImplementedError(msg) + if not f(version, constraint, prefix): + return False + return True + + @property + def exact_version(self): + result = None + if len(self._parts) == 1 and self._parts[0][0] in ('==', '==='): + result = self._parts[0][1] + return result + + def _check_compatible(self, other): + if type(self) != type(other) or self.name != other.name: + raise TypeError('cannot compare %s and %s' % (self, other)) + + def __eq__(self, other): + self._check_compatible(other) + return self.key == other.key and self._parts == other._parts + + def __ne__(self, other): + return not self.__eq__(other) + + # See http://docs.python.org/reference/datamodel#object.__hash__ + def __hash__(self): + return hash(self.key) + hash(self._parts) + + def __repr__(self): + return "%s(%r)" % (self.__class__.__name__, self._string) + + def __str__(self): + return self._string + + +PEP440_VERSION_RE = re.compile(r'^v?(\d+!)?(\d+(\.\d+)*)((a|alpha|b|beta|c|rc|pre|preview)(\d+)?)?' + r'(\.(post|r|rev)(\d+)?)?([._-]?(dev)(\d+)?)?' + r'(\+([a-zA-Z\d]+(\.[a-zA-Z\d]+)?))?$', re.I) + + +def _pep_440_key(s): + s = s.strip() + m = PEP440_VERSION_RE.match(s) + if not m: + raise UnsupportedVersionError('Not a valid version: %s' % s) + groups = m.groups() + nums = tuple(int(v) for v in groups[1].split('.')) + while len(nums) > 1 and nums[-1] == 0: + nums = nums[:-1] + + if not groups[0]: + epoch = 0 + else: + epoch = int(groups[0][:-1]) + pre = groups[4:6] + post = groups[7:9] + dev = groups[10:12] + local = groups[13] + if pre == (None, None): + pre = () + else: + if pre[1] is None: + pre = pre[0], 0 + else: + pre = pre[0], int(pre[1]) + if post == (None, None): + post = () + else: + if post[1] is None: + post = post[0], 0 + else: + post = post[0], int(post[1]) + if dev == (None, None): + dev = () + else: + if dev[1] is None: + dev = dev[0], 0 + else: + dev = dev[0], int(dev[1]) + if local is None: + local = () + else: + parts = [] + for part in local.split('.'): + # to ensure that numeric compares as > lexicographic, avoid + # comparing them directly, but encode a tuple which ensures + # correct sorting + if part.isdigit(): + part = (1, int(part)) + else: + part = (0, part) + parts.append(part) + local = tuple(parts) + if not pre: + # either before pre-release, or final release and after + if not post and dev: + # before pre-release + pre = ('a', -1) # to sort before a0 + else: + pre = ('z',) # to sort after all pre-releases + # now look at the state of post and dev. + if not post: + post = ('_',) # sort before 'a' + if not dev: + dev = ('final',) + + return epoch, nums, pre, post, dev, local + + +_normalized_key = _pep_440_key + + +class NormalizedVersion(Version): + """A rational version. + + Good: + 1.2 # equivalent to "1.2.0" + 1.2.0 + 1.2a1 + 1.2.3a2 + 1.2.3b1 + 1.2.3c1 + 1.2.3.4 + TODO: fill this out + + Bad: + 1 # minimum two numbers + 1.2a # release level must have a release serial + 1.2.3b + """ + def parse(self, s): + result = _normalized_key(s) + # _normalized_key loses trailing zeroes in the release + # clause, since that's needed to ensure that X.Y == X.Y.0 == X.Y.0.0 + # However, PEP 440 prefix matching needs it: for example, + # (~= 1.4.5.0) matches differently to (~= 1.4.5.0.0). + m = PEP440_VERSION_RE.match(s) # must succeed + groups = m.groups() + self._release_clause = tuple(int(v) for v in groups[1].split('.')) + return result + + PREREL_TAGS = set(['a', 'b', 'c', 'rc', 'dev']) + + @property + def is_prerelease(self): + return any(t[0] in self.PREREL_TAGS for t in self._parts if t) + + +def _match_prefix(x, y): + x = str(x) + y = str(y) + if x == y: + return True + if not x.startswith(y): + return False + n = len(y) + return x[n] == '.' + + +class NormalizedMatcher(Matcher): + version_class = NormalizedVersion + + # value is either a callable or the name of a method + _operators = { + '~=': '_match_compatible', + '<': '_match_lt', + '>': '_match_gt', + '<=': '_match_le', + '>=': '_match_ge', + '==': '_match_eq', + '===': '_match_arbitrary', + '!=': '_match_ne', + } + + def _adjust_local(self, version, constraint, prefix): + if prefix: + strip_local = '+' not in constraint and version._parts[-1] + else: + # both constraint and version are + # NormalizedVersion instances. + # If constraint does not have a local component, + # ensure the version doesn't, either. + strip_local = not constraint._parts[-1] and version._parts[-1] + if strip_local: + s = version._string.split('+', 1)[0] + version = self.version_class(s) + return version, constraint + + def _match_lt(self, version, constraint, prefix): + version, constraint = self._adjust_local(version, constraint, prefix) + if version >= constraint: + return False + release_clause = constraint._release_clause + pfx = '.'.join([str(i) for i in release_clause]) + return not _match_prefix(version, pfx) + + def _match_gt(self, version, constraint, prefix): + version, constraint = self._adjust_local(version, constraint, prefix) + if version <= constraint: + return False + release_clause = constraint._release_clause + pfx = '.'.join([str(i) for i in release_clause]) + return not _match_prefix(version, pfx) + + def _match_le(self, version, constraint, prefix): + version, constraint = self._adjust_local(version, constraint, prefix) + return version <= constraint + + def _match_ge(self, version, constraint, prefix): + version, constraint = self._adjust_local(version, constraint, prefix) + return version >= constraint + + def _match_eq(self, version, constraint, prefix): + version, constraint = self._adjust_local(version, constraint, prefix) + if not prefix: + result = (version == constraint) + else: + result = _match_prefix(version, constraint) + return result + + def _match_arbitrary(self, version, constraint, prefix): + return str(version) == str(constraint) + + def _match_ne(self, version, constraint, prefix): + version, constraint = self._adjust_local(version, constraint, prefix) + if not prefix: + result = (version != constraint) + else: + result = not _match_prefix(version, constraint) + return result + + def _match_compatible(self, version, constraint, prefix): + version, constraint = self._adjust_local(version, constraint, prefix) + if version == constraint: + return True + if version < constraint: + return False +# if not prefix: +# return True + release_clause = constraint._release_clause + if len(release_clause) > 1: + release_clause = release_clause[:-1] + pfx = '.'.join([str(i) for i in release_clause]) + return _match_prefix(version, pfx) + + +_REPLACEMENTS = ( + (re.compile('[.+-]$'), ''), # remove trailing puncts + (re.compile(r'^[.](\d)'), r'0.\1'), # .N -> 0.N at start + (re.compile('^[.-]'), ''), # remove leading puncts + (re.compile(r'^\((.*)\)$'), r'\1'), # remove parentheses + (re.compile(r'^v(ersion)?\s*(\d+)'), r'\2'), # remove leading v(ersion) + (re.compile(r'^r(ev)?\s*(\d+)'), r'\2'), # remove leading v(ersion) + (re.compile('[.]{2,}'), '.'), # multiple runs of '.' + (re.compile(r'\b(alfa|apha)\b'), 'alpha'), # misspelt alpha + (re.compile(r'\b(pre-alpha|prealpha)\b'), + 'pre.alpha'), # standardise + (re.compile(r'\(beta\)$'), 'beta'), # remove parentheses +) + +_SUFFIX_REPLACEMENTS = ( + (re.compile('^[:~._+-]+'), ''), # remove leading puncts + (re.compile('[,*")([\\]]'), ''), # remove unwanted chars + (re.compile('[~:+_ -]'), '.'), # replace illegal chars + (re.compile('[.]{2,}'), '.'), # multiple runs of '.' + (re.compile(r'\.$'), ''), # trailing '.' +) + +_NUMERIC_PREFIX = re.compile(r'(\d+(\.\d+)*)') + + +def _suggest_semantic_version(s): + """ + Try to suggest a semantic form for a version for which + _suggest_normalized_version couldn't come up with anything. + """ + result = s.strip().lower() + for pat, repl in _REPLACEMENTS: + result = pat.sub(repl, result) + if not result: + result = '0.0.0' + + # Now look for numeric prefix, and separate it out from + # the rest. + # import pdb; pdb.set_trace() + m = _NUMERIC_PREFIX.match(result) + if not m: + prefix = '0.0.0' + suffix = result + else: + prefix = m.groups()[0].split('.') + prefix = [int(i) for i in prefix] + while len(prefix) < 3: + prefix.append(0) + if len(prefix) == 3: + suffix = result[m.end():] + else: + suffix = '.'.join([str(i) for i in prefix[3:]]) + result[m.end():] + prefix = prefix[:3] + prefix = '.'.join([str(i) for i in prefix]) + suffix = suffix.strip() + if suffix: + # import pdb; pdb.set_trace() + # massage the suffix. + for pat, repl in _SUFFIX_REPLACEMENTS: + suffix = pat.sub(repl, suffix) + + if not suffix: + result = prefix + else: + sep = '-' if 'dev' in suffix else '+' + result = prefix + sep + suffix + if not is_semver(result): + result = None + return result + + +def _suggest_normalized_version(s): + """Suggest a normalized version close to the given version string. + + If you have a version string that isn't rational (i.e. NormalizedVersion + doesn't like it) then you might be able to get an equivalent (or close) + rational version from this function. + + This does a number of simple normalizations to the given string, based + on observation of versions currently in use on PyPI. Given a dump of + those version during PyCon 2009, 4287 of them: + - 2312 (53.93%) match NormalizedVersion without change + with the automatic suggestion + - 3474 (81.04%) match when using this suggestion method + + @param s {str} An irrational version string. + @returns A rational version string, or None, if couldn't determine one. + """ + try: + _normalized_key(s) + return s # already rational + except UnsupportedVersionError: + pass + + rs = s.lower() + + # part of this could use maketrans + for orig, repl in (('-alpha', 'a'), ('-beta', 'b'), ('alpha', 'a'), + ('beta', 'b'), ('rc', 'c'), ('-final', ''), + ('-pre', 'c'), + ('-release', ''), ('.release', ''), ('-stable', ''), + ('+', '.'), ('_', '.'), (' ', ''), ('.final', ''), + ('final', '')): + rs = rs.replace(orig, repl) + + # if something ends with dev or pre, we add a 0 + rs = re.sub(r"pre$", r"pre0", rs) + rs = re.sub(r"dev$", r"dev0", rs) + + # if we have something like "b-2" or "a.2" at the end of the + # version, that is probably beta, alpha, etc + # let's remove the dash or dot + rs = re.sub(r"([abc]|rc)[\-\.](\d+)$", r"\1\2", rs) + + # 1.0-dev-r371 -> 1.0.dev371 + # 0.1-dev-r79 -> 0.1.dev79 + rs = re.sub(r"[\-\.](dev)[\-\.]?r?(\d+)$", r".\1\2", rs) + + # Clean: 2.0.a.3, 2.0.b1, 0.9.0~c1 + rs = re.sub(r"[.~]?([abc])\.?", r"\1", rs) + + # Clean: v0.3, v1.0 + if rs.startswith('v'): + rs = rs[1:] + + # Clean leading '0's on numbers. + # TODO: unintended side-effect on, e.g., "2003.05.09" + # PyPI stats: 77 (~2%) better + rs = re.sub(r"\b0+(\d+)(?!\d)", r"\1", rs) + + # Clean a/b/c with no version. E.g. "1.0a" -> "1.0a0". Setuptools infers + # zero. + # PyPI stats: 245 (7.56%) better + rs = re.sub(r"(\d+[abc])$", r"\g<1>0", rs) + + # the 'dev-rNNN' tag is a dev tag + rs = re.sub(r"\.?(dev-r|dev\.r)\.?(\d+)$", r".dev\2", rs) + + # clean the - when used as a pre delimiter + rs = re.sub(r"-(a|b|c)(\d+)$", r"\1\2", rs) + + # a terminal "dev" or "devel" can be changed into ".dev0" + rs = re.sub(r"[\.\-](dev|devel)$", r".dev0", rs) + + # a terminal "dev" can be changed into ".dev0" + rs = re.sub(r"(?![\.\-])dev$", r".dev0", rs) + + # a terminal "final" or "stable" can be removed + rs = re.sub(r"(final|stable)$", "", rs) + + # The 'r' and the '-' tags are post release tags + # 0.4a1.r10 -> 0.4a1.post10 + # 0.9.33-17222 -> 0.9.33.post17222 + # 0.9.33-r17222 -> 0.9.33.post17222 + rs = re.sub(r"\.?(r|-|-r)\.?(\d+)$", r".post\2", rs) + + # Clean 'r' instead of 'dev' usage: + # 0.9.33+r17222 -> 0.9.33.dev17222 + # 1.0dev123 -> 1.0.dev123 + # 1.0.git123 -> 1.0.dev123 + # 1.0.bzr123 -> 1.0.dev123 + # 0.1a0dev.123 -> 0.1a0.dev123 + # PyPI stats: ~150 (~4%) better + rs = re.sub(r"\.?(dev|git|bzr)\.?(\d+)$", r".dev\2", rs) + + # Clean '.pre' (normalized from '-pre' above) instead of 'c' usage: + # 0.2.pre1 -> 0.2c1 + # 0.2-c1 -> 0.2c1 + # 1.0preview123 -> 1.0c123 + # PyPI stats: ~21 (0.62%) better + rs = re.sub(r"\.?(pre|preview|-c)(\d+)$", r"c\g<2>", rs) + + # Tcl/Tk uses "px" for their post release markers + rs = re.sub(r"p(\d+)$", r".post\1", rs) + + try: + _normalized_key(rs) + except UnsupportedVersionError: + rs = None + return rs + +# +# Legacy version processing (distribute-compatible) +# + + +_VERSION_PART = re.compile(r'([a-z]+|\d+|[\.-])', re.I) +_VERSION_REPLACE = { + 'pre': 'c', + 'preview': 'c', + '-': 'final-', + 'rc': 'c', + 'dev': '@', + '': None, + '.': None, +} + + +def _legacy_key(s): + def get_parts(s): + result = [] + for p in _VERSION_PART.split(s.lower()): + p = _VERSION_REPLACE.get(p, p) + if p: + if '0' <= p[:1] <= '9': + p = p.zfill(8) + else: + p = '*' + p + result.append(p) + result.append('*final') + return result + + result = [] + for p in get_parts(s): + if p.startswith('*'): + if p < '*final': + while result and result[-1] == '*final-': + result.pop() + while result and result[-1] == '00000000': + result.pop() + result.append(p) + return tuple(result) + + +class LegacyVersion(Version): + def parse(self, s): + return _legacy_key(s) + + @property + def is_prerelease(self): + result = False + for x in self._parts: + if (isinstance(x, string_types) and x.startswith('*') and x < '*final'): + result = True + break + return result + + +class LegacyMatcher(Matcher): + version_class = LegacyVersion + + _operators = dict(Matcher._operators) + _operators['~='] = '_match_compatible' + + numeric_re = re.compile(r'^(\d+(\.\d+)*)') + + def _match_compatible(self, version, constraint, prefix): + if version < constraint: + return False + m = self.numeric_re.match(str(constraint)) + if not m: + logger.warning('Cannot compute compatible match for version %s ' + ' and constraint %s', version, constraint) + return True + s = m.groups()[0] + if '.' in s: + s = s.rsplit('.', 1)[0] + return _match_prefix(version, s) + +# +# Semantic versioning +# + + +_SEMVER_RE = re.compile(r'^(\d+)\.(\d+)\.(\d+)' + r'(-[a-z0-9]+(\.[a-z0-9-]+)*)?' + r'(\+[a-z0-9]+(\.[a-z0-9-]+)*)?$', re.I) + + +def is_semver(s): + return _SEMVER_RE.match(s) + + +def _semantic_key(s): + def make_tuple(s, absent): + if s is None: + result = (absent,) + else: + parts = s[1:].split('.') + # We can't compare ints and strings on Python 3, so fudge it + # by zero-filling numeric values so simulate a numeric comparison + result = tuple([p.zfill(8) if p.isdigit() else p for p in parts]) + return result + + m = is_semver(s) + if not m: + raise UnsupportedVersionError(s) + groups = m.groups() + major, minor, patch = [int(i) for i in groups[:3]] + # choose the '|' and '*' so that versions sort correctly + pre, build = make_tuple(groups[3], '|'), make_tuple(groups[5], '*') + return (major, minor, patch), pre, build + + +class SemanticVersion(Version): + def parse(self, s): + return _semantic_key(s) + + @property + def is_prerelease(self): + return self._parts[1][0] != '|' + + +class SemanticMatcher(Matcher): + version_class = SemanticVersion + + +class VersionScheme(object): + def __init__(self, key, matcher, suggester=None): + self.key = key + self.matcher = matcher + self.suggester = suggester + + def is_valid_version(self, s): + try: + self.matcher.version_class(s) + result = True + except UnsupportedVersionError: + result = False + return result + + def is_valid_matcher(self, s): + try: + self.matcher(s) + result = True + except UnsupportedVersionError: + result = False + return result + + def is_valid_constraint_list(self, s): + """ + Used for processing some metadata fields + """ + # See issue #140. Be tolerant of a single trailing comma. + if s.endswith(','): + s = s[:-1] + return self.is_valid_matcher('dummy_name (%s)' % s) + + def suggest(self, s): + if self.suggester is None: + result = None + else: + result = self.suggester(s) + return result + + +_SCHEMES = { + 'normalized': VersionScheme(_normalized_key, NormalizedMatcher, + _suggest_normalized_version), + 'legacy': VersionScheme(_legacy_key, LegacyMatcher, lambda self, s: s), + 'semantic': VersionScheme(_semantic_key, SemanticMatcher, + _suggest_semantic_version), +} + +_SCHEMES['default'] = _SCHEMES['normalized'] + + +def get_scheme(name): + if name not in _SCHEMES: + raise ValueError('unknown scheme name: %r' % name) + return _SCHEMES[name] diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/w32.exe b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/w32.exe new file mode 100644 index 0000000..4ee2d3a Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/w32.exe differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/w64-arm.exe b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/w64-arm.exe new file mode 100644 index 0000000..951d581 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/w64-arm.exe differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/w64.exe b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/w64.exe new file mode 100644 index 0000000..5763076 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/w64.exe differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/wheel.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/wheel.py new file mode 100644 index 0000000..62ab10f --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/wheel.py @@ -0,0 +1,1100 @@ +# -*- coding: utf-8 -*- +# +# Copyright (C) 2013-2023 Vinay Sajip. +# Licensed to the Python Software Foundation under a contributor agreement. +# See LICENSE.txt and CONTRIBUTORS.txt. +# +from __future__ import unicode_literals + +import base64 +import codecs +import datetime +from email import message_from_file +import hashlib +import json +import logging +import os +import posixpath +import re +import shutil +import sys +import tempfile +import zipfile + +from . import __version__, DistlibException +from .compat import sysconfig, ZipFile, fsdecode, text_type, filter +from .database import InstalledDistribution +from .metadata import Metadata, WHEEL_METADATA_FILENAME, LEGACY_METADATA_FILENAME +from .util import (FileOperator, convert_path, CSVReader, CSVWriter, Cache, cached_property, get_cache_base, + read_exports, tempdir, get_platform) +from .version import NormalizedVersion, UnsupportedVersionError + +logger = logging.getLogger(__name__) + +cache = None # created when needed + +if hasattr(sys, 'pypy_version_info'): # pragma: no cover + IMP_PREFIX = 'pp' +elif sys.platform.startswith('java'): # pragma: no cover + IMP_PREFIX = 'jy' +elif sys.platform == 'cli': # pragma: no cover + IMP_PREFIX = 'ip' +else: + IMP_PREFIX = 'cp' + +VER_SUFFIX = sysconfig.get_config_var('py_version_nodot') +if not VER_SUFFIX: # pragma: no cover + VER_SUFFIX = '%s%s' % sys.version_info[:2] +PYVER = 'py' + VER_SUFFIX +IMPVER = IMP_PREFIX + VER_SUFFIX + +ARCH = get_platform().replace('-', '_').replace('.', '_') + +ABI = sysconfig.get_config_var('SOABI') +if ABI and ABI.startswith('cpython-'): + ABI = ABI.replace('cpython-', 'cp').split('-')[0] +else: + + def _derive_abi(): + parts = ['cp', VER_SUFFIX] + if sysconfig.get_config_var('Py_DEBUG'): + parts.append('d') + if IMP_PREFIX == 'cp': + vi = sys.version_info[:2] + if vi < (3, 8): + wpm = sysconfig.get_config_var('WITH_PYMALLOC') + if wpm is None: + wpm = True + if wpm: + parts.append('m') + if vi < (3, 3): + us = sysconfig.get_config_var('Py_UNICODE_SIZE') + if us == 4 or (us is None and sys.maxunicode == 0x10FFFF): + parts.append('u') + return ''.join(parts) + + ABI = _derive_abi() + del _derive_abi + +FILENAME_RE = re.compile( + r''' +(?P[^-]+) +-(?P\d+[^-]*) +(-(?P\d+[^-]*))? +-(?P\w+\d+(\.\w+\d+)*) +-(?P\w+) +-(?P\w+(\.\w+)*) +\.whl$ +''', re.IGNORECASE | re.VERBOSE) + +NAME_VERSION_RE = re.compile(r''' +(?P[^-]+) +-(?P\d+[^-]*) +(-(?P\d+[^-]*))?$ +''', re.IGNORECASE | re.VERBOSE) + +SHEBANG_RE = re.compile(br'\s*#![^\r\n]*') +SHEBANG_DETAIL_RE = re.compile(br'^(\s*#!("[^"]+"|\S+))\s+(.*)$') +SHEBANG_PYTHON = b'#!python' +SHEBANG_PYTHONW = b'#!pythonw' + +if os.sep == '/': + to_posix = lambda o: o +else: + to_posix = lambda o: o.replace(os.sep, '/') + +if sys.version_info[0] < 3: + import imp +else: + imp = None + import importlib.machinery + import importlib.util + + +def _get_suffixes(): + if imp: + return [s[0] for s in imp.get_suffixes()] + else: + return importlib.machinery.EXTENSION_SUFFIXES + + +def _load_dynamic(name, path): + # https://docs.python.org/3/library/importlib.html#importing-a-source-file-directly + if imp: + return imp.load_dynamic(name, path) + else: + spec = importlib.util.spec_from_file_location(name, path) + module = importlib.util.module_from_spec(spec) + sys.modules[name] = module + spec.loader.exec_module(module) + return module + + +class Mounter(object): + + def __init__(self): + self.impure_wheels = {} + self.libs = {} + + def add(self, pathname, extensions): + self.impure_wheels[pathname] = extensions + self.libs.update(extensions) + + def remove(self, pathname): + extensions = self.impure_wheels.pop(pathname) + for k, v in extensions: + if k in self.libs: + del self.libs[k] + + def find_module(self, fullname, path=None): + if fullname in self.libs: + result = self + else: + result = None + return result + + def load_module(self, fullname): + if fullname in sys.modules: + result = sys.modules[fullname] + else: + if fullname not in self.libs: + raise ImportError('unable to find extension for %s' % fullname) + result = _load_dynamic(fullname, self.libs[fullname]) + result.__loader__ = self + parts = fullname.rsplit('.', 1) + if len(parts) > 1: + result.__package__ = parts[0] + return result + + +_hook = Mounter() + + +class Wheel(object): + """ + Class to build and install from Wheel files (PEP 427). + """ + + wheel_version = (1, 1) + hash_kind = 'sha256' + + def __init__(self, filename=None, sign=False, verify=False): + """ + Initialise an instance using a (valid) filename. + """ + self.sign = sign + self.should_verify = verify + self.buildver = '' + self.pyver = [PYVER] + self.abi = ['none'] + self.arch = ['any'] + self.dirname = os.getcwd() + if filename is None: + self.name = 'dummy' + self.version = '0.1' + self._filename = self.filename + else: + m = NAME_VERSION_RE.match(filename) + if m: + info = m.groupdict('') + self.name = info['nm'] + # Reinstate the local version separator + self.version = info['vn'].replace('_', '-') + self.buildver = info['bn'] + self._filename = self.filename + else: + dirname, filename = os.path.split(filename) + m = FILENAME_RE.match(filename) + if not m: + raise DistlibException('Invalid name or ' + 'filename: %r' % filename) + if dirname: + self.dirname = os.path.abspath(dirname) + self._filename = filename + info = m.groupdict('') + self.name = info['nm'] + self.version = info['vn'] + self.buildver = info['bn'] + self.pyver = info['py'].split('.') + self.abi = info['bi'].split('.') + self.arch = info['ar'].split('.') + + @property + def filename(self): + """ + Build and return a filename from the various components. + """ + if self.buildver: + buildver = '-' + self.buildver + else: + buildver = '' + pyver = '.'.join(self.pyver) + abi = '.'.join(self.abi) + arch = '.'.join(self.arch) + # replace - with _ as a local version separator + version = self.version.replace('-', '_') + return '%s-%s%s-%s-%s-%s.whl' % (self.name, version, buildver, pyver, abi, arch) + + @property + def exists(self): + path = os.path.join(self.dirname, self.filename) + return os.path.isfile(path) + + @property + def tags(self): + for pyver in self.pyver: + for abi in self.abi: + for arch in self.arch: + yield pyver, abi, arch + + @cached_property + def metadata(self): + pathname = os.path.join(self.dirname, self.filename) + name_ver = '%s-%s' % (self.name, self.version) + info_dir = '%s.dist-info' % name_ver + wrapper = codecs.getreader('utf-8') + with ZipFile(pathname, 'r') as zf: + self.get_wheel_metadata(zf) + # wv = wheel_metadata['Wheel-Version'].split('.', 1) + # file_version = tuple([int(i) for i in wv]) + # if file_version < (1, 1): + # fns = [WHEEL_METADATA_FILENAME, METADATA_FILENAME, + # LEGACY_METADATA_FILENAME] + # else: + # fns = [WHEEL_METADATA_FILENAME, METADATA_FILENAME] + fns = [WHEEL_METADATA_FILENAME, LEGACY_METADATA_FILENAME] + result = None + for fn in fns: + try: + metadata_filename = posixpath.join(info_dir, fn) + with zf.open(metadata_filename) as bf: + wf = wrapper(bf) + result = Metadata(fileobj=wf) + if result: + break + except KeyError: + pass + if not result: + raise ValueError('Invalid wheel, because metadata is ' + 'missing: looked in %s' % ', '.join(fns)) + return result + + def get_wheel_metadata(self, zf): + name_ver = '%s-%s' % (self.name, self.version) + info_dir = '%s.dist-info' % name_ver + metadata_filename = posixpath.join(info_dir, 'WHEEL') + with zf.open(metadata_filename) as bf: + wf = codecs.getreader('utf-8')(bf) + message = message_from_file(wf) + return dict(message) + + @cached_property + def info(self): + pathname = os.path.join(self.dirname, self.filename) + with ZipFile(pathname, 'r') as zf: + result = self.get_wheel_metadata(zf) + return result + + def process_shebang(self, data): + m = SHEBANG_RE.match(data) + if m: + end = m.end() + shebang, data_after_shebang = data[:end], data[end:] + # Preserve any arguments after the interpreter + if b'pythonw' in shebang.lower(): + shebang_python = SHEBANG_PYTHONW + else: + shebang_python = SHEBANG_PYTHON + m = SHEBANG_DETAIL_RE.match(shebang) + if m: + args = b' ' + m.groups()[-1] + else: + args = b'' + shebang = shebang_python + args + data = shebang + data_after_shebang + else: + cr = data.find(b'\r') + lf = data.find(b'\n') + if cr < 0 or cr > lf: + term = b'\n' + else: + if data[cr:cr + 2] == b'\r\n': + term = b'\r\n' + else: + term = b'\r' + data = SHEBANG_PYTHON + term + data + return data + + def get_hash(self, data, hash_kind=None): + if hash_kind is None: + hash_kind = self.hash_kind + try: + hasher = getattr(hashlib, hash_kind) + except AttributeError: + raise DistlibException('Unsupported hash algorithm: %r' % hash_kind) + result = hasher(data).digest() + result = base64.urlsafe_b64encode(result).rstrip(b'=').decode('ascii') + return hash_kind, result + + def write_record(self, records, record_path, archive_record_path): + records = list(records) # make a copy, as mutated + records.append((archive_record_path, '', '')) + with CSVWriter(record_path) as writer: + for row in records: + writer.writerow(row) + + def write_records(self, info, libdir, archive_paths): + records = [] + distinfo, info_dir = info + # hasher = getattr(hashlib, self.hash_kind) + for ap, p in archive_paths: + with open(p, 'rb') as f: + data = f.read() + digest = '%s=%s' % self.get_hash(data) + size = os.path.getsize(p) + records.append((ap, digest, size)) + + p = os.path.join(distinfo, 'RECORD') + ap = to_posix(os.path.join(info_dir, 'RECORD')) + self.write_record(records, p, ap) + archive_paths.append((ap, p)) + + def build_zip(self, pathname, archive_paths): + with ZipFile(pathname, 'w', zipfile.ZIP_DEFLATED) as zf: + for ap, p in archive_paths: + logger.debug('Wrote %s to %s in wheel', p, ap) + zf.write(p, ap) + + def build(self, paths, tags=None, wheel_version=None): + """ + Build a wheel from files in specified paths, and use any specified tags + when determining the name of the wheel. + """ + if tags is None: + tags = {} + + libkey = list(filter(lambda o: o in paths, ('purelib', 'platlib')))[0] + if libkey == 'platlib': + is_pure = 'false' + default_pyver = [IMPVER] + default_abi = [ABI] + default_arch = [ARCH] + else: + is_pure = 'true' + default_pyver = [PYVER] + default_abi = ['none'] + default_arch = ['any'] + + self.pyver = tags.get('pyver', default_pyver) + self.abi = tags.get('abi', default_abi) + self.arch = tags.get('arch', default_arch) + + libdir = paths[libkey] + + name_ver = '%s-%s' % (self.name, self.version) + data_dir = '%s.data' % name_ver + info_dir = '%s.dist-info' % name_ver + + archive_paths = [] + + # First, stuff which is not in site-packages + for key in ('data', 'headers', 'scripts'): + if key not in paths: + continue + path = paths[key] + if os.path.isdir(path): + for root, dirs, files in os.walk(path): + for fn in files: + p = fsdecode(os.path.join(root, fn)) + rp = os.path.relpath(p, path) + ap = to_posix(os.path.join(data_dir, key, rp)) + archive_paths.append((ap, p)) + if key == 'scripts' and not p.endswith('.exe'): + with open(p, 'rb') as f: + data = f.read() + data = self.process_shebang(data) + with open(p, 'wb') as f: + f.write(data) + + # Now, stuff which is in site-packages, other than the + # distinfo stuff. + path = libdir + distinfo = None + for root, dirs, files in os.walk(path): + if root == path: + # At the top level only, save distinfo for later + # and skip it for now + for i, dn in enumerate(dirs): + dn = fsdecode(dn) + if dn.endswith('.dist-info'): + distinfo = os.path.join(root, dn) + del dirs[i] + break + assert distinfo, '.dist-info directory expected, not found' + + for fn in files: + # comment out next suite to leave .pyc files in + if fsdecode(fn).endswith(('.pyc', '.pyo')): + continue + p = os.path.join(root, fn) + rp = to_posix(os.path.relpath(p, path)) + archive_paths.append((rp, p)) + + # Now distinfo. Assumed to be flat, i.e. os.listdir is enough. + files = os.listdir(distinfo) + for fn in files: + if fn not in ('RECORD', 'INSTALLER', 'SHARED', 'WHEEL'): + p = fsdecode(os.path.join(distinfo, fn)) + ap = to_posix(os.path.join(info_dir, fn)) + archive_paths.append((ap, p)) + + wheel_metadata = [ + 'Wheel-Version: %d.%d' % (wheel_version or self.wheel_version), + 'Generator: distlib %s' % __version__, + 'Root-Is-Purelib: %s' % is_pure, + ] + for pyver, abi, arch in self.tags: + wheel_metadata.append('Tag: %s-%s-%s' % (pyver, abi, arch)) + p = os.path.join(distinfo, 'WHEEL') + with open(p, 'w') as f: + f.write('\n'.join(wheel_metadata)) + ap = to_posix(os.path.join(info_dir, 'WHEEL')) + archive_paths.append((ap, p)) + + # sort the entries by archive path. Not needed by any spec, but it + # keeps the archive listing and RECORD tidier than they would otherwise + # be. Use the number of path segments to keep directory entries together, + # and keep the dist-info stuff at the end. + def sorter(t): + ap = t[0] + n = ap.count('/') + if '.dist-info' in ap: + n += 10000 + return (n, ap) + + archive_paths = sorted(archive_paths, key=sorter) + + # Now, at last, RECORD. + # Paths in here are archive paths - nothing else makes sense. + self.write_records((distinfo, info_dir), libdir, archive_paths) + # Now, ready to build the zip file + pathname = os.path.join(self.dirname, self.filename) + self.build_zip(pathname, archive_paths) + return pathname + + def skip_entry(self, arcname): + """ + Determine whether an archive entry should be skipped when verifying + or installing. + """ + # The signature file won't be in RECORD, + # and we don't currently don't do anything with it + # We also skip directories, as they won't be in RECORD + # either. See: + # + # https://github.com/pypa/wheel/issues/294 + # https://github.com/pypa/wheel/issues/287 + # https://github.com/pypa/wheel/pull/289 + # + return arcname.endswith(('/', '/RECORD.jws')) + + def install(self, paths, maker, **kwargs): + """ + Install a wheel to the specified paths. If kwarg ``warner`` is + specified, it should be a callable, which will be called with two + tuples indicating the wheel version of this software and the wheel + version in the file, if there is a discrepancy in the versions. + This can be used to issue any warnings to raise any exceptions. + If kwarg ``lib_only`` is True, only the purelib/platlib files are + installed, and the headers, scripts, data and dist-info metadata are + not written. If kwarg ``bytecode_hashed_invalidation`` is True, written + bytecode will try to use file-hash based invalidation (PEP-552) on + supported interpreter versions (CPython 3.7+). + + The return value is a :class:`InstalledDistribution` instance unless + ``options.lib_only`` is True, in which case the return value is ``None``. + """ + + dry_run = maker.dry_run + warner = kwargs.get('warner') + lib_only = kwargs.get('lib_only', False) + bc_hashed_invalidation = kwargs.get('bytecode_hashed_invalidation', False) + + pathname = os.path.join(self.dirname, self.filename) + name_ver = '%s-%s' % (self.name, self.version) + data_dir = '%s.data' % name_ver + info_dir = '%s.dist-info' % name_ver + + metadata_name = posixpath.join(info_dir, LEGACY_METADATA_FILENAME) + wheel_metadata_name = posixpath.join(info_dir, 'WHEEL') + record_name = posixpath.join(info_dir, 'RECORD') + + wrapper = codecs.getreader('utf-8') + + with ZipFile(pathname, 'r') as zf: + with zf.open(wheel_metadata_name) as bwf: + wf = wrapper(bwf) + message = message_from_file(wf) + wv = message['Wheel-Version'].split('.', 1) + file_version = tuple([int(i) for i in wv]) + if (file_version != self.wheel_version) and warner: + warner(self.wheel_version, file_version) + + if message['Root-Is-Purelib'] == 'true': + libdir = paths['purelib'] + else: + libdir = paths['platlib'] + + records = {} + with zf.open(record_name) as bf: + with CSVReader(stream=bf) as reader: + for row in reader: + p = row[0] + records[p] = row + + data_pfx = posixpath.join(data_dir, '') + info_pfx = posixpath.join(info_dir, '') + script_pfx = posixpath.join(data_dir, 'scripts', '') + + # make a new instance rather than a copy of maker's, + # as we mutate it + fileop = FileOperator(dry_run=dry_run) + fileop.record = True # so we can rollback if needed + + bc = not sys.dont_write_bytecode # Double negatives. Lovely! + + outfiles = [] # for RECORD writing + + # for script copying/shebang processing + workdir = tempfile.mkdtemp() + # set target dir later + # we default add_launchers to False, as the + # Python Launcher should be used instead + maker.source_dir = workdir + maker.target_dir = None + try: + for zinfo in zf.infolist(): + arcname = zinfo.filename + if isinstance(arcname, text_type): + u_arcname = arcname + else: + u_arcname = arcname.decode('utf-8') + if self.skip_entry(u_arcname): + continue + row = records[u_arcname] + if row[2] and str(zinfo.file_size) != row[2]: + raise DistlibException('size mismatch for ' + '%s' % u_arcname) + if row[1]: + kind, value = row[1].split('=', 1) + with zf.open(arcname) as bf: + data = bf.read() + _, digest = self.get_hash(data, kind) + if digest != value: + raise DistlibException('digest mismatch for ' + '%s' % arcname) + + if lib_only and u_arcname.startswith((info_pfx, data_pfx)): + logger.debug('lib_only: skipping %s', u_arcname) + continue + is_script = (u_arcname.startswith(script_pfx) and not u_arcname.endswith('.exe')) + + if u_arcname.startswith(data_pfx): + _, where, rp = u_arcname.split('/', 2) + outfile = os.path.join(paths[where], convert_path(rp)) + else: + # meant for site-packages. + if u_arcname in (wheel_metadata_name, record_name): + continue + outfile = os.path.join(libdir, convert_path(u_arcname)) + if not is_script: + with zf.open(arcname) as bf: + fileop.copy_stream(bf, outfile) + # Issue #147: permission bits aren't preserved. Using + # zf.extract(zinfo, libdir) should have worked, but didn't, + # see https://www.thetopsites.net/article/53834422.shtml + # So ... manually preserve permission bits as given in zinfo + if os.name == 'posix': + # just set the normal permission bits + os.chmod(outfile, (zinfo.external_attr >> 16) & 0x1FF) + outfiles.append(outfile) + # Double check the digest of the written file + if not dry_run and row[1]: + with open(outfile, 'rb') as bf: + data = bf.read() + _, newdigest = self.get_hash(data, kind) + if newdigest != digest: + raise DistlibException('digest mismatch ' + 'on write for ' + '%s' % outfile) + if bc and outfile.endswith('.py'): + try: + pyc = fileop.byte_compile(outfile, hashed_invalidation=bc_hashed_invalidation) + outfiles.append(pyc) + except Exception: + # Don't give up if byte-compilation fails, + # but log it and perhaps warn the user + logger.warning('Byte-compilation failed', exc_info=True) + else: + fn = os.path.basename(convert_path(arcname)) + workname = os.path.join(workdir, fn) + with zf.open(arcname) as bf: + fileop.copy_stream(bf, workname) + + dn, fn = os.path.split(outfile) + maker.target_dir = dn + filenames = maker.make(fn) + fileop.set_executable_mode(filenames) + outfiles.extend(filenames) + + if lib_only: + logger.debug('lib_only: returning None') + dist = None + else: + # Generate scripts + + # Try to get pydist.json so we can see if there are + # any commands to generate. If this fails (e.g. because + # of a legacy wheel), log a warning but don't give up. + commands = None + file_version = self.info['Wheel-Version'] + if file_version == '1.0': + # Use legacy info + ep = posixpath.join(info_dir, 'entry_points.txt') + try: + with zf.open(ep) as bwf: + epdata = read_exports(bwf) + commands = {} + for key in ('console', 'gui'): + k = '%s_scripts' % key + if k in epdata: + commands['wrap_%s' % key] = d = {} + for v in epdata[k].values(): + s = '%s:%s' % (v.prefix, v.suffix) + if v.flags: + s += ' [%s]' % ','.join(v.flags) + d[v.name] = s + except Exception: + logger.warning('Unable to read legacy script ' + 'metadata, so cannot generate ' + 'scripts') + else: + try: + with zf.open(metadata_name) as bwf: + wf = wrapper(bwf) + commands = json.load(wf).get('extensions') + if commands: + commands = commands.get('python.commands') + except Exception: + logger.warning('Unable to read JSON metadata, so ' + 'cannot generate scripts') + if commands: + console_scripts = commands.get('wrap_console', {}) + gui_scripts = commands.get('wrap_gui', {}) + if console_scripts or gui_scripts: + script_dir = paths.get('scripts', '') + if not os.path.isdir(script_dir): + raise ValueError('Valid script path not ' + 'specified') + maker.target_dir = script_dir + for k, v in console_scripts.items(): + script = '%s = %s' % (k, v) + filenames = maker.make(script) + fileop.set_executable_mode(filenames) + + if gui_scripts: + options = {'gui': True} + for k, v in gui_scripts.items(): + script = '%s = %s' % (k, v) + filenames = maker.make(script, options) + fileop.set_executable_mode(filenames) + + p = os.path.join(libdir, info_dir) + dist = InstalledDistribution(p) + + # Write SHARED + paths = dict(paths) # don't change passed in dict + del paths['purelib'] + del paths['platlib'] + paths['lib'] = libdir + p = dist.write_shared_locations(paths, dry_run) + if p: + outfiles.append(p) + + # Write RECORD + dist.write_installed_files(outfiles, paths['prefix'], dry_run) + return dist + except Exception: # pragma: no cover + logger.exception('installation failed.') + fileop.rollback() + raise + finally: + shutil.rmtree(workdir) + + def _get_dylib_cache(self): + global cache + if cache is None: + # Use native string to avoid issues on 2.x: see Python #20140. + base = os.path.join(get_cache_base(), str('dylib-cache'), '%s.%s' % sys.version_info[:2]) + cache = Cache(base) + return cache + + def _get_extensions(self): + pathname = os.path.join(self.dirname, self.filename) + name_ver = '%s-%s' % (self.name, self.version) + info_dir = '%s.dist-info' % name_ver + arcname = posixpath.join(info_dir, 'EXTENSIONS') + wrapper = codecs.getreader('utf-8') + result = [] + with ZipFile(pathname, 'r') as zf: + try: + with zf.open(arcname) as bf: + wf = wrapper(bf) + extensions = json.load(wf) + cache = self._get_dylib_cache() + prefix = cache.prefix_to_dir(self.filename, use_abspath=False) + cache_base = os.path.join(cache.base, prefix) + if not os.path.isdir(cache_base): + os.makedirs(cache_base) + for name, relpath in extensions.items(): + dest = os.path.join(cache_base, convert_path(relpath)) + if not os.path.exists(dest): + extract = True + else: + file_time = os.stat(dest).st_mtime + file_time = datetime.datetime.fromtimestamp(file_time) + info = zf.getinfo(relpath) + wheel_time = datetime.datetime(*info.date_time) + extract = wheel_time > file_time + if extract: + zf.extract(relpath, cache_base) + result.append((name, dest)) + except KeyError: + pass + return result + + def is_compatible(self): + """ + Determine if a wheel is compatible with the running system. + """ + return is_compatible(self) + + def is_mountable(self): + """ + Determine if a wheel is asserted as mountable by its metadata. + """ + return True # for now - metadata details TBD + + def mount(self, append=False): + pathname = os.path.abspath(os.path.join(self.dirname, self.filename)) + if not self.is_compatible(): + msg = 'Wheel %s not compatible with this Python.' % pathname + raise DistlibException(msg) + if not self.is_mountable(): + msg = 'Wheel %s is marked as not mountable.' % pathname + raise DistlibException(msg) + if pathname in sys.path: + logger.debug('%s already in path', pathname) + else: + if append: + sys.path.append(pathname) + else: + sys.path.insert(0, pathname) + extensions = self._get_extensions() + if extensions: + if _hook not in sys.meta_path: + sys.meta_path.append(_hook) + _hook.add(pathname, extensions) + + def unmount(self): + pathname = os.path.abspath(os.path.join(self.dirname, self.filename)) + if pathname not in sys.path: + logger.debug('%s not in path', pathname) + else: + sys.path.remove(pathname) + if pathname in _hook.impure_wheels: + _hook.remove(pathname) + if not _hook.impure_wheels: + if _hook in sys.meta_path: + sys.meta_path.remove(_hook) + + def verify(self): + pathname = os.path.join(self.dirname, self.filename) + name_ver = '%s-%s' % (self.name, self.version) + # data_dir = '%s.data' % name_ver + info_dir = '%s.dist-info' % name_ver + + # metadata_name = posixpath.join(info_dir, LEGACY_METADATA_FILENAME) + wheel_metadata_name = posixpath.join(info_dir, 'WHEEL') + record_name = posixpath.join(info_dir, 'RECORD') + + wrapper = codecs.getreader('utf-8') + + with ZipFile(pathname, 'r') as zf: + with zf.open(wheel_metadata_name) as bwf: + wf = wrapper(bwf) + message_from_file(wf) + # wv = message['Wheel-Version'].split('.', 1) + # file_version = tuple([int(i) for i in wv]) + # TODO version verification + + records = {} + with zf.open(record_name) as bf: + with CSVReader(stream=bf) as reader: + for row in reader: + p = row[0] + records[p] = row + + for zinfo in zf.infolist(): + arcname = zinfo.filename + if isinstance(arcname, text_type): + u_arcname = arcname + else: + u_arcname = arcname.decode('utf-8') + # See issue #115: some wheels have .. in their entries, but + # in the filename ... e.g. __main__..py ! So the check is + # updated to look for .. in the directory portions + p = u_arcname.split('/') + if '..' in p: + raise DistlibException('invalid entry in ' + 'wheel: %r' % u_arcname) + + if self.skip_entry(u_arcname): + continue + row = records[u_arcname] + if row[2] and str(zinfo.file_size) != row[2]: + raise DistlibException('size mismatch for ' + '%s' % u_arcname) + if row[1]: + kind, value = row[1].split('=', 1) + with zf.open(arcname) as bf: + data = bf.read() + _, digest = self.get_hash(data, kind) + if digest != value: + raise DistlibException('digest mismatch for ' + '%s' % arcname) + + def update(self, modifier, dest_dir=None, **kwargs): + """ + Update the contents of a wheel in a generic way. The modifier should + be a callable which expects a dictionary argument: its keys are + archive-entry paths, and its values are absolute filesystem paths + where the contents the corresponding archive entries can be found. The + modifier is free to change the contents of the files pointed to, add + new entries and remove entries, before returning. This method will + extract the entire contents of the wheel to a temporary location, call + the modifier, and then use the passed (and possibly updated) + dictionary to write a new wheel. If ``dest_dir`` is specified, the new + wheel is written there -- otherwise, the original wheel is overwritten. + + The modifier should return True if it updated the wheel, else False. + This method returns the same value the modifier returns. + """ + + def get_version(path_map, info_dir): + version = path = None + key = '%s/%s' % (info_dir, LEGACY_METADATA_FILENAME) + if key not in path_map: + key = '%s/PKG-INFO' % info_dir + if key in path_map: + path = path_map[key] + version = Metadata(path=path).version + return version, path + + def update_version(version, path): + updated = None + try: + NormalizedVersion(version) + i = version.find('-') + if i < 0: + updated = '%s+1' % version + else: + parts = [int(s) for s in version[i + 1:].split('.')] + parts[-1] += 1 + updated = '%s+%s' % (version[:i], '.'.join(str(i) for i in parts)) + except UnsupportedVersionError: + logger.debug('Cannot update non-compliant (PEP-440) ' + 'version %r', version) + if updated: + md = Metadata(path=path) + md.version = updated + legacy = path.endswith(LEGACY_METADATA_FILENAME) + md.write(path=path, legacy=legacy) + logger.debug('Version updated from %r to %r', version, updated) + + pathname = os.path.join(self.dirname, self.filename) + name_ver = '%s-%s' % (self.name, self.version) + info_dir = '%s.dist-info' % name_ver + record_name = posixpath.join(info_dir, 'RECORD') + with tempdir() as workdir: + with ZipFile(pathname, 'r') as zf: + path_map = {} + for zinfo in zf.infolist(): + arcname = zinfo.filename + if isinstance(arcname, text_type): + u_arcname = arcname + else: + u_arcname = arcname.decode('utf-8') + if u_arcname == record_name: + continue + if '..' in u_arcname: + raise DistlibException('invalid entry in ' + 'wheel: %r' % u_arcname) + zf.extract(zinfo, workdir) + path = os.path.join(workdir, convert_path(u_arcname)) + path_map[u_arcname] = path + + # Remember the version. + original_version, _ = get_version(path_map, info_dir) + # Files extracted. Call the modifier. + modified = modifier(path_map, **kwargs) + if modified: + # Something changed - need to build a new wheel. + current_version, path = get_version(path_map, info_dir) + if current_version and (current_version == original_version): + # Add or update local version to signify changes. + update_version(current_version, path) + # Decide where the new wheel goes. + if dest_dir is None: + fd, newpath = tempfile.mkstemp(suffix='.whl', prefix='wheel-update-', dir=workdir) + os.close(fd) + else: + if not os.path.isdir(dest_dir): + raise DistlibException('Not a directory: %r' % dest_dir) + newpath = os.path.join(dest_dir, self.filename) + archive_paths = list(path_map.items()) + distinfo = os.path.join(workdir, info_dir) + info = distinfo, info_dir + self.write_records(info, workdir, archive_paths) + self.build_zip(newpath, archive_paths) + if dest_dir is None: + shutil.copyfile(newpath, pathname) + return modified + + +def _get_glibc_version(): + import platform + ver = platform.libc_ver() + result = [] + if ver[0] == 'glibc': + for s in ver[1].split('.'): + result.append(int(s) if s.isdigit() else 0) + result = tuple(result) + return result + + +def compatible_tags(): + """ + Return (pyver, abi, arch) tuples compatible with this Python. + """ + class _Version: + def __init__(self, major, minor): + self.major = major + self.major_minor = (major, minor) + self.string = ''.join((str(major), str(minor))) + + def __str__(self): + return self.string + + + versions = [ + _Version(sys.version_info.major, minor_version) + for minor_version in range(sys.version_info.minor, -1, -1) + ] + abis = [] + for suffix in _get_suffixes(): + if suffix.startswith('.abi'): + abis.append(suffix.split('.', 2)[1]) + abis.sort() + if ABI != 'none': + abis.insert(0, ABI) + abis.append('none') + result = [] + + arches = [ARCH] + if sys.platform == 'darwin': + m = re.match(r'(\w+)_(\d+)_(\d+)_(\w+)$', ARCH) + if m: + name, major, minor, arch = m.groups() + minor = int(minor) + matches = [arch] + if arch in ('i386', 'ppc'): + matches.append('fat') + if arch in ('i386', 'ppc', 'x86_64'): + matches.append('fat3') + if arch in ('ppc64', 'x86_64'): + matches.append('fat64') + if arch in ('i386', 'x86_64'): + matches.append('intel') + if arch in ('i386', 'x86_64', 'intel', 'ppc', 'ppc64'): + matches.append('universal') + while minor >= 0: + for match in matches: + s = '%s_%s_%s_%s' % (name, major, minor, match) + if s != ARCH: # already there + arches.append(s) + minor -= 1 + + # Most specific - our Python version, ABI and arch + for i, version_object in enumerate(versions): + version = str(version_object) + add_abis = [] + + if i == 0: + add_abis = abis + + if IMP_PREFIX == 'cp' and version_object.major_minor >= (3, 2): + limited_api_abi = 'abi' + str(version_object.major) + if limited_api_abi not in add_abis: + add_abis.append(limited_api_abi) + + for abi in add_abis: + for arch in arches: + result.append((''.join((IMP_PREFIX, version)), abi, arch)) + # manylinux + if abi != 'none' and sys.platform.startswith('linux'): + arch = arch.replace('linux_', '') + parts = _get_glibc_version() + if len(parts) == 2: + if parts >= (2, 5): + result.append((''.join((IMP_PREFIX, version)), abi, 'manylinux1_%s' % arch)) + if parts >= (2, 12): + result.append((''.join((IMP_PREFIX, version)), abi, 'manylinux2010_%s' % arch)) + if parts >= (2, 17): + result.append((''.join((IMP_PREFIX, version)), abi, 'manylinux2014_%s' % arch)) + result.append((''.join( + (IMP_PREFIX, version)), abi, 'manylinux_%s_%s_%s' % (parts[0], parts[1], arch))) + + # where no ABI / arch dependency, but IMP_PREFIX dependency + for i, version_object in enumerate(versions): + version = str(version_object) + result.append((''.join((IMP_PREFIX, version)), 'none', 'any')) + if i == 0: + result.append((''.join((IMP_PREFIX, version[0])), 'none', 'any')) + + # no IMP_PREFIX, ABI or arch dependency + for i, version_object in enumerate(versions): + version = str(version_object) + result.append((''.join(('py', version)), 'none', 'any')) + if i == 0: + result.append((''.join(('py', version[0])), 'none', 'any')) + + return set(result) + + +COMPATIBLE_TAGS = compatible_tags() + +del compatible_tags + + +def is_compatible(wheel, tags=None): + if not isinstance(wheel, Wheel): + wheel = Wheel(wheel) # assume it's a filename + result = False + if tags is None: + tags = COMPATIBLE_TAGS + for ver, abi, arch in tags: + if ver in wheel.pyver and abi in wheel.abi and arch in wheel.arch: + result = True + break + return result diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/distro/__init__.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/distro/__init__.py new file mode 100644 index 0000000..7686fe8 --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/distro/__init__.py @@ -0,0 +1,54 @@ +from .distro import ( + NORMALIZED_DISTRO_ID, + NORMALIZED_LSB_ID, + NORMALIZED_OS_ID, + LinuxDistribution, + __version__, + build_number, + codename, + distro_release_attr, + distro_release_info, + id, + info, + like, + linux_distribution, + lsb_release_attr, + lsb_release_info, + major_version, + minor_version, + name, + os_release_attr, + os_release_info, + uname_attr, + uname_info, + version, + version_parts, +) + +__all__ = [ + "NORMALIZED_DISTRO_ID", + "NORMALIZED_LSB_ID", + "NORMALIZED_OS_ID", + "LinuxDistribution", + "build_number", + "codename", + "distro_release_attr", + "distro_release_info", + "id", + "info", + "like", + "linux_distribution", + "lsb_release_attr", + "lsb_release_info", + "major_version", + "minor_version", + "name", + "os_release_attr", + "os_release_info", + "uname_attr", + "uname_info", + "version", + "version_parts", +] + +__version__ = __version__ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/distro/__main__.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/distro/__main__.py new file mode 100644 index 0000000..0c01d5b --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/distro/__main__.py @@ -0,0 +1,4 @@ +from .distro import main + +if __name__ == "__main__": + main() diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/distro/__pycache__/__init__.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/distro/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000..b3f5202 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/distro/__pycache__/__init__.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/distro/__pycache__/__main__.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/distro/__pycache__/__main__.cpython-312.pyc new file mode 100644 index 0000000..33a3efa Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/distro/__pycache__/__main__.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/distro/__pycache__/distro.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/distro/__pycache__/distro.cpython-312.pyc new file mode 100644 index 0000000..8eb2a90 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/distro/__pycache__/distro.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/distro/distro.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/distro/distro.py new file mode 100644 index 0000000..78ccdfa --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/distro/distro.py @@ -0,0 +1,1403 @@ +#!/usr/bin/env python +# Copyright 2015-2021 Nir Cohen +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. + +""" +The ``distro`` package (``distro`` stands for Linux Distribution) provides +information about the Linux distribution it runs on, such as a reliable +machine-readable distro ID, or version information. + +It is the recommended replacement for Python's original +:py:func:`platform.linux_distribution` function, but it provides much more +functionality. An alternative implementation became necessary because Python +3.5 deprecated this function, and Python 3.8 removed it altogether. Its +predecessor function :py:func:`platform.dist` was already deprecated since +Python 2.6 and removed in Python 3.8. Still, there are many cases in which +access to OS distribution information is needed. See `Python issue 1322 +`_ for more information. +""" + +import argparse +import json +import logging +import os +import re +import shlex +import subprocess +import sys +import warnings +from typing import ( + Any, + Callable, + Dict, + Iterable, + Optional, + Sequence, + TextIO, + Tuple, + Type, +) + +try: + from typing import TypedDict +except ImportError: + # Python 3.7 + TypedDict = dict + +__version__ = "1.9.0" + + +class VersionDict(TypedDict): + major: str + minor: str + build_number: str + + +class InfoDict(TypedDict): + id: str + version: str + version_parts: VersionDict + like: str + codename: str + + +_UNIXCONFDIR = os.environ.get("UNIXCONFDIR", "/etc") +_UNIXUSRLIBDIR = os.environ.get("UNIXUSRLIBDIR", "/usr/lib") +_OS_RELEASE_BASENAME = "os-release" + +#: Translation table for normalizing the "ID" attribute defined in os-release +#: files, for use by the :func:`distro.id` method. +#: +#: * Key: Value as defined in the os-release file, translated to lower case, +#: with blanks translated to underscores. +#: +#: * Value: Normalized value. +NORMALIZED_OS_ID = { + "ol": "oracle", # Oracle Linux + "opensuse-leap": "opensuse", # Newer versions of OpenSuSE report as opensuse-leap +} + +#: Translation table for normalizing the "Distributor ID" attribute returned by +#: the lsb_release command, for use by the :func:`distro.id` method. +#: +#: * Key: Value as returned by the lsb_release command, translated to lower +#: case, with blanks translated to underscores. +#: +#: * Value: Normalized value. +NORMALIZED_LSB_ID = { + "enterpriseenterpriseas": "oracle", # Oracle Enterprise Linux 4 + "enterpriseenterpriseserver": "oracle", # Oracle Linux 5 + "redhatenterpriseworkstation": "rhel", # RHEL 6, 7 Workstation + "redhatenterpriseserver": "rhel", # RHEL 6, 7 Server + "redhatenterprisecomputenode": "rhel", # RHEL 6 ComputeNode +} + +#: Translation table for normalizing the distro ID derived from the file name +#: of distro release files, for use by the :func:`distro.id` method. +#: +#: * Key: Value as derived from the file name of a distro release file, +#: translated to lower case, with blanks translated to underscores. +#: +#: * Value: Normalized value. +NORMALIZED_DISTRO_ID = { + "redhat": "rhel", # RHEL 6.x, 7.x +} + +# Pattern for content of distro release file (reversed) +_DISTRO_RELEASE_CONTENT_REVERSED_PATTERN = re.compile( + r"(?:[^)]*\)(.*)\()? *(?:STL )?([\d.+\-a-z]*\d) *(?:esaeler *)?(.+)" +) + +# Pattern for base file name of distro release file +_DISTRO_RELEASE_BASENAME_PATTERN = re.compile(r"(\w+)[-_](release|version)$") + +# Base file names to be looked up for if _UNIXCONFDIR is not readable. +_DISTRO_RELEASE_BASENAMES = [ + "SuSE-release", + "altlinux-release", + "arch-release", + "base-release", + "centos-release", + "fedora-release", + "gentoo-release", + "mageia-release", + "mandrake-release", + "mandriva-release", + "mandrivalinux-release", + "manjaro-release", + "oracle-release", + "redhat-release", + "rocky-release", + "sl-release", + "slackware-version", +] + +# Base file names to be ignored when searching for distro release file +_DISTRO_RELEASE_IGNORE_BASENAMES = ( + "debian_version", + "lsb-release", + "oem-release", + _OS_RELEASE_BASENAME, + "system-release", + "plesk-release", + "iredmail-release", + "board-release", + "ec2_version", +) + + +def linux_distribution(full_distribution_name: bool = True) -> Tuple[str, str, str]: + """ + .. deprecated:: 1.6.0 + + :func:`distro.linux_distribution()` is deprecated. It should only be + used as a compatibility shim with Python's + :py:func:`platform.linux_distribution()`. Please use :func:`distro.id`, + :func:`distro.version` and :func:`distro.name` instead. + + Return information about the current OS distribution as a tuple + ``(id_name, version, codename)`` with items as follows: + + * ``id_name``: If *full_distribution_name* is false, the result of + :func:`distro.id`. Otherwise, the result of :func:`distro.name`. + + * ``version``: The result of :func:`distro.version`. + + * ``codename``: The extra item (usually in parentheses) after the + os-release version number, or the result of :func:`distro.codename`. + + The interface of this function is compatible with the original + :py:func:`platform.linux_distribution` function, supporting a subset of + its parameters. + + The data it returns may not exactly be the same, because it uses more data + sources than the original function, and that may lead to different data if + the OS distribution is not consistent across multiple data sources it + provides (there are indeed such distributions ...). + + Another reason for differences is the fact that the :func:`distro.id` + method normalizes the distro ID string to a reliable machine-readable value + for a number of popular OS distributions. + """ + warnings.warn( + "distro.linux_distribution() is deprecated. It should only be used as a " + "compatibility shim with Python's platform.linux_distribution(). Please use " + "distro.id(), distro.version() and distro.name() instead.", + DeprecationWarning, + stacklevel=2, + ) + return _distro.linux_distribution(full_distribution_name) + + +def id() -> str: + """ + Return the distro ID of the current distribution, as a + machine-readable string. + + For a number of OS distributions, the returned distro ID value is + *reliable*, in the sense that it is documented and that it does not change + across releases of the distribution. + + This package maintains the following reliable distro ID values: + + ============== ========================================= + Distro ID Distribution + ============== ========================================= + "ubuntu" Ubuntu + "debian" Debian + "rhel" RedHat Enterprise Linux + "centos" CentOS + "fedora" Fedora + "sles" SUSE Linux Enterprise Server + "opensuse" openSUSE + "amzn" Amazon Linux + "arch" Arch Linux + "buildroot" Buildroot + "cloudlinux" CloudLinux OS + "exherbo" Exherbo Linux + "gentoo" GenToo Linux + "ibm_powerkvm" IBM PowerKVM + "kvmibm" KVM for IBM z Systems + "linuxmint" Linux Mint + "mageia" Mageia + "mandriva" Mandriva Linux + "parallels" Parallels + "pidora" Pidora + "raspbian" Raspbian + "oracle" Oracle Linux (and Oracle Enterprise Linux) + "scientific" Scientific Linux + "slackware" Slackware + "xenserver" XenServer + "openbsd" OpenBSD + "netbsd" NetBSD + "freebsd" FreeBSD + "midnightbsd" MidnightBSD + "rocky" Rocky Linux + "aix" AIX + "guix" Guix System + "altlinux" ALT Linux + ============== ========================================= + + If you have a need to get distros for reliable IDs added into this set, + or if you find that the :func:`distro.id` function returns a different + distro ID for one of the listed distros, please create an issue in the + `distro issue tracker`_. + + **Lookup hierarchy and transformations:** + + First, the ID is obtained from the following sources, in the specified + order. The first available and non-empty value is used: + + * the value of the "ID" attribute of the os-release file, + + * the value of the "Distributor ID" attribute returned by the lsb_release + command, + + * the first part of the file name of the distro release file, + + The so determined ID value then passes the following transformations, + before it is returned by this method: + + * it is translated to lower case, + + * blanks (which should not be there anyway) are translated to underscores, + + * a normalization of the ID is performed, based upon + `normalization tables`_. The purpose of this normalization is to ensure + that the ID is as reliable as possible, even across incompatible changes + in the OS distributions. A common reason for an incompatible change is + the addition of an os-release file, or the addition of the lsb_release + command, with ID values that differ from what was previously determined + from the distro release file name. + """ + return _distro.id() + + +def name(pretty: bool = False) -> str: + """ + Return the name of the current OS distribution, as a human-readable + string. + + If *pretty* is false, the name is returned without version or codename. + (e.g. "CentOS Linux") + + If *pretty* is true, the version and codename are appended. + (e.g. "CentOS Linux 7.1.1503 (Core)") + + **Lookup hierarchy:** + + The name is obtained from the following sources, in the specified order. + The first available and non-empty value is used: + + * If *pretty* is false: + + - the value of the "NAME" attribute of the os-release file, + + - the value of the "Distributor ID" attribute returned by the lsb_release + command, + + - the value of the "" field of the distro release file. + + * If *pretty* is true: + + - the value of the "PRETTY_NAME" attribute of the os-release file, + + - the value of the "Description" attribute returned by the lsb_release + command, + + - the value of the "" field of the distro release file, appended + with the value of the pretty version ("" and "" + fields) of the distro release file, if available. + """ + return _distro.name(pretty) + + +def version(pretty: bool = False, best: bool = False) -> str: + """ + Return the version of the current OS distribution, as a human-readable + string. + + If *pretty* is false, the version is returned without codename (e.g. + "7.0"). + + If *pretty* is true, the codename in parenthesis is appended, if the + codename is non-empty (e.g. "7.0 (Maipo)"). + + Some distributions provide version numbers with different precisions in + the different sources of distribution information. Examining the different + sources in a fixed priority order does not always yield the most precise + version (e.g. for Debian 8.2, or CentOS 7.1). + + Some other distributions may not provide this kind of information. In these + cases, an empty string would be returned. This behavior can be observed + with rolling releases distributions (e.g. Arch Linux). + + The *best* parameter can be used to control the approach for the returned + version: + + If *best* is false, the first non-empty version number in priority order of + the examined sources is returned. + + If *best* is true, the most precise version number out of all examined + sources is returned. + + **Lookup hierarchy:** + + In all cases, the version number is obtained from the following sources. + If *best* is false, this order represents the priority order: + + * the value of the "VERSION_ID" attribute of the os-release file, + * the value of the "Release" attribute returned by the lsb_release + command, + * the version number parsed from the "" field of the first line + of the distro release file, + * the version number parsed from the "PRETTY_NAME" attribute of the + os-release file, if it follows the format of the distro release files. + * the version number parsed from the "Description" attribute returned by + the lsb_release command, if it follows the format of the distro release + files. + """ + return _distro.version(pretty, best) + + +def version_parts(best: bool = False) -> Tuple[str, str, str]: + """ + Return the version of the current OS distribution as a tuple + ``(major, minor, build_number)`` with items as follows: + + * ``major``: The result of :func:`distro.major_version`. + + * ``minor``: The result of :func:`distro.minor_version`. + + * ``build_number``: The result of :func:`distro.build_number`. + + For a description of the *best* parameter, see the :func:`distro.version` + method. + """ + return _distro.version_parts(best) + + +def major_version(best: bool = False) -> str: + """ + Return the major version of the current OS distribution, as a string, + if provided. + Otherwise, the empty string is returned. The major version is the first + part of the dot-separated version string. + + For a description of the *best* parameter, see the :func:`distro.version` + method. + """ + return _distro.major_version(best) + + +def minor_version(best: bool = False) -> str: + """ + Return the minor version of the current OS distribution, as a string, + if provided. + Otherwise, the empty string is returned. The minor version is the second + part of the dot-separated version string. + + For a description of the *best* parameter, see the :func:`distro.version` + method. + """ + return _distro.minor_version(best) + + +def build_number(best: bool = False) -> str: + """ + Return the build number of the current OS distribution, as a string, + if provided. + Otherwise, the empty string is returned. The build number is the third part + of the dot-separated version string. + + For a description of the *best* parameter, see the :func:`distro.version` + method. + """ + return _distro.build_number(best) + + +def like() -> str: + """ + Return a space-separated list of distro IDs of distributions that are + closely related to the current OS distribution in regards to packaging + and programming interfaces, for example distributions the current + distribution is a derivative from. + + **Lookup hierarchy:** + + This information item is only provided by the os-release file. + For details, see the description of the "ID_LIKE" attribute in the + `os-release man page + `_. + """ + return _distro.like() + + +def codename() -> str: + """ + Return the codename for the release of the current OS distribution, + as a string. + + If the distribution does not have a codename, an empty string is returned. + + Note that the returned codename is not always really a codename. For + example, openSUSE returns "x86_64". This function does not handle such + cases in any special way and just returns the string it finds, if any. + + **Lookup hierarchy:** + + * the codename within the "VERSION" attribute of the os-release file, if + provided, + + * the value of the "Codename" attribute returned by the lsb_release + command, + + * the value of the "" field of the distro release file. + """ + return _distro.codename() + + +def info(pretty: bool = False, best: bool = False) -> InfoDict: + """ + Return certain machine-readable information items about the current OS + distribution in a dictionary, as shown in the following example: + + .. sourcecode:: python + + { + 'id': 'rhel', + 'version': '7.0', + 'version_parts': { + 'major': '7', + 'minor': '0', + 'build_number': '' + }, + 'like': 'fedora', + 'codename': 'Maipo' + } + + The dictionary structure and keys are always the same, regardless of which + information items are available in the underlying data sources. The values + for the various keys are as follows: + + * ``id``: The result of :func:`distro.id`. + + * ``version``: The result of :func:`distro.version`. + + * ``version_parts -> major``: The result of :func:`distro.major_version`. + + * ``version_parts -> minor``: The result of :func:`distro.minor_version`. + + * ``version_parts -> build_number``: The result of + :func:`distro.build_number`. + + * ``like``: The result of :func:`distro.like`. + + * ``codename``: The result of :func:`distro.codename`. + + For a description of the *pretty* and *best* parameters, see the + :func:`distro.version` method. + """ + return _distro.info(pretty, best) + + +def os_release_info() -> Dict[str, str]: + """ + Return a dictionary containing key-value pairs for the information items + from the os-release file data source of the current OS distribution. + + See `os-release file`_ for details about these information items. + """ + return _distro.os_release_info() + + +def lsb_release_info() -> Dict[str, str]: + """ + Return a dictionary containing key-value pairs for the information items + from the lsb_release command data source of the current OS distribution. + + See `lsb_release command output`_ for details about these information + items. + """ + return _distro.lsb_release_info() + + +def distro_release_info() -> Dict[str, str]: + """ + Return a dictionary containing key-value pairs for the information items + from the distro release file data source of the current OS distribution. + + See `distro release file`_ for details about these information items. + """ + return _distro.distro_release_info() + + +def uname_info() -> Dict[str, str]: + """ + Return a dictionary containing key-value pairs for the information items + from the distro release file data source of the current OS distribution. + """ + return _distro.uname_info() + + +def os_release_attr(attribute: str) -> str: + """ + Return a single named information item from the os-release file data source + of the current OS distribution. + + Parameters: + + * ``attribute`` (string): Key of the information item. + + Returns: + + * (string): Value of the information item, if the item exists. + The empty string, if the item does not exist. + + See `os-release file`_ for details about these information items. + """ + return _distro.os_release_attr(attribute) + + +def lsb_release_attr(attribute: str) -> str: + """ + Return a single named information item from the lsb_release command output + data source of the current OS distribution. + + Parameters: + + * ``attribute`` (string): Key of the information item. + + Returns: + + * (string): Value of the information item, if the item exists. + The empty string, if the item does not exist. + + See `lsb_release command output`_ for details about these information + items. + """ + return _distro.lsb_release_attr(attribute) + + +def distro_release_attr(attribute: str) -> str: + """ + Return a single named information item from the distro release file + data source of the current OS distribution. + + Parameters: + + * ``attribute`` (string): Key of the information item. + + Returns: + + * (string): Value of the information item, if the item exists. + The empty string, if the item does not exist. + + See `distro release file`_ for details about these information items. + """ + return _distro.distro_release_attr(attribute) + + +def uname_attr(attribute: str) -> str: + """ + Return a single named information item from the distro release file + data source of the current OS distribution. + + Parameters: + + * ``attribute`` (string): Key of the information item. + + Returns: + + * (string): Value of the information item, if the item exists. + The empty string, if the item does not exist. + """ + return _distro.uname_attr(attribute) + + +try: + from functools import cached_property +except ImportError: + # Python < 3.8 + class cached_property: # type: ignore + """A version of @property which caches the value. On access, it calls the + underlying function and sets the value in `__dict__` so future accesses + will not re-call the property. + """ + + def __init__(self, f: Callable[[Any], Any]) -> None: + self._fname = f.__name__ + self._f = f + + def __get__(self, obj: Any, owner: Type[Any]) -> Any: + assert obj is not None, f"call {self._fname} on an instance" + ret = obj.__dict__[self._fname] = self._f(obj) + return ret + + +class LinuxDistribution: + """ + Provides information about a OS distribution. + + This package creates a private module-global instance of this class with + default initialization arguments, that is used by the + `consolidated accessor functions`_ and `single source accessor functions`_. + By using default initialization arguments, that module-global instance + returns data about the current OS distribution (i.e. the distro this + package runs on). + + Normally, it is not necessary to create additional instances of this class. + However, in situations where control is needed over the exact data sources + that are used, instances of this class can be created with a specific + distro release file, or a specific os-release file, or without invoking the + lsb_release command. + """ + + def __init__( + self, + include_lsb: Optional[bool] = None, + os_release_file: str = "", + distro_release_file: str = "", + include_uname: Optional[bool] = None, + root_dir: Optional[str] = None, + include_oslevel: Optional[bool] = None, + ) -> None: + """ + The initialization method of this class gathers information from the + available data sources, and stores that in private instance attributes. + Subsequent access to the information items uses these private instance + attributes, so that the data sources are read only once. + + Parameters: + + * ``include_lsb`` (bool): Controls whether the + `lsb_release command output`_ is included as a data source. + + If the lsb_release command is not available in the program execution + path, the data source for the lsb_release command will be empty. + + * ``os_release_file`` (string): The path name of the + `os-release file`_ that is to be used as a data source. + + An empty string (the default) will cause the default path name to + be used (see `os-release file`_ for details). + + If the specified or defaulted os-release file does not exist, the + data source for the os-release file will be empty. + + * ``distro_release_file`` (string): The path name of the + `distro release file`_ that is to be used as a data source. + + An empty string (the default) will cause a default search algorithm + to be used (see `distro release file`_ for details). + + If the specified distro release file does not exist, or if no default + distro release file can be found, the data source for the distro + release file will be empty. + + * ``include_uname`` (bool): Controls whether uname command output is + included as a data source. If the uname command is not available in + the program execution path the data source for the uname command will + be empty. + + * ``root_dir`` (string): The absolute path to the root directory to use + to find distro-related information files. Note that ``include_*`` + parameters must not be enabled in combination with ``root_dir``. + + * ``include_oslevel`` (bool): Controls whether (AIX) oslevel command + output is included as a data source. If the oslevel command is not + available in the program execution path the data source will be + empty. + + Public instance attributes: + + * ``os_release_file`` (string): The path name of the + `os-release file`_ that is actually used as a data source. The + empty string if no distro release file is used as a data source. + + * ``distro_release_file`` (string): The path name of the + `distro release file`_ that is actually used as a data source. The + empty string if no distro release file is used as a data source. + + * ``include_lsb`` (bool): The result of the ``include_lsb`` parameter. + This controls whether the lsb information will be loaded. + + * ``include_uname`` (bool): The result of the ``include_uname`` + parameter. This controls whether the uname information will + be loaded. + + * ``include_oslevel`` (bool): The result of the ``include_oslevel`` + parameter. This controls whether (AIX) oslevel information will be + loaded. + + * ``root_dir`` (string): The result of the ``root_dir`` parameter. + The absolute path to the root directory to use to find distro-related + information files. + + Raises: + + * :py:exc:`ValueError`: Initialization parameters combination is not + supported. + + * :py:exc:`OSError`: Some I/O issue with an os-release file or distro + release file. + + * :py:exc:`UnicodeError`: A data source has unexpected characters or + uses an unexpected encoding. + """ + self.root_dir = root_dir + self.etc_dir = os.path.join(root_dir, "etc") if root_dir else _UNIXCONFDIR + self.usr_lib_dir = ( + os.path.join(root_dir, "usr/lib") if root_dir else _UNIXUSRLIBDIR + ) + + if os_release_file: + self.os_release_file = os_release_file + else: + etc_dir_os_release_file = os.path.join(self.etc_dir, _OS_RELEASE_BASENAME) + usr_lib_os_release_file = os.path.join( + self.usr_lib_dir, _OS_RELEASE_BASENAME + ) + + # NOTE: The idea is to respect order **and** have it set + # at all times for API backwards compatibility. + if os.path.isfile(etc_dir_os_release_file) or not os.path.isfile( + usr_lib_os_release_file + ): + self.os_release_file = etc_dir_os_release_file + else: + self.os_release_file = usr_lib_os_release_file + + self.distro_release_file = distro_release_file or "" # updated later + + is_root_dir_defined = root_dir is not None + if is_root_dir_defined and (include_lsb or include_uname or include_oslevel): + raise ValueError( + "Including subprocess data sources from specific root_dir is disallowed" + " to prevent false information" + ) + self.include_lsb = ( + include_lsb if include_lsb is not None else not is_root_dir_defined + ) + self.include_uname = ( + include_uname if include_uname is not None else not is_root_dir_defined + ) + self.include_oslevel = ( + include_oslevel if include_oslevel is not None else not is_root_dir_defined + ) + + def __repr__(self) -> str: + """Return repr of all info""" + return ( + "LinuxDistribution(" + "os_release_file={self.os_release_file!r}, " + "distro_release_file={self.distro_release_file!r}, " + "include_lsb={self.include_lsb!r}, " + "include_uname={self.include_uname!r}, " + "include_oslevel={self.include_oslevel!r}, " + "root_dir={self.root_dir!r}, " + "_os_release_info={self._os_release_info!r}, " + "_lsb_release_info={self._lsb_release_info!r}, " + "_distro_release_info={self._distro_release_info!r}, " + "_uname_info={self._uname_info!r}, " + "_oslevel_info={self._oslevel_info!r})".format(self=self) + ) + + def linux_distribution( + self, full_distribution_name: bool = True + ) -> Tuple[str, str, str]: + """ + Return information about the OS distribution that is compatible + with Python's :func:`platform.linux_distribution`, supporting a subset + of its parameters. + + For details, see :func:`distro.linux_distribution`. + """ + return ( + self.name() if full_distribution_name else self.id(), + self.version(), + self._os_release_info.get("release_codename") or self.codename(), + ) + + def id(self) -> str: + """Return the distro ID of the OS distribution, as a string. + + For details, see :func:`distro.id`. + """ + + def normalize(distro_id: str, table: Dict[str, str]) -> str: + distro_id = distro_id.lower().replace(" ", "_") + return table.get(distro_id, distro_id) + + distro_id = self.os_release_attr("id") + if distro_id: + return normalize(distro_id, NORMALIZED_OS_ID) + + distro_id = self.lsb_release_attr("distributor_id") + if distro_id: + return normalize(distro_id, NORMALIZED_LSB_ID) + + distro_id = self.distro_release_attr("id") + if distro_id: + return normalize(distro_id, NORMALIZED_DISTRO_ID) + + distro_id = self.uname_attr("id") + if distro_id: + return normalize(distro_id, NORMALIZED_DISTRO_ID) + + return "" + + def name(self, pretty: bool = False) -> str: + """ + Return the name of the OS distribution, as a string. + + For details, see :func:`distro.name`. + """ + name = ( + self.os_release_attr("name") + or self.lsb_release_attr("distributor_id") + or self.distro_release_attr("name") + or self.uname_attr("name") + ) + if pretty: + name = self.os_release_attr("pretty_name") or self.lsb_release_attr( + "description" + ) + if not name: + name = self.distro_release_attr("name") or self.uname_attr("name") + version = self.version(pretty=True) + if version: + name = f"{name} {version}" + return name or "" + + def version(self, pretty: bool = False, best: bool = False) -> str: + """ + Return the version of the OS distribution, as a string. + + For details, see :func:`distro.version`. + """ + versions = [ + self.os_release_attr("version_id"), + self.lsb_release_attr("release"), + self.distro_release_attr("version_id"), + self._parse_distro_release_content(self.os_release_attr("pretty_name")).get( + "version_id", "" + ), + self._parse_distro_release_content( + self.lsb_release_attr("description") + ).get("version_id", ""), + self.uname_attr("release"), + ] + if self.uname_attr("id").startswith("aix"): + # On AIX platforms, prefer oslevel command output. + versions.insert(0, self.oslevel_info()) + elif self.id() == "debian" or "debian" in self.like().split(): + # On Debian-like, add debian_version file content to candidates list. + versions.append(self._debian_version) + version = "" + if best: + # This algorithm uses the last version in priority order that has + # the best precision. If the versions are not in conflict, that + # does not matter; otherwise, using the last one instead of the + # first one might be considered a surprise. + for v in versions: + if v.count(".") > version.count(".") or version == "": + version = v + else: + for v in versions: + if v != "": + version = v + break + if pretty and version and self.codename(): + version = f"{version} ({self.codename()})" + return version + + def version_parts(self, best: bool = False) -> Tuple[str, str, str]: + """ + Return the version of the OS distribution, as a tuple of version + numbers. + + For details, see :func:`distro.version_parts`. + """ + version_str = self.version(best=best) + if version_str: + version_regex = re.compile(r"(\d+)\.?(\d+)?\.?(\d+)?") + matches = version_regex.match(version_str) + if matches: + major, minor, build_number = matches.groups() + return major, minor or "", build_number or "" + return "", "", "" + + def major_version(self, best: bool = False) -> str: + """ + Return the major version number of the current distribution. + + For details, see :func:`distro.major_version`. + """ + return self.version_parts(best)[0] + + def minor_version(self, best: bool = False) -> str: + """ + Return the minor version number of the current distribution. + + For details, see :func:`distro.minor_version`. + """ + return self.version_parts(best)[1] + + def build_number(self, best: bool = False) -> str: + """ + Return the build number of the current distribution. + + For details, see :func:`distro.build_number`. + """ + return self.version_parts(best)[2] + + def like(self) -> str: + """ + Return the IDs of distributions that are like the OS distribution. + + For details, see :func:`distro.like`. + """ + return self.os_release_attr("id_like") or "" + + def codename(self) -> str: + """ + Return the codename of the OS distribution. + + For details, see :func:`distro.codename`. + """ + try: + # Handle os_release specially since distros might purposefully set + # this to empty string to have no codename + return self._os_release_info["codename"] + except KeyError: + return ( + self.lsb_release_attr("codename") + or self.distro_release_attr("codename") + or "" + ) + + def info(self, pretty: bool = False, best: bool = False) -> InfoDict: + """ + Return certain machine-readable information about the OS + distribution. + + For details, see :func:`distro.info`. + """ + return InfoDict( + id=self.id(), + version=self.version(pretty, best), + version_parts=VersionDict( + major=self.major_version(best), + minor=self.minor_version(best), + build_number=self.build_number(best), + ), + like=self.like(), + codename=self.codename(), + ) + + def os_release_info(self) -> Dict[str, str]: + """ + Return a dictionary containing key-value pairs for the information + items from the os-release file data source of the OS distribution. + + For details, see :func:`distro.os_release_info`. + """ + return self._os_release_info + + def lsb_release_info(self) -> Dict[str, str]: + """ + Return a dictionary containing key-value pairs for the information + items from the lsb_release command data source of the OS + distribution. + + For details, see :func:`distro.lsb_release_info`. + """ + return self._lsb_release_info + + def distro_release_info(self) -> Dict[str, str]: + """ + Return a dictionary containing key-value pairs for the information + items from the distro release file data source of the OS + distribution. + + For details, see :func:`distro.distro_release_info`. + """ + return self._distro_release_info + + def uname_info(self) -> Dict[str, str]: + """ + Return a dictionary containing key-value pairs for the information + items from the uname command data source of the OS distribution. + + For details, see :func:`distro.uname_info`. + """ + return self._uname_info + + def oslevel_info(self) -> str: + """ + Return AIX' oslevel command output. + """ + return self._oslevel_info + + def os_release_attr(self, attribute: str) -> str: + """ + Return a single named information item from the os-release file data + source of the OS distribution. + + For details, see :func:`distro.os_release_attr`. + """ + return self._os_release_info.get(attribute, "") + + def lsb_release_attr(self, attribute: str) -> str: + """ + Return a single named information item from the lsb_release command + output data source of the OS distribution. + + For details, see :func:`distro.lsb_release_attr`. + """ + return self._lsb_release_info.get(attribute, "") + + def distro_release_attr(self, attribute: str) -> str: + """ + Return a single named information item from the distro release file + data source of the OS distribution. + + For details, see :func:`distro.distro_release_attr`. + """ + return self._distro_release_info.get(attribute, "") + + def uname_attr(self, attribute: str) -> str: + """ + Return a single named information item from the uname command + output data source of the OS distribution. + + For details, see :func:`distro.uname_attr`. + """ + return self._uname_info.get(attribute, "") + + @cached_property + def _os_release_info(self) -> Dict[str, str]: + """ + Get the information items from the specified os-release file. + + Returns: + A dictionary containing all information items. + """ + if os.path.isfile(self.os_release_file): + with open(self.os_release_file, encoding="utf-8") as release_file: + return self._parse_os_release_content(release_file) + return {} + + @staticmethod + def _parse_os_release_content(lines: TextIO) -> Dict[str, str]: + """ + Parse the lines of an os-release file. + + Parameters: + + * lines: Iterable through the lines in the os-release file. + Each line must be a unicode string or a UTF-8 encoded byte + string. + + Returns: + A dictionary containing all information items. + """ + props = {} + lexer = shlex.shlex(lines, posix=True) + lexer.whitespace_split = True + + tokens = list(lexer) + for token in tokens: + # At this point, all shell-like parsing has been done (i.e. + # comments processed, quotes and backslash escape sequences + # processed, multi-line values assembled, trailing newlines + # stripped, etc.), so the tokens are now either: + # * variable assignments: var=value + # * commands or their arguments (not allowed in os-release) + # Ignore any tokens that are not variable assignments + if "=" in token: + k, v = token.split("=", 1) + props[k.lower()] = v + + if "version" in props: + # extract release codename (if any) from version attribute + match = re.search(r"\((\D+)\)|,\s*(\D+)", props["version"]) + if match: + release_codename = match.group(1) or match.group(2) + props["codename"] = props["release_codename"] = release_codename + + if "version_codename" in props: + # os-release added a version_codename field. Use that in + # preference to anything else Note that some distros purposefully + # do not have code names. They should be setting + # version_codename="" + props["codename"] = props["version_codename"] + elif "ubuntu_codename" in props: + # Same as above but a non-standard field name used on older Ubuntus + props["codename"] = props["ubuntu_codename"] + + return props + + @cached_property + def _lsb_release_info(self) -> Dict[str, str]: + """ + Get the information items from the lsb_release command output. + + Returns: + A dictionary containing all information items. + """ + if not self.include_lsb: + return {} + try: + cmd = ("lsb_release", "-a") + stdout = subprocess.check_output(cmd, stderr=subprocess.DEVNULL) + # Command not found or lsb_release returned error + except (OSError, subprocess.CalledProcessError): + return {} + content = self._to_str(stdout).splitlines() + return self._parse_lsb_release_content(content) + + @staticmethod + def _parse_lsb_release_content(lines: Iterable[str]) -> Dict[str, str]: + """ + Parse the output of the lsb_release command. + + Parameters: + + * lines: Iterable through the lines of the lsb_release output. + Each line must be a unicode string or a UTF-8 encoded byte + string. + + Returns: + A dictionary containing all information items. + """ + props = {} + for line in lines: + kv = line.strip("\n").split(":", 1) + if len(kv) != 2: + # Ignore lines without colon. + continue + k, v = kv + props.update({k.replace(" ", "_").lower(): v.strip()}) + return props + + @cached_property + def _uname_info(self) -> Dict[str, str]: + if not self.include_uname: + return {} + try: + cmd = ("uname", "-rs") + stdout = subprocess.check_output(cmd, stderr=subprocess.DEVNULL) + except OSError: + return {} + content = self._to_str(stdout).splitlines() + return self._parse_uname_content(content) + + @cached_property + def _oslevel_info(self) -> str: + if not self.include_oslevel: + return "" + try: + stdout = subprocess.check_output("oslevel", stderr=subprocess.DEVNULL) + except (OSError, subprocess.CalledProcessError): + return "" + return self._to_str(stdout).strip() + + @cached_property + def _debian_version(self) -> str: + try: + with open( + os.path.join(self.etc_dir, "debian_version"), encoding="ascii" + ) as fp: + return fp.readline().rstrip() + except FileNotFoundError: + return "" + + @staticmethod + def _parse_uname_content(lines: Sequence[str]) -> Dict[str, str]: + if not lines: + return {} + props = {} + match = re.search(r"^([^\s]+)\s+([\d\.]+)", lines[0].strip()) + if match: + name, version = match.groups() + + # This is to prevent the Linux kernel version from + # appearing as the 'best' version on otherwise + # identifiable distributions. + if name == "Linux": + return {} + props["id"] = name.lower() + props["name"] = name + props["release"] = version + return props + + @staticmethod + def _to_str(bytestring: bytes) -> str: + encoding = sys.getfilesystemencoding() + return bytestring.decode(encoding) + + @cached_property + def _distro_release_info(self) -> Dict[str, str]: + """ + Get the information items from the specified distro release file. + + Returns: + A dictionary containing all information items. + """ + if self.distro_release_file: + # If it was specified, we use it and parse what we can, even if + # its file name or content does not match the expected pattern. + distro_info = self._parse_distro_release_file(self.distro_release_file) + basename = os.path.basename(self.distro_release_file) + # The file name pattern for user-specified distro release files + # is somewhat more tolerant (compared to when searching for the + # file), because we want to use what was specified as best as + # possible. + match = _DISTRO_RELEASE_BASENAME_PATTERN.match(basename) + else: + try: + basenames = [ + basename + for basename in os.listdir(self.etc_dir) + if basename not in _DISTRO_RELEASE_IGNORE_BASENAMES + and os.path.isfile(os.path.join(self.etc_dir, basename)) + ] + # We sort for repeatability in cases where there are multiple + # distro specific files; e.g. CentOS, Oracle, Enterprise all + # containing `redhat-release` on top of their own. + basenames.sort() + except OSError: + # This may occur when /etc is not readable but we can't be + # sure about the *-release files. Check common entries of + # /etc for information. If they turn out to not be there the + # error is handled in `_parse_distro_release_file()`. + basenames = _DISTRO_RELEASE_BASENAMES + for basename in basenames: + match = _DISTRO_RELEASE_BASENAME_PATTERN.match(basename) + if match is None: + continue + filepath = os.path.join(self.etc_dir, basename) + distro_info = self._parse_distro_release_file(filepath) + # The name is always present if the pattern matches. + if "name" not in distro_info: + continue + self.distro_release_file = filepath + break + else: # the loop didn't "break": no candidate. + return {} + + if match is not None: + distro_info["id"] = match.group(1) + + # CloudLinux < 7: manually enrich info with proper id. + if "cloudlinux" in distro_info.get("name", "").lower(): + distro_info["id"] = "cloudlinux" + + return distro_info + + def _parse_distro_release_file(self, filepath: str) -> Dict[str, str]: + """ + Parse a distro release file. + + Parameters: + + * filepath: Path name of the distro release file. + + Returns: + A dictionary containing all information items. + """ + try: + with open(filepath, encoding="utf-8") as fp: + # Only parse the first line. For instance, on SLES there + # are multiple lines. We don't want them... + return self._parse_distro_release_content(fp.readline()) + except OSError: + # Ignore not being able to read a specific, seemingly version + # related file. + # See https://github.com/python-distro/distro/issues/162 + return {} + + @staticmethod + def _parse_distro_release_content(line: str) -> Dict[str, str]: + """ + Parse a line from a distro release file. + + Parameters: + * line: Line from the distro release file. Must be a unicode string + or a UTF-8 encoded byte string. + + Returns: + A dictionary containing all information items. + """ + matches = _DISTRO_RELEASE_CONTENT_REVERSED_PATTERN.match(line.strip()[::-1]) + distro_info = {} + if matches: + # regexp ensures non-None + distro_info["name"] = matches.group(3)[::-1] + if matches.group(2): + distro_info["version_id"] = matches.group(2)[::-1] + if matches.group(1): + distro_info["codename"] = matches.group(1)[::-1] + elif line: + distro_info["name"] = line.strip() + return distro_info + + +_distro = LinuxDistribution() + + +def main() -> None: + logger = logging.getLogger(__name__) + logger.setLevel(logging.DEBUG) + logger.addHandler(logging.StreamHandler(sys.stdout)) + + parser = argparse.ArgumentParser(description="OS distro info tool") + parser.add_argument( + "--json", "-j", help="Output in machine readable format", action="store_true" + ) + + parser.add_argument( + "--root-dir", + "-r", + type=str, + dest="root_dir", + help="Path to the root filesystem directory (defaults to /)", + ) + + args = parser.parse_args() + + if args.root_dir: + dist = LinuxDistribution( + include_lsb=False, + include_uname=False, + include_oslevel=False, + root_dir=args.root_dir, + ) + else: + dist = _distro + + if args.json: + logger.info(json.dumps(dist.info(), indent=4, sort_keys=True)) + else: + logger.info("Name: %s", dist.name(pretty=True)) + distribution_version = dist.version(pretty=True) + logger.info("Version: %s", distribution_version) + distribution_codename = dist.codename() + logger.info("Codename: %s", distribution_codename) + + +if __name__ == "__main__": + main() diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/distro/py.typed b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/distro/py.typed new file mode 100644 index 0000000..e69de29 diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/idna/__init__.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/idna/__init__.py new file mode 100644 index 0000000..cfdc030 --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/idna/__init__.py @@ -0,0 +1,45 @@ +from .core import ( + IDNABidiError, + IDNAError, + InvalidCodepoint, + InvalidCodepointContext, + alabel, + check_bidi, + check_hyphen_ok, + check_initial_combiner, + check_label, + check_nfc, + decode, + encode, + ulabel, + uts46_remap, + valid_contextj, + valid_contexto, + valid_label_length, + valid_string_length, +) +from .intranges import intranges_contain +from .package_data import __version__ + +__all__ = [ + "__version__", + "IDNABidiError", + "IDNAError", + "InvalidCodepoint", + "InvalidCodepointContext", + "alabel", + "check_bidi", + "check_hyphen_ok", + "check_initial_combiner", + "check_label", + "check_nfc", + "decode", + "encode", + "intranges_contain", + "ulabel", + "uts46_remap", + "valid_contextj", + "valid_contexto", + "valid_label_length", + "valid_string_length", +] diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/idna/__pycache__/__init__.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/idna/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000..f2aa9de Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/idna/__pycache__/__init__.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/idna/__pycache__/codec.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/idna/__pycache__/codec.cpython-312.pyc new file mode 100644 index 0000000..42f4975 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/idna/__pycache__/codec.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/idna/__pycache__/compat.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/idna/__pycache__/compat.cpython-312.pyc new file mode 100644 index 0000000..275c9cc Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/idna/__pycache__/compat.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/idna/__pycache__/core.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/idna/__pycache__/core.cpython-312.pyc new file mode 100644 index 0000000..45fac1a Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/idna/__pycache__/core.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/idna/__pycache__/idnadata.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/idna/__pycache__/idnadata.cpython-312.pyc new file mode 100644 index 0000000..cf07093 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/idna/__pycache__/idnadata.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/idna/__pycache__/intranges.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/idna/__pycache__/intranges.cpython-312.pyc new file mode 100644 index 0000000..1942917 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/idna/__pycache__/intranges.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/idna/__pycache__/package_data.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/idna/__pycache__/package_data.cpython-312.pyc new file mode 100644 index 0000000..f80ecc0 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/idna/__pycache__/package_data.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/idna/__pycache__/uts46data.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/idna/__pycache__/uts46data.cpython-312.pyc new file mode 100644 index 0000000..3e964a0 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/idna/__pycache__/uts46data.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/idna/codec.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/idna/codec.py new file mode 100644 index 0000000..913abfd --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/idna/codec.py @@ -0,0 +1,122 @@ +import codecs +import re +from typing import Any, Optional, Tuple + +from .core import IDNAError, alabel, decode, encode, ulabel + +_unicode_dots_re = re.compile("[\u002e\u3002\uff0e\uff61]") + + +class Codec(codecs.Codec): + def encode(self, data: str, errors: str = "strict") -> Tuple[bytes, int]: + if errors != "strict": + raise IDNAError('Unsupported error handling "{}"'.format(errors)) + + if not data: + return b"", 0 + + return encode(data), len(data) + + def decode(self, data: bytes, errors: str = "strict") -> Tuple[str, int]: + if errors != "strict": + raise IDNAError('Unsupported error handling "{}"'.format(errors)) + + if not data: + return "", 0 + + return decode(data), len(data) + + +class IncrementalEncoder(codecs.BufferedIncrementalEncoder): + def _buffer_encode(self, data: str, errors: str, final: bool) -> Tuple[bytes, int]: + if errors != "strict": + raise IDNAError('Unsupported error handling "{}"'.format(errors)) + + if not data: + return b"", 0 + + labels = _unicode_dots_re.split(data) + trailing_dot = b"" + if labels: + if not labels[-1]: + trailing_dot = b"." + del labels[-1] + elif not final: + # Keep potentially unfinished label until the next call + del labels[-1] + if labels: + trailing_dot = b"." + + result = [] + size = 0 + for label in labels: + result.append(alabel(label)) + if size: + size += 1 + size += len(label) + + # Join with U+002E + result_bytes = b".".join(result) + trailing_dot + size += len(trailing_dot) + return result_bytes, size + + +class IncrementalDecoder(codecs.BufferedIncrementalDecoder): + def _buffer_decode(self, data: Any, errors: str, final: bool) -> Tuple[str, int]: + if errors != "strict": + raise IDNAError('Unsupported error handling "{}"'.format(errors)) + + if not data: + return ("", 0) + + if not isinstance(data, str): + data = str(data, "ascii") + + labels = _unicode_dots_re.split(data) + trailing_dot = "" + if labels: + if not labels[-1]: + trailing_dot = "." + del labels[-1] + elif not final: + # Keep potentially unfinished label until the next call + del labels[-1] + if labels: + trailing_dot = "." + + result = [] + size = 0 + for label in labels: + result.append(ulabel(label)) + if size: + size += 1 + size += len(label) + + result_str = ".".join(result) + trailing_dot + size += len(trailing_dot) + return (result_str, size) + + +class StreamWriter(Codec, codecs.StreamWriter): + pass + + +class StreamReader(Codec, codecs.StreamReader): + pass + + +def search_function(name: str) -> Optional[codecs.CodecInfo]: + if name != "idna2008": + return None + return codecs.CodecInfo( + name=name, + encode=Codec().encode, + decode=Codec().decode, + incrementalencoder=IncrementalEncoder, + incrementaldecoder=IncrementalDecoder, + streamwriter=StreamWriter, + streamreader=StreamReader, + ) + + +codecs.register(search_function) diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/idna/compat.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/idna/compat.py new file mode 100644 index 0000000..1df9f2a --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/idna/compat.py @@ -0,0 +1,15 @@ +from typing import Any, Union + +from .core import decode, encode + + +def ToASCII(label: str) -> bytes: + return encode(label) + + +def ToUnicode(label: Union[bytes, bytearray]) -> str: + return decode(label) + + +def nameprep(s: Any) -> None: + raise NotImplementedError("IDNA 2008 does not utilise nameprep protocol") diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/idna/core.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/idna/core.py new file mode 100644 index 0000000..9115f12 --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/idna/core.py @@ -0,0 +1,437 @@ +import bisect +import re +import unicodedata +from typing import Optional, Union + +from . import idnadata +from .intranges import intranges_contain + +_virama_combining_class = 9 +_alabel_prefix = b"xn--" +_unicode_dots_re = re.compile("[\u002e\u3002\uff0e\uff61]") + + +class IDNAError(UnicodeError): + """Base exception for all IDNA-encoding related problems""" + + pass + + +class IDNABidiError(IDNAError): + """Exception when bidirectional requirements are not satisfied""" + + pass + + +class InvalidCodepoint(IDNAError): + """Exception when a disallowed or unallocated codepoint is used""" + + pass + + +class InvalidCodepointContext(IDNAError): + """Exception when the codepoint is not valid in the context it is used""" + + pass + + +def _combining_class(cp: int) -> int: + v = unicodedata.combining(chr(cp)) + if v == 0: + if not unicodedata.name(chr(cp)): + raise ValueError("Unknown character in unicodedata") + return v + + +def _is_script(cp: str, script: str) -> bool: + return intranges_contain(ord(cp), idnadata.scripts[script]) + + +def _punycode(s: str) -> bytes: + return s.encode("punycode") + + +def _unot(s: int) -> str: + return "U+{:04X}".format(s) + + +def valid_label_length(label: Union[bytes, str]) -> bool: + if len(label) > 63: + return False + return True + + +def valid_string_length(label: Union[bytes, str], trailing_dot: bool) -> bool: + if len(label) > (254 if trailing_dot else 253): + return False + return True + + +def check_bidi(label: str, check_ltr: bool = False) -> bool: + # Bidi rules should only be applied if string contains RTL characters + bidi_label = False + for idx, cp in enumerate(label, 1): + direction = unicodedata.bidirectional(cp) + if direction == "": + # String likely comes from a newer version of Unicode + raise IDNABidiError("Unknown directionality in label {} at position {}".format(repr(label), idx)) + if direction in ["R", "AL", "AN"]: + bidi_label = True + if not bidi_label and not check_ltr: + return True + + # Bidi rule 1 + direction = unicodedata.bidirectional(label[0]) + if direction in ["R", "AL"]: + rtl = True + elif direction == "L": + rtl = False + else: + raise IDNABidiError("First codepoint in label {} must be directionality L, R or AL".format(repr(label))) + + valid_ending = False + number_type: Optional[str] = None + for idx, cp in enumerate(label, 1): + direction = unicodedata.bidirectional(cp) + + if rtl: + # Bidi rule 2 + if direction not in [ + "R", + "AL", + "AN", + "EN", + "ES", + "CS", + "ET", + "ON", + "BN", + "NSM", + ]: + raise IDNABidiError("Invalid direction for codepoint at position {} in a right-to-left label".format(idx)) + # Bidi rule 3 + if direction in ["R", "AL", "EN", "AN"]: + valid_ending = True + elif direction != "NSM": + valid_ending = False + # Bidi rule 4 + if direction in ["AN", "EN"]: + if not number_type: + number_type = direction + else: + if number_type != direction: + raise IDNABidiError("Can not mix numeral types in a right-to-left label") + else: + # Bidi rule 5 + if direction not in ["L", "EN", "ES", "CS", "ET", "ON", "BN", "NSM"]: + raise IDNABidiError("Invalid direction for codepoint at position {} in a left-to-right label".format(idx)) + # Bidi rule 6 + if direction in ["L", "EN"]: + valid_ending = True + elif direction != "NSM": + valid_ending = False + + if not valid_ending: + raise IDNABidiError("Label ends with illegal codepoint directionality") + + return True + + +def check_initial_combiner(label: str) -> bool: + if unicodedata.category(label[0])[0] == "M": + raise IDNAError("Label begins with an illegal combining character") + return True + + +def check_hyphen_ok(label: str) -> bool: + if label[2:4] == "--": + raise IDNAError("Label has disallowed hyphens in 3rd and 4th position") + if label[0] == "-" or label[-1] == "-": + raise IDNAError("Label must not start or end with a hyphen") + return True + + +def check_nfc(label: str) -> None: + if unicodedata.normalize("NFC", label) != label: + raise IDNAError("Label must be in Normalization Form C") + + +def valid_contextj(label: str, pos: int) -> bool: + cp_value = ord(label[pos]) + + if cp_value == 0x200C: + if pos > 0: + if _combining_class(ord(label[pos - 1])) == _virama_combining_class: + return True + + ok = False + for i in range(pos - 1, -1, -1): + joining_type = idnadata.joining_types.get(ord(label[i])) + if joining_type == ord("T"): + continue + elif joining_type in [ord("L"), ord("D")]: + ok = True + break + else: + break + + if not ok: + return False + + ok = False + for i in range(pos + 1, len(label)): + joining_type = idnadata.joining_types.get(ord(label[i])) + if joining_type == ord("T"): + continue + elif joining_type in [ord("R"), ord("D")]: + ok = True + break + else: + break + return ok + + if cp_value == 0x200D: + if pos > 0: + if _combining_class(ord(label[pos - 1])) == _virama_combining_class: + return True + return False + + else: + return False + + +def valid_contexto(label: str, pos: int, exception: bool = False) -> bool: + cp_value = ord(label[pos]) + + if cp_value == 0x00B7: + if 0 < pos < len(label) - 1: + if ord(label[pos - 1]) == 0x006C and ord(label[pos + 1]) == 0x006C: + return True + return False + + elif cp_value == 0x0375: + if pos < len(label) - 1 and len(label) > 1: + return _is_script(label[pos + 1], "Greek") + return False + + elif cp_value == 0x05F3 or cp_value == 0x05F4: + if pos > 0: + return _is_script(label[pos - 1], "Hebrew") + return False + + elif cp_value == 0x30FB: + for cp in label: + if cp == "\u30fb": + continue + if _is_script(cp, "Hiragana") or _is_script(cp, "Katakana") or _is_script(cp, "Han"): + return True + return False + + elif 0x660 <= cp_value <= 0x669: + for cp in label: + if 0x6F0 <= ord(cp) <= 0x06F9: + return False + return True + + elif 0x6F0 <= cp_value <= 0x6F9: + for cp in label: + if 0x660 <= ord(cp) <= 0x0669: + return False + return True + + return False + + +def check_label(label: Union[str, bytes, bytearray]) -> None: + if isinstance(label, (bytes, bytearray)): + label = label.decode("utf-8") + if len(label) == 0: + raise IDNAError("Empty Label") + + check_nfc(label) + check_hyphen_ok(label) + check_initial_combiner(label) + + for pos, cp in enumerate(label): + cp_value = ord(cp) + if intranges_contain(cp_value, idnadata.codepoint_classes["PVALID"]): + continue + elif intranges_contain(cp_value, idnadata.codepoint_classes["CONTEXTJ"]): + try: + if not valid_contextj(label, pos): + raise InvalidCodepointContext( + "Joiner {} not allowed at position {} in {}".format(_unot(cp_value), pos + 1, repr(label)) + ) + except ValueError: + raise IDNAError( + "Unknown codepoint adjacent to joiner {} at position {} in {}".format( + _unot(cp_value), pos + 1, repr(label) + ) + ) + elif intranges_contain(cp_value, idnadata.codepoint_classes["CONTEXTO"]): + if not valid_contexto(label, pos): + raise InvalidCodepointContext( + "Codepoint {} not allowed at position {} in {}".format(_unot(cp_value), pos + 1, repr(label)) + ) + else: + raise InvalidCodepoint( + "Codepoint {} at position {} of {} not allowed".format(_unot(cp_value), pos + 1, repr(label)) + ) + + check_bidi(label) + + +def alabel(label: str) -> bytes: + try: + label_bytes = label.encode("ascii") + ulabel(label_bytes) + if not valid_label_length(label_bytes): + raise IDNAError("Label too long") + return label_bytes + except UnicodeEncodeError: + pass + + check_label(label) + label_bytes = _alabel_prefix + _punycode(label) + + if not valid_label_length(label_bytes): + raise IDNAError("Label too long") + + return label_bytes + + +def ulabel(label: Union[str, bytes, bytearray]) -> str: + if not isinstance(label, (bytes, bytearray)): + try: + label_bytes = label.encode("ascii") + except UnicodeEncodeError: + check_label(label) + return label + else: + label_bytes = label + + label_bytes = label_bytes.lower() + if label_bytes.startswith(_alabel_prefix): + label_bytes = label_bytes[len(_alabel_prefix) :] + if not label_bytes: + raise IDNAError("Malformed A-label, no Punycode eligible content found") + if label_bytes.decode("ascii")[-1] == "-": + raise IDNAError("A-label must not end with a hyphen") + else: + check_label(label_bytes) + return label_bytes.decode("ascii") + + try: + label = label_bytes.decode("punycode") + except UnicodeError: + raise IDNAError("Invalid A-label") + check_label(label) + return label + + +def uts46_remap(domain: str, std3_rules: bool = True, transitional: bool = False) -> str: + """Re-map the characters in the string according to UTS46 processing.""" + from .uts46data import uts46data + + output = "" + + for pos, char in enumerate(domain): + code_point = ord(char) + try: + uts46row = uts46data[code_point if code_point < 256 else bisect.bisect_left(uts46data, (code_point, "Z")) - 1] + status = uts46row[1] + replacement: Optional[str] = None + if len(uts46row) == 3: + replacement = uts46row[2] + if ( + status == "V" + or (status == "D" and not transitional) + or (status == "3" and not std3_rules and replacement is None) + ): + output += char + elif replacement is not None and ( + status == "M" or (status == "3" and not std3_rules) or (status == "D" and transitional) + ): + output += replacement + elif status != "I": + raise IndexError() + except IndexError: + raise InvalidCodepoint( + "Codepoint {} not allowed at position {} in {}".format(_unot(code_point), pos + 1, repr(domain)) + ) + + return unicodedata.normalize("NFC", output) + + +def encode( + s: Union[str, bytes, bytearray], + strict: bool = False, + uts46: bool = False, + std3_rules: bool = False, + transitional: bool = False, +) -> bytes: + if not isinstance(s, str): + try: + s = str(s, "ascii") + except UnicodeDecodeError: + raise IDNAError("should pass a unicode string to the function rather than a byte string.") + if uts46: + s = uts46_remap(s, std3_rules, transitional) + trailing_dot = False + result = [] + if strict: + labels = s.split(".") + else: + labels = _unicode_dots_re.split(s) + if not labels or labels == [""]: + raise IDNAError("Empty domain") + if labels[-1] == "": + del labels[-1] + trailing_dot = True + for label in labels: + s = alabel(label) + if s: + result.append(s) + else: + raise IDNAError("Empty label") + if trailing_dot: + result.append(b"") + s = b".".join(result) + if not valid_string_length(s, trailing_dot): + raise IDNAError("Domain too long") + return s + + +def decode( + s: Union[str, bytes, bytearray], + strict: bool = False, + uts46: bool = False, + std3_rules: bool = False, +) -> str: + try: + if not isinstance(s, str): + s = str(s, "ascii") + except UnicodeDecodeError: + raise IDNAError("Invalid ASCII in A-label") + if uts46: + s = uts46_remap(s, std3_rules, False) + trailing_dot = False + result = [] + if not strict: + labels = _unicode_dots_re.split(s) + else: + labels = s.split(".") + if not labels or labels == [""]: + raise IDNAError("Empty domain") + if not labels[-1]: + del labels[-1] + trailing_dot = True + for label in labels: + s = ulabel(label) + if s: + result.append(s) + else: + raise IDNAError("Empty label") + if trailing_dot: + result.append("") + return ".".join(result) diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/idna/idnadata.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/idna/idnadata.py new file mode 100644 index 0000000..4be6004 --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/idna/idnadata.py @@ -0,0 +1,4243 @@ +# This file is automatically generated by tools/idna-data + +__version__ = "15.1.0" +scripts = { + "Greek": ( + 0x37000000374, + 0x37500000378, + 0x37A0000037E, + 0x37F00000380, + 0x38400000385, + 0x38600000387, + 0x3880000038B, + 0x38C0000038D, + 0x38E000003A2, + 0x3A3000003E2, + 0x3F000000400, + 0x1D2600001D2B, + 0x1D5D00001D62, + 0x1D6600001D6B, + 0x1DBF00001DC0, + 0x1F0000001F16, + 0x1F1800001F1E, + 0x1F2000001F46, + 0x1F4800001F4E, + 0x1F5000001F58, + 0x1F5900001F5A, + 0x1F5B00001F5C, + 0x1F5D00001F5E, + 0x1F5F00001F7E, + 0x1F8000001FB5, + 0x1FB600001FC5, + 0x1FC600001FD4, + 0x1FD600001FDC, + 0x1FDD00001FF0, + 0x1FF200001FF5, + 0x1FF600001FFF, + 0x212600002127, + 0xAB650000AB66, + 0x101400001018F, + 0x101A0000101A1, + 0x1D2000001D246, + ), + "Han": ( + 0x2E8000002E9A, + 0x2E9B00002EF4, + 0x2F0000002FD6, + 0x300500003006, + 0x300700003008, + 0x30210000302A, + 0x30380000303C, + 0x340000004DC0, + 0x4E000000A000, + 0xF9000000FA6E, + 0xFA700000FADA, + 0x16FE200016FE4, + 0x16FF000016FF2, + 0x200000002A6E0, + 0x2A7000002B73A, + 0x2B7400002B81E, + 0x2B8200002CEA2, + 0x2CEB00002EBE1, + 0x2EBF00002EE5E, + 0x2F8000002FA1E, + 0x300000003134B, + 0x31350000323B0, + ), + "Hebrew": ( + 0x591000005C8, + 0x5D0000005EB, + 0x5EF000005F5, + 0xFB1D0000FB37, + 0xFB380000FB3D, + 0xFB3E0000FB3F, + 0xFB400000FB42, + 0xFB430000FB45, + 0xFB460000FB50, + ), + "Hiragana": ( + 0x304100003097, + 0x309D000030A0, + 0x1B0010001B120, + 0x1B1320001B133, + 0x1B1500001B153, + 0x1F2000001F201, + ), + "Katakana": ( + 0x30A1000030FB, + 0x30FD00003100, + 0x31F000003200, + 0x32D0000032FF, + 0x330000003358, + 0xFF660000FF70, + 0xFF710000FF9E, + 0x1AFF00001AFF4, + 0x1AFF50001AFFC, + 0x1AFFD0001AFFF, + 0x1B0000001B001, + 0x1B1200001B123, + 0x1B1550001B156, + 0x1B1640001B168, + ), +} +joining_types = { + 0xAD: 84, + 0x300: 84, + 0x301: 84, + 0x302: 84, + 0x303: 84, + 0x304: 84, + 0x305: 84, + 0x306: 84, + 0x307: 84, + 0x308: 84, + 0x309: 84, + 0x30A: 84, + 0x30B: 84, + 0x30C: 84, + 0x30D: 84, + 0x30E: 84, + 0x30F: 84, + 0x310: 84, + 0x311: 84, + 0x312: 84, + 0x313: 84, + 0x314: 84, + 0x315: 84, + 0x316: 84, + 0x317: 84, + 0x318: 84, + 0x319: 84, + 0x31A: 84, + 0x31B: 84, + 0x31C: 84, + 0x31D: 84, + 0x31E: 84, + 0x31F: 84, + 0x320: 84, + 0x321: 84, + 0x322: 84, + 0x323: 84, + 0x324: 84, + 0x325: 84, + 0x326: 84, + 0x327: 84, + 0x328: 84, + 0x329: 84, + 0x32A: 84, + 0x32B: 84, + 0x32C: 84, + 0x32D: 84, + 0x32E: 84, + 0x32F: 84, + 0x330: 84, + 0x331: 84, + 0x332: 84, + 0x333: 84, + 0x334: 84, + 0x335: 84, + 0x336: 84, + 0x337: 84, + 0x338: 84, + 0x339: 84, + 0x33A: 84, + 0x33B: 84, + 0x33C: 84, + 0x33D: 84, + 0x33E: 84, + 0x33F: 84, + 0x340: 84, + 0x341: 84, + 0x342: 84, + 0x343: 84, + 0x344: 84, + 0x345: 84, + 0x346: 84, + 0x347: 84, + 0x348: 84, + 0x349: 84, + 0x34A: 84, + 0x34B: 84, + 0x34C: 84, + 0x34D: 84, + 0x34E: 84, + 0x34F: 84, + 0x350: 84, + 0x351: 84, + 0x352: 84, + 0x353: 84, + 0x354: 84, + 0x355: 84, + 0x356: 84, + 0x357: 84, + 0x358: 84, + 0x359: 84, + 0x35A: 84, + 0x35B: 84, + 0x35C: 84, + 0x35D: 84, + 0x35E: 84, + 0x35F: 84, + 0x360: 84, + 0x361: 84, + 0x362: 84, + 0x363: 84, + 0x364: 84, + 0x365: 84, + 0x366: 84, + 0x367: 84, + 0x368: 84, + 0x369: 84, + 0x36A: 84, + 0x36B: 84, + 0x36C: 84, + 0x36D: 84, + 0x36E: 84, + 0x36F: 84, + 0x483: 84, + 0x484: 84, + 0x485: 84, + 0x486: 84, + 0x487: 84, + 0x488: 84, + 0x489: 84, + 0x591: 84, + 0x592: 84, + 0x593: 84, + 0x594: 84, + 0x595: 84, + 0x596: 84, + 0x597: 84, + 0x598: 84, + 0x599: 84, + 0x59A: 84, + 0x59B: 84, + 0x59C: 84, + 0x59D: 84, + 0x59E: 84, + 0x59F: 84, + 0x5A0: 84, + 0x5A1: 84, + 0x5A2: 84, + 0x5A3: 84, + 0x5A4: 84, + 0x5A5: 84, + 0x5A6: 84, + 0x5A7: 84, + 0x5A8: 84, + 0x5A9: 84, + 0x5AA: 84, + 0x5AB: 84, + 0x5AC: 84, + 0x5AD: 84, + 0x5AE: 84, + 0x5AF: 84, + 0x5B0: 84, + 0x5B1: 84, + 0x5B2: 84, + 0x5B3: 84, + 0x5B4: 84, + 0x5B5: 84, + 0x5B6: 84, + 0x5B7: 84, + 0x5B8: 84, + 0x5B9: 84, + 0x5BA: 84, + 0x5BB: 84, + 0x5BC: 84, + 0x5BD: 84, + 0x5BF: 84, + 0x5C1: 84, + 0x5C2: 84, + 0x5C4: 84, + 0x5C5: 84, + 0x5C7: 84, + 0x610: 84, + 0x611: 84, + 0x612: 84, + 0x613: 84, + 0x614: 84, + 0x615: 84, + 0x616: 84, + 0x617: 84, + 0x618: 84, + 0x619: 84, + 0x61A: 84, + 0x61C: 84, + 0x620: 68, + 0x622: 82, + 0x623: 82, + 0x624: 82, + 0x625: 82, + 0x626: 68, + 0x627: 82, + 0x628: 68, + 0x629: 82, + 0x62A: 68, + 0x62B: 68, + 0x62C: 68, + 0x62D: 68, + 0x62E: 68, + 0x62F: 82, + 0x630: 82, + 0x631: 82, + 0x632: 82, + 0x633: 68, + 0x634: 68, + 0x635: 68, + 0x636: 68, + 0x637: 68, + 0x638: 68, + 0x639: 68, + 0x63A: 68, + 0x63B: 68, + 0x63C: 68, + 0x63D: 68, + 0x63E: 68, + 0x63F: 68, + 0x640: 67, + 0x641: 68, + 0x642: 68, + 0x643: 68, + 0x644: 68, + 0x645: 68, + 0x646: 68, + 0x647: 68, + 0x648: 82, + 0x649: 68, + 0x64A: 68, + 0x64B: 84, + 0x64C: 84, + 0x64D: 84, + 0x64E: 84, + 0x64F: 84, + 0x650: 84, + 0x651: 84, + 0x652: 84, + 0x653: 84, + 0x654: 84, + 0x655: 84, + 0x656: 84, + 0x657: 84, + 0x658: 84, + 0x659: 84, + 0x65A: 84, + 0x65B: 84, + 0x65C: 84, + 0x65D: 84, + 0x65E: 84, + 0x65F: 84, + 0x66E: 68, + 0x66F: 68, + 0x670: 84, + 0x671: 82, + 0x672: 82, + 0x673: 82, + 0x675: 82, + 0x676: 82, + 0x677: 82, + 0x678: 68, + 0x679: 68, + 0x67A: 68, + 0x67B: 68, + 0x67C: 68, + 0x67D: 68, + 0x67E: 68, + 0x67F: 68, + 0x680: 68, + 0x681: 68, + 0x682: 68, + 0x683: 68, + 0x684: 68, + 0x685: 68, + 0x686: 68, + 0x687: 68, + 0x688: 82, + 0x689: 82, + 0x68A: 82, + 0x68B: 82, + 0x68C: 82, + 0x68D: 82, + 0x68E: 82, + 0x68F: 82, + 0x690: 82, + 0x691: 82, + 0x692: 82, + 0x693: 82, + 0x694: 82, + 0x695: 82, + 0x696: 82, + 0x697: 82, + 0x698: 82, + 0x699: 82, + 0x69A: 68, + 0x69B: 68, + 0x69C: 68, + 0x69D: 68, + 0x69E: 68, + 0x69F: 68, + 0x6A0: 68, + 0x6A1: 68, + 0x6A2: 68, + 0x6A3: 68, + 0x6A4: 68, + 0x6A5: 68, + 0x6A6: 68, + 0x6A7: 68, + 0x6A8: 68, + 0x6A9: 68, + 0x6AA: 68, + 0x6AB: 68, + 0x6AC: 68, + 0x6AD: 68, + 0x6AE: 68, + 0x6AF: 68, + 0x6B0: 68, + 0x6B1: 68, + 0x6B2: 68, + 0x6B3: 68, + 0x6B4: 68, + 0x6B5: 68, + 0x6B6: 68, + 0x6B7: 68, + 0x6B8: 68, + 0x6B9: 68, + 0x6BA: 68, + 0x6BB: 68, + 0x6BC: 68, + 0x6BD: 68, + 0x6BE: 68, + 0x6BF: 68, + 0x6C0: 82, + 0x6C1: 68, + 0x6C2: 68, + 0x6C3: 82, + 0x6C4: 82, + 0x6C5: 82, + 0x6C6: 82, + 0x6C7: 82, + 0x6C8: 82, + 0x6C9: 82, + 0x6CA: 82, + 0x6CB: 82, + 0x6CC: 68, + 0x6CD: 82, + 0x6CE: 68, + 0x6CF: 82, + 0x6D0: 68, + 0x6D1: 68, + 0x6D2: 82, + 0x6D3: 82, + 0x6D5: 82, + 0x6D6: 84, + 0x6D7: 84, + 0x6D8: 84, + 0x6D9: 84, + 0x6DA: 84, + 0x6DB: 84, + 0x6DC: 84, + 0x6DF: 84, + 0x6E0: 84, + 0x6E1: 84, + 0x6E2: 84, + 0x6E3: 84, + 0x6E4: 84, + 0x6E7: 84, + 0x6E8: 84, + 0x6EA: 84, + 0x6EB: 84, + 0x6EC: 84, + 0x6ED: 84, + 0x6EE: 82, + 0x6EF: 82, + 0x6FA: 68, + 0x6FB: 68, + 0x6FC: 68, + 0x6FF: 68, + 0x70F: 84, + 0x710: 82, + 0x711: 84, + 0x712: 68, + 0x713: 68, + 0x714: 68, + 0x715: 82, + 0x716: 82, + 0x717: 82, + 0x718: 82, + 0x719: 82, + 0x71A: 68, + 0x71B: 68, + 0x71C: 68, + 0x71D: 68, + 0x71E: 82, + 0x71F: 68, + 0x720: 68, + 0x721: 68, + 0x722: 68, + 0x723: 68, + 0x724: 68, + 0x725: 68, + 0x726: 68, + 0x727: 68, + 0x728: 82, + 0x729: 68, + 0x72A: 82, + 0x72B: 68, + 0x72C: 82, + 0x72D: 68, + 0x72E: 68, + 0x72F: 82, + 0x730: 84, + 0x731: 84, + 0x732: 84, + 0x733: 84, + 0x734: 84, + 0x735: 84, + 0x736: 84, + 0x737: 84, + 0x738: 84, + 0x739: 84, + 0x73A: 84, + 0x73B: 84, + 0x73C: 84, + 0x73D: 84, + 0x73E: 84, + 0x73F: 84, + 0x740: 84, + 0x741: 84, + 0x742: 84, + 0x743: 84, + 0x744: 84, + 0x745: 84, + 0x746: 84, + 0x747: 84, + 0x748: 84, + 0x749: 84, + 0x74A: 84, + 0x74D: 82, + 0x74E: 68, + 0x74F: 68, + 0x750: 68, + 0x751: 68, + 0x752: 68, + 0x753: 68, + 0x754: 68, + 0x755: 68, + 0x756: 68, + 0x757: 68, + 0x758: 68, + 0x759: 82, + 0x75A: 82, + 0x75B: 82, + 0x75C: 68, + 0x75D: 68, + 0x75E: 68, + 0x75F: 68, + 0x760: 68, + 0x761: 68, + 0x762: 68, + 0x763: 68, + 0x764: 68, + 0x765: 68, + 0x766: 68, + 0x767: 68, + 0x768: 68, + 0x769: 68, + 0x76A: 68, + 0x76B: 82, + 0x76C: 82, + 0x76D: 68, + 0x76E: 68, + 0x76F: 68, + 0x770: 68, + 0x771: 82, + 0x772: 68, + 0x773: 82, + 0x774: 82, + 0x775: 68, + 0x776: 68, + 0x777: 68, + 0x778: 82, + 0x779: 82, + 0x77A: 68, + 0x77B: 68, + 0x77C: 68, + 0x77D: 68, + 0x77E: 68, + 0x77F: 68, + 0x7A6: 84, + 0x7A7: 84, + 0x7A8: 84, + 0x7A9: 84, + 0x7AA: 84, + 0x7AB: 84, + 0x7AC: 84, + 0x7AD: 84, + 0x7AE: 84, + 0x7AF: 84, + 0x7B0: 84, + 0x7CA: 68, + 0x7CB: 68, + 0x7CC: 68, + 0x7CD: 68, + 0x7CE: 68, + 0x7CF: 68, + 0x7D0: 68, + 0x7D1: 68, + 0x7D2: 68, + 0x7D3: 68, + 0x7D4: 68, + 0x7D5: 68, + 0x7D6: 68, + 0x7D7: 68, + 0x7D8: 68, + 0x7D9: 68, + 0x7DA: 68, + 0x7DB: 68, + 0x7DC: 68, + 0x7DD: 68, + 0x7DE: 68, + 0x7DF: 68, + 0x7E0: 68, + 0x7E1: 68, + 0x7E2: 68, + 0x7E3: 68, + 0x7E4: 68, + 0x7E5: 68, + 0x7E6: 68, + 0x7E7: 68, + 0x7E8: 68, + 0x7E9: 68, + 0x7EA: 68, + 0x7EB: 84, + 0x7EC: 84, + 0x7ED: 84, + 0x7EE: 84, + 0x7EF: 84, + 0x7F0: 84, + 0x7F1: 84, + 0x7F2: 84, + 0x7F3: 84, + 0x7FA: 67, + 0x7FD: 84, + 0x816: 84, + 0x817: 84, + 0x818: 84, + 0x819: 84, + 0x81B: 84, + 0x81C: 84, + 0x81D: 84, + 0x81E: 84, + 0x81F: 84, + 0x820: 84, + 0x821: 84, + 0x822: 84, + 0x823: 84, + 0x825: 84, + 0x826: 84, + 0x827: 84, + 0x829: 84, + 0x82A: 84, + 0x82B: 84, + 0x82C: 84, + 0x82D: 84, + 0x840: 82, + 0x841: 68, + 0x842: 68, + 0x843: 68, + 0x844: 68, + 0x845: 68, + 0x846: 82, + 0x847: 82, + 0x848: 68, + 0x849: 82, + 0x84A: 68, + 0x84B: 68, + 0x84C: 68, + 0x84D: 68, + 0x84E: 68, + 0x84F: 68, + 0x850: 68, + 0x851: 68, + 0x852: 68, + 0x853: 68, + 0x854: 82, + 0x855: 68, + 0x856: 82, + 0x857: 82, + 0x858: 82, + 0x859: 84, + 0x85A: 84, + 0x85B: 84, + 0x860: 68, + 0x862: 68, + 0x863: 68, + 0x864: 68, + 0x865: 68, + 0x867: 82, + 0x868: 68, + 0x869: 82, + 0x86A: 82, + 0x870: 82, + 0x871: 82, + 0x872: 82, + 0x873: 82, + 0x874: 82, + 0x875: 82, + 0x876: 82, + 0x877: 82, + 0x878: 82, + 0x879: 82, + 0x87A: 82, + 0x87B: 82, + 0x87C: 82, + 0x87D: 82, + 0x87E: 82, + 0x87F: 82, + 0x880: 82, + 0x881: 82, + 0x882: 82, + 0x883: 67, + 0x884: 67, + 0x885: 67, + 0x886: 68, + 0x889: 68, + 0x88A: 68, + 0x88B: 68, + 0x88C: 68, + 0x88D: 68, + 0x88E: 82, + 0x898: 84, + 0x899: 84, + 0x89A: 84, + 0x89B: 84, + 0x89C: 84, + 0x89D: 84, + 0x89E: 84, + 0x89F: 84, + 0x8A0: 68, + 0x8A1: 68, + 0x8A2: 68, + 0x8A3: 68, + 0x8A4: 68, + 0x8A5: 68, + 0x8A6: 68, + 0x8A7: 68, + 0x8A8: 68, + 0x8A9: 68, + 0x8AA: 82, + 0x8AB: 82, + 0x8AC: 82, + 0x8AE: 82, + 0x8AF: 68, + 0x8B0: 68, + 0x8B1: 82, + 0x8B2: 82, + 0x8B3: 68, + 0x8B4: 68, + 0x8B5: 68, + 0x8B6: 68, + 0x8B7: 68, + 0x8B8: 68, + 0x8B9: 82, + 0x8BA: 68, + 0x8BB: 68, + 0x8BC: 68, + 0x8BD: 68, + 0x8BE: 68, + 0x8BF: 68, + 0x8C0: 68, + 0x8C1: 68, + 0x8C2: 68, + 0x8C3: 68, + 0x8C4: 68, + 0x8C5: 68, + 0x8C6: 68, + 0x8C7: 68, + 0x8C8: 68, + 0x8CA: 84, + 0x8CB: 84, + 0x8CC: 84, + 0x8CD: 84, + 0x8CE: 84, + 0x8CF: 84, + 0x8D0: 84, + 0x8D1: 84, + 0x8D2: 84, + 0x8D3: 84, + 0x8D4: 84, + 0x8D5: 84, + 0x8D6: 84, + 0x8D7: 84, + 0x8D8: 84, + 0x8D9: 84, + 0x8DA: 84, + 0x8DB: 84, + 0x8DC: 84, + 0x8DD: 84, + 0x8DE: 84, + 0x8DF: 84, + 0x8E0: 84, + 0x8E1: 84, + 0x8E3: 84, + 0x8E4: 84, + 0x8E5: 84, + 0x8E6: 84, + 0x8E7: 84, + 0x8E8: 84, + 0x8E9: 84, + 0x8EA: 84, + 0x8EB: 84, + 0x8EC: 84, + 0x8ED: 84, + 0x8EE: 84, + 0x8EF: 84, + 0x8F0: 84, + 0x8F1: 84, + 0x8F2: 84, + 0x8F3: 84, + 0x8F4: 84, + 0x8F5: 84, + 0x8F6: 84, + 0x8F7: 84, + 0x8F8: 84, + 0x8F9: 84, + 0x8FA: 84, + 0x8FB: 84, + 0x8FC: 84, + 0x8FD: 84, + 0x8FE: 84, + 0x8FF: 84, + 0x900: 84, + 0x901: 84, + 0x902: 84, + 0x93A: 84, + 0x93C: 84, + 0x941: 84, + 0x942: 84, + 0x943: 84, + 0x944: 84, + 0x945: 84, + 0x946: 84, + 0x947: 84, + 0x948: 84, + 0x94D: 84, + 0x951: 84, + 0x952: 84, + 0x953: 84, + 0x954: 84, + 0x955: 84, + 0x956: 84, + 0x957: 84, + 0x962: 84, + 0x963: 84, + 0x981: 84, + 0x9BC: 84, + 0x9C1: 84, + 0x9C2: 84, + 0x9C3: 84, + 0x9C4: 84, + 0x9CD: 84, + 0x9E2: 84, + 0x9E3: 84, + 0x9FE: 84, + 0xA01: 84, + 0xA02: 84, + 0xA3C: 84, + 0xA41: 84, + 0xA42: 84, + 0xA47: 84, + 0xA48: 84, + 0xA4B: 84, + 0xA4C: 84, + 0xA4D: 84, + 0xA51: 84, + 0xA70: 84, + 0xA71: 84, + 0xA75: 84, + 0xA81: 84, + 0xA82: 84, + 0xABC: 84, + 0xAC1: 84, + 0xAC2: 84, + 0xAC3: 84, + 0xAC4: 84, + 0xAC5: 84, + 0xAC7: 84, + 0xAC8: 84, + 0xACD: 84, + 0xAE2: 84, + 0xAE3: 84, + 0xAFA: 84, + 0xAFB: 84, + 0xAFC: 84, + 0xAFD: 84, + 0xAFE: 84, + 0xAFF: 84, + 0xB01: 84, + 0xB3C: 84, + 0xB3F: 84, + 0xB41: 84, + 0xB42: 84, + 0xB43: 84, + 0xB44: 84, + 0xB4D: 84, + 0xB55: 84, + 0xB56: 84, + 0xB62: 84, + 0xB63: 84, + 0xB82: 84, + 0xBC0: 84, + 0xBCD: 84, + 0xC00: 84, + 0xC04: 84, + 0xC3C: 84, + 0xC3E: 84, + 0xC3F: 84, + 0xC40: 84, + 0xC46: 84, + 0xC47: 84, + 0xC48: 84, + 0xC4A: 84, + 0xC4B: 84, + 0xC4C: 84, + 0xC4D: 84, + 0xC55: 84, + 0xC56: 84, + 0xC62: 84, + 0xC63: 84, + 0xC81: 84, + 0xCBC: 84, + 0xCBF: 84, + 0xCC6: 84, + 0xCCC: 84, + 0xCCD: 84, + 0xCE2: 84, + 0xCE3: 84, + 0xD00: 84, + 0xD01: 84, + 0xD3B: 84, + 0xD3C: 84, + 0xD41: 84, + 0xD42: 84, + 0xD43: 84, + 0xD44: 84, + 0xD4D: 84, + 0xD62: 84, + 0xD63: 84, + 0xD81: 84, + 0xDCA: 84, + 0xDD2: 84, + 0xDD3: 84, + 0xDD4: 84, + 0xDD6: 84, + 0xE31: 84, + 0xE34: 84, + 0xE35: 84, + 0xE36: 84, + 0xE37: 84, + 0xE38: 84, + 0xE39: 84, + 0xE3A: 84, + 0xE47: 84, + 0xE48: 84, + 0xE49: 84, + 0xE4A: 84, + 0xE4B: 84, + 0xE4C: 84, + 0xE4D: 84, + 0xE4E: 84, + 0xEB1: 84, + 0xEB4: 84, + 0xEB5: 84, + 0xEB6: 84, + 0xEB7: 84, + 0xEB8: 84, + 0xEB9: 84, + 0xEBA: 84, + 0xEBB: 84, + 0xEBC: 84, + 0xEC8: 84, + 0xEC9: 84, + 0xECA: 84, + 0xECB: 84, + 0xECC: 84, + 0xECD: 84, + 0xECE: 84, + 0xF18: 84, + 0xF19: 84, + 0xF35: 84, + 0xF37: 84, + 0xF39: 84, + 0xF71: 84, + 0xF72: 84, + 0xF73: 84, + 0xF74: 84, + 0xF75: 84, + 0xF76: 84, + 0xF77: 84, + 0xF78: 84, + 0xF79: 84, + 0xF7A: 84, + 0xF7B: 84, + 0xF7C: 84, + 0xF7D: 84, + 0xF7E: 84, + 0xF80: 84, + 0xF81: 84, + 0xF82: 84, + 0xF83: 84, + 0xF84: 84, + 0xF86: 84, + 0xF87: 84, + 0xF8D: 84, + 0xF8E: 84, + 0xF8F: 84, + 0xF90: 84, + 0xF91: 84, + 0xF92: 84, + 0xF93: 84, + 0xF94: 84, + 0xF95: 84, + 0xF96: 84, + 0xF97: 84, + 0xF99: 84, + 0xF9A: 84, + 0xF9B: 84, + 0xF9C: 84, + 0xF9D: 84, + 0xF9E: 84, + 0xF9F: 84, + 0xFA0: 84, + 0xFA1: 84, + 0xFA2: 84, + 0xFA3: 84, + 0xFA4: 84, + 0xFA5: 84, + 0xFA6: 84, + 0xFA7: 84, + 0xFA8: 84, + 0xFA9: 84, + 0xFAA: 84, + 0xFAB: 84, + 0xFAC: 84, + 0xFAD: 84, + 0xFAE: 84, + 0xFAF: 84, + 0xFB0: 84, + 0xFB1: 84, + 0xFB2: 84, + 0xFB3: 84, + 0xFB4: 84, + 0xFB5: 84, + 0xFB6: 84, + 0xFB7: 84, + 0xFB8: 84, + 0xFB9: 84, + 0xFBA: 84, + 0xFBB: 84, + 0xFBC: 84, + 0xFC6: 84, + 0x102D: 84, + 0x102E: 84, + 0x102F: 84, + 0x1030: 84, + 0x1032: 84, + 0x1033: 84, + 0x1034: 84, + 0x1035: 84, + 0x1036: 84, + 0x1037: 84, + 0x1039: 84, + 0x103A: 84, + 0x103D: 84, + 0x103E: 84, + 0x1058: 84, + 0x1059: 84, + 0x105E: 84, + 0x105F: 84, + 0x1060: 84, + 0x1071: 84, + 0x1072: 84, + 0x1073: 84, + 0x1074: 84, + 0x1082: 84, + 0x1085: 84, + 0x1086: 84, + 0x108D: 84, + 0x109D: 84, + 0x135D: 84, + 0x135E: 84, + 0x135F: 84, + 0x1712: 84, + 0x1713: 84, + 0x1714: 84, + 0x1732: 84, + 0x1733: 84, + 0x1752: 84, + 0x1753: 84, + 0x1772: 84, + 0x1773: 84, + 0x17B4: 84, + 0x17B5: 84, + 0x17B7: 84, + 0x17B8: 84, + 0x17B9: 84, + 0x17BA: 84, + 0x17BB: 84, + 0x17BC: 84, + 0x17BD: 84, + 0x17C6: 84, + 0x17C9: 84, + 0x17CA: 84, + 0x17CB: 84, + 0x17CC: 84, + 0x17CD: 84, + 0x17CE: 84, + 0x17CF: 84, + 0x17D0: 84, + 0x17D1: 84, + 0x17D2: 84, + 0x17D3: 84, + 0x17DD: 84, + 0x1807: 68, + 0x180A: 67, + 0x180B: 84, + 0x180C: 84, + 0x180D: 84, + 0x180F: 84, + 0x1820: 68, + 0x1821: 68, + 0x1822: 68, + 0x1823: 68, + 0x1824: 68, + 0x1825: 68, + 0x1826: 68, + 0x1827: 68, + 0x1828: 68, + 0x1829: 68, + 0x182A: 68, + 0x182B: 68, + 0x182C: 68, + 0x182D: 68, + 0x182E: 68, + 0x182F: 68, + 0x1830: 68, + 0x1831: 68, + 0x1832: 68, + 0x1833: 68, + 0x1834: 68, + 0x1835: 68, + 0x1836: 68, + 0x1837: 68, + 0x1838: 68, + 0x1839: 68, + 0x183A: 68, + 0x183B: 68, + 0x183C: 68, + 0x183D: 68, + 0x183E: 68, + 0x183F: 68, + 0x1840: 68, + 0x1841: 68, + 0x1842: 68, + 0x1843: 68, + 0x1844: 68, + 0x1845: 68, + 0x1846: 68, + 0x1847: 68, + 0x1848: 68, + 0x1849: 68, + 0x184A: 68, + 0x184B: 68, + 0x184C: 68, + 0x184D: 68, + 0x184E: 68, + 0x184F: 68, + 0x1850: 68, + 0x1851: 68, + 0x1852: 68, + 0x1853: 68, + 0x1854: 68, + 0x1855: 68, + 0x1856: 68, + 0x1857: 68, + 0x1858: 68, + 0x1859: 68, + 0x185A: 68, + 0x185B: 68, + 0x185C: 68, + 0x185D: 68, + 0x185E: 68, + 0x185F: 68, + 0x1860: 68, + 0x1861: 68, + 0x1862: 68, + 0x1863: 68, + 0x1864: 68, + 0x1865: 68, + 0x1866: 68, + 0x1867: 68, + 0x1868: 68, + 0x1869: 68, + 0x186A: 68, + 0x186B: 68, + 0x186C: 68, + 0x186D: 68, + 0x186E: 68, + 0x186F: 68, + 0x1870: 68, + 0x1871: 68, + 0x1872: 68, + 0x1873: 68, + 0x1874: 68, + 0x1875: 68, + 0x1876: 68, + 0x1877: 68, + 0x1878: 68, + 0x1885: 84, + 0x1886: 84, + 0x1887: 68, + 0x1888: 68, + 0x1889: 68, + 0x188A: 68, + 0x188B: 68, + 0x188C: 68, + 0x188D: 68, + 0x188E: 68, + 0x188F: 68, + 0x1890: 68, + 0x1891: 68, + 0x1892: 68, + 0x1893: 68, + 0x1894: 68, + 0x1895: 68, + 0x1896: 68, + 0x1897: 68, + 0x1898: 68, + 0x1899: 68, + 0x189A: 68, + 0x189B: 68, + 0x189C: 68, + 0x189D: 68, + 0x189E: 68, + 0x189F: 68, + 0x18A0: 68, + 0x18A1: 68, + 0x18A2: 68, + 0x18A3: 68, + 0x18A4: 68, + 0x18A5: 68, + 0x18A6: 68, + 0x18A7: 68, + 0x18A8: 68, + 0x18A9: 84, + 0x18AA: 68, + 0x1920: 84, + 0x1921: 84, + 0x1922: 84, + 0x1927: 84, + 0x1928: 84, + 0x1932: 84, + 0x1939: 84, + 0x193A: 84, + 0x193B: 84, + 0x1A17: 84, + 0x1A18: 84, + 0x1A1B: 84, + 0x1A56: 84, + 0x1A58: 84, + 0x1A59: 84, + 0x1A5A: 84, + 0x1A5B: 84, + 0x1A5C: 84, + 0x1A5D: 84, + 0x1A5E: 84, + 0x1A60: 84, + 0x1A62: 84, + 0x1A65: 84, + 0x1A66: 84, + 0x1A67: 84, + 0x1A68: 84, + 0x1A69: 84, + 0x1A6A: 84, + 0x1A6B: 84, + 0x1A6C: 84, + 0x1A73: 84, + 0x1A74: 84, + 0x1A75: 84, + 0x1A76: 84, + 0x1A77: 84, + 0x1A78: 84, + 0x1A79: 84, + 0x1A7A: 84, + 0x1A7B: 84, + 0x1A7C: 84, + 0x1A7F: 84, + 0x1AB0: 84, + 0x1AB1: 84, + 0x1AB2: 84, + 0x1AB3: 84, + 0x1AB4: 84, + 0x1AB5: 84, + 0x1AB6: 84, + 0x1AB7: 84, + 0x1AB8: 84, + 0x1AB9: 84, + 0x1ABA: 84, + 0x1ABB: 84, + 0x1ABC: 84, + 0x1ABD: 84, + 0x1ABE: 84, + 0x1ABF: 84, + 0x1AC0: 84, + 0x1AC1: 84, + 0x1AC2: 84, + 0x1AC3: 84, + 0x1AC4: 84, + 0x1AC5: 84, + 0x1AC6: 84, + 0x1AC7: 84, + 0x1AC8: 84, + 0x1AC9: 84, + 0x1ACA: 84, + 0x1ACB: 84, + 0x1ACC: 84, + 0x1ACD: 84, + 0x1ACE: 84, + 0x1B00: 84, + 0x1B01: 84, + 0x1B02: 84, + 0x1B03: 84, + 0x1B34: 84, + 0x1B36: 84, + 0x1B37: 84, + 0x1B38: 84, + 0x1B39: 84, + 0x1B3A: 84, + 0x1B3C: 84, + 0x1B42: 84, + 0x1B6B: 84, + 0x1B6C: 84, + 0x1B6D: 84, + 0x1B6E: 84, + 0x1B6F: 84, + 0x1B70: 84, + 0x1B71: 84, + 0x1B72: 84, + 0x1B73: 84, + 0x1B80: 84, + 0x1B81: 84, + 0x1BA2: 84, + 0x1BA3: 84, + 0x1BA4: 84, + 0x1BA5: 84, + 0x1BA8: 84, + 0x1BA9: 84, + 0x1BAB: 84, + 0x1BAC: 84, + 0x1BAD: 84, + 0x1BE6: 84, + 0x1BE8: 84, + 0x1BE9: 84, + 0x1BED: 84, + 0x1BEF: 84, + 0x1BF0: 84, + 0x1BF1: 84, + 0x1C2C: 84, + 0x1C2D: 84, + 0x1C2E: 84, + 0x1C2F: 84, + 0x1C30: 84, + 0x1C31: 84, + 0x1C32: 84, + 0x1C33: 84, + 0x1C36: 84, + 0x1C37: 84, + 0x1CD0: 84, + 0x1CD1: 84, + 0x1CD2: 84, + 0x1CD4: 84, + 0x1CD5: 84, + 0x1CD6: 84, + 0x1CD7: 84, + 0x1CD8: 84, + 0x1CD9: 84, + 0x1CDA: 84, + 0x1CDB: 84, + 0x1CDC: 84, + 0x1CDD: 84, + 0x1CDE: 84, + 0x1CDF: 84, + 0x1CE0: 84, + 0x1CE2: 84, + 0x1CE3: 84, + 0x1CE4: 84, + 0x1CE5: 84, + 0x1CE6: 84, + 0x1CE7: 84, + 0x1CE8: 84, + 0x1CED: 84, + 0x1CF4: 84, + 0x1CF8: 84, + 0x1CF9: 84, + 0x1DC0: 84, + 0x1DC1: 84, + 0x1DC2: 84, + 0x1DC3: 84, + 0x1DC4: 84, + 0x1DC5: 84, + 0x1DC6: 84, + 0x1DC7: 84, + 0x1DC8: 84, + 0x1DC9: 84, + 0x1DCA: 84, + 0x1DCB: 84, + 0x1DCC: 84, + 0x1DCD: 84, + 0x1DCE: 84, + 0x1DCF: 84, + 0x1DD0: 84, + 0x1DD1: 84, + 0x1DD2: 84, + 0x1DD3: 84, + 0x1DD4: 84, + 0x1DD5: 84, + 0x1DD6: 84, + 0x1DD7: 84, + 0x1DD8: 84, + 0x1DD9: 84, + 0x1DDA: 84, + 0x1DDB: 84, + 0x1DDC: 84, + 0x1DDD: 84, + 0x1DDE: 84, + 0x1DDF: 84, + 0x1DE0: 84, + 0x1DE1: 84, + 0x1DE2: 84, + 0x1DE3: 84, + 0x1DE4: 84, + 0x1DE5: 84, + 0x1DE6: 84, + 0x1DE7: 84, + 0x1DE8: 84, + 0x1DE9: 84, + 0x1DEA: 84, + 0x1DEB: 84, + 0x1DEC: 84, + 0x1DED: 84, + 0x1DEE: 84, + 0x1DEF: 84, + 0x1DF0: 84, + 0x1DF1: 84, + 0x1DF2: 84, + 0x1DF3: 84, + 0x1DF4: 84, + 0x1DF5: 84, + 0x1DF6: 84, + 0x1DF7: 84, + 0x1DF8: 84, + 0x1DF9: 84, + 0x1DFA: 84, + 0x1DFB: 84, + 0x1DFC: 84, + 0x1DFD: 84, + 0x1DFE: 84, + 0x1DFF: 84, + 0x200B: 84, + 0x200D: 67, + 0x200E: 84, + 0x200F: 84, + 0x202A: 84, + 0x202B: 84, + 0x202C: 84, + 0x202D: 84, + 0x202E: 84, + 0x2060: 84, + 0x2061: 84, + 0x2062: 84, + 0x2063: 84, + 0x2064: 84, + 0x206A: 84, + 0x206B: 84, + 0x206C: 84, + 0x206D: 84, + 0x206E: 84, + 0x206F: 84, + 0x20D0: 84, + 0x20D1: 84, + 0x20D2: 84, + 0x20D3: 84, + 0x20D4: 84, + 0x20D5: 84, + 0x20D6: 84, + 0x20D7: 84, + 0x20D8: 84, + 0x20D9: 84, + 0x20DA: 84, + 0x20DB: 84, + 0x20DC: 84, + 0x20DD: 84, + 0x20DE: 84, + 0x20DF: 84, + 0x20E0: 84, + 0x20E1: 84, + 0x20E2: 84, + 0x20E3: 84, + 0x20E4: 84, + 0x20E5: 84, + 0x20E6: 84, + 0x20E7: 84, + 0x20E8: 84, + 0x20E9: 84, + 0x20EA: 84, + 0x20EB: 84, + 0x20EC: 84, + 0x20ED: 84, + 0x20EE: 84, + 0x20EF: 84, + 0x20F0: 84, + 0x2CEF: 84, + 0x2CF0: 84, + 0x2CF1: 84, + 0x2D7F: 84, + 0x2DE0: 84, + 0x2DE1: 84, + 0x2DE2: 84, + 0x2DE3: 84, + 0x2DE4: 84, + 0x2DE5: 84, + 0x2DE6: 84, + 0x2DE7: 84, + 0x2DE8: 84, + 0x2DE9: 84, + 0x2DEA: 84, + 0x2DEB: 84, + 0x2DEC: 84, + 0x2DED: 84, + 0x2DEE: 84, + 0x2DEF: 84, + 0x2DF0: 84, + 0x2DF1: 84, + 0x2DF2: 84, + 0x2DF3: 84, + 0x2DF4: 84, + 0x2DF5: 84, + 0x2DF6: 84, + 0x2DF7: 84, + 0x2DF8: 84, + 0x2DF9: 84, + 0x2DFA: 84, + 0x2DFB: 84, + 0x2DFC: 84, + 0x2DFD: 84, + 0x2DFE: 84, + 0x2DFF: 84, + 0x302A: 84, + 0x302B: 84, + 0x302C: 84, + 0x302D: 84, + 0x3099: 84, + 0x309A: 84, + 0xA66F: 84, + 0xA670: 84, + 0xA671: 84, + 0xA672: 84, + 0xA674: 84, + 0xA675: 84, + 0xA676: 84, + 0xA677: 84, + 0xA678: 84, + 0xA679: 84, + 0xA67A: 84, + 0xA67B: 84, + 0xA67C: 84, + 0xA67D: 84, + 0xA69E: 84, + 0xA69F: 84, + 0xA6F0: 84, + 0xA6F1: 84, + 0xA802: 84, + 0xA806: 84, + 0xA80B: 84, + 0xA825: 84, + 0xA826: 84, + 0xA82C: 84, + 0xA840: 68, + 0xA841: 68, + 0xA842: 68, + 0xA843: 68, + 0xA844: 68, + 0xA845: 68, + 0xA846: 68, + 0xA847: 68, + 0xA848: 68, + 0xA849: 68, + 0xA84A: 68, + 0xA84B: 68, + 0xA84C: 68, + 0xA84D: 68, + 0xA84E: 68, + 0xA84F: 68, + 0xA850: 68, + 0xA851: 68, + 0xA852: 68, + 0xA853: 68, + 0xA854: 68, + 0xA855: 68, + 0xA856: 68, + 0xA857: 68, + 0xA858: 68, + 0xA859: 68, + 0xA85A: 68, + 0xA85B: 68, + 0xA85C: 68, + 0xA85D: 68, + 0xA85E: 68, + 0xA85F: 68, + 0xA860: 68, + 0xA861: 68, + 0xA862: 68, + 0xA863: 68, + 0xA864: 68, + 0xA865: 68, + 0xA866: 68, + 0xA867: 68, + 0xA868: 68, + 0xA869: 68, + 0xA86A: 68, + 0xA86B: 68, + 0xA86C: 68, + 0xA86D: 68, + 0xA86E: 68, + 0xA86F: 68, + 0xA870: 68, + 0xA871: 68, + 0xA872: 76, + 0xA8C4: 84, + 0xA8C5: 84, + 0xA8E0: 84, + 0xA8E1: 84, + 0xA8E2: 84, + 0xA8E3: 84, + 0xA8E4: 84, + 0xA8E5: 84, + 0xA8E6: 84, + 0xA8E7: 84, + 0xA8E8: 84, + 0xA8E9: 84, + 0xA8EA: 84, + 0xA8EB: 84, + 0xA8EC: 84, + 0xA8ED: 84, + 0xA8EE: 84, + 0xA8EF: 84, + 0xA8F0: 84, + 0xA8F1: 84, + 0xA8FF: 84, + 0xA926: 84, + 0xA927: 84, + 0xA928: 84, + 0xA929: 84, + 0xA92A: 84, + 0xA92B: 84, + 0xA92C: 84, + 0xA92D: 84, + 0xA947: 84, + 0xA948: 84, + 0xA949: 84, + 0xA94A: 84, + 0xA94B: 84, + 0xA94C: 84, + 0xA94D: 84, + 0xA94E: 84, + 0xA94F: 84, + 0xA950: 84, + 0xA951: 84, + 0xA980: 84, + 0xA981: 84, + 0xA982: 84, + 0xA9B3: 84, + 0xA9B6: 84, + 0xA9B7: 84, + 0xA9B8: 84, + 0xA9B9: 84, + 0xA9BC: 84, + 0xA9BD: 84, + 0xA9E5: 84, + 0xAA29: 84, + 0xAA2A: 84, + 0xAA2B: 84, + 0xAA2C: 84, + 0xAA2D: 84, + 0xAA2E: 84, + 0xAA31: 84, + 0xAA32: 84, + 0xAA35: 84, + 0xAA36: 84, + 0xAA43: 84, + 0xAA4C: 84, + 0xAA7C: 84, + 0xAAB0: 84, + 0xAAB2: 84, + 0xAAB3: 84, + 0xAAB4: 84, + 0xAAB7: 84, + 0xAAB8: 84, + 0xAABE: 84, + 0xAABF: 84, + 0xAAC1: 84, + 0xAAEC: 84, + 0xAAED: 84, + 0xAAF6: 84, + 0xABE5: 84, + 0xABE8: 84, + 0xABED: 84, + 0xFB1E: 84, + 0xFE00: 84, + 0xFE01: 84, + 0xFE02: 84, + 0xFE03: 84, + 0xFE04: 84, + 0xFE05: 84, + 0xFE06: 84, + 0xFE07: 84, + 0xFE08: 84, + 0xFE09: 84, + 0xFE0A: 84, + 0xFE0B: 84, + 0xFE0C: 84, + 0xFE0D: 84, + 0xFE0E: 84, + 0xFE0F: 84, + 0xFE20: 84, + 0xFE21: 84, + 0xFE22: 84, + 0xFE23: 84, + 0xFE24: 84, + 0xFE25: 84, + 0xFE26: 84, + 0xFE27: 84, + 0xFE28: 84, + 0xFE29: 84, + 0xFE2A: 84, + 0xFE2B: 84, + 0xFE2C: 84, + 0xFE2D: 84, + 0xFE2E: 84, + 0xFE2F: 84, + 0xFEFF: 84, + 0xFFF9: 84, + 0xFFFA: 84, + 0xFFFB: 84, + 0x101FD: 84, + 0x102E0: 84, + 0x10376: 84, + 0x10377: 84, + 0x10378: 84, + 0x10379: 84, + 0x1037A: 84, + 0x10A01: 84, + 0x10A02: 84, + 0x10A03: 84, + 0x10A05: 84, + 0x10A06: 84, + 0x10A0C: 84, + 0x10A0D: 84, + 0x10A0E: 84, + 0x10A0F: 84, + 0x10A38: 84, + 0x10A39: 84, + 0x10A3A: 84, + 0x10A3F: 84, + 0x10AC0: 68, + 0x10AC1: 68, + 0x10AC2: 68, + 0x10AC3: 68, + 0x10AC4: 68, + 0x10AC5: 82, + 0x10AC7: 82, + 0x10AC9: 82, + 0x10ACA: 82, + 0x10ACD: 76, + 0x10ACE: 82, + 0x10ACF: 82, + 0x10AD0: 82, + 0x10AD1: 82, + 0x10AD2: 82, + 0x10AD3: 68, + 0x10AD4: 68, + 0x10AD5: 68, + 0x10AD6: 68, + 0x10AD7: 76, + 0x10AD8: 68, + 0x10AD9: 68, + 0x10ADA: 68, + 0x10ADB: 68, + 0x10ADC: 68, + 0x10ADD: 82, + 0x10ADE: 68, + 0x10ADF: 68, + 0x10AE0: 68, + 0x10AE1: 82, + 0x10AE4: 82, + 0x10AE5: 84, + 0x10AE6: 84, + 0x10AEB: 68, + 0x10AEC: 68, + 0x10AED: 68, + 0x10AEE: 68, + 0x10AEF: 82, + 0x10B80: 68, + 0x10B81: 82, + 0x10B82: 68, + 0x10B83: 82, + 0x10B84: 82, + 0x10B85: 82, + 0x10B86: 68, + 0x10B87: 68, + 0x10B88: 68, + 0x10B89: 82, + 0x10B8A: 68, + 0x10B8B: 68, + 0x10B8C: 82, + 0x10B8D: 68, + 0x10B8E: 82, + 0x10B8F: 82, + 0x10B90: 68, + 0x10B91: 82, + 0x10BA9: 82, + 0x10BAA: 82, + 0x10BAB: 82, + 0x10BAC: 82, + 0x10BAD: 68, + 0x10BAE: 68, + 0x10D00: 76, + 0x10D01: 68, + 0x10D02: 68, + 0x10D03: 68, + 0x10D04: 68, + 0x10D05: 68, + 0x10D06: 68, + 0x10D07: 68, + 0x10D08: 68, + 0x10D09: 68, + 0x10D0A: 68, + 0x10D0B: 68, + 0x10D0C: 68, + 0x10D0D: 68, + 0x10D0E: 68, + 0x10D0F: 68, + 0x10D10: 68, + 0x10D11: 68, + 0x10D12: 68, + 0x10D13: 68, + 0x10D14: 68, + 0x10D15: 68, + 0x10D16: 68, + 0x10D17: 68, + 0x10D18: 68, + 0x10D19: 68, + 0x10D1A: 68, + 0x10D1B: 68, + 0x10D1C: 68, + 0x10D1D: 68, + 0x10D1E: 68, + 0x10D1F: 68, + 0x10D20: 68, + 0x10D21: 68, + 0x10D22: 82, + 0x10D23: 68, + 0x10D24: 84, + 0x10D25: 84, + 0x10D26: 84, + 0x10D27: 84, + 0x10EAB: 84, + 0x10EAC: 84, + 0x10EFD: 84, + 0x10EFE: 84, + 0x10EFF: 84, + 0x10F30: 68, + 0x10F31: 68, + 0x10F32: 68, + 0x10F33: 82, + 0x10F34: 68, + 0x10F35: 68, + 0x10F36: 68, + 0x10F37: 68, + 0x10F38: 68, + 0x10F39: 68, + 0x10F3A: 68, + 0x10F3B: 68, + 0x10F3C: 68, + 0x10F3D: 68, + 0x10F3E: 68, + 0x10F3F: 68, + 0x10F40: 68, + 0x10F41: 68, + 0x10F42: 68, + 0x10F43: 68, + 0x10F44: 68, + 0x10F46: 84, + 0x10F47: 84, + 0x10F48: 84, + 0x10F49: 84, + 0x10F4A: 84, + 0x10F4B: 84, + 0x10F4C: 84, + 0x10F4D: 84, + 0x10F4E: 84, + 0x10F4F: 84, + 0x10F50: 84, + 0x10F51: 68, + 0x10F52: 68, + 0x10F53: 68, + 0x10F54: 82, + 0x10F70: 68, + 0x10F71: 68, + 0x10F72: 68, + 0x10F73: 68, + 0x10F74: 82, + 0x10F75: 82, + 0x10F76: 68, + 0x10F77: 68, + 0x10F78: 68, + 0x10F79: 68, + 0x10F7A: 68, + 0x10F7B: 68, + 0x10F7C: 68, + 0x10F7D: 68, + 0x10F7E: 68, + 0x10F7F: 68, + 0x10F80: 68, + 0x10F81: 68, + 0x10F82: 84, + 0x10F83: 84, + 0x10F84: 84, + 0x10F85: 84, + 0x10FB0: 68, + 0x10FB2: 68, + 0x10FB3: 68, + 0x10FB4: 82, + 0x10FB5: 82, + 0x10FB6: 82, + 0x10FB8: 68, + 0x10FB9: 82, + 0x10FBA: 82, + 0x10FBB: 68, + 0x10FBC: 68, + 0x10FBD: 82, + 0x10FBE: 68, + 0x10FBF: 68, + 0x10FC1: 68, + 0x10FC2: 82, + 0x10FC3: 82, + 0x10FC4: 68, + 0x10FC9: 82, + 0x10FCA: 68, + 0x10FCB: 76, + 0x11001: 84, + 0x11038: 84, + 0x11039: 84, + 0x1103A: 84, + 0x1103B: 84, + 0x1103C: 84, + 0x1103D: 84, + 0x1103E: 84, + 0x1103F: 84, + 0x11040: 84, + 0x11041: 84, + 0x11042: 84, + 0x11043: 84, + 0x11044: 84, + 0x11045: 84, + 0x11046: 84, + 0x11070: 84, + 0x11073: 84, + 0x11074: 84, + 0x1107F: 84, + 0x11080: 84, + 0x11081: 84, + 0x110B3: 84, + 0x110B4: 84, + 0x110B5: 84, + 0x110B6: 84, + 0x110B9: 84, + 0x110BA: 84, + 0x110C2: 84, + 0x11100: 84, + 0x11101: 84, + 0x11102: 84, + 0x11127: 84, + 0x11128: 84, + 0x11129: 84, + 0x1112A: 84, + 0x1112B: 84, + 0x1112D: 84, + 0x1112E: 84, + 0x1112F: 84, + 0x11130: 84, + 0x11131: 84, + 0x11132: 84, + 0x11133: 84, + 0x11134: 84, + 0x11173: 84, + 0x11180: 84, + 0x11181: 84, + 0x111B6: 84, + 0x111B7: 84, + 0x111B8: 84, + 0x111B9: 84, + 0x111BA: 84, + 0x111BB: 84, + 0x111BC: 84, + 0x111BD: 84, + 0x111BE: 84, + 0x111C9: 84, + 0x111CA: 84, + 0x111CB: 84, + 0x111CC: 84, + 0x111CF: 84, + 0x1122F: 84, + 0x11230: 84, + 0x11231: 84, + 0x11234: 84, + 0x11236: 84, + 0x11237: 84, + 0x1123E: 84, + 0x11241: 84, + 0x112DF: 84, + 0x112E3: 84, + 0x112E4: 84, + 0x112E5: 84, + 0x112E6: 84, + 0x112E7: 84, + 0x112E8: 84, + 0x112E9: 84, + 0x112EA: 84, + 0x11300: 84, + 0x11301: 84, + 0x1133B: 84, + 0x1133C: 84, + 0x11340: 84, + 0x11366: 84, + 0x11367: 84, + 0x11368: 84, + 0x11369: 84, + 0x1136A: 84, + 0x1136B: 84, + 0x1136C: 84, + 0x11370: 84, + 0x11371: 84, + 0x11372: 84, + 0x11373: 84, + 0x11374: 84, + 0x11438: 84, + 0x11439: 84, + 0x1143A: 84, + 0x1143B: 84, + 0x1143C: 84, + 0x1143D: 84, + 0x1143E: 84, + 0x1143F: 84, + 0x11442: 84, + 0x11443: 84, + 0x11444: 84, + 0x11446: 84, + 0x1145E: 84, + 0x114B3: 84, + 0x114B4: 84, + 0x114B5: 84, + 0x114B6: 84, + 0x114B7: 84, + 0x114B8: 84, + 0x114BA: 84, + 0x114BF: 84, + 0x114C0: 84, + 0x114C2: 84, + 0x114C3: 84, + 0x115B2: 84, + 0x115B3: 84, + 0x115B4: 84, + 0x115B5: 84, + 0x115BC: 84, + 0x115BD: 84, + 0x115BF: 84, + 0x115C0: 84, + 0x115DC: 84, + 0x115DD: 84, + 0x11633: 84, + 0x11634: 84, + 0x11635: 84, + 0x11636: 84, + 0x11637: 84, + 0x11638: 84, + 0x11639: 84, + 0x1163A: 84, + 0x1163D: 84, + 0x1163F: 84, + 0x11640: 84, + 0x116AB: 84, + 0x116AD: 84, + 0x116B0: 84, + 0x116B1: 84, + 0x116B2: 84, + 0x116B3: 84, + 0x116B4: 84, + 0x116B5: 84, + 0x116B7: 84, + 0x1171D: 84, + 0x1171E: 84, + 0x1171F: 84, + 0x11722: 84, + 0x11723: 84, + 0x11724: 84, + 0x11725: 84, + 0x11727: 84, + 0x11728: 84, + 0x11729: 84, + 0x1172A: 84, + 0x1172B: 84, + 0x1182F: 84, + 0x11830: 84, + 0x11831: 84, + 0x11832: 84, + 0x11833: 84, + 0x11834: 84, + 0x11835: 84, + 0x11836: 84, + 0x11837: 84, + 0x11839: 84, + 0x1183A: 84, + 0x1193B: 84, + 0x1193C: 84, + 0x1193E: 84, + 0x11943: 84, + 0x119D4: 84, + 0x119D5: 84, + 0x119D6: 84, + 0x119D7: 84, + 0x119DA: 84, + 0x119DB: 84, + 0x119E0: 84, + 0x11A01: 84, + 0x11A02: 84, + 0x11A03: 84, + 0x11A04: 84, + 0x11A05: 84, + 0x11A06: 84, + 0x11A07: 84, + 0x11A08: 84, + 0x11A09: 84, + 0x11A0A: 84, + 0x11A33: 84, + 0x11A34: 84, + 0x11A35: 84, + 0x11A36: 84, + 0x11A37: 84, + 0x11A38: 84, + 0x11A3B: 84, + 0x11A3C: 84, + 0x11A3D: 84, + 0x11A3E: 84, + 0x11A47: 84, + 0x11A51: 84, + 0x11A52: 84, + 0x11A53: 84, + 0x11A54: 84, + 0x11A55: 84, + 0x11A56: 84, + 0x11A59: 84, + 0x11A5A: 84, + 0x11A5B: 84, + 0x11A8A: 84, + 0x11A8B: 84, + 0x11A8C: 84, + 0x11A8D: 84, + 0x11A8E: 84, + 0x11A8F: 84, + 0x11A90: 84, + 0x11A91: 84, + 0x11A92: 84, + 0x11A93: 84, + 0x11A94: 84, + 0x11A95: 84, + 0x11A96: 84, + 0x11A98: 84, + 0x11A99: 84, + 0x11C30: 84, + 0x11C31: 84, + 0x11C32: 84, + 0x11C33: 84, + 0x11C34: 84, + 0x11C35: 84, + 0x11C36: 84, + 0x11C38: 84, + 0x11C39: 84, + 0x11C3A: 84, + 0x11C3B: 84, + 0x11C3C: 84, + 0x11C3D: 84, + 0x11C3F: 84, + 0x11C92: 84, + 0x11C93: 84, + 0x11C94: 84, + 0x11C95: 84, + 0x11C96: 84, + 0x11C97: 84, + 0x11C98: 84, + 0x11C99: 84, + 0x11C9A: 84, + 0x11C9B: 84, + 0x11C9C: 84, + 0x11C9D: 84, + 0x11C9E: 84, + 0x11C9F: 84, + 0x11CA0: 84, + 0x11CA1: 84, + 0x11CA2: 84, + 0x11CA3: 84, + 0x11CA4: 84, + 0x11CA5: 84, + 0x11CA6: 84, + 0x11CA7: 84, + 0x11CAA: 84, + 0x11CAB: 84, + 0x11CAC: 84, + 0x11CAD: 84, + 0x11CAE: 84, + 0x11CAF: 84, + 0x11CB0: 84, + 0x11CB2: 84, + 0x11CB3: 84, + 0x11CB5: 84, + 0x11CB6: 84, + 0x11D31: 84, + 0x11D32: 84, + 0x11D33: 84, + 0x11D34: 84, + 0x11D35: 84, + 0x11D36: 84, + 0x11D3A: 84, + 0x11D3C: 84, + 0x11D3D: 84, + 0x11D3F: 84, + 0x11D40: 84, + 0x11D41: 84, + 0x11D42: 84, + 0x11D43: 84, + 0x11D44: 84, + 0x11D45: 84, + 0x11D47: 84, + 0x11D90: 84, + 0x11D91: 84, + 0x11D95: 84, + 0x11D97: 84, + 0x11EF3: 84, + 0x11EF4: 84, + 0x11F00: 84, + 0x11F01: 84, + 0x11F36: 84, + 0x11F37: 84, + 0x11F38: 84, + 0x11F39: 84, + 0x11F3A: 84, + 0x11F40: 84, + 0x11F42: 84, + 0x13430: 84, + 0x13431: 84, + 0x13432: 84, + 0x13433: 84, + 0x13434: 84, + 0x13435: 84, + 0x13436: 84, + 0x13437: 84, + 0x13438: 84, + 0x13439: 84, + 0x1343A: 84, + 0x1343B: 84, + 0x1343C: 84, + 0x1343D: 84, + 0x1343E: 84, + 0x1343F: 84, + 0x13440: 84, + 0x13447: 84, + 0x13448: 84, + 0x13449: 84, + 0x1344A: 84, + 0x1344B: 84, + 0x1344C: 84, + 0x1344D: 84, + 0x1344E: 84, + 0x1344F: 84, + 0x13450: 84, + 0x13451: 84, + 0x13452: 84, + 0x13453: 84, + 0x13454: 84, + 0x13455: 84, + 0x16AF0: 84, + 0x16AF1: 84, + 0x16AF2: 84, + 0x16AF3: 84, + 0x16AF4: 84, + 0x16B30: 84, + 0x16B31: 84, + 0x16B32: 84, + 0x16B33: 84, + 0x16B34: 84, + 0x16B35: 84, + 0x16B36: 84, + 0x16F4F: 84, + 0x16F8F: 84, + 0x16F90: 84, + 0x16F91: 84, + 0x16F92: 84, + 0x16FE4: 84, + 0x1BC9D: 84, + 0x1BC9E: 84, + 0x1BCA0: 84, + 0x1BCA1: 84, + 0x1BCA2: 84, + 0x1BCA3: 84, + 0x1CF00: 84, + 0x1CF01: 84, + 0x1CF02: 84, + 0x1CF03: 84, + 0x1CF04: 84, + 0x1CF05: 84, + 0x1CF06: 84, + 0x1CF07: 84, + 0x1CF08: 84, + 0x1CF09: 84, + 0x1CF0A: 84, + 0x1CF0B: 84, + 0x1CF0C: 84, + 0x1CF0D: 84, + 0x1CF0E: 84, + 0x1CF0F: 84, + 0x1CF10: 84, + 0x1CF11: 84, + 0x1CF12: 84, + 0x1CF13: 84, + 0x1CF14: 84, + 0x1CF15: 84, + 0x1CF16: 84, + 0x1CF17: 84, + 0x1CF18: 84, + 0x1CF19: 84, + 0x1CF1A: 84, + 0x1CF1B: 84, + 0x1CF1C: 84, + 0x1CF1D: 84, + 0x1CF1E: 84, + 0x1CF1F: 84, + 0x1CF20: 84, + 0x1CF21: 84, + 0x1CF22: 84, + 0x1CF23: 84, + 0x1CF24: 84, + 0x1CF25: 84, + 0x1CF26: 84, + 0x1CF27: 84, + 0x1CF28: 84, + 0x1CF29: 84, + 0x1CF2A: 84, + 0x1CF2B: 84, + 0x1CF2C: 84, + 0x1CF2D: 84, + 0x1CF30: 84, + 0x1CF31: 84, + 0x1CF32: 84, + 0x1CF33: 84, + 0x1CF34: 84, + 0x1CF35: 84, + 0x1CF36: 84, + 0x1CF37: 84, + 0x1CF38: 84, + 0x1CF39: 84, + 0x1CF3A: 84, + 0x1CF3B: 84, + 0x1CF3C: 84, + 0x1CF3D: 84, + 0x1CF3E: 84, + 0x1CF3F: 84, + 0x1CF40: 84, + 0x1CF41: 84, + 0x1CF42: 84, + 0x1CF43: 84, + 0x1CF44: 84, + 0x1CF45: 84, + 0x1CF46: 84, + 0x1D167: 84, + 0x1D168: 84, + 0x1D169: 84, + 0x1D173: 84, + 0x1D174: 84, + 0x1D175: 84, + 0x1D176: 84, + 0x1D177: 84, + 0x1D178: 84, + 0x1D179: 84, + 0x1D17A: 84, + 0x1D17B: 84, + 0x1D17C: 84, + 0x1D17D: 84, + 0x1D17E: 84, + 0x1D17F: 84, + 0x1D180: 84, + 0x1D181: 84, + 0x1D182: 84, + 0x1D185: 84, + 0x1D186: 84, + 0x1D187: 84, + 0x1D188: 84, + 0x1D189: 84, + 0x1D18A: 84, + 0x1D18B: 84, + 0x1D1AA: 84, + 0x1D1AB: 84, + 0x1D1AC: 84, + 0x1D1AD: 84, + 0x1D242: 84, + 0x1D243: 84, + 0x1D244: 84, + 0x1DA00: 84, + 0x1DA01: 84, + 0x1DA02: 84, + 0x1DA03: 84, + 0x1DA04: 84, + 0x1DA05: 84, + 0x1DA06: 84, + 0x1DA07: 84, + 0x1DA08: 84, + 0x1DA09: 84, + 0x1DA0A: 84, + 0x1DA0B: 84, + 0x1DA0C: 84, + 0x1DA0D: 84, + 0x1DA0E: 84, + 0x1DA0F: 84, + 0x1DA10: 84, + 0x1DA11: 84, + 0x1DA12: 84, + 0x1DA13: 84, + 0x1DA14: 84, + 0x1DA15: 84, + 0x1DA16: 84, + 0x1DA17: 84, + 0x1DA18: 84, + 0x1DA19: 84, + 0x1DA1A: 84, + 0x1DA1B: 84, + 0x1DA1C: 84, + 0x1DA1D: 84, + 0x1DA1E: 84, + 0x1DA1F: 84, + 0x1DA20: 84, + 0x1DA21: 84, + 0x1DA22: 84, + 0x1DA23: 84, + 0x1DA24: 84, + 0x1DA25: 84, + 0x1DA26: 84, + 0x1DA27: 84, + 0x1DA28: 84, + 0x1DA29: 84, + 0x1DA2A: 84, + 0x1DA2B: 84, + 0x1DA2C: 84, + 0x1DA2D: 84, + 0x1DA2E: 84, + 0x1DA2F: 84, + 0x1DA30: 84, + 0x1DA31: 84, + 0x1DA32: 84, + 0x1DA33: 84, + 0x1DA34: 84, + 0x1DA35: 84, + 0x1DA36: 84, + 0x1DA3B: 84, + 0x1DA3C: 84, + 0x1DA3D: 84, + 0x1DA3E: 84, + 0x1DA3F: 84, + 0x1DA40: 84, + 0x1DA41: 84, + 0x1DA42: 84, + 0x1DA43: 84, + 0x1DA44: 84, + 0x1DA45: 84, + 0x1DA46: 84, + 0x1DA47: 84, + 0x1DA48: 84, + 0x1DA49: 84, + 0x1DA4A: 84, + 0x1DA4B: 84, + 0x1DA4C: 84, + 0x1DA4D: 84, + 0x1DA4E: 84, + 0x1DA4F: 84, + 0x1DA50: 84, + 0x1DA51: 84, + 0x1DA52: 84, + 0x1DA53: 84, + 0x1DA54: 84, + 0x1DA55: 84, + 0x1DA56: 84, + 0x1DA57: 84, + 0x1DA58: 84, + 0x1DA59: 84, + 0x1DA5A: 84, + 0x1DA5B: 84, + 0x1DA5C: 84, + 0x1DA5D: 84, + 0x1DA5E: 84, + 0x1DA5F: 84, + 0x1DA60: 84, + 0x1DA61: 84, + 0x1DA62: 84, + 0x1DA63: 84, + 0x1DA64: 84, + 0x1DA65: 84, + 0x1DA66: 84, + 0x1DA67: 84, + 0x1DA68: 84, + 0x1DA69: 84, + 0x1DA6A: 84, + 0x1DA6B: 84, + 0x1DA6C: 84, + 0x1DA75: 84, + 0x1DA84: 84, + 0x1DA9B: 84, + 0x1DA9C: 84, + 0x1DA9D: 84, + 0x1DA9E: 84, + 0x1DA9F: 84, + 0x1DAA1: 84, + 0x1DAA2: 84, + 0x1DAA3: 84, + 0x1DAA4: 84, + 0x1DAA5: 84, + 0x1DAA6: 84, + 0x1DAA7: 84, + 0x1DAA8: 84, + 0x1DAA9: 84, + 0x1DAAA: 84, + 0x1DAAB: 84, + 0x1DAAC: 84, + 0x1DAAD: 84, + 0x1DAAE: 84, + 0x1DAAF: 84, + 0x1E000: 84, + 0x1E001: 84, + 0x1E002: 84, + 0x1E003: 84, + 0x1E004: 84, + 0x1E005: 84, + 0x1E006: 84, + 0x1E008: 84, + 0x1E009: 84, + 0x1E00A: 84, + 0x1E00B: 84, + 0x1E00C: 84, + 0x1E00D: 84, + 0x1E00E: 84, + 0x1E00F: 84, + 0x1E010: 84, + 0x1E011: 84, + 0x1E012: 84, + 0x1E013: 84, + 0x1E014: 84, + 0x1E015: 84, + 0x1E016: 84, + 0x1E017: 84, + 0x1E018: 84, + 0x1E01B: 84, + 0x1E01C: 84, + 0x1E01D: 84, + 0x1E01E: 84, + 0x1E01F: 84, + 0x1E020: 84, + 0x1E021: 84, + 0x1E023: 84, + 0x1E024: 84, + 0x1E026: 84, + 0x1E027: 84, + 0x1E028: 84, + 0x1E029: 84, + 0x1E02A: 84, + 0x1E08F: 84, + 0x1E130: 84, + 0x1E131: 84, + 0x1E132: 84, + 0x1E133: 84, + 0x1E134: 84, + 0x1E135: 84, + 0x1E136: 84, + 0x1E2AE: 84, + 0x1E2EC: 84, + 0x1E2ED: 84, + 0x1E2EE: 84, + 0x1E2EF: 84, + 0x1E4EC: 84, + 0x1E4ED: 84, + 0x1E4EE: 84, + 0x1E4EF: 84, + 0x1E8D0: 84, + 0x1E8D1: 84, + 0x1E8D2: 84, + 0x1E8D3: 84, + 0x1E8D4: 84, + 0x1E8D5: 84, + 0x1E8D6: 84, + 0x1E900: 68, + 0x1E901: 68, + 0x1E902: 68, + 0x1E903: 68, + 0x1E904: 68, + 0x1E905: 68, + 0x1E906: 68, + 0x1E907: 68, + 0x1E908: 68, + 0x1E909: 68, + 0x1E90A: 68, + 0x1E90B: 68, + 0x1E90C: 68, + 0x1E90D: 68, + 0x1E90E: 68, + 0x1E90F: 68, + 0x1E910: 68, + 0x1E911: 68, + 0x1E912: 68, + 0x1E913: 68, + 0x1E914: 68, + 0x1E915: 68, + 0x1E916: 68, + 0x1E917: 68, + 0x1E918: 68, + 0x1E919: 68, + 0x1E91A: 68, + 0x1E91B: 68, + 0x1E91C: 68, + 0x1E91D: 68, + 0x1E91E: 68, + 0x1E91F: 68, + 0x1E920: 68, + 0x1E921: 68, + 0x1E922: 68, + 0x1E923: 68, + 0x1E924: 68, + 0x1E925: 68, + 0x1E926: 68, + 0x1E927: 68, + 0x1E928: 68, + 0x1E929: 68, + 0x1E92A: 68, + 0x1E92B: 68, + 0x1E92C: 68, + 0x1E92D: 68, + 0x1E92E: 68, + 0x1E92F: 68, + 0x1E930: 68, + 0x1E931: 68, + 0x1E932: 68, + 0x1E933: 68, + 0x1E934: 68, + 0x1E935: 68, + 0x1E936: 68, + 0x1E937: 68, + 0x1E938: 68, + 0x1E939: 68, + 0x1E93A: 68, + 0x1E93B: 68, + 0x1E93C: 68, + 0x1E93D: 68, + 0x1E93E: 68, + 0x1E93F: 68, + 0x1E940: 68, + 0x1E941: 68, + 0x1E942: 68, + 0x1E943: 68, + 0x1E944: 84, + 0x1E945: 84, + 0x1E946: 84, + 0x1E947: 84, + 0x1E948: 84, + 0x1E949: 84, + 0x1E94A: 84, + 0x1E94B: 84, + 0xE0001: 84, + 0xE0020: 84, + 0xE0021: 84, + 0xE0022: 84, + 0xE0023: 84, + 0xE0024: 84, + 0xE0025: 84, + 0xE0026: 84, + 0xE0027: 84, + 0xE0028: 84, + 0xE0029: 84, + 0xE002A: 84, + 0xE002B: 84, + 0xE002C: 84, + 0xE002D: 84, + 0xE002E: 84, + 0xE002F: 84, + 0xE0030: 84, + 0xE0031: 84, + 0xE0032: 84, + 0xE0033: 84, + 0xE0034: 84, + 0xE0035: 84, + 0xE0036: 84, + 0xE0037: 84, + 0xE0038: 84, + 0xE0039: 84, + 0xE003A: 84, + 0xE003B: 84, + 0xE003C: 84, + 0xE003D: 84, + 0xE003E: 84, + 0xE003F: 84, + 0xE0040: 84, + 0xE0041: 84, + 0xE0042: 84, + 0xE0043: 84, + 0xE0044: 84, + 0xE0045: 84, + 0xE0046: 84, + 0xE0047: 84, + 0xE0048: 84, + 0xE0049: 84, + 0xE004A: 84, + 0xE004B: 84, + 0xE004C: 84, + 0xE004D: 84, + 0xE004E: 84, + 0xE004F: 84, + 0xE0050: 84, + 0xE0051: 84, + 0xE0052: 84, + 0xE0053: 84, + 0xE0054: 84, + 0xE0055: 84, + 0xE0056: 84, + 0xE0057: 84, + 0xE0058: 84, + 0xE0059: 84, + 0xE005A: 84, + 0xE005B: 84, + 0xE005C: 84, + 0xE005D: 84, + 0xE005E: 84, + 0xE005F: 84, + 0xE0060: 84, + 0xE0061: 84, + 0xE0062: 84, + 0xE0063: 84, + 0xE0064: 84, + 0xE0065: 84, + 0xE0066: 84, + 0xE0067: 84, + 0xE0068: 84, + 0xE0069: 84, + 0xE006A: 84, + 0xE006B: 84, + 0xE006C: 84, + 0xE006D: 84, + 0xE006E: 84, + 0xE006F: 84, + 0xE0070: 84, + 0xE0071: 84, + 0xE0072: 84, + 0xE0073: 84, + 0xE0074: 84, + 0xE0075: 84, + 0xE0076: 84, + 0xE0077: 84, + 0xE0078: 84, + 0xE0079: 84, + 0xE007A: 84, + 0xE007B: 84, + 0xE007C: 84, + 0xE007D: 84, + 0xE007E: 84, + 0xE007F: 84, + 0xE0100: 84, + 0xE0101: 84, + 0xE0102: 84, + 0xE0103: 84, + 0xE0104: 84, + 0xE0105: 84, + 0xE0106: 84, + 0xE0107: 84, + 0xE0108: 84, + 0xE0109: 84, + 0xE010A: 84, + 0xE010B: 84, + 0xE010C: 84, + 0xE010D: 84, + 0xE010E: 84, + 0xE010F: 84, + 0xE0110: 84, + 0xE0111: 84, + 0xE0112: 84, + 0xE0113: 84, + 0xE0114: 84, + 0xE0115: 84, + 0xE0116: 84, + 0xE0117: 84, + 0xE0118: 84, + 0xE0119: 84, + 0xE011A: 84, + 0xE011B: 84, + 0xE011C: 84, + 0xE011D: 84, + 0xE011E: 84, + 0xE011F: 84, + 0xE0120: 84, + 0xE0121: 84, + 0xE0122: 84, + 0xE0123: 84, + 0xE0124: 84, + 0xE0125: 84, + 0xE0126: 84, + 0xE0127: 84, + 0xE0128: 84, + 0xE0129: 84, + 0xE012A: 84, + 0xE012B: 84, + 0xE012C: 84, + 0xE012D: 84, + 0xE012E: 84, + 0xE012F: 84, + 0xE0130: 84, + 0xE0131: 84, + 0xE0132: 84, + 0xE0133: 84, + 0xE0134: 84, + 0xE0135: 84, + 0xE0136: 84, + 0xE0137: 84, + 0xE0138: 84, + 0xE0139: 84, + 0xE013A: 84, + 0xE013B: 84, + 0xE013C: 84, + 0xE013D: 84, + 0xE013E: 84, + 0xE013F: 84, + 0xE0140: 84, + 0xE0141: 84, + 0xE0142: 84, + 0xE0143: 84, + 0xE0144: 84, + 0xE0145: 84, + 0xE0146: 84, + 0xE0147: 84, + 0xE0148: 84, + 0xE0149: 84, + 0xE014A: 84, + 0xE014B: 84, + 0xE014C: 84, + 0xE014D: 84, + 0xE014E: 84, + 0xE014F: 84, + 0xE0150: 84, + 0xE0151: 84, + 0xE0152: 84, + 0xE0153: 84, + 0xE0154: 84, + 0xE0155: 84, + 0xE0156: 84, + 0xE0157: 84, + 0xE0158: 84, + 0xE0159: 84, + 0xE015A: 84, + 0xE015B: 84, + 0xE015C: 84, + 0xE015D: 84, + 0xE015E: 84, + 0xE015F: 84, + 0xE0160: 84, + 0xE0161: 84, + 0xE0162: 84, + 0xE0163: 84, + 0xE0164: 84, + 0xE0165: 84, + 0xE0166: 84, + 0xE0167: 84, + 0xE0168: 84, + 0xE0169: 84, + 0xE016A: 84, + 0xE016B: 84, + 0xE016C: 84, + 0xE016D: 84, + 0xE016E: 84, + 0xE016F: 84, + 0xE0170: 84, + 0xE0171: 84, + 0xE0172: 84, + 0xE0173: 84, + 0xE0174: 84, + 0xE0175: 84, + 0xE0176: 84, + 0xE0177: 84, + 0xE0178: 84, + 0xE0179: 84, + 0xE017A: 84, + 0xE017B: 84, + 0xE017C: 84, + 0xE017D: 84, + 0xE017E: 84, + 0xE017F: 84, + 0xE0180: 84, + 0xE0181: 84, + 0xE0182: 84, + 0xE0183: 84, + 0xE0184: 84, + 0xE0185: 84, + 0xE0186: 84, + 0xE0187: 84, + 0xE0188: 84, + 0xE0189: 84, + 0xE018A: 84, + 0xE018B: 84, + 0xE018C: 84, + 0xE018D: 84, + 0xE018E: 84, + 0xE018F: 84, + 0xE0190: 84, + 0xE0191: 84, + 0xE0192: 84, + 0xE0193: 84, + 0xE0194: 84, + 0xE0195: 84, + 0xE0196: 84, + 0xE0197: 84, + 0xE0198: 84, + 0xE0199: 84, + 0xE019A: 84, + 0xE019B: 84, + 0xE019C: 84, + 0xE019D: 84, + 0xE019E: 84, + 0xE019F: 84, + 0xE01A0: 84, + 0xE01A1: 84, + 0xE01A2: 84, + 0xE01A3: 84, + 0xE01A4: 84, + 0xE01A5: 84, + 0xE01A6: 84, + 0xE01A7: 84, + 0xE01A8: 84, + 0xE01A9: 84, + 0xE01AA: 84, + 0xE01AB: 84, + 0xE01AC: 84, + 0xE01AD: 84, + 0xE01AE: 84, + 0xE01AF: 84, + 0xE01B0: 84, + 0xE01B1: 84, + 0xE01B2: 84, + 0xE01B3: 84, + 0xE01B4: 84, + 0xE01B5: 84, + 0xE01B6: 84, + 0xE01B7: 84, + 0xE01B8: 84, + 0xE01B9: 84, + 0xE01BA: 84, + 0xE01BB: 84, + 0xE01BC: 84, + 0xE01BD: 84, + 0xE01BE: 84, + 0xE01BF: 84, + 0xE01C0: 84, + 0xE01C1: 84, + 0xE01C2: 84, + 0xE01C3: 84, + 0xE01C4: 84, + 0xE01C5: 84, + 0xE01C6: 84, + 0xE01C7: 84, + 0xE01C8: 84, + 0xE01C9: 84, + 0xE01CA: 84, + 0xE01CB: 84, + 0xE01CC: 84, + 0xE01CD: 84, + 0xE01CE: 84, + 0xE01CF: 84, + 0xE01D0: 84, + 0xE01D1: 84, + 0xE01D2: 84, + 0xE01D3: 84, + 0xE01D4: 84, + 0xE01D5: 84, + 0xE01D6: 84, + 0xE01D7: 84, + 0xE01D8: 84, + 0xE01D9: 84, + 0xE01DA: 84, + 0xE01DB: 84, + 0xE01DC: 84, + 0xE01DD: 84, + 0xE01DE: 84, + 0xE01DF: 84, + 0xE01E0: 84, + 0xE01E1: 84, + 0xE01E2: 84, + 0xE01E3: 84, + 0xE01E4: 84, + 0xE01E5: 84, + 0xE01E6: 84, + 0xE01E7: 84, + 0xE01E8: 84, + 0xE01E9: 84, + 0xE01EA: 84, + 0xE01EB: 84, + 0xE01EC: 84, + 0xE01ED: 84, + 0xE01EE: 84, + 0xE01EF: 84, +} +codepoint_classes = { + "PVALID": ( + 0x2D0000002E, + 0x300000003A, + 0x610000007B, + 0xDF000000F7, + 0xF800000100, + 0x10100000102, + 0x10300000104, + 0x10500000106, + 0x10700000108, + 0x1090000010A, + 0x10B0000010C, + 0x10D0000010E, + 0x10F00000110, + 0x11100000112, + 0x11300000114, + 0x11500000116, + 0x11700000118, + 0x1190000011A, + 0x11B0000011C, + 0x11D0000011E, + 0x11F00000120, + 0x12100000122, + 0x12300000124, + 0x12500000126, + 0x12700000128, + 0x1290000012A, + 0x12B0000012C, + 0x12D0000012E, + 0x12F00000130, + 0x13100000132, + 0x13500000136, + 0x13700000139, + 0x13A0000013B, + 0x13C0000013D, + 0x13E0000013F, + 0x14200000143, + 0x14400000145, + 0x14600000147, + 0x14800000149, + 0x14B0000014C, + 0x14D0000014E, + 0x14F00000150, + 0x15100000152, + 0x15300000154, + 0x15500000156, + 0x15700000158, + 0x1590000015A, + 0x15B0000015C, + 0x15D0000015E, + 0x15F00000160, + 0x16100000162, + 0x16300000164, + 0x16500000166, + 0x16700000168, + 0x1690000016A, + 0x16B0000016C, + 0x16D0000016E, + 0x16F00000170, + 0x17100000172, + 0x17300000174, + 0x17500000176, + 0x17700000178, + 0x17A0000017B, + 0x17C0000017D, + 0x17E0000017F, + 0x18000000181, + 0x18300000184, + 0x18500000186, + 0x18800000189, + 0x18C0000018E, + 0x19200000193, + 0x19500000196, + 0x1990000019C, + 0x19E0000019F, + 0x1A1000001A2, + 0x1A3000001A4, + 0x1A5000001A6, + 0x1A8000001A9, + 0x1AA000001AC, + 0x1AD000001AE, + 0x1B0000001B1, + 0x1B4000001B5, + 0x1B6000001B7, + 0x1B9000001BC, + 0x1BD000001C4, + 0x1CE000001CF, + 0x1D0000001D1, + 0x1D2000001D3, + 0x1D4000001D5, + 0x1D6000001D7, + 0x1D8000001D9, + 0x1DA000001DB, + 0x1DC000001DE, + 0x1DF000001E0, + 0x1E1000001E2, + 0x1E3000001E4, + 0x1E5000001E6, + 0x1E7000001E8, + 0x1E9000001EA, + 0x1EB000001EC, + 0x1ED000001EE, + 0x1EF000001F1, + 0x1F5000001F6, + 0x1F9000001FA, + 0x1FB000001FC, + 0x1FD000001FE, + 0x1FF00000200, + 0x20100000202, + 0x20300000204, + 0x20500000206, + 0x20700000208, + 0x2090000020A, + 0x20B0000020C, + 0x20D0000020E, + 0x20F00000210, + 0x21100000212, + 0x21300000214, + 0x21500000216, + 0x21700000218, + 0x2190000021A, + 0x21B0000021C, + 0x21D0000021E, + 0x21F00000220, + 0x22100000222, + 0x22300000224, + 0x22500000226, + 0x22700000228, + 0x2290000022A, + 0x22B0000022C, + 0x22D0000022E, + 0x22F00000230, + 0x23100000232, + 0x2330000023A, + 0x23C0000023D, + 0x23F00000241, + 0x24200000243, + 0x24700000248, + 0x2490000024A, + 0x24B0000024C, + 0x24D0000024E, + 0x24F000002B0, + 0x2B9000002C2, + 0x2C6000002D2, + 0x2EC000002ED, + 0x2EE000002EF, + 0x30000000340, + 0x34200000343, + 0x3460000034F, + 0x35000000370, + 0x37100000372, + 0x37300000374, + 0x37700000378, + 0x37B0000037E, + 0x39000000391, + 0x3AC000003CF, + 0x3D7000003D8, + 0x3D9000003DA, + 0x3DB000003DC, + 0x3DD000003DE, + 0x3DF000003E0, + 0x3E1000003E2, + 0x3E3000003E4, + 0x3E5000003E6, + 0x3E7000003E8, + 0x3E9000003EA, + 0x3EB000003EC, + 0x3ED000003EE, + 0x3EF000003F0, + 0x3F3000003F4, + 0x3F8000003F9, + 0x3FB000003FD, + 0x43000000460, + 0x46100000462, + 0x46300000464, + 0x46500000466, + 0x46700000468, + 0x4690000046A, + 0x46B0000046C, + 0x46D0000046E, + 0x46F00000470, + 0x47100000472, + 0x47300000474, + 0x47500000476, + 0x47700000478, + 0x4790000047A, + 0x47B0000047C, + 0x47D0000047E, + 0x47F00000480, + 0x48100000482, + 0x48300000488, + 0x48B0000048C, + 0x48D0000048E, + 0x48F00000490, + 0x49100000492, + 0x49300000494, + 0x49500000496, + 0x49700000498, + 0x4990000049A, + 0x49B0000049C, + 0x49D0000049E, + 0x49F000004A0, + 0x4A1000004A2, + 0x4A3000004A4, + 0x4A5000004A6, + 0x4A7000004A8, + 0x4A9000004AA, + 0x4AB000004AC, + 0x4AD000004AE, + 0x4AF000004B0, + 0x4B1000004B2, + 0x4B3000004B4, + 0x4B5000004B6, + 0x4B7000004B8, + 0x4B9000004BA, + 0x4BB000004BC, + 0x4BD000004BE, + 0x4BF000004C0, + 0x4C2000004C3, + 0x4C4000004C5, + 0x4C6000004C7, + 0x4C8000004C9, + 0x4CA000004CB, + 0x4CC000004CD, + 0x4CE000004D0, + 0x4D1000004D2, + 0x4D3000004D4, + 0x4D5000004D6, + 0x4D7000004D8, + 0x4D9000004DA, + 0x4DB000004DC, + 0x4DD000004DE, + 0x4DF000004E0, + 0x4E1000004E2, + 0x4E3000004E4, + 0x4E5000004E6, + 0x4E7000004E8, + 0x4E9000004EA, + 0x4EB000004EC, + 0x4ED000004EE, + 0x4EF000004F0, + 0x4F1000004F2, + 0x4F3000004F4, + 0x4F5000004F6, + 0x4F7000004F8, + 0x4F9000004FA, + 0x4FB000004FC, + 0x4FD000004FE, + 0x4FF00000500, + 0x50100000502, + 0x50300000504, + 0x50500000506, + 0x50700000508, + 0x5090000050A, + 0x50B0000050C, + 0x50D0000050E, + 0x50F00000510, + 0x51100000512, + 0x51300000514, + 0x51500000516, + 0x51700000518, + 0x5190000051A, + 0x51B0000051C, + 0x51D0000051E, + 0x51F00000520, + 0x52100000522, + 0x52300000524, + 0x52500000526, + 0x52700000528, + 0x5290000052A, + 0x52B0000052C, + 0x52D0000052E, + 0x52F00000530, + 0x5590000055A, + 0x56000000587, + 0x58800000589, + 0x591000005BE, + 0x5BF000005C0, + 0x5C1000005C3, + 0x5C4000005C6, + 0x5C7000005C8, + 0x5D0000005EB, + 0x5EF000005F3, + 0x6100000061B, + 0x62000000640, + 0x64100000660, + 0x66E00000675, + 0x679000006D4, + 0x6D5000006DD, + 0x6DF000006E9, + 0x6EA000006F0, + 0x6FA00000700, + 0x7100000074B, + 0x74D000007B2, + 0x7C0000007F6, + 0x7FD000007FE, + 0x8000000082E, + 0x8400000085C, + 0x8600000086B, + 0x87000000888, + 0x8890000088F, + 0x898000008E2, + 0x8E300000958, + 0x96000000964, + 0x96600000970, + 0x97100000984, + 0x9850000098D, + 0x98F00000991, + 0x993000009A9, + 0x9AA000009B1, + 0x9B2000009B3, + 0x9B6000009BA, + 0x9BC000009C5, + 0x9C7000009C9, + 0x9CB000009CF, + 0x9D7000009D8, + 0x9E0000009E4, + 0x9E6000009F2, + 0x9FC000009FD, + 0x9FE000009FF, + 0xA0100000A04, + 0xA0500000A0B, + 0xA0F00000A11, + 0xA1300000A29, + 0xA2A00000A31, + 0xA3200000A33, + 0xA3500000A36, + 0xA3800000A3A, + 0xA3C00000A3D, + 0xA3E00000A43, + 0xA4700000A49, + 0xA4B00000A4E, + 0xA5100000A52, + 0xA5C00000A5D, + 0xA6600000A76, + 0xA8100000A84, + 0xA8500000A8E, + 0xA8F00000A92, + 0xA9300000AA9, + 0xAAA00000AB1, + 0xAB200000AB4, + 0xAB500000ABA, + 0xABC00000AC6, + 0xAC700000ACA, + 0xACB00000ACE, + 0xAD000000AD1, + 0xAE000000AE4, + 0xAE600000AF0, + 0xAF900000B00, + 0xB0100000B04, + 0xB0500000B0D, + 0xB0F00000B11, + 0xB1300000B29, + 0xB2A00000B31, + 0xB3200000B34, + 0xB3500000B3A, + 0xB3C00000B45, + 0xB4700000B49, + 0xB4B00000B4E, + 0xB5500000B58, + 0xB5F00000B64, + 0xB6600000B70, + 0xB7100000B72, + 0xB8200000B84, + 0xB8500000B8B, + 0xB8E00000B91, + 0xB9200000B96, + 0xB9900000B9B, + 0xB9C00000B9D, + 0xB9E00000BA0, + 0xBA300000BA5, + 0xBA800000BAB, + 0xBAE00000BBA, + 0xBBE00000BC3, + 0xBC600000BC9, + 0xBCA00000BCE, + 0xBD000000BD1, + 0xBD700000BD8, + 0xBE600000BF0, + 0xC0000000C0D, + 0xC0E00000C11, + 0xC1200000C29, + 0xC2A00000C3A, + 0xC3C00000C45, + 0xC4600000C49, + 0xC4A00000C4E, + 0xC5500000C57, + 0xC5800000C5B, + 0xC5D00000C5E, + 0xC6000000C64, + 0xC6600000C70, + 0xC8000000C84, + 0xC8500000C8D, + 0xC8E00000C91, + 0xC9200000CA9, + 0xCAA00000CB4, + 0xCB500000CBA, + 0xCBC00000CC5, + 0xCC600000CC9, + 0xCCA00000CCE, + 0xCD500000CD7, + 0xCDD00000CDF, + 0xCE000000CE4, + 0xCE600000CF0, + 0xCF100000CF4, + 0xD0000000D0D, + 0xD0E00000D11, + 0xD1200000D45, + 0xD4600000D49, + 0xD4A00000D4F, + 0xD5400000D58, + 0xD5F00000D64, + 0xD6600000D70, + 0xD7A00000D80, + 0xD8100000D84, + 0xD8500000D97, + 0xD9A00000DB2, + 0xDB300000DBC, + 0xDBD00000DBE, + 0xDC000000DC7, + 0xDCA00000DCB, + 0xDCF00000DD5, + 0xDD600000DD7, + 0xDD800000DE0, + 0xDE600000DF0, + 0xDF200000DF4, + 0xE0100000E33, + 0xE3400000E3B, + 0xE4000000E4F, + 0xE5000000E5A, + 0xE8100000E83, + 0xE8400000E85, + 0xE8600000E8B, + 0xE8C00000EA4, + 0xEA500000EA6, + 0xEA700000EB3, + 0xEB400000EBE, + 0xEC000000EC5, + 0xEC600000EC7, + 0xEC800000ECF, + 0xED000000EDA, + 0xEDE00000EE0, + 0xF0000000F01, + 0xF0B00000F0C, + 0xF1800000F1A, + 0xF2000000F2A, + 0xF3500000F36, + 0xF3700000F38, + 0xF3900000F3A, + 0xF3E00000F43, + 0xF4400000F48, + 0xF4900000F4D, + 0xF4E00000F52, + 0xF5300000F57, + 0xF5800000F5C, + 0xF5D00000F69, + 0xF6A00000F6D, + 0xF7100000F73, + 0xF7400000F75, + 0xF7A00000F81, + 0xF8200000F85, + 0xF8600000F93, + 0xF9400000F98, + 0xF9900000F9D, + 0xF9E00000FA2, + 0xFA300000FA7, + 0xFA800000FAC, + 0xFAD00000FB9, + 0xFBA00000FBD, + 0xFC600000FC7, + 0x10000000104A, + 0x10500000109E, + 0x10D0000010FB, + 0x10FD00001100, + 0x120000001249, + 0x124A0000124E, + 0x125000001257, + 0x125800001259, + 0x125A0000125E, + 0x126000001289, + 0x128A0000128E, + 0x1290000012B1, + 0x12B2000012B6, + 0x12B8000012BF, + 0x12C0000012C1, + 0x12C2000012C6, + 0x12C8000012D7, + 0x12D800001311, + 0x131200001316, + 0x13180000135B, + 0x135D00001360, + 0x138000001390, + 0x13A0000013F6, + 0x14010000166D, + 0x166F00001680, + 0x16810000169B, + 0x16A0000016EB, + 0x16F1000016F9, + 0x170000001716, + 0x171F00001735, + 0x174000001754, + 0x17600000176D, + 0x176E00001771, + 0x177200001774, + 0x1780000017B4, + 0x17B6000017D4, + 0x17D7000017D8, + 0x17DC000017DE, + 0x17E0000017EA, + 0x18100000181A, + 0x182000001879, + 0x1880000018AB, + 0x18B0000018F6, + 0x19000000191F, + 0x19200000192C, + 0x19300000193C, + 0x19460000196E, + 0x197000001975, + 0x1980000019AC, + 0x19B0000019CA, + 0x19D0000019DA, + 0x1A0000001A1C, + 0x1A2000001A5F, + 0x1A6000001A7D, + 0x1A7F00001A8A, + 0x1A9000001A9A, + 0x1AA700001AA8, + 0x1AB000001ABE, + 0x1ABF00001ACF, + 0x1B0000001B4D, + 0x1B5000001B5A, + 0x1B6B00001B74, + 0x1B8000001BF4, + 0x1C0000001C38, + 0x1C4000001C4A, + 0x1C4D00001C7E, + 0x1CD000001CD3, + 0x1CD400001CFB, + 0x1D0000001D2C, + 0x1D2F00001D30, + 0x1D3B00001D3C, + 0x1D4E00001D4F, + 0x1D6B00001D78, + 0x1D7900001D9B, + 0x1DC000001E00, + 0x1E0100001E02, + 0x1E0300001E04, + 0x1E0500001E06, + 0x1E0700001E08, + 0x1E0900001E0A, + 0x1E0B00001E0C, + 0x1E0D00001E0E, + 0x1E0F00001E10, + 0x1E1100001E12, + 0x1E1300001E14, + 0x1E1500001E16, + 0x1E1700001E18, + 0x1E1900001E1A, + 0x1E1B00001E1C, + 0x1E1D00001E1E, + 0x1E1F00001E20, + 0x1E2100001E22, + 0x1E2300001E24, + 0x1E2500001E26, + 0x1E2700001E28, + 0x1E2900001E2A, + 0x1E2B00001E2C, + 0x1E2D00001E2E, + 0x1E2F00001E30, + 0x1E3100001E32, + 0x1E3300001E34, + 0x1E3500001E36, + 0x1E3700001E38, + 0x1E3900001E3A, + 0x1E3B00001E3C, + 0x1E3D00001E3E, + 0x1E3F00001E40, + 0x1E4100001E42, + 0x1E4300001E44, + 0x1E4500001E46, + 0x1E4700001E48, + 0x1E4900001E4A, + 0x1E4B00001E4C, + 0x1E4D00001E4E, + 0x1E4F00001E50, + 0x1E5100001E52, + 0x1E5300001E54, + 0x1E5500001E56, + 0x1E5700001E58, + 0x1E5900001E5A, + 0x1E5B00001E5C, + 0x1E5D00001E5E, + 0x1E5F00001E60, + 0x1E6100001E62, + 0x1E6300001E64, + 0x1E6500001E66, + 0x1E6700001E68, + 0x1E6900001E6A, + 0x1E6B00001E6C, + 0x1E6D00001E6E, + 0x1E6F00001E70, + 0x1E7100001E72, + 0x1E7300001E74, + 0x1E7500001E76, + 0x1E7700001E78, + 0x1E7900001E7A, + 0x1E7B00001E7C, + 0x1E7D00001E7E, + 0x1E7F00001E80, + 0x1E8100001E82, + 0x1E8300001E84, + 0x1E8500001E86, + 0x1E8700001E88, + 0x1E8900001E8A, + 0x1E8B00001E8C, + 0x1E8D00001E8E, + 0x1E8F00001E90, + 0x1E9100001E92, + 0x1E9300001E94, + 0x1E9500001E9A, + 0x1E9C00001E9E, + 0x1E9F00001EA0, + 0x1EA100001EA2, + 0x1EA300001EA4, + 0x1EA500001EA6, + 0x1EA700001EA8, + 0x1EA900001EAA, + 0x1EAB00001EAC, + 0x1EAD00001EAE, + 0x1EAF00001EB0, + 0x1EB100001EB2, + 0x1EB300001EB4, + 0x1EB500001EB6, + 0x1EB700001EB8, + 0x1EB900001EBA, + 0x1EBB00001EBC, + 0x1EBD00001EBE, + 0x1EBF00001EC0, + 0x1EC100001EC2, + 0x1EC300001EC4, + 0x1EC500001EC6, + 0x1EC700001EC8, + 0x1EC900001ECA, + 0x1ECB00001ECC, + 0x1ECD00001ECE, + 0x1ECF00001ED0, + 0x1ED100001ED2, + 0x1ED300001ED4, + 0x1ED500001ED6, + 0x1ED700001ED8, + 0x1ED900001EDA, + 0x1EDB00001EDC, + 0x1EDD00001EDE, + 0x1EDF00001EE0, + 0x1EE100001EE2, + 0x1EE300001EE4, + 0x1EE500001EE6, + 0x1EE700001EE8, + 0x1EE900001EEA, + 0x1EEB00001EEC, + 0x1EED00001EEE, + 0x1EEF00001EF0, + 0x1EF100001EF2, + 0x1EF300001EF4, + 0x1EF500001EF6, + 0x1EF700001EF8, + 0x1EF900001EFA, + 0x1EFB00001EFC, + 0x1EFD00001EFE, + 0x1EFF00001F08, + 0x1F1000001F16, + 0x1F2000001F28, + 0x1F3000001F38, + 0x1F4000001F46, + 0x1F5000001F58, + 0x1F6000001F68, + 0x1F7000001F71, + 0x1F7200001F73, + 0x1F7400001F75, + 0x1F7600001F77, + 0x1F7800001F79, + 0x1F7A00001F7B, + 0x1F7C00001F7D, + 0x1FB000001FB2, + 0x1FB600001FB7, + 0x1FC600001FC7, + 0x1FD000001FD3, + 0x1FD600001FD8, + 0x1FE000001FE3, + 0x1FE400001FE8, + 0x1FF600001FF7, + 0x214E0000214F, + 0x218400002185, + 0x2C3000002C60, + 0x2C6100002C62, + 0x2C6500002C67, + 0x2C6800002C69, + 0x2C6A00002C6B, + 0x2C6C00002C6D, + 0x2C7100002C72, + 0x2C7300002C75, + 0x2C7600002C7C, + 0x2C8100002C82, + 0x2C8300002C84, + 0x2C8500002C86, + 0x2C8700002C88, + 0x2C8900002C8A, + 0x2C8B00002C8C, + 0x2C8D00002C8E, + 0x2C8F00002C90, + 0x2C9100002C92, + 0x2C9300002C94, + 0x2C9500002C96, + 0x2C9700002C98, + 0x2C9900002C9A, + 0x2C9B00002C9C, + 0x2C9D00002C9E, + 0x2C9F00002CA0, + 0x2CA100002CA2, + 0x2CA300002CA4, + 0x2CA500002CA6, + 0x2CA700002CA8, + 0x2CA900002CAA, + 0x2CAB00002CAC, + 0x2CAD00002CAE, + 0x2CAF00002CB0, + 0x2CB100002CB2, + 0x2CB300002CB4, + 0x2CB500002CB6, + 0x2CB700002CB8, + 0x2CB900002CBA, + 0x2CBB00002CBC, + 0x2CBD00002CBE, + 0x2CBF00002CC0, + 0x2CC100002CC2, + 0x2CC300002CC4, + 0x2CC500002CC6, + 0x2CC700002CC8, + 0x2CC900002CCA, + 0x2CCB00002CCC, + 0x2CCD00002CCE, + 0x2CCF00002CD0, + 0x2CD100002CD2, + 0x2CD300002CD4, + 0x2CD500002CD6, + 0x2CD700002CD8, + 0x2CD900002CDA, + 0x2CDB00002CDC, + 0x2CDD00002CDE, + 0x2CDF00002CE0, + 0x2CE100002CE2, + 0x2CE300002CE5, + 0x2CEC00002CED, + 0x2CEE00002CF2, + 0x2CF300002CF4, + 0x2D0000002D26, + 0x2D2700002D28, + 0x2D2D00002D2E, + 0x2D3000002D68, + 0x2D7F00002D97, + 0x2DA000002DA7, + 0x2DA800002DAF, + 0x2DB000002DB7, + 0x2DB800002DBF, + 0x2DC000002DC7, + 0x2DC800002DCF, + 0x2DD000002DD7, + 0x2DD800002DDF, + 0x2DE000002E00, + 0x2E2F00002E30, + 0x300500003008, + 0x302A0000302E, + 0x303C0000303D, + 0x304100003097, + 0x30990000309B, + 0x309D0000309F, + 0x30A1000030FB, + 0x30FC000030FF, + 0x310500003130, + 0x31A0000031C0, + 0x31F000003200, + 0x340000004DC0, + 0x4E000000A48D, + 0xA4D00000A4FE, + 0xA5000000A60D, + 0xA6100000A62C, + 0xA6410000A642, + 0xA6430000A644, + 0xA6450000A646, + 0xA6470000A648, + 0xA6490000A64A, + 0xA64B0000A64C, + 0xA64D0000A64E, + 0xA64F0000A650, + 0xA6510000A652, + 0xA6530000A654, + 0xA6550000A656, + 0xA6570000A658, + 0xA6590000A65A, + 0xA65B0000A65C, + 0xA65D0000A65E, + 0xA65F0000A660, + 0xA6610000A662, + 0xA6630000A664, + 0xA6650000A666, + 0xA6670000A668, + 0xA6690000A66A, + 0xA66B0000A66C, + 0xA66D0000A670, + 0xA6740000A67E, + 0xA67F0000A680, + 0xA6810000A682, + 0xA6830000A684, + 0xA6850000A686, + 0xA6870000A688, + 0xA6890000A68A, + 0xA68B0000A68C, + 0xA68D0000A68E, + 0xA68F0000A690, + 0xA6910000A692, + 0xA6930000A694, + 0xA6950000A696, + 0xA6970000A698, + 0xA6990000A69A, + 0xA69B0000A69C, + 0xA69E0000A6E6, + 0xA6F00000A6F2, + 0xA7170000A720, + 0xA7230000A724, + 0xA7250000A726, + 0xA7270000A728, + 0xA7290000A72A, + 0xA72B0000A72C, + 0xA72D0000A72E, + 0xA72F0000A732, + 0xA7330000A734, + 0xA7350000A736, + 0xA7370000A738, + 0xA7390000A73A, + 0xA73B0000A73C, + 0xA73D0000A73E, + 0xA73F0000A740, + 0xA7410000A742, + 0xA7430000A744, + 0xA7450000A746, + 0xA7470000A748, + 0xA7490000A74A, + 0xA74B0000A74C, + 0xA74D0000A74E, + 0xA74F0000A750, + 0xA7510000A752, + 0xA7530000A754, + 0xA7550000A756, + 0xA7570000A758, + 0xA7590000A75A, + 0xA75B0000A75C, + 0xA75D0000A75E, + 0xA75F0000A760, + 0xA7610000A762, + 0xA7630000A764, + 0xA7650000A766, + 0xA7670000A768, + 0xA7690000A76A, + 0xA76B0000A76C, + 0xA76D0000A76E, + 0xA76F0000A770, + 0xA7710000A779, + 0xA77A0000A77B, + 0xA77C0000A77D, + 0xA77F0000A780, + 0xA7810000A782, + 0xA7830000A784, + 0xA7850000A786, + 0xA7870000A789, + 0xA78C0000A78D, + 0xA78E0000A790, + 0xA7910000A792, + 0xA7930000A796, + 0xA7970000A798, + 0xA7990000A79A, + 0xA79B0000A79C, + 0xA79D0000A79E, + 0xA79F0000A7A0, + 0xA7A10000A7A2, + 0xA7A30000A7A4, + 0xA7A50000A7A6, + 0xA7A70000A7A8, + 0xA7A90000A7AA, + 0xA7AF0000A7B0, + 0xA7B50000A7B6, + 0xA7B70000A7B8, + 0xA7B90000A7BA, + 0xA7BB0000A7BC, + 0xA7BD0000A7BE, + 0xA7BF0000A7C0, + 0xA7C10000A7C2, + 0xA7C30000A7C4, + 0xA7C80000A7C9, + 0xA7CA0000A7CB, + 0xA7D10000A7D2, + 0xA7D30000A7D4, + 0xA7D50000A7D6, + 0xA7D70000A7D8, + 0xA7D90000A7DA, + 0xA7F60000A7F8, + 0xA7FA0000A828, + 0xA82C0000A82D, + 0xA8400000A874, + 0xA8800000A8C6, + 0xA8D00000A8DA, + 0xA8E00000A8F8, + 0xA8FB0000A8FC, + 0xA8FD0000A92E, + 0xA9300000A954, + 0xA9800000A9C1, + 0xA9CF0000A9DA, + 0xA9E00000A9FF, + 0xAA000000AA37, + 0xAA400000AA4E, + 0xAA500000AA5A, + 0xAA600000AA77, + 0xAA7A0000AAC3, + 0xAADB0000AADE, + 0xAAE00000AAF0, + 0xAAF20000AAF7, + 0xAB010000AB07, + 0xAB090000AB0F, + 0xAB110000AB17, + 0xAB200000AB27, + 0xAB280000AB2F, + 0xAB300000AB5B, + 0xAB600000AB69, + 0xABC00000ABEB, + 0xABEC0000ABEE, + 0xABF00000ABFA, + 0xAC000000D7A4, + 0xFA0E0000FA10, + 0xFA110000FA12, + 0xFA130000FA15, + 0xFA1F0000FA20, + 0xFA210000FA22, + 0xFA230000FA25, + 0xFA270000FA2A, + 0xFB1E0000FB1F, + 0xFE200000FE30, + 0xFE730000FE74, + 0x100000001000C, + 0x1000D00010027, + 0x100280001003B, + 0x1003C0001003E, + 0x1003F0001004E, + 0x100500001005E, + 0x10080000100FB, + 0x101FD000101FE, + 0x102800001029D, + 0x102A0000102D1, + 0x102E0000102E1, + 0x1030000010320, + 0x1032D00010341, + 0x103420001034A, + 0x103500001037B, + 0x103800001039E, + 0x103A0000103C4, + 0x103C8000103D0, + 0x104280001049E, + 0x104A0000104AA, + 0x104D8000104FC, + 0x1050000010528, + 0x1053000010564, + 0x10597000105A2, + 0x105A3000105B2, + 0x105B3000105BA, + 0x105BB000105BD, + 0x1060000010737, + 0x1074000010756, + 0x1076000010768, + 0x1078000010781, + 0x1080000010806, + 0x1080800010809, + 0x1080A00010836, + 0x1083700010839, + 0x1083C0001083D, + 0x1083F00010856, + 0x1086000010877, + 0x108800001089F, + 0x108E0000108F3, + 0x108F4000108F6, + 0x1090000010916, + 0x109200001093A, + 0x10980000109B8, + 0x109BE000109C0, + 0x10A0000010A04, + 0x10A0500010A07, + 0x10A0C00010A14, + 0x10A1500010A18, + 0x10A1900010A36, + 0x10A3800010A3B, + 0x10A3F00010A40, + 0x10A6000010A7D, + 0x10A8000010A9D, + 0x10AC000010AC8, + 0x10AC900010AE7, + 0x10B0000010B36, + 0x10B4000010B56, + 0x10B6000010B73, + 0x10B8000010B92, + 0x10C0000010C49, + 0x10CC000010CF3, + 0x10D0000010D28, + 0x10D3000010D3A, + 0x10E8000010EAA, + 0x10EAB00010EAD, + 0x10EB000010EB2, + 0x10EFD00010F1D, + 0x10F2700010F28, + 0x10F3000010F51, + 0x10F7000010F86, + 0x10FB000010FC5, + 0x10FE000010FF7, + 0x1100000011047, + 0x1106600011076, + 0x1107F000110BB, + 0x110C2000110C3, + 0x110D0000110E9, + 0x110F0000110FA, + 0x1110000011135, + 0x1113600011140, + 0x1114400011148, + 0x1115000011174, + 0x1117600011177, + 0x11180000111C5, + 0x111C9000111CD, + 0x111CE000111DB, + 0x111DC000111DD, + 0x1120000011212, + 0x1121300011238, + 0x1123E00011242, + 0x1128000011287, + 0x1128800011289, + 0x1128A0001128E, + 0x1128F0001129E, + 0x1129F000112A9, + 0x112B0000112EB, + 0x112F0000112FA, + 0x1130000011304, + 0x113050001130D, + 0x1130F00011311, + 0x1131300011329, + 0x1132A00011331, + 0x1133200011334, + 0x113350001133A, + 0x1133B00011345, + 0x1134700011349, + 0x1134B0001134E, + 0x1135000011351, + 0x1135700011358, + 0x1135D00011364, + 0x113660001136D, + 0x1137000011375, + 0x114000001144B, + 0x114500001145A, + 0x1145E00011462, + 0x11480000114C6, + 0x114C7000114C8, + 0x114D0000114DA, + 0x11580000115B6, + 0x115B8000115C1, + 0x115D8000115DE, + 0x1160000011641, + 0x1164400011645, + 0x116500001165A, + 0x11680000116B9, + 0x116C0000116CA, + 0x117000001171B, + 0x1171D0001172C, + 0x117300001173A, + 0x1174000011747, + 0x118000001183B, + 0x118C0000118EA, + 0x118FF00011907, + 0x119090001190A, + 0x1190C00011914, + 0x1191500011917, + 0x1191800011936, + 0x1193700011939, + 0x1193B00011944, + 0x119500001195A, + 0x119A0000119A8, + 0x119AA000119D8, + 0x119DA000119E2, + 0x119E3000119E5, + 0x11A0000011A3F, + 0x11A4700011A48, + 0x11A5000011A9A, + 0x11A9D00011A9E, + 0x11AB000011AF9, + 0x11C0000011C09, + 0x11C0A00011C37, + 0x11C3800011C41, + 0x11C5000011C5A, + 0x11C7200011C90, + 0x11C9200011CA8, + 0x11CA900011CB7, + 0x11D0000011D07, + 0x11D0800011D0A, + 0x11D0B00011D37, + 0x11D3A00011D3B, + 0x11D3C00011D3E, + 0x11D3F00011D48, + 0x11D5000011D5A, + 0x11D6000011D66, + 0x11D6700011D69, + 0x11D6A00011D8F, + 0x11D9000011D92, + 0x11D9300011D99, + 0x11DA000011DAA, + 0x11EE000011EF7, + 0x11F0000011F11, + 0x11F1200011F3B, + 0x11F3E00011F43, + 0x11F5000011F5A, + 0x11FB000011FB1, + 0x120000001239A, + 0x1248000012544, + 0x12F9000012FF1, + 0x1300000013430, + 0x1344000013456, + 0x1440000014647, + 0x1680000016A39, + 0x16A4000016A5F, + 0x16A6000016A6A, + 0x16A7000016ABF, + 0x16AC000016ACA, + 0x16AD000016AEE, + 0x16AF000016AF5, + 0x16B0000016B37, + 0x16B4000016B44, + 0x16B5000016B5A, + 0x16B6300016B78, + 0x16B7D00016B90, + 0x16E6000016E80, + 0x16F0000016F4B, + 0x16F4F00016F88, + 0x16F8F00016FA0, + 0x16FE000016FE2, + 0x16FE300016FE5, + 0x16FF000016FF2, + 0x17000000187F8, + 0x1880000018CD6, + 0x18D0000018D09, + 0x1AFF00001AFF4, + 0x1AFF50001AFFC, + 0x1AFFD0001AFFF, + 0x1B0000001B123, + 0x1B1320001B133, + 0x1B1500001B153, + 0x1B1550001B156, + 0x1B1640001B168, + 0x1B1700001B2FC, + 0x1BC000001BC6B, + 0x1BC700001BC7D, + 0x1BC800001BC89, + 0x1BC900001BC9A, + 0x1BC9D0001BC9F, + 0x1CF000001CF2E, + 0x1CF300001CF47, + 0x1DA000001DA37, + 0x1DA3B0001DA6D, + 0x1DA750001DA76, + 0x1DA840001DA85, + 0x1DA9B0001DAA0, + 0x1DAA10001DAB0, + 0x1DF000001DF1F, + 0x1DF250001DF2B, + 0x1E0000001E007, + 0x1E0080001E019, + 0x1E01B0001E022, + 0x1E0230001E025, + 0x1E0260001E02B, + 0x1E08F0001E090, + 0x1E1000001E12D, + 0x1E1300001E13E, + 0x1E1400001E14A, + 0x1E14E0001E14F, + 0x1E2900001E2AF, + 0x1E2C00001E2FA, + 0x1E4D00001E4FA, + 0x1E7E00001E7E7, + 0x1E7E80001E7EC, + 0x1E7ED0001E7EF, + 0x1E7F00001E7FF, + 0x1E8000001E8C5, + 0x1E8D00001E8D7, + 0x1E9220001E94C, + 0x1E9500001E95A, + 0x200000002A6E0, + 0x2A7000002B73A, + 0x2B7400002B81E, + 0x2B8200002CEA2, + 0x2CEB00002EBE1, + 0x2EBF00002EE5E, + 0x300000003134B, + 0x31350000323B0, + ), + "CONTEXTJ": (0x200C0000200E,), + "CONTEXTO": ( + 0xB7000000B8, + 0x37500000376, + 0x5F3000005F5, + 0x6600000066A, + 0x6F0000006FA, + 0x30FB000030FC, + ), +} diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/idna/intranges.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/idna/intranges.py new file mode 100644 index 0000000..7bfaa8d --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/idna/intranges.py @@ -0,0 +1,57 @@ +""" +Given a list of integers, made up of (hopefully) a small number of long runs +of consecutive integers, compute a representation of the form +((start1, end1), (start2, end2) ...). Then answer the question "was x present +in the original list?" in time O(log(# runs)). +""" + +import bisect +from typing import List, Tuple + + +def intranges_from_list(list_: List[int]) -> Tuple[int, ...]: + """Represent a list of integers as a sequence of ranges: + ((start_0, end_0), (start_1, end_1), ...), such that the original + integers are exactly those x such that start_i <= x < end_i for some i. + + Ranges are encoded as single integers (start << 32 | end), not as tuples. + """ + + sorted_list = sorted(list_) + ranges = [] + last_write = -1 + for i in range(len(sorted_list)): + if i + 1 < len(sorted_list): + if sorted_list[i] == sorted_list[i + 1] - 1: + continue + current_range = sorted_list[last_write + 1 : i + 1] + ranges.append(_encode_range(current_range[0], current_range[-1] + 1)) + last_write = i + + return tuple(ranges) + + +def _encode_range(start: int, end: int) -> int: + return (start << 32) | end + + +def _decode_range(r: int) -> Tuple[int, int]: + return (r >> 32), (r & ((1 << 32) - 1)) + + +def intranges_contain(int_: int, ranges: Tuple[int, ...]) -> bool: + """Determine if `int_` falls into one of the ranges in `ranges`.""" + tuple_ = _encode_range(int_, 0) + pos = bisect.bisect_left(ranges, tuple_) + # we could be immediately ahead of a tuple (start, end) + # with start < int_ <= end + if pos > 0: + left, right = _decode_range(ranges[pos - 1]) + if left <= int_ < right: + return True + # or we could be immediately behind a tuple (int_, end) + if pos < len(ranges): + left, _ = _decode_range(ranges[pos]) + if left == int_: + return True + return False diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/idna/package_data.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/idna/package_data.py new file mode 100644 index 0000000..514ff7e --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/idna/package_data.py @@ -0,0 +1 @@ +__version__ = "3.10" diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/idna/py.typed b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/idna/py.typed new file mode 100644 index 0000000..e69de29 diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/idna/uts46data.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/idna/uts46data.py new file mode 100644 index 0000000..eb89432 --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/idna/uts46data.py @@ -0,0 +1,8681 @@ +# This file is automatically generated by tools/idna-data +# vim: set fileencoding=utf-8 : + +from typing import List, Tuple, Union + +"""IDNA Mapping Table from UTS46.""" + + +__version__ = "15.1.0" + + +def _seg_0() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x0, "3"), + (0x1, "3"), + (0x2, "3"), + (0x3, "3"), + (0x4, "3"), + (0x5, "3"), + (0x6, "3"), + (0x7, "3"), + (0x8, "3"), + (0x9, "3"), + (0xA, "3"), + (0xB, "3"), + (0xC, "3"), + (0xD, "3"), + (0xE, "3"), + (0xF, "3"), + (0x10, "3"), + (0x11, "3"), + (0x12, "3"), + (0x13, "3"), + (0x14, "3"), + (0x15, "3"), + (0x16, "3"), + (0x17, "3"), + (0x18, "3"), + (0x19, "3"), + (0x1A, "3"), + (0x1B, "3"), + (0x1C, "3"), + (0x1D, "3"), + (0x1E, "3"), + (0x1F, "3"), + (0x20, "3"), + (0x21, "3"), + (0x22, "3"), + (0x23, "3"), + (0x24, "3"), + (0x25, "3"), + (0x26, "3"), + (0x27, "3"), + (0x28, "3"), + (0x29, "3"), + (0x2A, "3"), + (0x2B, "3"), + (0x2C, "3"), + (0x2D, "V"), + (0x2E, "V"), + (0x2F, "3"), + (0x30, "V"), + (0x31, "V"), + (0x32, "V"), + (0x33, "V"), + (0x34, "V"), + (0x35, "V"), + (0x36, "V"), + (0x37, "V"), + (0x38, "V"), + (0x39, "V"), + (0x3A, "3"), + (0x3B, "3"), + (0x3C, "3"), + (0x3D, "3"), + (0x3E, "3"), + (0x3F, "3"), + (0x40, "3"), + (0x41, "M", "a"), + (0x42, "M", "b"), + (0x43, "M", "c"), + (0x44, "M", "d"), + (0x45, "M", "e"), + (0x46, "M", "f"), + (0x47, "M", "g"), + (0x48, "M", "h"), + (0x49, "M", "i"), + (0x4A, "M", "j"), + (0x4B, "M", "k"), + (0x4C, "M", "l"), + (0x4D, "M", "m"), + (0x4E, "M", "n"), + (0x4F, "M", "o"), + (0x50, "M", "p"), + (0x51, "M", "q"), + (0x52, "M", "r"), + (0x53, "M", "s"), + (0x54, "M", "t"), + (0x55, "M", "u"), + (0x56, "M", "v"), + (0x57, "M", "w"), + (0x58, "M", "x"), + (0x59, "M", "y"), + (0x5A, "M", "z"), + (0x5B, "3"), + (0x5C, "3"), + (0x5D, "3"), + (0x5E, "3"), + (0x5F, "3"), + (0x60, "3"), + (0x61, "V"), + (0x62, "V"), + (0x63, "V"), + ] + + +def _seg_1() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x64, "V"), + (0x65, "V"), + (0x66, "V"), + (0x67, "V"), + (0x68, "V"), + (0x69, "V"), + (0x6A, "V"), + (0x6B, "V"), + (0x6C, "V"), + (0x6D, "V"), + (0x6E, "V"), + (0x6F, "V"), + (0x70, "V"), + (0x71, "V"), + (0x72, "V"), + (0x73, "V"), + (0x74, "V"), + (0x75, "V"), + (0x76, "V"), + (0x77, "V"), + (0x78, "V"), + (0x79, "V"), + (0x7A, "V"), + (0x7B, "3"), + (0x7C, "3"), + (0x7D, "3"), + (0x7E, "3"), + (0x7F, "3"), + (0x80, "X"), + (0x81, "X"), + (0x82, "X"), + (0x83, "X"), + (0x84, "X"), + (0x85, "X"), + (0x86, "X"), + (0x87, "X"), + (0x88, "X"), + (0x89, "X"), + (0x8A, "X"), + (0x8B, "X"), + (0x8C, "X"), + (0x8D, "X"), + (0x8E, "X"), + (0x8F, "X"), + (0x90, "X"), + (0x91, "X"), + (0x92, "X"), + (0x93, "X"), + (0x94, "X"), + (0x95, "X"), + (0x96, "X"), + (0x97, "X"), + (0x98, "X"), + (0x99, "X"), + (0x9A, "X"), + (0x9B, "X"), + (0x9C, "X"), + (0x9D, "X"), + (0x9E, "X"), + (0x9F, "X"), + (0xA0, "3", " "), + (0xA1, "V"), + (0xA2, "V"), + (0xA3, "V"), + (0xA4, "V"), + (0xA5, "V"), + (0xA6, "V"), + (0xA7, "V"), + (0xA8, "3", " ̈"), + (0xA9, "V"), + (0xAA, "M", "a"), + (0xAB, "V"), + (0xAC, "V"), + (0xAD, "I"), + (0xAE, "V"), + (0xAF, "3", " ̄"), + (0xB0, "V"), + (0xB1, "V"), + (0xB2, "M", "2"), + (0xB3, "M", "3"), + (0xB4, "3", " ́"), + (0xB5, "M", "μ"), + (0xB6, "V"), + (0xB7, "V"), + (0xB8, "3", " ̧"), + (0xB9, "M", "1"), + (0xBA, "M", "o"), + (0xBB, "V"), + (0xBC, "M", "1⁄4"), + (0xBD, "M", "1⁄2"), + (0xBE, "M", "3⁄4"), + (0xBF, "V"), + (0xC0, "M", "à"), + (0xC1, "M", "á"), + (0xC2, "M", "â"), + (0xC3, "M", "ã"), + (0xC4, "M", "ä"), + (0xC5, "M", "å"), + (0xC6, "M", "æ"), + (0xC7, "M", "ç"), + ] + + +def _seg_2() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0xC8, "M", "è"), + (0xC9, "M", "é"), + (0xCA, "M", "ê"), + (0xCB, "M", "ë"), + (0xCC, "M", "ì"), + (0xCD, "M", "í"), + (0xCE, "M", "î"), + (0xCF, "M", "ï"), + (0xD0, "M", "ð"), + (0xD1, "M", "ñ"), + (0xD2, "M", "ò"), + (0xD3, "M", "ó"), + (0xD4, "M", "ô"), + (0xD5, "M", "õ"), + (0xD6, "M", "ö"), + (0xD7, "V"), + (0xD8, "M", "ø"), + (0xD9, "M", "ù"), + (0xDA, "M", "ú"), + (0xDB, "M", "û"), + (0xDC, "M", "ü"), + (0xDD, "M", "ý"), + (0xDE, "M", "þ"), + (0xDF, "D", "ss"), + (0xE0, "V"), + (0xE1, "V"), + (0xE2, "V"), + (0xE3, "V"), + (0xE4, "V"), + (0xE5, "V"), + (0xE6, "V"), + (0xE7, "V"), + (0xE8, "V"), + (0xE9, "V"), + (0xEA, "V"), + (0xEB, "V"), + (0xEC, "V"), + (0xED, "V"), + (0xEE, "V"), + (0xEF, "V"), + (0xF0, "V"), + (0xF1, "V"), + (0xF2, "V"), + (0xF3, "V"), + (0xF4, "V"), + (0xF5, "V"), + (0xF6, "V"), + (0xF7, "V"), + (0xF8, "V"), + (0xF9, "V"), + (0xFA, "V"), + (0xFB, "V"), + (0xFC, "V"), + (0xFD, "V"), + (0xFE, "V"), + (0xFF, "V"), + (0x100, "M", "ā"), + (0x101, "V"), + (0x102, "M", "ă"), + (0x103, "V"), + (0x104, "M", "ą"), + (0x105, "V"), + (0x106, "M", "ć"), + (0x107, "V"), + (0x108, "M", "ĉ"), + (0x109, "V"), + (0x10A, "M", "ċ"), + (0x10B, "V"), + (0x10C, "M", "č"), + (0x10D, "V"), + (0x10E, "M", "ď"), + (0x10F, "V"), + (0x110, "M", "đ"), + (0x111, "V"), + (0x112, "M", "ē"), + (0x113, "V"), + (0x114, "M", "ĕ"), + (0x115, "V"), + (0x116, "M", "ė"), + (0x117, "V"), + (0x118, "M", "ę"), + (0x119, "V"), + (0x11A, "M", "ě"), + (0x11B, "V"), + (0x11C, "M", "ĝ"), + (0x11D, "V"), + (0x11E, "M", "ğ"), + (0x11F, "V"), + (0x120, "M", "ġ"), + (0x121, "V"), + (0x122, "M", "ģ"), + (0x123, "V"), + (0x124, "M", "ĥ"), + (0x125, "V"), + (0x126, "M", "ħ"), + (0x127, "V"), + (0x128, "M", "ĩ"), + (0x129, "V"), + (0x12A, "M", "ī"), + (0x12B, "V"), + ] + + +def _seg_3() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x12C, "M", "ĭ"), + (0x12D, "V"), + (0x12E, "M", "į"), + (0x12F, "V"), + (0x130, "M", "i̇"), + (0x131, "V"), + (0x132, "M", "ij"), + (0x134, "M", "ĵ"), + (0x135, "V"), + (0x136, "M", "ķ"), + (0x137, "V"), + (0x139, "M", "ĺ"), + (0x13A, "V"), + (0x13B, "M", "ļ"), + (0x13C, "V"), + (0x13D, "M", "ľ"), + (0x13E, "V"), + (0x13F, "M", "l·"), + (0x141, "M", "ł"), + (0x142, "V"), + (0x143, "M", "ń"), + (0x144, "V"), + (0x145, "M", "ņ"), + (0x146, "V"), + (0x147, "M", "ň"), + (0x148, "V"), + (0x149, "M", "ʼn"), + (0x14A, "M", "ŋ"), + (0x14B, "V"), + (0x14C, "M", "ō"), + (0x14D, "V"), + (0x14E, "M", "ŏ"), + (0x14F, "V"), + (0x150, "M", "ő"), + (0x151, "V"), + (0x152, "M", "œ"), + (0x153, "V"), + (0x154, "M", "ŕ"), + (0x155, "V"), + (0x156, "M", "ŗ"), + (0x157, "V"), + (0x158, "M", "ř"), + (0x159, "V"), + (0x15A, "M", "ś"), + (0x15B, "V"), + (0x15C, "M", "ŝ"), + (0x15D, "V"), + (0x15E, "M", "ş"), + (0x15F, "V"), + (0x160, "M", "š"), + (0x161, "V"), + (0x162, "M", "ţ"), + (0x163, "V"), + (0x164, "M", "ť"), + (0x165, "V"), + (0x166, "M", "ŧ"), + (0x167, "V"), + (0x168, "M", "ũ"), + (0x169, "V"), + (0x16A, "M", "ū"), + (0x16B, "V"), + (0x16C, "M", "ŭ"), + (0x16D, "V"), + (0x16E, "M", "ů"), + (0x16F, "V"), + (0x170, "M", "ű"), + (0x171, "V"), + (0x172, "M", "ų"), + (0x173, "V"), + (0x174, "M", "ŵ"), + (0x175, "V"), + (0x176, "M", "ŷ"), + (0x177, "V"), + (0x178, "M", "ÿ"), + (0x179, "M", "ź"), + (0x17A, "V"), + (0x17B, "M", "ż"), + (0x17C, "V"), + (0x17D, "M", "ž"), + (0x17E, "V"), + (0x17F, "M", "s"), + (0x180, "V"), + (0x181, "M", "ɓ"), + (0x182, "M", "ƃ"), + (0x183, "V"), + (0x184, "M", "ƅ"), + (0x185, "V"), + (0x186, "M", "ɔ"), + (0x187, "M", "ƈ"), + (0x188, "V"), + (0x189, "M", "ɖ"), + (0x18A, "M", "ɗ"), + (0x18B, "M", "ƌ"), + (0x18C, "V"), + (0x18E, "M", "ǝ"), + (0x18F, "M", "ə"), + (0x190, "M", "ɛ"), + (0x191, "M", "ƒ"), + (0x192, "V"), + (0x193, "M", "ɠ"), + ] + + +def _seg_4() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x194, "M", "ɣ"), + (0x195, "V"), + (0x196, "M", "ɩ"), + (0x197, "M", "ɨ"), + (0x198, "M", "ƙ"), + (0x199, "V"), + (0x19C, "M", "ɯ"), + (0x19D, "M", "ɲ"), + (0x19E, "V"), + (0x19F, "M", "ɵ"), + (0x1A0, "M", "ơ"), + (0x1A1, "V"), + (0x1A2, "M", "ƣ"), + (0x1A3, "V"), + (0x1A4, "M", "ƥ"), + (0x1A5, "V"), + (0x1A6, "M", "ʀ"), + (0x1A7, "M", "ƨ"), + (0x1A8, "V"), + (0x1A9, "M", "ʃ"), + (0x1AA, "V"), + (0x1AC, "M", "ƭ"), + (0x1AD, "V"), + (0x1AE, "M", "ʈ"), + (0x1AF, "M", "ư"), + (0x1B0, "V"), + (0x1B1, "M", "ʊ"), + (0x1B2, "M", "ʋ"), + (0x1B3, "M", "ƴ"), + (0x1B4, "V"), + (0x1B5, "M", "ƶ"), + (0x1B6, "V"), + (0x1B7, "M", "ʒ"), + (0x1B8, "M", "ƹ"), + (0x1B9, "V"), + (0x1BC, "M", "ƽ"), + (0x1BD, "V"), + (0x1C4, "M", "dž"), + (0x1C7, "M", "lj"), + (0x1CA, "M", "nj"), + (0x1CD, "M", "ǎ"), + (0x1CE, "V"), + (0x1CF, "M", "ǐ"), + (0x1D0, "V"), + (0x1D1, "M", "ǒ"), + (0x1D2, "V"), + (0x1D3, "M", "ǔ"), + (0x1D4, "V"), + (0x1D5, "M", "ǖ"), + (0x1D6, "V"), + (0x1D7, "M", "ǘ"), + (0x1D8, "V"), + (0x1D9, "M", "ǚ"), + (0x1DA, "V"), + (0x1DB, "M", "ǜ"), + (0x1DC, "V"), + (0x1DE, "M", "ǟ"), + (0x1DF, "V"), + (0x1E0, "M", "ǡ"), + (0x1E1, "V"), + (0x1E2, "M", "ǣ"), + (0x1E3, "V"), + (0x1E4, "M", "ǥ"), + (0x1E5, "V"), + (0x1E6, "M", "ǧ"), + (0x1E7, "V"), + (0x1E8, "M", "ǩ"), + (0x1E9, "V"), + (0x1EA, "M", "ǫ"), + (0x1EB, "V"), + (0x1EC, "M", "ǭ"), + (0x1ED, "V"), + (0x1EE, "M", "ǯ"), + (0x1EF, "V"), + (0x1F1, "M", "dz"), + (0x1F4, "M", "ǵ"), + (0x1F5, "V"), + (0x1F6, "M", "ƕ"), + (0x1F7, "M", "ƿ"), + (0x1F8, "M", "ǹ"), + (0x1F9, "V"), + (0x1FA, "M", "ǻ"), + (0x1FB, "V"), + (0x1FC, "M", "ǽ"), + (0x1FD, "V"), + (0x1FE, "M", "ǿ"), + (0x1FF, "V"), + (0x200, "M", "ȁ"), + (0x201, "V"), + (0x202, "M", "ȃ"), + (0x203, "V"), + (0x204, "M", "ȅ"), + (0x205, "V"), + (0x206, "M", "ȇ"), + (0x207, "V"), + (0x208, "M", "ȉ"), + (0x209, "V"), + (0x20A, "M", "ȋ"), + (0x20B, "V"), + (0x20C, "M", "ȍ"), + ] + + +def _seg_5() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x20D, "V"), + (0x20E, "M", "ȏ"), + (0x20F, "V"), + (0x210, "M", "ȑ"), + (0x211, "V"), + (0x212, "M", "ȓ"), + (0x213, "V"), + (0x214, "M", "ȕ"), + (0x215, "V"), + (0x216, "M", "ȗ"), + (0x217, "V"), + (0x218, "M", "ș"), + (0x219, "V"), + (0x21A, "M", "ț"), + (0x21B, "V"), + (0x21C, "M", "ȝ"), + (0x21D, "V"), + (0x21E, "M", "ȟ"), + (0x21F, "V"), + (0x220, "M", "ƞ"), + (0x221, "V"), + (0x222, "M", "ȣ"), + (0x223, "V"), + (0x224, "M", "ȥ"), + (0x225, "V"), + (0x226, "M", "ȧ"), + (0x227, "V"), + (0x228, "M", "ȩ"), + (0x229, "V"), + (0x22A, "M", "ȫ"), + (0x22B, "V"), + (0x22C, "M", "ȭ"), + (0x22D, "V"), + (0x22E, "M", "ȯ"), + (0x22F, "V"), + (0x230, "M", "ȱ"), + (0x231, "V"), + (0x232, "M", "ȳ"), + (0x233, "V"), + (0x23A, "M", "ⱥ"), + (0x23B, "M", "ȼ"), + (0x23C, "V"), + (0x23D, "M", "ƚ"), + (0x23E, "M", "ⱦ"), + (0x23F, "V"), + (0x241, "M", "ɂ"), + (0x242, "V"), + (0x243, "M", "ƀ"), + (0x244, "M", "ʉ"), + (0x245, "M", "ʌ"), + (0x246, "M", "ɇ"), + (0x247, "V"), + (0x248, "M", "ɉ"), + (0x249, "V"), + (0x24A, "M", "ɋ"), + (0x24B, "V"), + (0x24C, "M", "ɍ"), + (0x24D, "V"), + (0x24E, "M", "ɏ"), + (0x24F, "V"), + (0x2B0, "M", "h"), + (0x2B1, "M", "ɦ"), + (0x2B2, "M", "j"), + (0x2B3, "M", "r"), + (0x2B4, "M", "ɹ"), + (0x2B5, "M", "ɻ"), + (0x2B6, "M", "ʁ"), + (0x2B7, "M", "w"), + (0x2B8, "M", "y"), + (0x2B9, "V"), + (0x2D8, "3", " ̆"), + (0x2D9, "3", " ̇"), + (0x2DA, "3", " ̊"), + (0x2DB, "3", " ̨"), + (0x2DC, "3", " ̃"), + (0x2DD, "3", " ̋"), + (0x2DE, "V"), + (0x2E0, "M", "ɣ"), + (0x2E1, "M", "l"), + (0x2E2, "M", "s"), + (0x2E3, "M", "x"), + (0x2E4, "M", "ʕ"), + (0x2E5, "V"), + (0x340, "M", "̀"), + (0x341, "M", "́"), + (0x342, "V"), + (0x343, "M", "̓"), + (0x344, "M", "̈́"), + (0x345, "M", "ι"), + (0x346, "V"), + (0x34F, "I"), + (0x350, "V"), + (0x370, "M", "ͱ"), + (0x371, "V"), + (0x372, "M", "ͳ"), + (0x373, "V"), + (0x374, "M", "ʹ"), + (0x375, "V"), + (0x376, "M", "ͷ"), + (0x377, "V"), + ] + + +def _seg_6() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x378, "X"), + (0x37A, "3", " ι"), + (0x37B, "V"), + (0x37E, "3", ";"), + (0x37F, "M", "ϳ"), + (0x380, "X"), + (0x384, "3", " ́"), + (0x385, "3", " ̈́"), + (0x386, "M", "ά"), + (0x387, "M", "·"), + (0x388, "M", "έ"), + (0x389, "M", "ή"), + (0x38A, "M", "ί"), + (0x38B, "X"), + (0x38C, "M", "ό"), + (0x38D, "X"), + (0x38E, "M", "ύ"), + (0x38F, "M", "ώ"), + (0x390, "V"), + (0x391, "M", "α"), + (0x392, "M", "β"), + (0x393, "M", "γ"), + (0x394, "M", "δ"), + (0x395, "M", "ε"), + (0x396, "M", "ζ"), + (0x397, "M", "η"), + (0x398, "M", "θ"), + (0x399, "M", "ι"), + (0x39A, "M", "κ"), + (0x39B, "M", "λ"), + (0x39C, "M", "μ"), + (0x39D, "M", "ν"), + (0x39E, "M", "ξ"), + (0x39F, "M", "ο"), + (0x3A0, "M", "π"), + (0x3A1, "M", "ρ"), + (0x3A2, "X"), + (0x3A3, "M", "σ"), + (0x3A4, "M", "τ"), + (0x3A5, "M", "υ"), + (0x3A6, "M", "φ"), + (0x3A7, "M", "χ"), + (0x3A8, "M", "ψ"), + (0x3A9, "M", "ω"), + (0x3AA, "M", "ϊ"), + (0x3AB, "M", "ϋ"), + (0x3AC, "V"), + (0x3C2, "D", "σ"), + (0x3C3, "V"), + (0x3CF, "M", "ϗ"), + (0x3D0, "M", "β"), + (0x3D1, "M", "θ"), + (0x3D2, "M", "υ"), + (0x3D3, "M", "ύ"), + (0x3D4, "M", "ϋ"), + (0x3D5, "M", "φ"), + (0x3D6, "M", "π"), + (0x3D7, "V"), + (0x3D8, "M", "ϙ"), + (0x3D9, "V"), + (0x3DA, "M", "ϛ"), + (0x3DB, "V"), + (0x3DC, "M", "ϝ"), + (0x3DD, "V"), + (0x3DE, "M", "ϟ"), + (0x3DF, "V"), + (0x3E0, "M", "ϡ"), + (0x3E1, "V"), + (0x3E2, "M", "ϣ"), + (0x3E3, "V"), + (0x3E4, "M", "ϥ"), + (0x3E5, "V"), + (0x3E6, "M", "ϧ"), + (0x3E7, "V"), + (0x3E8, "M", "ϩ"), + (0x3E9, "V"), + (0x3EA, "M", "ϫ"), + (0x3EB, "V"), + (0x3EC, "M", "ϭ"), + (0x3ED, "V"), + (0x3EE, "M", "ϯ"), + (0x3EF, "V"), + (0x3F0, "M", "κ"), + (0x3F1, "M", "ρ"), + (0x3F2, "M", "σ"), + (0x3F3, "V"), + (0x3F4, "M", "θ"), + (0x3F5, "M", "ε"), + (0x3F6, "V"), + (0x3F7, "M", "ϸ"), + (0x3F8, "V"), + (0x3F9, "M", "σ"), + (0x3FA, "M", "ϻ"), + (0x3FB, "V"), + (0x3FD, "M", "ͻ"), + (0x3FE, "M", "ͼ"), + (0x3FF, "M", "ͽ"), + (0x400, "M", "ѐ"), + (0x401, "M", "ё"), + (0x402, "M", "ђ"), + ] + + +def _seg_7() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x403, "M", "ѓ"), + (0x404, "M", "є"), + (0x405, "M", "ѕ"), + (0x406, "M", "і"), + (0x407, "M", "ї"), + (0x408, "M", "ј"), + (0x409, "M", "љ"), + (0x40A, "M", "њ"), + (0x40B, "M", "ћ"), + (0x40C, "M", "ќ"), + (0x40D, "M", "ѝ"), + (0x40E, "M", "ў"), + (0x40F, "M", "џ"), + (0x410, "M", "а"), + (0x411, "M", "б"), + (0x412, "M", "в"), + (0x413, "M", "г"), + (0x414, "M", "д"), + (0x415, "M", "е"), + (0x416, "M", "ж"), + (0x417, "M", "з"), + (0x418, "M", "и"), + (0x419, "M", "й"), + (0x41A, "M", "к"), + (0x41B, "M", "л"), + (0x41C, "M", "м"), + (0x41D, "M", "н"), + (0x41E, "M", "о"), + (0x41F, "M", "п"), + (0x420, "M", "р"), + (0x421, "M", "с"), + (0x422, "M", "т"), + (0x423, "M", "у"), + (0x424, "M", "ф"), + (0x425, "M", "х"), + (0x426, "M", "ц"), + (0x427, "M", "ч"), + (0x428, "M", "ш"), + (0x429, "M", "щ"), + (0x42A, "M", "ъ"), + (0x42B, "M", "ы"), + (0x42C, "M", "ь"), + (0x42D, "M", "э"), + (0x42E, "M", "ю"), + (0x42F, "M", "я"), + (0x430, "V"), + (0x460, "M", "ѡ"), + (0x461, "V"), + (0x462, "M", "ѣ"), + (0x463, "V"), + (0x464, "M", "ѥ"), + (0x465, "V"), + (0x466, "M", "ѧ"), + (0x467, "V"), + (0x468, "M", "ѩ"), + (0x469, "V"), + (0x46A, "M", "ѫ"), + (0x46B, "V"), + (0x46C, "M", "ѭ"), + (0x46D, "V"), + (0x46E, "M", "ѯ"), + (0x46F, "V"), + (0x470, "M", "ѱ"), + (0x471, "V"), + (0x472, "M", "ѳ"), + (0x473, "V"), + (0x474, "M", "ѵ"), + (0x475, "V"), + (0x476, "M", "ѷ"), + (0x477, "V"), + (0x478, "M", "ѹ"), + (0x479, "V"), + (0x47A, "M", "ѻ"), + (0x47B, "V"), + (0x47C, "M", "ѽ"), + (0x47D, "V"), + (0x47E, "M", "ѿ"), + (0x47F, "V"), + (0x480, "M", "ҁ"), + (0x481, "V"), + (0x48A, "M", "ҋ"), + (0x48B, "V"), + (0x48C, "M", "ҍ"), + (0x48D, "V"), + (0x48E, "M", "ҏ"), + (0x48F, "V"), + (0x490, "M", "ґ"), + (0x491, "V"), + (0x492, "M", "ғ"), + (0x493, "V"), + (0x494, "M", "ҕ"), + (0x495, "V"), + (0x496, "M", "җ"), + (0x497, "V"), + (0x498, "M", "ҙ"), + (0x499, "V"), + (0x49A, "M", "қ"), + (0x49B, "V"), + (0x49C, "M", "ҝ"), + (0x49D, "V"), + ] + + +def _seg_8() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x49E, "M", "ҟ"), + (0x49F, "V"), + (0x4A0, "M", "ҡ"), + (0x4A1, "V"), + (0x4A2, "M", "ң"), + (0x4A3, "V"), + (0x4A4, "M", "ҥ"), + (0x4A5, "V"), + (0x4A6, "M", "ҧ"), + (0x4A7, "V"), + (0x4A8, "M", "ҩ"), + (0x4A9, "V"), + (0x4AA, "M", "ҫ"), + (0x4AB, "V"), + (0x4AC, "M", "ҭ"), + (0x4AD, "V"), + (0x4AE, "M", "ү"), + (0x4AF, "V"), + (0x4B0, "M", "ұ"), + (0x4B1, "V"), + (0x4B2, "M", "ҳ"), + (0x4B3, "V"), + (0x4B4, "M", "ҵ"), + (0x4B5, "V"), + (0x4B6, "M", "ҷ"), + (0x4B7, "V"), + (0x4B8, "M", "ҹ"), + (0x4B9, "V"), + (0x4BA, "M", "һ"), + (0x4BB, "V"), + (0x4BC, "M", "ҽ"), + (0x4BD, "V"), + (0x4BE, "M", "ҿ"), + (0x4BF, "V"), + (0x4C0, "X"), + (0x4C1, "M", "ӂ"), + (0x4C2, "V"), + (0x4C3, "M", "ӄ"), + (0x4C4, "V"), + (0x4C5, "M", "ӆ"), + (0x4C6, "V"), + (0x4C7, "M", "ӈ"), + (0x4C8, "V"), + (0x4C9, "M", "ӊ"), + (0x4CA, "V"), + (0x4CB, "M", "ӌ"), + (0x4CC, "V"), + (0x4CD, "M", "ӎ"), + (0x4CE, "V"), + (0x4D0, "M", "ӑ"), + (0x4D1, "V"), + (0x4D2, "M", "ӓ"), + (0x4D3, "V"), + (0x4D4, "M", "ӕ"), + (0x4D5, "V"), + (0x4D6, "M", "ӗ"), + (0x4D7, "V"), + (0x4D8, "M", "ә"), + (0x4D9, "V"), + (0x4DA, "M", "ӛ"), + (0x4DB, "V"), + (0x4DC, "M", "ӝ"), + (0x4DD, "V"), + (0x4DE, "M", "ӟ"), + (0x4DF, "V"), + (0x4E0, "M", "ӡ"), + (0x4E1, "V"), + (0x4E2, "M", "ӣ"), + (0x4E3, "V"), + (0x4E4, "M", "ӥ"), + (0x4E5, "V"), + (0x4E6, "M", "ӧ"), + (0x4E7, "V"), + (0x4E8, "M", "ө"), + (0x4E9, "V"), + (0x4EA, "M", "ӫ"), + (0x4EB, "V"), + (0x4EC, "M", "ӭ"), + (0x4ED, "V"), + (0x4EE, "M", "ӯ"), + (0x4EF, "V"), + (0x4F0, "M", "ӱ"), + (0x4F1, "V"), + (0x4F2, "M", "ӳ"), + (0x4F3, "V"), + (0x4F4, "M", "ӵ"), + (0x4F5, "V"), + (0x4F6, "M", "ӷ"), + (0x4F7, "V"), + (0x4F8, "M", "ӹ"), + (0x4F9, "V"), + (0x4FA, "M", "ӻ"), + (0x4FB, "V"), + (0x4FC, "M", "ӽ"), + (0x4FD, "V"), + (0x4FE, "M", "ӿ"), + (0x4FF, "V"), + (0x500, "M", "ԁ"), + (0x501, "V"), + (0x502, "M", "ԃ"), + ] + + +def _seg_9() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x503, "V"), + (0x504, "M", "ԅ"), + (0x505, "V"), + (0x506, "M", "ԇ"), + (0x507, "V"), + (0x508, "M", "ԉ"), + (0x509, "V"), + (0x50A, "M", "ԋ"), + (0x50B, "V"), + (0x50C, "M", "ԍ"), + (0x50D, "V"), + (0x50E, "M", "ԏ"), + (0x50F, "V"), + (0x510, "M", "ԑ"), + (0x511, "V"), + (0x512, "M", "ԓ"), + (0x513, "V"), + (0x514, "M", "ԕ"), + (0x515, "V"), + (0x516, "M", "ԗ"), + (0x517, "V"), + (0x518, "M", "ԙ"), + (0x519, "V"), + (0x51A, "M", "ԛ"), + (0x51B, "V"), + (0x51C, "M", "ԝ"), + (0x51D, "V"), + (0x51E, "M", "ԟ"), + (0x51F, "V"), + (0x520, "M", "ԡ"), + (0x521, "V"), + (0x522, "M", "ԣ"), + (0x523, "V"), + (0x524, "M", "ԥ"), + (0x525, "V"), + (0x526, "M", "ԧ"), + (0x527, "V"), + (0x528, "M", "ԩ"), + (0x529, "V"), + (0x52A, "M", "ԫ"), + (0x52B, "V"), + (0x52C, "M", "ԭ"), + (0x52D, "V"), + (0x52E, "M", "ԯ"), + (0x52F, "V"), + (0x530, "X"), + (0x531, "M", "ա"), + (0x532, "M", "բ"), + (0x533, "M", "գ"), + (0x534, "M", "դ"), + (0x535, "M", "ե"), + (0x536, "M", "զ"), + (0x537, "M", "է"), + (0x538, "M", "ը"), + (0x539, "M", "թ"), + (0x53A, "M", "ժ"), + (0x53B, "M", "ի"), + (0x53C, "M", "լ"), + (0x53D, "M", "խ"), + (0x53E, "M", "ծ"), + (0x53F, "M", "կ"), + (0x540, "M", "հ"), + (0x541, "M", "ձ"), + (0x542, "M", "ղ"), + (0x543, "M", "ճ"), + (0x544, "M", "մ"), + (0x545, "M", "յ"), + (0x546, "M", "ն"), + (0x547, "M", "շ"), + (0x548, "M", "ո"), + (0x549, "M", "չ"), + (0x54A, "M", "պ"), + (0x54B, "M", "ջ"), + (0x54C, "M", "ռ"), + (0x54D, "M", "ս"), + (0x54E, "M", "վ"), + (0x54F, "M", "տ"), + (0x550, "M", "ր"), + (0x551, "M", "ց"), + (0x552, "M", "ւ"), + (0x553, "M", "փ"), + (0x554, "M", "ք"), + (0x555, "M", "օ"), + (0x556, "M", "ֆ"), + (0x557, "X"), + (0x559, "V"), + (0x587, "M", "եւ"), + (0x588, "V"), + (0x58B, "X"), + (0x58D, "V"), + (0x590, "X"), + (0x591, "V"), + (0x5C8, "X"), + (0x5D0, "V"), + (0x5EB, "X"), + (0x5EF, "V"), + (0x5F5, "X"), + (0x606, "V"), + (0x61C, "X"), + (0x61D, "V"), + ] + + +def _seg_10() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x675, "M", "اٴ"), + (0x676, "M", "وٴ"), + (0x677, "M", "ۇٴ"), + (0x678, "M", "يٴ"), + (0x679, "V"), + (0x6DD, "X"), + (0x6DE, "V"), + (0x70E, "X"), + (0x710, "V"), + (0x74B, "X"), + (0x74D, "V"), + (0x7B2, "X"), + (0x7C0, "V"), + (0x7FB, "X"), + (0x7FD, "V"), + (0x82E, "X"), + (0x830, "V"), + (0x83F, "X"), + (0x840, "V"), + (0x85C, "X"), + (0x85E, "V"), + (0x85F, "X"), + (0x860, "V"), + (0x86B, "X"), + (0x870, "V"), + (0x88F, "X"), + (0x898, "V"), + (0x8E2, "X"), + (0x8E3, "V"), + (0x958, "M", "क़"), + (0x959, "M", "ख़"), + (0x95A, "M", "ग़"), + (0x95B, "M", "ज़"), + (0x95C, "M", "ड़"), + (0x95D, "M", "ढ़"), + (0x95E, "M", "फ़"), + (0x95F, "M", "य़"), + (0x960, "V"), + (0x984, "X"), + (0x985, "V"), + (0x98D, "X"), + (0x98F, "V"), + (0x991, "X"), + (0x993, "V"), + (0x9A9, "X"), + (0x9AA, "V"), + (0x9B1, "X"), + (0x9B2, "V"), + (0x9B3, "X"), + (0x9B6, "V"), + (0x9BA, "X"), + (0x9BC, "V"), + (0x9C5, "X"), + (0x9C7, "V"), + (0x9C9, "X"), + (0x9CB, "V"), + (0x9CF, "X"), + (0x9D7, "V"), + (0x9D8, "X"), + (0x9DC, "M", "ড়"), + (0x9DD, "M", "ঢ়"), + (0x9DE, "X"), + (0x9DF, "M", "য়"), + (0x9E0, "V"), + (0x9E4, "X"), + (0x9E6, "V"), + (0x9FF, "X"), + (0xA01, "V"), + (0xA04, "X"), + (0xA05, "V"), + (0xA0B, "X"), + (0xA0F, "V"), + (0xA11, "X"), + (0xA13, "V"), + (0xA29, "X"), + (0xA2A, "V"), + (0xA31, "X"), + (0xA32, "V"), + (0xA33, "M", "ਲ਼"), + (0xA34, "X"), + (0xA35, "V"), + (0xA36, "M", "ਸ਼"), + (0xA37, "X"), + (0xA38, "V"), + (0xA3A, "X"), + (0xA3C, "V"), + (0xA3D, "X"), + (0xA3E, "V"), + (0xA43, "X"), + (0xA47, "V"), + (0xA49, "X"), + (0xA4B, "V"), + (0xA4E, "X"), + (0xA51, "V"), + (0xA52, "X"), + (0xA59, "M", "ਖ਼"), + (0xA5A, "M", "ਗ਼"), + (0xA5B, "M", "ਜ਼"), + (0xA5C, "V"), + (0xA5D, "X"), + ] + + +def _seg_11() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0xA5E, "M", "ਫ਼"), + (0xA5F, "X"), + (0xA66, "V"), + (0xA77, "X"), + (0xA81, "V"), + (0xA84, "X"), + (0xA85, "V"), + (0xA8E, "X"), + (0xA8F, "V"), + (0xA92, "X"), + (0xA93, "V"), + (0xAA9, "X"), + (0xAAA, "V"), + (0xAB1, "X"), + (0xAB2, "V"), + (0xAB4, "X"), + (0xAB5, "V"), + (0xABA, "X"), + (0xABC, "V"), + (0xAC6, "X"), + (0xAC7, "V"), + (0xACA, "X"), + (0xACB, "V"), + (0xACE, "X"), + (0xAD0, "V"), + (0xAD1, "X"), + (0xAE0, "V"), + (0xAE4, "X"), + (0xAE6, "V"), + (0xAF2, "X"), + (0xAF9, "V"), + (0xB00, "X"), + (0xB01, "V"), + (0xB04, "X"), + (0xB05, "V"), + (0xB0D, "X"), + (0xB0F, "V"), + (0xB11, "X"), + (0xB13, "V"), + (0xB29, "X"), + (0xB2A, "V"), + (0xB31, "X"), + (0xB32, "V"), + (0xB34, "X"), + (0xB35, "V"), + (0xB3A, "X"), + (0xB3C, "V"), + (0xB45, "X"), + (0xB47, "V"), + (0xB49, "X"), + (0xB4B, "V"), + (0xB4E, "X"), + (0xB55, "V"), + (0xB58, "X"), + (0xB5C, "M", "ଡ଼"), + (0xB5D, "M", "ଢ଼"), + (0xB5E, "X"), + (0xB5F, "V"), + (0xB64, "X"), + (0xB66, "V"), + (0xB78, "X"), + (0xB82, "V"), + (0xB84, "X"), + (0xB85, "V"), + (0xB8B, "X"), + (0xB8E, "V"), + (0xB91, "X"), + (0xB92, "V"), + (0xB96, "X"), + (0xB99, "V"), + (0xB9B, "X"), + (0xB9C, "V"), + (0xB9D, "X"), + (0xB9E, "V"), + (0xBA0, "X"), + (0xBA3, "V"), + (0xBA5, "X"), + (0xBA8, "V"), + (0xBAB, "X"), + (0xBAE, "V"), + (0xBBA, "X"), + (0xBBE, "V"), + (0xBC3, "X"), + (0xBC6, "V"), + (0xBC9, "X"), + (0xBCA, "V"), + (0xBCE, "X"), + (0xBD0, "V"), + (0xBD1, "X"), + (0xBD7, "V"), + (0xBD8, "X"), + (0xBE6, "V"), + (0xBFB, "X"), + (0xC00, "V"), + (0xC0D, "X"), + (0xC0E, "V"), + (0xC11, "X"), + (0xC12, "V"), + (0xC29, "X"), + (0xC2A, "V"), + ] + + +def _seg_12() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0xC3A, "X"), + (0xC3C, "V"), + (0xC45, "X"), + (0xC46, "V"), + (0xC49, "X"), + (0xC4A, "V"), + (0xC4E, "X"), + (0xC55, "V"), + (0xC57, "X"), + (0xC58, "V"), + (0xC5B, "X"), + (0xC5D, "V"), + (0xC5E, "X"), + (0xC60, "V"), + (0xC64, "X"), + (0xC66, "V"), + (0xC70, "X"), + (0xC77, "V"), + (0xC8D, "X"), + (0xC8E, "V"), + (0xC91, "X"), + (0xC92, "V"), + (0xCA9, "X"), + (0xCAA, "V"), + (0xCB4, "X"), + (0xCB5, "V"), + (0xCBA, "X"), + (0xCBC, "V"), + (0xCC5, "X"), + (0xCC6, "V"), + (0xCC9, "X"), + (0xCCA, "V"), + (0xCCE, "X"), + (0xCD5, "V"), + (0xCD7, "X"), + (0xCDD, "V"), + (0xCDF, "X"), + (0xCE0, "V"), + (0xCE4, "X"), + (0xCE6, "V"), + (0xCF0, "X"), + (0xCF1, "V"), + (0xCF4, "X"), + (0xD00, "V"), + (0xD0D, "X"), + (0xD0E, "V"), + (0xD11, "X"), + (0xD12, "V"), + (0xD45, "X"), + (0xD46, "V"), + (0xD49, "X"), + (0xD4A, "V"), + (0xD50, "X"), + (0xD54, "V"), + (0xD64, "X"), + (0xD66, "V"), + (0xD80, "X"), + (0xD81, "V"), + (0xD84, "X"), + (0xD85, "V"), + (0xD97, "X"), + (0xD9A, "V"), + (0xDB2, "X"), + (0xDB3, "V"), + (0xDBC, "X"), + (0xDBD, "V"), + (0xDBE, "X"), + (0xDC0, "V"), + (0xDC7, "X"), + (0xDCA, "V"), + (0xDCB, "X"), + (0xDCF, "V"), + (0xDD5, "X"), + (0xDD6, "V"), + (0xDD7, "X"), + (0xDD8, "V"), + (0xDE0, "X"), + (0xDE6, "V"), + (0xDF0, "X"), + (0xDF2, "V"), + (0xDF5, "X"), + (0xE01, "V"), + (0xE33, "M", "ํา"), + (0xE34, "V"), + (0xE3B, "X"), + (0xE3F, "V"), + (0xE5C, "X"), + (0xE81, "V"), + (0xE83, "X"), + (0xE84, "V"), + (0xE85, "X"), + (0xE86, "V"), + (0xE8B, "X"), + (0xE8C, "V"), + (0xEA4, "X"), + (0xEA5, "V"), + (0xEA6, "X"), + (0xEA7, "V"), + (0xEB3, "M", "ໍາ"), + (0xEB4, "V"), + ] + + +def _seg_13() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0xEBE, "X"), + (0xEC0, "V"), + (0xEC5, "X"), + (0xEC6, "V"), + (0xEC7, "X"), + (0xEC8, "V"), + (0xECF, "X"), + (0xED0, "V"), + (0xEDA, "X"), + (0xEDC, "M", "ຫນ"), + (0xEDD, "M", "ຫມ"), + (0xEDE, "V"), + (0xEE0, "X"), + (0xF00, "V"), + (0xF0C, "M", "་"), + (0xF0D, "V"), + (0xF43, "M", "གྷ"), + (0xF44, "V"), + (0xF48, "X"), + (0xF49, "V"), + (0xF4D, "M", "ཌྷ"), + (0xF4E, "V"), + (0xF52, "M", "དྷ"), + (0xF53, "V"), + (0xF57, "M", "བྷ"), + (0xF58, "V"), + (0xF5C, "M", "ཛྷ"), + (0xF5D, "V"), + (0xF69, "M", "ཀྵ"), + (0xF6A, "V"), + (0xF6D, "X"), + (0xF71, "V"), + (0xF73, "M", "ཱི"), + (0xF74, "V"), + (0xF75, "M", "ཱུ"), + (0xF76, "M", "ྲྀ"), + (0xF77, "M", "ྲཱྀ"), + (0xF78, "M", "ླྀ"), + (0xF79, "M", "ླཱྀ"), + (0xF7A, "V"), + (0xF81, "M", "ཱྀ"), + (0xF82, "V"), + (0xF93, "M", "ྒྷ"), + (0xF94, "V"), + (0xF98, "X"), + (0xF99, "V"), + (0xF9D, "M", "ྜྷ"), + (0xF9E, "V"), + (0xFA2, "M", "ྡྷ"), + (0xFA3, "V"), + (0xFA7, "M", "ྦྷ"), + (0xFA8, "V"), + (0xFAC, "M", "ྫྷ"), + (0xFAD, "V"), + (0xFB9, "M", "ྐྵ"), + (0xFBA, "V"), + (0xFBD, "X"), + (0xFBE, "V"), + (0xFCD, "X"), + (0xFCE, "V"), + (0xFDB, "X"), + (0x1000, "V"), + (0x10A0, "X"), + (0x10C7, "M", "ⴧ"), + (0x10C8, "X"), + (0x10CD, "M", "ⴭ"), + (0x10CE, "X"), + (0x10D0, "V"), + (0x10FC, "M", "ნ"), + (0x10FD, "V"), + (0x115F, "X"), + (0x1161, "V"), + (0x1249, "X"), + (0x124A, "V"), + (0x124E, "X"), + (0x1250, "V"), + (0x1257, "X"), + (0x1258, "V"), + (0x1259, "X"), + (0x125A, "V"), + (0x125E, "X"), + (0x1260, "V"), + (0x1289, "X"), + (0x128A, "V"), + (0x128E, "X"), + (0x1290, "V"), + (0x12B1, "X"), + (0x12B2, "V"), + (0x12B6, "X"), + (0x12B8, "V"), + (0x12BF, "X"), + (0x12C0, "V"), + (0x12C1, "X"), + (0x12C2, "V"), + (0x12C6, "X"), + (0x12C8, "V"), + (0x12D7, "X"), + (0x12D8, "V"), + (0x1311, "X"), + (0x1312, "V"), + ] + + +def _seg_14() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x1316, "X"), + (0x1318, "V"), + (0x135B, "X"), + (0x135D, "V"), + (0x137D, "X"), + (0x1380, "V"), + (0x139A, "X"), + (0x13A0, "V"), + (0x13F6, "X"), + (0x13F8, "M", "Ᏸ"), + (0x13F9, "M", "Ᏹ"), + (0x13FA, "M", "Ᏺ"), + (0x13FB, "M", "Ᏻ"), + (0x13FC, "M", "Ᏼ"), + (0x13FD, "M", "Ᏽ"), + (0x13FE, "X"), + (0x1400, "V"), + (0x1680, "X"), + (0x1681, "V"), + (0x169D, "X"), + (0x16A0, "V"), + (0x16F9, "X"), + (0x1700, "V"), + (0x1716, "X"), + (0x171F, "V"), + (0x1737, "X"), + (0x1740, "V"), + (0x1754, "X"), + (0x1760, "V"), + (0x176D, "X"), + (0x176E, "V"), + (0x1771, "X"), + (0x1772, "V"), + (0x1774, "X"), + (0x1780, "V"), + (0x17B4, "X"), + (0x17B6, "V"), + (0x17DE, "X"), + (0x17E0, "V"), + (0x17EA, "X"), + (0x17F0, "V"), + (0x17FA, "X"), + (0x1800, "V"), + (0x1806, "X"), + (0x1807, "V"), + (0x180B, "I"), + (0x180E, "X"), + (0x180F, "I"), + (0x1810, "V"), + (0x181A, "X"), + (0x1820, "V"), + (0x1879, "X"), + (0x1880, "V"), + (0x18AB, "X"), + (0x18B0, "V"), + (0x18F6, "X"), + (0x1900, "V"), + (0x191F, "X"), + (0x1920, "V"), + (0x192C, "X"), + (0x1930, "V"), + (0x193C, "X"), + (0x1940, "V"), + (0x1941, "X"), + (0x1944, "V"), + (0x196E, "X"), + (0x1970, "V"), + (0x1975, "X"), + (0x1980, "V"), + (0x19AC, "X"), + (0x19B0, "V"), + (0x19CA, "X"), + (0x19D0, "V"), + (0x19DB, "X"), + (0x19DE, "V"), + (0x1A1C, "X"), + (0x1A1E, "V"), + (0x1A5F, "X"), + (0x1A60, "V"), + (0x1A7D, "X"), + (0x1A7F, "V"), + (0x1A8A, "X"), + (0x1A90, "V"), + (0x1A9A, "X"), + (0x1AA0, "V"), + (0x1AAE, "X"), + (0x1AB0, "V"), + (0x1ACF, "X"), + (0x1B00, "V"), + (0x1B4D, "X"), + (0x1B50, "V"), + (0x1B7F, "X"), + (0x1B80, "V"), + (0x1BF4, "X"), + (0x1BFC, "V"), + (0x1C38, "X"), + (0x1C3B, "V"), + (0x1C4A, "X"), + (0x1C4D, "V"), + (0x1C80, "M", "в"), + ] + + +def _seg_15() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x1C81, "M", "д"), + (0x1C82, "M", "о"), + (0x1C83, "M", "с"), + (0x1C84, "M", "т"), + (0x1C86, "M", "ъ"), + (0x1C87, "M", "ѣ"), + (0x1C88, "M", "ꙋ"), + (0x1C89, "X"), + (0x1C90, "M", "ა"), + (0x1C91, "M", "ბ"), + (0x1C92, "M", "გ"), + (0x1C93, "M", "დ"), + (0x1C94, "M", "ე"), + (0x1C95, "M", "ვ"), + (0x1C96, "M", "ზ"), + (0x1C97, "M", "თ"), + (0x1C98, "M", "ი"), + (0x1C99, "M", "კ"), + (0x1C9A, "M", "ლ"), + (0x1C9B, "M", "მ"), + (0x1C9C, "M", "ნ"), + (0x1C9D, "M", "ო"), + (0x1C9E, "M", "პ"), + (0x1C9F, "M", "ჟ"), + (0x1CA0, "M", "რ"), + (0x1CA1, "M", "ს"), + (0x1CA2, "M", "ტ"), + (0x1CA3, "M", "უ"), + (0x1CA4, "M", "ფ"), + (0x1CA5, "M", "ქ"), + (0x1CA6, "M", "ღ"), + (0x1CA7, "M", "ყ"), + (0x1CA8, "M", "შ"), + (0x1CA9, "M", "ჩ"), + (0x1CAA, "M", "ც"), + (0x1CAB, "M", "ძ"), + (0x1CAC, "M", "წ"), + (0x1CAD, "M", "ჭ"), + (0x1CAE, "M", "ხ"), + (0x1CAF, "M", "ჯ"), + (0x1CB0, "M", "ჰ"), + (0x1CB1, "M", "ჱ"), + (0x1CB2, "M", "ჲ"), + (0x1CB3, "M", "ჳ"), + (0x1CB4, "M", "ჴ"), + (0x1CB5, "M", "ჵ"), + (0x1CB6, "M", "ჶ"), + (0x1CB7, "M", "ჷ"), + (0x1CB8, "M", "ჸ"), + (0x1CB9, "M", "ჹ"), + (0x1CBA, "M", "ჺ"), + (0x1CBB, "X"), + (0x1CBD, "M", "ჽ"), + (0x1CBE, "M", "ჾ"), + (0x1CBF, "M", "ჿ"), + (0x1CC0, "V"), + (0x1CC8, "X"), + (0x1CD0, "V"), + (0x1CFB, "X"), + (0x1D00, "V"), + (0x1D2C, "M", "a"), + (0x1D2D, "M", "æ"), + (0x1D2E, "M", "b"), + (0x1D2F, "V"), + (0x1D30, "M", "d"), + (0x1D31, "M", "e"), + (0x1D32, "M", "ǝ"), + (0x1D33, "M", "g"), + (0x1D34, "M", "h"), + (0x1D35, "M", "i"), + (0x1D36, "M", "j"), + (0x1D37, "M", "k"), + (0x1D38, "M", "l"), + (0x1D39, "M", "m"), + (0x1D3A, "M", "n"), + (0x1D3B, "V"), + (0x1D3C, "M", "o"), + (0x1D3D, "M", "ȣ"), + (0x1D3E, "M", "p"), + (0x1D3F, "M", "r"), + (0x1D40, "M", "t"), + (0x1D41, "M", "u"), + (0x1D42, "M", "w"), + (0x1D43, "M", "a"), + (0x1D44, "M", "ɐ"), + (0x1D45, "M", "ɑ"), + (0x1D46, "M", "ᴂ"), + (0x1D47, "M", "b"), + (0x1D48, "M", "d"), + (0x1D49, "M", "e"), + (0x1D4A, "M", "ə"), + (0x1D4B, "M", "ɛ"), + (0x1D4C, "M", "ɜ"), + (0x1D4D, "M", "g"), + (0x1D4E, "V"), + (0x1D4F, "M", "k"), + (0x1D50, "M", "m"), + (0x1D51, "M", "ŋ"), + (0x1D52, "M", "o"), + (0x1D53, "M", "ɔ"), + ] + + +def _seg_16() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x1D54, "M", "ᴖ"), + (0x1D55, "M", "ᴗ"), + (0x1D56, "M", "p"), + (0x1D57, "M", "t"), + (0x1D58, "M", "u"), + (0x1D59, "M", "ᴝ"), + (0x1D5A, "M", "ɯ"), + (0x1D5B, "M", "v"), + (0x1D5C, "M", "ᴥ"), + (0x1D5D, "M", "β"), + (0x1D5E, "M", "γ"), + (0x1D5F, "M", "δ"), + (0x1D60, "M", "φ"), + (0x1D61, "M", "χ"), + (0x1D62, "M", "i"), + (0x1D63, "M", "r"), + (0x1D64, "M", "u"), + (0x1D65, "M", "v"), + (0x1D66, "M", "β"), + (0x1D67, "M", "γ"), + (0x1D68, "M", "ρ"), + (0x1D69, "M", "φ"), + (0x1D6A, "M", "χ"), + (0x1D6B, "V"), + (0x1D78, "M", "н"), + (0x1D79, "V"), + (0x1D9B, "M", "ɒ"), + (0x1D9C, "M", "c"), + (0x1D9D, "M", "ɕ"), + (0x1D9E, "M", "ð"), + (0x1D9F, "M", "ɜ"), + (0x1DA0, "M", "f"), + (0x1DA1, "M", "ɟ"), + (0x1DA2, "M", "ɡ"), + (0x1DA3, "M", "ɥ"), + (0x1DA4, "M", "ɨ"), + (0x1DA5, "M", "ɩ"), + (0x1DA6, "M", "ɪ"), + (0x1DA7, "M", "ᵻ"), + (0x1DA8, "M", "ʝ"), + (0x1DA9, "M", "ɭ"), + (0x1DAA, "M", "ᶅ"), + (0x1DAB, "M", "ʟ"), + (0x1DAC, "M", "ɱ"), + (0x1DAD, "M", "ɰ"), + (0x1DAE, "M", "ɲ"), + (0x1DAF, "M", "ɳ"), + (0x1DB0, "M", "ɴ"), + (0x1DB1, "M", "ɵ"), + (0x1DB2, "M", "ɸ"), + (0x1DB3, "M", "ʂ"), + (0x1DB4, "M", "ʃ"), + (0x1DB5, "M", "ƫ"), + (0x1DB6, "M", "ʉ"), + (0x1DB7, "M", "ʊ"), + (0x1DB8, "M", "ᴜ"), + (0x1DB9, "M", "ʋ"), + (0x1DBA, "M", "ʌ"), + (0x1DBB, "M", "z"), + (0x1DBC, "M", "ʐ"), + (0x1DBD, "M", "ʑ"), + (0x1DBE, "M", "ʒ"), + (0x1DBF, "M", "θ"), + (0x1DC0, "V"), + (0x1E00, "M", "ḁ"), + (0x1E01, "V"), + (0x1E02, "M", "ḃ"), + (0x1E03, "V"), + (0x1E04, "M", "ḅ"), + (0x1E05, "V"), + (0x1E06, "M", "ḇ"), + (0x1E07, "V"), + (0x1E08, "M", "ḉ"), + (0x1E09, "V"), + (0x1E0A, "M", "ḋ"), + (0x1E0B, "V"), + (0x1E0C, "M", "ḍ"), + (0x1E0D, "V"), + (0x1E0E, "M", "ḏ"), + (0x1E0F, "V"), + (0x1E10, "M", "ḑ"), + (0x1E11, "V"), + (0x1E12, "M", "ḓ"), + (0x1E13, "V"), + (0x1E14, "M", "ḕ"), + (0x1E15, "V"), + (0x1E16, "M", "ḗ"), + (0x1E17, "V"), + (0x1E18, "M", "ḙ"), + (0x1E19, "V"), + (0x1E1A, "M", "ḛ"), + (0x1E1B, "V"), + (0x1E1C, "M", "ḝ"), + (0x1E1D, "V"), + (0x1E1E, "M", "ḟ"), + (0x1E1F, "V"), + (0x1E20, "M", "ḡ"), + (0x1E21, "V"), + (0x1E22, "M", "ḣ"), + (0x1E23, "V"), + ] + + +def _seg_17() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x1E24, "M", "ḥ"), + (0x1E25, "V"), + (0x1E26, "M", "ḧ"), + (0x1E27, "V"), + (0x1E28, "M", "ḩ"), + (0x1E29, "V"), + (0x1E2A, "M", "ḫ"), + (0x1E2B, "V"), + (0x1E2C, "M", "ḭ"), + (0x1E2D, "V"), + (0x1E2E, "M", "ḯ"), + (0x1E2F, "V"), + (0x1E30, "M", "ḱ"), + (0x1E31, "V"), + (0x1E32, "M", "ḳ"), + (0x1E33, "V"), + (0x1E34, "M", "ḵ"), + (0x1E35, "V"), + (0x1E36, "M", "ḷ"), + (0x1E37, "V"), + (0x1E38, "M", "ḹ"), + (0x1E39, "V"), + (0x1E3A, "M", "ḻ"), + (0x1E3B, "V"), + (0x1E3C, "M", "ḽ"), + (0x1E3D, "V"), + (0x1E3E, "M", "ḿ"), + (0x1E3F, "V"), + (0x1E40, "M", "ṁ"), + (0x1E41, "V"), + (0x1E42, "M", "ṃ"), + (0x1E43, "V"), + (0x1E44, "M", "ṅ"), + (0x1E45, "V"), + (0x1E46, "M", "ṇ"), + (0x1E47, "V"), + (0x1E48, "M", "ṉ"), + (0x1E49, "V"), + (0x1E4A, "M", "ṋ"), + (0x1E4B, "V"), + (0x1E4C, "M", "ṍ"), + (0x1E4D, "V"), + (0x1E4E, "M", "ṏ"), + (0x1E4F, "V"), + (0x1E50, "M", "ṑ"), + (0x1E51, "V"), + (0x1E52, "M", "ṓ"), + (0x1E53, "V"), + (0x1E54, "M", "ṕ"), + (0x1E55, "V"), + (0x1E56, "M", "ṗ"), + (0x1E57, "V"), + (0x1E58, "M", "ṙ"), + (0x1E59, "V"), + (0x1E5A, "M", "ṛ"), + (0x1E5B, "V"), + (0x1E5C, "M", "ṝ"), + (0x1E5D, "V"), + (0x1E5E, "M", "ṟ"), + (0x1E5F, "V"), + (0x1E60, "M", "ṡ"), + (0x1E61, "V"), + (0x1E62, "M", "ṣ"), + (0x1E63, "V"), + (0x1E64, "M", "ṥ"), + (0x1E65, "V"), + (0x1E66, "M", "ṧ"), + (0x1E67, "V"), + (0x1E68, "M", "ṩ"), + (0x1E69, "V"), + (0x1E6A, "M", "ṫ"), + (0x1E6B, "V"), + (0x1E6C, "M", "ṭ"), + (0x1E6D, "V"), + (0x1E6E, "M", "ṯ"), + (0x1E6F, "V"), + (0x1E70, "M", "ṱ"), + (0x1E71, "V"), + (0x1E72, "M", "ṳ"), + (0x1E73, "V"), + (0x1E74, "M", "ṵ"), + (0x1E75, "V"), + (0x1E76, "M", "ṷ"), + (0x1E77, "V"), + (0x1E78, "M", "ṹ"), + (0x1E79, "V"), + (0x1E7A, "M", "ṻ"), + (0x1E7B, "V"), + (0x1E7C, "M", "ṽ"), + (0x1E7D, "V"), + (0x1E7E, "M", "ṿ"), + (0x1E7F, "V"), + (0x1E80, "M", "ẁ"), + (0x1E81, "V"), + (0x1E82, "M", "ẃ"), + (0x1E83, "V"), + (0x1E84, "M", "ẅ"), + (0x1E85, "V"), + (0x1E86, "M", "ẇ"), + (0x1E87, "V"), + ] + + +def _seg_18() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x1E88, "M", "ẉ"), + (0x1E89, "V"), + (0x1E8A, "M", "ẋ"), + (0x1E8B, "V"), + (0x1E8C, "M", "ẍ"), + (0x1E8D, "V"), + (0x1E8E, "M", "ẏ"), + (0x1E8F, "V"), + (0x1E90, "M", "ẑ"), + (0x1E91, "V"), + (0x1E92, "M", "ẓ"), + (0x1E93, "V"), + (0x1E94, "M", "ẕ"), + (0x1E95, "V"), + (0x1E9A, "M", "aʾ"), + (0x1E9B, "M", "ṡ"), + (0x1E9C, "V"), + (0x1E9E, "M", "ß"), + (0x1E9F, "V"), + (0x1EA0, "M", "ạ"), + (0x1EA1, "V"), + (0x1EA2, "M", "ả"), + (0x1EA3, "V"), + (0x1EA4, "M", "ấ"), + (0x1EA5, "V"), + (0x1EA6, "M", "ầ"), + (0x1EA7, "V"), + (0x1EA8, "M", "ẩ"), + (0x1EA9, "V"), + (0x1EAA, "M", "ẫ"), + (0x1EAB, "V"), + (0x1EAC, "M", "ậ"), + (0x1EAD, "V"), + (0x1EAE, "M", "ắ"), + (0x1EAF, "V"), + (0x1EB0, "M", "ằ"), + (0x1EB1, "V"), + (0x1EB2, "M", "ẳ"), + (0x1EB3, "V"), + (0x1EB4, "M", "ẵ"), + (0x1EB5, "V"), + (0x1EB6, "M", "ặ"), + (0x1EB7, "V"), + (0x1EB8, "M", "ẹ"), + (0x1EB9, "V"), + (0x1EBA, "M", "ẻ"), + (0x1EBB, "V"), + (0x1EBC, "M", "ẽ"), + (0x1EBD, "V"), + (0x1EBE, "M", "ế"), + (0x1EBF, "V"), + (0x1EC0, "M", "ề"), + (0x1EC1, "V"), + (0x1EC2, "M", "ể"), + (0x1EC3, "V"), + (0x1EC4, "M", "ễ"), + (0x1EC5, "V"), + (0x1EC6, "M", "ệ"), + (0x1EC7, "V"), + (0x1EC8, "M", "ỉ"), + (0x1EC9, "V"), + (0x1ECA, "M", "ị"), + (0x1ECB, "V"), + (0x1ECC, "M", "ọ"), + (0x1ECD, "V"), + (0x1ECE, "M", "ỏ"), + (0x1ECF, "V"), + (0x1ED0, "M", "ố"), + (0x1ED1, "V"), + (0x1ED2, "M", "ồ"), + (0x1ED3, "V"), + (0x1ED4, "M", "ổ"), + (0x1ED5, "V"), + (0x1ED6, "M", "ỗ"), + (0x1ED7, "V"), + (0x1ED8, "M", "ộ"), + (0x1ED9, "V"), + (0x1EDA, "M", "ớ"), + (0x1EDB, "V"), + (0x1EDC, "M", "ờ"), + (0x1EDD, "V"), + (0x1EDE, "M", "ở"), + (0x1EDF, "V"), + (0x1EE0, "M", "ỡ"), + (0x1EE1, "V"), + (0x1EE2, "M", "ợ"), + (0x1EE3, "V"), + (0x1EE4, "M", "ụ"), + (0x1EE5, "V"), + (0x1EE6, "M", "ủ"), + (0x1EE7, "V"), + (0x1EE8, "M", "ứ"), + (0x1EE9, "V"), + (0x1EEA, "M", "ừ"), + (0x1EEB, "V"), + (0x1EEC, "M", "ử"), + (0x1EED, "V"), + (0x1EEE, "M", "ữ"), + (0x1EEF, "V"), + (0x1EF0, "M", "ự"), + ] + + +def _seg_19() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x1EF1, "V"), + (0x1EF2, "M", "ỳ"), + (0x1EF3, "V"), + (0x1EF4, "M", "ỵ"), + (0x1EF5, "V"), + (0x1EF6, "M", "ỷ"), + (0x1EF7, "V"), + (0x1EF8, "M", "ỹ"), + (0x1EF9, "V"), + (0x1EFA, "M", "ỻ"), + (0x1EFB, "V"), + (0x1EFC, "M", "ỽ"), + (0x1EFD, "V"), + (0x1EFE, "M", "ỿ"), + (0x1EFF, "V"), + (0x1F08, "M", "ἀ"), + (0x1F09, "M", "ἁ"), + (0x1F0A, "M", "ἂ"), + (0x1F0B, "M", "ἃ"), + (0x1F0C, "M", "ἄ"), + (0x1F0D, "M", "ἅ"), + (0x1F0E, "M", "ἆ"), + (0x1F0F, "M", "ἇ"), + (0x1F10, "V"), + (0x1F16, "X"), + (0x1F18, "M", "ἐ"), + (0x1F19, "M", "ἑ"), + (0x1F1A, "M", "ἒ"), + (0x1F1B, "M", "ἓ"), + (0x1F1C, "M", "ἔ"), + (0x1F1D, "M", "ἕ"), + (0x1F1E, "X"), + (0x1F20, "V"), + (0x1F28, "M", "ἠ"), + (0x1F29, "M", "ἡ"), + (0x1F2A, "M", "ἢ"), + (0x1F2B, "M", "ἣ"), + (0x1F2C, "M", "ἤ"), + (0x1F2D, "M", "ἥ"), + (0x1F2E, "M", "ἦ"), + (0x1F2F, "M", "ἧ"), + (0x1F30, "V"), + (0x1F38, "M", "ἰ"), + (0x1F39, "M", "ἱ"), + (0x1F3A, "M", "ἲ"), + (0x1F3B, "M", "ἳ"), + (0x1F3C, "M", "ἴ"), + (0x1F3D, "M", "ἵ"), + (0x1F3E, "M", "ἶ"), + (0x1F3F, "M", "ἷ"), + (0x1F40, "V"), + (0x1F46, "X"), + (0x1F48, "M", "ὀ"), + (0x1F49, "M", "ὁ"), + (0x1F4A, "M", "ὂ"), + (0x1F4B, "M", "ὃ"), + (0x1F4C, "M", "ὄ"), + (0x1F4D, "M", "ὅ"), + (0x1F4E, "X"), + (0x1F50, "V"), + (0x1F58, "X"), + (0x1F59, "M", "ὑ"), + (0x1F5A, "X"), + (0x1F5B, "M", "ὓ"), + (0x1F5C, "X"), + (0x1F5D, "M", "ὕ"), + (0x1F5E, "X"), + (0x1F5F, "M", "ὗ"), + (0x1F60, "V"), + (0x1F68, "M", "ὠ"), + (0x1F69, "M", "ὡ"), + (0x1F6A, "M", "ὢ"), + (0x1F6B, "M", "ὣ"), + (0x1F6C, "M", "ὤ"), + (0x1F6D, "M", "ὥ"), + (0x1F6E, "M", "ὦ"), + (0x1F6F, "M", "ὧ"), + (0x1F70, "V"), + (0x1F71, "M", "ά"), + (0x1F72, "V"), + (0x1F73, "M", "έ"), + (0x1F74, "V"), + (0x1F75, "M", "ή"), + (0x1F76, "V"), + (0x1F77, "M", "ί"), + (0x1F78, "V"), + (0x1F79, "M", "ό"), + (0x1F7A, "V"), + (0x1F7B, "M", "ύ"), + (0x1F7C, "V"), + (0x1F7D, "M", "ώ"), + (0x1F7E, "X"), + (0x1F80, "M", "ἀι"), + (0x1F81, "M", "ἁι"), + (0x1F82, "M", "ἂι"), + (0x1F83, "M", "ἃι"), + (0x1F84, "M", "ἄι"), + (0x1F85, "M", "ἅι"), + (0x1F86, "M", "ἆι"), + (0x1F87, "M", "ἇι"), + ] + + +def _seg_20() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x1F88, "M", "ἀι"), + (0x1F89, "M", "ἁι"), + (0x1F8A, "M", "ἂι"), + (0x1F8B, "M", "ἃι"), + (0x1F8C, "M", "ἄι"), + (0x1F8D, "M", "ἅι"), + (0x1F8E, "M", "ἆι"), + (0x1F8F, "M", "ἇι"), + (0x1F90, "M", "ἠι"), + (0x1F91, "M", "ἡι"), + (0x1F92, "M", "ἢι"), + (0x1F93, "M", "ἣι"), + (0x1F94, "M", "ἤι"), + (0x1F95, "M", "ἥι"), + (0x1F96, "M", "ἦι"), + (0x1F97, "M", "ἧι"), + (0x1F98, "M", "ἠι"), + (0x1F99, "M", "ἡι"), + (0x1F9A, "M", "ἢι"), + (0x1F9B, "M", "ἣι"), + (0x1F9C, "M", "ἤι"), + (0x1F9D, "M", "ἥι"), + (0x1F9E, "M", "ἦι"), + (0x1F9F, "M", "ἧι"), + (0x1FA0, "M", "ὠι"), + (0x1FA1, "M", "ὡι"), + (0x1FA2, "M", "ὢι"), + (0x1FA3, "M", "ὣι"), + (0x1FA4, "M", "ὤι"), + (0x1FA5, "M", "ὥι"), + (0x1FA6, "M", "ὦι"), + (0x1FA7, "M", "ὧι"), + (0x1FA8, "M", "ὠι"), + (0x1FA9, "M", "ὡι"), + (0x1FAA, "M", "ὢι"), + (0x1FAB, "M", "ὣι"), + (0x1FAC, "M", "ὤι"), + (0x1FAD, "M", "ὥι"), + (0x1FAE, "M", "ὦι"), + (0x1FAF, "M", "ὧι"), + (0x1FB0, "V"), + (0x1FB2, "M", "ὰι"), + (0x1FB3, "M", "αι"), + (0x1FB4, "M", "άι"), + (0x1FB5, "X"), + (0x1FB6, "V"), + (0x1FB7, "M", "ᾶι"), + (0x1FB8, "M", "ᾰ"), + (0x1FB9, "M", "ᾱ"), + (0x1FBA, "M", "ὰ"), + (0x1FBB, "M", "ά"), + (0x1FBC, "M", "αι"), + (0x1FBD, "3", " ̓"), + (0x1FBE, "M", "ι"), + (0x1FBF, "3", " ̓"), + (0x1FC0, "3", " ͂"), + (0x1FC1, "3", " ̈͂"), + (0x1FC2, "M", "ὴι"), + (0x1FC3, "M", "ηι"), + (0x1FC4, "M", "ήι"), + (0x1FC5, "X"), + (0x1FC6, "V"), + (0x1FC7, "M", "ῆι"), + (0x1FC8, "M", "ὲ"), + (0x1FC9, "M", "έ"), + (0x1FCA, "M", "ὴ"), + (0x1FCB, "M", "ή"), + (0x1FCC, "M", "ηι"), + (0x1FCD, "3", " ̓̀"), + (0x1FCE, "3", " ̓́"), + (0x1FCF, "3", " ̓͂"), + (0x1FD0, "V"), + (0x1FD3, "M", "ΐ"), + (0x1FD4, "X"), + (0x1FD6, "V"), + (0x1FD8, "M", "ῐ"), + (0x1FD9, "M", "ῑ"), + (0x1FDA, "M", "ὶ"), + (0x1FDB, "M", "ί"), + (0x1FDC, "X"), + (0x1FDD, "3", " ̔̀"), + (0x1FDE, "3", " ̔́"), + (0x1FDF, "3", " ̔͂"), + (0x1FE0, "V"), + (0x1FE3, "M", "ΰ"), + (0x1FE4, "V"), + (0x1FE8, "M", "ῠ"), + (0x1FE9, "M", "ῡ"), + (0x1FEA, "M", "ὺ"), + (0x1FEB, "M", "ύ"), + (0x1FEC, "M", "ῥ"), + (0x1FED, "3", " ̈̀"), + (0x1FEE, "3", " ̈́"), + (0x1FEF, "3", "`"), + (0x1FF0, "X"), + (0x1FF2, "M", "ὼι"), + (0x1FF3, "M", "ωι"), + (0x1FF4, "M", "ώι"), + (0x1FF5, "X"), + (0x1FF6, "V"), + ] + + +def _seg_21() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x1FF7, "M", "ῶι"), + (0x1FF8, "M", "ὸ"), + (0x1FF9, "M", "ό"), + (0x1FFA, "M", "ὼ"), + (0x1FFB, "M", "ώ"), + (0x1FFC, "M", "ωι"), + (0x1FFD, "3", " ́"), + (0x1FFE, "3", " ̔"), + (0x1FFF, "X"), + (0x2000, "3", " "), + (0x200B, "I"), + (0x200C, "D", ""), + (0x200E, "X"), + (0x2010, "V"), + (0x2011, "M", "‐"), + (0x2012, "V"), + (0x2017, "3", " ̳"), + (0x2018, "V"), + (0x2024, "X"), + (0x2027, "V"), + (0x2028, "X"), + (0x202F, "3", " "), + (0x2030, "V"), + (0x2033, "M", "′′"), + (0x2034, "M", "′′′"), + (0x2035, "V"), + (0x2036, "M", "‵‵"), + (0x2037, "M", "‵‵‵"), + (0x2038, "V"), + (0x203C, "3", "!!"), + (0x203D, "V"), + (0x203E, "3", " ̅"), + (0x203F, "V"), + (0x2047, "3", "??"), + (0x2048, "3", "?!"), + (0x2049, "3", "!?"), + (0x204A, "V"), + (0x2057, "M", "′′′′"), + (0x2058, "V"), + (0x205F, "3", " "), + (0x2060, "I"), + (0x2061, "X"), + (0x2064, "I"), + (0x2065, "X"), + (0x2070, "M", "0"), + (0x2071, "M", "i"), + (0x2072, "X"), + (0x2074, "M", "4"), + (0x2075, "M", "5"), + (0x2076, "M", "6"), + (0x2077, "M", "7"), + (0x2078, "M", "8"), + (0x2079, "M", "9"), + (0x207A, "3", "+"), + (0x207B, "M", "−"), + (0x207C, "3", "="), + (0x207D, "3", "("), + (0x207E, "3", ")"), + (0x207F, "M", "n"), + (0x2080, "M", "0"), + (0x2081, "M", "1"), + (0x2082, "M", "2"), + (0x2083, "M", "3"), + (0x2084, "M", "4"), + (0x2085, "M", "5"), + (0x2086, "M", "6"), + (0x2087, "M", "7"), + (0x2088, "M", "8"), + (0x2089, "M", "9"), + (0x208A, "3", "+"), + (0x208B, "M", "−"), + (0x208C, "3", "="), + (0x208D, "3", "("), + (0x208E, "3", ")"), + (0x208F, "X"), + (0x2090, "M", "a"), + (0x2091, "M", "e"), + (0x2092, "M", "o"), + (0x2093, "M", "x"), + (0x2094, "M", "ə"), + (0x2095, "M", "h"), + (0x2096, "M", "k"), + (0x2097, "M", "l"), + (0x2098, "M", "m"), + (0x2099, "M", "n"), + (0x209A, "M", "p"), + (0x209B, "M", "s"), + (0x209C, "M", "t"), + (0x209D, "X"), + (0x20A0, "V"), + (0x20A8, "M", "rs"), + (0x20A9, "V"), + (0x20C1, "X"), + (0x20D0, "V"), + (0x20F1, "X"), + (0x2100, "3", "a/c"), + (0x2101, "3", "a/s"), + (0x2102, "M", "c"), + (0x2103, "M", "°c"), + (0x2104, "V"), + ] + + +def _seg_22() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x2105, "3", "c/o"), + (0x2106, "3", "c/u"), + (0x2107, "M", "ɛ"), + (0x2108, "V"), + (0x2109, "M", "°f"), + (0x210A, "M", "g"), + (0x210B, "M", "h"), + (0x210F, "M", "ħ"), + (0x2110, "M", "i"), + (0x2112, "M", "l"), + (0x2114, "V"), + (0x2115, "M", "n"), + (0x2116, "M", "no"), + (0x2117, "V"), + (0x2119, "M", "p"), + (0x211A, "M", "q"), + (0x211B, "M", "r"), + (0x211E, "V"), + (0x2120, "M", "sm"), + (0x2121, "M", "tel"), + (0x2122, "M", "tm"), + (0x2123, "V"), + (0x2124, "M", "z"), + (0x2125, "V"), + (0x2126, "M", "ω"), + (0x2127, "V"), + (0x2128, "M", "z"), + (0x2129, "V"), + (0x212A, "M", "k"), + (0x212B, "M", "å"), + (0x212C, "M", "b"), + (0x212D, "M", "c"), + (0x212E, "V"), + (0x212F, "M", "e"), + (0x2131, "M", "f"), + (0x2132, "X"), + (0x2133, "M", "m"), + (0x2134, "M", "o"), + (0x2135, "M", "א"), + (0x2136, "M", "ב"), + (0x2137, "M", "ג"), + (0x2138, "M", "ד"), + (0x2139, "M", "i"), + (0x213A, "V"), + (0x213B, "M", "fax"), + (0x213C, "M", "π"), + (0x213D, "M", "γ"), + (0x213F, "M", "π"), + (0x2140, "M", "∑"), + (0x2141, "V"), + (0x2145, "M", "d"), + (0x2147, "M", "e"), + (0x2148, "M", "i"), + (0x2149, "M", "j"), + (0x214A, "V"), + (0x2150, "M", "1⁄7"), + (0x2151, "M", "1⁄9"), + (0x2152, "M", "1⁄10"), + (0x2153, "M", "1⁄3"), + (0x2154, "M", "2⁄3"), + (0x2155, "M", "1⁄5"), + (0x2156, "M", "2⁄5"), + (0x2157, "M", "3⁄5"), + (0x2158, "M", "4⁄5"), + (0x2159, "M", "1⁄6"), + (0x215A, "M", "5⁄6"), + (0x215B, "M", "1⁄8"), + (0x215C, "M", "3⁄8"), + (0x215D, "M", "5⁄8"), + (0x215E, "M", "7⁄8"), + (0x215F, "M", "1⁄"), + (0x2160, "M", "i"), + (0x2161, "M", "ii"), + (0x2162, "M", "iii"), + (0x2163, "M", "iv"), + (0x2164, "M", "v"), + (0x2165, "M", "vi"), + (0x2166, "M", "vii"), + (0x2167, "M", "viii"), + (0x2168, "M", "ix"), + (0x2169, "M", "x"), + (0x216A, "M", "xi"), + (0x216B, "M", "xii"), + (0x216C, "M", "l"), + (0x216D, "M", "c"), + (0x216E, "M", "d"), + (0x216F, "M", "m"), + (0x2170, "M", "i"), + (0x2171, "M", "ii"), + (0x2172, "M", "iii"), + (0x2173, "M", "iv"), + (0x2174, "M", "v"), + (0x2175, "M", "vi"), + (0x2176, "M", "vii"), + (0x2177, "M", "viii"), + (0x2178, "M", "ix"), + (0x2179, "M", "x"), + (0x217A, "M", "xi"), + (0x217B, "M", "xii"), + (0x217C, "M", "l"), + ] + + +def _seg_23() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x217D, "M", "c"), + (0x217E, "M", "d"), + (0x217F, "M", "m"), + (0x2180, "V"), + (0x2183, "X"), + (0x2184, "V"), + (0x2189, "M", "0⁄3"), + (0x218A, "V"), + (0x218C, "X"), + (0x2190, "V"), + (0x222C, "M", "∫∫"), + (0x222D, "M", "∫∫∫"), + (0x222E, "V"), + (0x222F, "M", "∮∮"), + (0x2230, "M", "∮∮∮"), + (0x2231, "V"), + (0x2329, "M", "〈"), + (0x232A, "M", "〉"), + (0x232B, "V"), + (0x2427, "X"), + (0x2440, "V"), + (0x244B, "X"), + (0x2460, "M", "1"), + (0x2461, "M", "2"), + (0x2462, "M", "3"), + (0x2463, "M", "4"), + (0x2464, "M", "5"), + (0x2465, "M", "6"), + (0x2466, "M", "7"), + (0x2467, "M", "8"), + (0x2468, "M", "9"), + (0x2469, "M", "10"), + (0x246A, "M", "11"), + (0x246B, "M", "12"), + (0x246C, "M", "13"), + (0x246D, "M", "14"), + (0x246E, "M", "15"), + (0x246F, "M", "16"), + (0x2470, "M", "17"), + (0x2471, "M", "18"), + (0x2472, "M", "19"), + (0x2473, "M", "20"), + (0x2474, "3", "(1)"), + (0x2475, "3", "(2)"), + (0x2476, "3", "(3)"), + (0x2477, "3", "(4)"), + (0x2478, "3", "(5)"), + (0x2479, "3", "(6)"), + (0x247A, "3", "(7)"), + (0x247B, "3", "(8)"), + (0x247C, "3", "(9)"), + (0x247D, "3", "(10)"), + (0x247E, "3", "(11)"), + (0x247F, "3", "(12)"), + (0x2480, "3", "(13)"), + (0x2481, "3", "(14)"), + (0x2482, "3", "(15)"), + (0x2483, "3", "(16)"), + (0x2484, "3", "(17)"), + (0x2485, "3", "(18)"), + (0x2486, "3", "(19)"), + (0x2487, "3", "(20)"), + (0x2488, "X"), + (0x249C, "3", "(a)"), + (0x249D, "3", "(b)"), + (0x249E, "3", "(c)"), + (0x249F, "3", "(d)"), + (0x24A0, "3", "(e)"), + (0x24A1, "3", "(f)"), + (0x24A2, "3", "(g)"), + (0x24A3, "3", "(h)"), + (0x24A4, "3", "(i)"), + (0x24A5, "3", "(j)"), + (0x24A6, "3", "(k)"), + (0x24A7, "3", "(l)"), + (0x24A8, "3", "(m)"), + (0x24A9, "3", "(n)"), + (0x24AA, "3", "(o)"), + (0x24AB, "3", "(p)"), + (0x24AC, "3", "(q)"), + (0x24AD, "3", "(r)"), + (0x24AE, "3", "(s)"), + (0x24AF, "3", "(t)"), + (0x24B0, "3", "(u)"), + (0x24B1, "3", "(v)"), + (0x24B2, "3", "(w)"), + (0x24B3, "3", "(x)"), + (0x24B4, "3", "(y)"), + (0x24B5, "3", "(z)"), + (0x24B6, "M", "a"), + (0x24B7, "M", "b"), + (0x24B8, "M", "c"), + (0x24B9, "M", "d"), + (0x24BA, "M", "e"), + (0x24BB, "M", "f"), + (0x24BC, "M", "g"), + (0x24BD, "M", "h"), + (0x24BE, "M", "i"), + (0x24BF, "M", "j"), + (0x24C0, "M", "k"), + ] + + +def _seg_24() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x24C1, "M", "l"), + (0x24C2, "M", "m"), + (0x24C3, "M", "n"), + (0x24C4, "M", "o"), + (0x24C5, "M", "p"), + (0x24C6, "M", "q"), + (0x24C7, "M", "r"), + (0x24C8, "M", "s"), + (0x24C9, "M", "t"), + (0x24CA, "M", "u"), + (0x24CB, "M", "v"), + (0x24CC, "M", "w"), + (0x24CD, "M", "x"), + (0x24CE, "M", "y"), + (0x24CF, "M", "z"), + (0x24D0, "M", "a"), + (0x24D1, "M", "b"), + (0x24D2, "M", "c"), + (0x24D3, "M", "d"), + (0x24D4, "M", "e"), + (0x24D5, "M", "f"), + (0x24D6, "M", "g"), + (0x24D7, "M", "h"), + (0x24D8, "M", "i"), + (0x24D9, "M", "j"), + (0x24DA, "M", "k"), + (0x24DB, "M", "l"), + (0x24DC, "M", "m"), + (0x24DD, "M", "n"), + (0x24DE, "M", "o"), + (0x24DF, "M", "p"), + (0x24E0, "M", "q"), + (0x24E1, "M", "r"), + (0x24E2, "M", "s"), + (0x24E3, "M", "t"), + (0x24E4, "M", "u"), + (0x24E5, "M", "v"), + (0x24E6, "M", "w"), + (0x24E7, "M", "x"), + (0x24E8, "M", "y"), + (0x24E9, "M", "z"), + (0x24EA, "M", "0"), + (0x24EB, "V"), + (0x2A0C, "M", "∫∫∫∫"), + (0x2A0D, "V"), + (0x2A74, "3", "::="), + (0x2A75, "3", "=="), + (0x2A76, "3", "==="), + (0x2A77, "V"), + (0x2ADC, "M", "⫝̸"), + (0x2ADD, "V"), + (0x2B74, "X"), + (0x2B76, "V"), + (0x2B96, "X"), + (0x2B97, "V"), + (0x2C00, "M", "ⰰ"), + (0x2C01, "M", "ⰱ"), + (0x2C02, "M", "ⰲ"), + (0x2C03, "M", "ⰳ"), + (0x2C04, "M", "ⰴ"), + (0x2C05, "M", "ⰵ"), + (0x2C06, "M", "ⰶ"), + (0x2C07, "M", "ⰷ"), + (0x2C08, "M", "ⰸ"), + (0x2C09, "M", "ⰹ"), + (0x2C0A, "M", "ⰺ"), + (0x2C0B, "M", "ⰻ"), + (0x2C0C, "M", "ⰼ"), + (0x2C0D, "M", "ⰽ"), + (0x2C0E, "M", "ⰾ"), + (0x2C0F, "M", "ⰿ"), + (0x2C10, "M", "ⱀ"), + (0x2C11, "M", "ⱁ"), + (0x2C12, "M", "ⱂ"), + (0x2C13, "M", "ⱃ"), + (0x2C14, "M", "ⱄ"), + (0x2C15, "M", "ⱅ"), + (0x2C16, "M", "ⱆ"), + (0x2C17, "M", "ⱇ"), + (0x2C18, "M", "ⱈ"), + (0x2C19, "M", "ⱉ"), + (0x2C1A, "M", "ⱊ"), + (0x2C1B, "M", "ⱋ"), + (0x2C1C, "M", "ⱌ"), + (0x2C1D, "M", "ⱍ"), + (0x2C1E, "M", "ⱎ"), + (0x2C1F, "M", "ⱏ"), + (0x2C20, "M", "ⱐ"), + (0x2C21, "M", "ⱑ"), + (0x2C22, "M", "ⱒ"), + (0x2C23, "M", "ⱓ"), + (0x2C24, "M", "ⱔ"), + (0x2C25, "M", "ⱕ"), + (0x2C26, "M", "ⱖ"), + (0x2C27, "M", "ⱗ"), + (0x2C28, "M", "ⱘ"), + (0x2C29, "M", "ⱙ"), + (0x2C2A, "M", "ⱚ"), + (0x2C2B, "M", "ⱛ"), + (0x2C2C, "M", "ⱜ"), + ] + + +def _seg_25() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x2C2D, "M", "ⱝ"), + (0x2C2E, "M", "ⱞ"), + (0x2C2F, "M", "ⱟ"), + (0x2C30, "V"), + (0x2C60, "M", "ⱡ"), + (0x2C61, "V"), + (0x2C62, "M", "ɫ"), + (0x2C63, "M", "ᵽ"), + (0x2C64, "M", "ɽ"), + (0x2C65, "V"), + (0x2C67, "M", "ⱨ"), + (0x2C68, "V"), + (0x2C69, "M", "ⱪ"), + (0x2C6A, "V"), + (0x2C6B, "M", "ⱬ"), + (0x2C6C, "V"), + (0x2C6D, "M", "ɑ"), + (0x2C6E, "M", "ɱ"), + (0x2C6F, "M", "ɐ"), + (0x2C70, "M", "ɒ"), + (0x2C71, "V"), + (0x2C72, "M", "ⱳ"), + (0x2C73, "V"), + (0x2C75, "M", "ⱶ"), + (0x2C76, "V"), + (0x2C7C, "M", "j"), + (0x2C7D, "M", "v"), + (0x2C7E, "M", "ȿ"), + (0x2C7F, "M", "ɀ"), + (0x2C80, "M", "ⲁ"), + (0x2C81, "V"), + (0x2C82, "M", "ⲃ"), + (0x2C83, "V"), + (0x2C84, "M", "ⲅ"), + (0x2C85, "V"), + (0x2C86, "M", "ⲇ"), + (0x2C87, "V"), + (0x2C88, "M", "ⲉ"), + (0x2C89, "V"), + (0x2C8A, "M", "ⲋ"), + (0x2C8B, "V"), + (0x2C8C, "M", "ⲍ"), + (0x2C8D, "V"), + (0x2C8E, "M", "ⲏ"), + (0x2C8F, "V"), + (0x2C90, "M", "ⲑ"), + (0x2C91, "V"), + (0x2C92, "M", "ⲓ"), + (0x2C93, "V"), + (0x2C94, "M", "ⲕ"), + (0x2C95, "V"), + (0x2C96, "M", "ⲗ"), + (0x2C97, "V"), + (0x2C98, "M", "ⲙ"), + (0x2C99, "V"), + (0x2C9A, "M", "ⲛ"), + (0x2C9B, "V"), + (0x2C9C, "M", "ⲝ"), + (0x2C9D, "V"), + (0x2C9E, "M", "ⲟ"), + (0x2C9F, "V"), + (0x2CA0, "M", "ⲡ"), + (0x2CA1, "V"), + (0x2CA2, "M", "ⲣ"), + (0x2CA3, "V"), + (0x2CA4, "M", "ⲥ"), + (0x2CA5, "V"), + (0x2CA6, "M", "ⲧ"), + (0x2CA7, "V"), + (0x2CA8, "M", "ⲩ"), + (0x2CA9, "V"), + (0x2CAA, "M", "ⲫ"), + (0x2CAB, "V"), + (0x2CAC, "M", "ⲭ"), + (0x2CAD, "V"), + (0x2CAE, "M", "ⲯ"), + (0x2CAF, "V"), + (0x2CB0, "M", "ⲱ"), + (0x2CB1, "V"), + (0x2CB2, "M", "ⲳ"), + (0x2CB3, "V"), + (0x2CB4, "M", "ⲵ"), + (0x2CB5, "V"), + (0x2CB6, "M", "ⲷ"), + (0x2CB7, "V"), + (0x2CB8, "M", "ⲹ"), + (0x2CB9, "V"), + (0x2CBA, "M", "ⲻ"), + (0x2CBB, "V"), + (0x2CBC, "M", "ⲽ"), + (0x2CBD, "V"), + (0x2CBE, "M", "ⲿ"), + (0x2CBF, "V"), + (0x2CC0, "M", "ⳁ"), + (0x2CC1, "V"), + (0x2CC2, "M", "ⳃ"), + (0x2CC3, "V"), + (0x2CC4, "M", "ⳅ"), + (0x2CC5, "V"), + (0x2CC6, "M", "ⳇ"), + ] + + +def _seg_26() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x2CC7, "V"), + (0x2CC8, "M", "ⳉ"), + (0x2CC9, "V"), + (0x2CCA, "M", "ⳋ"), + (0x2CCB, "V"), + (0x2CCC, "M", "ⳍ"), + (0x2CCD, "V"), + (0x2CCE, "M", "ⳏ"), + (0x2CCF, "V"), + (0x2CD0, "M", "ⳑ"), + (0x2CD1, "V"), + (0x2CD2, "M", "ⳓ"), + (0x2CD3, "V"), + (0x2CD4, "M", "ⳕ"), + (0x2CD5, "V"), + (0x2CD6, "M", "ⳗ"), + (0x2CD7, "V"), + (0x2CD8, "M", "ⳙ"), + (0x2CD9, "V"), + (0x2CDA, "M", "ⳛ"), + (0x2CDB, "V"), + (0x2CDC, "M", "ⳝ"), + (0x2CDD, "V"), + (0x2CDE, "M", "ⳟ"), + (0x2CDF, "V"), + (0x2CE0, "M", "ⳡ"), + (0x2CE1, "V"), + (0x2CE2, "M", "ⳣ"), + (0x2CE3, "V"), + (0x2CEB, "M", "ⳬ"), + (0x2CEC, "V"), + (0x2CED, "M", "ⳮ"), + (0x2CEE, "V"), + (0x2CF2, "M", "ⳳ"), + (0x2CF3, "V"), + (0x2CF4, "X"), + (0x2CF9, "V"), + (0x2D26, "X"), + (0x2D27, "V"), + (0x2D28, "X"), + (0x2D2D, "V"), + (0x2D2E, "X"), + (0x2D30, "V"), + (0x2D68, "X"), + (0x2D6F, "M", "ⵡ"), + (0x2D70, "V"), + (0x2D71, "X"), + (0x2D7F, "V"), + (0x2D97, "X"), + (0x2DA0, "V"), + (0x2DA7, "X"), + (0x2DA8, "V"), + (0x2DAF, "X"), + (0x2DB0, "V"), + (0x2DB7, "X"), + (0x2DB8, "V"), + (0x2DBF, "X"), + (0x2DC0, "V"), + (0x2DC7, "X"), + (0x2DC8, "V"), + (0x2DCF, "X"), + (0x2DD0, "V"), + (0x2DD7, "X"), + (0x2DD8, "V"), + (0x2DDF, "X"), + (0x2DE0, "V"), + (0x2E5E, "X"), + (0x2E80, "V"), + (0x2E9A, "X"), + (0x2E9B, "V"), + (0x2E9F, "M", "母"), + (0x2EA0, "V"), + (0x2EF3, "M", "龟"), + (0x2EF4, "X"), + (0x2F00, "M", "一"), + (0x2F01, "M", "丨"), + (0x2F02, "M", "丶"), + (0x2F03, "M", "丿"), + (0x2F04, "M", "乙"), + (0x2F05, "M", "亅"), + (0x2F06, "M", "二"), + (0x2F07, "M", "亠"), + (0x2F08, "M", "人"), + (0x2F09, "M", "儿"), + (0x2F0A, "M", "入"), + (0x2F0B, "M", "八"), + (0x2F0C, "M", "冂"), + (0x2F0D, "M", "冖"), + (0x2F0E, "M", "冫"), + (0x2F0F, "M", "几"), + (0x2F10, "M", "凵"), + (0x2F11, "M", "刀"), + (0x2F12, "M", "力"), + (0x2F13, "M", "勹"), + (0x2F14, "M", "匕"), + (0x2F15, "M", "匚"), + (0x2F16, "M", "匸"), + (0x2F17, "M", "十"), + (0x2F18, "M", "卜"), + (0x2F19, "M", "卩"), + ] + + +def _seg_27() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x2F1A, "M", "厂"), + (0x2F1B, "M", "厶"), + (0x2F1C, "M", "又"), + (0x2F1D, "M", "口"), + (0x2F1E, "M", "囗"), + (0x2F1F, "M", "土"), + (0x2F20, "M", "士"), + (0x2F21, "M", "夂"), + (0x2F22, "M", "夊"), + (0x2F23, "M", "夕"), + (0x2F24, "M", "大"), + (0x2F25, "M", "女"), + (0x2F26, "M", "子"), + (0x2F27, "M", "宀"), + (0x2F28, "M", "寸"), + (0x2F29, "M", "小"), + (0x2F2A, "M", "尢"), + (0x2F2B, "M", "尸"), + (0x2F2C, "M", "屮"), + (0x2F2D, "M", "山"), + (0x2F2E, "M", "巛"), + (0x2F2F, "M", "工"), + (0x2F30, "M", "己"), + (0x2F31, "M", "巾"), + (0x2F32, "M", "干"), + (0x2F33, "M", "幺"), + (0x2F34, "M", "广"), + (0x2F35, "M", "廴"), + (0x2F36, "M", "廾"), + (0x2F37, "M", "弋"), + (0x2F38, "M", "弓"), + (0x2F39, "M", "彐"), + (0x2F3A, "M", "彡"), + (0x2F3B, "M", "彳"), + (0x2F3C, "M", "心"), + (0x2F3D, "M", "戈"), + (0x2F3E, "M", "戶"), + (0x2F3F, "M", "手"), + (0x2F40, "M", "支"), + (0x2F41, "M", "攴"), + (0x2F42, "M", "文"), + (0x2F43, "M", "斗"), + (0x2F44, "M", "斤"), + (0x2F45, "M", "方"), + (0x2F46, "M", "无"), + (0x2F47, "M", "日"), + (0x2F48, "M", "曰"), + (0x2F49, "M", "月"), + (0x2F4A, "M", "木"), + (0x2F4B, "M", "欠"), + (0x2F4C, "M", "止"), + (0x2F4D, "M", "歹"), + (0x2F4E, "M", "殳"), + (0x2F4F, "M", "毋"), + (0x2F50, "M", "比"), + (0x2F51, "M", "毛"), + (0x2F52, "M", "氏"), + (0x2F53, "M", "气"), + (0x2F54, "M", "水"), + (0x2F55, "M", "火"), + (0x2F56, "M", "爪"), + (0x2F57, "M", "父"), + (0x2F58, "M", "爻"), + (0x2F59, "M", "爿"), + (0x2F5A, "M", "片"), + (0x2F5B, "M", "牙"), + (0x2F5C, "M", "牛"), + (0x2F5D, "M", "犬"), + (0x2F5E, "M", "玄"), + (0x2F5F, "M", "玉"), + (0x2F60, "M", "瓜"), + (0x2F61, "M", "瓦"), + (0x2F62, "M", "甘"), + (0x2F63, "M", "生"), + (0x2F64, "M", "用"), + (0x2F65, "M", "田"), + (0x2F66, "M", "疋"), + (0x2F67, "M", "疒"), + (0x2F68, "M", "癶"), + (0x2F69, "M", "白"), + (0x2F6A, "M", "皮"), + (0x2F6B, "M", "皿"), + (0x2F6C, "M", "目"), + (0x2F6D, "M", "矛"), + (0x2F6E, "M", "矢"), + (0x2F6F, "M", "石"), + (0x2F70, "M", "示"), + (0x2F71, "M", "禸"), + (0x2F72, "M", "禾"), + (0x2F73, "M", "穴"), + (0x2F74, "M", "立"), + (0x2F75, "M", "竹"), + (0x2F76, "M", "米"), + (0x2F77, "M", "糸"), + (0x2F78, "M", "缶"), + (0x2F79, "M", "网"), + (0x2F7A, "M", "羊"), + (0x2F7B, "M", "羽"), + (0x2F7C, "M", "老"), + (0x2F7D, "M", "而"), + ] + + +def _seg_28() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x2F7E, "M", "耒"), + (0x2F7F, "M", "耳"), + (0x2F80, "M", "聿"), + (0x2F81, "M", "肉"), + (0x2F82, "M", "臣"), + (0x2F83, "M", "自"), + (0x2F84, "M", "至"), + (0x2F85, "M", "臼"), + (0x2F86, "M", "舌"), + (0x2F87, "M", "舛"), + (0x2F88, "M", "舟"), + (0x2F89, "M", "艮"), + (0x2F8A, "M", "色"), + (0x2F8B, "M", "艸"), + (0x2F8C, "M", "虍"), + (0x2F8D, "M", "虫"), + (0x2F8E, "M", "血"), + (0x2F8F, "M", "行"), + (0x2F90, "M", "衣"), + (0x2F91, "M", "襾"), + (0x2F92, "M", "見"), + (0x2F93, "M", "角"), + (0x2F94, "M", "言"), + (0x2F95, "M", "谷"), + (0x2F96, "M", "豆"), + (0x2F97, "M", "豕"), + (0x2F98, "M", "豸"), + (0x2F99, "M", "貝"), + (0x2F9A, "M", "赤"), + (0x2F9B, "M", "走"), + (0x2F9C, "M", "足"), + (0x2F9D, "M", "身"), + (0x2F9E, "M", "車"), + (0x2F9F, "M", "辛"), + (0x2FA0, "M", "辰"), + (0x2FA1, "M", "辵"), + (0x2FA2, "M", "邑"), + (0x2FA3, "M", "酉"), + (0x2FA4, "M", "釆"), + (0x2FA5, "M", "里"), + (0x2FA6, "M", "金"), + (0x2FA7, "M", "長"), + (0x2FA8, "M", "門"), + (0x2FA9, "M", "阜"), + (0x2FAA, "M", "隶"), + (0x2FAB, "M", "隹"), + (0x2FAC, "M", "雨"), + (0x2FAD, "M", "靑"), + (0x2FAE, "M", "非"), + (0x2FAF, "M", "面"), + (0x2FB0, "M", "革"), + (0x2FB1, "M", "韋"), + (0x2FB2, "M", "韭"), + (0x2FB3, "M", "音"), + (0x2FB4, "M", "頁"), + (0x2FB5, "M", "風"), + (0x2FB6, "M", "飛"), + (0x2FB7, "M", "食"), + (0x2FB8, "M", "首"), + (0x2FB9, "M", "香"), + (0x2FBA, "M", "馬"), + (0x2FBB, "M", "骨"), + (0x2FBC, "M", "高"), + (0x2FBD, "M", "髟"), + (0x2FBE, "M", "鬥"), + (0x2FBF, "M", "鬯"), + (0x2FC0, "M", "鬲"), + (0x2FC1, "M", "鬼"), + (0x2FC2, "M", "魚"), + (0x2FC3, "M", "鳥"), + (0x2FC4, "M", "鹵"), + (0x2FC5, "M", "鹿"), + (0x2FC6, "M", "麥"), + (0x2FC7, "M", "麻"), + (0x2FC8, "M", "黃"), + (0x2FC9, "M", "黍"), + (0x2FCA, "M", "黑"), + (0x2FCB, "M", "黹"), + (0x2FCC, "M", "黽"), + (0x2FCD, "M", "鼎"), + (0x2FCE, "M", "鼓"), + (0x2FCF, "M", "鼠"), + (0x2FD0, "M", "鼻"), + (0x2FD1, "M", "齊"), + (0x2FD2, "M", "齒"), + (0x2FD3, "M", "龍"), + (0x2FD4, "M", "龜"), + (0x2FD5, "M", "龠"), + (0x2FD6, "X"), + (0x3000, "3", " "), + (0x3001, "V"), + (0x3002, "M", "."), + (0x3003, "V"), + (0x3036, "M", "〒"), + (0x3037, "V"), + (0x3038, "M", "十"), + (0x3039, "M", "卄"), + (0x303A, "M", "卅"), + (0x303B, "V"), + (0x3040, "X"), + ] + + +def _seg_29() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x3041, "V"), + (0x3097, "X"), + (0x3099, "V"), + (0x309B, "3", " ゙"), + (0x309C, "3", " ゚"), + (0x309D, "V"), + (0x309F, "M", "より"), + (0x30A0, "V"), + (0x30FF, "M", "コト"), + (0x3100, "X"), + (0x3105, "V"), + (0x3130, "X"), + (0x3131, "M", "ᄀ"), + (0x3132, "M", "ᄁ"), + (0x3133, "M", "ᆪ"), + (0x3134, "M", "ᄂ"), + (0x3135, "M", "ᆬ"), + (0x3136, "M", "ᆭ"), + (0x3137, "M", "ᄃ"), + (0x3138, "M", "ᄄ"), + (0x3139, "M", "ᄅ"), + (0x313A, "M", "ᆰ"), + (0x313B, "M", "ᆱ"), + (0x313C, "M", "ᆲ"), + (0x313D, "M", "ᆳ"), + (0x313E, "M", "ᆴ"), + (0x313F, "M", "ᆵ"), + (0x3140, "M", "ᄚ"), + (0x3141, "M", "ᄆ"), + (0x3142, "M", "ᄇ"), + (0x3143, "M", "ᄈ"), + (0x3144, "M", "ᄡ"), + (0x3145, "M", "ᄉ"), + (0x3146, "M", "ᄊ"), + (0x3147, "M", "ᄋ"), + (0x3148, "M", "ᄌ"), + (0x3149, "M", "ᄍ"), + (0x314A, "M", "ᄎ"), + (0x314B, "M", "ᄏ"), + (0x314C, "M", "ᄐ"), + (0x314D, "M", "ᄑ"), + (0x314E, "M", "ᄒ"), + (0x314F, "M", "ᅡ"), + (0x3150, "M", "ᅢ"), + (0x3151, "M", "ᅣ"), + (0x3152, "M", "ᅤ"), + (0x3153, "M", "ᅥ"), + (0x3154, "M", "ᅦ"), + (0x3155, "M", "ᅧ"), + (0x3156, "M", "ᅨ"), + (0x3157, "M", "ᅩ"), + (0x3158, "M", "ᅪ"), + (0x3159, "M", "ᅫ"), + (0x315A, "M", "ᅬ"), + (0x315B, "M", "ᅭ"), + (0x315C, "M", "ᅮ"), + (0x315D, "M", "ᅯ"), + (0x315E, "M", "ᅰ"), + (0x315F, "M", "ᅱ"), + (0x3160, "M", "ᅲ"), + (0x3161, "M", "ᅳ"), + (0x3162, "M", "ᅴ"), + (0x3163, "M", "ᅵ"), + (0x3164, "X"), + (0x3165, "M", "ᄔ"), + (0x3166, "M", "ᄕ"), + (0x3167, "M", "ᇇ"), + (0x3168, "M", "ᇈ"), + (0x3169, "M", "ᇌ"), + (0x316A, "M", "ᇎ"), + (0x316B, "M", "ᇓ"), + (0x316C, "M", "ᇗ"), + (0x316D, "M", "ᇙ"), + (0x316E, "M", "ᄜ"), + (0x316F, "M", "ᇝ"), + (0x3170, "M", "ᇟ"), + (0x3171, "M", "ᄝ"), + (0x3172, "M", "ᄞ"), + (0x3173, "M", "ᄠ"), + (0x3174, "M", "ᄢ"), + (0x3175, "M", "ᄣ"), + (0x3176, "M", "ᄧ"), + (0x3177, "M", "ᄩ"), + (0x3178, "M", "ᄫ"), + (0x3179, "M", "ᄬ"), + (0x317A, "M", "ᄭ"), + (0x317B, "M", "ᄮ"), + (0x317C, "M", "ᄯ"), + (0x317D, "M", "ᄲ"), + (0x317E, "M", "ᄶ"), + (0x317F, "M", "ᅀ"), + (0x3180, "M", "ᅇ"), + (0x3181, "M", "ᅌ"), + (0x3182, "M", "ᇱ"), + (0x3183, "M", "ᇲ"), + (0x3184, "M", "ᅗ"), + (0x3185, "M", "ᅘ"), + (0x3186, "M", "ᅙ"), + (0x3187, "M", "ᆄ"), + (0x3188, "M", "ᆅ"), + ] + + +def _seg_30() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x3189, "M", "ᆈ"), + (0x318A, "M", "ᆑ"), + (0x318B, "M", "ᆒ"), + (0x318C, "M", "ᆔ"), + (0x318D, "M", "ᆞ"), + (0x318E, "M", "ᆡ"), + (0x318F, "X"), + (0x3190, "V"), + (0x3192, "M", "一"), + (0x3193, "M", "二"), + (0x3194, "M", "三"), + (0x3195, "M", "四"), + (0x3196, "M", "上"), + (0x3197, "M", "中"), + (0x3198, "M", "下"), + (0x3199, "M", "甲"), + (0x319A, "M", "乙"), + (0x319B, "M", "丙"), + (0x319C, "M", "丁"), + (0x319D, "M", "天"), + (0x319E, "M", "地"), + (0x319F, "M", "人"), + (0x31A0, "V"), + (0x31E4, "X"), + (0x31F0, "V"), + (0x3200, "3", "(ᄀ)"), + (0x3201, "3", "(ᄂ)"), + (0x3202, "3", "(ᄃ)"), + (0x3203, "3", "(ᄅ)"), + (0x3204, "3", "(ᄆ)"), + (0x3205, "3", "(ᄇ)"), + (0x3206, "3", "(ᄉ)"), + (0x3207, "3", "(ᄋ)"), + (0x3208, "3", "(ᄌ)"), + (0x3209, "3", "(ᄎ)"), + (0x320A, "3", "(ᄏ)"), + (0x320B, "3", "(ᄐ)"), + (0x320C, "3", "(ᄑ)"), + (0x320D, "3", "(ᄒ)"), + (0x320E, "3", "(가)"), + (0x320F, "3", "(나)"), + (0x3210, "3", "(다)"), + (0x3211, "3", "(라)"), + (0x3212, "3", "(마)"), + (0x3213, "3", "(바)"), + (0x3214, "3", "(사)"), + (0x3215, "3", "(아)"), + (0x3216, "3", "(자)"), + (0x3217, "3", "(차)"), + (0x3218, "3", "(카)"), + (0x3219, "3", "(타)"), + (0x321A, "3", "(파)"), + (0x321B, "3", "(하)"), + (0x321C, "3", "(주)"), + (0x321D, "3", "(오전)"), + (0x321E, "3", "(오후)"), + (0x321F, "X"), + (0x3220, "3", "(一)"), + (0x3221, "3", "(二)"), + (0x3222, "3", "(三)"), + (0x3223, "3", "(四)"), + (0x3224, "3", "(五)"), + (0x3225, "3", "(六)"), + (0x3226, "3", "(七)"), + (0x3227, "3", "(八)"), + (0x3228, "3", "(九)"), + (0x3229, "3", "(十)"), + (0x322A, "3", "(月)"), + (0x322B, "3", "(火)"), + (0x322C, "3", "(水)"), + (0x322D, "3", "(木)"), + (0x322E, "3", "(金)"), + (0x322F, "3", "(土)"), + (0x3230, "3", "(日)"), + (0x3231, "3", "(株)"), + (0x3232, "3", "(有)"), + (0x3233, "3", "(社)"), + (0x3234, "3", "(名)"), + (0x3235, "3", "(特)"), + (0x3236, "3", "(財)"), + (0x3237, "3", "(祝)"), + (0x3238, "3", "(労)"), + (0x3239, "3", "(代)"), + (0x323A, "3", "(呼)"), + (0x323B, "3", "(学)"), + (0x323C, "3", "(監)"), + (0x323D, "3", "(企)"), + (0x323E, "3", "(資)"), + (0x323F, "3", "(協)"), + (0x3240, "3", "(祭)"), + (0x3241, "3", "(休)"), + (0x3242, "3", "(自)"), + (0x3243, "3", "(至)"), + (0x3244, "M", "問"), + (0x3245, "M", "幼"), + (0x3246, "M", "文"), + (0x3247, "M", "箏"), + (0x3248, "V"), + (0x3250, "M", "pte"), + (0x3251, "M", "21"), + ] + + +def _seg_31() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x3252, "M", "22"), + (0x3253, "M", "23"), + (0x3254, "M", "24"), + (0x3255, "M", "25"), + (0x3256, "M", "26"), + (0x3257, "M", "27"), + (0x3258, "M", "28"), + (0x3259, "M", "29"), + (0x325A, "M", "30"), + (0x325B, "M", "31"), + (0x325C, "M", "32"), + (0x325D, "M", "33"), + (0x325E, "M", "34"), + (0x325F, "M", "35"), + (0x3260, "M", "ᄀ"), + (0x3261, "M", "ᄂ"), + (0x3262, "M", "ᄃ"), + (0x3263, "M", "ᄅ"), + (0x3264, "M", "ᄆ"), + (0x3265, "M", "ᄇ"), + (0x3266, "M", "ᄉ"), + (0x3267, "M", "ᄋ"), + (0x3268, "M", "ᄌ"), + (0x3269, "M", "ᄎ"), + (0x326A, "M", "ᄏ"), + (0x326B, "M", "ᄐ"), + (0x326C, "M", "ᄑ"), + (0x326D, "M", "ᄒ"), + (0x326E, "M", "가"), + (0x326F, "M", "나"), + (0x3270, "M", "다"), + (0x3271, "M", "라"), + (0x3272, "M", "마"), + (0x3273, "M", "바"), + (0x3274, "M", "사"), + (0x3275, "M", "아"), + (0x3276, "M", "자"), + (0x3277, "M", "차"), + (0x3278, "M", "카"), + (0x3279, "M", "타"), + (0x327A, "M", "파"), + (0x327B, "M", "하"), + (0x327C, "M", "참고"), + (0x327D, "M", "주의"), + (0x327E, "M", "우"), + (0x327F, "V"), + (0x3280, "M", "一"), + (0x3281, "M", "二"), + (0x3282, "M", "三"), + (0x3283, "M", "四"), + (0x3284, "M", "五"), + (0x3285, "M", "六"), + (0x3286, "M", "七"), + (0x3287, "M", "八"), + (0x3288, "M", "九"), + (0x3289, "M", "十"), + (0x328A, "M", "月"), + (0x328B, "M", "火"), + (0x328C, "M", "水"), + (0x328D, "M", "木"), + (0x328E, "M", "金"), + (0x328F, "M", "土"), + (0x3290, "M", "日"), + (0x3291, "M", "株"), + (0x3292, "M", "有"), + (0x3293, "M", "社"), + (0x3294, "M", "名"), + (0x3295, "M", "特"), + (0x3296, "M", "財"), + (0x3297, "M", "祝"), + (0x3298, "M", "労"), + (0x3299, "M", "秘"), + (0x329A, "M", "男"), + (0x329B, "M", "女"), + (0x329C, "M", "適"), + (0x329D, "M", "優"), + (0x329E, "M", "印"), + (0x329F, "M", "注"), + (0x32A0, "M", "項"), + (0x32A1, "M", "休"), + (0x32A2, "M", "写"), + (0x32A3, "M", "正"), + (0x32A4, "M", "上"), + (0x32A5, "M", "中"), + (0x32A6, "M", "下"), + (0x32A7, "M", "左"), + (0x32A8, "M", "右"), + (0x32A9, "M", "医"), + (0x32AA, "M", "宗"), + (0x32AB, "M", "学"), + (0x32AC, "M", "監"), + (0x32AD, "M", "企"), + (0x32AE, "M", "資"), + (0x32AF, "M", "協"), + (0x32B0, "M", "夜"), + (0x32B1, "M", "36"), + (0x32B2, "M", "37"), + (0x32B3, "M", "38"), + (0x32B4, "M", "39"), + (0x32B5, "M", "40"), + ] + + +def _seg_32() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x32B6, "M", "41"), + (0x32B7, "M", "42"), + (0x32B8, "M", "43"), + (0x32B9, "M", "44"), + (0x32BA, "M", "45"), + (0x32BB, "M", "46"), + (0x32BC, "M", "47"), + (0x32BD, "M", "48"), + (0x32BE, "M", "49"), + (0x32BF, "M", "50"), + (0x32C0, "M", "1月"), + (0x32C1, "M", "2月"), + (0x32C2, "M", "3月"), + (0x32C3, "M", "4月"), + (0x32C4, "M", "5月"), + (0x32C5, "M", "6月"), + (0x32C6, "M", "7月"), + (0x32C7, "M", "8月"), + (0x32C8, "M", "9月"), + (0x32C9, "M", "10月"), + (0x32CA, "M", "11月"), + (0x32CB, "M", "12月"), + (0x32CC, "M", "hg"), + (0x32CD, "M", "erg"), + (0x32CE, "M", "ev"), + (0x32CF, "M", "ltd"), + (0x32D0, "M", "ア"), + (0x32D1, "M", "イ"), + (0x32D2, "M", "ウ"), + (0x32D3, "M", "エ"), + (0x32D4, "M", "オ"), + (0x32D5, "M", "カ"), + (0x32D6, "M", "キ"), + (0x32D7, "M", "ク"), + (0x32D8, "M", "ケ"), + (0x32D9, "M", "コ"), + (0x32DA, "M", "サ"), + (0x32DB, "M", "シ"), + (0x32DC, "M", "ス"), + (0x32DD, "M", "セ"), + (0x32DE, "M", "ソ"), + (0x32DF, "M", "タ"), + (0x32E0, "M", "チ"), + (0x32E1, "M", "ツ"), + (0x32E2, "M", "テ"), + (0x32E3, "M", "ト"), + (0x32E4, "M", "ナ"), + (0x32E5, "M", "ニ"), + (0x32E6, "M", "ヌ"), + (0x32E7, "M", "ネ"), + (0x32E8, "M", "ノ"), + (0x32E9, "M", "ハ"), + (0x32EA, "M", "ヒ"), + (0x32EB, "M", "フ"), + (0x32EC, "M", "ヘ"), + (0x32ED, "M", "ホ"), + (0x32EE, "M", "マ"), + (0x32EF, "M", "ミ"), + (0x32F0, "M", "ム"), + (0x32F1, "M", "メ"), + (0x32F2, "M", "モ"), + (0x32F3, "M", "ヤ"), + (0x32F4, "M", "ユ"), + (0x32F5, "M", "ヨ"), + (0x32F6, "M", "ラ"), + (0x32F7, "M", "リ"), + (0x32F8, "M", "ル"), + (0x32F9, "M", "レ"), + (0x32FA, "M", "ロ"), + (0x32FB, "M", "ワ"), + (0x32FC, "M", "ヰ"), + (0x32FD, "M", "ヱ"), + (0x32FE, "M", "ヲ"), + (0x32FF, "M", "令和"), + (0x3300, "M", "アパート"), + (0x3301, "M", "アルファ"), + (0x3302, "M", "アンペア"), + (0x3303, "M", "アール"), + (0x3304, "M", "イニング"), + (0x3305, "M", "インチ"), + (0x3306, "M", "ウォン"), + (0x3307, "M", "エスクード"), + (0x3308, "M", "エーカー"), + (0x3309, "M", "オンス"), + (0x330A, "M", "オーム"), + (0x330B, "M", "カイリ"), + (0x330C, "M", "カラット"), + (0x330D, "M", "カロリー"), + (0x330E, "M", "ガロン"), + (0x330F, "M", "ガンマ"), + (0x3310, "M", "ギガ"), + (0x3311, "M", "ギニー"), + (0x3312, "M", "キュリー"), + (0x3313, "M", "ギルダー"), + (0x3314, "M", "キロ"), + (0x3315, "M", "キログラム"), + (0x3316, "M", "キロメートル"), + (0x3317, "M", "キロワット"), + (0x3318, "M", "グラム"), + (0x3319, "M", "グラムトン"), + ] + + +def _seg_33() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x331A, "M", "クルゼイロ"), + (0x331B, "M", "クローネ"), + (0x331C, "M", "ケース"), + (0x331D, "M", "コルナ"), + (0x331E, "M", "コーポ"), + (0x331F, "M", "サイクル"), + (0x3320, "M", "サンチーム"), + (0x3321, "M", "シリング"), + (0x3322, "M", "センチ"), + (0x3323, "M", "セント"), + (0x3324, "M", "ダース"), + (0x3325, "M", "デシ"), + (0x3326, "M", "ドル"), + (0x3327, "M", "トン"), + (0x3328, "M", "ナノ"), + (0x3329, "M", "ノット"), + (0x332A, "M", "ハイツ"), + (0x332B, "M", "パーセント"), + (0x332C, "M", "パーツ"), + (0x332D, "M", "バーレル"), + (0x332E, "M", "ピアストル"), + (0x332F, "M", "ピクル"), + (0x3330, "M", "ピコ"), + (0x3331, "M", "ビル"), + (0x3332, "M", "ファラッド"), + (0x3333, "M", "フィート"), + (0x3334, "M", "ブッシェル"), + (0x3335, "M", "フラン"), + (0x3336, "M", "ヘクタール"), + (0x3337, "M", "ペソ"), + (0x3338, "M", "ペニヒ"), + (0x3339, "M", "ヘルツ"), + (0x333A, "M", "ペンス"), + (0x333B, "M", "ページ"), + (0x333C, "M", "ベータ"), + (0x333D, "M", "ポイント"), + (0x333E, "M", "ボルト"), + (0x333F, "M", "ホン"), + (0x3340, "M", "ポンド"), + (0x3341, "M", "ホール"), + (0x3342, "M", "ホーン"), + (0x3343, "M", "マイクロ"), + (0x3344, "M", "マイル"), + (0x3345, "M", "マッハ"), + (0x3346, "M", "マルク"), + (0x3347, "M", "マンション"), + (0x3348, "M", "ミクロン"), + (0x3349, "M", "ミリ"), + (0x334A, "M", "ミリバール"), + (0x334B, "M", "メガ"), + (0x334C, "M", "メガトン"), + (0x334D, "M", "メートル"), + (0x334E, "M", "ヤード"), + (0x334F, "M", "ヤール"), + (0x3350, "M", "ユアン"), + (0x3351, "M", "リットル"), + (0x3352, "M", "リラ"), + (0x3353, "M", "ルピー"), + (0x3354, "M", "ルーブル"), + (0x3355, "M", "レム"), + (0x3356, "M", "レントゲン"), + (0x3357, "M", "ワット"), + (0x3358, "M", "0点"), + (0x3359, "M", "1点"), + (0x335A, "M", "2点"), + (0x335B, "M", "3点"), + (0x335C, "M", "4点"), + (0x335D, "M", "5点"), + (0x335E, "M", "6点"), + (0x335F, "M", "7点"), + (0x3360, "M", "8点"), + (0x3361, "M", "9点"), + (0x3362, "M", "10点"), + (0x3363, "M", "11点"), + (0x3364, "M", "12点"), + (0x3365, "M", "13点"), + (0x3366, "M", "14点"), + (0x3367, "M", "15点"), + (0x3368, "M", "16点"), + (0x3369, "M", "17点"), + (0x336A, "M", "18点"), + (0x336B, "M", "19点"), + (0x336C, "M", "20点"), + (0x336D, "M", "21点"), + (0x336E, "M", "22点"), + (0x336F, "M", "23点"), + (0x3370, "M", "24点"), + (0x3371, "M", "hpa"), + (0x3372, "M", "da"), + (0x3373, "M", "au"), + (0x3374, "M", "bar"), + (0x3375, "M", "ov"), + (0x3376, "M", "pc"), + (0x3377, "M", "dm"), + (0x3378, "M", "dm2"), + (0x3379, "M", "dm3"), + (0x337A, "M", "iu"), + (0x337B, "M", "平成"), + (0x337C, "M", "昭和"), + (0x337D, "M", "大正"), + ] + + +def _seg_34() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x337E, "M", "明治"), + (0x337F, "M", "株式会社"), + (0x3380, "M", "pa"), + (0x3381, "M", "na"), + (0x3382, "M", "μa"), + (0x3383, "M", "ma"), + (0x3384, "M", "ka"), + (0x3385, "M", "kb"), + (0x3386, "M", "mb"), + (0x3387, "M", "gb"), + (0x3388, "M", "cal"), + (0x3389, "M", "kcal"), + (0x338A, "M", "pf"), + (0x338B, "M", "nf"), + (0x338C, "M", "μf"), + (0x338D, "M", "μg"), + (0x338E, "M", "mg"), + (0x338F, "M", "kg"), + (0x3390, "M", "hz"), + (0x3391, "M", "khz"), + (0x3392, "M", "mhz"), + (0x3393, "M", "ghz"), + (0x3394, "M", "thz"), + (0x3395, "M", "μl"), + (0x3396, "M", "ml"), + (0x3397, "M", "dl"), + (0x3398, "M", "kl"), + (0x3399, "M", "fm"), + (0x339A, "M", "nm"), + (0x339B, "M", "μm"), + (0x339C, "M", "mm"), + (0x339D, "M", "cm"), + (0x339E, "M", "km"), + (0x339F, "M", "mm2"), + (0x33A0, "M", "cm2"), + (0x33A1, "M", "m2"), + (0x33A2, "M", "km2"), + (0x33A3, "M", "mm3"), + (0x33A4, "M", "cm3"), + (0x33A5, "M", "m3"), + (0x33A6, "M", "km3"), + (0x33A7, "M", "m∕s"), + (0x33A8, "M", "m∕s2"), + (0x33A9, "M", "pa"), + (0x33AA, "M", "kpa"), + (0x33AB, "M", "mpa"), + (0x33AC, "M", "gpa"), + (0x33AD, "M", "rad"), + (0x33AE, "M", "rad∕s"), + (0x33AF, "M", "rad∕s2"), + (0x33B0, "M", "ps"), + (0x33B1, "M", "ns"), + (0x33B2, "M", "μs"), + (0x33B3, "M", "ms"), + (0x33B4, "M", "pv"), + (0x33B5, "M", "nv"), + (0x33B6, "M", "μv"), + (0x33B7, "M", "mv"), + (0x33B8, "M", "kv"), + (0x33B9, "M", "mv"), + (0x33BA, "M", "pw"), + (0x33BB, "M", "nw"), + (0x33BC, "M", "μw"), + (0x33BD, "M", "mw"), + (0x33BE, "M", "kw"), + (0x33BF, "M", "mw"), + (0x33C0, "M", "kω"), + (0x33C1, "M", "mω"), + (0x33C2, "X"), + (0x33C3, "M", "bq"), + (0x33C4, "M", "cc"), + (0x33C5, "M", "cd"), + (0x33C6, "M", "c∕kg"), + (0x33C7, "X"), + (0x33C8, "M", "db"), + (0x33C9, "M", "gy"), + (0x33CA, "M", "ha"), + (0x33CB, "M", "hp"), + (0x33CC, "M", "in"), + (0x33CD, "M", "kk"), + (0x33CE, "M", "km"), + (0x33CF, "M", "kt"), + (0x33D0, "M", "lm"), + (0x33D1, "M", "ln"), + (0x33D2, "M", "log"), + (0x33D3, "M", "lx"), + (0x33D4, "M", "mb"), + (0x33D5, "M", "mil"), + (0x33D6, "M", "mol"), + (0x33D7, "M", "ph"), + (0x33D8, "X"), + (0x33D9, "M", "ppm"), + (0x33DA, "M", "pr"), + (0x33DB, "M", "sr"), + (0x33DC, "M", "sv"), + (0x33DD, "M", "wb"), + (0x33DE, "M", "v∕m"), + (0x33DF, "M", "a∕m"), + (0x33E0, "M", "1日"), + (0x33E1, "M", "2日"), + ] + + +def _seg_35() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x33E2, "M", "3日"), + (0x33E3, "M", "4日"), + (0x33E4, "M", "5日"), + (0x33E5, "M", "6日"), + (0x33E6, "M", "7日"), + (0x33E7, "M", "8日"), + (0x33E8, "M", "9日"), + (0x33E9, "M", "10日"), + (0x33EA, "M", "11日"), + (0x33EB, "M", "12日"), + (0x33EC, "M", "13日"), + (0x33ED, "M", "14日"), + (0x33EE, "M", "15日"), + (0x33EF, "M", "16日"), + (0x33F0, "M", "17日"), + (0x33F1, "M", "18日"), + (0x33F2, "M", "19日"), + (0x33F3, "M", "20日"), + (0x33F4, "M", "21日"), + (0x33F5, "M", "22日"), + (0x33F6, "M", "23日"), + (0x33F7, "M", "24日"), + (0x33F8, "M", "25日"), + (0x33F9, "M", "26日"), + (0x33FA, "M", "27日"), + (0x33FB, "M", "28日"), + (0x33FC, "M", "29日"), + (0x33FD, "M", "30日"), + (0x33FE, "M", "31日"), + (0x33FF, "M", "gal"), + (0x3400, "V"), + (0xA48D, "X"), + (0xA490, "V"), + (0xA4C7, "X"), + (0xA4D0, "V"), + (0xA62C, "X"), + (0xA640, "M", "ꙁ"), + (0xA641, "V"), + (0xA642, "M", "ꙃ"), + (0xA643, "V"), + (0xA644, "M", "ꙅ"), + (0xA645, "V"), + (0xA646, "M", "ꙇ"), + (0xA647, "V"), + (0xA648, "M", "ꙉ"), + (0xA649, "V"), + (0xA64A, "M", "ꙋ"), + (0xA64B, "V"), + (0xA64C, "M", "ꙍ"), + (0xA64D, "V"), + (0xA64E, "M", "ꙏ"), + (0xA64F, "V"), + (0xA650, "M", "ꙑ"), + (0xA651, "V"), + (0xA652, "M", "ꙓ"), + (0xA653, "V"), + (0xA654, "M", "ꙕ"), + (0xA655, "V"), + (0xA656, "M", "ꙗ"), + (0xA657, "V"), + (0xA658, "M", "ꙙ"), + (0xA659, "V"), + (0xA65A, "M", "ꙛ"), + (0xA65B, "V"), + (0xA65C, "M", "ꙝ"), + (0xA65D, "V"), + (0xA65E, "M", "ꙟ"), + (0xA65F, "V"), + (0xA660, "M", "ꙡ"), + (0xA661, "V"), + (0xA662, "M", "ꙣ"), + (0xA663, "V"), + (0xA664, "M", "ꙥ"), + (0xA665, "V"), + (0xA666, "M", "ꙧ"), + (0xA667, "V"), + (0xA668, "M", "ꙩ"), + (0xA669, "V"), + (0xA66A, "M", "ꙫ"), + (0xA66B, "V"), + (0xA66C, "M", "ꙭ"), + (0xA66D, "V"), + (0xA680, "M", "ꚁ"), + (0xA681, "V"), + (0xA682, "M", "ꚃ"), + (0xA683, "V"), + (0xA684, "M", "ꚅ"), + (0xA685, "V"), + (0xA686, "M", "ꚇ"), + (0xA687, "V"), + (0xA688, "M", "ꚉ"), + (0xA689, "V"), + (0xA68A, "M", "ꚋ"), + (0xA68B, "V"), + (0xA68C, "M", "ꚍ"), + (0xA68D, "V"), + (0xA68E, "M", "ꚏ"), + (0xA68F, "V"), + (0xA690, "M", "ꚑ"), + (0xA691, "V"), + ] + + +def _seg_36() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0xA692, "M", "ꚓ"), + (0xA693, "V"), + (0xA694, "M", "ꚕ"), + (0xA695, "V"), + (0xA696, "M", "ꚗ"), + (0xA697, "V"), + (0xA698, "M", "ꚙ"), + (0xA699, "V"), + (0xA69A, "M", "ꚛ"), + (0xA69B, "V"), + (0xA69C, "M", "ъ"), + (0xA69D, "M", "ь"), + (0xA69E, "V"), + (0xA6F8, "X"), + (0xA700, "V"), + (0xA722, "M", "ꜣ"), + (0xA723, "V"), + (0xA724, "M", "ꜥ"), + (0xA725, "V"), + (0xA726, "M", "ꜧ"), + (0xA727, "V"), + (0xA728, "M", "ꜩ"), + (0xA729, "V"), + (0xA72A, "M", "ꜫ"), + (0xA72B, "V"), + (0xA72C, "M", "ꜭ"), + (0xA72D, "V"), + (0xA72E, "M", "ꜯ"), + (0xA72F, "V"), + (0xA732, "M", "ꜳ"), + (0xA733, "V"), + (0xA734, "M", "ꜵ"), + (0xA735, "V"), + (0xA736, "M", "ꜷ"), + (0xA737, "V"), + (0xA738, "M", "ꜹ"), + (0xA739, "V"), + (0xA73A, "M", "ꜻ"), + (0xA73B, "V"), + (0xA73C, "M", "ꜽ"), + (0xA73D, "V"), + (0xA73E, "M", "ꜿ"), + (0xA73F, "V"), + (0xA740, "M", "ꝁ"), + (0xA741, "V"), + (0xA742, "M", "ꝃ"), + (0xA743, "V"), + (0xA744, "M", "ꝅ"), + (0xA745, "V"), + (0xA746, "M", "ꝇ"), + (0xA747, "V"), + (0xA748, "M", "ꝉ"), + (0xA749, "V"), + (0xA74A, "M", "ꝋ"), + (0xA74B, "V"), + (0xA74C, "M", "ꝍ"), + (0xA74D, "V"), + (0xA74E, "M", "ꝏ"), + (0xA74F, "V"), + (0xA750, "M", "ꝑ"), + (0xA751, "V"), + (0xA752, "M", "ꝓ"), + (0xA753, "V"), + (0xA754, "M", "ꝕ"), + (0xA755, "V"), + (0xA756, "M", "ꝗ"), + (0xA757, "V"), + (0xA758, "M", "ꝙ"), + (0xA759, "V"), + (0xA75A, "M", "ꝛ"), + (0xA75B, "V"), + (0xA75C, "M", "ꝝ"), + (0xA75D, "V"), + (0xA75E, "M", "ꝟ"), + (0xA75F, "V"), + (0xA760, "M", "ꝡ"), + (0xA761, "V"), + (0xA762, "M", "ꝣ"), + (0xA763, "V"), + (0xA764, "M", "ꝥ"), + (0xA765, "V"), + (0xA766, "M", "ꝧ"), + (0xA767, "V"), + (0xA768, "M", "ꝩ"), + (0xA769, "V"), + (0xA76A, "M", "ꝫ"), + (0xA76B, "V"), + (0xA76C, "M", "ꝭ"), + (0xA76D, "V"), + (0xA76E, "M", "ꝯ"), + (0xA76F, "V"), + (0xA770, "M", "ꝯ"), + (0xA771, "V"), + (0xA779, "M", "ꝺ"), + (0xA77A, "V"), + (0xA77B, "M", "ꝼ"), + (0xA77C, "V"), + (0xA77D, "M", "ᵹ"), + (0xA77E, "M", "ꝿ"), + (0xA77F, "V"), + ] + + +def _seg_37() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0xA780, "M", "ꞁ"), + (0xA781, "V"), + (0xA782, "M", "ꞃ"), + (0xA783, "V"), + (0xA784, "M", "ꞅ"), + (0xA785, "V"), + (0xA786, "M", "ꞇ"), + (0xA787, "V"), + (0xA78B, "M", "ꞌ"), + (0xA78C, "V"), + (0xA78D, "M", "ɥ"), + (0xA78E, "V"), + (0xA790, "M", "ꞑ"), + (0xA791, "V"), + (0xA792, "M", "ꞓ"), + (0xA793, "V"), + (0xA796, "M", "ꞗ"), + (0xA797, "V"), + (0xA798, "M", "ꞙ"), + (0xA799, "V"), + (0xA79A, "M", "ꞛ"), + (0xA79B, "V"), + (0xA79C, "M", "ꞝ"), + (0xA79D, "V"), + (0xA79E, "M", "ꞟ"), + (0xA79F, "V"), + (0xA7A0, "M", "ꞡ"), + (0xA7A1, "V"), + (0xA7A2, "M", "ꞣ"), + (0xA7A3, "V"), + (0xA7A4, "M", "ꞥ"), + (0xA7A5, "V"), + (0xA7A6, "M", "ꞧ"), + (0xA7A7, "V"), + (0xA7A8, "M", "ꞩ"), + (0xA7A9, "V"), + (0xA7AA, "M", "ɦ"), + (0xA7AB, "M", "ɜ"), + (0xA7AC, "M", "ɡ"), + (0xA7AD, "M", "ɬ"), + (0xA7AE, "M", "ɪ"), + (0xA7AF, "V"), + (0xA7B0, "M", "ʞ"), + (0xA7B1, "M", "ʇ"), + (0xA7B2, "M", "ʝ"), + (0xA7B3, "M", "ꭓ"), + (0xA7B4, "M", "ꞵ"), + (0xA7B5, "V"), + (0xA7B6, "M", "ꞷ"), + (0xA7B7, "V"), + (0xA7B8, "M", "ꞹ"), + (0xA7B9, "V"), + (0xA7BA, "M", "ꞻ"), + (0xA7BB, "V"), + (0xA7BC, "M", "ꞽ"), + (0xA7BD, "V"), + (0xA7BE, "M", "ꞿ"), + (0xA7BF, "V"), + (0xA7C0, "M", "ꟁ"), + (0xA7C1, "V"), + (0xA7C2, "M", "ꟃ"), + (0xA7C3, "V"), + (0xA7C4, "M", "ꞔ"), + (0xA7C5, "M", "ʂ"), + (0xA7C6, "M", "ᶎ"), + (0xA7C7, "M", "ꟈ"), + (0xA7C8, "V"), + (0xA7C9, "M", "ꟊ"), + (0xA7CA, "V"), + (0xA7CB, "X"), + (0xA7D0, "M", "ꟑ"), + (0xA7D1, "V"), + (0xA7D2, "X"), + (0xA7D3, "V"), + (0xA7D4, "X"), + (0xA7D5, "V"), + (0xA7D6, "M", "ꟗ"), + (0xA7D7, "V"), + (0xA7D8, "M", "ꟙ"), + (0xA7D9, "V"), + (0xA7DA, "X"), + (0xA7F2, "M", "c"), + (0xA7F3, "M", "f"), + (0xA7F4, "M", "q"), + (0xA7F5, "M", "ꟶ"), + (0xA7F6, "V"), + (0xA7F8, "M", "ħ"), + (0xA7F9, "M", "œ"), + (0xA7FA, "V"), + (0xA82D, "X"), + (0xA830, "V"), + (0xA83A, "X"), + (0xA840, "V"), + (0xA878, "X"), + (0xA880, "V"), + (0xA8C6, "X"), + (0xA8CE, "V"), + (0xA8DA, "X"), + (0xA8E0, "V"), + (0xA954, "X"), + ] + + +def _seg_38() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0xA95F, "V"), + (0xA97D, "X"), + (0xA980, "V"), + (0xA9CE, "X"), + (0xA9CF, "V"), + (0xA9DA, "X"), + (0xA9DE, "V"), + (0xA9FF, "X"), + (0xAA00, "V"), + (0xAA37, "X"), + (0xAA40, "V"), + (0xAA4E, "X"), + (0xAA50, "V"), + (0xAA5A, "X"), + (0xAA5C, "V"), + (0xAAC3, "X"), + (0xAADB, "V"), + (0xAAF7, "X"), + (0xAB01, "V"), + (0xAB07, "X"), + (0xAB09, "V"), + (0xAB0F, "X"), + (0xAB11, "V"), + (0xAB17, "X"), + (0xAB20, "V"), + (0xAB27, "X"), + (0xAB28, "V"), + (0xAB2F, "X"), + (0xAB30, "V"), + (0xAB5C, "M", "ꜧ"), + (0xAB5D, "M", "ꬷ"), + (0xAB5E, "M", "ɫ"), + (0xAB5F, "M", "ꭒ"), + (0xAB60, "V"), + (0xAB69, "M", "ʍ"), + (0xAB6A, "V"), + (0xAB6C, "X"), + (0xAB70, "M", "Ꭰ"), + (0xAB71, "M", "Ꭱ"), + (0xAB72, "M", "Ꭲ"), + (0xAB73, "M", "Ꭳ"), + (0xAB74, "M", "Ꭴ"), + (0xAB75, "M", "Ꭵ"), + (0xAB76, "M", "Ꭶ"), + (0xAB77, "M", "Ꭷ"), + (0xAB78, "M", "Ꭸ"), + (0xAB79, "M", "Ꭹ"), + (0xAB7A, "M", "Ꭺ"), + (0xAB7B, "M", "Ꭻ"), + (0xAB7C, "M", "Ꭼ"), + (0xAB7D, "M", "Ꭽ"), + (0xAB7E, "M", "Ꭾ"), + (0xAB7F, "M", "Ꭿ"), + (0xAB80, "M", "Ꮀ"), + (0xAB81, "M", "Ꮁ"), + (0xAB82, "M", "Ꮂ"), + (0xAB83, "M", "Ꮃ"), + (0xAB84, "M", "Ꮄ"), + (0xAB85, "M", "Ꮅ"), + (0xAB86, "M", "Ꮆ"), + (0xAB87, "M", "Ꮇ"), + (0xAB88, "M", "Ꮈ"), + (0xAB89, "M", "Ꮉ"), + (0xAB8A, "M", "Ꮊ"), + (0xAB8B, "M", "Ꮋ"), + (0xAB8C, "M", "Ꮌ"), + (0xAB8D, "M", "Ꮍ"), + (0xAB8E, "M", "Ꮎ"), + (0xAB8F, "M", "Ꮏ"), + (0xAB90, "M", "Ꮐ"), + (0xAB91, "M", "Ꮑ"), + (0xAB92, "M", "Ꮒ"), + (0xAB93, "M", "Ꮓ"), + (0xAB94, "M", "Ꮔ"), + (0xAB95, "M", "Ꮕ"), + (0xAB96, "M", "Ꮖ"), + (0xAB97, "M", "Ꮗ"), + (0xAB98, "M", "Ꮘ"), + (0xAB99, "M", "Ꮙ"), + (0xAB9A, "M", "Ꮚ"), + (0xAB9B, "M", "Ꮛ"), + (0xAB9C, "M", "Ꮜ"), + (0xAB9D, "M", "Ꮝ"), + (0xAB9E, "M", "Ꮞ"), + (0xAB9F, "M", "Ꮟ"), + (0xABA0, "M", "Ꮠ"), + (0xABA1, "M", "Ꮡ"), + (0xABA2, "M", "Ꮢ"), + (0xABA3, "M", "Ꮣ"), + (0xABA4, "M", "Ꮤ"), + (0xABA5, "M", "Ꮥ"), + (0xABA6, "M", "Ꮦ"), + (0xABA7, "M", "Ꮧ"), + (0xABA8, "M", "Ꮨ"), + (0xABA9, "M", "Ꮩ"), + (0xABAA, "M", "Ꮪ"), + (0xABAB, "M", "Ꮫ"), + (0xABAC, "M", "Ꮬ"), + (0xABAD, "M", "Ꮭ"), + (0xABAE, "M", "Ꮮ"), + ] + + +def _seg_39() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0xABAF, "M", "Ꮯ"), + (0xABB0, "M", "Ꮰ"), + (0xABB1, "M", "Ꮱ"), + (0xABB2, "M", "Ꮲ"), + (0xABB3, "M", "Ꮳ"), + (0xABB4, "M", "Ꮴ"), + (0xABB5, "M", "Ꮵ"), + (0xABB6, "M", "Ꮶ"), + (0xABB7, "M", "Ꮷ"), + (0xABB8, "M", "Ꮸ"), + (0xABB9, "M", "Ꮹ"), + (0xABBA, "M", "Ꮺ"), + (0xABBB, "M", "Ꮻ"), + (0xABBC, "M", "Ꮼ"), + (0xABBD, "M", "Ꮽ"), + (0xABBE, "M", "Ꮾ"), + (0xABBF, "M", "Ꮿ"), + (0xABC0, "V"), + (0xABEE, "X"), + (0xABF0, "V"), + (0xABFA, "X"), + (0xAC00, "V"), + (0xD7A4, "X"), + (0xD7B0, "V"), + (0xD7C7, "X"), + (0xD7CB, "V"), + (0xD7FC, "X"), + (0xF900, "M", "豈"), + (0xF901, "M", "更"), + (0xF902, "M", "車"), + (0xF903, "M", "賈"), + (0xF904, "M", "滑"), + (0xF905, "M", "串"), + (0xF906, "M", "句"), + (0xF907, "M", "龜"), + (0xF909, "M", "契"), + (0xF90A, "M", "金"), + (0xF90B, "M", "喇"), + (0xF90C, "M", "奈"), + (0xF90D, "M", "懶"), + (0xF90E, "M", "癩"), + (0xF90F, "M", "羅"), + (0xF910, "M", "蘿"), + (0xF911, "M", "螺"), + (0xF912, "M", "裸"), + (0xF913, "M", "邏"), + (0xF914, "M", "樂"), + (0xF915, "M", "洛"), + (0xF916, "M", "烙"), + (0xF917, "M", "珞"), + (0xF918, "M", "落"), + (0xF919, "M", "酪"), + (0xF91A, "M", "駱"), + (0xF91B, "M", "亂"), + (0xF91C, "M", "卵"), + (0xF91D, "M", "欄"), + (0xF91E, "M", "爛"), + (0xF91F, "M", "蘭"), + (0xF920, "M", "鸞"), + (0xF921, "M", "嵐"), + (0xF922, "M", "濫"), + (0xF923, "M", "藍"), + (0xF924, "M", "襤"), + (0xF925, "M", "拉"), + (0xF926, "M", "臘"), + (0xF927, "M", "蠟"), + (0xF928, "M", "廊"), + (0xF929, "M", "朗"), + (0xF92A, "M", "浪"), + (0xF92B, "M", "狼"), + (0xF92C, "M", "郎"), + (0xF92D, "M", "來"), + (0xF92E, "M", "冷"), + (0xF92F, "M", "勞"), + (0xF930, "M", "擄"), + (0xF931, "M", "櫓"), + (0xF932, "M", "爐"), + (0xF933, "M", "盧"), + (0xF934, "M", "老"), + (0xF935, "M", "蘆"), + (0xF936, "M", "虜"), + (0xF937, "M", "路"), + (0xF938, "M", "露"), + (0xF939, "M", "魯"), + (0xF93A, "M", "鷺"), + (0xF93B, "M", "碌"), + (0xF93C, "M", "祿"), + (0xF93D, "M", "綠"), + (0xF93E, "M", "菉"), + (0xF93F, "M", "錄"), + (0xF940, "M", "鹿"), + (0xF941, "M", "論"), + (0xF942, "M", "壟"), + (0xF943, "M", "弄"), + (0xF944, "M", "籠"), + (0xF945, "M", "聾"), + (0xF946, "M", "牢"), + (0xF947, "M", "磊"), + (0xF948, "M", "賂"), + (0xF949, "M", "雷"), + ] + + +def _seg_40() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0xF94A, "M", "壘"), + (0xF94B, "M", "屢"), + (0xF94C, "M", "樓"), + (0xF94D, "M", "淚"), + (0xF94E, "M", "漏"), + (0xF94F, "M", "累"), + (0xF950, "M", "縷"), + (0xF951, "M", "陋"), + (0xF952, "M", "勒"), + (0xF953, "M", "肋"), + (0xF954, "M", "凜"), + (0xF955, "M", "凌"), + (0xF956, "M", "稜"), + (0xF957, "M", "綾"), + (0xF958, "M", "菱"), + (0xF959, "M", "陵"), + (0xF95A, "M", "讀"), + (0xF95B, "M", "拏"), + (0xF95C, "M", "樂"), + (0xF95D, "M", "諾"), + (0xF95E, "M", "丹"), + (0xF95F, "M", "寧"), + (0xF960, "M", "怒"), + (0xF961, "M", "率"), + (0xF962, "M", "異"), + (0xF963, "M", "北"), + (0xF964, "M", "磻"), + (0xF965, "M", "便"), + (0xF966, "M", "復"), + (0xF967, "M", "不"), + (0xF968, "M", "泌"), + (0xF969, "M", "數"), + (0xF96A, "M", "索"), + (0xF96B, "M", "參"), + (0xF96C, "M", "塞"), + (0xF96D, "M", "省"), + (0xF96E, "M", "葉"), + (0xF96F, "M", "說"), + (0xF970, "M", "殺"), + (0xF971, "M", "辰"), + (0xF972, "M", "沈"), + (0xF973, "M", "拾"), + (0xF974, "M", "若"), + (0xF975, "M", "掠"), + (0xF976, "M", "略"), + (0xF977, "M", "亮"), + (0xF978, "M", "兩"), + (0xF979, "M", "凉"), + (0xF97A, "M", "梁"), + (0xF97B, "M", "糧"), + (0xF97C, "M", "良"), + (0xF97D, "M", "諒"), + (0xF97E, "M", "量"), + (0xF97F, "M", "勵"), + (0xF980, "M", "呂"), + (0xF981, "M", "女"), + (0xF982, "M", "廬"), + (0xF983, "M", "旅"), + (0xF984, "M", "濾"), + (0xF985, "M", "礪"), + (0xF986, "M", "閭"), + (0xF987, "M", "驪"), + (0xF988, "M", "麗"), + (0xF989, "M", "黎"), + (0xF98A, "M", "力"), + (0xF98B, "M", "曆"), + (0xF98C, "M", "歷"), + (0xF98D, "M", "轢"), + (0xF98E, "M", "年"), + (0xF98F, "M", "憐"), + (0xF990, "M", "戀"), + (0xF991, "M", "撚"), + (0xF992, "M", "漣"), + (0xF993, "M", "煉"), + (0xF994, "M", "璉"), + (0xF995, "M", "秊"), + (0xF996, "M", "練"), + (0xF997, "M", "聯"), + (0xF998, "M", "輦"), + (0xF999, "M", "蓮"), + (0xF99A, "M", "連"), + (0xF99B, "M", "鍊"), + (0xF99C, "M", "列"), + (0xF99D, "M", "劣"), + (0xF99E, "M", "咽"), + (0xF99F, "M", "烈"), + (0xF9A0, "M", "裂"), + (0xF9A1, "M", "說"), + (0xF9A2, "M", "廉"), + (0xF9A3, "M", "念"), + (0xF9A4, "M", "捻"), + (0xF9A5, "M", "殮"), + (0xF9A6, "M", "簾"), + (0xF9A7, "M", "獵"), + (0xF9A8, "M", "令"), + (0xF9A9, "M", "囹"), + (0xF9AA, "M", "寧"), + (0xF9AB, "M", "嶺"), + (0xF9AC, "M", "怜"), + (0xF9AD, "M", "玲"), + ] + + +def _seg_41() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0xF9AE, "M", "瑩"), + (0xF9AF, "M", "羚"), + (0xF9B0, "M", "聆"), + (0xF9B1, "M", "鈴"), + (0xF9B2, "M", "零"), + (0xF9B3, "M", "靈"), + (0xF9B4, "M", "領"), + (0xF9B5, "M", "例"), + (0xF9B6, "M", "禮"), + (0xF9B7, "M", "醴"), + (0xF9B8, "M", "隸"), + (0xF9B9, "M", "惡"), + (0xF9BA, "M", "了"), + (0xF9BB, "M", "僚"), + (0xF9BC, "M", "寮"), + (0xF9BD, "M", "尿"), + (0xF9BE, "M", "料"), + (0xF9BF, "M", "樂"), + (0xF9C0, "M", "燎"), + (0xF9C1, "M", "療"), + (0xF9C2, "M", "蓼"), + (0xF9C3, "M", "遼"), + (0xF9C4, "M", "龍"), + (0xF9C5, "M", "暈"), + (0xF9C6, "M", "阮"), + (0xF9C7, "M", "劉"), + (0xF9C8, "M", "杻"), + (0xF9C9, "M", "柳"), + (0xF9CA, "M", "流"), + (0xF9CB, "M", "溜"), + (0xF9CC, "M", "琉"), + (0xF9CD, "M", "留"), + (0xF9CE, "M", "硫"), + (0xF9CF, "M", "紐"), + (0xF9D0, "M", "類"), + (0xF9D1, "M", "六"), + (0xF9D2, "M", "戮"), + (0xF9D3, "M", "陸"), + (0xF9D4, "M", "倫"), + (0xF9D5, "M", "崙"), + (0xF9D6, "M", "淪"), + (0xF9D7, "M", "輪"), + (0xF9D8, "M", "律"), + (0xF9D9, "M", "慄"), + (0xF9DA, "M", "栗"), + (0xF9DB, "M", "率"), + (0xF9DC, "M", "隆"), + (0xF9DD, "M", "利"), + (0xF9DE, "M", "吏"), + (0xF9DF, "M", "履"), + (0xF9E0, "M", "易"), + (0xF9E1, "M", "李"), + (0xF9E2, "M", "梨"), + (0xF9E3, "M", "泥"), + (0xF9E4, "M", "理"), + (0xF9E5, "M", "痢"), + (0xF9E6, "M", "罹"), + (0xF9E7, "M", "裏"), + (0xF9E8, "M", "裡"), + (0xF9E9, "M", "里"), + (0xF9EA, "M", "離"), + (0xF9EB, "M", "匿"), + (0xF9EC, "M", "溺"), + (0xF9ED, "M", "吝"), + (0xF9EE, "M", "燐"), + (0xF9EF, "M", "璘"), + (0xF9F0, "M", "藺"), + (0xF9F1, "M", "隣"), + (0xF9F2, "M", "鱗"), + (0xF9F3, "M", "麟"), + (0xF9F4, "M", "林"), + (0xF9F5, "M", "淋"), + (0xF9F6, "M", "臨"), + (0xF9F7, "M", "立"), + (0xF9F8, "M", "笠"), + (0xF9F9, "M", "粒"), + (0xF9FA, "M", "狀"), + (0xF9FB, "M", "炙"), + (0xF9FC, "M", "識"), + (0xF9FD, "M", "什"), + (0xF9FE, "M", "茶"), + (0xF9FF, "M", "刺"), + (0xFA00, "M", "切"), + (0xFA01, "M", "度"), + (0xFA02, "M", "拓"), + (0xFA03, "M", "糖"), + (0xFA04, "M", "宅"), + (0xFA05, "M", "洞"), + (0xFA06, "M", "暴"), + (0xFA07, "M", "輻"), + (0xFA08, "M", "行"), + (0xFA09, "M", "降"), + (0xFA0A, "M", "見"), + (0xFA0B, "M", "廓"), + (0xFA0C, "M", "兀"), + (0xFA0D, "M", "嗀"), + (0xFA0E, "V"), + (0xFA10, "M", "塚"), + (0xFA11, "V"), + (0xFA12, "M", "晴"), + ] + + +def _seg_42() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0xFA13, "V"), + (0xFA15, "M", "凞"), + (0xFA16, "M", "猪"), + (0xFA17, "M", "益"), + (0xFA18, "M", "礼"), + (0xFA19, "M", "神"), + (0xFA1A, "M", "祥"), + (0xFA1B, "M", "福"), + (0xFA1C, "M", "靖"), + (0xFA1D, "M", "精"), + (0xFA1E, "M", "羽"), + (0xFA1F, "V"), + (0xFA20, "M", "蘒"), + (0xFA21, "V"), + (0xFA22, "M", "諸"), + (0xFA23, "V"), + (0xFA25, "M", "逸"), + (0xFA26, "M", "都"), + (0xFA27, "V"), + (0xFA2A, "M", "飯"), + (0xFA2B, "M", "飼"), + (0xFA2C, "M", "館"), + (0xFA2D, "M", "鶴"), + (0xFA2E, "M", "郞"), + (0xFA2F, "M", "隷"), + (0xFA30, "M", "侮"), + (0xFA31, "M", "僧"), + (0xFA32, "M", "免"), + (0xFA33, "M", "勉"), + (0xFA34, "M", "勤"), + (0xFA35, "M", "卑"), + (0xFA36, "M", "喝"), + (0xFA37, "M", "嘆"), + (0xFA38, "M", "器"), + (0xFA39, "M", "塀"), + (0xFA3A, "M", "墨"), + (0xFA3B, "M", "層"), + (0xFA3C, "M", "屮"), + (0xFA3D, "M", "悔"), + (0xFA3E, "M", "慨"), + (0xFA3F, "M", "憎"), + (0xFA40, "M", "懲"), + (0xFA41, "M", "敏"), + (0xFA42, "M", "既"), + (0xFA43, "M", "暑"), + (0xFA44, "M", "梅"), + (0xFA45, "M", "海"), + (0xFA46, "M", "渚"), + (0xFA47, "M", "漢"), + (0xFA48, "M", "煮"), + (0xFA49, "M", "爫"), + (0xFA4A, "M", "琢"), + (0xFA4B, "M", "碑"), + (0xFA4C, "M", "社"), + (0xFA4D, "M", "祉"), + (0xFA4E, "M", "祈"), + (0xFA4F, "M", "祐"), + (0xFA50, "M", "祖"), + (0xFA51, "M", "祝"), + (0xFA52, "M", "禍"), + (0xFA53, "M", "禎"), + (0xFA54, "M", "穀"), + (0xFA55, "M", "突"), + (0xFA56, "M", "節"), + (0xFA57, "M", "練"), + (0xFA58, "M", "縉"), + (0xFA59, "M", "繁"), + (0xFA5A, "M", "署"), + (0xFA5B, "M", "者"), + (0xFA5C, "M", "臭"), + (0xFA5D, "M", "艹"), + (0xFA5F, "M", "著"), + (0xFA60, "M", "褐"), + (0xFA61, "M", "視"), + (0xFA62, "M", "謁"), + (0xFA63, "M", "謹"), + (0xFA64, "M", "賓"), + (0xFA65, "M", "贈"), + (0xFA66, "M", "辶"), + (0xFA67, "M", "逸"), + (0xFA68, "M", "難"), + (0xFA69, "M", "響"), + (0xFA6A, "M", "頻"), + (0xFA6B, "M", "恵"), + (0xFA6C, "M", "𤋮"), + (0xFA6D, "M", "舘"), + (0xFA6E, "X"), + (0xFA70, "M", "並"), + (0xFA71, "M", "况"), + (0xFA72, "M", "全"), + (0xFA73, "M", "侀"), + (0xFA74, "M", "充"), + (0xFA75, "M", "冀"), + (0xFA76, "M", "勇"), + (0xFA77, "M", "勺"), + (0xFA78, "M", "喝"), + (0xFA79, "M", "啕"), + (0xFA7A, "M", "喙"), + (0xFA7B, "M", "嗢"), + (0xFA7C, "M", "塚"), + ] + + +def _seg_43() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0xFA7D, "M", "墳"), + (0xFA7E, "M", "奄"), + (0xFA7F, "M", "奔"), + (0xFA80, "M", "婢"), + (0xFA81, "M", "嬨"), + (0xFA82, "M", "廒"), + (0xFA83, "M", "廙"), + (0xFA84, "M", "彩"), + (0xFA85, "M", "徭"), + (0xFA86, "M", "惘"), + (0xFA87, "M", "慎"), + (0xFA88, "M", "愈"), + (0xFA89, "M", "憎"), + (0xFA8A, "M", "慠"), + (0xFA8B, "M", "懲"), + (0xFA8C, "M", "戴"), + (0xFA8D, "M", "揄"), + (0xFA8E, "M", "搜"), + (0xFA8F, "M", "摒"), + (0xFA90, "M", "敖"), + (0xFA91, "M", "晴"), + (0xFA92, "M", "朗"), + (0xFA93, "M", "望"), + (0xFA94, "M", "杖"), + (0xFA95, "M", "歹"), + (0xFA96, "M", "殺"), + (0xFA97, "M", "流"), + (0xFA98, "M", "滛"), + (0xFA99, "M", "滋"), + (0xFA9A, "M", "漢"), + (0xFA9B, "M", "瀞"), + (0xFA9C, "M", "煮"), + (0xFA9D, "M", "瞧"), + (0xFA9E, "M", "爵"), + (0xFA9F, "M", "犯"), + (0xFAA0, "M", "猪"), + (0xFAA1, "M", "瑱"), + (0xFAA2, "M", "甆"), + (0xFAA3, "M", "画"), + (0xFAA4, "M", "瘝"), + (0xFAA5, "M", "瘟"), + (0xFAA6, "M", "益"), + (0xFAA7, "M", "盛"), + (0xFAA8, "M", "直"), + (0xFAA9, "M", "睊"), + (0xFAAA, "M", "着"), + (0xFAAB, "M", "磌"), + (0xFAAC, "M", "窱"), + (0xFAAD, "M", "節"), + (0xFAAE, "M", "类"), + (0xFAAF, "M", "絛"), + (0xFAB0, "M", "練"), + (0xFAB1, "M", "缾"), + (0xFAB2, "M", "者"), + (0xFAB3, "M", "荒"), + (0xFAB4, "M", "華"), + (0xFAB5, "M", "蝹"), + (0xFAB6, "M", "襁"), + (0xFAB7, "M", "覆"), + (0xFAB8, "M", "視"), + (0xFAB9, "M", "調"), + (0xFABA, "M", "諸"), + (0xFABB, "M", "請"), + (0xFABC, "M", "謁"), + (0xFABD, "M", "諾"), + (0xFABE, "M", "諭"), + (0xFABF, "M", "謹"), + (0xFAC0, "M", "變"), + (0xFAC1, "M", "贈"), + (0xFAC2, "M", "輸"), + (0xFAC3, "M", "遲"), + (0xFAC4, "M", "醙"), + (0xFAC5, "M", "鉶"), + (0xFAC6, "M", "陼"), + (0xFAC7, "M", "難"), + (0xFAC8, "M", "靖"), + (0xFAC9, "M", "韛"), + (0xFACA, "M", "響"), + (0xFACB, "M", "頋"), + (0xFACC, "M", "頻"), + (0xFACD, "M", "鬒"), + (0xFACE, "M", "龜"), + (0xFACF, "M", "𢡊"), + (0xFAD0, "M", "𢡄"), + (0xFAD1, "M", "𣏕"), + (0xFAD2, "M", "㮝"), + (0xFAD3, "M", "䀘"), + (0xFAD4, "M", "䀹"), + (0xFAD5, "M", "𥉉"), + (0xFAD6, "M", "𥳐"), + (0xFAD7, "M", "𧻓"), + (0xFAD8, "M", "齃"), + (0xFAD9, "M", "龎"), + (0xFADA, "X"), + (0xFB00, "M", "ff"), + (0xFB01, "M", "fi"), + (0xFB02, "M", "fl"), + (0xFB03, "M", "ffi"), + (0xFB04, "M", "ffl"), + (0xFB05, "M", "st"), + ] + + +def _seg_44() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0xFB07, "X"), + (0xFB13, "M", "մն"), + (0xFB14, "M", "մե"), + (0xFB15, "M", "մի"), + (0xFB16, "M", "վն"), + (0xFB17, "M", "մխ"), + (0xFB18, "X"), + (0xFB1D, "M", "יִ"), + (0xFB1E, "V"), + (0xFB1F, "M", "ײַ"), + (0xFB20, "M", "ע"), + (0xFB21, "M", "א"), + (0xFB22, "M", "ד"), + (0xFB23, "M", "ה"), + (0xFB24, "M", "כ"), + (0xFB25, "M", "ל"), + (0xFB26, "M", "ם"), + (0xFB27, "M", "ר"), + (0xFB28, "M", "ת"), + (0xFB29, "3", "+"), + (0xFB2A, "M", "שׁ"), + (0xFB2B, "M", "שׂ"), + (0xFB2C, "M", "שּׁ"), + (0xFB2D, "M", "שּׂ"), + (0xFB2E, "M", "אַ"), + (0xFB2F, "M", "אָ"), + (0xFB30, "M", "אּ"), + (0xFB31, "M", "בּ"), + (0xFB32, "M", "גּ"), + (0xFB33, "M", "דּ"), + (0xFB34, "M", "הּ"), + (0xFB35, "M", "וּ"), + (0xFB36, "M", "זּ"), + (0xFB37, "X"), + (0xFB38, "M", "טּ"), + (0xFB39, "M", "יּ"), + (0xFB3A, "M", "ךּ"), + (0xFB3B, "M", "כּ"), + (0xFB3C, "M", "לּ"), + (0xFB3D, "X"), + (0xFB3E, "M", "מּ"), + (0xFB3F, "X"), + (0xFB40, "M", "נּ"), + (0xFB41, "M", "סּ"), + (0xFB42, "X"), + (0xFB43, "M", "ףּ"), + (0xFB44, "M", "פּ"), + (0xFB45, "X"), + (0xFB46, "M", "צּ"), + (0xFB47, "M", "קּ"), + (0xFB48, "M", "רּ"), + (0xFB49, "M", "שּ"), + (0xFB4A, "M", "תּ"), + (0xFB4B, "M", "וֹ"), + (0xFB4C, "M", "בֿ"), + (0xFB4D, "M", "כֿ"), + (0xFB4E, "M", "פֿ"), + (0xFB4F, "M", "אל"), + (0xFB50, "M", "ٱ"), + (0xFB52, "M", "ٻ"), + (0xFB56, "M", "پ"), + (0xFB5A, "M", "ڀ"), + (0xFB5E, "M", "ٺ"), + (0xFB62, "M", "ٿ"), + (0xFB66, "M", "ٹ"), + (0xFB6A, "M", "ڤ"), + (0xFB6E, "M", "ڦ"), + (0xFB72, "M", "ڄ"), + (0xFB76, "M", "ڃ"), + (0xFB7A, "M", "چ"), + (0xFB7E, "M", "ڇ"), + (0xFB82, "M", "ڍ"), + (0xFB84, "M", "ڌ"), + (0xFB86, "M", "ڎ"), + (0xFB88, "M", "ڈ"), + (0xFB8A, "M", "ژ"), + (0xFB8C, "M", "ڑ"), + (0xFB8E, "M", "ک"), + (0xFB92, "M", "گ"), + (0xFB96, "M", "ڳ"), + (0xFB9A, "M", "ڱ"), + (0xFB9E, "M", "ں"), + (0xFBA0, "M", "ڻ"), + (0xFBA4, "M", "ۀ"), + (0xFBA6, "M", "ہ"), + (0xFBAA, "M", "ھ"), + (0xFBAE, "M", "ے"), + (0xFBB0, "M", "ۓ"), + (0xFBB2, "V"), + (0xFBC3, "X"), + (0xFBD3, "M", "ڭ"), + (0xFBD7, "M", "ۇ"), + (0xFBD9, "M", "ۆ"), + (0xFBDB, "M", "ۈ"), + (0xFBDD, "M", "ۇٴ"), + (0xFBDE, "M", "ۋ"), + (0xFBE0, "M", "ۅ"), + (0xFBE2, "M", "ۉ"), + (0xFBE4, "M", "ې"), + (0xFBE8, "M", "ى"), + ] + + +def _seg_45() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0xFBEA, "M", "ئا"), + (0xFBEC, "M", "ئە"), + (0xFBEE, "M", "ئو"), + (0xFBF0, "M", "ئۇ"), + (0xFBF2, "M", "ئۆ"), + (0xFBF4, "M", "ئۈ"), + (0xFBF6, "M", "ئې"), + (0xFBF9, "M", "ئى"), + (0xFBFC, "M", "ی"), + (0xFC00, "M", "ئج"), + (0xFC01, "M", "ئح"), + (0xFC02, "M", "ئم"), + (0xFC03, "M", "ئى"), + (0xFC04, "M", "ئي"), + (0xFC05, "M", "بج"), + (0xFC06, "M", "بح"), + (0xFC07, "M", "بخ"), + (0xFC08, "M", "بم"), + (0xFC09, "M", "بى"), + (0xFC0A, "M", "بي"), + (0xFC0B, "M", "تج"), + (0xFC0C, "M", "تح"), + (0xFC0D, "M", "تخ"), + (0xFC0E, "M", "تم"), + (0xFC0F, "M", "تى"), + (0xFC10, "M", "تي"), + (0xFC11, "M", "ثج"), + (0xFC12, "M", "ثم"), + (0xFC13, "M", "ثى"), + (0xFC14, "M", "ثي"), + (0xFC15, "M", "جح"), + (0xFC16, "M", "جم"), + (0xFC17, "M", "حج"), + (0xFC18, "M", "حم"), + (0xFC19, "M", "خج"), + (0xFC1A, "M", "خح"), + (0xFC1B, "M", "خم"), + (0xFC1C, "M", "سج"), + (0xFC1D, "M", "سح"), + (0xFC1E, "M", "سخ"), + (0xFC1F, "M", "سم"), + (0xFC20, "M", "صح"), + (0xFC21, "M", "صم"), + (0xFC22, "M", "ضج"), + (0xFC23, "M", "ضح"), + (0xFC24, "M", "ضخ"), + (0xFC25, "M", "ضم"), + (0xFC26, "M", "طح"), + (0xFC27, "M", "طم"), + (0xFC28, "M", "ظم"), + (0xFC29, "M", "عج"), + (0xFC2A, "M", "عم"), + (0xFC2B, "M", "غج"), + (0xFC2C, "M", "غم"), + (0xFC2D, "M", "فج"), + (0xFC2E, "M", "فح"), + (0xFC2F, "M", "فخ"), + (0xFC30, "M", "فم"), + (0xFC31, "M", "فى"), + (0xFC32, "M", "في"), + (0xFC33, "M", "قح"), + (0xFC34, "M", "قم"), + (0xFC35, "M", "قى"), + (0xFC36, "M", "قي"), + (0xFC37, "M", "كا"), + (0xFC38, "M", "كج"), + (0xFC39, "M", "كح"), + (0xFC3A, "M", "كخ"), + (0xFC3B, "M", "كل"), + (0xFC3C, "M", "كم"), + (0xFC3D, "M", "كى"), + (0xFC3E, "M", "كي"), + (0xFC3F, "M", "لج"), + (0xFC40, "M", "لح"), + (0xFC41, "M", "لخ"), + (0xFC42, "M", "لم"), + (0xFC43, "M", "لى"), + (0xFC44, "M", "لي"), + (0xFC45, "M", "مج"), + (0xFC46, "M", "مح"), + (0xFC47, "M", "مخ"), + (0xFC48, "M", "مم"), + (0xFC49, "M", "مى"), + (0xFC4A, "M", "مي"), + (0xFC4B, "M", "نج"), + (0xFC4C, "M", "نح"), + (0xFC4D, "M", "نخ"), + (0xFC4E, "M", "نم"), + (0xFC4F, "M", "نى"), + (0xFC50, "M", "ني"), + (0xFC51, "M", "هج"), + (0xFC52, "M", "هم"), + (0xFC53, "M", "هى"), + (0xFC54, "M", "هي"), + (0xFC55, "M", "يج"), + (0xFC56, "M", "يح"), + (0xFC57, "M", "يخ"), + (0xFC58, "M", "يم"), + (0xFC59, "M", "يى"), + (0xFC5A, "M", "يي"), + ] + + +def _seg_46() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0xFC5B, "M", "ذٰ"), + (0xFC5C, "M", "رٰ"), + (0xFC5D, "M", "ىٰ"), + (0xFC5E, "3", " ٌّ"), + (0xFC5F, "3", " ٍّ"), + (0xFC60, "3", " َّ"), + (0xFC61, "3", " ُّ"), + (0xFC62, "3", " ِّ"), + (0xFC63, "3", " ّٰ"), + (0xFC64, "M", "ئر"), + (0xFC65, "M", "ئز"), + (0xFC66, "M", "ئم"), + (0xFC67, "M", "ئن"), + (0xFC68, "M", "ئى"), + (0xFC69, "M", "ئي"), + (0xFC6A, "M", "بر"), + (0xFC6B, "M", "بز"), + (0xFC6C, "M", "بم"), + (0xFC6D, "M", "بن"), + (0xFC6E, "M", "بى"), + (0xFC6F, "M", "بي"), + (0xFC70, "M", "تر"), + (0xFC71, "M", "تز"), + (0xFC72, "M", "تم"), + (0xFC73, "M", "تن"), + (0xFC74, "M", "تى"), + (0xFC75, "M", "تي"), + (0xFC76, "M", "ثر"), + (0xFC77, "M", "ثز"), + (0xFC78, "M", "ثم"), + (0xFC79, "M", "ثن"), + (0xFC7A, "M", "ثى"), + (0xFC7B, "M", "ثي"), + (0xFC7C, "M", "فى"), + (0xFC7D, "M", "في"), + (0xFC7E, "M", "قى"), + (0xFC7F, "M", "قي"), + (0xFC80, "M", "كا"), + (0xFC81, "M", "كل"), + (0xFC82, "M", "كم"), + (0xFC83, "M", "كى"), + (0xFC84, "M", "كي"), + (0xFC85, "M", "لم"), + (0xFC86, "M", "لى"), + (0xFC87, "M", "لي"), + (0xFC88, "M", "ما"), + (0xFC89, "M", "مم"), + (0xFC8A, "M", "نر"), + (0xFC8B, "M", "نز"), + (0xFC8C, "M", "نم"), + (0xFC8D, "M", "نن"), + (0xFC8E, "M", "نى"), + (0xFC8F, "M", "ني"), + (0xFC90, "M", "ىٰ"), + (0xFC91, "M", "ير"), + (0xFC92, "M", "يز"), + (0xFC93, "M", "يم"), + (0xFC94, "M", "ين"), + (0xFC95, "M", "يى"), + (0xFC96, "M", "يي"), + (0xFC97, "M", "ئج"), + (0xFC98, "M", "ئح"), + (0xFC99, "M", "ئخ"), + (0xFC9A, "M", "ئم"), + (0xFC9B, "M", "ئه"), + (0xFC9C, "M", "بج"), + (0xFC9D, "M", "بح"), + (0xFC9E, "M", "بخ"), + (0xFC9F, "M", "بم"), + (0xFCA0, "M", "به"), + (0xFCA1, "M", "تج"), + (0xFCA2, "M", "تح"), + (0xFCA3, "M", "تخ"), + (0xFCA4, "M", "تم"), + (0xFCA5, "M", "ته"), + (0xFCA6, "M", "ثم"), + (0xFCA7, "M", "جح"), + (0xFCA8, "M", "جم"), + (0xFCA9, "M", "حج"), + (0xFCAA, "M", "حم"), + (0xFCAB, "M", "خج"), + (0xFCAC, "M", "خم"), + (0xFCAD, "M", "سج"), + (0xFCAE, "M", "سح"), + (0xFCAF, "M", "سخ"), + (0xFCB0, "M", "سم"), + (0xFCB1, "M", "صح"), + (0xFCB2, "M", "صخ"), + (0xFCB3, "M", "صم"), + (0xFCB4, "M", "ضج"), + (0xFCB5, "M", "ضح"), + (0xFCB6, "M", "ضخ"), + (0xFCB7, "M", "ضم"), + (0xFCB8, "M", "طح"), + (0xFCB9, "M", "ظم"), + (0xFCBA, "M", "عج"), + (0xFCBB, "M", "عم"), + (0xFCBC, "M", "غج"), + (0xFCBD, "M", "غم"), + (0xFCBE, "M", "فج"), + ] + + +def _seg_47() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0xFCBF, "M", "فح"), + (0xFCC0, "M", "فخ"), + (0xFCC1, "M", "فم"), + (0xFCC2, "M", "قح"), + (0xFCC3, "M", "قم"), + (0xFCC4, "M", "كج"), + (0xFCC5, "M", "كح"), + (0xFCC6, "M", "كخ"), + (0xFCC7, "M", "كل"), + (0xFCC8, "M", "كم"), + (0xFCC9, "M", "لج"), + (0xFCCA, "M", "لح"), + (0xFCCB, "M", "لخ"), + (0xFCCC, "M", "لم"), + (0xFCCD, "M", "له"), + (0xFCCE, "M", "مج"), + (0xFCCF, "M", "مح"), + (0xFCD0, "M", "مخ"), + (0xFCD1, "M", "مم"), + (0xFCD2, "M", "نج"), + (0xFCD3, "M", "نح"), + (0xFCD4, "M", "نخ"), + (0xFCD5, "M", "نم"), + (0xFCD6, "M", "نه"), + (0xFCD7, "M", "هج"), + (0xFCD8, "M", "هم"), + (0xFCD9, "M", "هٰ"), + (0xFCDA, "M", "يج"), + (0xFCDB, "M", "يح"), + (0xFCDC, "M", "يخ"), + (0xFCDD, "M", "يم"), + (0xFCDE, "M", "يه"), + (0xFCDF, "M", "ئم"), + (0xFCE0, "M", "ئه"), + (0xFCE1, "M", "بم"), + (0xFCE2, "M", "به"), + (0xFCE3, "M", "تم"), + (0xFCE4, "M", "ته"), + (0xFCE5, "M", "ثم"), + (0xFCE6, "M", "ثه"), + (0xFCE7, "M", "سم"), + (0xFCE8, "M", "سه"), + (0xFCE9, "M", "شم"), + (0xFCEA, "M", "شه"), + (0xFCEB, "M", "كل"), + (0xFCEC, "M", "كم"), + (0xFCED, "M", "لم"), + (0xFCEE, "M", "نم"), + (0xFCEF, "M", "نه"), + (0xFCF0, "M", "يم"), + (0xFCF1, "M", "يه"), + (0xFCF2, "M", "ـَّ"), + (0xFCF3, "M", "ـُّ"), + (0xFCF4, "M", "ـِّ"), + (0xFCF5, "M", "طى"), + (0xFCF6, "M", "طي"), + (0xFCF7, "M", "عى"), + (0xFCF8, "M", "عي"), + (0xFCF9, "M", "غى"), + (0xFCFA, "M", "غي"), + (0xFCFB, "M", "سى"), + (0xFCFC, "M", "سي"), + (0xFCFD, "M", "شى"), + (0xFCFE, "M", "شي"), + (0xFCFF, "M", "حى"), + (0xFD00, "M", "حي"), + (0xFD01, "M", "جى"), + (0xFD02, "M", "جي"), + (0xFD03, "M", "خى"), + (0xFD04, "M", "خي"), + (0xFD05, "M", "صى"), + (0xFD06, "M", "صي"), + (0xFD07, "M", "ضى"), + (0xFD08, "M", "ضي"), + (0xFD09, "M", "شج"), + (0xFD0A, "M", "شح"), + (0xFD0B, "M", "شخ"), + (0xFD0C, "M", "شم"), + (0xFD0D, "M", "شر"), + (0xFD0E, "M", "سر"), + (0xFD0F, "M", "صر"), + (0xFD10, "M", "ضر"), + (0xFD11, "M", "طى"), + (0xFD12, "M", "طي"), + (0xFD13, "M", "عى"), + (0xFD14, "M", "عي"), + (0xFD15, "M", "غى"), + (0xFD16, "M", "غي"), + (0xFD17, "M", "سى"), + (0xFD18, "M", "سي"), + (0xFD19, "M", "شى"), + (0xFD1A, "M", "شي"), + (0xFD1B, "M", "حى"), + (0xFD1C, "M", "حي"), + (0xFD1D, "M", "جى"), + (0xFD1E, "M", "جي"), + (0xFD1F, "M", "خى"), + (0xFD20, "M", "خي"), + (0xFD21, "M", "صى"), + (0xFD22, "M", "صي"), + ] + + +def _seg_48() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0xFD23, "M", "ضى"), + (0xFD24, "M", "ضي"), + (0xFD25, "M", "شج"), + (0xFD26, "M", "شح"), + (0xFD27, "M", "شخ"), + (0xFD28, "M", "شم"), + (0xFD29, "M", "شر"), + (0xFD2A, "M", "سر"), + (0xFD2B, "M", "صر"), + (0xFD2C, "M", "ضر"), + (0xFD2D, "M", "شج"), + (0xFD2E, "M", "شح"), + (0xFD2F, "M", "شخ"), + (0xFD30, "M", "شم"), + (0xFD31, "M", "سه"), + (0xFD32, "M", "شه"), + (0xFD33, "M", "طم"), + (0xFD34, "M", "سج"), + (0xFD35, "M", "سح"), + (0xFD36, "M", "سخ"), + (0xFD37, "M", "شج"), + (0xFD38, "M", "شح"), + (0xFD39, "M", "شخ"), + (0xFD3A, "M", "طم"), + (0xFD3B, "M", "ظم"), + (0xFD3C, "M", "اً"), + (0xFD3E, "V"), + (0xFD50, "M", "تجم"), + (0xFD51, "M", "تحج"), + (0xFD53, "M", "تحم"), + (0xFD54, "M", "تخم"), + (0xFD55, "M", "تمج"), + (0xFD56, "M", "تمح"), + (0xFD57, "M", "تمخ"), + (0xFD58, "M", "جمح"), + (0xFD5A, "M", "حمي"), + (0xFD5B, "M", "حمى"), + (0xFD5C, "M", "سحج"), + (0xFD5D, "M", "سجح"), + (0xFD5E, "M", "سجى"), + (0xFD5F, "M", "سمح"), + (0xFD61, "M", "سمج"), + (0xFD62, "M", "سمم"), + (0xFD64, "M", "صحح"), + (0xFD66, "M", "صمم"), + (0xFD67, "M", "شحم"), + (0xFD69, "M", "شجي"), + (0xFD6A, "M", "شمخ"), + (0xFD6C, "M", "شمم"), + (0xFD6E, "M", "ضحى"), + (0xFD6F, "M", "ضخم"), + (0xFD71, "M", "طمح"), + (0xFD73, "M", "طمم"), + (0xFD74, "M", "طمي"), + (0xFD75, "M", "عجم"), + (0xFD76, "M", "عمم"), + (0xFD78, "M", "عمى"), + (0xFD79, "M", "غمم"), + (0xFD7A, "M", "غمي"), + (0xFD7B, "M", "غمى"), + (0xFD7C, "M", "فخم"), + (0xFD7E, "M", "قمح"), + (0xFD7F, "M", "قمم"), + (0xFD80, "M", "لحم"), + (0xFD81, "M", "لحي"), + (0xFD82, "M", "لحى"), + (0xFD83, "M", "لجج"), + (0xFD85, "M", "لخم"), + (0xFD87, "M", "لمح"), + (0xFD89, "M", "محج"), + (0xFD8A, "M", "محم"), + (0xFD8B, "M", "محي"), + (0xFD8C, "M", "مجح"), + (0xFD8D, "M", "مجم"), + (0xFD8E, "M", "مخج"), + (0xFD8F, "M", "مخم"), + (0xFD90, "X"), + (0xFD92, "M", "مجخ"), + (0xFD93, "M", "همج"), + (0xFD94, "M", "همم"), + (0xFD95, "M", "نحم"), + (0xFD96, "M", "نحى"), + (0xFD97, "M", "نجم"), + (0xFD99, "M", "نجى"), + (0xFD9A, "M", "نمي"), + (0xFD9B, "M", "نمى"), + (0xFD9C, "M", "يمم"), + (0xFD9E, "M", "بخي"), + (0xFD9F, "M", "تجي"), + (0xFDA0, "M", "تجى"), + (0xFDA1, "M", "تخي"), + (0xFDA2, "M", "تخى"), + (0xFDA3, "M", "تمي"), + (0xFDA4, "M", "تمى"), + (0xFDA5, "M", "جمي"), + (0xFDA6, "M", "جحى"), + (0xFDA7, "M", "جمى"), + (0xFDA8, "M", "سخى"), + (0xFDA9, "M", "صحي"), + (0xFDAA, "M", "شحي"), + ] + + +def _seg_49() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0xFDAB, "M", "ضحي"), + (0xFDAC, "M", "لجي"), + (0xFDAD, "M", "لمي"), + (0xFDAE, "M", "يحي"), + (0xFDAF, "M", "يجي"), + (0xFDB0, "M", "يمي"), + (0xFDB1, "M", "ممي"), + (0xFDB2, "M", "قمي"), + (0xFDB3, "M", "نحي"), + (0xFDB4, "M", "قمح"), + (0xFDB5, "M", "لحم"), + (0xFDB6, "M", "عمي"), + (0xFDB7, "M", "كمي"), + (0xFDB8, "M", "نجح"), + (0xFDB9, "M", "مخي"), + (0xFDBA, "M", "لجم"), + (0xFDBB, "M", "كمم"), + (0xFDBC, "M", "لجم"), + (0xFDBD, "M", "نجح"), + (0xFDBE, "M", "جحي"), + (0xFDBF, "M", "حجي"), + (0xFDC0, "M", "مجي"), + (0xFDC1, "M", "فمي"), + (0xFDC2, "M", "بحي"), + (0xFDC3, "M", "كمم"), + (0xFDC4, "M", "عجم"), + (0xFDC5, "M", "صمم"), + (0xFDC6, "M", "سخي"), + (0xFDC7, "M", "نجي"), + (0xFDC8, "X"), + (0xFDCF, "V"), + (0xFDD0, "X"), + (0xFDF0, "M", "صلے"), + (0xFDF1, "M", "قلے"), + (0xFDF2, "M", "الله"), + (0xFDF3, "M", "اكبر"), + (0xFDF4, "M", "محمد"), + (0xFDF5, "M", "صلعم"), + (0xFDF6, "M", "رسول"), + (0xFDF7, "M", "عليه"), + (0xFDF8, "M", "وسلم"), + (0xFDF9, "M", "صلى"), + (0xFDFA, "3", "صلى الله عليه وسلم"), + (0xFDFB, "3", "جل جلاله"), + (0xFDFC, "M", "ریال"), + (0xFDFD, "V"), + (0xFE00, "I"), + (0xFE10, "3", ","), + (0xFE11, "M", "、"), + (0xFE12, "X"), + (0xFE13, "3", ":"), + (0xFE14, "3", ";"), + (0xFE15, "3", "!"), + (0xFE16, "3", "?"), + (0xFE17, "M", "〖"), + (0xFE18, "M", "〗"), + (0xFE19, "X"), + (0xFE20, "V"), + (0xFE30, "X"), + (0xFE31, "M", "—"), + (0xFE32, "M", "–"), + (0xFE33, "3", "_"), + (0xFE35, "3", "("), + (0xFE36, "3", ")"), + (0xFE37, "3", "{"), + (0xFE38, "3", "}"), + (0xFE39, "M", "〔"), + (0xFE3A, "M", "〕"), + (0xFE3B, "M", "【"), + (0xFE3C, "M", "】"), + (0xFE3D, "M", "《"), + (0xFE3E, "M", "》"), + (0xFE3F, "M", "〈"), + (0xFE40, "M", "〉"), + (0xFE41, "M", "「"), + (0xFE42, "M", "」"), + (0xFE43, "M", "『"), + (0xFE44, "M", "』"), + (0xFE45, "V"), + (0xFE47, "3", "["), + (0xFE48, "3", "]"), + (0xFE49, "3", " ̅"), + (0xFE4D, "3", "_"), + (0xFE50, "3", ","), + (0xFE51, "M", "、"), + (0xFE52, "X"), + (0xFE54, "3", ";"), + (0xFE55, "3", ":"), + (0xFE56, "3", "?"), + (0xFE57, "3", "!"), + (0xFE58, "M", "—"), + (0xFE59, "3", "("), + (0xFE5A, "3", ")"), + (0xFE5B, "3", "{"), + (0xFE5C, "3", "}"), + (0xFE5D, "M", "〔"), + (0xFE5E, "M", "〕"), + (0xFE5F, "3", "#"), + (0xFE60, "3", "&"), + (0xFE61, "3", "*"), + ] + + +def _seg_50() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0xFE62, "3", "+"), + (0xFE63, "M", "-"), + (0xFE64, "3", "<"), + (0xFE65, "3", ">"), + (0xFE66, "3", "="), + (0xFE67, "X"), + (0xFE68, "3", "\\"), + (0xFE69, "3", "$"), + (0xFE6A, "3", "%"), + (0xFE6B, "3", "@"), + (0xFE6C, "X"), + (0xFE70, "3", " ً"), + (0xFE71, "M", "ـً"), + (0xFE72, "3", " ٌ"), + (0xFE73, "V"), + (0xFE74, "3", " ٍ"), + (0xFE75, "X"), + (0xFE76, "3", " َ"), + (0xFE77, "M", "ـَ"), + (0xFE78, "3", " ُ"), + (0xFE79, "M", "ـُ"), + (0xFE7A, "3", " ِ"), + (0xFE7B, "M", "ـِ"), + (0xFE7C, "3", " ّ"), + (0xFE7D, "M", "ـّ"), + (0xFE7E, "3", " ْ"), + (0xFE7F, "M", "ـْ"), + (0xFE80, "M", "ء"), + (0xFE81, "M", "آ"), + (0xFE83, "M", "أ"), + (0xFE85, "M", "ؤ"), + (0xFE87, "M", "إ"), + (0xFE89, "M", "ئ"), + (0xFE8D, "M", "ا"), + (0xFE8F, "M", "ب"), + (0xFE93, "M", "ة"), + (0xFE95, "M", "ت"), + (0xFE99, "M", "ث"), + (0xFE9D, "M", "ج"), + (0xFEA1, "M", "ح"), + (0xFEA5, "M", "خ"), + (0xFEA9, "M", "د"), + (0xFEAB, "M", "ذ"), + (0xFEAD, "M", "ر"), + (0xFEAF, "M", "ز"), + (0xFEB1, "M", "س"), + (0xFEB5, "M", "ش"), + (0xFEB9, "M", "ص"), + (0xFEBD, "M", "ض"), + (0xFEC1, "M", "ط"), + (0xFEC5, "M", "ظ"), + (0xFEC9, "M", "ع"), + (0xFECD, "M", "غ"), + (0xFED1, "M", "ف"), + (0xFED5, "M", "ق"), + (0xFED9, "M", "ك"), + (0xFEDD, "M", "ل"), + (0xFEE1, "M", "م"), + (0xFEE5, "M", "ن"), + (0xFEE9, "M", "ه"), + (0xFEED, "M", "و"), + (0xFEEF, "M", "ى"), + (0xFEF1, "M", "ي"), + (0xFEF5, "M", "لآ"), + (0xFEF7, "M", "لأ"), + (0xFEF9, "M", "لإ"), + (0xFEFB, "M", "لا"), + (0xFEFD, "X"), + (0xFEFF, "I"), + (0xFF00, "X"), + (0xFF01, "3", "!"), + (0xFF02, "3", '"'), + (0xFF03, "3", "#"), + (0xFF04, "3", "$"), + (0xFF05, "3", "%"), + (0xFF06, "3", "&"), + (0xFF07, "3", "'"), + (0xFF08, "3", "("), + (0xFF09, "3", ")"), + (0xFF0A, "3", "*"), + (0xFF0B, "3", "+"), + (0xFF0C, "3", ","), + (0xFF0D, "M", "-"), + (0xFF0E, "M", "."), + (0xFF0F, "3", "/"), + (0xFF10, "M", "0"), + (0xFF11, "M", "1"), + (0xFF12, "M", "2"), + (0xFF13, "M", "3"), + (0xFF14, "M", "4"), + (0xFF15, "M", "5"), + (0xFF16, "M", "6"), + (0xFF17, "M", "7"), + (0xFF18, "M", "8"), + (0xFF19, "M", "9"), + (0xFF1A, "3", ":"), + (0xFF1B, "3", ";"), + (0xFF1C, "3", "<"), + (0xFF1D, "3", "="), + (0xFF1E, "3", ">"), + ] + + +def _seg_51() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0xFF1F, "3", "?"), + (0xFF20, "3", "@"), + (0xFF21, "M", "a"), + (0xFF22, "M", "b"), + (0xFF23, "M", "c"), + (0xFF24, "M", "d"), + (0xFF25, "M", "e"), + (0xFF26, "M", "f"), + (0xFF27, "M", "g"), + (0xFF28, "M", "h"), + (0xFF29, "M", "i"), + (0xFF2A, "M", "j"), + (0xFF2B, "M", "k"), + (0xFF2C, "M", "l"), + (0xFF2D, "M", "m"), + (0xFF2E, "M", "n"), + (0xFF2F, "M", "o"), + (0xFF30, "M", "p"), + (0xFF31, "M", "q"), + (0xFF32, "M", "r"), + (0xFF33, "M", "s"), + (0xFF34, "M", "t"), + (0xFF35, "M", "u"), + (0xFF36, "M", "v"), + (0xFF37, "M", "w"), + (0xFF38, "M", "x"), + (0xFF39, "M", "y"), + (0xFF3A, "M", "z"), + (0xFF3B, "3", "["), + (0xFF3C, "3", "\\"), + (0xFF3D, "3", "]"), + (0xFF3E, "3", "^"), + (0xFF3F, "3", "_"), + (0xFF40, "3", "`"), + (0xFF41, "M", "a"), + (0xFF42, "M", "b"), + (0xFF43, "M", "c"), + (0xFF44, "M", "d"), + (0xFF45, "M", "e"), + (0xFF46, "M", "f"), + (0xFF47, "M", "g"), + (0xFF48, "M", "h"), + (0xFF49, "M", "i"), + (0xFF4A, "M", "j"), + (0xFF4B, "M", "k"), + (0xFF4C, "M", "l"), + (0xFF4D, "M", "m"), + (0xFF4E, "M", "n"), + (0xFF4F, "M", "o"), + (0xFF50, "M", "p"), + (0xFF51, "M", "q"), + (0xFF52, "M", "r"), + (0xFF53, "M", "s"), + (0xFF54, "M", "t"), + (0xFF55, "M", "u"), + (0xFF56, "M", "v"), + (0xFF57, "M", "w"), + (0xFF58, "M", "x"), + (0xFF59, "M", "y"), + (0xFF5A, "M", "z"), + (0xFF5B, "3", "{"), + (0xFF5C, "3", "|"), + (0xFF5D, "3", "}"), + (0xFF5E, "3", "~"), + (0xFF5F, "M", "⦅"), + (0xFF60, "M", "⦆"), + (0xFF61, "M", "."), + (0xFF62, "M", "「"), + (0xFF63, "M", "」"), + (0xFF64, "M", "、"), + (0xFF65, "M", "・"), + (0xFF66, "M", "ヲ"), + (0xFF67, "M", "ァ"), + (0xFF68, "M", "ィ"), + (0xFF69, "M", "ゥ"), + (0xFF6A, "M", "ェ"), + (0xFF6B, "M", "ォ"), + (0xFF6C, "M", "ャ"), + (0xFF6D, "M", "ュ"), + (0xFF6E, "M", "ョ"), + (0xFF6F, "M", "ッ"), + (0xFF70, "M", "ー"), + (0xFF71, "M", "ア"), + (0xFF72, "M", "イ"), + (0xFF73, "M", "ウ"), + (0xFF74, "M", "エ"), + (0xFF75, "M", "オ"), + (0xFF76, "M", "カ"), + (0xFF77, "M", "キ"), + (0xFF78, "M", "ク"), + (0xFF79, "M", "ケ"), + (0xFF7A, "M", "コ"), + (0xFF7B, "M", "サ"), + (0xFF7C, "M", "シ"), + (0xFF7D, "M", "ス"), + (0xFF7E, "M", "セ"), + (0xFF7F, "M", "ソ"), + (0xFF80, "M", "タ"), + (0xFF81, "M", "チ"), + (0xFF82, "M", "ツ"), + ] + + +def _seg_52() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0xFF83, "M", "テ"), + (0xFF84, "M", "ト"), + (0xFF85, "M", "ナ"), + (0xFF86, "M", "ニ"), + (0xFF87, "M", "ヌ"), + (0xFF88, "M", "ネ"), + (0xFF89, "M", "ノ"), + (0xFF8A, "M", "ハ"), + (0xFF8B, "M", "ヒ"), + (0xFF8C, "M", "フ"), + (0xFF8D, "M", "ヘ"), + (0xFF8E, "M", "ホ"), + (0xFF8F, "M", "マ"), + (0xFF90, "M", "ミ"), + (0xFF91, "M", "ム"), + (0xFF92, "M", "メ"), + (0xFF93, "M", "モ"), + (0xFF94, "M", "ヤ"), + (0xFF95, "M", "ユ"), + (0xFF96, "M", "ヨ"), + (0xFF97, "M", "ラ"), + (0xFF98, "M", "リ"), + (0xFF99, "M", "ル"), + (0xFF9A, "M", "レ"), + (0xFF9B, "M", "ロ"), + (0xFF9C, "M", "ワ"), + (0xFF9D, "M", "ン"), + (0xFF9E, "M", "゙"), + (0xFF9F, "M", "゚"), + (0xFFA0, "X"), + (0xFFA1, "M", "ᄀ"), + (0xFFA2, "M", "ᄁ"), + (0xFFA3, "M", "ᆪ"), + (0xFFA4, "M", "ᄂ"), + (0xFFA5, "M", "ᆬ"), + (0xFFA6, "M", "ᆭ"), + (0xFFA7, "M", "ᄃ"), + (0xFFA8, "M", "ᄄ"), + (0xFFA9, "M", "ᄅ"), + (0xFFAA, "M", "ᆰ"), + (0xFFAB, "M", "ᆱ"), + (0xFFAC, "M", "ᆲ"), + (0xFFAD, "M", "ᆳ"), + (0xFFAE, "M", "ᆴ"), + (0xFFAF, "M", "ᆵ"), + (0xFFB0, "M", "ᄚ"), + (0xFFB1, "M", "ᄆ"), + (0xFFB2, "M", "ᄇ"), + (0xFFB3, "M", "ᄈ"), + (0xFFB4, "M", "ᄡ"), + (0xFFB5, "M", "ᄉ"), + (0xFFB6, "M", "ᄊ"), + (0xFFB7, "M", "ᄋ"), + (0xFFB8, "M", "ᄌ"), + (0xFFB9, "M", "ᄍ"), + (0xFFBA, "M", "ᄎ"), + (0xFFBB, "M", "ᄏ"), + (0xFFBC, "M", "ᄐ"), + (0xFFBD, "M", "ᄑ"), + (0xFFBE, "M", "ᄒ"), + (0xFFBF, "X"), + (0xFFC2, "M", "ᅡ"), + (0xFFC3, "M", "ᅢ"), + (0xFFC4, "M", "ᅣ"), + (0xFFC5, "M", "ᅤ"), + (0xFFC6, "M", "ᅥ"), + (0xFFC7, "M", "ᅦ"), + (0xFFC8, "X"), + (0xFFCA, "M", "ᅧ"), + (0xFFCB, "M", "ᅨ"), + (0xFFCC, "M", "ᅩ"), + (0xFFCD, "M", "ᅪ"), + (0xFFCE, "M", "ᅫ"), + (0xFFCF, "M", "ᅬ"), + (0xFFD0, "X"), + (0xFFD2, "M", "ᅭ"), + (0xFFD3, "M", "ᅮ"), + (0xFFD4, "M", "ᅯ"), + (0xFFD5, "M", "ᅰ"), + (0xFFD6, "M", "ᅱ"), + (0xFFD7, "M", "ᅲ"), + (0xFFD8, "X"), + (0xFFDA, "M", "ᅳ"), + (0xFFDB, "M", "ᅴ"), + (0xFFDC, "M", "ᅵ"), + (0xFFDD, "X"), + (0xFFE0, "M", "¢"), + (0xFFE1, "M", "£"), + (0xFFE2, "M", "¬"), + (0xFFE3, "3", " ̄"), + (0xFFE4, "M", "¦"), + (0xFFE5, "M", "¥"), + (0xFFE6, "M", "₩"), + (0xFFE7, "X"), + (0xFFE8, "M", "│"), + (0xFFE9, "M", "←"), + (0xFFEA, "M", "↑"), + (0xFFEB, "M", "→"), + (0xFFEC, "M", "↓"), + (0xFFED, "M", "■"), + ] + + +def _seg_53() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0xFFEE, "M", "○"), + (0xFFEF, "X"), + (0x10000, "V"), + (0x1000C, "X"), + (0x1000D, "V"), + (0x10027, "X"), + (0x10028, "V"), + (0x1003B, "X"), + (0x1003C, "V"), + (0x1003E, "X"), + (0x1003F, "V"), + (0x1004E, "X"), + (0x10050, "V"), + (0x1005E, "X"), + (0x10080, "V"), + (0x100FB, "X"), + (0x10100, "V"), + (0x10103, "X"), + (0x10107, "V"), + (0x10134, "X"), + (0x10137, "V"), + (0x1018F, "X"), + (0x10190, "V"), + (0x1019D, "X"), + (0x101A0, "V"), + (0x101A1, "X"), + (0x101D0, "V"), + (0x101FE, "X"), + (0x10280, "V"), + (0x1029D, "X"), + (0x102A0, "V"), + (0x102D1, "X"), + (0x102E0, "V"), + (0x102FC, "X"), + (0x10300, "V"), + (0x10324, "X"), + (0x1032D, "V"), + (0x1034B, "X"), + (0x10350, "V"), + (0x1037B, "X"), + (0x10380, "V"), + (0x1039E, "X"), + (0x1039F, "V"), + (0x103C4, "X"), + (0x103C8, "V"), + (0x103D6, "X"), + (0x10400, "M", "𐐨"), + (0x10401, "M", "𐐩"), + (0x10402, "M", "𐐪"), + (0x10403, "M", "𐐫"), + (0x10404, "M", "𐐬"), + (0x10405, "M", "𐐭"), + (0x10406, "M", "𐐮"), + (0x10407, "M", "𐐯"), + (0x10408, "M", "𐐰"), + (0x10409, "M", "𐐱"), + (0x1040A, "M", "𐐲"), + (0x1040B, "M", "𐐳"), + (0x1040C, "M", "𐐴"), + (0x1040D, "M", "𐐵"), + (0x1040E, "M", "𐐶"), + (0x1040F, "M", "𐐷"), + (0x10410, "M", "𐐸"), + (0x10411, "M", "𐐹"), + (0x10412, "M", "𐐺"), + (0x10413, "M", "𐐻"), + (0x10414, "M", "𐐼"), + (0x10415, "M", "𐐽"), + (0x10416, "M", "𐐾"), + (0x10417, "M", "𐐿"), + (0x10418, "M", "𐑀"), + (0x10419, "M", "𐑁"), + (0x1041A, "M", "𐑂"), + (0x1041B, "M", "𐑃"), + (0x1041C, "M", "𐑄"), + (0x1041D, "M", "𐑅"), + (0x1041E, "M", "𐑆"), + (0x1041F, "M", "𐑇"), + (0x10420, "M", "𐑈"), + (0x10421, "M", "𐑉"), + (0x10422, "M", "𐑊"), + (0x10423, "M", "𐑋"), + (0x10424, "M", "𐑌"), + (0x10425, "M", "𐑍"), + (0x10426, "M", "𐑎"), + (0x10427, "M", "𐑏"), + (0x10428, "V"), + (0x1049E, "X"), + (0x104A0, "V"), + (0x104AA, "X"), + (0x104B0, "M", "𐓘"), + (0x104B1, "M", "𐓙"), + (0x104B2, "M", "𐓚"), + (0x104B3, "M", "𐓛"), + (0x104B4, "M", "𐓜"), + (0x104B5, "M", "𐓝"), + (0x104B6, "M", "𐓞"), + (0x104B7, "M", "𐓟"), + (0x104B8, "M", "𐓠"), + (0x104B9, "M", "𐓡"), + ] + + +def _seg_54() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x104BA, "M", "𐓢"), + (0x104BB, "M", "𐓣"), + (0x104BC, "M", "𐓤"), + (0x104BD, "M", "𐓥"), + (0x104BE, "M", "𐓦"), + (0x104BF, "M", "𐓧"), + (0x104C0, "M", "𐓨"), + (0x104C1, "M", "𐓩"), + (0x104C2, "M", "𐓪"), + (0x104C3, "M", "𐓫"), + (0x104C4, "M", "𐓬"), + (0x104C5, "M", "𐓭"), + (0x104C6, "M", "𐓮"), + (0x104C7, "M", "𐓯"), + (0x104C8, "M", "𐓰"), + (0x104C9, "M", "𐓱"), + (0x104CA, "M", "𐓲"), + (0x104CB, "M", "𐓳"), + (0x104CC, "M", "𐓴"), + (0x104CD, "M", "𐓵"), + (0x104CE, "M", "𐓶"), + (0x104CF, "M", "𐓷"), + (0x104D0, "M", "𐓸"), + (0x104D1, "M", "𐓹"), + (0x104D2, "M", "𐓺"), + (0x104D3, "M", "𐓻"), + (0x104D4, "X"), + (0x104D8, "V"), + (0x104FC, "X"), + (0x10500, "V"), + (0x10528, "X"), + (0x10530, "V"), + (0x10564, "X"), + (0x1056F, "V"), + (0x10570, "M", "𐖗"), + (0x10571, "M", "𐖘"), + (0x10572, "M", "𐖙"), + (0x10573, "M", "𐖚"), + (0x10574, "M", "𐖛"), + (0x10575, "M", "𐖜"), + (0x10576, "M", "𐖝"), + (0x10577, "M", "𐖞"), + (0x10578, "M", "𐖟"), + (0x10579, "M", "𐖠"), + (0x1057A, "M", "𐖡"), + (0x1057B, "X"), + (0x1057C, "M", "𐖣"), + (0x1057D, "M", "𐖤"), + (0x1057E, "M", "𐖥"), + (0x1057F, "M", "𐖦"), + (0x10580, "M", "𐖧"), + (0x10581, "M", "𐖨"), + (0x10582, "M", "𐖩"), + (0x10583, "M", "𐖪"), + (0x10584, "M", "𐖫"), + (0x10585, "M", "𐖬"), + (0x10586, "M", "𐖭"), + (0x10587, "M", "𐖮"), + (0x10588, "M", "𐖯"), + (0x10589, "M", "𐖰"), + (0x1058A, "M", "𐖱"), + (0x1058B, "X"), + (0x1058C, "M", "𐖳"), + (0x1058D, "M", "𐖴"), + (0x1058E, "M", "𐖵"), + (0x1058F, "M", "𐖶"), + (0x10590, "M", "𐖷"), + (0x10591, "M", "𐖸"), + (0x10592, "M", "𐖹"), + (0x10593, "X"), + (0x10594, "M", "𐖻"), + (0x10595, "M", "𐖼"), + (0x10596, "X"), + (0x10597, "V"), + (0x105A2, "X"), + (0x105A3, "V"), + (0x105B2, "X"), + (0x105B3, "V"), + (0x105BA, "X"), + (0x105BB, "V"), + (0x105BD, "X"), + (0x10600, "V"), + (0x10737, "X"), + (0x10740, "V"), + (0x10756, "X"), + (0x10760, "V"), + (0x10768, "X"), + (0x10780, "V"), + (0x10781, "M", "ː"), + (0x10782, "M", "ˑ"), + (0x10783, "M", "æ"), + (0x10784, "M", "ʙ"), + (0x10785, "M", "ɓ"), + (0x10786, "X"), + (0x10787, "M", "ʣ"), + (0x10788, "M", "ꭦ"), + (0x10789, "M", "ʥ"), + (0x1078A, "M", "ʤ"), + (0x1078B, "M", "ɖ"), + (0x1078C, "M", "ɗ"), + ] + + +def _seg_55() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x1078D, "M", "ᶑ"), + (0x1078E, "M", "ɘ"), + (0x1078F, "M", "ɞ"), + (0x10790, "M", "ʩ"), + (0x10791, "M", "ɤ"), + (0x10792, "M", "ɢ"), + (0x10793, "M", "ɠ"), + (0x10794, "M", "ʛ"), + (0x10795, "M", "ħ"), + (0x10796, "M", "ʜ"), + (0x10797, "M", "ɧ"), + (0x10798, "M", "ʄ"), + (0x10799, "M", "ʪ"), + (0x1079A, "M", "ʫ"), + (0x1079B, "M", "ɬ"), + (0x1079C, "M", "𝼄"), + (0x1079D, "M", "ꞎ"), + (0x1079E, "M", "ɮ"), + (0x1079F, "M", "𝼅"), + (0x107A0, "M", "ʎ"), + (0x107A1, "M", "𝼆"), + (0x107A2, "M", "ø"), + (0x107A3, "M", "ɶ"), + (0x107A4, "M", "ɷ"), + (0x107A5, "M", "q"), + (0x107A6, "M", "ɺ"), + (0x107A7, "M", "𝼈"), + (0x107A8, "M", "ɽ"), + (0x107A9, "M", "ɾ"), + (0x107AA, "M", "ʀ"), + (0x107AB, "M", "ʨ"), + (0x107AC, "M", "ʦ"), + (0x107AD, "M", "ꭧ"), + (0x107AE, "M", "ʧ"), + (0x107AF, "M", "ʈ"), + (0x107B0, "M", "ⱱ"), + (0x107B1, "X"), + (0x107B2, "M", "ʏ"), + (0x107B3, "M", "ʡ"), + (0x107B4, "M", "ʢ"), + (0x107B5, "M", "ʘ"), + (0x107B6, "M", "ǀ"), + (0x107B7, "M", "ǁ"), + (0x107B8, "M", "ǂ"), + (0x107B9, "M", "𝼊"), + (0x107BA, "M", "𝼞"), + (0x107BB, "X"), + (0x10800, "V"), + (0x10806, "X"), + (0x10808, "V"), + (0x10809, "X"), + (0x1080A, "V"), + (0x10836, "X"), + (0x10837, "V"), + (0x10839, "X"), + (0x1083C, "V"), + (0x1083D, "X"), + (0x1083F, "V"), + (0x10856, "X"), + (0x10857, "V"), + (0x1089F, "X"), + (0x108A7, "V"), + (0x108B0, "X"), + (0x108E0, "V"), + (0x108F3, "X"), + (0x108F4, "V"), + (0x108F6, "X"), + (0x108FB, "V"), + (0x1091C, "X"), + (0x1091F, "V"), + (0x1093A, "X"), + (0x1093F, "V"), + (0x10940, "X"), + (0x10980, "V"), + (0x109B8, "X"), + (0x109BC, "V"), + (0x109D0, "X"), + (0x109D2, "V"), + (0x10A04, "X"), + (0x10A05, "V"), + (0x10A07, "X"), + (0x10A0C, "V"), + (0x10A14, "X"), + (0x10A15, "V"), + (0x10A18, "X"), + (0x10A19, "V"), + (0x10A36, "X"), + (0x10A38, "V"), + (0x10A3B, "X"), + (0x10A3F, "V"), + (0x10A49, "X"), + (0x10A50, "V"), + (0x10A59, "X"), + (0x10A60, "V"), + (0x10AA0, "X"), + (0x10AC0, "V"), + (0x10AE7, "X"), + (0x10AEB, "V"), + (0x10AF7, "X"), + (0x10B00, "V"), + ] + + +def _seg_56() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x10B36, "X"), + (0x10B39, "V"), + (0x10B56, "X"), + (0x10B58, "V"), + (0x10B73, "X"), + (0x10B78, "V"), + (0x10B92, "X"), + (0x10B99, "V"), + (0x10B9D, "X"), + (0x10BA9, "V"), + (0x10BB0, "X"), + (0x10C00, "V"), + (0x10C49, "X"), + (0x10C80, "M", "𐳀"), + (0x10C81, "M", "𐳁"), + (0x10C82, "M", "𐳂"), + (0x10C83, "M", "𐳃"), + (0x10C84, "M", "𐳄"), + (0x10C85, "M", "𐳅"), + (0x10C86, "M", "𐳆"), + (0x10C87, "M", "𐳇"), + (0x10C88, "M", "𐳈"), + (0x10C89, "M", "𐳉"), + (0x10C8A, "M", "𐳊"), + (0x10C8B, "M", "𐳋"), + (0x10C8C, "M", "𐳌"), + (0x10C8D, "M", "𐳍"), + (0x10C8E, "M", "𐳎"), + (0x10C8F, "M", "𐳏"), + (0x10C90, "M", "𐳐"), + (0x10C91, "M", "𐳑"), + (0x10C92, "M", "𐳒"), + (0x10C93, "M", "𐳓"), + (0x10C94, "M", "𐳔"), + (0x10C95, "M", "𐳕"), + (0x10C96, "M", "𐳖"), + (0x10C97, "M", "𐳗"), + (0x10C98, "M", "𐳘"), + (0x10C99, "M", "𐳙"), + (0x10C9A, "M", "𐳚"), + (0x10C9B, "M", "𐳛"), + (0x10C9C, "M", "𐳜"), + (0x10C9D, "M", "𐳝"), + (0x10C9E, "M", "𐳞"), + (0x10C9F, "M", "𐳟"), + (0x10CA0, "M", "𐳠"), + (0x10CA1, "M", "𐳡"), + (0x10CA2, "M", "𐳢"), + (0x10CA3, "M", "𐳣"), + (0x10CA4, "M", "𐳤"), + (0x10CA5, "M", "𐳥"), + (0x10CA6, "M", "𐳦"), + (0x10CA7, "M", "𐳧"), + (0x10CA8, "M", "𐳨"), + (0x10CA9, "M", "𐳩"), + (0x10CAA, "M", "𐳪"), + (0x10CAB, "M", "𐳫"), + (0x10CAC, "M", "𐳬"), + (0x10CAD, "M", "𐳭"), + (0x10CAE, "M", "𐳮"), + (0x10CAF, "M", "𐳯"), + (0x10CB0, "M", "𐳰"), + (0x10CB1, "M", "𐳱"), + (0x10CB2, "M", "𐳲"), + (0x10CB3, "X"), + (0x10CC0, "V"), + (0x10CF3, "X"), + (0x10CFA, "V"), + (0x10D28, "X"), + (0x10D30, "V"), + (0x10D3A, "X"), + (0x10E60, "V"), + (0x10E7F, "X"), + (0x10E80, "V"), + (0x10EAA, "X"), + (0x10EAB, "V"), + (0x10EAE, "X"), + (0x10EB0, "V"), + (0x10EB2, "X"), + (0x10EFD, "V"), + (0x10F28, "X"), + (0x10F30, "V"), + (0x10F5A, "X"), + (0x10F70, "V"), + (0x10F8A, "X"), + (0x10FB0, "V"), + (0x10FCC, "X"), + (0x10FE0, "V"), + (0x10FF7, "X"), + (0x11000, "V"), + (0x1104E, "X"), + (0x11052, "V"), + (0x11076, "X"), + (0x1107F, "V"), + (0x110BD, "X"), + (0x110BE, "V"), + (0x110C3, "X"), + (0x110D0, "V"), + (0x110E9, "X"), + (0x110F0, "V"), + ] + + +def _seg_57() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x110FA, "X"), + (0x11100, "V"), + (0x11135, "X"), + (0x11136, "V"), + (0x11148, "X"), + (0x11150, "V"), + (0x11177, "X"), + (0x11180, "V"), + (0x111E0, "X"), + (0x111E1, "V"), + (0x111F5, "X"), + (0x11200, "V"), + (0x11212, "X"), + (0x11213, "V"), + (0x11242, "X"), + (0x11280, "V"), + (0x11287, "X"), + (0x11288, "V"), + (0x11289, "X"), + (0x1128A, "V"), + (0x1128E, "X"), + (0x1128F, "V"), + (0x1129E, "X"), + (0x1129F, "V"), + (0x112AA, "X"), + (0x112B0, "V"), + (0x112EB, "X"), + (0x112F0, "V"), + (0x112FA, "X"), + (0x11300, "V"), + (0x11304, "X"), + (0x11305, "V"), + (0x1130D, "X"), + (0x1130F, "V"), + (0x11311, "X"), + (0x11313, "V"), + (0x11329, "X"), + (0x1132A, "V"), + (0x11331, "X"), + (0x11332, "V"), + (0x11334, "X"), + (0x11335, "V"), + (0x1133A, "X"), + (0x1133B, "V"), + (0x11345, "X"), + (0x11347, "V"), + (0x11349, "X"), + (0x1134B, "V"), + (0x1134E, "X"), + (0x11350, "V"), + (0x11351, "X"), + (0x11357, "V"), + (0x11358, "X"), + (0x1135D, "V"), + (0x11364, "X"), + (0x11366, "V"), + (0x1136D, "X"), + (0x11370, "V"), + (0x11375, "X"), + (0x11400, "V"), + (0x1145C, "X"), + (0x1145D, "V"), + (0x11462, "X"), + (0x11480, "V"), + (0x114C8, "X"), + (0x114D0, "V"), + (0x114DA, "X"), + (0x11580, "V"), + (0x115B6, "X"), + (0x115B8, "V"), + (0x115DE, "X"), + (0x11600, "V"), + (0x11645, "X"), + (0x11650, "V"), + (0x1165A, "X"), + (0x11660, "V"), + (0x1166D, "X"), + (0x11680, "V"), + (0x116BA, "X"), + (0x116C0, "V"), + (0x116CA, "X"), + (0x11700, "V"), + (0x1171B, "X"), + (0x1171D, "V"), + (0x1172C, "X"), + (0x11730, "V"), + (0x11747, "X"), + (0x11800, "V"), + (0x1183C, "X"), + (0x118A0, "M", "𑣀"), + (0x118A1, "M", "𑣁"), + (0x118A2, "M", "𑣂"), + (0x118A3, "M", "𑣃"), + (0x118A4, "M", "𑣄"), + (0x118A5, "M", "𑣅"), + (0x118A6, "M", "𑣆"), + (0x118A7, "M", "𑣇"), + (0x118A8, "M", "𑣈"), + (0x118A9, "M", "𑣉"), + (0x118AA, "M", "𑣊"), + ] + + +def _seg_58() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x118AB, "M", "𑣋"), + (0x118AC, "M", "𑣌"), + (0x118AD, "M", "𑣍"), + (0x118AE, "M", "𑣎"), + (0x118AF, "M", "𑣏"), + (0x118B0, "M", "𑣐"), + (0x118B1, "M", "𑣑"), + (0x118B2, "M", "𑣒"), + (0x118B3, "M", "𑣓"), + (0x118B4, "M", "𑣔"), + (0x118B5, "M", "𑣕"), + (0x118B6, "M", "𑣖"), + (0x118B7, "M", "𑣗"), + (0x118B8, "M", "𑣘"), + (0x118B9, "M", "𑣙"), + (0x118BA, "M", "𑣚"), + (0x118BB, "M", "𑣛"), + (0x118BC, "M", "𑣜"), + (0x118BD, "M", "𑣝"), + (0x118BE, "M", "𑣞"), + (0x118BF, "M", "𑣟"), + (0x118C0, "V"), + (0x118F3, "X"), + (0x118FF, "V"), + (0x11907, "X"), + (0x11909, "V"), + (0x1190A, "X"), + (0x1190C, "V"), + (0x11914, "X"), + (0x11915, "V"), + (0x11917, "X"), + (0x11918, "V"), + (0x11936, "X"), + (0x11937, "V"), + (0x11939, "X"), + (0x1193B, "V"), + (0x11947, "X"), + (0x11950, "V"), + (0x1195A, "X"), + (0x119A0, "V"), + (0x119A8, "X"), + (0x119AA, "V"), + (0x119D8, "X"), + (0x119DA, "V"), + (0x119E5, "X"), + (0x11A00, "V"), + (0x11A48, "X"), + (0x11A50, "V"), + (0x11AA3, "X"), + (0x11AB0, "V"), + (0x11AF9, "X"), + (0x11B00, "V"), + (0x11B0A, "X"), + (0x11C00, "V"), + (0x11C09, "X"), + (0x11C0A, "V"), + (0x11C37, "X"), + (0x11C38, "V"), + (0x11C46, "X"), + (0x11C50, "V"), + (0x11C6D, "X"), + (0x11C70, "V"), + (0x11C90, "X"), + (0x11C92, "V"), + (0x11CA8, "X"), + (0x11CA9, "V"), + (0x11CB7, "X"), + (0x11D00, "V"), + (0x11D07, "X"), + (0x11D08, "V"), + (0x11D0A, "X"), + (0x11D0B, "V"), + (0x11D37, "X"), + (0x11D3A, "V"), + (0x11D3B, "X"), + (0x11D3C, "V"), + (0x11D3E, "X"), + (0x11D3F, "V"), + (0x11D48, "X"), + (0x11D50, "V"), + (0x11D5A, "X"), + (0x11D60, "V"), + (0x11D66, "X"), + (0x11D67, "V"), + (0x11D69, "X"), + (0x11D6A, "V"), + (0x11D8F, "X"), + (0x11D90, "V"), + (0x11D92, "X"), + (0x11D93, "V"), + (0x11D99, "X"), + (0x11DA0, "V"), + (0x11DAA, "X"), + (0x11EE0, "V"), + (0x11EF9, "X"), + (0x11F00, "V"), + (0x11F11, "X"), + (0x11F12, "V"), + (0x11F3B, "X"), + (0x11F3E, "V"), + ] + + +def _seg_59() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x11F5A, "X"), + (0x11FB0, "V"), + (0x11FB1, "X"), + (0x11FC0, "V"), + (0x11FF2, "X"), + (0x11FFF, "V"), + (0x1239A, "X"), + (0x12400, "V"), + (0x1246F, "X"), + (0x12470, "V"), + (0x12475, "X"), + (0x12480, "V"), + (0x12544, "X"), + (0x12F90, "V"), + (0x12FF3, "X"), + (0x13000, "V"), + (0x13430, "X"), + (0x13440, "V"), + (0x13456, "X"), + (0x14400, "V"), + (0x14647, "X"), + (0x16800, "V"), + (0x16A39, "X"), + (0x16A40, "V"), + (0x16A5F, "X"), + (0x16A60, "V"), + (0x16A6A, "X"), + (0x16A6E, "V"), + (0x16ABF, "X"), + (0x16AC0, "V"), + (0x16ACA, "X"), + (0x16AD0, "V"), + (0x16AEE, "X"), + (0x16AF0, "V"), + (0x16AF6, "X"), + (0x16B00, "V"), + (0x16B46, "X"), + (0x16B50, "V"), + (0x16B5A, "X"), + (0x16B5B, "V"), + (0x16B62, "X"), + (0x16B63, "V"), + (0x16B78, "X"), + (0x16B7D, "V"), + (0x16B90, "X"), + (0x16E40, "M", "𖹠"), + (0x16E41, "M", "𖹡"), + (0x16E42, "M", "𖹢"), + (0x16E43, "M", "𖹣"), + (0x16E44, "M", "𖹤"), + (0x16E45, "M", "𖹥"), + (0x16E46, "M", "𖹦"), + (0x16E47, "M", "𖹧"), + (0x16E48, "M", "𖹨"), + (0x16E49, "M", "𖹩"), + (0x16E4A, "M", "𖹪"), + (0x16E4B, "M", "𖹫"), + (0x16E4C, "M", "𖹬"), + (0x16E4D, "M", "𖹭"), + (0x16E4E, "M", "𖹮"), + (0x16E4F, "M", "𖹯"), + (0x16E50, "M", "𖹰"), + (0x16E51, "M", "𖹱"), + (0x16E52, "M", "𖹲"), + (0x16E53, "M", "𖹳"), + (0x16E54, "M", "𖹴"), + (0x16E55, "M", "𖹵"), + (0x16E56, "M", "𖹶"), + (0x16E57, "M", "𖹷"), + (0x16E58, "M", "𖹸"), + (0x16E59, "M", "𖹹"), + (0x16E5A, "M", "𖹺"), + (0x16E5B, "M", "𖹻"), + (0x16E5C, "M", "𖹼"), + (0x16E5D, "M", "𖹽"), + (0x16E5E, "M", "𖹾"), + (0x16E5F, "M", "𖹿"), + (0x16E60, "V"), + (0x16E9B, "X"), + (0x16F00, "V"), + (0x16F4B, "X"), + (0x16F4F, "V"), + (0x16F88, "X"), + (0x16F8F, "V"), + (0x16FA0, "X"), + (0x16FE0, "V"), + (0x16FE5, "X"), + (0x16FF0, "V"), + (0x16FF2, "X"), + (0x17000, "V"), + (0x187F8, "X"), + (0x18800, "V"), + (0x18CD6, "X"), + (0x18D00, "V"), + (0x18D09, "X"), + (0x1AFF0, "V"), + (0x1AFF4, "X"), + (0x1AFF5, "V"), + (0x1AFFC, "X"), + (0x1AFFD, "V"), + ] + + +def _seg_60() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x1AFFF, "X"), + (0x1B000, "V"), + (0x1B123, "X"), + (0x1B132, "V"), + (0x1B133, "X"), + (0x1B150, "V"), + (0x1B153, "X"), + (0x1B155, "V"), + (0x1B156, "X"), + (0x1B164, "V"), + (0x1B168, "X"), + (0x1B170, "V"), + (0x1B2FC, "X"), + (0x1BC00, "V"), + (0x1BC6B, "X"), + (0x1BC70, "V"), + (0x1BC7D, "X"), + (0x1BC80, "V"), + (0x1BC89, "X"), + (0x1BC90, "V"), + (0x1BC9A, "X"), + (0x1BC9C, "V"), + (0x1BCA0, "I"), + (0x1BCA4, "X"), + (0x1CF00, "V"), + (0x1CF2E, "X"), + (0x1CF30, "V"), + (0x1CF47, "X"), + (0x1CF50, "V"), + (0x1CFC4, "X"), + (0x1D000, "V"), + (0x1D0F6, "X"), + (0x1D100, "V"), + (0x1D127, "X"), + (0x1D129, "V"), + (0x1D15E, "M", "𝅗𝅥"), + (0x1D15F, "M", "𝅘𝅥"), + (0x1D160, "M", "𝅘𝅥𝅮"), + (0x1D161, "M", "𝅘𝅥𝅯"), + (0x1D162, "M", "𝅘𝅥𝅰"), + (0x1D163, "M", "𝅘𝅥𝅱"), + (0x1D164, "M", "𝅘𝅥𝅲"), + (0x1D165, "V"), + (0x1D173, "X"), + (0x1D17B, "V"), + (0x1D1BB, "M", "𝆹𝅥"), + (0x1D1BC, "M", "𝆺𝅥"), + (0x1D1BD, "M", "𝆹𝅥𝅮"), + (0x1D1BE, "M", "𝆺𝅥𝅮"), + (0x1D1BF, "M", "𝆹𝅥𝅯"), + (0x1D1C0, "M", "𝆺𝅥𝅯"), + (0x1D1C1, "V"), + (0x1D1EB, "X"), + (0x1D200, "V"), + (0x1D246, "X"), + (0x1D2C0, "V"), + (0x1D2D4, "X"), + (0x1D2E0, "V"), + (0x1D2F4, "X"), + (0x1D300, "V"), + (0x1D357, "X"), + (0x1D360, "V"), + (0x1D379, "X"), + (0x1D400, "M", "a"), + (0x1D401, "M", "b"), + (0x1D402, "M", "c"), + (0x1D403, "M", "d"), + (0x1D404, "M", "e"), + (0x1D405, "M", "f"), + (0x1D406, "M", "g"), + (0x1D407, "M", "h"), + (0x1D408, "M", "i"), + (0x1D409, "M", "j"), + (0x1D40A, "M", "k"), + (0x1D40B, "M", "l"), + (0x1D40C, "M", "m"), + (0x1D40D, "M", "n"), + (0x1D40E, "M", "o"), + (0x1D40F, "M", "p"), + (0x1D410, "M", "q"), + (0x1D411, "M", "r"), + (0x1D412, "M", "s"), + (0x1D413, "M", "t"), + (0x1D414, "M", "u"), + (0x1D415, "M", "v"), + (0x1D416, "M", "w"), + (0x1D417, "M", "x"), + (0x1D418, "M", "y"), + (0x1D419, "M", "z"), + (0x1D41A, "M", "a"), + (0x1D41B, "M", "b"), + (0x1D41C, "M", "c"), + (0x1D41D, "M", "d"), + (0x1D41E, "M", "e"), + (0x1D41F, "M", "f"), + (0x1D420, "M", "g"), + (0x1D421, "M", "h"), + (0x1D422, "M", "i"), + (0x1D423, "M", "j"), + (0x1D424, "M", "k"), + ] + + +def _seg_61() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x1D425, "M", "l"), + (0x1D426, "M", "m"), + (0x1D427, "M", "n"), + (0x1D428, "M", "o"), + (0x1D429, "M", "p"), + (0x1D42A, "M", "q"), + (0x1D42B, "M", "r"), + (0x1D42C, "M", "s"), + (0x1D42D, "M", "t"), + (0x1D42E, "M", "u"), + (0x1D42F, "M", "v"), + (0x1D430, "M", "w"), + (0x1D431, "M", "x"), + (0x1D432, "M", "y"), + (0x1D433, "M", "z"), + (0x1D434, "M", "a"), + (0x1D435, "M", "b"), + (0x1D436, "M", "c"), + (0x1D437, "M", "d"), + (0x1D438, "M", "e"), + (0x1D439, "M", "f"), + (0x1D43A, "M", "g"), + (0x1D43B, "M", "h"), + (0x1D43C, "M", "i"), + (0x1D43D, "M", "j"), + (0x1D43E, "M", "k"), + (0x1D43F, "M", "l"), + (0x1D440, "M", "m"), + (0x1D441, "M", "n"), + (0x1D442, "M", "o"), + (0x1D443, "M", "p"), + (0x1D444, "M", "q"), + (0x1D445, "M", "r"), + (0x1D446, "M", "s"), + (0x1D447, "M", "t"), + (0x1D448, "M", "u"), + (0x1D449, "M", "v"), + (0x1D44A, "M", "w"), + (0x1D44B, "M", "x"), + (0x1D44C, "M", "y"), + (0x1D44D, "M", "z"), + (0x1D44E, "M", "a"), + (0x1D44F, "M", "b"), + (0x1D450, "M", "c"), + (0x1D451, "M", "d"), + (0x1D452, "M", "e"), + (0x1D453, "M", "f"), + (0x1D454, "M", "g"), + (0x1D455, "X"), + (0x1D456, "M", "i"), + (0x1D457, "M", "j"), + (0x1D458, "M", "k"), + (0x1D459, "M", "l"), + (0x1D45A, "M", "m"), + (0x1D45B, "M", "n"), + (0x1D45C, "M", "o"), + (0x1D45D, "M", "p"), + (0x1D45E, "M", "q"), + (0x1D45F, "M", "r"), + (0x1D460, "M", "s"), + (0x1D461, "M", "t"), + (0x1D462, "M", "u"), + (0x1D463, "M", "v"), + (0x1D464, "M", "w"), + (0x1D465, "M", "x"), + (0x1D466, "M", "y"), + (0x1D467, "M", "z"), + (0x1D468, "M", "a"), + (0x1D469, "M", "b"), + (0x1D46A, "M", "c"), + (0x1D46B, "M", "d"), + (0x1D46C, "M", "e"), + (0x1D46D, "M", "f"), + (0x1D46E, "M", "g"), + (0x1D46F, "M", "h"), + (0x1D470, "M", "i"), + (0x1D471, "M", "j"), + (0x1D472, "M", "k"), + (0x1D473, "M", "l"), + (0x1D474, "M", "m"), + (0x1D475, "M", "n"), + (0x1D476, "M", "o"), + (0x1D477, "M", "p"), + (0x1D478, "M", "q"), + (0x1D479, "M", "r"), + (0x1D47A, "M", "s"), + (0x1D47B, "M", "t"), + (0x1D47C, "M", "u"), + (0x1D47D, "M", "v"), + (0x1D47E, "M", "w"), + (0x1D47F, "M", "x"), + (0x1D480, "M", "y"), + (0x1D481, "M", "z"), + (0x1D482, "M", "a"), + (0x1D483, "M", "b"), + (0x1D484, "M", "c"), + (0x1D485, "M", "d"), + (0x1D486, "M", "e"), + (0x1D487, "M", "f"), + (0x1D488, "M", "g"), + ] + + +def _seg_62() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x1D489, "M", "h"), + (0x1D48A, "M", "i"), + (0x1D48B, "M", "j"), + (0x1D48C, "M", "k"), + (0x1D48D, "M", "l"), + (0x1D48E, "M", "m"), + (0x1D48F, "M", "n"), + (0x1D490, "M", "o"), + (0x1D491, "M", "p"), + (0x1D492, "M", "q"), + (0x1D493, "M", "r"), + (0x1D494, "M", "s"), + (0x1D495, "M", "t"), + (0x1D496, "M", "u"), + (0x1D497, "M", "v"), + (0x1D498, "M", "w"), + (0x1D499, "M", "x"), + (0x1D49A, "M", "y"), + (0x1D49B, "M", "z"), + (0x1D49C, "M", "a"), + (0x1D49D, "X"), + (0x1D49E, "M", "c"), + (0x1D49F, "M", "d"), + (0x1D4A0, "X"), + (0x1D4A2, "M", "g"), + (0x1D4A3, "X"), + (0x1D4A5, "M", "j"), + (0x1D4A6, "M", "k"), + (0x1D4A7, "X"), + (0x1D4A9, "M", "n"), + (0x1D4AA, "M", "o"), + (0x1D4AB, "M", "p"), + (0x1D4AC, "M", "q"), + (0x1D4AD, "X"), + (0x1D4AE, "M", "s"), + (0x1D4AF, "M", "t"), + (0x1D4B0, "M", "u"), + (0x1D4B1, "M", "v"), + (0x1D4B2, "M", "w"), + (0x1D4B3, "M", "x"), + (0x1D4B4, "M", "y"), + (0x1D4B5, "M", "z"), + (0x1D4B6, "M", "a"), + (0x1D4B7, "M", "b"), + (0x1D4B8, "M", "c"), + (0x1D4B9, "M", "d"), + (0x1D4BA, "X"), + (0x1D4BB, "M", "f"), + (0x1D4BC, "X"), + (0x1D4BD, "M", "h"), + (0x1D4BE, "M", "i"), + (0x1D4BF, "M", "j"), + (0x1D4C0, "M", "k"), + (0x1D4C1, "M", "l"), + (0x1D4C2, "M", "m"), + (0x1D4C3, "M", "n"), + (0x1D4C4, "X"), + (0x1D4C5, "M", "p"), + (0x1D4C6, "M", "q"), + (0x1D4C7, "M", "r"), + (0x1D4C8, "M", "s"), + (0x1D4C9, "M", "t"), + (0x1D4CA, "M", "u"), + (0x1D4CB, "M", "v"), + (0x1D4CC, "M", "w"), + (0x1D4CD, "M", "x"), + (0x1D4CE, "M", "y"), + (0x1D4CF, "M", "z"), + (0x1D4D0, "M", "a"), + (0x1D4D1, "M", "b"), + (0x1D4D2, "M", "c"), + (0x1D4D3, "M", "d"), + (0x1D4D4, "M", "e"), + (0x1D4D5, "M", "f"), + (0x1D4D6, "M", "g"), + (0x1D4D7, "M", "h"), + (0x1D4D8, "M", "i"), + (0x1D4D9, "M", "j"), + (0x1D4DA, "M", "k"), + (0x1D4DB, "M", "l"), + (0x1D4DC, "M", "m"), + (0x1D4DD, "M", "n"), + (0x1D4DE, "M", "o"), + (0x1D4DF, "M", "p"), + (0x1D4E0, "M", "q"), + (0x1D4E1, "M", "r"), + (0x1D4E2, "M", "s"), + (0x1D4E3, "M", "t"), + (0x1D4E4, "M", "u"), + (0x1D4E5, "M", "v"), + (0x1D4E6, "M", "w"), + (0x1D4E7, "M", "x"), + (0x1D4E8, "M", "y"), + (0x1D4E9, "M", "z"), + (0x1D4EA, "M", "a"), + (0x1D4EB, "M", "b"), + (0x1D4EC, "M", "c"), + (0x1D4ED, "M", "d"), + (0x1D4EE, "M", "e"), + (0x1D4EF, "M", "f"), + ] + + +def _seg_63() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x1D4F0, "M", "g"), + (0x1D4F1, "M", "h"), + (0x1D4F2, "M", "i"), + (0x1D4F3, "M", "j"), + (0x1D4F4, "M", "k"), + (0x1D4F5, "M", "l"), + (0x1D4F6, "M", "m"), + (0x1D4F7, "M", "n"), + (0x1D4F8, "M", "o"), + (0x1D4F9, "M", "p"), + (0x1D4FA, "M", "q"), + (0x1D4FB, "M", "r"), + (0x1D4FC, "M", "s"), + (0x1D4FD, "M", "t"), + (0x1D4FE, "M", "u"), + (0x1D4FF, "M", "v"), + (0x1D500, "M", "w"), + (0x1D501, "M", "x"), + (0x1D502, "M", "y"), + (0x1D503, "M", "z"), + (0x1D504, "M", "a"), + (0x1D505, "M", "b"), + (0x1D506, "X"), + (0x1D507, "M", "d"), + (0x1D508, "M", "e"), + (0x1D509, "M", "f"), + (0x1D50A, "M", "g"), + (0x1D50B, "X"), + (0x1D50D, "M", "j"), + (0x1D50E, "M", "k"), + (0x1D50F, "M", "l"), + (0x1D510, "M", "m"), + (0x1D511, "M", "n"), + (0x1D512, "M", "o"), + (0x1D513, "M", "p"), + (0x1D514, "M", "q"), + (0x1D515, "X"), + (0x1D516, "M", "s"), + (0x1D517, "M", "t"), + (0x1D518, "M", "u"), + (0x1D519, "M", "v"), + (0x1D51A, "M", "w"), + (0x1D51B, "M", "x"), + (0x1D51C, "M", "y"), + (0x1D51D, "X"), + (0x1D51E, "M", "a"), + (0x1D51F, "M", "b"), + (0x1D520, "M", "c"), + (0x1D521, "M", "d"), + (0x1D522, "M", "e"), + (0x1D523, "M", "f"), + (0x1D524, "M", "g"), + (0x1D525, "M", "h"), + (0x1D526, "M", "i"), + (0x1D527, "M", "j"), + (0x1D528, "M", "k"), + (0x1D529, "M", "l"), + (0x1D52A, "M", "m"), + (0x1D52B, "M", "n"), + (0x1D52C, "M", "o"), + (0x1D52D, "M", "p"), + (0x1D52E, "M", "q"), + (0x1D52F, "M", "r"), + (0x1D530, "M", "s"), + (0x1D531, "M", "t"), + (0x1D532, "M", "u"), + (0x1D533, "M", "v"), + (0x1D534, "M", "w"), + (0x1D535, "M", "x"), + (0x1D536, "M", "y"), + (0x1D537, "M", "z"), + (0x1D538, "M", "a"), + (0x1D539, "M", "b"), + (0x1D53A, "X"), + (0x1D53B, "M", "d"), + (0x1D53C, "M", "e"), + (0x1D53D, "M", "f"), + (0x1D53E, "M", "g"), + (0x1D53F, "X"), + (0x1D540, "M", "i"), + (0x1D541, "M", "j"), + (0x1D542, "M", "k"), + (0x1D543, "M", "l"), + (0x1D544, "M", "m"), + (0x1D545, "X"), + (0x1D546, "M", "o"), + (0x1D547, "X"), + (0x1D54A, "M", "s"), + (0x1D54B, "M", "t"), + (0x1D54C, "M", "u"), + (0x1D54D, "M", "v"), + (0x1D54E, "M", "w"), + (0x1D54F, "M", "x"), + (0x1D550, "M", "y"), + (0x1D551, "X"), + (0x1D552, "M", "a"), + (0x1D553, "M", "b"), + (0x1D554, "M", "c"), + (0x1D555, "M", "d"), + (0x1D556, "M", "e"), + ] + + +def _seg_64() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x1D557, "M", "f"), + (0x1D558, "M", "g"), + (0x1D559, "M", "h"), + (0x1D55A, "M", "i"), + (0x1D55B, "M", "j"), + (0x1D55C, "M", "k"), + (0x1D55D, "M", "l"), + (0x1D55E, "M", "m"), + (0x1D55F, "M", "n"), + (0x1D560, "M", "o"), + (0x1D561, "M", "p"), + (0x1D562, "M", "q"), + (0x1D563, "M", "r"), + (0x1D564, "M", "s"), + (0x1D565, "M", "t"), + (0x1D566, "M", "u"), + (0x1D567, "M", "v"), + (0x1D568, "M", "w"), + (0x1D569, "M", "x"), + (0x1D56A, "M", "y"), + (0x1D56B, "M", "z"), + (0x1D56C, "M", "a"), + (0x1D56D, "M", "b"), + (0x1D56E, "M", "c"), + (0x1D56F, "M", "d"), + (0x1D570, "M", "e"), + (0x1D571, "M", "f"), + (0x1D572, "M", "g"), + (0x1D573, "M", "h"), + (0x1D574, "M", "i"), + (0x1D575, "M", "j"), + (0x1D576, "M", "k"), + (0x1D577, "M", "l"), + (0x1D578, "M", "m"), + (0x1D579, "M", "n"), + (0x1D57A, "M", "o"), + (0x1D57B, "M", "p"), + (0x1D57C, "M", "q"), + (0x1D57D, "M", "r"), + (0x1D57E, "M", "s"), + (0x1D57F, "M", "t"), + (0x1D580, "M", "u"), + (0x1D581, "M", "v"), + (0x1D582, "M", "w"), + (0x1D583, "M", "x"), + (0x1D584, "M", "y"), + (0x1D585, "M", "z"), + (0x1D586, "M", "a"), + (0x1D587, "M", "b"), + (0x1D588, "M", "c"), + (0x1D589, "M", "d"), + (0x1D58A, "M", "e"), + (0x1D58B, "M", "f"), + (0x1D58C, "M", "g"), + (0x1D58D, "M", "h"), + (0x1D58E, "M", "i"), + (0x1D58F, "M", "j"), + (0x1D590, "M", "k"), + (0x1D591, "M", "l"), + (0x1D592, "M", "m"), + (0x1D593, "M", "n"), + (0x1D594, "M", "o"), + (0x1D595, "M", "p"), + (0x1D596, "M", "q"), + (0x1D597, "M", "r"), + (0x1D598, "M", "s"), + (0x1D599, "M", "t"), + (0x1D59A, "M", "u"), + (0x1D59B, "M", "v"), + (0x1D59C, "M", "w"), + (0x1D59D, "M", "x"), + (0x1D59E, "M", "y"), + (0x1D59F, "M", "z"), + (0x1D5A0, "M", "a"), + (0x1D5A1, "M", "b"), + (0x1D5A2, "M", "c"), + (0x1D5A3, "M", "d"), + (0x1D5A4, "M", "e"), + (0x1D5A5, "M", "f"), + (0x1D5A6, "M", "g"), + (0x1D5A7, "M", "h"), + (0x1D5A8, "M", "i"), + (0x1D5A9, "M", "j"), + (0x1D5AA, "M", "k"), + (0x1D5AB, "M", "l"), + (0x1D5AC, "M", "m"), + (0x1D5AD, "M", "n"), + (0x1D5AE, "M", "o"), + (0x1D5AF, "M", "p"), + (0x1D5B0, "M", "q"), + (0x1D5B1, "M", "r"), + (0x1D5B2, "M", "s"), + (0x1D5B3, "M", "t"), + (0x1D5B4, "M", "u"), + (0x1D5B5, "M", "v"), + (0x1D5B6, "M", "w"), + (0x1D5B7, "M", "x"), + (0x1D5B8, "M", "y"), + (0x1D5B9, "M", "z"), + (0x1D5BA, "M", "a"), + ] + + +def _seg_65() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x1D5BB, "M", "b"), + (0x1D5BC, "M", "c"), + (0x1D5BD, "M", "d"), + (0x1D5BE, "M", "e"), + (0x1D5BF, "M", "f"), + (0x1D5C0, "M", "g"), + (0x1D5C1, "M", "h"), + (0x1D5C2, "M", "i"), + (0x1D5C3, "M", "j"), + (0x1D5C4, "M", "k"), + (0x1D5C5, "M", "l"), + (0x1D5C6, "M", "m"), + (0x1D5C7, "M", "n"), + (0x1D5C8, "M", "o"), + (0x1D5C9, "M", "p"), + (0x1D5CA, "M", "q"), + (0x1D5CB, "M", "r"), + (0x1D5CC, "M", "s"), + (0x1D5CD, "M", "t"), + (0x1D5CE, "M", "u"), + (0x1D5CF, "M", "v"), + (0x1D5D0, "M", "w"), + (0x1D5D1, "M", "x"), + (0x1D5D2, "M", "y"), + (0x1D5D3, "M", "z"), + (0x1D5D4, "M", "a"), + (0x1D5D5, "M", "b"), + (0x1D5D6, "M", "c"), + (0x1D5D7, "M", "d"), + (0x1D5D8, "M", "e"), + (0x1D5D9, "M", "f"), + (0x1D5DA, "M", "g"), + (0x1D5DB, "M", "h"), + (0x1D5DC, "M", "i"), + (0x1D5DD, "M", "j"), + (0x1D5DE, "M", "k"), + (0x1D5DF, "M", "l"), + (0x1D5E0, "M", "m"), + (0x1D5E1, "M", "n"), + (0x1D5E2, "M", "o"), + (0x1D5E3, "M", "p"), + (0x1D5E4, "M", "q"), + (0x1D5E5, "M", "r"), + (0x1D5E6, "M", "s"), + (0x1D5E7, "M", "t"), + (0x1D5E8, "M", "u"), + (0x1D5E9, "M", "v"), + (0x1D5EA, "M", "w"), + (0x1D5EB, "M", "x"), + (0x1D5EC, "M", "y"), + (0x1D5ED, "M", "z"), + (0x1D5EE, "M", "a"), + (0x1D5EF, "M", "b"), + (0x1D5F0, "M", "c"), + (0x1D5F1, "M", "d"), + (0x1D5F2, "M", "e"), + (0x1D5F3, "M", "f"), + (0x1D5F4, "M", "g"), + (0x1D5F5, "M", "h"), + (0x1D5F6, "M", "i"), + (0x1D5F7, "M", "j"), + (0x1D5F8, "M", "k"), + (0x1D5F9, "M", "l"), + (0x1D5FA, "M", "m"), + (0x1D5FB, "M", "n"), + (0x1D5FC, "M", "o"), + (0x1D5FD, "M", "p"), + (0x1D5FE, "M", "q"), + (0x1D5FF, "M", "r"), + (0x1D600, "M", "s"), + (0x1D601, "M", "t"), + (0x1D602, "M", "u"), + (0x1D603, "M", "v"), + (0x1D604, "M", "w"), + (0x1D605, "M", "x"), + (0x1D606, "M", "y"), + (0x1D607, "M", "z"), + (0x1D608, "M", "a"), + (0x1D609, "M", "b"), + (0x1D60A, "M", "c"), + (0x1D60B, "M", "d"), + (0x1D60C, "M", "e"), + (0x1D60D, "M", "f"), + (0x1D60E, "M", "g"), + (0x1D60F, "M", "h"), + (0x1D610, "M", "i"), + (0x1D611, "M", "j"), + (0x1D612, "M", "k"), + (0x1D613, "M", "l"), + (0x1D614, "M", "m"), + (0x1D615, "M", "n"), + (0x1D616, "M", "o"), + (0x1D617, "M", "p"), + (0x1D618, "M", "q"), + (0x1D619, "M", "r"), + (0x1D61A, "M", "s"), + (0x1D61B, "M", "t"), + (0x1D61C, "M", "u"), + (0x1D61D, "M", "v"), + (0x1D61E, "M", "w"), + ] + + +def _seg_66() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x1D61F, "M", "x"), + (0x1D620, "M", "y"), + (0x1D621, "M", "z"), + (0x1D622, "M", "a"), + (0x1D623, "M", "b"), + (0x1D624, "M", "c"), + (0x1D625, "M", "d"), + (0x1D626, "M", "e"), + (0x1D627, "M", "f"), + (0x1D628, "M", "g"), + (0x1D629, "M", "h"), + (0x1D62A, "M", "i"), + (0x1D62B, "M", "j"), + (0x1D62C, "M", "k"), + (0x1D62D, "M", "l"), + (0x1D62E, "M", "m"), + (0x1D62F, "M", "n"), + (0x1D630, "M", "o"), + (0x1D631, "M", "p"), + (0x1D632, "M", "q"), + (0x1D633, "M", "r"), + (0x1D634, "M", "s"), + (0x1D635, "M", "t"), + (0x1D636, "M", "u"), + (0x1D637, "M", "v"), + (0x1D638, "M", "w"), + (0x1D639, "M", "x"), + (0x1D63A, "M", "y"), + (0x1D63B, "M", "z"), + (0x1D63C, "M", "a"), + (0x1D63D, "M", "b"), + (0x1D63E, "M", "c"), + (0x1D63F, "M", "d"), + (0x1D640, "M", "e"), + (0x1D641, "M", "f"), + (0x1D642, "M", "g"), + (0x1D643, "M", "h"), + (0x1D644, "M", "i"), + (0x1D645, "M", "j"), + (0x1D646, "M", "k"), + (0x1D647, "M", "l"), + (0x1D648, "M", "m"), + (0x1D649, "M", "n"), + (0x1D64A, "M", "o"), + (0x1D64B, "M", "p"), + (0x1D64C, "M", "q"), + (0x1D64D, "M", "r"), + (0x1D64E, "M", "s"), + (0x1D64F, "M", "t"), + (0x1D650, "M", "u"), + (0x1D651, "M", "v"), + (0x1D652, "M", "w"), + (0x1D653, "M", "x"), + (0x1D654, "M", "y"), + (0x1D655, "M", "z"), + (0x1D656, "M", "a"), + (0x1D657, "M", "b"), + (0x1D658, "M", "c"), + (0x1D659, "M", "d"), + (0x1D65A, "M", "e"), + (0x1D65B, "M", "f"), + (0x1D65C, "M", "g"), + (0x1D65D, "M", "h"), + (0x1D65E, "M", "i"), + (0x1D65F, "M", "j"), + (0x1D660, "M", "k"), + (0x1D661, "M", "l"), + (0x1D662, "M", "m"), + (0x1D663, "M", "n"), + (0x1D664, "M", "o"), + (0x1D665, "M", "p"), + (0x1D666, "M", "q"), + (0x1D667, "M", "r"), + (0x1D668, "M", "s"), + (0x1D669, "M", "t"), + (0x1D66A, "M", "u"), + (0x1D66B, "M", "v"), + (0x1D66C, "M", "w"), + (0x1D66D, "M", "x"), + (0x1D66E, "M", "y"), + (0x1D66F, "M", "z"), + (0x1D670, "M", "a"), + (0x1D671, "M", "b"), + (0x1D672, "M", "c"), + (0x1D673, "M", "d"), + (0x1D674, "M", "e"), + (0x1D675, "M", "f"), + (0x1D676, "M", "g"), + (0x1D677, "M", "h"), + (0x1D678, "M", "i"), + (0x1D679, "M", "j"), + (0x1D67A, "M", "k"), + (0x1D67B, "M", "l"), + (0x1D67C, "M", "m"), + (0x1D67D, "M", "n"), + (0x1D67E, "M", "o"), + (0x1D67F, "M", "p"), + (0x1D680, "M", "q"), + (0x1D681, "M", "r"), + (0x1D682, "M", "s"), + ] + + +def _seg_67() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x1D683, "M", "t"), + (0x1D684, "M", "u"), + (0x1D685, "M", "v"), + (0x1D686, "M", "w"), + (0x1D687, "M", "x"), + (0x1D688, "M", "y"), + (0x1D689, "M", "z"), + (0x1D68A, "M", "a"), + (0x1D68B, "M", "b"), + (0x1D68C, "M", "c"), + (0x1D68D, "M", "d"), + (0x1D68E, "M", "e"), + (0x1D68F, "M", "f"), + (0x1D690, "M", "g"), + (0x1D691, "M", "h"), + (0x1D692, "M", "i"), + (0x1D693, "M", "j"), + (0x1D694, "M", "k"), + (0x1D695, "M", "l"), + (0x1D696, "M", "m"), + (0x1D697, "M", "n"), + (0x1D698, "M", "o"), + (0x1D699, "M", "p"), + (0x1D69A, "M", "q"), + (0x1D69B, "M", "r"), + (0x1D69C, "M", "s"), + (0x1D69D, "M", "t"), + (0x1D69E, "M", "u"), + (0x1D69F, "M", "v"), + (0x1D6A0, "M", "w"), + (0x1D6A1, "M", "x"), + (0x1D6A2, "M", "y"), + (0x1D6A3, "M", "z"), + (0x1D6A4, "M", "ı"), + (0x1D6A5, "M", "ȷ"), + (0x1D6A6, "X"), + (0x1D6A8, "M", "α"), + (0x1D6A9, "M", "β"), + (0x1D6AA, "M", "γ"), + (0x1D6AB, "M", "δ"), + (0x1D6AC, "M", "ε"), + (0x1D6AD, "M", "ζ"), + (0x1D6AE, "M", "η"), + (0x1D6AF, "M", "θ"), + (0x1D6B0, "M", "ι"), + (0x1D6B1, "M", "κ"), + (0x1D6B2, "M", "λ"), + (0x1D6B3, "M", "μ"), + (0x1D6B4, "M", "ν"), + (0x1D6B5, "M", "ξ"), + (0x1D6B6, "M", "ο"), + (0x1D6B7, "M", "π"), + (0x1D6B8, "M", "ρ"), + (0x1D6B9, "M", "θ"), + (0x1D6BA, "M", "σ"), + (0x1D6BB, "M", "τ"), + (0x1D6BC, "M", "υ"), + (0x1D6BD, "M", "φ"), + (0x1D6BE, "M", "χ"), + (0x1D6BF, "M", "ψ"), + (0x1D6C0, "M", "ω"), + (0x1D6C1, "M", "∇"), + (0x1D6C2, "M", "α"), + (0x1D6C3, "M", "β"), + (0x1D6C4, "M", "γ"), + (0x1D6C5, "M", "δ"), + (0x1D6C6, "M", "ε"), + (0x1D6C7, "M", "ζ"), + (0x1D6C8, "M", "η"), + (0x1D6C9, "M", "θ"), + (0x1D6CA, "M", "ι"), + (0x1D6CB, "M", "κ"), + (0x1D6CC, "M", "λ"), + (0x1D6CD, "M", "μ"), + (0x1D6CE, "M", "ν"), + (0x1D6CF, "M", "ξ"), + (0x1D6D0, "M", "ο"), + (0x1D6D1, "M", "π"), + (0x1D6D2, "M", "ρ"), + (0x1D6D3, "M", "σ"), + (0x1D6D5, "M", "τ"), + (0x1D6D6, "M", "υ"), + (0x1D6D7, "M", "φ"), + (0x1D6D8, "M", "χ"), + (0x1D6D9, "M", "ψ"), + (0x1D6DA, "M", "ω"), + (0x1D6DB, "M", "∂"), + (0x1D6DC, "M", "ε"), + (0x1D6DD, "M", "θ"), + (0x1D6DE, "M", "κ"), + (0x1D6DF, "M", "φ"), + (0x1D6E0, "M", "ρ"), + (0x1D6E1, "M", "π"), + (0x1D6E2, "M", "α"), + (0x1D6E3, "M", "β"), + (0x1D6E4, "M", "γ"), + (0x1D6E5, "M", "δ"), + (0x1D6E6, "M", "ε"), + (0x1D6E7, "M", "ζ"), + (0x1D6E8, "M", "η"), + ] + + +def _seg_68() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x1D6E9, "M", "θ"), + (0x1D6EA, "M", "ι"), + (0x1D6EB, "M", "κ"), + (0x1D6EC, "M", "λ"), + (0x1D6ED, "M", "μ"), + (0x1D6EE, "M", "ν"), + (0x1D6EF, "M", "ξ"), + (0x1D6F0, "M", "ο"), + (0x1D6F1, "M", "π"), + (0x1D6F2, "M", "ρ"), + (0x1D6F3, "M", "θ"), + (0x1D6F4, "M", "σ"), + (0x1D6F5, "M", "τ"), + (0x1D6F6, "M", "υ"), + (0x1D6F7, "M", "φ"), + (0x1D6F8, "M", "χ"), + (0x1D6F9, "M", "ψ"), + (0x1D6FA, "M", "ω"), + (0x1D6FB, "M", "∇"), + (0x1D6FC, "M", "α"), + (0x1D6FD, "M", "β"), + (0x1D6FE, "M", "γ"), + (0x1D6FF, "M", "δ"), + (0x1D700, "M", "ε"), + (0x1D701, "M", "ζ"), + (0x1D702, "M", "η"), + (0x1D703, "M", "θ"), + (0x1D704, "M", "ι"), + (0x1D705, "M", "κ"), + (0x1D706, "M", "λ"), + (0x1D707, "M", "μ"), + (0x1D708, "M", "ν"), + (0x1D709, "M", "ξ"), + (0x1D70A, "M", "ο"), + (0x1D70B, "M", "π"), + (0x1D70C, "M", "ρ"), + (0x1D70D, "M", "σ"), + (0x1D70F, "M", "τ"), + (0x1D710, "M", "υ"), + (0x1D711, "M", "φ"), + (0x1D712, "M", "χ"), + (0x1D713, "M", "ψ"), + (0x1D714, "M", "ω"), + (0x1D715, "M", "∂"), + (0x1D716, "M", "ε"), + (0x1D717, "M", "θ"), + (0x1D718, "M", "κ"), + (0x1D719, "M", "φ"), + (0x1D71A, "M", "ρ"), + (0x1D71B, "M", "π"), + (0x1D71C, "M", "α"), + (0x1D71D, "M", "β"), + (0x1D71E, "M", "γ"), + (0x1D71F, "M", "δ"), + (0x1D720, "M", "ε"), + (0x1D721, "M", "ζ"), + (0x1D722, "M", "η"), + (0x1D723, "M", "θ"), + (0x1D724, "M", "ι"), + (0x1D725, "M", "κ"), + (0x1D726, "M", "λ"), + (0x1D727, "M", "μ"), + (0x1D728, "M", "ν"), + (0x1D729, "M", "ξ"), + (0x1D72A, "M", "ο"), + (0x1D72B, "M", "π"), + (0x1D72C, "M", "ρ"), + (0x1D72D, "M", "θ"), + (0x1D72E, "M", "σ"), + (0x1D72F, "M", "τ"), + (0x1D730, "M", "υ"), + (0x1D731, "M", "φ"), + (0x1D732, "M", "χ"), + (0x1D733, "M", "ψ"), + (0x1D734, "M", "ω"), + (0x1D735, "M", "∇"), + (0x1D736, "M", "α"), + (0x1D737, "M", "β"), + (0x1D738, "M", "γ"), + (0x1D739, "M", "δ"), + (0x1D73A, "M", "ε"), + (0x1D73B, "M", "ζ"), + (0x1D73C, "M", "η"), + (0x1D73D, "M", "θ"), + (0x1D73E, "M", "ι"), + (0x1D73F, "M", "κ"), + (0x1D740, "M", "λ"), + (0x1D741, "M", "μ"), + (0x1D742, "M", "ν"), + (0x1D743, "M", "ξ"), + (0x1D744, "M", "ο"), + (0x1D745, "M", "π"), + (0x1D746, "M", "ρ"), + (0x1D747, "M", "σ"), + (0x1D749, "M", "τ"), + (0x1D74A, "M", "υ"), + (0x1D74B, "M", "φ"), + (0x1D74C, "M", "χ"), + (0x1D74D, "M", "ψ"), + (0x1D74E, "M", "ω"), + ] + + +def _seg_69() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x1D74F, "M", "∂"), + (0x1D750, "M", "ε"), + (0x1D751, "M", "θ"), + (0x1D752, "M", "κ"), + (0x1D753, "M", "φ"), + (0x1D754, "M", "ρ"), + (0x1D755, "M", "π"), + (0x1D756, "M", "α"), + (0x1D757, "M", "β"), + (0x1D758, "M", "γ"), + (0x1D759, "M", "δ"), + (0x1D75A, "M", "ε"), + (0x1D75B, "M", "ζ"), + (0x1D75C, "M", "η"), + (0x1D75D, "M", "θ"), + (0x1D75E, "M", "ι"), + (0x1D75F, "M", "κ"), + (0x1D760, "M", "λ"), + (0x1D761, "M", "μ"), + (0x1D762, "M", "ν"), + (0x1D763, "M", "ξ"), + (0x1D764, "M", "ο"), + (0x1D765, "M", "π"), + (0x1D766, "M", "ρ"), + (0x1D767, "M", "θ"), + (0x1D768, "M", "σ"), + (0x1D769, "M", "τ"), + (0x1D76A, "M", "υ"), + (0x1D76B, "M", "φ"), + (0x1D76C, "M", "χ"), + (0x1D76D, "M", "ψ"), + (0x1D76E, "M", "ω"), + (0x1D76F, "M", "∇"), + (0x1D770, "M", "α"), + (0x1D771, "M", "β"), + (0x1D772, "M", "γ"), + (0x1D773, "M", "δ"), + (0x1D774, "M", "ε"), + (0x1D775, "M", "ζ"), + (0x1D776, "M", "η"), + (0x1D777, "M", "θ"), + (0x1D778, "M", "ι"), + (0x1D779, "M", "κ"), + (0x1D77A, "M", "λ"), + (0x1D77B, "M", "μ"), + (0x1D77C, "M", "ν"), + (0x1D77D, "M", "ξ"), + (0x1D77E, "M", "ο"), + (0x1D77F, "M", "π"), + (0x1D780, "M", "ρ"), + (0x1D781, "M", "σ"), + (0x1D783, "M", "τ"), + (0x1D784, "M", "υ"), + (0x1D785, "M", "φ"), + (0x1D786, "M", "χ"), + (0x1D787, "M", "ψ"), + (0x1D788, "M", "ω"), + (0x1D789, "M", "∂"), + (0x1D78A, "M", "ε"), + (0x1D78B, "M", "θ"), + (0x1D78C, "M", "κ"), + (0x1D78D, "M", "φ"), + (0x1D78E, "M", "ρ"), + (0x1D78F, "M", "π"), + (0x1D790, "M", "α"), + (0x1D791, "M", "β"), + (0x1D792, "M", "γ"), + (0x1D793, "M", "δ"), + (0x1D794, "M", "ε"), + (0x1D795, "M", "ζ"), + (0x1D796, "M", "η"), + (0x1D797, "M", "θ"), + (0x1D798, "M", "ι"), + (0x1D799, "M", "κ"), + (0x1D79A, "M", "λ"), + (0x1D79B, "M", "μ"), + (0x1D79C, "M", "ν"), + (0x1D79D, "M", "ξ"), + (0x1D79E, "M", "ο"), + (0x1D79F, "M", "π"), + (0x1D7A0, "M", "ρ"), + (0x1D7A1, "M", "θ"), + (0x1D7A2, "M", "σ"), + (0x1D7A3, "M", "τ"), + (0x1D7A4, "M", "υ"), + (0x1D7A5, "M", "φ"), + (0x1D7A6, "M", "χ"), + (0x1D7A7, "M", "ψ"), + (0x1D7A8, "M", "ω"), + (0x1D7A9, "M", "∇"), + (0x1D7AA, "M", "α"), + (0x1D7AB, "M", "β"), + (0x1D7AC, "M", "γ"), + (0x1D7AD, "M", "δ"), + (0x1D7AE, "M", "ε"), + (0x1D7AF, "M", "ζ"), + (0x1D7B0, "M", "η"), + (0x1D7B1, "M", "θ"), + (0x1D7B2, "M", "ι"), + (0x1D7B3, "M", "κ"), + ] + + +def _seg_70() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x1D7B4, "M", "λ"), + (0x1D7B5, "M", "μ"), + (0x1D7B6, "M", "ν"), + (0x1D7B7, "M", "ξ"), + (0x1D7B8, "M", "ο"), + (0x1D7B9, "M", "π"), + (0x1D7BA, "M", "ρ"), + (0x1D7BB, "M", "σ"), + (0x1D7BD, "M", "τ"), + (0x1D7BE, "M", "υ"), + (0x1D7BF, "M", "φ"), + (0x1D7C0, "M", "χ"), + (0x1D7C1, "M", "ψ"), + (0x1D7C2, "M", "ω"), + (0x1D7C3, "M", "∂"), + (0x1D7C4, "M", "ε"), + (0x1D7C5, "M", "θ"), + (0x1D7C6, "M", "κ"), + (0x1D7C7, "M", "φ"), + (0x1D7C8, "M", "ρ"), + (0x1D7C9, "M", "π"), + (0x1D7CA, "M", "ϝ"), + (0x1D7CC, "X"), + (0x1D7CE, "M", "0"), + (0x1D7CF, "M", "1"), + (0x1D7D0, "M", "2"), + (0x1D7D1, "M", "3"), + (0x1D7D2, "M", "4"), + (0x1D7D3, "M", "5"), + (0x1D7D4, "M", "6"), + (0x1D7D5, "M", "7"), + (0x1D7D6, "M", "8"), + (0x1D7D7, "M", "9"), + (0x1D7D8, "M", "0"), + (0x1D7D9, "M", "1"), + (0x1D7DA, "M", "2"), + (0x1D7DB, "M", "3"), + (0x1D7DC, "M", "4"), + (0x1D7DD, "M", "5"), + (0x1D7DE, "M", "6"), + (0x1D7DF, "M", "7"), + (0x1D7E0, "M", "8"), + (0x1D7E1, "M", "9"), + (0x1D7E2, "M", "0"), + (0x1D7E3, "M", "1"), + (0x1D7E4, "M", "2"), + (0x1D7E5, "M", "3"), + (0x1D7E6, "M", "4"), + (0x1D7E7, "M", "5"), + (0x1D7E8, "M", "6"), + (0x1D7E9, "M", "7"), + (0x1D7EA, "M", "8"), + (0x1D7EB, "M", "9"), + (0x1D7EC, "M", "0"), + (0x1D7ED, "M", "1"), + (0x1D7EE, "M", "2"), + (0x1D7EF, "M", "3"), + (0x1D7F0, "M", "4"), + (0x1D7F1, "M", "5"), + (0x1D7F2, "M", "6"), + (0x1D7F3, "M", "7"), + (0x1D7F4, "M", "8"), + (0x1D7F5, "M", "9"), + (0x1D7F6, "M", "0"), + (0x1D7F7, "M", "1"), + (0x1D7F8, "M", "2"), + (0x1D7F9, "M", "3"), + (0x1D7FA, "M", "4"), + (0x1D7FB, "M", "5"), + (0x1D7FC, "M", "6"), + (0x1D7FD, "M", "7"), + (0x1D7FE, "M", "8"), + (0x1D7FF, "M", "9"), + (0x1D800, "V"), + (0x1DA8C, "X"), + (0x1DA9B, "V"), + (0x1DAA0, "X"), + (0x1DAA1, "V"), + (0x1DAB0, "X"), + (0x1DF00, "V"), + (0x1DF1F, "X"), + (0x1DF25, "V"), + (0x1DF2B, "X"), + (0x1E000, "V"), + (0x1E007, "X"), + (0x1E008, "V"), + (0x1E019, "X"), + (0x1E01B, "V"), + (0x1E022, "X"), + (0x1E023, "V"), + (0x1E025, "X"), + (0x1E026, "V"), + (0x1E02B, "X"), + (0x1E030, "M", "а"), + (0x1E031, "M", "б"), + (0x1E032, "M", "в"), + (0x1E033, "M", "г"), + (0x1E034, "M", "д"), + (0x1E035, "M", "е"), + (0x1E036, "M", "ж"), + ] + + +def _seg_71() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x1E037, "M", "з"), + (0x1E038, "M", "и"), + (0x1E039, "M", "к"), + (0x1E03A, "M", "л"), + (0x1E03B, "M", "м"), + (0x1E03C, "M", "о"), + (0x1E03D, "M", "п"), + (0x1E03E, "M", "р"), + (0x1E03F, "M", "с"), + (0x1E040, "M", "т"), + (0x1E041, "M", "у"), + (0x1E042, "M", "ф"), + (0x1E043, "M", "х"), + (0x1E044, "M", "ц"), + (0x1E045, "M", "ч"), + (0x1E046, "M", "ш"), + (0x1E047, "M", "ы"), + (0x1E048, "M", "э"), + (0x1E049, "M", "ю"), + (0x1E04A, "M", "ꚉ"), + (0x1E04B, "M", "ә"), + (0x1E04C, "M", "і"), + (0x1E04D, "M", "ј"), + (0x1E04E, "M", "ө"), + (0x1E04F, "M", "ү"), + (0x1E050, "M", "ӏ"), + (0x1E051, "M", "а"), + (0x1E052, "M", "б"), + (0x1E053, "M", "в"), + (0x1E054, "M", "г"), + (0x1E055, "M", "д"), + (0x1E056, "M", "е"), + (0x1E057, "M", "ж"), + (0x1E058, "M", "з"), + (0x1E059, "M", "и"), + (0x1E05A, "M", "к"), + (0x1E05B, "M", "л"), + (0x1E05C, "M", "о"), + (0x1E05D, "M", "п"), + (0x1E05E, "M", "с"), + (0x1E05F, "M", "у"), + (0x1E060, "M", "ф"), + (0x1E061, "M", "х"), + (0x1E062, "M", "ц"), + (0x1E063, "M", "ч"), + (0x1E064, "M", "ш"), + (0x1E065, "M", "ъ"), + (0x1E066, "M", "ы"), + (0x1E067, "M", "ґ"), + (0x1E068, "M", "і"), + (0x1E069, "M", "ѕ"), + (0x1E06A, "M", "џ"), + (0x1E06B, "M", "ҫ"), + (0x1E06C, "M", "ꙑ"), + (0x1E06D, "M", "ұ"), + (0x1E06E, "X"), + (0x1E08F, "V"), + (0x1E090, "X"), + (0x1E100, "V"), + (0x1E12D, "X"), + (0x1E130, "V"), + (0x1E13E, "X"), + (0x1E140, "V"), + (0x1E14A, "X"), + (0x1E14E, "V"), + (0x1E150, "X"), + (0x1E290, "V"), + (0x1E2AF, "X"), + (0x1E2C0, "V"), + (0x1E2FA, "X"), + (0x1E2FF, "V"), + (0x1E300, "X"), + (0x1E4D0, "V"), + (0x1E4FA, "X"), + (0x1E7E0, "V"), + (0x1E7E7, "X"), + (0x1E7E8, "V"), + (0x1E7EC, "X"), + (0x1E7ED, "V"), + (0x1E7EF, "X"), + (0x1E7F0, "V"), + (0x1E7FF, "X"), + (0x1E800, "V"), + (0x1E8C5, "X"), + (0x1E8C7, "V"), + (0x1E8D7, "X"), + (0x1E900, "M", "𞤢"), + (0x1E901, "M", "𞤣"), + (0x1E902, "M", "𞤤"), + (0x1E903, "M", "𞤥"), + (0x1E904, "M", "𞤦"), + (0x1E905, "M", "𞤧"), + (0x1E906, "M", "𞤨"), + (0x1E907, "M", "𞤩"), + (0x1E908, "M", "𞤪"), + (0x1E909, "M", "𞤫"), + (0x1E90A, "M", "𞤬"), + (0x1E90B, "M", "𞤭"), + (0x1E90C, "M", "𞤮"), + (0x1E90D, "M", "𞤯"), + ] + + +def _seg_72() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x1E90E, "M", "𞤰"), + (0x1E90F, "M", "𞤱"), + (0x1E910, "M", "𞤲"), + (0x1E911, "M", "𞤳"), + (0x1E912, "M", "𞤴"), + (0x1E913, "M", "𞤵"), + (0x1E914, "M", "𞤶"), + (0x1E915, "M", "𞤷"), + (0x1E916, "M", "𞤸"), + (0x1E917, "M", "𞤹"), + (0x1E918, "M", "𞤺"), + (0x1E919, "M", "𞤻"), + (0x1E91A, "M", "𞤼"), + (0x1E91B, "M", "𞤽"), + (0x1E91C, "M", "𞤾"), + (0x1E91D, "M", "𞤿"), + (0x1E91E, "M", "𞥀"), + (0x1E91F, "M", "𞥁"), + (0x1E920, "M", "𞥂"), + (0x1E921, "M", "𞥃"), + (0x1E922, "V"), + (0x1E94C, "X"), + (0x1E950, "V"), + (0x1E95A, "X"), + (0x1E95E, "V"), + (0x1E960, "X"), + (0x1EC71, "V"), + (0x1ECB5, "X"), + (0x1ED01, "V"), + (0x1ED3E, "X"), + (0x1EE00, "M", "ا"), + (0x1EE01, "M", "ب"), + (0x1EE02, "M", "ج"), + (0x1EE03, "M", "د"), + (0x1EE04, "X"), + (0x1EE05, "M", "و"), + (0x1EE06, "M", "ز"), + (0x1EE07, "M", "ح"), + (0x1EE08, "M", "ط"), + (0x1EE09, "M", "ي"), + (0x1EE0A, "M", "ك"), + (0x1EE0B, "M", "ل"), + (0x1EE0C, "M", "م"), + (0x1EE0D, "M", "ن"), + (0x1EE0E, "M", "س"), + (0x1EE0F, "M", "ع"), + (0x1EE10, "M", "ف"), + (0x1EE11, "M", "ص"), + (0x1EE12, "M", "ق"), + (0x1EE13, "M", "ر"), + (0x1EE14, "M", "ش"), + (0x1EE15, "M", "ت"), + (0x1EE16, "M", "ث"), + (0x1EE17, "M", "خ"), + (0x1EE18, "M", "ذ"), + (0x1EE19, "M", "ض"), + (0x1EE1A, "M", "ظ"), + (0x1EE1B, "M", "غ"), + (0x1EE1C, "M", "ٮ"), + (0x1EE1D, "M", "ں"), + (0x1EE1E, "M", "ڡ"), + (0x1EE1F, "M", "ٯ"), + (0x1EE20, "X"), + (0x1EE21, "M", "ب"), + (0x1EE22, "M", "ج"), + (0x1EE23, "X"), + (0x1EE24, "M", "ه"), + (0x1EE25, "X"), + (0x1EE27, "M", "ح"), + (0x1EE28, "X"), + (0x1EE29, "M", "ي"), + (0x1EE2A, "M", "ك"), + (0x1EE2B, "M", "ل"), + (0x1EE2C, "M", "م"), + (0x1EE2D, "M", "ن"), + (0x1EE2E, "M", "س"), + (0x1EE2F, "M", "ع"), + (0x1EE30, "M", "ف"), + (0x1EE31, "M", "ص"), + (0x1EE32, "M", "ق"), + (0x1EE33, "X"), + (0x1EE34, "M", "ش"), + (0x1EE35, "M", "ت"), + (0x1EE36, "M", "ث"), + (0x1EE37, "M", "خ"), + (0x1EE38, "X"), + (0x1EE39, "M", "ض"), + (0x1EE3A, "X"), + (0x1EE3B, "M", "غ"), + (0x1EE3C, "X"), + (0x1EE42, "M", "ج"), + (0x1EE43, "X"), + (0x1EE47, "M", "ح"), + (0x1EE48, "X"), + (0x1EE49, "M", "ي"), + (0x1EE4A, "X"), + (0x1EE4B, "M", "ل"), + (0x1EE4C, "X"), + (0x1EE4D, "M", "ن"), + (0x1EE4E, "M", "س"), + ] + + +def _seg_73() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x1EE4F, "M", "ع"), + (0x1EE50, "X"), + (0x1EE51, "M", "ص"), + (0x1EE52, "M", "ق"), + (0x1EE53, "X"), + (0x1EE54, "M", "ش"), + (0x1EE55, "X"), + (0x1EE57, "M", "خ"), + (0x1EE58, "X"), + (0x1EE59, "M", "ض"), + (0x1EE5A, "X"), + (0x1EE5B, "M", "غ"), + (0x1EE5C, "X"), + (0x1EE5D, "M", "ں"), + (0x1EE5E, "X"), + (0x1EE5F, "M", "ٯ"), + (0x1EE60, "X"), + (0x1EE61, "M", "ب"), + (0x1EE62, "M", "ج"), + (0x1EE63, "X"), + (0x1EE64, "M", "ه"), + (0x1EE65, "X"), + (0x1EE67, "M", "ح"), + (0x1EE68, "M", "ط"), + (0x1EE69, "M", "ي"), + (0x1EE6A, "M", "ك"), + (0x1EE6B, "X"), + (0x1EE6C, "M", "م"), + (0x1EE6D, "M", "ن"), + (0x1EE6E, "M", "س"), + (0x1EE6F, "M", "ع"), + (0x1EE70, "M", "ف"), + (0x1EE71, "M", "ص"), + (0x1EE72, "M", "ق"), + (0x1EE73, "X"), + (0x1EE74, "M", "ش"), + (0x1EE75, "M", "ت"), + (0x1EE76, "M", "ث"), + (0x1EE77, "M", "خ"), + (0x1EE78, "X"), + (0x1EE79, "M", "ض"), + (0x1EE7A, "M", "ظ"), + (0x1EE7B, "M", "غ"), + (0x1EE7C, "M", "ٮ"), + (0x1EE7D, "X"), + (0x1EE7E, "M", "ڡ"), + (0x1EE7F, "X"), + (0x1EE80, "M", "ا"), + (0x1EE81, "M", "ب"), + (0x1EE82, "M", "ج"), + (0x1EE83, "M", "د"), + (0x1EE84, "M", "ه"), + (0x1EE85, "M", "و"), + (0x1EE86, "M", "ز"), + (0x1EE87, "M", "ح"), + (0x1EE88, "M", "ط"), + (0x1EE89, "M", "ي"), + (0x1EE8A, "X"), + (0x1EE8B, "M", "ل"), + (0x1EE8C, "M", "م"), + (0x1EE8D, "M", "ن"), + (0x1EE8E, "M", "س"), + (0x1EE8F, "M", "ع"), + (0x1EE90, "M", "ف"), + (0x1EE91, "M", "ص"), + (0x1EE92, "M", "ق"), + (0x1EE93, "M", "ر"), + (0x1EE94, "M", "ش"), + (0x1EE95, "M", "ت"), + (0x1EE96, "M", "ث"), + (0x1EE97, "M", "خ"), + (0x1EE98, "M", "ذ"), + (0x1EE99, "M", "ض"), + (0x1EE9A, "M", "ظ"), + (0x1EE9B, "M", "غ"), + (0x1EE9C, "X"), + (0x1EEA1, "M", "ب"), + (0x1EEA2, "M", "ج"), + (0x1EEA3, "M", "د"), + (0x1EEA4, "X"), + (0x1EEA5, "M", "و"), + (0x1EEA6, "M", "ز"), + (0x1EEA7, "M", "ح"), + (0x1EEA8, "M", "ط"), + (0x1EEA9, "M", "ي"), + (0x1EEAA, "X"), + (0x1EEAB, "M", "ل"), + (0x1EEAC, "M", "م"), + (0x1EEAD, "M", "ن"), + (0x1EEAE, "M", "س"), + (0x1EEAF, "M", "ع"), + (0x1EEB0, "M", "ف"), + (0x1EEB1, "M", "ص"), + (0x1EEB2, "M", "ق"), + (0x1EEB3, "M", "ر"), + (0x1EEB4, "M", "ش"), + (0x1EEB5, "M", "ت"), + (0x1EEB6, "M", "ث"), + (0x1EEB7, "M", "خ"), + (0x1EEB8, "M", "ذ"), + ] + + +def _seg_74() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x1EEB9, "M", "ض"), + (0x1EEBA, "M", "ظ"), + (0x1EEBB, "M", "غ"), + (0x1EEBC, "X"), + (0x1EEF0, "V"), + (0x1EEF2, "X"), + (0x1F000, "V"), + (0x1F02C, "X"), + (0x1F030, "V"), + (0x1F094, "X"), + (0x1F0A0, "V"), + (0x1F0AF, "X"), + (0x1F0B1, "V"), + (0x1F0C0, "X"), + (0x1F0C1, "V"), + (0x1F0D0, "X"), + (0x1F0D1, "V"), + (0x1F0F6, "X"), + (0x1F101, "3", "0,"), + (0x1F102, "3", "1,"), + (0x1F103, "3", "2,"), + (0x1F104, "3", "3,"), + (0x1F105, "3", "4,"), + (0x1F106, "3", "5,"), + (0x1F107, "3", "6,"), + (0x1F108, "3", "7,"), + (0x1F109, "3", "8,"), + (0x1F10A, "3", "9,"), + (0x1F10B, "V"), + (0x1F110, "3", "(a)"), + (0x1F111, "3", "(b)"), + (0x1F112, "3", "(c)"), + (0x1F113, "3", "(d)"), + (0x1F114, "3", "(e)"), + (0x1F115, "3", "(f)"), + (0x1F116, "3", "(g)"), + (0x1F117, "3", "(h)"), + (0x1F118, "3", "(i)"), + (0x1F119, "3", "(j)"), + (0x1F11A, "3", "(k)"), + (0x1F11B, "3", "(l)"), + (0x1F11C, "3", "(m)"), + (0x1F11D, "3", "(n)"), + (0x1F11E, "3", "(o)"), + (0x1F11F, "3", "(p)"), + (0x1F120, "3", "(q)"), + (0x1F121, "3", "(r)"), + (0x1F122, "3", "(s)"), + (0x1F123, "3", "(t)"), + (0x1F124, "3", "(u)"), + (0x1F125, "3", "(v)"), + (0x1F126, "3", "(w)"), + (0x1F127, "3", "(x)"), + (0x1F128, "3", "(y)"), + (0x1F129, "3", "(z)"), + (0x1F12A, "M", "〔s〕"), + (0x1F12B, "M", "c"), + (0x1F12C, "M", "r"), + (0x1F12D, "M", "cd"), + (0x1F12E, "M", "wz"), + (0x1F12F, "V"), + (0x1F130, "M", "a"), + (0x1F131, "M", "b"), + (0x1F132, "M", "c"), + (0x1F133, "M", "d"), + (0x1F134, "M", "e"), + (0x1F135, "M", "f"), + (0x1F136, "M", "g"), + (0x1F137, "M", "h"), + (0x1F138, "M", "i"), + (0x1F139, "M", "j"), + (0x1F13A, "M", "k"), + (0x1F13B, "M", "l"), + (0x1F13C, "M", "m"), + (0x1F13D, "M", "n"), + (0x1F13E, "M", "o"), + (0x1F13F, "M", "p"), + (0x1F140, "M", "q"), + (0x1F141, "M", "r"), + (0x1F142, "M", "s"), + (0x1F143, "M", "t"), + (0x1F144, "M", "u"), + (0x1F145, "M", "v"), + (0x1F146, "M", "w"), + (0x1F147, "M", "x"), + (0x1F148, "M", "y"), + (0x1F149, "M", "z"), + (0x1F14A, "M", "hv"), + (0x1F14B, "M", "mv"), + (0x1F14C, "M", "sd"), + (0x1F14D, "M", "ss"), + (0x1F14E, "M", "ppv"), + (0x1F14F, "M", "wc"), + (0x1F150, "V"), + (0x1F16A, "M", "mc"), + (0x1F16B, "M", "md"), + (0x1F16C, "M", "mr"), + (0x1F16D, "V"), + (0x1F190, "M", "dj"), + (0x1F191, "V"), + ] + + +def _seg_75() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x1F1AE, "X"), + (0x1F1E6, "V"), + (0x1F200, "M", "ほか"), + (0x1F201, "M", "ココ"), + (0x1F202, "M", "サ"), + (0x1F203, "X"), + (0x1F210, "M", "手"), + (0x1F211, "M", "字"), + (0x1F212, "M", "双"), + (0x1F213, "M", "デ"), + (0x1F214, "M", "二"), + (0x1F215, "M", "多"), + (0x1F216, "M", "解"), + (0x1F217, "M", "天"), + (0x1F218, "M", "交"), + (0x1F219, "M", "映"), + (0x1F21A, "M", "無"), + (0x1F21B, "M", "料"), + (0x1F21C, "M", "前"), + (0x1F21D, "M", "後"), + (0x1F21E, "M", "再"), + (0x1F21F, "M", "新"), + (0x1F220, "M", "初"), + (0x1F221, "M", "終"), + (0x1F222, "M", "生"), + (0x1F223, "M", "販"), + (0x1F224, "M", "声"), + (0x1F225, "M", "吹"), + (0x1F226, "M", "演"), + (0x1F227, "M", "投"), + (0x1F228, "M", "捕"), + (0x1F229, "M", "一"), + (0x1F22A, "M", "三"), + (0x1F22B, "M", "遊"), + (0x1F22C, "M", "左"), + (0x1F22D, "M", "中"), + (0x1F22E, "M", "右"), + (0x1F22F, "M", "指"), + (0x1F230, "M", "走"), + (0x1F231, "M", "打"), + (0x1F232, "M", "禁"), + (0x1F233, "M", "空"), + (0x1F234, "M", "合"), + (0x1F235, "M", "満"), + (0x1F236, "M", "有"), + (0x1F237, "M", "月"), + (0x1F238, "M", "申"), + (0x1F239, "M", "割"), + (0x1F23A, "M", "営"), + (0x1F23B, "M", "配"), + (0x1F23C, "X"), + (0x1F240, "M", "〔本〕"), + (0x1F241, "M", "〔三〕"), + (0x1F242, "M", "〔二〕"), + (0x1F243, "M", "〔安〕"), + (0x1F244, "M", "〔点〕"), + (0x1F245, "M", "〔打〕"), + (0x1F246, "M", "〔盗〕"), + (0x1F247, "M", "〔勝〕"), + (0x1F248, "M", "〔敗〕"), + (0x1F249, "X"), + (0x1F250, "M", "得"), + (0x1F251, "M", "可"), + (0x1F252, "X"), + (0x1F260, "V"), + (0x1F266, "X"), + (0x1F300, "V"), + (0x1F6D8, "X"), + (0x1F6DC, "V"), + (0x1F6ED, "X"), + (0x1F6F0, "V"), + (0x1F6FD, "X"), + (0x1F700, "V"), + (0x1F777, "X"), + (0x1F77B, "V"), + (0x1F7DA, "X"), + (0x1F7E0, "V"), + (0x1F7EC, "X"), + (0x1F7F0, "V"), + (0x1F7F1, "X"), + (0x1F800, "V"), + (0x1F80C, "X"), + (0x1F810, "V"), + (0x1F848, "X"), + (0x1F850, "V"), + (0x1F85A, "X"), + (0x1F860, "V"), + (0x1F888, "X"), + (0x1F890, "V"), + (0x1F8AE, "X"), + (0x1F8B0, "V"), + (0x1F8B2, "X"), + (0x1F900, "V"), + (0x1FA54, "X"), + (0x1FA60, "V"), + (0x1FA6E, "X"), + (0x1FA70, "V"), + (0x1FA7D, "X"), + (0x1FA80, "V"), + (0x1FA89, "X"), + ] + + +def _seg_76() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x1FA90, "V"), + (0x1FABE, "X"), + (0x1FABF, "V"), + (0x1FAC6, "X"), + (0x1FACE, "V"), + (0x1FADC, "X"), + (0x1FAE0, "V"), + (0x1FAE9, "X"), + (0x1FAF0, "V"), + (0x1FAF9, "X"), + (0x1FB00, "V"), + (0x1FB93, "X"), + (0x1FB94, "V"), + (0x1FBCB, "X"), + (0x1FBF0, "M", "0"), + (0x1FBF1, "M", "1"), + (0x1FBF2, "M", "2"), + (0x1FBF3, "M", "3"), + (0x1FBF4, "M", "4"), + (0x1FBF5, "M", "5"), + (0x1FBF6, "M", "6"), + (0x1FBF7, "M", "7"), + (0x1FBF8, "M", "8"), + (0x1FBF9, "M", "9"), + (0x1FBFA, "X"), + (0x20000, "V"), + (0x2A6E0, "X"), + (0x2A700, "V"), + (0x2B73A, "X"), + (0x2B740, "V"), + (0x2B81E, "X"), + (0x2B820, "V"), + (0x2CEA2, "X"), + (0x2CEB0, "V"), + (0x2EBE1, "X"), + (0x2EBF0, "V"), + (0x2EE5E, "X"), + (0x2F800, "M", "丽"), + (0x2F801, "M", "丸"), + (0x2F802, "M", "乁"), + (0x2F803, "M", "𠄢"), + (0x2F804, "M", "你"), + (0x2F805, "M", "侮"), + (0x2F806, "M", "侻"), + (0x2F807, "M", "倂"), + (0x2F808, "M", "偺"), + (0x2F809, "M", "備"), + (0x2F80A, "M", "僧"), + (0x2F80B, "M", "像"), + (0x2F80C, "M", "㒞"), + (0x2F80D, "M", "𠘺"), + (0x2F80E, "M", "免"), + (0x2F80F, "M", "兔"), + (0x2F810, "M", "兤"), + (0x2F811, "M", "具"), + (0x2F812, "M", "𠔜"), + (0x2F813, "M", "㒹"), + (0x2F814, "M", "內"), + (0x2F815, "M", "再"), + (0x2F816, "M", "𠕋"), + (0x2F817, "M", "冗"), + (0x2F818, "M", "冤"), + (0x2F819, "M", "仌"), + (0x2F81A, "M", "冬"), + (0x2F81B, "M", "况"), + (0x2F81C, "M", "𩇟"), + (0x2F81D, "M", "凵"), + (0x2F81E, "M", "刃"), + (0x2F81F, "M", "㓟"), + (0x2F820, "M", "刻"), + (0x2F821, "M", "剆"), + (0x2F822, "M", "割"), + (0x2F823, "M", "剷"), + (0x2F824, "M", "㔕"), + (0x2F825, "M", "勇"), + (0x2F826, "M", "勉"), + (0x2F827, "M", "勤"), + (0x2F828, "M", "勺"), + (0x2F829, "M", "包"), + (0x2F82A, "M", "匆"), + (0x2F82B, "M", "北"), + (0x2F82C, "M", "卉"), + (0x2F82D, "M", "卑"), + (0x2F82E, "M", "博"), + (0x2F82F, "M", "即"), + (0x2F830, "M", "卽"), + (0x2F831, "M", "卿"), + (0x2F834, "M", "𠨬"), + (0x2F835, "M", "灰"), + (0x2F836, "M", "及"), + (0x2F837, "M", "叟"), + (0x2F838, "M", "𠭣"), + (0x2F839, "M", "叫"), + (0x2F83A, "M", "叱"), + (0x2F83B, "M", "吆"), + (0x2F83C, "M", "咞"), + (0x2F83D, "M", "吸"), + (0x2F83E, "M", "呈"), + (0x2F83F, "M", "周"), + (0x2F840, "M", "咢"), + ] + + +def _seg_77() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x2F841, "M", "哶"), + (0x2F842, "M", "唐"), + (0x2F843, "M", "啓"), + (0x2F844, "M", "啣"), + (0x2F845, "M", "善"), + (0x2F847, "M", "喙"), + (0x2F848, "M", "喫"), + (0x2F849, "M", "喳"), + (0x2F84A, "M", "嗂"), + (0x2F84B, "M", "圖"), + (0x2F84C, "M", "嘆"), + (0x2F84D, "M", "圗"), + (0x2F84E, "M", "噑"), + (0x2F84F, "M", "噴"), + (0x2F850, "M", "切"), + (0x2F851, "M", "壮"), + (0x2F852, "M", "城"), + (0x2F853, "M", "埴"), + (0x2F854, "M", "堍"), + (0x2F855, "M", "型"), + (0x2F856, "M", "堲"), + (0x2F857, "M", "報"), + (0x2F858, "M", "墬"), + (0x2F859, "M", "𡓤"), + (0x2F85A, "M", "売"), + (0x2F85B, "M", "壷"), + (0x2F85C, "M", "夆"), + (0x2F85D, "M", "多"), + (0x2F85E, "M", "夢"), + (0x2F85F, "M", "奢"), + (0x2F860, "M", "𡚨"), + (0x2F861, "M", "𡛪"), + (0x2F862, "M", "姬"), + (0x2F863, "M", "娛"), + (0x2F864, "M", "娧"), + (0x2F865, "M", "姘"), + (0x2F866, "M", "婦"), + (0x2F867, "M", "㛮"), + (0x2F868, "X"), + (0x2F869, "M", "嬈"), + (0x2F86A, "M", "嬾"), + (0x2F86C, "M", "𡧈"), + (0x2F86D, "M", "寃"), + (0x2F86E, "M", "寘"), + (0x2F86F, "M", "寧"), + (0x2F870, "M", "寳"), + (0x2F871, "M", "𡬘"), + (0x2F872, "M", "寿"), + (0x2F873, "M", "将"), + (0x2F874, "X"), + (0x2F875, "M", "尢"), + (0x2F876, "M", "㞁"), + (0x2F877, "M", "屠"), + (0x2F878, "M", "屮"), + (0x2F879, "M", "峀"), + (0x2F87A, "M", "岍"), + (0x2F87B, "M", "𡷤"), + (0x2F87C, "M", "嵃"), + (0x2F87D, "M", "𡷦"), + (0x2F87E, "M", "嵮"), + (0x2F87F, "M", "嵫"), + (0x2F880, "M", "嵼"), + (0x2F881, "M", "巡"), + (0x2F882, "M", "巢"), + (0x2F883, "M", "㠯"), + (0x2F884, "M", "巽"), + (0x2F885, "M", "帨"), + (0x2F886, "M", "帽"), + (0x2F887, "M", "幩"), + (0x2F888, "M", "㡢"), + (0x2F889, "M", "𢆃"), + (0x2F88A, "M", "㡼"), + (0x2F88B, "M", "庰"), + (0x2F88C, "M", "庳"), + (0x2F88D, "M", "庶"), + (0x2F88E, "M", "廊"), + (0x2F88F, "M", "𪎒"), + (0x2F890, "M", "廾"), + (0x2F891, "M", "𢌱"), + (0x2F893, "M", "舁"), + (0x2F894, "M", "弢"), + (0x2F896, "M", "㣇"), + (0x2F897, "M", "𣊸"), + (0x2F898, "M", "𦇚"), + (0x2F899, "M", "形"), + (0x2F89A, "M", "彫"), + (0x2F89B, "M", "㣣"), + (0x2F89C, "M", "徚"), + (0x2F89D, "M", "忍"), + (0x2F89E, "M", "志"), + (0x2F89F, "M", "忹"), + (0x2F8A0, "M", "悁"), + (0x2F8A1, "M", "㤺"), + (0x2F8A2, "M", "㤜"), + (0x2F8A3, "M", "悔"), + (0x2F8A4, "M", "𢛔"), + (0x2F8A5, "M", "惇"), + (0x2F8A6, "M", "慈"), + (0x2F8A7, "M", "慌"), + (0x2F8A8, "M", "慎"), + ] + + +def _seg_78() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x2F8A9, "M", "慌"), + (0x2F8AA, "M", "慺"), + (0x2F8AB, "M", "憎"), + (0x2F8AC, "M", "憲"), + (0x2F8AD, "M", "憤"), + (0x2F8AE, "M", "憯"), + (0x2F8AF, "M", "懞"), + (0x2F8B0, "M", "懲"), + (0x2F8B1, "M", "懶"), + (0x2F8B2, "M", "成"), + (0x2F8B3, "M", "戛"), + (0x2F8B4, "M", "扝"), + (0x2F8B5, "M", "抱"), + (0x2F8B6, "M", "拔"), + (0x2F8B7, "M", "捐"), + (0x2F8B8, "M", "𢬌"), + (0x2F8B9, "M", "挽"), + (0x2F8BA, "M", "拼"), + (0x2F8BB, "M", "捨"), + (0x2F8BC, "M", "掃"), + (0x2F8BD, "M", "揤"), + (0x2F8BE, "M", "𢯱"), + (0x2F8BF, "M", "搢"), + (0x2F8C0, "M", "揅"), + (0x2F8C1, "M", "掩"), + (0x2F8C2, "M", "㨮"), + (0x2F8C3, "M", "摩"), + (0x2F8C4, "M", "摾"), + (0x2F8C5, "M", "撝"), + (0x2F8C6, "M", "摷"), + (0x2F8C7, "M", "㩬"), + (0x2F8C8, "M", "敏"), + (0x2F8C9, "M", "敬"), + (0x2F8CA, "M", "𣀊"), + (0x2F8CB, "M", "旣"), + (0x2F8CC, "M", "書"), + (0x2F8CD, "M", "晉"), + (0x2F8CE, "M", "㬙"), + (0x2F8CF, "M", "暑"), + (0x2F8D0, "M", "㬈"), + (0x2F8D1, "M", "㫤"), + (0x2F8D2, "M", "冒"), + (0x2F8D3, "M", "冕"), + (0x2F8D4, "M", "最"), + (0x2F8D5, "M", "暜"), + (0x2F8D6, "M", "肭"), + (0x2F8D7, "M", "䏙"), + (0x2F8D8, "M", "朗"), + (0x2F8D9, "M", "望"), + (0x2F8DA, "M", "朡"), + (0x2F8DB, "M", "杞"), + (0x2F8DC, "M", "杓"), + (0x2F8DD, "M", "𣏃"), + (0x2F8DE, "M", "㭉"), + (0x2F8DF, "M", "柺"), + (0x2F8E0, "M", "枅"), + (0x2F8E1, "M", "桒"), + (0x2F8E2, "M", "梅"), + (0x2F8E3, "M", "𣑭"), + (0x2F8E4, "M", "梎"), + (0x2F8E5, "M", "栟"), + (0x2F8E6, "M", "椔"), + (0x2F8E7, "M", "㮝"), + (0x2F8E8, "M", "楂"), + (0x2F8E9, "M", "榣"), + (0x2F8EA, "M", "槪"), + (0x2F8EB, "M", "檨"), + (0x2F8EC, "M", "𣚣"), + (0x2F8ED, "M", "櫛"), + (0x2F8EE, "M", "㰘"), + (0x2F8EF, "M", "次"), + (0x2F8F0, "M", "𣢧"), + (0x2F8F1, "M", "歔"), + (0x2F8F2, "M", "㱎"), + (0x2F8F3, "M", "歲"), + (0x2F8F4, "M", "殟"), + (0x2F8F5, "M", "殺"), + (0x2F8F6, "M", "殻"), + (0x2F8F7, "M", "𣪍"), + (0x2F8F8, "M", "𡴋"), + (0x2F8F9, "M", "𣫺"), + (0x2F8FA, "M", "汎"), + (0x2F8FB, "M", "𣲼"), + (0x2F8FC, "M", "沿"), + (0x2F8FD, "M", "泍"), + (0x2F8FE, "M", "汧"), + (0x2F8FF, "M", "洖"), + (0x2F900, "M", "派"), + (0x2F901, "M", "海"), + (0x2F902, "M", "流"), + (0x2F903, "M", "浩"), + (0x2F904, "M", "浸"), + (0x2F905, "M", "涅"), + (0x2F906, "M", "𣴞"), + (0x2F907, "M", "洴"), + (0x2F908, "M", "港"), + (0x2F909, "M", "湮"), + (0x2F90A, "M", "㴳"), + (0x2F90B, "M", "滋"), + (0x2F90C, "M", "滇"), + ] + + +def _seg_79() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x2F90D, "M", "𣻑"), + (0x2F90E, "M", "淹"), + (0x2F90F, "M", "潮"), + (0x2F910, "M", "𣽞"), + (0x2F911, "M", "𣾎"), + (0x2F912, "M", "濆"), + (0x2F913, "M", "瀹"), + (0x2F914, "M", "瀞"), + (0x2F915, "M", "瀛"), + (0x2F916, "M", "㶖"), + (0x2F917, "M", "灊"), + (0x2F918, "M", "災"), + (0x2F919, "M", "灷"), + (0x2F91A, "M", "炭"), + (0x2F91B, "M", "𠔥"), + (0x2F91C, "M", "煅"), + (0x2F91D, "M", "𤉣"), + (0x2F91E, "M", "熜"), + (0x2F91F, "X"), + (0x2F920, "M", "爨"), + (0x2F921, "M", "爵"), + (0x2F922, "M", "牐"), + (0x2F923, "M", "𤘈"), + (0x2F924, "M", "犀"), + (0x2F925, "M", "犕"), + (0x2F926, "M", "𤜵"), + (0x2F927, "M", "𤠔"), + (0x2F928, "M", "獺"), + (0x2F929, "M", "王"), + (0x2F92A, "M", "㺬"), + (0x2F92B, "M", "玥"), + (0x2F92C, "M", "㺸"), + (0x2F92E, "M", "瑇"), + (0x2F92F, "M", "瑜"), + (0x2F930, "M", "瑱"), + (0x2F931, "M", "璅"), + (0x2F932, "M", "瓊"), + (0x2F933, "M", "㼛"), + (0x2F934, "M", "甤"), + (0x2F935, "M", "𤰶"), + (0x2F936, "M", "甾"), + (0x2F937, "M", "𤲒"), + (0x2F938, "M", "異"), + (0x2F939, "M", "𢆟"), + (0x2F93A, "M", "瘐"), + (0x2F93B, "M", "𤾡"), + (0x2F93C, "M", "𤾸"), + (0x2F93D, "M", "𥁄"), + (0x2F93E, "M", "㿼"), + (0x2F93F, "M", "䀈"), + (0x2F940, "M", "直"), + (0x2F941, "M", "𥃳"), + (0x2F942, "M", "𥃲"), + (0x2F943, "M", "𥄙"), + (0x2F944, "M", "𥄳"), + (0x2F945, "M", "眞"), + (0x2F946, "M", "真"), + (0x2F948, "M", "睊"), + (0x2F949, "M", "䀹"), + (0x2F94A, "M", "瞋"), + (0x2F94B, "M", "䁆"), + (0x2F94C, "M", "䂖"), + (0x2F94D, "M", "𥐝"), + (0x2F94E, "M", "硎"), + (0x2F94F, "M", "碌"), + (0x2F950, "M", "磌"), + (0x2F951, "M", "䃣"), + (0x2F952, "M", "𥘦"), + (0x2F953, "M", "祖"), + (0x2F954, "M", "𥚚"), + (0x2F955, "M", "𥛅"), + (0x2F956, "M", "福"), + (0x2F957, "M", "秫"), + (0x2F958, "M", "䄯"), + (0x2F959, "M", "穀"), + (0x2F95A, "M", "穊"), + (0x2F95B, "M", "穏"), + (0x2F95C, "M", "𥥼"), + (0x2F95D, "M", "𥪧"), + (0x2F95F, "X"), + (0x2F960, "M", "䈂"), + (0x2F961, "M", "𥮫"), + (0x2F962, "M", "篆"), + (0x2F963, "M", "築"), + (0x2F964, "M", "䈧"), + (0x2F965, "M", "𥲀"), + (0x2F966, "M", "糒"), + (0x2F967, "M", "䊠"), + (0x2F968, "M", "糨"), + (0x2F969, "M", "糣"), + (0x2F96A, "M", "紀"), + (0x2F96B, "M", "𥾆"), + (0x2F96C, "M", "絣"), + (0x2F96D, "M", "䌁"), + (0x2F96E, "M", "緇"), + (0x2F96F, "M", "縂"), + (0x2F970, "M", "繅"), + (0x2F971, "M", "䌴"), + (0x2F972, "M", "𦈨"), + (0x2F973, "M", "𦉇"), + ] + + +def _seg_80() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x2F974, "M", "䍙"), + (0x2F975, "M", "𦋙"), + (0x2F976, "M", "罺"), + (0x2F977, "M", "𦌾"), + (0x2F978, "M", "羕"), + (0x2F979, "M", "翺"), + (0x2F97A, "M", "者"), + (0x2F97B, "M", "𦓚"), + (0x2F97C, "M", "𦔣"), + (0x2F97D, "M", "聠"), + (0x2F97E, "M", "𦖨"), + (0x2F97F, "M", "聰"), + (0x2F980, "M", "𣍟"), + (0x2F981, "M", "䏕"), + (0x2F982, "M", "育"), + (0x2F983, "M", "脃"), + (0x2F984, "M", "䐋"), + (0x2F985, "M", "脾"), + (0x2F986, "M", "媵"), + (0x2F987, "M", "𦞧"), + (0x2F988, "M", "𦞵"), + (0x2F989, "M", "𣎓"), + (0x2F98A, "M", "𣎜"), + (0x2F98B, "M", "舁"), + (0x2F98C, "M", "舄"), + (0x2F98D, "M", "辞"), + (0x2F98E, "M", "䑫"), + (0x2F98F, "M", "芑"), + (0x2F990, "M", "芋"), + (0x2F991, "M", "芝"), + (0x2F992, "M", "劳"), + (0x2F993, "M", "花"), + (0x2F994, "M", "芳"), + (0x2F995, "M", "芽"), + (0x2F996, "M", "苦"), + (0x2F997, "M", "𦬼"), + (0x2F998, "M", "若"), + (0x2F999, "M", "茝"), + (0x2F99A, "M", "荣"), + (0x2F99B, "M", "莭"), + (0x2F99C, "M", "茣"), + (0x2F99D, "M", "莽"), + (0x2F99E, "M", "菧"), + (0x2F99F, "M", "著"), + (0x2F9A0, "M", "荓"), + (0x2F9A1, "M", "菊"), + (0x2F9A2, "M", "菌"), + (0x2F9A3, "M", "菜"), + (0x2F9A4, "M", "𦰶"), + (0x2F9A5, "M", "𦵫"), + (0x2F9A6, "M", "𦳕"), + (0x2F9A7, "M", "䔫"), + (0x2F9A8, "M", "蓱"), + (0x2F9A9, "M", "蓳"), + (0x2F9AA, "M", "蔖"), + (0x2F9AB, "M", "𧏊"), + (0x2F9AC, "M", "蕤"), + (0x2F9AD, "M", "𦼬"), + (0x2F9AE, "M", "䕝"), + (0x2F9AF, "M", "䕡"), + (0x2F9B0, "M", "𦾱"), + (0x2F9B1, "M", "𧃒"), + (0x2F9B2, "M", "䕫"), + (0x2F9B3, "M", "虐"), + (0x2F9B4, "M", "虜"), + (0x2F9B5, "M", "虧"), + (0x2F9B6, "M", "虩"), + (0x2F9B7, "M", "蚩"), + (0x2F9B8, "M", "蚈"), + (0x2F9B9, "M", "蜎"), + (0x2F9BA, "M", "蛢"), + (0x2F9BB, "M", "蝹"), + (0x2F9BC, "M", "蜨"), + (0x2F9BD, "M", "蝫"), + (0x2F9BE, "M", "螆"), + (0x2F9BF, "X"), + (0x2F9C0, "M", "蟡"), + (0x2F9C1, "M", "蠁"), + (0x2F9C2, "M", "䗹"), + (0x2F9C3, "M", "衠"), + (0x2F9C4, "M", "衣"), + (0x2F9C5, "M", "𧙧"), + (0x2F9C6, "M", "裗"), + (0x2F9C7, "M", "裞"), + (0x2F9C8, "M", "䘵"), + (0x2F9C9, "M", "裺"), + (0x2F9CA, "M", "㒻"), + (0x2F9CB, "M", "𧢮"), + (0x2F9CC, "M", "𧥦"), + (0x2F9CD, "M", "䚾"), + (0x2F9CE, "M", "䛇"), + (0x2F9CF, "M", "誠"), + (0x2F9D0, "M", "諭"), + (0x2F9D1, "M", "變"), + (0x2F9D2, "M", "豕"), + (0x2F9D3, "M", "𧲨"), + (0x2F9D4, "M", "貫"), + (0x2F9D5, "M", "賁"), + (0x2F9D6, "M", "贛"), + (0x2F9D7, "M", "起"), + ] + + +def _seg_81() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x2F9D8, "M", "𧼯"), + (0x2F9D9, "M", "𠠄"), + (0x2F9DA, "M", "跋"), + (0x2F9DB, "M", "趼"), + (0x2F9DC, "M", "跰"), + (0x2F9DD, "M", "𠣞"), + (0x2F9DE, "M", "軔"), + (0x2F9DF, "M", "輸"), + (0x2F9E0, "M", "𨗒"), + (0x2F9E1, "M", "𨗭"), + (0x2F9E2, "M", "邔"), + (0x2F9E3, "M", "郱"), + (0x2F9E4, "M", "鄑"), + (0x2F9E5, "M", "𨜮"), + (0x2F9E6, "M", "鄛"), + (0x2F9E7, "M", "鈸"), + (0x2F9E8, "M", "鋗"), + (0x2F9E9, "M", "鋘"), + (0x2F9EA, "M", "鉼"), + (0x2F9EB, "M", "鏹"), + (0x2F9EC, "M", "鐕"), + (0x2F9ED, "M", "𨯺"), + (0x2F9EE, "M", "開"), + (0x2F9EF, "M", "䦕"), + (0x2F9F0, "M", "閷"), + (0x2F9F1, "M", "𨵷"), + (0x2F9F2, "M", "䧦"), + (0x2F9F3, "M", "雃"), + (0x2F9F4, "M", "嶲"), + (0x2F9F5, "M", "霣"), + (0x2F9F6, "M", "𩅅"), + (0x2F9F7, "M", "𩈚"), + (0x2F9F8, "M", "䩮"), + (0x2F9F9, "M", "䩶"), + (0x2F9FA, "M", "韠"), + (0x2F9FB, "M", "𩐊"), + (0x2F9FC, "M", "䪲"), + (0x2F9FD, "M", "𩒖"), + (0x2F9FE, "M", "頋"), + (0x2FA00, "M", "頩"), + (0x2FA01, "M", "𩖶"), + (0x2FA02, "M", "飢"), + (0x2FA03, "M", "䬳"), + (0x2FA04, "M", "餩"), + (0x2FA05, "M", "馧"), + (0x2FA06, "M", "駂"), + (0x2FA07, "M", "駾"), + (0x2FA08, "M", "䯎"), + (0x2FA09, "M", "𩬰"), + (0x2FA0A, "M", "鬒"), + (0x2FA0B, "M", "鱀"), + (0x2FA0C, "M", "鳽"), + (0x2FA0D, "M", "䳎"), + (0x2FA0E, "M", "䳭"), + (0x2FA0F, "M", "鵧"), + (0x2FA10, "M", "𪃎"), + (0x2FA11, "M", "䳸"), + (0x2FA12, "M", "𪄅"), + (0x2FA13, "M", "𪈎"), + (0x2FA14, "M", "𪊑"), + (0x2FA15, "M", "麻"), + (0x2FA16, "M", "䵖"), + (0x2FA17, "M", "黹"), + (0x2FA18, "M", "黾"), + (0x2FA19, "M", "鼅"), + (0x2FA1A, "M", "鼏"), + (0x2FA1B, "M", "鼖"), + (0x2FA1C, "M", "鼻"), + (0x2FA1D, "M", "𪘀"), + (0x2FA1E, "X"), + (0x30000, "V"), + (0x3134B, "X"), + (0x31350, "V"), + (0x323B0, "X"), + (0xE0100, "I"), + (0xE01F0, "X"), + ] + + +uts46data = tuple( + _seg_0() + + _seg_1() + + _seg_2() + + _seg_3() + + _seg_4() + + _seg_5() + + _seg_6() + + _seg_7() + + _seg_8() + + _seg_9() + + _seg_10() + + _seg_11() + + _seg_12() + + _seg_13() + + _seg_14() + + _seg_15() + + _seg_16() + + _seg_17() + + _seg_18() + + _seg_19() + + _seg_20() + + _seg_21() + + _seg_22() + + _seg_23() + + _seg_24() + + _seg_25() + + _seg_26() + + _seg_27() + + _seg_28() + + _seg_29() + + _seg_30() + + _seg_31() + + _seg_32() + + _seg_33() + + _seg_34() + + _seg_35() + + _seg_36() + + _seg_37() + + _seg_38() + + _seg_39() + + _seg_40() + + _seg_41() + + _seg_42() + + _seg_43() + + _seg_44() + + _seg_45() + + _seg_46() + + _seg_47() + + _seg_48() + + _seg_49() + + _seg_50() + + _seg_51() + + _seg_52() + + _seg_53() + + _seg_54() + + _seg_55() + + _seg_56() + + _seg_57() + + _seg_58() + + _seg_59() + + _seg_60() + + _seg_61() + + _seg_62() + + _seg_63() + + _seg_64() + + _seg_65() + + _seg_66() + + _seg_67() + + _seg_68() + + _seg_69() + + _seg_70() + + _seg_71() + + _seg_72() + + _seg_73() + + _seg_74() + + _seg_75() + + _seg_76() + + _seg_77() + + _seg_78() + + _seg_79() + + _seg_80() + + _seg_81() +) # type: Tuple[Union[Tuple[int, str], Tuple[int, str, str]], ...] diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/msgpack/__init__.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/msgpack/__init__.py new file mode 100644 index 0000000..b615105 --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/msgpack/__init__.py @@ -0,0 +1,55 @@ +# ruff: noqa: F401 +import os + +from .exceptions import * # noqa: F403 +from .ext import ExtType, Timestamp + +version = (1, 1, 0) +__version__ = "1.1.0" + + +if os.environ.get("MSGPACK_PUREPYTHON"): + from .fallback import Packer, Unpacker, unpackb +else: + try: + from ._cmsgpack import Packer, Unpacker, unpackb + except ImportError: + from .fallback import Packer, Unpacker, unpackb + + +def pack(o, stream, **kwargs): + """ + Pack object `o` and write it to `stream` + + See :class:`Packer` for options. + """ + packer = Packer(**kwargs) + stream.write(packer.pack(o)) + + +def packb(o, **kwargs): + """ + Pack object `o` and return packed bytes + + See :class:`Packer` for options. + """ + return Packer(**kwargs).pack(o) + + +def unpack(stream, **kwargs): + """ + Unpack an object from `stream`. + + Raises `ExtraData` when `stream` contains extra bytes. + See :class:`Unpacker` for options. + """ + data = stream.read() + return unpackb(data, **kwargs) + + +# alias for compatibility to simplejson/marshal/pickle. +load = unpack +loads = unpackb + +dump = pack +dumps = packb diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/msgpack/__pycache__/__init__.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/msgpack/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000..3259f37 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/msgpack/__pycache__/__init__.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/msgpack/__pycache__/exceptions.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/msgpack/__pycache__/exceptions.cpython-312.pyc new file mode 100644 index 0000000..5ab588b Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/msgpack/__pycache__/exceptions.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/msgpack/__pycache__/ext.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/msgpack/__pycache__/ext.cpython-312.pyc new file mode 100644 index 0000000..d9a0f29 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/msgpack/__pycache__/ext.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/msgpack/__pycache__/fallback.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/msgpack/__pycache__/fallback.cpython-312.pyc new file mode 100644 index 0000000..e3a1237 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/msgpack/__pycache__/fallback.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/msgpack/exceptions.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/msgpack/exceptions.py new file mode 100644 index 0000000..d6d2615 --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/msgpack/exceptions.py @@ -0,0 +1,48 @@ +class UnpackException(Exception): + """Base class for some exceptions raised while unpacking. + + NOTE: unpack may raise exception other than subclass of + UnpackException. If you want to catch all error, catch + Exception instead. + """ + + +class BufferFull(UnpackException): + pass + + +class OutOfData(UnpackException): + pass + + +class FormatError(ValueError, UnpackException): + """Invalid msgpack format""" + + +class StackError(ValueError, UnpackException): + """Too nested""" + + +# Deprecated. Use ValueError instead +UnpackValueError = ValueError + + +class ExtraData(UnpackValueError): + """ExtraData is raised when there is trailing data. + + This exception is raised while only one-shot (not streaming) + unpack. + """ + + def __init__(self, unpacked, extra): + self.unpacked = unpacked + self.extra = extra + + def __str__(self): + return "unpack(b) received extra data." + + +# Deprecated. Use Exception instead to catch all exception during packing. +PackException = Exception +PackValueError = ValueError +PackOverflowError = OverflowError diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/msgpack/ext.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/msgpack/ext.py new file mode 100644 index 0000000..9694819 --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/msgpack/ext.py @@ -0,0 +1,170 @@ +import datetime +import struct +from collections import namedtuple + + +class ExtType(namedtuple("ExtType", "code data")): + """ExtType represents ext type in msgpack.""" + + def __new__(cls, code, data): + if not isinstance(code, int): + raise TypeError("code must be int") + if not isinstance(data, bytes): + raise TypeError("data must be bytes") + if not 0 <= code <= 127: + raise ValueError("code must be 0~127") + return super().__new__(cls, code, data) + + +class Timestamp: + """Timestamp represents the Timestamp extension type in msgpack. + + When built with Cython, msgpack uses C methods to pack and unpack `Timestamp`. + When using pure-Python msgpack, :func:`to_bytes` and :func:`from_bytes` are used to pack and + unpack `Timestamp`. + + This class is immutable: Do not override seconds and nanoseconds. + """ + + __slots__ = ["seconds", "nanoseconds"] + + def __init__(self, seconds, nanoseconds=0): + """Initialize a Timestamp object. + + :param int seconds: + Number of seconds since the UNIX epoch (00:00:00 UTC Jan 1 1970, minus leap seconds). + May be negative. + + :param int nanoseconds: + Number of nanoseconds to add to `seconds` to get fractional time. + Maximum is 999_999_999. Default is 0. + + Note: Negative times (before the UNIX epoch) are represented as neg. seconds + pos. ns. + """ + if not isinstance(seconds, int): + raise TypeError("seconds must be an integer") + if not isinstance(nanoseconds, int): + raise TypeError("nanoseconds must be an integer") + if not (0 <= nanoseconds < 10**9): + raise ValueError("nanoseconds must be a non-negative integer less than 999999999.") + self.seconds = seconds + self.nanoseconds = nanoseconds + + def __repr__(self): + """String representation of Timestamp.""" + return f"Timestamp(seconds={self.seconds}, nanoseconds={self.nanoseconds})" + + def __eq__(self, other): + """Check for equality with another Timestamp object""" + if type(other) is self.__class__: + return self.seconds == other.seconds and self.nanoseconds == other.nanoseconds + return False + + def __ne__(self, other): + """not-equals method (see :func:`__eq__()`)""" + return not self.__eq__(other) + + def __hash__(self): + return hash((self.seconds, self.nanoseconds)) + + @staticmethod + def from_bytes(b): + """Unpack bytes into a `Timestamp` object. + + Used for pure-Python msgpack unpacking. + + :param b: Payload from msgpack ext message with code -1 + :type b: bytes + + :returns: Timestamp object unpacked from msgpack ext payload + :rtype: Timestamp + """ + if len(b) == 4: + seconds = struct.unpack("!L", b)[0] + nanoseconds = 0 + elif len(b) == 8: + data64 = struct.unpack("!Q", b)[0] + seconds = data64 & 0x00000003FFFFFFFF + nanoseconds = data64 >> 34 + elif len(b) == 12: + nanoseconds, seconds = struct.unpack("!Iq", b) + else: + raise ValueError( + "Timestamp type can only be created from 32, 64, or 96-bit byte objects" + ) + return Timestamp(seconds, nanoseconds) + + def to_bytes(self): + """Pack this Timestamp object into bytes. + + Used for pure-Python msgpack packing. + + :returns data: Payload for EXT message with code -1 (timestamp type) + :rtype: bytes + """ + if (self.seconds >> 34) == 0: # seconds is non-negative and fits in 34 bits + data64 = self.nanoseconds << 34 | self.seconds + if data64 & 0xFFFFFFFF00000000 == 0: + # nanoseconds is zero and seconds < 2**32, so timestamp 32 + data = struct.pack("!L", data64) + else: + # timestamp 64 + data = struct.pack("!Q", data64) + else: + # timestamp 96 + data = struct.pack("!Iq", self.nanoseconds, self.seconds) + return data + + @staticmethod + def from_unix(unix_sec): + """Create a Timestamp from posix timestamp in seconds. + + :param unix_float: Posix timestamp in seconds. + :type unix_float: int or float + """ + seconds = int(unix_sec // 1) + nanoseconds = int((unix_sec % 1) * 10**9) + return Timestamp(seconds, nanoseconds) + + def to_unix(self): + """Get the timestamp as a floating-point value. + + :returns: posix timestamp + :rtype: float + """ + return self.seconds + self.nanoseconds / 1e9 + + @staticmethod + def from_unix_nano(unix_ns): + """Create a Timestamp from posix timestamp in nanoseconds. + + :param int unix_ns: Posix timestamp in nanoseconds. + :rtype: Timestamp + """ + return Timestamp(*divmod(unix_ns, 10**9)) + + def to_unix_nano(self): + """Get the timestamp as a unixtime in nanoseconds. + + :returns: posix timestamp in nanoseconds + :rtype: int + """ + return self.seconds * 10**9 + self.nanoseconds + + def to_datetime(self): + """Get the timestamp as a UTC datetime. + + :rtype: `datetime.datetime` + """ + utc = datetime.timezone.utc + return datetime.datetime.fromtimestamp(0, utc) + datetime.timedelta( + seconds=self.seconds, microseconds=self.nanoseconds // 1000 + ) + + @staticmethod + def from_datetime(dt): + """Create a Timestamp from datetime with tzinfo. + + :rtype: Timestamp + """ + return Timestamp(seconds=int(dt.timestamp()), nanoseconds=dt.microsecond * 1000) diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/msgpack/fallback.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/msgpack/fallback.py new file mode 100644 index 0000000..b02e47c --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/msgpack/fallback.py @@ -0,0 +1,929 @@ +"""Fallback pure Python implementation of msgpack""" + +import struct +import sys +from datetime import datetime as _DateTime + +if hasattr(sys, "pypy_version_info"): + from __pypy__ import newlist_hint + from __pypy__.builders import BytesBuilder + + _USING_STRINGBUILDER = True + + class BytesIO: + def __init__(self, s=b""): + if s: + self.builder = BytesBuilder(len(s)) + self.builder.append(s) + else: + self.builder = BytesBuilder() + + def write(self, s): + if isinstance(s, memoryview): + s = s.tobytes() + elif isinstance(s, bytearray): + s = bytes(s) + self.builder.append(s) + + def getvalue(self): + return self.builder.build() + +else: + from io import BytesIO + + _USING_STRINGBUILDER = False + + def newlist_hint(size): + return [] + + +from .exceptions import BufferFull, ExtraData, FormatError, OutOfData, StackError +from .ext import ExtType, Timestamp + +EX_SKIP = 0 +EX_CONSTRUCT = 1 +EX_READ_ARRAY_HEADER = 2 +EX_READ_MAP_HEADER = 3 + +TYPE_IMMEDIATE = 0 +TYPE_ARRAY = 1 +TYPE_MAP = 2 +TYPE_RAW = 3 +TYPE_BIN = 4 +TYPE_EXT = 5 + +DEFAULT_RECURSE_LIMIT = 511 + + +def _check_type_strict(obj, t, type=type, tuple=tuple): + if type(t) is tuple: + return type(obj) in t + else: + return type(obj) is t + + +def _get_data_from_buffer(obj): + view = memoryview(obj) + if view.itemsize != 1: + raise ValueError("cannot unpack from multi-byte object") + return view + + +def unpackb(packed, **kwargs): + """ + Unpack an object from `packed`. + + Raises ``ExtraData`` when *packed* contains extra bytes. + Raises ``ValueError`` when *packed* is incomplete. + Raises ``FormatError`` when *packed* is not valid msgpack. + Raises ``StackError`` when *packed* contains too nested. + Other exceptions can be raised during unpacking. + + See :class:`Unpacker` for options. + """ + unpacker = Unpacker(None, max_buffer_size=len(packed), **kwargs) + unpacker.feed(packed) + try: + ret = unpacker._unpack() + except OutOfData: + raise ValueError("Unpack failed: incomplete input") + except RecursionError: + raise StackError + if unpacker._got_extradata(): + raise ExtraData(ret, unpacker._get_extradata()) + return ret + + +_NO_FORMAT_USED = "" +_MSGPACK_HEADERS = { + 0xC4: (1, _NO_FORMAT_USED, TYPE_BIN), + 0xC5: (2, ">H", TYPE_BIN), + 0xC6: (4, ">I", TYPE_BIN), + 0xC7: (2, "Bb", TYPE_EXT), + 0xC8: (3, ">Hb", TYPE_EXT), + 0xC9: (5, ">Ib", TYPE_EXT), + 0xCA: (4, ">f"), + 0xCB: (8, ">d"), + 0xCC: (1, _NO_FORMAT_USED), + 0xCD: (2, ">H"), + 0xCE: (4, ">I"), + 0xCF: (8, ">Q"), + 0xD0: (1, "b"), + 0xD1: (2, ">h"), + 0xD2: (4, ">i"), + 0xD3: (8, ">q"), + 0xD4: (1, "b1s", TYPE_EXT), + 0xD5: (2, "b2s", TYPE_EXT), + 0xD6: (4, "b4s", TYPE_EXT), + 0xD7: (8, "b8s", TYPE_EXT), + 0xD8: (16, "b16s", TYPE_EXT), + 0xD9: (1, _NO_FORMAT_USED, TYPE_RAW), + 0xDA: (2, ">H", TYPE_RAW), + 0xDB: (4, ">I", TYPE_RAW), + 0xDC: (2, ">H", TYPE_ARRAY), + 0xDD: (4, ">I", TYPE_ARRAY), + 0xDE: (2, ">H", TYPE_MAP), + 0xDF: (4, ">I", TYPE_MAP), +} + + +class Unpacker: + """Streaming unpacker. + + Arguments: + + :param file_like: + File-like object having `.read(n)` method. + If specified, unpacker reads serialized data from it and `.feed()` is not usable. + + :param int read_size: + Used as `file_like.read(read_size)`. (default: `min(16*1024, max_buffer_size)`) + + :param bool use_list: + If true, unpack msgpack array to Python list. + Otherwise, unpack to Python tuple. (default: True) + + :param bool raw: + If true, unpack msgpack raw to Python bytes. + Otherwise, unpack to Python str by decoding with UTF-8 encoding (default). + + :param int timestamp: + Control how timestamp type is unpacked: + + 0 - Timestamp + 1 - float (Seconds from the EPOCH) + 2 - int (Nanoseconds from the EPOCH) + 3 - datetime.datetime (UTC). + + :param bool strict_map_key: + If true (default), only str or bytes are accepted for map (dict) keys. + + :param object_hook: + When specified, it should be callable. + Unpacker calls it with a dict argument after unpacking msgpack map. + (See also simplejson) + + :param object_pairs_hook: + When specified, it should be callable. + Unpacker calls it with a list of key-value pairs after unpacking msgpack map. + (See also simplejson) + + :param str unicode_errors: + The error handler for decoding unicode. (default: 'strict') + This option should be used only when you have msgpack data which + contains invalid UTF-8 string. + + :param int max_buffer_size: + Limits size of data waiting unpacked. 0 means 2**32-1. + The default value is 100*1024*1024 (100MiB). + Raises `BufferFull` exception when it is insufficient. + You should set this parameter when unpacking data from untrusted source. + + :param int max_str_len: + Deprecated, use *max_buffer_size* instead. + Limits max length of str. (default: max_buffer_size) + + :param int max_bin_len: + Deprecated, use *max_buffer_size* instead. + Limits max length of bin. (default: max_buffer_size) + + :param int max_array_len: + Limits max length of array. + (default: max_buffer_size) + + :param int max_map_len: + Limits max length of map. + (default: max_buffer_size//2) + + :param int max_ext_len: + Deprecated, use *max_buffer_size* instead. + Limits max size of ext type. (default: max_buffer_size) + + Example of streaming deserialize from file-like object:: + + unpacker = Unpacker(file_like) + for o in unpacker: + process(o) + + Example of streaming deserialize from socket:: + + unpacker = Unpacker() + while True: + buf = sock.recv(1024**2) + if not buf: + break + unpacker.feed(buf) + for o in unpacker: + process(o) + + Raises ``ExtraData`` when *packed* contains extra bytes. + Raises ``OutOfData`` when *packed* is incomplete. + Raises ``FormatError`` when *packed* is not valid msgpack. + Raises ``StackError`` when *packed* contains too nested. + Other exceptions can be raised during unpacking. + """ + + def __init__( + self, + file_like=None, + *, + read_size=0, + use_list=True, + raw=False, + timestamp=0, + strict_map_key=True, + object_hook=None, + object_pairs_hook=None, + list_hook=None, + unicode_errors=None, + max_buffer_size=100 * 1024 * 1024, + ext_hook=ExtType, + max_str_len=-1, + max_bin_len=-1, + max_array_len=-1, + max_map_len=-1, + max_ext_len=-1, + ): + if unicode_errors is None: + unicode_errors = "strict" + + if file_like is None: + self._feeding = True + else: + if not callable(file_like.read): + raise TypeError("`file_like.read` must be callable") + self.file_like = file_like + self._feeding = False + + #: array of bytes fed. + self._buffer = bytearray() + #: Which position we currently reads + self._buff_i = 0 + + # When Unpacker is used as an iterable, between the calls to next(), + # the buffer is not "consumed" completely, for efficiency sake. + # Instead, it is done sloppily. To make sure we raise BufferFull at + # the correct moments, we have to keep track of how sloppy we were. + # Furthermore, when the buffer is incomplete (that is: in the case + # we raise an OutOfData) we need to rollback the buffer to the correct + # state, which _buf_checkpoint records. + self._buf_checkpoint = 0 + + if not max_buffer_size: + max_buffer_size = 2**31 - 1 + if max_str_len == -1: + max_str_len = max_buffer_size + if max_bin_len == -1: + max_bin_len = max_buffer_size + if max_array_len == -1: + max_array_len = max_buffer_size + if max_map_len == -1: + max_map_len = max_buffer_size // 2 + if max_ext_len == -1: + max_ext_len = max_buffer_size + + self._max_buffer_size = max_buffer_size + if read_size > self._max_buffer_size: + raise ValueError("read_size must be smaller than max_buffer_size") + self._read_size = read_size or min(self._max_buffer_size, 16 * 1024) + self._raw = bool(raw) + self._strict_map_key = bool(strict_map_key) + self._unicode_errors = unicode_errors + self._use_list = use_list + if not (0 <= timestamp <= 3): + raise ValueError("timestamp must be 0..3") + self._timestamp = timestamp + self._list_hook = list_hook + self._object_hook = object_hook + self._object_pairs_hook = object_pairs_hook + self._ext_hook = ext_hook + self._max_str_len = max_str_len + self._max_bin_len = max_bin_len + self._max_array_len = max_array_len + self._max_map_len = max_map_len + self._max_ext_len = max_ext_len + self._stream_offset = 0 + + if list_hook is not None and not callable(list_hook): + raise TypeError("`list_hook` is not callable") + if object_hook is not None and not callable(object_hook): + raise TypeError("`object_hook` is not callable") + if object_pairs_hook is not None and not callable(object_pairs_hook): + raise TypeError("`object_pairs_hook` is not callable") + if object_hook is not None and object_pairs_hook is not None: + raise TypeError("object_pairs_hook and object_hook are mutually exclusive") + if not callable(ext_hook): + raise TypeError("`ext_hook` is not callable") + + def feed(self, next_bytes): + assert self._feeding + view = _get_data_from_buffer(next_bytes) + if len(self._buffer) - self._buff_i + len(view) > self._max_buffer_size: + raise BufferFull + + # Strip buffer before checkpoint before reading file. + if self._buf_checkpoint > 0: + del self._buffer[: self._buf_checkpoint] + self._buff_i -= self._buf_checkpoint + self._buf_checkpoint = 0 + + # Use extend here: INPLACE_ADD += doesn't reliably typecast memoryview in jython + self._buffer.extend(view) + view.release() + + def _consume(self): + """Gets rid of the used parts of the buffer.""" + self._stream_offset += self._buff_i - self._buf_checkpoint + self._buf_checkpoint = self._buff_i + + def _got_extradata(self): + return self._buff_i < len(self._buffer) + + def _get_extradata(self): + return self._buffer[self._buff_i :] + + def read_bytes(self, n): + ret = self._read(n, raise_outofdata=False) + self._consume() + return ret + + def _read(self, n, raise_outofdata=True): + # (int) -> bytearray + self._reserve(n, raise_outofdata=raise_outofdata) + i = self._buff_i + ret = self._buffer[i : i + n] + self._buff_i = i + len(ret) + return ret + + def _reserve(self, n, raise_outofdata=True): + remain_bytes = len(self._buffer) - self._buff_i - n + + # Fast path: buffer has n bytes already + if remain_bytes >= 0: + return + + if self._feeding: + self._buff_i = self._buf_checkpoint + raise OutOfData + + # Strip buffer before checkpoint before reading file. + if self._buf_checkpoint > 0: + del self._buffer[: self._buf_checkpoint] + self._buff_i -= self._buf_checkpoint + self._buf_checkpoint = 0 + + # Read from file + remain_bytes = -remain_bytes + if remain_bytes + len(self._buffer) > self._max_buffer_size: + raise BufferFull + while remain_bytes > 0: + to_read_bytes = max(self._read_size, remain_bytes) + read_data = self.file_like.read(to_read_bytes) + if not read_data: + break + assert isinstance(read_data, bytes) + self._buffer += read_data + remain_bytes -= len(read_data) + + if len(self._buffer) < n + self._buff_i and raise_outofdata: + self._buff_i = 0 # rollback + raise OutOfData + + def _read_header(self): + typ = TYPE_IMMEDIATE + n = 0 + obj = None + self._reserve(1) + b = self._buffer[self._buff_i] + self._buff_i += 1 + if b & 0b10000000 == 0: + obj = b + elif b & 0b11100000 == 0b11100000: + obj = -1 - (b ^ 0xFF) + elif b & 0b11100000 == 0b10100000: + n = b & 0b00011111 + typ = TYPE_RAW + if n > self._max_str_len: + raise ValueError(f"{n} exceeds max_str_len({self._max_str_len})") + obj = self._read(n) + elif b & 0b11110000 == 0b10010000: + n = b & 0b00001111 + typ = TYPE_ARRAY + if n > self._max_array_len: + raise ValueError(f"{n} exceeds max_array_len({self._max_array_len})") + elif b & 0b11110000 == 0b10000000: + n = b & 0b00001111 + typ = TYPE_MAP + if n > self._max_map_len: + raise ValueError(f"{n} exceeds max_map_len({self._max_map_len})") + elif b == 0xC0: + obj = None + elif b == 0xC2: + obj = False + elif b == 0xC3: + obj = True + elif 0xC4 <= b <= 0xC6: + size, fmt, typ = _MSGPACK_HEADERS[b] + self._reserve(size) + if len(fmt) > 0: + n = struct.unpack_from(fmt, self._buffer, self._buff_i)[0] + else: + n = self._buffer[self._buff_i] + self._buff_i += size + if n > self._max_bin_len: + raise ValueError(f"{n} exceeds max_bin_len({self._max_bin_len})") + obj = self._read(n) + elif 0xC7 <= b <= 0xC9: + size, fmt, typ = _MSGPACK_HEADERS[b] + self._reserve(size) + L, n = struct.unpack_from(fmt, self._buffer, self._buff_i) + self._buff_i += size + if L > self._max_ext_len: + raise ValueError(f"{L} exceeds max_ext_len({self._max_ext_len})") + obj = self._read(L) + elif 0xCA <= b <= 0xD3: + size, fmt = _MSGPACK_HEADERS[b] + self._reserve(size) + if len(fmt) > 0: + obj = struct.unpack_from(fmt, self._buffer, self._buff_i)[0] + else: + obj = self._buffer[self._buff_i] + self._buff_i += size + elif 0xD4 <= b <= 0xD8: + size, fmt, typ = _MSGPACK_HEADERS[b] + if self._max_ext_len < size: + raise ValueError(f"{size} exceeds max_ext_len({self._max_ext_len})") + self._reserve(size + 1) + n, obj = struct.unpack_from(fmt, self._buffer, self._buff_i) + self._buff_i += size + 1 + elif 0xD9 <= b <= 0xDB: + size, fmt, typ = _MSGPACK_HEADERS[b] + self._reserve(size) + if len(fmt) > 0: + (n,) = struct.unpack_from(fmt, self._buffer, self._buff_i) + else: + n = self._buffer[self._buff_i] + self._buff_i += size + if n > self._max_str_len: + raise ValueError(f"{n} exceeds max_str_len({self._max_str_len})") + obj = self._read(n) + elif 0xDC <= b <= 0xDD: + size, fmt, typ = _MSGPACK_HEADERS[b] + self._reserve(size) + (n,) = struct.unpack_from(fmt, self._buffer, self._buff_i) + self._buff_i += size + if n > self._max_array_len: + raise ValueError(f"{n} exceeds max_array_len({self._max_array_len})") + elif 0xDE <= b <= 0xDF: + size, fmt, typ = _MSGPACK_HEADERS[b] + self._reserve(size) + (n,) = struct.unpack_from(fmt, self._buffer, self._buff_i) + self._buff_i += size + if n > self._max_map_len: + raise ValueError(f"{n} exceeds max_map_len({self._max_map_len})") + else: + raise FormatError("Unknown header: 0x%x" % b) + return typ, n, obj + + def _unpack(self, execute=EX_CONSTRUCT): + typ, n, obj = self._read_header() + + if execute == EX_READ_ARRAY_HEADER: + if typ != TYPE_ARRAY: + raise ValueError("Expected array") + return n + if execute == EX_READ_MAP_HEADER: + if typ != TYPE_MAP: + raise ValueError("Expected map") + return n + # TODO should we eliminate the recursion? + if typ == TYPE_ARRAY: + if execute == EX_SKIP: + for i in range(n): + # TODO check whether we need to call `list_hook` + self._unpack(EX_SKIP) + return + ret = newlist_hint(n) + for i in range(n): + ret.append(self._unpack(EX_CONSTRUCT)) + if self._list_hook is not None: + ret = self._list_hook(ret) + # TODO is the interaction between `list_hook` and `use_list` ok? + return ret if self._use_list else tuple(ret) + if typ == TYPE_MAP: + if execute == EX_SKIP: + for i in range(n): + # TODO check whether we need to call hooks + self._unpack(EX_SKIP) + self._unpack(EX_SKIP) + return + if self._object_pairs_hook is not None: + ret = self._object_pairs_hook( + (self._unpack(EX_CONSTRUCT), self._unpack(EX_CONSTRUCT)) for _ in range(n) + ) + else: + ret = {} + for _ in range(n): + key = self._unpack(EX_CONSTRUCT) + if self._strict_map_key and type(key) not in (str, bytes): + raise ValueError("%s is not allowed for map key" % str(type(key))) + if isinstance(key, str): + key = sys.intern(key) + ret[key] = self._unpack(EX_CONSTRUCT) + if self._object_hook is not None: + ret = self._object_hook(ret) + return ret + if execute == EX_SKIP: + return + if typ == TYPE_RAW: + if self._raw: + obj = bytes(obj) + else: + obj = obj.decode("utf_8", self._unicode_errors) + return obj + if typ == TYPE_BIN: + return bytes(obj) + if typ == TYPE_EXT: + if n == -1: # timestamp + ts = Timestamp.from_bytes(bytes(obj)) + if self._timestamp == 1: + return ts.to_unix() + elif self._timestamp == 2: + return ts.to_unix_nano() + elif self._timestamp == 3: + return ts.to_datetime() + else: + return ts + else: + return self._ext_hook(n, bytes(obj)) + assert typ == TYPE_IMMEDIATE + return obj + + def __iter__(self): + return self + + def __next__(self): + try: + ret = self._unpack(EX_CONSTRUCT) + self._consume() + return ret + except OutOfData: + self._consume() + raise StopIteration + except RecursionError: + raise StackError + + next = __next__ + + def skip(self): + self._unpack(EX_SKIP) + self._consume() + + def unpack(self): + try: + ret = self._unpack(EX_CONSTRUCT) + except RecursionError: + raise StackError + self._consume() + return ret + + def read_array_header(self): + ret = self._unpack(EX_READ_ARRAY_HEADER) + self._consume() + return ret + + def read_map_header(self): + ret = self._unpack(EX_READ_MAP_HEADER) + self._consume() + return ret + + def tell(self): + return self._stream_offset + + +class Packer: + """ + MessagePack Packer + + Usage:: + + packer = Packer() + astream.write(packer.pack(a)) + astream.write(packer.pack(b)) + + Packer's constructor has some keyword arguments: + + :param default: + When specified, it should be callable. + Convert user type to builtin type that Packer supports. + See also simplejson's document. + + :param bool use_single_float: + Use single precision float type for float. (default: False) + + :param bool autoreset: + Reset buffer after each pack and return its content as `bytes`. (default: True). + If set this to false, use `bytes()` to get content and `.reset()` to clear buffer. + + :param bool use_bin_type: + Use bin type introduced in msgpack spec 2.0 for bytes. + It also enables str8 type for unicode. (default: True) + + :param bool strict_types: + If set to true, types will be checked to be exact. Derived classes + from serializable types will not be serialized and will be + treated as unsupported type and forwarded to default. + Additionally tuples will not be serialized as lists. + This is useful when trying to implement accurate serialization + for python types. + + :param bool datetime: + If set to true, datetime with tzinfo is packed into Timestamp type. + Note that the tzinfo is stripped in the timestamp. + You can get UTC datetime with `timestamp=3` option of the Unpacker. + + :param str unicode_errors: + The error handler for encoding unicode. (default: 'strict') + DO NOT USE THIS!! This option is kept for very specific usage. + + :param int buf_size: + Internal buffer size. This option is used only for C implementation. + """ + + def __init__( + self, + *, + default=None, + use_single_float=False, + autoreset=True, + use_bin_type=True, + strict_types=False, + datetime=False, + unicode_errors=None, + buf_size=None, + ): + self._strict_types = strict_types + self._use_float = use_single_float + self._autoreset = autoreset + self._use_bin_type = use_bin_type + self._buffer = BytesIO() + self._datetime = bool(datetime) + self._unicode_errors = unicode_errors or "strict" + if default is not None and not callable(default): + raise TypeError("default must be callable") + self._default = default + + def _pack( + self, + obj, + nest_limit=DEFAULT_RECURSE_LIMIT, + check=isinstance, + check_type_strict=_check_type_strict, + ): + default_used = False + if self._strict_types: + check = check_type_strict + list_types = list + else: + list_types = (list, tuple) + while True: + if nest_limit < 0: + raise ValueError("recursion limit exceeded") + if obj is None: + return self._buffer.write(b"\xc0") + if check(obj, bool): + if obj: + return self._buffer.write(b"\xc3") + return self._buffer.write(b"\xc2") + if check(obj, int): + if 0 <= obj < 0x80: + return self._buffer.write(struct.pack("B", obj)) + if -0x20 <= obj < 0: + return self._buffer.write(struct.pack("b", obj)) + if 0x80 <= obj <= 0xFF: + return self._buffer.write(struct.pack("BB", 0xCC, obj)) + if -0x80 <= obj < 0: + return self._buffer.write(struct.pack(">Bb", 0xD0, obj)) + if 0xFF < obj <= 0xFFFF: + return self._buffer.write(struct.pack(">BH", 0xCD, obj)) + if -0x8000 <= obj < -0x80: + return self._buffer.write(struct.pack(">Bh", 0xD1, obj)) + if 0xFFFF < obj <= 0xFFFFFFFF: + return self._buffer.write(struct.pack(">BI", 0xCE, obj)) + if -0x80000000 <= obj < -0x8000: + return self._buffer.write(struct.pack(">Bi", 0xD2, obj)) + if 0xFFFFFFFF < obj <= 0xFFFFFFFFFFFFFFFF: + return self._buffer.write(struct.pack(">BQ", 0xCF, obj)) + if -0x8000000000000000 <= obj < -0x80000000: + return self._buffer.write(struct.pack(">Bq", 0xD3, obj)) + if not default_used and self._default is not None: + obj = self._default(obj) + default_used = True + continue + raise OverflowError("Integer value out of range") + if check(obj, (bytes, bytearray)): + n = len(obj) + if n >= 2**32: + raise ValueError("%s is too large" % type(obj).__name__) + self._pack_bin_header(n) + return self._buffer.write(obj) + if check(obj, str): + obj = obj.encode("utf-8", self._unicode_errors) + n = len(obj) + if n >= 2**32: + raise ValueError("String is too large") + self._pack_raw_header(n) + return self._buffer.write(obj) + if check(obj, memoryview): + n = obj.nbytes + if n >= 2**32: + raise ValueError("Memoryview is too large") + self._pack_bin_header(n) + return self._buffer.write(obj) + if check(obj, float): + if self._use_float: + return self._buffer.write(struct.pack(">Bf", 0xCA, obj)) + return self._buffer.write(struct.pack(">Bd", 0xCB, obj)) + if check(obj, (ExtType, Timestamp)): + if check(obj, Timestamp): + code = -1 + data = obj.to_bytes() + else: + code = obj.code + data = obj.data + assert isinstance(code, int) + assert isinstance(data, bytes) + L = len(data) + if L == 1: + self._buffer.write(b"\xd4") + elif L == 2: + self._buffer.write(b"\xd5") + elif L == 4: + self._buffer.write(b"\xd6") + elif L == 8: + self._buffer.write(b"\xd7") + elif L == 16: + self._buffer.write(b"\xd8") + elif L <= 0xFF: + self._buffer.write(struct.pack(">BB", 0xC7, L)) + elif L <= 0xFFFF: + self._buffer.write(struct.pack(">BH", 0xC8, L)) + else: + self._buffer.write(struct.pack(">BI", 0xC9, L)) + self._buffer.write(struct.pack("b", code)) + self._buffer.write(data) + return + if check(obj, list_types): + n = len(obj) + self._pack_array_header(n) + for i in range(n): + self._pack(obj[i], nest_limit - 1) + return + if check(obj, dict): + return self._pack_map_pairs(len(obj), obj.items(), nest_limit - 1) + + if self._datetime and check(obj, _DateTime) and obj.tzinfo is not None: + obj = Timestamp.from_datetime(obj) + default_used = 1 + continue + + if not default_used and self._default is not None: + obj = self._default(obj) + default_used = 1 + continue + + if self._datetime and check(obj, _DateTime): + raise ValueError(f"Cannot serialize {obj!r} where tzinfo=None") + + raise TypeError(f"Cannot serialize {obj!r}") + + def pack(self, obj): + try: + self._pack(obj) + except: + self._buffer = BytesIO() # force reset + raise + if self._autoreset: + ret = self._buffer.getvalue() + self._buffer = BytesIO() + return ret + + def pack_map_pairs(self, pairs): + self._pack_map_pairs(len(pairs), pairs) + if self._autoreset: + ret = self._buffer.getvalue() + self._buffer = BytesIO() + return ret + + def pack_array_header(self, n): + if n >= 2**32: + raise ValueError + self._pack_array_header(n) + if self._autoreset: + ret = self._buffer.getvalue() + self._buffer = BytesIO() + return ret + + def pack_map_header(self, n): + if n >= 2**32: + raise ValueError + self._pack_map_header(n) + if self._autoreset: + ret = self._buffer.getvalue() + self._buffer = BytesIO() + return ret + + def pack_ext_type(self, typecode, data): + if not isinstance(typecode, int): + raise TypeError("typecode must have int type.") + if not 0 <= typecode <= 127: + raise ValueError("typecode should be 0-127") + if not isinstance(data, bytes): + raise TypeError("data must have bytes type") + L = len(data) + if L > 0xFFFFFFFF: + raise ValueError("Too large data") + if L == 1: + self._buffer.write(b"\xd4") + elif L == 2: + self._buffer.write(b"\xd5") + elif L == 4: + self._buffer.write(b"\xd6") + elif L == 8: + self._buffer.write(b"\xd7") + elif L == 16: + self._buffer.write(b"\xd8") + elif L <= 0xFF: + self._buffer.write(b"\xc7" + struct.pack("B", L)) + elif L <= 0xFFFF: + self._buffer.write(b"\xc8" + struct.pack(">H", L)) + else: + self._buffer.write(b"\xc9" + struct.pack(">I", L)) + self._buffer.write(struct.pack("B", typecode)) + self._buffer.write(data) + + def _pack_array_header(self, n): + if n <= 0x0F: + return self._buffer.write(struct.pack("B", 0x90 + n)) + if n <= 0xFFFF: + return self._buffer.write(struct.pack(">BH", 0xDC, n)) + if n <= 0xFFFFFFFF: + return self._buffer.write(struct.pack(">BI", 0xDD, n)) + raise ValueError("Array is too large") + + def _pack_map_header(self, n): + if n <= 0x0F: + return self._buffer.write(struct.pack("B", 0x80 + n)) + if n <= 0xFFFF: + return self._buffer.write(struct.pack(">BH", 0xDE, n)) + if n <= 0xFFFFFFFF: + return self._buffer.write(struct.pack(">BI", 0xDF, n)) + raise ValueError("Dict is too large") + + def _pack_map_pairs(self, n, pairs, nest_limit=DEFAULT_RECURSE_LIMIT): + self._pack_map_header(n) + for k, v in pairs: + self._pack(k, nest_limit - 1) + self._pack(v, nest_limit - 1) + + def _pack_raw_header(self, n): + if n <= 0x1F: + self._buffer.write(struct.pack("B", 0xA0 + n)) + elif self._use_bin_type and n <= 0xFF: + self._buffer.write(struct.pack(">BB", 0xD9, n)) + elif n <= 0xFFFF: + self._buffer.write(struct.pack(">BH", 0xDA, n)) + elif n <= 0xFFFFFFFF: + self._buffer.write(struct.pack(">BI", 0xDB, n)) + else: + raise ValueError("Raw is too large") + + def _pack_bin_header(self, n): + if not self._use_bin_type: + return self._pack_raw_header(n) + elif n <= 0xFF: + return self._buffer.write(struct.pack(">BB", 0xC4, n)) + elif n <= 0xFFFF: + return self._buffer.write(struct.pack(">BH", 0xC5, n)) + elif n <= 0xFFFFFFFF: + return self._buffer.write(struct.pack(">BI", 0xC6, n)) + else: + raise ValueError("Bin is too large") + + def bytes(self): + """Return internal buffer contents as bytes object""" + return self._buffer.getvalue() + + def reset(self): + """Reset internal buffer. + + This method is useful only when autoreset=False. + """ + self._buffer = BytesIO() + + def getbuffer(self): + """Return view of internal buffer.""" + if _USING_STRINGBUILDER: + return memoryview(self.bytes()) + else: + return self._buffer.getbuffer() diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/__init__.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/__init__.py new file mode 100644 index 0000000..d79f73c --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/__init__.py @@ -0,0 +1,15 @@ +# This file is dual licensed under the terms of the Apache License, Version +# 2.0, and the BSD License. See the LICENSE file in the root of this repository +# for complete details. + +__title__ = "packaging" +__summary__ = "Core utilities for Python packages" +__uri__ = "https://github.com/pypa/packaging" + +__version__ = "24.2" + +__author__ = "Donald Stufft and individual contributors" +__email__ = "donald@stufft.io" + +__license__ = "BSD-2-Clause or Apache-2.0" +__copyright__ = f"2014 {__author__}" diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/__pycache__/__init__.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000..50e2d5c Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/__pycache__/__init__.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/__pycache__/_elffile.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/__pycache__/_elffile.cpython-312.pyc new file mode 100644 index 0000000..b43529f Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/__pycache__/_elffile.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/__pycache__/_manylinux.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/__pycache__/_manylinux.cpython-312.pyc new file mode 100644 index 0000000..46599fe Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/__pycache__/_manylinux.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/__pycache__/_musllinux.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/__pycache__/_musllinux.cpython-312.pyc new file mode 100644 index 0000000..80980c8 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/__pycache__/_musllinux.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/__pycache__/_parser.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/__pycache__/_parser.cpython-312.pyc new file mode 100644 index 0000000..98d7583 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/__pycache__/_parser.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/__pycache__/_structures.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/__pycache__/_structures.cpython-312.pyc new file mode 100644 index 0000000..364b14b Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/__pycache__/_structures.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/__pycache__/_tokenizer.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/__pycache__/_tokenizer.cpython-312.pyc new file mode 100644 index 0000000..d5a7027 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/__pycache__/_tokenizer.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/__pycache__/markers.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/__pycache__/markers.cpython-312.pyc new file mode 100644 index 0000000..e211213 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/__pycache__/markers.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/__pycache__/metadata.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/__pycache__/metadata.cpython-312.pyc new file mode 100644 index 0000000..12645ff Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/__pycache__/metadata.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/__pycache__/requirements.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/__pycache__/requirements.cpython-312.pyc new file mode 100644 index 0000000..d6100e7 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/__pycache__/requirements.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/__pycache__/specifiers.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/__pycache__/specifiers.cpython-312.pyc new file mode 100644 index 0000000..246f2ef Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/__pycache__/specifiers.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/__pycache__/tags.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/__pycache__/tags.cpython-312.pyc new file mode 100644 index 0000000..f64d831 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/__pycache__/tags.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/__pycache__/utils.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/__pycache__/utils.cpython-312.pyc new file mode 100644 index 0000000..673ee7d Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/__pycache__/utils.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/__pycache__/version.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/__pycache__/version.cpython-312.pyc new file mode 100644 index 0000000..7c8629e Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/__pycache__/version.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/_elffile.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/_elffile.py new file mode 100644 index 0000000..25f4282 --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/_elffile.py @@ -0,0 +1,110 @@ +""" +ELF file parser. + +This provides a class ``ELFFile`` that parses an ELF executable in a similar +interface to ``ZipFile``. Only the read interface is implemented. + +Based on: https://gist.github.com/lyssdod/f51579ae8d93c8657a5564aefc2ffbca +ELF header: https://refspecs.linuxfoundation.org/elf/gabi4+/ch4.eheader.html +""" + +from __future__ import annotations + +import enum +import os +import struct +from typing import IO + + +class ELFInvalid(ValueError): + pass + + +class EIClass(enum.IntEnum): + C32 = 1 + C64 = 2 + + +class EIData(enum.IntEnum): + Lsb = 1 + Msb = 2 + + +class EMachine(enum.IntEnum): + I386 = 3 + S390 = 22 + Arm = 40 + X8664 = 62 + AArc64 = 183 + + +class ELFFile: + """ + Representation of an ELF executable. + """ + + def __init__(self, f: IO[bytes]) -> None: + self._f = f + + try: + ident = self._read("16B") + except struct.error as e: + raise ELFInvalid("unable to parse identification") from e + magic = bytes(ident[:4]) + if magic != b"\x7fELF": + raise ELFInvalid(f"invalid magic: {magic!r}") + + self.capacity = ident[4] # Format for program header (bitness). + self.encoding = ident[5] # Data structure encoding (endianness). + + try: + # e_fmt: Format for program header. + # p_fmt: Format for section header. + # p_idx: Indexes to find p_type, p_offset, and p_filesz. + e_fmt, self._p_fmt, self._p_idx = { + (1, 1): ("HHIIIIIHHH", ">IIIIIIII", (0, 1, 4)), # 32-bit MSB. + (2, 1): ("HHIQQQIHHH", ">IIQQQQQQ", (0, 2, 5)), # 64-bit MSB. + }[(self.capacity, self.encoding)] + except KeyError as e: + raise ELFInvalid( + f"unrecognized capacity ({self.capacity}) or " + f"encoding ({self.encoding})" + ) from e + + try: + ( + _, + self.machine, # Architecture type. + _, + _, + self._e_phoff, # Offset of program header. + _, + self.flags, # Processor-specific flags. + _, + self._e_phentsize, # Size of section. + self._e_phnum, # Number of sections. + ) = self._read(e_fmt) + except struct.error as e: + raise ELFInvalid("unable to parse machine and section information") from e + + def _read(self, fmt: str) -> tuple[int, ...]: + return struct.unpack(fmt, self._f.read(struct.calcsize(fmt))) + + @property + def interpreter(self) -> str | None: + """ + The path recorded in the ``PT_INTERP`` section header. + """ + for index in range(self._e_phnum): + self._f.seek(self._e_phoff + self._e_phentsize * index) + try: + data = self._read(self._p_fmt) + except struct.error: + continue + if data[self._p_idx[0]] != 3: # Not PT_INTERP. + continue + self._f.seek(data[self._p_idx[1]]) + return os.fsdecode(self._f.read(data[self._p_idx[2]])).strip("\0") + return None diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/_manylinux.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/_manylinux.py new file mode 100644 index 0000000..61339a6 --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/_manylinux.py @@ -0,0 +1,263 @@ +from __future__ import annotations + +import collections +import contextlib +import functools +import os +import re +import sys +import warnings +from typing import Generator, Iterator, NamedTuple, Sequence + +from ._elffile import EIClass, EIData, ELFFile, EMachine + +EF_ARM_ABIMASK = 0xFF000000 +EF_ARM_ABI_VER5 = 0x05000000 +EF_ARM_ABI_FLOAT_HARD = 0x00000400 + + +# `os.PathLike` not a generic type until Python 3.9, so sticking with `str` +# as the type for `path` until then. +@contextlib.contextmanager +def _parse_elf(path: str) -> Generator[ELFFile | None, None, None]: + try: + with open(path, "rb") as f: + yield ELFFile(f) + except (OSError, TypeError, ValueError): + yield None + + +def _is_linux_armhf(executable: str) -> bool: + # hard-float ABI can be detected from the ELF header of the running + # process + # https://static.docs.arm.com/ihi0044/g/aaelf32.pdf + with _parse_elf(executable) as f: + return ( + f is not None + and f.capacity == EIClass.C32 + and f.encoding == EIData.Lsb + and f.machine == EMachine.Arm + and f.flags & EF_ARM_ABIMASK == EF_ARM_ABI_VER5 + and f.flags & EF_ARM_ABI_FLOAT_HARD == EF_ARM_ABI_FLOAT_HARD + ) + + +def _is_linux_i686(executable: str) -> bool: + with _parse_elf(executable) as f: + return ( + f is not None + and f.capacity == EIClass.C32 + and f.encoding == EIData.Lsb + and f.machine == EMachine.I386 + ) + + +def _have_compatible_abi(executable: str, archs: Sequence[str]) -> bool: + if "armv7l" in archs: + return _is_linux_armhf(executable) + if "i686" in archs: + return _is_linux_i686(executable) + allowed_archs = { + "x86_64", + "aarch64", + "ppc64", + "ppc64le", + "s390x", + "loongarch64", + "riscv64", + } + return any(arch in allowed_archs for arch in archs) + + +# If glibc ever changes its major version, we need to know what the last +# minor version was, so we can build the complete list of all versions. +# For now, guess what the highest minor version might be, assume it will +# be 50 for testing. Once this actually happens, update the dictionary +# with the actual value. +_LAST_GLIBC_MINOR: dict[int, int] = collections.defaultdict(lambda: 50) + + +class _GLibCVersion(NamedTuple): + major: int + minor: int + + +def _glibc_version_string_confstr() -> str | None: + """ + Primary implementation of glibc_version_string using os.confstr. + """ + # os.confstr is quite a bit faster than ctypes.DLL. It's also less likely + # to be broken or missing. This strategy is used in the standard library + # platform module. + # https://github.com/python/cpython/blob/fcf1d003bf4f0100c/Lib/platform.py#L175-L183 + try: + # Should be a string like "glibc 2.17". + version_string: str | None = os.confstr("CS_GNU_LIBC_VERSION") + assert version_string is not None + _, version = version_string.rsplit() + except (AssertionError, AttributeError, OSError, ValueError): + # os.confstr() or CS_GNU_LIBC_VERSION not available (or a bad value)... + return None + return version + + +def _glibc_version_string_ctypes() -> str | None: + """ + Fallback implementation of glibc_version_string using ctypes. + """ + try: + import ctypes + except ImportError: + return None + + # ctypes.CDLL(None) internally calls dlopen(NULL), and as the dlopen + # manpage says, "If filename is NULL, then the returned handle is for the + # main program". This way we can let the linker do the work to figure out + # which libc our process is actually using. + # + # We must also handle the special case where the executable is not a + # dynamically linked executable. This can occur when using musl libc, + # for example. In this situation, dlopen() will error, leading to an + # OSError. Interestingly, at least in the case of musl, there is no + # errno set on the OSError. The single string argument used to construct + # OSError comes from libc itself and is therefore not portable to + # hard code here. In any case, failure to call dlopen() means we + # can proceed, so we bail on our attempt. + try: + process_namespace = ctypes.CDLL(None) + except OSError: + return None + + try: + gnu_get_libc_version = process_namespace.gnu_get_libc_version + except AttributeError: + # Symbol doesn't exist -> therefore, we are not linked to + # glibc. + return None + + # Call gnu_get_libc_version, which returns a string like "2.5" + gnu_get_libc_version.restype = ctypes.c_char_p + version_str: str = gnu_get_libc_version() + # py2 / py3 compatibility: + if not isinstance(version_str, str): + version_str = version_str.decode("ascii") + + return version_str + + +def _glibc_version_string() -> str | None: + """Returns glibc version string, or None if not using glibc.""" + return _glibc_version_string_confstr() or _glibc_version_string_ctypes() + + +def _parse_glibc_version(version_str: str) -> tuple[int, int]: + """Parse glibc version. + + We use a regexp instead of str.split because we want to discard any + random junk that might come after the minor version -- this might happen + in patched/forked versions of glibc (e.g. Linaro's version of glibc + uses version strings like "2.20-2014.11"). See gh-3588. + """ + m = re.match(r"(?P[0-9]+)\.(?P[0-9]+)", version_str) + if not m: + warnings.warn( + f"Expected glibc version with 2 components major.minor," + f" got: {version_str}", + RuntimeWarning, + stacklevel=2, + ) + return -1, -1 + return int(m.group("major")), int(m.group("minor")) + + +@functools.lru_cache +def _get_glibc_version() -> tuple[int, int]: + version_str = _glibc_version_string() + if version_str is None: + return (-1, -1) + return _parse_glibc_version(version_str) + + +# From PEP 513, PEP 600 +def _is_compatible(arch: str, version: _GLibCVersion) -> bool: + sys_glibc = _get_glibc_version() + if sys_glibc < version: + return False + # Check for presence of _manylinux module. + try: + import _manylinux + except ImportError: + return True + if hasattr(_manylinux, "manylinux_compatible"): + result = _manylinux.manylinux_compatible(version[0], version[1], arch) + if result is not None: + return bool(result) + return True + if version == _GLibCVersion(2, 5): + if hasattr(_manylinux, "manylinux1_compatible"): + return bool(_manylinux.manylinux1_compatible) + if version == _GLibCVersion(2, 12): + if hasattr(_manylinux, "manylinux2010_compatible"): + return bool(_manylinux.manylinux2010_compatible) + if version == _GLibCVersion(2, 17): + if hasattr(_manylinux, "manylinux2014_compatible"): + return bool(_manylinux.manylinux2014_compatible) + return True + + +_LEGACY_MANYLINUX_MAP = { + # CentOS 7 w/ glibc 2.17 (PEP 599) + (2, 17): "manylinux2014", + # CentOS 6 w/ glibc 2.12 (PEP 571) + (2, 12): "manylinux2010", + # CentOS 5 w/ glibc 2.5 (PEP 513) + (2, 5): "manylinux1", +} + + +def platform_tags(archs: Sequence[str]) -> Iterator[str]: + """Generate manylinux tags compatible to the current platform. + + :param archs: Sequence of compatible architectures. + The first one shall be the closest to the actual architecture and be the part of + platform tag after the ``linux_`` prefix, e.g. ``x86_64``. + The ``linux_`` prefix is assumed as a prerequisite for the current platform to + be manylinux-compatible. + + :returns: An iterator of compatible manylinux tags. + """ + if not _have_compatible_abi(sys.executable, archs): + return + # Oldest glibc to be supported regardless of architecture is (2, 17). + too_old_glibc2 = _GLibCVersion(2, 16) + if set(archs) & {"x86_64", "i686"}: + # On x86/i686 also oldest glibc to be supported is (2, 5). + too_old_glibc2 = _GLibCVersion(2, 4) + current_glibc = _GLibCVersion(*_get_glibc_version()) + glibc_max_list = [current_glibc] + # We can assume compatibility across glibc major versions. + # https://sourceware.org/bugzilla/show_bug.cgi?id=24636 + # + # Build a list of maximum glibc versions so that we can + # output the canonical list of all glibc from current_glibc + # down to too_old_glibc2, including all intermediary versions. + for glibc_major in range(current_glibc.major - 1, 1, -1): + glibc_minor = _LAST_GLIBC_MINOR[glibc_major] + glibc_max_list.append(_GLibCVersion(glibc_major, glibc_minor)) + for arch in archs: + for glibc_max in glibc_max_list: + if glibc_max.major == too_old_glibc2.major: + min_minor = too_old_glibc2.minor + else: + # For other glibc major versions oldest supported is (x, 0). + min_minor = -1 + for glibc_minor in range(glibc_max.minor, min_minor, -1): + glibc_version = _GLibCVersion(glibc_max.major, glibc_minor) + tag = "manylinux_{}_{}".format(*glibc_version) + if _is_compatible(arch, glibc_version): + yield f"{tag}_{arch}" + # Handle the legacy manylinux1, manylinux2010, manylinux2014 tags. + if glibc_version in _LEGACY_MANYLINUX_MAP: + legacy_tag = _LEGACY_MANYLINUX_MAP[glibc_version] + if _is_compatible(arch, glibc_version): + yield f"{legacy_tag}_{arch}" diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/_musllinux.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/_musllinux.py new file mode 100644 index 0000000..d2bf30b --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/_musllinux.py @@ -0,0 +1,85 @@ +"""PEP 656 support. + +This module implements logic to detect if the currently running Python is +linked against musl, and what musl version is used. +""" + +from __future__ import annotations + +import functools +import re +import subprocess +import sys +from typing import Iterator, NamedTuple, Sequence + +from ._elffile import ELFFile + + +class _MuslVersion(NamedTuple): + major: int + minor: int + + +def _parse_musl_version(output: str) -> _MuslVersion | None: + lines = [n for n in (n.strip() for n in output.splitlines()) if n] + if len(lines) < 2 or lines[0][:4] != "musl": + return None + m = re.match(r"Version (\d+)\.(\d+)", lines[1]) + if not m: + return None + return _MuslVersion(major=int(m.group(1)), minor=int(m.group(2))) + + +@functools.lru_cache +def _get_musl_version(executable: str) -> _MuslVersion | None: + """Detect currently-running musl runtime version. + + This is done by checking the specified executable's dynamic linking + information, and invoking the loader to parse its output for a version + string. If the loader is musl, the output would be something like:: + + musl libc (x86_64) + Version 1.2.2 + Dynamic Program Loader + """ + try: + with open(executable, "rb") as f: + ld = ELFFile(f).interpreter + except (OSError, TypeError, ValueError): + return None + if ld is None or "musl" not in ld: + return None + proc = subprocess.run([ld], stderr=subprocess.PIPE, text=True) + return _parse_musl_version(proc.stderr) + + +def platform_tags(archs: Sequence[str]) -> Iterator[str]: + """Generate musllinux tags compatible to the current platform. + + :param archs: Sequence of compatible architectures. + The first one shall be the closest to the actual architecture and be the part of + platform tag after the ``linux_`` prefix, e.g. ``x86_64``. + The ``linux_`` prefix is assumed as a prerequisite for the current platform to + be musllinux-compatible. + + :returns: An iterator of compatible musllinux tags. + """ + sys_musl = _get_musl_version(sys.executable) + if sys_musl is None: # Python not dynamically linked against musl. + return + for arch in archs: + for minor in range(sys_musl.minor, -1, -1): + yield f"musllinux_{sys_musl.major}_{minor}_{arch}" + + +if __name__ == "__main__": # pragma: no cover + import sysconfig + + plat = sysconfig.get_platform() + assert plat.startswith("linux-"), "not linux" + + print("plat:", plat) + print("musl:", _get_musl_version(sys.executable)) + print("tags:", end=" ") + for t in platform_tags(re.sub(r"[.-]", "_", plat.split("-", 1)[-1])): + print(t, end="\n ") diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/_parser.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/_parser.py new file mode 100644 index 0000000..c1238c0 --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/_parser.py @@ -0,0 +1,354 @@ +"""Handwritten parser of dependency specifiers. + +The docstring for each __parse_* function contains EBNF-inspired grammar representing +the implementation. +""" + +from __future__ import annotations + +import ast +from typing import NamedTuple, Sequence, Tuple, Union + +from ._tokenizer import DEFAULT_RULES, Tokenizer + + +class Node: + def __init__(self, value: str) -> None: + self.value = value + + def __str__(self) -> str: + return self.value + + def __repr__(self) -> str: + return f"<{self.__class__.__name__}('{self}')>" + + def serialize(self) -> str: + raise NotImplementedError + + +class Variable(Node): + def serialize(self) -> str: + return str(self) + + +class Value(Node): + def serialize(self) -> str: + return f'"{self}"' + + +class Op(Node): + def serialize(self) -> str: + return str(self) + + +MarkerVar = Union[Variable, Value] +MarkerItem = Tuple[MarkerVar, Op, MarkerVar] +MarkerAtom = Union[MarkerItem, Sequence["MarkerAtom"]] +MarkerList = Sequence[Union["MarkerList", MarkerAtom, str]] + + +class ParsedRequirement(NamedTuple): + name: str + url: str + extras: list[str] + specifier: str + marker: MarkerList | None + + +# -------------------------------------------------------------------------------------- +# Recursive descent parser for dependency specifier +# -------------------------------------------------------------------------------------- +def parse_requirement(source: str) -> ParsedRequirement: + return _parse_requirement(Tokenizer(source, rules=DEFAULT_RULES)) + + +def _parse_requirement(tokenizer: Tokenizer) -> ParsedRequirement: + """ + requirement = WS? IDENTIFIER WS? extras WS? requirement_details + """ + tokenizer.consume("WS") + + name_token = tokenizer.expect( + "IDENTIFIER", expected="package name at the start of dependency specifier" + ) + name = name_token.text + tokenizer.consume("WS") + + extras = _parse_extras(tokenizer) + tokenizer.consume("WS") + + url, specifier, marker = _parse_requirement_details(tokenizer) + tokenizer.expect("END", expected="end of dependency specifier") + + return ParsedRequirement(name, url, extras, specifier, marker) + + +def _parse_requirement_details( + tokenizer: Tokenizer, +) -> tuple[str, str, MarkerList | None]: + """ + requirement_details = AT URL (WS requirement_marker?)? + | specifier WS? (requirement_marker)? + """ + + specifier = "" + url = "" + marker = None + + if tokenizer.check("AT"): + tokenizer.read() + tokenizer.consume("WS") + + url_start = tokenizer.position + url = tokenizer.expect("URL", expected="URL after @").text + if tokenizer.check("END", peek=True): + return (url, specifier, marker) + + tokenizer.expect("WS", expected="whitespace after URL") + + # The input might end after whitespace. + if tokenizer.check("END", peek=True): + return (url, specifier, marker) + + marker = _parse_requirement_marker( + tokenizer, span_start=url_start, after="URL and whitespace" + ) + else: + specifier_start = tokenizer.position + specifier = _parse_specifier(tokenizer) + tokenizer.consume("WS") + + if tokenizer.check("END", peek=True): + return (url, specifier, marker) + + marker = _parse_requirement_marker( + tokenizer, + span_start=specifier_start, + after=( + "version specifier" + if specifier + else "name and no valid version specifier" + ), + ) + + return (url, specifier, marker) + + +def _parse_requirement_marker( + tokenizer: Tokenizer, *, span_start: int, after: str +) -> MarkerList: + """ + requirement_marker = SEMICOLON marker WS? + """ + + if not tokenizer.check("SEMICOLON"): + tokenizer.raise_syntax_error( + f"Expected end or semicolon (after {after})", + span_start=span_start, + ) + tokenizer.read() + + marker = _parse_marker(tokenizer) + tokenizer.consume("WS") + + return marker + + +def _parse_extras(tokenizer: Tokenizer) -> list[str]: + """ + extras = (LEFT_BRACKET wsp* extras_list? wsp* RIGHT_BRACKET)? + """ + if not tokenizer.check("LEFT_BRACKET", peek=True): + return [] + + with tokenizer.enclosing_tokens( + "LEFT_BRACKET", + "RIGHT_BRACKET", + around="extras", + ): + tokenizer.consume("WS") + extras = _parse_extras_list(tokenizer) + tokenizer.consume("WS") + + return extras + + +def _parse_extras_list(tokenizer: Tokenizer) -> list[str]: + """ + extras_list = identifier (wsp* ',' wsp* identifier)* + """ + extras: list[str] = [] + + if not tokenizer.check("IDENTIFIER"): + return extras + + extras.append(tokenizer.read().text) + + while True: + tokenizer.consume("WS") + if tokenizer.check("IDENTIFIER", peek=True): + tokenizer.raise_syntax_error("Expected comma between extra names") + elif not tokenizer.check("COMMA"): + break + + tokenizer.read() + tokenizer.consume("WS") + + extra_token = tokenizer.expect("IDENTIFIER", expected="extra name after comma") + extras.append(extra_token.text) + + return extras + + +def _parse_specifier(tokenizer: Tokenizer) -> str: + """ + specifier = LEFT_PARENTHESIS WS? version_many WS? RIGHT_PARENTHESIS + | WS? version_many WS? + """ + with tokenizer.enclosing_tokens( + "LEFT_PARENTHESIS", + "RIGHT_PARENTHESIS", + around="version specifier", + ): + tokenizer.consume("WS") + parsed_specifiers = _parse_version_many(tokenizer) + tokenizer.consume("WS") + + return parsed_specifiers + + +def _parse_version_many(tokenizer: Tokenizer) -> str: + """ + version_many = (SPECIFIER (WS? COMMA WS? SPECIFIER)*)? + """ + parsed_specifiers = "" + while tokenizer.check("SPECIFIER"): + span_start = tokenizer.position + parsed_specifiers += tokenizer.read().text + if tokenizer.check("VERSION_PREFIX_TRAIL", peek=True): + tokenizer.raise_syntax_error( + ".* suffix can only be used with `==` or `!=` operators", + span_start=span_start, + span_end=tokenizer.position + 1, + ) + if tokenizer.check("VERSION_LOCAL_LABEL_TRAIL", peek=True): + tokenizer.raise_syntax_error( + "Local version label can only be used with `==` or `!=` operators", + span_start=span_start, + span_end=tokenizer.position, + ) + tokenizer.consume("WS") + if not tokenizer.check("COMMA"): + break + parsed_specifiers += tokenizer.read().text + tokenizer.consume("WS") + + return parsed_specifiers + + +# -------------------------------------------------------------------------------------- +# Recursive descent parser for marker expression +# -------------------------------------------------------------------------------------- +def parse_marker(source: str) -> MarkerList: + return _parse_full_marker(Tokenizer(source, rules=DEFAULT_RULES)) + + +def _parse_full_marker(tokenizer: Tokenizer) -> MarkerList: + retval = _parse_marker(tokenizer) + tokenizer.expect("END", expected="end of marker expression") + return retval + + +def _parse_marker(tokenizer: Tokenizer) -> MarkerList: + """ + marker = marker_atom (BOOLOP marker_atom)+ + """ + expression = [_parse_marker_atom(tokenizer)] + while tokenizer.check("BOOLOP"): + token = tokenizer.read() + expr_right = _parse_marker_atom(tokenizer) + expression.extend((token.text, expr_right)) + return expression + + +def _parse_marker_atom(tokenizer: Tokenizer) -> MarkerAtom: + """ + marker_atom = WS? LEFT_PARENTHESIS WS? marker WS? RIGHT_PARENTHESIS WS? + | WS? marker_item WS? + """ + + tokenizer.consume("WS") + if tokenizer.check("LEFT_PARENTHESIS", peek=True): + with tokenizer.enclosing_tokens( + "LEFT_PARENTHESIS", + "RIGHT_PARENTHESIS", + around="marker expression", + ): + tokenizer.consume("WS") + marker: MarkerAtom = _parse_marker(tokenizer) + tokenizer.consume("WS") + else: + marker = _parse_marker_item(tokenizer) + tokenizer.consume("WS") + return marker + + +def _parse_marker_item(tokenizer: Tokenizer) -> MarkerItem: + """ + marker_item = WS? marker_var WS? marker_op WS? marker_var WS? + """ + tokenizer.consume("WS") + marker_var_left = _parse_marker_var(tokenizer) + tokenizer.consume("WS") + marker_op = _parse_marker_op(tokenizer) + tokenizer.consume("WS") + marker_var_right = _parse_marker_var(tokenizer) + tokenizer.consume("WS") + return (marker_var_left, marker_op, marker_var_right) + + +def _parse_marker_var(tokenizer: Tokenizer) -> MarkerVar: + """ + marker_var = VARIABLE | QUOTED_STRING + """ + if tokenizer.check("VARIABLE"): + return process_env_var(tokenizer.read().text.replace(".", "_")) + elif tokenizer.check("QUOTED_STRING"): + return process_python_str(tokenizer.read().text) + else: + tokenizer.raise_syntax_error( + message="Expected a marker variable or quoted string" + ) + + +def process_env_var(env_var: str) -> Variable: + if env_var in ("platform_python_implementation", "python_implementation"): + return Variable("platform_python_implementation") + else: + return Variable(env_var) + + +def process_python_str(python_str: str) -> Value: + value = ast.literal_eval(python_str) + return Value(str(value)) + + +def _parse_marker_op(tokenizer: Tokenizer) -> Op: + """ + marker_op = IN | NOT IN | OP + """ + if tokenizer.check("IN"): + tokenizer.read() + return Op("in") + elif tokenizer.check("NOT"): + tokenizer.read() + tokenizer.expect("WS", expected="whitespace after 'not'") + tokenizer.expect("IN", expected="'in' after 'not'") + return Op("not in") + elif tokenizer.check("OP"): + return Op(tokenizer.read().text) + else: + return tokenizer.raise_syntax_error( + "Expected marker operator, one of " + "<=, <, !=, ==, >=, >, ~=, ===, in, not in" + ) diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/_structures.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/_structures.py new file mode 100644 index 0000000..90a6465 --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/_structures.py @@ -0,0 +1,61 @@ +# This file is dual licensed under the terms of the Apache License, Version +# 2.0, and the BSD License. See the LICENSE file in the root of this repository +# for complete details. + + +class InfinityType: + def __repr__(self) -> str: + return "Infinity" + + def __hash__(self) -> int: + return hash(repr(self)) + + def __lt__(self, other: object) -> bool: + return False + + def __le__(self, other: object) -> bool: + return False + + def __eq__(self, other: object) -> bool: + return isinstance(other, self.__class__) + + def __gt__(self, other: object) -> bool: + return True + + def __ge__(self, other: object) -> bool: + return True + + def __neg__(self: object) -> "NegativeInfinityType": + return NegativeInfinity + + +Infinity = InfinityType() + + +class NegativeInfinityType: + def __repr__(self) -> str: + return "-Infinity" + + def __hash__(self) -> int: + return hash(repr(self)) + + def __lt__(self, other: object) -> bool: + return True + + def __le__(self, other: object) -> bool: + return True + + def __eq__(self, other: object) -> bool: + return isinstance(other, self.__class__) + + def __gt__(self, other: object) -> bool: + return False + + def __ge__(self, other: object) -> bool: + return False + + def __neg__(self: object) -> InfinityType: + return Infinity + + +NegativeInfinity = NegativeInfinityType() diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/_tokenizer.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/_tokenizer.py new file mode 100644 index 0000000..89d0416 --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/_tokenizer.py @@ -0,0 +1,194 @@ +from __future__ import annotations + +import contextlib +import re +from dataclasses import dataclass +from typing import Iterator, NoReturn + +from .specifiers import Specifier + + +@dataclass +class Token: + name: str + text: str + position: int + + +class ParserSyntaxError(Exception): + """The provided source text could not be parsed correctly.""" + + def __init__( + self, + message: str, + *, + source: str, + span: tuple[int, int], + ) -> None: + self.span = span + self.message = message + self.source = source + + super().__init__() + + def __str__(self) -> str: + marker = " " * self.span[0] + "~" * (self.span[1] - self.span[0]) + "^" + return "\n ".join([self.message, self.source, marker]) + + +DEFAULT_RULES: dict[str, str | re.Pattern[str]] = { + "LEFT_PARENTHESIS": r"\(", + "RIGHT_PARENTHESIS": r"\)", + "LEFT_BRACKET": r"\[", + "RIGHT_BRACKET": r"\]", + "SEMICOLON": r";", + "COMMA": r",", + "QUOTED_STRING": re.compile( + r""" + ( + ('[^']*') + | + ("[^"]*") + ) + """, + re.VERBOSE, + ), + "OP": r"(===|==|~=|!=|<=|>=|<|>)", + "BOOLOP": r"\b(or|and)\b", + "IN": r"\bin\b", + "NOT": r"\bnot\b", + "VARIABLE": re.compile( + r""" + \b( + python_version + |python_full_version + |os[._]name + |sys[._]platform + |platform_(release|system) + |platform[._](version|machine|python_implementation) + |python_implementation + |implementation_(name|version) + |extra + )\b + """, + re.VERBOSE, + ), + "SPECIFIER": re.compile( + Specifier._operator_regex_str + Specifier._version_regex_str, + re.VERBOSE | re.IGNORECASE, + ), + "AT": r"\@", + "URL": r"[^ \t]+", + "IDENTIFIER": r"\b[a-zA-Z0-9][a-zA-Z0-9._-]*\b", + "VERSION_PREFIX_TRAIL": r"\.\*", + "VERSION_LOCAL_LABEL_TRAIL": r"\+[a-z0-9]+(?:[-_\.][a-z0-9]+)*", + "WS": r"[ \t]+", + "END": r"$", +} + + +class Tokenizer: + """Context-sensitive token parsing. + + Provides methods to examine the input stream to check whether the next token + matches. + """ + + def __init__( + self, + source: str, + *, + rules: dict[str, str | re.Pattern[str]], + ) -> None: + self.source = source + self.rules: dict[str, re.Pattern[str]] = { + name: re.compile(pattern) for name, pattern in rules.items() + } + self.next_token: Token | None = None + self.position = 0 + + def consume(self, name: str) -> None: + """Move beyond provided token name, if at current position.""" + if self.check(name): + self.read() + + def check(self, name: str, *, peek: bool = False) -> bool: + """Check whether the next token has the provided name. + + By default, if the check succeeds, the token *must* be read before + another check. If `peek` is set to `True`, the token is not loaded and + would need to be checked again. + """ + assert ( + self.next_token is None + ), f"Cannot check for {name!r}, already have {self.next_token!r}" + assert name in self.rules, f"Unknown token name: {name!r}" + + expression = self.rules[name] + + match = expression.match(self.source, self.position) + if match is None: + return False + if not peek: + self.next_token = Token(name, match[0], self.position) + return True + + def expect(self, name: str, *, expected: str) -> Token: + """Expect a certain token name next, failing with a syntax error otherwise. + + The token is *not* read. + """ + if not self.check(name): + raise self.raise_syntax_error(f"Expected {expected}") + return self.read() + + def read(self) -> Token: + """Consume the next token and return it.""" + token = self.next_token + assert token is not None + + self.position += len(token.text) + self.next_token = None + + return token + + def raise_syntax_error( + self, + message: str, + *, + span_start: int | None = None, + span_end: int | None = None, + ) -> NoReturn: + """Raise ParserSyntaxError at the given position.""" + span = ( + self.position if span_start is None else span_start, + self.position if span_end is None else span_end, + ) + raise ParserSyntaxError( + message, + source=self.source, + span=span, + ) + + @contextlib.contextmanager + def enclosing_tokens( + self, open_token: str, close_token: str, *, around: str + ) -> Iterator[None]: + if self.check(open_token): + open_position = self.position + self.read() + else: + open_position = None + + yield + + if open_position is None: + return + + if not self.check(close_token): + self.raise_syntax_error( + f"Expected matching {close_token} for {open_token}, after {around}", + span_start=open_position, + ) + + self.read() diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/licenses/__init__.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/licenses/__init__.py new file mode 100644 index 0000000..71a1a77 --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/licenses/__init__.py @@ -0,0 +1,145 @@ +####################################################################################### +# +# Adapted from: +# https://github.com/pypa/hatch/blob/5352e44/backend/src/hatchling/licenses/parse.py +# +# MIT License +# +# Copyright (c) 2017-present Ofek Lev +# +# Permission is hereby granted, free of charge, to any person obtaining a copy of this +# software and associated documentation files (the "Software"), to deal in the Software +# without restriction, including without limitation the rights to use, copy, modify, +# merge, publish, distribute, sublicense, and/or sell copies of the Software, and to +# permit persons to whom the Software is furnished to do so, subject to the following +# conditions: +# +# The above copyright notice and this permission notice shall be included in all copies +# or substantial portions of the Software. +# +# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, +# INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A +# PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT +# HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF +# CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE +# OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. +# +# +# With additional allowance of arbitrary `LicenseRef-` identifiers, not just +# `LicenseRef-Public-Domain` and `LicenseRef-Proprietary`. +# +####################################################################################### +from __future__ import annotations + +import re +from typing import NewType, cast + +from pip._vendor.packaging.licenses._spdx import EXCEPTIONS, LICENSES + +__all__ = [ + "NormalizedLicenseExpression", + "InvalidLicenseExpression", + "canonicalize_license_expression", +] + +license_ref_allowed = re.compile("^[A-Za-z0-9.-]*$") + +NormalizedLicenseExpression = NewType("NormalizedLicenseExpression", str) + + +class InvalidLicenseExpression(ValueError): + """Raised when a license-expression string is invalid + + >>> canonicalize_license_expression("invalid") + Traceback (most recent call last): + ... + packaging.licenses.InvalidLicenseExpression: Invalid license expression: 'invalid' + """ + + +def canonicalize_license_expression( + raw_license_expression: str, +) -> NormalizedLicenseExpression: + if not raw_license_expression: + message = f"Invalid license expression: {raw_license_expression!r}" + raise InvalidLicenseExpression(message) + + # Pad any parentheses so tokenization can be achieved by merely splitting on + # whitespace. + license_expression = raw_license_expression.replace("(", " ( ").replace(")", " ) ") + licenseref_prefix = "LicenseRef-" + license_refs = { + ref.lower(): "LicenseRef-" + ref[len(licenseref_prefix) :] + for ref in license_expression.split() + if ref.lower().startswith(licenseref_prefix.lower()) + } + + # Normalize to lower case so we can look up licenses/exceptions + # and so boolean operators are Python-compatible. + license_expression = license_expression.lower() + + tokens = license_expression.split() + + # Rather than implementing boolean logic, we create an expression that Python can + # parse. Everything that is not involved with the grammar itself is treated as + # `False` and the expression should evaluate as such. + python_tokens = [] + for token in tokens: + if token not in {"or", "and", "with", "(", ")"}: + python_tokens.append("False") + elif token == "with": + python_tokens.append("or") + elif token == "(" and python_tokens and python_tokens[-1] not in {"or", "and"}: + message = f"Invalid license expression: {raw_license_expression!r}" + raise InvalidLicenseExpression(message) + else: + python_tokens.append(token) + + python_expression = " ".join(python_tokens) + try: + invalid = eval(python_expression, globals(), locals()) + except Exception: + invalid = True + + if invalid is not False: + message = f"Invalid license expression: {raw_license_expression!r}" + raise InvalidLicenseExpression(message) from None + + # Take a final pass to check for unknown licenses/exceptions. + normalized_tokens = [] + for token in tokens: + if token in {"or", "and", "with", "(", ")"}: + normalized_tokens.append(token.upper()) + continue + + if normalized_tokens and normalized_tokens[-1] == "WITH": + if token not in EXCEPTIONS: + message = f"Unknown license exception: {token!r}" + raise InvalidLicenseExpression(message) + + normalized_tokens.append(EXCEPTIONS[token]["id"]) + else: + if token.endswith("+"): + final_token = token[:-1] + suffix = "+" + else: + final_token = token + suffix = "" + + if final_token.startswith("licenseref-"): + if not license_ref_allowed.match(final_token): + message = f"Invalid licenseref: {final_token!r}" + raise InvalidLicenseExpression(message) + normalized_tokens.append(license_refs[final_token] + suffix) + else: + if final_token not in LICENSES: + message = f"Unknown license: {final_token!r}" + raise InvalidLicenseExpression(message) + normalized_tokens.append(LICENSES[final_token]["id"] + suffix) + + normalized_expression = " ".join(normalized_tokens) + + return cast( + NormalizedLicenseExpression, + normalized_expression.replace("( ", "(").replace(" )", ")"), + ) diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/licenses/__pycache__/__init__.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/licenses/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000..c057e8b Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/licenses/__pycache__/__init__.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/licenses/__pycache__/_spdx.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/licenses/__pycache__/_spdx.cpython-312.pyc new file mode 100644 index 0000000..8e294b8 Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/licenses/__pycache__/_spdx.cpython-312.pyc differ diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/licenses/_spdx.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/licenses/_spdx.py new file mode 100644 index 0000000..eac2227 --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/licenses/_spdx.py @@ -0,0 +1,759 @@ + +from __future__ import annotations + +from typing import TypedDict + +class SPDXLicense(TypedDict): + id: str + deprecated: bool + +class SPDXException(TypedDict): + id: str + deprecated: bool + + +VERSION = '3.25.0' + +LICENSES: dict[str, SPDXLicense] = { + '0bsd': {'id': '0BSD', 'deprecated': False}, + '3d-slicer-1.0': {'id': '3D-Slicer-1.0', 'deprecated': False}, + 'aal': {'id': 'AAL', 'deprecated': False}, + 'abstyles': {'id': 'Abstyles', 'deprecated': False}, + 'adacore-doc': {'id': 'AdaCore-doc', 'deprecated': False}, + 'adobe-2006': {'id': 'Adobe-2006', 'deprecated': False}, + 'adobe-display-postscript': {'id': 'Adobe-Display-PostScript', 'deprecated': False}, + 'adobe-glyph': {'id': 'Adobe-Glyph', 'deprecated': False}, + 'adobe-utopia': {'id': 'Adobe-Utopia', 'deprecated': False}, + 'adsl': {'id': 'ADSL', 'deprecated': False}, + 'afl-1.1': {'id': 'AFL-1.1', 'deprecated': False}, + 'afl-1.2': {'id': 'AFL-1.2', 'deprecated': False}, + 'afl-2.0': {'id': 'AFL-2.0', 'deprecated': False}, + 'afl-2.1': {'id': 'AFL-2.1', 'deprecated': False}, + 'afl-3.0': {'id': 'AFL-3.0', 'deprecated': False}, + 'afmparse': {'id': 'Afmparse', 'deprecated': False}, + 'agpl-1.0': {'id': 'AGPL-1.0', 'deprecated': True}, + 'agpl-1.0-only': {'id': 'AGPL-1.0-only', 'deprecated': False}, + 'agpl-1.0-or-later': {'id': 'AGPL-1.0-or-later', 'deprecated': False}, + 'agpl-3.0': {'id': 'AGPL-3.0', 'deprecated': True}, + 'agpl-3.0-only': {'id': 'AGPL-3.0-only', 'deprecated': False}, + 'agpl-3.0-or-later': {'id': 'AGPL-3.0-or-later', 'deprecated': False}, + 'aladdin': {'id': 'Aladdin', 'deprecated': False}, + 'amd-newlib': {'id': 'AMD-newlib', 'deprecated': False}, + 'amdplpa': {'id': 'AMDPLPA', 'deprecated': False}, + 'aml': {'id': 'AML', 'deprecated': False}, + 'aml-glslang': {'id': 'AML-glslang', 'deprecated': False}, + 'ampas': {'id': 'AMPAS', 'deprecated': False}, + 'antlr-pd': {'id': 'ANTLR-PD', 'deprecated': False}, + 'antlr-pd-fallback': {'id': 'ANTLR-PD-fallback', 'deprecated': False}, + 'any-osi': {'id': 'any-OSI', 'deprecated': False}, + 'apache-1.0': {'id': 'Apache-1.0', 'deprecated': False}, + 'apache-1.1': {'id': 'Apache-1.1', 'deprecated': False}, + 'apache-2.0': {'id': 'Apache-2.0', 'deprecated': False}, + 'apafml': {'id': 'APAFML', 'deprecated': False}, + 'apl-1.0': {'id': 'APL-1.0', 'deprecated': False}, + 'app-s2p': {'id': 'App-s2p', 'deprecated': False}, + 'apsl-1.0': {'id': 'APSL-1.0', 'deprecated': False}, + 'apsl-1.1': {'id': 'APSL-1.1', 'deprecated': False}, + 'apsl-1.2': {'id': 'APSL-1.2', 'deprecated': False}, + 'apsl-2.0': {'id': 'APSL-2.0', 'deprecated': False}, + 'arphic-1999': {'id': 'Arphic-1999', 'deprecated': False}, + 'artistic-1.0': {'id': 'Artistic-1.0', 'deprecated': False}, + 'artistic-1.0-cl8': {'id': 'Artistic-1.0-cl8', 'deprecated': False}, + 'artistic-1.0-perl': {'id': 'Artistic-1.0-Perl', 'deprecated': False}, + 'artistic-2.0': {'id': 'Artistic-2.0', 'deprecated': False}, + 'aswf-digital-assets-1.0': {'id': 'ASWF-Digital-Assets-1.0', 'deprecated': False}, + 'aswf-digital-assets-1.1': {'id': 'ASWF-Digital-Assets-1.1', 'deprecated': False}, + 'baekmuk': {'id': 'Baekmuk', 'deprecated': False}, + 'bahyph': {'id': 'Bahyph', 'deprecated': False}, + 'barr': {'id': 'Barr', 'deprecated': False}, + 'bcrypt-solar-designer': {'id': 'bcrypt-Solar-Designer', 'deprecated': False}, + 'beerware': {'id': 'Beerware', 'deprecated': False}, + 'bitstream-charter': {'id': 'Bitstream-Charter', 'deprecated': False}, + 'bitstream-vera': {'id': 'Bitstream-Vera', 'deprecated': False}, + 'bittorrent-1.0': {'id': 'BitTorrent-1.0', 'deprecated': False}, + 'bittorrent-1.1': {'id': 'BitTorrent-1.1', 'deprecated': False}, + 'blessing': {'id': 'blessing', 'deprecated': False}, + 'blueoak-1.0.0': {'id': 'BlueOak-1.0.0', 'deprecated': False}, + 'boehm-gc': {'id': 'Boehm-GC', 'deprecated': False}, + 'borceux': {'id': 'Borceux', 'deprecated': False}, + 'brian-gladman-2-clause': {'id': 'Brian-Gladman-2-Clause', 'deprecated': False}, + 'brian-gladman-3-clause': {'id': 'Brian-Gladman-3-Clause', 'deprecated': False}, + 'bsd-1-clause': {'id': 'BSD-1-Clause', 'deprecated': False}, + 'bsd-2-clause': {'id': 'BSD-2-Clause', 'deprecated': False}, + 'bsd-2-clause-darwin': {'id': 'BSD-2-Clause-Darwin', 'deprecated': False}, + 'bsd-2-clause-first-lines': {'id': 'BSD-2-Clause-first-lines', 'deprecated': False}, + 'bsd-2-clause-freebsd': {'id': 'BSD-2-Clause-FreeBSD', 'deprecated': True}, + 'bsd-2-clause-netbsd': {'id': 'BSD-2-Clause-NetBSD', 'deprecated': True}, + 'bsd-2-clause-patent': {'id': 'BSD-2-Clause-Patent', 'deprecated': False}, + 'bsd-2-clause-views': {'id': 'BSD-2-Clause-Views', 'deprecated': False}, + 'bsd-3-clause': {'id': 'BSD-3-Clause', 'deprecated': False}, + 'bsd-3-clause-acpica': {'id': 'BSD-3-Clause-acpica', 'deprecated': False}, + 'bsd-3-clause-attribution': {'id': 'BSD-3-Clause-Attribution', 'deprecated': False}, + 'bsd-3-clause-clear': {'id': 'BSD-3-Clause-Clear', 'deprecated': False}, + 'bsd-3-clause-flex': {'id': 'BSD-3-Clause-flex', 'deprecated': False}, + 'bsd-3-clause-hp': {'id': 'BSD-3-Clause-HP', 'deprecated': False}, + 'bsd-3-clause-lbnl': {'id': 'BSD-3-Clause-LBNL', 'deprecated': False}, + 'bsd-3-clause-modification': {'id': 'BSD-3-Clause-Modification', 'deprecated': False}, + 'bsd-3-clause-no-military-license': {'id': 'BSD-3-Clause-No-Military-License', 'deprecated': False}, + 'bsd-3-clause-no-nuclear-license': {'id': 'BSD-3-Clause-No-Nuclear-License', 'deprecated': False}, + 'bsd-3-clause-no-nuclear-license-2014': {'id': 'BSD-3-Clause-No-Nuclear-License-2014', 'deprecated': False}, + 'bsd-3-clause-no-nuclear-warranty': {'id': 'BSD-3-Clause-No-Nuclear-Warranty', 'deprecated': False}, + 'bsd-3-clause-open-mpi': {'id': 'BSD-3-Clause-Open-MPI', 'deprecated': False}, + 'bsd-3-clause-sun': {'id': 'BSD-3-Clause-Sun', 'deprecated': False}, + 'bsd-4-clause': {'id': 'BSD-4-Clause', 'deprecated': False}, + 'bsd-4-clause-shortened': {'id': 'BSD-4-Clause-Shortened', 'deprecated': False}, + 'bsd-4-clause-uc': {'id': 'BSD-4-Clause-UC', 'deprecated': False}, + 'bsd-4.3reno': {'id': 'BSD-4.3RENO', 'deprecated': False}, + 'bsd-4.3tahoe': {'id': 'BSD-4.3TAHOE', 'deprecated': False}, + 'bsd-advertising-acknowledgement': {'id': 'BSD-Advertising-Acknowledgement', 'deprecated': False}, + 'bsd-attribution-hpnd-disclaimer': {'id': 'BSD-Attribution-HPND-disclaimer', 'deprecated': False}, + 'bsd-inferno-nettverk': {'id': 'BSD-Inferno-Nettverk', 'deprecated': False}, + 'bsd-protection': {'id': 'BSD-Protection', 'deprecated': False}, + 'bsd-source-beginning-file': {'id': 'BSD-Source-beginning-file', 'deprecated': False}, + 'bsd-source-code': {'id': 'BSD-Source-Code', 'deprecated': False}, + 'bsd-systemics': {'id': 'BSD-Systemics', 'deprecated': False}, + 'bsd-systemics-w3works': {'id': 'BSD-Systemics-W3Works', 'deprecated': False}, + 'bsl-1.0': {'id': 'BSL-1.0', 'deprecated': False}, + 'busl-1.1': {'id': 'BUSL-1.1', 'deprecated': False}, + 'bzip2-1.0.5': {'id': 'bzip2-1.0.5', 'deprecated': True}, + 'bzip2-1.0.6': {'id': 'bzip2-1.0.6', 'deprecated': False}, + 'c-uda-1.0': {'id': 'C-UDA-1.0', 'deprecated': False}, + 'cal-1.0': {'id': 'CAL-1.0', 'deprecated': False}, + 'cal-1.0-combined-work-exception': {'id': 'CAL-1.0-Combined-Work-Exception', 'deprecated': False}, + 'caldera': {'id': 'Caldera', 'deprecated': False}, + 'caldera-no-preamble': {'id': 'Caldera-no-preamble', 'deprecated': False}, + 'catharon': {'id': 'Catharon', 'deprecated': False}, + 'catosl-1.1': {'id': 'CATOSL-1.1', 'deprecated': False}, + 'cc-by-1.0': {'id': 'CC-BY-1.0', 'deprecated': False}, + 'cc-by-2.0': {'id': 'CC-BY-2.0', 'deprecated': False}, + 'cc-by-2.5': {'id': 'CC-BY-2.5', 'deprecated': False}, + 'cc-by-2.5-au': {'id': 'CC-BY-2.5-AU', 'deprecated': False}, + 'cc-by-3.0': {'id': 'CC-BY-3.0', 'deprecated': False}, + 'cc-by-3.0-at': {'id': 'CC-BY-3.0-AT', 'deprecated': False}, + 'cc-by-3.0-au': {'id': 'CC-BY-3.0-AU', 'deprecated': False}, + 'cc-by-3.0-de': {'id': 'CC-BY-3.0-DE', 'deprecated': False}, + 'cc-by-3.0-igo': {'id': 'CC-BY-3.0-IGO', 'deprecated': False}, + 'cc-by-3.0-nl': {'id': 'CC-BY-3.0-NL', 'deprecated': False}, + 'cc-by-3.0-us': {'id': 'CC-BY-3.0-US', 'deprecated': False}, + 'cc-by-4.0': {'id': 'CC-BY-4.0', 'deprecated': False}, + 'cc-by-nc-1.0': {'id': 'CC-BY-NC-1.0', 'deprecated': False}, + 'cc-by-nc-2.0': {'id': 'CC-BY-NC-2.0', 'deprecated': False}, + 'cc-by-nc-2.5': {'id': 'CC-BY-NC-2.5', 'deprecated': False}, + 'cc-by-nc-3.0': {'id': 'CC-BY-NC-3.0', 'deprecated': False}, + 'cc-by-nc-3.0-de': {'id': 'CC-BY-NC-3.0-DE', 'deprecated': False}, + 'cc-by-nc-4.0': {'id': 'CC-BY-NC-4.0', 'deprecated': False}, + 'cc-by-nc-nd-1.0': {'id': 'CC-BY-NC-ND-1.0', 'deprecated': False}, + 'cc-by-nc-nd-2.0': {'id': 'CC-BY-NC-ND-2.0', 'deprecated': False}, + 'cc-by-nc-nd-2.5': {'id': 'CC-BY-NC-ND-2.5', 'deprecated': False}, + 'cc-by-nc-nd-3.0': {'id': 'CC-BY-NC-ND-3.0', 'deprecated': False}, + 'cc-by-nc-nd-3.0-de': {'id': 'CC-BY-NC-ND-3.0-DE', 'deprecated': False}, + 'cc-by-nc-nd-3.0-igo': {'id': 'CC-BY-NC-ND-3.0-IGO', 'deprecated': False}, + 'cc-by-nc-nd-4.0': {'id': 'CC-BY-NC-ND-4.0', 'deprecated': False}, + 'cc-by-nc-sa-1.0': {'id': 'CC-BY-NC-SA-1.0', 'deprecated': False}, + 'cc-by-nc-sa-2.0': {'id': 'CC-BY-NC-SA-2.0', 'deprecated': False}, + 'cc-by-nc-sa-2.0-de': {'id': 'CC-BY-NC-SA-2.0-DE', 'deprecated': False}, + 'cc-by-nc-sa-2.0-fr': {'id': 'CC-BY-NC-SA-2.0-FR', 'deprecated': False}, + 'cc-by-nc-sa-2.0-uk': {'id': 'CC-BY-NC-SA-2.0-UK', 'deprecated': False}, + 'cc-by-nc-sa-2.5': {'id': 'CC-BY-NC-SA-2.5', 'deprecated': False}, + 'cc-by-nc-sa-3.0': {'id': 'CC-BY-NC-SA-3.0', 'deprecated': False}, + 'cc-by-nc-sa-3.0-de': {'id': 'CC-BY-NC-SA-3.0-DE', 'deprecated': False}, + 'cc-by-nc-sa-3.0-igo': {'id': 'CC-BY-NC-SA-3.0-IGO', 'deprecated': False}, + 'cc-by-nc-sa-4.0': {'id': 'CC-BY-NC-SA-4.0', 'deprecated': False}, + 'cc-by-nd-1.0': {'id': 'CC-BY-ND-1.0', 'deprecated': False}, + 'cc-by-nd-2.0': {'id': 'CC-BY-ND-2.0', 'deprecated': False}, + 'cc-by-nd-2.5': {'id': 'CC-BY-ND-2.5', 'deprecated': False}, + 'cc-by-nd-3.0': {'id': 'CC-BY-ND-3.0', 'deprecated': False}, + 'cc-by-nd-3.0-de': {'id': 'CC-BY-ND-3.0-DE', 'deprecated': False}, + 'cc-by-nd-4.0': {'id': 'CC-BY-ND-4.0', 'deprecated': False}, + 'cc-by-sa-1.0': {'id': 'CC-BY-SA-1.0', 'deprecated': False}, + 'cc-by-sa-2.0': {'id': 'CC-BY-SA-2.0', 'deprecated': False}, + 'cc-by-sa-2.0-uk': {'id': 'CC-BY-SA-2.0-UK', 'deprecated': False}, + 'cc-by-sa-2.1-jp': {'id': 'CC-BY-SA-2.1-JP', 'deprecated': False}, + 'cc-by-sa-2.5': {'id': 'CC-BY-SA-2.5', 'deprecated': False}, + 'cc-by-sa-3.0': {'id': 'CC-BY-SA-3.0', 'deprecated': False}, + 'cc-by-sa-3.0-at': {'id': 'CC-BY-SA-3.0-AT', 'deprecated': False}, + 'cc-by-sa-3.0-de': {'id': 'CC-BY-SA-3.0-DE', 'deprecated': False}, + 'cc-by-sa-3.0-igo': {'id': 'CC-BY-SA-3.0-IGO', 'deprecated': False}, + 'cc-by-sa-4.0': {'id': 'CC-BY-SA-4.0', 'deprecated': False}, + 'cc-pddc': {'id': 'CC-PDDC', 'deprecated': False}, + 'cc0-1.0': {'id': 'CC0-1.0', 'deprecated': False}, + 'cddl-1.0': {'id': 'CDDL-1.0', 'deprecated': False}, + 'cddl-1.1': {'id': 'CDDL-1.1', 'deprecated': False}, + 'cdl-1.0': {'id': 'CDL-1.0', 'deprecated': False}, + 'cdla-permissive-1.0': {'id': 'CDLA-Permissive-1.0', 'deprecated': False}, + 'cdla-permissive-2.0': {'id': 'CDLA-Permissive-2.0', 'deprecated': False}, + 'cdla-sharing-1.0': {'id': 'CDLA-Sharing-1.0', 'deprecated': False}, + 'cecill-1.0': {'id': 'CECILL-1.0', 'deprecated': False}, + 'cecill-1.1': {'id': 'CECILL-1.1', 'deprecated': False}, + 'cecill-2.0': {'id': 'CECILL-2.0', 'deprecated': False}, + 'cecill-2.1': {'id': 'CECILL-2.1', 'deprecated': False}, + 'cecill-b': {'id': 'CECILL-B', 'deprecated': False}, + 'cecill-c': {'id': 'CECILL-C', 'deprecated': False}, + 'cern-ohl-1.1': {'id': 'CERN-OHL-1.1', 'deprecated': False}, + 'cern-ohl-1.2': {'id': 'CERN-OHL-1.2', 'deprecated': False}, + 'cern-ohl-p-2.0': {'id': 'CERN-OHL-P-2.0', 'deprecated': False}, + 'cern-ohl-s-2.0': {'id': 'CERN-OHL-S-2.0', 'deprecated': False}, + 'cern-ohl-w-2.0': {'id': 'CERN-OHL-W-2.0', 'deprecated': False}, + 'cfitsio': {'id': 'CFITSIO', 'deprecated': False}, + 'check-cvs': {'id': 'check-cvs', 'deprecated': False}, + 'checkmk': {'id': 'checkmk', 'deprecated': False}, + 'clartistic': {'id': 'ClArtistic', 'deprecated': False}, + 'clips': {'id': 'Clips', 'deprecated': False}, + 'cmu-mach': {'id': 'CMU-Mach', 'deprecated': False}, + 'cmu-mach-nodoc': {'id': 'CMU-Mach-nodoc', 'deprecated': False}, + 'cnri-jython': {'id': 'CNRI-Jython', 'deprecated': False}, + 'cnri-python': {'id': 'CNRI-Python', 'deprecated': False}, + 'cnri-python-gpl-compatible': {'id': 'CNRI-Python-GPL-Compatible', 'deprecated': False}, + 'coil-1.0': {'id': 'COIL-1.0', 'deprecated': False}, + 'community-spec-1.0': {'id': 'Community-Spec-1.0', 'deprecated': False}, + 'condor-1.1': {'id': 'Condor-1.1', 'deprecated': False}, + 'copyleft-next-0.3.0': {'id': 'copyleft-next-0.3.0', 'deprecated': False}, + 'copyleft-next-0.3.1': {'id': 'copyleft-next-0.3.1', 'deprecated': False}, + 'cornell-lossless-jpeg': {'id': 'Cornell-Lossless-JPEG', 'deprecated': False}, + 'cpal-1.0': {'id': 'CPAL-1.0', 'deprecated': False}, + 'cpl-1.0': {'id': 'CPL-1.0', 'deprecated': False}, + 'cpol-1.02': {'id': 'CPOL-1.02', 'deprecated': False}, + 'cronyx': {'id': 'Cronyx', 'deprecated': False}, + 'crossword': {'id': 'Crossword', 'deprecated': False}, + 'crystalstacker': {'id': 'CrystalStacker', 'deprecated': False}, + 'cua-opl-1.0': {'id': 'CUA-OPL-1.0', 'deprecated': False}, + 'cube': {'id': 'Cube', 'deprecated': False}, + 'curl': {'id': 'curl', 'deprecated': False}, + 'cve-tou': {'id': 'cve-tou', 'deprecated': False}, + 'd-fsl-1.0': {'id': 'D-FSL-1.0', 'deprecated': False}, + 'dec-3-clause': {'id': 'DEC-3-Clause', 'deprecated': False}, + 'diffmark': {'id': 'diffmark', 'deprecated': False}, + 'dl-de-by-2.0': {'id': 'DL-DE-BY-2.0', 'deprecated': False}, + 'dl-de-zero-2.0': {'id': 'DL-DE-ZERO-2.0', 'deprecated': False}, + 'doc': {'id': 'DOC', 'deprecated': False}, + 'docbook-schema': {'id': 'DocBook-Schema', 'deprecated': False}, + 'docbook-xml': {'id': 'DocBook-XML', 'deprecated': False}, + 'dotseqn': {'id': 'Dotseqn', 'deprecated': False}, + 'drl-1.0': {'id': 'DRL-1.0', 'deprecated': False}, + 'drl-1.1': {'id': 'DRL-1.1', 'deprecated': False}, + 'dsdp': {'id': 'DSDP', 'deprecated': False}, + 'dtoa': {'id': 'dtoa', 'deprecated': False}, + 'dvipdfm': {'id': 'dvipdfm', 'deprecated': False}, + 'ecl-1.0': {'id': 'ECL-1.0', 'deprecated': False}, + 'ecl-2.0': {'id': 'ECL-2.0', 'deprecated': False}, + 'ecos-2.0': {'id': 'eCos-2.0', 'deprecated': True}, + 'efl-1.0': {'id': 'EFL-1.0', 'deprecated': False}, + 'efl-2.0': {'id': 'EFL-2.0', 'deprecated': False}, + 'egenix': {'id': 'eGenix', 'deprecated': False}, + 'elastic-2.0': {'id': 'Elastic-2.0', 'deprecated': False}, + 'entessa': {'id': 'Entessa', 'deprecated': False}, + 'epics': {'id': 'EPICS', 'deprecated': False}, + 'epl-1.0': {'id': 'EPL-1.0', 'deprecated': False}, + 'epl-2.0': {'id': 'EPL-2.0', 'deprecated': False}, + 'erlpl-1.1': {'id': 'ErlPL-1.1', 'deprecated': False}, + 'etalab-2.0': {'id': 'etalab-2.0', 'deprecated': False}, + 'eudatagrid': {'id': 'EUDatagrid', 'deprecated': False}, + 'eupl-1.0': {'id': 'EUPL-1.0', 'deprecated': False}, + 'eupl-1.1': {'id': 'EUPL-1.1', 'deprecated': False}, + 'eupl-1.2': {'id': 'EUPL-1.2', 'deprecated': False}, + 'eurosym': {'id': 'Eurosym', 'deprecated': False}, + 'fair': {'id': 'Fair', 'deprecated': False}, + 'fbm': {'id': 'FBM', 'deprecated': False}, + 'fdk-aac': {'id': 'FDK-AAC', 'deprecated': False}, + 'ferguson-twofish': {'id': 'Ferguson-Twofish', 'deprecated': False}, + 'frameworx-1.0': {'id': 'Frameworx-1.0', 'deprecated': False}, + 'freebsd-doc': {'id': 'FreeBSD-DOC', 'deprecated': False}, + 'freeimage': {'id': 'FreeImage', 'deprecated': False}, + 'fsfap': {'id': 'FSFAP', 'deprecated': False}, + 'fsfap-no-warranty-disclaimer': {'id': 'FSFAP-no-warranty-disclaimer', 'deprecated': False}, + 'fsful': {'id': 'FSFUL', 'deprecated': False}, + 'fsfullr': {'id': 'FSFULLR', 'deprecated': False}, + 'fsfullrwd': {'id': 'FSFULLRWD', 'deprecated': False}, + 'ftl': {'id': 'FTL', 'deprecated': False}, + 'furuseth': {'id': 'Furuseth', 'deprecated': False}, + 'fwlw': {'id': 'fwlw', 'deprecated': False}, + 'gcr-docs': {'id': 'GCR-docs', 'deprecated': False}, + 'gd': {'id': 'GD', 'deprecated': False}, + 'gfdl-1.1': {'id': 'GFDL-1.1', 'deprecated': True}, + 'gfdl-1.1-invariants-only': {'id': 'GFDL-1.1-invariants-only', 'deprecated': False}, + 'gfdl-1.1-invariants-or-later': {'id': 'GFDL-1.1-invariants-or-later', 'deprecated': False}, + 'gfdl-1.1-no-invariants-only': {'id': 'GFDL-1.1-no-invariants-only', 'deprecated': False}, + 'gfdl-1.1-no-invariants-or-later': {'id': 'GFDL-1.1-no-invariants-or-later', 'deprecated': False}, + 'gfdl-1.1-only': {'id': 'GFDL-1.1-only', 'deprecated': False}, + 'gfdl-1.1-or-later': {'id': 'GFDL-1.1-or-later', 'deprecated': False}, + 'gfdl-1.2': {'id': 'GFDL-1.2', 'deprecated': True}, + 'gfdl-1.2-invariants-only': {'id': 'GFDL-1.2-invariants-only', 'deprecated': False}, + 'gfdl-1.2-invariants-or-later': {'id': 'GFDL-1.2-invariants-or-later', 'deprecated': False}, + 'gfdl-1.2-no-invariants-only': {'id': 'GFDL-1.2-no-invariants-only', 'deprecated': False}, + 'gfdl-1.2-no-invariants-or-later': {'id': 'GFDL-1.2-no-invariants-or-later', 'deprecated': False}, + 'gfdl-1.2-only': {'id': 'GFDL-1.2-only', 'deprecated': False}, + 'gfdl-1.2-or-later': {'id': 'GFDL-1.2-or-later', 'deprecated': False}, + 'gfdl-1.3': {'id': 'GFDL-1.3', 'deprecated': True}, + 'gfdl-1.3-invariants-only': {'id': 'GFDL-1.3-invariants-only', 'deprecated': False}, + 'gfdl-1.3-invariants-or-later': {'id': 'GFDL-1.3-invariants-or-later', 'deprecated': False}, + 'gfdl-1.3-no-invariants-only': {'id': 'GFDL-1.3-no-invariants-only', 'deprecated': False}, + 'gfdl-1.3-no-invariants-or-later': {'id': 'GFDL-1.3-no-invariants-or-later', 'deprecated': False}, + 'gfdl-1.3-only': {'id': 'GFDL-1.3-only', 'deprecated': False}, + 'gfdl-1.3-or-later': {'id': 'GFDL-1.3-or-later', 'deprecated': False}, + 'giftware': {'id': 'Giftware', 'deprecated': False}, + 'gl2ps': {'id': 'GL2PS', 'deprecated': False}, + 'glide': {'id': 'Glide', 'deprecated': False}, + 'glulxe': {'id': 'Glulxe', 'deprecated': False}, + 'glwtpl': {'id': 'GLWTPL', 'deprecated': False}, + 'gnuplot': {'id': 'gnuplot', 'deprecated': False}, + 'gpl-1.0': {'id': 'GPL-1.0', 'deprecated': True}, + 'gpl-1.0+': {'id': 'GPL-1.0+', 'deprecated': True}, + 'gpl-1.0-only': {'id': 'GPL-1.0-only', 'deprecated': False}, + 'gpl-1.0-or-later': {'id': 'GPL-1.0-or-later', 'deprecated': False}, + 'gpl-2.0': {'id': 'GPL-2.0', 'deprecated': True}, + 'gpl-2.0+': {'id': 'GPL-2.0+', 'deprecated': True}, + 'gpl-2.0-only': {'id': 'GPL-2.0-only', 'deprecated': False}, + 'gpl-2.0-or-later': {'id': 'GPL-2.0-or-later', 'deprecated': False}, + 'gpl-2.0-with-autoconf-exception': {'id': 'GPL-2.0-with-autoconf-exception', 'deprecated': True}, + 'gpl-2.0-with-bison-exception': {'id': 'GPL-2.0-with-bison-exception', 'deprecated': True}, + 'gpl-2.0-with-classpath-exception': {'id': 'GPL-2.0-with-classpath-exception', 'deprecated': True}, + 'gpl-2.0-with-font-exception': {'id': 'GPL-2.0-with-font-exception', 'deprecated': True}, + 'gpl-2.0-with-gcc-exception': {'id': 'GPL-2.0-with-GCC-exception', 'deprecated': True}, + 'gpl-3.0': {'id': 'GPL-3.0', 'deprecated': True}, + 'gpl-3.0+': {'id': 'GPL-3.0+', 'deprecated': True}, + 'gpl-3.0-only': {'id': 'GPL-3.0-only', 'deprecated': False}, + 'gpl-3.0-or-later': {'id': 'GPL-3.0-or-later', 'deprecated': False}, + 'gpl-3.0-with-autoconf-exception': {'id': 'GPL-3.0-with-autoconf-exception', 'deprecated': True}, + 'gpl-3.0-with-gcc-exception': {'id': 'GPL-3.0-with-GCC-exception', 'deprecated': True}, + 'graphics-gems': {'id': 'Graphics-Gems', 'deprecated': False}, + 'gsoap-1.3b': {'id': 'gSOAP-1.3b', 'deprecated': False}, + 'gtkbook': {'id': 'gtkbook', 'deprecated': False}, + 'gutmann': {'id': 'Gutmann', 'deprecated': False}, + 'haskellreport': {'id': 'HaskellReport', 'deprecated': False}, + 'hdparm': {'id': 'hdparm', 'deprecated': False}, + 'hidapi': {'id': 'HIDAPI', 'deprecated': False}, + 'hippocratic-2.1': {'id': 'Hippocratic-2.1', 'deprecated': False}, + 'hp-1986': {'id': 'HP-1986', 'deprecated': False}, + 'hp-1989': {'id': 'HP-1989', 'deprecated': False}, + 'hpnd': {'id': 'HPND', 'deprecated': False}, + 'hpnd-dec': {'id': 'HPND-DEC', 'deprecated': False}, + 'hpnd-doc': {'id': 'HPND-doc', 'deprecated': False}, + 'hpnd-doc-sell': {'id': 'HPND-doc-sell', 'deprecated': False}, + 'hpnd-export-us': {'id': 'HPND-export-US', 'deprecated': False}, + 'hpnd-export-us-acknowledgement': {'id': 'HPND-export-US-acknowledgement', 'deprecated': False}, + 'hpnd-export-us-modify': {'id': 'HPND-export-US-modify', 'deprecated': False}, + 'hpnd-export2-us': {'id': 'HPND-export2-US', 'deprecated': False}, + 'hpnd-fenneberg-livingston': {'id': 'HPND-Fenneberg-Livingston', 'deprecated': False}, + 'hpnd-inria-imag': {'id': 'HPND-INRIA-IMAG', 'deprecated': False}, + 'hpnd-intel': {'id': 'HPND-Intel', 'deprecated': False}, + 'hpnd-kevlin-henney': {'id': 'HPND-Kevlin-Henney', 'deprecated': False}, + 'hpnd-markus-kuhn': {'id': 'HPND-Markus-Kuhn', 'deprecated': False}, + 'hpnd-merchantability-variant': {'id': 'HPND-merchantability-variant', 'deprecated': False}, + 'hpnd-mit-disclaimer': {'id': 'HPND-MIT-disclaimer', 'deprecated': False}, + 'hpnd-netrek': {'id': 'HPND-Netrek', 'deprecated': False}, + 'hpnd-pbmplus': {'id': 'HPND-Pbmplus', 'deprecated': False}, + 'hpnd-sell-mit-disclaimer-xserver': {'id': 'HPND-sell-MIT-disclaimer-xserver', 'deprecated': False}, + 'hpnd-sell-regexpr': {'id': 'HPND-sell-regexpr', 'deprecated': False}, + 'hpnd-sell-variant': {'id': 'HPND-sell-variant', 'deprecated': False}, + 'hpnd-sell-variant-mit-disclaimer': {'id': 'HPND-sell-variant-MIT-disclaimer', 'deprecated': False}, + 'hpnd-sell-variant-mit-disclaimer-rev': {'id': 'HPND-sell-variant-MIT-disclaimer-rev', 'deprecated': False}, + 'hpnd-uc': {'id': 'HPND-UC', 'deprecated': False}, + 'hpnd-uc-export-us': {'id': 'HPND-UC-export-US', 'deprecated': False}, + 'htmltidy': {'id': 'HTMLTIDY', 'deprecated': False}, + 'ibm-pibs': {'id': 'IBM-pibs', 'deprecated': False}, + 'icu': {'id': 'ICU', 'deprecated': False}, + 'iec-code-components-eula': {'id': 'IEC-Code-Components-EULA', 'deprecated': False}, + 'ijg': {'id': 'IJG', 'deprecated': False}, + 'ijg-short': {'id': 'IJG-short', 'deprecated': False}, + 'imagemagick': {'id': 'ImageMagick', 'deprecated': False}, + 'imatix': {'id': 'iMatix', 'deprecated': False}, + 'imlib2': {'id': 'Imlib2', 'deprecated': False}, + 'info-zip': {'id': 'Info-ZIP', 'deprecated': False}, + 'inner-net-2.0': {'id': 'Inner-Net-2.0', 'deprecated': False}, + 'intel': {'id': 'Intel', 'deprecated': False}, + 'intel-acpi': {'id': 'Intel-ACPI', 'deprecated': False}, + 'interbase-1.0': {'id': 'Interbase-1.0', 'deprecated': False}, + 'ipa': {'id': 'IPA', 'deprecated': False}, + 'ipl-1.0': {'id': 'IPL-1.0', 'deprecated': False}, + 'isc': {'id': 'ISC', 'deprecated': False}, + 'isc-veillard': {'id': 'ISC-Veillard', 'deprecated': False}, + 'jam': {'id': 'Jam', 'deprecated': False}, + 'jasper-2.0': {'id': 'JasPer-2.0', 'deprecated': False}, + 'jpl-image': {'id': 'JPL-image', 'deprecated': False}, + 'jpnic': {'id': 'JPNIC', 'deprecated': False}, + 'json': {'id': 'JSON', 'deprecated': False}, + 'kastrup': {'id': 'Kastrup', 'deprecated': False}, + 'kazlib': {'id': 'Kazlib', 'deprecated': False}, + 'knuth-ctan': {'id': 'Knuth-CTAN', 'deprecated': False}, + 'lal-1.2': {'id': 'LAL-1.2', 'deprecated': False}, + 'lal-1.3': {'id': 'LAL-1.3', 'deprecated': False}, + 'latex2e': {'id': 'Latex2e', 'deprecated': False}, + 'latex2e-translated-notice': {'id': 'Latex2e-translated-notice', 'deprecated': False}, + 'leptonica': {'id': 'Leptonica', 'deprecated': False}, + 'lgpl-2.0': {'id': 'LGPL-2.0', 'deprecated': True}, + 'lgpl-2.0+': {'id': 'LGPL-2.0+', 'deprecated': True}, + 'lgpl-2.0-only': {'id': 'LGPL-2.0-only', 'deprecated': False}, + 'lgpl-2.0-or-later': {'id': 'LGPL-2.0-or-later', 'deprecated': False}, + 'lgpl-2.1': {'id': 'LGPL-2.1', 'deprecated': True}, + 'lgpl-2.1+': {'id': 'LGPL-2.1+', 'deprecated': True}, + 'lgpl-2.1-only': {'id': 'LGPL-2.1-only', 'deprecated': False}, + 'lgpl-2.1-or-later': {'id': 'LGPL-2.1-or-later', 'deprecated': False}, + 'lgpl-3.0': {'id': 'LGPL-3.0', 'deprecated': True}, + 'lgpl-3.0+': {'id': 'LGPL-3.0+', 'deprecated': True}, + 'lgpl-3.0-only': {'id': 'LGPL-3.0-only', 'deprecated': False}, + 'lgpl-3.0-or-later': {'id': 'LGPL-3.0-or-later', 'deprecated': False}, + 'lgpllr': {'id': 'LGPLLR', 'deprecated': False}, + 'libpng': {'id': 'Libpng', 'deprecated': False}, + 'libpng-2.0': {'id': 'libpng-2.0', 'deprecated': False}, + 'libselinux-1.0': {'id': 'libselinux-1.0', 'deprecated': False}, + 'libtiff': {'id': 'libtiff', 'deprecated': False}, + 'libutil-david-nugent': {'id': 'libutil-David-Nugent', 'deprecated': False}, + 'liliq-p-1.1': {'id': 'LiLiQ-P-1.1', 'deprecated': False}, + 'liliq-r-1.1': {'id': 'LiLiQ-R-1.1', 'deprecated': False}, + 'liliq-rplus-1.1': {'id': 'LiLiQ-Rplus-1.1', 'deprecated': False}, + 'linux-man-pages-1-para': {'id': 'Linux-man-pages-1-para', 'deprecated': False}, + 'linux-man-pages-copyleft': {'id': 'Linux-man-pages-copyleft', 'deprecated': False}, + 'linux-man-pages-copyleft-2-para': {'id': 'Linux-man-pages-copyleft-2-para', 'deprecated': False}, + 'linux-man-pages-copyleft-var': {'id': 'Linux-man-pages-copyleft-var', 'deprecated': False}, + 'linux-openib': {'id': 'Linux-OpenIB', 'deprecated': False}, + 'loop': {'id': 'LOOP', 'deprecated': False}, + 'lpd-document': {'id': 'LPD-document', 'deprecated': False}, + 'lpl-1.0': {'id': 'LPL-1.0', 'deprecated': False}, + 'lpl-1.02': {'id': 'LPL-1.02', 'deprecated': False}, + 'lppl-1.0': {'id': 'LPPL-1.0', 'deprecated': False}, + 'lppl-1.1': {'id': 'LPPL-1.1', 'deprecated': False}, + 'lppl-1.2': {'id': 'LPPL-1.2', 'deprecated': False}, + 'lppl-1.3a': {'id': 'LPPL-1.3a', 'deprecated': False}, + 'lppl-1.3c': {'id': 'LPPL-1.3c', 'deprecated': False}, + 'lsof': {'id': 'lsof', 'deprecated': False}, + 'lucida-bitmap-fonts': {'id': 'Lucida-Bitmap-Fonts', 'deprecated': False}, + 'lzma-sdk-9.11-to-9.20': {'id': 'LZMA-SDK-9.11-to-9.20', 'deprecated': False}, + 'lzma-sdk-9.22': {'id': 'LZMA-SDK-9.22', 'deprecated': False}, + 'mackerras-3-clause': {'id': 'Mackerras-3-Clause', 'deprecated': False}, + 'mackerras-3-clause-acknowledgment': {'id': 'Mackerras-3-Clause-acknowledgment', 'deprecated': False}, + 'magaz': {'id': 'magaz', 'deprecated': False}, + 'mailprio': {'id': 'mailprio', 'deprecated': False}, + 'makeindex': {'id': 'MakeIndex', 'deprecated': False}, + 'martin-birgmeier': {'id': 'Martin-Birgmeier', 'deprecated': False}, + 'mcphee-slideshow': {'id': 'McPhee-slideshow', 'deprecated': False}, + 'metamail': {'id': 'metamail', 'deprecated': False}, + 'minpack': {'id': 'Minpack', 'deprecated': False}, + 'miros': {'id': 'MirOS', 'deprecated': False}, + 'mit': {'id': 'MIT', 'deprecated': False}, + 'mit-0': {'id': 'MIT-0', 'deprecated': False}, + 'mit-advertising': {'id': 'MIT-advertising', 'deprecated': False}, + 'mit-cmu': {'id': 'MIT-CMU', 'deprecated': False}, + 'mit-enna': {'id': 'MIT-enna', 'deprecated': False}, + 'mit-feh': {'id': 'MIT-feh', 'deprecated': False}, + 'mit-festival': {'id': 'MIT-Festival', 'deprecated': False}, + 'mit-khronos-old': {'id': 'MIT-Khronos-old', 'deprecated': False}, + 'mit-modern-variant': {'id': 'MIT-Modern-Variant', 'deprecated': False}, + 'mit-open-group': {'id': 'MIT-open-group', 'deprecated': False}, + 'mit-testregex': {'id': 'MIT-testregex', 'deprecated': False}, + 'mit-wu': {'id': 'MIT-Wu', 'deprecated': False}, + 'mitnfa': {'id': 'MITNFA', 'deprecated': False}, + 'mmixware': {'id': 'MMIXware', 'deprecated': False}, + 'motosoto': {'id': 'Motosoto', 'deprecated': False}, + 'mpeg-ssg': {'id': 'MPEG-SSG', 'deprecated': False}, + 'mpi-permissive': {'id': 'mpi-permissive', 'deprecated': False}, + 'mpich2': {'id': 'mpich2', 'deprecated': False}, + 'mpl-1.0': {'id': 'MPL-1.0', 'deprecated': False}, + 'mpl-1.1': {'id': 'MPL-1.1', 'deprecated': False}, + 'mpl-2.0': {'id': 'MPL-2.0', 'deprecated': False}, + 'mpl-2.0-no-copyleft-exception': {'id': 'MPL-2.0-no-copyleft-exception', 'deprecated': False}, + 'mplus': {'id': 'mplus', 'deprecated': False}, + 'ms-lpl': {'id': 'MS-LPL', 'deprecated': False}, + 'ms-pl': {'id': 'MS-PL', 'deprecated': False}, + 'ms-rl': {'id': 'MS-RL', 'deprecated': False}, + 'mtll': {'id': 'MTLL', 'deprecated': False}, + 'mulanpsl-1.0': {'id': 'MulanPSL-1.0', 'deprecated': False}, + 'mulanpsl-2.0': {'id': 'MulanPSL-2.0', 'deprecated': False}, + 'multics': {'id': 'Multics', 'deprecated': False}, + 'mup': {'id': 'Mup', 'deprecated': False}, + 'naist-2003': {'id': 'NAIST-2003', 'deprecated': False}, + 'nasa-1.3': {'id': 'NASA-1.3', 'deprecated': False}, + 'naumen': {'id': 'Naumen', 'deprecated': False}, + 'nbpl-1.0': {'id': 'NBPL-1.0', 'deprecated': False}, + 'ncbi-pd': {'id': 'NCBI-PD', 'deprecated': False}, + 'ncgl-uk-2.0': {'id': 'NCGL-UK-2.0', 'deprecated': False}, + 'ncl': {'id': 'NCL', 'deprecated': False}, + 'ncsa': {'id': 'NCSA', 'deprecated': False}, + 'net-snmp': {'id': 'Net-SNMP', 'deprecated': True}, + 'netcdf': {'id': 'NetCDF', 'deprecated': False}, + 'newsletr': {'id': 'Newsletr', 'deprecated': False}, + 'ngpl': {'id': 'NGPL', 'deprecated': False}, + 'nicta-1.0': {'id': 'NICTA-1.0', 'deprecated': False}, + 'nist-pd': {'id': 'NIST-PD', 'deprecated': False}, + 'nist-pd-fallback': {'id': 'NIST-PD-fallback', 'deprecated': False}, + 'nist-software': {'id': 'NIST-Software', 'deprecated': False}, + 'nlod-1.0': {'id': 'NLOD-1.0', 'deprecated': False}, + 'nlod-2.0': {'id': 'NLOD-2.0', 'deprecated': False}, + 'nlpl': {'id': 'NLPL', 'deprecated': False}, + 'nokia': {'id': 'Nokia', 'deprecated': False}, + 'nosl': {'id': 'NOSL', 'deprecated': False}, + 'noweb': {'id': 'Noweb', 'deprecated': False}, + 'npl-1.0': {'id': 'NPL-1.0', 'deprecated': False}, + 'npl-1.1': {'id': 'NPL-1.1', 'deprecated': False}, + 'nposl-3.0': {'id': 'NPOSL-3.0', 'deprecated': False}, + 'nrl': {'id': 'NRL', 'deprecated': False}, + 'ntp': {'id': 'NTP', 'deprecated': False}, + 'ntp-0': {'id': 'NTP-0', 'deprecated': False}, + 'nunit': {'id': 'Nunit', 'deprecated': True}, + 'o-uda-1.0': {'id': 'O-UDA-1.0', 'deprecated': False}, + 'oar': {'id': 'OAR', 'deprecated': False}, + 'occt-pl': {'id': 'OCCT-PL', 'deprecated': False}, + 'oclc-2.0': {'id': 'OCLC-2.0', 'deprecated': False}, + 'odbl-1.0': {'id': 'ODbL-1.0', 'deprecated': False}, + 'odc-by-1.0': {'id': 'ODC-By-1.0', 'deprecated': False}, + 'offis': {'id': 'OFFIS', 'deprecated': False}, + 'ofl-1.0': {'id': 'OFL-1.0', 'deprecated': False}, + 'ofl-1.0-no-rfn': {'id': 'OFL-1.0-no-RFN', 'deprecated': False}, + 'ofl-1.0-rfn': {'id': 'OFL-1.0-RFN', 'deprecated': False}, + 'ofl-1.1': {'id': 'OFL-1.1', 'deprecated': False}, + 'ofl-1.1-no-rfn': {'id': 'OFL-1.1-no-RFN', 'deprecated': False}, + 'ofl-1.1-rfn': {'id': 'OFL-1.1-RFN', 'deprecated': False}, + 'ogc-1.0': {'id': 'OGC-1.0', 'deprecated': False}, + 'ogdl-taiwan-1.0': {'id': 'OGDL-Taiwan-1.0', 'deprecated': False}, + 'ogl-canada-2.0': {'id': 'OGL-Canada-2.0', 'deprecated': False}, + 'ogl-uk-1.0': {'id': 'OGL-UK-1.0', 'deprecated': False}, + 'ogl-uk-2.0': {'id': 'OGL-UK-2.0', 'deprecated': False}, + 'ogl-uk-3.0': {'id': 'OGL-UK-3.0', 'deprecated': False}, + 'ogtsl': {'id': 'OGTSL', 'deprecated': False}, + 'oldap-1.1': {'id': 'OLDAP-1.1', 'deprecated': False}, + 'oldap-1.2': {'id': 'OLDAP-1.2', 'deprecated': False}, + 'oldap-1.3': {'id': 'OLDAP-1.3', 'deprecated': False}, + 'oldap-1.4': {'id': 'OLDAP-1.4', 'deprecated': False}, + 'oldap-2.0': {'id': 'OLDAP-2.0', 'deprecated': False}, + 'oldap-2.0.1': {'id': 'OLDAP-2.0.1', 'deprecated': False}, + 'oldap-2.1': {'id': 'OLDAP-2.1', 'deprecated': False}, + 'oldap-2.2': {'id': 'OLDAP-2.2', 'deprecated': False}, + 'oldap-2.2.1': {'id': 'OLDAP-2.2.1', 'deprecated': False}, + 'oldap-2.2.2': {'id': 'OLDAP-2.2.2', 'deprecated': False}, + 'oldap-2.3': {'id': 'OLDAP-2.3', 'deprecated': False}, + 'oldap-2.4': {'id': 'OLDAP-2.4', 'deprecated': False}, + 'oldap-2.5': {'id': 'OLDAP-2.5', 'deprecated': False}, + 'oldap-2.6': {'id': 'OLDAP-2.6', 'deprecated': False}, + 'oldap-2.7': {'id': 'OLDAP-2.7', 'deprecated': False}, + 'oldap-2.8': {'id': 'OLDAP-2.8', 'deprecated': False}, + 'olfl-1.3': {'id': 'OLFL-1.3', 'deprecated': False}, + 'oml': {'id': 'OML', 'deprecated': False}, + 'openpbs-2.3': {'id': 'OpenPBS-2.3', 'deprecated': False}, + 'openssl': {'id': 'OpenSSL', 'deprecated': False}, + 'openssl-standalone': {'id': 'OpenSSL-standalone', 'deprecated': False}, + 'openvision': {'id': 'OpenVision', 'deprecated': False}, + 'opl-1.0': {'id': 'OPL-1.0', 'deprecated': False}, + 'opl-uk-3.0': {'id': 'OPL-UK-3.0', 'deprecated': False}, + 'opubl-1.0': {'id': 'OPUBL-1.0', 'deprecated': False}, + 'oset-pl-2.1': {'id': 'OSET-PL-2.1', 'deprecated': False}, + 'osl-1.0': {'id': 'OSL-1.0', 'deprecated': False}, + 'osl-1.1': {'id': 'OSL-1.1', 'deprecated': False}, + 'osl-2.0': {'id': 'OSL-2.0', 'deprecated': False}, + 'osl-2.1': {'id': 'OSL-2.1', 'deprecated': False}, + 'osl-3.0': {'id': 'OSL-3.0', 'deprecated': False}, + 'padl': {'id': 'PADL', 'deprecated': False}, + 'parity-6.0.0': {'id': 'Parity-6.0.0', 'deprecated': False}, + 'parity-7.0.0': {'id': 'Parity-7.0.0', 'deprecated': False}, + 'pddl-1.0': {'id': 'PDDL-1.0', 'deprecated': False}, + 'php-3.0': {'id': 'PHP-3.0', 'deprecated': False}, + 'php-3.01': {'id': 'PHP-3.01', 'deprecated': False}, + 'pixar': {'id': 'Pixar', 'deprecated': False}, + 'pkgconf': {'id': 'pkgconf', 'deprecated': False}, + 'plexus': {'id': 'Plexus', 'deprecated': False}, + 'pnmstitch': {'id': 'pnmstitch', 'deprecated': False}, + 'polyform-noncommercial-1.0.0': {'id': 'PolyForm-Noncommercial-1.0.0', 'deprecated': False}, + 'polyform-small-business-1.0.0': {'id': 'PolyForm-Small-Business-1.0.0', 'deprecated': False}, + 'postgresql': {'id': 'PostgreSQL', 'deprecated': False}, + 'ppl': {'id': 'PPL', 'deprecated': False}, + 'psf-2.0': {'id': 'PSF-2.0', 'deprecated': False}, + 'psfrag': {'id': 'psfrag', 'deprecated': False}, + 'psutils': {'id': 'psutils', 'deprecated': False}, + 'python-2.0': {'id': 'Python-2.0', 'deprecated': False}, + 'python-2.0.1': {'id': 'Python-2.0.1', 'deprecated': False}, + 'python-ldap': {'id': 'python-ldap', 'deprecated': False}, + 'qhull': {'id': 'Qhull', 'deprecated': False}, + 'qpl-1.0': {'id': 'QPL-1.0', 'deprecated': False}, + 'qpl-1.0-inria-2004': {'id': 'QPL-1.0-INRIA-2004', 'deprecated': False}, + 'radvd': {'id': 'radvd', 'deprecated': False}, + 'rdisc': {'id': 'Rdisc', 'deprecated': False}, + 'rhecos-1.1': {'id': 'RHeCos-1.1', 'deprecated': False}, + 'rpl-1.1': {'id': 'RPL-1.1', 'deprecated': False}, + 'rpl-1.5': {'id': 'RPL-1.5', 'deprecated': False}, + 'rpsl-1.0': {'id': 'RPSL-1.0', 'deprecated': False}, + 'rsa-md': {'id': 'RSA-MD', 'deprecated': False}, + 'rscpl': {'id': 'RSCPL', 'deprecated': False}, + 'ruby': {'id': 'Ruby', 'deprecated': False}, + 'ruby-pty': {'id': 'Ruby-pty', 'deprecated': False}, + 'sax-pd': {'id': 'SAX-PD', 'deprecated': False}, + 'sax-pd-2.0': {'id': 'SAX-PD-2.0', 'deprecated': False}, + 'saxpath': {'id': 'Saxpath', 'deprecated': False}, + 'scea': {'id': 'SCEA', 'deprecated': False}, + 'schemereport': {'id': 'SchemeReport', 'deprecated': False}, + 'sendmail': {'id': 'Sendmail', 'deprecated': False}, + 'sendmail-8.23': {'id': 'Sendmail-8.23', 'deprecated': False}, + 'sgi-b-1.0': {'id': 'SGI-B-1.0', 'deprecated': False}, + 'sgi-b-1.1': {'id': 'SGI-B-1.1', 'deprecated': False}, + 'sgi-b-2.0': {'id': 'SGI-B-2.0', 'deprecated': False}, + 'sgi-opengl': {'id': 'SGI-OpenGL', 'deprecated': False}, + 'sgp4': {'id': 'SGP4', 'deprecated': False}, + 'shl-0.5': {'id': 'SHL-0.5', 'deprecated': False}, + 'shl-0.51': {'id': 'SHL-0.51', 'deprecated': False}, + 'simpl-2.0': {'id': 'SimPL-2.0', 'deprecated': False}, + 'sissl': {'id': 'SISSL', 'deprecated': False}, + 'sissl-1.2': {'id': 'SISSL-1.2', 'deprecated': False}, + 'sl': {'id': 'SL', 'deprecated': False}, + 'sleepycat': {'id': 'Sleepycat', 'deprecated': False}, + 'smlnj': {'id': 'SMLNJ', 'deprecated': False}, + 'smppl': {'id': 'SMPPL', 'deprecated': False}, + 'snia': {'id': 'SNIA', 'deprecated': False}, + 'snprintf': {'id': 'snprintf', 'deprecated': False}, + 'softsurfer': {'id': 'softSurfer', 'deprecated': False}, + 'soundex': {'id': 'Soundex', 'deprecated': False}, + 'spencer-86': {'id': 'Spencer-86', 'deprecated': False}, + 'spencer-94': {'id': 'Spencer-94', 'deprecated': False}, + 'spencer-99': {'id': 'Spencer-99', 'deprecated': False}, + 'spl-1.0': {'id': 'SPL-1.0', 'deprecated': False}, + 'ssh-keyscan': {'id': 'ssh-keyscan', 'deprecated': False}, + 'ssh-openssh': {'id': 'SSH-OpenSSH', 'deprecated': False}, + 'ssh-short': {'id': 'SSH-short', 'deprecated': False}, + 'ssleay-standalone': {'id': 'SSLeay-standalone', 'deprecated': False}, + 'sspl-1.0': {'id': 'SSPL-1.0', 'deprecated': False}, + 'standardml-nj': {'id': 'StandardML-NJ', 'deprecated': True}, + 'sugarcrm-1.1.3': {'id': 'SugarCRM-1.1.3', 'deprecated': False}, + 'sun-ppp': {'id': 'Sun-PPP', 'deprecated': False}, + 'sun-ppp-2000': {'id': 'Sun-PPP-2000', 'deprecated': False}, + 'sunpro': {'id': 'SunPro', 'deprecated': False}, + 'swl': {'id': 'SWL', 'deprecated': False}, + 'swrule': {'id': 'swrule', 'deprecated': False}, + 'symlinks': {'id': 'Symlinks', 'deprecated': False}, + 'tapr-ohl-1.0': {'id': 'TAPR-OHL-1.0', 'deprecated': False}, + 'tcl': {'id': 'TCL', 'deprecated': False}, + 'tcp-wrappers': {'id': 'TCP-wrappers', 'deprecated': False}, + 'termreadkey': {'id': 'TermReadKey', 'deprecated': False}, + 'tgppl-1.0': {'id': 'TGPPL-1.0', 'deprecated': False}, + 'threeparttable': {'id': 'threeparttable', 'deprecated': False}, + 'tmate': {'id': 'TMate', 'deprecated': False}, + 'torque-1.1': {'id': 'TORQUE-1.1', 'deprecated': False}, + 'tosl': {'id': 'TOSL', 'deprecated': False}, + 'tpdl': {'id': 'TPDL', 'deprecated': False}, + 'tpl-1.0': {'id': 'TPL-1.0', 'deprecated': False}, + 'ttwl': {'id': 'TTWL', 'deprecated': False}, + 'ttyp0': {'id': 'TTYP0', 'deprecated': False}, + 'tu-berlin-1.0': {'id': 'TU-Berlin-1.0', 'deprecated': False}, + 'tu-berlin-2.0': {'id': 'TU-Berlin-2.0', 'deprecated': False}, + 'ubuntu-font-1.0': {'id': 'Ubuntu-font-1.0', 'deprecated': False}, + 'ucar': {'id': 'UCAR', 'deprecated': False}, + 'ucl-1.0': {'id': 'UCL-1.0', 'deprecated': False}, + 'ulem': {'id': 'ulem', 'deprecated': False}, + 'umich-merit': {'id': 'UMich-Merit', 'deprecated': False}, + 'unicode-3.0': {'id': 'Unicode-3.0', 'deprecated': False}, + 'unicode-dfs-2015': {'id': 'Unicode-DFS-2015', 'deprecated': False}, + 'unicode-dfs-2016': {'id': 'Unicode-DFS-2016', 'deprecated': False}, + 'unicode-tou': {'id': 'Unicode-TOU', 'deprecated': False}, + 'unixcrypt': {'id': 'UnixCrypt', 'deprecated': False}, + 'unlicense': {'id': 'Unlicense', 'deprecated': False}, + 'upl-1.0': {'id': 'UPL-1.0', 'deprecated': False}, + 'urt-rle': {'id': 'URT-RLE', 'deprecated': False}, + 'vim': {'id': 'Vim', 'deprecated': False}, + 'vostrom': {'id': 'VOSTROM', 'deprecated': False}, + 'vsl-1.0': {'id': 'VSL-1.0', 'deprecated': False}, + 'w3c': {'id': 'W3C', 'deprecated': False}, + 'w3c-19980720': {'id': 'W3C-19980720', 'deprecated': False}, + 'w3c-20150513': {'id': 'W3C-20150513', 'deprecated': False}, + 'w3m': {'id': 'w3m', 'deprecated': False}, + 'watcom-1.0': {'id': 'Watcom-1.0', 'deprecated': False}, + 'widget-workshop': {'id': 'Widget-Workshop', 'deprecated': False}, + 'wsuipa': {'id': 'Wsuipa', 'deprecated': False}, + 'wtfpl': {'id': 'WTFPL', 'deprecated': False}, + 'wxwindows': {'id': 'wxWindows', 'deprecated': True}, + 'x11': {'id': 'X11', 'deprecated': False}, + 'x11-distribute-modifications-variant': {'id': 'X11-distribute-modifications-variant', 'deprecated': False}, + 'x11-swapped': {'id': 'X11-swapped', 'deprecated': False}, + 'xdebug-1.03': {'id': 'Xdebug-1.03', 'deprecated': False}, + 'xerox': {'id': 'Xerox', 'deprecated': False}, + 'xfig': {'id': 'Xfig', 'deprecated': False}, + 'xfree86-1.1': {'id': 'XFree86-1.1', 'deprecated': False}, + 'xinetd': {'id': 'xinetd', 'deprecated': False}, + 'xkeyboard-config-zinoviev': {'id': 'xkeyboard-config-Zinoviev', 'deprecated': False}, + 'xlock': {'id': 'xlock', 'deprecated': False}, + 'xnet': {'id': 'Xnet', 'deprecated': False}, + 'xpp': {'id': 'xpp', 'deprecated': False}, + 'xskat': {'id': 'XSkat', 'deprecated': False}, + 'xzoom': {'id': 'xzoom', 'deprecated': False}, + 'ypl-1.0': {'id': 'YPL-1.0', 'deprecated': False}, + 'ypl-1.1': {'id': 'YPL-1.1', 'deprecated': False}, + 'zed': {'id': 'Zed', 'deprecated': False}, + 'zeeff': {'id': 'Zeeff', 'deprecated': False}, + 'zend-2.0': {'id': 'Zend-2.0', 'deprecated': False}, + 'zimbra-1.3': {'id': 'Zimbra-1.3', 'deprecated': False}, + 'zimbra-1.4': {'id': 'Zimbra-1.4', 'deprecated': False}, + 'zlib': {'id': 'Zlib', 'deprecated': False}, + 'zlib-acknowledgement': {'id': 'zlib-acknowledgement', 'deprecated': False}, + 'zpl-1.1': {'id': 'ZPL-1.1', 'deprecated': False}, + 'zpl-2.0': {'id': 'ZPL-2.0', 'deprecated': False}, + 'zpl-2.1': {'id': 'ZPL-2.1', 'deprecated': False}, +} + +EXCEPTIONS: dict[str, SPDXException] = { + '389-exception': {'id': '389-exception', 'deprecated': False}, + 'asterisk-exception': {'id': 'Asterisk-exception', 'deprecated': False}, + 'asterisk-linking-protocols-exception': {'id': 'Asterisk-linking-protocols-exception', 'deprecated': False}, + 'autoconf-exception-2.0': {'id': 'Autoconf-exception-2.0', 'deprecated': False}, + 'autoconf-exception-3.0': {'id': 'Autoconf-exception-3.0', 'deprecated': False}, + 'autoconf-exception-generic': {'id': 'Autoconf-exception-generic', 'deprecated': False}, + 'autoconf-exception-generic-3.0': {'id': 'Autoconf-exception-generic-3.0', 'deprecated': False}, + 'autoconf-exception-macro': {'id': 'Autoconf-exception-macro', 'deprecated': False}, + 'bison-exception-1.24': {'id': 'Bison-exception-1.24', 'deprecated': False}, + 'bison-exception-2.2': {'id': 'Bison-exception-2.2', 'deprecated': False}, + 'bootloader-exception': {'id': 'Bootloader-exception', 'deprecated': False}, + 'classpath-exception-2.0': {'id': 'Classpath-exception-2.0', 'deprecated': False}, + 'clisp-exception-2.0': {'id': 'CLISP-exception-2.0', 'deprecated': False}, + 'cryptsetup-openssl-exception': {'id': 'cryptsetup-OpenSSL-exception', 'deprecated': False}, + 'digirule-foss-exception': {'id': 'DigiRule-FOSS-exception', 'deprecated': False}, + 'ecos-exception-2.0': {'id': 'eCos-exception-2.0', 'deprecated': False}, + 'erlang-otp-linking-exception': {'id': 'erlang-otp-linking-exception', 'deprecated': False}, + 'fawkes-runtime-exception': {'id': 'Fawkes-Runtime-exception', 'deprecated': False}, + 'fltk-exception': {'id': 'FLTK-exception', 'deprecated': False}, + 'fmt-exception': {'id': 'fmt-exception', 'deprecated': False}, + 'font-exception-2.0': {'id': 'Font-exception-2.0', 'deprecated': False}, + 'freertos-exception-2.0': {'id': 'freertos-exception-2.0', 'deprecated': False}, + 'gcc-exception-2.0': {'id': 'GCC-exception-2.0', 'deprecated': False}, + 'gcc-exception-2.0-note': {'id': 'GCC-exception-2.0-note', 'deprecated': False}, + 'gcc-exception-3.1': {'id': 'GCC-exception-3.1', 'deprecated': False}, + 'gmsh-exception': {'id': 'Gmsh-exception', 'deprecated': False}, + 'gnat-exception': {'id': 'GNAT-exception', 'deprecated': False}, + 'gnome-examples-exception': {'id': 'GNOME-examples-exception', 'deprecated': False}, + 'gnu-compiler-exception': {'id': 'GNU-compiler-exception', 'deprecated': False}, + 'gnu-javamail-exception': {'id': 'gnu-javamail-exception', 'deprecated': False}, + 'gpl-3.0-interface-exception': {'id': 'GPL-3.0-interface-exception', 'deprecated': False}, + 'gpl-3.0-linking-exception': {'id': 'GPL-3.0-linking-exception', 'deprecated': False}, + 'gpl-3.0-linking-source-exception': {'id': 'GPL-3.0-linking-source-exception', 'deprecated': False}, + 'gpl-cc-1.0': {'id': 'GPL-CC-1.0', 'deprecated': False}, + 'gstreamer-exception-2005': {'id': 'GStreamer-exception-2005', 'deprecated': False}, + 'gstreamer-exception-2008': {'id': 'GStreamer-exception-2008', 'deprecated': False}, + 'i2p-gpl-java-exception': {'id': 'i2p-gpl-java-exception', 'deprecated': False}, + 'kicad-libraries-exception': {'id': 'KiCad-libraries-exception', 'deprecated': False}, + 'lgpl-3.0-linking-exception': {'id': 'LGPL-3.0-linking-exception', 'deprecated': False}, + 'libpri-openh323-exception': {'id': 'libpri-OpenH323-exception', 'deprecated': False}, + 'libtool-exception': {'id': 'Libtool-exception', 'deprecated': False}, + 'linux-syscall-note': {'id': 'Linux-syscall-note', 'deprecated': False}, + 'llgpl': {'id': 'LLGPL', 'deprecated': False}, + 'llvm-exception': {'id': 'LLVM-exception', 'deprecated': False}, + 'lzma-exception': {'id': 'LZMA-exception', 'deprecated': False}, + 'mif-exception': {'id': 'mif-exception', 'deprecated': False}, + 'nokia-qt-exception-1.1': {'id': 'Nokia-Qt-exception-1.1', 'deprecated': True}, + 'ocaml-lgpl-linking-exception': {'id': 'OCaml-LGPL-linking-exception', 'deprecated': False}, + 'occt-exception-1.0': {'id': 'OCCT-exception-1.0', 'deprecated': False}, + 'openjdk-assembly-exception-1.0': {'id': 'OpenJDK-assembly-exception-1.0', 'deprecated': False}, + 'openvpn-openssl-exception': {'id': 'openvpn-openssl-exception', 'deprecated': False}, + 'pcre2-exception': {'id': 'PCRE2-exception', 'deprecated': False}, + 'ps-or-pdf-font-exception-20170817': {'id': 'PS-or-PDF-font-exception-20170817', 'deprecated': False}, + 'qpl-1.0-inria-2004-exception': {'id': 'QPL-1.0-INRIA-2004-exception', 'deprecated': False}, + 'qt-gpl-exception-1.0': {'id': 'Qt-GPL-exception-1.0', 'deprecated': False}, + 'qt-lgpl-exception-1.1': {'id': 'Qt-LGPL-exception-1.1', 'deprecated': False}, + 'qwt-exception-1.0': {'id': 'Qwt-exception-1.0', 'deprecated': False}, + 'romic-exception': {'id': 'romic-exception', 'deprecated': False}, + 'rrdtool-floss-exception-2.0': {'id': 'RRDtool-FLOSS-exception-2.0', 'deprecated': False}, + 'sane-exception': {'id': 'SANE-exception', 'deprecated': False}, + 'shl-2.0': {'id': 'SHL-2.0', 'deprecated': False}, + 'shl-2.1': {'id': 'SHL-2.1', 'deprecated': False}, + 'stunnel-exception': {'id': 'stunnel-exception', 'deprecated': False}, + 'swi-exception': {'id': 'SWI-exception', 'deprecated': False}, + 'swift-exception': {'id': 'Swift-exception', 'deprecated': False}, + 'texinfo-exception': {'id': 'Texinfo-exception', 'deprecated': False}, + 'u-boot-exception-2.0': {'id': 'u-boot-exception-2.0', 'deprecated': False}, + 'ubdl-exception': {'id': 'UBDL-exception', 'deprecated': False}, + 'universal-foss-exception-1.0': {'id': 'Universal-FOSS-exception-1.0', 'deprecated': False}, + 'vsftpd-openssl-exception': {'id': 'vsftpd-openssl-exception', 'deprecated': False}, + 'wxwindows-exception-3.1': {'id': 'WxWindows-exception-3.1', 'deprecated': False}, + 'x11vnc-openssl-exception': {'id': 'x11vnc-openssl-exception', 'deprecated': False}, +} diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/markers.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/markers.py new file mode 100644 index 0000000..fb7f49c --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/markers.py @@ -0,0 +1,331 @@ +# This file is dual licensed under the terms of the Apache License, Version +# 2.0, and the BSD License. See the LICENSE file in the root of this repository +# for complete details. + +from __future__ import annotations + +import operator +import os +import platform +import sys +from typing import Any, Callable, TypedDict, cast + +from ._parser import MarkerAtom, MarkerList, Op, Value, Variable +from ._parser import parse_marker as _parse_marker +from ._tokenizer import ParserSyntaxError +from .specifiers import InvalidSpecifier, Specifier +from .utils import canonicalize_name + +__all__ = [ + "InvalidMarker", + "Marker", + "UndefinedComparison", + "UndefinedEnvironmentName", + "default_environment", +] + +Operator = Callable[[str, str], bool] + + +class InvalidMarker(ValueError): + """ + An invalid marker was found, users should refer to PEP 508. + """ + + +class UndefinedComparison(ValueError): + """ + An invalid operation was attempted on a value that doesn't support it. + """ + + +class UndefinedEnvironmentName(ValueError): + """ + A name was attempted to be used that does not exist inside of the + environment. + """ + + +class Environment(TypedDict): + implementation_name: str + """The implementation's identifier, e.g. ``'cpython'``.""" + + implementation_version: str + """ + The implementation's version, e.g. ``'3.13.0a2'`` for CPython 3.13.0a2, or + ``'7.3.13'`` for PyPy3.10 v7.3.13. + """ + + os_name: str + """ + The value of :py:data:`os.name`. The name of the operating system dependent module + imported, e.g. ``'posix'``. + """ + + platform_machine: str + """ + Returns the machine type, e.g. ``'i386'``. + + An empty string if the value cannot be determined. + """ + + platform_release: str + """ + The system's release, e.g. ``'2.2.0'`` or ``'NT'``. + + An empty string if the value cannot be determined. + """ + + platform_system: str + """ + The system/OS name, e.g. ``'Linux'``, ``'Windows'`` or ``'Java'``. + + An empty string if the value cannot be determined. + """ + + platform_version: str + """ + The system's release version, e.g. ``'#3 on degas'``. + + An empty string if the value cannot be determined. + """ + + python_full_version: str + """ + The Python version as string ``'major.minor.patchlevel'``. + + Note that unlike the Python :py:data:`sys.version`, this value will always include + the patchlevel (it defaults to 0). + """ + + platform_python_implementation: str + """ + A string identifying the Python implementation, e.g. ``'CPython'``. + """ + + python_version: str + """The Python version as string ``'major.minor'``.""" + + sys_platform: str + """ + This string contains a platform identifier that can be used to append + platform-specific components to :py:data:`sys.path`, for instance. + + For Unix systems, except on Linux and AIX, this is the lowercased OS name as + returned by ``uname -s`` with the first part of the version as returned by + ``uname -r`` appended, e.g. ``'sunos5'`` or ``'freebsd8'``, at the time when Python + was built. + """ + + +def _normalize_extra_values(results: Any) -> Any: + """ + Normalize extra values. + """ + if isinstance(results[0], tuple): + lhs, op, rhs = results[0] + if isinstance(lhs, Variable) and lhs.value == "extra": + normalized_extra = canonicalize_name(rhs.value) + rhs = Value(normalized_extra) + elif isinstance(rhs, Variable) and rhs.value == "extra": + normalized_extra = canonicalize_name(lhs.value) + lhs = Value(normalized_extra) + results[0] = lhs, op, rhs + return results + + +def _format_marker( + marker: list[str] | MarkerAtom | str, first: bool | None = True +) -> str: + assert isinstance(marker, (list, tuple, str)) + + # Sometimes we have a structure like [[...]] which is a single item list + # where the single item is itself it's own list. In that case we want skip + # the rest of this function so that we don't get extraneous () on the + # outside. + if ( + isinstance(marker, list) + and len(marker) == 1 + and isinstance(marker[0], (list, tuple)) + ): + return _format_marker(marker[0]) + + if isinstance(marker, list): + inner = (_format_marker(m, first=False) for m in marker) + if first: + return " ".join(inner) + else: + return "(" + " ".join(inner) + ")" + elif isinstance(marker, tuple): + return " ".join([m.serialize() for m in marker]) + else: + return marker + + +_operators: dict[str, Operator] = { + "in": lambda lhs, rhs: lhs in rhs, + "not in": lambda lhs, rhs: lhs not in rhs, + "<": operator.lt, + "<=": operator.le, + "==": operator.eq, + "!=": operator.ne, + ">=": operator.ge, + ">": operator.gt, +} + + +def _eval_op(lhs: str, op: Op, rhs: str) -> bool: + try: + spec = Specifier("".join([op.serialize(), rhs])) + except InvalidSpecifier: + pass + else: + return spec.contains(lhs, prereleases=True) + + oper: Operator | None = _operators.get(op.serialize()) + if oper is None: + raise UndefinedComparison(f"Undefined {op!r} on {lhs!r} and {rhs!r}.") + + return oper(lhs, rhs) + + +def _normalize(*values: str, key: str) -> tuple[str, ...]: + # PEP 685 – Comparison of extra names for optional distribution dependencies + # https://peps.python.org/pep-0685/ + # > When comparing extra names, tools MUST normalize the names being + # > compared using the semantics outlined in PEP 503 for names + if key == "extra": + return tuple(canonicalize_name(v) for v in values) + + # other environment markers don't have such standards + return values + + +def _evaluate_markers(markers: MarkerList, environment: dict[str, str]) -> bool: + groups: list[list[bool]] = [[]] + + for marker in markers: + assert isinstance(marker, (list, tuple, str)) + + if isinstance(marker, list): + groups[-1].append(_evaluate_markers(marker, environment)) + elif isinstance(marker, tuple): + lhs, op, rhs = marker + + if isinstance(lhs, Variable): + environment_key = lhs.value + lhs_value = environment[environment_key] + rhs_value = rhs.value + else: + lhs_value = lhs.value + environment_key = rhs.value + rhs_value = environment[environment_key] + + lhs_value, rhs_value = _normalize(lhs_value, rhs_value, key=environment_key) + groups[-1].append(_eval_op(lhs_value, op, rhs_value)) + else: + assert marker in ["and", "or"] + if marker == "or": + groups.append([]) + + return any(all(item) for item in groups) + + +def format_full_version(info: sys._version_info) -> str: + version = f"{info.major}.{info.minor}.{info.micro}" + kind = info.releaselevel + if kind != "final": + version += kind[0] + str(info.serial) + return version + + +def default_environment() -> Environment: + iver = format_full_version(sys.implementation.version) + implementation_name = sys.implementation.name + return { + "implementation_name": implementation_name, + "implementation_version": iver, + "os_name": os.name, + "platform_machine": platform.machine(), + "platform_release": platform.release(), + "platform_system": platform.system(), + "platform_version": platform.version(), + "python_full_version": platform.python_version(), + "platform_python_implementation": platform.python_implementation(), + "python_version": ".".join(platform.python_version_tuple()[:2]), + "sys_platform": sys.platform, + } + + +class Marker: + def __init__(self, marker: str) -> None: + # Note: We create a Marker object without calling this constructor in + # packaging.requirements.Requirement. If any additional logic is + # added here, make sure to mirror/adapt Requirement. + try: + self._markers = _normalize_extra_values(_parse_marker(marker)) + # The attribute `_markers` can be described in terms of a recursive type: + # MarkerList = List[Union[Tuple[Node, ...], str, MarkerList]] + # + # For example, the following expression: + # python_version > "3.6" or (python_version == "3.6" and os_name == "unix") + # + # is parsed into: + # [ + # (, ')>, ), + # 'and', + # [ + # (, , ), + # 'or', + # (, , ) + # ] + # ] + except ParserSyntaxError as e: + raise InvalidMarker(str(e)) from e + + def __str__(self) -> str: + return _format_marker(self._markers) + + def __repr__(self) -> str: + return f"" + + def __hash__(self) -> int: + return hash((self.__class__.__name__, str(self))) + + def __eq__(self, other: Any) -> bool: + if not isinstance(other, Marker): + return NotImplemented + + return str(self) == str(other) + + def evaluate(self, environment: dict[str, str] | None = None) -> bool: + """Evaluate a marker. + + Return the boolean from evaluating the given marker against the + environment. environment is an optional argument to override all or + part of the determined environment. + + The environment is determined from the current Python process. + """ + current_environment = cast("dict[str, str]", default_environment()) + current_environment["extra"] = "" + if environment is not None: + current_environment.update(environment) + # The API used to allow setting extra to None. We need to handle this + # case for backwards compatibility. + if current_environment["extra"] is None: + current_environment["extra"] = "" + + return _evaluate_markers( + self._markers, _repair_python_full_version(current_environment) + ) + + +def _repair_python_full_version(env: dict[str, str]) -> dict[str, str]: + """ + Work around platform.python_version() returning something that is not PEP 440 + compliant for non-tagged Python builds. + """ + if env["python_full_version"].endswith("+"): + env["python_full_version"] += "local" + return env diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/metadata.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/metadata.py new file mode 100644 index 0000000..721f411 --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/metadata.py @@ -0,0 +1,863 @@ +from __future__ import annotations + +import email.feedparser +import email.header +import email.message +import email.parser +import email.policy +import pathlib +import sys +import typing +from typing import ( + Any, + Callable, + Generic, + Literal, + TypedDict, + cast, +) + +from . import licenses, requirements, specifiers, utils +from . import version as version_module +from .licenses import NormalizedLicenseExpression + +T = typing.TypeVar("T") + + +if sys.version_info >= (3, 11): # pragma: no cover + ExceptionGroup = ExceptionGroup +else: # pragma: no cover + + class ExceptionGroup(Exception): + """A minimal implementation of :external:exc:`ExceptionGroup` from Python 3.11. + + If :external:exc:`ExceptionGroup` is already defined by Python itself, + that version is used instead. + """ + + message: str + exceptions: list[Exception] + + def __init__(self, message: str, exceptions: list[Exception]) -> None: + self.message = message + self.exceptions = exceptions + + def __repr__(self) -> str: + return f"{self.__class__.__name__}({self.message!r}, {self.exceptions!r})" + + +class InvalidMetadata(ValueError): + """A metadata field contains invalid data.""" + + field: str + """The name of the field that contains invalid data.""" + + def __init__(self, field: str, message: str) -> None: + self.field = field + super().__init__(message) + + +# The RawMetadata class attempts to make as few assumptions about the underlying +# serialization formats as possible. The idea is that as long as a serialization +# formats offer some very basic primitives in *some* way then we can support +# serializing to and from that format. +class RawMetadata(TypedDict, total=False): + """A dictionary of raw core metadata. + + Each field in core metadata maps to a key of this dictionary (when data is + provided). The key is lower-case and underscores are used instead of dashes + compared to the equivalent core metadata field. Any core metadata field that + can be specified multiple times or can hold multiple values in a single + field have a key with a plural name. See :class:`Metadata` whose attributes + match the keys of this dictionary. + + Core metadata fields that can be specified multiple times are stored as a + list or dict depending on which is appropriate for the field. Any fields + which hold multiple values in a single field are stored as a list. + + """ + + # Metadata 1.0 - PEP 241 + metadata_version: str + name: str + version: str + platforms: list[str] + summary: str + description: str + keywords: list[str] + home_page: str + author: str + author_email: str + license: str + + # Metadata 1.1 - PEP 314 + supported_platforms: list[str] + download_url: str + classifiers: list[str] + requires: list[str] + provides: list[str] + obsoletes: list[str] + + # Metadata 1.2 - PEP 345 + maintainer: str + maintainer_email: str + requires_dist: list[str] + provides_dist: list[str] + obsoletes_dist: list[str] + requires_python: str + requires_external: list[str] + project_urls: dict[str, str] + + # Metadata 2.0 + # PEP 426 attempted to completely revamp the metadata format + # but got stuck without ever being able to build consensus on + # it and ultimately ended up withdrawn. + # + # However, a number of tools had started emitting METADATA with + # `2.0` Metadata-Version, so for historical reasons, this version + # was skipped. + + # Metadata 2.1 - PEP 566 + description_content_type: str + provides_extra: list[str] + + # Metadata 2.2 - PEP 643 + dynamic: list[str] + + # Metadata 2.3 - PEP 685 + # No new fields were added in PEP 685, just some edge case were + # tightened up to provide better interoptability. + + # Metadata 2.4 - PEP 639 + license_expression: str + license_files: list[str] + + +_STRING_FIELDS = { + "author", + "author_email", + "description", + "description_content_type", + "download_url", + "home_page", + "license", + "license_expression", + "maintainer", + "maintainer_email", + "metadata_version", + "name", + "requires_python", + "summary", + "version", +} + +_LIST_FIELDS = { + "classifiers", + "dynamic", + "license_files", + "obsoletes", + "obsoletes_dist", + "platforms", + "provides", + "provides_dist", + "provides_extra", + "requires", + "requires_dist", + "requires_external", + "supported_platforms", +} + +_DICT_FIELDS = { + "project_urls", +} + + +def _parse_keywords(data: str) -> list[str]: + """Split a string of comma-separated keywords into a list of keywords.""" + return [k.strip() for k in data.split(",")] + + +def _parse_project_urls(data: list[str]) -> dict[str, str]: + """Parse a list of label/URL string pairings separated by a comma.""" + urls = {} + for pair in data: + # Our logic is slightly tricky here as we want to try and do + # *something* reasonable with malformed data. + # + # The main thing that we have to worry about, is data that does + # not have a ',' at all to split the label from the Value. There + # isn't a singular right answer here, and we will fail validation + # later on (if the caller is validating) so it doesn't *really* + # matter, but since the missing value has to be an empty str + # and our return value is dict[str, str], if we let the key + # be the missing value, then they'd have multiple '' values that + # overwrite each other in a accumulating dict. + # + # The other potentional issue is that it's possible to have the + # same label multiple times in the metadata, with no solid "right" + # answer with what to do in that case. As such, we'll do the only + # thing we can, which is treat the field as unparseable and add it + # to our list of unparsed fields. + parts = [p.strip() for p in pair.split(",", 1)] + parts.extend([""] * (max(0, 2 - len(parts)))) # Ensure 2 items + + # TODO: The spec doesn't say anything about if the keys should be + # considered case sensitive or not... logically they should + # be case-preserving and case-insensitive, but doing that + # would open up more cases where we might have duplicate + # entries. + label, url = parts + if label in urls: + # The label already exists in our set of urls, so this field + # is unparseable, and we can just add the whole thing to our + # unparseable data and stop processing it. + raise KeyError("duplicate labels in project urls") + urls[label] = url + + return urls + + +def _get_payload(msg: email.message.Message, source: bytes | str) -> str: + """Get the body of the message.""" + # If our source is a str, then our caller has managed encodings for us, + # and we don't need to deal with it. + if isinstance(source, str): + payload = msg.get_payload() + assert isinstance(payload, str) + return payload + # If our source is a bytes, then we're managing the encoding and we need + # to deal with it. + else: + bpayload = msg.get_payload(decode=True) + assert isinstance(bpayload, bytes) + try: + return bpayload.decode("utf8", "strict") + except UnicodeDecodeError as exc: + raise ValueError("payload in an invalid encoding") from exc + + +# The various parse_FORMAT functions here are intended to be as lenient as +# possible in their parsing, while still returning a correctly typed +# RawMetadata. +# +# To aid in this, we also generally want to do as little touching of the +# data as possible, except where there are possibly some historic holdovers +# that make valid data awkward to work with. +# +# While this is a lower level, intermediate format than our ``Metadata`` +# class, some light touch ups can make a massive difference in usability. + +# Map METADATA fields to RawMetadata. +_EMAIL_TO_RAW_MAPPING = { + "author": "author", + "author-email": "author_email", + "classifier": "classifiers", + "description": "description", + "description-content-type": "description_content_type", + "download-url": "download_url", + "dynamic": "dynamic", + "home-page": "home_page", + "keywords": "keywords", + "license": "license", + "license-expression": "license_expression", + "license-file": "license_files", + "maintainer": "maintainer", + "maintainer-email": "maintainer_email", + "metadata-version": "metadata_version", + "name": "name", + "obsoletes": "obsoletes", + "obsoletes-dist": "obsoletes_dist", + "platform": "platforms", + "project-url": "project_urls", + "provides": "provides", + "provides-dist": "provides_dist", + "provides-extra": "provides_extra", + "requires": "requires", + "requires-dist": "requires_dist", + "requires-external": "requires_external", + "requires-python": "requires_python", + "summary": "summary", + "supported-platform": "supported_platforms", + "version": "version", +} +_RAW_TO_EMAIL_MAPPING = {raw: email for email, raw in _EMAIL_TO_RAW_MAPPING.items()} + + +def parse_email(data: bytes | str) -> tuple[RawMetadata, dict[str, list[str]]]: + """Parse a distribution's metadata stored as email headers (e.g. from ``METADATA``). + + This function returns a two-item tuple of dicts. The first dict is of + recognized fields from the core metadata specification. Fields that can be + parsed and translated into Python's built-in types are converted + appropriately. All other fields are left as-is. Fields that are allowed to + appear multiple times are stored as lists. + + The second dict contains all other fields from the metadata. This includes + any unrecognized fields. It also includes any fields which are expected to + be parsed into a built-in type but were not formatted appropriately. Finally, + any fields that are expected to appear only once but are repeated are + included in this dict. + + """ + raw: dict[str, str | list[str] | dict[str, str]] = {} + unparsed: dict[str, list[str]] = {} + + if isinstance(data, str): + parsed = email.parser.Parser(policy=email.policy.compat32).parsestr(data) + else: + parsed = email.parser.BytesParser(policy=email.policy.compat32).parsebytes(data) + + # We have to wrap parsed.keys() in a set, because in the case of multiple + # values for a key (a list), the key will appear multiple times in the + # list of keys, but we're avoiding that by using get_all(). + for name in frozenset(parsed.keys()): + # Header names in RFC are case insensitive, so we'll normalize to all + # lower case to make comparisons easier. + name = name.lower() + + # We use get_all() here, even for fields that aren't multiple use, + # because otherwise someone could have e.g. two Name fields, and we + # would just silently ignore it rather than doing something about it. + headers = parsed.get_all(name) or [] + + # The way the email module works when parsing bytes is that it + # unconditionally decodes the bytes as ascii using the surrogateescape + # handler. When you pull that data back out (such as with get_all() ), + # it looks to see if the str has any surrogate escapes, and if it does + # it wraps it in a Header object instead of returning the string. + # + # As such, we'll look for those Header objects, and fix up the encoding. + value = [] + # Flag if we have run into any issues processing the headers, thus + # signalling that the data belongs in 'unparsed'. + valid_encoding = True + for h in headers: + # It's unclear if this can return more types than just a Header or + # a str, so we'll just assert here to make sure. + assert isinstance(h, (email.header.Header, str)) + + # If it's a header object, we need to do our little dance to get + # the real data out of it. In cases where there is invalid data + # we're going to end up with mojibake, but there's no obvious, good + # way around that without reimplementing parts of the Header object + # ourselves. + # + # That should be fine since, if mojibacked happens, this key is + # going into the unparsed dict anyways. + if isinstance(h, email.header.Header): + # The Header object stores it's data as chunks, and each chunk + # can be independently encoded, so we'll need to check each + # of them. + chunks: list[tuple[bytes, str | None]] = [] + for bin, encoding in email.header.decode_header(h): + try: + bin.decode("utf8", "strict") + except UnicodeDecodeError: + # Enable mojibake. + encoding = "latin1" + valid_encoding = False + else: + encoding = "utf8" + chunks.append((bin, encoding)) + + # Turn our chunks back into a Header object, then let that + # Header object do the right thing to turn them into a + # string for us. + value.append(str(email.header.make_header(chunks))) + # This is already a string, so just add it. + else: + value.append(h) + + # We've processed all of our values to get them into a list of str, + # but we may have mojibake data, in which case this is an unparsed + # field. + if not valid_encoding: + unparsed[name] = value + continue + + raw_name = _EMAIL_TO_RAW_MAPPING.get(name) + if raw_name is None: + # This is a bit of a weird situation, we've encountered a key that + # we don't know what it means, so we don't know whether it's meant + # to be a list or not. + # + # Since we can't really tell one way or another, we'll just leave it + # as a list, even though it may be a single item list, because that's + # what makes the most sense for email headers. + unparsed[name] = value + continue + + # If this is one of our string fields, then we'll check to see if our + # value is a list of a single item. If it is then we'll assume that + # it was emitted as a single string, and unwrap the str from inside + # the list. + # + # If it's any other kind of data, then we haven't the faintest clue + # what we should parse it as, and we have to just add it to our list + # of unparsed stuff. + if raw_name in _STRING_FIELDS and len(value) == 1: + raw[raw_name] = value[0] + # If this is one of our list of string fields, then we can just assign + # the value, since email *only* has strings, and our get_all() call + # above ensures that this is a list. + elif raw_name in _LIST_FIELDS: + raw[raw_name] = value + # Special Case: Keywords + # The keywords field is implemented in the metadata spec as a str, + # but it conceptually is a list of strings, and is serialized using + # ", ".join(keywords), so we'll do some light data massaging to turn + # this into what it logically is. + elif raw_name == "keywords" and len(value) == 1: + raw[raw_name] = _parse_keywords(value[0]) + # Special Case: Project-URL + # The project urls is implemented in the metadata spec as a list of + # specially-formatted strings that represent a key and a value, which + # is fundamentally a mapping, however the email format doesn't support + # mappings in a sane way, so it was crammed into a list of strings + # instead. + # + # We will do a little light data massaging to turn this into a map as + # it logically should be. + elif raw_name == "project_urls": + try: + raw[raw_name] = _parse_project_urls(value) + except KeyError: + unparsed[name] = value + # Nothing that we've done has managed to parse this, so it'll just + # throw it in our unparseable data and move on. + else: + unparsed[name] = value + + # We need to support getting the Description from the message payload in + # addition to getting it from the the headers. This does mean, though, there + # is the possibility of it being set both ways, in which case we put both + # in 'unparsed' since we don't know which is right. + try: + payload = _get_payload(parsed, data) + except ValueError: + unparsed.setdefault("description", []).append( + parsed.get_payload(decode=isinstance(data, bytes)) # type: ignore[call-overload] + ) + else: + if payload: + # Check to see if we've already got a description, if so then both + # it, and this body move to unparseable. + if "description" in raw: + description_header = cast(str, raw.pop("description")) + unparsed.setdefault("description", []).extend( + [description_header, payload] + ) + elif "description" in unparsed: + unparsed["description"].append(payload) + else: + raw["description"] = payload + + # We need to cast our `raw` to a metadata, because a TypedDict only support + # literal key names, but we're computing our key names on purpose, but the + # way this function is implemented, our `TypedDict` can only have valid key + # names. + return cast(RawMetadata, raw), unparsed + + +_NOT_FOUND = object() + + +# Keep the two values in sync. +_VALID_METADATA_VERSIONS = ["1.0", "1.1", "1.2", "2.1", "2.2", "2.3", "2.4"] +_MetadataVersion = Literal["1.0", "1.1", "1.2", "2.1", "2.2", "2.3", "2.4"] + +_REQUIRED_ATTRS = frozenset(["metadata_version", "name", "version"]) + + +class _Validator(Generic[T]): + """Validate a metadata field. + + All _process_*() methods correspond to a core metadata field. The method is + called with the field's raw value. If the raw value is valid it is returned + in its "enriched" form (e.g. ``version.Version`` for the ``Version`` field). + If the raw value is invalid, :exc:`InvalidMetadata` is raised (with a cause + as appropriate). + """ + + name: str + raw_name: str + added: _MetadataVersion + + def __init__( + self, + *, + added: _MetadataVersion = "1.0", + ) -> None: + self.added = added + + def __set_name__(self, _owner: Metadata, name: str) -> None: + self.name = name + self.raw_name = _RAW_TO_EMAIL_MAPPING[name] + + def __get__(self, instance: Metadata, _owner: type[Metadata]) -> T: + # With Python 3.8, the caching can be replaced with functools.cached_property(). + # No need to check the cache as attribute lookup will resolve into the + # instance's __dict__ before __get__ is called. + cache = instance.__dict__ + value = instance._raw.get(self.name) + + # To make the _process_* methods easier, we'll check if the value is None + # and if this field is NOT a required attribute, and if both of those + # things are true, we'll skip the the converter. This will mean that the + # converters never have to deal with the None union. + if self.name in _REQUIRED_ATTRS or value is not None: + try: + converter: Callable[[Any], T] = getattr(self, f"_process_{self.name}") + except AttributeError: + pass + else: + value = converter(value) + + cache[self.name] = value + try: + del instance._raw[self.name] # type: ignore[misc] + except KeyError: + pass + + return cast(T, value) + + def _invalid_metadata( + self, msg: str, cause: Exception | None = None + ) -> InvalidMetadata: + exc = InvalidMetadata( + self.raw_name, msg.format_map({"field": repr(self.raw_name)}) + ) + exc.__cause__ = cause + return exc + + def _process_metadata_version(self, value: str) -> _MetadataVersion: + # Implicitly makes Metadata-Version required. + if value not in _VALID_METADATA_VERSIONS: + raise self._invalid_metadata(f"{value!r} is not a valid metadata version") + return cast(_MetadataVersion, value) + + def _process_name(self, value: str) -> str: + if not value: + raise self._invalid_metadata("{field} is a required field") + # Validate the name as a side-effect. + try: + utils.canonicalize_name(value, validate=True) + except utils.InvalidName as exc: + raise self._invalid_metadata( + f"{value!r} is invalid for {{field}}", cause=exc + ) from exc + else: + return value + + def _process_version(self, value: str) -> version_module.Version: + if not value: + raise self._invalid_metadata("{field} is a required field") + try: + return version_module.parse(value) + except version_module.InvalidVersion as exc: + raise self._invalid_metadata( + f"{value!r} is invalid for {{field}}", cause=exc + ) from exc + + def _process_summary(self, value: str) -> str: + """Check the field contains no newlines.""" + if "\n" in value: + raise self._invalid_metadata("{field} must be a single line") + return value + + def _process_description_content_type(self, value: str) -> str: + content_types = {"text/plain", "text/x-rst", "text/markdown"} + message = email.message.EmailMessage() + message["content-type"] = value + + content_type, parameters = ( + # Defaults to `text/plain` if parsing failed. + message.get_content_type().lower(), + message["content-type"].params, + ) + # Check if content-type is valid or defaulted to `text/plain` and thus was + # not parseable. + if content_type not in content_types or content_type not in value.lower(): + raise self._invalid_metadata( + f"{{field}} must be one of {list(content_types)}, not {value!r}" + ) + + charset = parameters.get("charset", "UTF-8") + if charset != "UTF-8": + raise self._invalid_metadata( + f"{{field}} can only specify the UTF-8 charset, not {list(charset)}" + ) + + markdown_variants = {"GFM", "CommonMark"} + variant = parameters.get("variant", "GFM") # Use an acceptable default. + if content_type == "text/markdown" and variant not in markdown_variants: + raise self._invalid_metadata( + f"valid Markdown variants for {{field}} are {list(markdown_variants)}, " + f"not {variant!r}", + ) + return value + + def _process_dynamic(self, value: list[str]) -> list[str]: + for dynamic_field in map(str.lower, value): + if dynamic_field in {"name", "version", "metadata-version"}: + raise self._invalid_metadata( + f"{dynamic_field!r} is not allowed as a dynamic field" + ) + elif dynamic_field not in _EMAIL_TO_RAW_MAPPING: + raise self._invalid_metadata( + f"{dynamic_field!r} is not a valid dynamic field" + ) + return list(map(str.lower, value)) + + def _process_provides_extra( + self, + value: list[str], + ) -> list[utils.NormalizedName]: + normalized_names = [] + try: + for name in value: + normalized_names.append(utils.canonicalize_name(name, validate=True)) + except utils.InvalidName as exc: + raise self._invalid_metadata( + f"{name!r} is invalid for {{field}}", cause=exc + ) from exc + else: + return normalized_names + + def _process_requires_python(self, value: str) -> specifiers.SpecifierSet: + try: + return specifiers.SpecifierSet(value) + except specifiers.InvalidSpecifier as exc: + raise self._invalid_metadata( + f"{value!r} is invalid for {{field}}", cause=exc + ) from exc + + def _process_requires_dist( + self, + value: list[str], + ) -> list[requirements.Requirement]: + reqs = [] + try: + for req in value: + reqs.append(requirements.Requirement(req)) + except requirements.InvalidRequirement as exc: + raise self._invalid_metadata( + f"{req!r} is invalid for {{field}}", cause=exc + ) from exc + else: + return reqs + + def _process_license_expression( + self, value: str + ) -> NormalizedLicenseExpression | None: + try: + return licenses.canonicalize_license_expression(value) + except ValueError as exc: + raise self._invalid_metadata( + f"{value!r} is invalid for {{field}}", cause=exc + ) from exc + + def _process_license_files(self, value: list[str]) -> list[str]: + paths = [] + for path in value: + if ".." in path: + raise self._invalid_metadata( + f"{path!r} is invalid for {{field}}, " + "parent directory indicators are not allowed" + ) + if "*" in path: + raise self._invalid_metadata( + f"{path!r} is invalid for {{field}}, paths must be resolved" + ) + if ( + pathlib.PurePosixPath(path).is_absolute() + or pathlib.PureWindowsPath(path).is_absolute() + ): + raise self._invalid_metadata( + f"{path!r} is invalid for {{field}}, paths must be relative" + ) + if pathlib.PureWindowsPath(path).as_posix() != path: + raise self._invalid_metadata( + f"{path!r} is invalid for {{field}}, " + "paths must use '/' delimiter" + ) + paths.append(path) + return paths + + +class Metadata: + """Representation of distribution metadata. + + Compared to :class:`RawMetadata`, this class provides objects representing + metadata fields instead of only using built-in types. Any invalid metadata + will cause :exc:`InvalidMetadata` to be raised (with a + :py:attr:`~BaseException.__cause__` attribute as appropriate). + """ + + _raw: RawMetadata + + @classmethod + def from_raw(cls, data: RawMetadata, *, validate: bool = True) -> Metadata: + """Create an instance from :class:`RawMetadata`. + + If *validate* is true, all metadata will be validated. All exceptions + related to validation will be gathered and raised as an :class:`ExceptionGroup`. + """ + ins = cls() + ins._raw = data.copy() # Mutations occur due to caching enriched values. + + if validate: + exceptions: list[Exception] = [] + try: + metadata_version = ins.metadata_version + metadata_age = _VALID_METADATA_VERSIONS.index(metadata_version) + except InvalidMetadata as metadata_version_exc: + exceptions.append(metadata_version_exc) + metadata_version = None + + # Make sure to check for the fields that are present, the required + # fields (so their absence can be reported). + fields_to_check = frozenset(ins._raw) | _REQUIRED_ATTRS + # Remove fields that have already been checked. + fields_to_check -= {"metadata_version"} + + for key in fields_to_check: + try: + if metadata_version: + # Can't use getattr() as that triggers descriptor protocol which + # will fail due to no value for the instance argument. + try: + field_metadata_version = cls.__dict__[key].added + except KeyError: + exc = InvalidMetadata(key, f"unrecognized field: {key!r}") + exceptions.append(exc) + continue + field_age = _VALID_METADATA_VERSIONS.index( + field_metadata_version + ) + if field_age > metadata_age: + field = _RAW_TO_EMAIL_MAPPING[key] + exc = InvalidMetadata( + field, + f"{field} introduced in metadata version " + f"{field_metadata_version}, not {metadata_version}", + ) + exceptions.append(exc) + continue + getattr(ins, key) + except InvalidMetadata as exc: + exceptions.append(exc) + + if exceptions: + raise ExceptionGroup("invalid metadata", exceptions) + + return ins + + @classmethod + def from_email(cls, data: bytes | str, *, validate: bool = True) -> Metadata: + """Parse metadata from email headers. + + If *validate* is true, the metadata will be validated. All exceptions + related to validation will be gathered and raised as an :class:`ExceptionGroup`. + """ + raw, unparsed = parse_email(data) + + if validate: + exceptions: list[Exception] = [] + for unparsed_key in unparsed: + if unparsed_key in _EMAIL_TO_RAW_MAPPING: + message = f"{unparsed_key!r} has invalid data" + else: + message = f"unrecognized field: {unparsed_key!r}" + exceptions.append(InvalidMetadata(unparsed_key, message)) + + if exceptions: + raise ExceptionGroup("unparsed", exceptions) + + try: + return cls.from_raw(raw, validate=validate) + except ExceptionGroup as exc_group: + raise ExceptionGroup( + "invalid or unparsed metadata", exc_group.exceptions + ) from None + + metadata_version: _Validator[_MetadataVersion] = _Validator() + """:external:ref:`core-metadata-metadata-version` + (required; validated to be a valid metadata version)""" + # `name` is not normalized/typed to NormalizedName so as to provide access to + # the original/raw name. + name: _Validator[str] = _Validator() + """:external:ref:`core-metadata-name` + (required; validated using :func:`~packaging.utils.canonicalize_name` and its + *validate* parameter)""" + version: _Validator[version_module.Version] = _Validator() + """:external:ref:`core-metadata-version` (required)""" + dynamic: _Validator[list[str] | None] = _Validator( + added="2.2", + ) + """:external:ref:`core-metadata-dynamic` + (validated against core metadata field names and lowercased)""" + platforms: _Validator[list[str] | None] = _Validator() + """:external:ref:`core-metadata-platform`""" + supported_platforms: _Validator[list[str] | None] = _Validator(added="1.1") + """:external:ref:`core-metadata-supported-platform`""" + summary: _Validator[str | None] = _Validator() + """:external:ref:`core-metadata-summary` (validated to contain no newlines)""" + description: _Validator[str | None] = _Validator() # TODO 2.1: can be in body + """:external:ref:`core-metadata-description`""" + description_content_type: _Validator[str | None] = _Validator(added="2.1") + """:external:ref:`core-metadata-description-content-type` (validated)""" + keywords: _Validator[list[str] | None] = _Validator() + """:external:ref:`core-metadata-keywords`""" + home_page: _Validator[str | None] = _Validator() + """:external:ref:`core-metadata-home-page`""" + download_url: _Validator[str | None] = _Validator(added="1.1") + """:external:ref:`core-metadata-download-url`""" + author: _Validator[str | None] = _Validator() + """:external:ref:`core-metadata-author`""" + author_email: _Validator[str | None] = _Validator() + """:external:ref:`core-metadata-author-email`""" + maintainer: _Validator[str | None] = _Validator(added="1.2") + """:external:ref:`core-metadata-maintainer`""" + maintainer_email: _Validator[str | None] = _Validator(added="1.2") + """:external:ref:`core-metadata-maintainer-email`""" + license: _Validator[str | None] = _Validator() + """:external:ref:`core-metadata-license`""" + license_expression: _Validator[NormalizedLicenseExpression | None] = _Validator( + added="2.4" + ) + """:external:ref:`core-metadata-license-expression`""" + license_files: _Validator[list[str] | None] = _Validator(added="2.4") + """:external:ref:`core-metadata-license-file`""" + classifiers: _Validator[list[str] | None] = _Validator(added="1.1") + """:external:ref:`core-metadata-classifier`""" + requires_dist: _Validator[list[requirements.Requirement] | None] = _Validator( + added="1.2" + ) + """:external:ref:`core-metadata-requires-dist`""" + requires_python: _Validator[specifiers.SpecifierSet | None] = _Validator( + added="1.2" + ) + """:external:ref:`core-metadata-requires-python`""" + # Because `Requires-External` allows for non-PEP 440 version specifiers, we + # don't do any processing on the values. + requires_external: _Validator[list[str] | None] = _Validator(added="1.2") + """:external:ref:`core-metadata-requires-external`""" + project_urls: _Validator[dict[str, str] | None] = _Validator(added="1.2") + """:external:ref:`core-metadata-project-url`""" + # PEP 685 lets us raise an error if an extra doesn't pass `Name` validation + # regardless of metadata version. + provides_extra: _Validator[list[utils.NormalizedName] | None] = _Validator( + added="2.1", + ) + """:external:ref:`core-metadata-provides-extra`""" + provides_dist: _Validator[list[str] | None] = _Validator(added="1.2") + """:external:ref:`core-metadata-provides-dist`""" + obsoletes_dist: _Validator[list[str] | None] = _Validator(added="1.2") + """:external:ref:`core-metadata-obsoletes-dist`""" + requires: _Validator[list[str] | None] = _Validator(added="1.1") + """``Requires`` (deprecated)""" + provides: _Validator[list[str] | None] = _Validator(added="1.1") + """``Provides`` (deprecated)""" + obsoletes: _Validator[list[str] | None] = _Validator(added="1.1") + """``Obsoletes`` (deprecated)""" diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/py.typed b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/py.typed new file mode 100644 index 0000000..e69de29 diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/requirements.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/requirements.py new file mode 100644 index 0000000..4e068c9 --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/requirements.py @@ -0,0 +1,91 @@ +# This file is dual licensed under the terms of the Apache License, Version +# 2.0, and the BSD License. See the LICENSE file in the root of this repository +# for complete details. +from __future__ import annotations + +from typing import Any, Iterator + +from ._parser import parse_requirement as _parse_requirement +from ._tokenizer import ParserSyntaxError +from .markers import Marker, _normalize_extra_values +from .specifiers import SpecifierSet +from .utils import canonicalize_name + + +class InvalidRequirement(ValueError): + """ + An invalid requirement was found, users should refer to PEP 508. + """ + + +class Requirement: + """Parse a requirement. + + Parse a given requirement string into its parts, such as name, specifier, + URL, and extras. Raises InvalidRequirement on a badly-formed requirement + string. + """ + + # TODO: Can we test whether something is contained within a requirement? + # If so how do we do that? Do we need to test against the _name_ of + # the thing as well as the version? What about the markers? + # TODO: Can we normalize the name and extra name? + + def __init__(self, requirement_string: str) -> None: + try: + parsed = _parse_requirement(requirement_string) + except ParserSyntaxError as e: + raise InvalidRequirement(str(e)) from e + + self.name: str = parsed.name + self.url: str | None = parsed.url or None + self.extras: set[str] = set(parsed.extras or []) + self.specifier: SpecifierSet = SpecifierSet(parsed.specifier) + self.marker: Marker | None = None + if parsed.marker is not None: + self.marker = Marker.__new__(Marker) + self.marker._markers = _normalize_extra_values(parsed.marker) + + def _iter_parts(self, name: str) -> Iterator[str]: + yield name + + if self.extras: + formatted_extras = ",".join(sorted(self.extras)) + yield f"[{formatted_extras}]" + + if self.specifier: + yield str(self.specifier) + + if self.url: + yield f"@ {self.url}" + if self.marker: + yield " " + + if self.marker: + yield f"; {self.marker}" + + def __str__(self) -> str: + return "".join(self._iter_parts(self.name)) + + def __repr__(self) -> str: + return f"" + + def __hash__(self) -> int: + return hash( + ( + self.__class__.__name__, + *self._iter_parts(canonicalize_name(self.name)), + ) + ) + + def __eq__(self, other: Any) -> bool: + if not isinstance(other, Requirement): + return NotImplemented + + return ( + canonicalize_name(self.name) == canonicalize_name(other.name) + and self.extras == other.extras + and self.specifier == other.specifier + and self.url == other.url + and self.marker == other.marker + ) diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/specifiers.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/specifiers.py new file mode 100644 index 0000000..f18016e --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/specifiers.py @@ -0,0 +1,1020 @@ +# This file is dual licensed under the terms of the Apache License, Version +# 2.0, and the BSD License. See the LICENSE file in the root of this repository +# for complete details. +""" +.. testsetup:: + + from pip._vendor.packaging.specifiers import Specifier, SpecifierSet, InvalidSpecifier + from pip._vendor.packaging.version import Version +""" + +from __future__ import annotations + +import abc +import itertools +import re +from typing import Callable, Iterable, Iterator, TypeVar, Union + +from .utils import canonicalize_version +from .version import Version + +UnparsedVersion = Union[Version, str] +UnparsedVersionVar = TypeVar("UnparsedVersionVar", bound=UnparsedVersion) +CallableOperator = Callable[[Version, str], bool] + + +def _coerce_version(version: UnparsedVersion) -> Version: + if not isinstance(version, Version): + version = Version(version) + return version + + +class InvalidSpecifier(ValueError): + """ + Raised when attempting to create a :class:`Specifier` with a specifier + string that is invalid. + + >>> Specifier("lolwat") + Traceback (most recent call last): + ... + packaging.specifiers.InvalidSpecifier: Invalid specifier: 'lolwat' + """ + + +class BaseSpecifier(metaclass=abc.ABCMeta): + @abc.abstractmethod + def __str__(self) -> str: + """ + Returns the str representation of this Specifier-like object. This + should be representative of the Specifier itself. + """ + + @abc.abstractmethod + def __hash__(self) -> int: + """ + Returns a hash value for this Specifier-like object. + """ + + @abc.abstractmethod + def __eq__(self, other: object) -> bool: + """ + Returns a boolean representing whether or not the two Specifier-like + objects are equal. + + :param other: The other object to check against. + """ + + @property + @abc.abstractmethod + def prereleases(self) -> bool | None: + """Whether or not pre-releases as a whole are allowed. + + This can be set to either ``True`` or ``False`` to explicitly enable or disable + prereleases or it can be set to ``None`` (the default) to use default semantics. + """ + + @prereleases.setter + def prereleases(self, value: bool) -> None: + """Setter for :attr:`prereleases`. + + :param value: The value to set. + """ + + @abc.abstractmethod + def contains(self, item: str, prereleases: bool | None = None) -> bool: + """ + Determines if the given item is contained within this specifier. + """ + + @abc.abstractmethod + def filter( + self, iterable: Iterable[UnparsedVersionVar], prereleases: bool | None = None + ) -> Iterator[UnparsedVersionVar]: + """ + Takes an iterable of items and filters them so that only items which + are contained within this specifier are allowed in it. + """ + + +class Specifier(BaseSpecifier): + """This class abstracts handling of version specifiers. + + .. tip:: + + It is generally not required to instantiate this manually. You should instead + prefer to work with :class:`SpecifierSet` instead, which can parse + comma-separated version specifiers (which is what package metadata contains). + """ + + _operator_regex_str = r""" + (?P(~=|==|!=|<=|>=|<|>|===)) + """ + _version_regex_str = r""" + (?P + (?: + # The identity operators allow for an escape hatch that will + # do an exact string match of the version you wish to install. + # This will not be parsed by PEP 440 and we cannot determine + # any semantic meaning from it. This operator is discouraged + # but included entirely as an escape hatch. + (?<====) # Only match for the identity operator + \s* + [^\s;)]* # The arbitrary version can be just about anything, + # we match everything except for whitespace, a + # semi-colon for marker support, and a closing paren + # since versions can be enclosed in them. + ) + | + (?: + # The (non)equality operators allow for wild card and local + # versions to be specified so we have to define these two + # operators separately to enable that. + (?<===|!=) # Only match for equals and not equals + + \s* + v? + (?:[0-9]+!)? # epoch + [0-9]+(?:\.[0-9]+)* # release + + # You cannot use a wild card and a pre-release, post-release, a dev or + # local version together so group them with a | and make them optional. + (?: + \.\* # Wild card syntax of .* + | + (?: # pre release + [-_\.]? + (alpha|beta|preview|pre|a|b|c|rc) + [-_\.]? + [0-9]* + )? + (?: # post release + (?:-[0-9]+)|(?:[-_\.]?(post|rev|r)[-_\.]?[0-9]*) + )? + (?:[-_\.]?dev[-_\.]?[0-9]*)? # dev release + (?:\+[a-z0-9]+(?:[-_\.][a-z0-9]+)*)? # local + )? + ) + | + (?: + # The compatible operator requires at least two digits in the + # release segment. + (?<=~=) # Only match for the compatible operator + + \s* + v? + (?:[0-9]+!)? # epoch + [0-9]+(?:\.[0-9]+)+ # release (We have a + instead of a *) + (?: # pre release + [-_\.]? + (alpha|beta|preview|pre|a|b|c|rc) + [-_\.]? + [0-9]* + )? + (?: # post release + (?:-[0-9]+)|(?:[-_\.]?(post|rev|r)[-_\.]?[0-9]*) + )? + (?:[-_\.]?dev[-_\.]?[0-9]*)? # dev release + ) + | + (?: + # All other operators only allow a sub set of what the + # (non)equality operators do. Specifically they do not allow + # local versions to be specified nor do they allow the prefix + # matching wild cards. + (?=": "greater_than_equal", + "<": "less_than", + ">": "greater_than", + "===": "arbitrary", + } + + def __init__(self, spec: str = "", prereleases: bool | None = None) -> None: + """Initialize a Specifier instance. + + :param spec: + The string representation of a specifier which will be parsed and + normalized before use. + :param prereleases: + This tells the specifier if it should accept prerelease versions if + applicable or not. The default of ``None`` will autodetect it from the + given specifiers. + :raises InvalidSpecifier: + If the given specifier is invalid (i.e. bad syntax). + """ + match = self._regex.search(spec) + if not match: + raise InvalidSpecifier(f"Invalid specifier: {spec!r}") + + self._spec: tuple[str, str] = ( + match.group("operator").strip(), + match.group("version").strip(), + ) + + # Store whether or not this Specifier should accept prereleases + self._prereleases = prereleases + + # https://github.com/python/mypy/pull/13475#pullrequestreview-1079784515 + @property # type: ignore[override] + def prereleases(self) -> bool: + # If there is an explicit prereleases set for this, then we'll just + # blindly use that. + if self._prereleases is not None: + return self._prereleases + + # Look at all of our specifiers and determine if they are inclusive + # operators, and if they are if they are including an explicit + # prerelease. + operator, version = self._spec + if operator in ["==", ">=", "<=", "~=", "===", ">", "<"]: + # The == specifier can include a trailing .*, if it does we + # want to remove before parsing. + if operator == "==" and version.endswith(".*"): + version = version[:-2] + + # Parse the version, and if it is a pre-release than this + # specifier allows pre-releases. + if Version(version).is_prerelease: + return True + + return False + + @prereleases.setter + def prereleases(self, value: bool) -> None: + self._prereleases = value + + @property + def operator(self) -> str: + """The operator of this specifier. + + >>> Specifier("==1.2.3").operator + '==' + """ + return self._spec[0] + + @property + def version(self) -> str: + """The version of this specifier. + + >>> Specifier("==1.2.3").version + '1.2.3' + """ + return self._spec[1] + + def __repr__(self) -> str: + """A representation of the Specifier that shows all internal state. + + >>> Specifier('>=1.0.0') + =1.0.0')> + >>> Specifier('>=1.0.0', prereleases=False) + =1.0.0', prereleases=False)> + >>> Specifier('>=1.0.0', prereleases=True) + =1.0.0', prereleases=True)> + """ + pre = ( + f", prereleases={self.prereleases!r}" + if self._prereleases is not None + else "" + ) + + return f"<{self.__class__.__name__}({str(self)!r}{pre})>" + + def __str__(self) -> str: + """A string representation of the Specifier that can be round-tripped. + + >>> str(Specifier('>=1.0.0')) + '>=1.0.0' + >>> str(Specifier('>=1.0.0', prereleases=False)) + '>=1.0.0' + """ + return "{}{}".format(*self._spec) + + @property + def _canonical_spec(self) -> tuple[str, str]: + canonical_version = canonicalize_version( + self._spec[1], + strip_trailing_zero=(self._spec[0] != "~="), + ) + return self._spec[0], canonical_version + + def __hash__(self) -> int: + return hash(self._canonical_spec) + + def __eq__(self, other: object) -> bool: + """Whether or not the two Specifier-like objects are equal. + + :param other: The other object to check against. + + The value of :attr:`prereleases` is ignored. + + >>> Specifier("==1.2.3") == Specifier("== 1.2.3.0") + True + >>> (Specifier("==1.2.3", prereleases=False) == + ... Specifier("==1.2.3", prereleases=True)) + True + >>> Specifier("==1.2.3") == "==1.2.3" + True + >>> Specifier("==1.2.3") == Specifier("==1.2.4") + False + >>> Specifier("==1.2.3") == Specifier("~=1.2.3") + False + """ + if isinstance(other, str): + try: + other = self.__class__(str(other)) + except InvalidSpecifier: + return NotImplemented + elif not isinstance(other, self.__class__): + return NotImplemented + + return self._canonical_spec == other._canonical_spec + + def _get_operator(self, op: str) -> CallableOperator: + operator_callable: CallableOperator = getattr( + self, f"_compare_{self._operators[op]}" + ) + return operator_callable + + def _compare_compatible(self, prospective: Version, spec: str) -> bool: + # Compatible releases have an equivalent combination of >= and ==. That + # is that ~=2.2 is equivalent to >=2.2,==2.*. This allows us to + # implement this in terms of the other specifiers instead of + # implementing it ourselves. The only thing we need to do is construct + # the other specifiers. + + # We want everything but the last item in the version, but we want to + # ignore suffix segments. + prefix = _version_join( + list(itertools.takewhile(_is_not_suffix, _version_split(spec)))[:-1] + ) + + # Add the prefix notation to the end of our string + prefix += ".*" + + return self._get_operator(">=")(prospective, spec) and self._get_operator("==")( + prospective, prefix + ) + + def _compare_equal(self, prospective: Version, spec: str) -> bool: + # We need special logic to handle prefix matching + if spec.endswith(".*"): + # In the case of prefix matching we want to ignore local segment. + normalized_prospective = canonicalize_version( + prospective.public, strip_trailing_zero=False + ) + # Get the normalized version string ignoring the trailing .* + normalized_spec = canonicalize_version(spec[:-2], strip_trailing_zero=False) + # Split the spec out by bangs and dots, and pretend that there is + # an implicit dot in between a release segment and a pre-release segment. + split_spec = _version_split(normalized_spec) + + # Split the prospective version out by bangs and dots, and pretend + # that there is an implicit dot in between a release segment and + # a pre-release segment. + split_prospective = _version_split(normalized_prospective) + + # 0-pad the prospective version before shortening it to get the correct + # shortened version. + padded_prospective, _ = _pad_version(split_prospective, split_spec) + + # Shorten the prospective version to be the same length as the spec + # so that we can determine if the specifier is a prefix of the + # prospective version or not. + shortened_prospective = padded_prospective[: len(split_spec)] + + return shortened_prospective == split_spec + else: + # Convert our spec string into a Version + spec_version = Version(spec) + + # If the specifier does not have a local segment, then we want to + # act as if the prospective version also does not have a local + # segment. + if not spec_version.local: + prospective = Version(prospective.public) + + return prospective == spec_version + + def _compare_not_equal(self, prospective: Version, spec: str) -> bool: + return not self._compare_equal(prospective, spec) + + def _compare_less_than_equal(self, prospective: Version, spec: str) -> bool: + # NB: Local version identifiers are NOT permitted in the version + # specifier, so local version labels can be universally removed from + # the prospective version. + return Version(prospective.public) <= Version(spec) + + def _compare_greater_than_equal(self, prospective: Version, spec: str) -> bool: + # NB: Local version identifiers are NOT permitted in the version + # specifier, so local version labels can be universally removed from + # the prospective version. + return Version(prospective.public) >= Version(spec) + + def _compare_less_than(self, prospective: Version, spec_str: str) -> bool: + # Convert our spec to a Version instance, since we'll want to work with + # it as a version. + spec = Version(spec_str) + + # Check to see if the prospective version is less than the spec + # version. If it's not we can short circuit and just return False now + # instead of doing extra unneeded work. + if not prospective < spec: + return False + + # This special case is here so that, unless the specifier itself + # includes is a pre-release version, that we do not accept pre-release + # versions for the version mentioned in the specifier (e.g. <3.1 should + # not match 3.1.dev0, but should match 3.0.dev0). + if not spec.is_prerelease and prospective.is_prerelease: + if Version(prospective.base_version) == Version(spec.base_version): + return False + + # If we've gotten to here, it means that prospective version is both + # less than the spec version *and* it's not a pre-release of the same + # version in the spec. + return True + + def _compare_greater_than(self, prospective: Version, spec_str: str) -> bool: + # Convert our spec to a Version instance, since we'll want to work with + # it as a version. + spec = Version(spec_str) + + # Check to see if the prospective version is greater than the spec + # version. If it's not we can short circuit and just return False now + # instead of doing extra unneeded work. + if not prospective > spec: + return False + + # This special case is here so that, unless the specifier itself + # includes is a post-release version, that we do not accept + # post-release versions for the version mentioned in the specifier + # (e.g. >3.1 should not match 3.0.post0, but should match 3.2.post0). + if not spec.is_postrelease and prospective.is_postrelease: + if Version(prospective.base_version) == Version(spec.base_version): + return False + + # Ensure that we do not allow a local version of the version mentioned + # in the specifier, which is technically greater than, to match. + if prospective.local is not None: + if Version(prospective.base_version) == Version(spec.base_version): + return False + + # If we've gotten to here, it means that prospective version is both + # greater than the spec version *and* it's not a pre-release of the + # same version in the spec. + return True + + def _compare_arbitrary(self, prospective: Version, spec: str) -> bool: + return str(prospective).lower() == str(spec).lower() + + def __contains__(self, item: str | Version) -> bool: + """Return whether or not the item is contained in this specifier. + + :param item: The item to check for. + + This is used for the ``in`` operator and behaves the same as + :meth:`contains` with no ``prereleases`` argument passed. + + >>> "1.2.3" in Specifier(">=1.2.3") + True + >>> Version("1.2.3") in Specifier(">=1.2.3") + True + >>> "1.0.0" in Specifier(">=1.2.3") + False + >>> "1.3.0a1" in Specifier(">=1.2.3") + False + >>> "1.3.0a1" in Specifier(">=1.2.3", prereleases=True) + True + """ + return self.contains(item) + + def contains(self, item: UnparsedVersion, prereleases: bool | None = None) -> bool: + """Return whether or not the item is contained in this specifier. + + :param item: + The item to check for, which can be a version string or a + :class:`Version` instance. + :param prereleases: + Whether or not to match prereleases with this Specifier. If set to + ``None`` (the default), it uses :attr:`prereleases` to determine + whether or not prereleases are allowed. + + >>> Specifier(">=1.2.3").contains("1.2.3") + True + >>> Specifier(">=1.2.3").contains(Version("1.2.3")) + True + >>> Specifier(">=1.2.3").contains("1.0.0") + False + >>> Specifier(">=1.2.3").contains("1.3.0a1") + False + >>> Specifier(">=1.2.3", prereleases=True).contains("1.3.0a1") + True + >>> Specifier(">=1.2.3").contains("1.3.0a1", prereleases=True) + True + """ + + # Determine if prereleases are to be allowed or not. + if prereleases is None: + prereleases = self.prereleases + + # Normalize item to a Version, this allows us to have a shortcut for + # "2.0" in Specifier(">=2") + normalized_item = _coerce_version(item) + + # Determine if we should be supporting prereleases in this specifier + # or not, if we do not support prereleases than we can short circuit + # logic if this version is a prereleases. + if normalized_item.is_prerelease and not prereleases: + return False + + # Actually do the comparison to determine if this item is contained + # within this Specifier or not. + operator_callable: CallableOperator = self._get_operator(self.operator) + return operator_callable(normalized_item, self.version) + + def filter( + self, iterable: Iterable[UnparsedVersionVar], prereleases: bool | None = None + ) -> Iterator[UnparsedVersionVar]: + """Filter items in the given iterable, that match the specifier. + + :param iterable: + An iterable that can contain version strings and :class:`Version` instances. + The items in the iterable will be filtered according to the specifier. + :param prereleases: + Whether or not to allow prereleases in the returned iterator. If set to + ``None`` (the default), it will be intelligently decide whether to allow + prereleases or not (based on the :attr:`prereleases` attribute, and + whether the only versions matching are prereleases). + + This method is smarter than just ``filter(Specifier().contains, [...])`` + because it implements the rule from :pep:`440` that a prerelease item + SHOULD be accepted if no other versions match the given specifier. + + >>> list(Specifier(">=1.2.3").filter(["1.2", "1.3", "1.5a1"])) + ['1.3'] + >>> list(Specifier(">=1.2.3").filter(["1.2", "1.2.3", "1.3", Version("1.4")])) + ['1.2.3', '1.3', ] + >>> list(Specifier(">=1.2.3").filter(["1.2", "1.5a1"])) + ['1.5a1'] + >>> list(Specifier(">=1.2.3").filter(["1.3", "1.5a1"], prereleases=True)) + ['1.3', '1.5a1'] + >>> list(Specifier(">=1.2.3", prereleases=True).filter(["1.3", "1.5a1"])) + ['1.3', '1.5a1'] + """ + + yielded = False + found_prereleases = [] + + kw = {"prereleases": prereleases if prereleases is not None else True} + + # Attempt to iterate over all the values in the iterable and if any of + # them match, yield them. + for version in iterable: + parsed_version = _coerce_version(version) + + if self.contains(parsed_version, **kw): + # If our version is a prerelease, and we were not set to allow + # prereleases, then we'll store it for later in case nothing + # else matches this specifier. + if parsed_version.is_prerelease and not ( + prereleases or self.prereleases + ): + found_prereleases.append(version) + # Either this is not a prerelease, or we should have been + # accepting prereleases from the beginning. + else: + yielded = True + yield version + + # Now that we've iterated over everything, determine if we've yielded + # any values, and if we have not and we have any prereleases stored up + # then we will go ahead and yield the prereleases. + if not yielded and found_prereleases: + for version in found_prereleases: + yield version + + +_prefix_regex = re.compile(r"^([0-9]+)((?:a|b|c|rc)[0-9]+)$") + + +def _version_split(version: str) -> list[str]: + """Split version into components. + + The split components are intended for version comparison. The logic does + not attempt to retain the original version string, so joining the + components back with :func:`_version_join` may not produce the original + version string. + """ + result: list[str] = [] + + epoch, _, rest = version.rpartition("!") + result.append(epoch or "0") + + for item in rest.split("."): + match = _prefix_regex.search(item) + if match: + result.extend(match.groups()) + else: + result.append(item) + return result + + +def _version_join(components: list[str]) -> str: + """Join split version components into a version string. + + This function assumes the input came from :func:`_version_split`, where the + first component must be the epoch (either empty or numeric), and all other + components numeric. + """ + epoch, *rest = components + return f"{epoch}!{'.'.join(rest)}" + + +def _is_not_suffix(segment: str) -> bool: + return not any( + segment.startswith(prefix) for prefix in ("dev", "a", "b", "rc", "post") + ) + + +def _pad_version(left: list[str], right: list[str]) -> tuple[list[str], list[str]]: + left_split, right_split = [], [] + + # Get the release segment of our versions + left_split.append(list(itertools.takewhile(lambda x: x.isdigit(), left))) + right_split.append(list(itertools.takewhile(lambda x: x.isdigit(), right))) + + # Get the rest of our versions + left_split.append(left[len(left_split[0]) :]) + right_split.append(right[len(right_split[0]) :]) + + # Insert our padding + left_split.insert(1, ["0"] * max(0, len(right_split[0]) - len(left_split[0]))) + right_split.insert(1, ["0"] * max(0, len(left_split[0]) - len(right_split[0]))) + + return ( + list(itertools.chain.from_iterable(left_split)), + list(itertools.chain.from_iterable(right_split)), + ) + + +class SpecifierSet(BaseSpecifier): + """This class abstracts handling of a set of version specifiers. + + It can be passed a single specifier (``>=3.0``), a comma-separated list of + specifiers (``>=3.0,!=3.1``), or no specifier at all. + """ + + def __init__( + self, + specifiers: str | Iterable[Specifier] = "", + prereleases: bool | None = None, + ) -> None: + """Initialize a SpecifierSet instance. + + :param specifiers: + The string representation of a specifier or a comma-separated list of + specifiers which will be parsed and normalized before use. + May also be an iterable of ``Specifier`` instances, which will be used + as is. + :param prereleases: + This tells the SpecifierSet if it should accept prerelease versions if + applicable or not. The default of ``None`` will autodetect it from the + given specifiers. + + :raises InvalidSpecifier: + If the given ``specifiers`` are not parseable than this exception will be + raised. + """ + + if isinstance(specifiers, str): + # Split on `,` to break each individual specifier into its own item, and + # strip each item to remove leading/trailing whitespace. + split_specifiers = [s.strip() for s in specifiers.split(",") if s.strip()] + + # Make each individual specifier a Specifier and save in a frozen set + # for later. + self._specs = frozenset(map(Specifier, split_specifiers)) + else: + # Save the supplied specifiers in a frozen set. + self._specs = frozenset(specifiers) + + # Store our prereleases value so we can use it later to determine if + # we accept prereleases or not. + self._prereleases = prereleases + + @property + def prereleases(self) -> bool | None: + # If we have been given an explicit prerelease modifier, then we'll + # pass that through here. + if self._prereleases is not None: + return self._prereleases + + # If we don't have any specifiers, and we don't have a forced value, + # then we'll just return None since we don't know if this should have + # pre-releases or not. + if not self._specs: + return None + + # Otherwise we'll see if any of the given specifiers accept + # prereleases, if any of them do we'll return True, otherwise False. + return any(s.prereleases for s in self._specs) + + @prereleases.setter + def prereleases(self, value: bool) -> None: + self._prereleases = value + + def __repr__(self) -> str: + """A representation of the specifier set that shows all internal state. + + Note that the ordering of the individual specifiers within the set may not + match the input string. + + >>> SpecifierSet('>=1.0.0,!=2.0.0') + =1.0.0')> + >>> SpecifierSet('>=1.0.0,!=2.0.0', prereleases=False) + =1.0.0', prereleases=False)> + >>> SpecifierSet('>=1.0.0,!=2.0.0', prereleases=True) + =1.0.0', prereleases=True)> + """ + pre = ( + f", prereleases={self.prereleases!r}" + if self._prereleases is not None + else "" + ) + + return f"" + + def __str__(self) -> str: + """A string representation of the specifier set that can be round-tripped. + + Note that the ordering of the individual specifiers within the set may not + match the input string. + + >>> str(SpecifierSet(">=1.0.0,!=1.0.1")) + '!=1.0.1,>=1.0.0' + >>> str(SpecifierSet(">=1.0.0,!=1.0.1", prereleases=False)) + '!=1.0.1,>=1.0.0' + """ + return ",".join(sorted(str(s) for s in self._specs)) + + def __hash__(self) -> int: + return hash(self._specs) + + def __and__(self, other: SpecifierSet | str) -> SpecifierSet: + """Return a SpecifierSet which is a combination of the two sets. + + :param other: The other object to combine with. + + >>> SpecifierSet(">=1.0.0,!=1.0.1") & '<=2.0.0,!=2.0.1' + =1.0.0')> + >>> SpecifierSet(">=1.0.0,!=1.0.1") & SpecifierSet('<=2.0.0,!=2.0.1') + =1.0.0')> + """ + if isinstance(other, str): + other = SpecifierSet(other) + elif not isinstance(other, SpecifierSet): + return NotImplemented + + specifier = SpecifierSet() + specifier._specs = frozenset(self._specs | other._specs) + + if self._prereleases is None and other._prereleases is not None: + specifier._prereleases = other._prereleases + elif self._prereleases is not None and other._prereleases is None: + specifier._prereleases = self._prereleases + elif self._prereleases == other._prereleases: + specifier._prereleases = self._prereleases + else: + raise ValueError( + "Cannot combine SpecifierSets with True and False prerelease " + "overrides." + ) + + return specifier + + def __eq__(self, other: object) -> bool: + """Whether or not the two SpecifierSet-like objects are equal. + + :param other: The other object to check against. + + The value of :attr:`prereleases` is ignored. + + >>> SpecifierSet(">=1.0.0,!=1.0.1") == SpecifierSet(">=1.0.0,!=1.0.1") + True + >>> (SpecifierSet(">=1.0.0,!=1.0.1", prereleases=False) == + ... SpecifierSet(">=1.0.0,!=1.0.1", prereleases=True)) + True + >>> SpecifierSet(">=1.0.0,!=1.0.1") == ">=1.0.0,!=1.0.1" + True + >>> SpecifierSet(">=1.0.0,!=1.0.1") == SpecifierSet(">=1.0.0") + False + >>> SpecifierSet(">=1.0.0,!=1.0.1") == SpecifierSet(">=1.0.0,!=1.0.2") + False + """ + if isinstance(other, (str, Specifier)): + other = SpecifierSet(str(other)) + elif not isinstance(other, SpecifierSet): + return NotImplemented + + return self._specs == other._specs + + def __len__(self) -> int: + """Returns the number of specifiers in this specifier set.""" + return len(self._specs) + + def __iter__(self) -> Iterator[Specifier]: + """ + Returns an iterator over all the underlying :class:`Specifier` instances + in this specifier set. + + >>> sorted(SpecifierSet(">=1.0.0,!=1.0.1"), key=str) + [, =1.0.0')>] + """ + return iter(self._specs) + + def __contains__(self, item: UnparsedVersion) -> bool: + """Return whether or not the item is contained in this specifier. + + :param item: The item to check for. + + This is used for the ``in`` operator and behaves the same as + :meth:`contains` with no ``prereleases`` argument passed. + + >>> "1.2.3" in SpecifierSet(">=1.0.0,!=1.0.1") + True + >>> Version("1.2.3") in SpecifierSet(">=1.0.0,!=1.0.1") + True + >>> "1.0.1" in SpecifierSet(">=1.0.0,!=1.0.1") + False + >>> "1.3.0a1" in SpecifierSet(">=1.0.0,!=1.0.1") + False + >>> "1.3.0a1" in SpecifierSet(">=1.0.0,!=1.0.1", prereleases=True) + True + """ + return self.contains(item) + + def contains( + self, + item: UnparsedVersion, + prereleases: bool | None = None, + installed: bool | None = None, + ) -> bool: + """Return whether or not the item is contained in this SpecifierSet. + + :param item: + The item to check for, which can be a version string or a + :class:`Version` instance. + :param prereleases: + Whether or not to match prereleases with this SpecifierSet. If set to + ``None`` (the default), it uses :attr:`prereleases` to determine + whether or not prereleases are allowed. + + >>> SpecifierSet(">=1.0.0,!=1.0.1").contains("1.2.3") + True + >>> SpecifierSet(">=1.0.0,!=1.0.1").contains(Version("1.2.3")) + True + >>> SpecifierSet(">=1.0.0,!=1.0.1").contains("1.0.1") + False + >>> SpecifierSet(">=1.0.0,!=1.0.1").contains("1.3.0a1") + False + >>> SpecifierSet(">=1.0.0,!=1.0.1", prereleases=True).contains("1.3.0a1") + True + >>> SpecifierSet(">=1.0.0,!=1.0.1").contains("1.3.0a1", prereleases=True) + True + """ + # Ensure that our item is a Version instance. + if not isinstance(item, Version): + item = Version(item) + + # Determine if we're forcing a prerelease or not, if we're not forcing + # one for this particular filter call, then we'll use whatever the + # SpecifierSet thinks for whether or not we should support prereleases. + if prereleases is None: + prereleases = self.prereleases + + # We can determine if we're going to allow pre-releases by looking to + # see if any of the underlying items supports them. If none of them do + # and this item is a pre-release then we do not allow it and we can + # short circuit that here. + # Note: This means that 1.0.dev1 would not be contained in something + # like >=1.0.devabc however it would be in >=1.0.debabc,>0.0.dev0 + if not prereleases and item.is_prerelease: + return False + + if installed and item.is_prerelease: + item = Version(item.base_version) + + # We simply dispatch to the underlying specs here to make sure that the + # given version is contained within all of them. + # Note: This use of all() here means that an empty set of specifiers + # will always return True, this is an explicit design decision. + return all(s.contains(item, prereleases=prereleases) for s in self._specs) + + def filter( + self, iterable: Iterable[UnparsedVersionVar], prereleases: bool | None = None + ) -> Iterator[UnparsedVersionVar]: + """Filter items in the given iterable, that match the specifiers in this set. + + :param iterable: + An iterable that can contain version strings and :class:`Version` instances. + The items in the iterable will be filtered according to the specifier. + :param prereleases: + Whether or not to allow prereleases in the returned iterator. If set to + ``None`` (the default), it will be intelligently decide whether to allow + prereleases or not (based on the :attr:`prereleases` attribute, and + whether the only versions matching are prereleases). + + This method is smarter than just ``filter(SpecifierSet(...).contains, [...])`` + because it implements the rule from :pep:`440` that a prerelease item + SHOULD be accepted if no other versions match the given specifier. + + >>> list(SpecifierSet(">=1.2.3").filter(["1.2", "1.3", "1.5a1"])) + ['1.3'] + >>> list(SpecifierSet(">=1.2.3").filter(["1.2", "1.3", Version("1.4")])) + ['1.3', ] + >>> list(SpecifierSet(">=1.2.3").filter(["1.2", "1.5a1"])) + [] + >>> list(SpecifierSet(">=1.2.3").filter(["1.3", "1.5a1"], prereleases=True)) + ['1.3', '1.5a1'] + >>> list(SpecifierSet(">=1.2.3", prereleases=True).filter(["1.3", "1.5a1"])) + ['1.3', '1.5a1'] + + An "empty" SpecifierSet will filter items based on the presence of prerelease + versions in the set. + + >>> list(SpecifierSet("").filter(["1.3", "1.5a1"])) + ['1.3'] + >>> list(SpecifierSet("").filter(["1.5a1"])) + ['1.5a1'] + >>> list(SpecifierSet("", prereleases=True).filter(["1.3", "1.5a1"])) + ['1.3', '1.5a1'] + >>> list(SpecifierSet("").filter(["1.3", "1.5a1"], prereleases=True)) + ['1.3', '1.5a1'] + """ + # Determine if we're forcing a prerelease or not, if we're not forcing + # one for this particular filter call, then we'll use whatever the + # SpecifierSet thinks for whether or not we should support prereleases. + if prereleases is None: + prereleases = self.prereleases + + # If we have any specifiers, then we want to wrap our iterable in the + # filter method for each one, this will act as a logical AND amongst + # each specifier. + if self._specs: + for spec in self._specs: + iterable = spec.filter(iterable, prereleases=bool(prereleases)) + return iter(iterable) + # If we do not have any specifiers, then we need to have a rough filter + # which will filter out any pre-releases, unless there are no final + # releases. + else: + filtered: list[UnparsedVersionVar] = [] + found_prereleases: list[UnparsedVersionVar] = [] + + for item in iterable: + parsed_version = _coerce_version(item) + + # Store any item which is a pre-release for later unless we've + # already found a final version or we are accepting prereleases + if parsed_version.is_prerelease and not prereleases: + if not filtered: + found_prereleases.append(item) + else: + filtered.append(item) + + # If we've found no items except for pre-releases, then we'll go + # ahead and use the pre-releases + if not filtered and found_prereleases and prereleases is None: + return iter(found_prereleases) + + return iter(filtered) diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/tags.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/tags.py new file mode 100644 index 0000000..f590340 --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/tags.py @@ -0,0 +1,617 @@ +# This file is dual licensed under the terms of the Apache License, Version +# 2.0, and the BSD License. See the LICENSE file in the root of this repository +# for complete details. + +from __future__ import annotations + +import logging +import platform +import re +import struct +import subprocess +import sys +import sysconfig +from importlib.machinery import EXTENSION_SUFFIXES +from typing import ( + Iterable, + Iterator, + Sequence, + Tuple, + cast, +) + +from . import _manylinux, _musllinux + +logger = logging.getLogger(__name__) + +PythonVersion = Sequence[int] +AppleVersion = Tuple[int, int] + +INTERPRETER_SHORT_NAMES: dict[str, str] = { + "python": "py", # Generic. + "cpython": "cp", + "pypy": "pp", + "ironpython": "ip", + "jython": "jy", +} + + +_32_BIT_INTERPRETER = struct.calcsize("P") == 4 + + +class Tag: + """ + A representation of the tag triple for a wheel. + + Instances are considered immutable and thus are hashable. Equality checking + is also supported. + """ + + __slots__ = ["_abi", "_hash", "_interpreter", "_platform"] + + def __init__(self, interpreter: str, abi: str, platform: str) -> None: + self._interpreter = interpreter.lower() + self._abi = abi.lower() + self._platform = platform.lower() + # The __hash__ of every single element in a Set[Tag] will be evaluated each time + # that a set calls its `.disjoint()` method, which may be called hundreds of + # times when scanning a page of links for packages with tags matching that + # Set[Tag]. Pre-computing the value here produces significant speedups for + # downstream consumers. + self._hash = hash((self._interpreter, self._abi, self._platform)) + + @property + def interpreter(self) -> str: + return self._interpreter + + @property + def abi(self) -> str: + return self._abi + + @property + def platform(self) -> str: + return self._platform + + def __eq__(self, other: object) -> bool: + if not isinstance(other, Tag): + return NotImplemented + + return ( + (self._hash == other._hash) # Short-circuit ASAP for perf reasons. + and (self._platform == other._platform) + and (self._abi == other._abi) + and (self._interpreter == other._interpreter) + ) + + def __hash__(self) -> int: + return self._hash + + def __str__(self) -> str: + return f"{self._interpreter}-{self._abi}-{self._platform}" + + def __repr__(self) -> str: + return f"<{self} @ {id(self)}>" + + +def parse_tag(tag: str) -> frozenset[Tag]: + """ + Parses the provided tag (e.g. `py3-none-any`) into a frozenset of Tag instances. + + Returning a set is required due to the possibility that the tag is a + compressed tag set. + """ + tags = set() + interpreters, abis, platforms = tag.split("-") + for interpreter in interpreters.split("."): + for abi in abis.split("."): + for platform_ in platforms.split("."): + tags.add(Tag(interpreter, abi, platform_)) + return frozenset(tags) + + +def _get_config_var(name: str, warn: bool = False) -> int | str | None: + value: int | str | None = sysconfig.get_config_var(name) + if value is None and warn: + logger.debug( + "Config variable '%s' is unset, Python ABI tag may be incorrect", name + ) + return value + + +def _normalize_string(string: str) -> str: + return string.replace(".", "_").replace("-", "_").replace(" ", "_") + + +def _is_threaded_cpython(abis: list[str]) -> bool: + """ + Determine if the ABI corresponds to a threaded (`--disable-gil`) build. + + The threaded builds are indicated by a "t" in the abiflags. + """ + if len(abis) == 0: + return False + # expect e.g., cp313 + m = re.match(r"cp\d+(.*)", abis[0]) + if not m: + return False + abiflags = m.group(1) + return "t" in abiflags + + +def _abi3_applies(python_version: PythonVersion, threading: bool) -> bool: + """ + Determine if the Python version supports abi3. + + PEP 384 was first implemented in Python 3.2. The threaded (`--disable-gil`) + builds do not support abi3. + """ + return len(python_version) > 1 and tuple(python_version) >= (3, 2) and not threading + + +def _cpython_abis(py_version: PythonVersion, warn: bool = False) -> list[str]: + py_version = tuple(py_version) # To allow for version comparison. + abis = [] + version = _version_nodot(py_version[:2]) + threading = debug = pymalloc = ucs4 = "" + with_debug = _get_config_var("Py_DEBUG", warn) + has_refcount = hasattr(sys, "gettotalrefcount") + # Windows doesn't set Py_DEBUG, so checking for support of debug-compiled + # extension modules is the best option. + # https://github.com/pypa/pip/issues/3383#issuecomment-173267692 + has_ext = "_d.pyd" in EXTENSION_SUFFIXES + if with_debug or (with_debug is None and (has_refcount or has_ext)): + debug = "d" + if py_version >= (3, 13) and _get_config_var("Py_GIL_DISABLED", warn): + threading = "t" + if py_version < (3, 8): + with_pymalloc = _get_config_var("WITH_PYMALLOC", warn) + if with_pymalloc or with_pymalloc is None: + pymalloc = "m" + if py_version < (3, 3): + unicode_size = _get_config_var("Py_UNICODE_SIZE", warn) + if unicode_size == 4 or ( + unicode_size is None and sys.maxunicode == 0x10FFFF + ): + ucs4 = "u" + elif debug: + # Debug builds can also load "normal" extension modules. + # We can also assume no UCS-4 or pymalloc requirement. + abis.append(f"cp{version}{threading}") + abis.insert(0, f"cp{version}{threading}{debug}{pymalloc}{ucs4}") + return abis + + +def cpython_tags( + python_version: PythonVersion | None = None, + abis: Iterable[str] | None = None, + platforms: Iterable[str] | None = None, + *, + warn: bool = False, +) -> Iterator[Tag]: + """ + Yields the tags for a CPython interpreter. + + The tags consist of: + - cp-- + - cp-abi3- + - cp-none- + - cp-abi3- # Older Python versions down to 3.2. + + If python_version only specifies a major version then user-provided ABIs and + the 'none' ABItag will be used. + + If 'abi3' or 'none' are specified in 'abis' then they will be yielded at + their normal position and not at the beginning. + """ + if not python_version: + python_version = sys.version_info[:2] + + interpreter = f"cp{_version_nodot(python_version[:2])}" + + if abis is None: + if len(python_version) > 1: + abis = _cpython_abis(python_version, warn) + else: + abis = [] + abis = list(abis) + # 'abi3' and 'none' are explicitly handled later. + for explicit_abi in ("abi3", "none"): + try: + abis.remove(explicit_abi) + except ValueError: + pass + + platforms = list(platforms or platform_tags()) + for abi in abis: + for platform_ in platforms: + yield Tag(interpreter, abi, platform_) + + threading = _is_threaded_cpython(abis) + use_abi3 = _abi3_applies(python_version, threading) + if use_abi3: + yield from (Tag(interpreter, "abi3", platform_) for platform_ in platforms) + yield from (Tag(interpreter, "none", platform_) for platform_ in platforms) + + if use_abi3: + for minor_version in range(python_version[1] - 1, 1, -1): + for platform_ in platforms: + version = _version_nodot((python_version[0], minor_version)) + interpreter = f"cp{version}" + yield Tag(interpreter, "abi3", platform_) + + +def _generic_abi() -> list[str]: + """ + Return the ABI tag based on EXT_SUFFIX. + """ + # The following are examples of `EXT_SUFFIX`. + # We want to keep the parts which are related to the ABI and remove the + # parts which are related to the platform: + # - linux: '.cpython-310-x86_64-linux-gnu.so' => cp310 + # - mac: '.cpython-310-darwin.so' => cp310 + # - win: '.cp310-win_amd64.pyd' => cp310 + # - win: '.pyd' => cp37 (uses _cpython_abis()) + # - pypy: '.pypy38-pp73-x86_64-linux-gnu.so' => pypy38_pp73 + # - graalpy: '.graalpy-38-native-x86_64-darwin.dylib' + # => graalpy_38_native + + ext_suffix = _get_config_var("EXT_SUFFIX", warn=True) + if not isinstance(ext_suffix, str) or ext_suffix[0] != ".": + raise SystemError("invalid sysconfig.get_config_var('EXT_SUFFIX')") + parts = ext_suffix.split(".") + if len(parts) < 3: + # CPython3.7 and earlier uses ".pyd" on Windows. + return _cpython_abis(sys.version_info[:2]) + soabi = parts[1] + if soabi.startswith("cpython"): + # non-windows + abi = "cp" + soabi.split("-")[1] + elif soabi.startswith("cp"): + # windows + abi = soabi.split("-")[0] + elif soabi.startswith("pypy"): + abi = "-".join(soabi.split("-")[:2]) + elif soabi.startswith("graalpy"): + abi = "-".join(soabi.split("-")[:3]) + elif soabi: + # pyston, ironpython, others? + abi = soabi + else: + return [] + return [_normalize_string(abi)] + + +def generic_tags( + interpreter: str | None = None, + abis: Iterable[str] | None = None, + platforms: Iterable[str] | None = None, + *, + warn: bool = False, +) -> Iterator[Tag]: + """ + Yields the tags for a generic interpreter. + + The tags consist of: + - -- + + The "none" ABI will be added if it was not explicitly provided. + """ + if not interpreter: + interp_name = interpreter_name() + interp_version = interpreter_version(warn=warn) + interpreter = "".join([interp_name, interp_version]) + if abis is None: + abis = _generic_abi() + else: + abis = list(abis) + platforms = list(platforms or platform_tags()) + if "none" not in abis: + abis.append("none") + for abi in abis: + for platform_ in platforms: + yield Tag(interpreter, abi, platform_) + + +def _py_interpreter_range(py_version: PythonVersion) -> Iterator[str]: + """ + Yields Python versions in descending order. + + After the latest version, the major-only version will be yielded, and then + all previous versions of that major version. + """ + if len(py_version) > 1: + yield f"py{_version_nodot(py_version[:2])}" + yield f"py{py_version[0]}" + if len(py_version) > 1: + for minor in range(py_version[1] - 1, -1, -1): + yield f"py{_version_nodot((py_version[0], minor))}" + + +def compatible_tags( + python_version: PythonVersion | None = None, + interpreter: str | None = None, + platforms: Iterable[str] | None = None, +) -> Iterator[Tag]: + """ + Yields the sequence of tags that are compatible with a specific version of Python. + + The tags consist of: + - py*-none- + - -none-any # ... if `interpreter` is provided. + - py*-none-any + """ + if not python_version: + python_version = sys.version_info[:2] + platforms = list(platforms or platform_tags()) + for version in _py_interpreter_range(python_version): + for platform_ in platforms: + yield Tag(version, "none", platform_) + if interpreter: + yield Tag(interpreter, "none", "any") + for version in _py_interpreter_range(python_version): + yield Tag(version, "none", "any") + + +def _mac_arch(arch: str, is_32bit: bool = _32_BIT_INTERPRETER) -> str: + if not is_32bit: + return arch + + if arch.startswith("ppc"): + return "ppc" + + return "i386" + + +def _mac_binary_formats(version: AppleVersion, cpu_arch: str) -> list[str]: + formats = [cpu_arch] + if cpu_arch == "x86_64": + if version < (10, 4): + return [] + formats.extend(["intel", "fat64", "fat32"]) + + elif cpu_arch == "i386": + if version < (10, 4): + return [] + formats.extend(["intel", "fat32", "fat"]) + + elif cpu_arch == "ppc64": + # TODO: Need to care about 32-bit PPC for ppc64 through 10.2? + if version > (10, 5) or version < (10, 4): + return [] + formats.append("fat64") + + elif cpu_arch == "ppc": + if version > (10, 6): + return [] + formats.extend(["fat32", "fat"]) + + if cpu_arch in {"arm64", "x86_64"}: + formats.append("universal2") + + if cpu_arch in {"x86_64", "i386", "ppc64", "ppc", "intel"}: + formats.append("universal") + + return formats + + +def mac_platforms( + version: AppleVersion | None = None, arch: str | None = None +) -> Iterator[str]: + """ + Yields the platform tags for a macOS system. + + The `version` parameter is a two-item tuple specifying the macOS version to + generate platform tags for. The `arch` parameter is the CPU architecture to + generate platform tags for. Both parameters default to the appropriate value + for the current system. + """ + version_str, _, cpu_arch = platform.mac_ver() + if version is None: + version = cast("AppleVersion", tuple(map(int, version_str.split(".")[:2]))) + if version == (10, 16): + # When built against an older macOS SDK, Python will report macOS 10.16 + # instead of the real version. + version_str = subprocess.run( + [ + sys.executable, + "-sS", + "-c", + "import platform; print(platform.mac_ver()[0])", + ], + check=True, + env={"SYSTEM_VERSION_COMPAT": "0"}, + stdout=subprocess.PIPE, + text=True, + ).stdout + version = cast("AppleVersion", tuple(map(int, version_str.split(".")[:2]))) + else: + version = version + if arch is None: + arch = _mac_arch(cpu_arch) + else: + arch = arch + + if (10, 0) <= version and version < (11, 0): + # Prior to Mac OS 11, each yearly release of Mac OS bumped the + # "minor" version number. The major version was always 10. + major_version = 10 + for minor_version in range(version[1], -1, -1): + compat_version = major_version, minor_version + binary_formats = _mac_binary_formats(compat_version, arch) + for binary_format in binary_formats: + yield f"macosx_{major_version}_{minor_version}_{binary_format}" + + if version >= (11, 0): + # Starting with Mac OS 11, each yearly release bumps the major version + # number. The minor versions are now the midyear updates. + minor_version = 0 + for major_version in range(version[0], 10, -1): + compat_version = major_version, minor_version + binary_formats = _mac_binary_formats(compat_version, arch) + for binary_format in binary_formats: + yield f"macosx_{major_version}_{minor_version}_{binary_format}" + + if version >= (11, 0): + # Mac OS 11 on x86_64 is compatible with binaries from previous releases. + # Arm64 support was introduced in 11.0, so no Arm binaries from previous + # releases exist. + # + # However, the "universal2" binary format can have a + # macOS version earlier than 11.0 when the x86_64 part of the binary supports + # that version of macOS. + major_version = 10 + if arch == "x86_64": + for minor_version in range(16, 3, -1): + compat_version = major_version, minor_version + binary_formats = _mac_binary_formats(compat_version, arch) + for binary_format in binary_formats: + yield f"macosx_{major_version}_{minor_version}_{binary_format}" + else: + for minor_version in range(16, 3, -1): + compat_version = major_version, minor_version + binary_format = "universal2" + yield f"macosx_{major_version}_{minor_version}_{binary_format}" + + +def ios_platforms( + version: AppleVersion | None = None, multiarch: str | None = None +) -> Iterator[str]: + """ + Yields the platform tags for an iOS system. + + :param version: A two-item tuple specifying the iOS version to generate + platform tags for. Defaults to the current iOS version. + :param multiarch: The CPU architecture+ABI to generate platform tags for - + (the value used by `sys.implementation._multiarch` e.g., + `arm64_iphoneos` or `x84_64_iphonesimulator`). Defaults to the current + multiarch value. + """ + if version is None: + # if iOS is the current platform, ios_ver *must* be defined. However, + # it won't exist for CPython versions before 3.13, which causes a mypy + # error. + _, release, _, _ = platform.ios_ver() # type: ignore[attr-defined, unused-ignore] + version = cast("AppleVersion", tuple(map(int, release.split(".")[:2]))) + + if multiarch is None: + multiarch = sys.implementation._multiarch + multiarch = multiarch.replace("-", "_") + + ios_platform_template = "ios_{major}_{minor}_{multiarch}" + + # Consider any iOS major.minor version from the version requested, down to + # 12.0. 12.0 is the first iOS version that is known to have enough features + # to support CPython. Consider every possible minor release up to X.9. There + # highest the minor has ever gone is 8 (14.8 and 15.8) but having some extra + # candidates that won't ever match doesn't really hurt, and it saves us from + # having to keep an explicit list of known iOS versions in the code. Return + # the results descending order of version number. + + # If the requested major version is less than 12, there won't be any matches. + if version[0] < 12: + return + + # Consider the actual X.Y version that was requested. + yield ios_platform_template.format( + major=version[0], minor=version[1], multiarch=multiarch + ) + + # Consider every minor version from X.0 to the minor version prior to the + # version requested by the platform. + for minor in range(version[1] - 1, -1, -1): + yield ios_platform_template.format( + major=version[0], minor=minor, multiarch=multiarch + ) + + for major in range(version[0] - 1, 11, -1): + for minor in range(9, -1, -1): + yield ios_platform_template.format( + major=major, minor=minor, multiarch=multiarch + ) + + +def _linux_platforms(is_32bit: bool = _32_BIT_INTERPRETER) -> Iterator[str]: + linux = _normalize_string(sysconfig.get_platform()) + if not linux.startswith("linux_"): + # we should never be here, just yield the sysconfig one and return + yield linux + return + if is_32bit: + if linux == "linux_x86_64": + linux = "linux_i686" + elif linux == "linux_aarch64": + linux = "linux_armv8l" + _, arch = linux.split("_", 1) + archs = {"armv8l": ["armv8l", "armv7l"]}.get(arch, [arch]) + yield from _manylinux.platform_tags(archs) + yield from _musllinux.platform_tags(archs) + for arch in archs: + yield f"linux_{arch}" + + +def _generic_platforms() -> Iterator[str]: + yield _normalize_string(sysconfig.get_platform()) + + +def platform_tags() -> Iterator[str]: + """ + Provides the platform tags for this installation. + """ + if platform.system() == "Darwin": + return mac_platforms() + elif platform.system() == "iOS": + return ios_platforms() + elif platform.system() == "Linux": + return _linux_platforms() + else: + return _generic_platforms() + + +def interpreter_name() -> str: + """ + Returns the name of the running interpreter. + + Some implementations have a reserved, two-letter abbreviation which will + be returned when appropriate. + """ + name = sys.implementation.name + return INTERPRETER_SHORT_NAMES.get(name) or name + + +def interpreter_version(*, warn: bool = False) -> str: + """ + Returns the version of the running interpreter. + """ + version = _get_config_var("py_version_nodot", warn=warn) + if version: + version = str(version) + else: + version = _version_nodot(sys.version_info[:2]) + return version + + +def _version_nodot(version: PythonVersion) -> str: + return "".join(map(str, version)) + + +def sys_tags(*, warn: bool = False) -> Iterator[Tag]: + """ + Returns the sequence of tag triples for the running interpreter. + + The order of the sequence corresponds to priority order for the + interpreter, from most to least important. + """ + + interp_name = interpreter_name() + if interp_name == "cp": + yield from cpython_tags(warn=warn) + else: + yield from generic_tags() + + if interp_name == "pp": + interp = "pp3" + elif interp_name == "cp": + interp = "cp" + interpreter_version(warn=warn) + else: + interp = None + yield from compatible_tags(interpreter=interp) diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/utils.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/utils.py new file mode 100644 index 0000000..2345095 --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/utils.py @@ -0,0 +1,163 @@ +# This file is dual licensed under the terms of the Apache License, Version +# 2.0, and the BSD License. See the LICENSE file in the root of this repository +# for complete details. + +from __future__ import annotations + +import functools +import re +from typing import NewType, Tuple, Union, cast + +from .tags import Tag, parse_tag +from .version import InvalidVersion, Version, _TrimmedRelease + +BuildTag = Union[Tuple[()], Tuple[int, str]] +NormalizedName = NewType("NormalizedName", str) + + +class InvalidName(ValueError): + """ + An invalid distribution name; users should refer to the packaging user guide. + """ + + +class InvalidWheelFilename(ValueError): + """ + An invalid wheel filename was found, users should refer to PEP 427. + """ + + +class InvalidSdistFilename(ValueError): + """ + An invalid sdist filename was found, users should refer to the packaging user guide. + """ + + +# Core metadata spec for `Name` +_validate_regex = re.compile( + r"^([A-Z0-9]|[A-Z0-9][A-Z0-9._-]*[A-Z0-9])$", re.IGNORECASE +) +_canonicalize_regex = re.compile(r"[-_.]+") +_normalized_regex = re.compile(r"^([a-z0-9]|[a-z0-9]([a-z0-9-](?!--))*[a-z0-9])$") +# PEP 427: The build number must start with a digit. +_build_tag_regex = re.compile(r"(\d+)(.*)") + + +def canonicalize_name(name: str, *, validate: bool = False) -> NormalizedName: + if validate and not _validate_regex.match(name): + raise InvalidName(f"name is invalid: {name!r}") + # This is taken from PEP 503. + value = _canonicalize_regex.sub("-", name).lower() + return cast(NormalizedName, value) + + +def is_normalized_name(name: str) -> bool: + return _normalized_regex.match(name) is not None + + +@functools.singledispatch +def canonicalize_version( + version: Version | str, *, strip_trailing_zero: bool = True +) -> str: + """ + Return a canonical form of a version as a string. + + >>> canonicalize_version('1.0.1') + '1.0.1' + + Per PEP 625, versions may have multiple canonical forms, differing + only by trailing zeros. + + >>> canonicalize_version('1.0.0') + '1' + >>> canonicalize_version('1.0.0', strip_trailing_zero=False) + '1.0.0' + + Invalid versions are returned unaltered. + + >>> canonicalize_version('foo bar baz') + 'foo bar baz' + """ + return str(_TrimmedRelease(str(version)) if strip_trailing_zero else version) + + +@canonicalize_version.register +def _(version: str, *, strip_trailing_zero: bool = True) -> str: + try: + parsed = Version(version) + except InvalidVersion: + # Legacy versions cannot be normalized + return version + return canonicalize_version(parsed, strip_trailing_zero=strip_trailing_zero) + + +def parse_wheel_filename( + filename: str, +) -> tuple[NormalizedName, Version, BuildTag, frozenset[Tag]]: + if not filename.endswith(".whl"): + raise InvalidWheelFilename( + f"Invalid wheel filename (extension must be '.whl'): {filename!r}" + ) + + filename = filename[:-4] + dashes = filename.count("-") + if dashes not in (4, 5): + raise InvalidWheelFilename( + f"Invalid wheel filename (wrong number of parts): {filename!r}" + ) + + parts = filename.split("-", dashes - 2) + name_part = parts[0] + # See PEP 427 for the rules on escaping the project name. + if "__" in name_part or re.match(r"^[\w\d._]*$", name_part, re.UNICODE) is None: + raise InvalidWheelFilename(f"Invalid project name: {filename!r}") + name = canonicalize_name(name_part) + + try: + version = Version(parts[1]) + except InvalidVersion as e: + raise InvalidWheelFilename( + f"Invalid wheel filename (invalid version): {filename!r}" + ) from e + + if dashes == 5: + build_part = parts[2] + build_match = _build_tag_regex.match(build_part) + if build_match is None: + raise InvalidWheelFilename( + f"Invalid build number: {build_part} in {filename!r}" + ) + build = cast(BuildTag, (int(build_match.group(1)), build_match.group(2))) + else: + build = () + tags = parse_tag(parts[-1]) + return (name, version, build, tags) + + +def parse_sdist_filename(filename: str) -> tuple[NormalizedName, Version]: + if filename.endswith(".tar.gz"): + file_stem = filename[: -len(".tar.gz")] + elif filename.endswith(".zip"): + file_stem = filename[: -len(".zip")] + else: + raise InvalidSdistFilename( + f"Invalid sdist filename (extension must be '.tar.gz' or '.zip'):" + f" {filename!r}" + ) + + # We are requiring a PEP 440 version, which cannot contain dashes, + # so we split on the last dash. + name_part, sep, version_part = file_stem.rpartition("-") + if not sep: + raise InvalidSdistFilename(f"Invalid sdist filename: {filename!r}") + + name = canonicalize_name(name_part) + + try: + version = Version(version_part) + except InvalidVersion as e: + raise InvalidSdistFilename( + f"Invalid sdist filename (invalid version): {filename!r}" + ) from e + + return (name, version) diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/version.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/version.py new file mode 100644 index 0000000..21f44ca --- /dev/null +++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/version.py @@ -0,0 +1,582 @@ +# This file is dual licensed under the terms of the Apache License, Version +# 2.0, and the BSD License. See the LICENSE file in the root of this repository +# for complete details. +""" +.. testsetup:: + + from pip._vendor.packaging.version import parse, Version +""" + +from __future__ import annotations + +import itertools +import re +from typing import Any, Callable, NamedTuple, SupportsInt, Tuple, Union + +from ._structures import Infinity, InfinityType, NegativeInfinity, NegativeInfinityType + +__all__ = ["VERSION_PATTERN", "InvalidVersion", "Version", "parse"] + +LocalType = Tuple[Union[int, str], ...] + +CmpPrePostDevType = Union[InfinityType, NegativeInfinityType, Tuple[str, int]] +CmpLocalType = Union[ + NegativeInfinityType, + Tuple[Union[Tuple[int, str], Tuple[NegativeInfinityType, Union[int, str]]], ...], +] +CmpKey = Tuple[ + int, + Tuple[int, ...], + CmpPrePostDevType, + CmpPrePostDevType, + CmpPrePostDevType, + CmpLocalType, +] +VersionComparisonMethod = Callable[[CmpKey, CmpKey], bool] + + +class _Version(NamedTuple): + epoch: int + release: tuple[int, ...] + dev: tuple[str, int] | None + pre: tuple[str, int] | None + post: tuple[str, int] | None + local: LocalType | None + + +def parse(version: str) -> Version: + """Parse the given version string. + + >>> parse('1.0.dev1') + + + :param version: The version string to parse. + :raises InvalidVersion: When the version string is not a valid version. + """ + return Version(version) + + +class InvalidVersion(ValueError): + """Raised when a version string is not a valid version. + + >>> Version("invalid") + Traceback (most recent call last): + ... + packaging.version.InvalidVersion: Invalid version: 'invalid' + """ + + +class _BaseVersion: + _key: tuple[Any, ...] + + def __hash__(self) -> int: + return hash(self._key) + + # Please keep the duplicated `isinstance` check + # in the six comparisons hereunder + # unless you find a way to avoid adding overhead function calls. + def __lt__(self, other: _BaseVersion) -> bool: + if not isinstance(other, _BaseVersion): + return NotImplemented + + return self._key < other._key + + def __le__(self, other: _BaseVersion) -> bool: + if not isinstance(other, _BaseVersion): + return NotImplemented + + return self._key <= other._key + + def __eq__(self, other: object) -> bool: + if not isinstance(other, _BaseVersion): + return NotImplemented + + return self._key == other._key + + def __ge__(self, other: _BaseVersion) -> bool: + if not isinstance(other, _BaseVersion): + return NotImplemented + + return self._key >= other._key + + def __gt__(self, other: _BaseVersion) -> bool: + if not isinstance(other, _BaseVersion): + return NotImplemented + + return self._key > other._key + + def __ne__(self, other: object) -> bool: + if not isinstance(other, _BaseVersion): + return NotImplemented + + return self._key != other._key + + +# Deliberately not anchored to the start and end of the string, to make it +# easier for 3rd party code to reuse +_VERSION_PATTERN = r""" + v? + (?: + (?:(?P[0-9]+)!)? # epoch + (?P[0-9]+(?:\.[0-9]+)*) # release segment + (?P
                                          # pre-release
+            [-_\.]?
+            (?Palpha|a|beta|b|preview|pre|c|rc)
+            [-_\.]?
+            (?P[0-9]+)?
+        )?
+        (?P                                         # post release
+            (?:-(?P[0-9]+))
+            |
+            (?:
+                [-_\.]?
+                (?Ppost|rev|r)
+                [-_\.]?
+                (?P[0-9]+)?
+            )
+        )?
+        (?P                                          # dev release
+            [-_\.]?
+            (?Pdev)
+            [-_\.]?
+            (?P[0-9]+)?
+        )?
+    )
+    (?:\+(?P[a-z0-9]+(?:[-_\.][a-z0-9]+)*))?       # local version
+"""
+
+VERSION_PATTERN = _VERSION_PATTERN
+"""
+A string containing the regular expression used to match a valid version.
+
+The pattern is not anchored at either end, and is intended for embedding in larger
+expressions (for example, matching a version number as part of a file name). The
+regular expression should be compiled with the ``re.VERBOSE`` and ``re.IGNORECASE``
+flags set.
+
+:meta hide-value:
+"""
+
+
+class Version(_BaseVersion):
+    """This class abstracts handling of a project's versions.
+
+    A :class:`Version` instance is comparison aware and can be compared and
+    sorted using the standard Python interfaces.
+
+    >>> v1 = Version("1.0a5")
+    >>> v2 = Version("1.0")
+    >>> v1
+    
+    >>> v2
+    
+    >>> v1 < v2
+    True
+    >>> v1 == v2
+    False
+    >>> v1 > v2
+    False
+    >>> v1 >= v2
+    False
+    >>> v1 <= v2
+    True
+    """
+
+    _regex = re.compile(r"^\s*" + VERSION_PATTERN + r"\s*$", re.VERBOSE | re.IGNORECASE)
+    _key: CmpKey
+
+    def __init__(self, version: str) -> None:
+        """Initialize a Version object.
+
+        :param version:
+            The string representation of a version which will be parsed and normalized
+            before use.
+        :raises InvalidVersion:
+            If the ``version`` does not conform to PEP 440 in any way then this
+            exception will be raised.
+        """
+
+        # Validate the version and parse it into pieces
+        match = self._regex.search(version)
+        if not match:
+            raise InvalidVersion(f"Invalid version: {version!r}")
+
+        # Store the parsed out pieces of the version
+        self._version = _Version(
+            epoch=int(match.group("epoch")) if match.group("epoch") else 0,
+            release=tuple(int(i) for i in match.group("release").split(".")),
+            pre=_parse_letter_version(match.group("pre_l"), match.group("pre_n")),
+            post=_parse_letter_version(
+                match.group("post_l"), match.group("post_n1") or match.group("post_n2")
+            ),
+            dev=_parse_letter_version(match.group("dev_l"), match.group("dev_n")),
+            local=_parse_local_version(match.group("local")),
+        )
+
+        # Generate a key which will be used for sorting
+        self._key = _cmpkey(
+            self._version.epoch,
+            self._version.release,
+            self._version.pre,
+            self._version.post,
+            self._version.dev,
+            self._version.local,
+        )
+
+    def __repr__(self) -> str:
+        """A representation of the Version that shows all internal state.
+
+        >>> Version('1.0.0')
+        
+        """
+        return f""
+
+    def __str__(self) -> str:
+        """A string representation of the version that can be round-tripped.
+
+        >>> str(Version("1.0a5"))
+        '1.0a5'
+        """
+        parts = []
+
+        # Epoch
+        if self.epoch != 0:
+            parts.append(f"{self.epoch}!")
+
+        # Release segment
+        parts.append(".".join(str(x) for x in self.release))
+
+        # Pre-release
+        if self.pre is not None:
+            parts.append("".join(str(x) for x in self.pre))
+
+        # Post-release
+        if self.post is not None:
+            parts.append(f".post{self.post}")
+
+        # Development release
+        if self.dev is not None:
+            parts.append(f".dev{self.dev}")
+
+        # Local version segment
+        if self.local is not None:
+            parts.append(f"+{self.local}")
+
+        return "".join(parts)
+
+    @property
+    def epoch(self) -> int:
+        """The epoch of the version.
+
+        >>> Version("2.0.0").epoch
+        0
+        >>> Version("1!2.0.0").epoch
+        1
+        """
+        return self._version.epoch
+
+    @property
+    def release(self) -> tuple[int, ...]:
+        """The components of the "release" segment of the version.
+
+        >>> Version("1.2.3").release
+        (1, 2, 3)
+        >>> Version("2.0.0").release
+        (2, 0, 0)
+        >>> Version("1!2.0.0.post0").release
+        (2, 0, 0)
+
+        Includes trailing zeroes but not the epoch or any pre-release / development /
+        post-release suffixes.
+        """
+        return self._version.release
+
+    @property
+    def pre(self) -> tuple[str, int] | None:
+        """The pre-release segment of the version.
+
+        >>> print(Version("1.2.3").pre)
+        None
+        >>> Version("1.2.3a1").pre
+        ('a', 1)
+        >>> Version("1.2.3b1").pre
+        ('b', 1)
+        >>> Version("1.2.3rc1").pre
+        ('rc', 1)
+        """
+        return self._version.pre
+
+    @property
+    def post(self) -> int | None:
+        """The post-release number of the version.
+
+        >>> print(Version("1.2.3").post)
+        None
+        >>> Version("1.2.3.post1").post
+        1
+        """
+        return self._version.post[1] if self._version.post else None
+
+    @property
+    def dev(self) -> int | None:
+        """The development number of the version.
+
+        >>> print(Version("1.2.3").dev)
+        None
+        >>> Version("1.2.3.dev1").dev
+        1
+        """
+        return self._version.dev[1] if self._version.dev else None
+
+    @property
+    def local(self) -> str | None:
+        """The local version segment of the version.
+
+        >>> print(Version("1.2.3").local)
+        None
+        >>> Version("1.2.3+abc").local
+        'abc'
+        """
+        if self._version.local:
+            return ".".join(str(x) for x in self._version.local)
+        else:
+            return None
+
+    @property
+    def public(self) -> str:
+        """The public portion of the version.
+
+        >>> Version("1.2.3").public
+        '1.2.3'
+        >>> Version("1.2.3+abc").public
+        '1.2.3'
+        >>> Version("1!1.2.3dev1+abc").public
+        '1!1.2.3.dev1'
+        """
+        return str(self).split("+", 1)[0]
+
+    @property
+    def base_version(self) -> str:
+        """The "base version" of the version.
+
+        >>> Version("1.2.3").base_version
+        '1.2.3'
+        >>> Version("1.2.3+abc").base_version
+        '1.2.3'
+        >>> Version("1!1.2.3dev1+abc").base_version
+        '1!1.2.3'
+
+        The "base version" is the public version of the project without any pre or post
+        release markers.
+        """
+        parts = []
+
+        # Epoch
+        if self.epoch != 0:
+            parts.append(f"{self.epoch}!")
+
+        # Release segment
+        parts.append(".".join(str(x) for x in self.release))
+
+        return "".join(parts)
+
+    @property
+    def is_prerelease(self) -> bool:
+        """Whether this version is a pre-release.
+
+        >>> Version("1.2.3").is_prerelease
+        False
+        >>> Version("1.2.3a1").is_prerelease
+        True
+        >>> Version("1.2.3b1").is_prerelease
+        True
+        >>> Version("1.2.3rc1").is_prerelease
+        True
+        >>> Version("1.2.3dev1").is_prerelease
+        True
+        """
+        return self.dev is not None or self.pre is not None
+
+    @property
+    def is_postrelease(self) -> bool:
+        """Whether this version is a post-release.
+
+        >>> Version("1.2.3").is_postrelease
+        False
+        >>> Version("1.2.3.post1").is_postrelease
+        True
+        """
+        return self.post is not None
+
+    @property
+    def is_devrelease(self) -> bool:
+        """Whether this version is a development release.
+
+        >>> Version("1.2.3").is_devrelease
+        False
+        >>> Version("1.2.3.dev1").is_devrelease
+        True
+        """
+        return self.dev is not None
+
+    @property
+    def major(self) -> int:
+        """The first item of :attr:`release` or ``0`` if unavailable.
+
+        >>> Version("1.2.3").major
+        1
+        """
+        return self.release[0] if len(self.release) >= 1 else 0
+
+    @property
+    def minor(self) -> int:
+        """The second item of :attr:`release` or ``0`` if unavailable.
+
+        >>> Version("1.2.3").minor
+        2
+        >>> Version("1").minor
+        0
+        """
+        return self.release[1] if len(self.release) >= 2 else 0
+
+    @property
+    def micro(self) -> int:
+        """The third item of :attr:`release` or ``0`` if unavailable.
+
+        >>> Version("1.2.3").micro
+        3
+        >>> Version("1").micro
+        0
+        """
+        return self.release[2] if len(self.release) >= 3 else 0
+
+
+class _TrimmedRelease(Version):
+    @property
+    def release(self) -> tuple[int, ...]:
+        """
+        Release segment without any trailing zeros.
+
+        >>> _TrimmedRelease('1.0.0').release
+        (1,)
+        >>> _TrimmedRelease('0.0').release
+        (0,)
+        """
+        rel = super().release
+        nonzeros = (index for index, val in enumerate(rel) if val)
+        last_nonzero = max(nonzeros, default=0)
+        return rel[: last_nonzero + 1]
+
+
+def _parse_letter_version(
+    letter: str | None, number: str | bytes | SupportsInt | None
+) -> tuple[str, int] | None:
+    if letter:
+        # We consider there to be an implicit 0 in a pre-release if there is
+        # not a numeral associated with it.
+        if number is None:
+            number = 0
+
+        # We normalize any letters to their lower case form
+        letter = letter.lower()
+
+        # We consider some words to be alternate spellings of other words and
+        # in those cases we want to normalize the spellings to our preferred
+        # spelling.
+        if letter == "alpha":
+            letter = "a"
+        elif letter == "beta":
+            letter = "b"
+        elif letter in ["c", "pre", "preview"]:
+            letter = "rc"
+        elif letter in ["rev", "r"]:
+            letter = "post"
+
+        return letter, int(number)
+
+    assert not letter
+    if number:
+        # We assume if we are given a number, but we are not given a letter
+        # then this is using the implicit post release syntax (e.g. 1.0-1)
+        letter = "post"
+
+        return letter, int(number)
+
+    return None
+
+
+_local_version_separators = re.compile(r"[\._-]")
+
+
+def _parse_local_version(local: str | None) -> LocalType | None:
+    """
+    Takes a string like abc.1.twelve and turns it into ("abc", 1, "twelve").
+    """
+    if local is not None:
+        return tuple(
+            part.lower() if not part.isdigit() else int(part)
+            for part in _local_version_separators.split(local)
+        )
+    return None
+
+
+def _cmpkey(
+    epoch: int,
+    release: tuple[int, ...],
+    pre: tuple[str, int] | None,
+    post: tuple[str, int] | None,
+    dev: tuple[str, int] | None,
+    local: LocalType | None,
+) -> CmpKey:
+    # When we compare a release version, we want to compare it with all of the
+    # trailing zeros removed. So we'll use a reverse the list, drop all the now
+    # leading zeros until we come to something non zero, then take the rest
+    # re-reverse it back into the correct order and make it a tuple and use
+    # that for our sorting key.
+    _release = tuple(
+        reversed(list(itertools.dropwhile(lambda x: x == 0, reversed(release))))
+    )
+
+    # We need to "trick" the sorting algorithm to put 1.0.dev0 before 1.0a0.
+    # We'll do this by abusing the pre segment, but we _only_ want to do this
+    # if there is not a pre or a post segment. If we have one of those then
+    # the normal sorting rules will handle this case correctly.
+    if pre is None and post is None and dev is not None:
+        _pre: CmpPrePostDevType = NegativeInfinity
+    # Versions without a pre-release (except as noted above) should sort after
+    # those with one.
+    elif pre is None:
+        _pre = Infinity
+    else:
+        _pre = pre
+
+    # Versions without a post segment should sort before those with one.
+    if post is None:
+        _post: CmpPrePostDevType = NegativeInfinity
+
+    else:
+        _post = post
+
+    # Versions without a development segment should sort after those with one.
+    if dev is None:
+        _dev: CmpPrePostDevType = Infinity
+
+    else:
+        _dev = dev
+
+    if local is None:
+        # Versions without a local segment should sort before those with one.
+        _local: CmpLocalType = NegativeInfinity
+    else:
+        # Versions with a local segment need that segment parsed to implement
+        # the sorting rules in PEP440.
+        # - Alpha numeric segments sort before numeric segments
+        # - Alpha numeric segments sort lexicographically
+        # - Numeric segments sort numerically
+        # - Shorter versions sort before longer versions when the prefixes
+        #   match exactly
+        _local = tuple(
+            (i, "") if isinstance(i, int) else (NegativeInfinity, i) for i in local
+        )
+
+    return epoch, _release, _pre, _post, _dev, _local
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pkg_resources/__init__.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pkg_resources/__init__.py
new file mode 100644
index 0000000..57ce7f1
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pkg_resources/__init__.py
@@ -0,0 +1,3676 @@
+# TODO: Add Generic type annotations to initialized collections.
+# For now we'd simply use implicit Any/Unknown which would add redundant annotations
+# mypy: disable-error-code="var-annotated"
+"""
+Package resource API
+--------------------
+
+A resource is a logical file contained within a package, or a logical
+subdirectory thereof.  The package resource API expects resource names
+to have their path parts separated with ``/``, *not* whatever the local
+path separator is.  Do not use os.path operations to manipulate resource
+names being passed into the API.
+
+The package resource API is designed to work with normal filesystem packages,
+.egg files, and unpacked .egg files.  It can also work in a limited way with
+.zip files and with custom PEP 302 loaders that support the ``get_data()``
+method.
+
+This module is deprecated. Users are directed to :mod:`importlib.resources`,
+:mod:`importlib.metadata` and :pypi:`packaging` instead.
+"""
+
+from __future__ import annotations
+
+import sys
+
+if sys.version_info < (3, 8):  # noqa: UP036 # Check for unsupported versions
+    raise RuntimeError("Python 3.8 or later is required")
+
+import os
+import io
+import time
+import re
+import types
+from typing import (
+    Any,
+    Literal,
+    Dict,
+    Iterator,
+    Mapping,
+    MutableSequence,
+    NamedTuple,
+    NoReturn,
+    Tuple,
+    Union,
+    TYPE_CHECKING,
+    Protocol,
+    Callable,
+    Iterable,
+    TypeVar,
+    overload,
+)
+import zipfile
+import zipimport
+import warnings
+import stat
+import functools
+import pkgutil
+import operator
+import platform
+import collections
+import plistlib
+import email.parser
+import errno
+import tempfile
+import textwrap
+import inspect
+import ntpath
+import posixpath
+import importlib
+import importlib.abc
+import importlib.machinery
+from pkgutil import get_importer
+
+import _imp
+
+# capture these to bypass sandboxing
+from os import utime
+from os import open as os_open
+from os.path import isdir, split
+
+try:
+    from os import mkdir, rename, unlink
+
+    WRITE_SUPPORT = True
+except ImportError:
+    # no write support, probably under GAE
+    WRITE_SUPPORT = False
+
+from pip._internal.utils._jaraco_text import (
+    yield_lines,
+    drop_comment,
+    join_continuation,
+)
+from pip._vendor.packaging import markers as _packaging_markers
+from pip._vendor.packaging import requirements as _packaging_requirements
+from pip._vendor.packaging import utils as _packaging_utils
+from pip._vendor.packaging import version as _packaging_version
+from pip._vendor.platformdirs import user_cache_dir as _user_cache_dir
+
+if TYPE_CHECKING:
+    from _typeshed import BytesPath, StrPath, StrOrBytesPath
+    from pip._vendor.typing_extensions import Self
+
+
+# Patch: Remove deprecation warning from vendored pkg_resources.
+# Setting PYTHONWARNINGS=error to verify builds produce no warnings
+# causes immediate exceptions.
+# See https://github.com/pypa/pip/issues/12243
+
+
+_T = TypeVar("_T")
+_DistributionT = TypeVar("_DistributionT", bound="Distribution")
+# Type aliases
+_NestedStr = Union[str, Iterable[Union[str, Iterable["_NestedStr"]]]]
+_InstallerTypeT = Callable[["Requirement"], "_DistributionT"]
+_InstallerType = Callable[["Requirement"], Union["Distribution", None]]
+_PkgReqType = Union[str, "Requirement"]
+_EPDistType = Union["Distribution", _PkgReqType]
+_MetadataType = Union["IResourceProvider", None]
+_ResolvedEntryPoint = Any  # Can be any attribute in the module
+_ResourceStream = Any  # TODO / Incomplete: A readable file-like object
+# Any object works, but let's indicate we expect something like a module (optionally has __loader__ or __file__)
+_ModuleLike = Union[object, types.ModuleType]
+# Any: Should be _ModuleLike but we end up with issues where _ModuleLike doesn't have _ZipLoaderModule's __loader__
+_ProviderFactoryType = Callable[[Any], "IResourceProvider"]
+_DistFinderType = Callable[[_T, str, bool], Iterable["Distribution"]]
+_NSHandlerType = Callable[[_T, str, str, types.ModuleType], Union[str, None]]
+_AdapterT = TypeVar(
+    "_AdapterT", _DistFinderType[Any], _ProviderFactoryType, _NSHandlerType[Any]
+)
+
+
+# Use _typeshed.importlib.LoaderProtocol once available https://github.com/python/typeshed/pull/11890
+class _LoaderProtocol(Protocol):
+    def load_module(self, fullname: str, /) -> types.ModuleType: ...
+
+
+class _ZipLoaderModule(Protocol):
+    __loader__: zipimport.zipimporter
+
+
+_PEP440_FALLBACK = re.compile(r"^v?(?P(?:[0-9]+!)?[0-9]+(?:\.[0-9]+)*)", re.I)
+
+
+class PEP440Warning(RuntimeWarning):
+    """
+    Used when there is an issue with a version or specifier not complying with
+    PEP 440.
+    """
+
+
+parse_version = _packaging_version.Version
+
+
+_state_vars: dict[str, str] = {}
+
+
+def _declare_state(vartype: str, varname: str, initial_value: _T) -> _T:
+    _state_vars[varname] = vartype
+    return initial_value
+
+
+def __getstate__() -> dict[str, Any]:
+    state = {}
+    g = globals()
+    for k, v in _state_vars.items():
+        state[k] = g['_sget_' + v](g[k])
+    return state
+
+
+def __setstate__(state: dict[str, Any]) -> dict[str, Any]:
+    g = globals()
+    for k, v in state.items():
+        g['_sset_' + _state_vars[k]](k, g[k], v)
+    return state
+
+
+def _sget_dict(val):
+    return val.copy()
+
+
+def _sset_dict(key, ob, state):
+    ob.clear()
+    ob.update(state)
+
+
+def _sget_object(val):
+    return val.__getstate__()
+
+
+def _sset_object(key, ob, state):
+    ob.__setstate__(state)
+
+
+_sget_none = _sset_none = lambda *args: None
+
+
+def get_supported_platform():
+    """Return this platform's maximum compatible version.
+
+    distutils.util.get_platform() normally reports the minimum version
+    of macOS that would be required to *use* extensions produced by
+    distutils.  But what we want when checking compatibility is to know the
+    version of macOS that we are *running*.  To allow usage of packages that
+    explicitly require a newer version of macOS, we must also know the
+    current version of the OS.
+
+    If this condition occurs for any other platform with a version in its
+    platform strings, this function should be extended accordingly.
+    """
+    plat = get_build_platform()
+    m = macosVersionString.match(plat)
+    if m is not None and sys.platform == "darwin":
+        try:
+            plat = 'macosx-%s-%s' % ('.'.join(_macos_vers()[:2]), m.group(3))
+        except ValueError:
+            # not macOS
+            pass
+    return plat
+
+
+__all__ = [
+    # Basic resource access and distribution/entry point discovery
+    'require',
+    'run_script',
+    'get_provider',
+    'get_distribution',
+    'load_entry_point',
+    'get_entry_map',
+    'get_entry_info',
+    'iter_entry_points',
+    'resource_string',
+    'resource_stream',
+    'resource_filename',
+    'resource_listdir',
+    'resource_exists',
+    'resource_isdir',
+    # Environmental control
+    'declare_namespace',
+    'working_set',
+    'add_activation_listener',
+    'find_distributions',
+    'set_extraction_path',
+    'cleanup_resources',
+    'get_default_cache',
+    # Primary implementation classes
+    'Environment',
+    'WorkingSet',
+    'ResourceManager',
+    'Distribution',
+    'Requirement',
+    'EntryPoint',
+    # Exceptions
+    'ResolutionError',
+    'VersionConflict',
+    'DistributionNotFound',
+    'UnknownExtra',
+    'ExtractionError',
+    # Warnings
+    'PEP440Warning',
+    # Parsing functions and string utilities
+    'parse_requirements',
+    'parse_version',
+    'safe_name',
+    'safe_version',
+    'get_platform',
+    'compatible_platforms',
+    'yield_lines',
+    'split_sections',
+    'safe_extra',
+    'to_filename',
+    'invalid_marker',
+    'evaluate_marker',
+    # filesystem utilities
+    'ensure_directory',
+    'normalize_path',
+    # Distribution "precedence" constants
+    'EGG_DIST',
+    'BINARY_DIST',
+    'SOURCE_DIST',
+    'CHECKOUT_DIST',
+    'DEVELOP_DIST',
+    # "Provider" interfaces, implementations, and registration/lookup APIs
+    'IMetadataProvider',
+    'IResourceProvider',
+    'FileMetadata',
+    'PathMetadata',
+    'EggMetadata',
+    'EmptyProvider',
+    'empty_provider',
+    'NullProvider',
+    'EggProvider',
+    'DefaultProvider',
+    'ZipProvider',
+    'register_finder',
+    'register_namespace_handler',
+    'register_loader_type',
+    'fixup_namespace_packages',
+    'get_importer',
+    # Warnings
+    'PkgResourcesDeprecationWarning',
+    # Deprecated/backward compatibility only
+    'run_main',
+    'AvailableDistributions',
+]
+
+
+class ResolutionError(Exception):
+    """Abstract base for dependency resolution errors"""
+
+    def __repr__(self):
+        return self.__class__.__name__ + repr(self.args)
+
+
+class VersionConflict(ResolutionError):
+    """
+    An already-installed version conflicts with the requested version.
+
+    Should be initialized with the installed Distribution and the requested
+    Requirement.
+    """
+
+    _template = "{self.dist} is installed but {self.req} is required"
+
+    @property
+    def dist(self) -> Distribution:
+        return self.args[0]
+
+    @property
+    def req(self) -> Requirement:
+        return self.args[1]
+
+    def report(self):
+        return self._template.format(**locals())
+
+    def with_context(self, required_by: set[Distribution | str]):
+        """
+        If required_by is non-empty, return a version of self that is a
+        ContextualVersionConflict.
+        """
+        if not required_by:
+            return self
+        args = self.args + (required_by,)
+        return ContextualVersionConflict(*args)
+
+
+class ContextualVersionConflict(VersionConflict):
+    """
+    A VersionConflict that accepts a third parameter, the set of the
+    requirements that required the installed Distribution.
+    """
+
+    _template = VersionConflict._template + ' by {self.required_by}'
+
+    @property
+    def required_by(self) -> set[str]:
+        return self.args[2]
+
+
+class DistributionNotFound(ResolutionError):
+    """A requested distribution was not found"""
+
+    _template = (
+        "The '{self.req}' distribution was not found "
+        "and is required by {self.requirers_str}"
+    )
+
+    @property
+    def req(self) -> Requirement:
+        return self.args[0]
+
+    @property
+    def requirers(self) -> set[str] | None:
+        return self.args[1]
+
+    @property
+    def requirers_str(self):
+        if not self.requirers:
+            return 'the application'
+        return ', '.join(self.requirers)
+
+    def report(self):
+        return self._template.format(**locals())
+
+    def __str__(self):
+        return self.report()
+
+
+class UnknownExtra(ResolutionError):
+    """Distribution doesn't have an "extra feature" of the given name"""
+
+
+_provider_factories: dict[type[_ModuleLike], _ProviderFactoryType] = {}
+
+PY_MAJOR = '{}.{}'.format(*sys.version_info)
+EGG_DIST = 3
+BINARY_DIST = 2
+SOURCE_DIST = 1
+CHECKOUT_DIST = 0
+DEVELOP_DIST = -1
+
+
+def register_loader_type(
+    loader_type: type[_ModuleLike], provider_factory: _ProviderFactoryType
+):
+    """Register `provider_factory` to make providers for `loader_type`
+
+    `loader_type` is the type or class of a PEP 302 ``module.__loader__``,
+    and `provider_factory` is a function that, passed a *module* object,
+    returns an ``IResourceProvider`` for that module.
+    """
+    _provider_factories[loader_type] = provider_factory
+
+
+@overload
+def get_provider(moduleOrReq: str) -> IResourceProvider: ...
+@overload
+def get_provider(moduleOrReq: Requirement) -> Distribution: ...
+def get_provider(moduleOrReq: str | Requirement) -> IResourceProvider | Distribution:
+    """Return an IResourceProvider for the named module or requirement"""
+    if isinstance(moduleOrReq, Requirement):
+        return working_set.find(moduleOrReq) or require(str(moduleOrReq))[0]
+    try:
+        module = sys.modules[moduleOrReq]
+    except KeyError:
+        __import__(moduleOrReq)
+        module = sys.modules[moduleOrReq]
+    loader = getattr(module, '__loader__', None)
+    return _find_adapter(_provider_factories, loader)(module)
+
+
+@functools.lru_cache(maxsize=None)
+def _macos_vers():
+    version = platform.mac_ver()[0]
+    # fallback for MacPorts
+    if version == '':
+        plist = '/System/Library/CoreServices/SystemVersion.plist'
+        if os.path.exists(plist):
+            with open(plist, 'rb') as fh:
+                plist_content = plistlib.load(fh)
+            if 'ProductVersion' in plist_content:
+                version = plist_content['ProductVersion']
+    return version.split('.')
+
+
+def _macos_arch(machine):
+    return {'PowerPC': 'ppc', 'Power_Macintosh': 'ppc'}.get(machine, machine)
+
+
+def get_build_platform():
+    """Return this platform's string for platform-specific distributions
+
+    XXX Currently this is the same as ``distutils.util.get_platform()``, but it
+    needs some hacks for Linux and macOS.
+    """
+    from sysconfig import get_platform
+
+    plat = get_platform()
+    if sys.platform == "darwin" and not plat.startswith('macosx-'):
+        try:
+            version = _macos_vers()
+            machine = os.uname()[4].replace(" ", "_")
+            return "macosx-%d.%d-%s" % (
+                int(version[0]),
+                int(version[1]),
+                _macos_arch(machine),
+            )
+        except ValueError:
+            # if someone is running a non-Mac darwin system, this will fall
+            # through to the default implementation
+            pass
+    return plat
+
+
+macosVersionString = re.compile(r"macosx-(\d+)\.(\d+)-(.*)")
+darwinVersionString = re.compile(r"darwin-(\d+)\.(\d+)\.(\d+)-(.*)")
+# XXX backward compat
+get_platform = get_build_platform
+
+
+def compatible_platforms(provided: str | None, required: str | None):
+    """Can code for the `provided` platform run on the `required` platform?
+
+    Returns true if either platform is ``None``, or the platforms are equal.
+
+    XXX Needs compatibility checks for Linux and other unixy OSes.
+    """
+    if provided is None or required is None or provided == required:
+        # easy case
+        return True
+
+    # macOS special cases
+    reqMac = macosVersionString.match(required)
+    if reqMac:
+        provMac = macosVersionString.match(provided)
+
+        # is this a Mac package?
+        if not provMac:
+            # this is backwards compatibility for packages built before
+            # setuptools 0.6. All packages built after this point will
+            # use the new macOS designation.
+            provDarwin = darwinVersionString.match(provided)
+            if provDarwin:
+                dversion = int(provDarwin.group(1))
+                macosversion = "%s.%s" % (reqMac.group(1), reqMac.group(2))
+                if (
+                    dversion == 7
+                    and macosversion >= "10.3"
+                    or dversion == 8
+                    and macosversion >= "10.4"
+                ):
+                    return True
+            # egg isn't macOS or legacy darwin
+            return False
+
+        # are they the same major version and machine type?
+        if provMac.group(1) != reqMac.group(1) or provMac.group(3) != reqMac.group(3):
+            return False
+
+        # is the required OS major update >= the provided one?
+        if int(provMac.group(2)) > int(reqMac.group(2)):
+            return False
+
+        return True
+
+    # XXX Linux and other platforms' special cases should go here
+    return False
+
+
+@overload
+def get_distribution(dist: _DistributionT) -> _DistributionT: ...
+@overload
+def get_distribution(dist: _PkgReqType) -> Distribution: ...
+def get_distribution(dist: Distribution | _PkgReqType) -> Distribution:
+    """Return a current distribution object for a Requirement or string"""
+    if isinstance(dist, str):
+        dist = Requirement.parse(dist)
+    if isinstance(dist, Requirement):
+        # Bad type narrowing, dist has to be a Requirement here, so get_provider has to return Distribution
+        dist = get_provider(dist)  # type: ignore[assignment]
+    if not isinstance(dist, Distribution):
+        raise TypeError("Expected str, Requirement, or Distribution", dist)
+    return dist
+
+
+def load_entry_point(dist: _EPDistType, group: str, name: str) -> _ResolvedEntryPoint:
+    """Return `name` entry point of `group` for `dist` or raise ImportError"""
+    return get_distribution(dist).load_entry_point(group, name)
+
+
+@overload
+def get_entry_map(
+    dist: _EPDistType, group: None = None
+) -> dict[str, dict[str, EntryPoint]]: ...
+@overload
+def get_entry_map(dist: _EPDistType, group: str) -> dict[str, EntryPoint]: ...
+def get_entry_map(dist: _EPDistType, group: str | None = None):
+    """Return the entry point map for `group`, or the full entry map"""
+    return get_distribution(dist).get_entry_map(group)
+
+
+def get_entry_info(dist: _EPDistType, group: str, name: str):
+    """Return the EntryPoint object for `group`+`name`, or ``None``"""
+    return get_distribution(dist).get_entry_info(group, name)
+
+
+class IMetadataProvider(Protocol):
+    def has_metadata(self, name: str) -> bool:
+        """Does the package's distribution contain the named metadata?"""
+
+    def get_metadata(self, name: str) -> str:
+        """The named metadata resource as a string"""
+
+    def get_metadata_lines(self, name: str) -> Iterator[str]:
+        """Yield named metadata resource as list of non-blank non-comment lines
+
+        Leading and trailing whitespace is stripped from each line, and lines
+        with ``#`` as the first non-blank character are omitted."""
+
+    def metadata_isdir(self, name: str) -> bool:
+        """Is the named metadata a directory?  (like ``os.path.isdir()``)"""
+
+    def metadata_listdir(self, name: str) -> list[str]:
+        """List of metadata names in the directory (like ``os.listdir()``)"""
+
+    def run_script(self, script_name: str, namespace: dict[str, Any]) -> None:
+        """Execute the named script in the supplied namespace dictionary"""
+
+
+class IResourceProvider(IMetadataProvider, Protocol):
+    """An object that provides access to package resources"""
+
+    def get_resource_filename(
+        self, manager: ResourceManager, resource_name: str
+    ) -> str:
+        """Return a true filesystem path for `resource_name`
+
+        `manager` must be a ``ResourceManager``"""
+
+    def get_resource_stream(
+        self, manager: ResourceManager, resource_name: str
+    ) -> _ResourceStream:
+        """Return a readable file-like object for `resource_name`
+
+        `manager` must be a ``ResourceManager``"""
+
+    def get_resource_string(
+        self, manager: ResourceManager, resource_name: str
+    ) -> bytes:
+        """Return the contents of `resource_name` as :obj:`bytes`
+
+        `manager` must be a ``ResourceManager``"""
+
+    def has_resource(self, resource_name: str) -> bool:
+        """Does the package contain the named resource?"""
+
+    def resource_isdir(self, resource_name: str) -> bool:
+        """Is the named resource a directory?  (like ``os.path.isdir()``)"""
+
+    def resource_listdir(self, resource_name: str) -> list[str]:
+        """List of resource names in the directory (like ``os.listdir()``)"""
+
+
+class WorkingSet:
+    """A collection of active distributions on sys.path (or a similar list)"""
+
+    def __init__(self, entries: Iterable[str] | None = None):
+        """Create working set from list of path entries (default=sys.path)"""
+        self.entries: list[str] = []
+        self.entry_keys = {}
+        self.by_key = {}
+        self.normalized_to_canonical_keys = {}
+        self.callbacks = []
+
+        if entries is None:
+            entries = sys.path
+
+        for entry in entries:
+            self.add_entry(entry)
+
+    @classmethod
+    def _build_master(cls):
+        """
+        Prepare the master working set.
+        """
+        ws = cls()
+        try:
+            from __main__ import __requires__
+        except ImportError:
+            # The main program does not list any requirements
+            return ws
+
+        # ensure the requirements are met
+        try:
+            ws.require(__requires__)
+        except VersionConflict:
+            return cls._build_from_requirements(__requires__)
+
+        return ws
+
+    @classmethod
+    def _build_from_requirements(cls, req_spec):
+        """
+        Build a working set from a requirement spec. Rewrites sys.path.
+        """
+        # try it without defaults already on sys.path
+        # by starting with an empty path
+        ws = cls([])
+        reqs = parse_requirements(req_spec)
+        dists = ws.resolve(reqs, Environment())
+        for dist in dists:
+            ws.add(dist)
+
+        # add any missing entries from sys.path
+        for entry in sys.path:
+            if entry not in ws.entries:
+                ws.add_entry(entry)
+
+        # then copy back to sys.path
+        sys.path[:] = ws.entries
+        return ws
+
+    def add_entry(self, entry: str):
+        """Add a path item to ``.entries``, finding any distributions on it
+
+        ``find_distributions(entry, True)`` is used to find distributions
+        corresponding to the path entry, and they are added.  `entry` is
+        always appended to ``.entries``, even if it is already present.
+        (This is because ``sys.path`` can contain the same value more than
+        once, and the ``.entries`` of the ``sys.path`` WorkingSet should always
+        equal ``sys.path``.)
+        """
+        self.entry_keys.setdefault(entry, [])
+        self.entries.append(entry)
+        for dist in find_distributions(entry, True):
+            self.add(dist, entry, False)
+
+    def __contains__(self, dist: Distribution) -> bool:
+        """True if `dist` is the active distribution for its project"""
+        return self.by_key.get(dist.key) == dist
+
+    def find(self, req: Requirement) -> Distribution | None:
+        """Find a distribution matching requirement `req`
+
+        If there is an active distribution for the requested project, this
+        returns it as long as it meets the version requirement specified by
+        `req`.  But, if there is an active distribution for the project and it
+        does *not* meet the `req` requirement, ``VersionConflict`` is raised.
+        If there is no active distribution for the requested project, ``None``
+        is returned.
+        """
+        dist = self.by_key.get(req.key)
+
+        if dist is None:
+            canonical_key = self.normalized_to_canonical_keys.get(req.key)
+
+            if canonical_key is not None:
+                req.key = canonical_key
+                dist = self.by_key.get(canonical_key)
+
+        if dist is not None and dist not in req:
+            # XXX add more info
+            raise VersionConflict(dist, req)
+        return dist
+
+    def iter_entry_points(self, group: str, name: str | None = None):
+        """Yield entry point objects from `group` matching `name`
+
+        If `name` is None, yields all entry points in `group` from all
+        distributions in the working set, otherwise only ones matching
+        both `group` and `name` are yielded (in distribution order).
+        """
+        return (
+            entry
+            for dist in self
+            for entry in dist.get_entry_map(group).values()
+            if name is None or name == entry.name
+        )
+
+    def run_script(self, requires: str, script_name: str):
+        """Locate distribution for `requires` and run `script_name` script"""
+        ns = sys._getframe(1).f_globals
+        name = ns['__name__']
+        ns.clear()
+        ns['__name__'] = name
+        self.require(requires)[0].run_script(script_name, ns)
+
+    def __iter__(self) -> Iterator[Distribution]:
+        """Yield distributions for non-duplicate projects in the working set
+
+        The yield order is the order in which the items' path entries were
+        added to the working set.
+        """
+        seen = set()
+        for item in self.entries:
+            if item not in self.entry_keys:
+                # workaround a cache issue
+                continue
+
+            for key in self.entry_keys[item]:
+                if key not in seen:
+                    seen.add(key)
+                    yield self.by_key[key]
+
+    def add(
+        self,
+        dist: Distribution,
+        entry: str | None = None,
+        insert: bool = True,
+        replace: bool = False,
+    ):
+        """Add `dist` to working set, associated with `entry`
+
+        If `entry` is unspecified, it defaults to the ``.location`` of `dist`.
+        On exit from this routine, `entry` is added to the end of the working
+        set's ``.entries`` (if it wasn't already present).
+
+        `dist` is only added to the working set if it's for a project that
+        doesn't already have a distribution in the set, unless `replace=True`.
+        If it's added, any callbacks registered with the ``subscribe()`` method
+        will be called.
+        """
+        if insert:
+            dist.insert_on(self.entries, entry, replace=replace)
+
+        if entry is None:
+            entry = dist.location
+        keys = self.entry_keys.setdefault(entry, [])
+        keys2 = self.entry_keys.setdefault(dist.location, [])
+        if not replace and dist.key in self.by_key:
+            # ignore hidden distros
+            return
+
+        self.by_key[dist.key] = dist
+        normalized_name = _packaging_utils.canonicalize_name(dist.key)
+        self.normalized_to_canonical_keys[normalized_name] = dist.key
+        if dist.key not in keys:
+            keys.append(dist.key)
+        if dist.key not in keys2:
+            keys2.append(dist.key)
+        self._added_new(dist)
+
+    @overload
+    def resolve(
+        self,
+        requirements: Iterable[Requirement],
+        env: Environment | None,
+        installer: _InstallerTypeT[_DistributionT],
+        replace_conflicting: bool = False,
+        extras: tuple[str, ...] | None = None,
+    ) -> list[_DistributionT]: ...
+    @overload
+    def resolve(
+        self,
+        requirements: Iterable[Requirement],
+        env: Environment | None = None,
+        *,
+        installer: _InstallerTypeT[_DistributionT],
+        replace_conflicting: bool = False,
+        extras: tuple[str, ...] | None = None,
+    ) -> list[_DistributionT]: ...
+    @overload
+    def resolve(
+        self,
+        requirements: Iterable[Requirement],
+        env: Environment | None = None,
+        installer: _InstallerType | None = None,
+        replace_conflicting: bool = False,
+        extras: tuple[str, ...] | None = None,
+    ) -> list[Distribution]: ...
+    def resolve(
+        self,
+        requirements: Iterable[Requirement],
+        env: Environment | None = None,
+        installer: _InstallerType | None | _InstallerTypeT[_DistributionT] = None,
+        replace_conflicting: bool = False,
+        extras: tuple[str, ...] | None = None,
+    ) -> list[Distribution] | list[_DistributionT]:
+        """List all distributions needed to (recursively) meet `requirements`
+
+        `requirements` must be a sequence of ``Requirement`` objects.  `env`,
+        if supplied, should be an ``Environment`` instance.  If
+        not supplied, it defaults to all distributions available within any
+        entry or distribution in the working set.  `installer`, if supplied,
+        will be invoked with each requirement that cannot be met by an
+        already-installed distribution; it should return a ``Distribution`` or
+        ``None``.
+
+        Unless `replace_conflicting=True`, raises a VersionConflict exception
+        if
+        any requirements are found on the path that have the correct name but
+        the wrong version.  Otherwise, if an `installer` is supplied it will be
+        invoked to obtain the correct version of the requirement and activate
+        it.
+
+        `extras` is a list of the extras to be used with these requirements.
+        This is important because extra requirements may look like `my_req;
+        extra = "my_extra"`, which would otherwise be interpreted as a purely
+        optional requirement.  Instead, we want to be able to assert that these
+        requirements are truly required.
+        """
+
+        # set up the stack
+        requirements = list(requirements)[::-1]
+        # set of processed requirements
+        processed = set()
+        # key -> dist
+        best = {}
+        to_activate = []
+
+        req_extras = _ReqExtras()
+
+        # Mapping of requirement to set of distributions that required it;
+        # useful for reporting info about conflicts.
+        required_by = collections.defaultdict(set)
+
+        while requirements:
+            # process dependencies breadth-first
+            req = requirements.pop(0)
+            if req in processed:
+                # Ignore cyclic or redundant dependencies
+                continue
+
+            if not req_extras.markers_pass(req, extras):
+                continue
+
+            dist = self._resolve_dist(
+                req, best, replace_conflicting, env, installer, required_by, to_activate
+            )
+
+            # push the new requirements onto the stack
+            new_requirements = dist.requires(req.extras)[::-1]
+            requirements.extend(new_requirements)
+
+            # Register the new requirements needed by req
+            for new_requirement in new_requirements:
+                required_by[new_requirement].add(req.project_name)
+                req_extras[new_requirement] = req.extras
+
+            processed.add(req)
+
+        # return list of distros to activate
+        return to_activate
+
+    def _resolve_dist(
+        self, req, best, replace_conflicting, env, installer, required_by, to_activate
+    ) -> Distribution:
+        dist = best.get(req.key)
+        if dist is None:
+            # Find the best distribution and add it to the map
+            dist = self.by_key.get(req.key)
+            if dist is None or (dist not in req and replace_conflicting):
+                ws = self
+                if env is None:
+                    if dist is None:
+                        env = Environment(self.entries)
+                    else:
+                        # Use an empty environment and workingset to avoid
+                        # any further conflicts with the conflicting
+                        # distribution
+                        env = Environment([])
+                        ws = WorkingSet([])
+                dist = best[req.key] = env.best_match(
+                    req, ws, installer, replace_conflicting=replace_conflicting
+                )
+                if dist is None:
+                    requirers = required_by.get(req, None)
+                    raise DistributionNotFound(req, requirers)
+            to_activate.append(dist)
+        if dist not in req:
+            # Oops, the "best" so far conflicts with a dependency
+            dependent_req = required_by[req]
+            raise VersionConflict(dist, req).with_context(dependent_req)
+        return dist
+
+    @overload
+    def find_plugins(
+        self,
+        plugin_env: Environment,
+        full_env: Environment | None,
+        installer: _InstallerTypeT[_DistributionT],
+        fallback: bool = True,
+    ) -> tuple[list[_DistributionT], dict[Distribution, Exception]]: ...
+    @overload
+    def find_plugins(
+        self,
+        plugin_env: Environment,
+        full_env: Environment | None = None,
+        *,
+        installer: _InstallerTypeT[_DistributionT],
+        fallback: bool = True,
+    ) -> tuple[list[_DistributionT], dict[Distribution, Exception]]: ...
+    @overload
+    def find_plugins(
+        self,
+        plugin_env: Environment,
+        full_env: Environment | None = None,
+        installer: _InstallerType | None = None,
+        fallback: bool = True,
+    ) -> tuple[list[Distribution], dict[Distribution, Exception]]: ...
+    def find_plugins(
+        self,
+        plugin_env: Environment,
+        full_env: Environment | None = None,
+        installer: _InstallerType | None | _InstallerTypeT[_DistributionT] = None,
+        fallback: bool = True,
+    ) -> tuple[
+        list[Distribution] | list[_DistributionT],
+        dict[Distribution, Exception],
+    ]:
+        """Find all activatable distributions in `plugin_env`
+
+        Example usage::
+
+            distributions, errors = working_set.find_plugins(
+                Environment(plugin_dirlist)
+            )
+            # add plugins+libs to sys.path
+            map(working_set.add, distributions)
+            # display errors
+            print('Could not load', errors)
+
+        The `plugin_env` should be an ``Environment`` instance that contains
+        only distributions that are in the project's "plugin directory" or
+        directories. The `full_env`, if supplied, should be an ``Environment``
+        contains all currently-available distributions.  If `full_env` is not
+        supplied, one is created automatically from the ``WorkingSet`` this
+        method is called on, which will typically mean that every directory on
+        ``sys.path`` will be scanned for distributions.
+
+        `installer` is a standard installer callback as used by the
+        ``resolve()`` method. The `fallback` flag indicates whether we should
+        attempt to resolve older versions of a plugin if the newest version
+        cannot be resolved.
+
+        This method returns a 2-tuple: (`distributions`, `error_info`), where
+        `distributions` is a list of the distributions found in `plugin_env`
+        that were loadable, along with any other distributions that are needed
+        to resolve their dependencies.  `error_info` is a dictionary mapping
+        unloadable plugin distributions to an exception instance describing the
+        error that occurred. Usually this will be a ``DistributionNotFound`` or
+        ``VersionConflict`` instance.
+        """
+
+        plugin_projects = list(plugin_env)
+        # scan project names in alphabetic order
+        plugin_projects.sort()
+
+        error_info: dict[Distribution, Exception] = {}
+        distributions: dict[Distribution, Exception | None] = {}
+
+        if full_env is None:
+            env = Environment(self.entries)
+            env += plugin_env
+        else:
+            env = full_env + plugin_env
+
+        shadow_set = self.__class__([])
+        # put all our entries in shadow_set
+        list(map(shadow_set.add, self))
+
+        for project_name in plugin_projects:
+            for dist in plugin_env[project_name]:
+                req = [dist.as_requirement()]
+
+                try:
+                    resolvees = shadow_set.resolve(req, env, installer)
+
+                except ResolutionError as v:
+                    # save error info
+                    error_info[dist] = v
+                    if fallback:
+                        # try the next older version of project
+                        continue
+                    else:
+                        # give up on this project, keep going
+                        break
+
+                else:
+                    list(map(shadow_set.add, resolvees))
+                    distributions.update(dict.fromkeys(resolvees))
+
+                    # success, no need to try any more versions of this project
+                    break
+
+        sorted_distributions = list(distributions)
+        sorted_distributions.sort()
+
+        return sorted_distributions, error_info
+
+    def require(self, *requirements: _NestedStr):
+        """Ensure that distributions matching `requirements` are activated
+
+        `requirements` must be a string or a (possibly-nested) sequence
+        thereof, specifying the distributions and versions required.  The
+        return value is a sequence of the distributions that needed to be
+        activated to fulfill the requirements; all relevant distributions are
+        included, even if they were already activated in this working set.
+        """
+        needed = self.resolve(parse_requirements(requirements))
+
+        for dist in needed:
+            self.add(dist)
+
+        return needed
+
+    def subscribe(
+        self, callback: Callable[[Distribution], object], existing: bool = True
+    ):
+        """Invoke `callback` for all distributions
+
+        If `existing=True` (default),
+        call on all existing ones, as well.
+        """
+        if callback in self.callbacks:
+            return
+        self.callbacks.append(callback)
+        if not existing:
+            return
+        for dist in self:
+            callback(dist)
+
+    def _added_new(self, dist):
+        for callback in self.callbacks:
+            callback(dist)
+
+    def __getstate__(self):
+        return (
+            self.entries[:],
+            self.entry_keys.copy(),
+            self.by_key.copy(),
+            self.normalized_to_canonical_keys.copy(),
+            self.callbacks[:],
+        )
+
+    def __setstate__(self, e_k_b_n_c):
+        entries, keys, by_key, normalized_to_canonical_keys, callbacks = e_k_b_n_c
+        self.entries = entries[:]
+        self.entry_keys = keys.copy()
+        self.by_key = by_key.copy()
+        self.normalized_to_canonical_keys = normalized_to_canonical_keys.copy()
+        self.callbacks = callbacks[:]
+
+
+class _ReqExtras(Dict["Requirement", Tuple[str, ...]]):
+    """
+    Map each requirement to the extras that demanded it.
+    """
+
+    def markers_pass(self, req: Requirement, extras: tuple[str, ...] | None = None):
+        """
+        Evaluate markers for req against each extra that
+        demanded it.
+
+        Return False if the req has a marker and fails
+        evaluation. Otherwise, return True.
+        """
+        extra_evals = (
+            req.marker.evaluate({'extra': extra})
+            for extra in self.get(req, ()) + (extras or (None,))
+        )
+        return not req.marker or any(extra_evals)
+
+
+class Environment:
+    """Searchable snapshot of distributions on a search path"""
+
+    def __init__(
+        self,
+        search_path: Iterable[str] | None = None,
+        platform: str | None = get_supported_platform(),
+        python: str | None = PY_MAJOR,
+    ):
+        """Snapshot distributions available on a search path
+
+        Any distributions found on `search_path` are added to the environment.
+        `search_path` should be a sequence of ``sys.path`` items.  If not
+        supplied, ``sys.path`` is used.
+
+        `platform` is an optional string specifying the name of the platform
+        that platform-specific distributions must be compatible with.  If
+        unspecified, it defaults to the current platform.  `python` is an
+        optional string naming the desired version of Python (e.g. ``'3.6'``);
+        it defaults to the current version.
+
+        You may explicitly set `platform` (and/or `python`) to ``None`` if you
+        wish to map *all* distributions, not just those compatible with the
+        running platform or Python version.
+        """
+        self._distmap = {}
+        self.platform = platform
+        self.python = python
+        self.scan(search_path)
+
+    def can_add(self, dist: Distribution):
+        """Is distribution `dist` acceptable for this environment?
+
+        The distribution must match the platform and python version
+        requirements specified when this environment was created, or False
+        is returned.
+        """
+        py_compat = (
+            self.python is None
+            or dist.py_version is None
+            or dist.py_version == self.python
+        )
+        return py_compat and compatible_platforms(dist.platform, self.platform)
+
+    def remove(self, dist: Distribution):
+        """Remove `dist` from the environment"""
+        self._distmap[dist.key].remove(dist)
+
+    def scan(self, search_path: Iterable[str] | None = None):
+        """Scan `search_path` for distributions usable in this environment
+
+        Any distributions found are added to the environment.
+        `search_path` should be a sequence of ``sys.path`` items.  If not
+        supplied, ``sys.path`` is used.  Only distributions conforming to
+        the platform/python version defined at initialization are added.
+        """
+        if search_path is None:
+            search_path = sys.path
+
+        for item in search_path:
+            for dist in find_distributions(item):
+                self.add(dist)
+
+    def __getitem__(self, project_name: str) -> list[Distribution]:
+        """Return a newest-to-oldest list of distributions for `project_name`
+
+        Uses case-insensitive `project_name` comparison, assuming all the
+        project's distributions use their project's name converted to all
+        lowercase as their key.
+
+        """
+        distribution_key = project_name.lower()
+        return self._distmap.get(distribution_key, [])
+
+    def add(self, dist: Distribution):
+        """Add `dist` if we ``can_add()`` it and it has not already been added"""
+        if self.can_add(dist) and dist.has_version():
+            dists = self._distmap.setdefault(dist.key, [])
+            if dist not in dists:
+                dists.append(dist)
+                dists.sort(key=operator.attrgetter('hashcmp'), reverse=True)
+
+    @overload
+    def best_match(
+        self,
+        req: Requirement,
+        working_set: WorkingSet,
+        installer: _InstallerTypeT[_DistributionT],
+        replace_conflicting: bool = False,
+    ) -> _DistributionT: ...
+    @overload
+    def best_match(
+        self,
+        req: Requirement,
+        working_set: WorkingSet,
+        installer: _InstallerType | None = None,
+        replace_conflicting: bool = False,
+    ) -> Distribution | None: ...
+    def best_match(
+        self,
+        req: Requirement,
+        working_set: WorkingSet,
+        installer: _InstallerType | None | _InstallerTypeT[_DistributionT] = None,
+        replace_conflicting: bool = False,
+    ) -> Distribution | None:
+        """Find distribution best matching `req` and usable on `working_set`
+
+        This calls the ``find(req)`` method of the `working_set` to see if a
+        suitable distribution is already active.  (This may raise
+        ``VersionConflict`` if an unsuitable version of the project is already
+        active in the specified `working_set`.)  If a suitable distribution
+        isn't active, this method returns the newest distribution in the
+        environment that meets the ``Requirement`` in `req`.  If no suitable
+        distribution is found, and `installer` is supplied, then the result of
+        calling the environment's ``obtain(req, installer)`` method will be
+        returned.
+        """
+        try:
+            dist = working_set.find(req)
+        except VersionConflict:
+            if not replace_conflicting:
+                raise
+            dist = None
+        if dist is not None:
+            return dist
+        for dist in self[req.key]:
+            if dist in req:
+                return dist
+        # try to download/install
+        return self.obtain(req, installer)
+
+    @overload
+    def obtain(
+        self,
+        requirement: Requirement,
+        installer: _InstallerTypeT[_DistributionT],
+    ) -> _DistributionT: ...
+    @overload
+    def obtain(
+        self,
+        requirement: Requirement,
+        installer: Callable[[Requirement], None] | None = None,
+    ) -> None: ...
+    @overload
+    def obtain(
+        self,
+        requirement: Requirement,
+        installer: _InstallerType | None = None,
+    ) -> Distribution | None: ...
+    def obtain(
+        self,
+        requirement: Requirement,
+        installer: Callable[[Requirement], None]
+        | _InstallerType
+        | None
+        | _InstallerTypeT[_DistributionT] = None,
+    ) -> Distribution | None:
+        """Obtain a distribution matching `requirement` (e.g. via download)
+
+        Obtain a distro that matches requirement (e.g. via download).  In the
+        base ``Environment`` class, this routine just returns
+        ``installer(requirement)``, unless `installer` is None, in which case
+        None is returned instead.  This method is a hook that allows subclasses
+        to attempt other ways of obtaining a distribution before falling back
+        to the `installer` argument."""
+        return installer(requirement) if installer else None
+
+    def __iter__(self) -> Iterator[str]:
+        """Yield the unique project names of the available distributions"""
+        for key in self._distmap.keys():
+            if self[key]:
+                yield key
+
+    def __iadd__(self, other: Distribution | Environment):
+        """In-place addition of a distribution or environment"""
+        if isinstance(other, Distribution):
+            self.add(other)
+        elif isinstance(other, Environment):
+            for project in other:
+                for dist in other[project]:
+                    self.add(dist)
+        else:
+            raise TypeError("Can't add %r to environment" % (other,))
+        return self
+
+    def __add__(self, other: Distribution | Environment):
+        """Add an environment or distribution to an environment"""
+        new = self.__class__([], platform=None, python=None)
+        for env in self, other:
+            new += env
+        return new
+
+
+# XXX backward compatibility
+AvailableDistributions = Environment
+
+
+class ExtractionError(RuntimeError):
+    """An error occurred extracting a resource
+
+    The following attributes are available from instances of this exception:
+
+    manager
+        The resource manager that raised this exception
+
+    cache_path
+        The base directory for resource extraction
+
+    original_error
+        The exception instance that caused extraction to fail
+    """
+
+    manager: ResourceManager
+    cache_path: str
+    original_error: BaseException | None
+
+
+class ResourceManager:
+    """Manage resource extraction and packages"""
+
+    extraction_path: str | None = None
+
+    def __init__(self):
+        self.cached_files = {}
+
+    def resource_exists(self, package_or_requirement: _PkgReqType, resource_name: str):
+        """Does the named resource exist?"""
+        return get_provider(package_or_requirement).has_resource(resource_name)
+
+    def resource_isdir(self, package_or_requirement: _PkgReqType, resource_name: str):
+        """Is the named resource an existing directory?"""
+        return get_provider(package_or_requirement).resource_isdir(resource_name)
+
+    def resource_filename(
+        self, package_or_requirement: _PkgReqType, resource_name: str
+    ):
+        """Return a true filesystem path for specified resource"""
+        return get_provider(package_or_requirement).get_resource_filename(
+            self, resource_name
+        )
+
+    def resource_stream(self, package_or_requirement: _PkgReqType, resource_name: str):
+        """Return a readable file-like object for specified resource"""
+        return get_provider(package_or_requirement).get_resource_stream(
+            self, resource_name
+        )
+
+    def resource_string(
+        self, package_or_requirement: _PkgReqType, resource_name: str
+    ) -> bytes:
+        """Return specified resource as :obj:`bytes`"""
+        return get_provider(package_or_requirement).get_resource_string(
+            self, resource_name
+        )
+
+    def resource_listdir(self, package_or_requirement: _PkgReqType, resource_name: str):
+        """List the contents of the named resource directory"""
+        return get_provider(package_or_requirement).resource_listdir(resource_name)
+
+    def extraction_error(self) -> NoReturn:
+        """Give an error message for problems extracting file(s)"""
+
+        old_exc = sys.exc_info()[1]
+        cache_path = self.extraction_path or get_default_cache()
+
+        tmpl = textwrap.dedent(
+            """
+            Can't extract file(s) to egg cache
+
+            The following error occurred while trying to extract file(s)
+            to the Python egg cache:
+
+              {old_exc}
+
+            The Python egg cache directory is currently set to:
+
+              {cache_path}
+
+            Perhaps your account does not have write access to this directory?
+            You can change the cache directory by setting the PYTHON_EGG_CACHE
+            environment variable to point to an accessible directory.
+            """
+        ).lstrip()
+        err = ExtractionError(tmpl.format(**locals()))
+        err.manager = self
+        err.cache_path = cache_path
+        err.original_error = old_exc
+        raise err
+
+    def get_cache_path(self, archive_name: str, names: Iterable[StrPath] = ()):
+        """Return absolute location in cache for `archive_name` and `names`
+
+        The parent directory of the resulting path will be created if it does
+        not already exist.  `archive_name` should be the base filename of the
+        enclosing egg (which may not be the name of the enclosing zipfile!),
+        including its ".egg" extension.  `names`, if provided, should be a
+        sequence of path name parts "under" the egg's extraction location.
+
+        This method should only be called by resource providers that need to
+        obtain an extraction location, and only for names they intend to
+        extract, as it tracks the generated names for possible cleanup later.
+        """
+        extract_path = self.extraction_path or get_default_cache()
+        target_path = os.path.join(extract_path, archive_name + '-tmp', *names)
+        try:
+            _bypass_ensure_directory(target_path)
+        except Exception:
+            self.extraction_error()
+
+        self._warn_unsafe_extraction_path(extract_path)
+
+        self.cached_files[target_path] = True
+        return target_path
+
+    @staticmethod
+    def _warn_unsafe_extraction_path(path):
+        """
+        If the default extraction path is overridden and set to an insecure
+        location, such as /tmp, it opens up an opportunity for an attacker to
+        replace an extracted file with an unauthorized payload. Warn the user
+        if a known insecure location is used.
+
+        See Distribute #375 for more details.
+        """
+        if os.name == 'nt' and not path.startswith(os.environ['windir']):
+            # On Windows, permissions are generally restrictive by default
+            #  and temp directories are not writable by other users, so
+            #  bypass the warning.
+            return
+        mode = os.stat(path).st_mode
+        if mode & stat.S_IWOTH or mode & stat.S_IWGRP:
+            msg = (
+                "Extraction path is writable by group/others "
+                "and vulnerable to attack when "
+                "used with get_resource_filename ({path}). "
+                "Consider a more secure "
+                "location (set with .set_extraction_path or the "
+                "PYTHON_EGG_CACHE environment variable)."
+            ).format(**locals())
+            warnings.warn(msg, UserWarning)
+
+    def postprocess(self, tempname: StrOrBytesPath, filename: StrOrBytesPath):
+        """Perform any platform-specific postprocessing of `tempname`
+
+        This is where Mac header rewrites should be done; other platforms don't
+        have anything special they should do.
+
+        Resource providers should call this method ONLY after successfully
+        extracting a compressed resource.  They must NOT call it on resources
+        that are already in the filesystem.
+
+        `tempname` is the current (temporary) name of the file, and `filename`
+        is the name it will be renamed to by the caller after this routine
+        returns.
+        """
+
+        if os.name == 'posix':
+            # Make the resource executable
+            mode = ((os.stat(tempname).st_mode) | 0o555) & 0o7777
+            os.chmod(tempname, mode)
+
+    def set_extraction_path(self, path: str):
+        """Set the base path where resources will be extracted to, if needed.
+
+        If you do not call this routine before any extractions take place, the
+        path defaults to the return value of ``get_default_cache()``.  (Which
+        is based on the ``PYTHON_EGG_CACHE`` environment variable, with various
+        platform-specific fallbacks.  See that routine's documentation for more
+        details.)
+
+        Resources are extracted to subdirectories of this path based upon
+        information given by the ``IResourceProvider``.  You may set this to a
+        temporary directory, but then you must call ``cleanup_resources()`` to
+        delete the extracted files when done.  There is no guarantee that
+        ``cleanup_resources()`` will be able to remove all extracted files.
+
+        (Note: you may not change the extraction path for a given resource
+        manager once resources have been extracted, unless you first call
+        ``cleanup_resources()``.)
+        """
+        if self.cached_files:
+            raise ValueError("Can't change extraction path, files already extracted")
+
+        self.extraction_path = path
+
+    def cleanup_resources(self, force: bool = False) -> list[str]:
+        """
+        Delete all extracted resource files and directories, returning a list
+        of the file and directory names that could not be successfully removed.
+        This function does not have any concurrency protection, so it should
+        generally only be called when the extraction path is a temporary
+        directory exclusive to a single process.  This method is not
+        automatically called; you must call it explicitly or register it as an
+        ``atexit`` function if you wish to ensure cleanup of a temporary
+        directory used for extractions.
+        """
+        # XXX
+        return []
+
+
+def get_default_cache() -> str:
+    """
+    Return the ``PYTHON_EGG_CACHE`` environment variable
+    or a platform-relevant user cache dir for an app
+    named "Python-Eggs".
+    """
+    return os.environ.get('PYTHON_EGG_CACHE') or _user_cache_dir(appname='Python-Eggs')
+
+
+def safe_name(name: str):
+    """Convert an arbitrary string to a standard distribution name
+
+    Any runs of non-alphanumeric/. characters are replaced with a single '-'.
+    """
+    return re.sub('[^A-Za-z0-9.]+', '-', name)
+
+
+def safe_version(version: str):
+    """
+    Convert an arbitrary string to a standard version string
+    """
+    try:
+        # normalize the version
+        return str(_packaging_version.Version(version))
+    except _packaging_version.InvalidVersion:
+        version = version.replace(' ', '.')
+        return re.sub('[^A-Za-z0-9.]+', '-', version)
+
+
+def _forgiving_version(version):
+    """Fallback when ``safe_version`` is not safe enough
+    >>> parse_version(_forgiving_version('0.23ubuntu1'))
+    
+    >>> parse_version(_forgiving_version('0.23-'))
+    
+    >>> parse_version(_forgiving_version('0.-_'))
+    
+    >>> parse_version(_forgiving_version('42.+?1'))
+    
+    >>> parse_version(_forgiving_version('hello world'))
+    
+    """
+    version = version.replace(' ', '.')
+    match = _PEP440_FALLBACK.search(version)
+    if match:
+        safe = match["safe"]
+        rest = version[len(safe) :]
+    else:
+        safe = "0"
+        rest = version
+    local = f"sanitized.{_safe_segment(rest)}".strip(".")
+    return f"{safe}.dev0+{local}"
+
+
+def _safe_segment(segment):
+    """Convert an arbitrary string into a safe segment"""
+    segment = re.sub('[^A-Za-z0-9.]+', '-', segment)
+    segment = re.sub('-[^A-Za-z0-9]+', '-', segment)
+    return re.sub(r'\.[^A-Za-z0-9]+', '.', segment).strip(".-")
+
+
+def safe_extra(extra: str):
+    """Convert an arbitrary string to a standard 'extra' name
+
+    Any runs of non-alphanumeric characters are replaced with a single '_',
+    and the result is always lowercased.
+    """
+    return re.sub('[^A-Za-z0-9.-]+', '_', extra).lower()
+
+
+def to_filename(name: str):
+    """Convert a project or version name to its filename-escaped form
+
+    Any '-' characters are currently replaced with '_'.
+    """
+    return name.replace('-', '_')
+
+
+def invalid_marker(text: str):
+    """
+    Validate text as a PEP 508 environment marker; return an exception
+    if invalid or False otherwise.
+    """
+    try:
+        evaluate_marker(text)
+    except SyntaxError as e:
+        e.filename = None
+        e.lineno = None
+        return e
+    return False
+
+
+def evaluate_marker(text: str, extra: str | None = None) -> bool:
+    """
+    Evaluate a PEP 508 environment marker.
+    Return a boolean indicating the marker result in this environment.
+    Raise SyntaxError if marker is invalid.
+
+    This implementation uses the 'pyparsing' module.
+    """
+    try:
+        marker = _packaging_markers.Marker(text)
+        return marker.evaluate()
+    except _packaging_markers.InvalidMarker as e:
+        raise SyntaxError(e) from e
+
+
+class NullProvider:
+    """Try to implement resources and metadata for arbitrary PEP 302 loaders"""
+
+    egg_name: str | None = None
+    egg_info: str | None = None
+    loader: _LoaderProtocol | None = None
+
+    def __init__(self, module: _ModuleLike):
+        self.loader = getattr(module, '__loader__', None)
+        self.module_path = os.path.dirname(getattr(module, '__file__', ''))
+
+    def get_resource_filename(self, manager: ResourceManager, resource_name: str):
+        return self._fn(self.module_path, resource_name)
+
+    def get_resource_stream(self, manager: ResourceManager, resource_name: str):
+        return io.BytesIO(self.get_resource_string(manager, resource_name))
+
+    def get_resource_string(
+        self, manager: ResourceManager, resource_name: str
+    ) -> bytes:
+        return self._get(self._fn(self.module_path, resource_name))
+
+    def has_resource(self, resource_name: str):
+        return self._has(self._fn(self.module_path, resource_name))
+
+    def _get_metadata_path(self, name):
+        return self._fn(self.egg_info, name)
+
+    def has_metadata(self, name: str) -> bool:
+        if not self.egg_info:
+            return False
+
+        path = self._get_metadata_path(name)
+        return self._has(path)
+
+    def get_metadata(self, name: str):
+        if not self.egg_info:
+            return ""
+        path = self._get_metadata_path(name)
+        value = self._get(path)
+        try:
+            return value.decode('utf-8')
+        except UnicodeDecodeError as exc:
+            # Include the path in the error message to simplify
+            # troubleshooting, and without changing the exception type.
+            exc.reason += ' in {} file at path: {}'.format(name, path)
+            raise
+
+    def get_metadata_lines(self, name: str) -> Iterator[str]:
+        return yield_lines(self.get_metadata(name))
+
+    def resource_isdir(self, resource_name: str):
+        return self._isdir(self._fn(self.module_path, resource_name))
+
+    def metadata_isdir(self, name: str) -> bool:
+        return bool(self.egg_info and self._isdir(self._fn(self.egg_info, name)))
+
+    def resource_listdir(self, resource_name: str):
+        return self._listdir(self._fn(self.module_path, resource_name))
+
+    def metadata_listdir(self, name: str) -> list[str]:
+        if self.egg_info:
+            return self._listdir(self._fn(self.egg_info, name))
+        return []
+
+    def run_script(self, script_name: str, namespace: dict[str, Any]):
+        script = 'scripts/' + script_name
+        if not self.has_metadata(script):
+            raise ResolutionError(
+                "Script {script!r} not found in metadata at {self.egg_info!r}".format(
+                    **locals()
+                ),
+            )
+
+        script_text = self.get_metadata(script).replace('\r\n', '\n')
+        script_text = script_text.replace('\r', '\n')
+        script_filename = self._fn(self.egg_info, script)
+        namespace['__file__'] = script_filename
+        if os.path.exists(script_filename):
+            source = _read_utf8_with_fallback(script_filename)
+            code = compile(source, script_filename, 'exec')
+            exec(code, namespace, namespace)
+        else:
+            from linecache import cache
+
+            cache[script_filename] = (
+                len(script_text),
+                0,
+                script_text.split('\n'),
+                script_filename,
+            )
+            script_code = compile(script_text, script_filename, 'exec')
+            exec(script_code, namespace, namespace)
+
+    def _has(self, path) -> bool:
+        raise NotImplementedError(
+            "Can't perform this operation for unregistered loader type"
+        )
+
+    def _isdir(self, path) -> bool:
+        raise NotImplementedError(
+            "Can't perform this operation for unregistered loader type"
+        )
+
+    def _listdir(self, path) -> list[str]:
+        raise NotImplementedError(
+            "Can't perform this operation for unregistered loader type"
+        )
+
+    def _fn(self, base: str | None, resource_name: str):
+        if base is None:
+            raise TypeError(
+                "`base` parameter in `_fn` is `None`. Either override this method or check the parameter first."
+            )
+        self._validate_resource_path(resource_name)
+        if resource_name:
+            return os.path.join(base, *resource_name.split('/'))
+        return base
+
+    @staticmethod
+    def _validate_resource_path(path):
+        """
+        Validate the resource paths according to the docs.
+        https://setuptools.pypa.io/en/latest/pkg_resources.html#basic-resource-access
+
+        >>> warned = getfixture('recwarn')
+        >>> warnings.simplefilter('always')
+        >>> vrp = NullProvider._validate_resource_path
+        >>> vrp('foo/bar.txt')
+        >>> bool(warned)
+        False
+        >>> vrp('../foo/bar.txt')
+        >>> bool(warned)
+        True
+        >>> warned.clear()
+        >>> vrp('/foo/bar.txt')
+        >>> bool(warned)
+        True
+        >>> vrp('foo/../../bar.txt')
+        >>> bool(warned)
+        True
+        >>> warned.clear()
+        >>> vrp('foo/f../bar.txt')
+        >>> bool(warned)
+        False
+
+        Windows path separators are straight-up disallowed.
+        >>> vrp(r'\\foo/bar.txt')
+        Traceback (most recent call last):
+        ...
+        ValueError: Use of .. or absolute path in a resource path \
+is not allowed.
+
+        >>> vrp(r'C:\\foo/bar.txt')
+        Traceback (most recent call last):
+        ...
+        ValueError: Use of .. or absolute path in a resource path \
+is not allowed.
+
+        Blank values are allowed
+
+        >>> vrp('')
+        >>> bool(warned)
+        False
+
+        Non-string values are not.
+
+        >>> vrp(None)
+        Traceback (most recent call last):
+        ...
+        AttributeError: ...
+        """
+        invalid = (
+            os.path.pardir in path.split(posixpath.sep)
+            or posixpath.isabs(path)
+            or ntpath.isabs(path)
+            or path.startswith("\\")
+        )
+        if not invalid:
+            return
+
+        msg = "Use of .. or absolute path in a resource path is not allowed."
+
+        # Aggressively disallow Windows absolute paths
+        if (path.startswith("\\") or ntpath.isabs(path)) and not posixpath.isabs(path):
+            raise ValueError(msg)
+
+        # for compatibility, warn; in future
+        # raise ValueError(msg)
+        issue_warning(
+            msg[:-1] + " and will raise exceptions in a future release.",
+            DeprecationWarning,
+        )
+
+    def _get(self, path) -> bytes:
+        if hasattr(self.loader, 'get_data') and self.loader:
+            # Already checked get_data exists
+            return self.loader.get_data(path)  # type: ignore[attr-defined]
+        raise NotImplementedError(
+            "Can't perform this operation for loaders without 'get_data()'"
+        )
+
+
+register_loader_type(object, NullProvider)
+
+
+def _parents(path):
+    """
+    yield all parents of path including path
+    """
+    last = None
+    while path != last:
+        yield path
+        last = path
+        path, _ = os.path.split(path)
+
+
+class EggProvider(NullProvider):
+    """Provider based on a virtual filesystem"""
+
+    def __init__(self, module: _ModuleLike):
+        super().__init__(module)
+        self._setup_prefix()
+
+    def _setup_prefix(self):
+        # Assume that metadata may be nested inside a "basket"
+        # of multiple eggs and use module_path instead of .archive.
+        eggs = filter(_is_egg_path, _parents(self.module_path))
+        egg = next(eggs, None)
+        egg and self._set_egg(egg)
+
+    def _set_egg(self, path: str):
+        self.egg_name = os.path.basename(path)
+        self.egg_info = os.path.join(path, 'EGG-INFO')
+        self.egg_root = path
+
+
+class DefaultProvider(EggProvider):
+    """Provides access to package resources in the filesystem"""
+
+    def _has(self, path) -> bool:
+        return os.path.exists(path)
+
+    def _isdir(self, path) -> bool:
+        return os.path.isdir(path)
+
+    def _listdir(self, path):
+        return os.listdir(path)
+
+    def get_resource_stream(self, manager: object, resource_name: str):
+        return open(self._fn(self.module_path, resource_name), 'rb')
+
+    def _get(self, path) -> bytes:
+        with open(path, 'rb') as stream:
+            return stream.read()
+
+    @classmethod
+    def _register(cls):
+        loader_names = (
+            'SourceFileLoader',
+            'SourcelessFileLoader',
+        )
+        for name in loader_names:
+            loader_cls = getattr(importlib.machinery, name, type(None))
+            register_loader_type(loader_cls, cls)
+
+
+DefaultProvider._register()
+
+
+class EmptyProvider(NullProvider):
+    """Provider that returns nothing for all requests"""
+
+    # A special case, we don't want all Providers inheriting from NullProvider to have a potentially None module_path
+    module_path: str | None = None  # type: ignore[assignment]
+
+    _isdir = _has = lambda self, path: False
+
+    def _get(self, path) -> bytes:
+        return b''
+
+    def _listdir(self, path):
+        return []
+
+    def __init__(self):
+        pass
+
+
+empty_provider = EmptyProvider()
+
+
+class ZipManifests(Dict[str, "MemoizedZipManifests.manifest_mod"]):
+    """
+    zip manifest builder
+    """
+
+    # `path` could be `StrPath | IO[bytes]` but that violates the LSP for `MemoizedZipManifests.load`
+    @classmethod
+    def build(cls, path: str):
+        """
+        Build a dictionary similar to the zipimport directory
+        caches, except instead of tuples, store ZipInfo objects.
+
+        Use a platform-specific path separator (os.sep) for the path keys
+        for compatibility with pypy on Windows.
+        """
+        with zipfile.ZipFile(path) as zfile:
+            items = (
+                (
+                    name.replace('/', os.sep),
+                    zfile.getinfo(name),
+                )
+                for name in zfile.namelist()
+            )
+            return dict(items)
+
+    load = build
+
+
+class MemoizedZipManifests(ZipManifests):
+    """
+    Memoized zipfile manifests.
+    """
+
+    class manifest_mod(NamedTuple):
+        manifest: dict[str, zipfile.ZipInfo]
+        mtime: float
+
+    def load(self, path: str) -> dict[str, zipfile.ZipInfo]:  # type: ignore[override] # ZipManifests.load is a classmethod
+        """
+        Load a manifest at path or return a suitable manifest already loaded.
+        """
+        path = os.path.normpath(path)
+        mtime = os.stat(path).st_mtime
+
+        if path not in self or self[path].mtime != mtime:
+            manifest = self.build(path)
+            self[path] = self.manifest_mod(manifest, mtime)
+
+        return self[path].manifest
+
+
+class ZipProvider(EggProvider):
+    """Resource support for zips and eggs"""
+
+    eagers: list[str] | None = None
+    _zip_manifests = MemoizedZipManifests()
+    # ZipProvider's loader should always be a zipimporter or equivalent
+    loader: zipimport.zipimporter
+
+    def __init__(self, module: _ZipLoaderModule):
+        super().__init__(module)
+        self.zip_pre = self.loader.archive + os.sep
+
+    def _zipinfo_name(self, fspath):
+        # Convert a virtual filename (full path to file) into a zipfile subpath
+        # usable with the zipimport directory cache for our target archive
+        fspath = fspath.rstrip(os.sep)
+        if fspath == self.loader.archive:
+            return ''
+        if fspath.startswith(self.zip_pre):
+            return fspath[len(self.zip_pre) :]
+        raise AssertionError("%s is not a subpath of %s" % (fspath, self.zip_pre))
+
+    def _parts(self, zip_path):
+        # Convert a zipfile subpath into an egg-relative path part list.
+        # pseudo-fs path
+        fspath = self.zip_pre + zip_path
+        if fspath.startswith(self.egg_root + os.sep):
+            return fspath[len(self.egg_root) + 1 :].split(os.sep)
+        raise AssertionError("%s is not a subpath of %s" % (fspath, self.egg_root))
+
+    @property
+    def zipinfo(self):
+        return self._zip_manifests.load(self.loader.archive)
+
+    def get_resource_filename(self, manager: ResourceManager, resource_name: str):
+        if not self.egg_name:
+            raise NotImplementedError(
+                "resource_filename() only supported for .egg, not .zip"
+            )
+        # no need to lock for extraction, since we use temp names
+        zip_path = self._resource_to_zip(resource_name)
+        eagers = self._get_eager_resources()
+        if '/'.join(self._parts(zip_path)) in eagers:
+            for name in eagers:
+                self._extract_resource(manager, self._eager_to_zip(name))
+        return self._extract_resource(manager, zip_path)
+
+    @staticmethod
+    def _get_date_and_size(zip_stat):
+        size = zip_stat.file_size
+        # ymdhms+wday, yday, dst
+        date_time = zip_stat.date_time + (0, 0, -1)
+        # 1980 offset already done
+        timestamp = time.mktime(date_time)
+        return timestamp, size
+
+    # FIXME: 'ZipProvider._extract_resource' is too complex (12)
+    def _extract_resource(self, manager: ResourceManager, zip_path) -> str:  # noqa: C901
+        if zip_path in self._index():
+            for name in self._index()[zip_path]:
+                last = self._extract_resource(manager, os.path.join(zip_path, name))
+            # return the extracted directory name
+            return os.path.dirname(last)
+
+        timestamp, size = self._get_date_and_size(self.zipinfo[zip_path])
+
+        if not WRITE_SUPPORT:
+            raise OSError(
+                '"os.rename" and "os.unlink" are not supported on this platform'
+            )
+        try:
+            if not self.egg_name:
+                raise OSError(
+                    '"egg_name" is empty. This likely means no egg could be found from the "module_path".'
+                )
+            real_path = manager.get_cache_path(self.egg_name, self._parts(zip_path))
+
+            if self._is_current(real_path, zip_path):
+                return real_path
+
+            outf, tmpnam = _mkstemp(
+                ".$extract",
+                dir=os.path.dirname(real_path),
+            )
+            os.write(outf, self.loader.get_data(zip_path))
+            os.close(outf)
+            utime(tmpnam, (timestamp, timestamp))
+            manager.postprocess(tmpnam, real_path)
+
+            try:
+                rename(tmpnam, real_path)
+
+            except OSError:
+                if os.path.isfile(real_path):
+                    if self._is_current(real_path, zip_path):
+                        # the file became current since it was checked above,
+                        #  so proceed.
+                        return real_path
+                    # Windows, del old file and retry
+                    elif os.name == 'nt':
+                        unlink(real_path)
+                        rename(tmpnam, real_path)
+                        return real_path
+                raise
+
+        except OSError:
+            # report a user-friendly error
+            manager.extraction_error()
+
+        return real_path
+
+    def _is_current(self, file_path, zip_path):
+        """
+        Return True if the file_path is current for this zip_path
+        """
+        timestamp, size = self._get_date_and_size(self.zipinfo[zip_path])
+        if not os.path.isfile(file_path):
+            return False
+        stat = os.stat(file_path)
+        if stat.st_size != size or stat.st_mtime != timestamp:
+            return False
+        # check that the contents match
+        zip_contents = self.loader.get_data(zip_path)
+        with open(file_path, 'rb') as f:
+            file_contents = f.read()
+        return zip_contents == file_contents
+
+    def _get_eager_resources(self):
+        if self.eagers is None:
+            eagers = []
+            for name in ('native_libs.txt', 'eager_resources.txt'):
+                if self.has_metadata(name):
+                    eagers.extend(self.get_metadata_lines(name))
+            self.eagers = eagers
+        return self.eagers
+
+    def _index(self):
+        try:
+            return self._dirindex
+        except AttributeError:
+            ind = {}
+            for path in self.zipinfo:
+                parts = path.split(os.sep)
+                while parts:
+                    parent = os.sep.join(parts[:-1])
+                    if parent in ind:
+                        ind[parent].append(parts[-1])
+                        break
+                    else:
+                        ind[parent] = [parts.pop()]
+            self._dirindex = ind
+            return ind
+
+    def _has(self, fspath) -> bool:
+        zip_path = self._zipinfo_name(fspath)
+        return zip_path in self.zipinfo or zip_path in self._index()
+
+    def _isdir(self, fspath) -> bool:
+        return self._zipinfo_name(fspath) in self._index()
+
+    def _listdir(self, fspath):
+        return list(self._index().get(self._zipinfo_name(fspath), ()))
+
+    def _eager_to_zip(self, resource_name: str):
+        return self._zipinfo_name(self._fn(self.egg_root, resource_name))
+
+    def _resource_to_zip(self, resource_name: str):
+        return self._zipinfo_name(self._fn(self.module_path, resource_name))
+
+
+register_loader_type(zipimport.zipimporter, ZipProvider)
+
+
+class FileMetadata(EmptyProvider):
+    """Metadata handler for standalone PKG-INFO files
+
+    Usage::
+
+        metadata = FileMetadata("/path/to/PKG-INFO")
+
+    This provider rejects all data and metadata requests except for PKG-INFO,
+    which is treated as existing, and will be the contents of the file at
+    the provided location.
+    """
+
+    def __init__(self, path: StrPath):
+        self.path = path
+
+    def _get_metadata_path(self, name):
+        return self.path
+
+    def has_metadata(self, name: str) -> bool:
+        return name == 'PKG-INFO' and os.path.isfile(self.path)
+
+    def get_metadata(self, name: str):
+        if name != 'PKG-INFO':
+            raise KeyError("No metadata except PKG-INFO is available")
+
+        with open(self.path, encoding='utf-8', errors="replace") as f:
+            metadata = f.read()
+        self._warn_on_replacement(metadata)
+        return metadata
+
+    def _warn_on_replacement(self, metadata):
+        replacement_char = '�'
+        if replacement_char in metadata:
+            tmpl = "{self.path} could not be properly decoded in UTF-8"
+            msg = tmpl.format(**locals())
+            warnings.warn(msg)
+
+    def get_metadata_lines(self, name: str) -> Iterator[str]:
+        return yield_lines(self.get_metadata(name))
+
+
+class PathMetadata(DefaultProvider):
+    """Metadata provider for egg directories
+
+    Usage::
+
+        # Development eggs:
+
+        egg_info = "/path/to/PackageName.egg-info"
+        base_dir = os.path.dirname(egg_info)
+        metadata = PathMetadata(base_dir, egg_info)
+        dist_name = os.path.splitext(os.path.basename(egg_info))[0]
+        dist = Distribution(basedir, project_name=dist_name, metadata=metadata)
+
+        # Unpacked egg directories:
+
+        egg_path = "/path/to/PackageName-ver-pyver-etc.egg"
+        metadata = PathMetadata(egg_path, os.path.join(egg_path,'EGG-INFO'))
+        dist = Distribution.from_filename(egg_path, metadata=metadata)
+    """
+
+    def __init__(self, path: str, egg_info: str):
+        self.module_path = path
+        self.egg_info = egg_info
+
+
+class EggMetadata(ZipProvider):
+    """Metadata provider for .egg files"""
+
+    def __init__(self, importer: zipimport.zipimporter):
+        """Create a metadata provider from a zipimporter"""
+
+        self.zip_pre = importer.archive + os.sep
+        self.loader = importer
+        if importer.prefix:
+            self.module_path = os.path.join(importer.archive, importer.prefix)
+        else:
+            self.module_path = importer.archive
+        self._setup_prefix()
+
+
+_distribution_finders: dict[type, _DistFinderType[Any]] = _declare_state(
+    'dict', '_distribution_finders', {}
+)
+
+
+def register_finder(importer_type: type[_T], distribution_finder: _DistFinderType[_T]):
+    """Register `distribution_finder` to find distributions in sys.path items
+
+    `importer_type` is the type or class of a PEP 302 "Importer" (sys.path item
+    handler), and `distribution_finder` is a callable that, passed a path
+    item and the importer instance, yields ``Distribution`` instances found on
+    that path item.  See ``pkg_resources.find_on_path`` for an example."""
+    _distribution_finders[importer_type] = distribution_finder
+
+
+def find_distributions(path_item: str, only: bool = False):
+    """Yield distributions accessible via `path_item`"""
+    importer = get_importer(path_item)
+    finder = _find_adapter(_distribution_finders, importer)
+    return finder(importer, path_item, only)
+
+
+def find_eggs_in_zip(
+    importer: zipimport.zipimporter, path_item: str, only: bool = False
+) -> Iterator[Distribution]:
+    """
+    Find eggs in zip files; possibly multiple nested eggs.
+    """
+    if importer.archive.endswith('.whl'):
+        # wheels are not supported with this finder
+        # they don't have PKG-INFO metadata, and won't ever contain eggs
+        return
+    metadata = EggMetadata(importer)
+    if metadata.has_metadata('PKG-INFO'):
+        yield Distribution.from_filename(path_item, metadata=metadata)
+    if only:
+        # don't yield nested distros
+        return
+    for subitem in metadata.resource_listdir(''):
+        if _is_egg_path(subitem):
+            subpath = os.path.join(path_item, subitem)
+            dists = find_eggs_in_zip(zipimport.zipimporter(subpath), subpath)
+            yield from dists
+        elif subitem.lower().endswith(('.dist-info', '.egg-info')):
+            subpath = os.path.join(path_item, subitem)
+            submeta = EggMetadata(zipimport.zipimporter(subpath))
+            submeta.egg_info = subpath
+            yield Distribution.from_location(path_item, subitem, submeta)
+
+
+register_finder(zipimport.zipimporter, find_eggs_in_zip)
+
+
+def find_nothing(
+    importer: object | None, path_item: str | None, only: bool | None = False
+):
+    return ()
+
+
+register_finder(object, find_nothing)
+
+
+def find_on_path(importer: object | None, path_item, only=False):
+    """Yield distributions accessible on a sys.path directory"""
+    path_item = _normalize_cached(path_item)
+
+    if _is_unpacked_egg(path_item):
+        yield Distribution.from_filename(
+            path_item,
+            metadata=PathMetadata(path_item, os.path.join(path_item, 'EGG-INFO')),
+        )
+        return
+
+    entries = (os.path.join(path_item, child) for child in safe_listdir(path_item))
+
+    # scan for .egg and .egg-info in directory
+    for entry in sorted(entries):
+        fullpath = os.path.join(path_item, entry)
+        factory = dist_factory(path_item, entry, only)
+        yield from factory(fullpath)
+
+
+def dist_factory(path_item, entry, only):
+    """Return a dist_factory for the given entry."""
+    lower = entry.lower()
+    is_egg_info = lower.endswith('.egg-info')
+    is_dist_info = lower.endswith('.dist-info') and os.path.isdir(
+        os.path.join(path_item, entry)
+    )
+    is_meta = is_egg_info or is_dist_info
+    return (
+        distributions_from_metadata
+        if is_meta
+        else find_distributions
+        if not only and _is_egg_path(entry)
+        else resolve_egg_link
+        if not only and lower.endswith('.egg-link')
+        else NoDists()
+    )
+
+
+class NoDists:
+    """
+    >>> bool(NoDists())
+    False
+
+    >>> list(NoDists()('anything'))
+    []
+    """
+
+    def __bool__(self):
+        return False
+
+    def __call__(self, fullpath):
+        return iter(())
+
+
+def safe_listdir(path: StrOrBytesPath):
+    """
+    Attempt to list contents of path, but suppress some exceptions.
+    """
+    try:
+        return os.listdir(path)
+    except (PermissionError, NotADirectoryError):
+        pass
+    except OSError as e:
+        # Ignore the directory if does not exist, not a directory or
+        # permission denied
+        if e.errno not in (errno.ENOTDIR, errno.EACCES, errno.ENOENT):
+            raise
+    return ()
+
+
+def distributions_from_metadata(path: str):
+    root = os.path.dirname(path)
+    if os.path.isdir(path):
+        if len(os.listdir(path)) == 0:
+            # empty metadata dir; skip
+            return
+        metadata: _MetadataType = PathMetadata(root, path)
+    else:
+        metadata = FileMetadata(path)
+    entry = os.path.basename(path)
+    yield Distribution.from_location(
+        root,
+        entry,
+        metadata,
+        precedence=DEVELOP_DIST,
+    )
+
+
+def non_empty_lines(path):
+    """
+    Yield non-empty lines from file at path
+    """
+    for line in _read_utf8_with_fallback(path).splitlines():
+        line = line.strip()
+        if line:
+            yield line
+
+
+def resolve_egg_link(path):
+    """
+    Given a path to an .egg-link, resolve distributions
+    present in the referenced path.
+    """
+    referenced_paths = non_empty_lines(path)
+    resolved_paths = (
+        os.path.join(os.path.dirname(path), ref) for ref in referenced_paths
+    )
+    dist_groups = map(find_distributions, resolved_paths)
+    return next(dist_groups, ())
+
+
+if hasattr(pkgutil, 'ImpImporter'):
+    register_finder(pkgutil.ImpImporter, find_on_path)
+
+register_finder(importlib.machinery.FileFinder, find_on_path)
+
+_namespace_handlers: dict[type, _NSHandlerType[Any]] = _declare_state(
+    'dict', '_namespace_handlers', {}
+)
+_namespace_packages: dict[str | None, list[str]] = _declare_state(
+    'dict', '_namespace_packages', {}
+)
+
+
+def register_namespace_handler(
+    importer_type: type[_T], namespace_handler: _NSHandlerType[_T]
+):
+    """Register `namespace_handler` to declare namespace packages
+
+    `importer_type` is the type or class of a PEP 302 "Importer" (sys.path item
+    handler), and `namespace_handler` is a callable like this::
+
+        def namespace_handler(importer, path_entry, moduleName, module):
+            # return a path_entry to use for child packages
+
+    Namespace handlers are only called if the importer object has already
+    agreed that it can handle the relevant path item, and they should only
+    return a subpath if the module __path__ does not already contain an
+    equivalent subpath.  For an example namespace handler, see
+    ``pkg_resources.file_ns_handler``.
+    """
+    _namespace_handlers[importer_type] = namespace_handler
+
+
+def _handle_ns(packageName, path_item):
+    """Ensure that named package includes a subpath of path_item (if needed)"""
+
+    importer = get_importer(path_item)
+    if importer is None:
+        return None
+
+    # use find_spec (PEP 451) and fall-back to find_module (PEP 302)
+    try:
+        spec = importer.find_spec(packageName)
+    except AttributeError:
+        # capture warnings due to #1111
+        with warnings.catch_warnings():
+            warnings.simplefilter("ignore")
+            loader = importer.find_module(packageName)
+    else:
+        loader = spec.loader if spec else None
+
+    if loader is None:
+        return None
+    module = sys.modules.get(packageName)
+    if module is None:
+        module = sys.modules[packageName] = types.ModuleType(packageName)
+        module.__path__ = []
+        _set_parent_ns(packageName)
+    elif not hasattr(module, '__path__'):
+        raise TypeError("Not a package:", packageName)
+    handler = _find_adapter(_namespace_handlers, importer)
+    subpath = handler(importer, path_item, packageName, module)
+    if subpath is not None:
+        path = module.__path__
+        path.append(subpath)
+        importlib.import_module(packageName)
+        _rebuild_mod_path(path, packageName, module)
+    return subpath
+
+
+def _rebuild_mod_path(orig_path, package_name, module: types.ModuleType):
+    """
+    Rebuild module.__path__ ensuring that all entries are ordered
+    corresponding to their sys.path order
+    """
+    sys_path = [_normalize_cached(p) for p in sys.path]
+
+    def safe_sys_path_index(entry):
+        """
+        Workaround for #520 and #513.
+        """
+        try:
+            return sys_path.index(entry)
+        except ValueError:
+            return float('inf')
+
+    def position_in_sys_path(path):
+        """
+        Return the ordinal of the path based on its position in sys.path
+        """
+        path_parts = path.split(os.sep)
+        module_parts = package_name.count('.') + 1
+        parts = path_parts[:-module_parts]
+        return safe_sys_path_index(_normalize_cached(os.sep.join(parts)))
+
+    new_path = sorted(orig_path, key=position_in_sys_path)
+    new_path = [_normalize_cached(p) for p in new_path]
+
+    if isinstance(module.__path__, list):
+        module.__path__[:] = new_path
+    else:
+        module.__path__ = new_path
+
+
+def declare_namespace(packageName: str):
+    """Declare that package 'packageName' is a namespace package"""
+
+    msg = (
+        f"Deprecated call to `pkg_resources.declare_namespace({packageName!r})`.\n"
+        "Implementing implicit namespace packages (as specified in PEP 420) "
+        "is preferred to `pkg_resources.declare_namespace`. "
+        "See https://setuptools.pypa.io/en/latest/references/"
+        "keywords.html#keyword-namespace-packages"
+    )
+    warnings.warn(msg, DeprecationWarning, stacklevel=2)
+
+    _imp.acquire_lock()
+    try:
+        if packageName in _namespace_packages:
+            return
+
+        path: MutableSequence[str] = sys.path
+        parent, _, _ = packageName.rpartition('.')
+
+        if parent:
+            declare_namespace(parent)
+            if parent not in _namespace_packages:
+                __import__(parent)
+            try:
+                path = sys.modules[parent].__path__
+            except AttributeError as e:
+                raise TypeError("Not a package:", parent) from e
+
+        # Track what packages are namespaces, so when new path items are added,
+        # they can be updated
+        _namespace_packages.setdefault(parent or None, []).append(packageName)
+        _namespace_packages.setdefault(packageName, [])
+
+        for path_item in path:
+            # Ensure all the parent's path items are reflected in the child,
+            # if they apply
+            _handle_ns(packageName, path_item)
+
+    finally:
+        _imp.release_lock()
+
+
+def fixup_namespace_packages(path_item: str, parent: str | None = None):
+    """Ensure that previously-declared namespace packages include path_item"""
+    _imp.acquire_lock()
+    try:
+        for package in _namespace_packages.get(parent, ()):
+            subpath = _handle_ns(package, path_item)
+            if subpath:
+                fixup_namespace_packages(subpath, package)
+    finally:
+        _imp.release_lock()
+
+
+def file_ns_handler(
+    importer: object,
+    path_item: StrPath,
+    packageName: str,
+    module: types.ModuleType,
+):
+    """Compute an ns-package subpath for a filesystem or zipfile importer"""
+
+    subpath = os.path.join(path_item, packageName.split('.')[-1])
+    normalized = _normalize_cached(subpath)
+    for item in module.__path__:
+        if _normalize_cached(item) == normalized:
+            break
+    else:
+        # Only return the path if it's not already there
+        return subpath
+
+
+if hasattr(pkgutil, 'ImpImporter'):
+    register_namespace_handler(pkgutil.ImpImporter, file_ns_handler)
+
+register_namespace_handler(zipimport.zipimporter, file_ns_handler)
+register_namespace_handler(importlib.machinery.FileFinder, file_ns_handler)
+
+
+def null_ns_handler(
+    importer: object,
+    path_item: str | None,
+    packageName: str | None,
+    module: _ModuleLike | None,
+):
+    return None
+
+
+register_namespace_handler(object, null_ns_handler)
+
+
+@overload
+def normalize_path(filename: StrPath) -> str: ...
+@overload
+def normalize_path(filename: BytesPath) -> bytes: ...
+def normalize_path(filename: StrOrBytesPath):
+    """Normalize a file/dir name for comparison purposes"""
+    return os.path.normcase(os.path.realpath(os.path.normpath(_cygwin_patch(filename))))
+
+
+def _cygwin_patch(filename: StrOrBytesPath):  # pragma: nocover
+    """
+    Contrary to POSIX 2008, on Cygwin, getcwd (3) contains
+    symlink components. Using
+    os.path.abspath() works around this limitation. A fix in os.getcwd()
+    would probably better, in Cygwin even more so, except
+    that this seems to be by design...
+    """
+    return os.path.abspath(filename) if sys.platform == 'cygwin' else filename
+
+
+if TYPE_CHECKING:
+    # https://github.com/python/mypy/issues/16261
+    # https://github.com/python/typeshed/issues/6347
+    @overload
+    def _normalize_cached(filename: StrPath) -> str: ...
+    @overload
+    def _normalize_cached(filename: BytesPath) -> bytes: ...
+    def _normalize_cached(filename: StrOrBytesPath) -> str | bytes: ...
+else:
+
+    @functools.lru_cache(maxsize=None)
+    def _normalize_cached(filename):
+        return normalize_path(filename)
+
+
+def _is_egg_path(path):
+    """
+    Determine if given path appears to be an egg.
+    """
+    return _is_zip_egg(path) or _is_unpacked_egg(path)
+
+
+def _is_zip_egg(path):
+    return (
+        path.lower().endswith('.egg')
+        and os.path.isfile(path)
+        and zipfile.is_zipfile(path)
+    )
+
+
+def _is_unpacked_egg(path):
+    """
+    Determine if given path appears to be an unpacked egg.
+    """
+    return path.lower().endswith('.egg') and os.path.isfile(
+        os.path.join(path, 'EGG-INFO', 'PKG-INFO')
+    )
+
+
+def _set_parent_ns(packageName):
+    parts = packageName.split('.')
+    name = parts.pop()
+    if parts:
+        parent = '.'.join(parts)
+        setattr(sys.modules[parent], name, sys.modules[packageName])
+
+
+MODULE = re.compile(r"\w+(\.\w+)*$").match
+EGG_NAME = re.compile(
+    r"""
+    (?P[^-]+) (
+        -(?P[^-]+) (
+            -py(?P[^-]+) (
+                -(?P.+)
+            )?
+        )?
+    )?
+    """,
+    re.VERBOSE | re.IGNORECASE,
+).match
+
+
+class EntryPoint:
+    """Object representing an advertised importable object"""
+
+    def __init__(
+        self,
+        name: str,
+        module_name: str,
+        attrs: Iterable[str] = (),
+        extras: Iterable[str] = (),
+        dist: Distribution | None = None,
+    ):
+        if not MODULE(module_name):
+            raise ValueError("Invalid module name", module_name)
+        self.name = name
+        self.module_name = module_name
+        self.attrs = tuple(attrs)
+        self.extras = tuple(extras)
+        self.dist = dist
+
+    def __str__(self):
+        s = "%s = %s" % (self.name, self.module_name)
+        if self.attrs:
+            s += ':' + '.'.join(self.attrs)
+        if self.extras:
+            s += ' [%s]' % ','.join(self.extras)
+        return s
+
+    def __repr__(self):
+        return "EntryPoint.parse(%r)" % str(self)
+
+    @overload
+    def load(
+        self,
+        require: Literal[True] = True,
+        env: Environment | None = None,
+        installer: _InstallerType | None = None,
+    ) -> _ResolvedEntryPoint: ...
+    @overload
+    def load(
+        self,
+        require: Literal[False],
+        *args: Any,
+        **kwargs: Any,
+    ) -> _ResolvedEntryPoint: ...
+    def load(
+        self,
+        require: bool = True,
+        *args: Environment | _InstallerType | None,
+        **kwargs: Environment | _InstallerType | None,
+    ) -> _ResolvedEntryPoint:
+        """
+        Require packages for this EntryPoint, then resolve it.
+        """
+        if not require or args or kwargs:
+            warnings.warn(
+                "Parameters to load are deprecated.  Call .resolve and "
+                ".require separately.",
+                PkgResourcesDeprecationWarning,
+                stacklevel=2,
+            )
+        if require:
+            # We could pass `env` and `installer` directly,
+            # but keeping `*args` and `**kwargs` for backwards compatibility
+            self.require(*args, **kwargs)  # type: ignore
+        return self.resolve()
+
+    def resolve(self) -> _ResolvedEntryPoint:
+        """
+        Resolve the entry point from its module and attrs.
+        """
+        module = __import__(self.module_name, fromlist=['__name__'], level=0)
+        try:
+            return functools.reduce(getattr, self.attrs, module)
+        except AttributeError as exc:
+            raise ImportError(str(exc)) from exc
+
+    def require(
+        self,
+        env: Environment | None = None,
+        installer: _InstallerType | None = None,
+    ):
+        if not self.dist:
+            error_cls = UnknownExtra if self.extras else AttributeError
+            raise error_cls("Can't require() without a distribution", self)
+
+        # Get the requirements for this entry point with all its extras and
+        # then resolve them. We have to pass `extras` along when resolving so
+        # that the working set knows what extras we want. Otherwise, for
+        # dist-info distributions, the working set will assume that the
+        # requirements for that extra are purely optional and skip over them.
+        reqs = self.dist.requires(self.extras)
+        items = working_set.resolve(reqs, env, installer, extras=self.extras)
+        list(map(working_set.add, items))
+
+    pattern = re.compile(
+        r'\s*'
+        r'(?P.+?)\s*'
+        r'=\s*'
+        r'(?P[\w.]+)\s*'
+        r'(:\s*(?P[\w.]+))?\s*'
+        r'(?P\[.*\])?\s*$'
+    )
+
+    @classmethod
+    def parse(cls, src: str, dist: Distribution | None = None):
+        """Parse a single entry point from string `src`
+
+        Entry point syntax follows the form::
+
+            name = some.module:some.attr [extra1, extra2]
+
+        The entry name and module name are required, but the ``:attrs`` and
+        ``[extras]`` parts are optional
+        """
+        m = cls.pattern.match(src)
+        if not m:
+            msg = "EntryPoint must be in 'name=module:attrs [extras]' format"
+            raise ValueError(msg, src)
+        res = m.groupdict()
+        extras = cls._parse_extras(res['extras'])
+        attrs = res['attr'].split('.') if res['attr'] else ()
+        return cls(res['name'], res['module'], attrs, extras, dist)
+
+    @classmethod
+    def _parse_extras(cls, extras_spec):
+        if not extras_spec:
+            return ()
+        req = Requirement.parse('x' + extras_spec)
+        if req.specs:
+            raise ValueError
+        return req.extras
+
+    @classmethod
+    def parse_group(
+        cls,
+        group: str,
+        lines: _NestedStr,
+        dist: Distribution | None = None,
+    ):
+        """Parse an entry point group"""
+        if not MODULE(group):
+            raise ValueError("Invalid group name", group)
+        this: dict[str, Self] = {}
+        for line in yield_lines(lines):
+            ep = cls.parse(line, dist)
+            if ep.name in this:
+                raise ValueError("Duplicate entry point", group, ep.name)
+            this[ep.name] = ep
+        return this
+
+    @classmethod
+    def parse_map(
+        cls,
+        data: str | Iterable[str] | dict[str, str | Iterable[str]],
+        dist: Distribution | None = None,
+    ):
+        """Parse a map of entry point groups"""
+        _data: Iterable[tuple[str | None, str | Iterable[str]]]
+        if isinstance(data, dict):
+            _data = data.items()
+        else:
+            _data = split_sections(data)
+        maps: dict[str, dict[str, Self]] = {}
+        for group, lines in _data:
+            if group is None:
+                if not lines:
+                    continue
+                raise ValueError("Entry points must be listed in groups")
+            group = group.strip()
+            if group in maps:
+                raise ValueError("Duplicate group name", group)
+            maps[group] = cls.parse_group(group, lines, dist)
+        return maps
+
+
+def _version_from_file(lines):
+    """
+    Given an iterable of lines from a Metadata file, return
+    the value of the Version field, if present, or None otherwise.
+    """
+
+    def is_version_line(line):
+        return line.lower().startswith('version:')
+
+    version_lines = filter(is_version_line, lines)
+    line = next(iter(version_lines), '')
+    _, _, value = line.partition(':')
+    return safe_version(value.strip()) or None
+
+
+class Distribution:
+    """Wrap an actual or potential sys.path entry w/metadata"""
+
+    PKG_INFO = 'PKG-INFO'
+
+    def __init__(
+        self,
+        location: str | None = None,
+        metadata: _MetadataType = None,
+        project_name: str | None = None,
+        version: str | None = None,
+        py_version: str | None = PY_MAJOR,
+        platform: str | None = None,
+        precedence: int = EGG_DIST,
+    ):
+        self.project_name = safe_name(project_name or 'Unknown')
+        if version is not None:
+            self._version = safe_version(version)
+        self.py_version = py_version
+        self.platform = platform
+        self.location = location
+        self.precedence = precedence
+        self._provider = metadata or empty_provider
+
+    @classmethod
+    def from_location(
+        cls,
+        location: str,
+        basename: StrPath,
+        metadata: _MetadataType = None,
+        **kw: int,  # We could set `precedence` explicitly, but keeping this as `**kw` for full backwards and subclassing compatibility
+    ) -> Distribution:
+        project_name, version, py_version, platform = [None] * 4
+        basename, ext = os.path.splitext(basename)
+        if ext.lower() in _distributionImpl:
+            cls = _distributionImpl[ext.lower()]
+
+            match = EGG_NAME(basename)
+            if match:
+                project_name, version, py_version, platform = match.group(
+                    'name', 'ver', 'pyver', 'plat'
+                )
+        return cls(
+            location,
+            metadata,
+            project_name=project_name,
+            version=version,
+            py_version=py_version,
+            platform=platform,
+            **kw,
+        )._reload_version()
+
+    def _reload_version(self):
+        return self
+
+    @property
+    def hashcmp(self):
+        return (
+            self._forgiving_parsed_version,
+            self.precedence,
+            self.key,
+            self.location,
+            self.py_version or '',
+            self.platform or '',
+        )
+
+    def __hash__(self):
+        return hash(self.hashcmp)
+
+    def __lt__(self, other: Distribution):
+        return self.hashcmp < other.hashcmp
+
+    def __le__(self, other: Distribution):
+        return self.hashcmp <= other.hashcmp
+
+    def __gt__(self, other: Distribution):
+        return self.hashcmp > other.hashcmp
+
+    def __ge__(self, other: Distribution):
+        return self.hashcmp >= other.hashcmp
+
+    def __eq__(self, other: object):
+        if not isinstance(other, self.__class__):
+            # It's not a Distribution, so they are not equal
+            return False
+        return self.hashcmp == other.hashcmp
+
+    def __ne__(self, other: object):
+        return not self == other
+
+    # These properties have to be lazy so that we don't have to load any
+    # metadata until/unless it's actually needed.  (i.e., some distributions
+    # may not know their name or version without loading PKG-INFO)
+
+    @property
+    def key(self):
+        try:
+            return self._key
+        except AttributeError:
+            self._key = key = self.project_name.lower()
+            return key
+
+    @property
+    def parsed_version(self):
+        if not hasattr(self, "_parsed_version"):
+            try:
+                self._parsed_version = parse_version(self.version)
+            except _packaging_version.InvalidVersion as ex:
+                info = f"(package: {self.project_name})"
+                if hasattr(ex, "add_note"):
+                    ex.add_note(info)  # PEP 678
+                    raise
+                raise _packaging_version.InvalidVersion(f"{str(ex)} {info}") from None
+
+        return self._parsed_version
+
+    @property
+    def _forgiving_parsed_version(self):
+        try:
+            return self.parsed_version
+        except _packaging_version.InvalidVersion as ex:
+            self._parsed_version = parse_version(_forgiving_version(self.version))
+
+            notes = "\n".join(getattr(ex, "__notes__", []))  # PEP 678
+            msg = f"""!!\n\n
+            *************************************************************************
+            {str(ex)}\n{notes}
+
+            This is a long overdue deprecation.
+            For the time being, `pkg_resources` will use `{self._parsed_version}`
+            as a replacement to avoid breaking existing environments,
+            but no future compatibility is guaranteed.
+
+            If you maintain package {self.project_name} you should implement
+            the relevant changes to adequate the project to PEP 440 immediately.
+            *************************************************************************
+            \n\n!!
+            """
+            warnings.warn(msg, DeprecationWarning)
+
+            return self._parsed_version
+
+    @property
+    def version(self):
+        try:
+            return self._version
+        except AttributeError as e:
+            version = self._get_version()
+            if version is None:
+                path = self._get_metadata_path_for_display(self.PKG_INFO)
+                msg = ("Missing 'Version:' header and/or {} file at path: {}").format(
+                    self.PKG_INFO, path
+                )
+                raise ValueError(msg, self) from e
+
+            return version
+
+    @property
+    def _dep_map(self):
+        """
+        A map of extra to its list of (direct) requirements
+        for this distribution, including the null extra.
+        """
+        try:
+            return self.__dep_map
+        except AttributeError:
+            self.__dep_map = self._filter_extras(self._build_dep_map())
+        return self.__dep_map
+
+    @staticmethod
+    def _filter_extras(dm: dict[str | None, list[Requirement]]):
+        """
+        Given a mapping of extras to dependencies, strip off
+        environment markers and filter out any dependencies
+        not matching the markers.
+        """
+        for extra in list(filter(None, dm)):
+            new_extra: str | None = extra
+            reqs = dm.pop(extra)
+            new_extra, _, marker = extra.partition(':')
+            fails_marker = marker and (
+                invalid_marker(marker) or not evaluate_marker(marker)
+            )
+            if fails_marker:
+                reqs = []
+            new_extra = safe_extra(new_extra) or None
+
+            dm.setdefault(new_extra, []).extend(reqs)
+        return dm
+
+    def _build_dep_map(self):
+        dm = {}
+        for name in 'requires.txt', 'depends.txt':
+            for extra, reqs in split_sections(self._get_metadata(name)):
+                dm.setdefault(extra, []).extend(parse_requirements(reqs))
+        return dm
+
+    def requires(self, extras: Iterable[str] = ()):
+        """List of Requirements needed for this distro if `extras` are used"""
+        dm = self._dep_map
+        deps: list[Requirement] = []
+        deps.extend(dm.get(None, ()))
+        for ext in extras:
+            try:
+                deps.extend(dm[safe_extra(ext)])
+            except KeyError as e:
+                raise UnknownExtra(
+                    "%s has no such extra feature %r" % (self, ext)
+                ) from e
+        return deps
+
+    def _get_metadata_path_for_display(self, name):
+        """
+        Return the path to the given metadata file, if available.
+        """
+        try:
+            # We need to access _get_metadata_path() on the provider object
+            # directly rather than through this class's __getattr__()
+            # since _get_metadata_path() is marked private.
+            path = self._provider._get_metadata_path(name)
+
+        # Handle exceptions e.g. in case the distribution's metadata
+        # provider doesn't support _get_metadata_path().
+        except Exception:
+            return '[could not detect]'
+
+        return path
+
+    def _get_metadata(self, name):
+        if self.has_metadata(name):
+            yield from self.get_metadata_lines(name)
+
+    def _get_version(self):
+        lines = self._get_metadata(self.PKG_INFO)
+        return _version_from_file(lines)
+
+    def activate(self, path: list[str] | None = None, replace: bool = False):
+        """Ensure distribution is importable on `path` (default=sys.path)"""
+        if path is None:
+            path = sys.path
+        self.insert_on(path, replace=replace)
+        if path is sys.path and self.location is not None:
+            fixup_namespace_packages(self.location)
+            for pkg in self._get_metadata('namespace_packages.txt'):
+                if pkg in sys.modules:
+                    declare_namespace(pkg)
+
+    def egg_name(self):
+        """Return what this distribution's standard .egg filename should be"""
+        filename = "%s-%s-py%s" % (
+            to_filename(self.project_name),
+            to_filename(self.version),
+            self.py_version or PY_MAJOR,
+        )
+
+        if self.platform:
+            filename += '-' + self.platform
+        return filename
+
+    def __repr__(self):
+        if self.location:
+            return "%s (%s)" % (self, self.location)
+        else:
+            return str(self)
+
+    def __str__(self):
+        try:
+            version = getattr(self, 'version', None)
+        except ValueError:
+            version = None
+        version = version or "[unknown version]"
+        return "%s %s" % (self.project_name, version)
+
+    def __getattr__(self, attr):
+        """Delegate all unrecognized public attributes to .metadata provider"""
+        if attr.startswith('_'):
+            raise AttributeError(attr)
+        return getattr(self._provider, attr)
+
+    def __dir__(self):
+        return list(
+            set(super().__dir__())
+            | set(attr for attr in self._provider.__dir__() if not attr.startswith('_'))
+        )
+
+    @classmethod
+    def from_filename(
+        cls,
+        filename: StrPath,
+        metadata: _MetadataType = None,
+        **kw: int,  # We could set `precedence` explicitly, but keeping this as `**kw` for full backwards and subclassing compatibility
+    ):
+        return cls.from_location(
+            _normalize_cached(filename), os.path.basename(filename), metadata, **kw
+        )
+
+    def as_requirement(self):
+        """Return a ``Requirement`` that matches this distribution exactly"""
+        if isinstance(self.parsed_version, _packaging_version.Version):
+            spec = "%s==%s" % (self.project_name, self.parsed_version)
+        else:
+            spec = "%s===%s" % (self.project_name, self.parsed_version)
+
+        return Requirement.parse(spec)
+
+    def load_entry_point(self, group: str, name: str) -> _ResolvedEntryPoint:
+        """Return the `name` entry point of `group` or raise ImportError"""
+        ep = self.get_entry_info(group, name)
+        if ep is None:
+            raise ImportError("Entry point %r not found" % ((group, name),))
+        return ep.load()
+
+    @overload
+    def get_entry_map(self, group: None = None) -> dict[str, dict[str, EntryPoint]]: ...
+    @overload
+    def get_entry_map(self, group: str) -> dict[str, EntryPoint]: ...
+    def get_entry_map(self, group: str | None = None):
+        """Return the entry point map for `group`, or the full entry map"""
+        if not hasattr(self, "_ep_map"):
+            self._ep_map = EntryPoint.parse_map(
+                self._get_metadata('entry_points.txt'), self
+            )
+        if group is not None:
+            return self._ep_map.get(group, {})
+        return self._ep_map
+
+    def get_entry_info(self, group: str, name: str):
+        """Return the EntryPoint object for `group`+`name`, or ``None``"""
+        return self.get_entry_map(group).get(name)
+
+    # FIXME: 'Distribution.insert_on' is too complex (13)
+    def insert_on(  # noqa: C901
+        self,
+        path: list[str],
+        loc=None,
+        replace: bool = False,
+    ):
+        """Ensure self.location is on path
+
+        If replace=False (default):
+            - If location is already in path anywhere, do nothing.
+            - Else:
+              - If it's an egg and its parent directory is on path,
+                insert just ahead of the parent.
+              - Else: add to the end of path.
+        If replace=True:
+            - If location is already on path anywhere (not eggs)
+              or higher priority than its parent (eggs)
+              do nothing.
+            - Else:
+              - If it's an egg and its parent directory is on path,
+                insert just ahead of the parent,
+                removing any lower-priority entries.
+              - Else: add it to the front of path.
+        """
+
+        loc = loc or self.location
+        if not loc:
+            return
+
+        nloc = _normalize_cached(loc)
+        bdir = os.path.dirname(nloc)
+        npath = [(p and _normalize_cached(p) or p) for p in path]
+
+        for p, item in enumerate(npath):
+            if item == nloc:
+                if replace:
+                    break
+                else:
+                    # don't modify path (even removing duplicates) if
+                    # found and not replace
+                    return
+            elif item == bdir and self.precedence == EGG_DIST:
+                # if it's an .egg, give it precedence over its directory
+                # UNLESS it's already been added to sys.path and replace=False
+                if (not replace) and nloc in npath[p:]:
+                    return
+                if path is sys.path:
+                    self.check_version_conflict()
+                path.insert(p, loc)
+                npath.insert(p, nloc)
+                break
+        else:
+            if path is sys.path:
+                self.check_version_conflict()
+            if replace:
+                path.insert(0, loc)
+            else:
+                path.append(loc)
+            return
+
+        # p is the spot where we found or inserted loc; now remove duplicates
+        while True:
+            try:
+                np = npath.index(nloc, p + 1)
+            except ValueError:
+                break
+            else:
+                del npath[np], path[np]
+                # ha!
+                p = np
+
+        return
+
+    def check_version_conflict(self):
+        if self.key == 'setuptools':
+            # ignore the inevitable setuptools self-conflicts  :(
+            return
+
+        nsp = dict.fromkeys(self._get_metadata('namespace_packages.txt'))
+        loc = normalize_path(self.location)
+        for modname in self._get_metadata('top_level.txt'):
+            if (
+                modname not in sys.modules
+                or modname in nsp
+                or modname in _namespace_packages
+            ):
+                continue
+            if modname in ('pkg_resources', 'setuptools', 'site'):
+                continue
+            fn = getattr(sys.modules[modname], '__file__', None)
+            if fn and (
+                normalize_path(fn).startswith(loc) or fn.startswith(self.location)
+            ):
+                continue
+            issue_warning(
+                "Module %s was already imported from %s, but %s is being added"
+                " to sys.path" % (modname, fn, self.location),
+            )
+
+    def has_version(self):
+        try:
+            self.version
+        except ValueError:
+            issue_warning("Unbuilt egg for " + repr(self))
+            return False
+        except SystemError:
+            # TODO: remove this except clause when python/cpython#103632 is fixed.
+            return False
+        return True
+
+    def clone(self, **kw: str | int | IResourceProvider | None):
+        """Copy this distribution, substituting in any changed keyword args"""
+        names = 'project_name version py_version platform location precedence'
+        for attr in names.split():
+            kw.setdefault(attr, getattr(self, attr, None))
+        kw.setdefault('metadata', self._provider)
+        # Unsafely unpacking. But keeping **kw for backwards and subclassing compatibility
+        return self.__class__(**kw)  # type:ignore[arg-type]
+
+    @property
+    def extras(self):
+        return [dep for dep in self._dep_map if dep]
+
+
+class EggInfoDistribution(Distribution):
+    def _reload_version(self):
+        """
+        Packages installed by distutils (e.g. numpy or scipy),
+        which uses an old safe_version, and so
+        their version numbers can get mangled when
+        converted to filenames (e.g., 1.11.0.dev0+2329eae to
+        1.11.0.dev0_2329eae). These distributions will not be
+        parsed properly
+        downstream by Distribution and safe_version, so
+        take an extra step and try to get the version number from
+        the metadata file itself instead of the filename.
+        """
+        md_version = self._get_version()
+        if md_version:
+            self._version = md_version
+        return self
+
+
+class DistInfoDistribution(Distribution):
+    """
+    Wrap an actual or potential sys.path entry
+    w/metadata, .dist-info style.
+    """
+
+    PKG_INFO = 'METADATA'
+    EQEQ = re.compile(r"([\(,])\s*(\d.*?)\s*([,\)])")
+
+    @property
+    def _parsed_pkg_info(self):
+        """Parse and cache metadata"""
+        try:
+            return self._pkg_info
+        except AttributeError:
+            metadata = self.get_metadata(self.PKG_INFO)
+            self._pkg_info = email.parser.Parser().parsestr(metadata)
+            return self._pkg_info
+
+    @property
+    def _dep_map(self):
+        try:
+            return self.__dep_map
+        except AttributeError:
+            self.__dep_map = self._compute_dependencies()
+            return self.__dep_map
+
+    def _compute_dependencies(self) -> dict[str | None, list[Requirement]]:
+        """Recompute this distribution's dependencies."""
+        self.__dep_map: dict[str | None, list[Requirement]] = {None: []}
+
+        reqs: list[Requirement] = []
+        # Including any condition expressions
+        for req in self._parsed_pkg_info.get_all('Requires-Dist') or []:
+            reqs.extend(parse_requirements(req))
+
+        def reqs_for_extra(extra):
+            for req in reqs:
+                if not req.marker or req.marker.evaluate({'extra': extra}):
+                    yield req
+
+        common = types.MappingProxyType(dict.fromkeys(reqs_for_extra(None)))
+        self.__dep_map[None].extend(common)
+
+        for extra in self._parsed_pkg_info.get_all('Provides-Extra') or []:
+            s_extra = safe_extra(extra.strip())
+            self.__dep_map[s_extra] = [
+                r for r in reqs_for_extra(extra) if r not in common
+            ]
+
+        return self.__dep_map
+
+
+_distributionImpl = {
+    '.egg': Distribution,
+    '.egg-info': EggInfoDistribution,
+    '.dist-info': DistInfoDistribution,
+}
+
+
+def issue_warning(*args, **kw):
+    level = 1
+    g = globals()
+    try:
+        # find the first stack frame that is *not* code in
+        # the pkg_resources module, to use for the warning
+        while sys._getframe(level).f_globals is g:
+            level += 1
+    except ValueError:
+        pass
+    warnings.warn(stacklevel=level + 1, *args, **kw)
+
+
+def parse_requirements(strs: _NestedStr):
+    """
+    Yield ``Requirement`` objects for each specification in `strs`.
+
+    `strs` must be a string, or a (possibly-nested) iterable thereof.
+    """
+    return map(Requirement, join_continuation(map(drop_comment, yield_lines(strs))))
+
+
+class RequirementParseError(_packaging_requirements.InvalidRequirement):
+    "Compatibility wrapper for InvalidRequirement"
+
+
+class Requirement(_packaging_requirements.Requirement):
+    def __init__(self, requirement_string: str):
+        """DO NOT CALL THIS UNDOCUMENTED METHOD; use Requirement.parse()!"""
+        super().__init__(requirement_string)
+        self.unsafe_name = self.name
+        project_name = safe_name(self.name)
+        self.project_name, self.key = project_name, project_name.lower()
+        self.specs = [(spec.operator, spec.version) for spec in self.specifier]
+        # packaging.requirements.Requirement uses a set for its extras. We use a variable-length tuple
+        self.extras: tuple[str] = tuple(map(safe_extra, self.extras))
+        self.hashCmp = (
+            self.key,
+            self.url,
+            self.specifier,
+            frozenset(self.extras),
+            str(self.marker) if self.marker else None,
+        )
+        self.__hash = hash(self.hashCmp)
+
+    def __eq__(self, other: object):
+        return isinstance(other, Requirement) and self.hashCmp == other.hashCmp
+
+    def __ne__(self, other):
+        return not self == other
+
+    def __contains__(self, item: Distribution | str | tuple[str, ...]) -> bool:
+        if isinstance(item, Distribution):
+            if item.key != self.key:
+                return False
+
+            item = item.version
+
+        # Allow prereleases always in order to match the previous behavior of
+        # this method. In the future this should be smarter and follow PEP 440
+        # more accurately.
+        return self.specifier.contains(item, prereleases=True)
+
+    def __hash__(self):
+        return self.__hash
+
+    def __repr__(self):
+        return "Requirement.parse(%r)" % str(self)
+
+    @staticmethod
+    def parse(s: str | Iterable[str]):
+        (req,) = parse_requirements(s)
+        return req
+
+
+def _always_object(classes):
+    """
+    Ensure object appears in the mro even
+    for old-style classes.
+    """
+    if object not in classes:
+        return classes + (object,)
+    return classes
+
+
+def _find_adapter(registry: Mapping[type, _AdapterT], ob: object) -> _AdapterT:
+    """Return an adapter factory for `ob` from `registry`"""
+    types = _always_object(inspect.getmro(getattr(ob, '__class__', type(ob))))
+    for t in types:
+        if t in registry:
+            return registry[t]
+    # _find_adapter would previously return None, and immediately be called.
+    # So we're raising a TypeError to keep backward compatibility if anyone depended on that behaviour.
+    raise TypeError(f"Could not find adapter for {registry} and {ob}")
+
+
+def ensure_directory(path: StrOrBytesPath):
+    """Ensure that the parent directory of `path` exists"""
+    dirname = os.path.dirname(path)
+    os.makedirs(dirname, exist_ok=True)
+
+
+def _bypass_ensure_directory(path):
+    """Sandbox-bypassing version of ensure_directory()"""
+    if not WRITE_SUPPORT:
+        raise OSError('"os.mkdir" not supported on this platform.')
+    dirname, filename = split(path)
+    if dirname and filename and not isdir(dirname):
+        _bypass_ensure_directory(dirname)
+        try:
+            mkdir(dirname, 0o755)
+        except FileExistsError:
+            pass
+
+
+def split_sections(s: _NestedStr) -> Iterator[tuple[str | None, list[str]]]:
+    """Split a string or iterable thereof into (section, content) pairs
+
+    Each ``section`` is a stripped version of the section header ("[section]")
+    and each ``content`` is a list of stripped lines excluding blank lines and
+    comment-only lines.  If there are any such lines before the first section
+    header, they're returned in a first ``section`` of ``None``.
+    """
+    section = None
+    content = []
+    for line in yield_lines(s):
+        if line.startswith("["):
+            if line.endswith("]"):
+                if section or content:
+                    yield section, content
+                section = line[1:-1].strip()
+                content = []
+            else:
+                raise ValueError("Invalid section heading", line)
+        else:
+            content.append(line)
+
+    # wrap up last segment
+    yield section, content
+
+
+def _mkstemp(*args, **kw):
+    old_open = os.open
+    try:
+        # temporarily bypass sandboxing
+        os.open = os_open
+        return tempfile.mkstemp(*args, **kw)
+    finally:
+        # and then put it back
+        os.open = old_open
+
+
+# Silence the PEP440Warning by default, so that end users don't get hit by it
+# randomly just because they use pkg_resources. We want to append the rule
+# because we want earlier uses of filterwarnings to take precedence over this
+# one.
+warnings.filterwarnings("ignore", category=PEP440Warning, append=True)
+
+
+class PkgResourcesDeprecationWarning(Warning):
+    """
+    Base class for warning about deprecations in ``pkg_resources``
+
+    This class is not derived from ``DeprecationWarning``, and as such is
+    visible by default.
+    """
+
+
+# Ported from ``setuptools`` to avoid introducing an import inter-dependency:
+_LOCALE_ENCODING = "locale" if sys.version_info >= (3, 10) else None
+
+
+def _read_utf8_with_fallback(file: str, fallback_encoding=_LOCALE_ENCODING) -> str:
+    """See setuptools.unicode_utils._read_utf8_with_fallback"""
+    try:
+        with open(file, "r", encoding="utf-8") as f:
+            return f.read()
+    except UnicodeDecodeError:  # pragma: no cover
+        msg = f"""\
+        ********************************************************************************
+        `encoding="utf-8"` fails with {file!r}, trying `encoding={fallback_encoding!r}`.
+
+        This fallback behaviour is considered **deprecated** and future versions of
+        `setuptools/pkg_resources` may not implement it.
+
+        Please encode {file!r} with "utf-8" to ensure future builds will succeed.
+
+        If this file was produced by `setuptools` itself, cleaning up the cached files
+        and re-building/re-installing the package with a newer version of `setuptools`
+        (e.g. by updating `build-system.requires` in its `pyproject.toml`)
+        might solve the problem.
+        ********************************************************************************
+        """
+        # TODO: Add a deadline?
+        #       See comment in setuptools.unicode_utils._Utf8EncodingNeeded
+        warnings.warn(msg, PkgResourcesDeprecationWarning, stacklevel=2)
+        with open(file, "r", encoding=fallback_encoding) as f:
+            return f.read()
+
+
+# from jaraco.functools 1.3
+def _call_aside(f, *args, **kwargs):
+    f(*args, **kwargs)
+    return f
+
+
+@_call_aside
+def _initialize(g=globals()):
+    "Set up global resource manager (deliberately not state-saved)"
+    manager = ResourceManager()
+    g['_manager'] = manager
+    g.update(
+        (name, getattr(manager, name))
+        for name in dir(manager)
+        if not name.startswith('_')
+    )
+
+
+@_call_aside
+def _initialize_master_working_set():
+    """
+    Prepare the master working set and make the ``require()``
+    API available.
+
+    This function has explicit effects on the global state
+    of pkg_resources. It is intended to be invoked once at
+    the initialization of this module.
+
+    Invocation by other packages is unsupported and done
+    at their own risk.
+    """
+    working_set = _declare_state('object', 'working_set', WorkingSet._build_master())
+
+    require = working_set.require
+    iter_entry_points = working_set.iter_entry_points
+    add_activation_listener = working_set.subscribe
+    run_script = working_set.run_script
+    # backward compatibility
+    run_main = run_script
+    # Activate all distributions already on sys.path with replace=False and
+    # ensure that all distributions added to the working set in the future
+    # (e.g. by calling ``require()``) will get activated as well,
+    # with higher priority (replace=True).
+    tuple(dist.activate(replace=False) for dist in working_set)
+    add_activation_listener(
+        lambda dist: dist.activate(replace=True),
+        existing=False,
+    )
+    working_set.entries = []
+    # match order
+    list(map(working_set.add_entry, sys.path))
+    globals().update(locals())
+
+
+if TYPE_CHECKING:
+    # All of these are set by the @_call_aside methods above
+    __resource_manager = ResourceManager()  # Won't exist at runtime
+    resource_exists = __resource_manager.resource_exists
+    resource_isdir = __resource_manager.resource_isdir
+    resource_filename = __resource_manager.resource_filename
+    resource_stream = __resource_manager.resource_stream
+    resource_string = __resource_manager.resource_string
+    resource_listdir = __resource_manager.resource_listdir
+    set_extraction_path = __resource_manager.set_extraction_path
+    cleanup_resources = __resource_manager.cleanup_resources
+
+    working_set = WorkingSet()
+    require = working_set.require
+    iter_entry_points = working_set.iter_entry_points
+    add_activation_listener = working_set.subscribe
+    run_script = working_set.run_script
+    run_main = run_script
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pkg_resources/__pycache__/__init__.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pkg_resources/__pycache__/__init__.cpython-312.pyc
new file mode 100644
index 0000000..1832568
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pkg_resources/__pycache__/__init__.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/platformdirs/__init__.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/platformdirs/__init__.py
new file mode 100644
index 0000000..edc21fa
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/platformdirs/__init__.py
@@ -0,0 +1,631 @@
+"""
+Utilities for determining application-specific dirs.
+
+See  for details and usage.
+
+"""
+
+from __future__ import annotations
+
+import os
+import sys
+from typing import TYPE_CHECKING
+
+from .api import PlatformDirsABC
+from .version import __version__
+from .version import __version_tuple__ as __version_info__
+
+if TYPE_CHECKING:
+    from pathlib import Path
+    from typing import Literal
+
+if sys.platform == "win32":
+    from pip._vendor.platformdirs.windows import Windows as _Result
+elif sys.platform == "darwin":
+    from pip._vendor.platformdirs.macos import MacOS as _Result
+else:
+    from pip._vendor.platformdirs.unix import Unix as _Result
+
+
+def _set_platform_dir_class() -> type[PlatformDirsABC]:
+    if os.getenv("ANDROID_DATA") == "/data" and os.getenv("ANDROID_ROOT") == "/system":
+        if os.getenv("SHELL") or os.getenv("PREFIX"):
+            return _Result
+
+        from pip._vendor.platformdirs.android import _android_folder  # noqa: PLC0415
+
+        if _android_folder() is not None:
+            from pip._vendor.platformdirs.android import Android  # noqa: PLC0415
+
+            return Android  # return to avoid redefinition of a result
+
+    return _Result
+
+
+if TYPE_CHECKING:
+    # Work around mypy issue: https://github.com/python/mypy/issues/10962
+    PlatformDirs = _Result
+else:
+    PlatformDirs = _set_platform_dir_class()  #: Currently active platform
+AppDirs = PlatformDirs  #: Backwards compatibility with appdirs
+
+
+def user_data_dir(
+    appname: str | None = None,
+    appauthor: str | None | Literal[False] = None,
+    version: str | None = None,
+    roaming: bool = False,  # noqa: FBT001, FBT002
+    ensure_exists: bool = False,  # noqa: FBT001, FBT002
+) -> str:
+    """
+    :param appname: See `appname `.
+    :param appauthor: See `appauthor `.
+    :param version: See `version `.
+    :param roaming: See `roaming `.
+    :param ensure_exists: See `ensure_exists `.
+    :returns: data directory tied to the user
+    """
+    return PlatformDirs(
+        appname=appname,
+        appauthor=appauthor,
+        version=version,
+        roaming=roaming,
+        ensure_exists=ensure_exists,
+    ).user_data_dir
+
+
+def site_data_dir(
+    appname: str | None = None,
+    appauthor: str | None | Literal[False] = None,
+    version: str | None = None,
+    multipath: bool = False,  # noqa: FBT001, FBT002
+    ensure_exists: bool = False,  # noqa: FBT001, FBT002
+) -> str:
+    """
+    :param appname: See `appname `.
+    :param appauthor: See `appauthor `.
+    :param version: See `version `.
+    :param multipath: See `roaming `.
+    :param ensure_exists: See `ensure_exists `.
+    :returns: data directory shared by users
+    """
+    return PlatformDirs(
+        appname=appname,
+        appauthor=appauthor,
+        version=version,
+        multipath=multipath,
+        ensure_exists=ensure_exists,
+    ).site_data_dir
+
+
+def user_config_dir(
+    appname: str | None = None,
+    appauthor: str | None | Literal[False] = None,
+    version: str | None = None,
+    roaming: bool = False,  # noqa: FBT001, FBT002
+    ensure_exists: bool = False,  # noqa: FBT001, FBT002
+) -> str:
+    """
+    :param appname: See `appname `.
+    :param appauthor: See `appauthor `.
+    :param version: See `version `.
+    :param roaming: See `roaming `.
+    :param ensure_exists: See `ensure_exists `.
+    :returns: config directory tied to the user
+    """
+    return PlatformDirs(
+        appname=appname,
+        appauthor=appauthor,
+        version=version,
+        roaming=roaming,
+        ensure_exists=ensure_exists,
+    ).user_config_dir
+
+
+def site_config_dir(
+    appname: str | None = None,
+    appauthor: str | None | Literal[False] = None,
+    version: str | None = None,
+    multipath: bool = False,  # noqa: FBT001, FBT002
+    ensure_exists: bool = False,  # noqa: FBT001, FBT002
+) -> str:
+    """
+    :param appname: See `appname `.
+    :param appauthor: See `appauthor `.
+    :param version: See `version `.
+    :param multipath: See `roaming `.
+    :param ensure_exists: See `ensure_exists `.
+    :returns: config directory shared by the users
+    """
+    return PlatformDirs(
+        appname=appname,
+        appauthor=appauthor,
+        version=version,
+        multipath=multipath,
+        ensure_exists=ensure_exists,
+    ).site_config_dir
+
+
+def user_cache_dir(
+    appname: str | None = None,
+    appauthor: str | None | Literal[False] = None,
+    version: str | None = None,
+    opinion: bool = True,  # noqa: FBT001, FBT002
+    ensure_exists: bool = False,  # noqa: FBT001, FBT002
+) -> str:
+    """
+    :param appname: See `appname `.
+    :param appauthor: See `appauthor `.
+    :param version: See `version `.
+    :param opinion: See `roaming `.
+    :param ensure_exists: See `ensure_exists `.
+    :returns: cache directory tied to the user
+    """
+    return PlatformDirs(
+        appname=appname,
+        appauthor=appauthor,
+        version=version,
+        opinion=opinion,
+        ensure_exists=ensure_exists,
+    ).user_cache_dir
+
+
+def site_cache_dir(
+    appname: str | None = None,
+    appauthor: str | None | Literal[False] = None,
+    version: str | None = None,
+    opinion: bool = True,  # noqa: FBT001, FBT002
+    ensure_exists: bool = False,  # noqa: FBT001, FBT002
+) -> str:
+    """
+    :param appname: See `appname `.
+    :param appauthor: See `appauthor `.
+    :param version: See `version `.
+    :param opinion: See `opinion `.
+    :param ensure_exists: See `ensure_exists `.
+    :returns: cache directory tied to the user
+    """
+    return PlatformDirs(
+        appname=appname,
+        appauthor=appauthor,
+        version=version,
+        opinion=opinion,
+        ensure_exists=ensure_exists,
+    ).site_cache_dir
+
+
+def user_state_dir(
+    appname: str | None = None,
+    appauthor: str | None | Literal[False] = None,
+    version: str | None = None,
+    roaming: bool = False,  # noqa: FBT001, FBT002
+    ensure_exists: bool = False,  # noqa: FBT001, FBT002
+) -> str:
+    """
+    :param appname: See `appname `.
+    :param appauthor: See `appauthor `.
+    :param version: See `version `.
+    :param roaming: See `roaming `.
+    :param ensure_exists: See `ensure_exists `.
+    :returns: state directory tied to the user
+    """
+    return PlatformDirs(
+        appname=appname,
+        appauthor=appauthor,
+        version=version,
+        roaming=roaming,
+        ensure_exists=ensure_exists,
+    ).user_state_dir
+
+
+def user_log_dir(
+    appname: str | None = None,
+    appauthor: str | None | Literal[False] = None,
+    version: str | None = None,
+    opinion: bool = True,  # noqa: FBT001, FBT002
+    ensure_exists: bool = False,  # noqa: FBT001, FBT002
+) -> str:
+    """
+    :param appname: See `appname `.
+    :param appauthor: See `appauthor `.
+    :param version: See `version `.
+    :param opinion: See `roaming `.
+    :param ensure_exists: See `ensure_exists `.
+    :returns: log directory tied to the user
+    """
+    return PlatformDirs(
+        appname=appname,
+        appauthor=appauthor,
+        version=version,
+        opinion=opinion,
+        ensure_exists=ensure_exists,
+    ).user_log_dir
+
+
+def user_documents_dir() -> str:
+    """:returns: documents directory tied to the user"""
+    return PlatformDirs().user_documents_dir
+
+
+def user_downloads_dir() -> str:
+    """:returns: downloads directory tied to the user"""
+    return PlatformDirs().user_downloads_dir
+
+
+def user_pictures_dir() -> str:
+    """:returns: pictures directory tied to the user"""
+    return PlatformDirs().user_pictures_dir
+
+
+def user_videos_dir() -> str:
+    """:returns: videos directory tied to the user"""
+    return PlatformDirs().user_videos_dir
+
+
+def user_music_dir() -> str:
+    """:returns: music directory tied to the user"""
+    return PlatformDirs().user_music_dir
+
+
+def user_desktop_dir() -> str:
+    """:returns: desktop directory tied to the user"""
+    return PlatformDirs().user_desktop_dir
+
+
+def user_runtime_dir(
+    appname: str | None = None,
+    appauthor: str | None | Literal[False] = None,
+    version: str | None = None,
+    opinion: bool = True,  # noqa: FBT001, FBT002
+    ensure_exists: bool = False,  # noqa: FBT001, FBT002
+) -> str:
+    """
+    :param appname: See `appname `.
+    :param appauthor: See `appauthor `.
+    :param version: See `version `.
+    :param opinion: See `opinion `.
+    :param ensure_exists: See `ensure_exists `.
+    :returns: runtime directory tied to the user
+    """
+    return PlatformDirs(
+        appname=appname,
+        appauthor=appauthor,
+        version=version,
+        opinion=opinion,
+        ensure_exists=ensure_exists,
+    ).user_runtime_dir
+
+
+def site_runtime_dir(
+    appname: str | None = None,
+    appauthor: str | None | Literal[False] = None,
+    version: str | None = None,
+    opinion: bool = True,  # noqa: FBT001, FBT002
+    ensure_exists: bool = False,  # noqa: FBT001, FBT002
+) -> str:
+    """
+    :param appname: See `appname `.
+    :param appauthor: See `appauthor `.
+    :param version: See `version `.
+    :param opinion: See `opinion `.
+    :param ensure_exists: See `ensure_exists `.
+    :returns: runtime directory shared by users
+    """
+    return PlatformDirs(
+        appname=appname,
+        appauthor=appauthor,
+        version=version,
+        opinion=opinion,
+        ensure_exists=ensure_exists,
+    ).site_runtime_dir
+
+
+def user_data_path(
+    appname: str | None = None,
+    appauthor: str | None | Literal[False] = None,
+    version: str | None = None,
+    roaming: bool = False,  # noqa: FBT001, FBT002
+    ensure_exists: bool = False,  # noqa: FBT001, FBT002
+) -> Path:
+    """
+    :param appname: See `appname `.
+    :param appauthor: See `appauthor `.
+    :param version: See `version `.
+    :param roaming: See `roaming `.
+    :param ensure_exists: See `ensure_exists `.
+    :returns: data path tied to the user
+    """
+    return PlatformDirs(
+        appname=appname,
+        appauthor=appauthor,
+        version=version,
+        roaming=roaming,
+        ensure_exists=ensure_exists,
+    ).user_data_path
+
+
+def site_data_path(
+    appname: str | None = None,
+    appauthor: str | None | Literal[False] = None,
+    version: str | None = None,
+    multipath: bool = False,  # noqa: FBT001, FBT002
+    ensure_exists: bool = False,  # noqa: FBT001, FBT002
+) -> Path:
+    """
+    :param appname: See `appname `.
+    :param appauthor: See `appauthor `.
+    :param version: See `version `.
+    :param multipath: See `multipath `.
+    :param ensure_exists: See `ensure_exists `.
+    :returns: data path shared by users
+    """
+    return PlatformDirs(
+        appname=appname,
+        appauthor=appauthor,
+        version=version,
+        multipath=multipath,
+        ensure_exists=ensure_exists,
+    ).site_data_path
+
+
+def user_config_path(
+    appname: str | None = None,
+    appauthor: str | None | Literal[False] = None,
+    version: str | None = None,
+    roaming: bool = False,  # noqa: FBT001, FBT002
+    ensure_exists: bool = False,  # noqa: FBT001, FBT002
+) -> Path:
+    """
+    :param appname: See `appname `.
+    :param appauthor: See `appauthor `.
+    :param version: See `version `.
+    :param roaming: See `roaming `.
+    :param ensure_exists: See `ensure_exists `.
+    :returns: config path tied to the user
+    """
+    return PlatformDirs(
+        appname=appname,
+        appauthor=appauthor,
+        version=version,
+        roaming=roaming,
+        ensure_exists=ensure_exists,
+    ).user_config_path
+
+
+def site_config_path(
+    appname: str | None = None,
+    appauthor: str | None | Literal[False] = None,
+    version: str | None = None,
+    multipath: bool = False,  # noqa: FBT001, FBT002
+    ensure_exists: bool = False,  # noqa: FBT001, FBT002
+) -> Path:
+    """
+    :param appname: See `appname `.
+    :param appauthor: See `appauthor `.
+    :param version: See `version `.
+    :param multipath: See `roaming `.
+    :param ensure_exists: See `ensure_exists `.
+    :returns: config path shared by the users
+    """
+    return PlatformDirs(
+        appname=appname,
+        appauthor=appauthor,
+        version=version,
+        multipath=multipath,
+        ensure_exists=ensure_exists,
+    ).site_config_path
+
+
+def site_cache_path(
+    appname: str | None = None,
+    appauthor: str | None | Literal[False] = None,
+    version: str | None = None,
+    opinion: bool = True,  # noqa: FBT001, FBT002
+    ensure_exists: bool = False,  # noqa: FBT001, FBT002
+) -> Path:
+    """
+    :param appname: See `appname `.
+    :param appauthor: See `appauthor `.
+    :param version: See `version `.
+    :param opinion: See `opinion `.
+    :param ensure_exists: See `ensure_exists `.
+    :returns: cache directory tied to the user
+    """
+    return PlatformDirs(
+        appname=appname,
+        appauthor=appauthor,
+        version=version,
+        opinion=opinion,
+        ensure_exists=ensure_exists,
+    ).site_cache_path
+
+
+def user_cache_path(
+    appname: str | None = None,
+    appauthor: str | None | Literal[False] = None,
+    version: str | None = None,
+    opinion: bool = True,  # noqa: FBT001, FBT002
+    ensure_exists: bool = False,  # noqa: FBT001, FBT002
+) -> Path:
+    """
+    :param appname: See `appname `.
+    :param appauthor: See `appauthor `.
+    :param version: See `version `.
+    :param opinion: See `roaming `.
+    :param ensure_exists: See `ensure_exists `.
+    :returns: cache path tied to the user
+    """
+    return PlatformDirs(
+        appname=appname,
+        appauthor=appauthor,
+        version=version,
+        opinion=opinion,
+        ensure_exists=ensure_exists,
+    ).user_cache_path
+
+
+def user_state_path(
+    appname: str | None = None,
+    appauthor: str | None | Literal[False] = None,
+    version: str | None = None,
+    roaming: bool = False,  # noqa: FBT001, FBT002
+    ensure_exists: bool = False,  # noqa: FBT001, FBT002
+) -> Path:
+    """
+    :param appname: See `appname `.
+    :param appauthor: See `appauthor `.
+    :param version: See `version `.
+    :param roaming: See `roaming `.
+    :param ensure_exists: See `ensure_exists `.
+    :returns: state path tied to the user
+    """
+    return PlatformDirs(
+        appname=appname,
+        appauthor=appauthor,
+        version=version,
+        roaming=roaming,
+        ensure_exists=ensure_exists,
+    ).user_state_path
+
+
+def user_log_path(
+    appname: str | None = None,
+    appauthor: str | None | Literal[False] = None,
+    version: str | None = None,
+    opinion: bool = True,  # noqa: FBT001, FBT002
+    ensure_exists: bool = False,  # noqa: FBT001, FBT002
+) -> Path:
+    """
+    :param appname: See `appname `.
+    :param appauthor: See `appauthor `.
+    :param version: See `version `.
+    :param opinion: See `roaming `.
+    :param ensure_exists: See `ensure_exists `.
+    :returns: log path tied to the user
+    """
+    return PlatformDirs(
+        appname=appname,
+        appauthor=appauthor,
+        version=version,
+        opinion=opinion,
+        ensure_exists=ensure_exists,
+    ).user_log_path
+
+
+def user_documents_path() -> Path:
+    """:returns: documents a path tied to the user"""
+    return PlatformDirs().user_documents_path
+
+
+def user_downloads_path() -> Path:
+    """:returns: downloads path tied to the user"""
+    return PlatformDirs().user_downloads_path
+
+
+def user_pictures_path() -> Path:
+    """:returns: pictures path tied to the user"""
+    return PlatformDirs().user_pictures_path
+
+
+def user_videos_path() -> Path:
+    """:returns: videos path tied to the user"""
+    return PlatformDirs().user_videos_path
+
+
+def user_music_path() -> Path:
+    """:returns: music path tied to the user"""
+    return PlatformDirs().user_music_path
+
+
+def user_desktop_path() -> Path:
+    """:returns: desktop path tied to the user"""
+    return PlatformDirs().user_desktop_path
+
+
+def user_runtime_path(
+    appname: str | None = None,
+    appauthor: str | None | Literal[False] = None,
+    version: str | None = None,
+    opinion: bool = True,  # noqa: FBT001, FBT002
+    ensure_exists: bool = False,  # noqa: FBT001, FBT002
+) -> Path:
+    """
+    :param appname: See `appname `.
+    :param appauthor: See `appauthor `.
+    :param version: See `version `.
+    :param opinion: See `opinion `.
+    :param ensure_exists: See `ensure_exists `.
+    :returns: runtime path tied to the user
+    """
+    return PlatformDirs(
+        appname=appname,
+        appauthor=appauthor,
+        version=version,
+        opinion=opinion,
+        ensure_exists=ensure_exists,
+    ).user_runtime_path
+
+
+def site_runtime_path(
+    appname: str | None = None,
+    appauthor: str | None | Literal[False] = None,
+    version: str | None = None,
+    opinion: bool = True,  # noqa: FBT001, FBT002
+    ensure_exists: bool = False,  # noqa: FBT001, FBT002
+) -> Path:
+    """
+    :param appname: See `appname `.
+    :param appauthor: See `appauthor `.
+    :param version: See `version `.
+    :param opinion: See `opinion `.
+    :param ensure_exists: See `ensure_exists `.
+    :returns: runtime path shared by users
+    """
+    return PlatformDirs(
+        appname=appname,
+        appauthor=appauthor,
+        version=version,
+        opinion=opinion,
+        ensure_exists=ensure_exists,
+    ).site_runtime_path
+
+
+__all__ = [
+    "AppDirs",
+    "PlatformDirs",
+    "PlatformDirsABC",
+    "__version__",
+    "__version_info__",
+    "site_cache_dir",
+    "site_cache_path",
+    "site_config_dir",
+    "site_config_path",
+    "site_data_dir",
+    "site_data_path",
+    "site_runtime_dir",
+    "site_runtime_path",
+    "user_cache_dir",
+    "user_cache_path",
+    "user_config_dir",
+    "user_config_path",
+    "user_data_dir",
+    "user_data_path",
+    "user_desktop_dir",
+    "user_desktop_path",
+    "user_documents_dir",
+    "user_documents_path",
+    "user_downloads_dir",
+    "user_downloads_path",
+    "user_log_dir",
+    "user_log_path",
+    "user_music_dir",
+    "user_music_path",
+    "user_pictures_dir",
+    "user_pictures_path",
+    "user_runtime_dir",
+    "user_runtime_path",
+    "user_state_dir",
+    "user_state_path",
+    "user_videos_dir",
+    "user_videos_path",
+]
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/platformdirs/__main__.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/platformdirs/__main__.py
new file mode 100644
index 0000000..fa8a677
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/platformdirs/__main__.py
@@ -0,0 +1,55 @@
+"""Main entry point."""
+
+from __future__ import annotations
+
+from pip._vendor.platformdirs import PlatformDirs, __version__
+
+PROPS = (
+    "user_data_dir",
+    "user_config_dir",
+    "user_cache_dir",
+    "user_state_dir",
+    "user_log_dir",
+    "user_documents_dir",
+    "user_downloads_dir",
+    "user_pictures_dir",
+    "user_videos_dir",
+    "user_music_dir",
+    "user_runtime_dir",
+    "site_data_dir",
+    "site_config_dir",
+    "site_cache_dir",
+    "site_runtime_dir",
+)
+
+
+def main() -> None:
+    """Run the main entry point."""
+    app_name = "MyApp"
+    app_author = "MyCompany"
+
+    print(f"-- platformdirs {__version__} --")  # noqa: T201
+
+    print("-- app dirs (with optional 'version')")  # noqa: T201
+    dirs = PlatformDirs(app_name, app_author, version="1.0")
+    for prop in PROPS:
+        print(f"{prop}: {getattr(dirs, prop)}")  # noqa: T201
+
+    print("\n-- app dirs (without optional 'version')")  # noqa: T201
+    dirs = PlatformDirs(app_name, app_author)
+    for prop in PROPS:
+        print(f"{prop}: {getattr(dirs, prop)}")  # noqa: T201
+
+    print("\n-- app dirs (without optional 'appauthor')")  # noqa: T201
+    dirs = PlatformDirs(app_name)
+    for prop in PROPS:
+        print(f"{prop}: {getattr(dirs, prop)}")  # noqa: T201
+
+    print("\n-- app dirs (with disabled 'appauthor')")  # noqa: T201
+    dirs = PlatformDirs(app_name, appauthor=False)
+    for prop in PROPS:
+        print(f"{prop}: {getattr(dirs, prop)}")  # noqa: T201
+
+
+if __name__ == "__main__":
+    main()
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/platformdirs/__pycache__/__init__.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/platformdirs/__pycache__/__init__.cpython-312.pyc
new file mode 100644
index 0000000..f189b23
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/platformdirs/__pycache__/__init__.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/platformdirs/__pycache__/__main__.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/platformdirs/__pycache__/__main__.cpython-312.pyc
new file mode 100644
index 0000000..37ae9e3
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/platformdirs/__pycache__/__main__.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/platformdirs/__pycache__/android.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/platformdirs/__pycache__/android.cpython-312.pyc
new file mode 100644
index 0000000..61379ad
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/platformdirs/__pycache__/android.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/platformdirs/__pycache__/api.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/platformdirs/__pycache__/api.cpython-312.pyc
new file mode 100644
index 0000000..aa11394
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/platformdirs/__pycache__/api.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/platformdirs/__pycache__/macos.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/platformdirs/__pycache__/macos.cpython-312.pyc
new file mode 100644
index 0000000..8f02fe1
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/platformdirs/__pycache__/macos.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/platformdirs/__pycache__/unix.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/platformdirs/__pycache__/unix.cpython-312.pyc
new file mode 100644
index 0000000..6b28eb1
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/platformdirs/__pycache__/unix.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/platformdirs/__pycache__/version.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/platformdirs/__pycache__/version.cpython-312.pyc
new file mode 100644
index 0000000..2f5bb6a
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/platformdirs/__pycache__/version.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/platformdirs/__pycache__/windows.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/platformdirs/__pycache__/windows.cpython-312.pyc
new file mode 100644
index 0000000..34b089b
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/platformdirs/__pycache__/windows.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/platformdirs/android.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/platformdirs/android.py
new file mode 100644
index 0000000..7004a85
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/platformdirs/android.py
@@ -0,0 +1,249 @@
+"""Android."""
+
+from __future__ import annotations
+
+import os
+import re
+import sys
+from functools import lru_cache
+from typing import TYPE_CHECKING, cast
+
+from .api import PlatformDirsABC
+
+
+class Android(PlatformDirsABC):
+    """
+    Follows the guidance `from here `_.
+
+    Makes use of the `appname `, `version
+    `, `ensure_exists `.
+
+    """
+
+    @property
+    def user_data_dir(self) -> str:
+        """:return: data directory tied to the user, e.g. ``/data/user///files/``"""
+        return self._append_app_name_and_version(cast(str, _android_folder()), "files")
+
+    @property
+    def site_data_dir(self) -> str:
+        """:return: data directory shared by users, same as `user_data_dir`"""
+        return self.user_data_dir
+
+    @property
+    def user_config_dir(self) -> str:
+        """
+        :return: config directory tied to the user, e.g. \
+        ``/data/user///shared_prefs/``
+        """
+        return self._append_app_name_and_version(cast(str, _android_folder()), "shared_prefs")
+
+    @property
+    def site_config_dir(self) -> str:
+        """:return: config directory shared by the users, same as `user_config_dir`"""
+        return self.user_config_dir
+
+    @property
+    def user_cache_dir(self) -> str:
+        """:return: cache directory tied to the user, e.g.,``/data/user///cache/``"""
+        return self._append_app_name_and_version(cast(str, _android_folder()), "cache")
+
+    @property
+    def site_cache_dir(self) -> str:
+        """:return: cache directory shared by users, same as `user_cache_dir`"""
+        return self.user_cache_dir
+
+    @property
+    def user_state_dir(self) -> str:
+        """:return: state directory tied to the user, same as `user_data_dir`"""
+        return self.user_data_dir
+
+    @property
+    def user_log_dir(self) -> str:
+        """
+        :return: log directory tied to the user, same as `user_cache_dir` if not opinionated else ``log`` in it,
+          e.g. ``/data/user///cache//log``
+        """
+        path = self.user_cache_dir
+        if self.opinion:
+            path = os.path.join(path, "log")  # noqa: PTH118
+        return path
+
+    @property
+    def user_documents_dir(self) -> str:
+        """:return: documents directory tied to the user e.g. ``/storage/emulated/0/Documents``"""
+        return _android_documents_folder()
+
+    @property
+    def user_downloads_dir(self) -> str:
+        """:return: downloads directory tied to the user e.g. ``/storage/emulated/0/Downloads``"""
+        return _android_downloads_folder()
+
+    @property
+    def user_pictures_dir(self) -> str:
+        """:return: pictures directory tied to the user e.g. ``/storage/emulated/0/Pictures``"""
+        return _android_pictures_folder()
+
+    @property
+    def user_videos_dir(self) -> str:
+        """:return: videos directory tied to the user e.g. ``/storage/emulated/0/DCIM/Camera``"""
+        return _android_videos_folder()
+
+    @property
+    def user_music_dir(self) -> str:
+        """:return: music directory tied to the user e.g. ``/storage/emulated/0/Music``"""
+        return _android_music_folder()
+
+    @property
+    def user_desktop_dir(self) -> str:
+        """:return: desktop directory tied to the user e.g. ``/storage/emulated/0/Desktop``"""
+        return "/storage/emulated/0/Desktop"
+
+    @property
+    def user_runtime_dir(self) -> str:
+        """
+        :return: runtime directory tied to the user, same as `user_cache_dir` if not opinionated else ``tmp`` in it,
+          e.g. ``/data/user///cache//tmp``
+        """
+        path = self.user_cache_dir
+        if self.opinion:
+            path = os.path.join(path, "tmp")  # noqa: PTH118
+        return path
+
+    @property
+    def site_runtime_dir(self) -> str:
+        """:return: runtime directory shared by users, same as `user_runtime_dir`"""
+        return self.user_runtime_dir
+
+
+@lru_cache(maxsize=1)
+def _android_folder() -> str | None:  # noqa: C901
+    """:return: base folder for the Android OS or None if it cannot be found"""
+    result: str | None = None
+    # type checker isn't happy with our "import android", just don't do this when type checking see
+    # https://stackoverflow.com/a/61394121
+    if not TYPE_CHECKING:
+        try:
+            # First try to get a path to android app using python4android (if available)...
+            from android import mActivity  # noqa: PLC0415
+
+            context = cast("android.content.Context", mActivity.getApplicationContext())  # noqa: F821
+            result = context.getFilesDir().getParentFile().getAbsolutePath()
+        except Exception:  # noqa: BLE001
+            result = None
+    if result is None:
+        try:
+            # ...and fall back to using plain pyjnius, if python4android isn't available or doesn't deliver any useful
+            # result...
+            from jnius import autoclass  # noqa: PLC0415
+
+            context = autoclass("android.content.Context")
+            result = context.getFilesDir().getParentFile().getAbsolutePath()
+        except Exception:  # noqa: BLE001
+            result = None
+    if result is None:
+        # and if that fails, too, find an android folder looking at path on the sys.path
+        # warning: only works for apps installed under /data, not adopted storage etc.
+        pattern = re.compile(r"/data/(data|user/\d+)/(.+)/files")
+        for path in sys.path:
+            if pattern.match(path):
+                result = path.split("/files")[0]
+                break
+        else:
+            result = None
+    if result is None:
+        # one last try: find an android folder looking at path on the sys.path taking adopted storage paths into
+        # account
+        pattern = re.compile(r"/mnt/expand/[a-fA-F0-9-]{36}/(data|user/\d+)/(.+)/files")
+        for path in sys.path:
+            if pattern.match(path):
+                result = path.split("/files")[0]
+                break
+        else:
+            result = None
+    return result
+
+
+@lru_cache(maxsize=1)
+def _android_documents_folder() -> str:
+    """:return: documents folder for the Android OS"""
+    # Get directories with pyjnius
+    try:
+        from jnius import autoclass  # noqa: PLC0415
+
+        context = autoclass("android.content.Context")
+        environment = autoclass("android.os.Environment")
+        documents_dir: str = context.getExternalFilesDir(environment.DIRECTORY_DOCUMENTS).getAbsolutePath()
+    except Exception:  # noqa: BLE001
+        documents_dir = "/storage/emulated/0/Documents"
+
+    return documents_dir
+
+
+@lru_cache(maxsize=1)
+def _android_downloads_folder() -> str:
+    """:return: downloads folder for the Android OS"""
+    # Get directories with pyjnius
+    try:
+        from jnius import autoclass  # noqa: PLC0415
+
+        context = autoclass("android.content.Context")
+        environment = autoclass("android.os.Environment")
+        downloads_dir: str = context.getExternalFilesDir(environment.DIRECTORY_DOWNLOADS).getAbsolutePath()
+    except Exception:  # noqa: BLE001
+        downloads_dir = "/storage/emulated/0/Downloads"
+
+    return downloads_dir
+
+
+@lru_cache(maxsize=1)
+def _android_pictures_folder() -> str:
+    """:return: pictures folder for the Android OS"""
+    # Get directories with pyjnius
+    try:
+        from jnius import autoclass  # noqa: PLC0415
+
+        context = autoclass("android.content.Context")
+        environment = autoclass("android.os.Environment")
+        pictures_dir: str = context.getExternalFilesDir(environment.DIRECTORY_PICTURES).getAbsolutePath()
+    except Exception:  # noqa: BLE001
+        pictures_dir = "/storage/emulated/0/Pictures"
+
+    return pictures_dir
+
+
+@lru_cache(maxsize=1)
+def _android_videos_folder() -> str:
+    """:return: videos folder for the Android OS"""
+    # Get directories with pyjnius
+    try:
+        from jnius import autoclass  # noqa: PLC0415
+
+        context = autoclass("android.content.Context")
+        environment = autoclass("android.os.Environment")
+        videos_dir: str = context.getExternalFilesDir(environment.DIRECTORY_DCIM).getAbsolutePath()
+    except Exception:  # noqa: BLE001
+        videos_dir = "/storage/emulated/0/DCIM/Camera"
+
+    return videos_dir
+
+
+@lru_cache(maxsize=1)
+def _android_music_folder() -> str:
+    """:return: music folder for the Android OS"""
+    # Get directories with pyjnius
+    try:
+        from jnius import autoclass  # noqa: PLC0415
+
+        context = autoclass("android.content.Context")
+        environment = autoclass("android.os.Environment")
+        music_dir: str = context.getExternalFilesDir(environment.DIRECTORY_MUSIC).getAbsolutePath()
+    except Exception:  # noqa: BLE001
+        music_dir = "/storage/emulated/0/Music"
+
+    return music_dir
+
+
+__all__ = [
+    "Android",
+]
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/platformdirs/api.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/platformdirs/api.py
new file mode 100644
index 0000000..18d660e
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/platformdirs/api.py
@@ -0,0 +1,298 @@
+"""Base API."""
+
+from __future__ import annotations
+
+import os
+from abc import ABC, abstractmethod
+from pathlib import Path
+from typing import TYPE_CHECKING
+
+if TYPE_CHECKING:
+    from typing import Iterator, Literal
+
+
+class PlatformDirsABC(ABC):  # noqa: PLR0904
+    """Abstract base class for platform directories."""
+
+    def __init__(  # noqa: PLR0913, PLR0917
+        self,
+        appname: str | None = None,
+        appauthor: str | None | Literal[False] = None,
+        version: str | None = None,
+        roaming: bool = False,  # noqa: FBT001, FBT002
+        multipath: bool = False,  # noqa: FBT001, FBT002
+        opinion: bool = True,  # noqa: FBT001, FBT002
+        ensure_exists: bool = False,  # noqa: FBT001, FBT002
+    ) -> None:
+        """
+        Create a new platform directory.
+
+        :param appname: See `appname`.
+        :param appauthor: See `appauthor`.
+        :param version: See `version`.
+        :param roaming: See `roaming`.
+        :param multipath: See `multipath`.
+        :param opinion: See `opinion`.
+        :param ensure_exists: See `ensure_exists`.
+
+        """
+        self.appname = appname  #: The name of application.
+        self.appauthor = appauthor
+        """
+        The name of the app author or distributing body for this application.
+
+        Typically, it is the owning company name. Defaults to `appname`. You may pass ``False`` to disable it.
+
+        """
+        self.version = version
+        """
+        An optional version path element to append to the path.
+
+        You might want to use this if you want multiple versions of your app to be able to run independently. If used,
+        this would typically be ``.``.
+
+        """
+        self.roaming = roaming
+        """
+        Whether to use the roaming appdata directory on Windows.
+
+        That means that for users on a Windows network setup for roaming profiles, this user data will be synced on
+        login (see
+        `here `_).
+
+        """
+        self.multipath = multipath
+        """
+        An optional parameter which indicates that the entire list of data dirs should be returned.
+
+        By default, the first item would only be returned.
+
+        """
+        self.opinion = opinion  #: A flag to indicating to use opinionated values.
+        self.ensure_exists = ensure_exists
+        """
+        Optionally create the directory (and any missing parents) upon access if it does not exist.
+
+        By default, no directories are created.
+
+        """
+
+    def _append_app_name_and_version(self, *base: str) -> str:
+        params = list(base[1:])
+        if self.appname:
+            params.append(self.appname)
+            if self.version:
+                params.append(self.version)
+        path = os.path.join(base[0], *params)  # noqa: PTH118
+        self._optionally_create_directory(path)
+        return path
+
+    def _optionally_create_directory(self, path: str) -> None:
+        if self.ensure_exists:
+            Path(path).mkdir(parents=True, exist_ok=True)
+
+    def _first_item_as_path_if_multipath(self, directory: str) -> Path:
+        if self.multipath:
+            # If multipath is True, the first path is returned.
+            directory = directory.split(os.pathsep)[0]
+        return Path(directory)
+
+    @property
+    @abstractmethod
+    def user_data_dir(self) -> str:
+        """:return: data directory tied to the user"""
+
+    @property
+    @abstractmethod
+    def site_data_dir(self) -> str:
+        """:return: data directory shared by users"""
+
+    @property
+    @abstractmethod
+    def user_config_dir(self) -> str:
+        """:return: config directory tied to the user"""
+
+    @property
+    @abstractmethod
+    def site_config_dir(self) -> str:
+        """:return: config directory shared by the users"""
+
+    @property
+    @abstractmethod
+    def user_cache_dir(self) -> str:
+        """:return: cache directory tied to the user"""
+
+    @property
+    @abstractmethod
+    def site_cache_dir(self) -> str:
+        """:return: cache directory shared by users"""
+
+    @property
+    @abstractmethod
+    def user_state_dir(self) -> str:
+        """:return: state directory tied to the user"""
+
+    @property
+    @abstractmethod
+    def user_log_dir(self) -> str:
+        """:return: log directory tied to the user"""
+
+    @property
+    @abstractmethod
+    def user_documents_dir(self) -> str:
+        """:return: documents directory tied to the user"""
+
+    @property
+    @abstractmethod
+    def user_downloads_dir(self) -> str:
+        """:return: downloads directory tied to the user"""
+
+    @property
+    @abstractmethod
+    def user_pictures_dir(self) -> str:
+        """:return: pictures directory tied to the user"""
+
+    @property
+    @abstractmethod
+    def user_videos_dir(self) -> str:
+        """:return: videos directory tied to the user"""
+
+    @property
+    @abstractmethod
+    def user_music_dir(self) -> str:
+        """:return: music directory tied to the user"""
+
+    @property
+    @abstractmethod
+    def user_desktop_dir(self) -> str:
+        """:return: desktop directory tied to the user"""
+
+    @property
+    @abstractmethod
+    def user_runtime_dir(self) -> str:
+        """:return: runtime directory tied to the user"""
+
+    @property
+    @abstractmethod
+    def site_runtime_dir(self) -> str:
+        """:return: runtime directory shared by users"""
+
+    @property
+    def user_data_path(self) -> Path:
+        """:return: data path tied to the user"""
+        return Path(self.user_data_dir)
+
+    @property
+    def site_data_path(self) -> Path:
+        """:return: data path shared by users"""
+        return Path(self.site_data_dir)
+
+    @property
+    def user_config_path(self) -> Path:
+        """:return: config path tied to the user"""
+        return Path(self.user_config_dir)
+
+    @property
+    def site_config_path(self) -> Path:
+        """:return: config path shared by the users"""
+        return Path(self.site_config_dir)
+
+    @property
+    def user_cache_path(self) -> Path:
+        """:return: cache path tied to the user"""
+        return Path(self.user_cache_dir)
+
+    @property
+    def site_cache_path(self) -> Path:
+        """:return: cache path shared by users"""
+        return Path(self.site_cache_dir)
+
+    @property
+    def user_state_path(self) -> Path:
+        """:return: state path tied to the user"""
+        return Path(self.user_state_dir)
+
+    @property
+    def user_log_path(self) -> Path:
+        """:return: log path tied to the user"""
+        return Path(self.user_log_dir)
+
+    @property
+    def user_documents_path(self) -> Path:
+        """:return: documents a path tied to the user"""
+        return Path(self.user_documents_dir)
+
+    @property
+    def user_downloads_path(self) -> Path:
+        """:return: downloads path tied to the user"""
+        return Path(self.user_downloads_dir)
+
+    @property
+    def user_pictures_path(self) -> Path:
+        """:return: pictures path tied to the user"""
+        return Path(self.user_pictures_dir)
+
+    @property
+    def user_videos_path(self) -> Path:
+        """:return: videos path tied to the user"""
+        return Path(self.user_videos_dir)
+
+    @property
+    def user_music_path(self) -> Path:
+        """:return: music path tied to the user"""
+        return Path(self.user_music_dir)
+
+    @property
+    def user_desktop_path(self) -> Path:
+        """:return: desktop path tied to the user"""
+        return Path(self.user_desktop_dir)
+
+    @property
+    def user_runtime_path(self) -> Path:
+        """:return: runtime path tied to the user"""
+        return Path(self.user_runtime_dir)
+
+    @property
+    def site_runtime_path(self) -> Path:
+        """:return: runtime path shared by users"""
+        return Path(self.site_runtime_dir)
+
+    def iter_config_dirs(self) -> Iterator[str]:
+        """:yield: all user and site configuration directories."""
+        yield self.user_config_dir
+        yield self.site_config_dir
+
+    def iter_data_dirs(self) -> Iterator[str]:
+        """:yield: all user and site data directories."""
+        yield self.user_data_dir
+        yield self.site_data_dir
+
+    def iter_cache_dirs(self) -> Iterator[str]:
+        """:yield: all user and site cache directories."""
+        yield self.user_cache_dir
+        yield self.site_cache_dir
+
+    def iter_runtime_dirs(self) -> Iterator[str]:
+        """:yield: all user and site runtime directories."""
+        yield self.user_runtime_dir
+        yield self.site_runtime_dir
+
+    def iter_config_paths(self) -> Iterator[Path]:
+        """:yield: all user and site configuration paths."""
+        for path in self.iter_config_dirs():
+            yield Path(path)
+
+    def iter_data_paths(self) -> Iterator[Path]:
+        """:yield: all user and site data paths."""
+        for path in self.iter_data_dirs():
+            yield Path(path)
+
+    def iter_cache_paths(self) -> Iterator[Path]:
+        """:yield: all user and site cache paths."""
+        for path in self.iter_cache_dirs():
+            yield Path(path)
+
+    def iter_runtime_paths(self) -> Iterator[Path]:
+        """:yield: all user and site runtime paths."""
+        for path in self.iter_runtime_dirs():
+            yield Path(path)
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/platformdirs/macos.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/platformdirs/macos.py
new file mode 100644
index 0000000..e4b0391
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/platformdirs/macos.py
@@ -0,0 +1,144 @@
+"""macOS."""
+
+from __future__ import annotations
+
+import os.path
+import sys
+from typing import TYPE_CHECKING
+
+from .api import PlatformDirsABC
+
+if TYPE_CHECKING:
+    from pathlib import Path
+
+
+class MacOS(PlatformDirsABC):
+    """
+    Platform directories for the macOS operating system.
+
+    Follows the guidance from
+    `Apple documentation `_.
+    Makes use of the `appname `,
+    `version `,
+    `ensure_exists `.
+
+    """
+
+    @property
+    def user_data_dir(self) -> str:
+        """:return: data directory tied to the user, e.g. ``~/Library/Application Support/$appname/$version``"""
+        return self._append_app_name_and_version(os.path.expanduser("~/Library/Application Support"))  # noqa: PTH111
+
+    @property
+    def site_data_dir(self) -> str:
+        """
+        :return: data directory shared by users, e.g. ``/Library/Application Support/$appname/$version``.
+          If we're using a Python binary managed by `Homebrew `_, the directory
+          will be under the Homebrew prefix, e.g. ``/opt/homebrew/share/$appname/$version``.
+          If `multipath ` is enabled, and we're in Homebrew,
+          the response is a multi-path string separated by ":", e.g.
+          ``/opt/homebrew/share/$appname/$version:/Library/Application Support/$appname/$version``
+        """
+        is_homebrew = sys.prefix.startswith("/opt/homebrew")
+        path_list = [self._append_app_name_and_version("/opt/homebrew/share")] if is_homebrew else []
+        path_list.append(self._append_app_name_and_version("/Library/Application Support"))
+        if self.multipath:
+            return os.pathsep.join(path_list)
+        return path_list[0]
+
+    @property
+    def site_data_path(self) -> Path:
+        """:return: data path shared by users. Only return the first item, even if ``multipath`` is set to ``True``"""
+        return self._first_item_as_path_if_multipath(self.site_data_dir)
+
+    @property
+    def user_config_dir(self) -> str:
+        """:return: config directory tied to the user, same as `user_data_dir`"""
+        return self.user_data_dir
+
+    @property
+    def site_config_dir(self) -> str:
+        """:return: config directory shared by the users, same as `site_data_dir`"""
+        return self.site_data_dir
+
+    @property
+    def user_cache_dir(self) -> str:
+        """:return: cache directory tied to the user, e.g. ``~/Library/Caches/$appname/$version``"""
+        return self._append_app_name_and_version(os.path.expanduser("~/Library/Caches"))  # noqa: PTH111
+
+    @property
+    def site_cache_dir(self) -> str:
+        """
+        :return: cache directory shared by users, e.g. ``/Library/Caches/$appname/$version``.
+          If we're using a Python binary managed by `Homebrew `_, the directory
+          will be under the Homebrew prefix, e.g. ``/opt/homebrew/var/cache/$appname/$version``.
+          If `multipath ` is enabled, and we're in Homebrew,
+          the response is a multi-path string separated by ":", e.g.
+          ``/opt/homebrew/var/cache/$appname/$version:/Library/Caches/$appname/$version``
+        """
+        is_homebrew = sys.prefix.startswith("/opt/homebrew")
+        path_list = [self._append_app_name_and_version("/opt/homebrew/var/cache")] if is_homebrew else []
+        path_list.append(self._append_app_name_and_version("/Library/Caches"))
+        if self.multipath:
+            return os.pathsep.join(path_list)
+        return path_list[0]
+
+    @property
+    def site_cache_path(self) -> Path:
+        """:return: cache path shared by users. Only return the first item, even if ``multipath`` is set to ``True``"""
+        return self._first_item_as_path_if_multipath(self.site_cache_dir)
+
+    @property
+    def user_state_dir(self) -> str:
+        """:return: state directory tied to the user, same as `user_data_dir`"""
+        return self.user_data_dir
+
+    @property
+    def user_log_dir(self) -> str:
+        """:return: log directory tied to the user, e.g. ``~/Library/Logs/$appname/$version``"""
+        return self._append_app_name_and_version(os.path.expanduser("~/Library/Logs"))  # noqa: PTH111
+
+    @property
+    def user_documents_dir(self) -> str:
+        """:return: documents directory tied to the user, e.g. ``~/Documents``"""
+        return os.path.expanduser("~/Documents")  # noqa: PTH111
+
+    @property
+    def user_downloads_dir(self) -> str:
+        """:return: downloads directory tied to the user, e.g. ``~/Downloads``"""
+        return os.path.expanduser("~/Downloads")  # noqa: PTH111
+
+    @property
+    def user_pictures_dir(self) -> str:
+        """:return: pictures directory tied to the user, e.g. ``~/Pictures``"""
+        return os.path.expanduser("~/Pictures")  # noqa: PTH111
+
+    @property
+    def user_videos_dir(self) -> str:
+        """:return: videos directory tied to the user, e.g. ``~/Movies``"""
+        return os.path.expanduser("~/Movies")  # noqa: PTH111
+
+    @property
+    def user_music_dir(self) -> str:
+        """:return: music directory tied to the user, e.g. ``~/Music``"""
+        return os.path.expanduser("~/Music")  # noqa: PTH111
+
+    @property
+    def user_desktop_dir(self) -> str:
+        """:return: desktop directory tied to the user, e.g. ``~/Desktop``"""
+        return os.path.expanduser("~/Desktop")  # noqa: PTH111
+
+    @property
+    def user_runtime_dir(self) -> str:
+        """:return: runtime directory tied to the user, e.g. ``~/Library/Caches/TemporaryItems/$appname/$version``"""
+        return self._append_app_name_and_version(os.path.expanduser("~/Library/Caches/TemporaryItems"))  # noqa: PTH111
+
+    @property
+    def site_runtime_dir(self) -> str:
+        """:return: runtime directory shared by users, same as `user_runtime_dir`"""
+        return self.user_runtime_dir
+
+
+__all__ = [
+    "MacOS",
+]
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/platformdirs/py.typed b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/platformdirs/py.typed
new file mode 100644
index 0000000..e69de29
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/platformdirs/unix.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/platformdirs/unix.py
new file mode 100644
index 0000000..f1942e9
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/platformdirs/unix.py
@@ -0,0 +1,269 @@
+"""Unix."""
+
+from __future__ import annotations
+
+import os
+import sys
+from configparser import ConfigParser
+from pathlib import Path
+from typing import Iterator, NoReturn
+
+from .api import PlatformDirsABC
+
+if sys.platform == "win32":
+
+    def getuid() -> NoReturn:
+        msg = "should only be used on Unix"
+        raise RuntimeError(msg)
+
+else:
+    from os import getuid
+
+
+class Unix(PlatformDirsABC):  # noqa: PLR0904
+    """
+    On Unix/Linux, we follow the `XDG Basedir Spec `_.
+
+    The spec allows overriding directories with environment variables. The examples shown are the default values,
+    alongside the name of the environment variable that overrides them. Makes use of the `appname
+    `, `version `, `multipath
+    `, `opinion `, `ensure_exists
+    `.
+
+    """
+
+    @property
+    def user_data_dir(self) -> str:
+        """
+        :return: data directory tied to the user, e.g. ``~/.local/share/$appname/$version`` or
+         ``$XDG_DATA_HOME/$appname/$version``
+        """
+        path = os.environ.get("XDG_DATA_HOME", "")
+        if not path.strip():
+            path = os.path.expanduser("~/.local/share")  # noqa: PTH111
+        return self._append_app_name_and_version(path)
+
+    @property
+    def _site_data_dirs(self) -> list[str]:
+        path = os.environ.get("XDG_DATA_DIRS", "")
+        if not path.strip():
+            path = f"/usr/local/share{os.pathsep}/usr/share"
+        return [self._append_app_name_and_version(p) for p in path.split(os.pathsep)]
+
+    @property
+    def site_data_dir(self) -> str:
+        """
+        :return: data directories shared by users (if `multipath ` is
+         enabled and ``XDG_DATA_DIRS`` is set and a multi path the response is also a multi path separated by the
+         OS path separator), e.g. ``/usr/local/share/$appname/$version`` or ``/usr/share/$appname/$version``
+        """
+        # XDG default for $XDG_DATA_DIRS; only first, if multipath is False
+        dirs = self._site_data_dirs
+        if not self.multipath:
+            return dirs[0]
+        return os.pathsep.join(dirs)
+
+    @property
+    def user_config_dir(self) -> str:
+        """
+        :return: config directory tied to the user, e.g. ``~/.config/$appname/$version`` or
+         ``$XDG_CONFIG_HOME/$appname/$version``
+        """
+        path = os.environ.get("XDG_CONFIG_HOME", "")
+        if not path.strip():
+            path = os.path.expanduser("~/.config")  # noqa: PTH111
+        return self._append_app_name_and_version(path)
+
+    @property
+    def _site_config_dirs(self) -> list[str]:
+        path = os.environ.get("XDG_CONFIG_DIRS", "")
+        if not path.strip():
+            path = "/etc/xdg"
+        return [self._append_app_name_and_version(p) for p in path.split(os.pathsep)]
+
+    @property
+    def site_config_dir(self) -> str:
+        """
+        :return: config directories shared by users (if `multipath `
+         is enabled and ``XDG_CONFIG_DIRS`` is set and a multi path the response is also a multi path separated by
+         the OS path separator), e.g. ``/etc/xdg/$appname/$version``
+        """
+        # XDG default for $XDG_CONFIG_DIRS only first, if multipath is False
+        dirs = self._site_config_dirs
+        if not self.multipath:
+            return dirs[0]
+        return os.pathsep.join(dirs)
+
+    @property
+    def user_cache_dir(self) -> str:
+        """
+        :return: cache directory tied to the user, e.g. ``~/.cache/$appname/$version`` or
+         ``~/$XDG_CACHE_HOME/$appname/$version``
+        """
+        path = os.environ.get("XDG_CACHE_HOME", "")
+        if not path.strip():
+            path = os.path.expanduser("~/.cache")  # noqa: PTH111
+        return self._append_app_name_and_version(path)
+
+    @property
+    def site_cache_dir(self) -> str:
+        """:return: cache directory shared by users, e.g. ``/var/cache/$appname/$version``"""
+        return self._append_app_name_and_version("/var/cache")
+
+    @property
+    def user_state_dir(self) -> str:
+        """
+        :return: state directory tied to the user, e.g. ``~/.local/state/$appname/$version`` or
+         ``$XDG_STATE_HOME/$appname/$version``
+        """
+        path = os.environ.get("XDG_STATE_HOME", "")
+        if not path.strip():
+            path = os.path.expanduser("~/.local/state")  # noqa: PTH111
+        return self._append_app_name_and_version(path)
+
+    @property
+    def user_log_dir(self) -> str:
+        """:return: log directory tied to the user, same as `user_state_dir` if not opinionated else ``log`` in it"""
+        path = self.user_state_dir
+        if self.opinion:
+            path = os.path.join(path, "log")  # noqa: PTH118
+            self._optionally_create_directory(path)
+        return path
+
+    @property
+    def user_documents_dir(self) -> str:
+        """:return: documents directory tied to the user, e.g. ``~/Documents``"""
+        return _get_user_media_dir("XDG_DOCUMENTS_DIR", "~/Documents")
+
+    @property
+    def user_downloads_dir(self) -> str:
+        """:return: downloads directory tied to the user, e.g. ``~/Downloads``"""
+        return _get_user_media_dir("XDG_DOWNLOAD_DIR", "~/Downloads")
+
+    @property
+    def user_pictures_dir(self) -> str:
+        """:return: pictures directory tied to the user, e.g. ``~/Pictures``"""
+        return _get_user_media_dir("XDG_PICTURES_DIR", "~/Pictures")
+
+    @property
+    def user_videos_dir(self) -> str:
+        """:return: videos directory tied to the user, e.g. ``~/Videos``"""
+        return _get_user_media_dir("XDG_VIDEOS_DIR", "~/Videos")
+
+    @property
+    def user_music_dir(self) -> str:
+        """:return: music directory tied to the user, e.g. ``~/Music``"""
+        return _get_user_media_dir("XDG_MUSIC_DIR", "~/Music")
+
+    @property
+    def user_desktop_dir(self) -> str:
+        """:return: desktop directory tied to the user, e.g. ``~/Desktop``"""
+        return _get_user_media_dir("XDG_DESKTOP_DIR", "~/Desktop")
+
+    @property
+    def user_runtime_dir(self) -> str:
+        """
+        :return: runtime directory tied to the user, e.g. ``/run/user/$(id -u)/$appname/$version`` or
+         ``$XDG_RUNTIME_DIR/$appname/$version``.
+
+         For FreeBSD/OpenBSD/NetBSD, it would return ``/var/run/user/$(id -u)/$appname/$version`` if
+         exists, otherwise ``/tmp/runtime-$(id -u)/$appname/$version``, if``$XDG_RUNTIME_DIR``
+         is not set.
+        """
+        path = os.environ.get("XDG_RUNTIME_DIR", "")
+        if not path.strip():
+            if sys.platform.startswith(("freebsd", "openbsd", "netbsd")):
+                path = f"/var/run/user/{getuid()}"
+                if not Path(path).exists():
+                    path = f"/tmp/runtime-{getuid()}"  # noqa: S108
+            else:
+                path = f"/run/user/{getuid()}"
+        return self._append_app_name_and_version(path)
+
+    @property
+    def site_runtime_dir(self) -> str:
+        """
+        :return: runtime directory shared by users, e.g. ``/run/$appname/$version`` or \
+        ``$XDG_RUNTIME_DIR/$appname/$version``.
+
+        Note that this behaves almost exactly like `user_runtime_dir` if ``$XDG_RUNTIME_DIR`` is set, but will
+        fall back to paths associated to the root user instead of a regular logged-in user if it's not set.
+
+        If you wish to ensure that a logged-in root user path is returned e.g. ``/run/user/0``, use `user_runtime_dir`
+        instead.
+
+        For FreeBSD/OpenBSD/NetBSD, it would return ``/var/run/$appname/$version`` if ``$XDG_RUNTIME_DIR`` is not set.
+        """
+        path = os.environ.get("XDG_RUNTIME_DIR", "")
+        if not path.strip():
+            if sys.platform.startswith(("freebsd", "openbsd", "netbsd")):
+                path = "/var/run"
+            else:
+                path = "/run"
+        return self._append_app_name_and_version(path)
+
+    @property
+    def site_data_path(self) -> Path:
+        """:return: data path shared by users. Only return the first item, even if ``multipath`` is set to ``True``"""
+        return self._first_item_as_path_if_multipath(self.site_data_dir)
+
+    @property
+    def site_config_path(self) -> Path:
+        """:return: config path shared by the users, returns the first item, even if ``multipath`` is set to ``True``"""
+        return self._first_item_as_path_if_multipath(self.site_config_dir)
+
+    @property
+    def site_cache_path(self) -> Path:
+        """:return: cache path shared by users. Only return the first item, even if ``multipath`` is set to ``True``"""
+        return self._first_item_as_path_if_multipath(self.site_cache_dir)
+
+    def iter_config_dirs(self) -> Iterator[str]:
+        """:yield: all user and site configuration directories."""
+        yield self.user_config_dir
+        yield from self._site_config_dirs
+
+    def iter_data_dirs(self) -> Iterator[str]:
+        """:yield: all user and site data directories."""
+        yield self.user_data_dir
+        yield from self._site_data_dirs
+
+
+def _get_user_media_dir(env_var: str, fallback_tilde_path: str) -> str:
+    media_dir = _get_user_dirs_folder(env_var)
+    if media_dir is None:
+        media_dir = os.environ.get(env_var, "").strip()
+        if not media_dir:
+            media_dir = os.path.expanduser(fallback_tilde_path)  # noqa: PTH111
+
+    return media_dir
+
+
+def _get_user_dirs_folder(key: str) -> str | None:
+    """
+    Return directory from user-dirs.dirs config file.
+
+    See https://freedesktop.org/wiki/Software/xdg-user-dirs/.
+
+    """
+    user_dirs_config_path = Path(Unix().user_config_dir) / "user-dirs.dirs"
+    if user_dirs_config_path.exists():
+        parser = ConfigParser()
+
+        with user_dirs_config_path.open() as stream:
+            # Add fake section header, so ConfigParser doesn't complain
+            parser.read_string(f"[top]\n{stream.read()}")
+
+        if key not in parser["top"]:
+            return None
+
+        path = parser["top"][key].strip('"')
+        # Handle relative home paths
+        return path.replace("$HOME", os.path.expanduser("~"))  # noqa: PTH111
+
+    return None
+
+
+__all__ = [
+    "Unix",
+]
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/platformdirs/version.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/platformdirs/version.py
new file mode 100644
index 0000000..afb4924
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/platformdirs/version.py
@@ -0,0 +1,16 @@
+# file generated by setuptools_scm
+# don't change, don't track in version control
+TYPE_CHECKING = False
+if TYPE_CHECKING:
+    from typing import Tuple, Union
+    VERSION_TUPLE = Tuple[Union[int, str], ...]
+else:
+    VERSION_TUPLE = object
+
+version: str
+__version__: str
+__version_tuple__: VERSION_TUPLE
+version_tuple: VERSION_TUPLE
+
+__version__ = version = '4.3.6'
+__version_tuple__ = version_tuple = (4, 3, 6)
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/platformdirs/windows.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/platformdirs/windows.py
new file mode 100644
index 0000000..d7bc960
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/platformdirs/windows.py
@@ -0,0 +1,272 @@
+"""Windows."""
+
+from __future__ import annotations
+
+import os
+import sys
+from functools import lru_cache
+from typing import TYPE_CHECKING
+
+from .api import PlatformDirsABC
+
+if TYPE_CHECKING:
+    from collections.abc import Callable
+
+
+class Windows(PlatformDirsABC):
+    """
+    `MSDN on where to store app data files `_.
+
+    Makes use of the `appname `, `appauthor
+    `, `version `, `roaming
+    `, `opinion `, `ensure_exists
+    `.
+
+    """
+
+    @property
+    def user_data_dir(self) -> str:
+        """
+        :return: data directory tied to the user, e.g.
+         ``%USERPROFILE%\\AppData\\Local\\$appauthor\\$appname`` (not roaming) or
+         ``%USERPROFILE%\\AppData\\Roaming\\$appauthor\\$appname`` (roaming)
+        """
+        const = "CSIDL_APPDATA" if self.roaming else "CSIDL_LOCAL_APPDATA"
+        path = os.path.normpath(get_win_folder(const))
+        return self._append_parts(path)
+
+    def _append_parts(self, path: str, *, opinion_value: str | None = None) -> str:
+        params = []
+        if self.appname:
+            if self.appauthor is not False:
+                author = self.appauthor or self.appname
+                params.append(author)
+            params.append(self.appname)
+            if opinion_value is not None and self.opinion:
+                params.append(opinion_value)
+            if self.version:
+                params.append(self.version)
+        path = os.path.join(path, *params)  # noqa: PTH118
+        self._optionally_create_directory(path)
+        return path
+
+    @property
+    def site_data_dir(self) -> str:
+        """:return: data directory shared by users, e.g. ``C:\\ProgramData\\$appauthor\\$appname``"""
+        path = os.path.normpath(get_win_folder("CSIDL_COMMON_APPDATA"))
+        return self._append_parts(path)
+
+    @property
+    def user_config_dir(self) -> str:
+        """:return: config directory tied to the user, same as `user_data_dir`"""
+        return self.user_data_dir
+
+    @property
+    def site_config_dir(self) -> str:
+        """:return: config directory shared by the users, same as `site_data_dir`"""
+        return self.site_data_dir
+
+    @property
+    def user_cache_dir(self) -> str:
+        """
+        :return: cache directory tied to the user (if opinionated with ``Cache`` folder within ``$appname``) e.g.
+         ``%USERPROFILE%\\AppData\\Local\\$appauthor\\$appname\\Cache\\$version``
+        """
+        path = os.path.normpath(get_win_folder("CSIDL_LOCAL_APPDATA"))
+        return self._append_parts(path, opinion_value="Cache")
+
+    @property
+    def site_cache_dir(self) -> str:
+        """:return: cache directory shared by users, e.g. ``C:\\ProgramData\\$appauthor\\$appname\\Cache\\$version``"""
+        path = os.path.normpath(get_win_folder("CSIDL_COMMON_APPDATA"))
+        return self._append_parts(path, opinion_value="Cache")
+
+    @property
+    def user_state_dir(self) -> str:
+        """:return: state directory tied to the user, same as `user_data_dir`"""
+        return self.user_data_dir
+
+    @property
+    def user_log_dir(self) -> str:
+        """:return: log directory tied to the user, same as `user_data_dir` if not opinionated else ``Logs`` in it"""
+        path = self.user_data_dir
+        if self.opinion:
+            path = os.path.join(path, "Logs")  # noqa: PTH118
+            self._optionally_create_directory(path)
+        return path
+
+    @property
+    def user_documents_dir(self) -> str:
+        """:return: documents directory tied to the user e.g. ``%USERPROFILE%\\Documents``"""
+        return os.path.normpath(get_win_folder("CSIDL_PERSONAL"))
+
+    @property
+    def user_downloads_dir(self) -> str:
+        """:return: downloads directory tied to the user e.g. ``%USERPROFILE%\\Downloads``"""
+        return os.path.normpath(get_win_folder("CSIDL_DOWNLOADS"))
+
+    @property
+    def user_pictures_dir(self) -> str:
+        """:return: pictures directory tied to the user e.g. ``%USERPROFILE%\\Pictures``"""
+        return os.path.normpath(get_win_folder("CSIDL_MYPICTURES"))
+
+    @property
+    def user_videos_dir(self) -> str:
+        """:return: videos directory tied to the user e.g. ``%USERPROFILE%\\Videos``"""
+        return os.path.normpath(get_win_folder("CSIDL_MYVIDEO"))
+
+    @property
+    def user_music_dir(self) -> str:
+        """:return: music directory tied to the user e.g. ``%USERPROFILE%\\Music``"""
+        return os.path.normpath(get_win_folder("CSIDL_MYMUSIC"))
+
+    @property
+    def user_desktop_dir(self) -> str:
+        """:return: desktop directory tied to the user, e.g. ``%USERPROFILE%\\Desktop``"""
+        return os.path.normpath(get_win_folder("CSIDL_DESKTOPDIRECTORY"))
+
+    @property
+    def user_runtime_dir(self) -> str:
+        """
+        :return: runtime directory tied to the user, e.g.
+         ``%USERPROFILE%\\AppData\\Local\\Temp\\$appauthor\\$appname``
+        """
+        path = os.path.normpath(os.path.join(get_win_folder("CSIDL_LOCAL_APPDATA"), "Temp"))  # noqa: PTH118
+        return self._append_parts(path)
+
+    @property
+    def site_runtime_dir(self) -> str:
+        """:return: runtime directory shared by users, same as `user_runtime_dir`"""
+        return self.user_runtime_dir
+
+
+def get_win_folder_from_env_vars(csidl_name: str) -> str:
+    """Get folder from environment variables."""
+    result = get_win_folder_if_csidl_name_not_env_var(csidl_name)
+    if result is not None:
+        return result
+
+    env_var_name = {
+        "CSIDL_APPDATA": "APPDATA",
+        "CSIDL_COMMON_APPDATA": "ALLUSERSPROFILE",
+        "CSIDL_LOCAL_APPDATA": "LOCALAPPDATA",
+    }.get(csidl_name)
+    if env_var_name is None:
+        msg = f"Unknown CSIDL name: {csidl_name}"
+        raise ValueError(msg)
+    result = os.environ.get(env_var_name)
+    if result is None:
+        msg = f"Unset environment variable: {env_var_name}"
+        raise ValueError(msg)
+    return result
+
+
+def get_win_folder_if_csidl_name_not_env_var(csidl_name: str) -> str | None:
+    """Get a folder for a CSIDL name that does not exist as an environment variable."""
+    if csidl_name == "CSIDL_PERSONAL":
+        return os.path.join(os.path.normpath(os.environ["USERPROFILE"]), "Documents")  # noqa: PTH118
+
+    if csidl_name == "CSIDL_DOWNLOADS":
+        return os.path.join(os.path.normpath(os.environ["USERPROFILE"]), "Downloads")  # noqa: PTH118
+
+    if csidl_name == "CSIDL_MYPICTURES":
+        return os.path.join(os.path.normpath(os.environ["USERPROFILE"]), "Pictures")  # noqa: PTH118
+
+    if csidl_name == "CSIDL_MYVIDEO":
+        return os.path.join(os.path.normpath(os.environ["USERPROFILE"]), "Videos")  # noqa: PTH118
+
+    if csidl_name == "CSIDL_MYMUSIC":
+        return os.path.join(os.path.normpath(os.environ["USERPROFILE"]), "Music")  # noqa: PTH118
+    return None
+
+
+def get_win_folder_from_registry(csidl_name: str) -> str:
+    """
+    Get folder from the registry.
+
+    This is a fallback technique at best. I'm not sure if using the registry for these guarantees us the correct answer
+    for all CSIDL_* names.
+
+    """
+    shell_folder_name = {
+        "CSIDL_APPDATA": "AppData",
+        "CSIDL_COMMON_APPDATA": "Common AppData",
+        "CSIDL_LOCAL_APPDATA": "Local AppData",
+        "CSIDL_PERSONAL": "Personal",
+        "CSIDL_DOWNLOADS": "{374DE290-123F-4565-9164-39C4925E467B}",
+        "CSIDL_MYPICTURES": "My Pictures",
+        "CSIDL_MYVIDEO": "My Video",
+        "CSIDL_MYMUSIC": "My Music",
+    }.get(csidl_name)
+    if shell_folder_name is None:
+        msg = f"Unknown CSIDL name: {csidl_name}"
+        raise ValueError(msg)
+    if sys.platform != "win32":  # only needed for mypy type checker to know that this code runs only on Windows
+        raise NotImplementedError
+    import winreg  # noqa: PLC0415
+
+    key = winreg.OpenKey(winreg.HKEY_CURRENT_USER, r"Software\Microsoft\Windows\CurrentVersion\Explorer\Shell Folders")
+    directory, _ = winreg.QueryValueEx(key, shell_folder_name)
+    return str(directory)
+
+
+def get_win_folder_via_ctypes(csidl_name: str) -> str:
+    """Get folder with ctypes."""
+    # There is no 'CSIDL_DOWNLOADS'.
+    # Use 'CSIDL_PROFILE' (40) and append the default folder 'Downloads' instead.
+    # https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid
+
+    import ctypes  # noqa: PLC0415
+
+    csidl_const = {
+        "CSIDL_APPDATA": 26,
+        "CSIDL_COMMON_APPDATA": 35,
+        "CSIDL_LOCAL_APPDATA": 28,
+        "CSIDL_PERSONAL": 5,
+        "CSIDL_MYPICTURES": 39,
+        "CSIDL_MYVIDEO": 14,
+        "CSIDL_MYMUSIC": 13,
+        "CSIDL_DOWNLOADS": 40,
+        "CSIDL_DESKTOPDIRECTORY": 16,
+    }.get(csidl_name)
+    if csidl_const is None:
+        msg = f"Unknown CSIDL name: {csidl_name}"
+        raise ValueError(msg)
+
+    buf = ctypes.create_unicode_buffer(1024)
+    windll = getattr(ctypes, "windll")  # noqa: B009 # using getattr to avoid false positive with mypy type checker
+    windll.shell32.SHGetFolderPathW(None, csidl_const, None, 0, buf)
+
+    # Downgrade to short path name if it has high-bit chars.
+    if any(ord(c) > 255 for c in buf):  # noqa: PLR2004
+        buf2 = ctypes.create_unicode_buffer(1024)
+        if windll.kernel32.GetShortPathNameW(buf.value, buf2, 1024):
+            buf = buf2
+
+    if csidl_name == "CSIDL_DOWNLOADS":
+        return os.path.join(buf.value, "Downloads")  # noqa: PTH118
+
+    return buf.value
+
+
+def _pick_get_win_folder() -> Callable[[str], str]:
+    try:
+        import ctypes  # noqa: PLC0415
+    except ImportError:
+        pass
+    else:
+        if hasattr(ctypes, "windll"):
+            return get_win_folder_via_ctypes
+    try:
+        import winreg  # noqa: PLC0415, F401
+    except ImportError:
+        return get_win_folder_from_env_vars
+    else:
+        return get_win_folder_from_registry
+
+
+get_win_folder = lru_cache(maxsize=None)(_pick_get_win_folder())
+
+__all__ = [
+    "Windows",
+]
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/__init__.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/__init__.py
new file mode 100644
index 0000000..60ae9bb
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/__init__.py
@@ -0,0 +1,82 @@
+"""
+    Pygments
+    ~~~~~~~~
+
+    Pygments is a syntax highlighting package written in Python.
+
+    It is a generic syntax highlighter for general use in all kinds of software
+    such as forum systems, wikis or other applications that need to prettify
+    source code. Highlights are:
+
+    * a wide range of common languages and markup formats is supported
+    * special attention is paid to details, increasing quality by a fair amount
+    * support for new languages and formats are added easily
+    * a number of output formats, presently HTML, LaTeX, RTF, SVG, all image
+      formats that PIL supports, and ANSI sequences
+    * it is usable as a command-line tool and as a library
+    * ... and it highlights even Brainfuck!
+
+    The `Pygments master branch`_ is installable with ``easy_install Pygments==dev``.
+
+    .. _Pygments master branch:
+       https://github.com/pygments/pygments/archive/master.zip#egg=Pygments-dev
+
+    :copyright: Copyright 2006-2024 by the Pygments team, see AUTHORS.
+    :license: BSD, see LICENSE for details.
+"""
+from io import StringIO, BytesIO
+
+__version__ = '2.18.0'
+__docformat__ = 'restructuredtext'
+
+__all__ = ['lex', 'format', 'highlight']
+
+
+def lex(code, lexer):
+    """
+    Lex `code` with the `lexer` (must be a `Lexer` instance)
+    and return an iterable of tokens. Currently, this only calls
+    `lexer.get_tokens()`.
+    """
+    try:
+        return lexer.get_tokens(code)
+    except TypeError:
+        # Heuristic to catch a common mistake.
+        from pip._vendor.pygments.lexer import RegexLexer
+        if isinstance(lexer, type) and issubclass(lexer, RegexLexer):
+            raise TypeError('lex() argument must be a lexer instance, '
+                            'not a class')
+        raise
+
+
+def format(tokens, formatter, outfile=None):  # pylint: disable=redefined-builtin
+    """
+    Format ``tokens`` (an iterable of tokens) with the formatter ``formatter``
+    (a `Formatter` instance).
+
+    If ``outfile`` is given and a valid file object (an object with a
+    ``write`` method), the result will be written to it, otherwise it
+    is returned as a string.
+    """
+    try:
+        if not outfile:
+            realoutfile = getattr(formatter, 'encoding', None) and BytesIO() or StringIO()
+            formatter.format(tokens, realoutfile)
+            return realoutfile.getvalue()
+        else:
+            formatter.format(tokens, outfile)
+    except TypeError:
+        # Heuristic to catch a common mistake.
+        from pip._vendor.pygments.formatter import Formatter
+        if isinstance(formatter, type) and issubclass(formatter, Formatter):
+            raise TypeError('format() argument must be a formatter instance, '
+                            'not a class')
+        raise
+
+
+def highlight(code, lexer, formatter, outfile=None):
+    """
+    This is the most high-level highlighting function. It combines `lex` and
+    `format` in one function.
+    """
+    return format(lex(code, lexer), formatter, outfile)
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/__main__.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/__main__.py
new file mode 100644
index 0000000..dcc6e5a
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/__main__.py
@@ -0,0 +1,17 @@
+"""
+    pygments.__main__
+    ~~~~~~~~~~~~~~~~~
+
+    Main entry point for ``python -m pygments``.
+
+    :copyright: Copyright 2006-2024 by the Pygments team, see AUTHORS.
+    :license: BSD, see LICENSE for details.
+"""
+
+import sys
+from pip._vendor.pygments.cmdline import main
+
+try:
+    sys.exit(main(sys.argv))
+except KeyboardInterrupt:
+    sys.exit(1)
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/__pycache__/__init__.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/__pycache__/__init__.cpython-312.pyc
new file mode 100644
index 0000000..bf9eff1
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/__pycache__/__init__.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/__pycache__/__main__.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/__pycache__/__main__.cpython-312.pyc
new file mode 100644
index 0000000..8c4184d
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/__pycache__/__main__.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/__pycache__/cmdline.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/__pycache__/cmdline.cpython-312.pyc
new file mode 100644
index 0000000..3879ac4
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/__pycache__/cmdline.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/__pycache__/console.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/__pycache__/console.cpython-312.pyc
new file mode 100644
index 0000000..1c26d59
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/__pycache__/console.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/__pycache__/filter.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/__pycache__/filter.cpython-312.pyc
new file mode 100644
index 0000000..ab89726
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/__pycache__/filter.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/__pycache__/formatter.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/__pycache__/formatter.cpython-312.pyc
new file mode 100644
index 0000000..50d9d7f
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/__pycache__/formatter.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/__pycache__/lexer.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/__pycache__/lexer.cpython-312.pyc
new file mode 100644
index 0000000..da0b70c
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/__pycache__/lexer.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/__pycache__/modeline.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/__pycache__/modeline.cpython-312.pyc
new file mode 100644
index 0000000..1062e3e
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/__pycache__/modeline.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/__pycache__/plugin.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/__pycache__/plugin.cpython-312.pyc
new file mode 100644
index 0000000..336714a
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/__pycache__/plugin.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/__pycache__/regexopt.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/__pycache__/regexopt.cpython-312.pyc
new file mode 100644
index 0000000..d2053af
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/__pycache__/regexopt.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/__pycache__/scanner.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/__pycache__/scanner.cpython-312.pyc
new file mode 100644
index 0000000..71d668f
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/__pycache__/scanner.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/__pycache__/sphinxext.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/__pycache__/sphinxext.cpython-312.pyc
new file mode 100644
index 0000000..7855900
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/__pycache__/sphinxext.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/__pycache__/style.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/__pycache__/style.cpython-312.pyc
new file mode 100644
index 0000000..4359369
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/__pycache__/style.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/__pycache__/token.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/__pycache__/token.cpython-312.pyc
new file mode 100644
index 0000000..057ffa9
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/__pycache__/token.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/__pycache__/unistring.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/__pycache__/unistring.cpython-312.pyc
new file mode 100644
index 0000000..af36d02
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/__pycache__/unistring.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/__pycache__/util.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/__pycache__/util.cpython-312.pyc
new file mode 100644
index 0000000..c0522e8
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/__pycache__/util.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/cmdline.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/cmdline.py
new file mode 100644
index 0000000..0a7072e
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/cmdline.py
@@ -0,0 +1,668 @@
+"""
+    pygments.cmdline
+    ~~~~~~~~~~~~~~~~
+
+    Command line interface.
+
+    :copyright: Copyright 2006-2024 by the Pygments team, see AUTHORS.
+    :license: BSD, see LICENSE for details.
+"""
+
+import os
+import sys
+import shutil
+import argparse
+from textwrap import dedent
+
+from pip._vendor.pygments import __version__, highlight
+from pip._vendor.pygments.util import ClassNotFound, OptionError, docstring_headline, \
+    guess_decode, guess_decode_from_terminal, terminal_encoding, \
+    UnclosingTextIOWrapper
+from pip._vendor.pygments.lexers import get_all_lexers, get_lexer_by_name, guess_lexer, \
+    load_lexer_from_file, get_lexer_for_filename, find_lexer_class_for_filename
+from pip._vendor.pygments.lexers.special import TextLexer
+from pip._vendor.pygments.formatters.latex import LatexEmbeddedLexer, LatexFormatter
+from pip._vendor.pygments.formatters import get_all_formatters, get_formatter_by_name, \
+    load_formatter_from_file, get_formatter_for_filename, find_formatter_class
+from pip._vendor.pygments.formatters.terminal import TerminalFormatter
+from pip._vendor.pygments.formatters.terminal256 import Terminal256Formatter, TerminalTrueColorFormatter
+from pip._vendor.pygments.filters import get_all_filters, find_filter_class
+from pip._vendor.pygments.styles import get_all_styles, get_style_by_name
+
+
+def _parse_options(o_strs):
+    opts = {}
+    if not o_strs:
+        return opts
+    for o_str in o_strs:
+        if not o_str.strip():
+            continue
+        o_args = o_str.split(',')
+        for o_arg in o_args:
+            o_arg = o_arg.strip()
+            try:
+                o_key, o_val = o_arg.split('=', 1)
+                o_key = o_key.strip()
+                o_val = o_val.strip()
+            except ValueError:
+                opts[o_arg] = True
+            else:
+                opts[o_key] = o_val
+    return opts
+
+
+def _parse_filters(f_strs):
+    filters = []
+    if not f_strs:
+        return filters
+    for f_str in f_strs:
+        if ':' in f_str:
+            fname, fopts = f_str.split(':', 1)
+            filters.append((fname, _parse_options([fopts])))
+        else:
+            filters.append((f_str, {}))
+    return filters
+
+
+def _print_help(what, name):
+    try:
+        if what == 'lexer':
+            cls = get_lexer_by_name(name)
+            print(f"Help on the {cls.name} lexer:")
+            print(dedent(cls.__doc__))
+        elif what == 'formatter':
+            cls = find_formatter_class(name)
+            print(f"Help on the {cls.name} formatter:")
+            print(dedent(cls.__doc__))
+        elif what == 'filter':
+            cls = find_filter_class(name)
+            print(f"Help on the {name} filter:")
+            print(dedent(cls.__doc__))
+        return 0
+    except (AttributeError, ValueError):
+        print(f"{what} not found!", file=sys.stderr)
+        return 1
+
+
+def _print_list(what):
+    if what == 'lexer':
+        print()
+        print("Lexers:")
+        print("~~~~~~~")
+
+        info = []
+        for fullname, names, exts, _ in get_all_lexers():
+            tup = (', '.join(names)+':', fullname,
+                   exts and '(filenames ' + ', '.join(exts) + ')' or '')
+            info.append(tup)
+        info.sort()
+        for i in info:
+            print(('* {}\n    {} {}').format(*i))
+
+    elif what == 'formatter':
+        print()
+        print("Formatters:")
+        print("~~~~~~~~~~~")
+
+        info = []
+        for cls in get_all_formatters():
+            doc = docstring_headline(cls)
+            tup = (', '.join(cls.aliases) + ':', doc, cls.filenames and
+                   '(filenames ' + ', '.join(cls.filenames) + ')' or '')
+            info.append(tup)
+        info.sort()
+        for i in info:
+            print(('* {}\n    {} {}').format(*i))
+
+    elif what == 'filter':
+        print()
+        print("Filters:")
+        print("~~~~~~~~")
+
+        for name in get_all_filters():
+            cls = find_filter_class(name)
+            print("* " + name + ':')
+            print(f"    {docstring_headline(cls)}")
+
+    elif what == 'style':
+        print()
+        print("Styles:")
+        print("~~~~~~~")
+
+        for name in get_all_styles():
+            cls = get_style_by_name(name)
+            print("* " + name + ':')
+            print(f"    {docstring_headline(cls)}")
+
+
+def _print_list_as_json(requested_items):
+    import json
+    result = {}
+    if 'lexer' in requested_items:
+        info = {}
+        for fullname, names, filenames, mimetypes in get_all_lexers():
+            info[fullname] = {
+                'aliases': names,
+                'filenames': filenames,
+                'mimetypes': mimetypes
+            }
+        result['lexers'] = info
+
+    if 'formatter' in requested_items:
+        info = {}
+        for cls in get_all_formatters():
+            doc = docstring_headline(cls)
+            info[cls.name] = {
+                'aliases': cls.aliases,
+                'filenames': cls.filenames,
+                'doc': doc
+            }
+        result['formatters'] = info
+
+    if 'filter' in requested_items:
+        info = {}
+        for name in get_all_filters():
+            cls = find_filter_class(name)
+            info[name] = {
+                'doc': docstring_headline(cls)
+            }
+        result['filters'] = info
+
+    if 'style' in requested_items:
+        info = {}
+        for name in get_all_styles():
+            cls = get_style_by_name(name)
+            info[name] = {
+                'doc': docstring_headline(cls)
+            }
+        result['styles'] = info
+
+    json.dump(result, sys.stdout)
+
+def main_inner(parser, argns):
+    if argns.help:
+        parser.print_help()
+        return 0
+
+    if argns.V:
+        print(f'Pygments version {__version__}, (c) 2006-2024 by Georg Brandl, Matthäus '
+              'Chajdas and contributors.')
+        return 0
+
+    def is_only_option(opt):
+        return not any(v for (k, v) in vars(argns).items() if k != opt)
+
+    # handle ``pygmentize -L``
+    if argns.L is not None:
+        arg_set = set()
+        for k, v in vars(argns).items():
+            if v:
+                arg_set.add(k)
+
+        arg_set.discard('L')
+        arg_set.discard('json')
+
+        if arg_set:
+            parser.print_help(sys.stderr)
+            return 2
+
+        # print version
+        if not argns.json:
+            main(['', '-V'])
+        allowed_types = {'lexer', 'formatter', 'filter', 'style'}
+        largs = [arg.rstrip('s') for arg in argns.L]
+        if any(arg not in allowed_types for arg in largs):
+            parser.print_help(sys.stderr)
+            return 0
+        if not largs:
+            largs = allowed_types
+        if not argns.json:
+            for arg in largs:
+                _print_list(arg)
+        else:
+            _print_list_as_json(largs)
+        return 0
+
+    # handle ``pygmentize -H``
+    if argns.H:
+        if not is_only_option('H'):
+            parser.print_help(sys.stderr)
+            return 2
+        what, name = argns.H
+        if what not in ('lexer', 'formatter', 'filter'):
+            parser.print_help(sys.stderr)
+            return 2
+        return _print_help(what, name)
+
+    # parse -O options
+    parsed_opts = _parse_options(argns.O or [])
+
+    # parse -P options
+    for p_opt in argns.P or []:
+        try:
+            name, value = p_opt.split('=', 1)
+        except ValueError:
+            parsed_opts[p_opt] = True
+        else:
+            parsed_opts[name] = value
+
+    # encodings
+    inencoding = parsed_opts.get('inencoding', parsed_opts.get('encoding'))
+    outencoding = parsed_opts.get('outencoding', parsed_opts.get('encoding'))
+
+    # handle ``pygmentize -N``
+    if argns.N:
+        lexer = find_lexer_class_for_filename(argns.N)
+        if lexer is None:
+            lexer = TextLexer
+
+        print(lexer.aliases[0])
+        return 0
+
+    # handle ``pygmentize -C``
+    if argns.C:
+        inp = sys.stdin.buffer.read()
+        try:
+            lexer = guess_lexer(inp, inencoding=inencoding)
+        except ClassNotFound:
+            lexer = TextLexer
+
+        print(lexer.aliases[0])
+        return 0
+
+    # handle ``pygmentize -S``
+    S_opt = argns.S
+    a_opt = argns.a
+    if S_opt is not None:
+        f_opt = argns.f
+        if not f_opt:
+            parser.print_help(sys.stderr)
+            return 2
+        if argns.l or argns.INPUTFILE:
+            parser.print_help(sys.stderr)
+            return 2
+
+        try:
+            parsed_opts['style'] = S_opt
+            fmter = get_formatter_by_name(f_opt, **parsed_opts)
+        except ClassNotFound as err:
+            print(err, file=sys.stderr)
+            return 1
+
+        print(fmter.get_style_defs(a_opt or ''))
+        return 0
+
+    # if no -S is given, -a is not allowed
+    if argns.a is not None:
+        parser.print_help(sys.stderr)
+        return 2
+
+    # parse -F options
+    F_opts = _parse_filters(argns.F or [])
+
+    # -x: allow custom (eXternal) lexers and formatters
+    allow_custom_lexer_formatter = bool(argns.x)
+
+    # select lexer
+    lexer = None
+
+    # given by name?
+    lexername = argns.l
+    if lexername:
+        # custom lexer, located relative to user's cwd
+        if allow_custom_lexer_formatter and '.py' in lexername:
+            try:
+                filename = None
+                name = None
+                if ':' in lexername:
+                    filename, name = lexername.rsplit(':', 1)
+
+                    if '.py' in name:
+                        # This can happen on Windows: If the lexername is
+                        # C:\lexer.py -- return to normal load path in that case
+                        name = None
+
+                if filename and name:
+                    lexer = load_lexer_from_file(filename, name,
+                                                 **parsed_opts)
+                else:
+                    lexer = load_lexer_from_file(lexername, **parsed_opts)
+            except ClassNotFound as err:
+                print('Error:', err, file=sys.stderr)
+                return 1
+        else:
+            try:
+                lexer = get_lexer_by_name(lexername, **parsed_opts)
+            except (OptionError, ClassNotFound) as err:
+                print('Error:', err, file=sys.stderr)
+                return 1
+
+    # read input code
+    code = None
+
+    if argns.INPUTFILE:
+        if argns.s:
+            print('Error: -s option not usable when input file specified',
+                  file=sys.stderr)
+            return 2
+
+        infn = argns.INPUTFILE
+        try:
+            with open(infn, 'rb') as infp:
+                code = infp.read()
+        except Exception as err:
+            print('Error: cannot read infile:', err, file=sys.stderr)
+            return 1
+        if not inencoding:
+            code, inencoding = guess_decode(code)
+
+        # do we have to guess the lexer?
+        if not lexer:
+            try:
+                lexer = get_lexer_for_filename(infn, code, **parsed_opts)
+            except ClassNotFound as err:
+                if argns.g:
+                    try:
+                        lexer = guess_lexer(code, **parsed_opts)
+                    except ClassNotFound:
+                        lexer = TextLexer(**parsed_opts)
+                else:
+                    print('Error:', err, file=sys.stderr)
+                    return 1
+            except OptionError as err:
+                print('Error:', err, file=sys.stderr)
+                return 1
+
+    elif not argns.s:  # treat stdin as full file (-s support is later)
+        # read code from terminal, always in binary mode since we want to
+        # decode ourselves and be tolerant with it
+        code = sys.stdin.buffer.read()  # use .buffer to get a binary stream
+        if not inencoding:
+            code, inencoding = guess_decode_from_terminal(code, sys.stdin)
+            # else the lexer will do the decoding
+        if not lexer:
+            try:
+                lexer = guess_lexer(code, **parsed_opts)
+            except ClassNotFound:
+                lexer = TextLexer(**parsed_opts)
+
+    else:  # -s option needs a lexer with -l
+        if not lexer:
+            print('Error: when using -s a lexer has to be selected with -l',
+                  file=sys.stderr)
+            return 2
+
+    # process filters
+    for fname, fopts in F_opts:
+        try:
+            lexer.add_filter(fname, **fopts)
+        except ClassNotFound as err:
+            print('Error:', err, file=sys.stderr)
+            return 1
+
+    # select formatter
+    outfn = argns.o
+    fmter = argns.f
+    if fmter:
+        # custom formatter, located relative to user's cwd
+        if allow_custom_lexer_formatter and '.py' in fmter:
+            try:
+                filename = None
+                name = None
+                if ':' in fmter:
+                    # Same logic as above for custom lexer
+                    filename, name = fmter.rsplit(':', 1)
+
+                    if '.py' in name:
+                        name = None
+
+                if filename and name:
+                    fmter = load_formatter_from_file(filename, name,
+                                                     **parsed_opts)
+                else:
+                    fmter = load_formatter_from_file(fmter, **parsed_opts)
+            except ClassNotFound as err:
+                print('Error:', err, file=sys.stderr)
+                return 1
+        else:
+            try:
+                fmter = get_formatter_by_name(fmter, **parsed_opts)
+            except (OptionError, ClassNotFound) as err:
+                print('Error:', err, file=sys.stderr)
+                return 1
+
+    if outfn:
+        if not fmter:
+            try:
+                fmter = get_formatter_for_filename(outfn, **parsed_opts)
+            except (OptionError, ClassNotFound) as err:
+                print('Error:', err, file=sys.stderr)
+                return 1
+        try:
+            outfile = open(outfn, 'wb')
+        except Exception as err:
+            print('Error: cannot open outfile:', err, file=sys.stderr)
+            return 1
+    else:
+        if not fmter:
+            if os.environ.get('COLORTERM','') in ('truecolor', '24bit'):
+                fmter = TerminalTrueColorFormatter(**parsed_opts)
+            elif '256' in os.environ.get('TERM', ''):
+                fmter = Terminal256Formatter(**parsed_opts)
+            else:
+                fmter = TerminalFormatter(**parsed_opts)
+        outfile = sys.stdout.buffer
+
+    # determine output encoding if not explicitly selected
+    if not outencoding:
+        if outfn:
+            # output file? use lexer encoding for now (can still be None)
+            fmter.encoding = inencoding
+        else:
+            # else use terminal encoding
+            fmter.encoding = terminal_encoding(sys.stdout)
+
+    # provide coloring under Windows, if possible
+    if not outfn and sys.platform in ('win32', 'cygwin') and \
+       fmter.name in ('Terminal', 'Terminal256'):  # pragma: no cover
+        # unfortunately colorama doesn't support binary streams on Py3
+        outfile = UnclosingTextIOWrapper(outfile, encoding=fmter.encoding)
+        fmter.encoding = None
+        try:
+            import colorama.initialise
+        except ImportError:
+            pass
+        else:
+            outfile = colorama.initialise.wrap_stream(
+                outfile, convert=None, strip=None, autoreset=False, wrap=True)
+
+    # When using the LaTeX formatter and the option `escapeinside` is
+    # specified, we need a special lexer which collects escaped text
+    # before running the chosen language lexer.
+    escapeinside = parsed_opts.get('escapeinside', '')
+    if len(escapeinside) == 2 and isinstance(fmter, LatexFormatter):
+        left = escapeinside[0]
+        right = escapeinside[1]
+        lexer = LatexEmbeddedLexer(left, right, lexer)
+
+    # ... and do it!
+    if not argns.s:
+        # process whole input as per normal...
+        try:
+            highlight(code, lexer, fmter, outfile)
+        finally:
+            if outfn:
+                outfile.close()
+        return 0
+    else:
+        # line by line processing of stdin (eg: for 'tail -f')...
+        try:
+            while 1:
+                line = sys.stdin.buffer.readline()
+                if not line:
+                    break
+                if not inencoding:
+                    line = guess_decode_from_terminal(line, sys.stdin)[0]
+                highlight(line, lexer, fmter, outfile)
+                if hasattr(outfile, 'flush'):
+                    outfile.flush()
+            return 0
+        except KeyboardInterrupt:  # pragma: no cover
+            return 0
+        finally:
+            if outfn:
+                outfile.close()
+
+
+class HelpFormatter(argparse.HelpFormatter):
+    def __init__(self, prog, indent_increment=2, max_help_position=16, width=None):
+        if width is None:
+            try:
+                width = shutil.get_terminal_size().columns - 2
+            except Exception:
+                pass
+        argparse.HelpFormatter.__init__(self, prog, indent_increment,
+                                        max_help_position, width)
+
+
+def main(args=sys.argv):
+    """
+    Main command line entry point.
+    """
+    desc = "Highlight an input file and write the result to an output file."
+    parser = argparse.ArgumentParser(description=desc, add_help=False,
+                                     formatter_class=HelpFormatter)
+
+    operation = parser.add_argument_group('Main operation')
+    lexersel = operation.add_mutually_exclusive_group()
+    lexersel.add_argument(
+        '-l', metavar='LEXER',
+        help='Specify the lexer to use.  (Query names with -L.)  If not '
+        'given and -g is not present, the lexer is guessed from the filename.')
+    lexersel.add_argument(
+        '-g', action='store_true',
+        help='Guess the lexer from the file contents, or pass through '
+        'as plain text if nothing can be guessed.')
+    operation.add_argument(
+        '-F', metavar='FILTER[:options]', action='append',
+        help='Add a filter to the token stream.  (Query names with -L.) '
+        'Filter options are given after a colon if necessary.')
+    operation.add_argument(
+        '-f', metavar='FORMATTER',
+        help='Specify the formatter to use.  (Query names with -L.) '
+        'If not given, the formatter is guessed from the output filename, '
+        'and defaults to the terminal formatter if the output is to the '
+        'terminal or an unknown file extension.')
+    operation.add_argument(
+        '-O', metavar='OPTION=value[,OPTION=value,...]', action='append',
+        help='Give options to the lexer and formatter as a comma-separated '
+        'list of key-value pairs. '
+        'Example: `-O bg=light,python=cool`.')
+    operation.add_argument(
+        '-P', metavar='OPTION=value', action='append',
+        help='Give a single option to the lexer and formatter - with this '
+        'you can pass options whose value contains commas and equal signs. '
+        'Example: `-P "heading=Pygments, the Python highlighter"`.')
+    operation.add_argument(
+        '-o', metavar='OUTPUTFILE',
+        help='Where to write the output.  Defaults to standard output.')
+
+    operation.add_argument(
+        'INPUTFILE', nargs='?',
+        help='Where to read the input.  Defaults to standard input.')
+
+    flags = parser.add_argument_group('Operation flags')
+    flags.add_argument(
+        '-v', action='store_true',
+        help='Print a detailed traceback on unhandled exceptions, which '
+        'is useful for debugging and bug reports.')
+    flags.add_argument(
+        '-s', action='store_true',
+        help='Process lines one at a time until EOF, rather than waiting to '
+        'process the entire file.  This only works for stdin, only for lexers '
+        'with no line-spanning constructs, and is intended for streaming '
+        'input such as you get from `tail -f`. '
+        'Example usage: `tail -f sql.log | pygmentize -s -l sql`.')
+    flags.add_argument(
+        '-x', action='store_true',
+        help='Allow custom lexers and formatters to be loaded from a .py file '
+        'relative to the current working directory. For example, '
+        '`-l ./customlexer.py -x`. By default, this option expects a file '
+        'with a class named CustomLexer or CustomFormatter; you can also '
+        'specify your own class name with a colon (`-l ./lexer.py:MyLexer`). '
+        'Users should be very careful not to use this option with untrusted '
+        'files, because it will import and run them.')
+    flags.add_argument('--json', help='Output as JSON. This can '
+        'be only used in conjunction with -L.',
+        default=False,
+        action='store_true')
+
+    special_modes_group = parser.add_argument_group(
+        'Special modes - do not do any highlighting')
+    special_modes = special_modes_group.add_mutually_exclusive_group()
+    special_modes.add_argument(
+        '-S', metavar='STYLE -f formatter',
+        help='Print style definitions for STYLE for a formatter '
+        'given with -f. The argument given by -a is formatter '
+        'dependent.')
+    special_modes.add_argument(
+        '-L', nargs='*', metavar='WHAT',
+        help='List lexers, formatters, styles or filters -- '
+        'give additional arguments for the thing(s) you want to list '
+        '(e.g. "styles"), or omit them to list everything.')
+    special_modes.add_argument(
+        '-N', metavar='FILENAME',
+        help='Guess and print out a lexer name based solely on the given '
+        'filename. Does not take input or highlight anything. If no specific '
+        'lexer can be determined, "text" is printed.')
+    special_modes.add_argument(
+        '-C', action='store_true',
+        help='Like -N, but print out a lexer name based solely on '
+        'a given content from standard input.')
+    special_modes.add_argument(
+        '-H', action='store', nargs=2, metavar=('NAME', 'TYPE'),
+        help='Print detailed help for the object  of type , '
+        'where  is one of "lexer", "formatter" or "filter".')
+    special_modes.add_argument(
+        '-V', action='store_true',
+        help='Print the package version.')
+    special_modes.add_argument(
+        '-h', '--help', action='store_true',
+        help='Print this help.')
+    special_modes_group.add_argument(
+        '-a', metavar='ARG',
+        help='Formatter-specific additional argument for the -S (print '
+        'style sheet) mode.')
+
+    argns = parser.parse_args(args[1:])
+
+    try:
+        return main_inner(parser, argns)
+    except BrokenPipeError:
+        # someone closed our stdout, e.g. by quitting a pager.
+        return 0
+    except Exception:
+        if argns.v:
+            print(file=sys.stderr)
+            print('*' * 65, file=sys.stderr)
+            print('An unhandled exception occurred while highlighting.',
+                  file=sys.stderr)
+            print('Please report the whole traceback to the issue tracker at',
+                  file=sys.stderr)
+            print('.',
+                  file=sys.stderr)
+            print('*' * 65, file=sys.stderr)
+            print(file=sys.stderr)
+            raise
+        import traceback
+        info = traceback.format_exception(*sys.exc_info())
+        msg = info[-1].strip()
+        if len(info) >= 3:
+            # extract relevant file and position info
+            msg += '\n   (f{})'.format(info[-2].split('\n')[0].strip()[1:])
+        print(file=sys.stderr)
+        print('*** Error while highlighting:', file=sys.stderr)
+        print(msg, file=sys.stderr)
+        print('*** If this is a bug you want to report, please rerun with -v.',
+              file=sys.stderr)
+        return 1
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/console.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/console.py
new file mode 100644
index 0000000..4c1a062
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/console.py
@@ -0,0 +1,70 @@
+"""
+    pygments.console
+    ~~~~~~~~~~~~~~~~
+
+    Format colored console output.
+
+    :copyright: Copyright 2006-2024 by the Pygments team, see AUTHORS.
+    :license: BSD, see LICENSE for details.
+"""
+
+esc = "\x1b["
+
+codes = {}
+codes[""] = ""
+codes["reset"] = esc + "39;49;00m"
+
+codes["bold"] = esc + "01m"
+codes["faint"] = esc + "02m"
+codes["standout"] = esc + "03m"
+codes["underline"] = esc + "04m"
+codes["blink"] = esc + "05m"
+codes["overline"] = esc + "06m"
+
+dark_colors = ["black", "red", "green", "yellow", "blue",
+               "magenta", "cyan", "gray"]
+light_colors = ["brightblack", "brightred", "brightgreen", "brightyellow", "brightblue",
+                "brightmagenta", "brightcyan", "white"]
+
+x = 30
+for dark, light in zip(dark_colors, light_colors):
+    codes[dark] = esc + "%im" % x
+    codes[light] = esc + "%im" % (60 + x)
+    x += 1
+
+del dark, light, x
+
+codes["white"] = codes["bold"]
+
+
+def reset_color():
+    return codes["reset"]
+
+
+def colorize(color_key, text):
+    return codes[color_key] + text + codes["reset"]
+
+
+def ansiformat(attr, text):
+    """
+    Format ``text`` with a color and/or some attributes::
+
+        color       normal color
+        *color*     bold color
+        _color_     underlined color
+        +color+     blinking color
+    """
+    result = []
+    if attr[:1] == attr[-1:] == '+':
+        result.append(codes['blink'])
+        attr = attr[1:-1]
+    if attr[:1] == attr[-1:] == '*':
+        result.append(codes['bold'])
+        attr = attr[1:-1]
+    if attr[:1] == attr[-1:] == '_':
+        result.append(codes['underline'])
+        attr = attr[1:-1]
+    result.append(codes[attr])
+    result.append(text)
+    result.append(codes['reset'])
+    return ''.join(result)
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/filter.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/filter.py
new file mode 100644
index 0000000..aa6f760
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/filter.py
@@ -0,0 +1,70 @@
+"""
+    pygments.filter
+    ~~~~~~~~~~~~~~~
+
+    Module that implements the default filter.
+
+    :copyright: Copyright 2006-2024 by the Pygments team, see AUTHORS.
+    :license: BSD, see LICENSE for details.
+"""
+
+
+def apply_filters(stream, filters, lexer=None):
+    """
+    Use this method to apply an iterable of filters to
+    a stream. If lexer is given it's forwarded to the
+    filter, otherwise the filter receives `None`.
+    """
+    def _apply(filter_, stream):
+        yield from filter_.filter(lexer, stream)
+    for filter_ in filters:
+        stream = _apply(filter_, stream)
+    return stream
+
+
+def simplefilter(f):
+    """
+    Decorator that converts a function into a filter::
+
+        @simplefilter
+        def lowercase(self, lexer, stream, options):
+            for ttype, value in stream:
+                yield ttype, value.lower()
+    """
+    return type(f.__name__, (FunctionFilter,), {
+        '__module__': getattr(f, '__module__'),
+        '__doc__': f.__doc__,
+        'function': f,
+    })
+
+
+class Filter:
+    """
+    Default filter. Subclass this class or use the `simplefilter`
+    decorator to create own filters.
+    """
+
+    def __init__(self, **options):
+        self.options = options
+
+    def filter(self, lexer, stream):
+        raise NotImplementedError()
+
+
+class FunctionFilter(Filter):
+    """
+    Abstract class used by `simplefilter` to create simple
+    function filters on the fly. The `simplefilter` decorator
+    automatically creates subclasses of this class for
+    functions passed to it.
+    """
+    function = None
+
+    def __init__(self, **options):
+        if not hasattr(self, 'function'):
+            raise TypeError(f'{self.__class__.__name__!r} used without bound function')
+        Filter.__init__(self, **options)
+
+    def filter(self, lexer, stream):
+        # pylint: disable=not-callable
+        yield from self.function(lexer, stream, self.options)
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/filters/__init__.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/filters/__init__.py
new file mode 100644
index 0000000..9255ca2
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/filters/__init__.py
@@ -0,0 +1,940 @@
+"""
+    pygments.filters
+    ~~~~~~~~~~~~~~~~
+
+    Module containing filter lookup functions and default
+    filters.
+
+    :copyright: Copyright 2006-2024 by the Pygments team, see AUTHORS.
+    :license: BSD, see LICENSE for details.
+"""
+
+import re
+
+from pip._vendor.pygments.token import String, Comment, Keyword, Name, Error, Whitespace, \
+    string_to_tokentype
+from pip._vendor.pygments.filter import Filter
+from pip._vendor.pygments.util import get_list_opt, get_int_opt, get_bool_opt, \
+    get_choice_opt, ClassNotFound, OptionError
+from pip._vendor.pygments.plugin import find_plugin_filters
+
+
+def find_filter_class(filtername):
+    """Lookup a filter by name. Return None if not found."""
+    if filtername in FILTERS:
+        return FILTERS[filtername]
+    for name, cls in find_plugin_filters():
+        if name == filtername:
+            return cls
+    return None
+
+
+def get_filter_by_name(filtername, **options):
+    """Return an instantiated filter.
+
+    Options are passed to the filter initializer if wanted.
+    Raise a ClassNotFound if not found.
+    """
+    cls = find_filter_class(filtername)
+    if cls:
+        return cls(**options)
+    else:
+        raise ClassNotFound(f'filter {filtername!r} not found')
+
+
+def get_all_filters():
+    """Return a generator of all filter names."""
+    yield from FILTERS
+    for name, _ in find_plugin_filters():
+        yield name
+
+
+def _replace_special(ttype, value, regex, specialttype,
+                     replacefunc=lambda x: x):
+    last = 0
+    for match in regex.finditer(value):
+        start, end = match.start(), match.end()
+        if start != last:
+            yield ttype, value[last:start]
+        yield specialttype, replacefunc(value[start:end])
+        last = end
+    if last != len(value):
+        yield ttype, value[last:]
+
+
+class CodeTagFilter(Filter):
+    """Highlight special code tags in comments and docstrings.
+
+    Options accepted:
+
+    `codetags` : list of strings
+       A list of strings that are flagged as code tags.  The default is to
+       highlight ``XXX``, ``TODO``, ``FIXME``, ``BUG`` and ``NOTE``.
+
+    .. versionchanged:: 2.13
+       Now recognizes ``FIXME`` by default.
+    """
+
+    def __init__(self, **options):
+        Filter.__init__(self, **options)
+        tags = get_list_opt(options, 'codetags',
+                            ['XXX', 'TODO', 'FIXME', 'BUG', 'NOTE'])
+        self.tag_re = re.compile(r'\b({})\b'.format('|'.join([
+            re.escape(tag) for tag in tags if tag
+        ])))
+
+    def filter(self, lexer, stream):
+        regex = self.tag_re
+        for ttype, value in stream:
+            if ttype in String.Doc or \
+               ttype in Comment and \
+               ttype not in Comment.Preproc:
+                yield from _replace_special(ttype, value, regex, Comment.Special)
+            else:
+                yield ttype, value
+
+
+class SymbolFilter(Filter):
+    """Convert mathematical symbols such as \\ in Isabelle
+    or \\longrightarrow in LaTeX into Unicode characters.
+
+    This is mostly useful for HTML or console output when you want to
+    approximate the source rendering you'd see in an IDE.
+
+    Options accepted:
+
+    `lang` : string
+       The symbol language. Must be one of ``'isabelle'`` or
+       ``'latex'``.  The default is ``'isabelle'``.
+    """
+
+    latex_symbols = {
+        '\\alpha'                : '\U000003b1',
+        '\\beta'                 : '\U000003b2',
+        '\\gamma'                : '\U000003b3',
+        '\\delta'                : '\U000003b4',
+        '\\varepsilon'           : '\U000003b5',
+        '\\zeta'                 : '\U000003b6',
+        '\\eta'                  : '\U000003b7',
+        '\\vartheta'             : '\U000003b8',
+        '\\iota'                 : '\U000003b9',
+        '\\kappa'                : '\U000003ba',
+        '\\lambda'               : '\U000003bb',
+        '\\mu'                   : '\U000003bc',
+        '\\nu'                   : '\U000003bd',
+        '\\xi'                   : '\U000003be',
+        '\\pi'                   : '\U000003c0',
+        '\\varrho'               : '\U000003c1',
+        '\\sigma'                : '\U000003c3',
+        '\\tau'                  : '\U000003c4',
+        '\\upsilon'              : '\U000003c5',
+        '\\varphi'               : '\U000003c6',
+        '\\chi'                  : '\U000003c7',
+        '\\psi'                  : '\U000003c8',
+        '\\omega'                : '\U000003c9',
+        '\\Gamma'                : '\U00000393',
+        '\\Delta'                : '\U00000394',
+        '\\Theta'                : '\U00000398',
+        '\\Lambda'               : '\U0000039b',
+        '\\Xi'                   : '\U0000039e',
+        '\\Pi'                   : '\U000003a0',
+        '\\Sigma'                : '\U000003a3',
+        '\\Upsilon'              : '\U000003a5',
+        '\\Phi'                  : '\U000003a6',
+        '\\Psi'                  : '\U000003a8',
+        '\\Omega'                : '\U000003a9',
+        '\\leftarrow'            : '\U00002190',
+        '\\longleftarrow'        : '\U000027f5',
+        '\\rightarrow'           : '\U00002192',
+        '\\longrightarrow'       : '\U000027f6',
+        '\\Leftarrow'            : '\U000021d0',
+        '\\Longleftarrow'        : '\U000027f8',
+        '\\Rightarrow'           : '\U000021d2',
+        '\\Longrightarrow'       : '\U000027f9',
+        '\\leftrightarrow'       : '\U00002194',
+        '\\longleftrightarrow'   : '\U000027f7',
+        '\\Leftrightarrow'       : '\U000021d4',
+        '\\Longleftrightarrow'   : '\U000027fa',
+        '\\mapsto'               : '\U000021a6',
+        '\\longmapsto'           : '\U000027fc',
+        '\\relbar'               : '\U00002500',
+        '\\Relbar'               : '\U00002550',
+        '\\hookleftarrow'        : '\U000021a9',
+        '\\hookrightarrow'       : '\U000021aa',
+        '\\leftharpoondown'      : '\U000021bd',
+        '\\rightharpoondown'     : '\U000021c1',
+        '\\leftharpoonup'        : '\U000021bc',
+        '\\rightharpoonup'       : '\U000021c0',
+        '\\rightleftharpoons'    : '\U000021cc',
+        '\\leadsto'              : '\U0000219d',
+        '\\downharpoonleft'      : '\U000021c3',
+        '\\downharpoonright'     : '\U000021c2',
+        '\\upharpoonleft'        : '\U000021bf',
+        '\\upharpoonright'       : '\U000021be',
+        '\\restriction'          : '\U000021be',
+        '\\uparrow'              : '\U00002191',
+        '\\Uparrow'              : '\U000021d1',
+        '\\downarrow'            : '\U00002193',
+        '\\Downarrow'            : '\U000021d3',
+        '\\updownarrow'          : '\U00002195',
+        '\\Updownarrow'          : '\U000021d5',
+        '\\langle'               : '\U000027e8',
+        '\\rangle'               : '\U000027e9',
+        '\\lceil'                : '\U00002308',
+        '\\rceil'                : '\U00002309',
+        '\\lfloor'               : '\U0000230a',
+        '\\rfloor'               : '\U0000230b',
+        '\\flqq'                 : '\U000000ab',
+        '\\frqq'                 : '\U000000bb',
+        '\\bot'                  : '\U000022a5',
+        '\\top'                  : '\U000022a4',
+        '\\wedge'                : '\U00002227',
+        '\\bigwedge'             : '\U000022c0',
+        '\\vee'                  : '\U00002228',
+        '\\bigvee'               : '\U000022c1',
+        '\\forall'               : '\U00002200',
+        '\\exists'               : '\U00002203',
+        '\\nexists'              : '\U00002204',
+        '\\neg'                  : '\U000000ac',
+        '\\Box'                  : '\U000025a1',
+        '\\Diamond'              : '\U000025c7',
+        '\\vdash'                : '\U000022a2',
+        '\\models'               : '\U000022a8',
+        '\\dashv'                : '\U000022a3',
+        '\\surd'                 : '\U0000221a',
+        '\\le'                   : '\U00002264',
+        '\\ge'                   : '\U00002265',
+        '\\ll'                   : '\U0000226a',
+        '\\gg'                   : '\U0000226b',
+        '\\lesssim'              : '\U00002272',
+        '\\gtrsim'               : '\U00002273',
+        '\\lessapprox'           : '\U00002a85',
+        '\\gtrapprox'            : '\U00002a86',
+        '\\in'                   : '\U00002208',
+        '\\notin'                : '\U00002209',
+        '\\subset'               : '\U00002282',
+        '\\supset'               : '\U00002283',
+        '\\subseteq'             : '\U00002286',
+        '\\supseteq'             : '\U00002287',
+        '\\sqsubset'             : '\U0000228f',
+        '\\sqsupset'             : '\U00002290',
+        '\\sqsubseteq'           : '\U00002291',
+        '\\sqsupseteq'           : '\U00002292',
+        '\\cap'                  : '\U00002229',
+        '\\bigcap'               : '\U000022c2',
+        '\\cup'                  : '\U0000222a',
+        '\\bigcup'               : '\U000022c3',
+        '\\sqcup'                : '\U00002294',
+        '\\bigsqcup'             : '\U00002a06',
+        '\\sqcap'                : '\U00002293',
+        '\\Bigsqcap'             : '\U00002a05',
+        '\\setminus'             : '\U00002216',
+        '\\propto'               : '\U0000221d',
+        '\\uplus'                : '\U0000228e',
+        '\\bigplus'              : '\U00002a04',
+        '\\sim'                  : '\U0000223c',
+        '\\doteq'                : '\U00002250',
+        '\\simeq'                : '\U00002243',
+        '\\approx'               : '\U00002248',
+        '\\asymp'                : '\U0000224d',
+        '\\cong'                 : '\U00002245',
+        '\\equiv'                : '\U00002261',
+        '\\Join'                 : '\U000022c8',
+        '\\bowtie'               : '\U00002a1d',
+        '\\prec'                 : '\U0000227a',
+        '\\succ'                 : '\U0000227b',
+        '\\preceq'               : '\U0000227c',
+        '\\succeq'               : '\U0000227d',
+        '\\parallel'             : '\U00002225',
+        '\\mid'                  : '\U000000a6',
+        '\\pm'                   : '\U000000b1',
+        '\\mp'                   : '\U00002213',
+        '\\times'                : '\U000000d7',
+        '\\div'                  : '\U000000f7',
+        '\\cdot'                 : '\U000022c5',
+        '\\star'                 : '\U000022c6',
+        '\\circ'                 : '\U00002218',
+        '\\dagger'               : '\U00002020',
+        '\\ddagger'              : '\U00002021',
+        '\\lhd'                  : '\U000022b2',
+        '\\rhd'                  : '\U000022b3',
+        '\\unlhd'                : '\U000022b4',
+        '\\unrhd'                : '\U000022b5',
+        '\\triangleleft'         : '\U000025c3',
+        '\\triangleright'        : '\U000025b9',
+        '\\triangle'             : '\U000025b3',
+        '\\triangleq'            : '\U0000225c',
+        '\\oplus'                : '\U00002295',
+        '\\bigoplus'             : '\U00002a01',
+        '\\otimes'               : '\U00002297',
+        '\\bigotimes'            : '\U00002a02',
+        '\\odot'                 : '\U00002299',
+        '\\bigodot'              : '\U00002a00',
+        '\\ominus'               : '\U00002296',
+        '\\oslash'               : '\U00002298',
+        '\\dots'                 : '\U00002026',
+        '\\cdots'                : '\U000022ef',
+        '\\sum'                  : '\U00002211',
+        '\\prod'                 : '\U0000220f',
+        '\\coprod'               : '\U00002210',
+        '\\infty'                : '\U0000221e',
+        '\\int'                  : '\U0000222b',
+        '\\oint'                 : '\U0000222e',
+        '\\clubsuit'             : '\U00002663',
+        '\\diamondsuit'          : '\U00002662',
+        '\\heartsuit'            : '\U00002661',
+        '\\spadesuit'            : '\U00002660',
+        '\\aleph'                : '\U00002135',
+        '\\emptyset'             : '\U00002205',
+        '\\nabla'                : '\U00002207',
+        '\\partial'              : '\U00002202',
+        '\\flat'                 : '\U0000266d',
+        '\\natural'              : '\U0000266e',
+        '\\sharp'                : '\U0000266f',
+        '\\angle'                : '\U00002220',
+        '\\copyright'            : '\U000000a9',
+        '\\textregistered'       : '\U000000ae',
+        '\\textonequarter'       : '\U000000bc',
+        '\\textonehalf'          : '\U000000bd',
+        '\\textthreequarters'    : '\U000000be',
+        '\\textordfeminine'      : '\U000000aa',
+        '\\textordmasculine'     : '\U000000ba',
+        '\\euro'                 : '\U000020ac',
+        '\\pounds'               : '\U000000a3',
+        '\\yen'                  : '\U000000a5',
+        '\\textcent'             : '\U000000a2',
+        '\\textcurrency'         : '\U000000a4',
+        '\\textdegree'           : '\U000000b0',
+    }
+
+    isabelle_symbols = {
+        '\\'                 : '\U0001d7ec',
+        '\\'                  : '\U0001d7ed',
+        '\\'                  : '\U0001d7ee',
+        '\\'                : '\U0001d7ef',
+        '\\'                 : '\U0001d7f0',
+        '\\'                 : '\U0001d7f1',
+        '\\'                  : '\U0001d7f2',
+        '\\'                : '\U0001d7f3',
+        '\\'                : '\U0001d7f4',
+        '\\'                 : '\U0001d7f5',
+        '\\'                    : '\U0001d49c',
+        '\\'                    : '\U0000212c',
+        '\\'                    : '\U0001d49e',
+        '\\'                    : '\U0001d49f',
+        '\\'                    : '\U00002130',
+        '\\'                    : '\U00002131',
+        '\\'                    : '\U0001d4a2',
+        '\\'                    : '\U0000210b',
+        '\\'                    : '\U00002110',
+        '\\'                    : '\U0001d4a5',
+        '\\'                    : '\U0001d4a6',
+        '\\'                    : '\U00002112',
+        '\\'                    : '\U00002133',
+        '\\'                    : '\U0001d4a9',
+        '\\'                    : '\U0001d4aa',
+        '\\
'                    : '\U0001d5c9',
+        '\\'                    : '\U0001d5ca',
+        '\\'                    : '\U0001d5cb',
+        '\\'                    : '\U0001d5cc',
+        '\\'                    : '\U0001d5cd',
+        '\\'                    : '\U0001d5ce',
+        '\\'                    : '\U0001d5cf',
+        '\\'                    : '\U0001d5d0',
+        '\\'                    : '\U0001d5d1',
+        '\\'                    : '\U0001d5d2',
+        '\\'                    : '\U0001d5d3',
+        '\\'                   : '\U0001d504',
+        '\\'                   : '\U0001d505',
+        '\\'                   : '\U0000212d',
+        '\\
'                   : '\U0001d507',
+        '\\'                   : '\U0001d508',
+        '\\'                   : '\U0001d509',
+        '\\'                   : '\U0001d50a',
+        '\\'                   : '\U0000210c',
+        '\\'                   : '\U00002111',
+        '\\'                   : '\U0001d50d',
+        '\\'                   : '\U0001d50e',
+        '\\'                   : '\U0001d50f',
+        '\\'                   : '\U0001d510',
+        '\\'                   : '\U0001d511',
+        '\\'                   : '\U0001d512',
+        '\\'                   : '\U0001d513',
+        '\\'                   : '\U0001d514',
+        '\\'                   : '\U0000211c',
+        '\\'                   : '\U0001d516',
+        '\\'                   : '\U0001d517',
+        '\\'                   : '\U0001d518',
+        '\\'                   : '\U0001d519',
+        '\\'                   : '\U0001d51a',
+        '\\'                   : '\U0001d51b',
+        '\\'                   : '\U0001d51c',
+        '\\'                   : '\U00002128',
+        '\\'                   : '\U0001d51e',
+        '\\'                   : '\U0001d51f',
+        '\\'                   : '\U0001d520',
+        '\\
'                    : '\U0001d4ab',
+        '\\'                    : '\U0001d4ac',
+        '\\'                    : '\U0000211b',
+        '\\'                    : '\U0001d4ae',
+        '\\'                    : '\U0001d4af',
+        '\\'                    : '\U0001d4b0',
+        '\\'                    : '\U0001d4b1',
+        '\\'                    : '\U0001d4b2',
+        '\\'                    : '\U0001d4b3',
+        '\\'                    : '\U0001d4b4',
+        '\\'                    : '\U0001d4b5',
+        '\\'                    : '\U0001d5ba',
+        '\\'                    : '\U0001d5bb',
+        '\\'                    : '\U0001d5bc',
+        '\\'                    : '\U0001d5bd',
+        '\\'                    : '\U0001d5be',
+        '\\'                    : '\U0001d5bf',
+        '\\'                    : '\U0001d5c0',
+        '\\'                    : '\U0001d5c1',
+        '\\'                    : '\U0001d5c2',
+        '\\'                    : '\U0001d5c3',
+        '\\'                    : '\U0001d5c4',
+        '\\'                    : '\U0001d5c5',
+        '\\'                    : '\U0001d5c6',
+        '\\'                    : '\U0001d5c7',
+        '\\'                    : '\U0001d5c8',
+        '\\
'                   : '\U0001d521',
+        '\\'                   : '\U0001d522',
+        '\\'                   : '\U0001d523',
+        '\\'                   : '\U0001d524',
+        '\\'                   : '\U0001d525',
+        '\\'                   : '\U0001d526',
+        '\\'                   : '\U0001d527',
+        '\\'                   : '\U0001d528',
+        '\\'                   : '\U0001d529',
+        '\\'                   : '\U0001d52a',
+        '\\'                   : '\U0001d52b',
+        '\\'                   : '\U0001d52c',
+        '\\'                   : '\U0001d52d',
+        '\\'                   : '\U0001d52e',
+        '\\'                   : '\U0001d52f',
+        '\\'                   : '\U0001d530',
+        '\\'                   : '\U0001d531',
+        '\\'                   : '\U0001d532',
+        '\\'                   : '\U0001d533',
+        '\\'                   : '\U0001d534',
+        '\\'                   : '\U0001d535',
+        '\\'                   : '\U0001d536',
+        '\\'                   : '\U0001d537',
+        '\\'                : '\U000003b1',
+        '\\'                 : '\U000003b2',
+        '\\'                : '\U000003b3',
+        '\\'                : '\U000003b4',
+        '\\'              : '\U000003b5',
+        '\\'                 : '\U000003b6',
+        '\\'                  : '\U000003b7',
+        '\\'                : '\U000003b8',
+        '\\'                 : '\U000003b9',
+        '\\'                : '\U000003ba',
+        '\\'               : '\U000003bb',
+        '\\'                   : '\U000003bc',
+        '\\'                   : '\U000003bd',
+        '\\'                   : '\U000003be',
+        '\\'                   : '\U000003c0',
+        '\\'                  : '\U000003c1',
+        '\\'                : '\U000003c3',
+        '\\'                  : '\U000003c4',
+        '\\'              : '\U000003c5',
+        '\\'                  : '\U000003c6',
+        '\\'                  : '\U000003c7',
+        '\\'                  : '\U000003c8',
+        '\\'                : '\U000003c9',
+        '\\'                : '\U00000393',
+        '\\'                : '\U00000394',
+        '\\'                : '\U00000398',
+        '\\'               : '\U0000039b',
+        '\\'                   : '\U0000039e',
+        '\\'                   : '\U000003a0',
+        '\\'                : '\U000003a3',
+        '\\'              : '\U000003a5',
+        '\\'                  : '\U000003a6',
+        '\\'                  : '\U000003a8',
+        '\\'                : '\U000003a9',
+        '\\'                 : '\U0001d539',
+        '\\'              : '\U00002102',
+        '\\'                  : '\U00002115',
+        '\\'                  : '\U0000211a',
+        '\\'                 : '\U0000211d',
+        '\\'                  : '\U00002124',
+        '\\'            : '\U00002190',
+        '\\'        : '\U000027f5',
+        '\\'           : '\U00002192',
+        '\\'       : '\U000027f6',
+        '\\'            : '\U000021d0',
+        '\\'        : '\U000027f8',
+        '\\'           : '\U000021d2',
+        '\\'       : '\U000027f9',
+        '\\'       : '\U00002194',
+        '\\'   : '\U000027f7',
+        '\\'       : '\U000021d4',
+        '\\'   : '\U000027fa',
+        '\\'               : '\U000021a6',
+        '\\'           : '\U000027fc',
+        '\\'             : '\U00002500',
+        '\\'             : '\U00002550',
+        '\\'        : '\U000021a9',
+        '\\'       : '\U000021aa',
+        '\\'      : '\U000021bd',
+        '\\'     : '\U000021c1',
+        '\\'        : '\U000021bc',
+        '\\'       : '\U000021c0',
+        '\\'    : '\U000021cc',
+        '\\'              : '\U0000219d',
+        '\\'      : '\U000021c3',
+        '\\'     : '\U000021c2',
+        '\\'        : '\U000021bf',
+        '\\'       : '\U000021be',
+        '\\'          : '\U000021be',
+        '\\'                : '\U00002237',
+        '\\'                   : '\U00002191',
+        '\\'                   : '\U000021d1',
+        '\\'                 : '\U00002193',
+        '\\'                 : '\U000021d3',
+        '\\'               : '\U00002195',
+        '\\'               : '\U000021d5',
+        '\\'               : '\U000027e8',
+        '\\'               : '\U000027e9',
+        '\\'                : '\U00002308',
+        '\\'                : '\U00002309',
+        '\\'               : '\U0000230a',
+        '\\'               : '\U0000230b',
+        '\\'                : '\U00002987',
+        '\\'                : '\U00002988',
+        '\\'               : '\U000027e6',
+        '\\'               : '\U000027e7',
+        '\\'               : '\U00002983',
+        '\\'               : '\U00002984',
+        '\\'        : '\U000000ab',
+        '\\'       : '\U000000bb',
+        '\\'               : '\U000022a5',
+        '\\'                  : '\U000022a4',
+        '\\'                  : '\U00002227',
+        '\\'                  : '\U000022c0',
+        '\\'                   : '\U00002228',
+        '\\'                   : '\U000022c1',
+        '\\'               : '\U00002200',
+        '\\'               : '\U00002203',
+        '\\'              : '\U00002204',
+        '\\'                  : '\U000000ac',
+        '\\'                  : '\U000025a1',
+        '\\'              : '\U000025c7',
+        '\\'            : '\U000022a2',
+        '\\'            : '\U000022a8',
+        '\\'           : '\U000022a9',
+        '\\'           : '\U000022ab',
+        '\\'            : '\U000022a3',
+        '\\'                 : '\U0000221a',
+        '\\'                   : '\U00002264',
+        '\\'                   : '\U00002265',
+        '\\'                : '\U0000226a',
+        '\\'             : '\U0000226b',
+        '\\'              : '\U00002272',
+        '\\'           : '\U00002273',
+        '\\'           : '\U00002a85',
+        '\\'        : '\U00002a86',
+        '\\'                   : '\U00002208',
+        '\\'                : '\U00002209',
+        '\\'               : '\U00002282',
+        '\\'               : '\U00002283',
+        '\\'             : '\U00002286',
+        '\\'             : '\U00002287',
+        '\\'             : '\U0000228f',
+        '\\'             : '\U00002290',
+        '\\'           : '\U00002291',
+        '\\'           : '\U00002292',
+        '\\'                : '\U00002229',
+        '\\'                : '\U000022c2',
+        '\\'                : '\U0000222a',
+        '\\'                : '\U000022c3',
+        '\\'              : '\U00002294',
+        '\\'              : '\U00002a06',
+        '\\'              : '\U00002293',
+        '\\'              : '\U00002a05',
+        '\\'             : '\U00002216',
+        '\\'               : '\U0000221d',
+        '\\'                : '\U0000228e',
+        '\\'                : '\U00002a04',
+        '\\'                : '\U00002260',
+        '\\'                  : '\U0000223c',
+        '\\'                : '\U00002250',
+        '\\'                : '\U00002243',
+        '\\'               : '\U00002248',
+        '\\'                : '\U0000224d',
+        '\\'                 : '\U00002245',
+        '\\'                : '\U00002323',
+        '\\'                : '\U00002261',
+        '\\'                : '\U00002322',
+        '\\'                 : '\U000022c8',
+        '\\'               : '\U00002a1d',
+        '\\'                 : '\U0000227a',
+        '\\'                 : '\U0000227b',
+        '\\'               : '\U0000227c',
+        '\\'               : '\U0000227d',
+        '\\'             : '\U00002225',
+        '\\'                  : '\U000000a6',
+        '\\'            : '\U000000b1',
+        '\\'            : '\U00002213',
+        '\\'                : '\U000000d7',
+        '\\
'                  : '\U000000f7',
+        '\\'                 : '\U000022c5',
+        '\\'                 : '\U000022c6',
+        '\\'               : '\U00002219',
+        '\\'                 : '\U00002218',
+        '\\'               : '\U00002020',
+        '\\'              : '\U00002021',
+        '\\'                  : '\U000022b2',
+        '\\'                  : '\U000022b3',
+        '\\'                : '\U000022b4',
+        '\\'                : '\U000022b5',
+        '\\'         : '\U000025c3',
+        '\\'        : '\U000025b9',
+        '\\'             : '\U000025b3',
+        '\\'            : '\U0000225c',
+        '\\'                : '\U00002295',
+        '\\'                : '\U00002a01',
+        '\\'               : '\U00002297',
+        '\\'               : '\U00002a02',
+        '\\'                 : '\U00002299',
+        '\\'                 : '\U00002a00',
+        '\\'               : '\U00002296',
+        '\\'               : '\U00002298',
+        '\\'                 : '\U00002026',
+        '\\'                : '\U000022ef',
+        '\\'                  : '\U00002211',
+        '\\'                 : '\U0000220f',
+        '\\'               : '\U00002210',
+        '\\'             : '\U0000221e',
+        '\\'             : '\U0000222b',
+        '\\'            : '\U0000222e',
+        '\\'             : '\U00002663',
+        '\\'          : '\U00002662',
+        '\\'            : '\U00002661',
+        '\\'            : '\U00002660',
+        '\\'                : '\U00002135',
+        '\\'             : '\U00002205',
+        '\\'                : '\U00002207',
+        '\\'              : '\U00002202',
+        '\\'                 : '\U0000266d',
+        '\\'              : '\U0000266e',
+        '\\'                : '\U0000266f',
+        '\\'                : '\U00002220',
+        '\\'            : '\U000000a9',
+        '\\'           : '\U000000ae',
+        '\\'               : '\U000000ad',
+        '\\'              : '\U000000af',
+        '\\'           : '\U000000bc',
+        '\\'              : '\U000000bd',
+        '\\'        : '\U000000be',
+        '\\'          : '\U000000aa',
+        '\\'         : '\U000000ba',
+        '\\
'              : '\U000000a7',
+        '\\'            : '\U000000b6',
+        '\\'           : '\U000000a1',
+        '\\'         : '\U000000bf',
+        '\\'                 : '\U000020ac',
+        '\\'               : '\U000000a3',
+        '\\'                  : '\U000000a5',
+        '\\'                 : '\U000000a2',
+        '\\'             : '\U000000a4',
+        '\\'               : '\U000000b0',
+        '\\'                : '\U00002a3f',
+        '\\'                  : '\U00002127',
+        '\\'              : '\U000025ca',
+        '\\'                   : '\U00002118',
+        '\\'                : '\U00002240',
+        '\\'               : '\U000022c4',
+        '\\'                : '\U000000b4',
+        '\\'                : '\U00000131',
+        '\\'             : '\U000000a8',
+        '\\'              : '\U000000b8',
+        '\\'         : '\U000002dd',
+        '\\'                 : '\U000003f5',
+        '\\'              : '\U000023ce',
+        '\\'                 : '\U00002039',
+        '\\'                : '\U0000203a',
+        '\\'                 : '\U00002302',
+        '\\<^sub>'                 : '\U000021e9',
+        '\\<^sup>'                 : '\U000021e7',
+        '\\<^bold>'                : '\U00002759',
+        '\\<^bsub>'                : '\U000021d8',
+        '\\<^esub>'                : '\U000021d9',
+        '\\<^bsup>'                : '\U000021d7',
+        '\\<^esup>'                : '\U000021d6',
+    }
+
+    lang_map = {'isabelle' : isabelle_symbols, 'latex' : latex_symbols}
+
+    def __init__(self, **options):
+        Filter.__init__(self, **options)
+        lang = get_choice_opt(options, 'lang',
+                              ['isabelle', 'latex'], 'isabelle')
+        self.symbols = self.lang_map[lang]
+
+    def filter(self, lexer, stream):
+        for ttype, value in stream:
+            if value in self.symbols:
+                yield ttype, self.symbols[value]
+            else:
+                yield ttype, value
+
+
+class KeywordCaseFilter(Filter):
+    """Convert keywords to lowercase or uppercase or capitalize them, which
+    means first letter uppercase, rest lowercase.
+
+    This can be useful e.g. if you highlight Pascal code and want to adapt the
+    code to your styleguide.
+
+    Options accepted:
+
+    `case` : string
+       The casing to convert keywords to. Must be one of ``'lower'``,
+       ``'upper'`` or ``'capitalize'``.  The default is ``'lower'``.
+    """
+
+    def __init__(self, **options):
+        Filter.__init__(self, **options)
+        case = get_choice_opt(options, 'case',
+                              ['lower', 'upper', 'capitalize'], 'lower')
+        self.convert = getattr(str, case)
+
+    def filter(self, lexer, stream):
+        for ttype, value in stream:
+            if ttype in Keyword:
+                yield ttype, self.convert(value)
+            else:
+                yield ttype, value
+
+
+class NameHighlightFilter(Filter):
+    """Highlight a normal Name (and Name.*) token with a different token type.
+
+    Example::
+
+        filter = NameHighlightFilter(
+            names=['foo', 'bar', 'baz'],
+            tokentype=Name.Function,
+        )
+
+    This would highlight the names "foo", "bar" and "baz"
+    as functions. `Name.Function` is the default token type.
+
+    Options accepted:
+
+    `names` : list of strings
+      A list of names that should be given the different token type.
+      There is no default.
+    `tokentype` : TokenType or string
+      A token type or a string containing a token type name that is
+      used for highlighting the strings in `names`.  The default is
+      `Name.Function`.
+    """
+
+    def __init__(self, **options):
+        Filter.__init__(self, **options)
+        self.names = set(get_list_opt(options, 'names', []))
+        tokentype = options.get('tokentype')
+        if tokentype:
+            self.tokentype = string_to_tokentype(tokentype)
+        else:
+            self.tokentype = Name.Function
+
+    def filter(self, lexer, stream):
+        for ttype, value in stream:
+            if ttype in Name and value in self.names:
+                yield self.tokentype, value
+            else:
+                yield ttype, value
+
+
+class ErrorToken(Exception):
+    pass
+
+
+class RaiseOnErrorTokenFilter(Filter):
+    """Raise an exception when the lexer generates an error token.
+
+    Options accepted:
+
+    `excclass` : Exception class
+      The exception class to raise.
+      The default is `pygments.filters.ErrorToken`.
+
+    .. versionadded:: 0.8
+    """
+
+    def __init__(self, **options):
+        Filter.__init__(self, **options)
+        self.exception = options.get('excclass', ErrorToken)
+        try:
+            # issubclass() will raise TypeError if first argument is not a class
+            if not issubclass(self.exception, Exception):
+                raise TypeError
+        except TypeError:
+            raise OptionError('excclass option is not an exception class')
+
+    def filter(self, lexer, stream):
+        for ttype, value in stream:
+            if ttype is Error:
+                raise self.exception(value)
+            yield ttype, value
+
+
+class VisibleWhitespaceFilter(Filter):
+    """Convert tabs, newlines and/or spaces to visible characters.
+
+    Options accepted:
+
+    `spaces` : string or bool
+      If this is a one-character string, spaces will be replaces by this string.
+      If it is another true value, spaces will be replaced by ``·`` (unicode
+      MIDDLE DOT).  If it is a false value, spaces will not be replaced.  The
+      default is ``False``.
+    `tabs` : string or bool
+      The same as for `spaces`, but the default replacement character is ``»``
+      (unicode RIGHT-POINTING DOUBLE ANGLE QUOTATION MARK).  The default value
+      is ``False``.  Note: this will not work if the `tabsize` option for the
+      lexer is nonzero, as tabs will already have been expanded then.
+    `tabsize` : int
+      If tabs are to be replaced by this filter (see the `tabs` option), this
+      is the total number of characters that a tab should be expanded to.
+      The default is ``8``.
+    `newlines` : string or bool
+      The same as for `spaces`, but the default replacement character is ``¶``
+      (unicode PILCROW SIGN).  The default value is ``False``.
+    `wstokentype` : bool
+      If true, give whitespace the special `Whitespace` token type.  This allows
+      styling the visible whitespace differently (e.g. greyed out), but it can
+      disrupt background colors.  The default is ``True``.
+
+    .. versionadded:: 0.8
+    """
+
+    def __init__(self, **options):
+        Filter.__init__(self, **options)
+        for name, default in [('spaces',   '·'),
+                              ('tabs',     '»'),
+                              ('newlines', '¶')]:
+            opt = options.get(name, False)
+            if isinstance(opt, str) and len(opt) == 1:
+                setattr(self, name, opt)
+            else:
+                setattr(self, name, (opt and default or ''))
+        tabsize = get_int_opt(options, 'tabsize', 8)
+        if self.tabs:
+            self.tabs += ' ' * (tabsize - 1)
+        if self.newlines:
+            self.newlines += '\n'
+        self.wstt = get_bool_opt(options, 'wstokentype', True)
+
+    def filter(self, lexer, stream):
+        if self.wstt:
+            spaces = self.spaces or ' '
+            tabs = self.tabs or '\t'
+            newlines = self.newlines or '\n'
+            regex = re.compile(r'\s')
+
+            def replacefunc(wschar):
+                if wschar == ' ':
+                    return spaces
+                elif wschar == '\t':
+                    return tabs
+                elif wschar == '\n':
+                    return newlines
+                return wschar
+
+            for ttype, value in stream:
+                yield from _replace_special(ttype, value, regex, Whitespace,
+                                            replacefunc)
+        else:
+            spaces, tabs, newlines = self.spaces, self.tabs, self.newlines
+            # simpler processing
+            for ttype, value in stream:
+                if spaces:
+                    value = value.replace(' ', spaces)
+                if tabs:
+                    value = value.replace('\t', tabs)
+                if newlines:
+                    value = value.replace('\n', newlines)
+                yield ttype, value
+
+
+class GobbleFilter(Filter):
+    """Gobbles source code lines (eats initial characters).
+
+    This filter drops the first ``n`` characters off every line of code.  This
+    may be useful when the source code fed to the lexer is indented by a fixed
+    amount of space that isn't desired in the output.
+
+    Options accepted:
+
+    `n` : int
+       The number of characters to gobble.
+
+    .. versionadded:: 1.2
+    """
+    def __init__(self, **options):
+        Filter.__init__(self, **options)
+        self.n = get_int_opt(options, 'n', 0)
+
+    def gobble(self, value, left):
+        if left < len(value):
+            return value[left:], 0
+        else:
+            return '', left - len(value)
+
+    def filter(self, lexer, stream):
+        n = self.n
+        left = n  # How many characters left to gobble.
+        for ttype, value in stream:
+            # Remove ``left`` tokens from first line, ``n`` from all others.
+            parts = value.split('\n')
+            (parts[0], left) = self.gobble(parts[0], left)
+            for i in range(1, len(parts)):
+                (parts[i], left) = self.gobble(parts[i], n)
+            value = '\n'.join(parts)
+
+            if value != '':
+                yield ttype, value
+
+
+class TokenMergeFilter(Filter):
+    """Merges consecutive tokens with the same token type in the output
+    stream of a lexer.
+
+    .. versionadded:: 1.2
+    """
+    def __init__(self, **options):
+        Filter.__init__(self, **options)
+
+    def filter(self, lexer, stream):
+        current_type = None
+        current_value = None
+        for ttype, value in stream:
+            if ttype is current_type:
+                current_value += value
+            else:
+                if current_type is not None:
+                    yield current_type, current_value
+                current_type = ttype
+                current_value = value
+        if current_type is not None:
+            yield current_type, current_value
+
+
+FILTERS = {
+    'codetagify':     CodeTagFilter,
+    'keywordcase':    KeywordCaseFilter,
+    'highlight':      NameHighlightFilter,
+    'raiseonerror':   RaiseOnErrorTokenFilter,
+    'whitespace':     VisibleWhitespaceFilter,
+    'gobble':         GobbleFilter,
+    'tokenmerge':     TokenMergeFilter,
+    'symbols':        SymbolFilter,
+}
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/filters/__pycache__/__init__.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/filters/__pycache__/__init__.cpython-312.pyc
new file mode 100644
index 0000000..8d37e0f
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/filters/__pycache__/__init__.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/formatter.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/formatter.py
new file mode 100644
index 0000000..d266603
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/formatter.py
@@ -0,0 +1,129 @@
+"""
+    pygments.formatter
+    ~~~~~~~~~~~~~~~~~~
+
+    Base formatter class.
+
+    :copyright: Copyright 2006-2024 by the Pygments team, see AUTHORS.
+    :license: BSD, see LICENSE for details.
+"""
+
+import codecs
+
+from pip._vendor.pygments.util import get_bool_opt
+from pip._vendor.pygments.styles import get_style_by_name
+
+__all__ = ['Formatter']
+
+
+def _lookup_style(style):
+    if isinstance(style, str):
+        return get_style_by_name(style)
+    return style
+
+
+class Formatter:
+    """
+    Converts a token stream to text.
+
+    Formatters should have attributes to help selecting them. These
+    are similar to the corresponding :class:`~pygments.lexer.Lexer`
+    attributes.
+
+    .. autoattribute:: name
+       :no-value:
+
+    .. autoattribute:: aliases
+       :no-value:
+
+    .. autoattribute:: filenames
+       :no-value:
+
+    You can pass options as keyword arguments to the constructor.
+    All formatters accept these basic options:
+
+    ``style``
+        The style to use, can be a string or a Style subclass
+        (default: "default"). Not used by e.g. the
+        TerminalFormatter.
+    ``full``
+        Tells the formatter to output a "full" document, i.e.
+        a complete self-contained document. This doesn't have
+        any effect for some formatters (default: false).
+    ``title``
+        If ``full`` is true, the title that should be used to
+        caption the document (default: '').
+    ``encoding``
+        If given, must be an encoding name. This will be used to
+        convert the Unicode token strings to byte strings in the
+        output. If it is "" or None, Unicode strings will be written
+        to the output file, which most file-like objects do not
+        support (default: None).
+    ``outencoding``
+        Overrides ``encoding`` if given.
+
+    """
+
+    #: Full name for the formatter, in human-readable form.
+    name = None
+
+    #: A list of short, unique identifiers that can be used to lookup
+    #: the formatter from a list, e.g. using :func:`.get_formatter_by_name()`.
+    aliases = []
+
+    #: A list of fnmatch patterns that match filenames for which this
+    #: formatter can produce output. The patterns in this list should be unique
+    #: among all formatters.
+    filenames = []
+
+    #: If True, this formatter outputs Unicode strings when no encoding
+    #: option is given.
+    unicodeoutput = True
+
+    def __init__(self, **options):
+        """
+        As with lexers, this constructor takes arbitrary optional arguments,
+        and if you override it, you should first process your own options, then
+        call the base class implementation.
+        """
+        self.style = _lookup_style(options.get('style', 'default'))
+        self.full = get_bool_opt(options, 'full', False)
+        self.title = options.get('title', '')
+        self.encoding = options.get('encoding', None) or None
+        if self.encoding in ('guess', 'chardet'):
+            # can happen for e.g. pygmentize -O encoding=guess
+            self.encoding = 'utf-8'
+        self.encoding = options.get('outencoding') or self.encoding
+        self.options = options
+
+    def get_style_defs(self, arg=''):
+        """
+        This method must return statements or declarations suitable to define
+        the current style for subsequent highlighted text (e.g. CSS classes
+        in the `HTMLFormatter`).
+
+        The optional argument `arg` can be used to modify the generation and
+        is formatter dependent (it is standardized because it can be given on
+        the command line).
+
+        This method is called by the ``-S`` :doc:`command-line option `,
+        the `arg` is then given by the ``-a`` option.
+        """
+        return ''
+
+    def format(self, tokensource, outfile):
+        """
+        This method must format the tokens from the `tokensource` iterable and
+        write the formatted version to the file object `outfile`.
+
+        Formatter options can control how exactly the tokens are converted.
+        """
+        if self.encoding:
+            # wrap the outfile in a StreamWriter
+            outfile = codecs.lookup(self.encoding)[3](outfile)
+        return self.format_unencoded(tokensource, outfile)
+
+    # Allow writing Formatter[str] or Formatter[bytes]. That's equivalent to
+    # Formatter. This helps when using third-party type stubs from typeshed.
+    def __class_getitem__(cls, name):
+        return cls
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/__init__.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/__init__.py
new file mode 100644
index 0000000..f19e993
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/__init__.py
@@ -0,0 +1,157 @@
+"""
+    pygments.formatters
+    ~~~~~~~~~~~~~~~~~~~
+
+    Pygments formatters.
+
+    :copyright: Copyright 2006-2024 by the Pygments team, see AUTHORS.
+    :license: BSD, see LICENSE for details.
+"""
+
+import re
+import sys
+import types
+import fnmatch
+from os.path import basename
+
+from pip._vendor.pygments.formatters._mapping import FORMATTERS
+from pip._vendor.pygments.plugin import find_plugin_formatters
+from pip._vendor.pygments.util import ClassNotFound
+
+__all__ = ['get_formatter_by_name', 'get_formatter_for_filename',
+           'get_all_formatters', 'load_formatter_from_file'] + list(FORMATTERS)
+
+_formatter_cache = {}  # classes by name
+_pattern_cache = {}
+
+
+def _fn_matches(fn, glob):
+    """Return whether the supplied file name fn matches pattern filename."""
+    if glob not in _pattern_cache:
+        pattern = _pattern_cache[glob] = re.compile(fnmatch.translate(glob))
+        return pattern.match(fn)
+    return _pattern_cache[glob].match(fn)
+
+
+def _load_formatters(module_name):
+    """Load a formatter (and all others in the module too)."""
+    mod = __import__(module_name, None, None, ['__all__'])
+    for formatter_name in mod.__all__:
+        cls = getattr(mod, formatter_name)
+        _formatter_cache[cls.name] = cls
+
+
+def get_all_formatters():
+    """Return a generator for all formatter classes."""
+    # NB: this returns formatter classes, not info like get_all_lexers().
+    for info in FORMATTERS.values():
+        if info[1] not in _formatter_cache:
+            _load_formatters(info[0])
+        yield _formatter_cache[info[1]]
+    for _, formatter in find_plugin_formatters():
+        yield formatter
+
+
+def find_formatter_class(alias):
+    """Lookup a formatter by alias.
+
+    Returns None if not found.
+    """
+    for module_name, name, aliases, _, _ in FORMATTERS.values():
+        if alias in aliases:
+            if name not in _formatter_cache:
+                _load_formatters(module_name)
+            return _formatter_cache[name]
+    for _, cls in find_plugin_formatters():
+        if alias in cls.aliases:
+            return cls
+
+
+def get_formatter_by_name(_alias, **options):
+    """
+    Return an instance of a :class:`.Formatter` subclass that has `alias` in its
+    aliases list. The formatter is given the `options` at its instantiation.
+
+    Will raise :exc:`pygments.util.ClassNotFound` if no formatter with that
+    alias is found.
+    """
+    cls = find_formatter_class(_alias)
+    if cls is None:
+        raise ClassNotFound(f"no formatter found for name {_alias!r}")
+    return cls(**options)
+
+
+def load_formatter_from_file(filename, formattername="CustomFormatter", **options):
+    """
+    Return a `Formatter` subclass instance loaded from the provided file, relative
+    to the current directory.
+
+    The file is expected to contain a Formatter class named ``formattername``
+    (by default, CustomFormatter). Users should be very careful with the input, because
+    this method is equivalent to running ``eval()`` on the input file. The formatter is
+    given the `options` at its instantiation.
+
+    :exc:`pygments.util.ClassNotFound` is raised if there are any errors loading
+    the formatter.
+
+    .. versionadded:: 2.2
+    """
+    try:
+        # This empty dict will contain the namespace for the exec'd file
+        custom_namespace = {}
+        with open(filename, 'rb') as f:
+            exec(f.read(), custom_namespace)
+        # Retrieve the class `formattername` from that namespace
+        if formattername not in custom_namespace:
+            raise ClassNotFound(f'no valid {formattername} class found in {filename}')
+        formatter_class = custom_namespace[formattername]
+        # And finally instantiate it with the options
+        return formatter_class(**options)
+    except OSError as err:
+        raise ClassNotFound(f'cannot read {filename}: {err}')
+    except ClassNotFound:
+        raise
+    except Exception as err:
+        raise ClassNotFound(f'error when loading custom formatter: {err}')
+
+
+def get_formatter_for_filename(fn, **options):
+    """
+    Return a :class:`.Formatter` subclass instance that has a filename pattern
+    matching `fn`. The formatter is given the `options` at its instantiation.
+
+    Will raise :exc:`pygments.util.ClassNotFound` if no formatter for that filename
+    is found.
+    """
+    fn = basename(fn)
+    for modname, name, _, filenames, _ in FORMATTERS.values():
+        for filename in filenames:
+            if _fn_matches(fn, filename):
+                if name not in _formatter_cache:
+                    _load_formatters(modname)
+                return _formatter_cache[name](**options)
+    for _name, cls in find_plugin_formatters():
+        for filename in cls.filenames:
+            if _fn_matches(fn, filename):
+                return cls(**options)
+    raise ClassNotFound(f"no formatter found for file name {fn!r}")
+
+
+class _automodule(types.ModuleType):
+    """Automatically import formatters."""
+
+    def __getattr__(self, name):
+        info = FORMATTERS.get(name)
+        if info:
+            _load_formatters(info[0])
+            cls = _formatter_cache[info[1]]
+            setattr(self, name, cls)
+            return cls
+        raise AttributeError(name)
+
+
+oldmod = sys.modules[__name__]
+newmod = _automodule(__name__)
+newmod.__dict__.update(oldmod.__dict__)
+sys.modules[__name__] = newmod
+del newmod.newmod, newmod.oldmod, newmod.sys, newmod.types
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/__pycache__/__init__.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/__pycache__/__init__.cpython-312.pyc
new file mode 100644
index 0000000..9b266ce
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/__pycache__/__init__.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/__pycache__/_mapping.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/__pycache__/_mapping.cpython-312.pyc
new file mode 100644
index 0000000..1894941
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/__pycache__/_mapping.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/__pycache__/bbcode.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/__pycache__/bbcode.cpython-312.pyc
new file mode 100644
index 0000000..b2f0015
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/__pycache__/bbcode.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/__pycache__/groff.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/__pycache__/groff.cpython-312.pyc
new file mode 100644
index 0000000..783f763
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/__pycache__/groff.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/__pycache__/html.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/__pycache__/html.cpython-312.pyc
new file mode 100644
index 0000000..6b97f83
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/__pycache__/html.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/__pycache__/img.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/__pycache__/img.cpython-312.pyc
new file mode 100644
index 0000000..a4c7a6d
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/__pycache__/img.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/__pycache__/irc.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/__pycache__/irc.cpython-312.pyc
new file mode 100644
index 0000000..422cab1
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/__pycache__/irc.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/__pycache__/latex.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/__pycache__/latex.cpython-312.pyc
new file mode 100644
index 0000000..e443cfc
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/__pycache__/latex.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/__pycache__/other.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/__pycache__/other.cpython-312.pyc
new file mode 100644
index 0000000..9fa5c88
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/__pycache__/other.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/__pycache__/pangomarkup.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/__pycache__/pangomarkup.cpython-312.pyc
new file mode 100644
index 0000000..7a29575
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/__pycache__/pangomarkup.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/__pycache__/rtf.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/__pycache__/rtf.cpython-312.pyc
new file mode 100644
index 0000000..64e3dc7
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/__pycache__/rtf.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/__pycache__/svg.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/__pycache__/svg.cpython-312.pyc
new file mode 100644
index 0000000..573fc6d
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/__pycache__/svg.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/__pycache__/terminal.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/__pycache__/terminal.cpython-312.pyc
new file mode 100644
index 0000000..1e94cb3
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/__pycache__/terminal.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/__pycache__/terminal256.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/__pycache__/terminal256.cpython-312.pyc
new file mode 100644
index 0000000..924ac5e
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/__pycache__/terminal256.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/_mapping.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/_mapping.py
new file mode 100644
index 0000000..72ca840
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/_mapping.py
@@ -0,0 +1,23 @@
+# Automatically generated by scripts/gen_mapfiles.py.
+# DO NOT EDIT BY HAND; run `tox -e mapfiles` instead.
+
+FORMATTERS = {
+    'BBCodeFormatter': ('pygments.formatters.bbcode', 'BBCode', ('bbcode', 'bb'), (), 'Format tokens with BBcodes. These formatting codes are used by many bulletin boards, so you can highlight your sourcecode with pygments before posting it there.'),
+    'BmpImageFormatter': ('pygments.formatters.img', 'img_bmp', ('bmp', 'bitmap'), ('*.bmp',), 'Create a bitmap image from source code. This uses the Python Imaging Library to generate a pixmap from the source code.'),
+    'GifImageFormatter': ('pygments.formatters.img', 'img_gif', ('gif',), ('*.gif',), 'Create a GIF image from source code. This uses the Python Imaging Library to generate a pixmap from the source code.'),
+    'GroffFormatter': ('pygments.formatters.groff', 'groff', ('groff', 'troff', 'roff'), (), 'Format tokens with groff escapes to change their color and font style.'),
+    'HtmlFormatter': ('pygments.formatters.html', 'HTML', ('html',), ('*.html', '*.htm'), "Format tokens as HTML 4 ```` tags. By default, the content is enclosed in a ``
`` tag, itself wrapped in a ``
`` tag (but see the `nowrap` option). The ``
``'s CSS class can be set by the `cssclass` option."),
+    'IRCFormatter': ('pygments.formatters.irc', 'IRC', ('irc', 'IRC'), (), 'Format tokens with IRC color sequences'),
+    'ImageFormatter': ('pygments.formatters.img', 'img', ('img', 'IMG', 'png'), ('*.png',), 'Create a PNG image from source code. This uses the Python Imaging Library to generate a pixmap from the source code.'),
+    'JpgImageFormatter': ('pygments.formatters.img', 'img_jpg', ('jpg', 'jpeg'), ('*.jpg',), 'Create a JPEG image from source code. This uses the Python Imaging Library to generate a pixmap from the source code.'),
+    'LatexFormatter': ('pygments.formatters.latex', 'LaTeX', ('latex', 'tex'), ('*.tex',), 'Format tokens as LaTeX code. This needs the `fancyvrb` and `color` standard packages.'),
+    'NullFormatter': ('pygments.formatters.other', 'Text only', ('text', 'null'), ('*.txt',), 'Output the text unchanged without any formatting.'),
+    'PangoMarkupFormatter': ('pygments.formatters.pangomarkup', 'Pango Markup', ('pango', 'pangomarkup'), (), 'Format tokens as Pango Markup code. It can then be rendered to an SVG.'),
+    'RawTokenFormatter': ('pygments.formatters.other', 'Raw tokens', ('raw', 'tokens'), ('*.raw',), 'Format tokens as a raw representation for storing token streams.'),
+    'RtfFormatter': ('pygments.formatters.rtf', 'RTF', ('rtf',), ('*.rtf',), 'Format tokens as RTF markup. This formatter automatically outputs full RTF documents with color information and other useful stuff. Perfect for Copy and Paste into Microsoft(R) Word(R) documents.'),
+    'SvgFormatter': ('pygments.formatters.svg', 'SVG', ('svg',), ('*.svg',), 'Format tokens as an SVG graphics file.  This formatter is still experimental. Each line of code is a ```` element with explicit ``x`` and ``y`` coordinates containing ```` elements with the individual token styles.'),
+    'Terminal256Formatter': ('pygments.formatters.terminal256', 'Terminal256', ('terminal256', 'console256', '256'), (), 'Format tokens with ANSI color sequences, for output in a 256-color terminal or console.  Like in `TerminalFormatter` color sequences are terminated at newlines, so that paging the output works correctly.'),
+    'TerminalFormatter': ('pygments.formatters.terminal', 'Terminal', ('terminal', 'console'), (), 'Format tokens with ANSI color sequences, for output in a text console. Color sequences are terminated at newlines, so that paging the output works correctly.'),
+    'TerminalTrueColorFormatter': ('pygments.formatters.terminal256', 'TerminalTrueColor', ('terminal16m', 'console16m', '16m'), (), 'Format tokens with ANSI color sequences, for output in a true-color terminal or console.  Like in `TerminalFormatter` color sequences are terminated at newlines, so that paging the output works correctly.'),
+    'TestcaseFormatter': ('pygments.formatters.other', 'Testcase', ('testcase',), (), 'Format tokens as appropriate for a new testcase.'),
+}
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/bbcode.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/bbcode.py
new file mode 100644
index 0000000..5a05bd9
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/bbcode.py
@@ -0,0 +1,108 @@
+"""
+    pygments.formatters.bbcode
+    ~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+    BBcode formatter.
+
+    :copyright: Copyright 2006-2024 by the Pygments team, see AUTHORS.
+    :license: BSD, see LICENSE for details.
+"""
+
+
+from pip._vendor.pygments.formatter import Formatter
+from pip._vendor.pygments.util import get_bool_opt
+
+__all__ = ['BBCodeFormatter']
+
+
+class BBCodeFormatter(Formatter):
+    """
+    Format tokens with BBcodes. These formatting codes are used by many
+    bulletin boards, so you can highlight your sourcecode with pygments before
+    posting it there.
+
+    This formatter has no support for background colors and borders, as there
+    are no common BBcode tags for that.
+
+    Some board systems (e.g. phpBB) don't support colors in their [code] tag,
+    so you can't use the highlighting together with that tag.
+    Text in a [code] tag usually is shown with a monospace font (which this
+    formatter can do with the ``monofont`` option) and no spaces (which you
+    need for indentation) are removed.
+
+    Additional options accepted:
+
+    `style`
+        The style to use, can be a string or a Style subclass (default:
+        ``'default'``).
+
+    `codetag`
+        If set to true, put the output into ``[code]`` tags (default:
+        ``false``)
+
+    `monofont`
+        If set to true, add a tag to show the code with a monospace font
+        (default: ``false``).
+    """
+    name = 'BBCode'
+    aliases = ['bbcode', 'bb']
+    filenames = []
+
+    def __init__(self, **options):
+        Formatter.__init__(self, **options)
+        self._code = get_bool_opt(options, 'codetag', False)
+        self._mono = get_bool_opt(options, 'monofont', False)
+
+        self.styles = {}
+        self._make_styles()
+
+    def _make_styles(self):
+        for ttype, ndef in self.style:
+            start = end = ''
+            if ndef['color']:
+                start += '[color=#{}]'.format(ndef['color'])
+                end = '[/color]' + end
+            if ndef['bold']:
+                start += '[b]'
+                end = '[/b]' + end
+            if ndef['italic']:
+                start += '[i]'
+                end = '[/i]' + end
+            if ndef['underline']:
+                start += '[u]'
+                end = '[/u]' + end
+            # there are no common BBcodes for background-color and border
+
+            self.styles[ttype] = start, end
+
+    def format_unencoded(self, tokensource, outfile):
+        if self._code:
+            outfile.write('[code]')
+        if self._mono:
+            outfile.write('[font=monospace]')
+
+        lastval = ''
+        lasttype = None
+
+        for ttype, value in tokensource:
+            while ttype not in self.styles:
+                ttype = ttype.parent
+            if ttype == lasttype:
+                lastval += value
+            else:
+                if lastval:
+                    start, end = self.styles[lasttype]
+                    outfile.write(''.join((start, lastval, end)))
+                lastval = value
+                lasttype = ttype
+
+        if lastval:
+            start, end = self.styles[lasttype]
+            outfile.write(''.join((start, lastval, end)))
+
+        if self._mono:
+            outfile.write('[/font]')
+        if self._code:
+            outfile.write('[/code]')
+        if self._code or self._mono:
+            outfile.write('\n')
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/groff.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/groff.py
new file mode 100644
index 0000000..5c8a958
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/groff.py
@@ -0,0 +1,170 @@
+"""
+    pygments.formatters.groff
+    ~~~~~~~~~~~~~~~~~~~~~~~~~
+
+    Formatter for groff output.
+
+    :copyright: Copyright 2006-2024 by the Pygments team, see AUTHORS.
+    :license: BSD, see LICENSE for details.
+"""
+
+import math
+from pip._vendor.pygments.formatter import Formatter
+from pip._vendor.pygments.util import get_bool_opt, get_int_opt
+
+__all__ = ['GroffFormatter']
+
+
+class GroffFormatter(Formatter):
+    """
+    Format tokens with groff escapes to change their color and font style.
+
+    .. versionadded:: 2.11
+
+    Additional options accepted:
+
+    `style`
+        The style to use, can be a string or a Style subclass (default:
+        ``'default'``).
+
+    `monospaced`
+        If set to true, monospace font will be used (default: ``true``).
+
+    `linenos`
+        If set to true, print the line numbers (default: ``false``).
+
+    `wrap`
+        Wrap lines to the specified number of characters. Disabled if set to 0
+        (default: ``0``).
+    """
+
+    name = 'groff'
+    aliases = ['groff','troff','roff']
+    filenames = []
+
+    def __init__(self, **options):
+        Formatter.__init__(self, **options)
+
+        self.monospaced = get_bool_opt(options, 'monospaced', True)
+        self.linenos = get_bool_opt(options, 'linenos', False)
+        self._lineno = 0
+        self.wrap = get_int_opt(options, 'wrap', 0)
+        self._linelen = 0
+
+        self.styles = {}
+        self._make_styles()
+
+
+    def _make_styles(self):
+        regular = '\\f[CR]' if self.monospaced else '\\f[R]'
+        bold = '\\f[CB]' if self.monospaced else '\\f[B]'
+        italic = '\\f[CI]' if self.monospaced else '\\f[I]'
+
+        for ttype, ndef in self.style:
+            start = end = ''
+            if ndef['color']:
+                start += '\\m[{}]'.format(ndef['color'])
+                end = '\\m[]' + end
+            if ndef['bold']:
+                start += bold
+                end = regular + end
+            if ndef['italic']:
+                start += italic
+                end = regular + end
+            if ndef['bgcolor']:
+                start += '\\M[{}]'.format(ndef['bgcolor'])
+                end = '\\M[]' + end
+
+            self.styles[ttype] = start, end
+
+
+    def _define_colors(self, outfile):
+        colors = set()
+        for _, ndef in self.style:
+            if ndef['color'] is not None:
+                colors.add(ndef['color'])
+
+        for color in sorted(colors):
+            outfile.write('.defcolor ' + color + ' rgb #' + color + '\n')
+
+
+    def _write_lineno(self, outfile):
+        self._lineno += 1
+        outfile.write("%s% 4d " % (self._lineno != 1 and '\n' or '', self._lineno))
+
+
+    def _wrap_line(self, line):
+        length = len(line.rstrip('\n'))
+        space = '     ' if self.linenos else ''
+        newline = ''
+
+        if length > self.wrap:
+            for i in range(0, math.floor(length / self.wrap)):
+                chunk = line[i*self.wrap:i*self.wrap+self.wrap]
+                newline += (chunk + '\n' + space)
+            remainder = length % self.wrap
+            if remainder > 0:
+                newline += line[-remainder-1:]
+                self._linelen = remainder
+        elif self._linelen + length > self.wrap:
+            newline = ('\n' + space) + line
+            self._linelen = length
+        else:
+            newline = line
+            self._linelen += length
+
+        return newline
+
+
+    def _escape_chars(self, text):
+        text = text.replace('\\', '\\[u005C]'). \
+                    replace('.', '\\[char46]'). \
+                    replace('\'', '\\[u0027]'). \
+                    replace('`', '\\[u0060]'). \
+                    replace('~', '\\[u007E]')
+        copy = text
+
+        for char in copy:
+            if len(char) != len(char.encode()):
+                uni = char.encode('unicode_escape') \
+                    .decode()[1:] \
+                    .replace('x', 'u00') \
+                    .upper()
+                text = text.replace(char, '\\[u' + uni[1:] + ']')
+
+        return text
+
+
+    def format_unencoded(self, tokensource, outfile):
+        self._define_colors(outfile)
+
+        outfile.write('.nf\n\\f[CR]\n')
+
+        if self.linenos:
+            self._write_lineno(outfile)
+
+        for ttype, value in tokensource:
+            while ttype not in self.styles:
+                ttype = ttype.parent
+            start, end = self.styles[ttype]
+
+            for line in value.splitlines(True):
+                if self.wrap > 0:
+                    line = self._wrap_line(line)
+
+                if start and end:
+                    text = self._escape_chars(line.rstrip('\n'))
+                    if text != '':
+                        outfile.write(''.join((start, text, end)))
+                else:
+                    outfile.write(self._escape_chars(line.rstrip('\n')))
+
+                if line.endswith('\n'):
+                    if self.linenos:
+                        self._write_lineno(outfile)
+                        self._linelen = 0
+                    else:
+                        outfile.write('\n')
+                        self._linelen = 0
+
+        outfile.write('\n.fi')
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/html.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/html.py
new file mode 100644
index 0000000..7aa938f
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/html.py
@@ -0,0 +1,987 @@
+"""
+    pygments.formatters.html
+    ~~~~~~~~~~~~~~~~~~~~~~~~
+
+    Formatter for HTML output.
+
+    :copyright: Copyright 2006-2024 by the Pygments team, see AUTHORS.
+    :license: BSD, see LICENSE for details.
+"""
+
+import functools
+import os
+import sys
+import os.path
+from io import StringIO
+
+from pip._vendor.pygments.formatter import Formatter
+from pip._vendor.pygments.token import Token, Text, STANDARD_TYPES
+from pip._vendor.pygments.util import get_bool_opt, get_int_opt, get_list_opt
+
+try:
+    import ctags
+except ImportError:
+    ctags = None
+
+__all__ = ['HtmlFormatter']
+
+
+_escape_html_table = {
+    ord('&'): '&',
+    ord('<'): '<',
+    ord('>'): '>',
+    ord('"'): '"',
+    ord("'"): ''',
+}
+
+
+def escape_html(text, table=_escape_html_table):
+    """Escape &, <, > as well as single and double quotes for HTML."""
+    return text.translate(table)
+
+
+def webify(color):
+    if color.startswith('calc') or color.startswith('var'):
+        return color
+    else:
+        return '#' + color
+
+
+def _get_ttype_class(ttype):
+    fname = STANDARD_TYPES.get(ttype)
+    if fname:
+        return fname
+    aname = ''
+    while fname is None:
+        aname = '-' + ttype[-1] + aname
+        ttype = ttype.parent
+        fname = STANDARD_TYPES.get(ttype)
+    return fname + aname
+
+
+CSSFILE_TEMPLATE = '''\
+/*
+generated by Pygments 
+Copyright 2006-2024 by the Pygments team.
+Licensed under the BSD license, see LICENSE for details.
+*/
+%(styledefs)s
+'''
+
+DOC_HEADER = '''\
+
+
+
+
+  %(title)s
+  
+  
+
+
+
%(title)s

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

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

+        

+          
+          
+        

+            
1
+            2

+          		
+            
def foo(bar):
+              pass
+            

+          

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

+
+
+"""
+
+CONSOLE_SVG_FORMAT = """\
+
+    
+    
+
+    
+    
+      
+    
+    {lines}
+    
+
+    {chrome}
+    
+    {backgrounds}
+    
+    {matrix}
+    
+    
+
+"""
+
+_SVG_FONT_FAMILY = "Rich Fira Code"
+_SVG_CLASSES_PREFIX = "rich-svg"
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/_extension.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/_extension.py
new file mode 100644
index 0000000..cbd6da9
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/_extension.py
@@ -0,0 +1,10 @@
+from typing import Any
+
+
+def load_ipython_extension(ip: Any) -> None:  # pragma: no cover
+    # prevent circular import
+    from pip._vendor.rich.pretty import install
+    from pip._vendor.rich.traceback import install as tr_install
+
+    install()
+    tr_install()
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/_fileno.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/_fileno.py
new file mode 100644
index 0000000..b17ee65
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/_fileno.py
@@ -0,0 +1,24 @@
+from __future__ import annotations
+
+from typing import IO, Callable
+
+
+def get_fileno(file_like: IO[str]) -> int | None:
+    """Get fileno() from a file, accounting for poorly implemented file-like objects.
+
+    Args:
+        file_like (IO): A file-like object.
+
+    Returns:
+        int | None: The result of fileno if available, or None if operation failed.
+    """
+    fileno: Callable[[], int] | None = getattr(file_like, "fileno", None)
+    if fileno is not None:
+        try:
+            return fileno()
+        except Exception:
+            # `fileno` is documented as potentially raising a OSError
+            # Alas, from the issues, there are so many poorly implemented file-like objects,
+            # that `fileno()` can raise just about anything.
+            return None
+    return None
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/_inspect.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/_inspect.py
new file mode 100644
index 0000000..e87698d
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/_inspect.py
@@ -0,0 +1,268 @@
+import inspect
+from inspect import cleandoc, getdoc, getfile, isclass, ismodule, signature
+from typing import Any, Collection, Iterable, Optional, Tuple, Type, Union
+
+from .console import Group, RenderableType
+from .control import escape_control_codes
+from .highlighter import ReprHighlighter
+from .jupyter import JupyterMixin
+from .panel import Panel
+from .pretty import Pretty
+from .table import Table
+from .text import Text, TextType
+
+
+def _first_paragraph(doc: str) -> str:
+    """Get the first paragraph from a docstring."""
+    paragraph, _, _ = doc.partition("\n\n")
+    return paragraph
+
+
+class Inspect(JupyterMixin):
+    """A renderable to inspect any Python Object.
+
+    Args:
+        obj (Any): An object to inspect.
+        title (str, optional): Title to display over inspect result, or None use type. Defaults to None.
+        help (bool, optional): Show full help text rather than just first paragraph. Defaults to False.
+        methods (bool, optional): Enable inspection of callables. Defaults to False.
+        docs (bool, optional): Also render doc strings. Defaults to True.
+        private (bool, optional): Show private attributes (beginning with underscore). Defaults to False.
+        dunder (bool, optional): Show attributes starting with double underscore. Defaults to False.
+        sort (bool, optional): Sort attributes alphabetically. Defaults to True.
+        all (bool, optional): Show all attributes. Defaults to False.
+        value (bool, optional): Pretty print value of object. Defaults to True.
+    """
+
+    def __init__(
+        self,
+        obj: Any,
+        *,
+        title: Optional[TextType] = None,
+        help: bool = False,
+        methods: bool = False,
+        docs: bool = True,
+        private: bool = False,
+        dunder: bool = False,
+        sort: bool = True,
+        all: bool = True,
+        value: bool = True,
+    ) -> None:
+        self.highlighter = ReprHighlighter()
+        self.obj = obj
+        self.title = title or self._make_title(obj)
+        if all:
+            methods = private = dunder = True
+        self.help = help
+        self.methods = methods
+        self.docs = docs or help
+        self.private = private or dunder
+        self.dunder = dunder
+        self.sort = sort
+        self.value = value
+
+    def _make_title(self, obj: Any) -> Text:
+        """Make a default title."""
+        title_str = (
+            str(obj)
+            if (isclass(obj) or callable(obj) or ismodule(obj))
+            else str(type(obj))
+        )
+        title_text = self.highlighter(title_str)
+        return title_text
+
+    def __rich__(self) -> Panel:
+        return Panel.fit(
+            Group(*self._render()),
+            title=self.title,
+            border_style="scope.border",
+            padding=(0, 1),
+        )
+
+    def _get_signature(self, name: str, obj: Any) -> Optional[Text]:
+        """Get a signature for a callable."""
+        try:
+            _signature = str(signature(obj)) + ":"
+        except ValueError:
+            _signature = "(...)"
+        except TypeError:
+            return None
+
+        source_filename: Optional[str] = None
+        try:
+            source_filename = getfile(obj)
+        except (OSError, TypeError):
+            # OSError is raised if obj has no source file, e.g. when defined in REPL.
+            pass
+
+        callable_name = Text(name, style="inspect.callable")
+        if source_filename:
+            callable_name.stylize(f"link file://{source_filename}")
+        signature_text = self.highlighter(_signature)
+
+        qualname = name or getattr(obj, "__qualname__", name)
+
+        # If obj is a module, there may be classes (which are callable) to display
+        if inspect.isclass(obj):
+            prefix = "class"
+        elif inspect.iscoroutinefunction(obj):
+            prefix = "async def"
+        else:
+            prefix = "def"
+
+        qual_signature = Text.assemble(
+            (f"{prefix} ", f"inspect.{prefix.replace(' ', '_')}"),
+            (qualname, "inspect.callable"),
+            signature_text,
+        )
+
+        return qual_signature
+
+    def _render(self) -> Iterable[RenderableType]:
+        """Render object."""
+
+        def sort_items(item: Tuple[str, Any]) -> Tuple[bool, str]:
+            key, (_error, value) = item
+            return (callable(value), key.strip("_").lower())
+
+        def safe_getattr(attr_name: str) -> Tuple[Any, Any]:
+            """Get attribute or any exception."""
+            try:
+                return (None, getattr(obj, attr_name))
+            except Exception as error:
+                return (error, None)
+
+        obj = self.obj
+        keys = dir(obj)
+        total_items = len(keys)
+        if not self.dunder:
+            keys = [key for key in keys if not key.startswith("__")]
+        if not self.private:
+            keys = [key for key in keys if not key.startswith("_")]
+        not_shown_count = total_items - len(keys)
+        items = [(key, safe_getattr(key)) for key in keys]
+        if self.sort:
+            items.sort(key=sort_items)
+
+        items_table = Table.grid(padding=(0, 1), expand=False)
+        items_table.add_column(justify="right")
+        add_row = items_table.add_row
+        highlighter = self.highlighter
+
+        if callable(obj):
+            signature = self._get_signature("", obj)
+            if signature is not None:
+                yield signature
+                yield ""
+
+        if self.docs:
+            _doc = self._get_formatted_doc(obj)
+            if _doc is not None:
+                doc_text = Text(_doc, style="inspect.help")
+                doc_text = highlighter(doc_text)
+                yield doc_text
+                yield ""
+
+        if self.value and not (isclass(obj) or callable(obj) or ismodule(obj)):
+            yield Panel(
+                Pretty(obj, indent_guides=True, max_length=10, max_string=60),
+                border_style="inspect.value.border",
+            )
+            yield ""
+
+        for key, (error, value) in items:
+            key_text = Text.assemble(
+                (
+                    key,
+                    "inspect.attr.dunder" if key.startswith("__") else "inspect.attr",
+                ),
+                (" =", "inspect.equals"),
+            )
+            if error is not None:
+                warning = key_text.copy()
+                warning.stylize("inspect.error")
+                add_row(warning, highlighter(repr(error)))
+                continue
+
+            if callable(value):
+                if not self.methods:
+                    continue
+
+                _signature_text = self._get_signature(key, value)
+                if _signature_text is None:
+                    add_row(key_text, Pretty(value, highlighter=highlighter))
+                else:
+                    if self.docs:
+                        docs = self._get_formatted_doc(value)
+                        if docs is not None:
+                            _signature_text.append("\n" if "\n" in docs else " ")
+                            doc = highlighter(docs)
+                            doc.stylize("inspect.doc")
+                            _signature_text.append(doc)
+
+                    add_row(key_text, _signature_text)
+            else:
+                add_row(key_text, Pretty(value, highlighter=highlighter))
+        if items_table.row_count:
+            yield items_table
+        elif not_shown_count:
+            yield Text.from_markup(
+                f"[b cyan]{not_shown_count}[/][i] attribute(s) not shown.[/i] "
+                f"Run [b][magenta]inspect[/]([not b]inspect[/])[/b] for options."
+            )
+
+    def _get_formatted_doc(self, object_: Any) -> Optional[str]:
+        """
+        Extract the docstring of an object, process it and returns it.
+        The processing consists in cleaning up the doctring's indentation,
+        taking only its 1st paragraph if `self.help` is not True,
+        and escape its control codes.
+
+        Args:
+            object_ (Any): the object to get the docstring from.
+
+        Returns:
+            Optional[str]: the processed docstring, or None if no docstring was found.
+        """
+        docs = getdoc(object_)
+        if docs is None:
+            return None
+        docs = cleandoc(docs).strip()
+        if not self.help:
+            docs = _first_paragraph(docs)
+        return escape_control_codes(docs)
+
+
+def get_object_types_mro(obj: Union[object, Type[Any]]) -> Tuple[type, ...]:
+    """Returns the MRO of an object's class, or of the object itself if it's a class."""
+    if not hasattr(obj, "__mro__"):
+        # N.B. we cannot use `if type(obj) is type` here because it doesn't work with
+        # some types of classes, such as the ones that use abc.ABCMeta.
+        obj = type(obj)
+    return getattr(obj, "__mro__", ())
+
+
+def get_object_types_mro_as_strings(obj: object) -> Collection[str]:
+    """
+    Returns the MRO of an object's class as full qualified names, or of the object itself if it's a class.
+
+    Examples:
+        `object_types_mro_as_strings(JSONDecoder)` will return `['json.decoder.JSONDecoder', 'builtins.object']`
+    """
+    return [
+        f'{getattr(type_, "__module__", "")}.{getattr(type_, "__qualname__", "")}'
+        for type_ in get_object_types_mro(obj)
+    ]
+
+
+def is_object_one_of_types(
+    obj: object, fully_qualified_types_names: Collection[str]
+) -> bool:
+    """
+    Returns `True` if the given object's class (or the object itself, if it's a class) has one of the
+    fully qualified names in its MRO.
+    """
+    for type_name in get_object_types_mro_as_strings(obj):
+        if type_name in fully_qualified_types_names:
+            return True
+    return False
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/_log_render.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/_log_render.py
new file mode 100644
index 0000000..fc16c84
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/_log_render.py
@@ -0,0 +1,94 @@
+from datetime import datetime
+from typing import Iterable, List, Optional, TYPE_CHECKING, Union, Callable
+
+
+from .text import Text, TextType
+
+if TYPE_CHECKING:
+    from .console import Console, ConsoleRenderable, RenderableType
+    from .table import Table
+
+FormatTimeCallable = Callable[[datetime], Text]
+
+
+class LogRender:
+    def __init__(
+        self,
+        show_time: bool = True,
+        show_level: bool = False,
+        show_path: bool = True,
+        time_format: Union[str, FormatTimeCallable] = "[%x %X]",
+        omit_repeated_times: bool = True,
+        level_width: Optional[int] = 8,
+    ) -> None:
+        self.show_time = show_time
+        self.show_level = show_level
+        self.show_path = show_path
+        self.time_format = time_format
+        self.omit_repeated_times = omit_repeated_times
+        self.level_width = level_width
+        self._last_time: Optional[Text] = None
+
+    def __call__(
+        self,
+        console: "Console",
+        renderables: Iterable["ConsoleRenderable"],
+        log_time: Optional[datetime] = None,
+        time_format: Optional[Union[str, FormatTimeCallable]] = None,
+        level: TextType = "",
+        path: Optional[str] = None,
+        line_no: Optional[int] = None,
+        link_path: Optional[str] = None,
+    ) -> "Table":
+        from .containers import Renderables
+        from .table import Table
+
+        output = Table.grid(padding=(0, 1))
+        output.expand = True
+        if self.show_time:
+            output.add_column(style="log.time")
+        if self.show_level:
+            output.add_column(style="log.level", width=self.level_width)
+        output.add_column(ratio=1, style="log.message", overflow="fold")
+        if self.show_path and path:
+            output.add_column(style="log.path")
+        row: List["RenderableType"] = []
+        if self.show_time:
+            log_time = log_time or console.get_datetime()
+            time_format = time_format or self.time_format
+            if callable(time_format):
+                log_time_display = time_format(log_time)
+            else:
+                log_time_display = Text(log_time.strftime(time_format))
+            if log_time_display == self._last_time and self.omit_repeated_times:
+                row.append(Text(" " * len(log_time_display)))
+            else:
+                row.append(log_time_display)
+                self._last_time = log_time_display
+        if self.show_level:
+            row.append(level)
+
+        row.append(Renderables(renderables))
+        if self.show_path and path:
+            path_text = Text()
+            path_text.append(
+                path, style=f"link file://{link_path}" if link_path else ""
+            )
+            if line_no:
+                path_text.append(":")
+                path_text.append(
+                    f"{line_no}",
+                    style=f"link file://{link_path}#{line_no}" if link_path else "",
+                )
+            row.append(path_text)
+
+        output.add_row(*row)
+        return output
+
+
+if __name__ == "__main__":  # pragma: no cover
+    from pip._vendor.rich.console import Console
+
+    c = Console()
+    c.print("[on blue]Hello", justify="right")
+    c.log("[on blue]hello", justify="right")
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/_loop.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/_loop.py
new file mode 100644
index 0000000..01c6caf
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/_loop.py
@@ -0,0 +1,43 @@
+from typing import Iterable, Tuple, TypeVar
+
+T = TypeVar("T")
+
+
+def loop_first(values: Iterable[T]) -> Iterable[Tuple[bool, T]]:
+    """Iterate and generate a tuple with a flag for first value."""
+    iter_values = iter(values)
+    try:
+        value = next(iter_values)
+    except StopIteration:
+        return
+    yield True, value
+    for value in iter_values:
+        yield False, value
+
+
+def loop_last(values: Iterable[T]) -> Iterable[Tuple[bool, T]]:
+    """Iterate and generate a tuple with a flag for last value."""
+    iter_values = iter(values)
+    try:
+        previous_value = next(iter_values)
+    except StopIteration:
+        return
+    for value in iter_values:
+        yield False, previous_value
+        previous_value = value
+    yield True, previous_value
+
+
+def loop_first_last(values: Iterable[T]) -> Iterable[Tuple[bool, bool, T]]:
+    """Iterate and generate a tuple with a flag for first and last value."""
+    iter_values = iter(values)
+    try:
+        previous_value = next(iter_values)
+    except StopIteration:
+        return
+    first = True
+    for value in iter_values:
+        yield first, False, previous_value
+        first = False
+        previous_value = value
+    yield first, True, previous_value
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/_null_file.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/_null_file.py
new file mode 100644
index 0000000..6ae05d3
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/_null_file.py
@@ -0,0 +1,69 @@
+from types import TracebackType
+from typing import IO, Iterable, Iterator, List, Optional, Type
+
+
+class NullFile(IO[str]):
+    def close(self) -> None:
+        pass
+
+    def isatty(self) -> bool:
+        return False
+
+    def read(self, __n: int = 1) -> str:
+        return ""
+
+    def readable(self) -> bool:
+        return False
+
+    def readline(self, __limit: int = 1) -> str:
+        return ""
+
+    def readlines(self, __hint: int = 1) -> List[str]:
+        return []
+
+    def seek(self, __offset: int, __whence: int = 1) -> int:
+        return 0
+
+    def seekable(self) -> bool:
+        return False
+
+    def tell(self) -> int:
+        return 0
+
+    def truncate(self, __size: Optional[int] = 1) -> int:
+        return 0
+
+    def writable(self) -> bool:
+        return False
+
+    def writelines(self, __lines: Iterable[str]) -> None:
+        pass
+
+    def __next__(self) -> str:
+        return ""
+
+    def __iter__(self) -> Iterator[str]:
+        return iter([""])
+
+    def __enter__(self) -> IO[str]:
+        return self
+
+    def __exit__(
+        self,
+        __t: Optional[Type[BaseException]],
+        __value: Optional[BaseException],
+        __traceback: Optional[TracebackType],
+    ) -> None:
+        pass
+
+    def write(self, text: str) -> int:
+        return 0
+
+    def flush(self) -> None:
+        pass
+
+    def fileno(self) -> int:
+        return -1
+
+
+NULL_FILE = NullFile()
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/_palettes.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/_palettes.py
new file mode 100644
index 0000000..3c748d3
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/_palettes.py
@@ -0,0 +1,309 @@
+from .palette import Palette
+
+
+# Taken from https://en.wikipedia.org/wiki/ANSI_escape_code (Windows 10 column)
+WINDOWS_PALETTE = Palette(
+    [
+        (12, 12, 12),
+        (197, 15, 31),
+        (19, 161, 14),
+        (193, 156, 0),
+        (0, 55, 218),
+        (136, 23, 152),
+        (58, 150, 221),
+        (204, 204, 204),
+        (118, 118, 118),
+        (231, 72, 86),
+        (22, 198, 12),
+        (249, 241, 165),
+        (59, 120, 255),
+        (180, 0, 158),
+        (97, 214, 214),
+        (242, 242, 242),
+    ]
+)
+
+# # The standard ansi colors (including bright variants)
+STANDARD_PALETTE = Palette(
+    [
+        (0, 0, 0),
+        (170, 0, 0),
+        (0, 170, 0),
+        (170, 85, 0),
+        (0, 0, 170),
+        (170, 0, 170),
+        (0, 170, 170),
+        (170, 170, 170),
+        (85, 85, 85),
+        (255, 85, 85),
+        (85, 255, 85),
+        (255, 255, 85),
+        (85, 85, 255),
+        (255, 85, 255),
+        (85, 255, 255),
+        (255, 255, 255),
+    ]
+)
+
+
+# The 256 color palette
+EIGHT_BIT_PALETTE = Palette(
+    [
+        (0, 0, 0),
+        (128, 0, 0),
+        (0, 128, 0),
+        (128, 128, 0),
+        (0, 0, 128),
+        (128, 0, 128),
+        (0, 128, 128),
+        (192, 192, 192),
+        (128, 128, 128),
+        (255, 0, 0),
+        (0, 255, 0),
+        (255, 255, 0),
+        (0, 0, 255),
+        (255, 0, 255),
+        (0, 255, 255),
+        (255, 255, 255),
+        (0, 0, 0),
+        (0, 0, 95),
+        (0, 0, 135),
+        (0, 0, 175),
+        (0, 0, 215),
+        (0, 0, 255),
+        (0, 95, 0),
+        (0, 95, 95),
+        (0, 95, 135),
+        (0, 95, 175),
+        (0, 95, 215),
+        (0, 95, 255),
+        (0, 135, 0),
+        (0, 135, 95),
+        (0, 135, 135),
+        (0, 135, 175),
+        (0, 135, 215),
+        (0, 135, 255),
+        (0, 175, 0),
+        (0, 175, 95),
+        (0, 175, 135),
+        (0, 175, 175),
+        (0, 175, 215),
+        (0, 175, 255),
+        (0, 215, 0),
+        (0, 215, 95),
+        (0, 215, 135),
+        (0, 215, 175),
+        (0, 215, 215),
+        (0, 215, 255),
+        (0, 255, 0),
+        (0, 255, 95),
+        (0, 255, 135),
+        (0, 255, 175),
+        (0, 255, 215),
+        (0, 255, 255),
+        (95, 0, 0),
+        (95, 0, 95),
+        (95, 0, 135),
+        (95, 0, 175),
+        (95, 0, 215),
+        (95, 0, 255),
+        (95, 95, 0),
+        (95, 95, 95),
+        (95, 95, 135),
+        (95, 95, 175),
+        (95, 95, 215),
+        (95, 95, 255),
+        (95, 135, 0),
+        (95, 135, 95),
+        (95, 135, 135),
+        (95, 135, 175),
+        (95, 135, 215),
+        (95, 135, 255),
+        (95, 175, 0),
+        (95, 175, 95),
+        (95, 175, 135),
+        (95, 175, 175),
+        (95, 175, 215),
+        (95, 175, 255),
+        (95, 215, 0),
+        (95, 215, 95),
+        (95, 215, 135),
+        (95, 215, 175),
+        (95, 215, 215),
+        (95, 215, 255),
+        (95, 255, 0),
+        (95, 255, 95),
+        (95, 255, 135),
+        (95, 255, 175),
+        (95, 255, 215),
+        (95, 255, 255),
+        (135, 0, 0),
+        (135, 0, 95),
+        (135, 0, 135),
+        (135, 0, 175),
+        (135, 0, 215),
+        (135, 0, 255),
+        (135, 95, 0),
+        (135, 95, 95),
+        (135, 95, 135),
+        (135, 95, 175),
+        (135, 95, 215),
+        (135, 95, 255),
+        (135, 135, 0),
+        (135, 135, 95),
+        (135, 135, 135),
+        (135, 135, 175),
+        (135, 135, 215),
+        (135, 135, 255),
+        (135, 175, 0),
+        (135, 175, 95),
+        (135, 175, 135),
+        (135, 175, 175),
+        (135, 175, 215),
+        (135, 175, 255),
+        (135, 215, 0),
+        (135, 215, 95),
+        (135, 215, 135),
+        (135, 215, 175),
+        (135, 215, 215),
+        (135, 215, 255),
+        (135, 255, 0),
+        (135, 255, 95),
+        (135, 255, 135),
+        (135, 255, 175),
+        (135, 255, 215),
+        (135, 255, 255),
+        (175, 0, 0),
+        (175, 0, 95),
+        (175, 0, 135),
+        (175, 0, 175),
+        (175, 0, 215),
+        (175, 0, 255),
+        (175, 95, 0),
+        (175, 95, 95),
+        (175, 95, 135),
+        (175, 95, 175),
+        (175, 95, 215),
+        (175, 95, 255),
+        (175, 135, 0),
+        (175, 135, 95),
+        (175, 135, 135),
+        (175, 135, 175),
+        (175, 135, 215),
+        (175, 135, 255),
+        (175, 175, 0),
+        (175, 175, 95),
+        (175, 175, 135),
+        (175, 175, 175),
+        (175, 175, 215),
+        (175, 175, 255),
+        (175, 215, 0),
+        (175, 215, 95),
+        (175, 215, 135),
+        (175, 215, 175),
+        (175, 215, 215),
+        (175, 215, 255),
+        (175, 255, 0),
+        (175, 255, 95),
+        (175, 255, 135),
+        (175, 255, 175),
+        (175, 255, 215),
+        (175, 255, 255),
+        (215, 0, 0),
+        (215, 0, 95),
+        (215, 0, 135),
+        (215, 0, 175),
+        (215, 0, 215),
+        (215, 0, 255),
+        (215, 95, 0),
+        (215, 95, 95),
+        (215, 95, 135),
+        (215, 95, 175),
+        (215, 95, 215),
+        (215, 95, 255),
+        (215, 135, 0),
+        (215, 135, 95),
+        (215, 135, 135),
+        (215, 135, 175),
+        (215, 135, 215),
+        (215, 135, 255),
+        (215, 175, 0),
+        (215, 175, 95),
+        (215, 175, 135),
+        (215, 175, 175),
+        (215, 175, 215),
+        (215, 175, 255),
+        (215, 215, 0),
+        (215, 215, 95),
+        (215, 215, 135),
+        (215, 215, 175),
+        (215, 215, 215),
+        (215, 215, 255),
+        (215, 255, 0),
+        (215, 255, 95),
+        (215, 255, 135),
+        (215, 255, 175),
+        (215, 255, 215),
+        (215, 255, 255),
+        (255, 0, 0),
+        (255, 0, 95),
+        (255, 0, 135),
+        (255, 0, 175),
+        (255, 0, 215),
+        (255, 0, 255),
+        (255, 95, 0),
+        (255, 95, 95),
+        (255, 95, 135),
+        (255, 95, 175),
+        (255, 95, 215),
+        (255, 95, 255),
+        (255, 135, 0),
+        (255, 135, 95),
+        (255, 135, 135),
+        (255, 135, 175),
+        (255, 135, 215),
+        (255, 135, 255),
+        (255, 175, 0),
+        (255, 175, 95),
+        (255, 175, 135),
+        (255, 175, 175),
+        (255, 175, 215),
+        (255, 175, 255),
+        (255, 215, 0),
+        (255, 215, 95),
+        (255, 215, 135),
+        (255, 215, 175),
+        (255, 215, 215),
+        (255, 215, 255),
+        (255, 255, 0),
+        (255, 255, 95),
+        (255, 255, 135),
+        (255, 255, 175),
+        (255, 255, 215),
+        (255, 255, 255),
+        (8, 8, 8),
+        (18, 18, 18),
+        (28, 28, 28),
+        (38, 38, 38),
+        (48, 48, 48),
+        (58, 58, 58),
+        (68, 68, 68),
+        (78, 78, 78),
+        (88, 88, 88),
+        (98, 98, 98),
+        (108, 108, 108),
+        (118, 118, 118),
+        (128, 128, 128),
+        (138, 138, 138),
+        (148, 148, 148),
+        (158, 158, 158),
+        (168, 168, 168),
+        (178, 178, 178),
+        (188, 188, 188),
+        (198, 198, 198),
+        (208, 208, 208),
+        (218, 218, 218),
+        (228, 228, 228),
+        (238, 238, 238),
+    ]
+)
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/_pick.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/_pick.py
new file mode 100644
index 0000000..4f6d8b2
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/_pick.py
@@ -0,0 +1,17 @@
+from typing import Optional
+
+
+def pick_bool(*values: Optional[bool]) -> bool:
+    """Pick the first non-none bool or return the last value.
+
+    Args:
+        *values (bool): Any number of boolean or None values.
+
+    Returns:
+        bool: First non-none boolean.
+    """
+    assert values, "1 or more values required"
+    for value in values:
+        if value is not None:
+            return value
+    return bool(value)
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/_ratio.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/_ratio.py
new file mode 100644
index 0000000..95267b0
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/_ratio.py
@@ -0,0 +1,159 @@
+import sys
+from fractions import Fraction
+from math import ceil
+from typing import cast, List, Optional, Sequence
+
+if sys.version_info >= (3, 8):
+    from typing import Protocol
+else:
+    from pip._vendor.typing_extensions import Protocol  # pragma: no cover
+
+
+class Edge(Protocol):
+    """Any object that defines an edge (such as Layout)."""
+
+    size: Optional[int] = None
+    ratio: int = 1
+    minimum_size: int = 1
+
+
+def ratio_resolve(total: int, edges: Sequence[Edge]) -> List[int]:
+    """Divide total space to satisfy size, ratio, and minimum_size, constraints.
+
+    The returned list of integers should add up to total in most cases, unless it is
+    impossible to satisfy all the constraints. For instance, if there are two edges
+    with a minimum size of 20 each and `total` is 30 then the returned list will be
+    greater than total. In practice, this would mean that a Layout object would
+    clip the rows that would overflow the screen height.
+
+    Args:
+        total (int): Total number of characters.
+        edges (List[Edge]): Edges within total space.
+
+    Returns:
+        List[int]: Number of characters for each edge.
+    """
+    # Size of edge or None for yet to be determined
+    sizes = [(edge.size or None) for edge in edges]
+
+    _Fraction = Fraction
+
+    # While any edges haven't been calculated
+    while None in sizes:
+        # Get flexible edges and index to map these back on to sizes list
+        flexible_edges = [
+            (index, edge)
+            for index, (size, edge) in enumerate(zip(sizes, edges))
+            if size is None
+        ]
+        # Remaining space in total
+        remaining = total - sum(size or 0 for size in sizes)
+        if remaining <= 0:
+            # No room for flexible edges
+            return [
+                ((edge.minimum_size or 1) if size is None else size)
+                for size, edge in zip(sizes, edges)
+            ]
+        # Calculate number of characters in a ratio portion
+        portion = _Fraction(
+            remaining, sum((edge.ratio or 1) for _, edge in flexible_edges)
+        )
+
+        # If any edges will be less than their minimum, replace size with the minimum
+        for index, edge in flexible_edges:
+            if portion * edge.ratio <= edge.minimum_size:
+                sizes[index] = edge.minimum_size
+                # New fixed size will invalidate calculations, so we need to repeat the process
+                break
+        else:
+            # Distribute flexible space and compensate for rounding error
+            # Since edge sizes can only be integers we need to add the remainder
+            # to the following line
+            remainder = _Fraction(0)
+            for index, edge in flexible_edges:
+                size, remainder = divmod(portion * edge.ratio + remainder, 1)
+                sizes[index] = size
+            break
+    # Sizes now contains integers only
+    return cast(List[int], sizes)
+
+
+def ratio_reduce(
+    total: int, ratios: List[int], maximums: List[int], values: List[int]
+) -> List[int]:
+    """Divide an integer total in to parts based on ratios.
+
+    Args:
+        total (int): The total to divide.
+        ratios (List[int]): A list of integer ratios.
+        maximums (List[int]): List of maximums values for each slot.
+        values (List[int]): List of values
+
+    Returns:
+        List[int]: A list of integers guaranteed to sum to total.
+    """
+    ratios = [ratio if _max else 0 for ratio, _max in zip(ratios, maximums)]
+    total_ratio = sum(ratios)
+    if not total_ratio:
+        return values[:]
+    total_remaining = total
+    result: List[int] = []
+    append = result.append
+    for ratio, maximum, value in zip(ratios, maximums, values):
+        if ratio and total_ratio > 0:
+            distributed = min(maximum, round(ratio * total_remaining / total_ratio))
+            append(value - distributed)
+            total_remaining -= distributed
+            total_ratio -= ratio
+        else:
+            append(value)
+    return result
+
+
+def ratio_distribute(
+    total: int, ratios: List[int], minimums: Optional[List[int]] = None
+) -> List[int]:
+    """Distribute an integer total in to parts based on ratios.
+
+    Args:
+        total (int): The total to divide.
+        ratios (List[int]): A list of integer ratios.
+        minimums (List[int]): List of minimum values for each slot.
+
+    Returns:
+        List[int]: A list of integers guaranteed to sum to total.
+    """
+    if minimums:
+        ratios = [ratio if _min else 0 for ratio, _min in zip(ratios, minimums)]
+    total_ratio = sum(ratios)
+    assert total_ratio > 0, "Sum of ratios must be > 0"
+
+    total_remaining = total
+    distributed_total: List[int] = []
+    append = distributed_total.append
+    if minimums is None:
+        _minimums = [0] * len(ratios)
+    else:
+        _minimums = minimums
+    for ratio, minimum in zip(ratios, _minimums):
+        if total_ratio > 0:
+            distributed = max(minimum, ceil(ratio * total_remaining / total_ratio))
+        else:
+            distributed = total_remaining
+        append(distributed)
+        total_ratio -= ratio
+        total_remaining -= distributed
+    return distributed_total
+
+
+if __name__ == "__main__":
+    from dataclasses import dataclass
+
+    @dataclass
+    class E:
+        size: Optional[int] = None
+        ratio: int = 1
+        minimum_size: int = 1
+
+    resolved = ratio_resolve(110, [E(None, 1, 1), E(None, 1, 1), E(None, 1, 1)])
+    print(sum(resolved))
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/_spinners.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/_spinners.py
new file mode 100644
index 0000000..d0bb1fe
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/_spinners.py
@@ -0,0 +1,482 @@
+"""
+Spinners are from:
+* cli-spinners:
+    MIT License
+    Copyright (c) Sindre Sorhus  (sindresorhus.com)
+    Permission is hereby granted, free of charge, to any person obtaining a copy
+    of this software and associated documentation files (the "Software"), to deal
+    in the Software without restriction, including without limitation the rights to
+    use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
+    the Software, and to permit persons to whom the Software is furnished to do so,
+    subject to the following conditions:
+    The above copyright notice and this permission notice shall be included
+    in all copies or substantial portions of the Software.
+    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
+    INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR
+    PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE
+    FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
+    ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
+    IN THE SOFTWARE.
+"""
+
+SPINNERS = {
+    "dots": {
+        "interval": 80,
+        "frames": "⠋⠙⠹⠸⠼⠴⠦⠧⠇⠏",
+    },
+    "dots2": {"interval": 80, "frames": "⣾⣽⣻⢿⡿⣟⣯⣷"},
+    "dots3": {
+        "interval": 80,
+        "frames": "⠋⠙⠚⠞⠖⠦⠴⠲⠳⠓",
+    },
+    "dots4": {
+        "interval": 80,
+        "frames": "⠄⠆⠇⠋⠙⠸⠰⠠⠰⠸⠙⠋⠇⠆",
+    },
+    "dots5": {
+        "interval": 80,
+        "frames": "⠋⠙⠚⠒⠂⠂⠒⠲⠴⠦⠖⠒⠐⠐⠒⠓⠋",
+    },
+    "dots6": {
+        "interval": 80,
+        "frames": "⠁⠉⠙⠚⠒⠂⠂⠒⠲⠴⠤⠄⠄⠤⠴⠲⠒⠂⠂⠒⠚⠙⠉⠁",
+    },
+    "dots7": {
+        "interval": 80,
+        "frames": "⠈⠉⠋⠓⠒⠐⠐⠒⠖⠦⠤⠠⠠⠤⠦⠖⠒⠐⠐⠒⠓⠋⠉⠈",
+    },
+    "dots8": {
+        "interval": 80,
+        "frames": "⠁⠁⠉⠙⠚⠒⠂⠂⠒⠲⠴⠤⠄⠄⠤⠠⠠⠤⠦⠖⠒⠐⠐⠒⠓⠋⠉⠈⠈",
+    },
+    "dots9": {"interval": 80, "frames": "⢹⢺⢼⣸⣇⡧⡗⡏"},
+    "dots10": {"interval": 80, "frames": "⢄⢂⢁⡁⡈⡐⡠"},
+    "dots11": {"interval": 100, "frames": "⠁⠂⠄⡀⢀⠠⠐⠈"},
+    "dots12": {
+        "interval": 80,
+        "frames": [
+            "⢀⠀",
+            "⡀⠀",
+            "⠄⠀",
+            "⢂⠀",
+            "⡂⠀",
+            "⠅⠀",
+            "⢃⠀",
+            "⡃⠀",
+            "⠍⠀",
+            "⢋⠀",
+            "⡋⠀",
+            "⠍⠁",
+            "⢋⠁",
+            "⡋⠁",
+            "⠍⠉",
+            "⠋⠉",
+            "⠋⠉",
+            "⠉⠙",
+            "⠉⠙",
+            "⠉⠩",
+            "⠈⢙",
+            "⠈⡙",
+            "⢈⠩",
+            "⡀⢙",
+            "⠄⡙",
+            "⢂⠩",
+            "⡂⢘",
+            "⠅⡘",
+            "⢃⠨",
+            "⡃⢐",
+            "⠍⡐",
+            "⢋⠠",
+            "⡋⢀",
+            "⠍⡁",
+            "⢋⠁",
+            "⡋⠁",
+            "⠍⠉",
+            "⠋⠉",
+            "⠋⠉",
+            "⠉⠙",
+            "⠉⠙",
+            "⠉⠩",
+            "⠈⢙",
+            "⠈⡙",
+            "⠈⠩",
+            "⠀⢙",
+            "⠀⡙",
+            "⠀⠩",
+            "⠀⢘",
+            "⠀⡘",
+            "⠀⠨",
+            "⠀⢐",
+            "⠀⡐",
+            "⠀⠠",
+            "⠀⢀",
+            "⠀⡀",
+        ],
+    },
+    "dots8Bit": {
+        "interval": 80,
+        "frames": "⠀⠁⠂⠃⠄⠅⠆⠇⡀⡁⡂⡃⡄⡅⡆⡇⠈⠉⠊⠋⠌⠍⠎⠏⡈⡉⡊⡋⡌⡍⡎⡏⠐⠑⠒⠓⠔⠕⠖⠗⡐⡑⡒⡓⡔⡕⡖⡗⠘⠙⠚⠛⠜⠝⠞⠟⡘⡙"
+        "⡚⡛⡜⡝⡞⡟⠠⠡⠢⠣⠤⠥⠦⠧⡠⡡⡢⡣⡤⡥⡦⡧⠨⠩⠪⠫⠬⠭⠮⠯⡨⡩⡪⡫⡬⡭⡮⡯⠰⠱⠲⠳⠴⠵⠶⠷⡰⡱⡲⡳⡴⡵⡶⡷⠸⠹⠺⠻"
+        "⠼⠽⠾⠿⡸⡹⡺⡻⡼⡽⡾⡿⢀⢁⢂⢃⢄⢅⢆⢇⣀⣁⣂⣃⣄⣅⣆⣇⢈⢉⢊⢋⢌⢍⢎⢏⣈⣉⣊⣋⣌⣍⣎⣏⢐⢑⢒⢓⢔⢕⢖⢗⣐⣑⣒⣓⣔⣕"
+        "⣖⣗⢘⢙⢚⢛⢜⢝⢞⢟⣘⣙⣚⣛⣜⣝⣞⣟⢠⢡⢢⢣⢤⢥⢦⢧⣠⣡⣢⣣⣤⣥⣦⣧⢨⢩⢪⢫⢬⢭⢮⢯⣨⣩⣪⣫⣬⣭⣮⣯⢰⢱⢲⢳⢴⢵⢶⢷"
+        "⣰⣱⣲⣳⣴⣵⣶⣷⢸⢹⢺⢻⢼⢽⢾⢿⣸⣹⣺⣻⣼⣽⣾⣿",
+    },
+    "line": {"interval": 130, "frames": ["-", "\\", "|", "/"]},
+    "line2": {"interval": 100, "frames": "⠂-–—–-"},
+    "pipe": {"interval": 100, "frames": "┤┘┴└├┌┬┐"},
+    "simpleDots": {"interval": 400, "frames": [".  ", ".. ", "...", "   "]},
+    "simpleDotsScrolling": {
+        "interval": 200,
+        "frames": [".  ", ".. ", "...", " ..", "  .", "   "],
+    },
+    "star": {"interval": 70, "frames": "✶✸✹✺✹✷"},
+    "star2": {"interval": 80, "frames": "+x*"},
+    "flip": {
+        "interval": 70,
+        "frames": "___-``'´-___",
+    },
+    "hamburger": {"interval": 100, "frames": "☱☲☴"},
+    "growVertical": {
+        "interval": 120,
+        "frames": "▁▃▄▅▆▇▆▅▄▃",
+    },
+    "growHorizontal": {
+        "interval": 120,
+        "frames": "▏▎▍▌▋▊▉▊▋▌▍▎",
+    },
+    "balloon": {"interval": 140, "frames": " .oO@* "},
+    "balloon2": {"interval": 120, "frames": ".oO°Oo."},
+    "noise": {"interval": 100, "frames": "▓▒░"},
+    "bounce": {"interval": 120, "frames": "⠁⠂⠄⠂"},
+    "boxBounce": {"interval": 120, "frames": "▖▘▝▗"},
+    "boxBounce2": {"interval": 100, "frames": "▌▀▐▄"},
+    "triangle": {"interval": 50, "frames": "◢◣◤◥"},
+    "arc": {"interval": 100, "frames": "◜◠◝◞◡◟"},
+    "circle": {"interval": 120, "frames": "◡⊙◠"},
+    "squareCorners": {"interval": 180, "frames": "◰◳◲◱"},
+    "circleQuarters": {"interval": 120, "frames": "◴◷◶◵"},
+    "circleHalves": {"interval": 50, "frames": "◐◓◑◒"},
+    "squish": {"interval": 100, "frames": "╫╪"},
+    "toggle": {"interval": 250, "frames": "⊶⊷"},
+    "toggle2": {"interval": 80, "frames": "▫▪"},
+    "toggle3": {"interval": 120, "frames": "□■"},
+    "toggle4": {"interval": 100, "frames": "■□▪▫"},
+    "toggle5": {"interval": 100, "frames": "▮▯"},
+    "toggle6": {"interval": 300, "frames": "ဝ၀"},
+    "toggle7": {"interval": 80, "frames": "⦾⦿"},
+    "toggle8": {"interval": 100, "frames": "◍◌"},
+    "toggle9": {"interval": 100, "frames": "◉◎"},
+    "toggle10": {"interval": 100, "frames": "㊂㊀㊁"},
+    "toggle11": {"interval": 50, "frames": "⧇⧆"},
+    "toggle12": {"interval": 120, "frames": "☗☖"},
+    "toggle13": {"interval": 80, "frames": "=*-"},
+    "arrow": {"interval": 100, "frames": "←↖↑↗→↘↓↙"},
+    "arrow2": {
+        "interval": 80,
+        "frames": ["⬆️ ", "↗️ ", "➡️ ", "↘️ ", "⬇️ ", "↙️ ", "⬅️ ", "↖️ "],
+    },
+    "arrow3": {
+        "interval": 120,
+        "frames": ["▹▹▹▹▹", "▸▹▹▹▹", "▹▸▹▹▹", "▹▹▸▹▹", "▹▹▹▸▹", "▹▹▹▹▸"],
+    },
+    "bouncingBar": {
+        "interval": 80,
+        "frames": [
+            "[    ]",
+            "[=   ]",
+            "[==  ]",
+            "[=== ]",
+            "[ ===]",
+            "[  ==]",
+            "[   =]",
+            "[    ]",
+            "[   =]",
+            "[  ==]",
+            "[ ===]",
+            "[====]",
+            "[=== ]",
+            "[==  ]",
+            "[=   ]",
+        ],
+    },
+    "bouncingBall": {
+        "interval": 80,
+        "frames": [
+            "( ●    )",
+            "(  ●   )",
+            "(   ●  )",
+            "(    ● )",
+            "(     ●)",
+            "(    ● )",
+            "(   ●  )",
+            "(  ●   )",
+            "( ●    )",
+            "(●     )",
+        ],
+    },
+    "smiley": {"interval": 200, "frames": ["😄 ", "😝 "]},
+    "monkey": {"interval": 300, "frames": ["🙈 ", "🙈 ", "🙉 ", "🙊 "]},
+    "hearts": {"interval": 100, "frames": ["💛 ", "💙 ", "💜 ", "💚 ", "❤️ "]},
+    "clock": {
+        "interval": 100,
+        "frames": [
+            "🕛 ",
+            "🕐 ",
+            "🕑 ",
+            "🕒 ",
+            "🕓 ",
+            "🕔 ",
+            "🕕 ",
+            "🕖 ",
+            "🕗 ",
+            "🕘 ",
+            "🕙 ",
+            "🕚 ",
+        ],
+    },
+    "earth": {"interval": 180, "frames": ["🌍 ", "🌎 ", "🌏 "]},
+    "material": {
+        "interval": 17,
+        "frames": [
+            "█▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁",
+            "██▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁",
+            "███▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁",
+            "████▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁",
+            "██████▁▁▁▁▁▁▁▁▁▁▁▁▁▁",
+            "██████▁▁▁▁▁▁▁▁▁▁▁▁▁▁",
+            "███████▁▁▁▁▁▁▁▁▁▁▁▁▁",
+            "████████▁▁▁▁▁▁▁▁▁▁▁▁",
+            "█████████▁▁▁▁▁▁▁▁▁▁▁",
+            "█████████▁▁▁▁▁▁▁▁▁▁▁",
+            "██████████▁▁▁▁▁▁▁▁▁▁",
+            "███████████▁▁▁▁▁▁▁▁▁",
+            "█████████████▁▁▁▁▁▁▁",
+            "██████████████▁▁▁▁▁▁",
+            "██████████████▁▁▁▁▁▁",
+            "▁██████████████▁▁▁▁▁",
+            "▁██████████████▁▁▁▁▁",
+            "▁██████████████▁▁▁▁▁",
+            "▁▁██████████████▁▁▁▁",
+            "▁▁▁██████████████▁▁▁",
+            "▁▁▁▁█████████████▁▁▁",
+            "▁▁▁▁██████████████▁▁",
+            "▁▁▁▁██████████████▁▁",
+            "▁▁▁▁▁██████████████▁",
+            "▁▁▁▁▁██████████████▁",
+            "▁▁▁▁▁██████████████▁",
+            "▁▁▁▁▁▁██████████████",
+            "▁▁▁▁▁▁██████████████",
+            "▁▁▁▁▁▁▁█████████████",
+            "▁▁▁▁▁▁▁█████████████",
+            "▁▁▁▁▁▁▁▁████████████",
+            "▁▁▁▁▁▁▁▁████████████",
+            "▁▁▁▁▁▁▁▁▁███████████",
+            "▁▁▁▁▁▁▁▁▁███████████",
+            "▁▁▁▁▁▁▁▁▁▁██████████",
+            "▁▁▁▁▁▁▁▁▁▁██████████",
+            "▁▁▁▁▁▁▁▁▁▁▁▁████████",
+            "▁▁▁▁▁▁▁▁▁▁▁▁▁███████",
+            "▁▁▁▁▁▁▁▁▁▁▁▁▁▁██████",
+            "▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁█████",
+            "▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁█████",
+            "█▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁████",
+            "██▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁███",
+            "██▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁███",
+            "███▁▁▁▁▁▁▁▁▁▁▁▁▁▁███",
+            "████▁▁▁▁▁▁▁▁▁▁▁▁▁▁██",
+            "█████▁▁▁▁▁▁▁▁▁▁▁▁▁▁█",
+            "█████▁▁▁▁▁▁▁▁▁▁▁▁▁▁█",
+            "██████▁▁▁▁▁▁▁▁▁▁▁▁▁█",
+            "████████▁▁▁▁▁▁▁▁▁▁▁▁",
+            "█████████▁▁▁▁▁▁▁▁▁▁▁",
+            "█████████▁▁▁▁▁▁▁▁▁▁▁",
+            "█████████▁▁▁▁▁▁▁▁▁▁▁",
+            "█████████▁▁▁▁▁▁▁▁▁▁▁",
+            "███████████▁▁▁▁▁▁▁▁▁",
+            "████████████▁▁▁▁▁▁▁▁",
+            "████████████▁▁▁▁▁▁▁▁",
+            "██████████████▁▁▁▁▁▁",
+            "██████████████▁▁▁▁▁▁",
+            "▁██████████████▁▁▁▁▁",
+            "▁██████████████▁▁▁▁▁",
+            "▁▁▁█████████████▁▁▁▁",
+            "▁▁▁▁▁████████████▁▁▁",
+            "▁▁▁▁▁████████████▁▁▁",
+            "▁▁▁▁▁▁███████████▁▁▁",
+            "▁▁▁▁▁▁▁▁█████████▁▁▁",
+            "▁▁▁▁▁▁▁▁█████████▁▁▁",
+            "▁▁▁▁▁▁▁▁▁█████████▁▁",
+            "▁▁▁▁▁▁▁▁▁█████████▁▁",
+            "▁▁▁▁▁▁▁▁▁▁█████████▁",
+            "▁▁▁▁▁▁▁▁▁▁▁████████▁",
+            "▁▁▁▁▁▁▁▁▁▁▁████████▁",
+            "▁▁▁▁▁▁▁▁▁▁▁▁███████▁",
+            "▁▁▁▁▁▁▁▁▁▁▁▁███████▁",
+            "▁▁▁▁▁▁▁▁▁▁▁▁▁███████",
+            "▁▁▁▁▁▁▁▁▁▁▁▁▁███████",
+            "▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁█████",
+            "▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁████",
+            "▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁████",
+            "▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁████",
+            "▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁███",
+            "▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁███",
+            "▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁██",
+            "▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁██",
+            "▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁██",
+            "▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁█",
+            "▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁█",
+            "▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁█",
+            "▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁",
+            "▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁",
+            "▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁",
+            "▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁",
+        ],
+    },
+    "moon": {
+        "interval": 80,
+        "frames": ["🌑 ", "🌒 ", "🌓 ", "🌔 ", "🌕 ", "🌖 ", "🌗 ", "🌘 "],
+    },
+    "runner": {"interval": 140, "frames": ["🚶 ", "🏃 "]},
+    "pong": {
+        "interval": 80,
+        "frames": [
+            "▐⠂       ▌",
+            "▐⠈       ▌",
+            "▐ ⠂      ▌",
+            "▐ ⠠      ▌",
+            "▐  ⡀     ▌",
+            "▐  ⠠     ▌",
+            "▐   ⠂    ▌",
+            "▐   ⠈    ▌",
+            "▐    ⠂   ▌",
+            "▐    ⠠   ▌",
+            "▐     ⡀  ▌",
+            "▐     ⠠  ▌",
+            "▐      ⠂ ▌",
+            "▐      ⠈ ▌",
+            "▐       ⠂▌",
+            "▐       ⠠▌",
+            "▐       ⡀▌",
+            "▐      ⠠ ▌",
+            "▐      ⠂ ▌",
+            "▐     ⠈  ▌",
+            "▐     ⠂  ▌",
+            "▐    ⠠   ▌",
+            "▐    ⡀   ▌",
+            "▐   ⠠    ▌",
+            "▐   ⠂    ▌",
+            "▐  ⠈     ▌",
+            "▐  ⠂     ▌",
+            "▐ ⠠      ▌",
+            "▐ ⡀      ▌",
+            "▐⠠       ▌",
+        ],
+    },
+    "shark": {
+        "interval": 120,
+        "frames": [
+            "▐|\\____________▌",
+            "▐_|\\___________▌",
+            "▐__|\\__________▌",
+            "▐___|\\_________▌",
+            "▐____|\\________▌",
+            "▐_____|\\_______▌",
+            "▐______|\\______▌",
+            "▐_______|\\_____▌",
+            "▐________|\\____▌",
+            "▐_________|\\___▌",
+            "▐__________|\\__▌",
+            "▐___________|\\_▌",
+            "▐____________|\\▌",
+            "▐____________/|▌",
+            "▐___________/|_▌",
+            "▐__________/|__▌",
+            "▐_________/|___▌",
+            "▐________/|____▌",
+            "▐_______/|_____▌",
+            "▐______/|______▌",
+            "▐_____/|_______▌",
+            "▐____/|________▌",
+            "▐___/|_________▌",
+            "▐__/|__________▌",
+            "▐_/|___________▌",
+            "▐/|____________▌",
+        ],
+    },
+    "dqpb": {"interval": 100, "frames": "dqpb"},
+    "weather": {
+        "interval": 100,
+        "frames": [
+            "☀️ ",
+            "☀️ ",
+            "☀️ ",
+            "🌤 ",
+            "⛅️ ",
+            "🌥 ",
+            "☁️ ",
+            "🌧 ",
+            "🌨 ",
+            "🌧 ",
+            "🌨 ",
+            "🌧 ",
+            "🌨 ",
+            "⛈ ",
+            "🌨 ",
+            "🌧 ",
+            "🌨 ",
+            "☁️ ",
+            "🌥 ",
+            "⛅️ ",
+            "🌤 ",
+            "☀️ ",
+            "☀️ ",
+        ],
+    },
+    "christmas": {"interval": 400, "frames": "🌲🎄"},
+    "grenade": {
+        "interval": 80,
+        "frames": [
+            "،   ",
+            "′   ",
+            " ´ ",
+            " ‾ ",
+            "  ⸌",
+            "  ⸊",
+            "  |",
+            "  ⁎",
+            "  ⁕",
+            " ෴ ",
+            "  ⁓",
+            "   ",
+            "   ",
+            "   ",
+        ],
+    },
+    "point": {"interval": 125, "frames": ["∙∙∙", "●∙∙", "∙●∙", "∙∙●", "∙∙∙"]},
+    "layer": {"interval": 150, "frames": "-=≡"},
+    "betaWave": {
+        "interval": 80,
+        "frames": [
+            "ρββββββ",
+            "βρβββββ",
+            "ββρββββ",
+            "βββρβββ",
+            "ββββρββ",
+            "βββββρβ",
+            "ββββββρ",
+        ],
+    },
+    "aesthetic": {
+        "interval": 80,
+        "frames": [
+            "▰▱▱▱▱▱▱",
+            "▰▰▱▱▱▱▱",
+            "▰▰▰▱▱▱▱",
+            "▰▰▰▰▱▱▱",
+            "▰▰▰▰▰▱▱",
+            "▰▰▰▰▰▰▱",
+            "▰▰▰▰▰▰▰",
+            "▰▱▱▱▱▱▱",
+        ],
+    },
+}
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/_stack.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/_stack.py
new file mode 100644
index 0000000..194564e
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/_stack.py
@@ -0,0 +1,16 @@
+from typing import List, TypeVar
+
+T = TypeVar("T")
+
+
+class Stack(List[T]):
+    """A small shim over builtin list."""
+
+    @property
+    def top(self) -> T:
+        """Get top of stack."""
+        return self[-1]
+
+    def push(self, item: T) -> None:
+        """Push an item on to the stack (append in stack nomenclature)."""
+        self.append(item)
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/_timer.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/_timer.py
new file mode 100644
index 0000000..a2ca6be
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/_timer.py
@@ -0,0 +1,19 @@
+"""
+Timer context manager, only used in debug.
+
+"""
+
+from time import time
+
+import contextlib
+from typing import Generator
+
+
+@contextlib.contextmanager
+def timer(subject: str = "time") -> Generator[None, None, None]:
+    """print the elapsed time. (only used in debugging)"""
+    start = time()
+    yield
+    elapsed = time() - start
+    elapsed_ms = elapsed * 1000
+    print(f"{subject} elapsed {elapsed_ms:.1f}ms")
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/_win32_console.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/_win32_console.py
new file mode 100644
index 0000000..2eba1b9
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/_win32_console.py
@@ -0,0 +1,661 @@
+"""Light wrapper around the Win32 Console API - this module should only be imported on Windows
+
+The API that this module wraps is documented at https://docs.microsoft.com/en-us/windows/console/console-functions
+"""
+
+import ctypes
+import sys
+from typing import Any
+
+windll: Any = None
+if sys.platform == "win32":
+    windll = ctypes.LibraryLoader(ctypes.WinDLL)
+else:
+    raise ImportError(f"{__name__} can only be imported on Windows")
+
+import time
+from ctypes import Structure, byref, wintypes
+from typing import IO, NamedTuple, Type, cast
+
+from pip._vendor.rich.color import ColorSystem
+from pip._vendor.rich.style import Style
+
+STDOUT = -11
+ENABLE_VIRTUAL_TERMINAL_PROCESSING = 4
+
+COORD = wintypes._COORD
+
+
+class LegacyWindowsError(Exception):
+    pass
+
+
+class WindowsCoordinates(NamedTuple):
+    """Coordinates in the Windows Console API are (y, x), not (x, y).
+    This class is intended to prevent that confusion.
+    Rows and columns are indexed from 0.
+    This class can be used in place of wintypes._COORD in arguments and argtypes.
+    """
+
+    row: int
+    col: int
+
+    @classmethod
+    def from_param(cls, value: "WindowsCoordinates") -> COORD:
+        """Converts a WindowsCoordinates into a wintypes _COORD structure.
+        This classmethod is internally called by ctypes to perform the conversion.
+
+        Args:
+            value (WindowsCoordinates): The input coordinates to convert.
+
+        Returns:
+            wintypes._COORD: The converted coordinates struct.
+        """
+        return COORD(value.col, value.row)
+
+
+class CONSOLE_SCREEN_BUFFER_INFO(Structure):
+    _fields_ = [
+        ("dwSize", COORD),
+        ("dwCursorPosition", COORD),
+        ("wAttributes", wintypes.WORD),
+        ("srWindow", wintypes.SMALL_RECT),
+        ("dwMaximumWindowSize", COORD),
+    ]
+
+
+class CONSOLE_CURSOR_INFO(ctypes.Structure):
+    _fields_ = [("dwSize", wintypes.DWORD), ("bVisible", wintypes.BOOL)]
+
+
+_GetStdHandle = windll.kernel32.GetStdHandle
+_GetStdHandle.argtypes = [
+    wintypes.DWORD,
+]
+_GetStdHandle.restype = wintypes.HANDLE
+
+
+def GetStdHandle(handle: int = STDOUT) -> wintypes.HANDLE:
+    """Retrieves a handle to the specified standard device (standard input, standard output, or standard error).
+
+    Args:
+        handle (int): Integer identifier for the handle. Defaults to -11 (stdout).
+
+    Returns:
+        wintypes.HANDLE: The handle
+    """
+    return cast(wintypes.HANDLE, _GetStdHandle(handle))
+
+
+_GetConsoleMode = windll.kernel32.GetConsoleMode
+_GetConsoleMode.argtypes = [wintypes.HANDLE, wintypes.LPDWORD]
+_GetConsoleMode.restype = wintypes.BOOL
+
+
+def GetConsoleMode(std_handle: wintypes.HANDLE) -> int:
+    """Retrieves the current input mode of a console's input buffer
+    or the current output mode of a console screen buffer.
+
+    Args:
+        std_handle (wintypes.HANDLE): A handle to the console input buffer or the console screen buffer.
+
+    Raises:
+        LegacyWindowsError: If any error occurs while calling the Windows console API.
+
+    Returns:
+        int: Value representing the current console mode as documented at
+            https://docs.microsoft.com/en-us/windows/console/getconsolemode#parameters
+    """
+
+    console_mode = wintypes.DWORD()
+    success = bool(_GetConsoleMode(std_handle, console_mode))
+    if not success:
+        raise LegacyWindowsError("Unable to get legacy Windows Console Mode")
+    return console_mode.value
+
+
+_FillConsoleOutputCharacterW = windll.kernel32.FillConsoleOutputCharacterW
+_FillConsoleOutputCharacterW.argtypes = [
+    wintypes.HANDLE,
+    ctypes.c_char,
+    wintypes.DWORD,
+    cast(Type[COORD], WindowsCoordinates),
+    ctypes.POINTER(wintypes.DWORD),
+]
+_FillConsoleOutputCharacterW.restype = wintypes.BOOL
+
+
+def FillConsoleOutputCharacter(
+    std_handle: wintypes.HANDLE,
+    char: str,
+    length: int,
+    start: WindowsCoordinates,
+) -> int:
+    """Writes a character to the console screen buffer a specified number of times, beginning at the specified coordinates.
+
+    Args:
+        std_handle (wintypes.HANDLE): A handle to the console input buffer or the console screen buffer.
+        char (str): The character to write. Must be a string of length 1.
+        length (int): The number of times to write the character.
+        start (WindowsCoordinates): The coordinates to start writing at.
+
+    Returns:
+        int: The number of characters written.
+    """
+    character = ctypes.c_char(char.encode())
+    num_characters = wintypes.DWORD(length)
+    num_written = wintypes.DWORD(0)
+    _FillConsoleOutputCharacterW(
+        std_handle,
+        character,
+        num_characters,
+        start,
+        byref(num_written),
+    )
+    return num_written.value
+
+
+_FillConsoleOutputAttribute = windll.kernel32.FillConsoleOutputAttribute
+_FillConsoleOutputAttribute.argtypes = [
+    wintypes.HANDLE,
+    wintypes.WORD,
+    wintypes.DWORD,
+    cast(Type[COORD], WindowsCoordinates),
+    ctypes.POINTER(wintypes.DWORD),
+]
+_FillConsoleOutputAttribute.restype = wintypes.BOOL
+
+
+def FillConsoleOutputAttribute(
+    std_handle: wintypes.HANDLE,
+    attributes: int,
+    length: int,
+    start: WindowsCoordinates,
+) -> int:
+    """Sets the character attributes for a specified number of character cells,
+    beginning at the specified coordinates in a screen buffer.
+
+    Args:
+        std_handle (wintypes.HANDLE): A handle to the console input buffer or the console screen buffer.
+        attributes (int): Integer value representing the foreground and background colours of the cells.
+        length (int): The number of cells to set the output attribute of.
+        start (WindowsCoordinates): The coordinates of the first cell whose attributes are to be set.
+
+    Returns:
+        int: The number of cells whose attributes were actually set.
+    """
+    num_cells = wintypes.DWORD(length)
+    style_attrs = wintypes.WORD(attributes)
+    num_written = wintypes.DWORD(0)
+    _FillConsoleOutputAttribute(
+        std_handle, style_attrs, num_cells, start, byref(num_written)
+    )
+    return num_written.value
+
+
+_SetConsoleTextAttribute = windll.kernel32.SetConsoleTextAttribute
+_SetConsoleTextAttribute.argtypes = [
+    wintypes.HANDLE,
+    wintypes.WORD,
+]
+_SetConsoleTextAttribute.restype = wintypes.BOOL
+
+
+def SetConsoleTextAttribute(
+    std_handle: wintypes.HANDLE, attributes: wintypes.WORD
+) -> bool:
+    """Set the colour attributes for all text written after this function is called.
+
+    Args:
+        std_handle (wintypes.HANDLE): A handle to the console input buffer or the console screen buffer.
+        attributes (int): Integer value representing the foreground and background colours.
+
+
+    Returns:
+        bool: True if the attribute was set successfully, otherwise False.
+    """
+    return bool(_SetConsoleTextAttribute(std_handle, attributes))
+
+
+_GetConsoleScreenBufferInfo = windll.kernel32.GetConsoleScreenBufferInfo
+_GetConsoleScreenBufferInfo.argtypes = [
+    wintypes.HANDLE,
+    ctypes.POINTER(CONSOLE_SCREEN_BUFFER_INFO),
+]
+_GetConsoleScreenBufferInfo.restype = wintypes.BOOL
+
+
+def GetConsoleScreenBufferInfo(
+    std_handle: wintypes.HANDLE,
+) -> CONSOLE_SCREEN_BUFFER_INFO:
+    """Retrieves information about the specified console screen buffer.
+
+    Args:
+        std_handle (wintypes.HANDLE): A handle to the console input buffer or the console screen buffer.
+
+    Returns:
+        CONSOLE_SCREEN_BUFFER_INFO: A CONSOLE_SCREEN_BUFFER_INFO ctype struct contain information about
+            screen size, cursor position, colour attributes, and more."""
+    console_screen_buffer_info = CONSOLE_SCREEN_BUFFER_INFO()
+    _GetConsoleScreenBufferInfo(std_handle, byref(console_screen_buffer_info))
+    return console_screen_buffer_info
+
+
+_SetConsoleCursorPosition = windll.kernel32.SetConsoleCursorPosition
+_SetConsoleCursorPosition.argtypes = [
+    wintypes.HANDLE,
+    cast(Type[COORD], WindowsCoordinates),
+]
+_SetConsoleCursorPosition.restype = wintypes.BOOL
+
+
+def SetConsoleCursorPosition(
+    std_handle: wintypes.HANDLE, coords: WindowsCoordinates
+) -> bool:
+    """Set the position of the cursor in the console screen
+
+    Args:
+        std_handle (wintypes.HANDLE): A handle to the console input buffer or the console screen buffer.
+        coords (WindowsCoordinates): The coordinates to move the cursor to.
+
+    Returns:
+        bool: True if the function succeeds, otherwise False.
+    """
+    return bool(_SetConsoleCursorPosition(std_handle, coords))
+
+
+_GetConsoleCursorInfo = windll.kernel32.GetConsoleCursorInfo
+_GetConsoleCursorInfo.argtypes = [
+    wintypes.HANDLE,
+    ctypes.POINTER(CONSOLE_CURSOR_INFO),
+]
+_GetConsoleCursorInfo.restype = wintypes.BOOL
+
+
+def GetConsoleCursorInfo(
+    std_handle: wintypes.HANDLE, cursor_info: CONSOLE_CURSOR_INFO
+) -> bool:
+    """Get the cursor info - used to get cursor visibility and width
+
+    Args:
+        std_handle (wintypes.HANDLE): A handle to the console input buffer or the console screen buffer.
+        cursor_info (CONSOLE_CURSOR_INFO): CONSOLE_CURSOR_INFO ctype struct that receives information
+            about the console's cursor.
+
+    Returns:
+          bool: True if the function succeeds, otherwise False.
+    """
+    return bool(_GetConsoleCursorInfo(std_handle, byref(cursor_info)))
+
+
+_SetConsoleCursorInfo = windll.kernel32.SetConsoleCursorInfo
+_SetConsoleCursorInfo.argtypes = [
+    wintypes.HANDLE,
+    ctypes.POINTER(CONSOLE_CURSOR_INFO),
+]
+_SetConsoleCursorInfo.restype = wintypes.BOOL
+
+
+def SetConsoleCursorInfo(
+    std_handle: wintypes.HANDLE, cursor_info: CONSOLE_CURSOR_INFO
+) -> bool:
+    """Set the cursor info - used for adjusting cursor visibility and width
+
+    Args:
+        std_handle (wintypes.HANDLE): A handle to the console input buffer or the console screen buffer.
+        cursor_info (CONSOLE_CURSOR_INFO): CONSOLE_CURSOR_INFO ctype struct containing the new cursor info.
+
+    Returns:
+          bool: True if the function succeeds, otherwise False.
+    """
+    return bool(_SetConsoleCursorInfo(std_handle, byref(cursor_info)))
+
+
+_SetConsoleTitle = windll.kernel32.SetConsoleTitleW
+_SetConsoleTitle.argtypes = [wintypes.LPCWSTR]
+_SetConsoleTitle.restype = wintypes.BOOL
+
+
+def SetConsoleTitle(title: str) -> bool:
+    """Sets the title of the current console window
+
+    Args:
+        title (str): The new title of the console window.
+
+    Returns:
+        bool: True if the function succeeds, otherwise False.
+    """
+    return bool(_SetConsoleTitle(title))
+
+
+class LegacyWindowsTerm:
+    """This class allows interaction with the legacy Windows Console API. It should only be used in the context
+    of environments where virtual terminal processing is not available. However, if it is used in a Windows environment,
+    the entire API should work.
+
+    Args:
+        file (IO[str]): The file which the Windows Console API HANDLE is retrieved from, defaults to sys.stdout.
+    """
+
+    BRIGHT_BIT = 8
+
+    # Indices are ANSI color numbers, values are the corresponding Windows Console API color numbers
+    ANSI_TO_WINDOWS = [
+        0,  # black                      The Windows colours are defined in wincon.h as follows:
+        4,  # red                         define FOREGROUND_BLUE            0x0001 -- 0000 0001
+        2,  # green                       define FOREGROUND_GREEN           0x0002 -- 0000 0010
+        6,  # yellow                      define FOREGROUND_RED             0x0004 -- 0000 0100
+        1,  # blue                        define FOREGROUND_INTENSITY       0x0008 -- 0000 1000
+        5,  # magenta                     define BACKGROUND_BLUE            0x0010 -- 0001 0000
+        3,  # cyan                        define BACKGROUND_GREEN           0x0020 -- 0010 0000
+        7,  # white                       define BACKGROUND_RED             0x0040 -- 0100 0000
+        8,  # bright black (grey)         define BACKGROUND_INTENSITY       0x0080 -- 1000 0000
+        12,  # bright red
+        10,  # bright green
+        14,  # bright yellow
+        9,  # bright blue
+        13,  # bright magenta
+        11,  # bright cyan
+        15,  # bright white
+    ]
+
+    def __init__(self, file: "IO[str]") -> None:
+        handle = GetStdHandle(STDOUT)
+        self._handle = handle
+        default_text = GetConsoleScreenBufferInfo(handle).wAttributes
+        self._default_text = default_text
+
+        self._default_fore = default_text & 7
+        self._default_back = (default_text >> 4) & 7
+        self._default_attrs = self._default_fore | (self._default_back << 4)
+
+        self._file = file
+        self.write = file.write
+        self.flush = file.flush
+
+    @property
+    def cursor_position(self) -> WindowsCoordinates:
+        """Returns the current position of the cursor (0-based)
+
+        Returns:
+            WindowsCoordinates: The current cursor position.
+        """
+        coord: COORD = GetConsoleScreenBufferInfo(self._handle).dwCursorPosition
+        return WindowsCoordinates(row=coord.Y, col=coord.X)
+
+    @property
+    def screen_size(self) -> WindowsCoordinates:
+        """Returns the current size of the console screen buffer, in character columns and rows
+
+        Returns:
+            WindowsCoordinates: The width and height of the screen as WindowsCoordinates.
+        """
+        screen_size: COORD = GetConsoleScreenBufferInfo(self._handle).dwSize
+        return WindowsCoordinates(row=screen_size.Y, col=screen_size.X)
+
+    def write_text(self, text: str) -> None:
+        """Write text directly to the terminal without any modification of styles
+
+        Args:
+            text (str): The text to write to the console
+        """
+        self.write(text)
+        self.flush()
+
+    def write_styled(self, text: str, style: Style) -> None:
+        """Write styled text to the terminal.
+
+        Args:
+            text (str): The text to write
+            style (Style): The style of the text
+        """
+        color = style.color
+        bgcolor = style.bgcolor
+        if style.reverse:
+            color, bgcolor = bgcolor, color
+
+        if color:
+            fore = color.downgrade(ColorSystem.WINDOWS).number
+            fore = fore if fore is not None else 7  # Default to ANSI 7: White
+            if style.bold:
+                fore = fore | self.BRIGHT_BIT
+            if style.dim:
+                fore = fore & ~self.BRIGHT_BIT
+            fore = self.ANSI_TO_WINDOWS[fore]
+        else:
+            fore = self._default_fore
+
+        if bgcolor:
+            back = bgcolor.downgrade(ColorSystem.WINDOWS).number
+            back = back if back is not None else 0  # Default to ANSI 0: Black
+            back = self.ANSI_TO_WINDOWS[back]
+        else:
+            back = self._default_back
+
+        assert fore is not None
+        assert back is not None
+
+        SetConsoleTextAttribute(
+            self._handle, attributes=ctypes.c_ushort(fore | (back << 4))
+        )
+        self.write_text(text)
+        SetConsoleTextAttribute(self._handle, attributes=self._default_text)
+
+    def move_cursor_to(self, new_position: WindowsCoordinates) -> None:
+        """Set the position of the cursor
+
+        Args:
+            new_position (WindowsCoordinates): The WindowsCoordinates representing the new position of the cursor.
+        """
+        if new_position.col < 0 or new_position.row < 0:
+            return
+        SetConsoleCursorPosition(self._handle, coords=new_position)
+
+    def erase_line(self) -> None:
+        """Erase all content on the line the cursor is currently located at"""
+        screen_size = self.screen_size
+        cursor_position = self.cursor_position
+        cells_to_erase = screen_size.col
+        start_coordinates = WindowsCoordinates(row=cursor_position.row, col=0)
+        FillConsoleOutputCharacter(
+            self._handle, " ", length=cells_to_erase, start=start_coordinates
+        )
+        FillConsoleOutputAttribute(
+            self._handle,
+            self._default_attrs,
+            length=cells_to_erase,
+            start=start_coordinates,
+        )
+
+    def erase_end_of_line(self) -> None:
+        """Erase all content from the cursor position to the end of that line"""
+        cursor_position = self.cursor_position
+        cells_to_erase = self.screen_size.col - cursor_position.col
+        FillConsoleOutputCharacter(
+            self._handle, " ", length=cells_to_erase, start=cursor_position
+        )
+        FillConsoleOutputAttribute(
+            self._handle,
+            self._default_attrs,
+            length=cells_to_erase,
+            start=cursor_position,
+        )
+
+    def erase_start_of_line(self) -> None:
+        """Erase all content from the cursor position to the start of that line"""
+        row, col = self.cursor_position
+        start = WindowsCoordinates(row, 0)
+        FillConsoleOutputCharacter(self._handle, " ", length=col, start=start)
+        FillConsoleOutputAttribute(
+            self._handle, self._default_attrs, length=col, start=start
+        )
+
+    def move_cursor_up(self) -> None:
+        """Move the cursor up a single cell"""
+        cursor_position = self.cursor_position
+        SetConsoleCursorPosition(
+            self._handle,
+            coords=WindowsCoordinates(
+                row=cursor_position.row - 1, col=cursor_position.col
+            ),
+        )
+
+    def move_cursor_down(self) -> None:
+        """Move the cursor down a single cell"""
+        cursor_position = self.cursor_position
+        SetConsoleCursorPosition(
+            self._handle,
+            coords=WindowsCoordinates(
+                row=cursor_position.row + 1,
+                col=cursor_position.col,
+            ),
+        )
+
+    def move_cursor_forward(self) -> None:
+        """Move the cursor forward a single cell. Wrap to the next line if required."""
+        row, col = self.cursor_position
+        if col == self.screen_size.col - 1:
+            row += 1
+            col = 0
+        else:
+            col += 1
+        SetConsoleCursorPosition(
+            self._handle, coords=WindowsCoordinates(row=row, col=col)
+        )
+
+    def move_cursor_to_column(self, column: int) -> None:
+        """Move cursor to the column specified by the zero-based column index, staying on the same row
+
+        Args:
+            column (int): The zero-based column index to move the cursor to.
+        """
+        row, _ = self.cursor_position
+        SetConsoleCursorPosition(self._handle, coords=WindowsCoordinates(row, column))
+
+    def move_cursor_backward(self) -> None:
+        """Move the cursor backward a single cell. Wrap to the previous line if required."""
+        row, col = self.cursor_position
+        if col == 0:
+            row -= 1
+            col = self.screen_size.col - 1
+        else:
+            col -= 1
+        SetConsoleCursorPosition(
+            self._handle, coords=WindowsCoordinates(row=row, col=col)
+        )
+
+    def hide_cursor(self) -> None:
+        """Hide the cursor"""
+        current_cursor_size = self._get_cursor_size()
+        invisible_cursor = CONSOLE_CURSOR_INFO(dwSize=current_cursor_size, bVisible=0)
+        SetConsoleCursorInfo(self._handle, cursor_info=invisible_cursor)
+
+    def show_cursor(self) -> None:
+        """Show the cursor"""
+        current_cursor_size = self._get_cursor_size()
+        visible_cursor = CONSOLE_CURSOR_INFO(dwSize=current_cursor_size, bVisible=1)
+        SetConsoleCursorInfo(self._handle, cursor_info=visible_cursor)
+
+    def set_title(self, title: str) -> None:
+        """Set the title of the terminal window
+
+        Args:
+            title (str): The new title of the console window
+        """
+        assert len(title) < 255, "Console title must be less than 255 characters"
+        SetConsoleTitle(title)
+
+    def _get_cursor_size(self) -> int:
+        """Get the percentage of the character cell that is filled by the cursor"""
+        cursor_info = CONSOLE_CURSOR_INFO()
+        GetConsoleCursorInfo(self._handle, cursor_info=cursor_info)
+        return int(cursor_info.dwSize)
+
+
+if __name__ == "__main__":
+    handle = GetStdHandle()
+
+    from pip._vendor.rich.console import Console
+
+    console = Console()
+
+    term = LegacyWindowsTerm(sys.stdout)
+    term.set_title("Win32 Console Examples")
+
+    style = Style(color="black", bgcolor="red")
+
+    heading = Style.parse("black on green")
+
+    # Check colour output
+    console.rule("Checking colour output")
+    console.print("[on red]on red!")
+    console.print("[blue]blue!")
+    console.print("[yellow]yellow!")
+    console.print("[bold yellow]bold yellow!")
+    console.print("[bright_yellow]bright_yellow!")
+    console.print("[dim bright_yellow]dim bright_yellow!")
+    console.print("[italic cyan]italic cyan!")
+    console.print("[bold white on blue]bold white on blue!")
+    console.print("[reverse bold white on blue]reverse bold white on blue!")
+    console.print("[bold black on cyan]bold black on cyan!")
+    console.print("[black on green]black on green!")
+    console.print("[blue on green]blue on green!")
+    console.print("[white on black]white on black!")
+    console.print("[black on white]black on white!")
+    console.print("[#1BB152 on #DA812D]#1BB152 on #DA812D!")
+
+    # Check cursor movement
+    console.rule("Checking cursor movement")
+    console.print()
+    term.move_cursor_backward()
+    term.move_cursor_backward()
+    term.write_text("went back and wrapped to prev line")
+    time.sleep(1)
+    term.move_cursor_up()
+    term.write_text("we go up")
+    time.sleep(1)
+    term.move_cursor_down()
+    term.write_text("and down")
+    time.sleep(1)
+    term.move_cursor_up()
+    term.move_cursor_backward()
+    term.move_cursor_backward()
+    term.write_text("we went up and back 2")
+    time.sleep(1)
+    term.move_cursor_down()
+    term.move_cursor_backward()
+    term.move_cursor_backward()
+    term.write_text("we went down and back 2")
+    time.sleep(1)
+
+    # Check erasing of lines
+    term.hide_cursor()
+    console.print()
+    console.rule("Checking line erasing")
+    console.print("\n...Deleting to the start of the line...")
+    term.write_text("The red arrow shows the cursor location, and direction of erase")
+    time.sleep(1)
+    term.move_cursor_to_column(16)
+    term.write_styled("<", Style.parse("black on red"))
+    term.move_cursor_backward()
+    time.sleep(1)
+    term.erase_start_of_line()
+    time.sleep(1)
+
+    console.print("\n\n...And to the end of the line...")
+    term.write_text("The red arrow shows the cursor location, and direction of erase")
+    time.sleep(1)
+
+    term.move_cursor_to_column(16)
+    term.write_styled(">", Style.parse("black on red"))
+    time.sleep(1)
+    term.erase_end_of_line()
+    time.sleep(1)
+
+    console.print("\n\n...Now the whole line will be erased...")
+    term.write_styled("I'm going to disappear!", style=Style.parse("black on cyan"))
+    time.sleep(1)
+    term.erase_line()
+
+    term.show_cursor()
+    print("\n")
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/_windows.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/_windows.py
new file mode 100644
index 0000000..7520a9f
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/_windows.py
@@ -0,0 +1,71 @@
+import sys
+from dataclasses import dataclass
+
+
+@dataclass
+class WindowsConsoleFeatures:
+    """Windows features available."""
+
+    vt: bool = False
+    """The console supports VT codes."""
+    truecolor: bool = False
+    """The console supports truecolor."""
+
+
+try:
+    import ctypes
+    from ctypes import LibraryLoader
+
+    if sys.platform == "win32":
+        windll = LibraryLoader(ctypes.WinDLL)
+    else:
+        windll = None
+        raise ImportError("Not windows")
+
+    from pip._vendor.rich._win32_console import (
+        ENABLE_VIRTUAL_TERMINAL_PROCESSING,
+        GetConsoleMode,
+        GetStdHandle,
+        LegacyWindowsError,
+    )
+
+except (AttributeError, ImportError, ValueError):
+    # Fallback if we can't load the Windows DLL
+    def get_windows_console_features() -> WindowsConsoleFeatures:
+        features = WindowsConsoleFeatures()
+        return features
+
+else:
+
+    def get_windows_console_features() -> WindowsConsoleFeatures:
+        """Get windows console features.
+
+        Returns:
+            WindowsConsoleFeatures: An instance of WindowsConsoleFeatures.
+        """
+        handle = GetStdHandle()
+        try:
+            console_mode = GetConsoleMode(handle)
+            success = True
+        except LegacyWindowsError:
+            console_mode = 0
+            success = False
+        vt = bool(success and console_mode & ENABLE_VIRTUAL_TERMINAL_PROCESSING)
+        truecolor = False
+        if vt:
+            win_version = sys.getwindowsversion()
+            truecolor = win_version.major > 10 or (
+                win_version.major == 10 and win_version.build >= 15063
+            )
+        features = WindowsConsoleFeatures(vt=vt, truecolor=truecolor)
+        return features
+
+
+if __name__ == "__main__":
+    import platform
+
+    features = get_windows_console_features()
+    from pip._vendor.rich import print
+
+    print(f'platform="{platform.system()}"')
+    print(repr(features))
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/_windows_renderer.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/_windows_renderer.py
new file mode 100644
index 0000000..5ece056
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/_windows_renderer.py
@@ -0,0 +1,56 @@
+from typing import Iterable, Sequence, Tuple, cast
+
+from pip._vendor.rich._win32_console import LegacyWindowsTerm, WindowsCoordinates
+from pip._vendor.rich.segment import ControlCode, ControlType, Segment
+
+
+def legacy_windows_render(buffer: Iterable[Segment], term: LegacyWindowsTerm) -> None:
+    """Makes appropriate Windows Console API calls based on the segments in the buffer.
+
+    Args:
+        buffer (Iterable[Segment]): Iterable of Segments to convert to Win32 API calls.
+        term (LegacyWindowsTerm): Used to call the Windows Console API.
+    """
+    for text, style, control in buffer:
+        if not control:
+            if style:
+                term.write_styled(text, style)
+            else:
+                term.write_text(text)
+        else:
+            control_codes: Sequence[ControlCode] = control
+            for control_code in control_codes:
+                control_type = control_code[0]
+                if control_type == ControlType.CURSOR_MOVE_TO:
+                    _, x, y = cast(Tuple[ControlType, int, int], control_code)
+                    term.move_cursor_to(WindowsCoordinates(row=y - 1, col=x - 1))
+                elif control_type == ControlType.CARRIAGE_RETURN:
+                    term.write_text("\r")
+                elif control_type == ControlType.HOME:
+                    term.move_cursor_to(WindowsCoordinates(0, 0))
+                elif control_type == ControlType.CURSOR_UP:
+                    term.move_cursor_up()
+                elif control_type == ControlType.CURSOR_DOWN:
+                    term.move_cursor_down()
+                elif control_type == ControlType.CURSOR_FORWARD:
+                    term.move_cursor_forward()
+                elif control_type == ControlType.CURSOR_BACKWARD:
+                    term.move_cursor_backward()
+                elif control_type == ControlType.CURSOR_MOVE_TO_COLUMN:
+                    _, column = cast(Tuple[ControlType, int], control_code)
+                    term.move_cursor_to_column(column - 1)
+                elif control_type == ControlType.HIDE_CURSOR:
+                    term.hide_cursor()
+                elif control_type == ControlType.SHOW_CURSOR:
+                    term.show_cursor()
+                elif control_type == ControlType.ERASE_IN_LINE:
+                    _, mode = cast(Tuple[ControlType, int], control_code)
+                    if mode == 0:
+                        term.erase_end_of_line()
+                    elif mode == 1:
+                        term.erase_start_of_line()
+                    elif mode == 2:
+                        term.erase_line()
+                elif control_type == ControlType.SET_WINDOW_TITLE:
+                    _, title = cast(Tuple[ControlType, str], control_code)
+                    term.set_title(title)
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/_wrap.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/_wrap.py
new file mode 100644
index 0000000..2e94ff6
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/_wrap.py
@@ -0,0 +1,93 @@
+from __future__ import annotations
+
+import re
+from typing import Iterable
+
+from ._loop import loop_last
+from .cells import cell_len, chop_cells
+
+re_word = re.compile(r"\s*\S+\s*")
+
+
+def words(text: str) -> Iterable[tuple[int, int, str]]:
+    """Yields each word from the text as a tuple
+    containing (start_index, end_index, word). A "word" in this context may
+    include the actual word and any whitespace to the right.
+    """
+    position = 0
+    word_match = re_word.match(text, position)
+    while word_match is not None:
+        start, end = word_match.span()
+        word = word_match.group(0)
+        yield start, end, word
+        word_match = re_word.match(text, end)
+
+
+def divide_line(text: str, width: int, fold: bool = True) -> list[int]:
+    """Given a string of text, and a width (measured in cells), return a list
+    of cell offsets which the string should be split at in order for it to fit
+    within the given width.
+
+    Args:
+        text: The text to examine.
+        width: The available cell width.
+        fold: If True, words longer than `width` will be folded onto a new line.
+
+    Returns:
+        A list of indices to break the line at.
+    """
+    break_positions: list[int] = []  # offsets to insert the breaks at
+    append = break_positions.append
+    cell_offset = 0
+    _cell_len = cell_len
+
+    for start, _end, word in words(text):
+        word_length = _cell_len(word.rstrip())
+        remaining_space = width - cell_offset
+        word_fits_remaining_space = remaining_space >= word_length
+
+        if word_fits_remaining_space:
+            # Simplest case - the word fits within the remaining width for this line.
+            cell_offset += _cell_len(word)
+        else:
+            # Not enough space remaining for this word on the current line.
+            if word_length > width:
+                # The word doesn't fit on any line, so we can't simply
+                # place it on the next line...
+                if fold:
+                    # Fold the word across multiple lines.
+                    folded_word = chop_cells(word, width=width)
+                    for last, line in loop_last(folded_word):
+                        if start:
+                            append(start)
+                        if last:
+                            cell_offset = _cell_len(line)
+                        else:
+                            start += len(line)
+                else:
+                    # Folding isn't allowed, so crop the word.
+                    if start:
+                        append(start)
+                    cell_offset = _cell_len(word)
+            elif cell_offset and start:
+                # The word doesn't fit within the remaining space on the current
+                # line, but it *can* fit on to the next (empty) line.
+                append(start)
+                cell_offset = _cell_len(word)
+
+    return break_positions
+
+
+if __name__ == "__main__":  # pragma: no cover
+    from .console import Console
+
+    console = Console(width=10)
+    console.print("12345 abcdefghijklmnopqrstuvwyxzABCDEFGHIJKLMNOPQRSTUVWXYZ 12345")
+    print(chop_cells("abcdefghijklmnopqrstuvwxyz", 10))
+
+    console = Console(width=20)
+    console.rule()
+    console.print("TextualはPythonの高速アプリケーション開発フレームワークです")
+
+    console.rule()
+    console.print("アプリケーションは1670万色を使用でき")
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/abc.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/abc.py
new file mode 100644
index 0000000..e6e498e
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/abc.py
@@ -0,0 +1,33 @@
+from abc import ABC
+
+
+class RichRenderable(ABC):
+    """An abstract base class for Rich renderables.
+
+    Note that there is no need to extend this class, the intended use is to check if an
+    object supports the Rich renderable protocol. For example::
+
+        if isinstance(my_object, RichRenderable):
+            console.print(my_object)
+
+    """
+
+    @classmethod
+    def __subclasshook__(cls, other: type) -> bool:
+        """Check if this class supports the rich render protocol."""
+        return hasattr(other, "__rich_console__") or hasattr(other, "__rich__")
+
+
+if __name__ == "__main__":  # pragma: no cover
+    from pip._vendor.rich.text import Text
+
+    t = Text()
+    print(isinstance(Text, RichRenderable))
+    print(isinstance(t, RichRenderable))
+
+    class Foo:
+        pass
+
+    f = Foo()
+    print(isinstance(f, RichRenderable))
+    print(isinstance("", RichRenderable))
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/align.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/align.py
new file mode 100644
index 0000000..330dcc5
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/align.py
@@ -0,0 +1,312 @@
+import sys
+from itertools import chain
+from typing import TYPE_CHECKING, Iterable, Optional
+
+if sys.version_info >= (3, 8):
+    from typing import Literal
+else:
+    from pip._vendor.typing_extensions import Literal  # pragma: no cover
+
+from .constrain import Constrain
+from .jupyter import JupyterMixin
+from .measure import Measurement
+from .segment import Segment
+from .style import StyleType
+
+if TYPE_CHECKING:
+    from .console import Console, ConsoleOptions, RenderableType, RenderResult
+
+AlignMethod = Literal["left", "center", "right"]
+VerticalAlignMethod = Literal["top", "middle", "bottom"]
+
+
+class Align(JupyterMixin):
+    """Align a renderable by adding spaces if necessary.
+
+    Args:
+        renderable (RenderableType): A console renderable.
+        align (AlignMethod): One of "left", "center", or "right""
+        style (StyleType, optional): An optional style to apply to the background.
+        vertical (Optional[VerticalAlignMethod], optional): Optional vertical align, one of "top", "middle", or "bottom". Defaults to None.
+        pad (bool, optional): Pad the right with spaces. Defaults to True.
+        width (int, optional): Restrict contents to given width, or None to use default width. Defaults to None.
+        height (int, optional): Set height of align renderable, or None to fit to contents. Defaults to None.
+
+    Raises:
+        ValueError: if ``align`` is not one of the expected values.
+    """
+
+    def __init__(
+        self,
+        renderable: "RenderableType",
+        align: AlignMethod = "left",
+        style: Optional[StyleType] = None,
+        *,
+        vertical: Optional[VerticalAlignMethod] = None,
+        pad: bool = True,
+        width: Optional[int] = None,
+        height: Optional[int] = None,
+    ) -> None:
+        if align not in ("left", "center", "right"):
+            raise ValueError(
+                f'invalid value for align, expected "left", "center", or "right" (not {align!r})'
+            )
+        if vertical is not None and vertical not in ("top", "middle", "bottom"):
+            raise ValueError(
+                f'invalid value for vertical, expected "top", "middle", or "bottom" (not {vertical!r})'
+            )
+        self.renderable = renderable
+        self.align = align
+        self.style = style
+        self.vertical = vertical
+        self.pad = pad
+        self.width = width
+        self.height = height
+
+    def __repr__(self) -> str:
+        return f"Align({self.renderable!r}, {self.align!r})"
+
+    @classmethod
+    def left(
+        cls,
+        renderable: "RenderableType",
+        style: Optional[StyleType] = None,
+        *,
+        vertical: Optional[VerticalAlignMethod] = None,
+        pad: bool = True,
+        width: Optional[int] = None,
+        height: Optional[int] = None,
+    ) -> "Align":
+        """Align a renderable to the left."""
+        return cls(
+            renderable,
+            "left",
+            style=style,
+            vertical=vertical,
+            pad=pad,
+            width=width,
+            height=height,
+        )
+
+    @classmethod
+    def center(
+        cls,
+        renderable: "RenderableType",
+        style: Optional[StyleType] = None,
+        *,
+        vertical: Optional[VerticalAlignMethod] = None,
+        pad: bool = True,
+        width: Optional[int] = None,
+        height: Optional[int] = None,
+    ) -> "Align":
+        """Align a renderable to the center."""
+        return cls(
+            renderable,
+            "center",
+            style=style,
+            vertical=vertical,
+            pad=pad,
+            width=width,
+            height=height,
+        )
+
+    @classmethod
+    def right(
+        cls,
+        renderable: "RenderableType",
+        style: Optional[StyleType] = None,
+        *,
+        vertical: Optional[VerticalAlignMethod] = None,
+        pad: bool = True,
+        width: Optional[int] = None,
+        height: Optional[int] = None,
+    ) -> "Align":
+        """Align a renderable to the right."""
+        return cls(
+            renderable,
+            "right",
+            style=style,
+            vertical=vertical,
+            pad=pad,
+            width=width,
+            height=height,
+        )
+
+    def __rich_console__(
+        self, console: "Console", options: "ConsoleOptions"
+    ) -> "RenderResult":
+        align = self.align
+        width = console.measure(self.renderable, options=options).maximum
+        rendered = console.render(
+            Constrain(
+                self.renderable, width if self.width is None else min(width, self.width)
+            ),
+            options.update(height=None),
+        )
+        lines = list(Segment.split_lines(rendered))
+        width, height = Segment.get_shape(lines)
+        lines = Segment.set_shape(lines, width, height)
+        new_line = Segment.line()
+        excess_space = options.max_width - width
+        style = console.get_style(self.style) if self.style is not None else None
+
+        def generate_segments() -> Iterable[Segment]:
+            if excess_space <= 0:
+                # Exact fit
+                for line in lines:
+                    yield from line
+                    yield new_line
+
+            elif align == "left":
+                # Pad on the right
+                pad = Segment(" " * excess_space, style) if self.pad else None
+                for line in lines:
+                    yield from line
+                    if pad:
+                        yield pad
+                    yield new_line
+
+            elif align == "center":
+                # Pad left and right
+                left = excess_space // 2
+                pad = Segment(" " * left, style)
+                pad_right = (
+                    Segment(" " * (excess_space - left), style) if self.pad else None
+                )
+                for line in lines:
+                    if left:
+                        yield pad
+                    yield from line
+                    if pad_right:
+                        yield pad_right
+                    yield new_line
+
+            elif align == "right":
+                # Padding on left
+                pad = Segment(" " * excess_space, style)
+                for line in lines:
+                    yield pad
+                    yield from line
+                    yield new_line
+
+        blank_line = (
+            Segment(f"{' ' * (self.width or options.max_width)}\n", style)
+            if self.pad
+            else Segment("\n")
+        )
+
+        def blank_lines(count: int) -> Iterable[Segment]:
+            if count > 0:
+                for _ in range(count):
+                    yield blank_line
+
+        vertical_height = self.height or options.height
+        iter_segments: Iterable[Segment]
+        if self.vertical and vertical_height is not None:
+            if self.vertical == "top":
+                bottom_space = vertical_height - height
+                iter_segments = chain(generate_segments(), blank_lines(bottom_space))
+            elif self.vertical == "middle":
+                top_space = (vertical_height - height) // 2
+                bottom_space = vertical_height - top_space - height
+                iter_segments = chain(
+                    blank_lines(top_space),
+                    generate_segments(),
+                    blank_lines(bottom_space),
+                )
+            else:  #  self.vertical == "bottom":
+                top_space = vertical_height - height
+                iter_segments = chain(blank_lines(top_space), generate_segments())
+        else:
+            iter_segments = generate_segments()
+        if self.style:
+            style = console.get_style(self.style)
+            iter_segments = Segment.apply_style(iter_segments, style)
+        yield from iter_segments
+
+    def __rich_measure__(
+        self, console: "Console", options: "ConsoleOptions"
+    ) -> Measurement:
+        measurement = Measurement.get(console, options, self.renderable)
+        return measurement
+
+
+class VerticalCenter(JupyterMixin):
+    """Vertically aligns a renderable.
+
+    Warn:
+        This class is deprecated and may be removed in a future version. Use Align class with
+        `vertical="middle"`.
+
+    Args:
+        renderable (RenderableType): A renderable object.
+        style (StyleType, optional): An optional style to apply to the background. Defaults to None.
+    """
+
+    def __init__(
+        self,
+        renderable: "RenderableType",
+        style: Optional[StyleType] = None,
+    ) -> None:
+        self.renderable = renderable
+        self.style = style
+
+    def __repr__(self) -> str:
+        return f"VerticalCenter({self.renderable!r})"
+
+    def __rich_console__(
+        self, console: "Console", options: "ConsoleOptions"
+    ) -> "RenderResult":
+        style = console.get_style(self.style) if self.style is not None else None
+        lines = console.render_lines(
+            self.renderable, options.update(height=None), pad=False
+        )
+        width, _height = Segment.get_shape(lines)
+        new_line = Segment.line()
+        height = options.height or options.size.height
+        top_space = (height - len(lines)) // 2
+        bottom_space = height - top_space - len(lines)
+        blank_line = Segment(f"{' ' * width}", style)
+
+        def blank_lines(count: int) -> Iterable[Segment]:
+            for _ in range(count):
+                yield blank_line
+                yield new_line
+
+        if top_space > 0:
+            yield from blank_lines(top_space)
+        for line in lines:
+            yield from line
+            yield new_line
+        if bottom_space > 0:
+            yield from blank_lines(bottom_space)
+
+    def __rich_measure__(
+        self, console: "Console", options: "ConsoleOptions"
+    ) -> Measurement:
+        measurement = Measurement.get(console, options, self.renderable)
+        return measurement
+
+
+if __name__ == "__main__":  # pragma: no cover
+    from pip._vendor.rich.console import Console, Group
+    from pip._vendor.rich.highlighter import ReprHighlighter
+    from pip._vendor.rich.panel import Panel
+
+    highlighter = ReprHighlighter()
+    console = Console()
+
+    panel = Panel(
+        Group(
+            Align.left(highlighter("align='left'")),
+            Align.center(highlighter("align='center'")),
+            Align.right(highlighter("align='right'")),
+        ),
+        width=60,
+        style="on dark_blue",
+        title="Align",
+    )
+
+    console.print(
+        Align.center(panel, vertical="middle", style="on red", height=console.height)
+    )
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/ansi.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/ansi.py
new file mode 100644
index 0000000..7de86ce
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/ansi.py
@@ -0,0 +1,241 @@
+import re
+import sys
+from contextlib import suppress
+from typing import Iterable, NamedTuple, Optional
+
+from .color import Color
+from .style import Style
+from .text import Text
+
+re_ansi = re.compile(
+    r"""
+(?:\x1b[0-?])|
+(?:\x1b\](.*?)\x1b\\)|
+(?:\x1b([(@-Z\\-_]|\[[0-?]*[ -/]*[@-~]))
+""",
+    re.VERBOSE,
+)
+
+
+class _AnsiToken(NamedTuple):
+    """Result of ansi tokenized string."""
+
+    plain: str = ""
+    sgr: Optional[str] = ""
+    osc: Optional[str] = ""
+
+
+def _ansi_tokenize(ansi_text: str) -> Iterable[_AnsiToken]:
+    """Tokenize a string in to plain text and ANSI codes.
+
+    Args:
+        ansi_text (str): A String containing ANSI codes.
+
+    Yields:
+        AnsiToken: A named tuple of (plain, sgr, osc)
+    """
+
+    position = 0
+    sgr: Optional[str]
+    osc: Optional[str]
+    for match in re_ansi.finditer(ansi_text):
+        start, end = match.span(0)
+        osc, sgr = match.groups()
+        if start > position:
+            yield _AnsiToken(ansi_text[position:start])
+        if sgr:
+            if sgr == "(":
+                position = end + 1
+                continue
+            if sgr.endswith("m"):
+                yield _AnsiToken("", sgr[1:-1], osc)
+        else:
+            yield _AnsiToken("", sgr, osc)
+        position = end
+    if position < len(ansi_text):
+        yield _AnsiToken(ansi_text[position:])
+
+
+SGR_STYLE_MAP = {
+    1: "bold",
+    2: "dim",
+    3: "italic",
+    4: "underline",
+    5: "blink",
+    6: "blink2",
+    7: "reverse",
+    8: "conceal",
+    9: "strike",
+    21: "underline2",
+    22: "not dim not bold",
+    23: "not italic",
+    24: "not underline",
+    25: "not blink",
+    26: "not blink2",
+    27: "not reverse",
+    28: "not conceal",
+    29: "not strike",
+    30: "color(0)",
+    31: "color(1)",
+    32: "color(2)",
+    33: "color(3)",
+    34: "color(4)",
+    35: "color(5)",
+    36: "color(6)",
+    37: "color(7)",
+    39: "default",
+    40: "on color(0)",
+    41: "on color(1)",
+    42: "on color(2)",
+    43: "on color(3)",
+    44: "on color(4)",
+    45: "on color(5)",
+    46: "on color(6)",
+    47: "on color(7)",
+    49: "on default",
+    51: "frame",
+    52: "encircle",
+    53: "overline",
+    54: "not frame not encircle",
+    55: "not overline",
+    90: "color(8)",
+    91: "color(9)",
+    92: "color(10)",
+    93: "color(11)",
+    94: "color(12)",
+    95: "color(13)",
+    96: "color(14)",
+    97: "color(15)",
+    100: "on color(8)",
+    101: "on color(9)",
+    102: "on color(10)",
+    103: "on color(11)",
+    104: "on color(12)",
+    105: "on color(13)",
+    106: "on color(14)",
+    107: "on color(15)",
+}
+
+
+class AnsiDecoder:
+    """Translate ANSI code in to styled Text."""
+
+    def __init__(self) -> None:
+        self.style = Style.null()
+
+    def decode(self, terminal_text: str) -> Iterable[Text]:
+        """Decode ANSI codes in an iterable of lines.
+
+        Args:
+            lines (Iterable[str]): An iterable of lines of terminal output.
+
+        Yields:
+            Text: Marked up Text.
+        """
+        for line in terminal_text.splitlines():
+            yield self.decode_line(line)
+
+    def decode_line(self, line: str) -> Text:
+        """Decode a line containing ansi codes.
+
+        Args:
+            line (str): A line of terminal output.
+
+        Returns:
+            Text: A Text instance marked up according to ansi codes.
+        """
+        from_ansi = Color.from_ansi
+        from_rgb = Color.from_rgb
+        _Style = Style
+        text = Text()
+        append = text.append
+        line = line.rsplit("\r", 1)[-1]
+        for plain_text, sgr, osc in _ansi_tokenize(line):
+            if plain_text:
+                append(plain_text, self.style or None)
+            elif osc is not None:
+                if osc.startswith("8;"):
+                    _params, semicolon, link = osc[2:].partition(";")
+                    if semicolon:
+                        self.style = self.style.update_link(link or None)
+            elif sgr is not None:
+                # Translate in to semi-colon separated codes
+                # Ignore invalid codes, because we want to be lenient
+                codes = [
+                    min(255, int(_code) if _code else 0)
+                    for _code in sgr.split(";")
+                    if _code.isdigit() or _code == ""
+                ]
+                iter_codes = iter(codes)
+                for code in iter_codes:
+                    if code == 0:
+                        # reset
+                        self.style = _Style.null()
+                    elif code in SGR_STYLE_MAP:
+                        # styles
+                        self.style += _Style.parse(SGR_STYLE_MAP[code])
+                    elif code == 38:
+                        #  Foreground
+                        with suppress(StopIteration):
+                            color_type = next(iter_codes)
+                            if color_type == 5:
+                                self.style += _Style.from_color(
+                                    from_ansi(next(iter_codes))
+                                )
+                            elif color_type == 2:
+                                self.style += _Style.from_color(
+                                    from_rgb(
+                                        next(iter_codes),
+                                        next(iter_codes),
+                                        next(iter_codes),
+                                    )
+                                )
+                    elif code == 48:
+                        # Background
+                        with suppress(StopIteration):
+                            color_type = next(iter_codes)
+                            if color_type == 5:
+                                self.style += _Style.from_color(
+                                    None, from_ansi(next(iter_codes))
+                                )
+                            elif color_type == 2:
+                                self.style += _Style.from_color(
+                                    None,
+                                    from_rgb(
+                                        next(iter_codes),
+                                        next(iter_codes),
+                                        next(iter_codes),
+                                    ),
+                                )
+
+        return text
+
+
+if sys.platform != "win32" and __name__ == "__main__":  # pragma: no cover
+    import io
+    import os
+    import pty
+    import sys
+
+    decoder = AnsiDecoder()
+
+    stdout = io.BytesIO()
+
+    def read(fd: int) -> bytes:
+        data = os.read(fd, 1024)
+        stdout.write(data)
+        return data
+
+    pty.spawn(sys.argv[1:], read)
+
+    from .console import Console
+
+    console = Console(record=True)
+
+    stdout_result = stdout.getvalue().decode("utf-8")
+    print(stdout_result)
+
+    for line in decoder.decode(stdout_result):
+        console.print(line)
+
+    console.save_html("stdout.html")
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/bar.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/bar.py
new file mode 100644
index 0000000..022284b
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/bar.py
@@ -0,0 +1,93 @@
+from typing import Optional, Union
+
+from .color import Color
+from .console import Console, ConsoleOptions, RenderResult
+from .jupyter import JupyterMixin
+from .measure import Measurement
+from .segment import Segment
+from .style import Style
+
+# There are left-aligned characters for 1/8 to 7/8, but
+# the right-aligned characters exist only for 1/8 and 4/8.
+BEGIN_BLOCK_ELEMENTS = ["█", "█", "█", "▐", "▐", "▐", "▕", "▕"]
+END_BLOCK_ELEMENTS = [" ", "▏", "▎", "▍", "▌", "▋", "▊", "▉"]
+FULL_BLOCK = "█"
+
+
+class Bar(JupyterMixin):
+    """Renders a solid block bar.
+
+    Args:
+        size (float): Value for the end of the bar.
+        begin (float): Begin point (between 0 and size, inclusive).
+        end (float): End point (between 0 and size, inclusive).
+        width (int, optional): Width of the bar, or ``None`` for maximum width. Defaults to None.
+        color (Union[Color, str], optional): Color of the bar. Defaults to "default".
+        bgcolor (Union[Color, str], optional): Color of bar background. Defaults to "default".
+    """
+
+    def __init__(
+        self,
+        size: float,
+        begin: float,
+        end: float,
+        *,
+        width: Optional[int] = None,
+        color: Union[Color, str] = "default",
+        bgcolor: Union[Color, str] = "default",
+    ):
+        self.size = size
+        self.begin = max(begin, 0)
+        self.end = min(end, size)
+        self.width = width
+        self.style = Style(color=color, bgcolor=bgcolor)
+
+    def __repr__(self) -> str:
+        return f"Bar({self.size}, {self.begin}, {self.end})"
+
+    def __rich_console__(
+        self, console: Console, options: ConsoleOptions
+    ) -> RenderResult:
+        width = min(
+            self.width if self.width is not None else options.max_width,
+            options.max_width,
+        )
+
+        if self.begin >= self.end:
+            yield Segment(" " * width, self.style)
+            yield Segment.line()
+            return
+
+        prefix_complete_eights = int(width * 8 * self.begin / self.size)
+        prefix_bar_count = prefix_complete_eights // 8
+        prefix_eights_count = prefix_complete_eights % 8
+
+        body_complete_eights = int(width * 8 * self.end / self.size)
+        body_bar_count = body_complete_eights // 8
+        body_eights_count = body_complete_eights % 8
+
+        # When start and end fall into the same cell, we ideally should render
+        # a symbol that's "center-aligned", but there is no good symbol in Unicode.
+        # In this case, we fall back to right-aligned block symbol for simplicity.
+
+        prefix = " " * prefix_bar_count
+        if prefix_eights_count:
+            prefix += BEGIN_BLOCK_ELEMENTS[prefix_eights_count]
+
+        body = FULL_BLOCK * body_bar_count
+        if body_eights_count:
+            body += END_BLOCK_ELEMENTS[body_eights_count]
+
+        suffix = " " * (width - len(body))
+
+        yield Segment(prefix + body[len(prefix) :] + suffix, self.style)
+        yield Segment.line()
+
+    def __rich_measure__(
+        self, console: Console, options: ConsoleOptions
+    ) -> Measurement:
+        return (
+            Measurement(self.width, self.width)
+            if self.width is not None
+            else Measurement(4, options.max_width)
+        )
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/box.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/box.py
new file mode 100644
index 0000000..0511a9e
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/box.py
@@ -0,0 +1,480 @@
+import sys
+from typing import TYPE_CHECKING, Iterable, List
+
+if sys.version_info >= (3, 8):
+    from typing import Literal
+else:
+    from pip._vendor.typing_extensions import Literal  # pragma: no cover
+
+
+from ._loop import loop_last
+
+if TYPE_CHECKING:
+    from pip._vendor.rich.console import ConsoleOptions
+
+
+class Box:
+    """Defines characters to render boxes.
+
+    ┌─┬┐ top
+    │ ││ head
+    ├─┼┤ head_row
+    │ ││ mid
+    ├─┼┤ row
+    ├─┼┤ foot_row
+    │ ││ foot
+    └─┴┘ bottom
+
+    Args:
+        box (str): Characters making up box.
+        ascii (bool, optional): True if this box uses ascii characters only. Default is False.
+    """
+
+    def __init__(self, box: str, *, ascii: bool = False) -> None:
+        self._box = box
+        self.ascii = ascii
+        line1, line2, line3, line4, line5, line6, line7, line8 = box.splitlines()
+        # top
+        self.top_left, self.top, self.top_divider, self.top_right = iter(line1)
+        # head
+        self.head_left, _, self.head_vertical, self.head_right = iter(line2)
+        # head_row
+        (
+            self.head_row_left,
+            self.head_row_horizontal,
+            self.head_row_cross,
+            self.head_row_right,
+        ) = iter(line3)
+
+        # mid
+        self.mid_left, _, self.mid_vertical, self.mid_right = iter(line4)
+        # row
+        self.row_left, self.row_horizontal, self.row_cross, self.row_right = iter(line5)
+        # foot_row
+        (
+            self.foot_row_left,
+            self.foot_row_horizontal,
+            self.foot_row_cross,
+            self.foot_row_right,
+        ) = iter(line6)
+        # foot
+        self.foot_left, _, self.foot_vertical, self.foot_right = iter(line7)
+        # bottom
+        self.bottom_left, self.bottom, self.bottom_divider, self.bottom_right = iter(
+            line8
+        )
+
+    def __repr__(self) -> str:
+        return "Box(...)"
+
+    def __str__(self) -> str:
+        return self._box
+
+    def substitute(self, options: "ConsoleOptions", safe: bool = True) -> "Box":
+        """Substitute this box for another if it won't render due to platform issues.
+
+        Args:
+            options (ConsoleOptions): Console options used in rendering.
+            safe (bool, optional): Substitute this for another Box if there are known problems
+                displaying on the platform (currently only relevant on Windows). Default is True.
+
+        Returns:
+            Box: A different Box or the same Box.
+        """
+        box = self
+        if options.legacy_windows and safe:
+            box = LEGACY_WINDOWS_SUBSTITUTIONS.get(box, box)
+        if options.ascii_only and not box.ascii:
+            box = ASCII
+        return box
+
+    def get_plain_headed_box(self) -> "Box":
+        """If this box uses special characters for the borders of the header, then
+        return the equivalent box that does not.
+
+        Returns:
+            Box: The most similar Box that doesn't use header-specific box characters.
+                If the current Box already satisfies this criterion, then it's returned.
+        """
+        return PLAIN_HEADED_SUBSTITUTIONS.get(self, self)
+
+    def get_top(self, widths: Iterable[int]) -> str:
+        """Get the top of a simple box.
+
+        Args:
+            widths (List[int]): Widths of columns.
+
+        Returns:
+            str: A string of box characters.
+        """
+
+        parts: List[str] = []
+        append = parts.append
+        append(self.top_left)
+        for last, width in loop_last(widths):
+            append(self.top * width)
+            if not last:
+                append(self.top_divider)
+        append(self.top_right)
+        return "".join(parts)
+
+    def get_row(
+        self,
+        widths: Iterable[int],
+        level: Literal["head", "row", "foot", "mid"] = "row",
+        edge: bool = True,
+    ) -> str:
+        """Get the top of a simple box.
+
+        Args:
+            width (List[int]): Widths of columns.
+
+        Returns:
+            str: A string of box characters.
+        """
+        if level == "head":
+            left = self.head_row_left
+            horizontal = self.head_row_horizontal
+            cross = self.head_row_cross
+            right = self.head_row_right
+        elif level == "row":
+            left = self.row_left
+            horizontal = self.row_horizontal
+            cross = self.row_cross
+            right = self.row_right
+        elif level == "mid":
+            left = self.mid_left
+            horizontal = " "
+            cross = self.mid_vertical
+            right = self.mid_right
+        elif level == "foot":
+            left = self.foot_row_left
+            horizontal = self.foot_row_horizontal
+            cross = self.foot_row_cross
+            right = self.foot_row_right
+        else:
+            raise ValueError("level must be 'head', 'row' or 'foot'")
+
+        parts: List[str] = []
+        append = parts.append
+        if edge:
+            append(left)
+        for last, width in loop_last(widths):
+            append(horizontal * width)
+            if not last:
+                append(cross)
+        if edge:
+            append(right)
+        return "".join(parts)
+
+    def get_bottom(self, widths: Iterable[int]) -> str:
+        """Get the bottom of a simple box.
+
+        Args:
+            widths (List[int]): Widths of columns.
+
+        Returns:
+            str: A string of box characters.
+        """
+
+        parts: List[str] = []
+        append = parts.append
+        append(self.bottom_left)
+        for last, width in loop_last(widths):
+            append(self.bottom * width)
+            if not last:
+                append(self.bottom_divider)
+        append(self.bottom_right)
+        return "".join(parts)
+
+
+# fmt: off
+ASCII: Box = Box(
+    "+--+\n"
+    "| ||\n"
+    "|-+|\n"
+    "| ||\n"
+    "|-+|\n"
+    "|-+|\n"
+    "| ||\n"
+    "+--+\n",
+    ascii=True,
+)
+
+ASCII2: Box = Box(
+    "+-++\n"
+    "| ||\n"
+    "+-++\n"
+    "| ||\n"
+    "+-++\n"
+    "+-++\n"
+    "| ||\n"
+    "+-++\n",
+    ascii=True,
+)
+
+ASCII_DOUBLE_HEAD: Box = Box(
+    "+-++\n"
+    "| ||\n"
+    "+=++\n"
+    "| ||\n"
+    "+-++\n"
+    "+-++\n"
+    "| ||\n"
+    "+-++\n",
+    ascii=True,
+)
+
+SQUARE: Box = Box(
+    "┌─┬┐\n"
+    "│ ││\n"
+    "├─┼┤\n"
+    "│ ││\n"
+    "├─┼┤\n"
+    "├─┼┤\n"
+    "│ ││\n"
+    "└─┴┘\n"
+)
+
+SQUARE_DOUBLE_HEAD: Box = Box(
+    "┌─┬┐\n"
+    "│ ││\n"
+    "╞═╪╡\n"
+    "│ ││\n"
+    "├─┼┤\n"
+    "├─┼┤\n"
+    "│ ││\n"
+    "└─┴┘\n"
+)
+
+MINIMAL: Box = Box(
+    "  ╷ \n"
+    "  │ \n"
+    "╶─┼╴\n"
+    "  │ \n"
+    "╶─┼╴\n"
+    "╶─┼╴\n"
+    "  │ \n"
+    "  ╵ \n"
+)
+
+
+MINIMAL_HEAVY_HEAD: Box = Box(
+    "  ╷ \n"
+    "  │ \n"
+    "╺━┿╸\n"
+    "  │ \n"
+    "╶─┼╴\n"
+    "╶─┼╴\n"
+    "  │ \n"
+    "  ╵ \n"
+)
+
+MINIMAL_DOUBLE_HEAD: Box = Box(
+    "  ╷ \n"
+    "  │ \n"
+    " ═╪ \n"
+    "  │ \n"
+    " ─┼ \n"
+    " ─┼ \n"
+    "  │ \n"
+    "  ╵ \n"
+)
+
+
+SIMPLE: Box = Box(
+    "    \n"
+    "    \n"
+    " ── \n"
+    "    \n"
+    "    \n"
+    " ── \n"
+    "    \n"
+    "    \n"
+)
+
+SIMPLE_HEAD: Box = Box(
+    "    \n"
+    "    \n"
+    " ── \n"
+    "    \n"
+    "    \n"
+    "    \n"
+    "    \n"
+    "    \n"
+)
+
+
+SIMPLE_HEAVY: Box = Box(
+    "    \n"
+    "    \n"
+    " ━━ \n"
+    "    \n"
+    "    \n"
+    " ━━ \n"
+    "    \n"
+    "    \n"
+)
+
+
+HORIZONTALS: Box = Box(
+    " ── \n"
+    "    \n"
+    " ── \n"
+    "    \n"
+    " ── \n"
+    " ── \n"
+    "    \n"
+    " ── \n"
+)
+
+ROUNDED: Box = Box(
+    "╭─┬╮\n"
+    "│ ││\n"
+    "├─┼┤\n"
+    "│ ││\n"
+    "├─┼┤\n"
+    "├─┼┤\n"
+    "│ ││\n"
+    "╰─┴╯\n"
+)
+
+HEAVY: Box = Box(
+    "┏━┳┓\n"
+    "┃ ┃┃\n"
+    "┣━╋┫\n"
+    "┃ ┃┃\n"
+    "┣━╋┫\n"
+    "┣━╋┫\n"
+    "┃ ┃┃\n"
+    "┗━┻┛\n"
+)
+
+HEAVY_EDGE: Box = Box(
+    "┏━┯┓\n"
+    "┃ │┃\n"
+    "┠─┼┨\n"
+    "┃ │┃\n"
+    "┠─┼┨\n"
+    "┠─┼┨\n"
+    "┃ │┃\n"
+    "┗━┷┛\n"
+)
+
+HEAVY_HEAD: Box = Box(
+    "┏━┳┓\n"
+    "┃ ┃┃\n"
+    "┡━╇┩\n"
+    "│ ││\n"
+    "├─┼┤\n"
+    "├─┼┤\n"
+    "│ ││\n"
+    "└─┴┘\n"
+)
+
+DOUBLE: Box = Box(
+    "╔═╦╗\n"
+    "║ ║║\n"
+    "╠═╬╣\n"
+    "║ ║║\n"
+    "╠═╬╣\n"
+    "╠═╬╣\n"
+    "║ ║║\n"
+    "╚═╩╝\n"
+)
+
+DOUBLE_EDGE: Box = Box(
+    "╔═╤╗\n"
+    "║ │║\n"
+    "╟─┼╢\n"
+    "║ │║\n"
+    "╟─┼╢\n"
+    "╟─┼╢\n"
+    "║ │║\n"
+    "╚═╧╝\n"
+)
+
+MARKDOWN: Box = Box(
+    "    \n"
+    "| ||\n"
+    "|-||\n"
+    "| ||\n"
+    "|-||\n"
+    "|-||\n"
+    "| ||\n"
+    "    \n",
+    ascii=True,
+)
+# fmt: on
+
+# Map Boxes that don't render with raster fonts on to equivalent that do
+LEGACY_WINDOWS_SUBSTITUTIONS = {
+    ROUNDED: SQUARE,
+    MINIMAL_HEAVY_HEAD: MINIMAL,
+    SIMPLE_HEAVY: SIMPLE,
+    HEAVY: SQUARE,
+    HEAVY_EDGE: SQUARE,
+    HEAVY_HEAD: SQUARE,
+}
+
+# Map headed boxes to their headerless equivalents
+PLAIN_HEADED_SUBSTITUTIONS = {
+    HEAVY_HEAD: SQUARE,
+    SQUARE_DOUBLE_HEAD: SQUARE,
+    MINIMAL_DOUBLE_HEAD: MINIMAL,
+    MINIMAL_HEAVY_HEAD: MINIMAL,
+    ASCII_DOUBLE_HEAD: ASCII2,
+}
+
+
+if __name__ == "__main__":  # pragma: no cover
+    from pip._vendor.rich.columns import Columns
+    from pip._vendor.rich.panel import Panel
+
+    from . import box as box
+    from .console import Console
+    from .table import Table
+    from .text import Text
+
+    console = Console(record=True)
+
+    BOXES = [
+        "ASCII",
+        "ASCII2",
+        "ASCII_DOUBLE_HEAD",
+        "SQUARE",
+        "SQUARE_DOUBLE_HEAD",
+        "MINIMAL",
+        "MINIMAL_HEAVY_HEAD",
+        "MINIMAL_DOUBLE_HEAD",
+        "SIMPLE",
+        "SIMPLE_HEAD",
+        "SIMPLE_HEAVY",
+        "HORIZONTALS",
+        "ROUNDED",
+        "HEAVY",
+        "HEAVY_EDGE",
+        "HEAVY_HEAD",
+        "DOUBLE",
+        "DOUBLE_EDGE",
+        "MARKDOWN",
+    ]
+
+    console.print(Panel("[bold green]Box Constants", style="green"), justify="center")
+    console.print()
+
+    columns = Columns(expand=True, padding=2)
+    for box_name in sorted(BOXES):
+        table = Table(
+            show_footer=True, style="dim", border_style="not dim", expand=True
+        )
+        table.add_column("Header 1", "Footer 1")
+        table.add_column("Header 2", "Footer 2")
+        table.add_row("Cell", "Cell")
+        table.add_row("Cell", "Cell")
+        table.box = getattr(box, box_name)
+        table.title = Text(f"box.{box_name}", style="magenta")
+        columns.add_renderable(table)
+    console.print(columns)
+
+    # console.save_svg("box.svg")
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/cells.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/cells.py
new file mode 100644
index 0000000..a854622
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/cells.py
@@ -0,0 +1,174 @@
+from __future__ import annotations
+
+from functools import lru_cache
+from typing import Callable
+
+from ._cell_widths import CELL_WIDTHS
+
+# Ranges of unicode ordinals that produce a 1-cell wide character
+# This is non-exhaustive, but covers most common Western characters
+_SINGLE_CELL_UNICODE_RANGES: list[tuple[int, int]] = [
+    (0x20, 0x7E),  # Latin (excluding non-printable)
+    (0xA0, 0xAC),
+    (0xAE, 0x002FF),
+    (0x00370, 0x00482),  # Greek / Cyrillic
+    (0x02500, 0x025FC),  # Box drawing, box elements, geometric shapes
+    (0x02800, 0x028FF),  # Braille
+]
+
+# A set of characters that are a single cell wide
+_SINGLE_CELLS = frozenset(
+    [
+        character
+        for _start, _end in _SINGLE_CELL_UNICODE_RANGES
+        for character in map(chr, range(_start, _end + 1))
+    ]
+)
+
+# When called with a string this will return True if all
+# characters are single-cell, otherwise False
+_is_single_cell_widths: Callable[[str], bool] = _SINGLE_CELLS.issuperset
+
+
+@lru_cache(4096)
+def cached_cell_len(text: str) -> int:
+    """Get the number of cells required to display text.
+
+    This method always caches, which may use up a lot of memory. It is recommended to use
+    `cell_len` over this method.
+
+    Args:
+        text (str): Text to display.
+
+    Returns:
+        int: Get the number of cells required to display text.
+    """
+    if _is_single_cell_widths(text):
+        return len(text)
+    return sum(map(get_character_cell_size, text))
+
+
+def cell_len(text: str, _cell_len: Callable[[str], int] = cached_cell_len) -> int:
+    """Get the number of cells required to display text.
+
+    Args:
+        text (str): Text to display.
+
+    Returns:
+        int: Get the number of cells required to display text.
+    """
+    if len(text) < 512:
+        return _cell_len(text)
+    if _is_single_cell_widths(text):
+        return len(text)
+    return sum(map(get_character_cell_size, text))
+
+
+@lru_cache(maxsize=4096)
+def get_character_cell_size(character: str) -> int:
+    """Get the cell size of a character.
+
+    Args:
+        character (str): A single character.
+
+    Returns:
+        int: Number of cells (0, 1 or 2) occupied by that character.
+    """
+    codepoint = ord(character)
+    _table = CELL_WIDTHS
+    lower_bound = 0
+    upper_bound = len(_table) - 1
+    index = (lower_bound + upper_bound) // 2
+    while True:
+        start, end, width = _table[index]
+        if codepoint < start:
+            upper_bound = index - 1
+        elif codepoint > end:
+            lower_bound = index + 1
+        else:
+            return 0 if width == -1 else width
+        if upper_bound < lower_bound:
+            break
+        index = (lower_bound + upper_bound) // 2
+    return 1
+
+
+def set_cell_size(text: str, total: int) -> str:
+    """Set the length of a string to fit within given number of cells."""
+
+    if _is_single_cell_widths(text):
+        size = len(text)
+        if size < total:
+            return text + " " * (total - size)
+        return text[:total]
+
+    if total <= 0:
+        return ""
+    cell_size = cell_len(text)
+    if cell_size == total:
+        return text
+    if cell_size < total:
+        return text + " " * (total - cell_size)
+
+    start = 0
+    end = len(text)
+
+    # Binary search until we find the right size
+    while True:
+        pos = (start + end) // 2
+        before = text[: pos + 1]
+        before_len = cell_len(before)
+        if before_len == total + 1 and cell_len(before[-1]) == 2:
+            return before[:-1] + " "
+        if before_len == total:
+            return before
+        if before_len > total:
+            end = pos
+        else:
+            start = pos
+
+
+def chop_cells(
+    text: str,
+    width: int,
+) -> list[str]:
+    """Split text into lines such that each line fits within the available (cell) width.
+
+    Args:
+        text: The text to fold such that it fits in the given width.
+        width: The width available (number of cells).
+
+    Returns:
+        A list of strings such that each string in the list has cell width
+        less than or equal to the available width.
+    """
+    _get_character_cell_size = get_character_cell_size
+    lines: list[list[str]] = [[]]
+
+    append_new_line = lines.append
+    append_to_last_line = lines[-1].append
+
+    total_width = 0
+
+    for character in text:
+        cell_width = _get_character_cell_size(character)
+        char_doesnt_fit = total_width + cell_width > width
+
+        if char_doesnt_fit:
+            append_new_line([character])
+            append_to_last_line = lines[-1].append
+            total_width = cell_width
+        else:
+            append_to_last_line(character)
+            total_width += cell_width
+
+    return ["".join(line) for line in lines]
+
+
+if __name__ == "__main__":  # pragma: no cover
+    print(get_character_cell_size("😽"))
+    for line in chop_cells("""这是对亚洲语言支持的测试。面对模棱两可的想法，拒绝猜测的诱惑。""", 8):
+        print(line)
+    for n in range(80, 1, -1):
+        print(set_cell_size("""这是对亚洲语言支持的测试。面对模棱两可的想法，拒绝猜测的诱惑。""", n) + "|")
+        print("x" * n)
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/color.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/color.py
new file mode 100644
index 0000000..e2c23a6
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/color.py
@@ -0,0 +1,621 @@
+import re
+import sys
+from colorsys import rgb_to_hls
+from enum import IntEnum
+from functools import lru_cache
+from typing import TYPE_CHECKING, NamedTuple, Optional, Tuple
+
+from ._palettes import EIGHT_BIT_PALETTE, STANDARD_PALETTE, WINDOWS_PALETTE
+from .color_triplet import ColorTriplet
+from .repr import Result, rich_repr
+from .terminal_theme import DEFAULT_TERMINAL_THEME
+
+if TYPE_CHECKING:  # pragma: no cover
+    from .terminal_theme import TerminalTheme
+    from .text import Text
+
+
+WINDOWS = sys.platform == "win32"
+
+
+class ColorSystem(IntEnum):
+    """One of the 3 color system supported by terminals."""
+
+    STANDARD = 1
+    EIGHT_BIT = 2
+    TRUECOLOR = 3
+    WINDOWS = 4
+
+    def __repr__(self) -> str:
+        return f"ColorSystem.{self.name}"
+
+    def __str__(self) -> str:
+        return repr(self)
+
+
+class ColorType(IntEnum):
+    """Type of color stored in Color class."""
+
+    DEFAULT = 0
+    STANDARD = 1
+    EIGHT_BIT = 2
+    TRUECOLOR = 3
+    WINDOWS = 4
+
+    def __repr__(self) -> str:
+        return f"ColorType.{self.name}"
+
+
+ANSI_COLOR_NAMES = {
+    "black": 0,
+    "red": 1,
+    "green": 2,
+    "yellow": 3,
+    "blue": 4,
+    "magenta": 5,
+    "cyan": 6,
+    "white": 7,
+    "bright_black": 8,
+    "bright_red": 9,
+    "bright_green": 10,
+    "bright_yellow": 11,
+    "bright_blue": 12,
+    "bright_magenta": 13,
+    "bright_cyan": 14,
+    "bright_white": 15,
+    "grey0": 16,
+    "gray0": 16,
+    "navy_blue": 17,
+    "dark_blue": 18,
+    "blue3": 20,
+    "blue1": 21,
+    "dark_green": 22,
+    "deep_sky_blue4": 25,
+    "dodger_blue3": 26,
+    "dodger_blue2": 27,
+    "green4": 28,
+    "spring_green4": 29,
+    "turquoise4": 30,
+    "deep_sky_blue3": 32,
+    "dodger_blue1": 33,
+    "green3": 40,
+    "spring_green3": 41,
+    "dark_cyan": 36,
+    "light_sea_green": 37,
+    "deep_sky_blue2": 38,
+    "deep_sky_blue1": 39,
+    "spring_green2": 47,
+    "cyan3": 43,
+    "dark_turquoise": 44,
+    "turquoise2": 45,
+    "green1": 46,
+    "spring_green1": 48,
+    "medium_spring_green": 49,
+    "cyan2": 50,
+    "cyan1": 51,
+    "dark_red": 88,
+    "deep_pink4": 125,
+    "purple4": 55,
+    "purple3": 56,
+    "blue_violet": 57,
+    "orange4": 94,
+    "grey37": 59,
+    "gray37": 59,
+    "medium_purple4": 60,
+    "slate_blue3": 62,
+    "royal_blue1": 63,
+    "chartreuse4": 64,
+    "dark_sea_green4": 71,
+    "pale_turquoise4": 66,
+    "steel_blue": 67,
+    "steel_blue3": 68,
+    "cornflower_blue": 69,
+    "chartreuse3": 76,
+    "cadet_blue": 73,
+    "sky_blue3": 74,
+    "steel_blue1": 81,
+    "pale_green3": 114,
+    "sea_green3": 78,
+    "aquamarine3": 79,
+    "medium_turquoise": 80,
+    "chartreuse2": 112,
+    "sea_green2": 83,
+    "sea_green1": 85,
+    "aquamarine1": 122,
+    "dark_slate_gray2": 87,
+    "dark_magenta": 91,
+    "dark_violet": 128,
+    "purple": 129,
+    "light_pink4": 95,
+    "plum4": 96,
+    "medium_purple3": 98,
+    "slate_blue1": 99,
+    "yellow4": 106,
+    "wheat4": 101,
+    "grey53": 102,
+    "gray53": 102,
+    "light_slate_grey": 103,
+    "light_slate_gray": 103,
+    "medium_purple": 104,
+    "light_slate_blue": 105,
+    "dark_olive_green3": 149,
+    "dark_sea_green": 108,
+    "light_sky_blue3": 110,
+    "sky_blue2": 111,
+    "dark_sea_green3": 150,
+    "dark_slate_gray3": 116,
+    "sky_blue1": 117,
+    "chartreuse1": 118,
+    "light_green": 120,
+    "pale_green1": 156,
+    "dark_slate_gray1": 123,
+    "red3": 160,
+    "medium_violet_red": 126,
+    "magenta3": 164,
+    "dark_orange3": 166,
+    "indian_red": 167,
+    "hot_pink3": 168,
+    "medium_orchid3": 133,
+    "medium_orchid": 134,
+    "medium_purple2": 140,
+    "dark_goldenrod": 136,
+    "light_salmon3": 173,
+    "rosy_brown": 138,
+    "grey63": 139,
+    "gray63": 139,
+    "medium_purple1": 141,
+    "gold3": 178,
+    "dark_khaki": 143,
+    "navajo_white3": 144,
+    "grey69": 145,
+    "gray69": 145,
+    "light_steel_blue3": 146,
+    "light_steel_blue": 147,
+    "yellow3": 184,
+    "dark_sea_green2": 157,
+    "light_cyan3": 152,
+    "light_sky_blue1": 153,
+    "green_yellow": 154,
+    "dark_olive_green2": 155,
+    "dark_sea_green1": 193,
+    "pale_turquoise1": 159,
+    "deep_pink3": 162,
+    "magenta2": 200,
+    "hot_pink2": 169,
+    "orchid": 170,
+    "medium_orchid1": 207,
+    "orange3": 172,
+    "light_pink3": 174,
+    "pink3": 175,
+    "plum3": 176,
+    "violet": 177,
+    "light_goldenrod3": 179,
+    "tan": 180,
+    "misty_rose3": 181,
+    "thistle3": 182,
+    "plum2": 183,
+    "khaki3": 185,
+    "light_goldenrod2": 222,
+    "light_yellow3": 187,
+    "grey84": 188,
+    "gray84": 188,
+    "light_steel_blue1": 189,
+    "yellow2": 190,
+    "dark_olive_green1": 192,
+    "honeydew2": 194,
+    "light_cyan1": 195,
+    "red1": 196,
+    "deep_pink2": 197,
+    "deep_pink1": 199,
+    "magenta1": 201,
+    "orange_red1": 202,
+    "indian_red1": 204,
+    "hot_pink": 206,
+    "dark_orange": 208,
+    "salmon1": 209,
+    "light_coral": 210,
+    "pale_violet_red1": 211,
+    "orchid2": 212,
+    "orchid1": 213,
+    "orange1": 214,
+    "sandy_brown": 215,
+    "light_salmon1": 216,
+    "light_pink1": 217,
+    "pink1": 218,
+    "plum1": 219,
+    "gold1": 220,
+    "navajo_white1": 223,
+    "misty_rose1": 224,
+    "thistle1": 225,
+    "yellow1": 226,
+    "light_goldenrod1": 227,
+    "khaki1": 228,
+    "wheat1": 229,
+    "cornsilk1": 230,
+    "grey100": 231,
+    "gray100": 231,
+    "grey3": 232,
+    "gray3": 232,
+    "grey7": 233,
+    "gray7": 233,
+    "grey11": 234,
+    "gray11": 234,
+    "grey15": 235,
+    "gray15": 235,
+    "grey19": 236,
+    "gray19": 236,
+    "grey23": 237,
+    "gray23": 237,
+    "grey27": 238,
+    "gray27": 238,
+    "grey30": 239,
+    "gray30": 239,
+    "grey35": 240,
+    "gray35": 240,
+    "grey39": 241,
+    "gray39": 241,
+    "grey42": 242,
+    "gray42": 242,
+    "grey46": 243,
+    "gray46": 243,
+    "grey50": 244,
+    "gray50": 244,
+    "grey54": 245,
+    "gray54": 245,
+    "grey58": 246,
+    "gray58": 246,
+    "grey62": 247,
+    "gray62": 247,
+    "grey66": 248,
+    "gray66": 248,
+    "grey70": 249,
+    "gray70": 249,
+    "grey74": 250,
+    "gray74": 250,
+    "grey78": 251,
+    "gray78": 251,
+    "grey82": 252,
+    "gray82": 252,
+    "grey85": 253,
+    "gray85": 253,
+    "grey89": 254,
+    "gray89": 254,
+    "grey93": 255,
+    "gray93": 255,
+}
+
+
+class ColorParseError(Exception):
+    """The color could not be parsed."""
+
+
+RE_COLOR = re.compile(
+    r"""^
+\#([0-9a-f]{6})$|
+color\(([0-9]{1,3})\)$|
+rgb\(([\d\s,]+)\)$
+""",
+    re.VERBOSE,
+)
+
+
+@rich_repr
+class Color(NamedTuple):
+    """Terminal color definition."""
+
+    name: str
+    """The name of the color (typically the input to Color.parse)."""
+    type: ColorType
+    """The type of the color."""
+    number: Optional[int] = None
+    """The color number, if a standard color, or None."""
+    triplet: Optional[ColorTriplet] = None
+    """A triplet of color components, if an RGB color."""
+
+    def __rich__(self) -> "Text":
+        """Displays the actual color if Rich printed."""
+        from .style import Style
+        from .text import Text
+
+        return Text.assemble(
+            f"",
+        )
+
+    def __rich_repr__(self) -> Result:
+        yield self.name
+        yield self.type
+        yield "number", self.number, None
+        yield "triplet", self.triplet, None
+
+    @property
+    def system(self) -> ColorSystem:
+        """Get the native color system for this color."""
+        if self.type == ColorType.DEFAULT:
+            return ColorSystem.STANDARD
+        return ColorSystem(int(self.type))
+
+    @property
+    def is_system_defined(self) -> bool:
+        """Check if the color is ultimately defined by the system."""
+        return self.system not in (ColorSystem.EIGHT_BIT, ColorSystem.TRUECOLOR)
+
+    @property
+    def is_default(self) -> bool:
+        """Check if the color is a default color."""
+        return self.type == ColorType.DEFAULT
+
+    def get_truecolor(
+        self, theme: Optional["TerminalTheme"] = None, foreground: bool = True
+    ) -> ColorTriplet:
+        """Get an equivalent color triplet for this color.
+
+        Args:
+            theme (TerminalTheme, optional): Optional terminal theme, or None to use default. Defaults to None.
+            foreground (bool, optional): True for a foreground color, or False for background. Defaults to True.
+
+        Returns:
+            ColorTriplet: A color triplet containing RGB components.
+        """
+
+        if theme is None:
+            theme = DEFAULT_TERMINAL_THEME
+        if self.type == ColorType.TRUECOLOR:
+            assert self.triplet is not None
+            return self.triplet
+        elif self.type == ColorType.EIGHT_BIT:
+            assert self.number is not None
+            return EIGHT_BIT_PALETTE[self.number]
+        elif self.type == ColorType.STANDARD:
+            assert self.number is not None
+            return theme.ansi_colors[self.number]
+        elif self.type == ColorType.WINDOWS:
+            assert self.number is not None
+            return WINDOWS_PALETTE[self.number]
+        else:  # self.type == ColorType.DEFAULT:
+            assert self.number is None
+            return theme.foreground_color if foreground else theme.background_color
+
+    @classmethod
+    def from_ansi(cls, number: int) -> "Color":
+        """Create a Color number from it's 8-bit ansi number.
+
+        Args:
+            number (int): A number between 0-255 inclusive.
+
+        Returns:
+            Color: A new Color instance.
+        """
+        return cls(
+            name=f"color({number})",
+            type=(ColorType.STANDARD if number < 16 else ColorType.EIGHT_BIT),
+            number=number,
+        )
+
+    @classmethod
+    def from_triplet(cls, triplet: "ColorTriplet") -> "Color":
+        """Create a truecolor RGB color from a triplet of values.
+
+        Args:
+            triplet (ColorTriplet): A color triplet containing red, green and blue components.
+
+        Returns:
+            Color: A new color object.
+        """
+        return cls(name=triplet.hex, type=ColorType.TRUECOLOR, triplet=triplet)
+
+    @classmethod
+    def from_rgb(cls, red: float, green: float, blue: float) -> "Color":
+        """Create a truecolor from three color components in the range(0->255).
+
+        Args:
+            red (float): Red component in range 0-255.
+            green (float): Green component in range 0-255.
+            blue (float): Blue component in range 0-255.
+
+        Returns:
+            Color: A new color object.
+        """
+        return cls.from_triplet(ColorTriplet(int(red), int(green), int(blue)))
+
+    @classmethod
+    def default(cls) -> "Color":
+        """Get a Color instance representing the default color.
+
+        Returns:
+            Color: Default color.
+        """
+        return cls(name="default", type=ColorType.DEFAULT)
+
+    @classmethod
+    @lru_cache(maxsize=1024)
+    def parse(cls, color: str) -> "Color":
+        """Parse a color definition."""
+        original_color = color
+        color = color.lower().strip()
+
+        if color == "default":
+            return cls(color, type=ColorType.DEFAULT)
+
+        color_number = ANSI_COLOR_NAMES.get(color)
+        if color_number is not None:
+            return cls(
+                color,
+                type=(ColorType.STANDARD if color_number < 16 else ColorType.EIGHT_BIT),
+                number=color_number,
+            )
+
+        color_match = RE_COLOR.match(color)
+        if color_match is None:
+            raise ColorParseError(f"{original_color!r} is not a valid color")
+
+        color_24, color_8, color_rgb = color_match.groups()
+        if color_24:
+            triplet = ColorTriplet(
+                int(color_24[0:2], 16), int(color_24[2:4], 16), int(color_24[4:6], 16)
+            )
+            return cls(color, ColorType.TRUECOLOR, triplet=triplet)
+
+        elif color_8:
+            number = int(color_8)
+            if number > 255:
+                raise ColorParseError(f"color number must be <= 255 in {color!r}")
+            return cls(
+                color,
+                type=(ColorType.STANDARD if number < 16 else ColorType.EIGHT_BIT),
+                number=number,
+            )
+
+        else:  #  color_rgb:
+            components = color_rgb.split(",")
+            if len(components) != 3:
+                raise ColorParseError(
+                    f"expected three components in {original_color!r}"
+                )
+            red, green, blue = components
+            triplet = ColorTriplet(int(red), int(green), int(blue))
+            if not all(component <= 255 for component in triplet):
+                raise ColorParseError(
+                    f"color components must be <= 255 in {original_color!r}"
+                )
+            return cls(color, ColorType.TRUECOLOR, triplet=triplet)
+
+    @lru_cache(maxsize=1024)
+    def get_ansi_codes(self, foreground: bool = True) -> Tuple[str, ...]:
+        """Get the ANSI escape codes for this color."""
+        _type = self.type
+        if _type == ColorType.DEFAULT:
+            return ("39" if foreground else "49",)
+
+        elif _type == ColorType.WINDOWS:
+            number = self.number
+            assert number is not None
+            fore, back = (30, 40) if number < 8 else (82, 92)
+            return (str(fore + number if foreground else back + number),)
+
+        elif _type == ColorType.STANDARD:
+            number = self.number
+            assert number is not None
+            fore, back = (30, 40) if number < 8 else (82, 92)
+            return (str(fore + number if foreground else back + number),)
+
+        elif _type == ColorType.EIGHT_BIT:
+            assert self.number is not None
+            return ("38" if foreground else "48", "5", str(self.number))
+
+        else:  # self.standard == ColorStandard.TRUECOLOR:
+            assert self.triplet is not None
+            red, green, blue = self.triplet
+            return ("38" if foreground else "48", "2", str(red), str(green), str(blue))
+
+    @lru_cache(maxsize=1024)
+    def downgrade(self, system: ColorSystem) -> "Color":
+        """Downgrade a color system to a system with fewer colors."""
+
+        if self.type in (ColorType.DEFAULT, system):
+            return self
+        # Convert to 8-bit color from truecolor color
+        if system == ColorSystem.EIGHT_BIT and self.system == ColorSystem.TRUECOLOR:
+            assert self.triplet is not None
+            _h, l, s = rgb_to_hls(*self.triplet.normalized)
+            # If saturation is under 15% assume it is grayscale
+            if s < 0.15:
+                gray = round(l * 25.0)
+                if gray == 0:
+                    color_number = 16
+                elif gray == 25:
+                    color_number = 231
+                else:
+                    color_number = 231 + gray
+                return Color(self.name, ColorType.EIGHT_BIT, number=color_number)
+
+            red, green, blue = self.triplet
+            six_red = red / 95 if red < 95 else 1 + (red - 95) / 40
+            six_green = green / 95 if green < 95 else 1 + (green - 95) / 40
+            six_blue = blue / 95 if blue < 95 else 1 + (blue - 95) / 40
+
+            color_number = (
+                16 + 36 * round(six_red) + 6 * round(six_green) + round(six_blue)
+            )
+            return Color(self.name, ColorType.EIGHT_BIT, number=color_number)
+
+        # Convert to standard from truecolor or 8-bit
+        elif system == ColorSystem.STANDARD:
+            if self.system == ColorSystem.TRUECOLOR:
+                assert self.triplet is not None
+                triplet = self.triplet
+            else:  # self.system == ColorSystem.EIGHT_BIT
+                assert self.number is not None
+                triplet = ColorTriplet(*EIGHT_BIT_PALETTE[self.number])
+
+            color_number = STANDARD_PALETTE.match(triplet)
+            return Color(self.name, ColorType.STANDARD, number=color_number)
+
+        elif system == ColorSystem.WINDOWS:
+            if self.system == ColorSystem.TRUECOLOR:
+                assert self.triplet is not None
+                triplet = self.triplet
+            else:  # self.system == ColorSystem.EIGHT_BIT
+                assert self.number is not None
+                if self.number < 16:
+                    return Color(self.name, ColorType.WINDOWS, number=self.number)
+                triplet = ColorTriplet(*EIGHT_BIT_PALETTE[self.number])
+
+            color_number = WINDOWS_PALETTE.match(triplet)
+            return Color(self.name, ColorType.WINDOWS, number=color_number)
+
+        return self
+
+
+def parse_rgb_hex(hex_color: str) -> ColorTriplet:
+    """Parse six hex characters in to RGB triplet."""
+    assert len(hex_color) == 6, "must be 6 characters"
+    color = ColorTriplet(
+        int(hex_color[0:2], 16), int(hex_color[2:4], 16), int(hex_color[4:6], 16)
+    )
+    return color
+
+
+def blend_rgb(
+    color1: ColorTriplet, color2: ColorTriplet, cross_fade: float = 0.5
+) -> ColorTriplet:
+    """Blend one RGB color in to another."""
+    r1, g1, b1 = color1
+    r2, g2, b2 = color2
+    new_color = ColorTriplet(
+        int(r1 + (r2 - r1) * cross_fade),
+        int(g1 + (g2 - g1) * cross_fade),
+        int(b1 + (b2 - b1) * cross_fade),
+    )
+    return new_color
+
+
+if __name__ == "__main__":  # pragma: no cover
+    from .console import Console
+    from .table import Table
+    from .text import Text
+
+    console = Console()
+
+    table = Table(show_footer=False, show_edge=True)
+    table.add_column("Color", width=10, overflow="ellipsis")
+    table.add_column("Number", justify="right", style="yellow")
+    table.add_column("Name", style="green")
+    table.add_column("Hex", style="blue")
+    table.add_column("RGB", style="magenta")
+
+    colors = sorted((v, k) for k, v in ANSI_COLOR_NAMES.items())
+    for color_number, name in colors:
+        if "grey" in name:
+            continue
+        color_cell = Text(" " * 10, style=f"on {name}")
+        if color_number < 16:
+            table.add_row(color_cell, f"{color_number}", Text(f'"{name}"'))
+        else:
+            color = EIGHT_BIT_PALETTE[color_number]  # type: ignore[has-type]
+            table.add_row(
+                color_cell, str(color_number), Text(f'"{name}"'), color.hex, color.rgb
+            )
+
+    console.print(table)
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/color_triplet.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/color_triplet.py
new file mode 100644
index 0000000..02cab32
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/color_triplet.py
@@ -0,0 +1,38 @@
+from typing import NamedTuple, Tuple
+
+
+class ColorTriplet(NamedTuple):
+    """The red, green, and blue components of a color."""
+
+    red: int
+    """Red component in 0 to 255 range."""
+    green: int
+    """Green component in 0 to 255 range."""
+    blue: int
+    """Blue component in 0 to 255 range."""
+
+    @property
+    def hex(self) -> str:
+        """get the color triplet in CSS style."""
+        red, green, blue = self
+        return f"#{red:02x}{green:02x}{blue:02x}"
+
+    @property
+    def rgb(self) -> str:
+        """The color in RGB format.
+
+        Returns:
+            str: An rgb color, e.g. ``"rgb(100,23,255)"``.
+        """
+        red, green, blue = self
+        return f"rgb({red},{green},{blue})"
+
+    @property
+    def normalized(self) -> Tuple[float, float, float]:
+        """Convert components into floats between 0 and 1.
+
+        Returns:
+            Tuple[float, float, float]: A tuple of three normalized colour components.
+        """
+        red, green, blue = self
+        return red / 255.0, green / 255.0, blue / 255.0
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/columns.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/columns.py
new file mode 100644
index 0000000..669a3a7
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/columns.py
@@ -0,0 +1,187 @@
+from collections import defaultdict
+from itertools import chain
+from operator import itemgetter
+from typing import Dict, Iterable, List, Optional, Tuple
+
+from .align import Align, AlignMethod
+from .console import Console, ConsoleOptions, RenderableType, RenderResult
+from .constrain import Constrain
+from .measure import Measurement
+from .padding import Padding, PaddingDimensions
+from .table import Table
+from .text import TextType
+from .jupyter import JupyterMixin
+
+
+class Columns(JupyterMixin):
+    """Display renderables in neat columns.
+
+    Args:
+        renderables (Iterable[RenderableType]): Any number of Rich renderables (including str).
+        width (int, optional): The desired width of the columns, or None to auto detect. Defaults to None.
+        padding (PaddingDimensions, optional): Optional padding around cells. Defaults to (0, 1).
+        expand (bool, optional): Expand columns to full width. Defaults to False.
+        equal (bool, optional): Arrange in to equal sized columns. Defaults to False.
+        column_first (bool, optional): Align items from top to bottom (rather than left to right). Defaults to False.
+        right_to_left (bool, optional): Start column from right hand side. Defaults to False.
+        align (str, optional): Align value ("left", "right", or "center") or None for default. Defaults to None.
+        title (TextType, optional): Optional title for Columns.
+    """
+
+    def __init__(
+        self,
+        renderables: Optional[Iterable[RenderableType]] = None,
+        padding: PaddingDimensions = (0, 1),
+        *,
+        width: Optional[int] = None,
+        expand: bool = False,
+        equal: bool = False,
+        column_first: bool = False,
+        right_to_left: bool = False,
+        align: Optional[AlignMethod] = None,
+        title: Optional[TextType] = None,
+    ) -> None:
+        self.renderables = list(renderables or [])
+        self.width = width
+        self.padding = padding
+        self.expand = expand
+        self.equal = equal
+        self.column_first = column_first
+        self.right_to_left = right_to_left
+        self.align: Optional[AlignMethod] = align
+        self.title = title
+
+    def add_renderable(self, renderable: RenderableType) -> None:
+        """Add a renderable to the columns.
+
+        Args:
+            renderable (RenderableType): Any renderable object.
+        """
+        self.renderables.append(renderable)
+
+    def __rich_console__(
+        self, console: Console, options: ConsoleOptions
+    ) -> RenderResult:
+        render_str = console.render_str
+        renderables = [
+            render_str(renderable) if isinstance(renderable, str) else renderable
+            for renderable in self.renderables
+        ]
+        if not renderables:
+            return
+        _top, right, _bottom, left = Padding.unpack(self.padding)
+        width_padding = max(left, right)
+        max_width = options.max_width
+        widths: Dict[int, int] = defaultdict(int)
+        column_count = len(renderables)
+
+        get_measurement = Measurement.get
+        renderable_widths = [
+            get_measurement(console, options, renderable).maximum
+            for renderable in renderables
+        ]
+        if self.equal:
+            renderable_widths = [max(renderable_widths)] * len(renderable_widths)
+
+        def iter_renderables(
+            column_count: int,
+        ) -> Iterable[Tuple[int, Optional[RenderableType]]]:
+            item_count = len(renderables)
+            if self.column_first:
+                width_renderables = list(zip(renderable_widths, renderables))
+
+                column_lengths: List[int] = [item_count // column_count] * column_count
+                for col_no in range(item_count % column_count):
+                    column_lengths[col_no] += 1
+
+                row_count = (item_count + column_count - 1) // column_count
+                cells = [[-1] * column_count for _ in range(row_count)]
+                row = col = 0
+                for index in range(item_count):
+                    cells[row][col] = index
+                    column_lengths[col] -= 1
+                    if column_lengths[col]:
+                        row += 1
+                    else:
+                        col += 1
+                        row = 0
+                for index in chain.from_iterable(cells):
+                    if index == -1:
+                        break
+                    yield width_renderables[index]
+            else:
+                yield from zip(renderable_widths, renderables)
+            # Pad odd elements with spaces
+            if item_count % column_count:
+                for _ in range(column_count - (item_count % column_count)):
+                    yield 0, None
+
+        table = Table.grid(padding=self.padding, collapse_padding=True, pad_edge=False)
+        table.expand = self.expand
+        table.title = self.title
+
+        if self.width is not None:
+            column_count = (max_width) // (self.width + width_padding)
+            for _ in range(column_count):
+                table.add_column(width=self.width)
+        else:
+            while column_count > 1:
+                widths.clear()
+                column_no = 0
+                for renderable_width, _ in iter_renderables(column_count):
+                    widths[column_no] = max(widths[column_no], renderable_width)
+                    total_width = sum(widths.values()) + width_padding * (
+                        len(widths) - 1
+                    )
+                    if total_width > max_width:
+                        column_count = len(widths) - 1
+                        break
+                    else:
+                        column_no = (column_no + 1) % column_count
+                else:
+                    break
+
+        get_renderable = itemgetter(1)
+        _renderables = [
+            get_renderable(_renderable)
+            for _renderable in iter_renderables(column_count)
+        ]
+        if self.equal:
+            _renderables = [
+                None
+                if renderable is None
+                else Constrain(renderable, renderable_widths[0])
+                for renderable in _renderables
+            ]
+        if self.align:
+            align = self.align
+            _Align = Align
+            _renderables = [
+                None if renderable is None else _Align(renderable, align)
+                for renderable in _renderables
+            ]
+
+        right_to_left = self.right_to_left
+        add_row = table.add_row
+        for start in range(0, len(_renderables), column_count):
+            row = _renderables[start : start + column_count]
+            if right_to_left:
+                row = row[::-1]
+            add_row(*row)
+        yield table
+
+
+if __name__ == "__main__":  # pragma: no cover
+    import os
+
+    console = Console()
+
+    files = [f"{i} {s}" for i, s in enumerate(sorted(os.listdir()))]
+    columns = Columns(files, padding=(0, 1), expand=False, equal=False)
+    console.print(columns)
+    console.rule()
+    columns.column_first = True
+    console.print(columns)
+    columns.right_to_left = True
+    console.rule()
+    console.print(columns)
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/console.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/console.py
new file mode 100644
index 0000000..5728845
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/console.py
@@ -0,0 +1,2661 @@
+import inspect
+import os
+import sys
+import threading
+import zlib
+from abc import ABC, abstractmethod
+from dataclasses import dataclass, field
+from datetime import datetime
+from functools import wraps
+from getpass import getpass
+from html import escape
+from inspect import isclass
+from itertools import islice
+from math import ceil
+from time import monotonic
+from types import FrameType, ModuleType, TracebackType
+from typing import (
+    IO,
+    TYPE_CHECKING,
+    Any,
+    Callable,
+    Dict,
+    Iterable,
+    List,
+    Mapping,
+    NamedTuple,
+    Optional,
+    TextIO,
+    Tuple,
+    Type,
+    Union,
+    cast,
+)
+
+from pip._vendor.rich._null_file import NULL_FILE
+
+if sys.version_info >= (3, 8):
+    from typing import Literal, Protocol, runtime_checkable
+else:
+    from pip._vendor.typing_extensions import (
+        Literal,
+        Protocol,
+        runtime_checkable,
+    )  # pragma: no cover
+
+from . import errors, themes
+from ._emoji_replace import _emoji_replace
+from ._export_format import CONSOLE_HTML_FORMAT, CONSOLE_SVG_FORMAT
+from ._fileno import get_fileno
+from ._log_render import FormatTimeCallable, LogRender
+from .align import Align, AlignMethod
+from .color import ColorSystem, blend_rgb
+from .control import Control
+from .emoji import EmojiVariant
+from .highlighter import NullHighlighter, ReprHighlighter
+from .markup import render as render_markup
+from .measure import Measurement, measure_renderables
+from .pager import Pager, SystemPager
+from .pretty import Pretty, is_expandable
+from .protocol import rich_cast
+from .region import Region
+from .scope import render_scope
+from .screen import Screen
+from .segment import Segment
+from .style import Style, StyleType
+from .styled import Styled
+from .terminal_theme import DEFAULT_TERMINAL_THEME, SVG_EXPORT_THEME, TerminalTheme
+from .text import Text, TextType
+from .theme import Theme, ThemeStack
+
+if TYPE_CHECKING:
+    from ._windows import WindowsConsoleFeatures
+    from .live import Live
+    from .status import Status
+
+JUPYTER_DEFAULT_COLUMNS = 115
+JUPYTER_DEFAULT_LINES = 100
+WINDOWS = sys.platform == "win32"
+
+HighlighterType = Callable[[Union[str, "Text"]], "Text"]
+JustifyMethod = Literal["default", "left", "center", "right", "full"]
+OverflowMethod = Literal["fold", "crop", "ellipsis", "ignore"]
+
+
+class NoChange:
+    pass
+
+
+NO_CHANGE = NoChange()
+
+try:
+    _STDIN_FILENO = sys.__stdin__.fileno()  # type: ignore[union-attr]
+except Exception:
+    _STDIN_FILENO = 0
+try:
+    _STDOUT_FILENO = sys.__stdout__.fileno()  # type: ignore[union-attr]
+except Exception:
+    _STDOUT_FILENO = 1
+try:
+    _STDERR_FILENO = sys.__stderr__.fileno()  # type: ignore[union-attr]
+except Exception:
+    _STDERR_FILENO = 2
+
+_STD_STREAMS = (_STDIN_FILENO, _STDOUT_FILENO, _STDERR_FILENO)
+_STD_STREAMS_OUTPUT = (_STDOUT_FILENO, _STDERR_FILENO)
+
+
+_TERM_COLORS = {
+    "kitty": ColorSystem.EIGHT_BIT,
+    "256color": ColorSystem.EIGHT_BIT,
+    "16color": ColorSystem.STANDARD,
+}
+
+
+class ConsoleDimensions(NamedTuple):
+    """Size of the terminal."""
+
+    width: int
+    """The width of the console in 'cells'."""
+    height: int
+    """The height of the console in lines."""
+
+
+@dataclass
+class ConsoleOptions:
+    """Options for __rich_console__ method."""
+
+    size: ConsoleDimensions
+    """Size of console."""
+    legacy_windows: bool
+    """legacy_windows: flag for legacy windows."""
+    min_width: int
+    """Minimum width of renderable."""
+    max_width: int
+    """Maximum width of renderable."""
+    is_terminal: bool
+    """True if the target is a terminal, otherwise False."""
+    encoding: str
+    """Encoding of terminal."""
+    max_height: int
+    """Height of container (starts as terminal)"""
+    justify: Optional[JustifyMethod] = None
+    """Justify value override for renderable."""
+    overflow: Optional[OverflowMethod] = None
+    """Overflow value override for renderable."""
+    no_wrap: Optional[bool] = False
+    """Disable wrapping for text."""
+    highlight: Optional[bool] = None
+    """Highlight override for render_str."""
+    markup: Optional[bool] = None
+    """Enable markup when rendering strings."""
+    height: Optional[int] = None
+
+    @property
+    def ascii_only(self) -> bool:
+        """Check if renderables should use ascii only."""
+        return not self.encoding.startswith("utf")
+
+    def copy(self) -> "ConsoleOptions":
+        """Return a copy of the options.
+
+        Returns:
+            ConsoleOptions: a copy of self.
+        """
+        options: ConsoleOptions = ConsoleOptions.__new__(ConsoleOptions)
+        options.__dict__ = self.__dict__.copy()
+        return options
+
+    def update(
+        self,
+        *,
+        width: Union[int, NoChange] = NO_CHANGE,
+        min_width: Union[int, NoChange] = NO_CHANGE,
+        max_width: Union[int, NoChange] = NO_CHANGE,
+        justify: Union[Optional[JustifyMethod], NoChange] = NO_CHANGE,
+        overflow: Union[Optional[OverflowMethod], NoChange] = NO_CHANGE,
+        no_wrap: Union[Optional[bool], NoChange] = NO_CHANGE,
+        highlight: Union[Optional[bool], NoChange] = NO_CHANGE,
+        markup: Union[Optional[bool], NoChange] = NO_CHANGE,
+        height: Union[Optional[int], NoChange] = NO_CHANGE,
+    ) -> "ConsoleOptions":
+        """Update values, return a copy."""
+        options = self.copy()
+        if not isinstance(width, NoChange):
+            options.min_width = options.max_width = max(0, width)
+        if not isinstance(min_width, NoChange):
+            options.min_width = min_width
+        if not isinstance(max_width, NoChange):
+            options.max_width = max_width
+        if not isinstance(justify, NoChange):
+            options.justify = justify
+        if not isinstance(overflow, NoChange):
+            options.overflow = overflow
+        if not isinstance(no_wrap, NoChange):
+            options.no_wrap = no_wrap
+        if not isinstance(highlight, NoChange):
+            options.highlight = highlight
+        if not isinstance(markup, NoChange):
+            options.markup = markup
+        if not isinstance(height, NoChange):
+            if height is not None:
+                options.max_height = height
+            options.height = None if height is None else max(0, height)
+        return options
+
+    def update_width(self, width: int) -> "ConsoleOptions":
+        """Update just the width, return a copy.
+
+        Args:
+            width (int): New width (sets both min_width and max_width)
+
+        Returns:
+            ~ConsoleOptions: New console options instance.
+        """
+        options = self.copy()
+        options.min_width = options.max_width = max(0, width)
+        return options
+
+    def update_height(self, height: int) -> "ConsoleOptions":
+        """Update the height, and return a copy.
+
+        Args:
+            height (int): New height
+
+        Returns:
+            ~ConsoleOptions: New Console options instance.
+        """
+        options = self.copy()
+        options.max_height = options.height = height
+        return options
+
+    def reset_height(self) -> "ConsoleOptions":
+        """Return a copy of the options with height set to ``None``.
+
+        Returns:
+            ~ConsoleOptions: New console options instance.
+        """
+        options = self.copy()
+        options.height = None
+        return options
+
+    def update_dimensions(self, width: int, height: int) -> "ConsoleOptions":
+        """Update the width and height, and return a copy.
+
+        Args:
+            width (int): New width (sets both min_width and max_width).
+            height (int): New height.
+
+        Returns:
+            ~ConsoleOptions: New console options instance.
+        """
+        options = self.copy()
+        options.min_width = options.max_width = max(0, width)
+        options.height = options.max_height = height
+        return options
+
+
+@runtime_checkable
+class RichCast(Protocol):
+    """An object that may be 'cast' to a console renderable."""
+
+    def __rich__(
+        self,
+    ) -> Union["ConsoleRenderable", "RichCast", str]:  # pragma: no cover
+        ...
+
+
+@runtime_checkable
+class ConsoleRenderable(Protocol):
+    """An object that supports the console protocol."""
+
+    def __rich_console__(
+        self, console: "Console", options: "ConsoleOptions"
+    ) -> "RenderResult":  # pragma: no cover
+        ...
+
+
+# A type that may be rendered by Console.
+RenderableType = Union[ConsoleRenderable, RichCast, str]
+"""A string or any object that may be rendered by Rich."""
+
+# The result of calling a __rich_console__ method.
+RenderResult = Iterable[Union[RenderableType, Segment]]
+
+_null_highlighter = NullHighlighter()
+
+
+class CaptureError(Exception):
+    """An error in the Capture context manager."""
+
+
+class NewLine:
+    """A renderable to generate new line(s)"""
+
+    def __init__(self, count: int = 1) -> None:
+        self.count = count
+
+    def __rich_console__(
+        self, console: "Console", options: "ConsoleOptions"
+    ) -> Iterable[Segment]:
+        yield Segment("\n" * self.count)
+
+
+class ScreenUpdate:
+    """Render a list of lines at a given offset."""
+
+    def __init__(self, lines: List[List[Segment]], x: int, y: int) -> None:
+        self._lines = lines
+        self.x = x
+        self.y = y
+
+    def __rich_console__(
+        self, console: "Console", options: ConsoleOptions
+    ) -> RenderResult:
+        x = self.x
+        move_to = Control.move_to
+        for offset, line in enumerate(self._lines, self.y):
+            yield move_to(x, offset)
+            yield from line
+
+
+class Capture:
+    """Context manager to capture the result of printing to the console.
+    See :meth:`~rich.console.Console.capture` for how to use.
+
+    Args:
+        console (Console): A console instance to capture output.
+    """
+
+    def __init__(self, console: "Console") -> None:
+        self._console = console
+        self._result: Optional[str] = None
+
+    def __enter__(self) -> "Capture":
+        self._console.begin_capture()
+        return self
+
+    def __exit__(
+        self,
+        exc_type: Optional[Type[BaseException]],
+        exc_val: Optional[BaseException],
+        exc_tb: Optional[TracebackType],
+    ) -> None:
+        self._result = self._console.end_capture()
+
+    def get(self) -> str:
+        """Get the result of the capture."""
+        if self._result is None:
+            raise CaptureError(
+                "Capture result is not available until context manager exits."
+            )
+        return self._result
+
+
+class ThemeContext:
+    """A context manager to use a temporary theme. See :meth:`~rich.console.Console.use_theme` for usage."""
+
+    def __init__(self, console: "Console", theme: Theme, inherit: bool = True) -> None:
+        self.console = console
+        self.theme = theme
+        self.inherit = inherit
+
+    def __enter__(self) -> "ThemeContext":
+        self.console.push_theme(self.theme)
+        return self
+
+    def __exit__(
+        self,
+        exc_type: Optional[Type[BaseException]],
+        exc_val: Optional[BaseException],
+        exc_tb: Optional[TracebackType],
+    ) -> None:
+        self.console.pop_theme()
+
+
+class PagerContext:
+    """A context manager that 'pages' content. See :meth:`~rich.console.Console.pager` for usage."""
+
+    def __init__(
+        self,
+        console: "Console",
+        pager: Optional[Pager] = None,
+        styles: bool = False,
+        links: bool = False,
+    ) -> None:
+        self._console = console
+        self.pager = SystemPager() if pager is None else pager
+        self.styles = styles
+        self.links = links
+
+    def __enter__(self) -> "PagerContext":
+        self._console._enter_buffer()
+        return self
+
+    def __exit__(
+        self,
+        exc_type: Optional[Type[BaseException]],
+        exc_val: Optional[BaseException],
+        exc_tb: Optional[TracebackType],
+    ) -> None:
+        if exc_type is None:
+            with self._console._lock:
+                buffer: List[Segment] = self._console._buffer[:]
+                del self._console._buffer[:]
+                segments: Iterable[Segment] = buffer
+                if not self.styles:
+                    segments = Segment.strip_styles(segments)
+                elif not self.links:
+                    segments = Segment.strip_links(segments)
+                content = self._console._render_buffer(segments)
+            self.pager.show(content)
+        self._console._exit_buffer()
+
+
+class ScreenContext:
+    """A context manager that enables an alternative screen. See :meth:`~rich.console.Console.screen` for usage."""
+
+    def __init__(
+        self, console: "Console", hide_cursor: bool, style: StyleType = ""
+    ) -> None:
+        self.console = console
+        self.hide_cursor = hide_cursor
+        self.screen = Screen(style=style)
+        self._changed = False
+
+    def update(
+        self, *renderables: RenderableType, style: Optional[StyleType] = None
+    ) -> None:
+        """Update the screen.
+
+        Args:
+            renderable (RenderableType, optional): Optional renderable to replace current renderable,
+                or None for no change. Defaults to None.
+            style: (Style, optional): Replacement style, or None for no change. Defaults to None.
+        """
+        if renderables:
+            self.screen.renderable = (
+                Group(*renderables) if len(renderables) > 1 else renderables[0]
+            )
+        if style is not None:
+            self.screen.style = style
+        self.console.print(self.screen, end="")
+
+    def __enter__(self) -> "ScreenContext":
+        self._changed = self.console.set_alt_screen(True)
+        if self._changed and self.hide_cursor:
+            self.console.show_cursor(False)
+        return self
+
+    def __exit__(
+        self,
+        exc_type: Optional[Type[BaseException]],
+        exc_val: Optional[BaseException],
+        exc_tb: Optional[TracebackType],
+    ) -> None:
+        if self._changed:
+            self.console.set_alt_screen(False)
+            if self.hide_cursor:
+                self.console.show_cursor(True)
+
+
+class Group:
+    """Takes a group of renderables and returns a renderable object that renders the group.
+
+    Args:
+        renderables (Iterable[RenderableType]): An iterable of renderable objects.
+        fit (bool, optional): Fit dimension of group to contents, or fill available space. Defaults to True.
+    """
+
+    def __init__(self, *renderables: "RenderableType", fit: bool = True) -> None:
+        self._renderables = renderables
+        self.fit = fit
+        self._render: Optional[List[RenderableType]] = None
+
+    @property
+    def renderables(self) -> List["RenderableType"]:
+        if self._render is None:
+            self._render = list(self._renderables)
+        return self._render
+
+    def __rich_measure__(
+        self, console: "Console", options: "ConsoleOptions"
+    ) -> "Measurement":
+        if self.fit:
+            return measure_renderables(console, options, self.renderables)
+        else:
+            return Measurement(options.max_width, options.max_width)
+
+    def __rich_console__(
+        self, console: "Console", options: "ConsoleOptions"
+    ) -> RenderResult:
+        yield from self.renderables
+
+
+def group(fit: bool = True) -> Callable[..., Callable[..., Group]]:
+    """A decorator that turns an iterable of renderables in to a group.
+
+    Args:
+        fit (bool, optional): Fit dimension of group to contents, or fill available space. Defaults to True.
+    """
+
+    def decorator(
+        method: Callable[..., Iterable[RenderableType]]
+    ) -> Callable[..., Group]:
+        """Convert a method that returns an iterable of renderables in to a Group."""
+
+        @wraps(method)
+        def _replace(*args: Any, **kwargs: Any) -> Group:
+            renderables = method(*args, **kwargs)
+            return Group(*renderables, fit=fit)
+
+        return _replace
+
+    return decorator
+
+
+def _is_jupyter() -> bool:  # pragma: no cover
+    """Check if we're running in a Jupyter notebook."""
+    try:
+        get_ipython  # type: ignore[name-defined]
+    except NameError:
+        return False
+    ipython = get_ipython()  # type: ignore[name-defined]
+    shell = ipython.__class__.__name__
+    if (
+        "google.colab" in str(ipython.__class__)
+        or os.getenv("DATABRICKS_RUNTIME_VERSION")
+        or shell == "ZMQInteractiveShell"
+    ):
+        return True  # Jupyter notebook or qtconsole
+    elif shell == "TerminalInteractiveShell":
+        return False  # Terminal running IPython
+    else:
+        return False  # Other type (?)
+
+
+COLOR_SYSTEMS = {
+    "standard": ColorSystem.STANDARD,
+    "256": ColorSystem.EIGHT_BIT,
+    "truecolor": ColorSystem.TRUECOLOR,
+    "windows": ColorSystem.WINDOWS,
+}
+
+_COLOR_SYSTEMS_NAMES = {system: name for name, system in COLOR_SYSTEMS.items()}
+
+
+@dataclass
+class ConsoleThreadLocals(threading.local):
+    """Thread local values for Console context."""
+
+    theme_stack: ThemeStack
+    buffer: List[Segment] = field(default_factory=list)
+    buffer_index: int = 0
+
+
+class RenderHook(ABC):
+    """Provides hooks in to the render process."""
+
+    @abstractmethod
+    def process_renderables(
+        self, renderables: List[ConsoleRenderable]
+    ) -> List[ConsoleRenderable]:
+        """Called with a list of objects to render.
+
+        This method can return a new list of renderables, or modify and return the same list.
+
+        Args:
+            renderables (List[ConsoleRenderable]): A number of renderable objects.
+
+        Returns:
+            List[ConsoleRenderable]: A replacement list of renderables.
+        """
+
+
+_windows_console_features: Optional["WindowsConsoleFeatures"] = None
+
+
+def get_windows_console_features() -> "WindowsConsoleFeatures":  # pragma: no cover
+    global _windows_console_features
+    if _windows_console_features is not None:
+        return _windows_console_features
+    from ._windows import get_windows_console_features
+
+    _windows_console_features = get_windows_console_features()
+    return _windows_console_features
+
+
+def detect_legacy_windows() -> bool:
+    """Detect legacy Windows."""
+    return WINDOWS and not get_windows_console_features().vt
+
+
+class Console:
+    """A high level console interface.
+
+    Args:
+        color_system (str, optional): The color system supported by your terminal,
+            either ``"standard"``, ``"256"`` or ``"truecolor"``. Leave as ``"auto"`` to autodetect.
+        force_terminal (Optional[bool], optional): Enable/disable terminal control codes, or None to auto-detect terminal. Defaults to None.
+        force_jupyter (Optional[bool], optional): Enable/disable Jupyter rendering, or None to auto-detect Jupyter. Defaults to None.
+        force_interactive (Optional[bool], optional): Enable/disable interactive mode, or None to auto detect. Defaults to None.
+        soft_wrap (Optional[bool], optional): Set soft wrap default on print method. Defaults to False.
+        theme (Theme, optional): An optional style theme object, or ``None`` for default theme.
+        stderr (bool, optional): Use stderr rather than stdout if ``file`` is not specified. Defaults to False.
+        file (IO, optional): A file object where the console should write to. Defaults to stdout.
+        quiet (bool, Optional): Boolean to suppress all output. Defaults to False.
+        width (int, optional): The width of the terminal. Leave as default to auto-detect width.
+        height (int, optional): The height of the terminal. Leave as default to auto-detect height.
+        style (StyleType, optional): Style to apply to all output, or None for no style. Defaults to None.
+        no_color (Optional[bool], optional): Enabled no color mode, or None to auto detect. Defaults to None.
+        tab_size (int, optional): Number of spaces used to replace a tab character. Defaults to 8.
+        record (bool, optional): Boolean to enable recording of terminal output,
+            required to call :meth:`export_html`, :meth:`export_svg`, and :meth:`export_text`. Defaults to False.
+        markup (bool, optional): Boolean to enable :ref:`console_markup`. Defaults to True.
+        emoji (bool, optional): Enable emoji code. Defaults to True.
+        emoji_variant (str, optional): Optional emoji variant, either "text" or "emoji". Defaults to None.
+        highlight (bool, optional): Enable automatic highlighting. Defaults to True.
+        log_time (bool, optional): Boolean to enable logging of time by :meth:`log` methods. Defaults to True.
+        log_path (bool, optional): Boolean to enable the logging of the caller by :meth:`log`. Defaults to True.
+        log_time_format (Union[str, TimeFormatterCallable], optional): If ``log_time`` is enabled, either string for strftime or callable that formats the time. Defaults to "[%X] ".
+        highlighter (HighlighterType, optional): Default highlighter.
+        legacy_windows (bool, optional): Enable legacy Windows mode, or ``None`` to auto detect. Defaults to ``None``.
+        safe_box (bool, optional): Restrict box options that don't render on legacy Windows.
+        get_datetime (Callable[[], datetime], optional): Callable that gets the current time as a datetime.datetime object (used by Console.log),
+            or None for datetime.now.
+        get_time (Callable[[], time], optional): Callable that gets the current time in seconds, default uses time.monotonic.
+    """
+
+    _environ: Mapping[str, str] = os.environ
+
+    def __init__(
+        self,
+        *,
+        color_system: Optional[
+            Literal["auto", "standard", "256", "truecolor", "windows"]
+        ] = "auto",
+        force_terminal: Optional[bool] = None,
+        force_jupyter: Optional[bool] = None,
+        force_interactive: Optional[bool] = None,
+        soft_wrap: bool = False,
+        theme: Optional[Theme] = None,
+        stderr: bool = False,
+        file: Optional[IO[str]] = None,
+        quiet: bool = False,
+        width: Optional[int] = None,
+        height: Optional[int] = None,
+        style: Optional[StyleType] = None,
+        no_color: Optional[bool] = None,
+        tab_size: int = 8,
+        record: bool = False,
+        markup: bool = True,
+        emoji: bool = True,
+        emoji_variant: Optional[EmojiVariant] = None,
+        highlight: bool = True,
+        log_time: bool = True,
+        log_path: bool = True,
+        log_time_format: Union[str, FormatTimeCallable] = "[%X]",
+        highlighter: Optional["HighlighterType"] = ReprHighlighter(),
+        legacy_windows: Optional[bool] = None,
+        safe_box: bool = True,
+        get_datetime: Optional[Callable[[], datetime]] = None,
+        get_time: Optional[Callable[[], float]] = None,
+        _environ: Optional[Mapping[str, str]] = None,
+    ):
+        # Copy of os.environ allows us to replace it for testing
+        if _environ is not None:
+            self._environ = _environ
+
+        self.is_jupyter = _is_jupyter() if force_jupyter is None else force_jupyter
+        if self.is_jupyter:
+            if width is None:
+                jupyter_columns = self._environ.get("JUPYTER_COLUMNS")
+                if jupyter_columns is not None and jupyter_columns.isdigit():
+                    width = int(jupyter_columns)
+                else:
+                    width = JUPYTER_DEFAULT_COLUMNS
+            if height is None:
+                jupyter_lines = self._environ.get("JUPYTER_LINES")
+                if jupyter_lines is not None and jupyter_lines.isdigit():
+                    height = int(jupyter_lines)
+                else:
+                    height = JUPYTER_DEFAULT_LINES
+
+        self.tab_size = tab_size
+        self.record = record
+        self._markup = markup
+        self._emoji = emoji
+        self._emoji_variant: Optional[EmojiVariant] = emoji_variant
+        self._highlight = highlight
+        self.legacy_windows: bool = (
+            (detect_legacy_windows() and not self.is_jupyter)
+            if legacy_windows is None
+            else legacy_windows
+        )
+
+        if width is None:
+            columns = self._environ.get("COLUMNS")
+            if columns is not None and columns.isdigit():
+                width = int(columns) - self.legacy_windows
+        if height is None:
+            lines = self._environ.get("LINES")
+            if lines is not None and lines.isdigit():
+                height = int(lines)
+
+        self.soft_wrap = soft_wrap
+        self._width = width
+        self._height = height
+
+        self._color_system: Optional[ColorSystem]
+
+        self._force_terminal = None
+        if force_terminal is not None:
+            self._force_terminal = force_terminal
+
+        self._file = file
+        self.quiet = quiet
+        self.stderr = stderr
+
+        if color_system is None:
+            self._color_system = None
+        elif color_system == "auto":
+            self._color_system = self._detect_color_system()
+        else:
+            self._color_system = COLOR_SYSTEMS[color_system]
+
+        self._lock = threading.RLock()
+        self._log_render = LogRender(
+            show_time=log_time,
+            show_path=log_path,
+            time_format=log_time_format,
+        )
+        self.highlighter: HighlighterType = highlighter or _null_highlighter
+        self.safe_box = safe_box
+        self.get_datetime = get_datetime or datetime.now
+        self.get_time = get_time or monotonic
+        self.style = style
+        self.no_color = (
+            no_color if no_color is not None else "NO_COLOR" in self._environ
+        )
+        self.is_interactive = (
+            (self.is_terminal and not self.is_dumb_terminal)
+            if force_interactive is None
+            else force_interactive
+        )
+
+        self._record_buffer_lock = threading.RLock()
+        self._thread_locals = ConsoleThreadLocals(
+            theme_stack=ThemeStack(themes.DEFAULT if theme is None else theme)
+        )
+        self._record_buffer: List[Segment] = []
+        self._render_hooks: List[RenderHook] = []
+        self._live: Optional["Live"] = None
+        self._is_alt_screen = False
+
+    def __repr__(self) -> str:
+        return f""
+
+    @property
+    def file(self) -> IO[str]:
+        """Get the file object to write to."""
+        file = self._file or (sys.stderr if self.stderr else sys.stdout)
+        file = getattr(file, "rich_proxied_file", file)
+        if file is None:
+            file = NULL_FILE
+        return file
+
+    @file.setter
+    def file(self, new_file: IO[str]) -> None:
+        """Set a new file object."""
+        self._file = new_file
+
+    @property
+    def _buffer(self) -> List[Segment]:
+        """Get a thread local buffer."""
+        return self._thread_locals.buffer
+
+    @property
+    def _buffer_index(self) -> int:
+        """Get a thread local buffer."""
+        return self._thread_locals.buffer_index
+
+    @_buffer_index.setter
+    def _buffer_index(self, value: int) -> None:
+        self._thread_locals.buffer_index = value
+
+    @property
+    def _theme_stack(self) -> ThemeStack:
+        """Get the thread local theme stack."""
+        return self._thread_locals.theme_stack
+
+    def _detect_color_system(self) -> Optional[ColorSystem]:
+        """Detect color system from env vars."""
+        if self.is_jupyter:
+            return ColorSystem.TRUECOLOR
+        if not self.is_terminal or self.is_dumb_terminal:
+            return None
+        if WINDOWS:  # pragma: no cover
+            if self.legacy_windows:  # pragma: no cover
+                return ColorSystem.WINDOWS
+            windows_console_features = get_windows_console_features()
+            return (
+                ColorSystem.TRUECOLOR
+                if windows_console_features.truecolor
+                else ColorSystem.EIGHT_BIT
+            )
+        else:
+            color_term = self._environ.get("COLORTERM", "").strip().lower()
+            if color_term in ("truecolor", "24bit"):
+                return ColorSystem.TRUECOLOR
+            term = self._environ.get("TERM", "").strip().lower()
+            _term_name, _hyphen, colors = term.rpartition("-")
+            color_system = _TERM_COLORS.get(colors, ColorSystem.STANDARD)
+            return color_system
+
+    def _enter_buffer(self) -> None:
+        """Enter in to a buffer context, and buffer all output."""
+        self._buffer_index += 1
+
+    def _exit_buffer(self) -> None:
+        """Leave buffer context, and render content if required."""
+        self._buffer_index -= 1
+        self._check_buffer()
+
+    def set_live(self, live: "Live") -> None:
+        """Set Live instance. Used by Live context manager.
+
+        Args:
+            live (Live): Live instance using this Console.
+
+        Raises:
+            errors.LiveError: If this Console has a Live context currently active.
+        """
+        with self._lock:
+            if self._live is not None:
+                raise errors.LiveError("Only one live display may be active at once")
+            self._live = live
+
+    def clear_live(self) -> None:
+        """Clear the Live instance."""
+        with self._lock:
+            self._live = None
+
+    def push_render_hook(self, hook: RenderHook) -> None:
+        """Add a new render hook to the stack.
+
+        Args:
+            hook (RenderHook): Render hook instance.
+        """
+        with self._lock:
+            self._render_hooks.append(hook)
+
+    def pop_render_hook(self) -> None:
+        """Pop the last renderhook from the stack."""
+        with self._lock:
+            self._render_hooks.pop()
+
+    def __enter__(self) -> "Console":
+        """Own context manager to enter buffer context."""
+        self._enter_buffer()
+        return self
+
+    def __exit__(self, exc_type: Any, exc_value: Any, traceback: Any) -> None:
+        """Exit buffer context."""
+        self._exit_buffer()
+
+    def begin_capture(self) -> None:
+        """Begin capturing console output. Call :meth:`end_capture` to exit capture mode and return output."""
+        self._enter_buffer()
+
+    def end_capture(self) -> str:
+        """End capture mode and return captured string.
+
+        Returns:
+            str: Console output.
+        """
+        render_result = self._render_buffer(self._buffer)
+        del self._buffer[:]
+        self._exit_buffer()
+        return render_result
+
+    def push_theme(self, theme: Theme, *, inherit: bool = True) -> None:
+        """Push a new theme on to the top of the stack, replacing the styles from the previous theme.
+        Generally speaking, you should call :meth:`~rich.console.Console.use_theme` to get a context manager, rather
+        than calling this method directly.
+
+        Args:
+            theme (Theme): A theme instance.
+            inherit (bool, optional): Inherit existing styles. Defaults to True.
+        """
+        self._theme_stack.push_theme(theme, inherit=inherit)
+
+    def pop_theme(self) -> None:
+        """Remove theme from top of stack, restoring previous theme."""
+        self._theme_stack.pop_theme()
+
+    def use_theme(self, theme: Theme, *, inherit: bool = True) -> ThemeContext:
+        """Use a different theme for the duration of the context manager.
+
+        Args:
+            theme (Theme): Theme instance to user.
+            inherit (bool, optional): Inherit existing console styles. Defaults to True.
+
+        Returns:
+            ThemeContext: [description]
+        """
+        return ThemeContext(self, theme, inherit)
+
+    @property
+    def color_system(self) -> Optional[str]:
+        """Get color system string.
+
+        Returns:
+            Optional[str]: "standard", "256" or "truecolor".
+        """
+
+        if self._color_system is not None:
+            return _COLOR_SYSTEMS_NAMES[self._color_system]
+        else:
+            return None
+
+    @property
+    def encoding(self) -> str:
+        """Get the encoding of the console file, e.g. ``"utf-8"``.
+
+        Returns:
+            str: A standard encoding string.
+        """
+        return (getattr(self.file, "encoding", "utf-8") or "utf-8").lower()
+
+    @property
+    def is_terminal(self) -> bool:
+        """Check if the console is writing to a terminal.
+
+        Returns:
+            bool: True if the console writing to a device capable of
+            understanding terminal codes, otherwise False.
+        """
+        if self._force_terminal is not None:
+            return self._force_terminal
+
+        if hasattr(sys.stdin, "__module__") and sys.stdin.__module__.startswith(
+            "idlelib"
+        ):
+            # Return False for Idle which claims to be a tty but can't handle ansi codes
+            return False
+
+        if self.is_jupyter:
+            # return False for Jupyter, which may have FORCE_COLOR set
+            return False
+
+        # If FORCE_COLOR env var has any value at all, we assume a terminal.
+        force_color = self._environ.get("FORCE_COLOR")
+        if force_color is not None:
+            self._force_terminal = True
+            return True
+
+        isatty: Optional[Callable[[], bool]] = getattr(self.file, "isatty", None)
+        try:
+            return False if isatty is None else isatty()
+        except ValueError:
+            # in some situation (at the end of a pytest run for example) isatty() can raise
+            # ValueError: I/O operation on closed file
+            # return False because we aren't in a terminal anymore
+            return False
+
+    @property
+    def is_dumb_terminal(self) -> bool:
+        """Detect dumb terminal.
+
+        Returns:
+            bool: True if writing to a dumb terminal, otherwise False.
+
+        """
+        _term = self._environ.get("TERM", "")
+        is_dumb = _term.lower() in ("dumb", "unknown")
+        return self.is_terminal and is_dumb
+
+    @property
+    def options(self) -> ConsoleOptions:
+        """Get default console options."""
+        return ConsoleOptions(
+            max_height=self.size.height,
+            size=self.size,
+            legacy_windows=self.legacy_windows,
+            min_width=1,
+            max_width=self.width,
+            encoding=self.encoding,
+            is_terminal=self.is_terminal,
+        )
+
+    @property
+    def size(self) -> ConsoleDimensions:
+        """Get the size of the console.
+
+        Returns:
+            ConsoleDimensions: A named tuple containing the dimensions.
+        """
+
+        if self._width is not None and self._height is not None:
+            return ConsoleDimensions(self._width - self.legacy_windows, self._height)
+
+        if self.is_dumb_terminal:
+            return ConsoleDimensions(80, 25)
+
+        width: Optional[int] = None
+        height: Optional[int] = None
+
+        streams = _STD_STREAMS_OUTPUT if WINDOWS else _STD_STREAMS
+        for file_descriptor in streams:
+            try:
+                width, height = os.get_terminal_size(file_descriptor)
+            except (AttributeError, ValueError, OSError):  # Probably not a terminal
+                pass
+            else:
+                break
+
+        columns = self._environ.get("COLUMNS")
+        if columns is not None and columns.isdigit():
+            width = int(columns)
+        lines = self._environ.get("LINES")
+        if lines is not None and lines.isdigit():
+            height = int(lines)
+
+        # get_terminal_size can report 0, 0 if run from pseudo-terminal
+        width = width or 80
+        height = height or 25
+        return ConsoleDimensions(
+            width - self.legacy_windows if self._width is None else self._width,
+            height if self._height is None else self._height,
+        )
+
+    @size.setter
+    def size(self, new_size: Tuple[int, int]) -> None:
+        """Set a new size for the terminal.
+
+        Args:
+            new_size (Tuple[int, int]): New width and height.
+        """
+        width, height = new_size
+        self._width = width
+        self._height = height
+
+    @property
+    def width(self) -> int:
+        """Get the width of the console.
+
+        Returns:
+            int: The width (in characters) of the console.
+        """
+        return self.size.width
+
+    @width.setter
+    def width(self, width: int) -> None:
+        """Set width.
+
+        Args:
+            width (int): New width.
+        """
+        self._width = width
+
+    @property
+    def height(self) -> int:
+        """Get the height of the console.
+
+        Returns:
+            int: The height (in lines) of the console.
+        """
+        return self.size.height
+
+    @height.setter
+    def height(self, height: int) -> None:
+        """Set height.
+
+        Args:
+            height (int): new height.
+        """
+        self._height = height
+
+    def bell(self) -> None:
+        """Play a 'bell' sound (if supported by the terminal)."""
+        self.control(Control.bell())
+
+    def capture(self) -> Capture:
+        """A context manager to *capture* the result of print() or log() in a string,
+        rather than writing it to the console.
+
+        Example:
+            >>> from rich.console import Console
+            >>> console = Console()
+            >>> with console.capture() as capture:
+            ...     console.print("[bold magenta]Hello World[/]")
+            >>> print(capture.get())
+
+        Returns:
+            Capture: Context manager with disables writing to the terminal.
+        """
+        capture = Capture(self)
+        return capture
+
+    def pager(
+        self, pager: Optional[Pager] = None, styles: bool = False, links: bool = False
+    ) -> PagerContext:
+        """A context manager to display anything printed within a "pager". The pager application
+        is defined by the system and will typically support at least pressing a key to scroll.
+
+        Args:
+            pager (Pager, optional): A pager object, or None to use :class:`~rich.pager.SystemPager`. Defaults to None.
+            styles (bool, optional): Show styles in pager. Defaults to False.
+            links (bool, optional): Show links in pager. Defaults to False.
+
+        Example:
+            >>> from rich.console import Console
+            >>> from rich.__main__ import make_test_card
+            >>> console = Console()
+            >>> with console.pager():
+                    console.print(make_test_card())
+
+        Returns:
+            PagerContext: A context manager.
+        """
+        return PagerContext(self, pager=pager, styles=styles, links=links)
+
+    def line(self, count: int = 1) -> None:
+        """Write new line(s).
+
+        Args:
+            count (int, optional): Number of new lines. Defaults to 1.
+        """
+
+        assert count >= 0, "count must be >= 0"
+        self.print(NewLine(count))
+
+    def clear(self, home: bool = True) -> None:
+        """Clear the screen.
+
+        Args:
+            home (bool, optional): Also move the cursor to 'home' position. Defaults to True.
+        """
+        if home:
+            self.control(Control.clear(), Control.home())
+        else:
+            self.control(Control.clear())
+
+    def status(
+        self,
+        status: RenderableType,
+        *,
+        spinner: str = "dots",
+        spinner_style: StyleType = "status.spinner",
+        speed: float = 1.0,
+        refresh_per_second: float = 12.5,
+    ) -> "Status":
+        """Display a status and spinner.
+
+        Args:
+            status (RenderableType): A status renderable (str or Text typically).
+            spinner (str, optional): Name of spinner animation (see python -m rich.spinner). Defaults to "dots".
+            spinner_style (StyleType, optional): Style of spinner. Defaults to "status.spinner".
+            speed (float, optional): Speed factor for spinner animation. Defaults to 1.0.
+            refresh_per_second (float, optional): Number of refreshes per second. Defaults to 12.5.
+
+        Returns:
+            Status: A Status object that may be used as a context manager.
+        """
+        from .status import Status
+
+        status_renderable = Status(
+            status,
+            console=self,
+            spinner=spinner,
+            spinner_style=spinner_style,
+            speed=speed,
+            refresh_per_second=refresh_per_second,
+        )
+        return status_renderable
+
+    def show_cursor(self, show: bool = True) -> bool:
+        """Show or hide the cursor.
+
+        Args:
+            show (bool, optional): Set visibility of the cursor.
+        """
+        if self.is_terminal:
+            self.control(Control.show_cursor(show))
+            return True
+        return False
+
+    def set_alt_screen(self, enable: bool = True) -> bool:
+        """Enables alternative screen mode.
+
+        Note, if you enable this mode, you should ensure that is disabled before
+        the application exits. See :meth:`~rich.Console.screen` for a context manager
+        that handles this for you.
+
+        Args:
+            enable (bool, optional): Enable (True) or disable (False) alternate screen. Defaults to True.
+
+        Returns:
+            bool: True if the control codes were written.
+
+        """
+        changed = False
+        if self.is_terminal and not self.legacy_windows:
+            self.control(Control.alt_screen(enable))
+            changed = True
+            self._is_alt_screen = enable
+        return changed
+
+    @property
+    def is_alt_screen(self) -> bool:
+        """Check if the alt screen was enabled.
+
+        Returns:
+            bool: True if the alt screen was enabled, otherwise False.
+        """
+        return self._is_alt_screen
+
+    def set_window_title(self, title: str) -> bool:
+        """Set the title of the console terminal window.
+
+        Warning: There is no means within Rich of "resetting" the window title to its
+        previous value, meaning the title you set will persist even after your application
+        exits.
+
+        ``fish`` shell resets the window title before and after each command by default,
+        negating this issue. Windows Terminal and command prompt will also reset the title for you.
+        Most other shells and terminals, however, do not do this.
+
+        Some terminals may require configuration changes before you can set the title.
+        Some terminals may not support setting the title at all.
+
+        Other software (including the terminal itself, the shell, custom prompts, plugins, etc.)
+        may also set the terminal window title. This could result in whatever value you write
+        using this method being overwritten.
+
+        Args:
+            title (str): The new title of the terminal window.
+
+        Returns:
+            bool: True if the control code to change the terminal title was
+                written, otherwise False. Note that a return value of True
+                does not guarantee that the window title has actually changed,
+                since the feature may be unsupported/disabled in some terminals.
+        """
+        if self.is_terminal:
+            self.control(Control.title(title))
+            return True
+        return False
+
+    def screen(
+        self, hide_cursor: bool = True, style: Optional[StyleType] = None
+    ) -> "ScreenContext":
+        """Context manager to enable and disable 'alternative screen' mode.
+
+        Args:
+            hide_cursor (bool, optional): Also hide the cursor. Defaults to False.
+            style (Style, optional): Optional style for screen. Defaults to None.
+
+        Returns:
+            ~ScreenContext: Context which enables alternate screen on enter, and disables it on exit.
+        """
+        return ScreenContext(self, hide_cursor=hide_cursor, style=style or "")
+
+    def measure(
+        self, renderable: RenderableType, *, options: Optional[ConsoleOptions] = None
+    ) -> Measurement:
+        """Measure a renderable. Returns a :class:`~rich.measure.Measurement` object which contains
+        information regarding the number of characters required to print the renderable.
+
+        Args:
+            renderable (RenderableType): Any renderable or string.
+            options (Optional[ConsoleOptions], optional): Options to use when measuring, or None
+                to use default options. Defaults to None.
+
+        Returns:
+            Measurement: A measurement of the renderable.
+        """
+        measurement = Measurement.get(self, options or self.options, renderable)
+        return measurement
+
+    def render(
+        self, renderable: RenderableType, options: Optional[ConsoleOptions] = None
+    ) -> Iterable[Segment]:
+        """Render an object in to an iterable of `Segment` instances.
+
+        This method contains the logic for rendering objects with the console protocol.
+        You are unlikely to need to use it directly, unless you are extending the library.
+
+        Args:
+            renderable (RenderableType): An object supporting the console protocol, or
+                an object that may be converted to a string.
+            options (ConsoleOptions, optional): An options object, or None to use self.options. Defaults to None.
+
+        Returns:
+            Iterable[Segment]: An iterable of segments that may be rendered.
+        """
+
+        _options = options or self.options
+        if _options.max_width < 1:
+            # No space to render anything. This prevents potential recursion errors.
+            return
+        render_iterable: RenderResult
+
+        renderable = rich_cast(renderable)
+        if hasattr(renderable, "__rich_console__") and not isclass(renderable):
+            render_iterable = renderable.__rich_console__(self, _options)
+        elif isinstance(renderable, str):
+            text_renderable = self.render_str(
+                renderable, highlight=_options.highlight, markup=_options.markup
+            )
+            render_iterable = text_renderable.__rich_console__(self, _options)
+        else:
+            raise errors.NotRenderableError(
+                f"Unable to render {renderable!r}; "
+                "A str, Segment or object with __rich_console__ method is required"
+            )
+
+        try:
+            iter_render = iter(render_iterable)
+        except TypeError:
+            raise errors.NotRenderableError(
+                f"object {render_iterable!r} is not renderable"
+            )
+        _Segment = Segment
+        _options = _options.reset_height()
+        for render_output in iter_render:
+            if isinstance(render_output, _Segment):
+                yield render_output
+            else:
+                yield from self.render(render_output, _options)
+
+    def render_lines(
+        self,
+        renderable: RenderableType,
+        options: Optional[ConsoleOptions] = None,
+        *,
+        style: Optional[Style] = None,
+        pad: bool = True,
+        new_lines: bool = False,
+    ) -> List[List[Segment]]:
+        """Render objects in to a list of lines.
+
+        The output of render_lines is useful when further formatting of rendered console text
+        is required, such as the Panel class which draws a border around any renderable object.
+
+        Args:
+            renderable (RenderableType): Any object renderable in the console.
+            options (Optional[ConsoleOptions], optional): Console options, or None to use self.options. Default to ``None``.
+            style (Style, optional): Optional style to apply to renderables. Defaults to ``None``.
+            pad (bool, optional): Pad lines shorter than render width. Defaults to ``True``.
+            new_lines (bool, optional): Include "\n" characters at end of lines.
+
+        Returns:
+            List[List[Segment]]: A list of lines, where a line is a list of Segment objects.
+        """
+        with self._lock:
+            render_options = options or self.options
+            _rendered = self.render(renderable, render_options)
+            if style:
+                _rendered = Segment.apply_style(_rendered, style)
+
+            render_height = render_options.height
+            if render_height is not None:
+                render_height = max(0, render_height)
+
+            lines = list(
+                islice(
+                    Segment.split_and_crop_lines(
+                        _rendered,
+                        render_options.max_width,
+                        include_new_lines=new_lines,
+                        pad=pad,
+                        style=style,
+                    ),
+                    None,
+                    render_height,
+                )
+            )
+            if render_options.height is not None:
+                extra_lines = render_options.height - len(lines)
+                if extra_lines > 0:
+                    pad_line = [
+                        (
+                            [
+                                Segment(" " * render_options.max_width, style),
+                                Segment("\n"),
+                            ]
+                            if new_lines
+                            else [Segment(" " * render_options.max_width, style)]
+                        )
+                    ]
+                    lines.extend(pad_line * extra_lines)
+
+            return lines
+
+    def render_str(
+        self,
+        text: str,
+        *,
+        style: Union[str, Style] = "",
+        justify: Optional[JustifyMethod] = None,
+        overflow: Optional[OverflowMethod] = None,
+        emoji: Optional[bool] = None,
+        markup: Optional[bool] = None,
+        highlight: Optional[bool] = None,
+        highlighter: Optional[HighlighterType] = None,
+    ) -> "Text":
+        """Convert a string to a Text instance. This is called automatically if
+        you print or log a string.
+
+        Args:
+            text (str): Text to render.
+            style (Union[str, Style], optional): Style to apply to rendered text.
+            justify (str, optional): Justify method: "default", "left", "center", "full", or "right". Defaults to ``None``.
+            overflow (str, optional): Overflow method: "crop", "fold", or "ellipsis". Defaults to ``None``.
+            emoji (Optional[bool], optional): Enable emoji, or ``None`` to use Console default.
+            markup (Optional[bool], optional): Enable markup, or ``None`` to use Console default.
+            highlight (Optional[bool], optional): Enable highlighting, or ``None`` to use Console default.
+            highlighter (HighlighterType, optional): Optional highlighter to apply.
+        Returns:
+            ConsoleRenderable: Renderable object.
+
+        """
+        emoji_enabled = emoji or (emoji is None and self._emoji)
+        markup_enabled = markup or (markup is None and self._markup)
+        highlight_enabled = highlight or (highlight is None and self._highlight)
+
+        if markup_enabled:
+            rich_text = render_markup(
+                text,
+                style=style,
+                emoji=emoji_enabled,
+                emoji_variant=self._emoji_variant,
+            )
+            rich_text.justify = justify
+            rich_text.overflow = overflow
+        else:
+            rich_text = Text(
+                (
+                    _emoji_replace(text, default_variant=self._emoji_variant)
+                    if emoji_enabled
+                    else text
+                ),
+                justify=justify,
+                overflow=overflow,
+                style=style,
+            )
+
+        _highlighter = (highlighter or self.highlighter) if highlight_enabled else None
+        if _highlighter is not None:
+            highlight_text = _highlighter(str(rich_text))
+            highlight_text.copy_styles(rich_text)
+            return highlight_text
+
+        return rich_text
+
+    def get_style(
+        self, name: Union[str, Style], *, default: Optional[Union[Style, str]] = None
+    ) -> Style:
+        """Get a Style instance by its theme name or parse a definition.
+
+        Args:
+            name (str): The name of a style or a style definition.
+
+        Returns:
+            Style: A Style object.
+
+        Raises:
+            MissingStyle: If no style could be parsed from name.
+
+        """
+        if isinstance(name, Style):
+            return name
+
+        try:
+            style = self._theme_stack.get(name)
+            if style is None:
+                style = Style.parse(name)
+            return style.copy() if style.link else style
+        except errors.StyleSyntaxError as error:
+            if default is not None:
+                return self.get_style(default)
+            raise errors.MissingStyle(
+                f"Failed to get style {name!r}; {error}"
+            ) from None
+
+    def _collect_renderables(
+        self,
+        objects: Iterable[Any],
+        sep: str,
+        end: str,
+        *,
+        justify: Optional[JustifyMethod] = None,
+        emoji: Optional[bool] = None,
+        markup: Optional[bool] = None,
+        highlight: Optional[bool] = None,
+    ) -> List[ConsoleRenderable]:
+        """Combine a number of renderables and text into one renderable.
+
+        Args:
+            objects (Iterable[Any]): Anything that Rich can render.
+            sep (str): String to write between print data.
+            end (str): String to write at end of print data.
+            justify (str, optional): One of "left", "right", "center", or "full". Defaults to ``None``.
+            emoji (Optional[bool], optional): Enable emoji code, or ``None`` to use console default.
+            markup (Optional[bool], optional): Enable markup, or ``None`` to use console default.
+            highlight (Optional[bool], optional): Enable automatic highlighting, or ``None`` to use console default.
+
+        Returns:
+            List[ConsoleRenderable]: A list of things to render.
+        """
+        renderables: List[ConsoleRenderable] = []
+        _append = renderables.append
+        text: List[Text] = []
+        append_text = text.append
+
+        append = _append
+        if justify in ("left", "center", "right"):
+
+            def align_append(renderable: RenderableType) -> None:
+                _append(Align(renderable, cast(AlignMethod, justify)))
+
+            append = align_append
+
+        _highlighter: HighlighterType = _null_highlighter
+        if highlight or (highlight is None and self._highlight):
+            _highlighter = self.highlighter
+
+        def check_text() -> None:
+            if text:
+                sep_text = Text(sep, justify=justify, end=end)
+                append(sep_text.join(text))
+                text.clear()
+
+        for renderable in objects:
+            renderable = rich_cast(renderable)
+            if isinstance(renderable, str):
+                append_text(
+                    self.render_str(
+                        renderable,
+                        emoji=emoji,
+                        markup=markup,
+                        highlight=highlight,
+                        highlighter=_highlighter,
+                    )
+                )
+            elif isinstance(renderable, Text):
+                append_text(renderable)
+            elif isinstance(renderable, ConsoleRenderable):
+                check_text()
+                append(renderable)
+            elif is_expandable(renderable):
+                check_text()
+                append(Pretty(renderable, highlighter=_highlighter))
+            else:
+                append_text(_highlighter(str(renderable)))
+
+        check_text()
+
+        if self.style is not None:
+            style = self.get_style(self.style)
+            renderables = [Styled(renderable, style) for renderable in renderables]
+
+        return renderables
+
+    def rule(
+        self,
+        title: TextType = "",
+        *,
+        characters: str = "─",
+        style: Union[str, Style] = "rule.line",
+        align: AlignMethod = "center",
+    ) -> None:
+        """Draw a line with optional centered title.
+
+        Args:
+            title (str, optional): Text to render over the rule. Defaults to "".
+            characters (str, optional): Character(s) to form the line. Defaults to "─".
+            style (str, optional): Style of line. Defaults to "rule.line".
+            align (str, optional): How to align the title, one of "left", "center", or "right". Defaults to "center".
+        """
+        from .rule import Rule
+
+        rule = Rule(title=title, characters=characters, style=style, align=align)
+        self.print(rule)
+
+    def control(self, *control: Control) -> None:
+        """Insert non-printing control codes.
+
+        Args:
+            control_codes (str): Control codes, such as those that may move the cursor.
+        """
+        if not self.is_dumb_terminal:
+            with self:
+                self._buffer.extend(_control.segment for _control in control)
+
+    def out(
+        self,
+        *objects: Any,
+        sep: str = " ",
+        end: str = "\n",
+        style: Optional[Union[str, Style]] = None,
+        highlight: Optional[bool] = None,
+    ) -> None:
+        """Output to the terminal. This is a low-level way of writing to the terminal which unlike
+        :meth:`~rich.console.Console.print` won't pretty print, wrap text, or apply markup, but will
+        optionally apply highlighting and a basic style.
+
+        Args:
+            sep (str, optional): String to write between print data. Defaults to " ".
+            end (str, optional): String to write at end of print data. Defaults to "\\\\n".
+            style (Union[str, Style], optional): A style to apply to output. Defaults to None.
+            highlight (Optional[bool], optional): Enable automatic highlighting, or ``None`` to use
+                console default. Defaults to ``None``.
+        """
+        raw_output: str = sep.join(str(_object) for _object in objects)
+        self.print(
+            raw_output,
+            style=style,
+            highlight=highlight,
+            emoji=False,
+            markup=False,
+            no_wrap=True,
+            overflow="ignore",
+            crop=False,
+            end=end,
+        )
+
+    def print(
+        self,
+        *objects: Any,
+        sep: str = " ",
+        end: str = "\n",
+        style: Optional[Union[str, Style]] = None,
+        justify: Optional[JustifyMethod] = None,
+        overflow: Optional[OverflowMethod] = None,
+        no_wrap: Optional[bool] = None,
+        emoji: Optional[bool] = None,
+        markup: Optional[bool] = None,
+        highlight: Optional[bool] = None,
+        width: Optional[int] = None,
+        height: Optional[int] = None,
+        crop: bool = True,
+        soft_wrap: Optional[bool] = None,
+        new_line_start: bool = False,
+    ) -> None:
+        """Print to the console.
+
+        Args:
+            objects (positional args): Objects to log to the terminal.
+            sep (str, optional): String to write between print data. Defaults to " ".
+            end (str, optional): String to write at end of print data. Defaults to "\\\\n".
+            style (Union[str, Style], optional): A style to apply to output. Defaults to None.
+            justify (str, optional): Justify method: "default", "left", "right", "center", or "full". Defaults to ``None``.
+            overflow (str, optional): Overflow method: "ignore", "crop", "fold", or "ellipsis". Defaults to None.
+            no_wrap (Optional[bool], optional): Disable word wrapping. Defaults to None.
+            emoji (Optional[bool], optional): Enable emoji code, or ``None`` to use console default. Defaults to ``None``.
+            markup (Optional[bool], optional): Enable markup, or ``None`` to use console default. Defaults to ``None``.
+            highlight (Optional[bool], optional): Enable automatic highlighting, or ``None`` to use console default. Defaults to ``None``.
+            width (Optional[int], optional): Width of output, or ``None`` to auto-detect. Defaults to ``None``.
+            crop (Optional[bool], optional): Crop output to width of terminal. Defaults to True.
+            soft_wrap (bool, optional): Enable soft wrap mode which disables word wrapping and cropping of text or ``None`` for
+                Console default. Defaults to ``None``.
+            new_line_start (bool, False): Insert a new line at the start if the output contains more than one line. Defaults to ``False``.
+        """
+        if not objects:
+            objects = (NewLine(),)
+
+        if soft_wrap is None:
+            soft_wrap = self.soft_wrap
+        if soft_wrap:
+            if no_wrap is None:
+                no_wrap = True
+            if overflow is None:
+                overflow = "ignore"
+            crop = False
+        render_hooks = self._render_hooks[:]
+        with self:
+            renderables = self._collect_renderables(
+                objects,
+                sep,
+                end,
+                justify=justify,
+                emoji=emoji,
+                markup=markup,
+                highlight=highlight,
+            )
+            for hook in render_hooks:
+                renderables = hook.process_renderables(renderables)
+            render_options = self.options.update(
+                justify=justify,
+                overflow=overflow,
+                width=min(width, self.width) if width is not None else NO_CHANGE,
+                height=height,
+                no_wrap=no_wrap,
+                markup=markup,
+                highlight=highlight,
+            )
+
+            new_segments: List[Segment] = []
+            extend = new_segments.extend
+            render = self.render
+            if style is None:
+                for renderable in renderables:
+                    extend(render(renderable, render_options))
+            else:
+                for renderable in renderables:
+                    extend(
+                        Segment.apply_style(
+                            render(renderable, render_options), self.get_style(style)
+                        )
+                    )
+            if new_line_start:
+                if (
+                    len("".join(segment.text for segment in new_segments).splitlines())
+                    > 1
+                ):
+                    new_segments.insert(0, Segment.line())
+            if crop:
+                buffer_extend = self._buffer.extend
+                for line in Segment.split_and_crop_lines(
+                    new_segments, self.width, pad=False
+                ):
+                    buffer_extend(line)
+            else:
+                self._buffer.extend(new_segments)
+
+    def print_json(
+        self,
+        json: Optional[str] = None,
+        *,
+        data: Any = None,
+        indent: Union[None, int, str] = 2,
+        highlight: bool = True,
+        skip_keys: bool = False,
+        ensure_ascii: bool = False,
+        check_circular: bool = True,
+        allow_nan: bool = True,
+        default: Optional[Callable[[Any], Any]] = None,
+        sort_keys: bool = False,
+    ) -> None:
+        """Pretty prints JSON. Output will be valid JSON.
+
+        Args:
+            json (Optional[str]): A string containing JSON.
+            data (Any): If json is not supplied, then encode this data.
+            indent (Union[None, int, str], optional): Number of spaces to indent. Defaults to 2.
+            highlight (bool, optional): Enable highlighting of output: Defaults to True.
+            skip_keys (bool, optional): Skip keys not of a basic type. Defaults to False.
+            ensure_ascii (bool, optional): Escape all non-ascii characters. Defaults to False.
+            check_circular (bool, optional): Check for circular references. Defaults to True.
+            allow_nan (bool, optional): Allow NaN and Infinity values. Defaults to True.
+            default (Callable, optional): A callable that converts values that can not be encoded
+                in to something that can be JSON encoded. Defaults to None.
+            sort_keys (bool, optional): Sort dictionary keys. Defaults to False.
+        """
+        from pip._vendor.rich.json import JSON
+
+        if json is None:
+            json_renderable = JSON.from_data(
+                data,
+                indent=indent,
+                highlight=highlight,
+                skip_keys=skip_keys,
+                ensure_ascii=ensure_ascii,
+                check_circular=check_circular,
+                allow_nan=allow_nan,
+                default=default,
+                sort_keys=sort_keys,
+            )
+        else:
+            if not isinstance(json, str):
+                raise TypeError(
+                    f"json must be str. Did you mean print_json(data={json!r}) ?"
+                )
+            json_renderable = JSON(
+                json,
+                indent=indent,
+                highlight=highlight,
+                skip_keys=skip_keys,
+                ensure_ascii=ensure_ascii,
+                check_circular=check_circular,
+                allow_nan=allow_nan,
+                default=default,
+                sort_keys=sort_keys,
+            )
+        self.print(json_renderable, soft_wrap=True)
+
+    def update_screen(
+        self,
+        renderable: RenderableType,
+        *,
+        region: Optional[Region] = None,
+        options: Optional[ConsoleOptions] = None,
+    ) -> None:
+        """Update the screen at a given offset.
+
+        Args:
+            renderable (RenderableType): A Rich renderable.
+            region (Region, optional): Region of screen to update, or None for entire screen. Defaults to None.
+            x (int, optional): x offset. Defaults to 0.
+            y (int, optional): y offset. Defaults to 0.
+
+        Raises:
+            errors.NoAltScreen: If the Console isn't in alt screen mode.
+
+        """
+        if not self.is_alt_screen:
+            raise errors.NoAltScreen("Alt screen must be enabled to call update_screen")
+        render_options = options or self.options
+        if region is None:
+            x = y = 0
+            render_options = render_options.update_dimensions(
+                render_options.max_width, render_options.height or self.height
+            )
+        else:
+            x, y, width, height = region
+            render_options = render_options.update_dimensions(width, height)
+
+        lines = self.render_lines(renderable, options=render_options)
+        self.update_screen_lines(lines, x, y)
+
+    def update_screen_lines(
+        self, lines: List[List[Segment]], x: int = 0, y: int = 0
+    ) -> None:
+        """Update lines of the screen at a given offset.
+
+        Args:
+            lines (List[List[Segment]]): Rendered lines (as produced by :meth:`~rich.Console.render_lines`).
+            x (int, optional): x offset (column no). Defaults to 0.
+            y (int, optional): y offset (column no). Defaults to 0.
+
+        Raises:
+            errors.NoAltScreen: If the Console isn't in alt screen mode.
+        """
+        if not self.is_alt_screen:
+            raise errors.NoAltScreen("Alt screen must be enabled to call update_screen")
+        screen_update = ScreenUpdate(lines, x, y)
+        segments = self.render(screen_update)
+        self._buffer.extend(segments)
+        self._check_buffer()
+
+    def print_exception(
+        self,
+        *,
+        width: Optional[int] = 100,
+        extra_lines: int = 3,
+        theme: Optional[str] = None,
+        word_wrap: bool = False,
+        show_locals: bool = False,
+        suppress: Iterable[Union[str, ModuleType]] = (),
+        max_frames: int = 100,
+    ) -> None:
+        """Prints a rich render of the last exception and traceback.
+
+        Args:
+            width (Optional[int], optional): Number of characters used to render code. Defaults to 100.
+            extra_lines (int, optional): Additional lines of code to render. Defaults to 3.
+            theme (str, optional): Override pygments theme used in traceback
+            word_wrap (bool, optional): Enable word wrapping of long lines. Defaults to False.
+            show_locals (bool, optional): Enable display of local variables. Defaults to False.
+            suppress (Iterable[Union[str, ModuleType]]): Optional sequence of modules or paths to exclude from traceback.
+            max_frames (int): Maximum number of frames to show in a traceback, 0 for no maximum. Defaults to 100.
+        """
+        from .traceback import Traceback
+
+        traceback = Traceback(
+            width=width,
+            extra_lines=extra_lines,
+            theme=theme,
+            word_wrap=word_wrap,
+            show_locals=show_locals,
+            suppress=suppress,
+            max_frames=max_frames,
+        )
+        self.print(traceback)
+
+    @staticmethod
+    def _caller_frame_info(
+        offset: int,
+        currentframe: Callable[[], Optional[FrameType]] = inspect.currentframe,
+    ) -> Tuple[str, int, Dict[str, Any]]:
+        """Get caller frame information.
+
+        Args:
+            offset (int): the caller offset within the current frame stack.
+            currentframe (Callable[[], Optional[FrameType]], optional): the callable to use to
+                retrieve the current frame. Defaults to ``inspect.currentframe``.
+
+        Returns:
+            Tuple[str, int, Dict[str, Any]]: A tuple containing the filename, the line number and
+                the dictionary of local variables associated with the caller frame.
+
+        Raises:
+            RuntimeError: If the stack offset is invalid.
+        """
+        # Ignore the frame of this local helper
+        offset += 1
+
+        frame = currentframe()
+        if frame is not None:
+            # Use the faster currentframe where implemented
+            while offset and frame is not None:
+                frame = frame.f_back
+                offset -= 1
+            assert frame is not None
+            return frame.f_code.co_filename, frame.f_lineno, frame.f_locals
+        else:
+            # Fallback to the slower stack
+            frame_info = inspect.stack()[offset]
+            return frame_info.filename, frame_info.lineno, frame_info.frame.f_locals
+
+    def log(
+        self,
+        *objects: Any,
+        sep: str = " ",
+        end: str = "\n",
+        style: Optional[Union[str, Style]] = None,
+        justify: Optional[JustifyMethod] = None,
+        emoji: Optional[bool] = None,
+        markup: Optional[bool] = None,
+        highlight: Optional[bool] = None,
+        log_locals: bool = False,
+        _stack_offset: int = 1,
+    ) -> None:
+        """Log rich content to the terminal.
+
+        Args:
+            objects (positional args): Objects to log to the terminal.
+            sep (str, optional): String to write between print data. Defaults to " ".
+            end (str, optional): String to write at end of print data. Defaults to "\\\\n".
+            style (Union[str, Style], optional): A style to apply to output. Defaults to None.
+            justify (str, optional): One of "left", "right", "center", or "full". Defaults to ``None``.
+            emoji (Optional[bool], optional): Enable emoji code, or ``None`` to use console default. Defaults to None.
+            markup (Optional[bool], optional): Enable markup, or ``None`` to use console default. Defaults to None.
+            highlight (Optional[bool], optional): Enable automatic highlighting, or ``None`` to use console default. Defaults to None.
+            log_locals (bool, optional): Boolean to enable logging of locals where ``log()``
+                was called. Defaults to False.
+            _stack_offset (int, optional): Offset of caller from end of call stack. Defaults to 1.
+        """
+        if not objects:
+            objects = (NewLine(),)
+
+        render_hooks = self._render_hooks[:]
+
+        with self:
+            renderables = self._collect_renderables(
+                objects,
+                sep,
+                end,
+                justify=justify,
+                emoji=emoji,
+                markup=markup,
+                highlight=highlight,
+            )
+            if style is not None:
+                renderables = [Styled(renderable, style) for renderable in renderables]
+
+            filename, line_no, locals = self._caller_frame_info(_stack_offset)
+            link_path = None if filename.startswith("<") else os.path.abspath(filename)
+            path = filename.rpartition(os.sep)[-1]
+            if log_locals:
+                locals_map = {
+                    key: value
+                    for key, value in locals.items()
+                    if not key.startswith("__")
+                }
+                renderables.append(render_scope(locals_map, title="[i]locals"))
+
+            renderables = [
+                self._log_render(
+                    self,
+                    renderables,
+                    log_time=self.get_datetime(),
+                    path=path,
+                    line_no=line_no,
+                    link_path=link_path,
+                )
+            ]
+            for hook in render_hooks:
+                renderables = hook.process_renderables(renderables)
+            new_segments: List[Segment] = []
+            extend = new_segments.extend
+            render = self.render
+            render_options = self.options
+            for renderable in renderables:
+                extend(render(renderable, render_options))
+            buffer_extend = self._buffer.extend
+            for line in Segment.split_and_crop_lines(
+                new_segments, self.width, pad=False
+            ):
+                buffer_extend(line)
+
+    def on_broken_pipe(self) -> None:
+        """This function is called when a `BrokenPipeError` is raised.
+
+        This can occur when piping Textual output in Linux and macOS.
+        The default implementation is to exit the app, but you could implement
+        this method in a subclass to change the behavior.
+
+        See https://docs.python.org/3/library/signal.html#note-on-sigpipe for details.
+        """
+        self.quiet = True
+        devnull = os.open(os.devnull, os.O_WRONLY)
+        os.dup2(devnull, sys.stdout.fileno())
+        raise SystemExit(1)
+
+    def _check_buffer(self) -> None:
+        """Check if the buffer may be rendered. Render it if it can (e.g. Console.quiet is False)
+        Rendering is supported on Windows, Unix and Jupyter environments. For
+        legacy Windows consoles, the win32 API is called directly.
+        This method will also record what it renders if recording is enabled via Console.record.
+        """
+        if self.quiet:
+            del self._buffer[:]
+            return
+
+        try:
+            self._write_buffer()
+        except BrokenPipeError:
+            self.on_broken_pipe()
+
+    def _write_buffer(self) -> None:
+        """Write the buffer to the output file."""
+
+        with self._lock:
+            if self.record and not self._buffer_index:
+                with self._record_buffer_lock:
+                    self._record_buffer.extend(self._buffer[:])
+
+            if self._buffer_index == 0:
+                if self.is_jupyter:  # pragma: no cover
+                    from .jupyter import display
+
+                    display(self._buffer, self._render_buffer(self._buffer[:]))
+                    del self._buffer[:]
+                else:
+                    if WINDOWS:
+                        use_legacy_windows_render = False
+                        if self.legacy_windows:
+                            fileno = get_fileno(self.file)
+                            if fileno is not None:
+                                use_legacy_windows_render = (
+                                    fileno in _STD_STREAMS_OUTPUT
+                                )
+
+                        if use_legacy_windows_render:
+                            from pip._vendor.rich._win32_console import LegacyWindowsTerm
+                            from pip._vendor.rich._windows_renderer import legacy_windows_render
+
+                            buffer = self._buffer[:]
+                            if self.no_color and self._color_system:
+                                buffer = list(Segment.remove_color(buffer))
+
+                            legacy_windows_render(buffer, LegacyWindowsTerm(self.file))
+                        else:
+                            # Either a non-std stream on legacy Windows, or modern Windows.
+                            text = self._render_buffer(self._buffer[:])
+                            # https://bugs.python.org/issue37871
+                            # https://github.com/python/cpython/issues/82052
+                            # We need to avoid writing more than 32Kb in a single write, due to the above bug
+                            write = self.file.write
+                            # Worse case scenario, every character is 4 bytes of utf-8
+                            MAX_WRITE = 32 * 1024 // 4
+                            try:
+                                if len(text) <= MAX_WRITE:
+                                    write(text)
+                                else:
+                                    batch: List[str] = []
+                                    batch_append = batch.append
+                                    size = 0
+                                    for line in text.splitlines(True):
+                                        if size + len(line) > MAX_WRITE and batch:
+                                            write("".join(batch))
+                                            batch.clear()
+                                            size = 0
+                                        batch_append(line)
+                                        size += len(line)
+                                    if batch:
+                                        write("".join(batch))
+                                        batch.clear()
+                            except UnicodeEncodeError as error:
+                                error.reason = f"{error.reason}\n*** You may need to add PYTHONIOENCODING=utf-8 to your environment ***"
+                                raise
+                    else:
+                        text = self._render_buffer(self._buffer[:])
+                        try:
+                            self.file.write(text)
+                        except UnicodeEncodeError as error:
+                            error.reason = f"{error.reason}\n*** You may need to add PYTHONIOENCODING=utf-8 to your environment ***"
+                            raise
+
+                    self.file.flush()
+                    del self._buffer[:]
+
+    def _render_buffer(self, buffer: Iterable[Segment]) -> str:
+        """Render buffered output, and clear buffer."""
+        output: List[str] = []
+        append = output.append
+        color_system = self._color_system
+        legacy_windows = self.legacy_windows
+        not_terminal = not self.is_terminal
+        if self.no_color and color_system:
+            buffer = Segment.remove_color(buffer)
+        for text, style, control in buffer:
+            if style:
+                append(
+                    style.render(
+                        text,
+                        color_system=color_system,
+                        legacy_windows=legacy_windows,
+                    )
+                )
+            elif not (not_terminal and control):
+                append(text)
+
+        rendered = "".join(output)
+        return rendered
+
+    def input(
+        self,
+        prompt: TextType = "",
+        *,
+        markup: bool = True,
+        emoji: bool = True,
+        password: bool = False,
+        stream: Optional[TextIO] = None,
+    ) -> str:
+        """Displays a prompt and waits for input from the user. The prompt may contain color / style.
+
+        It works in the same way as Python's builtin :func:`input` function and provides elaborate line editing and history features if Python's builtin :mod:`readline` module is previously loaded.
+
+        Args:
+            prompt (Union[str, Text]): Text to render in the prompt.
+            markup (bool, optional): Enable console markup (requires a str prompt). Defaults to True.
+            emoji (bool, optional): Enable emoji (requires a str prompt). Defaults to True.
+            password: (bool, optional): Hide typed text. Defaults to False.
+            stream: (TextIO, optional): Optional file to read input from (rather than stdin). Defaults to None.
+
+        Returns:
+            str: Text read from stdin.
+        """
+        if prompt:
+            self.print(prompt, markup=markup, emoji=emoji, end="")
+        if password:
+            result = getpass("", stream=stream)
+        else:
+            if stream:
+                result = stream.readline()
+            else:
+                result = input()
+        return result
+
+    def export_text(self, *, clear: bool = True, styles: bool = False) -> str:
+        """Generate text from console contents (requires record=True argument in constructor).
+
+        Args:
+            clear (bool, optional): Clear record buffer after exporting. Defaults to ``True``.
+            styles (bool, optional): If ``True``, ansi escape codes will be included. ``False`` for plain text.
+                Defaults to ``False``.
+
+        Returns:
+            str: String containing console contents.
+
+        """
+        assert (
+            self.record
+        ), "To export console contents set record=True in the constructor or instance"
+
+        with self._record_buffer_lock:
+            if styles:
+                text = "".join(
+                    (style.render(text) if style else text)
+                    for text, style, _ in self._record_buffer
+                )
+            else:
+                text = "".join(
+                    segment.text
+                    for segment in self._record_buffer
+                    if not segment.control
+                )
+            if clear:
+                del self._record_buffer[:]
+        return text
+
+    def save_text(self, path: str, *, clear: bool = True, styles: bool = False) -> None:
+        """Generate text from console and save to a given location (requires record=True argument in constructor).
+
+        Args:
+            path (str): Path to write text files.
+            clear (bool, optional): Clear record buffer after exporting. Defaults to ``True``.
+            styles (bool, optional): If ``True``, ansi style codes will be included. ``False`` for plain text.
+                Defaults to ``False``.
+
+        """
+        text = self.export_text(clear=clear, styles=styles)
+        with open(path, "w", encoding="utf-8") as write_file:
+            write_file.write(text)
+
+    def export_html(
+        self,
+        *,
+        theme: Optional[TerminalTheme] = None,
+        clear: bool = True,
+        code_format: Optional[str] = None,
+        inline_styles: bool = False,
+    ) -> str:
+        """Generate HTML from console contents (requires record=True argument in constructor).
+
+        Args:
+            theme (TerminalTheme, optional): TerminalTheme object containing console colors.
+            clear (bool, optional): Clear record buffer after exporting. Defaults to ``True``.
+            code_format (str, optional): Format string to render HTML. In addition to '{foreground}',
+                '{background}', and '{code}', should contain '{stylesheet}' if inline_styles is ``False``.
+            inline_styles (bool, optional): If ``True`` styles will be inlined in to spans, which makes files
+                larger but easier to cut and paste markup. If ``False``, styles will be embedded in a style tag.
+                Defaults to False.
+
+        Returns:
+            str: String containing console contents as HTML.
+        """
+        assert (
+            self.record
+        ), "To export console contents set record=True in the constructor or instance"
+        fragments: List[str] = []
+        append = fragments.append
+        _theme = theme or DEFAULT_TERMINAL_THEME
+        stylesheet = ""
+
+        render_code_format = CONSOLE_HTML_FORMAT if code_format is None else code_format
+
+        with self._record_buffer_lock:
+            if inline_styles:
+                for text, style, _ in Segment.filter_control(
+                    Segment.simplify(self._record_buffer)
+                ):
+                    text = escape(text)
+                    if style:
+                        rule = style.get_html_style(_theme)
+                        if style.link:
+                            text = f'{text}'
+                        text = f'{text}' if rule else text
+                    append(text)
+            else:
+                styles: Dict[str, int] = {}
+                for text, style, _ in Segment.filter_control(
+                    Segment.simplify(self._record_buffer)
+                ):
+                    text = escape(text)
+                    if style:
+                        rule = style.get_html_style(_theme)
+                        style_number = styles.setdefault(rule, len(styles) + 1)
+                        if style.link:
+                            text = f'{text}'
+                        else:
+                            text = f'{text}'
+                    append(text)
+                stylesheet_rules: List[str] = []
+                stylesheet_append = stylesheet_rules.append
+                for style_rule, style_number in styles.items():
+                    if style_rule:
+                        stylesheet_append(f".r{style_number} {{{style_rule}}}")
+                stylesheet = "\n".join(stylesheet_rules)
+
+            rendered_code = render_code_format.format(
+                code="".join(fragments),
+                stylesheet=stylesheet,
+                foreground=_theme.foreground_color.hex,
+                background=_theme.background_color.hex,
+            )
+            if clear:
+                del self._record_buffer[:]
+        return rendered_code
+
+    def save_html(
+        self,
+        path: str,
+        *,
+        theme: Optional[TerminalTheme] = None,
+        clear: bool = True,
+        code_format: str = CONSOLE_HTML_FORMAT,
+        inline_styles: bool = False,
+    ) -> None:
+        """Generate HTML from console contents and write to a file (requires record=True argument in constructor).
+
+        Args:
+            path (str): Path to write html file.
+            theme (TerminalTheme, optional): TerminalTheme object containing console colors.
+            clear (bool, optional): Clear record buffer after exporting. Defaults to ``True``.
+            code_format (str, optional): Format string to render HTML. In addition to '{foreground}',
+                '{background}', and '{code}', should contain '{stylesheet}' if inline_styles is ``False``.
+            inline_styles (bool, optional): If ``True`` styles will be inlined in to spans, which makes files
+                larger but easier to cut and paste markup. If ``False``, styles will be embedded in a style tag.
+                Defaults to False.
+
+        """
+        html = self.export_html(
+            theme=theme,
+            clear=clear,
+            code_format=code_format,
+            inline_styles=inline_styles,
+        )
+        with open(path, "w", encoding="utf-8") as write_file:
+            write_file.write(html)
+
+    def export_svg(
+        self,
+        *,
+        title: str = "Rich",
+        theme: Optional[TerminalTheme] = None,
+        clear: bool = True,
+        code_format: str = CONSOLE_SVG_FORMAT,
+        font_aspect_ratio: float = 0.61,
+        unique_id: Optional[str] = None,
+    ) -> str:
+        """
+        Generate an SVG from the console contents (requires record=True in Console constructor).
+
+        Args:
+            title (str, optional): The title of the tab in the output image
+            theme (TerminalTheme, optional): The ``TerminalTheme`` object to use to style the terminal
+            clear (bool, optional): Clear record buffer after exporting. Defaults to ``True``
+            code_format (str, optional): Format string used to generate the SVG. Rich will inject a number of variables
+                into the string in order to form the final SVG output. The default template used and the variables
+                injected by Rich can be found by inspecting the ``console.CONSOLE_SVG_FORMAT`` variable.
+            font_aspect_ratio (float, optional): The width to height ratio of the font used in the ``code_format``
+                string. Defaults to 0.61, which is the width to height ratio of Fira Code (the default font).
+                If you aren't specifying a different font inside ``code_format``, you probably don't need this.
+            unique_id (str, optional): unique id that is used as the prefix for various elements (CSS styles, node
+                ids). If not set, this defaults to a computed value based on the recorded content.
+        """
+
+        from pip._vendor.rich.cells import cell_len
+
+        style_cache: Dict[Style, str] = {}
+
+        def get_svg_style(style: Style) -> str:
+            """Convert a Style to CSS rules for SVG."""
+            if style in style_cache:
+                return style_cache[style]
+            css_rules = []
+            color = (
+                _theme.foreground_color
+                if (style.color is None or style.color.is_default)
+                else style.color.get_truecolor(_theme)
+            )
+            bgcolor = (
+                _theme.background_color
+                if (style.bgcolor is None or style.bgcolor.is_default)
+                else style.bgcolor.get_truecolor(_theme)
+            )
+            if style.reverse:
+                color, bgcolor = bgcolor, color
+            if style.dim:
+                color = blend_rgb(color, bgcolor, 0.4)
+            css_rules.append(f"fill: {color.hex}")
+            if style.bold:
+                css_rules.append("font-weight: bold")
+            if style.italic:
+                css_rules.append("font-style: italic;")
+            if style.underline:
+                css_rules.append("text-decoration: underline;")
+            if style.strike:
+                css_rules.append("text-decoration: line-through;")
+
+            css = ";".join(css_rules)
+            style_cache[style] = css
+            return css
+
+        _theme = theme or SVG_EXPORT_THEME
+
+        width = self.width
+        char_height = 20
+        char_width = char_height * font_aspect_ratio
+        line_height = char_height * 1.22
+
+        margin_top = 1
+        margin_right = 1
+        margin_bottom = 1
+        margin_left = 1
+
+        padding_top = 40
+        padding_right = 8
+        padding_bottom = 8
+        padding_left = 8
+
+        padding_width = padding_left + padding_right
+        padding_height = padding_top + padding_bottom
+        margin_width = margin_left + margin_right
+        margin_height = margin_top + margin_bottom
+
+        text_backgrounds: List[str] = []
+        text_group: List[str] = []
+        classes: Dict[str, int] = {}
+        style_no = 1
+
+        def escape_text(text: str) -> str:
+            """HTML escape text and replace spaces with nbsp."""
+            return escape(text).replace(" ", " ")
+
+        def make_tag(
+            name: str, content: Optional[str] = None, **attribs: object
+        ) -> str:
+            """Make a tag from name, content, and attributes."""
+
+            def stringify(value: object) -> str:
+                if isinstance(value, (float)):
+                    return format(value, "g")
+                return str(value)
+
+            tag_attribs = " ".join(
+                f'{k.lstrip("_").replace("_", "-")}="{stringify(v)}"'
+                for k, v in attribs.items()
+            )
+            return (
+                f"<{name} {tag_attribs}>{content}"
+                if content
+                else f"<{name} {tag_attribs}/>"
+            )
+
+        with self._record_buffer_lock:
+            segments = list(Segment.filter_control(self._record_buffer))
+            if clear:
+                self._record_buffer.clear()
+
+        if unique_id is None:
+            unique_id = "terminal-" + str(
+                zlib.adler32(
+                    ("".join(repr(segment) for segment in segments)).encode(
+                        "utf-8",
+                        "ignore",
+                    )
+                    + title.encode("utf-8", "ignore")
+                )
+            )
+        y = 0
+        for y, line in enumerate(Segment.split_and_crop_lines(segments, length=width)):
+            x = 0
+            for text, style, _control in line:
+                style = style or Style()
+                rules = get_svg_style(style)
+                if rules not in classes:
+                    classes[rules] = style_no
+                    style_no += 1
+                class_name = f"r{classes[rules]}"
+
+                if style.reverse:
+                    has_background = True
+                    background = (
+                        _theme.foreground_color.hex
+                        if style.color is None
+                        else style.color.get_truecolor(_theme).hex
+                    )
+                else:
+                    bgcolor = style.bgcolor
+                    has_background = bgcolor is not None and not bgcolor.is_default
+                    background = (
+                        _theme.background_color.hex
+                        if style.bgcolor is None
+                        else style.bgcolor.get_truecolor(_theme).hex
+                    )
+
+                text_length = cell_len(text)
+                if has_background:
+                    text_backgrounds.append(
+                        make_tag(
+                            "rect",
+                            fill=background,
+                            x=x * char_width,
+                            y=y * line_height + 1.5,
+                            width=char_width * text_length,
+                            height=line_height + 0.25,
+                            shape_rendering="crispEdges",
+                        )
+                    )
+
+                if text != " " * len(text):
+                    text_group.append(
+                        make_tag(
+                            "text",
+                            escape_text(text),
+                            _class=f"{unique_id}-{class_name}",
+                            x=x * char_width,
+                            y=y * line_height + char_height,
+                            textLength=char_width * len(text),
+                            clip_path=f"url(#{unique_id}-line-{y})",
+                        )
+                    )
+                x += cell_len(text)
+
+        line_offsets = [line_no * line_height + 1.5 for line_no in range(y)]
+        lines = "\n".join(
+            f"""
+    {make_tag("rect", x=0, y=offset, width=char_width * width, height=line_height + 0.25)}
+            """
+            for line_no, offset in enumerate(line_offsets)
+        )
+
+        styles = "\n".join(
+            f".{unique_id}-r{rule_no} {{ {css} }}" for css, rule_no in classes.items()
+        )
+        backgrounds = "".join(text_backgrounds)
+        matrix = "".join(text_group)
+
+        terminal_width = ceil(width * char_width + padding_width)
+        terminal_height = (y + 1) * line_height + padding_height
+        chrome = make_tag(
+            "rect",
+            fill=_theme.background_color.hex,
+            stroke="rgba(255,255,255,0.35)",
+            stroke_width="1",
+            x=margin_left,
+            y=margin_top,
+            width=terminal_width,
+            height=terminal_height,
+            rx=8,
+        )
+
+        title_color = _theme.foreground_color.hex
+        if title:
+            chrome += make_tag(
+                "text",
+                escape_text(title),
+                _class=f"{unique_id}-title",
+                fill=title_color,
+                text_anchor="middle",
+                x=terminal_width // 2,
+                y=margin_top + char_height + 6,
+            )
+        chrome += f"""
+            
+            
+            
+            
+            
+        """
+
+        svg = code_format.format(
+            unique_id=unique_id,
+            char_width=char_width,
+            char_height=char_height,
+            line_height=line_height,
+            terminal_width=char_width * width - 1,
+            terminal_height=(y + 1) * line_height - 1,
+            width=terminal_width + margin_width,
+            height=terminal_height + margin_height,
+            terminal_x=margin_left + padding_left,
+            terminal_y=margin_top + padding_top,
+            styles=styles,
+            chrome=chrome,
+            backgrounds=backgrounds,
+            matrix=matrix,
+            lines=lines,
+        )
+        return svg
+
+    def save_svg(
+        self,
+        path: str,
+        *,
+        title: str = "Rich",
+        theme: Optional[TerminalTheme] = None,
+        clear: bool = True,
+        code_format: str = CONSOLE_SVG_FORMAT,
+        font_aspect_ratio: float = 0.61,
+        unique_id: Optional[str] = None,
+    ) -> None:
+        """Generate an SVG file from the console contents (requires record=True in Console constructor).
+
+        Args:
+            path (str): The path to write the SVG to.
+            title (str, optional): The title of the tab in the output image
+            theme (TerminalTheme, optional): The ``TerminalTheme`` object to use to style the terminal
+            clear (bool, optional): Clear record buffer after exporting. Defaults to ``True``
+            code_format (str, optional): Format string used to generate the SVG. Rich will inject a number of variables
+                into the string in order to form the final SVG output. The default template used and the variables
+                injected by Rich can be found by inspecting the ``console.CONSOLE_SVG_FORMAT`` variable.
+            font_aspect_ratio (float, optional): The width to height ratio of the font used in the ``code_format``
+                string. Defaults to 0.61, which is the width to height ratio of Fira Code (the default font).
+                If you aren't specifying a different font inside ``code_format``, you probably don't need this.
+            unique_id (str, optional): unique id that is used as the prefix for various elements (CSS styles, node
+                ids). If not set, this defaults to a computed value based on the recorded content.
+        """
+        svg = self.export_svg(
+            title=title,
+            theme=theme,
+            clear=clear,
+            code_format=code_format,
+            font_aspect_ratio=font_aspect_ratio,
+            unique_id=unique_id,
+        )
+        with open(path, "w", encoding="utf-8") as write_file:
+            write_file.write(svg)
+
+
+def _svg_hash(svg_main_code: str) -> str:
+    """Returns a unique hash for the given SVG main code.
+
+    Args:
+        svg_main_code (str): The content we're going to inject in the SVG envelope.
+
+    Returns:
+        str: a hash of the given content
+    """
+    return str(zlib.adler32(svg_main_code.encode()))
+
+
+if __name__ == "__main__":  # pragma: no cover
+    console = Console(record=True)
+
+    console.log(
+        "JSONRPC [i]request[/i]",
+        5,
+        1.3,
+        True,
+        False,
+        None,
+        {
+            "jsonrpc": "2.0",
+            "method": "subtract",
+            "params": {"minuend": 42, "subtrahend": 23},
+            "id": 3,
+        },
+    )
+
+    console.log("Hello, World!", "{'a': 1}", repr(console))
+
+    console.print(
+        {
+            "name": None,
+            "empty": [],
+            "quiz": {
+                "sport": {
+                    "answered": True,
+                    "q1": {
+                        "question": "Which one is correct team name in NBA?",
+                        "options": [
+                            "New York Bulls",
+                            "Los Angeles Kings",
+                            "Golden State Warriors",
+                            "Huston Rocket",
+                        ],
+                        "answer": "Huston Rocket",
+                    },
+                },
+                "maths": {
+                    "answered": False,
+                    "q1": {
+                        "question": "5 + 7 = ?",
+                        "options": [10, 11, 12, 13],
+                        "answer": 12,
+                    },
+                    "q2": {
+                        "question": "12 - 8 = ?",
+                        "options": [1, 2, 3, 4],
+                        "answer": 4,
+                    },
+                },
+            },
+        }
+    )
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/constrain.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/constrain.py
new file mode 100644
index 0000000..65fdf56
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/constrain.py
@@ -0,0 +1,37 @@
+from typing import Optional, TYPE_CHECKING
+
+from .jupyter import JupyterMixin
+from .measure import Measurement
+
+if TYPE_CHECKING:
+    from .console import Console, ConsoleOptions, RenderableType, RenderResult
+
+
+class Constrain(JupyterMixin):
+    """Constrain the width of a renderable to a given number of characters.
+
+    Args:
+        renderable (RenderableType): A renderable object.
+        width (int, optional): The maximum width (in characters) to render. Defaults to 80.
+    """
+
+    def __init__(self, renderable: "RenderableType", width: Optional[int] = 80) -> None:
+        self.renderable = renderable
+        self.width = width
+
+    def __rich_console__(
+        self, console: "Console", options: "ConsoleOptions"
+    ) -> "RenderResult":
+        if self.width is None:
+            yield self.renderable
+        else:
+            child_options = options.update_width(min(self.width, options.max_width))
+            yield from console.render(self.renderable, child_options)
+
+    def __rich_measure__(
+        self, console: "Console", options: "ConsoleOptions"
+    ) -> "Measurement":
+        if self.width is not None:
+            options = options.update_width(self.width)
+        measurement = Measurement.get(console, options, self.renderable)
+        return measurement
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/containers.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/containers.py
new file mode 100644
index 0000000..901ff8b
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/containers.py
@@ -0,0 +1,167 @@
+from itertools import zip_longest
+from typing import (
+    TYPE_CHECKING,
+    Iterable,
+    Iterator,
+    List,
+    Optional,
+    TypeVar,
+    Union,
+    overload,
+)
+
+if TYPE_CHECKING:
+    from .console import (
+        Console,
+        ConsoleOptions,
+        JustifyMethod,
+        OverflowMethod,
+        RenderResult,
+        RenderableType,
+    )
+    from .text import Text
+
+from .cells import cell_len
+from .measure import Measurement
+
+T = TypeVar("T")
+
+
+class Renderables:
+    """A list subclass which renders its contents to the console."""
+
+    def __init__(
+        self, renderables: Optional[Iterable["RenderableType"]] = None
+    ) -> None:
+        self._renderables: List["RenderableType"] = (
+            list(renderables) if renderables is not None else []
+        )
+
+    def __rich_console__(
+        self, console: "Console", options: "ConsoleOptions"
+    ) -> "RenderResult":
+        """Console render method to insert line-breaks."""
+        yield from self._renderables
+
+    def __rich_measure__(
+        self, console: "Console", options: "ConsoleOptions"
+    ) -> "Measurement":
+        dimensions = [
+            Measurement.get(console, options, renderable)
+            for renderable in self._renderables
+        ]
+        if not dimensions:
+            return Measurement(1, 1)
+        _min = max(dimension.minimum for dimension in dimensions)
+        _max = max(dimension.maximum for dimension in dimensions)
+        return Measurement(_min, _max)
+
+    def append(self, renderable: "RenderableType") -> None:
+        self._renderables.append(renderable)
+
+    def __iter__(self) -> Iterable["RenderableType"]:
+        return iter(self._renderables)
+
+
+class Lines:
+    """A list subclass which can render to the console."""
+
+    def __init__(self, lines: Iterable["Text"] = ()) -> None:
+        self._lines: List["Text"] = list(lines)
+
+    def __repr__(self) -> str:
+        return f"Lines({self._lines!r})"
+
+    def __iter__(self) -> Iterator["Text"]:
+        return iter(self._lines)
+
+    @overload
+    def __getitem__(self, index: int) -> "Text":
+        ...
+
+    @overload
+    def __getitem__(self, index: slice) -> List["Text"]:
+        ...
+
+    def __getitem__(self, index: Union[slice, int]) -> Union["Text", List["Text"]]:
+        return self._lines[index]
+
+    def __setitem__(self, index: int, value: "Text") -> "Lines":
+        self._lines[index] = value
+        return self
+
+    def __len__(self) -> int:
+        return self._lines.__len__()
+
+    def __rich_console__(
+        self, console: "Console", options: "ConsoleOptions"
+    ) -> "RenderResult":
+        """Console render method to insert line-breaks."""
+        yield from self._lines
+
+    def append(self, line: "Text") -> None:
+        self._lines.append(line)
+
+    def extend(self, lines: Iterable["Text"]) -> None:
+        self._lines.extend(lines)
+
+    def pop(self, index: int = -1) -> "Text":
+        return self._lines.pop(index)
+
+    def justify(
+        self,
+        console: "Console",
+        width: int,
+        justify: "JustifyMethod" = "left",
+        overflow: "OverflowMethod" = "fold",
+    ) -> None:
+        """Justify and overflow text to a given width.
+
+        Args:
+            console (Console): Console instance.
+            width (int): Number of cells available per line.
+            justify (str, optional): Default justify method for text: "left", "center", "full" or "right". Defaults to "left".
+            overflow (str, optional): Default overflow for text: "crop", "fold", or "ellipsis". Defaults to "fold".
+
+        """
+        from .text import Text
+
+        if justify == "left":
+            for line in self._lines:
+                line.truncate(width, overflow=overflow, pad=True)
+        elif justify == "center":
+            for line in self._lines:
+                line.rstrip()
+                line.truncate(width, overflow=overflow)
+                line.pad_left((width - cell_len(line.plain)) // 2)
+                line.pad_right(width - cell_len(line.plain))
+        elif justify == "right":
+            for line in self._lines:
+                line.rstrip()
+                line.truncate(width, overflow=overflow)
+                line.pad_left(width - cell_len(line.plain))
+        elif justify == "full":
+            for line_index, line in enumerate(self._lines):
+                if line_index == len(self._lines) - 1:
+                    break
+                words = line.split(" ")
+                words_size = sum(cell_len(word.plain) for word in words)
+                num_spaces = len(words) - 1
+                spaces = [1 for _ in range(num_spaces)]
+                index = 0
+                if spaces:
+                    while words_size + num_spaces < width:
+                        spaces[len(spaces) - index - 1] += 1
+                        num_spaces += 1
+                        index = (index + 1) % len(spaces)
+                tokens: List[Text] = []
+                for index, (word, next_word) in enumerate(
+                    zip_longest(words, words[1:])
+                ):
+                    tokens.append(word)
+                    if index < len(spaces):
+                        style = word.get_style_at_offset(console, -1)
+                        next_style = next_word.get_style_at_offset(console, 0)
+                        space_style = style if style == next_style else line.style
+                        tokens.append(Text(" " * spaces[index], style=space_style))
+                self[line_index] = Text("").join(tokens)
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/control.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/control.py
new file mode 100644
index 0000000..88fcb92
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/control.py
@@ -0,0 +1,225 @@
+import sys
+import time
+from typing import TYPE_CHECKING, Callable, Dict, Iterable, List, Union
+
+if sys.version_info >= (3, 8):
+    from typing import Final
+else:
+    from pip._vendor.typing_extensions import Final  # pragma: no cover
+
+from .segment import ControlCode, ControlType, Segment
+
+if TYPE_CHECKING:
+    from .console import Console, ConsoleOptions, RenderResult
+
+STRIP_CONTROL_CODES: Final = [
+    7,  # Bell
+    8,  # Backspace
+    11,  # Vertical tab
+    12,  # Form feed
+    13,  # Carriage return
+]
+_CONTROL_STRIP_TRANSLATE: Final = {
+    _codepoint: None for _codepoint in STRIP_CONTROL_CODES
+}
+
+CONTROL_ESCAPE: Final = {
+    7: "\\a",
+    8: "\\b",
+    11: "\\v",
+    12: "\\f",
+    13: "\\r",
+}
+
+CONTROL_CODES_FORMAT: Dict[int, Callable[..., str]] = {
+    ControlType.BELL: lambda: "\x07",
+    ControlType.CARRIAGE_RETURN: lambda: "\r",
+    ControlType.HOME: lambda: "\x1b[H",
+    ControlType.CLEAR: lambda: "\x1b[2J",
+    ControlType.ENABLE_ALT_SCREEN: lambda: "\x1b[?1049h",
+    ControlType.DISABLE_ALT_SCREEN: lambda: "\x1b[?1049l",
+    ControlType.SHOW_CURSOR: lambda: "\x1b[?25h",
+    ControlType.HIDE_CURSOR: lambda: "\x1b[?25l",
+    ControlType.CURSOR_UP: lambda param: f"\x1b[{param}A",
+    ControlType.CURSOR_DOWN: lambda param: f"\x1b[{param}B",
+    ControlType.CURSOR_FORWARD: lambda param: f"\x1b[{param}C",
+    ControlType.CURSOR_BACKWARD: lambda param: f"\x1b[{param}D",
+    ControlType.CURSOR_MOVE_TO_COLUMN: lambda param: f"\x1b[{param+1}G",
+    ControlType.ERASE_IN_LINE: lambda param: f"\x1b[{param}K",
+    ControlType.CURSOR_MOVE_TO: lambda x, y: f"\x1b[{y+1};{x+1}H",
+    ControlType.SET_WINDOW_TITLE: lambda title: f"\x1b]0;{title}\x07",
+}
+
+
+class Control:
+    """A renderable that inserts a control code (non printable but may move cursor).
+
+    Args:
+        *codes (str): Positional arguments are either a :class:`~rich.segment.ControlType` enum or a
+            tuple of ControlType and an integer parameter
+    """
+
+    __slots__ = ["segment"]
+
+    def __init__(self, *codes: Union[ControlType, ControlCode]) -> None:
+        control_codes: List[ControlCode] = [
+            (code,) if isinstance(code, ControlType) else code for code in codes
+        ]
+        _format_map = CONTROL_CODES_FORMAT
+        rendered_codes = "".join(
+            _format_map[code](*parameters) for code, *parameters in control_codes
+        )
+        self.segment = Segment(rendered_codes, None, control_codes)
+
+    @classmethod
+    def bell(cls) -> "Control":
+        """Ring the 'bell'."""
+        return cls(ControlType.BELL)
+
+    @classmethod
+    def home(cls) -> "Control":
+        """Move cursor to 'home' position."""
+        return cls(ControlType.HOME)
+
+    @classmethod
+    def move(cls, x: int = 0, y: int = 0) -> "Control":
+        """Move cursor relative to current position.
+
+        Args:
+            x (int): X offset.
+            y (int): Y offset.
+
+        Returns:
+            ~Control: Control object.
+
+        """
+
+        def get_codes() -> Iterable[ControlCode]:
+            control = ControlType
+            if x:
+                yield (
+                    control.CURSOR_FORWARD if x > 0 else control.CURSOR_BACKWARD,
+                    abs(x),
+                )
+            if y:
+                yield (
+                    control.CURSOR_DOWN if y > 0 else control.CURSOR_UP,
+                    abs(y),
+                )
+
+        control = cls(*get_codes())
+        return control
+
+    @classmethod
+    def move_to_column(cls, x: int, y: int = 0) -> "Control":
+        """Move to the given column, optionally add offset to row.
+
+        Returns:
+            x (int): absolute x (column)
+            y (int): optional y offset (row)
+
+        Returns:
+            ~Control: Control object.
+        """
+
+        return (
+            cls(
+                (ControlType.CURSOR_MOVE_TO_COLUMN, x),
+                (
+                    ControlType.CURSOR_DOWN if y > 0 else ControlType.CURSOR_UP,
+                    abs(y),
+                ),
+            )
+            if y
+            else cls((ControlType.CURSOR_MOVE_TO_COLUMN, x))
+        )
+
+    @classmethod
+    def move_to(cls, x: int, y: int) -> "Control":
+        """Move cursor to absolute position.
+
+        Args:
+            x (int): x offset (column)
+            y (int): y offset (row)
+
+        Returns:
+            ~Control: Control object.
+        """
+        return cls((ControlType.CURSOR_MOVE_TO, x, y))
+
+    @classmethod
+    def clear(cls) -> "Control":
+        """Clear the screen."""
+        return cls(ControlType.CLEAR)
+
+    @classmethod
+    def show_cursor(cls, show: bool) -> "Control":
+        """Show or hide the cursor."""
+        return cls(ControlType.SHOW_CURSOR if show else ControlType.HIDE_CURSOR)
+
+    @classmethod
+    def alt_screen(cls, enable: bool) -> "Control":
+        """Enable or disable alt screen."""
+        if enable:
+            return cls(ControlType.ENABLE_ALT_SCREEN, ControlType.HOME)
+        else:
+            return cls(ControlType.DISABLE_ALT_SCREEN)
+
+    @classmethod
+    def title(cls, title: str) -> "Control":
+        """Set the terminal window title
+
+        Args:
+            title (str): The new terminal window title
+        """
+        return cls((ControlType.SET_WINDOW_TITLE, title))
+
+    def __str__(self) -> str:
+        return self.segment.text
+
+    def __rich_console__(
+        self, console: "Console", options: "ConsoleOptions"
+    ) -> "RenderResult":
+        if self.segment.text:
+            yield self.segment
+
+
+def strip_control_codes(
+    text: str, _translate_table: Dict[int, None] = _CONTROL_STRIP_TRANSLATE
+) -> str:
+    """Remove control codes from text.
+
+    Args:
+        text (str): A string possibly contain control codes.
+
+    Returns:
+        str: String with control codes removed.
+    """
+    return text.translate(_translate_table)
+
+
+def escape_control_codes(
+    text: str,
+    _translate_table: Dict[int, str] = CONTROL_ESCAPE,
+) -> str:
+    """Replace control codes with their "escaped" equivalent in the given text.
+    (e.g. "\b" becomes "\\b")
+
+    Args:
+        text (str): A string possibly containing control codes.
+
+    Returns:
+        str: String with control codes replaced with their escaped version.
+    """
+    return text.translate(_translate_table)
+
+
+if __name__ == "__main__":  # pragma: no cover
+    from pip._vendor.rich.console import Console
+
+    console = Console()
+    console.print("Look at the title of your terminal window ^")
+    # console.print(Control((ControlType.SET_WINDOW_TITLE, "Hello, world!")))
+    for i in range(10):
+        console.set_window_title("🚀 Loading" + "." * i)
+        time.sleep(0.5)
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/default_styles.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/default_styles.py
new file mode 100644
index 0000000..6c0d732
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/default_styles.py
@@ -0,0 +1,191 @@
+from typing import Dict
+
+from .style import Style
+
+DEFAULT_STYLES: Dict[str, Style] = {
+    "none": Style.null(),
+    "reset": Style(
+        color="default",
+        bgcolor="default",
+        dim=False,
+        bold=False,
+        italic=False,
+        underline=False,
+        blink=False,
+        blink2=False,
+        reverse=False,
+        conceal=False,
+        strike=False,
+    ),
+    "dim": Style(dim=True),
+    "bright": Style(dim=False),
+    "bold": Style(bold=True),
+    "strong": Style(bold=True),
+    "code": Style(reverse=True, bold=True),
+    "italic": Style(italic=True),
+    "emphasize": Style(italic=True),
+    "underline": Style(underline=True),
+    "blink": Style(blink=True),
+    "blink2": Style(blink2=True),
+    "reverse": Style(reverse=True),
+    "strike": Style(strike=True),
+    "black": Style(color="black"),
+    "red": Style(color="red"),
+    "green": Style(color="green"),
+    "yellow": Style(color="yellow"),
+    "magenta": Style(color="magenta"),
+    "cyan": Style(color="cyan"),
+    "white": Style(color="white"),
+    "inspect.attr": Style(color="yellow", italic=True),
+    "inspect.attr.dunder": Style(color="yellow", italic=True, dim=True),
+    "inspect.callable": Style(bold=True, color="red"),
+    "inspect.async_def": Style(italic=True, color="bright_cyan"),
+    "inspect.def": Style(italic=True, color="bright_cyan"),
+    "inspect.class": Style(italic=True, color="bright_cyan"),
+    "inspect.error": Style(bold=True, color="red"),
+    "inspect.equals": Style(),
+    "inspect.help": Style(color="cyan"),
+    "inspect.doc": Style(dim=True),
+    "inspect.value.border": Style(color="green"),
+    "live.ellipsis": Style(bold=True, color="red"),
+    "layout.tree.row": Style(dim=False, color="red"),
+    "layout.tree.column": Style(dim=False, color="blue"),
+    "logging.keyword": Style(bold=True, color="yellow"),
+    "logging.level.notset": Style(dim=True),
+    "logging.level.debug": Style(color="green"),
+    "logging.level.info": Style(color="blue"),
+    "logging.level.warning": Style(color="yellow"),
+    "logging.level.error": Style(color="red", bold=True),
+    "logging.level.critical": Style(color="red", bold=True, reverse=True),
+    "log.level": Style.null(),
+    "log.time": Style(color="cyan", dim=True),
+    "log.message": Style.null(),
+    "log.path": Style(dim=True),
+    "repr.ellipsis": Style(color="yellow"),
+    "repr.indent": Style(color="green", dim=True),
+    "repr.error": Style(color="red", bold=True),
+    "repr.str": Style(color="green", italic=False, bold=False),
+    "repr.brace": Style(bold=True),
+    "repr.comma": Style(bold=True),
+    "repr.ipv4": Style(bold=True, color="bright_green"),
+    "repr.ipv6": Style(bold=True, color="bright_green"),
+    "repr.eui48": Style(bold=True, color="bright_green"),
+    "repr.eui64": Style(bold=True, color="bright_green"),
+    "repr.tag_start": Style(bold=True),
+    "repr.tag_name": Style(color="bright_magenta", bold=True),
+    "repr.tag_contents": Style(color="default"),
+    "repr.tag_end": Style(bold=True),
+    "repr.attrib_name": Style(color="yellow", italic=False),
+    "repr.attrib_equal": Style(bold=True),
+    "repr.attrib_value": Style(color="magenta", italic=False),
+    "repr.number": Style(color="cyan", bold=True, italic=False),
+    "repr.number_complex": Style(color="cyan", bold=True, italic=False),  # same
+    "repr.bool_true": Style(color="bright_green", italic=True),
+    "repr.bool_false": Style(color="bright_red", italic=True),
+    "repr.none": Style(color="magenta", italic=True),
+    "repr.url": Style(underline=True, color="bright_blue", italic=False, bold=False),
+    "repr.uuid": Style(color="bright_yellow", bold=False),
+    "repr.call": Style(color="magenta", bold=True),
+    "repr.path": Style(color="magenta"),
+    "repr.filename": Style(color="bright_magenta"),
+    "rule.line": Style(color="bright_green"),
+    "rule.text": Style.null(),
+    "json.brace": Style(bold=True),
+    "json.bool_true": Style(color="bright_green", italic=True),
+    "json.bool_false": Style(color="bright_red", italic=True),
+    "json.null": Style(color="magenta", italic=True),
+    "json.number": Style(color="cyan", bold=True, italic=False),
+    "json.str": Style(color="green", italic=False, bold=False),
+    "json.key": Style(color="blue", bold=True),
+    "prompt": Style.null(),
+    "prompt.choices": Style(color="magenta", bold=True),
+    "prompt.default": Style(color="cyan", bold=True),
+    "prompt.invalid": Style(color="red"),
+    "prompt.invalid.choice": Style(color="red"),
+    "pretty": Style.null(),
+    "scope.border": Style(color="blue"),
+    "scope.key": Style(color="yellow", italic=True),
+    "scope.key.special": Style(color="yellow", italic=True, dim=True),
+    "scope.equals": Style(color="red"),
+    "table.header": Style(bold=True),
+    "table.footer": Style(bold=True),
+    "table.cell": Style.null(),
+    "table.title": Style(italic=True),
+    "table.caption": Style(italic=True, dim=True),
+    "traceback.error": Style(color="red", italic=True),
+    "traceback.border.syntax_error": Style(color="bright_red"),
+    "traceback.border": Style(color="red"),
+    "traceback.text": Style.null(),
+    "traceback.title": Style(color="red", bold=True),
+    "traceback.exc_type": Style(color="bright_red", bold=True),
+    "traceback.exc_value": Style.null(),
+    "traceback.offset": Style(color="bright_red", bold=True),
+    "traceback.error_range": Style(underline=True, bold=True, dim=False),
+    "bar.back": Style(color="grey23"),
+    "bar.complete": Style(color="rgb(249,38,114)"),
+    "bar.finished": Style(color="rgb(114,156,31)"),
+    "bar.pulse": Style(color="rgb(249,38,114)"),
+    "progress.description": Style.null(),
+    "progress.filesize": Style(color="green"),
+    "progress.filesize.total": Style(color="green"),
+    "progress.download": Style(color="green"),
+    "progress.elapsed": Style(color="yellow"),
+    "progress.percentage": Style(color="magenta"),
+    "progress.remaining": Style(color="cyan"),
+    "progress.data.speed": Style(color="red"),
+    "progress.spinner": Style(color="green"),
+    "status.spinner": Style(color="green"),
+    "tree": Style(),
+    "tree.line": Style(),
+    "markdown.paragraph": Style(),
+    "markdown.text": Style(),
+    "markdown.em": Style(italic=True),
+    "markdown.emph": Style(italic=True),  # For commonmark backwards compatibility
+    "markdown.strong": Style(bold=True),
+    "markdown.code": Style(bold=True, color="cyan", bgcolor="black"),
+    "markdown.code_block": Style(color="cyan", bgcolor="black"),
+    "markdown.block_quote": Style(color="magenta"),
+    "markdown.list": Style(color="cyan"),
+    "markdown.item": Style(),
+    "markdown.item.bullet": Style(color="yellow", bold=True),
+    "markdown.item.number": Style(color="yellow", bold=True),
+    "markdown.hr": Style(color="yellow"),
+    "markdown.h1.border": Style(),
+    "markdown.h1": Style(bold=True),
+    "markdown.h2": Style(bold=True, underline=True),
+    "markdown.h3": Style(bold=True),
+    "markdown.h4": Style(bold=True, dim=True),
+    "markdown.h5": Style(underline=True),
+    "markdown.h6": Style(italic=True),
+    "markdown.h7": Style(italic=True, dim=True),
+    "markdown.link": Style(color="bright_blue"),
+    "markdown.link_url": Style(color="blue", underline=True),
+    "markdown.s": Style(strike=True),
+    "iso8601.date": Style(color="blue"),
+    "iso8601.time": Style(color="magenta"),
+    "iso8601.timezone": Style(color="yellow"),
+}
+
+
+if __name__ == "__main__":  # pragma: no cover
+    import argparse
+    import io
+
+    from pip._vendor.rich.console import Console
+    from pip._vendor.rich.table import Table
+    from pip._vendor.rich.text import Text
+
+    parser = argparse.ArgumentParser()
+    parser.add_argument("--html", action="store_true", help="Export as HTML table")
+    args = parser.parse_args()
+    html: bool = args.html
+    console = Console(record=True, width=70, file=io.StringIO()) if html else Console()
+
+    table = Table("Name", "Styling")
+
+    for style_name, style in DEFAULT_STYLES.items():
+        table.add_row(Text(style_name, style=style), str(style))
+
+    console.print(table)
+    if html:
+        print(console.export_html(inline_styles=True))
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/diagnose.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/diagnose.py
new file mode 100644
index 0000000..ad36183
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/diagnose.py
@@ -0,0 +1,37 @@
+import os
+import platform
+
+from pip._vendor.rich import inspect
+from pip._vendor.rich.console import Console, get_windows_console_features
+from pip._vendor.rich.panel import Panel
+from pip._vendor.rich.pretty import Pretty
+
+
+def report() -> None:  # pragma: no cover
+    """Print a report to the terminal with debugging information"""
+    console = Console()
+    inspect(console)
+    features = get_windows_console_features()
+    inspect(features)
+
+    env_names = (
+        "TERM",
+        "COLORTERM",
+        "CLICOLOR",
+        "NO_COLOR",
+        "TERM_PROGRAM",
+        "COLUMNS",
+        "LINES",
+        "JUPYTER_COLUMNS",
+        "JUPYTER_LINES",
+        "JPY_PARENT_PID",
+        "VSCODE_VERBOSE_LOGGING",
+    )
+    env = {name: os.getenv(name) for name in env_names}
+    console.print(Panel.fit((Pretty(env)), title="[b]Environment Variables"))
+
+    console.print(f'platform="{platform.system()}"')
+
+
+if __name__ == "__main__":  # pragma: no cover
+    report()
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/emoji.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/emoji.py
new file mode 100644
index 0000000..791f046
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/emoji.py
@@ -0,0 +1,96 @@
+import sys
+from typing import TYPE_CHECKING, Optional, Union
+
+from .jupyter import JupyterMixin
+from .segment import Segment
+from .style import Style
+from ._emoji_codes import EMOJI
+from ._emoji_replace import _emoji_replace
+
+if sys.version_info >= (3, 8):
+    from typing import Literal
+else:
+    from pip._vendor.typing_extensions import Literal  # pragma: no cover
+
+
+if TYPE_CHECKING:
+    from .console import Console, ConsoleOptions, RenderResult
+
+
+EmojiVariant = Literal["emoji", "text"]
+
+
+class NoEmoji(Exception):
+    """No emoji by that name."""
+
+
+class Emoji(JupyterMixin):
+    __slots__ = ["name", "style", "_char", "variant"]
+
+    VARIANTS = {"text": "\uFE0E", "emoji": "\uFE0F"}
+
+    def __init__(
+        self,
+        name: str,
+        style: Union[str, Style] = "none",
+        variant: Optional[EmojiVariant] = None,
+    ) -> None:
+        """A single emoji character.
+
+        Args:
+            name (str): Name of emoji.
+            style (Union[str, Style], optional): Optional style. Defaults to None.
+
+        Raises:
+            NoEmoji: If the emoji doesn't exist.
+        """
+        self.name = name
+        self.style = style
+        self.variant = variant
+        try:
+            self._char = EMOJI[name]
+        except KeyError:
+            raise NoEmoji(f"No emoji called {name!r}")
+        if variant is not None:
+            self._char += self.VARIANTS.get(variant, "")
+
+    @classmethod
+    def replace(cls, text: str) -> str:
+        """Replace emoji markup with corresponding unicode characters.
+
+        Args:
+            text (str): A string with emojis codes, e.g. "Hello :smiley:!"
+
+        Returns:
+            str: A string with emoji codes replaces with actual emoji.
+        """
+        return _emoji_replace(text)
+
+    def __repr__(self) -> str:
+        return f""
+
+    def __str__(self) -> str:
+        return self._char
+
+    def __rich_console__(
+        self, console: "Console", options: "ConsoleOptions"
+    ) -> "RenderResult":
+        yield Segment(self._char, console.get_style(self.style))
+
+
+if __name__ == "__main__":  # pragma: no cover
+    import sys
+
+    from pip._vendor.rich.columns import Columns
+    from pip._vendor.rich.console import Console
+
+    console = Console(record=True)
+
+    columns = Columns(
+        (f":{name}: {name}" for name in sorted(EMOJI.keys()) if "\u200D" not in name),
+        column_first=True,
+    )
+
+    console.print(columns)
+    if len(sys.argv) > 1:
+        console.save_html(sys.argv[1])
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/errors.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/errors.py
new file mode 100644
index 0000000..0bcbe53
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/errors.py
@@ -0,0 +1,34 @@
+class ConsoleError(Exception):
+    """An error in console operation."""
+
+
+class StyleError(Exception):
+    """An error in styles."""
+
+
+class StyleSyntaxError(ConsoleError):
+    """Style was badly formatted."""
+
+
+class MissingStyle(StyleError):
+    """No such style."""
+
+
+class StyleStackError(ConsoleError):
+    """Style stack is invalid."""
+
+
+class NotRenderableError(ConsoleError):
+    """Object is not renderable."""
+
+
+class MarkupError(ConsoleError):
+    """Markup was badly formatted."""
+
+
+class LiveError(ConsoleError):
+    """Error related to Live display."""
+
+
+class NoAltScreen(ConsoleError):
+    """Alt screen mode was required."""
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/file_proxy.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/file_proxy.py
new file mode 100644
index 0000000..4b0b0da
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/file_proxy.py
@@ -0,0 +1,57 @@
+import io
+from typing import IO, TYPE_CHECKING, Any, List
+
+from .ansi import AnsiDecoder
+from .text import Text
+
+if TYPE_CHECKING:
+    from .console import Console
+
+
+class FileProxy(io.TextIOBase):
+    """Wraps a file (e.g. sys.stdout) and redirects writes to a console."""
+
+    def __init__(self, console: "Console", file: IO[str]) -> None:
+        self.__console = console
+        self.__file = file
+        self.__buffer: List[str] = []
+        self.__ansi_decoder = AnsiDecoder()
+
+    @property
+    def rich_proxied_file(self) -> IO[str]:
+        """Get proxied file."""
+        return self.__file
+
+    def __getattr__(self, name: str) -> Any:
+        return getattr(self.__file, name)
+
+    def write(self, text: str) -> int:
+        if not isinstance(text, str):
+            raise TypeError(f"write() argument must be str, not {type(text).__name__}")
+        buffer = self.__buffer
+        lines: List[str] = []
+        while text:
+            line, new_line, text = text.partition("\n")
+            if new_line:
+                lines.append("".join(buffer) + line)
+                buffer.clear()
+            else:
+                buffer.append(line)
+                break
+        if lines:
+            console = self.__console
+            with console:
+                output = Text("\n").join(
+                    self.__ansi_decoder.decode_line(line) for line in lines
+                )
+                console.print(output)
+        return len(text)
+
+    def flush(self) -> None:
+        output = "".join(self.__buffer)
+        if output:
+            self.__console.print(output)
+        del self.__buffer[:]
+
+    def fileno(self) -> int:
+        return self.__file.fileno()
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/filesize.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/filesize.py
new file mode 100644
index 0000000..83bc911
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/filesize.py
@@ -0,0 +1,88 @@
+"""Functions for reporting filesizes. Borrowed from https://github.com/PyFilesystem/pyfilesystem2
+
+The functions declared in this module should cover the different
+use cases needed to generate a string representation of a file size
+using several different units. Since there are many standards regarding
+file size units, three different functions have been implemented.
+
+See Also:
+    * `Wikipedia: Binary prefix `_
+
+"""
+
+__all__ = ["decimal"]
+
+from typing import Iterable, List, Optional, Tuple
+
+
+def _to_str(
+    size: int,
+    suffixes: Iterable[str],
+    base: int,
+    *,
+    precision: Optional[int] = 1,
+    separator: Optional[str] = " ",
+) -> str:
+    if size == 1:
+        return "1 byte"
+    elif size < base:
+        return f"{size:,} bytes"
+
+    for i, suffix in enumerate(suffixes, 2):  # noqa: B007
+        unit = base**i
+        if size < unit:
+            break
+    return "{:,.{precision}f}{separator}{}".format(
+        (base * size / unit),
+        suffix,
+        precision=precision,
+        separator=separator,
+    )
+
+
+def pick_unit_and_suffix(size: int, suffixes: List[str], base: int) -> Tuple[int, str]:
+    """Pick a suffix and base for the given size."""
+    for i, suffix in enumerate(suffixes):
+        unit = base**i
+        if size < unit * base:
+            break
+    return unit, suffix
+
+
+def decimal(
+    size: int,
+    *,
+    precision: Optional[int] = 1,
+    separator: Optional[str] = " ",
+) -> str:
+    """Convert a filesize in to a string (powers of 1000, SI prefixes).
+
+    In this convention, ``1000 B = 1 kB``.
+
+    This is typically the format used to advertise the storage
+    capacity of USB flash drives and the like (*256 MB* meaning
+    actually a storage capacity of more than *256 000 000 B*),
+    or used by **Mac OS X** since v10.6 to report file sizes.
+
+    Arguments:
+        int (size): A file size.
+        int (precision): The number of decimal places to include (default = 1).
+        str (separator): The string to separate the value from the units (default = " ").
+
+    Returns:
+        `str`: A string containing a abbreviated file size and units.
+
+    Example:
+        >>> filesize.decimal(30000)
+        '30.0 kB'
+        >>> filesize.decimal(30000, precision=2, separator="")
+        '30.00kB'
+
+    """
+    return _to_str(
+        size,
+        ("kB", "MB", "GB", "TB", "PB", "EB", "ZB", "YB"),
+        1000,
+        precision=precision,
+        separator=separator,
+    )
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/highlighter.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/highlighter.py
new file mode 100644
index 0000000..e4c462e
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/highlighter.py
@@ -0,0 +1,232 @@
+import re
+from abc import ABC, abstractmethod
+from typing import List, Union
+
+from .text import Span, Text
+
+
+def _combine_regex(*regexes: str) -> str:
+    """Combine a number of regexes in to a single regex.
+
+    Returns:
+        str: New regex with all regexes ORed together.
+    """
+    return "|".join(regexes)
+
+
+class Highlighter(ABC):
+    """Abstract base class for highlighters."""
+
+    def __call__(self, text: Union[str, Text]) -> Text:
+        """Highlight a str or Text instance.
+
+        Args:
+            text (Union[str, ~Text]): Text to highlight.
+
+        Raises:
+            TypeError: If not called with text or str.
+
+        Returns:
+            Text: A test instance with highlighting applied.
+        """
+        if isinstance(text, str):
+            highlight_text = Text(text)
+        elif isinstance(text, Text):
+            highlight_text = text.copy()
+        else:
+            raise TypeError(f"str or Text instance required, not {text!r}")
+        self.highlight(highlight_text)
+        return highlight_text
+
+    @abstractmethod
+    def highlight(self, text: Text) -> None:
+        """Apply highlighting in place to text.
+
+        Args:
+            text (~Text): A text object highlight.
+        """
+
+
+class NullHighlighter(Highlighter):
+    """A highlighter object that doesn't highlight.
+
+    May be used to disable highlighting entirely.
+
+    """
+
+    def highlight(self, text: Text) -> None:
+        """Nothing to do"""
+
+
+class RegexHighlighter(Highlighter):
+    """Applies highlighting from a list of regular expressions."""
+
+    highlights: List[str] = []
+    base_style: str = ""
+
+    def highlight(self, text: Text) -> None:
+        """Highlight :class:`rich.text.Text` using regular expressions.
+
+        Args:
+            text (~Text): Text to highlighted.
+
+        """
+
+        highlight_regex = text.highlight_regex
+        for re_highlight in self.highlights:
+            highlight_regex(re_highlight, style_prefix=self.base_style)
+
+
+class ReprHighlighter(RegexHighlighter):
+    """Highlights the text typically produced from ``__repr__`` methods."""
+
+    base_style = "repr."
+    highlights = [
+        r"(?P<)(?P[-\w.:|]*)(?P[\w\W]*)(?P>)",
+        r'(?P[\w_]{1,50})=(?P"?[\w_]+"?)?',
+        r"(?P[][{}()])",
+        _combine_regex(
+            r"(?P[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3})",
+            r"(?P([A-Fa-f0-9]{1,4}::?){1,7}[A-Fa-f0-9]{1,4})",
+            r"(?P(?:[0-9A-Fa-f]{1,2}-){7}[0-9A-Fa-f]{1,2}|(?:[0-9A-Fa-f]{1,2}:){7}[0-9A-Fa-f]{1,2}|(?:[0-9A-Fa-f]{4}\.){3}[0-9A-Fa-f]{4})",
+            r"(?P(?:[0-9A-Fa-f]{1,2}-){5}[0-9A-Fa-f]{1,2}|(?:[0-9A-Fa-f]{1,2}:){5}[0-9A-Fa-f]{1,2}|(?:[0-9A-Fa-f]{4}\.){2}[0-9A-Fa-f]{4})",
+            r"(?P[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12})",
+            r"(?P[\w.]*?)\(",
+            r"\b(?PTrue)\b|\b(?PFalse)\b|\b(?PNone)\b",
+            r"(?P\.\.\.)",
+            r"(?P(?(?\B(/[-\w._+]+)*\/)(?P[-\w._+]*)?",
+            r"(?b?'''.*?(?(file|https|http|ws|wss)://[-0-9a-zA-Z$_+!`(),.?/;:&=%#~@]*)",
+        ),
+    ]
+
+
+class JSONHighlighter(RegexHighlighter):
+    """Highlights JSON"""
+
+    # Captures the start and end of JSON strings, handling escaped quotes
+    JSON_STR = r"(?b?\".*?(?[\{\[\(\)\]\}])",
+            r"\b(?Ptrue)\b|\b(?Pfalse)\b|\b(?Pnull)\b",
+            r"(?P(? None:
+        super().highlight(text)
+
+        # Additional work to handle highlighting JSON keys
+        plain = text.plain
+        append = text.spans.append
+        whitespace = self.JSON_WHITESPACE
+        for match in re.finditer(self.JSON_STR, plain):
+            start, end = match.span()
+            cursor = end
+            while cursor < len(plain):
+                char = plain[cursor]
+                cursor += 1
+                if char == ":":
+                    append(Span(start, end, "json.key"))
+                elif char in whitespace:
+                    continue
+                break
+
+
+class ISO8601Highlighter(RegexHighlighter):
+    """Highlights the ISO8601 date time strings.
+    Regex reference: https://www.oreilly.com/library/view/regular-expressions-cookbook/9781449327453/ch04s07.html
+    """
+
+    base_style = "iso8601."
+    highlights = [
+        #
+        # Dates
+        #
+        # Calendar month (e.g. 2008-08). The hyphen is required
+        r"^(?P[0-9]{4})-(?P1[0-2]|0[1-9])$",
+        # Calendar date w/o hyphens (e.g. 20080830)
+        r"^(?P(?P[0-9]{4})(?P1[0-2]|0[1-9])(?P3[01]|0[1-9]|[12][0-9]))$",
+        # Ordinal date (e.g. 2008-243). The hyphen is optional
+        r"^(?P(?P[0-9]{4})-?(?P36[0-6]|3[0-5][0-9]|[12][0-9]{2}|0[1-9][0-9]|00[1-9]))$",
+        #
+        # Weeks
+        #
+        # Week of the year (e.g., 2008-W35). The hyphen is optional
+        r"^(?P(?P[0-9]{4})-?W(?P5[0-3]|[1-4][0-9]|0[1-9]))$",
+        # Week date (e.g., 2008-W35-6). The hyphens are optional
+        r"^(?P(?P[0-9]{4})-?W(?P5[0-3]|[1-4][0-9]|0[1-9])-?(?P[1-7]))$",
+        #
+        # Times
+        #
+        # Hours and minutes (e.g., 17:21). The colon is optional
+        r"^(?P{text}'
+        append_fragment(text)
+
+    code = "".join(fragments)
+    html = JUPYTER_HTML_FORMAT.format(code=code)
+
+    return html
+
+
+def display(segments: Iterable[Segment], text: str) -> None:
+    """Render segments to Jupyter."""
+    html = _render_segments(segments)
+    jupyter_renderable = JupyterRenderable(html, text)
+    try:
+        from IPython.display import display as ipython_display
+
+        ipython_display(jupyter_renderable)
+    except ModuleNotFoundError:
+        # Handle the case where the Console has force_jupyter=True,
+        # but IPython is not installed.
+        pass
+
+
+def print(*args: Any, **kwargs: Any) -> None:
+    """Proxy for Console print."""
+    console = get_console()
+    return console.print(*args, **kwargs)
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/layout.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/layout.py
new file mode 100644
index 0000000..a6f1a31
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/layout.py
@@ -0,0 +1,442 @@
+from abc import ABC, abstractmethod
+from itertools import islice
+from operator import itemgetter
+from threading import RLock
+from typing import (
+    TYPE_CHECKING,
+    Dict,
+    Iterable,
+    List,
+    NamedTuple,
+    Optional,
+    Sequence,
+    Tuple,
+    Union,
+)
+
+from ._ratio import ratio_resolve
+from .align import Align
+from .console import Console, ConsoleOptions, RenderableType, RenderResult
+from .highlighter import ReprHighlighter
+from .panel import Panel
+from .pretty import Pretty
+from .region import Region
+from .repr import Result, rich_repr
+from .segment import Segment
+from .style import StyleType
+
+if TYPE_CHECKING:
+    from pip._vendor.rich.tree import Tree
+
+
+class LayoutRender(NamedTuple):
+    """An individual layout render."""
+
+    region: Region
+    render: List[List[Segment]]
+
+
+RegionMap = Dict["Layout", Region]
+RenderMap = Dict["Layout", LayoutRender]
+
+
+class LayoutError(Exception):
+    """Layout related error."""
+
+
+class NoSplitter(LayoutError):
+    """Requested splitter does not exist."""
+
+
+class _Placeholder:
+    """An internal renderable used as a Layout placeholder."""
+
+    highlighter = ReprHighlighter()
+
+    def __init__(self, layout: "Layout", style: StyleType = "") -> None:
+        self.layout = layout
+        self.style = style
+
+    def __rich_console__(
+        self, console: Console, options: ConsoleOptions
+    ) -> RenderResult:
+        width = options.max_width
+        height = options.height or options.size.height
+        layout = self.layout
+        title = (
+            f"{layout.name!r} ({width} x {height})"
+            if layout.name
+            else f"({width} x {height})"
+        )
+        yield Panel(
+            Align.center(Pretty(layout), vertical="middle"),
+            style=self.style,
+            title=self.highlighter(title),
+            border_style="blue",
+            height=height,
+        )
+
+
+class Splitter(ABC):
+    """Base class for a splitter."""
+
+    name: str = ""
+
+    @abstractmethod
+    def get_tree_icon(self) -> str:
+        """Get the icon (emoji) used in layout.tree"""
+
+    @abstractmethod
+    def divide(
+        self, children: Sequence["Layout"], region: Region
+    ) -> Iterable[Tuple["Layout", Region]]:
+        """Divide a region amongst several child layouts.
+
+        Args:
+            children (Sequence(Layout)): A number of child layouts.
+            region (Region): A rectangular region to divide.
+        """
+
+
+class RowSplitter(Splitter):
+    """Split a layout region in to rows."""
+
+    name = "row"
+
+    def get_tree_icon(self) -> str:
+        return "[layout.tree.row]⬌"
+
+    def divide(
+        self, children: Sequence["Layout"], region: Region
+    ) -> Iterable[Tuple["Layout", Region]]:
+        x, y, width, height = region
+        render_widths = ratio_resolve(width, children)
+        offset = 0
+        _Region = Region
+        for child, child_width in zip(children, render_widths):
+            yield child, _Region(x + offset, y, child_width, height)
+            offset += child_width
+
+
+class ColumnSplitter(Splitter):
+    """Split a layout region in to columns."""
+
+    name = "column"
+
+    def get_tree_icon(self) -> str:
+        return "[layout.tree.column]⬍"
+
+    def divide(
+        self, children: Sequence["Layout"], region: Region
+    ) -> Iterable[Tuple["Layout", Region]]:
+        x, y, width, height = region
+        render_heights = ratio_resolve(height, children)
+        offset = 0
+        _Region = Region
+        for child, child_height in zip(children, render_heights):
+            yield child, _Region(x, y + offset, width, child_height)
+            offset += child_height
+
+
+@rich_repr
+class Layout:
+    """A renderable to divide a fixed height in to rows or columns.
+
+    Args:
+        renderable (RenderableType, optional): Renderable content, or None for placeholder. Defaults to None.
+        name (str, optional): Optional identifier for Layout. Defaults to None.
+        size (int, optional): Optional fixed size of layout. Defaults to None.
+        minimum_size (int, optional): Minimum size of layout. Defaults to 1.
+        ratio (int, optional): Optional ratio for flexible layout. Defaults to 1.
+        visible (bool, optional): Visibility of layout. Defaults to True.
+    """
+
+    splitters = {"row": RowSplitter, "column": ColumnSplitter}
+
+    def __init__(
+        self,
+        renderable: Optional[RenderableType] = None,
+        *,
+        name: Optional[str] = None,
+        size: Optional[int] = None,
+        minimum_size: int = 1,
+        ratio: int = 1,
+        visible: bool = True,
+    ) -> None:
+        self._renderable = renderable or _Placeholder(self)
+        self.size = size
+        self.minimum_size = minimum_size
+        self.ratio = ratio
+        self.name = name
+        self.visible = visible
+        self.splitter: Splitter = self.splitters["column"]()
+        self._children: List[Layout] = []
+        self._render_map: RenderMap = {}
+        self._lock = RLock()
+
+    def __rich_repr__(self) -> Result:
+        yield "name", self.name, None
+        yield "size", self.size, None
+        yield "minimum_size", self.minimum_size, 1
+        yield "ratio", self.ratio, 1
+
+    @property
+    def renderable(self) -> RenderableType:
+        """Layout renderable."""
+        return self if self._children else self._renderable
+
+    @property
+    def children(self) -> List["Layout"]:
+        """Gets (visible) layout children."""
+        return [child for child in self._children if child.visible]
+
+    @property
+    def map(self) -> RenderMap:
+        """Get a map of the last render."""
+        return self._render_map
+
+    def get(self, name: str) -> Optional["Layout"]:
+        """Get a named layout, or None if it doesn't exist.
+
+        Args:
+            name (str): Name of layout.
+
+        Returns:
+            Optional[Layout]: Layout instance or None if no layout was found.
+        """
+        if self.name == name:
+            return self
+        else:
+            for child in self._children:
+                named_layout = child.get(name)
+                if named_layout is not None:
+                    return named_layout
+        return None
+
+    def __getitem__(self, name: str) -> "Layout":
+        layout = self.get(name)
+        if layout is None:
+            raise KeyError(f"No layout with name {name!r}")
+        return layout
+
+    @property
+    def tree(self) -> "Tree":
+        """Get a tree renderable to show layout structure."""
+        from pip._vendor.rich.styled import Styled
+        from pip._vendor.rich.table import Table
+        from pip._vendor.rich.tree import Tree
+
+        def summary(layout: "Layout") -> Table:
+            icon = layout.splitter.get_tree_icon()
+
+            table = Table.grid(padding=(0, 1, 0, 0))
+
+            text: RenderableType = (
+                Pretty(layout) if layout.visible else Styled(Pretty(layout), "dim")
+            )
+            table.add_row(icon, text)
+            _summary = table
+            return _summary
+
+        layout = self
+        tree = Tree(
+            summary(layout),
+            guide_style=f"layout.tree.{layout.splitter.name}",
+            highlight=True,
+        )
+
+        def recurse(tree: "Tree", layout: "Layout") -> None:
+            for child in layout._children:
+                recurse(
+                    tree.add(
+                        summary(child),
+                        guide_style=f"layout.tree.{child.splitter.name}",
+                    ),
+                    child,
+                )
+
+        recurse(tree, self)
+        return tree
+
+    def split(
+        self,
+        *layouts: Union["Layout", RenderableType],
+        splitter: Union[Splitter, str] = "column",
+    ) -> None:
+        """Split the layout in to multiple sub-layouts.
+
+        Args:
+            *layouts (Layout): Positional arguments should be (sub) Layout instances.
+            splitter (Union[Splitter, str]): Splitter instance or name of splitter.
+        """
+        _layouts = [
+            layout if isinstance(layout, Layout) else Layout(layout)
+            for layout in layouts
+        ]
+        try:
+            self.splitter = (
+                splitter
+                if isinstance(splitter, Splitter)
+                else self.splitters[splitter]()
+            )
+        except KeyError:
+            raise NoSplitter(f"No splitter called {splitter!r}")
+        self._children[:] = _layouts
+
+    def add_split(self, *layouts: Union["Layout", RenderableType]) -> None:
+        """Add a new layout(s) to existing split.
+
+        Args:
+            *layouts (Union[Layout, RenderableType]): Positional arguments should be renderables or (sub) Layout instances.
+
+        """
+        _layouts = (
+            layout if isinstance(layout, Layout) else Layout(layout)
+            for layout in layouts
+        )
+        self._children.extend(_layouts)
+
+    def split_row(self, *layouts: Union["Layout", RenderableType]) -> None:
+        """Split the layout in to a row (layouts side by side).
+
+        Args:
+            *layouts (Layout): Positional arguments should be (sub) Layout instances.
+        """
+        self.split(*layouts, splitter="row")
+
+    def split_column(self, *layouts: Union["Layout", RenderableType]) -> None:
+        """Split the layout in to a column (layouts stacked on top of each other).
+
+        Args:
+            *layouts (Layout): Positional arguments should be (sub) Layout instances.
+        """
+        self.split(*layouts, splitter="column")
+
+    def unsplit(self) -> None:
+        """Reset splits to initial state."""
+        del self._children[:]
+
+    def update(self, renderable: RenderableType) -> None:
+        """Update renderable.
+
+        Args:
+            renderable (RenderableType): New renderable object.
+        """
+        with self._lock:
+            self._renderable = renderable
+
+    def refresh_screen(self, console: "Console", layout_name: str) -> None:
+        """Refresh a sub-layout.
+
+        Args:
+            console (Console): Console instance where Layout is to be rendered.
+            layout_name (str): Name of layout.
+        """
+        with self._lock:
+            layout = self[layout_name]
+            region, _lines = self._render_map[layout]
+            (x, y, width, height) = region
+            lines = console.render_lines(
+                layout, console.options.update_dimensions(width, height)
+            )
+            self._render_map[layout] = LayoutRender(region, lines)
+            console.update_screen_lines(lines, x, y)
+
+    def _make_region_map(self, width: int, height: int) -> RegionMap:
+        """Create a dict that maps layout on to Region."""
+        stack: List[Tuple[Layout, Region]] = [(self, Region(0, 0, width, height))]
+        push = stack.append
+        pop = stack.pop
+        layout_regions: List[Tuple[Layout, Region]] = []
+        append_layout_region = layout_regions.append
+        while stack:
+            append_layout_region(pop())
+            layout, region = layout_regions[-1]
+            children = layout.children
+            if children:
+                for child_and_region in layout.splitter.divide(children, region):
+                    push(child_and_region)
+
+        region_map = {
+            layout: region
+            for layout, region in sorted(layout_regions, key=itemgetter(1))
+        }
+        return region_map
+
+    def render(self, console: Console, options: ConsoleOptions) -> RenderMap:
+        """Render the sub_layouts.
+
+        Args:
+            console (Console): Console instance.
+            options (ConsoleOptions): Console options.
+
+        Returns:
+            RenderMap: A dict that maps Layout on to a tuple of Region, lines
+        """
+        render_width = options.max_width
+        render_height = options.height or console.height
+        region_map = self._make_region_map(render_width, render_height)
+        layout_regions = [
+            (layout, region)
+            for layout, region in region_map.items()
+            if not layout.children
+        ]
+        render_map: Dict["Layout", "LayoutRender"] = {}
+        render_lines = console.render_lines
+        update_dimensions = options.update_dimensions
+
+        for layout, region in layout_regions:
+            lines = render_lines(
+                layout.renderable, update_dimensions(region.width, region.height)
+            )
+            render_map[layout] = LayoutRender(region, lines)
+        return render_map
+
+    def __rich_console__(
+        self, console: Console, options: ConsoleOptions
+    ) -> RenderResult:
+        with self._lock:
+            width = options.max_width or console.width
+            height = options.height or console.height
+            render_map = self.render(console, options.update_dimensions(width, height))
+            self._render_map = render_map
+            layout_lines: List[List[Segment]] = [[] for _ in range(height)]
+            _islice = islice
+            for region, lines in render_map.values():
+                _x, y, _layout_width, layout_height = region
+                for row, line in zip(
+                    _islice(layout_lines, y, y + layout_height), lines
+                ):
+                    row.extend(line)
+
+            new_line = Segment.line()
+            for layout_row in layout_lines:
+                yield from layout_row
+                yield new_line
+
+
+if __name__ == "__main__":
+    from pip._vendor.rich.console import Console
+
+    console = Console()
+    layout = Layout()
+
+    layout.split_column(
+        Layout(name="header", size=3),
+        Layout(ratio=1, name="main"),
+        Layout(size=10, name="footer"),
+    )
+
+    layout["main"].split_row(Layout(name="side"), Layout(name="body", ratio=2))
+
+    layout["body"].split_row(Layout(name="content", ratio=2), Layout(name="s2"))
+
+    layout["s2"].split_column(
+        Layout(name="top"), Layout(name="middle"), Layout(name="bottom")
+    )
+
+    layout["side"].split_column(Layout(layout.tree, name="left1"), Layout(name="left2"))
+
+    layout["content"].update("foo")
+
+    console.print(layout)
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/live.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/live.py
new file mode 100644
index 0000000..8738cf0
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/live.py
@@ -0,0 +1,375 @@
+import sys
+from threading import Event, RLock, Thread
+from types import TracebackType
+from typing import IO, Any, Callable, List, Optional, TextIO, Type, cast
+
+from . import get_console
+from .console import Console, ConsoleRenderable, RenderableType, RenderHook
+from .control import Control
+from .file_proxy import FileProxy
+from .jupyter import JupyterMixin
+from .live_render import LiveRender, VerticalOverflowMethod
+from .screen import Screen
+from .text import Text
+
+
+class _RefreshThread(Thread):
+    """A thread that calls refresh() at regular intervals."""
+
+    def __init__(self, live: "Live", refresh_per_second: float) -> None:
+        self.live = live
+        self.refresh_per_second = refresh_per_second
+        self.done = Event()
+        super().__init__(daemon=True)
+
+    def stop(self) -> None:
+        self.done.set()
+
+    def run(self) -> None:
+        while not self.done.wait(1 / self.refresh_per_second):
+            with self.live._lock:
+                if not self.done.is_set():
+                    self.live.refresh()
+
+
+class Live(JupyterMixin, RenderHook):
+    """Renders an auto-updating live display of any given renderable.
+
+    Args:
+        renderable (RenderableType, optional): The renderable to live display. Defaults to displaying nothing.
+        console (Console, optional): Optional Console instance. Defaults to an internal Console instance writing to stdout.
+        screen (bool, optional): Enable alternate screen mode. Defaults to False.
+        auto_refresh (bool, optional): Enable auto refresh. If disabled, you will need to call `refresh()` or `update()` with refresh flag. Defaults to True
+        refresh_per_second (float, optional): Number of times per second to refresh the live display. Defaults to 4.
+        transient (bool, optional): Clear the renderable on exit (has no effect when screen=True). Defaults to False.
+        redirect_stdout (bool, optional): Enable redirection of stdout, so ``print`` may be used. Defaults to True.
+        redirect_stderr (bool, optional): Enable redirection of stderr. Defaults to True.
+        vertical_overflow (VerticalOverflowMethod, optional): How to handle renderable when it is too tall for the console. Defaults to "ellipsis".
+        get_renderable (Callable[[], RenderableType], optional): Optional callable to get renderable. Defaults to None.
+    """
+
+    def __init__(
+        self,
+        renderable: Optional[RenderableType] = None,
+        *,
+        console: Optional[Console] = None,
+        screen: bool = False,
+        auto_refresh: bool = True,
+        refresh_per_second: float = 4,
+        transient: bool = False,
+        redirect_stdout: bool = True,
+        redirect_stderr: bool = True,
+        vertical_overflow: VerticalOverflowMethod = "ellipsis",
+        get_renderable: Optional[Callable[[], RenderableType]] = None,
+    ) -> None:
+        assert refresh_per_second > 0, "refresh_per_second must be > 0"
+        self._renderable = renderable
+        self.console = console if console is not None else get_console()
+        self._screen = screen
+        self._alt_screen = False
+
+        self._redirect_stdout = redirect_stdout
+        self._redirect_stderr = redirect_stderr
+        self._restore_stdout: Optional[IO[str]] = None
+        self._restore_stderr: Optional[IO[str]] = None
+
+        self._lock = RLock()
+        self.ipy_widget: Optional[Any] = None
+        self.auto_refresh = auto_refresh
+        self._started: bool = False
+        self.transient = True if screen else transient
+
+        self._refresh_thread: Optional[_RefreshThread] = None
+        self.refresh_per_second = refresh_per_second
+
+        self.vertical_overflow = vertical_overflow
+        self._get_renderable = get_renderable
+        self._live_render = LiveRender(
+            self.get_renderable(), vertical_overflow=vertical_overflow
+        )
+
+    @property
+    def is_started(self) -> bool:
+        """Check if live display has been started."""
+        return self._started
+
+    def get_renderable(self) -> RenderableType:
+        renderable = (
+            self._get_renderable()
+            if self._get_renderable is not None
+            else self._renderable
+        )
+        return renderable or ""
+
+    def start(self, refresh: bool = False) -> None:
+        """Start live rendering display.
+
+        Args:
+            refresh (bool, optional): Also refresh. Defaults to False.
+        """
+        with self._lock:
+            if self._started:
+                return
+            self.console.set_live(self)
+            self._started = True
+            if self._screen:
+                self._alt_screen = self.console.set_alt_screen(True)
+            self.console.show_cursor(False)
+            self._enable_redirect_io()
+            self.console.push_render_hook(self)
+            if refresh:
+                try:
+                    self.refresh()
+                except Exception:
+                    # If refresh fails, we want to stop the redirection of sys.stderr,
+                    # so the error stacktrace is properly displayed in the terminal.
+                    # (or, if the code that calls Rich captures the exception and wants to display something,
+                    # let this be displayed in the terminal).
+                    self.stop()
+                    raise
+            if self.auto_refresh:
+                self._refresh_thread = _RefreshThread(self, self.refresh_per_second)
+                self._refresh_thread.start()
+
+    def stop(self) -> None:
+        """Stop live rendering display."""
+        with self._lock:
+            if not self._started:
+                return
+            self.console.clear_live()
+            self._started = False
+
+            if self.auto_refresh and self._refresh_thread is not None:
+                self._refresh_thread.stop()
+                self._refresh_thread = None
+            # allow it to fully render on the last even if overflow
+            self.vertical_overflow = "visible"
+            with self.console:
+                try:
+                    if not self._alt_screen and not self.console.is_jupyter:
+                        self.refresh()
+                finally:
+                    self._disable_redirect_io()
+                    self.console.pop_render_hook()
+                    if not self._alt_screen and self.console.is_terminal:
+                        self.console.line()
+                    self.console.show_cursor(True)
+                    if self._alt_screen:
+                        self.console.set_alt_screen(False)
+
+                    if self.transient and not self._alt_screen:
+                        self.console.control(self._live_render.restore_cursor())
+                    if self.ipy_widget is not None and self.transient:
+                        self.ipy_widget.close()  # pragma: no cover
+
+    def __enter__(self) -> "Live":
+        self.start(refresh=self._renderable is not None)
+        return self
+
+    def __exit__(
+        self,
+        exc_type: Optional[Type[BaseException]],
+        exc_val: Optional[BaseException],
+        exc_tb: Optional[TracebackType],
+    ) -> None:
+        self.stop()
+
+    def _enable_redirect_io(self) -> None:
+        """Enable redirecting of stdout / stderr."""
+        if self.console.is_terminal or self.console.is_jupyter:
+            if self._redirect_stdout and not isinstance(sys.stdout, FileProxy):
+                self._restore_stdout = sys.stdout
+                sys.stdout = cast("TextIO", FileProxy(self.console, sys.stdout))
+            if self._redirect_stderr and not isinstance(sys.stderr, FileProxy):
+                self._restore_stderr = sys.stderr
+                sys.stderr = cast("TextIO", FileProxy(self.console, sys.stderr))
+
+    def _disable_redirect_io(self) -> None:
+        """Disable redirecting of stdout / stderr."""
+        if self._restore_stdout:
+            sys.stdout = cast("TextIO", self._restore_stdout)
+            self._restore_stdout = None
+        if self._restore_stderr:
+            sys.stderr = cast("TextIO", self._restore_stderr)
+            self._restore_stderr = None
+
+    @property
+    def renderable(self) -> RenderableType:
+        """Get the renderable that is being displayed
+
+        Returns:
+            RenderableType: Displayed renderable.
+        """
+        renderable = self.get_renderable()
+        return Screen(renderable) if self._alt_screen else renderable
+
+    def update(self, renderable: RenderableType, *, refresh: bool = False) -> None:
+        """Update the renderable that is being displayed
+
+        Args:
+            renderable (RenderableType): New renderable to use.
+            refresh (bool, optional): Refresh the display. Defaults to False.
+        """
+        if isinstance(renderable, str):
+            renderable = self.console.render_str(renderable)
+        with self._lock:
+            self._renderable = renderable
+            if refresh:
+                self.refresh()
+
+    def refresh(self) -> None:
+        """Update the display of the Live Render."""
+        with self._lock:
+            self._live_render.set_renderable(self.renderable)
+            if self.console.is_jupyter:  # pragma: no cover
+                try:
+                    from IPython.display import display
+                    from ipywidgets import Output
+                except ImportError:
+                    import warnings
+
+                    warnings.warn('install "ipywidgets" for Jupyter support')
+                else:
+                    if self.ipy_widget is None:
+                        self.ipy_widget = Output()
+                        display(self.ipy_widget)
+
+                    with self.ipy_widget:
+                        self.ipy_widget.clear_output(wait=True)
+                        self.console.print(self._live_render.renderable)
+            elif self.console.is_terminal and not self.console.is_dumb_terminal:
+                with self.console:
+                    self.console.print(Control())
+            elif (
+                not self._started and not self.transient
+            ):  # if it is finished allow files or dumb-terminals to see final result
+                with self.console:
+                    self.console.print(Control())
+
+    def process_renderables(
+        self, renderables: List[ConsoleRenderable]
+    ) -> List[ConsoleRenderable]:
+        """Process renderables to restore cursor and display progress."""
+        self._live_render.vertical_overflow = self.vertical_overflow
+        if self.console.is_interactive:
+            # lock needs acquiring as user can modify live_render renderable at any time unlike in Progress.
+            with self._lock:
+                reset = (
+                    Control.home()
+                    if self._alt_screen
+                    else self._live_render.position_cursor()
+                )
+                renderables = [reset, *renderables, self._live_render]
+        elif (
+            not self._started and not self.transient
+        ):  # if it is finished render the final output for files or dumb_terminals
+            renderables = [*renderables, self._live_render]
+
+        return renderables
+
+
+if __name__ == "__main__":  # pragma: no cover
+    import random
+    import time
+    from itertools import cycle
+    from typing import Dict, List, Tuple
+
+    from .align import Align
+    from .console import Console
+    from .live import Live as Live
+    from .panel import Panel
+    from .rule import Rule
+    from .syntax import Syntax
+    from .table import Table
+
+    console = Console()
+
+    syntax = Syntax(
+        '''def loop_last(values: Iterable[T]) -> Iterable[Tuple[bool, T]]:
+    """Iterate and generate a tuple with a flag for last value."""
+    iter_values = iter(values)
+    try:
+        previous_value = next(iter_values)
+    except StopIteration:
+        return
+    for value in iter_values:
+        yield False, previous_value
+        previous_value = value
+    yield True, previous_value''',
+        "python",
+        line_numbers=True,
+    )
+
+    table = Table("foo", "bar", "baz")
+    table.add_row("1", "2", "3")
+
+    progress_renderables = [
+        "You can make the terminal shorter and taller to see the live table hide"
+        "Text may be printed while the progress bars are rendering.",
+        Panel("In fact, [i]any[/i] renderable will work"),
+        "Such as [magenta]tables[/]...",
+        table,
+        "Pretty printed structures...",
+        {"type": "example", "text": "Pretty printed"},
+        "Syntax...",
+        syntax,
+        Rule("Give it a try!"),
+    ]
+
+    examples = cycle(progress_renderables)
+
+    exchanges = [
+        "SGD",
+        "MYR",
+        "EUR",
+        "USD",
+        "AUD",
+        "JPY",
+        "CNH",
+        "HKD",
+        "CAD",
+        "INR",
+        "DKK",
+        "GBP",
+        "RUB",
+        "NZD",
+        "MXN",
+        "IDR",
+        "TWD",
+        "THB",
+        "VND",
+    ]
+    with Live(console=console) as live_table:
+        exchange_rate_dict: Dict[Tuple[str, str], float] = {}
+
+        for index in range(100):
+            select_exchange = exchanges[index % len(exchanges)]
+
+            for exchange in exchanges:
+                if exchange == select_exchange:
+                    continue
+                time.sleep(0.4)
+                if random.randint(0, 10) < 1:
+                    console.log(next(examples))
+                exchange_rate_dict[(select_exchange, exchange)] = 200 / (
+                    (random.random() * 320) + 1
+                )
+                if len(exchange_rate_dict) > len(exchanges) - 1:
+                    exchange_rate_dict.pop(list(exchange_rate_dict.keys())[0])
+                table = Table(title="Exchange Rates")
+
+                table.add_column("Source Currency")
+                table.add_column("Destination Currency")
+                table.add_column("Exchange Rate")
+
+                for (source, dest), exchange_rate in exchange_rate_dict.items():
+                    table.add_row(
+                        source,
+                        dest,
+                        Text(
+                            f"{exchange_rate:.4f}",
+                            style="red" if exchange_rate < 1.0 else "green",
+                        ),
+                    )
+
+                live_table.update(Align.center(table))
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/live_render.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/live_render.py
new file mode 100644
index 0000000..e20745d
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/live_render.py
@@ -0,0 +1,112 @@
+import sys
+from typing import Optional, Tuple
+
+if sys.version_info >= (3, 8):
+    from typing import Literal
+else:
+    from pip._vendor.typing_extensions import Literal  # pragma: no cover
+
+
+from ._loop import loop_last
+from .console import Console, ConsoleOptions, RenderableType, RenderResult
+from .control import Control
+from .segment import ControlType, Segment
+from .style import StyleType
+from .text import Text
+
+VerticalOverflowMethod = Literal["crop", "ellipsis", "visible"]
+
+
+class LiveRender:
+    """Creates a renderable that may be updated.
+
+    Args:
+        renderable (RenderableType): Any renderable object.
+        style (StyleType, optional): An optional style to apply to the renderable. Defaults to "".
+    """
+
+    def __init__(
+        self,
+        renderable: RenderableType,
+        style: StyleType = "",
+        vertical_overflow: VerticalOverflowMethod = "ellipsis",
+    ) -> None:
+        self.renderable = renderable
+        self.style = style
+        self.vertical_overflow = vertical_overflow
+        self._shape: Optional[Tuple[int, int]] = None
+
+    def set_renderable(self, renderable: RenderableType) -> None:
+        """Set a new renderable.
+
+        Args:
+            renderable (RenderableType): Any renderable object, including str.
+        """
+        self.renderable = renderable
+
+    def position_cursor(self) -> Control:
+        """Get control codes to move cursor to beginning of live render.
+
+        Returns:
+            Control: A control instance that may be printed.
+        """
+        if self._shape is not None:
+            _, height = self._shape
+            return Control(
+                ControlType.CARRIAGE_RETURN,
+                (ControlType.ERASE_IN_LINE, 2),
+                *(
+                    (
+                        (ControlType.CURSOR_UP, 1),
+                        (ControlType.ERASE_IN_LINE, 2),
+                    )
+                    * (height - 1)
+                )
+            )
+        return Control()
+
+    def restore_cursor(self) -> Control:
+        """Get control codes to clear the render and restore the cursor to its previous position.
+
+        Returns:
+            Control: A Control instance that may be printed.
+        """
+        if self._shape is not None:
+            _, height = self._shape
+            return Control(
+                ControlType.CARRIAGE_RETURN,
+                *((ControlType.CURSOR_UP, 1), (ControlType.ERASE_IN_LINE, 2)) * height
+            )
+        return Control()
+
+    def __rich_console__(
+        self, console: Console, options: ConsoleOptions
+    ) -> RenderResult:
+        renderable = self.renderable
+        style = console.get_style(self.style)
+        lines = console.render_lines(renderable, options, style=style, pad=False)
+        shape = Segment.get_shape(lines)
+
+        _, height = shape
+        if height > options.size.height:
+            if self.vertical_overflow == "crop":
+                lines = lines[: options.size.height]
+                shape = Segment.get_shape(lines)
+            elif self.vertical_overflow == "ellipsis":
+                lines = lines[: (options.size.height - 1)]
+                overflow_text = Text(
+                    "...",
+                    overflow="crop",
+                    justify="center",
+                    end="",
+                    style="live.ellipsis",
+                )
+                lines.append(list(console.render(overflow_text)))
+                shape = Segment.get_shape(lines)
+        self._shape = shape
+
+        new_line = Segment.line()
+        for last, line in loop_last(lines):
+            yield from line
+            if not last:
+                yield new_line
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/logging.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/logging.py
new file mode 100644
index 0000000..ff8d5d9
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/logging.py
@@ -0,0 +1,297 @@
+import logging
+from datetime import datetime
+from logging import Handler, LogRecord
+from pathlib import Path
+from types import ModuleType
+from typing import ClassVar, Iterable, List, Optional, Type, Union
+
+from pip._vendor.rich._null_file import NullFile
+
+from . import get_console
+from ._log_render import FormatTimeCallable, LogRender
+from .console import Console, ConsoleRenderable
+from .highlighter import Highlighter, ReprHighlighter
+from .text import Text
+from .traceback import Traceback
+
+
+class RichHandler(Handler):
+    """A logging handler that renders output with Rich. The time / level / message and file are displayed in columns.
+    The level is color coded, and the message is syntax highlighted.
+
+    Note:
+        Be careful when enabling console markup in log messages if you have configured logging for libraries not
+        under your control. If a dependency writes messages containing square brackets, it may not produce the intended output.
+
+    Args:
+        level (Union[int, str], optional): Log level. Defaults to logging.NOTSET.
+        console (:class:`~rich.console.Console`, optional): Optional console instance to write logs.
+            Default will use a global console instance writing to stdout.
+        show_time (bool, optional): Show a column for the time. Defaults to True.
+        omit_repeated_times (bool, optional): Omit repetition of the same time. Defaults to True.
+        show_level (bool, optional): Show a column for the level. Defaults to True.
+        show_path (bool, optional): Show the path to the original log call. Defaults to True.
+        enable_link_path (bool, optional): Enable terminal link of path column to file. Defaults to True.
+        highlighter (Highlighter, optional): Highlighter to style log messages, or None to use ReprHighlighter. Defaults to None.
+        markup (bool, optional): Enable console markup in log messages. Defaults to False.
+        rich_tracebacks (bool, optional): Enable rich tracebacks with syntax highlighting and formatting. Defaults to False.
+        tracebacks_width (Optional[int], optional): Number of characters used to render tracebacks, or None for full width. Defaults to None.
+        tracebacks_code_width (int, optional): Number of code characters used to render tracebacks, or None for full width. Defaults to 88.
+        tracebacks_extra_lines (int, optional): Additional lines of code to render tracebacks, or None for full width. Defaults to None.
+        tracebacks_theme (str, optional): Override pygments theme used in traceback.
+        tracebacks_word_wrap (bool, optional): Enable word wrapping of long tracebacks lines. Defaults to True.
+        tracebacks_show_locals (bool, optional): Enable display of locals in tracebacks. Defaults to False.
+        tracebacks_suppress (Sequence[Union[str, ModuleType]]): Optional sequence of modules or paths to exclude from traceback.
+        tracebacks_max_frames (int, optional): Optional maximum number of frames returned by traceback.
+        locals_max_length (int, optional): Maximum length of containers before abbreviating, or None for no abbreviation.
+            Defaults to 10.
+        locals_max_string (int, optional): Maximum length of string before truncating, or None to disable. Defaults to 80.
+        log_time_format (Union[str, TimeFormatterCallable], optional): If ``log_time`` is enabled, either string for strftime or callable that formats the time. Defaults to "[%x %X] ".
+        keywords (List[str], optional): List of words to highlight instead of ``RichHandler.KEYWORDS``.
+    """
+
+    KEYWORDS: ClassVar[Optional[List[str]]] = [
+        "GET",
+        "POST",
+        "HEAD",
+        "PUT",
+        "DELETE",
+        "OPTIONS",
+        "TRACE",
+        "PATCH",
+    ]
+    HIGHLIGHTER_CLASS: ClassVar[Type[Highlighter]] = ReprHighlighter
+
+    def __init__(
+        self,
+        level: Union[int, str] = logging.NOTSET,
+        console: Optional[Console] = None,
+        *,
+        show_time: bool = True,
+        omit_repeated_times: bool = True,
+        show_level: bool = True,
+        show_path: bool = True,
+        enable_link_path: bool = True,
+        highlighter: Optional[Highlighter] = None,
+        markup: bool = False,
+        rich_tracebacks: bool = False,
+        tracebacks_width: Optional[int] = None,
+        tracebacks_code_width: int = 88,
+        tracebacks_extra_lines: int = 3,
+        tracebacks_theme: Optional[str] = None,
+        tracebacks_word_wrap: bool = True,
+        tracebacks_show_locals: bool = False,
+        tracebacks_suppress: Iterable[Union[str, ModuleType]] = (),
+        tracebacks_max_frames: int = 100,
+        locals_max_length: int = 10,
+        locals_max_string: int = 80,
+        log_time_format: Union[str, FormatTimeCallable] = "[%x %X]",
+        keywords: Optional[List[str]] = None,
+    ) -> None:
+        super().__init__(level=level)
+        self.console = console or get_console()
+        self.highlighter = highlighter or self.HIGHLIGHTER_CLASS()
+        self._log_render = LogRender(
+            show_time=show_time,
+            show_level=show_level,
+            show_path=show_path,
+            time_format=log_time_format,
+            omit_repeated_times=omit_repeated_times,
+            level_width=None,
+        )
+        self.enable_link_path = enable_link_path
+        self.markup = markup
+        self.rich_tracebacks = rich_tracebacks
+        self.tracebacks_width = tracebacks_width
+        self.tracebacks_extra_lines = tracebacks_extra_lines
+        self.tracebacks_theme = tracebacks_theme
+        self.tracebacks_word_wrap = tracebacks_word_wrap
+        self.tracebacks_show_locals = tracebacks_show_locals
+        self.tracebacks_suppress = tracebacks_suppress
+        self.tracebacks_max_frames = tracebacks_max_frames
+        self.tracebacks_code_width = tracebacks_code_width
+        self.locals_max_length = locals_max_length
+        self.locals_max_string = locals_max_string
+        self.keywords = keywords
+
+    def get_level_text(self, record: LogRecord) -> Text:
+        """Get the level name from the record.
+
+        Args:
+            record (LogRecord): LogRecord instance.
+
+        Returns:
+            Text: A tuple of the style and level name.
+        """
+        level_name = record.levelname
+        level_text = Text.styled(
+            level_name.ljust(8), f"logging.level.{level_name.lower()}"
+        )
+        return level_text
+
+    def emit(self, record: LogRecord) -> None:
+        """Invoked by logging."""
+        message = self.format(record)
+        traceback = None
+        if (
+            self.rich_tracebacks
+            and record.exc_info
+            and record.exc_info != (None, None, None)
+        ):
+            exc_type, exc_value, exc_traceback = record.exc_info
+            assert exc_type is not None
+            assert exc_value is not None
+            traceback = Traceback.from_exception(
+                exc_type,
+                exc_value,
+                exc_traceback,
+                width=self.tracebacks_width,
+                code_width=self.tracebacks_code_width,
+                extra_lines=self.tracebacks_extra_lines,
+                theme=self.tracebacks_theme,
+                word_wrap=self.tracebacks_word_wrap,
+                show_locals=self.tracebacks_show_locals,
+                locals_max_length=self.locals_max_length,
+                locals_max_string=self.locals_max_string,
+                suppress=self.tracebacks_suppress,
+                max_frames=self.tracebacks_max_frames,
+            )
+            message = record.getMessage()
+            if self.formatter:
+                record.message = record.getMessage()
+                formatter = self.formatter
+                if hasattr(formatter, "usesTime") and formatter.usesTime():
+                    record.asctime = formatter.formatTime(record, formatter.datefmt)
+                message = formatter.formatMessage(record)
+
+        message_renderable = self.render_message(record, message)
+        log_renderable = self.render(
+            record=record, traceback=traceback, message_renderable=message_renderable
+        )
+        if isinstance(self.console.file, NullFile):
+            # Handles pythonw, where stdout/stderr are null, and we return NullFile
+            # instance from Console.file. In this case, we still want to make a log record
+            # even though we won't be writing anything to a file.
+            self.handleError(record)
+        else:
+            try:
+                self.console.print(log_renderable)
+            except Exception:
+                self.handleError(record)
+
+    def render_message(self, record: LogRecord, message: str) -> "ConsoleRenderable":
+        """Render message text in to Text.
+
+        Args:
+            record (LogRecord): logging Record.
+            message (str): String containing log message.
+
+        Returns:
+            ConsoleRenderable: Renderable to display log message.
+        """
+        use_markup = getattr(record, "markup", self.markup)
+        message_text = Text.from_markup(message) if use_markup else Text(message)
+
+        highlighter = getattr(record, "highlighter", self.highlighter)
+        if highlighter:
+            message_text = highlighter(message_text)
+
+        if self.keywords is None:
+            self.keywords = self.KEYWORDS
+
+        if self.keywords:
+            message_text.highlight_words(self.keywords, "logging.keyword")
+
+        return message_text
+
+    def render(
+        self,
+        *,
+        record: LogRecord,
+        traceback: Optional[Traceback],
+        message_renderable: "ConsoleRenderable",
+    ) -> "ConsoleRenderable":
+        """Render log for display.
+
+        Args:
+            record (LogRecord): logging Record.
+            traceback (Optional[Traceback]): Traceback instance or None for no Traceback.
+            message_renderable (ConsoleRenderable): Renderable (typically Text) containing log message contents.
+
+        Returns:
+            ConsoleRenderable: Renderable to display log.
+        """
+        path = Path(record.pathname).name
+        level = self.get_level_text(record)
+        time_format = None if self.formatter is None else self.formatter.datefmt
+        log_time = datetime.fromtimestamp(record.created)
+
+        log_renderable = self._log_render(
+            self.console,
+            [message_renderable] if not traceback else [message_renderable, traceback],
+            log_time=log_time,
+            time_format=time_format,
+            level=level,
+            path=path,
+            line_no=record.lineno,
+            link_path=record.pathname if self.enable_link_path else None,
+        )
+        return log_renderable
+
+
+if __name__ == "__main__":  # pragma: no cover
+    from time import sleep
+
+    FORMAT = "%(message)s"
+    # FORMAT = "%(asctime)-15s - %(levelname)s - %(message)s"
+    logging.basicConfig(
+        level="NOTSET",
+        format=FORMAT,
+        datefmt="[%X]",
+        handlers=[RichHandler(rich_tracebacks=True, tracebacks_show_locals=True)],
+    )
+    log = logging.getLogger("rich")
+
+    log.info("Server starting...")
+    log.info("Listening on http://127.0.0.1:8080")
+    sleep(1)
+
+    log.info("GET /index.html 200 1298")
+    log.info("GET /imgs/backgrounds/back1.jpg 200 54386")
+    log.info("GET /css/styles.css 200 54386")
+    log.warning("GET /favicon.ico 404 242")
+    sleep(1)
+
+    log.debug(
+        "JSONRPC request\n--> %r\n<-- %r",
+        {
+            "version": "1.1",
+            "method": "confirmFruitPurchase",
+            "params": [["apple", "orange", "mangoes", "pomelo"], 1.123],
+            "id": "194521489",
+        },
+        {"version": "1.1", "result": True, "error": None, "id": "194521489"},
+    )
+    log.debug(
+        "Loading configuration file /adasd/asdasd/qeqwe/qwrqwrqwr/sdgsdgsdg/werwerwer/dfgerert/ertertert/ertetert/werwerwer"
+    )
+    log.error("Unable to find 'pomelo' in database!")
+    log.info("POST /jsonrpc/ 200 65532")
+    log.info("POST /admin/ 401 42234")
+    log.warning("password was rejected for admin site.")
+
+    def divide() -> None:
+        number = 1
+        divisor = 0
+        foos = ["foo"] * 100
+        log.debug("in divide")
+        try:
+            number / divisor
+        except:
+            log.exception("An error of some kind occurred!")
+
+    divide()
+    sleep(1)
+    log.critical("Out of memory!")
+    log.info("Server exited with code=-1")
+    log.info("[bold]EXITING...[/bold]", extra=dict(markup=True))
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/markup.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/markup.py
new file mode 100644
index 0000000..f617187
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/markup.py
@@ -0,0 +1,251 @@
+import re
+from ast import literal_eval
+from operator import attrgetter
+from typing import Callable, Iterable, List, Match, NamedTuple, Optional, Tuple, Union
+
+from ._emoji_replace import _emoji_replace
+from .emoji import EmojiVariant
+from .errors import MarkupError
+from .style import Style
+from .text import Span, Text
+
+RE_TAGS = re.compile(
+    r"""((\\*)\[([a-z#/@][^[]*?)])""",
+    re.VERBOSE,
+)
+
+RE_HANDLER = re.compile(r"^([\w.]*?)(\(.*?\))?$")
+
+
+class Tag(NamedTuple):
+    """A tag in console markup."""
+
+    name: str
+    """The tag name. e.g. 'bold'."""
+    parameters: Optional[str]
+    """Any additional parameters after the name."""
+
+    def __str__(self) -> str:
+        return (
+            self.name if self.parameters is None else f"{self.name} {self.parameters}"
+        )
+
+    @property
+    def markup(self) -> str:
+        """Get the string representation of this tag."""
+        return (
+            f"[{self.name}]"
+            if self.parameters is None
+            else f"[{self.name}={self.parameters}]"
+        )
+
+
+_ReStringMatch = Match[str]  # regex match object
+_ReSubCallable = Callable[[_ReStringMatch], str]  # Callable invoked by re.sub
+_EscapeSubMethod = Callable[[_ReSubCallable, str], str]  # Sub method of a compiled re
+
+
+def escape(
+    markup: str,
+    _escape: _EscapeSubMethod = re.compile(r"(\\*)(\[[a-z#/@][^[]*?])").sub,
+) -> str:
+    """Escapes text so that it won't be interpreted as markup.
+
+    Args:
+        markup (str): Content to be inserted in to markup.
+
+    Returns:
+        str: Markup with square brackets escaped.
+    """
+
+    def escape_backslashes(match: Match[str]) -> str:
+        """Called by re.sub replace matches."""
+        backslashes, text = match.groups()
+        return f"{backslashes}{backslashes}\\{text}"
+
+    markup = _escape(escape_backslashes, markup)
+    if markup.endswith("\\") and not markup.endswith("\\\\"):
+        return markup + "\\"
+
+    return markup
+
+
+def _parse(markup: str) -> Iterable[Tuple[int, Optional[str], Optional[Tag]]]:
+    """Parse markup in to an iterable of tuples of (position, text, tag).
+
+    Args:
+        markup (str): A string containing console markup
+
+    """
+    position = 0
+    _divmod = divmod
+    _Tag = Tag
+    for match in RE_TAGS.finditer(markup):
+        full_text, escapes, tag_text = match.groups()
+        start, end = match.span()
+        if start > position:
+            yield start, markup[position:start], None
+        if escapes:
+            backslashes, escaped = _divmod(len(escapes), 2)
+            if backslashes:
+                # Literal backslashes
+                yield start, "\\" * backslashes, None
+                start += backslashes * 2
+            if escaped:
+                # Escape of tag
+                yield start, full_text[len(escapes) :], None
+                position = end
+                continue
+        text, equals, parameters = tag_text.partition("=")
+        yield start, None, _Tag(text, parameters if equals else None)
+        position = end
+    if position < len(markup):
+        yield position, markup[position:], None
+
+
+def render(
+    markup: str,
+    style: Union[str, Style] = "",
+    emoji: bool = True,
+    emoji_variant: Optional[EmojiVariant] = None,
+) -> Text:
+    """Render console markup in to a Text instance.
+
+    Args:
+        markup (str): A string containing console markup.
+        style: (Union[str, Style]): The style to use.
+        emoji (bool, optional): Also render emoji code. Defaults to True.
+        emoji_variant (str, optional): Optional emoji variant, either "text" or "emoji". Defaults to None.
+
+
+    Raises:
+        MarkupError: If there is a syntax error in the markup.
+
+    Returns:
+        Text: A test instance.
+    """
+    emoji_replace = _emoji_replace
+    if "[" not in markup:
+        return Text(
+            emoji_replace(markup, default_variant=emoji_variant) if emoji else markup,
+            style=style,
+        )
+    text = Text(style=style)
+    append = text.append
+    normalize = Style.normalize
+
+    style_stack: List[Tuple[int, Tag]] = []
+    pop = style_stack.pop
+
+    spans: List[Span] = []
+    append_span = spans.append
+
+    _Span = Span
+    _Tag = Tag
+
+    def pop_style(style_name: str) -> Tuple[int, Tag]:
+        """Pop tag matching given style name."""
+        for index, (_, tag) in enumerate(reversed(style_stack), 1):
+            if tag.name == style_name:
+                return pop(-index)
+        raise KeyError(style_name)
+
+    for position, plain_text, tag in _parse(markup):
+        if plain_text is not None:
+            # Handle open brace escapes, where the brace is not part of a tag.
+            plain_text = plain_text.replace("\\[", "[")
+            append(emoji_replace(plain_text) if emoji else plain_text)
+        elif tag is not None:
+            if tag.name.startswith("/"):  # Closing tag
+                style_name = tag.name[1:].strip()
+
+                if style_name:  # explicit close
+                    style_name = normalize(style_name)
+                    try:
+                        start, open_tag = pop_style(style_name)
+                    except KeyError:
+                        raise MarkupError(
+                            f"closing tag '{tag.markup}' at position {position} doesn't match any open tag"
+                        ) from None
+                else:  # implicit close
+                    try:
+                        start, open_tag = pop()
+                    except IndexError:
+                        raise MarkupError(
+                            f"closing tag '[/]' at position {position} has nothing to close"
+                        ) from None
+
+                if open_tag.name.startswith("@"):
+                    if open_tag.parameters:
+                        handler_name = ""
+                        parameters = open_tag.parameters.strip()
+                        handler_match = RE_HANDLER.match(parameters)
+                        if handler_match is not None:
+                            handler_name, match_parameters = handler_match.groups()
+                            parameters = (
+                                "()" if match_parameters is None else match_parameters
+                            )
+
+                        try:
+                            meta_params = literal_eval(parameters)
+                        except SyntaxError as error:
+                            raise MarkupError(
+                                f"error parsing {parameters!r} in {open_tag.parameters!r}; {error.msg}"
+                            )
+                        except Exception as error:
+                            raise MarkupError(
+                                f"error parsing {open_tag.parameters!r}; {error}"
+                            ) from None
+
+                        if handler_name:
+                            meta_params = (
+                                handler_name,
+                                meta_params
+                                if isinstance(meta_params, tuple)
+                                else (meta_params,),
+                            )
+
+                    else:
+                        meta_params = ()
+
+                    append_span(
+                        _Span(
+                            start, len(text), Style(meta={open_tag.name: meta_params})
+                        )
+                    )
+                else:
+                    append_span(_Span(start, len(text), str(open_tag)))
+
+            else:  # Opening tag
+                normalized_tag = _Tag(normalize(tag.name), tag.parameters)
+                style_stack.append((len(text), normalized_tag))
+
+    text_length = len(text)
+    while style_stack:
+        start, tag = style_stack.pop()
+        style = str(tag)
+        if style:
+            append_span(_Span(start, text_length, style))
+
+    text.spans = sorted(spans[::-1], key=attrgetter("start"))
+    return text
+
+
+if __name__ == "__main__":  # pragma: no cover
+    MARKUP = [
+        "[red]Hello World[/red]",
+        "[magenta]Hello [b]World[/b]",
+        "[bold]Bold[italic] bold and italic [/bold]italic[/italic]",
+        "Click [link=https://www.willmcgugan.com]here[/link] to visit my Blog",
+        ":warning-emoji: [bold red blink] DANGER![/]",
+    ]
+
+    from pip._vendor.rich import print
+    from pip._vendor.rich.table import Table
+
+    grid = Table("Markup", "Result", padding=(0, 1))
+
+    for markup in MARKUP:
+        grid.add_row(Text(markup), markup)
+
+    print(grid)
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/measure.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/measure.py
new file mode 100644
index 0000000..a508ffa
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/measure.py
@@ -0,0 +1,151 @@
+from operator import itemgetter
+from typing import TYPE_CHECKING, Callable, NamedTuple, Optional, Sequence
+
+from . import errors
+from .protocol import is_renderable, rich_cast
+
+if TYPE_CHECKING:
+    from .console import Console, ConsoleOptions, RenderableType
+
+
+class Measurement(NamedTuple):
+    """Stores the minimum and maximum widths (in characters) required to render an object."""
+
+    minimum: int
+    """Minimum number of cells required to render."""
+    maximum: int
+    """Maximum number of cells required to render."""
+
+    @property
+    def span(self) -> int:
+        """Get difference between maximum and minimum."""
+        return self.maximum - self.minimum
+
+    def normalize(self) -> "Measurement":
+        """Get measurement that ensures that minimum <= maximum and minimum >= 0
+
+        Returns:
+            Measurement: A normalized measurement.
+        """
+        minimum, maximum = self
+        minimum = min(max(0, minimum), maximum)
+        return Measurement(max(0, minimum), max(0, max(minimum, maximum)))
+
+    def with_maximum(self, width: int) -> "Measurement":
+        """Get a RenderableWith where the widths are <= width.
+
+        Args:
+            width (int): Maximum desired width.
+
+        Returns:
+            Measurement: New Measurement object.
+        """
+        minimum, maximum = self
+        return Measurement(min(minimum, width), min(maximum, width))
+
+    def with_minimum(self, width: int) -> "Measurement":
+        """Get a RenderableWith where the widths are >= width.
+
+        Args:
+            width (int): Minimum desired width.
+
+        Returns:
+            Measurement: New Measurement object.
+        """
+        minimum, maximum = self
+        width = max(0, width)
+        return Measurement(max(minimum, width), max(maximum, width))
+
+    def clamp(
+        self, min_width: Optional[int] = None, max_width: Optional[int] = None
+    ) -> "Measurement":
+        """Clamp a measurement within the specified range.
+
+        Args:
+            min_width (int): Minimum desired width, or ``None`` for no minimum. Defaults to None.
+            max_width (int): Maximum desired width, or ``None`` for no maximum. Defaults to None.
+
+        Returns:
+            Measurement: New Measurement object.
+        """
+        measurement = self
+        if min_width is not None:
+            measurement = measurement.with_minimum(min_width)
+        if max_width is not None:
+            measurement = measurement.with_maximum(max_width)
+        return measurement
+
+    @classmethod
+    def get(
+        cls, console: "Console", options: "ConsoleOptions", renderable: "RenderableType"
+    ) -> "Measurement":
+        """Get a measurement for a renderable.
+
+        Args:
+            console (~rich.console.Console): Console instance.
+            options (~rich.console.ConsoleOptions): Console options.
+            renderable (RenderableType): An object that may be rendered with Rich.
+
+        Raises:
+            errors.NotRenderableError: If the object is not renderable.
+
+        Returns:
+            Measurement: Measurement object containing range of character widths required to render the object.
+        """
+        _max_width = options.max_width
+        if _max_width < 1:
+            return Measurement(0, 0)
+        if isinstance(renderable, str):
+            renderable = console.render_str(
+                renderable, markup=options.markup, highlight=False
+            )
+        renderable = rich_cast(renderable)
+        if is_renderable(renderable):
+            get_console_width: Optional[
+                Callable[["Console", "ConsoleOptions"], "Measurement"]
+            ] = getattr(renderable, "__rich_measure__", None)
+            if get_console_width is not None:
+                render_width = (
+                    get_console_width(console, options)
+                    .normalize()
+                    .with_maximum(_max_width)
+                )
+                if render_width.maximum < 1:
+                    return Measurement(0, 0)
+                return render_width.normalize()
+            else:
+                return Measurement(0, _max_width)
+        else:
+            raise errors.NotRenderableError(
+                f"Unable to get render width for {renderable!r}; "
+                "a str, Segment, or object with __rich_console__ method is required"
+            )
+
+
+def measure_renderables(
+    console: "Console",
+    options: "ConsoleOptions",
+    renderables: Sequence["RenderableType"],
+) -> "Measurement":
+    """Get a measurement that would fit a number of renderables.
+
+    Args:
+        console (~rich.console.Console): Console instance.
+        options (~rich.console.ConsoleOptions): Console options.
+        renderables (Iterable[RenderableType]): One or more renderable objects.
+
+    Returns:
+        Measurement: Measurement object containing range of character widths required to
+            contain all given renderables.
+    """
+    if not renderables:
+        return Measurement(0, 0)
+    get_measurement = Measurement.get
+    measurements = [
+        get_measurement(console, options, renderable) for renderable in renderables
+    ]
+    measured_width = Measurement(
+        max(measurements, key=itemgetter(0)).minimum,
+        max(measurements, key=itemgetter(1)).maximum,
+    )
+    return measured_width
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/padding.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/padding.py
new file mode 100644
index 0000000..0161cd1
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/padding.py
@@ -0,0 +1,141 @@
+from typing import TYPE_CHECKING, List, Optional, Tuple, Union
+
+if TYPE_CHECKING:
+    from .console import (
+        Console,
+        ConsoleOptions,
+        RenderableType,
+        RenderResult,
+    )
+
+from .jupyter import JupyterMixin
+from .measure import Measurement
+from .segment import Segment
+from .style import Style
+
+PaddingDimensions = Union[int, Tuple[int], Tuple[int, int], Tuple[int, int, int, int]]
+
+
+class Padding(JupyterMixin):
+    """Draw space around content.
+
+    Example:
+        >>> print(Padding("Hello", (2, 4), style="on blue"))
+
+    Args:
+        renderable (RenderableType): String or other renderable.
+        pad (Union[int, Tuple[int]]): Padding for top, right, bottom, and left borders.
+            May be specified with 1, 2, or 4 integers (CSS style).
+        style (Union[str, Style], optional): Style for padding characters. Defaults to "none".
+        expand (bool, optional): Expand padding to fit available width. Defaults to True.
+    """
+
+    def __init__(
+        self,
+        renderable: "RenderableType",
+        pad: "PaddingDimensions" = (0, 0, 0, 0),
+        *,
+        style: Union[str, Style] = "none",
+        expand: bool = True,
+    ):
+        self.renderable = renderable
+        self.top, self.right, self.bottom, self.left = self.unpack(pad)
+        self.style = style
+        self.expand = expand
+
+    @classmethod
+    def indent(cls, renderable: "RenderableType", level: int) -> "Padding":
+        """Make padding instance to render an indent.
+
+        Args:
+            renderable (RenderableType): String or other renderable.
+            level (int): Number of characters to indent.
+
+        Returns:
+            Padding: A Padding instance.
+        """
+
+        return Padding(renderable, pad=(0, 0, 0, level), expand=False)
+
+    @staticmethod
+    def unpack(pad: "PaddingDimensions") -> Tuple[int, int, int, int]:
+        """Unpack padding specified in CSS style."""
+        if isinstance(pad, int):
+            return (pad, pad, pad, pad)
+        if len(pad) == 1:
+            _pad = pad[0]
+            return (_pad, _pad, _pad, _pad)
+        if len(pad) == 2:
+            pad_top, pad_right = pad
+            return (pad_top, pad_right, pad_top, pad_right)
+        if len(pad) == 4:
+            top, right, bottom, left = pad
+            return (top, right, bottom, left)
+        raise ValueError(f"1, 2 or 4 integers required for padding; {len(pad)} given")
+
+    def __repr__(self) -> str:
+        return f"Padding({self.renderable!r}, ({self.top},{self.right},{self.bottom},{self.left}))"
+
+    def __rich_console__(
+        self, console: "Console", options: "ConsoleOptions"
+    ) -> "RenderResult":
+        style = console.get_style(self.style)
+        if self.expand:
+            width = options.max_width
+        else:
+            width = min(
+                Measurement.get(console, options, self.renderable).maximum
+                + self.left
+                + self.right,
+                options.max_width,
+            )
+        render_options = options.update_width(width - self.left - self.right)
+        if render_options.height is not None:
+            render_options = render_options.update_height(
+                height=render_options.height - self.top - self.bottom
+            )
+        lines = console.render_lines(
+            self.renderable, render_options, style=style, pad=True
+        )
+        _Segment = Segment
+
+        left = _Segment(" " * self.left, style) if self.left else None
+        right = (
+            [_Segment(f'{" " * self.right}', style), _Segment.line()]
+            if self.right
+            else [_Segment.line()]
+        )
+        blank_line: Optional[List[Segment]] = None
+        if self.top:
+            blank_line = [_Segment(f'{" " * width}\n', style)]
+            yield from blank_line * self.top
+        if left:
+            for line in lines:
+                yield left
+                yield from line
+                yield from right
+        else:
+            for line in lines:
+                yield from line
+                yield from right
+        if self.bottom:
+            blank_line = blank_line or [_Segment(f'{" " * width}\n', style)]
+            yield from blank_line * self.bottom
+
+    def __rich_measure__(
+        self, console: "Console", options: "ConsoleOptions"
+    ) -> "Measurement":
+        max_width = options.max_width
+        extra_width = self.left + self.right
+        if max_width - extra_width < 1:
+            return Measurement(max_width, max_width)
+        measure_min, measure_max = Measurement.get(console, options, self.renderable)
+        measurement = Measurement(measure_min + extra_width, measure_max + extra_width)
+        measurement = measurement.with_maximum(max_width)
+        return measurement
+
+
+if __name__ == "__main__":  #  pragma: no cover
+    from pip._vendor.rich import print
+
+    print(Padding("Hello, World", (2, 4), style="on blue"))
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/pager.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/pager.py
new file mode 100644
index 0000000..a3f7aa6
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/pager.py
@@ -0,0 +1,34 @@
+from abc import ABC, abstractmethod
+from typing import Any
+
+
+class Pager(ABC):
+    """Base class for a pager."""
+
+    @abstractmethod
+    def show(self, content: str) -> None:
+        """Show content in pager.
+
+        Args:
+            content (str): Content to be displayed.
+        """
+
+
+class SystemPager(Pager):
+    """Uses the pager installed on the system."""
+
+    def _pager(self, content: str) -> Any:  #  pragma: no cover
+        return __import__("pydoc").pager(content)
+
+    def show(self, content: str) -> None:
+        """Use the same pager used by pydoc."""
+        self._pager(content)
+
+
+if __name__ == "__main__":  # pragma: no cover
+    from .__main__ import make_test_card
+    from .console import Console
+
+    console = Console()
+    with console.pager(styles=True):
+        console.print(make_test_card())
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/palette.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/palette.py
new file mode 100644
index 0000000..fa0c4dd
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/palette.py
@@ -0,0 +1,100 @@
+from math import sqrt
+from functools import lru_cache
+from typing import Sequence, Tuple, TYPE_CHECKING
+
+from .color_triplet import ColorTriplet
+
+if TYPE_CHECKING:
+    from pip._vendor.rich.table import Table
+
+
+class Palette:
+    """A palette of available colors."""
+
+    def __init__(self, colors: Sequence[Tuple[int, int, int]]):
+        self._colors = colors
+
+    def __getitem__(self, number: int) -> ColorTriplet:
+        return ColorTriplet(*self._colors[number])
+
+    def __rich__(self) -> "Table":
+        from pip._vendor.rich.color import Color
+        from pip._vendor.rich.style import Style
+        from pip._vendor.rich.text import Text
+        from pip._vendor.rich.table import Table
+
+        table = Table(
+            "index",
+            "RGB",
+            "Color",
+            title="Palette",
+            caption=f"{len(self._colors)} colors",
+            highlight=True,
+            caption_justify="right",
+        )
+        for index, color in enumerate(self._colors):
+            table.add_row(
+                str(index),
+                repr(color),
+                Text(" " * 16, style=Style(bgcolor=Color.from_rgb(*color))),
+            )
+        return table
+
+    # This is somewhat inefficient and needs caching
+    @lru_cache(maxsize=1024)
+    def match(self, color: Tuple[int, int, int]) -> int:
+        """Find a color from a palette that most closely matches a given color.
+
+        Args:
+            color (Tuple[int, int, int]): RGB components in range 0 > 255.
+
+        Returns:
+            int: Index of closes matching color.
+        """
+        red1, green1, blue1 = color
+        _sqrt = sqrt
+        get_color = self._colors.__getitem__
+
+        def get_color_distance(index: int) -> float:
+            """Get the distance to a color."""
+            red2, green2, blue2 = get_color(index)
+            red_mean = (red1 + red2) // 2
+            red = red1 - red2
+            green = green1 - green2
+            blue = blue1 - blue2
+            return _sqrt(
+                (((512 + red_mean) * red * red) >> 8)
+                + 4 * green * green
+                + (((767 - red_mean) * blue * blue) >> 8)
+            )
+
+        min_index = min(range(len(self._colors)), key=get_color_distance)
+        return min_index
+
+
+if __name__ == "__main__":  # pragma: no cover
+    import colorsys
+    from typing import Iterable
+    from pip._vendor.rich.color import Color
+    from pip._vendor.rich.console import Console, ConsoleOptions
+    from pip._vendor.rich.segment import Segment
+    from pip._vendor.rich.style import Style
+
+    class ColorBox:
+        def __rich_console__(
+            self, console: Console, options: ConsoleOptions
+        ) -> Iterable[Segment]:
+            height = console.size.height - 3
+            for y in range(0, height):
+                for x in range(options.max_width):
+                    h = x / options.max_width
+                    l = y / (height + 1)
+                    r1, g1, b1 = colorsys.hls_to_rgb(h, l, 1.0)
+                    r2, g2, b2 = colorsys.hls_to_rgb(h, l + (1 / height / 2), 1.0)
+                    bgcolor = Color.from_rgb(r1 * 255, g1 * 255, b1 * 255)
+                    color = Color.from_rgb(r2 * 255, g2 * 255, b2 * 255)
+                    yield Segment("▄", Style(color=color, bgcolor=bgcolor))
+                yield Segment.line()
+
+    console = Console()
+    console.print(ColorBox())
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/panel.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/panel.py
new file mode 100644
index 0000000..8cfa6f4
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/panel.py
@@ -0,0 +1,318 @@
+from typing import TYPE_CHECKING, Optional
+
+from .align import AlignMethod
+from .box import ROUNDED, Box
+from .cells import cell_len
+from .jupyter import JupyterMixin
+from .measure import Measurement, measure_renderables
+from .padding import Padding, PaddingDimensions
+from .segment import Segment
+from .style import Style, StyleType
+from .text import Text, TextType
+
+if TYPE_CHECKING:
+    from .console import Console, ConsoleOptions, RenderableType, RenderResult
+
+
+class Panel(JupyterMixin):
+    """A console renderable that draws a border around its contents.
+
+    Example:
+        >>> console.print(Panel("Hello, World!"))
+
+    Args:
+        renderable (RenderableType): A console renderable object.
+        box (Box, optional): A Box instance that defines the look of the border (see :ref:`appendix_box`. Defaults to box.ROUNDED.
+        title (Optional[TextType], optional): Optional title displayed in panel header. Defaults to None.
+        title_align (AlignMethod, optional): Alignment of title. Defaults to "center".
+        subtitle (Optional[TextType], optional): Optional subtitle displayed in panel footer. Defaults to None.
+        subtitle_align (AlignMethod, optional): Alignment of subtitle. Defaults to "center".
+        safe_box (bool, optional): Disable box characters that don't display on windows legacy terminal with *raster* fonts. Defaults to True.
+        expand (bool, optional): If True the panel will stretch to fill the console width, otherwise it will be sized to fit the contents. Defaults to True.
+        style (str, optional): The style of the panel (border and contents). Defaults to "none".
+        border_style (str, optional): The style of the border. Defaults to "none".
+        width (Optional[int], optional): Optional width of panel. Defaults to None to auto-detect.
+        height (Optional[int], optional): Optional height of panel. Defaults to None to auto-detect.
+        padding (Optional[PaddingDimensions]): Optional padding around renderable. Defaults to 0.
+        highlight (bool, optional): Enable automatic highlighting of panel title (if str). Defaults to False.
+    """
+
+    def __init__(
+        self,
+        renderable: "RenderableType",
+        box: Box = ROUNDED,
+        *,
+        title: Optional[TextType] = None,
+        title_align: AlignMethod = "center",
+        subtitle: Optional[TextType] = None,
+        subtitle_align: AlignMethod = "center",
+        safe_box: Optional[bool] = None,
+        expand: bool = True,
+        style: StyleType = "none",
+        border_style: StyleType = "none",
+        width: Optional[int] = None,
+        height: Optional[int] = None,
+        padding: PaddingDimensions = (0, 1),
+        highlight: bool = False,
+    ) -> None:
+        self.renderable = renderable
+        self.box = box
+        self.title = title
+        self.title_align: AlignMethod = title_align
+        self.subtitle = subtitle
+        self.subtitle_align = subtitle_align
+        self.safe_box = safe_box
+        self.expand = expand
+        self.style = style
+        self.border_style = border_style
+        self.width = width
+        self.height = height
+        self.padding = padding
+        self.highlight = highlight
+
+    @classmethod
+    def fit(
+        cls,
+        renderable: "RenderableType",
+        box: Box = ROUNDED,
+        *,
+        title: Optional[TextType] = None,
+        title_align: AlignMethod = "center",
+        subtitle: Optional[TextType] = None,
+        subtitle_align: AlignMethod = "center",
+        safe_box: Optional[bool] = None,
+        style: StyleType = "none",
+        border_style: StyleType = "none",
+        width: Optional[int] = None,
+        height: Optional[int] = None,
+        padding: PaddingDimensions = (0, 1),
+        highlight: bool = False,
+    ) -> "Panel":
+        """An alternative constructor that sets expand=False."""
+        return cls(
+            renderable,
+            box,
+            title=title,
+            title_align=title_align,
+            subtitle=subtitle,
+            subtitle_align=subtitle_align,
+            safe_box=safe_box,
+            style=style,
+            border_style=border_style,
+            width=width,
+            height=height,
+            padding=padding,
+            highlight=highlight,
+            expand=False,
+        )
+
+    @property
+    def _title(self) -> Optional[Text]:
+        if self.title:
+            title_text = (
+                Text.from_markup(self.title)
+                if isinstance(self.title, str)
+                else self.title.copy()
+            )
+            title_text.end = ""
+            title_text.plain = title_text.plain.replace("\n", " ")
+            title_text.no_wrap = True
+            title_text.expand_tabs()
+            title_text.pad(1)
+            return title_text
+        return None
+
+    @property
+    def _subtitle(self) -> Optional[Text]:
+        if self.subtitle:
+            subtitle_text = (
+                Text.from_markup(self.subtitle)
+                if isinstance(self.subtitle, str)
+                else self.subtitle.copy()
+            )
+            subtitle_text.end = ""
+            subtitle_text.plain = subtitle_text.plain.replace("\n", " ")
+            subtitle_text.no_wrap = True
+            subtitle_text.expand_tabs()
+            subtitle_text.pad(1)
+            return subtitle_text
+        return None
+
+    def __rich_console__(
+        self, console: "Console", options: "ConsoleOptions"
+    ) -> "RenderResult":
+        _padding = Padding.unpack(self.padding)
+        renderable = (
+            Padding(self.renderable, _padding) if any(_padding) else self.renderable
+        )
+        style = console.get_style(self.style)
+        partial_border_style = console.get_style(self.border_style)
+        border_style = style + partial_border_style
+        width = (
+            options.max_width
+            if self.width is None
+            else min(options.max_width, self.width)
+        )
+
+        safe_box: bool = console.safe_box if self.safe_box is None else self.safe_box
+        box = self.box.substitute(options, safe=safe_box)
+
+        def align_text(
+            text: Text, width: int, align: str, character: str, style: Style
+        ) -> Text:
+            """Gets new aligned text.
+
+            Args:
+                text (Text): Title or subtitle text.
+                width (int): Desired width.
+                align (str): Alignment.
+                character (str): Character for alignment.
+                style (Style): Border style
+
+            Returns:
+                Text: New text instance
+            """
+            text = text.copy()
+            text.truncate(width)
+            excess_space = width - cell_len(text.plain)
+            if text.style:
+                text.stylize(console.get_style(text.style))
+
+            if excess_space:
+                if align == "left":
+                    return Text.assemble(
+                        text,
+                        (character * excess_space, style),
+                        no_wrap=True,
+                        end="",
+                    )
+                elif align == "center":
+                    left = excess_space // 2
+                    return Text.assemble(
+                        (character * left, style),
+                        text,
+                        (character * (excess_space - left), style),
+                        no_wrap=True,
+                        end="",
+                    )
+                else:
+                    return Text.assemble(
+                        (character * excess_space, style),
+                        text,
+                        no_wrap=True,
+                        end="",
+                    )
+            return text
+
+        title_text = self._title
+        if title_text is not None:
+            title_text.stylize_before(partial_border_style)
+
+        child_width = (
+            width - 2
+            if self.expand
+            else console.measure(
+                renderable, options=options.update_width(width - 2)
+            ).maximum
+        )
+        child_height = self.height or options.height or None
+        if child_height:
+            child_height -= 2
+        if title_text is not None:
+            child_width = min(
+                options.max_width - 2, max(child_width, title_text.cell_len + 2)
+            )
+
+        width = child_width + 2
+        child_options = options.update(
+            width=child_width, height=child_height, highlight=self.highlight
+        )
+        lines = console.render_lines(renderable, child_options, style=style)
+
+        line_start = Segment(box.mid_left, border_style)
+        line_end = Segment(f"{box.mid_right}", border_style)
+        new_line = Segment.line()
+        if title_text is None or width <= 4:
+            yield Segment(box.get_top([width - 2]), border_style)
+        else:
+            title_text = align_text(
+                title_text,
+                width - 4,
+                self.title_align,
+                box.top,
+                border_style,
+            )
+            yield Segment(box.top_left + box.top, border_style)
+            yield from console.render(title_text, child_options.update_width(width - 4))
+            yield Segment(box.top + box.top_right, border_style)
+
+        yield new_line
+        for line in lines:
+            yield line_start
+            yield from line
+            yield line_end
+            yield new_line
+
+        subtitle_text = self._subtitle
+        if subtitle_text is not None:
+            subtitle_text.stylize_before(partial_border_style)
+
+        if subtitle_text is None or width <= 4:
+            yield Segment(box.get_bottom([width - 2]), border_style)
+        else:
+            subtitle_text = align_text(
+                subtitle_text,
+                width - 4,
+                self.subtitle_align,
+                box.bottom,
+                border_style,
+            )
+            yield Segment(box.bottom_left + box.bottom, border_style)
+            yield from console.render(
+                subtitle_text, child_options.update_width(width - 4)
+            )
+            yield Segment(box.bottom + box.bottom_right, border_style)
+
+        yield new_line
+
+    def __rich_measure__(
+        self, console: "Console", options: "ConsoleOptions"
+    ) -> "Measurement":
+        _title = self._title
+        _, right, _, left = Padding.unpack(self.padding)
+        padding = left + right
+        renderables = [self.renderable, _title] if _title else [self.renderable]
+
+        if self.width is None:
+            width = (
+                measure_renderables(
+                    console,
+                    options.update_width(options.max_width - padding - 2),
+                    renderables,
+                ).maximum
+                + padding
+                + 2
+            )
+        else:
+            width = self.width
+        return Measurement(width, width)
+
+
+if __name__ == "__main__":  # pragma: no cover
+    from .console import Console
+
+    c = Console()
+
+    from .box import DOUBLE, ROUNDED
+    from .padding import Padding
+
+    p = Panel(
+        "Hello, World!",
+        title="rich.Panel",
+        style="white on blue",
+        box=DOUBLE,
+        padding=1,
+    )
+
+    c.print()
+    c.print(p)
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/pretty.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/pretty.py
new file mode 100644
index 0000000..c4a274f
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/pretty.py
@@ -0,0 +1,1016 @@
+import builtins
+import collections
+import dataclasses
+import inspect
+import os
+import reprlib
+import sys
+from array import array
+from collections import Counter, UserDict, UserList, defaultdict, deque
+from dataclasses import dataclass, fields, is_dataclass
+from inspect import isclass
+from itertools import islice
+from types import MappingProxyType
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    Callable,
+    DefaultDict,
+    Deque,
+    Dict,
+    Iterable,
+    List,
+    Optional,
+    Sequence,
+    Set,
+    Tuple,
+    Union,
+)
+
+from pip._vendor.rich.repr import RichReprResult
+
+try:
+    import attr as _attr_module
+
+    _has_attrs = hasattr(_attr_module, "ib")
+except ImportError:  # pragma: no cover
+    _has_attrs = False
+
+from . import get_console
+from ._loop import loop_last
+from ._pick import pick_bool
+from .abc import RichRenderable
+from .cells import cell_len
+from .highlighter import ReprHighlighter
+from .jupyter import JupyterMixin, JupyterRenderable
+from .measure import Measurement
+from .text import Text
+
+if TYPE_CHECKING:
+    from .console import (
+        Console,
+        ConsoleOptions,
+        HighlighterType,
+        JustifyMethod,
+        OverflowMethod,
+        RenderResult,
+    )
+
+
+def _is_attr_object(obj: Any) -> bool:
+    """Check if an object was created with attrs module."""
+    return _has_attrs and _attr_module.has(type(obj))
+
+
+def _get_attr_fields(obj: Any) -> Sequence["_attr_module.Attribute[Any]"]:
+    """Get fields for an attrs object."""
+    return _attr_module.fields(type(obj)) if _has_attrs else []
+
+
+def _is_dataclass_repr(obj: object) -> bool:
+    """Check if an instance of a dataclass contains the default repr.
+
+    Args:
+        obj (object): A dataclass instance.
+
+    Returns:
+        bool: True if the default repr is used, False if there is a custom repr.
+    """
+    # Digging in to a lot of internals here
+    # Catching all exceptions in case something is missing on a non CPython implementation
+    try:
+        return obj.__repr__.__code__.co_filename in (
+            dataclasses.__file__,
+            reprlib.__file__,
+        )
+    except Exception:  # pragma: no coverage
+        return False
+
+
+_dummy_namedtuple = collections.namedtuple("_dummy_namedtuple", [])
+
+
+def _has_default_namedtuple_repr(obj: object) -> bool:
+    """Check if an instance of namedtuple contains the default repr
+
+    Args:
+        obj (object): A namedtuple
+
+    Returns:
+        bool: True if the default repr is used, False if there's a custom repr.
+    """
+    obj_file = None
+    try:
+        obj_file = inspect.getfile(obj.__repr__)
+    except (OSError, TypeError):
+        # OSError handles case where object is defined in __main__ scope, e.g. REPL - no filename available.
+        # TypeError trapped defensively, in case of object without filename slips through.
+        pass
+    default_repr_file = inspect.getfile(_dummy_namedtuple.__repr__)
+    return obj_file == default_repr_file
+
+
+def _ipy_display_hook(
+    value: Any,
+    console: Optional["Console"] = None,
+    overflow: "OverflowMethod" = "ignore",
+    crop: bool = False,
+    indent_guides: bool = False,
+    max_length: Optional[int] = None,
+    max_string: Optional[int] = None,
+    max_depth: Optional[int] = None,
+    expand_all: bool = False,
+) -> Union[str, None]:
+    # needed here to prevent circular import:
+    from .console import ConsoleRenderable
+
+    # always skip rich generated jupyter renderables or None values
+    if _safe_isinstance(value, JupyterRenderable) or value is None:
+        return None
+
+    console = console or get_console()
+
+    with console.capture() as capture:
+        # certain renderables should start on a new line
+        if _safe_isinstance(value, ConsoleRenderable):
+            console.line()
+        console.print(
+            (
+                value
+                if _safe_isinstance(value, RichRenderable)
+                else Pretty(
+                    value,
+                    overflow=overflow,
+                    indent_guides=indent_guides,
+                    max_length=max_length,
+                    max_string=max_string,
+                    max_depth=max_depth,
+                    expand_all=expand_all,
+                    margin=12,
+                )
+            ),
+            crop=crop,
+            new_line_start=True,
+            end="",
+        )
+    # strip trailing newline, not usually part of a text repr
+    # I'm not sure if this should be prevented at a lower level
+    return capture.get().rstrip("\n")
+
+
+def _safe_isinstance(
+    obj: object, class_or_tuple: Union[type, Tuple[type, ...]]
+) -> bool:
+    """isinstance can fail in rare cases, for example types with no __class__"""
+    try:
+        return isinstance(obj, class_or_tuple)
+    except Exception:
+        return False
+
+
+def install(
+    console: Optional["Console"] = None,
+    overflow: "OverflowMethod" = "ignore",
+    crop: bool = False,
+    indent_guides: bool = False,
+    max_length: Optional[int] = None,
+    max_string: Optional[int] = None,
+    max_depth: Optional[int] = None,
+    expand_all: bool = False,
+) -> None:
+    """Install automatic pretty printing in the Python REPL.
+
+    Args:
+        console (Console, optional): Console instance or ``None`` to use global console. Defaults to None.
+        overflow (Optional[OverflowMethod], optional): Overflow method. Defaults to "ignore".
+        crop (Optional[bool], optional): Enable cropping of long lines. Defaults to False.
+        indent_guides (bool, optional): Enable indentation guides. Defaults to False.
+        max_length (int, optional): Maximum length of containers before abbreviating, or None for no abbreviation.
+            Defaults to None.
+        max_string (int, optional): Maximum length of string before truncating, or None to disable. Defaults to None.
+        max_depth (int, optional): Maximum depth of nested data structures, or None for no maximum. Defaults to None.
+        expand_all (bool, optional): Expand all containers. Defaults to False.
+        max_frames (int): Maximum number of frames to show in a traceback, 0 for no maximum. Defaults to 100.
+    """
+    from pip._vendor.rich import get_console
+
+    console = console or get_console()
+    assert console is not None
+
+    def display_hook(value: Any) -> None:
+        """Replacement sys.displayhook which prettifies objects with Rich."""
+        if value is not None:
+            assert console is not None
+            builtins._ = None  # type: ignore[attr-defined]
+            console.print(
+                (
+                    value
+                    if _safe_isinstance(value, RichRenderable)
+                    else Pretty(
+                        value,
+                        overflow=overflow,
+                        indent_guides=indent_guides,
+                        max_length=max_length,
+                        max_string=max_string,
+                        max_depth=max_depth,
+                        expand_all=expand_all,
+                    )
+                ),
+                crop=crop,
+            )
+            builtins._ = value  # type: ignore[attr-defined]
+
+    try:
+        ip = get_ipython()  # type: ignore[name-defined]
+    except NameError:
+        sys.displayhook = display_hook
+    else:
+        from IPython.core.formatters import BaseFormatter
+
+        class RichFormatter(BaseFormatter):  # type: ignore[misc]
+            pprint: bool = True
+
+            def __call__(self, value: Any) -> Any:
+                if self.pprint:
+                    return _ipy_display_hook(
+                        value,
+                        console=get_console(),
+                        overflow=overflow,
+                        indent_guides=indent_guides,
+                        max_length=max_length,
+                        max_string=max_string,
+                        max_depth=max_depth,
+                        expand_all=expand_all,
+                    )
+                else:
+                    return repr(value)
+
+        # replace plain text formatter with rich formatter
+        rich_formatter = RichFormatter()
+        ip.display_formatter.formatters["text/plain"] = rich_formatter
+
+
+class Pretty(JupyterMixin):
+    """A rich renderable that pretty prints an object.
+
+    Args:
+        _object (Any): An object to pretty print.
+        highlighter (HighlighterType, optional): Highlighter object to apply to result, or None for ReprHighlighter. Defaults to None.
+        indent_size (int, optional): Number of spaces in indent. Defaults to 4.
+        justify (JustifyMethod, optional): Justify method, or None for default. Defaults to None.
+        overflow (OverflowMethod, optional): Overflow method, or None for default. Defaults to None.
+        no_wrap (Optional[bool], optional): Disable word wrapping. Defaults to False.
+        indent_guides (bool, optional): Enable indentation guides. Defaults to False.
+        max_length (int, optional): Maximum length of containers before abbreviating, or None for no abbreviation.
+            Defaults to None.
+        max_string (int, optional): Maximum length of string before truncating, or None to disable. Defaults to None.
+        max_depth (int, optional): Maximum depth of nested data structures, or None for no maximum. Defaults to None.
+        expand_all (bool, optional): Expand all containers. Defaults to False.
+        margin (int, optional): Subtrace a margin from width to force containers to expand earlier. Defaults to 0.
+        insert_line (bool, optional): Insert a new line if the output has multiple new lines. Defaults to False.
+    """
+
+    def __init__(
+        self,
+        _object: Any,
+        highlighter: Optional["HighlighterType"] = None,
+        *,
+        indent_size: int = 4,
+        justify: Optional["JustifyMethod"] = None,
+        overflow: Optional["OverflowMethod"] = None,
+        no_wrap: Optional[bool] = False,
+        indent_guides: bool = False,
+        max_length: Optional[int] = None,
+        max_string: Optional[int] = None,
+        max_depth: Optional[int] = None,
+        expand_all: bool = False,
+        margin: int = 0,
+        insert_line: bool = False,
+    ) -> None:
+        self._object = _object
+        self.highlighter = highlighter or ReprHighlighter()
+        self.indent_size = indent_size
+        self.justify: Optional["JustifyMethod"] = justify
+        self.overflow: Optional["OverflowMethod"] = overflow
+        self.no_wrap = no_wrap
+        self.indent_guides = indent_guides
+        self.max_length = max_length
+        self.max_string = max_string
+        self.max_depth = max_depth
+        self.expand_all = expand_all
+        self.margin = margin
+        self.insert_line = insert_line
+
+    def __rich_console__(
+        self, console: "Console", options: "ConsoleOptions"
+    ) -> "RenderResult":
+        pretty_str = pretty_repr(
+            self._object,
+            max_width=options.max_width - self.margin,
+            indent_size=self.indent_size,
+            max_length=self.max_length,
+            max_string=self.max_string,
+            max_depth=self.max_depth,
+            expand_all=self.expand_all,
+        )
+        pretty_text = Text.from_ansi(
+            pretty_str,
+            justify=self.justify or options.justify,
+            overflow=self.overflow or options.overflow,
+            no_wrap=pick_bool(self.no_wrap, options.no_wrap),
+            style="pretty",
+        )
+        pretty_text = (
+            self.highlighter(pretty_text)
+            if pretty_text
+            else Text(
+                f"{type(self._object)}.__repr__ returned empty string",
+                style="dim italic",
+            )
+        )
+        if self.indent_guides and not options.ascii_only:
+            pretty_text = pretty_text.with_indent_guides(
+                self.indent_size, style="repr.indent"
+            )
+        if self.insert_line and "\n" in pretty_text:
+            yield ""
+        yield pretty_text
+
+    def __rich_measure__(
+        self, console: "Console", options: "ConsoleOptions"
+    ) -> "Measurement":
+        pretty_str = pretty_repr(
+            self._object,
+            max_width=options.max_width,
+            indent_size=self.indent_size,
+            max_length=self.max_length,
+            max_string=self.max_string,
+            max_depth=self.max_depth,
+            expand_all=self.expand_all,
+        )
+        text_width = (
+            max(cell_len(line) for line in pretty_str.splitlines()) if pretty_str else 0
+        )
+        return Measurement(text_width, text_width)
+
+
+def _get_braces_for_defaultdict(_object: DefaultDict[Any, Any]) -> Tuple[str, str, str]:
+    return (
+        f"defaultdict({_object.default_factory!r}, {{",
+        "})",
+        f"defaultdict({_object.default_factory!r}, {{}})",
+    )
+
+
+def _get_braces_for_deque(_object: Deque[Any]) -> Tuple[str, str, str]:
+    if _object.maxlen is None:
+        return ("deque([", "])", "deque()")
+    return (
+        "deque([",
+        f"], maxlen={_object.maxlen})",
+        f"deque(maxlen={_object.maxlen})",
+    )
+
+
+def _get_braces_for_array(_object: "array[Any]") -> Tuple[str, str, str]:
+    return (f"array({_object.typecode!r}, [", "])", f"array({_object.typecode!r})")
+
+
+_BRACES: Dict[type, Callable[[Any], Tuple[str, str, str]]] = {
+    os._Environ: lambda _object: ("environ({", "})", "environ({})"),
+    array: _get_braces_for_array,
+    defaultdict: _get_braces_for_defaultdict,
+    Counter: lambda _object: ("Counter({", "})", "Counter()"),
+    deque: _get_braces_for_deque,
+    dict: lambda _object: ("{", "}", "{}"),
+    UserDict: lambda _object: ("{", "}", "{}"),
+    frozenset: lambda _object: ("frozenset({", "})", "frozenset()"),
+    list: lambda _object: ("[", "]", "[]"),
+    UserList: lambda _object: ("[", "]", "[]"),
+    set: lambda _object: ("{", "}", "set()"),
+    tuple: lambda _object: ("(", ")", "()"),
+    MappingProxyType: lambda _object: ("mappingproxy({", "})", "mappingproxy({})"),
+}
+_CONTAINERS = tuple(_BRACES.keys())
+_MAPPING_CONTAINERS = (dict, os._Environ, MappingProxyType, UserDict)
+
+
+def is_expandable(obj: Any) -> bool:
+    """Check if an object may be expanded by pretty print."""
+    return (
+        _safe_isinstance(obj, _CONTAINERS)
+        or (is_dataclass(obj))
+        or (hasattr(obj, "__rich_repr__"))
+        or _is_attr_object(obj)
+    ) and not isclass(obj)
+
+
+@dataclass
+class Node:
+    """A node in a repr tree. May be atomic or a container."""
+
+    key_repr: str = ""
+    value_repr: str = ""
+    open_brace: str = ""
+    close_brace: str = ""
+    empty: str = ""
+    last: bool = False
+    is_tuple: bool = False
+    is_namedtuple: bool = False
+    children: Optional[List["Node"]] = None
+    key_separator: str = ": "
+    separator: str = ", "
+
+    def iter_tokens(self) -> Iterable[str]:
+        """Generate tokens for this node."""
+        if self.key_repr:
+            yield self.key_repr
+            yield self.key_separator
+        if self.value_repr:
+            yield self.value_repr
+        elif self.children is not None:
+            if self.children:
+                yield self.open_brace
+                if self.is_tuple and not self.is_namedtuple and len(self.children) == 1:
+                    yield from self.children[0].iter_tokens()
+                    yield ","
+                else:
+                    for child in self.children:
+                        yield from child.iter_tokens()
+                        if not child.last:
+                            yield self.separator
+                yield self.close_brace
+            else:
+                yield self.empty
+
+    def check_length(self, start_length: int, max_length: int) -> bool:
+        """Check the length fits within a limit.
+
+        Args:
+            start_length (int): Starting length of the line (indent, prefix, suffix).
+            max_length (int): Maximum length.
+
+        Returns:
+            bool: True if the node can be rendered within max length, otherwise False.
+        """
+        total_length = start_length
+        for token in self.iter_tokens():
+            total_length += cell_len(token)
+            if total_length > max_length:
+                return False
+        return True
+
+    def __str__(self) -> str:
+        repr_text = "".join(self.iter_tokens())
+        return repr_text
+
+    def render(
+        self, max_width: int = 80, indent_size: int = 4, expand_all: bool = False
+    ) -> str:
+        """Render the node to a pretty repr.
+
+        Args:
+            max_width (int, optional): Maximum width of the repr. Defaults to 80.
+            indent_size (int, optional): Size of indents. Defaults to 4.
+            expand_all (bool, optional): Expand all levels. Defaults to False.
+
+        Returns:
+            str: A repr string of the original object.
+        """
+        lines = [_Line(node=self, is_root=True)]
+        line_no = 0
+        while line_no < len(lines):
+            line = lines[line_no]
+            if line.expandable and not line.expanded:
+                if expand_all or not line.check_length(max_width):
+                    lines[line_no : line_no + 1] = line.expand(indent_size)
+            line_no += 1
+
+        repr_str = "\n".join(str(line) for line in lines)
+        return repr_str
+
+
+@dataclass
+class _Line:
+    """A line in repr output."""
+
+    parent: Optional["_Line"] = None
+    is_root: bool = False
+    node: Optional[Node] = None
+    text: str = ""
+    suffix: str = ""
+    whitespace: str = ""
+    expanded: bool = False
+    last: bool = False
+
+    @property
+    def expandable(self) -> bool:
+        """Check if the line may be expanded."""
+        return bool(self.node is not None and self.node.children)
+
+    def check_length(self, max_length: int) -> bool:
+        """Check this line fits within a given number of cells."""
+        start_length = (
+            len(self.whitespace) + cell_len(self.text) + cell_len(self.suffix)
+        )
+        assert self.node is not None
+        return self.node.check_length(start_length, max_length)
+
+    def expand(self, indent_size: int) -> Iterable["_Line"]:
+        """Expand this line by adding children on their own line."""
+        node = self.node
+        assert node is not None
+        whitespace = self.whitespace
+        assert node.children
+        if node.key_repr:
+            new_line = yield _Line(
+                text=f"{node.key_repr}{node.key_separator}{node.open_brace}",
+                whitespace=whitespace,
+            )
+        else:
+            new_line = yield _Line(text=node.open_brace, whitespace=whitespace)
+        child_whitespace = self.whitespace + " " * indent_size
+        tuple_of_one = node.is_tuple and len(node.children) == 1
+        for last, child in loop_last(node.children):
+            separator = "," if tuple_of_one else node.separator
+            line = _Line(
+                parent=new_line,
+                node=child,
+                whitespace=child_whitespace,
+                suffix=separator,
+                last=last and not tuple_of_one,
+            )
+            yield line
+
+        yield _Line(
+            text=node.close_brace,
+            whitespace=whitespace,
+            suffix=self.suffix,
+            last=self.last,
+        )
+
+    def __str__(self) -> str:
+        if self.last:
+            return f"{self.whitespace}{self.text}{self.node or ''}"
+        else:
+            return (
+                f"{self.whitespace}{self.text}{self.node or ''}{self.suffix.rstrip()}"
+            )
+
+
+def _is_namedtuple(obj: Any) -> bool:
+    """Checks if an object is most likely a namedtuple. It is possible
+    to craft an object that passes this check and isn't a namedtuple, but
+    there is only a minuscule chance of this happening unintentionally.
+
+    Args:
+        obj (Any): The object to test
+
+    Returns:
+        bool: True if the object is a namedtuple. False otherwise.
+    """
+    try:
+        fields = getattr(obj, "_fields", None)
+    except Exception:
+        # Being very defensive - if we cannot get the attr then its not a namedtuple
+        return False
+    return isinstance(obj, tuple) and isinstance(fields, tuple)
+
+
+def traverse(
+    _object: Any,
+    max_length: Optional[int] = None,
+    max_string: Optional[int] = None,
+    max_depth: Optional[int] = None,
+) -> Node:
+    """Traverse object and generate a tree.
+
+    Args:
+        _object (Any): Object to be traversed.
+        max_length (int, optional): Maximum length of containers before abbreviating, or None for no abbreviation.
+            Defaults to None.
+        max_string (int, optional): Maximum length of string before truncating, or None to disable truncating.
+            Defaults to None.
+        max_depth (int, optional): Maximum depth of data structures, or None for no maximum.
+            Defaults to None.
+
+    Returns:
+        Node: The root of a tree structure which can be used to render a pretty repr.
+    """
+
+    def to_repr(obj: Any) -> str:
+        """Get repr string for an object, but catch errors."""
+        if (
+            max_string is not None
+            and _safe_isinstance(obj, (bytes, str))
+            and len(obj) > max_string
+        ):
+            truncated = len(obj) - max_string
+            obj_repr = f"{obj[:max_string]!r}+{truncated}"
+        else:
+            try:
+                obj_repr = repr(obj)
+            except Exception as error:
+                obj_repr = f""
+        return obj_repr
+
+    visited_ids: Set[int] = set()
+    push_visited = visited_ids.add
+    pop_visited = visited_ids.remove
+
+    def _traverse(obj: Any, root: bool = False, depth: int = 0) -> Node:
+        """Walk the object depth first."""
+
+        obj_id = id(obj)
+        if obj_id in visited_ids:
+            # Recursion detected
+            return Node(value_repr="...")
+
+        obj_type = type(obj)
+        children: List[Node]
+        reached_max_depth = max_depth is not None and depth >= max_depth
+
+        def iter_rich_args(rich_args: Any) -> Iterable[Union[Any, Tuple[str, Any]]]:
+            for arg in rich_args:
+                if _safe_isinstance(arg, tuple):
+                    if len(arg) == 3:
+                        key, child, default = arg
+                        if default == child:
+                            continue
+                        yield key, child
+                    elif len(arg) == 2:
+                        key, child = arg
+                        yield key, child
+                    elif len(arg) == 1:
+                        yield arg[0]
+                else:
+                    yield arg
+
+        try:
+            fake_attributes = hasattr(
+                obj, "awehoi234_wdfjwljet234_234wdfoijsdfmmnxpi492"
+            )
+        except Exception:
+            fake_attributes = False
+
+        rich_repr_result: Optional[RichReprResult] = None
+        if not fake_attributes:
+            try:
+                if hasattr(obj, "__rich_repr__") and not isclass(obj):
+                    rich_repr_result = obj.__rich_repr__()
+            except Exception:
+                pass
+
+        if rich_repr_result is not None:
+            push_visited(obj_id)
+            angular = getattr(obj.__rich_repr__, "angular", False)
+            args = list(iter_rich_args(rich_repr_result))
+            class_name = obj.__class__.__name__
+
+            if args:
+                children = []
+                append = children.append
+
+                if reached_max_depth:
+                    if angular:
+                        node = Node(value_repr=f"<{class_name}...>")
+                    else:
+                        node = Node(value_repr=f"{class_name}(...)")
+                else:
+                    if angular:
+                        node = Node(
+                            open_brace=f"<{class_name} ",
+                            close_brace=">",
+                            children=children,
+                            last=root,
+                            separator=" ",
+                        )
+                    else:
+                        node = Node(
+                            open_brace=f"{class_name}(",
+                            close_brace=")",
+                            children=children,
+                            last=root,
+                        )
+                    for last, arg in loop_last(args):
+                        if _safe_isinstance(arg, tuple):
+                            key, child = arg
+                            child_node = _traverse(child, depth=depth + 1)
+                            child_node.last = last
+                            child_node.key_repr = key
+                            child_node.key_separator = "="
+                            append(child_node)
+                        else:
+                            child_node = _traverse(arg, depth=depth + 1)
+                            child_node.last = last
+                            append(child_node)
+            else:
+                node = Node(
+                    value_repr=f"<{class_name}>" if angular else f"{class_name}()",
+                    children=[],
+                    last=root,
+                )
+            pop_visited(obj_id)
+        elif _is_attr_object(obj) and not fake_attributes:
+            push_visited(obj_id)
+            children = []
+            append = children.append
+
+            attr_fields = _get_attr_fields(obj)
+            if attr_fields:
+                if reached_max_depth:
+                    node = Node(value_repr=f"{obj.__class__.__name__}(...)")
+                else:
+                    node = Node(
+                        open_brace=f"{obj.__class__.__name__}(",
+                        close_brace=")",
+                        children=children,
+                        last=root,
+                    )
+
+                    def iter_attrs() -> (
+                        Iterable[Tuple[str, Any, Optional[Callable[[Any], str]]]]
+                    ):
+                        """Iterate over attr fields and values."""
+                        for attr in attr_fields:
+                            if attr.repr:
+                                try:
+                                    value = getattr(obj, attr.name)
+                                except Exception as error:
+                                    # Can happen, albeit rarely
+                                    yield (attr.name, error, None)
+                                else:
+                                    yield (
+                                        attr.name,
+                                        value,
+                                        attr.repr if callable(attr.repr) else None,
+                                    )
+
+                    for last, (name, value, repr_callable) in loop_last(iter_attrs()):
+                        if repr_callable:
+                            child_node = Node(value_repr=str(repr_callable(value)))
+                        else:
+                            child_node = _traverse(value, depth=depth + 1)
+                        child_node.last = last
+                        child_node.key_repr = name
+                        child_node.key_separator = "="
+                        append(child_node)
+            else:
+                node = Node(
+                    value_repr=f"{obj.__class__.__name__}()", children=[], last=root
+                )
+            pop_visited(obj_id)
+        elif (
+            is_dataclass(obj)
+            and not _safe_isinstance(obj, type)
+            and not fake_attributes
+            and _is_dataclass_repr(obj)
+        ):
+            push_visited(obj_id)
+            children = []
+            append = children.append
+            if reached_max_depth:
+                node = Node(value_repr=f"{obj.__class__.__name__}(...)")
+            else:
+                node = Node(
+                    open_brace=f"{obj.__class__.__name__}(",
+                    close_brace=")",
+                    children=children,
+                    last=root,
+                    empty=f"{obj.__class__.__name__}()",
+                )
+
+                for last, field in loop_last(
+                    field
+                    for field in fields(obj)
+                    if field.repr and hasattr(obj, field.name)
+                ):
+                    child_node = _traverse(getattr(obj, field.name), depth=depth + 1)
+                    child_node.key_repr = field.name
+                    child_node.last = last
+                    child_node.key_separator = "="
+                    append(child_node)
+
+            pop_visited(obj_id)
+        elif _is_namedtuple(obj) and _has_default_namedtuple_repr(obj):
+            push_visited(obj_id)
+            class_name = obj.__class__.__name__
+            if reached_max_depth:
+                # If we've reached the max depth, we still show the class name, but not its contents
+                node = Node(
+                    value_repr=f"{class_name}(...)",
+                )
+            else:
+                children = []
+                append = children.append
+                node = Node(
+                    open_brace=f"{class_name}(",
+                    close_brace=")",
+                    children=children,
+                    empty=f"{class_name}()",
+                )
+                for last, (key, value) in loop_last(obj._asdict().items()):
+                    child_node = _traverse(value, depth=depth + 1)
+                    child_node.key_repr = key
+                    child_node.last = last
+                    child_node.key_separator = "="
+                    append(child_node)
+            pop_visited(obj_id)
+        elif _safe_isinstance(obj, _CONTAINERS):
+            for container_type in _CONTAINERS:
+                if _safe_isinstance(obj, container_type):
+                    obj_type = container_type
+                    break
+
+            push_visited(obj_id)
+
+            open_brace, close_brace, empty = _BRACES[obj_type](obj)
+
+            if reached_max_depth:
+                node = Node(value_repr=f"{open_brace}...{close_brace}")
+            elif obj_type.__repr__ != type(obj).__repr__:
+                node = Node(value_repr=to_repr(obj), last=root)
+            elif obj:
+                children = []
+                node = Node(
+                    open_brace=open_brace,
+                    close_brace=close_brace,
+                    children=children,
+                    last=root,
+                )
+                append = children.append
+                num_items = len(obj)
+                last_item_index = num_items - 1
+
+                if _safe_isinstance(obj, _MAPPING_CONTAINERS):
+                    iter_items = iter(obj.items())
+                    if max_length is not None:
+                        iter_items = islice(iter_items, max_length)
+                    for index, (key, child) in enumerate(iter_items):
+                        child_node = _traverse(child, depth=depth + 1)
+                        child_node.key_repr = to_repr(key)
+                        child_node.last = index == last_item_index
+                        append(child_node)
+                else:
+                    iter_values = iter(obj)
+                    if max_length is not None:
+                        iter_values = islice(iter_values, max_length)
+                    for index, child in enumerate(iter_values):
+                        child_node = _traverse(child, depth=depth + 1)
+                        child_node.last = index == last_item_index
+                        append(child_node)
+                if max_length is not None and num_items > max_length:
+                    append(Node(value_repr=f"... +{num_items - max_length}", last=True))
+            else:
+                node = Node(empty=empty, children=[], last=root)
+
+            pop_visited(obj_id)
+        else:
+            node = Node(value_repr=to_repr(obj), last=root)
+        node.is_tuple = type(obj) == tuple
+        node.is_namedtuple = _is_namedtuple(obj)
+        return node
+
+    node = _traverse(_object, root=True)
+    return node
+
+
+def pretty_repr(
+    _object: Any,
+    *,
+    max_width: int = 80,
+    indent_size: int = 4,
+    max_length: Optional[int] = None,
+    max_string: Optional[int] = None,
+    max_depth: Optional[int] = None,
+    expand_all: bool = False,
+) -> str:
+    """Prettify repr string by expanding on to new lines to fit within a given width.
+
+    Args:
+        _object (Any): Object to repr.
+        max_width (int, optional): Desired maximum width of repr string. Defaults to 80.
+        indent_size (int, optional): Number of spaces to indent. Defaults to 4.
+        max_length (int, optional): Maximum length of containers before abbreviating, or None for no abbreviation.
+            Defaults to None.
+        max_string (int, optional): Maximum length of string before truncating, or None to disable truncating.
+            Defaults to None.
+        max_depth (int, optional): Maximum depth of nested data structure, or None for no depth.
+            Defaults to None.
+        expand_all (bool, optional): Expand all containers regardless of available width. Defaults to False.
+
+    Returns:
+        str: A possibly multi-line representation of the object.
+    """
+
+    if _safe_isinstance(_object, Node):
+        node = _object
+    else:
+        node = traverse(
+            _object, max_length=max_length, max_string=max_string, max_depth=max_depth
+        )
+    repr_str: str = node.render(
+        max_width=max_width, indent_size=indent_size, expand_all=expand_all
+    )
+    return repr_str
+
+
+def pprint(
+    _object: Any,
+    *,
+    console: Optional["Console"] = None,
+    indent_guides: bool = True,
+    max_length: Optional[int] = None,
+    max_string: Optional[int] = None,
+    max_depth: Optional[int] = None,
+    expand_all: bool = False,
+) -> None:
+    """A convenience function for pretty printing.
+
+    Args:
+        _object (Any): Object to pretty print.
+        console (Console, optional): Console instance, or None to use default. Defaults to None.
+        max_length (int, optional): Maximum length of containers before abbreviating, or None for no abbreviation.
+            Defaults to None.
+        max_string (int, optional): Maximum length of strings before truncating, or None to disable. Defaults to None.
+        max_depth (int, optional): Maximum depth for nested data structures, or None for unlimited depth. Defaults to None.
+        indent_guides (bool, optional): Enable indentation guides. Defaults to True.
+        expand_all (bool, optional): Expand all containers. Defaults to False.
+    """
+    _console = get_console() if console is None else console
+    _console.print(
+        Pretty(
+            _object,
+            max_length=max_length,
+            max_string=max_string,
+            max_depth=max_depth,
+            indent_guides=indent_guides,
+            expand_all=expand_all,
+            overflow="ignore",
+        ),
+        soft_wrap=True,
+    )
+
+
+if __name__ == "__main__":  # pragma: no cover
+
+    class BrokenRepr:
+        def __repr__(self) -> str:
+            1 / 0
+            return "this will fail"
+
+    from typing import NamedTuple
+
+    class StockKeepingUnit(NamedTuple):
+        name: str
+        description: str
+        price: float
+        category: str
+        reviews: List[str]
+
+    d = defaultdict(int)
+    d["foo"] = 5
+    data = {
+        "foo": [
+            1,
+            "Hello World!",
+            100.123,
+            323.232,
+            432324.0,
+            {5, 6, 7, (1, 2, 3, 4), 8},
+        ],
+        "bar": frozenset({1, 2, 3}),
+        "defaultdict": defaultdict(
+            list, {"crumble": ["apple", "rhubarb", "butter", "sugar", "flour"]}
+        ),
+        "counter": Counter(
+            [
+                "apple",
+                "orange",
+                "pear",
+                "kumquat",
+                "kumquat",
+                "durian" * 100,
+            ]
+        ),
+        "atomic": (False, True, None),
+        "namedtuple": StockKeepingUnit(
+            "Sparkling British Spring Water",
+            "Carbonated spring water",
+            0.9,
+            "water",
+            ["its amazing!", "its terrible!"],
+        ),
+        "Broken": BrokenRepr(),
+    }
+    data["foo"].append(data)  # type: ignore[attr-defined]
+
+    from pip._vendor.rich import print
+
+    print(Pretty(data, indent_guides=True, max_string=20))
+
+    class Thing:
+        def __repr__(self) -> str:
+            return "Hello\x1b[38;5;239m World!"
+
+    print(Pretty(Thing()))
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/progress.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/progress.py
new file mode 100644
index 0000000..ec086d9
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/progress.py
@@ -0,0 +1,1715 @@
+import io
+import sys
+import typing
+import warnings
+from abc import ABC, abstractmethod
+from collections import deque
+from dataclasses import dataclass, field
+from datetime import timedelta
+from io import RawIOBase, UnsupportedOperation
+from math import ceil
+from mmap import mmap
+from operator import length_hint
+from os import PathLike, stat
+from threading import Event, RLock, Thread
+from types import TracebackType
+from typing import (
+    Any,
+    BinaryIO,
+    Callable,
+    ContextManager,
+    Deque,
+    Dict,
+    Generic,
+    Iterable,
+    List,
+    NamedTuple,
+    NewType,
+    Optional,
+    Sequence,
+    TextIO,
+    Tuple,
+    Type,
+    TypeVar,
+    Union,
+)
+
+if sys.version_info >= (3, 8):
+    from typing import Literal
+else:
+    from pip._vendor.typing_extensions import Literal  # pragma: no cover
+
+if sys.version_info >= (3, 11):
+    from typing import Self
+else:
+    from pip._vendor.typing_extensions import Self  # pragma: no cover
+
+from . import filesize, get_console
+from .console import Console, Group, JustifyMethod, RenderableType
+from .highlighter import Highlighter
+from .jupyter import JupyterMixin
+from .live import Live
+from .progress_bar import ProgressBar
+from .spinner import Spinner
+from .style import StyleType
+from .table import Column, Table
+from .text import Text, TextType
+
+TaskID = NewType("TaskID", int)
+
+ProgressType = TypeVar("ProgressType")
+
+GetTimeCallable = Callable[[], float]
+
+
+_I = typing.TypeVar("_I", TextIO, BinaryIO)
+
+
+class _TrackThread(Thread):
+    """A thread to periodically update progress."""
+
+    def __init__(self, progress: "Progress", task_id: "TaskID", update_period: float):
+        self.progress = progress
+        self.task_id = task_id
+        self.update_period = update_period
+        self.done = Event()
+
+        self.completed = 0
+        super().__init__(daemon=True)
+
+    def run(self) -> None:
+        task_id = self.task_id
+        advance = self.progress.advance
+        update_period = self.update_period
+        last_completed = 0
+        wait = self.done.wait
+        while not wait(update_period) and self.progress.live.is_started:
+            completed = self.completed
+            if last_completed != completed:
+                advance(task_id, completed - last_completed)
+                last_completed = completed
+
+        self.progress.update(self.task_id, completed=self.completed, refresh=True)
+
+    def __enter__(self) -> "_TrackThread":
+        self.start()
+        return self
+
+    def __exit__(
+        self,
+        exc_type: Optional[Type[BaseException]],
+        exc_val: Optional[BaseException],
+        exc_tb: Optional[TracebackType],
+    ) -> None:
+        self.done.set()
+        self.join()
+
+
+def track(
+    sequence: Union[Sequence[ProgressType], Iterable[ProgressType]],
+    description: str = "Working...",
+    total: Optional[float] = None,
+    completed: int = 0,
+    auto_refresh: bool = True,
+    console: Optional[Console] = None,
+    transient: bool = False,
+    get_time: Optional[Callable[[], float]] = None,
+    refresh_per_second: float = 10,
+    style: StyleType = "bar.back",
+    complete_style: StyleType = "bar.complete",
+    finished_style: StyleType = "bar.finished",
+    pulse_style: StyleType = "bar.pulse",
+    update_period: float = 0.1,
+    disable: bool = False,
+    show_speed: bool = True,
+) -> Iterable[ProgressType]:
+    """Track progress by iterating over a sequence.
+
+    Args:
+        sequence (Iterable[ProgressType]): A sequence (must support "len") you wish to iterate over.
+        description (str, optional): Description of task show next to progress bar. Defaults to "Working".
+        total: (float, optional): Total number of steps. Default is len(sequence).
+        completed (int, optional): Number of steps completed so far. Defaults to 0.
+        auto_refresh (bool, optional): Automatic refresh, disable to force a refresh after each iteration. Default is True.
+        transient: (bool, optional): Clear the progress on exit. Defaults to False.
+        console (Console, optional): Console to write to. Default creates internal Console instance.
+        refresh_per_second (float): Number of times per second to refresh the progress information. Defaults to 10.
+        style (StyleType, optional): Style for the bar background. Defaults to "bar.back".
+        complete_style (StyleType, optional): Style for the completed bar. Defaults to "bar.complete".
+        finished_style (StyleType, optional): Style for a finished bar. Defaults to "bar.finished".
+        pulse_style (StyleType, optional): Style for pulsing bars. Defaults to "bar.pulse".
+        update_period (float, optional): Minimum time (in seconds) between calls to update(). Defaults to 0.1.
+        disable (bool, optional): Disable display of progress.
+        show_speed (bool, optional): Show speed if total isn't known. Defaults to True.
+    Returns:
+        Iterable[ProgressType]: An iterable of the values in the sequence.
+
+    """
+
+    columns: List["ProgressColumn"] = (
+        [TextColumn("[progress.description]{task.description}")] if description else []
+    )
+    columns.extend(
+        (
+            BarColumn(
+                style=style,
+                complete_style=complete_style,
+                finished_style=finished_style,
+                pulse_style=pulse_style,
+            ),
+            TaskProgressColumn(show_speed=show_speed),
+            TimeRemainingColumn(elapsed_when_finished=True),
+        )
+    )
+    progress = Progress(
+        *columns,
+        auto_refresh=auto_refresh,
+        console=console,
+        transient=transient,
+        get_time=get_time,
+        refresh_per_second=refresh_per_second or 10,
+        disable=disable,
+    )
+
+    with progress:
+        yield from progress.track(
+            sequence,
+            total=total,
+            completed=completed,
+            description=description,
+            update_period=update_period,
+        )
+
+
+class _Reader(RawIOBase, BinaryIO):
+    """A reader that tracks progress while it's being read from."""
+
+    def __init__(
+        self,
+        handle: BinaryIO,
+        progress: "Progress",
+        task: TaskID,
+        close_handle: bool = True,
+    ) -> None:
+        self.handle = handle
+        self.progress = progress
+        self.task = task
+        self.close_handle = close_handle
+        self._closed = False
+
+    def __enter__(self) -> "_Reader":
+        self.handle.__enter__()
+        return self
+
+    def __exit__(
+        self,
+        exc_type: Optional[Type[BaseException]],
+        exc_val: Optional[BaseException],
+        exc_tb: Optional[TracebackType],
+    ) -> None:
+        self.close()
+
+    def __iter__(self) -> BinaryIO:
+        return self
+
+    def __next__(self) -> bytes:
+        line = next(self.handle)
+        self.progress.advance(self.task, advance=len(line))
+        return line
+
+    @property
+    def closed(self) -> bool:
+        return self._closed
+
+    def fileno(self) -> int:
+        return self.handle.fileno()
+
+    def isatty(self) -> bool:
+        return self.handle.isatty()
+
+    @property
+    def mode(self) -> str:
+        return self.handle.mode
+
+    @property
+    def name(self) -> str:
+        return self.handle.name
+
+    def readable(self) -> bool:
+        return self.handle.readable()
+
+    def seekable(self) -> bool:
+        return self.handle.seekable()
+
+    def writable(self) -> bool:
+        return False
+
+    def read(self, size: int = -1) -> bytes:
+        block = self.handle.read(size)
+        self.progress.advance(self.task, advance=len(block))
+        return block
+
+    def readinto(self, b: Union[bytearray, memoryview, mmap]):  # type: ignore[no-untyped-def, override]
+        n = self.handle.readinto(b)  # type: ignore[attr-defined]
+        self.progress.advance(self.task, advance=n)
+        return n
+
+    def readline(self, size: int = -1) -> bytes:  # type: ignore[override]
+        line = self.handle.readline(size)
+        self.progress.advance(self.task, advance=len(line))
+        return line
+
+    def readlines(self, hint: int = -1) -> List[bytes]:
+        lines = self.handle.readlines(hint)
+        self.progress.advance(self.task, advance=sum(map(len, lines)))
+        return lines
+
+    def close(self) -> None:
+        if self.close_handle:
+            self.handle.close()
+        self._closed = True
+
+    def seek(self, offset: int, whence: int = 0) -> int:
+        pos = self.handle.seek(offset, whence)
+        self.progress.update(self.task, completed=pos)
+        return pos
+
+    def tell(self) -> int:
+        return self.handle.tell()
+
+    def write(self, s: Any) -> int:
+        raise UnsupportedOperation("write")
+
+    def writelines(self, lines: Iterable[Any]) -> None:
+        raise UnsupportedOperation("writelines")
+
+
+class _ReadContext(ContextManager[_I], Generic[_I]):
+    """A utility class to handle a context for both a reader and a progress."""
+
+    def __init__(self, progress: "Progress", reader: _I) -> None:
+        self.progress = progress
+        self.reader: _I = reader
+
+    def __enter__(self) -> _I:
+        self.progress.start()
+        return self.reader.__enter__()
+
+    def __exit__(
+        self,
+        exc_type: Optional[Type[BaseException]],
+        exc_val: Optional[BaseException],
+        exc_tb: Optional[TracebackType],
+    ) -> None:
+        self.progress.stop()
+        self.reader.__exit__(exc_type, exc_val, exc_tb)
+
+
+def wrap_file(
+    file: BinaryIO,
+    total: int,
+    *,
+    description: str = "Reading...",
+    auto_refresh: bool = True,
+    console: Optional[Console] = None,
+    transient: bool = False,
+    get_time: Optional[Callable[[], float]] = None,
+    refresh_per_second: float = 10,
+    style: StyleType = "bar.back",
+    complete_style: StyleType = "bar.complete",
+    finished_style: StyleType = "bar.finished",
+    pulse_style: StyleType = "bar.pulse",
+    disable: bool = False,
+) -> ContextManager[BinaryIO]:
+    """Read bytes from a file while tracking progress.
+
+    Args:
+        file (Union[str, PathLike[str], BinaryIO]): The path to the file to read, or a file-like object in binary mode.
+        total (int): Total number of bytes to read.
+        description (str, optional): Description of task show next to progress bar. Defaults to "Reading".
+        auto_refresh (bool, optional): Automatic refresh, disable to force a refresh after each iteration. Default is True.
+        transient: (bool, optional): Clear the progress on exit. Defaults to False.
+        console (Console, optional): Console to write to. Default creates internal Console instance.
+        refresh_per_second (float): Number of times per second to refresh the progress information. Defaults to 10.
+        style (StyleType, optional): Style for the bar background. Defaults to "bar.back".
+        complete_style (StyleType, optional): Style for the completed bar. Defaults to "bar.complete".
+        finished_style (StyleType, optional): Style for a finished bar. Defaults to "bar.finished".
+        pulse_style (StyleType, optional): Style for pulsing bars. Defaults to "bar.pulse".
+        disable (bool, optional): Disable display of progress.
+    Returns:
+        ContextManager[BinaryIO]: A context manager yielding a progress reader.
+
+    """
+
+    columns: List["ProgressColumn"] = (
+        [TextColumn("[progress.description]{task.description}")] if description else []
+    )
+    columns.extend(
+        (
+            BarColumn(
+                style=style,
+                complete_style=complete_style,
+                finished_style=finished_style,
+                pulse_style=pulse_style,
+            ),
+            DownloadColumn(),
+            TimeRemainingColumn(),
+        )
+    )
+    progress = Progress(
+        *columns,
+        auto_refresh=auto_refresh,
+        console=console,
+        transient=transient,
+        get_time=get_time,
+        refresh_per_second=refresh_per_second or 10,
+        disable=disable,
+    )
+
+    reader = progress.wrap_file(file, total=total, description=description)
+    return _ReadContext(progress, reader)
+
+
+@typing.overload
+def open(
+    file: Union[str, "PathLike[str]", bytes],
+    mode: Union[Literal["rt"], Literal["r"]],
+    buffering: int = -1,
+    encoding: Optional[str] = None,
+    errors: Optional[str] = None,
+    newline: Optional[str] = None,
+    *,
+    total: Optional[int] = None,
+    description: str = "Reading...",
+    auto_refresh: bool = True,
+    console: Optional[Console] = None,
+    transient: bool = False,
+    get_time: Optional[Callable[[], float]] = None,
+    refresh_per_second: float = 10,
+    style: StyleType = "bar.back",
+    complete_style: StyleType = "bar.complete",
+    finished_style: StyleType = "bar.finished",
+    pulse_style: StyleType = "bar.pulse",
+    disable: bool = False,
+) -> ContextManager[TextIO]:
+    pass
+
+
+@typing.overload
+def open(
+    file: Union[str, "PathLike[str]", bytes],
+    mode: Literal["rb"],
+    buffering: int = -1,
+    encoding: Optional[str] = None,
+    errors: Optional[str] = None,
+    newline: Optional[str] = None,
+    *,
+    total: Optional[int] = None,
+    description: str = "Reading...",
+    auto_refresh: bool = True,
+    console: Optional[Console] = None,
+    transient: bool = False,
+    get_time: Optional[Callable[[], float]] = None,
+    refresh_per_second: float = 10,
+    style: StyleType = "bar.back",
+    complete_style: StyleType = "bar.complete",
+    finished_style: StyleType = "bar.finished",
+    pulse_style: StyleType = "bar.pulse",
+    disable: bool = False,
+) -> ContextManager[BinaryIO]:
+    pass
+
+
+def open(
+    file: Union[str, "PathLike[str]", bytes],
+    mode: Union[Literal["rb"], Literal["rt"], Literal["r"]] = "r",
+    buffering: int = -1,
+    encoding: Optional[str] = None,
+    errors: Optional[str] = None,
+    newline: Optional[str] = None,
+    *,
+    total: Optional[int] = None,
+    description: str = "Reading...",
+    auto_refresh: bool = True,
+    console: Optional[Console] = None,
+    transient: bool = False,
+    get_time: Optional[Callable[[], float]] = None,
+    refresh_per_second: float = 10,
+    style: StyleType = "bar.back",
+    complete_style: StyleType = "bar.complete",
+    finished_style: StyleType = "bar.finished",
+    pulse_style: StyleType = "bar.pulse",
+    disable: bool = False,
+) -> Union[ContextManager[BinaryIO], ContextManager[TextIO]]:
+    """Read bytes from a file while tracking progress.
+
+    Args:
+        path (Union[str, PathLike[str], BinaryIO]): The path to the file to read, or a file-like object in binary mode.
+        mode (str): The mode to use to open the file. Only supports "r", "rb" or "rt".
+        buffering (int): The buffering strategy to use, see :func:`io.open`.
+        encoding (str, optional): The encoding to use when reading in text mode, see :func:`io.open`.
+        errors (str, optional): The error handling strategy for decoding errors, see :func:`io.open`.
+        newline (str, optional): The strategy for handling newlines in text mode, see :func:`io.open`
+        total: (int, optional): Total number of bytes to read. Must be provided if reading from a file handle. Default for a path is os.stat(file).st_size.
+        description (str, optional): Description of task show next to progress bar. Defaults to "Reading".
+        auto_refresh (bool, optional): Automatic refresh, disable to force a refresh after each iteration. Default is True.
+        transient: (bool, optional): Clear the progress on exit. Defaults to False.
+        console (Console, optional): Console to write to. Default creates internal Console instance.
+        refresh_per_second (float): Number of times per second to refresh the progress information. Defaults to 10.
+        style (StyleType, optional): Style for the bar background. Defaults to "bar.back".
+        complete_style (StyleType, optional): Style for the completed bar. Defaults to "bar.complete".
+        finished_style (StyleType, optional): Style for a finished bar. Defaults to "bar.finished".
+        pulse_style (StyleType, optional): Style for pulsing bars. Defaults to "bar.pulse".
+        disable (bool, optional): Disable display of progress.
+        encoding (str, optional): The encoding to use when reading in text mode.
+
+    Returns:
+        ContextManager[BinaryIO]: A context manager yielding a progress reader.
+
+    """
+
+    columns: List["ProgressColumn"] = (
+        [TextColumn("[progress.description]{task.description}")] if description else []
+    )
+    columns.extend(
+        (
+            BarColumn(
+                style=style,
+                complete_style=complete_style,
+                finished_style=finished_style,
+                pulse_style=pulse_style,
+            ),
+            DownloadColumn(),
+            TimeRemainingColumn(),
+        )
+    )
+    progress = Progress(
+        *columns,
+        auto_refresh=auto_refresh,
+        console=console,
+        transient=transient,
+        get_time=get_time,
+        refresh_per_second=refresh_per_second or 10,
+        disable=disable,
+    )
+
+    reader = progress.open(
+        file,
+        mode=mode,
+        buffering=buffering,
+        encoding=encoding,
+        errors=errors,
+        newline=newline,
+        total=total,
+        description=description,
+    )
+    return _ReadContext(progress, reader)  # type: ignore[return-value, type-var]
+
+
+class ProgressColumn(ABC):
+    """Base class for a widget to use in progress display."""
+
+    max_refresh: Optional[float] = None
+
+    def __init__(self, table_column: Optional[Column] = None) -> None:
+        self._table_column = table_column
+        self._renderable_cache: Dict[TaskID, Tuple[float, RenderableType]] = {}
+        self._update_time: Optional[float] = None
+
+    def get_table_column(self) -> Column:
+        """Get a table column, used to build tasks table."""
+        return self._table_column or Column()
+
+    def __call__(self, task: "Task") -> RenderableType:
+        """Called by the Progress object to return a renderable for the given task.
+
+        Args:
+            task (Task): An object containing information regarding the task.
+
+        Returns:
+            RenderableType: Anything renderable (including str).
+        """
+        current_time = task.get_time()
+        if self.max_refresh is not None and not task.completed:
+            try:
+                timestamp, renderable = self._renderable_cache[task.id]
+            except KeyError:
+                pass
+            else:
+                if timestamp + self.max_refresh > current_time:
+                    return renderable
+
+        renderable = self.render(task)
+        self._renderable_cache[task.id] = (current_time, renderable)
+        return renderable
+
+    @abstractmethod
+    def render(self, task: "Task") -> RenderableType:
+        """Should return a renderable object."""
+
+
+class RenderableColumn(ProgressColumn):
+    """A column to insert an arbitrary column.
+
+    Args:
+        renderable (RenderableType, optional): Any renderable. Defaults to empty string.
+    """
+
+    def __init__(
+        self, renderable: RenderableType = "", *, table_column: Optional[Column] = None
+    ):
+        self.renderable = renderable
+        super().__init__(table_column=table_column)
+
+    def render(self, task: "Task") -> RenderableType:
+        return self.renderable
+
+
+class SpinnerColumn(ProgressColumn):
+    """A column with a 'spinner' animation.
+
+    Args:
+        spinner_name (str, optional): Name of spinner animation. Defaults to "dots".
+        style (StyleType, optional): Style of spinner. Defaults to "progress.spinner".
+        speed (float, optional): Speed factor of spinner. Defaults to 1.0.
+        finished_text (TextType, optional): Text used when task is finished. Defaults to " ".
+    """
+
+    def __init__(
+        self,
+        spinner_name: str = "dots",
+        style: Optional[StyleType] = "progress.spinner",
+        speed: float = 1.0,
+        finished_text: TextType = " ",
+        table_column: Optional[Column] = None,
+    ):
+        self.spinner = Spinner(spinner_name, style=style, speed=speed)
+        self.finished_text = (
+            Text.from_markup(finished_text)
+            if isinstance(finished_text, str)
+            else finished_text
+        )
+        super().__init__(table_column=table_column)
+
+    def set_spinner(
+        self,
+        spinner_name: str,
+        spinner_style: Optional[StyleType] = "progress.spinner",
+        speed: float = 1.0,
+    ) -> None:
+        """Set a new spinner.
+
+        Args:
+            spinner_name (str): Spinner name, see python -m rich.spinner.
+            spinner_style (Optional[StyleType], optional): Spinner style. Defaults to "progress.spinner".
+            speed (float, optional): Speed factor of spinner. Defaults to 1.0.
+        """
+        self.spinner = Spinner(spinner_name, style=spinner_style, speed=speed)
+
+    def render(self, task: "Task") -> RenderableType:
+        text = (
+            self.finished_text
+            if task.finished
+            else self.spinner.render(task.get_time())
+        )
+        return text
+
+
+class TextColumn(ProgressColumn):
+    """A column containing text."""
+
+    def __init__(
+        self,
+        text_format: str,
+        style: StyleType = "none",
+        justify: JustifyMethod = "left",
+        markup: bool = True,
+        highlighter: Optional[Highlighter] = None,
+        table_column: Optional[Column] = None,
+    ) -> None:
+        self.text_format = text_format
+        self.justify: JustifyMethod = justify
+        self.style = style
+        self.markup = markup
+        self.highlighter = highlighter
+        super().__init__(table_column=table_column or Column(no_wrap=True))
+
+    def render(self, task: "Task") -> Text:
+        _text = self.text_format.format(task=task)
+        if self.markup:
+            text = Text.from_markup(_text, style=self.style, justify=self.justify)
+        else:
+            text = Text(_text, style=self.style, justify=self.justify)
+        if self.highlighter:
+            self.highlighter.highlight(text)
+        return text
+
+
+class BarColumn(ProgressColumn):
+    """Renders a visual progress bar.
+
+    Args:
+        bar_width (Optional[int], optional): Width of bar or None for full width. Defaults to 40.
+        style (StyleType, optional): Style for the bar background. Defaults to "bar.back".
+        complete_style (StyleType, optional): Style for the completed bar. Defaults to "bar.complete".
+        finished_style (StyleType, optional): Style for a finished bar. Defaults to "bar.finished".
+        pulse_style (StyleType, optional): Style for pulsing bars. Defaults to "bar.pulse".
+    """
+
+    def __init__(
+        self,
+        bar_width: Optional[int] = 40,
+        style: StyleType = "bar.back",
+        complete_style: StyleType = "bar.complete",
+        finished_style: StyleType = "bar.finished",
+        pulse_style: StyleType = "bar.pulse",
+        table_column: Optional[Column] = None,
+    ) -> None:
+        self.bar_width = bar_width
+        self.style = style
+        self.complete_style = complete_style
+        self.finished_style = finished_style
+        self.pulse_style = pulse_style
+        super().__init__(table_column=table_column)
+
+    def render(self, task: "Task") -> ProgressBar:
+        """Gets a progress bar widget for a task."""
+        return ProgressBar(
+            total=max(0, task.total) if task.total is not None else None,
+            completed=max(0, task.completed),
+            width=None if self.bar_width is None else max(1, self.bar_width),
+            pulse=not task.started,
+            animation_time=task.get_time(),
+            style=self.style,
+            complete_style=self.complete_style,
+            finished_style=self.finished_style,
+            pulse_style=self.pulse_style,
+        )
+
+
+class TimeElapsedColumn(ProgressColumn):
+    """Renders time elapsed."""
+
+    def render(self, task: "Task") -> Text:
+        """Show time elapsed."""
+        elapsed = task.finished_time if task.finished else task.elapsed
+        if elapsed is None:
+            return Text("-:--:--", style="progress.elapsed")
+        delta = timedelta(seconds=max(0, int(elapsed)))
+        return Text(str(delta), style="progress.elapsed")
+
+
+class TaskProgressColumn(TextColumn):
+    """Show task progress as a percentage.
+
+    Args:
+        text_format (str, optional): Format for percentage display. Defaults to "[progress.percentage]{task.percentage:>3.0f}%".
+        text_format_no_percentage (str, optional): Format if percentage is unknown. Defaults to "".
+        style (StyleType, optional): Style of output. Defaults to "none".
+        justify (JustifyMethod, optional): Text justification. Defaults to "left".
+        markup (bool, optional): Enable markup. Defaults to True.
+        highlighter (Optional[Highlighter], optional): Highlighter to apply to output. Defaults to None.
+        table_column (Optional[Column], optional): Table Column to use. Defaults to None.
+        show_speed (bool, optional): Show speed if total is unknown. Defaults to False.
+    """
+
+    def __init__(
+        self,
+        text_format: str = "[progress.percentage]{task.percentage:>3.0f}%",
+        text_format_no_percentage: str = "",
+        style: StyleType = "none",
+        justify: JustifyMethod = "left",
+        markup: bool = True,
+        highlighter: Optional[Highlighter] = None,
+        table_column: Optional[Column] = None,
+        show_speed: bool = False,
+    ) -> None:
+        self.text_format_no_percentage = text_format_no_percentage
+        self.show_speed = show_speed
+        super().__init__(
+            text_format=text_format,
+            style=style,
+            justify=justify,
+            markup=markup,
+            highlighter=highlighter,
+            table_column=table_column,
+        )
+
+    @classmethod
+    def render_speed(cls, speed: Optional[float]) -> Text:
+        """Render the speed in iterations per second.
+
+        Args:
+            task (Task): A Task object.
+
+        Returns:
+            Text: Text object containing the task speed.
+        """
+        if speed is None:
+            return Text("", style="progress.percentage")
+        unit, suffix = filesize.pick_unit_and_suffix(
+            int(speed),
+            ["", "×10³", "×10⁶", "×10⁹", "×10¹²"],
+            1000,
+        )
+        data_speed = speed / unit
+        return Text(f"{data_speed:.1f}{suffix} it/s", style="progress.percentage")
+
+    def render(self, task: "Task") -> Text:
+        if task.total is None and self.show_speed:
+            return self.render_speed(task.finished_speed or task.speed)
+        text_format = (
+            self.text_format_no_percentage if task.total is None else self.text_format
+        )
+        _text = text_format.format(task=task)
+        if self.markup:
+            text = Text.from_markup(_text, style=self.style, justify=self.justify)
+        else:
+            text = Text(_text, style=self.style, justify=self.justify)
+        if self.highlighter:
+            self.highlighter.highlight(text)
+        return text
+
+
+class TimeRemainingColumn(ProgressColumn):
+    """Renders estimated time remaining.
+
+    Args:
+        compact (bool, optional): Render MM:SS when time remaining is less than an hour. Defaults to False.
+        elapsed_when_finished (bool, optional): Render time elapsed when the task is finished. Defaults to False.
+    """
+
+    # Only refresh twice a second to prevent jitter
+    max_refresh = 0.5
+
+    def __init__(
+        self,
+        compact: bool = False,
+        elapsed_when_finished: bool = False,
+        table_column: Optional[Column] = None,
+    ):
+        self.compact = compact
+        self.elapsed_when_finished = elapsed_when_finished
+        super().__init__(table_column=table_column)
+
+    def render(self, task: "Task") -> Text:
+        """Show time remaining."""
+        if self.elapsed_when_finished and task.finished:
+            task_time = task.finished_time
+            style = "progress.elapsed"
+        else:
+            task_time = task.time_remaining
+            style = "progress.remaining"
+
+        if task.total is None:
+            return Text("", style=style)
+
+        if task_time is None:
+            return Text("--:--" if self.compact else "-:--:--", style=style)
+
+        # Based on https://github.com/tqdm/tqdm/blob/master/tqdm/std.py
+        minutes, seconds = divmod(int(task_time), 60)
+        hours, minutes = divmod(minutes, 60)
+
+        if self.compact and not hours:
+            formatted = f"{minutes:02d}:{seconds:02d}"
+        else:
+            formatted = f"{hours:d}:{minutes:02d}:{seconds:02d}"
+
+        return Text(formatted, style=style)
+
+
+class FileSizeColumn(ProgressColumn):
+    """Renders completed filesize."""
+
+    def render(self, task: "Task") -> Text:
+        """Show data completed."""
+        data_size = filesize.decimal(int(task.completed))
+        return Text(data_size, style="progress.filesize")
+
+
+class TotalFileSizeColumn(ProgressColumn):
+    """Renders total filesize."""
+
+    def render(self, task: "Task") -> Text:
+        """Show data completed."""
+        data_size = filesize.decimal(int(task.total)) if task.total is not None else ""
+        return Text(data_size, style="progress.filesize.total")
+
+
+class MofNCompleteColumn(ProgressColumn):
+    """Renders completed count/total, e.g. '  10/1000'.
+
+    Best for bounded tasks with int quantities.
+
+    Space pads the completed count so that progress length does not change as task progresses
+    past powers of 10.
+
+    Args:
+        separator (str, optional): Text to separate completed and total values. Defaults to "/".
+    """
+
+    def __init__(self, separator: str = "/", table_column: Optional[Column] = None):
+        self.separator = separator
+        super().__init__(table_column=table_column)
+
+    def render(self, task: "Task") -> Text:
+        """Show completed/total."""
+        completed = int(task.completed)
+        total = int(task.total) if task.total is not None else "?"
+        total_width = len(str(total))
+        return Text(
+            f"{completed:{total_width}d}{self.separator}{total}",
+            style="progress.download",
+        )
+
+
+class DownloadColumn(ProgressColumn):
+    """Renders file size downloaded and total, e.g. '0.5/2.3 GB'.
+
+    Args:
+        binary_units (bool, optional): Use binary units, KiB, MiB etc. Defaults to False.
+    """
+
+    def __init__(
+        self, binary_units: bool = False, table_column: Optional[Column] = None
+    ) -> None:
+        self.binary_units = binary_units
+        super().__init__(table_column=table_column)
+
+    def render(self, task: "Task") -> Text:
+        """Calculate common unit for completed and total."""
+        completed = int(task.completed)
+
+        unit_and_suffix_calculation_base = (
+            int(task.total) if task.total is not None else completed
+        )
+        if self.binary_units:
+            unit, suffix = filesize.pick_unit_and_suffix(
+                unit_and_suffix_calculation_base,
+                ["bytes", "KiB", "MiB", "GiB", "TiB", "PiB", "EiB", "ZiB", "YiB"],
+                1024,
+            )
+        else:
+            unit, suffix = filesize.pick_unit_and_suffix(
+                unit_and_suffix_calculation_base,
+                ["bytes", "kB", "MB", "GB", "TB", "PB", "EB", "ZB", "YB"],
+                1000,
+            )
+        precision = 0 if unit == 1 else 1
+
+        completed_ratio = completed / unit
+        completed_str = f"{completed_ratio:,.{precision}f}"
+
+        if task.total is not None:
+            total = int(task.total)
+            total_ratio = total / unit
+            total_str = f"{total_ratio:,.{precision}f}"
+        else:
+            total_str = "?"
+
+        download_status = f"{completed_str}/{total_str} {suffix}"
+        download_text = Text(download_status, style="progress.download")
+        return download_text
+
+
+class TransferSpeedColumn(ProgressColumn):
+    """Renders human readable transfer speed."""
+
+    def render(self, task: "Task") -> Text:
+        """Show data transfer speed."""
+        speed = task.finished_speed or task.speed
+        if speed is None:
+            return Text("?", style="progress.data.speed")
+        data_speed = filesize.decimal(int(speed))
+        return Text(f"{data_speed}/s", style="progress.data.speed")
+
+
+class ProgressSample(NamedTuple):
+    """Sample of progress for a given time."""
+
+    timestamp: float
+    """Timestamp of sample."""
+    completed: float
+    """Number of steps completed."""
+
+
+@dataclass
+class Task:
+    """Information regarding a progress task.
+
+    This object should be considered read-only outside of the :class:`~Progress` class.
+
+    """
+
+    id: TaskID
+    """Task ID associated with this task (used in Progress methods)."""
+
+    description: str
+    """str: Description of the task."""
+
+    total: Optional[float]
+    """Optional[float]: Total number of steps in this task."""
+
+    completed: float
+    """float: Number of steps completed"""
+
+    _get_time: GetTimeCallable
+    """Callable to get the current time."""
+
+    finished_time: Optional[float] = None
+    """float: Time task was finished."""
+
+    visible: bool = True
+    """bool: Indicates if this task is visible in the progress display."""
+
+    fields: Dict[str, Any] = field(default_factory=dict)
+    """dict: Arbitrary fields passed in via Progress.update."""
+
+    start_time: Optional[float] = field(default=None, init=False, repr=False)
+    """Optional[float]: Time this task was started, or None if not started."""
+
+    stop_time: Optional[float] = field(default=None, init=False, repr=False)
+    """Optional[float]: Time this task was stopped, or None if not stopped."""
+
+    finished_speed: Optional[float] = None
+    """Optional[float]: The last speed for a finished task."""
+
+    _progress: Deque[ProgressSample] = field(
+        default_factory=lambda: deque(maxlen=1000), init=False, repr=False
+    )
+
+    _lock: RLock = field(repr=False, default_factory=RLock)
+    """Thread lock."""
+
+    def get_time(self) -> float:
+        """float: Get the current time, in seconds."""
+        return self._get_time()
+
+    @property
+    def started(self) -> bool:
+        """bool: Check if the task as started."""
+        return self.start_time is not None
+
+    @property
+    def remaining(self) -> Optional[float]:
+        """Optional[float]: Get the number of steps remaining, if a non-None total was set."""
+        if self.total is None:
+            return None
+        return self.total - self.completed
+
+    @property
+    def elapsed(self) -> Optional[float]:
+        """Optional[float]: Time elapsed since task was started, or ``None`` if the task hasn't started."""
+        if self.start_time is None:
+            return None
+        if self.stop_time is not None:
+            return self.stop_time - self.start_time
+        return self.get_time() - self.start_time
+
+    @property
+    def finished(self) -> bool:
+        """Check if the task has finished."""
+        return self.finished_time is not None
+
+    @property
+    def percentage(self) -> float:
+        """float: Get progress of task as a percentage. If a None total was set, returns 0"""
+        if not self.total:
+            return 0.0
+        completed = (self.completed / self.total) * 100.0
+        completed = min(100.0, max(0.0, completed))
+        return completed
+
+    @property
+    def speed(self) -> Optional[float]:
+        """Optional[float]: Get the estimated speed in steps per second."""
+        if self.start_time is None:
+            return None
+        with self._lock:
+            progress = self._progress
+            if not progress:
+                return None
+            total_time = progress[-1].timestamp - progress[0].timestamp
+            if total_time == 0:
+                return None
+            iter_progress = iter(progress)
+            next(iter_progress)
+            total_completed = sum(sample.completed for sample in iter_progress)
+            speed = total_completed / total_time
+            return speed
+
+    @property
+    def time_remaining(self) -> Optional[float]:
+        """Optional[float]: Get estimated time to completion, or ``None`` if no data."""
+        if self.finished:
+            return 0.0
+        speed = self.speed
+        if not speed:
+            return None
+        remaining = self.remaining
+        if remaining is None:
+            return None
+        estimate = ceil(remaining / speed)
+        return estimate
+
+    def _reset(self) -> None:
+        """Reset progress."""
+        self._progress.clear()
+        self.finished_time = None
+        self.finished_speed = None
+
+
+class Progress(JupyterMixin):
+    """Renders an auto-updating progress bar(s).
+
+    Args:
+        console (Console, optional): Optional Console instance. Defaults to an internal Console instance writing to stdout.
+        auto_refresh (bool, optional): Enable auto refresh. If disabled, you will need to call `refresh()`.
+        refresh_per_second (Optional[float], optional): Number of times per second to refresh the progress information or None to use default (10). Defaults to None.
+        speed_estimate_period: (float, optional): Period (in seconds) used to calculate the speed estimate. Defaults to 30.
+        transient: (bool, optional): Clear the progress on exit. Defaults to False.
+        redirect_stdout: (bool, optional): Enable redirection of stdout, so ``print`` may be used. Defaults to True.
+        redirect_stderr: (bool, optional): Enable redirection of stderr. Defaults to True.
+        get_time: (Callable, optional): A callable that gets the current time, or None to use Console.get_time. Defaults to None.
+        disable (bool, optional): Disable progress display. Defaults to False
+        expand (bool, optional): Expand tasks table to fit width. Defaults to False.
+    """
+
+    def __init__(
+        self,
+        *columns: Union[str, ProgressColumn],
+        console: Optional[Console] = None,
+        auto_refresh: bool = True,
+        refresh_per_second: float = 10,
+        speed_estimate_period: float = 30.0,
+        transient: bool = False,
+        redirect_stdout: bool = True,
+        redirect_stderr: bool = True,
+        get_time: Optional[GetTimeCallable] = None,
+        disable: bool = False,
+        expand: bool = False,
+    ) -> None:
+        assert refresh_per_second > 0, "refresh_per_second must be > 0"
+        self._lock = RLock()
+        self.columns = columns or self.get_default_columns()
+        self.speed_estimate_period = speed_estimate_period
+
+        self.disable = disable
+        self.expand = expand
+        self._tasks: Dict[TaskID, Task] = {}
+        self._task_index: TaskID = TaskID(0)
+        self.live = Live(
+            console=console or get_console(),
+            auto_refresh=auto_refresh,
+            refresh_per_second=refresh_per_second,
+            transient=transient,
+            redirect_stdout=redirect_stdout,
+            redirect_stderr=redirect_stderr,
+            get_renderable=self.get_renderable,
+        )
+        self.get_time = get_time or self.console.get_time
+        self.print = self.console.print
+        self.log = self.console.log
+
+    @classmethod
+    def get_default_columns(cls) -> Tuple[ProgressColumn, ...]:
+        """Get the default columns used for a new Progress instance:
+           - a text column for the description (TextColumn)
+           - the bar itself (BarColumn)
+           - a text column showing completion percentage (TextColumn)
+           - an estimated-time-remaining column (TimeRemainingColumn)
+        If the Progress instance is created without passing a columns argument,
+        the default columns defined here will be used.
+
+        You can also create a Progress instance using custom columns before
+        and/or after the defaults, as in this example:
+
+            progress = Progress(
+                SpinnerColumn(),
+                *Progress.get_default_columns(),
+                "Elapsed:",
+                TimeElapsedColumn(),
+            )
+
+        This code shows the creation of a Progress display, containing
+        a spinner to the left, the default columns, and a labeled elapsed
+        time column.
+        """
+        return (
+            TextColumn("[progress.description]{task.description}"),
+            BarColumn(),
+            TaskProgressColumn(),
+            TimeRemainingColumn(),
+        )
+
+    @property
+    def console(self) -> Console:
+        return self.live.console
+
+    @property
+    def tasks(self) -> List[Task]:
+        """Get a list of Task instances."""
+        with self._lock:
+            return list(self._tasks.values())
+
+    @property
+    def task_ids(self) -> List[TaskID]:
+        """A list of task IDs."""
+        with self._lock:
+            return list(self._tasks.keys())
+
+    @property
+    def finished(self) -> bool:
+        """Check if all tasks have been completed."""
+        with self._lock:
+            if not self._tasks:
+                return True
+            return all(task.finished for task in self._tasks.values())
+
+    def start(self) -> None:
+        """Start the progress display."""
+        if not self.disable:
+            self.live.start(refresh=True)
+
+    def stop(self) -> None:
+        """Stop the progress display."""
+        self.live.stop()
+        if not self.console.is_interactive and not self.console.is_jupyter:
+            self.console.print()
+
+    def __enter__(self) -> Self:
+        self.start()
+        return self
+
+    def __exit__(
+        self,
+        exc_type: Optional[Type[BaseException]],
+        exc_val: Optional[BaseException],
+        exc_tb: Optional[TracebackType],
+    ) -> None:
+        self.stop()
+
+    def track(
+        self,
+        sequence: Union[Iterable[ProgressType], Sequence[ProgressType]],
+        total: Optional[float] = None,
+        completed: int = 0,
+        task_id: Optional[TaskID] = None,
+        description: str = "Working...",
+        update_period: float = 0.1,
+    ) -> Iterable[ProgressType]:
+        """Track progress by iterating over a sequence.
+
+        Args:
+            sequence (Sequence[ProgressType]): A sequence of values you want to iterate over and track progress.
+            total: (float, optional): Total number of steps. Default is len(sequence).
+            completed (int, optional): Number of steps completed so far. Defaults to 0.
+            task_id: (TaskID): Task to track. Default is new task.
+            description: (str, optional): Description of task, if new task is created.
+            update_period (float, optional): Minimum time (in seconds) between calls to update(). Defaults to 0.1.
+
+        Returns:
+            Iterable[ProgressType]: An iterable of values taken from the provided sequence.
+        """
+        if total is None:
+            total = float(length_hint(sequence)) or None
+
+        if task_id is None:
+            task_id = self.add_task(description, total=total, completed=completed)
+        else:
+            self.update(task_id, total=total, completed=completed)
+
+        if self.live.auto_refresh:
+            with _TrackThread(self, task_id, update_period) as track_thread:
+                for value in sequence:
+                    yield value
+                    track_thread.completed += 1
+        else:
+            advance = self.advance
+            refresh = self.refresh
+            for value in sequence:
+                yield value
+                advance(task_id, 1)
+                refresh()
+
+    def wrap_file(
+        self,
+        file: BinaryIO,
+        total: Optional[int] = None,
+        *,
+        task_id: Optional[TaskID] = None,
+        description: str = "Reading...",
+    ) -> BinaryIO:
+        """Track progress file reading from a binary file.
+
+        Args:
+            file (BinaryIO): A file-like object opened in binary mode.
+            total (int, optional): Total number of bytes to read. This must be provided unless a task with a total is also given.
+            task_id (TaskID): Task to track. Default is new task.
+            description (str, optional): Description of task, if new task is created.
+
+        Returns:
+            BinaryIO: A readable file-like object in binary mode.
+
+        Raises:
+            ValueError: When no total value can be extracted from the arguments or the task.
+        """
+        # attempt to recover the total from the task
+        total_bytes: Optional[float] = None
+        if total is not None:
+            total_bytes = total
+        elif task_id is not None:
+            with self._lock:
+                total_bytes = self._tasks[task_id].total
+        if total_bytes is None:
+            raise ValueError(
+                f"unable to get the total number of bytes, please specify 'total'"
+            )
+
+        # update total of task or create new task
+        if task_id is None:
+            task_id = self.add_task(description, total=total_bytes)
+        else:
+            self.update(task_id, total=total_bytes)
+
+        return _Reader(file, self, task_id, close_handle=False)
+
+    @typing.overload
+    def open(
+        self,
+        file: Union[str, "PathLike[str]", bytes],
+        mode: Literal["rb"],
+        buffering: int = -1,
+        encoding: Optional[str] = None,
+        errors: Optional[str] = None,
+        newline: Optional[str] = None,
+        *,
+        total: Optional[int] = None,
+        task_id: Optional[TaskID] = None,
+        description: str = "Reading...",
+    ) -> BinaryIO:
+        pass
+
+    @typing.overload
+    def open(
+        self,
+        file: Union[str, "PathLike[str]", bytes],
+        mode: Union[Literal["r"], Literal["rt"]],
+        buffering: int = -1,
+        encoding: Optional[str] = None,
+        errors: Optional[str] = None,
+        newline: Optional[str] = None,
+        *,
+        total: Optional[int] = None,
+        task_id: Optional[TaskID] = None,
+        description: str = "Reading...",
+    ) -> TextIO:
+        pass
+
+    def open(
+        self,
+        file: Union[str, "PathLike[str]", bytes],
+        mode: Union[Literal["rb"], Literal["rt"], Literal["r"]] = "r",
+        buffering: int = -1,
+        encoding: Optional[str] = None,
+        errors: Optional[str] = None,
+        newline: Optional[str] = None,
+        *,
+        total: Optional[int] = None,
+        task_id: Optional[TaskID] = None,
+        description: str = "Reading...",
+    ) -> Union[BinaryIO, TextIO]:
+        """Track progress while reading from a binary file.
+
+        Args:
+            path (Union[str, PathLike[str]]): The path to the file to read.
+            mode (str): The mode to use to open the file. Only supports "r", "rb" or "rt".
+            buffering (int): The buffering strategy to use, see :func:`io.open`.
+            encoding (str, optional): The encoding to use when reading in text mode, see :func:`io.open`.
+            errors (str, optional): The error handling strategy for decoding errors, see :func:`io.open`.
+            newline (str, optional): The strategy for handling newlines in text mode, see :func:`io.open`.
+            total (int, optional): Total number of bytes to read. If none given, os.stat(path).st_size is used.
+            task_id (TaskID): Task to track. Default is new task.
+            description (str, optional): Description of task, if new task is created.
+
+        Returns:
+            BinaryIO: A readable file-like object in binary mode.
+
+        Raises:
+            ValueError: When an invalid mode is given.
+        """
+        # normalize the mode (always rb, rt)
+        _mode = "".join(sorted(mode, reverse=False))
+        if _mode not in ("br", "rt", "r"):
+            raise ValueError(f"invalid mode {mode!r}")
+
+        # patch buffering to provide the same behaviour as the builtin `open`
+        line_buffering = buffering == 1
+        if _mode == "br" and buffering == 1:
+            warnings.warn(
+                "line buffering (buffering=1) isn't supported in binary mode, the default buffer size will be used",
+                RuntimeWarning,
+            )
+            buffering = -1
+        elif _mode in ("rt", "r"):
+            if buffering == 0:
+                raise ValueError("can't have unbuffered text I/O")
+            elif buffering == 1:
+                buffering = -1
+
+        # attempt to get the total with `os.stat`
+        if total is None:
+            total = stat(file).st_size
+
+        # update total of task or create new task
+        if task_id is None:
+            task_id = self.add_task(description, total=total)
+        else:
+            self.update(task_id, total=total)
+
+        # open the file in binary mode,
+        handle = io.open(file, "rb", buffering=buffering)
+        reader = _Reader(handle, self, task_id, close_handle=True)
+
+        # wrap the reader in a `TextIOWrapper` if text mode
+        if mode in ("r", "rt"):
+            return io.TextIOWrapper(
+                reader,
+                encoding=encoding,
+                errors=errors,
+                newline=newline,
+                line_buffering=line_buffering,
+            )
+
+        return reader
+
+    def start_task(self, task_id: TaskID) -> None:
+        """Start a task.
+
+        Starts a task (used when calculating elapsed time). You may need to call this manually,
+        if you called ``add_task`` with ``start=False``.
+
+        Args:
+            task_id (TaskID): ID of task.
+        """
+        with self._lock:
+            task = self._tasks[task_id]
+            if task.start_time is None:
+                task.start_time = self.get_time()
+
+    def stop_task(self, task_id: TaskID) -> None:
+        """Stop a task.
+
+        This will freeze the elapsed time on the task.
+
+        Args:
+            task_id (TaskID): ID of task.
+        """
+        with self._lock:
+            task = self._tasks[task_id]
+            current_time = self.get_time()
+            if task.start_time is None:
+                task.start_time = current_time
+            task.stop_time = current_time
+
+    def update(
+        self,
+        task_id: TaskID,
+        *,
+        total: Optional[float] = None,
+        completed: Optional[float] = None,
+        advance: Optional[float] = None,
+        description: Optional[str] = None,
+        visible: Optional[bool] = None,
+        refresh: bool = False,
+        **fields: Any,
+    ) -> None:
+        """Update information associated with a task.
+
+        Args:
+            task_id (TaskID): Task id (returned by add_task).
+            total (float, optional): Updates task.total if not None.
+            completed (float, optional): Updates task.completed if not None.
+            advance (float, optional): Add a value to task.completed if not None.
+            description (str, optional): Change task description if not None.
+            visible (bool, optional): Set visible flag if not None.
+            refresh (bool): Force a refresh of progress information. Default is False.
+            **fields (Any): Additional data fields required for rendering.
+        """
+        with self._lock:
+            task = self._tasks[task_id]
+            completed_start = task.completed
+
+            if total is not None and total != task.total:
+                task.total = total
+                task._reset()
+            if advance is not None:
+                task.completed += advance
+            if completed is not None:
+                task.completed = completed
+            if description is not None:
+                task.description = description
+            if visible is not None:
+                task.visible = visible
+            task.fields.update(fields)
+            update_completed = task.completed - completed_start
+
+            current_time = self.get_time()
+            old_sample_time = current_time - self.speed_estimate_period
+            _progress = task._progress
+
+            popleft = _progress.popleft
+            while _progress and _progress[0].timestamp < old_sample_time:
+                popleft()
+            if update_completed > 0:
+                _progress.append(ProgressSample(current_time, update_completed))
+            if (
+                task.total is not None
+                and task.completed >= task.total
+                and task.finished_time is None
+            ):
+                task.finished_time = task.elapsed
+
+        if refresh:
+            self.refresh()
+
+    def reset(
+        self,
+        task_id: TaskID,
+        *,
+        start: bool = True,
+        total: Optional[float] = None,
+        completed: int = 0,
+        visible: Optional[bool] = None,
+        description: Optional[str] = None,
+        **fields: Any,
+    ) -> None:
+        """Reset a task so completed is 0 and the clock is reset.
+
+        Args:
+            task_id (TaskID): ID of task.
+            start (bool, optional): Start the task after reset. Defaults to True.
+            total (float, optional): New total steps in task, or None to use current total. Defaults to None.
+            completed (int, optional): Number of steps completed. Defaults to 0.
+            visible (bool, optional): Enable display of the task. Defaults to True.
+            description (str, optional): Change task description if not None. Defaults to None.
+            **fields (str): Additional data fields required for rendering.
+        """
+        current_time = self.get_time()
+        with self._lock:
+            task = self._tasks[task_id]
+            task._reset()
+            task.start_time = current_time if start else None
+            if total is not None:
+                task.total = total
+            task.completed = completed
+            if visible is not None:
+                task.visible = visible
+            if fields:
+                task.fields = fields
+            if description is not None:
+                task.description = description
+            task.finished_time = None
+        self.refresh()
+
+    def advance(self, task_id: TaskID, advance: float = 1) -> None:
+        """Advance task by a number of steps.
+
+        Args:
+            task_id (TaskID): ID of task.
+            advance (float): Number of steps to advance. Default is 1.
+        """
+        current_time = self.get_time()
+        with self._lock:
+            task = self._tasks[task_id]
+            completed_start = task.completed
+            task.completed += advance
+            update_completed = task.completed - completed_start
+            old_sample_time = current_time - self.speed_estimate_period
+            _progress = task._progress
+
+            popleft = _progress.popleft
+            while _progress and _progress[0].timestamp < old_sample_time:
+                popleft()
+            while len(_progress) > 1000:
+                popleft()
+            _progress.append(ProgressSample(current_time, update_completed))
+            if (
+                task.total is not None
+                and task.completed >= task.total
+                and task.finished_time is None
+            ):
+                task.finished_time = task.elapsed
+                task.finished_speed = task.speed
+
+    def refresh(self) -> None:
+        """Refresh (render) the progress information."""
+        if not self.disable and self.live.is_started:
+            self.live.refresh()
+
+    def get_renderable(self) -> RenderableType:
+        """Get a renderable for the progress display."""
+        renderable = Group(*self.get_renderables())
+        return renderable
+
+    def get_renderables(self) -> Iterable[RenderableType]:
+        """Get a number of renderables for the progress display."""
+        table = self.make_tasks_table(self.tasks)
+        yield table
+
+    def make_tasks_table(self, tasks: Iterable[Task]) -> Table:
+        """Get a table to render the Progress display.
+
+        Args:
+            tasks (Iterable[Task]): An iterable of Task instances, one per row of the table.
+
+        Returns:
+            Table: A table instance.
+        """
+        table_columns = (
+            (
+                Column(no_wrap=True)
+                if isinstance(_column, str)
+                else _column.get_table_column().copy()
+            )
+            for _column in self.columns
+        )
+        table = Table.grid(*table_columns, padding=(0, 1), expand=self.expand)
+
+        for task in tasks:
+            if task.visible:
+                table.add_row(
+                    *(
+                        (
+                            column.format(task=task)
+                            if isinstance(column, str)
+                            else column(task)
+                        )
+                        for column in self.columns
+                    )
+                )
+        return table
+
+    def __rich__(self) -> RenderableType:
+        """Makes the Progress class itself renderable."""
+        with self._lock:
+            return self.get_renderable()
+
+    def add_task(
+        self,
+        description: str,
+        start: bool = True,
+        total: Optional[float] = 100.0,
+        completed: int = 0,
+        visible: bool = True,
+        **fields: Any,
+    ) -> TaskID:
+        """Add a new 'task' to the Progress display.
+
+        Args:
+            description (str): A description of the task.
+            start (bool, optional): Start the task immediately (to calculate elapsed time). If set to False,
+                you will need to call `start` manually. Defaults to True.
+            total (float, optional): Number of total steps in the progress if known.
+                Set to None to render a pulsing animation. Defaults to 100.
+            completed (int, optional): Number of steps completed so far. Defaults to 0.
+            visible (bool, optional): Enable display of the task. Defaults to True.
+            **fields (str): Additional data fields required for rendering.
+
+        Returns:
+            TaskID: An ID you can use when calling `update`.
+        """
+        with self._lock:
+            task = Task(
+                self._task_index,
+                description,
+                total,
+                completed,
+                visible=visible,
+                fields=fields,
+                _get_time=self.get_time,
+                _lock=self._lock,
+            )
+            self._tasks[self._task_index] = task
+            if start:
+                self.start_task(self._task_index)
+            new_task_index = self._task_index
+            self._task_index = TaskID(int(self._task_index) + 1)
+        self.refresh()
+        return new_task_index
+
+    def remove_task(self, task_id: TaskID) -> None:
+        """Delete a task if it exists.
+
+        Args:
+            task_id (TaskID): A task ID.
+
+        """
+        with self._lock:
+            del self._tasks[task_id]
+
+
+if __name__ == "__main__":  # pragma: no coverage
+    import random
+    import time
+
+    from .panel import Panel
+    from .rule import Rule
+    from .syntax import Syntax
+    from .table import Table
+
+    syntax = Syntax(
+        '''def loop_last(values: Iterable[T]) -> Iterable[Tuple[bool, T]]:
+    """Iterate and generate a tuple with a flag for last value."""
+    iter_values = iter(values)
+    try:
+        previous_value = next(iter_values)
+    except StopIteration:
+        return
+    for value in iter_values:
+        yield False, previous_value
+        previous_value = value
+    yield True, previous_value''',
+        "python",
+        line_numbers=True,
+    )
+
+    table = Table("foo", "bar", "baz")
+    table.add_row("1", "2", "3")
+
+    progress_renderables = [
+        "Text may be printed while the progress bars are rendering.",
+        Panel("In fact, [i]any[/i] renderable will work"),
+        "Such as [magenta]tables[/]...",
+        table,
+        "Pretty printed structures...",
+        {"type": "example", "text": "Pretty printed"},
+        "Syntax...",
+        syntax,
+        Rule("Give it a try!"),
+    ]
+
+    from itertools import cycle
+
+    examples = cycle(progress_renderables)
+
+    console = Console(record=True)
+
+    with Progress(
+        SpinnerColumn(),
+        *Progress.get_default_columns(),
+        TimeElapsedColumn(),
+        console=console,
+        transient=False,
+    ) as progress:
+        task1 = progress.add_task("[red]Downloading", total=1000)
+        task2 = progress.add_task("[green]Processing", total=1000)
+        task3 = progress.add_task("[yellow]Thinking", total=None)
+
+        while not progress.finished:
+            progress.update(task1, advance=0.5)
+            progress.update(task2, advance=0.3)
+            time.sleep(0.01)
+            if random.randint(0, 100) < 1:
+                progress.log(next(examples))
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/progress_bar.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/progress_bar.py
new file mode 100644
index 0000000..41794f7
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/progress_bar.py
@@ -0,0 +1,223 @@
+import math
+from functools import lru_cache
+from time import monotonic
+from typing import Iterable, List, Optional
+
+from .color import Color, blend_rgb
+from .color_triplet import ColorTriplet
+from .console import Console, ConsoleOptions, RenderResult
+from .jupyter import JupyterMixin
+from .measure import Measurement
+from .segment import Segment
+from .style import Style, StyleType
+
+# Number of characters before 'pulse' animation repeats
+PULSE_SIZE = 20
+
+
+class ProgressBar(JupyterMixin):
+    """Renders a (progress) bar. Used by rich.progress.
+
+    Args:
+        total (float, optional): Number of steps in the bar. Defaults to 100. Set to None to render a pulsing animation.
+        completed (float, optional): Number of steps completed. Defaults to 0.
+        width (int, optional): Width of the bar, or ``None`` for maximum width. Defaults to None.
+        pulse (bool, optional): Enable pulse effect. Defaults to False. Will pulse if a None total was passed.
+        style (StyleType, optional): Style for the bar background. Defaults to "bar.back".
+        complete_style (StyleType, optional): Style for the completed bar. Defaults to "bar.complete".
+        finished_style (StyleType, optional): Style for a finished bar. Defaults to "bar.finished".
+        pulse_style (StyleType, optional): Style for pulsing bars. Defaults to "bar.pulse".
+        animation_time (Optional[float], optional): Time in seconds to use for animation, or None to use system time.
+    """
+
+    def __init__(
+        self,
+        total: Optional[float] = 100.0,
+        completed: float = 0,
+        width: Optional[int] = None,
+        pulse: bool = False,
+        style: StyleType = "bar.back",
+        complete_style: StyleType = "bar.complete",
+        finished_style: StyleType = "bar.finished",
+        pulse_style: StyleType = "bar.pulse",
+        animation_time: Optional[float] = None,
+    ):
+        self.total = total
+        self.completed = completed
+        self.width = width
+        self.pulse = pulse
+        self.style = style
+        self.complete_style = complete_style
+        self.finished_style = finished_style
+        self.pulse_style = pulse_style
+        self.animation_time = animation_time
+
+        self._pulse_segments: Optional[List[Segment]] = None
+
+    def __repr__(self) -> str:
+        return f""
+
+    @property
+    def percentage_completed(self) -> Optional[float]:
+        """Calculate percentage complete."""
+        if self.total is None:
+            return None
+        completed = (self.completed / self.total) * 100.0
+        completed = min(100, max(0.0, completed))
+        return completed
+
+    @lru_cache(maxsize=16)
+    def _get_pulse_segments(
+        self,
+        fore_style: Style,
+        back_style: Style,
+        color_system: str,
+        no_color: bool,
+        ascii: bool = False,
+    ) -> List[Segment]:
+        """Get a list of segments to render a pulse animation.
+
+        Returns:
+            List[Segment]: A list of segments, one segment per character.
+        """
+        bar = "-" if ascii else "━"
+        segments: List[Segment] = []
+        if color_system not in ("standard", "eight_bit", "truecolor") or no_color:
+            segments += [Segment(bar, fore_style)] * (PULSE_SIZE // 2)
+            segments += [Segment(" " if no_color else bar, back_style)] * (
+                PULSE_SIZE - (PULSE_SIZE // 2)
+            )
+            return segments
+
+        append = segments.append
+        fore_color = (
+            fore_style.color.get_truecolor()
+            if fore_style.color
+            else ColorTriplet(255, 0, 255)
+        )
+        back_color = (
+            back_style.color.get_truecolor()
+            if back_style.color
+            else ColorTriplet(0, 0, 0)
+        )
+        cos = math.cos
+        pi = math.pi
+        _Segment = Segment
+        _Style = Style
+        from_triplet = Color.from_triplet
+
+        for index in range(PULSE_SIZE):
+            position = index / PULSE_SIZE
+            fade = 0.5 + cos(position * pi * 2) / 2.0
+            color = blend_rgb(fore_color, back_color, cross_fade=fade)
+            append(_Segment(bar, _Style(color=from_triplet(color))))
+        return segments
+
+    def update(self, completed: float, total: Optional[float] = None) -> None:
+        """Update progress with new values.
+
+        Args:
+            completed (float): Number of steps completed.
+            total (float, optional): Total number of steps, or ``None`` to not change. Defaults to None.
+        """
+        self.completed = completed
+        self.total = total if total is not None else self.total
+
+    def _render_pulse(
+        self, console: Console, width: int, ascii: bool = False
+    ) -> Iterable[Segment]:
+        """Renders the pulse animation.
+
+        Args:
+            console (Console): Console instance.
+            width (int): Width in characters of pulse animation.
+
+        Returns:
+            RenderResult: [description]
+
+        Yields:
+            Iterator[Segment]: Segments to render pulse
+        """
+        fore_style = console.get_style(self.pulse_style, default="white")
+        back_style = console.get_style(self.style, default="black")
+
+        pulse_segments = self._get_pulse_segments(
+            fore_style, back_style, console.color_system, console.no_color, ascii=ascii
+        )
+        segment_count = len(pulse_segments)
+        current_time = (
+            monotonic() if self.animation_time is None else self.animation_time
+        )
+        segments = pulse_segments * (int(width / segment_count) + 2)
+        offset = int(-current_time * 15) % segment_count
+        segments = segments[offset : offset + width]
+        yield from segments
+
+    def __rich_console__(
+        self, console: Console, options: ConsoleOptions
+    ) -> RenderResult:
+        width = min(self.width or options.max_width, options.max_width)
+        ascii = options.legacy_windows or options.ascii_only
+        should_pulse = self.pulse or self.total is None
+        if should_pulse:
+            yield from self._render_pulse(console, width, ascii=ascii)
+            return
+
+        completed: Optional[float] = (
+            min(self.total, max(0, self.completed)) if self.total is not None else None
+        )
+
+        bar = "-" if ascii else "━"
+        half_bar_right = " " if ascii else "╸"
+        half_bar_left = " " if ascii else "╺"
+        complete_halves = (
+            int(width * 2 * completed / self.total)
+            if self.total and completed is not None
+            else width * 2
+        )
+        bar_count = complete_halves // 2
+        half_bar_count = complete_halves % 2
+        style = console.get_style(self.style)
+        is_finished = self.total is None or self.completed >= self.total
+        complete_style = console.get_style(
+            self.finished_style if is_finished else self.complete_style
+        )
+        _Segment = Segment
+        if bar_count:
+            yield _Segment(bar * bar_count, complete_style)
+        if half_bar_count:
+            yield _Segment(half_bar_right * half_bar_count, complete_style)
+
+        if not console.no_color:
+            remaining_bars = width - bar_count - half_bar_count
+            if remaining_bars and console.color_system is not None:
+                if not half_bar_count and bar_count:
+                    yield _Segment(half_bar_left, style)
+                    remaining_bars -= 1
+                if remaining_bars:
+                    yield _Segment(bar * remaining_bars, style)
+
+    def __rich_measure__(
+        self, console: Console, options: ConsoleOptions
+    ) -> Measurement:
+        return (
+            Measurement(self.width, self.width)
+            if self.width is not None
+            else Measurement(4, options.max_width)
+        )
+
+
+if __name__ == "__main__":  # pragma: no cover
+    console = Console()
+    bar = ProgressBar(width=50, total=100)
+
+    import time
+
+    console.show_cursor(False)
+    for n in range(0, 101, 1):
+        bar.update(n)
+        console.print(bar)
+        console.file.write("\r")
+        time.sleep(0.05)
+    console.show_cursor(True)
+    console.print()
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/prompt.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/prompt.py
new file mode 100644
index 0000000..fccb70d
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/prompt.py
@@ -0,0 +1,400 @@
+from typing import Any, Generic, List, Optional, TextIO, TypeVar, Union, overload
+
+from . import get_console
+from .console import Console
+from .text import Text, TextType
+
+PromptType = TypeVar("PromptType")
+DefaultType = TypeVar("DefaultType")
+
+
+class PromptError(Exception):
+    """Exception base class for prompt related errors."""
+
+
+class InvalidResponse(PromptError):
+    """Exception to indicate a response was invalid. Raise this within process_response() to indicate an error
+    and provide an error message.
+
+    Args:
+        message (Union[str, Text]): Error message.
+    """
+
+    def __init__(self, message: TextType) -> None:
+        self.message = message
+
+    def __rich__(self) -> TextType:
+        return self.message
+
+
+class PromptBase(Generic[PromptType]):
+    """Ask the user for input until a valid response is received. This is the base class, see one of
+    the concrete classes for examples.
+
+    Args:
+        prompt (TextType, optional): Prompt text. Defaults to "".
+        console (Console, optional): A Console instance or None to use global console. Defaults to None.
+        password (bool, optional): Enable password input. Defaults to False.
+        choices (List[str], optional): A list of valid choices. Defaults to None.
+        case_sensitive (bool, optional): Matching of choices should be case-sensitive. Defaults to True.
+        show_default (bool, optional): Show default in prompt. Defaults to True.
+        show_choices (bool, optional): Show choices in prompt. Defaults to True.
+    """
+
+    response_type: type = str
+
+    validate_error_message = "[prompt.invalid]Please enter a valid value"
+    illegal_choice_message = (
+        "[prompt.invalid.choice]Please select one of the available options"
+    )
+    prompt_suffix = ": "
+
+    choices: Optional[List[str]] = None
+
+    def __init__(
+        self,
+        prompt: TextType = "",
+        *,
+        console: Optional[Console] = None,
+        password: bool = False,
+        choices: Optional[List[str]] = None,
+        case_sensitive: bool = True,
+        show_default: bool = True,
+        show_choices: bool = True,
+    ) -> None:
+        self.console = console or get_console()
+        self.prompt = (
+            Text.from_markup(prompt, style="prompt")
+            if isinstance(prompt, str)
+            else prompt
+        )
+        self.password = password
+        if choices is not None:
+            self.choices = choices
+        self.case_sensitive = case_sensitive
+        self.show_default = show_default
+        self.show_choices = show_choices
+
+    @classmethod
+    @overload
+    def ask(
+        cls,
+        prompt: TextType = "",
+        *,
+        console: Optional[Console] = None,
+        password: bool = False,
+        choices: Optional[List[str]] = None,
+        case_sensitive: bool = True,
+        show_default: bool = True,
+        show_choices: bool = True,
+        default: DefaultType,
+        stream: Optional[TextIO] = None,
+    ) -> Union[DefaultType, PromptType]:
+        ...
+
+    @classmethod
+    @overload
+    def ask(
+        cls,
+        prompt: TextType = "",
+        *,
+        console: Optional[Console] = None,
+        password: bool = False,
+        choices: Optional[List[str]] = None,
+        case_sensitive: bool = True,
+        show_default: bool = True,
+        show_choices: bool = True,
+        stream: Optional[TextIO] = None,
+    ) -> PromptType:
+        ...
+
+    @classmethod
+    def ask(
+        cls,
+        prompt: TextType = "",
+        *,
+        console: Optional[Console] = None,
+        password: bool = False,
+        choices: Optional[List[str]] = None,
+        case_sensitive: bool = True,
+        show_default: bool = True,
+        show_choices: bool = True,
+        default: Any = ...,
+        stream: Optional[TextIO] = None,
+    ) -> Any:
+        """Shortcut to construct and run a prompt loop and return the result.
+
+        Example:
+            >>> filename = Prompt.ask("Enter a filename")
+
+        Args:
+            prompt (TextType, optional): Prompt text. Defaults to "".
+            console (Console, optional): A Console instance or None to use global console. Defaults to None.
+            password (bool, optional): Enable password input. Defaults to False.
+            choices (List[str], optional): A list of valid choices. Defaults to None.
+            case_sensitive (bool, optional): Matching of choices should be case-sensitive. Defaults to True.
+            show_default (bool, optional): Show default in prompt. Defaults to True.
+            show_choices (bool, optional): Show choices in prompt. Defaults to True.
+            stream (TextIO, optional): Optional text file open for reading to get input. Defaults to None.
+        """
+        _prompt = cls(
+            prompt,
+            console=console,
+            password=password,
+            choices=choices,
+            case_sensitive=case_sensitive,
+            show_default=show_default,
+            show_choices=show_choices,
+        )
+        return _prompt(default=default, stream=stream)
+
+    def render_default(self, default: DefaultType) -> Text:
+        """Turn the supplied default in to a Text instance.
+
+        Args:
+            default (DefaultType): Default value.
+
+        Returns:
+            Text: Text containing rendering of default value.
+        """
+        return Text(f"({default})", "prompt.default")
+
+    def make_prompt(self, default: DefaultType) -> Text:
+        """Make prompt text.
+
+        Args:
+            default (DefaultType): Default value.
+
+        Returns:
+            Text: Text to display in prompt.
+        """
+        prompt = self.prompt.copy()
+        prompt.end = ""
+
+        if self.show_choices and self.choices:
+            _choices = "/".join(self.choices)
+            choices = f"[{_choices}]"
+            prompt.append(" ")
+            prompt.append(choices, "prompt.choices")
+
+        if (
+            default != ...
+            and self.show_default
+            and isinstance(default, (str, self.response_type))
+        ):
+            prompt.append(" ")
+            _default = self.render_default(default)
+            prompt.append(_default)
+
+        prompt.append(self.prompt_suffix)
+
+        return prompt
+
+    @classmethod
+    def get_input(
+        cls,
+        console: Console,
+        prompt: TextType,
+        password: bool,
+        stream: Optional[TextIO] = None,
+    ) -> str:
+        """Get input from user.
+
+        Args:
+            console (Console): Console instance.
+            prompt (TextType): Prompt text.
+            password (bool): Enable password entry.
+
+        Returns:
+            str: String from user.
+        """
+        return console.input(prompt, password=password, stream=stream)
+
+    def check_choice(self, value: str) -> bool:
+        """Check value is in the list of valid choices.
+
+        Args:
+            value (str): Value entered by user.
+
+        Returns:
+            bool: True if choice was valid, otherwise False.
+        """
+        assert self.choices is not None
+        if self.case_sensitive:
+            return value.strip() in self.choices
+        return value.strip().lower() in [choice.lower() for choice in self.choices]
+
+    def process_response(self, value: str) -> PromptType:
+        """Process response from user, convert to prompt type.
+
+        Args:
+            value (str): String typed by user.
+
+        Raises:
+            InvalidResponse: If ``value`` is invalid.
+
+        Returns:
+            PromptType: The value to be returned from ask method.
+        """
+        value = value.strip()
+        try:
+            return_value: PromptType = self.response_type(value)
+        except ValueError:
+            raise InvalidResponse(self.validate_error_message)
+
+        if self.choices is not None:
+            if not self.check_choice(value):
+                raise InvalidResponse(self.illegal_choice_message)
+
+            if not self.case_sensitive:
+                # return the original choice, not the lower case version
+                return_value = self.response_type(
+                    self.choices[
+                        [choice.lower() for choice in self.choices].index(value.lower())
+                    ]
+                )
+        return return_value
+
+    def on_validate_error(self, value: str, error: InvalidResponse) -> None:
+        """Called to handle validation error.
+
+        Args:
+            value (str): String entered by user.
+            error (InvalidResponse): Exception instance the initiated the error.
+        """
+        self.console.print(error)
+
+    def pre_prompt(self) -> None:
+        """Hook to display something before the prompt."""
+
+    @overload
+    def __call__(self, *, stream: Optional[TextIO] = None) -> PromptType:
+        ...
+
+    @overload
+    def __call__(
+        self, *, default: DefaultType, stream: Optional[TextIO] = None
+    ) -> Union[PromptType, DefaultType]:
+        ...
+
+    def __call__(self, *, default: Any = ..., stream: Optional[TextIO] = None) -> Any:
+        """Run the prompt loop.
+
+        Args:
+            default (Any, optional): Optional default value.
+
+        Returns:
+            PromptType: Processed value.
+        """
+        while True:
+            self.pre_prompt()
+            prompt = self.make_prompt(default)
+            value = self.get_input(self.console, prompt, self.password, stream=stream)
+            if value == "" and default != ...:
+                return default
+            try:
+                return_value = self.process_response(value)
+            except InvalidResponse as error:
+                self.on_validate_error(value, error)
+                continue
+            else:
+                return return_value
+
+
+class Prompt(PromptBase[str]):
+    """A prompt that returns a str.
+
+    Example:
+        >>> name = Prompt.ask("Enter your name")
+
+
+    """
+
+    response_type = str
+
+
+class IntPrompt(PromptBase[int]):
+    """A prompt that returns an integer.
+
+    Example:
+        >>> burrito_count = IntPrompt.ask("How many burritos do you want to order")
+
+    """
+
+    response_type = int
+    validate_error_message = "[prompt.invalid]Please enter a valid integer number"
+
+
+class FloatPrompt(PromptBase[float]):
+    """A prompt that returns a float.
+
+    Example:
+        >>> temperature = FloatPrompt.ask("Enter desired temperature")
+
+    """
+
+    response_type = float
+    validate_error_message = "[prompt.invalid]Please enter a number"
+
+
+class Confirm(PromptBase[bool]):
+    """A yes / no confirmation prompt.
+
+    Example:
+        >>> if Confirm.ask("Continue"):
+                run_job()
+
+    """
+
+    response_type = bool
+    validate_error_message = "[prompt.invalid]Please enter Y or N"
+    choices: List[str] = ["y", "n"]
+
+    def render_default(self, default: DefaultType) -> Text:
+        """Render the default as (y) or (n) rather than True/False."""
+        yes, no = self.choices
+        return Text(f"({yes})" if default else f"({no})", style="prompt.default")
+
+    def process_response(self, value: str) -> bool:
+        """Convert choices to a bool."""
+        value = value.strip().lower()
+        if value not in self.choices:
+            raise InvalidResponse(self.validate_error_message)
+        return value == self.choices[0]
+
+
+if __name__ == "__main__":  # pragma: no cover
+    from pip._vendor.rich import print
+
+    if Confirm.ask("Run [i]prompt[/i] tests?", default=True):
+        while True:
+            result = IntPrompt.ask(
+                ":rocket: Enter a number between [b]1[/b] and [b]10[/b]", default=5
+            )
+            if result >= 1 and result <= 10:
+                break
+            print(":pile_of_poo: [prompt.invalid]Number must be between 1 and 10")
+        print(f"number={result}")
+
+        while True:
+            password = Prompt.ask(
+                "Please enter a password [cyan](must be at least 5 characters)",
+                password=True,
+            )
+            if len(password) >= 5:
+                break
+            print("[prompt.invalid]password too short")
+        print(f"password={password!r}")
+
+        fruit = Prompt.ask("Enter a fruit", choices=["apple", "orange", "pear"])
+        print(f"fruit={fruit!r}")
+
+        doggie = Prompt.ask(
+            "What's the best Dog? (Case INSENSITIVE)",
+            choices=["Border Terrier", "Collie", "Labradoodle"],
+            case_sensitive=False,
+        )
+        print(f"doggie={doggie!r}")
+
+    else:
+        print("[b]OK :loudly_crying_face:")
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/protocol.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/protocol.py
new file mode 100644
index 0000000..12ab237
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/protocol.py
@@ -0,0 +1,42 @@
+from typing import Any, cast, Set, TYPE_CHECKING
+from inspect import isclass
+
+if TYPE_CHECKING:
+    from pip._vendor.rich.console import RenderableType
+
+_GIBBERISH = """aihwerij235234ljsdnp34ksodfipwoe234234jlskjdf"""
+
+
+def is_renderable(check_object: Any) -> bool:
+    """Check if an object may be rendered by Rich."""
+    return (
+        isinstance(check_object, str)
+        or hasattr(check_object, "__rich__")
+        or hasattr(check_object, "__rich_console__")
+    )
+
+
+def rich_cast(renderable: object) -> "RenderableType":
+    """Cast an object to a renderable by calling __rich__ if present.
+
+    Args:
+        renderable (object): A potentially renderable object
+
+    Returns:
+        object: The result of recursively calling __rich__.
+    """
+    from pip._vendor.rich.console import RenderableType
+
+    rich_visited_set: Set[type] = set()  # Prevent potential infinite loop
+    while hasattr(renderable, "__rich__") and not isclass(renderable):
+        # Detect object which claim to have all the attributes
+        if hasattr(renderable, _GIBBERISH):
+            return repr(renderable)
+        cast_method = getattr(renderable, "__rich__")
+        renderable = cast_method()
+        renderable_type = type(renderable)
+        if renderable_type in rich_visited_set:
+            break
+        rich_visited_set.add(renderable_type)
+
+    return cast(RenderableType, renderable)
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/py.typed b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/py.typed
new file mode 100644
index 0000000..e69de29
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/region.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/region.py
new file mode 100644
index 0000000..75b3631
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/region.py
@@ -0,0 +1,10 @@
+from typing import NamedTuple
+
+
+class Region(NamedTuple):
+    """Defines a rectangular region of the screen."""
+
+    x: int
+    y: int
+    width: int
+    height: int
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/repr.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/repr.py
new file mode 100644
index 0000000..10efc42
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/repr.py
@@ -0,0 +1,149 @@
+import inspect
+from functools import partial
+from typing import (
+    Any,
+    Callable,
+    Iterable,
+    List,
+    Optional,
+    Tuple,
+    Type,
+    TypeVar,
+    Union,
+    overload,
+)
+
+T = TypeVar("T")
+
+
+Result = Iterable[Union[Any, Tuple[Any], Tuple[str, Any], Tuple[str, Any, Any]]]
+RichReprResult = Result
+
+
+class ReprError(Exception):
+    """An error occurred when attempting to build a repr."""
+
+
+@overload
+def auto(cls: Optional[Type[T]]) -> Type[T]:
+    ...
+
+
+@overload
+def auto(*, angular: bool = False) -> Callable[[Type[T]], Type[T]]:
+    ...
+
+
+def auto(
+    cls: Optional[Type[T]] = None, *, angular: Optional[bool] = None
+) -> Union[Type[T], Callable[[Type[T]], Type[T]]]:
+    """Class decorator to create __repr__ from __rich_repr__"""
+
+    def do_replace(cls: Type[T], angular: Optional[bool] = None) -> Type[T]:
+        def auto_repr(self: T) -> str:
+            """Create repr string from __rich_repr__"""
+            repr_str: List[str] = []
+            append = repr_str.append
+
+            angular: bool = getattr(self.__rich_repr__, "angular", False)  # type: ignore[attr-defined]
+            for arg in self.__rich_repr__():  # type: ignore[attr-defined]
+                if isinstance(arg, tuple):
+                    if len(arg) == 1:
+                        append(repr(arg[0]))
+                    else:
+                        key, value, *default = arg
+                        if key is None:
+                            append(repr(value))
+                        else:
+                            if default and default[0] == value:
+                                continue
+                            append(f"{key}={value!r}")
+                else:
+                    append(repr(arg))
+            if angular:
+                return f"<{self.__class__.__name__} {' '.join(repr_str)}>"
+            else:
+                return f"{self.__class__.__name__}({', '.join(repr_str)})"
+
+        def auto_rich_repr(self: Type[T]) -> Result:
+            """Auto generate __rich_rep__ from signature of __init__"""
+            try:
+                signature = inspect.signature(self.__init__)
+                for name, param in signature.parameters.items():
+                    if param.kind == param.POSITIONAL_ONLY:
+                        yield getattr(self, name)
+                    elif param.kind in (
+                        param.POSITIONAL_OR_KEYWORD,
+                        param.KEYWORD_ONLY,
+                    ):
+                        if param.default is param.empty:
+                            yield getattr(self, param.name)
+                        else:
+                            yield param.name, getattr(self, param.name), param.default
+            except Exception as error:
+                raise ReprError(
+                    f"Failed to auto generate __rich_repr__; {error}"
+                ) from None
+
+        if not hasattr(cls, "__rich_repr__"):
+            auto_rich_repr.__doc__ = "Build a rich repr"
+            cls.__rich_repr__ = auto_rich_repr  # type: ignore[attr-defined]
+
+        auto_repr.__doc__ = "Return repr(self)"
+        cls.__repr__ = auto_repr  # type: ignore[assignment]
+        if angular is not None:
+            cls.__rich_repr__.angular = angular  # type: ignore[attr-defined]
+        return cls
+
+    if cls is None:
+        return partial(do_replace, angular=angular)
+    else:
+        return do_replace(cls, angular=angular)
+
+
+@overload
+def rich_repr(cls: Optional[Type[T]]) -> Type[T]:
+    ...
+
+
+@overload
+def rich_repr(*, angular: bool = False) -> Callable[[Type[T]], Type[T]]:
+    ...
+
+
+def rich_repr(
+    cls: Optional[Type[T]] = None, *, angular: bool = False
+) -> Union[Type[T], Callable[[Type[T]], Type[T]]]:
+    if cls is None:
+        return auto(angular=angular)
+    else:
+        return auto(cls)
+
+
+if __name__ == "__main__":
+
+    @auto
+    class Foo:
+        def __rich_repr__(self) -> Result:
+            yield "foo"
+            yield "bar", {"shopping": ["eggs", "ham", "pineapple"]}
+            yield "buy", "hand sanitizer"
+
+    foo = Foo()
+    from pip._vendor.rich.console import Console
+
+    console = Console()
+
+    console.rule("Standard repr")
+    console.print(foo)
+
+    console.print(foo, width=60)
+    console.print(foo, width=30)
+
+    console.rule("Angular repr")
+    Foo.__rich_repr__.angular = True  # type: ignore[attr-defined]
+
+    console.print(foo)
+
+    console.print(foo, width=60)
+    console.print(foo, width=30)
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/rule.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/rule.py
new file mode 100644
index 0000000..fd00ce6
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/rule.py
@@ -0,0 +1,130 @@
+from typing import Union
+
+from .align import AlignMethod
+from .cells import cell_len, set_cell_size
+from .console import Console, ConsoleOptions, RenderResult
+from .jupyter import JupyterMixin
+from .measure import Measurement
+from .style import Style
+from .text import Text
+
+
+class Rule(JupyterMixin):
+    """A console renderable to draw a horizontal rule (line).
+
+    Args:
+        title (Union[str, Text], optional): Text to render in the rule. Defaults to "".
+        characters (str, optional): Character(s) used to draw the line. Defaults to "─".
+        style (StyleType, optional): Style of Rule. Defaults to "rule.line".
+        end (str, optional): Character at end of Rule. defaults to "\\\\n"
+        align (str, optional): How to align the title, one of "left", "center", or "right". Defaults to "center".
+    """
+
+    def __init__(
+        self,
+        title: Union[str, Text] = "",
+        *,
+        characters: str = "─",
+        style: Union[str, Style] = "rule.line",
+        end: str = "\n",
+        align: AlignMethod = "center",
+    ) -> None:
+        if cell_len(characters) < 1:
+            raise ValueError(
+                "'characters' argument must have a cell width of at least 1"
+            )
+        if align not in ("left", "center", "right"):
+            raise ValueError(
+                f'invalid value for align, expected "left", "center", "right" (not {align!r})'
+            )
+        self.title = title
+        self.characters = characters
+        self.style = style
+        self.end = end
+        self.align = align
+
+    def __repr__(self) -> str:
+        return f"Rule({self.title!r}, {self.characters!r})"
+
+    def __rich_console__(
+        self, console: Console, options: ConsoleOptions
+    ) -> RenderResult:
+        width = options.max_width
+
+        characters = (
+            "-"
+            if (options.ascii_only and not self.characters.isascii())
+            else self.characters
+        )
+
+        chars_len = cell_len(characters)
+        if not self.title:
+            yield self._rule_line(chars_len, width)
+            return
+
+        if isinstance(self.title, Text):
+            title_text = self.title
+        else:
+            title_text = console.render_str(self.title, style="rule.text")
+
+        title_text.plain = title_text.plain.replace("\n", " ")
+        title_text.expand_tabs()
+
+        required_space = 4 if self.align == "center" else 2
+        truncate_width = max(0, width - required_space)
+        if not truncate_width:
+            yield self._rule_line(chars_len, width)
+            return
+
+        rule_text = Text(end=self.end)
+        if self.align == "center":
+            title_text.truncate(truncate_width, overflow="ellipsis")
+            side_width = (width - cell_len(title_text.plain)) // 2
+            left = Text(characters * (side_width // chars_len + 1))
+            left.truncate(side_width - 1)
+            right_length = width - cell_len(left.plain) - cell_len(title_text.plain)
+            right = Text(characters * (side_width // chars_len + 1))
+            right.truncate(right_length)
+            rule_text.append(left.plain + " ", self.style)
+            rule_text.append(title_text)
+            rule_text.append(" " + right.plain, self.style)
+        elif self.align == "left":
+            title_text.truncate(truncate_width, overflow="ellipsis")
+            rule_text.append(title_text)
+            rule_text.append(" ")
+            rule_text.append(characters * (width - rule_text.cell_len), self.style)
+        elif self.align == "right":
+            title_text.truncate(truncate_width, overflow="ellipsis")
+            rule_text.append(characters * (width - title_text.cell_len - 1), self.style)
+            rule_text.append(" ")
+            rule_text.append(title_text)
+
+        rule_text.plain = set_cell_size(rule_text.plain, width)
+        yield rule_text
+
+    def _rule_line(self, chars_len: int, width: int) -> Text:
+        rule_text = Text(self.characters * ((width // chars_len) + 1), self.style)
+        rule_text.truncate(width)
+        rule_text.plain = set_cell_size(rule_text.plain, width)
+        return rule_text
+
+    def __rich_measure__(
+        self, console: Console, options: ConsoleOptions
+    ) -> Measurement:
+        return Measurement(1, 1)
+
+
+if __name__ == "__main__":  # pragma: no cover
+    import sys
+
+    from pip._vendor.rich.console import Console
+
+    try:
+        text = sys.argv[1]
+    except IndexError:
+        text = "Hello, World"
+    console = Console()
+    console.print(Rule(title=text))
+
+    console = Console()
+    console.print(Rule("foo"), width=4)
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/scope.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/scope.py
new file mode 100644
index 0000000..c9d134c
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/scope.py
@@ -0,0 +1,86 @@
+from collections.abc import Mapping
+from typing import TYPE_CHECKING, Any, Optional, Tuple
+
+from .highlighter import ReprHighlighter
+from .panel import Panel
+from .pretty import Pretty
+from .table import Table
+from .text import Text, TextType
+
+if TYPE_CHECKING:
+    from .console import ConsoleRenderable
+
+
+def render_scope(
+    scope: "Mapping[str, Any]",
+    *,
+    title: Optional[TextType] = None,
+    sort_keys: bool = True,
+    indent_guides: bool = False,
+    max_length: Optional[int] = None,
+    max_string: Optional[int] = None,
+) -> "ConsoleRenderable":
+    """Render python variables in a given scope.
+
+    Args:
+        scope (Mapping): A mapping containing variable names and values.
+        title (str, optional): Optional title. Defaults to None.
+        sort_keys (bool, optional): Enable sorting of items. Defaults to True.
+        indent_guides (bool, optional): Enable indentation guides. Defaults to False.
+        max_length (int, optional): Maximum length of containers before abbreviating, or None for no abbreviation.
+            Defaults to None.
+        max_string (int, optional): Maximum length of string before truncating, or None to disable. Defaults to None.
+
+    Returns:
+        ConsoleRenderable: A renderable object.
+    """
+    highlighter = ReprHighlighter()
+    items_table = Table.grid(padding=(0, 1), expand=False)
+    items_table.add_column(justify="right")
+
+    def sort_items(item: Tuple[str, Any]) -> Tuple[bool, str]:
+        """Sort special variables first, then alphabetically."""
+        key, _ = item
+        return (not key.startswith("__"), key.lower())
+
+    items = sorted(scope.items(), key=sort_items) if sort_keys else scope.items()
+    for key, value in items:
+        key_text = Text.assemble(
+            (key, "scope.key.special" if key.startswith("__") else "scope.key"),
+            (" =", "scope.equals"),
+        )
+        items_table.add_row(
+            key_text,
+            Pretty(
+                value,
+                highlighter=highlighter,
+                indent_guides=indent_guides,
+                max_length=max_length,
+                max_string=max_string,
+            ),
+        )
+    return Panel.fit(
+        items_table,
+        title=title,
+        border_style="scope.border",
+        padding=(0, 1),
+    )
+
+
+if __name__ == "__main__":  # pragma: no cover
+    from pip._vendor.rich import print
+
+    print()
+
+    def test(foo: float, bar: float) -> None:
+        list_of_things = [1, 2, 3, None, 4, True, False, "Hello World"]
+        dict_of_things = {
+            "version": "1.1",
+            "method": "confirmFruitPurchase",
+            "params": [["apple", "orange", "mangoes", "pomelo"], 1.123],
+            "id": "194521489",
+        }
+        print(render_scope(locals(), title="[i]locals", sort_keys=False))
+
+    test(20.3423, 3.1427)
+    print()
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/screen.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/screen.py
new file mode 100644
index 0000000..7f416e1
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/screen.py
@@ -0,0 +1,54 @@
+from typing import Optional, TYPE_CHECKING
+
+from .segment import Segment
+from .style import StyleType
+from ._loop import loop_last
+
+
+if TYPE_CHECKING:
+    from .console import (
+        Console,
+        ConsoleOptions,
+        RenderResult,
+        RenderableType,
+        Group,
+    )
+
+
+class Screen:
+    """A renderable that fills the terminal screen and crops excess.
+
+    Args:
+        renderable (RenderableType): Child renderable.
+        style (StyleType, optional): Optional background style. Defaults to None.
+    """
+
+    renderable: "RenderableType"
+
+    def __init__(
+        self,
+        *renderables: "RenderableType",
+        style: Optional[StyleType] = None,
+        application_mode: bool = False,
+    ) -> None:
+        from pip._vendor.rich.console import Group
+
+        self.renderable = Group(*renderables)
+        self.style = style
+        self.application_mode = application_mode
+
+    def __rich_console__(
+        self, console: "Console", options: "ConsoleOptions"
+    ) -> "RenderResult":
+        width, height = options.size
+        style = console.get_style(self.style) if self.style else None
+        render_options = options.update(width=width, height=height)
+        lines = console.render_lines(
+            self.renderable or "", render_options, style=style, pad=True
+        )
+        lines = Segment.set_shape(lines, width, height, style=style)
+        new_line = Segment("\n\r") if self.application_mode else Segment.line()
+        for last, line in loop_last(lines):
+            yield from line
+            if not last:
+                yield new_line
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/segment.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/segment.py
new file mode 100644
index 0000000..4b5f997
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/segment.py
@@ -0,0 +1,752 @@
+from enum import IntEnum
+from functools import lru_cache
+from itertools import filterfalse
+from logging import getLogger
+from operator import attrgetter
+from typing import (
+    TYPE_CHECKING,
+    Dict,
+    Iterable,
+    List,
+    NamedTuple,
+    Optional,
+    Sequence,
+    Tuple,
+    Type,
+    Union,
+)
+
+from .cells import (
+    _is_single_cell_widths,
+    cached_cell_len,
+    cell_len,
+    get_character_cell_size,
+    set_cell_size,
+)
+from .repr import Result, rich_repr
+from .style import Style
+
+if TYPE_CHECKING:
+    from .console import Console, ConsoleOptions, RenderResult
+
+log = getLogger("rich")
+
+
+class ControlType(IntEnum):
+    """Non-printable control codes which typically translate to ANSI codes."""
+
+    BELL = 1
+    CARRIAGE_RETURN = 2
+    HOME = 3
+    CLEAR = 4
+    SHOW_CURSOR = 5
+    HIDE_CURSOR = 6
+    ENABLE_ALT_SCREEN = 7
+    DISABLE_ALT_SCREEN = 8
+    CURSOR_UP = 9
+    CURSOR_DOWN = 10
+    CURSOR_FORWARD = 11
+    CURSOR_BACKWARD = 12
+    CURSOR_MOVE_TO_COLUMN = 13
+    CURSOR_MOVE_TO = 14
+    ERASE_IN_LINE = 15
+    SET_WINDOW_TITLE = 16
+
+
+ControlCode = Union[
+    Tuple[ControlType],
+    Tuple[ControlType, Union[int, str]],
+    Tuple[ControlType, int, int],
+]
+
+
+@rich_repr()
+class Segment(NamedTuple):
+    """A piece of text with associated style. Segments are produced by the Console render process and
+    are ultimately converted in to strings to be written to the terminal.
+
+    Args:
+        text (str): A piece of text.
+        style (:class:`~rich.style.Style`, optional): An optional style to apply to the text.
+        control (Tuple[ControlCode], optional): Optional sequence of control codes.
+
+    Attributes:
+        cell_length (int): The cell length of this Segment.
+    """
+
+    text: str
+    style: Optional[Style] = None
+    control: Optional[Sequence[ControlCode]] = None
+
+    @property
+    def cell_length(self) -> int:
+        """The number of terminal cells required to display self.text.
+
+        Returns:
+            int: A number of cells.
+        """
+        text, _style, control = self
+        return 0 if control else cell_len(text)
+
+    def __rich_repr__(self) -> Result:
+        yield self.text
+        if self.control is None:
+            if self.style is not None:
+                yield self.style
+        else:
+            yield self.style
+            yield self.control
+
+    def __bool__(self) -> bool:
+        """Check if the segment contains text."""
+        return bool(self.text)
+
+    @property
+    def is_control(self) -> bool:
+        """Check if the segment contains control codes."""
+        return self.control is not None
+
+    @classmethod
+    @lru_cache(1024 * 16)
+    def _split_cells(cls, segment: "Segment", cut: int) -> Tuple["Segment", "Segment"]:
+        """Split a segment in to two at a given cell position.
+
+        Note that splitting a double-width character, may result in that character turning
+        into two spaces.
+
+        Args:
+            segment (Segment): A segment to split.
+            cut (int): A cell position to cut on.
+
+        Returns:
+            A tuple of two segments.
+        """
+        text, style, control = segment
+        _Segment = Segment
+        cell_length = segment.cell_length
+        if cut >= cell_length:
+            return segment, _Segment("", style, control)
+
+        cell_size = get_character_cell_size
+
+        pos = int((cut / cell_length) * len(text))
+
+        while True:
+            before = text[:pos]
+            cell_pos = cell_len(before)
+            out_by = cell_pos - cut
+            if not out_by:
+                return (
+                    _Segment(before, style, control),
+                    _Segment(text[pos:], style, control),
+                )
+            if out_by == -1 and cell_size(text[pos]) == 2:
+                return (
+                    _Segment(text[:pos] + " ", style, control),
+                    _Segment(" " + text[pos + 1 :], style, control),
+                )
+            if out_by == +1 and cell_size(text[pos - 1]) == 2:
+                return (
+                    _Segment(text[: pos - 1] + " ", style, control),
+                    _Segment(" " + text[pos:], style, control),
+                )
+            if cell_pos < cut:
+                pos += 1
+            else:
+                pos -= 1
+
+    def split_cells(self, cut: int) -> Tuple["Segment", "Segment"]:
+        """Split segment in to two segments at the specified column.
+
+        If the cut point falls in the middle of a 2-cell wide character then it is replaced
+        by two spaces, to preserve the display width of the parent segment.
+
+        Args:
+            cut (int): Offset within the segment to cut.
+
+        Returns:
+            Tuple[Segment, Segment]: Two segments.
+        """
+        text, style, control = self
+        assert cut >= 0
+
+        if _is_single_cell_widths(text):
+            # Fast path with all 1 cell characters
+            if cut >= len(text):
+                return self, Segment("", style, control)
+            return (
+                Segment(text[:cut], style, control),
+                Segment(text[cut:], style, control),
+            )
+
+        return self._split_cells(self, cut)
+
+    @classmethod
+    def line(cls) -> "Segment":
+        """Make a new line segment."""
+        return cls("\n")
+
+    @classmethod
+    def apply_style(
+        cls,
+        segments: Iterable["Segment"],
+        style: Optional[Style] = None,
+        post_style: Optional[Style] = None,
+    ) -> Iterable["Segment"]:
+        """Apply style(s) to an iterable of segments.
+
+        Returns an iterable of segments where the style is replaced by ``style + segment.style + post_style``.
+
+        Args:
+            segments (Iterable[Segment]): Segments to process.
+            style (Style, optional): Base style. Defaults to None.
+            post_style (Style, optional): Style to apply on top of segment style. Defaults to None.
+
+        Returns:
+            Iterable[Segments]: A new iterable of segments (possibly the same iterable).
+        """
+        result_segments = segments
+        if style:
+            apply = style.__add__
+            result_segments = (
+                cls(text, None if control else apply(_style), control)
+                for text, _style, control in result_segments
+            )
+        if post_style:
+            result_segments = (
+                cls(
+                    text,
+                    (
+                        None
+                        if control
+                        else (_style + post_style if _style else post_style)
+                    ),
+                    control,
+                )
+                for text, _style, control in result_segments
+            )
+        return result_segments
+
+    @classmethod
+    def filter_control(
+        cls, segments: Iterable["Segment"], is_control: bool = False
+    ) -> Iterable["Segment"]:
+        """Filter segments by ``is_control`` attribute.
+
+        Args:
+            segments (Iterable[Segment]): An iterable of Segment instances.
+            is_control (bool, optional): is_control flag to match in search.
+
+        Returns:
+            Iterable[Segment]: And iterable of Segment instances.
+
+        """
+        if is_control:
+            return filter(attrgetter("control"), segments)
+        else:
+            return filterfalse(attrgetter("control"), segments)
+
+    @classmethod
+    def split_lines(cls, segments: Iterable["Segment"]) -> Iterable[List["Segment"]]:
+        """Split a sequence of segments in to a list of lines.
+
+        Args:
+            segments (Iterable[Segment]): Segments potentially containing line feeds.
+
+        Yields:
+            Iterable[List[Segment]]: Iterable of segment lists, one per line.
+        """
+        line: List[Segment] = []
+        append = line.append
+
+        for segment in segments:
+            if "\n" in segment.text and not segment.control:
+                text, style, _ = segment
+                while text:
+                    _text, new_line, text = text.partition("\n")
+                    if _text:
+                        append(cls(_text, style))
+                    if new_line:
+                        yield line
+                        line = []
+                        append = line.append
+            else:
+                append(segment)
+        if line:
+            yield line
+
+    @classmethod
+    def split_and_crop_lines(
+        cls,
+        segments: Iterable["Segment"],
+        length: int,
+        style: Optional[Style] = None,
+        pad: bool = True,
+        include_new_lines: bool = True,
+    ) -> Iterable[List["Segment"]]:
+        """Split segments in to lines, and crop lines greater than a given length.
+
+        Args:
+            segments (Iterable[Segment]): An iterable of segments, probably
+                generated from console.render.
+            length (int): Desired line length.
+            style (Style, optional): Style to use for any padding.
+            pad (bool): Enable padding of lines that are less than `length`.
+
+        Returns:
+            Iterable[List[Segment]]: An iterable of lines of segments.
+        """
+        line: List[Segment] = []
+        append = line.append
+
+        adjust_line_length = cls.adjust_line_length
+        new_line_segment = cls("\n")
+
+        for segment in segments:
+            if "\n" in segment.text and not segment.control:
+                text, segment_style, _ = segment
+                while text:
+                    _text, new_line, text = text.partition("\n")
+                    if _text:
+                        append(cls(_text, segment_style))
+                    if new_line:
+                        cropped_line = adjust_line_length(
+                            line, length, style=style, pad=pad
+                        )
+                        if include_new_lines:
+                            cropped_line.append(new_line_segment)
+                        yield cropped_line
+                        line.clear()
+            else:
+                append(segment)
+        if line:
+            yield adjust_line_length(line, length, style=style, pad=pad)
+
+    @classmethod
+    def adjust_line_length(
+        cls,
+        line: List["Segment"],
+        length: int,
+        style: Optional[Style] = None,
+        pad: bool = True,
+    ) -> List["Segment"]:
+        """Adjust a line to a given width (cropping or padding as required).
+
+        Args:
+            segments (Iterable[Segment]): A list of segments in a single line.
+            length (int): The desired width of the line.
+            style (Style, optional): The style of padding if used (space on the end). Defaults to None.
+            pad (bool, optional): Pad lines with spaces if they are shorter than `length`. Defaults to True.
+
+        Returns:
+            List[Segment]: A line of segments with the desired length.
+        """
+        line_length = sum(segment.cell_length for segment in line)
+        new_line: List[Segment]
+
+        if line_length < length:
+            if pad:
+                new_line = line + [cls(" " * (length - line_length), style)]
+            else:
+                new_line = line[:]
+        elif line_length > length:
+            new_line = []
+            append = new_line.append
+            line_length = 0
+            for segment in line:
+                segment_length = segment.cell_length
+                if line_length + segment_length < length or segment.control:
+                    append(segment)
+                    line_length += segment_length
+                else:
+                    text, segment_style, _ = segment
+                    text = set_cell_size(text, length - line_length)
+                    append(cls(text, segment_style))
+                    break
+        else:
+            new_line = line[:]
+        return new_line
+
+    @classmethod
+    def get_line_length(cls, line: List["Segment"]) -> int:
+        """Get the length of list of segments.
+
+        Args:
+            line (List[Segment]): A line encoded as a list of Segments (assumes no '\\\\n' characters),
+
+        Returns:
+            int: The length of the line.
+        """
+        _cell_len = cell_len
+        return sum(_cell_len(text) for text, style, control in line if not control)
+
+    @classmethod
+    def get_shape(cls, lines: List[List["Segment"]]) -> Tuple[int, int]:
+        """Get the shape (enclosing rectangle) of a list of lines.
+
+        Args:
+            lines (List[List[Segment]]): A list of lines (no '\\\\n' characters).
+
+        Returns:
+            Tuple[int, int]: Width and height in characters.
+        """
+        get_line_length = cls.get_line_length
+        max_width = max(get_line_length(line) for line in lines) if lines else 0
+        return (max_width, len(lines))
+
+    @classmethod
+    def set_shape(
+        cls,
+        lines: List[List["Segment"]],
+        width: int,
+        height: Optional[int] = None,
+        style: Optional[Style] = None,
+        new_lines: bool = False,
+    ) -> List[List["Segment"]]:
+        """Set the shape of a list of lines (enclosing rectangle).
+
+        Args:
+            lines (List[List[Segment]]): A list of lines.
+            width (int): Desired width.
+            height (int, optional): Desired height or None for no change.
+            style (Style, optional): Style of any padding added.
+            new_lines (bool, optional): Padded lines should include "\n". Defaults to False.
+
+        Returns:
+            List[List[Segment]]: New list of lines.
+        """
+        _height = height or len(lines)
+
+        blank = (
+            [cls(" " * width + "\n", style)] if new_lines else [cls(" " * width, style)]
+        )
+
+        adjust_line_length = cls.adjust_line_length
+        shaped_lines = lines[:_height]
+        shaped_lines[:] = [
+            adjust_line_length(line, width, style=style) for line in lines
+        ]
+        if len(shaped_lines) < _height:
+            shaped_lines.extend([blank] * (_height - len(shaped_lines)))
+        return shaped_lines
+
+    @classmethod
+    def align_top(
+        cls: Type["Segment"],
+        lines: List[List["Segment"]],
+        width: int,
+        height: int,
+        style: Style,
+        new_lines: bool = False,
+    ) -> List[List["Segment"]]:
+        """Aligns lines to top (adds extra lines to bottom as required).
+
+        Args:
+            lines (List[List[Segment]]): A list of lines.
+            width (int): Desired width.
+            height (int, optional): Desired height or None for no change.
+            style (Style): Style of any padding added.
+            new_lines (bool, optional): Padded lines should include "\n". Defaults to False.
+
+        Returns:
+            List[List[Segment]]: New list of lines.
+        """
+        extra_lines = height - len(lines)
+        if not extra_lines:
+            return lines[:]
+        lines = lines[:height]
+        blank = cls(" " * width + "\n", style) if new_lines else cls(" " * width, style)
+        lines = lines + [[blank]] * extra_lines
+        return lines
+
+    @classmethod
+    def align_bottom(
+        cls: Type["Segment"],
+        lines: List[List["Segment"]],
+        width: int,
+        height: int,
+        style: Style,
+        new_lines: bool = False,
+    ) -> List[List["Segment"]]:
+        """Aligns render to bottom (adds extra lines above as required).
+
+        Args:
+            lines (List[List[Segment]]): A list of lines.
+            width (int): Desired width.
+            height (int, optional): Desired height or None for no change.
+            style (Style): Style of any padding added. Defaults to None.
+            new_lines (bool, optional): Padded lines should include "\n". Defaults to False.
+
+        Returns:
+            List[List[Segment]]: New list of lines.
+        """
+        extra_lines = height - len(lines)
+        if not extra_lines:
+            return lines[:]
+        lines = lines[:height]
+        blank = cls(" " * width + "\n", style) if new_lines else cls(" " * width, style)
+        lines = [[blank]] * extra_lines + lines
+        return lines
+
+    @classmethod
+    def align_middle(
+        cls: Type["Segment"],
+        lines: List[List["Segment"]],
+        width: int,
+        height: int,
+        style: Style,
+        new_lines: bool = False,
+    ) -> List[List["Segment"]]:
+        """Aligns lines to middle (adds extra lines to above and below as required).
+
+        Args:
+            lines (List[List[Segment]]): A list of lines.
+            width (int): Desired width.
+            height (int, optional): Desired height or None for no change.
+            style (Style): Style of any padding added.
+            new_lines (bool, optional): Padded lines should include "\n". Defaults to False.
+
+        Returns:
+            List[List[Segment]]: New list of lines.
+        """
+        extra_lines = height - len(lines)
+        if not extra_lines:
+            return lines[:]
+        lines = lines[:height]
+        blank = cls(" " * width + "\n", style) if new_lines else cls(" " * width, style)
+        top_lines = extra_lines // 2
+        bottom_lines = extra_lines - top_lines
+        lines = [[blank]] * top_lines + lines + [[blank]] * bottom_lines
+        return lines
+
+    @classmethod
+    def simplify(cls, segments: Iterable["Segment"]) -> Iterable["Segment"]:
+        """Simplify an iterable of segments by combining contiguous segments with the same style.
+
+        Args:
+            segments (Iterable[Segment]): An iterable of segments.
+
+        Returns:
+            Iterable[Segment]: A possibly smaller iterable of segments that will render the same way.
+        """
+        iter_segments = iter(segments)
+        try:
+            last_segment = next(iter_segments)
+        except StopIteration:
+            return
+
+        _Segment = Segment
+        for segment in iter_segments:
+            if last_segment.style == segment.style and not segment.control:
+                last_segment = _Segment(
+                    last_segment.text + segment.text, last_segment.style
+                )
+            else:
+                yield last_segment
+                last_segment = segment
+        yield last_segment
+
+    @classmethod
+    def strip_links(cls, segments: Iterable["Segment"]) -> Iterable["Segment"]:
+        """Remove all links from an iterable of styles.
+
+        Args:
+            segments (Iterable[Segment]): An iterable segments.
+
+        Yields:
+            Segment: Segments with link removed.
+        """
+        for segment in segments:
+            if segment.control or segment.style is None:
+                yield segment
+            else:
+                text, style, _control = segment
+                yield cls(text, style.update_link(None) if style else None)
+
+    @classmethod
+    def strip_styles(cls, segments: Iterable["Segment"]) -> Iterable["Segment"]:
+        """Remove all styles from an iterable of segments.
+
+        Args:
+            segments (Iterable[Segment]): An iterable segments.
+
+        Yields:
+            Segment: Segments with styles replace with None
+        """
+        for text, _style, control in segments:
+            yield cls(text, None, control)
+
+    @classmethod
+    def remove_color(cls, segments: Iterable["Segment"]) -> Iterable["Segment"]:
+        """Remove all color from an iterable of segments.
+
+        Args:
+            segments (Iterable[Segment]): An iterable segments.
+
+        Yields:
+            Segment: Segments with colorless style.
+        """
+
+        cache: Dict[Style, Style] = {}
+        for text, style, control in segments:
+            if style:
+                colorless_style = cache.get(style)
+                if colorless_style is None:
+                    colorless_style = style.without_color
+                    cache[style] = colorless_style
+                yield cls(text, colorless_style, control)
+            else:
+                yield cls(text, None, control)
+
+    @classmethod
+    def divide(
+        cls, segments: Iterable["Segment"], cuts: Iterable[int]
+    ) -> Iterable[List["Segment"]]:
+        """Divides an iterable of segments in to portions.
+
+        Args:
+            cuts (Iterable[int]): Cell positions where to divide.
+
+        Yields:
+            [Iterable[List[Segment]]]: An iterable of Segments in List.
+        """
+        split_segments: List["Segment"] = []
+        add_segment = split_segments.append
+
+        iter_cuts = iter(cuts)
+
+        while True:
+            cut = next(iter_cuts, -1)
+            if cut == -1:
+                return
+            if cut != 0:
+                break
+            yield []
+        pos = 0
+
+        segments_clear = split_segments.clear
+        segments_copy = split_segments.copy
+
+        _cell_len = cached_cell_len
+        for segment in segments:
+            text, _style, control = segment
+            while text:
+                end_pos = pos if control else pos + _cell_len(text)
+                if end_pos < cut:
+                    add_segment(segment)
+                    pos = end_pos
+                    break
+
+                if end_pos == cut:
+                    add_segment(segment)
+                    yield segments_copy()
+                    segments_clear()
+                    pos = end_pos
+
+                    cut = next(iter_cuts, -1)
+                    if cut == -1:
+                        if split_segments:
+                            yield segments_copy()
+                        return
+
+                    break
+
+                else:
+                    before, segment = segment.split_cells(cut - pos)
+                    text, _style, control = segment
+                    add_segment(before)
+                    yield segments_copy()
+                    segments_clear()
+                    pos = cut
+
+                cut = next(iter_cuts, -1)
+                if cut == -1:
+                    if split_segments:
+                        yield segments_copy()
+                    return
+
+        yield segments_copy()
+
+
+class Segments:
+    """A simple renderable to render an iterable of segments. This class may be useful if
+    you want to print segments outside of a __rich_console__ method.
+
+    Args:
+        segments (Iterable[Segment]): An iterable of segments.
+        new_lines (bool, optional): Add new lines between segments. Defaults to False.
+    """
+
+    def __init__(self, segments: Iterable[Segment], new_lines: bool = False) -> None:
+        self.segments = list(segments)
+        self.new_lines = new_lines
+
+    def __rich_console__(
+        self, console: "Console", options: "ConsoleOptions"
+    ) -> "RenderResult":
+        if self.new_lines:
+            line = Segment.line()
+            for segment in self.segments:
+                yield segment
+                yield line
+        else:
+            yield from self.segments
+
+
+class SegmentLines:
+    def __init__(self, lines: Iterable[List[Segment]], new_lines: bool = False) -> None:
+        """A simple renderable containing a number of lines of segments. May be used as an intermediate
+        in rendering process.
+
+        Args:
+            lines (Iterable[List[Segment]]): Lists of segments forming lines.
+            new_lines (bool, optional): Insert new lines after each line. Defaults to False.
+        """
+        self.lines = list(lines)
+        self.new_lines = new_lines
+
+    def __rich_console__(
+        self, console: "Console", options: "ConsoleOptions"
+    ) -> "RenderResult":
+        if self.new_lines:
+            new_line = Segment.line()
+            for line in self.lines:
+                yield from line
+                yield new_line
+        else:
+            for line in self.lines:
+                yield from line
+
+
+if __name__ == "__main__":  # pragma: no cover
+    from pip._vendor.rich.console import Console
+    from pip._vendor.rich.syntax import Syntax
+    from pip._vendor.rich.text import Text
+
+    code = """from rich.console import Console
+console = Console()
+text = Text.from_markup("Hello, [bold magenta]World[/]!")
+console.print(text)"""
+
+    text = Text.from_markup("Hello, [bold magenta]World[/]!")
+
+    console = Console()
+
+    console.rule("rich.Segment")
+    console.print(
+        "A Segment is the last step in the Rich render process before generating text with ANSI codes."
+    )
+    console.print("\nConsider the following code:\n")
+    console.print(Syntax(code, "python", line_numbers=True))
+    console.print()
+    console.print(
+        "When you call [b]print()[/b], Rich [i]renders[/i] the object in to the following:\n"
+    )
+    fragments = list(console.render(text))
+    console.print(fragments)
+    console.print()
+    console.print("The Segments are then processed to produce the following output:\n")
+    console.print(text)
+    console.print(
+        "\nYou will only need to know this if you are implementing your own Rich renderables."
+    )
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/spinner.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/spinner.py
new file mode 100644
index 0000000..70570b6
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/spinner.py
@@ -0,0 +1,138 @@
+from typing import cast, List, Optional, TYPE_CHECKING, Union
+
+from ._spinners import SPINNERS
+from .measure import Measurement
+from .table import Table
+from .text import Text
+
+if TYPE_CHECKING:
+    from .console import Console, ConsoleOptions, RenderResult, RenderableType
+    from .style import StyleType
+
+
+class Spinner:
+    """A spinner animation.
+
+    Args:
+        name (str): Name of spinner (run python -m rich.spinner).
+        text (RenderableType, optional): A renderable to display at the right of the spinner (str or Text typically). Defaults to "".
+        style (StyleType, optional): Style for spinner animation. Defaults to None.
+        speed (float, optional): Speed factor for animation. Defaults to 1.0.
+
+    Raises:
+        KeyError: If name isn't one of the supported spinner animations.
+    """
+
+    def __init__(
+        self,
+        name: str,
+        text: "RenderableType" = "",
+        *,
+        style: Optional["StyleType"] = None,
+        speed: float = 1.0,
+    ) -> None:
+        try:
+            spinner = SPINNERS[name]
+        except KeyError:
+            raise KeyError(f"no spinner called {name!r}")
+        self.text: "Union[RenderableType, Text]" = (
+            Text.from_markup(text) if isinstance(text, str) else text
+        )
+        self.name = name
+        self.frames = cast(List[str], spinner["frames"])[:]
+        self.interval = cast(float, spinner["interval"])
+        self.start_time: Optional[float] = None
+        self.style = style
+        self.speed = speed
+        self.frame_no_offset: float = 0.0
+        self._update_speed = 0.0
+
+    def __rich_console__(
+        self, console: "Console", options: "ConsoleOptions"
+    ) -> "RenderResult":
+        yield self.render(console.get_time())
+
+    def __rich_measure__(
+        self, console: "Console", options: "ConsoleOptions"
+    ) -> Measurement:
+        text = self.render(0)
+        return Measurement.get(console, options, text)
+
+    def render(self, time: float) -> "RenderableType":
+        """Render the spinner for a given time.
+
+        Args:
+            time (float): Time in seconds.
+
+        Returns:
+            RenderableType: A renderable containing animation frame.
+        """
+        if self.start_time is None:
+            self.start_time = time
+
+        frame_no = ((time - self.start_time) * self.speed) / (
+            self.interval / 1000.0
+        ) + self.frame_no_offset
+        frame = Text(
+            self.frames[int(frame_no) % len(self.frames)], style=self.style or ""
+        )
+
+        if self._update_speed:
+            self.frame_no_offset = frame_no
+            self.start_time = time
+            self.speed = self._update_speed
+            self._update_speed = 0.0
+
+        if not self.text:
+            return frame
+        elif isinstance(self.text, (str, Text)):
+            return Text.assemble(frame, " ", self.text)
+        else:
+            table = Table.grid(padding=1)
+            table.add_row(frame, self.text)
+            return table
+
+    def update(
+        self,
+        *,
+        text: "RenderableType" = "",
+        style: Optional["StyleType"] = None,
+        speed: Optional[float] = None,
+    ) -> None:
+        """Updates attributes of a spinner after it has been started.
+
+        Args:
+            text (RenderableType, optional): A renderable to display at the right of the spinner (str or Text typically). Defaults to "".
+            style (StyleType, optional): Style for spinner animation. Defaults to None.
+            speed (float, optional): Speed factor for animation. Defaults to None.
+        """
+        if text:
+            self.text = Text.from_markup(text) if isinstance(text, str) else text
+        if style:
+            self.style = style
+        if speed:
+            self._update_speed = speed
+
+
+if __name__ == "__main__":  # pragma: no cover
+    from time import sleep
+
+    from .columns import Columns
+    from .panel import Panel
+    from .live import Live
+
+    all_spinners = Columns(
+        [
+            Spinner(spinner_name, text=Text(repr(spinner_name), style="green"))
+            for spinner_name in sorted(SPINNERS.keys())
+        ],
+        column_first=True,
+        expand=True,
+    )
+
+    with Live(
+        Panel(all_spinners, title="Spinners", border_style="blue"),
+        refresh_per_second=20,
+    ) as live:
+        while True:
+            sleep(0.1)
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/status.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/status.py
new file mode 100644
index 0000000..6574483
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/status.py
@@ -0,0 +1,131 @@
+from types import TracebackType
+from typing import Optional, Type
+
+from .console import Console, RenderableType
+from .jupyter import JupyterMixin
+from .live import Live
+from .spinner import Spinner
+from .style import StyleType
+
+
+class Status(JupyterMixin):
+    """Displays a status indicator with a 'spinner' animation.
+
+    Args:
+        status (RenderableType): A status renderable (str or Text typically).
+        console (Console, optional): Console instance to use, or None for global console. Defaults to None.
+        spinner (str, optional): Name of spinner animation (see python -m rich.spinner). Defaults to "dots".
+        spinner_style (StyleType, optional): Style of spinner. Defaults to "status.spinner".
+        speed (float, optional): Speed factor for spinner animation. Defaults to 1.0.
+        refresh_per_second (float, optional): Number of refreshes per second. Defaults to 12.5.
+    """
+
+    def __init__(
+        self,
+        status: RenderableType,
+        *,
+        console: Optional[Console] = None,
+        spinner: str = "dots",
+        spinner_style: StyleType = "status.spinner",
+        speed: float = 1.0,
+        refresh_per_second: float = 12.5,
+    ):
+        self.status = status
+        self.spinner_style = spinner_style
+        self.speed = speed
+        self._spinner = Spinner(spinner, text=status, style=spinner_style, speed=speed)
+        self._live = Live(
+            self.renderable,
+            console=console,
+            refresh_per_second=refresh_per_second,
+            transient=True,
+        )
+
+    @property
+    def renderable(self) -> Spinner:
+        return self._spinner
+
+    @property
+    def console(self) -> "Console":
+        """Get the Console used by the Status objects."""
+        return self._live.console
+
+    def update(
+        self,
+        status: Optional[RenderableType] = None,
+        *,
+        spinner: Optional[str] = None,
+        spinner_style: Optional[StyleType] = None,
+        speed: Optional[float] = None,
+    ) -> None:
+        """Update status.
+
+        Args:
+            status (Optional[RenderableType], optional): New status renderable or None for no change. Defaults to None.
+            spinner (Optional[str], optional): New spinner or None for no change. Defaults to None.
+            spinner_style (Optional[StyleType], optional): New spinner style or None for no change. Defaults to None.
+            speed (Optional[float], optional): Speed factor for spinner animation or None for no change. Defaults to None.
+        """
+        if status is not None:
+            self.status = status
+        if spinner_style is not None:
+            self.spinner_style = spinner_style
+        if speed is not None:
+            self.speed = speed
+        if spinner is not None:
+            self._spinner = Spinner(
+                spinner, text=self.status, style=self.spinner_style, speed=self.speed
+            )
+            self._live.update(self.renderable, refresh=True)
+        else:
+            self._spinner.update(
+                text=self.status, style=self.spinner_style, speed=self.speed
+            )
+
+    def start(self) -> None:
+        """Start the status animation."""
+        self._live.start()
+
+    def stop(self) -> None:
+        """Stop the spinner animation."""
+        self._live.stop()
+
+    def __rich__(self) -> RenderableType:
+        return self.renderable
+
+    def __enter__(self) -> "Status":
+        self.start()
+        return self
+
+    def __exit__(
+        self,
+        exc_type: Optional[Type[BaseException]],
+        exc_val: Optional[BaseException],
+        exc_tb: Optional[TracebackType],
+    ) -> None:
+        self.stop()
+
+
+if __name__ == "__main__":  # pragma: no cover
+    from time import sleep
+
+    from .console import Console
+
+    console = Console()
+    with console.status("[magenta]Covid detector booting up") as status:
+        sleep(3)
+        console.log("Importing advanced AI")
+        sleep(3)
+        console.log("Advanced Covid AI Ready")
+        sleep(3)
+        status.update(status="[bold blue] Scanning for Covid", spinner="earth")
+        sleep(3)
+        console.log("Found 10,000,000,000 copies of Covid32.exe")
+        sleep(3)
+        status.update(
+            status="[bold red]Moving Covid32.exe to Trash",
+            spinner="bouncingBall",
+            spinner_style="yellow",
+        )
+        sleep(5)
+    console.print("[bold green]Covid deleted successfully")
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/style.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/style.py
new file mode 100644
index 0000000..262fd6e
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/style.py
@@ -0,0 +1,796 @@
+import sys
+from functools import lru_cache
+from marshal import dumps, loads
+from random import randint
+from typing import Any, Dict, Iterable, List, Optional, Type, Union, cast
+
+from . import errors
+from .color import Color, ColorParseError, ColorSystem, blend_rgb
+from .repr import Result, rich_repr
+from .terminal_theme import DEFAULT_TERMINAL_THEME, TerminalTheme
+
+# Style instances and style definitions are often interchangeable
+StyleType = Union[str, "Style"]
+
+
+class _Bit:
+    """A descriptor to get/set a style attribute bit."""
+
+    __slots__ = ["bit"]
+
+    def __init__(self, bit_no: int) -> None:
+        self.bit = 1 << bit_no
+
+    def __get__(self, obj: "Style", objtype: Type["Style"]) -> Optional[bool]:
+        if obj._set_attributes & self.bit:
+            return obj._attributes & self.bit != 0
+        return None
+
+
+@rich_repr
+class Style:
+    """A terminal style.
+
+    A terminal style consists of a color (`color`), a background color (`bgcolor`), and a number of attributes, such
+    as bold, italic etc. The attributes have 3 states: they can either be on
+    (``True``), off (``False``), or not set (``None``).
+
+    Args:
+        color (Union[Color, str], optional): Color of terminal text. Defaults to None.
+        bgcolor (Union[Color, str], optional): Color of terminal background. Defaults to None.
+        bold (bool, optional): Enable bold text. Defaults to None.
+        dim (bool, optional): Enable dim text. Defaults to None.
+        italic (bool, optional): Enable italic text. Defaults to None.
+        underline (bool, optional): Enable underlined text. Defaults to None.
+        blink (bool, optional): Enabled blinking text. Defaults to None.
+        blink2 (bool, optional): Enable fast blinking text. Defaults to None.
+        reverse (bool, optional): Enabled reverse text. Defaults to None.
+        conceal (bool, optional): Enable concealed text. Defaults to None.
+        strike (bool, optional): Enable strikethrough text. Defaults to None.
+        underline2 (bool, optional): Enable doubly underlined text. Defaults to None.
+        frame (bool, optional): Enable framed text. Defaults to None.
+        encircle (bool, optional): Enable encircled text. Defaults to None.
+        overline (bool, optional): Enable overlined text. Defaults to None.
+        link (str, link): Link URL. Defaults to None.
+
+    """
+
+    _color: Optional[Color]
+    _bgcolor: Optional[Color]
+    _attributes: int
+    _set_attributes: int
+    _hash: Optional[int]
+    _null: bool
+    _meta: Optional[bytes]
+
+    __slots__ = [
+        "_color",
+        "_bgcolor",
+        "_attributes",
+        "_set_attributes",
+        "_link",
+        "_link_id",
+        "_ansi",
+        "_style_definition",
+        "_hash",
+        "_null",
+        "_meta",
+    ]
+
+    # maps bits on to SGR parameter
+    _style_map = {
+        0: "1",
+        1: "2",
+        2: "3",
+        3: "4",
+        4: "5",
+        5: "6",
+        6: "7",
+        7: "8",
+        8: "9",
+        9: "21",
+        10: "51",
+        11: "52",
+        12: "53",
+    }
+
+    STYLE_ATTRIBUTES = {
+        "dim": "dim",
+        "d": "dim",
+        "bold": "bold",
+        "b": "bold",
+        "italic": "italic",
+        "i": "italic",
+        "underline": "underline",
+        "u": "underline",
+        "blink": "blink",
+        "blink2": "blink2",
+        "reverse": "reverse",
+        "r": "reverse",
+        "conceal": "conceal",
+        "c": "conceal",
+        "strike": "strike",
+        "s": "strike",
+        "underline2": "underline2",
+        "uu": "underline2",
+        "frame": "frame",
+        "encircle": "encircle",
+        "overline": "overline",
+        "o": "overline",
+    }
+
+    def __init__(
+        self,
+        *,
+        color: Optional[Union[Color, str]] = None,
+        bgcolor: Optional[Union[Color, str]] = None,
+        bold: Optional[bool] = None,
+        dim: Optional[bool] = None,
+        italic: Optional[bool] = None,
+        underline: Optional[bool] = None,
+        blink: Optional[bool] = None,
+        blink2: Optional[bool] = None,
+        reverse: Optional[bool] = None,
+        conceal: Optional[bool] = None,
+        strike: Optional[bool] = None,
+        underline2: Optional[bool] = None,
+        frame: Optional[bool] = None,
+        encircle: Optional[bool] = None,
+        overline: Optional[bool] = None,
+        link: Optional[str] = None,
+        meta: Optional[Dict[str, Any]] = None,
+    ):
+        self._ansi: Optional[str] = None
+        self._style_definition: Optional[str] = None
+
+        def _make_color(color: Union[Color, str]) -> Color:
+            return color if isinstance(color, Color) else Color.parse(color)
+
+        self._color = None if color is None else _make_color(color)
+        self._bgcolor = None if bgcolor is None else _make_color(bgcolor)
+        self._set_attributes = sum(
+            (
+                bold is not None,
+                dim is not None and 2,
+                italic is not None and 4,
+                underline is not None and 8,
+                blink is not None and 16,
+                blink2 is not None and 32,
+                reverse is not None and 64,
+                conceal is not None and 128,
+                strike is not None and 256,
+                underline2 is not None and 512,
+                frame is not None and 1024,
+                encircle is not None and 2048,
+                overline is not None and 4096,
+            )
+        )
+        self._attributes = (
+            sum(
+                (
+                    bold and 1 or 0,
+                    dim and 2 or 0,
+                    italic and 4 or 0,
+                    underline and 8 or 0,
+                    blink and 16 or 0,
+                    blink2 and 32 or 0,
+                    reverse and 64 or 0,
+                    conceal and 128 or 0,
+                    strike and 256 or 0,
+                    underline2 and 512 or 0,
+                    frame and 1024 or 0,
+                    encircle and 2048 or 0,
+                    overline and 4096 or 0,
+                )
+            )
+            if self._set_attributes
+            else 0
+        )
+
+        self._link = link
+        self._meta = None if meta is None else dumps(meta)
+        self._link_id = (
+            f"{randint(0, 999999)}{hash(self._meta)}" if (link or meta) else ""
+        )
+        self._hash: Optional[int] = None
+        self._null = not (self._set_attributes or color or bgcolor or link or meta)
+
+    @classmethod
+    def null(cls) -> "Style":
+        """Create an 'null' style, equivalent to Style(), but more performant."""
+        return NULL_STYLE
+
+    @classmethod
+    def from_color(
+        cls, color: Optional[Color] = None, bgcolor: Optional[Color] = None
+    ) -> "Style":
+        """Create a new style with colors and no attributes.
+
+        Returns:
+            color (Optional[Color]): A (foreground) color, or None for no color. Defaults to None.
+            bgcolor (Optional[Color]): A (background) color, or None for no color. Defaults to None.
+        """
+        style: Style = cls.__new__(Style)
+        style._ansi = None
+        style._style_definition = None
+        style._color = color
+        style._bgcolor = bgcolor
+        style._set_attributes = 0
+        style._attributes = 0
+        style._link = None
+        style._link_id = ""
+        style._meta = None
+        style._null = not (color or bgcolor)
+        style._hash = None
+        return style
+
+    @classmethod
+    def from_meta(cls, meta: Optional[Dict[str, Any]]) -> "Style":
+        """Create a new style with meta data.
+
+        Returns:
+            meta (Optional[Dict[str, Any]]): A dictionary of meta data. Defaults to None.
+        """
+        style: Style = cls.__new__(Style)
+        style._ansi = None
+        style._style_definition = None
+        style._color = None
+        style._bgcolor = None
+        style._set_attributes = 0
+        style._attributes = 0
+        style._link = None
+        style._meta = dumps(meta)
+        style._link_id = f"{randint(0, 999999)}{hash(style._meta)}"
+        style._hash = None
+        style._null = not (meta)
+        return style
+
+    @classmethod
+    def on(cls, meta: Optional[Dict[str, Any]] = None, **handlers: Any) -> "Style":
+        """Create a blank style with meta information.
+
+        Example:
+            style = Style.on(click=self.on_click)
+
+        Args:
+            meta (Optional[Dict[str, Any]], optional): An optional dict of meta information.
+            **handlers (Any): Keyword arguments are translated in to handlers.
+
+        Returns:
+            Style: A Style with meta information attached.
+        """
+        meta = {} if meta is None else meta
+        meta.update({f"@{key}": value for key, value in handlers.items()})
+        return cls.from_meta(meta)
+
+    bold = _Bit(0)
+    dim = _Bit(1)
+    italic = _Bit(2)
+    underline = _Bit(3)
+    blink = _Bit(4)
+    blink2 = _Bit(5)
+    reverse = _Bit(6)
+    conceal = _Bit(7)
+    strike = _Bit(8)
+    underline2 = _Bit(9)
+    frame = _Bit(10)
+    encircle = _Bit(11)
+    overline = _Bit(12)
+
+    @property
+    def link_id(self) -> str:
+        """Get a link id, used in ansi code for links."""
+        return self._link_id
+
+    def __str__(self) -> str:
+        """Re-generate style definition from attributes."""
+        if self._style_definition is None:
+            attributes: List[str] = []
+            append = attributes.append
+            bits = self._set_attributes
+            if bits & 0b0000000001111:
+                if bits & 1:
+                    append("bold" if self.bold else "not bold")
+                if bits & (1 << 1):
+                    append("dim" if self.dim else "not dim")
+                if bits & (1 << 2):
+                    append("italic" if self.italic else "not italic")
+                if bits & (1 << 3):
+                    append("underline" if self.underline else "not underline")
+            if bits & 0b0000111110000:
+                if bits & (1 << 4):
+                    append("blink" if self.blink else "not blink")
+                if bits & (1 << 5):
+                    append("blink2" if self.blink2 else "not blink2")
+                if bits & (1 << 6):
+                    append("reverse" if self.reverse else "not reverse")
+                if bits & (1 << 7):
+                    append("conceal" if self.conceal else "not conceal")
+                if bits & (1 << 8):
+                    append("strike" if self.strike else "not strike")
+            if bits & 0b1111000000000:
+                if bits & (1 << 9):
+                    append("underline2" if self.underline2 else "not underline2")
+                if bits & (1 << 10):
+                    append("frame" if self.frame else "not frame")
+                if bits & (1 << 11):
+                    append("encircle" if self.encircle else "not encircle")
+                if bits & (1 << 12):
+                    append("overline" if self.overline else "not overline")
+            if self._color is not None:
+                append(self._color.name)
+            if self._bgcolor is not None:
+                append("on")
+                append(self._bgcolor.name)
+            if self._link:
+                append("link")
+                append(self._link)
+            self._style_definition = " ".join(attributes) or "none"
+        return self._style_definition
+
+    def __bool__(self) -> bool:
+        """A Style is false if it has no attributes, colors, or links."""
+        return not self._null
+
+    def _make_ansi_codes(self, color_system: ColorSystem) -> str:
+        """Generate ANSI codes for this style.
+
+        Args:
+            color_system (ColorSystem): Color system.
+
+        Returns:
+            str: String containing codes.
+        """
+
+        if self._ansi is None:
+            sgr: List[str] = []
+            append = sgr.append
+            _style_map = self._style_map
+            attributes = self._attributes & self._set_attributes
+            if attributes:
+                if attributes & 1:
+                    append(_style_map[0])
+                if attributes & 2:
+                    append(_style_map[1])
+                if attributes & 4:
+                    append(_style_map[2])
+                if attributes & 8:
+                    append(_style_map[3])
+                if attributes & 0b0000111110000:
+                    for bit in range(4, 9):
+                        if attributes & (1 << bit):
+                            append(_style_map[bit])
+                if attributes & 0b1111000000000:
+                    for bit in range(9, 13):
+                        if attributes & (1 << bit):
+                            append(_style_map[bit])
+            if self._color is not None:
+                sgr.extend(self._color.downgrade(color_system).get_ansi_codes())
+            if self._bgcolor is not None:
+                sgr.extend(
+                    self._bgcolor.downgrade(color_system).get_ansi_codes(
+                        foreground=False
+                    )
+                )
+            self._ansi = ";".join(sgr)
+        return self._ansi
+
+    @classmethod
+    @lru_cache(maxsize=1024)
+    def normalize(cls, style: str) -> str:
+        """Normalize a style definition so that styles with the same effect have the same string
+        representation.
+
+        Args:
+            style (str): A style definition.
+
+        Returns:
+            str: Normal form of style definition.
+        """
+        try:
+            return str(cls.parse(style))
+        except errors.StyleSyntaxError:
+            return style.strip().lower()
+
+    @classmethod
+    def pick_first(cls, *values: Optional[StyleType]) -> StyleType:
+        """Pick first non-None style."""
+        for value in values:
+            if value is not None:
+                return value
+        raise ValueError("expected at least one non-None style")
+
+    def __rich_repr__(self) -> Result:
+        yield "color", self.color, None
+        yield "bgcolor", self.bgcolor, None
+        yield "bold", self.bold, None,
+        yield "dim", self.dim, None,
+        yield "italic", self.italic, None
+        yield "underline", self.underline, None,
+        yield "blink", self.blink, None
+        yield "blink2", self.blink2, None
+        yield "reverse", self.reverse, None
+        yield "conceal", self.conceal, None
+        yield "strike", self.strike, None
+        yield "underline2", self.underline2, None
+        yield "frame", self.frame, None
+        yield "encircle", self.encircle, None
+        yield "link", self.link, None
+        if self._meta:
+            yield "meta", self.meta
+
+    def __eq__(self, other: Any) -> bool:
+        if not isinstance(other, Style):
+            return NotImplemented
+        return self.__hash__() == other.__hash__()
+
+    def __ne__(self, other: Any) -> bool:
+        if not isinstance(other, Style):
+            return NotImplemented
+        return self.__hash__() != other.__hash__()
+
+    def __hash__(self) -> int:
+        if self._hash is not None:
+            return self._hash
+        self._hash = hash(
+            (
+                self._color,
+                self._bgcolor,
+                self._attributes,
+                self._set_attributes,
+                self._link,
+                self._meta,
+            )
+        )
+        return self._hash
+
+    @property
+    def color(self) -> Optional[Color]:
+        """The foreground color or None if it is not set."""
+        return self._color
+
+    @property
+    def bgcolor(self) -> Optional[Color]:
+        """The background color or None if it is not set."""
+        return self._bgcolor
+
+    @property
+    def link(self) -> Optional[str]:
+        """Link text, if set."""
+        return self._link
+
+    @property
+    def transparent_background(self) -> bool:
+        """Check if the style specified a transparent background."""
+        return self.bgcolor is None or self.bgcolor.is_default
+
+    @property
+    def background_style(self) -> "Style":
+        """A Style with background only."""
+        return Style(bgcolor=self.bgcolor)
+
+    @property
+    def meta(self) -> Dict[str, Any]:
+        """Get meta information (can not be changed after construction)."""
+        return {} if self._meta is None else cast(Dict[str, Any], loads(self._meta))
+
+    @property
+    def without_color(self) -> "Style":
+        """Get a copy of the style with color removed."""
+        if self._null:
+            return NULL_STYLE
+        style: Style = self.__new__(Style)
+        style._ansi = None
+        style._style_definition = None
+        style._color = None
+        style._bgcolor = None
+        style._attributes = self._attributes
+        style._set_attributes = self._set_attributes
+        style._link = self._link
+        style._link_id = f"{randint(0, 999999)}" if self._link else ""
+        style._null = False
+        style._meta = None
+        style._hash = None
+        return style
+
+    @classmethod
+    @lru_cache(maxsize=4096)
+    def parse(cls, style_definition: str) -> "Style":
+        """Parse a style definition.
+
+        Args:
+            style_definition (str): A string containing a style.
+
+        Raises:
+            errors.StyleSyntaxError: If the style definition syntax is invalid.
+
+        Returns:
+            `Style`: A Style instance.
+        """
+        if style_definition.strip() == "none" or not style_definition:
+            return cls.null()
+
+        STYLE_ATTRIBUTES = cls.STYLE_ATTRIBUTES
+        color: Optional[str] = None
+        bgcolor: Optional[str] = None
+        attributes: Dict[str, Optional[Any]] = {}
+        link: Optional[str] = None
+
+        words = iter(style_definition.split())
+        for original_word in words:
+            word = original_word.lower()
+            if word == "on":
+                word = next(words, "")
+                if not word:
+                    raise errors.StyleSyntaxError("color expected after 'on'")
+                try:
+                    Color.parse(word) is None
+                except ColorParseError as error:
+                    raise errors.StyleSyntaxError(
+                        f"unable to parse {word!r} as background color; {error}"
+                    ) from None
+                bgcolor = word
+
+            elif word == "not":
+                word = next(words, "")
+                attribute = STYLE_ATTRIBUTES.get(word)
+                if attribute is None:
+                    raise errors.StyleSyntaxError(
+                        f"expected style attribute after 'not', found {word!r}"
+                    )
+                attributes[attribute] = False
+
+            elif word == "link":
+                word = next(words, "")
+                if not word:
+                    raise errors.StyleSyntaxError("URL expected after 'link'")
+                link = word
+
+            elif word in STYLE_ATTRIBUTES:
+                attributes[STYLE_ATTRIBUTES[word]] = True
+
+            else:
+                try:
+                    Color.parse(word)
+                except ColorParseError as error:
+                    raise errors.StyleSyntaxError(
+                        f"unable to parse {word!r} as color; {error}"
+                    ) from None
+                color = word
+        style = Style(color=color, bgcolor=bgcolor, link=link, **attributes)
+        return style
+
+    @lru_cache(maxsize=1024)
+    def get_html_style(self, theme: Optional[TerminalTheme] = None) -> str:
+        """Get a CSS style rule."""
+        theme = theme or DEFAULT_TERMINAL_THEME
+        css: List[str] = []
+        append = css.append
+
+        color = self.color
+        bgcolor = self.bgcolor
+        if self.reverse:
+            color, bgcolor = bgcolor, color
+        if self.dim:
+            foreground_color = (
+                theme.foreground_color if color is None else color.get_truecolor(theme)
+            )
+            color = Color.from_triplet(
+                blend_rgb(foreground_color, theme.background_color, 0.5)
+            )
+        if color is not None:
+            theme_color = color.get_truecolor(theme)
+            append(f"color: {theme_color.hex}")
+            append(f"text-decoration-color: {theme_color.hex}")
+        if bgcolor is not None:
+            theme_color = bgcolor.get_truecolor(theme, foreground=False)
+            append(f"background-color: {theme_color.hex}")
+        if self.bold:
+            append("font-weight: bold")
+        if self.italic:
+            append("font-style: italic")
+        if self.underline:
+            append("text-decoration: underline")
+        if self.strike:
+            append("text-decoration: line-through")
+        if self.overline:
+            append("text-decoration: overline")
+        return "; ".join(css)
+
+    @classmethod
+    def combine(cls, styles: Iterable["Style"]) -> "Style":
+        """Combine styles and get result.
+
+        Args:
+            styles (Iterable[Style]): Styles to combine.
+
+        Returns:
+            Style: A new style instance.
+        """
+        iter_styles = iter(styles)
+        return sum(iter_styles, next(iter_styles))
+
+    @classmethod
+    def chain(cls, *styles: "Style") -> "Style":
+        """Combine styles from positional argument in to a single style.
+
+        Args:
+            *styles (Iterable[Style]): Styles to combine.
+
+        Returns:
+            Style: A new style instance.
+        """
+        iter_styles = iter(styles)
+        return sum(iter_styles, next(iter_styles))
+
+    def copy(self) -> "Style":
+        """Get a copy of this style.
+
+        Returns:
+            Style: A new Style instance with identical attributes.
+        """
+        if self._null:
+            return NULL_STYLE
+        style: Style = self.__new__(Style)
+        style._ansi = self._ansi
+        style._style_definition = self._style_definition
+        style._color = self._color
+        style._bgcolor = self._bgcolor
+        style._attributes = self._attributes
+        style._set_attributes = self._set_attributes
+        style._link = self._link
+        style._link_id = f"{randint(0, 999999)}" if self._link else ""
+        style._hash = self._hash
+        style._null = False
+        style._meta = self._meta
+        return style
+
+    @lru_cache(maxsize=128)
+    def clear_meta_and_links(self) -> "Style":
+        """Get a copy of this style with link and meta information removed.
+
+        Returns:
+            Style: New style object.
+        """
+        if self._null:
+            return NULL_STYLE
+        style: Style = self.__new__(Style)
+        style._ansi = self._ansi
+        style._style_definition = self._style_definition
+        style._color = self._color
+        style._bgcolor = self._bgcolor
+        style._attributes = self._attributes
+        style._set_attributes = self._set_attributes
+        style._link = None
+        style._link_id = ""
+        style._hash = None
+        style._null = False
+        style._meta = None
+        return style
+
+    def update_link(self, link: Optional[str] = None) -> "Style":
+        """Get a copy with a different value for link.
+
+        Args:
+            link (str, optional): New value for link. Defaults to None.
+
+        Returns:
+            Style: A new Style instance.
+        """
+        style: Style = self.__new__(Style)
+        style._ansi = self._ansi
+        style._style_definition = self._style_definition
+        style._color = self._color
+        style._bgcolor = self._bgcolor
+        style._attributes = self._attributes
+        style._set_attributes = self._set_attributes
+        style._link = link
+        style._link_id = f"{randint(0, 999999)}" if link else ""
+        style._hash = None
+        style._null = False
+        style._meta = self._meta
+        return style
+
+    def render(
+        self,
+        text: str = "",
+        *,
+        color_system: Optional[ColorSystem] = ColorSystem.TRUECOLOR,
+        legacy_windows: bool = False,
+    ) -> str:
+        """Render the ANSI codes for the style.
+
+        Args:
+            text (str, optional): A string to style. Defaults to "".
+            color_system (Optional[ColorSystem], optional): Color system to render to. Defaults to ColorSystem.TRUECOLOR.
+
+        Returns:
+            str: A string containing ANSI style codes.
+        """
+        if not text or color_system is None:
+            return text
+        attrs = self._ansi or self._make_ansi_codes(color_system)
+        rendered = f"\x1b[{attrs}m{text}\x1b[0m" if attrs else text
+        if self._link and not legacy_windows:
+            rendered = (
+                f"\x1b]8;id={self._link_id};{self._link}\x1b\\{rendered}\x1b]8;;\x1b\\"
+            )
+        return rendered
+
+    def test(self, text: Optional[str] = None) -> None:
+        """Write text with style directly to terminal.
+
+        This method is for testing purposes only.
+
+        Args:
+            text (Optional[str], optional): Text to style or None for style name.
+
+        """
+        text = text or str(self)
+        sys.stdout.write(f"{self.render(text)}\n")
+
+    @lru_cache(maxsize=1024)
+    def _add(self, style: Optional["Style"]) -> "Style":
+        if style is None or style._null:
+            return self
+        if self._null:
+            return style
+        new_style: Style = self.__new__(Style)
+        new_style._ansi = None
+        new_style._style_definition = None
+        new_style._color = style._color or self._color
+        new_style._bgcolor = style._bgcolor or self._bgcolor
+        new_style._attributes = (self._attributes & ~style._set_attributes) | (
+            style._attributes & style._set_attributes
+        )
+        new_style._set_attributes = self._set_attributes | style._set_attributes
+        new_style._link = style._link or self._link
+        new_style._link_id = style._link_id or self._link_id
+        new_style._null = style._null
+        if self._meta and style._meta:
+            new_style._meta = dumps({**self.meta, **style.meta})
+        else:
+            new_style._meta = self._meta or style._meta
+        new_style._hash = None
+        return new_style
+
+    def __add__(self, style: Optional["Style"]) -> "Style":
+        combined_style = self._add(style)
+        return combined_style.copy() if combined_style.link else combined_style
+
+
+NULL_STYLE = Style()
+
+
+class StyleStack:
+    """A stack of styles."""
+
+    __slots__ = ["_stack"]
+
+    def __init__(self, default_style: "Style") -> None:
+        self._stack: List[Style] = [default_style]
+
+    def __repr__(self) -> str:
+        return f""
+
+    @property
+    def current(self) -> Style:
+        """Get the Style at the top of the stack."""
+        return self._stack[-1]
+
+    def push(self, style: Style) -> None:
+        """Push a new style on to the stack.
+
+        Args:
+            style (Style): New style to combine with current style.
+        """
+        self._stack.append(self._stack[-1] + style)
+
+    def pop(self) -> Style:
+        """Pop last style and discard.
+
+        Returns:
+            Style: New current style (also available as stack.current)
+        """
+        self._stack.pop()
+        return self._stack[-1]
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/styled.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/styled.py
new file mode 100644
index 0000000..91cd0db
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/styled.py
@@ -0,0 +1,42 @@
+from typing import TYPE_CHECKING
+
+from .measure import Measurement
+from .segment import Segment
+from .style import StyleType
+
+if TYPE_CHECKING:
+    from .console import Console, ConsoleOptions, RenderResult, RenderableType
+
+
+class Styled:
+    """Apply a style to a renderable.
+
+    Args:
+        renderable (RenderableType): Any renderable.
+        style (StyleType): A style to apply across the entire renderable.
+    """
+
+    def __init__(self, renderable: "RenderableType", style: "StyleType") -> None:
+        self.renderable = renderable
+        self.style = style
+
+    def __rich_console__(
+        self, console: "Console", options: "ConsoleOptions"
+    ) -> "RenderResult":
+        style = console.get_style(self.style)
+        rendered_segments = console.render(self.renderable, options)
+        segments = Segment.apply_style(rendered_segments, style)
+        return segments
+
+    def __rich_measure__(
+        self, console: "Console", options: "ConsoleOptions"
+    ) -> Measurement:
+        return Measurement.get(console, options, self.renderable)
+
+
+if __name__ == "__main__":  # pragma: no cover
+    from pip._vendor.rich import print
+    from pip._vendor.rich.panel import Panel
+
+    panel = Styled(Panel("hello"), "on blue")
+    print(panel)
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/syntax.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/syntax.py
new file mode 100644
index 0000000..f3d483c
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/syntax.py
@@ -0,0 +1,966 @@
+import os.path
+import re
+import sys
+import textwrap
+from abc import ABC, abstractmethod
+from pathlib import Path
+from typing import (
+    Any,
+    Dict,
+    Iterable,
+    List,
+    NamedTuple,
+    Optional,
+    Sequence,
+    Set,
+    Tuple,
+    Type,
+    Union,
+)
+
+from pip._vendor.pygments.lexer import Lexer
+from pip._vendor.pygments.lexers import get_lexer_by_name, guess_lexer_for_filename
+from pip._vendor.pygments.style import Style as PygmentsStyle
+from pip._vendor.pygments.styles import get_style_by_name
+from pip._vendor.pygments.token import (
+    Comment,
+    Error,
+    Generic,
+    Keyword,
+    Name,
+    Number,
+    Operator,
+    String,
+    Token,
+    Whitespace,
+)
+from pip._vendor.pygments.util import ClassNotFound
+
+from pip._vendor.rich.containers import Lines
+from pip._vendor.rich.padding import Padding, PaddingDimensions
+
+from ._loop import loop_first
+from .cells import cell_len
+from .color import Color, blend_rgb
+from .console import Console, ConsoleOptions, JustifyMethod, RenderResult
+from .jupyter import JupyterMixin
+from .measure import Measurement
+from .segment import Segment, Segments
+from .style import Style, StyleType
+from .text import Text
+
+TokenType = Tuple[str, ...]
+
+WINDOWS = sys.platform == "win32"
+DEFAULT_THEME = "monokai"
+
+# The following styles are based on https://github.com/pygments/pygments/blob/master/pygments/formatters/terminal.py
+# A few modifications were made
+
+ANSI_LIGHT: Dict[TokenType, Style] = {
+    Token: Style(),
+    Whitespace: Style(color="white"),
+    Comment: Style(dim=True),
+    Comment.Preproc: Style(color="cyan"),
+    Keyword: Style(color="blue"),
+    Keyword.Type: Style(color="cyan"),
+    Operator.Word: Style(color="magenta"),
+    Name.Builtin: Style(color="cyan"),
+    Name.Function: Style(color="green"),
+    Name.Namespace: Style(color="cyan", underline=True),
+    Name.Class: Style(color="green", underline=True),
+    Name.Exception: Style(color="cyan"),
+    Name.Decorator: Style(color="magenta", bold=True),
+    Name.Variable: Style(color="red"),
+    Name.Constant: Style(color="red"),
+    Name.Attribute: Style(color="cyan"),
+    Name.Tag: Style(color="bright_blue"),
+    String: Style(color="yellow"),
+    Number: Style(color="blue"),
+    Generic.Deleted: Style(color="bright_red"),
+    Generic.Inserted: Style(color="green"),
+    Generic.Heading: Style(bold=True),
+    Generic.Subheading: Style(color="magenta", bold=True),
+    Generic.Prompt: Style(bold=True),
+    Generic.Error: Style(color="bright_red"),
+    Error: Style(color="red", underline=True),
+}
+
+ANSI_DARK: Dict[TokenType, Style] = {
+    Token: Style(),
+    Whitespace: Style(color="bright_black"),
+    Comment: Style(dim=True),
+    Comment.Preproc: Style(color="bright_cyan"),
+    Keyword: Style(color="bright_blue"),
+    Keyword.Type: Style(color="bright_cyan"),
+    Operator.Word: Style(color="bright_magenta"),
+    Name.Builtin: Style(color="bright_cyan"),
+    Name.Function: Style(color="bright_green"),
+    Name.Namespace: Style(color="bright_cyan", underline=True),
+    Name.Class: Style(color="bright_green", underline=True),
+    Name.Exception: Style(color="bright_cyan"),
+    Name.Decorator: Style(color="bright_magenta", bold=True),
+    Name.Variable: Style(color="bright_red"),
+    Name.Constant: Style(color="bright_red"),
+    Name.Attribute: Style(color="bright_cyan"),
+    Name.Tag: Style(color="bright_blue"),
+    String: Style(color="yellow"),
+    Number: Style(color="bright_blue"),
+    Generic.Deleted: Style(color="bright_red"),
+    Generic.Inserted: Style(color="bright_green"),
+    Generic.Heading: Style(bold=True),
+    Generic.Subheading: Style(color="bright_magenta", bold=True),
+    Generic.Prompt: Style(bold=True),
+    Generic.Error: Style(color="bright_red"),
+    Error: Style(color="red", underline=True),
+}
+
+RICH_SYNTAX_THEMES = {"ansi_light": ANSI_LIGHT, "ansi_dark": ANSI_DARK}
+NUMBERS_COLUMN_DEFAULT_PADDING = 2
+
+
+class SyntaxTheme(ABC):
+    """Base class for a syntax theme."""
+
+    @abstractmethod
+    def get_style_for_token(self, token_type: TokenType) -> Style:
+        """Get a style for a given Pygments token."""
+        raise NotImplementedError  # pragma: no cover
+
+    @abstractmethod
+    def get_background_style(self) -> Style:
+        """Get the background color."""
+        raise NotImplementedError  # pragma: no cover
+
+
+class PygmentsSyntaxTheme(SyntaxTheme):
+    """Syntax theme that delegates to Pygments theme."""
+
+    def __init__(self, theme: Union[str, Type[PygmentsStyle]]) -> None:
+        self._style_cache: Dict[TokenType, Style] = {}
+        if isinstance(theme, str):
+            try:
+                self._pygments_style_class = get_style_by_name(theme)
+            except ClassNotFound:
+                self._pygments_style_class = get_style_by_name("default")
+        else:
+            self._pygments_style_class = theme
+
+        self._background_color = self._pygments_style_class.background_color
+        self._background_style = Style(bgcolor=self._background_color)
+
+    def get_style_for_token(self, token_type: TokenType) -> Style:
+        """Get a style from a Pygments class."""
+        try:
+            return self._style_cache[token_type]
+        except KeyError:
+            try:
+                pygments_style = self._pygments_style_class.style_for_token(token_type)
+            except KeyError:
+                style = Style.null()
+            else:
+                color = pygments_style["color"]
+                bgcolor = pygments_style["bgcolor"]
+                style = Style(
+                    color="#" + color if color else "#000000",
+                    bgcolor="#" + bgcolor if bgcolor else self._background_color,
+                    bold=pygments_style["bold"],
+                    italic=pygments_style["italic"],
+                    underline=pygments_style["underline"],
+                )
+            self._style_cache[token_type] = style
+        return style
+
+    def get_background_style(self) -> Style:
+        return self._background_style
+
+
+class ANSISyntaxTheme(SyntaxTheme):
+    """Syntax theme to use standard colors."""
+
+    def __init__(self, style_map: Dict[TokenType, Style]) -> None:
+        self.style_map = style_map
+        self._missing_style = Style.null()
+        self._background_style = Style.null()
+        self._style_cache: Dict[TokenType, Style] = {}
+
+    def get_style_for_token(self, token_type: TokenType) -> Style:
+        """Look up style in the style map."""
+        try:
+            return self._style_cache[token_type]
+        except KeyError:
+            # Styles form a hierarchy
+            # We need to go from most to least specific
+            # e.g. ("foo", "bar", "baz") to ("foo", "bar")  to ("foo",)
+            get_style = self.style_map.get
+            token = tuple(token_type)
+            style = self._missing_style
+            while token:
+                _style = get_style(token)
+                if _style is not None:
+                    style = _style
+                    break
+                token = token[:-1]
+            self._style_cache[token_type] = style
+            return style
+
+    def get_background_style(self) -> Style:
+        return self._background_style
+
+
+SyntaxPosition = Tuple[int, int]
+
+
+class _SyntaxHighlightRange(NamedTuple):
+    """
+    A range to highlight in a Syntax object.
+    `start` and `end` are 2-integers tuples, where the first integer is the line number
+    (starting from 1) and the second integer is the column index (starting from 0).
+    """
+
+    style: StyleType
+    start: SyntaxPosition
+    end: SyntaxPosition
+    style_before: bool = False
+
+
+class Syntax(JupyterMixin):
+    """Construct a Syntax object to render syntax highlighted code.
+
+    Args:
+        code (str): Code to highlight.
+        lexer (Lexer | str): Lexer to use (see https://pygments.org/docs/lexers/)
+        theme (str, optional): Color theme, aka Pygments style (see https://pygments.org/docs/styles/#getting-a-list-of-available-styles). Defaults to "monokai".
+        dedent (bool, optional): Enable stripping of initial whitespace. Defaults to False.
+        line_numbers (bool, optional): Enable rendering of line numbers. Defaults to False.
+        start_line (int, optional): Starting number for line numbers. Defaults to 1.
+        line_range (Tuple[int | None, int | None], optional): If given should be a tuple of the start and end line to render.
+            A value of None in the tuple indicates the range is open in that direction.
+        highlight_lines (Set[int]): A set of line numbers to highlight.
+        code_width: Width of code to render (not including line numbers), or ``None`` to use all available width.
+        tab_size (int, optional): Size of tabs. Defaults to 4.
+        word_wrap (bool, optional): Enable word wrapping.
+        background_color (str, optional): Optional background color, or None to use theme color. Defaults to None.
+        indent_guides (bool, optional): Show indent guides. Defaults to False.
+        padding (PaddingDimensions): Padding to apply around the syntax. Defaults to 0 (no padding).
+    """
+
+    _pygments_style_class: Type[PygmentsStyle]
+    _theme: SyntaxTheme
+
+    @classmethod
+    def get_theme(cls, name: Union[str, SyntaxTheme]) -> SyntaxTheme:
+        """Get a syntax theme instance."""
+        if isinstance(name, SyntaxTheme):
+            return name
+        theme: SyntaxTheme
+        if name in RICH_SYNTAX_THEMES:
+            theme = ANSISyntaxTheme(RICH_SYNTAX_THEMES[name])
+        else:
+            theme = PygmentsSyntaxTheme(name)
+        return theme
+
+    def __init__(
+        self,
+        code: str,
+        lexer: Union[Lexer, str],
+        *,
+        theme: Union[str, SyntaxTheme] = DEFAULT_THEME,
+        dedent: bool = False,
+        line_numbers: bool = False,
+        start_line: int = 1,
+        line_range: Optional[Tuple[Optional[int], Optional[int]]] = None,
+        highlight_lines: Optional[Set[int]] = None,
+        code_width: Optional[int] = None,
+        tab_size: int = 4,
+        word_wrap: bool = False,
+        background_color: Optional[str] = None,
+        indent_guides: bool = False,
+        padding: PaddingDimensions = 0,
+    ) -> None:
+        self.code = code
+        self._lexer = lexer
+        self.dedent = dedent
+        self.line_numbers = line_numbers
+        self.start_line = start_line
+        self.line_range = line_range
+        self.highlight_lines = highlight_lines or set()
+        self.code_width = code_width
+        self.tab_size = tab_size
+        self.word_wrap = word_wrap
+        self.background_color = background_color
+        self.background_style = (
+            Style(bgcolor=background_color) if background_color else Style()
+        )
+        self.indent_guides = indent_guides
+        self.padding = padding
+
+        self._theme = self.get_theme(theme)
+        self._stylized_ranges: List[_SyntaxHighlightRange] = []
+
+    @classmethod
+    def from_path(
+        cls,
+        path: str,
+        encoding: str = "utf-8",
+        lexer: Optional[Union[Lexer, str]] = None,
+        theme: Union[str, SyntaxTheme] = DEFAULT_THEME,
+        dedent: bool = False,
+        line_numbers: bool = False,
+        line_range: Optional[Tuple[int, int]] = None,
+        start_line: int = 1,
+        highlight_lines: Optional[Set[int]] = None,
+        code_width: Optional[int] = None,
+        tab_size: int = 4,
+        word_wrap: bool = False,
+        background_color: Optional[str] = None,
+        indent_guides: bool = False,
+        padding: PaddingDimensions = 0,
+    ) -> "Syntax":
+        """Construct a Syntax object from a file.
+
+        Args:
+            path (str): Path to file to highlight.
+            encoding (str): Encoding of file.
+            lexer (str | Lexer, optional): Lexer to use. If None, lexer will be auto-detected from path/file content.
+            theme (str, optional): Color theme, aka Pygments style (see https://pygments.org/docs/styles/#getting-a-list-of-available-styles). Defaults to "emacs".
+            dedent (bool, optional): Enable stripping of initial whitespace. Defaults to True.
+            line_numbers (bool, optional): Enable rendering of line numbers. Defaults to False.
+            start_line (int, optional): Starting number for line numbers. Defaults to 1.
+            line_range (Tuple[int, int], optional): If given should be a tuple of the start and end line to render.
+            highlight_lines (Set[int]): A set of line numbers to highlight.
+            code_width: Width of code to render (not including line numbers), or ``None`` to use all available width.
+            tab_size (int, optional): Size of tabs. Defaults to 4.
+            word_wrap (bool, optional): Enable word wrapping of code.
+            background_color (str, optional): Optional background color, or None to use theme color. Defaults to None.
+            indent_guides (bool, optional): Show indent guides. Defaults to False.
+            padding (PaddingDimensions): Padding to apply around the syntax. Defaults to 0 (no padding).
+
+        Returns:
+            [Syntax]: A Syntax object that may be printed to the console
+        """
+        code = Path(path).read_text(encoding=encoding)
+
+        if not lexer:
+            lexer = cls.guess_lexer(path, code=code)
+
+        return cls(
+            code,
+            lexer,
+            theme=theme,
+            dedent=dedent,
+            line_numbers=line_numbers,
+            line_range=line_range,
+            start_line=start_line,
+            highlight_lines=highlight_lines,
+            code_width=code_width,
+            tab_size=tab_size,
+            word_wrap=word_wrap,
+            background_color=background_color,
+            indent_guides=indent_guides,
+            padding=padding,
+        )
+
+    @classmethod
+    def guess_lexer(cls, path: str, code: Optional[str] = None) -> str:
+        """Guess the alias of the Pygments lexer to use based on a path and an optional string of code.
+        If code is supplied, it will use a combination of the code and the filename to determine the
+        best lexer to use. For example, if the file is ``index.html`` and the file contains Django
+        templating syntax, then "html+django" will be returned. If the file is ``index.html``, and no
+        templating language is used, the "html" lexer will be used. If no string of code
+        is supplied, the lexer will be chosen based on the file extension..
+
+        Args:
+             path (AnyStr): The path to the file containing the code you wish to know the lexer for.
+             code (str, optional): Optional string of code that will be used as a fallback if no lexer
+                is found for the supplied path.
+
+        Returns:
+            str: The name of the Pygments lexer that best matches the supplied path/code.
+        """
+        lexer: Optional[Lexer] = None
+        lexer_name = "default"
+        if code:
+            try:
+                lexer = guess_lexer_for_filename(path, code)
+            except ClassNotFound:
+                pass
+
+        if not lexer:
+            try:
+                _, ext = os.path.splitext(path)
+                if ext:
+                    extension = ext.lstrip(".").lower()
+                    lexer = get_lexer_by_name(extension)
+            except ClassNotFound:
+                pass
+
+        if lexer:
+            if lexer.aliases:
+                lexer_name = lexer.aliases[0]
+            else:
+                lexer_name = lexer.name
+
+        return lexer_name
+
+    def _get_base_style(self) -> Style:
+        """Get the base style."""
+        default_style = self._theme.get_background_style() + self.background_style
+        return default_style
+
+    def _get_token_color(self, token_type: TokenType) -> Optional[Color]:
+        """Get a color (if any) for the given token.
+
+        Args:
+            token_type (TokenType): A token type tuple from Pygments.
+
+        Returns:
+            Optional[Color]: Color from theme, or None for no color.
+        """
+        style = self._theme.get_style_for_token(token_type)
+        return style.color
+
+    @property
+    def lexer(self) -> Optional[Lexer]:
+        """The lexer for this syntax, or None if no lexer was found.
+
+        Tries to find the lexer by name if a string was passed to the constructor.
+        """
+
+        if isinstance(self._lexer, Lexer):
+            return self._lexer
+        try:
+            return get_lexer_by_name(
+                self._lexer,
+                stripnl=False,
+                ensurenl=True,
+                tabsize=self.tab_size,
+            )
+        except ClassNotFound:
+            return None
+
+    @property
+    def default_lexer(self) -> Lexer:
+        """A Pygments Lexer to use if one is not specified or invalid."""
+        return get_lexer_by_name(
+            "text",
+            stripnl=False,
+            ensurenl=True,
+            tabsize=self.tab_size,
+        )
+
+    def highlight(
+        self,
+        code: str,
+        line_range: Optional[Tuple[Optional[int], Optional[int]]] = None,
+    ) -> Text:
+        """Highlight code and return a Text instance.
+
+        Args:
+            code (str): Code to highlight.
+            line_range(Tuple[int, int], optional): Optional line range to highlight.
+
+        Returns:
+            Text: A text instance containing highlighted syntax.
+        """
+
+        base_style = self._get_base_style()
+        justify: JustifyMethod = (
+            "default" if base_style.transparent_background else "left"
+        )
+
+        text = Text(
+            justify=justify,
+            style=base_style,
+            tab_size=self.tab_size,
+            no_wrap=not self.word_wrap,
+        )
+        _get_theme_style = self._theme.get_style_for_token
+
+        lexer = self.lexer or self.default_lexer
+
+        if lexer is None:
+            text.append(code)
+        else:
+            if line_range:
+                # More complicated path to only stylize a portion of the code
+                # This speeds up further operations as there are less spans to process
+                line_start, line_end = line_range
+
+                def line_tokenize() -> Iterable[Tuple[Any, str]]:
+                    """Split tokens to one per line."""
+                    assert lexer  # required to make MyPy happy - we know lexer is not None at this point
+
+                    for token_type, token in lexer.get_tokens(code):
+                        while token:
+                            line_token, new_line, token = token.partition("\n")
+                            yield token_type, line_token + new_line
+
+                def tokens_to_spans() -> Iterable[Tuple[str, Optional[Style]]]:
+                    """Convert tokens to spans."""
+                    tokens = iter(line_tokenize())
+                    line_no = 0
+                    _line_start = line_start - 1 if line_start else 0
+
+                    # Skip over tokens until line start
+                    while line_no < _line_start:
+                        try:
+                            _token_type, token = next(tokens)
+                        except StopIteration:
+                            break
+                        yield (token, None)
+                        if token.endswith("\n"):
+                            line_no += 1
+                    # Generate spans until line end
+                    for token_type, token in tokens:
+                        yield (token, _get_theme_style(token_type))
+                        if token.endswith("\n"):
+                            line_no += 1
+                            if line_end and line_no >= line_end:
+                                break
+
+                text.append_tokens(tokens_to_spans())
+
+            else:
+                text.append_tokens(
+                    (token, _get_theme_style(token_type))
+                    for token_type, token in lexer.get_tokens(code)
+                )
+            if self.background_color is not None:
+                text.stylize(f"on {self.background_color}")
+
+        if self._stylized_ranges:
+            self._apply_stylized_ranges(text)
+
+        return text
+
+    def stylize_range(
+        self,
+        style: StyleType,
+        start: SyntaxPosition,
+        end: SyntaxPosition,
+        style_before: bool = False,
+    ) -> None:
+        """
+        Adds a custom style on a part of the code, that will be applied to the syntax display when it's rendered.
+        Line numbers are 1-based, while column indexes are 0-based.
+
+        Args:
+            style (StyleType): The style to apply.
+            start (Tuple[int, int]): The start of the range, in the form `[line number, column index]`.
+            end (Tuple[int, int]): The end of the range, in the form `[line number, column index]`.
+            style_before (bool): Apply the style before any existing styles.
+        """
+        self._stylized_ranges.append(
+            _SyntaxHighlightRange(style, start, end, style_before)
+        )
+
+    def _get_line_numbers_color(self, blend: float = 0.3) -> Color:
+        background_style = self._theme.get_background_style() + self.background_style
+        background_color = background_style.bgcolor
+        if background_color is None or background_color.is_system_defined:
+            return Color.default()
+        foreground_color = self._get_token_color(Token.Text)
+        if foreground_color is None or foreground_color.is_system_defined:
+            return foreground_color or Color.default()
+        new_color = blend_rgb(
+            background_color.get_truecolor(),
+            foreground_color.get_truecolor(),
+            cross_fade=blend,
+        )
+        return Color.from_triplet(new_color)
+
+    @property
+    def _numbers_column_width(self) -> int:
+        """Get the number of characters used to render the numbers column."""
+        column_width = 0
+        if self.line_numbers:
+            column_width = (
+                len(str(self.start_line + self.code.count("\n")))
+                + NUMBERS_COLUMN_DEFAULT_PADDING
+            )
+        return column_width
+
+    def _get_number_styles(self, console: Console) -> Tuple[Style, Style, Style]:
+        """Get background, number, and highlight styles for line numbers."""
+        background_style = self._get_base_style()
+        if background_style.transparent_background:
+            return Style.null(), Style(dim=True), Style.null()
+        if console.color_system in ("256", "truecolor"):
+            number_style = Style.chain(
+                background_style,
+                self._theme.get_style_for_token(Token.Text),
+                Style(color=self._get_line_numbers_color()),
+                self.background_style,
+            )
+            highlight_number_style = Style.chain(
+                background_style,
+                self._theme.get_style_for_token(Token.Text),
+                Style(bold=True, color=self._get_line_numbers_color(0.9)),
+                self.background_style,
+            )
+        else:
+            number_style = background_style + Style(dim=True)
+            highlight_number_style = background_style + Style(dim=False)
+        return background_style, number_style, highlight_number_style
+
+    def __rich_measure__(
+        self, console: "Console", options: "ConsoleOptions"
+    ) -> "Measurement":
+        _, right, _, left = Padding.unpack(self.padding)
+        padding = left + right
+        if self.code_width is not None:
+            width = self.code_width + self._numbers_column_width + padding + 1
+            return Measurement(self._numbers_column_width, width)
+        lines = self.code.splitlines()
+        width = (
+            self._numbers_column_width
+            + padding
+            + (max(cell_len(line) for line in lines) if lines else 0)
+        )
+        if self.line_numbers:
+            width += 1
+        return Measurement(self._numbers_column_width, width)
+
+    def __rich_console__(
+        self, console: Console, options: ConsoleOptions
+    ) -> RenderResult:
+        segments = Segments(self._get_syntax(console, options))
+        if self.padding:
+            yield Padding(segments, style=self._get_base_style(), pad=self.padding)
+        else:
+            yield segments
+
+    def _get_syntax(
+        self,
+        console: Console,
+        options: ConsoleOptions,
+    ) -> Iterable[Segment]:
+        """
+        Get the Segments for the Syntax object, excluding any vertical/horizontal padding
+        """
+        transparent_background = self._get_base_style().transparent_background
+        code_width = (
+            (
+                (options.max_width - self._numbers_column_width - 1)
+                if self.line_numbers
+                else options.max_width
+            )
+            if self.code_width is None
+            else self.code_width
+        )
+
+        ends_on_nl, processed_code = self._process_code(self.code)
+        text = self.highlight(processed_code, self.line_range)
+
+        if not self.line_numbers and not self.word_wrap and not self.line_range:
+            if not ends_on_nl:
+                text.remove_suffix("\n")
+            # Simple case of just rendering text
+            style = (
+                self._get_base_style()
+                + self._theme.get_style_for_token(Comment)
+                + Style(dim=True)
+                + self.background_style
+            )
+            if self.indent_guides and not options.ascii_only:
+                text = text.with_indent_guides(self.tab_size, style=style)
+                text.overflow = "crop"
+            if style.transparent_background:
+                yield from console.render(
+                    text, options=options.update(width=code_width)
+                )
+            else:
+                syntax_lines = console.render_lines(
+                    text,
+                    options.update(width=code_width, height=None, justify="left"),
+                    style=self.background_style,
+                    pad=True,
+                    new_lines=True,
+                )
+                for syntax_line in syntax_lines:
+                    yield from syntax_line
+            return
+
+        start_line, end_line = self.line_range or (None, None)
+        line_offset = 0
+        if start_line:
+            line_offset = max(0, start_line - 1)
+        lines: Union[List[Text], Lines] = text.split("\n", allow_blank=ends_on_nl)
+        if self.line_range:
+            if line_offset > len(lines):
+                return
+            lines = lines[line_offset:end_line]
+
+        if self.indent_guides and not options.ascii_only:
+            style = (
+                self._get_base_style()
+                + self._theme.get_style_for_token(Comment)
+                + Style(dim=True)
+                + self.background_style
+            )
+            lines = (
+                Text("\n")
+                .join(lines)
+                .with_indent_guides(self.tab_size, style=style + Style(italic=False))
+                .split("\n", allow_blank=True)
+            )
+
+        numbers_column_width = self._numbers_column_width
+        render_options = options.update(width=code_width)
+
+        highlight_line = self.highlight_lines.__contains__
+        _Segment = Segment
+        new_line = _Segment("\n")
+
+        line_pointer = "> " if options.legacy_windows else "❱ "
+
+        (
+            background_style,
+            number_style,
+            highlight_number_style,
+        ) = self._get_number_styles(console)
+
+        for line_no, line in enumerate(lines, self.start_line + line_offset):
+            if self.word_wrap:
+                wrapped_lines = console.render_lines(
+                    line,
+                    render_options.update(height=None, justify="left"),
+                    style=background_style,
+                    pad=not transparent_background,
+                )
+            else:
+                segments = list(line.render(console, end=""))
+                if options.no_wrap:
+                    wrapped_lines = [segments]
+                else:
+                    wrapped_lines = [
+                        _Segment.adjust_line_length(
+                            segments,
+                            render_options.max_width,
+                            style=background_style,
+                            pad=not transparent_background,
+                        )
+                    ]
+
+            if self.line_numbers:
+                wrapped_line_left_pad = _Segment(
+                    " " * numbers_column_width + " ", background_style
+                )
+                for first, wrapped_line in loop_first(wrapped_lines):
+                    if first:
+                        line_column = str(line_no).rjust(numbers_column_width - 2) + " "
+                        if highlight_line(line_no):
+                            yield _Segment(line_pointer, Style(color="red"))
+                            yield _Segment(line_column, highlight_number_style)
+                        else:
+                            yield _Segment("  ", highlight_number_style)
+                            yield _Segment(line_column, number_style)
+                    else:
+                        yield wrapped_line_left_pad
+                    yield from wrapped_line
+                    yield new_line
+            else:
+                for wrapped_line in wrapped_lines:
+                    yield from wrapped_line
+                    yield new_line
+
+    def _apply_stylized_ranges(self, text: Text) -> None:
+        """
+        Apply stylized ranges to a text instance,
+        using the given code to determine the right portion to apply the style to.
+
+        Args:
+            text (Text): Text instance to apply the style to.
+        """
+        code = text.plain
+        newlines_offsets = [
+            # Let's add outer boundaries at each side of the list:
+            0,
+            # N.B. using "\n" here is much faster than using metacharacters such as "^" or "\Z":
+            *[
+                match.start() + 1
+                for match in re.finditer("\n", code, flags=re.MULTILINE)
+            ],
+            len(code) + 1,
+        ]
+
+        for stylized_range in self._stylized_ranges:
+            start = _get_code_index_for_syntax_position(
+                newlines_offsets, stylized_range.start
+            )
+            end = _get_code_index_for_syntax_position(
+                newlines_offsets, stylized_range.end
+            )
+            if start is not None and end is not None:
+                if stylized_range.style_before:
+                    text.stylize_before(stylized_range.style, start, end)
+                else:
+                    text.stylize(stylized_range.style, start, end)
+
+    def _process_code(self, code: str) -> Tuple[bool, str]:
+        """
+        Applies various processing to a raw code string
+        (normalises it so it always ends with a line return, dedents it if necessary, etc.)
+
+        Args:
+            code (str): The raw code string to process
+
+        Returns:
+            Tuple[bool, str]: the boolean indicates whether the raw code ends with a line return,
+                while the string is the processed code.
+        """
+        ends_on_nl = code.endswith("\n")
+        processed_code = code if ends_on_nl else code + "\n"
+        processed_code = (
+            textwrap.dedent(processed_code) if self.dedent else processed_code
+        )
+        processed_code = processed_code.expandtabs(self.tab_size)
+        return ends_on_nl, processed_code
+
+
+def _get_code_index_for_syntax_position(
+    newlines_offsets: Sequence[int], position: SyntaxPosition
+) -> Optional[int]:
+    """
+    Returns the index of the code string for the given positions.
+
+    Args:
+        newlines_offsets (Sequence[int]): The offset of each newline character found in the code snippet.
+        position (SyntaxPosition): The position to search for.
+
+    Returns:
+        Optional[int]: The index of the code string for this position, or `None`
+            if the given position's line number is out of range (if it's the column that is out of range
+            we silently clamp its value so that it reaches the end of the line)
+    """
+    lines_count = len(newlines_offsets)
+
+    line_number, column_index = position
+    if line_number > lines_count or len(newlines_offsets) < (line_number + 1):
+        return None  # `line_number` is out of range
+    line_index = line_number - 1
+    line_length = newlines_offsets[line_index + 1] - newlines_offsets[line_index] - 1
+    # If `column_index` is out of range: let's silently clamp it:
+    column_index = min(line_length, column_index)
+    return newlines_offsets[line_index] + column_index
+
+
+if __name__ == "__main__":  # pragma: no cover
+    import argparse
+    import sys
+
+    parser = argparse.ArgumentParser(
+        description="Render syntax to the console with Rich"
+    )
+    parser.add_argument(
+        "path",
+        metavar="PATH",
+        help="path to file, or - for stdin",
+    )
+    parser.add_argument(
+        "-c",
+        "--force-color",
+        dest="force_color",
+        action="store_true",
+        default=None,
+        help="force color for non-terminals",
+    )
+    parser.add_argument(
+        "-i",
+        "--indent-guides",
+        dest="indent_guides",
+        action="store_true",
+        default=False,
+        help="display indent guides",
+    )
+    parser.add_argument(
+        "-l",
+        "--line-numbers",
+        dest="line_numbers",
+        action="store_true",
+        help="render line numbers",
+    )
+    parser.add_argument(
+        "-w",
+        "--width",
+        type=int,
+        dest="width",
+        default=None,
+        help="width of output (default will auto-detect)",
+    )
+    parser.add_argument(
+        "-r",
+        "--wrap",
+        dest="word_wrap",
+        action="store_true",
+        default=False,
+        help="word wrap long lines",
+    )
+    parser.add_argument(
+        "-s",
+        "--soft-wrap",
+        action="store_true",
+        dest="soft_wrap",
+        default=False,
+        help="enable soft wrapping mode",
+    )
+    parser.add_argument(
+        "-t", "--theme", dest="theme", default="monokai", help="pygments theme"
+    )
+    parser.add_argument(
+        "-b",
+        "--background-color",
+        dest="background_color",
+        default=None,
+        help="Override background color",
+    )
+    parser.add_argument(
+        "-x",
+        "--lexer",
+        default=None,
+        dest="lexer_name",
+        help="Lexer name",
+    )
+    parser.add_argument(
+        "-p", "--padding", type=int, default=0, dest="padding", help="Padding"
+    )
+    parser.add_argument(
+        "--highlight-line",
+        type=int,
+        default=None,
+        dest="highlight_line",
+        help="The line number (not index!) to highlight",
+    )
+    args = parser.parse_args()
+
+    from pip._vendor.rich.console import Console
+
+    console = Console(force_terminal=args.force_color, width=args.width)
+
+    if args.path == "-":
+        code = sys.stdin.read()
+        syntax = Syntax(
+            code=code,
+            lexer=args.lexer_name,
+            line_numbers=args.line_numbers,
+            word_wrap=args.word_wrap,
+            theme=args.theme,
+            background_color=args.background_color,
+            indent_guides=args.indent_guides,
+            padding=args.padding,
+            highlight_lines={args.highlight_line},
+        )
+    else:
+        syntax = Syntax.from_path(
+            args.path,
+            lexer=args.lexer_name,
+            line_numbers=args.line_numbers,
+            word_wrap=args.word_wrap,
+            theme=args.theme,
+            background_color=args.background_color,
+            indent_guides=args.indent_guides,
+            padding=args.padding,
+            highlight_lines={args.highlight_line},
+        )
+    console.print(syntax, soft_wrap=args.soft_wrap)
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/table.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/table.py
new file mode 100644
index 0000000..654c855
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/table.py
@@ -0,0 +1,1007 @@
+from dataclasses import dataclass, field, replace
+from typing import (
+    TYPE_CHECKING,
+    Dict,
+    Iterable,
+    List,
+    NamedTuple,
+    Optional,
+    Sequence,
+    Tuple,
+    Union,
+)
+
+from . import box, errors
+from ._loop import loop_first_last, loop_last
+from ._pick import pick_bool
+from ._ratio import ratio_distribute, ratio_reduce
+from .align import VerticalAlignMethod
+from .jupyter import JupyterMixin
+from .measure import Measurement
+from .padding import Padding, PaddingDimensions
+from .protocol import is_renderable
+from .segment import Segment
+from .style import Style, StyleType
+from .text import Text, TextType
+
+if TYPE_CHECKING:
+    from .console import (
+        Console,
+        ConsoleOptions,
+        JustifyMethod,
+        OverflowMethod,
+        RenderableType,
+        RenderResult,
+    )
+
+
+@dataclass
+class Column:
+    """Defines a column within a ~Table.
+
+    Args:
+        title (Union[str, Text], optional): The title of the table rendered at the top. Defaults to None.
+        caption (Union[str, Text], optional): The table caption rendered below. Defaults to None.
+        width (int, optional): The width in characters of the table, or ``None`` to automatically fit. Defaults to None.
+        min_width (Optional[int], optional): The minimum width of the table, or ``None`` for no minimum. Defaults to None.
+        box (box.Box, optional): One of the constants in box.py used to draw the edges (see :ref:`appendix_box`), or ``None`` for no box lines. Defaults to box.HEAVY_HEAD.
+        safe_box (Optional[bool], optional): Disable box characters that don't display on windows legacy terminal with *raster* fonts. Defaults to True.
+        padding (PaddingDimensions, optional): Padding for cells (top, right, bottom, left). Defaults to (0, 1).
+        collapse_padding (bool, optional): Enable collapsing of padding around cells. Defaults to False.
+        pad_edge (bool, optional): Enable padding of edge cells. Defaults to True.
+        expand (bool, optional): Expand the table to fit the available space if ``True``, otherwise the table width will be auto-calculated. Defaults to False.
+        show_header (bool, optional): Show a header row. Defaults to True.
+        show_footer (bool, optional): Show a footer row. Defaults to False.
+        show_edge (bool, optional): Draw a box around the outside of the table. Defaults to True.
+        show_lines (bool, optional): Draw lines between every row. Defaults to False.
+        leading (int, optional): Number of blank lines between rows (precludes ``show_lines``). Defaults to 0.
+        style (Union[str, Style], optional): Default style for the table. Defaults to "none".
+        row_styles (List[Union, str], optional): Optional list of row styles, if more than one style is given then the styles will alternate. Defaults to None.
+        header_style (Union[str, Style], optional): Style of the header. Defaults to "table.header".
+        footer_style (Union[str, Style], optional): Style of the footer. Defaults to "table.footer".
+        border_style (Union[str, Style], optional): Style of the border. Defaults to None.
+        title_style (Union[str, Style], optional): Style of the title. Defaults to None.
+        caption_style (Union[str, Style], optional): Style of the caption. Defaults to None.
+        title_justify (str, optional): Justify method for title. Defaults to "center".
+        caption_justify (str, optional): Justify method for caption. Defaults to "center".
+        highlight (bool, optional): Highlight cell contents (if str). Defaults to False.
+    """
+
+    header: "RenderableType" = ""
+    """RenderableType: Renderable for the header (typically a string)"""
+
+    footer: "RenderableType" = ""
+    """RenderableType: Renderable for the footer (typically a string)"""
+
+    header_style: StyleType = ""
+    """StyleType: The style of the header."""
+
+    footer_style: StyleType = ""
+    """StyleType: The style of the footer."""
+
+    style: StyleType = ""
+    """StyleType: The style of the column."""
+
+    justify: "JustifyMethod" = "left"
+    """str: How to justify text within the column ("left", "center", "right", or "full")"""
+
+    vertical: "VerticalAlignMethod" = "top"
+    """str: How to vertically align content ("top", "middle", or "bottom")"""
+
+    overflow: "OverflowMethod" = "ellipsis"
+    """str: Overflow method."""
+
+    width: Optional[int] = None
+    """Optional[int]: Width of the column, or ``None`` (default) to auto calculate width."""
+
+    min_width: Optional[int] = None
+    """Optional[int]: Minimum width of column, or ``None`` for no minimum. Defaults to None."""
+
+    max_width: Optional[int] = None
+    """Optional[int]: Maximum width of column, or ``None`` for no maximum. Defaults to None."""
+
+    ratio: Optional[int] = None
+    """Optional[int]: Ratio to use when calculating column width, or ``None`` (default) to adapt to column contents."""
+
+    no_wrap: bool = False
+    """bool: Prevent wrapping of text within the column. Defaults to ``False``."""
+
+    highlight: bool = False
+    """bool: Apply highlighter to column. Defaults to ``False``."""
+
+    _index: int = 0
+    """Index of column."""
+
+    _cells: List["RenderableType"] = field(default_factory=list)
+
+    def copy(self) -> "Column":
+        """Return a copy of this Column."""
+        return replace(self, _cells=[])
+
+    @property
+    def cells(self) -> Iterable["RenderableType"]:
+        """Get all cells in the column, not including header."""
+        yield from self._cells
+
+    @property
+    def flexible(self) -> bool:
+        """Check if this column is flexible."""
+        return self.ratio is not None
+
+
+@dataclass
+class Row:
+    """Information regarding a row."""
+
+    style: Optional[StyleType] = None
+    """Style to apply to row."""
+
+    end_section: bool = False
+    """Indicated end of section, which will force a line beneath the row."""
+
+
+class _Cell(NamedTuple):
+    """A single cell in a table."""
+
+    style: StyleType
+    """Style to apply to cell."""
+    renderable: "RenderableType"
+    """Cell renderable."""
+    vertical: VerticalAlignMethod
+    """Cell vertical alignment."""
+
+
+class Table(JupyterMixin):
+    """A console renderable to draw a table.
+
+    Args:
+        *headers (Union[Column, str]): Column headers, either as a string, or :class:`~rich.table.Column` instance.
+        title (Union[str, Text], optional): The title of the table rendered at the top. Defaults to None.
+        caption (Union[str, Text], optional): The table caption rendered below. Defaults to None.
+        width (int, optional): The width in characters of the table, or ``None`` to automatically fit. Defaults to None.
+        min_width (Optional[int], optional): The minimum width of the table, or ``None`` for no minimum. Defaults to None.
+        box (box.Box, optional): One of the constants in box.py used to draw the edges (see :ref:`appendix_box`), or ``None`` for no box lines. Defaults to box.HEAVY_HEAD.
+        safe_box (Optional[bool], optional): Disable box characters that don't display on windows legacy terminal with *raster* fonts. Defaults to True.
+        padding (PaddingDimensions, optional): Padding for cells (top, right, bottom, left). Defaults to (0, 1).
+        collapse_padding (bool, optional): Enable collapsing of padding around cells. Defaults to False.
+        pad_edge (bool, optional): Enable padding of edge cells. Defaults to True.
+        expand (bool, optional): Expand the table to fit the available space if ``True``, otherwise the table width will be auto-calculated. Defaults to False.
+        show_header (bool, optional): Show a header row. Defaults to True.
+        show_footer (bool, optional): Show a footer row. Defaults to False.
+        show_edge (bool, optional): Draw a box around the outside of the table. Defaults to True.
+        show_lines (bool, optional): Draw lines between every row. Defaults to False.
+        leading (int, optional): Number of blank lines between rows (precludes ``show_lines``). Defaults to 0.
+        style (Union[str, Style], optional): Default style for the table. Defaults to "none".
+        row_styles (List[Union, str], optional): Optional list of row styles, if more than one style is given then the styles will alternate. Defaults to None.
+        header_style (Union[str, Style], optional): Style of the header. Defaults to "table.header".
+        footer_style (Union[str, Style], optional): Style of the footer. Defaults to "table.footer".
+        border_style (Union[str, Style], optional): Style of the border. Defaults to None.
+        title_style (Union[str, Style], optional): Style of the title. Defaults to None.
+        caption_style (Union[str, Style], optional): Style of the caption. Defaults to None.
+        title_justify (str, optional): Justify method for title. Defaults to "center".
+        caption_justify (str, optional): Justify method for caption. Defaults to "center".
+        highlight (bool, optional): Highlight cell contents (if str). Defaults to False.
+    """
+
+    columns: List[Column]
+    rows: List[Row]
+
+    def __init__(
+        self,
+        *headers: Union[Column, str],
+        title: Optional[TextType] = None,
+        caption: Optional[TextType] = None,
+        width: Optional[int] = None,
+        min_width: Optional[int] = None,
+        box: Optional[box.Box] = box.HEAVY_HEAD,
+        safe_box: Optional[bool] = None,
+        padding: PaddingDimensions = (0, 1),
+        collapse_padding: bool = False,
+        pad_edge: bool = True,
+        expand: bool = False,
+        show_header: bool = True,
+        show_footer: bool = False,
+        show_edge: bool = True,
+        show_lines: bool = False,
+        leading: int = 0,
+        style: StyleType = "none",
+        row_styles: Optional[Iterable[StyleType]] = None,
+        header_style: Optional[StyleType] = "table.header",
+        footer_style: Optional[StyleType] = "table.footer",
+        border_style: Optional[StyleType] = None,
+        title_style: Optional[StyleType] = None,
+        caption_style: Optional[StyleType] = None,
+        title_justify: "JustifyMethod" = "center",
+        caption_justify: "JustifyMethod" = "center",
+        highlight: bool = False,
+    ) -> None:
+        self.columns: List[Column] = []
+        self.rows: List[Row] = []
+        self.title = title
+        self.caption = caption
+        self.width = width
+        self.min_width = min_width
+        self.box = box
+        self.safe_box = safe_box
+        self._padding = Padding.unpack(padding)
+        self.pad_edge = pad_edge
+        self._expand = expand
+        self.show_header = show_header
+        self.show_footer = show_footer
+        self.show_edge = show_edge
+        self.show_lines = show_lines
+        self.leading = leading
+        self.collapse_padding = collapse_padding
+        self.style = style
+        self.header_style = header_style or ""
+        self.footer_style = footer_style or ""
+        self.border_style = border_style
+        self.title_style = title_style
+        self.caption_style = caption_style
+        self.title_justify: "JustifyMethod" = title_justify
+        self.caption_justify: "JustifyMethod" = caption_justify
+        self.highlight = highlight
+        self.row_styles: Sequence[StyleType] = list(row_styles or [])
+        append_column = self.columns.append
+        for header in headers:
+            if isinstance(header, str):
+                self.add_column(header=header)
+            else:
+                header._index = len(self.columns)
+                append_column(header)
+
+    @classmethod
+    def grid(
+        cls,
+        *headers: Union[Column, str],
+        padding: PaddingDimensions = 0,
+        collapse_padding: bool = True,
+        pad_edge: bool = False,
+        expand: bool = False,
+    ) -> "Table":
+        """Get a table with no lines, headers, or footer.
+
+        Args:
+            *headers (Union[Column, str]): Column headers, either as a string, or :class:`~rich.table.Column` instance.
+            padding (PaddingDimensions, optional): Get padding around cells. Defaults to 0.
+            collapse_padding (bool, optional): Enable collapsing of padding around cells. Defaults to True.
+            pad_edge (bool, optional): Enable padding around edges of table. Defaults to False.
+            expand (bool, optional): Expand the table to fit the available space if ``True``, otherwise the table width will be auto-calculated. Defaults to False.
+
+        Returns:
+            Table: A table instance.
+        """
+        return cls(
+            *headers,
+            box=None,
+            padding=padding,
+            collapse_padding=collapse_padding,
+            show_header=False,
+            show_footer=False,
+            show_edge=False,
+            pad_edge=pad_edge,
+            expand=expand,
+        )
+
+    @property
+    def expand(self) -> bool:
+        """Setting a non-None self.width implies expand."""
+        return self._expand or self.width is not None
+
+    @expand.setter
+    def expand(self, expand: bool) -> None:
+        """Set expand."""
+        self._expand = expand
+
+    @property
+    def _extra_width(self) -> int:
+        """Get extra width to add to cell content."""
+        width = 0
+        if self.box and self.show_edge:
+            width += 2
+        if self.box:
+            width += len(self.columns) - 1
+        return width
+
+    @property
+    def row_count(self) -> int:
+        """Get the current number of rows."""
+        return len(self.rows)
+
+    def get_row_style(self, console: "Console", index: int) -> StyleType:
+        """Get the current row style."""
+        style = Style.null()
+        if self.row_styles:
+            style += console.get_style(self.row_styles[index % len(self.row_styles)])
+        row_style = self.rows[index].style
+        if row_style is not None:
+            style += console.get_style(row_style)
+        return style
+
+    def __rich_measure__(
+        self, console: "Console", options: "ConsoleOptions"
+    ) -> Measurement:
+        max_width = options.max_width
+        if self.width is not None:
+            max_width = self.width
+        if max_width < 0:
+            return Measurement(0, 0)
+
+        extra_width = self._extra_width
+        max_width = sum(
+            self._calculate_column_widths(
+                console, options.update_width(max_width - extra_width)
+            )
+        )
+        _measure_column = self._measure_column
+
+        measurements = [
+            _measure_column(console, options.update_width(max_width), column)
+            for column in self.columns
+        ]
+        minimum_width = (
+            sum(measurement.minimum for measurement in measurements) + extra_width
+        )
+        maximum_width = (
+            sum(measurement.maximum for measurement in measurements) + extra_width
+            if (self.width is None)
+            else self.width
+        )
+        measurement = Measurement(minimum_width, maximum_width)
+        measurement = measurement.clamp(self.min_width)
+        return measurement
+
+    @property
+    def padding(self) -> Tuple[int, int, int, int]:
+        """Get cell padding."""
+        return self._padding
+
+    @padding.setter
+    def padding(self, padding: PaddingDimensions) -> "Table":
+        """Set cell padding."""
+        self._padding = Padding.unpack(padding)
+        return self
+
+    def add_column(
+        self,
+        header: "RenderableType" = "",
+        footer: "RenderableType" = "",
+        *,
+        header_style: Optional[StyleType] = None,
+        highlight: Optional[bool] = None,
+        footer_style: Optional[StyleType] = None,
+        style: Optional[StyleType] = None,
+        justify: "JustifyMethod" = "left",
+        vertical: "VerticalAlignMethod" = "top",
+        overflow: "OverflowMethod" = "ellipsis",
+        width: Optional[int] = None,
+        min_width: Optional[int] = None,
+        max_width: Optional[int] = None,
+        ratio: Optional[int] = None,
+        no_wrap: bool = False,
+    ) -> None:
+        """Add a column to the table.
+
+        Args:
+            header (RenderableType, optional): Text or renderable for the header.
+                Defaults to "".
+            footer (RenderableType, optional): Text or renderable for the footer.
+                Defaults to "".
+            header_style (Union[str, Style], optional): Style for the header, or None for default. Defaults to None.
+            highlight (bool, optional): Whether to highlight the text. The default of None uses the value of the table (self) object.
+            footer_style (Union[str, Style], optional): Style for the footer, or None for default. Defaults to None.
+            style (Union[str, Style], optional): Style for the column cells, or None for default. Defaults to None.
+            justify (JustifyMethod, optional): Alignment for cells. Defaults to "left".
+            vertical (VerticalAlignMethod, optional): Vertical alignment, one of "top", "middle", or "bottom". Defaults to "top".
+            overflow (OverflowMethod): Overflow method: "crop", "fold", "ellipsis". Defaults to "ellipsis".
+            width (int, optional): Desired width of column in characters, or None to fit to contents. Defaults to None.
+            min_width (Optional[int], optional): Minimum width of column, or ``None`` for no minimum. Defaults to None.
+            max_width (Optional[int], optional): Maximum width of column, or ``None`` for no maximum. Defaults to None.
+            ratio (int, optional): Flexible ratio for the column (requires ``Table.expand`` or ``Table.width``). Defaults to None.
+            no_wrap (bool, optional): Set to ``True`` to disable wrapping of this column.
+        """
+
+        column = Column(
+            _index=len(self.columns),
+            header=header,
+            footer=footer,
+            header_style=header_style or "",
+            highlight=highlight if highlight is not None else self.highlight,
+            footer_style=footer_style or "",
+            style=style or "",
+            justify=justify,
+            vertical=vertical,
+            overflow=overflow,
+            width=width,
+            min_width=min_width,
+            max_width=max_width,
+            ratio=ratio,
+            no_wrap=no_wrap,
+        )
+        self.columns.append(column)
+
+    def add_row(
+        self,
+        *renderables: Optional["RenderableType"],
+        style: Optional[StyleType] = None,
+        end_section: bool = False,
+    ) -> None:
+        """Add a row of renderables.
+
+        Args:
+            *renderables (None or renderable): Each cell in a row must be a renderable object (including str),
+                or ``None`` for a blank cell.
+            style (StyleType, optional): An optional style to apply to the entire row. Defaults to None.
+            end_section (bool, optional): End a section and draw a line. Defaults to False.
+
+        Raises:
+            errors.NotRenderableError: If you add something that can't be rendered.
+        """
+
+        def add_cell(column: Column, renderable: "RenderableType") -> None:
+            column._cells.append(renderable)
+
+        cell_renderables: List[Optional["RenderableType"]] = list(renderables)
+
+        columns = self.columns
+        if len(cell_renderables) < len(columns):
+            cell_renderables = [
+                *cell_renderables,
+                *[None] * (len(columns) - len(cell_renderables)),
+            ]
+        for index, renderable in enumerate(cell_renderables):
+            if index == len(columns):
+                column = Column(_index=index, highlight=self.highlight)
+                for _ in self.rows:
+                    add_cell(column, Text(""))
+                self.columns.append(column)
+            else:
+                column = columns[index]
+            if renderable is None:
+                add_cell(column, "")
+            elif is_renderable(renderable):
+                add_cell(column, renderable)
+            else:
+                raise errors.NotRenderableError(
+                    f"unable to render {type(renderable).__name__}; a string or other renderable object is required"
+                )
+        self.rows.append(Row(style=style, end_section=end_section))
+
+    def add_section(self) -> None:
+        """Add a new section (draw a line after current row)."""
+
+        if self.rows:
+            self.rows[-1].end_section = True
+
+    def __rich_console__(
+        self, console: "Console", options: "ConsoleOptions"
+    ) -> "RenderResult":
+        if not self.columns:
+            yield Segment("\n")
+            return
+
+        max_width = options.max_width
+        if self.width is not None:
+            max_width = self.width
+
+        extra_width = self._extra_width
+        widths = self._calculate_column_widths(
+            console, options.update_width(max_width - extra_width)
+        )
+        table_width = sum(widths) + extra_width
+
+        render_options = options.update(
+            width=table_width, highlight=self.highlight, height=None
+        )
+
+        def render_annotation(
+            text: TextType, style: StyleType, justify: "JustifyMethod" = "center"
+        ) -> "RenderResult":
+            render_text = (
+                console.render_str(text, style=style, highlight=False)
+                if isinstance(text, str)
+                else text
+            )
+            return console.render(
+                render_text, options=render_options.update(justify=justify)
+            )
+
+        if self.title:
+            yield from render_annotation(
+                self.title,
+                style=Style.pick_first(self.title_style, "table.title"),
+                justify=self.title_justify,
+            )
+        yield from self._render(console, render_options, widths)
+        if self.caption:
+            yield from render_annotation(
+                self.caption,
+                style=Style.pick_first(self.caption_style, "table.caption"),
+                justify=self.caption_justify,
+            )
+
+    def _calculate_column_widths(
+        self, console: "Console", options: "ConsoleOptions"
+    ) -> List[int]:
+        """Calculate the widths of each column, including padding, not including borders."""
+        max_width = options.max_width
+        columns = self.columns
+        width_ranges = [
+            self._measure_column(console, options, column) for column in columns
+        ]
+        widths = [_range.maximum or 1 for _range in width_ranges]
+        get_padding_width = self._get_padding_width
+        extra_width = self._extra_width
+        if self.expand:
+            ratios = [col.ratio or 0 for col in columns if col.flexible]
+            if any(ratios):
+                fixed_widths = [
+                    0 if column.flexible else _range.maximum
+                    for _range, column in zip(width_ranges, columns)
+                ]
+                flex_minimum = [
+                    (column.width or 1) + get_padding_width(column._index)
+                    for column in columns
+                    if column.flexible
+                ]
+                flexible_width = max_width - sum(fixed_widths)
+                flex_widths = ratio_distribute(flexible_width, ratios, flex_minimum)
+                iter_flex_widths = iter(flex_widths)
+                for index, column in enumerate(columns):
+                    if column.flexible:
+                        widths[index] = fixed_widths[index] + next(iter_flex_widths)
+        table_width = sum(widths)
+
+        if table_width > max_width:
+            widths = self._collapse_widths(
+                widths,
+                [(column.width is None and not column.no_wrap) for column in columns],
+                max_width,
+            )
+            table_width = sum(widths)
+            # last resort, reduce columns evenly
+            if table_width > max_width:
+                excess_width = table_width - max_width
+                widths = ratio_reduce(excess_width, [1] * len(widths), widths, widths)
+                table_width = sum(widths)
+
+            width_ranges = [
+                self._measure_column(console, options.update_width(width), column)
+                for width, column in zip(widths, columns)
+            ]
+            widths = [_range.maximum or 0 for _range in width_ranges]
+
+        if (table_width < max_width and self.expand) or (
+            self.min_width is not None and table_width < (self.min_width - extra_width)
+        ):
+            _max_width = (
+                max_width
+                if self.min_width is None
+                else min(self.min_width - extra_width, max_width)
+            )
+            pad_widths = ratio_distribute(_max_width - table_width, widths)
+            widths = [_width + pad for _width, pad in zip(widths, pad_widths)]
+
+        return widths
+
+    @classmethod
+    def _collapse_widths(
+        cls, widths: List[int], wrapable: List[bool], max_width: int
+    ) -> List[int]:
+        """Reduce widths so that the total is under max_width.
+
+        Args:
+            widths (List[int]): List of widths.
+            wrapable (List[bool]): List of booleans that indicate if a column may shrink.
+            max_width (int): Maximum width to reduce to.
+
+        Returns:
+            List[int]: A new list of widths.
+        """
+        total_width = sum(widths)
+        excess_width = total_width - max_width
+        if any(wrapable):
+            while total_width and excess_width > 0:
+                max_column = max(
+                    width for width, allow_wrap in zip(widths, wrapable) if allow_wrap
+                )
+                second_max_column = max(
+                    width if allow_wrap and width != max_column else 0
+                    for width, allow_wrap in zip(widths, wrapable)
+                )
+                column_difference = max_column - second_max_column
+                ratios = [
+                    (1 if (width == max_column and allow_wrap) else 0)
+                    for width, allow_wrap in zip(widths, wrapable)
+                ]
+                if not any(ratios) or not column_difference:
+                    break
+                max_reduce = [min(excess_width, column_difference)] * len(widths)
+                widths = ratio_reduce(excess_width, ratios, max_reduce, widths)
+
+                total_width = sum(widths)
+                excess_width = total_width - max_width
+        return widths
+
+    def _get_cells(
+        self, console: "Console", column_index: int, column: Column
+    ) -> Iterable[_Cell]:
+        """Get all the cells with padding and optional header."""
+
+        collapse_padding = self.collapse_padding
+        pad_edge = self.pad_edge
+        padding = self.padding
+        any_padding = any(padding)
+
+        first_column = column_index == 0
+        last_column = column_index == len(self.columns) - 1
+
+        _padding_cache: Dict[Tuple[bool, bool], Tuple[int, int, int, int]] = {}
+
+        def get_padding(first_row: bool, last_row: bool) -> Tuple[int, int, int, int]:
+            cached = _padding_cache.get((first_row, last_row))
+            if cached:
+                return cached
+            top, right, bottom, left = padding
+
+            if collapse_padding:
+                if not first_column:
+                    left = max(0, left - right)
+                if not last_row:
+                    bottom = max(0, top - bottom)
+
+            if not pad_edge:
+                if first_column:
+                    left = 0
+                if last_column:
+                    right = 0
+                if first_row:
+                    top = 0
+                if last_row:
+                    bottom = 0
+            _padding = (top, right, bottom, left)
+            _padding_cache[(first_row, last_row)] = _padding
+            return _padding
+
+        raw_cells: List[Tuple[StyleType, "RenderableType"]] = []
+        _append = raw_cells.append
+        get_style = console.get_style
+        if self.show_header:
+            header_style = get_style(self.header_style or "") + get_style(
+                column.header_style
+            )
+            _append((header_style, column.header))
+        cell_style = get_style(column.style or "")
+        for cell in column.cells:
+            _append((cell_style, cell))
+        if self.show_footer:
+            footer_style = get_style(self.footer_style or "") + get_style(
+                column.footer_style
+            )
+            _append((footer_style, column.footer))
+
+        if any_padding:
+            _Padding = Padding
+            for first, last, (style, renderable) in loop_first_last(raw_cells):
+                yield _Cell(
+                    style,
+                    _Padding(renderable, get_padding(first, last)),
+                    getattr(renderable, "vertical", None) or column.vertical,
+                )
+        else:
+            for style, renderable in raw_cells:
+                yield _Cell(
+                    style,
+                    renderable,
+                    getattr(renderable, "vertical", None) or column.vertical,
+                )
+
+    def _get_padding_width(self, column_index: int) -> int:
+        """Get extra width from padding."""
+        _, pad_right, _, pad_left = self.padding
+        if self.collapse_padding:
+            if column_index > 0:
+                pad_left = max(0, pad_left - pad_right)
+        return pad_left + pad_right
+
+    def _measure_column(
+        self,
+        console: "Console",
+        options: "ConsoleOptions",
+        column: Column,
+    ) -> Measurement:
+        """Get the minimum and maximum width of the column."""
+
+        max_width = options.max_width
+        if max_width < 1:
+            return Measurement(0, 0)
+
+        padding_width = self._get_padding_width(column._index)
+
+        if column.width is not None:
+            # Fixed width column
+            return Measurement(
+                column.width + padding_width, column.width + padding_width
+            ).with_maximum(max_width)
+        # Flexible column, we need to measure contents
+        min_widths: List[int] = []
+        max_widths: List[int] = []
+        append_min = min_widths.append
+        append_max = max_widths.append
+        get_render_width = Measurement.get
+        for cell in self._get_cells(console, column._index, column):
+            _min, _max = get_render_width(console, options, cell.renderable)
+            append_min(_min)
+            append_max(_max)
+
+        measurement = Measurement(
+            max(min_widths) if min_widths else 1,
+            max(max_widths) if max_widths else max_width,
+        ).with_maximum(max_width)
+        measurement = measurement.clamp(
+            None if column.min_width is None else column.min_width + padding_width,
+            None if column.max_width is None else column.max_width + padding_width,
+        )
+        return measurement
+
+    def _render(
+        self, console: "Console", options: "ConsoleOptions", widths: List[int]
+    ) -> "RenderResult":
+        table_style = console.get_style(self.style or "")
+
+        border_style = table_style + console.get_style(self.border_style or "")
+        _column_cells = (
+            self._get_cells(console, column_index, column)
+            for column_index, column in enumerate(self.columns)
+        )
+        row_cells: List[Tuple[_Cell, ...]] = list(zip(*_column_cells))
+        _box = (
+            self.box.substitute(
+                options, safe=pick_bool(self.safe_box, console.safe_box)
+            )
+            if self.box
+            else None
+        )
+        _box = _box.get_plain_headed_box() if _box and not self.show_header else _box
+
+        new_line = Segment.line()
+
+        columns = self.columns
+        show_header = self.show_header
+        show_footer = self.show_footer
+        show_edge = self.show_edge
+        show_lines = self.show_lines
+        leading = self.leading
+
+        _Segment = Segment
+        if _box:
+            box_segments = [
+                (
+                    _Segment(_box.head_left, border_style),
+                    _Segment(_box.head_right, border_style),
+                    _Segment(_box.head_vertical, border_style),
+                ),
+                (
+                    _Segment(_box.mid_left, border_style),
+                    _Segment(_box.mid_right, border_style),
+                    _Segment(_box.mid_vertical, border_style),
+                ),
+                (
+                    _Segment(_box.foot_left, border_style),
+                    _Segment(_box.foot_right, border_style),
+                    _Segment(_box.foot_vertical, border_style),
+                ),
+            ]
+            if show_edge:
+                yield _Segment(_box.get_top(widths), border_style)
+                yield new_line
+        else:
+            box_segments = []
+
+        get_row_style = self.get_row_style
+        get_style = console.get_style
+
+        for index, (first, last, row_cell) in enumerate(loop_first_last(row_cells)):
+            header_row = first and show_header
+            footer_row = last and show_footer
+            row = (
+                self.rows[index - show_header]
+                if (not header_row and not footer_row)
+                else None
+            )
+            max_height = 1
+            cells: List[List[List[Segment]]] = []
+            if header_row or footer_row:
+                row_style = Style.null()
+            else:
+                row_style = get_style(
+                    get_row_style(console, index - 1 if show_header else index)
+                )
+            for width, cell, column in zip(widths, row_cell, columns):
+                render_options = options.update(
+                    width=width,
+                    justify=column.justify,
+                    no_wrap=column.no_wrap,
+                    overflow=column.overflow,
+                    height=None,
+                    highlight=column.highlight,
+                )
+                lines = console.render_lines(
+                    cell.renderable,
+                    render_options,
+                    style=get_style(cell.style) + row_style,
+                )
+                max_height = max(max_height, len(lines))
+                cells.append(lines)
+
+            row_height = max(len(cell) for cell in cells)
+
+            def align_cell(
+                cell: List[List[Segment]],
+                vertical: "VerticalAlignMethod",
+                width: int,
+                style: Style,
+            ) -> List[List[Segment]]:
+                if header_row:
+                    vertical = "bottom"
+                elif footer_row:
+                    vertical = "top"
+
+                if vertical == "top":
+                    return _Segment.align_top(cell, width, row_height, style)
+                elif vertical == "middle":
+                    return _Segment.align_middle(cell, width, row_height, style)
+                return _Segment.align_bottom(cell, width, row_height, style)
+
+            cells[:] = [
+                _Segment.set_shape(
+                    align_cell(
+                        cell,
+                        _cell.vertical,
+                        width,
+                        get_style(_cell.style) + row_style,
+                    ),
+                    width,
+                    max_height,
+                )
+                for width, _cell, cell, column in zip(widths, row_cell, cells, columns)
+            ]
+
+            if _box:
+                if last and show_footer:
+                    yield _Segment(
+                        _box.get_row(widths, "foot", edge=show_edge), border_style
+                    )
+                    yield new_line
+                left, right, _divider = box_segments[0 if first else (2 if last else 1)]
+
+                # If the column divider is whitespace also style it with the row background
+                divider = (
+                    _divider
+                    if _divider.text.strip()
+                    else _Segment(
+                        _divider.text, row_style.background_style + _divider.style
+                    )
+                )
+                for line_no in range(max_height):
+                    if show_edge:
+                        yield left
+                    for last_cell, rendered_cell in loop_last(cells):
+                        yield from rendered_cell[line_no]
+                        if not last_cell:
+                            yield divider
+                    if show_edge:
+                        yield right
+                    yield new_line
+            else:
+                for line_no in range(max_height):
+                    for rendered_cell in cells:
+                        yield from rendered_cell[line_no]
+                    yield new_line
+            if _box and first and show_header:
+                yield _Segment(
+                    _box.get_row(widths, "head", edge=show_edge), border_style
+                )
+                yield new_line
+            end_section = row and row.end_section
+            if _box and (show_lines or leading or end_section):
+                if (
+                    not last
+                    and not (show_footer and index >= len(row_cells) - 2)
+                    and not (show_header and header_row)
+                ):
+                    if leading:
+                        yield _Segment(
+                            _box.get_row(widths, "mid", edge=show_edge) * leading,
+                            border_style,
+                        )
+                    else:
+                        yield _Segment(
+                            _box.get_row(widths, "row", edge=show_edge), border_style
+                        )
+                    yield new_line
+
+        if _box and show_edge:
+            yield _Segment(_box.get_bottom(widths), border_style)
+            yield new_line
+
+
+if __name__ == "__main__":  # pragma: no cover
+    from pip._vendor.rich.console import Console
+    from pip._vendor.rich.highlighter import ReprHighlighter
+    from pip._vendor.rich.table import Table as Table
+
+    from ._timer import timer
+
+    with timer("Table render"):
+        table = Table(
+            title="Star Wars Movies",
+            caption="Rich example table",
+            caption_justify="right",
+        )
+
+        table.add_column(
+            "Released", header_style="bright_cyan", style="cyan", no_wrap=True
+        )
+        table.add_column("Title", style="magenta")
+        table.add_column("Box Office", justify="right", style="green")
+
+        table.add_row(
+            "Dec 20, 2019",
+            "Star Wars: The Rise of Skywalker",
+            "$952,110,690",
+        )
+        table.add_row("May 25, 2018", "Solo: A Star Wars Story", "$393,151,347")
+        table.add_row(
+            "Dec 15, 2017",
+            "Star Wars Ep. V111: The Last Jedi",
+            "$1,332,539,889",
+            style="on black",
+            end_section=True,
+        )
+        table.add_row(
+            "Dec 16, 2016",
+            "Rogue One: A Star Wars Story",
+            "$1,332,439,889",
+        )
+
+        def header(text: str) -> None:
+            console.print()
+            console.rule(highlight(text))
+            console.print()
+
+        console = Console()
+        highlight = ReprHighlighter()
+        header("Example Table")
+        console.print(table, justify="center")
+
+        table.expand = True
+        header("expand=True")
+        console.print(table)
+
+        table.width = 50
+        header("width=50")
+
+        console.print(table, justify="center")
+
+        table.width = None
+        table.expand = False
+        table.row_styles = ["dim", "none"]
+        header("row_styles=['dim', 'none']")
+
+        console.print(table, justify="center")
+
+        table.width = None
+        table.expand = False
+        table.row_styles = ["dim", "none"]
+        table.leading = 1
+        header("leading=1, row_styles=['dim', 'none']")
+        console.print(table, justify="center")
+
+        table.width = None
+        table.expand = False
+        table.row_styles = ["dim", "none"]
+        table.show_lines = True
+        table.leading = 0
+        header("show_lines=True, row_styles=['dim', 'none']")
+        console.print(table, justify="center")
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/terminal_theme.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/terminal_theme.py
new file mode 100644
index 0000000..565e9d9
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/terminal_theme.py
@@ -0,0 +1,153 @@
+from typing import List, Optional, Tuple
+
+from .color_triplet import ColorTriplet
+from .palette import Palette
+
+_ColorTuple = Tuple[int, int, int]
+
+
+class TerminalTheme:
+    """A color theme used when exporting console content.
+
+    Args:
+        background (Tuple[int, int, int]): The background color.
+        foreground (Tuple[int, int, int]): The foreground (text) color.
+        normal (List[Tuple[int, int, int]]): A list of 8 normal intensity colors.
+        bright (List[Tuple[int, int, int]], optional): A list of 8 bright colors, or None
+            to repeat normal intensity. Defaults to None.
+    """
+
+    def __init__(
+        self,
+        background: _ColorTuple,
+        foreground: _ColorTuple,
+        normal: List[_ColorTuple],
+        bright: Optional[List[_ColorTuple]] = None,
+    ) -> None:
+        self.background_color = ColorTriplet(*background)
+        self.foreground_color = ColorTriplet(*foreground)
+        self.ansi_colors = Palette(normal + (bright or normal))
+
+
+DEFAULT_TERMINAL_THEME = TerminalTheme(
+    (255, 255, 255),
+    (0, 0, 0),
+    [
+        (0, 0, 0),
+        (128, 0, 0),
+        (0, 128, 0),
+        (128, 128, 0),
+        (0, 0, 128),
+        (128, 0, 128),
+        (0, 128, 128),
+        (192, 192, 192),
+    ],
+    [
+        (128, 128, 128),
+        (255, 0, 0),
+        (0, 255, 0),
+        (255, 255, 0),
+        (0, 0, 255),
+        (255, 0, 255),
+        (0, 255, 255),
+        (255, 255, 255),
+    ],
+)
+
+MONOKAI = TerminalTheme(
+    (12, 12, 12),
+    (217, 217, 217),
+    [
+        (26, 26, 26),
+        (244, 0, 95),
+        (152, 224, 36),
+        (253, 151, 31),
+        (157, 101, 255),
+        (244, 0, 95),
+        (88, 209, 235),
+        (196, 197, 181),
+        (98, 94, 76),
+    ],
+    [
+        (244, 0, 95),
+        (152, 224, 36),
+        (224, 213, 97),
+        (157, 101, 255),
+        (244, 0, 95),
+        (88, 209, 235),
+        (246, 246, 239),
+    ],
+)
+DIMMED_MONOKAI = TerminalTheme(
+    (25, 25, 25),
+    (185, 188, 186),
+    [
+        (58, 61, 67),
+        (190, 63, 72),
+        (135, 154, 59),
+        (197, 166, 53),
+        (79, 118, 161),
+        (133, 92, 141),
+        (87, 143, 164),
+        (185, 188, 186),
+        (136, 137, 135),
+    ],
+    [
+        (251, 0, 31),
+        (15, 114, 47),
+        (196, 112, 51),
+        (24, 109, 227),
+        (251, 0, 103),
+        (46, 112, 109),
+        (253, 255, 185),
+    ],
+)
+NIGHT_OWLISH = TerminalTheme(
+    (255, 255, 255),
+    (64, 63, 83),
+    [
+        (1, 22, 39),
+        (211, 66, 62),
+        (42, 162, 152),
+        (218, 170, 1),
+        (72, 118, 214),
+        (64, 63, 83),
+        (8, 145, 106),
+        (122, 129, 129),
+        (122, 129, 129),
+    ],
+    [
+        (247, 110, 110),
+        (73, 208, 197),
+        (218, 194, 107),
+        (92, 167, 228),
+        (105, 112, 152),
+        (0, 201, 144),
+        (152, 159, 177),
+    ],
+)
+
+SVG_EXPORT_THEME = TerminalTheme(
+    (41, 41, 41),
+    (197, 200, 198),
+    [
+        (75, 78, 85),
+        (204, 85, 90),
+        (152, 168, 75),
+        (208, 179, 68),
+        (96, 138, 177),
+        (152, 114, 159),
+        (104, 160, 179),
+        (197, 200, 198),
+        (154, 155, 153),
+    ],
+    [
+        (255, 38, 39),
+        (0, 130, 61),
+        (208, 132, 66),
+        (25, 132, 233),
+        (255, 44, 122),
+        (57, 130, 128),
+        (253, 253, 197),
+    ],
+)
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/text.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/text.py
new file mode 100644
index 0000000..5a0c6b1
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/text.py
@@ -0,0 +1,1361 @@
+import re
+from functools import partial, reduce
+from math import gcd
+from operator import itemgetter
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    Callable,
+    Dict,
+    Iterable,
+    List,
+    NamedTuple,
+    Optional,
+    Pattern,
+    Tuple,
+    Union,
+)
+
+from ._loop import loop_last
+from ._pick import pick_bool
+from ._wrap import divide_line
+from .align import AlignMethod
+from .cells import cell_len, set_cell_size
+from .containers import Lines
+from .control import strip_control_codes
+from .emoji import EmojiVariant
+from .jupyter import JupyterMixin
+from .measure import Measurement
+from .segment import Segment
+from .style import Style, StyleType
+
+if TYPE_CHECKING:  # pragma: no cover
+    from .console import Console, ConsoleOptions, JustifyMethod, OverflowMethod
+
+DEFAULT_JUSTIFY: "JustifyMethod" = "default"
+DEFAULT_OVERFLOW: "OverflowMethod" = "fold"
+
+
+_re_whitespace = re.compile(r"\s+$")
+
+TextType = Union[str, "Text"]
+"""A plain string or a :class:`Text` instance."""
+
+GetStyleCallable = Callable[[str], Optional[StyleType]]
+
+
+class Span(NamedTuple):
+    """A marked up region in some text."""
+
+    start: int
+    """Span start index."""
+    end: int
+    """Span end index."""
+    style: Union[str, Style]
+    """Style associated with the span."""
+
+    def __repr__(self) -> str:
+        return f"Span({self.start}, {self.end}, {self.style!r})"
+
+    def __bool__(self) -> bool:
+        return self.end > self.start
+
+    def split(self, offset: int) -> Tuple["Span", Optional["Span"]]:
+        """Split a span in to 2 from a given offset."""
+
+        if offset < self.start:
+            return self, None
+        if offset >= self.end:
+            return self, None
+
+        start, end, style = self
+        span1 = Span(start, min(end, offset), style)
+        span2 = Span(span1.end, end, style)
+        return span1, span2
+
+    def move(self, offset: int) -> "Span":
+        """Move start and end by a given offset.
+
+        Args:
+            offset (int): Number of characters to add to start and end.
+
+        Returns:
+            TextSpan: A new TextSpan with adjusted position.
+        """
+        start, end, style = self
+        return Span(start + offset, end + offset, style)
+
+    def right_crop(self, offset: int) -> "Span":
+        """Crop the span at the given offset.
+
+        Args:
+            offset (int): A value between start and end.
+
+        Returns:
+            Span: A new (possibly smaller) span.
+        """
+        start, end, style = self
+        if offset >= end:
+            return self
+        return Span(start, min(offset, end), style)
+
+    def extend(self, cells: int) -> "Span":
+        """Extend the span by the given number of cells.
+
+        Args:
+            cells (int): Additional space to add to end of span.
+
+        Returns:
+            Span: A span.
+        """
+        if cells:
+            start, end, style = self
+            return Span(start, end + cells, style)
+        else:
+            return self
+
+
+class Text(JupyterMixin):
+    """Text with color / style.
+
+    Args:
+        text (str, optional): Default unstyled text. Defaults to "".
+        style (Union[str, Style], optional): Base style for text. Defaults to "".
+        justify (str, optional): Justify method: "left", "center", "full", "right". Defaults to None.
+        overflow (str, optional): Overflow method: "crop", "fold", "ellipsis". Defaults to None.
+        no_wrap (bool, optional): Disable text wrapping, or None for default. Defaults to None.
+        end (str, optional): Character to end text with. Defaults to "\\\\n".
+        tab_size (int): Number of spaces per tab, or ``None`` to use ``console.tab_size``. Defaults to None.
+        spans (List[Span], optional). A list of predefined style spans. Defaults to None.
+    """
+
+    __slots__ = [
+        "_text",
+        "style",
+        "justify",
+        "overflow",
+        "no_wrap",
+        "end",
+        "tab_size",
+        "_spans",
+        "_length",
+    ]
+
+    def __init__(
+        self,
+        text: str = "",
+        style: Union[str, Style] = "",
+        *,
+        justify: Optional["JustifyMethod"] = None,
+        overflow: Optional["OverflowMethod"] = None,
+        no_wrap: Optional[bool] = None,
+        end: str = "\n",
+        tab_size: Optional[int] = None,
+        spans: Optional[List[Span]] = None,
+    ) -> None:
+        sanitized_text = strip_control_codes(text)
+        self._text = [sanitized_text]
+        self.style = style
+        self.justify: Optional["JustifyMethod"] = justify
+        self.overflow: Optional["OverflowMethod"] = overflow
+        self.no_wrap = no_wrap
+        self.end = end
+        self.tab_size = tab_size
+        self._spans: List[Span] = spans or []
+        self._length: int = len(sanitized_text)
+
+    def __len__(self) -> int:
+        return self._length
+
+    def __bool__(self) -> bool:
+        return bool(self._length)
+
+    def __str__(self) -> str:
+        return self.plain
+
+    def __repr__(self) -> str:
+        return f""
+
+    def __add__(self, other: Any) -> "Text":
+        if isinstance(other, (str, Text)):
+            result = self.copy()
+            result.append(other)
+            return result
+        return NotImplemented
+
+    def __eq__(self, other: object) -> bool:
+        if not isinstance(other, Text):
+            return NotImplemented
+        return self.plain == other.plain and self._spans == other._spans
+
+    def __contains__(self, other: object) -> bool:
+        if isinstance(other, str):
+            return other in self.plain
+        elif isinstance(other, Text):
+            return other.plain in self.plain
+        return False
+
+    def __getitem__(self, slice: Union[int, slice]) -> "Text":
+        def get_text_at(offset: int) -> "Text":
+            _Span = Span
+            text = Text(
+                self.plain[offset],
+                spans=[
+                    _Span(0, 1, style)
+                    for start, end, style in self._spans
+                    if end > offset >= start
+                ],
+                end="",
+            )
+            return text
+
+        if isinstance(slice, int):
+            return get_text_at(slice)
+        else:
+            start, stop, step = slice.indices(len(self.plain))
+            if step == 1:
+                lines = self.divide([start, stop])
+                return lines[1]
+            else:
+                # This would be a bit of work to implement efficiently
+                # For now, its not required
+                raise TypeError("slices with step!=1 are not supported")
+
+    @property
+    def cell_len(self) -> int:
+        """Get the number of cells required to render this text."""
+        return cell_len(self.plain)
+
+    @property
+    def markup(self) -> str:
+        """Get console markup to render this Text.
+
+        Returns:
+            str: A string potentially creating markup tags.
+        """
+        from .markup import escape
+
+        output: List[str] = []
+
+        plain = self.plain
+        markup_spans = [
+            (0, False, self.style),
+            *((span.start, False, span.style) for span in self._spans),
+            *((span.end, True, span.style) for span in self._spans),
+            (len(plain), True, self.style),
+        ]
+        markup_spans.sort(key=itemgetter(0, 1))
+        position = 0
+        append = output.append
+        for offset, closing, style in markup_spans:
+            if offset > position:
+                append(escape(plain[position:offset]))
+                position = offset
+            if style:
+                append(f"[/{style}]" if closing else f"[{style}]")
+        markup = "".join(output)
+        return markup
+
+    @classmethod
+    def from_markup(
+        cls,
+        text: str,
+        *,
+        style: Union[str, Style] = "",
+        emoji: bool = True,
+        emoji_variant: Optional[EmojiVariant] = None,
+        justify: Optional["JustifyMethod"] = None,
+        overflow: Optional["OverflowMethod"] = None,
+        end: str = "\n",
+    ) -> "Text":
+        """Create Text instance from markup.
+
+        Args:
+            text (str): A string containing console markup.
+            style (Union[str, Style], optional): Base style for text. Defaults to "".
+            emoji (bool, optional): Also render emoji code. Defaults to True.
+            emoji_variant (str, optional): Optional emoji variant, either "text" or "emoji". Defaults to None.
+            justify (str, optional): Justify method: "left", "center", "full", "right". Defaults to None.
+            overflow (str, optional): Overflow method: "crop", "fold", "ellipsis". Defaults to None.
+            end (str, optional): Character to end text with. Defaults to "\\\\n".
+
+        Returns:
+            Text: A Text instance with markup rendered.
+        """
+        from .markup import render
+
+        rendered_text = render(text, style, emoji=emoji, emoji_variant=emoji_variant)
+        rendered_text.justify = justify
+        rendered_text.overflow = overflow
+        rendered_text.end = end
+        return rendered_text
+
+    @classmethod
+    def from_ansi(
+        cls,
+        text: str,
+        *,
+        style: Union[str, Style] = "",
+        justify: Optional["JustifyMethod"] = None,
+        overflow: Optional["OverflowMethod"] = None,
+        no_wrap: Optional[bool] = None,
+        end: str = "\n",
+        tab_size: Optional[int] = 8,
+    ) -> "Text":
+        """Create a Text object from a string containing ANSI escape codes.
+
+        Args:
+            text (str): A string containing escape codes.
+            style (Union[str, Style], optional): Base style for text. Defaults to "".
+            justify (str, optional): Justify method: "left", "center", "full", "right". Defaults to None.
+            overflow (str, optional): Overflow method: "crop", "fold", "ellipsis". Defaults to None.
+            no_wrap (bool, optional): Disable text wrapping, or None for default. Defaults to None.
+            end (str, optional): Character to end text with. Defaults to "\\\\n".
+            tab_size (int): Number of spaces per tab, or ``None`` to use ``console.tab_size``. Defaults to None.
+        """
+        from .ansi import AnsiDecoder
+
+        joiner = Text(
+            "\n",
+            justify=justify,
+            overflow=overflow,
+            no_wrap=no_wrap,
+            end=end,
+            tab_size=tab_size,
+            style=style,
+        )
+        decoder = AnsiDecoder()
+        result = joiner.join(line for line in decoder.decode(text))
+        return result
+
+    @classmethod
+    def styled(
+        cls,
+        text: str,
+        style: StyleType = "",
+        *,
+        justify: Optional["JustifyMethod"] = None,
+        overflow: Optional["OverflowMethod"] = None,
+    ) -> "Text":
+        """Construct a Text instance with a pre-applied styled. A style applied in this way won't be used
+        to pad the text when it is justified.
+
+        Args:
+            text (str): A string containing console markup.
+            style (Union[str, Style]): Style to apply to the text. Defaults to "".
+            justify (str, optional): Justify method: "left", "center", "full", "right". Defaults to None.
+            overflow (str, optional): Overflow method: "crop", "fold", "ellipsis". Defaults to None.
+
+        Returns:
+            Text: A text instance with a style applied to the entire string.
+        """
+        styled_text = cls(text, justify=justify, overflow=overflow)
+        styled_text.stylize(style)
+        return styled_text
+
+    @classmethod
+    def assemble(
+        cls,
+        *parts: Union[str, "Text", Tuple[str, StyleType]],
+        style: Union[str, Style] = "",
+        justify: Optional["JustifyMethod"] = None,
+        overflow: Optional["OverflowMethod"] = None,
+        no_wrap: Optional[bool] = None,
+        end: str = "\n",
+        tab_size: int = 8,
+        meta: Optional[Dict[str, Any]] = None,
+    ) -> "Text":
+        """Construct a text instance by combining a sequence of strings with optional styles.
+        The positional arguments should be either strings, or a tuple of string + style.
+
+        Args:
+            style (Union[str, Style], optional): Base style for text. Defaults to "".
+            justify (str, optional): Justify method: "left", "center", "full", "right". Defaults to None.
+            overflow (str, optional): Overflow method: "crop", "fold", "ellipsis". Defaults to None.
+            no_wrap (bool, optional): Disable text wrapping, or None for default. Defaults to None.
+            end (str, optional): Character to end text with. Defaults to "\\\\n".
+            tab_size (int): Number of spaces per tab, or ``None`` to use ``console.tab_size``. Defaults to None.
+            meta (Dict[str, Any], optional). Meta data to apply to text, or None for no meta data. Default to None
+
+        Returns:
+            Text: A new text instance.
+        """
+        text = cls(
+            style=style,
+            justify=justify,
+            overflow=overflow,
+            no_wrap=no_wrap,
+            end=end,
+            tab_size=tab_size,
+        )
+        append = text.append
+        _Text = Text
+        for part in parts:
+            if isinstance(part, (_Text, str)):
+                append(part)
+            else:
+                append(*part)
+        if meta:
+            text.apply_meta(meta)
+        return text
+
+    @property
+    def plain(self) -> str:
+        """Get the text as a single string."""
+        if len(self._text) != 1:
+            self._text[:] = ["".join(self._text)]
+        return self._text[0]
+
+    @plain.setter
+    def plain(self, new_text: str) -> None:
+        """Set the text to a new value."""
+        if new_text != self.plain:
+            sanitized_text = strip_control_codes(new_text)
+            self._text[:] = [sanitized_text]
+            old_length = self._length
+            self._length = len(sanitized_text)
+            if old_length > self._length:
+                self._trim_spans()
+
+    @property
+    def spans(self) -> List[Span]:
+        """Get a reference to the internal list of spans."""
+        return self._spans
+
+    @spans.setter
+    def spans(self, spans: List[Span]) -> None:
+        """Set spans."""
+        self._spans = spans[:]
+
+    def blank_copy(self, plain: str = "") -> "Text":
+        """Return a new Text instance with copied metadata (but not the string or spans)."""
+        copy_self = Text(
+            plain,
+            style=self.style,
+            justify=self.justify,
+            overflow=self.overflow,
+            no_wrap=self.no_wrap,
+            end=self.end,
+            tab_size=self.tab_size,
+        )
+        return copy_self
+
+    def copy(self) -> "Text":
+        """Return a copy of this instance."""
+        copy_self = Text(
+            self.plain,
+            style=self.style,
+            justify=self.justify,
+            overflow=self.overflow,
+            no_wrap=self.no_wrap,
+            end=self.end,
+            tab_size=self.tab_size,
+        )
+        copy_self._spans[:] = self._spans
+        return copy_self
+
+    def stylize(
+        self,
+        style: Union[str, Style],
+        start: int = 0,
+        end: Optional[int] = None,
+    ) -> None:
+        """Apply a style to the text, or a portion of the text.
+
+        Args:
+            style (Union[str, Style]): Style instance or style definition to apply.
+            start (int): Start offset (negative indexing is supported). Defaults to 0.
+            end (Optional[int], optional): End offset (negative indexing is supported), or None for end of text. Defaults to None.
+        """
+        if style:
+            length = len(self)
+            if start < 0:
+                start = length + start
+            if end is None:
+                end = length
+            if end < 0:
+                end = length + end
+            if start >= length or end <= start:
+                # Span not in text or not valid
+                return
+            self._spans.append(Span(start, min(length, end), style))
+
+    def stylize_before(
+        self,
+        style: Union[str, Style],
+        start: int = 0,
+        end: Optional[int] = None,
+    ) -> None:
+        """Apply a style to the text, or a portion of the text. Styles will be applied before other styles already present.
+
+        Args:
+            style (Union[str, Style]): Style instance or style definition to apply.
+            start (int): Start offset (negative indexing is supported). Defaults to 0.
+            end (Optional[int], optional): End offset (negative indexing is supported), or None for end of text. Defaults to None.
+        """
+        if style:
+            length = len(self)
+            if start < 0:
+                start = length + start
+            if end is None:
+                end = length
+            if end < 0:
+                end = length + end
+            if start >= length or end <= start:
+                # Span not in text or not valid
+                return
+            self._spans.insert(0, Span(start, min(length, end), style))
+
+    def apply_meta(
+        self, meta: Dict[str, Any], start: int = 0, end: Optional[int] = None
+    ) -> None:
+        """Apply metadata to the text, or a portion of the text.
+
+        Args:
+            meta (Dict[str, Any]): A dict of meta information.
+            start (int): Start offset (negative indexing is supported). Defaults to 0.
+            end (Optional[int], optional): End offset (negative indexing is supported), or None for end of text. Defaults to None.
+
+        """
+        style = Style.from_meta(meta)
+        self.stylize(style, start=start, end=end)
+
+    def on(self, meta: Optional[Dict[str, Any]] = None, **handlers: Any) -> "Text":
+        """Apply event handlers (used by Textual project).
+
+        Example:
+            >>> from rich.text import Text
+            >>> text = Text("hello world")
+            >>> text.on(click="view.toggle('world')")
+
+        Args:
+            meta (Dict[str, Any]): Mapping of meta information.
+            **handlers: Keyword args are prefixed with "@" to defined handlers.
+
+        Returns:
+            Text: Self is returned to method may be chained.
+        """
+        meta = {} if meta is None else meta
+        meta.update({f"@{key}": value for key, value in handlers.items()})
+        self.stylize(Style.from_meta(meta))
+        return self
+
+    def remove_suffix(self, suffix: str) -> None:
+        """Remove a suffix if it exists.
+
+        Args:
+            suffix (str): Suffix to remove.
+        """
+        if self.plain.endswith(suffix):
+            self.right_crop(len(suffix))
+
+    def get_style_at_offset(self, console: "Console", offset: int) -> Style:
+        """Get the style of a character at give offset.
+
+        Args:
+            console (~Console): Console where text will be rendered.
+            offset (int): Offset in to text (negative indexing supported)
+
+        Returns:
+            Style: A Style instance.
+        """
+        # TODO: This is a little inefficient, it is only used by full justify
+        if offset < 0:
+            offset = len(self) + offset
+        get_style = console.get_style
+        style = get_style(self.style).copy()
+        for start, end, span_style in self._spans:
+            if end > offset >= start:
+                style += get_style(span_style, default="")
+        return style
+
+    def extend_style(self, spaces: int) -> None:
+        """Extend the Text given number of spaces where the spaces have the same style as the last character.
+
+        Args:
+            spaces (int): Number of spaces to add to the Text.
+        """
+        if spaces <= 0:
+            return
+        spans = self.spans
+        new_spaces = " " * spaces
+        if spans:
+            end_offset = len(self)
+            self._spans[:] = [
+                span.extend(spaces) if span.end >= end_offset else span
+                for span in spans
+            ]
+            self._text.append(new_spaces)
+            self._length += spaces
+        else:
+            self.plain += new_spaces
+
+    def highlight_regex(
+        self,
+        re_highlight: Union[Pattern[str], str],
+        style: Optional[Union[GetStyleCallable, StyleType]] = None,
+        *,
+        style_prefix: str = "",
+    ) -> int:
+        """Highlight text with a regular expression, where group names are
+        translated to styles.
+
+        Args:
+            re_highlight (Union[re.Pattern, str]): A regular expression object or string.
+            style (Union[GetStyleCallable, StyleType]): Optional style to apply to whole match, or a callable
+                which accepts the matched text and returns a style. Defaults to None.
+            style_prefix (str, optional): Optional prefix to add to style group names.
+
+        Returns:
+            int: Number of regex matches
+        """
+        count = 0
+        append_span = self._spans.append
+        _Span = Span
+        plain = self.plain
+        if isinstance(re_highlight, str):
+            re_highlight = re.compile(re_highlight)
+        for match in re_highlight.finditer(plain):
+            get_span = match.span
+            if style:
+                start, end = get_span()
+                match_style = style(plain[start:end]) if callable(style) else style
+                if match_style is not None and end > start:
+                    append_span(_Span(start, end, match_style))
+
+            count += 1
+            for name in match.groupdict().keys():
+                start, end = get_span(name)
+                if start != -1 and end > start:
+                    append_span(_Span(start, end, f"{style_prefix}{name}"))
+        return count
+
+    def highlight_words(
+        self,
+        words: Iterable[str],
+        style: Union[str, Style],
+        *,
+        case_sensitive: bool = True,
+    ) -> int:
+        """Highlight words with a style.
+
+        Args:
+            words (Iterable[str]): Words to highlight.
+            style (Union[str, Style]): Style to apply.
+            case_sensitive (bool, optional): Enable case sensitive matching. Defaults to True.
+
+        Returns:
+            int: Number of words highlighted.
+        """
+        re_words = "|".join(re.escape(word) for word in words)
+        add_span = self._spans.append
+        count = 0
+        _Span = Span
+        for match in re.finditer(
+            re_words, self.plain, flags=0 if case_sensitive else re.IGNORECASE
+        ):
+            start, end = match.span(0)
+            add_span(_Span(start, end, style))
+            count += 1
+        return count
+
+    def rstrip(self) -> None:
+        """Strip whitespace from end of text."""
+        self.plain = self.plain.rstrip()
+
+    def rstrip_end(self, size: int) -> None:
+        """Remove whitespace beyond a certain width at the end of the text.
+
+        Args:
+            size (int): The desired size of the text.
+        """
+        text_length = len(self)
+        if text_length > size:
+            excess = text_length - size
+            whitespace_match = _re_whitespace.search(self.plain)
+            if whitespace_match is not None:
+                whitespace_count = len(whitespace_match.group(0))
+                self.right_crop(min(whitespace_count, excess))
+
+    def set_length(self, new_length: int) -> None:
+        """Set new length of the text, clipping or padding is required."""
+        length = len(self)
+        if length != new_length:
+            if length < new_length:
+                self.pad_right(new_length - length)
+            else:
+                self.right_crop(length - new_length)
+
+    def __rich_console__(
+        self, console: "Console", options: "ConsoleOptions"
+    ) -> Iterable[Segment]:
+        tab_size: int = console.tab_size if self.tab_size is None else self.tab_size
+        justify = self.justify or options.justify or DEFAULT_JUSTIFY
+
+        overflow = self.overflow or options.overflow or DEFAULT_OVERFLOW
+
+        lines = self.wrap(
+            console,
+            options.max_width,
+            justify=justify,
+            overflow=overflow,
+            tab_size=tab_size or 8,
+            no_wrap=pick_bool(self.no_wrap, options.no_wrap, False),
+        )
+        all_lines = Text("\n").join(lines)
+        yield from all_lines.render(console, end=self.end)
+
+    def __rich_measure__(
+        self, console: "Console", options: "ConsoleOptions"
+    ) -> Measurement:
+        text = self.plain
+        lines = text.splitlines()
+        max_text_width = max(cell_len(line) for line in lines) if lines else 0
+        words = text.split()
+        min_text_width = (
+            max(cell_len(word) for word in words) if words else max_text_width
+        )
+        return Measurement(min_text_width, max_text_width)
+
+    def render(self, console: "Console", end: str = "") -> Iterable["Segment"]:
+        """Render the text as Segments.
+
+        Args:
+            console (Console): Console instance.
+            end (Optional[str], optional): Optional end character.
+
+        Returns:
+            Iterable[Segment]: Result of render that may be written to the console.
+        """
+        _Segment = Segment
+        text = self.plain
+        if not self._spans:
+            yield Segment(text)
+            if end:
+                yield _Segment(end)
+            return
+        get_style = partial(console.get_style, default=Style.null())
+
+        enumerated_spans = list(enumerate(self._spans, 1))
+        style_map = {index: get_style(span.style) for index, span in enumerated_spans}
+        style_map[0] = get_style(self.style)
+
+        spans = [
+            (0, False, 0),
+            *((span.start, False, index) for index, span in enumerated_spans),
+            *((span.end, True, index) for index, span in enumerated_spans),
+            (len(text), True, 0),
+        ]
+        spans.sort(key=itemgetter(0, 1))
+
+        stack: List[int] = []
+        stack_append = stack.append
+        stack_pop = stack.remove
+
+        style_cache: Dict[Tuple[Style, ...], Style] = {}
+        style_cache_get = style_cache.get
+        combine = Style.combine
+
+        def get_current_style() -> Style:
+            """Construct current style from stack."""
+            styles = tuple(style_map[_style_id] for _style_id in sorted(stack))
+            cached_style = style_cache_get(styles)
+            if cached_style is not None:
+                return cached_style
+            current_style = combine(styles)
+            style_cache[styles] = current_style
+            return current_style
+
+        for (offset, leaving, style_id), (next_offset, _, _) in zip(spans, spans[1:]):
+            if leaving:
+                stack_pop(style_id)
+            else:
+                stack_append(style_id)
+            if next_offset > offset:
+                yield _Segment(text[offset:next_offset], get_current_style())
+        if end:
+            yield _Segment(end)
+
+    def join(self, lines: Iterable["Text"]) -> "Text":
+        """Join text together with this instance as the separator.
+
+        Args:
+            lines (Iterable[Text]): An iterable of Text instances to join.
+
+        Returns:
+            Text: A new text instance containing join text.
+        """
+
+        new_text = self.blank_copy()
+
+        def iter_text() -> Iterable["Text"]:
+            if self.plain:
+                for last, line in loop_last(lines):
+                    yield line
+                    if not last:
+                        yield self
+            else:
+                yield from lines
+
+        extend_text = new_text._text.extend
+        append_span = new_text._spans.append
+        extend_spans = new_text._spans.extend
+        offset = 0
+        _Span = Span
+
+        for text in iter_text():
+            extend_text(text._text)
+            if text.style:
+                append_span(_Span(offset, offset + len(text), text.style))
+            extend_spans(
+                _Span(offset + start, offset + end, style)
+                for start, end, style in text._spans
+            )
+            offset += len(text)
+        new_text._length = offset
+        return new_text
+
+    def expand_tabs(self, tab_size: Optional[int] = None) -> None:
+        """Converts tabs to spaces.
+
+        Args:
+            tab_size (int, optional): Size of tabs. Defaults to 8.
+
+        """
+        if "\t" not in self.plain:
+            return
+        if tab_size is None:
+            tab_size = self.tab_size
+        if tab_size is None:
+            tab_size = 8
+
+        new_text: List[Text] = []
+        append = new_text.append
+
+        for line in self.split("\n", include_separator=True):
+            if "\t" not in line.plain:
+                append(line)
+            else:
+                cell_position = 0
+                parts = line.split("\t", include_separator=True)
+                for part in parts:
+                    if part.plain.endswith("\t"):
+                        part._text[-1] = part._text[-1][:-1] + " "
+                        cell_position += part.cell_len
+                        tab_remainder = cell_position % tab_size
+                        if tab_remainder:
+                            spaces = tab_size - tab_remainder
+                            part.extend_style(spaces)
+                            cell_position += spaces
+                    else:
+                        cell_position += part.cell_len
+                    append(part)
+
+        result = Text("").join(new_text)
+
+        self._text = [result.plain]
+        self._length = len(self.plain)
+        self._spans[:] = result._spans
+
+    def truncate(
+        self,
+        max_width: int,
+        *,
+        overflow: Optional["OverflowMethod"] = None,
+        pad: bool = False,
+    ) -> None:
+        """Truncate text if it is longer that a given width.
+
+        Args:
+            max_width (int): Maximum number of characters in text.
+            overflow (str, optional): Overflow method: "crop", "fold", or "ellipsis". Defaults to None, to use self.overflow.
+            pad (bool, optional): Pad with spaces if the length is less than max_width. Defaults to False.
+        """
+        _overflow = overflow or self.overflow or DEFAULT_OVERFLOW
+        if _overflow != "ignore":
+            length = cell_len(self.plain)
+            if length > max_width:
+                if _overflow == "ellipsis":
+                    self.plain = set_cell_size(self.plain, max_width - 1) + "…"
+                else:
+                    self.plain = set_cell_size(self.plain, max_width)
+            if pad and length < max_width:
+                spaces = max_width - length
+                self._text = [f"{self.plain}{' ' * spaces}"]
+                self._length = len(self.plain)
+
+    def _trim_spans(self) -> None:
+        """Remove or modify any spans that are over the end of the text."""
+        max_offset = len(self.plain)
+        _Span = Span
+        self._spans[:] = [
+            (
+                span
+                if span.end < max_offset
+                else _Span(span.start, min(max_offset, span.end), span.style)
+            )
+            for span in self._spans
+            if span.start < max_offset
+        ]
+
+    def pad(self, count: int, character: str = " ") -> None:
+        """Pad left and right with a given number of characters.
+
+        Args:
+            count (int): Width of padding.
+            character (str): The character to pad with. Must be a string of length 1.
+        """
+        assert len(character) == 1, "Character must be a string of length 1"
+        if count:
+            pad_characters = character * count
+            self.plain = f"{pad_characters}{self.plain}{pad_characters}"
+            _Span = Span
+            self._spans[:] = [
+                _Span(start + count, end + count, style)
+                for start, end, style in self._spans
+            ]
+
+    def pad_left(self, count: int, character: str = " ") -> None:
+        """Pad the left with a given character.
+
+        Args:
+            count (int): Number of characters to pad.
+            character (str, optional): Character to pad with. Defaults to " ".
+        """
+        assert len(character) == 1, "Character must be a string of length 1"
+        if count:
+            self.plain = f"{character * count}{self.plain}"
+            _Span = Span
+            self._spans[:] = [
+                _Span(start + count, end + count, style)
+                for start, end, style in self._spans
+            ]
+
+    def pad_right(self, count: int, character: str = " ") -> None:
+        """Pad the right with a given character.
+
+        Args:
+            count (int): Number of characters to pad.
+            character (str, optional): Character to pad with. Defaults to " ".
+        """
+        assert len(character) == 1, "Character must be a string of length 1"
+        if count:
+            self.plain = f"{self.plain}{character * count}"
+
+    def align(self, align: AlignMethod, width: int, character: str = " ") -> None:
+        """Align text to a given width.
+
+        Args:
+            align (AlignMethod): One of "left", "center", or "right".
+            width (int): Desired width.
+            character (str, optional): Character to pad with. Defaults to " ".
+        """
+        self.truncate(width)
+        excess_space = width - cell_len(self.plain)
+        if excess_space:
+            if align == "left":
+                self.pad_right(excess_space, character)
+            elif align == "center":
+                left = excess_space // 2
+                self.pad_left(left, character)
+                self.pad_right(excess_space - left, character)
+            else:
+                self.pad_left(excess_space, character)
+
+    def append(
+        self, text: Union["Text", str], style: Optional[Union[str, "Style"]] = None
+    ) -> "Text":
+        """Add text with an optional style.
+
+        Args:
+            text (Union[Text, str]): A str or Text to append.
+            style (str, optional): A style name. Defaults to None.
+
+        Returns:
+            Text: Returns self for chaining.
+        """
+
+        if not isinstance(text, (str, Text)):
+            raise TypeError("Only str or Text can be appended to Text")
+
+        if len(text):
+            if isinstance(text, str):
+                sanitized_text = strip_control_codes(text)
+                self._text.append(sanitized_text)
+                offset = len(self)
+                text_length = len(sanitized_text)
+                if style:
+                    self._spans.append(Span(offset, offset + text_length, style))
+                self._length += text_length
+            elif isinstance(text, Text):
+                _Span = Span
+                if style is not None:
+                    raise ValueError(
+                        "style must not be set when appending Text instance"
+                    )
+                text_length = self._length
+                if text.style:
+                    self._spans.append(
+                        _Span(text_length, text_length + len(text), text.style)
+                    )
+                self._text.append(text.plain)
+                self._spans.extend(
+                    _Span(start + text_length, end + text_length, style)
+                    for start, end, style in text._spans.copy()
+                )
+                self._length += len(text)
+        return self
+
+    def append_text(self, text: "Text") -> "Text":
+        """Append another Text instance. This method is more performant that Text.append, but
+        only works for Text.
+
+        Args:
+            text (Text): The Text instance to append to this instance.
+
+        Returns:
+            Text: Returns self for chaining.
+        """
+        _Span = Span
+        text_length = self._length
+        if text.style:
+            self._spans.append(_Span(text_length, text_length + len(text), text.style))
+        self._text.append(text.plain)
+        self._spans.extend(
+            _Span(start + text_length, end + text_length, style)
+            for start, end, style in text._spans.copy()
+        )
+        self._length += len(text)
+        return self
+
+    def append_tokens(
+        self, tokens: Iterable[Tuple[str, Optional[StyleType]]]
+    ) -> "Text":
+        """Append iterable of str and style. Style may be a Style instance or a str style definition.
+
+        Args:
+            tokens (Iterable[Tuple[str, Optional[StyleType]]]): An iterable of tuples containing str content and style.
+
+        Returns:
+            Text: Returns self for chaining.
+        """
+        append_text = self._text.append
+        append_span = self._spans.append
+        _Span = Span
+        offset = len(self)
+        for content, style in tokens:
+            content = strip_control_codes(content)
+            append_text(content)
+            if style:
+                append_span(_Span(offset, offset + len(content), style))
+            offset += len(content)
+        self._length = offset
+        return self
+
+    def copy_styles(self, text: "Text") -> None:
+        """Copy styles from another Text instance.
+
+        Args:
+            text (Text): A Text instance to copy styles from, must be the same length.
+        """
+        self._spans.extend(text._spans)
+
+    def split(
+        self,
+        separator: str = "\n",
+        *,
+        include_separator: bool = False,
+        allow_blank: bool = False,
+    ) -> Lines:
+        """Split rich text in to lines, preserving styles.
+
+        Args:
+            separator (str, optional): String to split on. Defaults to "\\\\n".
+            include_separator (bool, optional): Include the separator in the lines. Defaults to False.
+            allow_blank (bool, optional): Return a blank line if the text ends with a separator. Defaults to False.
+
+        Returns:
+            List[RichText]: A list of rich text, one per line of the original.
+        """
+        assert separator, "separator must not be empty"
+
+        text = self.plain
+        if separator not in text:
+            return Lines([self.copy()])
+
+        if include_separator:
+            lines = self.divide(
+                match.end() for match in re.finditer(re.escape(separator), text)
+            )
+        else:
+
+            def flatten_spans() -> Iterable[int]:
+                for match in re.finditer(re.escape(separator), text):
+                    start, end = match.span()
+                    yield start
+                    yield end
+
+            lines = Lines(
+                line for line in self.divide(flatten_spans()) if line.plain != separator
+            )
+
+        if not allow_blank and text.endswith(separator):
+            lines.pop()
+
+        return lines
+
+    def divide(self, offsets: Iterable[int]) -> Lines:
+        """Divide text in to a number of lines at given offsets.
+
+        Args:
+            offsets (Iterable[int]): Offsets used to divide text.
+
+        Returns:
+            Lines: New RichText instances between offsets.
+        """
+        _offsets = list(offsets)
+
+        if not _offsets:
+            return Lines([self.copy()])
+
+        text = self.plain
+        text_length = len(text)
+        divide_offsets = [0, *_offsets, text_length]
+        line_ranges = list(zip(divide_offsets, divide_offsets[1:]))
+
+        style = self.style
+        justify = self.justify
+        overflow = self.overflow
+        _Text = Text
+        new_lines = Lines(
+            _Text(
+                text[start:end],
+                style=style,
+                justify=justify,
+                overflow=overflow,
+            )
+            for start, end in line_ranges
+        )
+        if not self._spans:
+            return new_lines
+
+        _line_appends = [line._spans.append for line in new_lines._lines]
+        line_count = len(line_ranges)
+        _Span = Span
+
+        for span_start, span_end, style in self._spans:
+            lower_bound = 0
+            upper_bound = line_count
+            start_line_no = (lower_bound + upper_bound) // 2
+
+            while True:
+                line_start, line_end = line_ranges[start_line_no]
+                if span_start < line_start:
+                    upper_bound = start_line_no - 1
+                elif span_start > line_end:
+                    lower_bound = start_line_no + 1
+                else:
+                    break
+                start_line_no = (lower_bound + upper_bound) // 2
+
+            if span_end < line_end:
+                end_line_no = start_line_no
+            else:
+                end_line_no = lower_bound = start_line_no
+                upper_bound = line_count
+
+                while True:
+                    line_start, line_end = line_ranges[end_line_no]
+                    if span_end < line_start:
+                        upper_bound = end_line_no - 1
+                    elif span_end > line_end:
+                        lower_bound = end_line_no + 1
+                    else:
+                        break
+                    end_line_no = (lower_bound + upper_bound) // 2
+
+            for line_no in range(start_line_no, end_line_no + 1):
+                line_start, line_end = line_ranges[line_no]
+                new_start = max(0, span_start - line_start)
+                new_end = min(span_end - line_start, line_end - line_start)
+                if new_end > new_start:
+                    _line_appends[line_no](_Span(new_start, new_end, style))
+
+        return new_lines
+
+    def right_crop(self, amount: int = 1) -> None:
+        """Remove a number of characters from the end of the text."""
+        max_offset = len(self.plain) - amount
+        _Span = Span
+        self._spans[:] = [
+            (
+                span
+                if span.end < max_offset
+                else _Span(span.start, min(max_offset, span.end), span.style)
+            )
+            for span in self._spans
+            if span.start < max_offset
+        ]
+        self._text = [self.plain[:-amount]]
+        self._length -= amount
+
+    def wrap(
+        self,
+        console: "Console",
+        width: int,
+        *,
+        justify: Optional["JustifyMethod"] = None,
+        overflow: Optional["OverflowMethod"] = None,
+        tab_size: int = 8,
+        no_wrap: Optional[bool] = None,
+    ) -> Lines:
+        """Word wrap the text.
+
+        Args:
+            console (Console): Console instance.
+            width (int): Number of cells available per line.
+            justify (str, optional): Justify method: "default", "left", "center", "full", "right". Defaults to "default".
+            overflow (str, optional): Overflow method: "crop", "fold", or "ellipsis". Defaults to None.
+            tab_size (int, optional): Default tab size. Defaults to 8.
+            no_wrap (bool, optional): Disable wrapping, Defaults to False.
+
+        Returns:
+            Lines: Number of lines.
+        """
+        wrap_justify = justify or self.justify or DEFAULT_JUSTIFY
+        wrap_overflow = overflow or self.overflow or DEFAULT_OVERFLOW
+
+        no_wrap = pick_bool(no_wrap, self.no_wrap, False) or overflow == "ignore"
+
+        lines = Lines()
+        for line in self.split(allow_blank=True):
+            if "\t" in line:
+                line.expand_tabs(tab_size)
+            if no_wrap:
+                new_lines = Lines([line])
+            else:
+                offsets = divide_line(str(line), width, fold=wrap_overflow == "fold")
+                new_lines = line.divide(offsets)
+            for line in new_lines:
+                line.rstrip_end(width)
+            if wrap_justify:
+                new_lines.justify(
+                    console, width, justify=wrap_justify, overflow=wrap_overflow
+                )
+            for line in new_lines:
+                line.truncate(width, overflow=wrap_overflow)
+            lines.extend(new_lines)
+        return lines
+
+    def fit(self, width: int) -> Lines:
+        """Fit the text in to given width by chopping in to lines.
+
+        Args:
+            width (int): Maximum characters in a line.
+
+        Returns:
+            Lines: Lines container.
+        """
+        lines: Lines = Lines()
+        append = lines.append
+        for line in self.split():
+            line.set_length(width)
+            append(line)
+        return lines
+
+    def detect_indentation(self) -> int:
+        """Auto-detect indentation of code.
+
+        Returns:
+            int: Number of spaces used to indent code.
+        """
+
+        _indentations = {
+            len(match.group(1))
+            for match in re.finditer(r"^( *)(.*)$", self.plain, flags=re.MULTILINE)
+        }
+
+        try:
+            indentation = (
+                reduce(gcd, [indent for indent in _indentations if not indent % 2]) or 1
+            )
+        except TypeError:
+            indentation = 1
+
+        return indentation
+
+    def with_indent_guides(
+        self,
+        indent_size: Optional[int] = None,
+        *,
+        character: str = "│",
+        style: StyleType = "dim green",
+    ) -> "Text":
+        """Adds indent guide lines to text.
+
+        Args:
+            indent_size (Optional[int]): Size of indentation, or None to auto detect. Defaults to None.
+            character (str, optional): Character to use for indentation. Defaults to "│".
+            style (Union[Style, str], optional): Style of indent guides.
+
+        Returns:
+            Text: New text with indentation guides.
+        """
+
+        _indent_size = self.detect_indentation() if indent_size is None else indent_size
+
+        text = self.copy()
+        text.expand_tabs()
+        indent_line = f"{character}{' ' * (_indent_size - 1)}"
+
+        re_indent = re.compile(r"^( *)(.*)$")
+        new_lines: List[Text] = []
+        add_line = new_lines.append
+        blank_lines = 0
+        for line in text.split(allow_blank=True):
+            match = re_indent.match(line.plain)
+            if not match or not match.group(2):
+                blank_lines += 1
+                continue
+            indent = match.group(1)
+            full_indents, remaining_space = divmod(len(indent), _indent_size)
+            new_indent = f"{indent_line * full_indents}{' ' * remaining_space}"
+            line.plain = new_indent + line.plain[len(new_indent) :]
+            line.stylize(style, 0, len(new_indent))
+            if blank_lines:
+                new_lines.extend([Text(new_indent, style=style)] * blank_lines)
+                blank_lines = 0
+            add_line(line)
+        if blank_lines:
+            new_lines.extend([Text("", style=style)] * blank_lines)
+
+        new_text = text.blank_copy("\n").join(new_lines)
+        return new_text
+
+
+if __name__ == "__main__":  # pragma: no cover
+    from pip._vendor.rich.console import Console
+
+    text = Text(
+        """\nLorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.\n"""
+    )
+    text.highlight_words(["Lorem"], "bold")
+    text.highlight_words(["ipsum"], "italic")
+
+    console = Console()
+
+    console.rule("justify='left'")
+    console.print(text, style="red")
+    console.print()
+
+    console.rule("justify='center'")
+    console.print(text, style="green", justify="center")
+    console.print()
+
+    console.rule("justify='right'")
+    console.print(text, style="blue", justify="right")
+    console.print()
+
+    console.rule("justify='full'")
+    console.print(text, style="magenta", justify="full")
+    console.print()
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/theme.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/theme.py
new file mode 100644
index 0000000..227f1d8
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/theme.py
@@ -0,0 +1,115 @@
+import configparser
+from typing import IO, Dict, List, Mapping, Optional
+
+from .default_styles import DEFAULT_STYLES
+from .style import Style, StyleType
+
+
+class Theme:
+    """A container for style information, used by :class:`~rich.console.Console`.
+
+    Args:
+        styles (Dict[str, Style], optional): A mapping of style names on to styles. Defaults to None for a theme with no styles.
+        inherit (bool, optional): Inherit default styles. Defaults to True.
+    """
+
+    styles: Dict[str, Style]
+
+    def __init__(
+        self, styles: Optional[Mapping[str, StyleType]] = None, inherit: bool = True
+    ):
+        self.styles = DEFAULT_STYLES.copy() if inherit else {}
+        if styles is not None:
+            self.styles.update(
+                {
+                    name: style if isinstance(style, Style) else Style.parse(style)
+                    for name, style in styles.items()
+                }
+            )
+
+    @property
+    def config(self) -> str:
+        """Get contents of a config file for this theme."""
+        config = "[styles]\n" + "\n".join(
+            f"{name} = {style}" for name, style in sorted(self.styles.items())
+        )
+        return config
+
+    @classmethod
+    def from_file(
+        cls, config_file: IO[str], source: Optional[str] = None, inherit: bool = True
+    ) -> "Theme":
+        """Load a theme from a text mode file.
+
+        Args:
+            config_file (IO[str]): An open conf file.
+            source (str, optional): The filename of the open file. Defaults to None.
+            inherit (bool, optional): Inherit default styles. Defaults to True.
+
+        Returns:
+            Theme: A New theme instance.
+        """
+        config = configparser.ConfigParser()
+        config.read_file(config_file, source=source)
+        styles = {name: Style.parse(value) for name, value in config.items("styles")}
+        theme = Theme(styles, inherit=inherit)
+        return theme
+
+    @classmethod
+    def read(
+        cls, path: str, inherit: bool = True, encoding: Optional[str] = None
+    ) -> "Theme":
+        """Read a theme from a path.
+
+        Args:
+            path (str): Path to a config file readable by Python configparser module.
+            inherit (bool, optional): Inherit default styles. Defaults to True.
+            encoding (str, optional): Encoding of the config file. Defaults to None.
+
+        Returns:
+            Theme: A new theme instance.
+        """
+        with open(path, encoding=encoding) as config_file:
+            return cls.from_file(config_file, source=path, inherit=inherit)
+
+
+class ThemeStackError(Exception):
+    """Base exception for errors related to the theme stack."""
+
+
+class ThemeStack:
+    """A stack of themes.
+
+    Args:
+        theme (Theme): A theme instance
+    """
+
+    def __init__(self, theme: Theme) -> None:
+        self._entries: List[Dict[str, Style]] = [theme.styles]
+        self.get = self._entries[-1].get
+
+    def push_theme(self, theme: Theme, inherit: bool = True) -> None:
+        """Push a theme on the top of the stack.
+
+        Args:
+            theme (Theme): A Theme instance.
+            inherit (boolean, optional): Inherit styles from current top of stack.
+        """
+        styles: Dict[str, Style]
+        styles = (
+            {**self._entries[-1], **theme.styles} if inherit else theme.styles.copy()
+        )
+        self._entries.append(styles)
+        self.get = self._entries[-1].get
+
+    def pop_theme(self) -> None:
+        """Pop (and discard) the top-most theme."""
+        if len(self._entries) == 1:
+            raise ThemeStackError("Unable to pop base theme")
+        self._entries.pop()
+        self.get = self._entries[-1].get
+
+
+if __name__ == "__main__":  # pragma: no cover
+    theme = Theme()
+    print(theme.config)
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/themes.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/themes.py
new file mode 100644
index 0000000..bf6db10
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/themes.py
@@ -0,0 +1,5 @@
+from .default_styles import DEFAULT_STYLES
+from .theme import Theme
+
+
+DEFAULT = Theme(DEFAULT_STYLES)
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/traceback.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/traceback.py
new file mode 100644
index 0000000..28d742b
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/traceback.py
@@ -0,0 +1,797 @@
+import inspect
+import linecache
+import os
+import sys
+from dataclasses import dataclass, field
+from itertools import islice
+from traceback import walk_tb
+from types import ModuleType, TracebackType
+from typing import (
+    Any,
+    Callable,
+    Dict,
+    Iterable,
+    List,
+    Optional,
+    Sequence,
+    Tuple,
+    Type,
+    Union,
+)
+
+from pip._vendor.pygments.lexers import guess_lexer_for_filename
+from pip._vendor.pygments.token import Comment, Keyword, Name, Number, Operator, String
+from pip._vendor.pygments.token import Text as TextToken
+from pip._vendor.pygments.token import Token
+from pip._vendor.pygments.util import ClassNotFound
+
+from . import pretty
+from ._loop import loop_last
+from .columns import Columns
+from .console import Console, ConsoleOptions, ConsoleRenderable, RenderResult, group
+from .constrain import Constrain
+from .highlighter import RegexHighlighter, ReprHighlighter
+from .panel import Panel
+from .scope import render_scope
+from .style import Style
+from .syntax import Syntax
+from .text import Text
+from .theme import Theme
+
+WINDOWS = sys.platform == "win32"
+
+LOCALS_MAX_LENGTH = 10
+LOCALS_MAX_STRING = 80
+
+
+def install(
+    *,
+    console: Optional[Console] = None,
+    width: Optional[int] = 100,
+    code_width: Optional[int] = 88,
+    extra_lines: int = 3,
+    theme: Optional[str] = None,
+    word_wrap: bool = False,
+    show_locals: bool = False,
+    locals_max_length: int = LOCALS_MAX_LENGTH,
+    locals_max_string: int = LOCALS_MAX_STRING,
+    locals_hide_dunder: bool = True,
+    locals_hide_sunder: Optional[bool] = None,
+    indent_guides: bool = True,
+    suppress: Iterable[Union[str, ModuleType]] = (),
+    max_frames: int = 100,
+) -> Callable[[Type[BaseException], BaseException, Optional[TracebackType]], Any]:
+    """Install a rich traceback handler.
+
+    Once installed, any tracebacks will be printed with syntax highlighting and rich formatting.
+
+
+    Args:
+        console (Optional[Console], optional): Console to write exception to. Default uses internal Console instance.
+        width (Optional[int], optional): Width (in characters) of traceback. Defaults to 100.
+        code_width (Optional[int], optional): Code width (in characters) of traceback. Defaults to 88.
+        extra_lines (int, optional): Extra lines of code. Defaults to 3.
+        theme (Optional[str], optional): Pygments theme to use in traceback. Defaults to ``None`` which will pick
+            a theme appropriate for the platform.
+        word_wrap (bool, optional): Enable word wrapping of long lines. Defaults to False.
+        show_locals (bool, optional): Enable display of local variables. Defaults to False.
+        locals_max_length (int, optional): Maximum length of containers before abbreviating, or None for no abbreviation.
+            Defaults to 10.
+        locals_max_string (int, optional): Maximum length of string before truncating, or None to disable. Defaults to 80.
+        locals_hide_dunder (bool, optional): Hide locals prefixed with double underscore. Defaults to True.
+        locals_hide_sunder (bool, optional): Hide locals prefixed with single underscore. Defaults to False.
+        indent_guides (bool, optional): Enable indent guides in code and locals. Defaults to True.
+        suppress (Sequence[Union[str, ModuleType]]): Optional sequence of modules or paths to exclude from traceback.
+
+    Returns:
+        Callable: The previous exception handler that was replaced.
+
+    """
+    traceback_console = Console(stderr=True) if console is None else console
+
+    locals_hide_sunder = (
+        True
+        if (traceback_console.is_jupyter and locals_hide_sunder is None)
+        else locals_hide_sunder
+    )
+
+    def excepthook(
+        type_: Type[BaseException],
+        value: BaseException,
+        traceback: Optional[TracebackType],
+    ) -> None:
+        traceback_console.print(
+            Traceback.from_exception(
+                type_,
+                value,
+                traceback,
+                width=width,
+                code_width=code_width,
+                extra_lines=extra_lines,
+                theme=theme,
+                word_wrap=word_wrap,
+                show_locals=show_locals,
+                locals_max_length=locals_max_length,
+                locals_max_string=locals_max_string,
+                locals_hide_dunder=locals_hide_dunder,
+                locals_hide_sunder=bool(locals_hide_sunder),
+                indent_guides=indent_guides,
+                suppress=suppress,
+                max_frames=max_frames,
+            )
+        )
+
+    def ipy_excepthook_closure(ip: Any) -> None:  # pragma: no cover
+        tb_data = {}  # store information about showtraceback call
+        default_showtraceback = ip.showtraceback  # keep reference of default traceback
+
+        def ipy_show_traceback(*args: Any, **kwargs: Any) -> None:
+            """wrap the default ip.showtraceback to store info for ip._showtraceback"""
+            nonlocal tb_data
+            tb_data = kwargs
+            default_showtraceback(*args, **kwargs)
+
+        def ipy_display_traceback(
+            *args: Any, is_syntax: bool = False, **kwargs: Any
+        ) -> None:
+            """Internally called traceback from ip._showtraceback"""
+            nonlocal tb_data
+            exc_tuple = ip._get_exc_info()
+
+            # do not display trace on syntax error
+            tb: Optional[TracebackType] = None if is_syntax else exc_tuple[2]
+
+            # determine correct tb_offset
+            compiled = tb_data.get("running_compiled_code", False)
+            tb_offset = tb_data.get("tb_offset", 1 if compiled else 0)
+            # remove ipython internal frames from trace with tb_offset
+            for _ in range(tb_offset):
+                if tb is None:
+                    break
+                tb = tb.tb_next
+
+            excepthook(exc_tuple[0], exc_tuple[1], tb)
+            tb_data = {}  # clear data upon usage
+
+        # replace _showtraceback instead of showtraceback to allow ipython features such as debugging to work
+        # this is also what the ipython docs recommends to modify when subclassing InteractiveShell
+        ip._showtraceback = ipy_display_traceback
+        # add wrapper to capture tb_data
+        ip.showtraceback = ipy_show_traceback
+        ip.showsyntaxerror = lambda *args, **kwargs: ipy_display_traceback(
+            *args, is_syntax=True, **kwargs
+        )
+
+    try:  # pragma: no cover
+        # if within ipython, use customized traceback
+        ip = get_ipython()  # type: ignore[name-defined]
+        ipy_excepthook_closure(ip)
+        return sys.excepthook
+    except Exception:
+        # otherwise use default system hook
+        old_excepthook = sys.excepthook
+        sys.excepthook = excepthook
+        return old_excepthook
+
+
+@dataclass
+class Frame:
+    filename: str
+    lineno: int
+    name: str
+    line: str = ""
+    locals: Optional[Dict[str, pretty.Node]] = None
+    last_instruction: Optional[Tuple[Tuple[int, int], Tuple[int, int]]] = None
+
+
+@dataclass
+class _SyntaxError:
+    offset: int
+    filename: str
+    line: str
+    lineno: int
+    msg: str
+
+
+@dataclass
+class Stack:
+    exc_type: str
+    exc_value: str
+    syntax_error: Optional[_SyntaxError] = None
+    is_cause: bool = False
+    frames: List[Frame] = field(default_factory=list)
+
+
+@dataclass
+class Trace:
+    stacks: List[Stack]
+
+
+class PathHighlighter(RegexHighlighter):
+    highlights = [r"(?P.*/)(?P.+)"]
+
+
+class Traceback:
+    """A Console renderable that renders a traceback.
+
+    Args:
+        trace (Trace, optional): A `Trace` object produced from `extract`. Defaults to None, which uses
+            the last exception.
+        width (Optional[int], optional): Number of characters used to traceback. Defaults to 100.
+        code_width (Optional[int], optional): Number of code characters used to traceback. Defaults to 88.
+        extra_lines (int, optional): Additional lines of code to render. Defaults to 3.
+        theme (str, optional): Override pygments theme used in traceback.
+        word_wrap (bool, optional): Enable word wrapping of long lines. Defaults to False.
+        show_locals (bool, optional): Enable display of local variables. Defaults to False.
+        indent_guides (bool, optional): Enable indent guides in code and locals. Defaults to True.
+        locals_max_length (int, optional): Maximum length of containers before abbreviating, or None for no abbreviation.
+            Defaults to 10.
+        locals_max_string (int, optional): Maximum length of string before truncating, or None to disable. Defaults to 80.
+        locals_hide_dunder (bool, optional): Hide locals prefixed with double underscore. Defaults to True.
+        locals_hide_sunder (bool, optional): Hide locals prefixed with single underscore. Defaults to False.
+        suppress (Sequence[Union[str, ModuleType]]): Optional sequence of modules or paths to exclude from traceback.
+        max_frames (int): Maximum number of frames to show in a traceback, 0 for no maximum. Defaults to 100.
+
+    """
+
+    LEXERS = {
+        "": "text",
+        ".py": "python",
+        ".pxd": "cython",
+        ".pyx": "cython",
+        ".pxi": "pyrex",
+    }
+
+    def __init__(
+        self,
+        trace: Optional[Trace] = None,
+        *,
+        width: Optional[int] = 100,
+        code_width: Optional[int] = 88,
+        extra_lines: int = 3,
+        theme: Optional[str] = None,
+        word_wrap: bool = False,
+        show_locals: bool = False,
+        locals_max_length: int = LOCALS_MAX_LENGTH,
+        locals_max_string: int = LOCALS_MAX_STRING,
+        locals_hide_dunder: bool = True,
+        locals_hide_sunder: bool = False,
+        indent_guides: bool = True,
+        suppress: Iterable[Union[str, ModuleType]] = (),
+        max_frames: int = 100,
+    ):
+        if trace is None:
+            exc_type, exc_value, traceback = sys.exc_info()
+            if exc_type is None or exc_value is None or traceback is None:
+                raise ValueError(
+                    "Value for 'trace' required if not called in except: block"
+                )
+            trace = self.extract(
+                exc_type, exc_value, traceback, show_locals=show_locals
+            )
+        self.trace = trace
+        self.width = width
+        self.code_width = code_width
+        self.extra_lines = extra_lines
+        self.theme = Syntax.get_theme(theme or "ansi_dark")
+        self.word_wrap = word_wrap
+        self.show_locals = show_locals
+        self.indent_guides = indent_guides
+        self.locals_max_length = locals_max_length
+        self.locals_max_string = locals_max_string
+        self.locals_hide_dunder = locals_hide_dunder
+        self.locals_hide_sunder = locals_hide_sunder
+
+        self.suppress: Sequence[str] = []
+        for suppress_entity in suppress:
+            if not isinstance(suppress_entity, str):
+                assert (
+                    suppress_entity.__file__ is not None
+                ), f"{suppress_entity!r} must be a module with '__file__' attribute"
+                path = os.path.dirname(suppress_entity.__file__)
+            else:
+                path = suppress_entity
+            path = os.path.normpath(os.path.abspath(path))
+            self.suppress.append(path)
+        self.max_frames = max(4, max_frames) if max_frames > 0 else 0
+
+    @classmethod
+    def from_exception(
+        cls,
+        exc_type: Type[Any],
+        exc_value: BaseException,
+        traceback: Optional[TracebackType],
+        *,
+        width: Optional[int] = 100,
+        code_width: Optional[int] = 88,
+        extra_lines: int = 3,
+        theme: Optional[str] = None,
+        word_wrap: bool = False,
+        show_locals: bool = False,
+        locals_max_length: int = LOCALS_MAX_LENGTH,
+        locals_max_string: int = LOCALS_MAX_STRING,
+        locals_hide_dunder: bool = True,
+        locals_hide_sunder: bool = False,
+        indent_guides: bool = True,
+        suppress: Iterable[Union[str, ModuleType]] = (),
+        max_frames: int = 100,
+    ) -> "Traceback":
+        """Create a traceback from exception info
+
+        Args:
+            exc_type (Type[BaseException]): Exception type.
+            exc_value (BaseException): Exception value.
+            traceback (TracebackType): Python Traceback object.
+            width (Optional[int], optional): Number of characters used to traceback. Defaults to 100.
+            code_width (Optional[int], optional): Number of code characters used to traceback. Defaults to 88.
+            extra_lines (int, optional): Additional lines of code to render. Defaults to 3.
+            theme (str, optional): Override pygments theme used in traceback.
+            word_wrap (bool, optional): Enable word wrapping of long lines. Defaults to False.
+            show_locals (bool, optional): Enable display of local variables. Defaults to False.
+            indent_guides (bool, optional): Enable indent guides in code and locals. Defaults to True.
+            locals_max_length (int, optional): Maximum length of containers before abbreviating, or None for no abbreviation.
+                Defaults to 10.
+            locals_max_string (int, optional): Maximum length of string before truncating, or None to disable. Defaults to 80.
+            locals_hide_dunder (bool, optional): Hide locals prefixed with double underscore. Defaults to True.
+            locals_hide_sunder (bool, optional): Hide locals prefixed with single underscore. Defaults to False.
+            suppress (Iterable[Union[str, ModuleType]]): Optional sequence of modules or paths to exclude from traceback.
+            max_frames (int): Maximum number of frames to show in a traceback, 0 for no maximum. Defaults to 100.
+
+        Returns:
+            Traceback: A Traceback instance that may be printed.
+        """
+        rich_traceback = cls.extract(
+            exc_type,
+            exc_value,
+            traceback,
+            show_locals=show_locals,
+            locals_max_length=locals_max_length,
+            locals_max_string=locals_max_string,
+            locals_hide_dunder=locals_hide_dunder,
+            locals_hide_sunder=locals_hide_sunder,
+        )
+
+        return cls(
+            rich_traceback,
+            width=width,
+            code_width=code_width,
+            extra_lines=extra_lines,
+            theme=theme,
+            word_wrap=word_wrap,
+            show_locals=show_locals,
+            indent_guides=indent_guides,
+            locals_max_length=locals_max_length,
+            locals_max_string=locals_max_string,
+            locals_hide_dunder=locals_hide_dunder,
+            locals_hide_sunder=locals_hide_sunder,
+            suppress=suppress,
+            max_frames=max_frames,
+        )
+
+    @classmethod
+    def extract(
+        cls,
+        exc_type: Type[BaseException],
+        exc_value: BaseException,
+        traceback: Optional[TracebackType],
+        *,
+        show_locals: bool = False,
+        locals_max_length: int = LOCALS_MAX_LENGTH,
+        locals_max_string: int = LOCALS_MAX_STRING,
+        locals_hide_dunder: bool = True,
+        locals_hide_sunder: bool = False,
+    ) -> Trace:
+        """Extract traceback information.
+
+        Args:
+            exc_type (Type[BaseException]): Exception type.
+            exc_value (BaseException): Exception value.
+            traceback (TracebackType): Python Traceback object.
+            show_locals (bool, optional): Enable display of local variables. Defaults to False.
+            locals_max_length (int, optional): Maximum length of containers before abbreviating, or None for no abbreviation.
+                Defaults to 10.
+            locals_max_string (int, optional): Maximum length of string before truncating, or None to disable. Defaults to 80.
+            locals_hide_dunder (bool, optional): Hide locals prefixed with double underscore. Defaults to True.
+            locals_hide_sunder (bool, optional): Hide locals prefixed with single underscore. Defaults to False.
+
+        Returns:
+            Trace: A Trace instance which you can use to construct a `Traceback`.
+        """
+
+        stacks: List[Stack] = []
+        is_cause = False
+
+        from pip._vendor.rich import _IMPORT_CWD
+
+        def safe_str(_object: Any) -> str:
+            """Don't allow exceptions from __str__ to propagate."""
+            try:
+                return str(_object)
+            except Exception:
+                return ""
+
+        while True:
+            stack = Stack(
+                exc_type=safe_str(exc_type.__name__),
+                exc_value=safe_str(exc_value),
+                is_cause=is_cause,
+            )
+
+            if isinstance(exc_value, SyntaxError):
+                stack.syntax_error = _SyntaxError(
+                    offset=exc_value.offset or 0,
+                    filename=exc_value.filename or "?",
+                    lineno=exc_value.lineno or 0,
+                    line=exc_value.text or "",
+                    msg=exc_value.msg,
+                )
+
+            stacks.append(stack)
+            append = stack.frames.append
+
+            def get_locals(
+                iter_locals: Iterable[Tuple[str, object]]
+            ) -> Iterable[Tuple[str, object]]:
+                """Extract locals from an iterator of key pairs."""
+                if not (locals_hide_dunder or locals_hide_sunder):
+                    yield from iter_locals
+                    return
+                for key, value in iter_locals:
+                    if locals_hide_dunder and key.startswith("__"):
+                        continue
+                    if locals_hide_sunder and key.startswith("_"):
+                        continue
+                    yield key, value
+
+            for frame_summary, line_no in walk_tb(traceback):
+                filename = frame_summary.f_code.co_filename
+
+                last_instruction: Optional[Tuple[Tuple[int, int], Tuple[int, int]]]
+                last_instruction = None
+                if sys.version_info >= (3, 11):
+                    instruction_index = frame_summary.f_lasti // 2
+                    instruction_position = next(
+                        islice(
+                            frame_summary.f_code.co_positions(),
+                            instruction_index,
+                            instruction_index + 1,
+                        )
+                    )
+                    (
+                        start_line,
+                        end_line,
+                        start_column,
+                        end_column,
+                    ) = instruction_position
+                    if (
+                        start_line is not None
+                        and end_line is not None
+                        and start_column is not None
+                        and end_column is not None
+                    ):
+                        last_instruction = (
+                            (start_line, start_column),
+                            (end_line, end_column),
+                        )
+
+                if filename and not filename.startswith("<"):
+                    if not os.path.isabs(filename):
+                        filename = os.path.join(_IMPORT_CWD, filename)
+                if frame_summary.f_locals.get("_rich_traceback_omit", False):
+                    continue
+
+                frame = Frame(
+                    filename=filename or "?",
+                    lineno=line_no,
+                    name=frame_summary.f_code.co_name,
+                    locals=(
+                        {
+                            key: pretty.traverse(
+                                value,
+                                max_length=locals_max_length,
+                                max_string=locals_max_string,
+                            )
+                            for key, value in get_locals(frame_summary.f_locals.items())
+                            if not (inspect.isfunction(value) or inspect.isclass(value))
+                        }
+                        if show_locals
+                        else None
+                    ),
+                    last_instruction=last_instruction,
+                )
+                append(frame)
+                if frame_summary.f_locals.get("_rich_traceback_guard", False):
+                    del stack.frames[:]
+
+            cause = getattr(exc_value, "__cause__", None)
+            if cause:
+                exc_type = cause.__class__
+                exc_value = cause
+                # __traceback__ can be None, e.g. for exceptions raised by the
+                # 'multiprocessing' module
+                traceback = cause.__traceback__
+                is_cause = True
+                continue
+
+            cause = exc_value.__context__
+            if cause and not getattr(exc_value, "__suppress_context__", False):
+                exc_type = cause.__class__
+                exc_value = cause
+                traceback = cause.__traceback__
+                is_cause = False
+                continue
+            # No cover, code is reached but coverage doesn't recognize it.
+            break  # pragma: no cover
+
+        trace = Trace(stacks=stacks)
+        return trace
+
+    def __rich_console__(
+        self, console: Console, options: ConsoleOptions
+    ) -> RenderResult:
+        theme = self.theme
+        background_style = theme.get_background_style()
+        token_style = theme.get_style_for_token
+
+        traceback_theme = Theme(
+            {
+                "pretty": token_style(TextToken),
+                "pygments.text": token_style(Token),
+                "pygments.string": token_style(String),
+                "pygments.function": token_style(Name.Function),
+                "pygments.number": token_style(Number),
+                "repr.indent": token_style(Comment) + Style(dim=True),
+                "repr.str": token_style(String),
+                "repr.brace": token_style(TextToken) + Style(bold=True),
+                "repr.number": token_style(Number),
+                "repr.bool_true": token_style(Keyword.Constant),
+                "repr.bool_false": token_style(Keyword.Constant),
+                "repr.none": token_style(Keyword.Constant),
+                "scope.border": token_style(String.Delimiter),
+                "scope.equals": token_style(Operator),
+                "scope.key": token_style(Name),
+                "scope.key.special": token_style(Name.Constant) + Style(dim=True),
+            },
+            inherit=False,
+        )
+
+        highlighter = ReprHighlighter()
+        for last, stack in loop_last(reversed(self.trace.stacks)):
+            if stack.frames:
+                stack_renderable: ConsoleRenderable = Panel(
+                    self._render_stack(stack),
+                    title="[traceback.title]Traceback [dim](most recent call last)",
+                    style=background_style,
+                    border_style="traceback.border",
+                    expand=True,
+                    padding=(0, 1),
+                )
+                stack_renderable = Constrain(stack_renderable, self.width)
+                with console.use_theme(traceback_theme):
+                    yield stack_renderable
+            if stack.syntax_error is not None:
+                with console.use_theme(traceback_theme):
+                    yield Constrain(
+                        Panel(
+                            self._render_syntax_error(stack.syntax_error),
+                            style=background_style,
+                            border_style="traceback.border.syntax_error",
+                            expand=True,
+                            padding=(0, 1),
+                            width=self.width,
+                        ),
+                        self.width,
+                    )
+                yield Text.assemble(
+                    (f"{stack.exc_type}: ", "traceback.exc_type"),
+                    highlighter(stack.syntax_error.msg),
+                )
+            elif stack.exc_value:
+                yield Text.assemble(
+                    (f"{stack.exc_type}: ", "traceback.exc_type"),
+                    highlighter(stack.exc_value),
+                )
+            else:
+                yield Text.assemble((f"{stack.exc_type}", "traceback.exc_type"))
+
+            if not last:
+                if stack.is_cause:
+                    yield Text.from_markup(
+                        "\n[i]The above exception was the direct cause of the following exception:\n",
+                    )
+                else:
+                    yield Text.from_markup(
+                        "\n[i]During handling of the above exception, another exception occurred:\n",
+                    )
+
+    @group()
+    def _render_syntax_error(self, syntax_error: _SyntaxError) -> RenderResult:
+        highlighter = ReprHighlighter()
+        path_highlighter = PathHighlighter()
+        if syntax_error.filename != "":
+            if os.path.exists(syntax_error.filename):
+                text = Text.assemble(
+                    (f" {syntax_error.filename}", "pygments.string"),
+                    (":", "pygments.text"),
+                    (str(syntax_error.lineno), "pygments.number"),
+                    style="pygments.text",
+                )
+                yield path_highlighter(text)
+        syntax_error_text = highlighter(syntax_error.line.rstrip())
+        syntax_error_text.no_wrap = True
+        offset = min(syntax_error.offset - 1, len(syntax_error_text))
+        syntax_error_text.stylize("bold underline", offset, offset)
+        syntax_error_text += Text.from_markup(
+            "\n" + " " * offset + "[traceback.offset]▲[/]",
+            style="pygments.text",
+        )
+        yield syntax_error_text
+
+    @classmethod
+    def _guess_lexer(cls, filename: str, code: str) -> str:
+        ext = os.path.splitext(filename)[-1]
+        if not ext:
+            # No extension, look at first line to see if it is a hashbang
+            # Note, this is an educated guess and not a guarantee
+            # If it fails, the only downside is that the code is highlighted strangely
+            new_line_index = code.index("\n")
+            first_line = code[:new_line_index] if new_line_index != -1 else code
+            if first_line.startswith("#!") and "python" in first_line.lower():
+                return "python"
+        try:
+            return cls.LEXERS.get(ext) or guess_lexer_for_filename(filename, code).name
+        except ClassNotFound:
+            return "text"
+
+    @group()
+    def _render_stack(self, stack: Stack) -> RenderResult:
+        path_highlighter = PathHighlighter()
+        theme = self.theme
+
+        def read_code(filename: str) -> str:
+            """Read files, and cache results on filename.
+
+            Args:
+                filename (str): Filename to read
+
+            Returns:
+                str: Contents of file
+            """
+            return "".join(linecache.getlines(filename))
+
+        def render_locals(frame: Frame) -> Iterable[ConsoleRenderable]:
+            if frame.locals:
+                yield render_scope(
+                    frame.locals,
+                    title="locals",
+                    indent_guides=self.indent_guides,
+                    max_length=self.locals_max_length,
+                    max_string=self.locals_max_string,
+                )
+
+        exclude_frames: Optional[range] = None
+        if self.max_frames != 0:
+            exclude_frames = range(
+                self.max_frames // 2,
+                len(stack.frames) - self.max_frames // 2,
+            )
+
+        excluded = False
+        for frame_index, frame in enumerate(stack.frames):
+            if exclude_frames and frame_index in exclude_frames:
+                excluded = True
+                continue
+
+            if excluded:
+                assert exclude_frames is not None
+                yield Text(
+                    f"\n... {len(exclude_frames)} frames hidden ...",
+                    justify="center",
+                    style="traceback.error",
+                )
+                excluded = False
+
+            first = frame_index == 0
+            frame_filename = frame.filename
+            suppressed = any(frame_filename.startswith(path) for path in self.suppress)
+
+            if os.path.exists(frame.filename):
+                text = Text.assemble(
+                    path_highlighter(Text(frame.filename, style="pygments.string")),
+                    (":", "pygments.text"),
+                    (str(frame.lineno), "pygments.number"),
+                    " in ",
+                    (frame.name, "pygments.function"),
+                    style="pygments.text",
+                )
+            else:
+                text = Text.assemble(
+                    "in ",
+                    (frame.name, "pygments.function"),
+                    (":", "pygments.text"),
+                    (str(frame.lineno), "pygments.number"),
+                    style="pygments.text",
+                )
+            if not frame.filename.startswith("<") and not first:
+                yield ""
+            yield text
+            if frame.filename.startswith("<"):
+                yield from render_locals(frame)
+                continue
+            if not suppressed:
+                try:
+                    code = read_code(frame.filename)
+                    if not code:
+                        # code may be an empty string if the file doesn't exist, OR
+                        # if the traceback filename is generated dynamically
+                        continue
+                    lexer_name = self._guess_lexer(frame.filename, code)
+                    syntax = Syntax(
+                        code,
+                        lexer_name,
+                        theme=theme,
+                        line_numbers=True,
+                        line_range=(
+                            frame.lineno - self.extra_lines,
+                            frame.lineno + self.extra_lines,
+                        ),
+                        highlight_lines={frame.lineno},
+                        word_wrap=self.word_wrap,
+                        code_width=self.code_width,
+                        indent_guides=self.indent_guides,
+                        dedent=False,
+                    )
+                    yield ""
+                except Exception as error:
+                    yield Text.assemble(
+                        (f"\n{error}", "traceback.error"),
+                    )
+                else:
+                    if frame.last_instruction is not None:
+                        start, end = frame.last_instruction
+                        syntax.stylize_range(
+                            style="traceback.error_range",
+                            start=start,
+                            end=end,
+                            style_before=True,
+                        )
+                    yield (
+                        Columns(
+                            [
+                                syntax,
+                                *render_locals(frame),
+                            ],
+                            padding=1,
+                        )
+                        if frame.locals
+                        else syntax
+                    )
+
+
+if __name__ == "__main__":  # pragma: no cover
+    install(show_locals=True)
+    import sys
+
+    def bar(
+        a: Any,
+    ) -> None:  # 这是对亚洲语言支持的测试。面对模棱两可的想法，拒绝猜测的诱惑
+        one = 1
+        print(one / a)
+
+    def foo(a: Any) -> None:
+        _rich_traceback_guard = True
+        zed = {
+            "characters": {
+                "Paul Atreides",
+                "Vladimir Harkonnen",
+                "Thufir Hawat",
+                "Duncan Idaho",
+            },
+            "atomic_types": (None, False, True),
+        }
+        bar(a)
+
+    def error() -> None:
+        foo(0)
+
+    error()
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/tree.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/tree.py
new file mode 100644
index 0000000..27c5cf7
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/rich/tree.py
@@ -0,0 +1,257 @@
+from typing import Iterator, List, Optional, Tuple
+
+from ._loop import loop_first, loop_last
+from .console import Console, ConsoleOptions, RenderableType, RenderResult
+from .jupyter import JupyterMixin
+from .measure import Measurement
+from .segment import Segment
+from .style import Style, StyleStack, StyleType
+from .styled import Styled
+
+GuideType = Tuple[str, str, str, str]
+
+
+class Tree(JupyterMixin):
+    """A renderable for a tree structure.
+
+    Attributes:
+        ASCII_GUIDES (GuideType): Guide lines used when Console.ascii_only is True.
+        TREE_GUIDES (List[GuideType, GuideType, GuideType]): Default guide lines.
+
+    Args:
+        label (RenderableType): The renderable or str for the tree label.
+        style (StyleType, optional): Style of this tree. Defaults to "tree".
+        guide_style (StyleType, optional): Style of the guide lines. Defaults to "tree.line".
+        expanded (bool, optional): Also display children. Defaults to True.
+        highlight (bool, optional): Highlight renderable (if str). Defaults to False.
+        hide_root (bool, optional): Hide the root node. Defaults to False.
+    """
+
+    ASCII_GUIDES = ("    ", "|   ", "+-- ", "`-- ")
+    TREE_GUIDES = [
+        ("    ", "│   ", "├── ", "└── "),
+        ("    ", "┃   ", "┣━━ ", "┗━━ "),
+        ("    ", "║   ", "╠══ ", "╚══ "),
+    ]
+
+    def __init__(
+        self,
+        label: RenderableType,
+        *,
+        style: StyleType = "tree",
+        guide_style: StyleType = "tree.line",
+        expanded: bool = True,
+        highlight: bool = False,
+        hide_root: bool = False,
+    ) -> None:
+        self.label = label
+        self.style = style
+        self.guide_style = guide_style
+        self.children: List[Tree] = []
+        self.expanded = expanded
+        self.highlight = highlight
+        self.hide_root = hide_root
+
+    def add(
+        self,
+        label: RenderableType,
+        *,
+        style: Optional[StyleType] = None,
+        guide_style: Optional[StyleType] = None,
+        expanded: bool = True,
+        highlight: Optional[bool] = False,
+    ) -> "Tree":
+        """Add a child tree.
+
+        Args:
+            label (RenderableType): The renderable or str for the tree label.
+            style (StyleType, optional): Style of this tree. Defaults to "tree".
+            guide_style (StyleType, optional): Style of the guide lines. Defaults to "tree.line".
+            expanded (bool, optional): Also display children. Defaults to True.
+            highlight (Optional[bool], optional): Highlight renderable (if str). Defaults to False.
+
+        Returns:
+            Tree: A new child Tree, which may be further modified.
+        """
+        node = Tree(
+            label,
+            style=self.style if style is None else style,
+            guide_style=self.guide_style if guide_style is None else guide_style,
+            expanded=expanded,
+            highlight=self.highlight if highlight is None else highlight,
+        )
+        self.children.append(node)
+        return node
+
+    def __rich_console__(
+        self, console: "Console", options: "ConsoleOptions"
+    ) -> "RenderResult":
+        stack: List[Iterator[Tuple[bool, Tree]]] = []
+        pop = stack.pop
+        push = stack.append
+        new_line = Segment.line()
+
+        get_style = console.get_style
+        null_style = Style.null()
+        guide_style = get_style(self.guide_style, default="") or null_style
+        SPACE, CONTINUE, FORK, END = range(4)
+
+        _Segment = Segment
+
+        def make_guide(index: int, style: Style) -> Segment:
+            """Make a Segment for a level of the guide lines."""
+            if options.ascii_only:
+                line = self.ASCII_GUIDES[index]
+            else:
+                guide = 1 if style.bold else (2 if style.underline2 else 0)
+                line = self.TREE_GUIDES[0 if options.legacy_windows else guide][index]
+            return _Segment(line, style)
+
+        levels: List[Segment] = [make_guide(CONTINUE, guide_style)]
+        push(iter(loop_last([self])))
+
+        guide_style_stack = StyleStack(get_style(self.guide_style))
+        style_stack = StyleStack(get_style(self.style))
+        remove_guide_styles = Style(bold=False, underline2=False)
+
+        depth = 0
+
+        while stack:
+            stack_node = pop()
+            try:
+                last, node = next(stack_node)
+            except StopIteration:
+                levels.pop()
+                if levels:
+                    guide_style = levels[-1].style or null_style
+                    levels[-1] = make_guide(FORK, guide_style)
+                    guide_style_stack.pop()
+                    style_stack.pop()
+                continue
+            push(stack_node)
+            if last:
+                levels[-1] = make_guide(END, levels[-1].style or null_style)
+
+            guide_style = guide_style_stack.current + get_style(node.guide_style)
+            style = style_stack.current + get_style(node.style)
+            prefix = levels[(2 if self.hide_root else 1) :]
+            renderable_lines = console.render_lines(
+                Styled(node.label, style),
+                options.update(
+                    width=options.max_width
+                    - sum(level.cell_length for level in prefix),
+                    highlight=self.highlight,
+                    height=None,
+                ),
+                pad=options.justify is not None,
+            )
+
+            if not (depth == 0 and self.hide_root):
+                for first, line in loop_first(renderable_lines):
+                    if prefix:
+                        yield from _Segment.apply_style(
+                            prefix,
+                            style.background_style,
+                            post_style=remove_guide_styles,
+                        )
+                    yield from line
+                    yield new_line
+                    if first and prefix:
+                        prefix[-1] = make_guide(
+                            SPACE if last else CONTINUE, prefix[-1].style or null_style
+                        )
+
+            if node.expanded and node.children:
+                levels[-1] = make_guide(
+                    SPACE if last else CONTINUE, levels[-1].style or null_style
+                )
+                levels.append(
+                    make_guide(END if len(node.children) == 1 else FORK, guide_style)
+                )
+                style_stack.push(get_style(node.style))
+                guide_style_stack.push(get_style(node.guide_style))
+                push(iter(loop_last(node.children)))
+                depth += 1
+
+    def __rich_measure__(
+        self, console: "Console", options: "ConsoleOptions"
+    ) -> "Measurement":
+        stack: List[Iterator[Tree]] = [iter([self])]
+        pop = stack.pop
+        push = stack.append
+        minimum = 0
+        maximum = 0
+        measure = Measurement.get
+        level = 0
+        while stack:
+            iter_tree = pop()
+            try:
+                tree = next(iter_tree)
+            except StopIteration:
+                level -= 1
+                continue
+            push(iter_tree)
+            min_measure, max_measure = measure(console, options, tree.label)
+            indent = level * 4
+            minimum = max(min_measure + indent, minimum)
+            maximum = max(max_measure + indent, maximum)
+            if tree.expanded and tree.children:
+                push(iter(tree.children))
+                level += 1
+        return Measurement(minimum, maximum)
+
+
+if __name__ == "__main__":  # pragma: no cover
+    from pip._vendor.rich.console import Group
+    from pip._vendor.rich.markdown import Markdown
+    from pip._vendor.rich.panel import Panel
+    from pip._vendor.rich.syntax import Syntax
+    from pip._vendor.rich.table import Table
+
+    table = Table(row_styles=["", "dim"])
+
+    table.add_column("Released", style="cyan", no_wrap=True)
+    table.add_column("Title", style="magenta")
+    table.add_column("Box Office", justify="right", style="green")
+
+    table.add_row("Dec 20, 2019", "Star Wars: The Rise of Skywalker", "$952,110,690")
+    table.add_row("May 25, 2018", "Solo: A Star Wars Story", "$393,151,347")
+    table.add_row("Dec 15, 2017", "Star Wars Ep. V111: The Last Jedi", "$1,332,539,889")
+    table.add_row("Dec 16, 2016", "Rogue One: A Star Wars Story", "$1,332,439,889")
+
+    code = """\
+class Segment(NamedTuple):
+    text: str = ""
+    style: Optional[Style] = None
+    is_control: bool = False
+"""
+    syntax = Syntax(code, "python", theme="monokai", line_numbers=True)
+
+    markdown = Markdown(
+        """\
+### example.md
+> Hello, World!
+>
+> Markdown _all_ the things
+"""
+    )
+
+    root = Tree("🌲 [b green]Rich Tree", highlight=True, hide_root=True)
+
+    node = root.add(":file_folder: Renderables", guide_style="red")
+    simple_node = node.add(":file_folder: [bold yellow]Atomic", guide_style="uu green")
+    simple_node.add(Group("📄 Syntax", syntax))
+    simple_node.add(Group("📄 Markdown", Panel(markdown, border_style="green")))
+
+    containers_node = node.add(
+        ":file_folder: [bold magenta]Containers", guide_style="bold magenta"
+    )
+    containers_node.expanded = True
+    panel = Panel.fit("Just a panel", border_style="red")
+    containers_node.add(Group("📄 Panels", panel))
+
+    containers_node.add(Group("📄 [b magenta]Table", table))
+
+    console = Console()
+
+    console.print(root)
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/tomli/__init__.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/tomli/__init__.py
new file mode 100644
index 0000000..2b08d6e
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/tomli/__init__.py
@@ -0,0 +1,8 @@
+# SPDX-License-Identifier: MIT
+# SPDX-FileCopyrightText: 2021 Taneli Hukkinen
+# Licensed to PSF under a Contributor Agreement.
+
+__all__ = ("loads", "load", "TOMLDecodeError")
+__version__ = "2.2.1"  # DO NOT EDIT THIS LINE MANUALLY. LET bump2version UTILITY DO IT
+
+from ._parser import TOMLDecodeError, load, loads
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/tomli/__pycache__/__init__.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/tomli/__pycache__/__init__.cpython-312.pyc
new file mode 100644
index 0000000..167386f
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/tomli/__pycache__/__init__.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/tomli/__pycache__/_parser.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/tomli/__pycache__/_parser.cpython-312.pyc
new file mode 100644
index 0000000..17a5259
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/tomli/__pycache__/_parser.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/tomli/__pycache__/_re.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/tomli/__pycache__/_re.cpython-312.pyc
new file mode 100644
index 0000000..381a75f
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/tomli/__pycache__/_re.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/tomli/__pycache__/_types.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/tomli/__pycache__/_types.cpython-312.pyc
new file mode 100644
index 0000000..2f540d6
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/tomli/__pycache__/_types.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/tomli/_parser.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/tomli/_parser.py
new file mode 100644
index 0000000..b548e8b
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/tomli/_parser.py
@@ -0,0 +1,770 @@
+# SPDX-License-Identifier: MIT
+# SPDX-FileCopyrightText: 2021 Taneli Hukkinen
+# Licensed to PSF under a Contributor Agreement.
+
+from __future__ import annotations
+
+from collections.abc import Iterable
+import string
+import sys
+from types import MappingProxyType
+from typing import IO, Any, Final, NamedTuple
+import warnings
+
+from ._re import (
+    RE_DATETIME,
+    RE_LOCALTIME,
+    RE_NUMBER,
+    match_to_datetime,
+    match_to_localtime,
+    match_to_number,
+)
+from ._types import Key, ParseFloat, Pos
+
+# Inline tables/arrays are implemented using recursion. Pathologically
+# nested documents cause pure Python to raise RecursionError (which is OK),
+# but mypyc binary wheels will crash unrecoverably (not OK). According to
+# mypyc docs this will be fixed in the future:
+# https://mypyc.readthedocs.io/en/latest/differences_from_python.html#stack-overflows
+# Before mypyc's fix is in, recursion needs to be limited by this library.
+# Choosing `sys.getrecursionlimit()` as maximum inline table/array nesting
+# level, as it allows more nesting than pure Python, but still seems a far
+# lower number than where mypyc binaries crash.
+MAX_INLINE_NESTING: Final = sys.getrecursionlimit()
+
+ASCII_CTRL: Final = frozenset(chr(i) for i in range(32)) | frozenset(chr(127))
+
+# Neither of these sets include quotation mark or backslash. They are
+# currently handled as separate cases in the parser functions.
+ILLEGAL_BASIC_STR_CHARS: Final = ASCII_CTRL - frozenset("\t")
+ILLEGAL_MULTILINE_BASIC_STR_CHARS: Final = ASCII_CTRL - frozenset("\t\n")
+
+ILLEGAL_LITERAL_STR_CHARS: Final = ILLEGAL_BASIC_STR_CHARS
+ILLEGAL_MULTILINE_LITERAL_STR_CHARS: Final = ILLEGAL_MULTILINE_BASIC_STR_CHARS
+
+ILLEGAL_COMMENT_CHARS: Final = ILLEGAL_BASIC_STR_CHARS
+
+TOML_WS: Final = frozenset(" \t")
+TOML_WS_AND_NEWLINE: Final = TOML_WS | frozenset("\n")
+BARE_KEY_CHARS: Final = frozenset(string.ascii_letters + string.digits + "-_")
+KEY_INITIAL_CHARS: Final = BARE_KEY_CHARS | frozenset("\"'")
+HEXDIGIT_CHARS: Final = frozenset(string.hexdigits)
+
+BASIC_STR_ESCAPE_REPLACEMENTS: Final = MappingProxyType(
+    {
+        "\\b": "\u0008",  # backspace
+        "\\t": "\u0009",  # tab
+        "\\n": "\u000A",  # linefeed
+        "\\f": "\u000C",  # form feed
+        "\\r": "\u000D",  # carriage return
+        '\\"': "\u0022",  # quote
+        "\\\\": "\u005C",  # backslash
+    }
+)
+
+
+class DEPRECATED_DEFAULT:
+    """Sentinel to be used as default arg during deprecation
+    period of TOMLDecodeError's free-form arguments."""
+
+
+class TOMLDecodeError(ValueError):
+    """An error raised if a document is not valid TOML.
+
+    Adds the following attributes to ValueError:
+    msg: The unformatted error message
+    doc: The TOML document being parsed
+    pos: The index of doc where parsing failed
+    lineno: The line corresponding to pos
+    colno: The column corresponding to pos
+    """
+
+    def __init__(
+        self,
+        msg: str | type[DEPRECATED_DEFAULT] = DEPRECATED_DEFAULT,
+        doc: str | type[DEPRECATED_DEFAULT] = DEPRECATED_DEFAULT,
+        pos: Pos | type[DEPRECATED_DEFAULT] = DEPRECATED_DEFAULT,
+        *args: Any,
+    ):
+        if (
+            args
+            or not isinstance(msg, str)
+            or not isinstance(doc, str)
+            or not isinstance(pos, int)
+        ):
+            warnings.warn(
+                "Free-form arguments for TOMLDecodeError are deprecated. "
+                "Please set 'msg' (str), 'doc' (str) and 'pos' (int) arguments only.",
+                DeprecationWarning,
+                stacklevel=2,
+            )
+            if pos is not DEPRECATED_DEFAULT:
+                args = pos, *args
+            if doc is not DEPRECATED_DEFAULT:
+                args = doc, *args
+            if msg is not DEPRECATED_DEFAULT:
+                args = msg, *args
+            ValueError.__init__(self, *args)
+            return
+
+        lineno = doc.count("\n", 0, pos) + 1
+        if lineno == 1:
+            colno = pos + 1
+        else:
+            colno = pos - doc.rindex("\n", 0, pos)
+
+        if pos >= len(doc):
+            coord_repr = "end of document"
+        else:
+            coord_repr = f"line {lineno}, column {colno}"
+        errmsg = f"{msg} (at {coord_repr})"
+        ValueError.__init__(self, errmsg)
+
+        self.msg = msg
+        self.doc = doc
+        self.pos = pos
+        self.lineno = lineno
+        self.colno = colno
+
+
+def load(__fp: IO[bytes], *, parse_float: ParseFloat = float) -> dict[str, Any]:
+    """Parse TOML from a binary file object."""
+    b = __fp.read()
+    try:
+        s = b.decode()
+    except AttributeError:
+        raise TypeError(
+            "File must be opened in binary mode, e.g. use `open('foo.toml', 'rb')`"
+        ) from None
+    return loads(s, parse_float=parse_float)
+
+
+def loads(__s: str, *, parse_float: ParseFloat = float) -> dict[str, Any]:  # noqa: C901
+    """Parse TOML from a string."""
+
+    # The spec allows converting "\r\n" to "\n", even in string
+    # literals. Let's do so to simplify parsing.
+    try:
+        src = __s.replace("\r\n", "\n")
+    except (AttributeError, TypeError):
+        raise TypeError(
+            f"Expected str object, not '{type(__s).__qualname__}'"
+        ) from None
+    pos = 0
+    out = Output(NestedDict(), Flags())
+    header: Key = ()
+    parse_float = make_safe_parse_float(parse_float)
+
+    # Parse one statement at a time
+    # (typically means one line in TOML source)
+    while True:
+        # 1. Skip line leading whitespace
+        pos = skip_chars(src, pos, TOML_WS)
+
+        # 2. Parse rules. Expect one of the following:
+        #    - end of file
+        #    - end of line
+        #    - comment
+        #    - key/value pair
+        #    - append dict to list (and move to its namespace)
+        #    - create dict (and move to its namespace)
+        # Skip trailing whitespace when applicable.
+        try:
+            char = src[pos]
+        except IndexError:
+            break
+        if char == "\n":
+            pos += 1
+            continue
+        if char in KEY_INITIAL_CHARS:
+            pos = key_value_rule(src, pos, out, header, parse_float)
+            pos = skip_chars(src, pos, TOML_WS)
+        elif char == "[":
+            try:
+                second_char: str | None = src[pos + 1]
+            except IndexError:
+                second_char = None
+            out.flags.finalize_pending()
+            if second_char == "[":
+                pos, header = create_list_rule(src, pos, out)
+            else:
+                pos, header = create_dict_rule(src, pos, out)
+            pos = skip_chars(src, pos, TOML_WS)
+        elif char != "#":
+            raise TOMLDecodeError("Invalid statement", src, pos)
+
+        # 3. Skip comment
+        pos = skip_comment(src, pos)
+
+        # 4. Expect end of line or end of file
+        try:
+            char = src[pos]
+        except IndexError:
+            break
+        if char != "\n":
+            raise TOMLDecodeError(
+                "Expected newline or end of document after a statement", src, pos
+            )
+        pos += 1
+
+    return out.data.dict
+
+
+class Flags:
+    """Flags that map to parsed keys/namespaces."""
+
+    # Marks an immutable namespace (inline array or inline table).
+    FROZEN: Final = 0
+    # Marks a nest that has been explicitly created and can no longer
+    # be opened using the "[table]" syntax.
+    EXPLICIT_NEST: Final = 1
+
+    def __init__(self) -> None:
+        self._flags: dict[str, dict] = {}
+        self._pending_flags: set[tuple[Key, int]] = set()
+
+    def add_pending(self, key: Key, flag: int) -> None:
+        self._pending_flags.add((key, flag))
+
+    def finalize_pending(self) -> None:
+        for key, flag in self._pending_flags:
+            self.set(key, flag, recursive=False)
+        self._pending_flags.clear()
+
+    def unset_all(self, key: Key) -> None:
+        cont = self._flags
+        for k in key[:-1]:
+            if k not in cont:
+                return
+            cont = cont[k]["nested"]
+        cont.pop(key[-1], None)
+
+    def set(self, key: Key, flag: int, *, recursive: bool) -> None:  # noqa: A003
+        cont = self._flags
+        key_parent, key_stem = key[:-1], key[-1]
+        for k in key_parent:
+            if k not in cont:
+                cont[k] = {"flags": set(), "recursive_flags": set(), "nested": {}}
+            cont = cont[k]["nested"]
+        if key_stem not in cont:
+            cont[key_stem] = {"flags": set(), "recursive_flags": set(), "nested": {}}
+        cont[key_stem]["recursive_flags" if recursive else "flags"].add(flag)
+
+    def is_(self, key: Key, flag: int) -> bool:
+        if not key:
+            return False  # document root has no flags
+        cont = self._flags
+        for k in key[:-1]:
+            if k not in cont:
+                return False
+            inner_cont = cont[k]
+            if flag in inner_cont["recursive_flags"]:
+                return True
+            cont = inner_cont["nested"]
+        key_stem = key[-1]
+        if key_stem in cont:
+            inner_cont = cont[key_stem]
+            return flag in inner_cont["flags"] or flag in inner_cont["recursive_flags"]
+        return False
+
+
+class NestedDict:
+    def __init__(self) -> None:
+        # The parsed content of the TOML document
+        self.dict: dict[str, Any] = {}
+
+    def get_or_create_nest(
+        self,
+        key: Key,
+        *,
+        access_lists: bool = True,
+    ) -> dict:
+        cont: Any = self.dict
+        for k in key:
+            if k not in cont:
+                cont[k] = {}
+            cont = cont[k]
+            if access_lists and isinstance(cont, list):
+                cont = cont[-1]
+            if not isinstance(cont, dict):
+                raise KeyError("There is no nest behind this key")
+        return cont
+
+    def append_nest_to_list(self, key: Key) -> None:
+        cont = self.get_or_create_nest(key[:-1])
+        last_key = key[-1]
+        if last_key in cont:
+            list_ = cont[last_key]
+            if not isinstance(list_, list):
+                raise KeyError("An object other than list found behind this key")
+            list_.append({})
+        else:
+            cont[last_key] = [{}]
+
+
+class Output(NamedTuple):
+    data: NestedDict
+    flags: Flags
+
+
+def skip_chars(src: str, pos: Pos, chars: Iterable[str]) -> Pos:
+    try:
+        while src[pos] in chars:
+            pos += 1
+    except IndexError:
+        pass
+    return pos
+
+
+def skip_until(
+    src: str,
+    pos: Pos,
+    expect: str,
+    *,
+    error_on: frozenset[str],
+    error_on_eof: bool,
+) -> Pos:
+    try:
+        new_pos = src.index(expect, pos)
+    except ValueError:
+        new_pos = len(src)
+        if error_on_eof:
+            raise TOMLDecodeError(f"Expected {expect!r}", src, new_pos) from None
+
+    if not error_on.isdisjoint(src[pos:new_pos]):
+        while src[pos] not in error_on:
+            pos += 1
+        raise TOMLDecodeError(f"Found invalid character {src[pos]!r}", src, pos)
+    return new_pos
+
+
+def skip_comment(src: str, pos: Pos) -> Pos:
+    try:
+        char: str | None = src[pos]
+    except IndexError:
+        char = None
+    if char == "#":
+        return skip_until(
+            src, pos + 1, "\n", error_on=ILLEGAL_COMMENT_CHARS, error_on_eof=False
+        )
+    return pos
+
+
+def skip_comments_and_array_ws(src: str, pos: Pos) -> Pos:
+    while True:
+        pos_before_skip = pos
+        pos = skip_chars(src, pos, TOML_WS_AND_NEWLINE)
+        pos = skip_comment(src, pos)
+        if pos == pos_before_skip:
+            return pos
+
+
+def create_dict_rule(src: str, pos: Pos, out: Output) -> tuple[Pos, Key]:
+    pos += 1  # Skip "["
+    pos = skip_chars(src, pos, TOML_WS)
+    pos, key = parse_key(src, pos)
+
+    if out.flags.is_(key, Flags.EXPLICIT_NEST) or out.flags.is_(key, Flags.FROZEN):
+        raise TOMLDecodeError(f"Cannot declare {key} twice", src, pos)
+    out.flags.set(key, Flags.EXPLICIT_NEST, recursive=False)
+    try:
+        out.data.get_or_create_nest(key)
+    except KeyError:
+        raise TOMLDecodeError("Cannot overwrite a value", src, pos) from None
+
+    if not src.startswith("]", pos):
+        raise TOMLDecodeError(
+            "Expected ']' at the end of a table declaration", src, pos
+        )
+    return pos + 1, key
+
+
+def create_list_rule(src: str, pos: Pos, out: Output) -> tuple[Pos, Key]:
+    pos += 2  # Skip "[["
+    pos = skip_chars(src, pos, TOML_WS)
+    pos, key = parse_key(src, pos)
+
+    if out.flags.is_(key, Flags.FROZEN):
+        raise TOMLDecodeError(f"Cannot mutate immutable namespace {key}", src, pos)
+    # Free the namespace now that it points to another empty list item...
+    out.flags.unset_all(key)
+    # ...but this key precisely is still prohibited from table declaration
+    out.flags.set(key, Flags.EXPLICIT_NEST, recursive=False)
+    try:
+        out.data.append_nest_to_list(key)
+    except KeyError:
+        raise TOMLDecodeError("Cannot overwrite a value", src, pos) from None
+
+    if not src.startswith("]]", pos):
+        raise TOMLDecodeError(
+            "Expected ']]' at the end of an array declaration", src, pos
+        )
+    return pos + 2, key
+
+
+def key_value_rule(
+    src: str, pos: Pos, out: Output, header: Key, parse_float: ParseFloat
+) -> Pos:
+    pos, key, value = parse_key_value_pair(src, pos, parse_float, nest_lvl=0)
+    key_parent, key_stem = key[:-1], key[-1]
+    abs_key_parent = header + key_parent
+
+    relative_path_cont_keys = (header + key[:i] for i in range(1, len(key)))
+    for cont_key in relative_path_cont_keys:
+        # Check that dotted key syntax does not redefine an existing table
+        if out.flags.is_(cont_key, Flags.EXPLICIT_NEST):
+            raise TOMLDecodeError(f"Cannot redefine namespace {cont_key}", src, pos)
+        # Containers in the relative path can't be opened with the table syntax or
+        # dotted key/value syntax in following table sections.
+        out.flags.add_pending(cont_key, Flags.EXPLICIT_NEST)
+
+    if out.flags.is_(abs_key_parent, Flags.FROZEN):
+        raise TOMLDecodeError(
+            f"Cannot mutate immutable namespace {abs_key_parent}", src, pos
+        )
+
+    try:
+        nest = out.data.get_or_create_nest(abs_key_parent)
+    except KeyError:
+        raise TOMLDecodeError("Cannot overwrite a value", src, pos) from None
+    if key_stem in nest:
+        raise TOMLDecodeError("Cannot overwrite a value", src, pos)
+    # Mark inline table and array namespaces recursively immutable
+    if isinstance(value, (dict, list)):
+        out.flags.set(header + key, Flags.FROZEN, recursive=True)
+    nest[key_stem] = value
+    return pos
+
+
+def parse_key_value_pair(
+    src: str, pos: Pos, parse_float: ParseFloat, nest_lvl: int
+) -> tuple[Pos, Key, Any]:
+    pos, key = parse_key(src, pos)
+    try:
+        char: str | None = src[pos]
+    except IndexError:
+        char = None
+    if char != "=":
+        raise TOMLDecodeError("Expected '=' after a key in a key/value pair", src, pos)
+    pos += 1
+    pos = skip_chars(src, pos, TOML_WS)
+    pos, value = parse_value(src, pos, parse_float, nest_lvl)
+    return pos, key, value
+
+
+def parse_key(src: str, pos: Pos) -> tuple[Pos, Key]:
+    pos, key_part = parse_key_part(src, pos)
+    key: Key = (key_part,)
+    pos = skip_chars(src, pos, TOML_WS)
+    while True:
+        try:
+            char: str | None = src[pos]
+        except IndexError:
+            char = None
+        if char != ".":
+            return pos, key
+        pos += 1
+        pos = skip_chars(src, pos, TOML_WS)
+        pos, key_part = parse_key_part(src, pos)
+        key += (key_part,)
+        pos = skip_chars(src, pos, TOML_WS)
+
+
+def parse_key_part(src: str, pos: Pos) -> tuple[Pos, str]:
+    try:
+        char: str | None = src[pos]
+    except IndexError:
+        char = None
+    if char in BARE_KEY_CHARS:
+        start_pos = pos
+        pos = skip_chars(src, pos, BARE_KEY_CHARS)
+        return pos, src[start_pos:pos]
+    if char == "'":
+        return parse_literal_str(src, pos)
+    if char == '"':
+        return parse_one_line_basic_str(src, pos)
+    raise TOMLDecodeError("Invalid initial character for a key part", src, pos)
+
+
+def parse_one_line_basic_str(src: str, pos: Pos) -> tuple[Pos, str]:
+    pos += 1
+    return parse_basic_str(src, pos, multiline=False)
+
+
+def parse_array(
+    src: str, pos: Pos, parse_float: ParseFloat, nest_lvl: int
+) -> tuple[Pos, list]:
+    pos += 1
+    array: list = []
+
+    pos = skip_comments_and_array_ws(src, pos)
+    if src.startswith("]", pos):
+        return pos + 1, array
+    while True:
+        pos, val = parse_value(src, pos, parse_float, nest_lvl)
+        array.append(val)
+        pos = skip_comments_and_array_ws(src, pos)
+
+        c = src[pos : pos + 1]
+        if c == "]":
+            return pos + 1, array
+        if c != ",":
+            raise TOMLDecodeError("Unclosed array", src, pos)
+        pos += 1
+
+        pos = skip_comments_and_array_ws(src, pos)
+        if src.startswith("]", pos):
+            return pos + 1, array
+
+
+def parse_inline_table(
+    src: str, pos: Pos, parse_float: ParseFloat, nest_lvl: int
+) -> tuple[Pos, dict]:
+    pos += 1
+    nested_dict = NestedDict()
+    flags = Flags()
+
+    pos = skip_chars(src, pos, TOML_WS)
+    if src.startswith("}", pos):
+        return pos + 1, nested_dict.dict
+    while True:
+        pos, key, value = parse_key_value_pair(src, pos, parse_float, nest_lvl)
+        key_parent, key_stem = key[:-1], key[-1]
+        if flags.is_(key, Flags.FROZEN):
+            raise TOMLDecodeError(f"Cannot mutate immutable namespace {key}", src, pos)
+        try:
+            nest = nested_dict.get_or_create_nest(key_parent, access_lists=False)
+        except KeyError:
+            raise TOMLDecodeError("Cannot overwrite a value", src, pos) from None
+        if key_stem in nest:
+            raise TOMLDecodeError(f"Duplicate inline table key {key_stem!r}", src, pos)
+        nest[key_stem] = value
+        pos = skip_chars(src, pos, TOML_WS)
+        c = src[pos : pos + 1]
+        if c == "}":
+            return pos + 1, nested_dict.dict
+        if c != ",":
+            raise TOMLDecodeError("Unclosed inline table", src, pos)
+        if isinstance(value, (dict, list)):
+            flags.set(key, Flags.FROZEN, recursive=True)
+        pos += 1
+        pos = skip_chars(src, pos, TOML_WS)
+
+
+def parse_basic_str_escape(
+    src: str, pos: Pos, *, multiline: bool = False
+) -> tuple[Pos, str]:
+    escape_id = src[pos : pos + 2]
+    pos += 2
+    if multiline and escape_id in {"\\ ", "\\\t", "\\\n"}:
+        # Skip whitespace until next non-whitespace character or end of
+        # the doc. Error if non-whitespace is found before newline.
+        if escape_id != "\\\n":
+            pos = skip_chars(src, pos, TOML_WS)
+            try:
+                char = src[pos]
+            except IndexError:
+                return pos, ""
+            if char != "\n":
+                raise TOMLDecodeError("Unescaped '\\' in a string", src, pos)
+            pos += 1
+        pos = skip_chars(src, pos, TOML_WS_AND_NEWLINE)
+        return pos, ""
+    if escape_id == "\\u":
+        return parse_hex_char(src, pos, 4)
+    if escape_id == "\\U":
+        return parse_hex_char(src, pos, 8)
+    try:
+        return pos, BASIC_STR_ESCAPE_REPLACEMENTS[escape_id]
+    except KeyError:
+        raise TOMLDecodeError("Unescaped '\\' in a string", src, pos) from None
+
+
+def parse_basic_str_escape_multiline(src: str, pos: Pos) -> tuple[Pos, str]:
+    return parse_basic_str_escape(src, pos, multiline=True)
+
+
+def parse_hex_char(src: str, pos: Pos, hex_len: int) -> tuple[Pos, str]:
+    hex_str = src[pos : pos + hex_len]
+    if len(hex_str) != hex_len or not HEXDIGIT_CHARS.issuperset(hex_str):
+        raise TOMLDecodeError("Invalid hex value", src, pos)
+    pos += hex_len
+    hex_int = int(hex_str, 16)
+    if not is_unicode_scalar_value(hex_int):
+        raise TOMLDecodeError(
+            "Escaped character is not a Unicode scalar value", src, pos
+        )
+    return pos, chr(hex_int)
+
+
+def parse_literal_str(src: str, pos: Pos) -> tuple[Pos, str]:
+    pos += 1  # Skip starting apostrophe
+    start_pos = pos
+    pos = skip_until(
+        src, pos, "'", error_on=ILLEGAL_LITERAL_STR_CHARS, error_on_eof=True
+    )
+    return pos + 1, src[start_pos:pos]  # Skip ending apostrophe
+
+
+def parse_multiline_str(src: str, pos: Pos, *, literal: bool) -> tuple[Pos, str]:
+    pos += 3
+    if src.startswith("\n", pos):
+        pos += 1
+
+    if literal:
+        delim = "'"
+        end_pos = skip_until(
+            src,
+            pos,
+            "'''",
+            error_on=ILLEGAL_MULTILINE_LITERAL_STR_CHARS,
+            error_on_eof=True,
+        )
+        result = src[pos:end_pos]
+        pos = end_pos + 3
+    else:
+        delim = '"'
+        pos, result = parse_basic_str(src, pos, multiline=True)
+
+    # Add at maximum two extra apostrophes/quotes if the end sequence
+    # is 4 or 5 chars long instead of just 3.
+    if not src.startswith(delim, pos):
+        return pos, result
+    pos += 1
+    if not src.startswith(delim, pos):
+        return pos, result + delim
+    pos += 1
+    return pos, result + (delim * 2)
+
+
+def parse_basic_str(src: str, pos: Pos, *, multiline: bool) -> tuple[Pos, str]:
+    if multiline:
+        error_on = ILLEGAL_MULTILINE_BASIC_STR_CHARS
+        parse_escapes = parse_basic_str_escape_multiline
+    else:
+        error_on = ILLEGAL_BASIC_STR_CHARS
+        parse_escapes = parse_basic_str_escape
+    result = ""
+    start_pos = pos
+    while True:
+        try:
+            char = src[pos]
+        except IndexError:
+            raise TOMLDecodeError("Unterminated string", src, pos) from None
+        if char == '"':
+            if not multiline:
+                return pos + 1, result + src[start_pos:pos]
+            if src.startswith('"""', pos):
+                return pos + 3, result + src[start_pos:pos]
+            pos += 1
+            continue
+        if char == "\\":
+            result += src[start_pos:pos]
+            pos, parsed_escape = parse_escapes(src, pos)
+            result += parsed_escape
+            start_pos = pos
+            continue
+        if char in error_on:
+            raise TOMLDecodeError(f"Illegal character {char!r}", src, pos)
+        pos += 1
+
+
+def parse_value(  # noqa: C901
+    src: str, pos: Pos, parse_float: ParseFloat, nest_lvl: int
+) -> tuple[Pos, Any]:
+    if nest_lvl > MAX_INLINE_NESTING:
+        # Pure Python should have raised RecursionError already.
+        # This ensures mypyc binaries eventually do the same.
+        raise RecursionError(  # pragma: no cover
+            "TOML inline arrays/tables are nested more than the allowed"
+            f" {MAX_INLINE_NESTING} levels"
+        )
+
+    try:
+        char: str | None = src[pos]
+    except IndexError:
+        char = None
+
+    # IMPORTANT: order conditions based on speed of checking and likelihood
+
+    # Basic strings
+    if char == '"':
+        if src.startswith('"""', pos):
+            return parse_multiline_str(src, pos, literal=False)
+        return parse_one_line_basic_str(src, pos)
+
+    # Literal strings
+    if char == "'":
+        if src.startswith("'''", pos):
+            return parse_multiline_str(src, pos, literal=True)
+        return parse_literal_str(src, pos)
+
+    # Booleans
+    if char == "t":
+        if src.startswith("true", pos):
+            return pos + 4, True
+    if char == "f":
+        if src.startswith("false", pos):
+            return pos + 5, False
+
+    # Arrays
+    if char == "[":
+        return parse_array(src, pos, parse_float, nest_lvl + 1)
+
+    # Inline tables
+    if char == "{":
+        return parse_inline_table(src, pos, parse_float, nest_lvl + 1)
+
+    # Dates and times
+    datetime_match = RE_DATETIME.match(src, pos)
+    if datetime_match:
+        try:
+            datetime_obj = match_to_datetime(datetime_match)
+        except ValueError as e:
+            raise TOMLDecodeError("Invalid date or datetime", src, pos) from e
+        return datetime_match.end(), datetime_obj
+    localtime_match = RE_LOCALTIME.match(src, pos)
+    if localtime_match:
+        return localtime_match.end(), match_to_localtime(localtime_match)
+
+    # Integers and "normal" floats.
+    # The regex will greedily match any type starting with a decimal
+    # char, so needs to be located after handling of dates and times.
+    number_match = RE_NUMBER.match(src, pos)
+    if number_match:
+        return number_match.end(), match_to_number(number_match, parse_float)
+
+    # Special floats
+    first_three = src[pos : pos + 3]
+    if first_three in {"inf", "nan"}:
+        return pos + 3, parse_float(first_three)
+    first_four = src[pos : pos + 4]
+    if first_four in {"-inf", "+inf", "-nan", "+nan"}:
+        return pos + 4, parse_float(first_four)
+
+    raise TOMLDecodeError("Invalid value", src, pos)
+
+
+def is_unicode_scalar_value(codepoint: int) -> bool:
+    return (0 <= codepoint <= 55295) or (57344 <= codepoint <= 1114111)
+
+
+def make_safe_parse_float(parse_float: ParseFloat) -> ParseFloat:
+    """A decorator to make `parse_float` safe.
+
+    `parse_float` must not return dicts or lists, because these types
+    would be mixed with parsed TOML tables and arrays, thus confusing
+    the parser. The returned decorated callable raises `ValueError`
+    instead of returning illegal types.
+    """
+    # The default `float` callable never returns illegal types. Optimize it.
+    if parse_float is float:
+        return float
+
+    def safe_parse_float(float_str: str) -> Any:
+        float_value = parse_float(float_str)
+        if isinstance(float_value, (dict, list)):
+            raise ValueError("parse_float must not return dicts or lists")
+        return float_value
+
+    return safe_parse_float
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/tomli/_re.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/tomli/_re.py
new file mode 100644
index 0000000..5134866
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/tomli/_re.py
@@ -0,0 +1,112 @@
+# SPDX-License-Identifier: MIT
+# SPDX-FileCopyrightText: 2021 Taneli Hukkinen
+# Licensed to PSF under a Contributor Agreement.
+
+from __future__ import annotations
+
+from datetime import date, datetime, time, timedelta, timezone, tzinfo
+from functools import lru_cache
+import re
+from typing import Any, Final
+
+from ._types import ParseFloat
+
+# E.g.
+# - 00:32:00.999999
+# - 00:32:00
+_TIME_RE_STR: Final = (
+    r"([01][0-9]|2[0-3]):([0-5][0-9]):([0-5][0-9])(?:\.([0-9]{1,6})[0-9]*)?"
+)
+
+RE_NUMBER: Final = re.compile(
+    r"""
+0
+(?:
+    x[0-9A-Fa-f](?:_?[0-9A-Fa-f])*   # hex
+    |
+    b[01](?:_?[01])*                 # bin
+    |
+    o[0-7](?:_?[0-7])*               # oct
+)
+|
+[+-]?(?:0|[1-9](?:_?[0-9])*)         # dec, integer part
+(?P
+    (?:\.[0-9](?:_?[0-9])*)?         # optional fractional part
+    (?:[eE][+-]?[0-9](?:_?[0-9])*)?  # optional exponent part
+)
+""",
+    flags=re.VERBOSE,
+)
+RE_LOCALTIME: Final = re.compile(_TIME_RE_STR)
+RE_DATETIME: Final = re.compile(
+    rf"""
+([0-9]{{4}})-(0[1-9]|1[0-2])-(0[1-9]|[12][0-9]|3[01])  # date, e.g. 1988-10-27
+(?:
+    [Tt ]
+    {_TIME_RE_STR}
+    (?:([Zz])|([+-])([01][0-9]|2[0-3]):([0-5][0-9]))?  # optional time offset
+)?
+""",
+    flags=re.VERBOSE,
+)
+
+
+def match_to_datetime(match: re.Match) -> datetime | date:
+    """Convert a `RE_DATETIME` match to `datetime.datetime` or `datetime.date`.
+
+    Raises ValueError if the match does not correspond to a valid date
+    or datetime.
+    """
+    (
+        year_str,
+        month_str,
+        day_str,
+        hour_str,
+        minute_str,
+        sec_str,
+        micros_str,
+        zulu_time,
+        offset_sign_str,
+        offset_hour_str,
+        offset_minute_str,
+    ) = match.groups()
+    year, month, day = int(year_str), int(month_str), int(day_str)
+    if hour_str is None:
+        return date(year, month, day)
+    hour, minute, sec = int(hour_str), int(minute_str), int(sec_str)
+    micros = int(micros_str.ljust(6, "0")) if micros_str else 0
+    if offset_sign_str:
+        tz: tzinfo | None = cached_tz(
+            offset_hour_str, offset_minute_str, offset_sign_str
+        )
+    elif zulu_time:
+        tz = timezone.utc
+    else:  # local date-time
+        tz = None
+    return datetime(year, month, day, hour, minute, sec, micros, tzinfo=tz)
+
+
+# No need to limit cache size. This is only ever called on input
+# that matched RE_DATETIME, so there is an implicit bound of
+# 24 (hours) * 60 (minutes) * 2 (offset direction) = 2880.
+@lru_cache(maxsize=None)
+def cached_tz(hour_str: str, minute_str: str, sign_str: str) -> timezone:
+    sign = 1 if sign_str == "+" else -1
+    return timezone(
+        timedelta(
+            hours=sign * int(hour_str),
+            minutes=sign * int(minute_str),
+        )
+    )
+
+
+def match_to_localtime(match: re.Match) -> time:
+    hour_str, minute_str, sec_str, micros_str = match.groups()
+    micros = int(micros_str.ljust(6, "0")) if micros_str else 0
+    return time(int(hour_str), int(minute_str), int(sec_str), micros)
+
+
+def match_to_number(match: re.Match, parse_float: ParseFloat) -> Any:
+    if match.group("floatpart"):
+        return parse_float(match.group())
+    return int(match.group(), 0)
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/tomli/_types.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/tomli/_types.py
new file mode 100644
index 0000000..d949412
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/tomli/_types.py
@@ -0,0 +1,10 @@
+# SPDX-License-Identifier: MIT
+# SPDX-FileCopyrightText: 2021 Taneli Hukkinen
+# Licensed to PSF under a Contributor Agreement.
+
+from typing import Any, Callable, Tuple
+
+# Type annotations
+ParseFloat = Callable[[str], Any]
+Key = Tuple[str, ...]
+Pos = int
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/tomli/py.typed b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/tomli/py.typed
new file mode 100644
index 0000000..7632ecf
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/tomli/py.typed
@@ -0,0 +1 @@
+# Marker file for PEP 561
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/truststore/__init__.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/truststore/__init__.py
new file mode 100644
index 0000000..e468bf8
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/truststore/__init__.py
@@ -0,0 +1,36 @@
+"""Verify certificates using native system trust stores"""
+
+import sys as _sys
+
+if _sys.version_info < (3, 10):
+    raise ImportError("truststore requires Python 3.10 or later")
+
+# Detect Python runtimes which don't implement SSLObject.get_unverified_chain() API
+# This API only became public in Python 3.13 but was available in CPython and PyPy since 3.10.
+if _sys.version_info < (3, 13):
+    try:
+        import ssl as _ssl
+    except ImportError:
+        raise ImportError("truststore requires the 'ssl' module")
+    else:
+        _sslmem = _ssl.MemoryBIO()
+        _sslobj = _ssl.create_default_context().wrap_bio(
+            _sslmem,
+            _sslmem,
+        )
+        try:
+            while not hasattr(_sslobj, "get_unverified_chain"):
+                _sslobj = _sslobj._sslobj  # type: ignore[attr-defined]
+        except AttributeError:
+            raise ImportError(
+                "truststore requires peer certificate chain APIs to be available"
+            ) from None
+
+        del _ssl, _sslobj, _sslmem  # noqa: F821
+
+from ._api import SSLContext, extract_from_ssl, inject_into_ssl  # noqa: E402
+
+del _api, _sys  # type: ignore[name-defined] # noqa: F821
+
+__all__ = ["SSLContext", "inject_into_ssl", "extract_from_ssl"]
+__version__ = "0.10.0"
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/truststore/__pycache__/__init__.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/truststore/__pycache__/__init__.cpython-312.pyc
new file mode 100644
index 0000000..940f992
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/truststore/__pycache__/__init__.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/truststore/__pycache__/_api.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/truststore/__pycache__/_api.cpython-312.pyc
new file mode 100644
index 0000000..36fd465
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/truststore/__pycache__/_api.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/truststore/__pycache__/_macos.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/truststore/__pycache__/_macos.cpython-312.pyc
new file mode 100644
index 0000000..3a56612
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/truststore/__pycache__/_macos.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/truststore/__pycache__/_openssl.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/truststore/__pycache__/_openssl.cpython-312.pyc
new file mode 100644
index 0000000..c1ff120
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/truststore/__pycache__/_openssl.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/truststore/__pycache__/_ssl_constants.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/truststore/__pycache__/_ssl_constants.cpython-312.pyc
new file mode 100644
index 0000000..fb51eea
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/truststore/__pycache__/_ssl_constants.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/truststore/__pycache__/_windows.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/truststore/__pycache__/_windows.cpython-312.pyc
new file mode 100644
index 0000000..aa113e6
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/truststore/__pycache__/_windows.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/truststore/_api.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/truststore/_api.py
new file mode 100644
index 0000000..aeb023a
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/truststore/_api.py
@@ -0,0 +1,316 @@
+import os
+import platform
+import socket
+import ssl
+import sys
+import typing
+
+import _ssl  # type: ignore[import-not-found]
+
+from ._ssl_constants import (
+    _original_SSLContext,
+    _original_super_SSLContext,
+    _truststore_SSLContext_dunder_class,
+    _truststore_SSLContext_super_class,
+)
+
+if platform.system() == "Windows":
+    from ._windows import _configure_context, _verify_peercerts_impl
+elif platform.system() == "Darwin":
+    from ._macos import _configure_context, _verify_peercerts_impl
+else:
+    from ._openssl import _configure_context, _verify_peercerts_impl
+
+if typing.TYPE_CHECKING:
+    from pip._vendor.typing_extensions import Buffer
+
+# From typeshed/stdlib/ssl.pyi
+_StrOrBytesPath: typing.TypeAlias = str | bytes | os.PathLike[str] | os.PathLike[bytes]
+_PasswordType: typing.TypeAlias = str | bytes | typing.Callable[[], str | bytes]
+
+
+def inject_into_ssl() -> None:
+    """Injects the :class:`truststore.SSLContext` into the ``ssl``
+    module by replacing :class:`ssl.SSLContext`.
+    """
+    setattr(ssl, "SSLContext", SSLContext)
+    # urllib3 holds on to its own reference of ssl.SSLContext
+    # so we need to replace that reference too.
+    try:
+        import pip._vendor.urllib3.util.ssl_ as urllib3_ssl
+
+        setattr(urllib3_ssl, "SSLContext", SSLContext)
+    except ImportError:
+        pass
+
+
+def extract_from_ssl() -> None:
+    """Restores the :class:`ssl.SSLContext` class to its original state"""
+    setattr(ssl, "SSLContext", _original_SSLContext)
+    try:
+        import pip._vendor.urllib3.util.ssl_ as urllib3_ssl
+
+        urllib3_ssl.SSLContext = _original_SSLContext  # type: ignore[assignment]
+    except ImportError:
+        pass
+
+
+class SSLContext(_truststore_SSLContext_super_class):  # type: ignore[misc]
+    """SSLContext API that uses system certificates on all platforms"""
+
+    @property  # type: ignore[misc]
+    def __class__(self) -> type:
+        # Dirty hack to get around isinstance() checks
+        # for ssl.SSLContext instances in aiohttp/trustme
+        # when using non-CPython implementations.
+        return _truststore_SSLContext_dunder_class or SSLContext
+
+    def __init__(self, protocol: int = None) -> None:  # type: ignore[assignment]
+        self._ctx = _original_SSLContext(protocol)
+
+        class TruststoreSSLObject(ssl.SSLObject):
+            # This object exists because wrap_bio() doesn't
+            # immediately do the handshake so we need to do
+            # certificate verifications after SSLObject.do_handshake()
+
+            def do_handshake(self) -> None:
+                ret = super().do_handshake()
+                _verify_peercerts(self, server_hostname=self.server_hostname)
+                return ret
+
+        self._ctx.sslobject_class = TruststoreSSLObject
+
+    def wrap_socket(
+        self,
+        sock: socket.socket,
+        server_side: bool = False,
+        do_handshake_on_connect: bool = True,
+        suppress_ragged_eofs: bool = True,
+        server_hostname: str | None = None,
+        session: ssl.SSLSession | None = None,
+    ) -> ssl.SSLSocket:
+        # Use a context manager here because the
+        # inner SSLContext holds on to our state
+        # but also does the actual handshake.
+        with _configure_context(self._ctx):
+            ssl_sock = self._ctx.wrap_socket(
+                sock,
+                server_side=server_side,
+                server_hostname=server_hostname,
+                do_handshake_on_connect=do_handshake_on_connect,
+                suppress_ragged_eofs=suppress_ragged_eofs,
+                session=session,
+            )
+        try:
+            _verify_peercerts(ssl_sock, server_hostname=server_hostname)
+        except Exception:
+            ssl_sock.close()
+            raise
+        return ssl_sock
+
+    def wrap_bio(
+        self,
+        incoming: ssl.MemoryBIO,
+        outgoing: ssl.MemoryBIO,
+        server_side: bool = False,
+        server_hostname: str | None = None,
+        session: ssl.SSLSession | None = None,
+    ) -> ssl.SSLObject:
+        with _configure_context(self._ctx):
+            ssl_obj = self._ctx.wrap_bio(
+                incoming,
+                outgoing,
+                server_hostname=server_hostname,
+                server_side=server_side,
+                session=session,
+            )
+        return ssl_obj
+
+    def load_verify_locations(
+        self,
+        cafile: str | bytes | os.PathLike[str] | os.PathLike[bytes] | None = None,
+        capath: str | bytes | os.PathLike[str] | os.PathLike[bytes] | None = None,
+        cadata: typing.Union[str, "Buffer", None] = None,
+    ) -> None:
+        return self._ctx.load_verify_locations(
+            cafile=cafile, capath=capath, cadata=cadata
+        )
+
+    def load_cert_chain(
+        self,
+        certfile: _StrOrBytesPath,
+        keyfile: _StrOrBytesPath | None = None,
+        password: _PasswordType | None = None,
+    ) -> None:
+        return self._ctx.load_cert_chain(
+            certfile=certfile, keyfile=keyfile, password=password
+        )
+
+    def load_default_certs(
+        self, purpose: ssl.Purpose = ssl.Purpose.SERVER_AUTH
+    ) -> None:
+        return self._ctx.load_default_certs(purpose)
+
+    def set_alpn_protocols(self, alpn_protocols: typing.Iterable[str]) -> None:
+        return self._ctx.set_alpn_protocols(alpn_protocols)
+
+    def set_npn_protocols(self, npn_protocols: typing.Iterable[str]) -> None:
+        return self._ctx.set_npn_protocols(npn_protocols)
+
+    def set_ciphers(self, __cipherlist: str) -> None:
+        return self._ctx.set_ciphers(__cipherlist)
+
+    def get_ciphers(self) -> typing.Any:
+        return self._ctx.get_ciphers()
+
+    def session_stats(self) -> dict[str, int]:
+        return self._ctx.session_stats()
+
+    def cert_store_stats(self) -> dict[str, int]:
+        raise NotImplementedError()
+
+    def set_default_verify_paths(self) -> None:
+        self._ctx.set_default_verify_paths()
+
+    @typing.overload
+    def get_ca_certs(
+        self, binary_form: typing.Literal[False] = ...
+    ) -> list[typing.Any]: ...
+
+    @typing.overload
+    def get_ca_certs(self, binary_form: typing.Literal[True] = ...) -> list[bytes]: ...
+
+    @typing.overload
+    def get_ca_certs(self, binary_form: bool = ...) -> typing.Any: ...
+
+    def get_ca_certs(self, binary_form: bool = False) -> list[typing.Any] | list[bytes]:
+        raise NotImplementedError()
+
+    @property
+    def check_hostname(self) -> bool:
+        return self._ctx.check_hostname
+
+    @check_hostname.setter
+    def check_hostname(self, value: bool) -> None:
+        self._ctx.check_hostname = value
+
+    @property
+    def hostname_checks_common_name(self) -> bool:
+        return self._ctx.hostname_checks_common_name
+
+    @hostname_checks_common_name.setter
+    def hostname_checks_common_name(self, value: bool) -> None:
+        self._ctx.hostname_checks_common_name = value
+
+    @property
+    def keylog_filename(self) -> str:
+        return self._ctx.keylog_filename
+
+    @keylog_filename.setter
+    def keylog_filename(self, value: str) -> None:
+        self._ctx.keylog_filename = value
+
+    @property
+    def maximum_version(self) -> ssl.TLSVersion:
+        return self._ctx.maximum_version
+
+    @maximum_version.setter
+    def maximum_version(self, value: ssl.TLSVersion) -> None:
+        _original_super_SSLContext.maximum_version.__set__(  # type: ignore[attr-defined]
+            self._ctx, value
+        )
+
+    @property
+    def minimum_version(self) -> ssl.TLSVersion:
+        return self._ctx.minimum_version
+
+    @minimum_version.setter
+    def minimum_version(self, value: ssl.TLSVersion) -> None:
+        _original_super_SSLContext.minimum_version.__set__(  # type: ignore[attr-defined]
+            self._ctx, value
+        )
+
+    @property
+    def options(self) -> ssl.Options:
+        return self._ctx.options
+
+    @options.setter
+    def options(self, value: ssl.Options) -> None:
+        _original_super_SSLContext.options.__set__(  # type: ignore[attr-defined]
+            self._ctx, value
+        )
+
+    @property
+    def post_handshake_auth(self) -> bool:
+        return self._ctx.post_handshake_auth
+
+    @post_handshake_auth.setter
+    def post_handshake_auth(self, value: bool) -> None:
+        self._ctx.post_handshake_auth = value
+
+    @property
+    def protocol(self) -> ssl._SSLMethod:
+        return self._ctx.protocol
+
+    @property
+    def security_level(self) -> int:
+        return self._ctx.security_level
+
+    @property
+    def verify_flags(self) -> ssl.VerifyFlags:
+        return self._ctx.verify_flags
+
+    @verify_flags.setter
+    def verify_flags(self, value: ssl.VerifyFlags) -> None:
+        _original_super_SSLContext.verify_flags.__set__(  # type: ignore[attr-defined]
+            self._ctx, value
+        )
+
+    @property
+    def verify_mode(self) -> ssl.VerifyMode:
+        return self._ctx.verify_mode
+
+    @verify_mode.setter
+    def verify_mode(self, value: ssl.VerifyMode) -> None:
+        _original_super_SSLContext.verify_mode.__set__(  # type: ignore[attr-defined]
+            self._ctx, value
+        )
+
+
+# Python 3.13+ makes get_unverified_chain() a public API that only returns DER
+# encoded certificates. We detect whether we need to call public_bytes() for 3.10->3.12
+# Pre-3.13 returned None instead of an empty list from get_unverified_chain()
+if sys.version_info >= (3, 13):
+
+    def _get_unverified_chain_bytes(sslobj: ssl.SSLObject) -> list[bytes]:
+        unverified_chain = sslobj.get_unverified_chain() or ()  # type: ignore[attr-defined]
+        return [
+            cert if isinstance(cert, bytes) else cert.public_bytes(_ssl.ENCODING_DER)
+            for cert in unverified_chain
+        ]
+
+else:
+
+    def _get_unverified_chain_bytes(sslobj: ssl.SSLObject) -> list[bytes]:
+        unverified_chain = sslobj.get_unverified_chain() or ()  # type: ignore[attr-defined]
+        return [cert.public_bytes(_ssl.ENCODING_DER) for cert in unverified_chain]
+
+
+def _verify_peercerts(
+    sock_or_sslobj: ssl.SSLSocket | ssl.SSLObject, server_hostname: str | None
+) -> None:
+    """
+    Verifies the peer certificates from an SSLSocket or SSLObject
+    against the certificates in the OS trust store.
+    """
+    sslobj: ssl.SSLObject = sock_or_sslobj  # type: ignore[assignment]
+    try:
+        while not hasattr(sslobj, "get_unverified_chain"):
+            sslobj = sslobj._sslobj  # type: ignore[attr-defined]
+    except AttributeError:
+        pass
+
+    cert_bytes = _get_unverified_chain_bytes(sslobj)
+    _verify_peercerts_impl(
+        sock_or_sslobj.context, cert_bytes, server_hostname=server_hostname
+    )
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/truststore/_macos.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/truststore/_macos.py
new file mode 100644
index 0000000..3450307
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/truststore/_macos.py
@@ -0,0 +1,571 @@
+import contextlib
+import ctypes
+import platform
+import ssl
+import typing
+from ctypes import (
+    CDLL,
+    POINTER,
+    c_bool,
+    c_char_p,
+    c_int32,
+    c_long,
+    c_uint32,
+    c_ulong,
+    c_void_p,
+)
+from ctypes.util import find_library
+
+from ._ssl_constants import _set_ssl_context_verify_mode
+
+_mac_version = platform.mac_ver()[0]
+_mac_version_info = tuple(map(int, _mac_version.split(".")))
+if _mac_version_info < (10, 8):
+    raise ImportError(
+        f"Only OS X 10.8 and newer are supported, not {_mac_version_info[0]}.{_mac_version_info[1]}"
+    )
+
+_is_macos_version_10_14_or_later = _mac_version_info >= (10, 14)
+
+
+def _load_cdll(name: str, macos10_16_path: str) -> CDLL:
+    """Loads a CDLL by name, falling back to known path on 10.16+"""
+    try:
+        # Big Sur is technically 11 but we use 10.16 due to the Big Sur
+        # beta being labeled as 10.16.
+        path: str | None
+        if _mac_version_info >= (10, 16):
+            path = macos10_16_path
+        else:
+            path = find_library(name)
+        if not path:
+            raise OSError  # Caught and reraised as 'ImportError'
+        return CDLL(path, use_errno=True)
+    except OSError:
+        raise ImportError(f"The library {name} failed to load") from None
+
+
+Security = _load_cdll(
+    "Security", "/System/Library/Frameworks/Security.framework/Security"
+)
+CoreFoundation = _load_cdll(
+    "CoreFoundation",
+    "/System/Library/Frameworks/CoreFoundation.framework/CoreFoundation",
+)
+
+Boolean = c_bool
+CFIndex = c_long
+CFStringEncoding = c_uint32
+CFData = c_void_p
+CFString = c_void_p
+CFArray = c_void_p
+CFMutableArray = c_void_p
+CFError = c_void_p
+CFType = c_void_p
+CFTypeID = c_ulong
+CFTypeRef = POINTER(CFType)
+CFAllocatorRef = c_void_p
+
+OSStatus = c_int32
+
+CFErrorRef = POINTER(CFError)
+CFDataRef = POINTER(CFData)
+CFStringRef = POINTER(CFString)
+CFArrayRef = POINTER(CFArray)
+CFMutableArrayRef = POINTER(CFMutableArray)
+CFArrayCallBacks = c_void_p
+CFOptionFlags = c_uint32
+
+SecCertificateRef = POINTER(c_void_p)
+SecPolicyRef = POINTER(c_void_p)
+SecTrustRef = POINTER(c_void_p)
+SecTrustResultType = c_uint32
+SecTrustOptionFlags = c_uint32
+
+try:
+    Security.SecCertificateCreateWithData.argtypes = [CFAllocatorRef, CFDataRef]
+    Security.SecCertificateCreateWithData.restype = SecCertificateRef
+
+    Security.SecCertificateCopyData.argtypes = [SecCertificateRef]
+    Security.SecCertificateCopyData.restype = CFDataRef
+
+    Security.SecCopyErrorMessageString.argtypes = [OSStatus, c_void_p]
+    Security.SecCopyErrorMessageString.restype = CFStringRef
+
+    Security.SecTrustSetAnchorCertificates.argtypes = [SecTrustRef, CFArrayRef]
+    Security.SecTrustSetAnchorCertificates.restype = OSStatus
+
+    Security.SecTrustSetAnchorCertificatesOnly.argtypes = [SecTrustRef, Boolean]
+    Security.SecTrustSetAnchorCertificatesOnly.restype = OSStatus
+
+    Security.SecPolicyCreateRevocation.argtypes = [CFOptionFlags]
+    Security.SecPolicyCreateRevocation.restype = SecPolicyRef
+
+    Security.SecPolicyCreateSSL.argtypes = [Boolean, CFStringRef]
+    Security.SecPolicyCreateSSL.restype = SecPolicyRef
+
+    Security.SecTrustCreateWithCertificates.argtypes = [
+        CFTypeRef,
+        CFTypeRef,
+        POINTER(SecTrustRef),
+    ]
+    Security.SecTrustCreateWithCertificates.restype = OSStatus
+
+    Security.SecTrustGetTrustResult.argtypes = [
+        SecTrustRef,
+        POINTER(SecTrustResultType),
+    ]
+    Security.SecTrustGetTrustResult.restype = OSStatus
+
+    Security.SecTrustEvaluate.argtypes = [
+        SecTrustRef,
+        POINTER(SecTrustResultType),
+    ]
+    Security.SecTrustEvaluate.restype = OSStatus
+
+    Security.SecTrustRef = SecTrustRef  # type: ignore[attr-defined]
+    Security.SecTrustResultType = SecTrustResultType  # type: ignore[attr-defined]
+    Security.OSStatus = OSStatus  # type: ignore[attr-defined]
+
+    kSecRevocationUseAnyAvailableMethod = 3
+    kSecRevocationRequirePositiveResponse = 8
+
+    CoreFoundation.CFRelease.argtypes = [CFTypeRef]
+    CoreFoundation.CFRelease.restype = None
+
+    CoreFoundation.CFGetTypeID.argtypes = [CFTypeRef]
+    CoreFoundation.CFGetTypeID.restype = CFTypeID
+
+    CoreFoundation.CFStringCreateWithCString.argtypes = [
+        CFAllocatorRef,
+        c_char_p,
+        CFStringEncoding,
+    ]
+    CoreFoundation.CFStringCreateWithCString.restype = CFStringRef
+
+    CoreFoundation.CFStringGetCStringPtr.argtypes = [CFStringRef, CFStringEncoding]
+    CoreFoundation.CFStringGetCStringPtr.restype = c_char_p
+
+    CoreFoundation.CFStringGetCString.argtypes = [
+        CFStringRef,
+        c_char_p,
+        CFIndex,
+        CFStringEncoding,
+    ]
+    CoreFoundation.CFStringGetCString.restype = c_bool
+
+    CoreFoundation.CFDataCreate.argtypes = [CFAllocatorRef, c_char_p, CFIndex]
+    CoreFoundation.CFDataCreate.restype = CFDataRef
+
+    CoreFoundation.CFDataGetLength.argtypes = [CFDataRef]
+    CoreFoundation.CFDataGetLength.restype = CFIndex
+
+    CoreFoundation.CFDataGetBytePtr.argtypes = [CFDataRef]
+    CoreFoundation.CFDataGetBytePtr.restype = c_void_p
+
+    CoreFoundation.CFArrayCreate.argtypes = [
+        CFAllocatorRef,
+        POINTER(CFTypeRef),
+        CFIndex,
+        CFArrayCallBacks,
+    ]
+    CoreFoundation.CFArrayCreate.restype = CFArrayRef
+
+    CoreFoundation.CFArrayCreateMutable.argtypes = [
+        CFAllocatorRef,
+        CFIndex,
+        CFArrayCallBacks,
+    ]
+    CoreFoundation.CFArrayCreateMutable.restype = CFMutableArrayRef
+
+    CoreFoundation.CFArrayAppendValue.argtypes = [CFMutableArrayRef, c_void_p]
+    CoreFoundation.CFArrayAppendValue.restype = None
+
+    CoreFoundation.CFArrayGetCount.argtypes = [CFArrayRef]
+    CoreFoundation.CFArrayGetCount.restype = CFIndex
+
+    CoreFoundation.CFArrayGetValueAtIndex.argtypes = [CFArrayRef, CFIndex]
+    CoreFoundation.CFArrayGetValueAtIndex.restype = c_void_p
+
+    CoreFoundation.CFErrorGetCode.argtypes = [CFErrorRef]
+    CoreFoundation.CFErrorGetCode.restype = CFIndex
+
+    CoreFoundation.CFErrorCopyDescription.argtypes = [CFErrorRef]
+    CoreFoundation.CFErrorCopyDescription.restype = CFStringRef
+
+    CoreFoundation.kCFAllocatorDefault = CFAllocatorRef.in_dll(  # type: ignore[attr-defined]
+        CoreFoundation, "kCFAllocatorDefault"
+    )
+    CoreFoundation.kCFTypeArrayCallBacks = c_void_p.in_dll(  # type: ignore[attr-defined]
+        CoreFoundation, "kCFTypeArrayCallBacks"
+    )
+
+    CoreFoundation.CFTypeRef = CFTypeRef  # type: ignore[attr-defined]
+    CoreFoundation.CFArrayRef = CFArrayRef  # type: ignore[attr-defined]
+    CoreFoundation.CFStringRef = CFStringRef  # type: ignore[attr-defined]
+    CoreFoundation.CFErrorRef = CFErrorRef  # type: ignore[attr-defined]
+
+except AttributeError as e:
+    raise ImportError(f"Error initializing ctypes: {e}") from None
+
+# SecTrustEvaluateWithError is macOS 10.14+
+if _is_macos_version_10_14_or_later:
+    try:
+        Security.SecTrustEvaluateWithError.argtypes = [
+            SecTrustRef,
+            POINTER(CFErrorRef),
+        ]
+        Security.SecTrustEvaluateWithError.restype = c_bool
+    except AttributeError as e:
+        raise ImportError(f"Error initializing ctypes: {e}") from None
+
+
+def _handle_osstatus(result: OSStatus, _: typing.Any, args: typing.Any) -> typing.Any:
+    """
+    Raises an error if the OSStatus value is non-zero.
+    """
+    if int(result) == 0:
+        return args
+
+    # Returns a CFString which we need to transform
+    # into a UTF-8 Python string.
+    error_message_cfstring = None
+    try:
+        error_message_cfstring = Security.SecCopyErrorMessageString(result, None)
+
+        # First step is convert the CFString into a C string pointer.
+        # We try the fast no-copy way first.
+        error_message_cfstring_c_void_p = ctypes.cast(
+            error_message_cfstring, ctypes.POINTER(ctypes.c_void_p)
+        )
+        message = CoreFoundation.CFStringGetCStringPtr(
+            error_message_cfstring_c_void_p, CFConst.kCFStringEncodingUTF8
+        )
+
+        # Quoting the Apple dev docs:
+        #
+        # "A pointer to a C string or NULL if the internal
+        # storage of theString does not allow this to be
+        # returned efficiently."
+        #
+        # So we need to get our hands dirty.
+        if message is None:
+            buffer = ctypes.create_string_buffer(1024)
+            result = CoreFoundation.CFStringGetCString(
+                error_message_cfstring_c_void_p,
+                buffer,
+                1024,
+                CFConst.kCFStringEncodingUTF8,
+            )
+            if not result:
+                raise OSError("Error copying C string from CFStringRef")
+            message = buffer.value
+
+    finally:
+        if error_message_cfstring is not None:
+            CoreFoundation.CFRelease(error_message_cfstring)
+
+    # If no message can be found for this status we come
+    # up with a generic one that forwards the status code.
+    if message is None or message == "":
+        message = f"SecureTransport operation returned a non-zero OSStatus: {result}"
+
+    raise ssl.SSLError(message)
+
+
+Security.SecTrustCreateWithCertificates.errcheck = _handle_osstatus  # type: ignore[assignment]
+Security.SecTrustSetAnchorCertificates.errcheck = _handle_osstatus  # type: ignore[assignment]
+Security.SecTrustSetAnchorCertificatesOnly.errcheck = _handle_osstatus  # type: ignore[assignment]
+Security.SecTrustGetTrustResult.errcheck = _handle_osstatus  # type: ignore[assignment]
+Security.SecTrustEvaluate.errcheck = _handle_osstatus  # type: ignore[assignment]
+
+
+class CFConst:
+    """CoreFoundation constants"""
+
+    kCFStringEncodingUTF8 = CFStringEncoding(0x08000100)
+
+    errSecIncompleteCertRevocationCheck = -67635
+    errSecHostNameMismatch = -67602
+    errSecCertificateExpired = -67818
+    errSecNotTrusted = -67843
+
+
+def _bytes_to_cf_data_ref(value: bytes) -> CFDataRef:  # type: ignore[valid-type]
+    return CoreFoundation.CFDataCreate(  # type: ignore[no-any-return]
+        CoreFoundation.kCFAllocatorDefault, value, len(value)
+    )
+
+
+def _bytes_to_cf_string(value: bytes) -> CFString:
+    """
+    Given a Python binary data, create a CFString.
+    The string must be CFReleased by the caller.
+    """
+    c_str = ctypes.c_char_p(value)
+    cf_str = CoreFoundation.CFStringCreateWithCString(
+        CoreFoundation.kCFAllocatorDefault,
+        c_str,
+        CFConst.kCFStringEncodingUTF8,
+    )
+    return cf_str  # type: ignore[no-any-return]
+
+
+def _cf_string_ref_to_str(cf_string_ref: CFStringRef) -> str | None:  # type: ignore[valid-type]
+    """
+    Creates a Unicode string from a CFString object. Used entirely for error
+    reporting.
+    Yes, it annoys me quite a lot that this function is this complex.
+    """
+
+    string = CoreFoundation.CFStringGetCStringPtr(
+        cf_string_ref, CFConst.kCFStringEncodingUTF8
+    )
+    if string is None:
+        buffer = ctypes.create_string_buffer(1024)
+        result = CoreFoundation.CFStringGetCString(
+            cf_string_ref, buffer, 1024, CFConst.kCFStringEncodingUTF8
+        )
+        if not result:
+            raise OSError("Error copying C string from CFStringRef")
+        string = buffer.value
+    if string is not None:
+        string = string.decode("utf-8")
+    return string  # type: ignore[no-any-return]
+
+
+def _der_certs_to_cf_cert_array(certs: list[bytes]) -> CFMutableArrayRef:  # type: ignore[valid-type]
+    """Builds a CFArray of SecCertificateRefs from a list of DER-encoded certificates.
+    Responsibility of the caller to call CoreFoundation.CFRelease on the CFArray.
+    """
+    cf_array = CoreFoundation.CFArrayCreateMutable(
+        CoreFoundation.kCFAllocatorDefault,
+        0,
+        ctypes.byref(CoreFoundation.kCFTypeArrayCallBacks),
+    )
+    if not cf_array:
+        raise MemoryError("Unable to allocate memory!")
+
+    for cert_data in certs:
+        cf_data = None
+        sec_cert_ref = None
+        try:
+            cf_data = _bytes_to_cf_data_ref(cert_data)
+            sec_cert_ref = Security.SecCertificateCreateWithData(
+                CoreFoundation.kCFAllocatorDefault, cf_data
+            )
+            CoreFoundation.CFArrayAppendValue(cf_array, sec_cert_ref)
+        finally:
+            if cf_data:
+                CoreFoundation.CFRelease(cf_data)
+            if sec_cert_ref:
+                CoreFoundation.CFRelease(sec_cert_ref)
+
+    return cf_array  # type: ignore[no-any-return]
+
+
+@contextlib.contextmanager
+def _configure_context(ctx: ssl.SSLContext) -> typing.Iterator[None]:
+    check_hostname = ctx.check_hostname
+    verify_mode = ctx.verify_mode
+    ctx.check_hostname = False
+    _set_ssl_context_verify_mode(ctx, ssl.CERT_NONE)
+    try:
+        yield
+    finally:
+        ctx.check_hostname = check_hostname
+        _set_ssl_context_verify_mode(ctx, verify_mode)
+
+
+def _verify_peercerts_impl(
+    ssl_context: ssl.SSLContext,
+    cert_chain: list[bytes],
+    server_hostname: str | None = None,
+) -> None:
+    certs = None
+    policies = None
+    trust = None
+    try:
+        # Only set a hostname on the policy if we're verifying the hostname
+        # on the leaf certificate.
+        if server_hostname is not None and ssl_context.check_hostname:
+            cf_str_hostname = None
+            try:
+                cf_str_hostname = _bytes_to_cf_string(server_hostname.encode("ascii"))
+                ssl_policy = Security.SecPolicyCreateSSL(True, cf_str_hostname)
+            finally:
+                if cf_str_hostname:
+                    CoreFoundation.CFRelease(cf_str_hostname)
+        else:
+            ssl_policy = Security.SecPolicyCreateSSL(True, None)
+
+        policies = ssl_policy
+        if ssl_context.verify_flags & ssl.VERIFY_CRL_CHECK_CHAIN:
+            # Add explicit policy requiring positive revocation checks
+            policies = CoreFoundation.CFArrayCreateMutable(
+                CoreFoundation.kCFAllocatorDefault,
+                0,
+                ctypes.byref(CoreFoundation.kCFTypeArrayCallBacks),
+            )
+            CoreFoundation.CFArrayAppendValue(policies, ssl_policy)
+            CoreFoundation.CFRelease(ssl_policy)
+            revocation_policy = Security.SecPolicyCreateRevocation(
+                kSecRevocationUseAnyAvailableMethod
+                | kSecRevocationRequirePositiveResponse
+            )
+            CoreFoundation.CFArrayAppendValue(policies, revocation_policy)
+            CoreFoundation.CFRelease(revocation_policy)
+        elif ssl_context.verify_flags & ssl.VERIFY_CRL_CHECK_LEAF:
+            raise NotImplementedError("VERIFY_CRL_CHECK_LEAF not implemented for macOS")
+
+        certs = None
+        try:
+            certs = _der_certs_to_cf_cert_array(cert_chain)
+
+            # Now that we have certificates loaded and a SecPolicy
+            # we can finally create a SecTrust object!
+            trust = Security.SecTrustRef()
+            Security.SecTrustCreateWithCertificates(
+                certs, policies, ctypes.byref(trust)
+            )
+
+        finally:
+            # The certs are now being held by SecTrust so we can
+            # release our handles for the array.
+            if certs:
+                CoreFoundation.CFRelease(certs)
+
+        # If there are additional trust anchors to load we need to transform
+        # the list of DER-encoded certificates into a CFArray.
+        ctx_ca_certs_der: list[bytes] | None = ssl_context.get_ca_certs(
+            binary_form=True
+        )
+        if ctx_ca_certs_der:
+            ctx_ca_certs = None
+            try:
+                ctx_ca_certs = _der_certs_to_cf_cert_array(ctx_ca_certs_der)
+                Security.SecTrustSetAnchorCertificates(trust, ctx_ca_certs)
+            finally:
+                if ctx_ca_certs:
+                    CoreFoundation.CFRelease(ctx_ca_certs)
+
+        # We always want system certificates.
+        Security.SecTrustSetAnchorCertificatesOnly(trust, False)
+
+        # macOS 10.13 and earlier don't support SecTrustEvaluateWithError()
+        # so we use SecTrustEvaluate() which means we need to construct error
+        # messages ourselves.
+        if _is_macos_version_10_14_or_later:
+            _verify_peercerts_impl_macos_10_14(ssl_context, trust)
+        else:
+            _verify_peercerts_impl_macos_10_13(ssl_context, trust)
+    finally:
+        if policies:
+            CoreFoundation.CFRelease(policies)
+        if trust:
+            CoreFoundation.CFRelease(trust)
+
+
+def _verify_peercerts_impl_macos_10_13(
+    ssl_context: ssl.SSLContext, sec_trust_ref: typing.Any
+) -> None:
+    """Verify using 'SecTrustEvaluate' API for macOS 10.13 and earlier.
+    macOS 10.14 added the 'SecTrustEvaluateWithError' API.
+    """
+    sec_trust_result_type = Security.SecTrustResultType()
+    Security.SecTrustEvaluate(sec_trust_ref, ctypes.byref(sec_trust_result_type))
+
+    try:
+        sec_trust_result_type_as_int = int(sec_trust_result_type.value)
+    except (ValueError, TypeError):
+        sec_trust_result_type_as_int = -1
+
+    # Apple doesn't document these values in their own API docs.
+    # See: https://github.com/xybp888/iOS-SDKs/blob/master/iPhoneOS13.0.sdk/System/Library/Frameworks/Security.framework/Headers/SecTrust.h#L84
+    if (
+        ssl_context.verify_mode == ssl.CERT_REQUIRED
+        and sec_trust_result_type_as_int not in (1, 4)
+    ):
+        # Note that we're not able to ignore only hostname errors
+        # for macOS 10.13 and earlier, so check_hostname=False will
+        # still return an error.
+        sec_trust_result_type_to_message = {
+            0: "Invalid trust result type",
+            # 1: "Trust evaluation succeeded",
+            2: "User confirmation required",
+            3: "User specified that certificate is not trusted",
+            # 4: "Trust result is unspecified",
+            5: "Recoverable trust failure occurred",
+            6: "Fatal trust failure occurred",
+            7: "Other error occurred, certificate may be revoked",
+        }
+        error_message = sec_trust_result_type_to_message.get(
+            sec_trust_result_type_as_int,
+            f"Unknown trust result: {sec_trust_result_type_as_int}",
+        )
+
+        err = ssl.SSLCertVerificationError(error_message)
+        err.verify_message = error_message
+        err.verify_code = sec_trust_result_type_as_int
+        raise err
+
+
+def _verify_peercerts_impl_macos_10_14(
+    ssl_context: ssl.SSLContext, sec_trust_ref: typing.Any
+) -> None:
+    """Verify using 'SecTrustEvaluateWithError' API for macOS 10.14+."""
+    cf_error = CoreFoundation.CFErrorRef()
+    sec_trust_eval_result = Security.SecTrustEvaluateWithError(
+        sec_trust_ref, ctypes.byref(cf_error)
+    )
+    # sec_trust_eval_result is a bool (0 or 1)
+    # where 1 means that the certs are trusted.
+    if sec_trust_eval_result == 1:
+        is_trusted = True
+    elif sec_trust_eval_result == 0:
+        is_trusted = False
+    else:
+        raise ssl.SSLError(
+            f"Unknown result from Security.SecTrustEvaluateWithError: {sec_trust_eval_result!r}"
+        )
+
+    cf_error_code = 0
+    if not is_trusted:
+        cf_error_code = CoreFoundation.CFErrorGetCode(cf_error)
+
+        # If the error is a known failure that we're
+        # explicitly okay with from SSLContext configuration
+        # we can set is_trusted accordingly.
+        if ssl_context.verify_mode != ssl.CERT_REQUIRED and (
+            cf_error_code == CFConst.errSecNotTrusted
+            or cf_error_code == CFConst.errSecCertificateExpired
+        ):
+            is_trusted = True
+
+    # If we're still not trusted then we start to
+    # construct and raise the SSLCertVerificationError.
+    if not is_trusted:
+        cf_error_string_ref = None
+        try:
+            cf_error_string_ref = CoreFoundation.CFErrorCopyDescription(cf_error)
+
+            # Can this ever return 'None' if there's a CFError?
+            cf_error_message = (
+                _cf_string_ref_to_str(cf_error_string_ref)
+                or "Certificate verification failed"
+            )
+
+            # TODO: Not sure if we need the SecTrustResultType for anything?
+            # We only care whether or not it's a success or failure for now.
+            sec_trust_result_type = Security.SecTrustResultType()
+            Security.SecTrustGetTrustResult(
+                sec_trust_ref, ctypes.byref(sec_trust_result_type)
+            )
+
+            err = ssl.SSLCertVerificationError(cf_error_message)
+            err.verify_message = cf_error_message
+            err.verify_code = cf_error_code
+            raise err
+        finally:
+            if cf_error_string_ref:
+                CoreFoundation.CFRelease(cf_error_string_ref)
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/truststore/_openssl.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/truststore/_openssl.py
new file mode 100644
index 0000000..9951cf7
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/truststore/_openssl.py
@@ -0,0 +1,66 @@
+import contextlib
+import os
+import re
+import ssl
+import typing
+
+# candidates based on https://github.com/tiran/certifi-system-store by Christian Heimes
+_CA_FILE_CANDIDATES = [
+    # Alpine, Arch, Fedora 34+, OpenWRT, RHEL 9+, BSD
+    "/etc/ssl/cert.pem",
+    # Fedora <= 34, RHEL <= 9, CentOS <= 9
+    "/etc/pki/tls/cert.pem",
+    # Debian, Ubuntu (requires ca-certificates)
+    "/etc/ssl/certs/ca-certificates.crt",
+    # SUSE
+    "/etc/ssl/ca-bundle.pem",
+]
+
+_HASHED_CERT_FILENAME_RE = re.compile(r"^[0-9a-fA-F]{8}\.[0-9]$")
+
+
+@contextlib.contextmanager
+def _configure_context(ctx: ssl.SSLContext) -> typing.Iterator[None]:
+    # First, check whether the default locations from OpenSSL
+    # seem like they will give us a usable set of CA certs.
+    # ssl.get_default_verify_paths already takes care of:
+    # - getting cafile from either the SSL_CERT_FILE env var
+    #   or the path configured when OpenSSL was compiled,
+    #   and verifying that that path exists
+    # - getting capath from either the SSL_CERT_DIR env var
+    #   or the path configured when OpenSSL was compiled,
+    #   and verifying that that path exists
+    # In addition we'll check whether capath appears to contain certs.
+    defaults = ssl.get_default_verify_paths()
+    if defaults.cafile or (defaults.capath and _capath_contains_certs(defaults.capath)):
+        ctx.set_default_verify_paths()
+    else:
+        # cafile from OpenSSL doesn't exist
+        # and capath from OpenSSL doesn't contain certs.
+        # Let's search other common locations instead.
+        for cafile in _CA_FILE_CANDIDATES:
+            if os.path.isfile(cafile):
+                ctx.load_verify_locations(cafile=cafile)
+                break
+
+    yield
+
+
+def _capath_contains_certs(capath: str) -> bool:
+    """Check whether capath exists and contains certs in the expected format."""
+    if not os.path.isdir(capath):
+        return False
+    for name in os.listdir(capath):
+        if _HASHED_CERT_FILENAME_RE.match(name):
+            return True
+    return False
+
+
+def _verify_peercerts_impl(
+    ssl_context: ssl.SSLContext,
+    cert_chain: list[bytes],
+    server_hostname: str | None = None,
+) -> None:
+    # This is a no-op because we've enabled SSLContext's built-in
+    # verification via verify_mode=CERT_REQUIRED, and don't need to repeat it.
+    pass
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/truststore/_ssl_constants.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/truststore/_ssl_constants.py
new file mode 100644
index 0000000..b1ee7a3
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/truststore/_ssl_constants.py
@@ -0,0 +1,31 @@
+import ssl
+import sys
+import typing
+
+# Hold on to the original class so we can create it consistently
+# even if we inject our own SSLContext into the ssl module.
+_original_SSLContext = ssl.SSLContext
+_original_super_SSLContext = super(_original_SSLContext, _original_SSLContext)
+
+# CPython is known to be good, but non-CPython implementations
+# may implement SSLContext differently so to be safe we don't
+# subclass the SSLContext.
+
+# This is returned by truststore.SSLContext.__class__()
+_truststore_SSLContext_dunder_class: typing.Optional[type]
+
+# This value is the superclass of truststore.SSLContext.
+_truststore_SSLContext_super_class: type
+
+if sys.implementation.name == "cpython":
+    _truststore_SSLContext_super_class = _original_SSLContext
+    _truststore_SSLContext_dunder_class = None
+else:
+    _truststore_SSLContext_super_class = object
+    _truststore_SSLContext_dunder_class = _original_SSLContext
+
+
+def _set_ssl_context_verify_mode(
+    ssl_context: ssl.SSLContext, verify_mode: ssl.VerifyMode
+) -> None:
+    _original_super_SSLContext.verify_mode.__set__(ssl_context, verify_mode)  # type: ignore[attr-defined]
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/truststore/_windows.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/truststore/_windows.py
new file mode 100644
index 0000000..a9bf9ab
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/truststore/_windows.py
@@ -0,0 +1,567 @@
+import contextlib
+import ssl
+import typing
+from ctypes import WinDLL  # type: ignore
+from ctypes import WinError  # type: ignore
+from ctypes import (
+    POINTER,
+    Structure,
+    c_char_p,
+    c_ulong,
+    c_void_p,
+    c_wchar_p,
+    cast,
+    create_unicode_buffer,
+    pointer,
+    sizeof,
+)
+from ctypes.wintypes import (
+    BOOL,
+    DWORD,
+    HANDLE,
+    LONG,
+    LPCSTR,
+    LPCVOID,
+    LPCWSTR,
+    LPFILETIME,
+    LPSTR,
+    LPWSTR,
+)
+from typing import TYPE_CHECKING, Any
+
+from ._ssl_constants import _set_ssl_context_verify_mode
+
+HCERTCHAINENGINE = HANDLE
+HCERTSTORE = HANDLE
+HCRYPTPROV_LEGACY = HANDLE
+
+
+class CERT_CONTEXT(Structure):
+    _fields_ = (
+        ("dwCertEncodingType", DWORD),
+        ("pbCertEncoded", c_void_p),
+        ("cbCertEncoded", DWORD),
+        ("pCertInfo", c_void_p),
+        ("hCertStore", HCERTSTORE),
+    )
+
+
+PCERT_CONTEXT = POINTER(CERT_CONTEXT)
+PCCERT_CONTEXT = POINTER(PCERT_CONTEXT)
+
+
+class CERT_ENHKEY_USAGE(Structure):
+    _fields_ = (
+        ("cUsageIdentifier", DWORD),
+        ("rgpszUsageIdentifier", POINTER(LPSTR)),
+    )
+
+
+PCERT_ENHKEY_USAGE = POINTER(CERT_ENHKEY_USAGE)
+
+
+class CERT_USAGE_MATCH(Structure):
+    _fields_ = (
+        ("dwType", DWORD),
+        ("Usage", CERT_ENHKEY_USAGE),
+    )
+
+
+class CERT_CHAIN_PARA(Structure):
+    _fields_ = (
+        ("cbSize", DWORD),
+        ("RequestedUsage", CERT_USAGE_MATCH),
+        ("RequestedIssuancePolicy", CERT_USAGE_MATCH),
+        ("dwUrlRetrievalTimeout", DWORD),
+        ("fCheckRevocationFreshnessTime", BOOL),
+        ("dwRevocationFreshnessTime", DWORD),
+        ("pftCacheResync", LPFILETIME),
+        ("pStrongSignPara", c_void_p),
+        ("dwStrongSignFlags", DWORD),
+    )
+
+
+if TYPE_CHECKING:
+    PCERT_CHAIN_PARA = pointer[CERT_CHAIN_PARA]  # type: ignore[misc]
+else:
+    PCERT_CHAIN_PARA = POINTER(CERT_CHAIN_PARA)
+
+
+class CERT_TRUST_STATUS(Structure):
+    _fields_ = (
+        ("dwErrorStatus", DWORD),
+        ("dwInfoStatus", DWORD),
+    )
+
+
+class CERT_CHAIN_ELEMENT(Structure):
+    _fields_ = (
+        ("cbSize", DWORD),
+        ("pCertContext", PCERT_CONTEXT),
+        ("TrustStatus", CERT_TRUST_STATUS),
+        ("pRevocationInfo", c_void_p),
+        ("pIssuanceUsage", PCERT_ENHKEY_USAGE),
+        ("pApplicationUsage", PCERT_ENHKEY_USAGE),
+        ("pwszExtendedErrorInfo", LPCWSTR),
+    )
+
+
+PCERT_CHAIN_ELEMENT = POINTER(CERT_CHAIN_ELEMENT)
+
+
+class CERT_SIMPLE_CHAIN(Structure):
+    _fields_ = (
+        ("cbSize", DWORD),
+        ("TrustStatus", CERT_TRUST_STATUS),
+        ("cElement", DWORD),
+        ("rgpElement", POINTER(PCERT_CHAIN_ELEMENT)),
+        ("pTrustListInfo", c_void_p),
+        ("fHasRevocationFreshnessTime", BOOL),
+        ("dwRevocationFreshnessTime", DWORD),
+    )
+
+
+PCERT_SIMPLE_CHAIN = POINTER(CERT_SIMPLE_CHAIN)
+
+
+class CERT_CHAIN_CONTEXT(Structure):
+    _fields_ = (
+        ("cbSize", DWORD),
+        ("TrustStatus", CERT_TRUST_STATUS),
+        ("cChain", DWORD),
+        ("rgpChain", POINTER(PCERT_SIMPLE_CHAIN)),
+        ("cLowerQualityChainContext", DWORD),
+        ("rgpLowerQualityChainContext", c_void_p),
+        ("fHasRevocationFreshnessTime", BOOL),
+        ("dwRevocationFreshnessTime", DWORD),
+    )
+
+
+PCERT_CHAIN_CONTEXT = POINTER(CERT_CHAIN_CONTEXT)
+PCCERT_CHAIN_CONTEXT = POINTER(PCERT_CHAIN_CONTEXT)
+
+
+class SSL_EXTRA_CERT_CHAIN_POLICY_PARA(Structure):
+    _fields_ = (
+        ("cbSize", DWORD),
+        ("dwAuthType", DWORD),
+        ("fdwChecks", DWORD),
+        ("pwszServerName", LPCWSTR),
+    )
+
+
+class CERT_CHAIN_POLICY_PARA(Structure):
+    _fields_ = (
+        ("cbSize", DWORD),
+        ("dwFlags", DWORD),
+        ("pvExtraPolicyPara", c_void_p),
+    )
+
+
+PCERT_CHAIN_POLICY_PARA = POINTER(CERT_CHAIN_POLICY_PARA)
+
+
+class CERT_CHAIN_POLICY_STATUS(Structure):
+    _fields_ = (
+        ("cbSize", DWORD),
+        ("dwError", DWORD),
+        ("lChainIndex", LONG),
+        ("lElementIndex", LONG),
+        ("pvExtraPolicyStatus", c_void_p),
+    )
+
+
+PCERT_CHAIN_POLICY_STATUS = POINTER(CERT_CHAIN_POLICY_STATUS)
+
+
+class CERT_CHAIN_ENGINE_CONFIG(Structure):
+    _fields_ = (
+        ("cbSize", DWORD),
+        ("hRestrictedRoot", HCERTSTORE),
+        ("hRestrictedTrust", HCERTSTORE),
+        ("hRestrictedOther", HCERTSTORE),
+        ("cAdditionalStore", DWORD),
+        ("rghAdditionalStore", c_void_p),
+        ("dwFlags", DWORD),
+        ("dwUrlRetrievalTimeout", DWORD),
+        ("MaximumCachedCertificates", DWORD),
+        ("CycleDetectionModulus", DWORD),
+        ("hExclusiveRoot", HCERTSTORE),
+        ("hExclusiveTrustedPeople", HCERTSTORE),
+        ("dwExclusiveFlags", DWORD),
+    )
+
+
+PCERT_CHAIN_ENGINE_CONFIG = POINTER(CERT_CHAIN_ENGINE_CONFIG)
+PHCERTCHAINENGINE = POINTER(HCERTCHAINENGINE)
+
+X509_ASN_ENCODING = 0x00000001
+PKCS_7_ASN_ENCODING = 0x00010000
+CERT_STORE_PROV_MEMORY = b"Memory"
+CERT_STORE_ADD_USE_EXISTING = 2
+USAGE_MATCH_TYPE_OR = 1
+OID_PKIX_KP_SERVER_AUTH = c_char_p(b"1.3.6.1.5.5.7.3.1")
+CERT_CHAIN_REVOCATION_CHECK_END_CERT = 0x10000000
+CERT_CHAIN_REVOCATION_CHECK_CHAIN = 0x20000000
+CERT_CHAIN_POLICY_IGNORE_ALL_NOT_TIME_VALID_FLAGS = 0x00000007
+CERT_CHAIN_POLICY_IGNORE_INVALID_BASIC_CONSTRAINTS_FLAG = 0x00000008
+CERT_CHAIN_POLICY_ALLOW_UNKNOWN_CA_FLAG = 0x00000010
+CERT_CHAIN_POLICY_IGNORE_INVALID_NAME_FLAG = 0x00000040
+CERT_CHAIN_POLICY_IGNORE_WRONG_USAGE_FLAG = 0x00000020
+CERT_CHAIN_POLICY_IGNORE_INVALID_POLICY_FLAG = 0x00000080
+CERT_CHAIN_POLICY_IGNORE_ALL_REV_UNKNOWN_FLAGS = 0x00000F00
+CERT_CHAIN_POLICY_ALLOW_TESTROOT_FLAG = 0x00008000
+CERT_CHAIN_POLICY_TRUST_TESTROOT_FLAG = 0x00004000
+SECURITY_FLAG_IGNORE_CERT_CN_INVALID = 0x00001000
+AUTHTYPE_SERVER = 2
+CERT_CHAIN_POLICY_SSL = 4
+FORMAT_MESSAGE_FROM_SYSTEM = 0x00001000
+FORMAT_MESSAGE_IGNORE_INSERTS = 0x00000200
+
+# Flags to set for SSLContext.verify_mode=CERT_NONE
+CERT_CHAIN_POLICY_VERIFY_MODE_NONE_FLAGS = (
+    CERT_CHAIN_POLICY_IGNORE_ALL_NOT_TIME_VALID_FLAGS
+    | CERT_CHAIN_POLICY_IGNORE_INVALID_BASIC_CONSTRAINTS_FLAG
+    | CERT_CHAIN_POLICY_ALLOW_UNKNOWN_CA_FLAG
+    | CERT_CHAIN_POLICY_IGNORE_INVALID_NAME_FLAG
+    | CERT_CHAIN_POLICY_IGNORE_WRONG_USAGE_FLAG
+    | CERT_CHAIN_POLICY_IGNORE_INVALID_POLICY_FLAG
+    | CERT_CHAIN_POLICY_IGNORE_ALL_REV_UNKNOWN_FLAGS
+    | CERT_CHAIN_POLICY_ALLOW_TESTROOT_FLAG
+    | CERT_CHAIN_POLICY_TRUST_TESTROOT_FLAG
+)
+
+wincrypt = WinDLL("crypt32.dll")
+kernel32 = WinDLL("kernel32.dll")
+
+
+def _handle_win_error(result: bool, _: Any, args: Any) -> Any:
+    if not result:
+        # Note, actually raises OSError after calling GetLastError and FormatMessage
+        raise WinError()
+    return args
+
+
+CertCreateCertificateChainEngine = wincrypt.CertCreateCertificateChainEngine
+CertCreateCertificateChainEngine.argtypes = (
+    PCERT_CHAIN_ENGINE_CONFIG,
+    PHCERTCHAINENGINE,
+)
+CertCreateCertificateChainEngine.errcheck = _handle_win_error
+
+CertOpenStore = wincrypt.CertOpenStore
+CertOpenStore.argtypes = (LPCSTR, DWORD, HCRYPTPROV_LEGACY, DWORD, c_void_p)
+CertOpenStore.restype = HCERTSTORE
+CertOpenStore.errcheck = _handle_win_error
+
+CertAddEncodedCertificateToStore = wincrypt.CertAddEncodedCertificateToStore
+CertAddEncodedCertificateToStore.argtypes = (
+    HCERTSTORE,
+    DWORD,
+    c_char_p,
+    DWORD,
+    DWORD,
+    PCCERT_CONTEXT,
+)
+CertAddEncodedCertificateToStore.restype = BOOL
+
+CertCreateCertificateContext = wincrypt.CertCreateCertificateContext
+CertCreateCertificateContext.argtypes = (DWORD, c_char_p, DWORD)
+CertCreateCertificateContext.restype = PCERT_CONTEXT
+CertCreateCertificateContext.errcheck = _handle_win_error
+
+CertGetCertificateChain = wincrypt.CertGetCertificateChain
+CertGetCertificateChain.argtypes = (
+    HCERTCHAINENGINE,
+    PCERT_CONTEXT,
+    LPFILETIME,
+    HCERTSTORE,
+    PCERT_CHAIN_PARA,
+    DWORD,
+    c_void_p,
+    PCCERT_CHAIN_CONTEXT,
+)
+CertGetCertificateChain.restype = BOOL
+CertGetCertificateChain.errcheck = _handle_win_error
+
+CertVerifyCertificateChainPolicy = wincrypt.CertVerifyCertificateChainPolicy
+CertVerifyCertificateChainPolicy.argtypes = (
+    c_ulong,
+    PCERT_CHAIN_CONTEXT,
+    PCERT_CHAIN_POLICY_PARA,
+    PCERT_CHAIN_POLICY_STATUS,
+)
+CertVerifyCertificateChainPolicy.restype = BOOL
+
+CertCloseStore = wincrypt.CertCloseStore
+CertCloseStore.argtypes = (HCERTSTORE, DWORD)
+CertCloseStore.restype = BOOL
+CertCloseStore.errcheck = _handle_win_error
+
+CertFreeCertificateChain = wincrypt.CertFreeCertificateChain
+CertFreeCertificateChain.argtypes = (PCERT_CHAIN_CONTEXT,)
+
+CertFreeCertificateContext = wincrypt.CertFreeCertificateContext
+CertFreeCertificateContext.argtypes = (PCERT_CONTEXT,)
+
+CertFreeCertificateChainEngine = wincrypt.CertFreeCertificateChainEngine
+CertFreeCertificateChainEngine.argtypes = (HCERTCHAINENGINE,)
+
+FormatMessageW = kernel32.FormatMessageW
+FormatMessageW.argtypes = (
+    DWORD,
+    LPCVOID,
+    DWORD,
+    DWORD,
+    LPWSTR,
+    DWORD,
+    c_void_p,
+)
+FormatMessageW.restype = DWORD
+
+
+def _verify_peercerts_impl(
+    ssl_context: ssl.SSLContext,
+    cert_chain: list[bytes],
+    server_hostname: str | None = None,
+) -> None:
+    """Verify the cert_chain from the server using Windows APIs."""
+
+    # If the peer didn't send any certificates then
+    # we can't do verification. Raise an error.
+    if not cert_chain:
+        raise ssl.SSLCertVerificationError("Peer sent no certificates to verify")
+
+    pCertContext = None
+    hIntermediateCertStore = CertOpenStore(CERT_STORE_PROV_MEMORY, 0, None, 0, None)
+    try:
+        # Add intermediate certs to an in-memory cert store
+        for cert_bytes in cert_chain[1:]:
+            CertAddEncodedCertificateToStore(
+                hIntermediateCertStore,
+                X509_ASN_ENCODING | PKCS_7_ASN_ENCODING,
+                cert_bytes,
+                len(cert_bytes),
+                CERT_STORE_ADD_USE_EXISTING,
+                None,
+            )
+
+        # Cert context for leaf cert
+        leaf_cert = cert_chain[0]
+        pCertContext = CertCreateCertificateContext(
+            X509_ASN_ENCODING | PKCS_7_ASN_ENCODING, leaf_cert, len(leaf_cert)
+        )
+
+        # Chain params to match certs for serverAuth extended usage
+        cert_enhkey_usage = CERT_ENHKEY_USAGE()
+        cert_enhkey_usage.cUsageIdentifier = 1
+        cert_enhkey_usage.rgpszUsageIdentifier = (c_char_p * 1)(OID_PKIX_KP_SERVER_AUTH)
+        cert_usage_match = CERT_USAGE_MATCH()
+        cert_usage_match.Usage = cert_enhkey_usage
+        chain_params = CERT_CHAIN_PARA()
+        chain_params.RequestedUsage = cert_usage_match
+        chain_params.cbSize = sizeof(chain_params)
+        pChainPara = pointer(chain_params)
+
+        if ssl_context.verify_flags & ssl.VERIFY_CRL_CHECK_CHAIN:
+            chain_flags = CERT_CHAIN_REVOCATION_CHECK_CHAIN
+        elif ssl_context.verify_flags & ssl.VERIFY_CRL_CHECK_LEAF:
+            chain_flags = CERT_CHAIN_REVOCATION_CHECK_END_CERT
+        else:
+            chain_flags = 0
+
+        try:
+            # First attempt to verify using the default Windows system trust roots
+            # (default chain engine).
+            _get_and_verify_cert_chain(
+                ssl_context,
+                None,
+                hIntermediateCertStore,
+                pCertContext,
+                pChainPara,
+                server_hostname,
+                chain_flags=chain_flags,
+            )
+        except ssl.SSLCertVerificationError as e:
+            # If that fails but custom CA certs have been added
+            # to the SSLContext using load_verify_locations,
+            # try verifying using a custom chain engine
+            # that trusts the custom CA certs.
+            custom_ca_certs: list[bytes] | None = ssl_context.get_ca_certs(
+                binary_form=True
+            )
+            if custom_ca_certs:
+                try:
+                    _verify_using_custom_ca_certs(
+                        ssl_context,
+                        custom_ca_certs,
+                        hIntermediateCertStore,
+                        pCertContext,
+                        pChainPara,
+                        server_hostname,
+                        chain_flags=chain_flags,
+                    )
+                # Raise the original error, not the new error.
+                except ssl.SSLCertVerificationError:
+                    raise e from None
+            else:
+                raise
+    finally:
+        CertCloseStore(hIntermediateCertStore, 0)
+        if pCertContext:
+            CertFreeCertificateContext(pCertContext)
+
+
+def _get_and_verify_cert_chain(
+    ssl_context: ssl.SSLContext,
+    hChainEngine: HCERTCHAINENGINE | None,
+    hIntermediateCertStore: HCERTSTORE,
+    pPeerCertContext: c_void_p,
+    pChainPara: PCERT_CHAIN_PARA,  # type: ignore[valid-type]
+    server_hostname: str | None,
+    chain_flags: int,
+) -> None:
+    ppChainContext = None
+    try:
+        # Get cert chain
+        ppChainContext = pointer(PCERT_CHAIN_CONTEXT())
+        CertGetCertificateChain(
+            hChainEngine,  # chain engine
+            pPeerCertContext,  # leaf cert context
+            None,  # current system time
+            hIntermediateCertStore,  # additional in-memory cert store
+            pChainPara,  # chain-building parameters
+            chain_flags,
+            None,  # reserved
+            ppChainContext,  # the resulting chain context
+        )
+        pChainContext = ppChainContext.contents
+
+        # Verify cert chain
+        ssl_extra_cert_chain_policy_para = SSL_EXTRA_CERT_CHAIN_POLICY_PARA()
+        ssl_extra_cert_chain_policy_para.cbSize = sizeof(
+            ssl_extra_cert_chain_policy_para
+        )
+        ssl_extra_cert_chain_policy_para.dwAuthType = AUTHTYPE_SERVER
+        ssl_extra_cert_chain_policy_para.fdwChecks = 0
+        if ssl_context.check_hostname is False:
+            ssl_extra_cert_chain_policy_para.fdwChecks = (
+                SECURITY_FLAG_IGNORE_CERT_CN_INVALID
+            )
+        if server_hostname:
+            ssl_extra_cert_chain_policy_para.pwszServerName = c_wchar_p(server_hostname)
+
+        chain_policy = CERT_CHAIN_POLICY_PARA()
+        chain_policy.pvExtraPolicyPara = cast(
+            pointer(ssl_extra_cert_chain_policy_para), c_void_p
+        )
+        if ssl_context.verify_mode == ssl.CERT_NONE:
+            chain_policy.dwFlags |= CERT_CHAIN_POLICY_VERIFY_MODE_NONE_FLAGS
+        chain_policy.cbSize = sizeof(chain_policy)
+
+        pPolicyPara = pointer(chain_policy)
+        policy_status = CERT_CHAIN_POLICY_STATUS()
+        policy_status.cbSize = sizeof(policy_status)
+        pPolicyStatus = pointer(policy_status)
+        CertVerifyCertificateChainPolicy(
+            CERT_CHAIN_POLICY_SSL,
+            pChainContext,
+            pPolicyPara,
+            pPolicyStatus,
+        )
+
+        # Check status
+        error_code = policy_status.dwError
+        if error_code:
+            # Try getting a human readable message for an error code.
+            error_message_buf = create_unicode_buffer(1024)
+            error_message_chars = FormatMessageW(
+                FORMAT_MESSAGE_FROM_SYSTEM | FORMAT_MESSAGE_IGNORE_INSERTS,
+                None,
+                error_code,
+                0,
+                error_message_buf,
+                sizeof(error_message_buf),
+                None,
+            )
+
+            # See if we received a message for the error,
+            # otherwise we use a generic error with the
+            # error code and hope that it's search-able.
+            if error_message_chars <= 0:
+                error_message = f"Certificate chain policy error {error_code:#x} [{policy_status.lElementIndex}]"
+            else:
+                error_message = error_message_buf.value.strip()
+
+            err = ssl.SSLCertVerificationError(error_message)
+            err.verify_message = error_message
+            err.verify_code = error_code
+            raise err from None
+    finally:
+        if ppChainContext:
+            CertFreeCertificateChain(ppChainContext.contents)
+
+
+def _verify_using_custom_ca_certs(
+    ssl_context: ssl.SSLContext,
+    custom_ca_certs: list[bytes],
+    hIntermediateCertStore: HCERTSTORE,
+    pPeerCertContext: c_void_p,
+    pChainPara: PCERT_CHAIN_PARA,  # type: ignore[valid-type]
+    server_hostname: str | None,
+    chain_flags: int,
+) -> None:
+    hChainEngine = None
+    hRootCertStore = CertOpenStore(CERT_STORE_PROV_MEMORY, 0, None, 0, None)
+    try:
+        # Add custom CA certs to an in-memory cert store
+        for cert_bytes in custom_ca_certs:
+            CertAddEncodedCertificateToStore(
+                hRootCertStore,
+                X509_ASN_ENCODING | PKCS_7_ASN_ENCODING,
+                cert_bytes,
+                len(cert_bytes),
+                CERT_STORE_ADD_USE_EXISTING,
+                None,
+            )
+
+        # Create a custom cert chain engine which exclusively trusts
+        # certs from our hRootCertStore
+        cert_chain_engine_config = CERT_CHAIN_ENGINE_CONFIG()
+        cert_chain_engine_config.cbSize = sizeof(cert_chain_engine_config)
+        cert_chain_engine_config.hExclusiveRoot = hRootCertStore
+        pConfig = pointer(cert_chain_engine_config)
+        phChainEngine = pointer(HCERTCHAINENGINE())
+        CertCreateCertificateChainEngine(
+            pConfig,
+            phChainEngine,
+        )
+        hChainEngine = phChainEngine.contents
+
+        # Get and verify a cert chain using the custom chain engine
+        _get_and_verify_cert_chain(
+            ssl_context,
+            hChainEngine,
+            hIntermediateCertStore,
+            pPeerCertContext,
+            pChainPara,
+            server_hostname,
+            chain_flags,
+        )
+    finally:
+        if hChainEngine:
+            CertFreeCertificateChainEngine(hChainEngine)
+        CertCloseStore(hRootCertStore, 0)
+
+
+@contextlib.contextmanager
+def _configure_context(ctx: ssl.SSLContext) -> typing.Iterator[None]:
+    check_hostname = ctx.check_hostname
+    verify_mode = ctx.verify_mode
+    ctx.check_hostname = False
+    _set_ssl_context_verify_mode(ctx, ssl.CERT_NONE)
+    try:
+        yield
+    finally:
+        ctx.check_hostname = check_hostname
+        _set_ssl_context_verify_mode(ctx, verify_mode)
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/truststore/py.typed b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/truststore/py.typed
new file mode 100644
index 0000000..e69de29
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/typing_extensions.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/typing_extensions.py
new file mode 100644
index 0000000..e429384
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/typing_extensions.py
@@ -0,0 +1,3641 @@
+import abc
+import collections
+import collections.abc
+import contextlib
+import functools
+import inspect
+import operator
+import sys
+import types as _types
+import typing
+import warnings
+
+__all__ = [
+    # Super-special typing primitives.
+    'Any',
+    'ClassVar',
+    'Concatenate',
+    'Final',
+    'LiteralString',
+    'ParamSpec',
+    'ParamSpecArgs',
+    'ParamSpecKwargs',
+    'Self',
+    'Type',
+    'TypeVar',
+    'TypeVarTuple',
+    'Unpack',
+
+    # ABCs (from collections.abc).
+    'Awaitable',
+    'AsyncIterator',
+    'AsyncIterable',
+    'Coroutine',
+    'AsyncGenerator',
+    'AsyncContextManager',
+    'Buffer',
+    'ChainMap',
+
+    # Concrete collection types.
+    'ContextManager',
+    'Counter',
+    'Deque',
+    'DefaultDict',
+    'NamedTuple',
+    'OrderedDict',
+    'TypedDict',
+
+    # Structural checks, a.k.a. protocols.
+    'SupportsAbs',
+    'SupportsBytes',
+    'SupportsComplex',
+    'SupportsFloat',
+    'SupportsIndex',
+    'SupportsInt',
+    'SupportsRound',
+
+    # One-off things.
+    'Annotated',
+    'assert_never',
+    'assert_type',
+    'clear_overloads',
+    'dataclass_transform',
+    'deprecated',
+    'Doc',
+    'get_overloads',
+    'final',
+    'get_args',
+    'get_origin',
+    'get_original_bases',
+    'get_protocol_members',
+    'get_type_hints',
+    'IntVar',
+    'is_protocol',
+    'is_typeddict',
+    'Literal',
+    'NewType',
+    'overload',
+    'override',
+    'Protocol',
+    'reveal_type',
+    'runtime',
+    'runtime_checkable',
+    'Text',
+    'TypeAlias',
+    'TypeAliasType',
+    'TypeGuard',
+    'TypeIs',
+    'TYPE_CHECKING',
+    'Never',
+    'NoReturn',
+    'ReadOnly',
+    'Required',
+    'NotRequired',
+
+    # Pure aliases, have always been in typing
+    'AbstractSet',
+    'AnyStr',
+    'BinaryIO',
+    'Callable',
+    'Collection',
+    'Container',
+    'Dict',
+    'ForwardRef',
+    'FrozenSet',
+    'Generator',
+    'Generic',
+    'Hashable',
+    'IO',
+    'ItemsView',
+    'Iterable',
+    'Iterator',
+    'KeysView',
+    'List',
+    'Mapping',
+    'MappingView',
+    'Match',
+    'MutableMapping',
+    'MutableSequence',
+    'MutableSet',
+    'NoDefault',
+    'Optional',
+    'Pattern',
+    'Reversible',
+    'Sequence',
+    'Set',
+    'Sized',
+    'TextIO',
+    'Tuple',
+    'Union',
+    'ValuesView',
+    'cast',
+    'no_type_check',
+    'no_type_check_decorator',
+]
+
+# for backward compatibility
+PEP_560 = True
+GenericMeta = type
+_PEP_696_IMPLEMENTED = sys.version_info >= (3, 13, 0, "beta")
+
+# The functions below are modified copies of typing internal helpers.
+# They are needed by _ProtocolMeta and they provide support for PEP 646.
+
+
+class _Sentinel:
+    def __repr__(self):
+        return ""
+
+
+_marker = _Sentinel()
+
+
+if sys.version_info >= (3, 10):
+    def _should_collect_from_parameters(t):
+        return isinstance(
+            t, (typing._GenericAlias, _types.GenericAlias, _types.UnionType)
+        )
+elif sys.version_info >= (3, 9):
+    def _should_collect_from_parameters(t):
+        return isinstance(t, (typing._GenericAlias, _types.GenericAlias))
+else:
+    def _should_collect_from_parameters(t):
+        return isinstance(t, typing._GenericAlias) and not t._special
+
+
+NoReturn = typing.NoReturn
+
+# Some unconstrained type variables.  These are used by the container types.
+# (These are not for export.)
+T = typing.TypeVar('T')  # Any type.
+KT = typing.TypeVar('KT')  # Key type.
+VT = typing.TypeVar('VT')  # Value type.
+T_co = typing.TypeVar('T_co', covariant=True)  # Any type covariant containers.
+T_contra = typing.TypeVar('T_contra', contravariant=True)  # Ditto contravariant.
+
+
+if sys.version_info >= (3, 11):
+    from typing import Any
+else:
+
+    class _AnyMeta(type):
+        def __instancecheck__(self, obj):
+            if self is Any:
+                raise TypeError("typing_extensions.Any cannot be used with isinstance()")
+            return super().__instancecheck__(obj)
+
+        def __repr__(self):
+            if self is Any:
+                return "typing_extensions.Any"
+            return super().__repr__()
+
+    class Any(metaclass=_AnyMeta):
+        """Special type indicating an unconstrained type.
+        - Any is compatible with every type.
+        - Any assumed to have all methods.
+        - All values assumed to be instances of Any.
+        Note that all the above statements are true from the point of view of
+        static type checkers. At runtime, Any should not be used with instance
+        checks.
+        """
+        def __new__(cls, *args, **kwargs):
+            if cls is Any:
+                raise TypeError("Any cannot be instantiated")
+            return super().__new__(cls, *args, **kwargs)
+
+
+ClassVar = typing.ClassVar
+
+
+class _ExtensionsSpecialForm(typing._SpecialForm, _root=True):
+    def __repr__(self):
+        return 'typing_extensions.' + self._name
+
+
+Final = typing.Final
+
+if sys.version_info >= (3, 11):
+    final = typing.final
+else:
+    # @final exists in 3.8+, but we backport it for all versions
+    # before 3.11 to keep support for the __final__ attribute.
+    # See https://bugs.python.org/issue46342
+    def final(f):
+        """This decorator can be used to indicate to type checkers that
+        the decorated method cannot be overridden, and decorated class
+        cannot be subclassed. For example:
+
+            class Base:
+                @final
+                def done(self) -> None:
+                    ...
+            class Sub(Base):
+                def done(self) -> None:  # Error reported by type checker
+                    ...
+            @final
+            class Leaf:
+                ...
+            class Other(Leaf):  # Error reported by type checker
+                ...
+
+        There is no runtime checking of these properties. The decorator
+        sets the ``__final__`` attribute to ``True`` on the decorated object
+        to allow runtime introspection.
+        """
+        try:
+            f.__final__ = True
+        except (AttributeError, TypeError):
+            # Skip the attribute silently if it is not writable.
+            # AttributeError happens if the object has __slots__ or a
+            # read-only property, TypeError if it's a builtin class.
+            pass
+        return f
+
+
+def IntVar(name):
+    return typing.TypeVar(name)
+
+
+# A Literal bug was fixed in 3.11.0, 3.10.1 and 3.9.8
+if sys.version_info >= (3, 10, 1):
+    Literal = typing.Literal
+else:
+    def _flatten_literal_params(parameters):
+        """An internal helper for Literal creation: flatten Literals among parameters"""
+        params = []
+        for p in parameters:
+            if isinstance(p, _LiteralGenericAlias):
+                params.extend(p.__args__)
+            else:
+                params.append(p)
+        return tuple(params)
+
+    def _value_and_type_iter(params):
+        for p in params:
+            yield p, type(p)
+
+    class _LiteralGenericAlias(typing._GenericAlias, _root=True):
+        def __eq__(self, other):
+            if not isinstance(other, _LiteralGenericAlias):
+                return NotImplemented
+            these_args_deduped = set(_value_and_type_iter(self.__args__))
+            other_args_deduped = set(_value_and_type_iter(other.__args__))
+            return these_args_deduped == other_args_deduped
+
+        def __hash__(self):
+            return hash(frozenset(_value_and_type_iter(self.__args__)))
+
+    class _LiteralForm(_ExtensionsSpecialForm, _root=True):
+        def __init__(self, doc: str):
+            self._name = 'Literal'
+            self._doc = self.__doc__ = doc
+
+        def __getitem__(self, parameters):
+            if not isinstance(parameters, tuple):
+                parameters = (parameters,)
+
+            parameters = _flatten_literal_params(parameters)
+
+            val_type_pairs = list(_value_and_type_iter(parameters))
+            try:
+                deduped_pairs = set(val_type_pairs)
+            except TypeError:
+                # unhashable parameters
+                pass
+            else:
+                # similar logic to typing._deduplicate on Python 3.9+
+                if len(deduped_pairs) < len(val_type_pairs):
+                    new_parameters = []
+                    for pair in val_type_pairs:
+                        if pair in deduped_pairs:
+                            new_parameters.append(pair[0])
+                            deduped_pairs.remove(pair)
+                    assert not deduped_pairs, deduped_pairs
+                    parameters = tuple(new_parameters)
+
+            return _LiteralGenericAlias(self, parameters)
+
+    Literal = _LiteralForm(doc="""\
+                           A type that can be used to indicate to type checkers
+                           that the corresponding value has a value literally equivalent
+                           to the provided parameter. For example:
+
+                               var: Literal[4] = 4
+
+                           The type checker understands that 'var' is literally equal to
+                           the value 4 and no other value.
+
+                           Literal[...] cannot be subclassed. There is no runtime
+                           checking verifying that the parameter is actually a value
+                           instead of a type.""")
+
+
+_overload_dummy = typing._overload_dummy
+
+
+if hasattr(typing, "get_overloads"):  # 3.11+
+    overload = typing.overload
+    get_overloads = typing.get_overloads
+    clear_overloads = typing.clear_overloads
+else:
+    # {module: {qualname: {firstlineno: func}}}
+    _overload_registry = collections.defaultdict(
+        functools.partial(collections.defaultdict, dict)
+    )
+
+    def overload(func):
+        """Decorator for overloaded functions/methods.
+
+        In a stub file, place two or more stub definitions for the same
+        function in a row, each decorated with @overload.  For example:
+
+        @overload
+        def utf8(value: None) -> None: ...
+        @overload
+        def utf8(value: bytes) -> bytes: ...
+        @overload
+        def utf8(value: str) -> bytes: ...
+
+        In a non-stub file (i.e. a regular .py file), do the same but
+        follow it with an implementation.  The implementation should *not*
+        be decorated with @overload.  For example:
+
+        @overload
+        def utf8(value: None) -> None: ...
+        @overload
+        def utf8(value: bytes) -> bytes: ...
+        @overload
+        def utf8(value: str) -> bytes: ...
+        def utf8(value):
+            # implementation goes here
+
+        The overloads for a function can be retrieved at runtime using the
+        get_overloads() function.
+        """
+        # classmethod and staticmethod
+        f = getattr(func, "__func__", func)
+        try:
+            _overload_registry[f.__module__][f.__qualname__][
+                f.__code__.co_firstlineno
+            ] = func
+        except AttributeError:
+            # Not a normal function; ignore.
+            pass
+        return _overload_dummy
+
+    def get_overloads(func):
+        """Return all defined overloads for *func* as a sequence."""
+        # classmethod and staticmethod
+        f = getattr(func, "__func__", func)
+        if f.__module__ not in _overload_registry:
+            return []
+        mod_dict = _overload_registry[f.__module__]
+        if f.__qualname__ not in mod_dict:
+            return []
+        return list(mod_dict[f.__qualname__].values())
+
+    def clear_overloads():
+        """Clear all overloads in the registry."""
+        _overload_registry.clear()
+
+
+# This is not a real generic class.  Don't use outside annotations.
+Type = typing.Type
+
+# Various ABCs mimicking those in collections.abc.
+# A few are simply re-exported for completeness.
+Awaitable = typing.Awaitable
+Coroutine = typing.Coroutine
+AsyncIterable = typing.AsyncIterable
+AsyncIterator = typing.AsyncIterator
+Deque = typing.Deque
+DefaultDict = typing.DefaultDict
+OrderedDict = typing.OrderedDict
+Counter = typing.Counter
+ChainMap = typing.ChainMap
+Text = typing.Text
+TYPE_CHECKING = typing.TYPE_CHECKING
+
+
+if sys.version_info >= (3, 13, 0, "beta"):
+    from typing import AsyncContextManager, AsyncGenerator, ContextManager, Generator
+else:
+    def _is_dunder(attr):
+        return attr.startswith('__') and attr.endswith('__')
+
+    # Python <3.9 doesn't have typing._SpecialGenericAlias
+    _special_generic_alias_base = getattr(
+        typing, "_SpecialGenericAlias", typing._GenericAlias
+    )
+
+    class _SpecialGenericAlias(_special_generic_alias_base, _root=True):
+        def __init__(self, origin, nparams, *, inst=True, name=None, defaults=()):
+            if _special_generic_alias_base is typing._GenericAlias:
+                # Python <3.9
+                self.__origin__ = origin
+                self._nparams = nparams
+                super().__init__(origin, nparams, special=True, inst=inst, name=name)
+            else:
+                # Python >= 3.9
+                super().__init__(origin, nparams, inst=inst, name=name)
+            self._defaults = defaults
+
+        def __setattr__(self, attr, val):
+            allowed_attrs = {'_name', '_inst', '_nparams', '_defaults'}
+            if _special_generic_alias_base is typing._GenericAlias:
+                # Python <3.9
+                allowed_attrs.add("__origin__")
+            if _is_dunder(attr) or attr in allowed_attrs:
+                object.__setattr__(self, attr, val)
+            else:
+                setattr(self.__origin__, attr, val)
+
+        @typing._tp_cache
+        def __getitem__(self, params):
+            if not isinstance(params, tuple):
+                params = (params,)
+            msg = "Parameters to generic types must be types."
+            params = tuple(typing._type_check(p, msg) for p in params)
+            if (
+                self._defaults
+                and len(params) < self._nparams
+                and len(params) + len(self._defaults) >= self._nparams
+            ):
+                params = (*params, *self._defaults[len(params) - self._nparams:])
+            actual_len = len(params)
+
+            if actual_len != self._nparams:
+                if self._defaults:
+                    expected = f"at least {self._nparams - len(self._defaults)}"
+                else:
+                    expected = str(self._nparams)
+                if not self._nparams:
+                    raise TypeError(f"{self} is not a generic class")
+                raise TypeError(
+                    f"Too {'many' if actual_len > self._nparams else 'few'}"
+                    f" arguments for {self};"
+                    f" actual {actual_len}, expected {expected}"
+                )
+            return self.copy_with(params)
+
+    _NoneType = type(None)
+    Generator = _SpecialGenericAlias(
+        collections.abc.Generator, 3, defaults=(_NoneType, _NoneType)
+    )
+    AsyncGenerator = _SpecialGenericAlias(
+        collections.abc.AsyncGenerator, 2, defaults=(_NoneType,)
+    )
+    ContextManager = _SpecialGenericAlias(
+        contextlib.AbstractContextManager,
+        2,
+        name="ContextManager",
+        defaults=(typing.Optional[bool],)
+    )
+    AsyncContextManager = _SpecialGenericAlias(
+        contextlib.AbstractAsyncContextManager,
+        2,
+        name="AsyncContextManager",
+        defaults=(typing.Optional[bool],)
+    )
+
+
+_PROTO_ALLOWLIST = {
+    'collections.abc': [
+        'Callable', 'Awaitable', 'Iterable', 'Iterator', 'AsyncIterable',
+        'Hashable', 'Sized', 'Container', 'Collection', 'Reversible', 'Buffer',
+    ],
+    'contextlib': ['AbstractContextManager', 'AbstractAsyncContextManager'],
+    'typing_extensions': ['Buffer'],
+}
+
+
+_EXCLUDED_ATTRS = frozenset(typing.EXCLUDED_ATTRIBUTES) | {
+    "__match_args__", "__protocol_attrs__", "__non_callable_proto_members__",
+    "__final__",
+}
+
+
+def _get_protocol_attrs(cls):
+    attrs = set()
+    for base in cls.__mro__[:-1]:  # without object
+        if base.__name__ in {'Protocol', 'Generic'}:
+            continue
+        annotations = getattr(base, '__annotations__', {})
+        for attr in (*base.__dict__, *annotations):
+            if (not attr.startswith('_abc_') and attr not in _EXCLUDED_ATTRS):
+                attrs.add(attr)
+    return attrs
+
+
+def _caller(depth=2):
+    try:
+        return sys._getframe(depth).f_globals.get('__name__', '__main__')
+    except (AttributeError, ValueError):  # For platforms without _getframe()
+        return None
+
+
+# `__match_args__` attribute was removed from protocol members in 3.13,
+# we want to backport this change to older Python versions.
+if sys.version_info >= (3, 13):
+    Protocol = typing.Protocol
+else:
+    def _allow_reckless_class_checks(depth=3):
+        """Allow instance and class checks for special stdlib modules.
+        The abc and functools modules indiscriminately call isinstance() and
+        issubclass() on the whole MRO of a user class, which may contain protocols.
+        """
+        return _caller(depth) in {'abc', 'functools', None}
+
+    def _no_init(self, *args, **kwargs):
+        if type(self)._is_protocol:
+            raise TypeError('Protocols cannot be instantiated')
+
+    def _type_check_issubclass_arg_1(arg):
+        """Raise TypeError if `arg` is not an instance of `type`
+        in `issubclass(arg, )`.
+
+        In most cases, this is verified by type.__subclasscheck__.
+        Checking it again unnecessarily would slow down issubclass() checks,
+        so, we don't perform this check unless we absolutely have to.
+
+        For various error paths, however,
+        we want to ensure that *this* error message is shown to the user
+        where relevant, rather than a typing.py-specific error message.
+        """
+        if not isinstance(arg, type):
+            # Same error message as for issubclass(1, int).
+            raise TypeError('issubclass() arg 1 must be a class')
+
+    # Inheriting from typing._ProtocolMeta isn't actually desirable,
+    # but is necessary to allow typing.Protocol and typing_extensions.Protocol
+    # to mix without getting TypeErrors about "metaclass conflict"
+    class _ProtocolMeta(type(typing.Protocol)):
+        # This metaclass is somewhat unfortunate,
+        # but is necessary for several reasons...
+        #
+        # NOTE: DO NOT call super() in any methods in this class
+        # That would call the methods on typing._ProtocolMeta on Python 3.8-3.11
+        # and those are slow
+        def __new__(mcls, name, bases, namespace, **kwargs):
+            if name == "Protocol" and len(bases) < 2:
+                pass
+            elif {Protocol, typing.Protocol} & set(bases):
+                for base in bases:
+                    if not (
+                        base in {object, typing.Generic, Protocol, typing.Protocol}
+                        or base.__name__ in _PROTO_ALLOWLIST.get(base.__module__, [])
+                        or is_protocol(base)
+                    ):
+                        raise TypeError(
+                            f"Protocols can only inherit from other protocols, "
+                            f"got {base!r}"
+                        )
+            return abc.ABCMeta.__new__(mcls, name, bases, namespace, **kwargs)
+
+        def __init__(cls, *args, **kwargs):
+            abc.ABCMeta.__init__(cls, *args, **kwargs)
+            if getattr(cls, "_is_protocol", False):
+                cls.__protocol_attrs__ = _get_protocol_attrs(cls)
+
+        def __subclasscheck__(cls, other):
+            if cls is Protocol:
+                return type.__subclasscheck__(cls, other)
+            if (
+                getattr(cls, '_is_protocol', False)
+                and not _allow_reckless_class_checks()
+            ):
+                if not getattr(cls, '_is_runtime_protocol', False):
+                    _type_check_issubclass_arg_1(other)
+                    raise TypeError(
+                        "Instance and class checks can only be used with "
+                        "@runtime_checkable protocols"
+                    )
+                if (
+                    # this attribute is set by @runtime_checkable:
+                    cls.__non_callable_proto_members__
+                    and cls.__dict__.get("__subclasshook__") is _proto_hook
+                ):
+                    _type_check_issubclass_arg_1(other)
+                    non_method_attrs = sorted(cls.__non_callable_proto_members__)
+                    raise TypeError(
+                        "Protocols with non-method members don't support issubclass()."
+                        f" Non-method members: {str(non_method_attrs)[1:-1]}."
+                    )
+            return abc.ABCMeta.__subclasscheck__(cls, other)
+
+        def __instancecheck__(cls, instance):
+            # We need this method for situations where attributes are
+            # assigned in __init__.
+            if cls is Protocol:
+                return type.__instancecheck__(cls, instance)
+            if not getattr(cls, "_is_protocol", False):
+                # i.e., it's a concrete subclass of a protocol
+                return abc.ABCMeta.__instancecheck__(cls, instance)
+
+            if (
+                not getattr(cls, '_is_runtime_protocol', False) and
+                not _allow_reckless_class_checks()
+            ):
+                raise TypeError("Instance and class checks can only be used with"
+                                " @runtime_checkable protocols")
+
+            if abc.ABCMeta.__instancecheck__(cls, instance):
+                return True
+
+            for attr in cls.__protocol_attrs__:
+                try:
+                    val = inspect.getattr_static(instance, attr)
+                except AttributeError:
+                    break
+                # this attribute is set by @runtime_checkable:
+                if val is None and attr not in cls.__non_callable_proto_members__:
+                    break
+            else:
+                return True
+
+            return False
+
+        def __eq__(cls, other):
+            # Hack so that typing.Generic.__class_getitem__
+            # treats typing_extensions.Protocol
+            # as equivalent to typing.Protocol
+            if abc.ABCMeta.__eq__(cls, other) is True:
+                return True
+            return cls is Protocol and other is typing.Protocol
+
+        # This has to be defined, or the abc-module cache
+        # complains about classes with this metaclass being unhashable,
+        # if we define only __eq__!
+        def __hash__(cls) -> int:
+            return type.__hash__(cls)
+
+    @classmethod
+    def _proto_hook(cls, other):
+        if not cls.__dict__.get('_is_protocol', False):
+            return NotImplemented
+
+        for attr in cls.__protocol_attrs__:
+            for base in other.__mro__:
+                # Check if the members appears in the class dictionary...
+                if attr in base.__dict__:
+                    if base.__dict__[attr] is None:
+                        return NotImplemented
+                    break
+
+                # ...or in annotations, if it is a sub-protocol.
+                annotations = getattr(base, '__annotations__', {})
+                if (
+                    isinstance(annotations, collections.abc.Mapping)
+                    and attr in annotations
+                    and is_protocol(other)
+                ):
+                    break
+            else:
+                return NotImplemented
+        return True
+
+    class Protocol(typing.Generic, metaclass=_ProtocolMeta):
+        __doc__ = typing.Protocol.__doc__
+        __slots__ = ()
+        _is_protocol = True
+        _is_runtime_protocol = False
+
+        def __init_subclass__(cls, *args, **kwargs):
+            super().__init_subclass__(*args, **kwargs)
+
+            # Determine if this is a protocol or a concrete subclass.
+            if not cls.__dict__.get('_is_protocol', False):
+                cls._is_protocol = any(b is Protocol for b in cls.__bases__)
+
+            # Set (or override) the protocol subclass hook.
+            if '__subclasshook__' not in cls.__dict__:
+                cls.__subclasshook__ = _proto_hook
+
+            # Prohibit instantiation for protocol classes
+            if cls._is_protocol and cls.__init__ is Protocol.__init__:
+                cls.__init__ = _no_init
+
+
+if sys.version_info >= (3, 13):
+    runtime_checkable = typing.runtime_checkable
+else:
+    def runtime_checkable(cls):
+        """Mark a protocol class as a runtime protocol.
+
+        Such protocol can be used with isinstance() and issubclass().
+        Raise TypeError if applied to a non-protocol class.
+        This allows a simple-minded structural check very similar to
+        one trick ponies in collections.abc such as Iterable.
+
+        For example::
+
+            @runtime_checkable
+            class Closable(Protocol):
+                def close(self): ...
+
+            assert isinstance(open('/some/file'), Closable)
+
+        Warning: this will check only the presence of the required methods,
+        not their type signatures!
+        """
+        if not issubclass(cls, typing.Generic) or not getattr(cls, '_is_protocol', False):
+            raise TypeError(f'@runtime_checkable can be only applied to protocol classes,'
+                            f' got {cls!r}')
+        cls._is_runtime_protocol = True
+
+        # typing.Protocol classes on <=3.11 break if we execute this block,
+        # because typing.Protocol classes on <=3.11 don't have a
+        # `__protocol_attrs__` attribute, and this block relies on the
+        # `__protocol_attrs__` attribute. Meanwhile, typing.Protocol classes on 3.12.2+
+        # break if we *don't* execute this block, because *they* assume that all
+        # protocol classes have a `__non_callable_proto_members__` attribute
+        # (which this block sets)
+        if isinstance(cls, _ProtocolMeta) or sys.version_info >= (3, 12, 2):
+            # PEP 544 prohibits using issubclass()
+            # with protocols that have non-method members.
+            # See gh-113320 for why we compute this attribute here,
+            # rather than in `_ProtocolMeta.__init__`
+            cls.__non_callable_proto_members__ = set()
+            for attr in cls.__protocol_attrs__:
+                try:
+                    is_callable = callable(getattr(cls, attr, None))
+                except Exception as e:
+                    raise TypeError(
+                        f"Failed to determine whether protocol member {attr!r} "
+                        "is a method member"
+                    ) from e
+                else:
+                    if not is_callable:
+                        cls.__non_callable_proto_members__.add(attr)
+
+        return cls
+
+
+# The "runtime" alias exists for backwards compatibility.
+runtime = runtime_checkable
+
+
+# Our version of runtime-checkable protocols is faster on Python 3.8-3.11
+if sys.version_info >= (3, 12):
+    SupportsInt = typing.SupportsInt
+    SupportsFloat = typing.SupportsFloat
+    SupportsComplex = typing.SupportsComplex
+    SupportsBytes = typing.SupportsBytes
+    SupportsIndex = typing.SupportsIndex
+    SupportsAbs = typing.SupportsAbs
+    SupportsRound = typing.SupportsRound
+else:
+    @runtime_checkable
+    class SupportsInt(Protocol):
+        """An ABC with one abstract method __int__."""
+        __slots__ = ()
+
+        @abc.abstractmethod
+        def __int__(self) -> int:
+            pass
+
+    @runtime_checkable
+    class SupportsFloat(Protocol):
+        """An ABC with one abstract method __float__."""
+        __slots__ = ()
+
+        @abc.abstractmethod
+        def __float__(self) -> float:
+            pass
+
+    @runtime_checkable
+    class SupportsComplex(Protocol):
+        """An ABC with one abstract method __complex__."""
+        __slots__ = ()
+
+        @abc.abstractmethod
+        def __complex__(self) -> complex:
+            pass
+
+    @runtime_checkable
+    class SupportsBytes(Protocol):
+        """An ABC with one abstract method __bytes__."""
+        __slots__ = ()
+
+        @abc.abstractmethod
+        def __bytes__(self) -> bytes:
+            pass
+
+    @runtime_checkable
+    class SupportsIndex(Protocol):
+        __slots__ = ()
+
+        @abc.abstractmethod
+        def __index__(self) -> int:
+            pass
+
+    @runtime_checkable
+    class SupportsAbs(Protocol[T_co]):
+        """
+        An ABC with one abstract method __abs__ that is covariant in its return type.
+        """
+        __slots__ = ()
+
+        @abc.abstractmethod
+        def __abs__(self) -> T_co:
+            pass
+
+    @runtime_checkable
+    class SupportsRound(Protocol[T_co]):
+        """
+        An ABC with one abstract method __round__ that is covariant in its return type.
+        """
+        __slots__ = ()
+
+        @abc.abstractmethod
+        def __round__(self, ndigits: int = 0) -> T_co:
+            pass
+
+
+def _ensure_subclassable(mro_entries):
+    def inner(func):
+        if sys.implementation.name == "pypy" and sys.version_info < (3, 9):
+            cls_dict = {
+                "__call__": staticmethod(func),
+                "__mro_entries__": staticmethod(mro_entries)
+            }
+            t = type(func.__name__, (), cls_dict)
+            return functools.update_wrapper(t(), func)
+        else:
+            func.__mro_entries__ = mro_entries
+            return func
+    return inner
+
+
+# Update this to something like >=3.13.0b1 if and when
+# PEP 728 is implemented in CPython
+_PEP_728_IMPLEMENTED = False
+
+if _PEP_728_IMPLEMENTED:
+    # The standard library TypedDict in Python 3.8 does not store runtime information
+    # about which (if any) keys are optional.  See https://bugs.python.org/issue38834
+    # The standard library TypedDict in Python 3.9.0/1 does not honour the "total"
+    # keyword with old-style TypedDict().  See https://bugs.python.org/issue42059
+    # The standard library TypedDict below Python 3.11 does not store runtime
+    # information about optional and required keys when using Required or NotRequired.
+    # Generic TypedDicts are also impossible using typing.TypedDict on Python <3.11.
+    # Aaaand on 3.12 we add __orig_bases__ to TypedDict
+    # to enable better runtime introspection.
+    # On 3.13 we deprecate some odd ways of creating TypedDicts.
+    # Also on 3.13, PEP 705 adds the ReadOnly[] qualifier.
+    # PEP 728 (still pending) makes more changes.
+    TypedDict = typing.TypedDict
+    _TypedDictMeta = typing._TypedDictMeta
+    is_typeddict = typing.is_typeddict
+else:
+    # 3.10.0 and later
+    _TAKES_MODULE = "module" in inspect.signature(typing._type_check).parameters
+
+    def _get_typeddict_qualifiers(annotation_type):
+        while True:
+            annotation_origin = get_origin(annotation_type)
+            if annotation_origin is Annotated:
+                annotation_args = get_args(annotation_type)
+                if annotation_args:
+                    annotation_type = annotation_args[0]
+                else:
+                    break
+            elif annotation_origin is Required:
+                yield Required
+                annotation_type, = get_args(annotation_type)
+            elif annotation_origin is NotRequired:
+                yield NotRequired
+                annotation_type, = get_args(annotation_type)
+            elif annotation_origin is ReadOnly:
+                yield ReadOnly
+                annotation_type, = get_args(annotation_type)
+            else:
+                break
+
+    class _TypedDictMeta(type):
+        def __new__(cls, name, bases, ns, *, total=True, closed=False):
+            """Create new typed dict class object.
+
+            This method is called when TypedDict is subclassed,
+            or when TypedDict is instantiated. This way
+            TypedDict supports all three syntax forms described in its docstring.
+            Subclasses and instances of TypedDict return actual dictionaries.
+            """
+            for base in bases:
+                if type(base) is not _TypedDictMeta and base is not typing.Generic:
+                    raise TypeError('cannot inherit from both a TypedDict type '
+                                    'and a non-TypedDict base class')
+
+            if any(issubclass(b, typing.Generic) for b in bases):
+                generic_base = (typing.Generic,)
+            else:
+                generic_base = ()
+
+            # typing.py generally doesn't let you inherit from plain Generic, unless
+            # the name of the class happens to be "Protocol"
+            tp_dict = type.__new__(_TypedDictMeta, "Protocol", (*generic_base, dict), ns)
+            tp_dict.__name__ = name
+            if tp_dict.__qualname__ == "Protocol":
+                tp_dict.__qualname__ = name
+
+            if not hasattr(tp_dict, '__orig_bases__'):
+                tp_dict.__orig_bases__ = bases
+
+            annotations = {}
+            if "__annotations__" in ns:
+                own_annotations = ns["__annotations__"]
+            elif "__annotate__" in ns:
+                # TODO: Use inspect.VALUE here, and make the annotations lazily evaluated
+                own_annotations = ns["__annotate__"](1)
+            else:
+                own_annotations = {}
+            msg = "TypedDict('Name', {f0: t0, f1: t1, ...}); each t must be a type"
+            if _TAKES_MODULE:
+                own_annotations = {
+                    n: typing._type_check(tp, msg, module=tp_dict.__module__)
+                    for n, tp in own_annotations.items()
+                }
+            else:
+                own_annotations = {
+                    n: typing._type_check(tp, msg)
+                    for n, tp in own_annotations.items()
+                }
+            required_keys = set()
+            optional_keys = set()
+            readonly_keys = set()
+            mutable_keys = set()
+            extra_items_type = None
+
+            for base in bases:
+                base_dict = base.__dict__
+
+                annotations.update(base_dict.get('__annotations__', {}))
+                required_keys.update(base_dict.get('__required_keys__', ()))
+                optional_keys.update(base_dict.get('__optional_keys__', ()))
+                readonly_keys.update(base_dict.get('__readonly_keys__', ()))
+                mutable_keys.update(base_dict.get('__mutable_keys__', ()))
+                base_extra_items_type = base_dict.get('__extra_items__', None)
+                if base_extra_items_type is not None:
+                    extra_items_type = base_extra_items_type
+
+            if closed and extra_items_type is None:
+                extra_items_type = Never
+            if closed and "__extra_items__" in own_annotations:
+                annotation_type = own_annotations.pop("__extra_items__")
+                qualifiers = set(_get_typeddict_qualifiers(annotation_type))
+                if Required in qualifiers:
+                    raise TypeError(
+                        "Special key __extra_items__ does not support "
+                        "Required"
+                    )
+                if NotRequired in qualifiers:
+                    raise TypeError(
+                        "Special key __extra_items__ does not support "
+                        "NotRequired"
+                    )
+                extra_items_type = annotation_type
+
+            annotations.update(own_annotations)
+            for annotation_key, annotation_type in own_annotations.items():
+                qualifiers = set(_get_typeddict_qualifiers(annotation_type))
+
+                if Required in qualifiers:
+                    required_keys.add(annotation_key)
+                elif NotRequired in qualifiers:
+                    optional_keys.add(annotation_key)
+                elif total:
+                    required_keys.add(annotation_key)
+                else:
+                    optional_keys.add(annotation_key)
+                if ReadOnly in qualifiers:
+                    mutable_keys.discard(annotation_key)
+                    readonly_keys.add(annotation_key)
+                else:
+                    mutable_keys.add(annotation_key)
+                    readonly_keys.discard(annotation_key)
+
+            tp_dict.__annotations__ = annotations
+            tp_dict.__required_keys__ = frozenset(required_keys)
+            tp_dict.__optional_keys__ = frozenset(optional_keys)
+            tp_dict.__readonly_keys__ = frozenset(readonly_keys)
+            tp_dict.__mutable_keys__ = frozenset(mutable_keys)
+            if not hasattr(tp_dict, '__total__'):
+                tp_dict.__total__ = total
+            tp_dict.__closed__ = closed
+            tp_dict.__extra_items__ = extra_items_type
+            return tp_dict
+
+        __call__ = dict  # static method
+
+        def __subclasscheck__(cls, other):
+            # Typed dicts are only for static structural subtyping.
+            raise TypeError('TypedDict does not support instance and class checks')
+
+        __instancecheck__ = __subclasscheck__
+
+    _TypedDict = type.__new__(_TypedDictMeta, 'TypedDict', (), {})
+
+    @_ensure_subclassable(lambda bases: (_TypedDict,))
+    def TypedDict(typename, fields=_marker, /, *, total=True, closed=False, **kwargs):
+        """A simple typed namespace. At runtime it is equivalent to a plain dict.
+
+        TypedDict creates a dictionary type such that a type checker will expect all
+        instances to have a certain set of keys, where each key is
+        associated with a value of a consistent type. This expectation
+        is not checked at runtime.
+
+        Usage::
+
+            class Point2D(TypedDict):
+                x: int
+                y: int
+                label: str
+
+            a: Point2D = {'x': 1, 'y': 2, 'label': 'good'}  # OK
+            b: Point2D = {'z': 3, 'label': 'bad'}           # Fails type check
+
+            assert Point2D(x=1, y=2, label='first') == dict(x=1, y=2, label='first')
+
+        The type info can be accessed via the Point2D.__annotations__ dict, and
+        the Point2D.__required_keys__ and Point2D.__optional_keys__ frozensets.
+        TypedDict supports an additional equivalent form::
+
+            Point2D = TypedDict('Point2D', {'x': int, 'y': int, 'label': str})
+
+        By default, all keys must be present in a TypedDict. It is possible
+        to override this by specifying totality::
+
+            class Point2D(TypedDict, total=False):
+                x: int
+                y: int
+
+        This means that a Point2D TypedDict can have any of the keys omitted. A type
+        checker is only expected to support a literal False or True as the value of
+        the total argument. True is the default, and makes all items defined in the
+        class body be required.
+
+        The Required and NotRequired special forms can also be used to mark
+        individual keys as being required or not required::
+
+            class Point2D(TypedDict):
+                x: int  # the "x" key must always be present (Required is the default)
+                y: NotRequired[int]  # the "y" key can be omitted
+
+        See PEP 655 for more details on Required and NotRequired.
+        """
+        if fields is _marker or fields is None:
+            if fields is _marker:
+                deprecated_thing = "Failing to pass a value for the 'fields' parameter"
+            else:
+                deprecated_thing = "Passing `None` as the 'fields' parameter"
+
+            example = f"`{typename} = TypedDict({typename!r}, {{}})`"
+            deprecation_msg = (
+                f"{deprecated_thing} is deprecated and will be disallowed in "
+                "Python 3.15. To create a TypedDict class with 0 fields "
+                "using the functional syntax, pass an empty dictionary, e.g. "
+            ) + example + "."
+            warnings.warn(deprecation_msg, DeprecationWarning, stacklevel=2)
+            if closed is not False and closed is not True:
+                kwargs["closed"] = closed
+                closed = False
+            fields = kwargs
+        elif kwargs:
+            raise TypeError("TypedDict takes either a dict or keyword arguments,"
+                            " but not both")
+        if kwargs:
+            if sys.version_info >= (3, 13):
+                raise TypeError("TypedDict takes no keyword arguments")
+            warnings.warn(
+                "The kwargs-based syntax for TypedDict definitions is deprecated "
+                "in Python 3.11, will be removed in Python 3.13, and may not be "
+                "understood by third-party type checkers.",
+                DeprecationWarning,
+                stacklevel=2,
+            )
+
+        ns = {'__annotations__': dict(fields)}
+        module = _caller()
+        if module is not None:
+            # Setting correct module is necessary to make typed dict classes pickleable.
+            ns['__module__'] = module
+
+        td = _TypedDictMeta(typename, (), ns, total=total, closed=closed)
+        td.__orig_bases__ = (TypedDict,)
+        return td
+
+    if hasattr(typing, "_TypedDictMeta"):
+        _TYPEDDICT_TYPES = (typing._TypedDictMeta, _TypedDictMeta)
+    else:
+        _TYPEDDICT_TYPES = (_TypedDictMeta,)
+
+    def is_typeddict(tp):
+        """Check if an annotation is a TypedDict class
+
+        For example::
+            class Film(TypedDict):
+                title: str
+                year: int
+
+            is_typeddict(Film)  # => True
+            is_typeddict(Union[list, str])  # => False
+        """
+        # On 3.8, this would otherwise return True
+        if hasattr(typing, "TypedDict") and tp is typing.TypedDict:
+            return False
+        return isinstance(tp, _TYPEDDICT_TYPES)
+
+
+if hasattr(typing, "assert_type"):
+    assert_type = typing.assert_type
+
+else:
+    def assert_type(val, typ, /):
+        """Assert (to the type checker) that the value is of the given type.
+
+        When the type checker encounters a call to assert_type(), it
+        emits an error if the value is not of the specified type::
+
+            def greet(name: str) -> None:
+                assert_type(name, str)  # ok
+                assert_type(name, int)  # type checker error
+
+        At runtime this returns the first argument unchanged and otherwise
+        does nothing.
+        """
+        return val
+
+
+if hasattr(typing, "ReadOnly"):  # 3.13+
+    get_type_hints = typing.get_type_hints
+else:  # <=3.13
+    # replaces _strip_annotations()
+    def _strip_extras(t):
+        """Strips Annotated, Required and NotRequired from a given type."""
+        if isinstance(t, _AnnotatedAlias):
+            return _strip_extras(t.__origin__)
+        if hasattr(t, "__origin__") and t.__origin__ in (Required, NotRequired, ReadOnly):
+            return _strip_extras(t.__args__[0])
+        if isinstance(t, typing._GenericAlias):
+            stripped_args = tuple(_strip_extras(a) for a in t.__args__)
+            if stripped_args == t.__args__:
+                return t
+            return t.copy_with(stripped_args)
+        if hasattr(_types, "GenericAlias") and isinstance(t, _types.GenericAlias):
+            stripped_args = tuple(_strip_extras(a) for a in t.__args__)
+            if stripped_args == t.__args__:
+                return t
+            return _types.GenericAlias(t.__origin__, stripped_args)
+        if hasattr(_types, "UnionType") and isinstance(t, _types.UnionType):
+            stripped_args = tuple(_strip_extras(a) for a in t.__args__)
+            if stripped_args == t.__args__:
+                return t
+            return functools.reduce(operator.or_, stripped_args)
+
+        return t
+
+    def get_type_hints(obj, globalns=None, localns=None, include_extras=False):
+        """Return type hints for an object.
+
+        This is often the same as obj.__annotations__, but it handles
+        forward references encoded as string literals, adds Optional[t] if a
+        default value equal to None is set and recursively replaces all
+        'Annotated[T, ...]', 'Required[T]' or 'NotRequired[T]' with 'T'
+        (unless 'include_extras=True').
+
+        The argument may be a module, class, method, or function. The annotations
+        are returned as a dictionary. For classes, annotations include also
+        inherited members.
+
+        TypeError is raised if the argument is not of a type that can contain
+        annotations, and an empty dictionary is returned if no annotations are
+        present.
+
+        BEWARE -- the behavior of globalns and localns is counterintuitive
+        (unless you are familiar with how eval() and exec() work).  The
+        search order is locals first, then globals.
+
+        - If no dict arguments are passed, an attempt is made to use the
+          globals from obj (or the respective module's globals for classes),
+          and these are also used as the locals.  If the object does not appear
+          to have globals, an empty dictionary is used.
+
+        - If one dict argument is passed, it is used for both globals and
+          locals.
+
+        - If two dict arguments are passed, they specify globals and
+          locals, respectively.
+        """
+        if hasattr(typing, "Annotated"):  # 3.9+
+            hint = typing.get_type_hints(
+                obj, globalns=globalns, localns=localns, include_extras=True
+            )
+        else:  # 3.8
+            hint = typing.get_type_hints(obj, globalns=globalns, localns=localns)
+        if include_extras:
+            return hint
+        return {k: _strip_extras(t) for k, t in hint.items()}
+
+
+# Python 3.9+ has PEP 593 (Annotated)
+if hasattr(typing, 'Annotated'):
+    Annotated = typing.Annotated
+    # Not exported and not a public API, but needed for get_origin() and get_args()
+    # to work.
+    _AnnotatedAlias = typing._AnnotatedAlias
+# 3.8
+else:
+    class _AnnotatedAlias(typing._GenericAlias, _root=True):
+        """Runtime representation of an annotated type.
+
+        At its core 'Annotated[t, dec1, dec2, ...]' is an alias for the type 't'
+        with extra annotations. The alias behaves like a normal typing alias,
+        instantiating is the same as instantiating the underlying type, binding
+        it to types is also the same.
+        """
+        def __init__(self, origin, metadata):
+            if isinstance(origin, _AnnotatedAlias):
+                metadata = origin.__metadata__ + metadata
+                origin = origin.__origin__
+            super().__init__(origin, origin)
+            self.__metadata__ = metadata
+
+        def copy_with(self, params):
+            assert len(params) == 1
+            new_type = params[0]
+            return _AnnotatedAlias(new_type, self.__metadata__)
+
+        def __repr__(self):
+            return (f"typing_extensions.Annotated[{typing._type_repr(self.__origin__)}, "
+                    f"{', '.join(repr(a) for a in self.__metadata__)}]")
+
+        def __reduce__(self):
+            return operator.getitem, (
+                Annotated, (self.__origin__, *self.__metadata__)
+            )
+
+        def __eq__(self, other):
+            if not isinstance(other, _AnnotatedAlias):
+                return NotImplemented
+            if self.__origin__ != other.__origin__:
+                return False
+            return self.__metadata__ == other.__metadata__
+
+        def __hash__(self):
+            return hash((self.__origin__, self.__metadata__))
+
+    class Annotated:
+        """Add context specific metadata to a type.
+
+        Example: Annotated[int, runtime_check.Unsigned] indicates to the
+        hypothetical runtime_check module that this type is an unsigned int.
+        Every other consumer of this type can ignore this metadata and treat
+        this type as int.
+
+        The first argument to Annotated must be a valid type (and will be in
+        the __origin__ field), the remaining arguments are kept as a tuple in
+        the __extra__ field.
+
+        Details:
+
+        - It's an error to call `Annotated` with less than two arguments.
+        - Nested Annotated are flattened::
+
+            Annotated[Annotated[T, Ann1, Ann2], Ann3] == Annotated[T, Ann1, Ann2, Ann3]
+
+        - Instantiating an annotated type is equivalent to instantiating the
+        underlying type::
+
+            Annotated[C, Ann1](5) == C(5)
+
+        - Annotated can be used as a generic type alias::
+
+            Optimized = Annotated[T, runtime.Optimize()]
+            Optimized[int] == Annotated[int, runtime.Optimize()]
+
+            OptimizedList = Annotated[List[T], runtime.Optimize()]
+            OptimizedList[int] == Annotated[List[int], runtime.Optimize()]
+        """
+
+        __slots__ = ()
+
+        def __new__(cls, *args, **kwargs):
+            raise TypeError("Type Annotated cannot be instantiated.")
+
+        @typing._tp_cache
+        def __class_getitem__(cls, params):
+            if not isinstance(params, tuple) or len(params) < 2:
+                raise TypeError("Annotated[...] should be used "
+                                "with at least two arguments (a type and an "
+                                "annotation).")
+            allowed_special_forms = (ClassVar, Final)
+            if get_origin(params[0]) in allowed_special_forms:
+                origin = params[0]
+            else:
+                msg = "Annotated[t, ...]: t must be a type."
+                origin = typing._type_check(params[0], msg)
+            metadata = tuple(params[1:])
+            return _AnnotatedAlias(origin, metadata)
+
+        def __init_subclass__(cls, *args, **kwargs):
+            raise TypeError(
+                f"Cannot subclass {cls.__module__}.Annotated"
+            )
+
+# Python 3.8 has get_origin() and get_args() but those implementations aren't
+# Annotated-aware, so we can't use those. Python 3.9's versions don't support
+# ParamSpecArgs and ParamSpecKwargs, so only Python 3.10's versions will do.
+if sys.version_info[:2] >= (3, 10):
+    get_origin = typing.get_origin
+    get_args = typing.get_args
+# 3.8-3.9
+else:
+    try:
+        # 3.9+
+        from typing import _BaseGenericAlias
+    except ImportError:
+        _BaseGenericAlias = typing._GenericAlias
+    try:
+        # 3.9+
+        from typing import GenericAlias as _typing_GenericAlias
+    except ImportError:
+        _typing_GenericAlias = typing._GenericAlias
+
+    def get_origin(tp):
+        """Get the unsubscripted version of a type.
+
+        This supports generic types, Callable, Tuple, Union, Literal, Final, ClassVar
+        and Annotated. Return None for unsupported types. Examples::
+
+            get_origin(Literal[42]) is Literal
+            get_origin(int) is None
+            get_origin(ClassVar[int]) is ClassVar
+            get_origin(Generic) is Generic
+            get_origin(Generic[T]) is Generic
+            get_origin(Union[T, int]) is Union
+            get_origin(List[Tuple[T, T]][int]) == list
+            get_origin(P.args) is P
+        """
+        if isinstance(tp, _AnnotatedAlias):
+            return Annotated
+        if isinstance(tp, (typing._GenericAlias, _typing_GenericAlias, _BaseGenericAlias,
+                           ParamSpecArgs, ParamSpecKwargs)):
+            return tp.__origin__
+        if tp is typing.Generic:
+            return typing.Generic
+        return None
+
+    def get_args(tp):
+        """Get type arguments with all substitutions performed.
+
+        For unions, basic simplifications used by Union constructor are performed.
+        Examples::
+            get_args(Dict[str, int]) == (str, int)
+            get_args(int) == ()
+            get_args(Union[int, Union[T, int], str][int]) == (int, str)
+            get_args(Union[int, Tuple[T, int]][str]) == (int, Tuple[str, int])
+            get_args(Callable[[], T][int]) == ([], int)
+        """
+        if isinstance(tp, _AnnotatedAlias):
+            return (tp.__origin__, *tp.__metadata__)
+        if isinstance(tp, (typing._GenericAlias, _typing_GenericAlias)):
+            if getattr(tp, "_special", False):
+                return ()
+            res = tp.__args__
+            if get_origin(tp) is collections.abc.Callable and res[0] is not Ellipsis:
+                res = (list(res[:-1]), res[-1])
+            return res
+        return ()
+
+
+# 3.10+
+if hasattr(typing, 'TypeAlias'):
+    TypeAlias = typing.TypeAlias
+# 3.9
+elif sys.version_info[:2] >= (3, 9):
+    @_ExtensionsSpecialForm
+    def TypeAlias(self, parameters):
+        """Special marker indicating that an assignment should
+        be recognized as a proper type alias definition by type
+        checkers.
+
+        For example::
+
+            Predicate: TypeAlias = Callable[..., bool]
+
+        It's invalid when used anywhere except as in the example above.
+        """
+        raise TypeError(f"{self} is not subscriptable")
+# 3.8
+else:
+    TypeAlias = _ExtensionsSpecialForm(
+        'TypeAlias',
+        doc="""Special marker indicating that an assignment should
+        be recognized as a proper type alias definition by type
+        checkers.
+
+        For example::
+
+            Predicate: TypeAlias = Callable[..., bool]
+
+        It's invalid when used anywhere except as in the example
+        above."""
+    )
+
+
+if hasattr(typing, "NoDefault"):
+    NoDefault = typing.NoDefault
+else:
+    class NoDefaultTypeMeta(type):
+        def __setattr__(cls, attr, value):
+            # TypeError is consistent with the behavior of NoneType
+            raise TypeError(
+                f"cannot set {attr!r} attribute of immutable type {cls.__name__!r}"
+            )
+
+    class NoDefaultType(metaclass=NoDefaultTypeMeta):
+        """The type of the NoDefault singleton."""
+
+        __slots__ = ()
+
+        def __new__(cls):
+            return globals().get("NoDefault") or object.__new__(cls)
+
+        def __repr__(self):
+            return "typing_extensions.NoDefault"
+
+        def __reduce__(self):
+            return "NoDefault"
+
+    NoDefault = NoDefaultType()
+    del NoDefaultType, NoDefaultTypeMeta
+
+
+def _set_default(type_param, default):
+    type_param.has_default = lambda: default is not NoDefault
+    type_param.__default__ = default
+
+
+def _set_module(typevarlike):
+    # for pickling:
+    def_mod = _caller(depth=3)
+    if def_mod != 'typing_extensions':
+        typevarlike.__module__ = def_mod
+
+
+class _DefaultMixin:
+    """Mixin for TypeVarLike defaults."""
+
+    __slots__ = ()
+    __init__ = _set_default
+
+
+# Classes using this metaclass must provide a _backported_typevarlike ClassVar
+class _TypeVarLikeMeta(type):
+    def __instancecheck__(cls, __instance: Any) -> bool:
+        return isinstance(__instance, cls._backported_typevarlike)
+
+
+if _PEP_696_IMPLEMENTED:
+    from typing import TypeVar
+else:
+    # Add default and infer_variance parameters from PEP 696 and 695
+    class TypeVar(metaclass=_TypeVarLikeMeta):
+        """Type variable."""
+
+        _backported_typevarlike = typing.TypeVar
+
+        def __new__(cls, name, *constraints, bound=None,
+                    covariant=False, contravariant=False,
+                    default=NoDefault, infer_variance=False):
+            if hasattr(typing, "TypeAliasType"):
+                # PEP 695 implemented (3.12+), can pass infer_variance to typing.TypeVar
+                typevar = typing.TypeVar(name, *constraints, bound=bound,
+                                         covariant=covariant, contravariant=contravariant,
+                                         infer_variance=infer_variance)
+            else:
+                typevar = typing.TypeVar(name, *constraints, bound=bound,
+                                         covariant=covariant, contravariant=contravariant)
+                if infer_variance and (covariant or contravariant):
+                    raise ValueError("Variance cannot be specified with infer_variance.")
+                typevar.__infer_variance__ = infer_variance
+
+            _set_default(typevar, default)
+            _set_module(typevar)
+
+            def _tvar_prepare_subst(alias, args):
+                if (
+                    typevar.has_default()
+                    and alias.__parameters__.index(typevar) == len(args)
+                ):
+                    args += (typevar.__default__,)
+                return args
+
+            typevar.__typing_prepare_subst__ = _tvar_prepare_subst
+            return typevar
+
+        def __init_subclass__(cls) -> None:
+            raise TypeError(f"type '{__name__}.TypeVar' is not an acceptable base type")
+
+
+# Python 3.10+ has PEP 612
+if hasattr(typing, 'ParamSpecArgs'):
+    ParamSpecArgs = typing.ParamSpecArgs
+    ParamSpecKwargs = typing.ParamSpecKwargs
+# 3.8-3.9
+else:
+    class _Immutable:
+        """Mixin to indicate that object should not be copied."""
+        __slots__ = ()
+
+        def __copy__(self):
+            return self
+
+        def __deepcopy__(self, memo):
+            return self
+
+    class ParamSpecArgs(_Immutable):
+        """The args for a ParamSpec object.
+
+        Given a ParamSpec object P, P.args is an instance of ParamSpecArgs.
+
+        ParamSpecArgs objects have a reference back to their ParamSpec:
+
+        P.args.__origin__ is P
+
+        This type is meant for runtime introspection and has no special meaning to
+        static type checkers.
+        """
+        def __init__(self, origin):
+            self.__origin__ = origin
+
+        def __repr__(self):
+            return f"{self.__origin__.__name__}.args"
+
+        def __eq__(self, other):
+            if not isinstance(other, ParamSpecArgs):
+                return NotImplemented
+            return self.__origin__ == other.__origin__
+
+    class ParamSpecKwargs(_Immutable):
+        """The kwargs for a ParamSpec object.
+
+        Given a ParamSpec object P, P.kwargs is an instance of ParamSpecKwargs.
+
+        ParamSpecKwargs objects have a reference back to their ParamSpec:
+
+        P.kwargs.__origin__ is P
+
+        This type is meant for runtime introspection and has no special meaning to
+        static type checkers.
+        """
+        def __init__(self, origin):
+            self.__origin__ = origin
+
+        def __repr__(self):
+            return f"{self.__origin__.__name__}.kwargs"
+
+        def __eq__(self, other):
+            if not isinstance(other, ParamSpecKwargs):
+                return NotImplemented
+            return self.__origin__ == other.__origin__
+
+
+if _PEP_696_IMPLEMENTED:
+    from typing import ParamSpec
+
+# 3.10+
+elif hasattr(typing, 'ParamSpec'):
+
+    # Add default parameter - PEP 696
+    class ParamSpec(metaclass=_TypeVarLikeMeta):
+        """Parameter specification."""
+
+        _backported_typevarlike = typing.ParamSpec
+
+        def __new__(cls, name, *, bound=None,
+                    covariant=False, contravariant=False,
+                    infer_variance=False, default=NoDefault):
+            if hasattr(typing, "TypeAliasType"):
+                # PEP 695 implemented, can pass infer_variance to typing.TypeVar
+                paramspec = typing.ParamSpec(name, bound=bound,
+                                             covariant=covariant,
+                                             contravariant=contravariant,
+                                             infer_variance=infer_variance)
+            else:
+                paramspec = typing.ParamSpec(name, bound=bound,
+                                             covariant=covariant,
+                                             contravariant=contravariant)
+                paramspec.__infer_variance__ = infer_variance
+
+            _set_default(paramspec, default)
+            _set_module(paramspec)
+
+            def _paramspec_prepare_subst(alias, args):
+                params = alias.__parameters__
+                i = params.index(paramspec)
+                if i == len(args) and paramspec.has_default():
+                    args = [*args, paramspec.__default__]
+                if i >= len(args):
+                    raise TypeError(f"Too few arguments for {alias}")
+                # Special case where Z[[int, str, bool]] == Z[int, str, bool] in PEP 612.
+                if len(params) == 1 and not typing._is_param_expr(args[0]):
+                    assert i == 0
+                    args = (args,)
+                # Convert lists to tuples to help other libraries cache the results.
+                elif isinstance(args[i], list):
+                    args = (*args[:i], tuple(args[i]), *args[i + 1:])
+                return args
+
+            paramspec.__typing_prepare_subst__ = _paramspec_prepare_subst
+            return paramspec
+
+        def __init_subclass__(cls) -> None:
+            raise TypeError(f"type '{__name__}.ParamSpec' is not an acceptable base type")
+
+# 3.8-3.9
+else:
+
+    # Inherits from list as a workaround for Callable checks in Python < 3.9.2.
+    class ParamSpec(list, _DefaultMixin):
+        """Parameter specification variable.
+
+        Usage::
+
+           P = ParamSpec('P')
+
+        Parameter specification variables exist primarily for the benefit of static
+        type checkers.  They are used to forward the parameter types of one
+        callable to another callable, a pattern commonly found in higher order
+        functions and decorators.  They are only valid when used in ``Concatenate``,
+        or s the first argument to ``Callable``. In Python 3.10 and higher,
+        they are also supported in user-defined Generics at runtime.
+        See class Generic for more information on generic types.  An
+        example for annotating a decorator::
+
+           T = TypeVar('T')
+           P = ParamSpec('P')
+
+           def add_logging(f: Callable[P, T]) -> Callable[P, T]:
+               '''A type-safe decorator to add logging to a function.'''
+               def inner(*args: P.args, **kwargs: P.kwargs) -> T:
+                   logging.info(f'{f.__name__} was called')
+                   return f(*args, **kwargs)
+               return inner
+
+           @add_logging
+           def add_two(x: float, y: float) -> float:
+               '''Add two numbers together.'''
+               return x + y
+
+        Parameter specification variables defined with covariant=True or
+        contravariant=True can be used to declare covariant or contravariant
+        generic types.  These keyword arguments are valid, but their actual semantics
+        are yet to be decided.  See PEP 612 for details.
+
+        Parameter specification variables can be introspected. e.g.:
+
+           P.__name__ == 'T'
+           P.__bound__ == None
+           P.__covariant__ == False
+           P.__contravariant__ == False
+
+        Note that only parameter specification variables defined in global scope can
+        be pickled.
+        """
+
+        # Trick Generic __parameters__.
+        __class__ = typing.TypeVar
+
+        @property
+        def args(self):
+            return ParamSpecArgs(self)
+
+        @property
+        def kwargs(self):
+            return ParamSpecKwargs(self)
+
+        def __init__(self, name, *, bound=None, covariant=False, contravariant=False,
+                     infer_variance=False, default=NoDefault):
+            list.__init__(self, [self])
+            self.__name__ = name
+            self.__covariant__ = bool(covariant)
+            self.__contravariant__ = bool(contravariant)
+            self.__infer_variance__ = bool(infer_variance)
+            if bound:
+                self.__bound__ = typing._type_check(bound, 'Bound must be a type.')
+            else:
+                self.__bound__ = None
+            _DefaultMixin.__init__(self, default)
+
+            # for pickling:
+            def_mod = _caller()
+            if def_mod != 'typing_extensions':
+                self.__module__ = def_mod
+
+        def __repr__(self):
+            if self.__infer_variance__:
+                prefix = ''
+            elif self.__covariant__:
+                prefix = '+'
+            elif self.__contravariant__:
+                prefix = '-'
+            else:
+                prefix = '~'
+            return prefix + self.__name__
+
+        def __hash__(self):
+            return object.__hash__(self)
+
+        def __eq__(self, other):
+            return self is other
+
+        def __reduce__(self):
+            return self.__name__
+
+        # Hack to get typing._type_check to pass.
+        def __call__(self, *args, **kwargs):
+            pass
+
+
+# 3.8-3.9
+if not hasattr(typing, 'Concatenate'):
+    # Inherits from list as a workaround for Callable checks in Python < 3.9.2.
+    class _ConcatenateGenericAlias(list):
+
+        # Trick Generic into looking into this for __parameters__.
+        __class__ = typing._GenericAlias
+
+        # Flag in 3.8.
+        _special = False
+
+        def __init__(self, origin, args):
+            super().__init__(args)
+            self.__origin__ = origin
+            self.__args__ = args
+
+        def __repr__(self):
+            _type_repr = typing._type_repr
+            return (f'{_type_repr(self.__origin__)}'
+                    f'[{", ".join(_type_repr(arg) for arg in self.__args__)}]')
+
+        def __hash__(self):
+            return hash((self.__origin__, self.__args__))
+
+        # Hack to get typing._type_check to pass in Generic.
+        def __call__(self, *args, **kwargs):
+            pass
+
+        @property
+        def __parameters__(self):
+            return tuple(
+                tp for tp in self.__args__ if isinstance(tp, (typing.TypeVar, ParamSpec))
+            )
+
+
+# 3.8-3.9
+@typing._tp_cache
+def _concatenate_getitem(self, parameters):
+    if parameters == ():
+        raise TypeError("Cannot take a Concatenate of no types.")
+    if not isinstance(parameters, tuple):
+        parameters = (parameters,)
+    if not isinstance(parameters[-1], ParamSpec):
+        raise TypeError("The last parameter to Concatenate should be a "
+                        "ParamSpec variable.")
+    msg = "Concatenate[arg, ...]: each arg must be a type."
+    parameters = tuple(typing._type_check(p, msg) for p in parameters)
+    return _ConcatenateGenericAlias(self, parameters)
+
+
+# 3.10+
+if hasattr(typing, 'Concatenate'):
+    Concatenate = typing.Concatenate
+    _ConcatenateGenericAlias = typing._ConcatenateGenericAlias
+# 3.9
+elif sys.version_info[:2] >= (3, 9):
+    @_ExtensionsSpecialForm
+    def Concatenate(self, parameters):
+        """Used in conjunction with ``ParamSpec`` and ``Callable`` to represent a
+        higher order function which adds, removes or transforms parameters of a
+        callable.
+
+        For example::
+
+           Callable[Concatenate[int, P], int]
+
+        See PEP 612 for detailed information.
+        """
+        return _concatenate_getitem(self, parameters)
+# 3.8
+else:
+    class _ConcatenateForm(_ExtensionsSpecialForm, _root=True):
+        def __getitem__(self, parameters):
+            return _concatenate_getitem(self, parameters)
+
+    Concatenate = _ConcatenateForm(
+        'Concatenate',
+        doc="""Used in conjunction with ``ParamSpec`` and ``Callable`` to represent a
+        higher order function which adds, removes or transforms parameters of a
+        callable.
+
+        For example::
+
+           Callable[Concatenate[int, P], int]
+
+        See PEP 612 for detailed information.
+        """)
+
+# 3.10+
+if hasattr(typing, 'TypeGuard'):
+    TypeGuard = typing.TypeGuard
+# 3.9
+elif sys.version_info[:2] >= (3, 9):
+    @_ExtensionsSpecialForm
+    def TypeGuard(self, parameters):
+        """Special typing form used to annotate the return type of a user-defined
+        type guard function.  ``TypeGuard`` only accepts a single type argument.
+        At runtime, functions marked this way should return a boolean.
+
+        ``TypeGuard`` aims to benefit *type narrowing* -- a technique used by static
+        type checkers to determine a more precise type of an expression within a
+        program's code flow.  Usually type narrowing is done by analyzing
+        conditional code flow and applying the narrowing to a block of code.  The
+        conditional expression here is sometimes referred to as a "type guard".
+
+        Sometimes it would be convenient to use a user-defined boolean function
+        as a type guard.  Such a function should use ``TypeGuard[...]`` as its
+        return type to alert static type checkers to this intention.
+
+        Using  ``-> TypeGuard`` tells the static type checker that for a given
+        function:
+
+        1. The return value is a boolean.
+        2. If the return value is ``True``, the type of its argument
+        is the type inside ``TypeGuard``.
+
+        For example::
+
+            def is_str(val: Union[str, float]):
+                # "isinstance" type guard
+                if isinstance(val, str):
+                    # Type of ``val`` is narrowed to ``str``
+                    ...
+                else:
+                    # Else, type of ``val`` is narrowed to ``float``.
+                    ...
+
+        Strict type narrowing is not enforced -- ``TypeB`` need not be a narrower
+        form of ``TypeA`` (it can even be a wider form) and this may lead to
+        type-unsafe results.  The main reason is to allow for things like
+        narrowing ``List[object]`` to ``List[str]`` even though the latter is not
+        a subtype of the former, since ``List`` is invariant.  The responsibility of
+        writing type-safe type guards is left to the user.
+
+        ``TypeGuard`` also works with type variables.  For more information, see
+        PEP 647 (User-Defined Type Guards).
+        """
+        item = typing._type_check(parameters, f'{self} accepts only a single type.')
+        return typing._GenericAlias(self, (item,))
+# 3.8
+else:
+    class _TypeGuardForm(_ExtensionsSpecialForm, _root=True):
+        def __getitem__(self, parameters):
+            item = typing._type_check(parameters,
+                                      f'{self._name} accepts only a single type')
+            return typing._GenericAlias(self, (item,))
+
+    TypeGuard = _TypeGuardForm(
+        'TypeGuard',
+        doc="""Special typing form used to annotate the return type of a user-defined
+        type guard function.  ``TypeGuard`` only accepts a single type argument.
+        At runtime, functions marked this way should return a boolean.
+
+        ``TypeGuard`` aims to benefit *type narrowing* -- a technique used by static
+        type checkers to determine a more precise type of an expression within a
+        program's code flow.  Usually type narrowing is done by analyzing
+        conditional code flow and applying the narrowing to a block of code.  The
+        conditional expression here is sometimes referred to as a "type guard".
+
+        Sometimes it would be convenient to use a user-defined boolean function
+        as a type guard.  Such a function should use ``TypeGuard[...]`` as its
+        return type to alert static type checkers to this intention.
+
+        Using  ``-> TypeGuard`` tells the static type checker that for a given
+        function:
+
+        1. The return value is a boolean.
+        2. If the return value is ``True``, the type of its argument
+        is the type inside ``TypeGuard``.
+
+        For example::
+
+            def is_str(val: Union[str, float]):
+                # "isinstance" type guard
+                if isinstance(val, str):
+                    # Type of ``val`` is narrowed to ``str``
+                    ...
+                else:
+                    # Else, type of ``val`` is narrowed to ``float``.
+                    ...
+
+        Strict type narrowing is not enforced -- ``TypeB`` need not be a narrower
+        form of ``TypeA`` (it can even be a wider form) and this may lead to
+        type-unsafe results.  The main reason is to allow for things like
+        narrowing ``List[object]`` to ``List[str]`` even though the latter is not
+        a subtype of the former, since ``List`` is invariant.  The responsibility of
+        writing type-safe type guards is left to the user.
+
+        ``TypeGuard`` also works with type variables.  For more information, see
+        PEP 647 (User-Defined Type Guards).
+        """)
+
+# 3.13+
+if hasattr(typing, 'TypeIs'):
+    TypeIs = typing.TypeIs
+# 3.9
+elif sys.version_info[:2] >= (3, 9):
+    @_ExtensionsSpecialForm
+    def TypeIs(self, parameters):
+        """Special typing form used to annotate the return type of a user-defined
+        type narrower function.  ``TypeIs`` only accepts a single type argument.
+        At runtime, functions marked this way should return a boolean.
+
+        ``TypeIs`` aims to benefit *type narrowing* -- a technique used by static
+        type checkers to determine a more precise type of an expression within a
+        program's code flow.  Usually type narrowing is done by analyzing
+        conditional code flow and applying the narrowing to a block of code.  The
+        conditional expression here is sometimes referred to as a "type guard".
+
+        Sometimes it would be convenient to use a user-defined boolean function
+        as a type guard.  Such a function should use ``TypeIs[...]`` as its
+        return type to alert static type checkers to this intention.
+
+        Using  ``-> TypeIs`` tells the static type checker that for a given
+        function:
+
+        1. The return value is a boolean.
+        2. If the return value is ``True``, the type of its argument
+        is the intersection of the type inside ``TypeGuard`` and the argument's
+        previously known type.
+
+        For example::
+
+            def is_awaitable(val: object) -> TypeIs[Awaitable[Any]]:
+                return hasattr(val, '__await__')
+
+            def f(val: Union[int, Awaitable[int]]) -> int:
+                if is_awaitable(val):
+                    assert_type(val, Awaitable[int])
+                else:
+                    assert_type(val, int)
+
+        ``TypeIs`` also works with type variables.  For more information, see
+        PEP 742 (Narrowing types with TypeIs).
+        """
+        item = typing._type_check(parameters, f'{self} accepts only a single type.')
+        return typing._GenericAlias(self, (item,))
+# 3.8
+else:
+    class _TypeIsForm(_ExtensionsSpecialForm, _root=True):
+        def __getitem__(self, parameters):
+            item = typing._type_check(parameters,
+                                      f'{self._name} accepts only a single type')
+            return typing._GenericAlias(self, (item,))
+
+    TypeIs = _TypeIsForm(
+        'TypeIs',
+        doc="""Special typing form used to annotate the return type of a user-defined
+        type narrower function.  ``TypeIs`` only accepts a single type argument.
+        At runtime, functions marked this way should return a boolean.
+
+        ``TypeIs`` aims to benefit *type narrowing* -- a technique used by static
+        type checkers to determine a more precise type of an expression within a
+        program's code flow.  Usually type narrowing is done by analyzing
+        conditional code flow and applying the narrowing to a block of code.  The
+        conditional expression here is sometimes referred to as a "type guard".
+
+        Sometimes it would be convenient to use a user-defined boolean function
+        as a type guard.  Such a function should use ``TypeIs[...]`` as its
+        return type to alert static type checkers to this intention.
+
+        Using  ``-> TypeIs`` tells the static type checker that for a given
+        function:
+
+        1. The return value is a boolean.
+        2. If the return value is ``True``, the type of its argument
+        is the intersection of the type inside ``TypeGuard`` and the argument's
+        previously known type.
+
+        For example::
+
+            def is_awaitable(val: object) -> TypeIs[Awaitable[Any]]:
+                return hasattr(val, '__await__')
+
+            def f(val: Union[int, Awaitable[int]]) -> int:
+                if is_awaitable(val):
+                    assert_type(val, Awaitable[int])
+                else:
+                    assert_type(val, int)
+
+        ``TypeIs`` also works with type variables.  For more information, see
+        PEP 742 (Narrowing types with TypeIs).
+        """)
+
+
+# Vendored from cpython typing._SpecialFrom
+class _SpecialForm(typing._Final, _root=True):
+    __slots__ = ('_name', '__doc__', '_getitem')
+
+    def __init__(self, getitem):
+        self._getitem = getitem
+        self._name = getitem.__name__
+        self.__doc__ = getitem.__doc__
+
+    def __getattr__(self, item):
+        if item in {'__name__', '__qualname__'}:
+            return self._name
+
+        raise AttributeError(item)
+
+    def __mro_entries__(self, bases):
+        raise TypeError(f"Cannot subclass {self!r}")
+
+    def __repr__(self):
+        return f'typing_extensions.{self._name}'
+
+    def __reduce__(self):
+        return self._name
+
+    def __call__(self, *args, **kwds):
+        raise TypeError(f"Cannot instantiate {self!r}")
+
+    def __or__(self, other):
+        return typing.Union[self, other]
+
+    def __ror__(self, other):
+        return typing.Union[other, self]
+
+    def __instancecheck__(self, obj):
+        raise TypeError(f"{self} cannot be used with isinstance()")
+
+    def __subclasscheck__(self, cls):
+        raise TypeError(f"{self} cannot be used with issubclass()")
+
+    @typing._tp_cache
+    def __getitem__(self, parameters):
+        return self._getitem(self, parameters)
+
+
+if hasattr(typing, "LiteralString"):  # 3.11+
+    LiteralString = typing.LiteralString
+else:
+    @_SpecialForm
+    def LiteralString(self, params):
+        """Represents an arbitrary literal string.
+
+        Example::
+
+          from pip._vendor.typing_extensions import LiteralString
+
+          def query(sql: LiteralString) -> ...:
+              ...
+
+          query("SELECT * FROM table")  # ok
+          query(f"SELECT * FROM {input()}")  # not ok
+
+        See PEP 675 for details.
+
+        """
+        raise TypeError(f"{self} is not subscriptable")
+
+
+if hasattr(typing, "Self"):  # 3.11+
+    Self = typing.Self
+else:
+    @_SpecialForm
+    def Self(self, params):
+        """Used to spell the type of "self" in classes.
+
+        Example::
+
+          from typing import Self
+
+          class ReturnsSelf:
+              def parse(self, data: bytes) -> Self:
+                  ...
+                  return self
+
+        """
+
+        raise TypeError(f"{self} is not subscriptable")
+
+
+if hasattr(typing, "Never"):  # 3.11+
+    Never = typing.Never
+else:
+    @_SpecialForm
+    def Never(self, params):
+        """The bottom type, a type that has no members.
+
+        This can be used to define a function that should never be
+        called, or a function that never returns::
+
+            from pip._vendor.typing_extensions import Never
+
+            def never_call_me(arg: Never) -> None:
+                pass
+
+            def int_or_str(arg: int | str) -> None:
+                never_call_me(arg)  # type checker error
+                match arg:
+                    case int():
+                        print("It's an int")
+                    case str():
+                        print("It's a str")
+                    case _:
+                        never_call_me(arg)  # ok, arg is of type Never
+
+        """
+
+        raise TypeError(f"{self} is not subscriptable")
+
+
+if hasattr(typing, 'Required'):  # 3.11+
+    Required = typing.Required
+    NotRequired = typing.NotRequired
+elif sys.version_info[:2] >= (3, 9):  # 3.9-3.10
+    @_ExtensionsSpecialForm
+    def Required(self, parameters):
+        """A special typing construct to mark a key of a total=False TypedDict
+        as required. For example:
+
+            class Movie(TypedDict, total=False):
+                title: Required[str]
+                year: int
+
+            m = Movie(
+                title='The Matrix',  # typechecker error if key is omitted
+                year=1999,
+            )
+
+        There is no runtime checking that a required key is actually provided
+        when instantiating a related TypedDict.
+        """
+        item = typing._type_check(parameters, f'{self._name} accepts only a single type.')
+        return typing._GenericAlias(self, (item,))
+
+    @_ExtensionsSpecialForm
+    def NotRequired(self, parameters):
+        """A special typing construct to mark a key of a TypedDict as
+        potentially missing. For example:
+
+            class Movie(TypedDict):
+                title: str
+                year: NotRequired[int]
+
+            m = Movie(
+                title='The Matrix',  # typechecker error if key is omitted
+                year=1999,
+            )
+        """
+        item = typing._type_check(parameters, f'{self._name} accepts only a single type.')
+        return typing._GenericAlias(self, (item,))
+
+else:  # 3.8
+    class _RequiredForm(_ExtensionsSpecialForm, _root=True):
+        def __getitem__(self, parameters):
+            item = typing._type_check(parameters,
+                                      f'{self._name} accepts only a single type.')
+            return typing._GenericAlias(self, (item,))
+
+    Required = _RequiredForm(
+        'Required',
+        doc="""A special typing construct to mark a key of a total=False TypedDict
+        as required. For example:
+
+            class Movie(TypedDict, total=False):
+                title: Required[str]
+                year: int
+
+            m = Movie(
+                title='The Matrix',  # typechecker error if key is omitted
+                year=1999,
+            )
+
+        There is no runtime checking that a required key is actually provided
+        when instantiating a related TypedDict.
+        """)
+    NotRequired = _RequiredForm(
+        'NotRequired',
+        doc="""A special typing construct to mark a key of a TypedDict as
+        potentially missing. For example:
+
+            class Movie(TypedDict):
+                title: str
+                year: NotRequired[int]
+
+            m = Movie(
+                title='The Matrix',  # typechecker error if key is omitted
+                year=1999,
+            )
+        """)
+
+
+if hasattr(typing, 'ReadOnly'):
+    ReadOnly = typing.ReadOnly
+elif sys.version_info[:2] >= (3, 9):  # 3.9-3.12
+    @_ExtensionsSpecialForm
+    def ReadOnly(self, parameters):
+        """A special typing construct to mark an item of a TypedDict as read-only.
+
+        For example:
+
+            class Movie(TypedDict):
+                title: ReadOnly[str]
+                year: int
+
+            def mutate_movie(m: Movie) -> None:
+                m["year"] = 1992  # allowed
+                m["title"] = "The Matrix"  # typechecker error
+
+        There is no runtime checking for this property.
+        """
+        item = typing._type_check(parameters, f'{self._name} accepts only a single type.')
+        return typing._GenericAlias(self, (item,))
+
+else:  # 3.8
+    class _ReadOnlyForm(_ExtensionsSpecialForm, _root=True):
+        def __getitem__(self, parameters):
+            item = typing._type_check(parameters,
+                                      f'{self._name} accepts only a single type.')
+            return typing._GenericAlias(self, (item,))
+
+    ReadOnly = _ReadOnlyForm(
+        'ReadOnly',
+        doc="""A special typing construct to mark a key of a TypedDict as read-only.
+
+        For example:
+
+            class Movie(TypedDict):
+                title: ReadOnly[str]
+                year: int
+
+            def mutate_movie(m: Movie) -> None:
+                m["year"] = 1992  # allowed
+                m["title"] = "The Matrix"  # typechecker error
+
+        There is no runtime checking for this propery.
+        """)
+
+
+_UNPACK_DOC = """\
+Type unpack operator.
+
+The type unpack operator takes the child types from some container type,
+such as `tuple[int, str]` or a `TypeVarTuple`, and 'pulls them out'. For
+example:
+
+  # For some generic class `Foo`:
+  Foo[Unpack[tuple[int, str]]]  # Equivalent to Foo[int, str]
+
+  Ts = TypeVarTuple('Ts')
+  # Specifies that `Bar` is generic in an arbitrary number of types.
+  # (Think of `Ts` as a tuple of an arbitrary number of individual
+  #  `TypeVar`s, which the `Unpack` is 'pulling out' directly into the
+  #  `Generic[]`.)
+  class Bar(Generic[Unpack[Ts]]): ...
+  Bar[int]  # Valid
+  Bar[int, str]  # Also valid
+
+From Python 3.11, this can also be done using the `*` operator:
+
+    Foo[*tuple[int, str]]
+    class Bar(Generic[*Ts]): ...
+
+The operator can also be used along with a `TypedDict` to annotate
+`**kwargs` in a function signature. For instance:
+
+  class Movie(TypedDict):
+    name: str
+    year: int
+
+  # This function expects two keyword arguments - *name* of type `str` and
+  # *year* of type `int`.
+  def foo(**kwargs: Unpack[Movie]): ...
+
+Note that there is only some runtime checking of this operator. Not
+everything the runtime allows may be accepted by static type checkers.
+
+For more information, see PEP 646 and PEP 692.
+"""
+
+
+if sys.version_info >= (3, 12):  # PEP 692 changed the repr of Unpack[]
+    Unpack = typing.Unpack
+
+    def _is_unpack(obj):
+        return get_origin(obj) is Unpack
+
+elif sys.version_info[:2] >= (3, 9):  # 3.9+
+    class _UnpackSpecialForm(_ExtensionsSpecialForm, _root=True):
+        def __init__(self, getitem):
+            super().__init__(getitem)
+            self.__doc__ = _UNPACK_DOC
+
+    class _UnpackAlias(typing._GenericAlias, _root=True):
+        __class__ = typing.TypeVar
+
+        @property
+        def __typing_unpacked_tuple_args__(self):
+            assert self.__origin__ is Unpack
+            assert len(self.__args__) == 1
+            arg, = self.__args__
+            if isinstance(arg, (typing._GenericAlias, _types.GenericAlias)):
+                if arg.__origin__ is not tuple:
+                    raise TypeError("Unpack[...] must be used with a tuple type")
+                return arg.__args__
+            return None
+
+    @_UnpackSpecialForm
+    def Unpack(self, parameters):
+        item = typing._type_check(parameters, f'{self._name} accepts only a single type.')
+        return _UnpackAlias(self, (item,))
+
+    def _is_unpack(obj):
+        return isinstance(obj, _UnpackAlias)
+
+else:  # 3.8
+    class _UnpackAlias(typing._GenericAlias, _root=True):
+        __class__ = typing.TypeVar
+
+    class _UnpackForm(_ExtensionsSpecialForm, _root=True):
+        def __getitem__(self, parameters):
+            item = typing._type_check(parameters,
+                                      f'{self._name} accepts only a single type.')
+            return _UnpackAlias(self, (item,))
+
+    Unpack = _UnpackForm('Unpack', doc=_UNPACK_DOC)
+
+    def _is_unpack(obj):
+        return isinstance(obj, _UnpackAlias)
+
+
+if _PEP_696_IMPLEMENTED:
+    from typing import TypeVarTuple
+
+elif hasattr(typing, "TypeVarTuple"):  # 3.11+
+
+    def _unpack_args(*args):
+        newargs = []
+        for arg in args:
+            subargs = getattr(arg, '__typing_unpacked_tuple_args__', None)
+            if subargs is not None and not (subargs and subargs[-1] is ...):
+                newargs.extend(subargs)
+            else:
+                newargs.append(arg)
+        return newargs
+
+    # Add default parameter - PEP 696
+    class TypeVarTuple(metaclass=_TypeVarLikeMeta):
+        """Type variable tuple."""
+
+        _backported_typevarlike = typing.TypeVarTuple
+
+        def __new__(cls, name, *, default=NoDefault):
+            tvt = typing.TypeVarTuple(name)
+            _set_default(tvt, default)
+            _set_module(tvt)
+
+            def _typevartuple_prepare_subst(alias, args):
+                params = alias.__parameters__
+                typevartuple_index = params.index(tvt)
+                for param in params[typevartuple_index + 1:]:
+                    if isinstance(param, TypeVarTuple):
+                        raise TypeError(
+                            f"More than one TypeVarTuple parameter in {alias}"
+                        )
+
+                alen = len(args)
+                plen = len(params)
+                left = typevartuple_index
+                right = plen - typevartuple_index - 1
+                var_tuple_index = None
+                fillarg = None
+                for k, arg in enumerate(args):
+                    if not isinstance(arg, type):
+                        subargs = getattr(arg, '__typing_unpacked_tuple_args__', None)
+                        if subargs and len(subargs) == 2 and subargs[-1] is ...:
+                            if var_tuple_index is not None:
+                                raise TypeError(
+                                    "More than one unpacked "
+                                    "arbitrary-length tuple argument"
+                                )
+                            var_tuple_index = k
+                            fillarg = subargs[0]
+                if var_tuple_index is not None:
+                    left = min(left, var_tuple_index)
+                    right = min(right, alen - var_tuple_index - 1)
+                elif left + right > alen:
+                    raise TypeError(f"Too few arguments for {alias};"
+                                    f" actual {alen}, expected at least {plen - 1}")
+                if left == alen - right and tvt.has_default():
+                    replacement = _unpack_args(tvt.__default__)
+                else:
+                    replacement = args[left: alen - right]
+
+                return (
+                    *args[:left],
+                    *([fillarg] * (typevartuple_index - left)),
+                    replacement,
+                    *([fillarg] * (plen - right - left - typevartuple_index - 1)),
+                    *args[alen - right:],
+                )
+
+            tvt.__typing_prepare_subst__ = _typevartuple_prepare_subst
+            return tvt
+
+        def __init_subclass__(self, *args, **kwds):
+            raise TypeError("Cannot subclass special typing classes")
+
+else:  # <=3.10
+    class TypeVarTuple(_DefaultMixin):
+        """Type variable tuple.
+
+        Usage::
+
+            Ts = TypeVarTuple('Ts')
+
+        In the same way that a normal type variable is a stand-in for a single
+        type such as ``int``, a type variable *tuple* is a stand-in for a *tuple*
+        type such as ``Tuple[int, str]``.
+
+        Type variable tuples can be used in ``Generic`` declarations.
+        Consider the following example::
+
+            class Array(Generic[*Ts]): ...
+
+        The ``Ts`` type variable tuple here behaves like ``tuple[T1, T2]``,
+        where ``T1`` and ``T2`` are type variables. To use these type variables
+        as type parameters of ``Array``, we must *unpack* the type variable tuple using
+        the star operator: ``*Ts``. The signature of ``Array`` then behaves
+        as if we had simply written ``class Array(Generic[T1, T2]): ...``.
+        In contrast to ``Generic[T1, T2]``, however, ``Generic[*Shape]`` allows
+        us to parameterise the class with an *arbitrary* number of type parameters.
+
+        Type variable tuples can be used anywhere a normal ``TypeVar`` can.
+        This includes class definitions, as shown above, as well as function
+        signatures and variable annotations::
+
+            class Array(Generic[*Ts]):
+
+                def __init__(self, shape: Tuple[*Ts]):
+                    self._shape: Tuple[*Ts] = shape
+
+                def get_shape(self) -> Tuple[*Ts]:
+                    return self._shape
+
+            shape = (Height(480), Width(640))
+            x: Array[Height, Width] = Array(shape)
+            y = abs(x)  # Inferred type is Array[Height, Width]
+            z = x + x   #        ...    is Array[Height, Width]
+            x.get_shape()  #     ...    is tuple[Height, Width]
+
+        """
+
+        # Trick Generic __parameters__.
+        __class__ = typing.TypeVar
+
+        def __iter__(self):
+            yield self.__unpacked__
+
+        def __init__(self, name, *, default=NoDefault):
+            self.__name__ = name
+            _DefaultMixin.__init__(self, default)
+
+            # for pickling:
+            def_mod = _caller()
+            if def_mod != 'typing_extensions':
+                self.__module__ = def_mod
+
+            self.__unpacked__ = Unpack[self]
+
+        def __repr__(self):
+            return self.__name__
+
+        def __hash__(self):
+            return object.__hash__(self)
+
+        def __eq__(self, other):
+            return self is other
+
+        def __reduce__(self):
+            return self.__name__
+
+        def __init_subclass__(self, *args, **kwds):
+            if '_root' not in kwds:
+                raise TypeError("Cannot subclass special typing classes")
+
+
+if hasattr(typing, "reveal_type"):  # 3.11+
+    reveal_type = typing.reveal_type
+else:  # <=3.10
+    def reveal_type(obj: T, /) -> T:
+        """Reveal the inferred type of a variable.
+
+        When a static type checker encounters a call to ``reveal_type()``,
+        it will emit the inferred type of the argument::
+
+            x: int = 1
+            reveal_type(x)
+
+        Running a static type checker (e.g., ``mypy``) on this example
+        will produce output similar to 'Revealed type is "builtins.int"'.
+
+        At runtime, the function prints the runtime type of the
+        argument and returns it unchanged.
+
+        """
+        print(f"Runtime type is {type(obj).__name__!r}", file=sys.stderr)
+        return obj
+
+
+if hasattr(typing, "_ASSERT_NEVER_REPR_MAX_LENGTH"):  # 3.11+
+    _ASSERT_NEVER_REPR_MAX_LENGTH = typing._ASSERT_NEVER_REPR_MAX_LENGTH
+else:  # <=3.10
+    _ASSERT_NEVER_REPR_MAX_LENGTH = 100
+
+
+if hasattr(typing, "assert_never"):  # 3.11+
+    assert_never = typing.assert_never
+else:  # <=3.10
+    def assert_never(arg: Never, /) -> Never:
+        """Assert to the type checker that a line of code is unreachable.
+
+        Example::
+
+            def int_or_str(arg: int | str) -> None:
+                match arg:
+                    case int():
+                        print("It's an int")
+                    case str():
+                        print("It's a str")
+                    case _:
+                        assert_never(arg)
+
+        If a type checker finds that a call to assert_never() is
+        reachable, it will emit an error.
+
+        At runtime, this throws an exception when called.
+
+        """
+        value = repr(arg)
+        if len(value) > _ASSERT_NEVER_REPR_MAX_LENGTH:
+            value = value[:_ASSERT_NEVER_REPR_MAX_LENGTH] + '...'
+        raise AssertionError(f"Expected code to be unreachable, but got: {value}")
+
+
+if sys.version_info >= (3, 12):  # 3.12+
+    # dataclass_transform exists in 3.11 but lacks the frozen_default parameter
+    dataclass_transform = typing.dataclass_transform
+else:  # <=3.11
+    def dataclass_transform(
+        *,
+        eq_default: bool = True,
+        order_default: bool = False,
+        kw_only_default: bool = False,
+        frozen_default: bool = False,
+        field_specifiers: typing.Tuple[
+            typing.Union[typing.Type[typing.Any], typing.Callable[..., typing.Any]],
+            ...
+        ] = (),
+        **kwargs: typing.Any,
+    ) -> typing.Callable[[T], T]:
+        """Decorator that marks a function, class, or metaclass as providing
+        dataclass-like behavior.
+
+        Example:
+
+            from pip._vendor.typing_extensions import dataclass_transform
+
+            _T = TypeVar("_T")
+
+            # Used on a decorator function
+            @dataclass_transform()
+            def create_model(cls: type[_T]) -> type[_T]:
+                ...
+                return cls
+
+            @create_model
+            class CustomerModel:
+                id: int
+                name: str
+
+            # Used on a base class
+            @dataclass_transform()
+            class ModelBase: ...
+
+            class CustomerModel(ModelBase):
+                id: int
+                name: str
+
+            # Used on a metaclass
+            @dataclass_transform()
+            class ModelMeta(type): ...
+
+            class ModelBase(metaclass=ModelMeta): ...
+
+            class CustomerModel(ModelBase):
+                id: int
+                name: str
+
+        Each of the ``CustomerModel`` classes defined in this example will now
+        behave similarly to a dataclass created with the ``@dataclasses.dataclass``
+        decorator. For example, the type checker will synthesize an ``__init__``
+        method.
+
+        The arguments to this decorator can be used to customize this behavior:
+        - ``eq_default`` indicates whether the ``eq`` parameter is assumed to be
+          True or False if it is omitted by the caller.
+        - ``order_default`` indicates whether the ``order`` parameter is
+          assumed to be True or False if it is omitted by the caller.
+        - ``kw_only_default`` indicates whether the ``kw_only`` parameter is
+          assumed to be True or False if it is omitted by the caller.
+        - ``frozen_default`` indicates whether the ``frozen`` parameter is
+          assumed to be True or False if it is omitted by the caller.
+        - ``field_specifiers`` specifies a static list of supported classes
+          or functions that describe fields, similar to ``dataclasses.field()``.
+
+        At runtime, this decorator records its arguments in the
+        ``__dataclass_transform__`` attribute on the decorated object.
+
+        See PEP 681 for details.
+
+        """
+        def decorator(cls_or_fn):
+            cls_or_fn.__dataclass_transform__ = {
+                "eq_default": eq_default,
+                "order_default": order_default,
+                "kw_only_default": kw_only_default,
+                "frozen_default": frozen_default,
+                "field_specifiers": field_specifiers,
+                "kwargs": kwargs,
+            }
+            return cls_or_fn
+        return decorator
+
+
+if hasattr(typing, "override"):  # 3.12+
+    override = typing.override
+else:  # <=3.11
+    _F = typing.TypeVar("_F", bound=typing.Callable[..., typing.Any])
+
+    def override(arg: _F, /) -> _F:
+        """Indicate that a method is intended to override a method in a base class.
+
+        Usage:
+
+            class Base:
+                def method(self) -> None:
+                    pass
+
+            class Child(Base):
+                @override
+                def method(self) -> None:
+                    super().method()
+
+        When this decorator is applied to a method, the type checker will
+        validate that it overrides a method with the same name on a base class.
+        This helps prevent bugs that may occur when a base class is changed
+        without an equivalent change to a child class.
+
+        There is no runtime checking of these properties. The decorator
+        sets the ``__override__`` attribute to ``True`` on the decorated object
+        to allow runtime introspection.
+
+        See PEP 698 for details.
+
+        """
+        try:
+            arg.__override__ = True
+        except (AttributeError, TypeError):
+            # Skip the attribute silently if it is not writable.
+            # AttributeError happens if the object has __slots__ or a
+            # read-only property, TypeError if it's a builtin class.
+            pass
+        return arg
+
+
+if hasattr(warnings, "deprecated"):
+    deprecated = warnings.deprecated
+else:
+    _T = typing.TypeVar("_T")
+
+    class deprecated:
+        """Indicate that a class, function or overload is deprecated.
+
+        When this decorator is applied to an object, the type checker
+        will generate a diagnostic on usage of the deprecated object.
+
+        Usage:
+
+            @deprecated("Use B instead")
+            class A:
+                pass
+
+            @deprecated("Use g instead")
+            def f():
+                pass
+
+            @overload
+            @deprecated("int support is deprecated")
+            def g(x: int) -> int: ...
+            @overload
+            def g(x: str) -> int: ...
+
+        The warning specified by *category* will be emitted at runtime
+        on use of deprecated objects. For functions, that happens on calls;
+        for classes, on instantiation and on creation of subclasses.
+        If the *category* is ``None``, no warning is emitted at runtime.
+        The *stacklevel* determines where the
+        warning is emitted. If it is ``1`` (the default), the warning
+        is emitted at the direct caller of the deprecated object; if it
+        is higher, it is emitted further up the stack.
+        Static type checker behavior is not affected by the *category*
+        and *stacklevel* arguments.
+
+        The deprecation message passed to the decorator is saved in the
+        ``__deprecated__`` attribute on the decorated object.
+        If applied to an overload, the decorator
+        must be after the ``@overload`` decorator for the attribute to
+        exist on the overload as returned by ``get_overloads()``.
+
+        See PEP 702 for details.
+
+        """
+        def __init__(
+            self,
+            message: str,
+            /,
+            *,
+            category: typing.Optional[typing.Type[Warning]] = DeprecationWarning,
+            stacklevel: int = 1,
+        ) -> None:
+            if not isinstance(message, str):
+                raise TypeError(
+                    "Expected an object of type str for 'message', not "
+                    f"{type(message).__name__!r}"
+                )
+            self.message = message
+            self.category = category
+            self.stacklevel = stacklevel
+
+        def __call__(self, arg: _T, /) -> _T:
+            # Make sure the inner functions created below don't
+            # retain a reference to self.
+            msg = self.message
+            category = self.category
+            stacklevel = self.stacklevel
+            if category is None:
+                arg.__deprecated__ = msg
+                return arg
+            elif isinstance(arg, type):
+                import functools
+                from types import MethodType
+
+                original_new = arg.__new__
+
+                @functools.wraps(original_new)
+                def __new__(cls, *args, **kwargs):
+                    if cls is arg:
+                        warnings.warn(msg, category=category, stacklevel=stacklevel + 1)
+                    if original_new is not object.__new__:
+                        return original_new(cls, *args, **kwargs)
+                    # Mirrors a similar check in object.__new__.
+                    elif cls.__init__ is object.__init__ and (args or kwargs):
+                        raise TypeError(f"{cls.__name__}() takes no arguments")
+                    else:
+                        return original_new(cls)
+
+                arg.__new__ = staticmethod(__new__)
+
+                original_init_subclass = arg.__init_subclass__
+                # We need slightly different behavior if __init_subclass__
+                # is a bound method (likely if it was implemented in Python)
+                if isinstance(original_init_subclass, MethodType):
+                    original_init_subclass = original_init_subclass.__func__
+
+                    @functools.wraps(original_init_subclass)
+                    def __init_subclass__(*args, **kwargs):
+                        warnings.warn(msg, category=category, stacklevel=stacklevel + 1)
+                        return original_init_subclass(*args, **kwargs)
+
+                    arg.__init_subclass__ = classmethod(__init_subclass__)
+                # Or otherwise, which likely means it's a builtin such as
+                # object's implementation of __init_subclass__.
+                else:
+                    @functools.wraps(original_init_subclass)
+                    def __init_subclass__(*args, **kwargs):
+                        warnings.warn(msg, category=category, stacklevel=stacklevel + 1)
+                        return original_init_subclass(*args, **kwargs)
+
+                    arg.__init_subclass__ = __init_subclass__
+
+                arg.__deprecated__ = __new__.__deprecated__ = msg
+                __init_subclass__.__deprecated__ = msg
+                return arg
+            elif callable(arg):
+                import functools
+
+                @functools.wraps(arg)
+                def wrapper(*args, **kwargs):
+                    warnings.warn(msg, category=category, stacklevel=stacklevel + 1)
+                    return arg(*args, **kwargs)
+
+                arg.__deprecated__ = wrapper.__deprecated__ = msg
+                return wrapper
+            else:
+                raise TypeError(
+                    "@deprecated decorator with non-None category must be applied to "
+                    f"a class or callable, not {arg!r}"
+                )
+
+
+# We have to do some monkey patching to deal with the dual nature of
+# Unpack/TypeVarTuple:
+# - We want Unpack to be a kind of TypeVar so it gets accepted in
+#   Generic[Unpack[Ts]]
+# - We want it to *not* be treated as a TypeVar for the purposes of
+#   counting generic parameters, so that when we subscript a generic,
+#   the runtime doesn't try to substitute the Unpack with the subscripted type.
+if not hasattr(typing, "TypeVarTuple"):
+    def _check_generic(cls, parameters, elen=_marker):
+        """Check correct count for parameters of a generic cls (internal helper).
+
+        This gives a nice error message in case of count mismatch.
+        """
+        if not elen:
+            raise TypeError(f"{cls} is not a generic class")
+        if elen is _marker:
+            if not hasattr(cls, "__parameters__") or not cls.__parameters__:
+                raise TypeError(f"{cls} is not a generic class")
+            elen = len(cls.__parameters__)
+        alen = len(parameters)
+        if alen != elen:
+            expect_val = elen
+            if hasattr(cls, "__parameters__"):
+                parameters = [p for p in cls.__parameters__ if not _is_unpack(p)]
+                num_tv_tuples = sum(isinstance(p, TypeVarTuple) for p in parameters)
+                if (num_tv_tuples > 0) and (alen >= elen - num_tv_tuples):
+                    return
+
+                # deal with TypeVarLike defaults
+                # required TypeVarLikes cannot appear after a defaulted one.
+                if alen < elen:
+                    # since we validate TypeVarLike default in _collect_type_vars
+                    # or _collect_parameters we can safely check parameters[alen]
+                    if (
+                        getattr(parameters[alen], '__default__', NoDefault)
+                        is not NoDefault
+                    ):
+                        return
+
+                    num_default_tv = sum(getattr(p, '__default__', NoDefault)
+                                         is not NoDefault for p in parameters)
+
+                    elen -= num_default_tv
+
+                    expect_val = f"at least {elen}"
+
+            things = "arguments" if sys.version_info >= (3, 10) else "parameters"
+            raise TypeError(f"Too {'many' if alen > elen else 'few'} {things}"
+                            f" for {cls}; actual {alen}, expected {expect_val}")
+else:
+    # Python 3.11+
+
+    def _check_generic(cls, parameters, elen):
+        """Check correct count for parameters of a generic cls (internal helper).
+
+        This gives a nice error message in case of count mismatch.
+        """
+        if not elen:
+            raise TypeError(f"{cls} is not a generic class")
+        alen = len(parameters)
+        if alen != elen:
+            expect_val = elen
+            if hasattr(cls, "__parameters__"):
+                parameters = [p for p in cls.__parameters__ if not _is_unpack(p)]
+
+                # deal with TypeVarLike defaults
+                # required TypeVarLikes cannot appear after a defaulted one.
+                if alen < elen:
+                    # since we validate TypeVarLike default in _collect_type_vars
+                    # or _collect_parameters we can safely check parameters[alen]
+                    if (
+                        getattr(parameters[alen], '__default__', NoDefault)
+                        is not NoDefault
+                    ):
+                        return
+
+                    num_default_tv = sum(getattr(p, '__default__', NoDefault)
+                                         is not NoDefault for p in parameters)
+
+                    elen -= num_default_tv
+
+                    expect_val = f"at least {elen}"
+
+            raise TypeError(f"Too {'many' if alen > elen else 'few'} arguments"
+                            f" for {cls}; actual {alen}, expected {expect_val}")
+
+if not _PEP_696_IMPLEMENTED:
+    typing._check_generic = _check_generic
+
+
+def _has_generic_or_protocol_as_origin() -> bool:
+    try:
+        frame = sys._getframe(2)
+    # - Catch AttributeError: not all Python implementations have sys._getframe()
+    # - Catch ValueError: maybe we're called from an unexpected module
+    #   and the call stack isn't deep enough
+    except (AttributeError, ValueError):
+        return False  # err on the side of leniency
+    else:
+        # If we somehow get invoked from outside typing.py,
+        # also err on the side of leniency
+        if frame.f_globals.get("__name__") != "typing":
+            return False
+        origin = frame.f_locals.get("origin")
+        # Cannot use "in" because origin may be an object with a buggy __eq__ that
+        # throws an error.
+        return origin is typing.Generic or origin is Protocol or origin is typing.Protocol
+
+
+_TYPEVARTUPLE_TYPES = {TypeVarTuple, getattr(typing, "TypeVarTuple", None)}
+
+
+def _is_unpacked_typevartuple(x) -> bool:
+    if get_origin(x) is not Unpack:
+        return False
+    args = get_args(x)
+    return (
+        bool(args)
+        and len(args) == 1
+        and type(args[0]) in _TYPEVARTUPLE_TYPES
+    )
+
+
+# Python 3.11+ _collect_type_vars was renamed to _collect_parameters
+if hasattr(typing, '_collect_type_vars'):
+    def _collect_type_vars(types, typevar_types=None):
+        """Collect all type variable contained in types in order of
+        first appearance (lexicographic order). For example::
+
+            _collect_type_vars((T, List[S, T])) == (T, S)
+        """
+        if typevar_types is None:
+            typevar_types = typing.TypeVar
+        tvars = []
+
+        # A required TypeVarLike cannot appear after a TypeVarLike with a default
+        # if it was a direct call to `Generic[]` or `Protocol[]`
+        enforce_default_ordering = _has_generic_or_protocol_as_origin()
+        default_encountered = False
+
+        # Also, a TypeVarLike with a default cannot appear after a TypeVarTuple
+        type_var_tuple_encountered = False
+
+        for t in types:
+            if _is_unpacked_typevartuple(t):
+                type_var_tuple_encountered = True
+            elif isinstance(t, typevar_types) and t not in tvars:
+                if enforce_default_ordering:
+                    has_default = getattr(t, '__default__', NoDefault) is not NoDefault
+                    if has_default:
+                        if type_var_tuple_encountered:
+                            raise TypeError('Type parameter with a default'
+                                            ' follows TypeVarTuple')
+                        default_encountered = True
+                    elif default_encountered:
+                        raise TypeError(f'Type parameter {t!r} without a default'
+                                        ' follows type parameter with a default')
+
+                tvars.append(t)
+            if _should_collect_from_parameters(t):
+                tvars.extend([t for t in t.__parameters__ if t not in tvars])
+        return tuple(tvars)
+
+    typing._collect_type_vars = _collect_type_vars
+else:
+    def _collect_parameters(args):
+        """Collect all type variables and parameter specifications in args
+        in order of first appearance (lexicographic order).
+
+        For example::
+
+            assert _collect_parameters((T, Callable[P, T])) == (T, P)
+        """
+        parameters = []
+
+        # A required TypeVarLike cannot appear after a TypeVarLike with default
+        # if it was a direct call to `Generic[]` or `Protocol[]`
+        enforce_default_ordering = _has_generic_or_protocol_as_origin()
+        default_encountered = False
+
+        # Also, a TypeVarLike with a default cannot appear after a TypeVarTuple
+        type_var_tuple_encountered = False
+
+        for t in args:
+            if isinstance(t, type):
+                # We don't want __parameters__ descriptor of a bare Python class.
+                pass
+            elif isinstance(t, tuple):
+                # `t` might be a tuple, when `ParamSpec` is substituted with
+                # `[T, int]`, or `[int, *Ts]`, etc.
+                for x in t:
+                    for collected in _collect_parameters([x]):
+                        if collected not in parameters:
+                            parameters.append(collected)
+            elif hasattr(t, '__typing_subst__'):
+                if t not in parameters:
+                    if enforce_default_ordering:
+                        has_default = (
+                            getattr(t, '__default__', NoDefault) is not NoDefault
+                        )
+
+                        if type_var_tuple_encountered and has_default:
+                            raise TypeError('Type parameter with a default'
+                                            ' follows TypeVarTuple')
+
+                        if has_default:
+                            default_encountered = True
+                        elif default_encountered:
+                            raise TypeError(f'Type parameter {t!r} without a default'
+                                            ' follows type parameter with a default')
+
+                    parameters.append(t)
+            else:
+                if _is_unpacked_typevartuple(t):
+                    type_var_tuple_encountered = True
+                for x in getattr(t, '__parameters__', ()):
+                    if x not in parameters:
+                        parameters.append(x)
+
+        return tuple(parameters)
+
+    if not _PEP_696_IMPLEMENTED:
+        typing._collect_parameters = _collect_parameters
+
+# Backport typing.NamedTuple as it exists in Python 3.13.
+# In 3.11, the ability to define generic `NamedTuple`s was supported.
+# This was explicitly disallowed in 3.9-3.10, and only half-worked in <=3.8.
+# On 3.12, we added __orig_bases__ to call-based NamedTuples
+# On 3.13, we deprecated kwargs-based NamedTuples
+if sys.version_info >= (3, 13):
+    NamedTuple = typing.NamedTuple
+else:
+    def _make_nmtuple(name, types, module, defaults=()):
+        fields = [n for n, t in types]
+        annotations = {n: typing._type_check(t, f"field {n} annotation must be a type")
+                       for n, t in types}
+        nm_tpl = collections.namedtuple(name, fields,
+                                        defaults=defaults, module=module)
+        nm_tpl.__annotations__ = nm_tpl.__new__.__annotations__ = annotations
+        # The `_field_types` attribute was removed in 3.9;
+        # in earlier versions, it is the same as the `__annotations__` attribute
+        if sys.version_info < (3, 9):
+            nm_tpl._field_types = annotations
+        return nm_tpl
+
+    _prohibited_namedtuple_fields = typing._prohibited
+    _special_namedtuple_fields = frozenset({'__module__', '__name__', '__annotations__'})
+
+    class _NamedTupleMeta(type):
+        def __new__(cls, typename, bases, ns):
+            assert _NamedTuple in bases
+            for base in bases:
+                if base is not _NamedTuple and base is not typing.Generic:
+                    raise TypeError(
+                        'can only inherit from a NamedTuple type and Generic')
+            bases = tuple(tuple if base is _NamedTuple else base for base in bases)
+            if "__annotations__" in ns:
+                types = ns["__annotations__"]
+            elif "__annotate__" in ns:
+                # TODO: Use inspect.VALUE here, and make the annotations lazily evaluated
+                types = ns["__annotate__"](1)
+            else:
+                types = {}
+            default_names = []
+            for field_name in types:
+                if field_name in ns:
+                    default_names.append(field_name)
+                elif default_names:
+                    raise TypeError(f"Non-default namedtuple field {field_name} "
+                                    f"cannot follow default field"
+                                    f"{'s' if len(default_names) > 1 else ''} "
+                                    f"{', '.join(default_names)}")
+            nm_tpl = _make_nmtuple(
+                typename, types.items(),
+                defaults=[ns[n] for n in default_names],
+                module=ns['__module__']
+            )
+            nm_tpl.__bases__ = bases
+            if typing.Generic in bases:
+                if hasattr(typing, '_generic_class_getitem'):  # 3.12+
+                    nm_tpl.__class_getitem__ = classmethod(typing._generic_class_getitem)
+                else:
+                    class_getitem = typing.Generic.__class_getitem__.__func__
+                    nm_tpl.__class_getitem__ = classmethod(class_getitem)
+            # update from user namespace without overriding special namedtuple attributes
+            for key, val in ns.items():
+                if key in _prohibited_namedtuple_fields:
+                    raise AttributeError("Cannot overwrite NamedTuple attribute " + key)
+                elif key not in _special_namedtuple_fields:
+                    if key not in nm_tpl._fields:
+                        setattr(nm_tpl, key, ns[key])
+                    try:
+                        set_name = type(val).__set_name__
+                    except AttributeError:
+                        pass
+                    else:
+                        try:
+                            set_name(val, nm_tpl, key)
+                        except BaseException as e:
+                            msg = (
+                                f"Error calling __set_name__ on {type(val).__name__!r} "
+                                f"instance {key!r} in {typename!r}"
+                            )
+                            # BaseException.add_note() existed on py311,
+                            # but the __set_name__ machinery didn't start
+                            # using add_note() until py312.
+                            # Making sure exceptions are raised in the same way
+                            # as in "normal" classes seems most important here.
+                            if sys.version_info >= (3, 12):
+                                e.add_note(msg)
+                                raise
+                            else:
+                                raise RuntimeError(msg) from e
+
+            if typing.Generic in bases:
+                nm_tpl.__init_subclass__()
+            return nm_tpl
+
+    _NamedTuple = type.__new__(_NamedTupleMeta, 'NamedTuple', (), {})
+
+    def _namedtuple_mro_entries(bases):
+        assert NamedTuple in bases
+        return (_NamedTuple,)
+
+    @_ensure_subclassable(_namedtuple_mro_entries)
+    def NamedTuple(typename, fields=_marker, /, **kwargs):
+        """Typed version of namedtuple.
+
+        Usage::
+
+            class Employee(NamedTuple):
+                name: str
+                id: int
+
+        This is equivalent to::
+
+            Employee = collections.namedtuple('Employee', ['name', 'id'])
+
+        The resulting class has an extra __annotations__ attribute, giving a
+        dict that maps field names to types.  (The field names are also in
+        the _fields attribute, which is part of the namedtuple API.)
+        An alternative equivalent functional syntax is also accepted::
+
+            Employee = NamedTuple('Employee', [('name', str), ('id', int)])
+        """
+        if fields is _marker:
+            if kwargs:
+                deprecated_thing = "Creating NamedTuple classes using keyword arguments"
+                deprecation_msg = (
+                    "{name} is deprecated and will be disallowed in Python {remove}. "
+                    "Use the class-based or functional syntax instead."
+                )
+            else:
+                deprecated_thing = "Failing to pass a value for the 'fields' parameter"
+                example = f"`{typename} = NamedTuple({typename!r}, [])`"
+                deprecation_msg = (
+                    "{name} is deprecated and will be disallowed in Python {remove}. "
+                    "To create a NamedTuple class with 0 fields "
+                    "using the functional syntax, "
+                    "pass an empty list, e.g. "
+                ) + example + "."
+        elif fields is None:
+            if kwargs:
+                raise TypeError(
+                    "Cannot pass `None` as the 'fields' parameter "
+                    "and also specify fields using keyword arguments"
+                )
+            else:
+                deprecated_thing = "Passing `None` as the 'fields' parameter"
+                example = f"`{typename} = NamedTuple({typename!r}, [])`"
+                deprecation_msg = (
+                    "{name} is deprecated and will be disallowed in Python {remove}. "
+                    "To create a NamedTuple class with 0 fields "
+                    "using the functional syntax, "
+                    "pass an empty list, e.g. "
+                ) + example + "."
+        elif kwargs:
+            raise TypeError("Either list of fields or keywords"
+                            " can be provided to NamedTuple, not both")
+        if fields is _marker or fields is None:
+            warnings.warn(
+                deprecation_msg.format(name=deprecated_thing, remove="3.15"),
+                DeprecationWarning,
+                stacklevel=2,
+            )
+            fields = kwargs.items()
+        nt = _make_nmtuple(typename, fields, module=_caller())
+        nt.__orig_bases__ = (NamedTuple,)
+        return nt
+
+
+if hasattr(collections.abc, "Buffer"):
+    Buffer = collections.abc.Buffer
+else:
+    class Buffer(abc.ABC):  # noqa: B024
+        """Base class for classes that implement the buffer protocol.
+
+        The buffer protocol allows Python objects to expose a low-level
+        memory buffer interface. Before Python 3.12, it is not possible
+        to implement the buffer protocol in pure Python code, or even
+        to check whether a class implements the buffer protocol. In
+        Python 3.12 and higher, the ``__buffer__`` method allows access
+        to the buffer protocol from Python code, and the
+        ``collections.abc.Buffer`` ABC allows checking whether a class
+        implements the buffer protocol.
+
+        To indicate support for the buffer protocol in earlier versions,
+        inherit from this ABC, either in a stub file or at runtime,
+        or use ABC registration. This ABC provides no methods, because
+        there is no Python-accessible methods shared by pre-3.12 buffer
+        classes. It is useful primarily for static checks.
+
+        """
+
+    # As a courtesy, register the most common stdlib buffer classes.
+    Buffer.register(memoryview)
+    Buffer.register(bytearray)
+    Buffer.register(bytes)
+
+
+# Backport of types.get_original_bases, available on 3.12+ in CPython
+if hasattr(_types, "get_original_bases"):
+    get_original_bases = _types.get_original_bases
+else:
+    def get_original_bases(cls, /):
+        """Return the class's "original" bases prior to modification by `__mro_entries__`.
+
+        Examples::
+
+            from typing import TypeVar, Generic
+            from pip._vendor.typing_extensions import NamedTuple, TypedDict
+
+            T = TypeVar("T")
+            class Foo(Generic[T]): ...
+            class Bar(Foo[int], float): ...
+            class Baz(list[str]): ...
+            Eggs = NamedTuple("Eggs", [("a", int), ("b", str)])
+            Spam = TypedDict("Spam", {"a": int, "b": str})
+
+            assert get_original_bases(Bar) == (Foo[int], float)
+            assert get_original_bases(Baz) == (list[str],)
+            assert get_original_bases(Eggs) == (NamedTuple,)
+            assert get_original_bases(Spam) == (TypedDict,)
+            assert get_original_bases(int) == (object,)
+        """
+        try:
+            return cls.__dict__.get("__orig_bases__", cls.__bases__)
+        except AttributeError:
+            raise TypeError(
+                f'Expected an instance of type, not {type(cls).__name__!r}'
+            ) from None
+
+
+# NewType is a class on Python 3.10+, making it pickleable
+# The error message for subclassing instances of NewType was improved on 3.11+
+if sys.version_info >= (3, 11):
+    NewType = typing.NewType
+else:
+    class NewType:
+        """NewType creates simple unique types with almost zero
+        runtime overhead. NewType(name, tp) is considered a subtype of tp
+        by static type checkers. At runtime, NewType(name, tp) returns
+        a dummy callable that simply returns its argument. Usage::
+            UserId = NewType('UserId', int)
+            def name_by_id(user_id: UserId) -> str:
+                ...
+            UserId('user')          # Fails type check
+            name_by_id(42)          # Fails type check
+            name_by_id(UserId(42))  # OK
+            num = UserId(5) + 1     # type: int
+        """
+
+        def __call__(self, obj, /):
+            return obj
+
+        def __init__(self, name, tp):
+            self.__qualname__ = name
+            if '.' in name:
+                name = name.rpartition('.')[-1]
+            self.__name__ = name
+            self.__supertype__ = tp
+            def_mod = _caller()
+            if def_mod != 'typing_extensions':
+                self.__module__ = def_mod
+
+        def __mro_entries__(self, bases):
+            # We defined __mro_entries__ to get a better error message
+            # if a user attempts to subclass a NewType instance. bpo-46170
+            supercls_name = self.__name__
+
+            class Dummy:
+                def __init_subclass__(cls):
+                    subcls_name = cls.__name__
+                    raise TypeError(
+                        f"Cannot subclass an instance of NewType. "
+                        f"Perhaps you were looking for: "
+                        f"`{subcls_name} = NewType({subcls_name!r}, {supercls_name})`"
+                    )
+
+            return (Dummy,)
+
+        def __repr__(self):
+            return f'{self.__module__}.{self.__qualname__}'
+
+        def __reduce__(self):
+            return self.__qualname__
+
+        if sys.version_info >= (3, 10):
+            # PEP 604 methods
+            # It doesn't make sense to have these methods on Python <3.10
+
+            def __or__(self, other):
+                return typing.Union[self, other]
+
+            def __ror__(self, other):
+                return typing.Union[other, self]
+
+
+if hasattr(typing, "TypeAliasType"):
+    TypeAliasType = typing.TypeAliasType
+else:
+    def _is_unionable(obj):
+        """Corresponds to is_unionable() in unionobject.c in CPython."""
+        return obj is None or isinstance(obj, (
+            type,
+            _types.GenericAlias,
+            _types.UnionType,
+            TypeAliasType,
+        ))
+
+    class TypeAliasType:
+        """Create named, parameterized type aliases.
+
+        This provides a backport of the new `type` statement in Python 3.12:
+
+            type ListOrSet[T] = list[T] | set[T]
+
+        is equivalent to:
+
+            T = TypeVar("T")
+            ListOrSet = TypeAliasType("ListOrSet", list[T] | set[T], type_params=(T,))
+
+        The name ListOrSet can then be used as an alias for the type it refers to.
+
+        The type_params argument should contain all the type parameters used
+        in the value of the type alias. If the alias is not generic, this
+        argument is omitted.
+
+        Static type checkers should only support type aliases declared using
+        TypeAliasType that follow these rules:
+
+        - The first argument (the name) must be a string literal.
+        - The TypeAliasType instance must be immediately assigned to a variable
+          of the same name. (For example, 'X = TypeAliasType("Y", int)' is invalid,
+          as is 'X, Y = TypeAliasType("X", int), TypeAliasType("Y", int)').
+
+        """
+
+        def __init__(self, name: str, value, *, type_params=()):
+            if not isinstance(name, str):
+                raise TypeError("TypeAliasType name must be a string")
+            self.__value__ = value
+            self.__type_params__ = type_params
+
+            parameters = []
+            for type_param in type_params:
+                if isinstance(type_param, TypeVarTuple):
+                    parameters.extend(type_param)
+                else:
+                    parameters.append(type_param)
+            self.__parameters__ = tuple(parameters)
+            def_mod = _caller()
+            if def_mod != 'typing_extensions':
+                self.__module__ = def_mod
+            # Setting this attribute closes the TypeAliasType from further modification
+            self.__name__ = name
+
+        def __setattr__(self, name: str, value: object, /) -> None:
+            if hasattr(self, "__name__"):
+                self._raise_attribute_error(name)
+            super().__setattr__(name, value)
+
+        def __delattr__(self, name: str, /) -> Never:
+            self._raise_attribute_error(name)
+
+        def _raise_attribute_error(self, name: str) -> Never:
+            # Match the Python 3.12 error messages exactly
+            if name == "__name__":
+                raise AttributeError("readonly attribute")
+            elif name in {"__value__", "__type_params__", "__parameters__", "__module__"}:
+                raise AttributeError(
+                    f"attribute '{name}' of 'typing.TypeAliasType' objects "
+                    "is not writable"
+                )
+            else:
+                raise AttributeError(
+                    f"'typing.TypeAliasType' object has no attribute '{name}'"
+                )
+
+        def __repr__(self) -> str:
+            return self.__name__
+
+        def __getitem__(self, parameters):
+            if not isinstance(parameters, tuple):
+                parameters = (parameters,)
+            parameters = [
+                typing._type_check(
+                    item, f'Subscripting {self.__name__} requires a type.'
+                )
+                for item in parameters
+            ]
+            return typing._GenericAlias(self, tuple(parameters))
+
+        def __reduce__(self):
+            return self.__name__
+
+        def __init_subclass__(cls, *args, **kwargs):
+            raise TypeError(
+                "type 'typing_extensions.TypeAliasType' is not an acceptable base type"
+            )
+
+        # The presence of this method convinces typing._type_check
+        # that TypeAliasTypes are types.
+        def __call__(self):
+            raise TypeError("Type alias is not callable")
+
+        if sys.version_info >= (3, 10):
+            def __or__(self, right):
+                # For forward compatibility with 3.12, reject Unions
+                # that are not accepted by the built-in Union.
+                if not _is_unionable(right):
+                    return NotImplemented
+                return typing.Union[self, right]
+
+            def __ror__(self, left):
+                if not _is_unionable(left):
+                    return NotImplemented
+                return typing.Union[left, self]
+
+
+if hasattr(typing, "is_protocol"):
+    is_protocol = typing.is_protocol
+    get_protocol_members = typing.get_protocol_members
+else:
+    def is_protocol(tp: type, /) -> bool:
+        """Return True if the given type is a Protocol.
+
+        Example::
+
+            >>> from typing_extensions import Protocol, is_protocol
+            >>> class P(Protocol):
+            ...     def a(self) -> str: ...
+            ...     b: int
+            >>> is_protocol(P)
+            True
+            >>> is_protocol(int)
+            False
+        """
+        return (
+            isinstance(tp, type)
+            and getattr(tp, '_is_protocol', False)
+            and tp is not Protocol
+            and tp is not typing.Protocol
+        )
+
+    def get_protocol_members(tp: type, /) -> typing.FrozenSet[str]:
+        """Return the set of members defined in a Protocol.
+
+        Example::
+
+            >>> from typing_extensions import Protocol, get_protocol_members
+            >>> class P(Protocol):
+            ...     def a(self) -> str: ...
+            ...     b: int
+            >>> get_protocol_members(P)
+            frozenset({'a', 'b'})
+
+        Raise a TypeError for arguments that are not Protocols.
+        """
+        if not is_protocol(tp):
+            raise TypeError(f'{tp!r} is not a Protocol')
+        if hasattr(tp, '__protocol_attrs__'):
+            return frozenset(tp.__protocol_attrs__)
+        return frozenset(_get_protocol_attrs(tp))
+
+
+if hasattr(typing, "Doc"):
+    Doc = typing.Doc
+else:
+    class Doc:
+        """Define the documentation of a type annotation using ``Annotated``, to be
+         used in class attributes, function and method parameters, return values,
+         and variables.
+
+        The value should be a positional-only string literal to allow static tools
+        like editors and documentation generators to use it.
+
+        This complements docstrings.
+
+        The string value passed is available in the attribute ``documentation``.
+
+        Example::
+
+            >>> from typing_extensions import Annotated, Doc
+            >>> def hi(to: Annotated[str, Doc("Who to say hi to")]) -> None: ...
+        """
+        def __init__(self, documentation: str, /) -> None:
+            self.documentation = documentation
+
+        def __repr__(self) -> str:
+            return f"Doc({self.documentation!r})"
+
+        def __hash__(self) -> int:
+            return hash(self.documentation)
+
+        def __eq__(self, other: object) -> bool:
+            if not isinstance(other, Doc):
+                return NotImplemented
+            return self.documentation == other.documentation
+
+
+_CapsuleType = getattr(_types, "CapsuleType", None)
+
+if _CapsuleType is None:
+    try:
+        import _socket
+    except ImportError:
+        pass
+    else:
+        _CAPI = getattr(_socket, "CAPI", None)
+        if _CAPI is not None:
+            _CapsuleType = type(_CAPI)
+
+if _CapsuleType is not None:
+    CapsuleType = _CapsuleType
+    __all__.append("CapsuleType")
+
+
+# Aliases for items that have always been in typing.
+# Explicitly assign these (rather than using `from typing import *` at the top),
+# so that we get a CI error if one of these is deleted from typing.py
+# in a future version of Python
+AbstractSet = typing.AbstractSet
+AnyStr = typing.AnyStr
+BinaryIO = typing.BinaryIO
+Callable = typing.Callable
+Collection = typing.Collection
+Container = typing.Container
+Dict = typing.Dict
+ForwardRef = typing.ForwardRef
+FrozenSet = typing.FrozenSet
+Generic = typing.Generic
+Hashable = typing.Hashable
+IO = typing.IO
+ItemsView = typing.ItemsView
+Iterable = typing.Iterable
+Iterator = typing.Iterator
+KeysView = typing.KeysView
+List = typing.List
+Mapping = typing.Mapping
+MappingView = typing.MappingView
+Match = typing.Match
+MutableMapping = typing.MutableMapping
+MutableSequence = typing.MutableSequence
+MutableSet = typing.MutableSet
+Optional = typing.Optional
+Pattern = typing.Pattern
+Reversible = typing.Reversible
+Sequence = typing.Sequence
+Set = typing.Set
+Sized = typing.Sized
+TextIO = typing.TextIO
+Tuple = typing.Tuple
+Union = typing.Union
+ValuesView = typing.ValuesView
+cast = typing.cast
+no_type_check = typing.no_type_check
+no_type_check_decorator = typing.no_type_check_decorator
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/__init__.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/__init__.py
new file mode 100644
index 0000000..c6fa382
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/__init__.py
@@ -0,0 +1,102 @@
+"""
+Python HTTP library with thread-safe connection pooling, file post support, user friendly, and more
+"""
+from __future__ import absolute_import
+
+# Set default logging handler to avoid "No handler found" warnings.
+import logging
+import warnings
+from logging import NullHandler
+
+from . import exceptions
+from ._version import __version__
+from .connectionpool import HTTPConnectionPool, HTTPSConnectionPool, connection_from_url
+from .filepost import encode_multipart_formdata
+from .poolmanager import PoolManager, ProxyManager, proxy_from_url
+from .response import HTTPResponse
+from .util.request import make_headers
+from .util.retry import Retry
+from .util.timeout import Timeout
+from .util.url import get_host
+
+# === NOTE TO REPACKAGERS AND VENDORS ===
+# Please delete this block, this logic is only
+# for urllib3 being distributed via PyPI.
+# See: https://github.com/urllib3/urllib3/issues/2680
+try:
+    import urllib3_secure_extra  # type: ignore # noqa: F401
+except ImportError:
+    pass
+else:
+    warnings.warn(
+        "'urllib3[secure]' extra is deprecated and will be removed "
+        "in a future release of urllib3 2.x. Read more in this issue: "
+        "https://github.com/urllib3/urllib3/issues/2680",
+        category=DeprecationWarning,
+        stacklevel=2,
+    )
+
+__author__ = "Andrey Petrov (andrey.petrov@shazow.net)"
+__license__ = "MIT"
+__version__ = __version__
+
+__all__ = (
+    "HTTPConnectionPool",
+    "HTTPSConnectionPool",
+    "PoolManager",
+    "ProxyManager",
+    "HTTPResponse",
+    "Retry",
+    "Timeout",
+    "add_stderr_logger",
+    "connection_from_url",
+    "disable_warnings",
+    "encode_multipart_formdata",
+    "get_host",
+    "make_headers",
+    "proxy_from_url",
+)
+
+logging.getLogger(__name__).addHandler(NullHandler())
+
+
+def add_stderr_logger(level=logging.DEBUG):
+    """
+    Helper for quickly adding a StreamHandler to the logger. Useful for
+    debugging.
+
+    Returns the handler after adding it.
+    """
+    # This method needs to be in this __init__.py to get the __name__ correct
+    # even if urllib3 is vendored within another package.
+    logger = logging.getLogger(__name__)
+    handler = logging.StreamHandler()
+    handler.setFormatter(logging.Formatter("%(asctime)s %(levelname)s %(message)s"))
+    logger.addHandler(handler)
+    logger.setLevel(level)
+    logger.debug("Added a stderr logging handler to logger: %s", __name__)
+    return handler
+
+
+# ... Clean up.
+del NullHandler
+
+
+# All warning filters *must* be appended unless you're really certain that they
+# shouldn't be: otherwise, it's very hard for users to use most Python
+# mechanisms to silence them.
+# SecurityWarning's always go off by default.
+warnings.simplefilter("always", exceptions.SecurityWarning, append=True)
+# SubjectAltNameWarning's should go off once per host
+warnings.simplefilter("default", exceptions.SubjectAltNameWarning, append=True)
+# InsecurePlatformWarning's don't vary between requests, so we keep it default.
+warnings.simplefilter("default", exceptions.InsecurePlatformWarning, append=True)
+# SNIMissingWarnings should go off only once.
+warnings.simplefilter("default", exceptions.SNIMissingWarning, append=True)
+
+
+def disable_warnings(category=exceptions.HTTPWarning):
+    """
+    Helper for quickly disabling all urllib3 warnings.
+    """
+    warnings.simplefilter("ignore", category)
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/__pycache__/__init__.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/__pycache__/__init__.cpython-312.pyc
new file mode 100644
index 0000000..f5144b9
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/__pycache__/__init__.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/__pycache__/_collections.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/__pycache__/_collections.cpython-312.pyc
new file mode 100644
index 0000000..5c8c9e9
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/__pycache__/_collections.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/__pycache__/_version.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/__pycache__/_version.cpython-312.pyc
new file mode 100644
index 0000000..63b08db
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/__pycache__/_version.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/__pycache__/connection.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/__pycache__/connection.cpython-312.pyc
new file mode 100644
index 0000000..15950bb
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/__pycache__/connection.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/__pycache__/connectionpool.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/__pycache__/connectionpool.cpython-312.pyc
new file mode 100644
index 0000000..d2e6b67
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/__pycache__/connectionpool.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/__pycache__/exceptions.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/__pycache__/exceptions.cpython-312.pyc
new file mode 100644
index 0000000..eeb2fd7
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/__pycache__/exceptions.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/__pycache__/fields.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/__pycache__/fields.cpython-312.pyc
new file mode 100644
index 0000000..f145b02
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/__pycache__/fields.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/__pycache__/filepost.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/__pycache__/filepost.cpython-312.pyc
new file mode 100644
index 0000000..76f7846
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/__pycache__/filepost.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/__pycache__/poolmanager.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/__pycache__/poolmanager.cpython-312.pyc
new file mode 100644
index 0000000..99edbf7
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/__pycache__/poolmanager.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/__pycache__/request.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/__pycache__/request.cpython-312.pyc
new file mode 100644
index 0000000..6f24fc4
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/__pycache__/request.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/__pycache__/response.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/__pycache__/response.cpython-312.pyc
new file mode 100644
index 0000000..8ed478f
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/__pycache__/response.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/_collections.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/_collections.py
new file mode 100644
index 0000000..bceb845
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/_collections.py
@@ -0,0 +1,355 @@
+from __future__ import absolute_import
+
+try:
+    from collections.abc import Mapping, MutableMapping
+except ImportError:
+    from collections import Mapping, MutableMapping
+try:
+    from threading import RLock
+except ImportError:  # Platform-specific: No threads available
+
+    class RLock:
+        def __enter__(self):
+            pass
+
+        def __exit__(self, exc_type, exc_value, traceback):
+            pass
+
+
+from collections import OrderedDict
+
+from .exceptions import InvalidHeader
+from .packages import six
+from .packages.six import iterkeys, itervalues
+
+__all__ = ["RecentlyUsedContainer", "HTTPHeaderDict"]
+
+
+_Null = object()
+
+
+class RecentlyUsedContainer(MutableMapping):
+    """
+    Provides a thread-safe dict-like container which maintains up to
+    ``maxsize`` keys while throwing away the least-recently-used keys beyond
+    ``maxsize``.
+
+    :param maxsize:
+        Maximum number of recent elements to retain.
+
+    :param dispose_func:
+        Every time an item is evicted from the container,
+        ``dispose_func(value)`` is called.  Callback which will get called
+    """
+
+    ContainerCls = OrderedDict
+
+    def __init__(self, maxsize=10, dispose_func=None):
+        self._maxsize = maxsize
+        self.dispose_func = dispose_func
+
+        self._container = self.ContainerCls()
+        self.lock = RLock()
+
+    def __getitem__(self, key):
+        # Re-insert the item, moving it to the end of the eviction line.
+        with self.lock:
+            item = self._container.pop(key)
+            self._container[key] = item
+            return item
+
+    def __setitem__(self, key, value):
+        evicted_value = _Null
+        with self.lock:
+            # Possibly evict the existing value of 'key'
+            evicted_value = self._container.get(key, _Null)
+            self._container[key] = value
+
+            # If we didn't evict an existing value, we might have to evict the
+            # least recently used item from the beginning of the container.
+            if len(self._container) > self._maxsize:
+                _key, evicted_value = self._container.popitem(last=False)
+
+        if self.dispose_func and evicted_value is not _Null:
+            self.dispose_func(evicted_value)
+
+    def __delitem__(self, key):
+        with self.lock:
+            value = self._container.pop(key)
+
+        if self.dispose_func:
+            self.dispose_func(value)
+
+    def __len__(self):
+        with self.lock:
+            return len(self._container)
+
+    def __iter__(self):
+        raise NotImplementedError(
+            "Iteration over this class is unlikely to be threadsafe."
+        )
+
+    def clear(self):
+        with self.lock:
+            # Copy pointers to all values, then wipe the mapping
+            values = list(itervalues(self._container))
+            self._container.clear()
+
+        if self.dispose_func:
+            for value in values:
+                self.dispose_func(value)
+
+    def keys(self):
+        with self.lock:
+            return list(iterkeys(self._container))
+
+
+class HTTPHeaderDict(MutableMapping):
+    """
+    :param headers:
+        An iterable of field-value pairs. Must not contain multiple field names
+        when compared case-insensitively.
+
+    :param kwargs:
+        Additional field-value pairs to pass in to ``dict.update``.
+
+    A ``dict`` like container for storing HTTP Headers.
+
+    Field names are stored and compared case-insensitively in compliance with
+    RFC 7230. Iteration provides the first case-sensitive key seen for each
+    case-insensitive pair.
+
+    Using ``__setitem__`` syntax overwrites fields that compare equal
+    case-insensitively in order to maintain ``dict``'s api. For fields that
+    compare equal, instead create a new ``HTTPHeaderDict`` and use ``.add``
+    in a loop.
+
+    If multiple fields that are equal case-insensitively are passed to the
+    constructor or ``.update``, the behavior is undefined and some will be
+    lost.
+
+    >>> headers = HTTPHeaderDict()
+    >>> headers.add('Set-Cookie', 'foo=bar')
+    >>> headers.add('set-cookie', 'baz=quxx')
+    >>> headers['content-length'] = '7'
+    >>> headers['SET-cookie']
+    'foo=bar, baz=quxx'
+    >>> headers['Content-Length']
+    '7'
+    """
+
+    def __init__(self, headers=None, **kwargs):
+        super(HTTPHeaderDict, self).__init__()
+        self._container = OrderedDict()
+        if headers is not None:
+            if isinstance(headers, HTTPHeaderDict):
+                self._copy_from(headers)
+            else:
+                self.extend(headers)
+        if kwargs:
+            self.extend(kwargs)
+
+    def __setitem__(self, key, val):
+        self._container[key.lower()] = [key, val]
+        return self._container[key.lower()]
+
+    def __getitem__(self, key):
+        val = self._container[key.lower()]
+        return ", ".join(val[1:])
+
+    def __delitem__(self, key):
+        del self._container[key.lower()]
+
+    def __contains__(self, key):
+        return key.lower() in self._container
+
+    def __eq__(self, other):
+        if not isinstance(other, Mapping) and not hasattr(other, "keys"):
+            return False
+        if not isinstance(other, type(self)):
+            other = type(self)(other)
+        return dict((k.lower(), v) for k, v in self.itermerged()) == dict(
+            (k.lower(), v) for k, v in other.itermerged()
+        )
+
+    def __ne__(self, other):
+        return not self.__eq__(other)
+
+    if six.PY2:  # Python 2
+        iterkeys = MutableMapping.iterkeys
+        itervalues = MutableMapping.itervalues
+
+    __marker = object()
+
+    def __len__(self):
+        return len(self._container)
+
+    def __iter__(self):
+        # Only provide the originally cased names
+        for vals in self._container.values():
+            yield vals[0]
+
+    def pop(self, key, default=__marker):
+        """D.pop(k[,d]) -> v, remove specified key and return the corresponding value.
+        If key is not found, d is returned if given, otherwise KeyError is raised.
+        """
+        # Using the MutableMapping function directly fails due to the private marker.
+        # Using ordinary dict.pop would expose the internal structures.
+        # So let's reinvent the wheel.
+        try:
+            value = self[key]
+        except KeyError:
+            if default is self.__marker:
+                raise
+            return default
+        else:
+            del self[key]
+            return value
+
+    def discard(self, key):
+        try:
+            del self[key]
+        except KeyError:
+            pass
+
+    def add(self, key, val):
+        """Adds a (name, value) pair, doesn't overwrite the value if it already
+        exists.
+
+        >>> headers = HTTPHeaderDict(foo='bar')
+        >>> headers.add('Foo', 'baz')
+        >>> headers['foo']
+        'bar, baz'
+        """
+        key_lower = key.lower()
+        new_vals = [key, val]
+        # Keep the common case aka no item present as fast as possible
+        vals = self._container.setdefault(key_lower, new_vals)
+        if new_vals is not vals:
+            vals.append(val)
+
+    def extend(self, *args, **kwargs):
+        """Generic import function for any type of header-like object.
+        Adapted version of MutableMapping.update in order to insert items
+        with self.add instead of self.__setitem__
+        """
+        if len(args) > 1:
+            raise TypeError(
+                "extend() takes at most 1 positional "
+                "arguments ({0} given)".format(len(args))
+            )
+        other = args[0] if len(args) >= 1 else ()
+
+        if isinstance(other, HTTPHeaderDict):
+            for key, val in other.iteritems():
+                self.add(key, val)
+        elif isinstance(other, Mapping):
+            for key in other:
+                self.add(key, other[key])
+        elif hasattr(other, "keys"):
+            for key in other.keys():
+                self.add(key, other[key])
+        else:
+            for key, value in other:
+                self.add(key, value)
+
+        for key, value in kwargs.items():
+            self.add(key, value)
+
+    def getlist(self, key, default=__marker):
+        """Returns a list of all the values for the named field. Returns an
+        empty list if the key doesn't exist."""
+        try:
+            vals = self._container[key.lower()]
+        except KeyError:
+            if default is self.__marker:
+                return []
+            return default
+        else:
+            return vals[1:]
+
+    def _prepare_for_method_change(self):
+        """
+        Remove content-specific header fields before changing the request
+        method to GET or HEAD according to RFC 9110, Section 15.4.
+        """
+        content_specific_headers = [
+            "Content-Encoding",
+            "Content-Language",
+            "Content-Location",
+            "Content-Type",
+            "Content-Length",
+            "Digest",
+            "Last-Modified",
+        ]
+        for header in content_specific_headers:
+            self.discard(header)
+        return self
+
+    # Backwards compatibility for httplib
+    getheaders = getlist
+    getallmatchingheaders = getlist
+    iget = getlist
+
+    # Backwards compatibility for http.cookiejar
+    get_all = getlist
+
+    def __repr__(self):
+        return "%s(%s)" % (type(self).__name__, dict(self.itermerged()))
+
+    def _copy_from(self, other):
+        for key in other:
+            val = other.getlist(key)
+            if isinstance(val, list):
+                # Don't need to convert tuples
+                val = list(val)
+            self._container[key.lower()] = [key] + val
+
+    def copy(self):
+        clone = type(self)()
+        clone._copy_from(self)
+        return clone
+
+    def iteritems(self):
+        """Iterate over all header lines, including duplicate ones."""
+        for key in self:
+            vals = self._container[key.lower()]
+            for val in vals[1:]:
+                yield vals[0], val
+
+    def itermerged(self):
+        """Iterate over all headers, merging duplicate ones together."""
+        for key in self:
+            val = self._container[key.lower()]
+            yield val[0], ", ".join(val[1:])
+
+    def items(self):
+        return list(self.iteritems())
+
+    @classmethod
+    def from_httplib(cls, message):  # Python 2
+        """Read headers from a Python 2 httplib message object."""
+        # python2.7 does not expose a proper API for exporting multiheaders
+        # efficiently. This function re-reads raw lines from the message
+        # object and extracts the multiheaders properly.
+        obs_fold_continued_leaders = (" ", "\t")
+        headers = []
+
+        for line in message.headers:
+            if line.startswith(obs_fold_continued_leaders):
+                if not headers:
+                    # We received a header line that starts with OWS as described
+                    # in RFC-7230 S3.2.4. This indicates a multiline header, but
+                    # there exists no previous header to which we can attach it.
+                    raise InvalidHeader(
+                        "Header continuation with no previous header: %s" % line
+                    )
+                else:
+                    key, value = headers[-1]
+                    headers[-1] = (key, value + " " + line.strip())
+                    continue
+
+            key, value = line.split(":", 1)
+            headers.append((key, value.strip()))
+
+        return cls(headers)
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/_version.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/_version.py
new file mode 100644
index 0000000..d49df2a
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/_version.py
@@ -0,0 +1,2 @@
+# This file is protected via CODEOWNERS
+__version__ = "1.26.20"
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/connection.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/connection.py
new file mode 100644
index 0000000..de35b63
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/connection.py
@@ -0,0 +1,572 @@
+from __future__ import absolute_import
+
+import datetime
+import logging
+import os
+import re
+import socket
+import warnings
+from socket import error as SocketError
+from socket import timeout as SocketTimeout
+
+from .packages import six
+from .packages.six.moves.http_client import HTTPConnection as _HTTPConnection
+from .packages.six.moves.http_client import HTTPException  # noqa: F401
+from .util.proxy import create_proxy_ssl_context
+
+try:  # Compiled with SSL?
+    import ssl
+
+    BaseSSLError = ssl.SSLError
+except (ImportError, AttributeError):  # Platform-specific: No SSL.
+    ssl = None
+
+    class BaseSSLError(BaseException):
+        pass
+
+
+try:
+    # Python 3: not a no-op, we're adding this to the namespace so it can be imported.
+    ConnectionError = ConnectionError
+except NameError:
+    # Python 2
+    class ConnectionError(Exception):
+        pass
+
+
+try:  # Python 3:
+    # Not a no-op, we're adding this to the namespace so it can be imported.
+    BrokenPipeError = BrokenPipeError
+except NameError:  # Python 2:
+
+    class BrokenPipeError(Exception):
+        pass
+
+
+from ._collections import HTTPHeaderDict  # noqa (historical, removed in v2)
+from ._version import __version__
+from .exceptions import (
+    ConnectTimeoutError,
+    NewConnectionError,
+    SubjectAltNameWarning,
+    SystemTimeWarning,
+)
+from .util import SKIP_HEADER, SKIPPABLE_HEADERS, connection
+from .util.ssl_ import (
+    assert_fingerprint,
+    create_urllib3_context,
+    is_ipaddress,
+    resolve_cert_reqs,
+    resolve_ssl_version,
+    ssl_wrap_socket,
+)
+from .util.ssl_match_hostname import CertificateError, match_hostname
+
+log = logging.getLogger(__name__)
+
+port_by_scheme = {"http": 80, "https": 443}
+
+# When it comes time to update this value as a part of regular maintenance
+# (ie test_recent_date is failing) update it to ~6 months before the current date.
+RECENT_DATE = datetime.date(2024, 1, 1)
+
+_CONTAINS_CONTROL_CHAR_RE = re.compile(r"[^-!#$%&'*+.^_`|~0-9a-zA-Z]")
+
+
+class HTTPConnection(_HTTPConnection, object):
+    """
+    Based on :class:`http.client.HTTPConnection` but provides an extra constructor
+    backwards-compatibility layer between older and newer Pythons.
+
+    Additional keyword parameters are used to configure attributes of the connection.
+    Accepted parameters include:
+
+    - ``strict``: See the documentation on :class:`urllib3.connectionpool.HTTPConnectionPool`
+    - ``source_address``: Set the source address for the current connection.
+    - ``socket_options``: Set specific options on the underlying socket. If not specified, then
+      defaults are loaded from ``HTTPConnection.default_socket_options`` which includes disabling
+      Nagle's algorithm (sets TCP_NODELAY to 1) unless the connection is behind a proxy.
+
+      For example, if you wish to enable TCP Keep Alive in addition to the defaults,
+      you might pass:
+
+      .. code-block:: python
+
+         HTTPConnection.default_socket_options + [
+             (socket.SOL_SOCKET, socket.SO_KEEPALIVE, 1),
+         ]
+
+      Or you may want to disable the defaults by passing an empty list (e.g., ``[]``).
+    """
+
+    default_port = port_by_scheme["http"]
+
+    #: Disable Nagle's algorithm by default.
+    #: ``[(socket.IPPROTO_TCP, socket.TCP_NODELAY, 1)]``
+    default_socket_options = [(socket.IPPROTO_TCP, socket.TCP_NODELAY, 1)]
+
+    #: Whether this connection verifies the host's certificate.
+    is_verified = False
+
+    #: Whether this proxy connection (if used) verifies the proxy host's
+    #: certificate.
+    proxy_is_verified = None
+
+    def __init__(self, *args, **kw):
+        if not six.PY2:
+            kw.pop("strict", None)
+
+        # Pre-set source_address.
+        self.source_address = kw.get("source_address")
+
+        #: The socket options provided by the user. If no options are
+        #: provided, we use the default options.
+        self.socket_options = kw.pop("socket_options", self.default_socket_options)
+
+        # Proxy options provided by the user.
+        self.proxy = kw.pop("proxy", None)
+        self.proxy_config = kw.pop("proxy_config", None)
+
+        _HTTPConnection.__init__(self, *args, **kw)
+
+    @property
+    def host(self):
+        """
+        Getter method to remove any trailing dots that indicate the hostname is an FQDN.
+
+        In general, SSL certificates don't include the trailing dot indicating a
+        fully-qualified domain name, and thus, they don't validate properly when
+        checked against a domain name that includes the dot. In addition, some
+        servers may not expect to receive the trailing dot when provided.
+
+        However, the hostname with trailing dot is critical to DNS resolution; doing a
+        lookup with the trailing dot will properly only resolve the appropriate FQDN,
+        whereas a lookup without a trailing dot will search the system's search domain
+        list. Thus, it's important to keep the original host around for use only in
+        those cases where it's appropriate (i.e., when doing DNS lookup to establish the
+        actual TCP connection across which we're going to send HTTP requests).
+        """
+        return self._dns_host.rstrip(".")
+
+    @host.setter
+    def host(self, value):
+        """
+        Setter for the `host` property.
+
+        We assume that only urllib3 uses the _dns_host attribute; httplib itself
+        only uses `host`, and it seems reasonable that other libraries follow suit.
+        """
+        self._dns_host = value
+
+    def _new_conn(self):
+        """Establish a socket connection and set nodelay settings on it.
+
+        :return: New socket connection.
+        """
+        extra_kw = {}
+        if self.source_address:
+            extra_kw["source_address"] = self.source_address
+
+        if self.socket_options:
+            extra_kw["socket_options"] = self.socket_options
+
+        try:
+            conn = connection.create_connection(
+                (self._dns_host, self.port), self.timeout, **extra_kw
+            )
+
+        except SocketTimeout:
+            raise ConnectTimeoutError(
+                self,
+                "Connection to %s timed out. (connect timeout=%s)"
+                % (self.host, self.timeout),
+            )
+
+        except SocketError as e:
+            raise NewConnectionError(
+                self, "Failed to establish a new connection: %s" % e
+            )
+
+        return conn
+
+    def _is_using_tunnel(self):
+        # Google App Engine's httplib does not define _tunnel_host
+        return getattr(self, "_tunnel_host", None)
+
+    def _prepare_conn(self, conn):
+        self.sock = conn
+        if self._is_using_tunnel():
+            # TODO: Fix tunnel so it doesn't depend on self.sock state.
+            self._tunnel()
+            # Mark this connection as not reusable
+            self.auto_open = 0
+
+    def connect(self):
+        conn = self._new_conn()
+        self._prepare_conn(conn)
+
+    def putrequest(self, method, url, *args, **kwargs):
+        """ """
+        # Empty docstring because the indentation of CPython's implementation
+        # is broken but we don't want this method in our documentation.
+        match = _CONTAINS_CONTROL_CHAR_RE.search(method)
+        if match:
+            raise ValueError(
+                "Method cannot contain non-token characters %r (found at least %r)"
+                % (method, match.group())
+            )
+
+        return _HTTPConnection.putrequest(self, method, url, *args, **kwargs)
+
+    def putheader(self, header, *values):
+        """ """
+        if not any(isinstance(v, str) and v == SKIP_HEADER for v in values):
+            _HTTPConnection.putheader(self, header, *values)
+        elif six.ensure_str(header.lower()) not in SKIPPABLE_HEADERS:
+            raise ValueError(
+                "urllib3.util.SKIP_HEADER only supports '%s'"
+                % ("', '".join(map(str.title, sorted(SKIPPABLE_HEADERS))),)
+            )
+
+    def request(self, method, url, body=None, headers=None):
+        # Update the inner socket's timeout value to send the request.
+        # This only triggers if the connection is re-used.
+        if getattr(self, "sock", None) is not None:
+            self.sock.settimeout(self.timeout)
+
+        if headers is None:
+            headers = {}
+        else:
+            # Avoid modifying the headers passed into .request()
+            headers = headers.copy()
+        if "user-agent" not in (six.ensure_str(k.lower()) for k in headers):
+            headers["User-Agent"] = _get_default_user_agent()
+        super(HTTPConnection, self).request(method, url, body=body, headers=headers)
+
+    def request_chunked(self, method, url, body=None, headers=None):
+        """
+        Alternative to the common request method, which sends the
+        body with chunked encoding and not as one block
+        """
+        headers = headers or {}
+        header_keys = set([six.ensure_str(k.lower()) for k in headers])
+        skip_accept_encoding = "accept-encoding" in header_keys
+        skip_host = "host" in header_keys
+        self.putrequest(
+            method, url, skip_accept_encoding=skip_accept_encoding, skip_host=skip_host
+        )
+        if "user-agent" not in header_keys:
+            self.putheader("User-Agent", _get_default_user_agent())
+        for header, value in headers.items():
+            self.putheader(header, value)
+        if "transfer-encoding" not in header_keys:
+            self.putheader("Transfer-Encoding", "chunked")
+        self.endheaders()
+
+        if body is not None:
+            stringish_types = six.string_types + (bytes,)
+            if isinstance(body, stringish_types):
+                body = (body,)
+            for chunk in body:
+                if not chunk:
+                    continue
+                if not isinstance(chunk, bytes):
+                    chunk = chunk.encode("utf8")
+                len_str = hex(len(chunk))[2:]
+                to_send = bytearray(len_str.encode())
+                to_send += b"\r\n"
+                to_send += chunk
+                to_send += b"\r\n"
+                self.send(to_send)
+
+        # After the if clause, to always have a closed body
+        self.send(b"0\r\n\r\n")
+
+
+class HTTPSConnection(HTTPConnection):
+    """
+    Many of the parameters to this constructor are passed to the underlying SSL
+    socket by means of :py:func:`urllib3.util.ssl_wrap_socket`.
+    """
+
+    default_port = port_by_scheme["https"]
+
+    cert_reqs = None
+    ca_certs = None
+    ca_cert_dir = None
+    ca_cert_data = None
+    ssl_version = None
+    assert_fingerprint = None
+    tls_in_tls_required = False
+
+    def __init__(
+        self,
+        host,
+        port=None,
+        key_file=None,
+        cert_file=None,
+        key_password=None,
+        strict=None,
+        timeout=socket._GLOBAL_DEFAULT_TIMEOUT,
+        ssl_context=None,
+        server_hostname=None,
+        **kw
+    ):
+
+        HTTPConnection.__init__(self, host, port, strict=strict, timeout=timeout, **kw)
+
+        self.key_file = key_file
+        self.cert_file = cert_file
+        self.key_password = key_password
+        self.ssl_context = ssl_context
+        self.server_hostname = server_hostname
+
+        # Required property for Google AppEngine 1.9.0 which otherwise causes
+        # HTTPS requests to go out as HTTP. (See Issue #356)
+        self._protocol = "https"
+
+    def set_cert(
+        self,
+        key_file=None,
+        cert_file=None,
+        cert_reqs=None,
+        key_password=None,
+        ca_certs=None,
+        assert_hostname=None,
+        assert_fingerprint=None,
+        ca_cert_dir=None,
+        ca_cert_data=None,
+    ):
+        """
+        This method should only be called once, before the connection is used.
+        """
+        # If cert_reqs is not provided we'll assume CERT_REQUIRED unless we also
+        # have an SSLContext object in which case we'll use its verify_mode.
+        if cert_reqs is None:
+            if self.ssl_context is not None:
+                cert_reqs = self.ssl_context.verify_mode
+            else:
+                cert_reqs = resolve_cert_reqs(None)
+
+        self.key_file = key_file
+        self.cert_file = cert_file
+        self.cert_reqs = cert_reqs
+        self.key_password = key_password
+        self.assert_hostname = assert_hostname
+        self.assert_fingerprint = assert_fingerprint
+        self.ca_certs = ca_certs and os.path.expanduser(ca_certs)
+        self.ca_cert_dir = ca_cert_dir and os.path.expanduser(ca_cert_dir)
+        self.ca_cert_data = ca_cert_data
+
+    def connect(self):
+        # Add certificate verification
+        self.sock = conn = self._new_conn()
+        hostname = self.host
+        tls_in_tls = False
+
+        if self._is_using_tunnel():
+            if self.tls_in_tls_required:
+                self.sock = conn = self._connect_tls_proxy(hostname, conn)
+                tls_in_tls = True
+
+            # Calls self._set_hostport(), so self.host is
+            # self._tunnel_host below.
+            self._tunnel()
+            # Mark this connection as not reusable
+            self.auto_open = 0
+
+            # Override the host with the one we're requesting data from.
+            hostname = self._tunnel_host
+
+        server_hostname = hostname
+        if self.server_hostname is not None:
+            server_hostname = self.server_hostname
+
+        is_time_off = datetime.date.today() < RECENT_DATE
+        if is_time_off:
+            warnings.warn(
+                (
+                    "System time is way off (before {0}). This will probably "
+                    "lead to SSL verification errors"
+                ).format(RECENT_DATE),
+                SystemTimeWarning,
+            )
+
+        # Wrap socket using verification with the root certs in
+        # trusted_root_certs
+        default_ssl_context = False
+        if self.ssl_context is None:
+            default_ssl_context = True
+            self.ssl_context = create_urllib3_context(
+                ssl_version=resolve_ssl_version(self.ssl_version),
+                cert_reqs=resolve_cert_reqs(self.cert_reqs),
+            )
+
+        context = self.ssl_context
+        context.verify_mode = resolve_cert_reqs(self.cert_reqs)
+
+        # Try to load OS default certs if none are given.
+        # Works well on Windows (requires Python3.4+)
+        if (
+            not self.ca_certs
+            and not self.ca_cert_dir
+            and not self.ca_cert_data
+            and default_ssl_context
+            and hasattr(context, "load_default_certs")
+        ):
+            context.load_default_certs()
+
+        self.sock = ssl_wrap_socket(
+            sock=conn,
+            keyfile=self.key_file,
+            certfile=self.cert_file,
+            key_password=self.key_password,
+            ca_certs=self.ca_certs,
+            ca_cert_dir=self.ca_cert_dir,
+            ca_cert_data=self.ca_cert_data,
+            server_hostname=server_hostname,
+            ssl_context=context,
+            tls_in_tls=tls_in_tls,
+        )
+
+        # If we're using all defaults and the connection
+        # is TLSv1 or TLSv1.1 we throw a DeprecationWarning
+        # for the host.
+        if (
+            default_ssl_context
+            and self.ssl_version is None
+            and hasattr(self.sock, "version")
+            and self.sock.version() in {"TLSv1", "TLSv1.1"}
+        ):  # Defensive:
+            warnings.warn(
+                "Negotiating TLSv1/TLSv1.1 by default is deprecated "
+                "and will be disabled in urllib3 v2.0.0. Connecting to "
+                "'%s' with '%s' can be enabled by explicitly opting-in "
+                "with 'ssl_version'" % (self.host, self.sock.version()),
+                DeprecationWarning,
+            )
+
+        if self.assert_fingerprint:
+            assert_fingerprint(
+                self.sock.getpeercert(binary_form=True), self.assert_fingerprint
+            )
+        elif (
+            context.verify_mode != ssl.CERT_NONE
+            and not getattr(context, "check_hostname", False)
+            and self.assert_hostname is not False
+        ):
+            # While urllib3 attempts to always turn off hostname matching from
+            # the TLS library, this cannot always be done. So we check whether
+            # the TLS Library still thinks it's matching hostnames.
+            cert = self.sock.getpeercert()
+            if not cert.get("subjectAltName", ()):
+                warnings.warn(
+                    (
+                        "Certificate for {0} has no `subjectAltName`, falling back to check for a "
+                        "`commonName` for now. This feature is being removed by major browsers and "
+                        "deprecated by RFC 2818. (See https://github.com/urllib3/urllib3/issues/497 "
+                        "for details.)".format(hostname)
+                    ),
+                    SubjectAltNameWarning,
+                )
+            _match_hostname(cert, self.assert_hostname or server_hostname)
+
+        self.is_verified = (
+            context.verify_mode == ssl.CERT_REQUIRED
+            or self.assert_fingerprint is not None
+        )
+
+    def _connect_tls_proxy(self, hostname, conn):
+        """
+        Establish a TLS connection to the proxy using the provided SSL context.
+        """
+        proxy_config = self.proxy_config
+        ssl_context = proxy_config.ssl_context
+        if ssl_context:
+            # If the user provided a proxy context, we assume CA and client
+            # certificates have already been set
+            return ssl_wrap_socket(
+                sock=conn,
+                server_hostname=hostname,
+                ssl_context=ssl_context,
+            )
+
+        ssl_context = create_proxy_ssl_context(
+            self.ssl_version,
+            self.cert_reqs,
+            self.ca_certs,
+            self.ca_cert_dir,
+            self.ca_cert_data,
+        )
+
+        # If no cert was provided, use only the default options for server
+        # certificate validation
+        socket = ssl_wrap_socket(
+            sock=conn,
+            ca_certs=self.ca_certs,
+            ca_cert_dir=self.ca_cert_dir,
+            ca_cert_data=self.ca_cert_data,
+            server_hostname=hostname,
+            ssl_context=ssl_context,
+        )
+
+        if ssl_context.verify_mode != ssl.CERT_NONE and not getattr(
+            ssl_context, "check_hostname", False
+        ):
+            # While urllib3 attempts to always turn off hostname matching from
+            # the TLS library, this cannot always be done. So we check whether
+            # the TLS Library still thinks it's matching hostnames.
+            cert = socket.getpeercert()
+            if not cert.get("subjectAltName", ()):
+                warnings.warn(
+                    (
+                        "Certificate for {0} has no `subjectAltName`, falling back to check for a "
+                        "`commonName` for now. This feature is being removed by major browsers and "
+                        "deprecated by RFC 2818. (See https://github.com/urllib3/urllib3/issues/497 "
+                        "for details.)".format(hostname)
+                    ),
+                    SubjectAltNameWarning,
+                )
+            _match_hostname(cert, hostname)
+
+        self.proxy_is_verified = ssl_context.verify_mode == ssl.CERT_REQUIRED
+        return socket
+
+
+def _match_hostname(cert, asserted_hostname):
+    # Our upstream implementation of ssl.match_hostname()
+    # only applies this normalization to IP addresses so it doesn't
+    # match DNS SANs so we do the same thing!
+    stripped_hostname = asserted_hostname.strip("u[]")
+    if is_ipaddress(stripped_hostname):
+        asserted_hostname = stripped_hostname
+
+    try:
+        match_hostname(cert, asserted_hostname)
+    except CertificateError as e:
+        log.warning(
+            "Certificate did not match expected hostname: %s. Certificate: %s",
+            asserted_hostname,
+            cert,
+        )
+        # Add cert to exception and reraise so client code can inspect
+        # the cert when catching the exception, if they want to
+        e._peer_cert = cert
+        raise
+
+
+def _get_default_user_agent():
+    return "python-urllib3/%s" % __version__
+
+
+class DummyConnection(object):
+    """Used to detect a failed ConnectionCls import."""
+
+    pass
+
+
+if not ssl:
+    HTTPSConnection = DummyConnection  # noqa: F811
+
+
+VerifiedHTTPSConnection = HTTPSConnection
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/connectionpool.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/connectionpool.py
new file mode 100644
index 0000000..0872ed7
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/connectionpool.py
@@ -0,0 +1,1140 @@
+from __future__ import absolute_import
+
+import errno
+import logging
+import re
+import socket
+import sys
+import warnings
+from socket import error as SocketError
+from socket import timeout as SocketTimeout
+
+from ._collections import HTTPHeaderDict
+from .connection import (
+    BaseSSLError,
+    BrokenPipeError,
+    DummyConnection,
+    HTTPConnection,
+    HTTPException,
+    HTTPSConnection,
+    VerifiedHTTPSConnection,
+    port_by_scheme,
+)
+from .exceptions import (
+    ClosedPoolError,
+    EmptyPoolError,
+    HeaderParsingError,
+    HostChangedError,
+    InsecureRequestWarning,
+    LocationValueError,
+    MaxRetryError,
+    NewConnectionError,
+    ProtocolError,
+    ProxyError,
+    ReadTimeoutError,
+    SSLError,
+    TimeoutError,
+)
+from .packages import six
+from .packages.six.moves import queue
+from .request import RequestMethods
+from .response import HTTPResponse
+from .util.connection import is_connection_dropped
+from .util.proxy import connection_requires_http_tunnel
+from .util.queue import LifoQueue
+from .util.request import set_file_position
+from .util.response import assert_header_parsing
+from .util.retry import Retry
+from .util.ssl_match_hostname import CertificateError
+from .util.timeout import Timeout
+from .util.url import Url, _encode_target
+from .util.url import _normalize_host as normalize_host
+from .util.url import get_host, parse_url
+
+try:  # Platform-specific: Python 3
+    import weakref
+
+    weakref_finalize = weakref.finalize
+except AttributeError:  # Platform-specific: Python 2
+    from .packages.backports.weakref_finalize import weakref_finalize
+
+xrange = six.moves.xrange
+
+log = logging.getLogger(__name__)
+
+_Default = object()
+
+
+# Pool objects
+class ConnectionPool(object):
+    """
+    Base class for all connection pools, such as
+    :class:`.HTTPConnectionPool` and :class:`.HTTPSConnectionPool`.
+
+    .. note::
+       ConnectionPool.urlopen() does not normalize or percent-encode target URIs
+       which is useful if your target server doesn't support percent-encoded
+       target URIs.
+    """
+
+    scheme = None
+    QueueCls = LifoQueue
+
+    def __init__(self, host, port=None):
+        if not host:
+            raise LocationValueError("No host specified.")
+
+        self.host = _normalize_host(host, scheme=self.scheme)
+        self._proxy_host = host.lower()
+        self.port = port
+
+    def __str__(self):
+        return "%s(host=%r, port=%r)" % (type(self).__name__, self.host, self.port)
+
+    def __enter__(self):
+        return self
+
+    def __exit__(self, exc_type, exc_val, exc_tb):
+        self.close()
+        # Return False to re-raise any potential exceptions
+        return False
+
+    def close(self):
+        """
+        Close all pooled connections and disable the pool.
+        """
+        pass
+
+
+# This is taken from http://hg.python.org/cpython/file/7aaba721ebc0/Lib/socket.py#l252
+_blocking_errnos = {errno.EAGAIN, errno.EWOULDBLOCK}
+
+
+class HTTPConnectionPool(ConnectionPool, RequestMethods):
+    """
+    Thread-safe connection pool for one host.
+
+    :param host:
+        Host used for this HTTP Connection (e.g. "localhost"), passed into
+        :class:`http.client.HTTPConnection`.
+
+    :param port:
+        Port used for this HTTP Connection (None is equivalent to 80), passed
+        into :class:`http.client.HTTPConnection`.
+
+    :param strict:
+        Causes BadStatusLine to be raised if the status line can't be parsed
+        as a valid HTTP/1.0 or 1.1 status line, passed into
+        :class:`http.client.HTTPConnection`.
+
+        .. note::
+           Only works in Python 2. This parameter is ignored in Python 3.
+
+    :param timeout:
+        Socket timeout in seconds for each individual connection. This can
+        be a float or integer, which sets the timeout for the HTTP request,
+        or an instance of :class:`urllib3.util.Timeout` which gives you more
+        fine-grained control over request timeouts. After the constructor has
+        been parsed, this is always a `urllib3.util.Timeout` object.
+
+    :param maxsize:
+        Number of connections to save that can be reused. More than 1 is useful
+        in multithreaded situations. If ``block`` is set to False, more
+        connections will be created but they will not be saved once they've
+        been used.
+
+    :param block:
+        If set to True, no more than ``maxsize`` connections will be used at
+        a time. When no free connections are available, the call will block
+        until a connection has been released. This is a useful side effect for
+        particular multithreaded situations where one does not want to use more
+        than maxsize connections per host to prevent flooding.
+
+    :param headers:
+        Headers to include with all requests, unless other headers are given
+        explicitly.
+
+    :param retries:
+        Retry configuration to use by default with requests in this pool.
+
+    :param _proxy:
+        Parsed proxy URL, should not be used directly, instead, see
+        :class:`urllib3.ProxyManager`
+
+    :param _proxy_headers:
+        A dictionary with proxy headers, should not be used directly,
+        instead, see :class:`urllib3.ProxyManager`
+
+    :param \\**conn_kw:
+        Additional parameters are used to create fresh :class:`urllib3.connection.HTTPConnection`,
+        :class:`urllib3.connection.HTTPSConnection` instances.
+    """
+
+    scheme = "http"
+    ConnectionCls = HTTPConnection
+    ResponseCls = HTTPResponse
+
+    def __init__(
+        self,
+        host,
+        port=None,
+        strict=False,
+        timeout=Timeout.DEFAULT_TIMEOUT,
+        maxsize=1,
+        block=False,
+        headers=None,
+        retries=None,
+        _proxy=None,
+        _proxy_headers=None,
+        _proxy_config=None,
+        **conn_kw
+    ):
+        ConnectionPool.__init__(self, host, port)
+        RequestMethods.__init__(self, headers)
+
+        self.strict = strict
+
+        if not isinstance(timeout, Timeout):
+            timeout = Timeout.from_float(timeout)
+
+        if retries is None:
+            retries = Retry.DEFAULT
+
+        self.timeout = timeout
+        self.retries = retries
+
+        self.pool = self.QueueCls(maxsize)
+        self.block = block
+
+        self.proxy = _proxy
+        self.proxy_headers = _proxy_headers or {}
+        self.proxy_config = _proxy_config
+
+        # Fill the queue up so that doing get() on it will block properly
+        for _ in xrange(maxsize):
+            self.pool.put(None)
+
+        # These are mostly for testing and debugging purposes.
+        self.num_connections = 0
+        self.num_requests = 0
+        self.conn_kw = conn_kw
+
+        if self.proxy:
+            # Enable Nagle's algorithm for proxies, to avoid packet fragmentation.
+            # We cannot know if the user has added default socket options, so we cannot replace the
+            # list.
+            self.conn_kw.setdefault("socket_options", [])
+
+            self.conn_kw["proxy"] = self.proxy
+            self.conn_kw["proxy_config"] = self.proxy_config
+
+        # Do not pass 'self' as callback to 'finalize'.
+        # Then the 'finalize' would keep an endless living (leak) to self.
+        # By just passing a reference to the pool allows the garbage collector
+        # to free self if nobody else has a reference to it.
+        pool = self.pool
+
+        # Close all the HTTPConnections in the pool before the
+        # HTTPConnectionPool object is garbage collected.
+        weakref_finalize(self, _close_pool_connections, pool)
+
+    def _new_conn(self):
+        """
+        Return a fresh :class:`HTTPConnection`.
+        """
+        self.num_connections += 1
+        log.debug(
+            "Starting new HTTP connection (%d): %s:%s",
+            self.num_connections,
+            self.host,
+            self.port or "80",
+        )
+
+        conn = self.ConnectionCls(
+            host=self.host,
+            port=self.port,
+            timeout=self.timeout.connect_timeout,
+            strict=self.strict,
+            **self.conn_kw
+        )
+        return conn
+
+    def _get_conn(self, timeout=None):
+        """
+        Get a connection. Will return a pooled connection if one is available.
+
+        If no connections are available and :prop:`.block` is ``False``, then a
+        fresh connection is returned.
+
+        :param timeout:
+            Seconds to wait before giving up and raising
+            :class:`urllib3.exceptions.EmptyPoolError` if the pool is empty and
+            :prop:`.block` is ``True``.
+        """
+        conn = None
+        try:
+            conn = self.pool.get(block=self.block, timeout=timeout)
+
+        except AttributeError:  # self.pool is None
+            raise ClosedPoolError(self, "Pool is closed.")
+
+        except queue.Empty:
+            if self.block:
+                raise EmptyPoolError(
+                    self,
+                    "Pool reached maximum size and no more connections are allowed.",
+                )
+            pass  # Oh well, we'll create a new connection then
+
+        # If this is a persistent connection, check if it got disconnected
+        if conn and is_connection_dropped(conn):
+            log.debug("Resetting dropped connection: %s", self.host)
+            conn.close()
+            if getattr(conn, "auto_open", 1) == 0:
+                # This is a proxied connection that has been mutated by
+                # http.client._tunnel() and cannot be reused (since it would
+                # attempt to bypass the proxy)
+                conn = None
+
+        return conn or self._new_conn()
+
+    def _put_conn(self, conn):
+        """
+        Put a connection back into the pool.
+
+        :param conn:
+            Connection object for the current host and port as returned by
+            :meth:`._new_conn` or :meth:`._get_conn`.
+
+        If the pool is already full, the connection is closed and discarded
+        because we exceeded maxsize. If connections are discarded frequently,
+        then maxsize should be increased.
+
+        If the pool is closed, then the connection will be closed and discarded.
+        """
+        try:
+            self.pool.put(conn, block=False)
+            return  # Everything is dandy, done.
+        except AttributeError:
+            # self.pool is None.
+            pass
+        except queue.Full:
+            # This should never happen if self.block == True
+            log.warning(
+                "Connection pool is full, discarding connection: %s. Connection pool size: %s",
+                self.host,
+                self.pool.qsize(),
+            )
+        # Connection never got put back into the pool, close it.
+        if conn:
+            conn.close()
+
+    def _validate_conn(self, conn):
+        """
+        Called right before a request is made, after the socket is created.
+        """
+        pass
+
+    def _prepare_proxy(self, conn):
+        # Nothing to do for HTTP connections.
+        pass
+
+    def _get_timeout(self, timeout):
+        """Helper that always returns a :class:`urllib3.util.Timeout`"""
+        if timeout is _Default:
+            return self.timeout.clone()
+
+        if isinstance(timeout, Timeout):
+            return timeout.clone()
+        else:
+            # User passed us an int/float. This is for backwards compatibility,
+            # can be removed later
+            return Timeout.from_float(timeout)
+
+    def _raise_timeout(self, err, url, timeout_value):
+        """Is the error actually a timeout? Will raise a ReadTimeout or pass"""
+
+        if isinstance(err, SocketTimeout):
+            raise ReadTimeoutError(
+                self, url, "Read timed out. (read timeout=%s)" % timeout_value
+            )
+
+        # See the above comment about EAGAIN in Python 3. In Python 2 we have
+        # to specifically catch it and throw the timeout error
+        if hasattr(err, "errno") and err.errno in _blocking_errnos:
+            raise ReadTimeoutError(
+                self, url, "Read timed out. (read timeout=%s)" % timeout_value
+            )
+
+        # Catch possible read timeouts thrown as SSL errors. If not the
+        # case, rethrow the original. We need to do this because of:
+        # http://bugs.python.org/issue10272
+        if "timed out" in str(err) or "did not complete (read)" in str(
+            err
+        ):  # Python < 2.7.4
+            raise ReadTimeoutError(
+                self, url, "Read timed out. (read timeout=%s)" % timeout_value
+            )
+
+    def _make_request(
+        self, conn, method, url, timeout=_Default, chunked=False, **httplib_request_kw
+    ):
+        """
+        Perform a request on a given urllib connection object taken from our
+        pool.
+
+        :param conn:
+            a connection from one of our connection pools
+
+        :param timeout:
+            Socket timeout in seconds for the request. This can be a
+            float or integer, which will set the same timeout value for
+            the socket connect and the socket read, or an instance of
+            :class:`urllib3.util.Timeout`, which gives you more fine-grained
+            control over your timeouts.
+        """
+        self.num_requests += 1
+
+        timeout_obj = self._get_timeout(timeout)
+        timeout_obj.start_connect()
+        conn.timeout = Timeout.resolve_default_timeout(timeout_obj.connect_timeout)
+
+        # Trigger any extra validation we need to do.
+        try:
+            self._validate_conn(conn)
+        except (SocketTimeout, BaseSSLError) as e:
+            # Py2 raises this as a BaseSSLError, Py3 raises it as socket timeout.
+            self._raise_timeout(err=e, url=url, timeout_value=conn.timeout)
+            raise
+
+        # conn.request() calls http.client.*.request, not the method in
+        # urllib3.request. It also calls makefile (recv) on the socket.
+        try:
+            if chunked:
+                conn.request_chunked(method, url, **httplib_request_kw)
+            else:
+                conn.request(method, url, **httplib_request_kw)
+
+        # We are swallowing BrokenPipeError (errno.EPIPE) since the server is
+        # legitimately able to close the connection after sending a valid response.
+        # With this behaviour, the received response is still readable.
+        except BrokenPipeError:
+            # Python 3
+            pass
+        except IOError as e:
+            # Python 2 and macOS/Linux
+            # EPIPE and ESHUTDOWN are BrokenPipeError on Python 2, and EPROTOTYPE/ECONNRESET are needed on macOS
+            # https://erickt.github.io/blog/2014/11/19/adventures-in-debugging-a-potential-osx-kernel-bug/
+            if e.errno not in {
+                errno.EPIPE,
+                errno.ESHUTDOWN,
+                errno.EPROTOTYPE,
+                errno.ECONNRESET,
+            }:
+                raise
+
+        # Reset the timeout for the recv() on the socket
+        read_timeout = timeout_obj.read_timeout
+
+        # App Engine doesn't have a sock attr
+        if getattr(conn, "sock", None):
+            # In Python 3 socket.py will catch EAGAIN and return None when you
+            # try and read into the file pointer created by http.client, which
+            # instead raises a BadStatusLine exception. Instead of catching
+            # the exception and assuming all BadStatusLine exceptions are read
+            # timeouts, check for a zero timeout before making the request.
+            if read_timeout == 0:
+                raise ReadTimeoutError(
+                    self, url, "Read timed out. (read timeout=%s)" % read_timeout
+                )
+            if read_timeout is Timeout.DEFAULT_TIMEOUT:
+                conn.sock.settimeout(socket.getdefaulttimeout())
+            else:  # None or a value
+                conn.sock.settimeout(read_timeout)
+
+        # Receive the response from the server
+        try:
+            try:
+                # Python 2.7, use buffering of HTTP responses
+                httplib_response = conn.getresponse(buffering=True)
+            except TypeError:
+                # Python 3
+                try:
+                    httplib_response = conn.getresponse()
+                except BaseException as e:
+                    # Remove the TypeError from the exception chain in
+                    # Python 3 (including for exceptions like SystemExit).
+                    # Otherwise it looks like a bug in the code.
+                    six.raise_from(e, None)
+        except (SocketTimeout, BaseSSLError, SocketError) as e:
+            self._raise_timeout(err=e, url=url, timeout_value=read_timeout)
+            raise
+
+        # AppEngine doesn't have a version attr.
+        http_version = getattr(conn, "_http_vsn_str", "HTTP/?")
+        log.debug(
+            '%s://%s:%s "%s %s %s" %s %s',
+            self.scheme,
+            self.host,
+            self.port,
+            method,
+            url,
+            http_version,
+            httplib_response.status,
+            httplib_response.length,
+        )
+
+        try:
+            assert_header_parsing(httplib_response.msg)
+        except (HeaderParsingError, TypeError) as hpe:  # Platform-specific: Python 3
+            log.warning(
+                "Failed to parse headers (url=%s): %s",
+                self._absolute_url(url),
+                hpe,
+                exc_info=True,
+            )
+
+        return httplib_response
+
+    def _absolute_url(self, path):
+        return Url(scheme=self.scheme, host=self.host, port=self.port, path=path).url
+
+    def close(self):
+        """
+        Close all pooled connections and disable the pool.
+        """
+        if self.pool is None:
+            return
+        # Disable access to the pool
+        old_pool, self.pool = self.pool, None
+
+        # Close all the HTTPConnections in the pool.
+        _close_pool_connections(old_pool)
+
+    def is_same_host(self, url):
+        """
+        Check if the given ``url`` is a member of the same host as this
+        connection pool.
+        """
+        if url.startswith("/"):
+            return True
+
+        # TODO: Add optional support for socket.gethostbyname checking.
+        scheme, host, port = get_host(url)
+        if host is not None:
+            host = _normalize_host(host, scheme=scheme)
+
+        # Use explicit default port for comparison when none is given
+        if self.port and not port:
+            port = port_by_scheme.get(scheme)
+        elif not self.port and port == port_by_scheme.get(scheme):
+            port = None
+
+        return (scheme, host, port) == (self.scheme, self.host, self.port)
+
+    def urlopen(
+        self,
+        method,
+        url,
+        body=None,
+        headers=None,
+        retries=None,
+        redirect=True,
+        assert_same_host=True,
+        timeout=_Default,
+        pool_timeout=None,
+        release_conn=None,
+        chunked=False,
+        body_pos=None,
+        **response_kw
+    ):
+        """
+        Get a connection from the pool and perform an HTTP request. This is the
+        lowest level call for making a request, so you'll need to specify all
+        the raw details.
+
+        .. note::
+
+           More commonly, it's appropriate to use a convenience method provided
+           by :class:`.RequestMethods`, such as :meth:`request`.
+
+        .. note::
+
+           `release_conn` will only behave as expected if
+           `preload_content=False` because we want to make
+           `preload_content=False` the default behaviour someday soon without
+           breaking backwards compatibility.
+
+        :param method:
+            HTTP request method (such as GET, POST, PUT, etc.)
+
+        :param url:
+            The URL to perform the request on.
+
+        :param body:
+            Data to send in the request body, either :class:`str`, :class:`bytes`,
+            an iterable of :class:`str`/:class:`bytes`, or a file-like object.
+
+        :param headers:
+            Dictionary of custom headers to send, such as User-Agent,
+            If-None-Match, etc. If None, pool headers are used. If provided,
+            these headers completely replace any pool-specific headers.
+
+        :param retries:
+            Configure the number of retries to allow before raising a
+            :class:`~urllib3.exceptions.MaxRetryError` exception.
+
+            Pass ``None`` to retry until you receive a response. Pass a
+            :class:`~urllib3.util.retry.Retry` object for fine-grained control
+            over different types of retries.
+            Pass an integer number to retry connection errors that many times,
+            but no other types of errors. Pass zero to never retry.
+
+            If ``False``, then retries are disabled and any exception is raised
+            immediately. Also, instead of raising a MaxRetryError on redirects,
+            the redirect response will be returned.
+
+        :type retries: :class:`~urllib3.util.retry.Retry`, False, or an int.
+
+        :param redirect:
+            If True, automatically handle redirects (status codes 301, 302,
+            303, 307, 308). Each redirect counts as a retry. Disabling retries
+            will disable redirect, too.
+
+        :param assert_same_host:
+            If ``True``, will make sure that the host of the pool requests is
+            consistent else will raise HostChangedError. When ``False``, you can
+            use the pool on an HTTP proxy and request foreign hosts.
+
+        :param timeout:
+            If specified, overrides the default timeout for this one
+            request. It may be a float (in seconds) or an instance of
+            :class:`urllib3.util.Timeout`.
+
+        :param pool_timeout:
+            If set and the pool is set to block=True, then this method will
+            block for ``pool_timeout`` seconds and raise EmptyPoolError if no
+            connection is available within the time period.
+
+        :param release_conn:
+            If False, then the urlopen call will not release the connection
+            back into the pool once a response is received (but will release if
+            you read the entire contents of the response such as when
+            `preload_content=True`). This is useful if you're not preloading
+            the response's content immediately. You will need to call
+            ``r.release_conn()`` on the response ``r`` to return the connection
+            back into the pool. If None, it takes the value of
+            ``response_kw.get('preload_content', True)``.
+
+        :param chunked:
+            If True, urllib3 will send the body using chunked transfer
+            encoding. Otherwise, urllib3 will send the body using the standard
+            content-length form. Defaults to False.
+
+        :param int body_pos:
+            Position to seek to in file-like body in the event of a retry or
+            redirect. Typically this won't need to be set because urllib3 will
+            auto-populate the value when needed.
+
+        :param \\**response_kw:
+            Additional parameters are passed to
+            :meth:`urllib3.response.HTTPResponse.from_httplib`
+        """
+
+        parsed_url = parse_url(url)
+        destination_scheme = parsed_url.scheme
+
+        if headers is None:
+            headers = self.headers
+
+        if not isinstance(retries, Retry):
+            retries = Retry.from_int(retries, redirect=redirect, default=self.retries)
+
+        if release_conn is None:
+            release_conn = response_kw.get("preload_content", True)
+
+        # Check host
+        if assert_same_host and not self.is_same_host(url):
+            raise HostChangedError(self, url, retries)
+
+        # Ensure that the URL we're connecting to is properly encoded
+        if url.startswith("/"):
+            url = six.ensure_str(_encode_target(url))
+        else:
+            url = six.ensure_str(parsed_url.url)
+
+        conn = None
+
+        # Track whether `conn` needs to be released before
+        # returning/raising/recursing. Update this variable if necessary, and
+        # leave `release_conn` constant throughout the function. That way, if
+        # the function recurses, the original value of `release_conn` will be
+        # passed down into the recursive call, and its value will be respected.
+        #
+        # See issue #651 [1] for details.
+        #
+        # [1] 
+        release_this_conn = release_conn
+
+        http_tunnel_required = connection_requires_http_tunnel(
+            self.proxy, self.proxy_config, destination_scheme
+        )
+
+        # Merge the proxy headers. Only done when not using HTTP CONNECT. We
+        # have to copy the headers dict so we can safely change it without those
+        # changes being reflected in anyone else's copy.
+        if not http_tunnel_required:
+            headers = headers.copy()
+            headers.update(self.proxy_headers)
+
+        # Must keep the exception bound to a separate variable or else Python 3
+        # complains about UnboundLocalError.
+        err = None
+
+        # Keep track of whether we cleanly exited the except block. This
+        # ensures we do proper cleanup in finally.
+        clean_exit = False
+
+        # Rewind body position, if needed. Record current position
+        # for future rewinds in the event of a redirect/retry.
+        body_pos = set_file_position(body, body_pos)
+
+        try:
+            # Request a connection from the queue.
+            timeout_obj = self._get_timeout(timeout)
+            conn = self._get_conn(timeout=pool_timeout)
+
+            conn.timeout = timeout_obj.connect_timeout
+
+            is_new_proxy_conn = self.proxy is not None and not getattr(
+                conn, "sock", None
+            )
+            if is_new_proxy_conn and http_tunnel_required:
+                self._prepare_proxy(conn)
+
+            # Make the request on the httplib connection object.
+            httplib_response = self._make_request(
+                conn,
+                method,
+                url,
+                timeout=timeout_obj,
+                body=body,
+                headers=headers,
+                chunked=chunked,
+            )
+
+            # If we're going to release the connection in ``finally:``, then
+            # the response doesn't need to know about the connection. Otherwise
+            # it will also try to release it and we'll have a double-release
+            # mess.
+            response_conn = conn if not release_conn else None
+
+            # Pass method to Response for length checking
+            response_kw["request_method"] = method
+
+            # Import httplib's response into our own wrapper object
+            response = self.ResponseCls.from_httplib(
+                httplib_response,
+                pool=self,
+                connection=response_conn,
+                retries=retries,
+                **response_kw
+            )
+
+            # Everything went great!
+            clean_exit = True
+
+        except EmptyPoolError:
+            # Didn't get a connection from the pool, no need to clean up
+            clean_exit = True
+            release_this_conn = False
+            raise
+
+        except (
+            TimeoutError,
+            HTTPException,
+            SocketError,
+            ProtocolError,
+            BaseSSLError,
+            SSLError,
+            CertificateError,
+        ) as e:
+            # Discard the connection for these exceptions. It will be
+            # replaced during the next _get_conn() call.
+            clean_exit = False
+
+            def _is_ssl_error_message_from_http_proxy(ssl_error):
+                # We're trying to detect the message 'WRONG_VERSION_NUMBER' but
+                # SSLErrors are kinda all over the place when it comes to the message,
+                # so we try to cover our bases here!
+                message = " ".join(re.split("[^a-z]", str(ssl_error).lower()))
+                return (
+                    "wrong version number" in message
+                    or "unknown protocol" in message
+                    or "record layer failure" in message
+                )
+
+            # Try to detect a common user error with proxies which is to
+            # set an HTTP proxy to be HTTPS when it should be 'http://'
+            # (ie {'http': 'http://proxy', 'https': 'https://proxy'})
+            # Instead we add a nice error message and point to a URL.
+            if (
+                isinstance(e, BaseSSLError)
+                and self.proxy
+                and _is_ssl_error_message_from_http_proxy(e)
+                and conn.proxy
+                and conn.proxy.scheme == "https"
+            ):
+                e = ProxyError(
+                    "Your proxy appears to only use HTTP and not HTTPS, "
+                    "try changing your proxy URL to be HTTP. See: "
+                    "https://urllib3.readthedocs.io/en/1.26.x/advanced-usage.html"
+                    "#https-proxy-error-http-proxy",
+                    SSLError(e),
+                )
+            elif isinstance(e, (BaseSSLError, CertificateError)):
+                e = SSLError(e)
+            elif isinstance(e, (SocketError, NewConnectionError)) and self.proxy:
+                e = ProxyError("Cannot connect to proxy.", e)
+            elif isinstance(e, (SocketError, HTTPException)):
+                e = ProtocolError("Connection aborted.", e)
+
+            retries = retries.increment(
+                method, url, error=e, _pool=self, _stacktrace=sys.exc_info()[2]
+            )
+            retries.sleep()
+
+            # Keep track of the error for the retry warning.
+            err = e
+
+        finally:
+            if not clean_exit:
+                # We hit some kind of exception, handled or otherwise. We need
+                # to throw the connection away unless explicitly told not to.
+                # Close the connection, set the variable to None, and make sure
+                # we put the None back in the pool to avoid leaking it.
+                conn = conn and conn.close()
+                release_this_conn = True
+
+            if release_this_conn:
+                # Put the connection back to be reused. If the connection is
+                # expired then it will be None, which will get replaced with a
+                # fresh connection during _get_conn.
+                self._put_conn(conn)
+
+        if not conn:
+            # Try again
+            log.warning(
+                "Retrying (%r) after connection broken by '%r': %s", retries, err, url
+            )
+            return self.urlopen(
+                method,
+                url,
+                body,
+                headers,
+                retries,
+                redirect,
+                assert_same_host,
+                timeout=timeout,
+                pool_timeout=pool_timeout,
+                release_conn=release_conn,
+                chunked=chunked,
+                body_pos=body_pos,
+                **response_kw
+            )
+
+        # Handle redirect?
+        redirect_location = redirect and response.get_redirect_location()
+        if redirect_location:
+            if response.status == 303:
+                # Change the method according to RFC 9110, Section 15.4.4.
+                method = "GET"
+                # And lose the body not to transfer anything sensitive.
+                body = None
+                headers = HTTPHeaderDict(headers)._prepare_for_method_change()
+
+            try:
+                retries = retries.increment(method, url, response=response, _pool=self)
+            except MaxRetryError:
+                if retries.raise_on_redirect:
+                    response.drain_conn()
+                    raise
+                return response
+
+            response.drain_conn()
+            retries.sleep_for_retry(response)
+            log.debug("Redirecting %s -> %s", url, redirect_location)
+            return self.urlopen(
+                method,
+                redirect_location,
+                body,
+                headers,
+                retries=retries,
+                redirect=redirect,
+                assert_same_host=assert_same_host,
+                timeout=timeout,
+                pool_timeout=pool_timeout,
+                release_conn=release_conn,
+                chunked=chunked,
+                body_pos=body_pos,
+                **response_kw
+            )
+
+        # Check if we should retry the HTTP response.
+        has_retry_after = bool(response.headers.get("Retry-After"))
+        if retries.is_retry(method, response.status, has_retry_after):
+            try:
+                retries = retries.increment(method, url, response=response, _pool=self)
+            except MaxRetryError:
+                if retries.raise_on_status:
+                    response.drain_conn()
+                    raise
+                return response
+
+            response.drain_conn()
+            retries.sleep(response)
+            log.debug("Retry: %s", url)
+            return self.urlopen(
+                method,
+                url,
+                body,
+                headers,
+                retries=retries,
+                redirect=redirect,
+                assert_same_host=assert_same_host,
+                timeout=timeout,
+                pool_timeout=pool_timeout,
+                release_conn=release_conn,
+                chunked=chunked,
+                body_pos=body_pos,
+                **response_kw
+            )
+
+        return response
+
+
+class HTTPSConnectionPool(HTTPConnectionPool):
+    """
+    Same as :class:`.HTTPConnectionPool`, but HTTPS.
+
+    :class:`.HTTPSConnection` uses one of ``assert_fingerprint``,
+    ``assert_hostname`` and ``host`` in this order to verify connections.
+    If ``assert_hostname`` is False, no verification is done.
+
+    The ``key_file``, ``cert_file``, ``cert_reqs``, ``ca_certs``,
+    ``ca_cert_dir``, ``ssl_version``, ``key_password`` are only used if :mod:`ssl`
+    is available and are fed into :meth:`urllib3.util.ssl_wrap_socket` to upgrade
+    the connection socket into an SSL socket.
+    """
+
+    scheme = "https"
+    ConnectionCls = HTTPSConnection
+
+    def __init__(
+        self,
+        host,
+        port=None,
+        strict=False,
+        timeout=Timeout.DEFAULT_TIMEOUT,
+        maxsize=1,
+        block=False,
+        headers=None,
+        retries=None,
+        _proxy=None,
+        _proxy_headers=None,
+        key_file=None,
+        cert_file=None,
+        cert_reqs=None,
+        key_password=None,
+        ca_certs=None,
+        ssl_version=None,
+        assert_hostname=None,
+        assert_fingerprint=None,
+        ca_cert_dir=None,
+        **conn_kw
+    ):
+
+        HTTPConnectionPool.__init__(
+            self,
+            host,
+            port,
+            strict,
+            timeout,
+            maxsize,
+            block,
+            headers,
+            retries,
+            _proxy,
+            _proxy_headers,
+            **conn_kw
+        )
+
+        self.key_file = key_file
+        self.cert_file = cert_file
+        self.cert_reqs = cert_reqs
+        self.key_password = key_password
+        self.ca_certs = ca_certs
+        self.ca_cert_dir = ca_cert_dir
+        self.ssl_version = ssl_version
+        self.assert_hostname = assert_hostname
+        self.assert_fingerprint = assert_fingerprint
+
+    def _prepare_conn(self, conn):
+        """
+        Prepare the ``connection`` for :meth:`urllib3.util.ssl_wrap_socket`
+        and establish the tunnel if proxy is used.
+        """
+
+        if isinstance(conn, VerifiedHTTPSConnection):
+            conn.set_cert(
+                key_file=self.key_file,
+                key_password=self.key_password,
+                cert_file=self.cert_file,
+                cert_reqs=self.cert_reqs,
+                ca_certs=self.ca_certs,
+                ca_cert_dir=self.ca_cert_dir,
+                assert_hostname=self.assert_hostname,
+                assert_fingerprint=self.assert_fingerprint,
+            )
+            conn.ssl_version = self.ssl_version
+        return conn
+
+    def _prepare_proxy(self, conn):
+        """
+        Establishes a tunnel connection through HTTP CONNECT.
+
+        Tunnel connection is established early because otherwise httplib would
+        improperly set Host: header to proxy's IP:port.
+        """
+
+        conn.set_tunnel(self._proxy_host, self.port, self.proxy_headers)
+
+        if self.proxy.scheme == "https":
+            conn.tls_in_tls_required = True
+
+        conn.connect()
+
+    def _new_conn(self):
+        """
+        Return a fresh :class:`http.client.HTTPSConnection`.
+        """
+        self.num_connections += 1
+        log.debug(
+            "Starting new HTTPS connection (%d): %s:%s",
+            self.num_connections,
+            self.host,
+            self.port or "443",
+        )
+
+        if not self.ConnectionCls or self.ConnectionCls is DummyConnection:
+            raise SSLError(
+                "Can't connect to HTTPS URL because the SSL module is not available."
+            )
+
+        actual_host = self.host
+        actual_port = self.port
+        if self.proxy is not None:
+            actual_host = self.proxy.host
+            actual_port = self.proxy.port
+
+        conn = self.ConnectionCls(
+            host=actual_host,
+            port=actual_port,
+            timeout=self.timeout.connect_timeout,
+            strict=self.strict,
+            cert_file=self.cert_file,
+            key_file=self.key_file,
+            key_password=self.key_password,
+            **self.conn_kw
+        )
+
+        return self._prepare_conn(conn)
+
+    def _validate_conn(self, conn):
+        """
+        Called right before a request is made, after the socket is created.
+        """
+        super(HTTPSConnectionPool, self)._validate_conn(conn)
+
+        # Force connect early to allow us to validate the connection.
+        if not getattr(conn, "sock", None):  # AppEngine might not have  `.sock`
+            conn.connect()
+
+        if not conn.is_verified:
+            warnings.warn(
+                (
+                    "Unverified HTTPS request is being made to host '%s'. "
+                    "Adding certificate verification is strongly advised. See: "
+                    "https://urllib3.readthedocs.io/en/1.26.x/advanced-usage.html"
+                    "#ssl-warnings" % conn.host
+                ),
+                InsecureRequestWarning,
+            )
+
+        if getattr(conn, "proxy_is_verified", None) is False:
+            warnings.warn(
+                (
+                    "Unverified HTTPS connection done to an HTTPS proxy. "
+                    "Adding certificate verification is strongly advised. See: "
+                    "https://urllib3.readthedocs.io/en/1.26.x/advanced-usage.html"
+                    "#ssl-warnings"
+                ),
+                InsecureRequestWarning,
+            )
+
+
+def connection_from_url(url, **kw):
+    """
+    Given a url, return an :class:`.ConnectionPool` instance of its host.
+
+    This is a shortcut for not having to parse out the scheme, host, and port
+    of the url before creating an :class:`.ConnectionPool` instance.
+
+    :param url:
+        Absolute URL string that must include the scheme. Port is optional.
+
+    :param \\**kw:
+        Passes additional parameters to the constructor of the appropriate
+        :class:`.ConnectionPool`. Useful for specifying things like
+        timeout, maxsize, headers, etc.
+
+    Example::
+
+        >>> conn = connection_from_url('http://google.com/')
+        >>> r = conn.request('GET', '/')
+    """
+    scheme, host, port = get_host(url)
+    port = port or port_by_scheme.get(scheme, 80)
+    if scheme == "https":
+        return HTTPSConnectionPool(host, port=port, **kw)
+    else:
+        return HTTPConnectionPool(host, port=port, **kw)
+
+
+def _normalize_host(host, scheme):
+    """
+    Normalize hosts for comparisons and use with sockets.
+    """
+
+    host = normalize_host(host, scheme)
+
+    # httplib doesn't like it when we include brackets in IPv6 addresses
+    # Specifically, if we include brackets but also pass the port then
+    # httplib crazily doubles up the square brackets on the Host header.
+    # Instead, we need to make sure we never pass ``None`` as the port.
+    # However, for backward compatibility reasons we can't actually
+    # *assert* that.  See http://bugs.python.org/issue28539
+    if host.startswith("[") and host.endswith("]"):
+        host = host[1:-1]
+    return host
+
+
+def _close_pool_connections(pool):
+    """Drains a queue of connections and closes each one."""
+    try:
+        while True:
+            conn = pool.get(block=False)
+            if conn:
+                conn.close()
+    except queue.Empty:
+        pass  # Done.
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/__init__.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/__init__.py
new file mode 100644
index 0000000..e69de29
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/__pycache__/__init__.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/__pycache__/__init__.cpython-312.pyc
new file mode 100644
index 0000000..a51d85a
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/__pycache__/__init__.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/__pycache__/_appengine_environ.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/__pycache__/_appengine_environ.cpython-312.pyc
new file mode 100644
index 0000000..97dfaa1
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/__pycache__/_appengine_environ.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/__pycache__/appengine.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/__pycache__/appengine.cpython-312.pyc
new file mode 100644
index 0000000..3f23a04
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/__pycache__/appengine.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/__pycache__/ntlmpool.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/__pycache__/ntlmpool.cpython-312.pyc
new file mode 100644
index 0000000..bc068ee
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/__pycache__/ntlmpool.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/__pycache__/pyopenssl.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/__pycache__/pyopenssl.cpython-312.pyc
new file mode 100644
index 0000000..c84a826
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/__pycache__/pyopenssl.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/__pycache__/securetransport.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/__pycache__/securetransport.cpython-312.pyc
new file mode 100644
index 0000000..36b7b00
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/__pycache__/securetransport.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/__pycache__/socks.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/__pycache__/socks.cpython-312.pyc
new file mode 100644
index 0000000..829986b
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/__pycache__/socks.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/_appengine_environ.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/_appengine_environ.py
new file mode 100644
index 0000000..8765b90
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/_appengine_environ.py
@@ -0,0 +1,36 @@
+"""
+This module provides means to detect the App Engine environment.
+"""
+
+import os
+
+
+def is_appengine():
+    return is_local_appengine() or is_prod_appengine()
+
+
+def is_appengine_sandbox():
+    """Reports if the app is running in the first generation sandbox.
+
+    The second generation runtimes are technically still in a sandbox, but it
+    is much less restrictive, so generally you shouldn't need to check for it.
+    see https://cloud.google.com/appengine/docs/standard/runtimes
+    """
+    return is_appengine() and os.environ["APPENGINE_RUNTIME"] == "python27"
+
+
+def is_local_appengine():
+    return "APPENGINE_RUNTIME" in os.environ and os.environ.get(
+        "SERVER_SOFTWARE", ""
+    ).startswith("Development/")
+
+
+def is_prod_appengine():
+    return "APPENGINE_RUNTIME" in os.environ and os.environ.get(
+        "SERVER_SOFTWARE", ""
+    ).startswith("Google App Engine/")
+
+
+def is_prod_appengine_mvms():
+    """Deprecated."""
+    return False
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/_securetransport/__init__.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/_securetransport/__init__.py
new file mode 100644
index 0000000..e69de29
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/_securetransport/__pycache__/__init__.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/_securetransport/__pycache__/__init__.cpython-312.pyc
new file mode 100644
index 0000000..d1bb26e
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/_securetransport/__pycache__/__init__.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/_securetransport/__pycache__/bindings.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/_securetransport/__pycache__/bindings.cpython-312.pyc
new file mode 100644
index 0000000..ad04d6f
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/_securetransport/__pycache__/bindings.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/_securetransport/__pycache__/low_level.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/_securetransport/__pycache__/low_level.cpython-312.pyc
new file mode 100644
index 0000000..a56a7ec
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/_securetransport/__pycache__/low_level.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/_securetransport/bindings.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/_securetransport/bindings.py
new file mode 100644
index 0000000..264d564
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/_securetransport/bindings.py
@@ -0,0 +1,519 @@
+"""
+This module uses ctypes to bind a whole bunch of functions and constants from
+SecureTransport. The goal here is to provide the low-level API to
+SecureTransport. These are essentially the C-level functions and constants, and
+they're pretty gross to work with.
+
+This code is a bastardised version of the code found in Will Bond's oscrypto
+library. An enormous debt is owed to him for blazing this trail for us. For
+that reason, this code should be considered to be covered both by urllib3's
+license and by oscrypto's:
+
+    Copyright (c) 2015-2016 Will Bond 
+
+    Permission is hereby granted, free of charge, to any person obtaining a
+    copy of this software and associated documentation files (the "Software"),
+    to deal in the Software without restriction, including without limitation
+    the rights to use, copy, modify, merge, publish, distribute, sublicense,
+    and/or sell copies of the Software, and to permit persons to whom the
+    Software is furnished to do so, subject to the following conditions:
+
+    The above copyright notice and this permission notice shall be included in
+    all copies or substantial portions of the Software.
+
+    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+    IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+    FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+    AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+    LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+    FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
+    DEALINGS IN THE SOFTWARE.
+"""
+from __future__ import absolute_import
+
+import platform
+from ctypes import (
+    CDLL,
+    CFUNCTYPE,
+    POINTER,
+    c_bool,
+    c_byte,
+    c_char_p,
+    c_int32,
+    c_long,
+    c_size_t,
+    c_uint32,
+    c_ulong,
+    c_void_p,
+)
+from ctypes.util import find_library
+
+from ...packages.six import raise_from
+
+if platform.system() != "Darwin":
+    raise ImportError("Only macOS is supported")
+
+version = platform.mac_ver()[0]
+version_info = tuple(map(int, version.split(".")))
+if version_info < (10, 8):
+    raise OSError(
+        "Only OS X 10.8 and newer are supported, not %s.%s"
+        % (version_info[0], version_info[1])
+    )
+
+
+def load_cdll(name, macos10_16_path):
+    """Loads a CDLL by name, falling back to known path on 10.16+"""
+    try:
+        # Big Sur is technically 11 but we use 10.16 due to the Big Sur
+        # beta being labeled as 10.16.
+        if version_info >= (10, 16):
+            path = macos10_16_path
+        else:
+            path = find_library(name)
+        if not path:
+            raise OSError  # Caught and reraised as 'ImportError'
+        return CDLL(path, use_errno=True)
+    except OSError:
+        raise_from(ImportError("The library %s failed to load" % name), None)
+
+
+Security = load_cdll(
+    "Security", "/System/Library/Frameworks/Security.framework/Security"
+)
+CoreFoundation = load_cdll(
+    "CoreFoundation",
+    "/System/Library/Frameworks/CoreFoundation.framework/CoreFoundation",
+)
+
+
+Boolean = c_bool
+CFIndex = c_long
+CFStringEncoding = c_uint32
+CFData = c_void_p
+CFString = c_void_p
+CFArray = c_void_p
+CFMutableArray = c_void_p
+CFDictionary = c_void_p
+CFError = c_void_p
+CFType = c_void_p
+CFTypeID = c_ulong
+
+CFTypeRef = POINTER(CFType)
+CFAllocatorRef = c_void_p
+
+OSStatus = c_int32
+
+CFDataRef = POINTER(CFData)
+CFStringRef = POINTER(CFString)
+CFArrayRef = POINTER(CFArray)
+CFMutableArrayRef = POINTER(CFMutableArray)
+CFDictionaryRef = POINTER(CFDictionary)
+CFArrayCallBacks = c_void_p
+CFDictionaryKeyCallBacks = c_void_p
+CFDictionaryValueCallBacks = c_void_p
+
+SecCertificateRef = POINTER(c_void_p)
+SecExternalFormat = c_uint32
+SecExternalItemType = c_uint32
+SecIdentityRef = POINTER(c_void_p)
+SecItemImportExportFlags = c_uint32
+SecItemImportExportKeyParameters = c_void_p
+SecKeychainRef = POINTER(c_void_p)
+SSLProtocol = c_uint32
+SSLCipherSuite = c_uint32
+SSLContextRef = POINTER(c_void_p)
+SecTrustRef = POINTER(c_void_p)
+SSLConnectionRef = c_uint32
+SecTrustResultType = c_uint32
+SecTrustOptionFlags = c_uint32
+SSLProtocolSide = c_uint32
+SSLConnectionType = c_uint32
+SSLSessionOption = c_uint32
+
+
+try:
+    Security.SecItemImport.argtypes = [
+        CFDataRef,
+        CFStringRef,
+        POINTER(SecExternalFormat),
+        POINTER(SecExternalItemType),
+        SecItemImportExportFlags,
+        POINTER(SecItemImportExportKeyParameters),
+        SecKeychainRef,
+        POINTER(CFArrayRef),
+    ]
+    Security.SecItemImport.restype = OSStatus
+
+    Security.SecCertificateGetTypeID.argtypes = []
+    Security.SecCertificateGetTypeID.restype = CFTypeID
+
+    Security.SecIdentityGetTypeID.argtypes = []
+    Security.SecIdentityGetTypeID.restype = CFTypeID
+
+    Security.SecKeyGetTypeID.argtypes = []
+    Security.SecKeyGetTypeID.restype = CFTypeID
+
+    Security.SecCertificateCreateWithData.argtypes = [CFAllocatorRef, CFDataRef]
+    Security.SecCertificateCreateWithData.restype = SecCertificateRef
+
+    Security.SecCertificateCopyData.argtypes = [SecCertificateRef]
+    Security.SecCertificateCopyData.restype = CFDataRef
+
+    Security.SecCopyErrorMessageString.argtypes = [OSStatus, c_void_p]
+    Security.SecCopyErrorMessageString.restype = CFStringRef
+
+    Security.SecIdentityCreateWithCertificate.argtypes = [
+        CFTypeRef,
+        SecCertificateRef,
+        POINTER(SecIdentityRef),
+    ]
+    Security.SecIdentityCreateWithCertificate.restype = OSStatus
+
+    Security.SecKeychainCreate.argtypes = [
+        c_char_p,
+        c_uint32,
+        c_void_p,
+        Boolean,
+        c_void_p,
+        POINTER(SecKeychainRef),
+    ]
+    Security.SecKeychainCreate.restype = OSStatus
+
+    Security.SecKeychainDelete.argtypes = [SecKeychainRef]
+    Security.SecKeychainDelete.restype = OSStatus
+
+    Security.SecPKCS12Import.argtypes = [
+        CFDataRef,
+        CFDictionaryRef,
+        POINTER(CFArrayRef),
+    ]
+    Security.SecPKCS12Import.restype = OSStatus
+
+    SSLReadFunc = CFUNCTYPE(OSStatus, SSLConnectionRef, c_void_p, POINTER(c_size_t))
+    SSLWriteFunc = CFUNCTYPE(
+        OSStatus, SSLConnectionRef, POINTER(c_byte), POINTER(c_size_t)
+    )
+
+    Security.SSLSetIOFuncs.argtypes = [SSLContextRef, SSLReadFunc, SSLWriteFunc]
+    Security.SSLSetIOFuncs.restype = OSStatus
+
+    Security.SSLSetPeerID.argtypes = [SSLContextRef, c_char_p, c_size_t]
+    Security.SSLSetPeerID.restype = OSStatus
+
+    Security.SSLSetCertificate.argtypes = [SSLContextRef, CFArrayRef]
+    Security.SSLSetCertificate.restype = OSStatus
+
+    Security.SSLSetCertificateAuthorities.argtypes = [SSLContextRef, CFTypeRef, Boolean]
+    Security.SSLSetCertificateAuthorities.restype = OSStatus
+
+    Security.SSLSetConnection.argtypes = [SSLContextRef, SSLConnectionRef]
+    Security.SSLSetConnection.restype = OSStatus
+
+    Security.SSLSetPeerDomainName.argtypes = [SSLContextRef, c_char_p, c_size_t]
+    Security.SSLSetPeerDomainName.restype = OSStatus
+
+    Security.SSLHandshake.argtypes = [SSLContextRef]
+    Security.SSLHandshake.restype = OSStatus
+
+    Security.SSLRead.argtypes = [SSLContextRef, c_char_p, c_size_t, POINTER(c_size_t)]
+    Security.SSLRead.restype = OSStatus
+
+    Security.SSLWrite.argtypes = [SSLContextRef, c_char_p, c_size_t, POINTER(c_size_t)]
+    Security.SSLWrite.restype = OSStatus
+
+    Security.SSLClose.argtypes = [SSLContextRef]
+    Security.SSLClose.restype = OSStatus
+
+    Security.SSLGetNumberSupportedCiphers.argtypes = [SSLContextRef, POINTER(c_size_t)]
+    Security.SSLGetNumberSupportedCiphers.restype = OSStatus
+
+    Security.SSLGetSupportedCiphers.argtypes = [
+        SSLContextRef,
+        POINTER(SSLCipherSuite),
+        POINTER(c_size_t),
+    ]
+    Security.SSLGetSupportedCiphers.restype = OSStatus
+
+    Security.SSLSetEnabledCiphers.argtypes = [
+        SSLContextRef,
+        POINTER(SSLCipherSuite),
+        c_size_t,
+    ]
+    Security.SSLSetEnabledCiphers.restype = OSStatus
+
+    Security.SSLGetNumberEnabledCiphers.argtype = [SSLContextRef, POINTER(c_size_t)]
+    Security.SSLGetNumberEnabledCiphers.restype = OSStatus
+
+    Security.SSLGetEnabledCiphers.argtypes = [
+        SSLContextRef,
+        POINTER(SSLCipherSuite),
+        POINTER(c_size_t),
+    ]
+    Security.SSLGetEnabledCiphers.restype = OSStatus
+
+    Security.SSLGetNegotiatedCipher.argtypes = [SSLContextRef, POINTER(SSLCipherSuite)]
+    Security.SSLGetNegotiatedCipher.restype = OSStatus
+
+    Security.SSLGetNegotiatedProtocolVersion.argtypes = [
+        SSLContextRef,
+        POINTER(SSLProtocol),
+    ]
+    Security.SSLGetNegotiatedProtocolVersion.restype = OSStatus
+
+    Security.SSLCopyPeerTrust.argtypes = [SSLContextRef, POINTER(SecTrustRef)]
+    Security.SSLCopyPeerTrust.restype = OSStatus
+
+    Security.SecTrustSetAnchorCertificates.argtypes = [SecTrustRef, CFArrayRef]
+    Security.SecTrustSetAnchorCertificates.restype = OSStatus
+
+    Security.SecTrustSetAnchorCertificatesOnly.argstypes = [SecTrustRef, Boolean]
+    Security.SecTrustSetAnchorCertificatesOnly.restype = OSStatus
+
+    Security.SecTrustEvaluate.argtypes = [SecTrustRef, POINTER(SecTrustResultType)]
+    Security.SecTrustEvaluate.restype = OSStatus
+
+    Security.SecTrustGetCertificateCount.argtypes = [SecTrustRef]
+    Security.SecTrustGetCertificateCount.restype = CFIndex
+
+    Security.SecTrustGetCertificateAtIndex.argtypes = [SecTrustRef, CFIndex]
+    Security.SecTrustGetCertificateAtIndex.restype = SecCertificateRef
+
+    Security.SSLCreateContext.argtypes = [
+        CFAllocatorRef,
+        SSLProtocolSide,
+        SSLConnectionType,
+    ]
+    Security.SSLCreateContext.restype = SSLContextRef
+
+    Security.SSLSetSessionOption.argtypes = [SSLContextRef, SSLSessionOption, Boolean]
+    Security.SSLSetSessionOption.restype = OSStatus
+
+    Security.SSLSetProtocolVersionMin.argtypes = [SSLContextRef, SSLProtocol]
+    Security.SSLSetProtocolVersionMin.restype = OSStatus
+
+    Security.SSLSetProtocolVersionMax.argtypes = [SSLContextRef, SSLProtocol]
+    Security.SSLSetProtocolVersionMax.restype = OSStatus
+
+    try:
+        Security.SSLSetALPNProtocols.argtypes = [SSLContextRef, CFArrayRef]
+        Security.SSLSetALPNProtocols.restype = OSStatus
+    except AttributeError:
+        # Supported only in 10.12+
+        pass
+
+    Security.SecCopyErrorMessageString.argtypes = [OSStatus, c_void_p]
+    Security.SecCopyErrorMessageString.restype = CFStringRef
+
+    Security.SSLReadFunc = SSLReadFunc
+    Security.SSLWriteFunc = SSLWriteFunc
+    Security.SSLContextRef = SSLContextRef
+    Security.SSLProtocol = SSLProtocol
+    Security.SSLCipherSuite = SSLCipherSuite
+    Security.SecIdentityRef = SecIdentityRef
+    Security.SecKeychainRef = SecKeychainRef
+    Security.SecTrustRef = SecTrustRef
+    Security.SecTrustResultType = SecTrustResultType
+    Security.SecExternalFormat = SecExternalFormat
+    Security.OSStatus = OSStatus
+
+    Security.kSecImportExportPassphrase = CFStringRef.in_dll(
+        Security, "kSecImportExportPassphrase"
+    )
+    Security.kSecImportItemIdentity = CFStringRef.in_dll(
+        Security, "kSecImportItemIdentity"
+    )
+
+    # CoreFoundation time!
+    CoreFoundation.CFRetain.argtypes = [CFTypeRef]
+    CoreFoundation.CFRetain.restype = CFTypeRef
+
+    CoreFoundation.CFRelease.argtypes = [CFTypeRef]
+    CoreFoundation.CFRelease.restype = None
+
+    CoreFoundation.CFGetTypeID.argtypes = [CFTypeRef]
+    CoreFoundation.CFGetTypeID.restype = CFTypeID
+
+    CoreFoundation.CFStringCreateWithCString.argtypes = [
+        CFAllocatorRef,
+        c_char_p,
+        CFStringEncoding,
+    ]
+    CoreFoundation.CFStringCreateWithCString.restype = CFStringRef
+
+    CoreFoundation.CFStringGetCStringPtr.argtypes = [CFStringRef, CFStringEncoding]
+    CoreFoundation.CFStringGetCStringPtr.restype = c_char_p
+
+    CoreFoundation.CFStringGetCString.argtypes = [
+        CFStringRef,
+        c_char_p,
+        CFIndex,
+        CFStringEncoding,
+    ]
+    CoreFoundation.CFStringGetCString.restype = c_bool
+
+    CoreFoundation.CFDataCreate.argtypes = [CFAllocatorRef, c_char_p, CFIndex]
+    CoreFoundation.CFDataCreate.restype = CFDataRef
+
+    CoreFoundation.CFDataGetLength.argtypes = [CFDataRef]
+    CoreFoundation.CFDataGetLength.restype = CFIndex
+
+    CoreFoundation.CFDataGetBytePtr.argtypes = [CFDataRef]
+    CoreFoundation.CFDataGetBytePtr.restype = c_void_p
+
+    CoreFoundation.CFDictionaryCreate.argtypes = [
+        CFAllocatorRef,
+        POINTER(CFTypeRef),
+        POINTER(CFTypeRef),
+        CFIndex,
+        CFDictionaryKeyCallBacks,
+        CFDictionaryValueCallBacks,
+    ]
+    CoreFoundation.CFDictionaryCreate.restype = CFDictionaryRef
+
+    CoreFoundation.CFDictionaryGetValue.argtypes = [CFDictionaryRef, CFTypeRef]
+    CoreFoundation.CFDictionaryGetValue.restype = CFTypeRef
+
+    CoreFoundation.CFArrayCreate.argtypes = [
+        CFAllocatorRef,
+        POINTER(CFTypeRef),
+        CFIndex,
+        CFArrayCallBacks,
+    ]
+    CoreFoundation.CFArrayCreate.restype = CFArrayRef
+
+    CoreFoundation.CFArrayCreateMutable.argtypes = [
+        CFAllocatorRef,
+        CFIndex,
+        CFArrayCallBacks,
+    ]
+    CoreFoundation.CFArrayCreateMutable.restype = CFMutableArrayRef
+
+    CoreFoundation.CFArrayAppendValue.argtypes = [CFMutableArrayRef, c_void_p]
+    CoreFoundation.CFArrayAppendValue.restype = None
+
+    CoreFoundation.CFArrayGetCount.argtypes = [CFArrayRef]
+    CoreFoundation.CFArrayGetCount.restype = CFIndex
+
+    CoreFoundation.CFArrayGetValueAtIndex.argtypes = [CFArrayRef, CFIndex]
+    CoreFoundation.CFArrayGetValueAtIndex.restype = c_void_p
+
+    CoreFoundation.kCFAllocatorDefault = CFAllocatorRef.in_dll(
+        CoreFoundation, "kCFAllocatorDefault"
+    )
+    CoreFoundation.kCFTypeArrayCallBacks = c_void_p.in_dll(
+        CoreFoundation, "kCFTypeArrayCallBacks"
+    )
+    CoreFoundation.kCFTypeDictionaryKeyCallBacks = c_void_p.in_dll(
+        CoreFoundation, "kCFTypeDictionaryKeyCallBacks"
+    )
+    CoreFoundation.kCFTypeDictionaryValueCallBacks = c_void_p.in_dll(
+        CoreFoundation, "kCFTypeDictionaryValueCallBacks"
+    )
+
+    CoreFoundation.CFTypeRef = CFTypeRef
+    CoreFoundation.CFArrayRef = CFArrayRef
+    CoreFoundation.CFStringRef = CFStringRef
+    CoreFoundation.CFDictionaryRef = CFDictionaryRef
+
+except (AttributeError):
+    raise ImportError("Error initializing ctypes")
+
+
+class CFConst(object):
+    """
+    A class object that acts as essentially a namespace for CoreFoundation
+    constants.
+    """
+
+    kCFStringEncodingUTF8 = CFStringEncoding(0x08000100)
+
+
+class SecurityConst(object):
+    """
+    A class object that acts as essentially a namespace for Security constants.
+    """
+
+    kSSLSessionOptionBreakOnServerAuth = 0
+
+    kSSLProtocol2 = 1
+    kSSLProtocol3 = 2
+    kTLSProtocol1 = 4
+    kTLSProtocol11 = 7
+    kTLSProtocol12 = 8
+    # SecureTransport does not support TLS 1.3 even if there's a constant for it
+    kTLSProtocol13 = 10
+    kTLSProtocolMaxSupported = 999
+
+    kSSLClientSide = 1
+    kSSLStreamType = 0
+
+    kSecFormatPEMSequence = 10
+
+    kSecTrustResultInvalid = 0
+    kSecTrustResultProceed = 1
+    # This gap is present on purpose: this was kSecTrustResultConfirm, which
+    # is deprecated.
+    kSecTrustResultDeny = 3
+    kSecTrustResultUnspecified = 4
+    kSecTrustResultRecoverableTrustFailure = 5
+    kSecTrustResultFatalTrustFailure = 6
+    kSecTrustResultOtherError = 7
+
+    errSSLProtocol = -9800
+    errSSLWouldBlock = -9803
+    errSSLClosedGraceful = -9805
+    errSSLClosedNoNotify = -9816
+    errSSLClosedAbort = -9806
+
+    errSSLXCertChainInvalid = -9807
+    errSSLCrypto = -9809
+    errSSLInternal = -9810
+    errSSLCertExpired = -9814
+    errSSLCertNotYetValid = -9815
+    errSSLUnknownRootCert = -9812
+    errSSLNoRootCert = -9813
+    errSSLHostNameMismatch = -9843
+    errSSLPeerHandshakeFail = -9824
+    errSSLPeerUserCancelled = -9839
+    errSSLWeakPeerEphemeralDHKey = -9850
+    errSSLServerAuthCompleted = -9841
+    errSSLRecordOverflow = -9847
+
+    errSecVerifyFailed = -67808
+    errSecNoTrustSettings = -25263
+    errSecItemNotFound = -25300
+    errSecInvalidTrustSettings = -25262
+
+    # Cipher suites. We only pick the ones our default cipher string allows.
+    # Source: https://developer.apple.com/documentation/security/1550981-ssl_cipher_suite_values
+    TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384 = 0xC02C
+    TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 = 0xC030
+    TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256 = 0xC02B
+    TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256 = 0xC02F
+    TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305_SHA256 = 0xCCA9
+    TLS_ECDHE_RSA_WITH_CHACHA20_POLY1305_SHA256 = 0xCCA8
+    TLS_DHE_RSA_WITH_AES_256_GCM_SHA384 = 0x009F
+    TLS_DHE_RSA_WITH_AES_128_GCM_SHA256 = 0x009E
+    TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384 = 0xC024
+    TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384 = 0xC028
+    TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA = 0xC00A
+    TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA = 0xC014
+    TLS_DHE_RSA_WITH_AES_256_CBC_SHA256 = 0x006B
+    TLS_DHE_RSA_WITH_AES_256_CBC_SHA = 0x0039
+    TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256 = 0xC023
+    TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256 = 0xC027
+    TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA = 0xC009
+    TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA = 0xC013
+    TLS_DHE_RSA_WITH_AES_128_CBC_SHA256 = 0x0067
+    TLS_DHE_RSA_WITH_AES_128_CBC_SHA = 0x0033
+    TLS_RSA_WITH_AES_256_GCM_SHA384 = 0x009D
+    TLS_RSA_WITH_AES_128_GCM_SHA256 = 0x009C
+    TLS_RSA_WITH_AES_256_CBC_SHA256 = 0x003D
+    TLS_RSA_WITH_AES_128_CBC_SHA256 = 0x003C
+    TLS_RSA_WITH_AES_256_CBC_SHA = 0x0035
+    TLS_RSA_WITH_AES_128_CBC_SHA = 0x002F
+    TLS_AES_128_GCM_SHA256 = 0x1301
+    TLS_AES_256_GCM_SHA384 = 0x1302
+    TLS_AES_128_CCM_8_SHA256 = 0x1305
+    TLS_AES_128_CCM_SHA256 = 0x1304
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/_securetransport/low_level.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/_securetransport/low_level.py
new file mode 100644
index 0000000..fa0b245
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/_securetransport/low_level.py
@@ -0,0 +1,397 @@
+"""
+Low-level helpers for the SecureTransport bindings.
+
+These are Python functions that are not directly related to the high-level APIs
+but are necessary to get them to work. They include a whole bunch of low-level
+CoreFoundation messing about and memory management. The concerns in this module
+are almost entirely about trying to avoid memory leaks and providing
+appropriate and useful assistance to the higher-level code.
+"""
+import base64
+import ctypes
+import itertools
+import os
+import re
+import ssl
+import struct
+import tempfile
+
+from .bindings import CFConst, CoreFoundation, Security
+
+# This regular expression is used to grab PEM data out of a PEM bundle.
+_PEM_CERTS_RE = re.compile(
+    b"-----BEGIN CERTIFICATE-----\n(.*?)\n-----END CERTIFICATE-----", re.DOTALL
+)
+
+
+def _cf_data_from_bytes(bytestring):
+    """
+    Given a bytestring, create a CFData object from it. This CFData object must
+    be CFReleased by the caller.
+    """
+    return CoreFoundation.CFDataCreate(
+        CoreFoundation.kCFAllocatorDefault, bytestring, len(bytestring)
+    )
+
+
+def _cf_dictionary_from_tuples(tuples):
+    """
+    Given a list of Python tuples, create an associated CFDictionary.
+    """
+    dictionary_size = len(tuples)
+
+    # We need to get the dictionary keys and values out in the same order.
+    keys = (t[0] for t in tuples)
+    values = (t[1] for t in tuples)
+    cf_keys = (CoreFoundation.CFTypeRef * dictionary_size)(*keys)
+    cf_values = (CoreFoundation.CFTypeRef * dictionary_size)(*values)
+
+    return CoreFoundation.CFDictionaryCreate(
+        CoreFoundation.kCFAllocatorDefault,
+        cf_keys,
+        cf_values,
+        dictionary_size,
+        CoreFoundation.kCFTypeDictionaryKeyCallBacks,
+        CoreFoundation.kCFTypeDictionaryValueCallBacks,
+    )
+
+
+def _cfstr(py_bstr):
+    """
+    Given a Python binary data, create a CFString.
+    The string must be CFReleased by the caller.
+    """
+    c_str = ctypes.c_char_p(py_bstr)
+    cf_str = CoreFoundation.CFStringCreateWithCString(
+        CoreFoundation.kCFAllocatorDefault,
+        c_str,
+        CFConst.kCFStringEncodingUTF8,
+    )
+    return cf_str
+
+
+def _create_cfstring_array(lst):
+    """
+    Given a list of Python binary data, create an associated CFMutableArray.
+    The array must be CFReleased by the caller.
+
+    Raises an ssl.SSLError on failure.
+    """
+    cf_arr = None
+    try:
+        cf_arr = CoreFoundation.CFArrayCreateMutable(
+            CoreFoundation.kCFAllocatorDefault,
+            0,
+            ctypes.byref(CoreFoundation.kCFTypeArrayCallBacks),
+        )
+        if not cf_arr:
+            raise MemoryError("Unable to allocate memory!")
+        for item in lst:
+            cf_str = _cfstr(item)
+            if not cf_str:
+                raise MemoryError("Unable to allocate memory!")
+            try:
+                CoreFoundation.CFArrayAppendValue(cf_arr, cf_str)
+            finally:
+                CoreFoundation.CFRelease(cf_str)
+    except BaseException as e:
+        if cf_arr:
+            CoreFoundation.CFRelease(cf_arr)
+        raise ssl.SSLError("Unable to allocate array: %s" % (e,))
+    return cf_arr
+
+
+def _cf_string_to_unicode(value):
+    """
+    Creates a Unicode string from a CFString object. Used entirely for error
+    reporting.
+
+    Yes, it annoys me quite a lot that this function is this complex.
+    """
+    value_as_void_p = ctypes.cast(value, ctypes.POINTER(ctypes.c_void_p))
+
+    string = CoreFoundation.CFStringGetCStringPtr(
+        value_as_void_p, CFConst.kCFStringEncodingUTF8
+    )
+    if string is None:
+        buffer = ctypes.create_string_buffer(1024)
+        result = CoreFoundation.CFStringGetCString(
+            value_as_void_p, buffer, 1024, CFConst.kCFStringEncodingUTF8
+        )
+        if not result:
+            raise OSError("Error copying C string from CFStringRef")
+        string = buffer.value
+    if string is not None:
+        string = string.decode("utf-8")
+    return string
+
+
+def _assert_no_error(error, exception_class=None):
+    """
+    Checks the return code and throws an exception if there is an error to
+    report
+    """
+    if error == 0:
+        return
+
+    cf_error_string = Security.SecCopyErrorMessageString(error, None)
+    output = _cf_string_to_unicode(cf_error_string)
+    CoreFoundation.CFRelease(cf_error_string)
+
+    if output is None or output == u"":
+        output = u"OSStatus %s" % error
+
+    if exception_class is None:
+        exception_class = ssl.SSLError
+
+    raise exception_class(output)
+
+
+def _cert_array_from_pem(pem_bundle):
+    """
+    Given a bundle of certs in PEM format, turns them into a CFArray of certs
+    that can be used to validate a cert chain.
+    """
+    # Normalize the PEM bundle's line endings.
+    pem_bundle = pem_bundle.replace(b"\r\n", b"\n")
+
+    der_certs = [
+        base64.b64decode(match.group(1)) for match in _PEM_CERTS_RE.finditer(pem_bundle)
+    ]
+    if not der_certs:
+        raise ssl.SSLError("No root certificates specified")
+
+    cert_array = CoreFoundation.CFArrayCreateMutable(
+        CoreFoundation.kCFAllocatorDefault,
+        0,
+        ctypes.byref(CoreFoundation.kCFTypeArrayCallBacks),
+    )
+    if not cert_array:
+        raise ssl.SSLError("Unable to allocate memory!")
+
+    try:
+        for der_bytes in der_certs:
+            certdata = _cf_data_from_bytes(der_bytes)
+            if not certdata:
+                raise ssl.SSLError("Unable to allocate memory!")
+            cert = Security.SecCertificateCreateWithData(
+                CoreFoundation.kCFAllocatorDefault, certdata
+            )
+            CoreFoundation.CFRelease(certdata)
+            if not cert:
+                raise ssl.SSLError("Unable to build cert object!")
+
+            CoreFoundation.CFArrayAppendValue(cert_array, cert)
+            CoreFoundation.CFRelease(cert)
+    except Exception:
+        # We need to free the array before the exception bubbles further.
+        # We only want to do that if an error occurs: otherwise, the caller
+        # should free.
+        CoreFoundation.CFRelease(cert_array)
+        raise
+
+    return cert_array
+
+
+def _is_cert(item):
+    """
+    Returns True if a given CFTypeRef is a certificate.
+    """
+    expected = Security.SecCertificateGetTypeID()
+    return CoreFoundation.CFGetTypeID(item) == expected
+
+
+def _is_identity(item):
+    """
+    Returns True if a given CFTypeRef is an identity.
+    """
+    expected = Security.SecIdentityGetTypeID()
+    return CoreFoundation.CFGetTypeID(item) == expected
+
+
+def _temporary_keychain():
+    """
+    This function creates a temporary Mac keychain that we can use to work with
+    credentials. This keychain uses a one-time password and a temporary file to
+    store the data. We expect to have one keychain per socket. The returned
+    SecKeychainRef must be freed by the caller, including calling
+    SecKeychainDelete.
+
+    Returns a tuple of the SecKeychainRef and the path to the temporary
+    directory that contains it.
+    """
+    # Unfortunately, SecKeychainCreate requires a path to a keychain. This
+    # means we cannot use mkstemp to use a generic temporary file. Instead,
+    # we're going to create a temporary directory and a filename to use there.
+    # This filename will be 8 random bytes expanded into base64. We also need
+    # some random bytes to password-protect the keychain we're creating, so we
+    # ask for 40 random bytes.
+    random_bytes = os.urandom(40)
+    filename = base64.b16encode(random_bytes[:8]).decode("utf-8")
+    password = base64.b16encode(random_bytes[8:])  # Must be valid UTF-8
+    tempdirectory = tempfile.mkdtemp()
+
+    keychain_path = os.path.join(tempdirectory, filename).encode("utf-8")
+
+    # We now want to create the keychain itself.
+    keychain = Security.SecKeychainRef()
+    status = Security.SecKeychainCreate(
+        keychain_path, len(password), password, False, None, ctypes.byref(keychain)
+    )
+    _assert_no_error(status)
+
+    # Having created the keychain, we want to pass it off to the caller.
+    return keychain, tempdirectory
+
+
+def _load_items_from_file(keychain, path):
+    """
+    Given a single file, loads all the trust objects from it into arrays and
+    the keychain.
+    Returns a tuple of lists: the first list is a list of identities, the
+    second a list of certs.
+    """
+    certificates = []
+    identities = []
+    result_array = None
+
+    with open(path, "rb") as f:
+        raw_filedata = f.read()
+
+    try:
+        filedata = CoreFoundation.CFDataCreate(
+            CoreFoundation.kCFAllocatorDefault, raw_filedata, len(raw_filedata)
+        )
+        result_array = CoreFoundation.CFArrayRef()
+        result = Security.SecItemImport(
+            filedata,  # cert data
+            None,  # Filename, leaving it out for now
+            None,  # What the type of the file is, we don't care
+            None,  # what's in the file, we don't care
+            0,  # import flags
+            None,  # key params, can include passphrase in the future
+            keychain,  # The keychain to insert into
+            ctypes.byref(result_array),  # Results
+        )
+        _assert_no_error(result)
+
+        # A CFArray is not very useful to us as an intermediary
+        # representation, so we are going to extract the objects we want
+        # and then free the array. We don't need to keep hold of keys: the
+        # keychain already has them!
+        result_count = CoreFoundation.CFArrayGetCount(result_array)
+        for index in range(result_count):
+            item = CoreFoundation.CFArrayGetValueAtIndex(result_array, index)
+            item = ctypes.cast(item, CoreFoundation.CFTypeRef)
+
+            if _is_cert(item):
+                CoreFoundation.CFRetain(item)
+                certificates.append(item)
+            elif _is_identity(item):
+                CoreFoundation.CFRetain(item)
+                identities.append(item)
+    finally:
+        if result_array:
+            CoreFoundation.CFRelease(result_array)
+
+        CoreFoundation.CFRelease(filedata)
+
+    return (identities, certificates)
+
+
+def _load_client_cert_chain(keychain, *paths):
+    """
+    Load certificates and maybe keys from a number of files. Has the end goal
+    of returning a CFArray containing one SecIdentityRef, and then zero or more
+    SecCertificateRef objects, suitable for use as a client certificate trust
+    chain.
+    """
+    # Ok, the strategy.
+    #
+    # This relies on knowing that macOS will not give you a SecIdentityRef
+    # unless you have imported a key into a keychain. This is a somewhat
+    # artificial limitation of macOS (for example, it doesn't necessarily
+    # affect iOS), but there is nothing inside Security.framework that lets you
+    # get a SecIdentityRef without having a key in a keychain.
+    #
+    # So the policy here is we take all the files and iterate them in order.
+    # Each one will use SecItemImport to have one or more objects loaded from
+    # it. We will also point at a keychain that macOS can use to work with the
+    # private key.
+    #
+    # Once we have all the objects, we'll check what we actually have. If we
+    # already have a SecIdentityRef in hand, fab: we'll use that. Otherwise,
+    # we'll take the first certificate (which we assume to be our leaf) and
+    # ask the keychain to give us a SecIdentityRef with that cert's associated
+    # key.
+    #
+    # We'll then return a CFArray containing the trust chain: one
+    # SecIdentityRef and then zero-or-more SecCertificateRef objects. The
+    # responsibility for freeing this CFArray will be with the caller. This
+    # CFArray must remain alive for the entire connection, so in practice it
+    # will be stored with a single SSLSocket, along with the reference to the
+    # keychain.
+    certificates = []
+    identities = []
+
+    # Filter out bad paths.
+    paths = (path for path in paths if path)
+
+    try:
+        for file_path in paths:
+            new_identities, new_certs = _load_items_from_file(keychain, file_path)
+            identities.extend(new_identities)
+            certificates.extend(new_certs)
+
+        # Ok, we have everything. The question is: do we have an identity? If
+        # not, we want to grab one from the first cert we have.
+        if not identities:
+            new_identity = Security.SecIdentityRef()
+            status = Security.SecIdentityCreateWithCertificate(
+                keychain, certificates[0], ctypes.byref(new_identity)
+            )
+            _assert_no_error(status)
+            identities.append(new_identity)
+
+            # We now want to release the original certificate, as we no longer
+            # need it.
+            CoreFoundation.CFRelease(certificates.pop(0))
+
+        # We now need to build a new CFArray that holds the trust chain.
+        trust_chain = CoreFoundation.CFArrayCreateMutable(
+            CoreFoundation.kCFAllocatorDefault,
+            0,
+            ctypes.byref(CoreFoundation.kCFTypeArrayCallBacks),
+        )
+        for item in itertools.chain(identities, certificates):
+            # ArrayAppendValue does a CFRetain on the item. That's fine,
+            # because the finally block will release our other refs to them.
+            CoreFoundation.CFArrayAppendValue(trust_chain, item)
+
+        return trust_chain
+    finally:
+        for obj in itertools.chain(identities, certificates):
+            CoreFoundation.CFRelease(obj)
+
+
+TLS_PROTOCOL_VERSIONS = {
+    "SSLv2": (0, 2),
+    "SSLv3": (3, 0),
+    "TLSv1": (3, 1),
+    "TLSv1.1": (3, 2),
+    "TLSv1.2": (3, 3),
+}
+
+
+def _build_tls_unknown_ca_alert(version):
+    """
+    Builds a TLS alert record for an unknown CA.
+    """
+    ver_maj, ver_min = TLS_PROTOCOL_VERSIONS[version]
+    severity_fatal = 0x02
+    description_unknown_ca = 0x30
+    msg = struct.pack(">BB", severity_fatal, description_unknown_ca)
+    msg_len = len(msg)
+    record_type_alert = 0x15
+    record = struct.pack(">BBBH", record_type_alert, ver_maj, ver_min, msg_len) + msg
+    return record
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/appengine.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/appengine.py
new file mode 100644
index 0000000..1717ee2
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/appengine.py
@@ -0,0 +1,314 @@
+"""
+This module provides a pool manager that uses Google App Engine's
+`URLFetch Service `_.
+
+Example usage::
+
+    from pip._vendor.urllib3 import PoolManager
+    from pip._vendor.urllib3.contrib.appengine import AppEngineManager, is_appengine_sandbox
+
+    if is_appengine_sandbox():
+        # AppEngineManager uses AppEngine's URLFetch API behind the scenes
+        http = AppEngineManager()
+    else:
+        # PoolManager uses a socket-level API behind the scenes
+        http = PoolManager()
+
+    r = http.request('GET', 'https://google.com/')
+
+There are `limitations `_ to the URLFetch service and it may not be
+the best choice for your application. There are three options for using
+urllib3 on Google App Engine:
+
+1. You can use :class:`AppEngineManager` with URLFetch. URLFetch is
+   cost-effective in many circumstances as long as your usage is within the
+   limitations.
+2. You can use a normal :class:`~urllib3.PoolManager` by enabling sockets.
+   Sockets also have `limitations and restrictions
+   `_ and have a lower free quota than URLFetch.
+   To use sockets, be sure to specify the following in your ``app.yaml``::
+
+        env_variables:
+            GAE_USE_SOCKETS_HTTPLIB : 'true'
+
+3. If you are using `App Engine Flexible
+`_, you can use the standard
+:class:`PoolManager` without any configuration or special environment variables.
+"""
+
+from __future__ import absolute_import
+
+import io
+import logging
+import warnings
+
+from ..exceptions import (
+    HTTPError,
+    HTTPWarning,
+    MaxRetryError,
+    ProtocolError,
+    SSLError,
+    TimeoutError,
+)
+from ..packages.six.moves.urllib.parse import urljoin
+from ..request import RequestMethods
+from ..response import HTTPResponse
+from ..util.retry import Retry
+from ..util.timeout import Timeout
+from . import _appengine_environ
+
+try:
+    from google.appengine.api import urlfetch
+except ImportError:
+    urlfetch = None
+
+
+log = logging.getLogger(__name__)
+
+
+class AppEnginePlatformWarning(HTTPWarning):
+    pass
+
+
+class AppEnginePlatformError(HTTPError):
+    pass
+
+
+class AppEngineManager(RequestMethods):
+    """
+    Connection manager for Google App Engine sandbox applications.
+
+    This manager uses the URLFetch service directly instead of using the
+    emulated httplib, and is subject to URLFetch limitations as described in
+    the App Engine documentation `here
+    `_.
+
+    Notably it will raise an :class:`AppEnginePlatformError` if:
+        * URLFetch is not available.
+        * If you attempt to use this on App Engine Flexible, as full socket
+          support is available.
+        * If a request size is more than 10 megabytes.
+        * If a response size is more than 32 megabytes.
+        * If you use an unsupported request method such as OPTIONS.
+
+    Beyond those cases, it will raise normal urllib3 errors.
+    """
+
+    def __init__(
+        self,
+        headers=None,
+        retries=None,
+        validate_certificate=True,
+        urlfetch_retries=True,
+    ):
+        if not urlfetch:
+            raise AppEnginePlatformError(
+                "URLFetch is not available in this environment."
+            )
+
+        warnings.warn(
+            "urllib3 is using URLFetch on Google App Engine sandbox instead "
+            "of sockets. To use sockets directly instead of URLFetch see "
+            "https://urllib3.readthedocs.io/en/1.26.x/reference/urllib3.contrib.html.",
+            AppEnginePlatformWarning,
+        )
+
+        RequestMethods.__init__(self, headers)
+        self.validate_certificate = validate_certificate
+        self.urlfetch_retries = urlfetch_retries
+
+        self.retries = retries or Retry.DEFAULT
+
+    def __enter__(self):
+        return self
+
+    def __exit__(self, exc_type, exc_val, exc_tb):
+        # Return False to re-raise any potential exceptions
+        return False
+
+    def urlopen(
+        self,
+        method,
+        url,
+        body=None,
+        headers=None,
+        retries=None,
+        redirect=True,
+        timeout=Timeout.DEFAULT_TIMEOUT,
+        **response_kw
+    ):
+
+        retries = self._get_retries(retries, redirect)
+
+        try:
+            follow_redirects = redirect and retries.redirect != 0 and retries.total
+            response = urlfetch.fetch(
+                url,
+                payload=body,
+                method=method,
+                headers=headers or {},
+                allow_truncated=False,
+                follow_redirects=self.urlfetch_retries and follow_redirects,
+                deadline=self._get_absolute_timeout(timeout),
+                validate_certificate=self.validate_certificate,
+            )
+        except urlfetch.DeadlineExceededError as e:
+            raise TimeoutError(self, e)
+
+        except urlfetch.InvalidURLError as e:
+            if "too large" in str(e):
+                raise AppEnginePlatformError(
+                    "URLFetch request too large, URLFetch only "
+                    "supports requests up to 10mb in size.",
+                    e,
+                )
+            raise ProtocolError(e)
+
+        except urlfetch.DownloadError as e:
+            if "Too many redirects" in str(e):
+                raise MaxRetryError(self, url, reason=e)
+            raise ProtocolError(e)
+
+        except urlfetch.ResponseTooLargeError as e:
+            raise AppEnginePlatformError(
+                "URLFetch response too large, URLFetch only supports"
+                "responses up to 32mb in size.",
+                e,
+            )
+
+        except urlfetch.SSLCertificateError as e:
+            raise SSLError(e)
+
+        except urlfetch.InvalidMethodError as e:
+            raise AppEnginePlatformError(
+                "URLFetch does not support method: %s" % method, e
+            )
+
+        http_response = self._urlfetch_response_to_http_response(
+            response, retries=retries, **response_kw
+        )
+
+        # Handle redirect?
+        redirect_location = redirect and http_response.get_redirect_location()
+        if redirect_location:
+            # Check for redirect response
+            if self.urlfetch_retries and retries.raise_on_redirect:
+                raise MaxRetryError(self, url, "too many redirects")
+            else:
+                if http_response.status == 303:
+                    method = "GET"
+
+                try:
+                    retries = retries.increment(
+                        method, url, response=http_response, _pool=self
+                    )
+                except MaxRetryError:
+                    if retries.raise_on_redirect:
+                        raise MaxRetryError(self, url, "too many redirects")
+                    return http_response
+
+                retries.sleep_for_retry(http_response)
+                log.debug("Redirecting %s -> %s", url, redirect_location)
+                redirect_url = urljoin(url, redirect_location)
+                return self.urlopen(
+                    method,
+                    redirect_url,
+                    body,
+                    headers,
+                    retries=retries,
+                    redirect=redirect,
+                    timeout=timeout,
+                    **response_kw
+                )
+
+        # Check if we should retry the HTTP response.
+        has_retry_after = bool(http_response.headers.get("Retry-After"))
+        if retries.is_retry(method, http_response.status, has_retry_after):
+            retries = retries.increment(method, url, response=http_response, _pool=self)
+            log.debug("Retry: %s", url)
+            retries.sleep(http_response)
+            return self.urlopen(
+                method,
+                url,
+                body=body,
+                headers=headers,
+                retries=retries,
+                redirect=redirect,
+                timeout=timeout,
+                **response_kw
+            )
+
+        return http_response
+
+    def _urlfetch_response_to_http_response(self, urlfetch_resp, **response_kw):
+
+        if is_prod_appengine():
+            # Production GAE handles deflate encoding automatically, but does
+            # not remove the encoding header.
+            content_encoding = urlfetch_resp.headers.get("content-encoding")
+
+            if content_encoding == "deflate":
+                del urlfetch_resp.headers["content-encoding"]
+
+        transfer_encoding = urlfetch_resp.headers.get("transfer-encoding")
+        # We have a full response's content,
+        # so let's make sure we don't report ourselves as chunked data.
+        if transfer_encoding == "chunked":
+            encodings = transfer_encoding.split(",")
+            encodings.remove("chunked")
+            urlfetch_resp.headers["transfer-encoding"] = ",".join(encodings)
+
+        original_response = HTTPResponse(
+            # In order for decoding to work, we must present the content as
+            # a file-like object.
+            body=io.BytesIO(urlfetch_resp.content),
+            msg=urlfetch_resp.header_msg,
+            headers=urlfetch_resp.headers,
+            status=urlfetch_resp.status_code,
+            **response_kw
+        )
+
+        return HTTPResponse(
+            body=io.BytesIO(urlfetch_resp.content),
+            headers=urlfetch_resp.headers,
+            status=urlfetch_resp.status_code,
+            original_response=original_response,
+            **response_kw
+        )
+
+    def _get_absolute_timeout(self, timeout):
+        if timeout is Timeout.DEFAULT_TIMEOUT:
+            return None  # Defer to URLFetch's default.
+        if isinstance(timeout, Timeout):
+            if timeout._read is not None or timeout._connect is not None:
+                warnings.warn(
+                    "URLFetch does not support granular timeout settings, "
+                    "reverting to total or default URLFetch timeout.",
+                    AppEnginePlatformWarning,
+                )
+            return timeout.total
+        return timeout
+
+    def _get_retries(self, retries, redirect):
+        if not isinstance(retries, Retry):
+            retries = Retry.from_int(retries, redirect=redirect, default=self.retries)
+
+        if retries.connect or retries.read or retries.redirect:
+            warnings.warn(
+                "URLFetch only supports total retries and does not "
+                "recognize connect, read, or redirect retry parameters.",
+                AppEnginePlatformWarning,
+            )
+
+        return retries
+
+
+# Alias methods from _appengine_environ to maintain public API interface.
+
+is_appengine = _appengine_environ.is_appengine
+is_appengine_sandbox = _appengine_environ.is_appengine_sandbox
+is_local_appengine = _appengine_environ.is_local_appengine
+is_prod_appengine = _appengine_environ.is_prod_appengine
+is_prod_appengine_mvms = _appengine_environ.is_prod_appengine_mvms
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/ntlmpool.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/ntlmpool.py
new file mode 100644
index 0000000..4716657
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/ntlmpool.py
@@ -0,0 +1,130 @@
+"""
+NTLM authenticating pool, contributed by erikcederstran
+
+Issue #10, see: http://code.google.com/p/urllib3/issues/detail?id=10
+"""
+from __future__ import absolute_import
+
+import warnings
+from logging import getLogger
+
+from ntlm import ntlm
+
+from .. import HTTPSConnectionPool
+from ..packages.six.moves.http_client import HTTPSConnection
+
+warnings.warn(
+    "The 'urllib3.contrib.ntlmpool' module is deprecated and will be removed "
+    "in urllib3 v2.0 release, urllib3 is not able to support it properly due "
+    "to reasons listed in issue: https://github.com/urllib3/urllib3/issues/2282. "
+    "If you are a user of this module please comment in the mentioned issue.",
+    DeprecationWarning,
+)
+
+log = getLogger(__name__)
+
+
+class NTLMConnectionPool(HTTPSConnectionPool):
+    """
+    Implements an NTLM authentication version of an urllib3 connection pool
+    """
+
+    scheme = "https"
+
+    def __init__(self, user, pw, authurl, *args, **kwargs):
+        """
+        authurl is a random URL on the server that is protected by NTLM.
+        user is the Windows user, probably in the DOMAIN\\username format.
+        pw is the password for the user.
+        """
+        super(NTLMConnectionPool, self).__init__(*args, **kwargs)
+        self.authurl = authurl
+        self.rawuser = user
+        user_parts = user.split("\\", 1)
+        self.domain = user_parts[0].upper()
+        self.user = user_parts[1]
+        self.pw = pw
+
+    def _new_conn(self):
+        # Performs the NTLM handshake that secures the connection. The socket
+        # must be kept open while requests are performed.
+        self.num_connections += 1
+        log.debug(
+            "Starting NTLM HTTPS connection no. %d: https://%s%s",
+            self.num_connections,
+            self.host,
+            self.authurl,
+        )
+
+        headers = {"Connection": "Keep-Alive"}
+        req_header = "Authorization"
+        resp_header = "www-authenticate"
+
+        conn = HTTPSConnection(host=self.host, port=self.port)
+
+        # Send negotiation message
+        headers[req_header] = "NTLM %s" % ntlm.create_NTLM_NEGOTIATE_MESSAGE(
+            self.rawuser
+        )
+        log.debug("Request headers: %s", headers)
+        conn.request("GET", self.authurl, None, headers)
+        res = conn.getresponse()
+        reshdr = dict(res.headers)
+        log.debug("Response status: %s %s", res.status, res.reason)
+        log.debug("Response headers: %s", reshdr)
+        log.debug("Response data: %s [...]", res.read(100))
+
+        # Remove the reference to the socket, so that it can not be closed by
+        # the response object (we want to keep the socket open)
+        res.fp = None
+
+        # Server should respond with a challenge message
+        auth_header_values = reshdr[resp_header].split(", ")
+        auth_header_value = None
+        for s in auth_header_values:
+            if s[:5] == "NTLM ":
+                auth_header_value = s[5:]
+        if auth_header_value is None:
+            raise Exception(
+                "Unexpected %s response header: %s" % (resp_header, reshdr[resp_header])
+            )
+
+        # Send authentication message
+        ServerChallenge, NegotiateFlags = ntlm.parse_NTLM_CHALLENGE_MESSAGE(
+            auth_header_value
+        )
+        auth_msg = ntlm.create_NTLM_AUTHENTICATE_MESSAGE(
+            ServerChallenge, self.user, self.domain, self.pw, NegotiateFlags
+        )
+        headers[req_header] = "NTLM %s" % auth_msg
+        log.debug("Request headers: %s", headers)
+        conn.request("GET", self.authurl, None, headers)
+        res = conn.getresponse()
+        log.debug("Response status: %s %s", res.status, res.reason)
+        log.debug("Response headers: %s", dict(res.headers))
+        log.debug("Response data: %s [...]", res.read()[:100])
+        if res.status != 200:
+            if res.status == 401:
+                raise Exception("Server rejected request: wrong username or password")
+            raise Exception("Wrong server response: %s %s" % (res.status, res.reason))
+
+        res.fp = None
+        log.debug("Connection established")
+        return conn
+
+    def urlopen(
+        self,
+        method,
+        url,
+        body=None,
+        headers=None,
+        retries=3,
+        redirect=True,
+        assert_same_host=True,
+    ):
+        if headers is None:
+            headers = {}
+        headers["Connection"] = "Keep-Alive"
+        return super(NTLMConnectionPool, self).urlopen(
+            method, url, body, headers, retries, redirect, assert_same_host
+        )
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/pyopenssl.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/pyopenssl.py
new file mode 100644
index 0000000..19e4aa9
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/pyopenssl.py
@@ -0,0 +1,518 @@
+"""
+TLS with SNI_-support for Python 2. Follow these instructions if you would
+like to verify TLS certificates in Python 2. Note, the default libraries do
+*not* do certificate checking; you need to do additional work to validate
+certificates yourself.
+
+This needs the following packages installed:
+
+* `pyOpenSSL`_ (tested with 16.0.0)
+* `cryptography`_ (minimum 1.3.4, from pyopenssl)
+* `idna`_ (minimum 2.0, from cryptography)
+
+However, pyopenssl depends on cryptography, which depends on idna, so while we
+use all three directly here we end up having relatively few packages required.
+
+You can install them with the following command:
+
+.. code-block:: bash
+
+    $ python -m pip install pyopenssl cryptography idna
+
+To activate certificate checking, call
+:func:`~urllib3.contrib.pyopenssl.inject_into_urllib3` from your Python code
+before you begin making HTTP requests. This can be done in a ``sitecustomize``
+module, or at any other time before your application begins using ``urllib3``,
+like this:
+
+.. code-block:: python
+
+    try:
+        import pip._vendor.urllib3.contrib.pyopenssl as pyopenssl
+        pyopenssl.inject_into_urllib3()
+    except ImportError:
+        pass
+
+Now you can use :mod:`urllib3` as you normally would, and it will support SNI
+when the required modules are installed.
+
+Activating this module also has the positive side effect of disabling SSL/TLS
+compression in Python 2 (see `CRIME attack`_).
+
+.. _sni: https://en.wikipedia.org/wiki/Server_Name_Indication
+.. _crime attack: https://en.wikipedia.org/wiki/CRIME_(security_exploit)
+.. _pyopenssl: https://www.pyopenssl.org
+.. _cryptography: https://cryptography.io
+.. _idna: https://github.com/kjd/idna
+"""
+from __future__ import absolute_import
+
+import OpenSSL.crypto
+import OpenSSL.SSL
+from cryptography import x509
+from cryptography.hazmat.backends.openssl import backend as openssl_backend
+
+try:
+    from cryptography.x509 import UnsupportedExtension
+except ImportError:
+    # UnsupportedExtension is gone in cryptography >= 2.1.0
+    class UnsupportedExtension(Exception):
+        pass
+
+
+from io import BytesIO
+from socket import error as SocketError
+from socket import timeout
+
+try:  # Platform-specific: Python 2
+    from socket import _fileobject
+except ImportError:  # Platform-specific: Python 3
+    _fileobject = None
+    from ..packages.backports.makefile import backport_makefile
+
+import logging
+import ssl
+import sys
+import warnings
+
+from .. import util
+from ..packages import six
+from ..util.ssl_ import PROTOCOL_TLS_CLIENT
+
+warnings.warn(
+    "'urllib3.contrib.pyopenssl' module is deprecated and will be removed "
+    "in a future release of urllib3 2.x. Read more in this issue: "
+    "https://github.com/urllib3/urllib3/issues/2680",
+    category=DeprecationWarning,
+    stacklevel=2,
+)
+
+__all__ = ["inject_into_urllib3", "extract_from_urllib3"]
+
+# SNI always works.
+HAS_SNI = True
+
+# Map from urllib3 to PyOpenSSL compatible parameter-values.
+_openssl_versions = {
+    util.PROTOCOL_TLS: OpenSSL.SSL.SSLv23_METHOD,
+    PROTOCOL_TLS_CLIENT: OpenSSL.SSL.SSLv23_METHOD,
+    ssl.PROTOCOL_TLSv1: OpenSSL.SSL.TLSv1_METHOD,
+}
+
+if hasattr(ssl, "PROTOCOL_SSLv3") and hasattr(OpenSSL.SSL, "SSLv3_METHOD"):
+    _openssl_versions[ssl.PROTOCOL_SSLv3] = OpenSSL.SSL.SSLv3_METHOD
+
+if hasattr(ssl, "PROTOCOL_TLSv1_1") and hasattr(OpenSSL.SSL, "TLSv1_1_METHOD"):
+    _openssl_versions[ssl.PROTOCOL_TLSv1_1] = OpenSSL.SSL.TLSv1_1_METHOD
+
+if hasattr(ssl, "PROTOCOL_TLSv1_2") and hasattr(OpenSSL.SSL, "TLSv1_2_METHOD"):
+    _openssl_versions[ssl.PROTOCOL_TLSv1_2] = OpenSSL.SSL.TLSv1_2_METHOD
+
+
+_stdlib_to_openssl_verify = {
+    ssl.CERT_NONE: OpenSSL.SSL.VERIFY_NONE,
+    ssl.CERT_OPTIONAL: OpenSSL.SSL.VERIFY_PEER,
+    ssl.CERT_REQUIRED: OpenSSL.SSL.VERIFY_PEER
+    + OpenSSL.SSL.VERIFY_FAIL_IF_NO_PEER_CERT,
+}
+_openssl_to_stdlib_verify = dict((v, k) for k, v in _stdlib_to_openssl_verify.items())
+
+# OpenSSL will only write 16K at a time
+SSL_WRITE_BLOCKSIZE = 16384
+
+orig_util_HAS_SNI = util.HAS_SNI
+orig_util_SSLContext = util.ssl_.SSLContext
+
+
+log = logging.getLogger(__name__)
+
+
+def inject_into_urllib3():
+    "Monkey-patch urllib3 with PyOpenSSL-backed SSL-support."
+
+    _validate_dependencies_met()
+
+    util.SSLContext = PyOpenSSLContext
+    util.ssl_.SSLContext = PyOpenSSLContext
+    util.HAS_SNI = HAS_SNI
+    util.ssl_.HAS_SNI = HAS_SNI
+    util.IS_PYOPENSSL = True
+    util.ssl_.IS_PYOPENSSL = True
+
+
+def extract_from_urllib3():
+    "Undo monkey-patching by :func:`inject_into_urllib3`."
+
+    util.SSLContext = orig_util_SSLContext
+    util.ssl_.SSLContext = orig_util_SSLContext
+    util.HAS_SNI = orig_util_HAS_SNI
+    util.ssl_.HAS_SNI = orig_util_HAS_SNI
+    util.IS_PYOPENSSL = False
+    util.ssl_.IS_PYOPENSSL = False
+
+
+def _validate_dependencies_met():
+    """
+    Verifies that PyOpenSSL's package-level dependencies have been met.
+    Throws `ImportError` if they are not met.
+    """
+    # Method added in `cryptography==1.1`; not available in older versions
+    from cryptography.x509.extensions import Extensions
+
+    if getattr(Extensions, "get_extension_for_class", None) is None:
+        raise ImportError(
+            "'cryptography' module missing required functionality.  "
+            "Try upgrading to v1.3.4 or newer."
+        )
+
+    # pyOpenSSL 0.14 and above use cryptography for OpenSSL bindings. The _x509
+    # attribute is only present on those versions.
+    from OpenSSL.crypto import X509
+
+    x509 = X509()
+    if getattr(x509, "_x509", None) is None:
+        raise ImportError(
+            "'pyOpenSSL' module missing required functionality. "
+            "Try upgrading to v0.14 or newer."
+        )
+
+
+def _dnsname_to_stdlib(name):
+    """
+    Converts a dNSName SubjectAlternativeName field to the form used by the
+    standard library on the given Python version.
+
+    Cryptography produces a dNSName as a unicode string that was idna-decoded
+    from ASCII bytes. We need to idna-encode that string to get it back, and
+    then on Python 3 we also need to convert to unicode via UTF-8 (the stdlib
+    uses PyUnicode_FromStringAndSize on it, which decodes via UTF-8).
+
+    If the name cannot be idna-encoded then we return None signalling that
+    the name given should be skipped.
+    """
+
+    def idna_encode(name):
+        """
+        Borrowed wholesale from the Python Cryptography Project. It turns out
+        that we can't just safely call `idna.encode`: it can explode for
+        wildcard names. This avoids that problem.
+        """
+        from pip._vendor import idna
+
+        try:
+            for prefix in [u"*.", u"."]:
+                if name.startswith(prefix):
+                    name = name[len(prefix) :]
+                    return prefix.encode("ascii") + idna.encode(name)
+            return idna.encode(name)
+        except idna.core.IDNAError:
+            return None
+
+    # Don't send IPv6 addresses through the IDNA encoder.
+    if ":" in name:
+        return name
+
+    name = idna_encode(name)
+    if name is None:
+        return None
+    elif sys.version_info >= (3, 0):
+        name = name.decode("utf-8")
+    return name
+
+
+def get_subj_alt_name(peer_cert):
+    """
+    Given an PyOpenSSL certificate, provides all the subject alternative names.
+    """
+    # Pass the cert to cryptography, which has much better APIs for this.
+    if hasattr(peer_cert, "to_cryptography"):
+        cert = peer_cert.to_cryptography()
+    else:
+        der = OpenSSL.crypto.dump_certificate(OpenSSL.crypto.FILETYPE_ASN1, peer_cert)
+        cert = x509.load_der_x509_certificate(der, openssl_backend)
+
+    # We want to find the SAN extension. Ask Cryptography to locate it (it's
+    # faster than looping in Python)
+    try:
+        ext = cert.extensions.get_extension_for_class(x509.SubjectAlternativeName).value
+    except x509.ExtensionNotFound:
+        # No such extension, return the empty list.
+        return []
+    except (
+        x509.DuplicateExtension,
+        UnsupportedExtension,
+        x509.UnsupportedGeneralNameType,
+        UnicodeError,
+    ) as e:
+        # A problem has been found with the quality of the certificate. Assume
+        # no SAN field is present.
+        log.warning(
+            "A problem was encountered with the certificate that prevented "
+            "urllib3 from finding the SubjectAlternativeName field. This can "
+            "affect certificate validation. The error was %s",
+            e,
+        )
+        return []
+
+    # We want to return dNSName and iPAddress fields. We need to cast the IPs
+    # back to strings because the match_hostname function wants them as
+    # strings.
+    # Sadly the DNS names need to be idna encoded and then, on Python 3, UTF-8
+    # decoded. This is pretty frustrating, but that's what the standard library
+    # does with certificates, and so we need to attempt to do the same.
+    # We also want to skip over names which cannot be idna encoded.
+    names = [
+        ("DNS", name)
+        for name in map(_dnsname_to_stdlib, ext.get_values_for_type(x509.DNSName))
+        if name is not None
+    ]
+    names.extend(
+        ("IP Address", str(name)) for name in ext.get_values_for_type(x509.IPAddress)
+    )
+
+    return names
+
+
+class WrappedSocket(object):
+    """API-compatibility wrapper for Python OpenSSL's Connection-class.
+
+    Note: _makefile_refs, _drop() and _reuse() are needed for the garbage
+    collector of pypy.
+    """
+
+    def __init__(self, connection, socket, suppress_ragged_eofs=True):
+        self.connection = connection
+        self.socket = socket
+        self.suppress_ragged_eofs = suppress_ragged_eofs
+        self._makefile_refs = 0
+        self._closed = False
+
+    def fileno(self):
+        return self.socket.fileno()
+
+    # Copy-pasted from Python 3.5 source code
+    def _decref_socketios(self):
+        if self._makefile_refs > 0:
+            self._makefile_refs -= 1
+        if self._closed:
+            self.close()
+
+    def recv(self, *args, **kwargs):
+        try:
+            data = self.connection.recv(*args, **kwargs)
+        except OpenSSL.SSL.SysCallError as e:
+            if self.suppress_ragged_eofs and e.args == (-1, "Unexpected EOF"):
+                return b""
+            else:
+                raise SocketError(str(e))
+        except OpenSSL.SSL.ZeroReturnError:
+            if self.connection.get_shutdown() == OpenSSL.SSL.RECEIVED_SHUTDOWN:
+                return b""
+            else:
+                raise
+        except OpenSSL.SSL.WantReadError:
+            if not util.wait_for_read(self.socket, self.socket.gettimeout()):
+                raise timeout("The read operation timed out")
+            else:
+                return self.recv(*args, **kwargs)
+
+        # TLS 1.3 post-handshake authentication
+        except OpenSSL.SSL.Error as e:
+            raise ssl.SSLError("read error: %r" % e)
+        else:
+            return data
+
+    def recv_into(self, *args, **kwargs):
+        try:
+            return self.connection.recv_into(*args, **kwargs)
+        except OpenSSL.SSL.SysCallError as e:
+            if self.suppress_ragged_eofs and e.args == (-1, "Unexpected EOF"):
+                return 0
+            else:
+                raise SocketError(str(e))
+        except OpenSSL.SSL.ZeroReturnError:
+            if self.connection.get_shutdown() == OpenSSL.SSL.RECEIVED_SHUTDOWN:
+                return 0
+            else:
+                raise
+        except OpenSSL.SSL.WantReadError:
+            if not util.wait_for_read(self.socket, self.socket.gettimeout()):
+                raise timeout("The read operation timed out")
+            else:
+                return self.recv_into(*args, **kwargs)
+
+        # TLS 1.3 post-handshake authentication
+        except OpenSSL.SSL.Error as e:
+            raise ssl.SSLError("read error: %r" % e)
+
+    def settimeout(self, timeout):
+        return self.socket.settimeout(timeout)
+
+    def _send_until_done(self, data):
+        while True:
+            try:
+                return self.connection.send(data)
+            except OpenSSL.SSL.WantWriteError:
+                if not util.wait_for_write(self.socket, self.socket.gettimeout()):
+                    raise timeout()
+                continue
+            except OpenSSL.SSL.SysCallError as e:
+                raise SocketError(str(e))
+
+    def sendall(self, data):
+        total_sent = 0
+        while total_sent < len(data):
+            sent = self._send_until_done(
+                data[total_sent : total_sent + SSL_WRITE_BLOCKSIZE]
+            )
+            total_sent += sent
+
+    def shutdown(self):
+        # FIXME rethrow compatible exceptions should we ever use this
+        self.connection.shutdown()
+
+    def close(self):
+        if self._makefile_refs < 1:
+            try:
+                self._closed = True
+                return self.connection.close()
+            except OpenSSL.SSL.Error:
+                return
+        else:
+            self._makefile_refs -= 1
+
+    def getpeercert(self, binary_form=False):
+        x509 = self.connection.get_peer_certificate()
+
+        if not x509:
+            return x509
+
+        if binary_form:
+            return OpenSSL.crypto.dump_certificate(OpenSSL.crypto.FILETYPE_ASN1, x509)
+
+        return {
+            "subject": ((("commonName", x509.get_subject().CN),),),
+            "subjectAltName": get_subj_alt_name(x509),
+        }
+
+    def version(self):
+        return self.connection.get_protocol_version_name()
+
+    def _reuse(self):
+        self._makefile_refs += 1
+
+    def _drop(self):
+        if self._makefile_refs < 1:
+            self.close()
+        else:
+            self._makefile_refs -= 1
+
+
+if _fileobject:  # Platform-specific: Python 2
+
+    def makefile(self, mode, bufsize=-1):
+        self._makefile_refs += 1
+        return _fileobject(self, mode, bufsize, close=True)
+
+else:  # Platform-specific: Python 3
+    makefile = backport_makefile
+
+WrappedSocket.makefile = makefile
+
+
+class PyOpenSSLContext(object):
+    """
+    I am a wrapper class for the PyOpenSSL ``Context`` object. I am responsible
+    for translating the interface of the standard library ``SSLContext`` object
+    to calls into PyOpenSSL.
+    """
+
+    def __init__(self, protocol):
+        self.protocol = _openssl_versions[protocol]
+        self._ctx = OpenSSL.SSL.Context(self.protocol)
+        self._options = 0
+        self.check_hostname = False
+
+    @property
+    def options(self):
+        return self._options
+
+    @options.setter
+    def options(self, value):
+        self._options = value
+        self._ctx.set_options(value)
+
+    @property
+    def verify_mode(self):
+        return _openssl_to_stdlib_verify[self._ctx.get_verify_mode()]
+
+    @verify_mode.setter
+    def verify_mode(self, value):
+        self._ctx.set_verify(_stdlib_to_openssl_verify[value], _verify_callback)
+
+    def set_default_verify_paths(self):
+        self._ctx.set_default_verify_paths()
+
+    def set_ciphers(self, ciphers):
+        if isinstance(ciphers, six.text_type):
+            ciphers = ciphers.encode("utf-8")
+        self._ctx.set_cipher_list(ciphers)
+
+    def load_verify_locations(self, cafile=None, capath=None, cadata=None):
+        if cafile is not None:
+            cafile = cafile.encode("utf-8")
+        if capath is not None:
+            capath = capath.encode("utf-8")
+        try:
+            self._ctx.load_verify_locations(cafile, capath)
+            if cadata is not None:
+                self._ctx.load_verify_locations(BytesIO(cadata))
+        except OpenSSL.SSL.Error as e:
+            raise ssl.SSLError("unable to load trusted certificates: %r" % e)
+
+    def load_cert_chain(self, certfile, keyfile=None, password=None):
+        self._ctx.use_certificate_chain_file(certfile)
+        if password is not None:
+            if not isinstance(password, six.binary_type):
+                password = password.encode("utf-8")
+            self._ctx.set_passwd_cb(lambda *_: password)
+        self._ctx.use_privatekey_file(keyfile or certfile)
+
+    def set_alpn_protocols(self, protocols):
+        protocols = [six.ensure_binary(p) for p in protocols]
+        return self._ctx.set_alpn_protos(protocols)
+
+    def wrap_socket(
+        self,
+        sock,
+        server_side=False,
+        do_handshake_on_connect=True,
+        suppress_ragged_eofs=True,
+        server_hostname=None,
+    ):
+        cnx = OpenSSL.SSL.Connection(self._ctx, sock)
+
+        if isinstance(server_hostname, six.text_type):  # Platform-specific: Python 3
+            server_hostname = server_hostname.encode("utf-8")
+
+        if server_hostname is not None:
+            cnx.set_tlsext_host_name(server_hostname)
+
+        cnx.set_connect_state()
+
+        while True:
+            try:
+                cnx.do_handshake()
+            except OpenSSL.SSL.WantReadError:
+                if not util.wait_for_read(sock, sock.gettimeout()):
+                    raise timeout("select timed out")
+                continue
+            except OpenSSL.SSL.Error as e:
+                raise ssl.SSLError("bad handshake: %r" % e)
+            break
+
+        return WrappedSocket(cnx, sock)
+
+
+def _verify_callback(cnx, x509, err_no, err_depth, return_code):
+    return err_no == 0
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/securetransport.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/securetransport.py
new file mode 100644
index 0000000..722ee4e
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/securetransport.py
@@ -0,0 +1,920 @@
+"""
+SecureTranport support for urllib3 via ctypes.
+
+This makes platform-native TLS available to urllib3 users on macOS without the
+use of a compiler. This is an important feature because the Python Package
+Index is moving to become a TLSv1.2-or-higher server, and the default OpenSSL
+that ships with macOS is not capable of doing TLSv1.2. The only way to resolve
+this is to give macOS users an alternative solution to the problem, and that
+solution is to use SecureTransport.
+
+We use ctypes here because this solution must not require a compiler. That's
+because pip is not allowed to require a compiler either.
+
+This is not intended to be a seriously long-term solution to this problem.
+The hope is that PEP 543 will eventually solve this issue for us, at which
+point we can retire this contrib module. But in the short term, we need to
+solve the impending tire fire that is Python on Mac without this kind of
+contrib module. So...here we are.
+
+To use this module, simply import and inject it::
+
+    import pip._vendor.urllib3.contrib.securetransport as securetransport
+    securetransport.inject_into_urllib3()
+
+Happy TLSing!
+
+This code is a bastardised version of the code found in Will Bond's oscrypto
+library. An enormous debt is owed to him for blazing this trail for us. For
+that reason, this code should be considered to be covered both by urllib3's
+license and by oscrypto's:
+
+.. code-block::
+
+    Copyright (c) 2015-2016 Will Bond 
+
+    Permission is hereby granted, free of charge, to any person obtaining a
+    copy of this software and associated documentation files (the "Software"),
+    to deal in the Software without restriction, including without limitation
+    the rights to use, copy, modify, merge, publish, distribute, sublicense,
+    and/or sell copies of the Software, and to permit persons to whom the
+    Software is furnished to do so, subject to the following conditions:
+
+    The above copyright notice and this permission notice shall be included in
+    all copies or substantial portions of the Software.
+
+    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+    IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+    FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+    AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+    LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+    FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
+    DEALINGS IN THE SOFTWARE.
+"""
+from __future__ import absolute_import
+
+import contextlib
+import ctypes
+import errno
+import os.path
+import shutil
+import socket
+import ssl
+import struct
+import threading
+import weakref
+
+from .. import util
+from ..packages import six
+from ..util.ssl_ import PROTOCOL_TLS_CLIENT
+from ._securetransport.bindings import CoreFoundation, Security, SecurityConst
+from ._securetransport.low_level import (
+    _assert_no_error,
+    _build_tls_unknown_ca_alert,
+    _cert_array_from_pem,
+    _create_cfstring_array,
+    _load_client_cert_chain,
+    _temporary_keychain,
+)
+
+try:  # Platform-specific: Python 2
+    from socket import _fileobject
+except ImportError:  # Platform-specific: Python 3
+    _fileobject = None
+    from ..packages.backports.makefile import backport_makefile
+
+__all__ = ["inject_into_urllib3", "extract_from_urllib3"]
+
+# SNI always works
+HAS_SNI = True
+
+orig_util_HAS_SNI = util.HAS_SNI
+orig_util_SSLContext = util.ssl_.SSLContext
+
+# This dictionary is used by the read callback to obtain a handle to the
+# calling wrapped socket. This is a pretty silly approach, but for now it'll
+# do. I feel like I should be able to smuggle a handle to the wrapped socket
+# directly in the SSLConnectionRef, but for now this approach will work I
+# guess.
+#
+# We need to lock around this structure for inserts, but we don't do it for
+# reads/writes in the callbacks. The reasoning here goes as follows:
+#
+#    1. It is not possible to call into the callbacks before the dictionary is
+#       populated, so once in the callback the id must be in the dictionary.
+#    2. The callbacks don't mutate the dictionary, they only read from it, and
+#       so cannot conflict with any of the insertions.
+#
+# This is good: if we had to lock in the callbacks we'd drastically slow down
+# the performance of this code.
+_connection_refs = weakref.WeakValueDictionary()
+_connection_ref_lock = threading.Lock()
+
+# Limit writes to 16kB. This is OpenSSL's limit, but we'll cargo-cult it over
+# for no better reason than we need *a* limit, and this one is right there.
+SSL_WRITE_BLOCKSIZE = 16384
+
+# This is our equivalent of util.ssl_.DEFAULT_CIPHERS, but expanded out to
+# individual cipher suites. We need to do this because this is how
+# SecureTransport wants them.
+CIPHER_SUITES = [
+    SecurityConst.TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384,
+    SecurityConst.TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256,
+    SecurityConst.TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384,
+    SecurityConst.TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256,
+    SecurityConst.TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305_SHA256,
+    SecurityConst.TLS_ECDHE_RSA_WITH_CHACHA20_POLY1305_SHA256,
+    SecurityConst.TLS_DHE_RSA_WITH_AES_256_GCM_SHA384,
+    SecurityConst.TLS_DHE_RSA_WITH_AES_128_GCM_SHA256,
+    SecurityConst.TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384,
+    SecurityConst.TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA,
+    SecurityConst.TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256,
+    SecurityConst.TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA,
+    SecurityConst.TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384,
+    SecurityConst.TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA,
+    SecurityConst.TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256,
+    SecurityConst.TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA,
+    SecurityConst.TLS_DHE_RSA_WITH_AES_256_CBC_SHA256,
+    SecurityConst.TLS_DHE_RSA_WITH_AES_256_CBC_SHA,
+    SecurityConst.TLS_DHE_RSA_WITH_AES_128_CBC_SHA256,
+    SecurityConst.TLS_DHE_RSA_WITH_AES_128_CBC_SHA,
+    SecurityConst.TLS_AES_256_GCM_SHA384,
+    SecurityConst.TLS_AES_128_GCM_SHA256,
+    SecurityConst.TLS_RSA_WITH_AES_256_GCM_SHA384,
+    SecurityConst.TLS_RSA_WITH_AES_128_GCM_SHA256,
+    SecurityConst.TLS_AES_128_CCM_8_SHA256,
+    SecurityConst.TLS_AES_128_CCM_SHA256,
+    SecurityConst.TLS_RSA_WITH_AES_256_CBC_SHA256,
+    SecurityConst.TLS_RSA_WITH_AES_128_CBC_SHA256,
+    SecurityConst.TLS_RSA_WITH_AES_256_CBC_SHA,
+    SecurityConst.TLS_RSA_WITH_AES_128_CBC_SHA,
+]
+
+# Basically this is simple: for PROTOCOL_SSLv23 we turn it into a low of
+# TLSv1 and a high of TLSv1.2. For everything else, we pin to that version.
+# TLSv1 to 1.2 are supported on macOS 10.8+
+_protocol_to_min_max = {
+    util.PROTOCOL_TLS: (SecurityConst.kTLSProtocol1, SecurityConst.kTLSProtocol12),
+    PROTOCOL_TLS_CLIENT: (SecurityConst.kTLSProtocol1, SecurityConst.kTLSProtocol12),
+}
+
+if hasattr(ssl, "PROTOCOL_SSLv2"):
+    _protocol_to_min_max[ssl.PROTOCOL_SSLv2] = (
+        SecurityConst.kSSLProtocol2,
+        SecurityConst.kSSLProtocol2,
+    )
+if hasattr(ssl, "PROTOCOL_SSLv3"):
+    _protocol_to_min_max[ssl.PROTOCOL_SSLv3] = (
+        SecurityConst.kSSLProtocol3,
+        SecurityConst.kSSLProtocol3,
+    )
+if hasattr(ssl, "PROTOCOL_TLSv1"):
+    _protocol_to_min_max[ssl.PROTOCOL_TLSv1] = (
+        SecurityConst.kTLSProtocol1,
+        SecurityConst.kTLSProtocol1,
+    )
+if hasattr(ssl, "PROTOCOL_TLSv1_1"):
+    _protocol_to_min_max[ssl.PROTOCOL_TLSv1_1] = (
+        SecurityConst.kTLSProtocol11,
+        SecurityConst.kTLSProtocol11,
+    )
+if hasattr(ssl, "PROTOCOL_TLSv1_2"):
+    _protocol_to_min_max[ssl.PROTOCOL_TLSv1_2] = (
+        SecurityConst.kTLSProtocol12,
+        SecurityConst.kTLSProtocol12,
+    )
+
+
+def inject_into_urllib3():
+    """
+    Monkey-patch urllib3 with SecureTransport-backed SSL-support.
+    """
+    util.SSLContext = SecureTransportContext
+    util.ssl_.SSLContext = SecureTransportContext
+    util.HAS_SNI = HAS_SNI
+    util.ssl_.HAS_SNI = HAS_SNI
+    util.IS_SECURETRANSPORT = True
+    util.ssl_.IS_SECURETRANSPORT = True
+
+
+def extract_from_urllib3():
+    """
+    Undo monkey-patching by :func:`inject_into_urllib3`.
+    """
+    util.SSLContext = orig_util_SSLContext
+    util.ssl_.SSLContext = orig_util_SSLContext
+    util.HAS_SNI = orig_util_HAS_SNI
+    util.ssl_.HAS_SNI = orig_util_HAS_SNI
+    util.IS_SECURETRANSPORT = False
+    util.ssl_.IS_SECURETRANSPORT = False
+
+
+def _read_callback(connection_id, data_buffer, data_length_pointer):
+    """
+    SecureTransport read callback. This is called by ST to request that data
+    be returned from the socket.
+    """
+    wrapped_socket = None
+    try:
+        wrapped_socket = _connection_refs.get(connection_id)
+        if wrapped_socket is None:
+            return SecurityConst.errSSLInternal
+        base_socket = wrapped_socket.socket
+
+        requested_length = data_length_pointer[0]
+
+        timeout = wrapped_socket.gettimeout()
+        error = None
+        read_count = 0
+
+        try:
+            while read_count < requested_length:
+                if timeout is None or timeout >= 0:
+                    if not util.wait_for_read(base_socket, timeout):
+                        raise socket.error(errno.EAGAIN, "timed out")
+
+                remaining = requested_length - read_count
+                buffer = (ctypes.c_char * remaining).from_address(
+                    data_buffer + read_count
+                )
+                chunk_size = base_socket.recv_into(buffer, remaining)
+                read_count += chunk_size
+                if not chunk_size:
+                    if not read_count:
+                        return SecurityConst.errSSLClosedGraceful
+                    break
+        except (socket.error) as e:
+            error = e.errno
+
+            if error is not None and error != errno.EAGAIN:
+                data_length_pointer[0] = read_count
+                if error == errno.ECONNRESET or error == errno.EPIPE:
+                    return SecurityConst.errSSLClosedAbort
+                raise
+
+        data_length_pointer[0] = read_count
+
+        if read_count != requested_length:
+            return SecurityConst.errSSLWouldBlock
+
+        return 0
+    except Exception as e:
+        if wrapped_socket is not None:
+            wrapped_socket._exception = e
+        return SecurityConst.errSSLInternal
+
+
+def _write_callback(connection_id, data_buffer, data_length_pointer):
+    """
+    SecureTransport write callback. This is called by ST to request that data
+    actually be sent on the network.
+    """
+    wrapped_socket = None
+    try:
+        wrapped_socket = _connection_refs.get(connection_id)
+        if wrapped_socket is None:
+            return SecurityConst.errSSLInternal
+        base_socket = wrapped_socket.socket
+
+        bytes_to_write = data_length_pointer[0]
+        data = ctypes.string_at(data_buffer, bytes_to_write)
+
+        timeout = wrapped_socket.gettimeout()
+        error = None
+        sent = 0
+
+        try:
+            while sent < bytes_to_write:
+                if timeout is None or timeout >= 0:
+                    if not util.wait_for_write(base_socket, timeout):
+                        raise socket.error(errno.EAGAIN, "timed out")
+                chunk_sent = base_socket.send(data)
+                sent += chunk_sent
+
+                # This has some needless copying here, but I'm not sure there's
+                # much value in optimising this data path.
+                data = data[chunk_sent:]
+        except (socket.error) as e:
+            error = e.errno
+
+            if error is not None and error != errno.EAGAIN:
+                data_length_pointer[0] = sent
+                if error == errno.ECONNRESET or error == errno.EPIPE:
+                    return SecurityConst.errSSLClosedAbort
+                raise
+
+        data_length_pointer[0] = sent
+
+        if sent != bytes_to_write:
+            return SecurityConst.errSSLWouldBlock
+
+        return 0
+    except Exception as e:
+        if wrapped_socket is not None:
+            wrapped_socket._exception = e
+        return SecurityConst.errSSLInternal
+
+
+# We need to keep these two objects references alive: if they get GC'd while
+# in use then SecureTransport could attempt to call a function that is in freed
+# memory. That would be...uh...bad. Yeah, that's the word. Bad.
+_read_callback_pointer = Security.SSLReadFunc(_read_callback)
+_write_callback_pointer = Security.SSLWriteFunc(_write_callback)
+
+
+class WrappedSocket(object):
+    """
+    API-compatibility wrapper for Python's OpenSSL wrapped socket object.
+
+    Note: _makefile_refs, _drop(), and _reuse() are needed for the garbage
+    collector of PyPy.
+    """
+
+    def __init__(self, socket):
+        self.socket = socket
+        self.context = None
+        self._makefile_refs = 0
+        self._closed = False
+        self._exception = None
+        self._keychain = None
+        self._keychain_dir = None
+        self._client_cert_chain = None
+
+        # We save off the previously-configured timeout and then set it to
+        # zero. This is done because we use select and friends to handle the
+        # timeouts, but if we leave the timeout set on the lower socket then
+        # Python will "kindly" call select on that socket again for us. Avoid
+        # that by forcing the timeout to zero.
+        self._timeout = self.socket.gettimeout()
+        self.socket.settimeout(0)
+
+    @contextlib.contextmanager
+    def _raise_on_error(self):
+        """
+        A context manager that can be used to wrap calls that do I/O from
+        SecureTransport. If any of the I/O callbacks hit an exception, this
+        context manager will correctly propagate the exception after the fact.
+        This avoids silently swallowing those exceptions.
+
+        It also correctly forces the socket closed.
+        """
+        self._exception = None
+
+        # We explicitly don't catch around this yield because in the unlikely
+        # event that an exception was hit in the block we don't want to swallow
+        # it.
+        yield
+        if self._exception is not None:
+            exception, self._exception = self._exception, None
+            self.close()
+            raise exception
+
+    def _set_ciphers(self):
+        """
+        Sets up the allowed ciphers. By default this matches the set in
+        util.ssl_.DEFAULT_CIPHERS, at least as supported by macOS. This is done
+        custom and doesn't allow changing at this time, mostly because parsing
+        OpenSSL cipher strings is going to be a freaking nightmare.
+        """
+        ciphers = (Security.SSLCipherSuite * len(CIPHER_SUITES))(*CIPHER_SUITES)
+        result = Security.SSLSetEnabledCiphers(
+            self.context, ciphers, len(CIPHER_SUITES)
+        )
+        _assert_no_error(result)
+
+    def _set_alpn_protocols(self, protocols):
+        """
+        Sets up the ALPN protocols on the context.
+        """
+        if not protocols:
+            return
+        protocols_arr = _create_cfstring_array(protocols)
+        try:
+            result = Security.SSLSetALPNProtocols(self.context, protocols_arr)
+            _assert_no_error(result)
+        finally:
+            CoreFoundation.CFRelease(protocols_arr)
+
+    def _custom_validate(self, verify, trust_bundle):
+        """
+        Called when we have set custom validation. We do this in two cases:
+        first, when cert validation is entirely disabled; and second, when
+        using a custom trust DB.
+        Raises an SSLError if the connection is not trusted.
+        """
+        # If we disabled cert validation, just say: cool.
+        if not verify:
+            return
+
+        successes = (
+            SecurityConst.kSecTrustResultUnspecified,
+            SecurityConst.kSecTrustResultProceed,
+        )
+        try:
+            trust_result = self._evaluate_trust(trust_bundle)
+            if trust_result in successes:
+                return
+            reason = "error code: %d" % (trust_result,)
+        except Exception as e:
+            # Do not trust on error
+            reason = "exception: %r" % (e,)
+
+        # SecureTransport does not send an alert nor shuts down the connection.
+        rec = _build_tls_unknown_ca_alert(self.version())
+        self.socket.sendall(rec)
+        # close the connection immediately
+        # l_onoff = 1, activate linger
+        # l_linger = 0, linger for 0 seoncds
+        opts = struct.pack("ii", 1, 0)
+        self.socket.setsockopt(socket.SOL_SOCKET, socket.SO_LINGER, opts)
+        self.close()
+        raise ssl.SSLError("certificate verify failed, %s" % reason)
+
+    def _evaluate_trust(self, trust_bundle):
+        # We want data in memory, so load it up.
+        if os.path.isfile(trust_bundle):
+            with open(trust_bundle, "rb") as f:
+                trust_bundle = f.read()
+
+        cert_array = None
+        trust = Security.SecTrustRef()
+
+        try:
+            # Get a CFArray that contains the certs we want.
+            cert_array = _cert_array_from_pem(trust_bundle)
+
+            # Ok, now the hard part. We want to get the SecTrustRef that ST has
+            # created for this connection, shove our CAs into it, tell ST to
+            # ignore everything else it knows, and then ask if it can build a
+            # chain. This is a buuuunch of code.
+            result = Security.SSLCopyPeerTrust(self.context, ctypes.byref(trust))
+            _assert_no_error(result)
+            if not trust:
+                raise ssl.SSLError("Failed to copy trust reference")
+
+            result = Security.SecTrustSetAnchorCertificates(trust, cert_array)
+            _assert_no_error(result)
+
+            result = Security.SecTrustSetAnchorCertificatesOnly(trust, True)
+            _assert_no_error(result)
+
+            trust_result = Security.SecTrustResultType()
+            result = Security.SecTrustEvaluate(trust, ctypes.byref(trust_result))
+            _assert_no_error(result)
+        finally:
+            if trust:
+                CoreFoundation.CFRelease(trust)
+
+            if cert_array is not None:
+                CoreFoundation.CFRelease(cert_array)
+
+        return trust_result.value
+
+    def handshake(
+        self,
+        server_hostname,
+        verify,
+        trust_bundle,
+        min_version,
+        max_version,
+        client_cert,
+        client_key,
+        client_key_passphrase,
+        alpn_protocols,
+    ):
+        """
+        Actually performs the TLS handshake. This is run automatically by
+        wrapped socket, and shouldn't be needed in user code.
+        """
+        # First, we do the initial bits of connection setup. We need to create
+        # a context, set its I/O funcs, and set the connection reference.
+        self.context = Security.SSLCreateContext(
+            None, SecurityConst.kSSLClientSide, SecurityConst.kSSLStreamType
+        )
+        result = Security.SSLSetIOFuncs(
+            self.context, _read_callback_pointer, _write_callback_pointer
+        )
+        _assert_no_error(result)
+
+        # Here we need to compute the handle to use. We do this by taking the
+        # id of self modulo 2**31 - 1. If this is already in the dictionary, we
+        # just keep incrementing by one until we find a free space.
+        with _connection_ref_lock:
+            handle = id(self) % 2147483647
+            while handle in _connection_refs:
+                handle = (handle + 1) % 2147483647
+            _connection_refs[handle] = self
+
+        result = Security.SSLSetConnection(self.context, handle)
+        _assert_no_error(result)
+
+        # If we have a server hostname, we should set that too.
+        if server_hostname:
+            if not isinstance(server_hostname, bytes):
+                server_hostname = server_hostname.encode("utf-8")
+
+            result = Security.SSLSetPeerDomainName(
+                self.context, server_hostname, len(server_hostname)
+            )
+            _assert_no_error(result)
+
+        # Setup the ciphers.
+        self._set_ciphers()
+
+        # Setup the ALPN protocols.
+        self._set_alpn_protocols(alpn_protocols)
+
+        # Set the minimum and maximum TLS versions.
+        result = Security.SSLSetProtocolVersionMin(self.context, min_version)
+        _assert_no_error(result)
+
+        result = Security.SSLSetProtocolVersionMax(self.context, max_version)
+        _assert_no_error(result)
+
+        # If there's a trust DB, we need to use it. We do that by telling
+        # SecureTransport to break on server auth. We also do that if we don't
+        # want to validate the certs at all: we just won't actually do any
+        # authing in that case.
+        if not verify or trust_bundle is not None:
+            result = Security.SSLSetSessionOption(
+                self.context, SecurityConst.kSSLSessionOptionBreakOnServerAuth, True
+            )
+            _assert_no_error(result)
+
+        # If there's a client cert, we need to use it.
+        if client_cert:
+            self._keychain, self._keychain_dir = _temporary_keychain()
+            self._client_cert_chain = _load_client_cert_chain(
+                self._keychain, client_cert, client_key
+            )
+            result = Security.SSLSetCertificate(self.context, self._client_cert_chain)
+            _assert_no_error(result)
+
+        while True:
+            with self._raise_on_error():
+                result = Security.SSLHandshake(self.context)
+
+                if result == SecurityConst.errSSLWouldBlock:
+                    raise socket.timeout("handshake timed out")
+                elif result == SecurityConst.errSSLServerAuthCompleted:
+                    self._custom_validate(verify, trust_bundle)
+                    continue
+                else:
+                    _assert_no_error(result)
+                    break
+
+    def fileno(self):
+        return self.socket.fileno()
+
+    # Copy-pasted from Python 3.5 source code
+    def _decref_socketios(self):
+        if self._makefile_refs > 0:
+            self._makefile_refs -= 1
+        if self._closed:
+            self.close()
+
+    def recv(self, bufsiz):
+        buffer = ctypes.create_string_buffer(bufsiz)
+        bytes_read = self.recv_into(buffer, bufsiz)
+        data = buffer[:bytes_read]
+        return data
+
+    def recv_into(self, buffer, nbytes=None):
+        # Read short on EOF.
+        if self._closed:
+            return 0
+
+        if nbytes is None:
+            nbytes = len(buffer)
+
+        buffer = (ctypes.c_char * nbytes).from_buffer(buffer)
+        processed_bytes = ctypes.c_size_t(0)
+
+        with self._raise_on_error():
+            result = Security.SSLRead(
+                self.context, buffer, nbytes, ctypes.byref(processed_bytes)
+            )
+
+        # There are some result codes that we want to treat as "not always
+        # errors". Specifically, those are errSSLWouldBlock,
+        # errSSLClosedGraceful, and errSSLClosedNoNotify.
+        if result == SecurityConst.errSSLWouldBlock:
+            # If we didn't process any bytes, then this was just a time out.
+            # However, we can get errSSLWouldBlock in situations when we *did*
+            # read some data, and in those cases we should just read "short"
+            # and return.
+            if processed_bytes.value == 0:
+                # Timed out, no data read.
+                raise socket.timeout("recv timed out")
+        elif result in (
+            SecurityConst.errSSLClosedGraceful,
+            SecurityConst.errSSLClosedNoNotify,
+        ):
+            # The remote peer has closed this connection. We should do so as
+            # well. Note that we don't actually return here because in
+            # principle this could actually be fired along with return data.
+            # It's unlikely though.
+            self.close()
+        else:
+            _assert_no_error(result)
+
+        # Ok, we read and probably succeeded. We should return whatever data
+        # was actually read.
+        return processed_bytes.value
+
+    def settimeout(self, timeout):
+        self._timeout = timeout
+
+    def gettimeout(self):
+        return self._timeout
+
+    def send(self, data):
+        processed_bytes = ctypes.c_size_t(0)
+
+        with self._raise_on_error():
+            result = Security.SSLWrite(
+                self.context, data, len(data), ctypes.byref(processed_bytes)
+            )
+
+        if result == SecurityConst.errSSLWouldBlock and processed_bytes.value == 0:
+            # Timed out
+            raise socket.timeout("send timed out")
+        else:
+            _assert_no_error(result)
+
+        # We sent, and probably succeeded. Tell them how much we sent.
+        return processed_bytes.value
+
+    def sendall(self, data):
+        total_sent = 0
+        while total_sent < len(data):
+            sent = self.send(data[total_sent : total_sent + SSL_WRITE_BLOCKSIZE])
+            total_sent += sent
+
+    def shutdown(self):
+        with self._raise_on_error():
+            Security.SSLClose(self.context)
+
+    def close(self):
+        # TODO: should I do clean shutdown here? Do I have to?
+        if self._makefile_refs < 1:
+            self._closed = True
+            if self.context:
+                CoreFoundation.CFRelease(self.context)
+                self.context = None
+            if self._client_cert_chain:
+                CoreFoundation.CFRelease(self._client_cert_chain)
+                self._client_cert_chain = None
+            if self._keychain:
+                Security.SecKeychainDelete(self._keychain)
+                CoreFoundation.CFRelease(self._keychain)
+                shutil.rmtree(self._keychain_dir)
+                self._keychain = self._keychain_dir = None
+            return self.socket.close()
+        else:
+            self._makefile_refs -= 1
+
+    def getpeercert(self, binary_form=False):
+        # Urgh, annoying.
+        #
+        # Here's how we do this:
+        #
+        # 1. Call SSLCopyPeerTrust to get hold of the trust object for this
+        #    connection.
+        # 2. Call SecTrustGetCertificateAtIndex for index 0 to get the leaf.
+        # 3. To get the CN, call SecCertificateCopyCommonName and process that
+        #    string so that it's of the appropriate type.
+        # 4. To get the SAN, we need to do something a bit more complex:
+        #    a. Call SecCertificateCopyValues to get the data, requesting
+        #       kSecOIDSubjectAltName.
+        #    b. Mess about with this dictionary to try to get the SANs out.
+        #
+        # This is gross. Really gross. It's going to be a few hundred LoC extra
+        # just to repeat something that SecureTransport can *already do*. So my
+        # operating assumption at this time is that what we want to do is
+        # instead to just flag to urllib3 that it shouldn't do its own hostname
+        # validation when using SecureTransport.
+        if not binary_form:
+            raise ValueError("SecureTransport only supports dumping binary certs")
+        trust = Security.SecTrustRef()
+        certdata = None
+        der_bytes = None
+
+        try:
+            # Grab the trust store.
+            result = Security.SSLCopyPeerTrust(self.context, ctypes.byref(trust))
+            _assert_no_error(result)
+            if not trust:
+                # Probably we haven't done the handshake yet. No biggie.
+                return None
+
+            cert_count = Security.SecTrustGetCertificateCount(trust)
+            if not cert_count:
+                # Also a case that might happen if we haven't handshaked.
+                # Handshook? Handshaken?
+                return None
+
+            leaf = Security.SecTrustGetCertificateAtIndex(trust, 0)
+            assert leaf
+
+            # Ok, now we want the DER bytes.
+            certdata = Security.SecCertificateCopyData(leaf)
+            assert certdata
+
+            data_length = CoreFoundation.CFDataGetLength(certdata)
+            data_buffer = CoreFoundation.CFDataGetBytePtr(certdata)
+            der_bytes = ctypes.string_at(data_buffer, data_length)
+        finally:
+            if certdata:
+                CoreFoundation.CFRelease(certdata)
+            if trust:
+                CoreFoundation.CFRelease(trust)
+
+        return der_bytes
+
+    def version(self):
+        protocol = Security.SSLProtocol()
+        result = Security.SSLGetNegotiatedProtocolVersion(
+            self.context, ctypes.byref(protocol)
+        )
+        _assert_no_error(result)
+        if protocol.value == SecurityConst.kTLSProtocol13:
+            raise ssl.SSLError("SecureTransport does not support TLS 1.3")
+        elif protocol.value == SecurityConst.kTLSProtocol12:
+            return "TLSv1.2"
+        elif protocol.value == SecurityConst.kTLSProtocol11:
+            return "TLSv1.1"
+        elif protocol.value == SecurityConst.kTLSProtocol1:
+            return "TLSv1"
+        elif protocol.value == SecurityConst.kSSLProtocol3:
+            return "SSLv3"
+        elif protocol.value == SecurityConst.kSSLProtocol2:
+            return "SSLv2"
+        else:
+            raise ssl.SSLError("Unknown TLS version: %r" % protocol)
+
+    def _reuse(self):
+        self._makefile_refs += 1
+
+    def _drop(self):
+        if self._makefile_refs < 1:
+            self.close()
+        else:
+            self._makefile_refs -= 1
+
+
+if _fileobject:  # Platform-specific: Python 2
+
+    def makefile(self, mode, bufsize=-1):
+        self._makefile_refs += 1
+        return _fileobject(self, mode, bufsize, close=True)
+
+else:  # Platform-specific: Python 3
+
+    def makefile(self, mode="r", buffering=None, *args, **kwargs):
+        # We disable buffering with SecureTransport because it conflicts with
+        # the buffering that ST does internally (see issue #1153 for more).
+        buffering = 0
+        return backport_makefile(self, mode, buffering, *args, **kwargs)
+
+
+WrappedSocket.makefile = makefile
+
+
+class SecureTransportContext(object):
+    """
+    I am a wrapper class for the SecureTransport library, to translate the
+    interface of the standard library ``SSLContext`` object to calls into
+    SecureTransport.
+    """
+
+    def __init__(self, protocol):
+        self._min_version, self._max_version = _protocol_to_min_max[protocol]
+        self._options = 0
+        self._verify = False
+        self._trust_bundle = None
+        self._client_cert = None
+        self._client_key = None
+        self._client_key_passphrase = None
+        self._alpn_protocols = None
+
+    @property
+    def check_hostname(self):
+        """
+        SecureTransport cannot have its hostname checking disabled. For more,
+        see the comment on getpeercert() in this file.
+        """
+        return True
+
+    @check_hostname.setter
+    def check_hostname(self, value):
+        """
+        SecureTransport cannot have its hostname checking disabled. For more,
+        see the comment on getpeercert() in this file.
+        """
+        pass
+
+    @property
+    def options(self):
+        # TODO: Well, crap.
+        #
+        # So this is the bit of the code that is the most likely to cause us
+        # trouble. Essentially we need to enumerate all of the SSL options that
+        # users might want to use and try to see if we can sensibly translate
+        # them, or whether we should just ignore them.
+        return self._options
+
+    @options.setter
+    def options(self, value):
+        # TODO: Update in line with above.
+        self._options = value
+
+    @property
+    def verify_mode(self):
+        return ssl.CERT_REQUIRED if self._verify else ssl.CERT_NONE
+
+    @verify_mode.setter
+    def verify_mode(self, value):
+        self._verify = True if value == ssl.CERT_REQUIRED else False
+
+    def set_default_verify_paths(self):
+        # So, this has to do something a bit weird. Specifically, what it does
+        # is nothing.
+        #
+        # This means that, if we had previously had load_verify_locations
+        # called, this does not undo that. We need to do that because it turns
+        # out that the rest of the urllib3 code will attempt to load the
+        # default verify paths if it hasn't been told about any paths, even if
+        # the context itself was sometime earlier. We resolve that by just
+        # ignoring it.
+        pass
+
+    def load_default_certs(self):
+        return self.set_default_verify_paths()
+
+    def set_ciphers(self, ciphers):
+        # For now, we just require the default cipher string.
+        if ciphers != util.ssl_.DEFAULT_CIPHERS:
+            raise ValueError("SecureTransport doesn't support custom cipher strings")
+
+    def load_verify_locations(self, cafile=None, capath=None, cadata=None):
+        # OK, we only really support cadata and cafile.
+        if capath is not None:
+            raise ValueError("SecureTransport does not support cert directories")
+
+        # Raise if cafile does not exist.
+        if cafile is not None:
+            with open(cafile):
+                pass
+
+        self._trust_bundle = cafile or cadata
+
+    def load_cert_chain(self, certfile, keyfile=None, password=None):
+        self._client_cert = certfile
+        self._client_key = keyfile
+        self._client_cert_passphrase = password
+
+    def set_alpn_protocols(self, protocols):
+        """
+        Sets the ALPN protocols that will later be set on the context.
+
+        Raises a NotImplementedError if ALPN is not supported.
+        """
+        if not hasattr(Security, "SSLSetALPNProtocols"):
+            raise NotImplementedError(
+                "SecureTransport supports ALPN only in macOS 10.12+"
+            )
+        self._alpn_protocols = [six.ensure_binary(p) for p in protocols]
+
+    def wrap_socket(
+        self,
+        sock,
+        server_side=False,
+        do_handshake_on_connect=True,
+        suppress_ragged_eofs=True,
+        server_hostname=None,
+    ):
+        # So, what do we do here? Firstly, we assert some properties. This is a
+        # stripped down shim, so there is some functionality we don't support.
+        # See PEP 543 for the real deal.
+        assert not server_side
+        assert do_handshake_on_connect
+        assert suppress_ragged_eofs
+
+        # Ok, we're good to go. Now we want to create the wrapped socket object
+        # and store it in the appropriate place.
+        wrapped_socket = WrappedSocket(sock)
+
+        # Now we can handshake
+        wrapped_socket.handshake(
+            server_hostname,
+            self._verify,
+            self._trust_bundle,
+            self._min_version,
+            self._max_version,
+            self._client_cert,
+            self._client_key,
+            self._client_key_passphrase,
+            self._alpn_protocols,
+        )
+        return wrapped_socket
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/socks.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/socks.py
new file mode 100644
index 0000000..c326e80
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/socks.py
@@ -0,0 +1,216 @@
+# -*- coding: utf-8 -*-
+"""
+This module contains provisional support for SOCKS proxies from within
+urllib3. This module supports SOCKS4, SOCKS4A (an extension of SOCKS4), and
+SOCKS5. To enable its functionality, either install PySocks or install this
+module with the ``socks`` extra.
+
+The SOCKS implementation supports the full range of urllib3 features. It also
+supports the following SOCKS features:
+
+- SOCKS4A (``proxy_url='socks4a://...``)
+- SOCKS4 (``proxy_url='socks4://...``)
+- SOCKS5 with remote DNS (``proxy_url='socks5h://...``)
+- SOCKS5 with local DNS (``proxy_url='socks5://...``)
+- Usernames and passwords for the SOCKS proxy
+
+.. note::
+   It is recommended to use ``socks5h://`` or ``socks4a://`` schemes in
+   your ``proxy_url`` to ensure that DNS resolution is done from the remote
+   server instead of client-side when connecting to a domain name.
+
+SOCKS4 supports IPv4 and domain names with the SOCKS4A extension. SOCKS5
+supports IPv4, IPv6, and domain names.
+
+When connecting to a SOCKS4 proxy the ``username`` portion of the ``proxy_url``
+will be sent as the ``userid`` section of the SOCKS request:
+
+.. code-block:: python
+
+    proxy_url="socks4a://@proxy-host"
+
+When connecting to a SOCKS5 proxy the ``username`` and ``password`` portion
+of the ``proxy_url`` will be sent as the username/password to authenticate
+with the proxy:
+
+.. code-block:: python
+
+    proxy_url="socks5h://:@proxy-host"
+
+"""
+from __future__ import absolute_import
+
+try:
+    import socks
+except ImportError:
+    import warnings
+
+    from ..exceptions import DependencyWarning
+
+    warnings.warn(
+        (
+            "SOCKS support in urllib3 requires the installation of optional "
+            "dependencies: specifically, PySocks.  For more information, see "
+            "https://urllib3.readthedocs.io/en/1.26.x/contrib.html#socks-proxies"
+        ),
+        DependencyWarning,
+    )
+    raise
+
+from socket import error as SocketError
+from socket import timeout as SocketTimeout
+
+from ..connection import HTTPConnection, HTTPSConnection
+from ..connectionpool import HTTPConnectionPool, HTTPSConnectionPool
+from ..exceptions import ConnectTimeoutError, NewConnectionError
+from ..poolmanager import PoolManager
+from ..util.url import parse_url
+
+try:
+    import ssl
+except ImportError:
+    ssl = None
+
+
+class SOCKSConnection(HTTPConnection):
+    """
+    A plain-text HTTP connection that connects via a SOCKS proxy.
+    """
+
+    def __init__(self, *args, **kwargs):
+        self._socks_options = kwargs.pop("_socks_options")
+        super(SOCKSConnection, self).__init__(*args, **kwargs)
+
+    def _new_conn(self):
+        """
+        Establish a new connection via the SOCKS proxy.
+        """
+        extra_kw = {}
+        if self.source_address:
+            extra_kw["source_address"] = self.source_address
+
+        if self.socket_options:
+            extra_kw["socket_options"] = self.socket_options
+
+        try:
+            conn = socks.create_connection(
+                (self.host, self.port),
+                proxy_type=self._socks_options["socks_version"],
+                proxy_addr=self._socks_options["proxy_host"],
+                proxy_port=self._socks_options["proxy_port"],
+                proxy_username=self._socks_options["username"],
+                proxy_password=self._socks_options["password"],
+                proxy_rdns=self._socks_options["rdns"],
+                timeout=self.timeout,
+                **extra_kw
+            )
+
+        except SocketTimeout:
+            raise ConnectTimeoutError(
+                self,
+                "Connection to %s timed out. (connect timeout=%s)"
+                % (self.host, self.timeout),
+            )
+
+        except socks.ProxyError as e:
+            # This is fragile as hell, but it seems to be the only way to raise
+            # useful errors here.
+            if e.socket_err:
+                error = e.socket_err
+                if isinstance(error, SocketTimeout):
+                    raise ConnectTimeoutError(
+                        self,
+                        "Connection to %s timed out. (connect timeout=%s)"
+                        % (self.host, self.timeout),
+                    )
+                else:
+                    raise NewConnectionError(
+                        self, "Failed to establish a new connection: %s" % error
+                    )
+            else:
+                raise NewConnectionError(
+                    self, "Failed to establish a new connection: %s" % e
+                )
+
+        except SocketError as e:  # Defensive: PySocks should catch all these.
+            raise NewConnectionError(
+                self, "Failed to establish a new connection: %s" % e
+            )
+
+        return conn
+
+
+# We don't need to duplicate the Verified/Unverified distinction from
+# urllib3/connection.py here because the HTTPSConnection will already have been
+# correctly set to either the Verified or Unverified form by that module. This
+# means the SOCKSHTTPSConnection will automatically be the correct type.
+class SOCKSHTTPSConnection(SOCKSConnection, HTTPSConnection):
+    pass
+
+
+class SOCKSHTTPConnectionPool(HTTPConnectionPool):
+    ConnectionCls = SOCKSConnection
+
+
+class SOCKSHTTPSConnectionPool(HTTPSConnectionPool):
+    ConnectionCls = SOCKSHTTPSConnection
+
+
+class SOCKSProxyManager(PoolManager):
+    """
+    A version of the urllib3 ProxyManager that routes connections via the
+    defined SOCKS proxy.
+    """
+
+    pool_classes_by_scheme = {
+        "http": SOCKSHTTPConnectionPool,
+        "https": SOCKSHTTPSConnectionPool,
+    }
+
+    def __init__(
+        self,
+        proxy_url,
+        username=None,
+        password=None,
+        num_pools=10,
+        headers=None,
+        **connection_pool_kw
+    ):
+        parsed = parse_url(proxy_url)
+
+        if username is None and password is None and parsed.auth is not None:
+            split = parsed.auth.split(":")
+            if len(split) == 2:
+                username, password = split
+        if parsed.scheme == "socks5":
+            socks_version = socks.PROXY_TYPE_SOCKS5
+            rdns = False
+        elif parsed.scheme == "socks5h":
+            socks_version = socks.PROXY_TYPE_SOCKS5
+            rdns = True
+        elif parsed.scheme == "socks4":
+            socks_version = socks.PROXY_TYPE_SOCKS4
+            rdns = False
+        elif parsed.scheme == "socks4a":
+            socks_version = socks.PROXY_TYPE_SOCKS4
+            rdns = True
+        else:
+            raise ValueError("Unable to determine SOCKS version from %s" % proxy_url)
+
+        self.proxy_url = proxy_url
+
+        socks_options = {
+            "socks_version": socks_version,
+            "proxy_host": parsed.host,
+            "proxy_port": parsed.port,
+            "username": username,
+            "password": password,
+            "rdns": rdns,
+        }
+        connection_pool_kw["_socks_options"] = socks_options
+
+        super(SOCKSProxyManager, self).__init__(
+            num_pools, headers, **connection_pool_kw
+        )
+
+        self.pool_classes_by_scheme = SOCKSProxyManager.pool_classes_by_scheme
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/exceptions.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/exceptions.py
new file mode 100644
index 0000000..cba6f3f
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/exceptions.py
@@ -0,0 +1,323 @@
+from __future__ import absolute_import
+
+from .packages.six.moves.http_client import IncompleteRead as httplib_IncompleteRead
+
+# Base Exceptions
+
+
+class HTTPError(Exception):
+    """Base exception used by this module."""
+
+    pass
+
+
+class HTTPWarning(Warning):
+    """Base warning used by this module."""
+
+    pass
+
+
+class PoolError(HTTPError):
+    """Base exception for errors caused within a pool."""
+
+    def __init__(self, pool, message):
+        self.pool = pool
+        HTTPError.__init__(self, "%s: %s" % (pool, message))
+
+    def __reduce__(self):
+        # For pickling purposes.
+        return self.__class__, (None, None)
+
+
+class RequestError(PoolError):
+    """Base exception for PoolErrors that have associated URLs."""
+
+    def __init__(self, pool, url, message):
+        self.url = url
+        PoolError.__init__(self, pool, message)
+
+    def __reduce__(self):
+        # For pickling purposes.
+        return self.__class__, (None, self.url, None)
+
+
+class SSLError(HTTPError):
+    """Raised when SSL certificate fails in an HTTPS connection."""
+
+    pass
+
+
+class ProxyError(HTTPError):
+    """Raised when the connection to a proxy fails."""
+
+    def __init__(self, message, error, *args):
+        super(ProxyError, self).__init__(message, error, *args)
+        self.original_error = error
+
+
+class DecodeError(HTTPError):
+    """Raised when automatic decoding based on Content-Type fails."""
+
+    pass
+
+
+class ProtocolError(HTTPError):
+    """Raised when something unexpected happens mid-request/response."""
+
+    pass
+
+
+#: Renamed to ProtocolError but aliased for backwards compatibility.
+ConnectionError = ProtocolError
+
+
+# Leaf Exceptions
+
+
+class MaxRetryError(RequestError):
+    """Raised when the maximum number of retries is exceeded.
+
+    :param pool: The connection pool
+    :type pool: :class:`~urllib3.connectionpool.HTTPConnectionPool`
+    :param string url: The requested Url
+    :param exceptions.Exception reason: The underlying error
+
+    """
+
+    def __init__(self, pool, url, reason=None):
+        self.reason = reason
+
+        message = "Max retries exceeded with url: %s (Caused by %r)" % (url, reason)
+
+        RequestError.__init__(self, pool, url, message)
+
+
+class HostChangedError(RequestError):
+    """Raised when an existing pool gets a request for a foreign host."""
+
+    def __init__(self, pool, url, retries=3):
+        message = "Tried to open a foreign host with url: %s" % url
+        RequestError.__init__(self, pool, url, message)
+        self.retries = retries
+
+
+class TimeoutStateError(HTTPError):
+    """Raised when passing an invalid state to a timeout"""
+
+    pass
+
+
+class TimeoutError(HTTPError):
+    """Raised when a socket timeout error occurs.
+
+    Catching this error will catch both :exc:`ReadTimeoutErrors
+    ` and :exc:`ConnectTimeoutErrors `.
+    """
+
+    pass
+
+
+class ReadTimeoutError(TimeoutError, RequestError):
+    """Raised when a socket timeout occurs while receiving data from a server"""
+
+    pass
+
+
+# This timeout error does not have a URL attached and needs to inherit from the
+# base HTTPError
+class ConnectTimeoutError(TimeoutError):
+    """Raised when a socket timeout occurs while connecting to a server"""
+
+    pass
+
+
+class NewConnectionError(ConnectTimeoutError, PoolError):
+    """Raised when we fail to establish a new connection. Usually ECONNREFUSED."""
+
+    pass
+
+
+class EmptyPoolError(PoolError):
+    """Raised when a pool runs out of connections and no more are allowed."""
+
+    pass
+
+
+class ClosedPoolError(PoolError):
+    """Raised when a request enters a pool after the pool has been closed."""
+
+    pass
+
+
+class LocationValueError(ValueError, HTTPError):
+    """Raised when there is something wrong with a given URL input."""
+
+    pass
+
+
+class LocationParseError(LocationValueError):
+    """Raised when get_host or similar fails to parse the URL input."""
+
+    def __init__(self, location):
+        message = "Failed to parse: %s" % location
+        HTTPError.__init__(self, message)
+
+        self.location = location
+
+
+class URLSchemeUnknown(LocationValueError):
+    """Raised when a URL input has an unsupported scheme."""
+
+    def __init__(self, scheme):
+        message = "Not supported URL scheme %s" % scheme
+        super(URLSchemeUnknown, self).__init__(message)
+
+        self.scheme = scheme
+
+
+class ResponseError(HTTPError):
+    """Used as a container for an error reason supplied in a MaxRetryError."""
+
+    GENERIC_ERROR = "too many error responses"
+    SPECIFIC_ERROR = "too many {status_code} error responses"
+
+
+class SecurityWarning(HTTPWarning):
+    """Warned when performing security reducing actions"""
+
+    pass
+
+
+class SubjectAltNameWarning(SecurityWarning):
+    """Warned when connecting to a host with a certificate missing a SAN."""
+
+    pass
+
+
+class InsecureRequestWarning(SecurityWarning):
+    """Warned when making an unverified HTTPS request."""
+
+    pass
+
+
+class SystemTimeWarning(SecurityWarning):
+    """Warned when system time is suspected to be wrong"""
+
+    pass
+
+
+class InsecurePlatformWarning(SecurityWarning):
+    """Warned when certain TLS/SSL configuration is not available on a platform."""
+
+    pass
+
+
+class SNIMissingWarning(HTTPWarning):
+    """Warned when making a HTTPS request without SNI available."""
+
+    pass
+
+
+class DependencyWarning(HTTPWarning):
+    """
+    Warned when an attempt is made to import a module with missing optional
+    dependencies.
+    """
+
+    pass
+
+
+class ResponseNotChunked(ProtocolError, ValueError):
+    """Response needs to be chunked in order to read it as chunks."""
+
+    pass
+
+
+class BodyNotHttplibCompatible(HTTPError):
+    """
+    Body should be :class:`http.client.HTTPResponse` like
+    (have an fp attribute which returns raw chunks) for read_chunked().
+    """
+
+    pass
+
+
+class IncompleteRead(HTTPError, httplib_IncompleteRead):
+    """
+    Response length doesn't match expected Content-Length
+
+    Subclass of :class:`http.client.IncompleteRead` to allow int value
+    for ``partial`` to avoid creating large objects on streamed reads.
+    """
+
+    def __init__(self, partial, expected):
+        super(IncompleteRead, self).__init__(partial, expected)
+
+    def __repr__(self):
+        return "IncompleteRead(%i bytes read, %i more expected)" % (
+            self.partial,
+            self.expected,
+        )
+
+
+class InvalidChunkLength(HTTPError, httplib_IncompleteRead):
+    """Invalid chunk length in a chunked response."""
+
+    def __init__(self, response, length):
+        super(InvalidChunkLength, self).__init__(
+            response.tell(), response.length_remaining
+        )
+        self.response = response
+        self.length = length
+
+    def __repr__(self):
+        return "InvalidChunkLength(got length %r, %i bytes read)" % (
+            self.length,
+            self.partial,
+        )
+
+
+class InvalidHeader(HTTPError):
+    """The header provided was somehow invalid."""
+
+    pass
+
+
+class ProxySchemeUnknown(AssertionError, URLSchemeUnknown):
+    """ProxyManager does not support the supplied scheme"""
+
+    # TODO(t-8ch): Stop inheriting from AssertionError in v2.0.
+
+    def __init__(self, scheme):
+        # 'localhost' is here because our URL parser parses
+        # localhost:8080 -> scheme=localhost, remove if we fix this.
+        if scheme == "localhost":
+            scheme = None
+        if scheme is None:
+            message = "Proxy URL had no scheme, should start with http:// or https://"
+        else:
+            message = (
+                "Proxy URL had unsupported scheme %s, should use http:// or https://"
+                % scheme
+            )
+        super(ProxySchemeUnknown, self).__init__(message)
+
+
+class ProxySchemeUnsupported(ValueError):
+    """Fetching HTTPS resources through HTTPS proxies is unsupported"""
+
+    pass
+
+
+class HeaderParsingError(HTTPError):
+    """Raised by assert_header_parsing, but we convert it to a log.warning statement."""
+
+    def __init__(self, defects, unparsed_data):
+        message = "%s, unparsed data: %r" % (defects or "Unknown", unparsed_data)
+        super(HeaderParsingError, self).__init__(message)
+
+
+class UnrewindableBodyError(HTTPError):
+    """urllib3 encountered an error when trying to rewind a body"""
+
+    pass
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/fields.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/fields.py
new file mode 100644
index 0000000..9d630f4
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/fields.py
@@ -0,0 +1,274 @@
+from __future__ import absolute_import
+
+import email.utils
+import mimetypes
+import re
+
+from .packages import six
+
+
+def guess_content_type(filename, default="application/octet-stream"):
+    """
+    Guess the "Content-Type" of a file.
+
+    :param filename:
+        The filename to guess the "Content-Type" of using :mod:`mimetypes`.
+    :param default:
+        If no "Content-Type" can be guessed, default to `default`.
+    """
+    if filename:
+        return mimetypes.guess_type(filename)[0] or default
+    return default
+
+
+def format_header_param_rfc2231(name, value):
+    """
+    Helper function to format and quote a single header parameter using the
+    strategy defined in RFC 2231.
+
+    Particularly useful for header parameters which might contain
+    non-ASCII values, like file names. This follows
+    `RFC 2388 Section 4.4 `_.
+
+    :param name:
+        The name of the parameter, a string expected to be ASCII only.
+    :param value:
+        The value of the parameter, provided as ``bytes`` or `str``.
+    :ret:
+        An RFC-2231-formatted unicode string.
+    """
+    if isinstance(value, six.binary_type):
+        value = value.decode("utf-8")
+
+    if not any(ch in value for ch in '"\\\r\n'):
+        result = u'%s="%s"' % (name, value)
+        try:
+            result.encode("ascii")
+        except (UnicodeEncodeError, UnicodeDecodeError):
+            pass
+        else:
+            return result
+
+    if six.PY2:  # Python 2:
+        value = value.encode("utf-8")
+
+    # encode_rfc2231 accepts an encoded string and returns an ascii-encoded
+    # string in Python 2 but accepts and returns unicode strings in Python 3
+    value = email.utils.encode_rfc2231(value, "utf-8")
+    value = "%s*=%s" % (name, value)
+
+    if six.PY2:  # Python 2:
+        value = value.decode("utf-8")
+
+    return value
+
+
+_HTML5_REPLACEMENTS = {
+    u"\u0022": u"%22",
+    # Replace "\" with "\\".
+    u"\u005C": u"\u005C\u005C",
+}
+
+# All control characters from 0x00 to 0x1F *except* 0x1B.
+_HTML5_REPLACEMENTS.update(
+    {
+        six.unichr(cc): u"%{:02X}".format(cc)
+        for cc in range(0x00, 0x1F + 1)
+        if cc not in (0x1B,)
+    }
+)
+
+
+def _replace_multiple(value, needles_and_replacements):
+    def replacer(match):
+        return needles_and_replacements[match.group(0)]
+
+    pattern = re.compile(
+        r"|".join([re.escape(needle) for needle in needles_and_replacements.keys()])
+    )
+
+    result = pattern.sub(replacer, value)
+
+    return result
+
+
+def format_header_param_html5(name, value):
+    """
+    Helper function to format and quote a single header parameter using the
+    HTML5 strategy.
+
+    Particularly useful for header parameters which might contain
+    non-ASCII values, like file names. This follows the `HTML5 Working Draft
+    Section 4.10.22.7`_ and matches the behavior of curl and modern browsers.
+
+    .. _HTML5 Working Draft Section 4.10.22.7:
+        https://w3c.github.io/html/sec-forms.html#multipart-form-data
+
+    :param name:
+        The name of the parameter, a string expected to be ASCII only.
+    :param value:
+        The value of the parameter, provided as ``bytes`` or `str``.
+    :ret:
+        A unicode string, stripped of troublesome characters.
+    """
+    if isinstance(value, six.binary_type):
+        value = value.decode("utf-8")
+
+    value = _replace_multiple(value, _HTML5_REPLACEMENTS)
+
+    return u'%s="%s"' % (name, value)
+
+
+# For backwards-compatibility.
+format_header_param = format_header_param_html5
+
+
+class RequestField(object):
+    """
+    A data container for request body parameters.
+
+    :param name:
+        The name of this request field. Must be unicode.
+    :param data:
+        The data/value body.
+    :param filename:
+        An optional filename of the request field. Must be unicode.
+    :param headers:
+        An optional dict-like object of headers to initially use for the field.
+    :param header_formatter:
+        An optional callable that is used to encode and format the headers. By
+        default, this is :func:`format_header_param_html5`.
+    """
+
+    def __init__(
+        self,
+        name,
+        data,
+        filename=None,
+        headers=None,
+        header_formatter=format_header_param_html5,
+    ):
+        self._name = name
+        self._filename = filename
+        self.data = data
+        self.headers = {}
+        if headers:
+            self.headers = dict(headers)
+        self.header_formatter = header_formatter
+
+    @classmethod
+    def from_tuples(cls, fieldname, value, header_formatter=format_header_param_html5):
+        """
+        A :class:`~urllib3.fields.RequestField` factory from old-style tuple parameters.
+
+        Supports constructing :class:`~urllib3.fields.RequestField` from
+        parameter of key/value strings AND key/filetuple. A filetuple is a
+        (filename, data, MIME type) tuple where the MIME type is optional.
+        For example::
+
+            'foo': 'bar',
+            'fakefile': ('foofile.txt', 'contents of foofile'),
+            'realfile': ('barfile.txt', open('realfile').read()),
+            'typedfile': ('bazfile.bin', open('bazfile').read(), 'image/jpeg'),
+            'nonamefile': 'contents of nonamefile field',
+
+        Field names and filenames must be unicode.
+        """
+        if isinstance(value, tuple):
+            if len(value) == 3:
+                filename, data, content_type = value
+            else:
+                filename, data = value
+                content_type = guess_content_type(filename)
+        else:
+            filename = None
+            content_type = None
+            data = value
+
+        request_param = cls(
+            fieldname, data, filename=filename, header_formatter=header_formatter
+        )
+        request_param.make_multipart(content_type=content_type)
+
+        return request_param
+
+    def _render_part(self, name, value):
+        """
+        Overridable helper function to format a single header parameter. By
+        default, this calls ``self.header_formatter``.
+
+        :param name:
+            The name of the parameter, a string expected to be ASCII only.
+        :param value:
+            The value of the parameter, provided as a unicode string.
+        """
+
+        return self.header_formatter(name, value)
+
+    def _render_parts(self, header_parts):
+        """
+        Helper function to format and quote a single header.
+
+        Useful for single headers that are composed of multiple items. E.g.,
+        'Content-Disposition' fields.
+
+        :param header_parts:
+            A sequence of (k, v) tuples or a :class:`dict` of (k, v) to format
+            as `k1="v1"; k2="v2"; ...`.
+        """
+        parts = []
+        iterable = header_parts
+        if isinstance(header_parts, dict):
+            iterable = header_parts.items()
+
+        for name, value in iterable:
+            if value is not None:
+                parts.append(self._render_part(name, value))
+
+        return u"; ".join(parts)
+
+    def render_headers(self):
+        """
+        Renders the headers for this request field.
+        """
+        lines = []
+
+        sort_keys = ["Content-Disposition", "Content-Type", "Content-Location"]
+        for sort_key in sort_keys:
+            if self.headers.get(sort_key, False):
+                lines.append(u"%s: %s" % (sort_key, self.headers[sort_key]))
+
+        for header_name, header_value in self.headers.items():
+            if header_name not in sort_keys:
+                if header_value:
+                    lines.append(u"%s: %s" % (header_name, header_value))
+
+        lines.append(u"\r\n")
+        return u"\r\n".join(lines)
+
+    def make_multipart(
+        self, content_disposition=None, content_type=None, content_location=None
+    ):
+        """
+        Makes this request field into a multipart request field.
+
+        This method overrides "Content-Disposition", "Content-Type" and
+        "Content-Location" headers to the request parameter.
+
+        :param content_type:
+            The 'Content-Type' of the request body.
+        :param content_location:
+            The 'Content-Location' of the request body.
+
+        """
+        self.headers["Content-Disposition"] = content_disposition or u"form-data"
+        self.headers["Content-Disposition"] += u"; ".join(
+            [
+                u"",
+                self._render_parts(
+                    ((u"name", self._name), (u"filename", self._filename))
+                ),
+            ]
+        )
+        self.headers["Content-Type"] = content_type
+        self.headers["Content-Location"] = content_location
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/filepost.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/filepost.py
new file mode 100644
index 0000000..36c9252
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/filepost.py
@@ -0,0 +1,98 @@
+from __future__ import absolute_import
+
+import binascii
+import codecs
+import os
+from io import BytesIO
+
+from .fields import RequestField
+from .packages import six
+from .packages.six import b
+
+writer = codecs.lookup("utf-8")[3]
+
+
+def choose_boundary():
+    """
+    Our embarrassingly-simple replacement for mimetools.choose_boundary.
+    """
+    boundary = binascii.hexlify(os.urandom(16))
+    if not six.PY2:
+        boundary = boundary.decode("ascii")
+    return boundary
+
+
+def iter_field_objects(fields):
+    """
+    Iterate over fields.
+
+    Supports list of (k, v) tuples and dicts, and lists of
+    :class:`~urllib3.fields.RequestField`.
+
+    """
+    if isinstance(fields, dict):
+        i = six.iteritems(fields)
+    else:
+        i = iter(fields)
+
+    for field in i:
+        if isinstance(field, RequestField):
+            yield field
+        else:
+            yield RequestField.from_tuples(*field)
+
+
+def iter_fields(fields):
+    """
+    .. deprecated:: 1.6
+
+    Iterate over fields.
+
+    The addition of :class:`~urllib3.fields.RequestField` makes this function
+    obsolete. Instead, use :func:`iter_field_objects`, which returns
+    :class:`~urllib3.fields.RequestField` objects.
+
+    Supports list of (k, v) tuples and dicts.
+    """
+    if isinstance(fields, dict):
+        return ((k, v) for k, v in six.iteritems(fields))
+
+    return ((k, v) for k, v in fields)
+
+
+def encode_multipart_formdata(fields, boundary=None):
+    """
+    Encode a dictionary of ``fields`` using the multipart/form-data MIME format.
+
+    :param fields:
+        Dictionary of fields or list of (key, :class:`~urllib3.fields.RequestField`).
+
+    :param boundary:
+        If not specified, then a random boundary will be generated using
+        :func:`urllib3.filepost.choose_boundary`.
+    """
+    body = BytesIO()
+    if boundary is None:
+        boundary = choose_boundary()
+
+    for field in iter_field_objects(fields):
+        body.write(b("--%s\r\n" % (boundary)))
+
+        writer(body).write(field.render_headers())
+        data = field.data
+
+        if isinstance(data, int):
+            data = str(data)  # Backwards compatibility
+
+        if isinstance(data, six.text_type):
+            writer(body).write(data)
+        else:
+            body.write(data)
+
+        body.write(b"\r\n")
+
+    body.write(b("--%s--\r\n" % (boundary)))
+
+    content_type = str("multipart/form-data; boundary=%s" % boundary)
+
+    return body.getvalue(), content_type
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/packages/__init__.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/packages/__init__.py
new file mode 100644
index 0000000..e69de29
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/packages/__pycache__/__init__.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/packages/__pycache__/__init__.cpython-312.pyc
new file mode 100644
index 0000000..596b771
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/packages/__pycache__/__init__.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/packages/__pycache__/six.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/packages/__pycache__/six.cpython-312.pyc
new file mode 100644
index 0000000..7251702
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/packages/__pycache__/six.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/packages/backports/__init__.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/packages/backports/__init__.py
new file mode 100644
index 0000000..e69de29
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/packages/backports/__pycache__/__init__.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/packages/backports/__pycache__/__init__.cpython-312.pyc
new file mode 100644
index 0000000..f8fd73a
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/packages/backports/__pycache__/__init__.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/packages/backports/__pycache__/makefile.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/packages/backports/__pycache__/makefile.cpython-312.pyc
new file mode 100644
index 0000000..7889231
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/packages/backports/__pycache__/makefile.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/packages/backports/__pycache__/weakref_finalize.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/packages/backports/__pycache__/weakref_finalize.cpython-312.pyc
new file mode 100644
index 0000000..8ff4f5d
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/packages/backports/__pycache__/weakref_finalize.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/packages/backports/makefile.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/packages/backports/makefile.py
new file mode 100644
index 0000000..b8fb215
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/packages/backports/makefile.py
@@ -0,0 +1,51 @@
+# -*- coding: utf-8 -*-
+"""
+backports.makefile
+~~~~~~~~~~~~~~~~~~
+
+Backports the Python 3 ``socket.makefile`` method for use with anything that
+wants to create a "fake" socket object.
+"""
+import io
+from socket import SocketIO
+
+
+def backport_makefile(
+    self, mode="r", buffering=None, encoding=None, errors=None, newline=None
+):
+    """
+    Backport of ``socket.makefile`` from Python 3.5.
+    """
+    if not set(mode) <= {"r", "w", "b"}:
+        raise ValueError("invalid mode %r (only r, w, b allowed)" % (mode,))
+    writing = "w" in mode
+    reading = "r" in mode or not writing
+    assert reading or writing
+    binary = "b" in mode
+    rawmode = ""
+    if reading:
+        rawmode += "r"
+    if writing:
+        rawmode += "w"
+    raw = SocketIO(self, rawmode)
+    self._makefile_refs += 1
+    if buffering is None:
+        buffering = -1
+    if buffering < 0:
+        buffering = io.DEFAULT_BUFFER_SIZE
+    if buffering == 0:
+        if not binary:
+            raise ValueError("unbuffered streams must be binary")
+        return raw
+    if reading and writing:
+        buffer = io.BufferedRWPair(raw, raw, buffering)
+    elif reading:
+        buffer = io.BufferedReader(raw, buffering)
+    else:
+        assert writing
+        buffer = io.BufferedWriter(raw, buffering)
+    if binary:
+        return buffer
+    text = io.TextIOWrapper(buffer, encoding, errors, newline)
+    text.mode = mode
+    return text
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/packages/backports/weakref_finalize.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/packages/backports/weakref_finalize.py
new file mode 100644
index 0000000..a2f2966
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/packages/backports/weakref_finalize.py
@@ -0,0 +1,155 @@
+# -*- coding: utf-8 -*-
+"""
+backports.weakref_finalize
+~~~~~~~~~~~~~~~~~~
+
+Backports the Python 3 ``weakref.finalize`` method.
+"""
+from __future__ import absolute_import
+
+import itertools
+import sys
+from weakref import ref
+
+__all__ = ["weakref_finalize"]
+
+
+class weakref_finalize(object):
+    """Class for finalization of weakrefable objects
+    finalize(obj, func, *args, **kwargs) returns a callable finalizer
+    object which will be called when obj is garbage collected. The
+    first time the finalizer is called it evaluates func(*arg, **kwargs)
+    and returns the result. After this the finalizer is dead, and
+    calling it just returns None.
+    When the program exits any remaining finalizers for which the
+    atexit attribute is true will be run in reverse order of creation.
+    By default atexit is true.
+    """
+
+    # Finalizer objects don't have any state of their own.  They are
+    # just used as keys to lookup _Info objects in the registry.  This
+    # ensures that they cannot be part of a ref-cycle.
+
+    __slots__ = ()
+    _registry = {}
+    _shutdown = False
+    _index_iter = itertools.count()
+    _dirty = False
+    _registered_with_atexit = False
+
+    class _Info(object):
+        __slots__ = ("weakref", "func", "args", "kwargs", "atexit", "index")
+
+    def __init__(self, obj, func, *args, **kwargs):
+        if not self._registered_with_atexit:
+            # We may register the exit function more than once because
+            # of a thread race, but that is harmless
+            import atexit
+
+            atexit.register(self._exitfunc)
+            weakref_finalize._registered_with_atexit = True
+        info = self._Info()
+        info.weakref = ref(obj, self)
+        info.func = func
+        info.args = args
+        info.kwargs = kwargs or None
+        info.atexit = True
+        info.index = next(self._index_iter)
+        self._registry[self] = info
+        weakref_finalize._dirty = True
+
+    def __call__(self, _=None):
+        """If alive then mark as dead and return func(*args, **kwargs);
+        otherwise return None"""
+        info = self._registry.pop(self, None)
+        if info and not self._shutdown:
+            return info.func(*info.args, **(info.kwargs or {}))
+
+    def detach(self):
+        """If alive then mark as dead and return (obj, func, args, kwargs);
+        otherwise return None"""
+        info = self._registry.get(self)
+        obj = info and info.weakref()
+        if obj is not None and self._registry.pop(self, None):
+            return (obj, info.func, info.args, info.kwargs or {})
+
+    def peek(self):
+        """If alive then return (obj, func, args, kwargs);
+        otherwise return None"""
+        info = self._registry.get(self)
+        obj = info and info.weakref()
+        if obj is not None:
+            return (obj, info.func, info.args, info.kwargs or {})
+
+    @property
+    def alive(self):
+        """Whether finalizer is alive"""
+        return self in self._registry
+
+    @property
+    def atexit(self):
+        """Whether finalizer should be called at exit"""
+        info = self._registry.get(self)
+        return bool(info) and info.atexit
+
+    @atexit.setter
+    def atexit(self, value):
+        info = self._registry.get(self)
+        if info:
+            info.atexit = bool(value)
+
+    def __repr__(self):
+        info = self._registry.get(self)
+        obj = info and info.weakref()
+        if obj is None:
+            return "<%s object at %#x; dead>" % (type(self).__name__, id(self))
+        else:
+            return "<%s object at %#x; for %r at %#x>" % (
+                type(self).__name__,
+                id(self),
+                type(obj).__name__,
+                id(obj),
+            )
+
+    @classmethod
+    def _select_for_exit(cls):
+        # Return live finalizers marked for exit, oldest first
+        L = [(f, i) for (f, i) in cls._registry.items() if i.atexit]
+        L.sort(key=lambda item: item[1].index)
+        return [f for (f, i) in L]
+
+    @classmethod
+    def _exitfunc(cls):
+        # At shutdown invoke finalizers for which atexit is true.
+        # This is called once all other non-daemonic threads have been
+        # joined.
+        reenable_gc = False
+        try:
+            if cls._registry:
+                import gc
+
+                if gc.isenabled():
+                    reenable_gc = True
+                    gc.disable()
+                pending = None
+                while True:
+                    if pending is None or weakref_finalize._dirty:
+                        pending = cls._select_for_exit()
+                        weakref_finalize._dirty = False
+                    if not pending:
+                        break
+                    f = pending.pop()
+                    try:
+                        # gc is disabled, so (assuming no daemonic
+                        # threads) the following is the only line in
+                        # this function which might trigger creation
+                        # of a new finalizer
+                        f()
+                    except Exception:
+                        sys.excepthook(*sys.exc_info())
+                    assert f not in cls._registry
+        finally:
+            # prevent any more finalizers from executing during shutdown
+            weakref_finalize._shutdown = True
+            if reenable_gc:
+                gc.enable()
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/packages/six.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/packages/six.py
new file mode 100644
index 0000000..f099a3d
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/packages/six.py
@@ -0,0 +1,1076 @@
+# Copyright (c) 2010-2020 Benjamin Peterson
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in all
+# copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# SOFTWARE.
+
+"""Utilities for writing code that runs on Python 2 and 3"""
+
+from __future__ import absolute_import
+
+import functools
+import itertools
+import operator
+import sys
+import types
+
+__author__ = "Benjamin Peterson "
+__version__ = "1.16.0"
+
+
+# Useful for very coarse version differentiation.
+PY2 = sys.version_info[0] == 2
+PY3 = sys.version_info[0] == 3
+PY34 = sys.version_info[0:2] >= (3, 4)
+
+if PY3:
+    string_types = (str,)
+    integer_types = (int,)
+    class_types = (type,)
+    text_type = str
+    binary_type = bytes
+
+    MAXSIZE = sys.maxsize
+else:
+    string_types = (basestring,)
+    integer_types = (int, long)
+    class_types = (type, types.ClassType)
+    text_type = unicode
+    binary_type = str
+
+    if sys.platform.startswith("java"):
+        # Jython always uses 32 bits.
+        MAXSIZE = int((1 << 31) - 1)
+    else:
+        # It's possible to have sizeof(long) != sizeof(Py_ssize_t).
+        class X(object):
+            def __len__(self):
+                return 1 << 31
+
+        try:
+            len(X())
+        except OverflowError:
+            # 32-bit
+            MAXSIZE = int((1 << 31) - 1)
+        else:
+            # 64-bit
+            MAXSIZE = int((1 << 63) - 1)
+        del X
+
+if PY34:
+    from importlib.util import spec_from_loader
+else:
+    spec_from_loader = None
+
+
+def _add_doc(func, doc):
+    """Add documentation to a function."""
+    func.__doc__ = doc
+
+
+def _import_module(name):
+    """Import module, returning the module after the last dot."""
+    __import__(name)
+    return sys.modules[name]
+
+
+class _LazyDescr(object):
+    def __init__(self, name):
+        self.name = name
+
+    def __get__(self, obj, tp):
+        result = self._resolve()
+        setattr(obj, self.name, result)  # Invokes __set__.
+        try:
+            # This is a bit ugly, but it avoids running this again by
+            # removing this descriptor.
+            delattr(obj.__class__, self.name)
+        except AttributeError:
+            pass
+        return result
+
+
+class MovedModule(_LazyDescr):
+    def __init__(self, name, old, new=None):
+        super(MovedModule, self).__init__(name)
+        if PY3:
+            if new is None:
+                new = name
+            self.mod = new
+        else:
+            self.mod = old
+
+    def _resolve(self):
+        return _import_module(self.mod)
+
+    def __getattr__(self, attr):
+        _module = self._resolve()
+        value = getattr(_module, attr)
+        setattr(self, attr, value)
+        return value
+
+
+class _LazyModule(types.ModuleType):
+    def __init__(self, name):
+        super(_LazyModule, self).__init__(name)
+        self.__doc__ = self.__class__.__doc__
+
+    def __dir__(self):
+        attrs = ["__doc__", "__name__"]
+        attrs += [attr.name for attr in self._moved_attributes]
+        return attrs
+
+    # Subclasses should override this
+    _moved_attributes = []
+
+
+class MovedAttribute(_LazyDescr):
+    def __init__(self, name, old_mod, new_mod, old_attr=None, new_attr=None):
+        super(MovedAttribute, self).__init__(name)
+        if PY3:
+            if new_mod is None:
+                new_mod = name
+            self.mod = new_mod
+            if new_attr is None:
+                if old_attr is None:
+                    new_attr = name
+                else:
+                    new_attr = old_attr
+            self.attr = new_attr
+        else:
+            self.mod = old_mod
+            if old_attr is None:
+                old_attr = name
+            self.attr = old_attr
+
+    def _resolve(self):
+        module = _import_module(self.mod)
+        return getattr(module, self.attr)
+
+
+class _SixMetaPathImporter(object):
+
+    """
+    A meta path importer to import six.moves and its submodules.
+
+    This class implements a PEP302 finder and loader. It should be compatible
+    with Python 2.5 and all existing versions of Python3
+    """
+
+    def __init__(self, six_module_name):
+        self.name = six_module_name
+        self.known_modules = {}
+
+    def _add_module(self, mod, *fullnames):
+        for fullname in fullnames:
+            self.known_modules[self.name + "." + fullname] = mod
+
+    def _get_module(self, fullname):
+        return self.known_modules[self.name + "." + fullname]
+
+    def find_module(self, fullname, path=None):
+        if fullname in self.known_modules:
+            return self
+        return None
+
+    def find_spec(self, fullname, path, target=None):
+        if fullname in self.known_modules:
+            return spec_from_loader(fullname, self)
+        return None
+
+    def __get_module(self, fullname):
+        try:
+            return self.known_modules[fullname]
+        except KeyError:
+            raise ImportError("This loader does not know module " + fullname)
+
+    def load_module(self, fullname):
+        try:
+            # in case of a reload
+            return sys.modules[fullname]
+        except KeyError:
+            pass
+        mod = self.__get_module(fullname)
+        if isinstance(mod, MovedModule):
+            mod = mod._resolve()
+        else:
+            mod.__loader__ = self
+        sys.modules[fullname] = mod
+        return mod
+
+    def is_package(self, fullname):
+        """
+        Return true, if the named module is a package.
+
+        We need this method to get correct spec objects with
+        Python 3.4 (see PEP451)
+        """
+        return hasattr(self.__get_module(fullname), "__path__")
+
+    def get_code(self, fullname):
+        """Return None
+
+        Required, if is_package is implemented"""
+        self.__get_module(fullname)  # eventually raises ImportError
+        return None
+
+    get_source = get_code  # same as get_code
+
+    def create_module(self, spec):
+        return self.load_module(spec.name)
+
+    def exec_module(self, module):
+        pass
+
+
+_importer = _SixMetaPathImporter(__name__)
+
+
+class _MovedItems(_LazyModule):
+
+    """Lazy loading of moved objects"""
+
+    __path__ = []  # mark as package
+
+
+_moved_attributes = [
+    MovedAttribute("cStringIO", "cStringIO", "io", "StringIO"),
+    MovedAttribute("filter", "itertools", "builtins", "ifilter", "filter"),
+    MovedAttribute(
+        "filterfalse", "itertools", "itertools", "ifilterfalse", "filterfalse"
+    ),
+    MovedAttribute("input", "__builtin__", "builtins", "raw_input", "input"),
+    MovedAttribute("intern", "__builtin__", "sys"),
+    MovedAttribute("map", "itertools", "builtins", "imap", "map"),
+    MovedAttribute("getcwd", "os", "os", "getcwdu", "getcwd"),
+    MovedAttribute("getcwdb", "os", "os", "getcwd", "getcwdb"),
+    MovedAttribute("getoutput", "commands", "subprocess"),
+    MovedAttribute("range", "__builtin__", "builtins", "xrange", "range"),
+    MovedAttribute(
+        "reload_module", "__builtin__", "importlib" if PY34 else "imp", "reload"
+    ),
+    MovedAttribute("reduce", "__builtin__", "functools"),
+    MovedAttribute("shlex_quote", "pipes", "shlex", "quote"),
+    MovedAttribute("StringIO", "StringIO", "io"),
+    MovedAttribute("UserDict", "UserDict", "collections"),
+    MovedAttribute("UserList", "UserList", "collections"),
+    MovedAttribute("UserString", "UserString", "collections"),
+    MovedAttribute("xrange", "__builtin__", "builtins", "xrange", "range"),
+    MovedAttribute("zip", "itertools", "builtins", "izip", "zip"),
+    MovedAttribute(
+        "zip_longest", "itertools", "itertools", "izip_longest", "zip_longest"
+    ),
+    MovedModule("builtins", "__builtin__"),
+    MovedModule("configparser", "ConfigParser"),
+    MovedModule(
+        "collections_abc",
+        "collections",
+        "collections.abc" if sys.version_info >= (3, 3) else "collections",
+    ),
+    MovedModule("copyreg", "copy_reg"),
+    MovedModule("dbm_gnu", "gdbm", "dbm.gnu"),
+    MovedModule("dbm_ndbm", "dbm", "dbm.ndbm"),
+    MovedModule(
+        "_dummy_thread",
+        "dummy_thread",
+        "_dummy_thread" if sys.version_info < (3, 9) else "_thread",
+    ),
+    MovedModule("http_cookiejar", "cookielib", "http.cookiejar"),
+    MovedModule("http_cookies", "Cookie", "http.cookies"),
+    MovedModule("html_entities", "htmlentitydefs", "html.entities"),
+    MovedModule("html_parser", "HTMLParser", "html.parser"),
+    MovedModule("http_client", "httplib", "http.client"),
+    MovedModule("email_mime_base", "email.MIMEBase", "email.mime.base"),
+    MovedModule("email_mime_image", "email.MIMEImage", "email.mime.image"),
+    MovedModule("email_mime_multipart", "email.MIMEMultipart", "email.mime.multipart"),
+    MovedModule(
+        "email_mime_nonmultipart", "email.MIMENonMultipart", "email.mime.nonmultipart"
+    ),
+    MovedModule("email_mime_text", "email.MIMEText", "email.mime.text"),
+    MovedModule("BaseHTTPServer", "BaseHTTPServer", "http.server"),
+    MovedModule("CGIHTTPServer", "CGIHTTPServer", "http.server"),
+    MovedModule("SimpleHTTPServer", "SimpleHTTPServer", "http.server"),
+    MovedModule("cPickle", "cPickle", "pickle"),
+    MovedModule("queue", "Queue"),
+    MovedModule("reprlib", "repr"),
+    MovedModule("socketserver", "SocketServer"),
+    MovedModule("_thread", "thread", "_thread"),
+    MovedModule("tkinter", "Tkinter"),
+    MovedModule("tkinter_dialog", "Dialog", "tkinter.dialog"),
+    MovedModule("tkinter_filedialog", "FileDialog", "tkinter.filedialog"),
+    MovedModule("tkinter_scrolledtext", "ScrolledText", "tkinter.scrolledtext"),
+    MovedModule("tkinter_simpledialog", "SimpleDialog", "tkinter.simpledialog"),
+    MovedModule("tkinter_tix", "Tix", "tkinter.tix"),
+    MovedModule("tkinter_ttk", "ttk", "tkinter.ttk"),
+    MovedModule("tkinter_constants", "Tkconstants", "tkinter.constants"),
+    MovedModule("tkinter_dnd", "Tkdnd", "tkinter.dnd"),
+    MovedModule("tkinter_colorchooser", "tkColorChooser", "tkinter.colorchooser"),
+    MovedModule("tkinter_commondialog", "tkCommonDialog", "tkinter.commondialog"),
+    MovedModule("tkinter_tkfiledialog", "tkFileDialog", "tkinter.filedialog"),
+    MovedModule("tkinter_font", "tkFont", "tkinter.font"),
+    MovedModule("tkinter_messagebox", "tkMessageBox", "tkinter.messagebox"),
+    MovedModule("tkinter_tksimpledialog", "tkSimpleDialog", "tkinter.simpledialog"),
+    MovedModule("urllib_parse", __name__ + ".moves.urllib_parse", "urllib.parse"),
+    MovedModule("urllib_error", __name__ + ".moves.urllib_error", "urllib.error"),
+    MovedModule("urllib", __name__ + ".moves.urllib", __name__ + ".moves.urllib"),
+    MovedModule("urllib_robotparser", "robotparser", "urllib.robotparser"),
+    MovedModule("xmlrpc_client", "xmlrpclib", "xmlrpc.client"),
+    MovedModule("xmlrpc_server", "SimpleXMLRPCServer", "xmlrpc.server"),
+]
+# Add windows specific modules.
+if sys.platform == "win32":
+    _moved_attributes += [
+        MovedModule("winreg", "_winreg"),
+    ]
+
+for attr in _moved_attributes:
+    setattr(_MovedItems, attr.name, attr)
+    if isinstance(attr, MovedModule):
+        _importer._add_module(attr, "moves." + attr.name)
+del attr
+
+_MovedItems._moved_attributes = _moved_attributes
+
+moves = _MovedItems(__name__ + ".moves")
+_importer._add_module(moves, "moves")
+
+
+class Module_six_moves_urllib_parse(_LazyModule):
+
+    """Lazy loading of moved objects in six.moves.urllib_parse"""
+
+
+_urllib_parse_moved_attributes = [
+    MovedAttribute("ParseResult", "urlparse", "urllib.parse"),
+    MovedAttribute("SplitResult", "urlparse", "urllib.parse"),
+    MovedAttribute("parse_qs", "urlparse", "urllib.parse"),
+    MovedAttribute("parse_qsl", "urlparse", "urllib.parse"),
+    MovedAttribute("urldefrag", "urlparse", "urllib.parse"),
+    MovedAttribute("urljoin", "urlparse", "urllib.parse"),
+    MovedAttribute("urlparse", "urlparse", "urllib.parse"),
+    MovedAttribute("urlsplit", "urlparse", "urllib.parse"),
+    MovedAttribute("urlunparse", "urlparse", "urllib.parse"),
+    MovedAttribute("urlunsplit", "urlparse", "urllib.parse"),
+    MovedAttribute("quote", "urllib", "urllib.parse"),
+    MovedAttribute("quote_plus", "urllib", "urllib.parse"),
+    MovedAttribute("unquote", "urllib", "urllib.parse"),
+    MovedAttribute("unquote_plus", "urllib", "urllib.parse"),
+    MovedAttribute(
+        "unquote_to_bytes", "urllib", "urllib.parse", "unquote", "unquote_to_bytes"
+    ),
+    MovedAttribute("urlencode", "urllib", "urllib.parse"),
+    MovedAttribute("splitquery", "urllib", "urllib.parse"),
+    MovedAttribute("splittag", "urllib", "urllib.parse"),
+    MovedAttribute("splituser", "urllib", "urllib.parse"),
+    MovedAttribute("splitvalue", "urllib", "urllib.parse"),
+    MovedAttribute("uses_fragment", "urlparse", "urllib.parse"),
+    MovedAttribute("uses_netloc", "urlparse", "urllib.parse"),
+    MovedAttribute("uses_params", "urlparse", "urllib.parse"),
+    MovedAttribute("uses_query", "urlparse", "urllib.parse"),
+    MovedAttribute("uses_relative", "urlparse", "urllib.parse"),
+]
+for attr in _urllib_parse_moved_attributes:
+    setattr(Module_six_moves_urllib_parse, attr.name, attr)
+del attr
+
+Module_six_moves_urllib_parse._moved_attributes = _urllib_parse_moved_attributes
+
+_importer._add_module(
+    Module_six_moves_urllib_parse(__name__ + ".moves.urllib_parse"),
+    "moves.urllib_parse",
+    "moves.urllib.parse",
+)
+
+
+class Module_six_moves_urllib_error(_LazyModule):
+
+    """Lazy loading of moved objects in six.moves.urllib_error"""
+
+
+_urllib_error_moved_attributes = [
+    MovedAttribute("URLError", "urllib2", "urllib.error"),
+    MovedAttribute("HTTPError", "urllib2", "urllib.error"),
+    MovedAttribute("ContentTooShortError", "urllib", "urllib.error"),
+]
+for attr in _urllib_error_moved_attributes:
+    setattr(Module_six_moves_urllib_error, attr.name, attr)
+del attr
+
+Module_six_moves_urllib_error._moved_attributes = _urllib_error_moved_attributes
+
+_importer._add_module(
+    Module_six_moves_urllib_error(__name__ + ".moves.urllib.error"),
+    "moves.urllib_error",
+    "moves.urllib.error",
+)
+
+
+class Module_six_moves_urllib_request(_LazyModule):
+
+    """Lazy loading of moved objects in six.moves.urllib_request"""
+
+
+_urllib_request_moved_attributes = [
+    MovedAttribute("urlopen", "urllib2", "urllib.request"),
+    MovedAttribute("install_opener", "urllib2", "urllib.request"),
+    MovedAttribute("build_opener", "urllib2", "urllib.request"),
+    MovedAttribute("pathname2url", "urllib", "urllib.request"),
+    MovedAttribute("url2pathname", "urllib", "urllib.request"),
+    MovedAttribute("getproxies", "urllib", "urllib.request"),
+    MovedAttribute("Request", "urllib2", "urllib.request"),
+    MovedAttribute("OpenerDirector", "urllib2", "urllib.request"),
+    MovedAttribute("HTTPDefaultErrorHandler", "urllib2", "urllib.request"),
+    MovedAttribute("HTTPRedirectHandler", "urllib2", "urllib.request"),
+    MovedAttribute("HTTPCookieProcessor", "urllib2", "urllib.request"),
+    MovedAttribute("ProxyHandler", "urllib2", "urllib.request"),
+    MovedAttribute("BaseHandler", "urllib2", "urllib.request"),
+    MovedAttribute("HTTPPasswordMgr", "urllib2", "urllib.request"),
+    MovedAttribute("HTTPPasswordMgrWithDefaultRealm", "urllib2", "urllib.request"),
+    MovedAttribute("AbstractBasicAuthHandler", "urllib2", "urllib.request"),
+    MovedAttribute("HTTPBasicAuthHandler", "urllib2", "urllib.request"),
+    MovedAttribute("ProxyBasicAuthHandler", "urllib2", "urllib.request"),
+    MovedAttribute("AbstractDigestAuthHandler", "urllib2", "urllib.request"),
+    MovedAttribute("HTTPDigestAuthHandler", "urllib2", "urllib.request"),
+    MovedAttribute("ProxyDigestAuthHandler", "urllib2", "urllib.request"),
+    MovedAttribute("HTTPHandler", "urllib2", "urllib.request"),
+    MovedAttribute("HTTPSHandler", "urllib2", "urllib.request"),
+    MovedAttribute("FileHandler", "urllib2", "urllib.request"),
+    MovedAttribute("FTPHandler", "urllib2", "urllib.request"),
+    MovedAttribute("CacheFTPHandler", "urllib2", "urllib.request"),
+    MovedAttribute("UnknownHandler", "urllib2", "urllib.request"),
+    MovedAttribute("HTTPErrorProcessor", "urllib2", "urllib.request"),
+    MovedAttribute("urlretrieve", "urllib", "urllib.request"),
+    MovedAttribute("urlcleanup", "urllib", "urllib.request"),
+    MovedAttribute("URLopener", "urllib", "urllib.request"),
+    MovedAttribute("FancyURLopener", "urllib", "urllib.request"),
+    MovedAttribute("proxy_bypass", "urllib", "urllib.request"),
+    MovedAttribute("parse_http_list", "urllib2", "urllib.request"),
+    MovedAttribute("parse_keqv_list", "urllib2", "urllib.request"),
+]
+for attr in _urllib_request_moved_attributes:
+    setattr(Module_six_moves_urllib_request, attr.name, attr)
+del attr
+
+Module_six_moves_urllib_request._moved_attributes = _urllib_request_moved_attributes
+
+_importer._add_module(
+    Module_six_moves_urllib_request(__name__ + ".moves.urllib.request"),
+    "moves.urllib_request",
+    "moves.urllib.request",
+)
+
+
+class Module_six_moves_urllib_response(_LazyModule):
+
+    """Lazy loading of moved objects in six.moves.urllib_response"""
+
+
+_urllib_response_moved_attributes = [
+    MovedAttribute("addbase", "urllib", "urllib.response"),
+    MovedAttribute("addclosehook", "urllib", "urllib.response"),
+    MovedAttribute("addinfo", "urllib", "urllib.response"),
+    MovedAttribute("addinfourl", "urllib", "urllib.response"),
+]
+for attr in _urllib_response_moved_attributes:
+    setattr(Module_six_moves_urllib_response, attr.name, attr)
+del attr
+
+Module_six_moves_urllib_response._moved_attributes = _urllib_response_moved_attributes
+
+_importer._add_module(
+    Module_six_moves_urllib_response(__name__ + ".moves.urllib.response"),
+    "moves.urllib_response",
+    "moves.urllib.response",
+)
+
+
+class Module_six_moves_urllib_robotparser(_LazyModule):
+
+    """Lazy loading of moved objects in six.moves.urllib_robotparser"""
+
+
+_urllib_robotparser_moved_attributes = [
+    MovedAttribute("RobotFileParser", "robotparser", "urllib.robotparser"),
+]
+for attr in _urllib_robotparser_moved_attributes:
+    setattr(Module_six_moves_urllib_robotparser, attr.name, attr)
+del attr
+
+Module_six_moves_urllib_robotparser._moved_attributes = (
+    _urllib_robotparser_moved_attributes
+)
+
+_importer._add_module(
+    Module_six_moves_urllib_robotparser(__name__ + ".moves.urllib.robotparser"),
+    "moves.urllib_robotparser",
+    "moves.urllib.robotparser",
+)
+
+
+class Module_six_moves_urllib(types.ModuleType):
+
+    """Create a six.moves.urllib namespace that resembles the Python 3 namespace"""
+
+    __path__ = []  # mark as package
+    parse = _importer._get_module("moves.urllib_parse")
+    error = _importer._get_module("moves.urllib_error")
+    request = _importer._get_module("moves.urllib_request")
+    response = _importer._get_module("moves.urllib_response")
+    robotparser = _importer._get_module("moves.urllib_robotparser")
+
+    def __dir__(self):
+        return ["parse", "error", "request", "response", "robotparser"]
+
+
+_importer._add_module(
+    Module_six_moves_urllib(__name__ + ".moves.urllib"), "moves.urllib"
+)
+
+
+def add_move(move):
+    """Add an item to six.moves."""
+    setattr(_MovedItems, move.name, move)
+
+
+def remove_move(name):
+    """Remove item from six.moves."""
+    try:
+        delattr(_MovedItems, name)
+    except AttributeError:
+        try:
+            del moves.__dict__[name]
+        except KeyError:
+            raise AttributeError("no such move, %r" % (name,))
+
+
+if PY3:
+    _meth_func = "__func__"
+    _meth_self = "__self__"
+
+    _func_closure = "__closure__"
+    _func_code = "__code__"
+    _func_defaults = "__defaults__"
+    _func_globals = "__globals__"
+else:
+    _meth_func = "im_func"
+    _meth_self = "im_self"
+
+    _func_closure = "func_closure"
+    _func_code = "func_code"
+    _func_defaults = "func_defaults"
+    _func_globals = "func_globals"
+
+
+try:
+    advance_iterator = next
+except NameError:
+
+    def advance_iterator(it):
+        return it.next()
+
+
+next = advance_iterator
+
+
+try:
+    callable = callable
+except NameError:
+
+    def callable(obj):
+        return any("__call__" in klass.__dict__ for klass in type(obj).__mro__)
+
+
+if PY3:
+
+    def get_unbound_function(unbound):
+        return unbound
+
+    create_bound_method = types.MethodType
+
+    def create_unbound_method(func, cls):
+        return func
+
+    Iterator = object
+else:
+
+    def get_unbound_function(unbound):
+        return unbound.im_func
+
+    def create_bound_method(func, obj):
+        return types.MethodType(func, obj, obj.__class__)
+
+    def create_unbound_method(func, cls):
+        return types.MethodType(func, None, cls)
+
+    class Iterator(object):
+        def next(self):
+            return type(self).__next__(self)
+
+    callable = callable
+_add_doc(
+    get_unbound_function, """Get the function out of a possibly unbound function"""
+)
+
+
+get_method_function = operator.attrgetter(_meth_func)
+get_method_self = operator.attrgetter(_meth_self)
+get_function_closure = operator.attrgetter(_func_closure)
+get_function_code = operator.attrgetter(_func_code)
+get_function_defaults = operator.attrgetter(_func_defaults)
+get_function_globals = operator.attrgetter(_func_globals)
+
+
+if PY3:
+
+    def iterkeys(d, **kw):
+        return iter(d.keys(**kw))
+
+    def itervalues(d, **kw):
+        return iter(d.values(**kw))
+
+    def iteritems(d, **kw):
+        return iter(d.items(**kw))
+
+    def iterlists(d, **kw):
+        return iter(d.lists(**kw))
+
+    viewkeys = operator.methodcaller("keys")
+
+    viewvalues = operator.methodcaller("values")
+
+    viewitems = operator.methodcaller("items")
+else:
+
+    def iterkeys(d, **kw):
+        return d.iterkeys(**kw)
+
+    def itervalues(d, **kw):
+        return d.itervalues(**kw)
+
+    def iteritems(d, **kw):
+        return d.iteritems(**kw)
+
+    def iterlists(d, **kw):
+        return d.iterlists(**kw)
+
+    viewkeys = operator.methodcaller("viewkeys")
+
+    viewvalues = operator.methodcaller("viewvalues")
+
+    viewitems = operator.methodcaller("viewitems")
+
+_add_doc(iterkeys, "Return an iterator over the keys of a dictionary.")
+_add_doc(itervalues, "Return an iterator over the values of a dictionary.")
+_add_doc(iteritems, "Return an iterator over the (key, value) pairs of a dictionary.")
+_add_doc(
+    iterlists, "Return an iterator over the (key, [values]) pairs of a dictionary."
+)
+
+
+if PY3:
+
+    def b(s):
+        return s.encode("latin-1")
+
+    def u(s):
+        return s
+
+    unichr = chr
+    import struct
+
+    int2byte = struct.Struct(">B").pack
+    del struct
+    byte2int = operator.itemgetter(0)
+    indexbytes = operator.getitem
+    iterbytes = iter
+    import io
+
+    StringIO = io.StringIO
+    BytesIO = io.BytesIO
+    del io
+    _assertCountEqual = "assertCountEqual"
+    if sys.version_info[1] <= 1:
+        _assertRaisesRegex = "assertRaisesRegexp"
+        _assertRegex = "assertRegexpMatches"
+        _assertNotRegex = "assertNotRegexpMatches"
+    else:
+        _assertRaisesRegex = "assertRaisesRegex"
+        _assertRegex = "assertRegex"
+        _assertNotRegex = "assertNotRegex"
+else:
+
+    def b(s):
+        return s
+
+    # Workaround for standalone backslash
+
+    def u(s):
+        return unicode(s.replace(r"\\", r"\\\\"), "unicode_escape")
+
+    unichr = unichr
+    int2byte = chr
+
+    def byte2int(bs):
+        return ord(bs[0])
+
+    def indexbytes(buf, i):
+        return ord(buf[i])
+
+    iterbytes = functools.partial(itertools.imap, ord)
+    import StringIO
+
+    StringIO = BytesIO = StringIO.StringIO
+    _assertCountEqual = "assertItemsEqual"
+    _assertRaisesRegex = "assertRaisesRegexp"
+    _assertRegex = "assertRegexpMatches"
+    _assertNotRegex = "assertNotRegexpMatches"
+_add_doc(b, """Byte literal""")
+_add_doc(u, """Text literal""")
+
+
+def assertCountEqual(self, *args, **kwargs):
+    return getattr(self, _assertCountEqual)(*args, **kwargs)
+
+
+def assertRaisesRegex(self, *args, **kwargs):
+    return getattr(self, _assertRaisesRegex)(*args, **kwargs)
+
+
+def assertRegex(self, *args, **kwargs):
+    return getattr(self, _assertRegex)(*args, **kwargs)
+
+
+def assertNotRegex(self, *args, **kwargs):
+    return getattr(self, _assertNotRegex)(*args, **kwargs)
+
+
+if PY3:
+    exec_ = getattr(moves.builtins, "exec")
+
+    def reraise(tp, value, tb=None):
+        try:
+            if value is None:
+                value = tp()
+            if value.__traceback__ is not tb:
+                raise value.with_traceback(tb)
+            raise value
+        finally:
+            value = None
+            tb = None
+
+else:
+
+    def exec_(_code_, _globs_=None, _locs_=None):
+        """Execute code in a namespace."""
+        if _globs_ is None:
+            frame = sys._getframe(1)
+            _globs_ = frame.f_globals
+            if _locs_ is None:
+                _locs_ = frame.f_locals
+            del frame
+        elif _locs_ is None:
+            _locs_ = _globs_
+        exec ("""exec _code_ in _globs_, _locs_""")
+
+    exec_(
+        """def reraise(tp, value, tb=None):
+    try:
+        raise tp, value, tb
+    finally:
+        tb = None
+"""
+    )
+
+
+if sys.version_info[:2] > (3,):
+    exec_(
+        """def raise_from(value, from_value):
+    try:
+        raise value from from_value
+    finally:
+        value = None
+"""
+    )
+else:
+
+    def raise_from(value, from_value):
+        raise value
+
+
+print_ = getattr(moves.builtins, "print", None)
+if print_ is None:
+
+    def print_(*args, **kwargs):
+        """The new-style print function for Python 2.4 and 2.5."""
+        fp = kwargs.pop("file", sys.stdout)
+        if fp is None:
+            return
+
+        def write(data):
+            if not isinstance(data, basestring):
+                data = str(data)
+            # If the file has an encoding, encode unicode with it.
+            if (
+                isinstance(fp, file)
+                and isinstance(data, unicode)
+                and fp.encoding is not None
+            ):
+                errors = getattr(fp, "errors", None)
+                if errors is None:
+                    errors = "strict"
+                data = data.encode(fp.encoding, errors)
+            fp.write(data)
+
+        want_unicode = False
+        sep = kwargs.pop("sep", None)
+        if sep is not None:
+            if isinstance(sep, unicode):
+                want_unicode = True
+            elif not isinstance(sep, str):
+                raise TypeError("sep must be None or a string")
+        end = kwargs.pop("end", None)
+        if end is not None:
+            if isinstance(end, unicode):
+                want_unicode = True
+            elif not isinstance(end, str):
+                raise TypeError("end must be None or a string")
+        if kwargs:
+            raise TypeError("invalid keyword arguments to print()")
+        if not want_unicode:
+            for arg in args:
+                if isinstance(arg, unicode):
+                    want_unicode = True
+                    break
+        if want_unicode:
+            newline = unicode("\n")
+            space = unicode(" ")
+        else:
+            newline = "\n"
+            space = " "
+        if sep is None:
+            sep = space
+        if end is None:
+            end = newline
+        for i, arg in enumerate(args):
+            if i:
+                write(sep)
+            write(arg)
+        write(end)
+
+
+if sys.version_info[:2] < (3, 3):
+    _print = print_
+
+    def print_(*args, **kwargs):
+        fp = kwargs.get("file", sys.stdout)
+        flush = kwargs.pop("flush", False)
+        _print(*args, **kwargs)
+        if flush and fp is not None:
+            fp.flush()
+
+
+_add_doc(reraise, """Reraise an exception.""")
+
+if sys.version_info[0:2] < (3, 4):
+    # This does exactly the same what the :func:`py3:functools.update_wrapper`
+    # function does on Python versions after 3.2. It sets the ``__wrapped__``
+    # attribute on ``wrapper`` object and it doesn't raise an error if any of
+    # the attributes mentioned in ``assigned`` and ``updated`` are missing on
+    # ``wrapped`` object.
+    def _update_wrapper(
+        wrapper,
+        wrapped,
+        assigned=functools.WRAPPER_ASSIGNMENTS,
+        updated=functools.WRAPPER_UPDATES,
+    ):
+        for attr in assigned:
+            try:
+                value = getattr(wrapped, attr)
+            except AttributeError:
+                continue
+            else:
+                setattr(wrapper, attr, value)
+        for attr in updated:
+            getattr(wrapper, attr).update(getattr(wrapped, attr, {}))
+        wrapper.__wrapped__ = wrapped
+        return wrapper
+
+    _update_wrapper.__doc__ = functools.update_wrapper.__doc__
+
+    def wraps(
+        wrapped,
+        assigned=functools.WRAPPER_ASSIGNMENTS,
+        updated=functools.WRAPPER_UPDATES,
+    ):
+        return functools.partial(
+            _update_wrapper, wrapped=wrapped, assigned=assigned, updated=updated
+        )
+
+    wraps.__doc__ = functools.wraps.__doc__
+
+else:
+    wraps = functools.wraps
+
+
+def with_metaclass(meta, *bases):
+    """Create a base class with a metaclass."""
+    # This requires a bit of explanation: the basic idea is to make a dummy
+    # metaclass for one level of class instantiation that replaces itself with
+    # the actual metaclass.
+    class metaclass(type):
+        def __new__(cls, name, this_bases, d):
+            if sys.version_info[:2] >= (3, 7):
+                # This version introduced PEP 560 that requires a bit
+                # of extra care (we mimic what is done by __build_class__).
+                resolved_bases = types.resolve_bases(bases)
+                if resolved_bases is not bases:
+                    d["__orig_bases__"] = bases
+            else:
+                resolved_bases = bases
+            return meta(name, resolved_bases, d)
+
+        @classmethod
+        def __prepare__(cls, name, this_bases):
+            return meta.__prepare__(name, bases)
+
+    return type.__new__(metaclass, "temporary_class", (), {})
+
+
+def add_metaclass(metaclass):
+    """Class decorator for creating a class with a metaclass."""
+
+    def wrapper(cls):
+        orig_vars = cls.__dict__.copy()
+        slots = orig_vars.get("__slots__")
+        if slots is not None:
+            if isinstance(slots, str):
+                slots = [slots]
+            for slots_var in slots:
+                orig_vars.pop(slots_var)
+        orig_vars.pop("__dict__", None)
+        orig_vars.pop("__weakref__", None)
+        if hasattr(cls, "__qualname__"):
+            orig_vars["__qualname__"] = cls.__qualname__
+        return metaclass(cls.__name__, cls.__bases__, orig_vars)
+
+    return wrapper
+
+
+def ensure_binary(s, encoding="utf-8", errors="strict"):
+    """Coerce **s** to six.binary_type.
+
+    For Python 2:
+      - `unicode` -> encoded to `str`
+      - `str` -> `str`
+
+    For Python 3:
+      - `str` -> encoded to `bytes`
+      - `bytes` -> `bytes`
+    """
+    if isinstance(s, binary_type):
+        return s
+    if isinstance(s, text_type):
+        return s.encode(encoding, errors)
+    raise TypeError("not expecting type '%s'" % type(s))
+
+
+def ensure_str(s, encoding="utf-8", errors="strict"):
+    """Coerce *s* to `str`.
+
+    For Python 2:
+      - `unicode` -> encoded to `str`
+      - `str` -> `str`
+
+    For Python 3:
+      - `str` -> `str`
+      - `bytes` -> decoded to `str`
+    """
+    # Optimization: Fast return for the common case.
+    if type(s) is str:
+        return s
+    if PY2 and isinstance(s, text_type):
+        return s.encode(encoding, errors)
+    elif PY3 and isinstance(s, binary_type):
+        return s.decode(encoding, errors)
+    elif not isinstance(s, (text_type, binary_type)):
+        raise TypeError("not expecting type '%s'" % type(s))
+    return s
+
+
+def ensure_text(s, encoding="utf-8", errors="strict"):
+    """Coerce *s* to six.text_type.
+
+    For Python 2:
+      - `unicode` -> `unicode`
+      - `str` -> `unicode`
+
+    For Python 3:
+      - `str` -> `str`
+      - `bytes` -> decoded to `str`
+    """
+    if isinstance(s, binary_type):
+        return s.decode(encoding, errors)
+    elif isinstance(s, text_type):
+        return s
+    else:
+        raise TypeError("not expecting type '%s'" % type(s))
+
+
+def python_2_unicode_compatible(klass):
+    """
+    A class decorator that defines __unicode__ and __str__ methods under Python 2.
+    Under Python 3 it does nothing.
+
+    To support Python 2 and 3 with a single code base, define a __str__ method
+    returning text and apply this decorator to the class.
+    """
+    if PY2:
+        if "__str__" not in klass.__dict__:
+            raise ValueError(
+                "@python_2_unicode_compatible cannot be applied "
+                "to %s because it doesn't define __str__()." % klass.__name__
+            )
+        klass.__unicode__ = klass.__str__
+        klass.__str__ = lambda self: self.__unicode__().encode("utf-8")
+    return klass
+
+
+# Complete the moves implementation.
+# This code is at the end of this module to speed up module loading.
+# Turn this module into a package.
+__path__ = []  # required for PEP 302 and PEP 451
+__package__ = __name__  # see PEP 366 @ReservedAssignment
+if globals().get("__spec__") is not None:
+    __spec__.submodule_search_locations = []  # PEP 451 @UndefinedVariable
+# Remove other six meta path importers, since they cause problems. This can
+# happen if six is removed from sys.modules and then reloaded. (Setuptools does
+# this for some reason.)
+if sys.meta_path:
+    for i, importer in enumerate(sys.meta_path):
+        # Here's some real nastiness: Another "instance" of the six module might
+        # be floating around. Therefore, we can't use isinstance() to check for
+        # the six meta path importer, since the other six instance will have
+        # inserted an importer with different class.
+        if (
+            type(importer).__name__ == "_SixMetaPathImporter"
+            and importer.name == __name__
+        ):
+            del sys.meta_path[i]
+            break
+    del i, importer
+# Finally, add the importer to the meta path import hook.
+sys.meta_path.append(_importer)
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/poolmanager.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/poolmanager.py
new file mode 100644
index 0000000..fb51bf7
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/poolmanager.py
@@ -0,0 +1,540 @@
+from __future__ import absolute_import
+
+import collections
+import functools
+import logging
+
+from ._collections import HTTPHeaderDict, RecentlyUsedContainer
+from .connectionpool import HTTPConnectionPool, HTTPSConnectionPool, port_by_scheme
+from .exceptions import (
+    LocationValueError,
+    MaxRetryError,
+    ProxySchemeUnknown,
+    ProxySchemeUnsupported,
+    URLSchemeUnknown,
+)
+from .packages import six
+from .packages.six.moves.urllib.parse import urljoin
+from .request import RequestMethods
+from .util.proxy import connection_requires_http_tunnel
+from .util.retry import Retry
+from .util.url import parse_url
+
+__all__ = ["PoolManager", "ProxyManager", "proxy_from_url"]
+
+
+log = logging.getLogger(__name__)
+
+SSL_KEYWORDS = (
+    "key_file",
+    "cert_file",
+    "cert_reqs",
+    "ca_certs",
+    "ssl_version",
+    "ca_cert_dir",
+    "ssl_context",
+    "key_password",
+    "server_hostname",
+)
+
+# All known keyword arguments that could be provided to the pool manager, its
+# pools, or the underlying connections. This is used to construct a pool key.
+_key_fields = (
+    "key_scheme",  # str
+    "key_host",  # str
+    "key_port",  # int
+    "key_timeout",  # int or float or Timeout
+    "key_retries",  # int or Retry
+    "key_strict",  # bool
+    "key_block",  # bool
+    "key_source_address",  # str
+    "key_key_file",  # str
+    "key_key_password",  # str
+    "key_cert_file",  # str
+    "key_cert_reqs",  # str
+    "key_ca_certs",  # str
+    "key_ssl_version",  # str
+    "key_ca_cert_dir",  # str
+    "key_ssl_context",  # instance of ssl.SSLContext or urllib3.util.ssl_.SSLContext
+    "key_maxsize",  # int
+    "key_headers",  # dict
+    "key__proxy",  # parsed proxy url
+    "key__proxy_headers",  # dict
+    "key__proxy_config",  # class
+    "key_socket_options",  # list of (level (int), optname (int), value (int or str)) tuples
+    "key__socks_options",  # dict
+    "key_assert_hostname",  # bool or string
+    "key_assert_fingerprint",  # str
+    "key_server_hostname",  # str
+)
+
+#: The namedtuple class used to construct keys for the connection pool.
+#: All custom key schemes should include the fields in this key at a minimum.
+PoolKey = collections.namedtuple("PoolKey", _key_fields)
+
+_proxy_config_fields = ("ssl_context", "use_forwarding_for_https")
+ProxyConfig = collections.namedtuple("ProxyConfig", _proxy_config_fields)
+
+
+def _default_key_normalizer(key_class, request_context):
+    """
+    Create a pool key out of a request context dictionary.
+
+    According to RFC 3986, both the scheme and host are case-insensitive.
+    Therefore, this function normalizes both before constructing the pool
+    key for an HTTPS request. If you wish to change this behaviour, provide
+    alternate callables to ``key_fn_by_scheme``.
+
+    :param key_class:
+        The class to use when constructing the key. This should be a namedtuple
+        with the ``scheme`` and ``host`` keys at a minimum.
+    :type  key_class: namedtuple
+    :param request_context:
+        A dictionary-like object that contain the context for a request.
+    :type  request_context: dict
+
+    :return: A namedtuple that can be used as a connection pool key.
+    :rtype:  PoolKey
+    """
+    # Since we mutate the dictionary, make a copy first
+    context = request_context.copy()
+    context["scheme"] = context["scheme"].lower()
+    context["host"] = context["host"].lower()
+
+    # These are both dictionaries and need to be transformed into frozensets
+    for key in ("headers", "_proxy_headers", "_socks_options"):
+        if key in context and context[key] is not None:
+            context[key] = frozenset(context[key].items())
+
+    # The socket_options key may be a list and needs to be transformed into a
+    # tuple.
+    socket_opts = context.get("socket_options")
+    if socket_opts is not None:
+        context["socket_options"] = tuple(socket_opts)
+
+    # Map the kwargs to the names in the namedtuple - this is necessary since
+    # namedtuples can't have fields starting with '_'.
+    for key in list(context.keys()):
+        context["key_" + key] = context.pop(key)
+
+    # Default to ``None`` for keys missing from the context
+    for field in key_class._fields:
+        if field not in context:
+            context[field] = None
+
+    return key_class(**context)
+
+
+#: A dictionary that maps a scheme to a callable that creates a pool key.
+#: This can be used to alter the way pool keys are constructed, if desired.
+#: Each PoolManager makes a copy of this dictionary so they can be configured
+#: globally here, or individually on the instance.
+key_fn_by_scheme = {
+    "http": functools.partial(_default_key_normalizer, PoolKey),
+    "https": functools.partial(_default_key_normalizer, PoolKey),
+}
+
+pool_classes_by_scheme = {"http": HTTPConnectionPool, "https": HTTPSConnectionPool}
+
+
+class PoolManager(RequestMethods):
+    """
+    Allows for arbitrary requests while transparently keeping track of
+    necessary connection pools for you.
+
+    :param num_pools:
+        Number of connection pools to cache before discarding the least
+        recently used pool.
+
+    :param headers:
+        Headers to include with all requests, unless other headers are given
+        explicitly.
+
+    :param \\**connection_pool_kw:
+        Additional parameters are used to create fresh
+        :class:`urllib3.connectionpool.ConnectionPool` instances.
+
+    Example::
+
+        >>> manager = PoolManager(num_pools=2)
+        >>> r = manager.request('GET', 'http://google.com/')
+        >>> r = manager.request('GET', 'http://google.com/mail')
+        >>> r = manager.request('GET', 'http://yahoo.com/')
+        >>> len(manager.pools)
+        2
+
+    """
+
+    proxy = None
+    proxy_config = None
+
+    def __init__(self, num_pools=10, headers=None, **connection_pool_kw):
+        RequestMethods.__init__(self, headers)
+        self.connection_pool_kw = connection_pool_kw
+        self.pools = RecentlyUsedContainer(num_pools)
+
+        # Locally set the pool classes and keys so other PoolManagers can
+        # override them.
+        self.pool_classes_by_scheme = pool_classes_by_scheme
+        self.key_fn_by_scheme = key_fn_by_scheme.copy()
+
+    def __enter__(self):
+        return self
+
+    def __exit__(self, exc_type, exc_val, exc_tb):
+        self.clear()
+        # Return False to re-raise any potential exceptions
+        return False
+
+    def _new_pool(self, scheme, host, port, request_context=None):
+        """
+        Create a new :class:`urllib3.connectionpool.ConnectionPool` based on host, port, scheme, and
+        any additional pool keyword arguments.
+
+        If ``request_context`` is provided, it is provided as keyword arguments
+        to the pool class used. This method is used to actually create the
+        connection pools handed out by :meth:`connection_from_url` and
+        companion methods. It is intended to be overridden for customization.
+        """
+        pool_cls = self.pool_classes_by_scheme[scheme]
+        if request_context is None:
+            request_context = self.connection_pool_kw.copy()
+
+        # Although the context has everything necessary to create the pool,
+        # this function has historically only used the scheme, host, and port
+        # in the positional args. When an API change is acceptable these can
+        # be removed.
+        for key in ("scheme", "host", "port"):
+            request_context.pop(key, None)
+
+        if scheme == "http":
+            for kw in SSL_KEYWORDS:
+                request_context.pop(kw, None)
+
+        return pool_cls(host, port, **request_context)
+
+    def clear(self):
+        """
+        Empty our store of pools and direct them all to close.
+
+        This will not affect in-flight connections, but they will not be
+        re-used after completion.
+        """
+        self.pools.clear()
+
+    def connection_from_host(self, host, port=None, scheme="http", pool_kwargs=None):
+        """
+        Get a :class:`urllib3.connectionpool.ConnectionPool` based on the host, port, and scheme.
+
+        If ``port`` isn't given, it will be derived from the ``scheme`` using
+        ``urllib3.connectionpool.port_by_scheme``. If ``pool_kwargs`` is
+        provided, it is merged with the instance's ``connection_pool_kw``
+        variable and used to create the new connection pool, if one is
+        needed.
+        """
+
+        if not host:
+            raise LocationValueError("No host specified.")
+
+        request_context = self._merge_pool_kwargs(pool_kwargs)
+        request_context["scheme"] = scheme or "http"
+        if not port:
+            port = port_by_scheme.get(request_context["scheme"].lower(), 80)
+        request_context["port"] = port
+        request_context["host"] = host
+
+        return self.connection_from_context(request_context)
+
+    def connection_from_context(self, request_context):
+        """
+        Get a :class:`urllib3.connectionpool.ConnectionPool` based on the request context.
+
+        ``request_context`` must at least contain the ``scheme`` key and its
+        value must be a key in ``key_fn_by_scheme`` instance variable.
+        """
+        scheme = request_context["scheme"].lower()
+        pool_key_constructor = self.key_fn_by_scheme.get(scheme)
+        if not pool_key_constructor:
+            raise URLSchemeUnknown(scheme)
+        pool_key = pool_key_constructor(request_context)
+
+        return self.connection_from_pool_key(pool_key, request_context=request_context)
+
+    def connection_from_pool_key(self, pool_key, request_context=None):
+        """
+        Get a :class:`urllib3.connectionpool.ConnectionPool` based on the provided pool key.
+
+        ``pool_key`` should be a namedtuple that only contains immutable
+        objects. At a minimum it must have the ``scheme``, ``host``, and
+        ``port`` fields.
+        """
+        with self.pools.lock:
+            # If the scheme, host, or port doesn't match existing open
+            # connections, open a new ConnectionPool.
+            pool = self.pools.get(pool_key)
+            if pool:
+                return pool
+
+            # Make a fresh ConnectionPool of the desired type
+            scheme = request_context["scheme"]
+            host = request_context["host"]
+            port = request_context["port"]
+            pool = self._new_pool(scheme, host, port, request_context=request_context)
+            self.pools[pool_key] = pool
+
+        return pool
+
+    def connection_from_url(self, url, pool_kwargs=None):
+        """
+        Similar to :func:`urllib3.connectionpool.connection_from_url`.
+
+        If ``pool_kwargs`` is not provided and a new pool needs to be
+        constructed, ``self.connection_pool_kw`` is used to initialize
+        the :class:`urllib3.connectionpool.ConnectionPool`. If ``pool_kwargs``
+        is provided, it is used instead. Note that if a new pool does not
+        need to be created for the request, the provided ``pool_kwargs`` are
+        not used.
+        """
+        u = parse_url(url)
+        return self.connection_from_host(
+            u.host, port=u.port, scheme=u.scheme, pool_kwargs=pool_kwargs
+        )
+
+    def _merge_pool_kwargs(self, override):
+        """
+        Merge a dictionary of override values for self.connection_pool_kw.
+
+        This does not modify self.connection_pool_kw and returns a new dict.
+        Any keys in the override dictionary with a value of ``None`` are
+        removed from the merged dictionary.
+        """
+        base_pool_kwargs = self.connection_pool_kw.copy()
+        if override:
+            for key, value in override.items():
+                if value is None:
+                    try:
+                        del base_pool_kwargs[key]
+                    except KeyError:
+                        pass
+                else:
+                    base_pool_kwargs[key] = value
+        return base_pool_kwargs
+
+    def _proxy_requires_url_absolute_form(self, parsed_url):
+        """
+        Indicates if the proxy requires the complete destination URL in the
+        request.  Normally this is only needed when not using an HTTP CONNECT
+        tunnel.
+        """
+        if self.proxy is None:
+            return False
+
+        return not connection_requires_http_tunnel(
+            self.proxy, self.proxy_config, parsed_url.scheme
+        )
+
+    def _validate_proxy_scheme_url_selection(self, url_scheme):
+        """
+        Validates that were not attempting to do TLS in TLS connections on
+        Python2 or with unsupported SSL implementations.
+        """
+        if self.proxy is None or url_scheme != "https":
+            return
+
+        if self.proxy.scheme != "https":
+            return
+
+        if six.PY2 and not self.proxy_config.use_forwarding_for_https:
+            raise ProxySchemeUnsupported(
+                "Contacting HTTPS destinations through HTTPS proxies "
+                "'via CONNECT tunnels' is not supported in Python 2"
+            )
+
+    def urlopen(self, method, url, redirect=True, **kw):
+        """
+        Same as :meth:`urllib3.HTTPConnectionPool.urlopen`
+        with custom cross-host redirect logic and only sends the request-uri
+        portion of the ``url``.
+
+        The given ``url`` parameter must be absolute, such that an appropriate
+        :class:`urllib3.connectionpool.ConnectionPool` can be chosen for it.
+        """
+        u = parse_url(url)
+        self._validate_proxy_scheme_url_selection(u.scheme)
+
+        conn = self.connection_from_host(u.host, port=u.port, scheme=u.scheme)
+
+        kw["assert_same_host"] = False
+        kw["redirect"] = False
+
+        if "headers" not in kw:
+            kw["headers"] = self.headers.copy()
+
+        if self._proxy_requires_url_absolute_form(u):
+            response = conn.urlopen(method, url, **kw)
+        else:
+            response = conn.urlopen(method, u.request_uri, **kw)
+
+        redirect_location = redirect and response.get_redirect_location()
+        if not redirect_location:
+            return response
+
+        # Support relative URLs for redirecting.
+        redirect_location = urljoin(url, redirect_location)
+
+        if response.status == 303:
+            # Change the method according to RFC 9110, Section 15.4.4.
+            method = "GET"
+            # And lose the body not to transfer anything sensitive.
+            kw["body"] = None
+            kw["headers"] = HTTPHeaderDict(kw["headers"])._prepare_for_method_change()
+
+        retries = kw.get("retries")
+        if not isinstance(retries, Retry):
+            retries = Retry.from_int(retries, redirect=redirect)
+
+        # Strip headers marked as unsafe to forward to the redirected location.
+        # Check remove_headers_on_redirect to avoid a potential network call within
+        # conn.is_same_host() which may use socket.gethostbyname() in the future.
+        if retries.remove_headers_on_redirect and not conn.is_same_host(
+            redirect_location
+        ):
+            headers = list(six.iterkeys(kw["headers"]))
+            for header in headers:
+                if header.lower() in retries.remove_headers_on_redirect:
+                    kw["headers"].pop(header, None)
+
+        try:
+            retries = retries.increment(method, url, response=response, _pool=conn)
+        except MaxRetryError:
+            if retries.raise_on_redirect:
+                response.drain_conn()
+                raise
+            return response
+
+        kw["retries"] = retries
+        kw["redirect"] = redirect
+
+        log.info("Redirecting %s -> %s", url, redirect_location)
+
+        response.drain_conn()
+        return self.urlopen(method, redirect_location, **kw)
+
+
+class ProxyManager(PoolManager):
+    """
+    Behaves just like :class:`PoolManager`, but sends all requests through
+    the defined proxy, using the CONNECT method for HTTPS URLs.
+
+    :param proxy_url:
+        The URL of the proxy to be used.
+
+    :param proxy_headers:
+        A dictionary containing headers that will be sent to the proxy. In case
+        of HTTP they are being sent with each request, while in the
+        HTTPS/CONNECT case they are sent only once. Could be used for proxy
+        authentication.
+
+    :param proxy_ssl_context:
+        The proxy SSL context is used to establish the TLS connection to the
+        proxy when using HTTPS proxies.
+
+    :param use_forwarding_for_https:
+        (Defaults to False) If set to True will forward requests to the HTTPS
+        proxy to be made on behalf of the client instead of creating a TLS
+        tunnel via the CONNECT method. **Enabling this flag means that request
+        and response headers and content will be visible from the HTTPS proxy**
+        whereas tunneling keeps request and response headers and content
+        private.  IP address, target hostname, SNI, and port are always visible
+        to an HTTPS proxy even when this flag is disabled.
+
+    Example:
+        >>> proxy = urllib3.ProxyManager('http://localhost:3128/')
+        >>> r1 = proxy.request('GET', 'http://google.com/')
+        >>> r2 = proxy.request('GET', 'http://httpbin.org/')
+        >>> len(proxy.pools)
+        1
+        >>> r3 = proxy.request('GET', 'https://httpbin.org/')
+        >>> r4 = proxy.request('GET', 'https://twitter.com/')
+        >>> len(proxy.pools)
+        3
+
+    """
+
+    def __init__(
+        self,
+        proxy_url,
+        num_pools=10,
+        headers=None,
+        proxy_headers=None,
+        proxy_ssl_context=None,
+        use_forwarding_for_https=False,
+        **connection_pool_kw
+    ):
+
+        if isinstance(proxy_url, HTTPConnectionPool):
+            proxy_url = "%s://%s:%i" % (
+                proxy_url.scheme,
+                proxy_url.host,
+                proxy_url.port,
+            )
+        proxy = parse_url(proxy_url)
+
+        if proxy.scheme not in ("http", "https"):
+            raise ProxySchemeUnknown(proxy.scheme)
+
+        if not proxy.port:
+            port = port_by_scheme.get(proxy.scheme, 80)
+            proxy = proxy._replace(port=port)
+
+        self.proxy = proxy
+        self.proxy_headers = proxy_headers or {}
+        self.proxy_ssl_context = proxy_ssl_context
+        self.proxy_config = ProxyConfig(proxy_ssl_context, use_forwarding_for_https)
+
+        connection_pool_kw["_proxy"] = self.proxy
+        connection_pool_kw["_proxy_headers"] = self.proxy_headers
+        connection_pool_kw["_proxy_config"] = self.proxy_config
+
+        super(ProxyManager, self).__init__(num_pools, headers, **connection_pool_kw)
+
+    def connection_from_host(self, host, port=None, scheme="http", pool_kwargs=None):
+        if scheme == "https":
+            return super(ProxyManager, self).connection_from_host(
+                host, port, scheme, pool_kwargs=pool_kwargs
+            )
+
+        return super(ProxyManager, self).connection_from_host(
+            self.proxy.host, self.proxy.port, self.proxy.scheme, pool_kwargs=pool_kwargs
+        )
+
+    def _set_proxy_headers(self, url, headers=None):
+        """
+        Sets headers needed by proxies: specifically, the Accept and Host
+        headers. Only sets headers not provided by the user.
+        """
+        headers_ = {"Accept": "*/*"}
+
+        netloc = parse_url(url).netloc
+        if netloc:
+            headers_["Host"] = netloc
+
+        if headers:
+            headers_.update(headers)
+        return headers_
+
+    def urlopen(self, method, url, redirect=True, **kw):
+        "Same as HTTP(S)ConnectionPool.urlopen, ``url`` must be absolute."
+        u = parse_url(url)
+        if not connection_requires_http_tunnel(self.proxy, self.proxy_config, u.scheme):
+            # For connections using HTTP CONNECT, httplib sets the necessary
+            # headers on the CONNECT to the proxy. If we're not using CONNECT,
+            # we'll definitely need to set 'Host' at the very least.
+            headers = kw.get("headers", self.headers)
+            kw["headers"] = self._set_proxy_headers(url, headers)
+
+        return super(ProxyManager, self).urlopen(method, url, redirect=redirect, **kw)
+
+
+def proxy_from_url(url, **kw):
+    return ProxyManager(proxy_url=url, **kw)
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/request.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/request.py
new file mode 100644
index 0000000..3b4cf99
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/request.py
@@ -0,0 +1,191 @@
+from __future__ import absolute_import
+
+import sys
+
+from .filepost import encode_multipart_formdata
+from .packages import six
+from .packages.six.moves.urllib.parse import urlencode
+
+__all__ = ["RequestMethods"]
+
+
+class RequestMethods(object):
+    """
+    Convenience mixin for classes who implement a :meth:`urlopen` method, such
+    as :class:`urllib3.HTTPConnectionPool` and
+    :class:`urllib3.PoolManager`.
+
+    Provides behavior for making common types of HTTP request methods and
+    decides which type of request field encoding to use.
+
+    Specifically,
+
+    :meth:`.request_encode_url` is for sending requests whose fields are
+    encoded in the URL (such as GET, HEAD, DELETE).
+
+    :meth:`.request_encode_body` is for sending requests whose fields are
+    encoded in the *body* of the request using multipart or www-form-urlencoded
+    (such as for POST, PUT, PATCH).
+
+    :meth:`.request` is for making any kind of request, it will look up the
+    appropriate encoding format and use one of the above two methods to make
+    the request.
+
+    Initializer parameters:
+
+    :param headers:
+        Headers to include with all requests, unless other headers are given
+        explicitly.
+    """
+
+    _encode_url_methods = {"DELETE", "GET", "HEAD", "OPTIONS"}
+
+    def __init__(self, headers=None):
+        self.headers = headers or {}
+
+    def urlopen(
+        self,
+        method,
+        url,
+        body=None,
+        headers=None,
+        encode_multipart=True,
+        multipart_boundary=None,
+        **kw
+    ):  # Abstract
+        raise NotImplementedError(
+            "Classes extending RequestMethods must implement "
+            "their own ``urlopen`` method."
+        )
+
+    def request(self, method, url, fields=None, headers=None, **urlopen_kw):
+        """
+        Make a request using :meth:`urlopen` with the appropriate encoding of
+        ``fields`` based on the ``method`` used.
+
+        This is a convenience method that requires the least amount of manual
+        effort. It can be used in most situations, while still having the
+        option to drop down to more specific methods when necessary, such as
+        :meth:`request_encode_url`, :meth:`request_encode_body`,
+        or even the lowest level :meth:`urlopen`.
+        """
+        method = method.upper()
+
+        urlopen_kw["request_url"] = url
+
+        if method in self._encode_url_methods:
+            return self.request_encode_url(
+                method, url, fields=fields, headers=headers, **urlopen_kw
+            )
+        else:
+            return self.request_encode_body(
+                method, url, fields=fields, headers=headers, **urlopen_kw
+            )
+
+    def request_encode_url(self, method, url, fields=None, headers=None, **urlopen_kw):
+        """
+        Make a request using :meth:`urlopen` with the ``fields`` encoded in
+        the url. This is useful for request methods like GET, HEAD, DELETE, etc.
+        """
+        if headers is None:
+            headers = self.headers
+
+        extra_kw = {"headers": headers}
+        extra_kw.update(urlopen_kw)
+
+        if fields:
+            url += "?" + urlencode(fields)
+
+        return self.urlopen(method, url, **extra_kw)
+
+    def request_encode_body(
+        self,
+        method,
+        url,
+        fields=None,
+        headers=None,
+        encode_multipart=True,
+        multipart_boundary=None,
+        **urlopen_kw
+    ):
+        """
+        Make a request using :meth:`urlopen` with the ``fields`` encoded in
+        the body. This is useful for request methods like POST, PUT, PATCH, etc.
+
+        When ``encode_multipart=True`` (default), then
+        :func:`urllib3.encode_multipart_formdata` is used to encode
+        the payload with the appropriate content type. Otherwise
+        :func:`urllib.parse.urlencode` is used with the
+        'application/x-www-form-urlencoded' content type.
+
+        Multipart encoding must be used when posting files, and it's reasonably
+        safe to use it in other times too. However, it may break request
+        signing, such as with OAuth.
+
+        Supports an optional ``fields`` parameter of key/value strings AND
+        key/filetuple. A filetuple is a (filename, data, MIME type) tuple where
+        the MIME type is optional. For example::
+
+            fields = {
+                'foo': 'bar',
+                'fakefile': ('foofile.txt', 'contents of foofile'),
+                'realfile': ('barfile.txt', open('realfile').read()),
+                'typedfile': ('bazfile.bin', open('bazfile').read(),
+                              'image/jpeg'),
+                'nonamefile': 'contents of nonamefile field',
+            }
+
+        When uploading a file, providing a filename (the first parameter of the
+        tuple) is optional but recommended to best mimic behavior of browsers.
+
+        Note that if ``headers`` are supplied, the 'Content-Type' header will
+        be overwritten because it depends on the dynamic random boundary string
+        which is used to compose the body of the request. The random boundary
+        string can be explicitly set with the ``multipart_boundary`` parameter.
+        """
+        if headers is None:
+            headers = self.headers
+
+        extra_kw = {"headers": {}}
+
+        if fields:
+            if "body" in urlopen_kw:
+                raise TypeError(
+                    "request got values for both 'fields' and 'body', can only specify one."
+                )
+
+            if encode_multipart:
+                body, content_type = encode_multipart_formdata(
+                    fields, boundary=multipart_boundary
+                )
+            else:
+                body, content_type = (
+                    urlencode(fields),
+                    "application/x-www-form-urlencoded",
+                )
+
+            extra_kw["body"] = body
+            extra_kw["headers"] = {"Content-Type": content_type}
+
+        extra_kw["headers"].update(headers)
+        extra_kw.update(urlopen_kw)
+
+        return self.urlopen(method, url, **extra_kw)
+
+
+if not six.PY2:
+
+    class RequestModule(sys.modules[__name__].__class__):
+        def __call__(self, *args, **kwargs):
+            """
+            If user tries to call this module directly urllib3 v2.x style raise an error to the user
+            suggesting they may need urllib3 v2
+            """
+            raise TypeError(
+                "'module' object is not callable\n"
+                "urllib3.request() method is not supported in this release, "
+                "upgrade to urllib3 v2 to use it\n"
+                "see https://urllib3.readthedocs.io/en/stable/v2-migration-guide.html"
+            )
+
+    sys.modules[__name__].__class__ = RequestModule
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/response.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/response.py
new file mode 100644
index 0000000..8909f84
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/response.py
@@ -0,0 +1,879 @@
+from __future__ import absolute_import
+
+import io
+import logging
+import sys
+import warnings
+import zlib
+from contextlib import contextmanager
+from socket import error as SocketError
+from socket import timeout as SocketTimeout
+
+brotli = None
+
+from . import util
+from ._collections import HTTPHeaderDict
+from .connection import BaseSSLError, HTTPException
+from .exceptions import (
+    BodyNotHttplibCompatible,
+    DecodeError,
+    HTTPError,
+    IncompleteRead,
+    InvalidChunkLength,
+    InvalidHeader,
+    ProtocolError,
+    ReadTimeoutError,
+    ResponseNotChunked,
+    SSLError,
+)
+from .packages import six
+from .util.response import is_fp_closed, is_response_to_head
+
+log = logging.getLogger(__name__)
+
+
+class DeflateDecoder(object):
+    def __init__(self):
+        self._first_try = True
+        self._data = b""
+        self._obj = zlib.decompressobj()
+
+    def __getattr__(self, name):
+        return getattr(self._obj, name)
+
+    def decompress(self, data):
+        if not data:
+            return data
+
+        if not self._first_try:
+            return self._obj.decompress(data)
+
+        self._data += data
+        try:
+            decompressed = self._obj.decompress(data)
+            if decompressed:
+                self._first_try = False
+                self._data = None
+            return decompressed
+        except zlib.error:
+            self._first_try = False
+            self._obj = zlib.decompressobj(-zlib.MAX_WBITS)
+            try:
+                return self.decompress(self._data)
+            finally:
+                self._data = None
+
+
+class GzipDecoderState(object):
+
+    FIRST_MEMBER = 0
+    OTHER_MEMBERS = 1
+    SWALLOW_DATA = 2
+
+
+class GzipDecoder(object):
+    def __init__(self):
+        self._obj = zlib.decompressobj(16 + zlib.MAX_WBITS)
+        self._state = GzipDecoderState.FIRST_MEMBER
+
+    def __getattr__(self, name):
+        return getattr(self._obj, name)
+
+    def decompress(self, data):
+        ret = bytearray()
+        if self._state == GzipDecoderState.SWALLOW_DATA or not data:
+            return bytes(ret)
+        while True:
+            try:
+                ret += self._obj.decompress(data)
+            except zlib.error:
+                previous_state = self._state
+                # Ignore data after the first error
+                self._state = GzipDecoderState.SWALLOW_DATA
+                if previous_state == GzipDecoderState.OTHER_MEMBERS:
+                    # Allow trailing garbage acceptable in other gzip clients
+                    return bytes(ret)
+                raise
+            data = self._obj.unused_data
+            if not data:
+                return bytes(ret)
+            self._state = GzipDecoderState.OTHER_MEMBERS
+            self._obj = zlib.decompressobj(16 + zlib.MAX_WBITS)
+
+
+if brotli is not None:
+
+    class BrotliDecoder(object):
+        # Supports both 'brotlipy' and 'Brotli' packages
+        # since they share an import name. The top branches
+        # are for 'brotlipy' and bottom branches for 'Brotli'
+        def __init__(self):
+            self._obj = brotli.Decompressor()
+            if hasattr(self._obj, "decompress"):
+                self.decompress = self._obj.decompress
+            else:
+                self.decompress = self._obj.process
+
+        def flush(self):
+            if hasattr(self._obj, "flush"):
+                return self._obj.flush()
+            return b""
+
+
+class MultiDecoder(object):
+    """
+    From RFC7231:
+        If one or more encodings have been applied to a representation, the
+        sender that applied the encodings MUST generate a Content-Encoding
+        header field that lists the content codings in the order in which
+        they were applied.
+    """
+
+    def __init__(self, modes):
+        self._decoders = [_get_decoder(m.strip()) for m in modes.split(",")]
+
+    def flush(self):
+        return self._decoders[0].flush()
+
+    def decompress(self, data):
+        for d in reversed(self._decoders):
+            data = d.decompress(data)
+        return data
+
+
+def _get_decoder(mode):
+    if "," in mode:
+        return MultiDecoder(mode)
+
+    if mode == "gzip":
+        return GzipDecoder()
+
+    if brotli is not None and mode == "br":
+        return BrotliDecoder()
+
+    return DeflateDecoder()
+
+
+class HTTPResponse(io.IOBase):
+    """
+    HTTP Response container.
+
+    Backwards-compatible with :class:`http.client.HTTPResponse` but the response ``body`` is
+    loaded and decoded on-demand when the ``data`` property is accessed.  This
+    class is also compatible with the Python standard library's :mod:`io`
+    module, and can hence be treated as a readable object in the context of that
+    framework.
+
+    Extra parameters for behaviour not present in :class:`http.client.HTTPResponse`:
+
+    :param preload_content:
+        If True, the response's body will be preloaded during construction.
+
+    :param decode_content:
+        If True, will attempt to decode the body based on the
+        'content-encoding' header.
+
+    :param original_response:
+        When this HTTPResponse wrapper is generated from an :class:`http.client.HTTPResponse`
+        object, it's convenient to include the original for debug purposes. It's
+        otherwise unused.
+
+    :param retries:
+        The retries contains the last :class:`~urllib3.util.retry.Retry` that
+        was used during the request.
+
+    :param enforce_content_length:
+        Enforce content length checking. Body returned by server must match
+        value of Content-Length header, if present. Otherwise, raise error.
+    """
+
+    CONTENT_DECODERS = ["gzip", "deflate"]
+    if brotli is not None:
+        CONTENT_DECODERS += ["br"]
+    REDIRECT_STATUSES = [301, 302, 303, 307, 308]
+
+    def __init__(
+        self,
+        body="",
+        headers=None,
+        status=0,
+        version=0,
+        reason=None,
+        strict=0,
+        preload_content=True,
+        decode_content=True,
+        original_response=None,
+        pool=None,
+        connection=None,
+        msg=None,
+        retries=None,
+        enforce_content_length=False,
+        request_method=None,
+        request_url=None,
+        auto_close=True,
+    ):
+
+        if isinstance(headers, HTTPHeaderDict):
+            self.headers = headers
+        else:
+            self.headers = HTTPHeaderDict(headers)
+        self.status = status
+        self.version = version
+        self.reason = reason
+        self.strict = strict
+        self.decode_content = decode_content
+        self.retries = retries
+        self.enforce_content_length = enforce_content_length
+        self.auto_close = auto_close
+
+        self._decoder = None
+        self._body = None
+        self._fp = None
+        self._original_response = original_response
+        self._fp_bytes_read = 0
+        self.msg = msg
+        self._request_url = request_url
+
+        if body and isinstance(body, (six.string_types, bytes)):
+            self._body = body
+
+        self._pool = pool
+        self._connection = connection
+
+        if hasattr(body, "read"):
+            self._fp = body
+
+        # Are we using the chunked-style of transfer encoding?
+        self.chunked = False
+        self.chunk_left = None
+        tr_enc = self.headers.get("transfer-encoding", "").lower()
+        # Don't incur the penalty of creating a list and then discarding it
+        encodings = (enc.strip() for enc in tr_enc.split(","))
+        if "chunked" in encodings:
+            self.chunked = True
+
+        # Determine length of response
+        self.length_remaining = self._init_length(request_method)
+
+        # If requested, preload the body.
+        if preload_content and not self._body:
+            self._body = self.read(decode_content=decode_content)
+
+    def get_redirect_location(self):
+        """
+        Should we redirect and where to?
+
+        :returns: Truthy redirect location string if we got a redirect status
+            code and valid location. ``None`` if redirect status and no
+            location. ``False`` if not a redirect status code.
+        """
+        if self.status in self.REDIRECT_STATUSES:
+            return self.headers.get("location")
+
+        return False
+
+    def release_conn(self):
+        if not self._pool or not self._connection:
+            return
+
+        self._pool._put_conn(self._connection)
+        self._connection = None
+
+    def drain_conn(self):
+        """
+        Read and discard any remaining HTTP response data in the response connection.
+
+        Unread data in the HTTPResponse connection blocks the connection from being released back to the pool.
+        """
+        try:
+            self.read()
+        except (HTTPError, SocketError, BaseSSLError, HTTPException):
+            pass
+
+    @property
+    def data(self):
+        # For backwards-compat with earlier urllib3 0.4 and earlier.
+        if self._body:
+            return self._body
+
+        if self._fp:
+            return self.read(cache_content=True)
+
+    @property
+    def connection(self):
+        return self._connection
+
+    def isclosed(self):
+        return is_fp_closed(self._fp)
+
+    def tell(self):
+        """
+        Obtain the number of bytes pulled over the wire so far. May differ from
+        the amount of content returned by :meth:``urllib3.response.HTTPResponse.read``
+        if bytes are encoded on the wire (e.g, compressed).
+        """
+        return self._fp_bytes_read
+
+    def _init_length(self, request_method):
+        """
+        Set initial length value for Response content if available.
+        """
+        length = self.headers.get("content-length")
+
+        if length is not None:
+            if self.chunked:
+                # This Response will fail with an IncompleteRead if it can't be
+                # received as chunked. This method falls back to attempt reading
+                # the response before raising an exception.
+                log.warning(
+                    "Received response with both Content-Length and "
+                    "Transfer-Encoding set. This is expressly forbidden "
+                    "by RFC 7230 sec 3.3.2. Ignoring Content-Length and "
+                    "attempting to process response as Transfer-Encoding: "
+                    "chunked."
+                )
+                return None
+
+            try:
+                # RFC 7230 section 3.3.2 specifies multiple content lengths can
+                # be sent in a single Content-Length header
+                # (e.g. Content-Length: 42, 42). This line ensures the values
+                # are all valid ints and that as long as the `set` length is 1,
+                # all values are the same. Otherwise, the header is invalid.
+                lengths = set([int(val) for val in length.split(",")])
+                if len(lengths) > 1:
+                    raise InvalidHeader(
+                        "Content-Length contained multiple "
+                        "unmatching values (%s)" % length
+                    )
+                length = lengths.pop()
+            except ValueError:
+                length = None
+            else:
+                if length < 0:
+                    length = None
+
+        # Convert status to int for comparison
+        # In some cases, httplib returns a status of "_UNKNOWN"
+        try:
+            status = int(self.status)
+        except ValueError:
+            status = 0
+
+        # Check for responses that shouldn't include a body
+        if status in (204, 304) or 100 <= status < 200 or request_method == "HEAD":
+            length = 0
+
+        return length
+
+    def _init_decoder(self):
+        """
+        Set-up the _decoder attribute if necessary.
+        """
+        # Note: content-encoding value should be case-insensitive, per RFC 7230
+        # Section 3.2
+        content_encoding = self.headers.get("content-encoding", "").lower()
+        if self._decoder is None:
+            if content_encoding in self.CONTENT_DECODERS:
+                self._decoder = _get_decoder(content_encoding)
+            elif "," in content_encoding:
+                encodings = [
+                    e.strip()
+                    for e in content_encoding.split(",")
+                    if e.strip() in self.CONTENT_DECODERS
+                ]
+                if len(encodings):
+                    self._decoder = _get_decoder(content_encoding)
+
+    DECODER_ERROR_CLASSES = (IOError, zlib.error)
+    if brotli is not None:
+        DECODER_ERROR_CLASSES += (brotli.error,)
+
+    def _decode(self, data, decode_content, flush_decoder):
+        """
+        Decode the data passed in and potentially flush the decoder.
+        """
+        if not decode_content:
+            return data
+
+        try:
+            if self._decoder:
+                data = self._decoder.decompress(data)
+        except self.DECODER_ERROR_CLASSES as e:
+            content_encoding = self.headers.get("content-encoding", "").lower()
+            raise DecodeError(
+                "Received response with content-encoding: %s, but "
+                "failed to decode it." % content_encoding,
+                e,
+            )
+        if flush_decoder:
+            data += self._flush_decoder()
+
+        return data
+
+    def _flush_decoder(self):
+        """
+        Flushes the decoder. Should only be called if the decoder is actually
+        being used.
+        """
+        if self._decoder:
+            buf = self._decoder.decompress(b"")
+            return buf + self._decoder.flush()
+
+        return b""
+
+    @contextmanager
+    def _error_catcher(self):
+        """
+        Catch low-level python exceptions, instead re-raising urllib3
+        variants, so that low-level exceptions are not leaked in the
+        high-level api.
+
+        On exit, release the connection back to the pool.
+        """
+        clean_exit = False
+
+        try:
+            try:
+                yield
+
+            except SocketTimeout:
+                # FIXME: Ideally we'd like to include the url in the ReadTimeoutError but
+                # there is yet no clean way to get at it from this context.
+                raise ReadTimeoutError(self._pool, None, "Read timed out.")
+
+            except BaseSSLError as e:
+                # FIXME: Is there a better way to differentiate between SSLErrors?
+                if "read operation timed out" not in str(e):
+                    # SSL errors related to framing/MAC get wrapped and reraised here
+                    raise SSLError(e)
+
+                raise ReadTimeoutError(self._pool, None, "Read timed out.")
+
+            except (HTTPException, SocketError) as e:
+                # This includes IncompleteRead.
+                raise ProtocolError("Connection broken: %r" % e, e)
+
+            # If no exception is thrown, we should avoid cleaning up
+            # unnecessarily.
+            clean_exit = True
+        finally:
+            # If we didn't terminate cleanly, we need to throw away our
+            # connection.
+            if not clean_exit:
+                # The response may not be closed but we're not going to use it
+                # anymore so close it now to ensure that the connection is
+                # released back to the pool.
+                if self._original_response:
+                    self._original_response.close()
+
+                # Closing the response may not actually be sufficient to close
+                # everything, so if we have a hold of the connection close that
+                # too.
+                if self._connection:
+                    self._connection.close()
+
+            # If we hold the original response but it's closed now, we should
+            # return the connection back to the pool.
+            if self._original_response and self._original_response.isclosed():
+                self.release_conn()
+
+    def _fp_read(self, amt):
+        """
+        Read a response with the thought that reading the number of bytes
+        larger than can fit in a 32-bit int at a time via SSL in some
+        known cases leads to an overflow error that has to be prevented
+        if `amt` or `self.length_remaining` indicate that a problem may
+        happen.
+
+        The known cases:
+          * 3.8 <= CPython < 3.9.7 because of a bug
+            https://github.com/urllib3/urllib3/issues/2513#issuecomment-1152559900.
+          * urllib3 injected with pyOpenSSL-backed SSL-support.
+          * CPython < 3.10 only when `amt` does not fit 32-bit int.
+        """
+        assert self._fp
+        c_int_max = 2 ** 31 - 1
+        if (
+            (
+                (amt and amt > c_int_max)
+                or (self.length_remaining and self.length_remaining > c_int_max)
+            )
+            and not util.IS_SECURETRANSPORT
+            and (util.IS_PYOPENSSL or sys.version_info < (3, 10))
+        ):
+            buffer = io.BytesIO()
+            # Besides `max_chunk_amt` being a maximum chunk size, it
+            # affects memory overhead of reading a response by this
+            # method in CPython.
+            # `c_int_max` equal to 2 GiB - 1 byte is the actual maximum
+            # chunk size that does not lead to an overflow error, but
+            # 256 MiB is a compromise.
+            max_chunk_amt = 2 ** 28
+            while amt is None or amt != 0:
+                if amt is not None:
+                    chunk_amt = min(amt, max_chunk_amt)
+                    amt -= chunk_amt
+                else:
+                    chunk_amt = max_chunk_amt
+                data = self._fp.read(chunk_amt)
+                if not data:
+                    break
+                buffer.write(data)
+                del data  # to reduce peak memory usage by `max_chunk_amt`.
+            return buffer.getvalue()
+        else:
+            # StringIO doesn't like amt=None
+            return self._fp.read(amt) if amt is not None else self._fp.read()
+
+    def read(self, amt=None, decode_content=None, cache_content=False):
+        """
+        Similar to :meth:`http.client.HTTPResponse.read`, but with two additional
+        parameters: ``decode_content`` and ``cache_content``.
+
+        :param amt:
+            How much of the content to read. If specified, caching is skipped
+            because it doesn't make sense to cache partial content as the full
+            response.
+
+        :param decode_content:
+            If True, will attempt to decode the body based on the
+            'content-encoding' header.
+
+        :param cache_content:
+            If True, will save the returned data such that the same result is
+            returned despite of the state of the underlying file object. This
+            is useful if you want the ``.data`` property to continue working
+            after having ``.read()`` the file object. (Overridden if ``amt`` is
+            set.)
+        """
+        self._init_decoder()
+        if decode_content is None:
+            decode_content = self.decode_content
+
+        if self._fp is None:
+            return
+
+        flush_decoder = False
+        fp_closed = getattr(self._fp, "closed", False)
+
+        with self._error_catcher():
+            data = self._fp_read(amt) if not fp_closed else b""
+            if amt is None:
+                flush_decoder = True
+            else:
+                cache_content = False
+                if (
+                    amt != 0 and not data
+                ):  # Platform-specific: Buggy versions of Python.
+                    # Close the connection when no data is returned
+                    #
+                    # This is redundant to what httplib/http.client _should_
+                    # already do.  However, versions of python released before
+                    # December 15, 2012 (http://bugs.python.org/issue16298) do
+                    # not properly close the connection in all cases. There is
+                    # no harm in redundantly calling close.
+                    self._fp.close()
+                    flush_decoder = True
+                    if self.enforce_content_length and self.length_remaining not in (
+                        0,
+                        None,
+                    ):
+                        # This is an edge case that httplib failed to cover due
+                        # to concerns of backward compatibility. We're
+                        # addressing it here to make sure IncompleteRead is
+                        # raised during streaming, so all calls with incorrect
+                        # Content-Length are caught.
+                        raise IncompleteRead(self._fp_bytes_read, self.length_remaining)
+
+        if data:
+            self._fp_bytes_read += len(data)
+            if self.length_remaining is not None:
+                self.length_remaining -= len(data)
+
+            data = self._decode(data, decode_content, flush_decoder)
+
+            if cache_content:
+                self._body = data
+
+        return data
+
+    def stream(self, amt=2 ** 16, decode_content=None):
+        """
+        A generator wrapper for the read() method. A call will block until
+        ``amt`` bytes have been read from the connection or until the
+        connection is closed.
+
+        :param amt:
+            How much of the content to read. The generator will return up to
+            much data per iteration, but may return less. This is particularly
+            likely when using compressed data. However, the empty string will
+            never be returned.
+
+        :param decode_content:
+            If True, will attempt to decode the body based on the
+            'content-encoding' header.
+        """
+        if self.chunked and self.supports_chunked_reads():
+            for line in self.read_chunked(amt, decode_content=decode_content):
+                yield line
+        else:
+            while not is_fp_closed(self._fp):
+                data = self.read(amt=amt, decode_content=decode_content)
+
+                if data:
+                    yield data
+
+    @classmethod
+    def from_httplib(ResponseCls, r, **response_kw):
+        """
+        Given an :class:`http.client.HTTPResponse` instance ``r``, return a
+        corresponding :class:`urllib3.response.HTTPResponse` object.
+
+        Remaining parameters are passed to the HTTPResponse constructor, along
+        with ``original_response=r``.
+        """
+        headers = r.msg
+
+        if not isinstance(headers, HTTPHeaderDict):
+            if six.PY2:
+                # Python 2.7
+                headers = HTTPHeaderDict.from_httplib(headers)
+            else:
+                headers = HTTPHeaderDict(headers.items())
+
+        # HTTPResponse objects in Python 3 don't have a .strict attribute
+        strict = getattr(r, "strict", 0)
+        resp = ResponseCls(
+            body=r,
+            headers=headers,
+            status=r.status,
+            version=r.version,
+            reason=r.reason,
+            strict=strict,
+            original_response=r,
+            **response_kw
+        )
+        return resp
+
+    # Backwards-compatibility methods for http.client.HTTPResponse
+    def getheaders(self):
+        warnings.warn(
+            "HTTPResponse.getheaders() is deprecated and will be removed "
+            "in urllib3 v2.1.0. Instead access HTTPResponse.headers directly.",
+            category=DeprecationWarning,
+            stacklevel=2,
+        )
+        return self.headers
+
+    def getheader(self, name, default=None):
+        warnings.warn(
+            "HTTPResponse.getheader() is deprecated and will be removed "
+            "in urllib3 v2.1.0. Instead use HTTPResponse.headers.get(name, default).",
+            category=DeprecationWarning,
+            stacklevel=2,
+        )
+        return self.headers.get(name, default)
+
+    # Backwards compatibility for http.cookiejar
+    def info(self):
+        return self.headers
+
+    # Overrides from io.IOBase
+    def close(self):
+        if not self.closed:
+            self._fp.close()
+
+        if self._connection:
+            self._connection.close()
+
+        if not self.auto_close:
+            io.IOBase.close(self)
+
+    @property
+    def closed(self):
+        if not self.auto_close:
+            return io.IOBase.closed.__get__(self)
+        elif self._fp is None:
+            return True
+        elif hasattr(self._fp, "isclosed"):
+            return self._fp.isclosed()
+        elif hasattr(self._fp, "closed"):
+            return self._fp.closed
+        else:
+            return True
+
+    def fileno(self):
+        if self._fp is None:
+            raise IOError("HTTPResponse has no file to get a fileno from")
+        elif hasattr(self._fp, "fileno"):
+            return self._fp.fileno()
+        else:
+            raise IOError(
+                "The file-like object this HTTPResponse is wrapped "
+                "around has no file descriptor"
+            )
+
+    def flush(self):
+        if (
+            self._fp is not None
+            and hasattr(self._fp, "flush")
+            and not getattr(self._fp, "closed", False)
+        ):
+            return self._fp.flush()
+
+    def readable(self):
+        # This method is required for `io` module compatibility.
+        return True
+
+    def readinto(self, b):
+        # This method is required for `io` module compatibility.
+        temp = self.read(len(b))
+        if len(temp) == 0:
+            return 0
+        else:
+            b[: len(temp)] = temp
+            return len(temp)
+
+    def supports_chunked_reads(self):
+        """
+        Checks if the underlying file-like object looks like a
+        :class:`http.client.HTTPResponse` object. We do this by testing for
+        the fp attribute. If it is present we assume it returns raw chunks as
+        processed by read_chunked().
+        """
+        return hasattr(self._fp, "fp")
+
+    def _update_chunk_length(self):
+        # First, we'll figure out length of a chunk and then
+        # we'll try to read it from socket.
+        if self.chunk_left is not None:
+            return
+        line = self._fp.fp.readline()
+        line = line.split(b";", 1)[0]
+        try:
+            self.chunk_left = int(line, 16)
+        except ValueError:
+            # Invalid chunked protocol response, abort.
+            self.close()
+            raise InvalidChunkLength(self, line)
+
+    def _handle_chunk(self, amt):
+        returned_chunk = None
+        if amt is None:
+            chunk = self._fp._safe_read(self.chunk_left)
+            returned_chunk = chunk
+            self._fp._safe_read(2)  # Toss the CRLF at the end of the chunk.
+            self.chunk_left = None
+        elif amt < self.chunk_left:
+            value = self._fp._safe_read(amt)
+            self.chunk_left = self.chunk_left - amt
+            returned_chunk = value
+        elif amt == self.chunk_left:
+            value = self._fp._safe_read(amt)
+            self._fp._safe_read(2)  # Toss the CRLF at the end of the chunk.
+            self.chunk_left = None
+            returned_chunk = value
+        else:  # amt > self.chunk_left
+            returned_chunk = self._fp._safe_read(self.chunk_left)
+            self._fp._safe_read(2)  # Toss the CRLF at the end of the chunk.
+            self.chunk_left = None
+        return returned_chunk
+
+    def read_chunked(self, amt=None, decode_content=None):
+        """
+        Similar to :meth:`HTTPResponse.read`, but with an additional
+        parameter: ``decode_content``.
+
+        :param amt:
+            How much of the content to read. If specified, caching is skipped
+            because it doesn't make sense to cache partial content as the full
+            response.
+
+        :param decode_content:
+            If True, will attempt to decode the body based on the
+            'content-encoding' header.
+        """
+        self._init_decoder()
+        # FIXME: Rewrite this method and make it a class with a better structured logic.
+        if not self.chunked:
+            raise ResponseNotChunked(
+                "Response is not chunked. "
+                "Header 'transfer-encoding: chunked' is missing."
+            )
+        if not self.supports_chunked_reads():
+            raise BodyNotHttplibCompatible(
+                "Body should be http.client.HTTPResponse like. "
+                "It should have have an fp attribute which returns raw chunks."
+            )
+
+        with self._error_catcher():
+            # Don't bother reading the body of a HEAD request.
+            if self._original_response and is_response_to_head(self._original_response):
+                self._original_response.close()
+                return
+
+            # If a response is already read and closed
+            # then return immediately.
+            if self._fp.fp is None:
+                return
+
+            while True:
+                self._update_chunk_length()
+                if self.chunk_left == 0:
+                    break
+                chunk = self._handle_chunk(amt)
+                decoded = self._decode(
+                    chunk, decode_content=decode_content, flush_decoder=False
+                )
+                if decoded:
+                    yield decoded
+
+            if decode_content:
+                # On CPython and PyPy, we should never need to flush the
+                # decoder. However, on Jython we *might* need to, so
+                # lets defensively do it anyway.
+                decoded = self._flush_decoder()
+                if decoded:  # Platform-specific: Jython.
+                    yield decoded
+
+            # Chunk content ends with \r\n: discard it.
+            while True:
+                line = self._fp.fp.readline()
+                if not line:
+                    # Some sites may not end with '\r\n'.
+                    break
+                if line == b"\r\n":
+                    break
+
+            # We read everything; close the "file".
+            if self._original_response:
+                self._original_response.close()
+
+    def geturl(self):
+        """
+        Returns the URL that was the source of this response.
+        If the request that generated this response redirected, this method
+        will return the final redirect location.
+        """
+        if self.retries is not None and len(self.retries.history):
+            return self.retries.history[-1].redirect_location
+        else:
+            return self._request_url
+
+    def __iter__(self):
+        buffer = []
+        for chunk in self.stream(decode_content=True):
+            if b"\n" in chunk:
+                chunk = chunk.split(b"\n")
+                yield b"".join(buffer) + chunk[0] + b"\n"
+                for x in chunk[1:-1]:
+                    yield x + b"\n"
+                if chunk[-1]:
+                    buffer = [chunk[-1]]
+                else:
+                    buffer = []
+            else:
+                buffer.append(chunk)
+        if buffer:
+            yield b"".join(buffer)
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/__init__.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/__init__.py
new file mode 100644
index 0000000..4547fc5
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/__init__.py
@@ -0,0 +1,49 @@
+from __future__ import absolute_import
+
+# For backwards compatibility, provide imports that used to be here.
+from .connection import is_connection_dropped
+from .request import SKIP_HEADER, SKIPPABLE_HEADERS, make_headers
+from .response import is_fp_closed
+from .retry import Retry
+from .ssl_ import (
+    ALPN_PROTOCOLS,
+    HAS_SNI,
+    IS_PYOPENSSL,
+    IS_SECURETRANSPORT,
+    PROTOCOL_TLS,
+    SSLContext,
+    assert_fingerprint,
+    resolve_cert_reqs,
+    resolve_ssl_version,
+    ssl_wrap_socket,
+)
+from .timeout import Timeout, current_time
+from .url import Url, get_host, parse_url, split_first
+from .wait import wait_for_read, wait_for_write
+
+__all__ = (
+    "HAS_SNI",
+    "IS_PYOPENSSL",
+    "IS_SECURETRANSPORT",
+    "SSLContext",
+    "PROTOCOL_TLS",
+    "ALPN_PROTOCOLS",
+    "Retry",
+    "Timeout",
+    "Url",
+    "assert_fingerprint",
+    "current_time",
+    "is_connection_dropped",
+    "is_fp_closed",
+    "get_host",
+    "parse_url",
+    "make_headers",
+    "resolve_cert_reqs",
+    "resolve_ssl_version",
+    "split_first",
+    "ssl_wrap_socket",
+    "wait_for_read",
+    "wait_for_write",
+    "SKIP_HEADER",
+    "SKIPPABLE_HEADERS",
+)
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/__pycache__/__init__.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/__pycache__/__init__.cpython-312.pyc
new file mode 100644
index 0000000..dd7bd04
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/__pycache__/__init__.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/__pycache__/connection.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/__pycache__/connection.cpython-312.pyc
new file mode 100644
index 0000000..a10612c
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/__pycache__/connection.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/__pycache__/proxy.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/__pycache__/proxy.cpython-312.pyc
new file mode 100644
index 0000000..a61072b
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/__pycache__/proxy.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/__pycache__/queue.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/__pycache__/queue.cpython-312.pyc
new file mode 100644
index 0000000..fda562b
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/__pycache__/queue.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/__pycache__/request.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/__pycache__/request.cpython-312.pyc
new file mode 100644
index 0000000..de3c243
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/__pycache__/request.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/__pycache__/response.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/__pycache__/response.cpython-312.pyc
new file mode 100644
index 0000000..f914126
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/__pycache__/response.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/__pycache__/retry.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/__pycache__/retry.cpython-312.pyc
new file mode 100644
index 0000000..1104ca3
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/__pycache__/retry.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/__pycache__/ssl_.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/__pycache__/ssl_.cpython-312.pyc
new file mode 100644
index 0000000..aa13282
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/__pycache__/ssl_.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/__pycache__/ssl_match_hostname.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/__pycache__/ssl_match_hostname.cpython-312.pyc
new file mode 100644
index 0000000..ffb9b0a
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/__pycache__/ssl_match_hostname.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/__pycache__/ssltransport.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/__pycache__/ssltransport.cpython-312.pyc
new file mode 100644
index 0000000..6e8561b
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/__pycache__/ssltransport.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/__pycache__/timeout.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/__pycache__/timeout.cpython-312.pyc
new file mode 100644
index 0000000..9ca047b
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/__pycache__/timeout.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/__pycache__/url.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/__pycache__/url.cpython-312.pyc
new file mode 100644
index 0000000..80e99dd
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/__pycache__/url.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/__pycache__/wait.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/__pycache__/wait.cpython-312.pyc
new file mode 100644
index 0000000..a6e8ee5
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/__pycache__/wait.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/connection.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/connection.py
new file mode 100644
index 0000000..6af1138
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/connection.py
@@ -0,0 +1,149 @@
+from __future__ import absolute_import
+
+import socket
+
+from ..contrib import _appengine_environ
+from ..exceptions import LocationParseError
+from ..packages import six
+from .wait import NoWayToWaitForSocketError, wait_for_read
+
+
+def is_connection_dropped(conn):  # Platform-specific
+    """
+    Returns True if the connection is dropped and should be closed.
+
+    :param conn:
+        :class:`http.client.HTTPConnection` object.
+
+    Note: For platforms like AppEngine, this will always return ``False`` to
+    let the platform handle connection recycling transparently for us.
+    """
+    sock = getattr(conn, "sock", False)
+    if sock is False:  # Platform-specific: AppEngine
+        return False
+    if sock is None:  # Connection already closed (such as by httplib).
+        return True
+    try:
+        # Returns True if readable, which here means it's been dropped
+        return wait_for_read(sock, timeout=0.0)
+    except NoWayToWaitForSocketError:  # Platform-specific: AppEngine
+        return False
+
+
+# This function is copied from socket.py in the Python 2.7 standard
+# library test suite. Added to its signature is only `socket_options`.
+# One additional modification is that we avoid binding to IPv6 servers
+# discovered in DNS if the system doesn't have IPv6 functionality.
+def create_connection(
+    address,
+    timeout=socket._GLOBAL_DEFAULT_TIMEOUT,
+    source_address=None,
+    socket_options=None,
+):
+    """Connect to *address* and return the socket object.
+
+    Convenience function.  Connect to *address* (a 2-tuple ``(host,
+    port)``) and return the socket object.  Passing the optional
+    *timeout* parameter will set the timeout on the socket instance
+    before attempting to connect.  If no *timeout* is supplied, the
+    global default timeout setting returned by :func:`socket.getdefaulttimeout`
+    is used.  If *source_address* is set it must be a tuple of (host, port)
+    for the socket to bind as a source address before making the connection.
+    An host of '' or port 0 tells the OS to use the default.
+    """
+
+    host, port = address
+    if host.startswith("["):
+        host = host.strip("[]")
+    err = None
+
+    # Using the value from allowed_gai_family() in the context of getaddrinfo lets
+    # us select whether to work with IPv4 DNS records, IPv6 records, or both.
+    # The original create_connection function always returns all records.
+    family = allowed_gai_family()
+
+    try:
+        host.encode("idna")
+    except UnicodeError:
+        return six.raise_from(
+            LocationParseError(u"'%s', label empty or too long" % host), None
+        )
+
+    for res in socket.getaddrinfo(host, port, family, socket.SOCK_STREAM):
+        af, socktype, proto, canonname, sa = res
+        sock = None
+        try:
+            sock = socket.socket(af, socktype, proto)
+
+            # If provided, set socket level options before connecting.
+            _set_socket_options(sock, socket_options)
+
+            if timeout is not socket._GLOBAL_DEFAULT_TIMEOUT:
+                sock.settimeout(timeout)
+            if source_address:
+                sock.bind(source_address)
+            sock.connect(sa)
+            return sock
+
+        except socket.error as e:
+            err = e
+            if sock is not None:
+                sock.close()
+                sock = None
+
+    if err is not None:
+        raise err
+
+    raise socket.error("getaddrinfo returns an empty list")
+
+
+def _set_socket_options(sock, options):
+    if options is None:
+        return
+
+    for opt in options:
+        sock.setsockopt(*opt)
+
+
+def allowed_gai_family():
+    """This function is designed to work in the context of
+    getaddrinfo, where family=socket.AF_UNSPEC is the default and
+    will perform a DNS search for both IPv6 and IPv4 records."""
+
+    family = socket.AF_INET
+    if HAS_IPV6:
+        family = socket.AF_UNSPEC
+    return family
+
+
+def _has_ipv6(host):
+    """Returns True if the system can bind an IPv6 address."""
+    sock = None
+    has_ipv6 = False
+
+    # App Engine doesn't support IPV6 sockets and actually has a quota on the
+    # number of sockets that can be used, so just early out here instead of
+    # creating a socket needlessly.
+    # See https://github.com/urllib3/urllib3/issues/1446
+    if _appengine_environ.is_appengine_sandbox():
+        return False
+
+    if socket.has_ipv6:
+        # has_ipv6 returns true if cPython was compiled with IPv6 support.
+        # It does not tell us if the system has IPv6 support enabled. To
+        # determine that we must bind to an IPv6 address.
+        # https://github.com/urllib3/urllib3/pull/611
+        # https://bugs.python.org/issue658327
+        try:
+            sock = socket.socket(socket.AF_INET6)
+            sock.bind((host, 0))
+            has_ipv6 = True
+        except Exception:
+            pass
+
+    if sock:
+        sock.close()
+    return has_ipv6
+
+
+HAS_IPV6 = _has_ipv6("::1")
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/proxy.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/proxy.py
new file mode 100644
index 0000000..2199cc7
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/proxy.py
@@ -0,0 +1,57 @@
+from .ssl_ import create_urllib3_context, resolve_cert_reqs, resolve_ssl_version
+
+
+def connection_requires_http_tunnel(
+    proxy_url=None, proxy_config=None, destination_scheme=None
+):
+    """
+    Returns True if the connection requires an HTTP CONNECT through the proxy.
+
+    :param URL proxy_url:
+        URL of the proxy.
+    :param ProxyConfig proxy_config:
+        Proxy configuration from poolmanager.py
+    :param str destination_scheme:
+        The scheme of the destination. (i.e https, http, etc)
+    """
+    # If we're not using a proxy, no way to use a tunnel.
+    if proxy_url is None:
+        return False
+
+    # HTTP destinations never require tunneling, we always forward.
+    if destination_scheme == "http":
+        return False
+
+    # Support for forwarding with HTTPS proxies and HTTPS destinations.
+    if (
+        proxy_url.scheme == "https"
+        and proxy_config
+        and proxy_config.use_forwarding_for_https
+    ):
+        return False
+
+    # Otherwise always use a tunnel.
+    return True
+
+
+def create_proxy_ssl_context(
+    ssl_version, cert_reqs, ca_certs=None, ca_cert_dir=None, ca_cert_data=None
+):
+    """
+    Generates a default proxy ssl context if one hasn't been provided by the
+    user.
+    """
+    ssl_context = create_urllib3_context(
+        ssl_version=resolve_ssl_version(ssl_version),
+        cert_reqs=resolve_cert_reqs(cert_reqs),
+    )
+
+    if (
+        not ca_certs
+        and not ca_cert_dir
+        and not ca_cert_data
+        and hasattr(ssl_context, "load_default_certs")
+    ):
+        ssl_context.load_default_certs()
+
+    return ssl_context
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/queue.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/queue.py
new file mode 100644
index 0000000..4178410
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/queue.py
@@ -0,0 +1,22 @@
+import collections
+
+from ..packages import six
+from ..packages.six.moves import queue
+
+if six.PY2:
+    # Queue is imported for side effects on MS Windows. See issue #229.
+    import Queue as _unused_module_Queue  # noqa: F401
+
+
+class LifoQueue(queue.Queue):
+    def _init(self, _):
+        self.queue = collections.deque()
+
+    def _qsize(self, len=len):
+        return len(self.queue)
+
+    def _put(self, item):
+        self.queue.append(item)
+
+    def _get(self):
+        return self.queue.pop()
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/request.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/request.py
new file mode 100644
index 0000000..330766e
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/request.py
@@ -0,0 +1,137 @@
+from __future__ import absolute_import
+
+from base64 import b64encode
+
+from ..exceptions import UnrewindableBodyError
+from ..packages.six import b, integer_types
+
+# Pass as a value within ``headers`` to skip
+# emitting some HTTP headers that are added automatically.
+# The only headers that are supported are ``Accept-Encoding``,
+# ``Host``, and ``User-Agent``.
+SKIP_HEADER = "@@@SKIP_HEADER@@@"
+SKIPPABLE_HEADERS = frozenset(["accept-encoding", "host", "user-agent"])
+
+ACCEPT_ENCODING = "gzip,deflate"
+
+_FAILEDTELL = object()
+
+
+def make_headers(
+    keep_alive=None,
+    accept_encoding=None,
+    user_agent=None,
+    basic_auth=None,
+    proxy_basic_auth=None,
+    disable_cache=None,
+):
+    """
+    Shortcuts for generating request headers.
+
+    :param keep_alive:
+        If ``True``, adds 'connection: keep-alive' header.
+
+    :param accept_encoding:
+        Can be a boolean, list, or string.
+        ``True`` translates to 'gzip,deflate'.
+        List will get joined by comma.
+        String will be used as provided.
+
+    :param user_agent:
+        String representing the user-agent you want, such as
+        "python-urllib3/0.6"
+
+    :param basic_auth:
+        Colon-separated username:password string for 'authorization: basic ...'
+        auth header.
+
+    :param proxy_basic_auth:
+        Colon-separated username:password string for 'proxy-authorization: basic ...'
+        auth header.
+
+    :param disable_cache:
+        If ``True``, adds 'cache-control: no-cache' header.
+
+    Example::
+
+        >>> make_headers(keep_alive=True, user_agent="Batman/1.0")
+        {'connection': 'keep-alive', 'user-agent': 'Batman/1.0'}
+        >>> make_headers(accept_encoding=True)
+        {'accept-encoding': 'gzip,deflate'}
+    """
+    headers = {}
+    if accept_encoding:
+        if isinstance(accept_encoding, str):
+            pass
+        elif isinstance(accept_encoding, list):
+            accept_encoding = ",".join(accept_encoding)
+        else:
+            accept_encoding = ACCEPT_ENCODING
+        headers["accept-encoding"] = accept_encoding
+
+    if user_agent:
+        headers["user-agent"] = user_agent
+
+    if keep_alive:
+        headers["connection"] = "keep-alive"
+
+    if basic_auth:
+        headers["authorization"] = "Basic " + b64encode(b(basic_auth)).decode("utf-8")
+
+    if proxy_basic_auth:
+        headers["proxy-authorization"] = "Basic " + b64encode(
+            b(proxy_basic_auth)
+        ).decode("utf-8")
+
+    if disable_cache:
+        headers["cache-control"] = "no-cache"
+
+    return headers
+
+
+def set_file_position(body, pos):
+    """
+    If a position is provided, move file to that point.
+    Otherwise, we'll attempt to record a position for future use.
+    """
+    if pos is not None:
+        rewind_body(body, pos)
+    elif getattr(body, "tell", None) is not None:
+        try:
+            pos = body.tell()
+        except (IOError, OSError):
+            # This differentiates from None, allowing us to catch
+            # a failed `tell()` later when trying to rewind the body.
+            pos = _FAILEDTELL
+
+    return pos
+
+
+def rewind_body(body, body_pos):
+    """
+    Attempt to rewind body to a certain position.
+    Primarily used for request redirects and retries.
+
+    :param body:
+        File-like object that supports seek.
+
+    :param int pos:
+        Position to seek to in file.
+    """
+    body_seek = getattr(body, "seek", None)
+    if body_seek is not None and isinstance(body_pos, integer_types):
+        try:
+            body_seek(body_pos)
+        except (IOError, OSError):
+            raise UnrewindableBodyError(
+                "An error occurred when rewinding request body for redirect/retry."
+            )
+    elif body_pos is _FAILEDTELL:
+        raise UnrewindableBodyError(
+            "Unable to record file position for rewinding "
+            "request body during a redirect/retry."
+        )
+    else:
+        raise ValueError(
+            "body_pos must be of type integer, instead it was %s." % type(body_pos)
+        )
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/response.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/response.py
new file mode 100644
index 0000000..5ea609c
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/response.py
@@ -0,0 +1,107 @@
+from __future__ import absolute_import
+
+from email.errors import MultipartInvariantViolationDefect, StartBoundaryNotFoundDefect
+
+from ..exceptions import HeaderParsingError
+from ..packages.six.moves import http_client as httplib
+
+
+def is_fp_closed(obj):
+    """
+    Checks whether a given file-like object is closed.
+
+    :param obj:
+        The file-like object to check.
+    """
+
+    try:
+        # Check `isclosed()` first, in case Python3 doesn't set `closed`.
+        # GH Issue #928
+        return obj.isclosed()
+    except AttributeError:
+        pass
+
+    try:
+        # Check via the official file-like-object way.
+        return obj.closed
+    except AttributeError:
+        pass
+
+    try:
+        # Check if the object is a container for another file-like object that
+        # gets released on exhaustion (e.g. HTTPResponse).
+        return obj.fp is None
+    except AttributeError:
+        pass
+
+    raise ValueError("Unable to determine whether fp is closed.")
+
+
+def assert_header_parsing(headers):
+    """
+    Asserts whether all headers have been successfully parsed.
+    Extracts encountered errors from the result of parsing headers.
+
+    Only works on Python 3.
+
+    :param http.client.HTTPMessage headers: Headers to verify.
+
+    :raises urllib3.exceptions.HeaderParsingError:
+        If parsing errors are found.
+    """
+
+    # This will fail silently if we pass in the wrong kind of parameter.
+    # To make debugging easier add an explicit check.
+    if not isinstance(headers, httplib.HTTPMessage):
+        raise TypeError("expected httplib.Message, got {0}.".format(type(headers)))
+
+    defects = getattr(headers, "defects", None)
+    get_payload = getattr(headers, "get_payload", None)
+
+    unparsed_data = None
+    if get_payload:
+        # get_payload is actually email.message.Message.get_payload;
+        # we're only interested in the result if it's not a multipart message
+        if not headers.is_multipart():
+            payload = get_payload()
+
+            if isinstance(payload, (bytes, str)):
+                unparsed_data = payload
+    if defects:
+        # httplib is assuming a response body is available
+        # when parsing headers even when httplib only sends
+        # header data to parse_headers() This results in
+        # defects on multipart responses in particular.
+        # See: https://github.com/urllib3/urllib3/issues/800
+
+        # So we ignore the following defects:
+        # - StartBoundaryNotFoundDefect:
+        #     The claimed start boundary was never found.
+        # - MultipartInvariantViolationDefect:
+        #     A message claimed to be a multipart but no subparts were found.
+        defects = [
+            defect
+            for defect in defects
+            if not isinstance(
+                defect, (StartBoundaryNotFoundDefect, MultipartInvariantViolationDefect)
+            )
+        ]
+
+    if defects or unparsed_data:
+        raise HeaderParsingError(defects=defects, unparsed_data=unparsed_data)
+
+
+def is_response_to_head(response):
+    """
+    Checks whether the request of a response has been a HEAD-request.
+    Handles the quirks of AppEngine.
+
+    :param http.client.HTTPResponse response:
+        Response to check if the originating request
+        used 'HEAD' as a method.
+    """
+    # FIXME: Can we do this somehow without accessing private httplib _method?
+    method = response._method
+    if isinstance(method, int):  # Platform-specific: Appengine
+        return method == 3
+    return method.upper() == "HEAD"
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/retry.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/retry.py
new file mode 100644
index 0000000..9a1e90d
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/retry.py
@@ -0,0 +1,622 @@
+from __future__ import absolute_import
+
+import email
+import logging
+import re
+import time
+import warnings
+from collections import namedtuple
+from itertools import takewhile
+
+from ..exceptions import (
+    ConnectTimeoutError,
+    InvalidHeader,
+    MaxRetryError,
+    ProtocolError,
+    ProxyError,
+    ReadTimeoutError,
+    ResponseError,
+)
+from ..packages import six
+
+log = logging.getLogger(__name__)
+
+
+# Data structure for representing the metadata of requests that result in a retry.
+RequestHistory = namedtuple(
+    "RequestHistory", ["method", "url", "error", "status", "redirect_location"]
+)
+
+
+# TODO: In v2 we can remove this sentinel and metaclass with deprecated options.
+_Default = object()
+
+
+class _RetryMeta(type):
+    @property
+    def DEFAULT_METHOD_WHITELIST(cls):
+        warnings.warn(
+            "Using 'Retry.DEFAULT_METHOD_WHITELIST' is deprecated and "
+            "will be removed in v2.0. Use 'Retry.DEFAULT_ALLOWED_METHODS' instead",
+            DeprecationWarning,
+        )
+        return cls.DEFAULT_ALLOWED_METHODS
+
+    @DEFAULT_METHOD_WHITELIST.setter
+    def DEFAULT_METHOD_WHITELIST(cls, value):
+        warnings.warn(
+            "Using 'Retry.DEFAULT_METHOD_WHITELIST' is deprecated and "
+            "will be removed in v2.0. Use 'Retry.DEFAULT_ALLOWED_METHODS' instead",
+            DeprecationWarning,
+        )
+        cls.DEFAULT_ALLOWED_METHODS = value
+
+    @property
+    def DEFAULT_REDIRECT_HEADERS_BLACKLIST(cls):
+        warnings.warn(
+            "Using 'Retry.DEFAULT_REDIRECT_HEADERS_BLACKLIST' is deprecated and "
+            "will be removed in v2.0. Use 'Retry.DEFAULT_REMOVE_HEADERS_ON_REDIRECT' instead",
+            DeprecationWarning,
+        )
+        return cls.DEFAULT_REMOVE_HEADERS_ON_REDIRECT
+
+    @DEFAULT_REDIRECT_HEADERS_BLACKLIST.setter
+    def DEFAULT_REDIRECT_HEADERS_BLACKLIST(cls, value):
+        warnings.warn(
+            "Using 'Retry.DEFAULT_REDIRECT_HEADERS_BLACKLIST' is deprecated and "
+            "will be removed in v2.0. Use 'Retry.DEFAULT_REMOVE_HEADERS_ON_REDIRECT' instead",
+            DeprecationWarning,
+        )
+        cls.DEFAULT_REMOVE_HEADERS_ON_REDIRECT = value
+
+    @property
+    def BACKOFF_MAX(cls):
+        warnings.warn(
+            "Using 'Retry.BACKOFF_MAX' is deprecated and "
+            "will be removed in v2.0. Use 'Retry.DEFAULT_BACKOFF_MAX' instead",
+            DeprecationWarning,
+        )
+        return cls.DEFAULT_BACKOFF_MAX
+
+    @BACKOFF_MAX.setter
+    def BACKOFF_MAX(cls, value):
+        warnings.warn(
+            "Using 'Retry.BACKOFF_MAX' is deprecated and "
+            "will be removed in v2.0. Use 'Retry.DEFAULT_BACKOFF_MAX' instead",
+            DeprecationWarning,
+        )
+        cls.DEFAULT_BACKOFF_MAX = value
+
+
+@six.add_metaclass(_RetryMeta)
+class Retry(object):
+    """Retry configuration.
+
+    Each retry attempt will create a new Retry object with updated values, so
+    they can be safely reused.
+
+    Retries can be defined as a default for a pool::
+
+        retries = Retry(connect=5, read=2, redirect=5)
+        http = PoolManager(retries=retries)
+        response = http.request('GET', 'http://example.com/')
+
+    Or per-request (which overrides the default for the pool)::
+
+        response = http.request('GET', 'http://example.com/', retries=Retry(10))
+
+    Retries can be disabled by passing ``False``::
+
+        response = http.request('GET', 'http://example.com/', retries=False)
+
+    Errors will be wrapped in :class:`~urllib3.exceptions.MaxRetryError` unless
+    retries are disabled, in which case the causing exception will be raised.
+
+    :param int total:
+        Total number of retries to allow. Takes precedence over other counts.
+
+        Set to ``None`` to remove this constraint and fall back on other
+        counts.
+
+        Set to ``0`` to fail on the first retry.
+
+        Set to ``False`` to disable and imply ``raise_on_redirect=False``.
+
+    :param int connect:
+        How many connection-related errors to retry on.
+
+        These are errors raised before the request is sent to the remote server,
+        which we assume has not triggered the server to process the request.
+
+        Set to ``0`` to fail on the first retry of this type.
+
+    :param int read:
+        How many times to retry on read errors.
+
+        These errors are raised after the request was sent to the server, so the
+        request may have side-effects.
+
+        Set to ``0`` to fail on the first retry of this type.
+
+    :param int redirect:
+        How many redirects to perform. Limit this to avoid infinite redirect
+        loops.
+
+        A redirect is a HTTP response with a status code 301, 302, 303, 307 or
+        308.
+
+        Set to ``0`` to fail on the first retry of this type.
+
+        Set to ``False`` to disable and imply ``raise_on_redirect=False``.
+
+    :param int status:
+        How many times to retry on bad status codes.
+
+        These are retries made on responses, where status code matches
+        ``status_forcelist``.
+
+        Set to ``0`` to fail on the first retry of this type.
+
+    :param int other:
+        How many times to retry on other errors.
+
+        Other errors are errors that are not connect, read, redirect or status errors.
+        These errors might be raised after the request was sent to the server, so the
+        request might have side-effects.
+
+        Set to ``0`` to fail on the first retry of this type.
+
+        If ``total`` is not set, it's a good idea to set this to 0 to account
+        for unexpected edge cases and avoid infinite retry loops.
+
+    :param iterable allowed_methods:
+        Set of uppercased HTTP method verbs that we should retry on.
+
+        By default, we only retry on methods which are considered to be
+        idempotent (multiple requests with the same parameters end with the
+        same state). See :attr:`Retry.DEFAULT_ALLOWED_METHODS`.
+
+        Set to a ``False`` value to retry on any verb.
+
+        .. warning::
+
+            Previously this parameter was named ``method_whitelist``, that
+            usage is deprecated in v1.26.0 and will be removed in v2.0.
+
+    :param iterable status_forcelist:
+        A set of integer HTTP status codes that we should force a retry on.
+        A retry is initiated if the request method is in ``allowed_methods``
+        and the response status code is in ``status_forcelist``.
+
+        By default, this is disabled with ``None``.
+
+    :param float backoff_factor:
+        A backoff factor to apply between attempts after the second try
+        (most errors are resolved immediately by a second try without a
+        delay). urllib3 will sleep for::
+
+            {backoff factor} * (2 ** ({number of total retries} - 1))
+
+        seconds. If the backoff_factor is 0.1, then :func:`.sleep` will sleep
+        for [0.0s, 0.2s, 0.4s, ...] between retries. It will never be longer
+        than :attr:`Retry.DEFAULT_BACKOFF_MAX`.
+
+        By default, backoff is disabled (set to 0).
+
+    :param bool raise_on_redirect: Whether, if the number of redirects is
+        exhausted, to raise a MaxRetryError, or to return a response with a
+        response code in the 3xx range.
+
+    :param bool raise_on_status: Similar meaning to ``raise_on_redirect``:
+        whether we should raise an exception, or return a response,
+        if status falls in ``status_forcelist`` range and retries have
+        been exhausted.
+
+    :param tuple history: The history of the request encountered during
+        each call to :meth:`~Retry.increment`. The list is in the order
+        the requests occurred. Each list item is of class :class:`RequestHistory`.
+
+    :param bool respect_retry_after_header:
+        Whether to respect Retry-After header on status codes defined as
+        :attr:`Retry.RETRY_AFTER_STATUS_CODES` or not.
+
+    :param iterable remove_headers_on_redirect:
+        Sequence of headers to remove from the request when a response
+        indicating a redirect is returned before firing off the redirected
+        request.
+    """
+
+    #: Default methods to be used for ``allowed_methods``
+    DEFAULT_ALLOWED_METHODS = frozenset(
+        ["HEAD", "GET", "PUT", "DELETE", "OPTIONS", "TRACE"]
+    )
+
+    #: Default status codes to be used for ``status_forcelist``
+    RETRY_AFTER_STATUS_CODES = frozenset([413, 429, 503])
+
+    #: Default headers to be used for ``remove_headers_on_redirect``
+    DEFAULT_REMOVE_HEADERS_ON_REDIRECT = frozenset(
+        ["Cookie", "Authorization", "Proxy-Authorization"]
+    )
+
+    #: Maximum backoff time.
+    DEFAULT_BACKOFF_MAX = 120
+
+    def __init__(
+        self,
+        total=10,
+        connect=None,
+        read=None,
+        redirect=None,
+        status=None,
+        other=None,
+        allowed_methods=_Default,
+        status_forcelist=None,
+        backoff_factor=0,
+        raise_on_redirect=True,
+        raise_on_status=True,
+        history=None,
+        respect_retry_after_header=True,
+        remove_headers_on_redirect=_Default,
+        # TODO: Deprecated, remove in v2.0
+        method_whitelist=_Default,
+    ):
+
+        if method_whitelist is not _Default:
+            if allowed_methods is not _Default:
+                raise ValueError(
+                    "Using both 'allowed_methods' and "
+                    "'method_whitelist' together is not allowed. "
+                    "Instead only use 'allowed_methods'"
+                )
+            warnings.warn(
+                "Using 'method_whitelist' with Retry is deprecated and "
+                "will be removed in v2.0. Use 'allowed_methods' instead",
+                DeprecationWarning,
+                stacklevel=2,
+            )
+            allowed_methods = method_whitelist
+        if allowed_methods is _Default:
+            allowed_methods = self.DEFAULT_ALLOWED_METHODS
+        if remove_headers_on_redirect is _Default:
+            remove_headers_on_redirect = self.DEFAULT_REMOVE_HEADERS_ON_REDIRECT
+
+        self.total = total
+        self.connect = connect
+        self.read = read
+        self.status = status
+        self.other = other
+
+        if redirect is False or total is False:
+            redirect = 0
+            raise_on_redirect = False
+
+        self.redirect = redirect
+        self.status_forcelist = status_forcelist or set()
+        self.allowed_methods = allowed_methods
+        self.backoff_factor = backoff_factor
+        self.raise_on_redirect = raise_on_redirect
+        self.raise_on_status = raise_on_status
+        self.history = history or tuple()
+        self.respect_retry_after_header = respect_retry_after_header
+        self.remove_headers_on_redirect = frozenset(
+            [h.lower() for h in remove_headers_on_redirect]
+        )
+
+    def new(self, **kw):
+        params = dict(
+            total=self.total,
+            connect=self.connect,
+            read=self.read,
+            redirect=self.redirect,
+            status=self.status,
+            other=self.other,
+            status_forcelist=self.status_forcelist,
+            backoff_factor=self.backoff_factor,
+            raise_on_redirect=self.raise_on_redirect,
+            raise_on_status=self.raise_on_status,
+            history=self.history,
+            remove_headers_on_redirect=self.remove_headers_on_redirect,
+            respect_retry_after_header=self.respect_retry_after_header,
+        )
+
+        # TODO: If already given in **kw we use what's given to us
+        # If not given we need to figure out what to pass. We decide
+        # based on whether our class has the 'method_whitelist' property
+        # and if so we pass the deprecated 'method_whitelist' otherwise
+        # we use 'allowed_methods'. Remove in v2.0
+        if "method_whitelist" not in kw and "allowed_methods" not in kw:
+            if "method_whitelist" in self.__dict__:
+                warnings.warn(
+                    "Using 'method_whitelist' with Retry is deprecated and "
+                    "will be removed in v2.0. Use 'allowed_methods' instead",
+                    DeprecationWarning,
+                )
+                params["method_whitelist"] = self.allowed_methods
+            else:
+                params["allowed_methods"] = self.allowed_methods
+
+        params.update(kw)
+        return type(self)(**params)
+
+    @classmethod
+    def from_int(cls, retries, redirect=True, default=None):
+        """Backwards-compatibility for the old retries format."""
+        if retries is None:
+            retries = default if default is not None else cls.DEFAULT
+
+        if isinstance(retries, Retry):
+            return retries
+
+        redirect = bool(redirect) and None
+        new_retries = cls(retries, redirect=redirect)
+        log.debug("Converted retries value: %r -> %r", retries, new_retries)
+        return new_retries
+
+    def get_backoff_time(self):
+        """Formula for computing the current backoff
+
+        :rtype: float
+        """
+        # We want to consider only the last consecutive errors sequence (Ignore redirects).
+        consecutive_errors_len = len(
+            list(
+                takewhile(lambda x: x.redirect_location is None, reversed(self.history))
+            )
+        )
+        if consecutive_errors_len <= 1:
+            return 0
+
+        backoff_value = self.backoff_factor * (2 ** (consecutive_errors_len - 1))
+        return min(self.DEFAULT_BACKOFF_MAX, backoff_value)
+
+    def parse_retry_after(self, retry_after):
+        # Whitespace: https://tools.ietf.org/html/rfc7230#section-3.2.4
+        if re.match(r"^\s*[0-9]+\s*$", retry_after):
+            seconds = int(retry_after)
+        else:
+            retry_date_tuple = email.utils.parsedate_tz(retry_after)
+            if retry_date_tuple is None:
+                raise InvalidHeader("Invalid Retry-After header: %s" % retry_after)
+            if retry_date_tuple[9] is None:  # Python 2
+                # Assume UTC if no timezone was specified
+                # On Python2.7, parsedate_tz returns None for a timezone offset
+                # instead of 0 if no timezone is given, where mktime_tz treats
+                # a None timezone offset as local time.
+                retry_date_tuple = retry_date_tuple[:9] + (0,) + retry_date_tuple[10:]
+
+            retry_date = email.utils.mktime_tz(retry_date_tuple)
+            seconds = retry_date - time.time()
+
+        if seconds < 0:
+            seconds = 0
+
+        return seconds
+
+    def get_retry_after(self, response):
+        """Get the value of Retry-After in seconds."""
+
+        retry_after = response.headers.get("Retry-After")
+
+        if retry_after is None:
+            return None
+
+        return self.parse_retry_after(retry_after)
+
+    def sleep_for_retry(self, response=None):
+        retry_after = self.get_retry_after(response)
+        if retry_after:
+            time.sleep(retry_after)
+            return True
+
+        return False
+
+    def _sleep_backoff(self):
+        backoff = self.get_backoff_time()
+        if backoff <= 0:
+            return
+        time.sleep(backoff)
+
+    def sleep(self, response=None):
+        """Sleep between retry attempts.
+
+        This method will respect a server's ``Retry-After`` response header
+        and sleep the duration of the time requested. If that is not present, it
+        will use an exponential backoff. By default, the backoff factor is 0 and
+        this method will return immediately.
+        """
+
+        if self.respect_retry_after_header and response:
+            slept = self.sleep_for_retry(response)
+            if slept:
+                return
+
+        self._sleep_backoff()
+
+    def _is_connection_error(self, err):
+        """Errors when we're fairly sure that the server did not receive the
+        request, so it should be safe to retry.
+        """
+        if isinstance(err, ProxyError):
+            err = err.original_error
+        return isinstance(err, ConnectTimeoutError)
+
+    def _is_read_error(self, err):
+        """Errors that occur after the request has been started, so we should
+        assume that the server began processing it.
+        """
+        return isinstance(err, (ReadTimeoutError, ProtocolError))
+
+    def _is_method_retryable(self, method):
+        """Checks if a given HTTP method should be retried upon, depending if
+        it is included in the allowed_methods
+        """
+        # TODO: For now favor if the Retry implementation sets its own method_whitelist
+        # property outside of our constructor to avoid breaking custom implementations.
+        if "method_whitelist" in self.__dict__:
+            warnings.warn(
+                "Using 'method_whitelist' with Retry is deprecated and "
+                "will be removed in v2.0. Use 'allowed_methods' instead",
+                DeprecationWarning,
+            )
+            allowed_methods = self.method_whitelist
+        else:
+            allowed_methods = self.allowed_methods
+
+        if allowed_methods and method.upper() not in allowed_methods:
+            return False
+        return True
+
+    def is_retry(self, method, status_code, has_retry_after=False):
+        """Is this method/status code retryable? (Based on allowlists and control
+        variables such as the number of total retries to allow, whether to
+        respect the Retry-After header, whether this header is present, and
+        whether the returned status code is on the list of status codes to
+        be retried upon on the presence of the aforementioned header)
+        """
+        if not self._is_method_retryable(method):
+            return False
+
+        if self.status_forcelist and status_code in self.status_forcelist:
+            return True
+
+        return (
+            self.total
+            and self.respect_retry_after_header
+            and has_retry_after
+            and (status_code in self.RETRY_AFTER_STATUS_CODES)
+        )
+
+    def is_exhausted(self):
+        """Are we out of retries?"""
+        retry_counts = (
+            self.total,
+            self.connect,
+            self.read,
+            self.redirect,
+            self.status,
+            self.other,
+        )
+        retry_counts = list(filter(None, retry_counts))
+        if not retry_counts:
+            return False
+
+        return min(retry_counts) < 0
+
+    def increment(
+        self,
+        method=None,
+        url=None,
+        response=None,
+        error=None,
+        _pool=None,
+        _stacktrace=None,
+    ):
+        """Return a new Retry object with incremented retry counters.
+
+        :param response: A response object, or None, if the server did not
+            return a response.
+        :type response: :class:`~urllib3.response.HTTPResponse`
+        :param Exception error: An error encountered during the request, or
+            None if the response was received successfully.
+
+        :return: A new ``Retry`` object.
+        """
+        if self.total is False and error:
+            # Disabled, indicate to re-raise the error.
+            raise six.reraise(type(error), error, _stacktrace)
+
+        total = self.total
+        if total is not None:
+            total -= 1
+
+        connect = self.connect
+        read = self.read
+        redirect = self.redirect
+        status_count = self.status
+        other = self.other
+        cause = "unknown"
+        status = None
+        redirect_location = None
+
+        if error and self._is_connection_error(error):
+            # Connect retry?
+            if connect is False:
+                raise six.reraise(type(error), error, _stacktrace)
+            elif connect is not None:
+                connect -= 1
+
+        elif error and self._is_read_error(error):
+            # Read retry?
+            if read is False or not self._is_method_retryable(method):
+                raise six.reraise(type(error), error, _stacktrace)
+            elif read is not None:
+                read -= 1
+
+        elif error:
+            # Other retry?
+            if other is not None:
+                other -= 1
+
+        elif response and response.get_redirect_location():
+            # Redirect retry?
+            if redirect is not None:
+                redirect -= 1
+            cause = "too many redirects"
+            redirect_location = response.get_redirect_location()
+            status = response.status
+
+        else:
+            # Incrementing because of a server error like a 500 in
+            # status_forcelist and the given method is in the allowed_methods
+            cause = ResponseError.GENERIC_ERROR
+            if response and response.status:
+                if status_count is not None:
+                    status_count -= 1
+                cause = ResponseError.SPECIFIC_ERROR.format(status_code=response.status)
+                status = response.status
+
+        history = self.history + (
+            RequestHistory(method, url, error, status, redirect_location),
+        )
+
+        new_retry = self.new(
+            total=total,
+            connect=connect,
+            read=read,
+            redirect=redirect,
+            status=status_count,
+            other=other,
+            history=history,
+        )
+
+        if new_retry.is_exhausted():
+            raise MaxRetryError(_pool, url, error or ResponseError(cause))
+
+        log.debug("Incremented Retry for (url='%s'): %r", url, new_retry)
+
+        return new_retry
+
+    def __repr__(self):
+        return (
+            "{cls.__name__}(total={self.total}, connect={self.connect}, "
+            "read={self.read}, redirect={self.redirect}, status={self.status})"
+        ).format(cls=type(self), self=self)
+
+    def __getattr__(self, item):
+        if item == "method_whitelist":
+            # TODO: Remove this deprecated alias in v2.0
+            warnings.warn(
+                "Using 'method_whitelist' with Retry is deprecated and "
+                "will be removed in v2.0. Use 'allowed_methods' instead",
+                DeprecationWarning,
+            )
+            return self.allowed_methods
+        try:
+            return getattr(super(Retry, self), item)
+        except AttributeError:
+            return getattr(Retry, item)
+
+
+# For backwards compatibility (equivalent to pre-v1.9):
+Retry.DEFAULT = Retry(3)
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/ssl_.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/ssl_.py
new file mode 100644
index 0000000..0a6a0e0
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/ssl_.py
@@ -0,0 +1,504 @@
+from __future__ import absolute_import
+
+import hashlib
+import hmac
+import os
+import sys
+import warnings
+from binascii import hexlify, unhexlify
+
+from ..exceptions import (
+    InsecurePlatformWarning,
+    ProxySchemeUnsupported,
+    SNIMissingWarning,
+    SSLError,
+)
+from ..packages import six
+from .url import BRACELESS_IPV6_ADDRZ_RE, IPV4_RE
+
+SSLContext = None
+SSLTransport = None
+HAS_SNI = False
+IS_PYOPENSSL = False
+IS_SECURETRANSPORT = False
+ALPN_PROTOCOLS = ["http/1.1"]
+
+# Maps the length of a digest to a possible hash function producing this digest
+HASHFUNC_MAP = {
+    length: getattr(hashlib, algorithm, None)
+    for length, algorithm in ((32, "md5"), (40, "sha1"), (64, "sha256"))
+}
+
+
+def _const_compare_digest_backport(a, b):
+    """
+    Compare two digests of equal length in constant time.
+
+    The digests must be of type str/bytes.
+    Returns True if the digests match, and False otherwise.
+    """
+    result = abs(len(a) - len(b))
+    for left, right in zip(bytearray(a), bytearray(b)):
+        result |= left ^ right
+    return result == 0
+
+
+_const_compare_digest = getattr(hmac, "compare_digest", _const_compare_digest_backport)
+
+try:  # Test for SSL features
+    import ssl
+    from ssl import CERT_REQUIRED, wrap_socket
+except ImportError:
+    pass
+
+try:
+    from ssl import HAS_SNI  # Has SNI?
+except ImportError:
+    pass
+
+try:
+    from .ssltransport import SSLTransport
+except ImportError:
+    pass
+
+
+try:  # Platform-specific: Python 3.6
+    from ssl import PROTOCOL_TLS
+
+    PROTOCOL_SSLv23 = PROTOCOL_TLS
+except ImportError:
+    try:
+        from ssl import PROTOCOL_SSLv23 as PROTOCOL_TLS
+
+        PROTOCOL_SSLv23 = PROTOCOL_TLS
+    except ImportError:
+        PROTOCOL_SSLv23 = PROTOCOL_TLS = 2
+
+try:
+    from ssl import PROTOCOL_TLS_CLIENT
+except ImportError:
+    PROTOCOL_TLS_CLIENT = PROTOCOL_TLS
+
+
+try:
+    from ssl import OP_NO_COMPRESSION, OP_NO_SSLv2, OP_NO_SSLv3
+except ImportError:
+    OP_NO_SSLv2, OP_NO_SSLv3 = 0x1000000, 0x2000000
+    OP_NO_COMPRESSION = 0x20000
+
+
+try:  # OP_NO_TICKET was added in Python 3.6
+    from ssl import OP_NO_TICKET
+except ImportError:
+    OP_NO_TICKET = 0x4000
+
+
+# A secure default.
+# Sources for more information on TLS ciphers:
+#
+# - https://wiki.mozilla.org/Security/Server_Side_TLS
+# - https://www.ssllabs.com/projects/best-practices/index.html
+# - https://hynek.me/articles/hardening-your-web-servers-ssl-ciphers/
+#
+# The general intent is:
+# - prefer cipher suites that offer perfect forward secrecy (DHE/ECDHE),
+# - prefer ECDHE over DHE for better performance,
+# - prefer any AES-GCM and ChaCha20 over any AES-CBC for better performance and
+#   security,
+# - prefer AES-GCM over ChaCha20 because hardware-accelerated AES is common,
+# - disable NULL authentication, MD5 MACs, DSS, and other
+#   insecure ciphers for security reasons.
+# - NOTE: TLS 1.3 cipher suites are managed through a different interface
+#   not exposed by CPython (yet!) and are enabled by default if they're available.
+DEFAULT_CIPHERS = ":".join(
+    [
+        "ECDHE+AESGCM",
+        "ECDHE+CHACHA20",
+        "DHE+AESGCM",
+        "DHE+CHACHA20",
+        "ECDH+AESGCM",
+        "DH+AESGCM",
+        "ECDH+AES",
+        "DH+AES",
+        "RSA+AESGCM",
+        "RSA+AES",
+        "!aNULL",
+        "!eNULL",
+        "!MD5",
+        "!DSS",
+    ]
+)
+
+try:
+    from ssl import SSLContext  # Modern SSL?
+except ImportError:
+
+    class SSLContext(object):  # Platform-specific: Python 2
+        def __init__(self, protocol_version):
+            self.protocol = protocol_version
+            # Use default values from a real SSLContext
+            self.check_hostname = False
+            self.verify_mode = ssl.CERT_NONE
+            self.ca_certs = None
+            self.options = 0
+            self.certfile = None
+            self.keyfile = None
+            self.ciphers = None
+
+        def load_cert_chain(self, certfile, keyfile):
+            self.certfile = certfile
+            self.keyfile = keyfile
+
+        def load_verify_locations(self, cafile=None, capath=None, cadata=None):
+            self.ca_certs = cafile
+
+            if capath is not None:
+                raise SSLError("CA directories not supported in older Pythons")
+
+            if cadata is not None:
+                raise SSLError("CA data not supported in older Pythons")
+
+        def set_ciphers(self, cipher_suite):
+            self.ciphers = cipher_suite
+
+        def wrap_socket(self, socket, server_hostname=None, server_side=False):
+            warnings.warn(
+                "A true SSLContext object is not available. This prevents "
+                "urllib3 from configuring SSL appropriately and may cause "
+                "certain SSL connections to fail. You can upgrade to a newer "
+                "version of Python to solve this. For more information, see "
+                "https://urllib3.readthedocs.io/en/1.26.x/advanced-usage.html"
+                "#ssl-warnings",
+                InsecurePlatformWarning,
+            )
+            kwargs = {
+                "keyfile": self.keyfile,
+                "certfile": self.certfile,
+                "ca_certs": self.ca_certs,
+                "cert_reqs": self.verify_mode,
+                "ssl_version": self.protocol,
+                "server_side": server_side,
+            }
+            return wrap_socket(socket, ciphers=self.ciphers, **kwargs)
+
+
+def assert_fingerprint(cert, fingerprint):
+    """
+    Checks if given fingerprint matches the supplied certificate.
+
+    :param cert:
+        Certificate as bytes object.
+    :param fingerprint:
+        Fingerprint as string of hexdigits, can be interspersed by colons.
+    """
+
+    fingerprint = fingerprint.replace(":", "").lower()
+    digest_length = len(fingerprint)
+    if digest_length not in HASHFUNC_MAP:
+        raise SSLError("Fingerprint of invalid length: {0}".format(fingerprint))
+    hashfunc = HASHFUNC_MAP.get(digest_length)
+    if hashfunc is None:
+        raise SSLError(
+            "Hash function implementation unavailable for fingerprint length: {0}".format(
+                digest_length
+            )
+        )
+
+    # We need encode() here for py32; works on py2 and p33.
+    fingerprint_bytes = unhexlify(fingerprint.encode())
+
+    cert_digest = hashfunc(cert).digest()
+
+    if not _const_compare_digest(cert_digest, fingerprint_bytes):
+        raise SSLError(
+            'Fingerprints did not match. Expected "{0}", got "{1}".'.format(
+                fingerprint, hexlify(cert_digest)
+            )
+        )
+
+
+def resolve_cert_reqs(candidate):
+    """
+    Resolves the argument to a numeric constant, which can be passed to
+    the wrap_socket function/method from the ssl module.
+    Defaults to :data:`ssl.CERT_REQUIRED`.
+    If given a string it is assumed to be the name of the constant in the
+    :mod:`ssl` module or its abbreviation.
+    (So you can specify `REQUIRED` instead of `CERT_REQUIRED`.
+    If it's neither `None` nor a string we assume it is already the numeric
+    constant which can directly be passed to wrap_socket.
+    """
+    if candidate is None:
+        return CERT_REQUIRED
+
+    if isinstance(candidate, str):
+        res = getattr(ssl, candidate, None)
+        if res is None:
+            res = getattr(ssl, "CERT_" + candidate)
+        return res
+
+    return candidate
+
+
+def resolve_ssl_version(candidate):
+    """
+    like resolve_cert_reqs
+    """
+    if candidate is None:
+        return PROTOCOL_TLS
+
+    if isinstance(candidate, str):
+        res = getattr(ssl, candidate, None)
+        if res is None:
+            res = getattr(ssl, "PROTOCOL_" + candidate)
+        return res
+
+    return candidate
+
+
+def create_urllib3_context(
+    ssl_version=None, cert_reqs=None, options=None, ciphers=None
+):
+    """All arguments have the same meaning as ``ssl_wrap_socket``.
+
+    By default, this function does a lot of the same work that
+    ``ssl.create_default_context`` does on Python 3.4+. It:
+
+    - Disables SSLv2, SSLv3, and compression
+    - Sets a restricted set of server ciphers
+
+    If you wish to enable SSLv3, you can do::
+
+        from pip._vendor.urllib3.util import ssl_
+        context = ssl_.create_urllib3_context()
+        context.options &= ~ssl_.OP_NO_SSLv3
+
+    You can do the same to enable compression (substituting ``COMPRESSION``
+    for ``SSLv3`` in the last line above).
+
+    :param ssl_version:
+        The desired protocol version to use. This will default to
+        PROTOCOL_SSLv23 which will negotiate the highest protocol that both
+        the server and your installation of OpenSSL support.
+    :param cert_reqs:
+        Whether to require the certificate verification. This defaults to
+        ``ssl.CERT_REQUIRED``.
+    :param options:
+        Specific OpenSSL options. These default to ``ssl.OP_NO_SSLv2``,
+        ``ssl.OP_NO_SSLv3``, ``ssl.OP_NO_COMPRESSION``, and ``ssl.OP_NO_TICKET``.
+    :param ciphers:
+        Which cipher suites to allow the server to select.
+    :returns:
+        Constructed SSLContext object with specified options
+    :rtype: SSLContext
+    """
+    # PROTOCOL_TLS is deprecated in Python 3.10
+    if not ssl_version or ssl_version == PROTOCOL_TLS:
+        ssl_version = PROTOCOL_TLS_CLIENT
+
+    context = SSLContext(ssl_version)
+
+    context.set_ciphers(ciphers or DEFAULT_CIPHERS)
+
+    # Setting the default here, as we may have no ssl module on import
+    cert_reqs = ssl.CERT_REQUIRED if cert_reqs is None else cert_reqs
+
+    if options is None:
+        options = 0
+        # SSLv2 is easily broken and is considered harmful and dangerous
+        options |= OP_NO_SSLv2
+        # SSLv3 has several problems and is now dangerous
+        options |= OP_NO_SSLv3
+        # Disable compression to prevent CRIME attacks for OpenSSL 1.0+
+        # (issue #309)
+        options |= OP_NO_COMPRESSION
+        # TLSv1.2 only. Unless set explicitly, do not request tickets.
+        # This may save some bandwidth on wire, and although the ticket is encrypted,
+        # there is a risk associated with it being on wire,
+        # if the server is not rotating its ticketing keys properly.
+        options |= OP_NO_TICKET
+
+    context.options |= options
+
+    # Enable post-handshake authentication for TLS 1.3, see GH #1634. PHA is
+    # necessary for conditional client cert authentication with TLS 1.3.
+    # The attribute is None for OpenSSL <= 1.1.0 or does not exist in older
+    # versions of Python.  We only enable on Python 3.7.4+ or if certificate
+    # verification is enabled to work around Python issue #37428
+    # See: https://bugs.python.org/issue37428
+    if (cert_reqs == ssl.CERT_REQUIRED or sys.version_info >= (3, 7, 4)) and getattr(
+        context, "post_handshake_auth", None
+    ) is not None:
+        context.post_handshake_auth = True
+
+    def disable_check_hostname():
+        if (
+            getattr(context, "check_hostname", None) is not None
+        ):  # Platform-specific: Python 3.2
+            # We do our own verification, including fingerprints and alternative
+            # hostnames. So disable it here
+            context.check_hostname = False
+
+    # The order of the below lines setting verify_mode and check_hostname
+    # matter due to safe-guards SSLContext has to prevent an SSLContext with
+    # check_hostname=True, verify_mode=NONE/OPTIONAL. This is made even more
+    # complex because we don't know whether PROTOCOL_TLS_CLIENT will be used
+    # or not so we don't know the initial state of the freshly created SSLContext.
+    if cert_reqs == ssl.CERT_REQUIRED:
+        context.verify_mode = cert_reqs
+        disable_check_hostname()
+    else:
+        disable_check_hostname()
+        context.verify_mode = cert_reqs
+
+    # Enable logging of TLS session keys via defacto standard environment variable
+    # 'SSLKEYLOGFILE', if the feature is available (Python 3.8+). Skip empty values.
+    if hasattr(context, "keylog_filename"):
+        sslkeylogfile = os.environ.get("SSLKEYLOGFILE")
+        if sslkeylogfile:
+            context.keylog_filename = sslkeylogfile
+
+    return context
+
+
+def ssl_wrap_socket(
+    sock,
+    keyfile=None,
+    certfile=None,
+    cert_reqs=None,
+    ca_certs=None,
+    server_hostname=None,
+    ssl_version=None,
+    ciphers=None,
+    ssl_context=None,
+    ca_cert_dir=None,
+    key_password=None,
+    ca_cert_data=None,
+    tls_in_tls=False,
+):
+    """
+    All arguments except for server_hostname, ssl_context, and ca_cert_dir have
+    the same meaning as they do when using :func:`ssl.wrap_socket`.
+
+    :param server_hostname:
+        When SNI is supported, the expected hostname of the certificate
+    :param ssl_context:
+        A pre-made :class:`SSLContext` object. If none is provided, one will
+        be created using :func:`create_urllib3_context`.
+    :param ciphers:
+        A string of ciphers we wish the client to support.
+    :param ca_cert_dir:
+        A directory containing CA certificates in multiple separate files, as
+        supported by OpenSSL's -CApath flag or the capath argument to
+        SSLContext.load_verify_locations().
+    :param key_password:
+        Optional password if the keyfile is encrypted.
+    :param ca_cert_data:
+        Optional string containing CA certificates in PEM format suitable for
+        passing as the cadata parameter to SSLContext.load_verify_locations()
+    :param tls_in_tls:
+        Use SSLTransport to wrap the existing socket.
+    """
+    context = ssl_context
+    if context is None:
+        # Note: This branch of code and all the variables in it are no longer
+        # used by urllib3 itself. We should consider deprecating and removing
+        # this code.
+        context = create_urllib3_context(ssl_version, cert_reqs, ciphers=ciphers)
+
+    if ca_certs or ca_cert_dir or ca_cert_data:
+        try:
+            context.load_verify_locations(ca_certs, ca_cert_dir, ca_cert_data)
+        except (IOError, OSError) as e:
+            raise SSLError(e)
+
+    elif ssl_context is None and hasattr(context, "load_default_certs"):
+        # try to load OS default certs; works well on Windows (require Python3.4+)
+        context.load_default_certs()
+
+    # Attempt to detect if we get the goofy behavior of the
+    # keyfile being encrypted and OpenSSL asking for the
+    # passphrase via the terminal and instead error out.
+    if keyfile and key_password is None and _is_key_file_encrypted(keyfile):
+        raise SSLError("Client private key is encrypted, password is required")
+
+    if certfile:
+        if key_password is None:
+            context.load_cert_chain(certfile, keyfile)
+        else:
+            context.load_cert_chain(certfile, keyfile, key_password)
+
+    try:
+        if hasattr(context, "set_alpn_protocols"):
+            context.set_alpn_protocols(ALPN_PROTOCOLS)
+    except NotImplementedError:  # Defensive: in CI, we always have set_alpn_protocols
+        pass
+
+    # If we detect server_hostname is an IP address then the SNI
+    # extension should not be used according to RFC3546 Section 3.1
+    use_sni_hostname = server_hostname and not is_ipaddress(server_hostname)
+    # SecureTransport uses server_hostname in certificate verification.
+    send_sni = (use_sni_hostname and HAS_SNI) or (
+        IS_SECURETRANSPORT and server_hostname
+    )
+    # Do not warn the user if server_hostname is an invalid SNI hostname.
+    if not HAS_SNI and use_sni_hostname:
+        warnings.warn(
+            "An HTTPS request has been made, but the SNI (Server Name "
+            "Indication) extension to TLS is not available on this platform. "
+            "This may cause the server to present an incorrect TLS "
+            "certificate, which can cause validation failures. You can upgrade to "
+            "a newer version of Python to solve this. For more information, see "
+            "https://urllib3.readthedocs.io/en/1.26.x/advanced-usage.html"
+            "#ssl-warnings",
+            SNIMissingWarning,
+        )
+
+    if send_sni:
+        ssl_sock = _ssl_wrap_socket_impl(
+            sock, context, tls_in_tls, server_hostname=server_hostname
+        )
+    else:
+        ssl_sock = _ssl_wrap_socket_impl(sock, context, tls_in_tls)
+    return ssl_sock
+
+
+def is_ipaddress(hostname):
+    """Detects whether the hostname given is an IPv4 or IPv6 address.
+    Also detects IPv6 addresses with Zone IDs.
+
+    :param str hostname: Hostname to examine.
+    :return: True if the hostname is an IP address, False otherwise.
+    """
+    if not six.PY2 and isinstance(hostname, bytes):
+        # IDN A-label bytes are ASCII compatible.
+        hostname = hostname.decode("ascii")
+    return bool(IPV4_RE.match(hostname) or BRACELESS_IPV6_ADDRZ_RE.match(hostname))
+
+
+def _is_key_file_encrypted(key_file):
+    """Detects if a key file is encrypted or not."""
+    with open(key_file, "r") as f:
+        for line in f:
+            # Look for Proc-Type: 4,ENCRYPTED
+            if "ENCRYPTED" in line:
+                return True
+
+    return False
+
+
+def _ssl_wrap_socket_impl(sock, ssl_context, tls_in_tls, server_hostname=None):
+    if tls_in_tls:
+        if not SSLTransport:
+            # Import error, ssl is not available.
+            raise ProxySchemeUnsupported(
+                "TLS in TLS requires support for the 'ssl' module"
+            )
+
+        SSLTransport._validate_ssl_context_for_tls_in_tls(ssl_context)
+        return SSLTransport(sock, ssl_context, server_hostname)
+
+    if server_hostname:
+        return ssl_context.wrap_socket(sock, server_hostname=server_hostname)
+    else:
+        return ssl_context.wrap_socket(sock)
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/ssl_match_hostname.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/ssl_match_hostname.py
new file mode 100644
index 0000000..1dd950c
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/ssl_match_hostname.py
@@ -0,0 +1,159 @@
+"""The match_hostname() function from Python 3.3.3, essential when using SSL."""
+
+# Note: This file is under the PSF license as the code comes from the python
+# stdlib.   http://docs.python.org/3/license.html
+
+import re
+import sys
+
+# ipaddress has been backported to 2.6+ in pypi.  If it is installed on the
+# system, use it to handle IPAddress ServerAltnames (this was added in
+# python-3.5) otherwise only do DNS matching.  This allows
+# util.ssl_match_hostname to continue to be used in Python 2.7.
+try:
+    import ipaddress
+except ImportError:
+    ipaddress = None
+
+__version__ = "3.5.0.1"
+
+
+class CertificateError(ValueError):
+    pass
+
+
+def _dnsname_match(dn, hostname, max_wildcards=1):
+    """Matching according to RFC 6125, section 6.4.3
+
+    http://tools.ietf.org/html/rfc6125#section-6.4.3
+    """
+    pats = []
+    if not dn:
+        return False
+
+    # Ported from python3-syntax:
+    # leftmost, *remainder = dn.split(r'.')
+    parts = dn.split(r".")
+    leftmost = parts[0]
+    remainder = parts[1:]
+
+    wildcards = leftmost.count("*")
+    if wildcards > max_wildcards:
+        # Issue #17980: avoid denials of service by refusing more
+        # than one wildcard per fragment.  A survey of established
+        # policy among SSL implementations showed it to be a
+        # reasonable choice.
+        raise CertificateError(
+            "too many wildcards in certificate DNS name: " + repr(dn)
+        )
+
+    # speed up common case w/o wildcards
+    if not wildcards:
+        return dn.lower() == hostname.lower()
+
+    # RFC 6125, section 6.4.3, subitem 1.
+    # The client SHOULD NOT attempt to match a presented identifier in which
+    # the wildcard character comprises a label other than the left-most label.
+    if leftmost == "*":
+        # When '*' is a fragment by itself, it matches a non-empty dotless
+        # fragment.
+        pats.append("[^.]+")
+    elif leftmost.startswith("xn--") or hostname.startswith("xn--"):
+        # RFC 6125, section 6.4.3, subitem 3.
+        # The client SHOULD NOT attempt to match a presented identifier
+        # where the wildcard character is embedded within an A-label or
+        # U-label of an internationalized domain name.
+        pats.append(re.escape(leftmost))
+    else:
+        # Otherwise, '*' matches any dotless string, e.g. www*
+        pats.append(re.escape(leftmost).replace(r"\*", "[^.]*"))
+
+    # add the remaining fragments, ignore any wildcards
+    for frag in remainder:
+        pats.append(re.escape(frag))
+
+    pat = re.compile(r"\A" + r"\.".join(pats) + r"\Z", re.IGNORECASE)
+    return pat.match(hostname)
+
+
+def _to_unicode(obj):
+    if isinstance(obj, str) and sys.version_info < (3,):
+        # ignored flake8 # F821 to support python 2.7 function
+        obj = unicode(obj, encoding="ascii", errors="strict")  # noqa: F821
+    return obj
+
+
+def _ipaddress_match(ipname, host_ip):
+    """Exact matching of IP addresses.
+
+    RFC 6125 explicitly doesn't define an algorithm for this
+    (section 1.7.2 - "Out of Scope").
+    """
+    # OpenSSL may add a trailing newline to a subjectAltName's IP address
+    # Divergence from upstream: ipaddress can't handle byte str
+    ip = ipaddress.ip_address(_to_unicode(ipname).rstrip())
+    return ip == host_ip
+
+
+def match_hostname(cert, hostname):
+    """Verify that *cert* (in decoded format as returned by
+    SSLSocket.getpeercert()) matches the *hostname*.  RFC 2818 and RFC 6125
+    rules are followed, but IP addresses are not accepted for *hostname*.
+
+    CertificateError is raised on failure. On success, the function
+    returns nothing.
+    """
+    if not cert:
+        raise ValueError(
+            "empty or no certificate, match_hostname needs a "
+            "SSL socket or SSL context with either "
+            "CERT_OPTIONAL or CERT_REQUIRED"
+        )
+    try:
+        # Divergence from upstream: ipaddress can't handle byte str
+        host_ip = ipaddress.ip_address(_to_unicode(hostname))
+    except (UnicodeError, ValueError):
+        # ValueError: Not an IP address (common case)
+        # UnicodeError: Divergence from upstream: Have to deal with ipaddress not taking
+        # byte strings.  addresses should be all ascii, so we consider it not
+        # an ipaddress in this case
+        host_ip = None
+    except AttributeError:
+        # Divergence from upstream: Make ipaddress library optional
+        if ipaddress is None:
+            host_ip = None
+        else:  # Defensive
+            raise
+    dnsnames = []
+    san = cert.get("subjectAltName", ())
+    for key, value in san:
+        if key == "DNS":
+            if host_ip is None and _dnsname_match(value, hostname):
+                return
+            dnsnames.append(value)
+        elif key == "IP Address":
+            if host_ip is not None and _ipaddress_match(value, host_ip):
+                return
+            dnsnames.append(value)
+    if not dnsnames:
+        # The subject is only checked when there is no dNSName entry
+        # in subjectAltName
+        for sub in cert.get("subject", ()):
+            for key, value in sub:
+                # XXX according to RFC 2818, the most specific Common Name
+                # must be used.
+                if key == "commonName":
+                    if _dnsname_match(value, hostname):
+                        return
+                    dnsnames.append(value)
+    if len(dnsnames) > 1:
+        raise CertificateError(
+            "hostname %r "
+            "doesn't match either of %s" % (hostname, ", ".join(map(repr, dnsnames)))
+        )
+    elif len(dnsnames) == 1:
+        raise CertificateError("hostname %r doesn't match %r" % (hostname, dnsnames[0]))
+    else:
+        raise CertificateError(
+            "no appropriate commonName or subjectAltName fields were found"
+        )
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/ssltransport.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/ssltransport.py
new file mode 100644
index 0000000..4a7105d
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/ssltransport.py
@@ -0,0 +1,221 @@
+import io
+import socket
+import ssl
+
+from ..exceptions import ProxySchemeUnsupported
+from ..packages import six
+
+SSL_BLOCKSIZE = 16384
+
+
+class SSLTransport:
+    """
+    The SSLTransport wraps an existing socket and establishes an SSL connection.
+
+    Contrary to Python's implementation of SSLSocket, it allows you to chain
+    multiple TLS connections together. It's particularly useful if you need to
+    implement TLS within TLS.
+
+    The class supports most of the socket API operations.
+    """
+
+    @staticmethod
+    def _validate_ssl_context_for_tls_in_tls(ssl_context):
+        """
+        Raises a ProxySchemeUnsupported if the provided ssl_context can't be used
+        for TLS in TLS.
+
+        The only requirement is that the ssl_context provides the 'wrap_bio'
+        methods.
+        """
+
+        if not hasattr(ssl_context, "wrap_bio"):
+            if six.PY2:
+                raise ProxySchemeUnsupported(
+                    "TLS in TLS requires SSLContext.wrap_bio() which isn't "
+                    "supported on Python 2"
+                )
+            else:
+                raise ProxySchemeUnsupported(
+                    "TLS in TLS requires SSLContext.wrap_bio() which isn't "
+                    "available on non-native SSLContext"
+                )
+
+    def __init__(
+        self, socket, ssl_context, server_hostname=None, suppress_ragged_eofs=True
+    ):
+        """
+        Create an SSLTransport around socket using the provided ssl_context.
+        """
+        self.incoming = ssl.MemoryBIO()
+        self.outgoing = ssl.MemoryBIO()
+
+        self.suppress_ragged_eofs = suppress_ragged_eofs
+        self.socket = socket
+
+        self.sslobj = ssl_context.wrap_bio(
+            self.incoming, self.outgoing, server_hostname=server_hostname
+        )
+
+        # Perform initial handshake.
+        self._ssl_io_loop(self.sslobj.do_handshake)
+
+    def __enter__(self):
+        return self
+
+    def __exit__(self, *_):
+        self.close()
+
+    def fileno(self):
+        return self.socket.fileno()
+
+    def read(self, len=1024, buffer=None):
+        return self._wrap_ssl_read(len, buffer)
+
+    def recv(self, len=1024, flags=0):
+        if flags != 0:
+            raise ValueError("non-zero flags not allowed in calls to recv")
+        return self._wrap_ssl_read(len)
+
+    def recv_into(self, buffer, nbytes=None, flags=0):
+        if flags != 0:
+            raise ValueError("non-zero flags not allowed in calls to recv_into")
+        if buffer and (nbytes is None):
+            nbytes = len(buffer)
+        elif nbytes is None:
+            nbytes = 1024
+        return self.read(nbytes, buffer)
+
+    def sendall(self, data, flags=0):
+        if flags != 0:
+            raise ValueError("non-zero flags not allowed in calls to sendall")
+        count = 0
+        with memoryview(data) as view, view.cast("B") as byte_view:
+            amount = len(byte_view)
+            while count < amount:
+                v = self.send(byte_view[count:])
+                count += v
+
+    def send(self, data, flags=0):
+        if flags != 0:
+            raise ValueError("non-zero flags not allowed in calls to send")
+        response = self._ssl_io_loop(self.sslobj.write, data)
+        return response
+
+    def makefile(
+        self, mode="r", buffering=None, encoding=None, errors=None, newline=None
+    ):
+        """
+        Python's httpclient uses makefile and buffered io when reading HTTP
+        messages and we need to support it.
+
+        This is unfortunately a copy and paste of socket.py makefile with small
+        changes to point to the socket directly.
+        """
+        if not set(mode) <= {"r", "w", "b"}:
+            raise ValueError("invalid mode %r (only r, w, b allowed)" % (mode,))
+
+        writing = "w" in mode
+        reading = "r" in mode or not writing
+        assert reading or writing
+        binary = "b" in mode
+        rawmode = ""
+        if reading:
+            rawmode += "r"
+        if writing:
+            rawmode += "w"
+        raw = socket.SocketIO(self, rawmode)
+        self.socket._io_refs += 1
+        if buffering is None:
+            buffering = -1
+        if buffering < 0:
+            buffering = io.DEFAULT_BUFFER_SIZE
+        if buffering == 0:
+            if not binary:
+                raise ValueError("unbuffered streams must be binary")
+            return raw
+        if reading and writing:
+            buffer = io.BufferedRWPair(raw, raw, buffering)
+        elif reading:
+            buffer = io.BufferedReader(raw, buffering)
+        else:
+            assert writing
+            buffer = io.BufferedWriter(raw, buffering)
+        if binary:
+            return buffer
+        text = io.TextIOWrapper(buffer, encoding, errors, newline)
+        text.mode = mode
+        return text
+
+    def unwrap(self):
+        self._ssl_io_loop(self.sslobj.unwrap)
+
+    def close(self):
+        self.socket.close()
+
+    def getpeercert(self, binary_form=False):
+        return self.sslobj.getpeercert(binary_form)
+
+    def version(self):
+        return self.sslobj.version()
+
+    def cipher(self):
+        return self.sslobj.cipher()
+
+    def selected_alpn_protocol(self):
+        return self.sslobj.selected_alpn_protocol()
+
+    def selected_npn_protocol(self):
+        return self.sslobj.selected_npn_protocol()
+
+    def shared_ciphers(self):
+        return self.sslobj.shared_ciphers()
+
+    def compression(self):
+        return self.sslobj.compression()
+
+    def settimeout(self, value):
+        self.socket.settimeout(value)
+
+    def gettimeout(self):
+        return self.socket.gettimeout()
+
+    def _decref_socketios(self):
+        self.socket._decref_socketios()
+
+    def _wrap_ssl_read(self, len, buffer=None):
+        try:
+            return self._ssl_io_loop(self.sslobj.read, len, buffer)
+        except ssl.SSLError as e:
+            if e.errno == ssl.SSL_ERROR_EOF and self.suppress_ragged_eofs:
+                return 0  # eof, return 0.
+            else:
+                raise
+
+    def _ssl_io_loop(self, func, *args):
+        """Performs an I/O loop between incoming/outgoing and the socket."""
+        should_loop = True
+        ret = None
+
+        while should_loop:
+            errno = None
+            try:
+                ret = func(*args)
+            except ssl.SSLError as e:
+                if e.errno not in (ssl.SSL_ERROR_WANT_READ, ssl.SSL_ERROR_WANT_WRITE):
+                    # WANT_READ, and WANT_WRITE are expected, others are not.
+                    raise e
+                errno = e.errno
+
+            buf = self.outgoing.read()
+            self.socket.sendall(buf)
+
+            if errno is None:
+                should_loop = False
+            elif errno == ssl.SSL_ERROR_WANT_READ:
+                buf = self.socket.recv(SSL_BLOCKSIZE)
+                if buf:
+                    self.incoming.write(buf)
+                else:
+                    self.incoming.write_eof()
+        return ret
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/timeout.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/timeout.py
new file mode 100644
index 0000000..78e18a6
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/timeout.py
@@ -0,0 +1,271 @@
+from __future__ import absolute_import
+
+import time
+
+# The default socket timeout, used by httplib to indicate that no timeout was; specified by the user
+from socket import _GLOBAL_DEFAULT_TIMEOUT, getdefaulttimeout
+
+from ..exceptions import TimeoutStateError
+
+# A sentinel value to indicate that no timeout was specified by the user in
+# urllib3
+_Default = object()
+
+
+# Use time.monotonic if available.
+current_time = getattr(time, "monotonic", time.time)
+
+
+class Timeout(object):
+    """Timeout configuration.
+
+    Timeouts can be defined as a default for a pool:
+
+    .. code-block:: python
+
+       timeout = Timeout(connect=2.0, read=7.0)
+       http = PoolManager(timeout=timeout)
+       response = http.request('GET', 'http://example.com/')
+
+    Or per-request (which overrides the default for the pool):
+
+    .. code-block:: python
+
+       response = http.request('GET', 'http://example.com/', timeout=Timeout(10))
+
+    Timeouts can be disabled by setting all the parameters to ``None``:
+
+    .. code-block:: python
+
+       no_timeout = Timeout(connect=None, read=None)
+       response = http.request('GET', 'http://example.com/, timeout=no_timeout)
+
+
+    :param total:
+        This combines the connect and read timeouts into one; the read timeout
+        will be set to the time leftover from the connect attempt. In the
+        event that both a connect timeout and a total are specified, or a read
+        timeout and a total are specified, the shorter timeout will be applied.
+
+        Defaults to None.
+
+    :type total: int, float, or None
+
+    :param connect:
+        The maximum amount of time (in seconds) to wait for a connection
+        attempt to a server to succeed. Omitting the parameter will default the
+        connect timeout to the system default, probably `the global default
+        timeout in socket.py
+        `_.
+        None will set an infinite timeout for connection attempts.
+
+    :type connect: int, float, or None
+
+    :param read:
+        The maximum amount of time (in seconds) to wait between consecutive
+        read operations for a response from the server. Omitting the parameter
+        will default the read timeout to the system default, probably `the
+        global default timeout in socket.py
+        `_.
+        None will set an infinite timeout.
+
+    :type read: int, float, or None
+
+    .. note::
+
+        Many factors can affect the total amount of time for urllib3 to return
+        an HTTP response.
+
+        For example, Python's DNS resolver does not obey the timeout specified
+        on the socket. Other factors that can affect total request time include
+        high CPU load, high swap, the program running at a low priority level,
+        or other behaviors.
+
+        In addition, the read and total timeouts only measure the time between
+        read operations on the socket connecting the client and the server,
+        not the total amount of time for the request to return a complete
+        response. For most requests, the timeout is raised because the server
+        has not sent the first byte in the specified time. This is not always
+        the case; if a server streams one byte every fifteen seconds, a timeout
+        of 20 seconds will not trigger, even though the request will take
+        several minutes to complete.
+
+        If your goal is to cut off any request after a set amount of wall clock
+        time, consider having a second "watcher" thread to cut off a slow
+        request.
+    """
+
+    #: A sentinel object representing the default timeout value
+    DEFAULT_TIMEOUT = _GLOBAL_DEFAULT_TIMEOUT
+
+    def __init__(self, total=None, connect=_Default, read=_Default):
+        self._connect = self._validate_timeout(connect, "connect")
+        self._read = self._validate_timeout(read, "read")
+        self.total = self._validate_timeout(total, "total")
+        self._start_connect = None
+
+    def __repr__(self):
+        return "%s(connect=%r, read=%r, total=%r)" % (
+            type(self).__name__,
+            self._connect,
+            self._read,
+            self.total,
+        )
+
+    # __str__ provided for backwards compatibility
+    __str__ = __repr__
+
+    @classmethod
+    def resolve_default_timeout(cls, timeout):
+        return getdefaulttimeout() if timeout is cls.DEFAULT_TIMEOUT else timeout
+
+    @classmethod
+    def _validate_timeout(cls, value, name):
+        """Check that a timeout attribute is valid.
+
+        :param value: The timeout value to validate
+        :param name: The name of the timeout attribute to validate. This is
+            used to specify in error messages.
+        :return: The validated and casted version of the given value.
+        :raises ValueError: If it is a numeric value less than or equal to
+            zero, or the type is not an integer, float, or None.
+        """
+        if value is _Default:
+            return cls.DEFAULT_TIMEOUT
+
+        if value is None or value is cls.DEFAULT_TIMEOUT:
+            return value
+
+        if isinstance(value, bool):
+            raise ValueError(
+                "Timeout cannot be a boolean value. It must "
+                "be an int, float or None."
+            )
+        try:
+            float(value)
+        except (TypeError, ValueError):
+            raise ValueError(
+                "Timeout value %s was %s, but it must be an "
+                "int, float or None." % (name, value)
+            )
+
+        try:
+            if value <= 0:
+                raise ValueError(
+                    "Attempted to set %s timeout to %s, but the "
+                    "timeout cannot be set to a value less "
+                    "than or equal to 0." % (name, value)
+                )
+        except TypeError:
+            # Python 3
+            raise ValueError(
+                "Timeout value %s was %s, but it must be an "
+                "int, float or None." % (name, value)
+            )
+
+        return value
+
+    @classmethod
+    def from_float(cls, timeout):
+        """Create a new Timeout from a legacy timeout value.
+
+        The timeout value used by httplib.py sets the same timeout on the
+        connect(), and recv() socket requests. This creates a :class:`Timeout`
+        object that sets the individual timeouts to the ``timeout`` value
+        passed to this function.
+
+        :param timeout: The legacy timeout value.
+        :type timeout: integer, float, sentinel default object, or None
+        :return: Timeout object
+        :rtype: :class:`Timeout`
+        """
+        return Timeout(read=timeout, connect=timeout)
+
+    def clone(self):
+        """Create a copy of the timeout object
+
+        Timeout properties are stored per-pool but each request needs a fresh
+        Timeout object to ensure each one has its own start/stop configured.
+
+        :return: a copy of the timeout object
+        :rtype: :class:`Timeout`
+        """
+        # We can't use copy.deepcopy because that will also create a new object
+        # for _GLOBAL_DEFAULT_TIMEOUT, which socket.py uses as a sentinel to
+        # detect the user default.
+        return Timeout(connect=self._connect, read=self._read, total=self.total)
+
+    def start_connect(self):
+        """Start the timeout clock, used during a connect() attempt
+
+        :raises urllib3.exceptions.TimeoutStateError: if you attempt
+            to start a timer that has been started already.
+        """
+        if self._start_connect is not None:
+            raise TimeoutStateError("Timeout timer has already been started.")
+        self._start_connect = current_time()
+        return self._start_connect
+
+    def get_connect_duration(self):
+        """Gets the time elapsed since the call to :meth:`start_connect`.
+
+        :return: Elapsed time in seconds.
+        :rtype: float
+        :raises urllib3.exceptions.TimeoutStateError: if you attempt
+            to get duration for a timer that hasn't been started.
+        """
+        if self._start_connect is None:
+            raise TimeoutStateError(
+                "Can't get connect duration for timer that has not started."
+            )
+        return current_time() - self._start_connect
+
+    @property
+    def connect_timeout(self):
+        """Get the value to use when setting a connection timeout.
+
+        This will be a positive float or integer, the value None
+        (never timeout), or the default system timeout.
+
+        :return: Connect timeout.
+        :rtype: int, float, :attr:`Timeout.DEFAULT_TIMEOUT` or None
+        """
+        if self.total is None:
+            return self._connect
+
+        if self._connect is None or self._connect is self.DEFAULT_TIMEOUT:
+            return self.total
+
+        return min(self._connect, self.total)
+
+    @property
+    def read_timeout(self):
+        """Get the value for the read timeout.
+
+        This assumes some time has elapsed in the connection timeout and
+        computes the read timeout appropriately.
+
+        If self.total is set, the read timeout is dependent on the amount of
+        time taken by the connect timeout. If the connection time has not been
+        established, a :exc:`~urllib3.exceptions.TimeoutStateError` will be
+        raised.
+
+        :return: Value to use for the read timeout.
+        :rtype: int, float, :attr:`Timeout.DEFAULT_TIMEOUT` or None
+        :raises urllib3.exceptions.TimeoutStateError: If :meth:`start_connect`
+            has not yet been called on this object.
+        """
+        if (
+            self.total is not None
+            and self.total is not self.DEFAULT_TIMEOUT
+            and self._read is not None
+            and self._read is not self.DEFAULT_TIMEOUT
+        ):
+            # In case the connect timeout has not yet been established.
+            if self._start_connect is None:
+                return self._read
+            return max(0, min(self.total - self.get_connect_duration(), self._read))
+        elif self.total is not None and self.total is not self.DEFAULT_TIMEOUT:
+            return max(0, self.total - self.get_connect_duration())
+        else:
+            return self._read
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/url.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/url.py
new file mode 100644
index 0000000..a960b2f
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/url.py
@@ -0,0 +1,435 @@
+from __future__ import absolute_import
+
+import re
+from collections import namedtuple
+
+from ..exceptions import LocationParseError
+from ..packages import six
+
+url_attrs = ["scheme", "auth", "host", "port", "path", "query", "fragment"]
+
+# We only want to normalize urls with an HTTP(S) scheme.
+# urllib3 infers URLs without a scheme (None) to be http.
+NORMALIZABLE_SCHEMES = ("http", "https", None)
+
+# Almost all of these patterns were derived from the
+# 'rfc3986' module: https://github.com/python-hyper/rfc3986
+PERCENT_RE = re.compile(r"%[a-fA-F0-9]{2}")
+SCHEME_RE = re.compile(r"^(?:[a-zA-Z][a-zA-Z0-9+-]*:|/)")
+URI_RE = re.compile(
+    r"^(?:([a-zA-Z][a-zA-Z0-9+.-]*):)?"
+    r"(?://([^\\/?#]*))?"
+    r"([^?#]*)"
+    r"(?:\?([^#]*))?"
+    r"(?:#(.*))?$",
+    re.UNICODE | re.DOTALL,
+)
+
+IPV4_PAT = r"(?:[0-9]{1,3}\.){3}[0-9]{1,3}"
+HEX_PAT = "[0-9A-Fa-f]{1,4}"
+LS32_PAT = "(?:{hex}:{hex}|{ipv4})".format(hex=HEX_PAT, ipv4=IPV4_PAT)
+_subs = {"hex": HEX_PAT, "ls32": LS32_PAT}
+_variations = [
+    #                            6( h16 ":" ) ls32
+    "(?:%(hex)s:){6}%(ls32)s",
+    #                       "::" 5( h16 ":" ) ls32
+    "::(?:%(hex)s:){5}%(ls32)s",
+    # [               h16 ] "::" 4( h16 ":" ) ls32
+    "(?:%(hex)s)?::(?:%(hex)s:){4}%(ls32)s",
+    # [ *1( h16 ":" ) h16 ] "::" 3( h16 ":" ) ls32
+    "(?:(?:%(hex)s:)?%(hex)s)?::(?:%(hex)s:){3}%(ls32)s",
+    # [ *2( h16 ":" ) h16 ] "::" 2( h16 ":" ) ls32
+    "(?:(?:%(hex)s:){0,2}%(hex)s)?::(?:%(hex)s:){2}%(ls32)s",
+    # [ *3( h16 ":" ) h16 ] "::"    h16 ":"   ls32
+    "(?:(?:%(hex)s:){0,3}%(hex)s)?::%(hex)s:%(ls32)s",
+    # [ *4( h16 ":" ) h16 ] "::"              ls32
+    "(?:(?:%(hex)s:){0,4}%(hex)s)?::%(ls32)s",
+    # [ *5( h16 ":" ) h16 ] "::"              h16
+    "(?:(?:%(hex)s:){0,5}%(hex)s)?::%(hex)s",
+    # [ *6( h16 ":" ) h16 ] "::"
+    "(?:(?:%(hex)s:){0,6}%(hex)s)?::",
+]
+
+UNRESERVED_PAT = r"ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789._\-~"
+IPV6_PAT = "(?:" + "|".join([x % _subs for x in _variations]) + ")"
+ZONE_ID_PAT = "(?:%25|%)(?:[" + UNRESERVED_PAT + "]|%[a-fA-F0-9]{2})+"
+IPV6_ADDRZ_PAT = r"\[" + IPV6_PAT + r"(?:" + ZONE_ID_PAT + r")?\]"
+REG_NAME_PAT = r"(?:[^\[\]%:/?#]|%[a-fA-F0-9]{2})*"
+TARGET_RE = re.compile(r"^(/[^?#]*)(?:\?([^#]*))?(?:#.*)?$")
+
+IPV4_RE = re.compile("^" + IPV4_PAT + "$")
+IPV6_RE = re.compile("^" + IPV6_PAT + "$")
+IPV6_ADDRZ_RE = re.compile("^" + IPV6_ADDRZ_PAT + "$")
+BRACELESS_IPV6_ADDRZ_RE = re.compile("^" + IPV6_ADDRZ_PAT[2:-2] + "$")
+ZONE_ID_RE = re.compile("(" + ZONE_ID_PAT + r")\]$")
+
+_HOST_PORT_PAT = ("^(%s|%s|%s)(?::0*?(|0|[1-9][0-9]{0,4}))?$") % (
+    REG_NAME_PAT,
+    IPV4_PAT,
+    IPV6_ADDRZ_PAT,
+)
+_HOST_PORT_RE = re.compile(_HOST_PORT_PAT, re.UNICODE | re.DOTALL)
+
+UNRESERVED_CHARS = set(
+    "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789._-~"
+)
+SUB_DELIM_CHARS = set("!$&'()*+,;=")
+USERINFO_CHARS = UNRESERVED_CHARS | SUB_DELIM_CHARS | {":"}
+PATH_CHARS = USERINFO_CHARS | {"@", "/"}
+QUERY_CHARS = FRAGMENT_CHARS = PATH_CHARS | {"?"}
+
+
+class Url(namedtuple("Url", url_attrs)):
+    """
+    Data structure for representing an HTTP URL. Used as a return value for
+    :func:`parse_url`. Both the scheme and host are normalized as they are
+    both case-insensitive according to RFC 3986.
+    """
+
+    __slots__ = ()
+
+    def __new__(
+        cls,
+        scheme=None,
+        auth=None,
+        host=None,
+        port=None,
+        path=None,
+        query=None,
+        fragment=None,
+    ):
+        if path and not path.startswith("/"):
+            path = "/" + path
+        if scheme is not None:
+            scheme = scheme.lower()
+        return super(Url, cls).__new__(
+            cls, scheme, auth, host, port, path, query, fragment
+        )
+
+    @property
+    def hostname(self):
+        """For backwards-compatibility with urlparse. We're nice like that."""
+        return self.host
+
+    @property
+    def request_uri(self):
+        """Absolute path including the query string."""
+        uri = self.path or "/"
+
+        if self.query is not None:
+            uri += "?" + self.query
+
+        return uri
+
+    @property
+    def netloc(self):
+        """Network location including host and port"""
+        if self.port:
+            return "%s:%d" % (self.host, self.port)
+        return self.host
+
+    @property
+    def url(self):
+        """
+        Convert self into a url
+
+        This function should more or less round-trip with :func:`.parse_url`. The
+        returned url may not be exactly the same as the url inputted to
+        :func:`.parse_url`, but it should be equivalent by the RFC (e.g., urls
+        with a blank port will have : removed).
+
+        Example: ::
+
+            >>> U = parse_url('http://google.com/mail/')
+            >>> U.url
+            'http://google.com/mail/'
+            >>> Url('http', 'username:password', 'host.com', 80,
+            ... '/path', 'query', 'fragment').url
+            'http://username:password@host.com:80/path?query#fragment'
+        """
+        scheme, auth, host, port, path, query, fragment = self
+        url = u""
+
+        # We use "is not None" we want things to happen with empty strings (or 0 port)
+        if scheme is not None:
+            url += scheme + u"://"
+        if auth is not None:
+            url += auth + u"@"
+        if host is not None:
+            url += host
+        if port is not None:
+            url += u":" + str(port)
+        if path is not None:
+            url += path
+        if query is not None:
+            url += u"?" + query
+        if fragment is not None:
+            url += u"#" + fragment
+
+        return url
+
+    def __str__(self):
+        return self.url
+
+
+def split_first(s, delims):
+    """
+    .. deprecated:: 1.25
+
+    Given a string and an iterable of delimiters, split on the first found
+    delimiter. Return two split parts and the matched delimiter.
+
+    If not found, then the first part is the full input string.
+
+    Example::
+
+        >>> split_first('foo/bar?baz', '?/=')
+        ('foo', 'bar?baz', '/')
+        >>> split_first('foo/bar?baz', '123')
+        ('foo/bar?baz', '', None)
+
+    Scales linearly with number of delims. Not ideal for large number of delims.
+    """
+    min_idx = None
+    min_delim = None
+    for d in delims:
+        idx = s.find(d)
+        if idx < 0:
+            continue
+
+        if min_idx is None or idx < min_idx:
+            min_idx = idx
+            min_delim = d
+
+    if min_idx is None or min_idx < 0:
+        return s, "", None
+
+    return s[:min_idx], s[min_idx + 1 :], min_delim
+
+
+def _encode_invalid_chars(component, allowed_chars, encoding="utf-8"):
+    """Percent-encodes a URI component without reapplying
+    onto an already percent-encoded component.
+    """
+    if component is None:
+        return component
+
+    component = six.ensure_text(component)
+
+    # Normalize existing percent-encoded bytes.
+    # Try to see if the component we're encoding is already percent-encoded
+    # so we can skip all '%' characters but still encode all others.
+    component, percent_encodings = PERCENT_RE.subn(
+        lambda match: match.group(0).upper(), component
+    )
+
+    uri_bytes = component.encode("utf-8", "surrogatepass")
+    is_percent_encoded = percent_encodings == uri_bytes.count(b"%")
+    encoded_component = bytearray()
+
+    for i in range(0, len(uri_bytes)):
+        # Will return a single character bytestring on both Python 2 & 3
+        byte = uri_bytes[i : i + 1]
+        byte_ord = ord(byte)
+        if (is_percent_encoded and byte == b"%") or (
+            byte_ord < 128 and byte.decode() in allowed_chars
+        ):
+            encoded_component += byte
+            continue
+        encoded_component.extend(b"%" + (hex(byte_ord)[2:].encode().zfill(2).upper()))
+
+    return encoded_component.decode(encoding)
+
+
+def _remove_path_dot_segments(path):
+    # See http://tools.ietf.org/html/rfc3986#section-5.2.4 for pseudo-code
+    segments = path.split("/")  # Turn the path into a list of segments
+    output = []  # Initialize the variable to use to store output
+
+    for segment in segments:
+        # '.' is the current directory, so ignore it, it is superfluous
+        if segment == ".":
+            continue
+        # Anything other than '..', should be appended to the output
+        elif segment != "..":
+            output.append(segment)
+        # In this case segment == '..', if we can, we should pop the last
+        # element
+        elif output:
+            output.pop()
+
+    # If the path starts with '/' and the output is empty or the first string
+    # is non-empty
+    if path.startswith("/") and (not output or output[0]):
+        output.insert(0, "")
+
+    # If the path starts with '/.' or '/..' ensure we add one more empty
+    # string to add a trailing '/'
+    if path.endswith(("/.", "/..")):
+        output.append("")
+
+    return "/".join(output)
+
+
+def _normalize_host(host, scheme):
+    if host:
+        if isinstance(host, six.binary_type):
+            host = six.ensure_str(host)
+
+        if scheme in NORMALIZABLE_SCHEMES:
+            is_ipv6 = IPV6_ADDRZ_RE.match(host)
+            if is_ipv6:
+                # IPv6 hosts of the form 'a::b%zone' are encoded in a URL as
+                # such per RFC 6874: 'a::b%25zone'. Unquote the ZoneID
+                # separator as necessary to return a valid RFC 4007 scoped IP.
+                match = ZONE_ID_RE.search(host)
+                if match:
+                    start, end = match.span(1)
+                    zone_id = host[start:end]
+
+                    if zone_id.startswith("%25") and zone_id != "%25":
+                        zone_id = zone_id[3:]
+                    else:
+                        zone_id = zone_id[1:]
+                    zone_id = "%" + _encode_invalid_chars(zone_id, UNRESERVED_CHARS)
+                    return host[:start].lower() + zone_id + host[end:]
+                else:
+                    return host.lower()
+            elif not IPV4_RE.match(host):
+                return six.ensure_str(
+                    b".".join([_idna_encode(label) for label in host.split(".")])
+                )
+    return host
+
+
+def _idna_encode(name):
+    if name and any(ord(x) >= 128 for x in name):
+        try:
+            from pip._vendor import idna
+        except ImportError:
+            six.raise_from(
+                LocationParseError("Unable to parse URL without the 'idna' module"),
+                None,
+            )
+        try:
+            return idna.encode(name.lower(), strict=True, std3_rules=True)
+        except idna.IDNAError:
+            six.raise_from(
+                LocationParseError(u"Name '%s' is not a valid IDNA label" % name), None
+            )
+    return name.lower().encode("ascii")
+
+
+def _encode_target(target):
+    """Percent-encodes a request target so that there are no invalid characters"""
+    path, query = TARGET_RE.match(target).groups()
+    target = _encode_invalid_chars(path, PATH_CHARS)
+    query = _encode_invalid_chars(query, QUERY_CHARS)
+    if query is not None:
+        target += "?" + query
+    return target
+
+
+def parse_url(url):
+    """
+    Given a url, return a parsed :class:`.Url` namedtuple. Best-effort is
+    performed to parse incomplete urls. Fields not provided will be None.
+    This parser is RFC 3986 and RFC 6874 compliant.
+
+    The parser logic and helper functions are based heavily on
+    work done in the ``rfc3986`` module.
+
+    :param str url: URL to parse into a :class:`.Url` namedtuple.
+
+    Partly backwards-compatible with :mod:`urlparse`.
+
+    Example::
+
+        >>> parse_url('http://google.com/mail/')
+        Url(scheme='http', host='google.com', port=None, path='/mail/', ...)
+        >>> parse_url('google.com:80')
+        Url(scheme=None, host='google.com', port=80, path=None, ...)
+        >>> parse_url('/foo?bar')
+        Url(scheme=None, host=None, port=None, path='/foo', query='bar', ...)
+    """
+    if not url:
+        # Empty
+        return Url()
+
+    source_url = url
+    if not SCHEME_RE.search(url):
+        url = "//" + url
+
+    try:
+        scheme, authority, path, query, fragment = URI_RE.match(url).groups()
+        normalize_uri = scheme is None or scheme.lower() in NORMALIZABLE_SCHEMES
+
+        if scheme:
+            scheme = scheme.lower()
+
+        if authority:
+            auth, _, host_port = authority.rpartition("@")
+            auth = auth or None
+            host, port = _HOST_PORT_RE.match(host_port).groups()
+            if auth and normalize_uri:
+                auth = _encode_invalid_chars(auth, USERINFO_CHARS)
+            if port == "":
+                port = None
+        else:
+            auth, host, port = None, None, None
+
+        if port is not None:
+            port = int(port)
+            if not (0 <= port <= 65535):
+                raise LocationParseError(url)
+
+        host = _normalize_host(host, scheme)
+
+        if normalize_uri and path:
+            path = _remove_path_dot_segments(path)
+            path = _encode_invalid_chars(path, PATH_CHARS)
+        if normalize_uri and query:
+            query = _encode_invalid_chars(query, QUERY_CHARS)
+        if normalize_uri and fragment:
+            fragment = _encode_invalid_chars(fragment, FRAGMENT_CHARS)
+
+    except (ValueError, AttributeError):
+        return six.raise_from(LocationParseError(source_url), None)
+
+    # For the sake of backwards compatibility we put empty
+    # string values for path if there are any defined values
+    # beyond the path in the URL.
+    # TODO: Remove this when we break backwards compatibility.
+    if not path:
+        if query is not None or fragment is not None:
+            path = ""
+        else:
+            path = None
+
+    # Ensure that each part of the URL is a `str` for
+    # backwards compatibility.
+    if isinstance(url, six.text_type):
+        ensure_func = six.ensure_text
+    else:
+        ensure_func = six.ensure_str
+
+    def ensure_type(x):
+        return x if x is None else ensure_func(x)
+
+    return Url(
+        scheme=ensure_type(scheme),
+        auth=ensure_type(auth),
+        host=ensure_type(host),
+        port=port,
+        path=ensure_type(path),
+        query=ensure_type(query),
+        fragment=ensure_type(fragment),
+    )
+
+
+def get_host(url):
+    """
+    Deprecated. Use :func:`parse_url` instead.
+    """
+    p = parse_url(url)
+    return p.scheme or "http", p.hostname, p.port
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/wait.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/wait.py
new file mode 100644
index 0000000..21b4590
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/wait.py
@@ -0,0 +1,152 @@
+import errno
+import select
+import sys
+from functools import partial
+
+try:
+    from time import monotonic
+except ImportError:
+    from time import time as monotonic
+
+__all__ = ["NoWayToWaitForSocketError", "wait_for_read", "wait_for_write"]
+
+
+class NoWayToWaitForSocketError(Exception):
+    pass
+
+
+# How should we wait on sockets?
+#
+# There are two types of APIs you can use for waiting on sockets: the fancy
+# modern stateful APIs like epoll/kqueue, and the older stateless APIs like
+# select/poll. The stateful APIs are more efficient when you have a lots of
+# sockets to keep track of, because you can set them up once and then use them
+# lots of times. But we only ever want to wait on a single socket at a time
+# and don't want to keep track of state, so the stateless APIs are actually
+# more efficient. So we want to use select() or poll().
+#
+# Now, how do we choose between select() and poll()? On traditional Unixes,
+# select() has a strange calling convention that makes it slow, or fail
+# altogether, for high-numbered file descriptors. The point of poll() is to fix
+# that, so on Unixes, we prefer poll().
+#
+# On Windows, there is no poll() (or at least Python doesn't provide a wrapper
+# for it), but that's OK, because on Windows, select() doesn't have this
+# strange calling convention; plain select() works fine.
+#
+# So: on Windows we use select(), and everywhere else we use poll(). We also
+# fall back to select() in case poll() is somehow broken or missing.
+
+if sys.version_info >= (3, 5):
+    # Modern Python, that retries syscalls by default
+    def _retry_on_intr(fn, timeout):
+        return fn(timeout)
+
+else:
+    # Old and broken Pythons.
+    def _retry_on_intr(fn, timeout):
+        if timeout is None:
+            deadline = float("inf")
+        else:
+            deadline = monotonic() + timeout
+
+        while True:
+            try:
+                return fn(timeout)
+            # OSError for 3 <= pyver < 3.5, select.error for pyver <= 2.7
+            except (OSError, select.error) as e:
+                # 'e.args[0]' incantation works for both OSError and select.error
+                if e.args[0] != errno.EINTR:
+                    raise
+                else:
+                    timeout = deadline - monotonic()
+                    if timeout < 0:
+                        timeout = 0
+                    if timeout == float("inf"):
+                        timeout = None
+                    continue
+
+
+def select_wait_for_socket(sock, read=False, write=False, timeout=None):
+    if not read and not write:
+        raise RuntimeError("must specify at least one of read=True, write=True")
+    rcheck = []
+    wcheck = []
+    if read:
+        rcheck.append(sock)
+    if write:
+        wcheck.append(sock)
+    # When doing a non-blocking connect, most systems signal success by
+    # marking the socket writable. Windows, though, signals success by marked
+    # it as "exceptional". We paper over the difference by checking the write
+    # sockets for both conditions. (The stdlib selectors module does the same
+    # thing.)
+    fn = partial(select.select, rcheck, wcheck, wcheck)
+    rready, wready, xready = _retry_on_intr(fn, timeout)
+    return bool(rready or wready or xready)
+
+
+def poll_wait_for_socket(sock, read=False, write=False, timeout=None):
+    if not read and not write:
+        raise RuntimeError("must specify at least one of read=True, write=True")
+    mask = 0
+    if read:
+        mask |= select.POLLIN
+    if write:
+        mask |= select.POLLOUT
+    poll_obj = select.poll()
+    poll_obj.register(sock, mask)
+
+    # For some reason, poll() takes timeout in milliseconds
+    def do_poll(t):
+        if t is not None:
+            t *= 1000
+        return poll_obj.poll(t)
+
+    return bool(_retry_on_intr(do_poll, timeout))
+
+
+def null_wait_for_socket(*args, **kwargs):
+    raise NoWayToWaitForSocketError("no select-equivalent available")
+
+
+def _have_working_poll():
+    # Apparently some systems have a select.poll that fails as soon as you try
+    # to use it, either due to strange configuration or broken monkeypatching
+    # from libraries like eventlet/greenlet.
+    try:
+        poll_obj = select.poll()
+        _retry_on_intr(poll_obj.poll, 0)
+    except (AttributeError, OSError):
+        return False
+    else:
+        return True
+
+
+def wait_for_socket(*args, **kwargs):
+    # We delay choosing which implementation to use until the first time we're
+    # called. We could do it at import time, but then we might make the wrong
+    # decision if someone goes wild with monkeypatching select.poll after
+    # we're imported.
+    global wait_for_socket
+    if _have_working_poll():
+        wait_for_socket = poll_wait_for_socket
+    elif hasattr(select, "select"):
+        wait_for_socket = select_wait_for_socket
+    else:  # Platform-specific: Appengine.
+        wait_for_socket = null_wait_for_socket
+    return wait_for_socket(*args, **kwargs)
+
+
+def wait_for_read(sock, timeout=None):
+    """Waits for reading to be available on a given socket.
+    Returns True if the socket is readable, or False if the timeout expired.
+    """
+    return wait_for_socket(sock, read=True, timeout=timeout)
+
+
+def wait_for_write(sock, timeout=None):
+    """Waits for writing to be available on a given socket.
+    Returns True if the socket is readable, or False if the timeout expired.
+    """
+    return wait_for_socket(sock, write=True, timeout=timeout)
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/vendor.txt b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/vendor.txt
new file mode 100644
index 0000000..f04a9c1
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/_vendor/vendor.txt
@@ -0,0 +1,18 @@
+CacheControl==0.14.1
+distlib==0.3.9
+distro==1.9.0
+msgpack==1.1.0
+packaging==24.2
+platformdirs==4.3.6
+pyproject-hooks==1.2.0
+requests==2.32.3
+    certifi==2024.8.30
+    idna==3.10
+    urllib3==1.26.20
+rich==13.9.4
+    pygments==2.18.0
+    typing_extensions==4.12.2
+resolvelib==1.0.1
+setuptools==70.3.0
+tomli==2.2.1
+truststore==0.10.0
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pip/py.typed b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/py.typed
new file mode 100644
index 0000000..493b53e
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pip/py.typed
@@ -0,0 +1,4 @@
+pip is a command line program. While it is implemented in Python, and so is
+available for import, you must not use pip's internal APIs in this way. Typing
+information is provided as a convenience only and is not a guarantee. Expect
+unannounced changes to the API and types in releases.
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame-2.6.1.dist-info/INSTALLER b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame-2.6.1.dist-info/INSTALLER
new file mode 100644
index 0000000..a1b589e
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame-2.6.1.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame-2.6.1.dist-info/METADATA b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame-2.6.1.dist-info/METADATA
new file mode 100644
index 0000000..7dd6e73
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame-2.6.1.dist-info/METADATA
@@ -0,0 +1,311 @@
+Metadata-Version: 2.1
+Name: pygame
+Version: 2.6.1
+Summary: Python Game Development
+Home-page: https://www.pygame.org
+Author: A community project.
+Author-email: pygame@pygame.org
+License: LGPL
+Project-URL: Documentation, https://pygame.org/docs
+Project-URL: Bug Tracker, https://github.com/pygame/pygame/issues
+Project-URL: Source, https://github.com/pygame/pygame
+Project-URL: Twitter, https://twitter.com/pygame_org
+Classifier: Development Status :: 6 - Mature
+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 :: Objective C
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.6
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 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: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: POSIX
+Classifier: Operating System :: Unix
+Classifier: Operating System :: MacOS
+Requires-Python: >=3.6
+Description-Content-Type: text/x-rst
+
+.. image:: https://raw.githubusercontent.com/pygame/pygame/main/docs/reST/_static/pygame_logo.svg
+  :alt: pygame
+  :target: https://www.pygame.org/
+
+
+|AppVeyorBuild| |PyPiVersion| |PyPiLicense|
+|Python3| |GithubCommits| |BlackFormatBadge|
+
+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.
+
+`We need your help`_ to make pygame the best it can be!
+New contributors are welcome.
+
+
+Installation
+------------
+
+Before installing pygame, you must check that Python is installed
+on your machine. To find out, open a command prompt (if you have
+Windows) or a terminal (if you have MacOS or Linux) and type this:
+::
+
+   python --version
+
+
+If a message such as "Python 3.8.10" appears, it means that Python
+is correctly installed. If an error message appears, it means that
+it is not installed yet. You must then go to the `official website
+`_ to download it.
+
+Once Python is installed, you have to perform a final check: you have
+to see if pip is installed. Generally, pip is pre-installed with
+Python but we are never sure. Same as for Python, type the following
+command:
+::
+
+   pip --version
+
+
+If a message such as "pip 20.0.2 from /usr/lib/python3/dist-packages/pip
+(python 3.8)" appears, you are ready to install pygame! To install
+it, enter this command:
+::
+
+   pip install pygame
+
+Once pygame is installed, quickly test your library by entering the following
+command, which opens one of the many example games that comes pre-installed: 
+::
+
+	python3 -m pygame.examples.aliens
+
+
+If this doesn’t work, the `Getting Started 
+`_ section of the official 
+website has more information for platform specific issues, such as adding
+python to your machine’s PATH settings
+
+
+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 --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.
+
+
+Features
+----------
+
+Pygame is a powerful library for game development, offering a wide
+range of features to simplify your coding journey. Let's delve into
+what pygame has to offer:
+
+Graphics - With pygame, creating dynamic and engaging graphics has
+never been easier. The library provides simple yet effective tools for
+2D graphics and animation, including support for images, rectangles,
+and polygon shapes. Whether you're a seasoned game developer or just
+starting out, pygame has you covered.
+
+Sound - Pygame also includes support for playing and manipulating sound
+and music, making it easy to add sound effects and background music to
+your games. With support for WAV, MP3, and OGG file formats, you have
+plenty of options to choose from.
+
+Input - Pygame provides intuitive functions for handling keyboard, mouse,
+and joystick input, allowing you to quickly and easily implement player
+controls in your games. No more struggling with complex input code, pygame
+makes it simple.
+
+Game Development - Lastly, pygame provides a comprehensive suite of tools
+and features specifically designed for game development. From collision
+detection to sprite management, pygame has everything you need to create
+exciting and engaging games. Whether you're building a platformer, puzzle
+game, or anything in between, pygame has you covered.
+
+
+Building From Source
+--------------------
+
+If you want to use features that are currently in development,
+or you want to contribute to pygame, you will need to build pygame
+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`_.
+
+Contribute
+----------
+
+* `Documentation Contributions `_ - Guidelines for contributing to the main documentations
+* `Writing your first unit test `_ - Step by step guide on how to write your first unit test in Python for Pygame.
+* `How to Hack Pygame `_ - Information on hacking, developing, and modifying Pygame
+* `Issue Tracker for beginners `_ - A way for beginners to contribute to the project
+* `Bugs & Patches `_ - Report bugs
+* `Communication tools `_ - More information and ways to get in touch with the Pygame team
+
+
+Credits
+-------
+
+Thanks to everyone who has helped contribute to this library.
+Special thanks are also in order.
+
+* Marcus Von Appen: many changes, and fixes, 1.7.1+ freebsd maintainer
+* Lenard Lindstrom: the 1.8+ windows maintainer, many changes, and fixes
+* Brian Fisher for svn auto builder, bug tracker and many contributions
+* Rene Dudfield: many changes, and fixes, 1.7+ release manager/maintainer
+* Phil Hassey for his work on the pygame.org website
+* DR0ID for his work on the sprite module
+* Richard Goedeken for his smoothscale function
+* Ulf Ekström for his pixel perfect collision detection code
+* Pete Shinners: original author
+* David Clark for filling the right-hand-man position
+* Ed Boraas and Francis Irving: Debian packages
+* Maxim Sobolev: FreeBSD packaging
+* Bob Ippolito: MacOS and OS X porting (much work!)
+* Jan Ekhol, Ray Kelm, and Peter Nicolai: putting up with early design ideas
+* Nat Pryce for starting our unit tests
+* Dan Richter for documentation work
+* TheCorruptor for his incredible logos and graphics
+* Nicholas Dudfield: many test improvements
+* Alex Folkner for pygame-ctypes
+
+Thanks to those sending in patches and fixes: Niki Spahiev, Gordon
+Tyler, Nathaniel Pryce, Dave Wallace, John Popplewell, Michael Urman,
+Andrew Straw, Michael Hudson, Ole Martin Bjoerndalen, Herve Cauwelier,
+James Mazer, Lalo Martins, Timothy Stranex, Chad Lester, Matthias
+Spiller, Bo Jangeborg, Dmitry Borisov, Campbell Barton, Diego Essaya,
+Eyal Lotem, Regis Desgroppes, Emmanuel Hainry, Randy Kaelber
+Matthew L Daniel, Nirav Patel, Forrest Voight, Charlie Nolan,
+Frankie Robertson, John Krukoff, Lorenz Quack, Nick Irvine,
+Michael George, Saul Spatz, Thomas Ibbotson, Tom Rothamel, Evan Kroske,
+Cambell Barton.
+
+And our bug hunters above and beyond: Angus, Guillaume Proux, Frank
+Raiser, Austin Henry, Kaweh Kazemi, Arturo Aldama, Mike Mulcheck,
+Michael Benfield, David Lau
+
+There's many more folks out there who've submitted helpful ideas, kept
+this project going, and basically made our life easier.  Thanks!
+
+Many thank you's for people making documentation comments, and adding to the
+pygame.org wiki.
+
+Also many thanks for people creating games and putting them on the
+pygame.org website for others to learn from and enjoy.
+
+Lots of thanks to James Paige for hosting the pygame bugzilla.
+
+Also a big thanks to Roger Dingledine and the crew at SEUL.ORG for our
+excellent hosting.
+
+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, which also can use libjpeg and libpng.  The
+transform module has an embedded version of SDL_rotozoom for its
+own rotozoom function.  The surfarray module requires the Python
+NumPy package for its multidimensional numeric arrays.
+Dependency versions:
+
+
++----------+------------------------+
+| CPython  | >= 3.6 (Or use PyPy3)  |
++----------+------------------------+
+| SDL      | >= 2.0.8               |
++----------+------------------------+
+| SDL_mixer| >= 2.0.0               |
++----------+------------------------+
+| SDL_image| >= 2.0.2               |
++----------+------------------------+
+| SDL_ttf  | >= 2.0.11              |
++----------+------------------------+
+| SDL_gfx  | (Optional, vendored in)|
++----------+------------------------+
+| NumPy    | >= 1.6.2 (Optional)    |
++----------+------------------------+
+
+
+
+License
+-------
+
+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 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.
+
+
+.. |AppVeyorBuild| image:: https://ci.appveyor.com/api/projects/status/x4074ybuobsh4myx?svg=true
+   :target: https://ci.appveyor.com/project/pygame/pygame
+
+.. |PyPiVersion| image:: https://img.shields.io/pypi/v/pygame.svg?v=1
+   :target: https://pypi.python.org/pypi/pygame
+
+.. |PyPiLicense| image:: https://img.shields.io/pypi/l/pygame.svg?v=1
+   :target: https://pypi.python.org/pypi/pygame
+
+.. |Python3| image:: https://img.shields.io/badge/python-3-blue.svg?v=1
+
+.. |GithubCommits| image:: https://img.shields.io/github/commits-since/pygame/pygame/2.1.2.svg
+   :target: https://github.com/pygame/pygame/compare/2.1.2...main
+
+.. |BlackFormatBadge| image:: https://img.shields.io/badge/code%20style-black-000000.svg
+    :target: https://github.com/psf/black
+
+.. _pygame: https://www.pygame.org
+.. _Simple DirectMedia Layer library: https://www.libsdl.org
+.. _We need your help: https://www.pygame.org/contribute.html
+.. _Compilation wiki page: https://www.pygame.org/wiki/Compilation
+.. _docs page: https://www.pygame.org/docs/
+.. _GNU LGPL version 2.1: https://www.gnu.org/copyleft/lesser.html
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame-2.6.1.dist-info/RECORD b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame-2.6.1.dist-info/RECORD
new file mode 100644
index 0000000..cffcced
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame-2.6.1.dist-info/RECORD
@@ -0,0 +1,786 @@
+../../../include/site/python3.12/pygame/_blit_info.h,sha256=wRHRXxQ9k7NBMHHPymtStYuI8Prwqbdu0jE0gouqUYc,470
+../../../include/site/python3.12/pygame/_camera.h,sha256=T0VYAfQxm0c4zww_BZaJGz4exa4z0FdEf3RSN_W2E-E,839
+../../../include/site/python3.12/pygame/_pygame.h,sha256=UhRJF2E7W8CVfKAW5cySBOxf8tvzyAX0tDjEhUrJPeM,11726
+../../../include/site/python3.12/pygame/_surface.h,sha256=Bbi9rW0SqwGs6THID0l6eB5d-5h-kxW7517TdqoxEZM,957
+../../../include/site/python3.12/pygame/camera.h,sha256=SDNTLUp5qj5HHZyrfNR8f-t-lpSNHxj3EXO-WqQNPYo,5605
+../../../include/site/python3.12/pygame/font.h,sha256=VHcKhYtIHduegTXEf1hbmbxCwN5IrqsJch2HaxEtB6I,348
+../../../include/site/python3.12/pygame/freetype.h,sha256=LbGY6saj9oakyoeGSlWlirSHySOpeoTKKOF-DO4zLRs,3245
+../../../include/site/python3.12/pygame/include/_pygame.h,sha256=n1_I_aMMA0F4MG1C-UpuTZ2qSe6luf7vt2pIpOuYPo4,30436
+../../../include/site/python3.12/pygame/include/bitmask.h,sha256=tGzYwZ407sMIHDQG7xeXBQCRmhZZ4wp-yTerhUmIlCU,4952
+../../../include/site/python3.12/pygame/include/pgcompat.h,sha256=l-At6iLGU8EeMqYdsDMATS2zfkviXWe1Rs7lnOwO7oc,1944
+../../../include/site/python3.12/pygame/include/pgimport.h,sha256=3VrUyOZC6kbEdOcXn1QbOZ3nusBAuFSQxYgDadHNTPI,2636
+../../../include/site/python3.12/pygame/include/pgplatform.h,sha256=4y5BDK1oKeK2i5pO3UfZAbZXv_KdNdco5ZBbrtBsrtc,2312
+../../../include/site/python3.12/pygame/include/pygame.h,sha256=OsEc_zNPFlXo4owOhGRqH4cbuYMtNJ_7K9d_Te--OEU,1245
+../../../include/site/python3.12/pygame/include/pygame_bufferproxy.h,sha256=Poh7HsIjugo3NFeKjItZe40_BavF5V7re8bVFjkpmfU,1834
+../../../include/site/python3.12/pygame/include/pygame_font.h,sha256=JKPbDFQdh_BAuz5F9S37iBSZbfjnL2scUlkS1geLd4s,1501
+../../../include/site/python3.12/pygame/include/pygame_freetype.h,sha256=VNyvy7xukNOXymg3IMZne9-iVu3sI5LvKLagfkWpKAk,1346
+../../../include/site/python3.12/pygame/include/pygame_mask.h,sha256=ONXIz3M3MPF4BlPSS2xRquysEYjZZf7AP2JRro8j4I0,1303
+../../../include/site/python3.12/pygame/include/pygame_mixer.h,sha256=HthA7STa9TLomwQQswroyAmAd72pywDu_UCLfIV71is,2021
+../../../include/site/python3.12/pygame/include/sse2neon.h,sha256=DcazZmLfny6MVJFIUlWbsdI39ZWQWGwmCJDuFEVZsw0,237885
+../../../include/site/python3.12/pygame/mask.h,sha256=Y7OqzNUqQQHchUsSlvd-ja5d9IgAfSV2uFlaa8_5Lys,153
+../../../include/site/python3.12/pygame/mixer.h,sha256=HJMd0Ho0DrdGBdPMDo_egSqkVxZnUZPMEQyPJMIw6_M,348
+../../../include/site/python3.12/pygame/palette.h,sha256=dzARYIsQdHAaV8ypCrQbYRWFisXYXABD4ToMlzYKojg,7057
+../../../include/site/python3.12/pygame/pgarrinter.h,sha256=alsw7p6X7ukOB1o3curyrjWOcGHgVCQgCvS1D9FtiRc,1060
+../../../include/site/python3.12/pygame/pgbufferproxy.h,sha256=tqMDkdkH40QoYJ3NtTjiknAnSMh0i1sfNMaow3npvKI,179
+../../../include/site/python3.12/pygame/pgcompat.h,sha256=Ro6kJ6ak2LQSHR4LmwnulolGuQO0KW6UZiu02iP-1_I,737
+../../../include/site/python3.12/pygame/pgopengl.h,sha256=bbIysbLph5paPfeE2nnrQBIrq8iZz4T4pGfz2mYPuRw,606
+../../../include/site/python3.12/pygame/pgplatform.h,sha256=LuZxNMbDYRCgjDk1_ruNTOiQsyO_FcI9qxNtJeAUpXQ,553
+../../../include/site/python3.12/pygame/pygame.h,sha256=AQcZWIoAWGmN9fYBynCXxc81hd9lcwxBwWeq8WZjTKE,1083
+../../../include/site/python3.12/pygame/scrap.h,sha256=d36ZWp5LM7o9RRcHCFiHwAT0aJZN_c17wTNu_LYHuEE,4704
+../../../include/site/python3.12/pygame/simd_blitters.h,sha256=8Bv4j0uHf4ErZMeJeXjnrnVvKBQdSLmKcrEVgbYJlPc,2494
+../../../include/site/python3.12/pygame/surface.h,sha256=6Goq2WvnwB_mYosiq4wZMIzPXn7uoCyA_fTK4uKtf6I,14584
+pygame-2.6.1.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
+pygame-2.6.1.dist-info/METADATA,sha256=UftAjlzr4zuNdFJSGcbs8oekZJTBYOHrIwMlRlv6hxg,12878
+pygame-2.6.1.dist-info/RECORD,,
+pygame-2.6.1.dist-info/REQUESTED,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+pygame-2.6.1.dist-info/WHEEL,sha256=Vn5rrdwmXMBVNlKjgSWDNoqXXbGpTeTFNnBfj813LFw,110
+pygame-2.6.1.dist-info/entry_points.txt,sha256=dLqlr3Z1J3rgwMU_2X_oMIHnHCLXfrFyfzD2q6ewoOI,63
+pygame-2.6.1.dist-info/top_level.txt,sha256=ABXdFGIAE2g9m2VOzQPaLa917r6XEu6d96RqIzvAWCs,7
+pygame/.dylibs/libFLAC.8.dylib,sha256=ZlJoeQLlennXKihTRrhvnGgtTUhfeqLrVqXj6hKoYyY,306928
+pygame/.dylibs/libSDL2-2.0.0.dylib,sha256=L5AJ5eiUFKK9fjtXEvGAALNNc2-3Z_tot2dUA81dWzU,2375008
+pygame/.dylibs/libSDL2_image-2.0.0.dylib,sha256=Hb6sXqx1TLlYyOCH0nXUMqimapB23tpfirUYioUe094,212192
+pygame/.dylibs/libSDL2_mixer-2.0.0.dylib,sha256=K8Ip2HKlC7WuXvXj_KtNeFemVQBKGfIHZEXB-jbvdHo,258928
+pygame/.dylibs/libSDL2_ttf-2.0.0.dylib,sha256=6VCtOuiBe2MCB4_NGNqsCyCIPKZOWvyis50ExWNmPtM,2271616
+pygame/.dylibs/libbrotlicommon.1.0.9.dylib,sha256=_oRX3zJY3LniathdY4w4krfnWOJNsI5tupTWdpqKW1c,185360
+pygame/.dylibs/libbrotlidec.1.0.9.dylib,sha256=fJFDJBua7FkWURbLLX9U55x7K0FcOJHCzLfSsdwwr0M,88208
+pygame/.dylibs/libfluidsynth.3.1.1.dylib,sha256=Rl8j5Ghs4Q0UglzjTxeZ8kulFSAAR3Cd7briKHre8w4,477840
+pygame/.dylibs/libfreetype.6.dylib,sha256=NqXhIEQ2JEmzfsgEBqWIUlNLPEf5sn-suFGf9rzNoqk,1025440
+pygame/.dylibs/libglib-2.0.0.dylib,sha256=K-eyep72-8lmXPDEP138jij4yh0ke5bF37jqxKw3kvY,1707040
+pygame/.dylibs/libgthread-2.0.0.dylib,sha256=dMPqvKZkz5K3Cdu83AZfuZ16zr8qMkMMRxMVbJzljes,52064
+pygame/.dylibs/libintl.8.dylib,sha256=7PF44ja_Kcipj1XZlpLVv0GCujbM39K4nE_n_SSN9eg,109616
+pygame/.dylibs/libjpeg.62.3.0.dylib,sha256=OFLtm8yZhS2iPRwl2SYC_9hKZT-PSqKqgBZqoLJ2JiQ,775168
+pygame/.dylibs/libmpg123.0.dylib,sha256=vzaImSECh98r-IYNoBQYEyA9CkBjq4CeEHwYEO2rp-Y,388016
+pygame/.dylibs/libogg.0.8.5.dylib,sha256=5Mcu9KRPo_1kZvCFb8Rcvw0MeKocab5oOroyOqE8gqs,72480
+pygame/.dylibs/libopus.0.dylib,sha256=VTLH783rxx_p6qDSClcNX_xFTaAthJdNRD0KSuebInQ,578528
+pygame/.dylibs/libopusfile.0.dylib,sha256=jnEUCilpr7LV2WxlT9iOu7hN9Fdif454UgyA3SwK35c,98656
+pygame/.dylibs/libpng16.16.dylib,sha256=2RNbXHeI66hNYfQcH9h3NIdxtLElVAgzA1I_bTJv_Z8,301552
+pygame/.dylibs/libportmidi.2.0.3.dylib,sha256=RtvodVPteS_v9Wy39pPgj14TiwJQn4WkTk_QFAHkDUg,97712
+pygame/.dylibs/libsharpyuv.0.dylib,sha256=VRM_jP74dtSL6Llmc1lTZ0mptL9lA9Ks50TQ9JF_iDY,57504
+pygame/.dylibs/libsndfile.1.0.34.dylib,sha256=oOcXPjLevbhmRgA56ZwO1TYq4vM9j9w1juexkTFV2Jw,584944
+pygame/.dylibs/libtiff.5.8.0.dylib,sha256=HstiHPeruRVoC1fdjmI7lP0meFXhZeLgxr5c2ReGUQs,572416
+pygame/.dylibs/libvorbis.0.4.9.dylib,sha256=wbzb0Db9JnOGFFQciOQ7u9YP2u8kpcawH0xqBoBQRY8,278160
+pygame/.dylibs/libvorbisenc.2.0.12.dylib,sha256=NdnZzkgkqg3kVd9MdMtuppBs3smWcsP4PeBYo7ITtyA,735088
+pygame/.dylibs/libvorbisfile.3.3.8.dylib,sha256=vRz26x9CpoLmUpFbpOACZyKHFY7EtV9W82MmMABNYko,74208
+pygame/.dylibs/libwebp.7.dylib,sha256=GuE1CvbAcoI3GiC4cGhVX4juYdLE8rgSFsKG8ShxrFI,711264
+pygame/.dylibs/libz.1.2.11.zlib-ng.dylib,sha256=E0MMJGwYAMWIru_MNOpooJ2m_rBl_PCg2sJ8CgzqDbk,161280
+pygame/__init__.py,sha256=cfk8mST6YzXpJH83W86aq5Sj6HzZYCZ8RYJUUR3KRt4,9483
+pygame/__init__.pyi,sha256=javlxYV7i0wDGZ69E_J2x1PLmXoEN-pfcF0MCcLqKbY,20400
+pygame/__pycache__/__init__.cpython-312.pyc,,
+pygame/__pycache__/_camera_opencv.cpython-312.pyc,,
+pygame/__pycache__/_camera_vidcapture.cpython-312.pyc,,
+pygame/__pycache__/camera.cpython-312.pyc,,
+pygame/__pycache__/colordict.cpython-312.pyc,,
+pygame/__pycache__/cursors.cpython-312.pyc,,
+pygame/__pycache__/draw_py.cpython-312.pyc,,
+pygame/__pycache__/fastevent.cpython-312.pyc,,
+pygame/__pycache__/freetype.cpython-312.pyc,,
+pygame/__pycache__/ftfont.cpython-312.pyc,,
+pygame/__pycache__/locals.cpython-312.pyc,,
+pygame/__pycache__/macosx.cpython-312.pyc,,
+pygame/__pycache__/midi.cpython-312.pyc,,
+pygame/__pycache__/pkgdata.cpython-312.pyc,,
+pygame/__pycache__/sndarray.cpython-312.pyc,,
+pygame/__pycache__/sprite.cpython-312.pyc,,
+pygame/__pycache__/surfarray.cpython-312.pyc,,
+pygame/__pycache__/sysfont.cpython-312.pyc,,
+pygame/__pycache__/version.cpython-312.pyc,,
+pygame/__pyinstaller/__init__.py,sha256=-c4Zo8nQGKAm8wc_LDscxMtK7zr_YhZwRnC9CMruUBE,72
+pygame/__pyinstaller/__pycache__/__init__.cpython-312.pyc,,
+pygame/__pyinstaller/__pycache__/hook-pygame.cpython-312.pyc,,
+pygame/__pyinstaller/hook-pygame.py,sha256=F54YZHmQpTIBH265sM0r5_8_YZYWo0IBhG_QVAQybgI,1368
+pygame/_camera.cpython-312-darwin.so,sha256=yWt-XVOGHWA_S_UJWTaKRnUdPIy2u7OMA6m2OJQ11qY,75072
+pygame/_camera_opencv.py,sha256=DiPrxXiIGUxoz4lSONGs04sOo9pEA8RKQ9cnNO7JC2M,5454
+pygame/_camera_vidcapture.py,sha256=mbPFnTU0520qXpj0qt6ei3YQ1_1OFRuDU-5fXFm-yos,3403
+pygame/_common.pyi,sha256=YPuDlQLtP8KzA-qA9LnYkOhS9zzSvA5ENwWHI2WSvoI,1349
+pygame/_freetype.cpython-312-darwin.so,sha256=CwOuVNuDEI-tU0gvbrnbij6SN6cVnGzhaj1tWYQJ6Ys,147312
+pygame/_sdl2/__init__.py,sha256=gmSh3cXyxHqEXwbck_mNOmoW--itmGMwonEHQnY49Zo,248
+pygame/_sdl2/__init__.pyi,sha256=fWR2P9epfYw8F_xyyMBoUxDZwJTIroizEnkN_eLf2rw,98
+pygame/_sdl2/__pycache__/__init__.cpython-312.pyc,,
+pygame/_sdl2/audio.cpython-312-darwin.so,sha256=lFIgUJqBoyAZGQ7FL-lJOdpoFrHyBAAeOeyfDUAzgKA,258944
+pygame/_sdl2/audio.pyi,sha256=DRRipL7rySE-0TddObb1A-l99rWQPK4YI36hvyHj4dw,1300
+pygame/_sdl2/controller.cpython-312-darwin.so,sha256=kXWivYoaw7YoQU6alUrttNAhvg7ABH0X7WJHRElxCFs,176624
+pygame/_sdl2/controller.pyi,sha256=8WZ0Qf5iHIJTElgu29LeAhZO3Htbo00b8oL3aohK5P4,1165
+pygame/_sdl2/mixer.cpython-312-darwin.so,sha256=P0q_QWwdYC4GxQbNfQy3FmVbqP-r5fakGHRUL6IvuAE,235280
+pygame/_sdl2/sdl2.cpython-312-darwin.so,sha256=vKeUueWR5YGN9n7edaa3CphyHcY09u9hmN5tJiApm-4,86768
+pygame/_sdl2/sdl2.pyi,sha256=n0Qa04-g3FdR7wiMEC_4ZhmAojvQTXGjTl1z13OWU70,338
+pygame/_sdl2/touch.cpython-312-darwin.so,sha256=s3csgBw0eVT2XVQnQp9gstv5Fxwu9eok9YUsShppmsI,55648
+pygame/_sdl2/touch.pyi,sha256=-vYGJsSC18E2gitH10HIv_V_DUc6DIeCb55zuQp3jPc,231
+pygame/_sdl2/video.cpython-312-darwin.so,sha256=I9bm2XzsfbqWL_nj0Z3PUEc1-QABTj5D-sAkPzcdi9U,355680
+pygame/_sdl2/video.pyi,sha256=1ziRZwVFLhFTYubfNBwtyIF7hBWlCiscXul7V4dMcS8,4677
+pygame/_sprite.cpython-312-darwin.so,sha256=AD3_S1T4ew9rBaeVBbgbaL6TO70qqJdyYYimoIjfnJ8,507728
+pygame/base.cpython-312-darwin.so,sha256=tQmYkCVOGJwjLZ3dECI1t7ADw9zxNnJlsfRRdRFwWjg,79888
+pygame/base.pyi,sha256=MPRqq61kkfR-s7IXcoZyahrRP3VzERTED46GCuVacpg,586
+pygame/bufferproxy.cpython-312-darwin.so,sha256=r9CU4Gu5-rB23hFYSzGYKkk8LgtQuk8-_G_JsSHMrsc,58768
+pygame/bufferproxy.pyi,sha256=znPTlMWUbbJI2iCUz8F3pY0guxHOzVnQhpnUaPhfB2E,458
+pygame/camera.py,sha256=MklsW1Bj7vEm8_33RMWZhelsgDQF7yy5ZrvGyD4CIG8,6083
+pygame/camera.pyi,sha256=yeFKyldBEFDOUwMRXsqPcDdH2hOgeoth9fOuBJ8Dc8Y,1624
+pygame/color.cpython-312-darwin.so,sha256=kDl7_msu-FEkGSrwMNXEauirHQO2u9ox7--2EFTDfFE,81120
+pygame/color.pyi,sha256=rBSvRlXAFlP4kzuVdI_z5n9TkCcZpz6_2XEAvYHG0gk,2050
+pygame/colordict.py,sha256=xS-mwTxatoVa3Howpp53otRNZ3p-b1MzZChlvy0cuic,25773
+pygame/constants.cpython-312-darwin.so,sha256=bgpLZAko2_CL9-1zEar93HcCpLPKLvXqrjHDUKzMaSo,86192
+pygame/constants.pyi,sha256=PqbIVEVcVE9pKTaCFd9RExuYFf4i-1H_u_zjx6KP44U,9902
+pygame/cursors.py,sha256=kwDhVH_LeFzfvakDmxPYnf8FB3ElmAH8aClRYedi4os,18093
+pygame/cursors.pyi,sha256=rvpf35D0IPYU2SBH30K46RRmigQfQH4SyQfb7TwnNiQ,2090
+pygame/display.cpython-312-darwin.so,sha256=_lCY6d78rvk0v7TSKP9me1PCKlyJfZGZdxHJLn1_YHU,86096
+pygame/display.pyi,sha256=5rC8JySsJTs0GWDaAG29lQan4HhtzIA0ilVvsi3Vvqs,2273
+pygame/docs/__main__.py,sha256=1dEMTojlXYV8qZ_T9h2f_AYdpPwwyCqmHBC8iuJ2KGI,995
+pygame/docs/__pycache__/__main__.cpython-312.pyc,,
+pygame/docs/generated/LGPL.txt,sha256=oZDcnIBDdV2Q-LCnX6ZrnkLUr0yYC_XdxjPwEk2zzuc,26430
+pygame/docs/generated/_images/AdvancedInputOutput1.gif,sha256=uSCxW5dFtO7PYQyoJglWJTe_aRYFfOav5DjnPkKBzKg,5649
+pygame/docs/generated/_images/AdvancedInputOutput11.gif,sha256=uSCxW5dFtO7PYQyoJglWJTe_aRYFfOav5DjnPkKBzKg,5649
+pygame/docs/generated/_images/AdvancedInputOutput2.gif,sha256=2UMDweIgRefzHFTJcJgbDsWgy-SlyOYaw2AKD6NKwmM,72233
+pygame/docs/generated/_images/AdvancedInputOutput21.gif,sha256=2UMDweIgRefzHFTJcJgbDsWgy-SlyOYaw2AKD6NKwmM,72233
+pygame/docs/generated/_images/AdvancedInputOutput3.gif,sha256=ez4Y7Yy0LsNH6UPYybfGckLmzutcLh7VIisajgFa4O8,6294
+pygame/docs/generated/_images/AdvancedInputOutput31.gif,sha256=ez4Y7Yy0LsNH6UPYybfGckLmzutcLh7VIisajgFa4O8,6294
+pygame/docs/generated/_images/AdvancedInputOutput4.gif,sha256=2-rK9cGngrgpJLW404oI3lG4NQnoT-UNwzA3Up48YIc,29185
+pygame/docs/generated/_images/AdvancedInputOutput41.gif,sha256=2-rK9cGngrgpJLW404oI3lG4NQnoT-UNwzA3Up48YIc,29185
+pygame/docs/generated/_images/AdvancedInputOutput5.gif,sha256=C6N4d_JD4QNMjLwPdINCOFWufyD4vM7b5LpR2GaHMcY,37349
+pygame/docs/generated/_images/AdvancedInputOutput51.gif,sha256=C6N4d_JD4QNMjLwPdINCOFWufyD4vM7b5LpR2GaHMcY,37349
+pygame/docs/generated/_images/AdvancedOutputAlpha1.gif,sha256=MH3CmK658WpN_u56GL9CV4YMFky9GLaKh0CAcixkMrA,14915
+pygame/docs/generated/_images/AdvancedOutputAlpha11.gif,sha256=MH3CmK658WpN_u56GL9CV4YMFky9GLaKh0CAcixkMrA,14915
+pygame/docs/generated/_images/AdvancedOutputAlpha2.gif,sha256=9E2YAIULWHZsAELfqLf5gdqL7-uE-Ebg4uqKgbSyVYk,71819
+pygame/docs/generated/_images/AdvancedOutputAlpha21.gif,sha256=9E2YAIULWHZsAELfqLf5gdqL7-uE-Ebg4uqKgbSyVYk,71819
+pygame/docs/generated/_images/AdvancedOutputAlpha3.gif,sha256=7gHdbhSKaUpyXgOC7GSusTdN7oJQvjGFY_o8DQNZ2Fc,30380
+pygame/docs/generated/_images/AdvancedOutputAlpha31.gif,sha256=7gHdbhSKaUpyXgOC7GSusTdN7oJQvjGFY_o8DQNZ2Fc,30380
+pygame/docs/generated/_images/AdvancedOutputProcess1.gif,sha256=QihTI3ThxtEnPjQ0qZaYF4rKj5GxSwDfFgfUmFjvcOw,15951
+pygame/docs/generated/_images/AdvancedOutputProcess11.gif,sha256=QihTI3ThxtEnPjQ0qZaYF4rKj5GxSwDfFgfUmFjvcOw,15951
+pygame/docs/generated/_images/AdvancedOutputProcess2.gif,sha256=qP09Je0xWwST1CoAs9BCy7_vq6OB69opna8kejTln50,1868
+pygame/docs/generated/_images/AdvancedOutputProcess21.gif,sha256=qP09Je0xWwST1CoAs9BCy7_vq6OB69opna8kejTln50,1868
+pygame/docs/generated/_images/AdvancedOutputProcess3.gif,sha256=4WhoBbEheizUdZfs_pFEBGGAm9aoetw3tJhgcNgVIyY,1912
+pygame/docs/generated/_images/AdvancedOutputProcess31.gif,sha256=4WhoBbEheizUdZfs_pFEBGGAm9aoetw3tJhgcNgVIyY,1912
+pygame/docs/generated/_images/AdvancedOutputProcess4.gif,sha256=m-gUJNOn6AuXT7FpKF6HRR8A6ytWorY9Y07N2uZaSIQ,14500
+pygame/docs/generated/_images/AdvancedOutputProcess41.gif,sha256=m-gUJNOn6AuXT7FpKF6HRR8A6ytWorY9Y07N2uZaSIQ,14500
+pygame/docs/generated/_images/AdvancedOutputProcess5.gif,sha256=GCi9KGUIhQTFg-HLEnp2GEgrnQl8_2KftS3N_UkuEH8,16896
+pygame/docs/generated/_images/AdvancedOutputProcess51.gif,sha256=GCi9KGUIhQTFg-HLEnp2GEgrnQl8_2KftS3N_UkuEH8,16896
+pygame/docs/generated/_images/AdvancedOutputProcess6.gif,sha256=nzV_M0JoA4aDyGwpe8lWoUFd5c1PK-WxUI-lF8WzfQQ,34058
+pygame/docs/generated/_images/AdvancedOutputProcess61.gif,sha256=nzV_M0JoA4aDyGwpe8lWoUFd5c1PK-WxUI-lF8WzfQQ,34058
+pygame/docs/generated/_images/Bagic-INPUT-resultscreen.png,sha256=RDZbxtVyFMJXdZA8wouSyJJjXf2MQ2WYTBzVotsDH88,5973
+pygame/docs/generated/_images/Bagic-INPUT-resultscreen1.png,sha256=RDZbxtVyFMJXdZA8wouSyJJjXf2MQ2WYTBzVotsDH88,5973
+pygame/docs/generated/_images/Bagic-INPUT-sourcecode.png,sha256=3F2c3AnravGgsRMxaNXlaekyqrhMl2cwYySJxhj7L0A,77061
+pygame/docs/generated/_images/Bagic-INPUT-sourcecode1.png,sha256=3F2c3AnravGgsRMxaNXlaekyqrhMl2cwYySJxhj7L0A,77061
+pygame/docs/generated/_images/Bagic-PROCESS-resultscreen.png,sha256=hQ1m6S1xhXpcaf0g50VRoOagmsiZZpUeOBx7QgG7Lqs,5348
+pygame/docs/generated/_images/Bagic-PROCESS-resultscreen1.png,sha256=hQ1m6S1xhXpcaf0g50VRoOagmsiZZpUeOBx7QgG7Lqs,5348
+pygame/docs/generated/_images/Bagic-PROCESS-sourcecode.png,sha256=vj0D6wrXFNjIHKmRFZrltZH4nH51zG6YSy94ID2fWos,66070
+pygame/docs/generated/_images/Bagic-PROCESS-sourcecode1.png,sha256=vj0D6wrXFNjIHKmRFZrltZH4nH51zG6YSy94ID2fWos,66070
+pygame/docs/generated/_images/Bagic-ouput-result-screen.png,sha256=Ig1vKczM-l0ebtdjYEHdwcJuqt8IoyUiK-RANEC065k,4819
+pygame/docs/generated/_images/Bagic-ouput-result-screen1.png,sha256=Ig1vKczM-l0ebtdjYEHdwcJuqt8IoyUiK-RANEC065k,4819
+pygame/docs/generated/_images/Basic-ouput-sourcecode.png,sha256=B6OVjvOtA2ZwiEwJyYkK1-tsGyN13y8O9kls1OYvzTo,57466
+pygame/docs/generated/_images/Basic-ouput-sourcecode1.png,sha256=B6OVjvOtA2ZwiEwJyYkK1-tsGyN13y8O9kls1OYvzTo,57466
+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.gif,sha256=Yc_ufSFTkZ5NA1IogV2juH5Cr4_ykoI7QcXQvfGYBfc,46010
+pygame/docs/generated/_images/draw_module_example.png,sha256=jAhc1HG8RXjjPnjn9AwncGwfi4dKbaO7rQgqcd5OCeQ,6476
+pygame/docs/generated/_images/intro_ball.gif,sha256=vEs0-OG_j55JZJML48IXhHsN4ZMIWrqlS7dfxd9-hxc,5015
+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/introduction-Battleship.png,sha256=6iHEhqo_HnXRfmQv9yriYMc3dX8Q2TwGbSGDQREFkN4,165586
+pygame/docs/generated/_images/introduction-Battleship1.png,sha256=6iHEhqo_HnXRfmQv9yriYMc3dX8Q2TwGbSGDQREFkN4,165586
+pygame/docs/generated/_images/introduction-PuyoPuyo.png,sha256=OEMjFSzQc8vJLQryUdkp7lJ3DhIw_yEo5-5nm2vBfrs,31388
+pygame/docs/generated/_images/introduction-PuyoPuyo1.png,sha256=OEMjFSzQc8vJLQryUdkp7lJ3DhIw_yEo5-5nm2vBfrs,31388
+pygame/docs/generated/_images/introduction-TPS.png,sha256=M4ioZMyjR2n7pQIp8UhGRV4m2V_rcXJCuo5lU3V7yGw,136031
+pygame/docs/generated/_images/introduction-TPS1.png,sha256=M4ioZMyjR2n7pQIp8UhGRV4m2V_rcXJCuo5lU3V7yGw,136031
+pygame/docs/generated/_images/joystick_calls.png,sha256=oNAQgfZ8GM5_Z17hoNVrLf1tYeRnths60ZrlhJduWhs,30004
+pygame/docs/generated/_images/pygame_lofi.png,sha256=QBECBUalJHRExXhf7nt-QpsVcu9LQ3RSAYVVS04AX3M,134242
+pygame/docs/generated/_images/pygame_logo.png,sha256=Jc1Lz47pY3mHjEFNzQXV9gx-olUUYCGuFYrutncaTXE,132068
+pygame/docs/generated/_images/pygame_powered.png,sha256=LgbswFcg647alSC5SawDPH96xuTMcWmMqVA6Zvs2K3Q,179911
+pygame/docs/generated/_images/pygame_powered_lowres.png,sha256=9go5WMiAE4fTEmB9w-zatEfROGl1IUWJGBpKoLqy-wU,179911
+pygame/docs/generated/_images/pygame_tiny.png,sha256=BXPk3OkSWdSkqjMkCQ1Dt5WjxZfb4zj4c2ir9U9_Y7Q,15310
+pygame/docs/generated/_images/surfarray_allblack.png,sha256=XEUO2hKFfTfZMyaqbPvM0u3zmETfl___AANBkHn6y-w,125
+pygame/docs/generated/_images/surfarray_flipped.png,sha256=UZ1FpljGrdAnB1UCUTuAfeJJxyqI-_0duSCKqy9UN3w,50835
+pygame/docs/generated/_images/surfarray_redimg.png,sha256=6tlO_tZokQTsfgvD3yNW21nHA5uA9hDWoaL7POrr_qE,23443
+pygame/docs/generated/_images/surfarray_rgbarray.png,sha256=8US5r3GcG_jZBncK-47HG2JLB2ZwQjaSBWhb3ynNs9w,50897
+pygame/docs/generated/_images/surfarray_scaledown.png,sha256=Z68XSoPUvV5bYIhJdkmhZYr42JpQKnC8g9hmN18iaWI,15109
+pygame/docs/generated/_images/surfarray_scaleup.png,sha256=sdxQlmVoRhlF_ocD2ecre0q51Q2LLoCxNsJaI8O1NYI,67759
+pygame/docs/generated/_images/surfarray_soften.png,sha256=XNzAZzfLUqn-QIQ25TxB2ujoDZkPEIRI6QSDnjJMIk0,47540
+pygame/docs/generated/_images/surfarray_striped.png,sha256=iH7gLZhBu5aATV-vfrsQmW30KdsMQoYB_LD-efRzl_Y,392
+pygame/docs/generated/_images/surfarray_xfade.png,sha256=uD8g8Ueqc3IMZaOqiD4n4sZmg5I4j798oIzl1pWDM70,41834
+pygame/docs/generated/_images/tom_basic.png,sha256=RzKBFmep1ksfD5QrJVW7JzdHvDN1_4ayUfGyVN-8Wms,5139
+pygame/docs/generated/_images/tom_event-flowchart.png,sha256=sG8YOH8YX2yTtx4-agBUWIcT8-jj1m6uKCF98QxmbKQ,5528
+pygame/docs/generated/_images/tom_formulae.png,sha256=6k8VDsueGVOh01ZrAVLE5miliOWKhQJqIrlPW_JEmXk,6763
+pygame/docs/generated/_images/tom_radians.png,sha256=BkBTx4OoiSXO5d6sMG01MyYBtO7EmDvgJixbTRKMm9Q,17409
+pygame/docs/generated/_sources/c_api.rst.txt,sha256=vSJF6tvDzMDdGTnXyyAi-Zz-iApxeuO-n5jTvceAQNw,473
+pygame/docs/generated/_sources/filepaths.rst.txt,sha256=sou-1N5amW1JXHqwKUU0BqYQmm2c5qDjjFKVIKIppfo,899
+pygame/docs/generated/_sources/index.rst.txt,sha256=UMDM3eMRAtTSwIiQfMXkaCKNWW6dlsnqR6MpxfGAMyI,5965
+pygame/docs/generated/_sources/logos.rst.txt,sha256=oJNZMoKbfJ9EuXTeipAahQGSpPkTaAcyHEIGWJPdWW8,1337
+pygame/docs/generated/_sources/ref/bufferproxy.rst.txt,sha256=V5gSzq__85alqL5Is05MTmpDv5NUHbLuuW4PYH98MzI,4708
+pygame/docs/generated/_sources/ref/camera.rst.txt,sha256=VGSdYbW2ii37WG3kC8HGn2Ao-TPRPYXTLez9VnwI364,9628
+pygame/docs/generated/_sources/ref/cdrom.rst.txt,sha256=0FlYODuxoQOsTYpZ9EiDYmUD9PIQrAeAlsXE8I67RQk,9068
+pygame/docs/generated/_sources/ref/color.rst.txt,sha256=DbdHOccIvmf8D8ERvo-fHKKvqKmZYb3tcNbQkSh_dj8,10798
+pygame/docs/generated/_sources/ref/color_list.rst.txt,sha256=XLIKLmTx_liiWk0gdKlrElBlCNZD0_sIvAg_El6tgfE,96353
+pygame/docs/generated/_sources/ref/cursors.rst.txt,sha256=dRrEevF8Uaho0It82zk-f1ySA9Pa_y3kUhM4mEm-zTQ,9415
+pygame/docs/generated/_sources/ref/display.rst.txt,sha256=Vnh3egkzBw1odhLMoVwFrR_WZLodTbgR2X01K4BhAkk,29190
+pygame/docs/generated/_sources/ref/draw.rst.txt,sha256=O-i4wVe9KULlpBvhdKrKbAYXiszO2_FUDhjzoEArmI0,24657
+pygame/docs/generated/_sources/ref/event.rst.txt,sha256=_0wgRCiHprZux0vJSF4wuyq0nAo1iOuK5T5eF1jzwTM,22211
+pygame/docs/generated/_sources/ref/examples.rst.txt,sha256=044bT9v4pQYRZqmaAwrdAI_GV3HLiwRlWHKYturVbN4,14095
+pygame/docs/generated/_sources/ref/fastevent.rst.txt,sha256=6gyem0cRZ-syKMDcQ6qexC83dJMro1O9-XHY_k2_HNg,3545
+pygame/docs/generated/_sources/ref/font.rst.txt,sha256=AGiup5hzk_KnfOElwadQGmzkzG9XcRex2yq9EvsNB-o,18217
+pygame/docs/generated/_sources/ref/freetype.rst.txt,sha256=R5RnUREdR9b5NPNsPYYTthl_ExWUcmX7vclWFjeNpyM,31386
+pygame/docs/generated/_sources/ref/gfxdraw.rst.txt,sha256=bQYID2bOb6xETZoDKM0mRtaCU_QD48MjQmCV8lvEErE,21842
+pygame/docs/generated/_sources/ref/image.rst.txt,sha256=4NJf_cJ9VVHm7VD1MD4msBUvjytoaCTkB83W6vubfkE,13395
+pygame/docs/generated/_sources/ref/joystick.rst.txt,sha256=sXgDyfTcwBdasNxdzW9r0Xnesxo6iwz23OBYG6SB0ws,19389
+pygame/docs/generated/_sources/ref/key.rst.txt,sha256=vSngmd3fawSny-yD8ord6lUR4sryVa9B6XcIiq8LyVA,16327
+pygame/docs/generated/_sources/ref/locals.rst.txt,sha256=VZi8cE2ZlPei4WdzSsok0fU_BOgPhlOmjfTCTSvl0N8,1022
+pygame/docs/generated/_sources/ref/mask.rst.txt,sha256=RAVpZZNK2i-ltHlCbNZgFa80x2RAXc_4lYkPgAVoyjs,24220
+pygame/docs/generated/_sources/ref/math.rst.txt,sha256=YbCqnfzaJeI1k8AYI45w8rokZ_x9f2NdnkoK2njrv3k,38384
+pygame/docs/generated/_sources/ref/midi.rst.txt,sha256=jIJ5qOZNvlMtBH0TA2icWTSB4_7CcUmU6_y9uVhGiak,14358
+pygame/docs/generated/_sources/ref/mixer.rst.txt,sha256=OHZqbN6F8ARkFGLe0cXHpAnOVf_MeqdC1cp5OeWRlbQ,22459
+pygame/docs/generated/_sources/ref/mouse.rst.txt,sha256=pzAlscsACbo_6p1pbazcbUaJW2vEf1Zx--jwy3ktA3k,8129
+pygame/docs/generated/_sources/ref/music.rst.txt,sha256=lLimQ-C1JXLMGw-gIHIsZ7r0bbav7SPTovbCqiXuO5Q,9531
+pygame/docs/generated/_sources/ref/overlay.rst.txt,sha256=loD8HVw0KQnsaPPisw_Xe8yms59CEAbdsboXwhS7zqk,2659
+pygame/docs/generated/_sources/ref/pixelarray.rst.txt,sha256=p0HY0TLZFoZAayVW9FxW8t0G4-Cjblhfd07uTkXqJK0,10204
+pygame/docs/generated/_sources/ref/pixelcopy.rst.txt,sha256=SMb-VGMZSxBBWgAjsFg2ucaQp80KglnIo56AkS7O-vE,4531
+pygame/docs/generated/_sources/ref/pygame.rst.txt,sha256=IOXEZG4wLePtTVyLkZ_oVu8m_l7ef2fPIk1GrVaJMTA,15129
+pygame/docs/generated/_sources/ref/rect.rst.txt,sha256=Qf24A1_9KRJgS1-L5xlHoRWKQbDI0bE4rViR8Zc1aBM,21147
+pygame/docs/generated/_sources/ref/scrap.rst.txt,sha256=eeN2xL1riH4ZKbpNJSAXVlG1Ew2JYn1B-JiSBmdtZ_Q,7988
+pygame/docs/generated/_sources/ref/sdl2_controller.rst.txt,sha256=8wI9cr_XTTZ0Kym7dtICQhivaI40sh_0_vy_C2EK4X4,9401
+pygame/docs/generated/_sources/ref/sdl2_video.rst.txt,sha256=1WSISwTtmvOX6n_wEzAFk5Yj7XgmeG5GdrPIZB8K6RQ,9117
+pygame/docs/generated/_sources/ref/sndarray.rst.txt,sha256=9N1u6w7AxTr943nJiSUoDyNi-8qE_tWJeVU0rVEQYi0,3260
+pygame/docs/generated/_sources/ref/sprite.rst.txt,sha256=z-Pts-M_gHhdorsxSIjkKsmQE0FFQMfMillhmpqxlJQ,30578
+pygame/docs/generated/_sources/ref/surface.rst.txt,sha256=eNBOZq2pkRHQcVtErIZs8jiG-nhAXSq3CR-Bup7_OQ8,36859
+pygame/docs/generated/_sources/ref/surfarray.rst.txt,sha256=rBeiZncxG9HIetGkZS0IcwxIlHqQgCxpiZxO6bSvY8s,12251
+pygame/docs/generated/_sources/ref/tests.rst.txt,sha256=vzkEPNYlI2274wXW3FKI1c9Qqmo293E7_eZhIIV9Xs0,4636
+pygame/docs/generated/_sources/ref/time.rst.txt,sha256=WJTVcpIu2GT39OD3k5MYQ3gXTqQJwJJaiNjA7GvWMlk,5624
+pygame/docs/generated/_sources/ref/touch.rst.txt,sha256=v7V0P85KlxiQIBLjaVyhTtH1fmDmqif-kDLhV0O6x4s,1957
+pygame/docs/generated/_sources/ref/transform.rst.txt,sha256=iZRvH-iMBYCszGMcoMQhut5OQDrGo07ElfF7jtX_mdM,13055
+pygame/docs/generated/_static/_sphinx_javascript_frameworks_compat.js,sha256=Lx4wNBsxMAvcOvKe5KZOD0DtFUkjRTh7tHVC2bm0gTw,4418
+pygame/docs/generated/_static/basic.css,sha256=gLIkBTmzbTROfJqlCQmVp3P_rh3ZDyHMBD5gV9lUPD0,15094
+pygame/docs/generated/_static/doctools.js,sha256=gcsto8KE5CmhpjqyiiC34wvOuOsVVqFUyMusC0zneVs,4472
+pygame/docs/generated/_static/documentation_options.js,sha256=RqJmZdBZVAcBFq09X4xr7pf7I8WtY7pItH0_EKF5FFQ,328
+pygame/docs/generated/_static/file.png,sha256=XEvJoWrr84xLlQ9ZuOUByjZJUyjLnrYiIYvOkGSjXj4,286
+pygame/docs/generated/_static/jquery-3.6.0.js,sha256=H-K7U5CnXl1h5ywQfKtSj8PCmoN9aaq30gDh27Xc0jk,288580
+pygame/docs/generated/_static/jquery.js,sha256=_xUj-3OJU5yExlq6GSYGSHk7tPXikynS7ogEvDej_m4,89501
+pygame/docs/generated/_static/language_data.js,sha256=26ix2NzhHa2zm9JNK6vbYXpX-PJ-BMYUJpyTe3hd8Ao,4758
+pygame/docs/generated/_static/legacy_logos.zip,sha256=69C68jO62qau7eQx3z6U9pLnDhAMXK72RZ4PatlSMdY,51315
+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=3gUIXeiTpxQjNsGUtPmTftcfl9yxwFItdXsUfiStCIc,11993
+pygame/docs/generated/_static/pygame.ico,sha256=YeIWletq938Rg_G11m_1iGL_zw9T_U1QXZhjnbHjJSU,1078
+pygame/docs/generated/_static/pygame_lofi.png,sha256=QBECBUalJHRExXhf7nt-QpsVcu9LQ3RSAYVVS04AX3M,134242
+pygame/docs/generated/_static/pygame_lofi.svg,sha256=5eTaA6Alehzg0SuUSEFa7uONJe-0WHthEXNKPj75j5o,59281
+pygame/docs/generated/_static/pygame_logo.png,sha256=Jc1Lz47pY3mHjEFNzQXV9gx-olUUYCGuFYrutncaTXE,132068
+pygame/docs/generated/_static/pygame_logo.svg,sha256=3Oxb-IF0TZVcfuYPz-bHbd-OYLNLkTVuxiY1vWAmHUk,59262
+pygame/docs/generated/_static/pygame_powered.png,sha256=LgbswFcg647alSC5SawDPH96xuTMcWmMqVA6Zvs2K3Q,179911
+pygame/docs/generated/_static/pygame_powered.svg,sha256=1_0Cxa_PMRGgGvd2KktrKYSajaxGH_3FKaNWIpxeUbU,102819
+pygame/docs/generated/_static/pygame_powered_lowres.png,sha256=9go5WMiAE4fTEmB9w-zatEfROGl1IUWJGBpKoLqy-wU,179911
+pygame/docs/generated/_static/pygame_tiny.png,sha256=BXPk3OkSWdSkqjMkCQ1Dt5WjxZfb4zj4c2ir9U9_Y7Q,15310
+pygame/docs/generated/_static/pygments.css,sha256=GszSf_2qNFZ3EhTbwvTYQdnr6TJNorI6wDM9NXVvJeU,4929
+pygame/docs/generated/_static/reset.css,sha256=wqvSs8L_cB2K6bR903cOJkEtfJi0LpNQFl3nC_kZQr4,1083
+pygame/docs/generated/_static/searchtools.js,sha256=irrDXfNjDCA_rVEOZvL54HJaeQgLi-lhEeI4oHFQCAU,20842
+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/underscore-1.13.1.js,sha256=zBD3mc0Pa2X5XEASRFSX5bo8ufUZZKlGiUCye96YtIc,68420
+pygame/docs/generated/_static/underscore.js,sha256=IY-xwfxy6a9rhm9DC-Kmf6N2OStNsvTb8ydyZxtq5Vw,19530
+pygame/docs/generated/c_api.html,sha256=muUT6uVFrbBs40i0Dg2E84WJ-9GSvsEK7T7CkOJmDe4,7316
+pygame/docs/generated/c_api/base.html,sha256=g9NHnebySv54yODVS6ZhOUj-w1GVM1Rz2AZX2GVNC0g,31906
+pygame/docs/generated/c_api/bufferproxy.html,sha256=AXRH7dsAI1irPgTigeS5GUcCGtgE8tQKveEb1wZl5-Q,11754
+pygame/docs/generated/c_api/color.html,sha256=YKVmVX2EumxtH7D-66sDwmP2FB15WBKUA_mEi8OUFBo,10221
+pygame/docs/generated/c_api/display.html,sha256=USxbX5byzwFN8c1MlQb4Buz-UsecK-h6zmHDn7k__pE,10688
+pygame/docs/generated/c_api/event.html,sha256=6b_HcQuUrrqiiGncoH_36Xoal4hKL8We1E9YgLKLve4,11643
+pygame/docs/generated/c_api/freetype.html,sha256=GLuib0PGN_UMptstne23q17qwo1HweeyEvPy_95bO3c,11131
+pygame/docs/generated/c_api/mixer.html,sha256=AuDllN9YRKZxfmroupZqJ-g2R67b5RA32c5MHpumz54,15077
+pygame/docs/generated/c_api/rect.html,sha256=mKF7ERijXsF5uwY8oaY-NDUa4bb-DTsdqXbgzIMbvmo,13577
+pygame/docs/generated/c_api/rwobject.html,sha256=ZVOWoZOtx44NQsF0L1wiLy33GV2BYfpiNEYS8w1JD3M,15019
+pygame/docs/generated/c_api/slots.html,sha256=FkIAb-J1KUk1-iykM0k03SItYgg66R4w8pMhkN3qp1k,6628
+pygame/docs/generated/c_api/surface.html,sha256=X3G2_RQerwuPHyMoHeIjwPP9mpidiKiukCR2bJQ2lPU,14633
+pygame/docs/generated/c_api/surflock.html,sha256=QnoA3hA3vwbDGmjKbREVgBw5oLmqYeKTmmI-ilOegB0,16481
+pygame/docs/generated/c_api/version.html,sha256=HrdYmSEjy9v-_BMbkaolsTKP1LVsBwYkfp_UF3KMeBk,7987
+pygame/docs/generated/filepaths.html,sha256=-6rJ_BeQSYiZ8YlQMJBpB7ZmHeFSU-Wojuf0HCZFWfE,6306
+pygame/docs/generated/genindex.html,sha256=sXwCW6I2nwiEebKbwWYDeySf0SVQiDcyeyXrI6tDr9U,121378
+pygame/docs/generated/index.html,sha256=W1LUbi6Ia19Vvo7FOmMTcmj4rH3_LOMhAKThcB6D-X4,24449
+pygame/docs/generated/logos.html,sha256=kVbV39kWjFB5EqKNTVfzk635unLohKIRjd97KJ6RB-0,7317
+pygame/docs/generated/py-modindex.html,sha256=3waXulukTJiT-NfZuBUSUFFVRM_DwunMzxLmT2lifPU,11222
+pygame/docs/generated/ref/bufferproxy.html,sha256=aZsP5wBfGjhsbRufXSQ1WqRI3bnqwRxEeXXmYVTaNC0,17322
+pygame/docs/generated/ref/camera.html,sha256=yHWaxLBgoV1l1b8n2DV-Y0S2vMd6GPBgIC0X9UiYaOU,26607
+pygame/docs/generated/ref/cdrom.html,sha256=2lgZ-5AdcuVm6LS4MEkxaGOWYst15i301ZLWA1St_xs,32454
+pygame/docs/generated/ref/color.html,sha256=oTlNLDDAMDO2P2Nvte01Rp4ApOFVNGMWwnCMUYtmCJo,36124
+pygame/docs/generated/ref/color_list.html,sha256=l3mm-9KTpEVjoOscdBMxmfXzDu77wLNyOSz_vtz3dmk,174167
+pygame/docs/generated/ref/cursors.html,sha256=m4_x_wn_BDLTi873OGDOmGivOYcnhbs5qfiX4WhP9uQ,34862
+pygame/docs/generated/ref/display.html,sha256=gAXzQ_GsI6eBaapxv7EKMrQzRwFA1elm1R-UGGi6Xk8,76129
+pygame/docs/generated/ref/draw.html,sha256=hHpRsrp0Mx9DrRX6nCTLdP5dD1Jfv2x-UMuHHz2qYv0,83766
+pygame/docs/generated/ref/event.html,sha256=hlUWIt00kC3UvjEa-OyGpMtdmvGo-IJVt3O9g1ctyLk,69191
+pygame/docs/generated/ref/examples.html,sha256=SEaZcZ3_r0t6L5OytVueofruOq3WCrTNHURJmsAGI1Q,47585
+pygame/docs/generated/ref/fastevent.html,sha256=o2nxwtiypOK6kkint-T3_tCk_7gSWUKnuixPPaDJ0RQ,14652
+pygame/docs/generated/ref/font.html,sha256=lRZqVih5mqbq0Kbxr1SVMSP9gNHHbuhKJ3JaD18-37w,48795
+pygame/docs/generated/ref/freetype.html,sha256=yKt9CNeYKhBnZxOyDIWa6LBhmijp3EVvsqqa0VuAAhE,98978
+pygame/docs/generated/ref/gfxdraw.html,sha256=heD80bnz7QtWJz_fg6wjupbxyEZwqcA5f3RnVHK4ecY,80501
+pygame/docs/generated/ref/image.html,sha256=LeLj9wLMiag6P7uQmp2UAB1IxLw5Jyl2TPNPqZclqq0,39676
+pygame/docs/generated/ref/joystick.html,sha256=CdQdY7wMqPHLcXcXhO_LhSNPaJfEUEkTyg7RsZ5YcUI,94960
+pygame/docs/generated/ref/key.html,sha256=fOiOebccMdpYj80Svg_U4tm-EJ_rg70KeO4G6Wf_25I,41926
+pygame/docs/generated/ref/locals.html,sha256=CysqJNNBgSEC2V_j6qVkrUkt09uM3DegNKFlSCqsgYA,8434
+pygame/docs/generated/ref/mask.html,sha256=g_-INc3OmRFuD02eV7Cqe06edN4Ety_pwyFiW0alfKQ,81074
+pygame/docs/generated/ref/math.html,sha256=El9MSwcqxbfN95eV6WY0Jh3WpvJsN8KpfJ2CZLJQXnM,121254
+pygame/docs/generated/ref/midi.html,sha256=sY3bm0YBi78Dpwf6fDzuXQ-MUJsu5RknjVLnBOAOFAM,51760
+pygame/docs/generated/ref/mixer.html,sha256=nXH_H_ikq0Lv3ma67qyRBiP6XQqCoqjLkMJtZONMInA,62733
+pygame/docs/generated/ref/mouse.html,sha256=8CqBAeS3CBMPrZve-bkUgjNHXhUEXgmai1k2RU2KMgg,26909
+pygame/docs/generated/ref/music.html,sha256=Jk2CzPErO7xJfM3BFLhZz4C4EGd6zhHBfUmBdBTCANE,32928
+pygame/docs/generated/ref/overlay.html,sha256=zMrhwoOJ54lmwQ3vuHq7iIDjqatMtxX2PRcmwWkAg2g,10635
+pygame/docs/generated/ref/pixelarray.html,sha256=8yJJLpf83-FNqDP-o2Ne3S0jjhLAy8O0VHxcAhwD-Xo,30803
+pygame/docs/generated/ref/pixelcopy.html,sha256=tEqf647PRXzs9zt5UXAL2kORsO6GFiPexYKgAjfZoC0,14711
+pygame/docs/generated/ref/pygame.html,sha256=TVKBNkkVc3NgNVfA4HiU_AZ5OyDG_xLygQzoYCzsW_M,49092
+pygame/docs/generated/ref/rect.html,sha256=TQzHr8vjLt8eV8bcAGw2Mg5aSTdTWIEMUtT0bpQg7vA,68956
+pygame/docs/generated/ref/scrap.html,sha256=j2T2uyL2ZRmYbd4xDAgFri17AiZ7HPJ9kXvZ3VBrb7A,30419
+pygame/docs/generated/ref/sdl2_controller.html,sha256=6zHum_uZRpfhoZ_nqCjj-s3KgPwywzeBedQIrXvvgq4,35957
+pygame/docs/generated/ref/sdl2_video.html,sha256=HW-VXkMl77B1aI0B7FzIeg5bSFewNLF7bRqpqiTIay0,60030
+pygame/docs/generated/ref/sndarray.html,sha256=5D3oDCvxy-Xsvkyz3PuaD-idCmJ4-CUyBsT6KPqRpqk,14290
+pygame/docs/generated/ref/sprite.html,sha256=fVTJsBl3Qy4ckuGbhLA9PBxYG1HrXh8hZBJWZ1zcsLg,93932
+pygame/docs/generated/ref/surface.html,sha256=JCnjAPJOjAvIYL5QlbXnAF0mp47FMXH2PSdEPDX9HFw,88335
+pygame/docs/generated/ref/surfarray.html,sha256=qoIurRAPcaIQxb3IAhxK_KaGbKG3nnZY19tGRenvqUE,37529
+pygame/docs/generated/ref/tests.html,sha256=f9CWl4btCEhzUtm4K_ISJwPv12ISeG5du_7GzCy1CsU,18203
+pygame/docs/generated/ref/time.html,sha256=ynhTzrU1r0dHSIG-ivcVULSPN3PSvStfEPXU6epd1aU,19396
+pygame/docs/generated/ref/touch.html,sha256=rj9JgiMkTP5blogL-8wZqQVleFaDkVt2e_3hGvzUxbk,12668
+pygame/docs/generated/ref/transform.html,sha256=Uj95DAF_t2KzgtMy4VEzUrll-Y4_lXkvJAOVkY2KCQ4,42242
+pygame/docs/generated/search.html,sha256=WeAgYl4q0YrYoGs9EFdKFMQADDA59k9YJzYSVJiuq7c,3157
+pygame/docs/generated/searchindex.js,sha256=RfbqqFeJuvrIJ0wwjqgu9BnCn-WR0OU92YoiMJseago,353375
+pygame/docs/generated/tut/CameraIntro.html,sha256=v8EGLIFPcmDJ5sOtgIssfE91IpnuPrYsOxTV6mBSo44,38045
+pygame/docs/generated/tut/ChimpLineByLine.html,sha256=_xdKUSnCnTkFk_GRpre0HUfapwWZHvHqriR4cEmlSOM,58280
+pygame/docs/generated/tut/DisplayModes.html,sha256=zhyhbxZo9V5iJ9x60kGyWcaSC6qBxHEExmkzW62H1rA,23075
+pygame/docs/generated/tut/ImportInit.html,sha256=keRtLNg8zLSVrxvRnPUkp7c5-Nc_C5jmC2rJSkeQ6bo,9563
+pygame/docs/generated/tut/MakeGames.html,sha256=Na6ekoB4bJpMSbZyVVAGT0_2gPeTU_jN3YAXLHyobV0,14645
+pygame/docs/generated/tut/MoveIt.html,sha256=EDpI3epHGvoJuMCr7hPZC5DoFRKe0LuUrCMUBWM4g6k,66698
+pygame/docs/generated/tut/PygameIntro.html,sha256=OMTGBM3JqcJgnG7a8rL9m-Xz7gjsWDurXLsQPZYwi_Y,28925
+pygame/docs/generated/tut/SpriteIntro.html,sha256=E8Bc0O7XB9Hw2US1_Y0zkTZhvTKK63g8ZATG1QCmyAI,44085
+pygame/docs/generated/tut/SurfarrayIntro.html,sha256=PXqvRIDwlgqSEzy4nKYl-9lQMMYf2GGk4805S8fXTis,50398
+pygame/docs/generated/tut/chimp.py.html,sha256=9W6DRoRwXNUDGPy2X8_LVAPYBORpwkxGaG9kgHMV0EA,36112
+pygame/docs/generated/tut/newbieguide.html,sha256=Wm8-b1MkmK2k-6Og0e3BJxnQm5wPjm4G09Om-cgfUTM,45340
+pygame/docs/generated/tut/tom_games2.html,sha256=4chbmRe3l6nFt7L6Zil9YFfNCeNy7VteJRdV0FeBzco,17484
+pygame/docs/generated/tut/tom_games3.html,sha256=3l1OhSScmhAt759dljgRpFbF_Z3bU2s0zG8vxLr8P2c,15134
+pygame/docs/generated/tut/tom_games4.html,sha256=xPnuxpv2YHHP92-wYmKnbtbayAMbCiR_t5qw-5UWgAE,18994
+pygame/docs/generated/tut/tom_games5.html,sha256=JkVG7KC8JO9DlFBQBG4T5Iqb1Z66dzR5YnXYjrS1QpI,21272
+pygame/docs/generated/tut/tom_games6.html,sha256=_ADabWr0_7Q0CrehNNs5Yisq9LU14uoehWaeTKYaV84,52836
+pygame/draw.cpython-312-darwin.so,sha256=TXvPYXewsTLzjg5-KomkN30uD6J-LFcPlx4Y20r9SMY,91728
+pygame/draw.pyi,sha256=VtcYPysR7rBEPcB8XZrTmkvgvBZDoLPKI6mwhFIWubM,1694
+pygame/draw_py.py,sha256=ME-6PCJ7TRsIYoExnwgvEwj3iGTFPgjkNepQag8Nh1g,18662
+pygame/event.cpython-312-darwin.so,sha256=QtIrv1ug69JdUUpVPcaEfv8LuyJDYq43r1GwN1F2YtI,82496
+pygame/event.pyi,sha256=4v_0k2oj2RLibGr_hg5585mvi9CHaAB1tN7wN286Db0,1488
+pygame/examples/README.rst,sha256=K1xE9Fz9XWB05ZKpu4b96ycF19_DY5a3Y-Plv-oeqww,4174
+pygame/examples/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+pygame/examples/__pycache__/__init__.cpython-312.pyc,,
+pygame/examples/__pycache__/aacircle.cpython-312.pyc,,
+pygame/examples/__pycache__/aliens.cpython-312.pyc,,
+pygame/examples/__pycache__/arraydemo.cpython-312.pyc,,
+pygame/examples/__pycache__/audiocapture.cpython-312.pyc,,
+pygame/examples/__pycache__/blend_fill.cpython-312.pyc,,
+pygame/examples/__pycache__/blit_blends.cpython-312.pyc,,
+pygame/examples/__pycache__/camera.cpython-312.pyc,,
+pygame/examples/__pycache__/chimp.cpython-312.pyc,,
+pygame/examples/__pycache__/cursors.cpython-312.pyc,,
+pygame/examples/__pycache__/dropevent.cpython-312.pyc,,
+pygame/examples/__pycache__/eventlist.cpython-312.pyc,,
+pygame/examples/__pycache__/font_viewer.cpython-312.pyc,,
+pygame/examples/__pycache__/fonty.cpython-312.pyc,,
+pygame/examples/__pycache__/freetype_misc.cpython-312.pyc,,
+pygame/examples/__pycache__/glcube.cpython-312.pyc,,
+pygame/examples/__pycache__/go_over_there.cpython-312.pyc,,
+pygame/examples/__pycache__/grid.cpython-312.pyc,,
+pygame/examples/__pycache__/headless_no_windows_needed.cpython-312.pyc,,
+pygame/examples/__pycache__/joystick.cpython-312.pyc,,
+pygame/examples/__pycache__/liquid.cpython-312.pyc,,
+pygame/examples/__pycache__/mask.cpython-312.pyc,,
+pygame/examples/__pycache__/midi.cpython-312.pyc,,
+pygame/examples/__pycache__/moveit.cpython-312.pyc,,
+pygame/examples/__pycache__/music_drop_fade.cpython-312.pyc,,
+pygame/examples/__pycache__/pixelarray.cpython-312.pyc,,
+pygame/examples/__pycache__/playmus.cpython-312.pyc,,
+pygame/examples/__pycache__/resizing_new.cpython-312.pyc,,
+pygame/examples/__pycache__/scaletest.cpython-312.pyc,,
+pygame/examples/__pycache__/scrap_clipboard.cpython-312.pyc,,
+pygame/examples/__pycache__/scroll.cpython-312.pyc,,
+pygame/examples/__pycache__/setmodescale.cpython-312.pyc,,
+pygame/examples/__pycache__/sound.cpython-312.pyc,,
+pygame/examples/__pycache__/sound_array_demos.cpython-312.pyc,,
+pygame/examples/__pycache__/sprite_texture.cpython-312.pyc,,
+pygame/examples/__pycache__/stars.cpython-312.pyc,,
+pygame/examples/__pycache__/testsprite.cpython-312.pyc,,
+pygame/examples/__pycache__/textinput.cpython-312.pyc,,
+pygame/examples/__pycache__/vgrade.cpython-312.pyc,,
+pygame/examples/__pycache__/video.cpython-312.pyc,,
+pygame/examples/aacircle.py,sha256=cKBEPuz4nVNgiyxf9SFI4c4P8jFmvJMHh_rlKDahm9I,1037
+pygame/examples/aliens.py,sha256=acRm3demyftDlt3uTc8_rI1xVlWqM4PZqt1ekxuYIs4,12310
+pygame/examples/arraydemo.py,sha256=G4ZYl8JqPNnbEJl6Ed7UCBfJvrz9QtHauFoFus87WB0,3255
+pygame/examples/audiocapture.py,sha256=hkq7mMKSmSvfHHD5UiIER4928il2l0mqdahkJViHHr8,1561
+pygame/examples/blend_fill.py,sha256=CCQJraeaBLEea-2_lWaUxVlcjM5rxy5UykRIjWCUAu0,3399
+pygame/examples/blit_blends.py,sha256=han3N9jK8dy57EePLJNJ73MEjfl34ypahoY7oGwZwt0,6318
+pygame/examples/camera.py,sha256=5205gt_W9EoTartrtQtXrdD-AkCLx6r8DkBaAvdiFO4,3905
+pygame/examples/chimp.py,sha256=2uBvczKQW8XEG87yJlf4CB46RR4b1a5iPjMi_C--fAY,5912
+pygame/examples/cursors.py,sha256=CtDYC49tEm2xcRft-Wlxa1zSVY3pqeunx0njhcCyV2c,7938
+pygame/examples/data/BGR.png,sha256=DvOrlW5BJdat94nNV8XEETBLRrSWRV7byQsMPsA69uw,244
+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/arraydemo.bmp,sha256=xM4-n_hRCQFZlfwwdTK6eaBweycUc863TgSFbWp3dbA,76854
+pygame/examples/data/asprite.bmp,sha256=97XMpKq9lLpMuv8UveCf8UJEAxheBhPUjHfMRQBkUx4,578
+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/blue.mpg,sha256=XDj1CRPt1MWxspCfA3oqb822nlZgQ7CyyEuVJwlgmpg,6144
+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.png,sha256=gFY5lDOflZ5fCMXpL9_HmipP4-3ALn_r6cCB9yTZKBk,826
+pygame/examples/data/city.png,sha256=c0Nu2o7x7QmvGMDmDCaPnhvJ8tPNuguKKpI_Z-NfQ40,143
+pygame/examples/data/crimson.pnm,sha256=o9ziiY4ox_cCmEo07w08SQckCQTRttxtLgKBE0VmZY8,3124
+pygame/examples/data/cursor.png,sha256=3RDqIuKTXH8Bs67n_ZwEbuS09dQtJeKRgSMR6D9gtWQ,2708
+pygame/examples/data/danger.gif,sha256=m0CBKalFbkqlohgOmrwkwVOfqBhRWonb7xm1pzbDy2Q,2761
+pygame/examples/data/explosion1.gif,sha256=WYcdwbZqmYdaaaPYFiR5vka0Anp4F4nnNlpSSx_1xug,6513
+pygame/examples/data/fist.png,sha256=X0VOsy6fP0UGqBjy7baoBX8XAXyp_1_s2tOItbtA7EI,86196
+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.mp3,sha256=R0nZUXymMp_XLPU8S1yvsiVeWT6MKLt5Rjp-WSnVrLQ,116320
+pygame/examples/data/house_lo.ogg,sha256=64FiQ1Zjq-cOj6Bmya_v3ZjEWmBaGZlTl19udKaz6sU,31334
+pygame/examples/data/house_lo.wav,sha256=B1BwfFaPIsSxaash-igVI_YE9SQd1BCXRTnSAKsNunY,78464
+pygame/examples/data/laplacian.png,sha256=uWI8dPstqMEPVuFPGtm-guu48T2-L3kn99rWA3ZhZ-Q,253
+pygame/examples/data/liquid.bmp,sha256=qtzPXhq0dr2ORNCCZ6gY2loT2Tsu0Dx5YvXB548I1Xg,11734
+pygame/examples/data/midikeys.png,sha256=9HCCmMHvlubR6G9a0jMv1C-AKeBzYfb5jjNhol2Mdqw,19666
+pygame/examples/data/player1.gif,sha256=3ZTVWGxnedKqtf3R-X1omPC0Y8jUSPGgHBAzeGhnV4c,3470
+pygame/examples/data/punch.wav,sha256=A0F1xT8aIZ6aNI_5McMqLygb1EfmdIzPi4kWkU4EwQc,4176
+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.png,sha256=Xe4wN80awt7nTNiLemoSNTEKlAbGFW7djNETP8IleNs,1202
+pygame/examples/data/teal.svg,sha256=nkksR3fo0NPwC9sVXQPrPR_QrvqRiUB1vC4I-K83dho,313
+pygame/examples/data/turquoise.tif,sha256=4OkIy6CDPMv77tRR_wA9ZHA6qZzG3pjZ-1m1mNB7bcI,1186
+pygame/examples/data/whiff.wav,sha256=FMWM3XnYtce6mHFXQCYPgzT-xu-Q4DJybZfpPjG8cpE,5850
+pygame/examples/data/yellow.tga,sha256=EhxUG3SMO6bbHxr4yFggnKrsC1mYZVq-L6znAsR3z8I,3116
+pygame/examples/dropevent.py,sha256=WMvQbhrHNuSsEyv2hcFr4K4Q83MbZCKtsFNpfuH_SDU,2187
+pygame/examples/eventlist.py,sha256=aPTb0B3DAGnuG76Bz6l8aj6-r3VQ314o9LAiJEl2VHM,5912
+pygame/examples/font_viewer.py,sha256=5l9vYH-P4CTCBxM7TkYh9ASLhdSTf2NB7n-vNu5ZY94,9648
+pygame/examples/fonty.py,sha256=qiYuIracT_jwH5HFx9-tLcwc8qlgALwmL93aZjcUQrU,2073
+pygame/examples/freetype_misc.py,sha256=Fd3USUExyXsmQWWO9I8f2TMLXDooCAebYx10Pnnmbxk,3659
+pygame/examples/glcube.py,sha256=UONh_9RvLhCG8qLQUys4sE2xXY8ukf2zs0KXr_IRE5k,16860
+pygame/examples/go_over_there.py,sha256=YPlaHd2rd4Kc7Cm5VYzRjHUiF8eng04rTO-5cEC_hJ8,2150
+pygame/examples/grid.py,sha256=9dEYCiBjkNxjvk5aMukZxyGtaSVUIWXR4MCN56JEsYY,1745
+pygame/examples/headless_no_windows_needed.py,sha256=Lf-FVBNEHON53nSPLFR5DXHVua5S5N_4LX3gd_yRf_o,1299
+pygame/examples/joystick.py,sha256=pIw3_JRd9R0bpu9LPMiMuN53LVZliWehR3MJ5SFcmzo,5252
+pygame/examples/liquid.py,sha256=mGAniBgkpFYhNyM4XMoFRtlwCbQtd5aZaWCI6C23Bak,2544
+pygame/examples/mask.py,sha256=henO1A-xYDZrB6yqYVOnXkVr-8JeZbNXDODhGmczUgU,5725
+pygame/examples/midi.py,sha256=iQh1tPyyi7zejua6VJa--77aPW-i8Bb8TokRtfaHLRo,31267
+pygame/examples/moveit.py,sha256=cLYWPTnqRVud-Lbq9bVd2S1W8KA8eSExjXmFof35wdI,3330
+pygame/examples/music_drop_fade.py,sha256=bzhtDpDkjyod6Jb-rLU6KAh3KAiHQLFP1XVx717fPt0,9110
+pygame/examples/pixelarray.py,sha256=UQzu0tO7g8EOMoQPVLoFRUvMv1ePd9ybkGUg1PKYoXA,3453
+pygame/examples/playmus.py,sha256=xPhC5wCIyEOjiJkz-ZNtRUl9kladd6m0ZU_jl6QSEko,5215
+pygame/examples/resizing_new.py,sha256=8p6Sy8s74A49OXeboxmWnKGQJVO99ATE4nm7A_ADTxY,1046
+pygame/examples/scaletest.py,sha256=Iq8w-K4pf92-2oee7caNcW9KaOIosArD4AL6roR-svY,4826
+pygame/examples/scrap_clipboard.py,sha256=L2tOzkBSxV3f3hva8XiUibMmYW3oxEMlVUmnX97dXlI,3033
+pygame/examples/scroll.py,sha256=2mKc79QAHLWMO8mG50jmuWTXAvZXdtVsqwjKVFA18RY,6642
+pygame/examples/setmodescale.py,sha256=6GCUOLrGp7KITI1qoGj1hJqNxkouUqmdfYgXlD7IYns,1801
+pygame/examples/sound.py,sha256=CwQ3hSKjD_sHmXEBLfimdbt18cQcXwk5QQ7jfnOuSS0,1172
+pygame/examples/sound_array_demos.py,sha256=Pp6ZsH2WRn_T2z5JNSdpEwILbTh2t_60F5tvNL7zt_s,5756
+pygame/examples/sprite_texture.py,sha256=XCbP01L_tVSylh67kvnPfbU7jLVGXfCwLwZ-HnPa1rU,2667
+pygame/examples/stars.py,sha256=fB6OkpKUYh2WtI04nM32_8A5QDrrw8Xlg_ZCTmVfl6w,2714
+pygame/examples/testsprite.py,sha256=2SRjgFolTSWWxQroPm_HztVADxoKvg5JXddawjvjkjY,6862
+pygame/examples/textinput.py,sha256=vf887f8nAInO66p4qwZbJu316I2bWmUkmZHi50hu9TQ,7579
+pygame/examples/vgrade.py,sha256=RZDRrsAi0bTg6SAh8UJqRQx8viMwjmLSyK20dCql7us,3263
+pygame/examples/video.py,sha256=v_81PS92Mxad1KelrHOAOGwLsIjE46GIM7HwUj9oSPo,4357
+pygame/fastevent.py,sha256=NOVGX3eAvQGCSHDOZZJ_VuWSyekqdPO1Wrr2MvCEQeU,1694
+pygame/fastevent.pyi,sha256=3FmWstDsaRS5TOqExgceS8jeZnkkYhSrYIgTEqSKkU0,249
+pygame/font.cpython-312-darwin.so,sha256=xBUPShvJf0qpzcIFeNlybsDRR5NY_qProWMteBtGMcM,62768
+pygame/font.pyi,sha256=YDTjkLtJUC_xp4Na6q-tolDN1AiFk9WTioGtwNHWFPU,2079
+pygame/freesansbold.ttf,sha256=v5JRJp8R5LNVgqmTdglt7uPQxJc6RZy9l7C-vAH0QK0,98600
+pygame/freetype.py,sha256=OyLcjKlZXyhQEV2EZ0xMY57HypqGA77K14CJGMxw5H8,2224
+pygame/freetype.pyi,sha256=sjguJUovQqRjoKZ9xACq52-ykUY2XRir__Uody8UPVo,3512
+pygame/ftfont.py,sha256=wJeDvzh9XT3Mi3Yur-JUCIBICEsOeNpeXwW--eBoLbg,6153
+pygame/gfxdraw.cpython-312-darwin.so,sha256=uAeTFJ5Iee_ogdzQYc2LWwXta_R-6bHoOA6RjnDktN8,117424
+pygame/gfxdraw.pyi,sha256=GbHQUuqOdJAxe6tQfp1EfhL3-P6vBltbayaMBeFjsVY,2500
+pygame/image.cpython-312-darwin.so,sha256=_LRq5kAsAM7FyKCGrOx-dF-Jsle4Pg4hautG393WtJ4,75232
+pygame/image.pyi,sha256=5bCTCOTJ5azmeIV82settKwR4aKfOA_kB_1mSiBTqSs,1705
+pygame/imageext.cpython-312-darwin.so,sha256=VLM5XlVWBq_o42W7qGcbscSfhS3JXaebkKg13c5pAAc,57680
+pygame/joystick.cpython-312-darwin.so,sha256=JJgYT8WIugodivcF7kr-DP7DqK4HM88EDui3sXqKbZ4,60304
+pygame/joystick.pyi,sha256=Lr0DiEuJjbuyGEc1fCPkzVMYPu_qPGUky_x-k5KikPQ,1348
+pygame/key.cpython-312-darwin.so,sha256=ofT_vdtRbBZHjWufhcBjBk-CF4N7uqygOf0_UaeCRhw,58224
+pygame/key.pyi,sha256=7Ei4SZ3tuWMb9XAtRZm2lw9Sd5BDwjzM3QS1-WRrcBY,562
+pygame/locals.py,sha256=IO2_D-d3Z5FStP6QDjiyN_W0QPq0i_hHuCQWhxdFRSs,1195
+pygame/locals.pyi,sha256=fLWVStrayTJQMr7r5z45ywHMIOgEYIqLYJkyjIcUsGg,9925
+pygame/macosx.py,sha256=GJYmXKulp9UCu5NgYMtHIzp22ij-QZBhNOLbrJdgtsM,329
+pygame/mask.cpython-312-darwin.so,sha256=A52I0En-XWRZw2GMOyu4arm-sSuDxpJkE4wDI-ckA9E,114304
+pygame/mask.pyi,sha256=bBxSevY0teCHn86xPnQIgx10xLd5HX2O3Ohkfrz_m5E,2304
+pygame/math.cpython-312-darwin.so,sha256=_gq32fCaY3B0FgUmXFTtjwS7ErdwkIEgabs6OVmVyas,126688
+pygame/math.pyi,sha256=crW5wZF1MKl2sERrePqGW1roEXACWAbyreqbi2n9zZs,11685
+pygame/midi.py,sha256=GEmQFXnCclms235CT5ULsMs6fIbnrIpwo57J-Kbla_c,24341
+pygame/midi.pyi,sha256=LlPPnnXyHdklV5OTipShPxi8WUcc-NyasfLYxz-fcGw,1774
+pygame/mixer.cpython-312-darwin.so,sha256=HyCCgLF_qfI9FAq28BM1qB1eaw6EGFa-sST_moRy7wk,84656
+pygame/mixer.pyi,sha256=HuPeysk7q79eWlPe2r54Z-j1Kgx1JKTQZnvXCESibjA,2856
+pygame/mixer_music.cpython-312-darwin.so,sha256=k71KEtcMNu_TXW3XlOcUA3i0cbVdj6bbgS820TqlNH8,59984
+pygame/mixer_music.pyi,sha256=gMklc23g-bBIAGa3giyM00yi2jLedrKipx9_8lebvFY,691
+pygame/mouse.cpython-312-darwin.so,sha256=HK4U2DONvp0X9ibehNukXcufDZYaAwMcAa-V3zDZ_jk,57968
+pygame/mouse.pyi,sha256=a9Y_UtpHhMVQqpE3LnkAaI3EoVjQMdVNJNVeZ-eXTXE,1184
+pygame/newbuffer.cpython-312-darwin.so,sha256=aawPh_We0j9AAOZ4264-9i8ROSPnEStHCIH9cC6GXms,60256
+pygame/pixelarray.cpython-312-darwin.so,sha256=aQEjOwfU4j90V2UonmcRRzPXBSgTOtsHhguo2GrnTo4,96320
+pygame/pixelarray.pyi,sha256=8bDvIdo9QPBfgSSU04kxZaYCkkdv_XyXRQtA28YI6P0,1226
+pygame/pixelcopy.cpython-312-darwin.so,sha256=vsutt6M-z4y_qtQoHrf1ADLZguqoD6sBwMTHWhxQd6A,89456
+pygame/pixelcopy.pyi,sha256=9P6c4l_16qAfJYsQ3IkJGPMKyp_weLB1e9iQIvLYDZM,534
+pygame/pkgdata.py,sha256=RTPgP8uEaPK9GdyeOSUzdN4N9LLdrUASHUXMoUersFY,2421
+pygame/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+pygame/pygame.ico,sha256=PBF9cw0Ca9Rw2pNmDD3iXvcYYQeI9ZzZ9vxtRLQRoJc,145516
+pygame/pygame_icon.bmp,sha256=Twnby8nv4HMhGka49n-47CPseDvwrSLZ0l1o9U2Bb5s,630
+pygame/pygame_icon.icns,sha256=4jwAo9VtMhTK9hq9ibt6MZ4_sd2VsZueWZ3YAMuTPgw,264148
+pygame/pygame_icon_mac.bmp,sha256=QrAs3kEF6v7wVMlIJgktI90aUdTg9RdTmp16d2HZhNg,262282
+pygame/pypm.cpython-312-darwin.so,sha256=5ThJ8DPpol43_ZNDtn1cSef1xn9KQO1Ii1kj8OvY8Lo,176288
+pygame/rect.cpython-312-darwin.so,sha256=CrIMmh4kI9UWqo0WrixARSErcP39l4sg4ZfU3PRgrmM,85840
+pygame/rect.pyi,sha256=gOICRGGXcziZKQvJrWVJ34H3wNl6-3Qp9uyWicbLHko,7138
+pygame/rwobject.cpython-312-darwin.so,sha256=1LluoGNyoS2saMFJwtTfje7capGk1ct13gB6_hJrhuQ,58272
+pygame/rwobject.pyi,sha256=7pjMcSV8digIazj9i0h5se7steQNUtBBBcK-f2sY-Yo,544
+pygame/scrap.cpython-312-darwin.so,sha256=7pFdSfdddoyswtAbo5_qorlqmboAuvKtEzjWaWrm87A,57888
+pygame/scrap.pyi,sha256=xEbe7P1WNSmqeFQ-M3XCX3JztjHu1-m_0x8vkL6S4bA,366
+pygame/sdlmain_osx.cpython-312-darwin.so,sha256=6OdK6D5MLvaHuIzYni1fQYpg_5WFo9B8sUvu7O4tONw,57840
+pygame/sndarray.py,sha256=hJMTnQBEbOBYzeBRdCiGHCr3S20NqpHVevX2WFxw51I,4083
+pygame/sndarray.pyi,sha256=-kUmCShhKSazBRhHberq4kDhQau0I-02LZHvfIVYi7A,337
+pygame/sprite.py,sha256=Uaas5bn2a85gfbRXHGJwlQVh6OLA_vrPc8iK4qbTcqE,62899
+pygame/sprite.pyi,sha256=M6V64QuHdfITdWOaX6Xa20v4B9tJoUjYtyCdCcqz0LI,9748
+pygame/surface.cpython-312-darwin.so,sha256=NTZSMQw8PbGfU_zKpekxl6TfrRy6cGmrk7DnI8JlGXg,293904
+pygame/surface.pyi,sha256=mKyduOgOgekHQ3JObqdjFMkTMI22Aeat2MCAkOTWseE,4726
+pygame/surfarray.py,sha256=xlKZVqyoL8DSOAGOarb0E8VSha0vPn3xYY2fJz7zT8o,14405
+pygame/surfarray.pyi,sha256=g4w8kePGEZGMGhdtKo0ClZ3G-VPitz7DmrtIK6a7FGY,1287
+pygame/surflock.cpython-312-darwin.so,sha256=p5XQFshM5aXezevSc8UcFRXCYz4jvbCkX6Mj81k8F_A,55936
+pygame/surflock.pyi,sha256=p6HFejTvHw2HxSUOD4vW9HolANRfvGHjADdRh63skKQ,122
+pygame/sysfont.py,sha256=8-p9XqoPP15Vkmtm9WcIzi_xmpIvk-WobfExf4MWxsM,15391
+pygame/tests/__init__.py,sha256=wfUhz-LZF-OXZNT81UfGdofNYPCUMJoF3nwgXpzg4sE,1251
+pygame/tests/__main__.py,sha256=xLKWh5Kk0hc-2vz_OrNsMkVproZ3ndWz6ZCMY7Myk5A,3788
+pygame/tests/__pycache__/__init__.cpython-312.pyc,,
+pygame/tests/__pycache__/__main__.cpython-312.pyc,,
+pygame/tests/__pycache__/base_test.cpython-312.pyc,,
+pygame/tests/__pycache__/blit_test.cpython-312.pyc,,
+pygame/tests/__pycache__/bufferproxy_test.cpython-312.pyc,,
+pygame/tests/__pycache__/camera_test.cpython-312.pyc,,
+pygame/tests/__pycache__/color_test.cpython-312.pyc,,
+pygame/tests/__pycache__/constants_test.cpython-312.pyc,,
+pygame/tests/__pycache__/controller_test.cpython-312.pyc,,
+pygame/tests/__pycache__/cursors_test.cpython-312.pyc,,
+pygame/tests/__pycache__/display_test.cpython-312.pyc,,
+pygame/tests/__pycache__/docs_test.cpython-312.pyc,,
+pygame/tests/__pycache__/draw_test.cpython-312.pyc,,
+pygame/tests/__pycache__/event_test.cpython-312.pyc,,
+pygame/tests/__pycache__/font_test.cpython-312.pyc,,
+pygame/tests/__pycache__/freetype_tags.cpython-312.pyc,,
+pygame/tests/__pycache__/freetype_test.cpython-312.pyc,,
+pygame/tests/__pycache__/ftfont_tags.cpython-312.pyc,,
+pygame/tests/__pycache__/ftfont_test.cpython-312.pyc,,
+pygame/tests/__pycache__/gfxdraw_test.cpython-312.pyc,,
+pygame/tests/__pycache__/image__save_gl_surface_test.cpython-312.pyc,,
+pygame/tests/__pycache__/image_tags.cpython-312.pyc,,
+pygame/tests/__pycache__/image_test.cpython-312.pyc,,
+pygame/tests/__pycache__/imageext_tags.cpython-312.pyc,,
+pygame/tests/__pycache__/imageext_test.cpython-312.pyc,,
+pygame/tests/__pycache__/joystick_test.cpython-312.pyc,,
+pygame/tests/__pycache__/key_test.cpython-312.pyc,,
+pygame/tests/__pycache__/locals_test.cpython-312.pyc,,
+pygame/tests/__pycache__/mask_test.cpython-312.pyc,,
+pygame/tests/__pycache__/math_test.cpython-312.pyc,,
+pygame/tests/__pycache__/midi_test.cpython-312.pyc,,
+pygame/tests/__pycache__/mixer_music_tags.cpython-312.pyc,,
+pygame/tests/__pycache__/mixer_music_test.cpython-312.pyc,,
+pygame/tests/__pycache__/mixer_tags.cpython-312.pyc,,
+pygame/tests/__pycache__/mixer_test.cpython-312.pyc,,
+pygame/tests/__pycache__/mouse_test.cpython-312.pyc,,
+pygame/tests/__pycache__/pixelarray_test.cpython-312.pyc,,
+pygame/tests/__pycache__/pixelcopy_test.cpython-312.pyc,,
+pygame/tests/__pycache__/rect_test.cpython-312.pyc,,
+pygame/tests/__pycache__/rwobject_test.cpython-312.pyc,,
+pygame/tests/__pycache__/scrap_tags.cpython-312.pyc,,
+pygame/tests/__pycache__/scrap_test.cpython-312.pyc,,
+pygame/tests/__pycache__/sndarray_tags.cpython-312.pyc,,
+pygame/tests/__pycache__/sndarray_test.cpython-312.pyc,,
+pygame/tests/__pycache__/sprite_test.cpython-312.pyc,,
+pygame/tests/__pycache__/surface_test.cpython-312.pyc,,
+pygame/tests/__pycache__/surfarray_tags.cpython-312.pyc,,
+pygame/tests/__pycache__/surfarray_test.cpython-312.pyc,,
+pygame/tests/__pycache__/surflock_test.cpython-312.pyc,,
+pygame/tests/__pycache__/sysfont_test.cpython-312.pyc,,
+pygame/tests/__pycache__/threads_test.cpython-312.pyc,,
+pygame/tests/__pycache__/time_test.cpython-312.pyc,,
+pygame/tests/__pycache__/touch_test.cpython-312.pyc,,
+pygame/tests/__pycache__/transform_test.cpython-312.pyc,,
+pygame/tests/__pycache__/version_test.cpython-312.pyc,,
+pygame/tests/__pycache__/video_test.cpython-312.pyc,,
+pygame/tests/base_test.py,sha256=d6POJDqd_uxot9yxTxRBW2thiOD4o0HYuIHBq84OBUg,22449
+pygame/tests/blit_test.py,sha256=IUGAXjy0ZK72jmboE2r9LF9wZ7TXlYJAzm99a4JNfV0,6343
+pygame/tests/bufferproxy_test.py,sha256=bji75h8zDPEHNXSKEnT9Gb4T0_cMcAlDxqvPdlR5WU0,16451
+pygame/tests/camera_test.py,sha256=kMyJ3SYnifZe5Mv7JRl8exEuJ4IOe2SA98_6y-Uour0,801
+pygame/tests/color_test.py,sha256=I0OxIOf8sqYk8nW3Wmy76AqFuFSCwafDGUOF8O6QA58,49781
+pygame/tests/constants_test.py,sha256=kOOqPnXMMka37d4VUDo70j3i_zAN74Y5QuRLnNQsRao,9308
+pygame/tests/controller_test.py,sha256=a6NSWn1k1Rpt4HTYeOAbF-cDx0KfnKsrG6DwA0vk_0k,10834
+pygame/tests/cursors_test.py,sha256=qc-T5sdh25LO-KOK16CMp9FnWCXJSwdUo29YkePeSTs,7700
+pygame/tests/display_test.py,sha256=hSHKBJUqDJWzgnQgNten0L5ejEQgNd1wZRklzBDLzmo,46425
+pygame/tests/docs_test.py,sha256=r2qa_ox8eg2_Y5Pb9-XzZExAhqJrdVMO30guO1o7PPM,1091
+pygame/tests/draw_test.py,sha256=YEt_6zJKnTRBjxHbO4dKBfWwFOmGDVbhwPe0zvdt5zI,237912
+pygame/tests/event_test.py,sha256=XNd_lLqGbZ9PwAJPL4AxoZwblLTlQrsLU_KpoiMyaog,33593
+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/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=lYgOKil5siDjsy-0FV2kHOTO8vdAESmVzYOoT8yONyc,27182
+pygame/tests/freetype_tags.py,sha256=NdjMDSYHfrhopKR0JuTeUfFX-AbcCu4fsXnS1a46iVM,182
+pygame/tests/freetype_test.py,sha256=GFZUMLZF-KjXEyOhq0FqI2Oe_nt1hbkPHTkSW7RN3pk,64896
+pygame/tests/ftfont_tags.py,sha256=IvteBUDEp4rv9q6FwlTpQ9X2px-XUromSMQ921VrhCU,180
+pygame/tests/ftfont_test.py,sha256=YZesw8r_NfqcoUsg78FbAh0kJaeC6iAzixHMsQcH3gY,421
+pygame/tests/gfxdraw_test.py,sha256=XWxHvtvkMWllmlCsGhaUGCdOFBAiOfJgYg_KnUj8Q_E,32354
+pygame/tests/image__save_gl_surface_test.py,sha256=5H8TeGZNRZzu5kJInWPe8AuuKqHv-utunadoBmn--CI,1198
+pygame/tests/image_tags.py,sha256=_WJGXgTOaUn4IG7fIk1sDKfDDZP3W8N6PkrrOpPT-U8,132
+pygame/tests/image_test.py,sha256=LaHCxn5hpcy1s9SdOq712iPau_4p-2Gq0mKjmc9pifc,43024
+pygame/tests/imageext_tags.py,sha256=-vnXr7O5F1NVrEDrOHBEYdaD-JiuBT9NI-lxGps-K1U,135
+pygame/tests/imageext_test.py,sha256=Dam4nzQG1dZtJ8rtAmSw2xdhIvENATklN81mVl5Mh4I,2852
+pygame/tests/joystick_test.py,sha256=XArf2gXSYYupNOuOekpKtGlJ_vaLWWUSl7hpKnBE3FU,6078
+pygame/tests/key_test.py,sha256=rZ9EPqi8q6VQI7kQzdjW8U0Ebqk2QYnU9D7i2TXsdDY,9172
+pygame/tests/locals_test.py,sha256=2g4vCW-wJG0U_wA7VP1kieV-wSsvGInyGkLW6OjvJ4o,417
+pygame/tests/mask_test.py,sha256=95xNu2gy1TVgxKNnDdcYXgo_rKaTdKPAqeeKn1jI_Xg,245880
+pygame/tests/math_test.py,sha256=LmwS-6B6LU4EXRx9_I-s_WyrddmEcu7HDp7xNL6VK30,111540
+pygame/tests/midi_test.py,sha256=utmDFvk5wZCcXrTTGXnl4N6dMjmkXgrIV6nGtgcws6k,16905
+pygame/tests/mixer_music_tags.py,sha256=o0gsQDjuICFYw8j3WOlIluwk9fdA42ledU1U6DIJzNU,138
+pygame/tests/mixer_music_test.py,sha256=rgTeUXFm__7ZR5SDVqB6O5VyRlwFuTZ9LrSP1Q4-R3s,17522
+pygame/tests/mixer_tags.py,sha256=qKcn8AD46H3V87xONG0iXlGH_FveeGBgf2gE1MMh2s0,132
+pygame/tests/mixer_test.py,sha256=OMElH1sGbJGlRK7Psr1qwWZvHG_MciAA5F_6o9S6rsE,54019
+pygame/tests/mouse_test.py,sha256=wL5Jmwj65UhtrON5rSXImomjNE_afKGlFQqlS-JZfT8,13146
+pygame/tests/pixelarray_test.py,sha256=NKVn_4NumiMz0CHUDm7DH-OcEZI0XpAZmjenAXwDJlY,62745
+pygame/tests/pixelcopy_test.py,sha256=j8ywtiFayJMiRBi1v6ywED8xnRkpSVv5vZ579yEvpDA,25543
+pygame/tests/rect_test.py,sha256=qN1IQrf9iFXuJfIF-8sOwqouxbMJkzNPLTD-YvIxHlA,117687
+pygame/tests/run_tests__tests/__init__.py,sha256=9_8wL9Scv8_Cs8HJyJHGvx1vwXErsuvlsAqNZLcJQR0,8
+pygame/tests/run_tests__tests/__pycache__/__init__.cpython-312.pyc,,
+pygame/tests/run_tests__tests/__pycache__/run_tests__test.cpython-312.pyc,,
+pygame/tests/run_tests__tests/all_ok/__init__.py,sha256=9_8wL9Scv8_Cs8HJyJHGvx1vwXErsuvlsAqNZLcJQR0,8
+pygame/tests/run_tests__tests/all_ok/__pycache__/__init__.cpython-312.pyc,,
+pygame/tests/run_tests__tests/all_ok/__pycache__/fake_2_test.cpython-312.pyc,,
+pygame/tests/run_tests__tests/all_ok/__pycache__/fake_3_test.cpython-312.pyc,,
+pygame/tests/run_tests__tests/all_ok/__pycache__/fake_4_test.cpython-312.pyc,,
+pygame/tests/run_tests__tests/all_ok/__pycache__/fake_5_test.cpython-312.pyc,,
+pygame/tests/run_tests__tests/all_ok/__pycache__/fake_6_test.cpython-312.pyc,,
+pygame/tests/run_tests__tests/all_ok/__pycache__/no_assertions__ret_code_of_1__test.cpython-312.pyc,,
+pygame/tests/run_tests__tests/all_ok/__pycache__/zero_tests_test.cpython-312.pyc,,
+pygame/tests/run_tests__tests/all_ok/fake_2_test.py,sha256=zFUNsDLmH9Pvpo-YEpvfW2raQyA6EL_BW3CuP10YIKU,899
+pygame/tests/run_tests__tests/all_ok/fake_3_test.py,sha256=zFUNsDLmH9Pvpo-YEpvfW2raQyA6EL_BW3CuP10YIKU,899
+pygame/tests/run_tests__tests/all_ok/fake_4_test.py,sha256=zFUNsDLmH9Pvpo-YEpvfW2raQyA6EL_BW3CuP10YIKU,899
+pygame/tests/run_tests__tests/all_ok/fake_5_test.py,sha256=zFUNsDLmH9Pvpo-YEpvfW2raQyA6EL_BW3CuP10YIKU,899
+pygame/tests/run_tests__tests/all_ok/fake_6_test.py,sha256=zFUNsDLmH9Pvpo-YEpvfW2raQyA6EL_BW3CuP10YIKU,899
+pygame/tests/run_tests__tests/all_ok/no_assertions__ret_code_of_1__test.py,sha256=PNrfACCpcPnO964Oxv2-9l4ciuJ-Iqw3x8HDs-kebVg,797
+pygame/tests/run_tests__tests/all_ok/zero_tests_test.py,sha256=XzLaMjkygsvNkFEqnRU9y2Ijm6bfds9n5Z6mg_LOMJQ,545
+pygame/tests/run_tests__tests/everything/__init__.py,sha256=9_8wL9Scv8_Cs8HJyJHGvx1vwXErsuvlsAqNZLcJQR0,8
+pygame/tests/run_tests__tests/everything/__pycache__/__init__.cpython-312.pyc,,
+pygame/tests/run_tests__tests/everything/__pycache__/fake_2_test.cpython-312.pyc,,
+pygame/tests/run_tests__tests/everything/__pycache__/incomplete_todo_test.cpython-312.pyc,,
+pygame/tests/run_tests__tests/everything/__pycache__/magic_tag_test.cpython-312.pyc,,
+pygame/tests/run_tests__tests/everything/__pycache__/sleep_test.cpython-312.pyc,,
+pygame/tests/run_tests__tests/everything/fake_2_test.py,sha256=zFUNsDLmH9Pvpo-YEpvfW2raQyA6EL_BW3CuP10YIKU,899
+pygame/tests/run_tests__tests/everything/incomplete_todo_test.py,sha256=71myeZtFerYY2rB-j60l5Ltz3FiRCuOR4evFXtJHC34,909
+pygame/tests/run_tests__tests/everything/magic_tag_test.py,sha256=SjIKB_7aLfGdih8cotQ34m1KbSEII_1wGQUBwrWeIyY,859
+pygame/tests/run_tests__tests/everything/sleep_test.py,sha256=AyGwZk5fQAkfeCr9VewdsuD_z5BzlVfkmbZD-XetB50,715
+pygame/tests/run_tests__tests/exclude/__init__.py,sha256=9_8wL9Scv8_Cs8HJyJHGvx1vwXErsuvlsAqNZLcJQR0,8
+pygame/tests/run_tests__tests/exclude/__pycache__/__init__.cpython-312.pyc,,
+pygame/tests/run_tests__tests/exclude/__pycache__/fake_2_test.cpython-312.pyc,,
+pygame/tests/run_tests__tests/exclude/__pycache__/invisible_tag_test.cpython-312.pyc,,
+pygame/tests/run_tests__tests/exclude/__pycache__/magic_tag_test.cpython-312.pyc,,
+pygame/tests/run_tests__tests/exclude/fake_2_test.py,sha256=zFUNsDLmH9Pvpo-YEpvfW2raQyA6EL_BW3CuP10YIKU,899
+pygame/tests/run_tests__tests/exclude/invisible_tag_test.py,sha256=AdHFvOK-kCRi2iUs68So6Ngef6C_LEdx3QpMLjhKtmM,925
+pygame/tests/run_tests__tests/exclude/magic_tag_test.py,sha256=SjIKB_7aLfGdih8cotQ34m1KbSEII_1wGQUBwrWeIyY,859
+pygame/tests/run_tests__tests/failures1/__init__.py,sha256=9_8wL9Scv8_Cs8HJyJHGvx1vwXErsuvlsAqNZLcJQR0,8
+pygame/tests/run_tests__tests/failures1/__pycache__/__init__.cpython-312.pyc,,
+pygame/tests/run_tests__tests/failures1/__pycache__/fake_2_test.cpython-312.pyc,,
+pygame/tests/run_tests__tests/failures1/__pycache__/fake_3_test.cpython-312.pyc,,
+pygame/tests/run_tests__tests/failures1/__pycache__/fake_4_test.cpython-312.pyc,,
+pygame/tests/run_tests__tests/failures1/fake_2_test.py,sha256=zFUNsDLmH9Pvpo-YEpvfW2raQyA6EL_BW3CuP10YIKU,899
+pygame/tests/run_tests__tests/failures1/fake_3_test.py,sha256=zFUNsDLmH9Pvpo-YEpvfW2raQyA6EL_BW3CuP10YIKU,899
+pygame/tests/run_tests__tests/failures1/fake_4_test.py,sha256=xWpIVUpzevSs4bVeze48Q9jkZzss4szdw6eMOrJnZV8,949
+pygame/tests/run_tests__tests/incomplete/__init__.py,sha256=9_8wL9Scv8_Cs8HJyJHGvx1vwXErsuvlsAqNZLcJQR0,8
+pygame/tests/run_tests__tests/incomplete/__pycache__/__init__.cpython-312.pyc,,
+pygame/tests/run_tests__tests/incomplete/__pycache__/fake_2_test.cpython-312.pyc,,
+pygame/tests/run_tests__tests/incomplete/__pycache__/fake_3_test.cpython-312.pyc,,
+pygame/tests/run_tests__tests/incomplete/fake_2_test.py,sha256=RVUuQZxqYScIUAflNIsXd7UE6Rxm6HHFZSi8cpz5m-k,889
+pygame/tests/run_tests__tests/incomplete/fake_3_test.py,sha256=zFUNsDLmH9Pvpo-YEpvfW2raQyA6EL_BW3CuP10YIKU,899
+pygame/tests/run_tests__tests/incomplete_todo/__init__.py,sha256=9_8wL9Scv8_Cs8HJyJHGvx1vwXErsuvlsAqNZLcJQR0,8
+pygame/tests/run_tests__tests/incomplete_todo/__pycache__/__init__.cpython-312.pyc,,
+pygame/tests/run_tests__tests/incomplete_todo/__pycache__/fake_2_test.cpython-312.pyc,,
+pygame/tests/run_tests__tests/incomplete_todo/__pycache__/fake_3_test.cpython-312.pyc,,
+pygame/tests/run_tests__tests/incomplete_todo/fake_2_test.py,sha256=71myeZtFerYY2rB-j60l5Ltz3FiRCuOR4evFXtJHC34,909
+pygame/tests/run_tests__tests/incomplete_todo/fake_3_test.py,sha256=zFUNsDLmH9Pvpo-YEpvfW2raQyA6EL_BW3CuP10YIKU,899
+pygame/tests/run_tests__tests/infinite_loop/__init__.py,sha256=9_8wL9Scv8_Cs8HJyJHGvx1vwXErsuvlsAqNZLcJQR0,8
+pygame/tests/run_tests__tests/infinite_loop/__pycache__/__init__.cpython-312.pyc,,
+pygame/tests/run_tests__tests/infinite_loop/__pycache__/fake_1_test.cpython-312.pyc,,
+pygame/tests/run_tests__tests/infinite_loop/__pycache__/fake_2_test.cpython-312.pyc,,
+pygame/tests/run_tests__tests/infinite_loop/fake_1_test.py,sha256=rNt-VaNziz7OmfbDXcbXbDIbwC_6ScFJ-MtenMjR68Y,906
+pygame/tests/run_tests__tests/infinite_loop/fake_2_test.py,sha256=zFUNsDLmH9Pvpo-YEpvfW2raQyA6EL_BW3CuP10YIKU,899
+pygame/tests/run_tests__tests/print_stderr/__init__.py,sha256=9_8wL9Scv8_Cs8HJyJHGvx1vwXErsuvlsAqNZLcJQR0,8
+pygame/tests/run_tests__tests/print_stderr/__pycache__/__init__.cpython-312.pyc,,
+pygame/tests/run_tests__tests/print_stderr/__pycache__/fake_2_test.cpython-312.pyc,,
+pygame/tests/run_tests__tests/print_stderr/__pycache__/fake_3_test.cpython-312.pyc,,
+pygame/tests/run_tests__tests/print_stderr/__pycache__/fake_4_test.cpython-312.pyc,,
+pygame/tests/run_tests__tests/print_stderr/fake_2_test.py,sha256=zFUNsDLmH9Pvpo-YEpvfW2raQyA6EL_BW3CuP10YIKU,899
+pygame/tests/run_tests__tests/print_stderr/fake_3_test.py,sha256=6AGEff135DU_spRhZ09oDGXE4lZC3dlHU_phnfOyWYY,954
+pygame/tests/run_tests__tests/print_stderr/fake_4_test.py,sha256=xWpIVUpzevSs4bVeze48Q9jkZzss4szdw6eMOrJnZV8,949
+pygame/tests/run_tests__tests/print_stdout/__init__.py,sha256=9_8wL9Scv8_Cs8HJyJHGvx1vwXErsuvlsAqNZLcJQR0,8
+pygame/tests/run_tests__tests/print_stdout/__pycache__/__init__.cpython-312.pyc,,
+pygame/tests/run_tests__tests/print_stdout/__pycache__/fake_2_test.cpython-312.pyc,,
+pygame/tests/run_tests__tests/print_stdout/__pycache__/fake_3_test.cpython-312.pyc,,
+pygame/tests/run_tests__tests/print_stdout/__pycache__/fake_4_test.cpython-312.pyc,,
+pygame/tests/run_tests__tests/print_stdout/fake_2_test.py,sha256=zFUNsDLmH9Pvpo-YEpvfW2raQyA6EL_BW3CuP10YIKU,899
+pygame/tests/run_tests__tests/print_stdout/fake_3_test.py,sha256=cruYqrh3O3MQ8fczEFloLpsrQrYmMOd6jgxMU6e5H8w,1012
+pygame/tests/run_tests__tests/print_stdout/fake_4_test.py,sha256=xWpIVUpzevSs4bVeze48Q9jkZzss4szdw6eMOrJnZV8,949
+pygame/tests/run_tests__tests/run_tests__test.py,sha256=9mDlobUHX5baqNIJvCo4hN7XGb5qRIRO_DFfNcOno5I,4315
+pygame/tests/run_tests__tests/timeout/__init__.py,sha256=9_8wL9Scv8_Cs8HJyJHGvx1vwXErsuvlsAqNZLcJQR0,8
+pygame/tests/run_tests__tests/timeout/__pycache__/__init__.cpython-312.pyc,,
+pygame/tests/run_tests__tests/timeout/__pycache__/fake_2_test.cpython-312.pyc,,
+pygame/tests/run_tests__tests/timeout/__pycache__/sleep_test.cpython-312.pyc,,
+pygame/tests/run_tests__tests/timeout/fake_2_test.py,sha256=zFUNsDLmH9Pvpo-YEpvfW2raQyA6EL_BW3CuP10YIKU,899
+pygame/tests/run_tests__tests/timeout/sleep_test.py,sha256=5EDW4U6kYN4QIid0IgHBypJ3T3a78pILILF41DPpujk,716
+pygame/tests/rwobject_test.py,sha256=LAJun6obwHADEiONe6F68WNM9qAuL7i4hqbPErjmox4,4323
+pygame/tests/scrap_tags.py,sha256=zHyLWy2JRyfw0DamlH9dz-MZq2R2uOryjH9JRu-RCkw,671
+pygame/tests/scrap_test.py,sha256=qt47IQLTs3jqf8FEP1mBC8gX6SzbeLsjJnIdszMhbYU,9160
+pygame/tests/sndarray_tags.py,sha256=ThDQxqGFaAembuWgdYGsFSWEppVezgXJ2htYRvvDaXE,190
+pygame/tests/sndarray_test.py,sha256=BOv9SLpvUiQraLEykbOHKyE4jkSJuKYPd1IRUdU510Y,6290
+pygame/tests/sprite_test.py,sha256=08ZqxvMi7Bii4gGFVy2NdKJ3yWKz1an6AyEQs8Qhmqs,47210
+pygame/tests/surface_test.py,sha256=1bzv6cwWVL8wxNk0ZlX8iGVrP2Ep8NagqsP_iem8qKI,165585
+pygame/tests/surfarray_tags.py,sha256=AwlglKM7DrjHvvcSMm-yXb-PSxsVhJkS6VE7Z8wOhes,260
+pygame/tests/surfarray_test.py,sha256=mYy2tMofKo6ESr70UOc-qxxU2X22sUKw_zyMHmwHgFc,25812
+pygame/tests/surflock_test.py,sha256=dMZkzND7-R_z-GaxN4ZIcpNtW3PsK1i7kdnizpU21UY,4728
+pygame/tests/sysfont_test.py,sha256=uf7ISqCvoiegyUvYTqOT1-kYQi_POeejL1TqXXeYF9Q,1463
+pygame/tests/test_utils/__init__.py,sha256=_eQvMYQ_-gFuB1fiftJLjL0RYqV3tl5jRYeBUzI8x-4,4429
+pygame/tests/test_utils/__pycache__/__init__.cpython-312.pyc,,
+pygame/tests/test_utils/__pycache__/arrinter.cpython-312.pyc,,
+pygame/tests/test_utils/__pycache__/async_sub.cpython-312.pyc,,
+pygame/tests/test_utils/__pycache__/buftools.cpython-312.pyc,,
+pygame/tests/test_utils/__pycache__/endian.cpython-312.pyc,,
+pygame/tests/test_utils/__pycache__/png.cpython-312.pyc,,
+pygame/tests/test_utils/__pycache__/run_tests.cpython-312.pyc,,
+pygame/tests/test_utils/__pycache__/test_machinery.cpython-312.pyc,,
+pygame/tests/test_utils/__pycache__/test_runner.cpython-312.pyc,,
+pygame/tests/test_utils/arrinter.py,sha256=xmfJDli6Q3SPBy5cLAF0SqTXlRc5QDZRhbDP50p5pjc,14698
+pygame/tests/test_utils/async_sub.py,sha256=2BqxoeKTo6sPlW2bwGCieEb0lwxZsHUHBnGFjSPny68,9128
+pygame/tests/test_utils/buftools.py,sha256=9bae7xJK78yZQk1Pc2juF-1Gp19Zpwsl3ujnCfsh48o,23641
+pygame/tests/test_utils/endian.py,sha256=Rc7rl38YamHgi8EzB92Muu8C4XH6yltH9f5On7qfMpY,495
+pygame/tests/test_utils/png.py,sha256=dxobMiiDvvAEZSNFoy0EkQxYoLNzfc4rHKLwYM58PEQ,152320
+pygame/tests/test_utils/run_tests.py,sha256=KeqrO4gUuPx6ElW9x-AuS_02Nqk7hMLasFFGfO-CjfY,12039
+pygame/tests/test_utils/test_machinery.py,sha256=4vsi3mOw_581298rsp4cmcQYpbB6P5PK3Eg0cTBy138,2429
+pygame/tests/test_utils/test_runner.py,sha256=ktlXMmx0LOD9gmeTXyk72Ozo1UkYlUUJGoYoohdMZfY,9328
+pygame/tests/threads_test.py,sha256=WWTg2G0x3eP0JxWZa3qGCbkRMWfiNCpkX9-_e0aUWZY,7833
+pygame/tests/time_test.py,sha256=lQTubG8CiDnTwHOcV0Esvk1QJX90vjbxZNDdorg1wZU,16065
+pygame/tests/touch_test.py,sha256=9e5LDHeZrtQSaUBrb9dLHT1YDuNuccSlYvcYIWYIm7k,3216
+pygame/tests/transform_test.py,sha256=EryZIaG25yunlIW9wS4pnQhtswVNI-IBp9oAJzTe7zY,53328
+pygame/tests/version_test.py,sha256=dvNIneFf1c4PAKa4xo1YLAlYRDFYL8_ZeUwI1FS55Is,1536
+pygame/tests/video_test.py,sha256=USdLAov8GnN_9vsXl_1pe0MI0ddM3KurURDhVQIV3nY,694
+pygame/threads/__init__.py,sha256=mkOLm--1G55m8Vj5AY30IMUhMfL1lBjZxcgNESooZBw,8063
+pygame/threads/__pycache__/__init__.cpython-312.pyc,,
+pygame/time.cpython-312-darwin.so,sha256=HLnyLGwISksbcNXMMksbVdhHccaU715GxwJNitDmTWs,58560
+pygame/time.pyi,sha256=0dUmVQjxwyhXkSRGX0DnqM2-0JzOMIVbHx4psLfrlhI,501
+pygame/transform.cpython-312-darwin.so,sha256=04Uijo-In7_b2f7wsxF8e2xaBQCZfskkcs3S-KfK64o,114592
+pygame/transform.pyi,sha256=EsjIBP706hur5c6aKmUBMbCp9cPQIilWcqkSHkCeUk4,1999
+pygame/version.py,sha256=pVI8HGqiF3HxgSZxrGL9-iTYQJT-rwXAJpa9xx_yjjM,2454
+pygame/version.pyi,sha256=NvmU4694WwSRWMiZ5WL3APQYA2s_3xY4foOnPsncNuM,600
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame-2.6.1.dist-info/REQUESTED b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame-2.6.1.dist-info/REQUESTED
new file mode 100644
index 0000000..e69de29
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame-2.6.1.dist-info/WHEEL b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame-2.6.1.dist-info/WHEEL
new file mode 100644
index 0000000..b79c5a7
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame-2.6.1.dist-info/WHEEL
@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (75.1.0)
+Root-Is-Purelib: false
+Tag: cp312-cp312-macosx_10_9_x86_64
+
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame-2.6.1.dist-info/entry_points.txt b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame-2.6.1.dist-info/entry_points.txt
new file mode 100644
index 0000000..05adb06
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame-2.6.1.dist-info/entry_points.txt
@@ -0,0 +1,2 @@
+[pyinstaller40]
+hook-dirs = pygame.__pyinstaller:get_hook_dirs
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame-2.6.1.dist-info/top_level.txt b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame-2.6.1.dist-info/top_level.txt
new file mode 100644
index 0000000..0cb7ff1
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame-2.6.1.dist-info/top_level.txt
@@ -0,0 +1 @@
+pygame
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/.dylibs/libFLAC.8.dylib b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/.dylibs/libFLAC.8.dylib
new file mode 100755
index 0000000..391e1a9
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/.dylibs/libFLAC.8.dylib differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/.dylibs/libSDL2-2.0.0.dylib b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/.dylibs/libSDL2-2.0.0.dylib
new file mode 100755
index 0000000..a486011
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/.dylibs/libSDL2-2.0.0.dylib differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/.dylibs/libSDL2_image-2.0.0.dylib b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/.dylibs/libSDL2_image-2.0.0.dylib
new file mode 100755
index 0000000..4c91f97
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/.dylibs/libSDL2_image-2.0.0.dylib differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/.dylibs/libSDL2_mixer-2.0.0.dylib b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/.dylibs/libSDL2_mixer-2.0.0.dylib
new file mode 100755
index 0000000..54cec78
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/.dylibs/libSDL2_mixer-2.0.0.dylib differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/.dylibs/libSDL2_ttf-2.0.0.dylib b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/.dylibs/libSDL2_ttf-2.0.0.dylib
new file mode 100755
index 0000000..b8b1db8
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/.dylibs/libSDL2_ttf-2.0.0.dylib differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/.dylibs/libbrotlicommon.1.0.9.dylib b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/.dylibs/libbrotlicommon.1.0.9.dylib
new file mode 100755
index 0000000..0c01644
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/.dylibs/libbrotlicommon.1.0.9.dylib differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/.dylibs/libbrotlidec.1.0.9.dylib b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/.dylibs/libbrotlidec.1.0.9.dylib
new file mode 100755
index 0000000..ad7a83b
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/.dylibs/libbrotlidec.1.0.9.dylib differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/.dylibs/libfluidsynth.3.1.1.dylib b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/.dylibs/libfluidsynth.3.1.1.dylib
new file mode 100755
index 0000000..d6f4f56
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/.dylibs/libfluidsynth.3.1.1.dylib differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/.dylibs/libfreetype.6.dylib b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/.dylibs/libfreetype.6.dylib
new file mode 100755
index 0000000..ab8780e
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/.dylibs/libfreetype.6.dylib differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/.dylibs/libglib-2.0.0.dylib b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/.dylibs/libglib-2.0.0.dylib
new file mode 100755
index 0000000..73707cd
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/.dylibs/libglib-2.0.0.dylib differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/.dylibs/libgthread-2.0.0.dylib b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/.dylibs/libgthread-2.0.0.dylib
new file mode 100755
index 0000000..17ea136
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/.dylibs/libgthread-2.0.0.dylib differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/.dylibs/libintl.8.dylib b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/.dylibs/libintl.8.dylib
new file mode 100644
index 0000000..ee12f40
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/.dylibs/libintl.8.dylib differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/.dylibs/libjpeg.62.3.0.dylib b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/.dylibs/libjpeg.62.3.0.dylib
new file mode 100755
index 0000000..19ea174
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/.dylibs/libjpeg.62.3.0.dylib differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/.dylibs/libmpg123.0.dylib b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/.dylibs/libmpg123.0.dylib
new file mode 100755
index 0000000..3ba4baf
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/.dylibs/libmpg123.0.dylib differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/.dylibs/libogg.0.8.5.dylib b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/.dylibs/libogg.0.8.5.dylib
new file mode 100755
index 0000000..a0c96b5
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/.dylibs/libogg.0.8.5.dylib differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/.dylibs/libopus.0.dylib b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/.dylibs/libopus.0.dylib
new file mode 100755
index 0000000..52e3b22
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/.dylibs/libopus.0.dylib differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/.dylibs/libopusfile.0.dylib b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/.dylibs/libopusfile.0.dylib
new file mode 100755
index 0000000..9936216
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/.dylibs/libopusfile.0.dylib differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/.dylibs/libpng16.16.dylib b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/.dylibs/libpng16.16.dylib
new file mode 100755
index 0000000..23541b1
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/.dylibs/libpng16.16.dylib differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/.dylibs/libportmidi.2.0.3.dylib b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/.dylibs/libportmidi.2.0.3.dylib
new file mode 100755
index 0000000..1eb307b
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/.dylibs/libportmidi.2.0.3.dylib differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/.dylibs/libsharpyuv.0.dylib b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/.dylibs/libsharpyuv.0.dylib
new file mode 100755
index 0000000..e62d2cb
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/.dylibs/libsharpyuv.0.dylib differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/.dylibs/libsndfile.1.0.34.dylib b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/.dylibs/libsndfile.1.0.34.dylib
new file mode 100755
index 0000000..087c6db
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/.dylibs/libsndfile.1.0.34.dylib differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/.dylibs/libtiff.5.8.0.dylib b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/.dylibs/libtiff.5.8.0.dylib
new file mode 100755
index 0000000..d5f3dc3
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/.dylibs/libtiff.5.8.0.dylib differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/.dylibs/libvorbis.0.4.9.dylib b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/.dylibs/libvorbis.0.4.9.dylib
new file mode 100755
index 0000000..4466aff
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/.dylibs/libvorbis.0.4.9.dylib differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/.dylibs/libvorbisenc.2.0.12.dylib b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/.dylibs/libvorbisenc.2.0.12.dylib
new file mode 100755
index 0000000..8ebcbda
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/.dylibs/libvorbisenc.2.0.12.dylib differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/.dylibs/libvorbisfile.3.3.8.dylib b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/.dylibs/libvorbisfile.3.3.8.dylib
new file mode 100755
index 0000000..ba49156
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/.dylibs/libvorbisfile.3.3.8.dylib differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/.dylibs/libwebp.7.dylib b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/.dylibs/libwebp.7.dylib
new file mode 100755
index 0000000..ae4fef5
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/.dylibs/libwebp.7.dylib differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/.dylibs/libz.1.2.11.zlib-ng.dylib b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/.dylibs/libz.1.2.11.zlib-ng.dylib
new file mode 100755
index 0000000..8c3eeab
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/.dylibs/libz.1.2.11.zlib-ng.dylib differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/__init__.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/__init__.py
new file mode 100644
index 0000000..da8bff7
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/__init__.py
@@ -0,0 +1,345 @@
+# pygame - Python Game Library
+# Copyright (C) 2000-2001  Pete Shinners
+#
+# This library is free software; you can redistribute it and/or
+# modify it under the terms of the GNU Library General Public
+# License as published by the Free Software Foundation; either
+# version 2 of the License, or (at your option) any later version.
+#
+# This library is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+# Library General Public License for more details.
+#
+# You should have received a copy of the GNU Library General Public
+# License along with this library; if not, write to the Free
+# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
+#
+# Pete Shinners
+# pete@shinners.org
+"""Pygame is a set of Python modules designed for writing games.
+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."""
+
+import sys
+import os
+
+# Choose Windows display driver
+if os.name == "nt":
+    pygame_dir = os.path.split(__file__)[0]
+
+    # pypy does not find the dlls, so we add package folder to PATH.
+    os.environ["PATH"] = os.environ["PATH"] + ";" + pygame_dir
+
+    # 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
+
+# when running under X11, always set the SDL window WM_CLASS to make the
+#   window managers correctly match the pygame window.
+elif "DISPLAY" in os.environ and "SDL_VIDEO_X11_WMCLASS" not in os.environ:
+    os.environ["SDL_VIDEO_X11_WMCLASS"] = os.path.basename(sys.argv[0])
+
+
+def _attribute_undefined(name):
+    raise RuntimeError(f"{name} is not available")
+
+
+class MissingModule:
+    _NOT_IMPLEMENTED_ = True
+
+    def __init__(self, name, urgent=0):
+        self.name = name
+        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()
+
+    def __getattr__(self, var):
+        if not self.urgent:
+            self.warn()
+            self.urgent = 1
+        missing_msg = f"{self.name} module not available ({self.reason})"
+        raise NotImplementedError(missing_msg)
+
+    def __bool__(self):
+        return False
+
+    def warn(self):
+        msg_type = "import" if self.urgent else "use"
+        message = f"{msg_type} {self.name}: {self.info}\n({self.reason})"
+        try:
+            import warnings
+
+            level = 4 if self.urgent else 3
+            warnings.warn(message, RuntimeWarning, level)
+        except ImportError:
+            print(message)
+
+
+# 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
+
+# first, the "required" modules
+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.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
+
+__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):
+    display = MissingModule("display", urgent=1)
+
+try:
+    import pygame.draw
+except (ImportError, OSError):
+    draw = MissingModule("draw", urgent=1)
+
+try:
+    import pygame.event
+except (ImportError, OSError):
+    event = MissingModule("event", urgent=1)
+
+try:
+    import pygame.image
+except (ImportError, OSError):
+    image = MissingModule("image", urgent=1)
+
+try:
+    import pygame.joystick
+except (ImportError, OSError):
+    joystick = MissingModule("joystick", urgent=1)
+
+try:
+    import pygame.key
+except (ImportError, OSError):
+    key = MissingModule("key", urgent=1)
+
+try:
+    import pygame.mouse
+except (ImportError, OSError):
+    mouse = MissingModule("mouse", urgent=1)
+
+try:
+    import pygame.cursors
+    from pygame.cursors import Cursor
+except (ImportError, OSError):
+    cursors = MissingModule("cursors", urgent=1)
+
+    def Cursor(*args):  # pylint: disable=unused-argument
+        _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):
+    pixelcopy = MissingModule("pixelcopy", urgent=1)
+
+
+try:
+    from pygame.surface import Surface, SurfaceType
+except (ImportError, OSError):
+
+    def Surface(size, flags, depth, masks):  # pylint: disable=unused-argument
+        _attribute_undefined("pygame.Surface")
+
+    SurfaceType = Surface
+
+try:
+    import pygame.mask
+    from pygame.mask import Mask
+except (ImportError, OSError):
+    mask = MissingModule("mask", urgent=0)
+
+    def Mask(size, fill):  # pylint: disable=unused-argument
+        _attribute_undefined("pygame.Mask")
+
+
+try:
+    from pygame.pixelarray import PixelArray
+except (ImportError, OSError):
+
+    def PixelArray(surface):  # pylint: disable=unused-argument
+        _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
+except (ImportError, OSError):
+    time = MissingModule("time", urgent=1)
+
+try:
+    import pygame.transform
+except (ImportError, OSError):
+    transform = MissingModule("transform", urgent=1)
+
+# lastly, the "optional" pygame modules
+if "PYGAME_FREETYPE" in os.environ:
+    try:
+        import pygame.ftfont as font
+
+        sys.modules["pygame.font"] = font
+    except (ImportError, OSError):
+        pass
+try:
+    import pygame.font
+    import pygame.sysfont
+
+    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 and load pygame.mixer_music before mixer, for py2app...
+try:
+    import pygame.mixer_music
+
+    # del pygame.mixer_music
+    # print("NOTE2: failed importing pygame.mixer_music in lib/__init__.py")
+except (ImportError, OSError):
+    pass
+
+try:
+    import pygame.mixer
+except (ImportError, OSError):
+    mixer = MissingModule("mixer", urgent=0)
+
+try:
+    import pygame.scrap
+except (ImportError, OSError):
+    scrap = MissingModule("scrap", urgent=0)
+
+try:
+    import pygame.surfarray
+except (ImportError, OSError):
+    surfarray = MissingModule("surfarray", urgent=0)
+
+try:
+    import pygame.sndarray
+except (ImportError, OSError):
+    sndarray = MissingModule("sndarray", urgent=0)
+
+try:
+    import pygame.fastevent
+except (ImportError, OSError):
+    fastevent = MissingModule("fastevent", urgent=0)
+
+# there's also a couple "internal" modules not needed
+# by users, but putting them here helps "dependency finder"
+# programs get everything they need (like py2exe)
+try:
+    import pygame.imageext
+
+    del pygame.imageext
+except (ImportError, OSError):
+    pass
+
+# this internal module needs to be included for dependency
+# finders, but can't be deleted, as some tests need it
+try:
+    import pygame.pkgdata
+
+except (ImportError, OSError):
+    pass
+
+
+def packager_imports():
+    """some additional imports that py2app/py2exe will want to see"""
+    import atexit
+    import numpy
+    import OpenGL.GL
+    import pygame.macosx
+    import pygame.colordict
+
+
+# make Rects pickleable
+
+import copyreg
+
+
+def __rect_constructor(x, y, w, h):
+    return Rect(x, y, w, h)
+
+
+def __rect_reduce(r):
+    assert isinstance(r, Rect)
+    return __rect_constructor, (r.x, r.y, r.w, r.h)
+
+
+copyreg.pickle(Rect, __rect_reduce, __rect_constructor)
+
+
+# make Colors pickleable
+def __color_constructor(r, g, b, a):
+    return Color(r, g, b, a)
+
+
+def __color_reduce(c):
+    assert isinstance(c, Color)
+    return __color_constructor, (c.r, c.g, c.b, c.a)
+
+
+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:
+    print(
+        "pygame {} (SDL {}.{}.{}, Python {}.{}.{})".format(  # pylint: disable=consider-using-f-string
+            ver, *get_sdl_version() + sys.version_info[0:3]
+        )
+    )
+    print("Hello from the pygame community. https://www.pygame.org/contribute.html")
+
+# cleanup namespace
+del pygame, os, sys, MissingModule, copyreg, packager_imports
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/__init__.pyi b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/__init__.pyi
new file mode 100644
index 0000000..2d26fd1
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/__init__.pyi
@@ -0,0 +1,632 @@
+# 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!
+
+
+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,
+    font as font,
+    image as image,
+    key as key,
+    mixer as mixer,
+    mouse as mouse,
+    time as time,
+    cursors as cursors,
+    joystick as joystick,
+    math as math,
+    mask as mask,
+    pixelcopy as pixelcopy,
+    sndarray as sndarray,
+    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,
+    color as color,
+    colordict as colordict,
+    mixer_music as mixer_music,
+    pixelarray as pixelarray,
+    rect as rect,
+    rwobject as rwobject,
+    surface as surface,
+    surflock as surflock,
+    sysfont as sysfont,
+)
+
+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
+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 .base import (
+    BufferError as BufferError,
+    HAVE_NEWBUF as HAVE_NEWBUF,
+    error as error,
+    get_array_interface as get_array_interface,
+    get_error as get_error,
+    get_init as get_init,
+    get_sdl_byteorder as get_sdl_byteorder,
+    get_sdl_version as get_sdl_version,
+    init as init,
+    quit as quit,
+    register_quit as register_quit,
+    set_error as set_error,
+)
+
+from .rwobject import (
+    encode_file_path as encode_file_path,
+    encode_string as encode_string,
+)
+
+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,
+    APPACTIVE as APPACTIVE,
+    APPINPUTFOCUS as APPINPUTFOCUS,
+    APPMOUSEFOCUS as APPMOUSEFOCUS,
+    APP_DIDENTERBACKGROUND as APP_DIDENTERBACKGROUND,
+    APP_DIDENTERFOREGROUND as APP_DIDENTERFOREGROUND,
+    APP_LOWMEMORY as APP_LOWMEMORY,
+    APP_TERMINATING as APP_TERMINATING,
+    APP_WILLENTERBACKGROUND as APP_WILLENTERBACKGROUND,
+    APP_WILLENTERFOREGROUND as APP_WILLENTERFOREGROUND,
+    ASYNCBLIT as ASYNCBLIT,
+    AUDIODEVICEADDED as AUDIODEVICEADDED,
+    AUDIODEVICEREMOVED as AUDIODEVICEREMOVED,
+    AUDIO_ALLOW_ANY_CHANGE as AUDIO_ALLOW_ANY_CHANGE,
+    AUDIO_ALLOW_CHANNELS_CHANGE as AUDIO_ALLOW_CHANNELS_CHANGE,
+    AUDIO_ALLOW_FORMAT_CHANGE as AUDIO_ALLOW_FORMAT_CHANGE,
+    AUDIO_ALLOW_FREQUENCY_CHANGE as AUDIO_ALLOW_FREQUENCY_CHANGE,
+    AUDIO_S16 as AUDIO_S16,
+    AUDIO_S16LSB as AUDIO_S16LSB,
+    AUDIO_S16MSB as AUDIO_S16MSB,
+    AUDIO_S16SYS as AUDIO_S16SYS,
+    AUDIO_S8 as AUDIO_S8,
+    AUDIO_U16 as AUDIO_U16,
+    AUDIO_U16LSB as AUDIO_U16LSB,
+    AUDIO_U16MSB as AUDIO_U16MSB,
+    AUDIO_U16SYS as AUDIO_U16SYS,
+    AUDIO_U8 as AUDIO_U8,
+    BIG_ENDIAN as BIG_ENDIAN,
+    BLENDMODE_ADD as BLENDMODE_ADD,
+    BLENDMODE_BLEND as BLENDMODE_BLEND,
+    BLENDMODE_MOD as BLENDMODE_MOD,
+    BLENDMODE_NONE as BLENDMODE_NONE,
+    BLEND_ADD as BLEND_ADD,
+    BLEND_ALPHA_SDL2 as BLEND_ALPHA_SDL2,
+    BLEND_MAX as BLEND_MAX,
+    BLEND_MIN as BLEND_MIN,
+    BLEND_MULT as BLEND_MULT,
+    BLEND_PREMULTIPLIED as BLEND_PREMULTIPLIED,
+    BLEND_RGBA_ADD as BLEND_RGBA_ADD,
+    BLEND_RGBA_MAX as BLEND_RGBA_MAX,
+    BLEND_RGBA_MIN as BLEND_RGBA_MIN,
+    BLEND_RGBA_MULT as BLEND_RGBA_MULT,
+    BLEND_RGBA_SUB as BLEND_RGBA_SUB,
+    BLEND_RGB_ADD as BLEND_RGB_ADD,
+    BLEND_RGB_MAX as BLEND_RGB_MAX,
+    BLEND_RGB_MIN as BLEND_RGB_MIN,
+    BLEND_RGB_MULT as BLEND_RGB_MULT,
+    BLEND_RGB_SUB as BLEND_RGB_SUB,
+    BLEND_SUB as BLEND_SUB,
+    BUTTON_LEFT as BUTTON_LEFT,
+    BUTTON_MIDDLE as BUTTON_MIDDLE,
+    BUTTON_RIGHT as BUTTON_RIGHT,
+    BUTTON_WHEELDOWN as BUTTON_WHEELDOWN,
+    BUTTON_WHEELUP as BUTTON_WHEELUP,
+    BUTTON_X1 as BUTTON_X1,
+    BUTTON_X2 as BUTTON_X2,
+    CLIPBOARDUPDATE as CLIPBOARDUPDATE,
+    CONTROLLERAXISMOTION as CONTROLLERAXISMOTION,
+    CONTROLLERBUTTONDOWN as CONTROLLERBUTTONDOWN,
+    CONTROLLERBUTTONUP as CONTROLLERBUTTONUP,
+    CONTROLLERDEVICEADDED as CONTROLLERDEVICEADDED,
+    CONTROLLERDEVICEREMAPPED as CONTROLLERDEVICEREMAPPED,
+    CONTROLLERDEVICEREMOVED as CONTROLLERDEVICEREMOVED,
+    CONTROLLERSENSORUPDATE as CONTROLLERSENSORUPDATE,
+    CONTROLLERTOUCHPADDOWN as CONTROLLERTOUCHPADDOWN,
+    CONTROLLERTOUCHPADMOTION as CONTROLLERTOUCHPADMOTION,
+    CONTROLLERTOUCHPADUP as CONTROLLERTOUCHPADUP,
+    CONTROLLER_AXIS_INVALID as CONTROLLER_AXIS_INVALID,
+    CONTROLLER_AXIS_LEFTX as CONTROLLER_AXIS_LEFTX,
+    CONTROLLER_AXIS_LEFTY as CONTROLLER_AXIS_LEFTY,
+    CONTROLLER_AXIS_MAX as CONTROLLER_AXIS_MAX,
+    CONTROLLER_AXIS_RIGHTX as CONTROLLER_AXIS_RIGHTX,
+    CONTROLLER_AXIS_RIGHTY as CONTROLLER_AXIS_RIGHTY,
+    CONTROLLER_AXIS_TRIGGERLEFT as CONTROLLER_AXIS_TRIGGERLEFT,
+    CONTROLLER_AXIS_TRIGGERRIGHT as CONTROLLER_AXIS_TRIGGERRIGHT,
+    CONTROLLER_BUTTON_A as CONTROLLER_BUTTON_A,
+    CONTROLLER_BUTTON_B as CONTROLLER_BUTTON_B,
+    CONTROLLER_BUTTON_BACK as CONTROLLER_BUTTON_BACK,
+    CONTROLLER_BUTTON_DPAD_DOWN as CONTROLLER_BUTTON_DPAD_DOWN,
+    CONTROLLER_BUTTON_DPAD_LEFT as CONTROLLER_BUTTON_DPAD_LEFT,
+    CONTROLLER_BUTTON_DPAD_RIGHT as CONTROLLER_BUTTON_DPAD_RIGHT,
+    CONTROLLER_BUTTON_DPAD_UP as CONTROLLER_BUTTON_DPAD_UP,
+    CONTROLLER_BUTTON_GUIDE as CONTROLLER_BUTTON_GUIDE,
+    CONTROLLER_BUTTON_INVALID as CONTROLLER_BUTTON_INVALID,
+    CONTROLLER_BUTTON_LEFTSHOULDER as CONTROLLER_BUTTON_LEFTSHOULDER,
+    CONTROLLER_BUTTON_LEFTSTICK as CONTROLLER_BUTTON_LEFTSTICK,
+    CONTROLLER_BUTTON_MAX as CONTROLLER_BUTTON_MAX,
+    CONTROLLER_BUTTON_RIGHTSHOULDER as CONTROLLER_BUTTON_RIGHTSHOULDER,
+    CONTROLLER_BUTTON_RIGHTSTICK as CONTROLLER_BUTTON_RIGHTSTICK,
+    CONTROLLER_BUTTON_START as CONTROLLER_BUTTON_START,
+    CONTROLLER_BUTTON_X as CONTROLLER_BUTTON_X,
+    CONTROLLER_BUTTON_Y as CONTROLLER_BUTTON_Y,
+    DOUBLEBUF as DOUBLEBUF,
+    DROPBEGIN as DROPBEGIN,
+    DROPCOMPLETE as DROPCOMPLETE,
+    DROPFILE as DROPFILE,
+    DROPTEXT as DROPTEXT,
+    FINGERDOWN as FINGERDOWN,
+    FINGERMOTION as FINGERMOTION,
+    FINGERUP as FINGERUP,
+    FULLSCREEN as FULLSCREEN,
+    GL_ACCELERATED_VISUAL as GL_ACCELERATED_VISUAL,
+    GL_ACCUM_ALPHA_SIZE as GL_ACCUM_ALPHA_SIZE,
+    GL_ACCUM_BLUE_SIZE as GL_ACCUM_BLUE_SIZE,
+    GL_ACCUM_GREEN_SIZE as GL_ACCUM_GREEN_SIZE,
+    GL_ACCUM_RED_SIZE as GL_ACCUM_RED_SIZE,
+    GL_ALPHA_SIZE as GL_ALPHA_SIZE,
+    GL_BLUE_SIZE as GL_BLUE_SIZE,
+    GL_BUFFER_SIZE as GL_BUFFER_SIZE,
+    GL_CONTEXT_DEBUG_FLAG as GL_CONTEXT_DEBUG_FLAG,
+    GL_CONTEXT_FLAGS as GL_CONTEXT_FLAGS,
+    GL_CONTEXT_FORWARD_COMPATIBLE_FLAG as GL_CONTEXT_FORWARD_COMPATIBLE_FLAG,
+    GL_CONTEXT_MAJOR_VERSION as GL_CONTEXT_MAJOR_VERSION,
+    GL_CONTEXT_MINOR_VERSION as GL_CONTEXT_MINOR_VERSION,
+    GL_CONTEXT_PROFILE_COMPATIBILITY as GL_CONTEXT_PROFILE_COMPATIBILITY,
+    GL_CONTEXT_PROFILE_CORE as GL_CONTEXT_PROFILE_CORE,
+    GL_CONTEXT_PROFILE_ES as GL_CONTEXT_PROFILE_ES,
+    GL_CONTEXT_PROFILE_MASK as GL_CONTEXT_PROFILE_MASK,
+    GL_CONTEXT_RELEASE_BEHAVIOR as GL_CONTEXT_RELEASE_BEHAVIOR,
+    GL_CONTEXT_RELEASE_BEHAVIOR_FLUSH as GL_CONTEXT_RELEASE_BEHAVIOR_FLUSH,
+    GL_CONTEXT_RELEASE_BEHAVIOR_NONE as GL_CONTEXT_RELEASE_BEHAVIOR_NONE,
+    GL_CONTEXT_RESET_ISOLATION_FLAG as GL_CONTEXT_RESET_ISOLATION_FLAG,
+    GL_CONTEXT_ROBUST_ACCESS_FLAG as GL_CONTEXT_ROBUST_ACCESS_FLAG,
+    GL_DEPTH_SIZE as GL_DEPTH_SIZE,
+    GL_DOUBLEBUFFER as GL_DOUBLEBUFFER,
+    GL_FRAMEBUFFER_SRGB_CAPABLE as GL_FRAMEBUFFER_SRGB_CAPABLE,
+    GL_GREEN_SIZE as GL_GREEN_SIZE,
+    GL_MULTISAMPLEBUFFERS as GL_MULTISAMPLEBUFFERS,
+    GL_MULTISAMPLESAMPLES as GL_MULTISAMPLESAMPLES,
+    GL_RED_SIZE as GL_RED_SIZE,
+    GL_SHARE_WITH_CURRENT_CONTEXT as GL_SHARE_WITH_CURRENT_CONTEXT,
+    GL_STENCIL_SIZE as GL_STENCIL_SIZE,
+    GL_STEREO as GL_STEREO,
+    GL_SWAP_CONTROL as GL_SWAP_CONTROL,
+    HAT_CENTERED as HAT_CENTERED,
+    HAT_DOWN as HAT_DOWN,
+    HAT_LEFT as HAT_LEFT,
+    HAT_LEFTDOWN as HAT_LEFTDOWN,
+    HAT_LEFTUP as HAT_LEFTUP,
+    HAT_RIGHT as HAT_RIGHT,
+    HAT_RIGHTDOWN as HAT_RIGHTDOWN,
+    HAT_RIGHTUP as HAT_RIGHTUP,
+    HAT_UP as HAT_UP,
+    HIDDEN as HIDDEN,
+    HWACCEL as HWACCEL,
+    HWPALETTE as HWPALETTE,
+    HWSURFACE as HWSURFACE,
+    JOYAXISMOTION as JOYAXISMOTION,
+    JOYBALLMOTION as JOYBALLMOTION,
+    JOYBUTTONDOWN as JOYBUTTONDOWN,
+    JOYBUTTONUP as JOYBUTTONUP,
+    JOYDEVICEADDED as JOYDEVICEADDED,
+    JOYDEVICEREMOVED as JOYDEVICEREMOVED,
+    JOYHATMOTION as JOYHATMOTION,
+    KEYDOWN as KEYDOWN,
+    KEYMAPCHANGED as KEYMAPCHANGED,
+    KEYUP as KEYUP,
+    KMOD_ALT as KMOD_ALT,
+    KMOD_CAPS as KMOD_CAPS,
+    KMOD_CTRL as KMOD_CTRL,
+    KMOD_GUI as KMOD_GUI,
+    KMOD_LALT as KMOD_LALT,
+    KMOD_LCTRL as KMOD_LCTRL,
+    KMOD_LGUI as KMOD_LGUI,
+    KMOD_LMETA as KMOD_LMETA,
+    KMOD_LSHIFT as KMOD_LSHIFT,
+    KMOD_META as KMOD_META,
+    KMOD_MODE as KMOD_MODE,
+    KMOD_NONE as KMOD_NONE,
+    KMOD_NUM as KMOD_NUM,
+    KMOD_RALT as KMOD_RALT,
+    KMOD_RCTRL as KMOD_RCTRL,
+    KMOD_RGUI as KMOD_RGUI,
+    KMOD_RMETA as KMOD_RMETA,
+    KMOD_RSHIFT as KMOD_RSHIFT,
+    KMOD_SHIFT as KMOD_SHIFT,
+    KSCAN_0 as KSCAN_0,
+    KSCAN_1 as KSCAN_1,
+    KSCAN_2 as KSCAN_2,
+    KSCAN_3 as KSCAN_3,
+    KSCAN_4 as KSCAN_4,
+    KSCAN_5 as KSCAN_5,
+    KSCAN_6 as KSCAN_6,
+    KSCAN_7 as KSCAN_7,
+    KSCAN_8 as KSCAN_8,
+    KSCAN_9 as KSCAN_9,
+    KSCAN_A as KSCAN_A,
+    KSCAN_AC_BACK as KSCAN_AC_BACK,
+    KSCAN_APOSTROPHE as KSCAN_APOSTROPHE,
+    KSCAN_B as KSCAN_B,
+    KSCAN_BACKSLASH as KSCAN_BACKSLASH,
+    KSCAN_BACKSPACE as KSCAN_BACKSPACE,
+    KSCAN_BREAK as KSCAN_BREAK,
+    KSCAN_C as KSCAN_C,
+    KSCAN_CAPSLOCK as KSCAN_CAPSLOCK,
+    KSCAN_CLEAR as KSCAN_CLEAR,
+    KSCAN_COMMA as KSCAN_COMMA,
+    KSCAN_CURRENCYSUBUNIT as KSCAN_CURRENCYSUBUNIT,
+    KSCAN_CURRENCYUNIT as KSCAN_CURRENCYUNIT,
+    KSCAN_D as KSCAN_D,
+    KSCAN_DELETE as KSCAN_DELETE,
+    KSCAN_DOWN as KSCAN_DOWN,
+    KSCAN_E as KSCAN_E,
+    KSCAN_END as KSCAN_END,
+    KSCAN_EQUALS as KSCAN_EQUALS,
+    KSCAN_ESCAPE as KSCAN_ESCAPE,
+    KSCAN_EURO as KSCAN_EURO,
+    KSCAN_F as KSCAN_F,
+    KSCAN_F1 as KSCAN_F1,
+    KSCAN_F10 as KSCAN_F10,
+    KSCAN_F11 as KSCAN_F11,
+    KSCAN_F12 as KSCAN_F12,
+    KSCAN_F13 as KSCAN_F13,
+    KSCAN_F14 as KSCAN_F14,
+    KSCAN_F15 as KSCAN_F15,
+    KSCAN_F2 as KSCAN_F2,
+    KSCAN_F3 as KSCAN_F3,
+    KSCAN_F4 as KSCAN_F4,
+    KSCAN_F5 as KSCAN_F5,
+    KSCAN_F6 as KSCAN_F6,
+    KSCAN_F7 as KSCAN_F7,
+    KSCAN_F8 as KSCAN_F8,
+    KSCAN_F9 as KSCAN_F9,
+    KSCAN_G as KSCAN_G,
+    KSCAN_GRAVE as KSCAN_GRAVE,
+    KSCAN_H as KSCAN_H,
+    KSCAN_HELP as KSCAN_HELP,
+    KSCAN_HOME as KSCAN_HOME,
+    KSCAN_I as KSCAN_I,
+    KSCAN_INSERT as KSCAN_INSERT,
+    KSCAN_INTERNATIONAL1 as KSCAN_INTERNATIONAL1,
+    KSCAN_INTERNATIONAL2 as KSCAN_INTERNATIONAL2,
+    KSCAN_INTERNATIONAL3 as KSCAN_INTERNATIONAL3,
+    KSCAN_INTERNATIONAL4 as KSCAN_INTERNATIONAL4,
+    KSCAN_INTERNATIONAL5 as KSCAN_INTERNATIONAL5,
+    KSCAN_INTERNATIONAL6 as KSCAN_INTERNATIONAL6,
+    KSCAN_INTERNATIONAL7 as KSCAN_INTERNATIONAL7,
+    KSCAN_INTERNATIONAL8 as KSCAN_INTERNATIONAL8,
+    KSCAN_INTERNATIONAL9 as KSCAN_INTERNATIONAL9,
+    KSCAN_J as KSCAN_J,
+    KSCAN_K as KSCAN_K,
+    KSCAN_KP0 as KSCAN_KP0,
+    KSCAN_KP1 as KSCAN_KP1,
+    KSCAN_KP2 as KSCAN_KP2,
+    KSCAN_KP3 as KSCAN_KP3,
+    KSCAN_KP4 as KSCAN_KP4,
+    KSCAN_KP5 as KSCAN_KP5,
+    KSCAN_KP6 as KSCAN_KP6,
+    KSCAN_KP7 as KSCAN_KP7,
+    KSCAN_KP8 as KSCAN_KP8,
+    KSCAN_KP9 as KSCAN_KP9,
+    KSCAN_KP_0 as KSCAN_KP_0,
+    KSCAN_KP_1 as KSCAN_KP_1,
+    KSCAN_KP_2 as KSCAN_KP_2,
+    KSCAN_KP_3 as KSCAN_KP_3,
+    KSCAN_KP_4 as KSCAN_KP_4,
+    KSCAN_KP_5 as KSCAN_KP_5,
+    KSCAN_KP_6 as KSCAN_KP_6,
+    KSCAN_KP_7 as KSCAN_KP_7,
+    KSCAN_KP_8 as KSCAN_KP_8,
+    KSCAN_KP_9 as KSCAN_KP_9,
+    KSCAN_KP_DIVIDE as KSCAN_KP_DIVIDE,
+    KSCAN_KP_ENTER as KSCAN_KP_ENTER,
+    KSCAN_KP_EQUALS as KSCAN_KP_EQUALS,
+    KSCAN_KP_MINUS as KSCAN_KP_MINUS,
+    KSCAN_KP_MULTIPLY as KSCAN_KP_MULTIPLY,
+    KSCAN_KP_PERIOD as KSCAN_KP_PERIOD,
+    KSCAN_KP_PLUS as KSCAN_KP_PLUS,
+    KSCAN_L as KSCAN_L,
+    KSCAN_LALT as KSCAN_LALT,
+    KSCAN_LANG1 as KSCAN_LANG1,
+    KSCAN_LANG2 as KSCAN_LANG2,
+    KSCAN_LANG3 as KSCAN_LANG3,
+    KSCAN_LANG4 as KSCAN_LANG4,
+    KSCAN_LANG5 as KSCAN_LANG5,
+    KSCAN_LANG6 as KSCAN_LANG6,
+    KSCAN_LANG7 as KSCAN_LANG7,
+    KSCAN_LANG8 as KSCAN_LANG8,
+    KSCAN_LANG9 as KSCAN_LANG9,
+    KSCAN_LCTRL as KSCAN_LCTRL,
+    KSCAN_LEFT as KSCAN_LEFT,
+    KSCAN_LEFTBRACKET as KSCAN_LEFTBRACKET,
+    KSCAN_LGUI as KSCAN_LGUI,
+    KSCAN_LMETA as KSCAN_LMETA,
+    KSCAN_LSHIFT as KSCAN_LSHIFT,
+    KSCAN_LSUPER as KSCAN_LSUPER,
+    KSCAN_M as KSCAN_M,
+    KSCAN_MENU as KSCAN_MENU,
+    KSCAN_MINUS as KSCAN_MINUS,
+    KSCAN_MODE as KSCAN_MODE,
+    KSCAN_N as KSCAN_N,
+    KSCAN_NONUSBACKSLASH as KSCAN_NONUSBACKSLASH,
+    KSCAN_NONUSHASH as KSCAN_NONUSHASH,
+    KSCAN_NUMLOCK as KSCAN_NUMLOCK,
+    KSCAN_NUMLOCKCLEAR as KSCAN_NUMLOCKCLEAR,
+    KSCAN_O as KSCAN_O,
+    KSCAN_P as KSCAN_P,
+    KSCAN_PAGEDOWN as KSCAN_PAGEDOWN,
+    KSCAN_PAGEUP as KSCAN_PAGEUP,
+    KSCAN_PAUSE as KSCAN_PAUSE,
+    KSCAN_PERIOD as KSCAN_PERIOD,
+    KSCAN_POWER as KSCAN_POWER,
+    KSCAN_PRINT as KSCAN_PRINT,
+    KSCAN_PRINTSCREEN as KSCAN_PRINTSCREEN,
+    KSCAN_Q as KSCAN_Q,
+    KSCAN_R as KSCAN_R,
+    KSCAN_RALT as KSCAN_RALT,
+    KSCAN_RCTRL as KSCAN_RCTRL,
+    KSCAN_RETURN as KSCAN_RETURN,
+    KSCAN_RGUI as KSCAN_RGUI,
+    KSCAN_RIGHT as KSCAN_RIGHT,
+    KSCAN_RIGHTBRACKET as KSCAN_RIGHTBRACKET,
+    KSCAN_RMETA as KSCAN_RMETA,
+    KSCAN_RSHIFT as KSCAN_RSHIFT,
+    KSCAN_RSUPER as KSCAN_RSUPER,
+    KSCAN_S as KSCAN_S,
+    KSCAN_SCROLLLOCK as KSCAN_SCROLLLOCK,
+    KSCAN_SCROLLOCK as KSCAN_SCROLLOCK,
+    KSCAN_SEMICOLON as KSCAN_SEMICOLON,
+    KSCAN_SLASH as KSCAN_SLASH,
+    KSCAN_SPACE as KSCAN_SPACE,
+    KSCAN_SYSREQ as KSCAN_SYSREQ,
+    KSCAN_T as KSCAN_T,
+    KSCAN_TAB as KSCAN_TAB,
+    KSCAN_U as KSCAN_U,
+    KSCAN_UNKNOWN as KSCAN_UNKNOWN,
+    KSCAN_UP as KSCAN_UP,
+    KSCAN_V as KSCAN_V,
+    KSCAN_W as KSCAN_W,
+    KSCAN_X as KSCAN_X,
+    KSCAN_Y as KSCAN_Y,
+    KSCAN_Z as KSCAN_Z,
+    K_0 as K_0,
+    K_1 as K_1,
+    K_2 as K_2,
+    K_3 as K_3,
+    K_4 as K_4,
+    K_5 as K_5,
+    K_6 as K_6,
+    K_7 as K_7,
+    K_8 as K_8,
+    K_9 as K_9,
+    K_AC_BACK as K_AC_BACK,
+    K_AMPERSAND as K_AMPERSAND,
+    K_ASTERISK as K_ASTERISK,
+    K_AT as K_AT,
+    K_BACKQUOTE as K_BACKQUOTE,
+    K_BACKSLASH as K_BACKSLASH,
+    K_BACKSPACE as K_BACKSPACE,
+    K_BREAK as K_BREAK,
+    K_CAPSLOCK as K_CAPSLOCK,
+    K_CARET as K_CARET,
+    K_CLEAR as K_CLEAR,
+    K_COLON as K_COLON,
+    K_COMMA as K_COMMA,
+    K_CURRENCYSUBUNIT as K_CURRENCYSUBUNIT,
+    K_CURRENCYUNIT as K_CURRENCYUNIT,
+    K_DELETE as K_DELETE,
+    K_DOLLAR as K_DOLLAR,
+    K_DOWN as K_DOWN,
+    K_END as K_END,
+    K_EQUALS as K_EQUALS,
+    K_ESCAPE as K_ESCAPE,
+    K_EURO as K_EURO,
+    K_EXCLAIM as K_EXCLAIM,
+    K_F1 as K_F1,
+    K_F10 as K_F10,
+    K_F11 as K_F11,
+    K_F12 as K_F12,
+    K_F13 as K_F13,
+    K_F14 as K_F14,
+    K_F15 as K_F15,
+    K_F2 as K_F2,
+    K_F3 as K_F3,
+    K_F4 as K_F4,
+    K_F5 as K_F5,
+    K_F6 as K_F6,
+    K_F7 as K_F7,
+    K_F8 as K_F8,
+    K_F9 as K_F9,
+    K_GREATER as K_GREATER,
+    K_HASH as K_HASH,
+    K_HELP as K_HELP,
+    K_HOME as K_HOME,
+    K_INSERT as K_INSERT,
+    K_KP0 as K_KP0,
+    K_KP1 as K_KP1,
+    K_KP2 as K_KP2,
+    K_KP3 as K_KP3,
+    K_KP4 as K_KP4,
+    K_KP5 as K_KP5,
+    K_KP6 as K_KP6,
+    K_KP7 as K_KP7,
+    K_KP8 as K_KP8,
+    K_KP9 as K_KP9,
+    K_KP_0 as K_KP_0,
+    K_KP_1 as K_KP_1,
+    K_KP_2 as K_KP_2,
+    K_KP_3 as K_KP_3,
+    K_KP_4 as K_KP_4,
+    K_KP_5 as K_KP_5,
+    K_KP_6 as K_KP_6,
+    K_KP_7 as K_KP_7,
+    K_KP_8 as K_KP_8,
+    K_KP_9 as K_KP_9,
+    K_KP_DIVIDE as K_KP_DIVIDE,
+    K_KP_ENTER as K_KP_ENTER,
+    K_KP_EQUALS as K_KP_EQUALS,
+    K_KP_MINUS as K_KP_MINUS,
+    K_KP_MULTIPLY as K_KP_MULTIPLY,
+    K_KP_PERIOD as K_KP_PERIOD,
+    K_KP_PLUS as K_KP_PLUS,
+    K_LALT as K_LALT,
+    K_LCTRL as K_LCTRL,
+    K_LEFT as K_LEFT,
+    K_LEFTBRACKET as K_LEFTBRACKET,
+    K_LEFTPAREN as K_LEFTPAREN,
+    K_LESS as K_LESS,
+    K_LGUI as K_LGUI,
+    K_LMETA as K_LMETA,
+    K_LSHIFT as K_LSHIFT,
+    K_LSUPER as K_LSUPER,
+    K_MENU as K_MENU,
+    K_MINUS as K_MINUS,
+    K_MODE as K_MODE,
+    K_NUMLOCK as K_NUMLOCK,
+    K_NUMLOCKCLEAR as K_NUMLOCKCLEAR,
+    K_PAGEDOWN as K_PAGEDOWN,
+    K_PAGEUP as K_PAGEUP,
+    K_PAUSE as K_PAUSE,
+    K_PERCENT as K_PERCENT,
+    K_PERIOD as K_PERIOD,
+    K_PLUS as K_PLUS,
+    K_POWER as K_POWER,
+    K_PRINT as K_PRINT,
+    K_PRINTSCREEN as K_PRINTSCREEN,
+    K_QUESTION as K_QUESTION,
+    K_QUOTE as K_QUOTE,
+    K_QUOTEDBL as K_QUOTEDBL,
+    K_RALT as K_RALT,
+    K_RCTRL as K_RCTRL,
+    K_RETURN as K_RETURN,
+    K_RGUI as K_RGUI,
+    K_RIGHT as K_RIGHT,
+    K_RIGHTBRACKET as K_RIGHTBRACKET,
+    K_RIGHTPAREN as K_RIGHTPAREN,
+    K_RMETA as K_RMETA,
+    K_RSHIFT as K_RSHIFT,
+    K_RSUPER as K_RSUPER,
+    K_SCROLLLOCK as K_SCROLLLOCK,
+    K_SCROLLOCK as K_SCROLLOCK,
+    K_SEMICOLON as K_SEMICOLON,
+    K_SLASH as K_SLASH,
+    K_SPACE as K_SPACE,
+    K_SYSREQ as K_SYSREQ,
+    K_TAB as K_TAB,
+    K_UNDERSCORE as K_UNDERSCORE,
+    K_UNKNOWN as K_UNKNOWN,
+    K_UP as K_UP,
+    K_a as K_a,
+    K_b as K_b,
+    K_c as K_c,
+    K_d as K_d,
+    K_e as K_e,
+    K_f as K_f,
+    K_g as K_g,
+    K_h as K_h,
+    K_i as K_i,
+    K_j as K_j,
+    K_k as K_k,
+    K_l as K_l,
+    K_m as K_m,
+    K_n as K_n,
+    K_o as K_o,
+    K_p as K_p,
+    K_q as K_q,
+    K_r as K_r,
+    K_s as K_s,
+    K_t as K_t,
+    K_u as K_u,
+    K_v as K_v,
+    K_w as K_w,
+    K_x as K_x,
+    K_y as K_y,
+    K_z as K_z,
+    LIL_ENDIAN as LIL_ENDIAN,
+    LOCALECHANGED as LOCALECHANGED,
+    MIDIIN as MIDIIN,
+    MIDIOUT as MIDIOUT,
+    MOUSEBUTTONDOWN as MOUSEBUTTONDOWN,
+    MOUSEBUTTONUP as MOUSEBUTTONUP,
+    MOUSEMOTION as MOUSEMOTION,
+    MOUSEWHEEL as MOUSEWHEEL,
+    MULTIGESTURE as MULTIGESTURE,
+    NOEVENT as NOEVENT,
+    NOFRAME as NOFRAME,
+    NUMEVENTS as NUMEVENTS,
+    OPENGL as OPENGL,
+    OPENGLBLIT as OPENGLBLIT,
+    PREALLOC as PREALLOC,
+    QUIT as QUIT,
+    RENDER_DEVICE_RESET as RENDER_DEVICE_RESET,
+    RENDER_TARGETS_RESET as RENDER_TARGETS_RESET,
+    RESIZABLE as RESIZABLE,
+    RLEACCEL as RLEACCEL,
+    RLEACCELOK as RLEACCELOK,
+    SCALED as SCALED,
+    SCRAP_BMP as SCRAP_BMP,
+    SCRAP_CLIPBOARD as SCRAP_CLIPBOARD,
+    SCRAP_PBM as SCRAP_PBM,
+    SCRAP_PPM as SCRAP_PPM,
+    SCRAP_SELECTION as SCRAP_SELECTION,
+    SCRAP_TEXT as SCRAP_TEXT,
+    SHOWN as SHOWN,
+    SRCALPHA as SRCALPHA,
+    SRCCOLORKEY as SRCCOLORKEY,
+    SWSURFACE as SWSURFACE,
+    SYSTEM_CURSOR_ARROW as SYSTEM_CURSOR_ARROW,
+    SYSTEM_CURSOR_CROSSHAIR as SYSTEM_CURSOR_CROSSHAIR,
+    SYSTEM_CURSOR_HAND as SYSTEM_CURSOR_HAND,
+    SYSTEM_CURSOR_IBEAM as SYSTEM_CURSOR_IBEAM,
+    SYSTEM_CURSOR_NO as SYSTEM_CURSOR_NO,
+    SYSTEM_CURSOR_SIZEALL as SYSTEM_CURSOR_SIZEALL,
+    SYSTEM_CURSOR_SIZENESW as SYSTEM_CURSOR_SIZENESW,
+    SYSTEM_CURSOR_SIZENS as SYSTEM_CURSOR_SIZENS,
+    SYSTEM_CURSOR_SIZENWSE as SYSTEM_CURSOR_SIZENWSE,
+    SYSTEM_CURSOR_SIZEWE as SYSTEM_CURSOR_SIZEWE,
+    SYSTEM_CURSOR_WAIT as SYSTEM_CURSOR_WAIT,
+    SYSTEM_CURSOR_WAITARROW as SYSTEM_CURSOR_WAITARROW,
+    SYSWMEVENT as SYSWMEVENT,
+    TEXTEDITING as TEXTEDITING,
+    TEXTINPUT as TEXTINPUT,
+    TIMER_RESOLUTION as TIMER_RESOLUTION,
+    USEREVENT as USEREVENT,
+    USEREVENT_DROPFILE as USEREVENT_DROPFILE,
+    VIDEOEXPOSE as VIDEOEXPOSE,
+    VIDEORESIZE as VIDEORESIZE,
+    WINDOWCLOSE as WINDOWCLOSE,
+    WINDOWDISPLAYCHANGED as WINDOWDISPLAYCHANGED,
+    WINDOWENTER as WINDOWENTER,
+    WINDOWEXPOSED as WINDOWEXPOSED,
+    WINDOWFOCUSGAINED as WINDOWFOCUSGAINED,
+    WINDOWFOCUSLOST as WINDOWFOCUSLOST,
+    WINDOWHIDDEN as WINDOWHIDDEN,
+    WINDOWHITTEST as WINDOWHITTEST,
+    WINDOWICCPROFCHANGED as WINDOWICCPROFCHANGED,
+    WINDOWLEAVE as WINDOWLEAVE,
+    WINDOWMAXIMIZED as WINDOWMAXIMIZED,
+    WINDOWMINIMIZED as WINDOWMINIMIZED,
+    WINDOWMOVED as WINDOWMOVED,
+    WINDOWRESIZED as WINDOWRESIZED,
+    WINDOWRESTORED as WINDOWRESTORED,
+    WINDOWSHOWN as WINDOWSHOWN,
+    WINDOWSIZECHANGED as WINDOWSIZECHANGED,
+    WINDOWTAKEFOCUS as WINDOWTAKEFOCUS,
+)
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/__pycache__/__init__.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/__pycache__/__init__.cpython-312.pyc
new file mode 100644
index 0000000..5d41583
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/__pycache__/__init__.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/__pycache__/_camera_opencv.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/__pycache__/_camera_opencv.cpython-312.pyc
new file mode 100644
index 0000000..bb871d3
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/__pycache__/_camera_opencv.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/__pycache__/_camera_vidcapture.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/__pycache__/_camera_vidcapture.cpython-312.pyc
new file mode 100644
index 0000000..7733710
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/__pycache__/_camera_vidcapture.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/__pycache__/camera.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/__pycache__/camera.cpython-312.pyc
new file mode 100644
index 0000000..6904164
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/__pycache__/camera.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/__pycache__/colordict.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/__pycache__/colordict.cpython-312.pyc
new file mode 100644
index 0000000..e734004
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/__pycache__/colordict.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/__pycache__/cursors.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/__pycache__/cursors.cpython-312.pyc
new file mode 100644
index 0000000..2ec390b
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/__pycache__/cursors.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/__pycache__/draw_py.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/__pycache__/draw_py.cpython-312.pyc
new file mode 100644
index 0000000..2fc6401
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/__pycache__/draw_py.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/__pycache__/fastevent.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/__pycache__/fastevent.cpython-312.pyc
new file mode 100644
index 0000000..aa51ae1
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/__pycache__/fastevent.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/__pycache__/freetype.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/__pycache__/freetype.cpython-312.pyc
new file mode 100644
index 0000000..4b3d51b
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/__pycache__/freetype.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/__pycache__/ftfont.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/__pycache__/ftfont.cpython-312.pyc
new file mode 100644
index 0000000..567d3b0
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/__pycache__/ftfont.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/__pycache__/locals.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/__pycache__/locals.cpython-312.pyc
new file mode 100644
index 0000000..981940c
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/__pycache__/locals.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/__pycache__/macosx.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/__pycache__/macosx.cpython-312.pyc
new file mode 100644
index 0000000..c1581be
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/__pycache__/macosx.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/__pycache__/midi.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/__pycache__/midi.cpython-312.pyc
new file mode 100644
index 0000000..82bc1e6
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/__pycache__/midi.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/__pycache__/pkgdata.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/__pycache__/pkgdata.cpython-312.pyc
new file mode 100644
index 0000000..adf4fff
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/__pycache__/pkgdata.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/__pycache__/sndarray.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/__pycache__/sndarray.cpython-312.pyc
new file mode 100644
index 0000000..1e61c3c
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/__pycache__/sndarray.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/__pycache__/sprite.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/__pycache__/sprite.cpython-312.pyc
new file mode 100644
index 0000000..bbff004
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/__pycache__/sprite.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/__pycache__/surfarray.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/__pycache__/surfarray.cpython-312.pyc
new file mode 100644
index 0000000..4b2b2f1
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/__pycache__/surfarray.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/__pycache__/sysfont.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/__pycache__/sysfont.cpython-312.pyc
new file mode 100644
index 0000000..b5e5cf2
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/__pycache__/sysfont.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/__pycache__/version.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/__pycache__/version.cpython-312.pyc
new file mode 100644
index 0000000..2de77f3
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/__pycache__/version.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/__pyinstaller/__init__.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/__pyinstaller/__init__.py
new file mode 100644
index 0000000..1c52aad
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/__pyinstaller/__init__.py
@@ -0,0 +1,5 @@
+import os
+
+
+def get_hook_dirs():
+    return [os.path.dirname(__file__)]
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/__pyinstaller/__pycache__/__init__.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/__pyinstaller/__pycache__/__init__.cpython-312.pyc
new file mode 100644
index 0000000..6552e14
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/__pyinstaller/__pycache__/__init__.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/__pyinstaller/__pycache__/hook-pygame.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/__pyinstaller/__pycache__/hook-pygame.cpython-312.pyc
new file mode 100644
index 0000000..8d95be5
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/__pyinstaller/__pycache__/hook-pygame.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/__pyinstaller/hook-pygame.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/__pyinstaller/hook-pygame.py
new file mode 100644
index 0000000..01477b6
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/__pyinstaller/hook-pygame.py
@@ -0,0 +1,45 @@
+"""
+binaries hook for pygame seems to be required for pygame 2.0 Windows.
+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
+"""
+
+import os
+import platform
+
+from pygame import __file__ as pygame_main_file
+
+# Get pygame's folder
+pygame_folder = os.path.dirname(os.path.abspath(pygame_main_file))
+
+# datas is the variable that pyinstaller looks for while processing hooks
+datas = []
+
+
+# A helper to append the relative path of a resource to hook variable - datas
+def _append_to_datas(file_path):
+    res_path = os.path.join(pygame_folder, file_path)
+    if os.path.exists(res_path):
+        datas.append((res_path, "pygame"))
+
+
+# First append the font file, then based on the OS, append pygame icon file
+_append_to_datas("freesansbold.ttf")
+if platform.system() == "Darwin":
+    _append_to_datas("pygame_icon_mac.bmp")
+else:
+    _append_to_datas("pygame_icon.bmp")
+
+if platform.system() == "Windows":
+    from PyInstaller.utils.hooks import collect_dynamic_libs
+
+    pre_binaries = collect_dynamic_libs("pygame")
+    binaries = []
+
+    for b in pre_binaries:
+        binary, location = b
+        # settles all the DLLs into the top level folder, which prevents duplication
+        # with the DLLs already being put there.
+        binaries.append((binary, "."))
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/_camera.cpython-312-darwin.so b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/_camera.cpython-312-darwin.so
new file mode 100755
index 0000000..e168859
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/_camera.cpython-312-darwin.so differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/_camera_opencv.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/_camera_opencv.py
new file mode 100644
index 0000000..289bf7e
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/_camera_opencv.py
@@ -0,0 +1,210 @@
+"""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 numpy
+import cv2
+
+import pygame
+
+
+def list_cameras():
+    """ """
+    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():
+    import subprocess
+    from xml.etree import ElementTree
+
+    # pylint: disable=consider-using-with
+    flout, _ = subprocess.Popen(
+        "system_profiler -xml SPCameraDataType",
+        shell=True,
+        stdout=subprocess.PIPE,
+        stderr=subprocess.PIPE,
+    ).communicate()
+
+    last_text = None
+    cameras = []
+
+    for node in ElementTree.fromstring(flout).iterfind("./array/dict/array/dict/*"):
+        if last_text == "_name":
+            cameras.append(node.text)
+        last_text = node.text
+
+    return cameras
+
+
+class Camera:
+    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":
+            self._fmt = cv2.COLOR_BGR2YUV
+        elif mode == "HSV":
+            self._fmt = cv2.COLOR_BGR2HSV
+        else:
+            raise ValueError("Not a supported mode")
+
+        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
+    # actual start() method
+    def start(self):
+        if self._open:
+            return
+
+        self._cam = cv2.VideoCapture(self._device_index, self.api_preference)
+
+        if not self._cam.isOpened():
+            raise ValueError("Could not open camera.")
+
+        self._cam.set(cv2.CAP_PROP_FRAME_WIDTH, self._size[0])
+        self._cam.set(cv2.CAP_PROP_FRAME_HEIGHT, self._size[1])
+
+        w = self._cam.get(cv2.CAP_PROP_FRAME_WIDTH)
+        h = self._cam.get(cv2.CAP_PROP_FRAME_HEIGHT)
+        self._size = (int(w), int(h))
+
+        self._flipx = False
+        self._flipy = False
+        self._brightness = 1
+
+        self._frametime = 1 / self._cam.get(cv2.CAP_PROP_FPS)
+        self._last_frame_time = 0
+
+        self._open = True
+
+    def stop(self):
+        if self._open:
+            self._cam.release()
+            self._cam = None
+            self._open = False
+
+    def _check_open(self):
+        if not self._open:
+            raise pygame.error("Camera must be started")
+
+    def get_size(self):
+        self._check_open()
+
+        return self._size
+
+    def set_controls(self, hflip=None, vflip=None, brightness=None):
+        self._check_open()
+
+        if hflip is not None:
+            self._flipx = bool(hflip)
+        if vflip is not None:
+            self._flipy = bool(vflip)
+        if brightness is not None:
+            self._cam.set(cv2.CAP_PROP_BRIGHTNESS, brightness)
+
+        return self.get_controls()
+
+    def get_controls(self):
+        self._check_open()
+
+        return (self._flipx, self._flipy, self._cam.get(cv2.CAP_PROP_BRIGHTNESS))
+
+    def query_image(self):
+        self._check_open()
+
+        current_time = time.time()
+        if current_time - self._last_frame_time > self._frametime:
+            return True
+        return False
+
+    def get_image(self, dest_surf=None):
+        self._check_open()
+
+        self._last_frame_time = time.time()
+
+        _, image = self._cam.read()
+
+        image = cv2.cvtColor(image, self._fmt)
+
+        flip_code = None
+        if self._flipx:
+            if self._flipy:
+                flip_code = -1
+            else:
+                flip_code = 1
+        elif self._flipy:
+            flip_code = 0
+
+        if flip_code is not None:
+            image = cv2.flip(image, flip_code)
+
+        image = numpy.fliplr(image)
+        image = numpy.rot90(image)
+
+        surf = pygame.surfarray.make_surface(image)
+
+        if dest_surf:
+            dest_surf.blit(surf, (0, 0))
+            return dest_surf
+
+        return surf
+
+    def get_raw(self):
+        self._check_open()
+
+        self._last_frame_time = time.time()
+
+        _, image = self._cam.read()
+
+        return image.tobytes()
+
+
+class CameraMac(Camera):
+    def __init__(self, device=0, size=(640, 480), mode="RGB", api_preference=None):
+        if isinstance(device, int):
+            _dev = device
+        elif isinstance(device, str):
+            _dev = list_cameras_darwin().index(device)
+        else:
+            raise TypeError(
+                "OpenCV-Mac backend can take device indices or names, ints or strings, not ",
+                str(type(device)),
+            )
+
+        super().__init__(_dev, size, mode, api_preference)
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/_camera_vidcapture.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/_camera_vidcapture.py
new file mode 100644
index 0000000..c61d6d4
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/_camera_vidcapture.py
@@ -0,0 +1,118 @@
+"""pygame.camera.Camera implementation using the videocapture module for windows.
+
+http://videocapture.sourceforge.net/
+
+Binary windows wheels:
+  https://www.lfd.uci.edu/~gohlke/pythonlibs/#videocapture
+"""
+
+import pygame
+
+
+def list_cameras():
+    """Always only lists one camera.
+
+    Functionality not supported in videocapture module.
+    """
+    return [0]
+
+    # this just cycles through all the cameras trying to open them
+    # cameras = []
+    # for x in range(256):
+    #    try:
+    #        c = Camera(x)
+    #    except:
+    #        break
+    #    cameras.append(x)
+    # return cameras
+
+
+def init():
+    global vidcap
+    try:
+        import vidcap as vc
+    except ImportError:
+        from VideoCapture import vidcap as vc
+    vidcap = vc
+
+
+def quit():
+    global vidcap
+    vidcap = None
+
+
+class Camera:
+    # pylint: disable=unused-argument
+    def __init__(self, device=0, size=(640, 480), mode="RGB", show_video_window=0):
+        """device:  VideoCapture enumerates the available video capture devices
+                 on your system.  If you have more than one device, specify
+                 the desired one here.  The device number starts from 0.
+
+        show_video_window: 0 ... do not display a video window (the default)
+                           1 ... display a video window
+
+                         Mainly used for debugging, since the video window
+                         can not be closed or moved around.
+        """
+        self.dev = vidcap.new_Dev(device, show_video_window)
+        width, height = size
+        self.dev.setresolution(width, height)
+
+    def display_capture_filter_properties(self):
+        """Displays a dialog containing the property page of the capture filter.
+
+        For VfW drivers you may find the option to select the resolution most
+        likely here.
+        """
+        self.dev.displaycapturefilterproperties()
+
+    def display_capture_pin_properties(self):
+        """Displays a dialog containing the property page of the capture pin.
+
+        For WDM drivers you may find the option to select the resolution most
+        likely here.
+        """
+        self.dev.displaycapturepinproperties()
+
+    def set_resolution(self, width, height):
+        """Sets the capture resolution. (without dialog)"""
+        self.dev.setresolution(width, height)
+
+    def get_buffer(self):
+        """Returns a string containing the raw pixel data."""
+        return self.dev.getbuffer()
+
+    def start(self):
+        """Not implemented."""
+
+    def set_controls(self, **kwargs):
+        """Not implemented."""
+
+    def stop(self):
+        """Not implemented."""
+
+    def get_image(self, dest_surf=None):
+        """ """
+        return self.get_surface(dest_surf)
+
+    def get_surface(self, dest_surf=None):
+        """Returns a pygame Surface."""
+        abuffer, width, height = self.get_buffer()
+        if not abuffer:
+            return None
+        surf = pygame.image.frombuffer(abuffer, (width, height), "BGR")
+        surf = pygame.transform.flip(surf, 0, 1)
+        # if there is a destination surface given, we blit onto that.
+        if dest_surf:
+            dest_surf.blit(surf, (0, 0))
+        else:
+            dest_surf = surf
+        return dest_surf
+
+
+if __name__ == "__main__":
+    import pygame.examples.camera
+
+    pygame.camera.Camera = Camera
+    pygame.camera.list_cameras = list_cameras
+    pygame.examples.camera.main()
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/_common.pyi b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/_common.pyi
new file mode 100644
index 0000000..bd13960
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/_common.pyi
@@ -0,0 +1,40 @@
+from os import PathLike
+from typing import IO, Callable, Sequence, Tuple, Union
+
+from typing_extensions import Literal as Literal
+from typing_extensions import Protocol
+
+from pygame.color import Color
+from pygame.math import Vector2
+from pygame.rect import Rect
+
+# For functions that take a file name
+AnyPath = Union[str, bytes, PathLike[str], PathLike[bytes]]
+
+# Most pygame functions that take a file argument should be able to handle
+# a FileArg type
+FileArg = Union[AnyPath, IO[bytes], IO[str]]
+
+Coordinate = Union[Tuple[float, float], Sequence[float], Vector2]
+
+# This typehint is used when a function would return an RGBA tuble
+RGBAOutput = Tuple[int, int, int, int]
+ColorValue = Union[Color, int, str, Tuple[int, int, int], RGBAOutput, Sequence[int]]
+from typing import Union
+
+def my_function(my_var: Union[int, float, complex]) -> None:
+    print(my_var)
+_CanBeRect = Union[
+    Rect,
+    Tuple[Union[float, int], Union[float, int], Union[float, int], Union[float, int]],
+    Tuple[Coordinate, Coordinate],
+    Sequence[Union[float, int]],
+    Sequence[Coordinate],
+]
+
+class _HasRectAttribute(Protocol):
+    # An object that has a rect attribute that is either a rect, or a function
+    # that returns a rect confirms to the rect protocol
+    rect: Union[RectValue, Callable[[], RectValue]]
+
+RectValue = Union[_CanBeRect, _HasRectAttribute]
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/_freetype.cpython-312-darwin.so b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/_freetype.cpython-312-darwin.so
new file mode 100755
index 0000000..2d88658
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/_freetype.cpython-312-darwin.so differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/_sdl2/__init__.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/_sdl2/__init__.py
new file mode 100644
index 0000000..b08b716
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/_sdl2/__init__.py
@@ -0,0 +1,3 @@
+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/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/_sdl2/__init__.pyi b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/_sdl2/__init__.pyi
new file mode 100644
index 0000000..8f929c7
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/_sdl2/__init__.pyi
@@ -0,0 +1,3 @@
+from pygame._sdl2.audio import *
+from pygame._sdl2.sdl2 import *
+from pygame._sdl2.video import *
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/_sdl2/__pycache__/__init__.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/_sdl2/__pycache__/__init__.cpython-312.pyc
new file mode 100644
index 0000000..1498e61
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/_sdl2/__pycache__/__init__.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/_sdl2/audio.cpython-312-darwin.so b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/_sdl2/audio.cpython-312-darwin.so
new file mode 100755
index 0000000..3342d75
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/_sdl2/audio.cpython-312-darwin.so differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/_sdl2/audio.pyi b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/_sdl2/audio.pyi
new file mode 100644
index 0000000..332f645
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/_sdl2/audio.pyi
@@ -0,0 +1,54 @@
+from typing import Callable, List
+
+AUDIO_U8: int
+AUDIO_S8: int
+AUDIO_U16LSB: int
+AUDIO_S16LSB: int
+AUDIO_U16MSB: int
+AUDIO_S16MSB: int
+AUDIO_U16: int
+AUDIO_S16: int
+AUDIO_S32LSB: int
+AUDIO_S32MSB: int
+AUDIO_S32: int
+AUDIO_F32LSB: int
+AUDIO_F32MSB: int
+AUDIO_F32: int
+
+AUDIO_ALLOW_FREQUENCY_CHANGE: int
+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]: ...
+
+class AudioDevice:
+    def __init__(
+        self,
+        devicename: str,
+        iscapture: bool,
+        frequency: int,
+        audioformat: int,
+        numchannels: int,
+        chunksize: int,
+        allowed_changes: int,
+        callback: Callable[[AudioDevice, memoryview], None],
+    ) -> None: ...
+    @property
+    def iscapture(self) -> bool: ...
+    @property
+    def deviceid(self) -> int: ...
+    @property
+    def devicename(self) -> str: ...
+    @property
+    def callback(self) -> Callable[[AudioDevice, memoryview], None]: ...
+    @property
+    def frequency(self) -> int: ...
+    @property
+    def audioformat(self) -> int: ...
+    @property
+    def numchannels(self) -> int: ...
+    @property
+    def chunksize(self) -> int: ...
+    def pause(self, pause_on: int) -> None: ...
+    def close(self) -> None: ...
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/_sdl2/controller.cpython-312-darwin.so b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/_sdl2/controller.cpython-312-darwin.so
new file mode 100755
index 0000000..c78b78e
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/_sdl2/controller.cpython-312-darwin.so differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/_sdl2/controller.pyi b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/_sdl2/controller.pyi
new file mode 100644
index 0000000..3810fbb
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/_sdl2/controller.pyi
@@ -0,0 +1,35 @@
+from typing import Dict, Mapping, Optional
+
+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) -> Optional[str]: ...
+
+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/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/_sdl2/mixer.cpython-312-darwin.so b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/_sdl2/mixer.cpython-312-darwin.so
new file mode 100755
index 0000000..444b40f
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/_sdl2/mixer.cpython-312-darwin.so differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/_sdl2/sdl2.cpython-312-darwin.so b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/_sdl2/sdl2.cpython-312-darwin.so
new file mode 100755
index 0000000..059339d
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/_sdl2/sdl2.cpython-312-darwin.so differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/_sdl2/sdl2.pyi b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/_sdl2/sdl2.pyi
new file mode 100644
index 0000000..8a2b622
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/_sdl2/sdl2.pyi
@@ -0,0 +1,16 @@
+from typing import Optional
+
+INIT_TIMER: int
+INIT_AUDIO: int
+INIT_VIDEO: int
+INIT_JOYSTICK: int
+INIT_HAPTIC: int
+INIT_GAMECONTROLLER: int
+INIT_EVENTS: int
+INIT_NOPARACHUTE: int
+INIT_EVERYTHING: int
+
+class error(RuntimeError):
+    def __init__(self, message: Optional[str] = None) -> None: ...
+
+def init_subsystem(flags: int) -> None: ...
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/_sdl2/touch.cpython-312-darwin.so b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/_sdl2/touch.cpython-312-darwin.so
new file mode 100755
index 0000000..a1634d0
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/_sdl2/touch.cpython-312-darwin.so differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/_sdl2/touch.pyi b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/_sdl2/touch.pyi
new file mode 100644
index 0000000..93e2745
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/_sdl2/touch.pyi
@@ -0,0 +1,6 @@
+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) -> Dict[str, Union[int, float]]: ...
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/_sdl2/video.cpython-312-darwin.so b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/_sdl2/video.cpython-312-darwin.so
new file mode 100755
index 0000000..cfceb70
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/_sdl2/video.cpython-312-darwin.so differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/_sdl2/video.pyi b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/_sdl2/video.pyi
new file mode 100644
index 0000000..a2d4afe
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/_sdl2/video.pyi
@@ -0,0 +1,159 @@
+from typing import Any, Generator, Iterable, Optional, Tuple, Union
+
+from pygame.rect import Rect
+from pygame.surface import Surface
+
+from .._common import RectValue, Literal, ColorValue
+
+WINDOWPOS_UNDEFINED: int
+WINDOWPOS_CENTERED: int
+
+MESSAGEBOX_ERROR: int
+MESSAGEBOX_WARNING: int
+MESSAGEBOX_INFORMATION: int
+
+class RendererDriverInfo:
+    name: str
+    flags: int
+    num_texture_formats: int
+    max_texture_width: int
+    max_texture_height: int
+
+def get_drivers() -> Generator[RendererDriverInfo, None, 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],
+        static: bool = False,
+        streaming: bool = False,
+        target: bool = False,
+    ) -> None: ...
+    @staticmethod
+    def from_surface(renderer: Renderer, surface: Surface) -> Texture: ...
+    renderer: Renderer
+    width: int
+    height: int
+    alpha: int
+    blend_mode: int
+    color: ColorValue
+    def get_rect(self, **kwargs: Any) -> Rect: ...
+    def draw(
+        self,
+        srcrect: Optional[RectValue] = None,
+        dstrect: Optional[RectValue] = None,
+        angle: float = 0.0,
+        origin: Optional[Iterable[int]] = None,
+        flip_x: bool = False,
+        flip_y: bool = False,
+    ) -> None: ...
+    def update(self, surface: Surface, area: Optional[RectValue] = None) -> None: ...
+
+class Image:
+    def __init__(
+        self,
+        textureOrImage: Union[Texture, Image],
+        srcrect: Optional[RectValue] = None,
+    ) -> None: ...
+    def get_rect(self, **kwargs: Any) -> Rect: ...
+    def draw(
+        self, srcrect: Optional[RectValue] = None, dstrect: Optional[RectValue] = None
+    ) -> None: ...
+    angle: float
+    origin: Optional[Iterable[float]]
+    flip_x: bool
+    flip_y: bool
+    color: ColorValue
+    alpha: float
+    blend_mode: int
+    texture: Texture
+    srcrect: Rect
+
+class Renderer:
+    def __init__(
+        self,
+        window: Window,
+        index: int = -1,
+        accelerated: int = -1,
+        vsync: bool = False,
+        target_texture: bool = False,
+    ) -> None: ...
+    @classmethod
+    def from_window(cls, window: Window) -> Renderer: ...
+    draw_blend_mode: int
+    draw_color: ColorValue
+    def clear(self) -> None: ...
+    def present(self) -> None: ...
+    def get_viewport(self) -> Rect: ...
+    def set_viewport(self, area: Optional[RectValue]) -> None: ...
+    logical_size: Iterable[int]
+    scale: Iterable[float]
+    target: Optional[Texture]
+    def blit(
+        self,
+        source: Union[Texture, Image],
+        dest: Optional[RectValue] = None,
+        area: Optional[RectValue] = None,
+        special_flags: int = 0,
+    ) -> Rect: ...
+    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: 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]
+    ) -> int: ...
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/_sprite.cpython-312-darwin.so b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/_sprite.cpython-312-darwin.so
new file mode 100755
index 0000000..9e780be
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/_sprite.cpython-312-darwin.so differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/base.cpython-312-darwin.so b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/base.cpython-312-darwin.so
new file mode 100755
index 0000000..c1d3631
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/base.cpython-312-darwin.so differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/base.pyi b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/base.pyi
new file mode 100644
index 0000000..c641e36
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/base.pyi
@@ -0,0 +1,19 @@
+from typing import Any, Tuple, Callable
+
+class error(RuntimeError): ...
+class BufferError(Exception): ...
+
+# Always defined
+HAVE_NEWBUF: int = 1
+
+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 get_sdl_byteorder() -> int: ...
+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: ...
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/bufferproxy.cpython-312-darwin.so b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/bufferproxy.cpython-312-darwin.so
new file mode 100755
index 0000000..9bac6e2
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/bufferproxy.cpython-312-darwin.so differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/bufferproxy.pyi b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/bufferproxy.pyi
new file mode 100644
index 0000000..b77eb46
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/bufferproxy.pyi
@@ -0,0 +1,15 @@
+from typing import Any, Dict, overload
+
+class BufferProxy:
+    parent: Any
+    length: int
+    raw: bytes
+    # possibly going to be deprecated/removed soon, in which case these
+    # typestubs must be removed too
+    __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/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/camera.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/camera.py
new file mode 100644
index 0000000..5f31c97
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/camera.py
@@ -0,0 +1,219 @@
+import os
+import platform
+import sys
+import warnings
+from abc import ABC, abstractmethod
+
+from pygame import error
+
+_is_init = False
+
+
+class AbstractCamera(ABC):
+    # set_controls and get_controls are not a part of the AbstractCamera ABC,
+    # because implementations of the same can vary across different Camera
+    # types
+    @abstractmethod
+    def __init__(self, *args, **kwargs):
+        """ """
+
+    @abstractmethod
+    def start(self):
+        """ """
+
+    @abstractmethod
+    def stop(self):
+        """ """
+
+    @abstractmethod
+    def get_size(self):
+        """ """
+
+    @abstractmethod
+    def query_image(self):
+        """ """
+
+    @abstractmethod
+    def get_image(self, dest_surf=None):
+        """ """
+
+    @abstractmethod
+    def get_raw(self):
+        """ """
+
+
+def _pre_init_placeholder():
+    if not _is_init:
+        raise error("pygame.camera is not initialized")
+
+    # camera was init, and yet functions are not monkey patched. This should
+    # not happen
+    raise NotImplementedError()
+
+
+def _pre_init_placeholder_varargs(*_, **__):
+    _pre_init_placeholder()
+
+
+class _PreInitPlaceholderCamera(AbstractCamera):
+    __init__ = _pre_init_placeholder_varargs
+    start = _pre_init_placeholder_varargs
+    stop = _pre_init_placeholder_varargs
+    get_controls = _pre_init_placeholder_varargs
+    set_controls = _pre_init_placeholder_varargs
+    get_size = _pre_init_placeholder_varargs
+    query_image = _pre_init_placeholder_varargs
+    get_image = _pre_init_placeholder_varargs
+    get_raw = _pre_init_placeholder_varargs
+
+
+list_cameras = _pre_init_placeholder
+Camera = _PreInitPlaceholderCamera
+
+
+def _colorspace_not_available(*args):
+    raise RuntimeError("pygame is not built with colorspace support")
+
+
+try:
+    from pygame import _camera
+
+    colorspace = _camera.colorspace
+except ImportError:
+    # Should not happen in most cases
+    colorspace = _colorspace_not_available
+
+
+def _setup_backend(backend):
+    global list_cameras, Camera
+    if backend == "opencv-mac":
+        from pygame import _camera_opencv
+
+        list_cameras = _camera_opencv.list_cameras_darwin
+        Camera = _camera_opencv.CameraMac
+
+    elif backend == "opencv":
+        from pygame import _camera_opencv
+
+        list_cameras = _camera_opencv.list_cameras
+        Camera = _camera_opencv.Camera
+
+    elif backend in ("_camera (msmf)", "_camera (v4l2)"):
+        from pygame import _camera
+
+        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")
+
+
+def get_backends():
+    possible_backends = []
+
+    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 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")
+
+    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()
+    if camera_env == "opencv":  # prioritize opencv
+        if "OpenCV" in possible_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
+
+
+def init(backend=None):
+    global _is_init
+    # select the camera module to import here.
+
+    backends = [b.lower() for b in get_backends()]
+    if not backends:
+        raise error("No camera backends are supported on your platform!")
+
+    backend = backends[0] if backend is None else backend.lower()
+    if backend not in backends:
+        warnings.warn(
+            "We don't think this is a supported backend on this system, "
+            "but we'll try it...",
+            Warning,
+            stacklevel=2,
+        )
+
+    try:
+        _setup_backend(backend)
+    except ImportError:
+        emsg = f"Backend '{backend}' is not supported on your platform!"
+        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"
+            )
+
+        raise error(emsg)
+
+    _is_init = True
+
+
+def quit():
+    global _is_init, Camera, list_cameras
+    # reset to their respective pre-init placeholders
+    list_cameras = _pre_init_placeholder
+    Camera = _PreInitPlaceholderCamera
+
+    _is_init = False
+
+
+if __name__ == "__main__":
+    # try and use this camera stuff with the pygame camera example.
+    import pygame.examples.camera
+
+    # pygame.camera.Camera = Camera
+    # pygame.camera.list_cameras = list_cameras
+    pygame.examples.camera.main()
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/camera.pyi b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/camera.pyi
new file mode 100644
index 0000000..eb0360c
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/camera.pyi
@@ -0,0 +1,49 @@
+from abc import ABC, abstractmethod
+from typing import List, Optional, Sequence, Tuple, Union
+
+from pygame.surface import Surface
+
+def get_backends() -> List[str]: ...
+def init(backend: Optional[str] = None) -> None: ...
+def quit() -> None: ...
+def list_cameras() -> List[str]: ...
+
+class AbstractCamera(ABC):
+    @abstractmethod
+    def __init__(self, *args, **kwargs) -> None: ...
+    @abstractmethod
+    def start(self) -> None: ...
+    @abstractmethod
+    def stop(self) -> None: ...
+    @abstractmethod
+    def get_size(self) -> Tuple[int, int]: ...
+    @abstractmethod
+    def query_image(self) -> bool: ...
+    @abstractmethod
+    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,
+    # because implementations of the same can vary across different Camera
+    # types
+
+class Camera(AbstractCamera):
+    def __init__(
+        self,
+        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 set_controls(
+        self,
+        hflip: bool = ...,
+        vflip: bool = ...,
+        brightness: int = ...,
+    ) -> Tuple[bool, bool, int]: ...
+    def get_size(self) -> Tuple[int, int]: ...
+    def query_image(self) -> bool: ...
+    def get_image(self, surface: Optional[Surface] = None) -> Surface: ...
+    def get_raw(self) -> bytes: ...
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/color.cpython-312-darwin.so b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/color.cpython-312-darwin.so
new file mode 100755
index 0000000..b55c0db
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/color.cpython-312-darwin.so differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/color.pyi b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/color.pyi
new file mode 100644
index 0000000..93ed688
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/color.pyi
@@ -0,0 +1,56 @@
+import sys
+from typing import Any, Dict, Iterator, Tuple, overload
+
+from ._common import ColorValue
+
+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]):
+    r: int
+    g: int
+    b: int
+    a: 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: ColorValue) -> None: ...
+    @overload
+    def __getitem__(self, i: int) -> int: ...
+    @overload
+    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: ...
+    def __sub__(self, other: Color) -> Color: ...
+    def __mul__(self, other: Color) -> Color: ...
+    def __floordiv__(self, other: Color) -> Color: ...
+    def __mod__(self, other: Color) -> Color: ...
+    def __int__(self) -> int: ...
+    def __float__(self) -> float: ...
+    def __len__(self) -> int: ...
+    def __index__(self) -> int: ...
+    def __invert__(self) -> Color: ...
+    def __contains__(self, other: int) -> bool: ...  # type: ignore[override]
+    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
+    def update(self, r: int, g: int, b: int, a: int = 255) -> None: ...
+    @overload
+    def update(self, rgbvalue: ColorValue) -> None: ...
+    def grayscale(self) -> Color: ...
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/colordict.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/colordict.py
new file mode 100644
index 0000000..0bd7256
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/colordict.py
@@ -0,0 +1,692 @@
+#    pygame - Python Game Library
+#    Copyright (C) 2000-2003  Pete Shinners
+#
+#    This library is free software; you can redistribute it and/or
+#    modify it under the terms of the GNU Library General Public
+#    License as published by the Free Software Foundation; either
+#    version 2 of the License, or (at your option) any later version.
+#
+#    This library is distributed in the hope that it will be useful,
+#    but WITHOUT ANY WARRANTY; without even the implied warranty of
+#    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+#    Library General Public License for more details.
+#
+#    You should have received a copy of the GNU Library General Public
+#    License along with this library; if not, write to the Free
+#    Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
+#
+#    Pete Shinners
+#    pete@shinners.org
+
+""" A dictionary of RGBA tuples indexed by color names.
+
+See https://www.pygame.org/docs/ref/color_list.html for sample swatches.
+"""
+
+THECOLORS = {
+    "aliceblue": (240, 248, 255, 255),
+    "antiquewhite": (250, 235, 215, 255),
+    "antiquewhite1": (255, 239, 219, 255),
+    "antiquewhite2": (238, 223, 204, 255),
+    "antiquewhite3": (205, 192, 176, 255),
+    "antiquewhite4": (139, 131, 120, 255),
+    "aqua": (0, 255, 255, 255),
+    "aquamarine": (127, 255, 212, 255),
+    "aquamarine1": (127, 255, 212, 255),
+    "aquamarine2": (118, 238, 198, 255),
+    "aquamarine3": (102, 205, 170, 255),
+    "aquamarine4": (69, 139, 116, 255),
+    "azure": (240, 255, 255, 255),
+    "azure1": (240, 255, 255, 255),
+    "azure3": (193, 205, 205, 255),
+    "azure2": (224, 238, 238, 255),
+    "azure4": (131, 139, 139, 255),
+    "beige": (245, 245, 220, 255),
+    "bisque": (255, 228, 196, 255),
+    "bisque1": (255, 228, 196, 255),
+    "bisque2": (238, 213, 183, 255),
+    "bisque3": (205, 183, 158, 255),
+    "bisque4": (139, 125, 107, 255),
+    "black": (0, 0, 0, 255),
+    "blanchedalmond": (255, 235, 205, 255),
+    "blue": (0, 0, 255, 255),
+    "blue1": (0, 0, 255, 255),
+    "blue2": (0, 0, 238, 255),
+    "blue3": (0, 0, 205, 255),
+    "blue4": (0, 0, 139, 255),
+    "blueviolet": (138, 43, 226, 255),
+    "brown": (165, 42, 42, 255),
+    "brown1": (255, 64, 64, 255),
+    "brown2": (238, 59, 59, 255),
+    "brown3": (205, 51, 51, 255),
+    "brown4": (139, 35, 35, 255),
+    "burlywood": (222, 184, 135, 255),
+    "burlywood1": (255, 211, 155, 255),
+    "burlywood2": (238, 197, 145, 255),
+    "burlywood3": (205, 170, 125, 255),
+    "burlywood4": (139, 115, 85, 255),
+    "cadetblue": (95, 158, 160, 255),
+    "cadetblue1": (152, 245, 255, 255),
+    "cadetblue2": (142, 229, 238, 255),
+    "cadetblue3": (122, 197, 205, 255),
+    "cadetblue4": (83, 134, 139, 255),
+    "chartreuse": (127, 255, 0, 255),
+    "chartreuse1": (127, 255, 0, 255),
+    "chartreuse2": (118, 238, 0, 255),
+    "chartreuse3": (102, 205, 0, 255),
+    "chartreuse4": (69, 139, 0, 255),
+    "chocolate": (210, 105, 30, 255),
+    "chocolate1": (255, 127, 36, 255),
+    "chocolate2": (238, 118, 33, 255),
+    "chocolate3": (205, 102, 29, 255),
+    "chocolate4": (139, 69, 19, 255),
+    "coral": (255, 127, 80, 255),
+    "coral1": (255, 114, 86, 255),
+    "coral2": (238, 106, 80, 255),
+    "coral3": (205, 91, 69, 255),
+    "coral4": (139, 62, 47, 255),
+    "cornflowerblue": (100, 149, 237, 255),
+    "cornsilk": (255, 248, 220, 255),
+    "cornsilk1": (255, 248, 220, 255),
+    "cornsilk2": (238, 232, 205, 255),
+    "cornsilk3": (205, 200, 177, 255),
+    "cornsilk4": (139, 136, 120, 255),
+    "crimson": (220, 20, 60, 255),
+    "cyan": (0, 255, 255, 255),
+    "cyan1": (0, 255, 255, 255),
+    "cyan2": (0, 238, 238, 255),
+    "cyan3": (0, 205, 205, 255),
+    "cyan4": (0, 139, 139, 255),
+    "darkblue": (0, 0, 139, 255),
+    "darkcyan": (0, 139, 139, 255),
+    "darkgoldenrod": (184, 134, 11, 255),
+    "darkgoldenrod1": (255, 185, 15, 255),
+    "darkgoldenrod2": (238, 173, 14, 255),
+    "darkgoldenrod3": (205, 149, 12, 255),
+    "darkgoldenrod4": (139, 101, 8, 255),
+    "darkgray": (169, 169, 169, 255),
+    "darkgreen": (0, 100, 0, 255),
+    "darkgrey": (169, 169, 169, 255),
+    "darkkhaki": (189, 183, 107, 255),
+    "darkmagenta": (139, 0, 139, 255),
+    "darkolivegreen": (85, 107, 47, 255),
+    "darkolivegreen1": (202, 255, 112, 255),
+    "darkolivegreen2": (188, 238, 104, 255),
+    "darkolivegreen3": (162, 205, 90, 255),
+    "darkolivegreen4": (110, 139, 61, 255),
+    "darkorange": (255, 140, 0, 255),
+    "darkorange1": (255, 127, 0, 255),
+    "darkorange2": (238, 118, 0, 255),
+    "darkorange3": (205, 102, 0, 255),
+    "darkorange4": (139, 69, 0, 255),
+    "darkorchid": (153, 50, 204, 255),
+    "darkorchid1": (191, 62, 255, 255),
+    "darkorchid2": (178, 58, 238, 255),
+    "darkorchid3": (154, 50, 205, 255),
+    "darkorchid4": (104, 34, 139, 255),
+    "darkred": (139, 0, 0, 255),
+    "darksalmon": (233, 150, 122, 255),
+    "darkseagreen": (143, 188, 143, 255),
+    "darkseagreen1": (193, 255, 193, 255),
+    "darkseagreen2": (180, 238, 180, 255),
+    "darkseagreen3": (155, 205, 155, 255),
+    "darkseagreen4": (105, 139, 105, 255),
+    "darkslateblue": (72, 61, 139, 255),
+    "darkslategray": (47, 79, 79, 255),
+    "darkslategray1": (151, 255, 255, 255),
+    "darkslategray2": (141, 238, 238, 255),
+    "darkslategray3": (121, 205, 205, 255),
+    "darkslategray4": (82, 139, 139, 255),
+    "darkslategrey": (47, 79, 79, 255),
+    "darkturquoise": (0, 206, 209, 255),
+    "darkviolet": (148, 0, 211, 255),
+    "deeppink": (255, 20, 147, 255),
+    "deeppink1": (255, 20, 147, 255),
+    "deeppink2": (238, 18, 137, 255),
+    "deeppink3": (205, 16, 118, 255),
+    "deeppink4": (139, 10, 80, 255),
+    "deepskyblue": (0, 191, 255, 255),
+    "deepskyblue1": (0, 191, 255, 255),
+    "deepskyblue2": (0, 178, 238, 255),
+    "deepskyblue3": (0, 154, 205, 255),
+    "deepskyblue4": (0, 104, 139, 255),
+    "dimgray": (105, 105, 105, 255),
+    "dimgrey": (105, 105, 105, 255),
+    "dodgerblue": (30, 144, 255, 255),
+    "dodgerblue1": (30, 144, 255, 255),
+    "dodgerblue2": (28, 134, 238, 255),
+    "dodgerblue3": (24, 116, 205, 255),
+    "dodgerblue4": (16, 78, 139, 255),
+    "firebrick": (178, 34, 34, 255),
+    "firebrick1": (255, 48, 48, 255),
+    "firebrick2": (238, 44, 44, 255),
+    "firebrick3": (205, 38, 38, 255),
+    "firebrick4": (139, 26, 26, 255),
+    "floralwhite": (255, 250, 240, 255),
+    "forestgreen": (34, 139, 34, 255),
+    "fuchsia": (255, 0, 255, 255),
+    "gainsboro": (220, 220, 220, 255),
+    "ghostwhite": (248, 248, 255, 255),
+    "gold": (255, 215, 0, 255),
+    "gold1": (255, 215, 0, 255),
+    "gold2": (238, 201, 0, 255),
+    "gold3": (205, 173, 0, 255),
+    "gold4": (139, 117, 0, 255),
+    "goldenrod": (218, 165, 32, 255),
+    "goldenrod1": (255, 193, 37, 255),
+    "goldenrod2": (238, 180, 34, 255),
+    "goldenrod3": (205, 155, 29, 255),
+    "goldenrod4": (139, 105, 20, 255),
+    "gray": (190, 190, 190, 255),
+    "gray0": (0, 0, 0, 255),
+    "gray1": (3, 3, 3, 255),
+    "gray2": (5, 5, 5, 255),
+    "gray3": (8, 8, 8, 255),
+    "gray4": (10, 10, 10, 255),
+    "gray5": (13, 13, 13, 255),
+    "gray6": (15, 15, 15, 255),
+    "gray7": (18, 18, 18, 255),
+    "gray8": (20, 20, 20, 255),
+    "gray9": (23, 23, 23, 255),
+    "gray10": (26, 26, 26, 255),
+    "gray11": (28, 28, 28, 255),
+    "gray12": (31, 31, 31, 255),
+    "gray13": (33, 33, 33, 255),
+    "gray14": (36, 36, 36, 255),
+    "gray15": (38, 38, 38, 255),
+    "gray16": (41, 41, 41, 255),
+    "gray17": (43, 43, 43, 255),
+    "gray18": (46, 46, 46, 255),
+    "gray19": (48, 48, 48, 255),
+    "gray20": (51, 51, 51, 255),
+    "gray21": (54, 54, 54, 255),
+    "gray22": (56, 56, 56, 255),
+    "gray23": (59, 59, 59, 255),
+    "gray24": (61, 61, 61, 255),
+    "gray25": (64, 64, 64, 255),
+    "gray26": (66, 66, 66, 255),
+    "gray27": (69, 69, 69, 255),
+    "gray28": (71, 71, 71, 255),
+    "gray29": (74, 74, 74, 255),
+    "gray30": (77, 77, 77, 255),
+    "gray31": (79, 79, 79, 255),
+    "gray32": (82, 82, 82, 255),
+    "gray33": (84, 84, 84, 255),
+    "gray34": (87, 87, 87, 255),
+    "gray35": (89, 89, 89, 255),
+    "gray36": (92, 92, 92, 255),
+    "gray37": (94, 94, 94, 255),
+    "gray38": (97, 97, 97, 255),
+    "gray39": (99, 99, 99, 255),
+    "gray40": (102, 102, 102, 255),
+    "gray41": (105, 105, 105, 255),
+    "gray42": (107, 107, 107, 255),
+    "gray43": (110, 110, 110, 255),
+    "gray44": (112, 112, 112, 255),
+    "gray45": (115, 115, 115, 255),
+    "gray46": (117, 117, 117, 255),
+    "gray47": (120, 120, 120, 255),
+    "gray48": (122, 122, 122, 255),
+    "gray49": (125, 125, 125, 255),
+    "gray50": (127, 127, 127, 255),
+    "gray51": (130, 130, 130, 255),
+    "gray52": (133, 133, 133, 255),
+    "gray53": (135, 135, 135, 255),
+    "gray54": (138, 138, 138, 255),
+    "gray55": (140, 140, 140, 255),
+    "gray56": (143, 143, 143, 255),
+    "gray57": (145, 145, 145, 255),
+    "gray58": (148, 148, 148, 255),
+    "gray59": (150, 150, 150, 255),
+    "gray60": (153, 153, 153, 255),
+    "gray61": (156, 156, 156, 255),
+    "gray62": (158, 158, 158, 255),
+    "gray63": (161, 161, 161, 255),
+    "gray64": (163, 163, 163, 255),
+    "gray65": (166, 166, 166, 255),
+    "gray66": (168, 168, 168, 255),
+    "gray67": (171, 171, 171, 255),
+    "gray68": (173, 173, 173, 255),
+    "gray69": (176, 176, 176, 255),
+    "gray70": (179, 179, 179, 255),
+    "gray71": (181, 181, 181, 255),
+    "gray72": (184, 184, 184, 255),
+    "gray73": (186, 186, 186, 255),
+    "gray74": (189, 189, 189, 255),
+    "gray75": (191, 191, 191, 255),
+    "gray76": (194, 194, 194, 255),
+    "gray77": (196, 196, 196, 255),
+    "gray78": (199, 199, 199, 255),
+    "gray79": (201, 201, 201, 255),
+    "gray80": (204, 204, 204, 255),
+    "gray81": (207, 207, 207, 255),
+    "gray82": (209, 209, 209, 255),
+    "gray83": (212, 212, 212, 255),
+    "gray84": (214, 214, 214, 255),
+    "gray85": (217, 217, 217, 255),
+    "gray86": (219, 219, 219, 255),
+    "gray87": (222, 222, 222, 255),
+    "gray88": (224, 224, 224, 255),
+    "gray89": (227, 227, 227, 255),
+    "gray90": (229, 229, 229, 255),
+    "gray91": (232, 232, 232, 255),
+    "gray92": (235, 235, 235, 255),
+    "gray93": (237, 237, 237, 255),
+    "gray94": (240, 240, 240, 255),
+    "gray95": (242, 242, 242, 255),
+    "gray96": (245, 245, 245, 255),
+    "gray97": (247, 247, 247, 255),
+    "gray98": (250, 250, 250, 255),
+    "gray99": (252, 252, 252, 255),
+    "gray100": (255, 255, 255, 255),
+    "green": (0, 255, 0, 255),
+    "green1": (0, 255, 0, 255),
+    "green2": (0, 238, 0, 255),
+    "green3": (0, 205, 0, 255),
+    "green4": (0, 139, 0, 255),
+    "greenyellow": (173, 255, 47, 255),
+    "grey": (190, 190, 190, 255),
+    "grey0": (0, 0, 0, 255),
+    "grey1": (3, 3, 3, 255),
+    "grey2": (5, 5, 5, 255),
+    "grey3": (8, 8, 8, 255),
+    "grey4": (10, 10, 10, 255),
+    "grey5": (13, 13, 13, 255),
+    "grey6": (15, 15, 15, 255),
+    "grey7": (18, 18, 18, 255),
+    "grey8": (20, 20, 20, 255),
+    "grey9": (23, 23, 23, 255),
+    "grey10": (26, 26, 26, 255),
+    "grey11": (28, 28, 28, 255),
+    "grey12": (31, 31, 31, 255),
+    "grey13": (33, 33, 33, 255),
+    "grey14": (36, 36, 36, 255),
+    "grey15": (38, 38, 38, 255),
+    "grey16": (41, 41, 41, 255),
+    "grey17": (43, 43, 43, 255),
+    "grey18": (46, 46, 46, 255),
+    "grey19": (48, 48, 48, 255),
+    "grey20": (51, 51, 51, 255),
+    "grey21": (54, 54, 54, 255),
+    "grey22": (56, 56, 56, 255),
+    "grey23": (59, 59, 59, 255),
+    "grey24": (61, 61, 61, 255),
+    "grey25": (64, 64, 64, 255),
+    "grey26": (66, 66, 66, 255),
+    "grey27": (69, 69, 69, 255),
+    "grey28": (71, 71, 71, 255),
+    "grey29": (74, 74, 74, 255),
+    "grey30": (77, 77, 77, 255),
+    "grey31": (79, 79, 79, 255),
+    "grey32": (82, 82, 82, 255),
+    "grey33": (84, 84, 84, 255),
+    "grey34": (87, 87, 87, 255),
+    "grey35": (89, 89, 89, 255),
+    "grey36": (92, 92, 92, 255),
+    "grey37": (94, 94, 94, 255),
+    "grey38": (97, 97, 97, 255),
+    "grey39": (99, 99, 99, 255),
+    "grey40": (102, 102, 102, 255),
+    "grey41": (105, 105, 105, 255),
+    "grey42": (107, 107, 107, 255),
+    "grey43": (110, 110, 110, 255),
+    "grey44": (112, 112, 112, 255),
+    "grey45": (115, 115, 115, 255),
+    "grey46": (117, 117, 117, 255),
+    "grey47": (120, 120, 120, 255),
+    "grey48": (122, 122, 122, 255),
+    "grey49": (125, 125, 125, 255),
+    "grey50": (127, 127, 127, 255),
+    "grey51": (130, 130, 130, 255),
+    "grey52": (133, 133, 133, 255),
+    "grey53": (135, 135, 135, 255),
+    "grey54": (138, 138, 138, 255),
+    "grey55": (140, 140, 140, 255),
+    "grey56": (143, 143, 143, 255),
+    "grey57": (145, 145, 145, 255),
+    "grey58": (148, 148, 148, 255),
+    "grey59": (150, 150, 150, 255),
+    "grey60": (153, 153, 153, 255),
+    "grey61": (156, 156, 156, 255),
+    "grey62": (158, 158, 158, 255),
+    "grey63": (161, 161, 161, 255),
+    "grey64": (163, 163, 163, 255),
+    "grey65": (166, 166, 166, 255),
+    "grey66": (168, 168, 168, 255),
+    "grey67": (171, 171, 171, 255),
+    "grey68": (173, 173, 173, 255),
+    "grey69": (176, 176, 176, 255),
+    "grey70": (179, 179, 179, 255),
+    "grey71": (181, 181, 181, 255),
+    "grey72": (184, 184, 184, 255),
+    "grey73": (186, 186, 186, 255),
+    "grey74": (189, 189, 189, 255),
+    "grey75": (191, 191, 191, 255),
+    "grey76": (194, 194, 194, 255),
+    "grey77": (196, 196, 196, 255),
+    "grey78": (199, 199, 199, 255),
+    "grey79": (201, 201, 201, 255),
+    "grey80": (204, 204, 204, 255),
+    "grey81": (207, 207, 207, 255),
+    "grey82": (209, 209, 209, 255),
+    "grey83": (212, 212, 212, 255),
+    "grey84": (214, 214, 214, 255),
+    "grey85": (217, 217, 217, 255),
+    "grey86": (219, 219, 219, 255),
+    "grey87": (222, 222, 222, 255),
+    "grey88": (224, 224, 224, 255),
+    "grey89": (227, 227, 227, 255),
+    "grey90": (229, 229, 229, 255),
+    "grey91": (232, 232, 232, 255),
+    "grey92": (235, 235, 235, 255),
+    "grey93": (237, 237, 237, 255),
+    "grey94": (240, 240, 240, 255),
+    "grey95": (242, 242, 242, 255),
+    "grey96": (245, 245, 245, 255),
+    "grey97": (247, 247, 247, 255),
+    "grey98": (250, 250, 250, 255),
+    "grey99": (252, 252, 252, 255),
+    "grey100": (255, 255, 255, 255),
+    "honeydew": (240, 255, 240, 255),
+    "honeydew1": (240, 255, 240, 255),
+    "honeydew2": (224, 238, 224, 255),
+    "honeydew3": (193, 205, 193, 255),
+    "honeydew4": (131, 139, 131, 255),
+    "hotpink": (255, 105, 180, 255),
+    "hotpink1": (255, 110, 180, 255),
+    "hotpink2": (238, 106, 167, 255),
+    "hotpink3": (205, 96, 144, 255),
+    "hotpink4": (139, 58, 98, 255),
+    "indianred": (205, 92, 92, 255),
+    "indianred1": (255, 106, 106, 255),
+    "indianred2": (238, 99, 99, 255),
+    "indianred3": (205, 85, 85, 255),
+    "indianred4": (139, 58, 58, 255),
+    "indigo": (75, 0, 130, 255),
+    "ivory": (255, 255, 240, 255),
+    "ivory1": (255, 255, 240, 255),
+    "ivory2": (238, 238, 224, 255),
+    "ivory3": (205, 205, 193, 255),
+    "ivory4": (139, 139, 131, 255),
+    "khaki": (240, 230, 140, 255),
+    "khaki1": (255, 246, 143, 255),
+    "khaki2": (238, 230, 133, 255),
+    "khaki3": (205, 198, 115, 255),
+    "khaki4": (139, 134, 78, 255),
+    "lavender": (230, 230, 250, 255),
+    "lavenderblush": (255, 240, 245, 255),
+    "lavenderblush1": (255, 240, 245, 255),
+    "lavenderblush2": (238, 224, 229, 255),
+    "lavenderblush3": (205, 193, 197, 255),
+    "lavenderblush4": (139, 131, 134, 255),
+    "lawngreen": (124, 252, 0, 255),
+    "lemonchiffon": (255, 250, 205, 255),
+    "lemonchiffon1": (255, 250, 205, 255),
+    "lemonchiffon2": (238, 233, 191, 255),
+    "lemonchiffon3": (205, 201, 165, 255),
+    "lemonchiffon4": (139, 137, 112, 255),
+    "lightblue": (173, 216, 230, 255),
+    "lightblue1": (191, 239, 255, 255),
+    "lightblue2": (178, 223, 238, 255),
+    "lightblue3": (154, 192, 205, 255),
+    "lightblue4": (104, 131, 139, 255),
+    "lightcoral": (240, 128, 128, 255),
+    "lightcyan": (224, 255, 255, 255),
+    "lightcyan1": (224, 255, 255, 255),
+    "lightcyan2": (209, 238, 238, 255),
+    "lightcyan3": (180, 205, 205, 255),
+    "lightcyan4": (122, 139, 139, 255),
+    "lightgoldenrod": (238, 221, 130, 255),
+    "lightgoldenrod1": (255, 236, 139, 255),
+    "lightgoldenrod2": (238, 220, 130, 255),
+    "lightgoldenrod3": (205, 190, 112, 255),
+    "lightgoldenrod4": (139, 129, 76, 255),
+    "lightgoldenrodyellow": (250, 250, 210, 255),
+    "lightgray": (211, 211, 211, 255),
+    "lightgreen": (144, 238, 144, 255),
+    "lightgrey": (211, 211, 211, 255),
+    "lightpink": (255, 182, 193, 255),
+    "lightpink1": (255, 174, 185, 255),
+    "lightpink2": (238, 162, 173, 255),
+    "lightpink3": (205, 140, 149, 255),
+    "lightpink4": (139, 95, 101, 255),
+    "lightsalmon": (255, 160, 122, 255),
+    "lightsalmon1": (255, 160, 122, 255),
+    "lightsalmon2": (238, 149, 114, 255),
+    "lightsalmon3": (205, 129, 98, 255),
+    "lightsalmon4": (139, 87, 66, 255),
+    "lightseagreen": (32, 178, 170, 255),
+    "lightskyblue": (135, 206, 250, 255),
+    "lightskyblue1": (176, 226, 255, 255),
+    "lightskyblue2": (164, 211, 238, 255),
+    "lightskyblue3": (141, 182, 205, 255),
+    "lightskyblue4": (96, 123, 139, 255),
+    "lightslateblue": (132, 112, 255, 255),
+    "lightslategray": (119, 136, 153, 255),
+    "lightslategrey": (119, 136, 153, 255),
+    "lightsteelblue": (176, 196, 222, 255),
+    "lightsteelblue1": (202, 225, 255, 255),
+    "lightsteelblue2": (188, 210, 238, 255),
+    "lightsteelblue3": (162, 181, 205, 255),
+    "lightsteelblue4": (110, 123, 139, 255),
+    "lightyellow": (255, 255, 224, 255),
+    "lightyellow1": (255, 255, 224, 255),
+    "lightyellow2": (238, 238, 209, 255),
+    "lightyellow3": (205, 205, 180, 255),
+    "lightyellow4": (139, 139, 122, 255),
+    "linen": (250, 240, 230, 255),
+    "lime": (0, 255, 0, 255),
+    "limegreen": (50, 205, 50, 255),
+    "magenta": (255, 0, 255, 255),
+    "magenta1": (255, 0, 255, 255),
+    "magenta2": (238, 0, 238, 255),
+    "magenta3": (205, 0, 205, 255),
+    "magenta4": (139, 0, 139, 255),
+    "maroon": (176, 48, 96, 255),
+    "maroon1": (255, 52, 179, 255),
+    "maroon2": (238, 48, 167, 255),
+    "maroon3": (205, 41, 144, 255),
+    "maroon4": (139, 28, 98, 255),
+    "mediumaquamarine": (102, 205, 170, 255),
+    "mediumblue": (0, 0, 205, 255),
+    "mediumorchid": (186, 85, 211, 255),
+    "mediumorchid1": (224, 102, 255, 255),
+    "mediumorchid2": (209, 95, 238, 255),
+    "mediumorchid3": (180, 82, 205, 255),
+    "mediumorchid4": (122, 55, 139, 255),
+    "mediumpurple": (147, 112, 219, 255),
+    "mediumpurple1": (171, 130, 255, 255),
+    "mediumpurple2": (159, 121, 238, 255),
+    "mediumpurple3": (137, 104, 205, 255),
+    "mediumpurple4": (93, 71, 139, 255),
+    "mediumseagreen": (60, 179, 113, 255),
+    "mediumslateblue": (123, 104, 238, 255),
+    "mediumspringgreen": (0, 250, 154, 255),
+    "mediumturquoise": (72, 209, 204, 255),
+    "mediumvioletred": (199, 21, 133, 255),
+    "midnightblue": (25, 25, 112, 255),
+    "mintcream": (245, 255, 250, 255),
+    "mistyrose": (255, 228, 225, 255),
+    "mistyrose1": (255, 228, 225, 255),
+    "mistyrose2": (238, 213, 210, 255),
+    "mistyrose3": (205, 183, 181, 255),
+    "mistyrose4": (139, 125, 123, 255),
+    "moccasin": (255, 228, 181, 255),
+    "navajowhite": (255, 222, 173, 255),
+    "navajowhite1": (255, 222, 173, 255),
+    "navajowhite2": (238, 207, 161, 255),
+    "navajowhite3": (205, 179, 139, 255),
+    "navajowhite4": (139, 121, 94, 255),
+    "navy": (0, 0, 128, 255),
+    "navyblue": (0, 0, 128, 255),
+    "oldlace": (253, 245, 230, 255),
+    "olive": (128, 128, 0, 255),
+    "olivedrab": (107, 142, 35, 255),
+    "olivedrab1": (192, 255, 62, 255),
+    "olivedrab2": (179, 238, 58, 255),
+    "olivedrab3": (154, 205, 50, 255),
+    "olivedrab4": (105, 139, 34, 255),
+    "orange": (255, 165, 0, 255),
+    "orange1": (255, 165, 0, 255),
+    "orange2": (238, 154, 0, 255),
+    "orange3": (205, 133, 0, 255),
+    "orange4": (139, 90, 0, 255),
+    "orangered": (255, 69, 0, 255),
+    "orangered1": (255, 69, 0, 255),
+    "orangered2": (238, 64, 0, 255),
+    "orangered3": (205, 55, 0, 255),
+    "orangered4": (139, 37, 0, 255),
+    "orchid": (218, 112, 214, 255),
+    "orchid1": (255, 131, 250, 255),
+    "orchid2": (238, 122, 233, 255),
+    "orchid3": (205, 105, 201, 255),
+    "orchid4": (139, 71, 137, 255),
+    "palegreen": (152, 251, 152, 255),
+    "palegreen1": (154, 255, 154, 255),
+    "palegreen2": (144, 238, 144, 255),
+    "palegreen3": (124, 205, 124, 255),
+    "palegreen4": (84, 139, 84, 255),
+    "palegoldenrod": (238, 232, 170, 255),
+    "paleturquoise": (175, 238, 238, 255),
+    "paleturquoise1": (187, 255, 255, 255),
+    "paleturquoise2": (174, 238, 238, 255),
+    "paleturquoise3": (150, 205, 205, 255),
+    "paleturquoise4": (102, 139, 139, 255),
+    "palevioletred": (219, 112, 147, 255),
+    "palevioletred1": (255, 130, 171, 255),
+    "palevioletred2": (238, 121, 159, 255),
+    "palevioletred3": (205, 104, 137, 255),
+    "palevioletred4": (139, 71, 93, 255),
+    "papayawhip": (255, 239, 213, 255),
+    "peachpuff": (255, 218, 185, 255),
+    "peachpuff1": (255, 218, 185, 255),
+    "peachpuff2": (238, 203, 173, 255),
+    "peachpuff3": (205, 175, 149, 255),
+    "peachpuff4": (139, 119, 101, 255),
+    "peru": (205, 133, 63, 255),
+    "pink": (255, 192, 203, 255),
+    "pink1": (255, 181, 197, 255),
+    "pink2": (238, 169, 184, 255),
+    "pink3": (205, 145, 158, 255),
+    "pink4": (139, 99, 108, 255),
+    "plum": (221, 160, 221, 255),
+    "plum1": (255, 187, 255, 255),
+    "plum2": (238, 174, 238, 255),
+    "plum3": (205, 150, 205, 255),
+    "plum4": (139, 102, 139, 255),
+    "powderblue": (176, 224, 230, 255),
+    "purple": (160, 32, 240, 255),
+    "purple1": (155, 48, 255, 255),
+    "purple2": (145, 44, 238, 255),
+    "purple3": (125, 38, 205, 255),
+    "purple4": (85, 26, 139, 255),
+    "red": (255, 0, 0, 255),
+    "red1": (255, 0, 0, 255),
+    "red2": (238, 0, 0, 255),
+    "red3": (205, 0, 0, 255),
+    "red4": (139, 0, 0, 255),
+    "rosybrown": (188, 143, 143, 255),
+    "rosybrown1": (255, 193, 193, 255),
+    "rosybrown2": (238, 180, 180, 255),
+    "rosybrown3": (205, 155, 155, 255),
+    "rosybrown4": (139, 105, 105, 255),
+    "royalblue": (65, 105, 225, 255),
+    "royalblue1": (72, 118, 255, 255),
+    "royalblue2": (67, 110, 238, 255),
+    "royalblue3": (58, 95, 205, 255),
+    "royalblue4": (39, 64, 139, 255),
+    "salmon": (250, 128, 114, 255),
+    "salmon1": (255, 140, 105, 255),
+    "salmon2": (238, 130, 98, 255),
+    "salmon3": (205, 112, 84, 255),
+    "salmon4": (139, 76, 57, 255),
+    "saddlebrown": (139, 69, 19, 255),
+    "sandybrown": (244, 164, 96, 255),
+    "seagreen": (46, 139, 87, 255),
+    "seagreen1": (84, 255, 159, 255),
+    "seagreen2": (78, 238, 148, 255),
+    "seagreen3": (67, 205, 128, 255),
+    "seagreen4": (46, 139, 87, 255),
+    "seashell": (255, 245, 238, 255),
+    "seashell1": (255, 245, 238, 255),
+    "seashell2": (238, 229, 222, 255),
+    "seashell3": (205, 197, 191, 255),
+    "seashell4": (139, 134, 130, 255),
+    "sienna": (160, 82, 45, 255),
+    "sienna1": (255, 130, 71, 255),
+    "sienna2": (238, 121, 66, 255),
+    "sienna3": (205, 104, 57, 255),
+    "sienna4": (139, 71, 38, 255),
+    "silver": (192, 192, 192, 255),
+    "skyblue": (135, 206, 235, 255),
+    "skyblue1": (135, 206, 255, 255),
+    "skyblue2": (126, 192, 238, 255),
+    "skyblue3": (108, 166, 205, 255),
+    "skyblue4": (74, 112, 139, 255),
+    "slateblue": (106, 90, 205, 255),
+    "slateblue1": (131, 111, 255, 255),
+    "slateblue2": (122, 103, 238, 255),
+    "slateblue3": (105, 89, 205, 255),
+    "slateblue4": (71, 60, 139, 255),
+    "slategray": (112, 128, 144, 255),
+    "slategray1": (198, 226, 255, 255),
+    "slategray2": (185, 211, 238, 255),
+    "slategray3": (159, 182, 205, 255),
+    "slategray4": (108, 123, 139, 255),
+    "slategrey": (112, 128, 144, 255),
+    "snow": (255, 250, 250, 255),
+    "snow1": (255, 250, 250, 255),
+    "snow2": (238, 233, 233, 255),
+    "snow3": (205, 201, 201, 255),
+    "snow4": (139, 137, 137, 255),
+    "springgreen": (0, 255, 127, 255),
+    "springgreen1": (0, 255, 127, 255),
+    "springgreen2": (0, 238, 118, 255),
+    "springgreen3": (0, 205, 102, 255),
+    "springgreen4": (0, 139, 69, 255),
+    "steelblue": (70, 130, 180, 255),
+    "steelblue1": (99, 184, 255, 255),
+    "steelblue2": (92, 172, 238, 255),
+    "steelblue3": (79, 148, 205, 255),
+    "steelblue4": (54, 100, 139, 255),
+    "tan": (210, 180, 140, 255),
+    "tan1": (255, 165, 79, 255),
+    "tan2": (238, 154, 73, 255),
+    "tan3": (205, 133, 63, 255),
+    "tan4": (139, 90, 43, 255),
+    "teal": (0, 128, 128, 255),
+    "thistle": (216, 191, 216, 255),
+    "thistle1": (255, 225, 255, 255),
+    "thistle2": (238, 210, 238, 255),
+    "thistle3": (205, 181, 205, 255),
+    "thistle4": (139, 123, 139, 255),
+    "tomato": (255, 99, 71, 255),
+    "tomato1": (255, 99, 71, 255),
+    "tomato2": (238, 92, 66, 255),
+    "tomato3": (205, 79, 57, 255),
+    "tomato4": (139, 54, 38, 255),
+    "turquoise": (64, 224, 208, 255),
+    "turquoise1": (0, 245, 255, 255),
+    "turquoise2": (0, 229, 238, 255),
+    "turquoise3": (0, 197, 205, 255),
+    "turquoise4": (0, 134, 139, 255),
+    "violet": (238, 130, 238, 255),
+    "violetred": (208, 32, 144, 255),
+    "violetred1": (255, 62, 150, 255),
+    "violetred2": (238, 58, 140, 255),
+    "violetred3": (205, 50, 120, 255),
+    "violetred4": (139, 34, 82, 255),
+    "wheat": (245, 222, 179, 255),
+    "wheat1": (255, 231, 186, 255),
+    "wheat2": (238, 216, 174, 255),
+    "wheat3": (205, 186, 150, 255),
+    "wheat4": (139, 126, 102, 255),
+    "white": (255, 255, 255, 255),
+    "whitesmoke": (245, 245, 245, 255),
+    "yellow": (255, 255, 0, 255),
+    "yellow1": (255, 255, 0, 255),
+    "yellow2": (238, 238, 0, 255),
+    "yellow3": (205, 205, 0, 255),
+    "yellow4": (139, 139, 0, 255),
+    "yellowgreen": (154, 205, 50, 255),
+}
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/constants.cpython-312-darwin.so b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/constants.cpython-312-darwin.so
new file mode 100755
index 0000000..69aa8f9
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/constants.cpython-312-darwin.so differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/constants.pyi b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/constants.pyi
new file mode 100644
index 0000000..07b2d46
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/constants.pyi
@@ -0,0 +1,560 @@
+# 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!
+
+ACTIVEEVENT: int
+ANYFORMAT: int
+APPACTIVE: int
+APPINPUTFOCUS: int
+APPMOUSEFOCUS: int
+APP_DIDENTERBACKGROUND: int
+APP_DIDENTERFOREGROUND: int
+APP_LOWMEMORY: int
+APP_TERMINATING: int
+APP_WILLENTERBACKGROUND: int
+APP_WILLENTERFOREGROUND: int
+ASYNCBLIT: int
+AUDIODEVICEADDED: int
+AUDIODEVICEREMOVED: int
+AUDIO_ALLOW_ANY_CHANGE: int
+AUDIO_ALLOW_CHANNELS_CHANGE: int
+AUDIO_ALLOW_FORMAT_CHANGE: int
+AUDIO_ALLOW_FREQUENCY_CHANGE: int
+AUDIO_S16: int
+AUDIO_S16LSB: int
+AUDIO_S16MSB: int
+AUDIO_S16SYS: int
+AUDIO_S8: int
+AUDIO_U16: int
+AUDIO_U16LSB: int
+AUDIO_U16MSB: int
+AUDIO_U16SYS: int
+AUDIO_U8: int
+BIG_ENDIAN: int
+BLENDMODE_ADD: int
+BLENDMODE_BLEND: int
+BLENDMODE_MOD: int
+BLENDMODE_NONE: int
+BLEND_ADD: int
+BLEND_ALPHA_SDL2: int
+BLEND_MAX: int
+BLEND_MIN: int
+BLEND_MULT: int
+BLEND_PREMULTIPLIED: int
+BLEND_RGBA_ADD: int
+BLEND_RGBA_MAX: int
+BLEND_RGBA_MIN: int
+BLEND_RGBA_MULT: int
+BLEND_RGBA_SUB: int
+BLEND_RGB_ADD: int
+BLEND_RGB_MAX: int
+BLEND_RGB_MIN: int
+BLEND_RGB_MULT: int
+BLEND_RGB_SUB: int
+BLEND_SUB: int
+BUTTON_LEFT: int
+BUTTON_MIDDLE: int
+BUTTON_RIGHT: int
+BUTTON_WHEELDOWN: int
+BUTTON_WHEELUP: int
+BUTTON_X1: int
+BUTTON_X2: int
+CLIPBOARDUPDATE: int
+CONTROLLERAXISMOTION: int
+CONTROLLERBUTTONDOWN: int
+CONTROLLERBUTTONUP: int
+CONTROLLERDEVICEADDED: int
+CONTROLLERDEVICEREMAPPED: int
+CONTROLLERDEVICEREMOVED: int
+CONTROLLERSENSORUPDATE: int
+CONTROLLERTOUCHPADDOWN: int
+CONTROLLERTOUCHPADMOTION: int
+CONTROLLERTOUCHPADUP: int
+CONTROLLER_AXIS_INVALID: int
+CONTROLLER_AXIS_LEFTX: int
+CONTROLLER_AXIS_LEFTY: int
+CONTROLLER_AXIS_MAX: int
+CONTROLLER_AXIS_RIGHTX: int
+CONTROLLER_AXIS_RIGHTY: int
+CONTROLLER_AXIS_TRIGGERLEFT: int
+CONTROLLER_AXIS_TRIGGERRIGHT: int
+CONTROLLER_BUTTON_A: int
+CONTROLLER_BUTTON_B: int
+CONTROLLER_BUTTON_BACK: int
+CONTROLLER_BUTTON_DPAD_DOWN: int
+CONTROLLER_BUTTON_DPAD_LEFT: int
+CONTROLLER_BUTTON_DPAD_RIGHT: int
+CONTROLLER_BUTTON_DPAD_UP: int
+CONTROLLER_BUTTON_GUIDE: int
+CONTROLLER_BUTTON_INVALID: int
+CONTROLLER_BUTTON_LEFTSHOULDER: int
+CONTROLLER_BUTTON_LEFTSTICK: int
+CONTROLLER_BUTTON_MAX: int
+CONTROLLER_BUTTON_RIGHTSHOULDER: int
+CONTROLLER_BUTTON_RIGHTSTICK: int
+CONTROLLER_BUTTON_START: int
+CONTROLLER_BUTTON_X: int
+CONTROLLER_BUTTON_Y: int
+DOUBLEBUF: int
+DROPBEGIN: int
+DROPCOMPLETE: int
+DROPFILE: int
+DROPTEXT: int
+FINGERDOWN: int
+FINGERMOTION: int
+FINGERUP: int
+FULLSCREEN: int
+GL_ACCELERATED_VISUAL: int
+GL_ACCUM_ALPHA_SIZE: int
+GL_ACCUM_BLUE_SIZE: int
+GL_ACCUM_GREEN_SIZE: int
+GL_ACCUM_RED_SIZE: int
+GL_ALPHA_SIZE: int
+GL_BLUE_SIZE: int
+GL_BUFFER_SIZE: int
+GL_CONTEXT_DEBUG_FLAG: int
+GL_CONTEXT_FLAGS: int
+GL_CONTEXT_FORWARD_COMPATIBLE_FLAG: int
+GL_CONTEXT_MAJOR_VERSION: int
+GL_CONTEXT_MINOR_VERSION: int
+GL_CONTEXT_PROFILE_COMPATIBILITY: int
+GL_CONTEXT_PROFILE_CORE: int
+GL_CONTEXT_PROFILE_ES: int
+GL_CONTEXT_PROFILE_MASK: int
+GL_CONTEXT_RELEASE_BEHAVIOR: int
+GL_CONTEXT_RELEASE_BEHAVIOR_FLUSH: int
+GL_CONTEXT_RELEASE_BEHAVIOR_NONE: int
+GL_CONTEXT_RESET_ISOLATION_FLAG: int
+GL_CONTEXT_ROBUST_ACCESS_FLAG: int
+GL_DEPTH_SIZE: int
+GL_DOUBLEBUFFER: int
+GL_FRAMEBUFFER_SRGB_CAPABLE: int
+GL_GREEN_SIZE: int
+GL_MULTISAMPLEBUFFERS: int
+GL_MULTISAMPLESAMPLES: int
+GL_RED_SIZE: int
+GL_SHARE_WITH_CURRENT_CONTEXT: int
+GL_STENCIL_SIZE: int
+GL_STEREO: int
+GL_SWAP_CONTROL: int
+HAT_CENTERED: int
+HAT_DOWN: int
+HAT_LEFT: int
+HAT_LEFTDOWN: int
+HAT_LEFTUP: int
+HAT_RIGHT: int
+HAT_RIGHTDOWN: int
+HAT_RIGHTUP: int
+HAT_UP: int
+HIDDEN: int
+HWACCEL: int
+HWPALETTE: int
+HWSURFACE: int
+JOYAXISMOTION: int
+JOYBALLMOTION: int
+JOYBUTTONDOWN: int
+JOYBUTTONUP: int
+JOYDEVICEADDED: int
+JOYDEVICEREMOVED: int
+JOYHATMOTION: int
+KEYDOWN: int
+KEYMAPCHANGED: int
+KEYUP: int
+KMOD_ALT: int
+KMOD_CAPS: int
+KMOD_CTRL: int
+KMOD_GUI: int
+KMOD_LALT: int
+KMOD_LCTRL: int
+KMOD_LGUI: int
+KMOD_LMETA: int
+KMOD_LSHIFT: int
+KMOD_META: int
+KMOD_MODE: int
+KMOD_NONE: int
+KMOD_NUM: int
+KMOD_RALT: int
+KMOD_RCTRL: int
+KMOD_RGUI: int
+KMOD_RMETA: int
+KMOD_RSHIFT: int
+KMOD_SHIFT: int
+KSCAN_0: int
+KSCAN_1: int
+KSCAN_2: int
+KSCAN_3: int
+KSCAN_4: int
+KSCAN_5: int
+KSCAN_6: int
+KSCAN_7: int
+KSCAN_8: int
+KSCAN_9: int
+KSCAN_A: int
+KSCAN_AC_BACK: int
+KSCAN_APOSTROPHE: int
+KSCAN_B: int
+KSCAN_BACKSLASH: int
+KSCAN_BACKSPACE: int
+KSCAN_BREAK: int
+KSCAN_C: int
+KSCAN_CAPSLOCK: int
+KSCAN_CLEAR: int
+KSCAN_COMMA: int
+KSCAN_CURRENCYSUBUNIT: int
+KSCAN_CURRENCYUNIT: int
+KSCAN_D: int
+KSCAN_DELETE: int
+KSCAN_DOWN: int
+KSCAN_E: int
+KSCAN_END: int
+KSCAN_EQUALS: int
+KSCAN_ESCAPE: int
+KSCAN_EURO: int
+KSCAN_F: int
+KSCAN_F1: int
+KSCAN_F10: int
+KSCAN_F11: int
+KSCAN_F12: int
+KSCAN_F13: int
+KSCAN_F14: int
+KSCAN_F15: int
+KSCAN_F2: int
+KSCAN_F3: int
+KSCAN_F4: int
+KSCAN_F5: int
+KSCAN_F6: int
+KSCAN_F7: int
+KSCAN_F8: int
+KSCAN_F9: int
+KSCAN_G: int
+KSCAN_GRAVE: int
+KSCAN_H: int
+KSCAN_HELP: int
+KSCAN_HOME: int
+KSCAN_I: int
+KSCAN_INSERT: int
+KSCAN_INTERNATIONAL1: int
+KSCAN_INTERNATIONAL2: int
+KSCAN_INTERNATIONAL3: int
+KSCAN_INTERNATIONAL4: int
+KSCAN_INTERNATIONAL5: int
+KSCAN_INTERNATIONAL6: int
+KSCAN_INTERNATIONAL7: int
+KSCAN_INTERNATIONAL8: int
+KSCAN_INTERNATIONAL9: int
+KSCAN_J: int
+KSCAN_K: int
+KSCAN_KP0: int
+KSCAN_KP1: int
+KSCAN_KP2: int
+KSCAN_KP3: int
+KSCAN_KP4: int
+KSCAN_KP5: int
+KSCAN_KP6: int
+KSCAN_KP7: int
+KSCAN_KP8: int
+KSCAN_KP9: int
+KSCAN_KP_0: int
+KSCAN_KP_1: int
+KSCAN_KP_2: int
+KSCAN_KP_3: int
+KSCAN_KP_4: int
+KSCAN_KP_5: int
+KSCAN_KP_6: int
+KSCAN_KP_7: int
+KSCAN_KP_8: int
+KSCAN_KP_9: int
+KSCAN_KP_DIVIDE: int
+KSCAN_KP_ENTER: int
+KSCAN_KP_EQUALS: int
+KSCAN_KP_MINUS: int
+KSCAN_KP_MULTIPLY: int
+KSCAN_KP_PERIOD: int
+KSCAN_KP_PLUS: int
+KSCAN_L: int
+KSCAN_LALT: int
+KSCAN_LANG1: int
+KSCAN_LANG2: int
+KSCAN_LANG3: int
+KSCAN_LANG4: int
+KSCAN_LANG5: int
+KSCAN_LANG6: int
+KSCAN_LANG7: int
+KSCAN_LANG8: int
+KSCAN_LANG9: int
+KSCAN_LCTRL: int
+KSCAN_LEFT: int
+KSCAN_LEFTBRACKET: int
+KSCAN_LGUI: int
+KSCAN_LMETA: int
+KSCAN_LSHIFT: int
+KSCAN_LSUPER: int
+KSCAN_M: int
+KSCAN_MENU: int
+KSCAN_MINUS: int
+KSCAN_MODE: int
+KSCAN_N: int
+KSCAN_NONUSBACKSLASH: int
+KSCAN_NONUSHASH: int
+KSCAN_NUMLOCK: int
+KSCAN_NUMLOCKCLEAR: int
+KSCAN_O: int
+KSCAN_P: int
+KSCAN_PAGEDOWN: int
+KSCAN_PAGEUP: int
+KSCAN_PAUSE: int
+KSCAN_PERIOD: int
+KSCAN_POWER: int
+KSCAN_PRINT: int
+KSCAN_PRINTSCREEN: int
+KSCAN_Q: int
+KSCAN_R: int
+KSCAN_RALT: int
+KSCAN_RCTRL: int
+KSCAN_RETURN: int
+KSCAN_RGUI: int
+KSCAN_RIGHT: int
+KSCAN_RIGHTBRACKET: int
+KSCAN_RMETA: int
+KSCAN_RSHIFT: int
+KSCAN_RSUPER: int
+KSCAN_S: int
+KSCAN_SCROLLLOCK: int
+KSCAN_SCROLLOCK: int
+KSCAN_SEMICOLON: int
+KSCAN_SLASH: int
+KSCAN_SPACE: int
+KSCAN_SYSREQ: int
+KSCAN_T: int
+KSCAN_TAB: int
+KSCAN_U: int
+KSCAN_UNKNOWN: int
+KSCAN_UP: int
+KSCAN_V: int
+KSCAN_W: int
+KSCAN_X: int
+KSCAN_Y: int
+KSCAN_Z: int
+K_0: int
+K_1: int
+K_2: int
+K_3: int
+K_4: int
+K_5: int
+K_6: int
+K_7: int
+K_8: int
+K_9: int
+K_AC_BACK: int
+K_AMPERSAND: int
+K_ASTERISK: int
+K_AT: int
+K_BACKQUOTE: int
+K_BACKSLASH: int
+K_BACKSPACE: int
+K_BREAK: int
+K_CAPSLOCK: int
+K_CARET: int
+K_CLEAR: int
+K_COLON: int
+K_COMMA: int
+K_CURRENCYSUBUNIT: int
+K_CURRENCYUNIT: int
+K_DELETE: int
+K_DOLLAR: int
+K_DOWN: int
+K_END: int
+K_EQUALS: int
+K_ESCAPE: int
+K_EURO: int
+K_EXCLAIM: int
+K_F1: int
+K_F10: int
+K_F11: int
+K_F12: int
+K_F13: int
+K_F14: int
+K_F15: int
+K_F2: int
+K_F3: int
+K_F4: int
+K_F5: int
+K_F6: int
+K_F7: int
+K_F8: int
+K_F9: int
+K_GREATER: int
+K_HASH: int
+K_HELP: int
+K_HOME: int
+K_INSERT: int
+K_KP0: int
+K_KP1: int
+K_KP2: int
+K_KP3: int
+K_KP4: int
+K_KP5: int
+K_KP6: int
+K_KP7: int
+K_KP8: int
+K_KP9: int
+K_KP_0: int
+K_KP_1: int
+K_KP_2: int
+K_KP_3: int
+K_KP_4: int
+K_KP_5: int
+K_KP_6: int
+K_KP_7: int
+K_KP_8: int
+K_KP_9: int
+K_KP_DIVIDE: int
+K_KP_ENTER: int
+K_KP_EQUALS: int
+K_KP_MINUS: int
+K_KP_MULTIPLY: int
+K_KP_PERIOD: int
+K_KP_PLUS: int
+K_LALT: int
+K_LCTRL: int
+K_LEFT: int
+K_LEFTBRACKET: int
+K_LEFTPAREN: int
+K_LESS: int
+K_LGUI: int
+K_LMETA: int
+K_LSHIFT: int
+K_LSUPER: int
+K_MENU: int
+K_MINUS: int
+K_MODE: int
+K_NUMLOCK: int
+K_NUMLOCKCLEAR: int
+K_PAGEDOWN: int
+K_PAGEUP: int
+K_PAUSE: int
+K_PERCENT: int
+K_PERIOD: int
+K_PLUS: int
+K_POWER: int
+K_PRINT: int
+K_PRINTSCREEN: int
+K_QUESTION: int
+K_QUOTE: int
+K_QUOTEDBL: int
+K_RALT: int
+K_RCTRL: int
+K_RETURN: int
+K_RGUI: int
+K_RIGHT: int
+K_RIGHTBRACKET: int
+K_RIGHTPAREN: int
+K_RMETA: int
+K_RSHIFT: int
+K_RSUPER: int
+K_SCROLLLOCK: int
+K_SCROLLOCK: int
+K_SEMICOLON: int
+K_SLASH: int
+K_SPACE: int
+K_SYSREQ: int
+K_TAB: int
+K_UNDERSCORE: int
+K_UNKNOWN: int
+K_UP: int
+K_a: int
+K_b: int
+K_c: int
+K_d: int
+K_e: int
+K_f: int
+K_g: int
+K_h: int
+K_i: int
+K_j: int
+K_k: int
+K_l: int
+K_m: int
+K_n: int
+K_o: int
+K_p: int
+K_q: int
+K_r: int
+K_s: int
+K_t: int
+K_u: int
+K_v: int
+K_w: int
+K_x: int
+K_y: int
+K_z: int
+LIL_ENDIAN: int
+LOCALECHANGED: int
+MIDIIN: int
+MIDIOUT: int
+MOUSEBUTTONDOWN: int
+MOUSEBUTTONUP: int
+MOUSEMOTION: int
+MOUSEWHEEL: int
+MULTIGESTURE: int
+NOEVENT: int
+NOFRAME: int
+NUMEVENTS: int
+OPENGL: int
+OPENGLBLIT: int
+PREALLOC: int
+QUIT: int
+RENDER_DEVICE_RESET: int
+RENDER_TARGETS_RESET: int
+RESIZABLE: int
+RLEACCEL: int
+RLEACCELOK: int
+SCALED: int
+SCRAP_BMP: str
+SCRAP_CLIPBOARD: int
+SCRAP_PBM: str
+SCRAP_PPM: str
+SCRAP_SELECTION: int
+SCRAP_TEXT: str
+SHOWN: int
+SRCALPHA: int
+SRCCOLORKEY: int
+SWSURFACE: int
+SYSTEM_CURSOR_ARROW: int
+SYSTEM_CURSOR_CROSSHAIR: int
+SYSTEM_CURSOR_HAND: int
+SYSTEM_CURSOR_IBEAM: int
+SYSTEM_CURSOR_NO: int
+SYSTEM_CURSOR_SIZEALL: int
+SYSTEM_CURSOR_SIZENESW: int
+SYSTEM_CURSOR_SIZENS: int
+SYSTEM_CURSOR_SIZENWSE: int
+SYSTEM_CURSOR_SIZEWE: int
+SYSTEM_CURSOR_WAIT: int
+SYSTEM_CURSOR_WAITARROW: int
+SYSWMEVENT: int
+TEXTEDITING: int
+TEXTINPUT: int
+TIMER_RESOLUTION: int
+USEREVENT: int
+USEREVENT_DROPFILE: int
+VIDEOEXPOSE: int
+VIDEORESIZE: int
+WINDOWCLOSE: int
+WINDOWDISPLAYCHANGED: int
+WINDOWENTER: int
+WINDOWEXPOSED: int
+WINDOWFOCUSGAINED: int
+WINDOWFOCUSLOST: int
+WINDOWHIDDEN: int
+WINDOWHITTEST: int
+WINDOWICCPROFCHANGED: int
+WINDOWLEAVE: int
+WINDOWMAXIMIZED: int
+WINDOWMINIMIZED: int
+WINDOWMOVED: int
+WINDOWRESIZED: int
+WINDOWRESTORED: int
+WINDOWSHOWN: int
+WINDOWSIZECHANGED: int
+WINDOWTAKEFOCUS: int
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/cursors.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/cursors.py
new file mode 100644
index 0000000..2c920be
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/cursors.py
@@ -0,0 +1,837 @@
+#    pygame - Python Game Library
+#    Copyright (C) 2000-2003  Pete Shinners
+#
+#    This library is free software; you can redistribute it and/or
+#    modify it under the terms of the GNU Library General Public
+#    License as published by the Free Software Foundation; either
+#    version 2 of the License, or (at your option) any later version.
+#
+#    This library is distributed in the hope that it will be useful,
+#    but WITHOUT ANY WARRANTY; without even the implied warranty of
+#    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+#    Library General Public License for more details.
+#
+#    You should have received a copy of the GNU Library General Public
+#    License along with this library; if not, write to the Free
+#    Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
+#
+#    Pete Shinners
+#    pete@shinners.org
+
+"""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).
+
+Here is a list of available cursors:
+    arrow, diamond, ball, broken_x, tri_left, tri_right
+
+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.
+
+Alternately, you can also create Cursor objects using surfaces or cursors constants,
+such as pygame.SYSTEM_CURSOR_ARROW.
+"""
+
+import pygame
+
+_cursor_id_table = {
+    pygame.SYSTEM_CURSOR_ARROW: "SYSTEM_CURSOR_ARROW",
+    pygame.SYSTEM_CURSOR_IBEAM: "SYSTEM_CURSOR_IBEAM",
+    pygame.SYSTEM_CURSOR_WAIT: "SYSTEM_CURSOR_WAIT",
+    pygame.SYSTEM_CURSOR_CROSSHAIR: "SYSTEM_CURSOR_CROSSHAIR",
+    pygame.SYSTEM_CURSOR_WAITARROW: "SYSTEM_CURSOR_WAITARROW",
+    pygame.SYSTEM_CURSOR_SIZENWSE: "SYSTEM_CURSOR_SIZENWSE",
+    pygame.SYSTEM_CURSOR_SIZENESW: "SYSTEM_CURSOR_SIZENESW",
+    pygame.SYSTEM_CURSOR_SIZEWE: "SYSTEM_CURSOR_SIZEWE",
+    pygame.SYSTEM_CURSOR_SIZENS: "SYSTEM_CURSOR_SIZENS",
+    pygame.SYSTEM_CURSOR_SIZEALL: "SYSTEM_CURSOR_SIZEALL",
+    pygame.SYSTEM_CURSOR_NO: "SYSTEM_CURSOR_NO",
+    pygame.SYSTEM_CURSOR_HAND: "SYSTEM_CURSOR_HAND",
+}
+
+
+class Cursor:
+    def __init__(self, *args):
+        """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
+
+        pygame object for representing cursors
+
+        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,)
+        elif len(args) == 1 and args[0] in _cursor_id_table:
+            self.type = "system"
+            self.data = (args[0],)
+        elif len(args) == 1 and isinstance(args[0], Cursor):
+            self.type = args[0].type
+            self.data = args[0].data
+        elif (
+            len(args) == 2 and len(args[0]) == 2 and isinstance(args[1], pygame.Surface)
+        ):
+            self.type = "color"
+            self.data = tuple(args)
+        elif len(args) == 4 and len(args[0]) == 2 and len(args[1]) == 2:
+            self.type = "bitmap"
+            # pylint: disable=consider-using-generator
+            # See https://github.com/pygame/pygame/pull/2509 for analysis
+            self.data = tuple(tuple(arg) for arg in args)
+        else:
+            raise TypeError("Arguments must match a cursor specification")
+
+    def __len__(self):
+        return len(self.data)
+
+    def __iter__(self):
+        return iter(self.data)
+
+    def __getitem__(self, index):
+        return self.data[index]
+
+    def __eq__(self, other):
+        return isinstance(other, Cursor) and self.data == other.data
+
+    def __ne__(self, other):
+        return not self.__eq__(other)
+
+    def __copy__(self):
+        """Clone the current Cursor object.
+        You can do the same thing by doing Cursor(Cursor)."""
+        return self.__class__(self)
+
+    copy = __copy__
+
+    def __hash__(self):
+        return hash(tuple([self.type] + list(self.data)))
+
+    def __repr__(self):
+        if self.type == "system":
+            id_string = _cursor_id_table.get(self.data[0], "constant lookup error")
+            return f""
+        if self.type == "bitmap":
+            size = f"size: {self.data[0]}"
+            hotspot = f"hotspot: {self.data[1]}"
+            return f""
+        if self.type == "color":
+            hotspot = f"hotspot: {self.data[0]}"
+            surf = repr(self.data[1])
+            return f""
+        raise TypeError("Invalid Cursor")
+
+
+# Python side of the set_cursor function: C side in mouse.c
+def set_cursor(*args):
+    """set_cursor(pygame.cursors.Cursor OR args for a pygame.cursors.Cursor) -> None
+    set the mouse cursor to a new cursor"""
+    cursor = Cursor(*args)
+    pygame.mouse._set_cursor(**{cursor.type: cursor.data})
+
+
+pygame.mouse.set_cursor = set_cursor
+del set_cursor  # cleanup namespace
+
+
+# Python side of the get_cursor function: C side in mouse.c
+def get_cursor():
+    """get_cursor() -> pygame.cursors.Cursor
+    get the current mouse cursor"""
+    return Cursor(*pygame.mouse._get_cursor())
+
+
+pygame.mouse.get_cursor = get_cursor
+del get_cursor  # cleanup namespace
+
+arrow = Cursor(
+    (16, 16),
+    (0, 0),
+    (
+        0x00,
+        0x00,
+        0x40,
+        0x00,
+        0x60,
+        0x00,
+        0x70,
+        0x00,
+        0x78,
+        0x00,
+        0x7C,
+        0x00,
+        0x7E,
+        0x00,
+        0x7F,
+        0x00,
+        0x7F,
+        0x80,
+        0x7C,
+        0x00,
+        0x6C,
+        0x00,
+        0x46,
+        0x00,
+        0x06,
+        0x00,
+        0x03,
+        0x00,
+        0x03,
+        0x00,
+        0x00,
+        0x00,
+    ),
+    (
+        0x40,
+        0x00,
+        0xE0,
+        0x00,
+        0xF0,
+        0x00,
+        0xF8,
+        0x00,
+        0xFC,
+        0x00,
+        0xFE,
+        0x00,
+        0xFF,
+        0x00,
+        0xFF,
+        0x80,
+        0xFF,
+        0xC0,
+        0xFF,
+        0x80,
+        0xFE,
+        0x00,
+        0xEF,
+        0x00,
+        0x4F,
+        0x00,
+        0x07,
+        0x80,
+        0x07,
+        0x80,
+        0x03,
+        0x00,
+    ),
+)
+
+diamond = Cursor(
+    (16, 16),
+    (7, 7),
+    (
+        0,
+        0,
+        1,
+        0,
+        3,
+        128,
+        7,
+        192,
+        14,
+        224,
+        28,
+        112,
+        56,
+        56,
+        112,
+        28,
+        56,
+        56,
+        28,
+        112,
+        14,
+        224,
+        7,
+        192,
+        3,
+        128,
+        1,
+        0,
+        0,
+        0,
+        0,
+        0,
+    ),
+    (
+        1,
+        0,
+        3,
+        128,
+        7,
+        192,
+        15,
+        224,
+        31,
+        240,
+        62,
+        248,
+        124,
+        124,
+        248,
+        62,
+        124,
+        124,
+        62,
+        248,
+        31,
+        240,
+        15,
+        224,
+        7,
+        192,
+        3,
+        128,
+        1,
+        0,
+        0,
+        0,
+    ),
+)
+
+ball = Cursor(
+    (16, 16),
+    (7, 7),
+    (
+        0,
+        0,
+        3,
+        192,
+        15,
+        240,
+        24,
+        248,
+        51,
+        252,
+        55,
+        252,
+        127,
+        254,
+        127,
+        254,
+        127,
+        254,
+        127,
+        254,
+        63,
+        252,
+        63,
+        252,
+        31,
+        248,
+        15,
+        240,
+        3,
+        192,
+        0,
+        0,
+    ),
+    (
+        3,
+        192,
+        15,
+        240,
+        31,
+        248,
+        63,
+        252,
+        127,
+        254,
+        127,
+        254,
+        255,
+        255,
+        255,
+        255,
+        255,
+        255,
+        255,
+        255,
+        127,
+        254,
+        127,
+        254,
+        63,
+        252,
+        31,
+        248,
+        15,
+        240,
+        3,
+        192,
+    ),
+)
+
+broken_x = Cursor(
+    (16, 16),
+    (7, 7),
+    (
+        0,
+        0,
+        96,
+        6,
+        112,
+        14,
+        56,
+        28,
+        28,
+        56,
+        12,
+        48,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        12,
+        48,
+        28,
+        56,
+        56,
+        28,
+        112,
+        14,
+        96,
+        6,
+        0,
+        0,
+    ),
+    (
+        224,
+        7,
+        240,
+        15,
+        248,
+        31,
+        124,
+        62,
+        62,
+        124,
+        30,
+        120,
+        14,
+        112,
+        0,
+        0,
+        0,
+        0,
+        14,
+        112,
+        30,
+        120,
+        62,
+        124,
+        124,
+        62,
+        248,
+        31,
+        240,
+        15,
+        224,
+        7,
+    ),
+)
+
+tri_left = Cursor(
+    (16, 16),
+    (1, 1),
+    (
+        0,
+        0,
+        96,
+        0,
+        120,
+        0,
+        62,
+        0,
+        63,
+        128,
+        31,
+        224,
+        31,
+        248,
+        15,
+        254,
+        15,
+        254,
+        7,
+        128,
+        7,
+        128,
+        3,
+        128,
+        3,
+        128,
+        1,
+        128,
+        1,
+        128,
+        0,
+        0,
+    ),
+    (
+        224,
+        0,
+        248,
+        0,
+        254,
+        0,
+        127,
+        128,
+        127,
+        224,
+        63,
+        248,
+        63,
+        254,
+        31,
+        255,
+        31,
+        255,
+        15,
+        254,
+        15,
+        192,
+        7,
+        192,
+        7,
+        192,
+        3,
+        192,
+        3,
+        192,
+        1,
+        128,
+    ),
+)
+
+tri_right = Cursor(
+    (16, 16),
+    (14, 1),
+    (
+        0,
+        0,
+        0,
+        6,
+        0,
+        30,
+        0,
+        124,
+        1,
+        252,
+        7,
+        248,
+        31,
+        248,
+        127,
+        240,
+        127,
+        240,
+        1,
+        224,
+        1,
+        224,
+        1,
+        192,
+        1,
+        192,
+        1,
+        128,
+        1,
+        128,
+        0,
+        0,
+    ),
+    (
+        0,
+        7,
+        0,
+        31,
+        0,
+        127,
+        1,
+        254,
+        7,
+        254,
+        31,
+        252,
+        127,
+        252,
+        255,
+        248,
+        255,
+        248,
+        127,
+        240,
+        3,
+        240,
+        3,
+        224,
+        3,
+        224,
+        3,
+        192,
+        3,
+        192,
+        1,
+        128,
+    ),
+)
+
+
+# Here is an example string resource cursor. To use this:
+#    curs, mask = pygame.cursors.compile_cursor(pygame.cursors.thickarrow_strings, 'X', '.')
+#    pygame.mouse.set_cursor((24, 24), (0, 0), curs, mask)
+# Be warned, though, that cursors created from compiled strings do not support colors.
+
+# sized 24x24
+thickarrow_strings = (
+    "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               ",
+    "                        ",
+    "                        ",
+    "                        ",
+)
+
+# sized 24x16
+sizer_x_strings = (
+    "     X      X           ",
+    "    XX      XX          ",
+    "   X.X      X.X         ",
+    "  X..X      X..X        ",
+    " X...XXXXXXXX...X       ",
+    "X................X      ",
+    " X...XXXXXXXX...X       ",
+    "  X..X      X..X        ",
+    "   X.X      X.X         ",
+    "    XX      XX          ",
+    "     X      X           ",
+    "                        ",
+    "                        ",
+    "                        ",
+    "                        ",
+    "                        ",
+)
+
+# sized 16x24
+sizer_y_strings = (
+    "     X          ",
+    "    X.X         ",
+    "   X...X        ",
+    "  X.....X       ",
+    " X.......X      ",
+    "XXXXX.XXXXX     ",
+    "    X.X         ",
+    "    X.X         ",
+    "    X.X         ",
+    "    X.X         ",
+    "    X.X         ",
+    "    X.X         ",
+    "    X.X         ",
+    "XXXXX.XXXXX     ",
+    " X.......X      ",
+    "  X.....X       ",
+    "   X...X        ",
+    "    X.X         ",
+    "     X          ",
+    "                ",
+    "                ",
+    "                ",
+    "                ",
+    "                ",
+)
+
+# sized 24x16
+sizer_xy_strings = (
+    "XXXXXXXX                ",
+    "X.....X                 ",
+    "X....X                  ",
+    "X...X                   ",
+    "X..X.X                  ",
+    "X.X X.X                 ",
+    "XX   X.X    X           ",
+    "X     X.X  XX           ",
+    "       X.XX.X           ",
+    "        X...X           ",
+    "        X...X           ",
+    "       X....X           ",
+    "      X.....X           ",
+    "     XXXXXXXX           ",
+    "                        ",
+    "                        ",
+)
+
+# sized 8x16
+textmarker_strings = (
+    "ooo ooo ",
+    "   o    ",
+    "   o    ",
+    "   o    ",
+    "   o    ",
+    "   o    ",
+    "   o    ",
+    "   o    ",
+    "   o    ",
+    "   o    ",
+    "   o    ",
+    "ooo ooo ",
+    "        ",
+    "        ",
+    "        ",
+    "        ",
+)
+
+
+def compile(strings, black="X", white=".", xor="o"):
+    """pygame.cursors.compile(strings, black, white, xor) -> data, mask
+    compile cursor strings into cursor data
+
+    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.
+
+    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.
+
+    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)
+    if size[0] % 8 or size[1] % 8:
+        raise ValueError(f"cursor string sizes must be divisible by 8 {size}")
+
+    for s in strings[1:]:
+        if len(s) != size[0]:
+            raise ValueError("Cursor strings are inconsistent lengths")
+
+    # create the data arrays.
+    # this could stand a little optimizing
+    maskdata = []
+    filldata = []
+    maskitem = fillitem = 0
+    step = 8
+    for s in strings:
+        for c in s:
+            maskitem = maskitem << 1
+            fillitem = fillitem << 1
+            step = step - 1
+            if c == black:
+                maskitem = maskitem | 1
+                fillitem = fillitem | 1
+            elif c == white:
+                maskitem = maskitem | 1
+            elif c == xor:
+                fillitem = fillitem | 1
+
+            if not step:
+                maskdata.append(maskitem)
+                filldata.append(fillitem)
+                maskitem = fillitem = 0
+                step = 8
+
+    return tuple(filldata), tuple(maskdata)
+
+
+def load_xbm(curs, mask):
+    """pygame.cursors.load_xbm(cursorfile, maskfile) -> cursor_args
+    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
+    should work with typical XBM files.
+    """
+
+    def bitswap(num):
+        val = 0
+        for x in range(8):
+            b = num & (1 << x) != 0
+            val = val << 1 | b
+        return val
+
+    if hasattr(curs, "readlines"):
+        curs = curs.readlines()
+    else:
+        with open(curs, encoding="ascii") as cursor_f:
+            curs = cursor_f.readlines()
+
+    if hasattr(mask, "readlines"):
+        mask = mask.readlines()
+    else:
+        with open(mask, encoding="ascii") as mask_f:
+            mask = mask_f.readlines()
+
+    # avoid comments
+    for i, line in enumerate(curs):
+        if line.startswith("#define"):
+            curs = curs[i:]
+            break
+
+    for i, line in enumerate(mask):
+        if line.startswith("#define"):
+            mask = mask[i:]
+            break
+
+    # load width,height
+    width = int(curs[0].split()[-1])
+    height = int(curs[1].split()[-1])
+    # load hotspot position
+    if curs[2].startswith("#define"):
+        hotx = int(curs[2].split()[-1])
+        hoty = int(curs[3].split()[-1])
+    else:
+        hotx = hoty = 0
+
+    info = width, height, hotx, hoty
+
+    possible_starts = ("static char", "static unsigned char")
+    for i, line in enumerate(curs):
+        if line.startswith(possible_starts):
+            break
+    data = " ".join(curs[i + 1 :]).replace("};", "").replace(",", " ")
+    cursdata = tuple(bitswap(int(x, 16)) for x in data.split())
+    for i, line in enumerate(mask):
+        if line.startswith(possible_starts):
+            break
+    data = " ".join(mask[i + 1 :]).replace("};", "").replace(",", " ")
+    maskdata = tuple(bitswap(int(x, 16)) for x in data.split())
+    return info[:2], info[2:], cursdata, maskdata
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/cursors.pyi b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/cursors.pyi
new file mode 100644
index 0000000..7edc62b
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/cursors.pyi
@@ -0,0 +1,91 @@
+from typing import Any, Iterator, Sequence, Tuple, Union, overload
+
+from pygame.surface import Surface
+
+from ._common import FileArg, Literal
+
+_Small_string = Tuple[
+    str, str, str, str, str, str, str, str, str, str, str, str, str, str, str, str
+]
+_Big_string = Tuple[
+    str,
+    str,
+    str,
+    str,
+    str,
+    str,
+    str,
+    str,
+    str,
+    str,
+    str,
+    str,
+    str,
+    str,
+    str,
+    str,
+    str,
+    str,
+    str,
+    str,
+    str,
+    str,
+    str,
+    str,
+]
+
+arrow: Cursor
+diamond: Cursor
+broken_x: Cursor
+tri_left: Cursor
+tri_right: Cursor
+ball: Cursor
+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: Sequence[str],
+    black: str = "X",
+    white: str = ".",
+    xor: str = "o",
+) -> Tuple[Tuple[int, ...], Tuple[int, ...]]: ...
+def load_xbm(
+    curs: FileArg, mask: FileArg
+) -> Tuple[Tuple[int, int], Tuple[int, int], Tuple[int, ...], Tuple[int, ...]]: ...
+
+class Cursor:
+    @overload
+    def __init__(self, constant: int = ...) -> None: ...
+    @overload
+    def __init__(self, cursor: Cursor) -> None: ...
+    @overload
+    def __init__(
+        self,
+        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: 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
+    ) -> Union[int, Tuple[int, int], Sequence[int], Surface]: ...
+    copy = __copy__
+    type: Literal["system", "color", "bitmap"]
+    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/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/display.cpython-312-darwin.so b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/display.cpython-312-darwin.so
new file mode 100755
index 0000000..fb1c872
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/display.cpython-312-darwin.so differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/display.pyi b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/display.pyi
new file mode 100644
index 0000000..443a1f9
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/display.pyi
@@ -0,0 +1,77 @@
+from typing import Union, Tuple, List, Optional, Dict, Sequence, overload
+
+from pygame.surface import Surface
+from pygame.constants import FULLSCREEN
+from ._common import Coordinate, RectValue, ColorValue, RGBAOutput
+
+class _VidInfo:
+    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: Coordinate = (0, 0),
+    flags: int = 0,
+    depth: int = 0,
+    display: int = 0,
+    vsync: int = 0,
+) -> Surface: ...
+def get_surface() -> Surface: ...
+def flip() -> None: ...
+@overload
+def update(
+    rectangle: Optional[Union[RectValue, Sequence[Optional[RectValue]]]] = None
+) -> None: ...
+@overload
+def update(x: int, y: int, w: int, h: int) -> None: ...
+@overload
+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]]: ...
+def mode_ok(
+    size: Union[Sequence[int], Tuple[int, int]],
+    flags: int = 0,
+    depth: int = 0,
+    display: int = 0,
+) -> 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: 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/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/__main__.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/__main__.py
new file mode 100644
index 0000000..249b65e
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/__main__.py
@@ -0,0 +1,37 @@
+# python -m pygame.docs
+
+import os
+import webbrowser
+from urllib.parse import quote, urlunparse
+
+
+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:
+        url = "https://www.pygame.org/docs/"
+    webbrowser.open(url)
+
+
+if __name__ == "__main__":
+    open_docs()
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/__pycache__/__main__.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/__pycache__/__main__.cpython-312.pyc
new file mode 100644
index 0000000..5fd1194
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/__pycache__/__main__.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/LGPL.txt b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/LGPL.txt
new file mode 100644
index 0000000..b1e3f5a
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/LGPL.txt
@@ -0,0 +1,504 @@
+		  GNU LESSER GENERAL PUBLIC LICENSE
+		       Version 2.1, February 1999
+
+ Copyright (C) 1991, 1999 Free Software Foundation, Inc.
+     59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
+ Everyone is permitted to copy and distribute verbatim copies
+ of this license document, but changing it is not allowed.
+
+[This is the first released version of the Lesser GPL.  It also counts
+ as the successor of the GNU Library Public License, version 2, hence
+ the version number 2.1.]
+
+			    Preamble
+
+  The licenses for most software are designed to take away your
+freedom to share and change it.  By contrast, the GNU General Public
+Licenses are intended to guarantee your freedom to share and change
+free software--to make sure the software is free for all its users.
+
+  This license, the Lesser General Public License, applies to some
+specially designated software packages--typically libraries--of the
+Free Software Foundation and other authors who decide to use it.  You
+can use it too, but we suggest you first think carefully about whether
+this license or the ordinary General Public License is the better
+strategy to use in any particular case, based on the explanations below.
+
+  When we speak of free software, we are referring to freedom of use,
+not price.  Our General Public Licenses are designed to make sure that
+you have the freedom to distribute copies of free software (and charge
+for this service if you wish); that you receive source code or can get
+it if you want it; that you can change the software and use pieces of
+it in new free programs; and that you are informed that you can do
+these things.
+
+  To protect your rights, we need to make restrictions that forbid
+distributors to deny you these rights or to ask you to surrender these
+rights.  These restrictions translate to certain responsibilities for
+you if you distribute copies of the library or if you modify it.
+
+  For example, if you distribute copies of the library, whether gratis
+or for a fee, you must give the recipients all the rights that we gave
+you.  You must make sure that they, too, receive or can get the source
+code.  If you link other code with the library, you must provide
+complete object files to the recipients, so that they can relink them
+with the library after making changes to the library and recompiling
+it.  And you must show them these terms so they know their rights.
+
+  We protect your rights with a two-step method: (1) we copyright the
+library, and (2) we offer you this license, which gives you legal
+permission to copy, distribute and/or modify the library.
+
+  To protect each distributor, we want to make it very clear that
+there is no warranty for the free library.  Also, if the library is
+modified by someone else and passed on, the recipients should know
+that what they have is not the original version, so that the original
+author's reputation will not be affected by problems that might be
+introduced by others.
+
+  Finally, software patents pose a constant threat to the existence of
+any free program.  We wish to make sure that a company cannot
+effectively restrict the users of a free program by obtaining a
+restrictive license from a patent holder.  Therefore, we insist that
+any patent license obtained for a version of the library must be
+consistent with the full freedom of use specified in this license.
+
+  Most GNU software, including some libraries, is covered by the
+ordinary GNU General Public License.  This license, the GNU Lesser
+General Public License, applies to certain designated libraries, and
+is quite different from the ordinary General Public License.  We use
+this license for certain libraries in order to permit linking those
+libraries into non-free programs.
+
+  When a program is linked with a library, whether statically or using
+a shared library, the combination of the two is legally speaking a
+combined work, a derivative of the original library.  The ordinary
+General Public License therefore permits such linking only if the
+entire combination fits its criteria of freedom.  The Lesser General
+Public License permits more lax criteria for linking other code with
+the library.
+
+  We call this license the "Lesser" General Public License because it
+does Less to protect the user's freedom than the ordinary General
+Public License.  It also provides other free software developers Less
+of an advantage over competing non-free programs.  These disadvantages
+are the reason we use the ordinary General Public License for many
+libraries.  However, the Lesser license provides advantages in certain
+special circumstances.
+
+  For example, on rare occasions, there may be a special need to
+encourage the widest possible use of a certain library, so that it becomes
+a de-facto standard.  To achieve this, non-free programs must be
+allowed to use the library.  A more frequent case is that a free
+library does the same job as widely used non-free libraries.  In this
+case, there is little to gain by limiting the free library to free
+software only, so we use the Lesser General Public License.
+
+  In other cases, permission to use a particular library in non-free
+programs enables a greater number of people to use a large body of
+free software.  For example, permission to use the GNU C Library in
+non-free programs enables many more people to use the whole GNU
+operating system, as well as its variant, the GNU/Linux operating
+system.
+
+  Although the Lesser General Public License is Less protective of the
+users' freedom, it does ensure that the user of a program that is
+linked with the Library has the freedom and the wherewithal to run
+that program using a modified version of the Library.
+
+  The precise terms and conditions for copying, distribution and
+modification follow.  Pay close attention to the difference between a
+"work based on the library" and a "work that uses the library".  The
+former contains code derived from the library, whereas the latter must
+be combined with the library in order to run.
+
+		  GNU LESSER GENERAL PUBLIC LICENSE
+   TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
+
+  0. This License Agreement applies to any software library or other
+program which contains a notice placed by the copyright holder or
+other authorized party saying it may be distributed under the terms of
+this Lesser General Public License (also called "this License").
+Each licensee is addressed as "you".
+
+  A "library" means a collection of software functions and/or data
+prepared so as to be conveniently linked with application programs
+(which use some of those functions and data) to form executables.
+
+  The "Library", below, refers to any such software library or work
+which has been distributed under these terms.  A "work based on the
+Library" means either the Library or any derivative work under
+copyright law: that is to say, a work containing the Library or a
+portion of it, either verbatim or with modifications and/or translated
+straightforwardly into another language.  (Hereinafter, translation is
+included without limitation in the term "modification".)
+
+  "Source code" for a work means the preferred form of the work for
+making modifications to it.  For a library, complete source code means
+all the source code for all modules it contains, plus any associated
+interface definition files, plus the scripts used to control compilation
+and installation of the library.
+
+  Activities other than copying, distribution and modification are not
+covered by this License; they are outside its scope.  The act of
+running a program using the Library is not restricted, and output from
+such a program is covered only if its contents constitute a work based
+on the Library (independent of the use of the Library in a tool for
+writing it).  Whether that is true depends on what the Library does
+and what the program that uses the Library does.
+  
+  1. You may copy and distribute verbatim copies of the Library's
+complete source code as you receive it, in any medium, provided that
+you conspicuously and appropriately publish on each copy an
+appropriate copyright notice and disclaimer of warranty; keep intact
+all the notices that refer to this License and to the absence of any
+warranty; and distribute a copy of this License along with the
+Library.
+
+  You may charge a fee for the physical act of transferring a copy,
+and you may at your option offer warranty protection in exchange for a
+fee.
+
+  2. You may modify your copy or copies of the Library or any portion
+of it, thus forming a work based on the Library, and copy and
+distribute such modifications or work under the terms of Section 1
+above, provided that you also meet all of these conditions:
+
+    a) The modified work must itself be a software library.
+
+    b) You must cause the files modified to carry prominent notices
+    stating that you changed the files and the date of any change.
+
+    c) You must cause the whole of the work to be licensed at no
+    charge to all third parties under the terms of this License.
+
+    d) If a facility in the modified Library refers to a function or a
+    table of data to be supplied by an application program that uses
+    the facility, other than as an argument passed when the facility
+    is invoked, then you must make a good faith effort to ensure that,
+    in the event an application does not supply such function or
+    table, the facility still operates, and performs whatever part of
+    its purpose remains meaningful.
+
+    (For example, a function in a library to compute square roots has
+    a purpose that is entirely well-defined independent of the
+    application.  Therefore, Subsection 2d requires that any
+    application-supplied function or table used by this function must
+    be optional: if the application does not supply it, the square
+    root function must still compute square roots.)
+
+These requirements apply to the modified work as a whole.  If
+identifiable sections of that work are not derived from the Library,
+and can be reasonably considered independent and separate works in
+themselves, then this License, and its terms, do not apply to those
+sections when you distribute them as separate works.  But when you
+distribute the same sections as part of a whole which is a work based
+on the Library, the distribution of the whole must be on the terms of
+this License, whose permissions for other licensees extend to the
+entire whole, and thus to each and every part regardless of who wrote
+it.
+
+Thus, it is not the intent of this section to claim rights or contest
+your rights to work written entirely by you; rather, the intent is to
+exercise the right to control the distribution of derivative or
+collective works based on the Library.
+
+In addition, mere aggregation of another work not based on the Library
+with the Library (or with a work based on the Library) on a volume of
+a storage or distribution medium does not bring the other work under
+the scope of this License.
+
+  3. You may opt to apply the terms of the ordinary GNU General Public
+License instead of this License to a given copy of the Library.  To do
+this, you must alter all the notices that refer to this License, so
+that they refer to the ordinary GNU General Public License, version 2,
+instead of to this License.  (If a newer version than version 2 of the
+ordinary GNU General Public License has appeared, then you can specify
+that version instead if you wish.)  Do not make any other change in
+these notices.
+
+  Once this change is made in a given copy, it is irreversible for
+that copy, so the ordinary GNU General Public License applies to all
+subsequent copies and derivative works made from that copy.
+
+  This option is useful when you wish to copy part of the code of
+the Library into a program that is not a library.
+
+  4. You may copy and distribute the Library (or a portion or
+derivative of it, under Section 2) in object code or executable form
+under the terms of Sections 1 and 2 above provided that you accompany
+it with the complete corresponding machine-readable source code, which
+must be distributed under the terms of Sections 1 and 2 above on a
+medium customarily used for software interchange.
+
+  If distribution of object code is made by offering access to copy
+from a designated place, then offering equivalent access to copy the
+source code from the same place satisfies the requirement to
+distribute the source code, even though third parties are not
+compelled to copy the source along with the object code.
+
+  5. A program that contains no derivative of any portion of the
+Library, but is designed to work with the Library by being compiled or
+linked with it, is called a "work that uses the Library".  Such a
+work, in isolation, is not a derivative work of the Library, and
+therefore falls outside the scope of this License.
+
+  However, linking a "work that uses the Library" with the Library
+creates an executable that is a derivative of the Library (because it
+contains portions of the Library), rather than a "work that uses the
+library".  The executable is therefore covered by this License.
+Section 6 states terms for distribution of such executables.
+
+  When a "work that uses the Library" uses material from a header file
+that is part of the Library, the object code for the work may be a
+derivative work of the Library even though the source code is not.
+Whether this is true is especially significant if the work can be
+linked without the Library, or if the work is itself a library.  The
+threshold for this to be true is not precisely defined by law.
+
+  If such an object file uses only numerical parameters, data
+structure layouts and accessors, and small macros and small inline
+functions (ten lines or less in length), then the use of the object
+file is unrestricted, regardless of whether it is legally a derivative
+work.  (Executables containing this object code plus portions of the
+Library will still fall under Section 6.)
+
+  Otherwise, if the work is a derivative of the Library, you may
+distribute the object code for the work under the terms of Section 6.
+Any executables containing that work also fall under Section 6,
+whether or not they are linked directly with the Library itself.
+
+  6. As an exception to the Sections above, you may also combine or
+link a "work that uses the Library" with the Library to produce a
+work containing portions of the Library, and distribute that work
+under terms of your choice, provided that the terms permit
+modification of the work for the customer's own use and reverse
+engineering for debugging such modifications.
+
+  You must give prominent notice with each copy of the work that the
+Library is used in it and that the Library and its use are covered by
+this License.  You must supply a copy of this License.  If the work
+during execution displays copyright notices, you must include the
+copyright notice for the Library among them, as well as a reference
+directing the user to the copy of this License.  Also, you must do one
+of these things:
+
+    a) Accompany the work with the complete corresponding
+    machine-readable source code for the Library including whatever
+    changes were used in the work (which must be distributed under
+    Sections 1 and 2 above); and, if the work is an executable linked
+    with the Library, with the complete machine-readable "work that
+    uses the Library", as object code and/or source code, so that the
+    user can modify the Library and then relink to produce a modified
+    executable containing the modified Library.  (It is understood
+    that the user who changes the contents of definitions files in the
+    Library will not necessarily be able to recompile the application
+    to use the modified definitions.)
+
+    b) Use a suitable shared library mechanism for linking with the
+    Library.  A suitable mechanism is one that (1) uses at run time a
+    copy of the library already present on the user's computer system,
+    rather than copying library functions into the executable, and (2)
+    will operate properly with a modified version of the library, if
+    the user installs one, as long as the modified version is
+    interface-compatible with the version that the work was made with.
+
+    c) Accompany the work with a written offer, valid for at
+    least three years, to give the same user the materials
+    specified in Subsection 6a, above, for a charge no more
+    than the cost of performing this distribution.
+
+    d) If distribution of the work is made by offering access to copy
+    from a designated place, offer equivalent access to copy the above
+    specified materials from the same place.
+
+    e) Verify that the user has already received a copy of these
+    materials or that you have already sent this user a copy.
+
+  For an executable, the required form of the "work that uses the
+Library" must include any data and utility programs needed for
+reproducing the executable from it.  However, as a special exception,
+the materials to be distributed need not include anything that is
+normally distributed (in either source or binary form) with the major
+components (compiler, kernel, and so on) of the operating system on
+which the executable runs, unless that component itself accompanies
+the executable.
+
+  It may happen that this requirement contradicts the license
+restrictions of other proprietary libraries that do not normally
+accompany the operating system.  Such a contradiction means you cannot
+use both them and the Library together in an executable that you
+distribute.
+
+  7. You may place library facilities that are a work based on the
+Library side-by-side in a single library together with other library
+facilities not covered by this License, and distribute such a combined
+library, provided that the separate distribution of the work based on
+the Library and of the other library facilities is otherwise
+permitted, and provided that you do these two things:
+
+    a) Accompany the combined library with a copy of the same work
+    based on the Library, uncombined with any other library
+    facilities.  This must be distributed under the terms of the
+    Sections above.
+
+    b) Give prominent notice with the combined library of the fact
+    that part of it is a work based on the Library, and explaining
+    where to find the accompanying uncombined form of the same work.
+
+  8. You may not copy, modify, sublicense, link with, or distribute
+the Library except as expressly provided under this License.  Any
+attempt otherwise to copy, modify, sublicense, link with, or
+distribute the Library is void, and will automatically terminate your
+rights under this License.  However, parties who have received copies,
+or rights, from you under this License will not have their licenses
+terminated so long as such parties remain in full compliance.
+
+  9. You are not required to accept this License, since you have not
+signed it.  However, nothing else grants you permission to modify or
+distribute the Library or its derivative works.  These actions are
+prohibited by law if you do not accept this License.  Therefore, by
+modifying or distributing the Library (or any work based on the
+Library), you indicate your acceptance of this License to do so, and
+all its terms and conditions for copying, distributing or modifying
+the Library or works based on it.
+
+  10. Each time you redistribute the Library (or any work based on the
+Library), the recipient automatically receives a license from the
+original licensor to copy, distribute, link with or modify the Library
+subject to these terms and conditions.  You may not impose any further
+restrictions on the recipients' exercise of the rights granted herein.
+You are not responsible for enforcing compliance by third parties with
+this License.
+
+  11. If, as a consequence of a court judgment or allegation of patent
+infringement or for any other reason (not limited to patent issues),
+conditions are imposed on you (whether by court order, agreement or
+otherwise) that contradict the conditions of this License, they do not
+excuse you from the conditions of this License.  If you cannot
+distribute so as to satisfy simultaneously your obligations under this
+License and any other pertinent obligations, then as a consequence you
+may not distribute the Library at all.  For example, if a patent
+license would not permit royalty-free redistribution of the Library by
+all those who receive copies directly or indirectly through you, then
+the only way you could satisfy both it and this License would be to
+refrain entirely from distribution of the Library.
+
+If any portion of this section is held invalid or unenforceable under any
+particular circumstance, the balance of the section is intended to apply,
+and the section as a whole is intended to apply in other circumstances.
+
+It is not the purpose of this section to induce you to infringe any
+patents or other property right claims or to contest validity of any
+such claims; this section has the sole purpose of protecting the
+integrity of the free software distribution system which is
+implemented by public license practices.  Many people have made
+generous contributions to the wide range of software distributed
+through that system in reliance on consistent application of that
+system; it is up to the author/donor to decide if he or she is willing
+to distribute software through any other system and a licensee cannot
+impose that choice.
+
+This section is intended to make thoroughly clear what is believed to
+be a consequence of the rest of this License.
+
+  12. If the distribution and/or use of the Library is restricted in
+certain countries either by patents or by copyrighted interfaces, the
+original copyright holder who places the Library under this License may add
+an explicit geographical distribution limitation excluding those countries,
+so that distribution is permitted only in or among countries not thus
+excluded.  In such case, this License incorporates the limitation as if
+written in the body of this License.
+
+  13. The Free Software Foundation may publish revised and/or new
+versions of the Lesser General Public License from time to time.
+Such new versions will be similar in spirit to the present version,
+but may differ in detail to address new problems or concerns.
+
+Each version is given a distinguishing version number.  If the Library
+specifies a version number of this License which applies to it and
+"any later version", you have the option of following the terms and
+conditions either of that version or of any later version published by
+the Free Software Foundation.  If the Library does not specify a
+license version number, you may choose any version ever published by
+the Free Software Foundation.
+
+  14. If you wish to incorporate parts of the Library into other free
+programs whose distribution conditions are incompatible with these,
+write to the author to ask for permission.  For software which is
+copyrighted by the Free Software Foundation, write to the Free
+Software Foundation; we sometimes make exceptions for this.  Our
+decision will be guided by the two goals of preserving the free status
+of all derivatives of our free software and of promoting the sharing
+and reuse of software generally.
+
+			    NO WARRANTY
+
+  15. BECAUSE THE LIBRARY IS LICENSED FREE OF CHARGE, THERE IS NO
+WARRANTY FOR THE LIBRARY, TO THE EXTENT PERMITTED BY APPLICABLE LAW.
+EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR
+OTHER PARTIES PROVIDE THE LIBRARY "AS IS" WITHOUT WARRANTY OF ANY
+KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+PURPOSE.  THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE
+LIBRARY IS WITH YOU.  SHOULD THE LIBRARY PROVE DEFECTIVE, YOU ASSUME
+THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
+
+  16. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN
+WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY
+AND/OR REDISTRIBUTE THE LIBRARY AS PERMITTED ABOVE, BE LIABLE TO YOU
+FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR
+CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE
+LIBRARY (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING
+RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A
+FAILURE OF THE LIBRARY TO OPERATE WITH ANY OTHER SOFTWARE), EVEN IF
+SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH
+DAMAGES.
+
+		     END OF TERMS AND CONDITIONS
+
+           How to Apply These Terms to Your New Libraries
+
+  If you develop a new library, and you want it to be of the greatest
+possible use to the public, we recommend making it free software that
+everyone can redistribute and change.  You can do so by permitting
+redistribution under these terms (or, alternatively, under the terms of the
+ordinary General Public License).
+
+  To apply these terms, attach the following notices to the library.  It is
+safest to attach them to the start of each source file to most effectively
+convey the exclusion of warranty; and each file should have at least the
+"copyright" line and a pointer to where the full notice is found.
+
+    
+    Copyright (C)   
+
+    This library is free software; you can redistribute it and/or
+    modify it under the terms of the GNU Lesser General Public
+    License as published by the Free Software Foundation; either
+    version 2.1 of the License, or (at your option) any later version.
+
+    This library is distributed in the hope that it will be useful,
+    but WITHOUT ANY WARRANTY; without even the implied warranty of
+    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+    Lesser General Public License for more details.
+
+    You should have received a copy of the GNU Lesser General Public
+    License along with this library; if not, write to the Free Software
+    Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
+
+Also add information on how to contact you by electronic and paper mail.
+
+You should also get your employer (if you work as a programmer) or your
+school, if any, to sign a "copyright disclaimer" for the library, if
+necessary.  Here is a sample; alter the names:
+
+  Yoyodyne, Inc., hereby disclaims all copyright interest in the
+  library `Frob' (a library for tweaking knobs) written by James Random Hacker.
+
+  , 1 April 1990
+  Ty Coon, President of Vice
+
+That's all there is to it!
+
+
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/AdvancedInputOutput1.gif b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/AdvancedInputOutput1.gif
new file mode 100644
index 0000000..8c7f7ea
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/AdvancedInputOutput1.gif differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/AdvancedInputOutput11.gif b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/AdvancedInputOutput11.gif
new file mode 100644
index 0000000..8c7f7ea
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/AdvancedInputOutput11.gif differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/AdvancedInputOutput2.gif b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/AdvancedInputOutput2.gif
new file mode 100644
index 0000000..2094e3a
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/AdvancedInputOutput2.gif differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/AdvancedInputOutput21.gif b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/AdvancedInputOutput21.gif
new file mode 100644
index 0000000..2094e3a
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/AdvancedInputOutput21.gif differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/AdvancedInputOutput3.gif b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/AdvancedInputOutput3.gif
new file mode 100644
index 0000000..3a0d748
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/AdvancedInputOutput3.gif differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/AdvancedInputOutput31.gif b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/AdvancedInputOutput31.gif
new file mode 100644
index 0000000..3a0d748
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/AdvancedInputOutput31.gif differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/AdvancedInputOutput4.gif b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/AdvancedInputOutput4.gif
new file mode 100644
index 0000000..415644e
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/AdvancedInputOutput4.gif differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/AdvancedInputOutput41.gif b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/AdvancedInputOutput41.gif
new file mode 100644
index 0000000..415644e
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/AdvancedInputOutput41.gif differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/AdvancedInputOutput5.gif b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/AdvancedInputOutput5.gif
new file mode 100644
index 0000000..5796b4e
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/AdvancedInputOutput5.gif differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/AdvancedInputOutput51.gif b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/AdvancedInputOutput51.gif
new file mode 100644
index 0000000..5796b4e
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/AdvancedInputOutput51.gif differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/AdvancedOutputAlpha1.gif b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/AdvancedOutputAlpha1.gif
new file mode 100644
index 0000000..c0d4124
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/AdvancedOutputAlpha1.gif differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/AdvancedOutputAlpha11.gif b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/AdvancedOutputAlpha11.gif
new file mode 100644
index 0000000..c0d4124
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/AdvancedOutputAlpha11.gif differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/AdvancedOutputAlpha2.gif b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/AdvancedOutputAlpha2.gif
new file mode 100644
index 0000000..00b443d
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/AdvancedOutputAlpha2.gif differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/AdvancedOutputAlpha21.gif b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/AdvancedOutputAlpha21.gif
new file mode 100644
index 0000000..00b443d
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/AdvancedOutputAlpha21.gif differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/AdvancedOutputAlpha3.gif b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/AdvancedOutputAlpha3.gif
new file mode 100644
index 0000000..be1204d
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/AdvancedOutputAlpha3.gif differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/AdvancedOutputAlpha31.gif b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/AdvancedOutputAlpha31.gif
new file mode 100644
index 0000000..be1204d
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/AdvancedOutputAlpha31.gif differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/AdvancedOutputProcess1.gif b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/AdvancedOutputProcess1.gif
new file mode 100644
index 0000000..20edf21
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/AdvancedOutputProcess1.gif differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/AdvancedOutputProcess11.gif b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/AdvancedOutputProcess11.gif
new file mode 100644
index 0000000..20edf21
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/AdvancedOutputProcess11.gif differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/AdvancedOutputProcess2.gif b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/AdvancedOutputProcess2.gif
new file mode 100644
index 0000000..5445c0e
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/AdvancedOutputProcess2.gif differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/AdvancedOutputProcess21.gif b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/AdvancedOutputProcess21.gif
new file mode 100644
index 0000000..5445c0e
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/AdvancedOutputProcess21.gif differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/AdvancedOutputProcess3.gif b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/AdvancedOutputProcess3.gif
new file mode 100644
index 0000000..0da81f1
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/AdvancedOutputProcess3.gif differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/AdvancedOutputProcess31.gif b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/AdvancedOutputProcess31.gif
new file mode 100644
index 0000000..0da81f1
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/AdvancedOutputProcess31.gif differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/AdvancedOutputProcess4.gif b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/AdvancedOutputProcess4.gif
new file mode 100644
index 0000000..18506fa
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/AdvancedOutputProcess4.gif differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/AdvancedOutputProcess41.gif b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/AdvancedOutputProcess41.gif
new file mode 100644
index 0000000..18506fa
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/AdvancedOutputProcess41.gif differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/AdvancedOutputProcess5.gif b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/AdvancedOutputProcess5.gif
new file mode 100644
index 0000000..def0e06
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/AdvancedOutputProcess5.gif differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/AdvancedOutputProcess51.gif b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/AdvancedOutputProcess51.gif
new file mode 100644
index 0000000..def0e06
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/AdvancedOutputProcess51.gif differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/AdvancedOutputProcess6.gif b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/AdvancedOutputProcess6.gif
new file mode 100644
index 0000000..127cc1e
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/AdvancedOutputProcess6.gif differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/AdvancedOutputProcess61.gif b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/AdvancedOutputProcess61.gif
new file mode 100644
index 0000000..127cc1e
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/AdvancedOutputProcess61.gif differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/Bagic-INPUT-resultscreen.png b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/Bagic-INPUT-resultscreen.png
new file mode 100644
index 0000000..9280cbe
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/Bagic-INPUT-resultscreen.png differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/Bagic-INPUT-resultscreen1.png b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/Bagic-INPUT-resultscreen1.png
new file mode 100644
index 0000000..9280cbe
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/Bagic-INPUT-resultscreen1.png differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/Bagic-INPUT-sourcecode.png b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/Bagic-INPUT-sourcecode.png
new file mode 100644
index 0000000..d378854
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/Bagic-INPUT-sourcecode.png differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/Bagic-INPUT-sourcecode1.png b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/Bagic-INPUT-sourcecode1.png
new file mode 100644
index 0000000..d378854
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/Bagic-INPUT-sourcecode1.png differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/Bagic-PROCESS-resultscreen.png b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/Bagic-PROCESS-resultscreen.png
new file mode 100644
index 0000000..f4e8322
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/Bagic-PROCESS-resultscreen.png differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/Bagic-PROCESS-resultscreen1.png b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/Bagic-PROCESS-resultscreen1.png
new file mode 100644
index 0000000..f4e8322
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/Bagic-PROCESS-resultscreen1.png differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/Bagic-PROCESS-sourcecode.png b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/Bagic-PROCESS-sourcecode.png
new file mode 100644
index 0000000..b20873a
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/Bagic-PROCESS-sourcecode.png differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/Bagic-PROCESS-sourcecode1.png b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/Bagic-PROCESS-sourcecode1.png
new file mode 100644
index 0000000..b20873a
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/Bagic-PROCESS-sourcecode1.png differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/Bagic-ouput-result-screen.png b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/Bagic-ouput-result-screen.png
new file mode 100644
index 0000000..d8628e1
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/Bagic-ouput-result-screen.png differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/Bagic-ouput-result-screen1.png b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/Bagic-ouput-result-screen1.png
new file mode 100644
index 0000000..d8628e1
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/Bagic-ouput-result-screen1.png differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/Basic-ouput-sourcecode.png b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/Basic-ouput-sourcecode.png
new file mode 100644
index 0000000..659c981
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/Basic-ouput-sourcecode.png differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/Basic-ouput-sourcecode1.png b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/Basic-ouput-sourcecode1.png
new file mode 100644
index 0000000..659c981
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/Basic-ouput-sourcecode1.png differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/angle_to.png b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/angle_to.png
new file mode 100644
index 0000000..2cf3b2a
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/angle_to.png differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/camera_average.jpg b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/camera_average.jpg
new file mode 100644
index 0000000..043e485
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/camera_average.jpg differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/camera_background.jpg b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/camera_background.jpg
new file mode 100644
index 0000000..cfcbd02
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/camera_background.jpg differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/camera_green.jpg b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/camera_green.jpg
new file mode 100644
index 0000000..24c4b09
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/camera_green.jpg differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/camera_hsv.jpg b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/camera_hsv.jpg
new file mode 100644
index 0000000..afe9559
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/camera_hsv.jpg differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/camera_mask.jpg b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/camera_mask.jpg
new file mode 100644
index 0000000..cd8ed1d
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/camera_mask.jpg differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/camera_rgb.jpg b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/camera_rgb.jpg
new file mode 100644
index 0000000..3401421
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/camera_rgb.jpg differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/camera_thresh.jpg b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/camera_thresh.jpg
new file mode 100644
index 0000000..cb2426f
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/camera_thresh.jpg differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/camera_thresholded.jpg b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/camera_thresholded.jpg
new file mode 100644
index 0000000..c4ee891
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/camera_thresholded.jpg differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/camera_yuv.jpg b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/camera_yuv.jpg
new file mode 100644
index 0000000..1cda596
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/camera_yuv.jpg differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/chimpshot.gif b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/chimpshot.gif
new file mode 100644
index 0000000..c27191d
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/chimpshot.gif differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/draw_module_example.png b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/draw_module_example.png
new file mode 100644
index 0000000..42d6ed1
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/draw_module_example.png differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/intro_ball.gif b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/intro_ball.gif
new file mode 100644
index 0000000..bbc4a95
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/intro_ball.gif differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/intro_blade.jpg b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/intro_blade.jpg
new file mode 100644
index 0000000..2ed490c
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/intro_blade.jpg differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/intro_freedom.jpg b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/intro_freedom.jpg
new file mode 100644
index 0000000..9ed473d
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/intro_freedom.jpg differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/introduction-Battleship.png b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/introduction-Battleship.png
new file mode 100644
index 0000000..35674f6
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/introduction-Battleship.png differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/introduction-Battleship1.png b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/introduction-Battleship1.png
new file mode 100644
index 0000000..35674f6
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/introduction-Battleship1.png differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/introduction-PuyoPuyo.png b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/introduction-PuyoPuyo.png
new file mode 100644
index 0000000..dc104ea
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/introduction-PuyoPuyo.png differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/introduction-PuyoPuyo1.png b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/introduction-PuyoPuyo1.png
new file mode 100644
index 0000000..dc104ea
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/introduction-PuyoPuyo1.png differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/introduction-TPS.png b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/introduction-TPS.png
new file mode 100644
index 0000000..9c8cb0c
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/introduction-TPS.png differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/introduction-TPS1.png b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/introduction-TPS1.png
new file mode 100644
index 0000000..9c8cb0c
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/introduction-TPS1.png differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/joystick_calls.png b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/joystick_calls.png
new file mode 100644
index 0000000..c713bfe
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/joystick_calls.png differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/pygame_lofi.png b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/pygame_lofi.png
new file mode 100644
index 0000000..b9e9f56
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/pygame_lofi.png differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/pygame_logo.png b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/pygame_logo.png
new file mode 100644
index 0000000..0de28c4
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/pygame_logo.png differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/pygame_powered.png b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/pygame_powered.png
new file mode 100644
index 0000000..4d5bf4b
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/pygame_powered.png differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/pygame_powered_lowres.png b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/pygame_powered_lowres.png
new file mode 100644
index 0000000..642ae7a
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/pygame_powered_lowres.png differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/pygame_tiny.png b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/pygame_tiny.png
new file mode 100644
index 0000000..5ee063a
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/pygame_tiny.png differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/surfarray_allblack.png b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/surfarray_allblack.png
new file mode 100644
index 0000000..80cbc35
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/surfarray_allblack.png differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/surfarray_flipped.png b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/surfarray_flipped.png
new file mode 100644
index 0000000..742f4f3
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/surfarray_flipped.png differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/surfarray_redimg.png b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/surfarray_redimg.png
new file mode 100644
index 0000000..58e9c3f
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/surfarray_redimg.png differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/surfarray_rgbarray.png b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/surfarray_rgbarray.png
new file mode 100644
index 0000000..8513ef7
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/surfarray_rgbarray.png differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/surfarray_scaledown.png b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/surfarray_scaledown.png
new file mode 100644
index 0000000..0be3541
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/surfarray_scaledown.png differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/surfarray_scaleup.png b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/surfarray_scaleup.png
new file mode 100644
index 0000000..ff1f15e
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/surfarray_scaleup.png differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/surfarray_soften.png b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/surfarray_soften.png
new file mode 100644
index 0000000..c1d4ce4
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/surfarray_soften.png differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/surfarray_striped.png b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/surfarray_striped.png
new file mode 100644
index 0000000..2ca4a79
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/surfarray_striped.png differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/surfarray_xfade.png b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/surfarray_xfade.png
new file mode 100644
index 0000000..8b90706
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/surfarray_xfade.png differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/tom_basic.png b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/tom_basic.png
new file mode 100644
index 0000000..849adb5
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/tom_basic.png differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/tom_event-flowchart.png b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/tom_event-flowchart.png
new file mode 100644
index 0000000..6a33613
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/tom_event-flowchart.png differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/tom_formulae.png b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/tom_formulae.png
new file mode 100644
index 0000000..f04b482
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/tom_formulae.png differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/tom_radians.png b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/tom_radians.png
new file mode 100644
index 0000000..4569df1
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_images/tom_radians.png differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_sources/c_api.rst.txt b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_sources/c_api.rst.txt
new file mode 100644
index 0000000..734289f
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_sources/c_api.rst.txt
@@ -0,0 +1,25 @@
+pygame C API
+============
+
+.. toctree::
+   :maxdepth: 1
+   :glob:
+
+   c_api/slots.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/surface.rst
+   c_api/surflock.rst
+   c_api/version.rst
+
+
+src_c/include/ contains header files for applications
+that use the pygame C API, while src_c/ contains
+headers used by pygame internally.
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_sources/filepaths.rst.txt b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_sources/filepaths.rst.txt
new file mode 100644
index 0000000..e17f687
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_sources/filepaths.rst.txt
@@ -0,0 +1,17 @@
+File Path Function Arguments
+============================
+
+A pygame function or method which takes a file path argument will accept
+either a Unicode or a byte (8-bit or ASCII character) string.
+Unicode strings are translated to Python's default filesystem encoding,
+as returned by sys.getfilesystemencoding().  A Unicode code point
+above U+FFFF (``\uFFFF``) can be coded directly with a 32-bit escape sequences
+(``\Uxxxxxxxx``), even for Python interpreters built with an UCS-2
+(16-bit character) Unicode type.  Byte strings are passed
+to the operating system unchanged.
+
+Null characters (``\x00``) are not permitted in the path, raising an exception.
+An exception is also raised if an Unicode file path cannot be encoded.
+How UTF-16 surrogate codes are handled is Python-interpreter-dependent.
+Use UTF-32 code points and 32-bit escape sequences instead.
+The exception types are function-dependent.
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_sources/index.rst.txt b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_sources/index.rst.txt
new file mode 100644
index 0000000..8d34d7c
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_sources/index.rst.txt
@@ -0,0 +1,213 @@
+Pygame Front Page
+=================
+
+.. toctree::
+   :maxdepth: 2
+   :glob:
+   :hidden:
+
+   ref/*
+   tut/*
+   tut/en/**/*
+   tut/ko/**/*
+   c_api
+   filepaths
+   logos
+
+Quick start
+-----------
+
+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)--
+
+.. literalinclude:: ref/code_examples/base_script.py
+
+Here is a slightly more fleshed out example, which shows you how to move something
+(a circle in this case) around on screen--
+
+.. literalinclude:: ref/code_examples/base_script_example.py
+
+For more in depth reference, check out the :ref:`tutorials-reference-label`
+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.
+
+`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.
+
+:doc:`Pygame Logos `
+   The logos of Pygame in different resolutions.
+
+
+`LGPL License`_
+  This is the license pygame is distributed under.
+  It provides for pygame to be distributed with open source and commercial software.
+  Generally, if pygame is not changed, it can be used with any type of program.
+
+.. _tutorials-reference-label:
+
+Tutorials
+---------
+
+: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:`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? `
+  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 `
+  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:`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:`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 `
+  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:`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 `
+  Getting a display surface for the screen.
+
+:doc:`한국어 튜토리얼 (Korean Tutorial) `
+  빨간블록 검은블록
+
+
+Reference
+---------
+
+:ref:`genindex`
+  A list of all functions, classes, and methods in the pygame package.
+
+:doc:`ref/bufferproxy`
+  An array protocol view of surface pixels
+
+:doc:`ref/color`
+  Color representation.
+
+:doc:`ref/cursors`
+  Loading and compiling cursor images.
+
+:doc:`ref/display`
+  Configure the display surface.
+
+:doc:`ref/draw`
+  Drawing simple shapes like lines and ellipses to surfaces.
+
+:doc:`ref/event`
+  Manage the incoming events from various input devices and the windowing platform.
+
+:doc:`ref/examples`
+  Various programs demonstrating the use of individual pygame modules.
+
+:doc:`ref/font`
+  Loading and rendering TrueType fonts.
+
+:doc:`ref/freetype`
+  Enhanced pygame module for loading and rendering font faces.
+
+:doc:`ref/gfxdraw`
+  Anti-aliasing draw functions.
+
+:doc:`ref/image`
+  Loading, saving, and transferring of surfaces.
+
+:doc:`ref/joystick`
+  Manage the joystick devices.
+
+:doc:`ref/key`
+  Manage the keyboard device.
+
+:doc:`ref/locals`
+  Pygame constants.
+
+:doc:`ref/mixer`
+  Load and play sounds
+
+:doc:`ref/mouse`
+  Manage the mouse device and display.
+
+:doc:`ref/music`
+  Play streaming music tracks.
+
+:doc:`ref/pygame`
+  Top level functions to manage pygame.
+
+:doc:`ref/pixelarray`
+  Manipulate image pixel data.
+
+:doc:`ref/rect`
+  Flexible container for a rectangle.
+
+:doc:`ref/scrap`
+  Native clipboard access.
+
+:doc:`ref/sndarray`
+  Manipulate sound sample data.
+
+:doc:`ref/sprite`
+  Higher level objects to represent game images.
+
+:doc:`ref/surface`
+  Objects for images and the screen.
+
+:doc:`ref/surfarray`
+  Manipulate image pixel data.
+
+:doc:`ref/tests`
+  Test pygame.
+
+:doc:`ref/time`
+  Manage timing and framerate.
+
+:doc:`ref/transform`
+  Resize and move images.
+
+:doc:`pygame C API `
+  The C api shared amongst pygame extension modules.
+
+:ref:`search`
+  Search pygame documents by keyword.
+
+.. _Readme: ../wiki/about
+
+.. _Install: ../wiki/GettingStarted#Pygame%20Installation
+
+.. _LGPL License: LGPL.txt
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_sources/logos.rst.txt b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_sources/logos.rst.txt
new file mode 100644
index 0000000..a7ee493
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_sources/logos.rst.txt
@@ -0,0 +1,47 @@
+*************************************************
+  Pygame Logos Page
+*************************************************
+
+Pygame Logos
+============
+
+These logos are available for use in your own game projects.
+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
+
+    .. 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)*
+
+Legacy logos
+------------
+
+.. container:: fullwidth
+
+    `legacy_logos.zip <_static/legacy_logos.zip>`_ - 50.1 KB
\ No newline at end of file
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_sources/ref/bufferproxy.rst.txt b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_sources/ref/bufferproxy.rst.txt
new file mode 100644
index 0000000..bb4e693
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_sources/ref/bufferproxy.rst.txt
@@ -0,0 +1,113 @@
+.. include:: common.txt
+
+.. default-domain:: py
+
+:class:`pygame.BufferProxy`
+===========================
+
+.. currentmodule:: pygame
+
+.. class:: BufferProxy
+
+   | :sl:`pygame object to export a surface buffer through an array protocol`
+   | :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.
+   For all Python versions a :class:`BufferProxy` object exports a C struct
+   and Python level array interface on behalf of its parent object's buffer.
+   A new buffer interface is also exported.
+   In pygame, :class:`BufferProxy` is key to implementing the
+   :mod:`pygame.surfarray` module.
+
+   :class:`BufferProxy` instances can be created directly from Python code,
+   either for a parent that exports an interface, or from a Python ``dict``
+   describing an object's buffer layout. The dict entries are based on the
+   Python level array interface mapping. The following keys are recognized:
+
+      ``"shape"`` : tuple
+         The length of each array dimension as a tuple of integers. The
+         length of the tuple is the number of dimensions in the array.
+
+      ``"typestr"`` : string
+         The array element type as a length 3 string. The first character
+         gives byteorder, '<' for little-endian, '>' for big-endian, and
+         '\|' for not applicable. The second character is the element type,
+         'i' for signed integer, 'u' for unsigned integer, 'f' for floating
+         point, and 'V' for an chunk of bytes. The third character gives the
+         bytesize of the element, from '1' to '9' bytes. So, for example,
+         " Surface`
+      | :sg:`parent -> `
+
+      The :class:`Surface` which returned the :class:`BufferProxy` object or
+      the object passed to a :class:`BufferProxy` call.
+
+   .. attribute:: length
+
+      | :sl:`The size, in bytes, of the exported buffer.`
+      | :sg:`length -> int`
+
+      The number of valid bytes of data exported. For discontinuous data,
+      that is data which is not a single block of memory, the bytes within
+      the gaps are excluded from the count. This property is equivalent to
+      the ``Py_buffer`` C struct ``len`` field.
+
+   .. attribute:: raw
+
+      | :sl:`A copy of the exported buffer as a single block of bytes.`
+      | :sg:`raw -> bytes`
+
+      The buffer data as a ``str``/``bytes`` object.
+      Any gaps in the exported data are removed.
+
+   .. method:: write
+
+      | :sl:`Write raw bytes to object buffer.`
+      | :sg:`write(buffer, offset=0)`
+
+      Overwrite bytes in the parent object's data. The data must be C or F
+      contiguous, otherwise a ValueError is raised. Argument `buffer` is a
+      ``str``/``bytes`` object. An optional offset gives a
+      start position, in bytes, within the buffer where overwriting begins.
+      If the offset is negative or greater that or equal to the buffer proxy's
+      :attr:`length` value, an ``IndexException`` is raised.
+      If ``len(buffer) > proxy.length + offset``, a ``ValueError`` is raised.
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_sources/ref/camera.rst.txt b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_sources/ref/camera.rst.txt
new file mode 100644
index 0000000..a412392
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_sources/ref/camera.rst.txt
@@ -0,0 +1,250 @@
+.. include:: common.txt
+
+:mod:`pygame.camera`
+====================
+
+.. module:: pygame.camera
+   :synopsis: pygame module for camera use
+
+| :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.
+
+.. 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.
+
+The Bayer to ``RGB`` function is based on:
+
+::
+
+ Sonix SN9C101 based webcam basic I/F routines
+ Copyright (C) 2004 Takafumi Mizuno 
+ 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 AUTHOR 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 AUTHOR 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.
+
+New in pygame 1.9.0.
+
+.. function:: init
+
+   | :sl:`Module init`
+   | :sg:`init(backend = None) -> None`
+
+   This function starts up the camera module, choosing the best webcam backend
+   it can find for your system. This is not guaranteed to succeed, and may even
+   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
+   :func:`get_backends()`.
+
+   .. versionchanged:: 2.0.3 Option to explicitly select backend
+
+   .. ## pygame.camera.init ##
+
+.. function:: get_backends
+
+   | :sl:`Get the backends supported on this system`
+   | :sg:`get_backends() -> [str]`
+
+   This function returns every backend it thinks has a possibility of working
+   on your system, in order of priority.
+
+   pygame.camera Backends:
+   ::
+
+      Backend           OS        Description
+      ---------------------------------------------------------------------------------
+      _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 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" 
+   through if you use that as the ``device`` parameter.
+
+   .. versionadded:: 2.0.3
+
+   .. ## pygame.camera.get_backends ##
+
+.. function:: colorspace
+
+   | :sl:`Surface colorspace conversion`
+   | :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
+   depth. This is useful for computer vision on devices with limited processing
+   power. Capture as small of an image as possible, ``transform.scale()`` it
+   even smaller, and then convert the colorspace to ``YUV`` or ``HSV`` before
+   doing any processing on it.
+
+   .. ## pygame.camera.colorspace ##
+
+.. function:: list_cameras
+
+   | :sl:`returns a list of available cameras`
+   | :sg:`list_cameras() -> [cameras]`
+
+   Checks the computer for available cameras and returns a list of strings of
+   camera names, ready to be fed into :class:`pygame.camera.Camera`.
+
+   If the camera backend doesn't support webcam enumeration, this will return
+   something like ``[0]``. See :func:`get_backends()` for much more
+   information.
+
+   .. ## pygame.camera.list_cameras ##
+
+.. class:: Camera
+
+   | :sl:`load a camera`
+   | :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. 
+   This is useful for computer vision purposes. The default is
+   ``RGB``. The following are supported:
+
+      * ``RGB`` - Red, Green, Blue
+
+      * ``YUV`` - Luma, Blue Chrominance, Red Chrominance
+
+      * ``HSV`` - Hue, Saturation, Value
+
+   .. method:: start
+
+      | :sl:`opens, initializes, and starts capturing`
+      | :sg:`start() -> None`
+
+      Opens the camera device, attempts to initialize it, and begins recording
+      images to a buffer. The camera must be started before any of the below
+      functions can be used.
+
+      .. ## Camera.start ##
+
+   .. method:: stop
+
+      | :sl:`stops, uninitializes, and closes the camera`
+      | :sg:`stop() -> None`
+
+      Stops recording, uninitializes the camera, and closes it. Once a camera
+      is stopped, the below functions cannot be used until it is started again.
+
+      .. ## Camera.stop ##
+
+   .. method:: get_controls
+
+      | :sl:`gets current values of user controls`
+      | :sg:`get_controls() -> (hflip = bool, vflip = bool, brightness)`
+
+      If the camera supports it, get_controls will return the current settings
+      for horizontal and vertical image flip as bools and brightness as an int.
+      If unsupported, it will return the default values of (0, 0, 0). Note that
+      the return values here may be different than those returned by
+      set_controls, though these are more likely to be correct.
+
+      .. ## Camera.get_controls ##
+
+   .. method:: set_controls
+
+      | :sl:`changes camera settings if supported by the camera`
+      | :sg:`set_controls(hflip = bool, vflip = bool, brightness) -> (hflip = bool, vflip = bool, brightness)`
+
+      Allows you to change camera settings if the camera supports it. The
+      return values will be the input values if the camera claims it succeeded
+      or the values previously in use if not. Each argument is optional, and
+      the desired one can be chosen by supplying the keyword, like hflip. Note
+      that the actual settings being used by the camera may not be the same as
+      those returned by set_controls. On Windows, :code:`hflip` and :code:`vflip` are
+      implemented by pygame, not by the Camera, so they should always work, but
+      :code:`brightness` is unsupported.
+
+      .. ## Camera.set_controls ##
+
+   .. method:: get_size
+
+      | :sl:`returns the dimensions of the images being recorded`
+      | :sg:`get_size() -> (width, height)`
+
+      Returns the current dimensions of the images being captured by the
+      camera. This will return the actual size, which may be different than the
+      one specified during initialization if the camera did not support that
+      size.
+
+      .. ## Camera.get_size ##
+
+   .. method:: query_image
+
+      | :sl:`checks if a frame is ready`
+      | :sg:`query_image() -> bool`
+
+      If an image is ready to get, it returns true. Otherwise it returns false.
+      Note that some webcams will always return False and will only queue a
+      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. 
+
+      .. ## Camera.query_image ##
+
+   .. method:: get_image
+
+      | :sl:`captures an image as a 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
+      24 bits on Linux, 32 bits on Windows, or the same as the optionally
+      supplied Surface.
+
+      .. ## Camera.get_image ##
+
+   .. method:: get_raw
+
+      | :sl:`returns an unmodified image as bytes`
+      | :sg:`get_raw() -> bytes`
+
+      Gets an image from a camera as a string in the native pixelformat of the
+      camera. Useful for integration with other libraries. This returns a
+      bytes object
+
+      .. ## Camera.get_raw ##
+
+   .. ## pygame.camera.Camera ##
+
+.. ## pygame.camera ##
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_sources/ref/cdrom.rst.txt b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_sources/ref/cdrom.rst.txt
new file mode 100644
index 0000000..62688c9
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_sources/ref/cdrom.rst.txt
@@ -0,0 +1,310 @@
+.. include:: common.txt
+
+:mod:`pygame.cdrom`
+===================
+
+.. module:: pygame.cdrom
+   :synopsis: pygame module for audio cdrom control
+
+| :sl:`pygame module for audio cdrom control`
+
+.. warning::
+	This module is non functional in pygame 2.0 and above, unless you have manually compiled pygame with SDL1.
+	This module will not be supported in the future.
+	One alternative for python cdrom functionality is `pycdio `_.
+	
+The cdrom module manages the ``CD`` and ``DVD`` drives on a computer. It can
+also control the playback of audio CDs. This module needs to be initialized
+before it can do anything. Each ``CD`` object you create represents a cdrom
+drive and must also be initialized individually before it can do most things.
+
+.. function:: init
+
+   | :sl:`initialize the cdrom module`
+   | :sg:`init() -> None`
+
+   Initialize the cdrom module. This will scan the system for all ``CD``
+   devices. The module must be initialized before any other functions will
+   work. This automatically happens when you call ``pygame.init()``.
+
+   It is safe to call this function more than once.
+
+   .. ## pygame.cdrom.init ##
+
+.. function:: quit
+
+   | :sl:`uninitialize the cdrom module`
+   | :sg:`quit() -> None`
+
+   Uninitialize the cdrom module. After you call this any existing ``CD``
+   objects will no longer work.
+
+   It is safe to call this function more than once.
+
+   .. ## pygame.cdrom.quit ##
+
+.. function:: get_init
+
+   | :sl:`true if the cdrom module is initialized`
+   | :sg:`get_init() -> bool`
+
+   Test if the cdrom module is initialized or not. This is different than the
+   ``CD.init()`` since each drive must also be initialized individually.
+
+   .. ## pygame.cdrom.get_init ##
+
+.. function:: get_count
+
+   | :sl:`number of cd drives on the system`
+   | :sg:`get_count() -> count`
+
+   Return the number of cd drives on the system. When you create ``CD`` objects
+   you need to pass an integer id that must be lower than this count. The count
+   will be 0 if there are no drives on the system.
+
+   .. ## pygame.cdrom.get_count ##
+
+.. class:: CD
+
+   | :sl:`class to manage a cdrom drive`
+   | :sg:`CD(id) -> CD`
+
+   You can create a ``CD`` object for each cdrom on the system. Use
+   ``pygame.cdrom.get_count()`` to determine how many drives actually exist.
+   The id argument is an integer of the drive, starting at zero.
+
+   The ``CD`` object is not initialized, you can only call ``CD.get_id()`` and
+   ``CD.get_name()`` on an uninitialized drive.
+
+   It is safe to create multiple ``CD`` objects for the same drive, they will
+   all cooperate normally.
+
+   .. method:: init
+
+      | :sl:`initialize a cdrom drive for use`
+      | :sg:`init() -> None`
+
+      Initialize the cdrom drive for use. The drive must be initialized for
+      most ``CD`` methods to work. Even if the rest of pygame has been
+      initialized.
+
+      There may be a brief pause while the drive is initialized. Avoid
+      ``CD.init()`` if the program should not stop for a second or two.
+
+      .. ## CD.init ##
+
+   .. method:: quit
+
+      | :sl:`uninitialize a cdrom drive for use`
+      | :sg:`quit() -> None`
+
+      Uninitialize a drive for use. Call this when your program will not be
+      accessing the drive for awhile.
+
+      .. ## CD.quit ##
+
+   .. method:: get_init
+
+      | :sl:`true if this cd device initialized`
+      | :sg:`get_init() -> bool`
+
+      Test if this ``CDROM`` device is initialized. This is different than the
+      ``pygame.cdrom.init()`` since each drive must also be initialized
+      individually.
+
+      .. ## CD.get_init ##
+
+   .. method:: play
+
+      | :sl:`start playing audio`
+      | :sg:`play(track, start=None, end=None) -> None`
+
+      Playback audio from an audio cdrom in the drive. Besides the track number
+      argument, you can also pass a starting and ending time for playback. The
+      start and end time are in seconds, and can limit the section of an audio
+      track played.
+
+      If you pass a start time but no end, the audio will play to the end of
+      the track. If you pass a start time and 'None' for the end time, the
+      audio will play to the end of the entire disc.
+
+      See the ``CD.get_numtracks()`` and ``CD.get_track_audio()`` to find
+      tracks to playback.
+
+      Note, track 0 is the first track on the ``CD``. Track numbers start at
+      zero.
+
+      .. ## CD.play ##
+
+   .. method:: stop
+
+      | :sl:`stop audio playback`
+      | :sg:`stop() -> None`
+
+      Stops playback of audio from the cdrom. This will also lose the current
+      playback position. This method does nothing if the drive isn't already
+      playing audio.
+
+      .. ## CD.stop ##
+
+   .. method:: pause
+
+      | :sl:`temporarily stop audio playback`
+      | :sg:`pause() -> None`
+
+      Temporarily stop audio playback on the ``CD``. The playback can be
+      resumed at the same point with the ``CD.resume()`` method. If the ``CD``
+      is not playing this method does nothing.
+
+      Note, track 0 is the first track on the ``CD``. Track numbers start at
+      zero.
+
+      .. ## CD.pause ##
+
+   .. method:: resume
+
+      | :sl:`unpause audio playback`
+      | :sg:`resume() -> None`
+
+      Unpause a paused ``CD``. If the ``CD`` is not paused or already playing,
+      this method does nothing.
+
+      .. ## CD.resume ##
+
+   .. method:: eject
+
+      | :sl:`eject or open the cdrom drive`
+      | :sg:`eject() -> None`
+
+      This will open the cdrom drive and eject the cdrom. If the drive is
+      playing or paused it will be stopped.
+
+      .. ## CD.eject ##
+
+   .. method:: get_id
+
+      | :sl:`the index of the cdrom drive`
+      | :sg:`get_id() -> id`
+
+      Returns the integer id that was used to create the ``CD`` instance. This
+      method can work on an uninitialized ``CD``.
+
+      .. ## CD.get_id ##
+
+   .. method:: get_name
+
+      | :sl:`the system name of the cdrom drive`
+      | :sg:`get_name() -> name`
+
+      Return the string name of the drive. This is the system name used to
+      represent the drive. It is often the drive letter or device name. This
+      method can work on an uninitialized ``CD``.
+
+      .. ## CD.get_name ##
+
+   .. method:: get_busy
+
+      | :sl:`true if the drive is playing audio`
+      | :sg:`get_busy() -> bool`
+
+      Returns True if the drive busy playing back audio.
+
+      .. ## CD.get_busy ##
+
+   .. method:: get_paused
+
+      | :sl:`true if the drive is paused`
+      | :sg:`get_paused() -> bool`
+
+      Returns True if the drive is currently paused.
+
+      .. ## CD.get_paused ##
+
+   .. method:: get_current
+
+      | :sl:`the current audio playback position`
+      | :sg:`get_current() -> track, seconds`
+
+      Returns both the current track and time of that track. This method works
+      when the drive is either playing or paused.
+
+      Note, track 0 is the first track on the ``CD``. Track numbers start at
+      zero.
+
+      .. ## CD.get_current ##
+
+   .. method:: get_empty
+
+      | :sl:`False if a cdrom is in the drive`
+      | :sg:`get_empty() -> bool`
+
+      Return False if there is a cdrom currently in the drive. If the drive is
+      empty this will return True.
+
+      .. ## CD.get_empty ##
+
+   .. method:: get_numtracks
+
+      | :sl:`the number of tracks on the cdrom`
+      | :sg:`get_numtracks() -> count`
+
+      Return the number of tracks on the cdrom in the drive. This will return
+      zero of the drive is empty or has no tracks.
+
+      .. ## CD.get_numtracks ##
+
+   .. method:: get_track_audio
+
+      | :sl:`true if the cdrom track has audio data`
+      | :sg:`get_track_audio(track) -> bool`
+
+      Determine if a track on a cdrom contains audio data. You can also call
+      ``CD.num_tracks()`` and ``CD.get_all()`` to determine more information
+      about the cdrom.
+
+      Note, track 0 is the first track on the ``CD``. Track numbers start at
+      zero.
+
+      .. ## CD.get_track_audio ##
+
+   .. method:: get_all
+
+      | :sl:`get all track information`
+      | :sg:`get_all() -> [(audio, start, end, length), ...]`
+
+      Return a list with information for every track on the cdrom. The
+      information consists of a tuple with four values. The audio value is True
+      if the track contains audio data. The start, end, and length values are
+      floating point numbers in seconds. Start and end represent absolute times
+      on the entire disc.
+
+      .. ## CD.get_all ##
+
+   .. method:: get_track_start
+
+      | :sl:`start time of a cdrom track`
+      | :sg:`get_track_start(track) -> seconds`
+
+      Return the absolute time in seconds where at start of the cdrom track.
+
+      Note, track 0 is the first track on the ``CD``. Track numbers start at
+      zero.
+
+      .. ## CD.get_track_start ##
+
+   .. method:: get_track_length
+
+      | :sl:`length of a cdrom track`
+      | :sg:`get_track_length(track) -> seconds`
+
+      Return a floating point value in seconds of the length of the cdrom
+      track.
+
+      Note, track 0 is the first track on the ``CD``. Track numbers start at
+      zero.
+
+      .. ## CD.get_track_length ##
+
+   .. ## pygame.cdrom.CD ##
+
+.. ## pygame.cdrom ##
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_sources/ref/color.rst.txt b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_sources/ref/color.rst.txt
new file mode 100644
index 0000000..fc5c123
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_sources/ref/color.rst.txt
@@ -0,0 +1,283 @@
+.. include:: common.txt
+
+:mod:`pygame.Color`
+===================
+
+.. currentmodule:: pygame
+
+.. 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/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_sources/ref/color_list.rst.txt b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_sources/ref/color_list.rst.txt
new file mode 100644
index 0000000..b6cf289
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_sources/ref/color_list.rst.txt
@@ -0,0 +1,2014 @@
+.. include:: common.txt
+
+Named Colors
+============
+
+.. raw:: html
+
+    
+
+:doc:`color` lets you specify any of these named colors when creating a new
+``pygame.Color`` (taken from the
+`colordict module `_).
+
+.. role:: aliceblue
+.. role:: antiquewhite
+.. role:: antiquewhite1
+.. role:: antiquewhite2
+.. role:: antiquewhite3
+.. role:: antiquewhite4
+.. role:: aqua
+.. role:: aquamarine
+.. role:: aquamarine1
+.. role:: aquamarine2
+.. role:: aquamarine3
+.. role:: aquamarine4
+.. role:: azure
+.. role:: azure1
+.. role:: azure2
+.. role:: azure3
+.. role:: azure4
+.. role:: beige
+.. role:: bisque
+.. role:: bisque1
+.. role:: bisque2
+.. role:: bisque3
+.. role:: bisque4
+.. role:: black
+.. role:: blanchedalmond
+.. role:: blue
+.. role:: blue1
+.. role:: blue2
+.. role:: blue3
+.. role:: blue4
+.. role:: blueviolet
+.. role:: brown
+.. role:: brown1
+.. role:: brown2
+.. role:: brown3
+.. role:: brown4
+.. role:: burlywood
+.. role:: burlywood1
+.. role:: burlywood2
+.. role:: burlywood3
+.. role:: burlywood4
+.. role:: cadetblue
+.. role:: cadetblue1
+.. role:: cadetblue2
+.. role:: cadetblue3
+.. role:: cadetblue4
+.. role:: chartreuse
+.. role:: chartreuse1
+.. role:: chartreuse2
+.. role:: chartreuse3
+.. role:: chartreuse4
+.. role:: chocolate
+.. role:: chocolate1
+.. role:: chocolate2
+.. role:: chocolate3
+.. role:: chocolate4
+.. role:: coral
+.. role:: coral1
+.. role:: coral2
+.. role:: coral3
+.. role:: coral4
+.. role:: cornflowerblue
+.. role:: cornsilk
+.. role:: cornsilk1
+.. role:: cornsilk2
+.. role:: cornsilk3
+.. role:: cornsilk4
+.. role:: crimson
+.. role:: cyan
+.. role:: cyan1
+.. role:: cyan2
+.. role:: cyan3
+.. role:: cyan4
+.. role:: darkblue
+.. role:: darkcyan
+.. role:: darkgoldenrod
+.. role:: darkgoldenrod1
+.. role:: darkgoldenrod2
+.. role:: darkgoldenrod3
+.. role:: darkgoldenrod4
+.. role:: darkgray
+.. role:: darkgreen
+.. role:: darkgrey
+.. role:: darkkhaki
+.. role:: darkmagenta
+.. role:: darkolivegreen
+.. role:: darkolivegreen1
+.. role:: darkolivegreen2
+.. role:: darkolivegreen3
+.. role:: darkolivegreen4
+.. role:: darkorange
+.. role:: darkorange1
+.. role:: darkorange2
+.. role:: darkorange3
+.. role:: darkorange4
+.. role:: darkorchid
+.. role:: darkorchid1
+.. role:: darkorchid2
+.. role:: darkorchid3
+.. role:: darkorchid4
+.. role:: darkred
+.. role:: darksalmon
+.. role:: darkseagreen
+.. role:: darkseagreen1
+.. role:: darkseagreen2
+.. role:: darkseagreen3
+.. role:: darkseagreen4
+.. role:: darkslateblue
+.. role:: darkslategray
+.. role:: darkslategray1
+.. role:: darkslategray2
+.. role:: darkslategray3
+.. role:: darkslategray4
+.. role:: darkslategrey
+.. role:: darkturquoise
+.. role:: darkviolet
+.. role:: deeppink
+.. role:: deeppink1
+.. role:: deeppink2
+.. role:: deeppink3
+.. role:: deeppink4
+.. role:: deepskyblue
+.. role:: deepskyblue1
+.. role:: deepskyblue2
+.. role:: deepskyblue3
+.. role:: deepskyblue4
+.. role:: dimgray
+.. role:: dimgrey
+.. role:: dodgerblue
+.. role:: dodgerblue1
+.. role:: dodgerblue2
+.. role:: dodgerblue3
+.. role:: dodgerblue4
+.. role:: firebrick
+.. role:: firebrick1
+.. role:: firebrick2
+.. role:: firebrick3
+.. role:: firebrick4
+.. role:: floralwhite
+.. role:: forestgreen
+.. role:: fuchsia
+.. role:: gainsboro
+.. role:: ghostwhite
+.. role:: gold
+.. role:: gold1
+.. role:: gold2
+.. role:: gold3
+.. role:: gold4
+.. role:: goldenrod
+.. role:: goldenrod1
+.. role:: goldenrod2
+.. role:: goldenrod3
+.. role:: goldenrod4
+.. role:: gray
+.. role:: gray0
+.. role:: gray1
+.. role:: gray2
+.. role:: gray3
+.. role:: gray4
+.. role:: gray5
+.. role:: gray6
+.. role:: gray7
+.. role:: gray8
+.. role:: gray9
+.. role:: gray10
+.. role:: gray11
+.. role:: gray12
+.. role:: gray13
+.. role:: gray14
+.. role:: gray15
+.. role:: gray16
+.. role:: gray17
+.. role:: gray18
+.. role:: gray19
+.. role:: gray20
+.. role:: gray21
+.. role:: gray22
+.. role:: gray23
+.. role:: gray24
+.. role:: gray25
+.. role:: gray26
+.. role:: gray27
+.. role:: gray28
+.. role:: gray29
+.. role:: gray30
+.. role:: gray31
+.. role:: gray32
+.. role:: gray33
+.. role:: gray34
+.. role:: gray35
+.. role:: gray36
+.. role:: gray37
+.. role:: gray38
+.. role:: gray39
+.. role:: gray40
+.. role:: gray41
+.. role:: gray42
+.. role:: gray43
+.. role:: gray44
+.. role:: gray45
+.. role:: gray46
+.. role:: gray47
+.. role:: gray48
+.. role:: gray49
+.. role:: gray50
+.. role:: gray51
+.. role:: gray52
+.. role:: gray53
+.. role:: gray54
+.. role:: gray55
+.. role:: gray56
+.. role:: gray57
+.. role:: gray58
+.. role:: gray59
+.. role:: gray60
+.. role:: gray61
+.. role:: gray62
+.. role:: gray63
+.. role:: gray64
+.. role:: gray65
+.. role:: gray66
+.. role:: gray67
+.. role:: gray68
+.. role:: gray69
+.. role:: gray70
+.. role:: gray71
+.. role:: gray72
+.. role:: gray73
+.. role:: gray74
+.. role:: gray75
+.. role:: gray76
+.. role:: gray77
+.. role:: gray78
+.. role:: gray79
+.. role:: gray80
+.. role:: gray81
+.. role:: gray82
+.. role:: gray83
+.. role:: gray84
+.. role:: gray85
+.. role:: gray86
+.. role:: gray87
+.. role:: gray88
+.. role:: gray89
+.. role:: gray90
+.. role:: gray91
+.. role:: gray92
+.. role:: gray93
+.. role:: gray94
+.. role:: gray95
+.. role:: gray96
+.. role:: gray97
+.. role:: gray98
+.. role:: gray99
+.. role:: gray100
+.. role:: green
+.. role:: green1
+.. role:: green2
+.. role:: green3
+.. role:: green4
+.. role:: greenyellow
+.. role:: grey
+.. role:: grey0
+.. role:: grey1
+.. role:: grey2
+.. role:: grey3
+.. role:: grey4
+.. role:: grey5
+.. role:: grey6
+.. role:: grey7
+.. role:: grey8
+.. role:: grey9
+.. role:: grey10
+.. role:: grey11
+.. role:: grey12
+.. role:: grey13
+.. role:: grey14
+.. role:: grey15
+.. role:: grey16
+.. role:: grey17
+.. role:: grey18
+.. role:: grey19
+.. role:: grey20
+.. role:: grey21
+.. role:: grey22
+.. role:: grey23
+.. role:: grey24
+.. role:: grey25
+.. role:: grey26
+.. role:: grey27
+.. role:: grey28
+.. role:: grey29
+.. role:: grey30
+.. role:: grey31
+.. role:: grey32
+.. role:: grey33
+.. role:: grey34
+.. role:: grey35
+.. role:: grey36
+.. role:: grey37
+.. role:: grey38
+.. role:: grey39
+.. role:: grey40
+.. role:: grey41
+.. role:: grey42
+.. role:: grey43
+.. role:: grey44
+.. role:: grey45
+.. role:: grey46
+.. role:: grey47
+.. role:: grey48
+.. role:: grey49
+.. role:: grey50
+.. role:: grey51
+.. role:: grey52
+.. role:: grey53
+.. role:: grey54
+.. role:: grey55
+.. role:: grey56
+.. role:: grey57
+.. role:: grey58
+.. role:: grey59
+.. role:: grey60
+.. role:: grey61
+.. role:: grey62
+.. role:: grey63
+.. role:: grey64
+.. role:: grey65
+.. role:: grey66
+.. role:: grey67
+.. role:: grey68
+.. role:: grey69
+.. role:: grey70
+.. role:: grey71
+.. role:: grey72
+.. role:: grey73
+.. role:: grey74
+.. role:: grey75
+.. role:: grey76
+.. role:: grey77
+.. role:: grey78
+.. role:: grey79
+.. role:: grey80
+.. role:: grey81
+.. role:: grey82
+.. role:: grey83
+.. role:: grey84
+.. role:: grey85
+.. role:: grey86
+.. role:: grey87
+.. role:: grey88
+.. role:: grey89
+.. role:: grey90
+.. role:: grey91
+.. role:: grey92
+.. role:: grey93
+.. role:: grey94
+.. role:: grey95
+.. role:: grey96
+.. role:: grey97
+.. role:: grey98
+.. role:: grey99
+.. role:: grey100
+.. role:: honeydew
+.. role:: honeydew1
+.. role:: honeydew2
+.. role:: honeydew3
+.. role:: honeydew4
+.. role:: hotpink
+.. role:: hotpink1
+.. role:: hotpink2
+.. role:: hotpink3
+.. role:: hotpink4
+.. role:: indianred
+.. role:: indianred1
+.. role:: indianred2
+.. role:: indianred3
+.. role:: indianred4
+.. role:: indigo
+.. role:: ivory
+.. role:: ivory1
+.. role:: ivory2
+.. role:: ivory3
+.. role:: ivory4
+.. role:: khaki
+.. role:: khaki1
+.. role:: khaki2
+.. role:: khaki3
+.. role:: khaki4
+.. role:: lavender
+.. role:: lavenderblush
+.. role:: lavenderblush1
+.. role:: lavenderblush2
+.. role:: lavenderblush3
+.. role:: lavenderblush4
+.. role:: lawngreen
+.. role:: lemonchiffon
+.. role:: lemonchiffon1
+.. role:: lemonchiffon2
+.. role:: lemonchiffon3
+.. role:: lemonchiffon4
+.. role:: lightblue
+.. role:: lightblue1
+.. role:: lightblue2
+.. role:: lightblue3
+.. role:: lightblue4
+.. role:: lightcoral
+.. role:: lightcyan
+.. role:: lightcyan1
+.. role:: lightcyan2
+.. role:: lightcyan3
+.. role:: lightcyan4
+.. role:: lightgoldenrod
+.. role:: lightgoldenrod1
+.. role:: lightgoldenrod2
+.. role:: lightgoldenrod3
+.. role:: lightgoldenrod4
+.. role:: lightgoldenrodyellow
+.. role:: lightgray
+.. role:: lightgreen
+.. role:: lightgrey
+.. role:: lightpink
+.. role:: lightpink1
+.. role:: lightpink2
+.. role:: lightpink3
+.. role:: lightpink4
+.. role:: lightsalmon
+.. role:: lightsalmon1
+.. role:: lightsalmon2
+.. role:: lightsalmon3
+.. role:: lightsalmon4
+.. role:: lightseagreen
+.. role:: lightskyblue
+.. role:: lightskyblue1
+.. role:: lightskyblue2
+.. role:: lightskyblue3
+.. role:: lightskyblue4
+.. role:: lightslateblue
+.. role:: lightslategray
+.. role:: lightslategrey
+.. role:: lightsteelblue
+.. role:: lightsteelblue1
+.. role:: lightsteelblue2
+.. role:: lightsteelblue3
+.. role:: lightsteelblue4
+.. role:: lightyellow
+.. role:: lightyellow1
+.. role:: lightyellow2
+.. role:: lightyellow3
+.. role:: lightyellow4
+.. role:: limegreen
+.. role:: lime
+.. role:: linen
+.. role:: magenta
+.. role:: magenta1
+.. role:: magenta2
+.. role:: magenta3
+.. role:: magenta4
+.. role:: maroon
+.. role:: maroon1
+.. role:: maroon2
+.. role:: maroon3
+.. role:: maroon4
+.. role:: mediumaquamarine
+.. role:: mediumblue
+.. role:: mediumorchid
+.. role:: mediumorchid1
+.. role:: mediumorchid2
+.. role:: mediumorchid3
+.. role:: mediumorchid4
+.. role:: mediumpurple
+.. role:: mediumpurple1
+.. role:: mediumpurple2
+.. role:: mediumpurple3
+.. role:: mediumpurple4
+.. role:: mediumseagreen
+.. role:: mediumslateblue
+.. role:: mediumspringgreen
+.. role:: mediumturquoise
+.. role:: mediumvioletred
+.. role:: midnightblue
+.. role:: mintcream
+.. role:: mistyrose
+.. role:: mistyrose1
+.. role:: mistyrose2
+.. role:: mistyrose3
+.. role:: mistyrose4
+.. role:: moccasin
+.. role:: navajowhite
+.. role:: navajowhite1
+.. role:: navajowhite2
+.. role:: navajowhite3
+.. role:: navajowhite4
+.. role:: navy
+.. role:: navyblue
+.. role:: oldlace
+.. role:: olive
+.. role:: olivedrab
+.. role:: olivedrab1
+.. role:: olivedrab2
+.. role:: olivedrab3
+.. role:: olivedrab4
+.. role:: orange
+.. role:: orange1
+.. role:: orange2
+.. role:: orange3
+.. role:: orange4
+.. role:: orangered
+.. role:: orangered1
+.. role:: orangered2
+.. role:: orangered3
+.. role:: orangered4
+.. role:: orchid
+.. role:: orchid1
+.. role:: orchid2
+.. role:: orchid3
+.. role:: orchid4
+.. role:: palegoldenrod
+.. role:: palegreen
+.. role:: palegreen1
+.. role:: palegreen2
+.. role:: palegreen3
+.. role:: palegreen4
+.. role:: paleturquoise
+.. role:: paleturquoise1
+.. role:: paleturquoise2
+.. role:: paleturquoise3
+.. role:: paleturquoise4
+.. role:: palevioletred
+.. role:: palevioletred1
+.. role:: palevioletred2
+.. role:: palevioletred3
+.. role:: palevioletred4
+.. role:: papayawhip
+.. role:: peachpuff
+.. role:: peachpuff1
+.. role:: peachpuff2
+.. role:: peachpuff3
+.. role:: peachpuff4
+.. role:: peru
+.. role:: pink
+.. role:: pink1
+.. role:: pink2
+.. role:: pink3
+.. role:: pink4
+.. role:: plum
+.. role:: plum1
+.. role:: plum2
+.. role:: plum3
+.. role:: plum4
+.. role:: powderblue
+.. role:: purple
+.. role:: purple1
+.. role:: purple2
+.. role:: purple3
+.. role:: purple4
+.. role:: red
+.. role:: red1
+.. role:: red2
+.. role:: red3
+.. role:: red4
+.. role:: rosybrown
+.. role:: rosybrown1
+.. role:: rosybrown2
+.. role:: rosybrown3
+.. role:: rosybrown4
+.. role:: royalblue
+.. role:: royalblue1
+.. role:: royalblue2
+.. role:: royalblue3
+.. role:: royalblue4
+.. role:: saddlebrown
+.. role:: salmon
+.. role:: salmon1
+.. role:: salmon2
+.. role:: salmon3
+.. role:: salmon4
+.. role:: sandybrown
+.. role:: seagreen
+.. role:: seagreen1
+.. role:: seagreen2
+.. role:: seagreen3
+.. role:: seagreen4
+.. role:: seashell
+.. role:: seashell1
+.. role:: seashell2
+.. role:: seashell3
+.. role:: seashell4
+.. role:: sienna
+.. role:: sienna1
+.. role:: sienna2
+.. role:: sienna3
+.. role:: sienna4
+.. role:: silver
+.. role:: skyblue
+.. role:: skyblue1
+.. role:: skyblue2
+.. role:: skyblue3
+.. role:: skyblue4
+.. role:: slateblue
+.. role:: slateblue1
+.. role:: slateblue2
+.. role:: slateblue3
+.. role:: slateblue4
+.. role:: slategray
+.. role:: slategray1
+.. role:: slategray2
+.. role:: slategray3
+.. role:: slategray4
+.. role:: slategrey
+.. role:: snow
+.. role:: snow1
+.. role:: snow2
+.. role:: snow3
+.. role:: snow4
+.. role:: springgreen
+.. role:: springgreen1
+.. role:: springgreen2
+.. role:: springgreen3
+.. role:: springgreen4
+.. role:: steelblue
+.. role:: steelblue1
+.. role:: steelblue2
+.. role:: steelblue3
+.. role:: steelblue4
+.. role:: tan
+.. role:: tan1
+.. role:: tan2
+.. role:: tan3
+.. role:: tan4
+.. role:: teal
+.. role:: thistle
+.. role:: thistle1
+.. role:: thistle2
+.. role:: thistle3
+.. role:: thistle4
+.. role:: tomato
+.. role:: tomato1
+.. role:: tomato2
+.. role:: tomato3
+.. role:: tomato4
+.. role:: turquoise
+.. role:: turquoise1
+.. role:: turquoise2
+.. role:: turquoise3
+.. role:: turquoise4
+.. role:: violet
+.. role:: violetred
+.. role:: violetred1
+.. role:: violetred2
+.. role:: violetred3
+.. role:: violetred4
+.. role:: wheat
+.. role:: wheat1
+.. role:: wheat2
+.. role:: wheat3
+.. role:: wheat4
+.. role:: white
+.. role:: whitesmoke
+.. role:: yellow
+.. role:: yellow1
+.. role:: yellow2
+.. role:: yellow3
+.. role:: yellow4
+.. role:: yellowgreen
+
+==========================  ======================================================================================================
+Name                        Color
+==========================  ======================================================================================================
+``aliceblue``               :aliceblue:`████████`
+``antiquewhite``            :antiquewhite:`████████`
+``antiquewhite1``           :antiquewhite1:`████████`
+``antiquewhite2``           :antiquewhite2:`████████`
+``antiquewhite3``           :antiquewhite3:`████████`
+``antiquewhite4``           :antiquewhite4:`████████`
+``aqua``                    :aqua:`████████`
+``aquamarine``              :aquamarine:`████████`
+``aquamarine1``             :aquamarine1:`████████`
+``aquamarine2``             :aquamarine2:`████████`
+``aquamarine3``             :aquamarine3:`████████`
+``aquamarine4``             :aquamarine4:`████████`
+``azure``                   :azure:`████████`
+``azure1``                  :azure1:`████████`
+``azure2``                  :azure2:`████████`
+``azure3``                  :azure3:`████████`
+``azure4``                  :azure4:`████████`
+``beige``                   :beige:`████████`
+``bisque``                  :bisque:`████████`
+``bisque1``                 :bisque1:`████████`
+``bisque2``                 :bisque2:`████████`
+``bisque3``                 :bisque3:`████████`
+``bisque4``                 :bisque4:`████████`
+``black``                   :black:`████████`
+``blanchedalmond``          :blanchedalmond:`████████`
+``blue``                    :blue:`████████`
+``blue1``                   :blue1:`████████`
+``blue2``                   :blue2:`████████`
+``blue3``                   :blue3:`████████`
+``blue4``                   :blue4:`████████`
+``blueviolet``              :blueviolet:`████████`
+``brown``                   :brown:`████████`
+``brown1``                  :brown1:`████████`
+``brown2``                  :brown2:`████████`
+``brown3``                  :brown3:`████████`
+``brown4``                  :brown4:`████████`
+``burlywood``               :burlywood:`████████`
+``burlywood1``              :burlywood1:`████████`
+``burlywood2``              :burlywood2:`████████`
+``burlywood3``              :burlywood3:`████████`
+``burlywood4``              :burlywood4:`████████`
+``cadetblue``               :cadetblue:`████████`
+``cadetblue1``              :cadetblue1:`████████`
+``cadetblue2``              :cadetblue2:`████████`
+``cadetblue3``              :cadetblue3:`████████`
+``cadetblue4``              :cadetblue4:`████████`
+``chartreuse``              :chartreuse:`████████`
+``chartreuse1``             :chartreuse1:`████████`
+``chartreuse2``             :chartreuse2:`████████`
+``chartreuse3``             :chartreuse3:`████████`
+``chartreuse4``             :chartreuse4:`████████`
+``chocolate``               :chocolate:`████████`
+``chocolate1``              :chocolate1:`████████`
+``chocolate2``              :chocolate2:`████████`
+``chocolate3``              :chocolate3:`████████`
+``chocolate4``              :chocolate4:`████████`
+``coral``                   :coral:`████████`
+``coral1``                  :coral1:`████████`
+``coral2``                  :coral2:`████████`
+``coral3``                  :coral3:`████████`
+``coral4``                  :coral4:`████████`
+``cornflowerblue``          :cornflowerblue:`████████`
+``cornsilk``                :cornsilk:`████████`
+``cornsilk1``               :cornsilk1:`████████`
+``cornsilk2``               :cornsilk2:`████████`
+``cornsilk3``               :cornsilk3:`████████`
+``cornsilk4``               :cornsilk4:`████████`
+``crimson``                 :crimson:`████████`
+``cyan``                    :cyan:`████████`
+``cyan1``                   :cyan1:`████████`
+``cyan2``                   :cyan2:`████████`
+``cyan3``                   :cyan3:`████████`
+``cyan4``                   :cyan4:`████████`
+``darkblue``                :darkblue:`████████`
+``darkcyan``                :darkcyan:`████████`
+``darkgoldenrod``           :darkgoldenrod:`████████`
+``darkgoldenrod1``          :darkgoldenrod1:`████████`
+``darkgoldenrod2``          :darkgoldenrod2:`████████`
+``darkgoldenrod3``          :darkgoldenrod3:`████████`
+``darkgoldenrod4``          :darkgoldenrod4:`████████`
+``darkgray``                :darkgray:`████████`
+``darkgreen``               :darkgreen:`████████`
+``darkgrey``                :darkgrey:`████████`
+``darkkhaki``               :darkkhaki:`████████`
+``darkmagenta``             :darkmagenta:`████████`
+``darkolivegreen``          :darkolivegreen:`████████`
+``darkolivegreen1``         :darkolivegreen1:`████████`
+``darkolivegreen2``         :darkolivegreen2:`████████`
+``darkolivegreen3``         :darkolivegreen3:`████████`
+``darkolivegreen4``         :darkolivegreen4:`████████`
+``darkorange``              :darkorange:`████████`
+``darkorange1``             :darkorange1:`████████`
+``darkorange2``             :darkorange2:`████████`
+``darkorange3``             :darkorange3:`████████`
+``darkorange4``             :darkorange4:`████████`
+``darkorchid``              :darkorchid:`████████`
+``darkorchid1``             :darkorchid1:`████████`
+``darkorchid2``             :darkorchid2:`████████`
+``darkorchid3``             :darkorchid3:`████████`
+``darkorchid4``             :darkorchid4:`████████`
+``darkred``                 :darkred:`████████`
+``darksalmon``              :darksalmon:`████████`
+``darkseagreen``            :darkseagreen:`████████`
+``darkseagreen1``           :darkseagreen1:`████████`
+``darkseagreen2``           :darkseagreen2:`████████`
+``darkseagreen3``           :darkseagreen3:`████████`
+``darkseagreen4``           :darkseagreen4:`████████`
+``darkslateblue``           :darkslateblue:`████████`
+``darkslategray``           :darkslategray:`████████`
+``darkslategray1``          :darkslategray1:`████████`
+``darkslategray2``          :darkslategray2:`████████`
+``darkslategray3``          :darkslategray3:`████████`
+``darkslategray4``          :darkslategray4:`████████`
+``darkslategrey``           :darkslategrey:`████████`
+``darkturquoise``           :darkturquoise:`████████`
+``darkviolet``              :darkviolet:`████████`
+``deeppink``                :deeppink:`████████`
+``deeppink1``               :deeppink1:`████████`
+``deeppink2``               :deeppink2:`████████`
+``deeppink3``               :deeppink3:`████████`
+``deeppink4``               :deeppink4:`████████`
+``deepskyblue``             :deepskyblue:`████████`
+``deepskyblue1``            :deepskyblue1:`████████`
+``deepskyblue2``            :deepskyblue2:`████████`
+``deepskyblue3``            :deepskyblue3:`████████`
+``deepskyblue4``            :deepskyblue4:`████████`
+``dimgray``                 :dimgray:`████████`
+``dimgrey``                 :dimgrey:`████████`
+``dodgerblue``              :dodgerblue:`████████`
+``dodgerblue1``             :dodgerblue1:`████████`
+``dodgerblue2``             :dodgerblue2:`████████`
+``dodgerblue3``             :dodgerblue3:`████████`
+``dodgerblue4``             :dodgerblue4:`████████`
+``firebrick``               :firebrick:`████████`
+``firebrick1``              :firebrick1:`████████`
+``firebrick2``              :firebrick2:`████████`
+``firebrick3``              :firebrick3:`████████`
+``firebrick4``              :firebrick4:`████████`
+``floralwhite``             :floralwhite:`████████`
+``forestgreen``             :forestgreen:`████████`
+``fuchsia``                 :fuchsia:`████████`
+``gainsboro``               :gainsboro:`████████`
+``ghostwhite``              :ghostwhite:`████████`
+``gold``                    :gold:`████████`
+``gold1``                   :gold1:`████████`
+``gold2``                   :gold2:`████████`
+``gold3``                   :gold3:`████████`
+``gold4``                   :gold4:`████████`
+``goldenrod``               :goldenrod:`████████`
+``goldenrod1``              :goldenrod1:`████████`
+``goldenrod2``              :goldenrod2:`████████`
+``goldenrod3``              :goldenrod3:`████████`
+``goldenrod4``              :goldenrod4:`████████`
+``gray``                    :gray:`████████`
+``gray0``                   :gray0:`████████`
+``gray1``                   :gray1:`████████`
+``gray2``                   :gray2:`████████`
+``gray3``                   :gray3:`████████`
+``gray4``                   :gray4:`████████`
+``gray5``                   :gray5:`████████`
+``gray6``                   :gray6:`████████`
+``gray7``                   :gray7:`████████`
+``gray8``                   :gray8:`████████`
+``gray9``                   :gray9:`████████`
+``gray10``                  :gray10:`████████`
+``gray11``                  :gray11:`████████`
+``gray12``                  :gray12:`████████`
+``gray13``                  :gray13:`████████`
+``gray14``                  :gray14:`████████`
+``gray15``                  :gray15:`████████`
+``gray16``                  :gray16:`████████`
+``gray17``                  :gray17:`████████`
+``gray18``                  :gray18:`████████`
+``gray19``                  :gray19:`████████`
+``gray20``                  :gray20:`████████`
+``gray21``                  :gray21:`████████`
+``gray22``                  :gray22:`████████`
+``gray23``                  :gray23:`████████`
+``gray24``                  :gray24:`████████`
+``gray25``                  :gray25:`████████`
+``gray26``                  :gray26:`████████`
+``gray27``                  :gray27:`████████`
+``gray28``                  :gray28:`████████`
+``gray29``                  :gray29:`████████`
+``gray30``                  :gray30:`████████`
+``gray31``                  :gray31:`████████`
+``gray32``                  :gray32:`████████`
+``gray33``                  :gray33:`████████`
+``gray34``                  :gray34:`████████`
+``gray35``                  :gray35:`████████`
+``gray36``                  :gray36:`████████`
+``gray37``                  :gray37:`████████`
+``gray38``                  :gray38:`████████`
+``gray39``                  :gray39:`████████`
+``gray40``                  :gray40:`████████`
+``gray41``                  :gray41:`████████`
+``gray42``                  :gray42:`████████`
+``gray43``                  :gray43:`████████`
+``gray44``                  :gray44:`████████`
+``gray45``                  :gray45:`████████`
+``gray46``                  :gray46:`████████`
+``gray47``                  :gray47:`████████`
+``gray48``                  :gray48:`████████`
+``gray49``                  :gray49:`████████`
+``gray50``                  :gray50:`████████`
+``gray51``                  :gray51:`████████`
+``gray52``                  :gray52:`████████`
+``gray53``                  :gray53:`████████`
+``gray54``                  :gray54:`████████`
+``gray55``                  :gray55:`████████`
+``gray56``                  :gray56:`████████`
+``gray57``                  :gray57:`████████`
+``gray58``                  :gray58:`████████`
+``gray59``                  :gray59:`████████`
+``gray60``                  :gray60:`████████`
+``gray61``                  :gray61:`████████`
+``gray62``                  :gray62:`████████`
+``gray63``                  :gray63:`████████`
+``gray64``                  :gray64:`████████`
+``gray65``                  :gray65:`████████`
+``gray66``                  :gray66:`████████`
+``gray67``                  :gray67:`████████`
+``gray68``                  :gray68:`████████`
+``gray69``                  :gray69:`████████`
+``gray70``                  :gray70:`████████`
+``gray71``                  :gray71:`████████`
+``gray72``                  :gray72:`████████`
+``gray73``                  :gray73:`████████`
+``gray74``                  :gray74:`████████`
+``gray75``                  :gray75:`████████`
+``gray76``                  :gray76:`████████`
+``gray77``                  :gray77:`████████`
+``gray78``                  :gray78:`████████`
+``gray79``                  :gray79:`████████`
+``gray80``                  :gray80:`████████`
+``gray81``                  :gray81:`████████`
+``gray82``                  :gray82:`████████`
+``gray83``                  :gray83:`████████`
+``gray84``                  :gray84:`████████`
+``gray85``                  :gray85:`████████`
+``gray86``                  :gray86:`████████`
+``gray87``                  :gray87:`████████`
+``gray88``                  :gray88:`████████`
+``gray89``                  :gray89:`████████`
+``gray90``                  :gray90:`████████`
+``gray91``                  :gray91:`████████`
+``gray92``                  :gray92:`████████`
+``gray93``                  :gray93:`████████`
+``gray94``                  :gray94:`████████`
+``gray95``                  :gray95:`████████`
+``gray96``                  :gray96:`████████`
+``gray97``                  :gray97:`████████`
+``gray98``                  :gray98:`████████`
+``gray99``                  :gray99:`████████`
+``gray100``                 :gray100:`████████`
+``green``                   :green:`████████`
+``green1``                  :green1:`████████`
+``green2``                  :green2:`████████`
+``green3``                  :green3:`████████`
+``green4``                  :green4:`████████`
+``greenyellow``             :greenyellow:`████████`
+``grey``                    :grey:`████████`
+``grey0``                   :grey0:`████████`
+``grey1``                   :grey1:`████████`
+``grey2``                   :grey2:`████████`
+``grey3``                   :grey3:`████████`
+``grey4``                   :grey4:`████████`
+``grey5``                   :grey5:`████████`
+``grey6``                   :grey6:`████████`
+``grey7``                   :grey7:`████████`
+``grey8``                   :grey8:`████████`
+``grey9``                   :grey9:`████████`
+``grey10``                  :grey10:`████████`
+``grey11``                  :grey11:`████████`
+``grey12``                  :grey12:`████████`
+``grey13``                  :grey13:`████████`
+``grey14``                  :grey14:`████████`
+``grey15``                  :grey15:`████████`
+``grey16``                  :grey16:`████████`
+``grey17``                  :grey17:`████████`
+``grey18``                  :grey18:`████████`
+``grey19``                  :grey19:`████████`
+``grey20``                  :grey20:`████████`
+``grey21``                  :grey21:`████████`
+``grey22``                  :grey22:`████████`
+``grey23``                  :grey23:`████████`
+``grey24``                  :grey24:`████████`
+``grey25``                  :grey25:`████████`
+``grey26``                  :grey26:`████████`
+``grey27``                  :grey27:`████████`
+``grey28``                  :grey28:`████████`
+``grey29``                  :grey29:`████████`
+``grey30``                  :grey30:`████████`
+``grey31``                  :grey31:`████████`
+``grey32``                  :grey32:`████████`
+``grey33``                  :grey33:`████████`
+``grey34``                  :grey34:`████████`
+``grey35``                  :grey35:`████████`
+``grey36``                  :grey36:`████████`
+``grey37``                  :grey37:`████████`
+``grey38``                  :grey38:`████████`
+``grey39``                  :grey39:`████████`
+``grey40``                  :grey40:`████████`
+``grey41``                  :grey41:`████████`
+``grey42``                  :grey42:`████████`
+``grey43``                  :grey43:`████████`
+``grey44``                  :grey44:`████████`
+``grey45``                  :grey45:`████████`
+``grey46``                  :grey46:`████████`
+``grey47``                  :grey47:`████████`
+``grey48``                  :grey48:`████████`
+``grey49``                  :grey49:`████████`
+``grey50``                  :grey50:`████████`
+``grey51``                  :grey51:`████████`
+``grey52``                  :grey52:`████████`
+``grey53``                  :grey53:`████████`
+``grey54``                  :grey54:`████████`
+``grey55``                  :grey55:`████████`
+``grey56``                  :grey56:`████████`
+``grey57``                  :grey57:`████████`
+``grey58``                  :grey58:`████████`
+``grey59``                  :grey59:`████████`
+``grey60``                  :grey60:`████████`
+``grey61``                  :grey61:`████████`
+``grey62``                  :grey62:`████████`
+``grey63``                  :grey63:`████████`
+``grey64``                  :grey64:`████████`
+``grey65``                  :grey65:`████████`
+``grey66``                  :grey66:`████████`
+``grey67``                  :grey67:`████████`
+``grey68``                  :grey68:`████████`
+``grey69``                  :grey69:`████████`
+``grey70``                  :grey70:`████████`
+``grey71``                  :grey71:`████████`
+``grey72``                  :grey72:`████████`
+``grey73``                  :grey73:`████████`
+``grey74``                  :grey74:`████████`
+``grey75``                  :grey75:`████████`
+``grey76``                  :grey76:`████████`
+``grey77``                  :grey77:`████████`
+``grey78``                  :grey78:`████████`
+``grey79``                  :grey79:`████████`
+``grey80``                  :grey80:`████████`
+``grey81``                  :grey81:`████████`
+``grey82``                  :grey82:`████████`
+``grey83``                  :grey83:`████████`
+``grey84``                  :grey84:`████████`
+``grey85``                  :grey85:`████████`
+``grey86``                  :grey86:`████████`
+``grey87``                  :grey87:`████████`
+``grey88``                  :grey88:`████████`
+``grey89``                  :grey89:`████████`
+``grey90``                  :grey90:`████████`
+``grey91``                  :grey91:`████████`
+``grey92``                  :grey92:`████████`
+``grey93``                  :grey93:`████████`
+``grey94``                  :grey94:`████████`
+``grey95``                  :grey95:`████████`
+``grey96``                  :grey96:`████████`
+``grey97``                  :grey97:`████████`
+``grey98``                  :grey98:`████████`
+``grey99``                  :grey99:`████████`
+``grey100``                 :grey100:`████████`
+``honeydew``                :honeydew:`████████`
+``honeydew1``               :honeydew1:`████████`
+``honeydew2``               :honeydew2:`████████`
+``honeydew3``               :honeydew3:`████████`
+``honeydew4``               :honeydew4:`████████`
+``hotpink``                 :hotpink:`████████`
+``hotpink1``                :hotpink1:`████████`
+``hotpink2``                :hotpink2:`████████`
+``hotpink3``                :hotpink3:`████████`
+``hotpink4``                :hotpink4:`████████`
+``indianred``               :indianred:`████████`
+``indianred1``              :indianred1:`████████`
+``indianred2``              :indianred2:`████████`
+``indianred3``              :indianred3:`████████`
+``indianred4``              :indianred4:`████████`
+``indigo``                  :indigo:`████████`
+``ivory``                   :ivory:`████████`
+``ivory1``                  :ivory1:`████████`
+``ivory2``                  :ivory2:`████████`
+``ivory3``                  :ivory3:`████████`
+``ivory4``                  :ivory4:`████████`
+``khaki``                   :khaki:`████████`
+``khaki1``                  :khaki1:`████████`
+``khaki2``                  :khaki2:`████████`
+``khaki3``                  :khaki3:`████████`
+``khaki4``                  :khaki4:`████████`
+``lavender``                :lavender:`████████`
+``lavenderblush``           :lavenderblush:`████████`
+``lavenderblush1``          :lavenderblush1:`████████`
+``lavenderblush2``          :lavenderblush2:`████████`
+``lavenderblush3``          :lavenderblush3:`████████`
+``lavenderblush4``          :lavenderblush4:`████████`
+``lawngreen``               :lawngreen:`████████`
+``lemonchiffon``            :lemonchiffon:`████████`
+``lemonchiffon1``           :lemonchiffon1:`████████`
+``lemonchiffon2``           :lemonchiffon2:`████████`
+``lemonchiffon3``           :lemonchiffon3:`████████`
+``lemonchiffon4``           :lemonchiffon4:`████████`
+``lightblue``               :lightblue:`████████`
+``lightblue1``              :lightblue1:`████████`
+``lightblue2``              :lightblue2:`████████`
+``lightblue3``              :lightblue3:`████████`
+``lightblue4``              :lightblue4:`████████`
+``lightcoral``              :lightcoral:`████████`
+``lightcyan``               :lightcyan:`████████`
+``lightcyan1``              :lightcyan1:`████████`
+``lightcyan2``              :lightcyan2:`████████`
+``lightcyan3``              :lightcyan3:`████████`
+``lightcyan4``              :lightcyan4:`████████`
+``lightgoldenrod``          :lightgoldenrod:`████████`
+``lightgoldenrod1``         :lightgoldenrod1:`████████`
+``lightgoldenrod2``         :lightgoldenrod2:`████████`
+``lightgoldenrod3``         :lightgoldenrod3:`████████`
+``lightgoldenrod4``         :lightgoldenrod4:`████████`
+``lightgoldenrodyellow``    :lightgoldenrodyellow:`████████`
+``lightgray``               :lightgray:`████████`
+``lightgreen``              :lightgreen:`████████`
+``lightgrey``               :lightgrey:`████████`
+``lightpink``               :lightpink:`████████`
+``lightpink1``              :lightpink1:`████████`
+``lightpink2``              :lightpink2:`████████`
+``lightpink3``              :lightpink3:`████████`
+``lightpink4``              :lightpink4:`████████`
+``lightsalmon``             :lightsalmon:`████████`
+``lightsalmon1``            :lightsalmon1:`████████`
+``lightsalmon2``            :lightsalmon2:`████████`
+``lightsalmon3``            :lightsalmon3:`████████`
+``lightsalmon4``            :lightsalmon4:`████████`
+``lightseagreen``           :lightseagreen:`████████`
+``lightskyblue``            :lightskyblue:`████████`
+``lightskyblue1``           :lightskyblue1:`████████`
+``lightskyblue2``           :lightskyblue2:`████████`
+``lightskyblue3``           :lightskyblue3:`████████`
+``lightskyblue4``           :lightskyblue4:`████████`
+``lightslateblue``          :lightslateblue:`████████`
+``lightslategray``          :lightslategray:`████████`
+``lightslategrey``          :lightslategrey:`████████`
+``lightsteelblue``          :lightsteelblue:`████████`
+``lightsteelblue1``         :lightsteelblue1:`████████`
+``lightsteelblue2``         :lightsteelblue2:`████████`
+``lightsteelblue3``         :lightsteelblue3:`████████`
+``lightsteelblue4``         :lightsteelblue4:`████████`
+``lightyellow``             :lightyellow:`████████`
+``lightyellow1``            :lightyellow1:`████████`
+``lightyellow2``            :lightyellow2:`████████`
+``lightyellow3``            :lightyellow3:`████████`
+``lightyellow4``            :lightyellow4:`████████`
+``lime``                    :lime:`████████`
+``limegreen``               :limegreen:`████████`
+``linen``                   :linen:`████████`
+``magenta``                 :magenta:`████████`
+``magenta1``                :magenta1:`████████`
+``magenta2``                :magenta2:`████████`
+``magenta3``                :magenta3:`████████`
+``magenta4``                :magenta4:`████████`
+``maroon``                  :maroon:`████████`
+``maroon1``                 :maroon1:`████████`
+``maroon2``                 :maroon2:`████████`
+``maroon3``                 :maroon3:`████████`
+``maroon4``                 :maroon4:`████████`
+``mediumaquamarine``        :mediumaquamarine:`████████`
+``mediumblue``              :mediumblue:`████████`
+``mediumorchid``            :mediumorchid:`████████`
+``mediumorchid1``           :mediumorchid1:`████████`
+``mediumorchid2``           :mediumorchid2:`████████`
+``mediumorchid3``           :mediumorchid3:`████████`
+``mediumorchid4``           :mediumorchid4:`████████`
+``mediumpurple``            :mediumpurple:`████████`
+``mediumpurple1``           :mediumpurple1:`████████`
+``mediumpurple2``           :mediumpurple2:`████████`
+``mediumpurple3``           :mediumpurple3:`████████`
+``mediumpurple4``           :mediumpurple4:`████████`
+``mediumseagreen``          :mediumseagreen:`████████`
+``mediumslateblue``         :mediumslateblue:`████████`
+``mediumspringgreen``       :mediumspringgreen:`████████`
+``mediumturquoise``         :mediumturquoise:`████████`
+``mediumvioletred``         :mediumvioletred:`████████`
+``midnightblue``            :midnightblue:`████████`
+``mintcream``               :mintcream:`████████`
+``mistyrose``               :mistyrose:`████████`
+``mistyrose1``              :mistyrose1:`████████`
+``mistyrose2``              :mistyrose2:`████████`
+``mistyrose3``              :mistyrose3:`████████`
+``mistyrose4``              :mistyrose4:`████████`
+``moccasin``                :moccasin:`████████`
+``navajowhite``             :navajowhite:`████████`
+``navajowhite1``            :navajowhite1:`████████`
+``navajowhite2``            :navajowhite2:`████████`
+``navajowhite3``            :navajowhite3:`████████`
+``navajowhite4``            :navajowhite4:`████████`
+``navy``                    :navy:`████████`
+``navyblue``                :navyblue:`████████`
+``oldlace``                 :oldlace:`████████`
+``olive``                   :olive:`████████`
+``olivedrab``               :olivedrab:`████████`
+``olivedrab1``              :olivedrab1:`████████`
+``olivedrab2``              :olivedrab2:`████████`
+``olivedrab3``              :olivedrab3:`████████`
+``olivedrab4``              :olivedrab4:`████████`
+``orange``                  :orange:`████████`
+``orange1``                 :orange1:`████████`
+``orange2``                 :orange2:`████████`
+``orange3``                 :orange3:`████████`
+``orange4``                 :orange4:`████████`
+``orangered``               :orangered:`████████`
+``orangered1``              :orangered1:`████████`
+``orangered2``              :orangered2:`████████`
+``orangered3``              :orangered3:`████████`
+``orangered4``              :orangered4:`████████`
+``orchid``                  :orchid:`████████`
+``orchid1``                 :orchid1:`████████`
+``orchid2``                 :orchid2:`████████`
+``orchid3``                 :orchid3:`████████`
+``orchid4``                 :orchid4:`████████`
+``palegoldenrod``           :palegoldenrod:`████████`
+``palegreen``               :palegreen:`████████`
+``palegreen1``              :palegreen1:`████████`
+``palegreen2``              :palegreen2:`████████`
+``palegreen3``              :palegreen3:`████████`
+``palegreen4``              :palegreen4:`████████`
+``paleturquoise``           :paleturquoise:`████████`
+``paleturquoise1``          :paleturquoise1:`████████`
+``paleturquoise2``          :paleturquoise2:`████████`
+``paleturquoise3``          :paleturquoise3:`████████`
+``paleturquoise4``          :paleturquoise4:`████████`
+``palevioletred``           :palevioletred:`████████`
+``palevioletred1``          :palevioletred1:`████████`
+``palevioletred2``          :palevioletred2:`████████`
+``palevioletred3``          :palevioletred3:`████████`
+``palevioletred4``          :palevioletred4:`████████`
+``papayawhip``              :papayawhip:`████████`
+``peachpuff``               :peachpuff:`████████`
+``peachpuff1``              :peachpuff1:`████████`
+``peachpuff2``              :peachpuff2:`████████`
+``peachpuff3``              :peachpuff3:`████████`
+``peachpuff4``              :peachpuff4:`████████`
+``peru``                    :peru:`████████`
+``pink``                    :pink:`████████`
+``pink1``                   :pink1:`████████`
+``pink2``                   :pink2:`████████`
+``pink3``                   :pink3:`████████`
+``pink4``                   :pink4:`████████`
+``plum``                    :plum:`████████`
+``plum1``                   :plum1:`████████`
+``plum2``                   :plum2:`████████`
+``plum3``                   :plum3:`████████`
+``plum4``                   :plum4:`████████`
+``powderblue``              :powderblue:`████████`
+``purple``                  :purple:`████████`
+``purple1``                 :purple1:`████████`
+``purple2``                 :purple2:`████████`
+``purple3``                 :purple3:`████████`
+``purple4``                 :purple4:`████████`
+``red``                     :red:`████████`
+``red1``                    :red1:`████████`
+``red2``                    :red2:`████████`
+``red3``                    :red3:`████████`
+``red4``                    :red4:`████████`
+``rosybrown``               :rosybrown:`████████`
+``rosybrown1``              :rosybrown1:`████████`
+``rosybrown2``              :rosybrown2:`████████`
+``rosybrown3``              :rosybrown3:`████████`
+``rosybrown4``              :rosybrown4:`████████`
+``royalblue``               :royalblue:`████████`
+``royalblue1``              :royalblue1:`████████`
+``royalblue2``              :royalblue2:`████████`
+``royalblue3``              :royalblue3:`████████`
+``royalblue4``              :royalblue4:`████████`
+``saddlebrown``             :saddlebrown:`████████`
+``salmon``                  :salmon:`████████`
+``salmon1``                 :salmon1:`████████`
+``salmon2``                 :salmon2:`████████`
+``salmon3``                 :salmon3:`████████`
+``salmon4``                 :salmon4:`████████`
+``sandybrown``              :sandybrown:`████████`
+``seagreen``                :seagreen:`████████`
+``seagreen1``               :seagreen1:`████████`
+``seagreen2``               :seagreen2:`████████`
+``seagreen3``               :seagreen3:`████████`
+``seagreen4``               :seagreen4:`████████`
+``seashell``                :seashell:`████████`
+``seashell1``               :seashell1:`████████`
+``seashell2``               :seashell2:`████████`
+``seashell3``               :seashell3:`████████`
+``seashell4``               :seashell4:`████████`
+``sienna``                  :sienna:`████████`
+``sienna1``                 :sienna1:`████████`
+``sienna2``                 :sienna2:`████████`
+``sienna3``                 :sienna3:`████████`
+``sienna4``                 :sienna4:`████████`
+``silver``                  :silver:`████████`
+``skyblue``                 :skyblue:`████████`
+``skyblue1``                :skyblue1:`████████`
+``skyblue2``                :skyblue2:`████████`
+``skyblue3``                :skyblue3:`████████`
+``skyblue4``                :skyblue4:`████████`
+``slateblue``               :slateblue:`████████`
+``slateblue1``              :slateblue1:`████████`
+``slateblue2``              :slateblue2:`████████`
+``slateblue3``              :slateblue3:`████████`
+``slateblue4``              :slateblue4:`████████`
+``slategray``               :slategray:`████████`
+``slategray1``              :slategray1:`████████`
+``slategray2``              :slategray2:`████████`
+``slategray3``              :slategray3:`████████`
+``slategray4``              :slategray4:`████████`
+``slategrey``               :slategrey:`████████`
+``snow``                    :snow:`████████`
+``snow1``                   :snow1:`████████`
+``snow2``                   :snow2:`████████`
+``snow3``                   :snow3:`████████`
+``snow4``                   :snow4:`████████`
+``springgreen``             :springgreen:`████████`
+``springgreen1``            :springgreen1:`████████`
+``springgreen2``            :springgreen2:`████████`
+``springgreen3``            :springgreen3:`████████`
+``springgreen4``            :springgreen4:`████████`
+``steelblue``               :steelblue:`████████`
+``steelblue1``              :steelblue1:`████████`
+``steelblue2``              :steelblue2:`████████`
+``steelblue3``              :steelblue3:`████████`
+``steelblue4``              :steelblue4:`████████`
+``tan``                     :tan:`████████`
+``tan1``                    :tan1:`████████`
+``tan2``                    :tan2:`████████`
+``tan3``                    :tan3:`████████`
+``tan4``                    :tan4:`████████`
+``teal``                    :teal:`████████`
+``thistle``                 :thistle:`████████`
+``thistle1``                :thistle1:`████████`
+``thistle2``                :thistle2:`████████`
+``thistle3``                :thistle3:`████████`
+``thistle4``                :thistle4:`████████`
+``tomato``                  :tomato:`████████`
+``tomato1``                 :tomato1:`████████`
+``tomato2``                 :tomato2:`████████`
+``tomato3``                 :tomato3:`████████`
+``tomato4``                 :tomato4:`████████`
+``turquoise``               :turquoise:`████████`
+``turquoise1``              :turquoise1:`████████`
+``turquoise2``              :turquoise2:`████████`
+``turquoise3``              :turquoise3:`████████`
+``turquoise4``              :turquoise4:`████████`
+``violet``                  :violet:`████████`
+``violetred``               :violetred:`████████`
+``violetred1``              :violetred1:`████████`
+``violetred2``              :violetred2:`████████`
+``violetred3``              :violetred3:`████████`
+``violetred4``              :violetred4:`████████`
+``wheat``                   :wheat:`████████`
+``wheat1``                  :wheat1:`████████`
+``wheat2``                  :wheat2:`████████`
+``wheat3``                  :wheat3:`████████`
+``wheat4``                  :wheat4:`████████`
+``white``                   :white:`████████`
+``whitesmoke``              :whitesmoke:`████████`
+``yellow``                  :yellow:`████████`
+``yellow1``                 :yellow1:`████████`
+``yellow2``                 :yellow2:`████████`
+``yellow3``                 :yellow3:`████████`
+``yellow4``                 :yellow4:`████████`
+``yellowgreen``             :yellowgreen:`████████`
+==========================  ======================================================================================================
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_sources/ref/cursors.rst.txt b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_sources/ref/cursors.rst.txt
new file mode 100644
index 0000000..6ea68e2
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_sources/ref/cursors.rst.txt
@@ -0,0 +1,251 @@
+.. include:: common.txt
+
+:mod:`pygame.cursors`
+=====================
+
+.. 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)
+
+.. literalinclude:: code_examples/cursors_module_example.py
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_sources/ref/display.rst.txt b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_sources/ref/display.rst.txt
new file mode 100644
index 0000000..ec3bf77
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_sources/ref/display.rst.txt
@@ -0,0 +1,737 @@
+.. include:: common.txt
+
+:mod:`pygame.display`
+=====================
+
+.. 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/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_sources/ref/draw.rst.txt b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_sources/ref/draw.rst.txt
new file mode 100644
index 0000000..a759860
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_sources/ref/draw.rst.txt
@@ -0,0 +1,557 @@
+.. include:: common.txt
+
+:mod:`pygame.draw`
+==================
+
+.. 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
+
+   Example code for draw module.
+
+.. literalinclude:: code_examples/draw_module_example.py
+
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_sources/ref/event.rst.txt b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_sources/ref/event.rst.txt
new file mode 100644
index 0000000..aa5b7e7
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_sources/ref/event.rst.txt
@@ -0,0 +1,565 @@
+.. include:: common.txt
+
+:mod:`pygame.event`
+===================
+
+.. module:: pygame.event
+   :synopsis: pygame module for interacting with events and queues
+
+| :sl:`pygame module for interacting with events and queues`
+
+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 :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 ``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`. 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 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. 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.
+
+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.
+
+While debugging and experimenting, you can print an event object for a quick
+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 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.
+
+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.
+
+|
+
+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
+
+.. 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
+   WINDOWRESIZED          Window got resized
+   WINDOWSIZECHANGED      Window changed its size
+   WINDOWMINIMIZED        Window was minimized
+   WINDOWMAXIMIZED        Window was maximized
+   WINDOWRESTORED         Window was restored
+   WINDOWENTER            Mouse entered the window
+   WINDOWLEAVE            Mouse left the window
+   WINDOWFOCUSGAINED      Window gained focus
+   WINDOWFOCUSLOST        Window lost focus
+   WINDOWCLOSE            Window was closed
+   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
+
+::
+
+   Event type                 Short description
+
+   APP_TERMINATING           OS is terminating the application
+   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
+
+.. versionadded:: 2.1.3
+
+|
+
+.. function:: pump
+
+   | :sl:`internally process pygame event handlers`
+   | :sg:`pump() -> None`
+
+   For each frame of your game, you will need to make some sort of call to the
+   event queue. This ensures your program can internally interact with the rest
+   of the operating system. If you are not using other event functions in your
+   game, you should call ``pygame.event.pump()`` to allow pygame to handle
+   internal actions.
+
+   This function is not necessary if your program is consistently processing
+   events on the queue through the other :mod:`pygame.event` functions.
+
+   There are important things that must be dealt with internally in the event
+   queue. The main window may need to be repainted or respond to the system. If
+   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 :mod:`pygame.display`.
+
+   .. ## pygame.event.pump ##
+
+.. function:: get
+
+   | :sl:`get events from the queue`
+   | :sg:`get(eventtype=None) -> Eventlist`
+   | :sg:`get(eventtype=None, pump=True) -> Eventlist`
+   | :sg:`get(eventtype=None, pump=True, exclude=None) -> Eventlist`
+
+   This will get all the messages and remove them from the queue. If a type or
+   sequence of types is given only those messages will be removed from the
+   queue and returned.
+
+   If a type or sequence of types is passed in the ``exclude`` argument
+   instead, then all only *other* messages will be removed from the queue. If
+   an ``exclude`` parameter is passed, the ``eventtype`` parameter *must* be
+   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 :func:`pygame.event.pump()` will be called.
+
+   .. versionchanged:: 1.9.5 Added ``pump`` argument
+   .. versionchanged:: 2.0.2 Added ``exclude`` argument
+
+   .. ## pygame.event.get ##
+
+.. function:: poll
+
+   | :sl:`get a single event from the queue`
+   | :sg:`poll() -> Event instance`
+
+   Returns a single event from the queue. If the event queue is empty an event
+   of type ``pygame.NOEVENT`` will be returned immediately. The returned event
+   is removed from the queue.
+
+   .. caution::
+      This function should only be called in the thread that initialized :mod:`pygame.display`.
+
+   .. ## pygame.event.poll ##
+
+.. function:: wait
+
+   | :sl:`wait for a single event from the queue`
+   | :sg:`wait() -> Event instance`
+   | :sg:`wait(timeout) -> Event instance`
+
+   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`` 
+   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.
+
+   .. versionchanged:: 2.0.0.dev13 Added ``timeout`` argument
+
+   .. caution::
+      This function should only be called in the thread that initialized :mod:`pygame.display`.
+
+   .. ## pygame.event.wait ##
+
+.. function:: peek
+
+   | :sl:`test if event types are waiting on the queue`
+   | :sg:`peek(eventtype=None) -> bool`
+   | :sg:`peek(eventtype=None, pump=True) -> bool`
+
+   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.
+
+   If ``pump`` is ``True`` (the default), then :func:`pygame.event.pump()` will be called.
+
+   .. versionchanged:: 1.9.5 Added ``pump`` argument
+
+   .. ## pygame.event.peek ##
+
+.. function:: clear
+
+   | :sl:`remove all events from the queue`
+   | :sg:`clear(eventtype=None) -> None`
+   | :sg:`clear(eventtype=None, pump=True) -> None`
+
+   Removes all events from the queue. If ``eventtype`` is given, removes the given event
+   or sequence of events. This has the same effect as :func:`pygame.event.get()` except ``None``
+   is returned. It can be slightly more efficient when clearing a full event queue.
+
+   If ``pump`` is ``True`` (the default), then :func:`pygame.event.pump()` will be called.
+
+   .. 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`
+
+   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.
+
+   .. versionchanged:: 2.5.0 Added support for keyword arguments.
+   .. ## pygame.event.event_name ##
+
+
+.. function:: set_blocked
+
+   | :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
+   default all events can be placed on the queue. It is safe to disable an
+   event type multiple times.
+
+   If ``None`` is passed as the argument, ALL of the event types are blocked
+   from being placed on the queue.
+
+   .. ## pygame.event.set_blocked ##
+
+.. 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(None) -> None`
+
+   The given event types are allowed to appear on the event queue. By default,
+   all event types can be placed on the queue. It is safe to enable an event
+   type multiple times.
+
+   If ``None`` is passed as the argument, ALL of the event types are allowed
+   to be placed on the queue.
+
+   .. ## pygame.event.set_allowed ##
+
+.. 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`
+
+   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
+   event types are blocked.
+
+   .. ## pygame.event.get_blocked ##
+
+.. function:: set_grab
+
+   | :sl:`control the sharing of input devices with other applications`
+   | :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
+   program sets the event grab to ``True``, it will lock all input into your
+   program.
+
+   It is best to not always grab the input, since it prevents the user from
+   doing other things on their system.
+
+   .. ## pygame.event.set_grab ##
+
+.. function:: get_grab
+
+   | :sl:`test if the program is sharing input devices`
+   | :sg:`get_grab() -> bool`
+
+   Returns ``True`` when the input events are grabbed for this application.
+
+   .. ## 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`
+
+   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.
+
+   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.
+
+   .. versionchanged:: 2.0.1 returns a boolean, previously returned ``None``
+
+   .. ## pygame.event.post ##
+
+.. function:: custom_type
+
+   | :sl:`make custom user event type`
+   | :sg:`custom_type() -> int`
+
+   Reserves a ``pygame.USEREVENT`` for a custom use.
+
+   If too many events are made a :exc:`pygame.error` is raised.
+
+   .. versionadded:: 2.0.0.dev3
+
+   .. ## pygame.event.custom_type ##
+
+.. class:: Event
+
+   | :sl:`pygame object for representing events`
+   | :sg:`Event(type, dict) -> Event`
+   | :sg:`Event(type, \**attributes) -> Event`
+
+   A pygame object used for representing an event. ``Event`` instances
+   support attribute assignment and deletion.
+
+   When creating the object, the attributes may come from a dictionary
+   argument with string keys or from keyword arguments.
+
+   .. note::
+      From version 2.1.3 ``EventType`` is an alias for ``Event``. Beforehand,
+      ``Event`` was a function that returned ``EventType`` instances. Use of
+      ``Event`` is preferred over ``EventType`` wherever it is possible, as
+      the latter could be deprecated in a future version.
+
+   .. attribute:: type
+
+      | :sl:`event type identifier.`
+      | :sg:`type -> int`
+
+      Read-only. The event type identifier. For user created event
+      objects, this is the ``type`` argument passed to
+      :func:`pygame.event.Event()`.
+
+      For example, some predefined event identifiers are ``QUIT`` and
+      ``MOUSEMOTION``.
+
+      .. ## pygame.event.Event.type ##
+
+   .. attribute:: __dict__
+
+      | :sl:`event attribute dictionary`
+      | :sg:`__dict__ -> dict`
+
+      Read-only. The event type specific attributes of an event. The
+      ``dict`` attribute is a synonym for backward compatibility.
+
+      For example, the attributes of a ``KEYDOWN`` event would be ``unicode``,
+      ``key``, and ``mod``
+
+      .. ## pygame.event.Event.__dict__ ##
+
+   .. versionadded:: 1.9.2 Mutable attributes.
+
+   .. ## pygame.event.Event ##
+
+.. ## pygame.event ##
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_sources/ref/examples.rst.txt b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_sources/ref/examples.rst.txt
new file mode 100644
index 0000000..000ea76
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_sources/ref/examples.rst.txt
@@ -0,0 +1,451 @@
+.. include:: common.txt
+
+:mod:`pygame.examples`
+======================
+
+.. module:: pygame.examples
+   :synopsis: module of example programs
+
+| :sl:`module of example programs`
+
+These examples should help get you started with pygame. Here is a brief rundown
+of what you get. The source code for these examples is in the public domain.
+Feel free to use for your own projects.
+
+There are several ways to run the examples. First they can be run as
+stand-alone programs. Second they can be imported and their ``main()`` methods
+called (see below). Finally, the easiest way is to use the python -m option:
+
+::
+
+   python -m pygame.examples. 
+
+eg:
+
+::
+
+   python -m pygame.examples.scaletest someimage.png
+
+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
+commands inside the python interpreter.
+
+::
+
+   >>> import pygame.examples.scaletest
+   >>> pygame.examples.scaletest.__file__
+   '/usr/lib/python2.6/site-packages/pygame/examples/scaletest.py'
+
+On each OS and version of Python the location will be slightly different.
+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
+   >>> pygame.examples.scaletest.main()
+
+
+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.
+
+examples as a package is new to pygame 1.9.0. But most of the examples came with
+pygame much earlier.
+
+.. function:: aliens.main
+
+   | :sl:`play the full aliens example`
+   | :sg:`aliens.main() -> None`
+
+   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)
+
+   .. ## pygame.examples.aliens.main ##
+
+.. function:: stars.main
+
+   | :sl:`run a simple starfield example`
+   | :sg:`stars.main() -> None`
+
+   A simple starfield example. You can change the center of perspective by
+   leftclicking the mouse on the screen.
+
+   .. ## pygame.examples.stars.main ##
+
+.. function:: chimp.main
+
+   | :sl:`hit the moving chimp`
+   | :sg:`chimp.main() -> None`
+
+   This simple example is derived from 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.
+
+   .. ## pygame.examples.chimp.main ##
+
+.. function:: moveit.main
+
+   | :sl:`display animated objects on the screen`
+   | :sg:`moveit.main() -> None`
+
+   This is the full and final example from the Pygame Tutorial, "How Do I Make
+   It Move". It creates 10 objects and animates them on the screen.
+
+   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.
+
+   .. ## pygame.examples.moveit.main ##
+
+.. function:: fonty.main
+
+   | :sl:`run a font rendering example`
+   | :sg:`fonty.main() -> None`
+
+   Super quick, super simple application demonstrating the different ways to
+   render fonts with the font module
+
+   .. ## pygame.examples.fonty.main ##
+
+.. function:: freetype_misc.main
+
+   | :sl:`run a FreeType rendering example`
+   | :sg:`freetype_misc.main() -> None`
+
+   A showcase of rendering features the :class:`pygame.freetype.Font`
+   class provides in addition to those available with :class:`pygame.font.Font`.
+   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.
+
+   .. ## pygame.examples.fonty.main ##
+
+.. function:: vgrade.main
+
+   | :sl:`display a vertical gradient`
+   | :sg:`vgrade.main() -> None`
+
+   Demonstrates creating a vertical gradient with pixelcopy and NumPy python.
+   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 :]
+
+   .. ## pygame.examples.vgrade.main ##
+
+.. function:: eventlist.main
+
+   | :sl:`display pygame events`
+   | :sg:`eventlist.main() -> None`
+
+   Eventlist is a sloppy style of pygame, but is a handy tool for learning
+   about pygame events and input. At the top of the screen are the state of
+   several device values, and a scrolling list of events are displayed on the
+   bottom.
+
+   This is not quality 'ui' code at all, but you can see how to implement very
+   non-interactive status displays, or even a crude text output control.
+
+   .. ## pygame.examples.eventlist.main ##
+
+.. function:: arraydemo.main
+
+   | :sl:`show various surfarray effects`
+   | :sg:`arraydemo.main(arraytype=None) -> None`
+
+   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
+
+   The ``arraytype`` parameter is deprecated; passing any value besides 'numpy'
+   will raise ValueError.
+
+   .. ## pygame.examples.arraydemo.main ##
+
+.. function:: sound.main
+
+   | :sl:`load and play a sound`
+   | :sg:`sound.main(file_path=None) -> None`
+
+   Extremely basic testing of the mixer module. Load a sound and play it. All
+   from the command shell, no graphics.
+
+   If provided, use the audio file 'file_path', otherwise use a default file.
+
+   ``sound.py`` optional command line argument: an audio file
+
+   .. ## pygame.examples.sound.main ##
+
+.. function:: sound_array_demos.main
+
+   | :sl:`play various sndarray effects`
+   | :sg:`sound_array_demos.main(arraytype=None) -> None`
+
+
+   Uses sndarray and NumPy to create offset faded copies of the
+   original sound. Currently it just uses hardcoded values for the number of
+   echoes and the delay. Easy for you to recreate as needed.
+
+   The ``arraytype`` parameter is deprecated; passing any value besides 'numpy'
+   will raise ValueError.
+
+   .. ## pygame.examples.sound_array_demos.main ##
+
+.. function:: liquid.main
+
+   | :sl:`display an animated liquid effect`
+   | :sg:`liquid.main() -> None`
+
+   This example was created in a quick comparison with the BlitzBasic gaming
+   language. Nonetheless, it demonstrates a quick 8-bit setup (with colormap).
+
+   .. ## pygame.examples.liquid.main ##
+
+.. function:: glcube.main
+
+   | :sl:`display an animated 3D cube using OpenGL`
+   | :sg:`glcube.main() -> None`
+
+   Using PyOpenGL and pygame, this creates a spinning 3D multicolored cube.
+
+   .. ## pygame.examples.glcube.main ##
+
+.. function:: scrap_clipboard.main
+
+   | :sl:`access the clipboard`
+   | :sg:`scrap_clipboard.main() -> None`
+
+   A simple demonstration example for the clipboard support.
+
+   .. ## pygame.examples.scrap_clipboard.main ##
+
+.. function:: mask.main
+
+   | :sl:`display multiple images bounce off each other using collision detection`
+   | :sg:`mask.main(*args) -> None`
+
+   Positional arguments:
+
+   ::
+
+       one or more image file names.
+
+   This ``pygame.masks`` demo will display multiple moving sprites bouncing off
+   each other. More than one sprite image can be provided.
+
+   If run as a program then ``mask.py`` takes one or more image files as
+   command line arguments.
+
+   .. ## pygame.examples.mask.main ##
+
+.. function:: testsprite.main
+
+   | :sl:`show lots of sprites moving around`
+   | :sg:`testsprite.main(update_rects = True, use_static = False, use_FastRenderGroup = False, screen_dims = [640, 480], use_alpha = False, flags = 0) -> None`
+
+   Optional keyword arguments:
+
+   ::
+
+       update_rects - use the RenderUpdate sprite group class
+       use_static - include non-moving images
+       use_FastRenderGroup - Use the FastRenderGroup sprite group
+       screen_dims - pygame window dimensions
+       use_alpha - use alpha blending
+       flags - additional display mode flags
+
+   Like the ``testsprite.c`` that comes with SDL, this pygame version shows
+   lots of sprites moving around.
+
+   If run as a stand-alone program then no command line arguments are taken.
+
+   .. ## pygame.examples.testsprite.main ##
+
+.. function:: headless_no_windows_needed.main
+
+   | :sl:`write an image file that is smoothscaled copy of an input file`
+   | :sg:`headless_no_windows_needed.main(fin, fout, w, h) -> None`
+
+   arguments:
+
+   ::
+
+       fin - name of an input image file
+       fout - name of the output file to create/overwrite
+       w, h - size of the rescaled image, as integer width and height
+
+   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.
+
+   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
+       eg. -scale in.png outpng 50 50
+
+   .. ## pygame.examples.headless_no_windows_needed.main ##
+
+.. function:: joystick.main
+
+   | :sl:`demonstrate joystick functionality`
+   | :sg:`joystick.main() -> None`
+
+   A demo showing full joystick support.
+
+   .. versionadded:: 2.0.2
+
+   .. ## pygame.examples.joystick.main ##
+
+.. function:: blend_fill.main
+
+   | :sl:`demonstrate the various surface.fill method blend options`
+   | :sg:`blend_fill.main() -> None`
+
+   A interactive demo that lets one choose which BLEND_xxx option to apply to a
+   surface.
+
+   .. ## pygame.examples.blend_fill.main ##
+
+.. function:: blit_blends.main
+
+   | :sl:`uses alternative additive fill to that of surface.fill`
+   | :sg:`blit_blends.main() -> None`
+
+   Fake additive blending. Using NumPy. it doesn't clamp. Press r,g,b Somewhat
+   like blend_fill.
+
+   .. ## pygame.examples.blit_blends.main ##
+
+.. function:: cursors.main
+
+   | :sl:`display two different custom cursors`
+   | :sg:`cursors.main() -> None`
+
+   Display an arrow or circle with crossbar cursor.
+
+   .. ## pygame.examples.cursors.main ##
+
+.. function:: pixelarray.main
+
+   | :sl:`display various pixelarray generated effects`
+   | :sg:`pixelarray.main() -> None`
+
+   Display various pixelarray generated effects.
+
+   .. ## pygame.examples.pixelarray.main ##
+
+.. function:: scaletest.main
+
+   | :sl:`interactively scale an image using smoothscale`
+   | :sg:`scaletest.main(imagefile, convert_alpha=False, run_speed_test=True) -> None`
+
+   arguments:
+
+   ::
+
+       imagefile - file name of source image (required)
+       convert_alpha - use convert_alpha() on the surf (default False)
+       run_speed_test - (default False)
+
+   A smoothscale example that resized an image on the screen. Vertical and
+   horizontal arrow keys are used to change the width and height of the
+   displayed image. If the convert_alpha option is True then the source image
+   is forced to have source alpha, whether or not the original images does. If
+   run_speed_test is True then a background timing test is performed instead of
+   the interactive scaler.
+
+   If ``scaletest.py`` is run as a program then the command line options are:
+
+   ::
+
+       ImageFile [-t] [-convert_alpha]
+       [-t] = Run Speed Test
+       [-convert_alpha] = Use convert_alpha() on the surf.
+
+   .. ## pygame.examples.scaletest.main ##
+
+.. function:: midi.main
+
+   | :sl:`run a midi example`
+   | :sg:`midi.main(mode='output', device_id=None) -> None`
+
+   Arguments:
+
+   ::
+
+       mode - if 'output' run a midi keyboard output example
+                 'input' run a midi event logger input example
+                 'list' list available midi devices
+              (default 'output')
+       device_id - midi device number; if None then use the default midi input or
+                   output device for the system
+
+   The output example shows how to translate mouse clicks or computer keyboard
+   events into midi notes. It implements a rudimentary button widget and state
+   machine.
+
+   The input example shows how to translate midi input to pygame events.
+
+   With the use of a virtual midi patch cord the output and input examples can
+   be run as separate processes and connected so the keyboard output is
+   displayed on a console.
+
+   new to pygame 1.9.0
+
+   .. ## pygame.examples.midi.main ##
+
+.. function:: scroll.main
+
+   | :sl:`run a Surface.scroll example that shows a magnified image`
+   | :sg:`scroll.main(image_file=None) -> None`
+
+   This example shows a scrollable image that has a zoom factor of eight. It
+   uses the :meth:`Surface.scroll() `
+   function to shift the image on the display surface.
+   A clip rectangle protects a margin area. If called as a function,
+   the example accepts an optional image file path. If run as a program it
+   takes an optional file path command line argument. If no file is provided a
+   default image file is used.
+
+   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.
+
+   .. ## pygame.examples.scroll.main ##
+
+.. function:: camera.main
+
+   | :sl:`display video captured live from an attached camera`
+   | :sg:`camera.main() -> None`
+
+   A simple live video player, it uses the first available camera it finds on
+   the system.
+
+   .. ## pygame.examples.camera.main ##
+
+.. function:: playmus.main
+
+   | :sl:`play an audio file`
+   | :sg:`playmus.main(file_path) -> None`
+
+   A simple music player with window and keyboard playback control. Playback can
+   be paused and rewound to the beginning.
+
+   .. ## pygame.examples.playmus.main ##
+
+.. ## pygame.examples ##
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_sources/ref/fastevent.rst.txt b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_sources/ref/fastevent.rst.txt
new file mode 100644
index 0000000..a2efe5f
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_sources/ref/fastevent.rst.txt
@@ -0,0 +1,109 @@
+.. include:: common.txt
+
+:mod:`pygame.fastevent`
+=======================
+
+.. module:: pygame.fastevent
+   :synopsis: pygame module for interacting with events and queues from multiple
+              threads.
+
+| :sl:`pygame module for interacting with events and queues`
+
+IMPORTANT NOTE: THIS MODULE IS DEPRECATED IN PYGAME 2.2
+
+In older pygame versions before pygame 2, :mod:`pygame.event` was not well
+suited for posting events from different threads. This module served as a
+replacement (with less features) for multithreaded use. Now, the usage of this
+module is highly discouraged in favour of use of the main :mod:`pygame.event`
+module. This module will be removed in a future pygame version.
+
+Below, the legacy docs of the module is provided
+
+.. function:: init
+
+   | :sl:`initialize pygame.fastevent`
+   | :sg:`init() -> None`
+
+   Initialize the pygame.fastevent module.
+
+   .. ## pygame.fastevent.init ##
+
+.. function:: get_init
+
+   | :sl:`returns True if the fastevent module is currently initialized`
+   | :sg:`get_init() -> bool`
+
+   Returns True if the pygame.fastevent module is currently initialized.
+
+   .. ## pygame.fastevent.get_init ##
+
+.. function:: pump
+
+   | :sl:`internally process pygame event handlers`
+   | :sg:`pump() -> None`
+
+   For each frame of your game, you will need to make some sort of call to the
+   event queue. This ensures your program can internally interact with the rest
+   of the operating system.
+
+   This function is not necessary if your program is consistently processing
+   events on the queue through the other :mod:`pygame.fastevent` functions.
+
+   There are important things that must be dealt with internally in the event
+   queue. The main window may need to be repainted or respond to the system. If
+   you fail to make a call to the event queue for too long, the system may
+   decide your program has locked up.
+
+   .. ## pygame.fastevent.pump ##
+
+.. function:: wait
+
+   | :sl:`wait for an event`
+   | :sg:`wait() -> Event`
+
+   Returns the current event on the queue. If there are no messages
+   waiting on the queue, this will not return until one is available.
+   Sometimes it is important to use this wait to get events from the queue,
+   it will allow your application to idle when the user isn't doing anything
+   with it.
+
+   .. ## pygame.fastevent.wait ##
+
+.. function:: poll
+
+   | :sl:`get an available event`
+   | :sg:`poll() -> Event`
+
+   Returns next event on queue. If there is no event waiting on the queue,
+   this will return an event with type NOEVENT.
+
+   .. ## pygame.fastevent.poll ##
+
+.. function:: get
+
+   | :sl:`get all events from the queue`
+   | :sg:`get() -> list of Events`
+
+   This will get all the messages and remove them from the queue.
+
+   .. ## pygame.fastevent.get ##
+
+.. function:: post
+
+   | :sl:`place an event on the queue`
+   | :sg:`post(Event) -> None`
+
+   This will post your own event objects onto the event queue. You can post
+   any event type you want, but some care must be taken. For example, if you
+   post a MOUSEBUTTONDOWN event to the queue, it is likely any code receiving
+   the event will expect the standard MOUSEBUTTONDOWN attributes to be
+   available, like 'pos' and 'button'.
+
+   Because pygame.fastevent.post() may have to wait for the queue to empty,
+   you can get into a dead lock if you try to append an event on to a full
+   queue from the thread that processes events. For that reason I do not
+   recommend using this function in the main thread of an SDL program.
+
+   .. ## pygame.fastevent.post ##
+
+.. ## pygame.fastevent ##
\ No newline at end of file
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_sources/ref/font.rst.txt b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_sources/ref/font.rst.txt
new file mode 100644
index 0000000..9f09a8b
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_sources/ref/font.rst.txt
@@ -0,0 +1,499 @@
+.. include:: common.txt
+
+:mod:`pygame.font`
+==================
+
+.. module:: pygame.font
+   :synopsis: pygame module for loading and rendering fonts
+
+| :sl:`pygame module for loading and rendering fonts`
+
+The font module allows for rendering TrueType fonts into Surface objects.
+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 :func:`pygame.font.Font`.
+
+You can load fonts from the system by using the :func:`pygame.font.SysFont`
+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.
+
+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 
+(like emojis, if the font has them) ('\\U00000001' to '\\U0010FFFF')).
+More about this in :func:`Font.render`.
+
+Before pygame 2.0.3, this character space restriction can be avoided by
+using the  :mod:`pygame.freetype` based ``pygame.ftfont`` to emulate the Font
+module. This can be used by defining the environment variable PYGAME_FREETYPE
+before the first import of :mod:`pygame`. Since the problem ``pygame.ftfont``
+solves no longer exists, it will likely be removed in the future.
+
+.. function:: init
+
+   | :sl:`initialize the font module`
+   | :sg:`init() -> None`
+
+   This method is called automatically by ``pygame.init()``. It initializes the
+   font module. The module must be initialized before any other functions will
+   work.
+
+   It is safe to call this function more than once.
+
+   .. ## pygame.font.init ##
+
+.. function:: quit
+
+   | :sl:`uninitialize the font module`
+   | :sg:`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.
+
+   .. ## pygame.font.quit ##
+
+.. function:: get_init
+
+   | :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 ##
+
+.. function:: get_default_font
+
+   | :sl:`get the filename of the default font`
+   | :sg:`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
+   module, but it can also be bundled in separate archives.
+
+   .. ## 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`
+   | :sg:`SysFont(name, size, bold=False, italic=False) -> Font`
+
+   Return a new Font object that is loaded from the system fonts. The font will
+   match the requested bold and italic flags. 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 a suitable system font is not found 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.
+
+   .. 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.
+
+   .. ## pygame.font.SysFont ##
+
+.. class:: 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`
+
+   Load a new font from a given filename or a python file object. The size is
+   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. 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.
+
+   .. attribute:: bold
+
+      | :sl:`Gets or sets whether the font should be rendered in (faked) bold.`
+      | :sg:`bold -> bool`
+
+      Whether the font should be rendered in bold.
+
+      When set to True, this 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.
+
+      .. versionadded:: 2.0.0
+
+      .. ## Font.bold ##
+
+   .. attribute:: italic
+
+      | :sl:`Gets or sets whether the font should be rendered in (faked) italics.`
+      | :sg:`italic -> bool`
+
+      Whether the font should be rendered in italic.
+
+      When set to True, this 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.
+
+      .. versionadded:: 2.0.0
+
+      .. ## Font.italic ##
+
+   .. attribute:: underline
+
+      | :sl:`Gets or sets whether the font should be rendered with an underline.`
+      | :sg:`underline -> bool`
+
+      Whether the font should be rendered in underline.
+
+      When set to True, 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.
+
+      .. versionadded:: 2.0.0
+
+      .. ## Font.underline ##
+   
+   .. attribute:: strikethrough
+
+      | :sl:`Gets or sets whether the font should be rendered with a strikethrough.`
+      | :sg:`strikethrough -> bool`
+
+      Whether the font should be rendered with a strikethrough.
+
+      When set to True, all rendered fonts will include an
+      strikethrough. The strikethrough is always one pixel thick,
+      regardless of font size. This can be mixed with the bold,
+      italic and underline modes.
+
+      .. versionadded:: 2.1.3
+
+      .. ## Font.strikethrough ##
+
+   .. method:: render
+
+      | :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. 
+      :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
+      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 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
+      for the text, a blank surface will be returned that is zero pixel wide and
+      the height of the font.
+
+      Depending on the type of background and antialiasing used, this returns
+      different types of Surfaces. For performance reasons, it is good to know
+      what type of image will be used. If antialiasing is not used, the return
+      image will always be an 8-bit image with a two-color palette. If the
+      background is transparent a colorkey will be set. Antialiased images are
+      rendered to 24-bit ``RGB`` images. If the background is transparent a
+      pixel alpha will be included.
+
+      Optimization: if you know that the final destination for the text (on the
+      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.
+
+      .. 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.
+
+      .. ## Font.render ##
+
+   .. method:: size
+
+      | :sl:`determine the amount of space needed to render text`
+      | :sg:`size(text) -> (width, height)`
+
+      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".
+
+      .. ## Font.size ##
+
+   .. method:: set_underline
+
+      | :sl:`control if text is rendered with an underline`
+      | :sg:`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
+      with the bold, italic and strikethrough modes.
+
+      .. note:: This is the same as the :attr:`underline` attribute.
+
+      .. ## Font.set_underline ##
+
+   .. method:: get_underline
+
+      | :sl:`check if text will be rendered with an underline`
+      | :sg:`get_underline() -> bool`
+
+      Return True when the font underline is enabled.
+
+       .. note:: This is the same as the :attr:`underline` attribute.
+
+      .. ## Font.get_underline ##
+   
+   .. method:: set_strikethrough
+
+      | :sl:`control if text is rendered with a strikethrough`
+      | :sg:`set_strikethrough(bool) -> None`
+
+      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
+
+      .. ## 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 ##
+
+.. ## pygame.font ##
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_sources/ref/freetype.rst.txt b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_sources/ref/freetype.rst.txt
new file mode 100644
index 0000000..0f282ac
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_sources/ref/freetype.rst.txt
@@ -0,0 +1,770 @@
+.. include:: common.txt
+
+:mod:`pygame.freetype`
+======================
+
+.. module:: pygame.freetype
+   :synopsis: Enhanced pygame module for loading and rendering computer fonts
+
+| :sl:`Enhanced pygame module for loading and rendering computer fonts`
+
+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,
+``SFNT``, ``PCF``, ``FNT``, ``BDF``, ``PFR`` and Type42 fonts.
+All glyphs having UTF-32 code points are accessible
+(see :attr:`Font.ucs4`).
+
+Most work on fonts is done using :class:`Font` instances.
+The module itself only has routines for initialization and creation
+of :class:`Font` objects.
+You can load fonts from the system using the :func:`SysFont` function.
+
+Extra support of bitmap fonts is available. Available bitmap sizes can
+be listed (see :meth:`Font.get_sizes`). For bitmap only fonts :class:`Font`
+can set the size for you (see the :attr:`Font.size` property).
+
+For now undefined character codes are replaced with the ``.notdef``
+(not defined) character.
+How undefined codes are handled may become configurable in a future release.
+
+Pygame comes with a built-in default font. This can always be accessed by
+passing None as the font name to the :class:`Font` constructor.
+
+Extra rendering features available to :class:`pygame.freetype.Font`
+are direct to surface rendering (see :meth:`Font.render_to`), character kerning
+(see :attr:`Font.kerning`), vertical layout (see :attr:`Font.vertical`),
+rotation of rendered text (see :attr:`Font.rotation`),
+and the strong style (see :attr:`Font.strong`).
+Some properties are configurable, such as
+strong style strength (see :attr:`Font.strength`) and underline positioning
+(see :attr:`Font.underline_adjustment`). Text can be positioned by the upper
+right corner of the text box or by the text baseline (see :attr:`Font.origin`).
+Finally, a font's vertical and horizontal size can be adjusted separately
+(see :attr:`Font.size`).
+The :any:`pygame.examples.freetype_misc `
+example shows these features in use.
+
+The pygame package does not import ``freetype`` automatically when
+loaded. This module must be imported explicitly to be used. ::
+
+   import pygame
+   import pygame.freetype
+
+.. versionadded:: 1.9.2 :mod:`freetype`
+
+
+.. function:: get_error
+
+   | :sl:`Return the latest FreeType error`
+   | :sg:`get_error() -> str`
+   | :sg:`get_error() -> None`
+
+   Return a description of the last error which occurred in the FreeType2
+   library, or ``None`` if no errors have occurred.
+
+.. function:: get_version
+
+   | :sl:`Return the FreeType version`
+   | :sg:`get_version(linked=True) -> (int, int, int)`
+
+   Returns the version of the FreeType library in use by this module. ``linked=True``
+   is the default behavior and returns the linked version of FreeType and ``linked=False``
+   returns the compiled version of FreeType.
+
+   Note that the ``freetype`` module depends on the FreeType 2 library.
+   It will not compile with the original FreeType 1.0. Hence, the first element
+   of the tuple will always be "2".
+
+   .. versionchanged:: 2.2.0 ``linked`` keyword argument added and default behavior changed from returning compiled version to returning linked version
+
+.. function:: init
+
+   | :sl:`Initialize the underlying FreeType library.`
+   | :sg:`init(cache_size=64, resolution=72) -> None`
+
+   This function initializes the underlying FreeType library and must be
+   called before trying to use any of the functionality of the ``freetype``
+   module.
+
+   However, :func:`pygame.init()` will automatically call this function
+   if the ``freetype`` module is already imported. It is safe to call this
+   function more than once.
+
+   Optionally, you may specify a default *cache_size* for the Glyph cache: the
+   maximum number of glyphs that will be cached at any given time by the
+   module. Exceedingly small values will be automatically tuned for
+   performance. Also a default pixel *resolution*, in dots per inch, can
+   be given to adjust font scaling.
+
+.. function:: quit
+
+   | :sl:`Shut down the underlying FreeType library.`
+   | :sg:`quit() -> None`
+
+   This function closes the ``freetype`` module. After calling this
+   function, you should not invoke any class, method or function related to the
+   ``freetype`` module as they are likely to fail or might give unpredictable
+   results. It is safe to call this function even if the module hasn't been
+   initialized yet.
+
+.. function:: get_init
+
+   | :sl:`Returns True if the FreeType module is currently initialized.`
+   | :sg:`get_init() -> bool`
+
+   Returns ``True`` if the ``pygame.freetype`` module is currently initialized.
+
+   .. versionadded:: 1.9.5
+
+.. function:: was_init
+
+   | :sl:`DEPRECATED: Use get_init() instead.`
+   | :sg:`was_init() -> bool`
+
+   DEPRECATED: Returns ``True`` if the ``pygame.freetype`` module is currently
+   initialized. Use ``get_init()`` instead.
+
+.. function:: get_cache_size
+
+   | :sl:`Return the glyph case size`
+   | :sg:`get_cache_size() -> long`
+
+   See :func:`pygame.freetype.init()`.
+
+.. function:: get_default_resolution
+
+   | :sl:`Return the default pixel size in dots per inch`
+   | :sg:`get_default_resolution() -> long`
+
+   Returns the default pixel size, in dots per inch, for the module.
+   The default is 72 DPI.
+
+.. function:: set_default_resolution
+
+   | :sl:`Set the default pixel size in dots per inch for the module`
+   | :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.
+
+.. function:: SysFont
+
+   | :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
+   match the requested *bold* and *italic* flags. 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 a suitable system font is not found
+   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.
+
+   .. versionadded:: 2.0.1 Accept an iterable of font names.
+
+.. function:: get_default_font
+
+   | :sl:`Get the filename of the default font`
+   | :sg:`get_default_font() -> string`
+
+   Return the filename of the default pygame font. This is not the full path
+   to the file. The file is usually in the same directory as the font module,
+   but can also be bundled in a separate archive.
+
+.. class:: Font
+
+   | :sl:`Create a new Font instance from a supported font file.`
+   | :sg:`Font(file, size=0, font_index=0, resolution=0, ucs4=False) -> Font`
+   | :sg:`Font(pathlib.Path) -> Font`
+
+   Argument *file* can be either a string representing the font's filename, a
+   file-like object containing the font, or None; if None, a default,
+   Pygame, font is used.
+
+   .. _freetype-font-size-argument:
+
+   Optionally, a *size* argument may be specified to set the default size in
+   points, which determines the size of the rendered characters.
+   The size can also be passed explicitly to each method call.
+   Because of the way the caching   system works, specifying a default size on
+   the constructor doesn't imply a performance gain over manually passing
+   the size on each function call. If the font is bitmap and no *size*
+   is given, the default size is set to the first available size for the font.
+
+   If the font file has more than one font, the font to load can be chosen with
+   the *index* argument. An exception is raised for an out-of-range font index
+   value.
+
+   The optional *resolution* argument sets the pixel size, in dots per inch,
+   for use in scaling glyphs for this Font instance. If 0 then the default
+   module value, set by :func:`init`, is used. The Font object's
+   resolution can only be changed by re-initializing the Font instance.
+
+   The optional *ucs4* argument, an integer, sets the default text translation
+   mode: 0 (False) recognize UTF-16 surrogate pairs, any other value (True),
+   to treat Unicode text as UCS-4, with no surrogate pairs. See
+   :attr:`Font.ucs4`.
+
+   .. attribute:: name
+
+      | :sl:`Proper font name.`
+      | :sg:`name -> string`
+
+      Read only. Returns the real (long) name of the font, as
+      recorded in the font file.
+
+   .. attribute:: path
+
+      | :sl:`Font file path`
+      | :sg:`path -> unicode`
+
+      Read only. Returns the path of the loaded font file
+
+   .. attribute:: size
+
+      | :sl:`The default point size used in rendering`
+      | :sg:`size -> float`
+      | :sg:`size -> (float, float)`
+
+      Get or set the default size for text metrics and rendering. It can be
+      a single point size, given as a Python ``int`` or ``float``, or a
+      font ppem (width, height) ``tuple``. Size values are non-negative.
+      A zero size or width represents an undefined size. In this case
+      the size must be given as a method argument, or an exception is
+      raised. A zero width but non-zero height is a ValueError.
+
+      For a scalable font, a single number value is equivalent to a tuple
+      with width equal height. A font can be stretched vertically with
+      height set greater than width, or horizontally with width set
+      greater than height. For embedded bitmaps, as listed by :meth:`get_sizes`,
+      use the nominal width and height to select an available size.
+
+      Font size differs for a non-scalable, bitmap, font. During a
+      method call it must match one of the available sizes returned by
+      method :meth:`get_sizes`. If not, an exception is raised.
+      If the size is a single number, the size is first matched against the
+      point size value. If no match, then the available size with the
+      same nominal width and height is chosen.
+
+   .. method:: get_rect
+
+      | :sl:`Return the size and offset of rendered text`
+      | :sg:`get_rect(text, style=STYLE_DEFAULT, rotation=0, size=0) -> rect`
+
+      Gets the final dimensions and origin, in pixels, of *text* using the
+      optional *size* in points, *style*, and *rotation*. For other
+      relevant render properties, and for any optional argument not given,
+      the default values set for the :class:`Font` instance are used.
+
+      Returns a :class:`Rect ` instance containing the
+      width and height of the text's bounding box and the position of the
+      text's origin.
+      The origin is useful in aligning separately rendered pieces of text.
+      It gives the baseline position and bearing at the start of the text.
+      See the :meth:`render_to` method for an example.
+
+      If *text* is a char (byte) string, its encoding is assumed to be
+      ``LATIN1``.
+
+      Optionally, *text* can be ``None``, which will return the bounding
+      rectangle for the text passed to a previous :meth:`get_rect`,
+      :meth:`render`, :meth:`render_to`, :meth:`render_raw`, or
+      :meth:`render_raw_to` call. See :meth:`render_to` for more
+      details.
+
+   .. method:: get_metrics
+
+      | :sl:`Return the glyph metrics for the given text`
+      | :sg:`get_metrics(text, size=0) -> [(...), ...]`
+
+      Returns the glyph metrics for each character in *text*.
+
+      The glyph metrics are returned as a list of tuples. Each tuple gives
+      metrics of a single character glyph. The glyph metrics are:
+
+      ::
+
+          (min_x, max_x, min_y, max_y, horizontal_advance_x, horizontal_advance_y)
+
+      The bounding box min_x, max_x, min_y, and max_y values are returned as
+      grid-fitted pixel coordinates of type int. The advance values are
+      float values.
+
+      The calculations are done using the font's default size in points.
+      Optionally you may specify another point size with the *size* argument.
+
+      The metrics are adjusted for the current rotation, strong, and oblique
+      settings.
+
+      If text is a char (byte) string, then its encoding is assumed to be
+      ``LATIN1``.
+
+   .. attribute:: height
+
+      | :sl:`The unscaled height of the font in font units`
+      | :sg:`height -> int`
+
+      Read only. Gets the height of the font. This is the average value of all
+      glyphs in the font.
+
+   .. attribute:: ascender
+
+      | :sl:`The unscaled ascent of the font in font units`
+      | :sg:`ascender -> int`
+
+      Read only. Return the number of units from the font's baseline to
+      the top of the bounding box.
+
+   .. attribute:: descender
+
+      | :sl:`The unscaled descent of the font in font units`
+      | :sg:`descender -> int`
+
+      Read only. Return the height in font units for the font descent.
+      The descent is the number of units from the font's baseline to the
+      bottom of the bounding box.
+
+   .. method:: get_sized_ascender
+
+      | :sl:`The scaled ascent of the font in pixels`
+      | :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.
+
+   .. method:: get_sized_descender
+
+      | :sl:`The scaled descent of the font in pixels`
+      | :sg:`get_sized_descender(=0) -> int`
+
+      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(=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.
+
+   .. method:: get_sized_glyph_height
+
+      | :sl:`The scaled bounding box height of the font in pixels`
+      | :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.
+      It is not adjusted for strong or rotation.
+
+   .. method:: get_sizes
+
+      | :sl:`return the available sizes of embedded bitmaps`
+      | :sg:`get_sizes() -> [(int, int, int, float, float), ...]`
+      | :sg:`get_sizes() -> []`
+
+      Returns a list of tuple records, one for each point size
+      supported. Each tuple containing the point size, the height in pixels,
+      width in pixels, horizontal ppem (nominal width) in fractional pixels,
+      and vertical ppem (nominal height) in fractional pixels.
+
+   .. method:: render
+
+      | :sl:`Return rendered text as a surface`
+      | :sg:`render(text, fgcolor=None, bgcolor=None, style=STYLE_DEFAULT, rotation=0, size=0) -> (Surface, Rect)`
+
+      Returns a new :class:`Surface `,
+      with the text rendered to it
+      in the color given by 'fgcolor'. If no foreground color is given,
+      the default foreground color, :attr:`fgcolor ` is used.
+      If ``bgcolor`` is given, the surface
+      will be filled with this color. When no background color is given,
+      the surface background is transparent, zero alpha. Normally the returned
+      surface has a 32 bit pixel size. However, if ``bgcolor`` is ``None``
+      and anti-aliasing is disabled a monochrome 8 bit colorkey surface,
+      with colorkey set for the background color, is returned.
+
+      The return value is a tuple: the new surface and the bounding
+      rectangle giving the size and origin of the rendered text.
+
+      If an empty string is passed for text then the returned Rect is zero
+      width and the height of the font.
+
+      Optional *fgcolor*, *style*, *rotation*, and *size* arguments override
+      the default values set for the :class:`Font` instance.
+
+      If *text* is a char (byte) string, then its encoding is assumed to be
+      ``LATIN1``.
+
+      Optionally, *text* can be ``None``, which will render the text
+      passed to a previous :meth:`get_rect`, :meth:`render`, :meth:`render_to`,
+      :meth:`render_raw`, or :meth:`render_raw_to` call.
+      See :meth:`render_to` for details.
+
+   .. method:: render_to
+
+      | :sl:`Render text onto an existing surface`
+      | :sg:`render_to(surf, dest, text, fgcolor=None, bgcolor=None, style=STYLE_DEFAULT, rotation=0, size=0) -> Rect`
+
+      Renders the string *text* to the :mod:`pygame.Surface` *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
+      is accepted, including a :class:`Rect ` instance.
+      As with :meth:`render`,
+      optional *fgcolor*, *style*, *rotation*, and *size* argument are
+      available.
+
+      If a background color *bgcolor* is given, the text bounding box is
+      first filled with that color. The text is blitted next.
+      Both the background fill and text rendering involve full alpha blits.
+      That is, the alpha values of the foreground, background, and destination
+      target surface all affect the blit.
+
+      The return value is a rectangle giving the size and position of the
+      rendered text within the surface.
+
+      If an empty string is passed for text then the returned
+      :class:`Rect ` is zero width and the height of the font.
+      The rect will test False.
+
+      Optionally, *text* can be set ``None``, which will re-render text
+      passed to a previous :meth:`render_to`, :meth:`get_rect`, :meth:`render`,
+      :meth:`render_raw`, or :meth:`render_raw_to` call. Primarily, this
+      feature is an aid to using :meth:`render_to` in combination with
+      :meth:`get_rect`. An example: ::
+
+          def word_wrap(surf, text, font, color=(0, 0, 0)):
+              font.origin = True
+              words = text.split(' ')
+              width, height = surf.get_size()
+              line_spacing = font.get_sized_height() + 2
+              x, y = 0, line_spacing
+              space = font.get_rect(' ')
+              for word in words:
+                  bounds = font.get_rect(word)
+                  if x + bounds.width + bounds.x >= width:
+                      x, y = 0, 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
+
+      When :meth:`render_to` is called with the same
+      font properties ― :attr:`size`, :attr:`style`, :attr:`strength`,
+      :attr:`wide`, :attr:`antialiased`, :attr:`vertical`, :attr:`rotation`,
+      :attr:`kerning`, and :attr:`use_bitmap_strikes` ― as :meth:`get_rect`,
+      :meth:`render_to` will use the layout calculated by :meth:`get_rect`.
+      Otherwise, :meth:`render_to` will recalculate the layout if called
+      with a text string or one of the above properties has changed
+      after the :meth:`get_rect` call.
+
+      If *text* is a char (byte) string, then its encoding is assumed to be
+      ``LATIN1``.
+
+   .. method:: render_raw
+
+      | :sl:`Return rendered text as a string of bytes`
+      | :sg:`render_raw(text, style=STYLE_DEFAULT, rotation=0, size=0, invert=False) -> (bytes, (int, int))`
+
+      Like :meth:`render` but with the pixels returned as a byte string
+      of 8-bit gray-scale values. The foreground color is 255, the
+      background 0, useful as an alpha mask for a foreground pattern.
+
+   .. method:: render_raw_to
+
+      | :sl:`Render text into an array of ints`
+      | :sg:`render_raw_to(array, text, dest=None, style=STYLE_DEFAULT, rotation=0, size=0, invert=False) -> Rect`
+
+      Render to an array object exposing an array struct interface. The array
+      must be two dimensional with integer items. The default *dest* value,
+      ``None``, is equivalent to position (0, 0). See :meth:`render_to`.
+      As with the other render methods, *text* can be ``None`` to
+      render a text string passed previously to another method.
+
+      The return value is a :func:`pygame.Rect` giving the size and position of
+      the rendered text.
+
+   .. attribute:: style
+
+      | :sl:`The font's style flags`
+      | :sg:`style -> int`
+
+      Gets or sets the default style of the Font. This default style will be
+      used for all text rendering and size calculations unless overridden
+      specifically a render or :meth:`get_rect` call.
+      The style value may be a bit-wise OR of one or more of the following
+      constants:
+
+      ::
+
+          STYLE_NORMAL
+          STYLE_UNDERLINE
+          STYLE_OBLIQUE
+          STYLE_STRONG
+          STYLE_WIDE
+          STYLE_DEFAULT
+
+      These constants may be found on the FreeType constants module.
+      Optionally, the default style can be modified or obtained accessing the
+      individual style attributes (underline, oblique, strong).
+
+      The ``STYLE_OBLIQUE`` and ``STYLE_STRONG`` styles are for
+      scalable fonts only. An attempt to set either for a bitmap font raises
+      an AttributeError. An attempt to set either for an inactive font,
+      as returned by ``Font.__new__()``, raises a RuntimeError.
+
+      Assigning ``STYLE_DEFAULT`` to the :attr:`style` property leaves
+      the property unchanged, as this property defines the default.
+      The :attr:`style` property will never return ``STYLE_DEFAULT``.
+
+   .. attribute:: underline
+
+      | :sl:`The state of the font's underline style flag`
+      | :sg:`underline -> bool`
+
+      Gets or sets whether the font will be underlined when drawing text. This
+      default style value will be used for all text rendering and size
+      calculations unless overridden specifically in a render or
+      :meth:`get_rect` call, via the 'style' parameter.
+
+   .. attribute:: strong
+
+      | :sl:`The state of the font's strong style flag`
+      | :sg:`strong -> bool`
+
+      Gets or sets whether the font will be bold when drawing text. This
+      default style value will be used for all text rendering and size
+      calculations unless overridden specifically in a render or
+      :meth:`get_rect` call, via the 'style' parameter.
+
+   .. attribute:: oblique
+
+      | :sl:`The state of the font's oblique style flag`
+      | :sg:`oblique -> bool`
+
+      Gets or sets whether the font will be rendered as oblique. This
+      default style value will be used for all text rendering and size
+      calculations unless overridden specifically in a render or
+      :meth:`get_rect` call, via the *style* parameter.
+
+      The oblique style is only supported for scalable (outline) fonts.
+      An attempt to set this style on a bitmap font will raise an
+      AttributeError. If the font object is inactive, as returned by
+      ``Font.__new__()``, setting this property raises a RuntimeError.
+
+   .. attribute:: wide
+
+      | :sl:`The state of the font's wide style flag`
+      | :sg:`wide -> bool`
+
+      Gets or sets whether the font will be stretched horizontally
+      when drawing text. It produces a result similar to
+      :class:`pygame.font.Font`'s bold. This style not available for
+      rotated text.
+
+   .. attribute:: strength
+
+      | :sl:`The strength associated with the strong or wide font styles`
+      | :sg:`strength -> float`
+
+      The amount by which a font glyph's size is enlarged for the
+      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 :class:`pygame.font.Font` 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
+      AttributeError. If the font object is inactive, as returned by
+      ``Font.__new__()``, assignment to this property raises a RuntimeError.
+
+   .. attribute:: underline_adjustment
+
+      | :sl:`Adjustment factor for the underline position`
+      | :sg:`underline_adjustment -> float`
+
+      Gets or sets a factor which, when positive, is multiplied with the
+      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 :class:`pygame.font.Font` underlining.
+
+   .. attribute:: fixed_width
+
+      | :sl:`Gets whether the font is fixed-width`
+      | :sg:`fixed_width -> bool`
+
+      Read only. Returns ``True`` if the font contains fixed-width
+      characters (for example Courier, Bitstream Vera Sans Mono, Andale Mono).
+
+   .. attribute:: fixed_sizes
+
+      | :sl:`the number of available bitmap sizes for the font`
+      | :sg:`fixed_sizes -> int`
+
+      Read only. Returns the number of point sizes for which the font contains
+      bitmap character images. If zero then the font is not a bitmap font.
+      A scalable font may contain pre-rendered point sizes as strikes.
+
+   .. attribute:: scalable
+
+      | :sl:`Gets whether the font is scalable`
+      | :sg:`scalable -> bool`
+
+      Read only. Returns ``True`` if the font contains outline glyphs.
+      If so, the point size is not limited to available bitmap sizes.
+
+   .. attribute:: use_bitmap_strikes
+
+      | :sl:`allow the use of embedded bitmaps in an outline font file`
+      | :sg:`use_bitmap_strikes -> bool`
+
+      Some scalable fonts include embedded bitmaps for particular point
+      sizes. This property controls whether or not those bitmap strikes
+      are used. Set it ``False`` to disable the loading of any bitmap
+      strike. Set it ``True``, the default, to permit bitmap strikes
+      for a non-rotated render with no style other than :attr:`wide` or
+      :attr:`underline`. This property is ignored for bitmap fonts.
+
+      See also :attr:`fixed_sizes` and :meth:`get_sizes`.
+
+   .. attribute:: antialiased
+
+      | :sl:`Font anti-aliasing mode`
+      | :sg:`antialiased -> bool`
+
+      Gets or sets the font's anti-aliasing mode. This defaults to
+      ``True`` on all fonts, which are rendered with full 8 bit blending.
+
+      Set to ``False`` to do monochrome rendering. This should
+      provide a small speed gain and reduce cache memory size.
+
+   .. attribute:: kerning
+
+      | :sl:`Character kerning mode`
+      | :sg:`kerning -> bool`
+
+      Gets or sets the font's kerning mode. This defaults to ``False``
+      on all fonts, which will be rendered without kerning.
+
+      Set to ``True`` to add kerning between character pairs, if supported
+      by the font, when positioning glyphs.
+
+   .. attribute:: vertical
+
+      | :sl:`Font vertical mode`
+      | :sg:`vertical -> bool`
+
+      Gets or sets whether the characters are laid out vertically rather
+      than horizontally. May be useful when rendering Kanji or some other
+      vertical script.
+
+      Set to ``True`` to switch to a vertical text layout. The default
+      is ``False``, place horizontally.
+
+      Note that the :class:`Font` class does not automatically determine
+      script orientation. Vertical layout must be selected explicitly.
+
+      Also note that several font formats (especially bitmap based ones) don't
+      contain the necessary metrics to draw glyphs vertically, so drawing in
+      those cases will give unspecified results.
+
+   .. attribute:: rotation
+
+      | :sl:`text rotation in degrees counterclockwise`
+      | :sg:`rotation -> int`
+
+      Gets or sets the baseline angle of the rendered text. The angle is
+      represented as integer degrees. The default angle is 0, with horizontal
+      text rendered along the X-axis, and vertical text along the Y-axis.
+      A positive value rotates these axes counterclockwise that many degrees.
+      A negative angle corresponds to a clockwise rotation. The rotation
+      value is normalized to a value within the range 0 to 359 inclusive
+      (eg. 390 -> 390 - 360 -> 30, -45 -> 360 + -45 -> 315,
+      720 -> 720 - (2 * 360) -> 0).
+
+      Only scalable (outline) fonts can be rotated. An attempt to change
+      the rotation of a bitmap font raises an AttributeError.
+      An attempt to change the rotation of an inactive font instance, as
+      returned by ``Font.__new__()``, raises a RuntimeError.
+
+   .. attribute:: fgcolor
+
+      | :sl:`default foreground color`
+      | :sg:`fgcolor -> Color`
+
+      Gets or sets the default glyph rendering color. It is initially opaque
+      black ― (0, 0, 0, 255). Applies to :meth:`render` and :meth:`render_to`.
+
+   .. attribute:: bgcolor
+
+      | :sl:`default background color`
+      | :sg:`bgcolor -> Color`
+
+      Gets or sets the default background rendering color. Initially it is
+      unset and text will render with a transparent background by default.
+      Applies to :meth:`render` and :meth:`render_to`.
+
+   .. versionadded:: 2.0.0
+
+   .. attribute:: origin
+
+      | :sl:`Font render to text origin mode`
+      | :sg:`origin -> bool`
+
+      If set ``True``, :meth:`render_to` and :meth:`render_raw_to` will
+      take the *dest* position to be that of the text origin, as opposed to
+      the top-left corner of the bounding box. See :meth:`get_rect` for
+      details.
+
+   .. attribute:: pad
+
+      | :sl:`padded boundary mode`
+      | :sg:`pad -> bool`
+
+      If set ``True``, then the text boundary rectangle will be inflated
+      to match that of :class:`font.Font `.
+      Otherwise, the boundary rectangle is just large enough for the text.
+
+   .. attribute:: ucs4
+
+      | :sl:`Enable UCS-4 mode`
+      | :sg:`ucs4 -> bool`
+
+      Gets or sets the decoding of Unicode text. By default, the
+      freetype module performs UTF-16 surrogate pair decoding on Unicode text.
+      This allows 32-bit escape sequences ('\Uxxxxxxxx') between 0x10000 and
+      0x10FFFF to represent their corresponding UTF-32 code points on Python
+      interpreters built with a UCS-2 Unicode type (on Windows, for instance).
+      It also means character values within the UTF-16 surrogate area (0xD800
+      to 0xDFFF) are considered part of a surrogate pair. A malformed surrogate
+      pair will raise a UnicodeEncodeError. Setting ucs4 ``True`` turns
+      surrogate pair decoding off, allowing access the full UCS-4 character
+      range to a Python interpreter built with four-byte Unicode character
+      support.
+
+   .. attribute:: resolution
+
+      | :sl:`Pixel resolution in dots per inch`
+      | :sg:`resolution -> int`
+
+      Read only. Gets pixel size used in scaling font glyphs for this
+      :class:`Font` instance.
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_sources/ref/gfxdraw.rst.txt b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_sources/ref/gfxdraw.rst.txt
new file mode 100644
index 0000000..28153a3
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_sources/ref/gfxdraw.rst.txt
@@ -0,0 +1,628 @@
+.. include:: common.txt
+
+:mod:`pygame.gfxdraw`
+=====================
+
+.. module:: pygame.gfxdraw
+   :synopsis: pygame module for drawing shapes
+
+| :sl:`pygame module for drawing shapes`
+
+**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 pygame package does not import gfxdraw automatically when loaded, so it
+must imported explicitly to be used.
+
+::
+
+    import pygame
+    import pygame.gfxdraw
+
+For all functions the arguments are strictly positional and integers are
+accepted for coordinates and radii. The ``color`` argument can be one of the
+following formats:
+
+   - a :mod:`pygame.Color` object
+   - an ``(RGB)`` triplet (tuple/list)
+   - an ``(RGBA)`` quadruplet (tuple/list)
+
+The functions :meth:`rectangle` and :meth:`box` will accept any ``(x, y, w, h)``
+sequence for their ``rect`` argument, though :mod:`pygame.Rect` instances are
+preferred.
+
+To draw a filled antialiased shape, first use the antialiased (aa*) version
+of the function, and then use the filled (filled_*) version.
+For example:
+
+::
+
+   col = (255, 0, 0)
+   surf.fill((255, 255, 255))
+   pygame.gfxdraw.aacircle(surf, x, y, 30, col)
+   pygame.gfxdraw.filled_circle(surf, x, y, 30, col)
+
+
+.. note::
+   For threading, each of the functions releases the GIL during the C part of
+   the call.
+
+.. note::
+   See the :mod:`pygame.draw` module for alternative draw methods.
+   The ``pygame.gfxdraw`` module differs from the :mod:`pygame.draw` 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.
+
+.. versionadded:: 1.9.0
+
+
+.. function:: pixel
+
+   | :sl:`draw a pixel`
+   | :sg:`pixel(surface, x, y, color) -> None`
+
+   Draws a single pixel, at position (x ,y), on the given surface.
+
+   :param Surface surface: surface to draw on
+   :param int x: x coordinate of the pixel
+   :param int y: y coordinate of the pixel
+   :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])
+
+   :returns: ``None``
+   :rtype: NoneType
+
+   .. ## pygame.gfxdraw.pixel ##
+
+.. function:: hline
+
+   | :sl:`draw a horizontal line`
+   | :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.
+
+   :param Surface surface: surface to draw on
+   :param int x1: x coordinate of one end of the line
+   :param int x2: x coordinate of the other end of the line
+   :param int y: y coordinate of the line
+   :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])
+
+   :returns: ``None``
+   :rtype: NoneType
+
+   .. ## pygame.gfxdraw.hline ##
+
+.. function:: vline
+
+   | :sl:`draw a vertical line`
+   | :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.
+
+   :param Surface surface: surface to draw on
+   :param int x: x coordinate of the line
+   :param int y1: y coordinate of one end of the line
+   :param int y2: y coordinate of the other end of the line
+   :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])
+
+   :returns: ``None``
+   :rtype: NoneType
+
+   .. ## pygame.gfxdraw.vline ##
+
+.. function:: line
+
+   | :sl:`draw a line`
+   | :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.
+
+   :param Surface surface: surface to draw on
+   :param int x1: x coordinate of one end of the line
+   :param int y1: y coordinate of one end of the line
+   :param int x2: x coordinate of the other end of the line
+   :param int y2: y coordinate of the other end of the line
+   :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])
+
+   :returns: ``None``
+   :rtype: NoneType
+
+   .. ## pygame.gfxdraw.line ##
+
+.. function:: rectangle
+
+   | :sl:`draw a rectangle`
+   | :sg:`rectangle(surface, rect, color) -> None`
+
+   Draws an unfilled rectangle on the given surface. For a filled rectangle use
+   :meth:`box`.
+
+   :param Surface surface: surface to draw on
+   :param Rect rect: rectangle to draw, position and dimensions
+   :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])
+
+   :returns: ``None``
+   :rtype: NoneType
+
+   .. note::
+      The ``rect.bottom`` and ``rect.right`` attributes of a :mod:`pygame.Rect`
+      always lie one pixel outside of its actual border. Therefore, these
+      values will not be included as part of the drawing.
+
+   .. ## pygame.gfxdraw.rectangle ##
+
+.. function:: box
+
+   | :sl:`draw a filled rectangle`
+   | :sg:`box(surface, rect, color) -> None`
+
+   Draws a filled rectangle on the given surface. For an unfilled rectangle use
+   :meth:`rectangle`.
+
+   :param Surface surface: surface to draw on
+   :param Rect rect: rectangle to draw, position and dimensions
+   :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])
+
+   :returns: ``None``
+   :rtype: NoneType
+
+   .. note::
+      The ``rect.bottom`` and ``rect.right`` attributes of a :mod:`pygame.Rect`
+      always lie one pixel outside of its actual border. Therefore, these
+      values will not be included as part of the drawing.
+
+   .. note::
+      The :func:`pygame.Surface.fill` method works just as well for drawing
+      filled rectangles. In fact :func:`pygame.Surface.fill` can be hardware
+      accelerated on some platforms with both software and hardware display
+      modes.
+
+   .. ## pygame.gfxdraw.box ##
+
+.. function:: circle
+
+   | :sl:`draw a circle`
+   | :sg:`circle(surface, x, y, r, color) -> None`
+
+   Draws an unfilled circle on the given surface. For a filled circle use
+   :meth:`filled_circle`.
+
+   :param Surface surface: surface to draw on
+   :param int x: x coordinate of the center of the circle
+   :param int y: y coordinate of the center of the circle
+   :param int r: radius of the circle
+   :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])
+
+   :returns: ``None``
+   :rtype: NoneType
+
+   .. ## pygame.gfxdraw.circle ##
+
+.. function:: aacircle
+
+   | :sl:`draw an antialiased circle`
+   | :sg:`aacircle(surface, x, y, r, color) -> None`
+
+   Draws an unfilled antialiased circle on the given surface.
+
+   :param Surface surface: surface to draw on
+   :param int x: x coordinate of the center of the circle
+   :param int y: y coordinate of the center of the circle
+   :param int r: radius of the circle
+   :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])
+
+   :returns: ``None``
+   :rtype: NoneType
+
+   .. ## pygame.gfxdraw.aacircle ##
+
+.. function:: filled_circle
+
+   | :sl:`draw a filled circle`
+   | :sg:`filled_circle(surface, x, y, r, color) -> None`
+
+   Draws a filled circle on the given surface. For an unfilled circle use
+   :meth:`circle`.
+
+   :param Surface surface: surface to draw on
+   :param int x: x coordinate of the center of the circle
+   :param int y: y coordinate of the center of the circle
+   :param int r: radius of the circle
+   :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])
+
+   :returns: ``None``
+   :rtype: NoneType
+
+   .. ## pygame.gfxdraw.filled_circle ##
+
+.. function:: ellipse
+
+   | :sl:`draw an ellipse`
+   | :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`.
+
+   :param Surface surface: surface to draw on
+   :param int x: x coordinate of the center of the ellipse
+   :param int y: y coordinate of the center of the ellipse
+   :param int rx: horizontal radius of the ellipse
+   :param int ry: vertical radius of the ellipse
+   :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])
+
+   :returns: ``None``
+   :rtype: NoneType
+
+   .. ## pygame.gfxdraw.ellipse ##
+
+.. function:: aaellipse
+
+   | :sl:`draw an antialiased ellipse`
+   | :sg:`aaellipse(surface, x, y, rx, ry, color) -> None`
+
+   Draws an unfilled antialiased ellipse on the given surface.
+
+   :param Surface surface: surface to draw on
+   :param int x: x coordinate of the center of the ellipse
+   :param int y: y coordinate of the center of the ellipse
+   :param int rx: horizontal radius of the ellipse
+   :param int ry: vertical radius of the ellipse
+   :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])
+
+   :returns: ``None``
+   :rtype: NoneType
+
+   .. ## pygame.gfxdraw.aaellipse ##
+
+.. function:: filled_ellipse
+
+   | :sl:`draw a filled ellipse`
+   | :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`.
+
+   :param Surface surface: surface to draw on
+   :param int x: x coordinate of the center of the ellipse
+   :param int y: y coordinate of the center of the ellipse
+   :param int rx: horizontal radius of the ellipse
+   :param int ry: vertical radius of the ellipse
+   :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])
+
+   :returns: ``None``
+   :rtype: NoneType
+
+   .. ## pygame.gfxdraw.filled_ellipse ##
+
+.. function:: arc
+
+   | :sl:`draw an arc`
+   | :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`.
+
+   The two angle arguments are given in degrees and indicate the start and stop
+   positions of the arc. The arc is drawn in a clockwise direction from the
+   ``start_angle`` to the ``stop_angle``. If ``start_angle == stop_angle``,
+   nothing will be drawn
+
+   :param Surface surface: surface to draw on
+   :param int x: x coordinate of the center of the arc
+   :param int y: y coordinate of the center of the arc
+   :param int r: radius of the arc
+   :param int start_angle: start angle in degrees
+   :param int stop_angle: stop angle in degrees
+   :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])
+
+   :returns: ``None``
+   :rtype: NoneType
+
+   .. note::
+      This function uses *degrees* while the :func:`pygame.draw.arc` function
+      uses *radians*.
+
+   .. ## pygame.gfxdraw.arc ##
+
+.. function:: pie
+
+   | :sl:`draw a pie`
+   | :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.
+
+   The two angle arguments are given in degrees and indicate the start and stop
+   positions of the pie. The pie is drawn in a clockwise direction from the
+   ``start_angle`` to the ``stop_angle``. If ``start_angle == stop_angle``,
+   a straight line will be drawn from the center position at the given angle,
+   to a length of the radius.
+
+   :param Surface surface: surface to draw on
+   :param int x: x coordinate of the center of the pie
+   :param int y: y coordinate of the center of the pie
+   :param int r: radius of the pie
+   :param int start_angle: start angle in degrees
+   :param int stop_angle: stop angle in degrees
+   :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])
+
+   :returns: ``None``
+   :rtype: NoneType
+
+   .. ## pygame.gfxdraw.pie ##
+
+.. function:: trigon
+
+   | :sl:`draw a trigon/triangle`
+   | :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`.
+
+   A trigon can also be drawn using :meth:`polygon` e.g.
+   ``polygon(surface, ((x1, y1), (x2, y2), (x3, y3)), color)``
+
+   :param Surface surface: surface to draw on
+   :param int x1: x coordinate of the first corner of the trigon
+   :param int y1: y coordinate of the first corner of the trigon
+   :param int x2: x coordinate of the second corner of the trigon
+   :param int y2: y coordinate of the second corner of the trigon
+   :param int x3: x coordinate of the third corner of the trigon
+   :param int y3: y coordinate of the third corner of the trigon
+   :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])
+
+   :returns: ``None``
+   :rtype: NoneType
+
+   .. ## pygame.gfxdraw.trigon ##
+
+.. function:: aatrigon
+
+   | :sl:`draw an antialiased trigon/triangle`
+   | :sg:`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 :meth:`aapolygon` e.g.
+   ``aapolygon(surface, ((x1, y1), (x2, y2), (x3, y3)), color)``
+
+   :param Surface surface: surface to draw on
+   :param int x1: x coordinate of the first corner of the trigon
+   :param int y1: y coordinate of the first corner of the trigon
+   :param int x2: x coordinate of the second corner of the trigon
+   :param int y2: y coordinate of the second corner of the trigon
+   :param int x3: x coordinate of the third corner of the trigon
+   :param int y3: y coordinate of the third corner of the trigon
+   :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])
+
+   :returns: ``None``
+   :rtype: NoneType
+
+   .. ## pygame.gfxdraw.aatrigon ##
+
+.. function:: filled_trigon
+
+   | :sl:`draw a filled trigon/triangle`
+   | :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`.
+
+   A filled_trigon can also be drawn using :meth:`filled_polygon` e.g.
+   ``filled_polygon(surface, ((x1, y1), (x2, y2), (x3, y3)), color)``
+
+   :param Surface surface: surface to draw on
+   :param int x1: x coordinate of the first corner of the trigon
+   :param int y1: y coordinate of the first corner of the trigon
+   :param int x2: x coordinate of the second corner of the trigon
+   :param int y2: y coordinate of the second corner of the trigon
+   :param int x3: x coordinate of the third corner of the trigon
+   :param int y3: y coordinate of the third corner of the trigon
+   :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])
+
+   :returns: ``None``
+   :rtype: NoneType
+
+   .. ## pygame.gfxdraw.filled_trigon ##
+
+.. function:: polygon
+
+   | :sl:`draw a polygon`
+   | :sg:`polygon(surface, points, color) -> None`
+
+   Draws an unfilled polygon on the given surface. For a filled polygon use
+   :meth:`filled_polygon`.
+
+   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
+   ``(x3, y3)``, and from ``(x3, y3)`` to ``(x1, y1)``.
+
+   :param Surface surface: surface to draw on
+   :param points: a sequence of 3 or more (x, y) coordinates, 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(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])
+
+   :returns: ``None``
+   :rtype: NoneType
+
+   :raises ValueError: if ``len(points) < 3`` (must have at least 3 points)
+   :raises IndexError: if ``len(coordinate) < 2`` (each coordinate must have
+      at least 2 items)
+
+   .. ## pygame.gfxdraw.polygon ##
+
+.. function:: aapolygon
+
+   | :sl:`draw an antialiased polygon`
+   | :sg:`aapolygon(surface, points, color) -> None`
+
+   Draws an unfilled antialiased polygon on the given surface.
+
+   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
+   ``(x3, y3)``, and from ``(x3, y3)`` to ``(x1, y1)``.
+
+   :param Surface surface: surface to draw on
+   :param points: a sequence of 3 or more (x, y) coordinates, 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(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])
+
+   :returns: ``None``
+   :rtype: NoneType
+
+   :raises ValueError: if ``len(points) < 3`` (must have at least 3 points)
+   :raises IndexError: if ``len(coordinate) < 2`` (each coordinate must have
+      at least 2 items)
+
+   .. ## pygame.gfxdraw.aapolygon ##
+
+.. function:: filled_polygon
+
+   | :sl:`draw a filled polygon`
+   | :sg:`filled_polygon(surface, points, color) -> None`
+
+   Draws a filled polygon on the given surface. For an unfilled polygon use
+   :meth:`polygon`.
+
+   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
+   ``(x3, y3)``, and from ``(x3, y3)`` to ``(x1, y1)``.
+
+   :param Surface surface: surface to draw on
+   :param points: a sequence of 3 or more (x, y) coordinates, 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(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])
+
+   :returns: ``None``
+   :rtype: NoneType
+
+   :raises ValueError: if ``len(points) < 3`` (must have at least 3 points)
+   :raises IndexError: if ``len(coordinate) < 2`` (each coordinate must have
+      at least 2 items)
+
+   .. ## pygame.gfxdraw.filled_polygon ##
+
+.. function:: textured_polygon
+
+   | :sl:`draw a textured polygon`
+   | :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.
+
+   A per-pixel alpha texture blit to a per-pixel alpha surface will differ from
+   a :func:`pygame.Surface.blit` blit. Also, a per-pixel alpha texture cannot be
+   used with an 8-bit per pixel destination.
+
+   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
+   ``(x3, y3)``, and from ``(x3, y3)`` to ``(x1, y1)``.
+
+   :param Surface surface: surface to draw on
+   :param points: a sequence of 3 or more (x, y) coordinates, 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(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
+
+   :returns: ``None``
+   :rtype: NoneType
+
+   :raises ValueError: if ``len(points) < 3`` (must have at least 3 points)
+   :raises IndexError: if ``len(coordinate) < 2`` (each coordinate must have
+      at least 2 items)
+
+   .. ## pygame.gfxdraw.textured_polygon ##
+
+.. function:: bezier
+
+   | :sl:`draw a Bezier curve`
+   | :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 *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(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])``
+   :type color: Color or tuple(int, int, int, [int])
+
+   :returns: ``None``
+   :rtype: NoneType
+
+   :raises ValueError: if ``steps < 2``
+   :raises ValueError: if ``len(points) < 3`` (must have at least 3 points)
+   :raises IndexError: if ``len(coordinate) < 2`` (each coordinate must have
+      at least 2 items)
+
+   .. ## pygame.gfxdraw.bezier ##
+
+.. ## pygame.gfxdraw ##
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_sources/ref/image.rst.txt b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_sources/ref/image.rst.txt
new file mode 100644
index 0000000..ec2e4fc
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_sources/ref/image.rst.txt
@@ -0,0 +1,375 @@
+.. include:: common.txt
+
+:mod:`pygame.image`
+===================
+
+.. 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/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_sources/ref/joystick.rst.txt b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_sources/ref/joystick.rst.txt
new file mode 100644
index 0000000..dba5b20
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_sources/ref/joystick.rst.txt
@@ -0,0 +1,697 @@
+.. include:: common.txt
+
+:mod:`pygame.joystick`
+======================
+
+.. module:: pygame.joystick
+   :synopsis: Pygame module for interacting with joysticks, gamepads, and trackballs.
+
+| :sl:`Pygame module for interacting with joysticks, gamepads, and trackballs.`
+
+The joystick module manages the joystick devices on a computer.
+Joystick devices include trackballs and video-game-style
+gamepads, and the module allows the use of multiple buttons and "hats".
+Computers may manage multiple joysticks at a time.
+
+Each instance of the Joystick class represents one gaming device plugged
+into the computer. If a gaming pad has multiple joysticks on it, then the
+joystick object can actually represent multiple joysticks on that single
+game device.
+
+For a quick way to initialise the joystick module and get a list of Joystick instances
+use the following code::
+
+    pygame.joystick.init()
+    joysticks = [pygame.joystick.Joystick(x) for x in range(pygame.joystick.get_count())]
+
+The following event types will be generated by the joysticks ::
+
+    JOYAXISMOTION JOYBALLMOTION JOYBUTTONDOWN JOYBUTTONUP JOYHATMOTION
+
+And in pygame 2, which supports hotplugging::
+
+   JOYDEVICEADDED JOYDEVICEREMOVED
+
+Note that in pygame 2, joysticks events use a unique "instance ID". The device index
+passed in the constructor to a Joystick object is not unique after devices have
+been added and removed. You must call :meth:`Joystick.get_instance_id()` to find
+the instance ID that was assigned to a Joystick on opening.
+
+The event queue needs to be pumped frequently for some of the methods to work.
+So call one of pygame.event.get, pygame.event.wait, or pygame.event.pump regularly.
+
+To be able to get joystick events and update the joystick objects while the window
+is not in focus, you may set the ``SDL_JOYSTICK_ALLOW_BACKGROUND_EVENTS`` environment
+variable. See :ref:`environment variables ` for more details.
+
+
+.. function:: init
+
+   | :sl:`Initialize the joystick module.`
+   | :sg:`init() -> None`
+
+   This function is called automatically by ``pygame.init()``.
+
+   It initializes the joystick module. The module must be initialized before any
+   other functions will work.
+
+   It is safe to call this function more than once.
+
+   .. ## pygame.joystick.init ##
+
+.. function:: quit
+
+   | :sl:`Uninitialize the joystick module.`
+   | :sg:`quit() -> None`
+
+   Uninitialize the joystick module. After you call this any existing joystick
+   objects will no longer work.
+
+   It is safe to call this function more than once.
+
+   .. ## pygame.joystick.quit ##
+
+.. function:: get_init
+
+   | :sl:`Returns True if the joystick module is initialized.`
+   | :sg:`get_init() -> bool`
+
+   Test if the ``pygame.joystick.init()`` function has been called.
+
+   .. ## pygame.joystick.get_init ##
+
+.. function:: get_count
+
+   | :sl:`Returns the number of joysticks.`
+   | :sg:`get_count() -> count`
+
+   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
+   that must be lower than this count.
+
+   .. ## pygame.joystick.get_count ##
+
+.. class:: Joystick
+
+   | :sl:`Create a new Joystick object.`
+   | :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``.
+
+   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.
+
+   .. versionchanged:: 2.0.0 Joystick objects are now opened immediately on creation.
+
+   .. method:: init
+
+      | :sl:`initialize the Joystick`
+      | :sg:`init() -> None`
+
+      Initialize the joystick, if it has been closed. It is safe to call this
+      even if the joystick is already initialized.
+
+      .. deprecated:: 2.0.0
+
+         In future it will not be possible to reinitialise a closed Joystick
+         object. Will be removed in Pygame 2.1.
+
+      .. ## Joystick.init ##
+
+   .. method:: quit
+
+      | :sl:`uninitialize the Joystick`
+      | :sg:`quit() -> None`
+
+      Close a Joystick object. After this the pygame event queue will no longer
+      receive events from the device.
+
+      It is safe to call this more than once.
+
+      .. ## Joystick.quit ##
+
+   .. method:: get_init
+
+      | :sl:`check if the Joystick is initialized`
+      | :sg:`get_init() -> bool`
+
+      Return True if the Joystick object is currently initialised.
+
+      .. ## Joystick.get_init ##
+
+   .. method:: get_id
+
+      | :sl:`get the device index (deprecated)`
+      | :sg:`get_id() -> int`
+
+      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:: 2.0.0
+
+         The original device index is not useful in pygame 2. Use
+         :meth:`.get_instance_id` instead. Will be removed in Pygame 2.1.
+
+   .. method:: get_instance_id() -> int
+
+      | :sl:`get the joystick instance id`
+      | :sg:`get_instance_id() -> int`
+
+      Get the joystick instance ID. This matches the ``instance_id`` field
+      that is given in joystick events.
+
+      .. versionadded:: 2.0.0dev11
+
+   .. method:: get_guid() -> str
+
+      | :sl:`get the joystick GUID`
+      | :sg:`get_guid() -> str`
+
+      Get the GUID string. This identifies the exact hardware of the joystick
+      device.
+
+      .. versionadded:: 2.0.0dev11
+
+   .. method:: get_power_level() -> str
+
+      | :sl:`get the approximate power status of the device`
+      | :sg:`get_power_level() -> str`
+
+      Get a string giving the power status of the device.
+
+      One of: ``empty``, ``low``, ``medium``, ``full``, ``wired``, ``max``, or
+      ``unknown``.
+
+      .. versionadded:: 2.0.0dev11
+
+      .. ## Joystick.get_id ##
+
+   .. method:: get_name
+
+      | :sl:`get the Joystick system name`
+      | :sg:`get_name() -> string`
+
+      Returns the system name for this joystick device. It is unknown what name
+      the system will give to the Joystick, but it should be a unique name that
+      identifies the device. This method can safely be called while the
+      Joystick is not initialized.
+
+      .. ## Joystick.get_name ##
+
+   .. method:: get_numaxes
+
+      | :sl:`get the number of axes on a Joystick`
+      | :sg:`get_numaxes() -> int`
+
+      Returns the number of input axes are on a Joystick. There will usually be
+      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 
+      generate a lot of rapid small motion events.
+
+      .. ## Joystick.get_numaxes ##
+
+   .. method:: get_axis
+
+      | :sl:`get the current position of an axis`
+      | :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 
+      position values.
+
+      The axis number must be an integer from ``0`` to ``get_numaxes() - 1``.
+
+      When using gamepads both the control sticks and the analog triggers are
+      usually reported as axes.
+
+      .. ## Joystick.get_axis ##
+
+   .. method:: get_numballs
+
+      | :sl:`get the number of trackballs on a Joystick`
+      | :sg:`get_numballs() -> int`
+
+      Returns the number of trackball devices on a Joystick. These devices work
+      similar to a mouse but they have no absolute position; they only have
+      relative amounts of movement.
+
+      The ``pygame.JOYBALLMOTION`` event will be sent when the trackball is
+      rolled. It will report the amount of movement on the trackball.
+
+      .. ## Joystick.get_numballs ##
+
+   .. method:: get_ball
+
+      | :sl:`get the relative position of a trackball`
+      | :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.
+
+      The ball number must be an integer from ``0`` to ``get_numballs() - 1``.
+
+      .. ## Joystick.get_ball ##
+
+   .. method:: get_numbuttons
+
+      | :sl:`get the number of buttons on a Joystick`
+      | :sg:`get_numbuttons() -> int`
+
+      Returns the number of pushable buttons on the joystick. These buttons
+      have a boolean (on or off) state.
+
+      Buttons generate a ``pygame.JOYBUTTONDOWN`` and ``pygame.JOYBUTTONUP``
+      event when they are pressed and released.
+
+      .. ## Joystick.get_numbuttons ##
+
+   .. method:: get_button
+
+      | :sl:`get the current button state`
+      | :sg:`get_button(button) -> bool`
+
+      Returns the current state of a joystick button.
+
+      .. ## Joystick.get_button ##
+
+   .. method:: get_numhats
+
+      | :sl:`get the number of hat controls on a Joystick`
+      | :sg:`get_numhats() -> int`
+
+      Returns the number of joystick hats on a Joystick. Hat devices are like
+      miniature digital joysticks on a joystick. Each hat has two axes of
+      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)`` 
+      means the hat is centered.
+
+      .. ## Joystick.get_numhats ##
+
+   .. method:: get_hat
+
+      | :sl:`get the position of a joystick hat`
+      | :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 
+      up; ``(1, 1)`` means upper-right; etc.
+
+      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``.
+
+      .. ## Joystick.get_hat ##
+
+   .. method:: rumble
+
+      | :sl:`Start a rumbling effect`
+      | :sg:`rumble(low_frequency, high_frequency, duration) -> bool`
+
+      Start a rumble effect on the joystick, with the specified strength ranging
+      from 0 to 1. Duration is length of the effect, in ms. Setting the duration
+      to 0 will play the effect until another one overwrites it or
+      :meth:`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 or :meth:`pygame.version.SDL` is below 2.0.9.
+
+      .. versionadded:: 2.0.2
+
+      .. ## Joystick.rumble ##
+
+   .. method:: stop_rumble
+
+      | :sl:`Stop any rumble effect playing`
+      | :sg:`stop_rumble() -> None`
+
+      Stops any rumble effect playing on the joystick. See
+      :meth:`Joystick.rumble` for more information.
+
+      .. versionadded:: 2.0.2
+
+      .. ## Joystick.stop_rumble ##
+
+   .. ## pygame.joystick.Joystick ##
+
+.. ## pygame.joystick ##
+
+.. figure:: code_examples/joystick_calls.png
+   :scale: 100 %
+   :alt: joystick module example
+
+   Example code for joystick module.
+
+.. literalinclude:: ../../../examples/joystick.py
+
+.. _controller-mappings:
+
+
+Common Controller Axis Mappings
+===============================
+
+Controller mappings are drawn from the underlying SDL library which pygame uses and they differ
+between pygame 1 and pygame 2. Below are a couple of mappings for three popular controllers.
+
+Axis and hat mappings are listed from -1 to +1.
+
+
+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"
+
+
+* **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      - 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"
+
+
+* **Buttons**::
+
+    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      - Y Axis
+    Left -> Right   - X Axis
+
+
+Nintendo Switch Pro Controller (pygame 2.x)
+*******************************************
+
+The Nintendo Switch Pro Controller has 6 axes, 16 buttons, and 0 hats.
+The controller is recognized as "Nintendo Switch Pro Controller".
+
+
+* **Left Stick**::
+
+    Left -> Right   - Axis 0
+    Up -> Down      - Axis 1
+
+* **Right Stick**::
+
+    Left -> Right   - Axis 2
+    Up -> Down      - Axis 3
+
+* **Left Trigger**::
+
+    Out -> In       - Axis 4
+
+* **Right Trigger**::
+
+    Out -> In       - Axis 5
+
+* **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
+    L. Stick In     - Button 7
+    R. Stick In     - Button 8
+    Left Bumper     - Button 9
+    Right Bumper    - 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
+
+
+XBox 360 Controller (pygame 2.x)
+********************************
+
+The Xbox 360 controller mapping has 6 axes, 11 buttons and 1 hat.
+The controller is recognized as "Xbox 360 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**::
+
+    A Button        - Button 0
+    B Button        - Button 1
+    X Button        - Button 2
+    Y Button        - Button 3
+    Left Bumper     - Button 4
+    Right Bumper    - Button 5
+    Back Button     - Button 6
+    Start Button    - Button 7
+    L. Stick In     - Button 8
+    R. Stick In     - Button 9
+    Guide Button    - Button 10
+
+* **Hat/D-pad**::
+
+    Down -> Up      - Y Axis
+    Left -> Right   - X Axis
+
+
+Playstation 4 Controller (pygame 2.x)
+*************************************
+
+The PlayStation 4 controller mapping has 6 axes and 16 buttons.
+The controller is recognized as "PS4 Controller".
+
+* **Left Stick**::
+
+    Left -> Right   - Axis 0
+    Up   -> Down    - Axis 1
+
+* **Right Stick**::
+
+    Left -> Right   - Axis 2
+    Up   -> Down    - Axis 3
+
+* **Left Trigger**::
+
+    Out -> In       - Axis 4
+
+* **Right Trigger**::
+
+    Out -> In       - Axis 5
+
+* **Buttons**::
+
+    Cross Button    - Button 0
+    Circle Button   - Button 1
+    Square Button   - Button 2
+    Triangle Button - Button 3
+    Share Button    - Button 4
+    PS Button       - Button 5
+    Options Button  - Button 6
+    L. Stick In     - Button 7
+    R. Stick In     - Button 8
+    Left Bumper     - Button 9
+    Right Bumper    - Button 10
+    D-pad Up        - Button 11
+    D-pad Down      - Button 12
+    D-pad Left      - Button 13
+    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)
+********************************
+
+The Xbox 360 controller mapping has 5 axes, 10 buttons, and 1 hat.
+The controller is recognized as "Controller (XBOX 360 For Windows)".
+
+* **Left Stick**::
+
+    Left -> Right   - Axis 0
+    Up   -> Down    - Axis 1
+
+* **Right Stick**::
+
+    Left -> Right   - Axis 4
+    Up   -> Down    - Axis 3
+
+* **Left Trigger & Right Trigger**::
+
+    RT -> LT        - Axis 2
+
+* **Buttons**::
+
+    A Button        - Button 0
+    B Button        - Button 1
+    X Button        - Button 2
+    Y Button        - Button 3
+    Left Bumper     - Button 4
+    Right Bumper    - Button 5
+    Back Button     - Button 6
+    Start Button    - Button 7
+    L. Stick In     - Button 8
+    R. Stick In     - Button 9
+
+* **Hat/D-pad**::
+
+    Down -> Up      - Y Axis
+    Left -> Right   - X Axis
+
+
+Playstation 4 Controller (pygame 1.x)
+*************************************
+
+The PlayStation 4 controller mapping has 6 axes, 14 buttons, and 1 hat.
+The controller is recognized as "Wireless Controller".
+
+* **Left Stick**::
+
+    Left -> Right   - Axis 0
+    Up   -> Down    - Axis 1
+
+* **Right Stick**::
+
+    Left -> Right   - Axis 2
+    Up   -> Down    - Axis 3
+
+* **Left Trigger**::
+
+    Out -> In       - Axis 5
+
+* **Right Trigger**::
+
+    Out -> In       - Axis 4
+
+* **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
+    L. Trigger(Full)- Button 6
+    R. Trigger(Full)- Button 7
+    Share Button    - Button 8
+    Options Button  - Button 9
+    L. Stick In     - Button 10
+    R. Stick In     - Button 11
+    PS Button       - Button 12
+    Touch Pad Click - Button 13
+
+* **Hat/D-pad**::
+
+    Down -> Up      - Y Axis
+    Left -> Right   - X Axis
+
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_sources/ref/key.rst.txt b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_sources/ref/key.rst.txt
new file mode 100644
index 0000000..315b0fb
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_sources/ref/key.rst.txt
@@ -0,0 +1,455 @@
+.. include:: common.txt
+
+:mod:`pygame.key`
+=================
+
+.. 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/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_sources/ref/locals.rst.txt b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_sources/ref/locals.rst.txt
new file mode 100644
index 0000000..091dbaa
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_sources/ref/locals.rst.txt
@@ -0,0 +1,27 @@
+.. include:: common.txt
+
+:mod:`pygame.locals`
+====================
+
+.. module:: pygame.locals
+   :synopsis: pygame constants
+
+| :sl:`pygame constants`
+
+This module contains various constants used by pygame. Its contents are
+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 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`.
+   - The :mod:`pygame.event` module contains the various event types.
+   - The :mod:`pygame.key` module lists the keyboard constants and modifiers
+     (``K_``\* and ``MOD_``\*) relating to the ``key`` and ``mod`` attributes of
+     the ``KEYDOWN`` and ``KEYUP`` events.
+   - The :mod:`pygame.time` module defines ``TIMER_RESOLUTION``.
+
+.. ## pygame.locals ##
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_sources/ref/mask.rst.txt b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_sources/ref/mask.rst.txt
new file mode 100644
index 0000000..f4365cf
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_sources/ref/mask.rst.txt
@@ -0,0 +1,642 @@
+.. include:: common.txt
+
+:mod:`pygame.mask`
+==================
+
+.. 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/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_sources/ref/math.rst.txt b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_sources/ref/math.rst.txt
new file mode 100644
index 0000000..0f037d9
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_sources/ref/math.rst.txt
@@ -0,0 +1,1143 @@
+.. include:: common.txt
+
+:mod:`pygame.math`
+==================
+
+.. module:: pygame.math
+   :synopsis: pygame module for vector classes
+
+| :sl:`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 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
+
+   | :sl:`a 2-Dimensional Vector`
+   | :sg:`Vector2() -> Vector2(0, 0)`
+   | :sg:`Vector2(int) -> Vector2`
+   | :sg:`Vector2(float) -> Vector2`
+   | :sg:`Vector2(Vector2) -> Vector2`
+   | :sg:`Vector2(x, y) -> Vector2`
+   | :sg:`Vector2((x, y)) -> Vector2`
+
+   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`
+
+      .. ## Vector2.dot ##
+
+   .. method:: cross
+
+      | :sl:`calculates the cross- or vector-product`
+      | :sg:`cross(Vector2) -> float`
+
+      calculates the third component of the cross-product.
+
+      .. ## Vector2.cross ##
+
+   .. method:: magnitude
+
+      | :sl:`returns the Euclidean magnitude of the vector.`
+      | :sg:`magnitude() -> float`
+
+      calculates the magnitude of the vector which follows from the
+      theorem: ``vec.magnitude() == math.sqrt(vec.x**2 + vec.y**2)``
+
+      .. ## Vector2.magnitude ##
+
+   .. method:: magnitude_squared
+
+      | :sl:`returns the squared magnitude of the vector.`
+      | :sg:`magnitude_squared() -> float`
+
+      calculates the magnitude of the vector which follows from the
+      theorem: ``vec.magnitude_squared() == vec.x**2 + vec.y**2``. This
+      is faster than ``vec.magnitude()`` because it avoids the square root.
+
+      .. ## Vector2.magnitude_squared ##
+
+   .. method:: length
+
+      | :sl:`returns the Euclidean length of the vector.`
+      | :sg:`length() -> float`
+
+      calculates the Euclidean length of the vector which follows from the
+      Pythagorean theorem: ``vec.length() == math.sqrt(vec.x**2 + vec.y**2)``
+
+      .. ## Vector2.length ##
+
+   .. method:: length_squared
+
+      | :sl:`returns the squared Euclidean length of the vector.`
+      | :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``. 
+      This is faster than ``vec.length()`` because it avoids the square root.
+
+      .. ## Vector2.length_squared ##
+
+   .. method:: normalize
+
+      | :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.
+
+      .. ## Vector2.normalize ##
+
+   .. method:: normalize_ip
+
+      | :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.
+
+      .. ## Vector2.normalize_ip ##
+
+   .. method:: is_normalized
+
+      | :sl:`tests if the vector is normalized i.e. has length == 1.`
+      | :sg:`is_normalized() -> Bool`
+
+      Returns True if the vector has ``length`` equal to ``1``. Otherwise 
+      it returns ``False``.
+
+      .. ## Vector2.is_normalized ##
+
+   .. method:: scale_to_length
+
+      | :sl:`scales the vector to a given length.`
+      | :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 
+      is the zero vector (i.e. has length ``0`` thus no direction) a
+      ``ValueError`` is raised.
+
+      .. ## Vector2.scale_to_length ##
+
+   .. method:: reflect
+
+      | :sl:`returns a vector reflected of a given normal.`
+      | :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
+      new vector is the same as self's.
+
+      .. ## Vector2.reflect ##
+
+   .. method:: reflect_ip
+
+      | :sl:`reflect the vector of a given normal in place.`
+      | :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.
+
+      .. ## Vector2.reflect_ip ##
+
+   .. method:: distance_to
+
+      | :sl:`calculates the Euclidean distance to a given vector.`
+      | :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`
+
+      .. ## 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`
+
+      **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.
+
+      .. versionadded:: 2.1.3
+
+      .. ## Vector2.move_towards ##
+
+   .. method:: move_towards_ip
+
+      | :sl:`moves the vector toward its target at a given distance.`
+      | :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.
+      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.
+
+      .. versionadded:: 2.1.3
+
+      .. ## Vector2.move_towards_ip ##
+
+   .. method:: lerp
+
+      | :sl:`returns a linear interpolation to the given vector.`
+      | :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.
+
+      .. ## Vector2.lerp ##
+
+   .. method:: slerp
+
+      | :sl:`returns a spherical interpolation to the given vector.`
+      | :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
+      parametrizes where - in between the two vectors - the result should be.
+      If a negative value is given the interpolation will not take the
+      complement of the shortest path.
+
+      .. ## Vector2.slerp ##
+
+   .. method:: elementwise
+
+      | :sl:`The next operation will be performed elementwise.`
+      | :sg:`elementwise() -> VectorElementwiseProxy`
+
+      Applies the following operation to each element of the vector.
+
+      .. ## Vector2.elementwise ##
+
+   .. method:: rotate
+
+      | :sl:`rotates a vector by a given angle in degrees.`
+      | :sg:`rotate(angle) -> Vector2`
+
+      Returns a vector which has the same length as self but is rotated
+      counterclockwise by the given angle in degrees.
+      (Note that due to pygame's inverted y coordinate system, the rotation
+      will look clockwise if displayed).
+
+      .. ## Vector2.rotate ##
+
+   .. method:: rotate_rad
+
+      | :sl:`rotates a vector by a given angle in radians.`
+      | :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).
+
+      .. 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`
+
+      Rotates the vector counterclockwise by the given angle in degrees. 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).
+
+      .. ## Vector2.rotate_ip ##
+
+   .. method:: rotate_ip_rad
+
+      | :sl:`rotates the vector by a given angle in radians in place.`
+      | :sg:`rotate_ip_rad(angle) -> None`
+
+      DEPRECATED: Use rotate_rad_ip() instead.
+
+      .. 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`
+
+      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).
+
+      .. 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`
+
+      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.
+
+      .. figure:: code_examples/angle_to.png
+         :alt: angle_to image
+
+         Example demonstrating the angle returned
+
+      .. ## Vector2.angle_to ##
+
+   .. method:: as_polar
+
+      | :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 
+      is the azimuthal angle.
+
+      .. ## Vector2.as_polar ##
+
+   .. method:: from_polar
+
+      | :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`
+
+      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`
+
+      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 `_.
+
+      .. versionadded:: 2.0.2
+
+      .. ## Vector2.project ##
+
+   
+   .. method:: copy
+
+      | :sl:`Returns a copy of itself.`
+      | :sg:`copy() -> Vector2`
+
+      Returns a new Vector2 having the same dimensions.
+
+      .. 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`
+
+      **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.
+
+      .. versionadded:: 2.1.3
+
+      .. ## 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`
+
+      **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.
+
+      .. versionadded:: 2.1.3
+
+      .. ## Vector2.clamp_magnitude_ip ##
+
+
+   .. method:: update
+
+      | :sl:`Sets the coordinates of the vector.`
+      | :sg:`update() -> None`
+      | :sg:`update(int) -> None`
+      | :sg:`update(float) -> None`
+      | :sg:`update(Vector2) -> None`
+      | :sg:`update(x, y) -> None`
+      | :sg:`update((x, y)) -> None`
+
+      Sets coordinates x and y in place.
+
+      .. 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:
+
+         * comparing Vectors (``==`` and ``!=``)
+         * the ``is_normalized`` method (if the square of the length is within ``epsilon`` of 1, it's normalized)
+         * slerping (a Vector with a length of ``> True
+         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 
+      might help you out.
+
+
+   .. ## pygame.math.Vector2 ##
+
+.. class:: Vector3
+
+   | :sl:`a 3-Dimensional Vector`
+   | :sg:`Vector3() -> Vector3(0, 0, 0)`
+   | :sg:`Vector3(int) -> Vector3`
+   | :sg:`Vector3(float) -> Vector3`
+   | :sg:`Vector3(Vector3) -> Vector3`
+   | :sg:`Vector3(x, y, z) -> Vector3`
+   | :sg:`Vector3((x, y, z)) -> Vector3`
+
+   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`
+
+      .. ## Vector3.dot ##
+
+   .. method:: cross
+
+      | :sl:`calculates the cross- or vector-product`
+      | :sg:`cross(Vector3) -> Vector3`
+
+      calculates the cross-product.
+
+      .. ## Vector3.cross ##
+
+   .. method:: magnitude
+
+      | :sl:`returns the Euclidean magnitude of the vector.`
+      | :sg:`magnitude() -> float`
+
+      calculates the magnitude of the vector which follows from the
+      theorem: ``vec.magnitude() == math.sqrt(vec.x**2 + vec.y**2 + vec.z**2)``
+
+      .. ## Vector3.magnitude ##
+
+   .. method:: magnitude_squared
+
+      | :sl:`returns the squared Euclidean magnitude of the vector.`
+      | :sg:`magnitude_squared() -> float`
+
+      calculates the magnitude of the vector which follows from the
+      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.
+
+      .. ## Vector3.magnitude_squared ##
+
+   .. method:: length
+
+      | :sl:`returns the Euclidean length of the vector.`
+      | :sg:`length() -> float`
+
+      calculates the Euclidean length of the vector which follows from the
+      Pythagorean theorem: 
+      ``vec.length() == math.sqrt(vec.x**2 + vec.y**2 + vec.z**2)``
+
+      .. ## Vector3.length ##
+
+   .. method:: length_squared
+
+      | :sl:`returns the squared Euclidean length of the vector.`
+      | :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``. 
+      This is faster than ``vec.length()`` because it avoids the square root.
+
+      .. ## Vector3.length_squared ##
+
+   .. method:: normalize
+
+      | :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.
+
+      .. ## Vector3.normalize ##
+
+   .. method:: normalize_ip
+
+      | :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.
+
+      .. ## Vector3.normalize_ip ##
+
+   .. method:: is_normalized
+
+      | :sl:`tests if the vector is normalized i.e. has length == 1.`
+      | :sg:`is_normalized() -> Bool`
+
+      Returns True if the vector has ``length`` equal to ``1``. Otherwise it 
+      returns ``False``.
+
+      .. ## Vector3.is_normalized ##
+
+   .. method:: scale_to_length
+
+      | :sl:`scales the vector to a given length.`
+      | :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 
+      is the zero vector (i.e. has length ``0`` thus no direction) a
+      ``ValueError`` is raised.
+
+      .. ## Vector3.scale_to_length ##
+
+   .. method:: reflect
+
+      | :sl:`returns a vector reflected of a given normal.`
+      | :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
+      new vector is the same as self's.
+
+      .. ## Vector3.reflect ##
+
+   .. method:: reflect_ip
+
+      | :sl:`reflect the vector of a given normal in place.`
+      | :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.
+
+      .. ## Vector3.reflect_ip ##
+
+   .. method:: distance_to
+
+      | :sl:`calculates the Euclidean distance to a given vector.`
+      | :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`
+
+      .. ## 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`
+
+      **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.
+
+      .. versionadded:: 2.1.3
+
+      .. ## Vector3.move_towards ##
+
+   .. method:: move_towards_ip
+
+      | :sl:`moves the vector toward its target at a given distance.`
+      | :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.
+      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.
+
+      .. versionadded:: 2.1.3
+
+      .. ## Vector3.move_towards_ip ##
+
+   .. method:: lerp
+
+      | :sl:`returns a linear interpolation to the given vector.`
+      | :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 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 ##
+
+   .. method:: slerp
+
+      | :sl:`returns a spherical interpolation to the given vector.`
+      | :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
+      parametrizes where - in between the two vectors - the result should be.
+      If a negative value is given the interpolation will not take the
+      complement of the shortest path.
+
+      .. ## Vector3.slerp ##
+
+   .. method:: elementwise
+
+      | :sl:`The next operation will be performed elementwise.`
+      | :sg:`elementwise() -> VectorElementwiseProxy`
+
+      Applies the following operation to each element of the vector.
+
+      .. ## Vector3.elementwise ##
+
+   .. method:: rotate
+
+      | :sl:`rotates a vector by a given angle in degrees.`
+      | :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.
+      (Note that due to pygame's inverted y coordinate system, the rotation
+      will look clockwise if displayed).
+
+      .. ## Vector3.rotate ##
+
+   .. method:: rotate_rad
+
+      | :sl:`rotates a vector by a given angle in radians.`
+      | :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).
+
+      .. 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`
+
+      Rotates the vector counterclockwise around the given axis by the given
+      angle in degrees. 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).
+
+      .. ## Vector3.rotate_ip ##
+
+   .. method:: rotate_ip_rad
+
+      | :sl:`rotates the vector by a given angle in radians in place.`
+      | :sg:`rotate_ip_rad(angle, Vector3) -> None`
+
+      DEPRECATED: Use rotate_rad_ip() instead.
+
+      .. 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`
+
+      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).
+
+      .. 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`
+
+      Returns a vector which has the same length as self but is rotated
+      counterclockwise around the x-axis by the given angle in degrees.
+      (Note that due to pygame's inverted y coordinate system, the rotation
+      will look clockwise if displayed).
+
+      .. ## Vector3.rotate_x ##
+
+   .. method:: rotate_x_rad
+
+      | :sl:`rotates a vector around the x-axis by the angle in radians.`
+      | :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).
+
+      .. 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`
+
+      Rotates the vector counterclockwise around the x-axis by the given angle
+      in degrees. 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).
+
+      .. ## Vector3.rotate_x_ip ##
+
+   .. 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`
+
+      DEPRECATED: Use rotate_x_rad_ip() instead.
+
+      .. 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`
+
+      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).
+
+      .. 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`
+
+      Returns a vector which has the same length as self but is rotated
+      counterclockwise around the y-axis by the given angle in degrees.
+      (Note that due to pygame's inverted y coordinate system, the rotation
+      will look clockwise if displayed).
+
+      .. ## Vector3.rotate_y ##
+
+   .. method:: rotate_y_rad
+
+      | :sl:`rotates a vector around the y-axis by the angle in radians.`
+      | :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).
+
+      .. 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`
+
+      Rotates the vector counterclockwise around the y-axis by the given angle
+      in degrees. 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).
+
+      .. ## Vector3.rotate_y_ip ##
+
+   .. 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`
+
+      DEPRECATED: Use rotate_y_rad_ip() instead.
+
+      .. 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`
+
+      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).
+
+      .. 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`
+
+      Returns a vector which has the same length as self but is rotated
+      counterclockwise around the z-axis by the given angle in degrees.
+      (Note that due to pygame's inverted y coordinate system, the rotation
+      will look clockwise if displayed).
+
+      .. ## Vector3.rotate_z ##
+
+   .. method:: rotate_z_rad
+
+      | :sl:`rotates a vector around the z-axis by the angle in radians.`
+      | :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).
+
+      .. 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`
+
+      Rotates the vector counterclockwise around the z-axis by the given angle
+      in degrees. 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).
+
+      .. ## Vector3.rotate_z_ip ##
+
+   .. 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`
+
+      DEPRECATED: Use rotate_z_rad_ip() instead.
+      
+      .. 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`
+
+      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).
+
+      .. 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`
+
+      Returns the angle between self and the given vector.
+
+      .. ## Vector3.angle_to ##
+
+   .. method:: as_spherical
+
+      | :sl:`returns a tuple with radial distance, inclination and azimuthal angle.`
+      | :sg:`as_spherical() -> (r, theta, phi)`
+
+      Returns a tuple ``(r, theta, phi)`` where r is the radial distance, theta is
+      the inclination angle and phi is the azimuthal angle.
+
+      .. ## Vector3.as_spherical ##
+
+   .. method:: from_spherical
+
+      | :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`
+
+      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 ##
+
+   .. method:: project
+
+      | :sl:`projects a vector onto another.`
+      | :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). 
+      For a more detailed explanation see `Wikipedia `_.
+
+      .. versionadded:: 2.0.2
+
+      .. ## Vector3.project ##
+   
+   .. method:: copy
+
+      | :sl:`Returns a copy of itself.`
+      | :sg:`copy() -> Vector3`
+
+      Returns a new Vector3 having the same dimensions.
+
+      .. versionadded:: 2.1.1
+
+      .. ## Vector3.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) -> Vector3`
+      | :sg:`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.
+
+      .. versionadded:: 2.1.3
+
+      .. ## 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`
+
+      **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.
+
+      .. versionadded:: 2.1.3
+
+      .. ## Vector3.clamp_magnitude_ip ##
+
+   .. method:: update
+
+      | :sl:`Sets the coordinates of the vector.`
+      | :sg:`update() -> None`
+      | :sg:`update(int) -> None`
+      | :sg:`update(float) -> None`
+      | :sg:`update(Vector3) -> None`
+      | :sg:`update(x, y, z) -> None`
+      | :sg:`update((x, y, z)) -> None`
+
+      Sets coordinates x, y, and z in place.
+
+      .. 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 ##
+
+.. ## pygame.math ##
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_sources/ref/midi.rst.txt b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_sources/ref/midi.rst.txt
new file mode 100644
index 0000000..edc9f25
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_sources/ref/midi.rst.txt
@@ -0,0 +1,484 @@
+.. include:: common.txt
+
+:mod:`pygame.midi`
+==================
+
+.. module:: pygame.midi
+   :synopsis: pygame module for interacting with midi input and output.
+
+| :sl:`pygame module for interacting with midi input and output.`
+
+.. 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.
+
+The midi module supports real and virtual midi devices.
+
+It uses the portmidi library. Is portable to which ever platforms portmidi
+supports (currently Windows, Mac OS X, and Linux).
+
+This uses pyportmidi for now, but may use its own bindings at some point in the
+future. The pyportmidi bindings are included with pygame.
+
+|
+
+.. 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
+midi events to pygame events.
+
+::
+
+   MIDIIN
+   MIDIOUT
+
+|
+
+.. function:: init
+
+   | :sl:`initialize the midi module`
+   | :sg:`init() -> None`
+
+   Initializes the :mod:`pygame.midi` module. Must be called before using the
+   :mod:`pygame.midi` module.
+
+   It is safe to call this more than once.
+
+   .. ## pygame.midi.init ##
+
+.. function:: quit
+
+   | :sl:`uninitialize the midi module`
+   | :sg:`quit() -> None`
+
+   Uninitializes the :mod:`pygame.midi` module. If :func:`pygame.midi.init` was
+   called to initialize the :mod:`pygame.midi` module, then this function will
+   be called automatically when your program exits.
+
+   It is safe to call this function more than once.
+
+   .. ## pygame.midi.quit ##
+
+.. function:: get_init
+
+   | :sl:`returns True if the midi module is currently initialized`
+   | :sg:`get_init() -> bool`
+
+   Gets the initialization state of the :mod:`pygame.midi` module.
+
+   :returns: ``True`` if the :mod:`pygame.midi` module is currently initialized.
+   :rtype: bool
+
+   .. versionadded:: 1.9.5
+
+   .. ## pygame.midi.get_init ##
+
+.. class:: Input
+
+   | :sl:`Input is used to get midi input from midi devices.`
+   | :sg:`Input(device_id) -> None`
+   | :sg:`Input(device_id, buffer_size) -> None`
+
+   :param int device_id: midi device id
+   :param int buffer_size: (optional) the number of input events to be buffered
+
+   .. method:: close
+
+      | :sl:`closes a midi stream, flushing any pending buffers.`
+      | :sg:`close() -> None`
+
+      PortMidi attempts to close open streams when the application exits.
+
+      .. note:: This is particularly difficult under Windows.
+
+      .. ## Input.close ##
+
+   .. method:: poll
+
+      | :sl:`returns True if there's data, or False if not.`
+      | :sg:`poll() -> bool`
+
+      Used to indicate if any data exists.
+
+      :returns: ``True`` if there is data, ``False`` otherwise
+      :rtype: bool
+
+      :raises MidiException: on error
+
+      .. ## Input.poll ##
+
+   .. method:: read
+
+      | :sl:`reads num_events midi events from the buffer.`
+      | :sg:`read(num_events) -> midi_event_list`
+
+      Reads from the input buffer and gives back midi events.
+
+      :param int num_events: number of input events to read
+
+      :returns: the format for midi_event_list is
+         ``[[[status, data1, data2, data3], timestamp], ...]``
+      :rtype: list
+
+      .. ## Input.read ##
+
+   .. ## pygame.midi.Input ##
+
+.. class:: Output
+
+   | :sl:`Output is used to send midi to an output device`
+   | :sg:`Output(device_id) -> None`
+   | :sg:`Output(device_id, latency=0) -> None`
+   | :sg:`Output(device_id, buffer_size=256) -> None`
+   | :sg:`Output(device_id, latency, buffer_size) -> None`
+
+   The ``buffer_size`` specifies the number of output events to be buffered
+   waiting for output. In some cases (see below) PortMidi does not buffer
+   output at all and merely passes data to a lower-level API, in which case
+   buffersize is ignored.
+
+   ``latency`` is the delay in milliseconds applied to timestamps to determine
+   when the output should actually occur. If ``latency`` is <<0, 0 is assumed.
+
+   If ``latency`` is zero, timestamps are ignored and all output is delivered
+   immediately. If ``latency`` is greater than zero, output is delayed until the
+   message timestamp plus the ``latency``. In some cases, PortMidi can obtain
+   better timing than your application by passing timestamps along to the
+   device driver or hardware. Latency may also help you to synchronize midi
+   data to audio data by matching midi latency to the audio buffer latency.
+
+   .. note::
+      Time is measured relative to the time source indicated by time_proc.
+      Timestamps are absolute, not relative delays or offsets.
+
+   .. method:: abort
+
+      | :sl:`terminates outgoing messages immediately`
+      | :sg:`abort() -> None`
+
+      The caller should immediately close the output port; this call may result
+      in transmission of a partial midi message. There is no abort for Midi
+      input because the user can simply ignore messages in the buffer and close
+      an input device at any time.
+
+      .. ## Output.abort ##
+
+   .. method:: close
+
+      | :sl:`closes a midi stream, flushing any pending buffers.`
+      | :sg:`close() -> None`
+
+      PortMidi attempts to close open streams when the application exits.
+
+      .. note:: This is particularly difficult under Windows.
+
+      .. ## Output.close ##
+
+   .. method:: note_off
+
+      | :sl:`turns a midi note off (note must be on)`
+      | :sg:`note_off(note, velocity=None, channel=0) -> None`
+
+      Turn a note off in the output stream. The note must already be on for
+      this to work correctly.
+
+      .. ## Output.note_off ##
+
+   .. method:: note_on
+
+      | :sl:`turns a midi note on (note must be off)`
+      | :sg:`note_on(note, velocity=None, channel=0) -> None`
+
+      Turn a note on in the output stream. The note must already be off for
+      this to work correctly.
+
+      .. ## Output.note_on ##
+
+   .. method:: set_instrument
+
+      | :sl:`select an instrument, with a value between 0 and 127`
+      | :sg:`set_instrument(instrument_id, channel=0) -> None`
+
+      Select an instrument.
+
+      .. ## Output.set_instrument ##
+
+   .. method:: pitch_bend
+
+      | :sl:`modify the pitch of a channel.`
+      | :sg:`set_instrument(value=0, channel=0) -> None`
+
+      Adjust the pitch of a channel. The value is a signed integer
+      from -8192 to +8191. For example, 0 means "no change", +4096 is
+      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".
+
+      .. versionadded:: 1.9.4
+
+   .. method:: write
+
+      | :sl:`writes a list of midi data to the Output`
+      | :sg:`write(data) -> None`
+
+      Writes series of MIDI information in the form of a list.
+
+      :param list data: data to write, the expected format is
+         ``[[[status, data1=0, data2=0, ...], timestamp], ...]``
+         with the ``data#`` fields being optional
+
+      :raises IndexError: if more than 1024 elements in the data list
+
+      Example:
+      ::
+
+         # Program change at time 20000 and 500ms later send note 65 with
+         # velocity 100.
+         write([[[0xc0, 0, 0], 20000], [[0x90, 60, 100], 20500]])
+
+      .. note::
+         - Timestamps will be ignored if latency = 0
+         - To get a note to play immediately, send MIDI info with timestamp
+           read from function Time
+         - Optional data fields: ``write([[[0xc0, 0, 0], 20000]])`` is
+           equivalent to ``write([[[0xc0], 20000]])``
+
+      .. ## Output.write ##
+
+   .. method:: write_short
+
+      | :sl:`writes up to 3 bytes of midi data to the Output`
+      | :sg:`write_short(status) -> None`
+      | :sg:`write_short(status, data1=0, data2=0) -> None`
+
+      Output MIDI information of 3 bytes or less. The ``data`` fields are
+      optional and assumed to be 0 if omitted.
+
+      Examples of status byte values:
+      ::
+
+         0xc0  # program change
+         0x90  # note on
+         # etc.
+
+      Example:
+      ::
+
+         # note 65 on with velocity 100
+         write_short(0x90, 65, 100)
+
+      .. ## Output.write_short ##
+
+   .. method:: write_sys_ex
+
+      | :sl:`writes a timestamped system-exclusive midi message.`
+      | :sg:`write_sys_ex(when, msg) -> None`
+
+      Writes a timestamped system-exclusive midi message.
+
+      :param msg: midi message
+      :type msg: list[int] or str
+      :param when: timestamp in milliseconds
+
+      Example:
+      ::
+
+         midi_output.write_sys_ex(0, '\xF0\x7D\x10\x11\x12\x13\xF7')
+
+         # is equivalent to
+
+         midi_output.write_sys_ex(pygame.midi.time(),
+                                  [0xF0, 0x7D, 0x10, 0x11, 0x12, 0x13, 0xF7])
+
+      .. ## Output.write_sys_ex ##
+
+   .. ## pygame.midi.Output ##
+
+.. function:: get_count
+
+   | :sl:`gets the number of devices.`
+   | :sg:`get_count() -> num_devices`
+
+   Device ids range from 0 to ``get_count() - 1``
+
+   .. ## pygame.midi.get_count ##
+
+.. function:: get_default_input_id
+
+   | :sl:`gets default input device number`
+   | :sg:`get_default_input_id() -> default_id`
+
+   The following describes the usage details for this function and the
+   :func:`get_default_output_id` function.
+
+   Return the default device ID or ``-1`` if there are no devices. The result
+   can be passed to the :class:`Input`/:class:`Output` class.
+
+   On a PC the user can specify a default device by setting an environment
+   variable. To use device #1, for example:
+   ::
+
+      set PM_RECOMMENDED_INPUT_DEVICE=1
+      or
+      set PM_RECOMMENDED_OUTPUT_DEVICE=1
+
+   The user should first determine the available device ID by using the
+   supplied application "testin" or "testout".
+
+   In general, the registry is a better place for this kind of info. With
+   USB devices that can come and go, using integers is not very reliable
+   for device identification. Under Windows, if ``PM_RECOMMENDED_INPUT_DEVICE``
+   (or ``PM_RECOMMENDED_OUTPUT_DEVICE``) is NOT found in the environment,
+   then the default device is obtained by looking for a string in the registry
+   under:
+   ::
+
+      HKEY_LOCAL_MACHINE/SOFTWARE/PortMidi/Recommended_Input_Device
+      or
+      HKEY_LOCAL_MACHINE/SOFTWARE/PortMidi/Recommended_Output_Device
+
+
+   The number of the first device with a substring that matches the
+   string exactly is returned. For example, if the string in the registry is
+   "USB" and device 1 is named "In USB MidiSport 1x1", then that will be
+   the default input because it contains the string "USB".
+
+   In addition to the name, :func:`get_device_info()` returns "interf", which is
+   the interface name. The "interface" is the underlying software system or
+   API used by PortMidi to access devices. Supported interfaces:
+   ::
+
+      MMSystem   # the only Win32 interface currently supported
+      ALSA       # the only Linux interface currently supported
+      CoreMIDI   # the only Mac OS X interface currently supported
+      # DirectX - not implemented
+      # OSS     - not implemented
+
+   To specify both the interface and the device name in the registry, separate
+   the two with a comma and a space. The string before the comma must be a
+   substring of the "interf" string and the string after the space must be a
+   substring of the "name" name string in order to match the device. e.g.:
+   ::
+
+      MMSystem, In USB MidiSport 1x1
+
+   .. note::
+      In the current release, the default is simply the first device (the
+      input or output device with the lowest PmDeviceID).
+
+   .. ## pygame.midi.get_default_input_id ##
+
+.. function:: get_default_output_id
+
+   | :sl:`gets default output device number`
+   | :sg:`get_default_output_id() -> default_id`
+
+   See :func:`get_default_input_id` for usage details.
+
+   .. ## pygame.midi.get_default_output_id ##
+
+.. function:: get_device_info
+
+   | :sl:`returns information about a midi device`
+   | :sg:`get_device_info(an_id) -> (interf, name, input, output, opened)`
+   | :sg:`get_device_info(an_id) -> None`
+
+   Gets the device info for a given id.
+
+   :param int an_id: id of the midi device being queried
+
+   :returns: if the id is out of range ``None`` is returned, otherwise
+      a tuple of (interf, name, input, output, opened) is returned.
+
+         - interf: string describing the device interface (e.g. 'ALSA')
+         - name: string name of the device (e.g. 'Midi Through Port-0')
+         - input: 1 if the device is an input device, otherwise 0
+         - output: 1 if the device is an output device, otherwise 0
+         - opened: 1 if the device is opened, otherwise 0
+   :rtype: tuple or None
+
+   .. ## pygame.midi.get_device_info ##
+
+.. function:: midis2events
+
+   | :sl:`converts midi events to pygame events`
+   | :sg:`midis2events(midi_events, device_id) -> [Event, ...]`
+
+   Takes a sequence of midi events and returns list of pygame events.
+
+   The ``midi_events`` data is expected to be a sequence of
+   ``((status, data1, data2, data3), timestamp)`` midi events (all values
+   required).
+
+   :returns: a list of pygame events of event type ``MIDIIN``
+   :rtype: list
+
+   .. ## pygame.midi.midis2events ##
+
+.. function:: time
+
+   | :sl:`returns the current time in ms of the PortMidi timer`
+   | :sg:`time() -> time`
+
+   The time is reset to 0 when the :mod:`pygame.midi` module is initialized.
+
+   .. ## pygame.midi.time ##
+
+
+.. function:: frequency_to_midi
+
+   | :sl:`Converts a frequency into a MIDI note. Rounds to the closest midi note.`
+   | :sg:`frequency_to_midi(midi_note) -> midi_note`
+
+   example:
+   ::
+
+       frequency_to_midi(27.5) == 21
+
+   .. versionadded:: 1.9.5
+
+   .. ## pygame.midi.frequency_to_midi ##
+
+
+.. function:: midi_to_frequency
+
+   | :sl:`Converts a midi note to a frequency.`
+   | :sg:`midi_to_frequency(midi_note) -> frequency`
+
+   example:
+   ::
+
+       midi_to_frequency(21) == 27.5
+
+   .. versionadded:: 1.9.5
+
+   .. ## pygame.midi.midi_to_frequency ##
+
+
+.. function:: midi_to_ansi_note
+
+   | :sl:`Returns the Ansi Note name for a midi number.`
+   | :sg:`midi_to_ansi_note(midi_note) -> ansi_note`
+
+   example:
+   ::
+
+       midi_to_ansi_note(21) == 'A0'
+
+   .. versionadded:: 1.9.5
+
+   .. ## pygame.midi.midi_to_ansi_note ##
+
+.. exception:: MidiException
+
+   | :sl:`exception that pygame.midi functions and classes can raise`
+   | :sg:`MidiException(errno) -> None`
+
+   .. ## pygame.midi.MidiException ##
+
+
+.. ## pygame.midi ##
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_sources/ref/mixer.rst.txt b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_sources/ref/mixer.rst.txt
new file mode 100644
index 0000000..55aed07
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_sources/ref/mixer.rst.txt
@@ -0,0 +1,605 @@
+.. include:: common.txt
+
+:mod:`pygame.mixer`
+===================
+
+.. module:: pygame.mixer
+   :synopsis: pygame module for loading and playing sounds
+
+| :sl:`pygame module for loading and playing sounds`
+
+This module contains classes for loading Sound objects and controlling
+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
+channel automatically. The default is 8 simultaneous channels, but complex
+programs can get more precise control over the number of channels and their
+use.
+
+All sound playback is mixed in background threads. When you begin to play a
+Sound object, it will return immediately while the sound continues to play. A
+single Sound object can also be actively played back multiple times.
+
+The mixer also has a special streaming channel. This is for music playback and
+is accessed through the :mod:`pygame.mixer.music` module. Consider using this
+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. 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 :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)``
+
+
+.. function:: init
+
+   | :sl:`initialize the mixer module`
+   | :sg:`init(frequency=44100, size=-16, channels=2, buffer=512, devicename=None, allowedchanges=AUDIO_ALLOW_FREQUENCY_CHANGE | AUDIO_ALLOW_CHANNELS_CHANGE) -> None`
+
+   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 
+   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).
+
+   The size argument represents how many bits are used for each audio sample.
+   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.
+
+   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).
+
+   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
+   init. To solve this, mixer has a function ``pygame.mixer.pre_init()`` to set
+   the proper defaults before the toplevel init is used.
+
+   When using allowedchanges=0 it will convert the samples at runtime to match
+   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 SDL2 supports.
+
+   Apart from 0, allowedchanged accepts the following constants ORed together:
+
+      - AUDIO_ALLOW_FREQUENCY_CHANGE
+      - AUDIO_ALLOW_FORMAT_CHANGE
+      - AUDIO_ALLOW_CHANNELS_CHANGE
+      - AUDIO_ALLOW_ANY_CHANGE
+
+   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()``.
+
+   .. 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 ##
+
+.. function:: pre_init
+
+   | :sl:`preset the mixer init arguments`
+   | :sg:`pre_init(frequency=44100, size=-16, channels=2, buffer=512, devicename=None, allowedchanges=AUDIO_ALLOW_FREQUENCY_CHANGE | AUDIO_ALLOW_CHANNELS_CHANGE) -> None`
+
+   Call pre_init to change the defaults used when the real
+   ``pygame.mixer.init()`` is called. Keyword arguments are accepted. The best
+   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.
+
+   .. 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 ##
+
+.. function:: quit
+
+   | :sl:`uninitialize the mixer`
+   | :sg:`quit() -> None`
+
+   This will uninitialize :mod:`pygame.mixer`. All playback will stop and any
+   loaded Sound objects may not be compatible with the mixer if it is
+   reinitialized later.
+
+   .. ## pygame.mixer.quit ##
+
+.. function:: get_init
+
+   | :sl:`test if the mixer is initialized`
+   | :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:: stop
+
+   | :sl:`stop playback of all sound channels`
+   | :sg:`stop() -> None`
+
+   This will stop all playback of all active mixer channels.
+
+   .. ## pygame.mixer.stop ##
+
+.. function:: pause
+
+   | :sl:`temporarily stop playback of all sound channels`
+   | :sg:`pause() -> None`
+
+   This will temporarily stop all playback on the active mixer channels. The
+   playback can later be resumed with ``pygame.mixer.unpause()``
+
+   .. ## pygame.mixer.pause ##
+
+.. function:: unpause
+
+   | :sl:`resume paused playback of sound channels`
+   | :sg:`unpause() -> None`
+
+   This will resume all active sound channels after they have been paused.
+
+   .. ## pygame.mixer.unpause ##
+
+.. function:: fadeout
+
+   | :sl:`fade out the volume on all sounds before stopping`
+   | :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.
+
+   .. ## pygame.mixer.fadeout ##
+
+.. function:: set_num_channels
+
+   | :sl:`set the total number of playback channels`
+   | :sg:`set_num_channels(count) -> None`
+
+   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.
+
+   .. ## pygame.mixer.set_num_channels ##
+
+.. function:: get_num_channels
+
+   | :sl:`get the total number of playback channels`
+   | :sg:`get_num_channels() -> count`
+
+   Returns the number of currently active playback channels.
+
+   .. ## pygame.mixer.get_num_channels ##
+
+.. function:: set_reserved
+
+   | :sl:`reserve channels from being automatically used`
+   | :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 
+   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.
+
+   This allows the application to reserve a specific number of channels for
+   important sounds that must not be dropped or have a guaranteed channel to
+   play on.
+
+   Will return number of channels actually reserved, this may be less than requested
+   depending on the number of channels previously allocated.
+
+   .. ## pygame.mixer.set_reserved ##
+
+.. function:: find_channel
+
+   | :sl:`find an unused channel`
+   | :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
+   inactive channels and the force argument is ``True``, this will find the
+   Channel with the longest running Sound and return it.
+
+   .. ## pygame.mixer.find_channel ##
+
+.. 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 then this return ``False``.
+
+   .. ## pygame.mixer.get_busy ##
+
+.. function:: get_sdl_mixer_version
+
+   | :sl:`get the mixer's SDL version`
+   | :sg:`get_sdl_mixer_version() -> (major, minor, patch)`
+   | :sg:`get_sdl_mixer_version(linked=True) -> (major, minor, patch)`
+
+   :param bool linked: if ``True`` (default) the linked version number is
+      returned, otherwise the compiled version number is returned
+
+   :returns: the mixer's SDL library version number (linked or compiled
+      depending on the ``linked`` parameter) as a tuple of 3 integers
+      ``(major, minor, patch)``
+   :rtype: tuple
+
+   .. note::
+      The linked and compile version numbers should be the same.
+
+   .. versionadded:: 2.0.0
+
+   .. ## pygame.mixer.get_sdl_mixer_version ##
+
+.. class:: Sound
+
+   | :sl:`Create a new Sound object from a file or buffer object`
+   | :sg:`Sound(filename) -> Sound`
+   | :sg:`Sound(file=filename) -> Sound`
+   | :sg:`Sound(file=pathlib_path) -> Sound`
+   | :sg:`Sound(buffer) -> Sound`
+   | :sg:`Sound(buffer=buffer) -> Sound`
+   | :sg:`Sound(object) -> Sound`
+   | :sg:`Sound(file=object) -> Sound`
+   | :sg:`Sound(array=object) -> Sound`
+
+   Load a new sound buffer from a filename, a python file object or a readable
+   buffer object. Limited resampling will be performed to help the sample match
+   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 
+   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 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``.
+
+   Note: The buffer will be copied internally, no data will be shared between
+   it and the Sound object.
+
+   For now buffer and array support is consistent with ``sndarray.make_sound``
+   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.
+
+   .. versionadded:: 1.8 ``pygame.mixer.Sound(buffer)``
+   .. versionadded:: 1.9.2
+      :class:`pygame.mixer.Sound` keyword arguments and array interface support
+   .. versionadded:: 2.0.1 pathlib.Path support on Python 3.
+
+   .. method:: play
+
+      | :sl:`begin sound playback`
+      | :sg:`play(loops=0, maxtime=0, fade_ms=0) -> Channel`
+
+      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.
+
+      .. ## Sound.play ##
+
+   .. method:: stop
+
+      | :sl:`stop sound playback`
+      | :sg:`stop() -> None`
+
+      This will stop the playback of this Sound on any active Channels.
+
+      .. ## Sound.stop ##
+
+   .. method:: fadeout
+
+      | :sl:`stop sound playback after fading out`
+      | :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
+      playing channels.
+
+      .. ## Sound.fadeout ##
+
+   .. method:: set_volume
+
+      | :sl:`set the playback volume for this Sound`
+      | :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
+      future playback of this Sound.
+
+      :param float value: volume in the range of 0.0 to 1.0 (inclusive)
+
+         | If value < 0.0, the volume will not be changed
+         | If value > 1.0, the volume will be set to 1.0
+
+      .. ## Sound.set_volume ##
+
+   .. method:: get_volume
+
+      | :sl:`get the playback volume`
+      | :sg:`get_volume() -> value`
+
+      Return a value from 0.0 to 1.0 representing the volume for this Sound.
+
+      .. ## Sound.get_volume ##
+
+   .. method:: get_num_channels
+
+      | :sl:`count how many times this Sound is playing`
+      | :sg:`get_num_channels() -> count`
+
+      Return the number of active channels this sound is playing on.
+
+      .. ## Sound.get_num_channels ##
+
+   .. method:: get_length
+
+      | :sl:`get the length of the Sound`
+      | :sg:`get_length() -> seconds`
+
+      Return the length of this Sound in seconds.
+
+      .. ## Sound.get_length ##
+
+   .. method:: get_raw
+
+      | :sl:`return a bytestring copy of the Sound samples.`
+      | :sg:`get_raw() -> bytes`
+
+      Return a copy of the Sound object buffer as a bytes.
+
+      .. versionadded:: 1.9.2
+
+      .. ## Sound.get_raw ##
+
+   .. ## pygame.mixer.Sound ##
+
+.. class:: Channel
+
+   | :sl:`Create a Channel object for controlling playback`
+   | :sg:`Channel(id) -> Channel`
+
+   Return a Channel object for one of the current channels. The id must be a
+   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.
+
+   .. method:: play
+
+      | :sl:`play a Sound on a specific Channel`
+      | :sg:`play(Sound, loops=0, maxtime=0, fade_ms=0) -> None`
+
+      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.
+
+      .. ## Channel.play ##
+
+   .. method:: stop
+
+      | :sl:`stop playback on a Channel`
+      | :sg:`stop() -> None`
+
+      Stop sound playback on a channel. After playback is stopped the channel
+      becomes available for new Sounds to play on it.
+
+      .. ## Channel.stop ##
+
+   .. method:: pause
+
+      | :sl:`temporarily stop playback of a channel`
+      | :sg:`pause() -> None`
+
+      Temporarily stop the playback of sound on a channel. It can be resumed at
+      a later time with ``Channel.unpause()``
+
+      .. ## Channel.pause ##
+
+   .. method:: unpause
+
+      | :sl:`resume pause playback of a channel`
+      | :sg:`unpause() -> None`
+
+      Resume the playback on a paused channel.
+
+      .. ## Channel.unpause ##
+
+   .. method:: fadeout
+
+      | :sl:`stop playback after fading channel out`
+      | :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_volume
+
+      | :sl:`set the volume of a playing channel`
+      | :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 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).
+
+      .. ## Channel.set_volume ##
+
+   .. method:: get_volume
+
+      | :sl:`get the volume of the playing channel`
+      | :sg:`get_volume() -> value`
+
+      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.
+
+      .. ## Channel.get_volume ##
+
+   .. method:: get_busy
+
+      | :sl:`check if the channel is active`
+      | :sg:`get_busy() -> bool`
+
+      Returns ``True`` if the channel is actively mixing sound. If the channel
+      is idle this returns ``False``.
+
+      .. ## Channel.get_busy ##
+
+   .. method:: get_sound
+
+      | :sl:`get the currently playing Sound`
+      | :sg:`get_sound() -> Sound`
+
+      Return the actual Sound object currently playing on this channel. If the
+      channel is idle ``None`` is returned.
+
+      .. ## Channel.get_sound ##
+
+   .. method:: queue
+
+      | :sl:`queue a Sound object to follow the current`
+      | :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
+      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.
+
+      .. ## Channel.queue ##
+
+   .. method:: get_queue
+
+      | :sl:`return any Sound that is queued`
+      | :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.
+
+      .. ## Channel.get_queue ##
+
+   .. method:: set_endevent
+
+      | :sl:`have the channel send an event when playback stops`
+      | :sg:`set_endevent() -> 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
+      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.
+
+      .. ## Channel.set_endevent ##
+
+   .. method:: get_endevent
+
+      | :sl:`get the event a channel sends when playback stops`
+      | :sg:`get_endevent() -> type`
+
+      Returns the event type to be sent every time the Channel finishes
+      playback of a Sound. If there is no endevent the function returns
+      ``pygame.NOEVENT``.
+
+      .. ## Channel.get_endevent ##
+
+   .. ## pygame.mixer.Channel ##
+
+.. ## pygame.mixer ##
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_sources/ref/mouse.rst.txt b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_sources/ref/mouse.rst.txt
new file mode 100644
index 0000000..dda6c7b
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_sources/ref/mouse.rst.txt
@@ -0,0 +1,219 @@
+.. include:: common.txt
+
+:mod:`pygame.mouse`
+===================
+
+.. 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/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_sources/ref/music.rst.txt b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_sources/ref/music.rst.txt
new file mode 100644
index 0000000..96a7b81
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_sources/ref/music.rst.txt
@@ -0,0 +1,274 @@
+.. include:: common.txt
+
+:mod:`pygame.mixer.music`
+=========================
+
+.. module:: pygame.mixer.music
+   :synopsis: pygame module for controlling streamed audio
+
+| :sl:`pygame module for controlling streamed audio`
+
+The music module is closely tied to :mod:`pygame.mixer`. Use the music module
+to control the playback of music in the sound mixer.
+
+The difference between the music playback and regular Sound playback is that
+the music is streamed, and never actually loaded all at once. The mixer system
+only supports a single music stream at once.
+
+On older pygame versions, ``MP3`` support was limited under Mac and Linux. This
+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.
+
+.. function:: load
+
+   | :sl:`Load a music file for playback`
+   | :sg:`load(filename) -> None`
+   | :sg:`load(fileobj, namehint="") -> None`
+
+   This will load a music filename/file object and prepare it for playback. If
+   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: :code:`load(fileobj, "ogg")`.
+
+   .. versionchanged:: 2.0.2 Added optional ``namehint`` argument
+
+   .. ## pygame.mixer.music.load ##
+
+.. function:: unload
+
+   | :sl:`Unload the currently loaded music to free up resources`
+   | :sg:`unload() -> None`
+
+   This closes resources like files for any music that may be loaded.
+
+   .. versionadded:: 2.0.0
+
+   .. ## pygame.mixer.music.load ##
+
+
+.. function:: play
+
+   | :sl:`Start the playback of the music stream`
+   | :sg:`play(loops=0, start=0.0, fade_ms=0) -> None`
+
+   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 
+   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 
+   the start position cannot be set.
+
+   ``fade_ms`` is an optional integer argument, which is ``0`` by default,
+   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 :func:`set_volume`). The sample may end before the fade-in
+   is complete. If the music is already streaming ``fade_ms`` is ignored.
+   
+   .. versionchanged:: 2.0.0 Added optional ``fade_ms`` argument
+
+   .. ## pygame.mixer.music.play ##
+
+.. function:: rewind
+
+   | :sl:`restart music`
+   | :sg:`rewind() -> None`
+
+   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
+             will start the music playing again even if previously paused).
+
+   .. ## pygame.mixer.music.rewind ##
+
+.. function:: stop
+
+   | :sl:`stop the music playback`
+   | :sg:`stop() -> None`
+
+   Stops the music playback if it is currently playing.
+   endevent will be triggered, if set.
+   It won't unload the music.
+
+   .. ## pygame.mixer.music.stop ##
+
+.. function:: pause
+
+   | :sl:`temporarily stop music playback`
+   | :sg:`pause() -> None`
+
+   Temporarily stop playback of the music stream. It can be resumed with the
+   :func:`unpause` function.
+
+   .. ## pygame.mixer.music.pause ##
+
+.. function:: unpause
+
+   | :sl:`resume paused music`
+   | :sg:`unpause() -> None`
+
+   This will resume the playback of a music stream after it has been paused.
+
+   .. ## pygame.mixer.music.unpause ##
+
+.. function:: fadeout
+
+   | :sl:`stop music playback after fading out`
+   | :sg:`fadeout(time) -> None`
+
+   Fade out and stop the currently playing music.
+
+   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 
+   called after the music has faded.
+
+   .. ## pygame.mixer.music.fadeout ##
+
+.. function:: set_volume
+
+   | :sl:`set the music volume`
+   | :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 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``.
+
+   .. ## pygame.mixer.music.set_volume ##
+
+.. function:: get_volume
+
+   | :sl:`get the music volume`
+   | :sg:`get_volume() -> value`
+
+   Returns the current volume for the mixer. The value will be between ``0.0`` 
+   and ``1.0``.
+
+   .. ## pygame.mixer.music.get_volume ##
+
+.. function:: get_busy
+
+   | :sl:`check if the music stream is playing`
+   | :sg:`get_busy() -> bool`
+
+   Returns True when the music stream is actively playing. When the music is
+   idle this returns False. In pygame 2.0.1 and above this function returns
+   False when the music is paused. In pygame 1 it returns True when the music
+   is 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`
+
+   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,
+   in seconds, from the current position. For absolute positioning in an ``MP3``
+   file, first call :func:`rewind`.
+
+   Other file formats are unsupported. Newer versions of SDL_mixer have
+   better positioning support than earlier ones. An SDLError is raised if a
+   particular format does not support positioning.
+
+   Function :func:`set_pos` calls underlining SDL_mixer function
+   ``Mix_SetMusicPosition``.
+
+   .. versionadded:: 1.9.2
+
+   .. ## pygame.mixer.music.set_pos ##
+
+.. function:: get_pos
+
+   | :sl:`get the music play time`
+   | :sg:`get_pos() -> time`
+
+   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.
+
+   .. ## pygame.mixer.music.get_pos ##
+
+.. function:: queue
+
+   | :sl:`queue a sound file to follow the current`
+   | :sg:`queue(filename) -> None`
+   | :sg:`queue(fileobj, namehint="", loops=0) -> None`
+
+   This will load a sound file and queue it. A queued sound file will begin as
+   soon as the current sound naturally ends. Only one sound can be queued at a
+   time. Queuing a new sound while another sound is queued will result in the
+   new sound becoming the queued sound. Also, if the current sound is ever
+   stopped or changed, the queued sound will be lost.
+
+   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:`queue(fileobj, "ogg")`.
+
+   The following example will play music by Bach six times, then play music by
+   Mozart once:
+
+   ::
+
+       pygame.mixer.music.load('bach.ogg')
+       pygame.mixer.music.play(5)        # Plays six times, not five!
+       pygame.mixer.music.queue('mozart.ogg')
+
+   .. versionchanged:: 2.0.2 Added optional ``namehint`` argument
+
+   .. ## pygame.mixer.music.queue ##
+
+.. function:: set_endevent
+
+   | :sl:`have the music send an event when playback stops`
+   | :sg:`set_endevent() -> 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.
+
+   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.
+
+   .. ## pygame.mixer.music.set_endevent ##
+
+.. function:: get_endevent
+
+   | :sl:`get the event a channel sends when playback stops`
+   | :sg:`get_endevent() -> type`
+
+   Returns the event type to be sent every time the music finishes playback. If
+   there is no endevent the function returns ``pygame.NOEVENT``.
+
+   .. ## pygame.mixer.music.get_endevent ##
+
+.. ## pygame.mixer.music ##
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_sources/ref/overlay.rst.txt b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_sources/ref/overlay.rst.txt
new file mode 100644
index 0000000..04ff9ae
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_sources/ref/overlay.rst.txt
@@ -0,0 +1,79 @@
+.. include:: common.txt
+
+:mod:`pygame.Overlay`
+=====================
+
+.. currentmodule:: pygame
+
+.. warning::
+	This module is non functional in pygame 2.0 and above, unless you have manually compiled pygame with SDL1.
+	This module will not be supported in the future.
+
+.. class:: Overlay
+
+   | :sl:`pygame object for video overlay graphics`
+   | :sg:`Overlay(format, (width, height)) -> Overlay`
+
+   The Overlay objects provide support for accessing hardware video overlays.
+   Video overlays do not use standard ``RGB`` pixel formats, and can use
+   multiple resolutions of data to create a single image.
+
+   The Overlay objects represent lower level access to the display hardware. To
+   use the object you must understand the technical details of video overlays.
+
+   The Overlay format determines the type of pixel data used. Not all hardware
+   will support all types of overlay formats. Here is a list of available
+   format types:
+
+   ::
+
+     YV12_OVERLAY, IYUV_OVERLAY, YUY2_OVERLAY, UYVY_OVERLAY, YVYU_OVERLAY
+
+   The width and height arguments control the size for the overlay image data.
+   The overlay image can be displayed at any size, not just the resolution of
+   the overlay.
+
+   The overlay objects are always visible, and always show above the regular
+   display contents.
+
+   .. method:: display
+
+      | :sl:`set the overlay pixel data`
+      | :sg:`display((y, u, v)) -> None`
+      | :sg:`display() -> None`
+
+      Display the YUV data in SDL's overlay planes. The y, u, and v arguments
+      are strings of binary data. The data must be in the correct format used
+      to create the Overlay.
+
+      If no argument is passed in, the Overlay will simply be redrawn with the
+      current data. This can be useful when the Overlay is not really hardware
+      accelerated.
+
+      The strings are not validated, and improperly sized strings could crash
+      the program.
+
+      .. ## Overlay.display ##
+
+   .. method:: set_location
+
+      | :sl:`control where the overlay is displayed`
+      | :sg:`set_location(rect) -> None`
+
+      Set the location for the overlay. The overlay will always be shown
+      relative to the main display Surface. This does not actually redraw the
+      overlay, it will be updated on the next call to ``Overlay.display()``.
+
+      .. ## Overlay.set_location ##
+
+   .. method:: get_hardware
+
+      | :sl:`test if the Overlay is hardware accelerated`
+      | :sg:`get_hardware(rect) -> int`
+
+      Returns a True value when the Overlay is hardware accelerated. If the
+      platform does not support acceleration, software rendering is used.
+
+      .. ## Overlay.get_hardware ##
+
+   .. ## pygame.Overlay ##
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_sources/ref/pixelarray.rst.txt b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_sources/ref/pixelarray.rst.txt
new file mode 100644
index 0000000..9bdc38c
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_sources/ref/pixelarray.rst.txt
@@ -0,0 +1,295 @@
+.. include:: common.txt
+
+:class:`pygame.PixelArray`
+==========================
+
+.. currentmodule:: pygame
+
+.. class:: PixelArray
+
+   | :sl:`pygame object for direct pixel access of surfaces`
+   | :sg:`PixelArray(Surface) -> PixelArray`
+
+   The PixelArray wraps a Surface and provides direct access to the
+   surface's pixels. A pixel array can be one or two dimensional.
+   A two dimensional array, like its surface, is indexed [column, row].
+   Pixel arrays support slicing, both for returning a subarray or
+   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 :mod:`pygame.pixelcopy` methods and NumPy
+   arrays.
+
+   A PixelArray pixel item can be assigned a raw integer values, a
+   :class:`pygame.Color` 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)
+
+   However, only a pixel's integer value is returned. So, to compare a pixel
+   to a particular color the color needs to be first mapped using
+   the :meth:`Surface.map_rgb()` method of the Surface object for which the
+   PixelArray was created.
+
+   ::
+
+     pxarray = pygame.PixelArray(surface)
+     # Check, if the first pixel at the topleft corner is blue
+     if pxarray[0, 0] == surface.map_rgb((0, 0, 255)):
+         ...
+
+   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
+     pxarray[a:b] = (0xFF00FF, 0xAACCEE, ... ) # first pixel = 0xFF00FF,
+                                               # second pixel  = 0xAACCEE, ...
+     pxarray[a:b] = [(255, 0, 255), (170, 204, 238), ...] # same as above
+     pxarray[a:b] = [(255, 0, 255), 0xAACCEE, ...]        # same as above
+     pxarray[a:b] = otherarray[x:y]            # slice sizes must match
+
+   For PixelArray assignment, if the right hand side array has a row length
+   of 1, then the column is broadcast over the target array's rows. An
+   array of height 1 is broadcast over the target's columns, and is equivalent
+   to assigning a 1D PixelArray.
+
+   Subscript slices can also be used to assign to a rectangular subview of
+   the target PixelArray.
+
+   ::
+
+     # Create some new PixelArray objects providing a different view
+     # of the original array/surface.
+     newarray = pxarray[2:4, 3:5]
+     otherarray = pxarray[::2, ::2]
+
+   Subscript slices can also be used to do fast rectangular pixel manipulations
+   instead of iterating over the x or y axis. The
+
+   ::
+
+     pxarray[::2, :] = (0, 0, 0)               # Make even columns black.
+     pxarray[::2] = (0, 0, 0)                  # Same as [::2, :]
+
+   During its lifetime, the PixelArray locks the surface, thus you explicitly
+   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.
+
+   ::
+
+     pxarray[::2, ...] = (0, 0, 0)             # Same as pxarray[::2, :]
+     pxarray[...] = (255, 0, 0)                # Same as pxarray[:]
+
+   A note about PixelArray to PixelArray assignment, for arrays with an
+   item size of 3 (created from 24 bit surfaces) pixel values are translated
+   from the source to the destinations format. The red, green, and blue
+   color elements of each pixel are shifted to match the format of the
+   target surface. For all other pixel sizes no such remapping occurs.
+   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.
+
+   .. 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).
+
+   .. versionadded:: 1.9.2
+
+    - array struct interface
+    - transpose method
+    - broadcasting for a length 1 dimension
+
+   .. 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.
+    - For assignment, a tuple can only be a color. Any other sequence type
+      is a sequence of colors.
+
+
+   .. versionadded: 1.8.0
+      Subscript support
+
+   .. versionadded: 1.8.1
+      Methods :meth:`make_surface`, :meth:`replace`, :meth:`extract`, and
+      :meth:`compare`
+
+   .. versionadded: 1.9.2
+      Properties :attr:`itemsize`, :attr:`ndim`, :attr:`shape`,
+      and :attr:`strides`
+
+   .. versionadded: 1.9.2
+      Array struct interface
+
+   .. versionadded: 1.9.4
+      Methods :meth:`close`
+
+   .. attribute:: surface
+
+      | :sl:`Gets the Surface the PixelArray uses.`
+      | :sg:`surface -> Surface`
+
+      The Surface the PixelArray was created for.
+
+      .. ## PixelArray.surface ##
+
+   .. attribute:: itemsize
+
+      | :sl:`Returns the byte size of a pixel array item`
+      | :sg:`itemsize -> int`
+
+      This is the same as :meth:`Surface.get_bytesize` for the
+      pixel array's surface.
+
+      .. versionadded:: 1.9.2
+
+   .. attribute:: ndim
+
+      | :sl:`Returns the number of dimensions.`
+      | :sg:`ndim -> int`
+
+      A pixel array can be 1 or 2 dimensional.
+
+      .. versionadded:: 1.9.2
+
+   .. attribute:: shape
+
+      | :sl:`Returns the array size.`
+      | :sg:`shape -> tuple of int's`
+
+      A tuple or length :attr:`ndim` giving the length of each
+      dimension. Analogous to :meth:`Surface.get_size`.
+
+      .. versionadded:: 1.9.2
+
+   .. attribute:: strides
+
+      | :sl:`Returns byte offsets for each array dimension.`
+      | :sg:`strides -> tuple of int's`
+
+      A tuple or length :attr:`ndim` byte counts. When a stride is
+      multiplied by the corresponding index it gives the offset
+      of that index from the start of the array. A stride is negative
+      for an array that has is inverted (has a negative step).
+
+      .. versionadded:: 1.9.2
+
+   .. method:: make_surface
+
+      | :sl:`Creates a new Surface from the current PixelArray.`
+      | :sg:`make_surface() -> Surface`
+
+      Creates a new Surface from the current PixelArray. Depending on the
+      current PixelArray the size, pixel order etc. will be different from the
+      original Surface.
+
+      ::
+
+        # Create a new surface flipped around the vertical axis.
+        sf = pxarray[:,::-1].make_surface ()
+
+      .. versionadded:: 1.8.1
+
+      .. ## PixelArray.make_surface ##
+
+   .. method:: replace
+
+      | :sl:`Replaces the passed color in the PixelArray with another one.`
+      | :sg:`replace(color, repcolor, distance=0, weights=(0.299, 0.587, 0.114)) -> None`
+
+      Replaces the pixels with the passed color in the PixelArray by changing
+      them them to the passed replacement color.
+
+      It uses a simple weighted Euclidean distance formula to calculate the
+      distance between the colors. The distance space ranges from 0.0 to 1.0
+      and is used as threshold for the color detection. This causes the
+      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.
+
+      .. versionadded:: 1.8.1
+
+      .. ## PixelArray.replace ##
+
+   .. method:: extract
+
+      | :sl:`Extracts the passed color from the PixelArray.`
+      | :sg:`extract(color, distance=0, weights=(0.299, 0.587, 0.114)) -> PixelArray`
+
+      Extracts the passed color by changing all matching pixels to white, while
+      non-matching pixels are changed to black. This returns a new PixelArray
+      with the black/white color mask.
+
+      It uses a simple weighted Euclidean distance formula to calculate the
+      distance between the colors. The distance space ranges from 0.0 to 1.0
+      and is used as threshold for the color detection. This causes the
+      extraction to take pixels with a similar, but not exactly identical
+      color, into account as well.
+
+      .. versionadded:: 1.8.1
+
+      .. ## PixelArray.extract ##
+
+   .. method:: compare
+
+      | :sl:`Compares the PixelArray with another one.`
+      | :sg:`compare(array, distance=0, weights=(0.299, 0.587, 0.114)) -> PixelArray`
+
+      Compares the contents of the PixelArray with those from the passed in
+      PixelArray. It returns a new PixelArray with a black/white color mask
+      that indicates the differences (black) of both arrays. Both PixelArray
+      objects must have identical bit depths and dimensions.
+
+      It uses a simple weighted Euclidean distance formula to calculate the
+      distance between the colors. The distance space ranges from 0.0 to 1.0
+      and is used as a threshold for the color detection. This causes the
+      comparison to mark pixels with a similar, but not exactly identical
+      color, as white.
+
+      .. versionadded:: 1.8.1
+
+      .. ## PixelArray.compare ##
+
+   .. method:: transpose
+
+      | :sl:`Exchanges the x and y axis.`
+      | :sg:`transpose() -> PixelArray`
+
+      This method returns a new view of the pixel array with the rows and
+      columns swapped. So for a (w, h) sized array a (h, w) slice is returned.
+      If an array is one dimensional, then a length 1 x dimension is added,
+      resulting in a 2D pixel array.
+
+      .. versionadded:: 1.9.2
+
+      .. ## PixelArray.transpose ##
+
+   .. method:: close
+
+      | :sl:`Closes the PixelArray, and releases Surface lock.`
+      | :sg:`close() -> PixelArray`
+
+      This method is for explicitly closing the PixelArray, and releasing
+      a lock on the Surface.
+
+      .. versionadded:: 1.9.4
+
+      .. ## PixelArray.close ##
+
+
+   .. ## pygame.PixelArray ##
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_sources/ref/pixelcopy.rst.txt b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_sources/ref/pixelcopy.rst.txt
new file mode 100644
index 0000000..dd8ecf7
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_sources/ref/pixelcopy.rst.txt
@@ -0,0 +1,104 @@
+.. include:: common.txt
+
+:mod:`pygame.pixelcopy`
+=======================
+
+.. 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/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_sources/ref/pygame.rst.txt b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_sources/ref/pygame.rst.txt
new file mode 100644
index 0000000..9a518fc
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_sources/ref/pygame.rst.txt
@@ -0,0 +1,505 @@
+.. include:: common.txt
+
+:mod:`pygame`
+=============
+
+.. module:: pygame
+   :synopsis: the top level pygame package
+
+| :sl:`the top level pygame package`
+
+The pygame package represents the top-level package for others to use. Pygame
+itself is broken into many submodules, but this does not affect programs that
+use pygame.
+
+As a convenience, most of the top-level variables in pygame have been placed
+inside a module named :mod:`pygame.locals`. This is meant to be used with
+``from pygame.locals import *``, in addition to ``import pygame``.
+
+When you ``import pygame`` all available pygame submodules are automatically
+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.
+
+.. function:: init
+
+   | :sl:`initialize all imported pygame modules`
+   | :sg:`init() -> (numpass, numfail)`
+
+   Initialize all imported pygame modules. No exceptions will be raised if a
+   module fails, but the total number if successful and failed inits will be
+   returned as a tuple. You can always initialize individual modules manually,
+   but :func:`pygame.init` is a convenient way to get everything started. The
+   ``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 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.
+
+   .. ## pygame.init ##
+
+.. function:: quit
+
+   | :sl:`uninitialize all pygame modules`
+   | :sg:`quit() -> None`
+
+   Uninitialize all pygame modules that have previously been initialized. When
+   the Python interpreter shuts down, this method is called regardless, so your
+   program should not need it, except when it wants to terminate its pygame
+   resources and continue. It is safe to call this function more than once as
+   repeated calls have no effect.
+
+   .. note::
+      Calling :func:`pygame.quit` will not exit your program. Consider letting
+      your program end in the same way a normal Python program will end.
+
+   .. ## pygame.quit ##
+
+.. function:: get_init
+
+   | :sl:`returns True if pygame is currently initialized`
+   | :sg:`get_init() -> bool`
+
+   Returns ``True`` if pygame is currently initialized.
+
+   .. versionadded:: 1.9.5
+
+   .. ## pygame.get_init ##
+
+.. exception:: error
+
+   | :sl:`standard pygame exception`
+   | :sg:`raise pygame.error(message)`
+
+   This exception is raised whenever a pygame or SDL operation fails. You
+   can catch any anticipated problems and deal with the error. The exception is
+   always raised with a descriptive message about the problem.
+
+   Derived from the ``RuntimeError`` exception, which can also be used to catch
+   these raised errors.
+
+   .. ## pygame.error ##
+
+.. function:: get_error
+
+   | :sl:`get the current error message`
+   | :sg:`get_error() -> errorstr`
+
+   SDL maintains an internal error message. This message will usually be
+   given to you when :func:`pygame.error` is raised, so this function will
+   rarely be needed.
+
+   .. ## pygame.get_error ##
+
+.. function:: set_error
+
+   | :sl:`set the current error message`
+   | :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
+   rarely be needed.
+
+   .. ## pygame.set_error ##
+
+.. function:: get_sdl_version
+
+   | :sl:`get the version number of SDL`
+   | :sg:`get_sdl_version(linked=True) -> major, minor, patch`
+
+   Returns the three version numbers of the SDL library. ``linked=True``
+   will cause the function to return the version of the library that pygame
+   is linked against while ``linked=False`` will cause the function to return
+   the version of the library that pygame is compiled against.
+   It can be used to detect which features may or may not be
+   available through pygame.
+
+   .. versionadded:: 1.7.0
+
+   .. versionchanged:: 2.2.0 ``linked`` keyword argument added
+
+   .. ## pygame.get_sdl_version ##
+
+.. function:: get_sdl_byteorder
+
+   | :sl:`get the byte order of SDL`
+   | :sg:`get_sdl_byteorder() -> int`
+
+   Returns the byte order of the SDL library. It returns ``1234`` for little
+   endian byte order and ``4321`` for big endian byte order.
+
+   .. 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`
+
+   When :func:`pygame.quit` is called, all registered quit functions are
+   called. Pygame modules do this automatically when they are initializing, so
+   this function will rarely be needed.
+
+   .. ## pygame.register_quit ##
+
+.. function:: encode_string
+
+   | :sl:`Encode a Unicode or bytes object`
+   | :sg:`encode_string([obj [, encoding [, errors [, etype]]]]) -> bytes or None`
+
+   obj: If Unicode, encode; if bytes, return unaltered; if anything else,
+   return ``None``; if not given, raise ``SyntaxError``.
+
+   encoding (string): If present, encoding to use. The default is
+   ``'unicode_escape'``.
+
+   errors (string): If given, how to handle unencodable characters. The default
+   is ``'backslashreplace'``.
+
+   etype (exception type): If given, the exception type to raise for an
+   encoding error. The default is ``UnicodeEncodeError``, as returned by
+   ``PyUnicode_AsEncodedString()``. For the default encoding and errors values
+   there should be no encoding errors.
+
+   This function is used in encoding file paths. Keyword arguments are
+   supported.
+
+   .. versionadded:: 1.9.2 (primarily for use in unit tests)
+
+   .. ## pygame.encode_string ##
+
+.. function:: encode_file_path
+
+   | :sl:`Encode a Unicode or bytes object as a file system path`
+   | :sg:`encode_file_path([obj [, etype]]) -> bytes or None`
+
+   obj: If Unicode, encode; if bytes, return unaltered; if anything else,
+   return ``None``; if not given, raise ``SyntaxError``.
+
+   etype (exception type): If given, the exception type to raise for an
+   encoding error. The default is ``UnicodeEncodeError``, as returned by
+   ``PyUnicode_AsEncodedString()``.
+
+   This function is used to encode file paths in pygame. Encoding is to the
+   codec as returned by ``sys.getfilesystemencoding()``. Keyword arguments are
+   supported.
+
+   .. versionadded:: 1.9.2 (primarily for use in unit tests)
+
+   .. ## pygame.encode_file_path ##
+
+
+:mod:`pygame.version`
+=====================
+
+.. module:: pygame.version
+   :synopsis: small module containing version information
+
+| :sl:`small module containing version information`
+
+This module is automatically imported into the pygame package and can be used to
+check which version of pygame has been imported.
+
+.. data:: ver
+
+   | :sl:`version number as a string`
+   | :sg:`ver = '1.2'`
+
+   This is the version represented as a string. It can contain a micro release
+   number as well, e.g. ``'1.5.2'``
+
+   .. ## pygame.version.ver ##
+
+.. data:: vernum
+
+   | :sl:`tupled integers of the version`
+   | :sg:`vernum = (1, 5, 3)`
+
+   This version information can easily be compared with other version
+   numbers of the same format. An example of checking pygame version numbers
+   would look like this:
+
+   ::
+
+       if pygame.version.vernum < (1, 5):
+           print('Warning, older version of pygame (%s)' %  pygame.version.ver)
+           disable_advanced_features = True
+
+   .. versionadded:: 1.9.6 Attributes ``major``, ``minor``, and ``patch``.
+
+   ::
+
+      vernum.major == vernum[0]
+      vernum.minor == vernum[1]
+      vernum.patch == vernum[2]
+
+   .. versionchanged:: 1.9.6
+      ``str(pygame.version.vernum)`` returns a string like ``"2.0.0"`` instead
+      of ``"(2, 0, 0)"``.
+
+   .. versionchanged:: 1.9.6
+      ``repr(pygame.version.vernum)`` returns a string like
+      ``"PygameVersion(major=2, minor=0, patch=0)"`` instead of ``"(2, 0, 0)"``.
+
+   .. ## pygame.version.vernum ##
+
+.. data:: rev
+
+   | :sl:`repository revision of the build`
+   | :sg:`rev = 'a6f89747b551+'`
+
+   The Mercurial node identifier of the repository checkout from which this
+   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 
+   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``.
+   
+   .. versionchanged:: 1.9.5
+      Always returns an empty string ``""``.
+
+   .. ## pygame.version.rev ##
+
+.. data:: SDL
+
+   | :sl:`tupled integers of the SDL library version`
+   | :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:
+
+   ::
+
+     >>> pygame.version.SDL.major
+     2
+
+   printing the whole thing returns a string like this:
+
+   ::
+
+    >>> pygame.version.SDL
+    SDLVersion(major=2, minor=0, patch=12)
+
+   .. versionadded:: 2.0.0
+
+   .. ## pygame.version.SDL ##
+
+.. ## pygame.version ##
+
+.. ## pygame ##
+
+.. _environment-variables:
+
+**Setting Environment Variables**
+
+Some aspects of pygame's behaviour can be controlled by setting environment variables, they cover a wide
+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
+     os.environ['NAME_OF_ENVIRONMENT_VARIABLE'] = 'value_to_set'
+
+Or to preserve users ability to override the variable::
+
+     import os
+     os.environ['ENV_VAR'] = os.environ.get('ENV_VAR', 'value')
+
+If the variable is more useful for users of an app to set than the developer then they can set it like this:
+
+**Windows**::
+
+    set NAME_OF_ENVIRONMENT_VARIABLE=value_to_set
+    python my_application.py
+
+**Linux/Mac**::
+
+    ENV_VAR=value python my_application.py
+
+For some variables they need to be set before initialising pygame, some must be set before even importing pygame,
+and others can simply be set right before the area of code they control is run.
+
+Below is a list of environment variables, their settable values, and a brief description of what they do.
+
+|
+
+**Pygame Environment Variables**
+
+These variables are defined by pygame itself.
+
+|
+
+::
+
+ PYGAME_DISPLAY - Experimental (subject to change)
+ Set index of the display to use, "0" is the default.
+
+This sets the display where pygame will open its window
+or screen. The value set here will be used if set before
+calling :func:`pygame.display.set_mode()`, and as long as no
+'display' parameter is passed into :func:`pygame.display.set_mode()`.
+
+|
+
+::
+
+ PYGAME_FORCE_SCALE -
+ Set to "photo" or "default".
+
+This forces set_mode() to use the SCALED display mode and,
+if "photo" is set, makes the scaling use the slowest, but
+highest quality anisotropic scaling algorithm, if it is
+available. Must be set before calling :func:`pygame.display.set_mode()`.
+
+|
+
+::
+
+ PYGAME_BLEND_ALPHA_SDL2 - New in pygame 2.0.0
+ Set to "1" to enable the SDL2 blitter.
+
+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 colours may differ. Must be set before
+:func:`pygame.init()` is called.
+
+|
+
+::
+
+ PYGAME_HIDE_SUPPORT_PROMPT -
+ Set to "1" to hide the prompt.
+
+This stops the welcome message popping up in the
+console that tells you which version of python,
+pygame & SDL you are using. Must be set before
+importing pygame.
+
+|
+
+::
+
+ PYGAME_FREETYPE -
+ Set to "1" to enable.
+
+This switches the pygame.font module to a pure
+freetype implementation that bypasses SDL_ttf.
+See the font module for why you might want to
+do this. Must be set before importing pygame.
+
+|
+
+::
+
+ PYGAME_CAMERA -
+ Set to "opencv" or "vidcapture"
+
+Forces the library backend used in the camera
+module, overriding the platform defaults. Must
+be set before calling :func:`pygame.camera.init()`.
+
+In pygame 2.0.3, backends can be set programmatically instead, and the old
+OpenCV backend has been replaced with one on top of "opencv-python," rather
+than the old "highgui" OpenCV port. Also, there is a new native Windows
+backend available.
+
+|
+|
+
+**SDL Environment Variables**
+
+These variables are defined by SDL.
+
+For documentation on the environment variables available in
+pygame 1 try `here
+`__.
+For Pygame 2, some selected environment variables are listed below.
+
+|
+
+::
+
+ SDL_VIDEO_CENTERED -
+ Set to "1" to enable centering the window.
+
+This will make the pygame window open in the centre of the display.
+Must be set before calling :func:`pygame.display.set_mode()`.
+
+|
+
+::
+
+ SDL_VIDEO_WINDOW_POS -
+ Set to "x,y" to position the top left corner of the window.
+
+This allows control over the placement of the pygame window within
+the display. Must be set before calling :func:`pygame.display.set_mode()`.
+
+|
+
+::
+
+ SDL_VIDEODRIVER -
+ Set to "drivername" to change the video driver used.
+
+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 :func:`pygame.init()` or :func:`pygame.display.init()`.
+
+|
+
+::
+
+ SDL_AUDIODRIVER -
+ Set to "drivername" to change the audio driver used.
+
+On some platforms there are multiple audio drivers available and
+this allows users to pick between them. More information is available
+`here `__. Must be set before
+calling :func:`pygame.init()` or :func:`pygame.mixer.init()`.
+
+|
+
+::
+
+ SDL_VIDEO_ALLOW_SCREENSAVER
+ Set to "1" to allow screensavers while pygame apps are running.
+
+By default pygame apps disable screensavers while
+they are running. Setting this environment variable allows users or
+developers to change that and make screensavers run again.
+
+|
+
+::
+
+ SDL_VIDEO_X11_NET_WM_BYPASS_COMPOSITOR
+ Set to "0" to re-enable the compositor.
+
+By default SDL tries to disable the X11 compositor for all pygame
+apps. This is usually a good thing as it's faster, however if you
+have an app which *doesn't* update every frame and are using linux
+you may want to disable this bypass. The bypass has reported problems
+on KDE linux. This variable is only used on x11/linux platforms.
+
+|
+
+::
+
+ SDL_JOYSTICK_ALLOW_BACKGROUND_EVENTS
+ Set to "1" to allow joysticks to be updated even when the window is out of focus
+
+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()`.
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_sources/ref/rect.rst.txt b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_sources/ref/rect.rst.txt
new file mode 100644
index 0000000..ce4e605
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_sources/ref/rect.rst.txt
@@ -0,0 +1,604 @@
+.. include:: common.txt
+
+:mod:`pygame.Rect`
+==================
+
+.. currentmodule:: pygame
+
+.. 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`
+
+   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
+   have an attribute named "rect".
+
+   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 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
+   None but affects the original Rect. These "in-place" methods are denoted
+   with the "ip" suffix.
+
+   The Rect object has several virtual attributes which can be used to move and
+   align the Rect:
+
+   ::
+
+       x,y
+       top, left, bottom, right
+       topleft, bottomleft, topright, bottomright
+       midtop, midleft, midbottom, midright
+       center, centerx, centery
+       size, width, height
+       w,h
+
+   All of these attributes can be assigned to:
+
+   ::
+
+       rect1.right = 10
+       rect2.center = (20,30)
+
+   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
+   nonzero test. Some methods return a Rect with 0 size to represent an invalid
+   rectangle. A Rect with a 0 size will not collide when using collision
+   detection methods (e.g. :meth:`collidepoint`, :meth:`colliderect`, etc.).
+
+   The coordinates for Rect objects are all integers. The size values can be
+   programmed to have negative values, but these are considered illegal Rects
+   for most operations.
+
+   There are several collision tests between other rectangles. Most python
+   containers can be searched for collisions against a single Rect.
+
+   The area covered by a Rect does not include the right- and bottom-most edge
+   of pixels. If one Rect's bottom border is another Rect's top border (i.e.,
+   rect1.bottom=rect2.top), the two meet exactly on the screen but do not
+   overlap, and ``rect1.colliderect(rect2)`` returns false.
+
+   The Rect object is also iterable:
+
+   ::
+
+      r = Rect(0, 1, 2, 3)
+      x, y, w, h = r
+
+   .. 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.
+
+   .. method:: copy
+
+      | :sl:`copy the rectangle`
+      | :sg:`copy() -> Rect`
+
+      Returns a new rectangle having the same position and size as the original.
+
+      New in pygame 1.9
+
+      .. ## Rect.copy ##
+
+   .. method:: move
+
+      | :sl:`moves the rectangle`
+      | :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.
+
+      .. ## Rect.move ##
+
+   .. method:: move_ip
+
+      | :sl:`moves the rectangle, in place`
+      | :sg:`move_ip(x, y) -> None`
+
+      Same as the ``Rect.move()`` method, but operates in place.
+
+      .. ## Rect.move_ip ##
+
+   .. method:: inflate
+
+      | :sl:`grow or shrink the rectangle size`
+      | :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
+      will shrink the rectangle. Note, uses integers, if the offset given is
+      too small(< 2 > -2), center will be off.
+
+      .. ## Rect.inflate ##
+
+   .. method:: inflate_ip
+
+      | :sl:`grow or shrink the rectangle size, in place`
+      | :sg:`inflate_ip(x, y) -> None`
+
+      Same as the ``Rect.inflate()`` method, but operates in place.
+
+      .. ## Rect.inflate_ip ##
+
+   .. method:: scale_by
+
+      | :sl:`scale the rectangle by given a multiplier`
+      | :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 
+      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.
+
+      .. 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(scalar) -> None`
+      | :sg:`scale_by_ip(scalex, scaley) -> None`
+
+      Same as the ``Rect.scale_by()`` method, but operates in place.
+
+      .. 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`
+
+      Sets the position and size of the rectangle, in place. See
+      parameters for :meth:`pygame.Rect` for the parameters of this function.
+
+      .. versionadded:: 2.0.1
+
+      .. ## Rect.update ##
+
+   .. method:: clamp
+
+      | :sl:`moves the rectangle inside another`
+      | :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
+      centered inside the argument Rect, but its size is not changed.
+
+      .. ## Rect.clamp ##
+
+   .. method:: clamp_ip
+
+      | :sl:`moves the rectangle inside another, in place`
+      | :sg:`clamp_ip(Rect) -> None`
+
+      Same as the ``Rect.clamp()`` method, but operates in place.
+
+      .. ## Rect.clamp_ip ##
+
+   .. method:: clip
+
+      | :sl:`crops a rectangle inside another`
+      | :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
+      with 0 size is returned.
+
+      .. ## Rect.clip ##
+
+   .. 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))) -> ()`
+
+      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
+      tuple is returned.
+
+      The line to crop can be any of the following formats (floats can be used
+      in place of ints, but they will be truncated):
+
+         - four ints
+         - 2 lists/tuples/Vector2s of 2 ints
+         - a list/tuple of four ints
+         - a list/tuple of 2 lists/tuples/Vector2s of 2 ints
+
+      :returns: a tuple with the coordinates of the given line cropped to be
+         completely inside the rectangle is returned, if the given line does
+         not overlap the rectangle, an empty tuple is returned
+      :rtype: tuple(tuple(int, int), tuple(int, int)) or ()
+
+      :raises TypeError: if the line coordinates are not given as one of the
+         above described line formats
+
+      .. note ::
+         This method can be used for collision detection between a rect and a
+         line. See example code below.
+
+      .. note ::
+         The ``rect.bottom`` and ``rect.right`` attributes of a
+         :mod:`pygame.Rect` always lie one pixel outside of its actual border.
+
+      ::
+
+         # Example using clipline().
+         clipped_line = rect.clipline(line)
+
+         if clipped_line:
+             # If clipped_line is not an empty tuple then the line
+             # collides/overlaps with the rect. The returned value contains
+             # the endpoints of the clipped line.
+             start, end = clipped_line
+             x1, y1 = start
+             x2, y2 = end
+         else:
+             print("No clipping. The line is fully outside the rect.")
+
+      .. 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`
+
+      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
+      covered by the originals.
+
+      .. ## Rect.union ##
+
+   .. method:: union_ip
+
+      | :sl:`joins two rectangles into one, in place`
+      | :sg:`union_ip(Rect) -> None`
+
+      Same as the ``Rect.union()`` method, but operates in place.
+
+      .. ## Rect.union_ip ##
+
+   .. method:: unionall
+
+      | :sl:`the union of many rectangles`
+      | :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`
+
+      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`
+
+      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
+      be smaller than the target in either width or height.
+
+      .. ## Rect.fit ##
+
+   .. method:: normalize
+
+      | :sl:`correct negative sizes`
+      | :sg:`normalize() -> None`
+
+      This will flip the width or height of a rectangle if it has a negative
+      size. The rectangle will remain in the same place, with only the sides
+      swapped.
+
+      .. ## Rect.normalize ##
+
+   .. method:: contains
+
+      | :sl:`test if one rectangle is inside another`
+      | :sg:`contains(Rect) -> bool`
+
+      Returns true when the argument is completely inside the Rect.
+
+      .. ## Rect.contains ##
+
+   .. method:: collidepoint
+
+      | :sl:`test if a point is inside a rectangle`
+      | :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.
+
+      .. note ::
+         For collision detection between a rect and a line the :meth:`clipline`
+         method can be used.
+
+      .. ## Rect.collidepoint ##
+
+   .. method:: colliderect
+
+      | :sl:`test if two rectangles overlap`
+      | :sg:`colliderect(Rect) -> bool`
+
+      Returns true if any portion of either rectangle overlap (except the
+      top+bottom or left+right edges).
+
+      .. note ::
+         For collision detection between a rect and a line the :meth:`clipline`
+         method can be used.
+
+      .. ## Rect.colliderect ##
+
+   .. method:: collidelist
+
+      | :sl:`test if one rectangle in a list intersects`
+      | :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`
+
+      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:
+
+      .. code-block:: python
+    
+          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 ##
+
+   .. method:: collideobjects
+
+      | :sl:`test if any object in a list intersects`
+      | :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
+
+      If key is given, then it should be a method taking an object from the list
+      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.
+
+      .. code-block:: python
+
+          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)  # -> 
+          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
+          )  # -> 
+          print(collision)
+
+          screen_rect = r.collideobjects(objects, key=lambda o: o.draw_rect)  # -> None
+          print(screen_rect)
+
+      .. versionadded:: 2.1.3
+
+      .. ## Rect.collideobjects ##
+
+   .. method:: collideobjectsall
+
+      | :sl:`test if all objects in a list intersect`
+      | :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.
+
+      If key is given, then it should be a method taking an object from the list
+      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.
+
+      .. code-block:: python
+
+          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
+          )  # -> [, , ]
+          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
+          )  # -> [, ]
+          print(collisions)
+
+          screen_rects = r.collideobjectsall(objects, key=lambda o: o.draw_rect)  # -> []
+          print(screen_rects)
+
+      .. versionadded:: 2.1.3
+
+      .. ## Rect.collideobjectsall ##
+
+   .. method:: collidedict
+
+      | :sl:`test if one rectangle in a dictionary intersects`
+      | :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
+      ``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 ::
+         Rect objects cannot be used as keys in a dictionary (they are not
+         hashable), so they must be converted to a tuple.
+         e.g. ``rect.collidedict({tuple(key_rect) : value})``
+
+      .. versionchanged:: 2.5.0 Added support for keyword arguments.
+      
+      .. ## Rect.collidedict ##
+
+   .. method:: collidedictall
+
+      | :sl:`test if all rectangles in a dictionary intersect`
+      | :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 ``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 ::
+         Rect objects cannot be used as keys in a dictionary (they are not
+         hashable), so they must be converted to a tuple.
+         e.g. ``rect.collidedictall({tuple(key_rect) : value})``
+
+      .. versionchanged:: 2.5.0 Added support for keyword arguments.
+      
+      .. ## Rect.collidedictall ##
+
+   .. ## pygame.Rect ##
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_sources/ref/scrap.rst.txt b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_sources/ref/scrap.rst.txt
new file mode 100644
index 0000000..1aac5d0
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_sources/ref/scrap.rst.txt
@@ -0,0 +1,240 @@
+.. include:: common.txt
+
+:mod:`pygame.scrap`
+===================
+
+.. module:: pygame.scrap
+   :synopsis: pygame module for clipboard support.
+
+| :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
+data (MIME) types are defined and registered:
+
+::
+
+   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:
+
+::
+
+  "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:
+
+::
+
+  "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 `_).
+
+.. versionadded:: 1.8
+
+.. note::
+   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
+
+   | :sl:`Initializes the scrap module.`
+   | :sg:`init() -> None`
+
+   Initialize the scrap module.
+
+   :raises pygame.error: if unable to initialize scrap module
+
+   .. note:: The scrap module requires :func:`pygame.display.set_mode()` be
+      called before being initialized.
+
+   .. ## pygame.scrap.init ##
+
+.. function:: get_init
+
+   | :sl:`Returns True if the scrap module is currently initialized.`
+   | :sg:`get_init() -> bool`
+
+   Gets the scrap module's initialization state.
+
+   :returns: ``True`` if the :mod:`pygame.scrap` module is currently
+      initialized, ``False`` otherwise
+   :rtype: bool
+
+   .. 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`
+
+   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
+   decoding to Unicode).
+
+   :param string type: data type to retrieve from the clipboard
+
+   :returns: data (bytes object) for the given type identifier or ``None`` if
+      no data for the given type is available
+   :rtype: bytes | None
+
+   ::
+
+     text = pygame.scrap.get(pygame.SCRAP_TEXT)
+     if text:
+         print("There is text in the clipboard.")
+     else:
+         print("There does not seem to be text in the clipboard.")
+
+   .. ## pygame.scrap.get ##
+
+.. function:: get_types
+
+   | :sl:`Gets a list of the available clipboard types.`
+   | :sg:`get_types() -> list`
+
+   Gets a list of data type string identifiers for the data currently
+   available on the clipboard. Each identifier can be used in the
+   :func:`pygame.scrap.get()` method to get the clipboard content of the
+   specific type.
+
+   :returns: list of strings of the available clipboard data types, if there
+      is no data in the clipboard an empty list is returned
+   :rtype: list
+
+   ::
+
+     for t in pygame.scrap.get_types():
+         if "text" in t:
+             # There is some content with the word "text" in its type string.
+             print(pygame.scrap.get(t))
+
+   .. ## pygame.scrap.get_types ##
+
+.. function:: put
+
+   | :sl:`Places data into the clipboard.`
+   | :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_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
+   :param data: data to be place into the clipboard, a bytes object
+   :type data: bytes
+
+   :raises pygame.error: if unable to put the data into the clipboard
+
+   ::
+
+     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
+     # it.
+     pygame.scrap.put(pygame.SCRAP_TEXT, b"A text to copy")
+     pygame.scrap.put("Plain text", b"Data for user defined type 'Plain text'")
+
+   .. ## pygame.scrap.put ##
+
+.. function:: contains
+
+   | :sl:`Checks whether data for a given type is available in the clipboard.`
+   | :sg:`contains(type) -> bool`
+
+   Checks whether data for the given type is currently available in the
+   clipboard.
+
+   :param string type: data type to check availability of
+
+   :returns: ``True`` if data for the passed type is available in the
+      clipboard, ``False`` otherwise
+   :rtype: bool
+
+   ::
+
+     if pygame.scrap.contains(pygame.SCRAP_TEXT):
+         print("There is text in the clipboard.")
+     if pygame.scrap.contains("own_data_type"):
+         print("There is stuff in the clipboard.")
+
+   .. ## pygame.scrap.contains ##
+
+.. function:: lost
+
+   | :sl:`Indicates if the clipboard ownership has been lost by the pygame application.`
+   | :sg:`lost() -> bool`
+
+   Indicates if the clipboard ownership has been lost by the pygame
+   application.
+
+   :returns: ``True``, if the clipboard ownership has been lost by the pygame
+      application, ``False`` if the pygame application still owns the clipboard
+   :rtype: bool
+
+   ::
+
+     if pygame.scrap.lost():
+         print("The clipboard is in use by another application.")
+
+   .. ## pygame.scrap.lost ##
+
+.. function:: set_mode
+
+   | :sl:`Sets the clipboard access mode.`
+   | :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
+   selections) and ``pygame.SCRAP_CLIPBOARD`` (for the clipboard) are
+   available. Setting the mode to ``pygame.SCRAP_SELECTION`` in other
+   environments will not change the mode from ``pygame.SCRAP_CLIPBOARD``.
+
+   :param mode: access mode, supported values are ``pygame.SCRAP_CLIPBOARD``
+      and ``pygame.SCRAP_SELECTION`` (``pygame.SCRAP_SELECTION`` only has an
+      effect when used on X11 platforms)
+
+   :raises ValueError: if the ``mode`` parameter is not
+      ``pygame.SCRAP_CLIPBOARD`` or ``pygame.SCRAP_SELECTION``
+
+   .. ## pygame.scrap.set_mode ##
+
+.. ## pygame.scrap ##
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_sources/ref/sdl2_controller.rst.txt b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_sources/ref/sdl2_controller.rst.txt
new file mode 100644
index 0000000..6c674f1
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_sources/ref/sdl2_controller.rst.txt
@@ -0,0 +1,290 @@
+.. include:: common.txt
+
+:mod:`pygame._sdl2.controller`
+==============================
+
+.. module:: pygame._sdl2.controller
+   :synopsis: pygame module to work with controllers
+
+| :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.
+
+Pygame uses xbox controllers naming conventions (like a, b, x, y for buttons) but
+they always refer to the same buttons. For example ``CONTROLLER_BUTTON_X`` is
+always the leftmost button of the 4 buttons on the right.
+
+Controllers can generate the following events::
+
+   CONTROLLERAXISMOTION, CONTROLLERBUTTONDOWN, CONTROLLERBUTTONUP,
+   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`
+Note that controllers can generate joystick events as well. This function only toggles
+events related to controllers.
+
+.. note::
+   See the :mod:`pygame.joystick` for a more versatile but more advanced api.
+
+.. versionadded:: 2 This module requires SDL2.
+
+.. function:: init
+
+   | :sl:`initialize the controller module`
+   | :sg:`init() -> None`
+
+   Initialize the controller module.
+
+   .. ## pygame._sdl2.controller.init ##
+
+.. function:: quit
+
+   | :sl:`Uninitialize the controller module.`
+   | :sg:`quit() -> None`
+
+   Uninitialize the controller module.
+
+   .. ## pygame._sdl2.controller.quit ##
+
+.. function:: get_init
+
+   | :sl:`Returns True if the controller module is initialized.`
+   | :sg:`get_init() -> bool`
+
+   Test if ``pygame._sdl2.controller.init()`` was called.
+
+    .. ## pygame._sdl2.controller.get_init ##
+
+.. function:: set_eventstate
+
+    | :sl:`Sets the current state of events related to controllers`
+    | :sg:`set_eventstate(state) -> None`
+
+    Enable or disable events connected to controllers.
+
+    .. note::
+        Controllers can still generate joystick events, which will not be toggled by this function.
+
+    .. versionchanged:: 2.0.2: Changed return type from int to None
+
+    .. ## pygame._sdl2.controller.set_eventstate ##
+
+.. function:: get_eventstate
+
+    | :sl:`Gets the current state of events related to controllers`
+    | :sg:`get_eventstate() -> bool`
+
+    Returns the current state of events related to controllers, True meaning
+    events will be posted.
+
+    .. versionadded:: 2.0.2
+
+    .. ## pygame._sdl2.controller.get_eventstate ##
+
+.. function:: get_count
+
+    | :sl:`Get the number of joysticks connected`
+    | :sg:`get_count() -> int`
+
+    Get the number of joysticks connected.
+
+    .. ## pygame._sdl2.controller.get_count ##
+
+.. function:: is_controller
+
+    | :sl:`Check if the given joystick is supported by the game controller interface`
+    | :sg:`is_controller(index) -> bool`
+
+    Returns True if the index given can be used to create a controller object.
+
+    .. ## pygame._sdl2.controller.is_controller ##
+
+.. function:: name_forindex
+
+    | :sl:`Get the name of the controller`
+    | :sg:`name_forindex(index) -> name or None`
+
+    Returns the name of controller, or None if there's no name or the
+    index is invalid.
+
+    .. ## pygame._sdl2.controller.name_forindex ##
+
+.. class:: Controller
+
+    | :sl:`Create a new Controller object.`
+    | :sg:`Controller(index) -> Controller`
+
+    Create a new Controller object. Index should be integer between
+    0 and ``pygame._sdl2.controller.get_count()``. Controllers also
+    can be created from a ``pygame.joystick.Joystick`` using
+    ``pygame._sdl2.controller.from_joystick``. Controllers are
+    initialized on creation.
+
+   .. method:: quit
+
+      | :sl:`uninitialize the Controller`
+      | :sg:`quit() -> None`
+
+      Close a Controller object. After this the pygame event queue will no longer
+      receive events from the device.
+
+      It is safe to call this more than once.
+
+      .. ## Controller.quit ##
+
+   .. method:: get_init
+
+      | :sl:`check if the Controller is initialized`
+      | :sg:`get_init() -> bool`
+
+      Returns True if the Controller object is currently initialised.
+
+      .. ## Controller.get_init ##
+
+   .. staticmethod:: from_joystick
+
+       | :sl:`Create a Controller from a pygame.joystick.Joystick object`
+       | :sg:`from_joystick(joystick) -> Controller`
+
+       Create a Controller object from a ``pygame.joystick.Joystick`` object
+
+       .. ## Controller.from_joystick ##
+
+   .. method:: attached
+
+      | :sl:`Check if the Controller has been opened and is currently connected.`
+      | :sg:`attached() -> bool`
+
+      Returns True if the Controller object is opened and connected.
+
+      .. ## Controller.attached ##
+
+   .. method:: as_joystick
+
+      | :sl:`Returns a pygame.joystick.Joystick() object`
+      | :sg:`as_joystick() -> Joystick object`
+
+      Returns a pygame.joystick.Joystick() object created from this controller's index
+
+      .. ## Controller.as_joystick ##
+
+   .. method:: get_axis
+
+      | :sl:`Get the current state of a joystick axis`
+      | :sg:`get_axis(axis) -> int`
+
+      Get the current state of a trigger or joystick axis.
+      The axis argument must be one of the following constants::
+
+         CONTROLLER_AXIS_LEFTX, CONTROLLER_AXIS_LEFTY,
+         CONTROLLER_AXIS_RIGHTX, CONTROLLER_AXIS_RIGHTY,
+         CONTROLLER_AXIS_TRIGGERLEFT, CONTROLLER_AXIS_TRIGGERRIGHT
+
+      Joysticks can return a value between -32768 and 32767. Triggers however
+      can only return a value between 0 and 32768.
+
+      .. ## Controller.get_axis ##
+
+   .. method:: get_button
+
+      | :sl:`Get the current state of a button`
+      | :sg:`get_button(button) -> bool`
+
+      Get the current state of a button, True meaning it is pressed down.
+      The button argument must be one of the following constants::
+
+         CONTROLLER_BUTTON_A, CONTROLLER_BUTTON_B,
+         CONTROLLER_BUTTON_X, CONTROLLER_BUTTON_Y
+         CONTROLLER_BUTTON_DPAD_UP, CONTROLLER_BUTTON_DPAD_DOWN,
+         CONTROLLER_BUTTON_DPAD_LEFT, CONTROLLER_BUTTON_DPAD_RIGHT,
+         CONTROLLER_BUTTON_LEFTSHOULDER, CONTROLLER_BUTTON_RIGHTSHOULDER,
+         CONTROLLER_BUTTON_LEFTSTICK, CONTROLLER_BUTTON_RIGHTSTICK,
+         CONTROLLER_BUTTON_BACK, CONTROLLER_BUTTON_GUIDE,
+         CONTROLLER_BUTTON_START
+
+
+      .. ## Controller.get_button ##
+
+   .. method:: get_mapping
+
+      | :sl:`Get the mapping assigned to the controller`
+      | :sg:`get_mapping() -> mapping`
+
+      Returns a dict containing the mapping of the Controller. For more
+      information see :meth:`Controller.set_mapping()`
+
+      .. versionchanged:: 2.0.2: Return type changed from ``str`` to ``dict``
+
+      .. ## Controller.get_mapping ##
+
+   .. method:: set_mapping
+
+      | :sl:`Assign a mapping to the controller`
+      | :sg:`set_mapping(mapping) -> int`
+
+      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
+      dictionary must be a button, hat or axis represented in the following way:
+
+      * For a button use: bX where X is the index of the button.
+      * For a hat use: hX.Y where X is the index and the Y is the direction (up: 1, right: 2, down: 3, left: 4).
+      * For an axis use: aX where x is the index of the axis.
+
+      An example of mapping::
+
+         mapping = controller.get_mapping() # Get current mapping
+         mapping["a"] = "b3" # Remap button a to y
+         mapping["y"] = "b0" # Remap button y to a
+         controller.set_mapping(mapping) # Set the mapping
+
+
+      The function will return 1 if a new mapping is added or 0 if an existing one is updated.
+
+      .. 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 ##
+
+   .. method:: rumble
+
+      | :sl:`Start a rumbling effect`
+      | :sg:`rumble(low_frequency, high_frequency, duration) -> bool`
+
+      Start a rumble effect on the controller, with the specified strength ranging
+      from 0 to 1. Duration is length of the effect, in ms. Setting the duration
+      to 0 will play the effect until another one overwrites it or
+      :meth:`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 or :meth:`pygame.version.SDL` is below 2.0.9.
+
+      .. versionadded:: 2.0.2
+
+      .. ## Controller.rumble ##
+
+   .. method:: stop_rumble
+
+      | :sl:`Stop any rumble effect playing`
+      | :sg:`stop_rumble() -> None`
+
+      Stops any rumble effect playing on the controller. See
+      :meth:`Controller.rumble` for more information.
+
+      .. versionadded:: 2.0.2
+
+      .. ## Controller.stop_rumble ##
+
+.. ## pygame._sdl2.controller ##
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_sources/ref/sdl2_video.rst.txt b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_sources/ref/sdl2_video.rst.txt
new file mode 100644
index 0000000..e273363
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_sources/ref/sdl2_video.rst.txt
@@ -0,0 +1,334 @@
+.. include:: common.txt
+
+:mod:`pygame.sdl2_video`
+========================
+
+.. module:: pygame._sdl2.video
+   :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.
+
+| :sl:`Experimental pygame module for porting new SDL video systems`
+
+.. 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`
+
+   .. classmethod:: from_display_module
+   
+      | :sl:`Creates window using window created by pygame.display.set_mode().`
+      | :sg:`from_display_module() -> Window`
+
+   .. classmethod:: from_window
+
+      | :sl:`Create Window from another window. Could be from another UI toolkit.`
+      | :sg:`from_window(other) -> Window`
+
+   .. attribute:: grab
+
+      | :sl:`Gets or sets whether the mouse is confined to the window.`
+      | :sg:`grab -> bool`
+
+   .. attribute:: relative_mouse
+
+      | :sl:`Gets or sets the window's relative mouse motion state.`
+      | :sg:`relative_mouse -> bool`
+
+   .. method:: set_windowed
+
+      | :sl:`Enable windowed mode (exit fullscreen).`
+      | :sg:`set_windowed() -> None`
+
+   .. method:: set_fullscreen
+
+      | :sl:`Enter fullscreen.`
+      | :sg:`set_fullscreen(desktop=False) -> None`
+
+   .. attribute:: title
+
+      | :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:`Gets the renderer associated with the Texture. *Read-only*`
+      | :sg:`renderer -> Renderer`
+
+   .. attribute:: width
+
+      | :sl:`Gets the width of the Texture. *Read-only*`
+      | :sg:`width -> int`
+
+   .. attribute:: height
+
+      | :sl:`Gets the height of the Texture. *Read-only*`
+      | :sg:`height -> int`
+
+   .. attribute:: alpha
+
+      | :sl:`Gets and sets an additional alpha value multiplied into render copy operations.`
+      | :sg:`alpha -> int`
+
+   .. attribute:: blend_mode
+
+      | :sl:`Gets and sets the blend mode for the Texture.`
+      | :sg:`blend_mode -> int`
+
+   .. attribute:: color
+
+      | :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.`
+      | :sg:`get_rect(**kwargs) -> Rect`
+
+   .. method:: draw
+
+      | :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`
+
+   .. method:: update
+
+      | :sl:`Update the texture with a Surface. WARNING: Slow operation, use sparingly.`
+      | :sg:`update(surface, area=None) -> None`
+
+.. class:: Image
+
+   | :sl:`Easy way to use a portion of a Texture without worrying about srcrect all the time.`
+   | :sg:`Image(textureOrImage, srcrect=None) -> Image`
+
+   .. method:: get_rect
+
+      | :sl:`Get the rectangular area of the Image.`
+      | :sg:`get_rect() -> Rect`
+
+   .. method:: draw
+
+      | :sl:`Copy a portion of the Image to the rendering target.`
+      | :sg:`draw(srcrect=None, dstrect=None) -> None`
+
+   .. attribute:: angle
+
+      | :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:`Gets and sets whether the Image is flipped on the x axis.`
+      | :sg:`flip_x -> bool`
+
+   .. attribute:: flip_y
+
+      | :sl:`Gets and sets whether the Image is flipped on the y axis.`
+      | :sg:`flip_y -> bool`
+
+   .. attribute:: color
+
+      | :sl:`Gets and sets the Image color modifier.`
+      | :sg:`color -> Color`
+
+   .. attribute:: alpha
+
+      | :sl:`Gets and sets the Image alpha modifier.`
+      | :sg:`alpha -> float`
+
+   .. attribute:: blend_mode
+
+      | :sl:`Gets and sets the blend mode for the Image.`
+      | :sg:`blend_mode -> int`
+
+   .. attribute:: texture
+
+      | :sl:`Gets and sets the Texture the Image is based on.`
+      | :sg:`texture -> Texture`
+
+   .. attribute:: srcrect
+
+      | :sl:`Gets and sets the Rect the Image is based on.`
+      | :sg:`srcrect -> Rect`
+
+.. class:: Renderer
+
+   | :sl:`Create a 2D rendering context for a window.`
+   | :sg:`Renderer(window, index=-1, accelerated=-1, vsync=False, target_texture=False) -> Renderer`
+
+   .. classmethod:: from_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.`
+      | :sg:`clear() -> None`
+
+   .. method:: present
+
+      | :sl:`Updates the screen with any new rendering since previous call.`
+      | :sg:`present() -> None`	
+
+   .. method:: get_viewport
+
+      | :sl:`Returns the drawing area on the target.`
+      | :sg:`get_viewport() -> Rect`
+
+   .. method:: set_viewport
+
+      | :sl:`Set the drawing area on the target. If area is None, the entire target will be used.`
+      | :sg:`set_viewport(area) -> None`
+
+   .. attribute:: logical_size
+
+      | :sl:`Gets and sets the logical size.`
+      | :sg:`logical_size -> (int width, int height)`
+
+   .. attribute:: scale
+
+      | :sl:`Gets and sets the scale.`
+      | :sg:`scale -> (float x_scale, float y_scale)`
+
+   .. attribute:: target
+
+      | :sl:`Gets and sets the render target. None represents the default target (the renderer).`
+      | :sg:`target -> Texture or None`
+
+   .. method:: blit
+
+      | :sl:`For compatibility purposes. Textures created by different Renderers cannot be shared!`
+      | :sg:`blit(source, dest, area=None, special_flags=0)-> Rect`
+
+   .. method:: draw_line
+
+      | :sl:`Draws a line.`
+      | :sg:`draw_line(p1, p2) -> None`
+
+   .. method:: draw_point
+
+      | :sl:`Draws a point.`
+      | :sg:`draw_point(point) -> None`
+
+   .. method:: draw_rect
+
+      | :sl:`Draws a rectangle.`
+      | :sg:`draw_rect(rect)-> None`
+
+   .. method:: fill_rect
+
+      | :sl:`Fills a rectangle.`
+      | :sg:`fill_rect(rect)-> None`
+
+   .. method:: to_surface
+
+      | :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/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_sources/ref/sndarray.rst.txt b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_sources/ref/sndarray.rst.txt
new file mode 100644
index 0000000..2a17764
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_sources/ref/sndarray.rst.txt
@@ -0,0 +1,95 @@
+.. include:: common.txt
+
+:mod:`pygame.sndarray`
+======================
+
+.. 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/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_sources/ref/sprite.rst.txt b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_sources/ref/sprite.rst.txt
new file mode 100644
index 0000000..85c75dc
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_sources/ref/sprite.rst.txt
@@ -0,0 +1,895 @@
+.. include:: common.txt
+
+:mod:`pygame.sprite`
+====================
+
+.. module:: pygame.sprite
+   :synopsis: pygame module with basic game object classes
+
+| :sl:`pygame module with basic game object classes`
+
+This module contains several simple classes to be used within games. There is
+the main Sprite class and several Group classes that contain Sprites. The use
+of these classes is entirely optional when using pygame. The classes are fairly
+lightweight and only provide a starting place for the code that is common to
+most games.
+
+The Sprite class is intended to be used as a base class for the different types
+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 ``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()`` 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 ``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
+Group. A given Sprite can exist in any number of groups. A game could use some
+groups to control object rendering, and a completely separate set of groups to
+control interaction or player movement. Instead of adding type attributes or
+bools to a derived Sprite class, consider keeping the Sprites inside organized
+Groups. This will allow for easier lookup later in the game.
+
+Sprites and Groups manage their relationships with the ``add()`` and
+``remove()`` methods. These methods can accept a single or multiple targets for
+membership. The default initializers for these classes also takes a single or
+list of targets for initial membership. It is safe to repeatedly add and remove
+the same Sprite from a Group.
+
+While it is possible to design sprite and group classes that don't derive from
+the Sprite and AbstractGroup classes below, it is strongly recommended that you
+extend those when you add a Sprite or Group class.
+
+Sprites are not thread safe. So lock them yourself if using threads.
+
+.. class:: Sprite
+
+   | :sl:`Simple base class for visible game objects.`
+   | :sg:`Sprite(*groups) -> Sprite`
+
+   The base class for visible game objects. Derived classes will want to
+   override the ``Sprite.update()`` and assign a ``Sprite.image`` and
+   ``Sprite.rect`` attributes. The initializer can accept any number of Group
+   instances to be added to.
+
+   When subclassing the Sprite, be sure to call the base initializer before
+   adding the Sprite to Groups. For example:
+
+   .. code-block:: python
+   
+       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):
+              # Call the parent class (Sprite) constructor
+              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()   
+      
+   .. method:: update
+
+      | :sl:`method to control sprite behavior`
+      | :sg:`update(*args, **kwargs) -> None`
+
+      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.
+
+      It is not necessary to use this method if not using the convenience method
+      by the same name in the Group class.
+
+      .. ## Sprite.update ##
+
+   .. method:: add
+
+      | :sl:`add the sprite to groups`
+      | :sg:`add(*groups) -> None`
+
+      Any number of Group instances can be passed as arguments. The Sprite will
+      be added to the Groups it is not already a member of.
+
+      .. ## Sprite.add ##
+
+   .. method:: remove
+
+      | :sl:`remove the sprite from groups`
+      | :sg:`remove(*groups) -> None`
+
+      Any number of Group instances can be passed as arguments. The Sprite will
+      be removed from the Groups it is currently a member of.
+
+      .. ## Sprite.remove ##
+
+   .. method:: kill
+
+      | :sl:`remove the Sprite from all Groups`
+      | :sg:`kill() -> None`
+
+      The Sprite is removed from all the Groups that contain it. This won't
+      change anything about the state of the Sprite. It is possible to continue
+      to use the Sprite after this method has been called, including adding it
+      to Groups.
+
+      .. ## Sprite.kill ##
+
+   .. method:: alive
+
+      | :sl:`does the sprite belong to any groups`
+      | :sg:`alive() -> bool`
+
+      Returns True when the Sprite belongs to one or more Groups.
+
+      .. ## Sprite.alive ##
+
+   .. method:: groups
+
+      | :sl:`list of Groups that contain this Sprite`
+      | :sg:`groups() -> group_list`
+
+      Return a list of all the Groups that contain this Sprite.
+
+      .. ## Sprite.groups ##
+
+   .. ## 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.`
+   | :sg:`DirtySprite(*groups) -> DirtySprite`
+
+   Extra DirtySprite attributes with their default values:
+
+   dirty = 1
+
+   ::
+
+       if set to 1, it is repainted and then set to 0 again
+       if set to 2 then it is always dirty ( repainted each frame,
+       flag is not reset)
+       0 means that it is not dirty and therefore not repainted again
+
+   blendmode = 0
+
+   ::
+
+       its the special_flags argument of blit, blendmodes
+
+   source_rect = None
+
+   ::
+
+       source rect to use, remember that it is relative to
+       topleft (0,0) of self.image
+
+   visible = 1
+
+   ::
+
+       normally 1, if set to 0 it will not be repainted
+       (you must set it dirty too to be erased from screen)
+
+   layer = 0
+
+   ::
+
+       (READONLY value, it is read when adding it to the
+       LayeredDirty, for details see doc of LayeredDirty)
+
+   .. ##  ##
+
+   .. ## pygame.sprite.DirtySprite ##
+
+.. class:: Group
+
+   | :sl:`A container class to hold and manage multiple Sprite objects.`
+   | :sg:`Group(*sprites) -> Group`
+
+   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. The group supports the following
+   standard Python operations:
+
+   ::
+
+       in      test if a Sprite is contained
+       len     the number of Sprites contained
+       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`
+      | :sg:`sprites() -> sprite_list`
+
+      Return a list of all the Sprites this group contains. You can also get an
+      iterator from the group, but you cannot iterate over a Group while
+      modifying it.
+
+      .. ## Group.sprites ##
+
+   .. method:: copy
+
+      | :sl:`duplicate the Group`
+      | :sg:`copy() -> Group`
+
+      Creates a new Group with all the same Sprites as the original. If you
+      have subclassed Group, the new object will have the same (sub-)class as
+      the original. This only works if the derived class's constructor takes
+      the same arguments as the Group class's.
+
+      .. ## Group.copy ##
+
+   .. method:: add
+
+      | :sl:`add Sprites to this Group`
+      | :sg:`add(*sprites) -> None`
+
+      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 a iterator containing Sprites.
+
+      .. ## Group.add ##
+
+   .. method:: remove
+
+      | :sl:`remove Sprites from the Group`
+      | :sg:`remove(*sprites) -> None`
+
+      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 a iterator containing Sprites.
+
+      .. ## Group.remove ##
+
+   .. method:: has
+
+      | :sl:`test if a Group contains Sprites`
+      | :sg:`has(*sprites) -> bool`
+
+      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 a iterator containing Sprites.
+
+      .. ## Group.has ##
+
+   .. method:: update
+
+      | :sl:`call the update method on contained Sprites`
+      | :sg:`update(*args, **kwargs) -> None`
+
+      Calls the ``update()`` method on all Sprites in the Group. The base
+      Sprite class has an update method that takes any number of arguments and
+      does nothing. The arguments passed to ``Group.update()`` will be passed
+      to each Sprite.
+
+      There is no way to get the return value from the ``Sprite.update()``
+      methods.
+
+      .. ## Group.update ##
+
+   .. method:: draw
+
+      | :sl:`blit the Sprite images`
+      | :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()``.
+      ``bgsurf`` is unused in this method but ``LayeredDirty.draw()`` uses
+      it.
+
+      The Group does not keep sprites in any order, so the draw order is
+      arbitrary.
+
+      .. ## Group.draw ##
+
+   .. method:: clear
+
+      | :sl:`draw a background over the Sprites`
+      | :sg:`clear(Surface_dest, background) -> None`
+
+      Erases the Sprites used in the last ``Group.draw()`` call. The
+      destination Surface is cleared by filling the drawn Sprite positions with
+      the background.
+
+      The background is usually a Surface image the same dimensions as the
+      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):
+              color = 255, 0, 0
+              surf.fill(color, rect)
+
+      .. ## Group.clear ##
+
+   .. method:: empty
+
+      | :sl:`remove all Sprites`
+      | :sg:`empty() -> None`
+
+      Removes all Sprites from this Group.
+
+      .. ## Group.empty ##
+
+   .. ## 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.`
+   | :sg:`RenderUpdates(*sprites) -> RenderUpdates`
+
+   This class is derived from ``pygame.sprite.Group()``. It has an extended
+   ``draw()`` method that tracks the changed areas of the screen.
+
+   .. method:: draw
+
+      | :sl:`blit the Sprite images and track changed areas`
+      | :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()``.
+
+      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.
+
+      .. ## 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 OrderedUpdates.`
+   | :sg:`LayeredUpdates(*sprites, **kwargs) -> LayeredUpdates`
+
+   This group is fully compatible with :class:`pygame.sprite.Sprite`.
+
+   You can set the default layer through kwargs using 'default_layer' and an
+   integer for the layer. The default layer is 0.
+
+   If the sprite you add has an attribute _layer then that layer will be used.
+   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.
+
+   .. versionadded:: 1.8
+
+   .. method:: add
+
+      | :sl:`add a sprite or sequence of sprites to a group`
+      | :sg:`add(*sprites, **kwargs) -> None`
+
+      If the ``sprite(s)`` have an attribute layer then that is used for the
+      layer. If \**kwargs contains 'layer' then the ``sprite(s)`` will be added
+      to that argument (overriding the sprite layer attribute). If neither is
+      passed then the ``sprite(s)`` will be added to the default layer.
+
+      .. ## LayeredUpdates.add ##
+
+   .. method:: sprites
+
+      | :sl:`returns a ordered list of sprites (first back, last top).`
+      | :sg:`sprites() -> sprites`
+
+      .. ## LayeredUpdates.sprites ##
+
+   .. method:: draw
+
+      | :sl:`draw all sprites in the right order onto the passed surface.`
+      | :sg:`draw(surface, bgsurf=None, special_flags=0) -> Rect_list`
+
+      .. ## LayeredUpdates.draw ##
+
+   .. method:: get_sprites_at
+
+      | :sl:`returns a list with all sprites at that position.`
+      | :sg:`get_sprites_at(pos) -> colliding_sprites`
+
+      Bottom sprites first, top last.
+
+      .. ## LayeredUpdates.get_sprites_at ##
+
+   .. method:: get_sprite
+
+      | :sl:`returns the sprite at the index idx from the groups sprites`
+      | :sg:`get_sprite(idx) -> sprite`
+
+      Raises IndexOutOfBounds if the idx is not within range.
+
+      .. ## LayeredUpdates.get_sprite ##
+
+   .. method:: remove_sprites_of_layer
+
+      | :sl:`removes all sprites from a layer and returns them as a list.`
+      | :sg:`remove_sprites_of_layer(layer_nr) -> sprites`
+
+      .. ## LayeredUpdates.remove_sprites_of_layer ##
+
+   .. method:: layers
+
+      | :sl:`returns a list of layers defined (unique), sorted from bottom up.`
+      | :sg:`layers() -> layers`
+
+      .. ## LayeredUpdates.layers ##
+
+   .. method:: change_layer
+
+      | :sl:`changes the layer of the sprite`
+      | :sg:`change_layer(sprite, new_layer) -> None`
+
+      sprite must have been added to the renderer. It is not checked.
+
+      .. ## LayeredUpdates.change_layer ##
+
+   .. method:: get_layer_of_sprite
+
+      | :sl:`returns the layer that sprite is currently in.`
+      | :sg:`get_layer_of_sprite(sprite) -> layer`
+
+      If the sprite is not found then it will return the default layer.
+
+      .. ## LayeredUpdates.get_layer_of_sprite ##
+
+   .. method:: get_top_layer
+
+      | :sl:`returns the top layer`
+      | :sg:`get_top_layer() -> layer`
+
+      .. ## LayeredUpdates.get_top_layer ##
+
+   .. method:: get_bottom_layer
+
+      | :sl:`returns the bottom layer`
+      | :sg:`get_bottom_layer() -> layer`
+
+      .. ## LayeredUpdates.get_bottom_layer ##
+
+   .. method:: move_to_front
+
+      | :sl:`brings the sprite to front layer`
+      | :sg:`move_to_front(sprite) -> None`
+
+      Brings the sprite to front, changing sprite layer to topmost layer (added
+      at the end of that layer).
+
+      .. ## LayeredUpdates.move_to_front ##
+
+   .. method:: move_to_back
+
+      | :sl:`moves the sprite to the bottom layer`
+      | :sg:`move_to_back(sprite) -> None`
+
+      Moves the sprite to the bottom layer, moving it behind all other layers
+      and adding one additional layer.
+
+      .. ## LayeredUpdates.move_to_back ##
+
+   .. method:: get_top_sprite
+
+      | :sl:`returns the topmost sprite`
+      | :sg:`get_top_sprite() -> Sprite`
+
+      .. ## LayeredUpdates.get_top_sprite ##
+
+   .. method:: get_sprites_from_layer
+
+      | :sl:`returns all sprites from a layer, ordered by how they where added`
+      | :sg:`get_sprites_from_layer(layer) -> sprites`
+
+      Returns all sprites from a layer, ordered by how they where added. It
+      uses linear search and the sprites are not removed from layer.
+
+      .. ## LayeredUpdates.get_sprites_from_layer ##
+
+   .. method:: switch_layer
+
+      | :sl:`switches the sprites from layer1 to layer2`
+      | :sg:`switch_layer(layer1_nr, layer2_nr) -> None`
+
+      The layers number must exist, it is not checked.
+
+      .. ## LayeredUpdates.switch_layer ##
+
+   .. ## pygame.sprite.LayeredUpdates ##
+
+.. class:: LayeredDirty
+
+   | :sl:`LayeredDirty group is for DirtySprite objects.  Subclasses LayeredUpdates.`
+   | :sg:`LayeredDirty(*sprites, **kwargs) -> LayeredDirty`
+
+   This group requires :class:`pygame.sprite.DirtySprite` or any sprite that
+   has the following attributes:
+
+   ::
+
+       image, rect, dirty, visible, blendmode (see doc of DirtySprite).
+
+   It uses the dirty flag technique and is therefore faster than the
+   :class:`pygame.sprite.RenderUpdates` if you have many static sprites. It
+   also switches automatically between dirty rect update and full screen
+   drawing, so you do not have to worry what would be faster.
+
+   Same as for the :class:`pygame.sprite.Group`. You can specify some
+   additional attributes through kwargs:
+
+   ::
+
+       _use_update: True/False   default is False
+       _default_layer: default layer where sprites without a layer are added.
+       _time_threshold: threshold time for switching between dirty rect mode
+           and fullscreen mode, defaults to 1000./80  == 1000./fps
+
+   .. versionadded:: 1.8
+
+   .. method:: draw
+
+      | :sl:`draw all sprites in the right order onto the passed surface.`
+      | :sg:`draw(surface, bgsurf=None, special_flags=None) -> Rect_list`
+
+      You can pass the background too. If a background is already set, then the
+      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 ##
+
+   .. method:: clear
+
+      | :sl:`used to set background`
+      | :sg:`clear(surface, bgd) -> None`
+
+      .. ## LayeredDirty.clear ##
+
+   .. method:: repaint_rect
+
+      | :sl:`repaints the given area`
+      | :sg:`repaint_rect(screen_rect) -> None`
+
+      screen_rect is in screen coordinates.
+
+      .. ## LayeredDirty.repaint_rect ##
+
+   .. method:: set_clip
+
+      | :sl:`clip the area where to draw. Just pass None (default) to reset the clip`
+      | :sg:`set_clip(screen_rect=None) -> None`
+
+      .. ## LayeredDirty.set_clip ##
+
+   .. method:: get_clip
+
+      | :sl:`clip the area where to draw. Just pass None (default) to reset the clip`
+      | :sg:`get_clip() -> Rect`
+
+      .. ## LayeredDirty.get_clip ##
+
+   .. method:: change_layer
+
+      | :sl:`changes the layer of the sprite`
+      | :sg:`change_layer(sprite, new_layer) -> None`
+
+      sprite must have been added to the renderer. It is not checked.
+
+      .. ## LayeredDirty.change_layer ##
+
+   .. method:: set_timing_treshold
+
+      | :sl:`sets the threshold in milliseconds`
+      | :sg:`set_timing_treshold(time_ms) -> None`
+
+      DEPRECATED: Use set_timing_threshold() instead.
+
+      .. deprecated:: 2.1.1
+
+      .. ## LayeredDirty.set_timing_treshold ##
+
+   .. method:: set_timing_threshold
+
+      | :sl:`sets the threshold in milliseconds`
+      | :sg:`set_timing_threshold(time_ms) -> None`
+
+      Defaults to 1000.0 / 80.0. This means that the screen will be painted
+      using the flip method rather than the update method if the update
+      method is taking so long to update the screen that the frame rate falls
+      below 80 frames per second.
+
+      .. versionadded:: 2.1.1
+
+      :raises TypeError: if ``time_ms`` is not int or float
+
+      .. ## LayeredDirty.set_timing_threshold ##
+
+   .. ## pygame.sprite.LayeredDirty ##
+
+.. function:: GroupSingle
+
+   | :sl:`Group container that holds a single sprite.`
+   | :sg:`GroupSingle(sprite=None) -> GroupSingle`
+
+   The GroupSingle container only holds a single Sprite. When a new Sprite is
+   added, the old one is removed.
+
+   There is a special property, ``GroupSingle.sprite``, that accesses the
+   Sprite that this Group contains. It can be None when the Group is empty. The
+   property can also be assigned to add a Sprite into the GroupSingle
+   container.
+
+   .. ## pygame.sprite.GroupSingle ##
+
+.. function:: spritecollide
+
+   | :sl:`Find sprites in a group that intersect another sprite.`
+   | :sg:`spritecollide(sprite, group, dokill, collided = None) -> Sprite_list`
+
+   Return a list containing all Sprites in a Group that intersect with another
+   Sprite. Intersection is determined by comparing the ``Sprite.rect``
+   attribute of each Sprite.
+
+   The dokill argument is a bool. If set to True, all Sprites that collide will
+   be removed from the Group.
+
+   The collided argument is a callback function used to calculate if two
+   sprites are colliding. it should take two sprites as values, and return a
+   bool value indicating if they are colliding. If collided is not passed, all
+   sprites must have a "rect" value, which is a rectangle of the sprite area,
+   which will be used to calculate the collision.
+
+   collided callables:
+
+   ::
+
+       collide_rect, collide_rect_ratio, collide_circle,
+       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)  
+     
+    # 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
+
+   | :sl:`Collision detection between two sprites, using rects.`
+   | :sg:`collide_rect(left, right) -> bool`
+
+   Tests for collision between two sprites. Uses the pygame rect colliderect
+   function to calculate the collision. Intended to be passed as a collided
+   callback function to the \*collide functions. Sprites must have a "rect"
+   attributes.
+
+   .. versionadded:: 1.8
+
+   .. ## pygame.sprite.collide_rect ##
+
+.. function:: collide_rect_ratio
+
+   | :sl:`Collision detection between two sprites, using rects scaled to a ratio.`
+   | :sg:`collide_rect_ratio(ratio) -> collided_callable`
+
+   A callable class that checks for collisions between two sprites, using a
+   scaled version of the sprites rects.
+
+   Is created with a ratio, the instance is then intended to be passed as a
+   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.
+
+   .. versionadded:: 1.8.1
+
+   .. ## pygame.sprite.collide_rect_ratio ##
+
+.. function:: collide_circle
+
+   | :sl:`Collision detection between two sprites, using circles.`
+   | :sg:`collide_circle(left, right) -> bool`
+
+   Tests for collision between two sprites, by testing to see if two circles
+   centered on the sprites overlap. If the sprites have a "radius" attribute,
+   that is used to create the circle, otherwise a circle is created 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.
+
+   .. versionadded:: 1.8.1
+
+   .. ## pygame.sprite.collide_circle ##
+
+.. function:: collide_circle_ratio
+
+   | :sl:`Collision detection between two sprites, using circles scaled to a ratio.`
+   | :sg:`collide_circle_ratio(ratio) -> collided_callable`
+
+   A callable class that checks for collisions between two sprites, using a
+   scaled version of the sprites radius.
+
+   Is created with a floating point ratio, the instance is then intended to be
+   passed as a 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.
+
+   The created callable tests for collision between two sprites, by testing to
+   see if two circles centered on the sprites overlap, after scaling the
+   circles radius by the stored ratio. If the sprites have a "radius"
+   attribute, that is used to create the circle, otherwise a circle is created
+   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.
+
+   .. versionadded:: 1.8.1
+
+   .. ## pygame.sprite.collide_circle_ratio ##
+
+.. function:: collide_mask
+
+   | :sl:`Collision detection between two sprites, using masks.`
+   | :sg:`collide_mask(sprite1, sprite2) -> (int, int)`
+   | :sg:`collide_mask(sprite1, sprite2) -> None`
+
+   Tests for collision between two sprites, by testing if their bitmasks
+   overlap (uses :func:`pygame.mask.Mask.overlap`). If the sprites have a
+   ``mask`` attribute, it is used as the mask, otherwise a mask is created from
+   the sprite's ``image`` (uses :func:`pygame.mask.from_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
+   (0, 0)). The collision point is a position within the mask and is not
+   related to the actual screen position of ``sprite1``.
+
+   This function is intended to be passed as a ``collided`` callback function
+   to the group collide functions (see :meth:`spritecollide`,
+   :meth:`groupcollide`, :meth:`spritecollideany`).
+
+   .. note::
+      To increase performance, create and set a ``mask`` attribute for all
+      sprites that will use this function to check for collisions. Otherwise,
+      each time this function is called it will create new masks.
+
+   .. note::
+      A new mask needs to be recreated each time a sprite's image is changed
+      (e.g. if a new image is used or the existing image is rotated).
+
+   ::
+
+      # Example of mask creation for a sprite.
+      sprite.mask = pygame.mask.from_surface(sprite.image)
+
+   :returns: first point of collision between the masks or ``None`` if no
+      collision
+   :rtype: tuple(int, int) or NoneType
+
+   .. versionadded:: 1.8.0
+
+   .. ## pygame.sprite.collide_mask ##
+
+.. function:: groupcollide
+
+   | :sl:`Find all sprites that collide between two groups.`
+   | :sg:`groupcollide(group1, group2, dokill1, dokill2, collided = None) -> Sprite_dict`
+
+   This will find collisions between all the Sprites in two groups.
+   Collision is determined by comparing the ``Sprite.rect`` attribute of
+   each Sprite or by using the collided function if it is not None.
+
+   Every Sprite inside group1 is added to the return dictionary. The value for
+   each item is the list of Sprites in group2 that intersect.
+
+   If either dokill argument is True, the colliding Sprites will be removed
+   from their respective Group.
+
+   The collided argument is a callback function used to calculate if two sprites are
+   colliding. It should take two sprites as values and return a bool value
+   indicating if they are colliding. If collided is not passed, then all
+   sprites must have a "rect" value, which is a rectangle of the sprite area,
+   which will be used to calculate the collision.
+
+   .. ## pygame.sprite.groupcollide ##
+
+.. function:: spritecollideany
+
+   | :sl:`Simple test if a sprite intersects anything in a group.`
+   | :sg:`spritecollideany(sprite, group, collided = None) -> Sprite` Collision with the returned sprite.
+   | :sg:`spritecollideany(sprite, group, collided = None) -> None` No collision
+
+   If the sprite collides with any single sprite in the group, a single
+   sprite from the group is returned.  On no collision None is returned.
+
+   If you don't need all the features of the ``pygame.sprite.spritecollide()`` function, this
+   function will be a bit quicker.
+
+   The collided argument is a callback function used to calculate if two sprites are
+   colliding. It should take two sprites as values and return a bool value
+   indicating if they are colliding. If collided is not passed, then all
+   sprites must have a "rect" value, which is a rectangle of the sprite area,
+   which will be used to calculate the collision.
+
+   .. ## pygame.sprite.spritecollideany ##
+
+.. ##  ##
+
+.. ## pygame.sprite ##
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_sources/ref/surface.rst.txt b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_sources/ref/surface.rst.txt
new file mode 100644
index 0000000..82466fc
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_sources/ref/surface.rst.txt
@@ -0,0 +1,949 @@
+.. include:: common.txt
+
+:mod:`pygame.Surface`
+=====================
+
+.. currentmodule:: pygame
+
+.. 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/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_sources/ref/surfarray.rst.txt b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_sources/ref/surfarray.rst.txt
new file mode 100644
index 0000000..c29723a
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_sources/ref/surfarray.rst.txt
@@ -0,0 +1,337 @@
+.. include:: common.txt
+
+:mod:`pygame.surfarray`
+=======================
+
+.. module:: pygame.surfarray
+   :synopsis: pygame module for accessing surface pixel data using array interfaces
+
+| :sl:`pygame module for accessing surface pixel data using array interfaces`
+
+Functions to convert between NumPy arrays and Surface 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.
+
+Every pixel is stored as a single integer value to represent the red, green,
+and blue colors. The 8-bit images use a value that looks into a colormap. Pixels
+with higher depth use a bit packing process to place three or four values into
+a single number.
+
+The arrays are indexed by the ``X`` axis first, followed by the ``Y`` axis.
+Arrays that treat the pixels as a single integer are referred to as 2D arrays.
+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 :func:`array2d` and :func:`pixels2d`
+are mapped to the specific surface. Use :meth:`pygame.Surface.unmap_rgb`
+to convert to a color, and :meth:`pygame.Surface.map_rgb` 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 :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
+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.
+
+.. function:: array2d
+
+   | :sl:`Copy pixels into a 2d array`
+   | :sg:`array2d(Surface) -> array`
+
+   Copy the :meth:`mapped ` (raw) pixels from a Surface
+   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 :meth:`pygame.Surface.lock` - lock the Surface memory for pixel
+   access method).
+
+   .. ## pygame.surfarray.array2d ##
+
+.. function:: pixels2d
+
+   | :sl:`Reference pixels into a 2d array`
+   | :sg:`pixels2d(Surface) -> array`
+
+   Create a new 2D array that directly references the pixel values in a
+   Surface. Any changes to the array will affect the pixels in the Surface.
+   This is a fast operation since no data is copied.
+
+   Pixels from a 24-bit Surface cannot be referenced, but all other Surface bit
+   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 :meth:`pygame.Surface.lock` - lock the Surface memory for pixel
+   access method.
+
+   .. ## pygame.surfarray.pixels2d ##
+
+.. function:: array3d
+
+   | :sl:`Copy pixels into a 3d array`
+   | :sg:`array3d(Surface) -> array`
+
+   Copy the pixels from a Surface into a 3D 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 :meth:`pygame.Surface.lock` - lock the Surface memory for pixel
+   access method).
+
+   .. ## pygame.surfarray.array3d ##
+
+.. function:: pixels3d
+
+   | :sl:`Reference pixels into a 3d array`
+   | :sg:`pixels3d(Surface) -> array`
+
+   Create a new 3D array that directly references the pixel values in a
+   Surface. Any changes to the array will affect the pixels in the Surface.
+   This is a fast operation since no data is copied.
+
+   This will only work on Surfaces that have 24-bit or 32-bit formats. Lower
+   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 :meth:`pygame.Surface.lock` - lock the Surface memory for pixel
+   access method.
+
+   .. ## pygame.surfarray.pixels3d ##
+
+.. function:: array_alpha
+
+   | :sl:`Copy pixel alphas into a 2d array`
+   | :sg:`array_alpha(Surface) -> array`
+
+   Copy the pixel alpha values (degree of transparency) from a Surface into a
+   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 :meth:`pygame.Surface.lock` - lock the Surface memory for pixel
+   access method).
+
+   .. ## pygame.surfarray.array_alpha ##
+
+.. function:: pixels_alpha
+
+   | :sl:`Reference pixel alphas into a 2d array`
+   | :sg:`pixels_alpha(Surface) -> array`
+
+   Create a new 2D array that directly references the alpha values (degree of
+   transparency) in a Surface. Any changes to the array will affect the pixels
+   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 :meth:`pygame.Surface.lock` - lock the Surface memory for pixel
+   access method.
+
+   .. ## pygame.surfarray.pixels_alpha ##
+
+.. function:: array_red
+
+   | :sl:`Copy red pixels into a 2d array`
+   | :sg:`array_red(Surface) -> array`
+
+   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 :meth:`pygame.Surface.lock` - lock the Surface memory for pixel
+   access method).
+
+   .. versionadded:: 2.0.2
+
+   .. ## pygame.surfarray.array_red ##
+
+.. function:: pixels_red
+
+   | :sl:`Reference pixel red into a 2d array.`
+   | :sg:`pixels_red (Surface) -> array`
+
+   Create a new 2D array that directly references the red values in a Surface.
+   Any changes to the array will affect the pixels in the Surface. 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 :meth:`pygame.Surface.lock` - lock the Surface memory for pixel
+   access method.
+
+   .. ## pygame.surfarray.pixels_red ##
+
+.. function:: array_green
+
+   | :sl:`Copy green pixels into a 2d array`
+   | :sg:`array_green(Surface) -> array`
+
+   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 :meth:`pygame.Surface.lock` - lock the Surface memory for pixel
+   access method).
+
+   .. versionadded:: 2.0.2
+
+   .. ## pygame.surfarray.array_green ##
+
+.. function:: pixels_green
+
+   | :sl:`Reference pixel green into a 2d array.`
+   | :sg:`pixels_green (Surface) -> array`
+
+   Create a new 2D array that directly references the green values in a
+   Surface. Any changes to the array will affect the pixels in the Surface.
+   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 :meth:`pygame.Surface.lock` - lock the Surface memory for pixel
+   access method.
+
+   .. ## pygame.surfarray.pixels_green ##
+
+.. function:: array_blue
+
+   | :sl:`Copy blue pixels into a 2d array`
+   | :sg:`array_blue(Surface) -> array`
+
+   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 :meth:`pygame.Surface.lock` - lock the Surface memory for pixel
+   access method).
+
+   .. versionadded:: 2.0.2
+
+   .. ## pygame.surfarray.array_blue ##
+
+.. function:: pixels_blue
+
+   | :sl:`Reference pixel blue into a 2d array.`
+   | :sg:`pixels_blue (Surface) -> array`
+
+   Create a new 2D array that directly references the blue values in a Surface.
+   Any changes to the array will affect the pixels in the Surface. 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 :meth:`pygame.Surface.lock` - lock the Surface memory for pixel
+   access method.
+
+   .. ## pygame.surfarray.pixels_blue ##
+
+.. function:: array_colorkey
+
+   | :sl:`Copy the colorkey values into a 2d array`
+   | :sg:`array_colorkey(Surface) -> array`
+
+   Create a new array with the colorkey transparency value from each pixel. If
+   the pixel matches the colorkey it will be fully transparent; otherwise it
+   will be fully opaque.
+
+   This will work on any type of Surface format. If the image has no colorkey a
+   solid opaque array will be returned.
+
+   This function will temporarily lock the Surface as pixels are copied.
+
+   .. ## pygame.surfarray.array_colorkey ##
+
+.. function:: make_surface
+
+   | :sl:`Copy an array to a new surface`
+   | :sg:`make_surface(array) -> 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. Function
+   make_surface uses the array struct interface to acquire array properties,
+   so is not limited to just NumPy arrays. See :mod:`pygame.pixelcopy`.
+
+   New in pygame 1.9.2: array struct interface support.
+
+   .. ## pygame.surfarray.make_surface ##
+
+.. function:: blit_array
+
+   | :sl:`Blit directly from a array values`
+   | :sg:`blit_array(Surface, array) -> None`
+
+   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. Only
+   integer, ASCII character and record arrays are accepted.
+
+   This function will temporarily lock the Surface as the new values are
+   copied.
+
+   .. ## pygame.surfarray.blit_array ##
+
+.. function:: map_array
+
+   | :sl:`Map a 3d array into a 2d array`
+   | :sg:`map_array(Surface, array3d) -> array2d`
+
+   Convert a 3D array into a 2D array. This will use the given Surface format
+   to control the conversion. Palette surface formats are supported for NumPy
+   arrays.
+
+   .. ## pygame.surfarray.map_array ##
+
+.. function:: use_arraytype
+
+   | :sl:`Sets the array system to be used for surface 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.surfarray.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.surfarray.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.surfarray.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.surfarray.get_arraytypes ##
+
+.. ## pygame.surfarray ##
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_sources/ref/tests.rst.txt b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_sources/ref/tests.rst.txt
new file mode 100644
index 0000000..88184f6
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_sources/ref/tests.rst.txt
@@ -0,0 +1,113 @@
+.. include:: common.txt
+
+:mod:`pygame.tests`
+===================
+
+.. module:: pygame.tests
+   :synopsis: Pygame unit test suite package
+
+| :sl:`Pygame unit test suite package`
+
+A quick way to run the test suite package from the command line is to import
+the go submodule with the Python -m option:
+
+::
+
+  python -m pygame.tests []
+
+Command line option --help displays a usage message. Available options
+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, 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 _tags.py module.
+The tags module has the global __tags__, a list of tag names. For example,
+``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.
+
+.. function:: run
+
+   | :sl:`Run the pygame unit test suite`
+   | :sg:`run(*args, **kwds) -> tuple`
+
+   Positional arguments (optional):
+
+   ::
+
+       The names of tests to include. If omitted then all tests are run. Test names
+       need not include the trailing '_test'.
+
+   Keyword arguments:
+
+   ::
+
+       incomplete - fail incomplete tests (default False)
+       nosubprocess - run all test suites in the current process
+                      (default False, use separate subprocesses)
+       dump - dump failures/errors as dict ready to eval (default False)
+       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
+       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)
+       seed - if provided, a seed randomizer integer
+       multi_thread - if provided, the number of THREADS in which to run
+                      subprocessed tests
+       time_out - if subprocess is True then the time limit in seconds before
+                  killing a test (default 30)
+       fake - if provided, the name of the fake tests package in the
+              run_tests__tests subpackage to run instead of the normal
+              pygame tests
+       python - the path to a python executable to run subprocessed tests
+                (default sys.executable)
+
+   Return value:
+
+   ::
+
+       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
+   recreates normal pygame usage where ``pygame.init()`` and ``pygame.quit()``
+   are called only once per program execution, and avoids unfortunate
+   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 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 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.
+
+   .. ## pygame.tests.run ##
+
+.. ## pygame.tests ##
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_sources/ref/time.rst.txt b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_sources/ref/time.rst.txt
new file mode 100644
index 0000000..59e0999
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_sources/ref/time.rst.txt
@@ -0,0 +1,165 @@
+.. include:: common.txt
+
+:mod:`pygame.time`
+==================
+
+.. 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/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_sources/ref/touch.rst.txt b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_sources/ref/touch.rst.txt
new file mode 100644
index 0000000..320da05
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_sources/ref/touch.rst.txt
@@ -0,0 +1,66 @@
+.. include:: common.txt
+
+:mod:`pygame._sdl2.touch`
+=========================
+
+.. module:: pygame._sdl2.touch
+   :synopsis: pygame module to work with touch input
+
+| :sl:`pygame module to work with touch input`
+
+.. versionadded:: 2 This module requires SDL2.
+
+.. function:: get_num_devices
+
+   | :sl:`get the number of touch devices`
+   | :sg:`get_num_devices() -> int`
+
+   Return the number of available touch devices.
+
+   .. ## pygame._sdl2.touch.get_num_devices ##
+
+.. function:: get_device
+
+   | :sl:`get the a touch device id for a given index`
+   | :sg:`get_device(index) -> touchid`
+
+   :param int index: This number is at least 0 and less than the
+                     :func:`number of devices `.
+
+   Return an integer id associated with the given ``index``.
+
+   .. ## pygame._sdl2.touch.get_device ##
+
+.. function:: get_num_fingers
+
+   | :sl:`the number of active fingers for a given touch device`
+   | :sg:`get_num_fingers(touchid) -> int`
+
+   Return the number of fingers active for the touch device
+   whose id is `touchid`.
+
+   .. ## pygame._sdl2.touch.get_num_fingers ##
+
+.. function:: get_finger
+
+   | :sl:`get information about an active finger`
+   | :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``.
+   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.
+      y          the normalized y position of the finger, between 0 and 1.
+      pressure   the amount of pressure applied by the finger, between 0 and 1.
+
+   .. ## pygame._sdl2.touch.get_finger ##
+
+.. ## pygame._sdl2.touch ##
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_sources/ref/transform.rst.txt b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_sources/ref/transform.rst.txt
new file mode 100644
index 0000000..91a3a8f
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_sources/ref/transform.rst.txt
@@ -0,0 +1,325 @@
+.. include:: common.txt
+
+:mod:`pygame.transform`
+=======================
+
+.. 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/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_static/_sphinx_javascript_frameworks_compat.js b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_static/_sphinx_javascript_frameworks_compat.js
new file mode 100644
index 0000000..8549469
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_static/_sphinx_javascript_frameworks_compat.js
@@ -0,0 +1,134 @@
+/*
+ * _sphinx_javascript_frameworks_compat.js
+ * ~~~~~~~~~~
+ *
+ * Compatability shim for jQuery and underscores.js.
+ *
+ * WILL BE REMOVED IN Sphinx 6.0
+ * xref RemovedInSphinx60Warning
+ *
+ */
+
+/**
+ * select a different prefix for underscore
+ */
+$u = _.noConflict();
+
+
+/**
+ * small helper function to urldecode strings
+ *
+ * See https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/decodeURIComponent#Decoding_query_parameters_from_a_URL
+ */
+jQuery.urldecode = function(x) {
+    if (!x) {
+        return x
+    }
+    return decodeURIComponent(x.replace(/\+/g, ' '));
+};
+
+/**
+ * small helper function to urlencode strings
+ */
+jQuery.urlencode = encodeURIComponent;
+
+/**
+ * This function returns the parsed url parameters of the
+ * current request. Multiple values per key are supported,
+ * it will always return arrays of strings for the value parts.
+ */
+jQuery.getQueryParameters = function(s) {
+    if (typeof s === 'undefined')
+        s = document.location.search;
+    var parts = s.substr(s.indexOf('?') + 1).split('&');
+    var result = {};
+    for (var i = 0; i < parts.length; i++) {
+        var tmp = parts[i].split('=', 2);
+        var key = jQuery.urldecode(tmp[0]);
+        var value = jQuery.urldecode(tmp[1]);
+        if (key in result)
+            result[key].push(value);
+        else
+            result[key] = [value];
+    }
+    return result;
+};
+
+/**
+ * highlight a given string on a jquery object by wrapping it in
+ * span elements with the given class name.
+ */
+jQuery.fn.highlightText = function(text, className) {
+    function highlight(node, addItems) {
+        if (node.nodeType === 3) {
+            var val = node.nodeValue;
+            var pos = val.toLowerCase().indexOf(text);
+            if (pos >= 0 &&
+                !jQuery(node.parentNode).hasClass(className) &&
+                !jQuery(node.parentNode).hasClass("nohighlight")) {
+                var span;
+                var isInSVG = jQuery(node).closest("body, svg, foreignObject").is("svg");
+                if (isInSVG) {
+                    span = document.createElementNS("http://www.w3.org/2000/svg", "tspan");
+                } else {
+                    span = document.createElement("span");
+                    span.className = className;
+                }
+                span.appendChild(document.createTextNode(val.substr(pos, text.length)));
+                node.parentNode.insertBefore(span, node.parentNode.insertBefore(
+                    document.createTextNode(val.substr(pos + text.length)),
+                    node.nextSibling));
+                node.nodeValue = val.substr(0, pos);
+                if (isInSVG) {
+                    var rect = document.createElementNS("http://www.w3.org/2000/svg", "rect");
+                    var bbox = node.parentElement.getBBox();
+                    rect.x.baseVal.value = bbox.x;
+                    rect.y.baseVal.value = bbox.y;
+                    rect.width.baseVal.value = bbox.width;
+                    rect.height.baseVal.value = bbox.height;
+                    rect.setAttribute('class', className);
+                    addItems.push({
+                        "parent": node.parentNode,
+                        "target": rect});
+                }
+            }
+        }
+        else if (!jQuery(node).is("button, select, textarea")) {
+            jQuery.each(node.childNodes, function() {
+                highlight(this, addItems);
+            });
+        }
+    }
+    var addItems = [];
+    var result = this.each(function() {
+        highlight(this, addItems);
+    });
+    for (var i = 0; i < addItems.length; ++i) {
+        jQuery(addItems[i].parent).before(addItems[i].target);
+    }
+    return result;
+};
+
+/*
+ * backward compatibility for jQuery.browser
+ * This will be supported until firefox bug is fixed.
+ */
+if (!jQuery.browser) {
+    jQuery.uaMatch = function(ua) {
+        ua = ua.toLowerCase();
+
+        var match = /(chrome)[ \/]([\w.]+)/.exec(ua) ||
+            /(webkit)[ \/]([\w.]+)/.exec(ua) ||
+            /(opera)(?:.*version|)[ \/]([\w.]+)/.exec(ua) ||
+            /(msie) ([\w.]+)/.exec(ua) ||
+            ua.indexOf("compatible") < 0 && /(mozilla)(?:.*? rv:([\w.]+)|)/.exec(ua) ||
+            [];
+
+        return {
+            browser: match[ 1 ] || "",
+            version: match[ 2 ] || "0"
+        };
+    };
+    jQuery.browser = {};
+    jQuery.browser[jQuery.uaMatch(navigator.userAgent).browser] = true;
+}
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_static/basic.css b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_static/basic.css
new file mode 100644
index 0000000..f316efc
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_static/basic.css
@@ -0,0 +1,925 @@
+/*
+ * basic.css
+ * ~~~~~~~~~
+ *
+ * Sphinx stylesheet -- basic theme.
+ *
+ * :copyright: Copyright 2007-2024 by the Sphinx team, see AUTHORS.
+ * :license: BSD, see LICENSE for details.
+ *
+ */
+
+/* -- main layout ----------------------------------------------------------- */
+
+div.clearer {
+    clear: both;
+}
+
+div.section::after {
+    display: block;
+    content: '';
+    clear: left;
+}
+
+/* -- relbar ---------------------------------------------------------------- */
+
+div.related {
+    width: 100%;
+    font-size: 90%;
+}
+
+div.related h3 {
+    display: none;
+}
+
+div.related ul {
+    margin: 0;
+    padding: 0 0 0 10px;
+    list-style: none;
+}
+
+div.related li {
+    display: inline;
+}
+
+div.related li.right {
+    float: right;
+    margin-right: 5px;
+}
+
+/* -- sidebar --------------------------------------------------------------- */
+
+div.sphinxsidebarwrapper {
+    padding: 10px 5px 0 10px;
+}
+
+div.sphinxsidebar {
+    float: left;
+    width: 230px;
+    margin-left: -100%;
+    font-size: 90%;
+    word-wrap: break-word;
+    overflow-wrap : break-word;
+}
+
+div.sphinxsidebar ul {
+    list-style: none;
+}
+
+div.sphinxsidebar ul ul,
+div.sphinxsidebar ul.want-points {
+    margin-left: 20px;
+    list-style: square;
+}
+
+div.sphinxsidebar ul ul {
+    margin-top: 0;
+    margin-bottom: 0;
+}
+
+div.sphinxsidebar form {
+    margin-top: 10px;
+}
+
+div.sphinxsidebar input {
+    border: 1px solid #98dbcc;
+    font-family: sans-serif;
+    font-size: 1em;
+}
+
+div.sphinxsidebar #searchbox form.search {
+    overflow: hidden;
+}
+
+div.sphinxsidebar #searchbox input[type="text"] {
+    float: left;
+    width: 80%;
+    padding: 0.25em;
+    box-sizing: border-box;
+}
+
+div.sphinxsidebar #searchbox input[type="submit"] {
+    float: left;
+    width: 20%;
+    border-left: none;
+    padding: 0.25em;
+    box-sizing: border-box;
+}
+
+
+img {
+    border: 0;
+    max-width: 100%;
+}
+
+/* -- search page ----------------------------------------------------------- */
+
+ul.search {
+    margin: 10px 0 0 20px;
+    padding: 0;
+}
+
+ul.search li {
+    padding: 5px 0 5px 20px;
+    background-image: url(file.png);
+    background-repeat: no-repeat;
+    background-position: 0 7px;
+}
+
+ul.search li a {
+    font-weight: bold;
+}
+
+ul.search li p.context {
+    color: #888;
+    margin: 2px 0 0 30px;
+    text-align: left;
+}
+
+ul.keywordmatches li.goodmatch a {
+    font-weight: bold;
+}
+
+/* -- index page ------------------------------------------------------------ */
+
+table.contentstable {
+    width: 90%;
+    margin-left: auto;
+    margin-right: auto;
+}
+
+table.contentstable p.biglink {
+    line-height: 150%;
+}
+
+a.biglink {
+    font-size: 1.3em;
+}
+
+span.linkdescr {
+    font-style: italic;
+    padding-top: 5px;
+    font-size: 90%;
+}
+
+/* -- general index --------------------------------------------------------- */
+
+table.indextable {
+    width: 100%;
+}
+
+table.indextable td {
+    text-align: left;
+    vertical-align: top;
+}
+
+table.indextable ul {
+    margin-top: 0;
+    margin-bottom: 0;
+    list-style-type: none;
+}
+
+table.indextable > tbody > tr > td > ul {
+    padding-left: 0em;
+}
+
+table.indextable tr.pcap {
+    height: 10px;
+}
+
+table.indextable tr.cap {
+    margin-top: 10px;
+    background-color: #f2f2f2;
+}
+
+img.toggler {
+    margin-right: 3px;
+    margin-top: 3px;
+    cursor: pointer;
+}
+
+div.modindex-jumpbox {
+    border-top: 1px solid #ddd;
+    border-bottom: 1px solid #ddd;
+    margin: 1em 0 1em 0;
+    padding: 0.4em;
+}
+
+div.genindex-jumpbox {
+    border-top: 1px solid #ddd;
+    border-bottom: 1px solid #ddd;
+    margin: 1em 0 1em 0;
+    padding: 0.4em;
+}
+
+/* -- domain module index --------------------------------------------------- */
+
+table.modindextable td {
+    padding: 2px;
+    border-collapse: collapse;
+}
+
+/* -- general body styles --------------------------------------------------- */
+
+div.body {
+    min-width: 360px;
+    max-width: 800px;
+}
+
+div.body p, div.body dd, div.body li, div.body blockquote {
+    -moz-hyphens: auto;
+    -ms-hyphens: auto;
+    -webkit-hyphens: auto;
+    hyphens: auto;
+}
+
+a.headerlink {
+    visibility: hidden;
+}
+
+a:visited {
+    color: #551A8B;
+}
+
+h1:hover > a.headerlink,
+h2:hover > a.headerlink,
+h3:hover > a.headerlink,
+h4:hover > a.headerlink,
+h5:hover > a.headerlink,
+h6:hover > a.headerlink,
+dt:hover > a.headerlink,
+caption:hover > a.headerlink,
+p.caption:hover > a.headerlink,
+div.code-block-caption:hover > a.headerlink {
+    visibility: visible;
+}
+
+div.body p.caption {
+    text-align: inherit;
+}
+
+div.body td {
+    text-align: left;
+}
+
+.first {
+    margin-top: 0 !important;
+}
+
+p.rubric {
+    margin-top: 30px;
+    font-weight: bold;
+}
+
+img.align-left, figure.align-left, .figure.align-left, object.align-left {
+    clear: left;
+    float: left;
+    margin-right: 1em;
+}
+
+img.align-right, figure.align-right, .figure.align-right, object.align-right {
+    clear: right;
+    float: right;
+    margin-left: 1em;
+}
+
+img.align-center, figure.align-center, .figure.align-center, object.align-center {
+  display: block;
+  margin-left: auto;
+  margin-right: auto;
+}
+
+img.align-default, figure.align-default, .figure.align-default {
+  display: block;
+  margin-left: auto;
+  margin-right: auto;
+}
+
+.align-left {
+    text-align: left;
+}
+
+.align-center {
+    text-align: center;
+}
+
+.align-default {
+    text-align: center;
+}
+
+.align-right {
+    text-align: right;
+}
+
+/* -- sidebars -------------------------------------------------------------- */
+
+div.sidebar,
+aside.sidebar {
+    margin: 0 0 0.5em 1em;
+    border: 1px solid #ddb;
+    padding: 7px;
+    background-color: #ffe;
+    width: 40%;
+    float: right;
+    clear: right;
+    overflow-x: auto;
+}
+
+p.sidebar-title {
+    font-weight: bold;
+}
+
+nav.contents,
+aside.topic,
+div.admonition, div.topic, blockquote {
+    clear: left;
+}
+
+/* -- topics ---------------------------------------------------------------- */
+
+nav.contents,
+aside.topic,
+div.topic {
+    border: 1px solid #ccc;
+    padding: 7px;
+    margin: 10px 0 10px 0;
+}
+
+p.topic-title {
+    font-size: 1.1em;
+    font-weight: bold;
+    margin-top: 10px;
+}
+
+/* -- admonitions ----------------------------------------------------------- */
+
+div.admonition {
+    margin-top: 10px;
+    margin-bottom: 10px;
+    padding: 7px;
+}
+
+div.admonition dt {
+    font-weight: bold;
+}
+
+p.admonition-title {
+    margin: 0px 10px 5px 0px;
+    font-weight: bold;
+}
+
+div.body p.centered {
+    text-align: center;
+    margin-top: 25px;
+}
+
+/* -- content of sidebars/topics/admonitions -------------------------------- */
+
+div.sidebar > :last-child,
+aside.sidebar > :last-child,
+nav.contents > :last-child,
+aside.topic > :last-child,
+div.topic > :last-child,
+div.admonition > :last-child {
+    margin-bottom: 0;
+}
+
+div.sidebar::after,
+aside.sidebar::after,
+nav.contents::after,
+aside.topic::after,
+div.topic::after,
+div.admonition::after,
+blockquote::after {
+    display: block;
+    content: '';
+    clear: both;
+}
+
+/* -- tables ---------------------------------------------------------------- */
+
+table.docutils {
+    margin-top: 10px;
+    margin-bottom: 10px;
+    border: 0;
+    border-collapse: collapse;
+}
+
+table.align-center {
+    margin-left: auto;
+    margin-right: auto;
+}
+
+table.align-default {
+    margin-left: auto;
+    margin-right: auto;
+}
+
+table caption span.caption-number {
+    font-style: italic;
+}
+
+table caption span.caption-text {
+}
+
+table.docutils td, table.docutils th {
+    padding: 1px 8px 1px 5px;
+    border-top: 0;
+    border-left: 0;
+    border-right: 0;
+    border-bottom: 1px solid #aaa;
+}
+
+th {
+    text-align: left;
+    padding-right: 5px;
+}
+
+table.citation {
+    border-left: solid 1px gray;
+    margin-left: 1px;
+}
+
+table.citation td {
+    border-bottom: none;
+}
+
+th > :first-child,
+td > :first-child {
+    margin-top: 0px;
+}
+
+th > :last-child,
+td > :last-child {
+    margin-bottom: 0px;
+}
+
+/* -- figures --------------------------------------------------------------- */
+
+div.figure, figure {
+    margin: 0.5em;
+    padding: 0.5em;
+}
+
+div.figure p.caption, figcaption {
+    padding: 0.3em;
+}
+
+div.figure p.caption span.caption-number,
+figcaption span.caption-number {
+    font-style: italic;
+}
+
+div.figure p.caption span.caption-text,
+figcaption span.caption-text {
+}
+
+/* -- field list styles ----------------------------------------------------- */
+
+table.field-list td, table.field-list th {
+    border: 0 !important;
+}
+
+.field-list ul {
+    margin: 0;
+    padding-left: 1em;
+}
+
+.field-list p {
+    margin: 0;
+}
+
+.field-name {
+    -moz-hyphens: manual;
+    -ms-hyphens: manual;
+    -webkit-hyphens: manual;
+    hyphens: manual;
+}
+
+/* -- hlist styles ---------------------------------------------------------- */
+
+table.hlist {
+    margin: 1em 0;
+}
+
+table.hlist td {
+    vertical-align: top;
+}
+
+/* -- object description styles --------------------------------------------- */
+
+.sig {
+	font-family: 'Consolas', 'Menlo', 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', monospace;
+}
+
+.sig-name, code.descname {
+    background-color: transparent;
+    font-weight: bold;
+}
+
+.sig-name {
+	font-size: 1.1em;
+}
+
+code.descname {
+    font-size: 1.2em;
+}
+
+.sig-prename, code.descclassname {
+    background-color: transparent;
+}
+
+.optional {
+    font-size: 1.3em;
+}
+
+.sig-paren {
+    font-size: larger;
+}
+
+.sig-param.n {
+	font-style: italic;
+}
+
+/* C++ specific styling */
+
+.sig-inline.c-texpr,
+.sig-inline.cpp-texpr {
+	font-family: unset;
+}
+
+.sig.c   .k, .sig.c   .kt,
+.sig.cpp .k, .sig.cpp .kt {
+	color: #0033B3;
+}
+
+.sig.c   .m,
+.sig.cpp .m {
+	color: #1750EB;
+}
+
+.sig.c   .s, .sig.c   .sc,
+.sig.cpp .s, .sig.cpp .sc {
+	color: #067D17;
+}
+
+
+/* -- other body styles ----------------------------------------------------- */
+
+ol.arabic {
+    list-style: decimal;
+}
+
+ol.loweralpha {
+    list-style: lower-alpha;
+}
+
+ol.upperalpha {
+    list-style: upper-alpha;
+}
+
+ol.lowerroman {
+    list-style: lower-roman;
+}
+
+ol.upperroman {
+    list-style: upper-roman;
+}
+
+:not(li) > ol > li:first-child > :first-child,
+:not(li) > ul > li:first-child > :first-child {
+    margin-top: 0px;
+}
+
+:not(li) > ol > li:last-child > :last-child,
+:not(li) > ul > li:last-child > :last-child {
+    margin-bottom: 0px;
+}
+
+ol.simple ol p,
+ol.simple ul p,
+ul.simple ol p,
+ul.simple ul p {
+    margin-top: 0;
+}
+
+ol.simple > li:not(:first-child) > p,
+ul.simple > li:not(:first-child) > p {
+    margin-top: 0;
+}
+
+ol.simple p,
+ul.simple p {
+    margin-bottom: 0;
+}
+
+aside.footnote > span,
+div.citation > span {
+    float: left;
+}
+aside.footnote > span:last-of-type,
+div.citation > span:last-of-type {
+  padding-right: 0.5em;
+}
+aside.footnote > p {
+  margin-left: 2em;
+}
+div.citation > p {
+  margin-left: 4em;
+}
+aside.footnote > p:last-of-type,
+div.citation > p:last-of-type {
+    margin-bottom: 0em;
+}
+aside.footnote > p:last-of-type:after,
+div.citation > p:last-of-type:after {
+    content: "";
+    clear: both;
+}
+
+dl.field-list {
+    display: grid;
+    grid-template-columns: fit-content(30%) auto;
+}
+
+dl.field-list > dt {
+    font-weight: bold;
+    word-break: break-word;
+    padding-left: 0.5em;
+    padding-right: 5px;
+}
+
+dl.field-list > dd {
+    padding-left: 0.5em;
+    margin-top: 0em;
+    margin-left: 0em;
+    margin-bottom: 0em;
+}
+
+dl {
+    margin-bottom: 15px;
+}
+
+dd > :first-child {
+    margin-top: 0px;
+}
+
+dd ul, dd table {
+    margin-bottom: 10px;
+}
+
+dd {
+    margin-top: 3px;
+    margin-bottom: 10px;
+    margin-left: 30px;
+}
+
+.sig dd {
+    margin-top: 0px;
+    margin-bottom: 0px;
+}
+
+.sig dl {
+    margin-top: 0px;
+    margin-bottom: 0px;
+}
+
+dl > dd:last-child,
+dl > dd:last-child > :last-child {
+    margin-bottom: 0;
+}
+
+dt:target, span.highlighted {
+    background-color: #fbe54e;
+}
+
+rect.highlighted {
+    fill: #fbe54e;
+}
+
+dl.glossary dt {
+    font-weight: bold;
+    font-size: 1.1em;
+}
+
+.versionmodified {
+    font-style: italic;
+}
+
+.system-message {
+    background-color: #fda;
+    padding: 5px;
+    border: 3px solid red;
+}
+
+.footnote:target  {
+    background-color: #ffa;
+}
+
+.line-block {
+    display: block;
+    margin-top: 1em;
+    margin-bottom: 1em;
+}
+
+.line-block .line-block {
+    margin-top: 0;
+    margin-bottom: 0;
+    margin-left: 1.5em;
+}
+
+.guilabel, .menuselection {
+    font-family: sans-serif;
+}
+
+.accelerator {
+    text-decoration: underline;
+}
+
+.classifier {
+    font-style: oblique;
+}
+
+.classifier:before {
+    font-style: normal;
+    margin: 0 0.5em;
+    content: ":";
+    display: inline-block;
+}
+
+abbr, acronym {
+    border-bottom: dotted 1px;
+    cursor: help;
+}
+
+.translated {
+    background-color: rgba(207, 255, 207, 0.2)
+}
+
+.untranslated {
+    background-color: rgba(255, 207, 207, 0.2)
+}
+
+/* -- code displays --------------------------------------------------------- */
+
+pre {
+    overflow: auto;
+    overflow-y: hidden;  /* fixes display issues on Chrome browsers */
+}
+
+pre, div[class*="highlight-"] {
+    clear: both;
+}
+
+span.pre {
+    -moz-hyphens: none;
+    -ms-hyphens: none;
+    -webkit-hyphens: none;
+    hyphens: none;
+    white-space: nowrap;
+}
+
+div[class*="highlight-"] {
+    margin: 1em 0;
+}
+
+td.linenos pre {
+    border: 0;
+    background-color: transparent;
+    color: #aaa;
+}
+
+table.highlighttable {
+    display: block;
+}
+
+table.highlighttable tbody {
+    display: block;
+}
+
+table.highlighttable tr {
+    display: flex;
+}
+
+table.highlighttable td {
+    margin: 0;
+    padding: 0;
+}
+
+table.highlighttable td.linenos {
+    padding-right: 0.5em;
+}
+
+table.highlighttable td.code {
+    flex: 1;
+    overflow: hidden;
+}
+
+.highlight .hll {
+    display: block;
+}
+
+div.highlight pre,
+table.highlighttable pre {
+    margin: 0;
+}
+
+div.code-block-caption + div {
+    margin-top: 0;
+}
+
+div.code-block-caption {
+    margin-top: 1em;
+    padding: 2px 5px;
+    font-size: small;
+}
+
+div.code-block-caption code {
+    background-color: transparent;
+}
+
+table.highlighttable td.linenos,
+span.linenos,
+div.highlight span.gp {  /* gp: Generic.Prompt */
+  user-select: none;
+  -webkit-user-select: text; /* Safari fallback only */
+  -webkit-user-select: none; /* Chrome/Safari */
+  -moz-user-select: none; /* Firefox */
+  -ms-user-select: none; /* IE10+ */
+}
+
+div.code-block-caption span.caption-number {
+    padding: 0.1em 0.3em;
+    font-style: italic;
+}
+
+div.code-block-caption span.caption-text {
+}
+
+div.literal-block-wrapper {
+    margin: 1em 0;
+}
+
+code.xref, a code {
+    background-color: transparent;
+    font-weight: bold;
+}
+
+h1 code, h2 code, h3 code, h4 code, h5 code, h6 code {
+    background-color: transparent;
+}
+
+.viewcode-link {
+    float: right;
+}
+
+.viewcode-back {
+    float: right;
+    font-family: sans-serif;
+}
+
+div.viewcode-block:target {
+    margin: -1px -10px;
+    padding: 0 10px;
+}
+
+/* -- math display ---------------------------------------------------------- */
+
+img.math {
+    vertical-align: middle;
+}
+
+div.body div.math p {
+    text-align: center;
+}
+
+span.eqno {
+    float: right;
+}
+
+span.eqno a.headerlink {
+    position: absolute;
+    z-index: 1;
+}
+
+div.math:hover a.headerlink {
+    visibility: visible;
+}
+
+/* -- printout stylesheet --------------------------------------------------- */
+
+@media print {
+    div.document,
+    div.documentwrapper,
+    div.bodywrapper {
+        margin: 0 !important;
+        width: 100%;
+    }
+
+    div.sphinxsidebar,
+    div.related,
+    div.footer,
+    #top-link {
+        display: none;
+    }
+}
\ No newline at end of file
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_static/doctools.js b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_static/doctools.js
new file mode 100644
index 0000000..4d67807
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_static/doctools.js
@@ -0,0 +1,156 @@
+/*
+ * 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";
+
+const BLACKLISTED_KEY_CONTROL_ELEMENTS = new Set([
+  "TEXTAREA",
+  "INPUT",
+  "SELECT",
+  "BUTTON",
+]);
+
+const _ready = (callback) => {
+  if (document.readyState !== "loading") {
+    callback();
+  } else {
+    document.addEventListener("DOMContentLoaded", callback);
+  }
+};
+
+/**
+ * Small JavaScript module for the documentation.
+ */
+const Documentation = {
+  init: () => {
+    Documentation.initDomainIndexTable();
+    Documentation.initOnKeyListeners();
+  },
+
+  /**
+   * i18n support
+   */
+  TRANSLATIONS: {},
+  PLURAL_EXPR: (n) => (n === 1 ? 0 : 1),
+  LOCALE: "unknown",
+
+  // gettext and ngettext don't access this so that the functions
+  // can safely bound to a different name (_ = Documentation.gettext)
+  gettext: (string) => {
+    const translated = Documentation.TRANSLATIONS[string];
+    switch (typeof translated) {
+      case "undefined":
+        return string; // no translation
+      case "string":
+        return translated; // translation exists
+      default:
+        return translated[0]; // (singular, plural) translation tuple exists
+    }
+  },
+
+  ngettext: (singular, plural, n) => {
+    const translated = Documentation.TRANSLATIONS[singular];
+    if (typeof translated !== "undefined")
+      return translated[Documentation.PLURAL_EXPR(n)];
+    return n === 1 ? singular : plural;
+  },
+
+  addTranslations: (catalog) => {
+    Object.assign(Documentation.TRANSLATIONS, catalog.messages);
+    Documentation.PLURAL_EXPR = new Function(
+      "n",
+      `return (${catalog.plural_expr})`
+    );
+    Documentation.LOCALE = catalog.locale;
+  },
+
+  /**
+   * helper function to focus on search bar
+   */
+  focusSearchBar: () => {
+    document.querySelectorAll("input[name=q]")[0]?.focus();
+  },
+
+  /**
+   * Initialise the domain index toggle buttons
+   */
+  initDomainIndexTable: () => {
+    const toggler = (el) => {
+      const idNumber = el.id.substr(7);
+      const toggledRows = document.querySelectorAll(`tr.cg-${idNumber}`);
+      if (el.src.substr(-9) === "minus.png") {
+        el.src = `${el.src.substr(0, el.src.length - 9)}plus.png`;
+        toggledRows.forEach((el) => (el.style.display = "none"));
+      } else {
+        el.src = `${el.src.substr(0, el.src.length - 8)}minus.png`;
+        toggledRows.forEach((el) => (el.style.display = ""));
+      }
+    };
+
+    const togglerElements = document.querySelectorAll("img.toggler");
+    togglerElements.forEach((el) =>
+      el.addEventListener("click", (event) => toggler(event.currentTarget))
+    );
+    togglerElements.forEach((el) => (el.style.display = ""));
+    if (DOCUMENTATION_OPTIONS.COLLAPSE_INDEX) togglerElements.forEach(toggler);
+  },
+
+  initOnKeyListeners: () => {
+    // only install a listener if it is really needed
+    if (
+      !DOCUMENTATION_OPTIONS.NAVIGATION_WITH_KEYS &&
+      !DOCUMENTATION_OPTIONS.ENABLE_SEARCH_SHORTCUTS
+    )
+      return;
+
+    document.addEventListener("keydown", (event) => {
+      // bail for input elements
+      if (BLACKLISTED_KEY_CONTROL_ELEMENTS.has(document.activeElement.tagName)) return;
+      // bail with special keys
+      if (event.altKey || event.ctrlKey || event.metaKey) return;
+
+      if (!event.shiftKey) {
+        switch (event.key) {
+          case "ArrowLeft":
+            if (!DOCUMENTATION_OPTIONS.NAVIGATION_WITH_KEYS) break;
+
+            const prevLink = document.querySelector('link[rel="prev"]');
+            if (prevLink && prevLink.href) {
+              window.location.href = prevLink.href;
+              event.preventDefault();
+            }
+            break;
+          case "ArrowRight":
+            if (!DOCUMENTATION_OPTIONS.NAVIGATION_WITH_KEYS) break;
+
+            const nextLink = document.querySelector('link[rel="next"]');
+            if (nextLink && nextLink.href) {
+              window.location.href = nextLink.href;
+              event.preventDefault();
+            }
+            break;
+        }
+      }
+
+      // some keyboard layouts may need Shift to get /
+      switch (event.key) {
+        case "/":
+          if (!DOCUMENTATION_OPTIONS.ENABLE_SEARCH_SHORTCUTS) break;
+          Documentation.focusSearchBar();
+          event.preventDefault();
+      }
+    });
+  },
+};
+
+// quick alias for translations
+const _ = Documentation.gettext;
+
+_ready(Documentation.init);
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_static/documentation_options.js b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_static/documentation_options.js
new file mode 100644
index 0000000..400c682
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_static/documentation_options.js
@@ -0,0 +1,13 @@
+const DOCUMENTATION_OPTIONS = {
+    VERSION: '2.6.1',
+    LANGUAGE: 'en',
+    COLLAPSE_INDEX: false,
+    BUILDER: 'html',
+    FILE_SUFFIX: '.html',
+    LINK_SUFFIX: '.html',
+    HAS_SOURCE: true,
+    SOURCELINK_SUFFIX: '.txt',
+    NAVIGATION_WITH_KEYS: false,
+    SHOW_SEARCH_SUMMARY: true,
+    ENABLE_SEARCH_SHORTCUTS: true,
+};
\ No newline at end of file
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_static/file.png b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_static/file.png
new file mode 100644
index 0000000..a858a41
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_static/file.png differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_static/jquery-3.6.0.js b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_static/jquery-3.6.0.js
new file mode 100644
index 0000000..fc6c299
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/_static/jquery-3.6.0.js
@@ -0,0 +1,10881 @@
+/*!
+ * jQuery JavaScript Library v3.6.0
+ * https://jquery.com/
+ *
+ * Includes Sizzle.js
+ * https://sizzlejs.com/
+ *
+ * Copyright OpenJS Foundation and other contributors
+ * Released under the MIT license
+ * https://jquery.org/license
+ *
+ * Date: 2021-03-02T17:08Z
+ */
+( function( global, factory ) {
+
+	"use strict";
+
+	if ( typeof module === "object" && typeof module.exports === "object" ) {
+
+		// For CommonJS and CommonJS-like environments where a proper `window`
+		// is present, execute the factory and get jQuery.
+		// For environments that do not have a `window` with a `document`
+		// (such as Node.js), expose a factory as module.exports.
+		// This accentuates the need for the creation of a real `window`.
+		// e.g. var jQuery = require("jquery")(window);
+		// See ticket #14549 for more info.
+		module.exports = global.document ?
+			factory( global, true ) :
+			function( w ) {
+				if ( !w.document ) {
+					throw new Error( "jQuery requires a window with a document" );
+				}
+				return factory( w );
+			};
+	} else {
+		factory( global );
+	}
+
+// Pass this if window is not defined yet
+} )( typeof window !== "undefined" ? window : this, function( window, noGlobal ) {
+
+// Edge <= 12 - 13+, Firefox <=18 - 45+, IE 10 - 11, Safari 5.1 - 9+, iOS 6 - 9.1
+// throw exceptions when non-strict code (e.g., ASP.NET 4.5) accesses strict mode
+// arguments.callee.caller (trac-13335). But as of jQuery 3.0 (2016), strict mode should be common
+// enough that all such attempts are guarded in a try block.
+"use strict";
+
+var arr = [];
+
+var getProto = Object.getPrototypeOf;
+
+var slice = arr.slice;
+
+var flat = arr.flat ? function( array ) {
+	return arr.flat.call( array );
+} : function( array ) {
+	return arr.concat.apply( [], array );
+};
+
+
+var push = arr.push;
+
+var indexOf = arr.indexOf;
+
+var class2type = {};
+
+var toString = class2type.toString;
+
+var hasOwn = class2type.hasOwnProperty;
+
+var fnToString = hasOwn.toString;
+
+var ObjectFunctionString = fnToString.call( Object );
+
+var support = {};
+
+var isFunction = function isFunction( obj ) {
+
+		// Support: Chrome <=57, Firefox <=52
+		// In some browsers, typeof returns "function" for HTML  elements
+		// (i.e., `typeof document.createElement( "object" ) === "function"`).
+		// We don't want to classify *any* DOM node as a function.
+		// Support: QtWeb <=3.8.5, WebKit <=534.34, wkhtmltopdf tool <=0.12.5
+		// Plus for old WebKit, typeof returns "function" for HTML collections
+		// (e.g., `typeof document.getElementsByTagName("div") === "function"`). (gh-4756)
+		return typeof obj === "function" && typeof obj.nodeType !== "number" &&
+			typeof obj.item !== "function";
+	};
+
+
+var isWindow = function isWindow( obj ) {
+		return obj != null && obj === obj.window;
+	};
+
+
+var document = window.document;
+
+
+
+	var preservedScriptAttributes = {
+		type: true,
+		src: true,
+		nonce: true,
+		noModule: true
+	};
+
+	function DOMEval( code, node, doc ) {
+		doc = doc || document;
+
+		var i, val,
+			script = doc.createElement( "script" );
+
+		script.text = code;
+		if ( node ) {
+			for ( i in preservedScriptAttributes ) {
+
+				// Support: Firefox 64+, Edge 18+
+				// Some browsers don't support the "nonce" property on scripts.
+				// On the other hand, just using `getAttribute` is not enough as
+				// the `nonce` attribute is reset to an empty string whenever it
+				// becomes browsing-context connected.
+				// See https://github.com/whatwg/html/issues/2369
+				// See https://html.spec.whatwg.org/#nonce-attributes
+				// The `node.getAttribute` check was added for the sake of
+				// `jQuery.globalEval` so that it can fake a nonce-containing node
+				// via an object.
+				val = node[ i ] || node.getAttribute && node.getAttribute( i );
+				if ( val ) {
+					script.setAttribute( i, val );
+				}
+			}
+		}
+		doc.head.appendChild( script ).parentNode.removeChild( script );
+	}
+
+
+function toType( obj ) {
+	if ( obj == null ) {
+		return obj + "";
+	}
+
+	// Support: Android <=2.3 only (functionish RegExp)
+	return typeof obj === "object" || typeof obj === "function" ?
+		class2type[ toString.call( obj ) ] || "object" :
+		typeof obj;
+}
+/* global Symbol */
+// Defining this global in .eslintrc.json would create a danger of using the global
+// unguarded in another place, it seems safer to define global only for this module
+
+
+
+var
+	version = "3.6.0",
+
+	// Define a local copy of jQuery
+	jQuery = function( selector, context ) {
+
+		// The jQuery object is actually just the init constructor 'enhanced'
+		// Need init if jQuery is called (just allow error to be thrown if not included)
+		return new jQuery.fn.init( selector, context );
+	};
+
+jQuery.fn = jQuery.prototype = {
+
+	// The current version of jQuery being used
+	jquery: version,
+
+	constructor: jQuery,
+
+	// The default length of a jQuery object is 0
+	length: 0,
+
+	toArray: function() {
+		return slice.call( this );
+	},
+
+	// Get the Nth element in the matched element set OR
+	// Get the whole matched element set as a clean array
+	get: function( num ) {
+
+		// Return all the elements in a clean array
+		if ( num == null ) {
+			return slice.call( this );
+		}
+
+		// Return just the one element from the set
+		return num < 0 ? this[ num + this.length ] : this[ num ];
+	},
+
+	// Take an array of elements and push it onto the stack
+	// (returning the new matched element set)
+	pushStack: function( elems ) {
+
+		// Build a new jQuery matched element set
+		var ret = jQuery.merge( this.constructor(), elems );
+
+		// Add the old object onto the stack (as a reference)
+		ret.prevObject = this;
+
+		// Return the newly-formed element set
+		return ret;
+	},
+
+	// Execute a callback for every element in the matched set.
+	each: function( callback ) {
+		return jQuery.each( this, callback );
+	},
+
+	map: function( callback ) {
+		return this.pushStack( jQuery.map( this, function( elem, i ) {
+			return callback.call( elem, i, elem );
+		} ) );
+	},
+
+	slice: function() {
+		return this.pushStack( slice.apply( this, arguments ) );
+	},
+
+	first: function() {
+		return this.eq( 0 );
+	},
+
+	last: function() {
+		return this.eq( -1 );
+	},
+
+	even: function() {
+		return this.pushStack( jQuery.grep( this, function( _elem, i ) {
+			return ( i + 1 ) % 2;
+		} ) );
+	},
+
+	odd: function() {
+		return this.pushStack( jQuery.grep( this, function( _elem, i ) {
+			return i % 2;
+		} ) );
+	},
+
+	eq: function( i ) {
+		var len = this.length,
+			j = +i + ( i < 0 ? len : 0 );
+		return this.pushStack( j >= 0 && j < len ? [ this[ j ] ] : [] );
+	},
+
+	end: function() {
+		return this.prevObject || this.constructor();
+	},
+
+	// For internal use only.
+	// Behaves like an Array's method, not like a jQuery method.
+	push: push,
+	sort: arr.sort,
+	splice: arr.splice
+};
+
+jQuery.extend = jQuery.fn.extend = function() {
+	var options, name, src, copy, copyIsArray, clone,
+		target = arguments[ 0 ] || {},
+		i = 1,
+		length = arguments.length,
+		deep = false;
+
+	// Handle a deep copy situation
+	if ( typeof target === "boolean" ) {
+		deep = target;
+
+		// Skip the boolean and the target
+		target = arguments[ i ] || {};
+		i++;
+	}
+
+	// Handle case when target is a string or something (possible in deep copy)
+	if ( typeof target !== "object" && !isFunction( target ) ) {
+		target = {};
+	}
+
+	// Extend jQuery itself if only one argument is passed
+	if ( i === length ) {
+		target = this;
+		i--;
+	}
+
+	for ( ; i < length; i++ ) {
+
+		// Only deal with non-null/undefined values
+		if ( ( options = arguments[ i ] ) != null ) {
+
+			// Extend the base object
+			for ( name in options ) {
+				copy = options[ name ];
+
+				// Prevent Object.prototype pollution
+				// Prevent never-ending loop
+				if ( name === "__proto__" || target === copy ) {
+					continue;
+				}
+
+				// Recurse if we're merging plain objects or arrays
+				if ( deep && copy && ( jQuery.isPlainObject( copy ) ||
+					( copyIsArray = Array.isArray( copy ) ) ) ) {
+					src = target[ name ];
+
+					// Ensure proper type for the source value
+					if ( copyIsArray && !Array.isArray( src ) ) {
+						clone = [];
+					} else if ( !copyIsArray && !jQuery.isPlainObject( src ) ) {
+						clone = {};
+					} else {
+						clone = src;
+					}
+					copyIsArray = false;
+
+					// Never move original objects, clone them
+					target[ name ] = jQuery.extend( deep, clone, copy );
+
+				// Don't bring in undefined values
+				} else if ( copy !== undefined ) {
+					target[ name ] = copy;
+				}
+			}
+		}
+	}
+
+	// Return the modified object
+	return target;
+};
+
+jQuery.extend( {
+
+	// Unique for each copy of jQuery on the page
+	expando: "jQuery" + ( version + Math.random() ).replace( /\D/g, "" ),
+
+	// Assume jQuery is ready without the ready module
+	isReady: true,
+
+	error: function( msg ) {
+		throw new Error( msg );
+	},
+
+	noop: function() {},
+
+	isPlainObject: function( obj ) {
+		var proto, Ctor;
+
+		// Detect obvious negatives
+		// Use toString instead of jQuery.type to catch host objects
+		if ( !obj || toString.call( obj ) !== "[object Object]" ) {
+			return false;
+		}
+
+		proto = getProto( obj );
+
+		// Objects with no prototype (e.g., `Object.create( null )`) are plain
+		if ( !proto ) {
+			return true;
+		}
+
+		// Objects with prototype are plain iff they were constructed by a global Object function
+		Ctor = hasOwn.call( proto, "constructor" ) && proto.constructor;
+		return typeof Ctor === "function" && fnToString.call( Ctor ) === ObjectFunctionString;
+	},
+
+	isEmptyObject: function( obj ) {
+		var name;
+
+		for ( name in obj ) {
+			return false;
+		}
+		return true;
+	},
+
+	// Evaluates a script in a provided context; falls back to the global one
+	// if not specified.
+	globalEval: function( code, options, doc ) {
+		DOMEval( code, { nonce: options && options.nonce }, doc );
+	},
+
+	each: function( obj, callback ) {
+		var length, i = 0;
+
+		if ( isArrayLike( obj ) ) {
+			length = obj.length;
+			for ( ; i < length; i++ ) {
+				if ( callback.call( obj[ i ], i, obj[ i ] ) === false ) {
+					break;
+				}
+			}
+		} else {
+			for ( i in obj ) {
+				if ( callback.call( obj[ i ], i, obj[ i ] ) === false ) {
+					break;
+				}
+			}
+		}
+
+		return obj;
+	},
+
+	// results is for internal usage only
+	makeArray: function( arr, results ) {
+		var ret = results || [];
+
+		if ( arr != null ) {
+			if ( isArrayLike( Object( arr ) ) ) {
+				jQuery.merge( ret,
+					typeof arr === "string" ?
+						[ arr ] : arr
+				);
+			} else {
+				push.call( ret, arr );
+			}
+		}
+
+		return ret;
+	},
+
+	inArray: function( elem, arr, i ) {
+		return arr == null ? -1 : indexOf.call( arr, elem, i );
+	},
+
+	// Support: Android <=4.0 only, PhantomJS 1 only
+	// push.apply(_, arraylike) throws on ancient WebKit
+	merge: function( first, second ) {
+		var len = +second.length,
+			j = 0,
+			i = first.length;
+
+		for ( ; j < len; j++ ) {
+			first[ i++ ] = second[ j ];
+		}
+
+		first.length = i;
+
+		return first;
+	},
+
+	grep: function( elems, callback, invert ) {
+		var callbackInverse,
+			matches = [],
+			i = 0,
+			length = elems.length,
+			callbackExpect = !invert;
+
+		// Go through the array, only saving the items
+		// that pass the validator function
+		for ( ; i < length; i++ ) {
+			callbackInverse = !callback( elems[ i ], i );
+			if ( callbackInverse !== callbackExpect ) {
+				matches.push( elems[ i ] );
+			}
+		}
+
+		return matches;
+	},
+
+	// arg is for internal usage only
+	map: function( elems, callback, arg ) {
+		var length, value,
+			i = 0,
+			ret = [];
+
+		// Go through the array, translating each of the items to their new values
+		if ( isArrayLike( elems ) ) {
+			length = elems.length;
+			for ( ; i < length; i++ ) {
+				value = callback( elems[ i ], i, arg );
+
+				if ( value != null ) {
+					ret.push( value );
+				}
+			}
+
+		// Go through every key on the object,
+		} else {
+			for ( i in elems ) {
+				value = callback( elems[ i ], i, arg );
+
+				if ( value != null ) {
+					ret.push( value );
+				}
+			}
+		}
+
+		// Flatten any nested arrays
+		return flat( ret );
+	},
+
+	// A global GUID counter for objects
+	guid: 1,
+
+	// jQuery.support is not used in Core but other projects attach their
+	// properties to it so it needs to exist.
+	support: support
+} );
+
+if ( typeof Symbol === "function" ) {
+	jQuery.fn[ Symbol.iterator ] = arr[ Symbol.iterator ];
+}
+
+// Populate the class2type map
+jQuery.each( "Boolean Number String Function Array Date RegExp Object Error Symbol".split( " " ),
+	function( _i, name ) {
+		class2type[ "[object " + name + "]" ] = name.toLowerCase();
+	} );
+
+function isArrayLike( obj ) {
+
+	// Support: real iOS 8.2 only (not reproducible in simulator)
+	// `in` check used to prevent JIT error (gh-2145)
+	// hasOwn isn't used here due to false negatives
+	// regarding Nodelist length in IE
+	var length = !!obj && "length" in obj && obj.length,
+		type = toType( obj );
+
+	if ( isFunction( obj ) || isWindow( obj ) ) {
+		return false;
+	}
+
+	return type === "array" || length === 0 ||
+		typeof length === "number" && length > 0 && ( length - 1 ) in obj;
+}
+var Sizzle =
+/*!
+ * Sizzle CSS Selector Engine v2.3.6
+ * https://sizzlejs.com/
+ *
+ * Copyright JS Foundation and other contributors
+ * Released under the MIT license
+ * https://js.foundation/
+ *
+ * Date: 2021-02-16
+ */
+( function( window ) {
+var i,
+	support,
+	Expr,
+	getText,
+	isXML,
+	tokenize,
+	compile,
+	select,
+	outermostContext,
+	sortInput,
+	hasDuplicate,
+
+	// Local document vars
+	setDocument,
+	document,
+	docElem,
+	documentIsHTML,
+	rbuggyQSA,
+	rbuggyMatches,
+	matches,
+	contains,
+
+	// Instance-specific data
+	expando = "sizzle" + 1 * new Date(),
+	preferredDoc = window.document,
+	dirruns = 0,
+	done = 0,
+	classCache = createCache(),
+	tokenCache = createCache(),
+	compilerCache = createCache(),
+	nonnativeSelectorCache = createCache(),
+	sortOrder = function( a, b ) {
+		if ( a === b ) {
+			hasDuplicate = true;
+		}
+		return 0;
+	},
+
+	// Instance methods
+	hasOwn = ( {} ).hasOwnProperty,
+	arr = [],
+	pop = arr.pop,
+	pushNative = arr.push,
+	push = arr.push,
+	slice = arr.slice,
+
+	// Use a stripped-down indexOf as it's faster than native
+	// https://jsperf.com/thor-indexof-vs-for/5
+	indexOf = function( list, elem ) {
+		var i = 0,
+			len = list.length;
+		for ( ; i < len; i++ ) {
+			if ( list[ i ] === elem ) {
+				return i;
+			}
+		}
+		return -1;
+	},
+
+	booleans = "checked|selected|async|autofocus|autoplay|controls|defer|disabled|hidden|" +
+		"ismap|loop|multiple|open|readonly|required|scoped",
+
+	// Regular expressions
+
+	// http://www.w3.org/TR/css3-selectors/#whitespace
+	whitespace = "[\\x20\\t\\r\\n\\f]",
+
+	// https://www.w3.org/TR/css-syntax-3/#ident-token-diagram
+	identifier = "(?:\\\\[\\da-fA-F]{1,6}" + whitespace +
+		"?|\\\\[^\\r\\n\\f]|[\\w-]|[^\0-\\x7f])+",
+
+	// Attribute selectors: http://www.w3.org/TR/selectors/#attribute-selectors
+	attributes = "\\[" + whitespace + "*(" + identifier + ")(?:" + whitespace +
+
+		// Operator (capture 2)
+		"*([*^$|!~]?=)" + whitespace +
+
+		// "Attribute values must be CSS identifiers [capture 5]
+		// or strings [capture 3 or capture 4]"
+		"*(?:'((?:\\\\.|[^\\\\'])*)'|\"((?:\\\\.|[^\\\\\"])*)\"|(" + identifier + "))|)" +
+		whitespace + "*\\]",
+
+	pseudos = ":(" + identifier + ")(?:\\((" +
+
+		// To reduce the number of selectors needing tokenize in the preFilter, prefer arguments:
+		// 1. quoted (capture 3; capture 4 or capture 5)
+		"('((?:\\\\.|[^\\\\'])*)'|\"((?:\\\\.|[^\\\\\"])*)\")|" +
+
+		// 2. simple (capture 6)
+		"((?:\\\\.|[^\\\\()[\\]]|" + attributes + ")*)|" +
+
+		// 3. anything else (capture 2)
+		".*" +
+		")\\)|)",
+
+	// Leading and non-escaped trailing whitespace, capturing some non-whitespace characters preceding the latter
+	rwhitespace = new RegExp( whitespace + "+", "g" ),
+	rtrim = new RegExp( "^" + whitespace + "+|((?:^|[^\\\\])(?:\\\\.)*)" +
+		whitespace + "+$", "g" ),
+
+	rcomma = new RegExp( "^" + whitespace + "*," + whitespace + "*" ),
+	rcombinators = new RegExp( "^" + whitespace + "*([>+~]|" + whitespace + ")" + whitespace +
+		"*" ),
+	rdescend = new RegExp( whitespace + "|>" ),
+
+	rpseudo = new RegExp( pseudos ),
+	ridentifier = new RegExp( "^" + identifier + "$" ),
+
+	matchExpr = {
+		"ID": new RegExp( "^#(" + identifier + ")" ),
+		"CLASS": new RegExp( "^\\.(" + identifier + ")" ),
+		"TAG": new RegExp( "^(" + identifier + "|[*])" ),
+		"ATTR": new RegExp( "^" + attributes ),
+		"PSEUDO": new RegExp( "^" + pseudos ),
+		"CHILD": new RegExp( "^:(only|first|last|nth|nth-last)-(child|of-type)(?:\\(" +
+			whitespace + "*(even|odd|(([+-]|)(\\d*)n|)" + whitespace + "*(?:([+-]|)" +
+			whitespace + "*(\\d+)|))" + whitespace + "*\\)|)", "i" ),
+		"bool": new RegExp( "^(?:" + booleans + ")$", "i" ),
+
+		// For use in libraries implementing .is()
+		// We use this for POS matching in `select`
+		"needsContext": new RegExp( "^" + whitespace +
+			"*[>+~]|:(even|odd|eq|gt|lt|nth|first|last)(?:\\(" + whitespace +
+			"*((?:-\\d)?\\d*)" + whitespace + "*\\)|)(?=[^-]|$)", "i" )
+	},
+
+	rhtml = /HTML$/i,
+	rinputs = /^(?:input|select|textarea|button)$/i,
+	rheader = /^h\d$/i,
+
+	rnative = /^[^{]+\{\s*\[native \w/,
+
+	// Easily-parseable/retrievable ID or TAG or CLASS selectors
+	rquickExpr = /^(?:#([\w-]+)|(\w+)|\.([\w-]+))$/,
+
+	rsibling = /[+~]/,
+
+	// CSS escapes
+	// http://www.w3.org/TR/CSS21/syndata.html#escaped-characters
+	runescape = new RegExp( "\\\\[\\da-fA-F]{1,6}" + whitespace + "?|\\\\([^\\r\\n\\f])", "g" ),
+	funescape = function( escape, nonHex ) {
+		var high = "0x" + escape.slice( 1 ) - 0x10000;
+
+		return nonHex ?
+
+			// Strip the backslash prefix from a non-hex escape sequence
+			nonHex :
+
+			// Replace a hexadecimal escape sequence with the encoded Unicode code point
+			// Support: IE <=11+
+			// For values outside the Basic Multilingual Plane (BMP), manually construct a
+			// surrogate pair
+			high < 0 ?
+				String.fromCharCode( high + 0x10000 ) :
+				String.fromCharCode( high >> 10 | 0xD800, high & 0x3FF | 0xDC00 );
+	},
+
+	// CSS string/identifier serialization
+	// https://drafts.csswg.org/cssom/#common-serializing-idioms
+	rcssescape = /([\0-\x1f\x7f]|^-?\d)|^-$|[^\0-\x1f\x7f-\uFFFF\w-]/g,
+	fcssescape = function( ch, asCodePoint ) {
+		if ( asCodePoint ) {
+
+			// U+0000 NULL becomes U+FFFD REPLACEMENT CHARACTER
+			if ( ch === "\0" ) {
+				return "\uFFFD";
+			}
+
+			// Control characters and (dependent upon position) numbers get escaped as code points
+			return ch.slice( 0, -1 ) + "\\" +
+				ch.charCodeAt( ch.length - 1 ).toString( 16 ) + " ";
+		}
+
+		// Other potentially-special ASCII characters get backslash-escaped
+		return "\\" + ch;
+	},
+
+	// Used for iframes
+	// See setDocument()
+	// Removing the function wrapper causes a "Permission Denied"
+	// error in IE
+	unloadHandler = function() {
+		setDocument();
+	},
+
+	inDisabledFieldset = addCombinator(
+		function( elem ) {
+			return elem.disabled === true && elem.nodeName.toLowerCase() === "fieldset";
+		},
+		{ dir: "parentNode", next: "legend" }
+	);
+
+// Optimize for push.apply( _, NodeList )
+try {
+	push.apply(
+		( arr = slice.call( preferredDoc.childNodes ) ),
+		preferredDoc.childNodes
+	);
+
+	// Support: Android<4.0
+	// Detect silently failing push.apply
+	// eslint-disable-next-line no-unused-expressions
+	arr[ preferredDoc.childNodes.length ].nodeType;
+} catch ( e ) {
+	push = { apply: arr.length ?
+
+		// Leverage slice if possible
+		function( target, els ) {
+			pushNative.apply( target, slice.call( els ) );
+		} :
+
+		// Support: IE<9
+		// Otherwise append directly
+		function( target, els ) {
+			var j = target.length,
+				i = 0;
+
+			// Can't trust NodeList.length
+			while ( ( target[ j++ ] = els[ i++ ] ) ) {}
+			target.length = j - 1;
+		}
+	};
+}
+
+function Sizzle( selector, context, results, seed ) {
+	var m, i, elem, nid, match, groups, newSelector,
+		newContext = context && context.ownerDocument,
+
+		// nodeType defaults to 9, since context defaults to document
+		nodeType = context ? context.nodeType : 9;
+
+	results = results || [];
+
+	// Return early from calls with invalid selector or context
+	if ( typeof selector !== "string" || !selector ||
+		nodeType !== 1 && nodeType !== 9 && nodeType !== 11 ) {
+
+		return results;
+	}
+
+	// Try to shortcut find operations (as opposed to filters) in HTML documents
+	if ( !seed ) {
+		setDocument( context );
+		context = context || document;
+
+		if ( documentIsHTML ) {
+
+			// If the selector is sufficiently simple, try using a "get*By*" DOM method
+			// (excepting DocumentFragment context, where the methods don't exist)
+			if ( nodeType !== 11 && ( match = rquickExpr.exec( selector ) ) ) {
+
+				// ID selector
+				if ( ( m = match[ 1 ] ) ) {
+
+					// Document context
+					if ( nodeType === 9 ) {
+						if ( ( elem = context.getElementById( m ) ) ) {
+
+							// Support: IE, Opera, Webkit
+							// TODO: identify versions
+							// getElementById can match elements by name instead of ID
+							if ( elem.id === m ) {
+								results.push( elem );
+								return results;
+							}
+						} else {
+							return results;
+						}
+
+					// Element context
+					} else {
+
+						// Support: IE, Opera, Webkit
+						// TODO: identify versions
+						// getElementById can match elements by name instead of ID
+						if ( newContext && ( elem = newContext.getElementById( m ) ) &&
+							contains( context, elem ) &&
+							elem.id === m ) {
+
+							results.push( elem );
+							return results;
+						}
+					}
+
+				// Type selector
+				} else if ( match[ 2 ] ) {
+					push.apply( results, context.getElementsByTagName( selector ) );
+					return results;
+
+				// Class selector
+				} else if ( ( m = match[ 3 ] ) && support.getElementsByClassName &&
+					context.getElementsByClassName ) {
+
+					push.apply( results, context.getElementsByClassName( m ) );
+					return results;
+				}
+			}
+
+			// Take advantage of querySelectorAll
+			if ( support.qsa &&
+				!nonnativeSelectorCache[ selector + " " ] &&
+				( !rbuggyQSA || !rbuggyQSA.test( selector ) ) &&
+
+				// Support: IE 8 only
+				// Exclude object elements
+				( nodeType !== 1 || context.nodeName.toLowerCase() !== "object" ) ) {
+
+				newSelector = selector;
+				newContext = context;
+
+				// qSA considers elements outside a scoping root when evaluating child or
+				// descendant combinators, which is not what we want.
+				// In such cases, we work around the behavior by prefixing every selector in the
+				// list with an ID selector referencing the scope context.
+				// The technique has to be used as well when a leading combinator is used
+				// as such selectors are not recognized by querySelectorAll.
+				// Thanks to Andrew Dupont for this technique.
+				if ( nodeType === 1 &&
+					( rdescend.test( selector ) || rcombinators.test( selector ) ) ) {
+
+					// Expand context for sibling selectors
+					newContext = rsibling.test( selector ) && testContext( context.parentNode ) ||
+						context;
+
+					// We can use :scope instead of the ID hack if the browser
+					// supports it & if we're not changing the context.
+					if ( newContext !== context || !support.scope ) {
+
+						// Capture the context ID, setting it first if necessary
+						if ( ( nid = context.getAttribute( "id" ) ) ) {
+							nid = nid.replace( rcssescape, fcssescape );
+						} else {
+							context.setAttribute( "id", ( nid = expando ) );
+						}
+					}
+
+					// Prefix every selector in the list
+					groups = tokenize( selector );
+					i = groups.length;
+					while ( i-- ) {
+						groups[ i ] = ( nid ? "#" + nid : ":scope" ) + " " +
+							toSelector( groups[ i ] );
+					}
+					newSelector = groups.join( "," );
+				}
+
+				try {
+					push.apply( results,
+						newContext.querySelectorAll( newSelector )
+					);
+					return results;
+				} catch ( qsaError ) {
+					nonnativeSelectorCache( selector, true );
+				} finally {
+					if ( nid === expando ) {
+						context.removeAttribute( "id" );
+					}
+				}
+			}
+		}
+	}
+
+	// All others
+	return select( selector.replace( rtrim, "$1" ), context, results, seed );
+}
+
+/**
+ * Create key-value caches of limited size
+ * @returns {function(string, object)} Returns the Object data after storing it on itself with
+ *	property name the (space-suffixed) string and (if the cache is larger than Expr.cacheLength)
+ *	deleting the oldest entry
+ */
+function createCache() {
+	var keys = [];
+
+	function cache( key, value ) {
+
+		// Use (key + " ") to avoid collision with native prototype properties (see Issue #157)
+		if ( keys.push( key + " " ) > Expr.cacheLength ) {
+
+			// Only keep the most recent entries
+			delete cache[ keys.shift() ];
+		}
+		return ( cache[ key + " " ] = value );
+	}
+	return cache;
+}
+
+/**
+ * Mark a function for special use by Sizzle
+ * @param {Function} fn The function to mark
+ */
+function markFunction( fn ) {
+	fn[ expando ] = true;
+	return fn;
+}
+
+/**
+ * Support testing using an element
+ * @param {Function} fn Passed the created element and returns a boolean result
+ */
+function assert( fn ) {
+	var el = document.createElement( "fieldset" );
+
+	try {
+		return !!fn( el );
+	} catch ( e ) {
+		return false;
+	} finally {
+
+		// Remove from its parent by default
+		if ( el.parentNode ) {
+			el.parentNode.removeChild( el );
+		}
+
+		// release memory in IE
+		el = null;
+	}
+}
+
+/**
+ * Adds the same handler for all of the specified attrs
+ * @param {String} attrs Pipe-separated list of attributes
+ * @param {Function} handler The method that will be applied
+ */
+function addHandle( attrs, handler ) {
+	var arr = attrs.split( "|" ),
+		i = arr.length;
+
+	while ( i-- ) {
+		Expr.attrHandle[ arr[ i ] ] = handler;
+	}
+}
+
+/**
+ * Checks document order of two siblings
+ * @param {Element} a
+ * @param {Element} b
+ * @returns {Number} Returns less than 0 if a precedes b, greater than 0 if a follows b
+ */
+function siblingCheck( a, b ) {
+	var cur = b && a,
+		diff = cur && a.nodeType === 1 && b.nodeType === 1 &&
+			a.sourceIndex - b.sourceIndex;
+
+	// Use IE sourceIndex if available on both nodes
+	if ( diff ) {
+		return diff;
+	}
+
+	// Check if b follows a
+	if ( cur ) {
+		while ( ( cur = cur.nextSibling ) ) {
+			if ( cur === b ) {
+				return -1;
+			}
+		}
+	}
+
+	return a ? 1 : -1;
+}
+
+/**
+ * Returns a function to use in pseudos for input types
+ * @param {String} type
+ */
+function createInputPseudo( type ) {
+	return function( elem ) {
+		var name = elem.nodeName.toLowerCase();
+		return name === "input" && elem.type === type;
+	};
+}
+
+/**
+ * Returns a function to use in pseudos for buttons
+ * @param {String} type
+ */
+function createButtonPseudo( type ) {
+	return function( elem ) {
+		var name = elem.nodeName.toLowerCase();
+		return ( name === "input" || name === "button" ) && elem.type === type;
+	};
+}
+
+/**
+ * Returns a function to use in pseudos for :enabled/:disabled
+ * @param {Boolean} disabled true for :disabled; false for :enabled
+ */
+function createDisabledPseudo( disabled ) {
+
+	// Known :disabled false positives: fieldset[disabled] > legend:nth-of-type(n+2) :can-disable
+	return function( elem ) {
+
+		// Only certain elements can match :enabled or :disabled
+		// https://html.spec.whatwg.org/multipage/scripting.html#selector-enabled
+		// https://html.spec.whatwg.org/multipage/scripting.html#selector-disabled
+		if ( "form" in elem ) {
+
+			// Check for inherited disabledness on relevant non-disabled elements:
+			// * listed form-associated elements in a disabled fieldset
+			//   https://html.spec.whatwg.org/multipage/forms.html#category-listed
+			//   https://html.spec.whatwg.org/multipage/forms.html#concept-fe-disabled
+			// * option elements in a disabled optgroup
+			//   https://html.spec.whatwg.org/multipage/forms.html#concept-option-disabled
+			// All such elements have a "form" property.
+			if ( elem.parentNode && elem.disabled === false ) {
+
+				// Option elements defer to a parent optgroup if present
+				if ( "label" in elem ) {
+					if ( "label" in elem.parentNode ) {
+						return elem.parentNode.disabled === disabled;
+					} else {
+						return elem.disabled === disabled;
+					}
+				}
+
+				// Support: IE 6 - 11
+				// Use the isDisabled shortcut property to check for disabled fieldset ancestors
+				return elem.isDisabled === disabled ||
+
+					// Where there is no isDisabled, check manually
+					/* jshint -W018 */
+					elem.isDisabled !== !disabled &&
+					inDisabledFieldset( elem ) === disabled;
+			}
+
+			return elem.disabled === disabled;
+
+		// Try to winnow out elements that can't be disabled before trusting the disabled property.
+		// Some victims get caught in our net (label, legend, menu, track), but it shouldn't
+		// even exist on them, let alone have a boolean value.
+		} else if ( "label" in elem ) {
+			return elem.disabled === disabled;
+		}
+
+		// Remaining elements are neither :enabled nor :disabled
+		return false;
+	};
+}
+
+/**
+ * Returns a function to use in pseudos for positionals
+ * @param {Function} fn
+ */
+function createPositionalPseudo( fn ) {
+	return markFunction( function( argument ) {
+		argument = +argument;
+		return markFunction( function( seed, matches ) {
+			var j,
+				matchIndexes = fn( [], seed.length, argument ),
+				i = matchIndexes.length;
+
+			// Match elements found at the specified indexes
+			while ( i-- ) {
+				if ( seed[ ( j = matchIndexes[ i ] ) ] ) {
+					seed[ j ] = !( matches[ j ] = seed[ j ] );
+				}
+			}
+		} );
+	} );
+}
+
+/**
+ * Checks a node for validity as a Sizzle context
+ * @param {Element|Object=} context
+ * @returns {Element|Object|Boolean} The input node if acceptable, otherwise a falsy value
+ */
+function testContext( context ) {
+	return context && typeof context.getElementsByTagName !== "undefined" && context;
+}
+
+// Expose support vars for convenience
+support = Sizzle.support = {};
+
+/**
+ * Detects XML nodes
+ * @param {Element|Object} elem An element or a document
+ * @returns {Boolean} True iff elem is a non-HTML XML node
+ */
+isXML = Sizzle.isXML = function( elem ) {
+	var namespace = elem && elem.namespaceURI,
+		docElem = elem && ( elem.ownerDocument || elem ).documentElement;
+
+	// Support: IE <=8
+	// Assume HTML when documentElement doesn't yet exist, such as inside loading iframes
+	// https://bugs.jquery.com/ticket/4833
+	return !rhtml.test( namespace || docElem && docElem.nodeName || "HTML" );
+};
+
+/**
+ * Sets document-related variables once based on the current document
+ * @param {Element|Object} [doc] An element or document object to use to set the document
+ * @returns {Object} Returns the current document
+ */
+setDocument = Sizzle.setDocument = function( node ) {
+	var hasCompare, subWindow,
+		doc = node ? node.ownerDocument || node : preferredDoc;
+
+	// Return early if doc is invalid or already selected
+	// Support: IE 11+, Edge 17 - 18+
+	// IE/Edge sometimes throw a "Permission denied" error when strict-comparing
+	// two documents; shallow comparisons work.
+	// eslint-disable-next-line eqeqeq
+	if ( doc == document || doc.nodeType !== 9 || !doc.documentElement ) {
+		return document;
+	}
+
+	// Update global variables
+	document = doc;
+	docElem = document.documentElement;
+	documentIsHTML = !isXML( document );
+
+	// Support: IE 9 - 11+, Edge 12 - 18+
+	// Accessing iframe documents after unload throws "permission denied" errors (jQuery #13936)
+	// Support: IE 11+, Edge 17 - 18+
+	// IE/Edge sometimes throw a "Permission denied" error when strict-comparing
+	// two documents; shallow comparisons work.
+	// eslint-disable-next-line eqeqeq
+	if ( preferredDoc != document &&
+		( subWindow = document.defaultView ) && subWindow.top !== subWindow ) {
+
+		// Support: IE 11, Edge
+		if ( subWindow.addEventListener ) {
+			subWindow.addEventListener( "unload", unloadHandler, false );
+
+		// Support: IE 9 - 10 only
+		} else if ( subWindow.attachEvent ) {
+			subWindow.attachEvent( "onunload", unloadHandler );
+		}
+	}
+
+	// Support: IE 8 - 11+, Edge 12 - 18+, Chrome <=16 - 25 only, Firefox <=3.6 - 31 only,
+	// Safari 4 - 5 only, Opera <=11.6 - 12.x only
+	// IE/Edge & older browsers don't support the :scope pseudo-class.
+	// Support: Safari 6.0 only
+	// Safari 6.0 supports :scope but it's an alias of :root there.
+	support.scope = assert( function( el ) {
+		docElem.appendChild( el ).appendChild( document.createElement( "div" ) );
+		return typeof el.querySelectorAll !== "undefined" &&
+			!el.querySelectorAll( ":scope fieldset div" ).length;
+	} );
+
+	/* Attributes
+	---------------------------------------------------------------------- */
+
+	// Support: IE<8
+	// Verify that getAttribute really returns attributes and not properties
+	// (excepting IE8 booleans)
+	support.attributes = assert( function( el ) {
+		el.className = "i";
+		return !el.getAttribute( "className" );
+	} );
+
+	/* getElement(s)By*
+	---------------------------------------------------------------------- */
+
+	// Check if getElementsByTagName("*") returns only elements
+	support.getElementsByTagName = assert( function( el ) {
+		el.appendChild( document.createComment( "" ) );
+		return !el.getElementsByTagName( "*" ).length;
+	} );
+
+	// Support: IE<9
+	support.getElementsByClassName = rnative.test( document.getElementsByClassName );
+
+	// Support: IE<10
+	// Check if getElementById returns elements by name
+	// The broken getElementById methods don't pick up programmatically-set names,
+	// so use a roundabout getElementsByName test
+	support.getById = assert( function( el ) {
+		docElem.appendChild( el ).id = expando;
+		return !document.getElementsByName || !document.getElementsByName( expando ).length;
+	} );
+
+	// ID filter and find
+	if ( support.getById ) {
+		Expr.filter[ "ID" ] = function( id ) {
+			var attrId = id.replace( runescape, funescape );
+			return function( elem ) {
+				return elem.getAttribute( "id" ) === attrId;
+			};
+		};
+		Expr.find[ "ID" ] = function( id, context ) {
+			if ( typeof context.getElementById !== "undefined" && documentIsHTML ) {
+				var elem = context.getElementById( id );
+				return elem ? [ elem ] : [];
+			}
+		};
+	} else {
+		Expr.filter[ "ID" ] =  function( id ) {
+			var attrId = id.replace( runescape, funescape );
+			return function( elem ) {
+				var node = typeof elem.getAttributeNode !== "undefined" &&
+					elem.getAttributeNode( "id" );
+				return node && node.value === attrId;
+			};
+		};
+
+		// Support: IE 6 - 7 only
+		// getElementById is not reliable as a find shortcut
+		Expr.find[ "ID" ] = function( id, context ) {
+			if ( typeof context.getElementById !== "undefined" && documentIsHTML ) {
+				var node, i, elems,
+					elem = context.getElementById( id );
+
+				if ( elem ) {
+
+					// Verify the id attribute
+					node = elem.getAttributeNode( "id" );
+					if ( node && node.value === id ) {
+						return [ elem ];
+					}
+
+					// Fall back on getElementsByName
+					elems = context.getElementsByName( id );
+					i = 0;
+					while ( ( elem = elems[ i++ ] ) ) {
+						node = elem.getAttributeNode( "id" );
+						if ( node && node.value === id ) {
+							return [ elem ];
+						}
+					}
+				}
+
+				return [];
+			}
+		};
+	}
+
+	// Tag
+	Expr.find[ "TAG" ] = support.getElementsByTagName ?
+		function( tag, context ) {
+			if ( typeof context.getElementsByTagName !== "undefined" ) {
+				return context.getElementsByTagName( tag );
+
+			// DocumentFragment nodes don't have gEBTN
+			} else if ( support.qsa ) {
+				return context.querySelectorAll( tag );
+			}
+		} :
+
+		function( tag, context ) {
+			var elem,
+				tmp = [],
+				i = 0,
+
+				// By happy coincidence, a (broken) gEBTN appears on DocumentFragment nodes too
+				results = context.getElementsByTagName( tag );
+
+			// Filter out possible comments
+			if ( tag === "*" ) {
+				while ( ( elem = results[ i++ ] ) ) {
+					if ( elem.nodeType === 1 ) {
+						tmp.push( elem );
+					}
+				}
+
+				return tmp;
+			}
+			return results;
+		};
+
+	// Class
+	Expr.find[ "CLASS" ] = support.getElementsByClassName && function( className, context ) {
+		if ( typeof context.getElementsByClassName !== "undefined" && documentIsHTML ) {
+			return context.getElementsByClassName( className );
+		}
+	};
+
+	/* QSA/matchesSelector
+	---------------------------------------------------------------------- */
+
+	// QSA and matchesSelector support
+
+	// matchesSelector(:active) reports false when true (IE9/Opera 11.5)
+	rbuggyMatches = [];
+
+	// qSa(:focus) reports false when true (Chrome 21)
+	// We allow this because of a bug in IE8/9 that throws an error
+	// whenever `document.activeElement` is accessed on an iframe
+	// So, we allow :focus to pass through QSA all the time to avoid the IE error
+	// See https://bugs.jquery.com/ticket/13378
+	rbuggyQSA = [];
+
+	if ( ( support.qsa = rnative.test( document.querySelectorAll ) ) ) {
+
+		// Build QSA regex
+		// Regex strategy adopted from Diego Perini
+		assert( function( el ) {
+
+			var input;
+
+			// Select is set to empty string on purpose
+			// This is to test IE's treatment of not explicitly
+			// setting a boolean content attribute,
+			// since its presence should be enough
+			// https://bugs.jquery.com/ticket/12359
+			docElem.appendChild( el ).innerHTML = "" +
+				"";
+
+			// Support: IE8, Opera 11-12.16
+			// Nothing should be selected when empty strings follow ^= or $= or *=
+			// The test attribute must be unknown in Opera but "safe" for WinRT
+			// https://msdn.microsoft.com/en-us/library/ie/hh465388.aspx#attribute_section
+			if ( el.querySelectorAll( "[msallowcapture^='']" ).length ) {
+				rbuggyQSA.push( "[*^$]=" + whitespace + "*(?:''|\"\")" );
+			}
+
+			// Support: IE8
+			// Boolean attributes and "value" are not treated correctly
+			if ( !el.querySelectorAll( "[selected]" ).length ) {
+				rbuggyQSA.push( "\\[" + whitespace + "*(?:value|" + booleans + ")" );
+			}
+
+			// Support: Chrome<29, Android<4.4, Safari<7.0+, iOS<7.0+, PhantomJS<1.9.8+
+			if ( !el.querySelectorAll( "[id~=" + expando + "-]" ).length ) {
+				rbuggyQSA.push( "~=" );
+			}
+
+			// Support: IE 11+, Edge 15 - 18+
+			// IE 11/Edge don't find elements on a `[name='']` query in some cases.
+			// Adding a temporary attribute to the document before the selection works
+			// around the issue.
+			// Interestingly, IE 10 & older don't seem to have the issue.
+			input = document.createElement( "input" );
+			input.setAttribute( "name", "" );
+			el.appendChild( input );
+			if ( !el.querySelectorAll( "[name='']" ).length ) {
+				rbuggyQSA.push( "\\[" + whitespace + "*name" + whitespace + "*=" +
+					whitespace + "*(?:''|\"\")" );
+			}
+
+			// Webkit/Opera - :checked should return selected option elements
+			// http://www.w3.org/TR/2011/REC-css3-selectors-20110929/#checked
+			// IE8 throws error here and will not see later tests
+			if ( !el.querySelectorAll( ":checked" ).length ) {
+				rbuggyQSA.push( ":checked" );
+			}
+
+			// Support: Safari 8+, iOS 8+
+			// https://bugs.webkit.org/show_bug.cgi?id=136851
+			// In-page `selector#id sibling-combinator selector` fails
+			if ( !el.querySelectorAll( "a#" + expando + "+*" ).length ) {
+				rbuggyQSA.push( ".#.+[+~]" );
+			}
+
+			// Support: Firefox <=3.6 - 5 only
+			// Old Firefox doesn't throw on a badly-escaped identifier.
+			el.querySelectorAll( "\\\f" );
+			rbuggyQSA.push( "[\\r\\n\\f]" );
+		} );
+
+		assert( function( el ) {
+			el.innerHTML = "" +
+				"";
+
+			// Support: Windows 8 Native Apps
+			// The type and name attributes are restricted during .innerHTML assignment
+			var input = document.createElement( "input" );
+			input.setAttribute( "type", "hidden" );
+			el.appendChild( input ).setAttribute( "name", "D" );
+
+			// Support: IE8
+			// Enforce case-sensitivity of name attribute
+			if ( el.querySelectorAll( "[name=d]" ).length ) {
+				rbuggyQSA.push( "name" + whitespace + "*[*^$|!~]?=" );
+			}
+
+			// FF 3.5 - :enabled/:disabled and hidden elements (hidden elements are still enabled)
+			// IE8 throws error here and will not see later tests
+			if ( el.querySelectorAll( ":enabled" ).length !== 2 ) {
+				rbuggyQSA.push( ":enabled", ":disabled" );
+			}
+
+			// Support: IE9-11+
+			// IE's :disabled selector does not pick up the children of disabled fieldsets
+			docElem.appendChild( el ).disabled = true;
+			if ( el.querySelectorAll( ":disabled" ).length !== 2 ) {
+				rbuggyQSA.push( ":enabled", ":disabled" );
+			}
+
+			// Support: Opera 10 - 11 only
+			// Opera 10-11 does not throw on post-comma invalid pseudos
+			el.querySelectorAll( "*,:x" );
+			rbuggyQSA.push( ",.*:" );
+		} );
+	}
+
+	if ( ( support.matchesSelector = rnative.test( ( matches = docElem.matches ||
+		docElem.webkitMatchesSelector ||
+		docElem.mozMatchesSelector ||
+		docElem.oMatchesSelector ||
+		docElem.msMatchesSelector ) ) ) ) {
+
+		assert( function( el ) {
+
+			// Check to see if it's possible to do matchesSelector
+			// on a disconnected node (IE 9)
+			support.disconnectedMatch = matches.call( el, "*" );
+
+			// This should fail with an exception
+			// Gecko does not error, returns false instead
+			matches.call( el, "[s!='']:x" );
+			rbuggyMatches.push( "!=", pseudos );
+		} );
+	}
+
+	rbuggyQSA = rbuggyQSA.length && new RegExp( rbuggyQSA.join( "|" ) );
+	rbuggyMatches = rbuggyMatches.length && new RegExp( rbuggyMatches.join( "|" ) );
+
+	/* Contains
+	---------------------------------------------------------------------- */
+	hasCompare = rnative.test( docElem.compareDocumentPosition );
+
+	// Element contains another
+	// Purposefully self-exclusive
+	// As in, an element does not contain itself
+	contains = hasCompare || rnative.test( docElem.contains ) ?
+		function( a, b ) {
+			var adown = a.nodeType === 9 ? a.documentElement : a,
+				bup = b && b.parentNode;
+			return a === bup || !!( bup && bup.nodeType === 1 && (
+				adown.contains ?
+					adown.contains( bup ) :
+					a.compareDocumentPosition && a.compareDocumentPosition( bup ) & 16
+			) );
+		} :
+		function( a, b ) {
+			if ( b ) {
+				while ( ( b = b.parentNode ) ) {
+					if ( b === a ) {
+						return true;
+					}
+				}
+			}
+			return false;
+		};
+
+	/* Sorting
+	---------------------------------------------------------------------- */
+
+	// Document order sorting
+	sortOrder = hasCompare ?
+	function( a, b ) {
+
+		// Flag for duplicate removal
+		if ( a === b ) {
+			hasDuplicate = true;
+			return 0;
+		}
+
+		// Sort on method existence if only one input has compareDocumentPosition
+		var compare = !a.compareDocumentPosition - !b.compareDocumentPosition;
+		if ( compare ) {
+			return compare;
+		}
+
+		// Calculate position if both inputs belong to the same document
+		// Support: IE 11+, Edge 17 - 18+
+		// IE/Edge sometimes throw a "Permission denied" error when strict-comparing
+		// two documents; shallow comparisons work.
+		// eslint-disable-next-line eqeqeq
+		compare = ( a.ownerDocument || a ) == ( b.ownerDocument || b ) ?
+			a.compareDocumentPosition( b ) :
+
+			// Otherwise we know they are disconnected
+			1;
+
+		// Disconnected nodes
+		if ( compare & 1 ||
+			( !support.sortDetached && b.compareDocumentPosition( a ) === compare ) ) {
+
+			// Choose the first element that is related to our preferred document
+			// Support: IE 11+, Edge 17 - 18+
+			// IE/Edge sometimes throw a "Permission denied" error when strict-comparing
+			// two documents; shallow comparisons work.
+			// eslint-disable-next-line eqeqeq
+			if ( a == document || a.ownerDocument == preferredDoc &&
+				contains( preferredDoc, a ) ) {
+				return -1;
+			}
+
+			// Support: IE 11+, Edge 17 - 18+
+			// IE/Edge sometimes throw a "Permission denied" error when strict-comparing
+			// two documents; shallow comparisons work.
+			// eslint-disable-next-line eqeqeq
+			if ( b == document || b.ownerDocument == preferredDoc &&
+				contains( preferredDoc, b ) ) {
+				return 1;
+			}
+
+			// Maintain original order
+			return sortInput ?
+				( indexOf( sortInput, a ) - indexOf( sortInput, b ) ) :
+				0;
+		}
+
+		return compare & 4 ? -1 : 1;
+	} :
+	function( a, b ) {
+
+		// Exit early if the nodes are identical
+		if ( a === b ) {
+			hasDuplicate = true;
+			return 0;
+		}
+
+		var cur,
+			i = 0,
+			aup = a.parentNode,
+			bup = b.parentNode,
+			ap = [ a ],
+			bp = [ b ];
+
+		// Parentless nodes are either documents or disconnected
+		if ( !aup || !bup ) {
+
+			// Support: IE 11+, Edge 17 - 18+
+			// IE/Edge sometimes throw a "Permission denied" error when strict-comparing
+			// two documents; shallow comparisons work.
+			/* eslint-disable eqeqeq */
+			return a == document ? -1 :
+				b == document ? 1 :
+				/* eslint-enable eqeqeq */
+				aup ? -1 :
+				bup ? 1 :
+				sortInput ?
+				( indexOf( sortInput, a ) - indexOf( sortInput, b ) ) :
+				0;
+
+		// If the nodes are siblings, we can do a quick check
+		} else if ( aup === bup ) {
+			return siblingCheck( a, b );
+		}
+
+		// Otherwise we need full lists of their ancestors for comparison
+		cur = a;
+		while ( ( cur = cur.parentNode ) ) {
+			ap.unshift( cur );
+		}
+		cur = b;
+		while ( ( cur = cur.parentNode ) ) {
+			bp.unshift( cur );
+		}
+
+		// Walk down the tree looking for a discrepancy
+		while ( ap[ i ] === bp[ i ] ) {
+			i++;
+		}
+
+		return i ?
+
+			// Do a sibling check if the nodes have a common ancestor
+			siblingCheck( ap[ i ], bp[ i ] ) :
+
+			// Otherwise nodes in our document sort first
+			// Support: IE 11+, Edge 17 - 18+
+			// IE/Edge sometimes throw a "Permission denied" error when strict-comparing
+			// two documents; shallow comparisons work.
+			/* eslint-disable eqeqeq */
+			ap[ i ] == preferredDoc ? -1 :
+			bp[ i ] == preferredDoc ? 1 :
+			/* eslint-enable eqeqeq */
+			0;
+	};
+
+	return document;
+};
+
+Sizzle.matches = function( expr, elements ) {
+	return Sizzle( expr, null, null, elements );
+};
+
+Sizzle.matchesSelector = function( elem, expr ) {
+	setDocument( elem );
+
+	if ( support.matchesSelector && documentIsHTML &&
+		!nonnativeSelectorCache[ expr + " " ] &&
+		( !rbuggyMatches || !rbuggyMatches.test( expr ) ) &&
+		( !rbuggyQSA     || !rbuggyQSA.test( expr ) ) ) {
+
+		try {
+			var ret = matches.call( elem, expr );
+
+			// IE 9's matchesSelector returns false on disconnected nodes
+			if ( ret || support.disconnectedMatch ||
+
+				// As well, disconnected nodes are said to be in a document
+				// fragment in IE 9
+				elem.document && elem.document.nodeType !== 11 ) {
+				return ret;
+			}
+		} catch ( e ) {
+			nonnativeSelectorCache( expr, true );
+		}
+	}
+
+	return Sizzle( expr, document, null, [ elem ] ).length > 0;
+};
+
+Sizzle.contains = function( context, elem ) {
+
+	// Set document vars if needed
+	// Support: IE 11+, Edge 17 - 18+
+	// IE/Edge sometimes throw a "Permission denied" error when strict-comparing
+	// two documents; shallow comparisons work.
+	// eslint-disable-next-line eqeqeq
+	if ( ( context.ownerDocument || context ) != document ) {
+		setDocument( context );
+	}
+	return contains( context, elem );
+};
+
+Sizzle.attr = function( elem, name ) {
+
+	// Set document vars if needed
+	// Support: IE 11+, Edge 17 - 18+
+	// IE/Edge sometimes throw a "Permission denied" error when strict-comparing
+	// two documents; shallow comparisons work.
+	// eslint-disable-next-line eqeqeq
+	if ( ( elem.ownerDocument || elem ) != document ) {
+		setDocument( elem );
+	}
+
+	var fn = Expr.attrHandle[ name.toLowerCase() ],
+
+		// Don't get fooled by Object.prototype properties (jQuery #13807)
+		val = fn && hasOwn.call( Expr.attrHandle, name.toLowerCase() ) ?
+			fn( elem, name, !documentIsHTML ) :
+			undefined;
+
+	return val !== undefined ?
+		val :
+		support.attributes || !documentIsHTML ?
+			elem.getAttribute( name ) :
+			( val = elem.getAttributeNode( name ) ) && val.specified ?
+				val.value :
+				null;
+};
+
+Sizzle.escape = function( sel ) {
+	return ( sel + "" ).replace( rcssescape, fcssescape );
+};
+
+Sizzle.error = function( msg ) {
+	throw new Error( "Syntax error, unrecognized expression: " + msg );
+};
+
+/**
+ * Document sorting and removing duplicates
+ * @param {ArrayLike} results
+ */
+Sizzle.uniqueSort = function( results ) {
+	var elem,
+		duplicates = [],
+		j = 0,
+		i = 0;
+
+	// Unless we *know* we can detect duplicates, assume their presence
+	hasDuplicate = !support.detectDuplicates;
+	sortInput = !support.sortStable && results.slice( 0 );
+	results.sort( sortOrder );
+
+	if ( hasDuplicate ) {
+		while ( ( elem = results[ i++ ] ) ) {
+			if ( elem === results[ i ] ) {
+				j = duplicates.push( i );
+			}
+		}
+		while ( j-- ) {
+			results.splice( duplicates[ j ], 1 );
+		}
+	}
+
+	// Clear input after sorting to release objects
+	// See https://github.com/jquery/sizzle/pull/225
+	sortInput = null;
+
+	return results;
+};
+
+/**
+ * Utility function for retrieving the text value of an array of DOM nodes
+ * @param {Array|Element} elem
+ */
+getText = Sizzle.getText = function( elem ) {
+	var node,
+		ret = "",
+		i = 0,
+		nodeType = elem.nodeType;
+
+	if ( !nodeType ) {
+
+		// If no nodeType, this is expected to be an array
+		while ( ( node = elem[ i++ ] ) ) {
+
+			// Do not traverse comment nodes
+			ret += getText( node );
+		}
+	} else if ( nodeType === 1 || nodeType === 9 || nodeType === 11 ) {
+
+		// Use textContent for elements
+		// innerText usage removed for consistency of new lines (jQuery #11153)
+		if ( typeof elem.textContent === "string" ) {
+			return elem.textContent;
+		} else {
+
+			// Traverse its children
+			for ( elem = elem.firstChild; elem; elem = elem.nextSibling ) {
+				ret += getText( elem );
+			}
+		}
+	} else if ( nodeType === 3 || nodeType === 4 ) {
+		return elem.nodeValue;
+	}
+
+	// Do not include comment or processing instruction nodes
+
+	return ret;
+};
+
+Expr = Sizzle.selectors = {
+
+	// Can be adjusted by the user
+	cacheLength: 50,
+
+	createPseudo: markFunction,
+
+	match: matchExpr,
+
+	attrHandle: {},
+
+	find: {},
+
+	relative: {
+		">": { dir: "parentNode", first: true },
+		" ": { dir: "parentNode" },
+		"+": { dir: "previousSibling", first: true },
+		"~": { dir: "previousSibling" }
+	},
+
+	preFilter: {
+		"ATTR": function( match ) {
+			match[ 1 ] = match[ 1 ].replace( runescape, funescape );
+
+			// Move the given value to match[3] whether quoted or unquoted
+			match[ 3 ] = ( match[ 3 ] || match[ 4 ] ||
+				match[ 5 ] || "" ).replace( runescape, funescape );
+
+			if ( match[ 2 ] === "~=" ) {
+				match[ 3 ] = " " + match[ 3 ] + " ";
+			}
+
+			return match.slice( 0, 4 );
+		},
+
+		"CHILD": function( match ) {
+
+			/* matches from matchExpr["CHILD"]
+				1 type (only|nth|...)
+				2 what (child|of-type)
+				3 argument (even|odd|\d*|\d*n([+-]\d+)?|...)
+				4 xn-component of xn+y argument ([+-]?\d*n|)
+				5 sign of xn-component
+				6 x of xn-component
+				7 sign of y-component
+				8 y of y-component
+			*/
+			match[ 1 ] = match[ 1 ].toLowerCase();
+
+			if ( match[ 1 ].slice( 0, 3 ) === "nth" ) {
+
+				// nth-* requires argument
+				if ( !match[ 3 ] ) {
+					Sizzle.error( match[ 0 ] );
+				}
+
+				// numeric x and y parameters for Expr.filter.CHILD
+				// remember that false/true cast respectively to 0/1
+				match[ 4 ] = +( match[ 4 ] ?
+					match[ 5 ] + ( match[ 6 ] || 1 ) :
+					2 * ( match[ 3 ] === "even" || match[ 3 ] === "odd" ) );
+				match[ 5 ] = +( ( match[ 7 ] + match[ 8 ] ) || match[ 3 ] === "odd" );
+
+				// other types prohibit arguments
+			} else if ( match[ 3 ] ) {
+				Sizzle.error( match[ 0 ] );
+			}
+
+			return match;
+		},
+
+		"PSEUDO": function( match ) {
+			var excess,
+				unquoted = !match[ 6 ] && match[ 2 ];
+
+			if ( matchExpr[ "CHILD" ].test( match[ 0 ] ) ) {
+				return null;
+			}
+
+			// Accept quoted arguments as-is
+			if ( match[ 3 ] ) {
+				match[ 2 ] = match[ 4 ] || match[ 5 ] || "";
+
+			// Strip excess characters from unquoted arguments
+			} else if ( unquoted && rpseudo.test( unquoted ) &&
+
+				// Get excess from tokenize (recursively)
+				( excess = tokenize( unquoted, true ) ) &&
+
+				// advance to the next closing parenthesis
+				( excess = unquoted.indexOf( ")", unquoted.length - excess ) - unquoted.length ) ) {
+
+				// excess is a negative index
+				match[ 0 ] = match[ 0 ].slice( 0, excess );
+				match[ 2 ] = unquoted.slice( 0, excess );
+			}
+
+			// Return only captures needed by the pseudo filter method (type and argument)
+			return match.slice( 0, 3 );
+		}
+	},
+
+	filter: {
+
+		"TAG": function( nodeNameSelector ) {
+			var nodeName = nodeNameSelector.replace( runescape, funescape ).toLowerCase();
+			return nodeNameSelector === "*" ?
+				function() {
+					return true;
+				} :
+				function( elem ) {
+					return elem.nodeName && elem.nodeName.toLowerCase() === nodeName;
+				};
+		},
+
+		"CLASS": function( className ) {
+			var pattern = classCache[ className + " " ];
+
+			return pattern ||
+				( pattern = new RegExp( "(^|" + whitespace +
+					")" + className + "(" + whitespace + "|$)" ) ) && classCache(
+						className, function( elem ) {
+							return pattern.test(
+								typeof elem.className === "string" && elem.className ||
+								typeof elem.getAttribute !== "undefined" &&
+									elem.getAttribute( "class" ) ||
+								""
+							);
+				} );
+		},
+
+		"ATTR": function( name, operator, check ) {
+			return function( elem ) {
+				var result = Sizzle.attr( elem, name );
+
+				if ( result == null ) {
+					return operator === "!=";
+				}
+				if ( !operator ) {
+					return true;
+				}
+
+				result += "";
+
+				/* eslint-disable max-len */
+
+				return operator === "=" ? result === check :
+					operator === "!=" ? result !== check :
+					operator === "^=" ? check && result.indexOf( check ) === 0 :
+					operator === "*=" ? check && result.indexOf( check ) > -1 :
+					operator === "$=" ? check && result.slice( -check.length ) === check :
+					operator === "~=" ? ( " " + result.replace( rwhitespace, " " ) + " " ).indexOf( check ) > -1 :
+					operator === "|=" ? result === check || result.slice( 0, check.length + 1 ) === check + "-" :
+					false;
+				/* eslint-enable max-len */
+
+			};
+		},
+
+		"CHILD": function( type, what, _argument, first, last ) {
+			var simple = type.slice( 0, 3 ) !== "nth",
+				forward = type.slice( -4 ) !== "last",
+				ofType = what === "of-type";
+
+			return first === 1 && last === 0 ?
+
+				// Shortcut for :nth-*(n)
+				function( elem ) {
+					return !!elem.parentNode;
+				} :
+
+				function( elem, _context, xml ) {
+					var cache, uniqueCache, outerCache, node, nodeIndex, start,
+						dir = simple !== forward ? "nextSibling" : "previousSibling",
+						parent = elem.parentNode,
+						name = ofType && elem.nodeName.toLowerCase(),
+						useCache = !xml && !ofType,
+						diff = false;
+
+					if ( parent ) {
+
+						// :(first|last|only)-(child|of-type)
+						if ( simple ) {
+							while ( dir ) {
+								node = elem;
+								while ( ( node = node[ dir ] ) ) {
+									if ( ofType ?
+										node.nodeName.toLowerCase() === name :
+										node.nodeType === 1 ) {
+
+										return false;
+									}
+								}
+
+								// Reverse direction for :only-* (if we haven't yet done so)
+								start = dir = type === "only" && !start && "nextSibling";
+							}
+							return true;
+						}
+
+						start = [ forward ? parent.firstChild : parent.lastChild ];
+
+						// non-xml :nth-child(...) stores cache data on `parent`
+						if ( forward && useCache ) {
+
+							// Seek `elem` from a previously-cached index
+
+							// ...in a gzip-friendly way
+							node = parent;
+							outerCache = node[ expando ] || ( node[ expando ] = {} );
+
+							// Support: IE <9 only
+							// Defend against cloned attroperties (jQuery gh-1709)
+							uniqueCache = outerCache[ node.uniqueID ] ||
+								( outerCache[ node.uniqueID ] = {} );
+
+							cache = uniqueCache[ type ] || [];
+							nodeIndex = cache[ 0 ] === dirruns && cache[ 1 ];
+							diff = nodeIndex && cache[ 2 ];
+							node = nodeIndex && parent.childNodes[ nodeIndex ];
+
+							while ( ( node = ++nodeIndex && node && node[ dir ] ||
+
+								// Fallback to seeking `elem` from the start
+								( diff = nodeIndex = 0 ) || start.pop() ) ) {
+
+								// When found, cache indexes on `parent` and break
+								if ( node.nodeType === 1 && ++diff && node === elem ) {
+									uniqueCache[ type ] = [ dirruns, nodeIndex, diff ];
+									break;
+								}
+							}
+
+						} else {
+
+							// Use previously-cached element index if available
+							if ( useCache ) {
+
+								// ...in a gzip-friendly way
+								node = elem;
+								outerCache = node[ expando ] || ( node[ expando ] = {} );
+
+								// Support: IE <9 only
+								// Defend against cloned attroperties (jQuery gh-1709)
+								uniqueCache = outerCache[ node.uniqueID ] ||
+									( outerCache[ node.uniqueID ] = {} );
+
+								cache = uniqueCache[ type ] || [];
+								nodeIndex = cache[ 0 ] === dirruns && cache[ 1 ];
+								diff = nodeIndex;
+							}
+
+							// xml :nth-child(...)
+							// or :nth-last-child(...) or :nth(-last)?-of-type(...)
+							if ( diff === false ) {
+
+								// Use the same loop as above to seek `elem` from the start
+								while ( ( node = ++nodeIndex && node && node[ dir ] ||
+									( diff = nodeIndex = 0 ) || start.pop() ) ) {
+
+									if ( ( ofType ?
+										node.nodeName.toLowerCase() === name :
+										node.nodeType === 1 ) &&
+										++diff ) {
+
+										// Cache the index of each encountered element
+										if ( useCache ) {
+											outerCache = node[ expando ] ||
+												( node[ expando ] = {} );
+
+											// Support: IE <9 only
+											// Defend against cloned attroperties (jQuery gh-1709)
+											uniqueCache = outerCache[ node.uniqueID ] ||
+												( outerCache[ node.uniqueID ] = {} );
+
+											uniqueCache[ type ] = [ dirruns, diff ];
+										}
+
+										if ( node === elem ) {
+											break;
+										}
+									}
+								}
+							}
+						}
+
+						// Incorporate the offset, then check against cycle size
+						diff -= last;
+						return diff === first || ( diff % first === 0 && diff / first >= 0 );
+					}
+				};
+		},
+
+		"PSEUDO": function( pseudo, argument ) {
+
+			// pseudo-class names are case-insensitive
+			// http://www.w3.org/TR/selectors/#pseudo-classes
+			// Prioritize by case sensitivity in case custom pseudos are added with uppercase letters
+			// Remember that setFilters inherits from pseudos
+			var args,
+				fn = Expr.pseudos[ pseudo ] || Expr.setFilters[ pseudo.toLowerCase() ] ||
+					Sizzle.error( "unsupported pseudo: " + pseudo );
+
+			// The user may use createPseudo to indicate that
+			// arguments are needed to create the filter function
+			// just as Sizzle does
+			if ( fn[ expando ] ) {
+				return fn( argument );
+			}
+
+			// But maintain support for old signatures
+			if ( fn.length > 1 ) {
+				args = [ pseudo, pseudo, "", argument ];
+				return Expr.setFilters.hasOwnProperty( pseudo.toLowerCase() ) ?
+					markFunction( function( seed, matches ) {
+						var idx,
+							matched = fn( seed, argument ),
+							i = matched.length;
+						while ( i-- ) {
+							idx = indexOf( seed, matched[ i ] );
+							seed[ idx ] = !( matches[ idx ] = matched[ i ] );
+						}
+					} ) :
+					function( elem ) {
+						return fn( elem, 0, args );
+					};
+			}
+
+			return fn;
+		}
+	},
+
+	pseudos: {
+
+		// Potentially complex pseudos
+		"not": markFunction( function( selector ) {
+
+			// Trim the selector passed to compile
+			// to avoid treating leading and trailing
+			// spaces as combinators
+			var input = [],
+				results = [],
+				matcher = compile( selector.replace( rtrim, "$1" ) );
+
+			return matcher[ expando ] ?
+				markFunction( function( seed, matches, _context, xml ) {
+					var elem,
+						unmatched = matcher( seed, null, xml, [] ),
+						i = seed.length;
+
+					// Match elements unmatched by `matcher`
+					while ( i-- ) {
+						if ( ( elem = unmatched[ i ] ) ) {
+							seed[ i ] = !( matches[ i ] = elem );
+						}
+					}
+				} ) :
+				function( elem, _context, xml ) {
+					input[ 0 ] = elem;
+					matcher( input, null, xml, results );
+
+					// Don't keep the element (issue #299)
+					input[ 0 ] = null;
+					return !results.pop();
+				};
+		} ),
+
+		"has": markFunction( function( selector ) {
+			return function( elem ) {
+				return Sizzle( selector, elem ).length > 0;
+			};
+		} ),
+
+		"contains": markFunction( function( text ) {
+			text = text.replace( runescape, funescape );
+			return function( elem ) {
+				return ( elem.textContent || getText( elem ) ).indexOf( text ) > -1;
+			};
+		} ),
+
+		// "Whether an element is represented by a :lang() selector
+		// is based solely on the element's language value
+		// being equal to the identifier C,
+		// or beginning with the identifier C immediately followed by "-".
+		// The matching of C against the element's language value is performed case-insensitively.
+		// The identifier C does not have to be a valid language name."
+		// http://www.w3.org/TR/selectors/#lang-pseudo
+		"lang": markFunction( function( lang ) {
+
+			// lang value must be a valid identifier
+			if ( !ridentifier.test( lang || "" ) ) {
+				Sizzle.error( "unsupported lang: " + lang );
+			}
+			lang = lang.replace( runescape, funescape ).toLowerCase();
+			return function( elem ) {
+				var elemLang;
+				do {
+					if ( ( elemLang = documentIsHTML ?
+						elem.lang :
+						elem.getAttribute( "xml:lang" ) || elem.getAttribute( "lang" ) ) ) {
+
+						elemLang = elemLang.toLowerCase();
+						return elemLang === lang || elemLang.indexOf( lang + "-" ) === 0;
+					}
+				} while ( ( elem = elem.parentNode ) && elem.nodeType === 1 );
+				return false;
+			};
+		} ),
+
+		// Miscellaneous
+		"target": function( elem ) {
+			var hash = window.location && window.location.hash;
+			return hash && hash.slice( 1 ) === elem.id;
+		},
+
+		"root": function( elem ) {
+			return elem === docElem;
+		},
+
+		"focus": function( elem ) {
+			return elem === document.activeElement &&
+				( !document.hasFocus || document.hasFocus() ) &&
+				!!( elem.type || elem.href || ~elem.tabIndex );
+		},
+
+		// Boolean properties
+		"enabled": createDisabledPseudo( false ),
+		"disabled": createDisabledPseudo( true ),
+
+		"checked": function( elem ) {
+
+			// In CSS3, :checked should return both checked and selected elements
+			// http://www.w3.org/TR/2011/REC-css3-selectors-20110929/#checked
+			var nodeName = elem.nodeName.toLowerCase();
+			return ( nodeName === "input" && !!elem.checked ) ||
+				( nodeName === "option" && !!elem.selected );
+		},
+
+		"selected": function( elem ) {
+
+			// Accessing this property makes selected-by-default
+			// options in Safari work properly
+			if ( elem.parentNode ) {
+				// eslint-disable-next-line no-unused-expressions
+				elem.parentNode.selectedIndex;
+			}
+
+			return elem.selected === true;
+		},
+
+		// Contents
+		"empty": function( elem ) {
+
+			// http://www.w3.org/TR/selectors/#empty-pseudo
+			// :empty is negated by element (1) or content nodes (text: 3; cdata: 4; entity ref: 5),
+			//   but not by others (comment: 8; processing instruction: 7; etc.)
+			// nodeType < 6 works because attributes (2) do not appear as children
+			for ( elem = elem.firstChild; elem; elem = elem.nextSibling ) {
+				if ( elem.nodeType < 6 ) {
+					return false;
+				}
+			}
+			return true;
+		},
+
+		"parent": function( elem ) {
+			return !Expr.pseudos[ "empty" ]( elem );
+		},
+
+		// Element/input types
+		"header": function( elem ) {
+			return rheader.test( elem.nodeName );
+		},
+
+		"input": function( elem ) {
+			return rinputs.test( elem.nodeName );
+		},
+
+		"button": function( elem ) {
+			var name = elem.nodeName.toLowerCase();
+			return name === "input" && elem.type === "button" || name === "button";
+		},
+
+		"text": function( elem ) {
+			var attr;
+			return elem.nodeName.toLowerCase() === "input" &&
+				elem.type === "text" &&
+
+				// Support: IE<8
+				// New HTML5 attribute values (e.g., "search") appear with elem.type === "text"
+				( ( attr = elem.getAttribute( "type" ) ) == null ||
+					attr.toLowerCase() === "text" );
+		},
+
+		// Position-in-collection
+		"first": createPositionalPseudo( function() {
+			return [ 0 ];
+		} ),
+
+		"last": createPositionalPseudo( function( _matchIndexes, length ) {
+			return [ length - 1 ];
+		} ),
+
+		"eq": createPositionalPseudo( function( _matchIndexes, length, argument ) {
+			return [ argument < 0 ? argument + length : argument ];
+		} ),
+
+		"even": createPositionalPseudo( function( matchIndexes, length ) {
+			var i = 0;
+			for ( ; i < length; i += 2 ) {
+				matchIndexes.push( i );
+			}
+			return matchIndexes;
+		} ),
+
+		"odd": createPositionalPseudo( function( matchIndexes, length ) {
+			var i = 1;
+			for ( ; i < length; i += 2 ) {
+				matchIndexes.push( i );
+			}
+			return matchIndexes;
+		} ),
+
+		"lt": createPositionalPseudo( function( matchIndexes, length, argument ) {
+			var i = argument < 0 ?
+				argument + length :
+				argument > length ?
+					length :
+					argument;
+			for ( ; --i >= 0; ) {
+				matchIndexes.push( i );
+			}
+			return matchIndexes;
+		} ),
+
+		"gt": createPositionalPseudo( function( matchIndexes, length, argument ) {
+			var i = argument < 0 ? argument + length : argument;
+			for ( ; ++i < length; ) {
+				matchIndexes.push( i );
+			}
+			return matchIndexes;
+		} )
+	}
+};
+
+Expr.pseudos[ "nth" ] = Expr.pseudos[ "eq" ];
+
+// Add button/input type pseudos
+for ( i in { radio: true, checkbox: true, file: true, password: true, image: true } ) {
+	Expr.pseudos[ i ] = createInputPseudo( i );
+}
+for ( i in { submit: true, reset: true } ) {
+	Expr.pseudos[ i ] = createButtonPseudo( i );
+}
+
+// Easy API for creating new setFilters
+function setFilters() {}
+setFilters.prototype = Expr.filters = Expr.pseudos;
+Expr.setFilters = new setFilters();
+
+tokenize = Sizzle.tokenize = function( selector, parseOnly ) {
+	var matched, match, tokens, type,
+		soFar, groups, preFilters,
+		cached = tokenCache[ selector + " " ];
+
+	if ( cached ) {
+		return parseOnly ? 0 : cached.slice( 0 );
+	}
+
+	soFar = selector;
+	groups = [];
+	preFilters = Expr.preFilter;
+
+	while ( soFar ) {
+
+		// Comma and first run
+		if ( !matched || ( match = rcomma.exec( soFar ) ) ) {
+			if ( match ) {
+
+				// Don't consume trailing commas as valid
+				soFar = soFar.slice( match[ 0 ].length ) || soFar;
+			}
+			groups.push( ( tokens = [] ) );
+		}
+
+		matched = false;
+
+		// Combinators
+		if ( ( match = rcombinators.exec( soFar ) ) ) {
+			matched = match.shift();
+			tokens.push( {
+				value: matched,
+
+				// Cast descendant combinators to space
+				type: match[ 0 ].replace( rtrim, " " )
+			} );
+			soFar = soFar.slice( matched.length );
+		}
+
+		// Filters
+		for ( type in Expr.filter ) {
+			if ( ( match = matchExpr[ type ].exec( soFar ) ) && ( !preFilters[ type ] ||
+				( match = preFilters[ type ]( match ) ) ) ) {
+				matched = match.shift();
+				tokens.push( {
+					value: matched,
+					type: type,
+					matches: match
+				} );
+				soFar = soFar.slice( matched.length );
+			}
+		}
+
+		if ( !matched ) {
+			break;
+		}
+	}
+
+	// Return the length of the invalid excess
+	// if we're just parsing
+	// Otherwise, throw an error or return tokens
+	return parseOnly ?
+		soFar.length :
+		soFar ?
+			Sizzle.error( selector ) :
+
+			// Cache the tokens
+			tokenCache( selector, groups ).slice( 0 );
+};
+
+function toSelector( tokens ) {
+	var i = 0,
+		len = tokens.length,
+		selector = "";
+	for ( ; i < len; i++ ) {
+		selector += tokens[ i ].value;
+	}
+	return selector;
+}
+
+function addCombinator( matcher, combinator, base ) {
+	var dir = combinator.dir,
+		skip = combinator.next,
+		key = skip || dir,
+		checkNonElements = base && key === "parentNode",
+		doneName = done++;
+
+	return combinator.first ?
+
+		// Check against closest ancestor/preceding element
+		function( elem, context, xml ) {
+			while ( ( elem = elem[ dir ] ) ) {
+				if ( elem.nodeType === 1 || checkNonElements ) {
+					return matcher( elem, context, xml );
+				}
+			}
+			return false;
+		} :
+
+		// Check against all ancestor/preceding elements
+		function( elem, context, xml ) {
+			var oldCache, uniqueCache, outerCache,
+				newCache = [ dirruns, doneName ];
+
+			// We can't set arbitrary data on XML nodes, so they don't benefit from combinator caching
+			if ( xml ) {
+				while ( ( elem = elem[ dir ] ) ) {
+					if ( elem.nodeType === 1 || checkNonElements ) {
+						if ( matcher( elem, context, xml ) ) {
+							return true;
+						}
+					}
+				}
+			} else {
+				while ( ( elem = elem[ dir ] ) ) {
+					if ( elem.nodeType === 1 || checkNonElements ) {
+						outerCache = elem[ expando ] || ( elem[ expando ] = {} );
+
+						// Support: IE <9 only
+						// Defend against cloned attroperties (jQuery gh-1709)
+						uniqueCache = outerCache[ elem.uniqueID ] ||
+							( outerCache[ elem.uniqueID ] = {} );
+
+						if ( skip && skip === elem.nodeName.toLowerCase() ) {
+							elem = elem[ dir ] || elem;
+						} else if ( ( oldCache = uniqueCache[ key ] ) &&
+							oldCache[ 0 ] === dirruns && oldCache[ 1 ] === doneName ) {
+
+							// Assign to newCache so results back-propagate to previous elements
+							return ( newCache[ 2 ] = oldCache[ 2 ] );
+						} else {
+
+							// Reuse newcache so results back-propagate to previous elements
+							uniqueCache[ key ] = newCache;
+
+							// A match means we're done; a fail means we have to keep checking
+							if ( ( newCache[ 2 ] = matcher( elem, context, xml ) ) ) {
+								return true;
+							}
+						}
+					}
+				}
+			}
+			return false;
+		};
+}
+
+function elementMatcher( matchers ) {
+	return matchers.length > 1 ?
+		function( elem, context, xml ) {
+			var i = matchers.length;
+			while ( i-- ) {
+				if ( !matchers[ i ]( elem, context, xml ) ) {
+					return false;
+				}
+			}
+			return true;
+		} :
+		matchers[ 0 ];
+}
+
+function multipleContexts( selector, contexts, results ) {
+	var i = 0,
+		len = contexts.length;
+	for ( ; i < len; i++ ) {
+		Sizzle( selector, contexts[ i ], results );
+	}
+	return results;
+}
+
+function condense( unmatched, map, filter, context, xml ) {
+	var elem,
+		newUnmatched = [],
+		i = 0,
+		len = unmatched.length,
+		mapped = map != null;
+
+	for ( ; i < len; i++ ) {
+		if ( ( elem = unmatched[ i ] ) ) {
+			if ( !filter || filter( elem, context, xml ) ) {
+				newUnmatched.push( elem );
+				if ( mapped ) {
+					map.push( i );
+				}
+			}
+		}
+	}
+
+	return newUnmatched;
+}
+
+function setMatcher( preFilter, selector, matcher, postFilter, postFinder, postSelector ) {
+	if ( postFilter && !postFilter[ expando ] ) {
+		postFilter = setMatcher( postFilter );
+	}
+	if ( postFinder && !postFinder[ expando ] ) {
+		postFinder = setMatcher( postFinder, postSelector );
+	}
+	return markFunction( function( seed, results, context, xml ) {
+		var temp, i, elem,
+			preMap = [],
+			postMap = [],
+			preexisting = results.length,
+
+			// Get initial elements from seed or context
+			elems = seed || multipleContexts(
+				selector || "*",
+				context.nodeType ? [ context ] : context,
+				[]
+			),
+
+			// Prefilter to get matcher input, preserving a map for seed-results synchronization
+			matcherIn = preFilter && ( seed || !selector ) ?
+				condense( elems, preMap, preFilter, context, xml ) :
+				elems,
+
+			matcherOut = matcher ?
+
+				// If we have a postFinder, or filtered seed, or non-seed postFilter or preexisting results,
+				postFinder || ( seed ? preFilter : preexisting || postFilter ) ?
+
+					// ...intermediate processing is necessary
+					[] :
+
+					// ...otherwise use results directly
+					results :
+				matcherIn;
+
+		// Find primary matches
+		if ( matcher ) {
+			matcher( matcherIn, matcherOut, context, xml );
+		}
+
+		// Apply postFilter
+		if ( postFilter ) {
+			temp = condense( matcherOut, postMap );
+			postFilter( temp, [], context, xml );
+
+			// Un-match failing elements by moving them back to matcherIn
+			i = temp.length;
+			while ( i-- ) {
+				if ( ( elem = temp[ i ] ) ) {
+					matcherOut[ postMap[ i ] ] = !( matcherIn[ postMap[ i ] ] = elem );
+				}
+			}
+		}
+
+		if ( seed ) {
+			if ( postFinder || preFilter ) {
+				if ( postFinder ) {
+
+					// Get the final matcherOut by condensing this intermediate into postFinder contexts
+					temp = [];
+					i = matcherOut.length;
+					while ( i-- ) {
+						if ( ( elem = matcherOut[ i ] ) ) {
+
+							// Restore matcherIn since elem is not yet a final match
+							temp.push( ( matcherIn[ i ] = elem ) );
+						}
+					}
+					postFinder( null, ( matcherOut = [] ), temp, xml );
+				}
+
+				// Move matched elements from seed to results to keep them synchronized
+				i = matcherOut.length;
+				while ( i-- ) {
+					if ( ( elem = matcherOut[ i ] ) &&
+						( temp = postFinder ? indexOf( seed, elem ) : preMap[ i ] ) > -1 ) {
+
+						seed[ temp ] = !( results[ temp ] = elem );
+					}
+				}
+			}
+
+		// Add elements to results, through postFinder if defined
+		} else {
+			matcherOut = condense(
+				matcherOut === results ?
+					matcherOut.splice( preexisting, matcherOut.length ) :
+					matcherOut
+			);
+			if ( postFinder ) {
+				postFinder( null, results, matcherOut, xml );
+			} else {
+				push.apply( results, matcherOut );
+			}
+		}
+	} );
+}
+
+function matcherFromTokens( tokens ) {
+	var checkContext, matcher, j,
+		len = tokens.length,
+		leadingRelative = Expr.relative[ tokens[ 0 ].type ],
+		implicitRelative = leadingRelative || Expr.relative[ " " ],
+		i = leadingRelative ? 1 : 0,
+
+		// The foundational matcher ensures that elements are reachable from top-level context(s)
+		matchContext = addCombinator( function( elem ) {
+			return elem === checkContext;
+		}, implicitRelative, true ),
+		matchAnyContext = addCombinator( function( elem ) {
+			return indexOf( checkContext, elem ) > -1;
+		}, implicitRelative, true ),
+		matchers = [ function( elem, context, xml ) {
+			var ret = ( !leadingRelative && ( xml || context !== outermostContext ) ) || (
+				( checkContext = context ).nodeType ?
+					matchContext( elem, context, xml ) :
+					matchAnyContext( elem, context, xml ) );
+
+			// Avoid hanging onto element (issue #299)
+			checkContext = null;
+			return ret;
+		} ];
+
+	for ( ; i < len; i++ ) {
+		if ( ( matcher = Expr.relative[ tokens[ i ].type ] ) ) {
+			matchers = [ addCombinator( elementMatcher( matchers ), matcher ) ];
+		} else {
+			matcher = Expr.filter[ tokens[ i ].type ].apply( null, tokens[ i ].matches );
+
+			// Return special upon seeing a positional matcher
+			if ( matcher[ expando ] ) {
+
+				// Find the next relative operator (if any) for proper handling
+				j = ++i;
+				for ( ; j < len; j++ ) {
+					if ( Expr.relative[ tokens[ j ].type ] ) {
+						break;
+					}
+				}
+				return setMatcher(
+					i > 1 && elementMatcher( matchers ),
+					i > 1 && toSelector(
+
+					// If the preceding token was a descendant combinator, insert an implicit any-element `*`
+					tokens
+						.slice( 0, i - 1 )
+						.concat( { value: tokens[ i - 2 ].type === " " ? "*" : "" } )
+					).replace( rtrim, "$1" ),
+					matcher,
+					i < j && matcherFromTokens( tokens.slice( i, j ) ),
+					j < len && matcherFromTokens( ( tokens = tokens.slice( j ) ) ),
+					j < len && toSelector( tokens )
+				);
+			}
+			matchers.push( matcher );
+		}
+	}
+
+	return elementMatcher( matchers );
+}
+
+function matcherFromGroupMatchers( elementMatchers, setMatchers ) {
+	var bySet = setMatchers.length > 0,
+		byElement = elementMatchers.length > 0,
+		superMatcher = function( seed, context, xml, results, outermost ) {
+			var elem, j, matcher,
+				matchedCount = 0,
+				i = "0",
+				unmatched = seed && [],
+				setMatched = [],
+				contextBackup = outermostContext,
+
+				// We must always have either seed elements or outermost context
+				elems = seed || byElement && Expr.find[ "TAG" ]( "*", outermost ),
+
+				// Use integer dirruns iff this is the outermost matcher
+				dirrunsUnique = ( dirruns += contextBackup == null ? 1 : Math.random() || 0.1 ),
+				len = elems.length;
+
+			if ( outermost ) {
+
+				// Support: IE 11+, Edge 17 - 18+
+				// IE/Edge sometimes throw a "Permission denied" error when strict-comparing
+				// two documents; shallow comparisons work.
+				// eslint-disable-next-line eqeqeq
+				outermostContext = context == document || context || outermost;
+			}
+
+			// Add elements passing elementMatchers directly to results
+			// Support: IE<9, Safari
+			// Tolerate NodeList properties (IE: "length"; Safari: ) matching elements by id
+			for ( ; i !== len && ( elem = elems[ i ] ) != null; i++ ) {
+				if ( byElement && elem ) {
+					j = 0;
+
+					// Support: IE 11+, Edge 17 - 18+
+					// IE/Edge sometimes throw a "Permission denied" error when strict-comparing
+					// two documents; shallow comparisons work.
+					// eslint-disable-next-line eqeqeq
+					if ( !context && elem.ownerDocument != document ) {
+						setDocument( elem );
+						xml = !documentIsHTML;
+					}
+					while ( ( matcher = elementMatchers[ j++ ] ) ) {
+						if ( matcher( elem, context || document, xml ) ) {
+							results.push( elem );
+							break;
+						}
+					}
+					if ( outermost ) {
+						dirruns = dirrunsUnique;
+					}
+				}
+
+				// Track unmatched elements for set filters
+				if ( bySet ) {
+
+					// They will have gone through all possible matchers
+					if ( ( elem = !matcher && elem ) ) {
+						matchedCount--;
+					}
+
+					// Lengthen the array for every element, matched or not
+					if ( seed ) {
+						unmatched.push( elem );
+					}
+				}
+			}
+
+			// `i` is now the count of elements visited above, and adding it to `matchedCount`
+			// makes the latter nonnegative.
+			matchedCount += i;
+
+			// Apply set filters to unmatched elements
+			// NOTE: This can be skipped if there are no unmatched elements (i.e., `matchedCount`
+			// equals `i`), unless we didn't visit _any_ elements in the above loop because we have
+			// no element matchers and no seed.
+			// Incrementing an initially-string "0" `i` allows `i` to remain a string only in that
+			// case, which will result in a "00" `matchedCount` that differs from `i` but is also
+			// numerically zero.
+			if ( bySet && i !== matchedCount ) {
+				j = 0;
+				while ( ( matcher = setMatchers[ j++ ] ) ) {
+					matcher( unmatched, setMatched, context, xml );
+				}
+
+				if ( seed ) {
+
+					// Reintegrate element matches to eliminate the need for sorting
+					if ( matchedCount > 0 ) {
+						while ( i-- ) {
+							if ( !( unmatched[ i ] || setMatched[ i ] ) ) {
+								setMatched[ i ] = pop.call( results );
+							}
+						}
+					}
+
+					// Discard index placeholder values to get only actual matches
+					setMatched = condense( setMatched );
+				}
+
+				// Add matches to results
+				push.apply( results, setMatched );
+
+				// Seedless set matches succeeding multiple successful matchers stipulate sorting
+				if ( outermost && !seed && setMatched.length > 0 &&
+					( matchedCount + setMatchers.length ) > 1 ) {
+
+					Sizzle.uniqueSort( results );
+				}
+			}
+
+			// Override manipulation of globals by nested matchers
+			if ( outermost ) {
+				dirruns = dirrunsUnique;
+				outermostContext = contextBackup;
+			}
+
+			return unmatched;
+		};
+
+	return bySet ?
+		markFunction( superMatcher ) :
+		superMatcher;
+}
+
+compile = Sizzle.compile = function( selector, match /* Internal Use Only */ ) {
+	var i,
+		setMatchers = [],
+		elementMatchers = [],
+		cached = compilerCache[ selector + " " ];
+
+	if ( !cached ) {
+
+		// Generate a function of recursive functions that can be used to check each element
+		if ( !match ) {
+			match = tokenize( selector );
+		}
+		i = match.length;
+		while ( i-- ) {
+			cached = matcherFromTokens( match[ i ] );
+			if ( cached[ expando ] ) {
+				setMatchers.push( cached );
+			} else {
+				elementMatchers.push( cached );
+			}
+		}
+
+		// Cache the compiled function
+		cached = compilerCache(
+			selector,
+			matcherFromGroupMatchers( elementMatchers, setMatchers )
+		);
+
+		// Save selector and tokenization
+		cached.selector = selector;
+	}
+	return cached;
+};
+
+/**
+ * A low-level selection function that works with Sizzle's compiled
+ *  selector functions
+ * @param {String|Function} selector A selector or a pre-compiled
+ *  selector function built with Sizzle.compile
+ * @param {Element} context
+ * @param {Array} [results]
+ * @param {Array} [seed] A set of elements to match against
+ */
+select = Sizzle.select = function( selector, context, results, seed ) {
+	var i, tokens, token, type, find,
+		compiled = typeof selector === "function" && selector,
+		match = !seed && tokenize( ( selector = compiled.selector || selector ) );
+
+	results = results || [];
+
+	// Try to minimize operations if there is only one selector in the list and no seed
+	// (the latter of which guarantees us context)
+	if ( match.length === 1 ) {
+
+		// Reduce context if the leading compound selector is an ID
+		tokens = match[ 0 ] = match[ 0 ].slice( 0 );
+		if ( tokens.length > 2 && ( token = tokens[ 0 ] ).type === "ID" &&
+			context.nodeType === 9 && documentIsHTML && Expr.relative[ tokens[ 1 ].type ] ) {
+
+			context = ( Expr.find[ "ID" ]( token.matches[ 0 ]
+				.replace( runescape, funescape ), context ) || [] )[ 0 ];
+			if ( !context ) {
+				return results;
+
+			// Precompiled matchers will still verify ancestry, so step up a level
+			} else if ( compiled ) {
+				context = context.parentNode;
+			}
+
+			selector = selector.slice( tokens.shift().value.length );
+		}
+
+		// Fetch a seed set for right-to-left matching
+		i = matchExpr[ "needsContext" ].test( selector ) ? 0 : tokens.length;
+		while ( i-- ) {
+			token = tokens[ i ];
+
+			// Abort if we hit a combinator
+			if ( Expr.relative[ ( type = token.type ) ] ) {
+				break;
+			}
+			if ( ( find = Expr.find[ type ] ) ) {
+
+				// Search, expanding context for leading sibling combinators
+				if ( ( seed = find(
+					token.matches[ 0 ].replace( runescape, funescape ),
+					rsibling.test( tokens[ 0 ].type ) && testContext( context.parentNode ) ||
+						context
+				) ) ) {
+
+					// If seed is empty or no tokens remain, we can return early
+					tokens.splice( i, 1 );
+					selector = seed.length && toSelector( tokens );
+					if ( !selector ) {
+						push.apply( results, seed );
+						return results;
+					}
+
+					break;
+				}
+			}
+		}
+	}
+
+	// Compile and execute a filtering function if one is not provided
+	// Provide `match` to avoid retokenization if we modified the selector above
+	( compiled || compile( selector, match ) )(
+		seed,
+		context,
+		!documentIsHTML,
+		results,
+		!context || rsibling.test( selector ) && testContext( context.parentNode ) || context
+	);
+	return results;
+};
+
+// One-time assignments
+
+// Sort stability
+support.sortStable = expando.split( "" ).sort( sortOrder ).join( "" ) === expando;
+
+// Support: Chrome 14-35+
+// Always assume duplicates if they aren't passed to the comparison function
+support.detectDuplicates = !!hasDuplicate;
+
+// Initialize against the default document
+setDocument();
+
+// Support: Webkit<537.32 - Safari 6.0.3/Chrome 25 (fixed in Chrome 27)
+// Detached nodes confoundingly follow *each other*
+support.sortDetached = assert( function( el ) {
+
+	// Should return 1, but returns 4 (following)
+	return el.compareDocumentPosition( document.createElement( "fieldset" ) ) & 1;
+} );
+
+// Support: IE<8
+// Prevent attribute/property "interpolation"
+// https://msdn.microsoft.com/en-us/library/ms536429%28VS.85%29.aspx
+if ( !assert( function( el ) {
+	el.innerHTML = "";
+	return el.firstChild.getAttribute( "href" ) === "#";
+} ) ) {
+	addHandle( "type|href|height|width", function( elem, name, isXML ) {
+		if ( !isXML ) {
+			return elem.getAttribute( name, name.toLowerCase() === "type" ? 1 : 2 );
+		}
+	} );
+}
+
+// Support: IE<9
+// Use defaultValue in place of getAttribute("value")
+if ( !support.attributes || !assert( function( el ) {
+	el.innerHTML = "";
+	el.firstChild.setAttribute( "value", "" );
+	return el.firstChild.getAttribute( "value" ) === "";
+} ) ) {
+	addHandle( "value", function( elem, _name, isXML ) {
+		if ( !isXML && elem.nodeName.toLowerCase() === "input" ) {
+			return elem.defaultValue;
+		}
+	} );
+}
+
+// Support: IE<9
+// Use getAttributeNode to fetch booleans when getAttribute lies
+if ( !assert( function( el ) {
+	return el.getAttribute( "disabled" ) == null;
+} ) ) {
+	addHandle( booleans, function( elem, name, isXML ) {
+		var val;
+		if ( !isXML ) {
+			return elem[ name ] === true ? name.toLowerCase() :
+				( val = elem.getAttributeNode( name ) ) && val.specified ?
+					val.value :
+					null;
+		}
+	} );
+}
+
+return Sizzle;
+
+} )( window );
+
+
+
+jQuery.find = Sizzle;
+jQuery.expr = Sizzle.selectors;
+
+// Deprecated
+jQuery.expr[ ":" ] = jQuery.expr.pseudos;
+jQuery.uniqueSort = jQuery.unique = Sizzle.uniqueSort;
+jQuery.text = Sizzle.getText;
+jQuery.isXMLDoc = Sizzle.isXML;
+jQuery.contains = Sizzle.contains;
+jQuery.escapeSelector = Sizzle.escape;
+
+
+
+
+var dir = function( elem, dir, until ) {
+	var matched = [],
+		truncate = until !== undefined;
+
+	while ( ( elem = elem[ dir ] ) && elem.nodeType !== 9 ) {
+		if ( elem.nodeType === 1 ) {
+			if ( truncate && jQuery( elem ).is( until ) ) {
+				break;
+			}
+			matched.push( elem );
+		}
+	}
+	return matched;
+};
+
+
+var siblings = function( n, elem ) {
+	var matched = [];
+
+	for ( ; n; n = n.nextSibling ) {
+		if ( n.nodeType === 1 && n !== elem ) {
+			matched.push( n );
+		}
+	}
+
+	return matched;
+};
+
+
+var rneedsContext = jQuery.expr.match.needsContext;
+
+
+
+function nodeName( elem, name ) {
+
+	return elem.nodeName && elem.nodeName.toLowerCase() === name.toLowerCase();
+
+}
+var rsingleTag = ( /^<([a-z][^\/\0>:\x20\t\r\n\f]*)[\x20\t\r\n\f]*\/?>(?:<\/\1>|)$/i );
+
+
+
+// Implement the identical functionality for filter and not
+function winnow( elements, qualifier, not ) {
+	if ( isFunction( qualifier ) ) {
+		return jQuery.grep( elements, function( elem, i ) {
+			return !!qualifier.call( elem, i, elem ) !== not;
+		} );
+	}
+
+	// Single element
+	if ( qualifier.nodeType ) {
+		return jQuery.grep( elements, function( elem ) {
+			return ( elem === qualifier ) !== not;
+		} );
+	}
+
+	// Arraylike of elements (jQuery, arguments, Array)
+	if ( typeof qualifier !== "string" ) {
+		return jQuery.grep( elements, function( elem ) {
+			return ( indexOf.call( qualifier, elem ) > -1 ) !== not;
+		} );
+	}
+
+	// Filtered directly for both simple and complex selectors
+	return jQuery.filter( qualifier, elements, not );
+}
+
+jQuery.filter = function( expr, elems, not ) {
+	var elem = elems[ 0 ];
+
+	if ( not ) {
+		expr = ":not(" + expr + ")";
+	}
+
+	if ( elems.length === 1 && elem.nodeType === 1 ) {
+		return jQuery.find.matchesSelector( elem, expr ) ? [ elem ] : [];
+	}
+
+	return jQuery.find.matches( expr, jQuery.grep( elems, function( elem ) {
+		return elem.nodeType === 1;
+	} ) );
+};
+
+jQuery.fn.extend( {
+	find: function( selector ) {
+		var i, ret,
+			len = this.length,
+			self = this;
+
+		if ( typeof selector !== "string" ) {
+			return this.pushStack( jQuery( selector ).filter( function() {
+				for ( i = 0; i < len; i++ ) {
+					if ( jQuery.contains( self[ i ], this ) ) {
+						return true;
+					}
+				}
+			} ) );
+		}
+
+		ret = this.pushStack( [] );
+
+		for ( i = 0; i < len; i++ ) {
+			jQuery.find( selector, self[ i ], ret );
+		}
+
+		return len > 1 ? jQuery.uniqueSort( ret ) : ret;
+	},
+	filter: function( selector ) {
+		return this.pushStack( winnow( this, selector || [], false ) );
+	},
+	not: function( selector ) {
+		return this.pushStack( winnow( this, selector || [], true ) );
+	},
+	is: function( selector ) {
+		return !!winnow(
+			this,
+
+			// If this is a positional/relative selector, check membership in the returned set
+			// so $("p:first").is("p:last") won't return true for a doc with two "p".
+			typeof selector === "string" && rneedsContext.test( selector ) ?
+				jQuery( selector ) :
+				selector || [],
+			false
+		).length;
+	}
+} );
+
+
+// Initialize a jQuery object
+
+
+// A central reference to the root jQuery(document)
+var rootjQuery,
+
+	// A simple way to check for HTML strings
+	// Prioritize #id over  to avoid XSS via location.hash (#9521)
+	// Strict HTML recognition (#11290: must start with <)
+	// Shortcut simple #id case for speed
+	rquickExpr = /^(?:\s*(<[\w\W]+>)[^>]*|#([\w-]+))$/,
+
+	init = jQuery.fn.init = function( selector, context, root ) {
+		var match, elem;
+
+		// HANDLE: $(""), $(null), $(undefined), $(false)
+		if ( !selector ) {
+			return this;
+		}
+
+		// Method init() accepts an alternate rootjQuery
+		// so migrate can support jQuery.sub (gh-2101)
+		root = root || rootjQuery;
+
+		// Handle HTML strings
+		if ( typeof selector === "string" ) {
+			if ( selector[ 0 ] === "<" &&
+				selector[ selector.length - 1 ] === ">" &&
+				selector.length >= 3 ) {
+
+				// Assume that strings that start and end with <> are HTML and skip the regex check
+				match = [ null, selector, null ];
+
+			} else {
+				match = rquickExpr.exec( selector );
+			}
+
+			// Match html or make sure no context is specified for #id
+			if ( match && ( match[ 1 ] || !context ) ) {
+
+				// HANDLE: $(html) -> $(array)
+				if ( match[ 1 ] ) {
+					context = context instanceof jQuery ? context[ 0 ] : context;
+
+					// Option to run scripts is true for back-compat
+					// Intentionally let the error be thrown if parseHTML is not present
+					jQuery.merge( this, jQuery.parseHTML(
+						match[ 1 ],
+						context && context.nodeType ? context.ownerDocument || context : document,
+						true
+					) );
+
+					// HANDLE: $(html, props)
+					if ( rsingleTag.test( match[ 1 ] ) && jQuery.isPlainObject( context ) ) {
+						for ( match in context ) {
+
+							// Properties of context are called as methods if possible
+							if ( isFunction( this[ match ] ) ) {
+								this[ match ]( context[ match ] );
+
+							// ...and otherwise set as attributes
+							} else {
+								this.attr( match, context[ match ] );
+							}
+						}
+					}
+
+					return this;
+
+				// HANDLE: $(#id)
+				} else {
+					elem = document.getElementById( match[ 2 ] );
+
+					if ( elem ) {
+
+						// Inject the element directly into the jQuery object
+						this[ 0 ] = elem;
+						this.length = 1;
+					}
+					return this;
+				}
+
+			// HANDLE: $(expr, $(...))
+			} else if ( !context || context.jquery ) {
+				return ( context || root ).find( selector );
+
+			// HANDLE: $(expr, context)
+			// (which is just equivalent to: $(context).find(expr)
+			} else {
+				return this.constructor( context ).find( selector );
+			}
+
+		// HANDLE: $(DOMElement)
+		} else if ( selector.nodeType ) {
+			this[ 0 ] = selector;
+			this.length = 1;
+			return this;
+
+		// HANDLE: $(function)
+		// Shortcut for document ready
+		} else if ( isFunction( selector ) ) {
+			return root.ready !== undefined ?
+				root.ready( selector ) :
+
+				// Execute immediately if ready is not present
+				selector( jQuery );
+		}
+
+		return jQuery.makeArray( selector, this );
+	};
+
+// Give the init function the jQuery prototype for later instantiation
+init.prototype = jQuery.fn;
+
+// Initialize central reference
+rootjQuery = jQuery( document );
+
+
+var rparentsprev = /^(?:parents|prev(?:Until|All))/,
+
+	// Methods guaranteed to produce a unique set when starting from a unique set
+	guaranteedUnique = {
+		children: true,
+		contents: true,
+		next: true,
+		prev: true
+	};
+
+jQuery.fn.extend( {
+	has: function( target ) {
+		var targets = jQuery( target, this ),
+			l = targets.length;
+
+		return this.filter( function() {
+			var i = 0;
+			for ( ; i < l; i++ ) {
+				if ( jQuery.contains( this, targets[ i ] ) ) {
+					return true;
+				}
+			}
+		} );
+	},
+
+	closest: function( selectors, context ) {
+		var cur,
+			i = 0,
+			l = this.length,
+			matched = [],
+			targets = typeof selectors !== "string" && jQuery( selectors );
+
+		// Positional selectors never match, since there's no _selection_ context
+		if ( !rneedsContext.test( selectors ) ) {
+			for ( ; i < l; i++ ) {
+				for ( cur = this[ i ]; cur && cur !== context; cur = cur.parentNode ) {
+
+					// Always skip document fragments
+					if ( cur.nodeType < 11 && ( targets ?
+						targets.index( cur ) > -1 :
+
+						// Don't pass non-elements to Sizzle
+						cur.nodeType === 1 &&
+							jQuery.find.matchesSelector( cur, selectors ) ) ) {
+
+						matched.push( cur );
+						break;
+					}
+				}
+			}
+		}
+
+		return this.pushStack( matched.length > 1 ? jQuery.uniqueSort( matched ) : matched );
+	},
+
+	// Determine the position of an element within the set
+	index: function( elem ) {
+
+		// No argument, return index in parent
+		if ( !elem ) {
+			return ( this[ 0 ] && this[ 0 ].parentNode ) ? this.first().prevAll().length : -1;
+		}
+
+		// Index in selector
+		if ( typeof elem === "string" ) {
+			return indexOf.call( jQuery( elem ), this[ 0 ] );
+		}
+
+		// Locate the position of the desired element
+		return indexOf.call( this,
+
+			// If it receives a jQuery object, the first element is used
+			elem.jquery ? elem[ 0 ] : elem
+		);
+	},
+
+	add: function( selector, context ) {
+		return this.pushStack(
+			jQuery.uniqueSort(
+				jQuery.merge( this.get(), jQuery( selector, context ) )
+			)
+		);
+	},
+
+	addBack: function( selector ) {
+		return this.add( selector == null ?
+			this.prevObject : this.prevObject.filter( selector )
+		);
+	}
+} );
+
+function sibling( cur, dir ) {
+	while ( ( cur = cur[ dir ] ) && cur.nodeType !== 1 ) {}
+	return cur;
+}
+
+jQuery.each( {
+	parent: function( elem ) {
+		var parent = elem.parentNode;
+		return parent && parent.nodeType !== 11 ? parent : null;
+	},
+	parents: function( elem ) {
+		return dir( elem, "parentNode" );
+	},
+	parentsUntil: function( elem, _i, until ) {
+		return dir( elem, "parentNode", until );
+	},
+	next: function( elem ) {
+		return sibling( elem, "nextSibling" );
+	},
+	prev: function( elem ) {
+		return sibling( elem, "previousSibling" );
+	},
+	nextAll: function( elem ) {
+		return dir( elem, "nextSibling" );
+	},
+	prevAll: function( elem ) {
+		return dir( elem, "previousSibling" );
+	},
+	nextUntil: function( elem, _i, until ) {
+		return dir( elem, "nextSibling", until );
+	},
+	prevUntil: function( elem, _i, until ) {
+		return dir( elem, "previousSibling", until );
+	},
+	siblings: function( elem ) {
+		return siblings( ( elem.parentNode || {} ).firstChild, elem );
+	},
+	children: function( elem ) {
+		return siblings( elem.firstChild );
+	},
+	contents: function( elem ) {
+		if ( elem.contentDocument != null &&
+
+			// Support: IE 11+
+			//  elements with no `data` attribute has an object
+			// `contentDocument` with a `null` prototype.
+			getProto( elem.contentDocument ) ) {
+
+			return elem.contentDocument;
+		}
+
+		// Support: IE 9 - 11 only, iOS 7 only, Android Browser <=4.3 only
+		// Treat the template element as a regular one in browsers that
+		// don't support it.
+		if ( nodeName( elem, "template" ) ) {
+			elem = elem.content || elem;
+		}
+
+		return jQuery.merge( [], elem.childNodes );
+	}
+}, function( name, fn ) {
+	jQuery.fn[ name ] = function( until, selector ) {
+		var matched = jQuery.map( this, fn, until );
+
+		if ( name.slice( -5 ) !== "Until" ) {
+			selector = until;
+		}
+
+		if ( selector && typeof selector === "string" ) {
+			matched = jQuery.filter( selector, matched );
+		}
+
+		if ( this.length > 1 ) {
+
+			// Remove duplicates
+			if ( !guaranteedUnique[ name ] ) {
+				jQuery.uniqueSort( matched );
+			}
+
+			// Reverse order for parents* and prev-derivatives
+			if ( rparentsprev.test( name ) ) {
+				matched.reverse();
+			}
+		}
+
+		return this.pushStack( matched );
+	};
+} );
+var rnothtmlwhite = ( /[^\x20\t\r\n\f]+/g );
+
+
+
+// Convert String-formatted options into Object-formatted ones
+function createOptions( options ) {
+	var object = {};
+	jQuery.each( options.match( rnothtmlwhite ) || [], function( _, flag ) {
+		object[ flag ] = true;
+	} );
+	return object;
+}
+
+/*
+ * Create a callback list using the following parameters:
+ *
+ *	options: an optional list of space-separated options that will change how
+ *			the callback list behaves or a more traditional option object
+ *
+ * By default a callback list will act like an event callback list and can be
+ * "fired" multiple times.
+ *
+ * Possible options:
+ *
+ *	once:			will ensure the callback list can only be fired once (like a Deferred)
+ *
+ *	memory:			will keep track of previous values and will call any callback added
+ *					after the list has been fired right away with the latest "memorized"
+ *					values (like a Deferred)
+ *
+ *	unique:			will ensure a callback can only be added once (no duplicate in the list)
+ *
+ *	stopOnFalse:	interrupt callings when a callback returns false
+ *
+ */
+jQuery.Callbacks = function( options ) {
+
+	// Convert options from String-formatted to Object-formatted if needed
+	// (we check in cache first)
+	options = typeof options === "string" ?
+		createOptions( options ) :
+		jQuery.extend( {}, options );
+
+	var // Flag to know if list is currently firing
+		firing,
+
+		// Last fire value for non-forgettable lists
+		memory,
+
+		// Flag to know if list was already fired
+		fired,
+
+		// Flag to prevent firing
+		locked,
+
+		// Actual callback list
+		list = [],
+
+		// Queue of execution data for repeatable lists
+		queue = [],
+
+		// Index of currently firing callback (modified by add/remove as needed)
+		firingIndex = -1,
+
+		// Fire callbacks
+		fire = function() {
+
+			// Enforce single-firing
+			locked = locked || options.once;
+
+			// Execute callbacks for all pending executions,
+			// respecting firingIndex overrides and runtime changes
+			fired = firing = true;
+			for ( ; queue.length; firingIndex = -1 ) {
+				memory = queue.shift();
+				while ( ++firingIndex < list.length ) {
+
+					// Run callback and check for early termination
+					if ( list[ firingIndex ].apply( memory[ 0 ], memory[ 1 ] ) === false &&
+						options.stopOnFalse ) {
+
+						// Jump to end and forget the data so .add doesn't re-fire
+						firingIndex = list.length;
+						memory = false;
+					}
+				}
+			}
+
+			// Forget the data if we're done with it
+			if ( !options.memory ) {
+				memory = false;
+			}
+
+			firing = false;
+
+			// Clean up if we're done firing for good
+			if ( locked ) {
+
+				// Keep an empty list if we have data for future add calls
+				if ( memory ) {
+					list = [];
+
+				// Otherwise, this object is spent
+				} else {
+					list = "";
+				}
+			}
+		},
+
+		// Actual Callbacks object
+		self = {
+
+			// Add a callback or a collection of callbacks to the list
+			add: function() {
+				if ( list ) {
+
+					// If we have memory from a past run, we should fire after adding
+					if ( memory && !firing ) {
+						firingIndex = list.length - 1;
+						queue.push( memory );
+					}
+
+					( function add( args ) {
+						jQuery.each( args, function( _, arg ) {
+							if ( isFunction( arg ) ) {
+								if ( !options.unique || !self.has( arg ) ) {
+									list.push( arg );
+								}
+							} else if ( arg && arg.length && toType( arg ) !== "string" ) {
+
+								// Inspect recursively
+								add( arg );
+							}
+						} );
+					} )( arguments );
+
+					if ( memory && !firing ) {
+						fire();
+					}
+				}
+				return this;
+			},
+
+			// Remove a callback from the list
+			remove: function() {
+				jQuery.each( arguments, function( _, arg ) {
+					var index;
+					while ( ( index = jQuery.inArray( arg, list, index ) ) > -1 ) {
+						list.splice( index, 1 );
+
+						// Handle firing indexes
+						if ( index <= firingIndex ) {
+							firingIndex--;
+						}
+					}
+				} );
+				return this;
+			},
+
+			// Check if a given callback is in the list.
+			// If no argument is given, return whether or not list has callbacks attached.
+			has: function( fn ) {
+				return fn ?
+					jQuery.inArray( fn, list ) > -1 :
+					list.length > 0;
+			},
+
+			// Remove all callbacks from the list
+			empty: function() {
+				if ( list ) {
+					list = [];
+				}
+				return this;
+			},
+
+			// Disable .fire and .add
+			// Abort any current/pending executions
+			// Clear all callbacks and values
+			disable: function() {
+				locked = queue = [];
+				list = memory = "";
+				return this;
+			},
+			disabled: function() {
+				return !list;
+			},
+
+			// Disable .fire
+			// Also disable .add unless we have memory (since it would have no effect)
+			// Abort any pending executions
+			lock: function() {
+				locked = queue = [];
+				if ( !memory && !firing ) {
+					list = memory = "";
+				}
+				return this;
+			},
+			locked: function() {
+				return !!locked;
+			},
+
+			// Call all callbacks with the given context and arguments
+			fireWith: function( context, args ) {
+				if ( !locked ) {
+					args = args || [];
+					args = [ context, args.slice ? args.slice() : args ];
+					queue.push( args );
+					if ( !firing ) {
+						fire();
+					}
+				}
+				return this;
+			},
+
+			// Call all the callbacks with the given arguments
+			fire: function() {
+				self.fireWith( this, arguments );
+				return this;
+			},
+
+			// To know if the callbacks have already been called at least once
+			fired: function() {
+				return !!fired;
+			}
+		};
+
+	return self;
+};
+
+
+function Identity( v ) {
+	return v;
+}
+function Thrower( ex ) {
+	throw ex;
+}
+
+function adoptValue( value, resolve, reject, noValue ) {
+	var method;
+
+	try {
+
+		// Check for promise aspect first to privilege synchronous behavior
+		if ( value && isFunction( ( method = value.promise ) ) ) {
+			method.call( value ).done( resolve ).fail( reject );
+
+		// Other thenables
+		} else if ( value && isFunction( ( method = value.then ) ) ) {
+			method.call( value, resolve, reject );
+
+		// Other non-thenables
+		} else {
+
+			// Control `resolve` arguments by letting Array#slice cast boolean `noValue` to integer:
+			// * false: [ value ].slice( 0 ) => resolve( value )
+			// * true: [ value ].slice( 1 ) => resolve()
+			resolve.apply( undefined, [ value ].slice( noValue ) );
+		}
+
+	// For Promises/A+, convert exceptions into rejections
+	// Since jQuery.when doesn't unwrap thenables, we can skip the extra checks appearing in
+	// Deferred#then to conditionally suppress rejection.
+	} catch ( value ) {
+
+		// Support: Android 4.0 only
+		// Strict mode functions invoked without .call/.apply get global-object context
+		reject.apply( undefined, [ value ] );
+	}
+}
+
+jQuery.extend( {
+
+	Deferred: function( func ) {
+		var tuples = [
+
+				// action, add listener, callbacks,
+				// ... .then handlers, argument index, [final state]
+				[ "notify", "progress", jQuery.Callbacks( "memory" ),
+					jQuery.Callbacks( "memory" ), 2 ],
+				[ "resolve", "done", jQuery.Callbacks( "once memory" ),
+					jQuery.Callbacks( "once memory" ), 0, "resolved" ],
+				[ "reject", "fail", jQuery.Callbacks( "once memory" ),
+					jQuery.Callbacks( "once memory" ), 1, "rejected" ]
+			],
+			state = "pending",
+			promise = {
+				state: function() {
+					return state;
+				},
+				always: function() {
+					deferred.done( arguments ).fail( arguments );
+					return this;
+				},
+				"catch": function( fn ) {
+					return promise.then( null, fn );
+				},
+
+				// Keep pipe for back-compat
+				pipe: function( /* fnDone, fnFail, fnProgress */ ) {
+					var fns = arguments;
+
+					return jQuery.Deferred( function( newDefer ) {
+						jQuery.each( tuples, function( _i, tuple ) {
+
+							// Map tuples (progress, done, fail) to arguments (done, fail, progress)
+							var fn = isFunction( fns[ tuple[ 4 ] ] ) && fns[ tuple[ 4 ] ];
+
+							// deferred.progress(function() { bind to newDefer or newDefer.notify })
+							// deferred.done(function() { bind to newDefer or newDefer.resolve })
+							// deferred.fail(function() { bind to newDefer or newDefer.reject })
+							deferred[ tuple[ 1 ] ]( function() {
+								var returned = fn && fn.apply( this, arguments );
+								if ( returned && isFunction( returned.promise ) ) {
+									returned.promise()
+										.progress( newDefer.notify )
+										.done( newDefer.resolve )
+										.fail( newDefer.reject );
+								} else {
+									newDefer[ tuple[ 0 ] + "With" ](
+										this,
+										fn ? [ returned ] : arguments
+									);
+								}
+							} );
+						} );
+						fns = null;
+					} ).promise();
+				},
+				then: function( onFulfilled, onRejected, onProgress ) {
+					var maxDepth = 0;
+					function resolve( depth, deferred, handler, special ) {
+						return function() {
+							var that = this,
+								args = arguments,
+								mightThrow = function() {
+									var returned, then;
+
+									// Support: Promises/A+ section 2.3.3.3.3
+									// https://promisesaplus.com/#point-59
+									// Ignore double-resolution attempts
+									if ( depth < maxDepth ) {
+										return;
+									}
+
+									returned = handler.apply( that, args );
+
+									// Support: Promises/A+ section 2.3.1
+									// https://promisesaplus.com/#point-48
+									if ( returned === deferred.promise() ) {
+										throw new TypeError( "Thenable self-resolution" );
+									}
+
+									// Support: Promises/A+ sections 2.3.3.1, 3.5
+									// https://promisesaplus.com/#point-54
+									// https://promisesaplus.com/#point-75
+									// Retrieve `then` only once
+									then = returned &&
+
+										// Support: Promises/A+ section 2.3.4
+										// https://promisesaplus.com/#point-64
+										// Only check objects and functions for thenability
+										( typeof returned === "object" ||
+											typeof returned === "function" ) &&
+										returned.then;
+
+									// Handle a returned thenable
+									if ( isFunction( then ) ) {
+
+										// Special processors (notify) just wait for resolution
+										if ( special ) {
+											then.call(
+												returned,
+												resolve( maxDepth, deferred, Identity, special ),
+												resolve( maxDepth, deferred, Thrower, special )
+											);
+
+										// Normal processors (resolve) also hook into progress
+										} else {
+
+											// ...and disregard older resolution values
+											maxDepth++;
+
+											then.call(
+												returned,
+												resolve( maxDepth, deferred, Identity, special ),
+												resolve( maxDepth, deferred, Thrower, special ),
+												resolve( maxDepth, deferred, Identity,
+													deferred.notifyWith )
+											);
+										}
+
+									// Handle all other returned values
+									} else {
+
+										// Only substitute handlers pass on context
+										// and multiple values (non-spec behavior)
+										if ( handler !== Identity ) {
+											that = undefined;
+											args = [ returned ];
+										}
+
+										// Process the value(s)
+										// Default process is resolve
+										( special || deferred.resolveWith )( that, args );
+									}
+								},
+
+								// Only normal processors (resolve) catch and reject exceptions
+								process = special ?
+									mightThrow :
+									function() {
+										try {
+											mightThrow();
+										} catch ( e ) {
+
+											if ( jQuery.Deferred.exceptionHook ) {
+												jQuery.Deferred.exceptionHook( e,
+													process.stackTrace );
+											}
+
+											// Support: Promises/A+ section 2.3.3.3.4.1
+											// https://promisesaplus.com/#point-61
+											// Ignore post-resolution exceptions
+											if ( depth + 1 >= maxDepth ) {
+
+												// Only substitute handlers pass on context
+												// and multiple values (non-spec behavior)
+												if ( handler !== Thrower ) {
+													that = undefined;
+													args = [ e ];
+												}
+
+												deferred.rejectWith( that, args );
+											}
+										}
+									};
+
+							// Support: Promises/A+ section 2.3.3.3.1
+							// https://promisesaplus.com/#point-57
+							// Re-resolve promises immediately to dodge false rejection from
+							// subsequent errors
+							if ( depth ) {
+								process();
+							} else {
+
+								// Call an optional hook to record the stack, in case of exception
+								// since it's otherwise lost when execution goes async
+								if ( jQuery.Deferred.getStackHook ) {
+									process.stackTrace = jQuery.Deferred.getStackHook();
+								}
+								window.setTimeout( process );
+							}
+						};
+					}
+
+					return jQuery.Deferred( function( newDefer ) {
+
+						// progress_handlers.add( ... )
+						tuples[ 0 ][ 3 ].add(
+							resolve(
+								0,
+								newDefer,
+								isFunction( onProgress ) ?
+									onProgress :
+									Identity,
+								newDefer.notifyWith
+							)
+						);
+
+						// fulfilled_handlers.add( ... )
+						tuples[ 1 ][ 3 ].add(
+							resolve(
+								0,
+								newDefer,
+								isFunction( onFulfilled ) ?
+									onFulfilled :
+									Identity
+							)
+						);
+
+						// rejected_handlers.add( ... )
+						tuples[ 2 ][ 3 ].add(
+							resolve(
+								0,
+								newDefer,
+								isFunction( onRejected ) ?
+									onRejected :
+									Thrower
+							)
+						);
+					} ).promise();
+				},
+
+				// Get a promise for this deferred
+				// If obj is provided, the promise aspect is added to the object
+				promise: function( obj ) {
+					return obj != null ? jQuery.extend( obj, promise ) : promise;
+				}
+			},
+			deferred = {};
+
+		// Add list-specific methods
+		jQuery.each( tuples, function( i, tuple ) {
+			var list = tuple[ 2 ],
+				stateString = tuple[ 5 ];
+
+			// promise.progress = list.add
+			// promise.done = list.add
+			// promise.fail = list.add
+			promise[ tuple[ 1 ] ] = list.add;
+
+			// Handle state
+			if ( stateString ) {
+				list.add(
+					function() {
+
+						// state = "resolved" (i.e., fulfilled)
+						// state = "rejected"
+						state = stateString;
+					},
+
+					// rejected_callbacks.disable
+					// fulfilled_callbacks.disable
+					tuples[ 3 - i ][ 2 ].disable,
+
+					// rejected_handlers.disable
+					// fulfilled_handlers.disable
+					tuples[ 3 - i ][ 3 ].disable,
+
+					// progress_callbacks.lock
+					tuples[ 0 ][ 2 ].lock,
+
+					// progress_handlers.lock
+					tuples[ 0 ][ 3 ].lock
+				);
+			}
+
+			// progress_handlers.fire
+			// fulfilled_handlers.fire
+			// rejected_handlers.fire
+			list.add( tuple[ 3 ].fire );
+
+			// deferred.notify = function() { deferred.notifyWith(...) }
+			// deferred.resolve = function() { deferred.resolveWith(...) }
+			// deferred.reject = function() { deferred.rejectWith(...) }
+			deferred[ tuple[ 0 ] ] = function() {
+				deferred[ tuple[ 0 ] + "With" ]( this === deferred ? undefined : this, arguments );
+				return this;
+			};
+
+			// deferred.notifyWith = list.fireWith
+			// deferred.resolveWith = list.fireWith
+			// deferred.rejectWith = list.fireWith
+			deferred[ tuple[ 0 ] + "With" ] = list.fireWith;
+		} );
+
+		// Make the deferred a promise
+		promise.promise( deferred );
+
+		// Call given func if any
+		if ( func ) {
+			func.call( deferred, deferred );
+		}
+
+		// All done!
+		return deferred;
+	},
+
+	// Deferred helper
+	when: function( singleValue ) {
+		var
+
+			// count of uncompleted subordinates
+			remaining = arguments.length,
+
+			// count of unprocessed arguments
+			i = remaining,
+
+			// subordinate fulfillment data
+			resolveContexts = Array( i ),
+			resolveValues = slice.call( arguments ),
+
+			// the primary Deferred
+			primary = jQuery.Deferred(),
+
+			// subordinate callback factory
+			updateFunc = function( i ) {
+				return function( value ) {
+					resolveContexts[ i ] = this;
+					resolveValues[ i ] = arguments.length > 1 ? slice.call( arguments ) : value;
+					if ( !( --remaining ) ) {
+						primary.resolveWith( resolveContexts, resolveValues );
+					}
+				};
+			};
+
+		// Single- and empty arguments are adopted like Promise.resolve
+		if ( remaining <= 1 ) {
+			adoptValue( singleValue, primary.done( updateFunc( i ) ).resolve, primary.reject,
+				!remaining );
+
+			// Use .then() to unwrap secondary thenables (cf. gh-3000)
+			if ( primary.state() === "pending" ||
+				isFunction( resolveValues[ i ] && resolveValues[ i ].then ) ) {
+
+				return primary.then();
+			}
+		}
+
+		// Multiple arguments are aggregated like Promise.all array elements
+		while ( i-- ) {
+			adoptValue( resolveValues[ i ], updateFunc( i ), primary.reject );
+		}
+
+		return primary.promise();
+	}
+} );
+
+
+// These usually indicate a programmer mistake during development,
+// warn about them ASAP rather than swallowing them by default.
+var rerrorNames = /^(Eval|Internal|Range|Reference|Syntax|Type|URI)Error$/;
+
+jQuery.Deferred.exceptionHook = function( error, stack ) {
+
+	// Support: IE 8 - 9 only
+	// Console exists when dev tools are open, which can happen at any time
+	if ( window.console && window.console.warn && error && rerrorNames.test( error.name ) ) {
+		window.console.warn( "jQuery.Deferred exception: " + error.message, error.stack, stack );
+	}
+};
+
+
+
+
+jQuery.readyException = function( error ) {
+	window.setTimeout( function() {
+		throw error;
+	} );
+};
+
+
+
+
+// The deferred used on DOM ready
+var readyList = jQuery.Deferred();
+
+jQuery.fn.ready = function( fn ) {
+
+	readyList
+		.then( fn )
+
+		// Wrap jQuery.readyException in a function so that the lookup
+		// happens at the time of error handling instead of callback
+		// registration.
+		.catch( function( error ) {
+			jQuery.readyException( error );
+		} );
+
+	return this;
+};
+
+jQuery.extend( {
+
+	// Is the DOM ready to be used? Set to true once it occurs.
+	isReady: false,
+
+	// A counter to track how many items to wait for before
+	// the ready event fires. See #6781
+	readyWait: 1,
+
+	// Handle when the DOM is ready
+	ready: function( wait ) {
+
+		// Abort if there are pending holds or we're already ready
+		if ( wait === true ? --jQuery.readyWait : jQuery.isReady ) {
+			return;
+		}
+
+		// Remember that the DOM is ready
+		jQuery.isReady = true;
+
+		// If a normal DOM Ready event fired, decrement, and wait if need be
+		if ( wait !== true && --jQuery.readyWait > 0 ) {
+			return;
+		}
+
+		// If there are functions bound, to execute
+		readyList.resolveWith( document, [ jQuery ] );
+	}
+} );
+
+jQuery.ready.then = readyList.then;
+
+// The ready event handler and self cleanup method
+function completed() {
+	document.removeEventListener( "DOMContentLoaded", completed );
+	window.removeEventListener( "load", completed );
+	jQuery.ready();
+}
+
+// Catch cases where $(document).ready() is called
+// after the browser event has already occurred.
+// Support: IE <=9 - 10 only
+// Older IE sometimes signals "interactive" too soon
+if ( document.readyState === "complete" ||
+	( document.readyState !== "loading" && !document.documentElement.doScroll ) ) {
+
+	// Handle it asynchronously to allow scripts the opportunity to delay ready
+	window.setTimeout( jQuery.ready );
+
+} else {
+
+	// Use the handy event callback
+	document.addEventListener( "DOMContentLoaded", completed );
+
+	// A fallback to window.onload, that will always work
+	window.addEventListener( "load", completed );
+}
+
+
+
+
+// Multifunctional method to get and set values of a collection
+// The value/s can optionally be executed if it's a function
+var access = function( elems, fn, key, value, chainable, emptyGet, raw ) {
+	var i = 0,
+		len = elems.length,
+		bulk = key == null;
+
+	// Sets many values
+	if ( toType( key ) === "object" ) {
+		chainable = true;
+		for ( i in key ) {
+			access( elems, fn, i, key[ i ], true, emptyGet, raw );
+		}
+
+	// Sets one value
+	} else if ( value !== undefined ) {
+		chainable = true;
+
+		if ( !isFunction( value ) ) {
+			raw = true;
+		}
+
+		if ( bulk ) {
+
+			// Bulk operations run against the entire set
+			if ( raw ) {
+				fn.call( elems, value );
+				fn = null;
+
+			// ...except when executing function values
+			} else {
+				bulk = fn;
+				fn = function( elem, _key, value ) {
+					return bulk.call( jQuery( elem ), value );
+				};
+			}
+		}
+
+		if ( fn ) {
+			for ( ; i < len; i++ ) {
+				fn(
+					elems[ i ], key, raw ?
+						value :
+						value.call( elems[ i ], i, fn( elems[ i ], key ) )
+				);
+			}
+		}
+	}
+
+	if ( chainable ) {
+		return elems;
+	}
+
+	// Gets
+	if ( bulk ) {
+		return fn.call( elems );
+	}
+
+	return len ? fn( elems[ 0 ], key ) : emptyGet;
+};
+
+
+// Matches dashed string for camelizing
+var rmsPrefix = /^-ms-/,
+	rdashAlpha = /-([a-z])/g;
+
+// Used by camelCase as callback to replace()
+function fcamelCase( _all, letter ) {
+	return letter.toUpperCase();
+}
+
+// Convert dashed to camelCase; used by the css and data modules
+// Support: IE <=9 - 11, Edge 12 - 15
+// Microsoft forgot to hump their vendor prefix (#9572)
+function camelCase( string ) {
+	return string.replace( rmsPrefix, "ms-" ).replace( rdashAlpha, fcamelCase );
+}
+var acceptData = function( owner ) {
+
+	// Accepts only:
+	//  - Node
+	//    - Node.ELEMENT_NODE
+	//    - Node.DOCUMENT_NODE
+	//  - Object
+	//    - Any
+	return owner.nodeType === 1 || owner.nodeType === 9 || !( +owner.nodeType );
+};
+
+
+
+
+function Data() {
+	this.expando = jQuery.expando + Data.uid++;
+}
+
+Data.uid = 1;
+
+Data.prototype = {
+
+	cache: function( owner ) {
+
+		// Check if the owner object already has a cache
+		var value = owner[ this.expando ];
+
+		// If not, create one
+		if ( !value ) {
+			value = {};
+
+			// We can accept data for non-element nodes in modern browsers,
+			// but we should not, see #8335.
+			// Always return an empty object.
+			if ( acceptData( owner ) ) {
+
+				// If it is a node unlikely to be stringify-ed or looped over
+				// use plain assignment
+				if ( owner.nodeType ) {
+					owner[ this.expando ] = value;
+
+				// Otherwise secure it in a non-enumerable property
+				// configurable must be true to allow the property to be
+				// deleted when data is removed
+				} else {
+					Object.defineProperty( owner, this.expando, {
+						value: value,
+						configurable: true
+					} );
+				}
+			}
+		}
+
+		return value;
+	},
+	set: function( owner, data, value ) {
+		var prop,
+			cache = this.cache( owner );
+
+		// Handle: [ owner, key, value ] args
+		// Always use camelCase key (gh-2257)
+		if ( typeof data === "string" ) {
+			cache[ camelCase( data ) ] = value;
+
+		// Handle: [ owner, { properties } ] args
+		} else {
+
+			// Copy the properties one-by-one to the cache object
+			for ( prop in data ) {
+				cache[ camelCase( prop ) ] = data[ prop ];
+			}
+		}
+		return cache;
+	},
+	get: function( owner, key ) {
+		return key === undefined ?
+			this.cache( owner ) :
+
+			// Always use camelCase key (gh-2257)
+			owner[ this.expando ] && owner[ this.expando ][ camelCase( key ) ];
+	},
+	access: function( owner, key, value ) {
+
+		// In cases where either:
+		//
+		//   1. No key was specified
+		//   2. A string key was specified, but no value provided
+		//
+		// Take the "read" path and allow the get method to determine
+		// which value to return, respectively either:
+		//
+		//   1. The entire cache object
+		//   2. The data stored at the key
+		//
+		if ( key === undefined ||
+				( ( key && typeof key === "string" ) && value === undefined ) ) {
+
+			return this.get( owner, key );
+		}
+
+		// When the key is not a string, or both a key and value
+		// are specified, set or extend (existing objects) with either:
+		//
+		//   1. An object of properties
+		//   2. A key and value
+		//
+		this.set( owner, key, value );
+
+		// Since the "set" path can have two possible entry points
+		// return the expected data based on which path was taken[*]
+		return value !== undefined ? value : key;
+	},
+	remove: function( owner, key ) {
+		var i,
+			cache = owner[ this.expando ];
+
+		if ( cache === undefined ) {
+			return;
+		}
+
+		if ( key !== undefined ) {
+
+			// Support array or space separated string of keys
+			if ( Array.isArray( key ) ) {
+
+				// If key is an array of keys...
+				// We always set camelCase keys, so remove that.
+				key = key.map( camelCase );
+			} else {
+				key = camelCase( key );
+
+				// If a key with the spaces exists, use it.
+				// Otherwise, create an array by matching non-whitespace
+				key = key in cache ?
+					[ key ] :
+					( key.match( rnothtmlwhite ) || [] );
+			}
+
+			i = key.length;
+
+			while ( i-- ) {
+				delete cache[ key[ i ] ];
+			}
+		}
+
+		// Remove the expando if there's no more data
+		if ( key === undefined || jQuery.isEmptyObject( cache ) ) {
+
+			// Support: Chrome <=35 - 45
+			// Webkit & Blink performance suffers when deleting properties
+			// from DOM nodes, so set to undefined instead
+			// https://bugs.chromium.org/p/chromium/issues/detail?id=378607 (bug restricted)
+			if ( owner.nodeType ) {
+				owner[ this.expando ] = undefined;
+			} else {
+				delete owner[ this.expando ];
+			}
+		}
+	},
+	hasData: function( owner ) {
+		var cache = owner[ this.expando ];
+		return cache !== undefined && !jQuery.isEmptyObject( cache );
+	}
+};
+var dataPriv = new Data();
+
+var dataUser = new Data();
+
+
+
+//	Implementation Summary
+//
+//	1. Enforce API surface and semantic compatibility with 1.9.x branch
+//	2. Improve the module's maintainability by reducing the storage
+//		paths to a single mechanism.
+//	3. Use the same single mechanism to support "private" and "user" data.
+//	4. _Never_ expose "private" data to user code (TODO: Drop _data, _removeData)
+//	5. Avoid exposing implementation details on user objects (eg. expando properties)
+//	6. Provide a clear path for implementation upgrade to WeakMap in 2014
+
+var rbrace = /^(?:\{[\w\W]*\}|\[[\w\W]*\])$/,
+	rmultiDash = /[A-Z]/g;
+
+function getData( data ) {
+	if ( data === "true" ) {
+		return true;
+	}
+
+	if ( data === "false" ) {
+		return false;
+	}
+
+	if ( data === "null" ) {
+		return null;
+	}
+
+	// Only convert to a number if it doesn't change the string
+	if ( data === +data + "" ) {
+		return +data;
+	}
+
+	if ( rbrace.test( data ) ) {
+		return JSON.parse( data );
+	}
+
+	return data;
+}
+
+function dataAttr( elem, key, data ) {
+	var name;
+
+	// If nothing was found internally, try to fetch any
+	// data from the HTML5 data-* attribute
+	if ( data === undefined && elem.nodeType === 1 ) {
+		name = "data-" + key.replace( rmultiDash, "-$&" ).toLowerCase();
+		data = elem.getAttribute( name );
+
+		if ( typeof data === "string" ) {
+			try {
+				data = getData( data );
+			} catch ( e ) {}
+
+			// Make sure we set the data so it isn't changed later
+			dataUser.set( elem, key, data );
+		} else {
+			data = undefined;
+		}
+	}
+	return data;
+}
+
+jQuery.extend( {
+	hasData: function( elem ) {
+		return dataUser.hasData( elem ) || dataPriv.hasData( elem );
+	},
+
+	data: function( elem, name, data ) {
+		return dataUser.access( elem, name, data );
+	},
+
+	removeData: function( elem, name ) {
+		dataUser.remove( elem, name );
+	},
+
+	// TODO: Now that all calls to _data and _removeData have been replaced
+	// with direct calls to dataPriv methods, these can be deprecated.
+	_data: function( elem, name, data ) {
+		return dataPriv.access( elem, name, data );
+	},
+
+	_removeData: function( elem, name ) {
+		dataPriv.remove( elem, name );
+	}
+} );
+
+jQuery.fn.extend( {
+	data: function( key, value ) {
+		var i, name, data,
+			elem = this[ 0 ],
+			attrs = elem && elem.attributes;
+
+		// Gets all values
+		if ( key === undefined ) {
+			if ( this.length ) {
+				data = dataUser.get( elem );
+
+				if ( elem.nodeType === 1 && !dataPriv.get( elem, "hasDataAttrs" ) ) {
+					i = attrs.length;
+					while ( i-- ) {
+
+						// Support: IE 11 only
+						// The attrs elements can be null (#14894)
+						if ( attrs[ i ] ) {
+							name = attrs[ i ].name;
+							if ( name.indexOf( "data-" ) === 0 ) {
+								name = camelCase( name.slice( 5 ) );
+								dataAttr( elem, name, data[ name ] );
+							}
+						}
+					}
+					dataPriv.set( elem, "hasDataAttrs", true );
+				}
+			}
+
+			return data;
+		}
+
+		// Sets multiple values
+		if ( typeof key === "object" ) {
+			return this.each( function() {
+				dataUser.set( this, key );
+			} );
+		}
+
+		return access( this, function( value ) {
+			var data;
+
+			// The calling jQuery object (element matches) is not empty
+			// (and therefore has an element appears at this[ 0 ]) and the
+			// `value` parameter was not undefined. An empty jQuery object
+			// will result in `undefined` for elem = this[ 0 ] which will
+			// throw an exception if an attempt to read a data cache is made.
+			if ( elem && value === undefined ) {
+
+				// Attempt to get data from the cache
+				// The key will always be camelCased in Data
+				data = dataUser.get( elem, key );
+				if ( data !== undefined ) {
+					return data;
+				}
+
+				// Attempt to "discover" the data in
+				// HTML5 custom data-* attrs
+				data = dataAttr( elem, key );
+				if ( data !== undefined ) {
+					return data;
+				}
+
+				// We tried really hard, but the data doesn't exist.
+				return;
+			}
+
+			// Set the data...
+			this.each( function() {
+
+				// We always store the camelCased key
+				dataUser.set( this, key, value );
+			} );
+		}, null, value, arguments.length > 1, null, true );
+	},
+
+	removeData: function( key ) {
+		return this.each( function() {
+			dataUser.remove( this, key );
+		} );
+	}
+} );
+
+
+jQuery.extend( {
+	queue: function( elem, type, data ) {
+		var queue;
+
+		if ( elem ) {
+			type = ( type || "fx" ) + "queue";
+			queue = dataPriv.get( elem, type );
+
+			// Speed up dequeue by getting out quickly if this is just a lookup
+			if ( data ) {
+				if ( !queue || Array.isArray( data ) ) {
+					queue = dataPriv.access( elem, type, jQuery.makeArray( data ) );
+				} else {
+					queue.push( data );
+				}
+			}
+			return queue || [];
+		}
+	},
+
+	dequeue: function( elem, type ) {
+		type = type || "fx";
+
+		var queue = jQuery.queue( elem, type ),
+			startLength = queue.length,
+			fn = queue.shift(),
+			hooks = jQuery._queueHooks( elem, type ),
+			next = function() {
+				jQuery.dequeue( elem, type );
+			};
+
+		// If the fx queue is dequeued, always remove the progress sentinel
+		if ( fn === "inprogress" ) {
+			fn = queue.shift();
+			startLength--;
+		}
+
+		if ( fn ) {
+
+			// Add a progress sentinel to prevent the fx queue from being
+			// automatically dequeued
+			if ( type === "fx" ) {
+				queue.unshift( "inprogress" );
+			}
+
+			// Clear up the last queue stop function
+			delete hooks.stop;
+			fn.call( elem, next, hooks );
+		}
+
+		if ( !startLength && hooks ) {
+			hooks.empty.fire();
+		}
+	},
+
+	// Not public - generate a queueHooks object, or return the current one
+	_queueHooks: function( elem, type ) {
+		var key = type + "queueHooks";
+		return dataPriv.get( elem, key ) || dataPriv.access( elem, key, {
+			empty: jQuery.Callbacks( "once memory" ).add( function() {
+				dataPriv.remove( elem, [ type + "queue", key ] );
+			} )
+		} );
+	}
+} );
+
+jQuery.fn.extend( {
+	queue: function( type, data ) {
+		var setter = 2;
+
+		if ( typeof type !== "string" ) {
+			data = type;
+			type = "fx";
+			setter--;
+		}
+
+		if ( arguments.length < setter ) {
+			return jQuery.queue( this[ 0 ], type );
+		}
+
+		return data === undefined ?
+			this :
+			this.each( function() {
+				var queue = jQuery.queue( this, type, data );
+
+				// Ensure a hooks for this queue
+				jQuery._queueHooks( this, type );
+
+				if ( type === "fx" && queue[ 0 ] !== "inprogress" ) {
+					jQuery.dequeue( this, type );
+				}
+			} );
+	},
+	dequeue: function( type ) {
+		return this.each( function() {
+			jQuery.dequeue( this, type );
+		} );
+	},
+	clearQueue: function( type ) {
+		return this.queue( type || "fx", [] );
+	},
+
+	// Get a promise resolved when queues of a certain type
+	// are emptied (fx is the type by default)
+	promise: function( type, obj ) {
+		var tmp,
+			count = 1,
+			defer = jQuery.Deferred(),
+			elements = this,
+			i = this.length,
+			resolve = function() {
+				if ( !( --count ) ) {
+					defer.resolveWith( elements, [ elements ] );
+				}
+			};
+
+		if ( typeof type !== "string" ) {
+			obj = type;
+			type = undefined;
+		}
+		type = type || "fx";
+
+		while ( i-- ) {
+			tmp = dataPriv.get( elements[ i ], type + "queueHooks" );
+			if ( tmp && tmp.empty ) {
+				count++;
+				tmp.empty.add( resolve );
+			}
+		}
+		resolve();
+		return defer.promise( obj );
+	}
+} );
+var pnum = ( /[+-]?(?:\d*\.|)\d+(?:[eE][+-]?\d+|)/ ).source;
+
+var rcssNum = new RegExp( "^(?:([+-])=|)(" + pnum + ")([a-z%]*)$", "i" );
+
+
+var cssExpand = [ "Top", "Right", "Bottom", "Left" ];
+
+var documentElement = document.documentElement;
+
+
+
+	var isAttached = function( elem ) {
+			return jQuery.contains( elem.ownerDocument, elem );
+		},
+		composed = { composed: true };
+
+	// Support: IE 9 - 11+, Edge 12 - 18+, iOS 10.0 - 10.2 only
+	// Check attachment across shadow DOM boundaries when possible (gh-3504)
+	// Support: iOS 10.0-10.2 only
+	// Early iOS 10 versions support `attachShadow` but not `getRootNode`,
+	// leading to errors. We need to check for `getRootNode`.
+	if ( documentElement.getRootNode ) {
+		isAttached = function( elem ) {
+			return jQuery.contains( elem.ownerDocument, elem ) ||
+				elem.getRootNode( composed ) === elem.ownerDocument;
+		};
+	}
+var isHiddenWithinTree = function( elem, el ) {
+
+		// isHiddenWithinTree might be called from jQuery#filter function;
+		// in that case, element will be second argument
+		elem = el || elem;
+
+		// Inline style trumps all
+		return elem.style.display === "none" ||
+			elem.style.display === "" &&
+
+			// Otherwise, check computed style
+			// Support: Firefox <=43 - 45
+			// Disconnected elements can have computed display: none, so first confirm that elem is
+			// in the document.
+			isAttached( elem ) &&
+
+			jQuery.css( elem, "display" ) === "none";
+	};
+
+
+
+function adjustCSS( elem, prop, valueParts, tween ) {
+	var adjusted, scale,
+		maxIterations = 20,
+		currentValue = tween ?
+			function() {
+				return tween.cur();
+			} :
+			function() {
+				return jQuery.css( elem, prop, "" );
+			},
+		initial = currentValue(),
+		unit = valueParts && valueParts[ 3 ] || ( jQuery.cssNumber[ prop ] ? "" : "px" ),
+
+		// Starting value computation is required for potential unit mismatches
+		initialInUnit = elem.nodeType &&
+			( jQuery.cssNumber[ prop ] || unit !== "px" && +initial ) &&
+			rcssNum.exec( jQuery.css( elem, prop ) );
+
+	if ( initialInUnit && initialInUnit[ 3 ] !== unit ) {
+
+		// Support: Firefox <=54
+		// Halve the iteration target value to prevent interference from CSS upper bounds (gh-2144)
+		initial = initial / 2;
+
+		// Trust units reported by jQuery.css
+		unit = unit || initialInUnit[ 3 ];
+
+		// Iteratively approximate from a nonzero starting point
+		initialInUnit = +initial || 1;
+
+		while ( maxIterations-- ) {
+
+			// Evaluate and update our best guess (doubling guesses that zero out).
+			// Finish if the scale equals or crosses 1 (making the old*new product non-positive).
+			jQuery.style( elem, prop, initialInUnit + unit );
+			if ( ( 1 - scale ) * ( 1 - ( scale = currentValue() / initial || 0.5 ) ) <= 0 ) {
+				maxIterations = 0;
+			}
+			initialInUnit = initialInUnit / scale;
+
+		}
+
+		initialInUnit = initialInUnit * 2;
+		jQuery.style( elem, prop, initialInUnit + unit );
+
+		// Make sure we update the tween properties later on
+		valueParts = valueParts || [];
+	}
+
+	if ( valueParts ) {
+		initialInUnit = +initialInUnit || +initial || 0;
+
+		// Apply relative offset (+=/-=) if specified
+		adjusted = valueParts[ 1 ] ?
+			initialInUnit + ( valueParts[ 1 ] + 1 ) * valueParts[ 2 ] :
+			+valueParts[ 2 ];
+		if ( tween ) {
+			tween.unit = unit;
+			tween.start = initialInUnit;
+			tween.end = adjusted;
+		}
+	}
+	return adjusted;
+}
+
+
+var defaultDisplayMap = {};
+
+function getDefaultDisplay( elem ) {
+	var temp,
+		doc = elem.ownerDocument,
+		nodeName = elem.nodeName,
+		display = defaultDisplayMap[ nodeName ];
+
+	if ( display ) {
+		return display;
+	}
+
+	temp = doc.body.appendChild( doc.createElement( nodeName ) );
+	display = jQuery.css( temp, "display" );
+
+	temp.parentNode.removeChild( temp );
+
+	if ( display === "none" ) {
+		display = "block";
+	}
+	defaultDisplayMap[ nodeName ] = display;
+
+	return display;
+}
+
+function showHide( elements, show ) {
+	var display, elem,
+		values = [],
+		index = 0,
+		length = elements.length;
+
+	// Determine new display value for elements that need to change
+	for ( ; index < length; index++ ) {
+		elem = elements[ index ];
+		if ( !elem.style ) {
+			continue;
+		}
+
+		display = elem.style.display;
+		if ( show ) {
+
+			// Since we force visibility upon cascade-hidden elements, an immediate (and slow)
+			// check is required in this first loop unless we have a nonempty display value (either
+			// inline or about-to-be-restored)
+			if ( display === "none" ) {
+				values[ index ] = dataPriv.get( elem, "display" ) || null;
+				if ( !values[ index ] ) {
+					elem.style.display = "";
+				}
+			}
+			if ( elem.style.display === "" && isHiddenWithinTree( elem ) ) {
+				values[ index ] = getDefaultDisplay( elem );
+			}
+		} else {
+			if ( display !== "none" ) {
+				values[ index ] = "none";
+
+				// Remember what we're overwriting
+				dataPriv.set( elem, "display", display );
+			}
+		}
+	}
+
+	// Set the display of the elements in a second loop to avoid constant reflow
+	for ( index = 0; index < length; index++ ) {
+		if ( values[ index ] != null ) {
+			elements[ index ].style.display = values[ index ];
+		}
+	}
+
+	return elements;
+}
+
+jQuery.fn.extend( {
+	show: function() {
+		return showHide( this, true );
+	},
+	hide: function() {
+		return showHide( this );
+	},
+	toggle: function( state ) {
+		if ( typeof state === "boolean" ) {
+			return state ? this.show() : this.hide();
+		}
+
+		return this.each( function() {
+			if ( isHiddenWithinTree( this ) ) {
+				jQuery( this ).show();
+			} else {
+				jQuery( this ).hide();
+			}
+		} );
+	}
+} );
+var rcheckableType = ( /^(?:checkbox|radio)$/i );
+
+var rtagName = ( /<([a-z][^\/\0>\x20\t\r\n\f]*)/i );
+
+var rscriptType = ( /^$|^module$|\/(?:java|ecma)script/i );
+
+
+
+( function() {
+	var fragment = document.createDocumentFragment(),
+		div = fragment.appendChild( document.createElement( "div" ) ),
+		input = document.createElement( "input" );
+
+	// Support: Android 4.0 - 4.3 only
+	// Check state lost if the name is set (#11217)
+	// Support: Windows Web Apps (WWA)
+	// `name` and `type` must use .setAttribute for WWA (#14901)
+	input.setAttribute( "type", "radio" );
+	input.setAttribute( "checked", "checked" );
+	input.setAttribute( "name", "t" );
+
+	div.appendChild( input );
+
+	// Support: Android <=4.1 only
+	// Older WebKit doesn't clone checked state correctly in fragments
+	support.checkClone = div.cloneNode( true ).cloneNode( true ).lastChild.checked;
+
+	// Support: IE <=11 only
+	// Make sure textarea (and checkbox) defaultValue is properly cloned
+	div.innerHTML = "";
+	support.noCloneChecked = !!div.cloneNode( true ).lastChild.defaultValue;
+
+	// Support: IE <=9 only
+	// IE <=9 replaces ";
+	support.option = !!div.lastChild;
+} )();
+
+
+// We have to close these tags to support XHTML (#13200)
+var wrapMap = {
+
+	// XHTML parsers do not magically insert elements in the
+	// same way that tag soup parsers do. So we cannot shorten
+	// this by omitting  or other required elements.
+	thead: [ 1, "", "
" ],
+	col: [ 2, "", "
" ],
+	tr: [ 2, "", "
" ],
+	td: [ 3, "", "
" ],
+
+	_default: [ 0, "", "" ]
+};
+
+wrapMap.tbody = wrapMap.tfoot = wrapMap.colgroup = wrapMap.caption = wrapMap.thead;
+wrapMap.th = wrapMap.td;
+
+// Support: IE <=9 only
+if ( !support.option ) {
+	wrapMap.optgroup = wrapMap.option = [ 1, "" ];
+}
+
+
+function getAll( context, tag ) {
+
+	// Support: IE <=9 - 11 only
+	// Use typeof to avoid zero-argument method invocation on host objects (#15151)
+	var ret;
+
+	if ( typeof context.getElementsByTagName !== "undefined" ) {
+		ret = context.getElementsByTagName( tag || "*" );
+
+	} else if ( typeof context.querySelectorAll !== "undefined" ) {
+		ret = context.querySelectorAll( tag || "*" );
+
+	} else {
+		ret = [];
+	}
+
+	if ( tag === undefined || tag && nodeName( context, tag ) ) {
+		return jQuery.merge( [ context ], ret );
+	}
+
+	return ret;
+}
+
+
+// Mark scripts as having already been evaluated
+function setGlobalEval( elems, refElements ) {
+	var i = 0,
+		l = elems.length;
+
+	for ( ; i < l; i++ ) {
+		dataPriv.set(
+			elems[ i ],
+			"globalEval",
+			!refElements || dataPriv.get( refElements[ i ], "globalEval" )
+		);
+	}
+}
+
+
+var rhtml = /<|&#?\w+;/;
+
+function buildFragment( elems, context, scripts, selection, ignored ) {
+	var elem, tmp, tag, wrap, attached, j,
+		fragment = context.createDocumentFragment(),
+		nodes = [],
+		i = 0,
+		l = elems.length;
+
+	for ( ; i < l; i++ ) {
+		elem = elems[ i ];
+
+		if ( elem || elem === 0 ) {
+
+			// Add nodes directly
+			if ( toType( elem ) === "object" ) {
+
+				// Support: Android <=4.0 only, PhantomJS 1 only
+				// push.apply(_, arraylike) throws on ancient WebKit
+				jQuery.merge( nodes, elem.nodeType ? [ elem ] : elem );
+
+			// Convert non-html into a text node
+			} else if ( !rhtml.test( elem ) ) {
+				nodes.push( context.createTextNode( elem ) );
+
+			// Convert html into DOM nodes
+			} else {
+				tmp = tmp || fragment.appendChild( context.createElement( "div" ) );
+
+				// Deserialize a standard representation
+				tag = ( rtagName.exec( elem ) || [ "", "" ] )[ 1 ].toLowerCase();
+				wrap = wrapMap[ tag ] || wrapMap._default;
+				tmp.innerHTML = wrap[ 1 ] + jQuery.htmlPrefilter( elem ) + wrap[ 2 ];
+
+				// Descend through wrappers to the right content
+				j = wrap[ 0 ];
+				while ( j-- ) {
+					tmp = tmp.lastChild;
+				}
+
+				// Support: Android <=4.0 only, PhantomJS 1 only
+				// push.apply(_, arraylike) throws on ancient WebKit
+				jQuery.merge( nodes, tmp.childNodes );
+
+				// Remember the top-level container
+				tmp = fragment.firstChild;
+
+				// Ensure the created nodes are orphaned (#12392)
+				tmp.textContent = "";
+			}
+		}
+	}
+
+	// Remove wrapper from fragment
+	fragment.textContent = "";
+
+	i = 0;
+	while ( ( elem = nodes[ i++ ] ) ) {
+
+		// Skip elements already in the context collection (trac-4087)
+		if ( selection && jQuery.inArray( elem, selection ) > -1 ) {
+			if ( ignored ) {
+				ignored.push( elem );
+			}
+			continue;
+		}
+
+		attached = isAttached( elem );
+
+		// Append to fragment
+		tmp = getAll( fragment.appendChild( elem ), "script" );
+
+		// Preserve script evaluation history
+		if ( attached ) {
+			setGlobalEval( tmp );
+		}
+
+		// Capture executables
+		if ( scripts ) {
+			j = 0;
+			while ( ( elem = tmp[ j++ ] ) ) {
+				if ( rscriptType.test( elem.type || "" ) ) {
+					scripts.push( elem );
+				}
+			}
+		}
+	}
+
+	return fragment;
+}
+
+
+var rtypenamespace = /^([^.]*)(?:\.(.+)|)/;
+
+function returnTrue() {
+	return true;
+}
+
+function returnFalse() {
+	return false;
+}
+
+// Support: IE <=9 - 11+
+// focus() and blur() are asynchronous, except when they are no-op.
+// So expect focus to be synchronous when the element is already active,
+// and blur to be synchronous when the element is not already active.
+// (focus and blur are always synchronous in other supported browsers,
+// this just defines when we can count on it).
+function expectSync( elem, type ) {
+	return ( elem === safeActiveElement() ) === ( type === "focus" );
+}
+
+// Support: IE <=9 only
+// Accessing document.activeElement can throw unexpectedly
+// https://bugs.jquery.com/ticket/13393
+function safeActiveElement() {
+	try {
+		return document.activeElement;
+	} catch ( err ) { }
+}
+
+function on( elem, types, selector, data, fn, one ) {
+	var origFn, type;
+
+	// Types can be a map of types/handlers
+	if ( typeof types === "object" ) {
+
+		// ( types-Object, selector, data )
+		if ( typeof selector !== "string" ) {
+
+			// ( types-Object, data )
+			data = data || selector;
+			selector = undefined;
+		}
+		for ( type in types ) {
+			on( elem, type, selector, data, types[ type ], one );
+		}
+		return elem;
+	}
+
+	if ( data == null && fn == null ) {
+
+		// ( types, fn )
+		fn = selector;
+		data = selector = undefined;
+	} else if ( fn == null ) {
+		if ( typeof selector === "string" ) {
+
+			// ( types, selector, fn )
+			fn = data;
+			data = undefined;
+		} else {
+
+			// ( types, data, fn )
+			fn = data;
+			data = selector;
+			selector = undefined;
+		}
+	}
+	if ( fn === false ) {
+		fn = returnFalse;
+	} else if ( !fn ) {
+		return elem;
+	}
+
+	if ( one === 1 ) {
+		origFn = fn;
+		fn = function( event ) {
+
+			// Can use an empty set, since event contains the info
+			jQuery().off( event );
+			return origFn.apply( this, arguments );
+		};
+
+		// Use same guid so caller can remove using origFn
+		fn.guid = origFn.guid || ( origFn.guid = jQuery.guid++ );
+	}
+	return elem.each( function() {
+		jQuery.event.add( this, types, fn, data, selector );
+	} );
+}
+
+/*
+ * Helper functions for managing events -- not part of the public interface.
+ * Props to Dean Edwards' addEvent library for many of the ideas.
+ */
+jQuery.event = {
+
+	global: {},
+
+	add: function( elem, types, handler, data, selector ) {
+
+		var handleObjIn, eventHandle, tmp,
+			events, t, handleObj,
+			special, handlers, type, namespaces, origType,
+			elemData = dataPriv.get( elem );
+
+		// Only attach events to objects that accept data
+		if ( !acceptData( elem ) ) {
+			return;
+		}
+
+		// Caller can pass in an object of custom data in lieu of the handler
+		if ( handler.handler ) {
+			handleObjIn = handler;
+			handler = handleObjIn.handler;
+			selector = handleObjIn.selector;
+		}
+
+		// Ensure that invalid selectors throw exceptions at attach time
+		// Evaluate against documentElement in case elem is a non-element node (e.g., document)
+		if ( selector ) {
+			jQuery.find.matchesSelector( documentElement, selector );
+		}
+
+		// Make sure that the handler has a unique ID, used to find/remove it later
+		if ( !handler.guid ) {
+			handler.guid = jQuery.guid++;
+		}
+
+		// Init the element's event structure and main handler, if this is the first
+		if ( !( events = elemData.events ) ) {
+			events = elemData.events = Object.create( null );
+		}
+		if ( !( eventHandle = elemData.handle ) ) {
+			eventHandle = elemData.handle = function( e ) {
+
+				// Discard the second event of a jQuery.event.trigger() and
+				// when an event is called after a page has unloaded
+				return typeof jQuery !== "undefined" && jQuery.event.triggered !== e.type ?
+					jQuery.event.dispatch.apply( elem, arguments ) : undefined;
+			};
+		}
+
+		// Handle multiple events separated by a space
+		types = ( types || "" ).match( rnothtmlwhite ) || [ "" ];
+		t = types.length;
+		while ( t-- ) {
+			tmp = rtypenamespace.exec( types[ t ] ) || [];
+			type = origType = tmp[ 1 ];
+			namespaces = ( tmp[ 2 ] || "" ).split( "." ).sort();
+
+			// There *must* be a type, no attaching namespace-only handlers
+			if ( !type ) {
+				continue;
+			}
+
+			// If event changes its type, use the special event handlers for the changed type
+			special = jQuery.event.special[ type ] || {};
+
+			// If selector defined, determine special event api type, otherwise given type
+			type = ( selector ? special.delegateType : special.bindType ) || type;
+
+			// Update special based on newly reset type
+			special = jQuery.event.special[ type ] || {};
+
+			// handleObj is passed to all event handlers
+			handleObj = jQuery.extend( {
+				type: type,
+				origType: origType,
+				data: data,
+				handler: handler,
+				guid: handler.guid,
+				selector: selector,
+				needsContext: selector && jQuery.expr.match.needsContext.test( selector ),
+				namespace: namespaces.join( "." )
+			}, handleObjIn );
+
+			// Init the event handler queue if we're the first
+			if ( !( handlers = events[ type ] ) ) {
+				handlers = events[ type ] = [];
+				handlers.delegateCount = 0;
+
+				// Only use addEventListener if the special events handler returns false
+				if ( !special.setup ||
+					special.setup.call( elem, data, namespaces, eventHandle ) === false ) {
+
+					if ( elem.addEventListener ) {
+						elem.addEventListener( type, eventHandle );
+					}
+				}
+			}
+
+			if ( special.add ) {
+				special.add.call( elem, handleObj );
+
+				if ( !handleObj.handler.guid ) {
+					handleObj.handler.guid = handler.guid;
+				}
+			}
+
+			// Add to the element's handler list, delegates in front
+			if ( selector ) {
+				handlers.splice( handlers.delegateCount++, 0, handleObj );
+			} else {
+				handlers.push( handleObj );
+			}
+
+			// Keep track of which events have ever been used, for event optimization
+			jQuery.event.global[ type ] = true;
+		}
+
+	},
+
+	// Detach an event or set of events from an element
+	remove: function( elem, types, handler, selector, mappedTypes ) {
+
+		var j, origCount, tmp,
+			events, t, handleObj,
+			special, handlers, type, namespaces, origType,
+			elemData = dataPriv.hasData( elem ) && dataPriv.get( elem );
+
+		if ( !elemData || !( events = elemData.events ) ) {
+			return;
+		}
+
+		// Once for each type.namespace in types; type may be omitted
+		types = ( types || "" ).match( rnothtmlwhite ) || [ "" ];
+		t = types.length;
+		while ( t-- ) {
+			tmp = rtypenamespace.exec( types[ t ] ) || [];
+			type = origType = tmp[ 1 ];
+			namespaces = ( tmp[ 2 ] || "" ).split( "." ).sort();
+
+			// Unbind all events (on this namespace, if provided) for the element
+			if ( !type ) {
+				for ( type in events ) {
+					jQuery.event.remove( elem, type + types[ t ], handler, selector, true );
+				}
+				continue;
+			}
+
+			special = jQuery.event.special[ type ] || {};
+			type = ( selector ? special.delegateType : special.bindType ) || type;
+			handlers = events[ type ] || [];
+			tmp = tmp[ 2 ] &&
+				new RegExp( "(^|\\.)" + namespaces.join( "\\.(?:.*\\.|)" ) + "(\\.|$)" );
+
+			// Remove matching events
+			origCount = j = handlers.length;
+			while ( j-- ) {
+				handleObj = handlers[ j ];
+
+				if ( ( mappedTypes || origType === handleObj.origType ) &&
+					( !handler || handler.guid === handleObj.guid ) &&
+					( !tmp || tmp.test( handleObj.namespace ) ) &&
+					( !selector || selector === handleObj.selector ||
+						selector === "**" && handleObj.selector ) ) {
+					handlers.splice( j, 1 );
+
+					if ( handleObj.selector ) {
+						handlers.delegateCount--;
+					}
+					if ( special.remove ) {
+						special.remove.call( elem, handleObj );
+					}
+				}
+			}
+
+			// Remove generic event handler if we removed something and no more handlers exist
+			// (avoids potential for endless recursion during removal of special event handlers)
+			if ( origCount && !handlers.length ) {
+				if ( !special.teardown ||
+					special.teardown.call( elem, namespaces, elemData.handle ) === false ) {
+
+					jQuery.removeEvent( elem, type, elemData.handle );
+				}
+
+				delete events[ type ];
+			}
+		}
+
+		// Remove data and the expando if it's no longer used
+		if ( jQuery.isEmptyObject( events ) ) {
+			dataPriv.remove( elem, "handle events" );
+		}
+	},
+
+	dispatch: function( nativeEvent ) {
+
+		var i, j, ret, matched, handleObj, handlerQueue,
+			args = new Array( arguments.length ),
+
+			// Make a writable jQuery.Event from the native event object
+			event = jQuery.event.fix( nativeEvent ),
+
+			handlers = (
+				dataPriv.get( this, "events" ) || Object.create( null )
+			)[ event.type ] || [],
+			special = jQuery.event.special[ event.type ] || {};
+
+		// Use the fix-ed jQuery.Event rather than the (read-only) native event
+		args[ 0 ] = event;
+
+		for ( i = 1; i < arguments.length; i++ ) {
+			args[ i ] = arguments[ i ];
+		}
+
+		event.delegateTarget = this;
+
+		// Call the preDispatch hook for the mapped type, and let it bail if desired
+		if ( special.preDispatch && special.preDispatch.call( this, event ) === false ) {
+			return;
+		}
+
+		// Determine handlers
+		handlerQueue = jQuery.event.handlers.call( this, event, handlers );
+
+		// Run delegates first; they may want to stop propagation beneath us
+		i = 0;
+		while ( ( matched = handlerQueue[ i++ ] ) && !event.isPropagationStopped() ) {
+			event.currentTarget = matched.elem;
+
+			j = 0;
+			while ( ( handleObj = matched.handlers[ j++ ] ) &&
+				!event.isImmediatePropagationStopped() ) {
+
+				// If the event is namespaced, then each handler is only invoked if it is
+				// specially universal or its namespaces are a superset of the event's.
+				if ( !event.rnamespace || handleObj.namespace === false ||
+					event.rnamespace.test( handleObj.namespace ) ) {
+
+					event.handleObj = handleObj;
+					event.data = handleObj.data;
+
+					ret = ( ( jQuery.event.special[ handleObj.origType ] || {} ).handle ||
+						handleObj.handler ).apply( matched.elem, args );
+
+					if ( ret !== undefined ) {
+						if ( ( event.result = ret ) === false ) {
+							event.preventDefault();
+							event.stopPropagation();
+						}
+					}
+				}
+			}
+		}
+
+		// Call the postDispatch hook for the mapped type
+		if ( special.postDispatch ) {
+			special.postDispatch.call( this, event );
+		}
+
+		return event.result;
+	},
+
+	handlers: function( event, handlers ) {
+		var i, handleObj, sel, matchedHandlers, matchedSelectors,
+			handlerQueue = [],
+			delegateCount = handlers.delegateCount,
+			cur = event.target;
+
+		// Find delegate handlers
+		if ( delegateCount &&
+
+			// Support: IE <=9
+			// Black-hole SVG  instance trees (trac-13180)
+			cur.nodeType &&
+
+			// Support: Firefox <=42
+			// Suppress spec-violating clicks indicating a non-primary pointer button (trac-3861)
+			// https://www.w3.org/TR/DOM-Level-3-Events/#event-type-click
+			// Support: IE 11 only
+			// ...but not arrow key "clicks" of radio inputs, which can have `button` -1 (gh-2343)
+			!( event.type === "click" && event.button >= 1 ) ) {
+
+			for ( ; cur !== this; cur = cur.parentNode || this ) {
+
+				// Don't check non-elements (#13208)
+				// Don't process clicks on disabled elements (#6911, #8165, #11382, #11764)
+				if ( cur.nodeType === 1 && !( event.type === "click" && cur.disabled === true ) ) {
+					matchedHandlers = [];
+					matchedSelectors = {};
+					for ( i = 0; i < delegateCount; i++ ) {
+						handleObj = handlers[ i ];
+
+						// Don't conflict with Object.prototype properties (#13203)
+						sel = handleObj.selector + " ";
+
+						if ( matchedSelectors[ sel ] === undefined ) {
+							matchedSelectors[ sel ] = handleObj.needsContext ?
+								jQuery( sel, this ).index( cur ) > -1 :
+								jQuery.find( sel, this, null, [ cur ] ).length;
+						}
+						if ( matchedSelectors[ sel ] ) {
+							matchedHandlers.push( handleObj );
+						}
+					}
+					if ( matchedHandlers.length ) {
+						handlerQueue.push( { elem: cur, handlers: matchedHandlers } );
+					}
+				}
+			}
+		}
+
+		// Add the remaining (directly-bound) handlers
+		cur = this;
+		if ( delegateCount < handlers.length ) {
+			handlerQueue.push( { elem: cur, handlers: handlers.slice( delegateCount ) } );
+		}
+
+		return handlerQueue;
+	},
+
+	addProp: function( name, hook ) {
+		Object.defineProperty( jQuery.Event.prototype, name, {
+			enumerable: true,
+			configurable: true,
+
+			get: isFunction( hook ) ?
+				function() {
+					if ( this.originalEvent ) {
+						return hook( this.originalEvent );
+					}
+				} :
+				function() {
+					if ( this.originalEvent ) {
+						return this.originalEvent[ name ];
+					}
+				},
+
+			set: function( value ) {
+				Object.defineProperty( this, name, {
+					enumerable: true,
+					configurable: true,
+					writable: true,
+					value: value
+				} );
+			}
+		} );
+	},
+
+	fix: function( originalEvent ) {
+		return originalEvent[ jQuery.expando ] ?
+			originalEvent :
+			new jQuery.Event( originalEvent );
+	},
+
+	special: {
+		load: {
+
+			// Prevent triggered image.load events from bubbling to window.load
+			noBubble: true
+		},
+		click: {
+
+			// Utilize native event to ensure correct state for checkable inputs
+			setup: function( data ) {
+
+				// For mutual compressibility with _default, replace `this` access with a local var.
+				// `|| data` is dead code meant only to preserve the variable through minification.
+				var el = this || data;
+
+				// Claim the first handler
+				if ( rcheckableType.test( el.type ) &&
+					el.click && nodeName( el, "input" ) ) {
+
+					// dataPriv.set( el, "click", ... )
+					leverageNative( el, "click", returnTrue );
+				}
+
+				// Return false to allow normal processing in the caller
+				return false;
+			},
+			trigger: function( data ) {
+
+				// For mutual compressibility with _default, replace `this` access with a local var.
+				// `|| data` is dead code meant only to preserve the variable through minification.
+				var el = this || data;
+
+				// Force setup before triggering a click
+				if ( rcheckableType.test( el.type ) &&
+					el.click && nodeName( el, "input" ) ) {
+
+					leverageNative( el, "click" );
+				}
+
+				// Return non-false to allow normal event-path propagation
+				return true;
+			},
+
+			// For cross-browser consistency, suppress native .click() on links
+			// Also prevent it if we're currently inside a leveraged native-event stack
+			_default: function( event ) {
+				var target = event.target;
+				return rcheckableType.test( target.type ) &&
+					target.click && nodeName( target, "input" ) &&
+					dataPriv.get( target, "click" ) ||
+					nodeName( target, "a" );
+			}
+		},
+
+		beforeunload: {
+			postDispatch: function( event ) {
+
+				// Support: Firefox 20+
+				// Firefox doesn't alert if the returnValue field is not set.
+				if ( event.result !== undefined && event.originalEvent ) {
+					event.originalEvent.returnValue = event.result;
+				}
+			}
+		}
+	}
+};
+
+// Ensure the presence of an event listener that handles manually-triggered
+// synthetic events by interrupting progress until reinvoked in response to
+// *native* events that it fires directly, ensuring that state changes have
+// already occurred before other listeners are invoked.
+function leverageNative( el, type, expectSync ) {
+
+	// Missing expectSync indicates a trigger call, which must force setup through jQuery.event.add
+	if ( !expectSync ) {
+		if ( dataPriv.get( el, type ) === undefined ) {
+			jQuery.event.add( el, type, returnTrue );
+		}
+		return;
+	}
+
+	// Register the controller as a special universal handler for all event namespaces
+	dataPriv.set( el, type, false );
+	jQuery.event.add( el, type, {
+		namespace: false,
+		handler: function( event ) {
+			var notAsync, result,
+				saved = dataPriv.get( this, type );
+
+			if ( ( event.isTrigger & 1 ) && this[ type ] ) {
+
+				// Interrupt processing of the outer synthetic .trigger()ed event
+				// Saved data should be false in such cases, but might be a leftover capture object
+				// from an async native handler (gh-4350)
+				if ( !saved.length ) {
+
+					// Store arguments for use when handling the inner native event
+					// There will always be at least one argument (an event object), so this array
+					// will not be confused with a leftover capture object.
+					saved = slice.call( arguments );
+					dataPriv.set( this, type, saved );
+
+					// Trigger the native event and capture its result
+					// Support: IE <=9 - 11+
+					// focus() and blur() are asynchronous
+					notAsync = expectSync( this, type );
+					this[ type ]();
+					result = dataPriv.get( this, type );
+					if ( saved !== result || notAsync ) {
+						dataPriv.set( this, type, false );
+					} else {
+						result = {};
+					}
+					if ( saved !== result ) {
+
+						// Cancel the outer synthetic event
+						event.stopImmediatePropagation();
+						event.preventDefault();
+
+						// Support: Chrome 86+
+						// In Chrome, if an element having a focusout handler is blurred by
+						// clicking outside of it, it invokes the handler synchronously. If
+						// that handler calls `.remove()` on the element, the data is cleared,
+						// leaving `result` undefined. We need to guard against this.
+						return result && result.value;
+					}
+
+				// If this is an inner synthetic event for an event with a bubbling surrogate
+				// (focus or blur), assume that the surrogate already propagated from triggering the
+				// native event and prevent that from happening again here.
+				// This technically gets the ordering wrong w.r.t. to `.trigger()` (in which the
+				// bubbling surrogate propagates *after* the non-bubbling base), but that seems
+				// less bad than duplication.
+				} else if ( ( jQuery.event.special[ type ] || {} ).delegateType ) {
+					event.stopPropagation();
+				}
+
+			// If this is a native event triggered above, everything is now in order
+			// Fire an inner synthetic event with the original arguments
+			} else if ( saved.length ) {
+
+				// ...and capture the result
+				dataPriv.set( this, type, {
+					value: jQuery.event.trigger(
+
+						// Support: IE <=9 - 11+
+						// Extend with the prototype to reset the above stopImmediatePropagation()
+						jQuery.extend( saved[ 0 ], jQuery.Event.prototype ),
+						saved.slice( 1 ),
+						this
+					)
+				} );
+
+				// Abort handling of the native event
+				event.stopImmediatePropagation();
+			}
+		}
+	} );
+}
+
+jQuery.removeEvent = function( elem, type, handle ) {
+
+	// This "if" is needed for plain objects
+	if ( elem.removeEventListener ) {
+		elem.removeEventListener( type, handle );
+	}
+};
+
+jQuery.Event = function( src, props ) {
+
+	// Allow instantiation without the 'new' keyword
+	if ( !( this instanceof jQuery.Event ) ) {
+		return new jQuery.Event( src, props );
+	}
+
+	// Event object
+	if ( src && src.type ) {
+		this.originalEvent = src;
+		this.type = src.type;
+
+		// Events bubbling up the document may have been marked as prevented
+		// by a handler lower down the tree; reflect the correct value.
+		this.isDefaultPrevented = src.defaultPrevented ||
+				src.defaultPrevented === undefined &&
+
+				// Support: Android <=2.3 only
+				src.returnValue === false ?
+			returnTrue :
+			returnFalse;
+
+		// Create target properties
+		// Support: Safari <=6 - 7 only
+		// Target should not be a text node (#504, #13143)
+		this.target = ( src.target && src.target.nodeType === 3 ) ?
+			src.target.parentNode :
+			src.target;
+
+		this.currentTarget = src.currentTarget;
+		this.relatedTarget = src.relatedTarget;
+
+	// Event type
+	} else {
+		this.type = src;
+	}
+
+	// Put explicitly provided properties onto the event object
+	if ( props ) {
+		jQuery.extend( this, props );
+	}
+
+	// Create a timestamp if incoming event doesn't have one
+	this.timeStamp = src && src.timeStamp || Date.now();
+
+	// Mark it as fixed
+	this[ jQuery.expando ] = true;
+};
+
+// jQuery.Event is based on DOM3 Events as specified by the ECMAScript Language Binding
+// https://www.w3.org/TR/2003/WD-DOM-Level-3-Events-20030331/ecma-script-binding.html
+jQuery.Event.prototype = {
+	constructor: jQuery.Event,
+	isDefaultPrevented: returnFalse,
+	isPropagationStopped: returnFalse,
+	isImmediatePropagationStopped: returnFalse,
+	isSimulated: false,
+
+	preventDefault: function() {
+		var e = this.originalEvent;
+
+		this.isDefaultPrevented = returnTrue;
+
+		if ( e && !this.isSimulated ) {
+			e.preventDefault();
+		}
+	},
+	stopPropagation: function() {
+		var e = this.originalEvent;
+
+		this.isPropagationStopped = returnTrue;
+
+		if ( e && !this.isSimulated ) {
+			e.stopPropagation();
+		}
+	},
+	stopImmediatePropagation: function() {
+		var e = this.originalEvent;
+
+		this.isImmediatePropagationStopped = returnTrue;
+
+		if ( e && !this.isSimulated ) {
+			e.stopImmediatePropagation();
+		}
+
+		this.stopPropagation();
+	}
+};
+
+// Includes all common event props including KeyEvent and MouseEvent specific props
+jQuery.each( {
+	altKey: true,
+	bubbles: true,
+	cancelable: true,
+	changedTouches: true,
+	ctrlKey: true,
+	detail: true,
+	eventPhase: true,
+	metaKey: true,
+	pageX: true,
+	pageY: true,
+	shiftKey: true,
+	view: true,
+	"char": true,
+	code: true,
+	charCode: true,
+	key: true,
+	keyCode: true,
+	button: true,
+	buttons: true,
+	clientX: true,
+	clientY: true,
+	offsetX: true,
+	offsetY: true,
+	pointerId: true,
+	pointerType: true,
+	screenX: true,
+	screenY: true,
+	targetTouches: true,
+	toElement: true,
+	touches: true,
+	which: true
+}, jQuery.event.addProp );
+
+jQuery.each( { focus: "focusin", blur: "focusout" }, function( type, delegateType ) {
+	jQuery.event.special[ type ] = {
+
+		// Utilize native event if possible so blur/focus sequence is correct
+		setup: function() {
+
+			// Claim the first handler
+			// dataPriv.set( this, "focus", ... )
+			// dataPriv.set( this, "blur", ... )
+			leverageNative( this, type, expectSync );
+
+			// Return false to allow normal processing in the caller
+			return false;
+		},
+		trigger: function() {
+
+			// Force setup before trigger
+			leverageNative( this, type );
+
+			// Return non-false to allow normal event-path propagation
+			return true;
+		},
+
+		// Suppress native focus or blur as it's already being fired
+		// in leverageNative.
+		_default: function() {
+			return true;
+		},
+
+		delegateType: delegateType
+	};
+} );
+
+// Create mouseenter/leave events using mouseover/out and event-time checks
+// so that event delegation works in jQuery.
+// Do the same for pointerenter/pointerleave and pointerover/pointerout
+//
+// Support: Safari 7 only
+// Safari sends mouseenter too often; see:
+// https://bugs.chromium.org/p/chromium/issues/detail?id=470258
+// for the description of the bug (it existed in older Chrome versions as well).
+jQuery.each( {
+	mouseenter: "mouseover",
+	mouseleave: "mouseout",
+	pointerenter: "pointerover",
+	pointerleave: "pointerout"
+}, function( orig, fix ) {
+	jQuery.event.special[ orig ] = {
+		delegateType: fix,
+		bindType: fix,
+
+		handle: function( event ) {
+			var ret,
+				target = this,
+				related = event.relatedTarget,
+				handleObj = event.handleObj;
+
+			// For mouseenter/leave call the handler if related is outside the target.
+			// NB: No relatedTarget if the mouse left/entered the browser window
+			if ( !related || ( related !== target && !jQuery.contains( target, related ) ) ) {
+				event.type = handleObj.origType;
+				ret = handleObj.handler.apply( this, arguments );
+				event.type = fix;
+			}
+			return ret;
+		}
+	};
+} );
+
+jQuery.fn.extend( {
+
+	on: function( types, selector, data, fn ) {
+		return on( this, types, selector, data, fn );
+	},
+	one: function( types, selector, data, fn ) {
+		return on( this, types, selector, data, fn, 1 );
+	},
+	off: function( types, selector, fn ) {
+		var handleObj, type;
+		if ( types && types.preventDefault && types.handleObj ) {
+
+			// ( event )  dispatched jQuery.Event
+			handleObj = types.handleObj;
+			jQuery( types.delegateTarget ).off(
+				handleObj.namespace ?
+					handleObj.origType + "." + handleObj.namespace :
+					handleObj.origType,
+				handleObj.selector,
+				handleObj.handler
+			);
+			return this;
+		}
+		if ( typeof types === "object" ) {
+
+			// ( types-object [, selector] )
+			for ( type in types ) {
+				this.off( type, selector, types[ type ] );
+			}
+			return this;
+		}
+		if ( selector === false || typeof selector === "function" ) {
+
+			// ( types [, fn] )
+			fn = selector;
+			selector = undefined;
+		}
+		if ( fn === false ) {
+			fn = returnFalse;
+		}
+		return this.each( function() {
+			jQuery.event.remove( this, types, fn, selector );
+		} );
+	}
+} );
+
+
+var
+
+	// Support: IE <=10 - 11, Edge 12 - 13 only
+	// In IE/Edge using regex groups here causes severe slowdowns.
+	// See https://connect.microsoft.com/IE/feedback/details/1736512/
+	rnoInnerhtml = /\s*$/g;
+
+// Prefer a tbody over its parent table for containing new rows
+function manipulationTarget( elem, content ) {
+	if ( nodeName( elem, "table" ) &&
+		nodeName( content.nodeType !== 11 ? content : content.firstChild, "tr" ) ) {
+
+		return jQuery( elem ).children( "tbody" )[ 0 ] || elem;
+	}
+
+	return elem;
+}
+
+// Replace/restore the type attribute of script elements for safe DOM manipulation
+function disableScript( elem ) {
+	elem.type = ( elem.getAttribute( "type" ) !== null ) + "/" + elem.type;
+	return elem;
+}
+function restoreScript( elem ) {
+	if ( ( elem.type || "" ).slice( 0, 5 ) === "true/" ) {
+		elem.type = elem.type.slice( 5 );
+	} else {
+		elem.removeAttribute( "type" );
+	}
+
+	return elem;
+}
+
+function cloneCopyEvent( src, dest ) {
+	var i, l, type, pdataOld, udataOld, udataCur, events;
+
+	if ( dest.nodeType !== 1 ) {
+		return;
+	}
+
+	// 1. Copy private data: events, handlers, etc.
+	if ( dataPriv.hasData( src ) ) {
+		pdataOld = dataPriv.get( src );
+		events = pdataOld.events;
+
+		if ( events ) {
+			dataPriv.remove( dest, "handle events" );
+
+			for ( type in events ) {
+				for ( i = 0, l = events[ type ].length; i < l; i++ ) {
+					jQuery.event.add( dest, type, events[ type ][ i ] );
+				}
+			}
+		}
+	}
+
+	// 2. Copy user data
+	if ( dataUser.hasData( src ) ) {
+		udataOld = dataUser.access( src );
+		udataCur = jQuery.extend( {}, udataOld );
+
+		dataUser.set( dest, udataCur );
+	}
+}
+
+// Fix IE bugs, see support tests
+function fixInput( src, dest ) {
+	var nodeName = dest.nodeName.toLowerCase();
+
+	// Fails to persist the checked state of a cloned checkbox or radio button.
+	if ( nodeName === "input" && rcheckableType.test( src.type ) ) {
+		dest.checked = src.checked;
+
+	// Fails to return the selected option to the default selected state when cloning options
+	} else if ( nodeName === "input" || nodeName === "textarea" ) {
+		dest.defaultValue = src.defaultValue;
+	}
+}
+
+function domManip( collection, args, callback, ignored ) {
+
+	// Flatten any nested arrays
+	args = flat( args );
+
+	var fragment, first, scripts, hasScripts, node, doc,
+		i = 0,
+		l = collection.length,
+		iNoClone = l - 1,
+		value = args[ 0 ],
+		valueIsFunction = isFunction( value );
+
+	// We can't cloneNode fragments that contain checked, in WebKit
+	if ( valueIsFunction ||
+			( l > 1 && typeof value === "string" &&
+				!support.checkClone && rchecked.test( value ) ) ) {
+		return collection.each( function( index ) {
+			var self = collection.eq( index );
+			if ( valueIsFunction ) {
+				args[ 0 ] = value.call( this, index, self.html() );
+			}
+			domManip( self, args, callback, ignored );
+		} );
+	}
+
+	if ( l ) {
+		fragment = buildFragment( args, collection[ 0 ].ownerDocument, false, collection, ignored );
+		first = fragment.firstChild;
+
+		if ( fragment.childNodes.length === 1 ) {
+			fragment = first;
+		}
+
+		// Require either new content or an interest in ignored elements to invoke the callback
+		if ( first || ignored ) {
+			scripts = jQuery.map( getAll( fragment, "script" ), disableScript );
+			hasScripts = scripts.length;
+
+			// Use the original fragment for the last item
+			// instead of the first because it can end up
+			// being emptied incorrectly in certain situations (#8070).
+			for ( ; i < l; i++ ) {
+				node = fragment;
+
+				if ( i !== iNoClone ) {
+					node = jQuery.clone( node, true, true );
+
+					// Keep references to cloned scripts for later restoration
+					if ( hasScripts ) {
+
+						// Support: Android <=4.0 only, PhantomJS 1 only
+						// push.apply(_, arraylike) throws on ancient WebKit
+						jQuery.merge( scripts, getAll( node, "script" ) );
+					}
+				}
+
+				callback.call( collection[ i ], node, i );
+			}
+
+			if ( hasScripts ) {
+				doc = scripts[ scripts.length - 1 ].ownerDocument;
+
+				// Reenable scripts
+				jQuery.map( scripts, restoreScript );
+
+				// Evaluate executable scripts on first document insertion
+				for ( i = 0; i < hasScripts; i++ ) {
+					node = scripts[ i ];
+					if ( rscriptType.test( node.type || "" ) &&
+						!dataPriv.access( node, "globalEval" ) &&
+						jQuery.contains( doc, node ) ) {
+
+						if ( node.src && ( node.type || "" ).toLowerCase()  !== "module" ) {
+
+							// Optional AJAX dependency, but won't run scripts if not present
+							if ( jQuery._evalUrl && !node.noModule ) {
+								jQuery._evalUrl( node.src, {
+									nonce: node.nonce || node.getAttribute( "nonce" )
+								}, doc );
+							}
+						} else {
+							DOMEval( node.textContent.replace( rcleanScript, "" ), node, doc );
+						}
+					}
+				}
+			}
+		}
+	}
+
+	return collection;
+}
+
+function remove( elem, selector, keepData ) {
+	var node,
+		nodes = selector ? jQuery.filter( selector, elem ) : elem,
+		i = 0;
+
+	for ( ; ( node = nodes[ i ] ) != null; i++ ) {
+		if ( !keepData && node.nodeType === 1 ) {
+			jQuery.cleanData( getAll( node ) );
+		}
+
+		if ( node.parentNode ) {
+			if ( keepData && isAttached( node ) ) {
+				setGlobalEval( getAll( node, "script" ) );
+			}
+			node.parentNode.removeChild( node );
+		}
+	}
+
+	return elem;
+}
+
+jQuery.extend( {
+	htmlPrefilter: function( html ) {
+		return html;
+	},
+
+	clone: function( elem, dataAndEvents, deepDataAndEvents ) {
+		var i, l, srcElements, destElements,
+			clone = elem.cloneNode( true ),
+			inPage = isAttached( elem );
+
+		// Fix IE cloning issues
+		if ( !support.noCloneChecked && ( elem.nodeType === 1 || elem.nodeType === 11 ) &&
+				!jQuery.isXMLDoc( elem ) ) {
+
+			// We eschew Sizzle here for performance reasons: https://jsperf.com/getall-vs-sizzle/2
+			destElements = getAll( clone );
+			srcElements = getAll( elem );
+
+			for ( i = 0, l = srcElements.length; i < l; i++ ) {
+				fixInput( srcElements[ i ], destElements[ i ] );
+			}
+		}
+
+		// Copy the events from the original to the clone
+		if ( dataAndEvents ) {
+			if ( deepDataAndEvents ) {
+				srcElements = srcElements || getAll( elem );
+				destElements = destElements || getAll( clone );
+
+				for ( i = 0, l = srcElements.length; i < l; i++ ) {
+					cloneCopyEvent( srcElements[ i ], destElements[ i ] );
+				}
+			} else {
+				cloneCopyEvent( elem, clone );
+			}
+		}
+
+		// Preserve script evaluation history
+		destElements = getAll( clone, "script" );
+		if ( destElements.length > 0 ) {
+			setGlobalEval( destElements, !inPage && getAll( elem, "script" ) );
+		}
+
+		// Return the cloned set
+		return clone;
+	},
+
+	cleanData: function( elems ) {
+		var data, elem, type,
+			special = jQuery.event.special,
+			i = 0;
+
+		for ( ; ( elem = elems[ i ] ) !== undefined; i++ ) {
+			if ( acceptData( elem ) ) {
+				if ( ( data = elem[ dataPriv.expando ] ) ) {
+					if ( data.events ) {
+						for ( type in data.events ) {
+							if ( special[ type ] ) {
+								jQuery.event.remove( elem, type );
+
+							// This is a shortcut to avoid jQuery.event.remove's overhead
+							} else {
+								jQuery.removeEvent( elem, type, data.handle );
+							}
+						}
+					}
+
+					// Support: Chrome <=35 - 45+
+					// Assign undefined instead of using delete, see Data#remove
+					elem[ dataPriv.expando ] = undefined;
+				}
+				if ( elem[ dataUser.expando ] ) {
+
+					// Support: Chrome <=35 - 45+
+					// Assign undefined instead of using delete, see Data#remove
+					elem[ dataUser.expando ] = undefined;
+				}
+			}
+		}
+	}
+} );
+
+jQuery.fn.extend( {
+	detach: function( selector ) {
+		return remove( this, selector, true );
+	},
+
+	remove: function( selector ) {
+		return remove( this, selector );
+	},
+
+	text: function( value ) {
+		return access( this, function( value ) {
+			return value === undefined ?
+				jQuery.text( this ) :
+				this.empty().each( function() {
+					if ( this.nodeType === 1 || this.nodeType === 11 || this.nodeType === 9 ) {
+						this.textContent = value;
+					}
+				} );
+		}, null, value, arguments.length );
+	},
+
+	append: function() {
+		return domManip( this, arguments, function( elem ) {
+			if ( this.nodeType === 1 || this.nodeType === 11 || this.nodeType === 9 ) {
+				var target = manipulationTarget( this, elem );
+				target.appendChild( elem );
+			}
+		} );
+	},
+
+	prepend: function() {
+		return domManip( this, arguments, function( elem ) {
+			if ( this.nodeType === 1 || this.nodeType === 11 || this.nodeType === 9 ) {
+				var target = manipulationTarget( this, elem );
+				target.insertBefore( elem, target.firstChild );
+			}
+		} );
+	},
+
+	before: function() {
+		return domManip( this, arguments, function( elem ) {
+			if ( this.parentNode ) {
+				this.parentNode.insertBefore( elem, this );
+			}
+		} );
+	},
+
+	after: function() {
+		return domManip( this, arguments, function( elem ) {
+			if ( this.parentNode ) {
+				this.parentNode.insertBefore( elem, this.nextSibling );
+			}
+		} );
+	},
+
+	empty: function() {
+		var elem,
+			i = 0;
+
+		for ( ; ( elem = this[ i ] ) != null; i++ ) {
+			if ( elem.nodeType === 1 ) {
+
+				// Prevent memory leaks
+				jQuery.cleanData( getAll( elem, false ) );
+
+				// Remove any remaining nodes
+				elem.textContent = "";
+			}
+		}
+
+		return this;
+	},
+
+	clone: function( dataAndEvents, deepDataAndEvents ) {
+		dataAndEvents = dataAndEvents == null ? false : dataAndEvents;
+		deepDataAndEvents = deepDataAndEvents == null ? dataAndEvents : deepDataAndEvents;
+
+		return this.map( function() {
+			return jQuery.clone( this, dataAndEvents, deepDataAndEvents );
+		} );
+	},
+
+	html: function( value ) {
+		return access( this, function( value ) {
+			var elem = this[ 0 ] || {},
+				i = 0,
+				l = this.length;
+
+			if ( value === undefined && elem.nodeType === 1 ) {
+				return elem.innerHTML;
+			}
+
+			// See if we can take a shortcut and just use innerHTML
+			if ( typeof value === "string" && !rnoInnerhtml.test( value ) &&
+				!wrapMap[ ( rtagName.exec( value ) || [ "", "" ] )[ 1 ].toLowerCase() ] ) {
+
+				value = jQuery.htmlPrefilter( value );
+
+				try {
+					for ( ; i < l; i++ ) {
+						elem = this[ i ] || {};
+
+						// Remove element nodes and prevent memory leaks
+						if ( elem.nodeType === 1 ) {
+							jQuery.cleanData( getAll( elem, false ) );
+							elem.innerHTML = value;
+						}
+					}
+
+					elem = 0;
+
+				// If using innerHTML throws an exception, use the fallback method
+				} catch ( e ) {}
+			}
+
+			if ( elem ) {
+				this.empty().append( value );
+			}
+		}, null, value, arguments.length );
+	},
+
+	replaceWith: function() {
+		var ignored = [];
+
+		// Make the changes, replacing each non-ignored context element with the new content
+		return domManip( this, arguments, function( elem ) {
+			var parent = this.parentNode;
+
+			if ( jQuery.inArray( this, ignored ) < 0 ) {
+				jQuery.cleanData( getAll( this ) );
+				if ( parent ) {
+					parent.replaceChild( elem, this );
+				}
+			}
+
+		// Force callback invocation
+		}, ignored );
+	}
+} );
+
+jQuery.each( {
+	appendTo: "append",
+	prependTo: "prepend",
+	insertBefore: "before",
+	insertAfter: "after",
+	replaceAll: "replaceWith"
+}, function( name, original ) {
+	jQuery.fn[ name ] = function( selector ) {
+		var elems,
+			ret = [],
+			insert = jQuery( selector ),
+			last = insert.length - 1,
+			i = 0;
+
+		for ( ; i <= last; i++ ) {
+			elems = i === last ? this : this.clone( true );
+			jQuery( insert[ i ] )[ original ]( elems );
+
+			// Support: Android <=4.0 only, PhantomJS 1 only
+			// .get() because push.apply(_, arraylike) throws on ancient WebKit
+			push.apply( ret, elems.get() );
+		}
+
+		return this.pushStack( ret );
+	};
+} );
+var rnumnonpx = new RegExp( "^(" + pnum + ")(?!px)[a-z%]+$", "i" );
+
+var getStyles = function( elem ) {
+
+		// Support: IE <=11 only, Firefox <=30 (#15098, #14150)
+		// IE throws on elements created in popups
+		// FF meanwhile throws on frame elements through "defaultView.getComputedStyle"
+		var view = elem.ownerDocument.defaultView;
+
+		if ( !view || !view.opener ) {
+			view = window;
+		}
+
+		return view.getComputedStyle( elem );
+	};
+
+var swap = function( elem, options, callback ) {
+	var ret, name,
+		old = {};
+
+	// Remember the old values, and insert the new ones
+	for ( name in options ) {
+		old[ name ] = elem.style[ name ];
+		elem.style[ name ] = options[ name ];
+	}
+
+	ret = callback.call( elem );
+
+	// Revert the old values
+	for ( name in options ) {
+		elem.style[ name ] = old[ name ];
+	}
+
+	return ret;
+};
+
+
+var rboxStyle = new RegExp( cssExpand.join( "|" ), "i" );
+
+
+
+( function() {
+
+	// Executing both pixelPosition & boxSizingReliable tests require only one layout
+	// so they're executed at the same time to save the second computation.
+	function computeStyleTests() {
+
+		// This is a singleton, we need to execute it only once
+		if ( !div ) {
+			return;
+		}
+
+		container.style.cssText = "position:absolute;left:-11111px;width:60px;" +
+			"margin-top:1px;padding:0;border:0";
+		div.style.cssText =
+			"position:relative;display:block;box-sizing:border-box;overflow:scroll;" +
+			"margin:auto;border:1px;padding:1px;" +
+			"width:60%;top:1%";
+		documentElement.appendChild( container ).appendChild( div );
+
+		var divStyle = window.getComputedStyle( div );
+		pixelPositionVal = divStyle.top !== "1%";
+
+		// Support: Android 4.0 - 4.3 only, Firefox <=3 - 44
+		reliableMarginLeftVal = roundPixelMeasures( divStyle.marginLeft ) === 12;
+
+		// Support: Android 4.0 - 4.3 only, Safari <=9.1 - 10.1, iOS <=7.0 - 9.3
+		// Some styles come back with percentage values, even though they shouldn't
+		div.style.right = "60%";
+		pixelBoxStylesVal = roundPixelMeasures( divStyle.right ) === 36;
+
+		// Support: IE 9 - 11 only
+		// Detect misreporting of content dimensions for box-sizing:border-box elements
+		boxSizingReliableVal = roundPixelMeasures( divStyle.width ) === 36;
+
+		// Support: IE 9 only
+		// Detect overflow:scroll screwiness (gh-3699)
+		// Support: Chrome <=64
+		// Don't get tricked when zoom affects offsetWidth (gh-4029)
+		div.style.position = "absolute";
+		scrollboxSizeVal = roundPixelMeasures( div.offsetWidth / 3 ) === 12;
+
+		documentElement.removeChild( container );
+
+		// Nullify the div so it wouldn't be stored in the memory and
+		// it will also be a sign that checks already performed
+		div = null;
+	}
+
+	function roundPixelMeasures( measure ) {
+		return Math.round( parseFloat( measure ) );
+	}
+
+	var pixelPositionVal, boxSizingReliableVal, scrollboxSizeVal, pixelBoxStylesVal,
+		reliableTrDimensionsVal, reliableMarginLeftVal,
+		container = document.createElement( "div" ),
+		div = document.createElement( "div" );
+
+	// Finish early in limited (non-browser) environments
+	if ( !div.style ) {
+		return;
+	}
+
+	// Support: IE <=9 - 11 only
+	// Style of cloned element affects source element cloned (#8908)
+	div.style.backgroundClip = "content-box";
+	div.cloneNode( true ).style.backgroundClip = "";
+	support.clearCloneStyle = div.style.backgroundClip === "content-box";
+
+	jQuery.extend( support, {
+		boxSizingReliable: function() {
+			computeStyleTests();
+			return boxSizingReliableVal;
+		},
+		pixelBoxStyles: function() {
+			computeStyleTests();
+			return pixelBoxStylesVal;
+		},
+		pixelPosition: function() {
+			computeStyleTests();
+			return pixelPositionVal;
+		},
+		reliableMarginLeft: function() {
+			computeStyleTests();
+			return reliableMarginLeftVal;
+		},
+		scrollboxSize: function() {
+			computeStyleTests();
+			return scrollboxSizeVal;
+		},
+
+		// Support: IE 9 - 11+, Edge 15 - 18+
+		// IE/Edge misreport `getComputedStyle` of table rows with width/height
+		// set in CSS while `offset*` properties report correct values.
+		// Behavior in IE 9 is more subtle than in newer versions & it passes
+		// some versions of this test; make sure not to make it pass there!
+		//
+		// Support: Firefox 70+
+		// Only Firefox includes border widths
+		// in computed dimensions. (gh-4529)
+		reliableTrDimensions: function() {
+			var table, tr, trChild, trStyle;
+			if ( reliableTrDimensionsVal == null ) {
+				table = document.createElement( "table" );
+				tr = document.createElement( "tr" );
+				trChild = document.createElement( "div" );
+
+				table.style.cssText = "position:absolute;left:-11111px;border-collapse:separate";
+				tr.style.cssText = "border:1px solid";
+
+				// Support: Chrome 86+
+				// Height set through cssText does not get applied.
+				// Computed height then comes back as 0.
+				tr.style.height = "1px";
+				trChild.style.height = "9px";
+
+				// Support: Android 8 Chrome 86+
+				// In our bodyBackground.html iframe,
+				// display for all div elements is set to "inline",
+				// which causes a problem only in Android 8 Chrome 86.
+				// Ensuring the div is display: block
+				// gets around this issue.
+				trChild.style.display = "block";
+
+				documentElement
+					.appendChild( table )
+					.appendChild( tr )
+					.appendChild( trChild );
+
+				trStyle = window.getComputedStyle( tr );
+				reliableTrDimensionsVal = ( parseInt( trStyle.height, 10 ) +
+					parseInt( trStyle.borderTopWidth, 10 ) +
+					parseInt( trStyle.borderBottomWidth, 10 ) ) === tr.offsetHeight;
+
+				documentElement.removeChild( table );
+			}
+			return reliableTrDimensionsVal;
+		}
+	} );
+} )();
+
+
+function curCSS( elem, name, computed ) {
+	var width, minWidth, maxWidth, ret,
+
+		// Support: Firefox 51+
+		// Retrieving style before computed somehow
+		// fixes an issue with getting wrong values
+		// on detached elements
+		style = elem.style;
+
+	computed = computed || getStyles( elem );
+
+	// getPropertyValue is needed for:
+	//   .css('filter') (IE 9 only, #12537)
+	//   .css('--customProperty) (#3144)
+	if ( computed ) {
+		ret = computed.getPropertyValue( name ) || computed[ name ];
+
+		if ( ret === "" && !isAttached( elem ) ) {
+			ret = jQuery.style( elem, name );
+		}
+
+		// A tribute to the "awesome hack by Dean Edwards"
+		// Android Browser returns percentage for some values,
+		// but width seems to be reliably pixels.
+		// This is against the CSSOM draft spec:
+		// https://drafts.csswg.org/cssom/#resolved-values
+		if ( !support.pixelBoxStyles() && rnumnonpx.test( ret ) && rboxStyle.test( name ) ) {
+
+			// Remember the original values
+			width = style.width;
+			minWidth = style.minWidth;
+			maxWidth = style.maxWidth;
+
+			// Put in the new values to get a computed value out
+			style.minWidth = style.maxWidth = style.width = ret;
+			ret = computed.width;
+
+			// Revert the changed values
+			style.width = width;
+			style.minWidth = minWidth;
+			style.maxWidth = maxWidth;
+		}
+	}
+
+	return ret !== undefined ?
+
+		// Support: IE <=9 - 11 only
+		// IE returns zIndex value as an integer.
+		ret + "" :
+		ret;
+}
+
+
+function addGetHookIf( conditionFn, hookFn ) {
+
+	// Define the hook, we'll check on the first run if it's really needed.
+	return {
+		get: function() {
+			if ( conditionFn() ) {
+
+				// Hook not needed (or it's not possible to use it due
+				// to missing dependency), remove it.
+				delete this.get;
+				return;
+			}
+
+			// Hook needed; redefine it so that the support test is not executed again.
+			return ( this.get = hookFn ).apply( this, arguments );
+		}
+	};
+}
+
+
+var cssPrefixes = [ "Webkit", "Moz", "ms" ],
+	emptyStyle = document.createElement( "div" ).style,
+	vendorProps = {};
+
+// Return a vendor-prefixed property or undefined
+function vendorPropName( name ) {
+
+	// Check for vendor prefixed names
+	var capName = name[ 0 ].toUpperCase() + name.slice( 1 ),
+		i = cssPrefixes.length;
+
+	while ( i-- ) {
+		name = cssPrefixes[ i ] + capName;
+		if ( name in emptyStyle ) {
+			return name;
+		}
+	}
+}
+
+// Return a potentially-mapped jQuery.cssProps or vendor prefixed property
+function finalPropName( name ) {
+	var final = jQuery.cssProps[ name ] || vendorProps[ name ];
+
+	if ( final ) {
+		return final;
+	}
+	if ( name in emptyStyle ) {
+		return name;
+	}
+	return vendorProps[ name ] = vendorPropName( name ) || name;
+}
+
+
+var
+
+	// Swappable if display is none or starts with table
+	// except "table", "table-cell", or "table-caption"
+	// See here for display values: https://developer.mozilla.org/en-US/docs/CSS/display
+	rdisplayswap = /^(none|table(?!-c[ea]).+)/,
+	rcustomProp = /^--/,
+	cssShow = { position: "absolute", visibility: "hidden", display: "block" },
+	cssNormalTransform = {
+		letterSpacing: "0",
+		fontWeight: "400"
+	};
+
+function setPositiveNumber( _elem, value, subtract ) {
+
+	// Any relative (+/-) values have already been
+	// normalized at this point
+	var matches = rcssNum.exec( value );
+	return matches ?
+
+		// Guard against undefined "subtract", e.g., when used as in cssHooks
+		Math.max( 0, matches[ 2 ] - ( subtract || 0 ) ) + ( matches[ 3 ] || "px" ) :
+		value;
+}
+
+function boxModelAdjustment( elem, dimension, box, isBorderBox, styles, computedVal ) {
+	var i = dimension === "width" ? 1 : 0,
+		extra = 0,
+		delta = 0;
+
+	// Adjustment may not be necessary
+	if ( box === ( isBorderBox ? "border" : "content" ) ) {
+		return 0;
+	}
+
+	for ( ; i < 4; i += 2 ) {
+
+		// Both box models exclude margin
+		if ( box === "margin" ) {
+			delta += jQuery.css( elem, box + cssExpand[ i ], true, styles );
+		}
+
+		// If we get here with a content-box, we're seeking "padding" or "border" or "margin"
+		if ( !isBorderBox ) {
+
+			// Add padding
+			delta += jQuery.css( elem, "padding" + cssExpand[ i ], true, styles );
+
+			// For "border" or "margin", add border
+			if ( box !== "padding" ) {
+				delta += jQuery.css( elem, "border" + cssExpand[ i ] + "Width", true, styles );
+
+			// But still keep track of it otherwise
+			} else {
+				extra += jQuery.css( elem, "border" + cssExpand[ i ] + "Width", true, styles );
+			}
+
+		// If we get here with a border-box (content + padding + border), we're seeking "content" or
+		// "padding" or "margin"
+		} else {
+
+			// For "content", subtract padding
+			if ( box === "content" ) {
+				delta -= jQuery.css( elem, "padding" + cssExpand[ i ], true, styles );
+			}
+
+			// For "content" or "padding", subtract border
+			if ( box !== "margin" ) {
+				delta -= jQuery.css( elem, "border" + cssExpand[ i ] + "Width", true, styles );
+			}
+		}
+	}
+
+	// Account for positive content-box scroll gutter when requested by providing computedVal
+	if ( !isBorderBox && computedVal >= 0 ) {
+
+		// offsetWidth/offsetHeight is a rounded sum of content, padding, scroll gutter, and border
+		// Assuming integer scroll gutter, subtract the rest and round down
+		delta += Math.max( 0, Math.ceil(
+			elem[ "offset" + dimension[ 0 ].toUpperCase() + dimension.slice( 1 ) ] -
+			computedVal -
+			delta -
+			extra -
+			0.5
+
+		// If offsetWidth/offsetHeight is unknown, then we can't determine content-box scroll gutter
+		// Use an explicit zero to avoid NaN (gh-3964)
+		) ) || 0;
+	}
+
+	return delta;
+}
+
+function getWidthOrHeight( elem, dimension, extra ) {
+
+	// Start with computed style
+	var styles = getStyles( elem ),
+
+		// To avoid forcing a reflow, only fetch boxSizing if we need it (gh-4322).
+		// Fake content-box until we know it's needed to know the true value.
+		boxSizingNeeded = !support.boxSizingReliable() || extra,
+		isBorderBox = boxSizingNeeded &&
+			jQuery.css( elem, "boxSizing", false, styles ) === "border-box",
+		valueIsBorderBox = isBorderBox,
+
+		val = curCSS( elem, dimension, styles ),
+		offsetProp = "offset" + dimension[ 0 ].toUpperCase() + dimension.slice( 1 );
+
+	// Support: Firefox <=54
+	// Return a confounding non-pixel value or feign ignorance, as appropriate.
+	if ( rnumnonpx.test( val ) ) {
+		if ( !extra ) {
+			return val;
+		}
+		val = "auto";
+	}
+
+
+	// Support: IE 9 - 11 only
+	// Use offsetWidth/offsetHeight for when box sizing is unreliable.
+	// In those cases, the computed value can be trusted to be border-box.
+	if ( ( !support.boxSizingReliable() && isBorderBox ||
+
+		// Support: IE 10 - 11+, Edge 15 - 18+
+		// IE/Edge misreport `getComputedStyle` of table rows with width/height
+		// set in CSS while `offset*` properties report correct values.
+		// Interestingly, in some cases IE 9 doesn't suffer from this issue.
+		!support.reliableTrDimensions() && nodeName( elem, "tr" ) ||
+
+		// Fall back to offsetWidth/offsetHeight when value is "auto"
+		// This happens for inline elements with no explicit setting (gh-3571)
+		val === "auto" ||
+
+		// Support: Android <=4.1 - 4.3 only
+		// Also use offsetWidth/offsetHeight for misreported inline dimensions (gh-3602)
+		!parseFloat( val ) && jQuery.css( elem, "display", false, styles ) === "inline" ) &&
+
+		// Make sure the element is visible & connected
+		elem.getClientRects().length ) {
+
+		isBorderBox = jQuery.css( elem, "boxSizing", false, styles ) === "border-box";
+
+		// Where available, offsetWidth/offsetHeight approximate border box dimensions.
+		// Where not available (e.g., SVG), assume unreliable box-sizing and interpret the
+		// retrieved value as a content box dimension.
+		valueIsBorderBox = offsetProp in elem;
+		if ( valueIsBorderBox ) {
+			val = elem[ offsetProp ];
+		}
+	}
+
+	// Normalize "" and auto
+	val = parseFloat( val ) || 0;
+
+	// Adjust for the element's box model
+	return ( val +
+		boxModelAdjustment(
+			elem,
+			dimension,
+			extra || ( isBorderBox ? "border" : "content" ),
+			valueIsBorderBox,
+			styles,
+
+			// Provide the current computed size to request scroll gutter calculation (gh-3589)
+			val
+		)
+	) + "px";
+}
+
+jQuery.extend( {
+
+	// Add in style property hooks for overriding the default
+	// behavior of getting and setting a style property
+	cssHooks: {
+		opacity: {
+			get: function( elem, computed ) {
+				if ( computed ) {
+
+					// We should always get a number back from opacity
+					var ret = curCSS( elem, "opacity" );
+					return ret === "" ? "1" : ret;
+				}
+			}
+		}
+	},
+
+	// Don't automatically add "px" to these possibly-unitless properties
+	cssNumber: {
+		"animationIterationCount": true,
+		"columnCount": true,
+		"fillOpacity": true,
+		"flexGrow": true,
+		"flexShrink": true,
+		"fontWeight": true,
+		"gridArea": true,
+		"gridColumn": true,
+		"gridColumnEnd": true,
+		"gridColumnStart": true,
+		"gridRow": true,
+		"gridRowEnd": true,
+		"gridRowStart": true,
+		"lineHeight": true,
+		"opacity": true,
+		"order": true,
+		"orphans": true,
+		"widows": true,
+		"zIndex": true,
+		"zoom": true
+	},
+
+	// Add in properties whose names you wish to fix before
+	// setting or getting the value
+	cssProps: {},
+
+	// Get and set the style property on a DOM Node
+	style: function( elem, name, value, extra ) {
+
+		// Don't set styles on text and comment nodes
+		if ( !elem || elem.nodeType === 3 || elem.nodeType === 8 || !elem.style ) {
+			return;
+		}
+
+		// Make sure that we're working with the right name
+		var ret, type, hooks,
+			origName = camelCase( name ),
+			isCustomProp = rcustomProp.test( name ),
+			style = elem.style;
+
+		// Make sure that we're working with the right name. We don't
+		// want to query the value if it is a CSS custom property
+		// since they are user-defined.
+		if ( !isCustomProp ) {
+			name = finalPropName( origName );
+		}
+
+		// Gets hook for the prefixed version, then unprefixed version
+		hooks = jQuery.cssHooks[ name ] || jQuery.cssHooks[ origName ];
+
+		// Check if we're setting a value
+		if ( value !== undefined ) {
+			type = typeof value;
+
+			// Convert "+=" or "-=" to relative numbers (#7345)
+			if ( type === "string" && ( ret = rcssNum.exec( value ) ) && ret[ 1 ] ) {
+				value = adjustCSS( elem, name, ret );
+
+				// Fixes bug #9237
+				type = "number";
+			}
+
+			// Make sure that null and NaN values aren't set (#7116)
+			if ( value == null || value !== value ) {
+				return;
+			}
+
+			// If a number was passed in, add the unit (except for certain CSS properties)
+			// The isCustomProp check can be removed in jQuery 4.0 when we only auto-append
+			// "px" to a few hardcoded values.
+			if ( type === "number" && !isCustomProp ) {
+				value += ret && ret[ 3 ] || ( jQuery.cssNumber[ origName ] ? "" : "px" );
+			}
+
+			// background-* props affect original clone's values
+			if ( !support.clearCloneStyle && value === "" && name.indexOf( "background" ) === 0 ) {
+				style[ name ] = "inherit";
+			}
+
+			// If a hook was provided, use that value, otherwise just set the specified value
+			if ( !hooks || !( "set" in hooks ) ||
+				( value = hooks.set( elem, value, extra ) ) !== undefined ) {
+
+				if ( isCustomProp ) {
+					style.setProperty( name, value );
+				} else {
+					style[ name ] = value;
+				}
+			}
+
+		} else {
+
+			// If a hook was provided get the non-computed value from there
+			if ( hooks && "get" in hooks &&
+				( ret = hooks.get( elem, false, extra ) ) !== undefined ) {
+
+				return ret;
+			}
+
+			// Otherwise just get the value from the style object
+			return style[ name ];
+		}
+	},
+
+	css: function( elem, name, extra, styles ) {
+		var val, num, hooks,
+			origName = camelCase( name ),
+			isCustomProp = rcustomProp.test( name );
+
+		// Make sure that we're working with the right name. We don't
+		// want to modify the value if it is a CSS custom property
+		// since they are user-defined.
+		if ( !isCustomProp ) {
+			name = finalPropName( origName );
+		}
+
+		// Try prefixed name followed by the unprefixed name
+		hooks = jQuery.cssHooks[ name ] || jQuery.cssHooks[ origName ];
+
+		// If a hook was provided get the computed value from there
+		if ( hooks && "get" in hooks ) {
+			val = hooks.get( elem, true, extra );
+		}
+
+		// Otherwise, if a way to get the computed value exists, use that
+		if ( val === undefined ) {
+			val = curCSS( elem, name, styles );
+		}
+
+		// Convert "normal" to computed value
+		if ( val === "normal" && name in cssNormalTransform ) {
+			val = cssNormalTransform[ name ];
+		}
+
+		// Make numeric if forced or a qualifier was provided and val looks numeric
+		if ( extra === "" || extra ) {
+			num = parseFloat( val );
+			return extra === true || isFinite( num ) ? num || 0 : val;
+		}
+
+		return val;
+	}
+} );
+
+jQuery.each( [ "height", "width" ], function( _i, dimension ) {
+	jQuery.cssHooks[ dimension ] = {
+		get: function( elem, computed, extra ) {
+			if ( computed ) {
+
+				// Certain elements can have dimension info if we invisibly show them
+				// but it must have a current display style that would benefit
+				return rdisplayswap.test( jQuery.css( elem, "display" ) ) &&
+
+					// Support: Safari 8+
+					// Table columns in Safari have non-zero offsetWidth & zero
+					// getBoundingClientRect().width unless display is changed.
+					// Support: IE <=11 only
+					// Running getBoundingClientRect on a disconnected node
+					// in IE throws an error.
+					( !elem.getClientRects().length || !elem.getBoundingClientRect().width ) ?
+					swap( elem, cssShow, function() {
+						return getWidthOrHeight( elem, dimension, extra );
+					} ) :
+					getWidthOrHeight( elem, dimension, extra );
+			}
+		},
+
+		set: function( elem, value, extra ) {
+			var matches,
+				styles = getStyles( elem ),
+
+				// Only read styles.position if the test has a chance to fail
+				// to avoid forcing a reflow.
+				scrollboxSizeBuggy = !support.scrollboxSize() &&
+					styles.position === "absolute",
+
+				// To avoid forcing a reflow, only fetch boxSizing if we need it (gh-3991)
+				boxSizingNeeded = scrollboxSizeBuggy || extra,
+				isBorderBox = boxSizingNeeded &&
+					jQuery.css( elem, "boxSizing", false, styles ) === "border-box",
+				subtract = extra ?
+					boxModelAdjustment(
+						elem,
+						dimension,
+						extra,
+						isBorderBox,
+						styles
+					) :
+					0;
+
+			// Account for unreliable border-box dimensions by comparing offset* to computed and
+			// faking a content-box to get border and padding (gh-3699)
+			if ( isBorderBox && scrollboxSizeBuggy ) {
+				subtract -= Math.ceil(
+					elem[ "offset" + dimension[ 0 ].toUpperCase() + dimension.slice( 1 ) ] -
+					parseFloat( styles[ dimension ] ) -
+					boxModelAdjustment( elem, dimension, "border", false, styles ) -
+					0.5
+				);
+			}
+
+			// Convert to pixels if value adjustment is needed
+			if ( subtract && ( matches = rcssNum.exec( value ) ) &&
+				( matches[ 3 ] || "px" ) !== "px" ) {
+
+				elem.style[ dimension ] = value;
+				value = jQuery.css( elem, dimension );
+			}
+
+			return setPositiveNumber( elem, value, subtract );
+		}
+	};
+} );
+
+jQuery.cssHooks.marginLeft = addGetHookIf( support.reliableMarginLeft,
+	function( elem, computed ) {
+		if ( computed ) {
+			return ( parseFloat( curCSS( elem, "marginLeft" ) ) ||
+				elem.getBoundingClientRect().left -
+					swap( elem, { marginLeft: 0 }, function() {
+						return elem.getBoundingClientRect().left;
+					} )
+			) + "px";
+		}
+	}
+);
+
+// These hooks are used by animate to expand properties
+jQuery.each( {
+	margin: "",
+	padding: "",
+	border: "Width"
+}, function( prefix, suffix ) {
+	jQuery.cssHooks[ prefix + suffix ] = {
+		expand: function( value ) {
+			var i = 0,
+				expanded = {},
+
+				// Assumes a single number if not a string
+				parts = typeof value === "string" ? value.split( " " ) : [ value ];
+
+			for ( ; i < 4; i++ ) {
+				expanded[ prefix + cssExpand[ i ] + suffix ] =
+					parts[ i ] || parts[ i - 2 ] || parts[ 0 ];
+			}
+
+			return expanded;
+		}
+	};
+
+	if ( prefix !== "margin" ) {
+		jQuery.cssHooks[ prefix + suffix ].set = setPositiveNumber;
+	}
+} );
+
+jQuery.fn.extend( {
+	css: function( name, value ) {
+		return access( this, function( elem, name, value ) {
+			var styles, len,
+				map = {},
+				i = 0;
+
+			if ( Array.isArray( name ) ) {
+				styles = getStyles( elem );
+				len = name.length;
+
+				for ( ; i < len; i++ ) {
+					map[ name[ i ] ] = jQuery.css( elem, name[ i ], false, styles );
+				}
+
+				return map;
+			}
+
+			return value !== undefined ?
+				jQuery.style( elem, name, value ) :
+				jQuery.css( elem, name );
+		}, name, value, arguments.length > 1 );
+	}
+} );
+
+
+function Tween( elem, options, prop, end, easing ) {
+	return new Tween.prototype.init( elem, options, prop, end, easing );
+}
+jQuery.Tween = Tween;
+
+Tween.prototype = {
+	constructor: Tween,
+	init: function( elem, options, prop, end, easing, unit ) {
+		this.elem = elem;
+		this.prop = prop;
+		this.easing = easing || jQuery.easing._default;
+		this.options = options;
+		this.start = this.now = this.cur();
+		this.end = end;
+		this.unit = unit || ( jQuery.cssNumber[ prop ] ? "" : "px" );
+	},
+	cur: function() {
+		var hooks = Tween.propHooks[ this.prop ];
+
+		return hooks && hooks.get ?
+			hooks.get( this ) :
+			Tween.propHooks._default.get( this );
+	},
+	run: function( percent ) {
+		var eased,
+			hooks = Tween.propHooks[ this.prop ];
+
+		if ( this.options.duration ) {
+			this.pos = eased = jQuery.easing[ this.easing ](
+				percent, this.options.duration * percent, 0, 1, this.options.duration
+			);
+		} else {
+			this.pos = eased = percent;
+		}
+		this.now = ( this.end - this.start ) * eased + this.start;
+
+		if ( this.options.step ) {
+			this.options.step.call( this.elem, this.now, this );
+		}
+
+		if ( hooks && hooks.set ) {
+			hooks.set( this );
+		} else {
+			Tween.propHooks._default.set( this );
+		}
+		return this;
+	}
+};
+
+Tween.prototype.init.prototype = Tween.prototype;
+
+Tween.propHooks = {
+	_default: {
+		get: function( tween ) {
+			var result;
+
+			// Use a property on the element directly when it is not a DOM element,
+			// or when there is no matching style property that exists.
+			if ( tween.elem.nodeType !== 1 ||
+				tween.elem[ tween.prop ] != null && tween.elem.style[ tween.prop ] == null ) {
+				return tween.elem[ tween.prop ];
+			}
+
+			// Passing an empty string as a 3rd parameter to .css will automatically
+			// attempt a parseFloat and fallback to a string if the parse fails.
+			// Simple values such as "10px" are parsed to Float;
+			// complex values such as "rotate(1rad)" are returned as-is.
+			result = jQuery.css( tween.elem, tween.prop, "" );
+
+			// Empty strings, null, undefined and "auto" are converted to 0.
+			return !result || result === "auto" ? 0 : result;
+		},
+		set: function( tween ) {
+
+			// Use step hook for back compat.
+			// Use cssHook if its there.
+			// Use .style if available and use plain properties where available.
+			if ( jQuery.fx.step[ tween.prop ] ) {
+				jQuery.fx.step[ tween.prop ]( tween );
+			} else if ( tween.elem.nodeType === 1 && (
+				jQuery.cssHooks[ tween.prop ] ||
+					tween.elem.style[ finalPropName( tween.prop ) ] != null ) ) {
+				jQuery.style( tween.elem, tween.prop, tween.now + tween.unit );
+			} else {
+				tween.elem[ tween.prop ] = tween.now;
+			}
+		}
+	}
+};
+
+// Support: IE <=9 only
+// Panic based approach to setting things on disconnected nodes
+Tween.propHooks.scrollTop = Tween.propHooks.scrollLeft = {
+	set: function( tween ) {
+		if ( tween.elem.nodeType && tween.elem.parentNode ) {
+			tween.elem[ tween.prop ] = tween.now;
+		}
+	}
+};
+
+jQuery.easing = {
+	linear: function( p ) {
+		return p;
+	},
+	swing: function( p ) {
+		return 0.5 - Math.cos( p * Math.PI ) / 2;
+	},
+	_default: "swing"
+};
+
+jQuery.fx = Tween.prototype.init;
+
+// Back compat <1.8 extension point
+jQuery.fx.step = {};
+
+
+
+
+var
+	fxNow, inProgress,
+	rfxtypes = /^(?:toggle|show|hide)$/,
+	rrun = /queueHooks$/;
+
+function schedule() {
+	if ( inProgress ) {
+		if ( document.hidden === false && window.requestAnimationFrame ) {
+			window.requestAnimationFrame( schedule );
+		} else {
+			window.setTimeout( schedule, jQuery.fx.interval );
+		}
+
+		jQuery.fx.tick();
+	}
+}
+
+// Animations created synchronously will run synchronously
+function createFxNow() {
+	window.setTimeout( function() {
+		fxNow = undefined;
+	} );
+	return ( fxNow = Date.now() );
+}
+
+// Generate parameters to create a standard animation
+function genFx( type, includeWidth ) {
+	var which,
+		i = 0,
+		attrs = { height: type };
+
+	// If we include width, step value is 1 to do all cssExpand values,
+	// otherwise step value is 2 to skip over Left and Right
+	includeWidth = includeWidth ? 1 : 0;
+	for ( ; i < 4; i += 2 - includeWidth ) {
+		which = cssExpand[ i ];
+		attrs[ "margin" + which ] = attrs[ "padding" + which ] = type;
+	}
+
+	if ( includeWidth ) {
+		attrs.opacity = attrs.width = type;
+	}
+
+	return attrs;
+}
+
+function createTween( value, prop, animation ) {
+	var tween,
+		collection = ( Animation.tweeners[ prop ] || [] ).concat( Animation.tweeners[ "*" ] ),
+		index = 0,
+		length = collection.length;
+	for ( ; index < length; index++ ) {
+		if ( ( tween = collection[ index ].call( animation, prop, value ) ) ) {
+
+			// We're done with this property
+			return tween;
+		}
+	}
+}
+
+function defaultPrefilter( elem, props, opts ) {
+	var prop, value, toggle, hooks, oldfire, propTween, restoreDisplay, display,
+		isBox = "width" in props || "height" in props,
+		anim = this,
+		orig = {},
+		style = elem.style,
+		hidden = elem.nodeType && isHiddenWithinTree( elem ),
+		dataShow = dataPriv.get( elem, "fxshow" );
+
+	// Queue-skipping animations hijack the fx hooks
+	if ( !opts.queue ) {
+		hooks = jQuery._queueHooks( elem, "fx" );
+		if ( hooks.unqueued == null ) {
+			hooks.unqueued = 0;
+			oldfire = hooks.empty.fire;
+			hooks.empty.fire = function() {
+				if ( !hooks.unqueued ) {
+					oldfire();
+				}
+			};
+		}
+		hooks.unqueued++;
+
+		anim.always( function() {
+
+			// Ensure the complete handler is called before this completes
+			anim.always( function() {
+				hooks.unqueued--;
+				if ( !jQuery.queue( elem, "fx" ).length ) {
+					hooks.empty.fire();
+				}
+			} );
+		} );
+	}
+
+	// Detect show/hide animations
+	for ( prop in props ) {
+		value = props[ prop ];
+		if ( rfxtypes.test( value ) ) {
+			delete props[ prop ];
+			toggle = toggle || value === "toggle";
+			if ( value === ( hidden ? "hide" : "show" ) ) {
+
+				// Pretend to be hidden if this is a "show" and
+				// there is still data from a stopped show/hide
+				if ( value === "show" && dataShow && dataShow[ prop ] !== undefined ) {
+					hidden = true;
+
+				// Ignore all other no-op show/hide data
+				} else {
+					continue;
+				}
+			}
+			orig[ prop ] = dataShow && dataShow[ prop ] || jQuery.style( elem, prop );
+		}
+	}
+
+	// Bail out if this is a no-op like .hide().hide()
+	propTween = !jQuery.isEmptyObject( props );
+	if ( !propTween && jQuery.isEmptyObject( orig ) ) {
+		return;
+	}
+
+	// Restrict "overflow" and "display" styles during box animations
+	if ( isBox && elem.nodeType === 1 ) {
+
+		// Support: IE <=9 - 11, Edge 12 - 15
+		// Record all 3 overflow attributes because IE does not infer the shorthand
+		// from identically-valued overflowX and overflowY and Edge just mirrors
+		// the overflowX value there.
+		opts.overflow = [ style.overflow, style.overflowX, style.overflowY ];
+
+		// Identify a display type, preferring old show/hide data over the CSS cascade
+		restoreDisplay = dataShow && dataShow.display;
+		if ( restoreDisplay == null ) {
+			restoreDisplay = dataPriv.get( elem, "display" );
+		}
+		display = jQuery.css( elem, "display" );
+		if ( display === "none" ) {
+			if ( restoreDisplay ) {
+				display = restoreDisplay;
+			} else {
+
+				// Get nonempty value(s) by temporarily forcing visibility
+				showHide( [ elem ], true );
+				restoreDisplay = elem.style.display || restoreDisplay;
+				display = jQuery.css( elem, "display" );
+				showHide( [ elem ] );
+			}
+		}
+
+		// Animate inline elements as inline-block
+		if ( display === "inline" || display === "inline-block" && restoreDisplay != null ) {
+			if ( jQuery.css( elem, "float" ) === "none" ) {
+
+				// Restore the original display value at the end of pure show/hide animations
+				if ( !propTween ) {
+					anim.done( function() {
+						style.display = restoreDisplay;
+					} );
+					if ( restoreDisplay == null ) {
+						display = style.display;
+						restoreDisplay = display === "none" ? "" : display;
+					}
+				}
+				style.display = "inline-block";
+			}
+		}
+	}
+
+	if ( opts.overflow ) {
+		style.overflow = "hidden";
+		anim.always( function() {
+			style.overflow = opts.overflow[ 0 ];
+			style.overflowX = opts.overflow[ 1 ];
+			style.overflowY = opts.overflow[ 2 ];
+		} );
+	}
+
+	// Implement show/hide animations
+	propTween = false;
+	for ( prop in orig ) {
+
+		// General show/hide setup for this element animation
+		if ( !propTween ) {
+			if ( dataShow ) {
+				if ( "hidden" in dataShow ) {
+					hidden = dataShow.hidden;
+				}
+			} else {
+				dataShow = dataPriv.access( elem, "fxshow", { display: restoreDisplay } );
+			}
+
+			// Store hidden/visible for toggle so `.stop().toggle()` "reverses"
+			if ( toggle ) {
+				dataShow.hidden = !hidden;
+			}
+
+			// Show elements before animating them
+			if ( hidden ) {
+				showHide( [ elem ], true );
+			}
+
+			/* eslint-disable no-loop-func */
+
+			anim.done( function() {
+
+				/* eslint-enable no-loop-func */
+
+				// The final step of a "hide" animation is actually hiding the element
+				if ( !hidden ) {
+					showHide( [ elem ] );
+				}
+				dataPriv.remove( elem, "fxshow" );
+				for ( prop in orig ) {
+					jQuery.style( elem, prop, orig[ prop ] );
+				}
+			} );
+		}
+
+		// Per-property setup
+		propTween = createTween( hidden ? dataShow[ prop ] : 0, prop, anim );
+		if ( !( prop in dataShow ) ) {
+			dataShow[ prop ] = propTween.start;
+			if ( hidden ) {
+				propTween.end = propTween.start;
+				propTween.start = 0;
+			}
+		}
+	}
+}
+
+function propFilter( props, specialEasing ) {
+	var index, name, easing, value, hooks;
+
+	// camelCase, specialEasing and expand cssHook pass
+	for ( index in props ) {
+		name = camelCase( index );
+		easing = specialEasing[ name ];
+		value = props[ index ];
+		if ( Array.isArray( value ) ) {
+			easing = value[ 1 ];
+			value = props[ index ] = value[ 0 ];
+		}
+
+		if ( index !== name ) {
+			props[ name ] = value;
+			delete props[ index ];
+		}
+
+		hooks = jQuery.cssHooks[ name ];
+		if ( hooks && "expand" in hooks ) {
+			value = hooks.expand( value );
+			delete props[ name ];
+
+			// Not quite $.extend, this won't overwrite existing keys.
+			// Reusing 'index' because we have the correct "name"
+			for ( index in value ) {
+				if ( !( index in props ) ) {
+					props[ index ] = value[ index ];
+					specialEasing[ index ] = easing;
+				}
+			}
+		} else {
+			specialEasing[ name ] = easing;
+		}
+	}
+}
+
+function Animation( elem, properties, options ) {
+	var result,
+		stopped,
+		index = 0,
+		length = Animation.prefilters.length,
+		deferred = jQuery.Deferred().always( function() {
+
+			// Don't match elem in the :animated selector
+			delete tick.elem;
+		} ),
+		tick = function() {
+			if ( stopped ) {
+				return false;
+			}
+			var currentTime = fxNow || createFxNow(),
+				remaining = Math.max( 0, animation.startTime + animation.duration - currentTime ),
+
+				// Support: Android 2.3 only
+				// Archaic crash bug won't allow us to use `1 - ( 0.5 || 0 )` (#12497)
+				temp = remaining / animation.duration || 0,
+				percent = 1 - temp,
+				index = 0,
+				length = animation.tweens.length;
+
+			for ( ; index < length; index++ ) {
+				animation.tweens[ index ].run( percent );
+			}
+
+			deferred.notifyWith( elem, [ animation, percent, remaining ] );
+
+			// If there's more to do, yield
+			if ( percent < 1 && length ) {
+				return remaining;
+			}
+
+			// If this was an empty animation, synthesize a final progress notification
+			if ( !length ) {
+				deferred.notifyWith( elem, [ animation, 1, 0 ] );
+			}
+
+			// Resolve the animation and report its conclusion
+			deferred.resolveWith( elem, [ animation ] );
+			return false;
+		},
+		animation = deferred.promise( {
+			elem: elem,
+			props: jQuery.extend( {}, properties ),
+			opts: jQuery.extend( true, {
+				specialEasing: {},
+				easing: jQuery.easing._default
+			}, options ),
+			originalProperties: properties,
+			originalOptions: options,
+			startTime: fxNow || createFxNow(),
+			duration: options.duration,
+			tweens: [],
+			createTween: function( prop, end ) {
+				var tween = jQuery.Tween( elem, animation.opts, prop, end,
+					animation.opts.specialEasing[ prop ] || animation.opts.easing );
+				animation.tweens.push( tween );
+				return tween;
+			},
+			stop: function( gotoEnd ) {
+				var index = 0,
+
+					// If we are going to the end, we want to run all the tweens
+					// otherwise we skip this part
+					length = gotoEnd ? animation.tweens.length : 0;
+				if ( stopped ) {
+					return this;
+				}
+				stopped = true;
+				for ( ; index < length; index++ ) {
+					animation.tweens[ index ].run( 1 );
+				}
+
+				// Resolve when we played the last frame; otherwise, reject
+				if ( gotoEnd ) {
+					deferred.notifyWith( elem, [ animation, 1, 0 ] );
+					deferred.resolveWith( elem, [ animation, gotoEnd ] );
+				} else {
+					deferred.rejectWith( elem, [ animation, gotoEnd ] );
+				}
+				return this;
+			}
+		} ),
+		props = animation.props;
+
+	propFilter( props, animation.opts.specialEasing );
+
+	for ( ; index < length; index++ ) {
+		result = Animation.prefilters[ index ].call( animation, elem, props, animation.opts );
+		if ( result ) {
+			if ( isFunction( result.stop ) ) {
+				jQuery._queueHooks( animation.elem, animation.opts.queue ).stop =
+					result.stop.bind( result );
+			}
+			return result;
+		}
+	}
+
+	jQuery.map( props, createTween, animation );
+
+	if ( isFunction( animation.opts.start ) ) {
+		animation.opts.start.call( elem, animation );
+	}
+
+	// Attach callbacks from options
+	animation
+		.progress( animation.opts.progress )
+		.done( animation.opts.done, animation.opts.complete )
+		.fail( animation.opts.fail )
+		.always( animation.opts.always );
+
+	jQuery.fx.timer(
+		jQuery.extend( tick, {
+			elem: elem,
+			anim: animation,
+			queue: animation.opts.queue
+		} )
+	);
+
+	return animation;
+}
+
+jQuery.Animation = jQuery.extend( Animation, {
+
+	tweeners: {
+		"*": [ function( prop, value ) {
+			var tween = this.createTween( prop, value );
+			adjustCSS( tween.elem, prop, rcssNum.exec( value ), tween );
+			return tween;
+		} ]
+	},
+
+	tweener: function( props, callback ) {
+		if ( isFunction( props ) ) {
+			callback = props;
+			props = [ "*" ];
+		} else {
+			props = props.match( rnothtmlwhite );
+		}
+
+		var prop,
+			index = 0,
+			length = props.length;
+
+		for ( ; index < length; index++ ) {
+			prop = props[ index ];
+			Animation.tweeners[ prop ] = Animation.tweeners[ prop ] || [];
+			Animation.tweeners[ prop ].unshift( callback );
+		}
+	},
+
+	prefilters: [ defaultPrefilter ],
+
+	prefilter: function( callback, prepend ) {
+		if ( prepend ) {
+			Animation.prefilters.unshift( callback );
+		} else {
+			Animation.prefilters.push( callback );
+		}
+	}
+} );
+
+jQuery.speed = function( speed, easing, fn ) {
+	var opt = speed && typeof speed === "object" ? jQuery.extend( {}, speed ) : {
+		complete: fn || !fn && easing ||
+			isFunction( speed ) && speed,
+		duration: speed,
+		easing: fn && easing || easing && !isFunction( easing ) && easing
+	};
+
+	// Go to the end state if fx are off
+	if ( jQuery.fx.off ) {
+		opt.duration = 0;
+
+	} else {
+		if ( typeof opt.duration !== "number" ) {
+			if ( opt.duration in jQuery.fx.speeds ) {
+				opt.duration = jQuery.fx.speeds[ opt.duration ];
+
+			} else {
+				opt.duration = jQuery.fx.speeds._default;
+			}
+		}
+	}
+
+	// Normalize opt.queue - true/undefined/null -> "fx"
+	if ( opt.queue == null || opt.queue === true ) {
+		opt.queue = "fx";
+	}
+
+	// Queueing
+	opt.old = opt.complete;
+
+	opt.complete = function() {
+		if ( isFunction( opt.old ) ) {
+			opt.old.call( this );
+		}
+
+		if ( opt.queue ) {
+			jQuery.dequeue( this, opt.queue );
+		}
+	};
+
+	return opt;
+};
+
+jQuery.fn.extend( {
+	fadeTo: function( speed, to, easing, callback ) {
+
+		// Show any hidden elements after setting opacity to 0
+		return this.filter( isHiddenWithinTree ).css( "opacity", 0 ).show()
+
+			// Animate to the value specified
+			.end().animate( { opacity: to }, speed, easing, callback );
+	},
+	animate: function( prop, speed, easing, callback ) {
+		var empty = jQuery.isEmptyObject( prop ),
+			optall = jQuery.speed( speed, easing, callback ),
+			doAnimation = function() {
+
+				// Operate on a copy of prop so per-property easing won't be lost
+				var anim = Animation( this, jQuery.extend( {}, prop ), optall );
+
+				// Empty animations, or finishing resolves immediately
+				if ( empty || dataPriv.get( this, "finish" ) ) {
+					anim.stop( true );
+				}
+			};
+
+		doAnimation.finish = doAnimation;
+
+		return empty || optall.queue === false ?
+			this.each( doAnimation ) :
+			this.queue( optall.queue, doAnimation );
+	},
+	stop: function( type, clearQueue, gotoEnd ) {
+		var stopQueue = function( hooks ) {
+			var stop = hooks.stop;
+			delete hooks.stop;
+			stop( gotoEnd );
+		};
+
+		if ( typeof type !== "string" ) {
+			gotoEnd = clearQueue;
+			clearQueue = type;
+			type = undefined;
+		}
+		if ( clearQueue ) {
+			this.queue( type || "fx", [] );
+		}
+
+		return this.each( function() {
+			var dequeue = true,
+				index = type != null && type + "queueHooks",
+				timers = jQuery.timers,
+				data = dataPriv.get( this );
+
+			if ( index ) {
+				if ( data[ index ] && data[ index ].stop ) {
+					stopQueue( data[ index ] );
+				}
+			} else {
+				for ( index in data ) {
+					if ( data[ index ] && data[ index ].stop && rrun.test( index ) ) {
+						stopQueue( data[ index ] );
+					}
+				}
+			}
+
+			for ( index = timers.length; index--; ) {
+				if ( timers[ index ].elem === this &&
+					( type == null || timers[ index ].queue === type ) ) {
+
+					timers[ index ].anim.stop( gotoEnd );
+					dequeue = false;
+					timers.splice( index, 1 );
+				}
+			}
+
+			// Start the next in the queue if the last step wasn't forced.
+			// Timers currently will call their complete callbacks, which
+			// will dequeue but only if they were gotoEnd.
+			if ( dequeue || !gotoEnd ) {
+				jQuery.dequeue( this, type );
+			}
+		} );
+	},
+	finish: function( type ) {
+		if ( type !== false ) {
+			type = type || "fx";
+		}
+		return this.each( function() {
+			var index,
+				data = dataPriv.get( this ),
+				queue = data[ type + "queue" ],
+				hooks = data[ type + "queueHooks" ],
+				timers = jQuery.timers,
+				length = queue ? queue.length : 0;
+
+			// Enable finishing flag on private data
+			data.finish = true;
+
+			// Empty the queue first
+			jQuery.queue( this, type, [] );
+
+			if ( hooks && hooks.stop ) {
+				hooks.stop.call( this, true );
+			}
+
+			// Look for any active animations, and finish them
+			for ( index = timers.length; index--; ) {
+				if ( timers[ index ].elem === this && timers[ index ].queue === type ) {
+					timers[ index ].anim.stop( true );
+					timers.splice( index, 1 );
+				}
+			}
+
+			// Look for any animations in the old queue and finish them
+			for ( index = 0; index < length; index++ ) {
+				if ( queue[ index ] && queue[ index ].finish ) {
+					queue[ index ].finish.call( this );
+				}
+			}
+
+			// Turn off finishing flag
+			delete data.finish;
+		} );
+	}
+} );
+
+jQuery.each( [ "toggle", "show", "hide" ], function( _i, name ) {
+	var cssFn = jQuery.fn[ name ];
+	jQuery.fn[ name ] = function( speed, easing, callback ) {
+		return speed == null || typeof speed === "boolean" ?
+			cssFn.apply( this, arguments ) :
+			this.animate( genFx( name, true ), speed, easing, callback );
+	};
+} );
+
+// Generate shortcuts for custom animations
+jQuery.each( {
+	slideDown: genFx( "show" ),
+	slideUp: genFx( "hide" ),
+	slideToggle: genFx( "toggle" ),
+	fadeIn: { opacity: "show" },
+	fadeOut: { opacity: "hide" },
+	fadeToggle: { opacity: "toggle" }
+}, function( name, props ) {
+	jQuery.fn[ name ] = function( speed, easing, callback ) {
+		return this.animate( props, speed, easing, callback );
+	};
+} );
+
+jQuery.timers = [];
+jQuery.fx.tick = function() {
+	var timer,
+		i = 0,
+		timers = jQuery.timers;
+
+	fxNow = Date.now();
+
+	for ( ; i < timers.length; i++ ) {
+		timer = timers[ i ];
+
+		// Run the timer and safely remove it when done (allowing for external removal)
+		if ( !timer() && timers[ i ] === timer ) {
+			timers.splice( i--, 1 );
+		}
+	}
+
+	if ( !timers.length ) {
+		jQuery.fx.stop();
+	}
+	fxNow = undefined;
+};
+
+jQuery.fx.timer = function( timer ) {
+	jQuery.timers.push( timer );
+	jQuery.fx.start();
+};
+
+jQuery.fx.interval = 13;
+jQuery.fx.start = function() {
+	if ( inProgress ) {
+		return;
+	}
+
+	inProgress = true;
+	schedule();
+};
+
+jQuery.fx.stop = function() {
+	inProgress = null;
+};
+
+jQuery.fx.speeds = {
+	slow: 600,
+	fast: 200,
+
+	// Default speed
+	_default: 400
+};
+
+
+// Based off of the plugin by Clint Helfers, with permission.
+// https://web.archive.org/web/20100324014747/http://blindsignals.com/index.php/2009/07/jquery-delay/
+jQuery.fn.delay = function( time, type ) {
+	time = jQuery.fx ? jQuery.fx.speeds[ time ] || time : time;
+	type = type || "fx";
+
+	return this.queue( type, function( next, hooks ) {
+		var timeout = window.setTimeout( next, time );
+		hooks.stop = function() {
+			window.clearTimeout( timeout );
+		};
+	} );
+};
+
+
+( function() {
+	var input = document.createElement( "input" ),
+		select = document.createElement( "select" ),
+		opt = select.appendChild( document.createElement( "option" ) );
+
+	input.type = "checkbox";
+
+	// Support: Android <=4.3 only
+	// Default value for a checkbox should be "on"
+	support.checkOn = input.value !== "";
+
+	// Support: IE <=11 only
+	// Must access selectedIndex to make default options select
+	support.optSelected = opt.selected;
+
+	// Support: IE <=11 only
+	// An input loses its value after becoming a radio
+	input = document.createElement( "input" );
+	input.value = "t";
+	input.type = "radio";
+	support.radioValue = input.value === "t";
+} )();
+
+
+var boolHook,
+	attrHandle = jQuery.expr.attrHandle;
+
+jQuery.fn.extend( {
+	attr: function( name, value ) {
+		return access( this, jQuery.attr, name, value, arguments.length > 1 );
+	},
+
+	removeAttr: function( name ) {
+		return this.each( function() {
+			jQuery.removeAttr( this, name );
+		} );
+	}
+} );
+
+jQuery.extend( {
+	attr: function( elem, name, value ) {
+		var ret, hooks,
+			nType = elem.nodeType;
+
+		// Don't get/set attributes on text, comment and attribute nodes
+		if ( nType === 3 || nType === 8 || nType === 2 ) {
+			return;
+		}
+
+		// Fallback to prop when attributes are not supported
+		if ( typeof elem.getAttribute === "undefined" ) {
+			return jQuery.prop( elem, name, value );
+		}
+
+		// Attribute hooks are determined by the lowercase version
+		// Grab necessary hook if one is defined
+		if ( nType !== 1 || !jQuery.isXMLDoc( elem ) ) {
+			hooks = jQuery.attrHooks[ name.toLowerCase() ] ||
+				( jQuery.expr.match.bool.test( name ) ? boolHook : undefined );
+		}
+
+		if ( value !== undefined ) {
+			if ( value === null ) {
+				jQuery.removeAttr( elem, name );
+				return;
+			}
+
+			if ( hooks && "set" in hooks &&
+				( ret = hooks.set( elem, value, name ) ) !== undefined ) {
+				return ret;
+			}
+
+			elem.setAttribute( name, value + "" );
+			return value;
+		}
+
+		if ( hooks && "get" in hooks && ( ret = hooks.get( elem, name ) ) !== null ) {
+			return ret;
+		}
+
+		ret = jQuery.find.attr( elem, name );
+
+		// Non-existent attributes return null, we normalize to undefined
+		return ret == null ? undefined : ret;
+	},
+
+	attrHooks: {
+		type: {
+			set: function( elem, value ) {
+				if ( !support.radioValue && value === "radio" &&
+					nodeName( elem, "input" ) ) {
+					var val = elem.value;
+					elem.setAttribute( "type", value );
+					if ( val ) {
+						elem.value = val;
+					}
+					return value;
+				}
+			}
+		}
+	},
+
+	removeAttr: function( elem, value ) {
+		var name,
+			i = 0,
+
+			// Attribute names can contain non-HTML whitespace characters
+			// https://html.spec.whatwg.org/multipage/syntax.html#attributes-2
+			attrNames = value && value.match( rnothtmlwhite );
+
+		if ( attrNames && elem.nodeType === 1 ) {
+			while ( ( name = attrNames[ i++ ] ) ) {
+				elem.removeAttribute( name );
+			}
+		}
+	}
+} );
+
+// Hooks for boolean attributes
+boolHook = {
+	set: function( elem, value, name ) {
+		if ( value === false ) {
+
+			// Remove boolean attributes when set to false
+			jQuery.removeAttr( elem, name );
+		} else {
+			elem.setAttribute( name, name );
+		}
+		return name;
+	}
+};
+
+jQuery.each( jQuery.expr.match.bool.source.match( /\w+/g ), function( _i, name ) {
+	var getter = attrHandle[ name ] || jQuery.find.attr;
+
+	attrHandle[ name ] = function( elem, name, isXML ) {
+		var ret, handle,
+			lowercaseName = name.toLowerCase();
+
+		if ( !isXML ) {
+
+			// Avoid an infinite loop by temporarily removing this function from the getter
+			handle = attrHandle[ lowercaseName ];
+			attrHandle[ lowercaseName ] = ret;
+			ret = getter( elem, name, isXML ) != null ?
+				lowercaseName :
+				null;
+			attrHandle[ lowercaseName ] = handle;
+		}
+		return ret;
+	};
+} );
+
+
+
+
+var rfocusable = /^(?:input|select|textarea|button)$/i,
+	rclickable = /^(?:a|area)$/i;
+
+jQuery.fn.extend( {
+	prop: function( name, value ) {
+		return access( this, jQuery.prop, name, value, arguments.length > 1 );
+	},
+
+	removeProp: function( name ) {
+		return this.each( function() {
+			delete this[ jQuery.propFix[ name ] || name ];
+		} );
+	}
+} );
+
+jQuery.extend( {
+	prop: function( elem, name, value ) {
+		var ret, hooks,
+			nType = elem.nodeType;
+
+		// Don't get/set properties on text, comment and attribute nodes
+		if ( nType === 3 || nType === 8 || nType === 2 ) {
+			return;
+		}
+
+		if ( nType !== 1 || !jQuery.isXMLDoc( elem ) ) {
+
+			// Fix name and attach hooks
+			name = jQuery.propFix[ name ] || name;
+			hooks = jQuery.propHooks[ name ];
+		}
+
+		if ( value !== undefined ) {
+			if ( hooks && "set" in hooks &&
+				( ret = hooks.set( elem, value, name ) ) !== undefined ) {
+				return ret;
+			}
+
+			return ( elem[ name ] = value );
+		}
+
+		if ( hooks && "get" in hooks && ( ret = hooks.get( elem, name ) ) !== null ) {
+			return ret;
+		}
+
+		return elem[ name ];
+	},
+
+	propHooks: {
+		tabIndex: {
+			get: function( elem ) {
+
+				// Support: IE <=9 - 11 only
+				// elem.tabIndex doesn't always return the
+				// correct value when it hasn't been explicitly set
+				// https://web.archive.org/web/20141116233347/http://fluidproject.org/blog/2008/01/09/getting-setting-and-removing-tabindex-values-with-javascript/
+				// Use proper attribute retrieval(#12072)
+				var tabindex = jQuery.find.attr( elem, "tabindex" );
+
+				if ( tabindex ) {
+					return parseInt( tabindex, 10 );
+				}
+
+				if (
+					rfocusable.test( elem.nodeName ) ||
+					rclickable.test( elem.nodeName ) &&
+					elem.href
+				) {
+					return 0;
+				}
+
+				return -1;
+			}
+		}
+	},
+
+	propFix: {
+		"for": "htmlFor",
+		"class": "className"
+	}
+} );
+
+// Support: IE <=11 only
+// Accessing the selectedIndex property
+// forces the browser to respect setting selected
+// on the option
+// The getter ensures a default option is selected
+// when in an optgroup
+// eslint rule "no-unused-expressions" is disabled for this code
+// since it considers such accessions noop
+if ( !support.optSelected ) {
+	jQuery.propHooks.selected = {
+		get: function( elem ) {
+
+			/* eslint no-unused-expressions: "off" */
+
+			var parent = elem.parentNode;
+			if ( parent && parent.parentNode ) {
+				parent.parentNode.selectedIndex;
+			}
+			return null;
+		},
+		set: function( elem ) {
+
+			/* eslint no-unused-expressions: "off" */
+
+			var parent = elem.parentNode;
+			if ( parent ) {
+				parent.selectedIndex;
+
+				if ( parent.parentNode ) {
+					parent.parentNode.selectedIndex;
+				}
+			}
+		}
+	};
+}
+
+jQuery.each( [
+	"tabIndex",
+	"readOnly",
+	"maxLength",
+	"cellSpacing",
+	"cellPadding",
+	"rowSpan",
+	"colSpan",
+	"useMap",
+	"frameBorder",
+	"contentEditable"
+], function() {
+	jQuery.propFix[ this.toLowerCase() ] = this;
+} );
+
+
+
+
+	// Strip and collapse whitespace according to HTML spec
+	// https://infra.spec.whatwg.org/#strip-and-collapse-ascii-whitespace
+	function stripAndCollapse( value ) {
+		var tokens = value.match( rnothtmlwhite ) || [];
+		return tokens.join( " " );
+	}
+
+
+function getClass( elem ) {
+	return elem.getAttribute && elem.getAttribute( "class" ) || "";
+}
+
+function classesToArray( value ) {
+	if ( Array.isArray( value ) ) {
+		return value;
+	}
+	if ( typeof value === "string" ) {
+		return value.match( rnothtmlwhite ) || [];
+	}
+	return [];
+}
+
+jQuery.fn.extend( {
+	addClass: function( value ) {
+		var classes, elem, cur, curValue, clazz, j, finalValue,
+			i = 0;
+
+		if ( isFunction( value ) ) {
+			return this.each( function( j ) {
+				jQuery( this ).addClass( value.call( this, j, getClass( this ) ) );
+			} );
+		}
+
+		classes = classesToArray( value );
+
+		if ( classes.length ) {
+			while ( ( elem = this[ i++ ] ) ) {
+				curValue = getClass( elem );
+				cur = elem.nodeType === 1 && ( " " + stripAndCollapse( curValue ) + " " );
+
+				if ( cur ) {
+					j = 0;
+					while ( ( clazz = classes[ j++ ] ) ) {
+						if ( cur.indexOf( " " + clazz + " " ) < 0 ) {
+							cur += clazz + " ";
+						}
+					}
+
+					// Only assign if different to avoid unneeded rendering.
+					finalValue = stripAndCollapse( cur );
+					if ( curValue !== finalValue ) {
+						elem.setAttribute( "class", finalValue );
+					}
+				}
+			}
+		}
+
+		return this;
+	},
+
+	removeClass: function( value ) {
+		var classes, elem, cur, curValue, clazz, j, finalValue,
+			i = 0;
+
+		if ( isFunction( value ) ) {
+			return this.each( function( j ) {
+				jQuery( this ).removeClass( value.call( this, j, getClass( this ) ) );
+			} );
+		}
+
+		if ( !arguments.length ) {
+			return this.attr( "class", "" );
+		}
+
+		classes = classesToArray( value );
+
+		if ( classes.length ) {
+			while ( ( elem = this[ i++ ] ) ) {
+				curValue = getClass( elem );
+
+				// This expression is here for better compressibility (see addClass)
+				cur = elem.nodeType === 1 && ( " " + stripAndCollapse( curValue ) + " " );
+
+				if ( cur ) {
+					j = 0;
+					while ( ( clazz = classes[ j++ ] ) ) {
+
+						// Remove *all* instances
+						while ( cur.indexOf( " " + clazz + " " ) > -1 ) {
+							cur = cur.replace( " " + clazz + " ", " " );
+						}
+					}
+
+					// Only assign if different to avoid unneeded rendering.
+					finalValue = stripAndCollapse( cur );
+					if ( curValue !== finalValue ) {
+						elem.setAttribute( "class", finalValue );
+					}
+				}
+			}
+		}
+
+		return this;
+	},
+
+	toggleClass: function( value, stateVal ) {
+		var type = typeof value,
+			isValidValue = type === "string" || Array.isArray( value );
+
+		if ( typeof stateVal === "boolean" && isValidValue ) {
+			return stateVal ? this.addClass( value ) : this.removeClass( value );
+		}
+
+		if ( isFunction( value ) ) {
+			return this.each( function( i ) {
+				jQuery( this ).toggleClass(
+					value.call( this, i, getClass( this ), stateVal ),
+					stateVal
+				);
+			} );
+		}
+
+		return this.each( function() {
+			var className, i, self, classNames;
+
+			if ( isValidValue ) {
+
+				// Toggle individual class names
+				i = 0;
+				self = jQuery( this );
+				classNames = classesToArray( value );
+
+				while ( ( className = classNames[ i++ ] ) ) {
+
+					// Check each className given, space separated list
+					if ( self.hasClass( className ) ) {
+						self.removeClass( className );
+					} else {
+						self.addClass( className );
+					}
+				}
+
+			// Toggle whole class name
+			} else if ( value === undefined || type === "boolean" ) {
+				className = getClass( this );
+				if ( className ) {
+
+					// Store className if set
+					dataPriv.set( this, "__className__", className );
+				}
+
+				// If the element has a class name or if we're passed `false`,
+				// then remove the whole classname (if there was one, the above saved it).
+				// Otherwise bring back whatever was previously saved (if anything),
+				// falling back to the empty string if nothing was stored.
+				if ( this.setAttribute ) {
+					this.setAttribute( "class",
+						className || value === false ?
+							"" :
+							dataPriv.get( this, "__className__" ) || ""
+					);
+				}
+			}
+		} );
+	},
+
+	hasClass: function( selector ) {
+		var className, elem,
+			i = 0;
+
+		className = " " + selector + " ";
+		while ( ( elem = this[ i++ ] ) ) {
+			if ( elem.nodeType === 1 &&
+				( " " + stripAndCollapse( getClass( elem ) ) + " " ).indexOf( className ) > -1 ) {
+				return true;
+			}
+		}
+
+		return false;
+	}
+} );
+
+
+
+
+var rreturn = /\r/g;
+
+jQuery.fn.extend( {
+	val: function( value ) {
+		var hooks, ret, valueIsFunction,
+			elem = this[ 0 ];
+
+		if ( !arguments.length ) {
+			if ( elem ) {
+				hooks = jQuery.valHooks[ elem.type ] ||
+					jQuery.valHooks[ elem.nodeName.toLowerCase() ];
+
+				if ( hooks &&
+					"get" in hooks &&
+					( ret = hooks.get( elem, "value" ) ) !== undefined
+				) {
+					return ret;
+				}
+
+				ret = elem.value;
+
+				// Handle most common string cases
+				if ( typeof ret === "string" ) {
+					return ret.replace( rreturn, "" );
+				}
+
+				// Handle cases where value is null/undef or number
+				return ret == null ? "" : ret;
+			}
+
+			return;
+		}
+
+		valueIsFunction = isFunction( value );
+
+		return this.each( function( i ) {
+			var val;
+
+			if ( this.nodeType !== 1 ) {
+				return;
+			}
+
+			if ( valueIsFunction ) {
+				val = value.call( this, i, jQuery( this ).val() );
+			} else {
+				val = value;
+			}
+
+			// Treat null/undefined as ""; convert numbers to string
+			if ( val == null ) {
+				val = "";
+
+			} else if ( typeof val === "number" ) {
+				val += "";
+
+			} else if ( Array.isArray( val ) ) {
+				val = jQuery.map( val, function( value ) {
+					return value == null ? "" : value + "";
+				} );
+			}
+
+			hooks = jQuery.valHooks[ this.type ] || jQuery.valHooks[ this.nodeName.toLowerCase() ];
+
+			// If set returns undefined, fall back to normal setting
+			if ( !hooks || !( "set" in hooks ) || hooks.set( this, val, "value" ) === undefined ) {
+				this.value = val;
+			}
+		} );
+	}
+} );
+
+jQuery.extend( {
+	valHooks: {
+		option: {
+			get: function( elem ) {
+
+				var val = jQuery.find.attr( elem, "value" );
+				return val != null ?
+					val :
+
+					// Support: IE <=10 - 11 only
+					// option.text throws exceptions (#14686, #14858)
+					// Strip and collapse whitespace
+					// https://html.spec.whatwg.org/#strip-and-collapse-whitespace
+					stripAndCollapse( jQuery.text( elem ) );
+			}
+		},
+		select: {
+			get: function( elem ) {
+				var value, option, i,
+					options = elem.options,
+					index = elem.selectedIndex,
+					one = elem.type === "select-one",
+					values = one ? null : [],
+					max = one ? index + 1 : options.length;
+
+				if ( index < 0 ) {
+					i = max;
+
+				} else {
+					i = one ? index : 0;
+				}
+
+				// Loop through all the selected options
+				for ( ; i < max; i++ ) {
+					option = options[ i ];
+
+					// Support: IE <=9 only
+					// IE8-9 doesn't update selected after form reset (#2551)
+					if ( ( option.selected || i === index ) &&
+
+							// Don't return options that are disabled or in a disabled optgroup
+							!option.disabled &&
+							( !option.parentNode.disabled ||
+								!nodeName( option.parentNode, "optgroup" ) ) ) {
+
+						// Get the specific value for the option
+						value = jQuery( option ).val();
+
+						// We don't need an array for one selects
+						if ( one ) {
+							return value;
+						}
+
+						// Multi-Selects return an array
+						values.push( value );
+					}
+				}
+
+				return values;
+			},
+
+			set: function( elem, value ) {
+				var optionSet, option,
+					options = elem.options,
+					values = jQuery.makeArray( value ),
+					i = options.length;
+
+				while ( i-- ) {
+					option = options[ i ];
+
+					/* eslint-disable no-cond-assign */
+
+					if ( option.selected =
+						jQuery.inArray( jQuery.valHooks.option.get( option ), values ) > -1
+					) {
+						optionSet = true;
+					}
+
+					/* eslint-enable no-cond-assign */
+				}
+
+				// Force browsers to behave consistently when non-matching value is set
+				if ( !optionSet ) {
+					elem.selectedIndex = -1;
+				}
+				return values;
+			}
+		}
+	}
+} );
+
+// Radios and checkboxes getter/setter
+jQuery.each( [ "radio", "checkbox" ], function() {
+	jQuery.valHooks[ this ] = {
+		set: function( elem, value ) {
+			if ( Array.isArray( value ) ) {
+				return ( elem.checked = jQuery.inArray( jQuery( elem ).val(), value ) > -1 );
+			}
+		}
+	};
+	if ( !support.checkOn ) {
+		jQuery.valHooks[ this ].get = function( elem ) {
+			return elem.getAttribute( "value" ) === null ? "on" : elem.value;
+		};
+	}
+} );
+
+
+
+
+// Return jQuery for attributes-only inclusion
+
+
+support.focusin = "onfocusin" in window;
+
+
+var rfocusMorph = /^(?:focusinfocus|focusoutblur)$/,
+	stopPropagationCallback = function( e ) {
+		e.stopPropagation();
+	};
+
+jQuery.extend( jQuery.event, {
+
+	trigger: function( event, data, elem, onlyHandlers ) {
+
+		var i, cur, tmp, bubbleType, ontype, handle, special, lastElement,
+			eventPath = [ elem || document ],
+			type = hasOwn.call( event, "type" ) ? event.type : event,
+			namespaces = hasOwn.call( event, "namespace" ) ? event.namespace.split( "." ) : [];
+
+		cur = lastElement = tmp = elem = elem || document;
+
+		// Don't do events on text and comment nodes
+		if ( elem.nodeType === 3 || elem.nodeType === 8 ) {
+			return;
+		}
+
+		// focus/blur morphs to focusin/out; ensure we're not firing them right now
+		if ( rfocusMorph.test( type + jQuery.event.triggered ) ) {
+			return;
+		}
+
+		if ( type.indexOf( "." ) > -1 ) {
+
+			// Namespaced trigger; create a regexp to match event type in handle()
+			namespaces = type.split( "." );
+			type = namespaces.shift();
+			namespaces.sort();
+		}
+		ontype = type.indexOf( ":" ) < 0 && "on" + type;
+
+		// Caller can pass in a jQuery.Event object, Object, or just an event type string
+		event = event[ jQuery.expando ] ?
+			event :
+			new jQuery.Event( type, typeof event === "object" && event );
+
+		// Trigger bitmask: & 1 for native handlers; & 2 for jQuery (always true)
+		event.isTrigger = onlyHandlers ? 2 : 3;
+		event.namespace = namespaces.join( "." );
+		event.rnamespace = event.namespace ?
+			new RegExp( "(^|\\.)" + namespaces.join( "\\.(?:.*\\.|)" ) + "(\\.|$)" ) :
+			null;
+
+		// Clean up the event in case it is being reused
+		event.result = undefined;
+		if ( !event.target ) {
+			event.target = elem;
+		}
+
+		// Clone any incoming data and prepend the event, creating the handler arg list
+		data = data == null ?
+			[ event ] :
+			jQuery.makeArray( data, [ event ] );
+
+		// Allow special events to draw outside the lines
+		special = jQuery.event.special[ type ] || {};
+		if ( !onlyHandlers && special.trigger && special.trigger.apply( elem, data ) === false ) {
+			return;
+		}
+
+		// Determine event propagation path in advance, per W3C events spec (#9951)
+		// Bubble up to document, then to window; watch for a global ownerDocument var (#9724)
+		if ( !onlyHandlers && !special.noBubble && !isWindow( elem ) ) {
+
+			bubbleType = special.delegateType || type;
+			if ( !rfocusMorph.test( bubbleType + type ) ) {
+				cur = cur.parentNode;
+			}
+			for ( ; cur; cur = cur.parentNode ) {
+				eventPath.push( cur );
+				tmp = cur;
+			}
+
+			// Only add window if we got to document (e.g., not plain obj or detached DOM)
+			if ( tmp === ( elem.ownerDocument || document ) ) {
+				eventPath.push( tmp.defaultView || tmp.parentWindow || window );
+			}
+		}
+
+		// Fire handlers on the event path
+		i = 0;
+		while ( ( cur = eventPath[ i++ ] ) && !event.isPropagationStopped() ) {
+			lastElement = cur;
+			event.type = i > 1 ?
+				bubbleType :
+				special.bindType || type;
+
+			// jQuery handler
+			handle = ( dataPriv.get( cur, "events" ) || Object.create( null ) )[ event.type ] &&
+				dataPriv.get( cur, "handle" );
+			if ( handle ) {
+				handle.apply( cur, data );
+			}
+
+			// Native handler
+			handle = ontype && cur[ ontype ];
+			if ( handle && handle.apply && acceptData( cur ) ) {
+				event.result = handle.apply( cur, data );
+				if ( event.result === false ) {
+					event.preventDefault();
+				}
+			}
+		}
+		event.type = type;
+
+		// If nobody prevented the default action, do it now
+		if ( !onlyHandlers && !event.isDefaultPrevented() ) {
+
+			if ( ( !special._default ||
+				special._default.apply( eventPath.pop(), data ) === false ) &&
+				acceptData( elem ) ) {
+
+				// Call a native DOM method on the target with the same name as the event.
+				// Don't do default actions on window, that's where global variables be (#6170)
+				if ( ontype && isFunction( elem[ type ] ) && !isWindow( elem ) ) {
+
+					// Don't re-trigger an onFOO event when we call its FOO() method
+					tmp = elem[ ontype ];
+
+					if ( tmp ) {
+						elem[ ontype ] = null;
+					}
+
+					// Prevent re-triggering of the same event, since we already bubbled it above
+					jQuery.event.triggered = type;
+
+					if ( event.isPropagationStopped() ) {
+						lastElement.addEventListener( type, stopPropagationCallback );
+					}
+
+					elem[ type ]();
+
+					if ( event.isPropagationStopped() ) {
+						lastElement.removeEventListener( type, stopPropagationCallback );
+					}
+
+					jQuery.event.triggered = undefined;
+
+					if ( tmp ) {
+						elem[ ontype ] = tmp;
+					}
+				}
+			}
+		}
+
+		return event.result;
+	},
+
+	// Piggyback on a donor event to simulate a different one
+	// Used only for `focus(in | out)` events
+	simulate: function( type, elem, event ) {
+		var e = jQuery.extend(
+			new jQuery.Event(),
+			event,
+			{
+				type: type,
+				isSimulated: true
+			}
+		);
+
+		jQuery.event.trigger( e, null, elem );
+	}
+
+} );
+
+jQuery.fn.extend( {
+
+	trigger: function( type, data ) {
+		return this.each( function() {
+			jQuery.event.trigger( type, data, this );
+		} );
+	},
+	triggerHandler: function( type, data ) {
+		var elem = this[ 0 ];
+		if ( elem ) {
+			return jQuery.event.trigger( type, data, elem, true );
+		}
+	}
+} );
+
+
+// Support: Firefox <=44
+// Firefox doesn't have focus(in | out) events
+// Related ticket - https://bugzilla.mozilla.org/show_bug.cgi?id=687787
+//
+// Support: Chrome <=48 - 49, Safari <=9.0 - 9.1
+// focus(in | out) events fire after focus & blur events,
+// which is spec violation - http://www.w3.org/TR/DOM-Level-3-Events/#events-focusevent-event-order
+// Related ticket - https://bugs.chromium.org/p/chromium/issues/detail?id=449857
+if ( !support.focusin ) {
+	jQuery.each( { focus: "focusin", blur: "focusout" }, function( orig, fix ) {
+
+		// Attach a single capturing handler on the document while someone wants focusin/focusout
+		var handler = function( event ) {
+			jQuery.event.simulate( fix, event.target, jQuery.event.fix( event ) );
+		};
+
+		jQuery.event.special[ fix ] = {
+			setup: function() {
+
+				// Handle: regular nodes (via `this.ownerDocument`), window
+				// (via `this.document`) & document (via `this`).
+				var doc = this.ownerDocument || this.document || this,
+					attaches = dataPriv.access( doc, fix );
+
+				if ( !attaches ) {
+					doc.addEventListener( orig, handler, true );
+				}
+				dataPriv.access( doc, fix, ( attaches || 0 ) + 1 );
+			},
+			teardown: function() {
+				var doc = this.ownerDocument || this.document || this,
+					attaches = dataPriv.access( doc, fix ) - 1;
+
+				if ( !attaches ) {
+					doc.removeEventListener( orig, handler, true );
+					dataPriv.remove( doc, fix );
+
+				} else {
+					dataPriv.access( doc, fix, attaches );
+				}
+			}
+		};
+	} );
+}
+var location = window.location;
+
+var nonce = { guid: Date.now() };
+
+var rquery = ( /\?/ );
+
+
+
+// Cross-browser xml parsing
+jQuery.parseXML = function( data ) {
+	var xml, parserErrorElem;
+	if ( !data || typeof data !== "string" ) {
+		return null;
+	}
+
+	// Support: IE 9 - 11 only
+	// IE throws on parseFromString with invalid input.
+	try {
+		xml = ( new window.DOMParser() ).parseFromString( data, "text/xml" );
+	} catch ( e ) {}
+
+	parserErrorElem = xml && xml.getElementsByTagName( "parsererror" )[ 0 ];
+	if ( !xml || parserErrorElem ) {
+		jQuery.error( "Invalid XML: " + (
+			parserErrorElem ?
+				jQuery.map( parserErrorElem.childNodes, function( el ) {
+					return el.textContent;
+				} ).join( "\n" ) :
+				data
+		) );
+	}
+	return xml;
+};
+
+
+var
+	rbracket = /\[\]$/,
+	rCRLF = /\r?\n/g,
+	rsubmitterTypes = /^(?:submit|button|image|reset|file)$/i,
+	rsubmittable = /^(?:input|select|textarea|keygen)/i;
+
+function buildParams( prefix, obj, traditional, add ) {
+	var name;
+
+	if ( Array.isArray( obj ) ) {
+
+		// Serialize array item.
+		jQuery.each( obj, function( i, v ) {
+			if ( traditional || rbracket.test( prefix ) ) {
+
+				// Treat each array item as a scalar.
+				add( prefix, v );
+
+			} else {
+
+				// Item is non-scalar (array or object), encode its numeric index.
+				buildParams(
+					prefix + "[" + ( typeof v === "object" && v != null ? i : "" ) + "]",
+					v,
+					traditional,
+					add
+				);
+			}
+		} );
+
+	} else if ( !traditional && toType( obj ) === "object" ) {
+
+		// Serialize object item.
+		for ( name in obj ) {
+			buildParams( prefix + "[" + name + "]", obj[ name ], traditional, add );
+		}
+
+	} else {
+
+		// Serialize scalar item.
+		add( prefix, obj );
+	}
+}
+
+// Serialize an array of form elements or a set of
+// key/values into a query string
+jQuery.param = function( a, traditional ) {
+	var prefix,
+		s = [],
+		add = function( key, valueOrFunction ) {
+
+			// If value is a function, invoke it and use its return value
+			var value = isFunction( valueOrFunction ) ?
+				valueOrFunction() :
+				valueOrFunction;
+
+			s[ s.length ] = encodeURIComponent( key ) + "=" +
+				encodeURIComponent( value == null ? "" : value );
+		};
+
+	if ( a == null ) {
+		return "";
+	}
+
+	// If an array was passed in, assume that it is an array of form elements.
+	if ( Array.isArray( a ) || ( a.jquery && !jQuery.isPlainObject( a ) ) ) {
+
+		// Serialize the form elements
+		jQuery.each( a, function() {
+			add( this.name, this.value );
+		} );
+
+	} else {
+
+		// If traditional, encode the "old" way (the way 1.3.2 or older
+		// did it), otherwise encode params recursively.
+		for ( prefix in a ) {
+			buildParams( prefix, a[ prefix ], traditional, add );
+		}
+	}
+
+	// Return the resulting serialization
+	return s.join( "&" );
+};
+
+jQuery.fn.extend( {
+	serialize: function() {
+		return jQuery.param( this.serializeArray() );
+	},
+	serializeArray: function() {
+		return this.map( function() {
+
+			// Can add propHook for "elements" to filter or add form elements
+			var elements = jQuery.prop( this, "elements" );
+			return elements ? jQuery.makeArray( elements ) : this;
+		} ).filter( function() {
+			var type = this.type;
+
+			// Use .is( ":disabled" ) so that fieldset[disabled] works
+			return this.name && !jQuery( this ).is( ":disabled" ) &&
+				rsubmittable.test( this.nodeName ) && !rsubmitterTypes.test( type ) &&
+				( this.checked || !rcheckableType.test( type ) );
+		} ).map( function( _i, elem ) {
+			var val = jQuery( this ).val();
+
+			if ( val == null ) {
+				return null;
+			}
+
+			if ( Array.isArray( val ) ) {
+				return jQuery.map( val, function( val ) {
+					return { name: elem.name, value: val.replace( rCRLF, "\r\n" ) };
+				} );
+			}
+
+			return { name: elem.name, value: val.replace( rCRLF, "\r\n" ) };
+		} ).get();
+	}
+} );
+
+
+var
+	r20 = /%20/g,
+	rhash = /#.*$/,
+	rantiCache = /([?&])_=[^&]*/,
+	rheaders = /^(.*?):[ \t]*([^\r\n]*)$/mg,
+
+	// #7653, #8125, #8152: local protocol detection
+	rlocalProtocol = /^(?:about|app|app-storage|.+-extension|file|res|widget):$/,
+	rnoContent = /^(?:GET|HEAD)$/,
+	rprotocol = /^\/\//,
+
+	/* Prefilters
+	 * 1) They are useful to introduce custom dataTypes (see ajax/jsonp.js for an example)
+	 * 2) These are called:
+	 *    - BEFORE asking for a transport
+	 *    - AFTER param serialization (s.data is a string if s.processData is true)
+	 * 3) key is the dataType
+	 * 4) the catchall symbol "*" can be used
+	 * 5) execution will start with transport dataType and THEN continue down to "*" if needed
+	 */
+	prefilters = {},
+
+	/* Transports bindings
+	 * 1) key is the dataType
+	 * 2) the catchall symbol "*" can be used
+	 * 3) selection will start with transport dataType and THEN go to "*" if needed
+	 */
+	transports = {},
+
+	// Avoid comment-prolog char sequence (#10098); must appease lint and evade compression
+	allTypes = "*/".concat( "*" ),
+
+	// Anchor tag for parsing the document origin
+	originAnchor = document.createElement( "a" );
+
+originAnchor.href = location.href;
+
+// Base "constructor" for jQuery.ajaxPrefilter and jQuery.ajaxTransport
+function addToPrefiltersOrTransports( structure ) {
+
+	// dataTypeExpression is optional and defaults to "*"
+	return function( dataTypeExpression, func ) {
+
+		if ( typeof dataTypeExpression !== "string" ) {
+			func = dataTypeExpression;
+			dataTypeExpression = "*";
+		}
+
+		var dataType,
+			i = 0,
+			dataTypes = dataTypeExpression.toLowerCase().match( rnothtmlwhite ) || [];
+
+		if ( isFunction( func ) ) {
+
+			// For each dataType in the dataTypeExpression
+			while ( ( dataType = dataTypes[ i++ ] ) ) {
+
+				// Prepend if requested
+				if ( dataType[ 0 ] === "+" ) {
+					dataType = dataType.slice( 1 ) || "*";
+					( structure[ dataType ] = structure[ dataType ] || [] ).unshift( func );
+
+				// Otherwise append
+				} else {
+					( structure[ dataType ] = structure[ dataType ] || [] ).push( func );
+				}
+			}
+		}
+	};
+}
+
+// Base inspection function for prefilters and transports
+function inspectPrefiltersOrTransports( structure, options, originalOptions, jqXHR ) {
+
+	var inspected = {},
+		seekingTransport = ( structure === transports );
+
+	function inspect( dataType ) {
+		var selected;
+		inspected[ dataType ] = true;
+		jQuery.each( structure[ dataType ] || [], function( _, prefilterOrFactory ) {
+			var dataTypeOrTransport = prefilterOrFactory( options, originalOptions, jqXHR );
+			if ( typeof dataTypeOrTransport === "string" &&
+				!seekingTransport && !inspected[ dataTypeOrTransport ] ) {
+
+				options.dataTypes.unshift( dataTypeOrTransport );
+				inspect( dataTypeOrTransport );
+				return false;
+			} else if ( seekingTransport ) {
+				return !( selected = dataTypeOrTransport );
+			}
+		} );
+		return selected;
+	}
+
+	return inspect( options.dataTypes[ 0 ] ) || !inspected[ "*" ] && inspect( "*" );
+}
+
+// A special extend for ajax options
+// that takes "flat" options (not to be deep extended)
+// Fixes #9887
+function ajaxExtend( target, src ) {
+	var key, deep,
+		flatOptions = jQuery.ajaxSettings.flatOptions || {};
+
+	for ( key in src ) {
+		if ( src[ key ] !== undefined ) {
+			( flatOptions[ key ] ? target : ( deep || ( deep = {} ) ) )[ key ] = src[ key ];
+		}
+	}
+	if ( deep ) {
+		jQuery.extend( true, target, deep );
+	}
+
+	return target;
+}
+
+/* Handles responses to an ajax request:
+ * - finds the right dataType (mediates between content-type and expected dataType)
+ * - returns the corresponding response
+ */
+function ajaxHandleResponses( s, jqXHR, responses ) {
+
+	var ct, type, finalDataType, firstDataType,
+		contents = s.contents,
+		dataTypes = s.dataTypes;
+
+	// Remove auto dataType and get content-type in the process
+	while ( dataTypes[ 0 ] === "*" ) {
+		dataTypes.shift();
+		if ( ct === undefined ) {
+			ct = s.mimeType || jqXHR.getResponseHeader( "Content-Type" );
+		}
+	}
+
+	// Check if we're dealing with a known content-type
+	if ( ct ) {
+		for ( type in contents ) {
+			if ( contents[ type ] && contents[ type ].test( ct ) ) {
+				dataTypes.unshift( type );
+				break;
+			}
+		}
+	}
+
+	// Check to see if we have a response for the expected dataType
+	if ( dataTypes[ 0 ] in responses ) {
+		finalDataType = dataTypes[ 0 ];
+	} else {
+
+		// Try convertible dataTypes
+		for ( type in responses ) {
+			if ( !dataTypes[ 0 ] || s.converters[ type + " " + dataTypes[ 0 ] ] ) {
+				finalDataType = type;
+				break;
+			}
+			if ( !firstDataType ) {
+				firstDataType = type;
+			}
+		}
+
+		// Or just use first one
+		finalDataType = finalDataType || firstDataType;
+	}
+
+	// If we found a dataType
+	// We add the dataType to the list if needed
+	// and return the corresponding response
+	if ( finalDataType ) {
+		if ( finalDataType !== dataTypes[ 0 ] ) {
+			dataTypes.unshift( finalDataType );
+		}
+		return responses[ finalDataType ];
+	}
+}
+
+/* Chain conversions given the request and the original response
+ * Also sets the responseXXX fields on the jqXHR instance
+ */
+function ajaxConvert( s, response, jqXHR, isSuccess ) {
+	var conv2, current, conv, tmp, prev,
+		converters = {},
+
+		// Work with a copy of dataTypes in case we need to modify it for conversion
+		dataTypes = s.dataTypes.slice();
+
+	// Create converters map with lowercased keys
+	if ( dataTypes[ 1 ] ) {
+		for ( conv in s.converters ) {
+			converters[ conv.toLowerCase() ] = s.converters[ conv ];
+		}
+	}
+
+	current = dataTypes.shift();
+
+	// Convert to each sequential dataType
+	while ( current ) {
+
+		if ( s.responseFields[ current ] ) {
+			jqXHR[ s.responseFields[ current ] ] = response;
+		}
+
+		// Apply the dataFilter if provided
+		if ( !prev && isSuccess && s.dataFilter ) {
+			response = s.dataFilter( response, s.dataType );
+		}
+
+		prev = current;
+		current = dataTypes.shift();
+
+		if ( current ) {
+
+			// There's only work to do if current dataType is non-auto
+			if ( current === "*" ) {
+
+				current = prev;
+
+			// Convert response if prev dataType is non-auto and differs from current
+			} else if ( prev !== "*" && prev !== current ) {
+
+				// Seek a direct converter
+				conv = converters[ prev + " " + current ] || converters[ "* " + current ];
+
+				// If none found, seek a pair
+				if ( !conv ) {
+					for ( conv2 in converters ) {
+
+						// If conv2 outputs current
+						tmp = conv2.split( " " );
+						if ( tmp[ 1 ] === current ) {
+
+							// If prev can be converted to accepted input
+							conv = converters[ prev + " " + tmp[ 0 ] ] ||
+								converters[ "* " + tmp[ 0 ] ];
+							if ( conv ) {
+
+								// Condense equivalence converters
+								if ( conv === true ) {
+									conv = converters[ conv2 ];
+
+								// Otherwise, insert the intermediate dataType
+								} else if ( converters[ conv2 ] !== true ) {
+									current = tmp[ 0 ];
+									dataTypes.unshift( tmp[ 1 ] );
+								}
+								break;
+							}
+						}
+					}
+				}
+
+				// Apply converter (if not an equivalence)
+				if ( conv !== true ) {
+
+					// Unless errors are allowed to bubble, catch and return them
+					if ( conv && s.throws ) {
+						response = conv( response );
+					} else {
+						try {
+							response = conv( response );
+						} catch ( e ) {
+							return {
+								state: "parsererror",
+								error: conv ? e : "No conversion from " + prev + " to " + current
+							};
+						}
+					}
+				}
+			}
+		}
+	}
+
+	return { state: "success", data: response };
+}
+
+jQuery.extend( {
+
+	// Counter for holding the number of active queries
+	active: 0,
+
+	// Last-Modified header cache for next request
+	lastModified: {},
+	etag: {},
+
+	ajaxSettings: {
+		url: location.href,
+		type: "GET",
+		isLocal: rlocalProtocol.test( location.protocol ),
+		global: true,
+		processData: true,
+		async: true,
+		contentType: "application/x-www-form-urlencoded; charset=UTF-8",
+
+		/*
+		timeout: 0,
+		data: null,
+		dataType: null,
+		username: null,
+		password: null,
+		cache: null,
+		throws: false,
+		traditional: false,
+		headers: {},
+		*/
+
+		accepts: {
+			"*": allTypes,
+			text: "text/plain",
+			html: "text/html",
+			xml: "application/xml, text/xml",
+			json: "application/json, text/javascript"
+		},
+
+		contents: {
+			xml: /\bxml\b/,
+			html: /\bhtml/,
+			json: /\bjson\b/
+		},
+
+		responseFields: {
+			xml: "responseXML",
+			text: "responseText",
+			json: "responseJSON"
+		},
+
+		// Data converters
+		// Keys separate source (or catchall "*") and destination types with a single space
+		converters: {
+
+			// Convert anything to text
+			"* text": String,
+
+			// Text to html (true = no transformation)
+			"text html": true,
+
+			// Evaluate text as a json expression
+			"text json": JSON.parse,
+
+			// Parse text as xml
+			"text xml": jQuery.parseXML
+		},
+
+		// For options that shouldn't be deep extended:
+		// you can add your own custom options here if
+		// and when you create one that shouldn't be
+		// deep extended (see ajaxExtend)
+		flatOptions: {
+			url: true,
+			context: true
+		}
+	},
+
+	// Creates a full fledged settings object into target
+	// with both ajaxSettings and settings fields.
+	// If target is omitted, writes into ajaxSettings.
+	ajaxSetup: function( target, settings ) {
+		return settings ?
+
+			// Building a settings object
+			ajaxExtend( ajaxExtend( target, jQuery.ajaxSettings ), settings ) :
+
+			// Extending ajaxSettings
+			ajaxExtend( jQuery.ajaxSettings, target );
+	},
+
+	ajaxPrefilter: addToPrefiltersOrTransports( prefilters ),
+	ajaxTransport: addToPrefiltersOrTransports( transports ),
+
+	// Main method
+	ajax: function( url, options ) {
+
+		// If url is an object, simulate pre-1.5 signature
+		if ( typeof url === "object" ) {
+			options = url;
+			url = undefined;
+		}
+
+		// Force options to be an object
+		options = options || {};
+
+		var transport,
+
+			// URL without anti-cache param
+			cacheURL,
+
+			// Response headers
+			responseHeadersString,
+			responseHeaders,
+
+			// timeout handle
+			timeoutTimer,
+
+			// Url cleanup var
+			urlAnchor,
+
+			// Request state (becomes false upon send and true upon completion)
+			completed,
+
+			// To know if global events are to be dispatched
+			fireGlobals,
+
+			// Loop variable
+			i,
+
+			// uncached part of the url
+			uncached,
+
+			// Create the final options object
+			s = jQuery.ajaxSetup( {}, options ),
+
+			// Callbacks context
+			callbackContext = s.context || s,
+
+			// Context for global events is callbackContext if it is a DOM node or jQuery collection
+			globalEventContext = s.context &&
+				( callbackContext.nodeType || callbackContext.jquery ) ?
+				jQuery( callbackContext ) :
+				jQuery.event,
+
+			// Deferreds
+			deferred = jQuery.Deferred(),
+			completeDeferred = jQuery.Callbacks( "once memory" ),
+
+			// Status-dependent callbacks
+			statusCode = s.statusCode || {},
+
+			// Headers (they are sent all at once)
+			requestHeaders = {},
+			requestHeadersNames = {},
+
+			// Default abort message
+			strAbort = "canceled",
+
+			// Fake xhr
+			jqXHR = {
+				readyState: 0,
+
+				// Builds headers hashtable if needed
+				getResponseHeader: function( key ) {
+					var match;
+					if ( completed ) {
+						if ( !responseHeaders ) {
+							responseHeaders = {};
+							while ( ( match = rheaders.exec( responseHeadersString ) ) ) {
+								responseHeaders[ match[ 1 ].toLowerCase() + " " ] =
+									( responseHeaders[ match[ 1 ].toLowerCase() + " " ] || [] )
+										.concat( match[ 2 ] );
+							}
+						}
+						match = responseHeaders[ key.toLowerCase() + " " ];
+					}
+					return match == null ? null : match.join( ", " );
+				},
+
+				// Raw string
+				getAllResponseHeaders: function() {
+					return completed ? responseHeadersString : null;
+				},
+
+				// Caches the header
+				setRequestHeader: function( name, value ) {
+					if ( completed == null ) {
+						name = requestHeadersNames[ name.toLowerCase() ] =
+							requestHeadersNames[ name.toLowerCase() ] || name;
+						requestHeaders[ name ] = value;
+					}
+					return this;
+				},
+
+				// Overrides response content-type header
+				overrideMimeType: function( type ) {
+					if ( completed == null ) {
+						s.mimeType = type;
+					}
+					return this;
+				},
+
+				// Status-dependent callbacks
+				statusCode: function( map ) {
+					var code;
+					if ( map ) {
+						if ( completed ) {
+
+							// Execute the appropriate callbacks
+							jqXHR.always( map[ jqXHR.status ] );
+						} else {
+
+							// Lazy-add the new callbacks in a way that preserves old ones
+							for ( code in map ) {
+								statusCode[ code ] = [ statusCode[ code ], map[ code ] ];
+							}
+						}
+					}
+					return this;
+				},
+
+				// Cancel the request
+				abort: function( statusText ) {
+					var finalText = statusText || strAbort;
+					if ( transport ) {
+						transport.abort( finalText );
+					}
+					done( 0, finalText );
+					return this;
+				}
+			};
+
+		// Attach deferreds
+		deferred.promise( jqXHR );
+
+		// Add protocol if not provided (prefilters might expect it)
+		// Handle falsy url in the settings object (#10093: consistency with old signature)
+		// We also use the url parameter if available
+		s.url = ( ( url || s.url || location.href ) + "" )
+			.replace( rprotocol, location.protocol + "//" );
+
+		// Alias method option to type as per ticket #12004
+		s.type = options.method || options.type || s.method || s.type;
+
+		// Extract dataTypes list
+		s.dataTypes = ( s.dataType || "*" ).toLowerCase().match( rnothtmlwhite ) || [ "" ];
+
+		// A cross-domain request is in order when the origin doesn't match the current origin.
+		if ( s.crossDomain == null ) {
+			urlAnchor = document.createElement( "a" );
+
+			// Support: IE <=8 - 11, Edge 12 - 15
+			// IE throws exception on accessing the href property if url is malformed,
+			// e.g. http://example.com:80x/
+			try {
+				urlAnchor.href = s.url;
+
+				// Support: IE <=8 - 11 only
+				// Anchor's host property isn't correctly set when s.url is relative
+				urlAnchor.href = urlAnchor.href;
+				s.crossDomain = originAnchor.protocol + "//" + originAnchor.host !==
+					urlAnchor.protocol + "//" + urlAnchor.host;
+			} catch ( e ) {
+
+				// If there is an error parsing the URL, assume it is crossDomain,
+				// it can be rejected by the transport if it is invalid
+				s.crossDomain = true;
+			}
+		}
+
+		// Convert data if not already a string
+		if ( s.data && s.processData && typeof s.data !== "string" ) {
+			s.data = jQuery.param( s.data, s.traditional );
+		}
+
+		// Apply prefilters
+		inspectPrefiltersOrTransports( prefilters, s, options, jqXHR );
+
+		// If request was aborted inside a prefilter, stop there
+		if ( completed ) {
+			return jqXHR;
+		}
+
+		// We can fire global events as of now if asked to
+		// Don't fire events if jQuery.event is undefined in an AMD-usage scenario (#15118)
+		fireGlobals = jQuery.event && s.global;
+
+		// Watch for a new set of requests
+		if ( fireGlobals && jQuery.active++ === 0 ) {
+			jQuery.event.trigger( "ajaxStart" );
+		}
+
+		// Uppercase the type
+		s.type = s.type.toUpperCase();
+
+		// Determine if request has content
+		s.hasContent = !rnoContent.test( s.type );
+
+		// Save the URL in case we're toying with the If-Modified-Since
+		// and/or If-None-Match header later on
+		// Remove hash to simplify url manipulation
+		cacheURL = s.url.replace( rhash, "" );
+
+		// More options handling for requests with no content
+		if ( !s.hasContent ) {
+
+			// Remember the hash so we can put it back
+			uncached = s.url.slice( cacheURL.length );
+
+			// If data is available and should be processed, append data to url
+			if ( s.data && ( s.processData || typeof s.data === "string" ) ) {
+				cacheURL += ( rquery.test( cacheURL ) ? "&" : "?" ) + s.data;
+
+				// #9682: remove data so that it's not used in an eventual retry
+				delete s.data;
+			}
+
+			// Add or update anti-cache param if needed
+			if ( s.cache === false ) {
+				cacheURL = cacheURL.replace( rantiCache, "$1" );
+				uncached = ( rquery.test( cacheURL ) ? "&" : "?" ) + "_=" + ( nonce.guid++ ) +
+					uncached;
+			}
+
+			// Put hash and anti-cache on the URL that will be requested (gh-1732)
+			s.url = cacheURL + uncached;
+
+		// Change '%20' to '+' if this is encoded form body content (gh-2658)
+		} else if ( s.data && s.processData &&
+			( s.contentType || "" ).indexOf( "application/x-www-form-urlencoded" ) === 0 ) {
+			s.data = s.data.replace( r20, "+" );
+		}
+
+		// Set the If-Modified-Since and/or If-None-Match header, if in ifModified mode.
+		if ( s.ifModified ) {
+			if ( jQuery.lastModified[ cacheURL ] ) {
+				jqXHR.setRequestHeader( "If-Modified-Since", jQuery.lastModified[ cacheURL ] );
+			}
+			if ( jQuery.etag[ cacheURL ] ) {
+				jqXHR.setRequestHeader( "If-None-Match", jQuery.etag[ cacheURL ] );
+			}
+		}
+
+		// Set the correct header, if data is being sent
+		if ( s.data && s.hasContent && s.contentType !== false || options.contentType ) {
+			jqXHR.setRequestHeader( "Content-Type", s.contentType );
+		}
+
+		// Set the Accepts header for the server, depending on the dataType
+		jqXHR.setRequestHeader(
+			"Accept",
+			s.dataTypes[ 0 ] && s.accepts[ s.dataTypes[ 0 ] ] ?
+				s.accepts[ s.dataTypes[ 0 ] ] +
+					( s.dataTypes[ 0 ] !== "*" ? ", " + allTypes + "; q=0.01" : "" ) :
+				s.accepts[ "*" ]
+		);
+
+		// Check for headers option
+		for ( i in s.headers ) {
+			jqXHR.setRequestHeader( i, s.headers[ i ] );
+		}
+
+		// Allow custom headers/mimetypes and early abort
+		if ( s.beforeSend &&
+			( s.beforeSend.call( callbackContext, jqXHR, s ) === false || completed ) ) {
+
+			// Abort if not done already and return
+			return jqXHR.abort();
+		}
+
+		// Aborting is no longer a cancellation
+		strAbort = "abort";
+
+		// Install callbacks on deferreds
+		completeDeferred.add( s.complete );
+		jqXHR.done( s.success );
+		jqXHR.fail( s.error );
+
+		// Get transport
+		transport = inspectPrefiltersOrTransports( transports, s, options, jqXHR );
+
+		// If no transport, we auto-abort
+		if ( !transport ) {
+			done( -1, "No Transport" );
+		} else {
+			jqXHR.readyState = 1;
+
+			// Send global event
+			if ( fireGlobals ) {
+				globalEventContext.trigger( "ajaxSend", [ jqXHR, s ] );
+			}
+
+			// If request was aborted inside ajaxSend, stop there
+			if ( completed ) {
+				return jqXHR;
+			}
+
+			// Timeout
+			if ( s.async && s.timeout > 0 ) {
+				timeoutTimer = window.setTimeout( function() {
+					jqXHR.abort( "timeout" );
+				}, s.timeout );
+			}
+
+			try {
+				completed = false;
+				transport.send( requestHeaders, done );
+			} catch ( e ) {
+
+				// Rethrow post-completion exceptions
+				if ( completed ) {
+					throw e;
+				}
+
+				// Propagate others as results
+				done( -1, e );
+			}
+		}
+
+		// Callback for when everything is done
+		function done( status, nativeStatusText, responses, headers ) {
+			var isSuccess, success, error, response, modified,
+				statusText = nativeStatusText;
+
+			// Ignore repeat invocations
+			if ( completed ) {
+				return;
+			}
+
+			completed = true;
+
+			// Clear timeout if it exists
+			if ( timeoutTimer ) {
+				window.clearTimeout( timeoutTimer );
+			}
+
+			// Dereference transport for early garbage collection
+			// (no matter how long the jqXHR object will be used)
+			transport = undefined;
+
+			// Cache response headers
+			responseHeadersString = headers || "";
+
+			// Set readyState
+			jqXHR.readyState = status > 0 ? 4 : 0;
+
+			// Determine if successful
+			isSuccess = status >= 200 && status < 300 || status === 304;
+
+			// Get response data
+			if ( responses ) {
+				response = ajaxHandleResponses( s, jqXHR, responses );
+			}
+
+			// Use a noop converter for missing script but not if jsonp
+			if ( !isSuccess &&
+				jQuery.inArray( "script", s.dataTypes ) > -1 &&
+				jQuery.inArray( "json", s.dataTypes ) < 0 ) {
+				s.converters[ "text script" ] = function() {};
+			}
+
+			// Convert no matter what (that way responseXXX fields are always set)
+			response = ajaxConvert( s, response, jqXHR, isSuccess );
+
+			// If successful, handle type chaining
+			if ( isSuccess ) {
+
+				// Set the If-Modified-Since and/or If-None-Match header, if in ifModified mode.
+				if ( s.ifModified ) {
+					modified = jqXHR.getResponseHeader( "Last-Modified" );
+					if ( modified ) {
+						jQuery.lastModified[ cacheURL ] = modified;
+					}
+					modified = jqXHR.getResponseHeader( "etag" );
+					if ( modified ) {
+						jQuery.etag[ cacheURL ] = modified;
+					}
+				}
+
+				// if no content
+				if ( status === 204 || s.type === "HEAD" ) {
+					statusText = "nocontent";
+
+				// if not modified
+				} else if ( status === 304 ) {
+					statusText = "notmodified";
+
+				// If we have data, let's convert it
+				} else {
+					statusText = response.state;
+					success = response.data;
+					error = response.error;
+					isSuccess = !error;
+				}
+			} else {
+
+				// Extract error from statusText and normalize for non-aborts
+				error = statusText;
+				if ( status || !statusText ) {
+					statusText = "error";
+					if ( status < 0 ) {
+						status = 0;
+					}
+				}
+			}
+
+			// Set data for the fake xhr object
+			jqXHR.status = status;
+			jqXHR.statusText = ( nativeStatusText || statusText ) + "";
+
+			// Success/Error
+			if ( isSuccess ) {
+				deferred.resolveWith( callbackContext, [ success, statusText, jqXHR ] );
+			} else {
+				deferred.rejectWith( callbackContext, [ jqXHR, statusText, error ] );
+			}
+
+			// Status-dependent callbacks
+			jqXHR.statusCode( statusCode );
+			statusCode = undefined;
+
+			if ( fireGlobals ) {
+				globalEventContext.trigger( isSuccess ? "ajaxSuccess" : "ajaxError",
+					[ jqXHR, s, isSuccess ? success : error ] );
+			}
+
+			// Complete
+			completeDeferred.fireWith( callbackContext, [ jqXHR, statusText ] );
+
+			if ( fireGlobals ) {
+				globalEventContext.trigger( "ajaxComplete", [ jqXHR, s ] );
+
+				// Handle the global AJAX counter
+				if ( !( --jQuery.active ) ) {
+					jQuery.event.trigger( "ajaxStop" );
+				}
+			}
+		}
+
+		return jqXHR;
+	},
+
+	getJSON: function( url, data, callback ) {
+		return jQuery.get( url, data, callback, "json" );
+	},
+
+	getScript: function( url, callback ) {
+		return jQuery.get( url, undefined, callback, "script" );
+	}
+} );
+
+jQuery.each( [ "get", "post" ], function( _i, method ) {
+	jQuery[ method ] = function( url, data, callback, type ) {
+
+		// Shift arguments if data argument was omitted
+		if ( isFunction( data ) ) {
+			type = type || callback;
+			callback = data;
+			data = undefined;
+		}
+
+		// The url can be an options object (which then must have .url)
+		return jQuery.ajax( jQuery.extend( {
+			url: url,
+			type: method,
+			dataType: type,
+			data: data,
+			success: callback
+		}, jQuery.isPlainObject( url ) && url ) );
+	};
+} );
+
+jQuery.ajaxPrefilter( function( s ) {
+	var i;
+	for ( i in s.headers ) {
+		if ( i.toLowerCase() === "content-type" ) {
+			s.contentType = s.headers[ i ] || "";
+		}
+	}
+} );
+
+
+jQuery._evalUrl = function( url, options, doc ) {
+	return jQuery.ajax( {
+		url: url,
+
+		// Make this explicit, since user can override this through ajaxSetup (#11264)
+		type: "GET",
+		dataType: "script",
+		cache: true,
+		async: false,
+		global: false,
+
+		// Only evaluate the response if it is successful (gh-4126)
+		// dataFilter is not invoked for failure responses, so using it instead
+		// of the default converter is kludgy but it works.
+		converters: {
+			"text script": function() {}
+		},
+		dataFilter: function( response ) {
+			jQuery.globalEval( response, options, doc );
+		}
+	} );
+};
+
+
+jQuery.fn.extend( {
+	wrapAll: function( html ) {
+		var wrap;
+
+		if ( this[ 0 ] ) {
+			if ( isFunction( html ) ) {
+				html = html.call( this[ 0 ] );
+			}
+
+			// The elements to wrap the target around
+			wrap = jQuery( html, this[ 0 ].ownerDocument ).eq( 0 ).clone( true );
+
+			if ( this[ 0 ].parentNode ) {
+				wrap.insertBefore( this[ 0 ] );
+			}
+
+			wrap.map( function() {
+				var elem = this;
+
+				while ( elem.firstElementChild ) {
+					elem = elem.firstElementChild;
+				}
+
+				return elem;
+			} ).append( this );
+		}
+
+		return this;
+	},
+
+	wrapInner: function( html ) {
+		if ( isFunction( html ) ) {
+			return this.each( function( i ) {
+				jQuery( this ).wrapInner( html.call( this, i ) );
+			} );
+		}
+
+		return this.each( function() {
+			var self = jQuery( this ),
+				contents = self.contents();
+
+			if ( contents.length ) {
+				contents.wrapAll( html );
+
+			} else {
+				self.append( html );
+			}
+		} );
+	},
+
+	wrap: function( html ) {
+		var htmlIsFunction = isFunction( html );
+
+		return this.each( function( i ) {
+			jQuery( this ).wrapAll( htmlIsFunction ? html.call( this, i ) : html );
+		} );
+	},
+
+	unwrap: function( selector ) {
+		this.parent( selector ).not( "body" ).each( function() {
+			jQuery( this ).replaceWith( this.childNodes );
+		} );
+		return this;
+	}
+} );
+
+
+jQuery.expr.pseudos.hidden = function( elem ) {
+	return !jQuery.expr.pseudos.visible( elem );
+};
+jQuery.expr.pseudos.visible = function( elem ) {
+	return !!( elem.offsetWidth || elem.offsetHeight || elem.getClientRects().length );
+};
+
+
+
+
+jQuery.ajaxSettings.xhr = function() {
+	try {
+		return new window.XMLHttpRequest();
+	} catch ( e ) {}
+};
+
+var xhrSuccessStatus = {
+
+		// File protocol always yields status code 0, assume 200
+		0: 200,
+
+		// Support: IE <=9 only
+		// #1450: sometimes IE returns 1223 when it should be 204
+		1223: 204
+	},
+	xhrSupported = jQuery.ajaxSettings.xhr();
+
+support.cors = !!xhrSupported && ( "withCredentials" in xhrSupported );
+support.ajax = xhrSupported = !!xhrSupported;
+
+jQuery.ajaxTransport( function( options ) {
+	var callback, errorCallback;
+
+	// Cross domain only allowed if supported through XMLHttpRequest
+	if ( support.cors || xhrSupported && !options.crossDomain ) {
+		return {
+			send: function( headers, complete ) {
+				var i,
+					xhr = options.xhr();
+
+				xhr.open(
+					options.type,
+					options.url,
+					options.async,
+					options.username,
+					options.password
+				);
+
+				// Apply custom fields if provided
+				if ( options.xhrFields ) {
+					for ( i in options.xhrFields ) {
+						xhr[ i ] = options.xhrFields[ i ];
+					}
+				}
+
+				// Override mime type if needed
+				if ( options.mimeType && xhr.overrideMimeType ) {
+					xhr.overrideMimeType( options.mimeType );
+				}
+
+				// X-Requested-With header
+				// For cross-domain requests, seeing as conditions for a preflight are
+				// akin to a jigsaw puzzle, we simply never set it to be sure.
+				// (it can always be set on a per-request basis or even using ajaxSetup)
+				// For same-domain requests, won't change header if already provided.
+				if ( !options.crossDomain && !headers[ "X-Requested-With" ] ) {
+					headers[ "X-Requested-With" ] = "XMLHttpRequest";
+				}
+
+				// Set headers
+				for ( i in headers ) {
+					xhr.setRequestHeader( i, headers[ i ] );
+				}
+
+				// Callback
+				callback = function( type ) {
+					return function() {
+						if ( callback ) {
+							callback = errorCallback = xhr.onload =
+								xhr.onerror = xhr.onabort = xhr.ontimeout =
+									xhr.onreadystatechange = null;
+
+							if ( type === "abort" ) {
+								xhr.abort();
+							} else if ( type === "error" ) {
+
+								// Support: IE <=9 only
+								// On a manual native abort, IE9 throws
+								// errors on any property access that is not readyState
+								if ( typeof xhr.status !== "number" ) {
+									complete( 0, "error" );
+								} else {
+									complete(
+
+										// File: protocol always yields status 0; see #8605, #14207
+										xhr.status,
+										xhr.statusText
+									);
+								}
+							} else {
+								complete(
+									xhrSuccessStatus[ xhr.status ] || xhr.status,
+									xhr.statusText,
+
+									// Support: IE <=9 only
+									// IE9 has no XHR2 but throws on binary (trac-11426)
+									// For XHR2 non-text, let the caller handle it (gh-2498)
+									( xhr.responseType || "text" ) !== "text"  ||
+									typeof xhr.responseText !== "string" ?
+										{ binary: xhr.response } :
+										{ text: xhr.responseText },
+									xhr.getAllResponseHeaders()
+								);
+							}
+						}
+					};
+				};
+
+				// Listen to events
+				xhr.onload = callback();
+				errorCallback = xhr.onerror = xhr.ontimeout = callback( "error" );
+
+				// Support: IE 9 only
+				// Use onreadystatechange to replace onabort
+				// to handle uncaught aborts
+				if ( xhr.onabort !== undefined ) {
+					xhr.onabort = errorCallback;
+				} else {
+					xhr.onreadystatechange = function() {
+
+						// Check readyState before timeout as it changes
+						if ( xhr.readyState === 4 ) {
+
+							// Allow onerror to be called first,
+							// but that will not handle a native abort
+							// Also, save errorCallback to a variable
+							// as xhr.onerror cannot be accessed
+							window.setTimeout( function() {
+								if ( callback ) {
+									errorCallback();
+								}
+							} );
+						}
+					};
+				}
+
+				// Create the abort callback
+				callback = callback( "abort" );
+
+				try {
+
+					// Do send the request (this may raise an exception)
+					xhr.send( options.hasContent && options.data || null );
+				} catch ( e ) {
+
+					// #14683: Only rethrow if this hasn't been notified as an error yet
+					if ( callback ) {
+						throw e;
+					}
+				}
+			},
+
+			abort: function() {
+				if ( callback ) {
+					callback();
+				}
+			}
+		};
+	}
+} );
+
+
+
+
+// Prevent auto-execution of scripts when no explicit dataType was provided (See gh-2432)
+jQuery.ajaxPrefilter( function( s ) {
+	if ( s.crossDomain ) {
+		s.contents.script = false;
+	}
+} );
+
+// Install script dataType
+jQuery.ajaxSetup( {
+	accepts: {
+		script: "text/javascript, application/javascript, " +
+			"application/ecmascript, application/x-ecmascript"
+	},
+	contents: {
+		script: /\b(?:java|ecma)script\b/
+	},
+	converters: {
+		"text script": function( text ) {
+			jQuery.globalEval( text );
+			return text;
+		}
+	}
+} );
+
+// Handle cache's special case and crossDomain
+jQuery.ajaxPrefilter( "script", function( s ) {
+	if ( s.cache === undefined ) {
+		s.cache = false;
+	}
+	if ( s.crossDomain ) {
+		s.type = "GET";
+	}
+} );
+
+// Bind script tag hack transport
+jQuery.ajaxTransport( "script", function( s ) {
+
+	// This transport only deals with cross domain or forced-by-attrs requests
+	if ( s.crossDomain || s.scriptAttrs ) {
+		var script, callback;
+		return {
+			send: function( _, complete ) {
+				script = jQuery( "
+    
+    
+    
+    
+    
+    
+     
+    
+
+    

+
+  

+	

+	
+	

+	  

+	    Pygame Home ||
+	    Help Contents ||
+	    Reference Index
+
+        

+          
+          
+        

+	  

+	  

+	  
Most useful stuff:
+	    Color | 
+	    display | 
+	    draw | 
+	    event | 
+	    font | 
+	    image | 
+	    key | 
+	    locals | 
+	    mixer | 
+	    mouse | 
+	    Rect | 
+	    Surface | 
+	    time | 
+	    music | 
+	    pygame
+	  

+
+	  
Advanced stuff:
+	    cursors | 
+	    joystick | 
+	    mask | 
+	    sprite | 
+	    transform | 
+	    BufferProxy | 
+	    freetype | 
+	    gfxdraw | 
+	    midi | 
+	    PixelArray | 
+	    pixelcopy | 
+	    sndarray | 
+	    surfarray | 
+	    math
+	  

+
+	  
Other:
+	    camera | 
+	    controller | 
+	    examples | 
+	    fastevent | 
+	    scrap | 
+	    tests | 
+	    touch | 
+	    version
+	  

+

+

+  

+
+      

+          

+            
+

+

+
+

+
src_c/include/ contains header files for applications
+that use the pygame C API, while src_c/ contains
+headers used by pygame internally.

+

+
+
+


+

+Edit on GitHub
+            

+          

+      

+      

+    

+    
+    
+  
+
\ No newline at end of file
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/c_api/base.html b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/c_api/base.html
new file mode 100644
index 0000000..9b3a162
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/c_api/base.html
@@ -0,0 +1,357 @@
+
+
+
+  
+    
+    
+
+    High level API exported by pygame.base — pygame v2.6.1 documentation
+    
+    
+    
+    
+    
+    
+    
+    
+    
+     
+    
+
+    

+
+  

+	

+	
+	

+	  

+	    Pygame Home ||
+	    Help Contents ||
+	    Reference Index
+
+        

+          
+          
+        

+	  

+	  

+	  
Most useful stuff:
+	    Color | 
+	    display | 
+	    draw | 
+	    event | 
+	    font | 
+	    image | 
+	    key | 
+	    locals | 
+	    mixer | 
+	    mouse | 
+	    Rect | 
+	    Surface | 
+	    time | 
+	    music | 
+	    pygame
+	  

+
+	  
Advanced stuff:
+	    cursors | 
+	    joystick | 
+	    mask | 
+	    sprite | 
+	    transform | 
+	    BufferProxy | 
+	    freetype | 
+	    gfxdraw | 
+	    midi | 
+	    PixelArray | 
+	    pixelcopy | 
+	    sndarray | 
+	    surfarray | 
+	    math
+	  

+
+	  
Other:
+	    camera | 
+	    controller | 
+	    examples | 
+	    fastevent | 
+	    scrap | 
+	    tests | 
+	    touch | 
+	    version
+	  

+

+

+  

+
+      

+          

+            
+

+

+
src_c/base.c

+
This extension module defines general purpose routines for starting and stopping
+SDL as well as various conversion routines uses elsewhere in pygame.

+
C header: src_c/include/pygame.h

+

+

+PyObject *pgExc_SDLError

+
This is pygame.error, the exception type used to raise SDL errors.

+

+
+

+

+int pg_mod_autoinit(const char *modname)

+
Inits a pygame module, which has the name modname
+Return 1 on success, 0 on error, with python
+error set.

+

+
+

+

+void pg_mod_autoquit(const char *modname)

+
Quits a pygame module, which has the name modname

+

+
+

+

+void pg_RegisterQuit(void (*f)(void))

+
Register function f as a callback on Pygame termination.
+Multiple functions can be registered.
+Functions are called in the reverse order they were registered.

+

+
+

+

+int pg_IntFromObj(PyObject *obj, int *val)

+
Convert number like object obj to C int and place in argument val.
+Return 1 on success, else 0.
+No Python exceptions are raised.

+

+
+

+

+int pg_IntFromObjIndex(PyObject *obj, int index, int *val)

+
Convert number like object at position i in sequence obj
+to C int and place in argument val.
+Return 1 on success, 0 on failure.
+No Python exceptions are raised.

+

+
+

+

+int pg_TwoIntsFromObj(PyObject *obj, int *val1, int *v2)

+
Convert the two number like objects in length 2 sequence obj
+to C int and place in arguments val1 and val2 respectively.
+Return 1 on success, 0 on failure.
+No Python exceptions are raised.

+

+
+

+

+int pg_FloatFromObj(PyObject *obj, float *val)

+
Convert number like object obj to C float and place in argument val.
+Returns 1 on success, 0 on failure.
+No Python exceptions are raised.

+

+
+

+

+int pg_FloatFromObjIndex(PyObject *obj, int index, float *val)

+
Convert number like object at position i in sequence obj
+to C float and place in argument val.
+Return 1 on success, else 0.
+No Python exceptions are raised.

+

+
+

+

+int pg_TwoFloatsFromObj(PyObject *obj, float *val1, float *val2)

+
Convert the two number like objects in length 2 sequence obj
+to C float and place in arguments val1 and val2 respectively.
+Return 1 on success, else 0.
+No Python exceptions are raised.

+

+
+

+

+int pg_UintFromObj(PyObject *obj, Uint32 *val)

+
Convert number like object obj to unsigned 32 bit integer and place
+in argument val.
+Return 1 on success, else 0.
+No Python exceptions are raised.

+

+
+

+

+int pg_UintFromObjIndex(PyObject *obj, int _index, Uint32 *val)

+
Convert number like object at position i in sequence obj
+to unsigned 32 bit integer and place in argument val.
+Return 1 on success, else 0.
+No Python exceptions are raised.

+

+
+

+

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

+
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.
+For a length 3 sequence an alpha value of 255 is assumed.
+Return 1 on success, 0 otherwise.
+No Python exceptions are raised.

+

+
+

+

+type pg_buffer

+

+

+Py_buffer view

+
A standard buffer description

+

+
+

+

+PyObject *consumer

+
The object holding the buffer

+

+
+

+

+pybuffer_releaseproc release_buffer

+
A buffer release callback.

+

+
+

+
+

+

+PyObject *pgExc_BufferError

+
Python exception type raised for any pg_buffer related errors.

+

+
+

+

+PyObject *pgBuffer_AsArrayInterface(Py_buffer *view_p)

+
Return a Python array interface object representation of buffer view_p.
+On failure raise a Python exception and return NULL.

+

+
+

+

+PyObject *pgBuffer_AsArrayStruct(Py_buffer *view_p)

+
Return a Python array struct object representation of buffer view_p.
+On failure raise a Python exception and return NULL.

+

+
+

+

+int pgObject_GetBuffer(PyObject *obj, pg_buffer *pg_view_p, int flags)

+
Request a buffer for object obj.
+Argument flags are PyBUF options.
+Return the buffer description in pg_view_p.
+An object may support the Python buffer interface, the NumPy array interface,
+or the NumPy array struct interface.
+Return 0 on success, raise a Python exception and return -1 on failure.

+

+
+

+

+void pgBuffer_Release(Pg_buffer *pg_view_p)

+
Release the Pygame pg_view_p buffer.

+

+
+

+

+int pgDict_AsBuffer(Pg_buffer *pg_view_p, PyObject *dict, int flags)

+
Write the array interface dictionary buffer description dict into a Pygame
+buffer description struct pg_view_p.
+The flags PyBUF options describe the view type requested.
+Return 0 on success, or raise a Python exception and return -1 on failure.

+

+
+

+

+void import_pygame_base()

+
Import the pygame.base module C API into an extension module.
+On failure raise a Python exception.

+

+
+

+

+SDL_Window *pg_GetDefaultWindow(void)

+
Return the Pygame default SDL window created by a
+pygame.display.set_mode() call, or NULL.

+

+
+

+

+void pg_SetDefaultWindow(SDL_Window *win)

+
Replace the Pygame default window with win.
+The previous window, if any, is destroyed.
+Argument win may be NULL.
+This function is called by pygame.display.set_mode().

+

+
+

+

+pgSurfaceObject *pg_GetDefaultWindowSurface(void)

+
Return a borrowed reference to the Pygame default window display surface,
+or NULL if no default window is open.

+

+
+

+

+void pg_SetDefaultWindowSurface(pgSurfaceObject *screen)

+
Replace the Pygame default display surface with object screen.
+The previous surface object, if any, is invalidated.
+Argument screen may be NULL.
+This functions is called by pygame.display.set_mode().

+

+
+

+

+
+
+


+

+Edit on GitHub
+            

+          

+      

+      

+    

+    
+    
+  
+
\ No newline at end of file
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/c_api/bufferproxy.html b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/c_api/bufferproxy.html
new file mode 100644
index 0000000..3bb4abc
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/c_api/bufferproxy.html
@@ -0,0 +1,179 @@
+
+
+
+  
+    
+    
+
+    Class BufferProxy API exported by pygame.bufferproxy — pygame v2.6.1 documentation
+    
+    
+    
+    
+    
+    
+    
+    
+    
+     
+    
+
+    

+
+  

+	

+	
+	

+	  

+	    Pygame Home ||
+	    Help Contents ||
+	    Reference Index
+
+        

+          
+          
+        

+	  

+	  

+	  
Most useful stuff:
+	    Color | 
+	    display | 
+	    draw | 
+	    event | 
+	    font | 
+	    image | 
+	    key | 
+	    locals | 
+	    mixer | 
+	    mouse | 
+	    Rect | 
+	    Surface | 
+	    time | 
+	    music | 
+	    pygame
+	  

+
+	  
Advanced stuff:
+	    cursors | 
+	    joystick | 
+	    mask | 
+	    sprite | 
+	    transform | 
+	    BufferProxy | 
+	    freetype | 
+	    gfxdraw | 
+	    midi | 
+	    PixelArray | 
+	    pixelcopy | 
+	    sndarray | 
+	    surfarray | 
+	    math
+	  

+
+	  
Other:
+	    camera | 
+	    controller | 
+	    examples | 
+	    fastevent | 
+	    scrap | 
+	    tests | 
+	    touch | 
+	    version
+	  

+

+

+  

+
+      

+          

+            
+

+

+
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_bufferproxy.h

+

+

+PyTypeObject *pgBufproxy_Type

+
The pygame buffer proxy object type pygame.BufferProxy.

+

+
+

+

+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 *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.
+Argument get_buffer is the pg_buffer get callback.
+It must not be NULL.
+On failure raise a Python error and return NULL.

+

+
+

+

+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 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.

+

+
+

+

+
+
+


+

+Edit on GitHub
+            

+          

+      

+      

+    

+    
+    
+  
+
\ No newline at end of file
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/c_api/color.html b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/c_api/color.html
new file mode 100644
index 0000000..bbeaf95
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/c_api/color.html
@@ -0,0 +1,168 @@
+
+
+
+  
+    
+    
+
+    Class Color API exported by pygame.color — pygame v2.6.1 documentation
+    
+    
+    
+    
+    
+    
+    
+    
+    
+     
+    
+
+    

+
+  

+	

+	
+	

+	  

+	    Pygame Home ||
+	    Help Contents ||
+	    Reference Index
+
+        

+          
+          
+        

+	  

+	  

+	  
Most useful stuff:
+	    Color | 
+	    display | 
+	    draw | 
+	    event | 
+	    font | 
+	    image | 
+	    key | 
+	    locals | 
+	    mixer | 
+	    mouse | 
+	    Rect | 
+	    Surface | 
+	    time | 
+	    music | 
+	    pygame
+	  

+
+	  
Advanced stuff:
+	    cursors | 
+	    joystick | 
+	    mask | 
+	    sprite | 
+	    transform | 
+	    BufferProxy | 
+	    freetype | 
+	    gfxdraw | 
+	    midi | 
+	    PixelArray | 
+	    pixelcopy | 
+	    sndarray | 
+	    surfarray | 
+	    math
+	  

+
+	  
Other:
+	    camera | 
+	    controller | 
+	    examples | 
+	    fastevent | 
+	    scrap | 
+	    tests | 
+	    touch | 
+	    version
+	  

+

+

+  

+
+      

+          

+            
+

+

+
src_c/color.c

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

+
Header file: src_c/include/pygame.h

+

+

+PyTypeObject *pgColor_Type

+
The Pygame color object type pygame.Color.

+

+
+

+

+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.

+

+
+

+

+PyObject *pgColor_New(Uint8 rgba[])

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

+

+
+

+

+PyObject *pgColor_NewLength(Uint8 rgba[], Uint8 length)

+
Return a new pygame.Color instance having length elements,
+with element values taken from the first length elements of array rgba.
+Argument length must be between 1 and 4 inclusive.
+On failure, raise a Python exception and return NULL.

+

+
+

+

+
+
+


+

+Edit on GitHub
+            

+          

+      

+      

+    

+    
+    
+  
+
\ No newline at end of file
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/c_api/display.html b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/c_api/display.html
new file mode 100644
index 0000000..5095c0d
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/c_api/display.html
@@ -0,0 +1,173 @@
+
+
+
+  
+    
+    
+
+    API exported by pygame.display — pygame v2.6.1 documentation
+    
+    
+    
+    
+    
+    
+    
+    
+    
+     
+    
+
+    

+
+  

+	

+	
+	

+	  

+	    Pygame Home ||
+	    Help Contents ||
+	    Reference Index
+
+        

+          
+          
+        

+	  

+	  

+	  
Most useful stuff:
+	    Color | 
+	    display | 
+	    draw | 
+	    event | 
+	    font | 
+	    image | 
+	    key | 
+	    locals | 
+	    mixer | 
+	    mouse | 
+	    Rect | 
+	    Surface | 
+	    time | 
+	    music | 
+	    pygame
+	  

+
+	  
Advanced stuff:
+	    cursors | 
+	    joystick | 
+	    mask | 
+	    sprite | 
+	    transform | 
+	    BufferProxy | 
+	    freetype | 
+	    gfxdraw | 
+	    midi | 
+	    PixelArray | 
+	    pixelcopy | 
+	    sndarray | 
+	    surfarray | 
+	    math
+	  

+
+	  
Other:
+	    camera | 
+	    controller | 
+	    examples | 
+	    fastevent | 
+	    scrap | 
+	    tests | 
+	    touch | 
+	    version
+	  

+

+

+  

+
+      

+          

+            
+

+

+
src_c/display.c

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

+
Header file: src_c/include/pygame.h

+

+

+type pgVidInfoObject

+
A pygame object that wraps an SDL_VideoInfo struct.
+The object returned by pygame.display.Info().

+

+
+

+

+PyTypeObject *pgVidInfo_Type

+
The pgVidInfoObject object Python type.

+

+
+

+

+SDL_VideoInfo pgVidInfo_AsVidInfo(PyObject *obj)

+
Return the SDL_VideoInfo field of obj, a pgVidInfo_Type instance.
+This macro does not check that obj is not NULL or an actual pgVidInfoObject object.

+

+
+

+

+PyObject *pgVidInfo_New(SDL_VideoInfo *i)

+
Return a new pgVidInfoObject object for the SDL_VideoInfo i.
+On failure, raise a Python exception and return NULL.

+

+
+

+

+int pgVidInfo_Check(PyObject *x)

+
Return true if x is a pgVidInfo_Type instance

+
Will return false if x is a subclass of pgVidInfo_Type.
+This macro does not check that x is not NULL.

+

+
+

+

+
+
+


+

+Edit on GitHub
+            

+          

+      

+      

+    

+    
+    
+  
+
\ No newline at end of file
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/c_api/event.html b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/c_api/event.html
new file mode 100644
index 0000000..a6c3d28
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/c_api/event.html
@@ -0,0 +1,188 @@
+
+
+
+  
+    
+    
+
+    API exported by pygame.event — pygame v2.6.1 documentation
+    
+    
+    
+    
+    
+    
+    
+    
+    
+     
+    
+
+    

+
+  

+	

+	
+	

+	  

+	    Pygame Home ||
+	    Help Contents ||
+	    Reference Index
+
+        

+          
+          
+        

+	  

+	  

+	  
Most useful stuff:
+	    Color | 
+	    display | 
+	    draw | 
+	    event | 
+	    font | 
+	    image | 
+	    key | 
+	    locals | 
+	    mixer | 
+	    mouse | 
+	    Rect | 
+	    Surface | 
+	    time | 
+	    music | 
+	    pygame
+	  

+
+	  
Advanced stuff:
+	    cursors | 
+	    joystick | 
+	    mask | 
+	    sprite | 
+	    transform | 
+	    BufferProxy | 
+	    freetype | 
+	    gfxdraw | 
+	    midi | 
+	    PixelArray | 
+	    pixelcopy | 
+	    sndarray | 
+	    surfarray | 
+	    math
+	  

+
+	  
Other:
+	    camera | 
+	    controller | 
+	    examples | 
+	    fastevent | 
+	    scrap | 
+	    tests | 
+	    touch | 
+	    version
+	  

+

+

+  

+
+      

+          

+            
+

+

+
src_c/event.c

+
The extension module pygame.eventpygame module for interacting with events and queues.

+
Header file: src_c/include/pygame.h

+

+

+type pgEventObject

+
The pygame.event.EventType object C struct.

+

+

+int type

+
The event type code.

+

+
+

+
+

+

+type pgEvent_Type

+
The pygame event object type pygame.event.EventType.

+

+
+

+

+int pgEvent_Check(PyObject *x)

+
Return true if x is a pygame event instance

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

+

+
+

+

+PyObject *pgEvent_New(SDL_Event *event)

+
Return a new pygame event instance for the SDL event.
+If event is NULL then create an empty event object.
+On failure raise a Python exception and return NULL.

+

+
+

+

+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.

+

+
+

+

+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.

+

+
+

+

+
+
+


+

+Edit on GitHub
+            

+          

+      

+      

+    

+    
+    
+  
+
\ No newline at end of file
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/c_api/freetype.html b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/c_api/freetype.html
new file mode 100644
index 0000000..fb6ff21
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/c_api/freetype.html
@@ -0,0 +1,176 @@
+
+
+
+  
+    
+    
+
+    API exported by pygame._freetype — pygame v2.6.1 documentation
+    
+    
+    
+    
+    
+    
+    
+    
+    
+     
+    
+
+    

+
+  

+	

+	
+	

+	  

+	    Pygame Home ||
+	    Help Contents ||
+	    Reference Index
+
+        

+          
+          
+        

+	  

+	  

+	  
Most useful stuff:
+	    Color | 
+	    display | 
+	    draw | 
+	    event | 
+	    font | 
+	    image | 
+	    key | 
+	    locals | 
+	    mixer | 
+	    mouse | 
+	    Rect | 
+	    Surface | 
+	    time | 
+	    music | 
+	    pygame
+	  

+
+	  
Advanced stuff:
+	    cursors | 
+	    joystick | 
+	    mask | 
+	    sprite | 
+	    transform | 
+	    BufferProxy | 
+	    freetype | 
+	    gfxdraw | 
+	    midi | 
+	    PixelArray | 
+	    pixelcopy | 
+	    sndarray | 
+	    surfarray | 
+	    math
+	  

+
+	  
Other:
+	    camera | 
+	    controller | 
+	    examples | 
+	    fastevent | 
+	    scrap | 
+	    tests | 
+	    touch | 
+	    version
+	  

+

+

+  

+
+      

+          

+            
+

+

+
src_c/_freetype.c

+
This extension module defines Python type pygame.freetype.FontCreate a new Font instance from a supported font file..

+
Header file: src_c/include/pygame_freetype.h

+

+

+type pgFontObject

+
The pygame.freetype.Font instance C struct.

+

+
+

+

+type pgFont_Type

+
The pygame.freetype.Font Python type.

+

+
+

+

+PyObject *pgFont_New(const char *filename, long font_index)

+
Open the font file with path filename and return a new
+new pygame.freetype.Font instance for that font.
+Set font_index to 0 unless the file contains multiple, indexed, fonts.
+On error raise a Python exception and return NULL.

+

+
+

+

+int pgFont_Check(PyObject *x)

+
Return true if x is a pygame.freetype.Font instance.
+Will return false for a subclass of Font.
+This is a macro. No check is made that x is not NULL.

+

+
+

+

+int pgFont_IS_ALIVE(PyObject *o)

+
Return true if pygame.freetype.Font object o
+is an open font file.
+This is a macro. No check is made that o is not NULL
+or not a Font instance.

+

+
+

+

+
+
+


+

+Edit on GitHub
+            

+          

+      

+      

+    

+    
+    
+  
+
\ No newline at end of file
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/c_api/mixer.html b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/c_api/mixer.html
new file mode 100644
index 0000000..c784c4e
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/c_api/mixer.html
@@ -0,0 +1,209 @@
+
+
+
+  
+    
+    
+
+    API exported by pygame.mixer — pygame v2.6.1 documentation
+    
+    
+    
+    
+    
+    
+    
+    
+    
+     
+    
+
+    

+
+  

+	

+	
+	

+	  

+	    Pygame Home ||
+	    Help Contents ||
+	    Reference Index
+
+        

+          
+          
+        

+	  

+	  

+	  
Most useful stuff:
+	    Color | 
+	    display | 
+	    draw | 
+	    event | 
+	    font | 
+	    image | 
+	    key | 
+	    locals | 
+	    mixer | 
+	    mouse | 
+	    Rect | 
+	    Surface | 
+	    time | 
+	    music | 
+	    pygame
+	  

+
+	  
Advanced stuff:
+	    cursors | 
+	    joystick | 
+	    mask | 
+	    sprite | 
+	    transform | 
+	    BufferProxy | 
+	    freetype | 
+	    gfxdraw | 
+	    midi | 
+	    PixelArray | 
+	    pixelcopy | 
+	    sndarray | 
+	    surfarray | 
+	    math
+	  

+
+	  
Other:
+	    camera | 
+	    controller | 
+	    examples | 
+	    fastevent | 
+	    scrap | 
+	    tests | 
+	    touch | 
+	    version
+	  

+

+

+  

+
+      

+          

+            
+

+

+
src_c/mixer.c

+
Python types and module startup/shutdown functions defined in the
+pygame.mixerpygame module for loading and playing sounds extension module.

+
Header file: src_c/include/pygame_mixer.h

+

+

+type pgSoundObject

+
The pygame.mixer.Sound instance C structure.

+

+
+

+

+PyTypeObject *pgSound_Type

+
The pygame.mixer.Sound Python type.

+

+
+

+

+PyObject *pgSound_New(Mix_Chunk *chunk)

+
Return a new pygame.mixer.Sound instance for the SDL mixer chunk chunk.
+On failure, raise a Python exception and return NULL.

+

+
+

+

+int pgSound_Check(PyObject *obj)

+
Return true if obj is an instance of type pgSound_Type,
+but not a pgSound_Type subclass instance.
+A macro.

+

+
+

+

+Mix_Chunk *pgSound_AsChunk(PyObject *x)

+
Return the SDL Mix_Chunk struct associated with the
+pgSound_Type instance x.
+A macro that does no NULL or Python type check on x.

+

+
+

+

+type pgChannelObject

+
The pygame.mixer.Channel instance C structure.

+

+
+

+

+PyTypeObject *pgChannel_Type

+
The pygame.mixer.Channel Python type.

+

+
+

+

+PyObject *pgChannel_New(int channelnum)

+
Return a new pygame.mixer.Channel instance for the SDL mixer
+channel channelnum.
+On failure, raise a Python exception and return NULL.

+

+
+

+

+int pgChannel_Check(PyObject *obj)

+
Return true if obj is an instance of type pgChannel_Type,
+but not a pgChannel_Type subclass instance.
+A macro.

+

+
+

+

+int pgChannel_AsInt(PyObject *x)

+
Return the SDL mixer music channel number associated with pgChannel_Type instance x.
+A macro that does no NULL or Python type check on x.

+

+
+

+

+
+
+


+

+Edit on GitHub
+            

+          

+      

+      

+    

+    
+    
+  
+
\ No newline at end of file
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/c_api/rect.html b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/c_api/rect.html
new file mode 100644
index 0000000..98d10e9
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/c_api/rect.html
@@ -0,0 +1,204 @@
+
+
+
+  
+    
+    
+
+    Class Rect API exported by pygame.rect — pygame v2.6.1 documentation
+    
+    
+    
+    
+    
+    
+    
+    
+    
+     
+    
+
+    

+
+  

+	

+	
+	

+	  

+	    Pygame Home ||
+	    Help Contents ||
+	    Reference Index
+
+        

+          
+          
+        

+	  

+	  

+	  
Most useful stuff:
+	    Color | 
+	    display | 
+	    draw | 
+	    event | 
+	    font | 
+	    image | 
+	    key | 
+	    locals | 
+	    mixer | 
+	    mouse | 
+	    Rect | 
+	    Surface | 
+	    time | 
+	    music | 
+	    pygame
+	  

+
+	  
Advanced stuff:
+	    cursors | 
+	    joystick | 
+	    mask | 
+	    sprite | 
+	    transform | 
+	    BufferProxy | 
+	    freetype | 
+	    gfxdraw | 
+	    midi | 
+	    PixelArray | 
+	    pixelcopy | 
+	    sndarray | 
+	    surfarray | 
+	    math
+	  

+
+	  
Other:
+	    camera | 
+	    controller | 
+	    examples | 
+	    fastevent | 
+	    scrap | 
+	    tests | 
+	    touch | 
+	    version
+	  

+

+

+  

+
+      

+          

+            
+

+

+
src_c/rect.c

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

+
Header file: src_c/include/pygame.h

+

+

+type pgRectObject

+

+

+SDL_Rect r

+

+
+
The Pygame rectangle type instance.

+

+
+

+

+PyTypeObject *pgRect_Type

+
The Pygame rectangle object type pygame.Rect.

+

+
+

+

+SDL_Rect pgRect_AsRect(PyObject *obj)

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

+

+
+

+

+PyObject *pgRect_New(SDL_Rect *r)

+
Return a new pygame.Rect instance from the SDL_Rect r.
+On failure, raise a Python exception and return NULL.

+

+
+

+

+PyObject *pgRect_New4(int x, int y, int w, int h)

+
Return a new pygame.Rect 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)

+
Translate a Python rectangle representation as a Pygame SDL_Rect.
+A rectangle can be a length 4 sequence integers (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_Rect 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_Rect representation
+of the rectangle, else return NULL.
+No Python exceptions are raised.

+

+
+

+

+void pgRect_Normalize(SDL_Rect *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.

+

+
+

+

+
+
+


+

+Edit on GitHub
+            

+          

+      

+      

+    

+    
+    
+  
+
\ No newline at end of file
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/c_api/rwobject.html b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/c_api/rwobject.html
new file mode 100644
index 0000000..1c3a2a8
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/c_api/rwobject.html
@@ -0,0 +1,200 @@
+
+
+
+  
+    
+    
+
+    API exported by pygame.rwobject — pygame v2.6.1 documentation
+    
+    
+    
+    
+    
+    
+    
+    
+    
+     
+    
+
+    

+
+  

+	

+	
+	

+	  

+	    Pygame Home ||
+	    Help Contents ||
+	    Reference Index
+
+        

+          
+          
+        

+	  

+	  

+	  
Most useful stuff:
+	    Color | 
+	    display | 
+	    draw | 
+	    event | 
+	    font | 
+	    image | 
+	    key | 
+	    locals | 
+	    mixer | 
+	    mouse | 
+	    Rect | 
+	    Surface | 
+	    time | 
+	    music | 
+	    pygame
+	  

+
+	  
Advanced stuff:
+	    cursors | 
+	    joystick | 
+	    mask | 
+	    sprite | 
+	    transform | 
+	    BufferProxy | 
+	    freetype | 
+	    gfxdraw | 
+	    midi | 
+	    PixelArray | 
+	    pixelcopy | 
+	    sndarray | 
+	    surfarray | 
+	    math
+	  

+
+	  
Other:
+	    camera | 
+	    controller | 
+	    examples | 
+	    fastevent | 
+	    scrap | 
+	    tests | 
+	    touch | 
+	    version
+	  

+

+

+  

+
+      

+          

+            
+

+

+
src_c/rwobject.c

+
This extension module implements functions for wrapping a Python file like
+object in a SDL_RWops struct for SDL file access.

+
Header file: src_c/include/pygame.h

+

+

+SDL_RWops *pgRWops_FromObject(PyObject *obj, char **extptr)

+
Return a SDL_RWops struct filled to access obj.
+If obj is a string then let SDL open the file it names.
+Otherwise, if obj is a Python file-like object then use its read, write,
+seek, tell, and close methods. If threads are available,
+the Python GIL is acquired before calling any of the obj methods.
+If you want to see the file extension, you can pass in a char double pointer
+that will be populated to a dynamically allocated string or NULL. Caller is
+responsible for freeing the extension string. It is safe to pass NULL if you
+don't care about the file extension. On error raise a Python exception and
+return NULL. If NULL is returned, the extptr will not be populated with
+dynamic memory, it is not necessary to free in that error handling.

+

+
+

+

+SDL_RWops *pgRWops_FromFileObject(PyObject *obj)

+
Return a SDL_RWops struct filled to access the Python file-like object obj.
+Uses its read, write, seek, tell, and close methods.
+If threads are available, the Python GIL is acquired before calling any of the obj methods.
+On error raise a Python exception and return NULL.

+

+
+

+

+int pgRWops_IsFileObject(SDL_RWops *rw)

+
Return true if rw is a Python file-like object wrapper returned by pgRWops_FromObject()
+or 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)

+
Return the file path obj as a byte string properly encoded for the OS.
+Null bytes are forbidden in the encoded file path.
+On error raise a Python exception and return NULL,
+using eclass as the exception type if it is not NULL.
+If obj is NULL assume an exception was already raised and pass it on.

+

+
+

+

+PyObject *pg_EncodeString(PyObject *obj, const char *encoding, const char *errors, PyObject *eclass)

+
Return string obj as an encoded byte string.
+The C string arguments encoding and errors are the same as for
+PyUnicode_AsEncodedString().
+On error raise a Python exception and return NULL,
+using eclass as the exception type if it is not NULL.
+If obj is NULL assume an exception was already raised and pass it on.

+

+
+

+

+
+
+


+

+Edit on GitHub
+            

+          

+      

+      

+    

+    
+    
+  
+
\ No newline at end of file
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/c_api/slots.html b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/c_api/slots.html
new file mode 100644
index 0000000..c4d3abc
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/c_api/slots.html
@@ -0,0 +1,153 @@
+
+
+
+  
+    
+    
+
+    Slots and c_api - Making functions and data available from other modules — pygame v2.6.1 documentation
+    
+    
+    
+    
+    
+    
+    
+    
+    
+     
+    
+
+    

+
+  

+	

+	
+	

+	  

+	    Pygame Home ||
+	    Help Contents ||
+	    Reference Index
+
+        

+          
+          
+        

+	  

+	  

+	  
Most useful stuff:
+	    Color | 
+	    display | 
+	    draw | 
+	    event | 
+	    font | 
+	    image | 
+	    key | 
+	    locals | 
+	    mixer | 
+	    mouse | 
+	    Rect | 
+	    Surface | 
+	    time | 
+	    music | 
+	    pygame
+	  

+
+	  
Advanced stuff:
+	    cursors | 
+	    joystick | 
+	    mask | 
+	    sprite | 
+	    transform | 
+	    BufferProxy | 
+	    freetype | 
+	    gfxdraw | 
+	    midi | 
+	    PixelArray | 
+	    pixelcopy | 
+	    sndarray | 
+	    surfarray | 
+	    math
+	  

+
+	  
Other:
+	    camera | 
+	    controller | 
+	    examples | 
+	    fastevent | 
+	    scrap | 
+	    tests | 
+	    touch | 
+	    version
+	  

+

+

+  

+
+      

+          

+            
+

+
One example is pg_RGBAFromObj where the implementation is defined in base.c, and also exported in base.c (and _pygame.h).

+
base.c has this exposing the pg_RGBAFromObj function to the c_api structure:

+

+
c_api[12] = pg_RGBAFromObj;

+

+
Then in src_c/include/_pygame.h there is an

+

+
#define pg_RGBAFromObj.

+

+
Also in _pygame.h, it needs to define the number of slots the base module uses. This is PYGAMEAPI_BASE_NUMSLOTS. So if you were adding another function, you need to increment this PYGAMEAPI_BASE_NUMSLOTS number.

+
Then to use the pg_RGBAFromObj in other files,

+
    
+
  1. include the "pygame.h" file,
    2. 
+
  2. they have to make sure base is imported with:
    
+
    
+
    import_pygame_base();
    
+
    
+
    3. 
+

+
Examples that use pg_RGBAFromObj are: _freetype.c, color.c, gfxdraw.c, and surface.c.

+

+
+
+


+

+Edit on GitHub
+            

+          

+      

+      

+    

+    
+    
+  
+
\ No newline at end of file
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/c_api/surface.html b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/c_api/surface.html
new file mode 100644
index 0000000..99bd166
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/c_api/surface.html
@@ -0,0 +1,198 @@
+
+
+
+  
+    
+    
+
+    Class Surface API exported by pygame.surface — pygame v2.6.1 documentation
+    
+    
+    
+    
+    
+    
+    
+    
+    
+     
+    
+
+    

+
+  

+	

+	
+	

+	  

+	    Pygame Home ||
+	    Help Contents ||
+	    Reference Index
+
+        

+          
+          
+        

+	  

+	  

+	  
Most useful stuff:
+	    Color | 
+	    display | 
+	    draw | 
+	    event | 
+	    font | 
+	    image | 
+	    key | 
+	    locals | 
+	    mixer | 
+	    mouse | 
+	    Rect | 
+	    Surface | 
+	    time | 
+	    music | 
+	    pygame
+	  

+
+	  
Advanced stuff:
+	    cursors | 
+	    joystick | 
+	    mask | 
+	    sprite | 
+	    transform | 
+	    BufferProxy | 
+	    freetype | 
+	    gfxdraw | 
+	    midi | 
+	    PixelArray | 
+	    pixelcopy | 
+	    sndarray | 
+	    surfarray | 
+	    math
+	  

+
+	  
Other:
+	    camera | 
+	    controller | 
+	    examples | 
+	    fastevent | 
+	    scrap | 
+	    tests | 
+	    touch | 
+	    version
+	  

+

+

+  

+
+      

+          

+            
+

+

+
src_c/surface.c

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

+
Header file: src_c/include/pygame.h

+

+

+type pgSurfaceObject

+
A pygame.Surface instance.

+

+
+

+

+PyTypeObject *pgSurface_Type

+
The pygame.Surface Python type.

+

+
+

+

+int pgSurface_Check(PyObject *x)

+
Return true if x is a pygame.Surface instance

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

+

+
+

+

+pgSurfaceObject *pgSurface_New(SDL_Surface *s)

+
Return a new new pygame surface instance for SDL surface s.
+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)

+
Return a pointer the SDL surface represented by the pygame Surface instance
+x.

+
This is a macro. Argument x is assumed to be a Surface, or subclass of
+Surface, instance.

+

+
+

+

+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 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,
+PYGAME_BLEND_RGBA_MULT, PYGAME_BLEND_RGBA_MIN,
+PYGAME_BLEND_RGBA_MAX, PYGAME_BLEND_ALPHA_SDL2 and PYGAME_BLEND_PREMULTIPLIED.
+Argument dstrect 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 or -2` on an exception.

+

+
+

+

+
+
+


+

+Edit on GitHub
+            

+          

+      

+      

+    

+    
+    
+  
+
\ No newline at end of file
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/c_api/surflock.html b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/c_api/surflock.html
new file mode 100644
index 0000000..1e75d75
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/c_api/surflock.html
@@ -0,0 +1,227 @@
+
+
+
+  
+    
+    
+
+    API exported by pygame.surflock — pygame v2.6.1 documentation
+    
+    
+    
+    
+    
+    
+    
+    
+    
+     
+    
+
+    

+
+  

+	

+	
+	

+	  

+	    Pygame Home ||
+	    Help Contents ||
+	    Reference Index
+
+        

+          
+          
+        

+	  

+	  

+	  
Most useful stuff:
+	    Color | 
+	    display | 
+	    draw | 
+	    event | 
+	    font | 
+	    image | 
+	    key | 
+	    locals | 
+	    mixer | 
+	    mouse | 
+	    Rect | 
+	    Surface | 
+	    time | 
+	    music | 
+	    pygame
+	  

+
+	  
Advanced stuff:
+	    cursors | 
+	    joystick | 
+	    mask | 
+	    sprite | 
+	    transform | 
+	    BufferProxy | 
+	    freetype | 
+	    gfxdraw | 
+	    midi | 
+	    PixelArray | 
+	    pixelcopy | 
+	    sndarray | 
+	    surfarray | 
+	    math
+	  

+
+	  
Other:
+	    camera | 
+	    controller | 
+	    examples | 
+	    fastevent | 
+	    scrap | 
+	    tests | 
+	    touch | 
+	    version
+	  

+

+

+  

+
+      

+          

+            
+

+

+
src_c/surflock.c

+
This extension module implements SDL surface locking for the
+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)

+
If surfobj is a subsurface, then lock the parent surface with surfobj
+the owner of the lock.

+

+
+

+

+void pgSurface_Unprep(pgSurfaceObject *surfobj)

+
If surfobj is a subsurface, then release its lock on the parent surface.

+

+
+

+

+int pgSurface_Lock(pgSurfaceObject *surfobj)

+
Lock pygame surface surfobj, with surfobj owning its own lock.

+

+
+

+

+int pgSurface_LockBy(pgSurfaceObject *surfobj, PyObject *lockobj)

+
Lock pygame surface surfobj with Python object lockobj the owning
+the lock.

+
The surface will keep a weak reference to object lockobj,
+and eventually remove the lock on itself if lockobj is garbage collected.
+However, it is best if lockobj also keep a reference to the locked surface
+and call to pgSurface_UnLockBy() when finished with the surface.

+

+
+

+

+int pgSurface_UnLock(pgSurfaceObject *surfobj)

+
Remove the pygame surface surfobj object's lock on itself.

+

+
+

+

+int pgSurface_UnLockBy(pgSurfaceObject *surfobj, PyObject *lockobj)

+
Remove the lock on pygame surface surfobj owned by Python object lockobj.

+

+
+

+

+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
+            

+          

+      

+      

+    

+    
+    
+  
+
\ No newline at end of file
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/c_api/version.html b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/c_api/version.html
new file mode 100644
index 0000000..5e3d88c
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/c_api/version.html
@@ -0,0 +1,169 @@
+
+
+
+  
+    
+    
+
+    API exported by pygame.version — pygame v2.6.1 documentation
+    
+    
+    
+    
+    
+    
+    
+    
+    
+     
+    
+
+    

+
+  

+	

+	
+	

+	  

+	    Pygame Home ||
+	    Help Contents ||
+	    Reference Index
+
+        

+          
+          
+        

+	  

+	  

+	  
Most useful stuff:
+	    Color | 
+	    display | 
+	    draw | 
+	    event | 
+	    font | 
+	    image | 
+	    key | 
+	    locals | 
+	    mixer | 
+	    mouse | 
+	    Rect | 
+	    Surface | 
+	    time | 
+	    music | 
+	    pygame
+	  

+
+	  
Advanced stuff:
+	    cursors | 
+	    joystick | 
+	    mask | 
+	    sprite | 
+	    transform | 
+	    BufferProxy | 
+	    freetype | 
+	    gfxdraw | 
+	    midi | 
+	    PixelArray | 
+	    pixelcopy | 
+	    sndarray | 
+	    surfarray | 
+	    math
+	  

+
+	  
Other:
+	    camera | 
+	    controller | 
+	    examples | 
+	    fastevent | 
+	    scrap | 
+	    tests | 
+	    touch | 
+	    version
+	  

+

+

+  

+
+      

+          

+            
+

+

+
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.

+

+

+

+PG_MAJOR_VERSION

+

+
+

+

+PG_MINOR_VERSION

+

+
+

+

+PG_PATCH_VERSION

+

+
+

+

+PG_VERSIONNUM(MAJOR, MINOR, PATCH)

+
Returns an integer representing the given version.

+

+
+

+

+PG_VERSION_ATLEAST(MAJOR, MINOR, PATCH)

+
Returns true if the current version is at least equal
+to the specified version.

+

+
+

+

+
+
+


+

+Edit on GitHub
+            

+          

+      

+      

+    

+    
+    
+  
+
\ No newline at end of file
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/filepaths.html b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/filepaths.html
new file mode 100644
index 0000000..0f015cb
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/filepaths.html
@@ -0,0 +1,145 @@
+
+
+
+  
+    
+    
+
+    File Path Function Arguments — pygame v2.6.1 documentation
+    
+    
+    
+    
+    
+    
+    
+    
+    
+     
+    
+
+    

+
+  

+	

+	
+	

+	  

+	    Pygame Home ||
+	    Help Contents ||
+	    Reference Index
+
+        

+          
+          
+        

+	  

+	  

+	  
Most useful stuff:
+	    Color | 
+	    display | 
+	    draw | 
+	    event | 
+	    font | 
+	    image | 
+	    key | 
+	    locals | 
+	    mixer | 
+	    mouse | 
+	    Rect | 
+	    Surface | 
+	    time | 
+	    music | 
+	    pygame
+	  

+
+	  
Advanced stuff:
+	    cursors | 
+	    joystick | 
+	    mask | 
+	    sprite | 
+	    transform | 
+	    BufferProxy | 
+	    freetype | 
+	    gfxdraw | 
+	    midi | 
+	    PixelArray | 
+	    pixelcopy | 
+	    sndarray | 
+	    surfarray | 
+	    math
+	  

+
+	  
Other:
+	    camera | 
+	    controller | 
+	    examples | 
+	    fastevent | 
+	    scrap | 
+	    tests | 
+	    touch | 
+	    version
+	  

+

+

+  

+
+      

+          

+            
+

+
A pygame function or method which takes a file path argument will accept
+either a Unicode or a byte (8-bit or ASCII character) string.
+Unicode strings are translated to Python's default filesystem encoding,
+as returned by sys.getfilesystemencoding().  A Unicode code point
+above U+FFFF (\uFFFF) can be coded directly with a 32-bit escape sequences
+(\Uxxxxxxxx), even for Python interpreters built with an UCS-2
+(16-bit character) Unicode type.  Byte strings are passed
+to the operating system unchanged.

+
Null characters (\x00) are not permitted in the path, raising an exception.
+An exception is also raised if an Unicode file path cannot be encoded.
+How UTF-16 surrogate codes are handled is Python-interpreter-dependent.
+Use UTF-32 code points and 32-bit escape sequences instead.
+The exception types are function-dependent.

+

+
+
+


+

+Edit on GitHub
+            

+          

+      

+      

+    

+    
+    
+  
+
\ No newline at end of file
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/genindex.html b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/genindex.html
new file mode 100644
index 0000000..1f90e1f
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/genindex.html
@@ -0,0 +1,2676 @@
+
+
+
+  
+    
+    
+    Index — pygame v2.6.1 documentation
+    
+    
+    
+    
+    
+    
+    
+     
+  
+      
+
+    

+      

+          

+            
+
+
Index

+
+

+ _
+ | A
+ | B
+ | C
+ | D
+ | E
+ | F
+ | G
+ | H
+ | I
+ | J
+ | K
+ | L
+ | M
+ | N
+ | O
+ | P
+ | Q
+ | R
+ | S
+ | T
+ | U
+ | V
+ | W
+ 
+

+
_

+
+  
+  
+

+
+
A

+
+  
+  
+

+
+
B

+
+  
+  
+

+
+
C

+
+  
+  
+

+
+
D

+
+  
+  
+

+
+
E

+
+  
+  
+

+
+
F

+
+  
+  
+

+
+
G

+
+  
+  
+

+
+
H

+
+  
+  
+

+
+
I

+
+  
+  
+

+
+
J

+
+  
+  
+

+
+
K

+
+  
+  
+

+
+
L

+
+  
+  
+

+
+
M

+
+  
+  
+

+
+
N

+
+  
+  
+

+
+
O

+
+  
+  
+

+
+
P

+
+  
+  
+

+
+
Q

+
+  
+

+
+
R

+
+  
+  
+

+
+
S

+
+  
+  
+

+
+
T

+
+  
+  
+

+
+
U

+
+  
+  
+

+
+
V

+
+  
+  
+

+
+
W

+
+  
+  
+

+
+
+
+            

+          

+      

+      

+    

+    
+    
+  
+
\ No newline at end of file
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/index.html b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/index.html
new file mode 100644
index 0000000..d67c581
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/index.html
@@ -0,0 +1,343 @@
+
+
+
+  
+    
+    
+
+    Pygame Front Page — pygame v2.6.1 documentation
+    
+    
+    
+    
+    
+    
+    
+    
+     
+    
+
+    

+
+  

+	

+	
+	

+	  

+	    Pygame Home ||
+	    Help Contents ||
+	    Reference Index
+
+        

+          
+          
+        

+	  

+	  

+	  
Most useful stuff:
+	    Color | 
+	    display | 
+	    draw | 
+	    event | 
+	    font | 
+	    image | 
+	    key | 
+	    locals | 
+	    mixer | 
+	    mouse | 
+	    Rect | 
+	    Surface | 
+	    time | 
+	    music | 
+	    pygame
+	  

+
+	  
Advanced stuff:
+	    cursors | 
+	    joystick | 
+	    mask | 
+	    sprite | 
+	    transform | 
+	    BufferProxy | 
+	    freetype | 
+	    gfxdraw | 
+	    midi | 
+	    PixelArray | 
+	    pixelcopy | 
+	    sndarray | 
+	    surfarray | 
+	    math
+	  

+
+	  
Other:
+	    camera | 
+	    controller | 
+	    examples | 
+	    fastevent | 
+	    scrap | 
+	    tests | 
+	    touch | 
+	    version
+	  

+

+

+  

+
+      

+          

+            
+

+
Pygame Front Page

+

+

+

+
Quick start

+
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
+
+# pygame setup
+pygame.init()
+screen = pygame.display.set_mode((1280, 720))
+clock = pygame.time.Clock()
+running = True
+
+while running:
+    # poll for events
+    # pygame.QUIT event means the user clicked X to close your window
+    for event in pygame.event.get():
+        if event.type == pygame.QUIT:
+            running = False
+
+    # fill the screen with a color to wipe away anything from last frame
+    screen.fill("purple")
+
+    # RENDER YOUR GAME HERE
+
+    # flip() the display to put your work on screen
+    pygame.display.flip()
+
+    clock.tick(60)  # limits FPS to 60
+
+pygame.quit()
+

+

+
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
+
+# pygame setup
+pygame.init()
+screen = pygame.display.set_mode((1280, 720))
+clock = pygame.time.Clock()
+running = True
+dt = 0
+
+player_pos = pygame.Vector2(screen.get_width() / 2, screen.get_height() / 2)
+
+while running:
+    # poll for events
+    # pygame.QUIT event means the user clicked X to close your window
+    for event in pygame.event.get():
+        if event.type == pygame.QUIT:
+            running = False
+
+    # fill the screen with a color to wipe away anything from last frame
+    screen.fill("purple")
+
+    pygame.draw.circle(screen, "red", player_pos, 40)
+
+    keys = pygame.key.get_pressed()
+    if keys[pygame.K_w]:
+        player_pos.y -= 300 * dt
+    if keys[pygame.K_s]:
+        player_pos.y += 300 * dt
+    if keys[pygame.K_a]:
+        player_pos.x -= 300 * dt
+    if keys[pygame.K_d]:
+        player_pos.x += 300 * dt
+
+    # flip() the display to put your work on screen
+    pygame.display.flip()
+
+    # limits FPS to 60
+    # dt is delta time in seconds since last frame, used for framerate-
+    # independent physics.
+    dt = clock.tick(60) / 1000
+
+pygame.quit()
+

+

+
For more in depth reference, check out the Tutorials
+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.

+

+
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.

+

+
Pygame Logos
The logos of Pygame in different resolutions.

+

+
LGPL License
This is the license pygame is distributed under.
+It provides for pygame to be distributed with open source and commercial software.
+Generally, if pygame is not changed, it can be used with any type of program.

+

+

+

+

+
Tutorials

+

+
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.
+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.
+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.
+This was inspired by the annoying flash banner of the early 2000s.
+This tutorial examines every line of code used in the example.

+

+
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.

+

+
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,
+watch live streams, and do some basic computer vision.
+This tutorial covers those use cases.

+

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

+

+
Making Games Tutorial
A large tutorial that covers the bigger topics needed to create an entire game.

+

+
Display Modes
Getting a display surface for the screen.

+

+
한국어 튜토리얼 (Korean Tutorial)
빨간블록 검은블록

+

+

+

+

+
Reference

+

+
Index
A list of all functions, classes, and methods in the pygame package.

+

+
pygame.BufferProxy
An array protocol view of surface pixels

+

+
pygame.Color
Color representation.

+

+
pygame.cursors
Loading and compiling cursor images.

+

+
pygame.display
Configure the display surface.

+

+
pygame.draw
Drawing simple shapes like lines and ellipses to surfaces.

+

+
pygame.event
Manage the incoming events from various input devices and the windowing platform.

+

+
pygame.examples
Various programs demonstrating the use of individual pygame modules.

+

+
pygame.font
Loading and rendering TrueType fonts.

+

+
pygame.freetype
Enhanced pygame module for loading and rendering font faces.

+

+
pygame.gfxdraw
Anti-aliasing draw functions.

+

+
pygame.image
Loading, saving, and transferring of surfaces.

+

+
pygame.joystick
Manage the joystick devices.

+

+
pygame.key
Manage the keyboard device.

+

+
pygame.locals
Pygame constants.

+

+
pygame.mixer
Load and play sounds

+

+
pygame.mouse
Manage the mouse device and display.

+

+
pygame.mixer.music
Play streaming music tracks.

+

+
pygame
Top level functions to manage pygame.

+

+
pygame.PixelArray
Manipulate image pixel data.

+

+
pygame.Rect
Flexible container for a rectangle.

+

+
pygame.scrap
Native clipboard access.

+

+
pygame.sndarray
Manipulate sound sample data.

+

+
pygame.sprite
Higher level objects to represent game images.

+

+
pygame.Surface
Objects for images and the screen.

+

+
pygame.surfarray
Manipulate image pixel data.

+

+
pygame.tests
Test pygame.

+

+
pygame.time
Manage timing and framerate.

+

+
pygame.transform
Resize and move images.

+

+
pygame C API
The C api shared amongst pygame extension modules.

+

+
Search Page
Search pygame documents by keyword.

+

+

+

+

+
+
+


+

+Edit on GitHub
+            

+          

+      

+      

+    

+    
+    
+  
+
\ No newline at end of file
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/logos.html b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/logos.html
new file mode 100644
index 0000000..ee3ab76
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/logos.html
@@ -0,0 +1,168 @@
+
+
+
+  
+    
+    
+
+    Pygame Logos Page — pygame v2.6.1 documentation
+    
+    
+    
+    
+    
+    
+    
+    
+     
+    
+
+    

+
+  

+	

+	
+	

+	  

+	    Pygame Home ||
+	    Help Contents ||
+	    Reference Index
+
+        

+          
+          
+        

+	  

+	  

+	  
Most useful stuff:
+	    Color | 
+	    display | 
+	    draw | 
+	    event | 
+	    font | 
+	    image | 
+	    key | 
+	    locals | 
+	    mixer | 
+	    mouse | 
+	    Rect | 
+	    Surface | 
+	    time | 
+	    music | 
+	    pygame
+	  

+
+	  
Advanced stuff:
+	    cursors | 
+	    joystick | 
+	    mask | 
+	    sprite | 
+	    transform | 
+	    BufferProxy | 
+	    freetype | 
+	    gfxdraw | 
+	    midi | 
+	    PixelArray | 
+	    pixelcopy | 
+	    sndarray | 
+	    surfarray | 
+	    math
+	  

+
+	  
Other:
+	    camera | 
+	    controller | 
+	    examples | 
+	    fastevent | 
+	    scrap | 
+	    tests | 
+	    touch | 
+	    version
+	  

+

+

+  

+
+      

+          

+            
+

+

+
Pygame Logos

+
These logos are available for use in your own game projects.
+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
+

+
pygame_logo.svg

+
pygame_logo.png - 1561 x 438

+

+_images/pygame_lofi.png
+

+
pygame_lofi.svg

+
pygame_lofi.png - 1561 x 438

+

+_images/pygame_powered.png
+

+
pygame_powered.svg

+
pygame_powered.png - 1617 x 640

+

+_images/pygame_tiny.png
+

+
pygame_tiny.png - 214 x 60

+

+_images/pygame_powered_lowres.png
+

+
pygame_powered_lowres.png - 101 x 40

+

+

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

+

+
Legacy logos

+

+
legacy_logos.zip - 50.1 KB

+

+

+

+

+
+
+


+

+Edit on GitHub
+            

+          

+      

+      

+    

+    
+    
+  
+
\ No newline at end of file
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/py-modindex.html b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/py-modindex.html
new file mode 100644
index 0000000..b708bed
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/py-modindex.html
@@ -0,0 +1,249 @@
+
+
+
+  
+    
+    
+    Python Module Index — pygame v2.6.1 documentation
+    
+    
+    
+    
+    
+    
+    
+    
+ 
+
+
+  
+      
+
+    

+      

+          

+            
+
+   
Python Module Index

+
+   

+   . | 
+   p
+   

+
+   
+     
+     
+     
+       
+       
+     
+       
+       
+     
+       
+       
+     
+       
+       
+     
+       
+       
+     
+       
+       
+     
+       
+       
+     
+       
+       
+     
+       
+       
+     
+       
+       
+     
+       
+       
+     
+       
+       
+     
+       
+       
+     
+       
+       
+     
+       
+       
+     
+       
+       
+     
+       
+       
+     
+       
+       
+     
+       
+       
+     
+       
+       
+     
+       
+       
+     
+       
+       
+     
+       
+       
+     
+       
+       
+     
+       
+       
+     
+       
+       
+     
+       
+       
+     
+       
+       
+     
+       
+       
+     
+       
+       
+     
+       
+       
+     
+       
+       
+     
+       
+       
+     
+     
+     
+       
+       
+   
 

+       .
   
+       pygame._sdl2.controller
+       pygame module to work with controllers
   
+       pygame._sdl2.touch
+       pygame module to work with touch input
   
+       pygame._sdl2.video
+       Experimental pygame module for porting new SDL video systems
   
+       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
   
+       pygame.event
+       pygame module for interacting with events and queues
   
+       pygame.examples
+       module of example programs
   
+       pygame.fastevent
+       pygame module for interacting with events and queues from multiple
+threads.
   
+       pygame.font
+       pygame module for loading and rendering fonts
   
+       pygame.freetype
+       Enhanced pygame module for loading and rendering computer fonts
   
+       pygame.gfxdraw
+       pygame module for drawing shapes
   
+       pygame.image
+       pygame module for loading and saving images
   
+       pygame.joystick
+       Pygame module for interacting with joysticks, gamepads, and trackballs.
   
+       pygame.key
+       pygame module to work with the keyboard
   
+       pygame.locals
+       pygame constants
   
+       pygame.mask
+       pygame module for image masks.
   
+       pygame.math
+       pygame module for vector classes
   
+       pygame.midi
+       pygame module for interacting with midi input and output.
   
+       pygame.mixer
+       pygame module for loading and playing sounds
   
+       pygame.mixer.music
+       pygame module for controlling streamed audio
   
+       pygame.mouse
+       pygame module to work with the mouse
   
+       pygame.pixelcopy
+       pygame module for general pixel array copying
   
+       pygame.scrap
+       pygame module for clipboard support.
   
+       pygame.sndarray
+       pygame module for accessing sound sample data
   
+       pygame.sprite
+       pygame module with basic game object classes
   
+       pygame.surfarray
+       pygame module for accessing surface pixel data using array interfaces
   
+       pygame.tests
+       Pygame unit test suite package
   
+       pygame.time
+       pygame module for monitoring time
   
+       pygame.transform
+       pygame module to transform surfaces
   
+       pygame.version
+       small module containing version information
 

+       p

+       pygame
+       the top level pygame package

+
+
+            

+          

+      

+      

+    

+    
+    
+  
+
\ No newline at end of file
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/ref/bufferproxy.html b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/ref/bufferproxy.html
new file mode 100644
index 0000000..d43b2f9
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/ref/bufferproxy.html
@@ -0,0 +1,274 @@
+
+
+
+  
+    
+    
+
+    pygame.BufferProxy — pygame v2.6.1 documentation
+    
+    
+    
+    
+    
+    
+    
+    
+    
+     
+    
+
+    

+
+  

+	

+	
+	

+	  

+	    Pygame Home ||
+	    Help Contents ||
+	    Reference Index
+
+        

+          
+          
+        

+	  

+	  

+	  
Most useful stuff:
+	    Color | 
+	    display | 
+	    draw | 
+	    event | 
+	    font | 
+	    image | 
+	    key | 
+	    locals | 
+	    mixer | 
+	    mouse | 
+	    Rect | 
+	    Surface | 
+	    time | 
+	    music | 
+	    pygame
+	  

+
+	  
Advanced stuff:
+	    cursors | 
+	    joystick | 
+	    mask | 
+	    sprite | 
+	    transform | 
+	    BufferProxy | 
+	    freetype | 
+	    gfxdraw | 
+	    midi | 
+	    PixelArray | 
+	    pixelcopy | 
+	    sndarray | 
+	    surfarray | 
+	    math
+	  

+
+	  
Other:
+	    camera | 
+	    controller | 
+	    examples | 
+	    fastevent | 
+	    scrap | 
+	    tests | 
+	    touch | 
+	    version
+	  

+

+

+  

+
+      

+          

+            
+

+

+

+pygame.BufferProxy

+

+
pygame object to export a surface buffer through an array protocol

+
BufferProxy(<parent>) -> BufferProxy

+

+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
pygame.BufferProxy.parent

+		—Return wrapped exporting object.
pygame.BufferProxy.length

+		—The size, in bytes, of the exported buffer.
pygame.BufferProxy.raw

+		—A copy of the exported buffer as a single block of bytes.
pygame.BufferProxy.write

+		—Write raw bytes to object buffer.

+
BufferProxy is a pygame support type, designed as the return value
+of the Surface.get_buffer() and Surface.get_view() methods.
+For all Python versions a BufferProxy object exports a C struct
+and Python level array interface on behalf of its parent object's buffer.
+A new buffer interface is also exported.
+In pygame, BufferProxy is key to implementing the
+pygame.surfarraypygame module for accessing surface pixel data using array interfaces module.

+
BufferProxy instances can be created directly from Python code,
+either for a parent that exports an interface, or from a Python dict
+describing an object's buffer layout. The dict entries are based on the
+Python level array interface mapping. The following keys are recognized:

+

+

+
"shape"tuple
The length of each array dimension as a tuple of integers. The
+length of the tuple is the number of dimensions in the array.

+

+
"typestr"string
The array element type as a length 3 string. The first character
+gives byteorder, '<' for little-endian, '>' for big-endian, and
+'|' for not applicable. The second character is the element type,
+'i' for signed integer, 'u' for unsigned integer, 'f' for floating
+point, and 'V' for an chunk of bytes. The third character gives the
+bytesize of the element, from '1' to '9' bytes. So, for example,
+"<u4" is an unsigned 4 byte little-endian integer, such as a
+32 bit pixel on a PC, while "|V3" would represent a 24 bit pixel,
+which has no integer equivalent.

+

+
"data"tuple
The physical buffer start address and a read-only flag as a length
+2 tuple. The address is an integer value, while the read-only flag
+is a bool—False for writable, True for read-only.

+

+
"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".

+

+
"parent"object(optional)
The exporting object. It can be used to keep the parent object
+alive while its buffer is visible.

+

+
"before"callable(optional)
Callback invoked when the BufferProxy instance
+exports the buffer. The callback is given one argument, the
+"parent" object if given, otherwise None.
+The callback is useful for setting a lock on the parent.

+

+
"after"callable(optional)
Callback invoked when an exported buffer is released.
+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.

+

+
New in pygame 1.8.0.

+

+

+
Extended in pygame 1.9.2.

+

+

+

+parent

+

+
Return wrapped exporting object.

+
parent -> Surface

+
parent -> <parent>

+

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

+

+
+

+

+length

+

+
The size, in bytes, of the exported buffer.

+
length -> int

+

+
The number of valid bytes of data exported. For discontinuous data,
+that is data which is not a single block of memory, the bytes within
+the gaps are excluded from the count. This property is equivalent to
+the Py_buffer C struct len field.

+

+
+

+

+raw

+

+
A copy of the exported buffer as a single block of bytes.

+
raw -> bytes

+

+
The buffer data as a str/bytes object.
+Any gaps in the exported data are removed.

+

+
+

+

+write()

+

+
Write raw bytes to object buffer.

+
write(buffer, offset=0)

+

+
Overwrite bytes in the parent object's data. The data must be C or F
+contiguous, otherwise a ValueError is raised. Argument buffer is a
+str/bytes object. An optional offset gives a
+start position, in bytes, within the buffer where overwriting begins.
+If the offset is negative or greater that or equal to the buffer proxy's
+length value, an IndexException is raised.
+If len(buffer) > proxy.length + offset, a ValueError is raised.

+

+
+

+
+

+
+
+


+

+Edit on GitHub
+            

+          

+      

+      

+    

+    
+    
+  
+
\ No newline at end of file
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/ref/camera.html b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/ref/camera.html
new file mode 100644
index 0000000..d829f50
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/ref/camera.html
@@ -0,0 +1,462 @@
+
+
+
+  
+    
+    
+
+    pygame.camera — pygame v2.6.1 documentation
+    
+    
+    
+    
+    
+    
+    
+    
+    
+     
+    
+
+    

+
+  

+	

+	
+	

+	  

+	    Pygame Home ||
+	    Help Contents ||
+	    Reference Index
+
+        

+          
+          
+        

+	  

+	  

+	  
Most useful stuff:
+	    Color | 
+	    display | 
+	    draw | 
+	    event | 
+	    font | 
+	    image | 
+	    key | 
+	    locals | 
+	    mixer | 
+	    mouse | 
+	    Rect | 
+	    Surface | 
+	    time | 
+	    music | 
+	    pygame
+	  

+
+	  
Advanced stuff:
+	    cursors | 
+	    joystick | 
+	    mask | 
+	    sprite | 
+	    transform | 
+	    BufferProxy | 
+	    freetype | 
+	    gfxdraw | 
+	    midi | 
+	    PixelArray | 
+	    pixelcopy | 
+	    sndarray | 
+	    surfarray | 
+	    math
+	  

+
+	  
Other:
+	    camera | 
+	    controller | 
+	    examples | 
+	    fastevent | 
+	    scrap | 
+	    tests | 
+	    touch | 
+	    version
+	  

+

+

+  

+
+      

+          

+            
+

+

+

+pygame.camera

+

+
pygame module for camera use

+

+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
pygame.camera.init

+		—Module init
pygame.camera.get_backends

+		—Get the backends supported on this system
pygame.camera.colorspace

+		—Surface colorspace conversion
pygame.camera.list_cameras

+		—returns a list of available cameras
pygame.camera.Camera

+		—load a camera

+

+
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

+

+
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:

+
Sonix SN9C101 based webcam basic I/F routines
+Copyright (C) 2004 Takafumi Mizuno <taka-qce@ls-a.jp>
+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 AUTHOR 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 AUTHOR 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.
+

+

+
New in pygame 1.9.0.

+

+

+pygame.camera.init()

+

+
Module init

+
init(backend = None) -> None

+

+
This function starts up the camera module, choosing the best webcam backend
+it can find for your system. This is not guaranteed to succeed, and may even
+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

+

+

+
+

+

+pygame.camera.get_backends()

+

+
Get the backends supported on this system

+
get_backends() -> [str]

+

+
This function returns every backend it thinks has a possibility of working
+on your system, in order of priority.

+
pygame.camera Backends:

+
Backend           OS        Description
+---------------------------------------------------------------------------------
+_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 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.

+

+

+
+

+

+pygame.camera.colorspace()

+

+
Surface colorspace conversion

+
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
+depth. This is useful for computer vision on devices with limited processing
+power. Capture as small of an image as possible, transform.scale() it
+even smaller, and then convert the colorspace to YUV or HSV before
+doing any processing on it.

+

+
+

+

+pygame.camera.list_cameras()

+

+
returns a list of available cameras

+
list_cameras() -> [cameras]

+

+
Checks the computer for available cameras and returns a list of strings of
+camera names, ready to be fed into pygame.camera.Cameraload a camera.

+
If the camera backend doesn't support webcam enumeration, this will return
+something like [0]. See get_backends() for much more
+information.

+

+
+

+

+pygame.camera.Camera

+

+
load a camera

+
Camera(device, (width, height), format) -> Camera

+

+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
pygame.camera.Camera.start

+		—opens, initializes, and starts capturing
pygame.camera.Camera.stop

+		—stops, uninitializes, and closes the camera
pygame.camera.Camera.get_controls

+		—gets current values of user controls
pygame.camera.Camera.set_controls

+		—changes camera settings if supported by the camera
pygame.camera.Camera.get_size

+		—returns the dimensions of the images being recorded
pygame.camera.Camera.query_image

+		—checks if a frame is ready
pygame.camera.Camera.get_image

+		—captures an image as a Surface
pygame.camera.Camera.get_raw

+		—returns an unmodified image as bytes

+
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.
+This is useful for computer vision purposes. The default is
+RGB. The following are supported:

+

+
    
+
  • RGB - Red, Green, Blue
    • 
+
  • YUV - Luma, Blue Chrominance, Red Chrominance
    • 
+
  • HSV - Hue, Saturation, Value
    • 
+

+

+

+

+start()

+

+
opens, initializes, and starts capturing

+
start() -> None

+

+
Opens the camera device, attempts to initialize it, and begins recording
+images to a buffer. The camera must be started before any of the below
+functions can be used.

+

+
+

+

+stop()

+

+
stops, uninitializes, and closes the camera

+
stop() -> None

+

+
Stops recording, uninitializes the camera, and closes it. Once a camera
+is stopped, the below functions cannot be used until it is started again.

+

+
+

+

+get_controls()

+

+
gets current values of user controls

+
get_controls() -> (hflip = bool, vflip = bool, brightness)

+

+
If the camera supports it, get_controls will return the current settings
+for horizontal and vertical image flip as bools and brightness as an int.
+If unsupported, it will return the default values of (0, 0, 0). Note that
+the return values here may be different than those returned by
+set_controls, though these are more likely to be correct.

+

+
+

+

+set_controls()

+

+
changes camera settings if supported by the camera

+
set_controls(hflip = bool, vflip = bool, brightness) -> (hflip = bool, vflip = bool, brightness)

+

+
Allows you to change camera settings if the camera supports it. The
+return values will be the input values if the camera claims it succeeded
+or the values previously in use if not. Each argument is optional, and
+the desired one can be chosen by supplying the keyword, like hflip. Note
+that the actual settings being used by the camera may not be the same as
+those returned by set_controls. On Windows, hflip and vflip are
+implemented by pygame, not by the Camera, so they should always work, but
+brightness is unsupported.

+

+
+

+

+get_size()

+

+
returns the dimensions of the images being recorded

+
get_size() -> (width, height)

+

+
Returns the current dimensions of the images being captured by the
+camera. This will return the actual size, which may be different than the
+one specified during initialization if the camera did not support that
+size.

+

+
+

+

+query_image()

+

+
checks if a frame is ready

+
query_image() -> bool

+

+
If an image is ready to get, it returns true. Otherwise it returns false.
+Note that some webcams will always return False and will only queue a
+frame when called with a blocking function like get_image().
+On Windows (MSMF), and the  OpenCV backends, 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.

+

+
+

+

+get_image()

+

+
captures an image as a 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
+24 bits on Linux, 32 bits on Windows, or the same as the optionally
+supplied Surface.

+

+
+

+

+get_raw()

+

+
returns an unmodified image as bytes

+
get_raw() -> bytes

+

+
Gets an image from a camera as a string in the native pixelformat of the
+camera. Useful for integration with other libraries. This returns a
+bytes object

+

+
+

+
+

+
+

+
+
+


+

+Edit on GitHub
+            

+          

+      

+      

+    

+    
+    
+  
+
\ No newline at end of file
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/ref/cdrom.html b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/ref/cdrom.html
new file mode 100644
index 0000000..f9c351a
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/ref/cdrom.html
@@ -0,0 +1,578 @@
+
+
+
+  
+    
+    
+
+    pygame.cdrom — pygame v2.6.1 documentation
+    
+    
+    
+    
+    
+    
+    
+    
+    
+     
+    
+
+    

+
+  

+	

+	
+	

+	  

+	    Pygame Home ||
+	    Help Contents ||
+	    Reference Index
+
+        

+          
+          
+        

+	  

+	  

+	  
Most useful stuff:
+	    Color | 
+	    display | 
+	    draw | 
+	    event | 
+	    font | 
+	    image | 
+	    key | 
+	    locals | 
+	    mixer | 
+	    mouse | 
+	    Rect | 
+	    Surface | 
+	    time | 
+	    music | 
+	    pygame
+	  

+
+	  
Advanced stuff:
+	    cursors | 
+	    joystick | 
+	    mask | 
+	    sprite | 
+	    transform | 
+	    BufferProxy | 
+	    freetype | 
+	    gfxdraw | 
+	    midi | 
+	    PixelArray | 
+	    pixelcopy | 
+	    sndarray | 
+	    surfarray | 
+	    math
+	  

+
+	  
Other:
+	    camera | 
+	    controller | 
+	    examples | 
+	    fastevent | 
+	    scrap | 
+	    tests | 
+	    touch | 
+	    version
+	  

+

+

+  

+
+      

+          

+            
+

+

+

+pygame.cdrom

+

+
pygame module for audio cdrom control

+

+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
pygame.cdrom.init

+		—initialize the cdrom module
pygame.cdrom.quit

+		—uninitialize the cdrom module
pygame.cdrom.get_init

+		—true if the cdrom module is initialized
pygame.cdrom.get_count

+		—number of cd drives on the system
pygame.cdrom.CD

+		—class to manage a cdrom drive

+

+
Warning

+
This module is non functional in pygame 2.0 and above, unless you have manually compiled pygame with SDL1.
+This module will not be supported in the future.
+One alternative for python cdrom functionality is pycdio.

+

+
The cdrom module manages the CD and DVD drives on a computer. It can
+also control the playback of audio CDs. This module needs to be initialized
+before it can do anything. Each CD object you create represents a cdrom
+drive and must also be initialized individually before it can do most things.

+

+

+pygame.cdrom.init()

+

+
initialize the cdrom module

+
init() -> None

+

+
Initialize the cdrom module. This will scan the system for all CD
+devices. The module must be initialized before any other functions will
+work. This automatically happens when you call pygame.init().

+
It is safe to call this function more than once.

+

+
+

+

+pygame.cdrom.quit()

+

+
uninitialize the cdrom module

+
quit() -> None

+

+
Uninitialize the cdrom module. After you call this any existing CD
+objects will no longer work.

+
It is safe to call this function more than once.

+

+
+

+

+pygame.cdrom.get_init()

+

+
true if the cdrom module is initialized

+
get_init() -> bool

+

+
Test if the cdrom module is initialized or not. This is different than the
+CD.init() since each drive must also be initialized individually.

+

+
+

+

+pygame.cdrom.get_count()

+

+
number of cd drives on the system

+
get_count() -> count

+

+
Return the number of cd drives on the system. When you create CD objects
+you need to pass an integer id that must be lower than this count. The count
+will be 0 if there are no drives on the system.

+

+
+

+

+pygame.cdrom.CD

+

+
class to manage a cdrom drive

+
CD(id) -> CD

+

+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
pygame.cdrom.CD.init

+		—initialize a cdrom drive for use
pygame.cdrom.CD.quit

+		—uninitialize a cdrom drive for use
pygame.cdrom.CD.get_init

+		—true if this cd device initialized
pygame.cdrom.CD.play

+		—start playing audio
pygame.cdrom.CD.stop

+		—stop audio playback
pygame.cdrom.CD.pause

+		—temporarily stop audio playback
pygame.cdrom.CD.resume

+		—unpause audio playback
pygame.cdrom.CD.eject

+		—eject or open the cdrom drive
pygame.cdrom.CD.get_id

+		—the index of the cdrom drive
pygame.cdrom.CD.get_name

+		—the system name of the cdrom drive
pygame.cdrom.CD.get_busy

+		—true if the drive is playing audio
pygame.cdrom.CD.get_paused

+		—true if the drive is paused
pygame.cdrom.CD.get_current

+		—the current audio playback position
pygame.cdrom.CD.get_empty

+		—False if a cdrom is in the drive
pygame.cdrom.CD.get_numtracks

+		—the number of tracks on the cdrom
pygame.cdrom.CD.get_track_audio

+		—true if the cdrom track has audio data
pygame.cdrom.CD.get_all

+		—get all track information
pygame.cdrom.CD.get_track_start

+		—start time of a cdrom track
pygame.cdrom.CD.get_track_length

+		—length of a cdrom track

+
You can create a CD object for each cdrom on the system. Use
+pygame.cdrom.get_count() to determine how many drives actually exist.
+The id argument is an integer of the drive, starting at zero.

+
The CD object is not initialized, you can only call CD.get_id() and
+CD.get_name() on an uninitialized drive.

+
It is safe to create multiple CD objects for the same drive, they will
+all cooperate normally.

+

+

+init()

+

+
initialize a cdrom drive for use

+
init() -> None

+

+
Initialize the cdrom drive for use. The drive must be initialized for
+most CD methods to work. Even if the rest of pygame has been
+initialized.

+
There may be a brief pause while the drive is initialized. Avoid
+CD.init() if the program should not stop for a second or two.

+

+
+

+

+quit()

+

+
uninitialize a cdrom drive for use

+
quit() -> None

+

+
Uninitialize a drive for use. Call this when your program will not be
+accessing the drive for awhile.

+

+
+

+

+get_init()

+

+
true if this cd device initialized

+
get_init() -> bool

+

+
Test if this CDROM device is initialized. This is different than the
+pygame.cdrom.init() since each drive must also be initialized
+individually.

+

+
+

+

+play()

+

+
start playing audio

+
play(track, start=None, end=None) -> None

+

+
Playback audio from an audio cdrom in the drive. Besides the track number
+argument, you can also pass a starting and ending time for playback. The
+start and end time are in seconds, and can limit the section of an audio
+track played.

+
If you pass a start time but no end, the audio will play to the end of
+the track. If you pass a start time and 'None' for the end time, the
+audio will play to the end of the entire disc.

+
See the CD.get_numtracks() and CD.get_track_audio() to find
+tracks to playback.

+
Note, track 0 is the first track on the CD. Track numbers start at
+zero.

+

+
+

+

+stop()

+

+
stop audio playback

+
stop() -> None

+

+
Stops playback of audio from the cdrom. This will also lose the current
+playback position. This method does nothing if the drive isn't already
+playing audio.

+

+
+

+

+pause()

+

+
temporarily stop audio playback

+
pause() -> None

+

+
Temporarily stop audio playback on the CD. The playback can be
+resumed at the same point with the CD.resume() method. If the CD
+is not playing this method does nothing.

+
Note, track 0 is the first track on the CD. Track numbers start at
+zero.

+

+
+

+

+resume()

+

+
unpause audio playback

+
resume() -> None

+

+
Unpause a paused CD. If the CD is not paused or already playing,
+this method does nothing.

+

+
+

+

+eject()

+

+
eject or open the cdrom drive

+
eject() -> None

+

+
This will open the cdrom drive and eject the cdrom. If the drive is
+playing or paused it will be stopped.

+

+
+

+

+get_id()

+

+
the index of the cdrom drive

+
get_id() -> id

+

+
Returns the integer id that was used to create the CD instance. This
+method can work on an uninitialized CD.

+

+
+

+

+get_name()

+

+
the system name of the cdrom drive

+
get_name() -> name

+

+
Return the string name of the drive. This is the system name used to
+represent the drive. It is often the drive letter or device name. This
+method can work on an uninitialized CD.

+

+
+

+

+get_busy()

+

+
true if the drive is playing audio

+
get_busy() -> bool

+

+
Returns True if the drive busy playing back audio.

+

+
+

+

+get_paused()

+

+
true if the drive is paused

+
get_paused() -> bool

+

+
Returns True if the drive is currently paused.

+

+
+

+

+get_current()

+

+
the current audio playback position

+
get_current() -> track, seconds

+

+
Returns both the current track and time of that track. This method works
+when the drive is either playing or paused.

+
Note, track 0 is the first track on the CD. Track numbers start at
+zero.

+

+
+

+

+get_empty()

+

+
False if a cdrom is in the drive

+
get_empty() -> bool

+

+
Return False if there is a cdrom currently in the drive. If the drive is
+empty this will return True.

+

+
+

+

+get_numtracks()

+

+
the number of tracks on the cdrom

+
get_numtracks() -> count

+

+
Return the number of tracks on the cdrom in the drive. This will return
+zero of the drive is empty or has no tracks.

+

+
+

+

+get_track_audio()

+

+
true if the cdrom track has audio data

+
get_track_audio(track) -> bool

+

+
Determine if a track on a cdrom contains audio data. You can also call
+CD.num_tracks() and CD.get_all() to determine more information
+about the cdrom.

+
Note, track 0 is the first track on the CD. Track numbers start at
+zero.

+

+
+

+

+get_all()

+

+
get all track information

+
get_all() -> [(audio, start, end, length), ...]

+

+
Return a list with information for every track on the cdrom. The
+information consists of a tuple with four values. The audio value is True
+if the track contains audio data. The start, end, and length values are
+floating point numbers in seconds. Start and end represent absolute times
+on the entire disc.

+

+
+

+

+get_track_start()

+

+
start time of a cdrom track

+
get_track_start(track) -> seconds

+

+
Return the absolute time in seconds where at start of the cdrom track.

+
Note, track 0 is the first track on the CD. Track numbers start at
+zero.

+

+
+

+

+get_track_length()

+

+
length of a cdrom track

+
get_track_length(track) -> seconds

+

+
Return a floating point value in seconds of the length of the cdrom
+track.

+
Note, track 0 is the first track on the CD. Track numbers start at
+zero.

+

+
+

+
+

+
+

+
+
+


+

+Edit on GitHub
+            

+          

+      

+      

+    

+    
+    
+  
+
\ No newline at end of file
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/ref/color.html b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/ref/color.html
new file mode 100644
index 0000000..2f4dc2d
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/ref/color.html
@@ -0,0 +1,523 @@
+
+
+
+  
+    
+    
+
+    pygame.Color — pygame v2.6.1 documentation
+    
+    
+    
+    
+    
+    
+    
+    
+    
+     
+    
+
+    

+
+  

+	

+	
+	

+	  

+	    Pygame Home ||
+	    Help Contents ||
+	    Reference Index
+
+        

+          
+          
+        

+	  

+	  

+	  
Most useful stuff:
+	    Color | 
+	    display | 
+	    draw | 
+	    event | 
+	    font | 
+	    image | 
+	    key | 
+	    locals | 
+	    mixer | 
+	    mouse | 
+	    Rect | 
+	    Surface | 
+	    time | 
+	    music | 
+	    pygame
+	  

+
+	  
Advanced stuff:
+	    cursors | 
+	    joystick | 
+	    mask | 
+	    sprite | 
+	    transform | 
+	    BufferProxy | 
+	    freetype | 
+	    gfxdraw | 
+	    midi | 
+	    PixelArray | 
+	    pixelcopy | 
+	    sndarray | 
+	    surfarray | 
+	    math
+	  

+
+	  
Other:
+	    camera | 
+	    controller | 
+	    examples | 
+	    fastevent | 
+	    scrap | 
+	    tests | 
+	    touch | 
+	    version
+	  

+

+

+  

+
+      

+          

+            
+

+

+

+pygame.Color

+

+
pygame object for color representations

+
Color(r, g, b) -> Color

+
Color(r, g, b, a=255) -> Color

+
Color(color_value) -> Color

+

+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
pygame.Color.r

+		—Gets or sets the red value of the Color.
pygame.Color.g

+		—Gets or sets the green value of the Color.
pygame.Color.b

+		—Gets or sets the blue value of the Color.
pygame.Color.a

+		—Gets or sets the alpha value of the Color.
pygame.Color.cmy

+		—Gets or sets the CMY representation of the Color.
pygame.Color.hsva

+		—Gets or sets the HSVA representation of the Color.
pygame.Color.hsla

+		—Gets or sets the HSLA representation of the Color.
pygame.Color.i1i2i3

+		—Gets or sets the I1I2I3 representation of the Color.
pygame.Color.normalize

+		—Returns the normalized RGBA values of the Color.
pygame.Color.correct_gamma

+		—Applies a certain gamma value to the Color.
pygame.Color.set_length

+		—Set the number of elements in the Color to 1,2,3, or 4.
pygame.Color.grayscale

+		—returns the grayscale of a Color
pygame.Color.lerp

+		—returns a linear interpolation to the given Color.
pygame.Color.premul_alpha

+		—returns a Color where the r,g,b components have been multiplied by the alpha.
pygame.Color.update

+		—Sets the elements of the 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 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.

+

+
Parameters:

+
    
+
  • r (int) -- red value in the range of 0 to 255 inclusive
    • 
+
  • g (int) -- green value in the range of 0 to 255 inclusive
    • 
+
  • b (int) -- blue value in the range of 0 to 255 inclusive
    • 
+
  • a (int) -- (optional) alpha value in the range of 0 to 255 inclusive,
+default is 255
    • 
+
  • color_value (Color or str or int or tuple(int, int, int, [int]) or
+list(int, int, int, [int])) -- 
    color value (see note below for the supported formats)
    
+
    
+
    Note
    
+
    
+
    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)
    
+
    - 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
    
+
    
+
    
+
    
+
    
+
    • 
+

+

+
Returns:

+
a newly created Color object

+

+
Return type:

+
Color

+

+

+

+
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

+

+
Gets or sets the red value of the Color.

+
r -> int

+

+
The red value of the Color.

+

+
+

+

+g

+

+
Gets or sets the green value of the Color.

+
g -> int

+

+
The green value of the Color.

+

+
+

+

+b

+

+
Gets or sets the blue value of the Color.

+
b -> int

+

+
The blue value of the Color.

+

+
+

+

+a

+

+
Gets or sets the alpha value of the Color.

+
a -> int

+

+
The alpha value of the Color.

+

+
+

+

+cmy

+

+
Gets or sets the CMY representation of the Color.

+
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.

+

+
+

+

+hsva

+

+
Gets or sets the HSVA representation of the Color.

+
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.

+

+
+

+

+hsla

+

+
Gets or sets the HSLA representation of the Color.

+
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.

+

+
+

+

+i1i2i3

+

+
Gets or sets the I1I2I3 representation of the Color.

+
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.

+

+
+

+

+normalize()

+

+
Returns the normalized RGBA values of the Color.

+
normalize() -> tuple

+

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

+

+
+

+

+correct_gamma()

+

+
Applies a certain gamma value to the Color.

+
correct_gamma (gamma) -> Color

+

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

+

+
+

+

+set_length()

+

+
Set the number of elements in the Color to 1,2,3, or 4.

+
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 since pygame 2.1.3.

+

+

+
New in pygame 1.9.0.

+

+

+
+

+

+grayscale()

+

+
returns the grayscale of a Color

+
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..

+

+
+

+

+lerp()

+

+
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.

+

+

+
+

+

+premul_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 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 one image onto another, which assumes that all surfaces using
+it are using pre-multiplied alpha colors.

+

+
New in pygame 2.0.0.

+

+

+
+

+

+update()

+

+
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
+parameters of this function. If the alpha value was not set it will not change.

+

+
New in pygame 2.0.1.

+

+

+
+

+
+

+
+
+


+

+Edit on GitHub
+            

+          

+      

+      

+    

+    
+    
+  
+
\ No newline at end of file
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/ref/color_list.html b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/ref/color_list.html
new file mode 100644
index 0000000..e00c9be
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/ref/color_list.html
@@ -0,0 +1,2805 @@
+
+
+
+  
+    
+    
+
+    Named Colors — pygame v2.6.1 documentation
+    
+    
+    
+    
+    
+    
+    
+    
+    
+     
+    
+
+    

+
+  

+	

+	
+	

+	  

+	    Pygame Home ||
+	    Help Contents ||
+	    Reference Index
+
+        

+          
+          
+        

+	  

+	  

+	  
Most useful stuff:
+	    Color | 
+	    display | 
+	    draw | 
+	    event | 
+	    font | 
+	    image | 
+	    key | 
+	    locals | 
+	    mixer | 
+	    mouse | 
+	    Rect | 
+	    Surface | 
+	    time | 
+	    music | 
+	    pygame
+	  

+
+	  
Advanced stuff:
+	    cursors | 
+	    joystick | 
+	    mask | 
+	    sprite | 
+	    transform | 
+	    BufferProxy | 
+	    freetype | 
+	    gfxdraw | 
+	    midi | 
+	    PixelArray | 
+	    pixelcopy | 
+	    sndarray | 
+	    surfarray | 
+	    math
+	  

+
+	  
Other:
+	    camera | 
+	    controller | 
+	    examples | 
+	    fastevent | 
+	    scrap | 
+	    tests | 
+	    touch | 
+	    version
+	  

+

+

+  

+
+      

+          

+            
+

+
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).

+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
Name
Color
aliceblue
████████
antiquewhite
████████
antiquewhite1
████████
antiquewhite2
████████
antiquewhite3
████████
antiquewhite4
████████
aqua
████████
aquamarine
████████
aquamarine1
████████
aquamarine2
████████
aquamarine3
████████
aquamarine4
████████
azure
████████
azure1
████████
azure2
████████
azure3
████████
azure4
████████
beige
████████
bisque
████████
bisque1
████████
bisque2
████████
bisque3
████████
bisque4
████████
black
████████
blanchedalmond
████████
blue
████████
blue1
████████
blue2
████████
blue3
████████
blue4
████████
blueviolet
████████
brown
████████
brown1
████████
brown2
████████
brown3
████████
brown4
████████
burlywood
████████
burlywood1
████████
burlywood2
████████
burlywood3
████████
burlywood4
████████
cadetblue
████████
cadetblue1
████████
cadetblue2
████████
cadetblue3
████████
cadetblue4
████████
chartreuse
████████
chartreuse1
████████
chartreuse2
████████
chartreuse3
████████
chartreuse4
████████
chocolate
████████
chocolate1
████████
chocolate2
████████
chocolate3
████████
chocolate4
████████
coral
████████
coral1
████████
coral2
████████
coral3
████████
coral4
████████
cornflowerblue
████████
cornsilk
████████
cornsilk1
████████
cornsilk2
████████
cornsilk3
████████
cornsilk4
████████
crimson
████████
cyan
████████
cyan1
████████
cyan2
████████
cyan3
████████
cyan4
████████
darkblue
████████
darkcyan
████████
darkgoldenrod
████████
darkgoldenrod1
████████
darkgoldenrod2
████████
darkgoldenrod3
████████
darkgoldenrod4
████████
darkgray
████████
darkgreen
████████
darkgrey
████████
darkkhaki
████████
darkmagenta
████████
darkolivegreen
████████
darkolivegreen1
████████
darkolivegreen2
████████
darkolivegreen3
████████
darkolivegreen4
████████
darkorange
████████
darkorange1
████████
darkorange2
████████
darkorange3
████████
darkorange4
████████
darkorchid
████████
darkorchid1
████████
darkorchid2
████████
darkorchid3
████████
darkorchid4
████████
darkred
████████
darksalmon
████████
darkseagreen
████████
darkseagreen1
████████
darkseagreen2
████████
darkseagreen3
████████
darkseagreen4
████████
darkslateblue
████████
darkslategray
████████
darkslategray1
████████
darkslategray2
████████
darkslategray3
████████
darkslategray4
████████
darkslategrey
████████
darkturquoise
████████
darkviolet
████████
deeppink
████████
deeppink1
████████
deeppink2
████████
deeppink3
████████
deeppink4
████████
deepskyblue
████████
deepskyblue1
████████
deepskyblue2
████████
deepskyblue3
████████
deepskyblue4
████████
dimgray
████████
dimgrey
████████
dodgerblue
████████
dodgerblue1
████████
dodgerblue2
████████
dodgerblue3
████████
dodgerblue4
████████
firebrick
████████
firebrick1
████████
firebrick2
████████
firebrick3
████████
firebrick4
████████
floralwhite
████████
forestgreen
████████
fuchsia
████████
gainsboro
████████
ghostwhite
████████
gold
████████
gold1
████████
gold2
████████
gold3
████████
gold4
████████
goldenrod
████████
goldenrod1
████████
goldenrod2
████████
goldenrod3
████████
goldenrod4
████████
gray
████████
gray0
████████
gray1
████████
gray2
████████
gray3
████████
gray4
████████
gray5
████████
gray6
████████
gray7
████████
gray8
████████
gray9
████████
gray10
████████
gray11
████████
gray12
████████
gray13
████████
gray14
████████
gray15
████████
gray16
████████
gray17
████████
gray18
████████
gray19
████████
gray20
████████
gray21
████████
gray22
████████
gray23
████████
gray24
████████
gray25
████████
gray26
████████
gray27
████████
gray28
████████
gray29
████████
gray30
████████
gray31
████████
gray32
████████
gray33
████████
gray34
████████
gray35
████████
gray36
████████
gray37
████████
gray38
████████
gray39
████████
gray40
████████
gray41
████████
gray42
████████
gray43
████████
gray44
████████
gray45
████████
gray46
████████
gray47
████████
gray48
████████
gray49
████████
gray50
████████
gray51
████████
gray52
████████
gray53
████████
gray54
████████
gray55
████████
gray56
████████
gray57
████████
gray58
████████
gray59
████████
gray60
████████
gray61
████████
gray62
████████
gray63
████████
gray64
████████
gray65
████████
gray66
████████
gray67
████████
gray68
████████
gray69
████████
gray70
████████
gray71
████████
gray72
████████
gray73
████████
gray74
████████
gray75
████████
gray76
████████
gray77
████████
gray78
████████
gray79
████████
gray80
████████
gray81
████████
gray82
████████
gray83
████████
gray84
████████
gray85
████████
gray86
████████
gray87
████████
gray88
████████
gray89
████████
gray90
████████
gray91
████████
gray92
████████
gray93
████████
gray94
████████
gray95
████████
gray96
████████
gray97
████████
gray98
████████
gray99
████████
gray100
████████
green
████████
green1
████████
green2
████████
green3
████████
green4
████████
greenyellow
████████
grey
████████
grey0
████████
grey1
████████
grey2
████████
grey3
████████
grey4
████████
grey5
████████
grey6
████████
grey7
████████
grey8
████████
grey9
████████
grey10
████████
grey11
████████
grey12
████████
grey13
████████
grey14
████████
grey15
████████
grey16
████████
grey17
████████
grey18
████████
grey19
████████
grey20
████████
grey21
████████
grey22
████████
grey23
████████
grey24
████████
grey25
████████
grey26
████████
grey27
████████
grey28
████████
grey29
████████
grey30
████████
grey31
████████
grey32
████████
grey33
████████
grey34
████████
grey35
████████
grey36
████████
grey37
████████
grey38
████████
grey39
████████
grey40
████████
grey41
████████
grey42
████████
grey43
████████
grey44
████████
grey45
████████
grey46
████████
grey47
████████
grey48
████████
grey49
████████
grey50
████████
grey51
████████
grey52
████████
grey53
████████
grey54
████████
grey55
████████
grey56
████████
grey57
████████
grey58
████████
grey59
████████
grey60
████████
grey61
████████
grey62
████████
grey63
████████
grey64
████████
grey65
████████
grey66
████████
grey67
████████
grey68
████████
grey69
████████
grey70
████████
grey71
████████
grey72
████████
grey73
████████
grey74
████████
grey75
████████
grey76
████████
grey77
████████
grey78
████████
grey79
████████
grey80
████████
grey81
████████
grey82
████████
grey83
████████
grey84
████████
grey85
████████
grey86
████████
grey87
████████
grey88
████████
grey89
████████
grey90
████████
grey91
████████
grey92
████████
grey93
████████
grey94
████████
grey95
████████
grey96
████████
grey97
████████
grey98
████████
grey99
████████
grey100
████████
honeydew
████████
honeydew1
████████
honeydew2
████████
honeydew3
████████
honeydew4
████████
hotpink
████████
hotpink1
████████
hotpink2
████████
hotpink3
████████
hotpink4
████████
indianred
████████
indianred1
████████
indianred2
████████
indianred3
████████
indianred4
████████
indigo
████████
ivory
████████
ivory1
████████
ivory2
████████
ivory3
████████
ivory4
████████
khaki
████████
khaki1
████████
khaki2
████████
khaki3
████████
khaki4
████████
lavender
████████
lavenderblush
████████
lavenderblush1
████████
lavenderblush2
████████
lavenderblush3
████████
lavenderblush4
████████
lawngreen
████████
lemonchiffon
████████
lemonchiffon1
████████
lemonchiffon2
████████
lemonchiffon3
████████
lemonchiffon4
████████
lightblue
████████
lightblue1
████████
lightblue2
████████
lightblue3
████████
lightblue4
████████
lightcoral
████████
lightcyan
████████
lightcyan1
████████
lightcyan2
████████
lightcyan3
████████
lightcyan4
████████
lightgoldenrod
████████
lightgoldenrod1
████████
lightgoldenrod2
████████
lightgoldenrod3
████████
lightgoldenrod4
████████
lightgoldenrodyellow
████████
lightgray
████████
lightgreen
████████
lightgrey
████████
lightpink
████████
lightpink1
████████
lightpink2
████████
lightpink3
████████
lightpink4
████████
lightsalmon
████████
lightsalmon1
████████
lightsalmon2
████████
lightsalmon3
████████
lightsalmon4
████████
lightseagreen
████████
lightskyblue
████████
lightskyblue1
████████
lightskyblue2
████████
lightskyblue3
████████
lightskyblue4
████████
lightslateblue
████████
lightslategray
████████
lightslategrey
████████
lightsteelblue
████████
lightsteelblue1
████████
lightsteelblue2
████████
lightsteelblue3
████████
lightsteelblue4
████████
lightyellow
████████
lightyellow1
████████
lightyellow2
████████
lightyellow3
████████
lightyellow4
████████
lime
████████
limegreen
████████
linen
████████
magenta
████████
magenta1
████████
magenta2
████████
magenta3
████████
magenta4
████████
maroon
████████
maroon1
████████
maroon2
████████
maroon3
████████
maroon4
████████
mediumaquamarine
████████
mediumblue
████████
mediumorchid
████████
mediumorchid1
████████
mediumorchid2
████████
mediumorchid3
████████
mediumorchid4
████████
mediumpurple
████████
mediumpurple1
████████
mediumpurple2
████████
mediumpurple3
████████
mediumpurple4
████████
mediumseagreen
████████
mediumslateblue
████████
mediumspringgreen
████████
mediumturquoise
████████
mediumvioletred
████████
midnightblue
████████
mintcream
████████
mistyrose
████████
mistyrose1
████████
mistyrose2
████████
mistyrose3
████████
mistyrose4
████████
moccasin
████████
navajowhite
████████
navajowhite1
████████
navajowhite2
████████
navajowhite3
████████
navajowhite4
████████
navy
████████
navyblue
████████
oldlace
████████
olive
████████
olivedrab
████████
olivedrab1
████████
olivedrab2
████████
olivedrab3
████████
olivedrab4
████████
orange
████████
orange1
████████
orange2
████████
orange3
████████
orange4
████████
orangered
████████
orangered1
████████
orangered2
████████
orangered3
████████
orangered4
████████
orchid
████████
orchid1
████████
orchid2
████████
orchid3
████████
orchid4
████████
palegoldenrod
████████
palegreen
████████
palegreen1
████████
palegreen2
████████
palegreen3
████████
palegreen4
████████
paleturquoise
████████
paleturquoise1
████████
paleturquoise2
████████
paleturquoise3
████████
paleturquoise4
████████
palevioletred
████████
palevioletred1
████████
palevioletred2
████████
palevioletred3
████████
palevioletred4
████████
papayawhip
████████
peachpuff
████████
peachpuff1
████████
peachpuff2
████████
peachpuff3
████████
peachpuff4
████████
peru
████████
pink
████████
pink1
████████
pink2
████████
pink3
████████
pink4
████████
plum
████████
plum1
████████
plum2
████████
plum3
████████
plum4
████████
powderblue
████████
purple
████████
purple1
████████
purple2
████████
purple3
████████
purple4
████████
red
████████
red1
████████
red2
████████
red3
████████
red4
████████
rosybrown
████████
rosybrown1
████████
rosybrown2
████████
rosybrown3
████████
rosybrown4
████████
royalblue
████████
royalblue1
████████
royalblue2
████████
royalblue3
████████
royalblue4
████████
saddlebrown
████████
salmon
████████
salmon1
████████
salmon2
████████
salmon3
████████
salmon4
████████
sandybrown
████████
seagreen
████████
seagreen1
████████
seagreen2
████████
seagreen3
████████
seagreen4
████████
seashell
████████
seashell1
████████
seashell2
████████
seashell3
████████
seashell4
████████
sienna
████████
sienna1
████████
sienna2
████████
sienna3
████████
sienna4
████████
silver
████████
skyblue
████████
skyblue1
████████
skyblue2
████████
skyblue3
████████
skyblue4
████████
slateblue
████████
slateblue1
████████
slateblue2
████████
slateblue3
████████
slateblue4
████████
slategray
████████
slategray1
████████
slategray2
████████
slategray3
████████
slategray4
████████
slategrey
████████
snow
████████
snow1
████████
snow2
████████
snow3
████████
snow4
████████
springgreen
████████
springgreen1
████████
springgreen2
████████
springgreen3
████████
springgreen4
████████
steelblue
████████
steelblue1
████████
steelblue2
████████
steelblue3
████████
steelblue4
████████
tan
████████
tan1
████████
tan2
████████
tan3
████████
tan4
████████
teal
████████
thistle
████████
thistle1
████████
thistle2
████████
thistle3
████████
thistle4
████████
tomato
████████
tomato1
████████
tomato2
████████
tomato3
████████
tomato4
████████
turquoise
████████
turquoise1
████████
turquoise2
████████
turquoise3
████████
turquoise4
████████
violet
████████
violetred
████████
violetred1
████████
violetred2
████████
violetred3
████████
violetred4
████████
wheat
████████
wheat1
████████
wheat2
████████
wheat3
████████
wheat4
████████
white
████████
whitesmoke
████████
yellow
████████
yellow1
████████
yellow2
████████
yellow3
████████
yellow4
████████
yellowgreen
████████

+

+
+
+


+

+Edit on GitHub
+            

+          

+      

+      

+    

+    
+    
+  
+
\ No newline at end of file
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/ref/cursors.html b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/ref/cursors.html
new file mode 100644
index 0000000..32ae44d
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/ref/cursors.html
@@ -0,0 +1,438 @@
+
+
+
+  
+    
+    
+
+    pygame.cursors — pygame v2.6.1 documentation
+    
+    
+    
+    
+    
+    
+    
+    
+    
+     
+    
+
+    

+
+  

+	

+	
+	

+	  

+	    Pygame Home ||
+	    Help Contents ||
+	    Reference Index
+
+        

+          
+          
+        

+	  

+	  

+	  
Most useful stuff:
+	    Color | 
+	    display | 
+	    draw | 
+	    event | 
+	    font | 
+	    image | 
+	    key | 
+	    locals | 
+	    mixer | 
+	    mouse | 
+	    Rect | 
+	    Surface | 
+	    time | 
+	    music | 
+	    pygame
+	  

+
+	  
Advanced stuff:
+	    cursors | 
+	    joystick | 
+	    mask | 
+	    sprite | 
+	    transform | 
+	    BufferProxy | 
+	    freetype | 
+	    gfxdraw | 
+	    midi | 
+	    PixelArray | 
+	    pixelcopy | 
+	    sndarray | 
+	    surfarray | 
+	    math
+	  

+
+	  
Other:
+	    camera | 
+	    controller | 
+	    examples | 
+	    fastevent | 
+	    scrap | 
+	    tests | 
+	    touch | 
+	    version
+	  

+

+

+  

+
+      

+          

+            
+

+

+

+pygame.cursors

+

+
pygame module for cursor resources

+

+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
pygame.cursors.compile

+		—create binary cursor data from simple strings
pygame.cursors.load_xbm

+		—load cursor data from an XBM file
pygame.cursors.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.

+
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
+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
    • 
+

+

+

+

+pygame.cursors.compile()

+

+
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.

+
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.load_xbm()

+

+
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
+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.Cursor

+

+
pygame object representing a cursor

+
Cursor(size, hotspot, xormasks, andmasks) -> Cursor

+
Cursor(hotspot, surface) -> Cursor

+
Cursor(constant) -> Cursor

+
Cursor(Cursor) -> Cursor

+
Cursor() -> Cursor

+

+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
pygame.cursors.Cursor.copy

+		—copy the current cursor
pygame.cursors.Cursor.type

+		—Gets the cursor type
pygame.cursors.Cursor.data

+		—Gets the cursor data

+
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
+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.

+

+

+copy()

+

+
copy the current cursor

+
copy() -> Cursor

+

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

+

+
+

+

+type

+

+
Gets the cursor type

+
type -> string

+

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

+

+
+

+

+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 as pg
+
+pg.init()
+screen = pg.display.set_mode([600, 400])
+pg.display.set_caption("Example code for the cursors module")
+
+# create a system cursor
+system = pg.cursors.Cursor(pg.SYSTEM_CURSOR_NO)
+
+# create bitmap cursors
+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 = pg.Surface((40, 40)) # you could also load an image
+surf.fill((120, 50, 50))        # and use that as your surface
+color = pg.cursors.Cursor((20, 20), surf)
+
+cursors = [system, bitmap_1, bitmap_2, color]
+cursor_index = 0
+
+pg.mouse.set_cursor(cursors[cursor_index])
+
+clock = pg.time.Clock()
+going = True
+while going:
+    clock.tick(60)
+    screen.fill((0, 75, 30))
+    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):
+            going = False
+
+        # if the mouse is clicked it will switch to a new cursor
+        if event.type == pg.MOUSEBUTTONDOWN:
+            cursor_index += 1
+            cursor_index %= len(cursors)
+            pg.mouse.set_cursor(cursors[cursor_index])
+
+pg.quit()
+

+

+

+
+

+
+
+


+

+Edit on GitHub
+            

+          

+      

+      

+    

+    
+    
+  
+
\ No newline at end of file
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/ref/display.html b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/ref/display.html
new file mode 100644
index 0000000..111166b
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/ref/display.html
@@ -0,0 +1,1006 @@
+
+
+
+  
+    
+    
+
+    pygame.display — pygame v2.6.1 documentation
+    
+    
+    
+    
+    
+    
+    
+    
+    
+     
+    
+
+    

+
+  

+	

+	
+	

+	  

+	    Pygame Home ||
+	    Help Contents ||
+	    Reference Index
+
+        

+          
+          
+        

+	  

+	  

+	  
Most useful stuff:
+	    Color | 
+	    display | 
+	    draw | 
+	    event | 
+	    font | 
+	    image | 
+	    key | 
+	    locals | 
+	    mixer | 
+	    mouse | 
+	    Rect | 
+	    Surface | 
+	    time | 
+	    music | 
+	    pygame
+	  

+
+	  
Advanced stuff:
+	    cursors | 
+	    joystick | 
+	    mask | 
+	    sprite | 
+	    transform | 
+	    BufferProxy | 
+	    freetype | 
+	    gfxdraw | 
+	    midi | 
+	    PixelArray | 
+	    pixelcopy | 
+	    sndarray | 
+	    surfarray | 
+	    math
+	  

+
+	  
Other:
+	    camera | 
+	    controller | 
+	    examples | 
+	    fastevent | 
+	    scrap | 
+	    tests | 
+	    touch | 
+	    version
+	  

+

+

+  

+
+      

+          

+            
+

+

+

+pygame.display

+

+
pygame module to control the display window and screen

+

+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
pygame.display.init

+		—Initialize the display module
pygame.display.quit

+		—Uninitialize the display module
pygame.display.get_init

+		—Returns True if the display module has been initialized
pygame.display.set_mode

+		—Initialize a window or screen for display
pygame.display.get_surface

+		—Get a reference to the currently set display surface
pygame.display.flip

+		—Update the full display Surface to the screen
pygame.display.update

+		—Update portions of the screen for software displays
pygame.display.get_driver

+		—Get the name of the pygame display backend
pygame.display.Info

+		—Create a video display information object
pygame.display.get_wm_info

+		—Get information about the current windowing system
pygame.display.get_desktop_sizes

+		—Get sizes of active desktops
pygame.display.list_modes

+		—Get list of available fullscreen modes
pygame.display.mode_ok

+		—Pick the best color depth for a display mode
pygame.display.gl_get_attribute

+		—Get the value for an OpenGL flag for the current display
pygame.display.gl_set_attribute

+		—Request an OpenGL display attribute for the display mode
pygame.display.get_active

+		—Returns True when the display is active on the screen
pygame.display.iconify

+		—Iconify the display surface
pygame.display.toggle_fullscreen

+		—Switch between fullscreen and windowed displays
pygame.display.set_gamma

+		—Change the hardware gamma ramps
pygame.display.set_gamma_ramp

+		—Change the hardware gamma ramps with a custom lookup
pygame.display.set_icon

+		—Change the system image for the display window
pygame.display.set_caption

+		—Set the current window caption
pygame.display.get_caption

+		—Get the current window caption
pygame.display.set_palette

+		—Set the display color palette for indexed displays
pygame.display.get_num_displays

+		—Return the number of displays
pygame.display.get_window_size

+		—Return the size of the window or screen
pygame.display.get_allow_screensaver

+		—Return whether the screensaver is allowed to run.
pygame.display.set_allow_screensaver

+		—Set whether the screensaver may run

+
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).

+

+

+pygame.display.init()

+

+
Initialize the display module

+
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.quit()

+

+
Uninitialize the display module

+
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.get_init()

+

+
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.

+

+
+

+

+pygame.display.set_mode()

+

+
Initialize a window or screen for display

+
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
+

+

+

+
New in pygame 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.

+

+
New in pygame 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.

+

+
Changed in pygame 1.9.5: display argument added

+

+

+
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.

+

+

+
+

+

+pygame.display.get_surface()

+

+
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.

+

+
+

+

+pygame.display.flip()

+

+
Update the full display Surface to the screen

+
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.update()

+

+
Update portions of the screen for software displays

+
update(rectangle=None) -> None

+
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.get_driver()

+

+
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.set_mode() to see some of the common options.

+

+
+

+

+pygame.display.Info()

+

+
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
+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.get_wm_info()

+

+
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.

+

+

+
+

+

+pygame.display.get_desktop_sizes()

+

+
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.

+
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.

+

+
New in pygame 2.0.0.

+

+

+
+

+

+pygame.display.list_modes()

+

+
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
+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).

+

+
Changed in pygame 1.9.5: display argument added

+

+

+
+

+

+pygame.display.mode_ok()

+

+
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
+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.

+

+
Changed in pygame 1.9.5: display argument added

+

+

+
+

+

+pygame.display.gl_get_attribute()

+

+
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

+

+
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
+

+

+
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.

+

+
GL_STENCIL_SIZE

+

+
Minimum bit size of the stencil buffer. Defaults to 0.

+

+
GL_DEPTH_SIZE

+

+
Minimum bit size of the depth buffer. Defaults to 16.

+

+
GL_STEREO

+

+
1 enables stereo 3D. Defaults to 0.

+

+
GL_BUFFER_SIZE

+

+
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,
+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
+

+

+
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
+

+

+

+
GL_ACCELERATED_VISUAL

+

+
Set to 1 to require hardware acceleration, or 0 to force software render.
+By default, both are allowed.

+

+

+
+

+

+pygame.display.get_active()

+

+
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
+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.iconify()

+

+
Iconify the display surface

+
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.toggle_fullscreen()

+

+
Switch between fullscreen and windowed displays

+
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

+
toggle_fullscreen() doesn't work on Windows
+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 #2380.

+

+

+
+

+

+pygame.display.set_gamma()

+

+
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
+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 since pygame 2.2.0.

+

+

+
+

+

+pygame.display.set_gamma_ramp()

+

+
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
+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 2.2.0.

+

+

+
+

+

+pygame.display.set_icon()

+

+
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.

+
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_caption()

+

+
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() -> (title, icontitle)

+

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

+

+
+

+

+pygame.display.set_palette()

+

+
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

+
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.

+

+

+
+

+

+pygame.display.get_window_size()

+

+
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.
+This may differ from the size of the display surface if SCALED is used.

+

+
New in pygame 2.0.0.

+

+

+
+

+

+pygame.display.get_allow_screensaver()

+

+
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.

+

+
Note

+
Some platforms do not have a screensaver or support
+disabling the screensaver.  Please see
+pygame.display.set_allow_screensaver()Set whether the screensaver may run for
+caveats with screensaver support.

+

+

+
New in pygame 2.0.0.

+

+

+
+

+

+pygame.display.set_allow_screensaver()

+

+
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.
+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 pygame.quit()uninitialize all pygame modules 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.

+

+

+
New in pygame 2.0.0.

+

+

+
+

+
+

+
+
+


+

+Edit on GitHub
+            

+          

+      

+      

+    

+    
+    
+  
+
\ No newline at end of file
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/ref/draw.html b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/ref/draw.html
new file mode 100644
index 0000000..7f8ddd7
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/ref/draw.html
@@ -0,0 +1,956 @@
+
+
+
+  
+    
+    
+
+    pygame.draw — pygame v2.6.1 documentation
+    
+    
+    
+    
+    
+    
+    
+    
+    
+     
+    
+
+    

+
+  

+	

+	
+	

+	  

+	    Pygame Home ||
+	    Help Contents ||
+	    Reference Index
+
+        

+          
+          
+        

+	  

+	  

+	  
Most useful stuff:
+	    Color | 
+	    display | 
+	    draw | 
+	    event | 
+	    font | 
+	    image | 
+	    key | 
+	    locals | 
+	    mixer | 
+	    mouse | 
+	    Rect | 
+	    Surface | 
+	    time | 
+	    music | 
+	    pygame
+	  

+
+	  
Advanced stuff:
+	    cursors | 
+	    joystick | 
+	    mask | 
+	    sprite | 
+	    transform | 
+	    BufferProxy | 
+	    freetype | 
+	    gfxdraw | 
+	    midi | 
+	    PixelArray | 
+	    pixelcopy | 
+	    sndarray | 
+	    surfarray | 
+	    math
+	  

+
+	  
Other:
+	    camera | 
+	    controller | 
+	    examples | 
+	    fastevent | 
+	    scrap | 
+	    tests | 
+	    touch | 
+	    version
+	  

+

+

+  

+
+      

+          

+            
+

+

+

+pygame.draw

+

+
pygame module for drawing shapes

+

+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
pygame.draw.rect

+		—draw a rectangle
pygame.draw.polygon

+		—draw a polygon
pygame.draw.circle

+		—draw a circle
pygame.draw.ellipse

+		—draw an ellipse
pygame.draw.arc

+		—draw an elliptical arc
pygame.draw.line

+		—draw a straight line
pygame.draw.lines

+		—draw multiple contiguous straight line segments
pygame.draw.aaline

+		—draw a straight antialiased line
pygame.draw.aalines

+		—draw multiple contiguous straight antialiased line segments

+
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 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).

+

+
Note

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

+

+

+

+pygame.draw.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 (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
+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
    
+

    
+
    
+
    
+
    
+
    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
+without rounded corners.
    • 
+
  • border_top_left_radius (int) -- (optional) used for setting the value of top left
+border. If you don't set this value, it will use the border_radius value.
    • 
+
  • border_top_right_radius (int) -- (optional) used for setting the value of top right
+border. If you don't set this value, it will use the border_radius value.
    • 
+
  • border_bottom_left_radius (int) -- (optional) used for setting the value of bottom left
+border. If you don't set this value, it will use the border_radius value.
    • 
+
  • border_bottom_right_radius (int) -- 
    (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

+

+
Return type:

+
Rect

+

+

+

+
Note

+
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.

+

+

+
+

+

+pygame.draw.polygon()

+

+
draw a polygon

+
polygon(surface, color, points) -> Rect

+
polygon(surface, color, points, width=0) -> Rect

+

+
Draws a polygon on the given surface.

+

+
Parameters:

+
    
+
  • surface (Surface) -- surface to draw on
    • 
+
  • 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(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
+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 pygame.draw.line()draw a straight 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

+

+
Return type:

+
Rect

+

+
Raises:

+
    
+
  • ValueError -- if len(points) < 3 (must have at least 3 points)
    • 
+
  • TypeError -- if points is not a sequence or points does not
+contain number pairs
    • 
+

+

+

+

+
Note

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

+

+

+
Changed in pygame 2.0.0: Added support for keyword arguments.

+

+

+
+

+

+pygame.draw.circle()

+

+
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 (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,
+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 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

+

+
Return type:

+
Rect

+

+
Raises:

+
    
+
  • TypeError -- if center is not a sequence of two numbers
    • 
+
  • TypeError -- if radius is not a number
    • 
+

+

+

+

+
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.ellipse()

+

+
draw an ellipse

+
ellipse(surface, color, rect) -> Rect

+
ellipse(surface, color, rect, width=0) -> Rect

+

+
Draws an ellipse on the given surface.

+

+
Parameters:

+
    
+
  • surface (Surface) -- surface to draw on
    • 
+
  • 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
+by it
    • 
+
  • width (int) -- 
    (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

+

+
Return type:

+
Rect

+

+

+

+
Changed in pygame 2.0.0: Added support for keyword arguments.

+

+

+
+

+

+pygame.draw.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.

+
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.

+

+
Parameters:

+
    
+
  • surface (Surface) -- surface to draw on
    • 
+
  • 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
+inside the rectangle
    • 
+
  • start_angle (float) -- start angle of the arc in radians
    • 
+
  • stop_angle (float) -- 
    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
    
+

    
+
    
+
    
+
    • 
+
  • width (int) -- 
    (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

+

+
Return type:

+
Rect

+

+

+

+
Changed in pygame 2.0.0: Added support for keyword arguments.

+

+

+
+

+

+pygame.draw.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
+lines the ends are squared off.

+

+
Parameters:

+
    
+
  • surface (Surface) -- surface to draw on
    • 
+
  • 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, 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

+

+
Return type:

+
Rect

+

+
Raises:

+
TypeError -- if start_pos or end_pos is not a sequence of
+two numbers

+

+

+

+
Changed in pygame 2.0.0: Added support for keyword arguments.

+

+

+
+

+

+pygame.draw.lines()

+

+
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
+no endcaps or miter joints. For thick lines the ends are squared off.
+Drawing thick lines with sharp corners can have undesired looking results.

+

+
Parameters:

+
    
+
  • surface (Surface) -- surface to draw on
    • 
+
  • 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(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
+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)
    • 
+
  • width (int) -- 
    (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 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

+

+
Return type:

+
Rect

+

+
Raises:

+
    
+
  • ValueError -- if len(points) < 2 (must have at least 2 points)
    • 
+
  • TypeError -- if points is not a sequence or points does not
+contain number pairs
    • 
+

+

+

+

+
Changed in pygame 2.0.0: Added support for keyword arguments.

+

+

+
+

+

+pygame.draw.aaline()

+

+
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.

+
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).

+

+

+
Parameters:

+
    
+
  • surface (Surface) -- surface to draw on
    • 
+
  • 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)
    • 
+
  • 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:

+
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

+

+
Return type:

+
Rect

+

+
Raises:

+
TypeError -- if start_pos or end_pos is not a sequence of
+two numbers

+

+

+

+
Changed in pygame 2.0.0: Added support for keyword arguments.

+

+

+
+

+

+pygame.draw.aalines()

+

+
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.

+

+
Parameters:

+
    
+
  • surface (Surface) -- surface to draw on
    • 
+
  • 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(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
+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:

+
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

+

+
Return type:

+
Rect

+

+
Raises:

+
    
+
  • ValueError -- if len(points) < 2 (must have at least 2 points)
    • 
+
  • TypeError -- if points is not a sequence or points does not
+contain number pairs
    • 
+

+

+

+

+
Changed in pygame 2.0.0: Added support for keyword arguments.

+

+

+
+

+draw module example
+

+
Example code for draw module.

+

+

+
import pygame
+from math import pi
+
+# Initialize pygame
+pygame.init()
+
+# Set the height and width of the screen
+size = [400, 300]
+screen = pygame.display.set_mode(size)
+
+pygame.display.set_caption("Example code for the draw module")
+
+# Loop until the user clicks the close button.
+done = False
+clock = pygame.time.Clock()
+
+while not done:
+    # This limits the while loop to a max of 60 times per second.
+    # Leave this out and we will use all CPU we can.
+    clock.tick(60)
+
+    for event in pygame.event.get():  # User did something
+        if event.type == pygame.QUIT:  # If user clicked close
+            done = True  # Flag that we are done so we exit this loop
+
+    # Clear the screen and set the screen background
+    screen.fill("white")
+
+    # Draw on the screen a green line from (0, 0) to (50, 30)
+    # 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 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.
+    pygame.draw.aaline(screen, (60, 179, 113), [0, 50], [50, 80], True)
+
+    # Draw on the screen 3 black lines, each 5 pixels wide.
+    # The 'False' means the first and last points are not connected.
+    pygame.draw.lines(
+        screen, "black", False, [[0, 80], [50, 90], [200, 80], [220, 30]], 5
+    )
+
+    # Draw a rectangle outline
+    pygame.draw.rect(screen, "black", [75, 10, 50, 20], 2)
+
+    # Draw a solid rectangle. Same color as "black" above, specified in a new way
+    pygame.draw.rect(screen, (0, 0, 0), [150, 10, 50, 20])
+
+    # Draw a rectangle with rounded corners
+    pygame.draw.rect(screen, "green", [115, 210, 70, 40], 10, border_radius=15)
+    pygame.draw.rect(
+        screen,
+        "red",
+        [135, 260, 50, 30],
+        0,
+        border_radius=10,
+        border_top_left_radius=0,
+        border_bottom_right_radius=15,
+    )
+
+    # Draw an ellipse outline, using a rectangle as the outside boundaries
+    pygame.draw.ellipse(screen, "red", [225, 10, 50, 20], 2)
+
+    # Draw an solid ellipse, using a rectangle as the outside boundaries
+    pygame.draw.ellipse(screen, "red", [300, 10, 50, 20])
+
+    # This draws a triangle using the polygon command
+    pygame.draw.polygon(screen, "black", [[100, 100], [0, 200], [200, 200]], 5)
+
+    # Draw an arc as part of an ellipse.
+    # Use radians to determine what angle to draw.
+    pygame.draw.arc(screen, "black", [210, 75, 150, 125], 0, pi / 2, 2)
+    pygame.draw.arc(screen, "green", [210, 75, 150, 125], pi / 2, pi, 2)
+    pygame.draw.arc(screen, "blue", [210, 75, 150, 125], pi, 3 * pi / 2, 2)
+    pygame.draw.arc(screen, "red", [210, 75, 150, 125], 3 * pi / 2, 2 * pi, 2)
+
+    # Draw a circle
+    pygame.draw.circle(screen, "blue", [60, 250], 40)
+
+    # 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)
+    pygame.draw.circle(screen, "green", [250, 250], 40, 20, draw_bottom_left=True)
+    pygame.draw.circle(screen, "black", [250, 250], 40, 10, draw_bottom_right=True)
+
+    # Go ahead and update the screen with what we've drawn.
+    # This MUST happen after all the other drawing commands.
+    pygame.display.flip()
+
+# Be IDLE friendly
+pygame.quit()
+

+

+

+
+

+
+
+


+

+Edit on GitHub
+            

+          

+      

+      

+    

+    
+    
+  
+
\ No newline at end of file
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/ref/event.html b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/ref/event.html
new file mode 100644
index 0000000..8cb120f
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/ref/event.html
@@ -0,0 +1,796 @@
+
+
+
+  
+    
+    
+
+    pygame.event — pygame v2.6.1 documentation
+    
+    
+    
+    
+    
+    
+    
+    
+    
+     
+    
+
+    

+
+  

+	

+	
+	

+	  

+	    Pygame Home ||
+	    Help Contents ||
+	    Reference Index
+
+        

+          
+          
+        

+	  

+	  

+	  
Most useful stuff:
+	    Color | 
+	    display | 
+	    draw | 
+	    event | 
+	    font | 
+	    image | 
+	    key | 
+	    locals | 
+	    mixer | 
+	    mouse | 
+	    Rect | 
+	    Surface | 
+	    time | 
+	    music | 
+	    pygame
+	  

+
+	  
Advanced stuff:
+	    cursors | 
+	    joystick | 
+	    mask | 
+	    sprite | 
+	    transform | 
+	    BufferProxy | 
+	    freetype | 
+	    gfxdraw | 
+	    midi | 
+	    PixelArray | 
+	    pixelcopy | 
+	    sndarray | 
+	    surfarray | 
+	    math
+	  

+
+	  
Other:
+	    camera | 
+	    controller | 
+	    examples | 
+	    fastevent | 
+	    scrap | 
+	    tests | 
+	    touch | 
+	    version
+	  

+

+

+  

+
+      

+          

+            
+

+

+

+pygame.event

+

+
pygame module for interacting with events and queues

+

+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
pygame.event.pump

+		—internally process pygame event handlers
pygame.event.get

+		—get events from the queue
pygame.event.poll

+		—get a single event from the queue
pygame.event.wait

+		—wait for a single event from the queue
pygame.event.peek

+		—test if event types are waiting on the queue
pygame.event.clear

+		—remove all events from the queue
pygame.event.event_name

+		—get the string name from an event id
pygame.event.set_blocked

+		—control which events are allowed on the queue
pygame.event.set_allowed

+		—control which events are allowed on the queue
pygame.event.get_blocked

+		—test if a type of event is blocked from the queue
pygame.event.set_grab

+		—control the sharing of input devices with other applications
pygame.event.get_grab

+		—test if the program is sharing input devices
pygame.event.set_keyboard_grab

+		—grab enables capture of system keyboard shortcuts like Alt+Tab or the Meta/Super key.
pygame.event.get_keyboard_grab

+		—get the current keyboard grab state
pygame.event.post

+		—place a new event on the queue
pygame.event.custom_type

+		—make custom user event type
pygame.event.Event

+		—pygame object for representing events

+
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 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(), 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.. 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 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. 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 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. 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 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.

+

+


+

+
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.

+

+


+

+
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
+WINDOWRESIZED          Window got resized
+WINDOWSIZECHANGED      Window changed its size
+WINDOWMINIMIZED        Window was minimized
+WINDOWMAXIMIZED        Window was maximized
+WINDOWRESTORED         Window was restored
+WINDOWENTER            Mouse entered the window
+WINDOWLEAVE            Mouse left the window
+WINDOWFOCUSGAINED      Window gained focus
+WINDOWFOCUSLOST        Window lost focus
+WINDOWCLOSE            Window was closed
+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
+
+APP_TERMINATING           OS is terminating the application
+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
+

+

+

+
New in pygame 2.1.3.

+

+

+


+

+

+

+pygame.event.pump()

+

+
internally process pygame event handlers

+
pump() -> None

+

+
For each frame of your game, you will need to make some sort of call to the
+event queue. This ensures your program can internally interact with the rest
+of the operating system. If you are not using other event functions in your
+game, you should call pygame.event.pump() to allow pygame to handle
+internal actions.

+
This function is not necessary if your program is consistently processing
+events on the queue through the other pygame.eventpygame module for interacting with events and queues functions.

+
There are important things that must be dealt with internally in the event
+queue. The main window may need to be repainted or respond to the system. If
+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.

+

+

+
+

+

+pygame.event.get()

+

+
get events from the queue

+
get(eventtype=None) -> Eventlist

+
get(eventtype=None, pump=True) -> Eventlist

+
get(eventtype=None, pump=True, exclude=None) -> Eventlist

+

+
This will get all the messages and remove them from the queue. If a type or
+sequence of types is given only those messages will be removed from the
+queue and returned.

+
If a type or sequence of types is passed in the exclude argument
+instead, then all only other messages will be removed from the queue. If
+an exclude parameter is passed, the eventtype parameter must be
+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

+

+

+
+

+

+pygame.event.poll()

+

+
get a single event from the queue

+
poll() -> Event instance

+

+
Returns a single event from the queue. If the event queue is empty an event
+of type pygame.NOEVENT will be returned immediately. The returned event
+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.

+

+

+
+

+

+pygame.event.wait()

+

+
wait for a single event from the queue

+
wait() -> Event instance

+
wait(timeout) -> Event instance

+

+
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
+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.

+

+
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.

+

+

+
+

+

+pygame.event.peek()

+

+
test if event types are waiting on the queue

+
peek(eventtype=None) -> bool

+
peek(eventtype=None, pump=True) -> bool

+

+
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.

+
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

+

+

+
+

+

+pygame.event.clear()

+

+
remove all events from the queue

+
clear(eventtype=None) -> None

+
clear(eventtype=None, pump=True) -> None

+

+
Removes all events from the queue. If eventtype is given, removes the given event
+or sequence of events. This has the same effect as 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

+

+

+
+

+

+pygame.event.event_name()

+

+
get the string name from an event id

+
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 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
+default all events can be placed on the queue. It is safe to disable an
+event type multiple times.

+
If None is passed as the argument, ALL of the event types are blocked
+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(None) -> None

+

+
The given event types are allowed to appear on the event queue. By default,
+all event types can be placed on the queue. It is safe to enable an event
+type multiple times.

+
If None is passed as the argument, ALL of the event types are allowed
+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

+

+
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
+event types are blocked.

+

+
+

+

+pygame.event.set_grab()

+

+
control the sharing of input devices with other applications

+
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
+program sets the event grab to True, it will lock all input into your
+program.

+
It is best to not always grab the input, since it prevents the user from
+doing other things on their system.

+

+
+

+

+pygame.event.get_grab()

+

+
test if the program is sharing input devices

+
get_grab() -> bool

+

+
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

+

+
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.

+
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

+

+

+
+

+

+pygame.event.custom_type()

+

+
make custom user event type

+
custom_type() -> int

+

+
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.

+

+

+
+

+

+pygame.event.Event

+

+
pygame object for representing events

+
Event(type, dict) -> Event

+
Event(type, **attributes) -> Event

+

+
+
+
+
+
+
+
+
+
+
+
+
pygame.event.Event.type

+		—event type identifier.
pygame.event.Event.__dict__

+		—event attribute dictionary

+
A pygame object used for representing an event. Event instances
+support attribute assignment and deletion.

+
When creating the object, the attributes may come from a dictionary
+argument with string keys or from keyword arguments.

+

+
Note

+
From version 2.1.3 EventType is an alias for Event. Beforehand,
+Event was a function that returned EventType instances. Use of
+Event is preferred over EventType wherever it is possible, as
+the latter could be deprecated in a future version.

+

+

+

+type

+

+
event type identifier.

+
type -> int

+

+
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.

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

+

+
+

+

+__dict__

+

+
event attribute dictionary

+
__dict__ -> dict

+

+
Read-only. The event type specific attributes of an event. The
+dict attribute is a synonym for backward compatibility.

+
For example, the attributes of a KEYDOWN event would be unicode,
+key, and mod

+

+
+

+
New in pygame 1.9.2: Mutable attributes.

+

+

+
+

+
+

+
+
+


+

+Edit on GitHub
+            

+          

+      

+      

+    

+    
+    
+  
+
\ No newline at end of file
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/ref/examples.html b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/ref/examples.html
new file mode 100644
index 0000000..6e2061c
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/ref/examples.html
@@ -0,0 +1,703 @@
+
+
+
+  
+    
+    
+
+    pygame.examples — pygame v2.6.1 documentation
+    
+    
+    
+    
+    
+    
+    
+    
+    
+     
+    
+
+    

+
+  

+	

+	
+	

+	  

+	    Pygame Home ||
+	    Help Contents ||
+	    Reference Index
+
+        

+          
+          
+        

+	  

+	  

+	  
Most useful stuff:
+	    Color | 
+	    display | 
+	    draw | 
+	    event | 
+	    font | 
+	    image | 
+	    key | 
+	    locals | 
+	    mixer | 
+	    mouse | 
+	    Rect | 
+	    Surface | 
+	    time | 
+	    music | 
+	    pygame
+	  

+
+	  
Advanced stuff:
+	    cursors | 
+	    joystick | 
+	    mask | 
+	    sprite | 
+	    transform | 
+	    BufferProxy | 
+	    freetype | 
+	    gfxdraw | 
+	    midi | 
+	    PixelArray | 
+	    pixelcopy | 
+	    sndarray | 
+	    surfarray | 
+	    math
+	  

+
+	  
Other:
+	    camera | 
+	    controller | 
+	    examples | 
+	    fastevent | 
+	    scrap | 
+	    tests | 
+	    touch | 
+	    version
+	  

+

+

+  

+
+      

+          

+            
+

+

+

+pygame.examples

+

+
module of example programs

+

+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
pygame.examples.aliens.main

+		—play the full aliens example
pygame.examples.stars.main

+		—run a simple starfield example
pygame.examples.chimp.main

+		—hit the moving chimp
pygame.examples.moveit.main

+		—display animated objects on the screen
pygame.examples.fonty.main

+		—run a font rendering example
pygame.examples.freetype_misc.main

+		—run a FreeType rendering example
pygame.examples.vgrade.main

+		—display a vertical gradient
pygame.examples.eventlist.main

+		—display pygame events
pygame.examples.arraydemo.main

+		—show various surfarray effects
pygame.examples.sound.main

+		—load and play a sound
pygame.examples.sound_array_demos.main

+		—play various sndarray effects
pygame.examples.liquid.main

+		—display an animated liquid effect
pygame.examples.glcube.main

+		—display an animated 3D cube using OpenGL
pygame.examples.scrap_clipboard.main

+		—access the clipboard
pygame.examples.mask.main

+		—display multiple images bounce off each other using collision detection
pygame.examples.testsprite.main

+		—show lots of sprites moving around
pygame.examples.headless_no_windows_needed.main

+		—write an image file that is smoothscaled copy of an input file
pygame.examples.joystick.main

+		—demonstrate joystick functionality
pygame.examples.blend_fill.main

+		—demonstrate the various surface.fill method blend options
pygame.examples.blit_blends.main

+		—uses alternative additive fill to that of surface.fill
pygame.examples.cursors.main

+		—display two different custom cursors
pygame.examples.pixelarray.main

+		—display various pixelarray generated effects
pygame.examples.scaletest.main

+		—interactively scale an image using smoothscale
pygame.examples.midi.main

+		—run a midi example
pygame.examples.scroll.main

+		—run a Surface.scroll example that shows a magnified image
pygame.examples.camera.main

+		—display video captured live from an attached camera
pygame.examples.playmus.main

+		—play an audio file

+
These examples should help get you started with pygame. Here is a brief rundown
+of what you get. The source code for these examples is in the public domain.
+Feel free to use for your own projects.

+
There are several ways to run the examples. First they can be run as
+stand-alone programs. Second they can be imported and their main() methods
+called (see below). Finally, the easiest way is to use the python -m option:

+
python -m pygame.examples.<example name> <example arguments>
+

+

+
eg:

+
python -m pygame.examples.scaletest someimage.png
+

+

+
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
+commands inside the python interpreter.

+
>>> import pygame.examples.scaletest
+>>> pygame.examples.scaletest.__file__
+'/usr/lib/python2.6/site-packages/pygame/examples/scaletest.py'
+

+

+
On each OS and version of Python the location will be slightly different.
+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
+>>> pygame.examples.scaletest.main()
+

+

+
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.

+
examples as a package is new to pygame 1.9.0. But most of the examples came with
+pygame much earlier.

+

+

+aliens.main()

+

+
play the full aliens example

+
aliens.main() -> None

+

+
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)

+

+
+

+

+stars.main()

+

+
run a simple starfield example

+
stars.main() -> None

+

+
A simple starfield example. You can change the center of perspective by
+leftclicking the mouse on the screen.

+

+
+

+

+chimp.main()

+

+
hit the moving chimp

+
chimp.main() -> None

+

+
This simple example is derived from 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.

+

+
+

+

+moveit.main()

+

+
display animated objects on the screen

+
moveit.main() -> None

+

+
This is the full and final example from the Pygame Tutorial, "How Do I Make
+It Move". It creates 10 objects and animates them on the screen.

+
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.

+

+
+

+

+fonty.main()

+

+
run a font rendering example

+
fonty.main() -> None

+

+
Super quick, super simple application demonstrating the different ways to
+render fonts with the font module

+

+
+

+

+freetype_misc.main()

+

+
run a FreeType rendering example

+
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.
+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.

+

+
+

+

+vgrade.main()

+

+
display a vertical gradient

+
vgrade.main() -> None

+

+
Demonstrates creating a vertical gradient with pixelcopy and NumPy python.
+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 :]

+

+
+

+

+eventlist.main()

+

+
display pygame events

+
eventlist.main() -> None

+

+
Eventlist is a sloppy style of pygame, but is a handy tool for learning
+about pygame events and input. At the top of the screen are the state of
+several device values, and a scrolling list of events are displayed on the
+bottom.

+
This is not quality 'ui' code at all, but you can see how to implement very
+non-interactive status displays, or even a crude text output control.

+

+
+

+

+arraydemo.main()

+

+
show various surfarray effects

+
arraydemo.main(arraytype=None) -> None

+

+
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

+
The arraytype parameter is deprecated; passing any value besides 'numpy'
+will raise ValueError.

+

+
+

+

+sound.main()

+

+
load and play a sound

+
sound.main(file_path=None) -> None

+

+
Extremely basic testing of the mixer module. Load a sound and play it. All
+from the command shell, no graphics.

+
If provided, use the audio file 'file_path', otherwise use a default file.

+
sound.py optional command line argument: an audio file

+

+
+

+

+sound_array_demos.main()

+

+
play various sndarray effects

+
sound_array_demos.main(arraytype=None) -> None

+

+
Uses sndarray and NumPy to create offset faded copies of the
+original sound. Currently it just uses hardcoded values for the number of
+echoes and the delay. Easy for you to recreate as needed.

+
The arraytype parameter is deprecated; passing any value besides 'numpy'
+will raise ValueError.

+

+
+

+

+liquid.main()

+

+
display an animated liquid effect

+
liquid.main() -> None

+

+
This example was created in a quick comparison with the BlitzBasic gaming
+language. Nonetheless, it demonstrates a quick 8-bit setup (with colormap).

+

+
+

+

+glcube.main()

+

+
display an animated 3D cube using OpenGL

+
glcube.main() -> None

+

+
Using PyOpenGL and pygame, this creates a spinning 3D multicolored cube.

+

+
+

+

+scrap_clipboard.main()

+

+
access the clipboard

+
scrap_clipboard.main() -> None

+

+
A simple demonstration example for the clipboard support.

+

+
+

+

+mask.main()

+

+
display multiple images bounce off each other using collision detection

+
mask.main(*args) -> None

+

+
Positional arguments:

+
one or more image file names.
+

+

+
This pygame.masks demo will display multiple moving sprites bouncing off
+each other. More than one sprite image can be provided.

+
If run as a program then mask.py takes one or more image files as
+command line arguments.

+

+
+

+

+testsprite.main()

+

+
show lots of sprites moving around

+
testsprite.main(update_rects = True, use_static = False, use_FastRenderGroup = False, screen_dims = [640, 480], use_alpha = False, flags = 0) -> None

+

+
Optional keyword arguments:

+
update_rects - use the RenderUpdate sprite group class
+use_static - include non-moving images
+use_FastRenderGroup - Use the FastRenderGroup sprite group
+screen_dims - pygame window dimensions
+use_alpha - use alpha blending
+flags - additional display mode flags
+

+

+
Like the testsprite.c that comes with SDL, this pygame version shows
+lots of sprites moving around.

+
If run as a stand-alone program then no command line arguments are taken.

+

+
+

+

+headless_no_windows_needed.main()

+

+
write an image file that is smoothscaled copy of an input file

+
headless_no_windows_needed.main(fin, fout, w, h) -> None

+

+
arguments:

+
fin - name of an input image file
+fout - name of the output file to create/overwrite
+w, h - size of the rescaled image, as integer width and height
+

+

+
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.

+
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
+eg. -scale in.png outpng 50 50
+

+

+

+
+

+

+joystick.main()

+

+
demonstrate joystick functionality

+
joystick.main() -> None

+

+
A demo showing full joystick support.

+

+
New in pygame 2.0.2.

+

+

+
+

+

+blend_fill.main()

+

+
demonstrate the various surface.fill method blend options

+
blend_fill.main() -> None

+

+
A interactive demo that lets one choose which BLEND_xxx option to apply to a
+surface.

+

+
+

+

+blit_blends.main()

+

+
uses alternative additive fill to that of surface.fill

+
blit_blends.main() -> None

+

+
Fake additive blending. Using NumPy. it doesn't clamp. Press r,g,b Somewhat
+like blend_fill.

+

+
+

+

+cursors.main()

+

+
display two different custom cursors

+
cursors.main() -> None

+

+
Display an arrow or circle with crossbar cursor.

+

+
+

+

+pixelarray.main()

+

+
display various pixelarray generated effects

+
pixelarray.main() -> None

+

+
Display various pixelarray generated effects.

+

+
+

+

+scaletest.main()

+

+
interactively scale an image using smoothscale

+
scaletest.main(imagefile, convert_alpha=False, run_speed_test=True) -> None

+

+
arguments:

+
imagefile - file name of source image (required)
+convert_alpha - use convert_alpha() on the surf (default False)
+run_speed_test - (default False)
+

+

+
A smoothscale example that resized an image on the screen. Vertical and
+horizontal arrow keys are used to change the width and height of the
+displayed image. If the convert_alpha option is True then the source image
+is forced to have source alpha, whether or not the original images does. If
+run_speed_test is True then a background timing test is performed instead of
+the interactive scaler.

+
If scaletest.py is run as a program then the command line options are:

+
ImageFile [-t] [-convert_alpha]
+[-t] = Run Speed Test
+[-convert_alpha] = Use convert_alpha() on the surf.
+

+

+

+
+

+

+midi.main()

+

+
run a midi example

+
midi.main(mode='output', device_id=None) -> None

+

+
Arguments:

+
mode - if 'output' run a midi keyboard output example
+          'input' run a midi event logger input example
+          'list' list available midi devices
+       (default 'output')
+device_id - midi device number; if None then use the default midi input or
+            output device for the system
+

+

+
The output example shows how to translate mouse clicks or computer keyboard
+events into midi notes. It implements a rudimentary button widget and state
+machine.

+
The input example shows how to translate midi input to pygame events.

+
With the use of a virtual midi patch cord the output and input examples can
+be run as separate processes and connected so the keyboard output is
+displayed on a console.

+
new to pygame 1.9.0

+

+
+

+

+scroll.main()

+

+
run a Surface.scroll example that shows a magnified image

+
scroll.main(image_file=None) -> None

+

+
This example shows a scrollable image that has a zoom factor of eight. It
+uses the Surface.scroll()
+function to shift the image on the display surface.
+A clip rectangle protects a margin area. If called as a function,
+the example accepts an optional image file path. If run as a program it
+takes an optional file path command line argument. If no file is provided a
+default image file is used.

+
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.

+

+
+

+

+camera.main()

+

+
display video captured live from an attached camera

+
camera.main() -> None

+

+
A simple live video player, it uses the first available camera it finds on
+the system.

+

+
+

+

+playmus.main()

+

+
play an audio file

+
playmus.main(file_path) -> None

+

+
A simple music player with window and keyboard playback control. Playback can
+be paused and rewound to the beginning.

+

+
+

+
+

+
+
+


+

+Edit on GitHub
+            

+          

+      

+      

+    

+    
+    
+  
+
\ No newline at end of file
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/ref/fastevent.html b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/ref/fastevent.html
new file mode 100644
index 0000000..82013c3
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/ref/fastevent.html
@@ -0,0 +1,277 @@
+
+
+
+  
+    
+    
+
+    pygame.fastevent — pygame v2.6.1 documentation
+    
+    
+    
+    
+    
+    
+    
+    
+    
+     
+    
+
+    

+
+  

+	

+	
+	

+	  

+	    Pygame Home ||
+	    Help Contents ||
+	    Reference Index
+
+        

+          
+          
+        

+	  

+	  

+	  
Most useful stuff:
+	    Color | 
+	    display | 
+	    draw | 
+	    event | 
+	    font | 
+	    image | 
+	    key | 
+	    locals | 
+	    mixer | 
+	    mouse | 
+	    Rect | 
+	    Surface | 
+	    time | 
+	    music | 
+	    pygame
+	  

+
+	  
Advanced stuff:
+	    cursors | 
+	    joystick | 
+	    mask | 
+	    sprite | 
+	    transform | 
+	    BufferProxy | 
+	    freetype | 
+	    gfxdraw | 
+	    midi | 
+	    PixelArray | 
+	    pixelcopy | 
+	    sndarray | 
+	    surfarray | 
+	    math
+	  

+
+	  
Other:
+	    camera | 
+	    controller | 
+	    examples | 
+	    fastevent | 
+	    scrap | 
+	    tests | 
+	    touch | 
+	    version
+	  

+

+

+  

+
+      

+          

+            
+

+

+

+pygame.fastevent

+

+
pygame module for interacting with events and queues

+

+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
pygame.fastevent.init

+		—initialize pygame.fastevent
pygame.fastevent.get_init

+		—returns True if the fastevent module is currently initialized
pygame.fastevent.pump

+		—internally process pygame event handlers
pygame.fastevent.wait

+		—wait for an event
pygame.fastevent.poll

+		—get an available event
pygame.fastevent.get

+		—get all events from the queue
pygame.fastevent.post

+		—place an event on the queue

+
IMPORTANT NOTE: THIS MODULE IS DEPRECATED IN PYGAME 2.2

+
In older pygame versions before pygame 2, pygame.eventpygame module for interacting with events and queues was not well
+suited for posting events from different threads. This module served as a
+replacement (with less features) for multithreaded use. Now, the usage of this
+module is highly discouraged in favour of use of the main pygame.eventpygame module for interacting with events and queues
+module. This module will be removed in a future pygame version.

+
Below, the legacy docs of the module is provided

+

+

+pygame.fastevent.init()

+

+
initialize pygame.fastevent

+
init() -> None

+

+
Initialize the pygame.fastevent module.

+

+
+

+

+pygame.fastevent.get_init()

+

+
returns True if the fastevent module is currently initialized

+
get_init() -> bool

+

+
Returns True if the pygame.fastevent module is currently initialized.

+

+
+

+

+pygame.fastevent.pump()

+

+
internally process pygame event handlers

+
pump() -> None

+

+
For each frame of your game, you will need to make some sort of call to the
+event queue. This ensures your program can internally interact with the rest
+of the operating system.

+
This function is not necessary if your program is consistently processing
+events on the queue through the other pygame.fasteventpygame module for interacting with events and queues functions.

+
There are important things that must be dealt with internally in the event
+queue. The main window may need to be repainted or respond to the system. If
+you fail to make a call to the event queue for too long, the system may
+decide your program has locked up.

+

+
+

+

+pygame.fastevent.wait()

+

+
wait for an event

+
wait() -> Event

+

+
Returns the current event on the queue. If there are no messages
+waiting on the queue, this will not return until one is available.
+Sometimes it is important to use this wait to get events from the queue,
+it will allow your application to idle when the user isn't doing anything
+with it.

+

+
+

+

+pygame.fastevent.poll()

+

+
get an available event

+
poll() -> Event

+

+
Returns next event on queue. If there is no event waiting on the queue,
+this will return an event with type NOEVENT.

+

+
+

+

+pygame.fastevent.get()

+

+
get all events from the queue

+
get() -> list of Events

+

+
This will get all the messages and remove them from the queue.

+

+
+

+

+pygame.fastevent.post()

+

+
place an event on the queue

+
post(Event) -> None

+

+
This will post your own event objects onto the event queue. You can post
+any event type you want, but some care must be taken. For example, if you
+post a MOUSEBUTTONDOWN event to the queue, it is likely any code receiving
+the event will expect the standard MOUSEBUTTONDOWN attributes to be
+available, like 'pos' and 'button'.

+
Because pygame.fastevent.post() may have to wait for the queue to empty,
+you can get into a dead lock if you try to append an event on to a full
+queue from the thread that processes events. For that reason I do not
+recommend using this function in the main thread of an SDL program.

+

+
+

+
+

+
+
+


+

+Edit on GitHub
+            

+          

+      

+      

+    

+    
+    
+  
+
\ No newline at end of file
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/ref/font.html b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/ref/font.html
new file mode 100644
index 0000000..e1d99c9
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/ref/font.html
@@ -0,0 +1,817 @@
+
+
+
+  
+    
+    
+
+    pygame.font — pygame v2.6.1 documentation
+    
+    
+    
+    
+    
+    
+    
+    
+    
+     
+    
+
+    

+
+  

+	

+	
+	

+	  

+	    Pygame Home ||
+	    Help Contents ||
+	    Reference Index
+
+        

+          
+          
+        

+	  

+	  

+	  
Most useful stuff:
+	    Color | 
+	    display | 
+	    draw | 
+	    event | 
+	    font | 
+	    image | 
+	    key | 
+	    locals | 
+	    mixer | 
+	    mouse | 
+	    Rect | 
+	    Surface | 
+	    time | 
+	    music | 
+	    pygame
+	  

+
+	  
Advanced stuff:
+	    cursors | 
+	    joystick | 
+	    mask | 
+	    sprite | 
+	    transform | 
+	    BufferProxy | 
+	    freetype | 
+	    gfxdraw | 
+	    midi | 
+	    PixelArray | 
+	    pixelcopy | 
+	    sndarray | 
+	    surfarray | 
+	    math
+	  

+
+	  
Other:
+	    camera | 
+	    controller | 
+	    examples | 
+	    fastevent | 
+	    scrap | 
+	    tests | 
+	    touch | 
+	    version
+	  

+

+

+  

+
+      

+          

+            
+

+

+

+pygame.font

+

+
pygame module for loading and rendering fonts

+

+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
pygame.font.init

+		—initialize the font module
pygame.font.quit

+		—uninitialize the font module
pygame.font.get_init

+		—true if the font module is initialized
pygame.font.get_default_font

+		—get the filename of the default font
pygame.font.get_sdl_ttf_version

+		—gets SDL_ttf version
pygame.font.get_fonts

+		—get all available fonts
pygame.font.match_font

+		—find a specific font on the system
pygame.font.SysFont

+		—create a Font object from the system fonts
pygame.font.Font

+		—create a new Font object from a file

+
The font module allows for rendering TrueType fonts into Surface objects.
+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
+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.

+
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
+(like emojis, if the font has them) ('\U00000001' to '\U0010FFFF')).
+More about this in Font.render().

+
Before pygame 2.0.3, this character space restriction can be avoided by
+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.

+

+

+pygame.font.init()

+

+
initialize the font module

+
init() -> None

+

+
This method is called automatically by pygame.init(). It initializes the
+font module. The module must be initialized before any other functions will
+work.

+
It is safe to call this function more than once.

+

+
+

+

+pygame.font.quit()

+

+
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.

+

+
+

+

+pygame.font.get_init()

+

+
true if the font module is initialized

+
get_init() -> bool

+

+
Test if the font module is initialized or not.

+

+
+

+

+pygame.font.get_default_font()

+

+
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
+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) -> (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

+

+
New in pygame 2.1.3.

+

+

+
+

+

+pygame.font.get_fonts()

+

+
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 2.1.3: Checks through user fonts instead of just global fonts for Windows.

+

+

+
+

+

+pygame.font.match_font()

+

+
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.

+
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.

+

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

+

+

+
Changed in pygame 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.SysFont()

+

+
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
+match the requested bold and italic flags. 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 a suitable system font is not found 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.

+

+

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

+

+

+
+

+

+pygame.font.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

+

+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
pygame.font.Font.bold

+		—Gets or sets whether the font should be rendered in (faked) bold.
pygame.font.Font.italic

+		—Gets or sets whether the font should be rendered in (faked) italics.
pygame.font.Font.underline

+		—Gets or sets whether the font should be rendered with an underline.
pygame.font.Font.strikethrough

+		—Gets or sets whether the font should be rendered with a strikethrough.
pygame.font.Font.render

+		—draw text on a new Surface
pygame.font.Font.size

+		—determine the amount of space needed to render text
pygame.font.Font.set_underline

+		—control if text is rendered with an underline
pygame.font.Font.get_underline

+		—check if text will be rendered with an underline
pygame.font.Font.set_strikethrough

+		—control if text is rendered with a strikethrough
pygame.font.Font.get_strikethrough

+		—check if text will be rendered with a strikethrough
pygame.font.Font.set_bold

+		—enable fake rendering of bold text
pygame.font.Font.get_bold

+		—check if text will be rendered bold
pygame.font.Font.set_italic

+		—enable fake rendering of italic text
pygame.font.Font.metrics

+		—gets the metrics for each character in the passed string
pygame.font.Font.get_italic

+		—check if the text will be rendered italic
pygame.font.Font.get_linesize

+		—get the line space of the font text
pygame.font.Font.get_height

+		—get the height of the font
pygame.font.Font.get_ascent

+		—get the ascent of the font
pygame.font.Font.get_descent

+		—get the descent of the font
pygame.font.Font.set_script

+		—set the script code for text shaping

+
Load a new font from a given filename or a python file object. The size is
+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. 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.

+

+

+bold

+

+
Gets or sets whether the font should be rendered in (faked) bold.

+
bold -> bool

+

+
Whether the font should be rendered in bold.

+
When set to True, this 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.

+

+
New in pygame 2.0.0.

+

+

+
+

+

+italic

+

+
Gets or sets whether the font should be rendered in (faked) italics.

+
italic -> bool

+

+
Whether the font should be rendered in italic.

+
When set to True, this 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.

+

+
New in pygame 2.0.0.

+

+

+
+

+

+underline

+

+
Gets or sets whether the font should be rendered with an underline.

+
underline -> bool

+

+
Whether the font should be rendered in underline.

+
When set to True, 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.

+

+
New in pygame 2.0.0.

+

+

+
+

+

+strikethrough

+

+
Gets or sets whether the font should be rendered with a strikethrough.

+
strikethrough -> bool

+

+
Whether the font should be rendered with a strikethrough.

+
When set to True, all rendered fonts will include an
+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 2.1.3.

+

+

+
+

+

+render()

+

+
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.

+
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 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
+the height of the font.

+
Depending on the type of background and antialiasing used, this returns
+different types of Surfaces. For performance reasons, it is good to know
+what type of image will be used. If antialiasing is not used, the return
+image will always be an 8-bit image with a two-color palette. If the
+background is transparent a colorkey will be set. Antialiased images are
+rendered to 24-bit RGB images. If the background is transparent a
+pixel alpha will be included.

+
Optimization: if you know that the final destination for the text (on the
+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.

+

+

+
+

+

+size()

+

+
determine the amount of space needed to render text

+
size(text) -> (width, height)

+

+
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".

+

+
+

+

+set_underline()

+

+
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
+with the bold, italic and strikethrough modes.

+

+
Note

+
This is the same as the underline attribute.

+

+

+
+

+

+get_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(bool) -> None

+

+
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 strikethrough attribute.

+

+

+
New in pygame 2.1.3.

+

+

+
+

+

+get_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 2.1.3.

+

+

+

+
+

+

+set_bold()

+

+
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
+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 bold attribute.

+

+

+
+

+

+get_bold()

+

+
check if text will be rendered bold

+
get_bold() -> bool

+

+
Return True when the font bold rendering mode is enabled.

+

+
Note

+
This is the same as the bold attribute.

+

+

+
+

+

+set_italic()

+

+
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
+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 italic attribute.

+

+

+
+

+

+metrics()

+

+
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
+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.

+

+
+

+

+get_italic()

+

+
check if the text will be rendered italic

+
get_italic() -> bool

+

+
Return True when the font italic rendering mode is enabled.

+

+
Note

+
This is the same as the italic attribute.

+

+

+
+

+

+get_linesize()

+

+
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.

+

+
+

+

+get_height()

+

+
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.

+

+
+

+

+get_ascent()

+

+
get the ascent of the font

+
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.

+

+
+

+

+get_descent()

+

+
get the descent of the font

+
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.

+

+
+

+

+set_script()

+

+
set the script code for text shaping

+
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.

+

+
New in pygame 2.2.0.

+

+

+
+

+
+

+
+

+
+
+


+

+Edit on GitHub
+            

+          

+      

+      

+    

+    
+    
+  
+
\ No newline at end of file
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/ref/freetype.html b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/ref/freetype.html
new file mode 100644
index 0000000..029cfcd
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/ref/freetype.html
@@ -0,0 +1,1261 @@
+
+
+
+  
+    
+    
+
+    pygame.freetype — pygame v2.6.1 documentation
+    
+    
+    
+    
+    
+    
+    
+    
+    
+     
+    
+
+    

+
+  

+	

+	
+	

+	  

+	    Pygame Home ||
+	    Help Contents ||
+	    Reference Index
+
+        

+          
+          
+        

+	  

+	  

+	  
Most useful stuff:
+	    Color | 
+	    display | 
+	    draw | 
+	    event | 
+	    font | 
+	    image | 
+	    key | 
+	    locals | 
+	    mixer | 
+	    mouse | 
+	    Rect | 
+	    Surface | 
+	    time | 
+	    music | 
+	    pygame
+	  

+
+	  
Advanced stuff:
+	    cursors | 
+	    joystick | 
+	    mask | 
+	    sprite | 
+	    transform | 
+	    BufferProxy | 
+	    freetype | 
+	    gfxdraw | 
+	    midi | 
+	    PixelArray | 
+	    pixelcopy | 
+	    sndarray | 
+	    surfarray | 
+	    math
+	  

+
+	  
Other:
+	    camera | 
+	    controller | 
+	    examples | 
+	    fastevent | 
+	    scrap | 
+	    tests | 
+	    touch | 
+	    version
+	  

+

+

+  

+
+      

+          

+            
+

+

+

+pygame.freetype

+

+
Enhanced pygame module for loading and rendering computer fonts

+

+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
pygame.freetype.get_error

+		—Return the latest FreeType error
pygame.freetype.get_version

+		—Return the FreeType version
pygame.freetype.init

+		—Initialize the underlying FreeType library.
pygame.freetype.quit

+		—Shut down the underlying FreeType library.
pygame.freetype.get_init

+		—Returns True if the FreeType module is currently initialized.
pygame.freetype.was_init

+		—DEPRECATED: Use get_init() instead.
pygame.freetype.get_cache_size

+		—Return the glyph case size
pygame.freetype.get_default_resolution

+		—Return the default pixel size in dots per inch
pygame.freetype.set_default_resolution

+		—Set the default pixel size in dots per inch for the module
pygame.freetype.SysFont

+		—create a Font object from the system fonts
pygame.freetype.get_default_font

+		—Get the filename of the default font
pygame.freetype.Font

+		—Create a new Font instance from a supported font file.

+
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.
+All glyphs having UTF-32 code points are accessible
+(see Font.ucs4).

+
Most work on fonts is done using Font instances.
+The module itself only has routines for initialization and creation
+of Font objects.
+You can load fonts from the system using the SysFont() function.

+
Extra support of bitmap fonts is available. Available bitmap sizes can
+be listed (see Font.get_sizes()). For bitmap only fonts Font
+can set the size for you (see the Font.size property).

+
For now undefined character codes are replaced with the .notdef
+(not defined) character.
+How undefined codes are handled may become configurable in a future release.

+
Pygame comes with a built-in default font. This can always be accessed by
+passing None as the font name to the Font constructor.

+
Extra rendering features available to pygame.freetype.FontCreate a new Font instance from a supported font file.
+are direct to surface rendering (see Font.render_to()), character kerning
+(see Font.kerning), vertical layout (see Font.vertical),
+rotation of rendered text (see Font.rotation),
+and the strong style (see Font.strong).
+Some properties are configurable, such as
+strong style strength (see Font.strength) and underline positioning
+(see Font.underline_adjustment). Text can be positioned by the upper
+right corner of the text box or by the text baseline (see Font.origin).
+Finally, a font's vertical and horizontal size can be adjusted separately
+(see Font.size).
+The pygame.examples.freetype_misc
+example shows these features in use.

+
The pygame package does not import freetype automatically when
+loaded. This module must be imported explicitly to be used.

+
import pygame
+import pygame.freetype
+

+

+

+
New in pygame 1.9.2: freetype

+

+

+

+pygame.freetype.get_error()

+

+
Return the latest FreeType error

+
get_error() -> str

+
get_error() -> None

+

+
Return a description of the last error which occurred in the FreeType2
+library, or None if no errors have occurred.

+

+
+

+

+pygame.freetype.get_version()

+

+
Return the FreeType version

+
get_version(linked=True) -> (int, int, int)

+

+
Returns the version of the FreeType library in use by this module. linked=True
+is the default behavior and returns the linked version of FreeType and linked=False
+returns the compiled version of FreeType.

+
Note that the freetype module depends on the FreeType 2 library.
+It will not compile with the original FreeType 1.0. Hence, the first element
+of the tuple will always be "2".

+

+
Changed in pygame 2.2.0: linked keyword argument added and default behavior changed from returning compiled version to returning linked version

+

+

+
+

+

+pygame.freetype.init()

+

+
Initialize the underlying FreeType library.

+
init(cache_size=64, resolution=72) -> None

+

+
This function initializes the underlying FreeType library and must be
+called before trying to use any of the functionality of the freetype
+module.

+
However, pygame.init()initialize all imported pygame modules will automatically call this function
+if the freetype module is already imported. It is safe to call this
+function more than once.

+
Optionally, you may specify a default cache_size for the Glyph cache: the
+maximum number of glyphs that will be cached at any given time by the
+module. Exceedingly small values will be automatically tuned for
+performance. Also a default pixel resolution, in dots per inch, can
+be given to adjust font scaling.

+

+
+

+

+pygame.freetype.quit()

+

+
Shut down the underlying FreeType library.

+
quit() -> None

+

+
This function closes the freetype module. After calling this
+function, you should not invoke any class, method or function related to the
+freetype module as they are likely to fail or might give unpredictable
+results. It is safe to call this function even if the module hasn't been
+initialized yet.

+

+
+

+

+pygame.freetype.get_init()

+

+
Returns True if the FreeType module is currently initialized.

+
get_init() -> bool

+

+
Returns True if the pygame.freetype module is currently initialized.

+

+
New in pygame 1.9.5.

+

+

+
+

+

+pygame.freetype.was_init()

+

+
DEPRECATED: Use get_init() instead.

+
was_init() -> bool

+

+
DEPRECATED: Returns True if the pygame.freetype module is currently
+initialized. Use get_init() instead.

+

+
+

+

+pygame.freetype.get_cache_size()

+

+
Return the glyph case size

+
get_cache_size() -> long

+

+
See pygame.freetype.init()Initialize the underlying FreeType library..

+

+
+

+

+pygame.freetype.get_default_resolution()

+

+
Return the default pixel size in dots per inch

+
get_default_resolution() -> long

+

+
Returns the default pixel size, in dots per inch, for the module.
+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 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.

+

+
+

+

+pygame.freetype.SysFont()

+

+
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
+match the requested bold and italic flags. 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 a suitable system font is not found
+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.

+

+

+
+

+

+pygame.freetype.get_default_font()

+

+
Get the filename of the default font

+
get_default_font() -> string

+

+
Return the filename of the default pygame font. This is not the full path
+to the file. The file is usually in the same directory as the font module,
+but can also be bundled in a separate archive.

+

+
+

+

+pygame.freetype.Font

+

+
Create a new Font instance from a supported font file.

+
Font(file, size=0, font_index=0, resolution=0, ucs4=False) -> Font

+
Font(pathlib.Path) -> Font

+

+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
pygame.freetype.Font.name

+		—Proper font name.
pygame.freetype.Font.path

+		—Font file path
pygame.freetype.Font.size

+		—The default point size used in rendering
pygame.freetype.Font.get_rect

+		—Return the size and offset of rendered text
pygame.freetype.Font.get_metrics

+		—Return the glyph metrics for the given text
pygame.freetype.Font.height

+		—The unscaled height of the font in font units
pygame.freetype.Font.ascender

+		—The unscaled ascent of the font in font units
pygame.freetype.Font.descender

+		—The unscaled descent of the font in font units
pygame.freetype.Font.get_sized_ascender

+		—The scaled ascent of the font in pixels
pygame.freetype.Font.get_sized_descender

+		—The scaled descent of the font in pixels
pygame.freetype.Font.get_sized_height

+		—The scaled height of the font in pixels
pygame.freetype.Font.get_sized_glyph_height

+		—The scaled bounding box height of the font in pixels
pygame.freetype.Font.get_sizes

+		—return the available sizes of embedded bitmaps
pygame.freetype.Font.render

+		—Return rendered text as a surface
pygame.freetype.Font.render_to

+		—Render text onto an existing surface
pygame.freetype.Font.render_raw

+		—Return rendered text as a string of bytes
pygame.freetype.Font.render_raw_to

+		—Render text into an array of ints
pygame.freetype.Font.style

+		—The font's style flags
pygame.freetype.Font.underline

+		—The state of the font's underline style flag
pygame.freetype.Font.strong

+		—The state of the font's strong style flag
pygame.freetype.Font.oblique

+		—The state of the font's oblique style flag
pygame.freetype.Font.wide

+		—The state of the font's wide style flag
pygame.freetype.Font.strength

+		—The strength associated with the strong or wide font styles
pygame.freetype.Font.underline_adjustment

+		—Adjustment factor for the underline position
pygame.freetype.Font.fixed_width

+		—Gets whether the font is fixed-width
pygame.freetype.Font.fixed_sizes

+		—the number of available bitmap sizes for the font
pygame.freetype.Font.scalable

+		—Gets whether the font is scalable
pygame.freetype.Font.use_bitmap_strikes

+		—allow the use of embedded bitmaps in an outline font file
pygame.freetype.Font.antialiased

+		—Font anti-aliasing mode
pygame.freetype.Font.kerning

+		—Character kerning mode
pygame.freetype.Font.vertical

+		—Font vertical mode
pygame.freetype.Font.rotation

+		—text rotation in degrees counterclockwise
pygame.freetype.Font.fgcolor

+		—default foreground color
pygame.freetype.Font.bgcolor

+		—default background color
pygame.freetype.Font.origin

+		—Font render to text origin mode
pygame.freetype.Font.pad

+		—padded boundary mode
pygame.freetype.Font.ucs4

+		—Enable UCS-4 mode
pygame.freetype.Font.resolution

+		—Pixel resolution in dots per inch

+
Argument file can be either a string representing the font's filename, a
+file-like object containing the font, or None; if None, a default,
+Pygame, font is used.

+
Optionally, a size argument may be specified to set the default size in
+points, which determines the size of the rendered characters.
+The size can also be passed explicitly to each method call.
+Because of the way the caching   system works, specifying a default size on
+the constructor doesn't imply a performance gain over manually passing
+the size on each function call. If the font is bitmap and no size
+is given, the default size is set to the first available size for the font.

+
If the font file has more than one font, the font to load can be chosen with
+the index argument. An exception is raised for an out-of-range font index
+value.

+
The optional resolution argument sets the pixel size, in dots per inch,
+for use in scaling glyphs for this Font instance. If 0 then the default
+module value, set by init(), is used. The Font object's
+resolution can only be changed by re-initializing the Font instance.

+
The optional ucs4 argument, an integer, sets the default text translation
+mode: 0 (False) recognize UTF-16 surrogate pairs, any other value (True),
+to treat Unicode text as UCS-4, with no surrogate pairs. See
+Font.ucs4.

+

+

+name

+

+
Proper font name.

+
name -> string

+

+
Read only. Returns the real (long) name of the font, as
+recorded in the font file.

+

+
+

+

+path

+

+
Font file path

+
path -> unicode

+

+
Read only. Returns the path of the loaded font file

+

+
+

+

+size

+

+
The default point size used in rendering

+
size -> float

+
size -> (float, float)

+

+
Get or set the default size for text metrics and rendering. It can be
+a single point size, given as a Python int or float, or a
+font ppem (width, height) tuple. Size values are non-negative.
+A zero size or width represents an undefined size. In this case
+the size must be given as a method argument, or an exception is
+raised. A zero width but non-zero height is a ValueError.

+
For a scalable font, a single number value is equivalent to a tuple
+with width equal height. A font can be stretched vertically with
+height set greater than width, or horizontally with width set
+greater than height. For embedded bitmaps, as listed by get_sizes(),
+use the nominal width and height to select an available size.

+
Font size differs for a non-scalable, bitmap, font. During a
+method call it must match one of the available sizes returned by
+method get_sizes(). If not, an exception is raised.
+If the size is a single number, the size is first matched against the
+point size value. If no match, then the available size with the
+same nominal width and height is chosen.

+

+
+

+

+get_rect()

+

+
Return the size and offset of rendered text

+
get_rect(text, style=STYLE_DEFAULT, rotation=0, size=0) -> rect

+

+
Gets the final dimensions and origin, in pixels, of text using the
+optional size in points, style, and rotation. For other
+relevant render properties, and for any optional argument not given,
+the default values set for the Font instance are used.

+
Returns a Rect instance containing the
+width and height of the text's bounding box and the position of the
+text's origin.
+The origin is useful in aligning separately rendered pieces of text.
+It gives the baseline position and bearing at the start of the text.
+See the render_to() method for an example.

+
If text is a char (byte) string, its encoding is assumed to be
+LATIN1.

+
Optionally, text can be None, which will return the bounding
+rectangle for the text passed to a previous get_rect(),
+render(), render_to(), render_raw(), or
+render_raw_to() call. See render_to() for more
+details.

+

+
+

+

+get_metrics()

+

+
Return the glyph metrics for the given text

+
get_metrics(text, size=0) -> [(...), ...]

+

+
Returns the glyph metrics for each character in text.

+
The glyph metrics are returned as a list of tuples. Each tuple gives
+metrics of a single character glyph. The glyph metrics are:

+
(min_x, max_x, min_y, max_y, horizontal_advance_x, horizontal_advance_y)
+

+

+
The bounding box min_x, max_x, min_y, and max_y values are returned as
+grid-fitted pixel coordinates of type int. The advance values are
+float values.

+
The calculations are done using the font's default size in points.
+Optionally you may specify another point size with the size argument.

+
The metrics are adjusted for the current rotation, strong, and oblique
+settings.

+
If text is a char (byte) string, then its encoding is assumed to be
+LATIN1.

+

+
+

+

+height

+

+
The unscaled height of the font in font units

+
height -> int

+

+
Read only. Gets the height of the font. This is the average value of all
+glyphs in the font.

+

+
+

+

+ascender

+

+
The unscaled ascent of the font in font units

+
ascender -> int

+

+
Read only. Return the number of units from the font's baseline to
+the top of the bounding box.

+

+
+

+

+descender

+

+
The unscaled descent of the font in font units

+
descender -> int

+

+
Read only. Return the height in font units for the font descent.
+The descent is the number of units from the font's baseline to the
+bottom of the bounding box.

+

+
+

+

+get_sized_ascender()

+

+
The scaled ascent of the font in pixels

+
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.

+

+
+

+

+get_sized_descender()

+

+
The scaled descent of the font in pixels

+
get_sized_descender(<size>=0) -> int

+

+
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.

+

+
+

+

+get_sized_height()

+

+
The scaled height of the font in pixels

+
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.

+

+
+

+

+get_sized_glyph_height()

+

+
The scaled bounding box height of the font in pixels

+
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.
+It is not adjusted for strong or rotation.

+

+
+

+

+get_sizes()

+

+
return the available sizes of embedded bitmaps

+
get_sizes() -> [(int, int, int, float, float), ...]

+
get_sizes() -> []

+

+
Returns a list of tuple records, one for each point size
+supported. Each tuple containing the point size, the height in pixels,
+width in pixels, horizontal ppem (nominal width) in fractional pixels,
+and vertical ppem (nominal height) in fractional pixels.

+

+
+

+

+render()

+

+
Return rendered text as a surface

+
render(text, fgcolor=None, bgcolor=None, style=STYLE_DEFAULT, rotation=0, size=0) -> (Surface, Rect)

+

+
Returns a new Surface,
+with the text rendered to it
+in the color given by 'fgcolor'. If no foreground color is given,
+the default foreground color, fgcolor is used.
+If bgcolor is given, the surface
+will be filled with this color. When no background color is given,
+the surface background is transparent, zero alpha. Normally the returned
+surface has a 32 bit pixel size. However, if bgcolor is None
+and anti-aliasing is disabled a monochrome 8 bit colorkey surface,
+with colorkey set for the background color, is returned.

+
The return value is a tuple: the new surface and the bounding
+rectangle giving the size and origin of the rendered text.

+
If an empty string is passed for text then the returned Rect is zero
+width and the height of the font.

+
Optional fgcolor, style, rotation, and size arguments override
+the default values set for the Font instance.

+
If text is a char (byte) string, then its encoding is assumed to be
+LATIN1.

+
Optionally, text can be None, which will render the text
+passed to a previous get_rect(), render(), render_to(),
+render_raw(), or render_raw_to() call.
+See render_to() for details.

+

+
+

+

+render_to()

+

+
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,
+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
+is accepted, including a Rect instance.
+As with render(),
+optional fgcolor, style, rotation, and size argument are
+available.

+
If a background color bgcolor is given, the text bounding box is
+first filled with that color. The text is blitted next.
+Both the background fill and text rendering involve full alpha blits.
+That is, the alpha values of the foreground, background, and destination
+target surface all affect the blit.

+
The return value is a rectangle giving the size and position of the
+rendered text within the surface.

+
If an empty string is passed for text then the returned
+Rect is zero width and the height of the font.
+The rect will test False.

+
Optionally, text can be set None, which will re-render text
+passed to a previous render_to(), get_rect(), render(),
+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)):
+    font.origin = True
+    words = text.split(' ')
+    width, height = surf.get_size()
+    line_spacing = font.get_sized_height() + 2
+    x, y = 0, line_spacing
+    space = font.get_rect(' ')
+    for word in words:
+        bounds = font.get_rect(word)
+        if x + bounds.width + bounds.x >= width:
+            x, y = 0, 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
+

+

+
When render_to() is called with the same
+font properties ― size, style, strength,
+wide, antialiased, vertical, rotation,
+kerning, and use_bitmap_strikes ― as get_rect(),
+render_to() will use the layout calculated by get_rect().
+Otherwise, render_to() will recalculate the layout if called
+with a text string or one of the above properties has changed
+after the get_rect() call.

+
If text is a char (byte) string, then its encoding is assumed to be
+LATIN1.

+

+
+

+

+render_raw()

+

+
Return rendered text as a string of bytes

+
render_raw(text, style=STYLE_DEFAULT, rotation=0, size=0, invert=False) -> (bytes, (int, int))

+

+
Like render() but with the pixels returned as a byte string
+of 8-bit gray-scale values. The foreground color is 255, the
+background 0, useful as an alpha mask for a foreground pattern.

+

+
+

+

+render_raw_to()

+

+
Render text into an array of ints

+
render_raw_to(array, text, dest=None, style=STYLE_DEFAULT, rotation=0, size=0, invert=False) -> Rect

+

+
Render to an array object exposing an array struct interface. The array
+must be two dimensional with integer items. The default dest value,
+None, is equivalent to position (0, 0). See render_to().
+As with the other render methods, text can be None to
+render a text string passed previously to another method.

+
The return value is a pygame.Rect()pygame object for storing rectangular coordinates giving the size and position of
+the rendered text.

+

+
+

+

+style

+

+
The font's style flags

+
style -> int

+

+
Gets or sets the default style of the Font. This default style will be
+used for all text rendering and size calculations unless overridden
+specifically a render or get_rect() call.
+The style value may be a bit-wise OR of one or more of the following
+constants:

+
STYLE_NORMAL
+STYLE_UNDERLINE
+STYLE_OBLIQUE
+STYLE_STRONG
+STYLE_WIDE
+STYLE_DEFAULT
+

+

+
These constants may be found on the FreeType constants module.
+Optionally, the default style can be modified or obtained accessing the
+individual style attributes (underline, oblique, strong).

+
The STYLE_OBLIQUE and STYLE_STRONG styles are for
+scalable fonts only. An attempt to set either for a bitmap font raises
+an AttributeError. An attempt to set either for an inactive font,
+as returned by Font.__new__(), raises a RuntimeError.

+
Assigning STYLE_DEFAULT to the style property leaves
+the property unchanged, as this property defines the default.
+The style property will never return STYLE_DEFAULT.

+

+
+

+

+underline

+

+
The state of the font's underline style flag

+
underline -> bool

+

+
Gets or sets whether the font will be underlined when drawing text. This
+default style value will be used for all text rendering and size
+calculations unless overridden specifically in a render or
+get_rect() call, via the 'style' parameter.

+

+
+

+

+strong

+

+
The state of the font's strong style flag

+
strong -> bool

+

+
Gets or sets whether the font will be bold when drawing text. This
+default style value will be used for all text rendering and size
+calculations unless overridden specifically in a render or
+get_rect() call, via the 'style' parameter.

+

+
+

+

+oblique

+

+
The state of the font's oblique style flag

+
oblique -> bool

+

+
Gets or sets whether the font will be rendered as oblique. This
+default style value will be used for all text rendering and size
+calculations unless overridden specifically in a render or
+get_rect() call, via the style parameter.

+
The oblique style is only supported for scalable (outline) fonts.
+An attempt to set this style on a bitmap font will raise an
+AttributeError. If the font object is inactive, as returned by
+Font.__new__(), setting this property raises a RuntimeError.

+

+
+

+

+wide

+

+
The state of the font's wide style flag

+
wide -> bool

+

+
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
+rotated text.

+

+
+

+

+strength

+

+
The strength associated with the strong or wide font styles

+
strength -> float

+

+
The amount by which a font glyph's size is enlarged for the
+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.
+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
+AttributeError. If the font object is inactive, as returned by
+Font.__new__(), assignment to this property raises a RuntimeError.

+

+
+

+

+underline_adjustment

+

+
Adjustment factor for the underline position

+
underline_adjustment -> float

+

+
Gets or sets a factor which, when positive, is multiplied with the
+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.

+

+
+

+

+fixed_width

+

+
Gets whether the font is fixed-width

+
fixed_width -> bool

+

+
Read only. Returns True if the font contains fixed-width
+characters (for example Courier, Bitstream Vera Sans Mono, Andale Mono).

+

+
+

+

+fixed_sizes

+

+
the number of available bitmap sizes for the font

+
fixed_sizes -> int

+

+
Read only. Returns the number of point sizes for which the font contains
+bitmap character images. If zero then the font is not a bitmap font.
+A scalable font may contain pre-rendered point sizes as strikes.

+

+
+

+

+scalable

+

+
Gets whether the font is scalable

+
scalable -> bool

+

+
Read only. Returns True if the font contains outline glyphs.
+If so, the point size is not limited to available bitmap sizes.

+

+
+

+

+use_bitmap_strikes

+

+
allow the use of embedded bitmaps in an outline font file

+
use_bitmap_strikes -> bool

+

+
Some scalable fonts include embedded bitmaps for particular point
+sizes. This property controls whether or not those bitmap strikes
+are used. Set it False to disable the loading of any bitmap
+strike. Set it True, the default, to permit bitmap strikes
+for a non-rotated render with no style other than wide or
+underline. This property is ignored for bitmap fonts.

+
See also fixed_sizes and get_sizes().

+

+
+

+

+antialiased

+

+
Font anti-aliasing mode

+
antialiased -> bool

+

+
Gets or sets the font's anti-aliasing mode. This defaults to
+True on all fonts, which are rendered with full 8 bit blending.

+
Set to False to do monochrome rendering. This should
+provide a small speed gain and reduce cache memory size.

+

+
+

+

+kerning

+

+
Character kerning mode

+
kerning -> bool

+

+
Gets or sets the font's kerning mode. This defaults to False
+on all fonts, which will be rendered without kerning.

+
Set to True to add kerning between character pairs, if supported
+by the font, when positioning glyphs.

+

+
+

+

+vertical

+

+
Font vertical mode

+
vertical -> bool

+

+
Gets or sets whether the characters are laid out vertically rather
+than horizontally. May be useful when rendering Kanji or some other
+vertical script.

+
Set to True to switch to a vertical text layout. The default
+is False, place horizontally.

+
Note that the Font class does not automatically determine
+script orientation. Vertical layout must be selected explicitly.

+
Also note that several font formats (especially bitmap based ones) don't
+contain the necessary metrics to draw glyphs vertically, so drawing in
+those cases will give unspecified results.

+

+
+

+

+rotation

+

+
text rotation in degrees counterclockwise

+
rotation -> int

+

+
Gets or sets the baseline angle of the rendered text. The angle is
+represented as integer degrees. The default angle is 0, with horizontal
+text rendered along the X-axis, and vertical text along the Y-axis.
+A positive value rotates these axes counterclockwise that many degrees.
+A negative angle corresponds to a clockwise rotation. The rotation
+value is normalized to a value within the range 0 to 359 inclusive
+(eg. 390 -> 390 - 360 -> 30, -45 -> 360 + -45 -> 315,
+720 -> 720 - (2 * 360) -> 0).

+
Only scalable (outline) fonts can be rotated. An attempt to change
+the rotation of a bitmap font raises an AttributeError.
+An attempt to change the rotation of an inactive font instance, as
+returned by Font.__new__(), raises a RuntimeError.

+

+
+

+

+fgcolor

+

+
default foreground color

+
fgcolor -> Color

+

+
Gets or sets the default glyph rendering color. It is initially opaque
+black ― (0, 0, 0, 255). Applies to render() and render_to().

+

+
+

+

+bgcolor

+

+
default background color

+
bgcolor -> Color

+

+
Gets or sets the default background rendering color. Initially it is
+unset and text will render with a transparent background by default.
+Applies to render() and render_to().

+

+
+

+
New in pygame 2.0.0.

+

+

+

+origin

+

+
Font render to text origin mode

+
origin -> bool

+

+
If set True, render_to() and render_raw_to() will
+take the dest position to be that of the text origin, as opposed to
+the top-left corner of the bounding box. See get_rect() for
+details.

+

+
+

+

+pad

+

+
padded boundary mode

+
pad -> bool

+

+
If set True, then the text boundary rectangle will be inflated
+to match that of font.Font.
+Otherwise, the boundary rectangle is just large enough for the text.

+

+
+

+

+ucs4

+

+
Enable UCS-4 mode

+
ucs4 -> bool

+

+
Gets or sets the decoding of Unicode text. By default, the
+freetype module performs UTF-16 surrogate pair decoding on Unicode text.
+This allows 32-bit escape sequences ('Uxxxxxxxx') between 0x10000 and
+0x10FFFF to represent their corresponding UTF-32 code points on Python
+interpreters built with a UCS-2 Unicode type (on Windows, for instance).
+It also means character values within the UTF-16 surrogate area (0xD800
+to 0xDFFF) are considered part of a surrogate pair. A malformed surrogate
+pair will raise a UnicodeEncodeError. Setting ucs4 True turns
+surrogate pair decoding off, allowing access the full UCS-4 character
+range to a Python interpreter built with four-byte Unicode character
+support.

+

+
+

+

+resolution

+

+
Pixel resolution in dots per inch

+
resolution -> int

+

+
Read only. Gets pixel size used in scaling font glyphs for this
+Font instance.

+

+
+

+
+

+
+

+
+
+


+

+Edit on GitHub
+            

+          

+      

+      

+    

+    
+    
+  
+
\ No newline at end of file
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/ref/gfxdraw.html b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/ref/gfxdraw.html
new file mode 100644
index 0000000..1c74953
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/ref/gfxdraw.html
@@ -0,0 +1,1049 @@
+
+
+
+  
+    
+    
+
+    pygame.gfxdraw — pygame v2.6.1 documentation
+    
+    
+    
+    
+    
+    
+    
+    
+    
+     
+    
+
+    

+
+  

+	

+	
+	

+	  

+	    Pygame Home ||
+	    Help Contents ||
+	    Reference Index
+
+        

+          
+          
+        

+	  

+	  

+	  
Most useful stuff:
+	    Color | 
+	    display | 
+	    draw | 
+	    event | 
+	    font | 
+	    image | 
+	    key | 
+	    locals | 
+	    mixer | 
+	    mouse | 
+	    Rect | 
+	    Surface | 
+	    time | 
+	    music | 
+	    pygame
+	  

+
+	  
Advanced stuff:
+	    cursors | 
+	    joystick | 
+	    mask | 
+	    sprite | 
+	    transform | 
+	    BufferProxy | 
+	    freetype | 
+	    gfxdraw | 
+	    midi | 
+	    PixelArray | 
+	    pixelcopy | 
+	    sndarray | 
+	    surfarray | 
+	    math
+	  

+
+	  
Other:
+	    camera | 
+	    controller | 
+	    examples | 
+	    fastevent | 
+	    scrap | 
+	    tests | 
+	    touch | 
+	    version
+	  

+

+

+  

+
+      

+          

+            
+

+

+

+pygame.gfxdraw

+

+
pygame module for drawing shapes

+

+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
pygame.gfxdraw.pixel

+		—draw a pixel
pygame.gfxdraw.hline

+		—draw a horizontal line
pygame.gfxdraw.vline

+		—draw a vertical line
pygame.gfxdraw.line

+		—draw a line
pygame.gfxdraw.rectangle

+		—draw a rectangle
pygame.gfxdraw.box

+		—draw a filled rectangle
pygame.gfxdraw.circle

+		—draw a circle
pygame.gfxdraw.aacircle

+		—draw an antialiased circle
pygame.gfxdraw.filled_circle

+		—draw a filled circle
pygame.gfxdraw.ellipse

+		—draw an ellipse
pygame.gfxdraw.aaellipse

+		—draw an antialiased ellipse
pygame.gfxdraw.filled_ellipse

+		—draw a filled ellipse
pygame.gfxdraw.arc

+		—draw an arc
pygame.gfxdraw.pie

+		—draw a pie
pygame.gfxdraw.trigon

+		—draw a trigon/triangle
pygame.gfxdraw.aatrigon

+		—draw an antialiased trigon/triangle
pygame.gfxdraw.filled_trigon

+		—draw a filled trigon/triangle
pygame.gfxdraw.polygon

+		—draw a polygon
pygame.gfxdraw.aapolygon

+		—draw an antialiased polygon
pygame.gfxdraw.filled_polygon

+		—draw a filled polygon
pygame.gfxdraw.textured_polygon

+		—draw a textured polygon
pygame.gfxdraw.bezier

+		—draw a Bezier curve

+
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 pygame package does not import gfxdraw automatically when loaded, so it
+must imported explicitly to be used.

+
import pygame
+import pygame.gfxdraw
+

+

+
For all functions the arguments are strictly positional and integers are
+accepted for coordinates and radii. The color argument can be one of the
+following formats:

+

+

+

+
The functions rectangle() and box() will accept any (x, y, w, h)
+sequence for their rect argument, though pygame.Rectpygame object for storing rectangular coordinates instances are
+preferred.

+
To draw a filled antialiased shape, first use the antialiased (aa*) version
+of the function, and then use the filled (filled_*) version.
+For example:

+
col = (255, 0, 0)
+surf.fill((255, 255, 255))
+pygame.gfxdraw.aacircle(surf, x, y, 30, col)
+pygame.gfxdraw.filled_circle(surf, x, y, 30, col)
+

+

+

+
Note

+
For threading, each of the functions releases the GIL during the C part of
+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
+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.

+

+

+

+pygame.gfxdraw.pixel()

+

+
draw a pixel

+
pixel(surface, x, y, color) -> None

+

+
Draws a single pixel, at position (x ,y), on the given surface.

+

+
Parameters:

+
    
+
  • surface (Surface) -- surface to draw on
    • 
+
  • x (int) -- x coordinate of the pixel
    • 
+
  • y (int) -- y coordinate of the pixel
    • 
+
  • color (Color or tuple(int, int, int, [int])) -- color to draw with, the alpha value is optional if using a
+tuple (RGB[A])
    • 
+

+

+
Returns:

+
None

+

+
Return type:

+
NoneType

+

+

+

+
+

+

+pygame.gfxdraw.hline()

+

+
draw a horizontal line

+
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.

+

+
Parameters:

+
    
+
  • surface (Surface) -- surface to draw on
    • 
+
  • x1 (int) -- x coordinate of one end of the line
    • 
+
  • x2 (int) -- x coordinate of the other end of the line
    • 
+
  • y (int) -- y coordinate of the line
    • 
+
  • color (Color or tuple(int, int, int, [int])) -- color to draw with, the alpha value is optional if using a
+tuple (RGB[A])
    • 
+

+

+
Returns:

+
None

+

+
Return type:

+
NoneType

+

+

+

+
+

+

+pygame.gfxdraw.vline()

+

+
draw a vertical line

+
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.

+

+
Parameters:

+
    
+
  • surface (Surface) -- surface to draw on
    • 
+
  • x (int) -- x coordinate of the line
    • 
+
  • y1 (int) -- y coordinate of one end of the line
    • 
+
  • y2 (int) -- y coordinate of the other end of the line
    • 
+
  • color (Color or tuple(int, int, int, [int])) -- color to draw with, the alpha value is optional if using a
+tuple (RGB[A])
    • 
+

+

+
Returns:

+
None

+

+
Return type:

+
NoneType

+

+

+

+
+

+

+pygame.gfxdraw.line()

+

+
draw a line

+
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.

+

+
Parameters:

+
    
+
  • surface (Surface) -- surface to draw on
    • 
+
  • x1 (int) -- x coordinate of one end of the line
    • 
+
  • y1 (int) -- y coordinate of one end of the line
    • 
+
  • x2 (int) -- x coordinate of the other end of the line
    • 
+
  • y2 (int) -- y coordinate of the other end of the line
    • 
+
  • color (Color or tuple(int, int, int, [int])) -- color to draw with, the alpha value is optional if using a
+tuple (RGB[A])
    • 
+

+

+
Returns:

+
None

+

+
Return type:

+
NoneType

+

+

+

+
+

+

+pygame.gfxdraw.rectangle()

+

+
draw a rectangle

+
rectangle(surface, rect, color) -> None

+

+
Draws an unfilled rectangle on the given surface. For a filled rectangle use
+box().

+

+
Parameters:

+
    
+
  • surface (Surface) -- surface to draw on
    • 
+
  • rect (Rect) -- rectangle to draw, position and dimensions
    • 
+
  • color (Color or tuple(int, int, int, [int])) -- color to draw with, the alpha value is optional if using a
+tuple (RGB[A])
    • 
+

+

+
Returns:

+
None

+

+
Return type:

+
NoneType

+

+

+

+
Note

+
The rect.bottom and rect.right attributes of a pygame.Rectpygame object for storing rectangular coordinates
+always lie one pixel outside of its actual border. Therefore, these
+values will not be included as part of the drawing.

+

+

+
+

+

+pygame.gfxdraw.box()

+

+
draw a filled rectangle

+
box(surface, rect, color) -> None

+

+
Draws a filled rectangle on the given surface. For an unfilled rectangle use
+rectangle().

+

+
Parameters:

+
    
+
  • surface (Surface) -- surface to draw on
    • 
+
  • rect (Rect) -- rectangle to draw, position and dimensions
    • 
+
  • color (Color or tuple(int, int, int, [int])) -- color to draw with, the alpha value is optional if using a
+tuple (RGB[A])
    • 
+

+

+
Returns:

+
None

+

+
Return type:

+
NoneType

+

+

+

+
Note

+
The rect.bottom and rect.right attributes of a pygame.Rectpygame object for storing rectangular coordinates
+always lie one pixel outside of its actual border. Therefore, these
+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
+accelerated on some platforms with both software and hardware display
+modes.

+

+

+
+

+

+pygame.gfxdraw.circle()

+

+
draw a circle

+
circle(surface, x, y, r, color) -> None

+

+
Draws an unfilled circle on the given surface. For a filled circle use
+filled_circle().

+

+
Parameters:

+
    
+
  • surface (Surface) -- surface to draw on
    • 
+
  • x (int) -- x coordinate of the center of the circle
    • 
+
  • y (int) -- y coordinate of the center of the circle
    • 
+
  • r (int) -- radius of the circle
    • 
+
  • color (Color or tuple(int, int, int, [int])) -- color to draw with, the alpha value is optional if using a
+tuple (RGB[A])
    • 
+

+

+
Returns:

+
None

+

+
Return type:

+
NoneType

+

+

+

+
+

+

+pygame.gfxdraw.aacircle()

+

+
draw an antialiased circle

+
aacircle(surface, x, y, r, color) -> None

+

+
Draws an unfilled antialiased circle on the given surface.

+

+
Parameters:

+
    
+
  • surface (Surface) -- surface to draw on
    • 
+
  • x (int) -- x coordinate of the center of the circle
    • 
+
  • y (int) -- y coordinate of the center of the circle
    • 
+
  • r (int) -- radius of the circle
    • 
+
  • color (Color or tuple(int, int, int, [int])) -- color to draw with, the alpha value is optional if using a
+tuple (RGB[A])
    • 
+

+

+
Returns:

+
None

+

+
Return type:

+
NoneType

+

+

+

+
+

+

+pygame.gfxdraw.filled_circle()

+

+
draw a filled circle

+
filled_circle(surface, x, y, r, color) -> None

+

+
Draws a filled circle on the given surface. For an unfilled circle use
+circle().

+

+
Parameters:

+
    
+
  • surface (Surface) -- surface to draw on
    • 
+
  • x (int) -- x coordinate of the center of the circle
    • 
+
  • y (int) -- y coordinate of the center of the circle
    • 
+
  • r (int) -- radius of the circle
    • 
+
  • color (Color or tuple(int, int, int, [int])) -- color to draw with, the alpha value is optional if using a
+tuple (RGB[A])
    • 
+

+

+
Returns:

+
None

+

+
Return type:

+
NoneType

+

+

+

+
+

+

+pygame.gfxdraw.ellipse()

+

+
draw an ellipse

+
ellipse(surface, x, y, rx, ry, color) -> None

+

+
Draws an unfilled ellipse on the given surface. For a filled ellipse use
+filled_ellipse().

+

+
Parameters:

+
    
+
  • surface (Surface) -- surface to draw on
    • 
+
  • x (int) -- x coordinate of the center of the ellipse
    • 
+
  • y (int) -- y coordinate of the center of the ellipse
    • 
+
  • rx (int) -- horizontal radius of the ellipse
    • 
+
  • ry (int) -- vertical radius of the ellipse
    • 
+
  • color (Color or tuple(int, int, int, [int])) -- color to draw with, the alpha value is optional if using a
+tuple (RGB[A])
    • 
+

+

+
Returns:

+
None

+

+
Return type:

+
NoneType

+

+

+

+
+

+

+pygame.gfxdraw.aaellipse()

+

+
draw an antialiased ellipse

+
aaellipse(surface, x, y, rx, ry, color) -> None

+

+
Draws an unfilled antialiased ellipse on the given surface.

+

+
Parameters:

+
    
+
  • surface (Surface) -- surface to draw on
    • 
+
  • x (int) -- x coordinate of the center of the ellipse
    • 
+
  • y (int) -- y coordinate of the center of the ellipse
    • 
+
  • rx (int) -- horizontal radius of the ellipse
    • 
+
  • ry (int) -- vertical radius of the ellipse
    • 
+
  • color (Color or tuple(int, int, int, [int])) -- color to draw with, the alpha value is optional if using a
+tuple (RGB[A])
    • 
+

+

+
Returns:

+
None

+

+
Return type:

+
NoneType

+

+

+

+
+

+

+pygame.gfxdraw.filled_ellipse()

+

+
draw a filled ellipse

+
filled_ellipse(surface, x, y, rx, ry, color) -> None

+

+
Draws a filled ellipse on the given surface. For an unfilled ellipse use
+ellipse().

+

+
Parameters:

+
    
+
  • surface (Surface) -- surface to draw on
    • 
+
  • x (int) -- x coordinate of the center of the ellipse
    • 
+
  • y (int) -- y coordinate of the center of the ellipse
    • 
+
  • rx (int) -- horizontal radius of the ellipse
    • 
+
  • ry (int) -- vertical radius of the ellipse
    • 
+
  • color (Color or tuple(int, int, int, [int])) -- color to draw with, the alpha value is optional if using a
+tuple (RGB[A])
    • 
+

+

+
Returns:

+
None

+

+
Return type:

+
NoneType

+

+

+

+
+

+

+pygame.gfxdraw.arc()

+

+
draw an arc

+
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().

+
The two angle arguments are given in degrees and indicate the start and stop
+positions of the arc. The arc is drawn in a clockwise direction from the
+start_angle to the stop_angle. If start_angle == stop_angle,
+nothing will be drawn

+

+
Parameters:

+
    
+
  • surface (Surface) -- surface to draw on
    • 
+
  • x (int) -- x coordinate of the center of the arc
    • 
+
  • y (int) -- y coordinate of the center of the arc
    • 
+
  • r (int) -- radius of the arc
    • 
+
  • start_angle (int) -- start angle in degrees
    • 
+
  • stop_angle (int) -- stop angle in degrees
    • 
+
  • color (Color or tuple(int, int, int, [int])) -- color to draw with, the alpha value is optional if using a
+tuple (RGB[A])
    • 
+

+

+
Returns:

+
None

+

+
Return type:

+
NoneType

+

+

+

+
Note

+
This function uses degrees while the pygame.draw.arc()draw an elliptical arc function
+uses radians.

+

+

+
+

+

+pygame.gfxdraw.pie()

+

+
draw a pie

+
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.

+
The two angle arguments are given in degrees and indicate the start and stop
+positions of the pie. The pie is drawn in a clockwise direction from the
+start_angle to the stop_angle. If start_angle == stop_angle,
+a straight line will be drawn from the center position at the given angle,
+to a length of the radius.

+

+
Parameters:

+
    
+
  • surface (Surface) -- surface to draw on
    • 
+
  • x (int) -- x coordinate of the center of the pie
    • 
+
  • y (int) -- y coordinate of the center of the pie
    • 
+
  • r (int) -- radius of the pie
    • 
+
  • start_angle (int) -- start angle in degrees
    • 
+
  • stop_angle (int) -- stop angle in degrees
    • 
+
  • color (Color or tuple(int, int, int, [int])) -- color to draw with, the alpha value is optional if using a
+tuple (RGB[A])
    • 
+

+

+
Returns:

+
None

+

+
Return type:

+
NoneType

+

+

+

+
+

+

+pygame.gfxdraw.trigon()

+

+
draw a trigon/triangle

+
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().

+
A trigon can also be drawn using polygon() e.g.
+polygon(surface, ((x1, y1), (x2, y2), (x3, y3)), color)

+

+
Parameters:

+
    
+
  • surface (Surface) -- surface to draw on
    • 
+
  • x1 (int) -- x coordinate of the first corner of the trigon
    • 
+
  • y1 (int) -- y coordinate of the first corner of the trigon
    • 
+
  • x2 (int) -- x coordinate of the second corner of the trigon
    • 
+
  • y2 (int) -- y coordinate of the second corner of the trigon
    • 
+
  • x3 (int) -- x coordinate of the third corner of the trigon
    • 
+
  • y3 (int) -- y coordinate of the third corner of the trigon
    • 
+
  • color (Color or tuple(int, int, int, [int])) -- color to draw with, the alpha value is optional if using a
+tuple (RGB[A])
    • 
+

+

+
Returns:

+
None

+

+
Return type:

+
NoneType

+

+

+

+
+

+

+pygame.gfxdraw.aatrigon()

+

+
draw an antialiased trigon/triangle

+
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.
+aapolygon(surface, ((x1, y1), (x2, y2), (x3, y3)), color)

+

+
Parameters:

+
    
+
  • surface (Surface) -- surface to draw on
    • 
+
  • x1 (int) -- x coordinate of the first corner of the trigon
    • 
+
  • y1 (int) -- y coordinate of the first corner of the trigon
    • 
+
  • x2 (int) -- x coordinate of the second corner of the trigon
    • 
+
  • y2 (int) -- y coordinate of the second corner of the trigon
    • 
+
  • x3 (int) -- x coordinate of the third corner of the trigon
    • 
+
  • y3 (int) -- y coordinate of the third corner of the trigon
    • 
+
  • color (Color or tuple(int, int, int, [int])) -- color to draw with, the alpha value is optional if using a
+tuple (RGB[A])
    • 
+

+

+
Returns:

+
None

+

+
Return type:

+
NoneType

+

+

+

+
+

+

+pygame.gfxdraw.filled_trigon()

+

+
draw a filled trigon/triangle

+
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().

+
A filled_trigon can also be drawn using filled_polygon() e.g.
+filled_polygon(surface, ((x1, y1), (x2, y2), (x3, y3)), color)

+

+
Parameters:

+
    
+
  • surface (Surface) -- surface to draw on
    • 
+
  • x1 (int) -- x coordinate of the first corner of the trigon
    • 
+
  • y1 (int) -- y coordinate of the first corner of the trigon
    • 
+
  • x2 (int) -- x coordinate of the second corner of the trigon
    • 
+
  • y2 (int) -- y coordinate of the second corner of the trigon
    • 
+
  • x3 (int) -- x coordinate of the third corner of the trigon
    • 
+
  • y3 (int) -- y coordinate of the third corner of the trigon
    • 
+
  • color (Color or tuple(int, int, int, [int])) -- color to draw with, the alpha value is optional if using a
+tuple (RGB[A])
    • 
+

+

+
Returns:

+
None

+

+
Return type:

+
NoneType

+

+

+

+
+

+

+pygame.gfxdraw.polygon()

+

+
draw a polygon

+
polygon(surface, points, color) -> None

+

+
Draws an unfilled polygon on the given surface. For a filled polygon use
+filled_polygon().

+
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
+(x3, y3), and from (x3, y3) to (x1, y1).

+

+
Parameters:

+
    
+
  • surface (Surface) -- surface to draw on
    • 
+
  • 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
+tuple (RGB[A])
    • 
+

+

+
Returns:

+
None

+

+
Return type:

+
NoneType

+

+
Raises:

+
    
+
  • ValueError -- if len(points) < 3 (must have at least 3 points)
    • 
+
  • IndexError -- if len(coordinate) < 2 (each coordinate must have
+at least 2 items)
    • 
+

+

+

+

+
+

+

+pygame.gfxdraw.aapolygon()

+

+
draw an antialiased polygon

+
aapolygon(surface, points, color) -> None

+

+
Draws an unfilled antialiased polygon on the given surface.

+
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
+(x3, y3), and from (x3, y3) to (x1, y1).

+

+
Parameters:

+
    
+
  • surface (Surface) -- surface to draw on
    • 
+
  • 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
+tuple (RGB[A])
    • 
+

+

+
Returns:

+
None

+

+
Return type:

+
NoneType

+

+
Raises:

+
    
+
  • ValueError -- if len(points) < 3 (must have at least 3 points)
    • 
+
  • IndexError -- if len(coordinate) < 2 (each coordinate must have
+at least 2 items)
    • 
+

+

+

+

+
+

+

+pygame.gfxdraw.filled_polygon()

+

+
draw a filled polygon

+
filled_polygon(surface, points, color) -> None

+

+
Draws a filled polygon on the given surface. For an unfilled polygon use
+polygon().

+
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
+(x3, y3), and from (x3, y3) to (x1, y1).

+

+
Parameters:

+
    
+
  • surface (Surface) -- surface to draw on
    • 
+
  • 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
+tuple (RGB[A])
    • 
+

+

+
Returns:

+
None

+

+
Return type:

+
NoneType

+

+
Raises:

+
    
+
  • ValueError -- if len(points) < 3 (must have at least 3 points)
    • 
+
  • IndexError -- if len(coordinate) < 2 (each coordinate must have
+at least 2 items)
    • 
+

+

+

+

+
+

+

+pygame.gfxdraw.textured_polygon()

+

+
draw a textured polygon

+
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 one image onto another blit. Also, a per-pixel alpha texture cannot be
+used with an 8-bit per pixel destination.

+
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
+(x3, y3), and from (x3, y3) to (x1, y1).

+

+
Parameters:

+
    
+
  • surface (Surface) -- surface to draw on
    • 
+
  • 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
    • 
+
  • tx (int) -- x offset of the texture
    • 
+
  • ty (int) -- y offset of the texture
    • 
+

+

+
Returns:

+
None

+

+
Return type:

+
NoneType

+

+
Raises:

+
    
+
  • ValueError -- if len(points) < 3 (must have at least 3 points)
    • 
+
  • IndexError -- if len(coordinate) < 2 (each coordinate must have
+at least 2 items)
    • 
+

+

+

+

+
+

+

+pygame.gfxdraw.bezier()

+

+
draw a Bezier curve

+
bezier(surface, points, steps, color) -> None

+

+
Draws a Bézier curve on the given surface.

+

+
Parameters:

+
    
+
  • surface (Surface) -- surface to draw on
    • 
+
  • 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
    • 
+
  • color (Color or tuple(int, int, int, [int])) -- color to draw with, the alpha value is optional if using a
+tuple (RGB[A])
    • 
+

+

+
Returns:

+
None

+

+
Return type:

+
NoneType

+

+
Raises:

+
    
+
  • ValueError -- if steps < 2
    • 
+
  • ValueError -- if len(points) < 3 (must have at least 3 points)
    • 
+
  • IndexError -- if len(coordinate) < 2 (each coordinate must have
+at least 2 items)
    • 
+

+

+

+

+
+

+
+

+
+
+


+

+Edit on GitHub
+            

+          

+      

+      

+    

+    
+    
+  
+
\ No newline at end of file
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/ref/image.html b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/ref/image.html
new file mode 100644
index 0000000..1ab7b6b
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/ref/image.html
@@ -0,0 +1,557 @@
+
+
+
+  
+    
+    
+
+    pygame.image — pygame v2.6.1 documentation
+    
+    
+    
+    
+    
+    
+    
+    
+    
+     
+    
+
+    

+
+  

+	

+	
+	

+	  

+	    Pygame Home ||
+	    Help Contents ||
+	    Reference Index
+
+        

+          
+          
+        

+	  

+	  

+	  
Most useful stuff:
+	    Color | 
+	    display | 
+	    draw | 
+	    event | 
+	    font | 
+	    image | 
+	    key | 
+	    locals | 
+	    mixer | 
+	    mouse | 
+	    Rect | 
+	    Surface | 
+	    time | 
+	    music | 
+	    pygame
+	  

+
+	  
Advanced stuff:
+	    cursors | 
+	    joystick | 
+	    mask | 
+	    sprite | 
+	    transform | 
+	    BufferProxy | 
+	    freetype | 
+	    gfxdraw | 
+	    midi | 
+	    PixelArray | 
+	    pixelcopy | 
+	    sndarray | 
+	    surfarray | 
+	    math
+	  

+
+	  
Other:
+	    camera | 
+	    controller | 
+	    examples | 
+	    fastevent | 
+	    scrap | 
+	    tests | 
+	    touch | 
+	    version
+	  

+

+

+  

+
+      

+          

+            
+

+

+

+pygame.image

+

+
pygame module for image transfer

+

+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
pygame.image.load

+		—load new image from a file (or file-like object)
pygame.image.save

+		—save an image to file (or file-like object)
pygame.image.get_sdl_image_version

+		—get version number of the SDL_Image library being used
pygame.image.get_extended

+		—test if extended image formats can be loaded
pygame.image.tostring

+		—transfer image to byte buffer
pygame.image.tobytes

+		—transfer image to byte buffer
pygame.image.fromstring

+		—create new Surface from a byte buffer
pygame.image.frombytes

+		—create new Surface from a byte buffer
pygame.image.frombuffer

+		—create a new Surface that shares data inside a bytes buffer
pygame.image.load_basic

+		—load new BMP image from a file (or file-like object)
pygame.image.load_extended

+		—load an image from a file (or file-like object)
pygame.image.save_extended

+		—save a png/jpg image to file (or file-like object)

+
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 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 (and PBM, PGM, PPM)
    • 
+
  • PCX
    • 
+
  • PNG
    • 
+
  • PNM
    • 
+
  • SVG (limited support, using Nano SVG)
    • 
+
  • TGA (uncompressed)
    • 
+
  • TIFF
    • 
+
  • WEBP
    • 
+
  • XPM
    • 
+

+

+

+
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.

+

+
    
+
  • BMP
    • 
+
  • JPEG
    • 
+
  • PNG
    • 
+
  • TGA
    • 
+

+

+
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(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.

+
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
+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 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
+returns True, you should be able to load most images (including PNG, JPG
+and GIF).

+
You should use os.path.join() for compatibility.

+
eg. asurf = pygame.image.load(os.path.join('data', 'bla.png'))
+

+

+

+
+

+

+pygame.image.save()

+

+
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
+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.

+

+

+
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.

+

+

+
+

+

+pygame.image.get_sdl_image_version()

+

+
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
+(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.

+

+
New in pygame 2.0.0.

+

+

+
Changed in pygame 2.2.0: linked keyword argument added and default behavior changed from returning compiled version to returning linked version

+

+

+
+

+

+pygame.image.get_extended()

+

+
test if extended image formats can be loaded

+
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.tostring()

+

+
transfer image to byte buffer

+
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 tobytes() as of pygame 2.1.3

+

+

+
New in pygame 2.1.3: BGRA format

+

+

+
+

+

+pygame.image.tobytes()

+

+
transfer image to byte buffer

+
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 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

+
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.

+

+

+
New in pygame 2.1.3.

+

+

+
+

+

+pygame.image.frombuffer()

+

+
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.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.fromstring()create new Surface from a byte buffer, 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
    • 
+

+

+

+
New in pygame 2.1.3: BGRA format

+

+

+
+

+

+pygame.image.load_basic()

+

+
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.

+

+
+

+

+pygame.image.load_extended()

+

+
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 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()

+

+
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.

+

+

+
+

+
+

+
+
+


+

+Edit on GitHub
+            

+          

+      

+      

+    

+    
+    
+  
+
\ No newline at end of file
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/ref/joystick.html b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/ref/joystick.html
new file mode 100644
index 0000000..5fc9703
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/ref/joystick.html
@@ -0,0 +1,1137 @@
+
+
+
+  
+    
+    
+
+    pygame.joystick — pygame v2.6.1 documentation
+    
+    
+    
+    
+    
+    
+    
+    
+    
+     
+    
+
+    

+
+  

+	

+	
+	

+	  

+	    Pygame Home ||
+	    Help Contents ||
+	    Reference Index
+
+        

+          
+          
+        

+	  

+	  

+	  
Most useful stuff:
+	    Color | 
+	    display | 
+	    draw | 
+	    event | 
+	    font | 
+	    image | 
+	    key | 
+	    locals | 
+	    mixer | 
+	    mouse | 
+	    Rect | 
+	    Surface | 
+	    time | 
+	    music | 
+	    pygame
+	  

+
+	  
Advanced stuff:
+	    cursors | 
+	    joystick | 
+	    mask | 
+	    sprite | 
+	    transform | 
+	    BufferProxy | 
+	    freetype | 
+	    gfxdraw | 
+	    midi | 
+	    PixelArray | 
+	    pixelcopy | 
+	    sndarray | 
+	    surfarray | 
+	    math
+	  

+
+	  
Other:
+	    camera | 
+	    controller | 
+	    examples | 
+	    fastevent | 
+	    scrap | 
+	    tests | 
+	    touch | 
+	    version
+	  

+

+

+  

+
+      

+          

+            
+

+

+

+pygame.joystick

+

+
Pygame module for interacting with joysticks, gamepads, and trackballs.

+

+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
pygame.joystick.init

+		—Initialize the joystick module.
pygame.joystick.quit

+		—Uninitialize the joystick module.
pygame.joystick.get_init

+		—Returns True if the joystick module is initialized.
pygame.joystick.get_count

+		—Returns the number of joysticks.
pygame.joystick.Joystick

+		—Create a new Joystick object.

+
The joystick module manages the joystick devices on a computer.
+Joystick devices include trackballs and video-game-style
+gamepads, and the module allows the use of multiple buttons and "hats".
+Computers may manage multiple joysticks at a time.

+
Each instance of the Joystick class represents one gaming device plugged
+into the computer. If a gaming pad has multiple joysticks on it, then the
+joystick object can actually represent multiple joysticks on that single
+game device.

+
For a quick way to initialise the joystick module and get a list of Joystick instances
+use the following code:

+
pygame.joystick.init()
+joysticks = [pygame.joystick.Joystick(x) for x in range(pygame.joystick.get_count())]
+

+

+
The following event types will be generated by the joysticks

+
JOYAXISMOTION JOYBALLMOTION JOYBUTTONDOWN JOYBUTTONUP JOYHATMOTION
+

+

+
And in pygame 2, which supports hotplugging:

+
JOYDEVICEADDED JOYDEVICEREMOVED
+

+

+
Note that in pygame 2, joysticks events use a unique "instance ID". The device index
+passed in the constructor to a Joystick object is not unique after devices have
+been added and removed. You must call Joystick.get_instance_id() to find
+the instance ID that was assigned to a Joystick on opening.

+
The event queue needs to be pumped frequently for some of the methods to work.
+So call one of pygame.event.get, pygame.event.wait, or pygame.event.pump regularly.

+
To be able to get joystick events and update the joystick objects while the window
+is not in focus, you may set the SDL_JOYSTICK_ALLOW_BACKGROUND_EVENTS environment
+variable. See environment variables for more details.

+

+

+pygame.joystick.init()

+

+
Initialize the joystick module.

+
init() -> None

+

+
This function is called automatically by pygame.init().

+
It initializes the joystick module. The module must be initialized before any
+other functions will work.

+
It is safe to call this function more than once.

+

+
+

+

+pygame.joystick.quit()

+

+
Uninitialize the joystick module.

+
quit() -> None

+

+
Uninitialize the joystick module. After you call this any existing joystick
+objects will no longer work.

+
It is safe to call this function more than once.

+

+
+

+

+pygame.joystick.get_init()

+

+
Returns True if the joystick module is initialized.

+
get_init() -> bool

+

+
Test if the pygame.joystick.init() function has been called.

+

+
+

+

+pygame.joystick.get_count()

+

+
Returns the number of joysticks.

+
get_count() -> count

+

+
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
+that must be lower than this count.

+

+
+

+

+pygame.joystick.Joystick

+

+
Create a new Joystick object.

+
Joystick(id) -> Joystick

+

+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
pygame.joystick.Joystick.init

+		—initialize the Joystick
pygame.joystick.Joystick.quit

+		—uninitialize the Joystick
pygame.joystick.Joystick.get_init

+		—check if the Joystick is initialized
pygame.joystick.Joystick.get_id

+		—get the device index (deprecated)
pygame.joystick.Joystick.get_instance_id

+		—get the joystick instance id
pygame.joystick.Joystick.get_guid

+		—get the joystick GUID
pygame.joystick.Joystick.get_power_level

+		—get the approximate power status of the device
pygame.joystick.Joystick.get_name

+		—get the Joystick system name
pygame.joystick.Joystick.get_numaxes

+		—get the number of axes on a Joystick
pygame.joystick.Joystick.get_axis

+		—get the current position of an axis
pygame.joystick.Joystick.get_numballs

+		—get the number of trackballs on a Joystick
pygame.joystick.Joystick.get_ball

+		—get the relative position of a trackball
pygame.joystick.Joystick.get_numbuttons

+		—get the number of buttons on a Joystick
pygame.joystick.Joystick.get_button

+		—get the current button state
pygame.joystick.Joystick.get_numhats

+		—get the number of hat controls on a Joystick
pygame.joystick.Joystick.get_hat

+		—get the position of a joystick hat
pygame.joystick.Joystick.rumble

+		—Start a rumbling effect
pygame.joystick.Joystick.stop_rumble

+		—Stop any rumble effect playing

+
Create a new joystick to access a physical device. The id argument must be a
+value from 0 to pygame.joystick.get_count() - 1.

+
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.

+

+

+

+init()

+

+
initialize the Joystick

+
init() -> None

+

+
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. Will be removed in Pygame 2.1.

+

+

+
+

+

+quit()

+

+
uninitialize the Joystick

+
quit() -> None

+

+
Close a Joystick object. After this the pygame event queue will no longer
+receive events from the device.

+
It is safe to call this more than once.

+

+
+

+

+get_init()

+

+
check if the Joystick is initialized

+
get_init() -> bool

+

+
Return True if the Joystick object is currently initialised.

+

+
+

+

+get_id()

+

+
get the device index (deprecated)

+
get_id() -> int

+

+
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. Will be removed in Pygame 2.1.

+

+

+
+

+

+get_instance_id() → int

+

+
get the joystick instance id

+
get_instance_id() -> int

+

+
Get the joystick instance ID. This matches the instance_id field
+that is given in joystick events.

+

+
New in pygame 2.0.0dev11.

+

+

+
+

+

+get_guid() → str

+

+
get the joystick GUID

+
get_guid() -> str

+

+
Get the GUID string. This identifies the exact hardware of the joystick
+device.

+

+
New in pygame 2.0.0dev11.

+

+

+
+

+

+get_power_level() → str

+

+
get the approximate power status of the device

+
get_power_level() -> str

+

+
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.

+

+

+
+

+

+get_name()

+

+
get the Joystick system name

+
get_name() -> string

+

+
Returns the system name for this joystick device. It is unknown what name
+the system will give to the Joystick, but it should be a unique name that
+identifies the device. This method can safely be called while the
+Joystick is not initialized.

+

+
+

+

+get_numaxes()

+

+
get the number of axes on a Joystick

+
get_numaxes() -> int

+

+
Returns the number of input axes are on a Joystick. There will usually be
+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
+generate a lot of rapid small motion events.

+

+
+

+

+get_axis()

+

+
get the current position of an axis

+
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
+position values.

+
The axis number must be an integer from 0 to get_numaxes() - 1.

+
When using gamepads both the control sticks and the analog triggers are
+usually reported as axes.

+

+
+

+

+get_numballs()

+

+
get the number of trackballs on a Joystick

+
get_numballs() -> int

+

+
Returns the number of trackball devices on a Joystick. These devices work
+similar to a mouse but they have no absolute position; they only have
+relative amounts of movement.

+
The pygame.JOYBALLMOTION event will be sent when the trackball is
+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

+

+
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.

+
The ball number must be an integer from 0 to get_numballs() - 1.

+

+
+

+

+get_numbuttons()

+

+
get the number of buttons on a Joystick

+
get_numbuttons() -> int

+

+
Returns the number of pushable buttons on the joystick. These buttons
+have a boolean (on or off) state.

+
Buttons generate a pygame.JOYBUTTONDOWN and pygame.JOYBUTTONUP
+event when they are pressed and released.

+

+
+

+

+get_button()

+

+
get the current button state

+
get_button(button) -> bool

+

+
Returns the current state of a joystick button.

+

+
+

+

+get_numhats()

+

+
get the number of hat controls on a Joystick

+
get_numhats() -> int

+

+
Returns the number of joystick hats on a Joystick. Hat devices are like
+miniature digital joysticks on a joystick. Each hat has two axes of
+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)
+means the hat is centered.

+

+
+

+

+get_hat()

+

+
get the position of a joystick hat

+
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
+up; (1, 1) means upper-right; etc.

+
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.

+

+
+

+

+rumble()

+

+
Start a rumbling effect

+
rumble(low_frequency, high_frequency, duration) -> bool

+

+
Start a rumble effect on the joystick, with the specified strength ranging
+from 0 to 1. Duration is length of the effect, in ms. Setting the duration
+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 or pygame.version.SDL()tupled integers of the SDL library version is below 2.0.9.

+

+
New in pygame 2.0.2.

+

+

+
+

+

+stop_rumble()

+

+
Stop any rumble effect playing

+
stop_rumble() -> None

+

+
Stops any rumble effect playing on the joystick. See
+Joystick.rumble() for more information.

+

+
New in pygame 2.0.2.

+

+

+
+

+
+

+joystick module example
+
+

+
Example code for joystick module.

+

+

+
import pygame
+
+pygame.init()
+
+
+# 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 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.time.Clock()
+
+    # Get ready to print.
+    text_print = TextPrint()
+
+    # 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 = {}
+
+    done = False
+    while not done:
+        # Event processing step.
+        # Possible joystick events: JOYAXISMOTION, JOYBALLMOTION, JOYBUTTONDOWN,
+        # JOYBUTTONUP, JOYHATMOTION, JOYDEVICEADDED, JOYDEVICEREMOVED
+        for event in pygame.event.get():
+            if event.type == pygame.QUIT:
+                done = True  # Flag that we are done so we exit this loop.
+
+            if event.type == pygame.JOYBUTTONDOWN:
+                print("Joystick button pressed.")
+                if event.button == 0:
+                    joystick = joysticks[event.instance_id]
+                    if joystick.rumble(0, 0.7, 500):
+                        print(f"Rumble effect played on joystick {event.instance_id}")
+
+            if event.type == pygame.JOYBUTTONUP:
+                print("Joystick button released.")
+
+            # Handle hotplugging
+            if event.type == pygame.JOYDEVICEADDED:
+                # This event will be generated when the program starts for every
+                # 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()} connencted")
+
+            if event.type == pygame.JOYDEVICEREMOVED:
+                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))
+        text_print.reset()
+
+        # Get count of joysticks.
+        joystick_count = pygame.joystick.get_count()
+
+        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()
+
+            text_print.tprint(screen, f"Joystick {jid}")
+            text_print.indent()
+
+            # Get the name from the OS for the controller/joystick.
+            name = joystick.get_name()
+            text_print.tprint(screen, f"Joystick name: {name}")
+
+            guid = joystick.get_guid()
+            text_print.tprint(screen, f"GUID: {guid}")
+
+            power_level = joystick.get_power_level()
+            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()
+            text_print.tprint(screen, f"Number of axes: {axes}")
+            text_print.indent()
+
+            for i in range(axes):
+                axis = joystick.get_axis(i)
+                text_print.tprint(screen, f"Axis {i} value: {axis:>6.3f}")
+            text_print.unindent()
+
+            buttons = joystick.get_numbuttons()
+            text_print.tprint(screen, f"Number of buttons: {buttons}")
+            text_print.indent()
+
+            for i in range(buttons):
+                button = joystick.get_button(i)
+                text_print.tprint(screen, f"Button {i:>2} value: {button}")
+            text_print.unindent()
+
+            hats = joystick.get_numhats()
+            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)
+                text_print.tprint(screen, f"Hat {i} value: {str(hat)}")
+            text_print.unindent()
+
+            text_print.unindent()
+
+        # Go ahead and update the screen with what we've drawn.
+        pygame.display.flip()
+
+        # Limit to 30 frames per second.
+        clock.tick(30)
+
+
+if __name__ == "__main__":
+    main()
+    # If you forget this line, the program will 'hang'
+    # on exit if running from IDLE.
+    pygame.quit()
+

+

+

+
+

+

+
Controller mappings are drawn from the underlying SDL library which pygame uses and they differ
+between pygame 1 and pygame 2. Below are a couple of mappings for three popular controllers.

+
Axis and hat mappings are listed from -1 to +1.

+

+
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"

+
    
+
  • 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      - 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"

+
    
+
  • Buttons:
    
+
    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      - Y Axis
+Left -> Right   - X Axis
+
    
+
    
+
    • 
+

+

+

+
Nintendo Switch Pro Controller (pygame 2.x)

+
The Nintendo Switch Pro Controller has 6 axes, 16 buttons, and 0 hats.
+The controller is recognized as "Nintendo Switch Pro Controller".

+
    
+
  • Left Stick:
    
+
    Left -> Right   - Axis 0
+Up -> Down      - Axis 1
+
    
+
    
+
    • 
+
  • Right Stick:
    
+
    Left -> Right   - Axis 2
+Up -> Down      - Axis 3
+
    
+
    
+
    • 
+
  • Left Trigger:
    
+
    Out -> In       - Axis 4
+
    
+
    
+
    • 
+
  • Right Trigger:
    
+
    Out -> In       - Axis 5
+
    
+
    
+
    • 
+
  • 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
+L. Stick In     - Button 7
+R. Stick In     - Button 8
+Left Bumper     - Button 9
+Right Bumper    - 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
+
    
+
    
+
    • 
+

+

+

+
XBox 360 Controller (pygame 2.x)

+
The Xbox 360 controller mapping has 6 axes, 11 buttons and 1 hat.
+The controller is recognized as "Xbox 360 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:
    
+
    A Button        - Button 0
+B Button        - Button 1
+X Button        - Button 2
+Y Button        - Button 3
+Left Bumper     - Button 4
+Right Bumper    - Button 5
+Back Button     - Button 6
+Start Button    - Button 7
+L. Stick In     - Button 8
+R. Stick In     - Button 9
+Guide Button    - Button 10
+
    
+
    
+
    • 
+
  • Hat/D-pad:
    
+
    Down -> Up      - Y Axis
+Left -> Right   - X Axis
+
    
+
    
+
    • 
+

+

+

+
Playstation 4 Controller (pygame 2.x)

+
The PlayStation 4 controller mapping has 6 axes and 16 buttons.
+The controller is recognized as "PS4 Controller".

+
    
+
  • Left Stick:
    
+
    Left -> Right   - Axis 0
+Up   -> Down    - Axis 1
+
    
+
    
+
    • 
+
  • Right Stick:
    
+
    Left -> Right   - Axis 2
+Up   -> Down    - Axis 3
+
    
+
    
+
    • 
+
  • Left Trigger:
    
+
    Out -> In       - Axis 4
+
    
+
    
+
    • 
+
  • Right Trigger:
    
+
    Out -> In       - Axis 5
+
    
+
    
+
    • 
+
  • Buttons:
    
+
    Cross Button    - Button 0
+Circle Button   - Button 1
+Square Button   - Button 2
+Triangle Button - Button 3
+Share Button    - Button 4
+PS Button       - Button 5
+Options Button  - Button 6
+L. Stick In     - Button 7
+R. Stick In     - Button 8
+Left Bumper     - Button 9
+Right Bumper    - Button 10
+D-pad Up        - Button 11
+D-pad Down      - Button 12
+D-pad Left      - Button 13
+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)

+
The Xbox 360 controller mapping has 5 axes, 10 buttons, and 1 hat.
+The controller is recognized as "Controller (XBOX 360 For Windows)".

+
    
+
  • Left Stick:
    
+
    Left -> Right   - Axis 0
+Up   -> Down    - Axis 1
+
    
+
    
+
    • 
+
  • Right Stick:
    
+
    Left -> Right   - Axis 4
+Up   -> Down    - Axis 3
+
    
+
    
+
    • 
+
  • Left Trigger & Right Trigger:
    
+
    RT -> LT        - Axis 2
+
    
+
    
+
    • 
+
  • Buttons:
    
+
    A Button        - Button 0
+B Button        - Button 1
+X Button        - Button 2
+Y Button        - Button 3
+Left Bumper     - Button 4
+Right Bumper    - Button 5
+Back Button     - Button 6
+Start Button    - Button 7
+L. Stick In     - Button 8
+R. Stick In     - Button 9
+
    
+
    
+
    • 
+
  • Hat/D-pad:
    
+
    Down -> Up      - Y Axis
+Left -> Right   - X Axis
+
    
+
    
+
    • 
+

+

+

+
Playstation 4 Controller (pygame 1.x)

+
The PlayStation 4 controller mapping has 6 axes, 14 buttons, and 1 hat.
+The controller is recognized as "Wireless Controller".

+
    
+
  • Left Stick:
    
+
    Left -> Right   - Axis 0
+Up   -> Down    - Axis 1
+
    
+
    
+
    • 
+
  • Right Stick:
    
+
    Left -> Right   - Axis 2
+Up   -> Down    - Axis 3
+
    
+
    
+
    • 
+
  • Left Trigger:
    
+
    Out -> In       - Axis 5
+
    
+
    
+
    • 
+
  • Right Trigger:
    
+
    Out -> In       - Axis 4
+
    
+
    
+
    • 
+
  • 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
+L. Trigger(Full)- Button 6
+R. Trigger(Full)- Button 7
+Share Button    - Button 8
+Options Button  - Button 9
+L. Stick In     - Button 10
+R. Stick In     - Button 11
+PS Button       - Button 12
+Touch Pad Click - Button 13
+
    
+
    
+
    • 
+
  • Hat/D-pad:
    
+
    Down -> Up      - Y Axis
+Left -> Right   - X Axis
+
    
+
    
+
    • 
+

+

+

+
+
+


+

+Edit on GitHub
+            

+          

+      

+      

+    

+    
+    
+  
+
\ No newline at end of file
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/ref/key.html b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/ref/key.html
new file mode 100644
index 0000000..01a0a5e
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/ref/key.html
@@ -0,0 +1,642 @@
+
+
+
+  
+    
+    
+
+    pygame.key — pygame v2.6.1 documentation
+    
+    
+    
+    
+    
+    
+    
+    
+    
+     
+    
+
+    

+
+  

+	

+	
+	

+	  

+	    Pygame Home ||
+	    Help Contents ||
+	    Reference Index
+
+        

+          
+          
+        

+	  

+	  

+	  
Most useful stuff:
+	    Color | 
+	    display | 
+	    draw | 
+	    event | 
+	    font | 
+	    image | 
+	    key | 
+	    locals | 
+	    mixer | 
+	    mouse | 
+	    Rect | 
+	    Surface | 
+	    time | 
+	    music | 
+	    pygame
+	  

+
+	  
Advanced stuff:
+	    cursors | 
+	    joystick | 
+	    mask | 
+	    sprite | 
+	    transform | 
+	    BufferProxy | 
+	    freetype | 
+	    gfxdraw | 
+	    midi | 
+	    PixelArray | 
+	    pixelcopy | 
+	    sndarray | 
+	    surfarray | 
+	    math
+	  

+
+	  
Other:
+	    camera | 
+	    controller | 
+	    examples | 
+	    fastevent | 
+	    scrap | 
+	    tests | 
+	    touch | 
+	    version
+	  

+

+

+  

+
+      

+          

+            
+

+

+

+pygame.key

+

+
pygame module to work with the keyboard

+

+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
pygame.key.get_focused

+		—true if the display is receiving keyboard input from the system
pygame.key.get_pressed

+		—get the state of all keyboard buttons
pygame.key.get_mods

+		—determine which modifier keys are being held
pygame.key.set_mods

+		—temporarily set which modifier keys are pressed
pygame.key.set_repeat

+		—control how held keys are repeated
pygame.key.get_repeat

+		—see how held keys are repeated
pygame.key.name

+		—get the name of a key identifier
pygame.key.key_code

+		—get the key identifier from a key name
pygame.key.start_text_input

+		—start handling Unicode text input events
pygame.key.stop_text_input

+		—stop handling Unicode text input events
pygame.key.set_text_input_rect

+		—controls the position of the candidate list

+
This module contains functions for dealing with the keyboard.

+
The pygame.eventpygame module for interacting with events and queues 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 integer ID representing every key
+on the keyboard
    • 
+
  • mod: a bitmask of all the 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
    • 
+

+

+

+
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.

+

+
The following is a list of all the constants (from pygame.localspygame constants) 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
+

+

+
The keyboard also has a list of modifier states (from pygame.localspygame constants) 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.')
+

+

+

+

+pygame.key.get_focused()

+

+
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
+system. If the display needs to ensure it does not lose keyboard focus, it
+can use pygame.event.set_grab()control the sharing of input devices with other applications to grab all input.

+

+
+

+

+pygame.key.get_pressed()

+

+
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
+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 pygame.eventpygame module for interacting with events and queues queue for this
+functionality.

+

+

+
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.

+

+

+
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.

+

+

+
+

+

+pygame.key.get_mods()

+

+
determine which modifier keys are being held

+
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
+modifier keys are pressed.

+

+
+

+

+pygame.key.set_mods()

+

+
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.

+

+
+

+

+pygame.key.set_repeat()

+

+
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
+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

+

+

+

+
Changed in pygame 2.0.0: A ValueError is now raised (instead of a
+pygame.error) if delay or interval is < 0.

+

+

+
+

+

+pygame.key.get_repeat()

+

+
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.

+

+
New in pygame 1.8.

+

+

+
+

+

+pygame.key.name()

+

+
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.
+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)

+

+
Changed in pygame 2.1.3: Added use_compat argument and guaranteed API stability for it

+

+

+
+

+

+pygame.key.key_code()

+

+
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:

+
>>> 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.

+

+

+

+
New in pygame 2.0.0.

+

+

+
+

+

+pygame.key.start_text_input()

+

+
start handling Unicode text input events

+
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.

+

+
New in pygame 2.0.0.

+

+

+
+

+

+pygame.key.stop_text_input()

+

+
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(), 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.

+

+

+
+

+

+pygame.key.set_text_input_rect()

+

+
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.

+

+

+
+

+
+

+
+
+


+

+Edit on GitHub
+            

+          

+      

+      

+    

+    
+    
+  
+
\ No newline at end of file
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/ref/locals.html b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/ref/locals.html
new file mode 100644
index 0000000..6ffbbbf
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/ref/locals.html
@@ -0,0 +1,157 @@
+
+
+
+  
+    
+    
+
+    pygame.locals — pygame v2.6.1 documentation
+    
+    
+    
+    
+    
+    
+    
+    
+    
+     
+    
+
+    

+
+  

+	

+	
+	

+	  

+	    Pygame Home ||
+	    Help Contents ||
+	    Reference Index
+
+        

+          
+          
+        

+	  

+	  

+	  
Most useful stuff:
+	    Color | 
+	    display | 
+	    draw | 
+	    event | 
+	    font | 
+	    image | 
+	    key | 
+	    locals | 
+	    mixer | 
+	    mouse | 
+	    Rect | 
+	    Surface | 
+	    time | 
+	    music | 
+	    pygame
+	  

+
+	  
Advanced stuff:
+	    cursors | 
+	    joystick | 
+	    mask | 
+	    sprite | 
+	    transform | 
+	    BufferProxy | 
+	    freetype | 
+	    gfxdraw | 
+	    midi | 
+	    PixelArray | 
+	    pixelcopy | 
+	    sndarray | 
+	    surfarray | 
+	    math
+	  

+
+	  
Other:
+	    camera | 
+	    controller | 
+	    examples | 
+	    fastevent | 
+	    scrap | 
+	    tests | 
+	    touch | 
+	    version
+	  

+

+

+  

+
+      

+          

+            
+

+

+

+pygame.locals

+

+
pygame constants

+

+
This module contains various constants used by pygame. Its contents are
+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 documentation. Here are the locations of some of them.

+

+

+

+

+
+

+
+
+


+

+Edit on GitHub
+            

+          

+      

+      

+    

+    
+    
+  
+
\ No newline at end of file
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/ref/mask.html b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/ref/mask.html
new file mode 100644
index 0000000..2ee1626
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/ref/mask.html
@@ -0,0 +1,1109 @@
+
+
+
+  
+    
+    
+
+    pygame.mask — pygame v2.6.1 documentation
+    
+    
+    
+    
+    
+    
+    
+    
+    
+     
+    
+
+    

+
+  

+	

+	
+	

+	  

+	    Pygame Home ||
+	    Help Contents ||
+	    Reference Index
+
+        

+          
+          
+        

+	  

+	  

+	  
Most useful stuff:
+	    Color | 
+	    display | 
+	    draw | 
+	    event | 
+	    font | 
+	    image | 
+	    key | 
+	    locals | 
+	    mixer | 
+	    mouse | 
+	    Rect | 
+	    Surface | 
+	    time | 
+	    music | 
+	    pygame
+	  

+
+	  
Advanced stuff:
+	    cursors | 
+	    joystick | 
+	    mask | 
+	    sprite | 
+	    transform | 
+	    BufferProxy | 
+	    freetype | 
+	    gfxdraw | 
+	    midi | 
+	    PixelArray | 
+	    pixelcopy | 
+	    sndarray | 
+	    surfarray | 
+	    math
+	  

+
+	  
Other:
+	    camera | 
+	    controller | 
+	    examples | 
+	    fastevent | 
+	    scrap | 
+	    tests | 
+	    touch | 
+	    version
+	  

+

+

+  

+
+      

+          

+            
+

+

+

+pygame.mask

+

+
pygame module for image masks.

+

+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
pygame.mask.from_surface

+		—Creates a Mask from the given surface
pygame.mask.from_threshold

+		—Creates a mask by thresholding Surfaces
pygame.mask.Mask

+		—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.

+

+

+

+pygame.mask.from_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
+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.

+

+
Parameters:

+
    
+
  • surface (Surface) -- the surface to create the mask from
    • 
+
  • threshold (int) -- (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 Mask object from the given surface

+

+
Return type:

+
Mask

+

+

+

+
Note

+
This function is used to create the masks for
+pygame.sprite.collide_mask()Collision detection between two sprites, using masks..

+

+

+
+

+

+pygame.mask.from_threshold()

+

+
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.

+
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.

+

+
Parameters:

+
    
+
  • surface (Surface) -- the surface to create the mask from
    • 
+
  • 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 (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
+from this surface (default is None)
    • 
+
  • palette_colors (int) -- (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 Mask object from the given surface

+

+
Return type:

+
Mask

+

+

+

+
+

+

+pygame.mask.Mask

+

+
pygame object for representing 2D bitmasks

+
Mask(size=(width, height)) -> Mask

+
Mask(size=(width, height), fill=False) -> Mask

+

+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
pygame.mask.Mask.copy

+		—Returns a new copy of the mask
pygame.mask.Mask.get_size

+		—Returns the size of the mask
pygame.mask.Mask.get_rect

+		—Returns a Rect based on the size of the mask
pygame.mask.Mask.get_at

+		—Gets the bit at the given position
pygame.mask.Mask.set_at

+		—Sets the bit at the given position
pygame.mask.Mask.overlap

+		—Returns the point of intersection
pygame.mask.Mask.overlap_area

+		—Returns the number of overlapping set bits
pygame.mask.Mask.overlap_mask

+		—Returns a mask of the overlapping set bits
pygame.mask.Mask.fill

+		—Sets all bits to 1
pygame.mask.Mask.clear

+		—Sets all bits to 0
pygame.mask.Mask.invert

+		—Flips all the bits
pygame.mask.Mask.scale

+		—Resizes a mask
pygame.mask.Mask.draw

+		—Draws a mask onto another
pygame.mask.Mask.erase

+		—Erases a mask from another
pygame.mask.Mask.count

+		—Returns the number of set bits
pygame.mask.Mask.centroid

+		—Returns the centroid of the set bits
pygame.mask.Mask.angle

+		—Returns the orientation of the set bits
pygame.mask.Mask.outline

+		—Returns a list of points outlining an object
pygame.mask.Mask.convolve

+		—Returns the convolution of this mask with another mask
pygame.mask.Mask.connected_component

+		—Returns a mask containing a connected component
pygame.mask.Mask.connected_components

+		—Returns a list of masks of connected components
pygame.mask.Mask.get_bounding_rects

+		—Returns a list of bounding rects of connected components
pygame.mask.Mask.to_surface

+		—Returns a surface with the mask drawn on it

+
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 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
+methods.

+
The methods overlap(), overlap_area(), overlap_mask(),
+draw(), erase(), and 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 |
+           +--------------+
+

+

+

+
Parameters:

+
    
+
  • size -- the dimensions of the mask (width and height)
    • 
+
  • fill (bool) -- (optional) create an unfilled mask (default: False) or
+filled mask (True)
    • 
+

+

+
Returns:

+
a newly created Mask object

+

+
Return type:

+
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.

+

+

+

+copy()

+

+
Returns a new copy of the mask

+
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

+

+
Return type:

+
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
+

+

+

+

+
New in pygame 2.0.0.

+

+

+
+

+

+get_size()

+

+
Returns the size of the mask

+
get_size() -> (width, height)

+

+

+
Returns:

+
the size of the mask, (width, height)

+

+
Return type:

+
tuple(int, int)

+

+

+

+
+

+

+get_rect()

+

+
Returns a Rect based on the size of the mask

+
get_rect(**kwargs) -> Rect

+

+
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.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.Rect()pygame object for storing rectangular coordinates based on the mask's size centered at the
+given position.

+

+
Parameters:

+
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.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.

+

+

+
+

+

+get_at()

+

+
Gets the bit at the given position

+
get_at(pos) -> int

+

+

+
Parameters:

+
pos -- the position of the bit to get (x, y)

+

+
Returns:

+
1 if the bit is set, 0 if the bit is not set

+

+
Return type:

+
int

+

+
Raises:

+
IndexError -- if the position is outside of the mask's bounds

+

+

+

+
+

+

+set_at()

+

+
Sets the bit at the given position

+
set_at(pos) -> None

+
set_at(pos, value=1) -> None

+

+

+
Parameters:

+
    
+
  • pos -- the position of the bit to set (x, y)
    • 
+
  • value (int) -- any nonzero int will set the bit to 1, 0 will set the
+bit to 0 (default is 1)
    • 
+

+

+
Returns:

+
None

+

+
Return type:

+
NoneType

+

+
Raises:

+
IndexError -- if the position is outside of the mask's bounds

+

+

+

+
+

+

+overlap()

+

+
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.

+
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.

+

+
Parameters:

+
    
+
  • other (Mask) -- the other mask to overlap with this mask
    • 
+
  • offset -- the offset of other from this mask, for more
+details refer to the Mask offset notes
    • 
+

+

+
Returns:

+
point of intersection or None if no intersection

+

+
Return type:

+
tuple(int, int) or NoneType

+

+

+

+
+

+

+overlap_area()

+

+
Returns the number of overlapping set bits

+
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))
+

+

+

+
Parameters:

+
    
+
  • other (Mask) -- the other mask to overlap with this mask
    • 
+
  • offset -- the offset of other from this mask, for more
+details refer to the Mask offset notes
    • 
+

+

+
Returns:

+
the number of overlapping set bits

+

+
Return type:

+
int

+

+

+

+
+

+

+overlap_mask()

+

+
Returns a mask of the overlapping set bits

+
overlap_mask(other, offset) -> Mask

+

+
Returns a Mask, the same size as this mask, containing the
+overlapping set bits between this mask and other.

+

+
Parameters:

+
    
+
  • other (Mask) -- the other mask to overlap with this mask
    • 
+
  • offset -- the offset of other from this mask, for more
+details refer to the Mask offset notes
    • 
+

+

+
Returns:

+
a newly created Mask with the overlapping bits set

+

+
Return type:

+
Mask

+

+

+

+
+

+

+fill()

+

+
Sets all bits to 1

+
fill() -> None

+

+
Sets all bits in the mask to 1.

+

+
Returns:

+
None

+

+
Return type:

+
NoneType

+

+

+

+
+

+

+clear()

+

+
Sets all bits to 0

+
clear() -> None

+

+
Sets all bits in the mask to 0.

+

+
Returns:

+
None

+

+
Return type:

+
NoneType

+

+

+

+
+

+

+invert()

+

+
Flips all the bits

+
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

+

+
Return type:

+
NoneType

+

+

+

+
+

+

+scale()

+

+
Resizes a mask

+
scale((width, height)) -> Mask

+

+
Creates a new Mask of the requested size with its bits scaled
+from this mask.

+

+
Parameters:

+
size -- the width and height (size) of the mask to create

+

+
Returns:

+
a new Mask object with its bits scaled from this mask

+

+
Return type:

+
Mask

+

+
Raises:

+
ValueError -- if width < 0 or height < 0

+

+

+

+
+

+

+draw()

+

+
Draws a mask onto another

+
draw(other, offset) -> None

+

+
Performs a bitwise OR, drawing othermask onto this mask.

+

+
Parameters:

+
    
+
  • other (Mask) -- the mask to draw onto this mask
    • 
+
  • offset -- the offset of other from this mask, for more
+details refer to the Mask offset notes
    • 
+

+

+
Returns:

+
None

+

+
Return type:

+
NoneType

+

+

+

+
+

+

+erase()

+

+
Erases a mask from another

+
erase(other, offset) -> None

+

+
Erases (clears) all bits set in other from this mask.

+

+
Parameters:

+
    
+
  • other (Mask) -- the mask to erase from this mask
    • 
+
  • offset -- the offset of other from this mask, for more
+details refer to the Mask offset notes
    • 
+

+

+
Returns:

+
None

+

+
Return type:

+
NoneType

+

+

+

+
+

+

+count()

+

+
Returns the number of set bits

+
count() -> bits

+

+

+
Returns:

+
the number of set bits in the mask

+

+
Return type:

+
int

+

+

+

+
+

+

+centroid()

+

+
Returns the centroid of the set bits

+
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

+

+
Return type:

+
tuple(int, int)

+

+

+

+
+

+

+angle()

+

+
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
+connected component.

+

+
Returns:

+
the orientation of the set bits in the mask, it will return
+0.0 if the mask has no bits set

+

+
Return type:

+
float

+

+

+

+
Note

+
See connected_component() for details on how a connected
+component is calculated.

+

+

+
+

+

+outline()

+

+
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
+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.

+

+
Parameters:

+
every (int) -- (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

+

+
Return type:

+
list[tuple(int, int)]

+

+

+

+
Note

+
See connected_component() for details on how a connected
+component is calculated.

+

+

+
+

+

+convolve()

+

+
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.

+

+
Parameters:

+
    
+
  • other (Mask) -- mask to convolve this mask with
    • 
+
  • output (Mask or NoneType) -- (optional) mask for output (default is None)
    • 
+
  • offset -- the offset of other from this mask, (default is
+(0, 0))
    • 
+

+

+
Returns:

+
a 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.

+

+

+
Return type:

+
Mask

+

+

+

+
+

+

+connected_component()

+

+
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
+connectivity, is used to find a connected component in the mask.

+
By default this method will return a 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 Mask will
+be empty (no bits set).

+

+
Parameters:

+
pos -- (optional) selects the connected component that contains the
+bit at this position

+

+
Returns:

+
a 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.

+

+

+
Return type:

+
Mask

+

+
Raises:

+
IndexError -- if the optional pos parameter is outside of the
+mask's bounds

+

+

+

+
+

+

+connected_components()

+

+
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.

+

+
Parameters:

+
minimum (int) -- (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 Mask object for each connected
+component, an empty list is returned if the mask has no bits set

+

+
Return type:

+
list[Mask]

+

+

+

+
Note

+
See connected_component() for details on how a connected
+component is calculated.

+

+

+
+

+

+get_bounding_rects()

+

+
Returns a list of bounding rects of connected components

+
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

+

+
Return type:

+
list[Rect]

+

+

+

+
Note

+
See connected_component() for details on how a connected
+component is calculated.

+

+

+
+

+

+to_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.

+

+
Parameters:

+
    
+
  • surface (Surface or None) -- (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)
    • 
+
  • setsurface (Surface or None) -- (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
    • 
+
  • unsetsurface (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 (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 (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
    • 
+
  • dest (Rect or tuple(int, int) or list(int, int) or Vector2(int, int)) -- (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)
    • 
+

+

+
Returns:

+
the surface parameter (or a newly created surface if no
+surface parameter was provided) with this mask drawn on it

+

+
Return type:

+
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.

+

+

+
New in pygame 2.0.0.

+

+

+
+

+
+

+
+

+
+
+


+

+Edit on GitHub
+            

+          

+      

+      

+    

+    
+    
+  
+
\ No newline at end of file
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/ref/math.html b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/ref/math.html
new file mode 100644
index 0000000..df8d956
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/ref/math.html
@@ -0,0 +1,1818 @@
+
+
+
+  
+    
+    
+
+    pygame.math — pygame v2.6.1 documentation
+    
+    
+    
+    
+    
+    
+    
+    
+    
+     
+    
+
+    

+
+  

+	

+	
+	

+	  

+	    Pygame Home ||
+	    Help Contents ||
+	    Reference Index
+
+        

+          
+          
+        

+	  

+	  

+	  
Most useful stuff:
+	    Color | 
+	    display | 
+	    draw | 
+	    event | 
+	    font | 
+	    image | 
+	    key | 
+	    locals | 
+	    mixer | 
+	    mouse | 
+	    Rect | 
+	    Surface | 
+	    time | 
+	    music | 
+	    pygame
+	  

+
+	  
Advanced stuff:
+	    cursors | 
+	    joystick | 
+	    mask | 
+	    sprite | 
+	    transform | 
+	    BufferProxy | 
+	    freetype | 
+	    gfxdraw | 
+	    midi | 
+	    PixelArray | 
+	    pixelcopy | 
+	    sndarray | 
+	    surfarray | 
+	    math
+	  

+
+	  
Other:
+	    camera | 
+	    controller | 
+	    examples | 
+	    fastevent | 
+	    scrap | 
+	    tests | 
+	    touch | 
+	    version
+	  

+

+

+  

+
+      

+          

+            
+

+

+

+pygame.math

+

+
pygame module for vector classes

+

+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
pygame.math.clamp

+		—returns value clamped to min and max.
pygame.math.lerp

+		—interpolates between two values by a weight.
pygame.math.Vector2

+		—a 2-Dimensional Vector
pygame.math.Vector3

+		—a 3-Dimensional Vector

+
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 using slices or swizzling

+
v = pygame.Vector2()
+v.xy = 1, 2
+v[:] = 1, 2
+

+

+

+
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 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

+

+
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 2.1.3.

+

+

+
+

+

+pygame.math.lerp()

+

+
interpolates between two values by a weight.

+
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].

+

+
New in pygame 2.1.3.

+

+

+
+

+

+pygame.math.Vector2

+

+
a 2-Dimensional Vector

+
Vector2() -> Vector2(0, 0)

+
Vector2(int) -> Vector2

+
Vector2(float) -> Vector2

+
Vector2(Vector2) -> Vector2

+
Vector2(x, y) -> Vector2

+
Vector2((x, y)) -> Vector2

+

+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
pygame.math.Vector2.dot

+		—calculates the dot- or scalar-product with the other vector
pygame.math.Vector2.cross

+		—calculates the cross- or vector-product
pygame.math.Vector2.magnitude

+		—returns the Euclidean magnitude of the vector.
pygame.math.Vector2.magnitude_squared

+		—returns the squared magnitude of the vector.
pygame.math.Vector2.length

+		—returns the Euclidean length of the vector.
pygame.math.Vector2.length_squared

+		—returns the squared Euclidean length of the vector.
pygame.math.Vector2.normalize

+		—returns a vector with the same direction but length 1.
pygame.math.Vector2.normalize_ip

+		—normalizes the vector in place so that its length is 1.
pygame.math.Vector2.is_normalized

+		—tests if the vector is normalized i.e. has length == 1.
pygame.math.Vector2.scale_to_length

+		—scales the vector to a given length.
pygame.math.Vector2.reflect

+		—returns a vector reflected of a given normal.
pygame.math.Vector2.reflect_ip

+		—reflect the vector of a given normal in place.
pygame.math.Vector2.distance_to

+		—calculates the Euclidean distance to a given vector.
pygame.math.Vector2.distance_squared_to

+		—calculates the squared Euclidean distance to a given vector.
pygame.math.Vector2.move_towards

+		—returns a vector moved toward the target by a given distance.
pygame.math.Vector2.move_towards_ip

+		—moves the vector toward its target at a given distance.
pygame.math.Vector2.lerp

+		—returns a linear interpolation to the given vector.
pygame.math.Vector2.slerp

+		—returns a spherical interpolation to the given vector.
pygame.math.Vector2.elementwise

+		—The next operation will be performed elementwise.
pygame.math.Vector2.rotate

+		—rotates a vector by a given angle in degrees.
pygame.math.Vector2.rotate_rad

+		—rotates a vector by a given angle in radians.
pygame.math.Vector2.rotate_ip

+		—rotates the vector by a given angle in degrees in place.
pygame.math.Vector2.rotate_ip_rad

+		—rotates the vector by a given angle in radians in place.
pygame.math.Vector2.rotate_rad_ip

+		—rotates the vector by a given angle in radians in place.
pygame.math.Vector2.angle_to

+		—calculates the angle to a given vector in degrees.
pygame.math.Vector2.as_polar

+		—returns a tuple with radial distance and azimuthal angle.
pygame.math.Vector2.from_polar

+		—Creates a Vector2(x, y) or sets x and y from a polar coordinates tuple.
pygame.math.Vector2.project

+		—projects a vector onto another.
pygame.math.Vector2.copy

+		—Returns a copy of itself.
pygame.math.Vector2.clamp_magnitude

+		—Returns a copy of a vector with the magnitude clamped between max_length and min_length.
pygame.math.Vector2.clamp_magnitude_ip

+		—Clamps the vector's magnitude between max_length and min_length
pygame.math.Vector2.update

+		—Sets the coordinates of the vector.
pygame.math.Vector2.epsilon

+		—Determines the tolerance of vector calculations.

+
Some general information about the Vector2 class.

+

+
Changed in pygame 2.1.3: Inherited methods of vector subclasses now correctly return an instance of the
+subclass instead of the superclass

+

+

+

+dot()

+

+
calculates the dot- or scalar-product with the other vector

+
dot(Vector2) -> float

+

+

+
+

+

+cross()

+

+
calculates the cross- or vector-product

+
cross(Vector2) -> float

+

+
calculates the third component of the cross-product.

+

+
+

+

+magnitude()

+

+
returns the Euclidean magnitude of the vector.

+
magnitude() -> float

+

+
calculates the magnitude of the vector which follows from the
+theorem: vec.magnitude() == math.sqrt(vec.x**2 + vec.y**2)

+

+
+

+

+magnitude_squared()

+

+
returns the squared magnitude of the vector.

+
magnitude_squared() -> float

+

+
calculates the magnitude of the vector which follows from the
+theorem: vec.magnitude_squared() == vec.x**2 + vec.y**2. This
+is faster than vec.magnitude() because it avoids the square root.

+

+
+

+

+length()

+

+
returns the Euclidean length of the vector.

+
length() -> float

+

+
calculates the Euclidean length of the vector which follows from the
+Pythagorean theorem: vec.length() == math.sqrt(vec.x**2 + vec.y**2)

+

+
+

+

+length_squared()

+

+
returns the squared Euclidean length of the vector.

+
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.
+This is faster than vec.length() because it avoids the square root.

+

+
+

+

+normalize()

+

+
returns a vector with the same direction but length 1.

+
normalize() -> Vector2

+

+
Returns a new vector that has length equal to 1 and the same
+direction as self.

+

+
+

+

+normalize_ip()

+

+
normalizes the vector in place so that its length is 1.

+
normalize_ip() -> None

+

+
Normalizes the vector so that it has length equal to 1.
+The direction of the vector is not changed.

+

+
+

+

+is_normalized()

+

+
tests if the vector is normalized i.e. has length == 1.

+
is_normalized() -> Bool

+

+
Returns True if the vector has length equal to 1. Otherwise
+it returns False.

+

+
+

+

+scale_to_length()

+

+
scales the vector to a given length.

+
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
+is the zero vector (i.e. has length 0 thus no direction) a
+ValueError is raised.

+

+
+

+

+reflect()

+

+
returns a vector reflected of a given normal.

+
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
+new vector is the same as self's.

+

+
+

+

+reflect_ip()

+

+
reflect the vector of a given normal in place.

+
reflect_ip(Vector2) -> None

+

+
Changes the direction of self as if it would have been reflected of a
+surface with the given surface normal.

+

+
+

+

+distance_to()

+

+
calculates the Euclidean distance to a given vector.

+
distance_to(Vector2) -> float

+

+

+
+

+

+distance_squared_to()

+

+
calculates the squared Euclidean distance to a given vector.

+
distance_squared_to(Vector2) -> float

+

+

+
+

+

+move_towards()

+

+
returns a vector moved toward the target by a given distance.

+
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 2.1.3.

+

+

+
+

+

+move_towards_ip()

+

+
moves the vector toward its target at a given distance.

+
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 2.1.3.

+

+

+
+

+

+lerp()

+

+
returns a linear interpolation to the given vector.

+
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.

+

+
+

+

+slerp()

+

+
returns a spherical interpolation to the given vector.

+
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
+parametrizes where - in between the two vectors - the result should be.
+If a negative value is given the interpolation will not take the
+complement of the shortest path.

+

+
+

+

+elementwise()

+

+
The next operation will be performed elementwise.

+
elementwise() -> VectorElementwiseProxy

+

+
Applies the following operation to each element of the vector.

+

+
+

+

+rotate()

+

+
rotates a vector by a given angle in degrees.

+
rotate(angle) -> Vector2

+

+
Returns a vector which has the same length as self but is rotated
+counterclockwise by the given angle in degrees.
+(Note that due to pygame's inverted y coordinate system, the rotation
+will look clockwise if displayed).

+

+
+

+

+rotate_rad()

+

+
rotates a vector by a given angle in radians.

+
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.

+

+

+
+

+

+rotate_ip()

+

+
rotates the vector by a given angle in degrees in place.

+
rotate_ip(angle) -> None

+

+
Rotates the vector counterclockwise by the given angle in degrees. 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).

+

+
+

+

+rotate_ip_rad()

+

+
rotates the vector by a given angle in radians in place.

+
rotate_ip_rad(angle) -> None

+

+
DEPRECATED: Use rotate_rad_ip() instead.

+

+
New in pygame 2.0.0.

+

+

+
Deprecated since pygame 2.1.1.

+

+

+
+

+

+rotate_rad_ip()

+

+
rotates the vector by a given angle in radians in place.

+
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.

+

+

+
+

+

+angle_to()

+

+
calculates the angle to a given vector in degrees.

+
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

+

+

+

+
+

+

+as_polar()

+

+
returns a tuple with radial distance and azimuthal angle.

+
as_polar() -> (r, phi)

+

+
Returns a tuple (r, phi) where r is the radial distance, and phi
+is the azimuthal angle.

+

+
+

+

+from_polar()

+

+
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

+

+
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.

+

+
+

+

+project()

+

+
projects a vector onto another.

+
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.

+

+

+
+

+

+copy()

+

+
Returns a copy of itself.

+
copy() -> Vector2

+

+
Returns a new Vector2 having the same dimensions.

+

+
New in pygame 2.1.1.

+

+

+
+

+

+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

+

+
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 2.1.3.

+

+

+
+

+

+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

+

+
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 2.1.3.

+

+

+
+

+

+update()

+

+
Sets the coordinates of the vector.

+
update() -> None

+
update(int) -> None

+
update(float) -> None

+
update(Vector2) -> None

+
update(x, y) -> None

+
update((x, y)) -> None

+

+
Sets coordinates x and y in place.

+

+
New in pygame 1.9.5.

+

+

+
+

+

+epsilon

+

+
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:

+

+
    
+
  • comparing Vectors (== and !=)
    • 
+
  • the is_normalized method (if the square of the length is within epsilon of 1, it's normalized)
    • 
+
  • slerping (a Vector with a length of <epsilon is considered a zero vector, and can't slerp with that)
    • 
+
  • reflection (can't reflect over the zero vector)
    • 
+
  • projection (can't project onto the zero vector)
    • 
+
  • rotation (only used when rotating by a multiple of 90 degrees)
    • 
+

+

+
While it's possible to change epsilon for a specific instance of a Vector, all the other Vectors
+will retain the default value. Changing epsilon on a specific instance however could lead to some
+asymmetric behavior where symmetry would be expected, such as

+
u = pygame.Vector2(0, 1)
+v = pygame.Vector2(0, 1.2)
+u.epsilon = 0.5 # don't set it nearly this large
+
+print(u == v) # >> True
+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
+might help you out.

+

+
+

+
+

+

+pygame.math.Vector3

+

+
a 3-Dimensional Vector

+
Vector3() -> Vector3(0, 0, 0)

+
Vector3(int) -> Vector3

+
Vector3(float) -> Vector3

+
Vector3(Vector3) -> Vector3

+
Vector3(x, y, z) -> Vector3

+
Vector3((x, y, z)) -> Vector3

+

+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
pygame.math.Vector3.dot

+		—calculates the dot- or scalar-product with the other vector
pygame.math.Vector3.cross

+		—calculates the cross- or vector-product
pygame.math.Vector3.magnitude

+		—returns the Euclidean magnitude of the vector.
pygame.math.Vector3.magnitude_squared

+		—returns the squared Euclidean magnitude of the vector.
pygame.math.Vector3.length

+		—returns the Euclidean length of the vector.
pygame.math.Vector3.length_squared

+		—returns the squared Euclidean length of the vector.
pygame.math.Vector3.normalize

+		—returns a vector with the same direction but length 1.
pygame.math.Vector3.normalize_ip

+		—normalizes the vector in place so that its length is 1.
pygame.math.Vector3.is_normalized

+		—tests if the vector is normalized i.e. has length == 1.
pygame.math.Vector3.scale_to_length

+		—scales the vector to a given length.
pygame.math.Vector3.reflect

+		—returns a vector reflected of a given normal.
pygame.math.Vector3.reflect_ip

+		—reflect the vector of a given normal in place.
pygame.math.Vector3.distance_to

+		—calculates the Euclidean distance to a given vector.
pygame.math.Vector3.distance_squared_to

+		—calculates the squared Euclidean distance to a given vector.
pygame.math.Vector3.move_towards

+		—returns a vector moved toward the target by a given distance.
pygame.math.Vector3.move_towards_ip

+		—moves the vector toward its target at a given distance.
pygame.math.Vector3.lerp

+		—returns a linear interpolation to the given vector.
pygame.math.Vector3.slerp

+		—returns a spherical interpolation to the given vector.
pygame.math.Vector3.elementwise

+		—The next operation will be performed elementwise.
pygame.math.Vector3.rotate

+		—rotates a vector by a given angle in degrees.
pygame.math.Vector3.rotate_rad

+		—rotates a vector by a given angle in radians.
pygame.math.Vector3.rotate_ip

+		—rotates the vector by a given angle in degrees in place.
pygame.math.Vector3.rotate_ip_rad

+		—rotates the vector by a given angle in radians in place.
pygame.math.Vector3.rotate_rad_ip

+		—rotates the vector by a given angle in radians in place.
pygame.math.Vector3.rotate_x

+		—rotates a vector around the x-axis by the angle in degrees.
pygame.math.Vector3.rotate_x_rad

+		—rotates a vector around the x-axis by the angle in radians.
pygame.math.Vector3.rotate_x_ip

+		—rotates the vector around the x-axis by the angle in degrees in place.
pygame.math.Vector3.rotate_x_ip_rad

+		—rotates the vector around the x-axis by the angle in radians in place.
pygame.math.Vector3.rotate_x_rad_ip

+		—rotates the vector around the x-axis by the angle in radians in place.
pygame.math.Vector3.rotate_y

+		—rotates a vector around the y-axis by the angle in degrees.
pygame.math.Vector3.rotate_y_rad

+		—rotates a vector around the y-axis by the angle in radians.
pygame.math.Vector3.rotate_y_ip

+		—rotates the vector around the y-axis by the angle in degrees in place.
pygame.math.Vector3.rotate_y_ip_rad

+		—rotates the vector around the y-axis by the angle in radians in place.
pygame.math.Vector3.rotate_y_rad_ip

+		—rotates the vector around the y-axis by the angle in radians in place.
pygame.math.Vector3.rotate_z

+		—rotates a vector around the z-axis by the angle in degrees.
pygame.math.Vector3.rotate_z_rad

+		—rotates a vector around the z-axis by the angle in radians.
pygame.math.Vector3.rotate_z_ip

+		—rotates the vector around the z-axis by the angle in degrees in place.
pygame.math.Vector3.rotate_z_ip_rad

+		—rotates the vector around the z-axis by the angle in radians in place.
pygame.math.Vector3.rotate_z_rad_ip

+		—rotates the vector around the z-axis by the angle in radians in place.
pygame.math.Vector3.angle_to

+		—calculates the angle to a given vector in degrees.
pygame.math.Vector3.as_spherical

+		—returns a tuple with radial distance, inclination and azimuthal angle.
pygame.math.Vector3.from_spherical

+		—Creates a Vector3(x, y, z) or sets x, y and z from a spherical coordinates 3-tuple.
pygame.math.Vector3.project

+		—projects a vector onto another.
pygame.math.Vector3.copy

+		—Returns a copy of itself.
pygame.math.Vector3.clamp_magnitude

+		—Returns a copy of a vector with the magnitude clamped between max_length and min_length.
pygame.math.Vector3.clamp_magnitude_ip

+		—Clamps the vector's magnitude between max_length and min_length
pygame.math.Vector3.update

+		—Sets the coordinates of the vector.
pygame.math.Vector3.epsilon

+		—Determines the tolerance of vector calculations.

+
Some general information about the Vector3 class.

+

+
Changed in pygame 2.1.3: Inherited methods of vector subclasses now correctly return an instance of the
+subclass instead of the superclass

+

+

+

+dot()

+

+
calculates the dot- or scalar-product with the other vector

+
dot(Vector3) -> float

+

+

+
+

+

+cross()

+

+
calculates the cross- or vector-product

+
cross(Vector3) -> Vector3

+

+
calculates the cross-product.

+

+
+

+

+magnitude()

+

+
returns the Euclidean magnitude of the vector.

+
magnitude() -> float

+

+
calculates the magnitude of the vector which follows from the
+theorem: vec.magnitude() == math.sqrt(vec.x**2 + vec.y**2 + vec.z**2)

+

+
+

+

+magnitude_squared()

+

+
returns the squared Euclidean magnitude of the vector.

+
magnitude_squared() -> float

+

+
calculates the magnitude of the vector which follows from the
+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.

+

+
+

+

+length()

+

+
returns the Euclidean length of the vector.

+
length() -> float

+

+
calculates the Euclidean length of the vector which follows from the
+Pythagorean theorem:
+vec.length() == math.sqrt(vec.x**2 + vec.y**2 + vec.z**2)

+

+
+

+

+length_squared()

+

+
returns the squared Euclidean length of the vector.

+
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.
+This is faster than vec.length() because it avoids the square root.

+

+
+

+

+normalize()

+

+
returns a vector with the same direction but length 1.

+
normalize() -> Vector3

+

+
Returns a new vector that has length equal to 1 and the same
+direction as self.

+

+
+

+

+normalize_ip()

+

+
normalizes the vector in place so that its length is 1.

+
normalize_ip() -> None

+

+
Normalizes the vector so that it has length equal to 1. The
+direction of the vector is not changed.

+

+
+

+

+is_normalized()

+

+
tests if the vector is normalized i.e. has length == 1.

+
is_normalized() -> Bool

+

+
Returns True if the vector has length equal to 1. Otherwise it
+returns False.

+

+
+

+

+scale_to_length()

+

+
scales the vector to a given length.

+
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
+is the zero vector (i.e. has length 0 thus no direction) a
+ValueError is raised.

+

+
+

+

+reflect()

+

+
returns a vector reflected of a given normal.

+
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
+new vector is the same as self's.

+

+
+

+

+reflect_ip()

+

+
reflect the vector of a given normal in place.

+
reflect_ip(Vector3) -> None

+

+
Changes the direction of self as if it would have been reflected of a
+surface with the given surface normal.

+

+
+

+

+distance_to()

+

+
calculates the Euclidean distance to a given vector.

+
distance_to(Vector3) -> float

+

+

+
+

+

+distance_squared_to()

+

+
calculates the squared Euclidean distance to a given vector.

+
distance_squared_to(Vector3) -> float

+

+

+
+

+

+move_towards()

+

+
returns a vector moved toward the target by a given distance.

+
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 2.1.3.

+

+

+
+

+

+move_towards_ip()

+

+
moves the vector toward its target at a given distance.

+
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 2.1.3.

+

+

+
+

+

+lerp()

+

+
returns a linear interpolation to the given vector.

+
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 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.

+

+
+

+

+slerp()

+

+
returns a spherical interpolation to the given vector.

+
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
+parametrizes where - in between the two vectors - the result should be.
+If a negative value is given the interpolation will not take the
+complement of the shortest path.

+

+
+

+

+elementwise()

+

+
The next operation will be performed elementwise.

+
elementwise() -> VectorElementwiseProxy

+

+
Applies the following operation to each element of the vector.

+

+
+

+

+rotate()

+

+
rotates a vector by a given angle in degrees.

+
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.
+(Note that due to pygame's inverted y coordinate system, the rotation
+will look clockwise if displayed).

+

+
+

+

+rotate_rad()

+

+
rotates a vector by a given angle in radians.

+
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.

+

+

+
+

+

+rotate_ip()

+

+
rotates the vector by a given angle in degrees in place.

+
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.
+(Note that due to pygame's inverted y coordinate system, the rotation
+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

+

+
DEPRECATED: Use rotate_rad_ip() instead.

+

+
New in pygame 2.0.0.

+

+

+
Deprecated since pygame 2.1.1.

+

+

+
+

+

+rotate_rad_ip()

+

+
rotates the vector by a given angle in radians in place.

+
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.

+

+

+
+

+

+rotate_x()

+

+
rotates a vector around the x-axis by the angle in degrees.

+
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.
+(Note that due to pygame's inverted y coordinate system, the rotation
+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

+

+
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.

+

+

+
+

+

+rotate_x_ip()

+

+
rotates the vector around the x-axis by the angle in degrees in place.

+
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.
+(Note that due to pygame's inverted y coordinate system, the rotation
+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

+

+
DEPRECATED: Use rotate_x_rad_ip() instead.

+

+
New in pygame 2.0.0.

+

+

+
Deprecated since pygame 2.1.1.

+

+

+
+

+

+rotate_x_rad_ip()

+

+
rotates the vector around the x-axis by the angle in radians in place.

+
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.

+

+

+
+

+

+rotate_y()

+

+
rotates a vector around the y-axis by the angle in degrees.

+
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.
+(Note that due to pygame's inverted y coordinate system, the rotation
+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

+

+
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.

+

+

+
+

+

+rotate_y_ip()

+

+
rotates the vector around the y-axis by the angle in degrees in place.

+
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.
+(Note that due to pygame's inverted y coordinate system, the rotation
+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

+

+
DEPRECATED: Use rotate_y_rad_ip() instead.

+

+
New in pygame 2.0.0.

+

+

+
Deprecated since pygame 2.1.1.

+

+

+
+

+

+rotate_y_rad_ip()

+

+
rotates the vector around the y-axis by the angle in radians in place.

+
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.

+

+

+
+

+

+rotate_z()

+

+
rotates a vector around the z-axis by the angle in degrees.

+
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.
+(Note that due to pygame's inverted y coordinate system, the rotation
+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

+

+
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.

+

+

+
+

+

+rotate_z_ip()

+

+
rotates the vector around the z-axis by the angle in degrees in place.

+
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.
+(Note that due to pygame's inverted y coordinate system, the rotation
+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

+

+
DEPRECATED: Use rotate_z_rad_ip() instead.

+

+
Deprecated since pygame 2.1.1.

+

+

+
+

+

+rotate_z_rad_ip()

+

+
rotates the vector around the z-axis by the angle in radians in place.

+
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.

+

+

+
+

+

+angle_to()

+

+
calculates the angle to a given vector in degrees.

+
angle_to(Vector3) -> float

+

+
Returns the angle between self and the given vector.

+

+
+

+

+as_spherical()

+

+
returns a tuple with radial distance, inclination and azimuthal angle.

+
as_spherical() -> (r, theta, phi)

+

+
Returns a tuple (r, theta, phi) where r is the radial distance, theta is
+the inclination angle and phi is the azimuthal angle.

+

+
+

+

+from_spherical()

+

+
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

+

+
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.

+

+
+

+

+project()

+

+
projects a vector onto another.

+
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.

+

+

+
+

+

+copy()

+

+
Returns a copy of itself.

+
copy() -> Vector3

+

+
Returns a new Vector3 having the same dimensions.

+

+
New in pygame 2.1.1.

+

+

+
+

+

+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

+

+
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 2.1.3.

+

+

+
+

+

+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

+

+
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 2.1.3.

+

+

+
+

+

+update()

+

+
Sets the coordinates of the vector.

+
update() -> None

+
update(int) -> None

+
update(float) -> None

+
update(Vector3) -> None

+
update(x, y, z) -> None

+
update((x, y, z)) -> None

+

+
Sets coordinates x, y, and z in place.

+

+
New in pygame 1.9.5.

+

+

+
+

+

+epsilon

+

+
Determines the tolerance of vector calculations.

+

+
With lengths within this number, vectors are considered equal. For more information see pygame.math.Vector2.epsilonDetermines the tolerance of vector calculations.

+

+
+

+
+

+
+

+
+
+


+

+Edit on GitHub
+            

+          

+      

+      

+    

+    
+    
+  
+
\ No newline at end of file
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/ref/midi.html b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/ref/midi.html
new file mode 100644
index 0000000..e70e387
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/ref/midi.html
@@ -0,0 +1,826 @@
+
+
+
+  
+    
+    
+
+    pygame.midi — pygame v2.6.1 documentation
+    
+    
+    
+    
+    
+    
+    
+    
+    
+     
+    
+
+    

+
+  

+	

+	
+	

+	  

+	    Pygame Home ||
+	    Help Contents ||
+	    Reference Index
+
+        

+          
+          
+        

+	  

+	  

+	  
Most useful stuff:
+	    Color | 
+	    display | 
+	    draw | 
+	    event | 
+	    font | 
+	    image | 
+	    key | 
+	    locals | 
+	    mixer | 
+	    mouse | 
+	    Rect | 
+	    Surface | 
+	    time | 
+	    music | 
+	    pygame
+	  

+
+	  
Advanced stuff:
+	    cursors | 
+	    joystick | 
+	    mask | 
+	    sprite | 
+	    transform | 
+	    BufferProxy | 
+	    freetype | 
+	    gfxdraw | 
+	    midi | 
+	    PixelArray | 
+	    pixelcopy | 
+	    sndarray | 
+	    surfarray | 
+	    math
+	  

+
+	  
Other:
+	    camera | 
+	    controller | 
+	    examples | 
+	    fastevent | 
+	    scrap | 
+	    tests | 
+	    touch | 
+	    version
+	  

+

+

+  

+
+      

+          

+            
+

+

+

+pygame.midi

+

+
pygame module for interacting with midi input and output.

+

+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
pygame.midi.init

+		—initialize the midi module
pygame.midi.quit

+		—uninitialize the midi module
pygame.midi.get_init

+		—returns True if the midi module is currently initialized
pygame.midi.Input

+		—Input is used to get midi input from midi devices.
pygame.midi.Output

+		—Output is used to send midi to an output device
pygame.midi.get_count

+		—gets the number of devices.
pygame.midi.get_default_input_id

+		—gets default input device number
pygame.midi.get_default_output_id

+		—gets default output device number
pygame.midi.get_device_info

+		—returns information about a midi device
pygame.midi.midis2events

+		—converts midi events to pygame events
pygame.midi.time

+		—returns the current time in ms of the PortMidi timer
pygame.midi.frequency_to_midi

+		—Converts a frequency into a MIDI note. Rounds to the closest midi note.
pygame.midi.midi_to_frequency

+		—Converts a midi note to a frequency.
pygame.midi.midi_to_ansi_note

+		—Returns the Ansi Note name for a midi number.
pygame.midi.MidiException

+		—exception that pygame.midi functions and classes can raise

+

+
New in pygame 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.

+
The midi module supports real and virtual midi devices.

+
It uses the portmidi library. Is portable to which ever platforms portmidi
+supports (currently Windows, Mac OS X, and Linux).

+
This uses pyportmidi for now, but may use its own bindings at some point in the
+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
+MIDIIN event is used by pygame.midi.midis2events()converts midi events to pygame events when converting
+midi events to pygame events.

+
MIDIIN
+MIDIOUT
+

+

+

+


+

+

+

+pygame.midi.init()

+

+
initialize the midi module

+
init() -> None

+

+
Initializes the pygame.midipygame module for interacting with midi input and output. module. Must be called before using the
+pygame.midipygame module for interacting with midi input and output. module.

+
It is safe to call this more than once.

+

+
+

+

+pygame.midi.quit()

+

+
uninitialize the midi module

+
quit() -> None

+

+
Uninitializes the pygame.midipygame module for interacting with midi input and output. module. If pygame.midi.init()initialize the midi module was
+called to initialize the pygame.midipygame module for interacting with midi input and output. module, then this function will
+be called automatically when your program exits.

+
It is safe to call this function more than once.

+

+
+

+

+pygame.midi.get_init()

+

+
returns True if the midi module is currently initialized

+
get_init() -> bool

+

+
Gets the initialization state of the pygame.midipygame module for interacting with midi input and output. module.

+

+
Returns:

+
True if the pygame.midipygame module for interacting with midi input and output. module is currently initialized.

+

+
Return type:

+
bool

+

+

+

+
New in pygame 1.9.5.

+

+

+
+

+

+pygame.midi.Input

+

+
Input is used to get midi input from midi devices.

+
Input(device_id) -> None

+
Input(device_id, buffer_size) -> None

+

+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
pygame.midi.Input.close

+		—closes a midi stream, flushing any pending buffers.
pygame.midi.Input.poll

+		—returns True if there's data, or False if not.
pygame.midi.Input.read

+		—reads num_events midi events from the buffer.

+

+
Parameters:

+
    
+
  • device_id (int) -- midi device id
    • 
+
  • buffer_size (int) -- (optional) the number of input events to be buffered
    • 
+

+

+

+

+

+close()

+

+
closes a midi stream, flushing any pending buffers.

+
close() -> None

+

+
PortMidi attempts to close open streams when the application exits.

+

+
Note

+
This is particularly difficult under Windows.

+

+

+
+

+

+poll()

+

+
returns True if there's data, or False if not.

+
poll() -> bool

+

+
Used to indicate if any data exists.

+

+
Returns:

+
True if there is data, False otherwise

+

+
Return type:

+
bool

+

+
Raises:

+
MidiException -- on error

+

+

+

+
+

+

+read()

+

+
reads num_events midi events from the buffer.

+
read(num_events) -> midi_event_list

+

+
Reads from the input buffer and gives back midi events.

+

+
Parameters:

+
num_events (int) -- number of input events to read

+

+
Returns:

+
the format for midi_event_list is
+[[[status, data1, data2, data3], timestamp], ...]

+

+
Return type:

+
list

+

+

+

+
+

+
+

+

+pygame.midi.Output

+

+
Output is used to send midi to an output device

+
Output(device_id) -> None

+
Output(device_id, latency=0) -> None

+
Output(device_id, buffer_size=256) -> None

+
Output(device_id, latency, buffer_size) -> None

+

+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
pygame.midi.Output.abort

+		—terminates outgoing messages immediately
pygame.midi.Output.close

+		—closes a midi stream, flushing any pending buffers.
pygame.midi.Output.note_off

+		—turns a midi note off (note must be on)
pygame.midi.Output.note_on

+		—turns a midi note on (note must be off)
pygame.midi.Output.set_instrument

+		—select an instrument, with a value between 0 and 127
pygame.midi.Output.pitch_bend

+		—modify the pitch of a channel.
pygame.midi.Output.write

+		—writes a list of midi data to the Output
pygame.midi.Output.write_short

+		—writes up to 3 bytes of midi data to the Output
pygame.midi.Output.write_sys_ex

+		—writes a timestamped system-exclusive midi message.

+
The buffer_size specifies the number of output events to be buffered
+waiting for output. In some cases (see below) PortMidi does not buffer
+output at all and merely passes data to a lower-level API, in which case
+buffersize is ignored.

+
latency is the delay in milliseconds applied to timestamps to determine
+when the output should actually occur. If latency is <<0, 0 is assumed.

+
If latency is zero, timestamps are ignored and all output is delivered
+immediately. If latency is greater than zero, output is delayed until the
+message timestamp plus the latency. In some cases, PortMidi can obtain
+better timing than your application by passing timestamps along to the
+device driver or hardware. Latency may also help you to synchronize midi
+data to audio data by matching midi latency to the audio buffer latency.

+

+
Note

+
Time is measured relative to the time source indicated by time_proc.
+Timestamps are absolute, not relative delays or offsets.

+

+

+

+abort()

+

+
terminates outgoing messages immediately

+
abort() -> None

+

+
The caller should immediately close the output port; this call may result
+in transmission of a partial midi message. There is no abort for Midi
+input because the user can simply ignore messages in the buffer and close
+an input device at any time.

+

+
+

+

+close()

+

+
closes a midi stream, flushing any pending buffers.

+
close() -> None

+

+
PortMidi attempts to close open streams when the application exits.

+

+
Note

+
This is particularly difficult under Windows.

+

+

+
+

+

+note_off()

+

+
turns a midi note off (note must be on)

+
note_off(note, velocity=None, channel=0) -> None

+

+
Turn a note off in the output stream. The note must already be on for
+this to work correctly.

+

+
+

+

+note_on()

+

+
turns a midi note on (note must be off)

+
note_on(note, velocity=None, channel=0) -> None

+

+
Turn a note on in the output stream. The note must already be off for
+this to work correctly.

+

+
+

+

+set_instrument()

+

+
select an instrument, with a value between 0 and 127

+
set_instrument(instrument_id, channel=0) -> None

+

+
Select an instrument.

+

+
+

+

+pitch_bend()

+

+
modify the pitch of a channel.

+
set_instrument(value=0, channel=0) -> None

+

+
Adjust the pitch of a channel. The value is a signed integer
+from -8192 to +8191. For example, 0 means "no change", +4096 is
+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.

+

+

+
+

+

+write()

+

+
writes a list of midi data to the Output

+
write(data) -> None

+

+
Writes series of MIDI information in the form of a list.

+

+
Parameters:

+
data (list) -- data to write, the expected format is
+[[[status, data1=0, data2=0, ...], timestamp], ...]
+with the data# fields being optional

+

+
Raises:

+
IndexError -- if more than 1024 elements in the data list

+

+

+
Example:

+
# Program change at time 20000 and 500ms later send note 65 with
+# velocity 100.
+write([[[0xc0, 0, 0], 20000], [[0x90, 60, 100], 20500]])
+

+

+

+
Note

+
    
+
  • Timestamps will be ignored if latency = 0
    • 
+
  • To get a note to play immediately, send MIDI info with timestamp
+read from function Time
    • 
+
  • Optional data fields: write([[[0xc0, 0, 0], 20000]]) is
+equivalent to write([[[0xc0], 20000]])
    • 
+

+

+

+
+

+

+write_short()

+

+
writes up to 3 bytes of midi data to the Output

+
write_short(status) -> None

+
write_short(status, data1=0, data2=0) -> None

+

+
Output MIDI information of 3 bytes or less. The data fields are
+optional and assumed to be 0 if omitted.

+
Examples of status byte values:

+
0xc0  # program change
+0x90  # note on
+# etc.
+

+

+
Example:

+
# note 65 on with velocity 100
+write_short(0x90, 65, 100)
+

+

+

+
+

+

+write_sys_ex()

+

+
writes a timestamped system-exclusive midi message.

+
write_sys_ex(when, msg) -> None

+

+
Writes a timestamped system-exclusive midi message.

+

+
Parameters:

+
    
+
  • msg (list[int] or str) -- midi message
    • 
+
  • when -- timestamp in milliseconds
    • 
+

+

+

+
Example:

+
midi_output.write_sys_ex(0, '\xF0\x7D\x10\x11\x12\x13\xF7')
+
+# is equivalent to
+
+midi_output.write_sys_ex(pygame.midi.time(),
+                         [0xF0, 0x7D, 0x10, 0x11, 0x12, 0x13, 0xF7])
+

+

+

+
+

+
+

+

+pygame.midi.get_count()

+

+
gets the number of devices.

+
get_count() -> num_devices

+

+
Device ids range from 0 to get_count() - 1

+

+
+

+

+pygame.midi.get_default_input_id()

+

+
gets default input device number

+
get_default_input_id() -> default_id

+

+
The following describes the usage details for this function and the
+get_default_output_id() function.

+
Return the default device ID or -1 if there are no devices. The result
+can be passed to the Input/Output class.

+
On a PC the user can specify a default device by setting an environment
+variable. To use device #1, for example:

+
set PM_RECOMMENDED_INPUT_DEVICE=1
+or
+set PM_RECOMMENDED_OUTPUT_DEVICE=1
+

+

+
The user should first determine the available device ID by using the
+supplied application "testin" or "testout".

+
In general, the registry is a better place for this kind of info. With
+USB devices that can come and go, using integers is not very reliable
+for device identification. Under Windows, if PM_RECOMMENDED_INPUT_DEVICE
+(or PM_RECOMMENDED_OUTPUT_DEVICE) is NOT found in the environment,
+then the default device is obtained by looking for a string in the registry
+under:

+
HKEY_LOCAL_MACHINE/SOFTWARE/PortMidi/Recommended_Input_Device
+or
+HKEY_LOCAL_MACHINE/SOFTWARE/PortMidi/Recommended_Output_Device
+

+

+
The number of the first device with a substring that matches the
+string exactly is returned. For example, if the string in the registry is
+"USB" and device 1 is named "In USB MidiSport 1x1", then that will be
+the default input because it contains the string "USB".

+
In addition to the name, get_device_info() returns "interf", which is
+the interface name. The "interface" is the underlying software system or
+API used by PortMidi to access devices. Supported interfaces:

+
MMSystem   # the only Win32 interface currently supported
+ALSA       # the only Linux interface currently supported
+CoreMIDI   # the only Mac OS X interface currently supported
+# DirectX - not implemented
+# OSS     - not implemented
+

+

+
To specify both the interface and the device name in the registry, separate
+the two with a comma and a space. The string before the comma must be a
+substring of the "interf" string and the string after the space must be a
+substring of the "name" name string in order to match the device. e.g.:

+
MMSystem, In USB MidiSport 1x1
+

+

+

+
Note

+
In the current release, the default is simply the first device (the
+input or output device with the lowest PmDeviceID).

+

+

+
+

+

+pygame.midi.get_default_output_id()

+

+
gets default output device number

+
get_default_output_id() -> default_id

+

+
See get_default_input_id() for usage details.

+

+
+

+

+pygame.midi.get_device_info()

+

+
returns information about a midi device

+
get_device_info(an_id) -> (interf, name, input, output, opened)

+
get_device_info(an_id) -> None

+

+
Gets the device info for a given id.

+

+
Parameters:

+
an_id (int) -- id of the midi device being queried

+

+
Returns:

+
if the id is out of range None is returned, otherwise
+a tuple of (interf, name, input, output, opened) is returned.

+

+
    
+
  • interf: string describing the device interface (e.g. 'ALSA')
    • 
+
  • name: string name of the device (e.g. 'Midi Through Port-0')
    • 
+
  • input: 1 if the device is an input device, otherwise 0
    • 
+
  • output: 1 if the device is an output device, otherwise 0
    • 
+
  • opened: 1 if the device is opened, otherwise 0
    • 
+

+

+

+

+
Return type:

+
tuple or None

+

+

+

+
+

+

+pygame.midi.midis2events()

+

+
converts midi events to pygame events

+
midis2events(midi_events, device_id) -> [Event, ...]

+

+
Takes a sequence of midi events and returns list of pygame events.

+
The midi_events data is expected to be a sequence of
+((status, data1, data2, data3), timestamp) midi events (all values
+required).

+

+
Returns:

+
a list of pygame events of event type MIDIIN

+

+
Return type:

+
list

+

+

+

+
+

+

+pygame.midi.time()

+

+
returns the current time in ms of the PortMidi timer

+
time() -> time

+

+
The time is reset to 0 when the pygame.midipygame module for interacting with midi input and output. module is initialized.

+

+
+

+

+pygame.midi.frequency_to_midi()

+

+
Converts a frequency into a MIDI note. Rounds to the closest midi note.

+
frequency_to_midi(midi_note) -> midi_note

+

+
example:

+
frequency_to_midi(27.5) == 21
+

+

+

+
New in pygame 1.9.5.

+

+

+
+

+

+pygame.midi.midi_to_frequency()

+

+
Converts a midi note to a frequency.

+
midi_to_frequency(midi_note) -> frequency

+

+
example:

+
midi_to_frequency(21) == 27.5
+

+

+

+
New in pygame 1.9.5.

+

+

+
+

+

+pygame.midi.midi_to_ansi_note()

+

+
Returns the Ansi Note name for a midi number.

+
midi_to_ansi_note(midi_note) -> ansi_note

+

+
example:

+
midi_to_ansi_note(21) == 'A0'
+

+

+

+
New in pygame 1.9.5.

+

+

+
+

+

+exception pygame.midi.MidiException

+

+
exception that pygame.midi functions and classes can raise

+
MidiException(errno) -> None

+

+

+
+

+
+

+
+
+


+

+Edit on GitHub
+            

+          

+      

+      

+    

+    
+    
+  
+
\ No newline at end of file
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/ref/mixer.html b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/ref/mixer.html
new file mode 100644
index 0000000..3e20bab
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/ref/mixer.html
@@ -0,0 +1,977 @@
+
+
+
+  
+    
+    
+
+    pygame.mixer — pygame v2.6.1 documentation
+    
+    
+    
+    
+    
+    
+    
+    
+    
+     
+    
+
+    

+
+  

+	

+	
+	

+	  

+	    Pygame Home ||
+	    Help Contents ||
+	    Reference Index
+
+        

+          
+          
+        

+	  

+	  

+	  
Most useful stuff:
+	    Color | 
+	    display | 
+	    draw | 
+	    event | 
+	    font | 
+	    image | 
+	    key | 
+	    locals | 
+	    mixer | 
+	    mouse | 
+	    Rect | 
+	    Surface | 
+	    time | 
+	    music | 
+	    pygame
+	  

+
+	  
Advanced stuff:
+	    cursors | 
+	    joystick | 
+	    mask | 
+	    sprite | 
+	    transform | 
+	    BufferProxy | 
+	    freetype | 
+	    gfxdraw | 
+	    midi | 
+	    PixelArray | 
+	    pixelcopy | 
+	    sndarray | 
+	    surfarray | 
+	    math
+	  

+
+	  
Other:
+	    camera | 
+	    controller | 
+	    examples | 
+	    fastevent | 
+	    scrap | 
+	    tests | 
+	    touch | 
+	    version
+	  

+

+

+  

+
+      

+          

+            
+

+

+

+pygame.mixer

+

+
pygame module for loading and playing sounds

+

+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
pygame.mixer.init

+		—initialize the mixer module
pygame.mixer.pre_init

+		—preset the mixer init arguments
pygame.mixer.quit

+		—uninitialize the mixer
pygame.mixer.get_init

+		—test if the mixer is initialized
pygame.mixer.stop

+		—stop playback of all sound channels
pygame.mixer.pause

+		—temporarily stop playback of all sound channels
pygame.mixer.unpause

+		—resume paused playback of sound channels
pygame.mixer.fadeout

+		—fade out the volume on all sounds before stopping
pygame.mixer.set_num_channels

+		—set the total number of playback channels
pygame.mixer.get_num_channels

+		—get the total number of playback channels
pygame.mixer.set_reserved

+		—reserve channels from being automatically used
pygame.mixer.find_channel

+		—find an unused channel
pygame.mixer.get_busy

+		—test if any sound is being mixed
pygame.mixer.get_sdl_mixer_version

+		—get the mixer's SDL version
pygame.mixer.Sound

+		—Create a new Sound object from a file or buffer object
pygame.mixer.Channel

+		—Create a Channel object for controlling playback

+
This module contains classes for loading Sound objects and controlling
+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
+programs can get more precise control over the number of channels and their
+use.

+
All sound playback is mixed in background threads. When you begin to play a
+Sound object, it will return immediately while the sound continues to play. A
+single Sound object can also be actively played back multiple times.

+
The mixer also has a special streaming channel. This is for music playback and
+is accessed through the pygame.mixer.musicpygame module for controlling streamed audio module. Consider using this
+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. 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)

+

+

+pygame.mixer.init()

+

+
initialize the mixer module

+
init(frequency=44100, size=-16, channels=2, buffer=512, devicename=None, allowedchanges=AUDIO_ALLOW_FREQUENCY_CHANGE | AUDIO_ALLOW_CHANNELS_CHANGE) -> None

+

+
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
+0 are replaced with the startup defaults, except for allowedchanges,
+where -1 is used. (startup defaults may be changed by a pre_init() call).

+
The size argument represents how many bits are used for each audio sample.
+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.

+
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).

+
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
+init. To solve this, mixer has a function pygame.mixer.pre_init() to set
+the proper defaults before the toplevel init is used.

+
When using allowedchanges=0 it will convert the samples at runtime to match
+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 SDL2 supports.

+
Apart from 0, allowedchanged accepts the following constants ORed together:

+

+
    
+
  • AUDIO_ALLOW_FREQUENCY_CHANGE
    • 
+
  • AUDIO_ALLOW_FORMAT_CHANGE
    • 
+
  • AUDIO_ALLOW_CHANNELS_CHANGE
    • 
+
  • AUDIO_ALLOW_ANY_CHANGE
    • 
+

+

+
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

+

+

+
+

+

+pygame.mixer.pre_init()

+

+
preset the mixer init arguments

+
pre_init(frequency=44100, size=-16, channels=2, buffer=512, devicename=None, allowedchanges=AUDIO_ALLOW_FREQUENCY_CHANGE | AUDIO_ALLOW_CHANNELS_CHANGE) -> None

+

+
Call pre_init to change the defaults used when the real
+pygame.mixer.init() is called. Keyword arguments are accepted. The best
+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

+

+

+
+

+

+pygame.mixer.quit()

+

+
uninitialize the mixer

+
quit() -> None

+

+
This will uninitialize pygame.mixerpygame module for loading and playing sounds. All playback will stop and any
+loaded Sound objects may not be compatible with the mixer if it is
+reinitialized later.

+

+
+

+

+pygame.mixer.get_init()

+

+
test if the mixer is initialized

+
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.stop()

+

+
stop playback of all sound channels

+
stop() -> None

+

+
This will stop all playback of all active mixer channels.

+

+
+

+

+pygame.mixer.pause()

+

+
temporarily stop playback of all sound channels

+
pause() -> None

+

+
This will temporarily stop all playback on the active mixer channels. The
+playback can later be resumed with pygame.mixer.unpause()

+

+
+

+

+pygame.mixer.unpause()

+

+
resume paused playback of sound channels

+
unpause() -> None

+

+
This will resume all active sound channels after they have been paused.

+

+
+

+

+pygame.mixer.fadeout()

+

+
fade out the volume on all sounds before stopping

+
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.

+

+
+

+

+pygame.mixer.set_num_channels()

+

+
set the total number of playback channels

+
set_num_channels(count) -> None

+

+
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.

+

+
+

+

+pygame.mixer.get_num_channels()

+

+
get the total number of playback channels

+
get_num_channels() -> count

+

+
Returns the number of currently active playback channels.

+

+
+

+

+pygame.mixer.set_reserved()

+

+
reserve channels from being automatically used

+
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
+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.

+
This allows the application to reserve a specific number of channels for
+important sounds that must not be dropped or have a guaranteed channel to
+play on.

+
Will return number of channels actually reserved, this may be less than requested
+depending on the number of channels previously allocated.

+

+
+

+

+pygame.mixer.find_channel()

+

+
find an unused channel

+
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
+inactive channels and the force argument is True, this will find the
+Channel with the longest running Sound and return it.

+

+
+

+

+pygame.mixer.get_busy()

+

+
test if any sound is being mixed

+
get_busy() -> bool

+

+
Returns True if the mixer is busy mixing any channels. If the mixer is
+idle then this return False.

+

+
+

+

+pygame.mixer.get_sdl_mixer_version()

+

+
get the mixer's SDL version

+
get_sdl_mixer_version() -> (major, minor, patch)

+
get_sdl_mixer_version(linked=True) -> (major, minor, patch)

+

+

+
Parameters:

+
linked (bool) -- if True (default) the linked version number is
+returned, otherwise the compiled version number is returned

+

+
Returns:

+
the mixer's SDL library version number (linked or compiled
+depending on the linked parameter) as a tuple of 3 integers
+(major, minor, patch)

+

+
Return type:

+
tuple

+

+

+

+
Note

+
The linked and compile version numbers should be the same.

+

+

+
New in pygame 2.0.0.

+

+

+
+

+

+pygame.mixer.Sound

+

+
Create a new Sound object from a file or buffer object

+
Sound(filename) -> Sound

+
Sound(file=filename) -> Sound

+
Sound(file=pathlib_path) -> Sound

+
Sound(buffer) -> Sound

+
Sound(buffer=buffer) -> Sound

+
Sound(object) -> Sound

+
Sound(file=object) -> Sound

+
Sound(array=object) -> Sound

+

+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
pygame.mixer.Sound.play

+		—begin sound playback
pygame.mixer.Sound.stop

+		—stop sound playback
pygame.mixer.Sound.fadeout

+		—stop sound playback after fading out
pygame.mixer.Sound.set_volume

+		—set the playback volume for this Sound
pygame.mixer.Sound.get_volume

+		—get the playback volume
pygame.mixer.Sound.get_num_channels

+		—count how many times this Sound is playing
pygame.mixer.Sound.get_length

+		—get the length of the Sound
pygame.mixer.Sound.get_raw

+		—return a bytestring copy of the Sound samples.

+
Load a new sound buffer from a filename, a python file object or a readable
+buffer object. Limited resampling will be performed to help the sample match
+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
+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 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.

+
Note: The buffer will be copied internally, no data will be shared between
+it and the Sound object.

+
For now buffer and array support is consistent with sndarray.make_sound
+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.

+

+
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.

+

+

+

+play()

+

+
begin sound playback

+
play(loops=0, maxtime=0, fade_ms=0) -> Channel

+

+
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.

+

+
+

+

+stop()

+

+
stop sound playback

+
stop() -> None

+

+
This will stop the playback of this Sound on any active Channels.

+

+
+

+

+fadeout()

+

+
stop sound playback after fading out

+
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
+playing channels.

+

+
+

+

+set_volume()

+

+
set the playback volume for this Sound

+
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
+future playback of this Sound.

+

+
Parameters:

+
value (float) -- 
volume in the range of 0.0 to 1.0 (inclusive)

+

+
If value < 0.0, the volume will not be changed

+
If value > 1.0, the volume will be set to 1.0

+

+

+

+

+

+
+

+

+get_volume()

+

+
get the playback volume

+
get_volume() -> value

+

+
Return a value from 0.0 to 1.0 representing the volume for this Sound.

+

+
+

+

+get_num_channels()

+

+
count how many times this Sound is playing

+
get_num_channels() -> count

+

+
Return the number of active channels this sound is playing on.

+

+
+

+

+get_length()

+

+
get the length of the Sound

+
get_length() -> seconds

+

+
Return the length of this Sound in seconds.

+

+
+

+

+get_raw()

+

+
return a bytestring copy of the Sound samples.

+
get_raw() -> bytes

+

+
Return a copy of the Sound object buffer as a bytes.

+

+
New in pygame 1.9.2.

+

+

+
+

+
+

+

+pygame.mixer.Channel

+

+
Create a Channel object for controlling playback

+
Channel(id) -> Channel

+

+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
pygame.mixer.Channel.play

+		—play a Sound on a specific Channel
pygame.mixer.Channel.stop

+		—stop playback on a Channel
pygame.mixer.Channel.pause

+		—temporarily stop playback of a channel
pygame.mixer.Channel.unpause

+		—resume pause playback of a channel
pygame.mixer.Channel.fadeout

+		—stop playback after fading channel out
pygame.mixer.Channel.set_volume

+		—set the volume of a playing channel
pygame.mixer.Channel.get_volume

+		—get the volume of the playing channel
pygame.mixer.Channel.get_busy

+		—check if the channel is active
pygame.mixer.Channel.get_sound

+		—get the currently playing Sound
pygame.mixer.Channel.queue

+		—queue a Sound object to follow the current
pygame.mixer.Channel.get_queue

+		—return any Sound that is queued
pygame.mixer.Channel.set_endevent

+		—have the channel send an event when playback stops
pygame.mixer.Channel.get_endevent

+		—get the event a channel sends when playback stops

+
Return a Channel object for one of the current channels. The id must be a
+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.

+

+

+play()

+

+
play a Sound on a specific Channel

+
play(Sound, loops=0, maxtime=0, fade_ms=0) -> None

+

+
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.

+

+
+

+

+stop()

+

+
stop playback on a Channel

+
stop() -> None

+

+
Stop sound playback on a channel. After playback is stopped the channel
+becomes available for new Sounds to play on it.

+

+
+

+

+pause()

+

+
temporarily stop playback of a channel

+
pause() -> None

+

+
Temporarily stop the playback of sound on a channel. It can be resumed at
+a later time with Channel.unpause()

+

+
+

+

+unpause()

+

+
resume pause playback of a channel

+
unpause() -> None

+

+
Resume the playback on a paused channel.

+

+
+

+

+fadeout()

+

+
stop playback after fading channel out

+
fadeout(time) -> None

+

+
Stop playback of a channel after fading out the sound over the given time
+argument in milliseconds.

+

+
+

+

+set_volume()

+

+
set the volume of a playing channel

+
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 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).
+

+

+

+
+

+

+get_volume()

+

+
get the volume of the playing channel

+
get_volume() -> value

+

+
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.

+

+
+

+

+get_busy()

+

+
check if the channel is active

+
get_busy() -> bool

+

+
Returns True if the channel is actively mixing sound. If the channel
+is idle this returns False.

+

+
+

+

+get_sound()

+

+
get the currently playing Sound

+
get_sound() -> Sound

+

+
Return the actual Sound object currently playing on this channel. If the
+channel is idle None is returned.

+

+
+

+

+queue()

+

+
queue a Sound object to follow the current

+
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
+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.

+

+
+

+

+get_queue()

+

+
return any Sound that is queued

+
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.

+

+
+

+

+set_endevent()

+

+
have the channel send an event when playback stops

+
set_endevent() -> 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
+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.

+

+
+

+

+get_endevent()

+

+
get the event a channel sends when playback stops

+
get_endevent() -> type

+

+
Returns the event type to be sent every time the Channel finishes
+playback of a Sound. If there is no endevent the function returns
+pygame.NOEVENT.

+

+
+

+
+

+
+

+
+
+


+

+Edit on GitHub
+            

+          

+      

+      

+    

+    
+    
+  
+
\ No newline at end of file
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/ref/mouse.html b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/ref/mouse.html
new file mode 100644
index 0000000..3d0fc29
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/ref/mouse.html
@@ -0,0 +1,397 @@
+
+
+
+  
+    
+    
+
+    pygame.mouse — pygame v2.6.1 documentation
+    
+    
+    
+    
+    
+    
+    
+    
+    
+     
+    
+
+    

+
+  

+	

+	
+	

+	  

+	    Pygame Home ||
+	    Help Contents ||
+	    Reference Index
+
+        

+          
+          
+        

+	  

+	  

+	  
Most useful stuff:
+	    Color | 
+	    display | 
+	    draw | 
+	    event | 
+	    font | 
+	    image | 
+	    key | 
+	    locals | 
+	    mixer | 
+	    mouse | 
+	    Rect | 
+	    Surface | 
+	    time | 
+	    music | 
+	    pygame
+	  

+
+	  
Advanced stuff:
+	    cursors | 
+	    joystick | 
+	    mask | 
+	    sprite | 
+	    transform | 
+	    BufferProxy | 
+	    freetype | 
+	    gfxdraw | 
+	    midi | 
+	    PixelArray | 
+	    pixelcopy | 
+	    sndarray | 
+	    surfarray | 
+	    math
+	  

+
+	  
Other:
+	    camera | 
+	    controller | 
+	    examples | 
+	    fastevent | 
+	    scrap | 
+	    tests | 
+	    touch | 
+	    version
+	  

+

+

+  

+
+      

+          

+            
+

+

+

+pygame.mouse

+

+
pygame module to work with the mouse

+

+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
pygame.mouse.get_pressed

+		—get the state of the mouse buttons
pygame.mouse.get_pos

+		—get the mouse cursor position
pygame.mouse.get_rel

+		—get the amount of mouse movement
pygame.mouse.set_pos

+		—set the mouse cursor position
pygame.mouse.set_visible

+		—hide or show the mouse cursor
pygame.mouse.get_visible

+		—get the current visibility state of the mouse cursor
pygame.mouse.get_focused

+		—check if the display is receiving mouse input
pygame.mouse.set_cursor

+		—set the mouse cursor to a new cursor
pygame.mouse.get_cursor

+		—get the current mouse cursor

+
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 https://wiki.libsdl.org/MigrationGuide#input

+
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 example of mouse scroll (tested on 2.0.0.dev7)

+
# 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()
+

+

+

+

+

+pygame.mouse.get_pressed()

+

+
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.

+
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.

+

+
Changed in pygame 2.0.0: num_buttons argument added

+

+

+
+

+

+pygame.mouse.get_pos()

+

+
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() -> (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.set_pos()

+

+
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
+a new pygame.MOUSEMOTION event.

+

+
+

+

+pygame.mouse.set_visible()

+

+
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.

+

+
+

+

+pygame.mouse.get_visible()

+

+
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.

+

+

+
+

+

+pygame.mouse.get_focused()

+

+
check if the display is receiving mouse input

+
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.set_cursor()

+

+
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.

+

+
Changed in pygame 2.0.1.

+

+

+
+

+

+pygame.mouse.get_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.

+

+
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.

+

+

+
+

+
+

+
+
+


+

+Edit on GitHub
+            

+          

+      

+      

+    

+    
+    
+  
+
\ No newline at end of file
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/ref/music.html b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/ref/music.html
new file mode 100644
index 0000000..5fbe0ea
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/ref/music.html
@@ -0,0 +1,493 @@
+
+
+
+  
+    
+    
+
+    pygame.mixer.music — pygame v2.6.1 documentation
+    
+    
+    
+    
+    
+    
+    
+    
+    
+     
+    
+
+    

+
+  

+	

+	
+	

+	  

+	    Pygame Home ||
+	    Help Contents ||
+	    Reference Index
+
+        

+          
+          
+        

+	  

+	  

+	  
Most useful stuff:
+	    Color | 
+	    display | 
+	    draw | 
+	    event | 
+	    font | 
+	    image | 
+	    key | 
+	    locals | 
+	    mixer | 
+	    mouse | 
+	    Rect | 
+	    Surface | 
+	    time | 
+	    music | 
+	    pygame
+	  

+
+	  
Advanced stuff:
+	    cursors | 
+	    joystick | 
+	    mask | 
+	    sprite | 
+	    transform | 
+	    BufferProxy | 
+	    freetype | 
+	    gfxdraw | 
+	    midi | 
+	    PixelArray | 
+	    pixelcopy | 
+	    sndarray | 
+	    surfarray | 
+	    math
+	  

+
+	  
Other:
+	    camera | 
+	    controller | 
+	    examples | 
+	    fastevent | 
+	    scrap | 
+	    tests | 
+	    touch | 
+	    version
+	  

+

+

+  

+
+      

+          

+            
+

+

+

+pygame.mixer.music

+

+
pygame module for controlling streamed audio

+

+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
pygame.mixer.music.load

+		—Load a music file for playback
pygame.mixer.music.unload

+		—Unload the currently loaded music to free up resources
pygame.mixer.music.play

+		—Start the playback of the music stream
pygame.mixer.music.rewind

+		—restart music
pygame.mixer.music.stop

+		—stop the music playback
pygame.mixer.music.pause

+		—temporarily stop music playback
pygame.mixer.music.unpause

+		—resume paused music
pygame.mixer.music.fadeout

+		—stop music playback after fading out
pygame.mixer.music.set_volume

+		—set the music volume
pygame.mixer.music.get_volume

+		—get the music volume
pygame.mixer.music.get_busy

+		—check if the music stream is playing
pygame.mixer.music.set_pos

+		—set position to play from
pygame.mixer.music.get_pos

+		—get the music play time
pygame.mixer.music.queue

+		—queue a sound file to follow the current
pygame.mixer.music.set_endevent

+		—have the music send an event when playback stops
pygame.mixer.music.get_endevent

+		—get the event a channel sends when playback stops

+
The music module is closely tied to pygame.mixerpygame module for loading and playing sounds. Use the music module
+to control the playback of music in the sound mixer.

+
The difference between the music playback and regular Sound playback is that
+the music is streamed, and never actually loaded all at once. The mixer system
+only supports a single music stream at once.

+
On older pygame versions, MP3 support was limited under Mac and Linux. This
+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.

+

+

+pygame.mixer.music.load()

+

+
Load a music file for playback

+
load(filename) -> None

+
load(fileobj, namehint="") -> None

+

+
This will load a music filename/file object and prepare it for playback. If
+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

+

+

+
+

+

+pygame.mixer.music.unload()

+

+
Unload the currently loaded music to free up resources

+
unload() -> None

+

+
This closes resources like files for any music that may be loaded.

+

+
New in pygame 2.0.0.

+

+

+
+

+

+pygame.mixer.music.play()

+

+
Start the playback of the music stream

+
play(loops=0, start=0.0, fade_ms=0) -> None

+

+
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
+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
+the start position cannot be set.

+
fade_ms is an optional integer argument, which is 0 by default,
+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

+

+

+
+

+

+pygame.mixer.music.rewind()

+

+
restart music

+
rewind() -> None

+

+
Resets playback of the current music to the beginning. If pause() has
+previously been used to pause the music, the music will remain paused.

+

+
Note

+
rewind() supports a limited number of file types and notably
+WAV files are NOT supported. For unsupported file types use play()
+which will restart the music that's already playing (note that this
+will start the music playing again even if previously paused).

+

+

+
+

+

+pygame.mixer.music.stop()

+

+
stop the music playback

+
stop() -> None

+

+
Stops the music playback if it is currently playing.
+endevent will be triggered, if set.
+It won't unload the music.

+

+
+

+

+pygame.mixer.music.pause()

+

+
temporarily stop music playback

+
pause() -> None

+

+
Temporarily stop playback of the music stream. It can be resumed with the
+unpause() function.

+

+
+

+

+pygame.mixer.music.unpause()

+

+
resume paused music

+
unpause() -> None

+

+
This will resume the playback of a music stream after it has been paused.

+

+
+

+

+pygame.mixer.music.fadeout()

+

+
stop music playback after fading out

+
fadeout(time) -> None

+

+
Fade out and stop the currently playing music.

+
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 fadeout() and set_volume() will have no effect during
+this time. If an event was set using set_endevent() it will be
+called after the music has faded.

+

+
+

+

+pygame.mixer.music.set_volume()

+

+
set the music volume

+
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 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.

+

+
+

+

+pygame.mixer.music.get_volume()

+

+
get the music volume

+
get_volume() -> value

+

+
Returns the current volume for the mixer. The value will be between 0.0
+and 1.0.

+

+
+

+

+pygame.mixer.music.get_busy()

+

+
check if the music stream is playing

+
get_busy() -> bool

+

+
Returns True when the music stream is actively playing. When the music is
+idle this returns False. In pygame 2.0.1 and above this function returns
+False when the music is paused. In pygame 1 it returns True when the music
+is paused.

+

+
Changed in pygame 2.0.1: Returns False when music paused.

+

+

+
+

+

+pygame.mixer.music.set_pos()

+

+
set position to play from

+
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,
+in seconds, from the current position. For absolute positioning in an MP3
+file, first call rewind().

+
Other file formats are unsupported. Newer versions of SDL_mixer have
+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.

+

+

+
+

+

+pygame.mixer.music.get_pos()

+

+
get the music play time

+
get_pos() -> time

+

+
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.

+

+
+

+

+pygame.mixer.music.queue()

+

+
queue a sound file to follow the current

+
queue(filename) -> None

+
queue(fileobj, namehint="", loops=0) -> None

+

+
This will load a sound file and queue it. A queued sound file will begin as
+soon as the current sound naturally ends. Only one sound can be queued at a
+time. Queuing a new sound while another sound is queued will result in the
+new sound becoming the queued sound. Also, if the current sound is ever
+stopped or changed, the queued sound will be lost.

+
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: queue(fileobj, "ogg").

+
The following example will play music by Bach six times, then play music by
+Mozart once:

+
pygame.mixer.music.load('bach.ogg')
+pygame.mixer.music.play(5)        # Plays six times, not five!
+pygame.mixer.music.queue('mozart.ogg')
+

+

+

+
Changed in pygame 2.0.2: Added optional namehint argument

+

+

+
+

+

+pygame.mixer.music.set_endevent()

+

+
have the music send an event when playback stops

+
set_endevent() -> 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.

+
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.

+

+
+

+

+pygame.mixer.music.get_endevent()

+

+
get the event a channel sends when playback stops

+
get_endevent() -> type

+

+
Returns the event type to be sent every time the music finishes playback. If
+there is no endevent the function returns pygame.NOEVENT.

+

+
+

+
+

+
+
+


+

+Edit on GitHub
+            

+          

+      

+      

+    

+    
+    
+  
+
\ No newline at end of file
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/ref/overlay.html b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/ref/overlay.html
new file mode 100644
index 0000000..7f524de
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/ref/overlay.html
@@ -0,0 +1,222 @@
+
+
+
+  
+    
+    
+
+    pygame.Overlay — pygame v2.6.1 documentation
+    
+    
+    
+    
+    
+    
+    
+    
+    
+     
+    
+
+    

+
+  

+	

+	
+	

+	  

+	    Pygame Home ||
+	    Help Contents ||
+	    Reference Index
+
+        

+          
+          
+        

+	  

+	  

+	  
Most useful stuff:
+	    Color | 
+	    display | 
+	    draw | 
+	    event | 
+	    font | 
+	    image | 
+	    key | 
+	    locals | 
+	    mixer | 
+	    mouse | 
+	    Rect | 
+	    Surface | 
+	    time | 
+	    music | 
+	    pygame
+	  

+
+	  
Advanced stuff:
+	    cursors | 
+	    joystick | 
+	    mask | 
+	    sprite | 
+	    transform | 
+	    BufferProxy | 
+	    freetype | 
+	    gfxdraw | 
+	    midi | 
+	    PixelArray | 
+	    pixelcopy | 
+	    sndarray | 
+	    surfarray | 
+	    math
+	  

+
+	  
Other:
+	    camera | 
+	    controller | 
+	    examples | 
+	    fastevent | 
+	    scrap | 
+	    tests | 
+	    touch | 
+	    version
+	  

+

+

+  

+
+      

+          

+            
+

+

+
Warning

+
This module is non functional in pygame 2.0 and above, unless you have manually compiled pygame with SDL1.
+This module will not be supported in the future.

+

+

+

+pygame.Overlay

+

+
pygame object for video overlay graphics

+
Overlay(format, (width, height)) -> Overlay

+

+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
pygame.Overlay.display

+		—set the overlay pixel data
pygame.Overlay.set_location

+		—control where the overlay is displayed
pygame.Overlay.get_hardware

+		—test if the Overlay is hardware accelerated

+
The Overlay objects provide support for accessing hardware video overlays.
+Video overlays do not use standard RGB pixel formats, and can use
+multiple resolutions of data to create a single image.

+
The Overlay objects represent lower level access to the display hardware. To
+use the object you must understand the technical details of video overlays.

+
The Overlay format determines the type of pixel data used. Not all hardware
+will support all types of overlay formats. Here is a list of available
+format types:

+
YV12_OVERLAY, IYUV_OVERLAY, YUY2_OVERLAY, UYVY_OVERLAY, YVYU_OVERLAY
+

+

+
The width and height arguments control the size for the overlay image data.
+The overlay image can be displayed at any size, not just the resolution of
+the overlay.

+
The overlay objects are always visible, and always show above the regular
+display contents.

+

+

+display()

+

+
set the overlay pixel data

+
display((y, u, v)) -> None

+
display() -> None

+

+
Display the YUV data in SDL's overlay planes. The y, u, and v arguments
+are strings of binary data. The data must be in the correct format used
+to create the Overlay.

+
If no argument is passed in, the Overlay will simply be redrawn with the
+current data. This can be useful when the Overlay is not really hardware
+accelerated.

+
The strings are not validated, and improperly sized strings could crash
+the program.

+

+
+

+

+set_location()

+

+
control where the overlay is displayed

+
set_location(rect) -> None

+

+
Set the location for the overlay. The overlay will always be shown
+relative to the main display Surface. This does not actually redraw the
+overlay, it will be updated on the next call to Overlay.display().

+

+
+

+

+get_hardware()

+

+
test if the Overlay is hardware accelerated

+
get_hardware(rect) -> int

+

+
Returns a True value when the Overlay is hardware accelerated. If the
+platform does not support acceleration, software rendering is used.

+

+
+

+
+

+
+
+


+

+Edit on GitHub
+            

+          

+      

+      

+    

+    
+    
+  
+
\ No newline at end of file
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/ref/pixelarray.html b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/ref/pixelarray.html
new file mode 100644
index 0000000..f25d725
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/ref/pixelarray.html
@@ -0,0 +1,477 @@
+
+
+
+  
+    
+    
+
+    pygame.PixelArray — pygame v2.6.1 documentation
+    
+    
+    
+    
+    
+    
+    
+    
+    
+     
+    
+
+    

+
+  

+	

+	
+	

+	  

+	    Pygame Home ||
+	    Help Contents ||
+	    Reference Index
+
+        

+          
+          
+        

+	  

+	  

+	  
Most useful stuff:
+	    Color | 
+	    display | 
+	    draw | 
+	    event | 
+	    font | 
+	    image | 
+	    key | 
+	    locals | 
+	    mixer | 
+	    mouse | 
+	    Rect | 
+	    Surface | 
+	    time | 
+	    music | 
+	    pygame
+	  

+
+	  
Advanced stuff:
+	    cursors | 
+	    joystick | 
+	    mask | 
+	    sprite | 
+	    transform | 
+	    BufferProxy | 
+	    freetype | 
+	    gfxdraw | 
+	    midi | 
+	    PixelArray | 
+	    pixelcopy | 
+	    sndarray | 
+	    surfarray | 
+	    math
+	  

+
+	  
Other:
+	    camera | 
+	    controller | 
+	    examples | 
+	    fastevent | 
+	    scrap | 
+	    tests | 
+	    touch | 
+	    version
+	  

+

+

+  

+
+      

+          

+            
+

+

+

+pygame.PixelArray

+

+
pygame object for direct pixel access of surfaces

+
PixelArray(Surface) -> PixelArray

+

+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
pygame.PixelArray.surface

+		—Gets the Surface the PixelArray uses.
pygame.PixelArray.itemsize

+		—Returns the byte size of a pixel array item
pygame.PixelArray.ndim

+		—Returns the number of dimensions.
pygame.PixelArray.shape

+		—Returns the array size.
pygame.PixelArray.strides

+		—Returns byte offsets for each array dimension.
pygame.PixelArray.make_surface

+		—Creates a new Surface from the current PixelArray.
pygame.PixelArray.replace

+		—Replaces the passed color in the PixelArray with another one.
pygame.PixelArray.extract

+		—Extracts the passed color from the PixelArray.
pygame.PixelArray.compare

+		—Compares the PixelArray with another one.
pygame.PixelArray.transpose

+		—Exchanges the x and y axis.
pygame.PixelArray.close

+		—Closes the PixelArray, and releases Surface lock.

+
The PixelArray wraps a Surface and provides direct access to the
+surface's pixels. A pixel array can be one or two dimensional.
+A two dimensional array, like its surface, is indexed [column, row].
+Pixel arrays support slicing, both for returning a subarray or
+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
+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.

+
pxarray[x, y] = 0xFF00FF
+pxarray[x, y] = pygame.Color(255, 0, 255)
+pxarray[x, y] = (255, 0, 255)
+

+

+
However, only a pixel's integer value is returned. So, to compare a pixel
+to a particular color the color needs to be first mapped using
+the Surface.map_rgb() method of the Surface object for which the
+PixelArray was created.

+
pxarray = pygame.PixelArray(surface)
+# Check, if the first pixel at the topleft corner is blue
+if pxarray[0, 0] == surface.map_rgb((0, 0, 255)):
+    ...
+

+

+
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
+pxarray[a:b] = (0xFF00FF, 0xAACCEE, ... ) # first pixel = 0xFF00FF,
+                                          # second pixel  = 0xAACCEE, ...
+pxarray[a:b] = [(255, 0, 255), (170, 204, 238), ...] # same as above
+pxarray[a:b] = [(255, 0, 255), 0xAACCEE, ...]        # same as above
+pxarray[a:b] = otherarray[x:y]            # slice sizes must match
+

+

+
For PixelArray assignment, if the right hand side array has a row length
+of 1, then the column is broadcast over the target array's rows. An
+array of height 1 is broadcast over the target's columns, and is equivalent
+to assigning a 1D PixelArray.

+
Subscript slices can also be used to assign to a rectangular subview of
+the target PixelArray.

+
# Create some new PixelArray objects providing a different view
+# of the original array/surface.
+newarray = pxarray[2:4, 3:5]
+otherarray = pxarray[::2, ::2]
+

+

+
Subscript slices can also be used to do fast rectangular pixel manipulations
+instead of iterating over the x or y axis. The

+
pxarray[::2, :] = (0, 0, 0)               # Make even columns black.
+pxarray[::2] = (0, 0, 0)                  # Same as [::2, :]
+

+

+
During its lifetime, the PixelArray locks the surface, thus you explicitly
+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.

+
pxarray[::2, ...] = (0, 0, 0)             # Same as pxarray[::2, :]
+pxarray[...] = (255, 0, 0)                # Same as pxarray[:]
+

+

+
A note about PixelArray to PixelArray assignment, for arrays with an
+item size of 3 (created from 24 bit surfaces) pixel values are translated
+from the source to the destinations format. The red, green, and blue
+color elements of each pixel are shifted to match the format of the
+target surface. For all other pixel sizes no such remapping occurs.
+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.
    • 
+
  • being able to use PixelArray as a context manager for cleanup.
    • 
+
  • both of these are useful for when working without reference counting (pypy).
    • 
+

+

+

+
New in pygame 1.9.2: 

+
    
+
  • array struct interface
    • 
+
  • transpose method
    • 
+
  • broadcasting for a length 1 dimension
    • 
+

+

+

+
Changed in pygame 1.9.2: 

+
    
+
  • A 2D PixelArray can have a length 1 dimension.
+Only an integer index on a 2D PixelArray returns a 1D array.
    • 
+
  • For assignment, a tuple can only be a color. Any other sequence type
+is a sequence of colors.
    • 
+

+

+

+

+surface

+

+
Gets the Surface the PixelArray uses.

+
surface -> Surface

+

+
The Surface the PixelArray was created for.

+

+
+

+

+itemsize

+

+
Returns the byte size of a pixel array item

+
itemsize -> int

+

+
This is the same as Surface.get_bytesize() for the
+pixel array's surface.

+

+
New in pygame 1.9.2.

+

+

+
+

+

+ndim

+

+
Returns the number of dimensions.

+
ndim -> int

+

+
A pixel array can be 1 or 2 dimensional.

+

+
New in pygame 1.9.2.

+

+

+
+

+

+shape

+

+
Returns the array size.

+
shape -> tuple of int's

+

+
A tuple or length ndim giving the length of each
+dimension. Analogous to Surface.get_size().

+

+
New in pygame 1.9.2.

+

+

+
+

+

+strides

+

+
Returns byte offsets for each array dimension.

+
strides -> tuple of int's

+

+
A tuple or length ndim byte counts. When a stride is
+multiplied by the corresponding index it gives the offset
+of that index from the start of the array. A stride is negative
+for an array that has is inverted (has a negative step).

+

+
New in pygame 1.9.2.

+

+

+
+

+

+make_surface()

+

+
Creates a new Surface from the current PixelArray.

+
make_surface() -> Surface

+

+
Creates a new Surface from the current PixelArray. Depending on the
+current PixelArray the size, pixel order etc. will be different from the
+original Surface.

+
# Create a new surface flipped around the vertical axis.
+sf = pxarray[:,::-1].make_surface ()
+

+

+

+
New in pygame 1.8.1.

+

+

+
+

+

+replace()

+

+
Replaces the passed color in the PixelArray with another one.

+
replace(color, repcolor, distance=0, weights=(0.299, 0.587, 0.114)) -> None

+

+
Replaces the pixels with the passed color in the PixelArray by changing
+them them to the passed replacement color.

+
It uses a simple weighted Euclidean distance formula to calculate the
+distance between the colors. The distance space ranges from 0.0 to 1.0
+and is used as threshold for the color detection. This causes the
+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.

+

+
New in pygame 1.8.1.

+

+

+
+

+

+extract()

+

+
Extracts the passed color from the PixelArray.

+
extract(color, distance=0, weights=(0.299, 0.587, 0.114)) -> PixelArray

+

+
Extracts the passed color by changing all matching pixels to white, while
+non-matching pixels are changed to black. This returns a new PixelArray
+with the black/white color mask.

+
It uses a simple weighted Euclidean distance formula to calculate the
+distance between the colors. The distance space ranges from 0.0 to 1.0
+and is used as threshold for the color detection. This causes the
+extraction to take pixels with a similar, but not exactly identical
+color, into account as well.

+

+
New in pygame 1.8.1.

+

+

+
+

+

+compare()

+

+
Compares the PixelArray with another one.

+
compare(array, distance=0, weights=(0.299, 0.587, 0.114)) -> PixelArray

+

+
Compares the contents of the PixelArray with those from the passed in
+PixelArray. It returns a new PixelArray with a black/white color mask
+that indicates the differences (black) of both arrays. Both PixelArray
+objects must have identical bit depths and dimensions.

+
It uses a simple weighted Euclidean distance formula to calculate the
+distance between the colors. The distance space ranges from 0.0 to 1.0
+and is used as a threshold for the color detection. This causes the
+comparison to mark pixels with a similar, but not exactly identical
+color, as white.

+

+
New in pygame 1.8.1.

+

+

+
+

+

+transpose()

+

+
Exchanges the x and y axis.

+
transpose() -> PixelArray

+

+
This method returns a new view of the pixel array with the rows and
+columns swapped. So for a (w, h) sized array a (h, w) slice is returned.
+If an array is one dimensional, then a length 1 x dimension is added,
+resulting in a 2D pixel array.

+

+
New in pygame 1.9.2.

+

+

+
+

+

+close()

+

+
Closes the PixelArray, and releases Surface lock.

+
close() -> PixelArray

+

+
This method is for explicitly closing the PixelArray, and releasing
+a lock on the Surface.

+

+
New in pygame 1.9.4.

+

+

+
+

+
+

+
+
+


+

+Edit on GitHub
+            

+          

+      

+      

+    

+    
+    
+  
+
\ No newline at end of file
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/ref/pixelcopy.html b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/ref/pixelcopy.html
new file mode 100644
index 0000000..b79ebe8
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/ref/pixelcopy.html
@@ -0,0 +1,253 @@
+
+
+
+  
+    
+    
+
+    pygame.pixelcopy — pygame v2.6.1 documentation
+    
+    
+    
+    
+    
+    
+    
+    
+    
+     
+    
+
+    

+
+  

+	

+	
+	

+	  

+	    Pygame Home ||
+	    Help Contents ||
+	    Reference Index
+
+        

+          
+          
+        

+	  

+	  

+	  
Most useful stuff:
+	    Color | 
+	    display | 
+	    draw | 
+	    event | 
+	    font | 
+	    image | 
+	    key | 
+	    locals | 
+	    mixer | 
+	    mouse | 
+	    Rect | 
+	    Surface | 
+	    time | 
+	    music | 
+	    pygame
+	  

+
+	  
Advanced stuff:
+	    cursors | 
+	    joystick | 
+	    mask | 
+	    sprite | 
+	    transform | 
+	    BufferProxy | 
+	    freetype | 
+	    gfxdraw | 
+	    midi | 
+	    PixelArray | 
+	    pixelcopy | 
+	    sndarray | 
+	    surfarray | 
+	    math
+	  

+
+	  
Other:
+	    camera | 
+	    controller | 
+	    examples | 
+	    fastevent | 
+	    scrap | 
+	    tests | 
+	    touch | 
+	    version
+	  

+

+

+  

+
+      

+          

+            
+

+

+

+pygame.pixelcopy

+

+
pygame module for general pixel array copying

+

+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
pygame.pixelcopy.surface_to_array

+		—copy surface pixels to an array object
pygame.pixelcopy.array_to_surface

+		—copy an array object to a surface
pygame.pixelcopy.map_array

+		—copy an array to another array, using surface format
pygame.pixelcopy.make_surface

+		—Copy an array to a new surface

+
The pygame.pixelcopy module contains functions for copying between
+surfaces and objects exporting an array structure interface. It is a backend
+for pygame.surfarraypygame module for accessing surface pixel data using array interfaces, 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 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

+
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 Surface.set_colorkey()),
+or has a blanket alpha
+(set with 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 pygame.surfarray.array_colorkey()Copy the colorkey values into a 2d array.

+
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.array_to_surface()

+

+
copy an array object to a surface

+
array_to_surface(<surface>, <array>) -> None

+

+
See pygame.surfarray.blit_array()Blit directly from a array values.

+

+
+

+

+pygame.pixelcopy.map_array()

+

+
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>.

+

+
+

+

+pygame.pixelcopy.make_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.

+

+
+

+
+

+
+
+


+

+Edit on GitHub
+            

+          

+      

+      

+    

+    
+    
+  
+
\ No newline at end of file
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/ref/pygame.html b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/ref/pygame.html
new file mode 100644
index 0000000..4b932a5
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/ref/pygame.html
@@ -0,0 +1,696 @@
+
+
+
+  
+    
+    
+
+    pygame — pygame v2.6.1 documentation
+    
+    
+    
+    
+    
+    
+    
+    
+    
+     
+    
+
+    

+
+  

+	

+	
+	

+	  

+	    Pygame Home ||
+	    Help Contents ||
+	    Reference Index
+
+        

+          
+          
+        

+	  

+	  

+	  
Most useful stuff:
+	    Color | 
+	    display | 
+	    draw | 
+	    event | 
+	    font | 
+	    image | 
+	    key | 
+	    locals | 
+	    mixer | 
+	    mouse | 
+	    Rect | 
+	    Surface | 
+	    time | 
+	    music | 
+	    pygame
+	  

+
+	  
Advanced stuff:
+	    cursors | 
+	    joystick | 
+	    mask | 
+	    sprite | 
+	    transform | 
+	    BufferProxy | 
+	    freetype | 
+	    gfxdraw | 
+	    midi | 
+	    PixelArray | 
+	    pixelcopy | 
+	    sndarray | 
+	    surfarray | 
+	    math
+	  

+
+	  
Other:
+	    camera | 
+	    controller | 
+	    examples | 
+	    fastevent | 
+	    scrap | 
+	    tests | 
+	    touch | 
+	    version
+	  

+

+

+  

+
+      

+          

+            
+

+

+

+pygame

+

+
the top level pygame package

+

+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
pygame.init

+		—initialize all imported pygame modules
pygame.quit

+		—uninitialize all pygame modules
pygame.get_init

+		—returns True if pygame is currently initialized
pygame.error

+		—standard pygame exception
pygame.get_error

+		—get the current error message
pygame.set_error

+		—set the current error message
pygame.get_sdl_version

+		—get the version number of SDL
pygame.get_sdl_byteorder

+		—get the byte order of SDL
pygame.register_quit

+		—register a function to be called when pygame quits
pygame.encode_string

+		—Encode a Unicode or bytes object
pygame.encode_file_path

+		—Encode a Unicode or bytes object as a file system path

+
The pygame package represents the top-level package for others to use. Pygame
+itself is broken into many submodules, but this does not affect programs that
+use pygame.

+
As a convenience, most of the top-level variables in pygame have been placed
+inside a module named pygame.localspygame constants. This is meant to be used with
+from pygame.locals import *, in addition to import pygame.

+
When you import pygame all available pygame submodules are automatically
+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.

+

+

+pygame.init()

+

+
initialize all imported pygame modules

+
init() -> (numpass, numfail)

+

+
Initialize all imported pygame modules. No exceptions will be raised if a
+module fails, but the total number if successful and failed inits will be
+returned as a tuple. You can always initialize individual modules manually,
+but pygame.init()initialize all imported pygame modules is a convenient way to get everything started. The
+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 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.

+

+
+

+

+pygame.quit()

+

+
uninitialize all pygame modules

+
quit() -> None

+

+
Uninitialize all pygame modules that have previously been initialized. When
+the Python interpreter shuts down, this method is called regardless, so your
+program should not need it, except when it wants to terminate its pygame
+resources and continue. It is safe to call this function more than once as
+repeated calls have no effect.

+

+
Note

+
Calling pygame.quit()uninitialize all pygame modules will not exit your program. Consider letting
+your program end in the same way a normal Python program will end.

+

+

+
+

+

+pygame.get_init()

+

+
returns True if pygame is currently initialized

+
get_init() -> bool

+

+
Returns True if pygame is currently initialized.

+

+
New in pygame 1.9.5.

+

+

+
+

+

+exception pygame.error

+

+
standard pygame exception

+
raise pygame.error(message)

+

+
This exception is raised whenever a pygame or SDL operation fails. You
+can catch any anticipated problems and deal with the error. The exception is
+always raised with a descriptive message about the problem.

+
Derived from the RuntimeError exception, which can also be used to catch
+these raised errors.

+

+
+

+

+pygame.get_error()

+

+
get the current error message

+
get_error() -> errorstr

+

+
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
+rarely be needed.

+

+
+

+

+pygame.set_error()

+

+
set the current error message

+
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
+rarely be needed.

+

+
+

+

+pygame.get_sdl_version()

+

+
get the version number of SDL

+
get_sdl_version(linked=True) -> major, minor, patch

+

+
Returns the three version numbers of the SDL library. linked=True
+will cause the function to return the version of the library that pygame
+is linked against while linked=False will cause the function to return
+the version of the library that pygame is compiled against.
+It can be used to detect which features may or may not be
+available through pygame.

+

+
New in pygame 1.7.0.

+

+

+
Changed in pygame 2.2.0: linked keyword argument added

+

+

+
+

+

+pygame.get_sdl_byteorder()

+

+
get the byte order of SDL

+
get_sdl_byteorder() -> int

+

+
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.

+

+

+
+

+

+pygame.register_quit()

+

+
register a function to be called when pygame quits

+
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
+this function will rarely be needed.

+

+
+

+

+pygame.encode_string()

+

+
Encode a Unicode or bytes object

+
encode_string([obj [, encoding [, errors [, etype]]]]) -> bytes or None

+

+
obj: If Unicode, encode; if bytes, return unaltered; if anything else,
+return None; if not given, raise SyntaxError.

+
encoding (string): If present, encoding to use. The default is
+'unicode_escape'.

+
errors (string): If given, how to handle unencodable characters. The default
+is 'backslashreplace'.

+
etype (exception type): If given, the exception type to raise for an
+encoding error. The default is UnicodeEncodeError, as returned by
+PyUnicode_AsEncodedString(). For the default encoding and errors values
+there should be no encoding errors.

+
This function is used in encoding file paths. Keyword arguments are
+supported.

+

+
New in pygame 1.9.2: (primarily for use in unit tests)

+

+

+
+

+

+pygame.encode_file_path()

+

+
Encode a Unicode or bytes object as a file system path

+
encode_file_path([obj [, etype]]) -> bytes or None

+

+
obj: If Unicode, encode; if bytes, return unaltered; if anything else,
+return None; if not given, raise SyntaxError.

+
etype (exception type): If given, the exception type to raise for an
+encoding error. The default is UnicodeEncodeError, as returned by
+PyUnicode_AsEncodedString().

+
This function is used to encode file paths in pygame. Encoding is to the
+codec as returned by sys.getfilesystemencoding(). Keyword arguments are
+supported.

+

+
New in pygame 1.9.2: (primarily for use in unit tests)

+

+

+
+

+
+

+

+

+

+pygame.version

+

+
small module containing version information

+

+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
pygame.version.ver

+		—version number as a string
pygame.version.vernum

+		—tupled integers of the version
pygame.version.rev

+		—repository revision of the build
pygame.version.SDL

+		—tupled integers of the SDL library version

+
This module is automatically imported into the pygame package and can be used to
+check which version of pygame has been imported.

+

+

+pygame.version.ver

+

+
version number as a string

+
ver = '1.2'

+

+
This is the version represented as a string. It can contain a micro release
+number as well, e.g. '1.5.2'

+

+
+

+

+pygame.version.vernum

+

+
tupled integers of the version

+
vernum = (1, 5, 3)

+

+
This version information can easily be compared with other version
+numbers of the same format. An example of checking pygame version numbers
+would look like this:

+
if pygame.version.vernum < (1, 5):
+    print('Warning, older version of pygame (%s)' %  pygame.version.ver)
+    disable_advanced_features = True
+

+

+

+
New in pygame 1.9.6: Attributes major, minor, and patch.

+

+
vernum.major == vernum[0]
+vernum.minor == vernum[1]
+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)".

+

+

+
+

+

+pygame.version.rev

+

+
repository revision of the build

+
rev = 'a6f89747b551+'

+

+
The Mercurial node identifier of the repository checkout from which this
+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
+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 "".

+

+

+
+

+

+pygame.version.SDL

+

+
tupled integers of the SDL library version

+
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:

+
>>> pygame.version.SDL.major
+2
+

+

+
printing the whole thing returns a string like this:

+
>>> pygame.version.SDL
+SDLVersion(major=2, minor=0, patch=12)
+

+

+

+
New in pygame 2.0.0.

+

+

+
+
Setting Environment Variables

+
Some aspects of pygame's behaviour can be controlled by setting environment variables, they cover a wide
+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
+os.environ['NAME_OF_ENVIRONMENT_VARIABLE'] = 'value_to_set'
+

+

+
Or to preserve users ability to override the variable:

+
import os
+os.environ['ENV_VAR'] = os.environ.get('ENV_VAR', 'value')
+

+

+
If the variable is more useful for users of an app to set than the developer then they can set it like this:

+
Windows:

+
set NAME_OF_ENVIRONMENT_VARIABLE=value_to_set
+python my_application.py
+

+

+
Linux/Mac:

+
ENV_VAR=value python my_application.py
+

+

+
For some variables they need to be set before initialising pygame, some must be set before even importing pygame,
+and others can simply be set right before the area of code they control is run.

+
Below is a list of environment variables, their settable values, and a brief description of what they do.

+

+


+

+
Pygame Environment Variables

+
These variables are defined by pygame itself.

+

+


+

+
PYGAME_DISPLAY - Experimental (subject to change)
+Set index of the display to use, "0" is the default.
+

+

+
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.

+

+


+

+
PYGAME_FORCE_SCALE -
+Set to "photo" or "default".
+

+

+
This forces set_mode() to use the SCALED display mode and,
+if "photo" is set, makes the scaling use the slowest, but
+highest quality anisotropic scaling algorithm, if it is
+available. Must be set before calling pygame.display.set_mode()Initialize a window or screen for display.

+

+


+

+
PYGAME_BLEND_ALPHA_SDL2 - New in pygame 2.0.0
+Set to "1" to enable the SDL2 blitter.
+

+

+
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 colours may differ. Must be set before
+pygame.init()initialize all imported pygame modules is called.

+

+


+

+
PYGAME_HIDE_SUPPORT_PROMPT -
+Set to "1" to hide the prompt.
+

+

+
This stops the welcome message popping up in the
+console that tells you which version of python,
+pygame & SDL you are using. Must be set before
+importing pygame.

+

+


+

+
PYGAME_FREETYPE -
+Set to "1" to enable.
+

+

+
This switches the pygame.font module to a pure
+freetype implementation that bypasses SDL_ttf.
+See the font module for why you might want to
+do this. Must be set before importing pygame.

+

+


+

+
PYGAME_CAMERA -
+Set to "opencv" or "vidcapture"
+

+

+
Forces the library backend used in the camera
+module, overriding the platform defaults. Must
+be set before calling pygame.camera.init()Module init.

+
In pygame 2.0.3, backends can be set programmatically instead, and the old
+OpenCV backend has been replaced with one on top of "opencv-python," rather
+than the old "highgui" OpenCV port. Also, there is a new native Windows
+backend available.

+

+


+


+

+
SDL Environment Variables

+
These variables are defined by SDL.

+
For documentation on the environment variables available in
+pygame 1 try here.
+For Pygame 2, some selected environment variables are listed below.

+

+


+

+
SDL_VIDEO_CENTERED -
+Set to "1" to enable centering the window.
+

+

+
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.

+

+


+

+
SDL_VIDEO_WINDOW_POS -
+Set to "x,y" to position the top left corner of the window.
+

+

+
This allows control over the placement of the pygame window within
+the display. Must be set before calling pygame.display.set_mode()Initialize a window or screen for display.

+

+


+

+
SDL_VIDEODRIVER -
+Set to "drivername" to change the video driver used.
+

+

+
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.

+

+


+

+
SDL_AUDIODRIVER -
+Set to "drivername" to change the audio driver used.
+

+

+
On some platforms there are multiple audio 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.mixer.init()initialize the mixer module.

+

+


+

+
SDL_VIDEO_ALLOW_SCREENSAVER
+Set to "1" to allow screensavers while pygame apps are running.
+

+

+
By default pygame apps disable screensavers while
+they are running. Setting this environment variable allows users or
+developers to change that and make screensavers run again.

+

+


+

+
SDL_VIDEO_X11_NET_WM_BYPASS_COMPOSITOR
+Set to "0" to re-enable the compositor.
+

+

+
By default SDL tries to disable the X11 compositor for all pygame
+apps. This is usually a good thing as it's faster, however if you
+have an app which doesn't update every frame and are using linux
+you may want to disable this bypass. The bypass has reported problems
+on KDE linux. This variable is only used on x11/linux platforms.

+

+


+

+
SDL_JOYSTICK_ALLOW_BACKGROUND_EVENTS
+Set to "1" to allow joysticks to be updated even when the window is out of focus
+

+

+
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 pygame.init()initialize all imported pygame modules or pygame.joystick.init()Initialize the joystick module..

+

+
+

+
+
+


+

+Edit on GitHub
+            

+          

+      

+      

+    

+    
+    
+  
+
\ No newline at end of file
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/ref/rect.html b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/ref/rect.html
new file mode 100644
index 0000000..336228e
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/ref/rect.html
@@ -0,0 +1,901 @@
+
+
+
+  
+    
+    
+
+    pygame.Rect — pygame v2.6.1 documentation
+    
+    
+    
+    
+    
+    
+    
+    
+    
+     
+    
+
+    

+
+  

+	

+	
+	

+	  

+	    Pygame Home ||
+	    Help Contents ||
+	    Reference Index
+
+        

+          
+          
+        

+	  

+	  

+	  
Most useful stuff:
+	    Color | 
+	    display | 
+	    draw | 
+	    event | 
+	    font | 
+	    image | 
+	    key | 
+	    locals | 
+	    mixer | 
+	    mouse | 
+	    Rect | 
+	    Surface | 
+	    time | 
+	    music | 
+	    pygame
+	  

+
+	  
Advanced stuff:
+	    cursors | 
+	    joystick | 
+	    mask | 
+	    sprite | 
+	    transform | 
+	    BufferProxy | 
+	    freetype | 
+	    gfxdraw | 
+	    midi | 
+	    PixelArray | 
+	    pixelcopy | 
+	    sndarray | 
+	    surfarray | 
+	    math
+	  

+
+	  
Other:
+	    camera | 
+	    controller | 
+	    examples | 
+	    fastevent | 
+	    scrap | 
+	    tests | 
+	    touch | 
+	    version
+	  

+

+

+  

+
+      

+          

+            
+

+

+

+pygame.Rect

+

+
pygame object for storing rectangular coordinates

+
Rect(left, top, width, height) -> Rect

+
Rect((left, top), (width, height)) -> Rect

+
Rect(object) -> Rect

+

+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
pygame.Rect.copy

+		—copy the rectangle
pygame.Rect.move

+		—moves the rectangle
pygame.Rect.move_ip

+		—moves the rectangle, in place
pygame.Rect.inflate

+		—grow or shrink the rectangle size
pygame.Rect.inflate_ip

+		—grow or shrink the rectangle size, in place
pygame.Rect.scale_by

+		—scale the rectangle by given a multiplier
pygame.Rect.scale_by_ip

+		—grow or shrink the rectangle size, in place
pygame.Rect.update

+		—sets the position and size of the rectangle
pygame.Rect.clamp

+		—moves the rectangle inside another
pygame.Rect.clamp_ip

+		—moves the rectangle inside another, in place
pygame.Rect.clip

+		—crops a rectangle inside another
pygame.Rect.clipline

+		—crops a line inside a rectangle
pygame.Rect.union

+		—joins two rectangles into one
pygame.Rect.union_ip

+		—joins two rectangles into one, in place
pygame.Rect.unionall

+		—the union of many rectangles
pygame.Rect.unionall_ip

+		—the union of many rectangles, in place
pygame.Rect.fit

+		—resize and move a rectangle with aspect ratio
pygame.Rect.normalize

+		—correct negative sizes
pygame.Rect.contains

+		—test if one rectangle is inside another
pygame.Rect.collidepoint

+		—test if a point is inside a rectangle
pygame.Rect.colliderect

+		—test if two rectangles overlap
pygame.Rect.collidelist

+		—test if one rectangle in a list intersects
pygame.Rect.collidelistall

+		—test if all rectangles in a list intersect
pygame.Rect.collideobjects

+		—test if any object in a list intersects
pygame.Rect.collideobjectsall

+		—test if all objects in a list intersect
pygame.Rect.collidedict

+		—test if one rectangle in a dictionary intersects
pygame.Rect.collidedictall

+		—test if all rectangles in a dictionary intersect

+
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
+have an attribute named "rect".

+
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 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
+None but affects the original Rect. These "in-place" methods are denoted
+with the "ip" suffix.

+
The Rect object has several virtual attributes which can be used to move and
+align the Rect:

+
x,y
+top, left, bottom, right
+topleft, bottomleft, topright, bottomright
+midtop, midleft, midbottom, midright
+center, centerx, centery
+size, width, height
+w,h
+

+

+
All of these attributes can be assigned to:

+
rect1.right = 10
+rect2.center = (20,30)
+

+

+
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
+nonzero test. Some methods return a Rect with 0 size to represent an invalid
+rectangle. A Rect with a 0 size will not collide when using collision
+detection methods (e.g. collidepoint(), colliderect(), etc.).

+
The coordinates for Rect objects are all integers. The size values can be
+programmed to have negative values, but these are considered illegal Rects
+for most operations.

+
There are several collision tests between other rectangles. Most python
+containers can be searched for collisions against a single Rect.

+
The area covered by a Rect does not include the right- and bottom-most edge
+of pixels. If one Rect's bottom border is another Rect's top border (i.e.,
+rect1.bottom=rect2.top), the two meet exactly on the screen but do not
+overlap, and rect1.colliderect(rect2) returns false.

+
The Rect object is also iterable:

+
r = Rect(0, 1, 2, 3)
+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.

+

+

+

+copy()

+

+
copy the rectangle

+
copy() -> Rect

+

+
Returns a new rectangle having the same position and size as the original.

+
New in pygame 1.9

+

+
+

+

+move()

+

+
moves the rectangle

+
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.

+

+
+

+

+move_ip()

+

+
moves the rectangle, in place

+
move_ip(x, y) -> None

+

+
Same as the Rect.move() method, but operates in place.

+

+
+

+

+inflate()

+

+
grow or shrink the rectangle size

+
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
+will shrink the rectangle. Note, uses integers, if the offset given is
+too small(< 2 > -2), center will be off.

+

+
+

+

+inflate_ip()

+

+
grow or shrink the rectangle size, in place

+
inflate_ip(x, y) -> None

+

+
Same as the Rect.inflate() method, but operates in place.

+

+
+

+

+scale_by()

+

+
scale the rectangle by given a multiplier

+
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.

+

+
Changed in pygame 2.5.0: Added support for keyword arguments.

+

+

+
+

+

+scale_by_ip()

+

+
grow or shrink the rectangle size, in place

+
scale_by_ip(scalar) -> None

+
scale_by_ip(scalex, scaley) -> None

+

+
Same as the Rect.scale_by() method, but operates in place.

+

+
Changed in pygame 2.5.0: Added support for keyword arguments.

+

+

+
+

+

+update()

+

+
sets the position and size of the rectangle

+
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.

+

+

+
+

+

+clamp()

+

+
moves the rectangle inside another

+
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
+centered inside the argument Rect, but its size is not changed.

+

+
+

+

+clamp_ip()

+

+
moves the rectangle inside another, in place

+
clamp_ip(Rect) -> None

+

+
Same as the Rect.clamp() method, but operates in place.

+

+
+

+

+clip()

+

+
crops a rectangle inside another

+
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
+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))) -> ()

+

+
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
+tuple is returned.

+
The line to crop can be any of the following formats (floats can be used
+in place of ints, but they will be truncated):

+

+
    
+
  • four ints
    • 
+
  • 2 lists/tuples/Vector2s of 2 ints
    • 
+
  • a list/tuple of four ints
    • 
+
  • a list/tuple of 2 lists/tuples/Vector2s of 2 ints
    • 
+

+

+

+
Returns:

+
a tuple with the coordinates of the given line cropped to be
+completely inside the rectangle is returned, if the given line does
+not overlap the rectangle, an empty tuple is returned

+

+
Return type:

+
tuple(tuple(int, int), tuple(int, int)) or ()

+

+
Raises:

+
TypeError -- if the line coordinates are not given as one of the
+above described line formats

+

+

+

+
Note

+
This method can be used for collision detection between a rect and a
+line. See example code below.

+

+

+
Note

+
The rect.bottom and rect.right attributes of a
+pygame.Rectpygame object for storing rectangular coordinates always lie one pixel outside of its actual border.

+

+
# Example using clipline().
+clipped_line = rect.clipline(line)
+
+if clipped_line:
+    # If clipped_line is not an empty tuple then the line
+    # collides/overlaps with the rect. The returned value contains
+    # the endpoints of the clipped line.
+    start, end = clipped_line
+    x1, y1 = start
+    x2, y2 = end
+else:
+    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.

+

+

+
+

+

+union()

+

+
joins two rectangles into one

+
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
+covered by the originals.

+

+
+

+

+union_ip()

+

+
joins two rectangles into one, in place

+
union_ip(Rect) -> None

+

+
Same as the Rect.union() method, but operates in place.

+

+
+

+

+unionall()

+

+
the union of many rectangles

+
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.

+

+

+
+

+

+unionall_ip()

+

+
the union of many rectangles, in place

+
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.

+

+

+
+

+

+fit()

+

+
resize and move a rectangle with aspect ratio

+
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
+be smaller than the target in either width or height.

+

+
+

+

+normalize()

+

+
correct negative sizes

+
normalize() -> None

+

+
This will flip the width or height of a rectangle if it has a negative
+size. The rectangle will remain in the same place, with only the sides
+swapped.

+

+
+

+

+contains()

+

+
test if one rectangle is inside another

+
contains(Rect) -> bool

+

+
Returns true when the argument is completely inside the Rect.

+

+
+

+

+collidepoint()

+

+
test if a point is inside a rectangle

+
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.

+

+
Note

+
For collision detection between a rect and a line the clipline()
+method can be used.

+

+

+
+

+

+colliderect()

+

+
test if two rectangles overlap

+
colliderect(Rect) -> bool

+

+
Returns true if any portion of either rectangle overlap (except the
+top+bottom or left+right edges).

+

+
Note

+
For collision detection between a rect and a line the clipline()
+method can be used.

+

+

+
+

+

+collidelist()

+

+
test if one rectangle in a list intersects

+
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.

+

+

+
+

+

+collidelistall()

+

+
test if all rectangles in a list intersect

+
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:

+
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.

+

+

+
+

+

+collideobjects()

+

+
test if any object in a list intersects

+
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

+
If key is given, then it should be a method taking an object from the list
+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.

+
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 2.1.3.

+

+

+
+

+

+collideobjectsall()

+

+
test if all objects in a list intersect

+
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.

+
If key is given, then it should be a method taking an object from the list
+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.

+
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 2.1.3.

+

+

+
+

+

+collidedict()

+

+
test if one rectangle in a dictionary intersects

+
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
+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

+
Rect objects cannot be used as keys in a dictionary (they are not
+hashable), so they must be converted to a tuple.
+e.g. rect.collidedict({tuple(key_rect) : value})

+

+

+
Changed in pygame 2.5.0: Added support for keyword arguments.

+

+

+
+

+

+collidedictall()

+

+
test if all rectangles in a dictionary intersect

+
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 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

+
Rect objects cannot be used as keys in a dictionary (they are not
+hashable), so they must be converted to a tuple.
+e.g. rect.collidedictall({tuple(key_rect) : value})

+

+

+
Changed in pygame 2.5.0: Added support for keyword arguments.

+

+

+
+

+
+

+
+
+


+

+Edit on GitHub
+            

+          

+      

+      

+    

+    
+    
+  
+
\ No newline at end of file
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/ref/scrap.html b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/ref/scrap.html
new file mode 100644
index 0000000..97df7b7
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/ref/scrap.html
@@ -0,0 +1,449 @@
+
+
+
+  
+    
+    
+
+    pygame.scrap — pygame v2.6.1 documentation
+    
+    
+    
+    
+    
+    
+    
+    
+    
+     
+    
+
+    

+
+  

+	

+	
+	

+	  

+	    Pygame Home ||
+	    Help Contents ||
+	    Reference Index
+
+        

+          
+          
+        

+	  

+	  

+	  
Most useful stuff:
+	    Color | 
+	    display | 
+	    draw | 
+	    event | 
+	    font | 
+	    image | 
+	    key | 
+	    locals | 
+	    mixer | 
+	    mouse | 
+	    Rect | 
+	    Surface | 
+	    time | 
+	    music | 
+	    pygame
+	  

+
+	  
Advanced stuff:
+	    cursors | 
+	    joystick | 
+	    mask | 
+	    sprite | 
+	    transform | 
+	    BufferProxy | 
+	    freetype | 
+	    gfxdraw | 
+	    midi | 
+	    PixelArray | 
+	    pixelcopy | 
+	    sndarray | 
+	    surfarray | 
+	    math
+	  

+
+	  
Other:
+	    camera | 
+	    controller | 
+	    examples | 
+	    fastevent | 
+	    scrap | 
+	    tests | 
+	    touch | 
+	    version
+	  

+

+

+  

+
+      

+          

+            
+

+

+

+pygame.scrap

+

+
pygame module for clipboard support.

+

+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
pygame.scrap.init

+		—Initializes the scrap module.
pygame.scrap.get_init

+		—Returns True if the scrap module is currently initialized.
pygame.scrap.get

+		—Gets the data for the specified type from the clipboard.
pygame.scrap.get_types

+		—Gets a list of the available clipboard types.
pygame.scrap.put

+		—Places data into the clipboard.
pygame.scrap.contains

+		—Checks whether data for a given type is available in the clipboard.
pygame.scrap.lost

+		—Indicates if the clipboard ownership has been lost by the pygame application.
pygame.scrap.set_mode

+		—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 cutting and pasting data between pygame and other applications. Some basic
+data (MIME) types are defined and registered:

+
 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:

+
"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:

+
"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).

+

+
New in pygame 1.8.

+

+

+
Note

+
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.

+

+

+

+pygame.scrap.init()

+

+
Initializes the scrap module.

+
init() -> None

+

+
Initialize the scrap module.

+

+
Raises:

+
pygame.errorstandard pygame exception -- if unable to initialize scrap module

+

+

+

+
Note

+
The scrap module requires pygame.display.set_mode()Initialize a window or screen for display be
+called before being initialized.

+

+

+
+

+

+pygame.scrap.get_init()

+

+
Returns True if the scrap module is currently initialized.

+
get_init() -> bool

+

+
Gets the scrap module's initialization state.

+

+
Returns:

+
True if the pygame.scrappygame module for clipboard support. module is currently
+initialized, False otherwise

+

+
Return type:

+
bool

+

+

+

+
New in pygame 1.9.5.

+

+

+
+

+

+pygame.scrap.get()

+

+
Gets the data for the specified type from the clipboard.

+
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
+decoding to Unicode).

+

+
Parameters:

+
type (string) -- data type to retrieve from the clipboard

+

+
Returns:

+
data (bytes object) for the given type identifier or None if
+no data for the given type is available

+

+
Return type:

+
bytes | None

+

+

+
text = pygame.scrap.get(pygame.SCRAP_TEXT)
+if text:
+    print("There is text in the clipboard.")
+else:
+    print("There does not seem to be text in the clipboard.")
+

+

+

+
+

+

+pygame.scrap.get_types()

+

+
Gets a list of the available clipboard types.

+
get_types() -> list

+

+
Gets a list of data type string identifiers for the data currently
+available on the clipboard. Each identifier can be used in the
+pygame.scrap.get()Gets the data for the specified type from the clipboard. method to get the clipboard content of the
+specific type.

+

+
Returns:

+
list of strings of the available clipboard data types, if there
+is no data in the clipboard an empty list is returned

+

+
Return type:

+
list

+

+

+
for t in pygame.scrap.get_types():
+    if "text" in t:
+        # There is some content with the word "text" in its type string.
+        print(pygame.scrap.get(t))
+

+

+

+
+

+

+pygame.scrap.put()

+

+
Places data into the clipboard.

+
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_PBM, pygame.SCRAP_PPM, pygame.SCRAP_BMP or
+pygame.SCRAP_TEXT values or a user defined string identifier.

+

+
Parameters:

+
    
+
  • type (string) -- type identifier of the data to be placed into the
+clipboard
    • 
+
  • data (bytes) -- data to be place into the clipboard, a bytes object
    • 
+

+

+
Raises:

+
pygame.errorstandard pygame exception -- if unable to put the data into the clipboard

+

+

+
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
+# it.
+pygame.scrap.put(pygame.SCRAP_TEXT, b"A text to copy")
+pygame.scrap.put("Plain text", b"Data for user defined type 'Plain text'")
+

+

+

+
+

+

+pygame.scrap.contains()

+

+
Checks whether data for a given type is available in the clipboard.

+
contains(type) -> bool

+

+
Checks whether data for the given type is currently available in the
+clipboard.

+

+
Parameters:

+
type (string) -- data type to check availability of

+

+
Returns:

+
True if data for the passed type is available in the
+clipboard, False otherwise

+

+
Return type:

+
bool

+

+

+
if pygame.scrap.contains(pygame.SCRAP_TEXT):
+    print("There is text in the clipboard.")
+if pygame.scrap.contains("own_data_type"):
+    print("There is stuff in the clipboard.")
+

+

+

+
+

+

+pygame.scrap.lost()

+

+
Indicates if the clipboard ownership has been lost by the pygame application.

+
lost() -> bool

+

+
Indicates if the clipboard ownership has been lost by the pygame
+application.

+

+
Returns:

+
True, if the clipboard ownership has been lost by the pygame
+application, False if the pygame application still owns the clipboard

+

+
Return type:

+
bool

+

+

+
if pygame.scrap.lost():
+    print("The clipboard is in use by another application.")
+

+

+

+
+

+

+pygame.scrap.set_mode()

+

+
Sets the clipboard access mode.

+
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
+selections) and pygame.SCRAP_CLIPBOARD (for the clipboard) are
+available. Setting the mode to pygame.SCRAP_SELECTION in other
+environments will not change the mode from pygame.SCRAP_CLIPBOARD.

+

+
Parameters:

+
mode -- access mode, supported values are pygame.SCRAP_CLIPBOARD
+and pygame.SCRAP_SELECTION (pygame.SCRAP_SELECTION only has an
+effect when used on X11 platforms)

+

+
Raises:

+
ValueError -- if the mode parameter is not
+pygame.SCRAP_CLIPBOARD or pygame.SCRAP_SELECTION

+

+

+

+
+

+
+

+
+
+


+

+Edit on GitHub
+            

+          

+      

+      

+    

+    
+    
+  
+
\ No newline at end of file
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/ref/sdl2_controller.html b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/ref/sdl2_controller.html
new file mode 100644
index 0000000..3ddb419
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/ref/sdl2_controller.html
@@ -0,0 +1,559 @@
+
+
+
+  
+    
+    
+
+    pygame._sdl2.controller — pygame v2.6.1 documentation
+    
+    
+    
+    
+    
+    
+    
+    
+    
+     
+    
+
+    

+
+  

+	

+	
+	

+	  

+	    Pygame Home ||
+	    Help Contents ||
+	    Reference Index
+
+        

+          
+          
+        

+	  

+	  

+	  
Most useful stuff:
+	    Color | 
+	    display | 
+	    draw | 
+	    event | 
+	    font | 
+	    image | 
+	    key | 
+	    locals | 
+	    mixer | 
+	    mouse | 
+	    Rect | 
+	    Surface | 
+	    time | 
+	    music | 
+	    pygame
+	  

+
+	  
Advanced stuff:
+	    cursors | 
+	    joystick | 
+	    mask | 
+	    sprite | 
+	    transform | 
+	    BufferProxy | 
+	    freetype | 
+	    gfxdraw | 
+	    midi | 
+	    PixelArray | 
+	    pixelcopy | 
+	    sndarray | 
+	    surfarray | 
+	    math
+	  

+
+	  
Other:
+	    camera | 
+	    controller | 
+	    examples | 
+	    fastevent | 
+	    scrap | 
+	    tests | 
+	    touch | 
+	    version
+	  

+

+

+  

+
+      

+          

+            
+

+

+

+pygame._sdl2.controller

+

+
Pygame module to work with controllers.

+

+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
pygame._sdl2.controller.init

+		—initialize the controller module
pygame._sdl2.controller.quit

+		—Uninitialize the controller module.
pygame._sdl2.controller.get_init

+		—Returns True if the controller module is initialized.
pygame._sdl2.controller.set_eventstate

+		—Sets the current state of events related to controllers
pygame._sdl2.controller.get_eventstate

+		—Gets the current state of events related to controllers
pygame._sdl2.controller.get_count

+		—Get the number of joysticks connected
pygame._sdl2.controller.is_controller

+		—Check if the given joystick is supported by the game controller interface
pygame._sdl2.controller.name_forindex

+		—Get the name of the controller
pygame._sdl2.controller.Controller

+		—Create a new Controller object.

+

+
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.

+
Pygame uses xbox controllers naming conventions (like a, b, x, y for buttons) but
+they always refer to the same buttons. For example CONTROLLER_BUTTON_X is
+always the leftmost button of the 4 buttons on the right.

+
Controllers can generate the following events:

+
CONTROLLERAXISMOTION, CONTROLLERBUTTONDOWN, CONTROLLERBUTTONUP,
+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
+Note that controllers can generate joystick events as well. This function only toggles
+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.

+

+

+

+pygame._sdl2.controller.init()

+

+
initialize the controller module

+
init() -> None

+

+
Initialize the controller module.

+

+
+

+

+pygame._sdl2.controller.quit()

+

+
Uninitialize the controller module.

+
quit() -> None

+

+
Uninitialize the controller module.

+

+
+

+

+pygame._sdl2.controller.get_init()

+

+
Returns True if the controller module is initialized.

+
get_init() -> bool

+

+
Test if pygame._sdl2.controller.init() was called.

+

+

+

+
+

+

+pygame._sdl2.controller.set_eventstate()

+

+
Sets the current state of events related to controllers

+
set_eventstate(state) -> None

+

+
Enable or disable events connected 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

+

+

+
+

+

+pygame._sdl2.controller.get_eventstate()

+

+
Gets the current state of events related to controllers

+
get_eventstate() -> bool

+

+
Returns the current state of events related to controllers, True meaning
+events will be posted.

+

+
New in pygame 2.0.2.

+

+

+
+

+

+pygame._sdl2.controller.get_count()

+

+
Get the number of joysticks connected

+
get_count() -> int

+

+
Get the number of joysticks connected.

+

+
+

+

+pygame._sdl2.controller.is_controller()

+

+
Check if the given joystick is supported by the game controller interface

+
is_controller(index) -> bool

+

+
Returns True if the index given can be used to create a controller object.

+

+
+

+

+pygame._sdl2.controller.name_forindex()

+

+
Get the name of the controller

+
name_forindex(index) -> name or None

+

+
Returns the name of controller, or None if there's no name or the
+index is invalid.

+

+
+

+

+pygame._sdl2.controller.Controller

+

+

+
Create a new Controller object.

+
Controller(index) -> Controller

+

+
Create a new Controller object. Index should be integer between
+0 and pygame._sdl2.controller.get_count(). Controllers also
+can be created from a pygame.joystick.Joystick using
+pygame._sdl2.controller.from_joystick. Controllers are
+initialized on creation.

+

+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
pygame._sdl2.controller.Controller.quit

+		—uninitialize the Controller
pygame._sdl2.controller.Controller.get_init

+		—check if the Controller is initialized
pygame._sdl2.controller.Controller.from_joystick

+		—Create a Controller from a pygame.joystick.Joystick object
pygame._sdl2.controller.Controller.attached

+		—Check if the Controller has been opened and is currently connected.
pygame._sdl2.controller.Controller.as_joystick

+		—Returns a pygame.joystick.Joystick() object
pygame._sdl2.controller.Controller.get_axis

+		—Get the current state of a joystick axis
pygame._sdl2.controller.Controller.get_button

+		—Get the current state of a button
pygame._sdl2.controller.Controller.get_mapping

+		—Get the mapping assigned to the controller
pygame._sdl2.controller.Controller.set_mapping

+		—Assign a mapping to the controller
pygame._sdl2.controller.Controller.rumble

+		—Start a rumbling effect
pygame._sdl2.controller.Controller.stop_rumble

+		—Stop any rumble effect playing

+

+

+quit()

+

+
uninitialize the Controller

+
quit() -> None

+

+
Close a Controller object. After this the pygame event queue will no longer
+receive events from the device.

+
It is safe to call this more than once.

+

+
+

+

+get_init()

+

+
check if the Controller is initialized

+
get_init() -> bool

+

+
Returns True if the Controller object is currently initialised.

+

+
+

+

+static from_joystick()

+

+
Create a Controller from a pygame.joystick.Joystick object

+
from_joystick(joystick) -> Controller

+

+
Create a Controller object from a pygame.joystick.Joystick object

+

+
+

+

+attached()

+

+
Check if the Controller has been opened and is currently connected.

+
attached() -> bool

+

+
Returns True if the Controller object is opened and connected.

+

+
+

+

+as_joystick()

+

+
Returns a pygame.joystick.Joystick() object

+
as_joystick() -> Joystick object

+

+
Returns a pygame.joystick.Joystick() object created from this controller's index

+

+
+

+

+get_axis()

+

+
Get the current state of a joystick axis

+
get_axis(axis) -> int

+

+
Get the current state of a trigger or joystick axis.
+The axis argument must be one of the following constants:

+
CONTROLLER_AXIS_LEFTX, CONTROLLER_AXIS_LEFTY,
+CONTROLLER_AXIS_RIGHTX, CONTROLLER_AXIS_RIGHTY,
+CONTROLLER_AXIS_TRIGGERLEFT, CONTROLLER_AXIS_TRIGGERRIGHT
+

+

+
Joysticks can return a value between -32768 and 32767. Triggers however
+can only return a value between 0 and 32768.

+

+
+

+

+get_button()

+

+
Get the current state of a button

+
get_button(button) -> bool

+

+
Get the current state of a button, True meaning it is pressed down.
+The button argument must be one of the following constants:

+
CONTROLLER_BUTTON_A, CONTROLLER_BUTTON_B,
+CONTROLLER_BUTTON_X, CONTROLLER_BUTTON_Y
+CONTROLLER_BUTTON_DPAD_UP, CONTROLLER_BUTTON_DPAD_DOWN,
+CONTROLLER_BUTTON_DPAD_LEFT, CONTROLLER_BUTTON_DPAD_RIGHT,
+CONTROLLER_BUTTON_LEFTSHOULDER, CONTROLLER_BUTTON_RIGHTSHOULDER,
+CONTROLLER_BUTTON_LEFTSTICK, CONTROLLER_BUTTON_RIGHTSTICK,
+CONTROLLER_BUTTON_BACK, CONTROLLER_BUTTON_GUIDE,
+CONTROLLER_BUTTON_START
+

+

+

+
+

+

+get_mapping()

+

+
Get the mapping assigned to the controller

+
get_mapping() -> mapping

+

+
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

+

+

+
+

+

+set_mapping()

+

+
Assign a mapping to the controller

+
set_mapping(mapping) -> int

+

+
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 Controller.get_mapping(). To edit
+this mapping assign a value to the original button. The value of the
+dictionary must be a button, hat or axis represented in the following way:

+
    
+
  • For a button use: bX where X is the index of the button.
    • 
+
  • For a hat use: hX.Y where X is the index and the Y is the direction (up: 1, right: 2, down: 3, left: 4).
    • 
+
  • For an axis use: aX where x is the index of the axis.
    • 
+

+
An example of mapping:

+
mapping = controller.get_mapping() # Get current mapping
+mapping["a"] = "b3" # Remap button a to y
+mapping["y"] = "b0" # Remap button y to a
+controller.set_mapping(mapping) # Set the mapping
+

+

+
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

+

+

+
+

+

+rumble()

+

+
Start a rumbling effect

+
rumble(low_frequency, high_frequency, duration) -> bool

+

+
Start a rumble effect on the controller, with the specified strength ranging
+from 0 to 1. Duration is length of the effect, in ms. Setting the duration
+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 or pygame.version.SDL()tupled integers of the SDL library version is below 2.0.9.

+

+
New in pygame 2.0.2.

+

+

+
+

+

+stop_rumble()

+

+
Stop any rumble effect playing

+
stop_rumble() -> None

+

+
Stops any rumble effect playing on the controller. See
+Controller.rumble() for more information.

+

+
New in pygame 2.0.2.

+

+

+
+

+
+

+
+

+
+
+


+

+Edit on GitHub
+            

+          

+      

+      

+    

+    
+    
+  
+
\ No newline at end of file
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/ref/sdl2_video.html b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/ref/sdl2_video.html
new file mode 100644
index 0000000..f0a952a
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/ref/sdl2_video.html
@@ -0,0 +1,1062 @@
+
+
+
+  
+    
+    
+
+    pygame.sdl2_video — pygame v2.6.1 documentation
+    
+    
+    
+    
+    
+    
+    
+    
+    
+     
+    
+
+    

+
+  

+	

+	
+	

+	  

+	    Pygame Home ||
+	    Help Contents ||
+	    Reference Index
+
+        

+          
+          
+        

+	  

+	  

+	  
Most useful stuff:
+	    Color | 
+	    display | 
+	    draw | 
+	    event | 
+	    font | 
+	    image | 
+	    key | 
+	    locals | 
+	    mixer | 
+	    mouse | 
+	    Rect | 
+	    Surface | 
+	    time | 
+	    music | 
+	    pygame
+	  

+
+	  
Advanced stuff:
+	    cursors | 
+	    joystick | 
+	    mask | 
+	    sprite | 
+	    transform | 
+	    BufferProxy | 
+	    freetype | 
+	    gfxdraw | 
+	    midi | 
+	    PixelArray | 
+	    pixelcopy | 
+	    sndarray | 
+	    surfarray | 
+	    math
+	  

+
+	  
Other:
+	    camera | 
+	    controller | 
+	    examples | 
+	    fastevent | 
+	    scrap | 
+	    tests | 
+	    touch | 
+	    version
+	  

+

+

+  

+
+      

+          

+            
+

+

+

+pygame.sdl2_video

+

+
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.

+

+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
pygame._sdl2.video.Window

+		—pygame object that represents a window
pygame._sdl2.video.Texture

+		—pygame object that representing a Texture.
pygame._sdl2.video.Image

+		—Easy way to use a portion of a Texture without worrying about srcrect all the time.
pygame._sdl2.video.Renderer

+		—Create a 2D rendering context for a window.

+

+
Experimental pygame module for porting new SDL video systems

+

+

+

+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

+

+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
pygame._sdl2.video.Window.from_display_module

+		—Creates window using window created by pygame.display.set_mode().
pygame._sdl2.video.Window.from_window

+		—Create Window from another window. Could be from another UI toolkit.
pygame._sdl2.video.Window.grab

+		—Gets or sets whether the mouse is confined to the window.
pygame._sdl2.video.Window.relative_mouse

+		—Gets or sets the window's relative mouse motion state.
pygame._sdl2.video.Window.set_windowed

+		—Enable windowed mode (exit fullscreen).
pygame._sdl2.video.Window.set_fullscreen

+		—Enter fullscreen.
pygame._sdl2.video.Window.title

+		—Gets or sets whether the window title.
pygame._sdl2.video.Window.destroy

+		—Destroys the window.
pygame._sdl2.video.Window.hide

+		—Hide the window.
pygame._sdl2.video.Window.show

+		—Show the window.
pygame._sdl2.video.Window.focus

+		—Raise the window above other windows and set the input focus. The "input_only" argument is only supported on X11.
pygame._sdl2.video.Window.restore

+		—Restore the size and position of a minimized or maximized window.
pygame._sdl2.video.Window.maximize

+		—Maximize the window.
pygame._sdl2.video.Window.minimize

+		—Minimize the window.
pygame._sdl2.video.Window.resizable

+		—Gets and sets whether the window is resizable.
pygame._sdl2.video.Window.borderless

+		—Add or remove the border from the window.
pygame._sdl2.video.Window.set_icon

+		—Set the icon for the window.
pygame._sdl2.video.Window.id

+		—Get the unique window ID. *Read-only*
pygame._sdl2.video.Window.size

+		—Gets and sets the window size.
pygame._sdl2.video.Window.position

+		—Gets and sets the window position.
pygame._sdl2.video.Window.opacity

+		—Gets and sets the window opacity. Between 0.0 (fully transparent) and 1.0 (fully opaque).
pygame._sdl2.video.Window.display_index

+		—Get the index of the display that owns the window. *Read-only*
pygame._sdl2.video.Window.set_modal_for

+		—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 representing a Texture.

+
Texture(renderer, size, depth=0, static=False, streaming=False, target=False) -> Texture

+

+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
pygame._sdl2.video.Texture.from_surface

+		—Create a texture from an existing surface.
pygame._sdl2.video.Texture.renderer

+		—Gets the renderer associated with the Texture. *Read-only*
pygame._sdl2.video.Texture.width

+		—Gets the width of the Texture. *Read-only*
pygame._sdl2.video.Texture.height

+		—Gets the height of the Texture. *Read-only*
pygame._sdl2.video.Texture.alpha

+		—Gets and sets an additional alpha value multiplied into render copy operations.
pygame._sdl2.video.Texture.blend_mode

+		—Gets and sets the blend mode for the Texture.
pygame._sdl2.video.Texture.color

+		—Gets and sets an additional color value multiplied into render copy operations.
pygame._sdl2.video.Texture.get_rect

+		—Get the rectangular area of the texture.
pygame._sdl2.video.Texture.draw

+		—Copy a portion of the texture to the rendering target.
pygame._sdl2.video.Texture.update

+		—Update the texture with a Surface. WARNING: Slow operation, use sparingly.

+

+

+static from_surface()

+

+
Create a texture from an existing surface.

+
from_surface(renderer, surface) -> Texture

+

+

+
+

+

+renderer

+

+
Gets the renderer associated with the Texture. *Read-only*

+
renderer -> Renderer

+

+

+
+

+

+width

+

+
Gets the width of the Texture. *Read-only*

+
width -> int

+

+

+
+

+

+height

+

+
Gets the height of the Texture. *Read-only*

+
height -> int

+

+

+
+

+

+alpha

+

+
Gets and sets an additional alpha value multiplied into render copy operations.

+
alpha -> int

+

+

+
+

+

+blend_mode

+

+
Gets and sets the blend mode for the Texture.

+
blend_mode -> int

+

+

+
+

+

+color

+

+
Gets and sets an additional color value multiplied into render copy operations.

+
color -> color

+

+

+
+

+

+get_rect()

+

+
Get the rectangular area of the texture.

+
get_rect(**kwargs) -> Rect

+

+

+
+

+

+draw()

+

+
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

+

+

+
+

+

+update()

+

+
Update the texture with a Surface. WARNING: Slow operation, use sparingly.

+
update(surface, area=None) -> None

+

+

+
+

+
+

+

+pygame._sdl2.video.Image

+

+
Easy way to use a portion of a Texture without worrying about srcrect all the time.

+
Image(textureOrImage, srcrect=None) -> Image

+

+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
pygame._sdl2.video.Image.get_rect

+		—Get the rectangular area of the Image.
pygame._sdl2.video.Image.draw

+		—Copy a portion of the Image to the rendering target.
pygame._sdl2.video.Image.angle

+		—Gets and sets the angle the Image draws itself with.
pygame._sdl2.video.Image.origin

+		—Gets and sets the origin. Origin=None means the Image will be rotated around its center.
pygame._sdl2.video.Image.flip_x

+		—Gets and sets whether the Image is flipped on the x axis.
pygame._sdl2.video.Image.flip_y

+		—Gets and sets whether the Image is flipped on the y axis.
pygame._sdl2.video.Image.color

+		—Gets and sets the Image color modifier.
pygame._sdl2.video.Image.alpha

+		—Gets and sets the Image alpha modifier.
pygame._sdl2.video.Image.blend_mode

+		—Gets and sets the blend mode for the Image.
pygame._sdl2.video.Image.texture

+		—Gets and sets the Texture the Image is based on.
pygame._sdl2.video.Image.srcrect

+		—Gets and sets the Rect the Image is based on.

+

+

+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

+

+
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

+

+
Gets and sets whether the Image is flipped on the x axis.

+
flip_x -> bool

+

+

+
+

+

+flip_y

+

+
Gets and sets whether the Image is flipped on the y axis.

+
flip_y -> bool

+

+

+
+

+

+color

+

+
Gets and sets the Image color modifier.

+
color -> Color

+

+

+
+

+

+alpha

+

+
Gets and sets the Image alpha modifier.

+
alpha -> float

+

+

+
+

+

+blend_mode

+

+
Gets and sets the blend mode for the Image.

+
blend_mode -> int

+

+

+
+

+

+texture

+

+
Gets and sets the Texture the Image is based on.

+
texture -> Texture

+

+

+
+

+

+srcrect

+

+
Gets and sets the Rect the Image is based on.

+
srcrect -> Rect

+

+

+
+

+
+

+

+pygame._sdl2.video.Renderer

+

+
Create a 2D rendering context for a window.

+
Renderer(window, index=-1, accelerated=-1, vsync=False, target_texture=False) -> Renderer

+

+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
pygame._sdl2.video.Renderer.from_window

+		—Easy way to create a Renderer.
pygame._sdl2.video.Renderer.draw_blend_mode

+		—Gets and sets the blend mode used by the drawing functions.
pygame._sdl2.video.Renderer.draw_color

+		—Gets and sets the color used by the drawing functions.
pygame._sdl2.video.Renderer.clear

+		—Clear the current rendering target with the drawing color.
pygame._sdl2.video.Renderer.present

+		—Updates the screen with any new rendering since previous call.
pygame._sdl2.video.Renderer.get_viewport

+		—Returns the drawing area on the target.
pygame._sdl2.video.Renderer.set_viewport

+		—Set the drawing area on the target. If area is None, the entire target will be used.
pygame._sdl2.video.Renderer.logical_size

+		—Gets and sets the logical size.
pygame._sdl2.video.Renderer.scale

+		—Gets and sets the scale.
pygame._sdl2.video.Renderer.target

+		—Gets and sets the render target. None represents the default target (the renderer).
pygame._sdl2.video.Renderer.blit

+		—For compatibility purposes. Textures created by different Renderers cannot be shared!
pygame._sdl2.video.Renderer.draw_line

+		—Draws a line.
pygame._sdl2.video.Renderer.draw_point

+		—Draws a point.
pygame._sdl2.video.Renderer.draw_rect

+		—Draws a rectangle.
pygame._sdl2.video.Renderer.fill_rect

+		—Fills a rectangle.
pygame._sdl2.video.Renderer.to_surface

+		—Read pixels from current render target and create a pygame.Surface. WARNING: Slow operation, use sparingly.

+

+

+classmethod from_window()

+

+
Easy way to create a Renderer.

+
from_window(window) -> Renderer

+

+

+
+

+

+draw_blend_mode

+

+
Gets and sets the blend mode used by the drawing functions.

+
draw_blend_mode -> int

+

+

+
+

+

+draw_color

+

+
Gets and sets the color used by the drawing functions.

+
draw_color -> Color

+

+

+
+

+

+clear()

+

+
Clear the current rendering target with the drawing color.

+
clear() -> None

+

+

+
+

+

+present()

+

+
Updates the screen with any new rendering since previous call.

+
present() -> None

+

+

+
+

+

+get_viewport()

+

+
Returns the drawing area on the target.

+
get_viewport() -> Rect

+

+

+
+

+

+set_viewport()

+

+
Set the drawing area on the target. If area is None, the entire target will be used.

+
set_viewport(area) -> None

+

+

+
+

+

+logical_size

+

+
Gets and sets the logical size.

+
logical_size -> (int width, int height)

+

+

+
+

+

+scale

+

+
Gets and sets the scale.

+
scale -> (float x_scale, float y_scale)

+

+

+
+

+

+target

+

+
Gets and sets the render target. None represents the default target (the renderer).

+
target -> Texture or None

+

+

+
+

+

+blit()

+

+
For compatibility purposes. Textures created by different Renderers cannot be shared!

+
blit(source, dest, area=None, special_flags=0)-> Rect

+

+

+
+

+

+draw_line()

+

+
Draws a line.

+
draw_line(p1, p2) -> None

+

+

+
+

+

+draw_point()

+

+
Draws a point.

+
draw_point(point) -> None

+

+

+
+

+

+draw_rect()

+

+
Draws a rectangle.

+
draw_rect(rect)-> None

+

+

+
+

+

+fill_rect()

+

+
Fills a rectangle.

+
fill_rect(rect)-> None

+

+

+
+

+

+to_surface()

+

+
Read pixels from current render target and create a pygame.Surface. WARNING: Slow operation, use sparingly.

+
to_surface(surface=None, area=None)-> Surface

+

+

+
+

+
+

+
+

+
+
+


+

+Edit on GitHub
+            

+          

+      

+      

+    

+    
+    
+  
+
\ No newline at end of file
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/ref/sndarray.html b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/ref/sndarray.html
new file mode 100644
index 0000000..b53d15c
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/ref/sndarray.html
@@ -0,0 +1,265 @@
+
+
+
+  
+    
+    
+
+    pygame.sndarray — pygame v2.6.1 documentation
+    
+    
+    
+    
+    
+    
+    
+    
+    
+     
+    
+
+    

+
+  

+	

+	
+	

+	  

+	    Pygame Home ||
+	    Help Contents ||
+	    Reference Index
+
+        

+          
+          
+        

+	  

+	  

+	  
Most useful stuff:
+	    Color | 
+	    display | 
+	    draw | 
+	    event | 
+	    font | 
+	    image | 
+	    key | 
+	    locals | 
+	    mixer | 
+	    mouse | 
+	    Rect | 
+	    Surface | 
+	    time | 
+	    music | 
+	    pygame
+	  

+
+	  
Advanced stuff:
+	    cursors | 
+	    joystick | 
+	    mask | 
+	    sprite | 
+	    transform | 
+	    BufferProxy | 
+	    freetype | 
+	    gfxdraw | 
+	    midi | 
+	    PixelArray | 
+	    pixelcopy | 
+	    sndarray | 
+	    surfarray | 
+	    math
+	  

+
+	  
Other:
+	    camera | 
+	    controller | 
+	    examples | 
+	    fastevent | 
+	    scrap | 
+	    tests | 
+	    touch | 
+	    version
+	  

+

+

+  

+
+      

+          

+            
+

+

+

+pygame.sndarray

+

+
pygame module for accessing sound sample data

+

+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
pygame.sndarray.array

+		—copy Sound samples into an array
pygame.sndarray.samples

+		—reference Sound samples into an array
pygame.sndarray.make_sound

+		—convert an array into a Sound object
pygame.sndarray.use_arraytype

+		—Sets the array system to be used for sound arrays
pygame.sndarray.get_arraytype

+		—Gets the currently active array type.
pygame.sndarray.get_arraytypes

+		—Gets the array system types currently supported.

+
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.

+

+

+pygame.sndarray.array()

+

+
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().

+

+
+

+

+pygame.sndarray.samples()

+

+
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
+format returned from pygame.mixer.get_init().

+

+
+

+

+pygame.sndarray.make_sound()

+

+
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
+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

+

+
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 ##

+

+
+

+

+pygame.sndarray.get_arraytype()

+

+
Gets the currently active array type.

+
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.

+

+

+
+

+

+pygame.sndarray.get_arraytypes()

+

+
Gets the array system types currently supported.

+
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
+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.

+

+

+
+

+
+

+
+
+


+

+Edit on GitHub
+            

+          

+      

+      

+    

+    
+    
+  
+
\ No newline at end of file
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/ref/sprite.html b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/ref/sprite.html
new file mode 100644
index 0000000..e5a53da
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/ref/sprite.html
@@ -0,0 +1,1381 @@
+
+
+
+  
+    
+    
+
+    pygame.sprite — pygame v2.6.1 documentation
+    
+    
+    
+    
+    
+    
+    
+    
+    
+     
+    
+
+    

+
+  

+	

+	
+	

+	  

+	    Pygame Home ||
+	    Help Contents ||
+	    Reference Index
+
+        

+          
+          
+        

+	  

+	  

+	  
Most useful stuff:
+	    Color | 
+	    display | 
+	    draw | 
+	    event | 
+	    font | 
+	    image | 
+	    key | 
+	    locals | 
+	    mixer | 
+	    mouse | 
+	    Rect | 
+	    Surface | 
+	    time | 
+	    music | 
+	    pygame
+	  

+
+	  
Advanced stuff:
+	    cursors | 
+	    joystick | 
+	    mask | 
+	    sprite | 
+	    transform | 
+	    BufferProxy | 
+	    freetype | 
+	    gfxdraw | 
+	    midi | 
+	    PixelArray | 
+	    pixelcopy | 
+	    sndarray | 
+	    surfarray | 
+	    math
+	  

+
+	  
Other:
+	    camera | 
+	    controller | 
+	    examples | 
+	    fastevent | 
+	    scrap | 
+	    tests | 
+	    touch | 
+	    version
+	  

+

+

+  

+
+      

+          

+            
+

+

+

+pygame.sprite

+

+
pygame module with basic game object classes

+

+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
pygame.sprite.Sprite

+		—Simple base class for visible game objects.
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.
pygame.sprite.DirtySprite

+		—A subclass of Sprite with more attributes and features.
pygame.sprite.Group

+		—A container class to hold and manage multiple Sprite objects.
pygame.sprite.WeakDirtySprite

+		—A subclass of WeakSprite and DirtySprite that combines the benefits of both classes.
pygame.sprite.RenderPlain

+		—Same as pygame.sprite.Group
pygame.sprite.RenderClear

+		—Same as pygame.sprite.Group
pygame.sprite.RenderUpdates

+		—Group sub-class that tracks dirty updates.
pygame.sprite.OrderedUpdates

+		—RenderUpdates sub-class that draws Sprites in order of addition.
pygame.sprite.LayeredUpdates

+		—LayeredUpdates is a sprite group that handles layers and draws like OrderedUpdates.
pygame.sprite.LayeredDirty

+		—LayeredDirty group is for DirtySprite objects.  Subclasses LayeredUpdates.
pygame.sprite.GroupSingle

+		—Group container that holds a single sprite.
pygame.sprite.spritecollide

+		—Find sprites in a group that intersect another sprite.
pygame.sprite.collide_rect

+		—Collision detection between two sprites, using rects.
pygame.sprite.collide_rect_ratio

+		—Collision detection between two sprites, using rects scaled to a ratio.
pygame.sprite.collide_circle

+		—Collision detection between two sprites, using circles.
pygame.sprite.collide_circle_ratio

+		—Collision detection between two sprites, using circles scaled to a ratio.
pygame.sprite.collide_mask

+		—Collision detection between two sprites, using masks.
pygame.sprite.groupcollide

+		—Find all sprites that collide between two groups.
pygame.sprite.spritecollideany

+		—Simple test if a sprite intersects anything in a group.

+
This module contains several simple classes to be used within games. There is
+the main Sprite class and several Group classes that contain Sprites. The use
+of these classes is entirely optional when using pygame. The classes are fairly
+lightweight and only provide a starting place for the code that is common to
+most games.

+
The Sprite class is intended to be used as a base class for the different types
+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 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() 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 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
+Group. A given Sprite can exist in any number of groups. A game could use some
+groups to control object rendering, and a completely separate set of groups to
+control interaction or player movement. Instead of adding type attributes or
+bools to a derived Sprite class, consider keeping the Sprites inside organized
+Groups. This will allow for easier lookup later in the game.

+
Sprites and Groups manage their relationships with the add() and
+remove() methods. These methods can accept a single or multiple targets for
+membership. The default initializers for these classes also takes a single or
+list of targets for initial membership. It is safe to repeatedly add and remove
+the same Sprite from a Group.

+
While it is possible to design sprite and group classes that don't derive from
+the Sprite and AbstractGroup classes below, it is strongly recommended that you
+extend those when you add a Sprite or Group class.

+
Sprites are not thread safe. So lock them yourself if using threads.

+

+

+pygame.sprite.Sprite

+

+
Simple base class for visible game objects.

+
Sprite(*groups) -> Sprite

+

+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
pygame.sprite.Sprite.update

+		—method to control sprite behavior
pygame.sprite.Sprite.add

+		—add the sprite to groups
pygame.sprite.Sprite.remove

+		—remove the sprite from groups
pygame.sprite.Sprite.kill

+		—remove the Sprite from all Groups
pygame.sprite.Sprite.alive

+		—does the sprite belong to any groups
pygame.sprite.Sprite.groups

+		—list of Groups that contain this Sprite

+
The base class for visible game objects. Derived classes will want to
+override the Sprite.update() and assign a Sprite.image and
+Sprite.rect attributes. The initializer can accept any number of Group
+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):
+
+    # 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)
+
+       # 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()
+

+

+

+

+update()

+

+
method to control sprite behavior

+
update(*args, **kwargs) -> None

+

+
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.

+
It is not necessary to use this method if not using the convenience method
+by the same name in the Group class.

+

+
+

+

+add()

+

+
add the sprite to groups

+
add(*groups) -> None

+

+
Any number of Group instances can be passed as arguments. The Sprite will
+be added to the Groups it is not already a member of.

+

+
+

+

+remove()

+

+
remove the sprite from groups

+
remove(*groups) -> None

+

+
Any number of Group instances can be passed as arguments. The Sprite will
+be removed from the Groups it is currently a member of.

+

+
+

+

+kill()

+

+
remove the Sprite from all Groups

+
kill() -> None

+

+
The Sprite is removed from all the Groups that contain it. This won't
+change anything about the state of the Sprite. It is possible to continue
+to use the Sprite after this method has been called, including adding it
+to Groups.

+

+
+

+

+alive()

+

+
does the sprite belong to any groups

+
alive() -> bool

+

+
Returns True when the Sprite belongs to one or more Groups.

+

+
+

+

+groups()

+

+
list of Groups that contain this Sprite

+
groups() -> group_list

+

+
Return a list of all the Groups that contain this Sprite.

+

+
+

+
+

+

+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

+

+
A subclass of Sprite with more attributes and features.

+
DirtySprite(*groups) -> DirtySprite

+

+
Extra DirtySprite attributes with their default values:

+
dirty = 1

+
if set to 1, it is repainted and then set to 0 again
+if set to 2 then it is always dirty ( repainted each frame,
+flag is not reset)
+0 means that it is not dirty and therefore not repainted again
+

+

+
blendmode = 0

+
its the special_flags argument of blit, blendmodes
+

+

+
source_rect = None

+
source rect to use, remember that it is relative to
+topleft (0,0) of self.image
+

+

+
visible = 1

+
normally 1, if set to 0 it will not be repainted
+(you must set it dirty too to be erased from screen)
+

+

+
layer = 0

+
(READONLY value, it is read when adding it to the
+LayeredDirty, for details see doc of LayeredDirty)
+

+

+

+
+

+

+pygame.sprite.Group

+

+
A container class to hold and manage multiple Sprite objects.

+
Group(*sprites) -> Group

+

+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
pygame.sprite.Group.sprites

+		—list of the Sprites this Group contains
pygame.sprite.Group.copy

+		—duplicate the Group
pygame.sprite.Group.add

+		—add Sprites to this Group
pygame.sprite.Group.remove

+		—remove Sprites from the Group
pygame.sprite.Group.has

+		—test if a Group contains Sprites
pygame.sprite.Group.update

+		—call the update method on contained Sprites
pygame.sprite.Group.draw

+		—blit the Sprite images
pygame.sprite.Group.clear

+		—draw a background over the Sprites
pygame.sprite.Group.empty

+		—remove all Sprites

+
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. The group supports the following
+standard Python operations:

+
in      test if a Sprite is contained
+len     the number of Sprites contained
+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.

+

+

+sprites()

+

+
list of the Sprites this Group contains

+
sprites() -> sprite_list

+

+
Return a list of all the Sprites this group contains. You can also get an
+iterator from the group, but you cannot iterate over a Group while
+modifying it.

+

+
+

+

+copy()

+

+
duplicate the Group

+
copy() -> Group

+

+
Creates a new Group with all the same Sprites as the original. If you
+have subclassed Group, the new object will have the same (sub-)class as
+the original. This only works if the derived class's constructor takes
+the same arguments as the Group class's.

+

+
+

+

+add()

+

+
add Sprites to this Group

+
add(*sprites) -> None

+

+
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 a iterator containing Sprites.

+

+
+

+

+remove()

+

+
remove Sprites from the Group

+
remove(*sprites) -> None

+

+
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 a iterator containing Sprites.

+

+
+

+

+has()

+

+
test if a Group contains Sprites

+
has(*sprites) -> bool

+

+
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 a iterator containing Sprites.

+

+
+

+

+update()

+

+
call the update method on contained Sprites

+
update(*args, **kwargs) -> None

+

+
Calls the update() method on all Sprites in the Group. The base
+Sprite class has an update method that takes any number of arguments and
+does nothing. The arguments passed to Group.update() will be passed
+to each Sprite.

+
There is no way to get the return value from the Sprite.update()
+methods.

+

+
+

+

+draw()

+

+
blit the Sprite images

+
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().
+bgsurf is unused in this method but LayeredDirty.draw() uses
+it.

+
The Group does not keep sprites in any order, so the draw order is
+arbitrary.

+

+
+

+

+clear()

+

+
draw a background over the Sprites

+
clear(Surface_dest, background) -> None

+

+
Erases the Sprites used in the last Group.draw() call. The
+destination Surface is cleared by filling the drawn Sprite positions with
+the background.

+
The background is usually a Surface image the same dimensions as the
+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):
+    color = 255, 0, 0
+    surf.fill(color, rect)
+

+

+

+
+

+

+empty()

+

+
remove all Sprites

+
empty() -> None

+

+
Removes all Sprites from this Group.

+

+
+

+
+

+

+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

+

+
Group sub-class that tracks dirty updates.

+
RenderUpdates(*sprites) -> RenderUpdates

+

+
+
+
+
+
+
+
+
pygame.sprite.RenderUpdates.draw

+		—blit the Sprite images and track changed areas

+
This class is derived from pygame.sprite.Group(). It has an extended
+draw() method that tracks the changed areas of the screen.

+

+

+draw()

+

+
blit the Sprite images and track changed areas

+
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().

+
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.

+

+
+

+
+

+

+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 OrderedUpdates.

+
LayeredUpdates(*sprites, **kwargs) -> LayeredUpdates

+

+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
pygame.sprite.LayeredUpdates.add

+		—add a sprite or sequence of sprites to a group
pygame.sprite.LayeredUpdates.sprites

+		—returns a ordered list of sprites (first back, last top).
pygame.sprite.LayeredUpdates.draw

+		—draw all sprites in the right order onto the passed surface.
pygame.sprite.LayeredUpdates.get_sprites_at

+		—returns a list with all sprites at that position.
pygame.sprite.LayeredUpdates.get_sprite

+		—returns the sprite at the index idx from the groups sprites
pygame.sprite.LayeredUpdates.remove_sprites_of_layer

+		—removes all sprites from a layer and returns them as a list.
pygame.sprite.LayeredUpdates.layers

+		—returns a list of layers defined (unique), sorted from bottom up.
pygame.sprite.LayeredUpdates.change_layer

+		—changes the layer of the sprite
pygame.sprite.LayeredUpdates.get_layer_of_sprite

+		—returns the layer that sprite is currently in.
pygame.sprite.LayeredUpdates.get_top_layer

+		—returns the top layer
pygame.sprite.LayeredUpdates.get_bottom_layer

+		—returns the bottom layer
pygame.sprite.LayeredUpdates.move_to_front

+		—brings the sprite to front layer
pygame.sprite.LayeredUpdates.move_to_back

+		—moves the sprite to the bottom layer
pygame.sprite.LayeredUpdates.get_top_sprite

+		—returns the topmost sprite
pygame.sprite.LayeredUpdates.get_sprites_from_layer

+		—returns all sprites from a layer, ordered by how they where added
pygame.sprite.LayeredUpdates.switch_layer

+		—switches the sprites from layer1 to layer2

+
This group is fully compatible with pygame.sprite.SpriteSimple base class for visible game objects..

+
You can set the default layer through kwargs using 'default_layer' and an
+integer for the layer. The default layer is 0.

+
If the sprite you add has an attribute _layer then that layer will be used.
+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.

+

+

+

+add()

+

+
add a sprite or sequence of sprites to a group

+
add(*sprites, **kwargs) -> None

+

+
If the sprite(s) have an attribute layer then that is used for the
+layer. If **kwargs contains 'layer' then the sprite(s) will be added
+to that argument (overriding the sprite layer attribute). If neither is
+passed then the sprite(s) will be added to the default layer.

+

+
+

+

+sprites()

+

+
returns a ordered list of sprites (first back, last top).

+
sprites() -> sprites

+

+

+
+

+

+draw()

+

+
draw all sprites in the right order onto the passed surface.

+
draw(surface, bgsurf=None, special_flags=0) -> Rect_list

+

+

+
+

+

+get_sprites_at()

+

+
returns a list with all sprites at that position.

+
get_sprites_at(pos) -> colliding_sprites

+

+
Bottom sprites first, top last.

+

+
+

+

+get_sprite()

+

+
returns the sprite at the index idx from the groups sprites

+
get_sprite(idx) -> sprite

+

+
Raises IndexOutOfBounds if the idx is not within range.

+

+
+

+

+remove_sprites_of_layer()

+

+
removes all sprites from a layer and returns them as a list.

+
remove_sprites_of_layer(layer_nr) -> sprites

+

+

+
+

+

+layers()

+

+
returns a list of layers defined (unique), sorted from bottom up.

+
layers() -> layers

+

+

+
+

+

+change_layer()

+

+
changes the layer of the sprite

+
change_layer(sprite, new_layer) -> None

+

+
sprite must have been added to the renderer. It is not checked.

+

+
+

+

+get_layer_of_sprite()

+

+
returns the layer that sprite is currently in.

+
get_layer_of_sprite(sprite) -> layer

+

+
If the sprite is not found then it will return the default layer.

+

+
+

+

+get_top_layer()

+

+
returns the top layer

+
get_top_layer() -> layer

+

+

+
+

+

+get_bottom_layer()

+

+
returns the bottom layer

+
get_bottom_layer() -> layer

+

+

+
+

+

+move_to_front()

+

+
brings the sprite to front layer

+
move_to_front(sprite) -> None

+

+
Brings the sprite to front, changing sprite layer to topmost layer (added
+at the end of that layer).

+

+
+

+

+move_to_back()

+

+
moves the sprite to the bottom layer

+
move_to_back(sprite) -> None

+

+
Moves the sprite to the bottom layer, moving it behind all other layers
+and adding one additional layer.

+

+
+

+

+get_top_sprite()

+

+
returns the topmost sprite

+
get_top_sprite() -> Sprite

+

+

+
+

+

+get_sprites_from_layer()

+

+
returns all sprites from a layer, ordered by how they where added

+
get_sprites_from_layer(layer) -> sprites

+

+
Returns all sprites from a layer, ordered by how they where added. It
+uses linear search and the sprites are not removed from layer.

+

+
+

+

+switch_layer()

+

+
switches the sprites from layer1 to layer2

+
switch_layer(layer1_nr, layer2_nr) -> None

+

+
The layers number must exist, it is not checked.

+

+
+

+
+

+

+pygame.sprite.LayeredDirty

+

+
LayeredDirty group is for DirtySprite objects.  Subclasses LayeredUpdates.

+
LayeredDirty(*sprites, **kwargs) -> LayeredDirty

+

+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
pygame.sprite.LayeredDirty.draw

+		—draw all sprites in the right order onto the passed surface.
pygame.sprite.LayeredDirty.clear

+		—used to set background
pygame.sprite.LayeredDirty.repaint_rect

+		—repaints the given area
pygame.sprite.LayeredDirty.set_clip

+		—clip the area where to draw. Just pass None (default) to reset the clip
pygame.sprite.LayeredDirty.get_clip

+		—clip the area where to draw. Just pass None (default) to reset the clip
pygame.sprite.LayeredDirty.change_layer

+		—changes the layer of the sprite
pygame.sprite.LayeredDirty.set_timing_treshold

+		—sets the threshold in milliseconds
pygame.sprite.LayeredDirty.set_timing_threshold

+		—sets the threshold in milliseconds

+
This group requires pygame.sprite.DirtySpriteA subclass of Sprite with more attributes and features. or any sprite that
+has the following attributes:

+
image, rect, dirty, visible, blendmode (see doc of DirtySprite).
+

+

+
It uses the dirty flag technique and is therefore faster than the
+pygame.sprite.RenderUpdatesGroup sub-class that tracks dirty updates. if you have many static sprites. It
+also switches automatically between dirty rect update and full screen
+drawing, so you do not have to worry what would be faster.

+
Same as for the pygame.sprite.GroupA container class to hold and manage multiple Sprite objects.. You can specify some
+additional attributes through kwargs:

+
_use_update: True/False   default is False
+_default_layer: default layer where sprites without a layer are added.
+_time_threshold: threshold time for switching between dirty rect mode
+    and fullscreen mode, defaults to 1000./80  == 1000./fps
+

+

+

+
New in pygame 1.8.

+

+

+

+draw()

+

+
draw all sprites in the right order onto the passed surface.

+
draw(surface, bgsurf=None, special_flags=None) -> Rect_list

+

+
You can pass the background too. If a background is already set, then the
+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.

+

+
+

+

+clear()

+

+
used to set background

+
clear(surface, bgd) -> None

+

+

+
+

+

+repaint_rect()

+

+
repaints the given area

+
repaint_rect(screen_rect) -> None

+

+
screen_rect is in screen coordinates.

+

+
+

+

+set_clip()

+

+
clip the area where to draw. Just pass None (default) to reset the clip

+
set_clip(screen_rect=None) -> None

+

+

+
+

+

+get_clip()

+

+
clip the area where to draw. Just pass None (default) to reset the clip

+
get_clip() -> Rect

+

+

+
+

+

+change_layer()

+

+
changes the layer of the sprite

+
change_layer(sprite, new_layer) -> None

+

+
sprite must have been added to the renderer. It is not checked.

+

+
+

+

+set_timing_treshold()

+

+
sets the threshold in milliseconds

+
set_timing_treshold(time_ms) -> None

+

+
DEPRECATED: Use set_timing_threshold() instead.

+

+
Deprecated since pygame 2.1.1.

+

+

+
+

+

+set_timing_threshold()

+

+
sets the threshold in milliseconds

+
set_timing_threshold(time_ms) -> None

+

+
Defaults to 1000.0 / 80.0. This means that the screen will be painted
+using the flip method rather than the update method if the update
+method is taking so long to update the screen that the frame rate falls
+below 80 frames per second.

+

+
New in pygame 2.1.1.

+

+

+
Raises:

+
TypeError -- if time_ms is not int or float

+

+

+

+
+

+
+

+

+pygame.sprite.GroupSingle()

+

+
Group container that holds a single sprite.

+
GroupSingle(sprite=None) -> GroupSingle

+

+
The GroupSingle container only holds a single Sprite. When a new Sprite is
+added, the old one is removed.

+
There is a special property, GroupSingle.sprite, that accesses the
+Sprite that this Group contains. It can be None when the Group is empty. The
+property can also be assigned to add a Sprite into the GroupSingle
+container.

+

+
+

+

+pygame.sprite.spritecollide()

+

+
Find sprites in a group that intersect another sprite.

+
spritecollide(sprite, group, dokill, collided = None) -> Sprite_list

+

+
Return a list containing all Sprites in a Group that intersect with another
+Sprite. Intersection is determined by comparing the Sprite.rect
+attribute of each Sprite.

+
The dokill argument is a bool. If set to True, all Sprites that collide will
+be removed from the Group.

+
The collided argument is a callback function used to calculate if two
+sprites are colliding. it should take two sprites as values, and return a
+bool value indicating if they are colliding. If collided is not passed, all
+sprites must have a "rect" value, which is a rectangle of the sprite area,
+which will be used to calculate the collision.

+
collided callables:

+
collide_rect, collide_rect_ratio, collide_circle,
+collide_circle_ratio, collide_mask
+

+

+
Example:

+
# 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)
+
+# 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.collide_rect()

+

+
Collision detection between two sprites, using rects.

+
collide_rect(left, right) -> bool

+

+
Tests for collision between two sprites. Uses the pygame rect colliderect
+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.

+

+

+
+

+

+pygame.sprite.collide_rect_ratio()

+

+
Collision detection between two sprites, using rects scaled to a ratio.

+
collide_rect_ratio(ratio) -> collided_callable

+

+
A callable class that checks for collisions between two sprites, using a
+scaled version of the sprites rects.

+
Is created with a ratio, the instance is then intended to be passed as a
+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.

+

+

+
+

+

+pygame.sprite.collide_circle()

+

+
Collision detection between two sprites, using circles.

+
collide_circle(left, right) -> bool

+

+
Tests for collision between two sprites, by testing to see if two circles
+centered on the sprites overlap. If the sprites have a "radius" attribute,
+that is used to create the circle, otherwise a circle is created 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.

+

+

+
+

+

+pygame.sprite.collide_circle_ratio()

+

+
Collision detection between two sprites, using circles scaled to a ratio.

+
collide_circle_ratio(ratio) -> collided_callable

+

+
A callable class that checks for collisions between two sprites, using a
+scaled version of the sprites radius.

+
Is created with a floating point ratio, the instance is then intended to be
+passed as a 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.

+
The created callable tests for collision between two sprites, by testing to
+see if two circles centered on the sprites overlap, after scaling the
+circles radius by the stored ratio. If the sprites have a "radius"
+attribute, that is used to create the circle, otherwise a circle is created
+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.

+

+

+
+

+

+pygame.sprite.collide_mask()

+

+
Collision detection between two sprites, using masks.

+
collide_mask(sprite1, sprite2) -> (int, int)

+
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
+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
+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
+(0, 0)). The collision point is a position within the mask and is not
+related to the actual screen position of sprite1.

+
This function is intended to be passed as a collided callback function
+to the group collide functions (see spritecollide(),
+groupcollide(), spritecollideany()).

+

+
Note

+
To increase performance, create and set a mask attribute for all
+sprites that will use this function to check for collisions. Otherwise,
+each time this function is called it will create new masks.

+

+

+
Note

+
A new mask needs to be recreated each time a sprite's image is changed
+(e.g. if a new image is used or the existing image is rotated).

+

+
# Example of mask creation for a sprite.
+sprite.mask = pygame.mask.from_surface(sprite.image)
+

+

+

+
Returns:

+
first point of collision between the masks or None if no
+collision

+

+
Return type:

+
tuple(int, int) or NoneType

+

+

+

+
New in pygame 1.8.0.

+

+

+
+

+

+pygame.sprite.groupcollide()

+

+
Find all sprites that collide between two groups.

+
groupcollide(group1, group2, dokill1, dokill2, collided = None) -> Sprite_dict

+

+
This will find collisions between all the Sprites in two groups.
+Collision is determined by comparing the Sprite.rect attribute of
+each Sprite or by using the collided function if it is not None.

+
Every Sprite inside group1 is added to the return dictionary. The value for
+each item is the list of Sprites in group2 that intersect.

+
If either dokill argument is True, the colliding Sprites will be removed
+from their respective Group.

+
The collided argument is a callback function used to calculate if two sprites are
+colliding. It should take two sprites as values and return a bool value
+indicating if they are colliding. If collided is not passed, then all
+sprites must have a "rect" value, which is a rectangle of the sprite area,
+which will be used to calculate the collision.

+

+
+

+

+pygame.sprite.spritecollideany()

+

+
Simple test if a sprite intersects anything in a group.

+
spritecollideany(sprite, group, collided = None) -> Sprite Collision with the returned sprite.

+
spritecollideany(sprite, group, collided = None) -> None No collision

+

+
If the sprite collides with any single sprite in the group, a single
+sprite from the group is returned.  On no collision None is returned.

+
If you don't need all the features of the pygame.sprite.spritecollide() function, this
+function will be a bit quicker.

+
The collided argument is a callback function used to calculate if two sprites are
+colliding. It should take two sprites as values and return a bool value
+indicating if they are colliding. If collided is not passed, then all
+sprites must have a "rect" value, which is a rectangle of the sprite area,
+which will be used to calculate the collision.

+

+
+

+
+

+
+
+


+

+Edit on GitHub
+            

+          

+      

+      

+    

+    
+    
+  
+
\ No newline at end of file
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/ref/surface.html b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/ref/surface.html
new file mode 100644
index 0000000..7d4703c
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/ref/surface.html
@@ -0,0 +1,1332 @@
+
+
+
+  
+    
+    
+
+    pygame.Surface — pygame v2.6.1 documentation
+    
+    
+    
+    
+    
+    
+    
+    
+    
+     
+    
+
+    

+
+  

+	

+	
+	

+	  

+	    Pygame Home ||
+	    Help Contents ||
+	    Reference Index
+
+        

+          
+          
+        

+	  

+	  

+	  
Most useful stuff:
+	    Color | 
+	    display | 
+	    draw | 
+	    event | 
+	    font | 
+	    image | 
+	    key | 
+	    locals | 
+	    mixer | 
+	    mouse | 
+	    Rect | 
+	    Surface | 
+	    time | 
+	    music | 
+	    pygame
+	  

+
+	  
Advanced stuff:
+	    cursors | 
+	    joystick | 
+	    mask | 
+	    sprite | 
+	    transform | 
+	    BufferProxy | 
+	    freetype | 
+	    gfxdraw | 
+	    midi | 
+	    PixelArray | 
+	    pixelcopy | 
+	    sndarray | 
+	    surfarray | 
+	    math
+	  

+
+	  
Other:
+	    camera | 
+	    controller | 
+	    examples | 
+	    fastevent | 
+	    scrap | 
+	    tests | 
+	    touch | 
+	    version
+	  

+

+

+  

+
+      

+          

+            
+

+

+

+pygame.Surface

+

+
pygame object for representing images

+
Surface((width, height), flags=0, depth=0, masks=None) -> Surface

+
Surface((width, height), flags=0, Surface) -> Surface

+

+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
pygame.Surface.blit

+		—draw one image onto another
pygame.Surface.blits

+		—draw many images onto another
pygame.Surface.convert

+		—change the pixel format of an image
pygame.Surface.convert_alpha

+		—change the pixel format of an image including per pixel alphas
pygame.Surface.copy

+		—create a new copy of a Surface
pygame.Surface.fill

+		—fill Surface with a solid color
pygame.Surface.scroll

+		—Shift the surface image in place
pygame.Surface.set_colorkey

+		—Set the transparent colorkey
pygame.Surface.get_colorkey

+		—Get the current transparent colorkey
pygame.Surface.set_alpha

+		—set the alpha value for the full Surface image
pygame.Surface.get_alpha

+		—get the current Surface transparency value
pygame.Surface.lock

+		—lock the Surface memory for pixel access
pygame.Surface.unlock

+		—unlock the Surface memory from pixel access
pygame.Surface.mustlock

+		—test if the Surface requires locking
pygame.Surface.get_locked

+		—test if the Surface is current locked
pygame.Surface.get_locks

+		—Gets the locks for the Surface
pygame.Surface.get_at

+		—get the color value at a single pixel
pygame.Surface.set_at

+		—set the color value for a single pixel
pygame.Surface.get_at_mapped

+		—get the mapped color value at a single pixel
pygame.Surface.get_palette

+		—get the color index palette for an 8-bit Surface
pygame.Surface.get_palette_at

+		—get the color for a single entry in a palette
pygame.Surface.set_palette

+		—set the color palette for an 8-bit Surface
pygame.Surface.set_palette_at

+		—set the color for a single index in an 8-bit Surface palette
pygame.Surface.map_rgb

+		—convert a color into a mapped color value
pygame.Surface.unmap_rgb

+		—convert a mapped integer color value into a Color
pygame.Surface.set_clip

+		—set the current clipping area of the Surface
pygame.Surface.get_clip

+		—get the current clipping area of the Surface
pygame.Surface.subsurface

+		—create a new surface that references its parent
pygame.Surface.get_parent

+		—find the parent of a subsurface
pygame.Surface.get_abs_parent

+		—find the top level parent of a subsurface
pygame.Surface.get_offset

+		—find the position of a child subsurface inside a parent
pygame.Surface.get_abs_offset

+		—find the absolute position of a child subsurface inside its top level parent
pygame.Surface.get_size

+		—get the dimensions of the Surface
pygame.Surface.get_width

+		—get the width of the Surface
pygame.Surface.get_height

+		—get the height of the Surface
pygame.Surface.get_rect

+		—get the rectangular area of the Surface
pygame.Surface.get_bitsize

+		—get the bit depth of the Surface pixel format
pygame.Surface.get_bytesize

+		—get the bytes used per Surface pixel
pygame.Surface.get_flags

+		—get the additional flags used for the Surface
pygame.Surface.get_pitch

+		—get the number of bytes used per Surface row
pygame.Surface.get_masks

+		—the bitmasks needed to convert between a color and a mapped integer
pygame.Surface.set_masks

+		—set the bitmasks needed to convert between a color and a mapped integer
pygame.Surface.get_shifts

+		—the bit shifts needed to convert between a color and a mapped integer
pygame.Surface.set_shifts

+		—sets the bit shifts needed to convert between a color and a mapped integer
pygame.Surface.get_losses

+		—the significant bits used to convert between a color and a mapped integer
pygame.Surface.get_bounding_rect

+		—find the smallest rect containing data
pygame.Surface.get_view

+		—return a buffer view of the Surface's pixels.
pygame.Surface.get_buffer

+		—acquires a buffer object for the pixels of the Surface.
pygame.Surface._pixels_address

+		—pixel buffer address
pygame.Surface.premul_alpha

+		—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
+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
+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
+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
+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 map_rgb() and
+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 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.

+

+

+blit()

+

+
draw one image onto another

+
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.

+

+
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.

+

+

+
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 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, ...]

+

+
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 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:

+
a list of rects of the areas changed if doreturn is
+True, otherwise None

+

+
Return type:

+
list or None

+

+

+
New in pygame 1.9.4.

+

+
+

+

+convert()

+

+
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.

+
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 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.

+

+
+

+

+convert_alpha()

+

+
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 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
+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

+
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().

+

+
+

+

+fill()

+

+
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 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 image in place

+
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.

+

+
New in pygame 1.9.

+

+

+
+

+

+set_colorkey()

+

+
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 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.

+

+
+

+

+get_colorkey()

+

+
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.

+

+
+

+

+set_alpha()

+

+
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, 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.

+

+
+

+

+get_alpha()

+

+
get the current Surface transparency value

+
get_alpha() -> int_value

+

+
Return the current alpha value for the Surface.

+

+
+

+

+lock()

+

+
lock the Surface memory for pixel access

+
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 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.

+

+
+

+

+unlock()

+

+
unlock the Surface memory from pixel access

+
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
+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.

+

+
+

+

+mustlock()

+

+
test if the Surface requires locking

+
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.

+

+
+

+

+get_locked()

+

+
test if the Surface is current locked

+
get_locked() -> bool

+

+
Returns True when the Surface is locked. It doesn't matter how many
+times the Surface is locked.

+

+
+

+

+get_locks()

+

+
Gets the locks for the Surface

+
get_locks() -> tuple

+

+
Returns the currently existing locks for the Surface.

+

+
+

+

+get_at()

+

+
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
+(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 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.

+

+
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.

+

+

+
+

+

+set_at()

+

+
set the color value for a single pixel

+
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.

+

+

+
+

+

+get_at_mapped()

+

+
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
+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.

+

+

+
+

+

+get_palette()

+

+
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.

+

+

+
+

+

+get_palette_at()

+

+
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.

+

+

+
+

+

+set_palette()

+

+
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
+colors in the original palette will be changed.

+
This function has no effect on a Surface with more than 8-bits per pixel.

+

+
+

+

+set_palette_at()

+

+
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.

+
This function has no effect on a Surface with more than 8-bits per pixel.

+

+
+

+

+map_rgb()

+

+
convert a color into a mapped color value

+
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.

+

+
+

+

+unmap_rgb()

+

+
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
+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.

+

+
+

+

+set_clip()

+

+
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
+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.

+

+
+

+

+get_clip()

+

+
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
+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.

+

+
+

+

+subsurface()

+

+
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
+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 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.

+

+
+

+

+get_parent()

+

+
find the parent of a subsurface

+
get_parent() -> Surface

+

+
Returns the parent Surface of a subsurface. If this is not a subsurface
+then None will be returned.

+

+
+

+

+get_abs_parent()

+

+
find the top level parent of a subsurface

+
get_abs_parent() -> Surface

+

+
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() -> (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).

+

+
+

+

+get_abs_offset()

+

+
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,
+0).

+

+
+

+

+get_size()

+

+
get the dimensions of the Surface

+
get_size() -> (width, height)

+

+
Return the width and height of the Surface in pixels.

+

+
+

+

+get_width()

+

+
get the width of the Surface

+
get_width() -> width

+

+
Return the width of the Surface in pixels.

+

+
+

+

+get_height()

+

+
get the height of the Surface

+
get_height() -> height

+

+
Return the height of the Surface in pixels.

+

+
+

+

+get_rect()

+

+
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 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.

+

+
+

+

+get_bitsize()

+

+
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
+not exactly fill the number of bytes used per pixel. For example a 15 bit
+Surface still requires a full 2 bytes.

+

+
+

+

+get_bytesize()

+

+
get the bytes used per Surface pixel

+
get_bytesize() -> int

+

+
Return the number of bytes used per pixel.

+

+
+

+

+get_flags()

+

+
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
+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 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
+RLEACCELOK     0x00002000    # Private flag
+RLEACCEL       0x00004000    # Surface is RLE encoded
+SRCALPHA       0x00010000    # Blit uses source alpha blending
+PREALLOC       0x01000000    # Surface uses preallocated memory
+

+

+

+
+

+

+get_pitch()

+

+
get the number of bytes used per Surface row

+
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.

+

+
+

+

+get_masks()

+

+
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.

+

+
+

+

+set_masks()

+

+
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.

+

+
Note

+
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.

+

+

+
+

+

+get_shifts()

+

+
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.

+
This value is not needed for normal pygame usage.

+

+
+

+

+set_shifts()

+

+
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.

+

+
Note

+
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.

+

+

+
+

+

+get_losses()

+

+
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.

+
This value is not needed for normal pygame usage.

+

+
+

+

+get_bounding_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
+alpha value.

+
This function will temporarily lock and unlock the Surface as needed.

+

+
New in pygame 1.8.

+

+

+
+

+

+get_view()

+

+
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
+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.

+

+
New in pygame 1.9.2.

+

+

+
+

+

+get_buffer()

+

+
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
+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 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.

+
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.

+

+
New in pygame 2.2.0.

+

+

+
+

+
+

+
+
+


+

+Edit on GitHub
+            

+          

+      

+      

+    

+    
+    
+  
+
\ No newline at end of file
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/ref/surfarray.html b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/ref/surfarray.html
new file mode 100644
index 0000000..cd09c1b
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/ref/surfarray.html
@@ -0,0 +1,562 @@
+
+
+
+  
+    
+    
+
+    pygame.surfarray — pygame v2.6.1 documentation
+    
+    
+    
+    
+    
+    
+    
+    
+    
+     
+    
+
+    

+
+  

+	

+	
+	

+	  

+	    Pygame Home ||
+	    Help Contents ||
+	    Reference Index
+
+        

+          
+          
+        

+	  

+	  

+	  
Most useful stuff:
+	    Color | 
+	    display | 
+	    draw | 
+	    event | 
+	    font | 
+	    image | 
+	    key | 
+	    locals | 
+	    mixer | 
+	    mouse | 
+	    Rect | 
+	    Surface | 
+	    time | 
+	    music | 
+	    pygame
+	  

+
+	  
Advanced stuff:
+	    cursors | 
+	    joystick | 
+	    mask | 
+	    sprite | 
+	    transform | 
+	    BufferProxy | 
+	    freetype | 
+	    gfxdraw | 
+	    midi | 
+	    PixelArray | 
+	    pixelcopy | 
+	    sndarray | 
+	    surfarray | 
+	    math
+	  

+
+	  
Other:
+	    camera | 
+	    controller | 
+	    examples | 
+	    fastevent | 
+	    scrap | 
+	    tests | 
+	    touch | 
+	    version
+	  

+

+

+  

+
+      

+          

+            
+

+

+

+pygame.surfarray

+

+
pygame module for accessing surface pixel data using array interfaces

+

+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
pygame.surfarray.array2d

+		—Copy pixels into a 2d array
pygame.surfarray.pixels2d

+		—Reference pixels into a 2d array
pygame.surfarray.array3d

+		—Copy pixels into a 3d array
pygame.surfarray.pixels3d

+		—Reference pixels into a 3d array
pygame.surfarray.array_alpha

+		—Copy pixel alphas into a 2d array
pygame.surfarray.pixels_alpha

+		—Reference pixel alphas into a 2d array
pygame.surfarray.array_red

+		—Copy red pixels into a 2d array
pygame.surfarray.pixels_red

+		—Reference pixel red into a 2d array.
pygame.surfarray.array_green

+		—Copy green pixels into a 2d array
pygame.surfarray.pixels_green

+		—Reference pixel green into a 2d array.
pygame.surfarray.array_blue

+		—Copy blue pixels into a 2d array
pygame.surfarray.pixels_blue

+		—Reference pixel blue into a 2d array.
pygame.surfarray.array_colorkey

+		—Copy the colorkey values into a 2d array
pygame.surfarray.make_surface

+		—Copy an array to a new surface
pygame.surfarray.blit_array

+		—Blit directly from a array values
pygame.surfarray.map_array

+		—Map a 3d array into a 2d array
pygame.surfarray.use_arraytype

+		—Sets the array system to be used for surface arrays
pygame.surfarray.get_arraytype

+		—Gets the currently active array type.
pygame.surfarray.get_arraytypes

+		—Gets the array system types currently supported.

+
Functions to convert between NumPy arrays and Surface 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.

+
Every pixel is stored as a single integer value to represent the red, green,
+and blue colors. The 8-bit images use a value that looks into a colormap. Pixels
+with higher depth use a bit packing process to place three or four values into
+a single number.

+
The arrays are indexed by the X axis first, followed by the Y axis.
+Arrays that treat the pixels as a single integer are referred to as 2D arrays.
+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
+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).

+
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
+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.

+

+

+pygame.surfarray.array2d()

+

+
Copy pixels into a 2d array

+
array2d(Surface) -> array

+

+
Copy the mapped (raw) pixels from a Surface
+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
+access method).

+

+
+

+

+pygame.surfarray.pixels2d()

+

+
Reference pixels into a 2d array

+
pixels2d(Surface) -> array

+

+
Create a new 2D array that directly references the pixel values in a
+Surface. Any changes to the array will affect the pixels in the Surface.
+This is a fast operation since no data is copied.

+
Pixels from a 24-bit Surface cannot be referenced, but all other Surface bit
+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
+access method.

+

+
+

+

+pygame.surfarray.array3d()

+

+
Copy pixels into a 3d array

+
array3d(Surface) -> array

+

+
Copy the pixels from a Surface into a 3D 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
+access method).

+

+
+

+

+pygame.surfarray.pixels3d()

+

+
Reference pixels into a 3d array

+
pixels3d(Surface) -> array

+

+
Create a new 3D array that directly references the pixel values in a
+Surface. Any changes to the array will affect the pixels in the Surface.
+This is a fast operation since no data is copied.

+
This will only work on Surfaces that have 24-bit or 32-bit formats. Lower
+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
+access method.

+

+
+

+

+pygame.surfarray.array_alpha()

+

+
Copy pixel alphas into a 2d array

+
array_alpha(Surface) -> array

+

+
Copy the pixel alpha values (degree of transparency) from a Surface into a
+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
+access method).

+

+
+

+

+pygame.surfarray.pixels_alpha()

+

+
Reference pixel alphas into a 2d array

+
pixels_alpha(Surface) -> array

+

+
Create a new 2D array that directly references the alpha values (degree of
+transparency) in a Surface. Any changes to the array will affect the pixels
+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
+access method.

+

+
+

+

+pygame.surfarray.array_red()

+

+
Copy red pixels into a 2d array

+
array_red(Surface) -> array

+

+
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
+access method).

+

+
New in pygame 2.0.2.

+

+

+
+

+

+pygame.surfarray.pixels_red()

+

+
Reference pixel red into a 2d array.

+
pixels_red (Surface) -> array

+

+
Create a new 2D array that directly references the red values in a Surface.
+Any changes to the array will affect the pixels in the Surface. 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
+access method.

+

+
+

+

+pygame.surfarray.array_green()

+

+
Copy green pixels into a 2d array

+
array_green(Surface) -> array

+

+
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
+access method).

+

+
New in pygame 2.0.2.

+

+

+
+

+

+pygame.surfarray.pixels_green()

+

+
Reference pixel green into a 2d array.

+
pixels_green (Surface) -> array

+

+
Create a new 2D array that directly references the green values in a
+Surface. Any changes to the array will affect the pixels in the Surface.
+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
+access method.

+

+
+

+

+pygame.surfarray.array_blue()

+

+
Copy blue pixels into a 2d array

+
array_blue(Surface) -> array

+

+
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
+access method).

+

+
New in pygame 2.0.2.

+

+

+
+

+

+pygame.surfarray.pixels_blue()

+

+
Reference pixel blue into a 2d array.

+
pixels_blue (Surface) -> array

+

+
Create a new 2D array that directly references the blue values in a Surface.
+Any changes to the array will affect the pixels in the Surface. 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
+access method.

+

+
+

+

+pygame.surfarray.array_colorkey()

+

+
Copy the colorkey values into a 2d array

+
array_colorkey(Surface) -> array

+

+
Create a new array with the colorkey transparency value from each pixel. If
+the pixel matches the colorkey it will be fully transparent; otherwise it
+will be fully opaque.

+
This will work on any type of Surface format. If the image has no colorkey a
+solid opaque array will be returned.

+
This function will temporarily lock the Surface as pixels are copied.

+

+
+

+

+pygame.surfarray.make_surface()

+

+
Copy an array to a new surface

+
make_surface(array) -> 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. 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.

+
New in pygame 1.9.2: array struct interface support.

+

+
+

+

+pygame.surfarray.blit_array()

+

+
Blit directly from a array values

+
blit_array(Surface, array) -> None

+

+
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. Only
+integer, ASCII character and record arrays are accepted.

+
This function will temporarily lock the Surface as the new values are
+copied.

+

+
+

+

+pygame.surfarray.map_array()

+

+
Map a 3d array into a 2d array

+
map_array(Surface, array3d) -> array2d

+

+
Convert a 3D array into a 2D array. This will use the given Surface format
+to control the conversion. Palette surface formats are supported for NumPy
+arrays.

+

+
+

+

+pygame.surfarray.use_arraytype()

+

+
Sets the array system to be used for surface 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.

+

+
+

+

+pygame.surfarray.get_arraytype()

+

+
Gets the currently active array type.

+
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.

+

+

+
+

+

+pygame.surfarray.get_arraytypes()

+

+
Gets the array system types currently supported.

+
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
+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.

+

+

+
+

+
+

+
+
+


+

+Edit on GitHub
+            

+          

+      

+      

+    

+    
+    
+  
+
\ No newline at end of file
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/ref/tests.html b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/ref/tests.html
new file mode 100644
index 0000000..18701bd
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/ref/tests.html
@@ -0,0 +1,234 @@
+
+
+
+  
+    
+    
+
+    pygame.tests — pygame v2.6.1 documentation
+    
+    
+    
+    
+    
+    
+    
+    
+    
+     
+    
+
+    

+
+  

+	

+	
+	

+	  

+	    Pygame Home ||
+	    Help Contents ||
+	    Reference Index
+
+        

+          
+          
+        

+	  

+	  

+	  
Most useful stuff:
+	    Color | 
+	    display | 
+	    draw | 
+	    event | 
+	    font | 
+	    image | 
+	    key | 
+	    locals | 
+	    mixer | 
+	    mouse | 
+	    Rect | 
+	    Surface | 
+	    time | 
+	    music | 
+	    pygame
+	  

+
+	  
Advanced stuff:
+	    cursors | 
+	    joystick | 
+	    mask | 
+	    sprite | 
+	    transform | 
+	    BufferProxy | 
+	    freetype | 
+	    gfxdraw | 
+	    midi | 
+	    PixelArray | 
+	    pixelcopy | 
+	    sndarray | 
+	    surfarray | 
+	    math
+	  

+
+	  
Other:
+	    camera | 
+	    controller | 
+	    examples | 
+	    fastevent | 
+	    scrap | 
+	    tests | 
+	    touch | 
+	    version
+	  

+

+

+  

+
+      

+          

+            
+

+

+

+pygame.tests

+

+
Pygame unit test suite package

+

+
+
+
+
+
+
+
+
pygame.tests.run

+		—Run the pygame unit test suite

+
A quick way to run the test suite package from the command line is to import
+the go submodule with the Python -m option:

+
python -m pygame.tests [<test options>]
+

+

+
Command line option --help displays a usage message. Available options
+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, 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,
+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.run()

+

+
Run the pygame unit test suite

+
run(*args, **kwds) -> tuple

+

+
Positional arguments (optional):

+
The names of tests to include. If omitted then all tests are run. Test names
+need not include the trailing '_test'.
+

+

+
Keyword arguments:

+
incomplete - fail incomplete tests (default False)
+nosubprocess - run all test suites in the current process
+               (default False, use separate subprocesses)
+dump - dump failures/errors as dict ready to eval (default False)
+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
+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)
+seed - if provided, a seed randomizer integer
+multi_thread - if provided, the number of THREADS in which to run
+               subprocessed tests
+time_out - if subprocess is True then the time limit in seconds before
+           killing a test (default 30)
+fake - if provided, the name of the fake tests package in the
+       run_tests__tests subpackage to run instead of the normal
+       pygame tests
+python - the path to a python executable to run subprocessed tests
+         (default sys.executable)
+

+

+
Return value:

+
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
+recreates normal pygame usage where pygame.init() and pygame.quit()
+are called only once per program execution, and avoids unfortunate
+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 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 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.

+

+
+

+
+

+
+
+


+

+Edit on GitHub
+            

+          

+      

+      

+    

+    
+    
+  
+
\ No newline at end of file
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/ref/time.html b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/ref/time.html
new file mode 100644
index 0000000..b4e364b
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/ref/time.html
@@ -0,0 +1,356 @@
+
+
+
+  
+    
+    
+
+    pygame.time — pygame v2.6.1 documentation
+    
+    
+    
+    
+    
+    
+    
+    
+    
+     
+    
+
+    

+
+  

+	

+	
+	

+	  

+	    Pygame Home ||
+	    Help Contents ||
+	    Reference Index
+
+        

+          
+          
+        

+	  

+	  

+	  
Most useful stuff:
+	    Color | 
+	    display | 
+	    draw | 
+	    event | 
+	    font | 
+	    image | 
+	    key | 
+	    locals | 
+	    mixer | 
+	    mouse | 
+	    Rect | 
+	    Surface | 
+	    time | 
+	    music | 
+	    pygame
+	  

+
+	  
Advanced stuff:
+	    cursors | 
+	    joystick | 
+	    mask | 
+	    sprite | 
+	    transform | 
+	    BufferProxy | 
+	    freetype | 
+	    gfxdraw | 
+	    midi | 
+	    PixelArray | 
+	    pixelcopy | 
+	    sndarray | 
+	    surfarray | 
+	    math
+	  

+
+	  
Other:
+	    camera | 
+	    controller | 
+	    examples | 
+	    fastevent | 
+	    scrap | 
+	    tests | 
+	    touch | 
+	    version
+	  

+

+

+  

+
+      

+          

+            
+

+

+

+pygame.time

+

+
pygame module for monitoring time

+

+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
pygame.time.get_ticks

+		—get the time in milliseconds
pygame.time.wait

+		—pause the program for an amount of time
pygame.time.delay

+		—pause the program for an amount of time
pygame.time.set_timer

+		—repeatedly create an event on the event queue
pygame.time.Clock

+		—create an object to help track 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.

+

+

+pygame.time.get_ticks()

+

+
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.

+

+
+

+

+pygame.time.wait()

+

+
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
+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.delay()

+

+
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
+than pygame.time.wait().

+
This returns the actual number of milliseconds used.

+

+
+

+

+pygame.time.set_timer()

+

+
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 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

+

+
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

+

+

+
+

+

+pygame.time.Clock

+

+
create an object to help track time

+
Clock() -> Clock

+

+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
pygame.time.Clock.tick

+		—update the clock
pygame.time.Clock.tick_busy_loop

+		—update the clock
pygame.time.Clock.get_time

+		—time used in the previous tick
pygame.time.Clock.get_rawtime

+		—actual time used in the previous tick
pygame.time.Clock.get_fps

+		—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.

+

+

+tick()

+

+
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.

+
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.

+

+
+

+

+tick_busy_loop()

+

+
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.

+
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 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.

+

+

+
+

+

+get_time()

+

+
time used in the previous tick

+
get_time() -> milliseconds

+

+
The number of milliseconds that passed between the previous two calls to
+Clock.tick().

+

+
+

+

+get_rawtime()

+

+
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.

+

+
+

+

+get_fps()

+

+
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().

+

+
+

+
+

+
+

+
+
+


+

+Edit on GitHub
+            

+          

+      

+      

+    

+    
+    
+  
+
\ No newline at end of file
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/ref/touch.html b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/ref/touch.html
new file mode 100644
index 0000000..5a813d2
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/ref/touch.html
@@ -0,0 +1,231 @@
+
+
+
+  
+    
+    
+
+    pygame._sdl2.touch — pygame v2.6.1 documentation
+    
+    
+    
+    
+    
+    
+    
+    
+    
+     
+    
+
+    

+
+  

+	

+	
+	

+	  

+	    Pygame Home ||
+	    Help Contents ||
+	    Reference Index
+
+        

+          
+          
+        

+	  

+	  

+	  
Most useful stuff:
+	    Color | 
+	    display | 
+	    draw | 
+	    event | 
+	    font | 
+	    image | 
+	    key | 
+	    locals | 
+	    mixer | 
+	    mouse | 
+	    Rect | 
+	    Surface | 
+	    time | 
+	    music | 
+	    pygame
+	  

+
+	  
Advanced stuff:
+	    cursors | 
+	    joystick | 
+	    mask | 
+	    sprite | 
+	    transform | 
+	    BufferProxy | 
+	    freetype | 
+	    gfxdraw | 
+	    midi | 
+	    PixelArray | 
+	    pixelcopy | 
+	    sndarray | 
+	    surfarray | 
+	    math
+	  

+
+	  
Other:
+	    camera | 
+	    controller | 
+	    examples | 
+	    fastevent | 
+	    scrap | 
+	    tests | 
+	    touch | 
+	    version
+	  

+

+

+  

+
+      

+          

+            
+

+

+

+pygame._sdl2.touch

+

+
pygame module to work with touch input

+

+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
pygame._sdl2.touch.get_num_devices

+		—get the number of touch devices
pygame._sdl2.touch.get_device

+		—get the a touch device id for a given index
pygame._sdl2.touch.get_num_fingers

+		—the number of active fingers for a given touch device
pygame._sdl2.touch.get_finger

+		—get information about an active finger

+

+
New in pygame 2: This module requires SDL2.

+

+

+

+pygame._sdl2.touch.get_num_devices()

+

+
get the number of touch devices

+
get_num_devices() -> int

+

+
Return the number of available touch devices.

+

+
+

+

+pygame._sdl2.touch.get_device()

+

+
get the a touch device id for a given index

+
get_device(index) -> touchid

+

+

+
Parameters:

+
index (int) -- This number is at least 0 and less than the
+number of devices.

+

+

+
Return an integer id associated with the given index.

+

+
+

+

+pygame._sdl2.touch.get_num_fingers()

+

+
the number of active fingers for a given touch device

+
get_num_fingers(touchid) -> int

+

+
Return the number of fingers active for the touch device
+whose id is touchid.

+

+
+

+

+pygame._sdl2.touch.get_finger()

+

+
get information about an active finger

+
get_finger(touchid, index) -> int

+

+

+
Parameters:

+
    
+
  • touchid (int) -- The touch device id.
    • 
+
  • index (int) -- The index of the finger to return
+information about, between 0 and the
+number of active fingers.
    • 
+

+

+

+
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.
+y          the normalized y position of the finger, between 0 and 1.
+pressure   the amount of pressure applied by the finger, between 0 and 1.
+

+

+

+
+

+
+

+
+
+


+

+Edit on GitHub
+            

+          

+      

+      

+    

+    
+    
+  
+
\ No newline at end of file
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/ref/transform.html b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/ref/transform.html
new file mode 100644
index 0000000..9afb845
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/ref/transform.html
@@ -0,0 +1,598 @@
+
+
+
+  
+    
+    
+
+    pygame.transform — pygame v2.6.1 documentation
+    
+    
+    
+    
+    
+    
+    
+    
+    
+     
+    
+
+    

+
+  

+	

+	
+	

+	  

+	    Pygame Home ||
+	    Help Contents ||
+	    Reference Index
+
+        

+          
+          
+        

+	  

+	  

+	  
Most useful stuff:
+	    Color | 
+	    display | 
+	    draw | 
+	    event | 
+	    font | 
+	    image | 
+	    key | 
+	    locals | 
+	    mixer | 
+	    mouse | 
+	    Rect | 
+	    Surface | 
+	    time | 
+	    music | 
+	    pygame
+	  

+
+	  
Advanced stuff:
+	    cursors | 
+	    joystick | 
+	    mask | 
+	    sprite | 
+	    transform | 
+	    BufferProxy | 
+	    freetype | 
+	    gfxdraw | 
+	    midi | 
+	    PixelArray | 
+	    pixelcopy | 
+	    sndarray | 
+	    surfarray | 
+	    math
+	  

+
+	  
Other:
+	    camera | 
+	    controller | 
+	    examples | 
+	    fastevent | 
+	    scrap | 
+	    tests | 
+	    touch | 
+	    version
+	  

+

+

+  

+
+      

+          

+            
+

+

+

+pygame.transform

+

+
pygame module to transform surfaces

+

+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
pygame.transform.flip

+		—flip vertically and horizontally
pygame.transform.scale

+		—resize to new resolution
pygame.transform.scale_by

+		—resize to new resolution, using scalar(s)
pygame.transform.rotate

+		—rotate an image
pygame.transform.rotozoom

+		—filtered scale and rotation
pygame.transform.scale2x

+		—specialized image doubler
pygame.transform.smoothscale

+		—scale a surface to an arbitrary size smoothly
pygame.transform.smoothscale_by

+		—resize to new resolution, using scalar(s)
pygame.transform.get_smoothscale_backend

+		—return smoothscale filter version in use: 'GENERIC', 'MMX', or 'SSE'
pygame.transform.set_smoothscale_backend

+		—set smoothscale filter version to one of: 'GENERIC', 'MMX', or 'SSE'
pygame.transform.chop

+		—gets a copy of an image with an interior area removed
pygame.transform.laplacian

+		—find edges in a surface
pygame.transform.average_surfaces

+		—find the average surface from many surfaces.
pygame.transform.average_color

+		—finds the average color of a surface
pygame.transform.grayscale

+		—grayscale a 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'.

+
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.)

+

+
Changed in pygame 2.0.2: transform functions now support keyword arguments.

+

+

+

+pygame.transform.flip()

+

+
flip vertically and horizontally

+
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.scale()

+

+
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 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)

+
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.

+

+
New in pygame 2.1.3.

+

+

+
+

+

+pygame.transform.rotate()

+

+
rotate an image

+
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.rotozoom()

+

+
filtered scale and rotation

+
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.scale2x()

+

+
specialized image doubler

+
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.smoothscale()

+

+
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. 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.

+

+

+
+

+

+pygame.transform.smoothscale_by()

+

+
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
+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.

+

+
New in pygame 2.1.3.

+

+

+
+

+

+pygame.transform.get_smoothscale_backend()

+

+
return smoothscale filter version in use: 'GENERIC', 'MMX', or 'SSE'

+
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.set_smoothscale_backend()

+

+
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. '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.chop()

+

+
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
+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.laplacian()

+

+
find edges in a surface

+
laplacian(surface, dest_surface=None) -> Surface

+

+
Finds the edges in a surface using the laplacian algorithm.

+

+
New in pygame 1.8.

+

+

+
+

+

+pygame.transform.average_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
+greyscale colors, and not palette colors.

+
Note, this function currently does not handle palette using surfaces
+correctly.

+

+
New in pygame 1.8.

+

+

+
New in pygame 1.9: palette_colors argument

+

+

+
+

+

+pygame.transform.average_color()

+

+
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 Color. 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.grayscale()

+

+
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.

+

+
+

+

+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) -> 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'.

+

+
Parameters:

+

+

+
Return type:

+
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

+
    def test_threshold_dest_surf_not_change(self):
+        """the pixels within the threshold.
+
+        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 1.8.

+

+

+
Changed in pygame 1.9.4: Fixed a lot of bugs and added keyword arguments. Test your code.

+

+

+
+

+
+

+
+
+


+

+Edit on GitHub
+            

+          

+      

+      

+    

+    
+    
+  
+
\ No newline at end of file
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/search.html b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/search.html
new file mode 100644
index 0000000..e280cca
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/search.html
@@ -0,0 +1,92 @@
+
+
+
+  
+    
+    
+    Search — pygame v2.6.1 documentation
+    
+    
+    
+    
+    
+    
+    
+    
+    
+    
+    
+    
+    
+     
+
+  
+      
+
+    

+      

+          

+            
+  
Search

+  
+  
+  
+  
+  

+    Searching for multiple words only shows matches that contain
+    all words.
+  

+  
+  
+  

+    
+    
+    
+  

+  
+  
+  

+  
+
+            

+          

+      

+      

+    

+    
+    
+  
+
\ No newline at end of file
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/searchindex.js b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/searchindex.js
new file mode 100644
index 0000000..25a9c34
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/searchindex.js
@@ -0,0 +1 @@
+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/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/tut/CameraIntro.html b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/tut/CameraIntro.html
new file mode 100644
index 0000000..613dd69
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/tut/CameraIntro.html
@@ -0,0 +1,374 @@
+
+
+
+  
+    
+    
+
+    Pygame Tutorials - Camera Module Introduction — pygame v2.6.1 documentation
+    
+    
+    
+    
+    
+    
+    
+    
+    
+     
+    
+
+    

+
+  

+	

+	
+	

+	  

+	    Pygame Home ||
+	    Help Contents ||
+	    Reference Index
+
+        

+          
+          
+        

+	  

+	  

+	  
Most useful stuff:
+	    Color | 
+	    display | 
+	    draw | 
+	    event | 
+	    font | 
+	    image | 
+	    key | 
+	    locals | 
+	    mixer | 
+	    mouse | 
+	    Rect | 
+	    Surface | 
+	    time | 
+	    music | 
+	    pygame
+	  

+
+	  
Advanced stuff:
+	    cursors | 
+	    joystick | 
+	    mask | 
+	    sprite | 
+	    transform | 
+	    BufferProxy | 
+	    freetype | 
+	    gfxdraw | 
+	    midi | 
+	    PixelArray | 
+	    pixelcopy | 
+	    sndarray | 
+	    surfarray | 
+	    math
+	  

+
+	  
Other:
+	    camera | 
+	    controller | 
+	    examples | 
+	    fastevent | 
+	    scrap | 
+	    tests | 
+	    touch | 
+	    version
+	  

+

+

+  

+
+      

+          

+            
+

+

+
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 Videocapture
+or 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
+        coord = mask.centroid()
+        # draw a circle with size variable on the size of the blob
+        pygame.draw.circle(self.display, (0,255,0), coord, 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/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/tut/ChimpLineByLine.html b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/tut/ChimpLineByLine.html
new file mode 100644
index 0000000..5726e08
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/tut/ChimpLineByLine.html
@@ -0,0 +1,593 @@
+
+
+
+  
+    
+    
+
+    Pygame Tutorials - Line By Line Chimp Example — pygame v2.6.1 documentation
+    
+    
+    
+    
+    
+    
+    
+    
+    
+     
+    
+
+    

+
+  

+	

+	
+	

+	  

+	    Pygame Home ||
+	    Help Contents ||
+	    Reference Index
+
+        

+          
+          
+        

+	  

+	  

+	  
Most useful stuff:
+	    Color | 
+	    display | 
+	    draw | 
+	    event | 
+	    font | 
+	    image | 
+	    key | 
+	    locals | 
+	    mixer | 
+	    mouse | 
+	    Rect | 
+	    Surface | 
+	    time | 
+	    music | 
+	    pygame
+	  

+
+	  
Advanced stuff:
+	    cursors | 
+	    joystick | 
+	    mask | 
+	    sprite | 
+	    transform | 
+	    BufferProxy | 
+	    freetype | 
+	    gfxdraw | 
+	    midi | 
+	    PixelArray | 
+	    pixelcopy | 
+	    sndarray | 
+	    surfarray | 
+	    math
+	  

+
+	  
Other:
+	    camera | 
+	    controller | 
+	    examples | 
+	    fastevent | 
+	    scrap | 
+	    tests | 
+	    touch | 
+	    version
+	  

+

+

+  

+
+      

+          

+            
+

+

+
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 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")
+

+

+
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. In our case, we import
+pygame as pg, so that all of the functionality of pygame is able to
+be referenced from the namespace pg.

+
Some pygame modules are optional, and if they aren't found,
+they evaluate to False. Because of that, we decide to print
+a nice warning message if the font or
+mixer modules in pygame are not available.
+(Although they will only be unavailable in very uncommon situations).

+
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 = 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()
+

+

+
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()resize to new resolution function.
+This function takes a Surface and the size it should be scaled to. To scale
+by a scalar, we can get the size and scale the x and y by the scalar.

+
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 pg.mixer or not pg.mixer.get_init():
+        return NoneSound()
+
+    fullname = os.path.join(data_dir, name)
+    sound = pg.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 imported correctly.
+If not, it returns a small class instance that has a dummy 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(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.png", -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
+

+

+
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(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 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
+        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
+

+

+
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.

+
pg.init()
+screen = pg.display.set_mode((1280, 480), pg.SCALED)
+pg.display.set_caption("Monkey Fever")
+pg.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 = pg.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. We
+only do this if we see the pygame.fontpygame module for loading and rendering fonts module has imported properly.
+If not, we just skip this section.

+
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)
+

+

+
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 grey 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))
+pg.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()
+allsprites = pg.sprite.RenderPlain((chimp, fist))
+clock = pg.time.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 actually use a special sprite group named RenderPlain. This sprite group can draw all the sprites it
+contains to the screen. It is called RenderPlain because there are actually
+more advanced Render groups. But for our game, we just need simple drawing. We
+create the group named "allsprites" 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 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()
+

+

+
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

+
allsprites.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))
+allsprites.draw(screen)
+pg.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. Since this sprite container is really an instance of the "RenderPlain"
+sprite group, it knows how to draw our sprites. Lastly, we flip() the contents
+of 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.

+
pg.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 pg.quit() explicitly cleans up pygame's internals.

+

+

+

+
+
+


+

+Edit on GitHub
+            

+          

+      

+      

+    

+    
+    
+  
+
\ No newline at end of file
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/tut/DisplayModes.html b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/tut/DisplayModes.html
new file mode 100644
index 0000000..0449181
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/tut/DisplayModes.html
@@ -0,0 +1,323 @@
+
+
+
+  
+    
+    
+
+    Pygame Tutorials - Setting Display Modes — pygame v2.6.1 documentation
+    
+    
+    
+    
+    
+    
+    
+    
+    
+     
+    
+
+    

+
+  

+	

+	
+	

+	  

+	    Pygame Home ||
+	    Help Contents ||
+	    Reference Index
+
+        

+          
+          
+        

+	  

+	  

+	  
Most useful stuff:
+	    Color | 
+	    display | 
+	    draw | 
+	    event | 
+	    font | 
+	    image | 
+	    key | 
+	    locals | 
+	    mixer | 
+	    mouse | 
+	    Rect | 
+	    Surface | 
+	    time | 
+	    music | 
+	    pygame
+	  

+
+	  
Advanced stuff:
+	    cursors | 
+	    joystick | 
+	    mask | 
+	    sprite | 
+	    transform | 
+	    BufferProxy | 
+	    freetype | 
+	    gfxdraw | 
+	    midi | 
+	    PixelArray | 
+	    pixelcopy | 
+	    sndarray | 
+	    surfarray | 
+	    math
+	  

+
+	  
Other:
+	    camera | 
+	    controller | 
+	    examples | 
+	    fastevent | 
+	    scrap | 
+	    tests | 
+	    touch | 
+	    version
+	  

+

+

+  

+
+      

+          

+            
+

+

+
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.
+If the width and height of the new display mode is not passed,
+the created surface will have the same size as the current screen
+resolution.
+If only the width or height is set to 0, the surface will have the
+same respective width or height as the screen resolution.
+Note that in older versions of Pygame using a SDL version prior to 1.2.10,
+not passing in the width and height will raise an exception.
+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, display)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, display)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, display)Pick the best color depth for a display mode

+

+
This function takes the same arguments as pygame.display.set_mode() with the
+exclusion of vsync.
+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, display)Get list of available fullscreen modes

+

+
Returns a list of supported display modes with the requested
+depth, flags, and display.
+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.
+The display index 0 means the default display is used.

+

+

+
pygame.display.get_desktop_sizes()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 and should be used to replace many use cases
+of pygame.display.list_modes() whenever applicable.

+

+

+
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/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/tut/ImportInit.html b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/tut/ImportInit.html
new file mode 100644
index 0000000..e60440e
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/tut/ImportInit.html
@@ -0,0 +1,193 @@
+
+
+
+  
+    
+    
+
+    Pygame Tutorials - Import and Initialize — pygame v2.6.1 documentation
+    
+    
+    
+    
+    
+    
+    
+    
+    
+     
+    
+
+    

+
+  

+	

+	
+	

+	  

+	    Pygame Home ||
+	    Help Contents ||
+	    Reference Index
+
+        

+          
+          
+        

+	  

+	  

+	  
Most useful stuff:
+	    Color | 
+	    display | 
+	    draw | 
+	    event | 
+	    font | 
+	    image | 
+	    key | 
+	    locals | 
+	    mixer | 
+	    mouse | 
+	    Rect | 
+	    Surface | 
+	    time | 
+	    music | 
+	    pygame
+	  

+
+	  
Advanced stuff:
+	    cursors | 
+	    joystick | 
+	    mask | 
+	    sprite | 
+	    transform | 
+	    BufferProxy | 
+	    freetype | 
+	    gfxdraw | 
+	    midi | 
+	    PixelArray | 
+	    pixelcopy | 
+	    sndarray | 
+	    surfarray | 
+	    math
+	  

+
+	  
Other:
+	    camera | 
+	    controller | 
+	    examples | 
+	    fastevent | 
+	    scrap | 
+	    tests | 
+	    touch | 
+	    version
+	  

+

+

+  

+
+      

+          

+            
+

+

+
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/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/tut/MakeGames.html b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/tut/MakeGames.html
new file mode 100644
index 0000000..85c9caa
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/tut/MakeGames.html
@@ -0,0 +1,233 @@
+
+
+
+  
+    
+    
+
+    Making Games With Pygame — pygame v2.6.1 documentation
+    
+    
+    
+    
+    
+    
+    
+    
+    
+     
+    
+
+    

+
+  

+	

+	
+	

+	  

+	    Pygame Home ||
+	    Help Contents ||
+	    Reference Index
+
+        

+          
+          
+        

+	  

+	  

+	  
Most useful stuff:
+	    Color | 
+	    display | 
+	    draw | 
+	    event | 
+	    font | 
+	    image | 
+	    key | 
+	    locals | 
+	    mixer | 
+	    mouse | 
+	    Rect | 
+	    Surface | 
+	    time | 
+	    music | 
+	    pygame
+	  

+
+	  
Advanced stuff:
+	    cursors | 
+	    joystick | 
+	    mask | 
+	    sprite | 
+	    transform | 
+	    BufferProxy | 
+	    freetype | 
+	    gfxdraw | 
+	    midi | 
+	    PixelArray | 
+	    pixelcopy | 
+	    sndarray | 
+	    surfarray | 
+	    math
+	  

+
+	  
Other:
+	    camera | 
+	    controller | 
+	    examples | 
+	    fastevent | 
+	    scrap | 
+	    tests | 
+	    touch | 
+	    version
+	  

+

+

+  

+
+      

+          

+            
+

+

+
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/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/tut/MoveIt.html b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/tut/MoveIt.html
new file mode 100644
index 0000000..c7920ff
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/tut/MoveIt.html
@@ -0,0 +1,653 @@
+
+
+
+  
+    
+    
+
+    Pygame Tutorials - Help! How Do I Move An Image? — pygame v2.6.1 documentation
+    
+    
+    
+    
+    
+    
+    
+    
+    
+     
+    
+
+    

+
+  

+	

+	
+	

+	  

+	    Pygame Home ||
+	    Help Contents ||
+	    Reference Index
+
+        

+          
+          
+        

+	  

+	  

+	  
Most useful stuff:
+	    Color | 
+	    display | 
+	    draw | 
+	    event | 
+	    font | 
+	    image | 
+	    key | 
+	    locals | 
+	    mixer | 
+	    mouse | 
+	    Rect | 
+	    Surface | 
+	    time | 
+	    music | 
+	    pygame
+	  

+
+	  
Advanced stuff:
+	    cursors | 
+	    joystick | 
+	    mask | 
+	    sprite | 
+	    transform | 
+	    BufferProxy | 
+	    freetype | 
+	    gfxdraw | 
+	    midi | 
+	    PixelArray | 
+	    pixelcopy | 
+	    sndarray | 
+	    surfarray | 
+	    math
+	  

+
+	  
Other:
+	    camera | 
+	    controller | 
+	    examples | 
+	    fastevent | 
+	    scrap | 
+	    tests | 
+	    touch | 
+	    version
+	  

+

+

+  

+
+      

+          

+            
+

+

+
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 ways 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 coordinate. 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 an (X,Y) coordinate.
+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 coordinate (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.bmp').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(self.speed, 0)
+...         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:
+...     screen.blit(background, p.pos, p.pos)
+...     for o in objects:
+...         screen.blit(background, o.pos, o.pos)
+...     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()
+...     screen.blit(p.image, p.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. Also updating the display.update() call to pass a list of the areas
+on-screen that have changed.

+
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/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/tut/PygameIntro.html b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/tut/PygameIntro.html
new file mode 100644
index 0000000..1157956
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/tut/PygameIntro.html
@@ -0,0 +1,419 @@
+
+
+
+  
+    
+    
+
+    Pygame Intro — pygame v2.6.1 documentation
+    
+    
+    
+    
+    
+    
+    
+    
+    
+     
+    
+
+    

+
+  

+	

+	
+	

+	  

+	    Pygame Home ||
+	    Help Contents ||
+	    Reference Index
+
+        

+          
+          
+        

+	  

+	  

+	  
Most useful stuff:
+	    Color | 
+	    display | 
+	    draw | 
+	    event | 
+	    font | 
+	    image | 
+	    key | 
+	    locals | 
+	    mixer | 
+	    mouse | 
+	    Rect | 
+	    Surface | 
+	    time | 
+	    music | 
+	    pygame
+	  

+
+	  
Advanced stuff:
+	    cursors | 
+	    joystick | 
+	    mask | 
+	    sprite | 
+	    transform | 
+	    BufferProxy | 
+	    freetype | 
+	    gfxdraw | 
+	    midi | 
+	    PixelArray | 
+	    pixelcopy | 
+	    sndarray | 
+	    surfarray | 
+	    math
+	  

+
+	  
Other:
+	    camera | 
+	    controller | 
+	    examples | 
+	    fastevent | 
+	    scrap | 
+	    tests | 
+	    touch | 
+	    version
+	  

+

+

+  

+
+      

+          

+            
+

+

+
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.gif
+
import sys, pygame
+pygame.init()
+
+size = width, height = 320, 240
+speed = [2, 2]
+black = 0, 0, 0
+
+screen = pygame.display.set_mode(size)
+
+ball = pygame.image.load("intro_ball.gif")
+ballrect = ball.get_rect()
+
+while True:
+    for event in pygame.event.get():
+        if event.type == pygame.QUIT: sys.exit()
+
+    ballrect = ballrect.move(speed)
+    if ballrect.left < 0 or ballrect.right > width:
+        speed[0] = -speed[0]
+    if ballrect.top < 0 or ballrect.bottom > height:
+        speed[1] = -speed[1]
+
+    screen.fill("black")
+    screen.blit(ball, ballrect)
+    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.
+Make sure the gif file of the bouncing ball is in the same folder
+as the code block.
+On line 4 we set the size of the display window, for best
+results you can change these numbers to match your own monitor's
+resolution.
+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. Later, in the animation part of
+the code, we will see what the Rect objects can do.

+
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 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

+
++++
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+




cdrom
playback
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/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/tut/SpriteIntro.html b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/tut/SpriteIntro.html
new file mode 100644
index 0000000..52deef2
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/tut/SpriteIntro.html
@@ -0,0 +1,494 @@
+
+
+
+  
+    
+    
+
+    Pygame Tutorials - Sprite Module Introduction — pygame v2.6.1 documentation
+    
+    
+    
+    
+    
+    
+    
+    
+    
+     
+    
+
+    

+
+  

+	

+	
+	

+	  

+	    Pygame Home ||
+	    Help Contents ||
+	    Reference Index
+
+        

+          
+          
+        

+	  

+	  

+	  
Most useful stuff:
+	    Color | 
+	    display | 
+	    draw | 
+	    event | 
+	    font | 
+	    image | 
+	    key | 
+	    locals | 
+	    mixer | 
+	    mouse | 
+	    Rect | 
+	    Surface | 
+	    time | 
+	    music | 
+	    pygame
+	  

+
+	  
Advanced stuff:
+	    cursors | 
+	    joystick | 
+	    mask | 
+	    sprite | 
+	    transform | 
+	    BufferProxy | 
+	    freetype | 
+	    gfxdraw | 
+	    midi | 
+	    PixelArray | 
+	    pixelcopy | 
+	    sndarray | 
+	    surfarray | 
+	    math
+	  

+
+	  
Other:
+	    camera | 
+	    controller | 
+	    examples | 
+	    fastevent | 
+	    scrap | 
+	    tests | 
+	    touch | 
+	    version
+	  

+

+

+  

+
+      

+          

+            
+

+

+
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 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 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 "dummy" 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.

+

+
RenderPlain

+

+
This is a standard group derived from Group. It has a draw() method
+that draws all the sprites it contains to the screen (or any Surface). For
+this to work, it requires all sprites it contains to have a "image" and "rect"
+attributes. It uses these to know what to blit, and where to blit it.

+

+
RenderClear

+

+
This is derived from the RenderPlain group, and adds a method named
+clear(). This will erase the previous position of all drawn sprites. It
+uses a background image to fill in the areas where the sprite were. It is smart
+enough to handle deleted sprites and properly clear them from the screen when
+the clear() method is called.

+

+
RenderUpdates

+

+
This is the Cadillac of rendering Groups. It is inherited from
+RenderClear, but changes the draw() method to also return a list of
+pygame Rects, which represent all the areas on screen that have been
+changed.

+

+

+
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 RenderUpdates one, but it adds overhead not
+really needed for something like a scrolling game. So we have a couple tools
+here, pick the right one for the right job.

+
For a scrolling type game, where the background completely changes every frame,
+we obviously don't need to worry about python's update rectangles in the call
+to display.update(). You should definitely go with the RenderPlain
+group here to manage your rendering.

+
For games where the background is more stationary, you definitely don't want
+pygame updating the entire screen (since it doesn't need to). This type of game
+usually involves erasing the old position of each object, then drawing it in a
+new place for each frame. This way we are only changing what is necessary.
+Most of the time you will just want to use the RenderUpdates class here.
+Since you will also want to pass this list of changes to the
+display.update() function.

+
The RenderUpdates class also does a good job at minimizing overlapping
+areas in the list of updated rectangles. If the previous position and current
+position of an object overlap, it will merge them into a single rectangle.
+Combined with the fact that it properly handles deleted objects, this is
+one powerful Group class. If you've written a game that manages the changed
+rectangles for the objects in a game, you know this is the cause for a lot of
+messy code in your game. Especially once you start to throw in objects that can
+be deleted at any time. All this work is reduced to a clear() and
+draw() method with this monster class. Plus with the overlap checking, it
+is likely faster than when you did it manually.

+
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, collided = None) -> 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, collided = None) -> 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
+render() 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(RenderClear):
+    """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 dummy 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/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/tut/SurfarrayIntro.html b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/tut/SurfarrayIntro.html
new file mode 100644
index 0000000..6002da2
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/tut/SurfarrayIntro.html
@@ -0,0 +1,655 @@
+
+
+
+  
+    
+    
+
+    Pygame Tutorials - Surfarray Introduction — pygame v2.6.1 documentation
+    
+    
+    
+    
+    
+    
+    
+    
+    
+     
+    
+
+    

+
+  

+	

+	
+	

+	  

+	    Pygame Home ||
+	    Help Contents ||
+	    Reference Index
+
+        

+          
+          
+        

+	  

+	  

+	  
Most useful stuff:
+	    Color | 
+	    display | 
+	    draw | 
+	    event | 
+	    font | 
+	    image | 
+	    key | 
+	    locals | 
+	    mixer | 
+	    mouse | 
+	    Rect | 
+	    Surface | 
+	    time | 
+	    music | 
+	    pygame
+	  

+
+	  
Advanced stuff:
+	    cursors | 
+	    joystick | 
+	    mask | 
+	    sprite | 
+	    transform | 
+	    BufferProxy | 
+	    freetype | 
+	    gfxdraw | 
+	    midi | 
+	    PixelArray | 
+	    pixelcopy | 
+	    sndarray | 
+	    surfarray | 
+	    math
+	  

+
+	  
Other:
+	    camera | 
+	    controller | 
+	    examples | 
+	    fastevent | 
+	    scrap | 
+	    tests | 
+	    touch | 
+	    version
+	  

+

+

+  

+
+      

+          

+            
+

+

+
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
+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.

+

+

+
NumPy

+
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.png')
+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 NumPy 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/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/tut/chimp.py.html b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/tut/chimp.py.html
new file mode 100644
index 0000000..b5d03e7
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/tut/chimp.py.html
@@ -0,0 +1,338 @@
+
+
+
+  
+    
+    
+
+    pygame/examples/chimp.py — pygame v2.6.1 documentation
+    
+    
+    
+    
+    
+    
+    
+    
+    
+     
+    
+
+    

+
+  

+	

+	
+	

+	  

+	    Pygame Home ||
+	    Help Contents ||
+	    Reference Index
+
+        

+          
+          
+        

+	  

+	  

+	  
Most useful stuff:
+	    Color | 
+	    display | 
+	    draw | 
+	    event | 
+	    font | 
+	    image | 
+	    key | 
+	    locals | 
+	    mixer | 
+	    mouse | 
+	    Rect | 
+	    Surface | 
+	    time | 
+	    music | 
+	    pygame
+	  

+
+	  
Advanced stuff:
+	    cursors | 
+	    joystick | 
+	    mask | 
+	    sprite | 
+	    transform | 
+	    BufferProxy | 
+	    freetype | 
+	    gfxdraw | 
+	    midi | 
+	    PixelArray | 
+	    pixelcopy | 
+	    sndarray | 
+	    surfarray | 
+	    math
+	  

+
+	  
Other:
+	    camera | 
+	    controller | 
+	    examples | 
+	    fastevent | 
+	    scrap | 
+	    tests | 
+	    touch | 
+	    version
+	  

+

+

+  

+
+      

+          

+            
+

+
#!/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 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")
+
+
+# functions to create our resources
+def load_image(name, colorkey=None, scale=1):
+    fullname = os.path.join(data_dir, name)
+    image = pg.image.load(fullname)
+    image = image.convert()
+
+    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, pg.RLEACCEL)
+    return image, image.get_rect()
+
+
+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
+
+
+# classes for our game objects
+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.png", -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
+
+
+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 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
+        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
+
+
+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
+    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 = pg.Surface(screen.get_size())
+    background = background.convert()
+    background.fill((170, 238, 187))
+
+    # Put Text On The Background, Centered
+    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))
+    pg.display.flip()
+
+    # Prepare Game Objects
+    whiff_sound = load_sound("whiff.wav")
+    punch_sound = load_sound("punch.wav")
+    chimp = Chimp()
+    fist = Fist()
+    allsprites = pg.sprite.RenderPlain((chimp, fist))
+    clock = pg.time.Clock()
+
+    # Main Loop
+    going = True
+    while going:
+        clock.tick(60)
+
+        # Handle Input Events
+        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()
+
+        allsprites.update()
+
+        # Draw Everything
+        screen.blit(background, (0, 0))
+        allsprites.draw(screen)
+        pg.display.flip()
+
+    pg.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/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/tut/newbieguide.html b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/tut/newbieguide.html
new file mode 100644
index 0000000..5d3c57d
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/tut/newbieguide.html
@@ -0,0 +1,542 @@
+
+
+
+  
+    
+    
+
+    A Newbie Guide to pygame — pygame v2.6.1 documentation
+    
+    
+    
+    
+    
+    
+    
+    
+    
+     
+    
+
+    

+
+  

+	

+	
+	

+	  

+	    Pygame Home ||
+	    Help Contents ||
+	    Reference Index
+
+        

+          
+          
+        

+	  

+	  

+	  
Most useful stuff:
+	    Color | 
+	    display | 
+	    draw | 
+	    event | 
+	    font | 
+	    image | 
+	    key | 
+	    locals | 
+	    mixer | 
+	    mouse | 
+	    Rect | 
+	    Surface | 
+	    time | 
+	    music | 
+	    pygame
+	  

+
+	  
Advanced stuff:
+	    cursors | 
+	    joystick | 
+	    mask | 
+	    sprite | 
+	    transform | 
+	    BufferProxy | 
+	    freetype | 
+	    gfxdraw | 
+	    midi | 
+	    PixelArray | 
+	    pixelcopy | 
+	    sndarray | 
+	    surfarray | 
+	    math
+	  

+
+	  
Other:
+	    camera | 
+	    controller | 
+	    examples | 
+	    fastevent | 
+	    scrap | 
+	    tests | 
+	    touch | 
+	    version
+	  

+

+

+  

+
+      

+          

+            
+

+

+
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 portions of the screen for software 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 some times when this old technique is still useful
+for squeezing out a few extra FPS. For example, with a single screen game like
+an Asteroids or Space Invaders. 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 required for making performant 2D games with
+modern CPUs, it is still useful 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.

+

+

+
There is NO rule six.

+

+

+
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 techniques, and much of it comes
+from the terminology used.

+
'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.  This is how we make sprites that aren't
+rectangular in shape.  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.

+
'Alpha' is different, and it comes in two flavors. 'Image alpha' applies to the
+whole image, and is probably what you want.  Properly known as 'translucency',
+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 colorkey and alpha
+blitting can be combined -- this produces an image that is fully transparent in
+some spots, and semi-transparent in others.

+
'Per-pixel alpha' is the other flavor of alpha, and it's more complicated.
+Basically, each pixel in the source image has its own alpha value, from 0 to
+255.  Each pixel, therefore, can have a different opacity when blitted onto a
+background.  This type of alpha can't be mixed with colorkey blitting,
+and it overrides per-image alpha.  Per-pixel alpha is rarely used in
+games, and to use it you have to save your source image in a graphic
+editor with a special alpha channel.  It's complicated -- don't use it
+yet.

+

+

+
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):

+
import pygame
+
+pygame.init()
+
+screen = pygame.display.set_mode((1280,720))
+
+clock = pygame.time.Clock()
+
+while True:
+    # Process player inputs.
+    for event in pygame.event.get():
+        if event.type == pygame.QUIT:
+            pygame.quit()
+            raise SystemExit
+
+    # Do logical updates here.
+    # ...
+
+    screen.fill("purple")  # Fill the display with a solid color
+
+    # Render the graphics here.
+    # ...
+
+    pygame.display.flip()  # Refresh on-screen display
+    clock.tick(60)         # wait until next frame (at 60 FPS)
+

+

+
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.

+

+

+

+
+
+


+

+Edit on GitHub
+            

+          

+      

+      

+    

+    
+    
+  
+
\ No newline at end of file
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/tut/tom_games2.html b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/tut/tom_games2.html
new file mode 100644
index 0000000..01a5843
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/tut/tom_games2.html
@@ -0,0 +1,236 @@
+
+
+
+  
+    
+    
+
+    Revision: Pygame fundamentals — pygame v2.6.1 documentation
+    
+    
+    
+    
+    
+    
+    
+    
+    
+     
+    
+
+    

+
+  

+	

+	
+	

+	  

+	    Pygame Home ||
+	    Help Contents ||
+	    Reference Index
+
+        

+          
+          
+        

+	  

+	  

+	  
Most useful stuff:
+	    Color | 
+	    display | 
+	    draw | 
+	    event | 
+	    font | 
+	    image | 
+	    key | 
+	    locals | 
+	    mixer | 
+	    mouse | 
+	    Rect | 
+	    Surface | 
+	    time | 
+	    music | 
+	    pygame
+	  

+
+	  
Advanced stuff:
+	    cursors | 
+	    joystick | 
+	    mask | 
+	    sprite | 
+	    transform | 
+	    BufferProxy | 
+	    freetype | 
+	    gfxdraw | 
+	    midi | 
+	    PixelArray | 
+	    pixelcopy | 
+	    sndarray | 
+	    surfarray | 
+	    math
+	  

+
+	  
Other:
+	    camera | 
+	    controller | 
+	    examples | 
+	    fastevent | 
+	    scrap | 
+	    tests | 
+	    touch | 
+	    version
+	  

+

+

+  

+
+      

+          

+            
+

+

+
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.png
+
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/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/tut/tom_games3.html b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/tut/tom_games3.html
new file mode 100644
index 0000000..675776d
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/tut/tom_games3.html
@@ -0,0 +1,216 @@
+
+
+
+  
+    
+    
+
+    Kicking things off — pygame v2.6.1 documentation
+    
+    
+    
+    
+    
+    
+    
+    
+    
+     
+    
+
+    

+
+  

+	

+	
+	

+	  

+	    Pygame Home ||
+	    Help Contents ||
+	    Reference Index
+
+        

+          
+          
+        

+	  

+	  

+	  
Most useful stuff:
+	    Color | 
+	    display | 
+	    draw | 
+	    event | 
+	    font | 
+	    image | 
+	    key | 
+	    locals | 
+	    mixer | 
+	    mouse | 
+	    Rect | 
+	    Surface | 
+	    time | 
+	    music | 
+	    pygame
+	  

+
+	  
Advanced stuff:
+	    cursors | 
+	    joystick | 
+	    mask | 
+	    sprite | 
+	    transform | 
+	    BufferProxy | 
+	    freetype | 
+	    gfxdraw | 
+	    midi | 
+	    PixelArray | 
+	    pixelcopy | 
+	    sndarray | 
+	    surfarray | 
+	    math
+	  

+
+	  
Other:
+	    camera | 
+	    controller | 
+	    examples | 
+	    fastevent | 
+	    scrap | 
+	    tests | 
+	    touch | 
+	    version
+	  

+

+

+  

+
+      

+          

+            
+

+

+
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 as 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/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/tut/tom_games4.html b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/tut/tom_games4.html
new file mode 100644
index 0000000..285cc98
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/tut/tom_games4.html
@@ -0,0 +1,245 @@
+
+
+
+  
+    
+    
+
+    Game object classes — pygame v2.6.1 documentation
+    
+    
+    
+    
+    
+    
+    
+    
+    
+     
+    
+
+    

+
+  

+	

+	
+	

+	  

+	    Pygame Home ||
+	    Help Contents ||
+	    Reference Index
+
+        

+          
+          
+        

+	  

+	  

+	  
Most useful stuff:
+	    Color | 
+	    display | 
+	    draw | 
+	    event | 
+	    font | 
+	    image | 
+	    key | 
+	    locals | 
+	    mixer | 
+	    mouse | 
+	    Rect | 
+	    Surface | 
+	    time | 
+	    music | 
+	    pygame
+	  

+
+	  
Advanced stuff:
+	    cursors | 
+	    joystick | 
+	    mask | 
+	    sprite | 
+	    transform | 
+	    BufferProxy | 
+	    freetype | 
+	    gfxdraw | 
+	    midi | 
+	    PixelArray | 
+	    pixelcopy | 
+	    sndarray | 
+	    surfarray | 
+	    math
+	  

+
+	  
Other:
+	    camera | 
+	    controller | 
+	    examples | 
+	    fastevent | 
+	    scrap | 
+	    tests | 
+	    touch | 
+	    version
+	  

+

+

+  

+
+      

+          

+            
+

+

+
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.png
+
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.png
+

+

+

+

+
+
+


+

+Edit on GitHub
+            

+          

+      

+      

+    

+    
+    
+  
+
\ No newline at end of file
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/tut/tom_games5.html b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/tut/tom_games5.html
new file mode 100644
index 0000000..1cec83e
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/tut/tom_games5.html
@@ -0,0 +1,234 @@
+
+
+
+  
+    
+    
+
+    User-controllable objects — pygame v2.6.1 documentation
+    
+    
+    
+    
+    
+    
+    
+    
+    
+     
+    
+
+    

+
+  

+	

+	
+	

+	  

+	    Pygame Home ||
+	    Help Contents ||
+	    Reference Index
+
+        

+          
+          
+        

+	  

+	  

+	  
Most useful stuff:
+	    Color | 
+	    display | 
+	    draw | 
+	    event | 
+	    font | 
+	    image | 
+	    key | 
+	    locals | 
+	    mixer | 
+	    mouse | 
+	    Rect | 
+	    Surface | 
+	    time | 
+	    music | 
+	    pygame
+	  

+
+	  
Advanced stuff:
+	    cursors | 
+	    joystick | 
+	    mask | 
+	    sprite | 
+	    transform | 
+	    BufferProxy | 
+	    freetype | 
+	    gfxdraw | 
+	    midi | 
+	    PixelArray | 
+	    pixelcopy | 
+	    sndarray | 
+	    surfarray | 
+	    math
+	  

+
+	  
Other:
+	    camera | 
+	    controller | 
+	    examples | 
+	    fastevent | 
+	    scrap | 
+	    tests | 
+	    touch | 
+	    version
+	  

+

+

+  

+
+      

+          

+            
+

+

+
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.png
+
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, dummy! 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/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/tut/tom_games6.html b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/tut/tom_games6.html
new file mode 100644
index 0000000..f566256
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/docs/generated/tut/tom_games6.html
@@ -0,0 +1,433 @@
+
+
+
+  
+    
+    
+
+    Putting it all together — pygame v2.6.1 documentation
+    
+    
+    
+    
+    
+    
+    
+    
+    
+     
+    
+
+    

+
+  

+	

+	
+	

+	  

+	    Pygame Home ||
+	    Help Contents ||
+	    Reference Index
+
+        

+          
+          
+        

+	  

+	  

+	  
Most useful stuff:
+	    Color | 
+	    display | 
+	    draw | 
+	    event | 
+	    font | 
+	    image | 
+	    key | 
+	    locals | 
+	    mixer | 
+	    mouse | 
+	    Rect | 
+	    Surface | 
+	    time | 
+	    music | 
+	    pygame
+	  

+
+	  
Advanced stuff:
+	    cursors | 
+	    joystick | 
+	    mask | 
+	    sprite | 
+	    transform | 
+	    BufferProxy | 
+	    freetype | 
+	    gfxdraw | 
+	    midi | 
+	    PixelArray | 
+	    pixelcopy | 
+	    sndarray | 
+	    surfarray | 
+	    math
+	  

+
+	  
Other:
+	    camera | 
+	    controller | 
+	    examples | 
+	    fastevent | 
+	    scrap | 
+	    tests | 
+	    touch | 
+	    version
+	  

+

+

+  

+
+      

+          

+            
+

+

+
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.RenderPlain((player1, player2))
+    ballsprite = pygame.sprite.RenderPlain(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/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/draw.cpython-312-darwin.so b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/draw.cpython-312-darwin.so
new file mode 100755
index 0000000..e140a07
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/draw.cpython-312-darwin.so differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/draw.pyi b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/draw.pyi
new file mode 100644
index 0000000..d574ea3
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/draw.pyi
@@ -0,0 +1,74 @@
+from typing import Optional, Sequence
+
+from pygame.rect import Rect
+from pygame.surface import Surface
+
+from ._common import ColorValue, Coordinate, RectValue
+
+def rect(
+    surface: Surface,
+    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: ...
+def polygon(
+    surface: Surface,
+    color: ColorValue,
+    points: Sequence[Coordinate],
+    width: int = 0,
+) -> Rect: ...
+def circle(
+    surface: Surface,
+    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: ...
+def ellipse(
+    surface: Surface, color: ColorValue, rect: RectValue, width: int = 0
+) -> Rect: ...
+def arc(
+    surface: Surface,
+    color: ColorValue,
+    rect: RectValue,
+    start_angle: float,
+    stop_angle: float,
+    width: int = 1,
+) -> Rect: ...
+def line(
+    surface: Surface,
+    color: ColorValue,
+    start_pos: Coordinate,
+    end_pos: Coordinate,
+    width: int = 1,
+) -> Rect: ...
+def lines(
+    surface: Surface,
+    color: ColorValue,
+    closed: bool,
+    points: Sequence[Coordinate],
+    width: int = 1,
+) -> Rect: ...
+def aaline(
+    surface: Surface,
+    color: ColorValue,
+    start_pos: Coordinate,
+    end_pos: Coordinate,
+    blend: int = 1,
+) -> Rect: ...
+def aalines(
+    surface: Surface,
+    color: ColorValue,
+    closed: bool,
+    points: Sequence[Coordinate],
+    blend: int = 1,
+) -> Rect: ...
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/draw_py.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/draw_py.py
new file mode 100644
index 0000000..33f6092
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/draw_py.py
@@ -0,0 +1,562 @@
+"""Pygame Drawing algorithms written in Python. (Work in Progress)
+
+Implement Pygame's Drawing Algorithms in a Python version for testing
+and debugging.
+"""
+
+from collections import namedtuple
+from math import floor, ceil
+
+
+#   H E L P E R   F U N C T I O N S    #
+
+# fractional part of x
+
+
+def frac(value):
+    """return fractional part of x"""
+    return value - floor(value)
+
+
+def inv_frac(value):
+    """return inverse fractional part of x"""
+    return 1 - (value - floor(value))  # eg, 1 - frac(x)
+
+
+BoundingBox = namedtuple("BoundingBox", ["left", "top", "right", "bottom"])
+Point = namedtuple("Point", ["x", "y"])
+
+
+#   L O W   L E V E L   D R A W   F U N C T I O N S   #
+# (They are too low-level to be translated into python, right?)
+
+
+def set_at(surf, in_x, in_y, color):
+    """Set the color of a pixel in a surface"""
+    surf.set_at((in_x, in_y), color)
+
+
+def draw_pixel(surf, pos, color, bright, blend=True):
+    """draw one blended pixel with given brightness."""
+    try:
+        other_col = surf.get_at(pos) if blend else (0, 0, 0, 0)
+    except IndexError:  # pixel outside the surface
+        return
+    new_color = tuple(
+        (bright * col + (1 - bright) * pix) for col, pix in zip(color, other_col)
+    )
+    # FIXME what should happen if only one, color or surf_col, has alpha?
+    surf.set_at(pos, new_color)
+
+
+def _drawhorzline(surf, color, x_from, in_y, x_to):
+    if x_from == x_to:
+        surf.set_at((x_from, in_y), color)
+        return
+
+    start, end = (x_from, x_to) if x_from <= x_to else (x_to, x_from)
+    for line_x in range(start, end + 1):
+        surf.set_at((line_x, in_y), color)
+
+
+def _drawvertline(surf, color, in_x, y_from, y_to):
+    if y_from == y_to:
+        surf.set_at((in_x, y_from), color)
+        return
+
+    start, end = (y_from, y_to) if y_from <= y_to else (y_to, y_from)
+    for line_y in range(start, end + 1):
+        surf.set_at((in_x, line_y), color)
+
+
+#    I N T E R N A L   D R A W   L I N E   F U N C T I O N S    #
+
+
+def _clip_and_draw_horizline(surf, color, x_from, in_y, x_to):
+    """draw clipped horizontal line."""
+    # check Y inside surf
+    clip = surf.get_clip()
+    if in_y < clip.y or in_y >= clip.y + clip.h:
+        return
+
+    x_from = max(x_from, clip.x)
+    x_to = min(x_to, clip.x + clip.w - 1)
+
+    # check any x inside surf
+    if x_to < clip.x or x_from >= clip.x + clip.w:
+        return
+
+    _drawhorzline(surf, color, x_from, in_y, x_to)
+
+
+def _clip_and_draw_vertline(surf, color, in_x, y_from, y_to):
+    """draw clipped vertical line."""
+    # check X inside surf
+    clip = surf.get_clip()
+
+    if in_x < clip.x or in_x >= clip.x + clip.w:
+        return
+
+    y_from = max(y_from, clip.y)
+    y_to = min(y_to, clip.y + clip.h - 1)
+
+    # check any y inside surf
+    if y_to < clip.y or y_from >= clip.y + clip.h:
+        return
+
+    _drawvertline(surf, color, in_x, y_from, y_to)
+
+
+# These constants xxx_EDGE are "outside-the-bounding-box"-flags
+LEFT_EDGE = 0x1
+RIGHT_EDGE = 0x2
+BOTTOM_EDGE = 0x4
+TOP_EDGE = 0x8
+
+
+def encode(pos, b_box):
+    """returns a code that defines position with respect to a bounding box"""
+    # we use the fact that python interprets booleans (the inequalities)
+    # as 0/1, and then multiply them with the xxx_EDGE flags
+    return (
+        (pos[0] < b_box.left) * LEFT_EDGE
+        + (pos[0] > b_box.right) * RIGHT_EDGE
+        + (pos[1] < b_box.top) * TOP_EDGE
+        + (pos[1] > b_box.bottom) * BOTTOM_EDGE
+    )
+
+
+def clip_line(line, b_box, use_float=False):
+    """Algorithm to calculate the clipped line.
+
+    We calculate the coordinates of the part of the line segment within the
+    bounding box (defined by left, top, right, bottom). The we write
+    the coordinates of the line segment into "line", much like the C-algorithm.
+    With `use_float` True, clip_line is usable for float-clipping.
+
+    Returns: true if the line segment cuts the bounding box (false otherwise)
+    """
+
+    def inside(code):
+        return not code
+
+    def accept(code_a, code_b):
+        return not (code_a or code_b)
+
+    def reject(code_a, code_b):
+        return code_a and code_b
+
+    assert isinstance(line, list)
+    x_1, y_1, x_2, y_2 = line
+    dtype = float if use_float else int
+
+    while True:
+        # the coordinates are progressively modified with the codes,
+        # until they are either rejected or correspond to the final result.
+        code1 = encode((x_1, y_1), b_box)
+        code2 = encode((x_2, y_2), b_box)
+
+        if accept(code1, code2):
+            # write coordinates into "line" !
+            line[:] = x_1, y_1, x_2, y_2
+            return True
+        if reject(code1, code2):
+            return False
+
+        # We operate on the (x_1, y_1) point,
+        # and swap if it is inside the bbox:
+        if inside(code1):
+            x_1, x_2 = x_2, x_1
+            y_1, y_2 = y_2, y_1
+            code1, code2 = code2, code1
+        slope = (y_2 - y_1) / float(x_2 - x_1) if (x_2 != x_1) else 1.0
+        # Each case, if true, means that we are outside the border:
+        # calculate x_1 and y_1 to be the "first point" inside the bbox...
+        if code1 & LEFT_EDGE:
+            y_1 += dtype((b_box.left - x_1) * slope)
+            x_1 = b_box.left
+        elif code1 & RIGHT_EDGE:
+            y_1 += dtype((b_box.right - x_1) * slope)
+            x_1 = b_box.right
+        elif code1 & BOTTOM_EDGE:
+            if x_2 != x_1:
+                x_1 += dtype((b_box.bottom - y_1) / slope)
+            y_1 = b_box.bottom
+        elif code1 & TOP_EDGE:
+            if x_2 != x_1:
+                x_1 += dtype((b_box.top - y_1) / slope)
+            y_1 = b_box.top
+
+
+def _draw_line(surf, color, start, end):
+    """draw a non-horizontal line (without anti-aliasing)."""
+    # Variant of https://en.wikipedia.org/wiki/Bresenham's_line_algorithm
+    #
+    # This strongly differs from craw.c implementation, because we use a
+    # "slope" variable (instead of delta_x and delta_y) and a "error" variable.
+    # And we can not do pointer-arithmetic with "BytesPerPixel", like in
+    # the C-algorithm.
+    if start.x == end.x:
+        # This case should not happen...
+        raise ValueError
+
+    slope = abs((end.y - start.y) / (end.x - start.x))
+    error = 0.0
+
+    if slope < 1:
+        # Here, it's a rather horizontal line
+
+        # 1. check in which octants we are & set init values
+        if end.x < start.x:
+            start.x, end.x = end.x, start.x
+            start.y, end.y = end.y, start.y
+        line_y = start.y
+        dy_sign = 1 if (start.y < end.y) else -1
+
+        # 2. step along x coordinate
+        for line_x in range(start.x, end.x + 1):
+            set_at(surf, line_x, line_y, color)
+            error += slope
+            if error >= 0.5:
+                line_y += dy_sign
+                error -= 1
+    else:
+        # Case of a rather vertical line
+
+        # 1. check in which octants we are & set init values
+        if start.y > end.y:
+            start.x, end.x = end.x, start.x
+            start.y, end.y = end.y, start.y
+        line_x = start.x
+        slope = 1 / slope
+        dx_sign = 1 if (start.x < end.x) else -1
+
+        # 2. step along y coordinate
+        for line_y in range(start.y, end.y + 1):
+            set_at(surf, line_x, line_y, color)
+            error += slope
+            if error >= 0.5:
+                line_x += dx_sign
+                error -= 1
+
+
+def _draw_aaline(surf, color, start, end, blend):
+    """draw an anti-aliased line.
+
+    The algorithm yields identical results with _draw_line for horizontal,
+    vertical or diagonal lines, and results changes smoothly when changing
+    any of the endpoint coordinates.
+
+    Note that this yields strange results for very short lines, eg
+    a line from (0, 0) to (0, 1) will draw 2 pixels, and a line from
+    (0, 0) to (0, 1.1) will blend 10 % on the pixel (0, 2).
+    """
+    # The different requirements that we have on an antialiasing algorithm
+    # implies to make some compromises:
+    # 1. We want smooth evolution wrt to the 4 endpoint coordinates
+    #    (this means also that we want a smooth evolution when the angle
+    #     passes +/- 45°
+    # 2. We want the same behavior when swapping the endpoints
+    # 3. We want understandable results for the endpoint values
+    #    (eg we want to avoid half-integer values to draw a simple plain
+    #     horizontal or vertical line between two integer l endpoints)
+    #
+    # This implies to somehow make the line artificially 1 pixel longer
+    # and to draw a full pixel when we have the  endpoints are identical.
+    d_x = end.x - start.x
+    d_y = end.y - start.y
+
+    if d_x == 0 and d_y == 0:
+        # For smoothness reasons, we could also do some blending here,
+        # but it seems overshoot...
+        set_at(surf, int(start.x), int(start.y), color)
+        return
+
+    if start.x > end.x or start.y > end.y:
+        start.x, end.x = end.x, start.x
+        start.y, end.y = end.y, start.y
+        d_x = -d_x
+        d_y = -d_y
+
+    if abs(d_x) >= abs(d_y):
+        slope = d_y / d_x
+
+        def draw_two_pixel(in_x, float_y, factor):
+            flr_y = floor(float_y)
+            draw_pixel(surf, (in_x, flr_y), color, factor * inv_frac(float_y), blend)
+            draw_pixel(surf, (in_x, flr_y + 1), color, factor * frac(float_y), blend)
+
+        _draw_aaline_dx(d_x, slope, end, start, draw_two_pixel)
+    else:
+        slope = d_x / d_y
+
+        def draw_two_pixel(float_x, in_y, factor):
+            fl_x = floor(float_x)
+            draw_pixel(surf, (fl_x, in_y), color, factor * inv_frac(float_x), blend)
+            draw_pixel(surf, (fl_x + 1, in_y), color, factor * frac(float_x), blend)
+
+        _draw_aaline_dy(d_y, slope, end, start, draw_two_pixel)
+
+
+def _draw_aaline_dy(d_y, slope, end, start, draw_two_pixel):
+    g_y = ceil(start.y)
+    g_x = start.x + (g_y - start.y) * slope
+    # 1. Draw start of the segment
+    if start.y < g_y:
+        draw_two_pixel(g_x - slope, floor(start.y), inv_frac(start.y))
+    # 2. Draw end of the segment
+    rest = frac(end.y)
+    s_y = ceil(end.y)
+    if rest > 0:
+        s_x = start.x + slope * (d_y + 1 - rest)
+        draw_two_pixel(s_x, s_y, rest)
+    else:
+        s_y += 1
+    # 3. loop for other points
+    for line_y in range(g_y, s_y):
+        line_x = g_x + slope * (line_y - g_y)
+        draw_two_pixel(line_x, line_y, 1)
+
+
+def _draw_aaline_dx(d_x, slope, end, start, draw_two_pixel):
+    # A and G are respectively left and right to the "from" point, but
+    # with integer-x-coordinate, (and only if from_x is not integer).
+    # Hence they appear in following order on the line in general case:
+    #  A   from-pt    G    .  .  .        to-pt    S
+    #  |------*-------|--- .  .  . ---|-----*------|-
+    g_x = ceil(start.x)
+    g_y = start.y + (g_x - start.x) * slope
+    # 1. Draw start of the segment if we have a non-integer-part
+    if start.x < g_x:
+        # this corresponds to the point "A"
+        draw_two_pixel(floor(start.x), g_y - slope, inv_frac(start.x))
+    # 2. Draw end of the segment: we add one pixel for homogeneity reasons
+    rest = frac(end.x)
+    s_x = ceil(end.x)
+    if rest > 0:
+        # Again we draw only if we have a non-integer-part
+        s_y = start.y + slope * (d_x + 1 - rest)
+        draw_two_pixel(s_x, s_y, rest)
+    else:
+        s_x += 1
+    # 3. loop for other points
+    for line_x in range(g_x, s_x):
+        line_y = g_y + slope * (line_x - g_x)
+        draw_two_pixel(line_x, line_y, 1)
+
+
+#   C L I P   A N D   D R A W   L I N E   F U N C T I O N S    #
+
+
+def _clip_and_draw_line(surf, rect, color, pts):
+    """clip the line into the rectangle and draw if needed.
+
+    Returns true if anything has been drawn, else false."""
+    # "pts" is a list with the four coordinates of the two endpoints
+    # of the line to be drawn : pts = x1, y1, x2, y2.
+    # The data format is like that to stay closer to the C-algorithm.
+    if not clip_line(
+        pts, BoundingBox(rect.x, rect.y, rect.x + rect.w - 1, rect.y + rect.h - 1)
+    ):
+        # The line segment defined by "pts" is not crossing the rectangle
+        return 0
+    if pts[1] == pts[3]:  # eg y1 == y2
+        _drawhorzline(surf, color, pts[0], pts[1], pts[2])
+    elif pts[0] == pts[2]:  # eg x1 == x2
+        _drawvertline(surf, color, pts[0], pts[1], pts[3])
+    else:
+        _draw_line(surf, color, Point(pts[0], pts[1]), Point(pts[2], pts[3]))
+    return 1
+
+
+def _clip_and_draw_line_width(surf, rect, color, line, width):
+    yinc = xinc = 0
+    if abs(line[0] - line[2]) > abs(line[1] - line[3]):
+        yinc = 1
+    else:
+        xinc = 1
+    newpts = line[:]
+    if _clip_and_draw_line(surf, rect, color, newpts):
+        anydrawn = 1
+        frame = newpts[:]
+    else:
+        anydrawn = 0
+        frame = [10000, 10000, -10000, -10000]
+
+    for loop in range(1, width // 2 + 1):
+        newpts[0] = line[0] + xinc * loop
+        newpts[1] = line[1] + yinc * loop
+        newpts[2] = line[2] + xinc * loop
+        newpts[3] = line[3] + yinc * loop
+        if _clip_and_draw_line(surf, rect, color, newpts):
+            anydrawn = 1
+            frame[0] = min(newpts[0], frame[0])
+            frame[1] = min(newpts[1], frame[1])
+            frame[2] = max(newpts[2], frame[2])
+            frame[3] = max(newpts[3], frame[3])
+
+        if loop * 2 < width:
+            newpts[0] = line[0] - xinc * loop
+            newpts[1] = line[1] - yinc * loop
+            newpts[2] = line[2] - xinc * loop
+            newpts[3] = line[3] - yinc * loop
+            if _clip_and_draw_line(surf, rect, color, newpts):
+                anydrawn = 1
+                frame[0] = min(newpts[0], frame[0])
+                frame[1] = min(newpts[1], frame[1])
+                frame[2] = max(newpts[2], frame[2])
+                frame[3] = max(newpts[3], frame[3])
+
+    return anydrawn
+
+
+def _clip_and_draw_aaline(surf, rect, color, line, blend):
+    """draw anti-aliased line between two endpoints."""
+    if not clip_line(
+        line,
+        BoundingBox(rect.x - 1, rect.y - 1, rect.x + rect.w, rect.y + rect.h),
+        use_float=True,
+    ):
+        return  # TODO Rect(rect.x, rect.y, 0, 0)
+    _draw_aaline(surf, color, Point(line[0], line[1]), Point(line[2], line[3]), blend)
+    return  # TODO Rect(-- affected area --)
+
+
+#    D R A W   L I N E   F U N C T I O N S    #
+
+
+def draw_aaline(surf, color, from_point, to_point, blend=True):
+    """draw anti-aliased line between two endpoints."""
+    line = [from_point[0], from_point[1], to_point[0], to_point[1]]
+    return _clip_and_draw_aaline(surf, surf.get_clip(), color, line, blend)
+
+
+def draw_line(surf, color, from_point, to_point, width=1):
+    """draw anti-aliased line between two endpoints."""
+    line = [from_point[0], from_point[1], to_point[0], to_point[1]]
+    return _clip_and_draw_line_width(surf, surf.get_clip(), color, line, width)
+
+
+#   M U L T I L I N E   F U N C T I O N S   #
+
+
+def _multi_lines(
+    surf,
+    color,
+    closed,  # pylint: disable=too-many-arguments
+    points,
+    width=1,
+    blend=False,
+    aaline=False,
+):
+    """draw several lines, either anti-aliased or not."""
+    # The code for anti-aliased or not is almost identical, so it's factorized
+    if len(points) <= 2:
+        raise TypeError
+    line = [0] * 4  # store x1, y1 & x2, y2 of the lines to be drawn
+
+    xlist = [pt[0] for pt in points]
+    ylist = [pt[1] for pt in points]
+    line[0] = xlist[0]
+    line[1] = ylist[0]
+    b_box = BoundingBox(left=xlist[0], right=xlist[0], top=ylist[0], bottom=ylist[0])
+
+    for line_x, line_y in points[1:]:
+        b_box.left = min(b_box.left, line_x)
+        b_box.right = max(b_box.right, line_x)
+        b_box.top = min(b_box.top, line_y)
+        b_box.bottom = max(b_box.bottom, line_y)
+
+    rect = surf.get_clip()
+    for loop in range(1, len(points)):
+        line[0] = xlist[loop - 1]
+        line[1] = ylist[loop - 1]
+        line[2] = xlist[loop]
+        line[3] = ylist[loop]
+        if aaline:
+            _clip_and_draw_aaline(surf, rect, color, line, blend)
+        else:
+            _clip_and_draw_line_width(surf, rect, color, line, width)
+
+    if closed:
+        line[0] = xlist[len(points) - 1]
+        line[1] = ylist[len(points) - 1]
+        line[2] = xlist[0]
+        line[3] = ylist[0]
+        if aaline:
+            _clip_and_draw_aaline(surf, rect, color, line, blend)
+        else:
+            _clip_and_draw_line_width(surf, rect, color, line, width)
+
+    # TODO Rect(...)
+
+
+def draw_lines(surf, color, closed, points, width=1):
+    """draw several lines connected through the points."""
+    return _multi_lines(surf, color, closed, points, width, aaline=False)
+
+
+def draw_aalines(surf, color, closed, points, blend=True):
+    """draw several anti-aliased lines connected through the points."""
+    return _multi_lines(surf, color, closed, points, blend=blend, aaline=True)
+
+
+def draw_polygon(surface, color, points, width):
+    """Draw a polygon"""
+    if width:
+        draw_lines(surface, color, 1, points, width)
+        return  # TODO Rect(...)
+    num_points = len(points)
+    point_x = [x for x, y in points]
+    point_y = [y for x, y in points]
+
+    miny = min(point_y)
+    maxy = max(point_y)
+
+    if miny == maxy:
+        minx = min(point_x)
+        maxx = max(point_x)
+        _clip_and_draw_horizline(surface, color, minx, miny, maxx)
+        return  # TODO Rect(...)
+
+    for y_coord in range(miny, maxy + 1):
+        x_intersect = []
+        for i in range(num_points):
+            _draw_polygon_inner_loop(i, point_x, point_y, y_coord, x_intersect)
+
+        x_intersect.sort()
+        for i in range(0, len(x_intersect), 2):
+            _clip_and_draw_horizline(
+                surface, color, x_intersect[i], y_coord, x_intersect[i + 1]
+            )
+
+    # special case : horizontal border lines
+    for i in range(num_points):
+        i_prev = i - 1 if i else num_points - 1
+        if miny < point_y[i] == point_y[i_prev] < maxy:
+            _clip_and_draw_horizline(
+                surface, color, point_x[i], point_y[i], point_x[i_prev]
+            )
+
+    return  # TODO Rect(...)
+
+
+def _draw_polygon_inner_loop(index, point_x, point_y, y_coord, x_intersect):
+    i_prev = index - 1 if index else len(point_x) - 1
+
+    y_1 = point_y[i_prev]
+    y_2 = point_y[index]
+
+    if y_1 < y_2:
+        x_1 = point_x[i_prev]
+        x_2 = point_x[index]
+    elif y_1 > y_2:
+        y_2 = point_y[i_prev]
+        y_1 = point_y[index]
+        x_2 = point_x[i_prev]
+        x_1 = point_x[index]
+    else:  # special case handled below
+        return
+
+    if (y_2 > y_coord >= y_1) or ((y_coord == max(point_y)) and (y_coord <= y_2)):
+        x_intersect.append((y_coord - y_1) * (x_2 - x_1) // (y_2 - y_1) + x_1)
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/event.cpython-312-darwin.so b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/event.cpython-312-darwin.so
new file mode 100755
index 0000000..19dab27
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/event.cpython-312-darwin.so differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/event.pyi b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/event.pyi
new file mode 100644
index 0000000..9175960
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/event.pyi
@@ -0,0 +1,51 @@
+from typing import (
+    Any,
+    Dict,
+    List,
+    Optional,
+    Sequence,
+    SupportsInt,
+    Tuple,
+    Union,
+    final,
+    overload,
+)
+
+@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
+    ) -> None: ...
+    def __getattribute__(self, name: str) -> Any: ...
+    def __setattr__(self, name: str, value: Any) -> None: ...
+    def __delattr__(self, name: str) -> None: ...
+    def __bool__(self) -> bool: ...
+
+_EventTypes = Union[SupportsInt, Tuple[SupportsInt, ...], Sequence[SupportsInt]]
+
+def pump() -> None: ...
+def get(
+    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: 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 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/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/README.rst b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/README.rst
new file mode 100644
index 0000000..68b75bb
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/README.rst
@@ -0,0 +1,154 @@
+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
+   An arcade-style space shooter game that showcases various common and 
+   important Pygame modules and techniques.
+
+arraydemo.py
+   Showcases the use of Numpy with Pygame to perform efficient 
+   pixel manipulation.
+
+audiocapture.py
+   Use the mixer module to record sound from a microphone, and 
+   play back the recorded sound.
+
+blend_fill.py
+   Demonstrates how to perform surface blending and filling 
+   with Pygame.
+
+blit_blends.py
+   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
+   Demonstrates the creation of custom cursors with Pygame.
+
+dropevent.py
+   Drag and drop files using the following events:
+   DROPBEGIN, DROPCOMPLETE, DROPTEXT, DROPFILE
+
+eventlist.py
+   A utility for displaying and logging real-time Pygame events, 
+   useful for debugging.
+
+font_viewer.py
+   Demonstrates how to display all available fonts in a 
+   scrolling window.
+
+fonty.py
+   A simple application demonstrating the different ways 
+   to render fonts with the font module
+
+freetype_misc.py
+   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 the important Vector.move_towards() function.
+
+grid.py
+   A simple example of grid-based movement.
+
+headless_no_windows_needed.py
+   Shows how to run Pygame in scripts.
+
+joystick.py
+   Shows how to integrate joysticks or game controllers into Pygame.
+
+liquid.py
+   Demonstrates how to create a simple liquid effect in an image. 
+
+mask.py
+   Showcases how to use masks for collision detection and sprite 
+   interaction.
+
+midi.py
+   Demonstrates how to use MIDI I/O using the midi module.
+
+moveit.py
+   Illustrates how to accomplish sprite movement and animation.
+
+music_drop_fade.py
+   Showcases dropping music files into Pygame, and how to
+   apply a fade effect to music playback.
+
+pixelarray.py
+   Manipulation of individual pixels using the PixelArray module.
+
+playmus.py
+   Uses the mixer module to play music files with CLI.
+
+prevent_display_stretching.py
+   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
+   Showcases the scaling of Surfaces.
+
+scrap_clipboard.py
+   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
+   Handles mouse scaling and selection of a good sized window depending
+   on the display.
+
+sound.py
+   Illustrates how to implement sound effects and music using Pygame.
+
+sound_array_demos.py
+   Showcases echo, delay and other array based processing of sounds.
+
+sprite_texture.py
+   Demonstrates how to use textured sprites in Pygame.
+
+stars.py
+   A simple starfield implementation in which the perspective can be
+   changed by a mouse click.
+
+testsprite.py
+   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
+   Shows how to apply vertical gradients to surfaces using Pygame.
+
+video.py
+   Showcases the movie module, including the display of playback 
+   controls.
+
+data/
+   Directory with the resources for the examples.
+
+
+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/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/__init__.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/__init__.py
new file mode 100644
index 0000000..e69de29
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/__pycache__/__init__.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/__pycache__/__init__.cpython-312.pyc
new file mode 100644
index 0000000..96ac491
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/__pycache__/__init__.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/__pycache__/aacircle.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/__pycache__/aacircle.cpython-312.pyc
new file mode 100644
index 0000000..ddb3a8e
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/__pycache__/aacircle.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/__pycache__/aliens.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/__pycache__/aliens.cpython-312.pyc
new file mode 100644
index 0000000..4860477
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/__pycache__/aliens.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/__pycache__/arraydemo.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/__pycache__/arraydemo.cpython-312.pyc
new file mode 100644
index 0000000..4d0cd06
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/__pycache__/arraydemo.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/__pycache__/audiocapture.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/__pycache__/audiocapture.cpython-312.pyc
new file mode 100644
index 0000000..0f44980
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/__pycache__/audiocapture.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/__pycache__/blend_fill.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/__pycache__/blend_fill.cpython-312.pyc
new file mode 100644
index 0000000..4906090
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/__pycache__/blend_fill.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/__pycache__/blit_blends.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/__pycache__/blit_blends.cpython-312.pyc
new file mode 100644
index 0000000..0e34e32
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/__pycache__/blit_blends.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/__pycache__/camera.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/__pycache__/camera.cpython-312.pyc
new file mode 100644
index 0000000..dae9972
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/__pycache__/camera.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/__pycache__/chimp.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/__pycache__/chimp.cpython-312.pyc
new file mode 100644
index 0000000..23e37eb
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/__pycache__/chimp.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/__pycache__/cursors.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/__pycache__/cursors.cpython-312.pyc
new file mode 100644
index 0000000..e62ae50
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/__pycache__/cursors.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/__pycache__/dropevent.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/__pycache__/dropevent.cpython-312.pyc
new file mode 100644
index 0000000..97a7505
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/__pycache__/dropevent.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/__pycache__/eventlist.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/__pycache__/eventlist.cpython-312.pyc
new file mode 100644
index 0000000..2b0cf58
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/__pycache__/eventlist.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/__pycache__/font_viewer.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/__pycache__/font_viewer.cpython-312.pyc
new file mode 100644
index 0000000..c87a919
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/__pycache__/font_viewer.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/__pycache__/fonty.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/__pycache__/fonty.cpython-312.pyc
new file mode 100644
index 0000000..e2e90ab
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/__pycache__/fonty.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/__pycache__/freetype_misc.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/__pycache__/freetype_misc.cpython-312.pyc
new file mode 100644
index 0000000..4d4996d
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/__pycache__/freetype_misc.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/__pycache__/glcube.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/__pycache__/glcube.cpython-312.pyc
new file mode 100644
index 0000000..f20e077
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/__pycache__/glcube.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/__pycache__/go_over_there.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/__pycache__/go_over_there.cpython-312.pyc
new file mode 100644
index 0000000..45ade4a
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/__pycache__/go_over_there.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/__pycache__/grid.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/__pycache__/grid.cpython-312.pyc
new file mode 100644
index 0000000..79ebaf7
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/__pycache__/grid.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/__pycache__/headless_no_windows_needed.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/__pycache__/headless_no_windows_needed.cpython-312.pyc
new file mode 100644
index 0000000..47127d8
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/__pycache__/headless_no_windows_needed.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/__pycache__/joystick.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/__pycache__/joystick.cpython-312.pyc
new file mode 100644
index 0000000..4fd8f1c
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/__pycache__/joystick.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/__pycache__/liquid.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/__pycache__/liquid.cpython-312.pyc
new file mode 100644
index 0000000..8c2e900
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/__pycache__/liquid.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/__pycache__/mask.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/__pycache__/mask.cpython-312.pyc
new file mode 100644
index 0000000..79944a4
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/__pycache__/mask.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/__pycache__/midi.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/__pycache__/midi.cpython-312.pyc
new file mode 100644
index 0000000..0f8f385
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/__pycache__/midi.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/__pycache__/moveit.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/__pycache__/moveit.cpython-312.pyc
new file mode 100644
index 0000000..6881b12
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/__pycache__/moveit.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/__pycache__/music_drop_fade.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/__pycache__/music_drop_fade.cpython-312.pyc
new file mode 100644
index 0000000..7c347a0
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/__pycache__/music_drop_fade.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/__pycache__/pixelarray.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/__pycache__/pixelarray.cpython-312.pyc
new file mode 100644
index 0000000..1f40b69
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/__pycache__/pixelarray.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/__pycache__/playmus.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/__pycache__/playmus.cpython-312.pyc
new file mode 100644
index 0000000..1bebc1f
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/__pycache__/playmus.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/__pycache__/resizing_new.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/__pycache__/resizing_new.cpython-312.pyc
new file mode 100644
index 0000000..5d30a04
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/__pycache__/resizing_new.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/__pycache__/scaletest.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/__pycache__/scaletest.cpython-312.pyc
new file mode 100644
index 0000000..74c19d2
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/__pycache__/scaletest.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/__pycache__/scrap_clipboard.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/__pycache__/scrap_clipboard.cpython-312.pyc
new file mode 100644
index 0000000..f23b565
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/__pycache__/scrap_clipboard.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/__pycache__/scroll.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/__pycache__/scroll.cpython-312.pyc
new file mode 100644
index 0000000..46107cf
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/__pycache__/scroll.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/__pycache__/setmodescale.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/__pycache__/setmodescale.cpython-312.pyc
new file mode 100644
index 0000000..7f4a68d
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/__pycache__/setmodescale.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/__pycache__/sound.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/__pycache__/sound.cpython-312.pyc
new file mode 100644
index 0000000..24e73f6
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/__pycache__/sound.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/__pycache__/sound_array_demos.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/__pycache__/sound_array_demos.cpython-312.pyc
new file mode 100644
index 0000000..ba27b6d
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/__pycache__/sound_array_demos.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/__pycache__/sprite_texture.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/__pycache__/sprite_texture.cpython-312.pyc
new file mode 100644
index 0000000..215f203
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/__pycache__/sprite_texture.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/__pycache__/stars.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/__pycache__/stars.cpython-312.pyc
new file mode 100644
index 0000000..2a524ab
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/__pycache__/stars.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/__pycache__/testsprite.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/__pycache__/testsprite.cpython-312.pyc
new file mode 100644
index 0000000..1268e04
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/__pycache__/testsprite.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/__pycache__/textinput.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/__pycache__/textinput.cpython-312.pyc
new file mode 100644
index 0000000..478a127
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/__pycache__/textinput.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/__pycache__/vgrade.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/__pycache__/vgrade.cpython-312.pyc
new file mode 100644
index 0000000..be0a243
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/__pycache__/vgrade.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/__pycache__/video.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/__pycache__/video.cpython-312.pyc
new file mode 100644
index 0000000..345ee35
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/__pycache__/video.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/aacircle.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/aacircle.py
new file mode 100644
index 0000000..651df18
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/aacircle.py
@@ -0,0 +1,41 @@
+#!/usr/bin/env python
+
+"""Proof of concept gfxdraw example"""
+
+import pygame
+import pygame.gfxdraw
+
+
+def main():
+    pygame.init()
+    screen = pygame.display.set_mode((500, 500))
+    screen.fill((255, 0, 0))
+    s = pygame.Surface(screen.get_size(), pygame.SRCALPHA, 32)
+    pygame.draw.line(s, (0, 0, 0), (250, 250), (250 + 200, 250))
+
+    width = 1
+    for a_radius in range(width):
+        radius = 200
+        pygame.gfxdraw.aacircle(s, 250, 250, radius - a_radius, (0, 0, 0))
+
+    screen.blit(s, (0, 0))
+
+    pygame.draw.circle(screen, "green", (50, 100), 10)
+    pygame.draw.circle(screen, "black", (50, 100), 10, 1)
+
+    pygame.display.flip()
+    try:
+        while True:
+            event = pygame.event.wait()
+            if event.type == 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__":
+    main()
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/aliens.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/aliens.py
new file mode 100644
index 0000000..224c749
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/aliens.py
@@ -0,0 +1,395 @@
+#!/usr/bin/env python
+""" pygame.examples.aliens
+
+Shows a mini game where you have to defend against aliens.
+
+What does it show you about pygame?
+
+* pg.sprite, the difference between Sprite and Group.
+* dirty rectangle optimization for processing for speed.
+* 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 pg.time.Clock
+* fullscreen switching.
+
+
+Controls
+--------
+
+* Left and right arrows to move.
+* Space bar to shoot
+* f key to toggle between fullscreen.
+
+"""
+
+import os
+import random
+from typing import List
+
+# import basic pygame modules
+import pygame as pg
+
+# see if we can load more than standard BMP
+if not pg.image.get_extended():
+    raise SystemExit("Sorry, extended image module required")
+
+
+# game constants
+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 = pg.Rect(0, 0, 640, 480)
+SCORE = 0
+
+main_dir = os.path.split(os.path.abspath(__file__))[0]
+
+
+def load_image(file):
+    """loads an image, prepares it for play"""
+    file = os.path.join(main_dir, "data", file)
+    try:
+        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 pg.mixer:
+        return None
+    file = os.path.join(main_dir, "data", file)
+    try:
+        sound = pg.mixer.Sound(file)
+        return sound
+    except pg.error:
+        print(f"Warning, unable to load, {file}")
+    return None
+
+
+# Each type of game object gets an init and an update function.
+# The update function is called once per frame, and it is when each object should
+# change its current position and state.
+#
+# The Player object actually gets a "move" function instead of update,
+# since it is passed extra information about the keyboard.
+
+
+class Player(pg.sprite.Sprite):
+    """Representing the player as a moon buggy type car."""
+
+    speed = 10
+    bounce = 24
+    gun_offset = -11
+    images: List[pg.Surface] = []
+
+    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 = 0
+        self.origtop = self.rect.top
+        self.facing = -1
+
+    def move(self, direction):
+        if direction:
+            self.facing = direction
+        self.rect.move_ip(direction * self.speed, 0)
+        self.rect = self.rect.clamp(SCREENRECT)
+        if direction < 0:
+            self.image = self.images[0]
+        elif direction > 0:
+            self.image = self.images[1]
+        self.rect.top = self.origtop - (self.rect.left // self.bounce % 2)
+
+    def gunpos(self):
+        pos = self.facing * self.gun_offset + self.rect.centerx
+        return pos, self.rect.top
+
+
+class Alien(pg.sprite.Sprite):
+    """An alien space ship. That slowly moves down the screen."""
+
+    speed = 13
+    animcycle = 12
+    images: List[pg.Surface] = []
+
+    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
+        self.frame = 0
+        if self.facing < 0:
+            self.rect.right = SCREENRECT.right
+
+    def update(self, *args, **kwargs):
+        self.rect.move_ip(self.facing, 0)
+        if not SCREENRECT.contains(self.rect):
+            self.facing = -self.facing
+            self.rect.top = self.rect.bottom + 1
+            self.rect = self.rect.clamp(SCREENRECT)
+        self.frame = self.frame + 1
+        self.image = self.images[self.frame // self.animcycle % 3]
+
+
+class Explosion(pg.sprite.Sprite):
+    """An explosion. Hopefully the Alien and not the player!"""
+
+    defaultlife = 12
+    animcycle = 3
+    images: List[pg.Surface] = []
+
+    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, *args, **kwargs):
+        """called every time around the game loop.
+
+        Show the explosion surface for 'defaultlife'.
+        Every game tick(update), we decrease the 'life'.
+
+        Also we animate the explosion.
+        """
+        self.life = self.life - 1
+        self.image = self.images[self.life // self.animcycle % 2]
+        if self.life <= 0:
+            self.kill()
+
+
+class Shot(pg.sprite.Sprite):
+    """a bullet the Player sprite fires."""
+
+    speed = -11
+    images: List[pg.Surface] = []
+
+    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, *args, **kwargs):
+        """called every time around the game loop.
+
+        Every tick we move the shot upwards.
+        """
+        self.rect.move_ip(0, self.speed)
+        if self.rect.top <= 0:
+            self.kill()
+
+
+class Bomb(pg.sprite.Sprite):
+    """A bomb the aliens drop."""
+
+    speed = 9
+    images: List[pg.Surface] = []
+
+    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, *args, **kwargs):
+        """called every time around the game loop.
+
+        Every frame we move the sprite 'rect' down.
+        When it reaches the bottom we:
+
+        - make an explosion.
+        - remove the Bomb.
+        """
+        self.rect.move_ip(0, self.speed)
+        if self.rect.bottom >= 470:
+            Explosion(self, self.explosion_group)
+            self.kill()
+
+
+class Score(pg.sprite.Sprite):
+    """to keep track of the score."""
+
+    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, *args, **kwargs):
+        """We only update the score in update() when it has changed."""
+        if SCORE != self.lastscore:
+            self.lastscore = SCORE
+            msg = f"Score: {SCORE}"
+            self.image = self.font.render(msg, 0, self.color)
+
+
+def main(winstyle=0):
+    # Initialize pygame
+    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")
+        pg.mixer = None
+
+    fullscreen = False
+    # Set the display mode
+    winstyle = 0  # |FULLSCREEN
+    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, pg.transform.flip(img, 1, 0)]
+    img = load_image("explosion1.gif")
+    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 = 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 = pg.Surface(SCREENRECT.size)
+    for x in range(0, SCREENRECT.width, bgdtile.get_width()):
+        background.blit(bgdtile, (x, 0))
+    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 pg.mixer:
+        music = os.path.join(main_dir, "data", "house_lo.wav")
+        pg.mixer.music.load(music)
+        pg.mixer.music.play(-1)
+
+    # Initialize Game Groups
+    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 = pg.time.Clock()
+
+    # initialize our starting sprites
+    global 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():
+        # get input
+        for event in pg.event.get():
+            if event.type == pg.QUIT:
+                return
+            if event.type == pg.KEYDOWN and event.key == pg.K_ESCAPE:
+                return
+            if event.type == pg.KEYDOWN:
+                if event.key == pg.K_f:
+                    if not fullscreen:
+                        print("Changing to FULLSCREEN")
+                        screen_backup = screen.copy()
+                        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 = pg.display.set_mode(
+                            SCREENRECT.size, winstyle, bestdepth
+                        )
+                        screen.blit(screen_backup, (0, 0))
+                    pg.display.flip()
+                    fullscreen = not fullscreen
+
+        keystate = pg.key.get_pressed()
+
+        # clear/erase the last drawn sprites
+        all.clear(screen, background)
+
+        # update all the sprites
+        all.update()
+
+        # handle player input
+        direction = keystate[pg.K_RIGHT] - keystate[pg.K_LEFT]
+        player.move(direction)
+        firing = keystate[pg.K_SPACE]
+        if not player.reloading and firing and len(shots) < MAX_SHOTS:
+            Shot(player.gunpos(), shots, all)
+            if pg.mixer and shoot_sound is not None:
+                shoot_sound.play()
+        player.reloading = firing
+
+        # Create new alien
+        if alienreload:
+            alienreload = alienreload - 1
+        elif not int(random.random() * ALIEN_ODDS):
+            Alien(aliens, all, lastalien)
+            alienreload = ALIEN_RELOAD
+
+        # Drop bombs
+        if lastalien and not int(random.random() * BOMB_ODDS):
+            Bomb(lastalien.sprite, all, bombs, all)
+
+        # Detect collisions between aliens and players.
+        for alien in pg.sprite.spritecollide(player, aliens, 1):
+            if pg.mixer and boom_sound is not None:
+                boom_sound.play()
+            Explosion(alien, all)
+            Explosion(player, all)
+            SCORE = SCORE + 1
+            player.kill()
+
+        # See if shots hit the aliens.
+        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, all)
+            SCORE = SCORE + 1
+
+        # See if alien bombs hit the player.
+        for bomb in pg.sprite.spritecollide(player, bombs, 1):
+            if pg.mixer and boom_sound is not None:
+                boom_sound.play()
+            Explosion(player, all)
+            Explosion(bomb, all)
+            player.kill()
+
+        # draw the scene
+        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 pg.mixer:
+        pg.mixer.music.fadeout(1000)
+    pg.time.wait(1000)
+
+
+# call the "main" function if running this script
+if __name__ == "__main__":
+    main()
+    pg.quit()
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/arraydemo.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/arraydemo.py
new file mode 100644
index 0000000..514722b
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/arraydemo.py
@@ -0,0 +1,120 @@
+#!/usr/bin/env python
+""" pygame.examples.arraydemo
+
+Welcome to the arraydemo!
+
+Use the numpy array package to manipulate pixels.
+
+This demo will show you a few things:
+
+* scale up, scale down, flip,
+* cross fade
+* soften
+* put stripes on it!
+
+"""
+
+import os
+
+import pygame as pg
+from pygame import surfarray
+
+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 = pg.display.set_mode(array_img.shape[:2], 0, 32)
+    surfarray.blit_array(screen, array_img)
+    pg.display.flip()
+    pg.display.set_caption(name)
+    while True:
+        e = pg.event.wait()
+        # Force application to only advance when main button is released
+        if e.type == pg.MOUSEBUTTONUP and e.button == pg.BUTTON_LEFT:
+            break
+        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()
+
+
+def main():
+    """show various surfarray effects"""
+    import numpy as np
+    from numpy import int32, uint
+
+    pg.init()
+
+    print("Using Numpy")
+    print("Press the left mouse button to advance image.")
+    print('Press the "s" key to save the current image.')
+
+    # allblack
+    allblack = np.zeros((128, 128), int32)
+    surfdemo_show(allblack, "allblack")
+
+    # striped
+    # the element type is required for np.zeros in numpy else
+    # an array of float is returned.
+    striped = np.zeros((128, 128, 3), int32)
+    striped[:] = (255, 0, 0)
+    striped[:, ::3] = (0, 255, 255)
+    surfdemo_show(striped, "striped")
+
+    # rgbarray
+    imagename = os.path.join(main_dir, "data", "arraydemo.bmp")
+    imgsurface = pg.image.load(imagename)
+    rgbarray = surfarray.array3d(imgsurface)
+    surfdemo_show(rgbarray, "rgbarray")
+
+    # flipped
+    flipped = rgbarray[:, ::-1]
+    surfdemo_show(flipped, "flipped")
+
+    # scaledown
+    scaledown = rgbarray[::2, ::2]
+    surfdemo_show(scaledown, "scaledown")
+
+    # scaleup
+    # the element type is required for np.zeros in numpy else
+    # an #array of floats is returned.
+    shape = rgbarray.shape
+    scaleup = np.zeros((shape[0] * 2, shape[1] * 2, shape[2]), int32)
+    scaleup[::2, ::2, :] = rgbarray
+    scaleup[1::2, ::2, :] = rgbarray
+    scaleup[:, 1::2] = scaleup[:, ::2]
+    surfdemo_show(scaleup, "scaleup")
+
+    # redimg
+    redimg = np.array(rgbarray)
+    redimg[:, :, 1:] = 0
+    surfdemo_show(redimg, "redimg")
+
+    # soften
+    # having factor as an array forces integer upgrade during multiplication
+    # of rgbarray, even for numpy.
+    factor = np.array((8,), int32)
+    soften = np.array(rgbarray, 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")
+
+    # crossfade (50%)
+    src = np.array(rgbarray)
+    dest = np.zeros(rgbarray.shape)  # dest is float64 by default.
+    dest[:] = 20, 50, 100
+    diff = (dest - src) * 0.50
+    xfade = src + diff.astype(uint)
+    surfdemo_show(xfade, "xfade")
+
+    # all done
+    pg.quit()
+
+
+if __name__ == "__main__":
+    main()
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/audiocapture.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/audiocapture.py
new file mode 100644
index 0000000..714a8aa
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/audiocapture.py
@@ -0,0 +1,78 @@
+#!/usr/bin/env python
+""" pygame.examples.audiocapture
+
+A pygame 2 experiment.
+
+* record sound from a microphone
+* play back the recorded sound
+"""
+import pygame as pg
+import time
+
+from pygame._sdl2 import (
+    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 = []
+
+
+def callback(audiodevice, audiomemoryview):
+    """This is called in the sound thread.
+
+    Note, that the frequency and such you request may not be what you get.
+    """
+    # print(type(audiomemoryview), len(audiomemoryview))
+    # print(audiodevice)
+    sound_chunks.append(bytes(audiomemoryview))
+
+
+def postmix_callback(postmix, audiomemoryview):
+    """This is called in the sound thread.
+
+    At the end of mixing we get this data.
+    """
+    print(type(audiomemoryview), len(audiomemoryview))
+    print(postmix)
+
+
+set_post_mix(postmix_callback)
+
+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 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/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/blend_fill.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/blend_fill.py
new file mode 100644
index 0000000..473da04
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/blend_fill.py
@@ -0,0 +1,114 @@
+#!/usr/bin/env python
+""" pygame.examples.blend_fill
+
+BLEND_ing colors in different ways with Surface.fill().
+
+Keyboard Controls:
+
+* Press R, G, B to increase the color channel values,
+* 1-9 to set the step range for the increment,
+* A - ADD, S- SUB, M- MULT, - MIN, + MAX to change the blend modes
+
+"""
+import os
+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
+
+
+def usage():
+    print("Press R, G, B to increase the color channel values,")
+    print("1-9 to set the step range for the increment,")
+    print("A - ADD, S- SUB, M- MULT, - MIN, + MAX")
+    print("  to change the blend modes")
+
+
+main_dir = os.path.split(os.path.abspath(__file__))[0]
+data_dir = os.path.join(main_dir, "data")
+
+
+def main():
+    color = [0, 0, 0]
+    changed = False
+    blendtype = 0
+    step = 5
+
+    pg.init()
+    screen = pg.display.set_mode((640, 480), 0, 32)
+    screen.fill((100, 100, 100))
+
+    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))
+
+    pg.display.flip()
+    pg.key.set_repeat(500, 30)
+    usage()
+
+    going = True
+    while going:
+        for event in pg.event.get():
+            if event.type == pg.QUIT:
+                going = False
+
+            if event.type == pg.KEYDOWN:
+                usage()
+
+                if event.key == pg.K_ESCAPE:
+                    going = False
+
+                if event.key == pg.K_r:
+                    color[0] += step
+                    if color[0] > 255:
+                        color[0] = 0
+                    changed = True
+
+                elif event.key == pg.K_g:
+                    color[1] += step
+                    if color[1] > 255:
+                        color[1] = 0
+                    changed = True
+
+                elif event.key == pg.K_b:
+                    color[2] += step
+                    if color[2] > 255:
+                        color[2] = 0
+                    changed = True
+
+                elif event.key == pg.K_a:
+                    blendtype = pg.BLEND_ADD
+                    changed = True
+                elif event.key == pg.K_s:
+                    blendtype = pg.BLEND_SUB
+                    changed = True
+                elif event.key == pg.K_m:
+                    blendtype = pg.BLEND_MULT
+                    changed = True
+                elif event.key == pg.K_PLUS:
+                    blendtype = pg.BLEND_MAX
+                    changed = True
+                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):
+                    step = int(event.unicode)
+
+            if changed:
+                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
+                pg.display.flip()
+
+    pg.quit()
+
+
+if __name__ == "__main__":
+    main()
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/blit_blends.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/blit_blends.py
new file mode 100644
index 0000000..e5f64a2
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/blit_blends.py
@@ -0,0 +1,197 @@
+#!/usr/bin/env python
+""" pygame.examples.blit_blends
+
+Blending colors in different ways with different blend modes.
+
+It also shows some tricks with the surfarray.
+Including how to do additive blending.
+
+
+Keyboard Controls
+-----------------
+
+* R, G, B - add a bit of Red, Green, or Blue.
+* A - Add blend mode
+* S - Subtractive blend mode
+* M - Multiply blend mode
+* = key BLEND_MAX blend mode.
+* - key BLEND_MIN blend mode.
+* 1, 2, 3, 4 - use different images.
+
+"""
+import os
+import pygame as pg
+import time
+
+main_dir = os.path.split(os.path.abspath(__file__))[0]
+data_dir = os.path.join(main_dir, "data")
+
+try:
+    import pygame.surfarray
+    import numpy
+except ImportError:
+    print("no surfarray for you!  install numpy")
+
+
+def main():
+    pg.init()
+    pg.mixer.quit()  # remove ALSA underflow messages for Debian squeeze
+    screen = pg.display.set_mode((640, 480))
+
+    im1 = pg.Surface(screen.get_size())
+    # im1= im1.convert()
+    im1.fill((100, 0, 0))
+
+    im2 = pg.Surface(screen.get_size())
+    im2.fill((0, 50, 0))
+    # we make a srcalpha copy of it.
+    # im3= im2.convert(SRCALPHA)
+    im3 = im2
+    im3.set_alpha(127)
+
+    images = {}
+    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[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[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))
+    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 pg.event.get():
+            if event.type == pg.QUIT:
+                going = False
+            if event.type == pg.KEYDOWN:
+                usage()
+
+            if event.type == pg.KEYDOWN and event.key == pg.K_ESCAPE:
+                going = False
+
+            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 == 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])
+                t2 = time.time()
+                print("one pixel is:%s:" % [im1.get_at((0, 0))])
+                print(f"time to do:{t2 - t1}:")
+
+            elif event.type == pg.KEYDOWN and event.key in [pg.K_t]:
+                for bkey in blits.keys():
+                    t1 = time.time()
+
+                    for x in range(300):
+                        im1.blit(img_to_blit, (0, 0), None, blits[bkey])
+
+                    t2 = time.time()
+
+                    # show which key we're doing...
+                    onedoing = blitsn[bkey]
+                    print(f"time to do :{onedoing}: is :{t2 - t1}:")
+
+            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))
+                t2 = time.time()
+                print("one pixel is:%s:" % [im1.get_at((0, 0))])
+                print(f"time to do:{t2 - t1}:")
+
+            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))
+                # im1.set_alpha(255)
+                t1 = time.time()
+
+                im1p = pygame.surfarray.pixels2d(im1)
+                im2p = pygame.surfarray.pixels2d(im2)
+                im1p += im2p
+                del im1p
+                del im2p
+                t2 = time.time()
+                print("one pixel is:%s:" % [im1.get_at((0, 0))])
+                print(f"time to do:{t2 - t1}:")
+
+            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)
+                im1p16 = im1p.astype(numpy.uint16)
+                im2p16 = im1p.astype(numpy.uint16)
+                im1p16 += im2p16
+                im1p16 = numpy.minimum(im1p16, 255)
+                pygame.surfarray.blit_array(im1, im1p16)
+
+                del im1p
+                del im2p
+                t2 = time.time()
+                print("one pixel is:%s:" % [im1.get_at((0, 0))])
+                print(f"time to do:{t2 - t1}:")
+
+            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[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 == pg.KEYDOWN and event.key == pg.K_p:
+                print("one pixel is:%s:" % [im1.get_at((0, 0))])
+
+            elif event.type == pg.KEYDOWN and event.key == pg.K_f:
+                # this additive blend without clamp two surfaces.
+
+                t1 = time.time()
+                im1.set_alpha(127)
+                im1.blit(im2, (0, 0))
+                im1.set_alpha(255)
+
+                t2 = time.time()
+                print("one pixel is:%s:" % [im1.get_at((0, 0))])
+                print(f"time to do:{t2 - t1}:")
+
+        screen.blit(im1, (0, 0))
+        pg.display.flip()
+
+    pg.quit()
+
+
+def usage():
+    print("press keys 1-5 to change image to blit.")
+    print("A - ADD, S- SUB, M- MULT, - MIN, + MAX")
+    print("T - timing test for special blend modes.")
+
+
+if __name__ == "__main__":
+    usage()
+    main()
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/camera.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/camera.py
new file mode 100644
index 0000000..cfb91d2
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/camera.py
@@ -0,0 +1,121 @@
+#!/usr/bin/env python
+""" pygame.examples.camera
+
+Basic image capturing and display using pygame.camera
+
+Keyboard controls
+-----------------
+
+- 0, start camera 0.
+- 1, start camera 1.
+- 9, start camera 9.
+- 10, start camera... wait a minute! There's not 10 key!
+"""
+import pygame as pg
+import pygame.camera
+
+
+class VideoCapturePlayer:
+    size = (640, 480)
+
+    def __init__(self, **argd):
+        self.__dict__.update(**argd)
+        super().__init__(**argd)
+
+        # create a display surface. standard pygame stuff
+        self.display = pg.display.set_mode(self.size)
+        self.init_cams(0)
+
+    def init_cams(self, which_cam_idx):
+        # gets a list of available cameras.
+        self.clist = pygame.camera.list_cameras()
+
+        # ensure a camera exists
+        if not self.clist:
+            raise ValueError("Sorry, no cameras detected.")
+
+        # check to see if the camera id exists. If not, default to the first one in the list.
+        try:
+            cam_id = self.clist[which_cam_idx]
+        except IndexError:
+            cam_id = self.clist[0]
+
+        # creates the camera of the specified size and in RGB colorspace
+        self.camera = pygame.camera.Camera(cam_id, self.size, "RGB")
+
+        # starts the camera
+        self.camera.start()
+
+        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 = 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
+
+    def get_and_flip(self):
+        # if you don't want to tie the framerate to the camera, you can check and
+        # see if the camera has an image ready.  note that while this works
+        # on most cameras, some will never return true.
+
+        self.snapshot = self.camera.get_image(self.display)
+
+        # if 0 and self.camera.query_image():
+        #     # capture an image
+
+        #     self.snapshot = self.camera.get_image(self.snapshot)
+
+        # if 0:
+        #     self.snapshot = self.camera.get_image(self.snapshot)
+        #     # self.snapshot = self.camera.get_image()
+
+        #     # blit it to the display surface.  simple!
+        #     self.display.blit(self.snapshot, (0, 0))
+        # else:
+
+        #     self.snapshot = self.camera.get_image(self.display)
+        #     # self.display.blit(self.snapshot, (0,0))
+
+        pg.display.flip()
+
+    def main(self):
+        # get the camera list. If there are no cameras, raise a value error.
+        clist = pygame.camera.list_cameras()
+        if not clist:
+            raise ValueError("Sorry, no cameras detected.")
+        # get the first camera, as this is the default. We want the display to contain the name of the camera.
+        camera = clist[0]
+
+        # create a list of options for the user to easily understand.
+        print(
+            "\nPress the associated number for the desired camera to see that display!"
+        )
+        print("(Selecting a camera that does not exist will default to camera 0)")
+        for index, cam in enumerate(clist):
+            print(f"[{index}]: {cam}")
+
+        going = True
+        while going:
+            events = pg.event.get()
+            for e in events:
+                if e.type == pg.QUIT or (e.type == pg.KEYDOWN and e.key == pg.K_ESCAPE):
+                    going = False
+                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()
+            pygame.display.set_caption(f"{camera} ({self.clock.get_fps():.2f} FPS)")
+
+
+def main():
+    pg.init()
+    pygame.camera.init()
+    VideoCapturePlayer().main()
+    pg.quit()
+
+
+if __name__ == "__main__":
+    main()
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/chimp.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/chimp.py
new file mode 100644
index 0000000..b3373ec
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/chimp.py
@@ -0,0 +1,203 @@
+#!/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 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")
+
+
+# functions to create our resources
+def load_image(name, colorkey=None, scale=1):
+    fullname = os.path.join(data_dir, name)
+    image = pg.image.load(fullname)
+    image = image.convert()
+
+    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, pg.RLEACCEL)
+    return image, image.get_rect()
+
+
+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
+
+
+# classes for our game objects
+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.png", -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
+
+
+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 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
+        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
+
+
+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
+    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 = pg.Surface(screen.get_size())
+    background = background.convert()
+    background.fill((170, 238, 187))
+
+    # Put Text On The Background, Centered
+    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))
+    pg.display.flip()
+
+    # Prepare Game Objects
+    whiff_sound = load_sound("whiff.wav")
+    punch_sound = load_sound("punch.wav")
+    chimp = Chimp()
+    fist = Fist()
+    allsprites = pg.sprite.RenderPlain((chimp, fist))
+    clock = pg.time.Clock()
+
+    # Main Loop
+    going = True
+    while going:
+        clock.tick(60)
+
+        # Handle Input Events
+        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()
+
+        allsprites.update()
+
+        # Draw Everything
+        screen.blit(background, (0, 0))
+        allsprites.draw(screen)
+        pg.display.flip()
+
+    pg.quit()
+
+
+# Game Over
+
+
+# this calls the 'main' function when this script is executed
+if __name__ == "__main__":
+    main()
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/cursors.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/cursors.py
new file mode 100644
index 0000000..f9448bd
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/cursors.py
@@ -0,0 +1,259 @@
+#!/usr/bin/env python
+""" pygame.examples.cursors
+Click a button and the cursor will change.
+This example will show you:
+*The different types of cursors that exist
+*How to create a cursor
+*How to set a cursor
+*How to make a simple button
+"""
+
+import pygame as pg
+import os
+
+
+# Create a system cursor
+
+system_cursor1 = pg.SYSTEM_CURSOR_CROSSHAIR
+system_cursor2 = pg.SYSTEM_CURSOR_HAND
+system_cursor3 = pg.SYSTEM_CURSOR_IBEAM
+
+
+# Create a color cursor
+
+surf = pg.Surface((40, 40))
+surf.fill((120, 50, 50))
+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.png")
+image = pg.image.load(image_name)
+image_cursor = pg.cursors.Cursor(
+    (image.get_width() // 2, image.get_height() // 2), image
+)
+
+
+# Create a bitmap cursor from simple strings
+
+# sized 24x24
+thickarrow_strings = (
+    "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               ",
+    "                        ",
+    "                        ",
+    "                        ",
+)
+
+bitmap_cursor1 = pg.cursors.Cursor(
+    (24, 24),
+    (0, 0),
+    *pg.cursors.compile(thickarrow_strings, black="X", white=".", xor="o"),
+)
+
+
+# Create a bitmap cursor from premade simple strings
+
+bitmap_cursor2 = pg.cursors.diamond
+
+
+# Calculate if mouse position is inside circle
+def check_circle(mouse_pos_x, mouse_pos_y, center_x, center_y, radius):
+    return (mouse_pos_x - center_x) ** 2 + (mouse_pos_y - center_y) ** 2 < radius**2
+
+
+def main():
+    pg.init()
+    pg.display.set_caption("Cursors Example")
+
+    pg.font.init()
+    font = pg.font.Font(None, 30)
+    font1 = pg.font.Font(None, 24)
+
+    bg = pg.display.set_mode((500, 400))
+    bg.fill((183, 201, 226))
+
+    # Initialize circles
+    radius1 = 40
+    radius2 = 40
+    radius3 = 40
+    radius4 = 40
+    radius5 = 40
+    radius6 = 40
+    radius7 = 40
+
+    pos_x1 = 82
+    pos_x2 = 138
+    pos_x3 = 194
+    pos_x4 = 250
+    pos_x5 = 306
+    pos_x6 = 362
+    pos_x7 = 418
+
+    pos_y1 = 140
+    pos_y2 = 220
+    pos_y3 = 140
+    pos_y4 = 220
+    pos_y5 = 140
+    pos_y6 = 220
+    pos_y7 = 140
+
+    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 = pg.draw.rect(
+        bg,
+        (180, 180, 180),
+        (139, 300, button_text.get_width() + 5, button_text.get_height() + 50),
+    )
+    button_text_rect = button_text.get_rect(center=button.center)
+    bg.blit(button_text, button_text_rect)
+
+    pg.display.update()
+
+    cursors = [
+        system_cursor1,
+        color_cursor,
+        system_cursor2,
+        image_cursor,
+        system_cursor3,
+        bitmap_cursor1,
+        bitmap_cursor2,
+    ]
+
+    index = 0
+    pg.mouse.set_cursor(cursors[index])
+
+    pressed = False
+    clock = pg.time.Clock()
+
+    while True:
+        clock.tick(50)
+
+        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 = pg.draw.circle(bg, (255, 0, 0), (pos_x1, pos_y1), radius1)
+        else:
+            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 = pg.draw.circle(bg, (255, 127, 0), (pos_x2, pos_y2), radius2)
+        else:
+            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 = pg.draw.circle(bg, (255, 255, 0), (pos_x3, pos_y3), radius3)
+        else:
+            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 = pg.draw.circle(bg, (0, 255, 0), (pos_x4, pos_y4), radius4)
+        else:
+            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 = pg.draw.circle(bg, (0, 0, 255), (pos_x5, pos_y5), radius5)
+        else:
+            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 = pg.draw.circle(bg, (75, 0, 130), (pos_x6, pos_y6), radius6)
+        else:
+            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 = pg.draw.circle(bg, (148, 0, 211), (pos_x7, pos_y7), radius7)
+        else:
+            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 {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 = pg.draw.rect(
+            bg,
+            (100, 149, 240),
+            (139, 300, button_text.get_width() + 5, button_text.get_height() + 50),
+        )
+        bg.blit(button_text, button_text_rect)
+
+        # Check if button was clicked and change cursor
+        if button.collidepoint(mouse_x, mouse_y):
+            button = pg.draw.rect(
+                bg,
+                (60, 100, 255),
+                (
+                    139,
+                    300,
+                    button_text.get_width() + 5,
+                    button_text.get_height() + 50,
+                ),
+            )
+            bg.blit(button_text, button_text_rect)
+
+            if pg.mouse.get_pressed()[0] == 1 and pressed is False:
+                button = pg.draw.rect(
+                    bg,
+                    (0, 0, 139),
+                    (
+                        139,
+                        300,
+                        button_text.get_width() + 5,
+                        button_text.get_height() + 50,
+                    ),
+                )
+                bg.blit(button_text, button_text_rect)
+                index += 1
+                index %= len(cursors)
+                pg.mouse.set_cursor(cursors[index])
+                pg.display.update()
+                pg.time.delay(40)
+
+        if pg.mouse.get_pressed()[0] == 1:
+            pressed = True
+        elif pg.mouse.get_pressed()[0] == 0:
+            pressed = False
+
+        for event in pg.event.get():
+            if event.type == pg.QUIT:
+                pg.quit()
+                raise SystemExit
+
+        pg.display.update()
+
+
+if __name__ == "__main__":
+    main()
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/BGR.png b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/BGR.png
new file mode 100644
index 0000000..f5dba74
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/BGR.png differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/alien1.gif b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/alien1.gif
new file mode 100644
index 0000000..c4497e0
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/alien1.gif differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/alien1.jpg b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/alien1.jpg
new file mode 100644
index 0000000..6d110a4
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/alien1.jpg differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/alien1.png b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/alien1.png
new file mode 100644
index 0000000..471d6a4
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/alien1.png differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/alien2.gif b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/alien2.gif
new file mode 100644
index 0000000..8df05a3
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/alien2.gif differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/alien2.png b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/alien2.png
new file mode 100644
index 0000000..aef5ace
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/alien2.png differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/alien3.gif b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/alien3.gif
new file mode 100644
index 0000000..5305d41
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/alien3.gif differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/alien3.png b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/alien3.png
new file mode 100644
index 0000000..90d0f7c
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/alien3.png differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/arraydemo.bmp b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/arraydemo.bmp
new file mode 100644
index 0000000..ad96338
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/arraydemo.bmp differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/asprite.bmp b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/asprite.bmp
new file mode 100644
index 0000000..cc96356
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/asprite.bmp differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/background.gif b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/background.gif
new file mode 100644
index 0000000..5041ce6
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/background.gif differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/black.ppm b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/black.ppm
new file mode 100644
index 0000000..698a52c
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/black.ppm
@@ -0,0 +1,3076 @@
+P3
+# Created by GIMP version 2.10.20 PNM plug-in
+32 32
+255
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/blue.gif b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/blue.gif
new file mode 100644
index 0000000..98c6fd6
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/blue.gif differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/blue.mpg b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/blue.mpg
new file mode 100644
index 0000000..60dceca
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/blue.mpg differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/bomb.gif b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/bomb.gif
new file mode 100644
index 0000000..f885cbb
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/bomb.gif differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/boom.wav b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/boom.wav
new file mode 100644
index 0000000..f19126a
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/boom.wav differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/brick.png b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/brick.png
new file mode 100644
index 0000000..cfe37a3
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/brick.png differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/car_door.wav b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/car_door.wav
new file mode 100644
index 0000000..60acf9e
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/car_door.wav differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/chimp.png b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/chimp.png
new file mode 100644
index 0000000..9bf37b1
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/chimp.png differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/city.png b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/city.png
new file mode 100644
index 0000000..202da5c
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/city.png differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/crimson.pnm b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/crimson.pnm
new file mode 100644
index 0000000..28501e9
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/crimson.pnm
@@ -0,0 +1,5 @@
+P6
+# CREATOR: GIMP PNM Filter Version 1.1
+32 32
+255
+<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<
\ No newline at end of file
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/cursor.png b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/cursor.png
new file mode 100644
index 0000000..9e2690d
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/cursor.png differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/danger.gif b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/danger.gif
new file mode 100644
index 0000000..106d69c
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/danger.gif differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/explosion1.gif b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/explosion1.gif
new file mode 100644
index 0000000..fabec16
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/explosion1.gif differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/fist.png b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/fist.png
new file mode 100644
index 0000000..9097629
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/fist.png differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/green.pcx b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/green.pcx
new file mode 100644
index 0000000..c0aea8d
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/green.pcx differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/grey.pgm b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/grey.pgm
new file mode 100644
index 0000000..b181a5d
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/grey.pgm
@@ -0,0 +1,1028 @@
+P2
+# Created by GIMP version 2.10.20 PNM plug-in
+32 32
+255
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
+120
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/house_lo.mp3 b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/house_lo.mp3
new file mode 100644
index 0000000..4c26994
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/house_lo.mp3 differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/house_lo.ogg b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/house_lo.ogg
new file mode 100644
index 0000000..e050848
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/house_lo.ogg differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/house_lo.wav b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/house_lo.wav
new file mode 100644
index 0000000..68a96b8
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/house_lo.wav differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/laplacian.png b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/laplacian.png
new file mode 100644
index 0000000..8d064f5
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/laplacian.png differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/liquid.bmp b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/liquid.bmp
new file mode 100644
index 0000000..c4f12eb
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/liquid.bmp differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/midikeys.png b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/midikeys.png
new file mode 100644
index 0000000..74ecb86
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/midikeys.png differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/player1.gif b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/player1.gif
new file mode 100644
index 0000000..6c4eda7
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/player1.gif differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/punch.wav b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/punch.wav
new file mode 100644
index 0000000..aa3f56c
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/punch.wav differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/purple.xpm b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/purple.xpm
new file mode 100644
index 0000000..7798cc1
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/purple.xpm
@@ -0,0 +1,36 @@
+/* XPM */
+static char * C:\Users\Kristof\Documents\purple_xpm[] = {
+"32 32 1 1",
+" 	c #FF00FF",
+"                                ",
+"                                ",
+"                                ",
+"                                ",
+"                                ",
+"                                ",
+"                                ",
+"                                ",
+"                                ",
+"                                ",
+"                                ",
+"                                ",
+"                                ",
+"                                ",
+"                                ",
+"                                ",
+"                                ",
+"                                ",
+"                                ",
+"                                ",
+"                                ",
+"                                ",
+"                                ",
+"                                ",
+"                                ",
+"                                ",
+"                                ",
+"                                ",
+"                                ",
+"                                ",
+"                                ",
+"                                "};
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/red.jpg b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/red.jpg
new file mode 100644
index 0000000..11a9aa0
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/red.jpg differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/sans.ttf b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/sans.ttf
new file mode 100644
index 0000000..09fac2f
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/sans.ttf differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/scarlet.webp b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/scarlet.webp
new file mode 100644
index 0000000..cd0a15c
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/scarlet.webp differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/secosmic_lo.wav b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/secosmic_lo.wav
new file mode 100644
index 0000000..867f802
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/secosmic_lo.wav differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/shot.gif b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/shot.gif
new file mode 100644
index 0000000..18de528
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/shot.gif differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/static.png b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/static.png
new file mode 100644
index 0000000..fb3b057
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/static.png differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/teal.svg b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/teal.svg
new file mode 100644
index 0000000..85f4149
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/teal.svg
@@ -0,0 +1,9 @@
+
+ teal
+
+ 
+  Layer 1
+  
+  
+ 
+
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/turquoise.tif b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/turquoise.tif
new file mode 100644
index 0000000..39b3620
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/turquoise.tif differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/whiff.wav b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/whiff.wav
new file mode 100644
index 0000000..3954efa
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/whiff.wav differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/yellow.tga b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/yellow.tga
new file mode 100644
index 0000000..d0124fe
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/data/yellow.tga differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/dropevent.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/dropevent.py
new file mode 100644
index 0000000..d159616
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/dropevent.py
@@ -0,0 +1,72 @@
+#!/usr/bin/env python
+""" pygame.examples.dropfile
+
+Drag and drop an image on here.
+
+Uses these events:
+
+* DROPBEGIN
+* DROPCOMPLETE
+* DROPTEXT
+* DROPFILE
+"""
+import pygame as pg
+
+
+def main():
+    pg.init()
+
+    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 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 ev.type == pg.DROPCOMPLETE:
+                print(ev)
+                print("File drop complete!")
+            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 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 = ev.file[-3:]
+                if filetype in ["png", "bmp", "jpg"]:
+                    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 and spr_file_image_rect is not None:
+            surf.blit(spr_file_image, spr_file_image_rect)
+
+        pg.display.flip()
+        clock.tick(30)
+
+    pg.quit()
+
+
+if __name__ == "__main__":
+    main()
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/eventlist.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/eventlist.py
new file mode 100644
index 0000000..3afe5bc
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/eventlist.py
@@ -0,0 +1,194 @@
+#!/usr/bin/env python
+""" pygame.examples.eventlist
+
+Learn about pygame events and input.
+
+At the top of the screen are the state of several device values,
+and a scrolling list of events are displayed on the bottom.
+
+"""
+
+usage = """
+Mouse Controls
+==============
+
+- 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.
+- If events grabbed and mouse invisible show virtual mouse coords.
+
+
+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.
+"""
+
+from typing import List
+import pygame as pg
+
+import pygame._sdl2.controller
+
+
+img_on_off: List[pg.Surface] = []
+font: pg.font.Font
+last_key = None
+
+# these are a running counter of mouse.get_rel() calls.
+virtual_x = 0
+virtual_y = 0
+
+
+def showtext(win, pos, text, color, bgcolor):
+    textimg = font.render(text, 1, color, bgcolor)
+    win.blit(textimg, pos)
+    return pos[0] + textimg.get_width() + 5, pos[1]
+
+
+def drawstatus(win):
+    global virtual_x, virtual_y
+    bgcolor = 50, 50, 50
+    win.fill(bgcolor, (0, 0, 640, 120))
+    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[pg.mouse.get_focused()], pos)
+
+    pos = showtext(
+        win, (pos[0] + 50, pos[1]), "Mouse visible", (255, 255, 255), bgcolor
+    )
+    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[pg.key.get_focused()], pos)
+
+    pos = showtext(win, (10, 60), "Mouse Position(rel)", (255, 255, 255), bgcolor)
+    rel = pg.mouse.get_rel()
+    virtual_x += rel[0]
+    virtual_y += rel[1]
+
+    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, 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[pg.event.get_grab()], pos)
+
+    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:
+        p = f"{virtual_x}, {virtual_y}"
+        showtext(win, (pos[0] + 50, pos[1]), p, bgcolor, (255, 255, 55))
+
+
+def drawhistory(win, history):
+    img = font.render("Event History Area", 1, (155, 155, 155), (0, 0, 0))
+    win.blit(img, (2, 132))
+    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):
+    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():
+    pg.init()
+    pygame._sdl2.controller.init()
+
+    print(usage)
+
+    win = pg.display.set_mode((640, 480), pg.RESIZABLE)
+    pg.display.set_caption("Mouse Focus Workout. h key for help")
+
+    global font
+    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 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(pg.joystick.get_count()):
+        if pygame._sdl2.controller.is_controller(x):
+            c = pygame._sdl2.controller.Controller(x)
+            txt = "Enabled controller: " + c.name
+        else:
+            j = pg.joystick.Joystick(x)
+            txt = "Enabled joystick: " + j.get_name()
+
+        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 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 == 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 == pg.MOUSEBUTTONDOWN and e.button == 1:
+                pg.event.set_grab(not pg.event.get_grab())
+
+            if e.type == pg.MOUSEBUTTONDOWN and e.button == 3:
+                pg.mouse.set_visible(not pg.mouse.get_visible())
+
+            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 == pg.VIDEORESIZE:
+                win = pg.display.set_mode(e.size, pg.RESIZABLE)
+
+            if e.type == pg.QUIT:
+                going = False
+
+        drawstatus(win)
+        drawhistory(win, history)
+
+        pg.display.flip()
+        pg.time.wait(10)
+
+    pg.quit()
+    raise SystemExit
+
+
+if __name__ == "__main__":
+    main()
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/font_viewer.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/font_viewer.py
new file mode 100644
index 0000000..fb7efb4
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/font_viewer.py
@@ -0,0 +1,278 @@
+#!/usr/bin/env python
+""" pygame.examples.font_viewer
+Scroll through your system fonts from a list of surfaces or one huge buffer.
+
+This example exhibits:
+* iterate over available fonts using font.get_fonts and font.SysFont()
+* click and drag using mouse input
+* scrolling with the scroll wheel
+* save a surface to disk
+* work with a very large surface
+* simple mouse and keyboard scroll speed acceleration
+
+By default this example uses the fonts returned by pygame.font.get_fonts()
+and opens them using pygame.font.SysFont().
+Alternatively, you may pass a path to the command line. The TTF files found
+in that directory will be used instead.
+
+Mouse Controls:
+* Use the mouse wheel or click and drag to scroll
+
+Keyboard Controls:
+* Press up or down to scroll
+* Press escape to exit
+"""
+import sys
+import os
+
+import pygame as pg
+
+use_big_surface = False  # draw into large buffer and save png file
+
+
+class FontViewer:
+    """
+    This example is encapsulated by the fontviewer class
+    It initializes the pygame window, handles input, and draws itself
+    to the screen.
+    """
+
+    KEY_SCROLL_SPEED = 10
+    MOUSE_SCROLL_SPEED = 50
+
+    def __init__(self):
+        pg.init()
+
+        # create a window that uses 80 percent of the screen
+        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 = pg.time.Clock()
+        self.y_offset = 0
+        self.grabbed = False
+        self.render_fonts("&N abcDEF789")
+
+        if use_big_surface or "big" in sys.argv:
+            self.render_surface()
+            self.display_surface()
+            self.save_png()
+        else:
+            self.display_fonts()
+
+    def get_font_list(self):
+        """
+        Generate a font list using font.get_fonts() for system fonts or
+        from a path from the command line.
+        """
+        path = ""
+        if len(sys.argv) > 1 and os.path.exists(sys.argv[1]):
+            path = os.path.join(sys.argv[1], "")
+        if os.path.exists(path):
+            fonts = [font for font in os.listdir(path) if font.endswith(".ttf")]
+        else:
+            fonts = pg.font.get_fonts()
+        return fonts, path
+
+    def render_fonts(self, text="A display of font &N"):
+        """
+        Build a list that includes a surface and the running total of their
+        height for each font in the font list. Store the largest width and
+        other variables for later use.
+        """
+        font_size = self.font_size
+        color = (255, 255, 255)
+        instruction_color = (255, 255, 0)
+        self.back_color = (0, 0, 0)
+
+        fonts, path = self.get_font_list()
+        font_surfaces = []
+        total_height = 0
+        max_width = 0
+
+        load_font = pg.font.Font if path else pg.font.SysFont
+
+        # display instructions at the top of the display
+        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",
+            "",
+        )
+        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):
+            try:
+                font = load_font(path + name, font_size)
+            except OSError:
+                continue
+            line = text.replace("&N", name)
+            try:
+                surf = font.render(line, 1, color, self.back_color)
+            except pg.error as e:
+                print(e)
+                break
+
+            max_width = max(max_width, surf.get_width())
+            font_surfaces.append((surf, total_height))
+            total_height += surf.get_height()
+
+        # store variables for later usage
+        self.total_height = total_height
+        self.max_width = max_width
+        self.font_surfaces = font_surfaces
+        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.
+        """
+        pg.display.set_caption("Font Viewer")
+        display = pg.display.get_surface()
+        clock = pg.time.Clock()
+        center = display.get_width() // 2
+
+        while True:
+            # draw visible surfaces
+            display.fill(self.back_color)
+            for surface, top in self.font_surfaces:
+                bottom = top + surface.get_height()
+                if (
+                    bottom >= self.y_offset
+                    and top <= self.y_offset + display.get_height()
+                ):
+                    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
+            pg.display.flip()
+            clock.tick(30)
+
+    def render_surface(self):
+        """
+        Note: this method uses twice the memory and is only called if
+        big_surface is set to true or big is added to the command line.
+
+        Optionally generates one large buffer to draw all the font surfaces
+        into. This is necessary to save the display to a png file and may
+        be useful for testing large surfaces.
+        """
+
+        large_surface = pg.surface.Surface(
+            (self.max_width, self.total_height)
+        ).convert()
+        large_surface.fill(self.back_color)
+        print("scrolling surface created")
+
+        # display the surface size and memory usage
+        byte_size = large_surface.get_bytesize()
+        total_size = byte_size * (self.max_width * self.total_height)
+        print(
+            "Surface Size = {}x{} @ {}bpp: {:,.3f}mb".format(
+                self.max_width, self.total_height, byte_size, total_size / 1000000.0
+            )
+        )
+
+        y = 0
+        center = int(self.max_width / 2)
+        for surface, top in self.font_surfaces:
+            w = surface.get_width()
+            x = center - int(w / 2)
+            large_surface.blit(surface, (x, y))
+            y += 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):
+        """
+        Display the large surface created by the render_surface method. Scrolls
+        based on the y_offset value(set in handle_events) and the height of the
+        pygame window.
+        """
+        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 = pg.rect.Rect(
+            0,
+            0,
+            self.surface.get_width(),
+            min(self.surface.get_height(), screen.get_height()),
+        )
+
+        x = int((screen.get_width() - self.surface.get_width()) / 2)
+        going = True
+        while going:
+            if not self.handle_events():
+                going = False
+            screen.fill(self.back_color)
+            rect.top = self.y_offset
+            screen.blit(self.surface, (x, 0), rect)
+            pg.display.flip()
+            self.clock.tick(20)
+
+    def save_png(self, name="font_viewer.png"):
+        pg.image.save(self.surface, name)
+        file_size = os.path.getsize(name) // 1024
+        print(f"font surface saved to {name}\nsize: {file_size:,}Kb")
+
+    def handle_events(self):
+        """
+        This method handles user input. It returns False when it receives
+        a pygame.QUIT event or the user presses escape. The y_offset is
+        changed based on mouse and keyboard input. display_fonts() and
+        display_surface() use the y_offset to scroll display.
+        """
+        events = pg.event.get()
+        for e in events:
+            if e.type == pg.QUIT:
+                return False
+            elif e.type == pg.KEYDOWN:
+                if e.key == pg.K_ESCAPE:
+                    return False
+            elif e.type == pg.MOUSEWHEEL:
+                self.y_offset += e.y * self.MOUSE_SCROLL_SPEED * -1
+            elif e.type == pg.MOUSEBUTTONDOWN:
+                # enter dragging mode on mouse down
+                self.grabbed = True
+                pg.event.set_grab(True)
+            elif e.type == pg.MOUSEBUTTONUP:
+                # exit drag mode on mouse up
+                self.grabbed = False
+                pg.event.set_grab(False)
+
+        # allow simple accelerated scrolling with the keyboard
+        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[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 = pg.mouse.get_rel()[1]
+        if y and self.grabbed:
+            self.y_offset -= y
+
+        self.y_offset = min((max(self.y_offset, 0), self.max_y))
+        return True
+
+
+viewer = FontViewer()
+pg.quit()
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/fonty.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/fonty.py
new file mode 100644
index 0000000..786f741
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/fonty.py
@@ -0,0 +1,81 @@
+#!/usr/bin/env python
+""" pygame.examples.fonty
+
+Here we load a .TTF True Type font file, and display it in
+a basic pygame window.
+
+Demonstrating several Font object attributes.
+
+- basic window, event, and font management.
+"""
+import pygame as pg
+
+
+def main():
+    # initialize
+    pg.init()
+    resolution = 400, 200
+    screen = pg.display.set_mode(resolution)
+
+    ##    pg.mouse.set_cursor(*pg.cursors.diamond)
+
+    fg = 250, 240, 230
+    bg = 5, 5, 5
+    wincolor = 40, 40, 90
+
+    # fill background
+    screen.fill(wincolor)
+
+    # load font, prepare values
+    font = pg.font.Font(None, 80)
+    text = "Fonty"
+    size = font.size(text)
+
+    # no AA, no transparency, normal
+    ren = font.render(text, 0, fg, bg)
+    screen.blit(ren, (10, 10))
+
+    # no AA, transparency, underline
+    font.set_underline(1)
+    ren = font.render(text, 0, fg)
+    screen.blit(ren, (10, 40 + size[1]))
+    font.set_underline(0)
+
+    a_sys_font = pg.font.SysFont("Arial", 60)
+
+    # AA, no transparency, bold
+    a_sys_font.set_bold(1)
+    ren = a_sys_font.render(text, 1, fg, bg)
+    screen.blit(ren, (30 + size[0], 10))
+    a_sys_font.set_bold(0)
+
+    # AA, transparency, italic
+    a_sys_font.set_italic(1)
+    ren = a_sys_font.render(text, 1, fg)
+    screen.blit(ren, (30 + size[0], 40 + size[1]))
+    a_sys_font.set_italic(0)
+
+    # Get some metrics.
+    print(f"Font metrics for 'Fonty':  {a_sys_font.metrics(text)}")
+    ch = "\u3060"
+    msg = f"Font metrics for '{ch}':  {a_sys_font.metrics(ch)}"
+    print(msg)
+
+    ## #some_japanese_unicode = u"\u304b\u3070\u306b"
+    ##some_japanese_unicode = unicode_('%c%c%c') % (0x304b, 0x3070, 0x306b)
+
+    # AA, transparency, italic
+    ##ren = a_sys_font.render(some_japanese_unicode, 1, fg)
+    ##screen.blit(ren, (30 + size[0], 40 + size[1]))
+
+    # show the surface and await user quit
+    pg.display.flip()
+    while True:
+        # use event.wait to keep from polling 100% cpu
+        if pg.event.wait().type in (pg.QUIT, pg.KEYDOWN, pg.MOUSEBUTTONDOWN):
+            break
+    pg.quit()
+
+
+if __name__ == "__main__":
+    main()
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/freetype_misc.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/freetype_misc.py
new file mode 100644
index 0000000..70a6090
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/freetype_misc.py
@@ -0,0 +1,157 @@
+#!/usr/bin/env python
+""" pygame.examples.freetype_misc
+
+
+Miscellaneous (or misc) means:
+  "consisting of a mixture of various things that are not
+   usually connected with each other"
+   Adjective
+
+
+All those words you read on computers, magazines, books, and such over the years?
+Probably a lot of them were constructed with...
+
+The FreeType Project:  a free, high-quality and portable Font engine.
+https://freetype.org
+
+Next time you're reading something. Think of them.
+
+
+Herein lies a *BOLD* demo consisting of a mixture of various things.
+
+        Not only is it a *BOLD* demo, it's an
+        italics demo,
+        a rotated demo,
+        it's a blend,
+        and is sized to go nicely with a cup of tea*.
+
+        * also goes well with coffee.
+
+Enjoy!
+"""
+import os
+import pygame as pg
+import pygame.freetype as freetype
+
+
+def run():
+    pg.init()
+
+    fontdir = os.path.dirname(os.path.abspath(__file__))
+    font = freetype.Font(os.path.join(fontdir, "data", "sans.ttf"))
+
+    screen = pg.display.set_mode((800, 600))
+    screen.fill("gray")
+
+    font.underline_adjustment = 0.5
+    font.pad = True
+    font.render_to(
+        screen,
+        (32, 32),
+        "Hello World",
+        "red3",
+        "dimgray",
+        size=64,
+        style=freetype.STYLE_UNDERLINE | freetype.STYLE_OBLIQUE,
+    )
+    font.pad = False
+
+    font.render_to(
+        screen,
+        (32, 128),
+        "abcdefghijklm",
+        "dimgray",
+        "green3",
+        size=64,
+    )
+
+    font.vertical = True
+    font.render_to(screen, (32, 200), "Vertical?", "blue3", None, size=32)
+    font.vertical = False
+
+    font.render_to(screen, (64, 190), "Let's spin!", "red3", None, size=48, rotation=55)
+
+    font.render_to(
+        screen, (160, 290), "All around!", "green3", None, size=48, rotation=-55
+    )
+
+    font.render_to(screen, (250, 220), "and BLEND", (255, 0, 0, 128), None, size=64)
+
+    font.render_to(screen, (265, 237), "or BLAND!", (0, 0xCC, 28, 128), None, size=64)
+
+    # Some pinwheels
+    font.origin = True
+    for angle in range(0, 360, 45):
+        font.render_to(screen, (150, 420), ")", "black", size=48, rotation=angle)
+    font.vertical = True
+    for angle in range(15, 375, 30):
+        font.render_to(screen, (600, 400), "|^*", "orange", size=48, rotation=angle)
+    font.vertical = False
+    font.origin = False
+
+    utext = "I \u2665 Unicode"
+    font.render_to(screen, (298, 320), utext, (0, 0xCC, 0xDD), None, size=64)
+
+    utext = "\u2665"
+    font.render_to(screen, (480, 32), utext, "gray", "red3", size=148)
+
+    font.render_to(
+        screen,
+        (380, 380),
+        "...yes, this is an SDL surface",
+        "black",
+        None,
+        size=24,
+        style=freetype.STYLE_STRONG,
+    )
+
+    font.origin = True
+    r = font.render_to(
+        screen,
+        (100, 530),
+        "stretch",
+        "red3",
+        None,
+        size=(24, 24),
+        style=freetype.STYLE_NORMAL,
+    )
+    font.render_to(
+        screen,
+        (100 + r.width, 530),
+        " VERTICAL",
+        "red3",
+        None,
+        size=(24, 48),
+        style=freetype.STYLE_NORMAL,
+    )
+
+    r = font.render_to(
+        screen,
+        (100, 580),
+        "stretch",
+        "blue3",
+        None,
+        size=(24, 24),
+        style=freetype.STYLE_NORMAL,
+    )
+    font.render_to(
+        screen,
+        (100 + r.width, 580),
+        " HORIZONTAL",
+        "blue3",
+        None,
+        size=(48, 24),
+        style=freetype.STYLE_NORMAL,
+    )
+
+    pg.display.flip()
+
+    while True:
+        if pg.event.wait().type in (pg.QUIT, pg.KEYDOWN, pg.MOUSEBUTTONDOWN):
+            break
+
+    pg.quit()
+
+
+if __name__ == "__main__":
+    run()
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/glcube.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/glcube.py
new file mode 100644
index 0000000..9d85c24
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/glcube.py
@@ -0,0 +1,591 @@
+#!/usr/bin/env python
+""" pygame.examples.glcube
+
+Draw a cube on the screen.
+
+
+
+Amazing.
+
+Every frame we orbit the camera around a small amount
+creating the illusion of a spinning object.
+
+First we setup some points of a multicolored cube. Then we then go through
+a semi-unoptimized loop to draw the cube points onto the screen.
+
+OpenGL does all the hard work for us. :]
+
+
+Keyboard Controls
+-----------------
+
+* ESCAPE key to quit
+* f key to toggle fullscreen.
+
+"""
+import math
+import ctypes
+
+import pygame as pg
+
+try:
+    import OpenGL.GL as GL
+    import OpenGL.GLU as GLU
+except ImportError:
+    print("pyopengl missing. The GLCUBE example requires: pyopengl numpy")
+    raise SystemExit
+
+try:
+    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
+
+# Some simple data for a colored cube here we have the 3D point position
+# and color for each corner. A list of indices describes each face, and a
+# list of indices describes each edge.
+
+CUBE_POINTS = (
+    (0.5, -0.5, -0.5),
+    (0.5, 0.5, -0.5),
+    (-0.5, 0.5, -0.5),
+    (-0.5, -0.5, -0.5),
+    (0.5, -0.5, 0.5),
+    (0.5, 0.5, 0.5),
+    (-0.5, -0.5, 0.5),
+    (-0.5, 0.5, 0.5),
+)
+
+# colors are 0-1 floating values
+CUBE_COLORS = (
+    (1, 0, 0),
+    (1, 1, 0),
+    (0, 1, 0),
+    (0, 0, 0),
+    (1, 0, 1),
+    (1, 1, 1),
+    (0, 0, 1),
+    (0, 1, 1),
+)
+
+CUBE_QUAD_VERTS = (
+    (0, 1, 2, 3),
+    (3, 2, 7, 6),
+    (6, 7, 5, 4),
+    (4, 5, 1, 0),
+    (1, 5, 7, 2),
+    (4, 0, 3, 6),
+)
+
+CUBE_EDGES = (
+    (0, 1),
+    (0, 3),
+    (0, 4),
+    (2, 1),
+    (2, 3),
+    (2, 7),
+    (6, 3),
+    (6, 4),
+    (6, 7),
+    (5, 1),
+    (5, 4),
+    (5, 7),
+)
+
+
+def translate(matrix, x=0.0, y=0.0, z=0.0):
+    """
+    Translate (move) a matrix in the x, y and z axes.
+
+    :param matrix: Matrix to translate.
+    :param x: direction and magnitude to translate in x axis. Defaults to 0.
+    :param y: direction and magnitude to translate in y axis. Defaults to 0.
+    :param z: direction and magnitude to translate in z axis. Defaults to 0.
+    :return: The translated matrix.
+    """
+    translation_matrix = array(
+        [
+            [1.0, 0.0, 0.0, x],
+            [0.0, 1.0, 0.0, y],
+            [0.0, 0.0, 1.0, z],
+            [0.0, 0.0, 0.0, 1.0],
+        ],
+        dtype=matrix.dtype,
+    ).T
+    matrix[...] = dot(matrix, translation_matrix)
+    return matrix
+
+
+def frustum(left, right, bottom, top, znear, zfar):
+    """
+    Build a perspective matrix from the clipping planes, or camera 'frustrum'
+    volume.
+
+    :param left: left position of the near clipping plane.
+    :param right: right position of the near clipping plane.
+    :param bottom: bottom position of the near clipping plane.
+    :param top: top position of the near clipping plane.
+    :param znear: z depth of the near clipping plane.
+    :param zfar: z depth of the far clipping plane.
+
+    :return: A perspective matrix.
+    """
+    perspective_matrix = zeros((4, 4), dtype=float32)
+    perspective_matrix[0, 0] = +2.0 * znear / (right - left)
+    perspective_matrix[2, 0] = (right + left) / (right - left)
+    perspective_matrix[1, 1] = +2.0 * znear / (top - bottom)
+    perspective_matrix[3, 1] = (top + bottom) / (top - bottom)
+    perspective_matrix[2, 2] = -(zfar + znear) / (zfar - znear)
+    perspective_matrix[3, 2] = -2.0 * znear * zfar / (zfar - znear)
+    perspective_matrix[2, 3] = -1.0
+    return perspective_matrix
+
+
+def perspective(fovy, aspect, znear, zfar):
+    """
+    Build a perspective matrix from field of view, aspect ratio and depth
+    planes.
+
+    :param fovy: the field of view angle in the y axis.
+    :param aspect: aspect ratio of our view port.
+    :param znear: z depth of the near clipping plane.
+    :param zfar: z depth of the far clipping plane.
+
+    :return: A perspective matrix.
+    """
+    h = math.tan(fovy / 360.0 * math.pi) * znear
+    w = h * aspect
+    return frustum(-w, w, -h, h, znear, zfar)
+
+
+def rotate(matrix, angle, x, y, z):
+    """
+    Rotate a matrix around an axis.
+
+    :param matrix: The matrix to rotate.
+    :param angle: The angle to rotate by.
+    :param x: x of axis to rotate around.
+    :param y: y of axis to rotate around.
+    :param z: z of axis to rotate around.
+
+    :return: The rotated matrix
+    """
+    angle = math.pi * angle / 180
+    c, s = math.cos(angle), math.sin(angle)
+    n = math.sqrt(x * x + y * y + z * z)
+    x, y, z = x / n, y / n, z / n
+    cx, cy, cz = (1 - c) * x, (1 - c) * y, (1 - c) * z
+    rotation_matrix = array(
+        [
+            [cx * x + c, cy * x - z * s, cz * x + y * s, 0],
+            [cx * y + z * s, cy * y + c, cz * y - x * s, 0],
+            [cx * z - y * s, cy * z + x * s, cz * z + c, 0],
+            [0, 0, 0, 1],
+        ],
+        dtype=matrix.dtype,
+    ).T
+    matrix[...] = dot(matrix, rotation_matrix)
+    return matrix
+
+
+class Rotation:
+    """
+    Data class that stores rotation angles in three axes.
+    """
+
+    def __init__(self):
+        self.theta = 20
+        self.phi = 40
+        self.psi = 25
+
+
+def drawcube_old():
+    """
+    Draw the cube using the old open GL methods pre 3.2 core context.
+    """
+    allpoints = list(zip(CUBE_POINTS, CUBE_COLORS))
+
+    GL.glBegin(GL.GL_QUADS)
+    for face in CUBE_QUAD_VERTS:
+        for vert in face:
+            pos, color = allpoints[vert]
+            GL.glColor3fv(color)
+            GL.glVertex3fv(pos)
+    GL.glEnd()
+
+    GL.glColor3f(1.0, 1.0, 1.0)
+    GL.glBegin(GL.GL_LINES)
+    for line in CUBE_EDGES:
+        for vert in line:
+            pos, color = allpoints[vert]
+            GL.glVertex3fv(pos)
+
+    GL.glEnd()
+
+
+def init_gl_stuff_old():
+    """
+    Initialise open GL, prior to core context 3.2
+    """
+    GL.glEnable(GL.GL_DEPTH_TEST)  # use our zbuffer
+
+    # setup the camera
+    GL.glMatrixMode(GL.GL_PROJECTION)
+    GL.glLoadIdentity()
+    GLU.gluPerspective(45.0, 640 / 480.0, 0.1, 100.0)  # setup lens
+    GL.glTranslatef(0.0, 0.0, -3.0)  # move back
+    GL.glRotatef(25, 1, 0, 0)  # orbit higher
+
+
+def init_gl_modern(display_size):
+    """
+    Initialise open GL in the 'modern' open GL style for open GL versions
+    greater than 3.1.
+
+    :param display_size: Size of the window/viewport.
+    """
+
+    # Create shaders
+    # --------------------------------------
+    vertex_code = """
+
+    #version 150
+    uniform mat4   model;
+    uniform mat4   view;
+    uniform mat4   projection;
+
+    uniform vec4   colour_mul;
+    uniform vec4   colour_add;
+
+    in vec4 vertex_colour;         // vertex colour in
+    in vec3 vertex_position;
+
+    out vec4   vertex_color_out;            // vertex colour out
+    void main()
+    {
+        vertex_color_out = (colour_mul * vertex_colour) + colour_add;
+        gl_Position = projection * view * model * vec4(vertex_position, 1.0);
+    }
+
+    """
+
+    fragment_code = """
+    #version 150
+    in vec4 vertex_color_out;  // vertex colour from vertex shader
+    out vec4 fragColor;
+    void main()
+    {
+        fragColor = vertex_color_out;
+    }
+    """
+
+    program = GL.glCreateProgram()
+    vertex = GL.glCreateShader(GL.GL_VERTEX_SHADER)
+    fragment = GL.glCreateShader(GL.GL_FRAGMENT_SHADER)
+    GL.glShaderSource(vertex, vertex_code)
+    GL.glCompileShader(vertex)
+
+    # this logs issues the shader compiler finds.
+    log = GL.glGetShaderInfoLog(vertex)
+    if isinstance(log, bytes):
+        log = log.decode()
+    for line in log.split("\n"):
+        print(line)
+
+    GL.glAttachShader(program, vertex)
+    GL.glShaderSource(fragment, fragment_code)
+    GL.glCompileShader(fragment)
+
+    # this logs issues the shader compiler finds.
+    log = GL.glGetShaderInfoLog(fragment)
+    if isinstance(log, bytes):
+        log = log.decode()
+    for line in log.split("\n"):
+        print(line)
+
+    GL.glAttachShader(program, fragment)
+    GL.glValidateProgram(program)
+    GL.glLinkProgram(program)
+
+    GL.glDetachShader(program, vertex)
+    GL.glDetachShader(program, fragment)
+    GL.glUseProgram(program)
+
+    # Create vertex buffers and shader constants
+    # ------------------------------------------
+
+    # Cube Data
+    vertices = zeros(
+        8, [("vertex_position", float32, 3), ("vertex_colour", float32, 4)]
+    )
+
+    vertices["vertex_position"] = [
+        [1, 1, 1],
+        [-1, 1, 1],
+        [-1, -1, 1],
+        [1, -1, 1],
+        [1, -1, -1],
+        [1, 1, -1],
+        [-1, 1, -1],
+        [-1, -1, -1],
+    ]
+
+    vertices["vertex_colour"] = [
+        [0, 1, 1, 1],
+        [0, 0, 1, 1],
+        [0, 0, 0, 1],
+        [0, 1, 0, 1],
+        [1, 1, 0, 1],
+        [1, 1, 1, 1],
+        [1, 0, 1, 1],
+        [1, 0, 0, 1],
+    ]
+
+    filled_cube_indices = array(
+        [
+            0,
+            1,
+            2,
+            0,
+            2,
+            3,
+            0,
+            3,
+            4,
+            0,
+            4,
+            5,
+            0,
+            5,
+            6,
+            0,
+            6,
+            1,
+            1,
+            6,
+            7,
+            1,
+            7,
+            2,
+            7,
+            4,
+            3,
+            7,
+            3,
+            2,
+            4,
+            7,
+            6,
+            4,
+            6,
+            5,
+        ],
+        dtype=uint32,
+    )
+
+    outline_cube_indices = array(
+        [0, 1, 1, 2, 2, 3, 3, 0, 4, 7, 7, 6, 6, 5, 5, 4, 0, 5, 1, 6, 2, 7, 3, 4],
+        dtype=uint32,
+    )
+
+    shader_data = {"buffer": {}, "constants": {}}
+
+    GL.glBindVertexArray(GL.glGenVertexArrays(1))  # Have to do this first
+
+    shader_data["buffer"]["vertices"] = GL.glGenBuffers(1)
+    GL.glBindBuffer(GL.GL_ARRAY_BUFFER, shader_data["buffer"]["vertices"])
+    GL.glBufferData(GL.GL_ARRAY_BUFFER, vertices.nbytes, vertices, GL.GL_DYNAMIC_DRAW)
+
+    stride = vertices.strides[0]
+    offset = ctypes.c_void_p(0)
+
+    loc = GL.glGetAttribLocation(program, "vertex_position")
+    GL.glEnableVertexAttribArray(loc)
+    GL.glVertexAttribPointer(loc, 3, GL.GL_FLOAT, False, stride, offset)
+
+    offset = ctypes.c_void_p(vertices.dtype["vertex_position"].itemsize)
+
+    loc = GL.glGetAttribLocation(program, "vertex_colour")
+    GL.glEnableVertexAttribArray(loc)
+    GL.glVertexAttribPointer(loc, 4, GL.GL_FLOAT, False, stride, offset)
+
+    shader_data["buffer"]["filled"] = GL.glGenBuffers(1)
+    GL.glBindBuffer(GL.GL_ELEMENT_ARRAY_BUFFER, shader_data["buffer"]["filled"])
+    GL.glBufferData(
+        GL.GL_ELEMENT_ARRAY_BUFFER,
+        filled_cube_indices.nbytes,
+        filled_cube_indices,
+        GL.GL_STATIC_DRAW,
+    )
+
+    shader_data["buffer"]["outline"] = GL.glGenBuffers(1)
+    GL.glBindBuffer(GL.GL_ELEMENT_ARRAY_BUFFER, shader_data["buffer"]["outline"])
+    GL.glBufferData(
+        GL.GL_ELEMENT_ARRAY_BUFFER,
+        outline_cube_indices.nbytes,
+        outline_cube_indices,
+        GL.GL_STATIC_DRAW,
+    )
+
+    shader_data["constants"]["model"] = GL.glGetUniformLocation(program, "model")
+    GL.glUniformMatrix4fv(shader_data["constants"]["model"], 1, False, eye(4))
+
+    shader_data["constants"]["view"] = GL.glGetUniformLocation(program, "view")
+    view = translate(eye(4), z=-6)
+    GL.glUniformMatrix4fv(shader_data["constants"]["view"], 1, False, view)
+
+    shader_data["constants"]["projection"] = GL.glGetUniformLocation(
+        program, "projection"
+    )
+    GL.glUniformMatrix4fv(shader_data["constants"]["projection"], 1, False, eye(4))
+
+    # This colour is multiplied with the base vertex colour in producing
+    # the final output
+    shader_data["constants"]["colour_mul"] = GL.glGetUniformLocation(
+        program, "colour_mul"
+    )
+    GL.glUniform4f(shader_data["constants"]["colour_mul"], 1, 1, 1, 1)
+
+    # This colour is added on to the base vertex colour in producing
+    # the final output
+    shader_data["constants"]["colour_add"] = GL.glGetUniformLocation(
+        program, "colour_add"
+    )
+    GL.glUniform4f(shader_data["constants"]["colour_add"], 0, 0, 0, 0)
+
+    # Set GL drawing data
+    # -------------------
+    GL.glClearColor(0, 0, 0, 0)
+    GL.glPolygonOffset(1, 1)
+    GL.glEnable(GL.GL_LINE_SMOOTH)
+    GL.glBlendFunc(GL.GL_SRC_ALPHA, GL.GL_ONE_MINUS_SRC_ALPHA)
+    GL.glDepthFunc(GL.GL_LESS)
+    GL.glHint(GL.GL_LINE_SMOOTH_HINT, GL.GL_NICEST)
+    GL.glLineWidth(1.0)
+
+    projection = perspective(45.0, display_size[0] / float(display_size[1]), 2.0, 100.0)
+    GL.glUniformMatrix4fv(shader_data["constants"]["projection"], 1, False, projection)
+
+    return shader_data, filled_cube_indices, outline_cube_indices
+
+
+def draw_cube_modern(shader_data, filled_cube_indices, outline_cube_indices, rotation):
+    """
+    Draw a cube in the 'modern' Open GL style, for post 3.1 versions of
+    open GL.
+
+    :param shader_data: compile vertex & pixel shader data for drawing a cube.
+    :param filled_cube_indices: the indices to draw the 'filled' cube.
+    :param outline_cube_indices: the indices to draw the 'outline' cube.
+    :param rotation: the current rotations to apply.
+    """
+
+    GL.glClear(GL.GL_COLOR_BUFFER_BIT | GL.GL_DEPTH_BUFFER_BIT)
+
+    # Filled cube
+    GL.glDisable(GL.GL_BLEND)
+    GL.glEnable(GL.GL_DEPTH_TEST)
+    GL.glEnable(GL.GL_POLYGON_OFFSET_FILL)
+    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
+    )
+
+    # Outlined cube
+    GL.glDisable(GL.GL_POLYGON_OFFSET_FILL)
+    GL.glEnable(GL.GL_BLEND)
+    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.psi += 1.0  # degrees
+    model = eye(4, dtype=float32)
+    # rotate(model, rotation.theta, 0, 0, 1)
+    rotate(model, rotation.phi, 0, 1, 0)
+    rotate(model, rotation.psi, 1, 0, 0)
+    GL.glUniformMatrix4fv(shader_data["constants"]["model"], 1, False, model)
+
+
+def main():
+    """run the demo"""
+
+    # initialize pygame and setup an opengl display
+    pg.init()
+
+    gl_version = (3, 0)  # GL Version number (Major, Minor)
+    if USE_MODERN_GL:
+        gl_version = (3, 2)  # GL Version number (Major, Minor)
+
+        # By setting these attributes we can choose which Open GL Profile
+        # to use, profiles greater than 3.2 use a different rendering path
+        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
+        )
+
+    fullscreen = False  # start in windowed mode
+
+    display_size = (640, 480)
+    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)
+        rotation = Rotation()
+    else:
+        init_gl_stuff_old()
+
+    going = True
+    while going:
+        # check for quit'n events
+        events = pg.event.get()
+        for event in events:
+            if event.type == pg.QUIT or (
+                event.type == pg.KEYDOWN and event.key == pg.K_ESCAPE
+            ):
+                going = False
+
+            elif event.type == pg.KEYDOWN and event.key == pg.K_f:
+                if not fullscreen:
+                    print("Changing to FULLSCREEN")
+                    pg.display.set_mode(
+                        (640, 480), pg.OPENGL | pg.DOUBLEBUF | pg.FULLSCREEN
+                    )
+                else:
+                    print("Changing to windowed mode")
+                    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()
+
+        if USE_MODERN_GL:
+            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)
+            # orbit camera around by 1 degree
+            GL.glRotatef(1, 0, 1, 0)
+            drawcube_old()
+
+        pg.display.flip()
+        pg.time.wait(10)
+
+    pg.quit()
+
+
+if __name__ == "__main__":
+    main()
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/go_over_there.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/go_over_there.py
new file mode 100644
index 0000000..ebf45a8
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/go_over_there.py
@@ -0,0 +1,89 @@
+""" 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.
+
+Mouse Controls:
+* Use the mouse to click on a new target position
+
+Keyboard Controls:
+* Press R to restart the demo
+"""
+
+import pygame as pg
+import random
+
+MIN_SPEED = 0.25
+MAX_SPEED = 5
+MAX_BALLS = 1600
+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 = []
+
+
+class Ball:
+    def __init__(self, position, speed):
+        self.position = position
+        self.speed = speed
+
+
+def reset():
+    global balls
+    global target_position
+
+    target_position = None
+    balls = []
+    for x in range(MAX_BALLS):
+        pos = pg.Vector2(
+            random.randint(0, int(SCREEN_SIZE.x)), random.randint(0, int(SCREEN_SIZE.y))
+        )
+        speed = random.uniform(MIN_SPEED, MAX_SPEED)
+
+        b = Ball(pos, speed)
+        balls.append(b)
+
+
+reset()
+delta_time = 0
+running = True
+while running:
+    for event in pg.event.get():
+        if event.type == pg.QUIT:
+            running = False
+
+        if event.type == pg.MOUSEBUTTONUP:
+            target_position = pg.mouse.get_pos()
+
+        if event.type == pg.KEYUP:
+            if event.key == pg.K_ESCAPE:
+                running = False
+
+            if event.key == pg.K_r:
+                reset()
+
+    screen.fill((31, 143, 65))
+
+    for o in balls:
+        if target_position is not None:
+            try:
+                o.position.move_towards_ip(target_position, o.speed * delta_time)
+            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)
+
+    pg.display.flip()
+    delta_time = clock.tick(60)
+    pg.display.set_caption(
+        f"fps: {round(clock.get_fps(), 2)}, ball count: {len(balls)}"
+    )
+
+pg.quit()
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/grid.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/grid.py
new file mode 100644
index 0000000..61dcbde
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/grid.py
@@ -0,0 +1,64 @@
+import pygame as pg
+
+TITLE = "Grid"
+TILES_HORIZONTAL = 10
+TILES_VERTICAL = 10
+TILE_SIZE = 80
+WINDOW_WIDTH = 800
+WINDOW_HEIGHT = 800
+
+
+class Player:
+    def __init__(self, surface):
+        self.surface = surface
+        self.pos = (40, 40)
+
+    def draw(self):
+        pg.draw.circle(self.surface, (255, 255, 255), self.pos, 40)
+
+    def move(self, target):
+        x = (80 * (target[0] // 80)) + 40
+        y = (80 * (target[1] // 80)) + 40
+
+        self.pos = (x, y)
+
+
+class Game:
+    def __init__(self):
+        pg.init()
+        self.clock = pg.time.Clock()
+        pg.display.set_caption(TITLE)
+        self.surface = pg.display.set_mode((WINDOW_WIDTH, WINDOW_HEIGHT))
+        self.loop = True
+        self.player = Player(self.surface)
+
+    def main(self):
+        while self.loop:
+            self.grid_loop()
+        pg.quit()
+
+    def grid_loop(self):
+        self.surface.fill((0, 0, 0))
+        for row in range(TILES_HORIZONTAL):
+            for col in range(row % 2, TILES_HORIZONTAL, 2):
+                pg.draw.rect(
+                    self.surface,
+                    (40, 40, 40),
+                    (row * TILE_SIZE, col * TILE_SIZE, TILE_SIZE, TILE_SIZE),
+                )
+        self.player.draw()
+        for event in pg.event.get():
+            if event.type == pg.QUIT:
+                self.loop = False
+            elif event.type == pg.KEYDOWN:
+                if event.key == pg.K_ESCAPE:
+                    self.loop = False
+            elif event.type == pg.MOUSEBUTTONUP:
+                pos = pg.mouse.get_pos()
+                self.player.move(pos)
+        pg.display.update()
+
+
+if __name__ == "__main__":
+    mygame = Game()
+    mygame.main()
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/headless_no_windows_needed.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/headless_no_windows_needed.py
new file mode 100644
index 0000000..1b5a943
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/headless_no_windows_needed.py
@@ -0,0 +1,50 @@
+#!/usr/bin/env python
+""" pygame.examples.headless_no_windows_needed
+
+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
+
+"""
+
+import os
+import sys
+
+# set SDL to use the dummy NULL video driver,
+#   so it doesn't need a windowing system.
+os.environ["SDL_VIDEODRIVER"] = "dummy"
+
+import pygame as pg
+
+# 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 = 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):
+    """smoothscale image file named fin as fout with new size (w,h)"""
+    scaleit(fin, fout, w, h)
+
+
+if __name__ == "__main__":
+    if "-scale" in sys.argv:
+        fin, fout, w, h = sys.argv[2:]
+        w, h = map(int, [w, h])
+        main(fin, fout, w, h)
+    else:
+        print(usage)
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/joystick.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/joystick.py
new file mode 100644
index 0000000..3635195
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/joystick.py
@@ -0,0 +1,151 @@
+import pygame
+
+pygame.init()
+
+
+# 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 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.time.Clock()
+
+    # Get ready to print.
+    text_print = TextPrint()
+
+    # 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 = {}
+
+    done = False
+    while not done:
+        # Event processing step.
+        # Possible joystick events: JOYAXISMOTION, JOYBALLMOTION, JOYBUTTONDOWN,
+        # JOYBUTTONUP, JOYHATMOTION, JOYDEVICEADDED, JOYDEVICEREMOVED
+        for event in pygame.event.get():
+            if event.type == pygame.QUIT:
+                done = True  # Flag that we are done so we exit this loop.
+
+            if event.type == pygame.JOYBUTTONDOWN:
+                print("Joystick button pressed.")
+                if event.button == 0:
+                    joystick = joysticks[event.instance_id]
+                    if joystick.rumble(0, 0.7, 500):
+                        print(f"Rumble effect played on joystick {event.instance_id}")
+
+            if event.type == pygame.JOYBUTTONUP:
+                print("Joystick button released.")
+
+            # Handle hotplugging
+            if event.type == pygame.JOYDEVICEADDED:
+                # This event will be generated when the program starts for every
+                # 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()} connencted")
+
+            if event.type == pygame.JOYDEVICEREMOVED:
+                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))
+        text_print.reset()
+
+        # Get count of joysticks.
+        joystick_count = pygame.joystick.get_count()
+
+        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()
+
+            text_print.tprint(screen, f"Joystick {jid}")
+            text_print.indent()
+
+            # Get the name from the OS for the controller/joystick.
+            name = joystick.get_name()
+            text_print.tprint(screen, f"Joystick name: {name}")
+
+            guid = joystick.get_guid()
+            text_print.tprint(screen, f"GUID: {guid}")
+
+            power_level = joystick.get_power_level()
+            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()
+            text_print.tprint(screen, f"Number of axes: {axes}")
+            text_print.indent()
+
+            for i in range(axes):
+                axis = joystick.get_axis(i)
+                text_print.tprint(screen, f"Axis {i} value: {axis:>6.3f}")
+            text_print.unindent()
+
+            buttons = joystick.get_numbuttons()
+            text_print.tprint(screen, f"Number of buttons: {buttons}")
+            text_print.indent()
+
+            for i in range(buttons):
+                button = joystick.get_button(i)
+                text_print.tprint(screen, f"Button {i:>2} value: {button}")
+            text_print.unindent()
+
+            hats = joystick.get_numhats()
+            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)
+                text_print.tprint(screen, f"Hat {i} value: {str(hat)}")
+            text_print.unindent()
+
+            text_print.unindent()
+
+        # Go ahead and update the screen with what we've drawn.
+        pygame.display.flip()
+
+        # Limit to 30 frames per second.
+        clock.tick(30)
+
+
+if __name__ == "__main__":
+    main()
+    # If you forget this line, the program will 'hang'
+    # on exit if running from IDLE.
+    pygame.quit()
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/liquid.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/liquid.py
new file mode 100644
index 0000000..22431ba
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/liquid.py
@@ -0,0 +1,89 @@
+#!/usr/bin/env python
+""" pygame.examples.liquid
+
+This example demonstrates a simplish water effect of an
+image. It attempts to create a hardware display surface that
+can use pageflipping for faster updates. Note that the colormap
+from the loaded GIF image is copied to the colormap for the
+display surface.
+
+This is based on the demo named F2KWarp by Brad Graham of Freedom2000
+done in BlitzBasic. I was just translating the BlitzBasic code to
+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 time
+
+main_dir = os.path.split(os.path.abspath(__file__))[0]
+
+
+def main():
+    # initialize and setup screen
+    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.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:
+        screen.set_palette(bitmap.get_palette())
+    else:
+        bitmap = bitmap.convert()
+
+    # prep some variables
+    anim = 0.0
+
+    # mainloop
+    xblocks = range(0, 640, 20)
+    yblocks = range(0, 480, 20)
+    stopevents = pg.QUIT, pg.KEYDOWN, pg.MOUSEBUTTONDOWN
+    while True:
+        for e in pg.event.get():
+            if e.type in stopevents:
+                return
+
+        anim = anim + 0.02
+        for x in xblocks:
+            xpos = (x + (sin(anim + x * 0.01) * 15)) + 20
+            for y in yblocks:
+                ypos = (y + (sin(anim + y * 0.01) * 15)) + 20
+                screen.blit(bitmap, (x, y), (xpos, ypos, 20, 20))
+
+        pg.display.flip()
+        time.sleep(0.01)
+
+
+if __name__ == "__main__":
+    main()
+    pg.quit()
+
+
+"""BTW, here is the code from the BlitzBasic example this was derived
+from. i've snipped the sound and text stuff out.
+-----------------------------------------------------------------
+; Brad@freedom2000.com
+
+; Load a bmp pic (800x600) and slice it into 1600 squares
+Graphics 640,480
+SetBuffer BackBuffer()
+bitmap$="f2kwarp.bmp"
+pic=LoadAnimImage(bitmap$,20,15,0,1600)
+
+; use SIN to move all 1600 squares around to give liquid effect
+Repeat
+f=0:w=w+10:If w=360 Then w=0
+For y=0 To 599 Step 15
+For x = 0 To 799 Step 20
+f=f+1:If f=1600 Then f=0
+DrawBlock pic,(x+(Sin(w+x)*40))/1.7+80,(y+(Sin(w+y)*40))/1.7+60,f
+Next:Next:Flip:Cls
+Until KeyDown(1)
+"""
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/mask.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/mask.py
new file mode 100644
index 0000000..c0ec097
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/mask.py
@@ -0,0 +1,202 @@
+#!/usr/bin/env python
+"""
+pygame.examples.mask
+
+A pygame.mask collision detection production.
+
+
+
+
+Brought
+
+       to
+             you
+                     by
+
+    the
+
+pixels
+               0000000000000
+      and
+         111111
+
+
+This is 32 bits:
+    11111111111111111111111111111111
+
+There are 32 or 64 bits in a computer 'word'.
+Rather than using one word for a pixel,
+the mask module represents 32 or 64 pixels in one word.
+As you can imagine, this makes things fast, and saves memory.
+
+Compute intensive things like collision detection,
+and computer vision benefit greatly from this.
+
+
+This module can also be run as a stand-alone program, excepting
+one or more image file names as command line arguments.
+"""
+
+import os
+import random
+import sys
+
+import pygame as pg
+
+
+class Sprite:
+    """
+    Moving Sprite demonstrating pixel-perfect collisions between pg.mask.Mask objects
+    """
+
+    def __init__(self, pos, vel, surface, mask=None):
+        """
+        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 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 = pg.mask.from_surface(self.surface)
+
+        self.pos = pg.Vector2(pos)
+        self.vel = pg.Vector2(vel)
+
+    def collide(self, sprite):
+        """
+        Test if the sprites are colliding and
+        resolve the collision in this case.
+
+        Positional arguments:
+            sprite: other sprite to test for collisions
+        """
+        offset = [int(x) for x in sprite.pos - self.pos]
+        overlap = self.mask.overlap_area(sprite.mask, offset)
+        if overlap == 0:
+            return
+        # Calculate collision normal
+
+        # Number of collisions
+        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])),
+            # y axis
+            self.mask.overlap_area(sprite.mask, (offset[0], offset[1] + 1))
+            - self.mask.overlap_area(sprite.mask, (offset[0], offset[1] - 1)),
+        )
+        if n_collisions.x == 0 and n_collisions.y == 0:
+            # One sprite is inside another
+            return
+
+        delta_vel = sprite.vel - self.vel
+        j = delta_vel * n_collisions / (2 * n_collisions * n_collisions)
+        if j > 0:
+            # Can scale up to 2*j here to get bouncy collisions
+            j *= 1.9
+            self.vel += [n_collisions.x * j, n_collisions.y * j]
+            sprite.vel += [-j * n_collisions.x, -j * n_collisions.y]
+
+        # # Separate the sprites
+        # c1 = -overlap / (n_collisions * n_collisions)
+        # c2 = -c1 / 2
+        # self.pos += [c2 * n_collisions.x, c2 * n_collisions.y]
+        # sprite.pos += [(c1 + c2) * n_collisions.x, (c1 + c2) * n_collisions.y]
+
+    def update(self):
+        """
+        Move the sprite
+        """
+        self.pos += self.vel
+
+
+def main(*args):
+    """
+    Display multiple images bounce off each other using collision detection
+
+    Positional arguments:
+      one or more image file names.
+
+    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")
+    pg.init()
+
+    screen_size = (640, 480)
+    screen = pg.display.set_mode(screen_size)
+    clock = pg.time.Clock()
+
+    images = []
+    masks = []
+    for image_path in args:
+        images.append(pg.image.load(image_path).convert_alpha())
+        masks.append(pg.mask.from_surface(images[-1]))
+
+    sprites = []
+    for i in range(20):
+        j = i % len(images)
+        sprite = Sprite(
+            pos=(
+                random.uniform(0, screen_size[0]),
+                random.uniform(0, screen_size[1]),
+            ),
+            vel=(
+                random.uniform(-5, 5),
+                random.uniform(-5, 5),
+            ),
+            surface=images[j],
+            mask=masks[j],
+        )
+        sprites.append(sprite)
+
+    while True:
+        for event in pg.event.get():
+            if event.type in (pg.QUIT, pg.KEYDOWN):
+                return
+
+        screen.fill((240, 220, 100))
+
+        for sprite_index, sprite in enumerate(sprites):
+            for other_sprite in sprites[sprite_index + 1 :]:
+                sprite.collide(other_sprite)
+
+            sprite.update()
+
+            # If the sprite is outside of the screen on the left
+            if sprite.pos.x < -sprite.width:
+                sprite.pos.x = screen_size[0]
+            # right
+            elif sprite.pos.x > screen_size[0]:
+                sprite.pos.x = -sprite.width
+            # top
+            if sprite.pos.y < -sprite.height:
+                sprite.pos.y = screen_size[1]
+            # down
+            elif sprite.pos.y > screen_size[1]:
+                sprite.pos.y = -sprite.height
+
+            screen.blit(sprite.surface, sprite.pos)
+
+        clock.tick(30)
+        pg.display.flip()
+
+
+if __name__ == "__main__":
+    if len(sys.argv) < 2:
+        print("Usage: mask.py  [ ...]")
+        print("Let many copies of IMAGE(s) bounce against each other")
+        print("Press any key to quit")
+        main_dir = os.path.split(os.path.abspath(__file__))[0]
+        main(os.path.join(main_dir, "data", "alien1.png"))
+
+    else:
+        main(*sys.argv[1:])
+    pg.quit()
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/midi.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/midi.py
new file mode 100644
index 0000000..f087ae6
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/midi.py
@@ -0,0 +1,932 @@
+#!/usr/bin/env python
+""" pygame.examples.midi
+
+midi input, and a separate example of midi output.
+
+By default it runs the output example.
+
+python -m pygame.examples.midi --output
+python -m pygame.examples.midi --input
+python -m pygame.examples.midi --input
+"""
+
+from dataclasses import dataclass
+import sys
+import os
+from typing import Any, Dict, List, Literal, Optional, Set, Tuple, Union
+
+import pygame as pg
+import pygame.midi
+
+# black and white piano keys use b/w color values directly
+BACKGROUNDCOLOR = "slategray"
+
+
+def print_device_info():
+    pygame.midi.init()
+    _print_device_info()
+    pygame.midi.quit()
+
+
+def _print_device_info():
+    for i in range(pygame.midi.get_count()):
+        r = pygame.midi.get_device_info(i)
+        (interf, name, input, output, opened) = r
+
+        in_out = ""
+        if input:
+            in_out = "(input)"
+        if output:
+            in_out = "(output)"
+
+        print(
+            "%2i: interface :%s:, name :%s:, opened :%s:  %s"
+            % (i, interf, name, opened, in_out)
+        )
+
+
+def input_main(device_id=None):
+    pg.init()
+
+    pygame.midi.init()
+
+    _print_device_info()
+
+    if device_id is None:
+        input_id = pygame.midi.get_default_input_id()
+    else:
+        input_id = device_id
+
+    print(f"using input_id :{input_id}:")
+    i = pygame.midi.Input(input_id)
+
+    pg.display.set_mode((1, 1))
+
+    going = True
+    while going:
+        events = pygame.event.get()
+        for e in events:
+            if e.type in [pg.QUIT]:
+                going = False
+            if e.type in [pg.KEYDOWN]:
+                going = False
+            if e.type in [pygame.midi.MIDIIN]:
+                print(e)
+
+        if i.poll():
+            midi_events = i.read(10)
+            # convert them into pygame events.
+            midi_evs = pygame.midi.midis2events(midi_events, i.device_id)
+
+            for m_e in midi_evs:
+                pygame.event.post(m_e)
+
+    del i
+    pygame.midi.quit()
+
+
+def output_main(device_id=None):
+    """Execute a musical keyboard example for the Church Organ instrument
+
+    This is a piano keyboard example, with a two octave keyboard, starting at
+    note F3. Left mouse down over a key starts a note, left up stops it. The
+    notes are also mapped to the computer keyboard keys, assuming an American
+    English PC keyboard (sorry everyone else, but I don't know if I can map to
+    absolute key position instead of value.) The white keys are on the second
+    row, TAB to BACKSLASH, starting with note F3. The black keys map to the top
+    row, '1' to BACKSPACE, starting with F#3. 'r' is middle C. Close the
+    window or press ESCAPE to quit the program. Key velocity (note
+    amplitude) varies vertically on the keyboard image, with minimum velocity
+    at the top of a key and maximum velocity at bottom.
+
+    Default Midi output, no device_id given, is to the default output device
+    for the computer.
+
+    """
+
+    # A note to new pygamers:
+    #
+    # All the midi module stuff is in this function. It is unnecessary to
+    # understand how the keyboard display works to appreciate how midi
+    # messages are sent.
+
+    # The keyboard is drawn by a Keyboard instance. This instance maps Midi
+    # notes to musical keyboard keys. A regions surface maps window position
+    # to (Midi note, velocity) pairs. A key_mapping dictionary does the same
+    # for computer keyboard keys. Midi sound is controlled with direct method
+    # calls to a pygame.midi.Output instance.
+    #
+    # Things to consider when using pygame.midi:
+    #
+    # 1) Initialize the midi module with a to pygame.midi.init().
+    # 2) Create a midi.Output instance for the desired output device port.
+    # 3) Select instruments with set_instrument() method calls.
+    # 4) Play notes with note_on() and note_off() method calls.
+    # 5) Call pygame.midi.Quit() when finished. Though the midi module tries
+    #    to ensure that midi is properly shut down, it is best to do it
+    #    explicitly. A try/finally statement is the safest way to do this.
+    #
+
+    # GRAND_PIANO = 0
+    CHURCH_ORGAN = 19
+
+    instrument = CHURCH_ORGAN
+    # instrument = GRAND_PIANO
+    start_note = 53  # F3 (white key note), start_note != 0
+    n_notes = 24  # Two octaves (14 white keys)
+
+    key_mapping = make_key_mapping(
+        [
+            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,
+    )
+
+    pg.init()
+    pygame.midi.init()
+
+    _print_device_info()
+
+    if device_id is None:
+        port = pygame.midi.get_default_output_id()
+    else:
+        port = device_id
+
+    print(f"using output_id :{port}:")
+
+    midi_out = pygame.midi.Output(port, 0)
+    try:
+        midi_out.set_instrument(instrument)
+        keyboard = Keyboard(start_note, n_notes)
+
+        screen = pg.display.set_mode(keyboard.rect.size)
+        screen.fill(BACKGROUNDCOLOR)
+        pg.display.flip()
+
+        background = pg.Surface(screen.get_size())
+        background.fill(BACKGROUNDCOLOR)
+        dirty_rects = []
+        keyboard.draw(screen, background, dirty_rects)
+        pg.display.update(dirty_rects)
+
+        regions = pg.Surface(screen.get_size())  # initial color (0,0,0)
+        keyboard.map_regions(regions)
+
+        pg.event.set_blocked(pg.MOUSEMOTION)
+        mouse_note = 0
+        on_notes = set()
+        while True:
+            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)
+                    midi_out.note_on(mouse_note, velocity)
+                    on_notes.add(mouse_note)
+                else:
+                    mouse_note = 0
+            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 == pg.QUIT:
+                break
+            elif e.type == pg.KEYDOWN:
+                if e.key == pg.K_ESCAPE:
+                    break
+                try:
+                    note, velocity = key_mapping[e.key]
+                except KeyError:
+                    pass
+                else:
+                    if note not in on_notes:
+                        keyboard.key_down(note)
+                        midi_out.note_on(note, velocity)
+                        on_notes.add(note)
+            elif e.type == pg.KEYUP:
+                try:
+                    note, __ = key_mapping[e.key]
+                except KeyError:
+                    pass
+                else:
+                    if note in on_notes and note != mouse_note:
+                        keyboard.key_up(note)
+                        midi_out.note_off(note, 0)
+                        on_notes.remove(note)
+
+            dirty_rects = []
+            keyboard.draw(screen, background, dirty_rects)
+            pg.display.update(dirty_rects)
+    finally:
+        del midi_out
+        pygame.midi.quit()
+
+
+def make_key_mapping(keys, start_note):
+    """Return a dictionary of (note, velocity) by computer keyboard key code"""
+    mapping = {}
+    for i, key in enumerate(keys):
+        mapping[key] = (start_note + i, 127)
+    return mapping
+
+
+class NullKey:
+    """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.
+
+    """
+
+    def _right_white_down(self):
+        pass
+
+    def _right_white_up(self):
+        pass
+
+    def _right_black_down(self):
+        pass
+
+    def _right_black_up(self):
+        pass
+
+
+null_key = NullKey()
+
+
+@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:
+    updates - a set into which a key instance adds itself if it needs
+        redrawing.
+    image_strip - The surface containing the images of all key states.
+    image_rects - A list of Rects giving the regions within image_strip that
+        are relevant to this key class.
+    is_white_key (default True) - Set false if this is a black key.
+
+    This function automates the creation of a key widget class for the
+    three basic key types. A key has two basic states, up or down (
+    depressed). Corresponding up and down images are drawn for each
+    of these two states. But to give the illusion of depth, a key
+    may have shadows cast upon it by the adjacent keys to its right.
+    These shadows change depending on the up/down state of the key and
+    its neighbors. So a key may support multiple images and states
+    depending on the shadows. A key type is determined by the length
+    of image_rects and the value of is_white.
+
+    """
+
+    # Naming convention: Variables used by the Key class as part of a
+    # closure start with 'c_'.
+
+    # State logic and shadows:
+    #
+    # A key may cast a shadow upon the key to its left. A black key casts a
+    # shadow on an adjacent white key. The shadow changes depending of whether
+    # the black or white key is depressed. A white key casts a shadow on the
+    # white key to its left if it is up and the left key is down. Therefore
+    # a keys state, and image it will draw, is determined entirely by its
+    # itself and the key immediately adjacent to it on the right. A white key
+    # is always assumed to have an adjacent white key.
+    #
+    # There can be up to eight key states, representing all permutations
+    # of the three fundamental states of self up/down, adjacent white
+    # right up/down, adjacent black up/down.
+    #
+    down_state_none = 0
+    down_state_self = 1
+    down_state_white = down_state_self << 1
+    down_state_self_white = down_state_self | down_state_white
+    down_state_black = down_state_white << 1
+    down_state_self_black = down_state_self | down_state_black
+    down_state_white_black = down_state_white | down_state_black
+    down_state_all = down_state_self | down_state_white_black
+
+    # Some values used in the class.
+    #
+    c_down_state_initial = down_state_none
+    c_down_state_rect_initial = image_rects[0]
+    c_updates = updates
+    c_image_strip = image_strip
+    c_width, c_height = image_rects[0].size
+
+    # A key propagates its up/down state change to the adjacent white key on
+    # the left by calling the adjacent key's _right_black_down or
+    # _right_white_down method.
+    #
+    if is_white_key:
+        key_color = "white"
+    else:
+        key_color = "black"
+    c_notify_down_method = f"_right_{key_color}_down"
+    c_notify_up_method = f"_right_{key_color}_up"
+
+    # Images:
+    #
+    # A black key only needs two images, for the up and down states. Its
+    # appearance is unaffected by the adjacent keys to its right, which cast no
+    # shadows upon it.
+    #
+    # A white key with a no adjacent black to its right only needs three
+    # images, for self up, self down, and both self and adjacent white down.
+    #
+    # A white key with both a black and white key to its right needs six
+    # images: self up, self up and adjacent black down, self down, self and
+    # adjacent white down, self and adjacent black down, and all three down.
+    #
+    # Each 'c_event' dictionary maps the current key state to a new key state,
+    # 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: 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),
+    }
+    c_event_right_white_up = c_event_right_white_down.copy()
+    c_event_right_black_down = c_event_right_white_down.copy()
+    c_event_right_black_up = c_event_right_white_down.copy()
+    if len(image_rects) > 2:
+        c_event_down[down_state_white] = (down_state_self_white, image_rects[2])
+        c_event_up[down_state_self_white] = (down_state_white, image_rects[0])
+        c_event_right_white_down[down_state_none] = (down_state_white, None)
+        c_event_right_white_down[down_state_self] = (
+            down_state_self_white,
+            image_rects[2],
+        )
+        c_event_right_white_up[down_state_white] = (down_state_none, None)
+        c_event_right_white_up[down_state_self_white] = (
+            down_state_self,
+            image_rects[1],
+        )
+        c_event_right_black_down[down_state_white] = (down_state_white, None)
+        c_event_right_black_down[down_state_self_white] = (down_state_self_white, None)
+        c_event_right_black_up[down_state_white] = (down_state_white, None)
+        c_event_right_black_up[down_state_self_white] = (down_state_self_white, None)
+    if len(image_rects) > 3:
+        c_event_down[down_state_black] = (down_state_self_black, image_rects[4])
+        c_event_down[down_state_white_black] = (down_state_all, image_rects[5])
+        c_event_up[down_state_self_black] = (down_state_black, image_rects[3])
+        c_event_up[down_state_all] = (down_state_white_black, image_rects[3])
+        c_event_right_white_down[down_state_black] = (down_state_white_black, None)
+        c_event_right_white_down[down_state_self_black] = (
+            down_state_all,
+            image_rects[5],
+        )
+        c_event_right_white_up[down_state_white_black] = (down_state_black, None)
+        c_event_right_white_up[down_state_all] = (down_state_self_black, image_rects[4])
+        c_event_right_black_down[down_state_none] = (down_state_black, image_rects[3])
+        c_event_right_black_down[down_state_self] = (
+            down_state_self_black,
+            image_rects[4],
+        )
+        c_event_right_black_down[down_state_white] = (
+            down_state_white_black,
+            image_rects[3],
+        )
+        c_event_right_black_down[down_state_self_white] = (
+            down_state_all,
+            image_rects[5],
+        )
+        c_event_right_black_up[down_state_black] = (down_state_none, image_rects[0])
+        c_event_right_black_up[down_state_self_black] = (
+            down_state_self,
+            image_rects[1],
+        )
+        c_event_right_black_up[down_state_white_black] = (
+            down_state_white,
+            image_rects[0],
+        )
+        c_event_right_black_up[down_state_all] = (down_state_self_white, image_rects[2])
+
+    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,
+        )
+
+    return OurKey
+
+
+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 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
+    white keys are determined by the proximity of the black keys. The plain
+    white key has no black key adjacent to it. A white-left and white-right
+    key has a black key to the left or right of it respectively. A white-center
+    key has a black key on both sides. A key may have up to six related
+    images depending on the state of adjacent keys to its right.
+
+    """
+
+    my_dir = os.path.split(os.path.abspath(__file__))[0]
+    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 = pg.image.load(strip_file)
+    names = [
+        "black none",
+        "black self",
+        "white none",
+        "white self",
+        "white self-white",
+        "white-left none",
+        "white-left self",
+        "white-left black",
+        "white-left self-black",
+        "white-left self-white",
+        "white-left all",
+        "white-center none",
+        "white-center self",
+        "white-center black",
+        "white-center self-black",
+        "white-center self-white",
+        "white-center all",
+        "white-right none",
+        "white-right self",
+        "white-right self-white",
+    ]
+    rects = {}
+    for i in range(2):
+        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]] = pg.Rect(
+            i * white_key_width, 0, white_key_width, white_key_height
+        )
+    return strip, rects
+
+
+class Keyboard:
+    """Musical keyboard widget
+
+    Constructor arguments:
+    start_note: midi note value of the starting note on the keyboard.
+    n_notes: number of notes (keys) on the keyboard.
+
+    A Keyboard instance draws the musical keyboard and maintains the state of
+    all the keyboard keys. Individual keys can be in a down (depressed) or
+    up (released) state.
+
+    """
+
+    _image_strip, _rects = key_images()
+
+    white_key_width, white_key_height = _rects["white none"].size
+    black_key_width, black_key_height = _rects["black none"].size
+
+    _updates: Set[Any] = set()
+
+    # There are five key classes, representing key shape:
+    # black key (BlackKey), plain white key (WhiteKey), white key to the left
+    # of a black key (WhiteKeyLeft), white key between two black keys
+    # (WhiteKeyCenter), and white key to the right of a black key
+    # (WhiteKeyRight).
+    BlackKey = key_class(
+        _updates, _image_strip, [_rects["black none"], _rects["black self"]], False
+    )
+    WhiteKey = key_class(
+        _updates,
+        _image_strip,
+        [_rects["white none"], _rects["white self"], _rects["white self-white"]],
+    )
+    WhiteKeyLeft = key_class(
+        _updates,
+        _image_strip,
+        [
+            _rects["white-left none"],
+            _rects["white-left self"],
+            _rects["white-left self-white"],
+            _rects["white-left black"],
+            _rects["white-left self-black"],
+            _rects["white-left all"],
+        ],
+    )
+    WhiteKeyCenter = key_class(
+        _updates,
+        _image_strip,
+        [
+            _rects["white-center none"],
+            _rects["white-center self"],
+            _rects["white-center self-white"],
+            _rects["white-center black"],
+            _rects["white-center self-black"],
+            _rects["white-center all"],
+        ],
+    )
+    WhiteKeyRight = key_class(
+        _updates,
+        _image_strip,
+        [
+            _rects["white-right none"],
+            _rects["white-right self"],
+            _rects["white-right self-white"],
+        ],
+    )
+
+    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) -> None:
+        """Populate the keyboard with key instances
+
+        Set the _keys and rect attributes.
+
+        """
+
+        # Keys are entered in a list, where index is Midi note. Since there are
+        # only 128 possible Midi notes the list length is manageable. Unassigned
+        # note positions should never be accessed, so are set None to ensure
+        # the bug is quickly detected.
+        #
+        key_map: list[Key | Literal[None]] = [None] * 128
+
+        start_note = self._start_note
+        end_note = self._end_note
+        black_offset = self.black_key_width // 2
+        prev_white_key = None
+        x = y = 0
+        if is_white_key(start_note):
+            is_prev_white = True
+        else:
+            x += black_offset
+            is_prev_white = False
+        for note in range(start_note, end_note + 1):
+            ident = note  # For now notes uniquely identify keyboard keys.
+            if is_white_key(note):
+                if is_prev_white:
+                    if note == end_note or is_white_key(note + 1):
+                        key = self.WhiteKey(ident, (x, y), prev_white_key)
+                    else:
+                        key = self.WhiteKeyLeft(ident, (x, y), prev_white_key)
+                else:
+                    if note == end_note or is_white_key(note + 1):
+                        key = self.WhiteKeyRight(ident, (x, y), prev_white_key)
+                    else:
+                        key = self.WhiteKeyCenter(ident, (x, y), prev_white_key)
+                is_prev_white = True
+                x += self.white_key_width
+                prev_white_key = key
+            else:
+                key = self.BlackKey(ident, (x - black_offset, y), prev_white_key)
+                is_prev_white = False
+            key_map[note] = key
+        self._keys = key_map
+
+        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 = pg.Rect(0, 0, kb_width, kb_height)
+
+    def map_regions(self, regions):
+        """Draw the key regions onto surface regions.
+
+        Regions must have at least 3 byte pixels. Each pixel of the keyboard
+        rectangle is set to the color (note, velocity, 0). The regions surface
+        must be at least as large as (0, 0, self.rect.left, self.rect.bottom)
+
+        """
+
+        # First draw the white key regions. Then add the overlapping
+        # black key regions.
+        #
+        cutoff = self.black_key_height
+        black_keys = []
+        for note in range(self._start_note, self._end_note + 1):
+            key = self._keys[note]
+            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:
+            if key is not None:
+                fill_region(regions, note, key.rect, cutoff)
+
+    def draw(self, surf, background, dirty_rects):
+        """Redraw all altered keyboard keys"""
+
+        changed_keys = self._updates
+        while changed_keys:
+            changed_keys.pop().draw(surf, background, dirty_rects)
+
+    def key_down(self, note):
+        """Signal a key down event for note"""
+        key = self._keys[note]
+        if key is not None:
+            key.down()
+
+    def key_up(self, note):
+        """Signal a key up event for note"""
+        key = self._keys[note]
+        if key is not None:
+            key.up()
+
+
+def fill_region(regions, note, rect, cutoff):
+    """Fill the region defined by rect with a (note, velocity, 0) color
+
+    The velocity varies from a small value at the top of the region to
+    127 at the bottom. The vertical region 0 to cutoff is split into
+    three parts, with velocities 42, 84 and 127. Everything below cutoff
+    has velocity 127.
+
+    """
+
+    x, y, width, height = rect
+    if cutoff is None:
+        cutoff = height
+    delta_height = cutoff // 3
+    regions.fill((note, 42, 0), (x, y, width, delta_height))
+    regions.fill((note, 84, 0), (x, y + delta_height, width, delta_height))
+    regions.fill(
+        (note, 127, 0), (x, y + 2 * delta_height, width, height - 2 * delta_height)
+    )
+
+
+def is_white_key(note):
+    """True if note is represented by a white key"""
+
+    key_pattern = [
+        True,
+        False,
+        True,
+        True,
+        False,
+        True,
+        False,
+        True,
+        True,
+        False,
+        True,
+        False,
+    ]
+    return key_pattern[(note - 21) % len(key_pattern)]
+
+
+def usage():
+    print("--input [device_id] : Midi message logger")
+    print("--output [device_id] : Midi piano keyboard")
+    print("--list : list available midi devices")
+
+
+def main(mode="output", device_id=None):
+    """Run a Midi example
+
+    Arguments:
+    mode - if 'output' run a midi keyboard output example
+              'input' run a midi event logger input example
+              'list' list available midi devices
+           (default 'output')
+    device_id - midi device number; if None then use the default midi input or
+                output device for the system
+
+    """
+
+    if mode == "input":
+        input_main(device_id)
+    elif mode == "output":
+        output_main(device_id)
+    elif mode == "list":
+        print_device_info()
+    else:
+        raise ValueError(f"Unknown mode option '{mode}'")
+
+
+if __name__ == "__main__":
+    device_id: Optional[int] = None
+    try:
+        device_id = int(sys.argv[-1])
+    except ValueError:
+        device_id = None
+
+    if "--input" in sys.argv or "-i" in sys.argv:
+        input_main(device_id)
+
+    elif "--output" in sys.argv or "-o" in sys.argv:
+        output_main(device_id)
+    elif "--list" in sys.argv or "-l" in sys.argv:
+        print_device_info()
+    else:
+        usage()
+
+    pg.quit()
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/moveit.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/moveit.py
new file mode 100644
index 0000000..ffcc7f9
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/moveit.py
@@ -0,0 +1,119 @@
+#!/usr/bin/env python
+""" 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
+them on the screen.
+
+It also has a separate player character that can be controlled with arrow keys.
+
+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 as pg
+
+main_dir = os.path.split(os.path.abspath(__file__))[0]
+
+# Height and Width of screen
+WIDTH = 640
+HEIGHT = 480
+# Height and width of the sprite
+SPRITE_WIDTH = 80
+SPRITE_HEIGHT = 60
+
+
+# our game object class
+class GameObject:
+    def __init__(self, image, height, speed):
+        self.speed = speed
+        self.image = image
+        self.pos = image.get_rect().move(0, height)
+
+    # move the object.
+    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
+
+        # controls the object such that it cannot leave the screen's viewpoint
+        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
+
+
+# quick function to load an image
+def load_image(name):
+    path = os.path.join(main_dir, "data", name)
+    return pg.image.load(path).convert()
+
+
+# here's the full code
+def main():
+    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.bmp")
+
+    # scale the background image so that it fills the window and
+    # successfully overwrites the old sprite position.
+    background = pg.transform.scale2x(background)
+    background = pg.transform.scale2x(background)
+
+    screen.blit(background, (0, 0))
+
+    objects = []
+    p = GameObject(player, 10, 3)
+    for x in range(10):
+        o = GameObject(entity, x * 40, x)
+        objects.append(o)
+
+    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 = pg.key.get_pressed()
+        if keys[pg.K_UP]:
+            p.move(up=True)
+        if keys[pg.K_DOWN]:
+            p.move(down=True)
+        if keys[pg.K_LEFT]:
+            p.move(left=True)
+        if keys[pg.K_RIGHT]:
+            p.move(right=True)
+
+        # Draw the background
+        screen.blit(background, (0, 0))
+        for e in pg.event.get():
+            # quit upon screen exit
+            if e.type == pg.QUIT:
+                return
+        for o in objects:
+            screen.blit(background, o.pos, o.pos)
+        for o in objects:
+            o.move(right=True)
+            screen.blit(o.image, o.pos)
+        screen.blit(p.image, p.pos)
+        clock.tick(60)
+        pg.display.update()
+        pg.time.delay(100)
+
+
+if __name__ == "__main__":
+    main()
+    pg.quit()
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/music_drop_fade.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/music_drop_fade.py
new file mode 100644
index 0000000..8988cd3
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/music_drop_fade.py
@@ -0,0 +1,253 @@
+#!/usr/bin/env python
+""" 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
+Music files passed from the commandline are played
+Music files and filenames are played when drag and dropped onto the pygame window
+Polls the clipboard and plays music files if it finds one there
+
+Keyboard Controls:
+* Press space or enter to pause music playback
+* Press up or down to change the music volume
+* Press left or right to seek 5 seconds into the track
+* Press escape to quit
+* Press any other button to skip to the next music file in the list
+"""
+
+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?
+
+
+def add_file(filename):
+    """
+    This function will check if filename exists and is a music file
+    If it is the file will be added to a list of music files(even if already there)
+    Type checking is by the extension of the file, not by its contents
+    We can only discover if the file is valid when we mixer.music.load() it later
+
+    It looks in the file directory and its data subdirectory
+    """
+    if filename.rpartition(".")[2].lower() not in music_file_types:
+        print(f"{filename} not added to file list")
+        print("only these files types are allowed: ", music_file_types)
+        return False
+    elif os.path.exists(filename):
+        music_file_list.append(filename)
+    elif os.path.exists(os.path.join(main_dir, filename)):
+        music_file_list.append(os.path.join(main_dir, filename))
+    elif os.path.exists(os.path.join(data_dir, filename)):
+        music_file_list.append(os.path.join(data_dir, filename))
+    else:
+        print("file not found")
+        return False
+    print(f"{filename} added to file list")
+    return True
+
+
+def play_file(filename):
+    """
+    This function will call add_file and play it if successful
+    The music will fade in during the first 4 seconds
+    set_endevent is used to post a MUSIC_DONE event when the song finishes
+    The main loop will call play_next() when the MUSIC_DONE event is received
+    """
+    global starting_pos
+
+    if add_file(filename):
+        try:  # we must do this in case the file is not a valid audio file
+            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
+        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")
+            starting_pos = 0
+        else:
+            print("file does not support seeking")
+            starting_pos = -1
+        pg.mixer.music.set_endevent(MUSIC_DONE)
+
+
+def play_next():
+    """
+    This function will play the next song in music_file_list
+    It uses pop(0) to get the next song and then appends it to the end of the list
+    The song will fade in during the first 4 seconds
+    """
+
+    global starting_pos
+    if len(music_file_list) > 1:
+        nxt = music_file_list.pop(0)
+
+        try:
+            pg.mixer.music.load(nxt)
+        except pg.error as e:
+            print(e)
+            print(f"{nxt} removed from file list")
+
+        music_file_list.append(nxt)
+        print("starting next song: ", nxt)
+    else:
+        nxt = music_file_list[0]
+    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
+    else:
+        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.
+    This only works with OGG and MP3 files.
+    music.get_pos() returns how many milliseconds the song has played, not
+    the current position in the file. We must track the starting position
+    ourselves. music.set_pos() will set the position in seconds.
+    """
+    global starting_pos
+
+    if starting_pos >= 0:  # will be -1 unless play_file() was OGG or MP3
+        played_for = pg.mixer.music.get_pos() / 1000.0
+        old_pos = starting_pos + played_for
+        starting_pos = old_pos + amount
+        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
+    running = True
+    paused = False
+
+    # we will be polling for key up and key down events
+    # users should be able to change the volume by holding the up and down arrows
+    # the change_volume variable will be set by key down events and cleared by key up events
+    change_volume = 0
+
+    pg.init()
+    pg.display.set_mode((640, 480))
+    font = pg.font.SysFont("Arial", 24)
+    clock = pg.time.Clock()
+
+    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:]:
+        add_file(arg)
+    play_file("house_lo.ogg")  # play default music included with pygame
+
+    # draw instructions on screen
+    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)
+
+    """
+    This is the main loop
+    It will respond to drag and drop, clipboard changes, and key presses
+    """
+    while running:
+        for ev in pg.event.get():
+            if ev.type == pg.QUIT:
+                running = False
+            elif ev.type == pg.DROPTEXT:
+                play_file(ev.text)
+            elif ev.type == pg.DROPFILE:
+                play_file(ev.file)
+            elif ev.type == MUSIC_DONE:
+                play_next()
+            elif ev.type == pg.KEYDOWN:
+                if ev.key == pg.K_ESCAPE:
+                    running = False  # exit loop
+                elif ev.key in (pg.K_SPACE, pg.K_RETURN):
+                    if paused:
+                        pg.mixer.music.unpause()
+                        paused = False
+                    else:
+                        pg.mixer.music.pause()
+                        paused = True
+                elif ev.key == pg.K_UP:
+                    change_volume = VOLUME_CHANGE_AMOUNT
+                elif ev.key == pg.K_DOWN:
+                    change_volume = -VOLUME_CHANGE_AMOUNT
+                elif ev.key == pg.K_RIGHT:
+                    change_music_position(+5)
+                elif ev.key == pg.K_LEFT:
+                    change_music_position(-5)
+
+                else:
+                    play_next()
+
+            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
+            pg.mixer.music.set_volume(volume)
+            print("volume:", volume)
+
+        # 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")
+
+        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
+
+    pg.quit()
+
+
+if __name__ == "__main__":
+    main()
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/pixelarray.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/pixelarray.py
new file mode 100644
index 0000000..6f5d58d
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/pixelarray.py
@@ -0,0 +1,142 @@
+#!/usr/bin/env python
+""" pygame.examples.pixelarray
+
+PixelArray does array processing of pixels.
+Sort of like another array processor called 'numpy' - But for pixels.
+
+    Flip it,
+            stripe it,
+                      rotate it.
+
+Controls
+--------
+
+To see different effects - press a key or click a mouse.
+"""
+import os
+import pygame as pg
+
+
+main_dir = os.path.split(os.path.abspath(__file__))[0]
+data_dir = os.path.join(main_dir, "data")
+
+
+def show(image):
+    screen = pg.display.get_surface()
+    screen.fill((255, 255, 255))
+    screen.blit(image, (0, 0))
+    pg.display.flip()
+    while True:
+        event = pg.event.wait()
+        if event.type == pg.QUIT:
+            pg.quit()
+            raise SystemExit
+        if event.type in [pg.MOUSEBUTTONDOWN, pg.KEYDOWN]:
+            break
+
+
+def main():
+    pg.init()
+
+    pg.display.set_mode((255, 255))
+    surface = pg.Surface((255, 255))
+
+    pg.display.flip()
+
+    # Create the PixelArray.
+    ar = pg.PixelArray(surface)
+
+    # Do some easy gradient effect.
+    for y in range(255):
+        r, g, b = y, y, y
+        ar[:, y] = (r, g, b)
+    del ar
+    show(surface)
+
+    # We have made some gradient effect, now flip it.
+    ar = pg.PixelArray(surface)
+    ar[:] = ar[:, ::-1]
+    del ar
+    show(surface)
+
+    # Every second column will be made blue
+    ar = pg.PixelArray(surface)
+    ar[::2] = (0, 0, 255)
+    del ar
+    show(surface)
+
+    # Every second row will be made green
+    ar = pg.PixelArray(surface)
+    ar[:, ::2] = (0, 255, 0)
+    del ar
+    show(surface)
+
+    # Manipulate the image. Flip it around the y axis.
+    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 = pg.PixelArray(surface)
+    ar[:] = ar[::-1, :]
+    del ar
+    show(surface)
+
+    # Every second column will be made white.
+    ar = pg.PixelArray(surface)
+    ar[::2] = (255, 255, 255)
+    del ar
+    show(surface)
+
+    # Flip the image around both axes, restoring its original layout.
+    ar = pg.PixelArray(surface)
+    ar[:] = ar[::-1, ::-1]
+    del ar
+    show(surface)
+
+    # Rotate 90 degrees clockwise.
+    w, h = surface.get_size()
+    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 = 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 = 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 = 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 = 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
+    show(sf3)
+
+
+if __name__ == "__main__":
+    main()
+    pg.quit()
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/playmus.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/playmus.py
new file mode 100644
index 0000000..8c67733
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/playmus.py
@@ -0,0 +1,165 @@
+#!/usr/bin/env python
+""" pygame.examples.playmus
+
+A simple music player.
+
+   Use pygame.mixer.music to play an audio file.
+
+A window is created to handle keyboard events for playback commands.
+
+
+Keyboard Controls
+-----------------
+
+space - play/pause toggle
+r     - rewind
+f     - fade out
+q     - stop
+
+"""
+import sys
+
+import pygame as pg
+import pygame.freetype
+
+
+class Window:
+    """The application's Pygame window
+
+    A Window instance manages the creation of and drawing to a
+    window. It is a singleton class. Only one instance can exist.
+
+    """
+
+    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 ")
+    print("       python -m pygame.examples.playmus ")
+
+
+def main(file_path):
+    """Play an audio file with pg.mixer.music"""
+
+    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)
+
+            # Make sure the event loop ticks over at least every 0.5 seconds.
+            pg.time.set_timer(pg.USEREVENT, 500)
+
+            pg.mixer.music.play()
+            win.write_lines("Playing ...\n", -1)
+
+            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
+                        pg.mixer.music.stop()
+                        # get_busy() will now return False.
+                elif e.type == pg.QUIT:
+                    paused = False
+                    pg.mixer.music.stop()
+                    # get_busy() will now return False.
+            pg.time.set_timer(pg.USEREVENT, 0)
+        finally:
+            pg.mixer.quit()
+    pg.quit()
+
+
+if __name__ == "__main__":
+    # Check the only command line argument, a file path
+    if len(sys.argv) != 2:
+        show_usage_message()
+    else:
+        main(sys.argv[1])
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/resizing_new.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/resizing_new.py
new file mode 100644
index 0000000..cda01f2
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/resizing_new.py
@@ -0,0 +1,44 @@
+#!/usr/bin/env python
+import pygame as pg
+
+pg.init()
+
+RES = (160, 120)
+FPS = 30
+clock = pg.time.Clock()
+
+screen = pg.display.set_mode(RES, pg.RESIZABLE)
+pg.display._set_autoresize(False)
+
+# MAIN LOOP
+
+done = False
+
+i = 0
+j = 0
+
+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()
+
+    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)
+
+    pg.display.flip()
+    clock.tick(FPS)
+pg.quit()
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/scaletest.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/scaletest.py
new file mode 100644
index 0000000..0a79f6f
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/scaletest.py
@@ -0,0 +1,154 @@
+#!/usr/bin/env python
+""" pygame.examples.scaletest
+
+Shows an interactive image scaler.
+
+"""
+import sys
+import time
+import pygame as pg
+
+
+def main(imagefile, convert_alpha=False, run_speed_test=False):
+    """show an interactive image scaler
+
+    Args:
+        imagefile - name of source image (required)
+        convert_alpha - use convert_alpha() on the surf (default False)
+        run_speed_test - (default False)
+    """
+
+    # initialize display
+    pg.display.init()
+    # load background image
+    background = pg.image.load(imagefile)
+
+    if run_speed_test:
+        if convert_alpha:
+            # convert_alpha() requires the display mode to be set
+            pg.display.set_mode((1, 1))
+            background = background.convert_alpha()
+
+        SpeedTest(background)
+        return
+
+    # start fullscreen mode
+    screen = pg.display.set_mode((1024, 768), pg.FULLSCREEN)
+    if convert_alpha:
+        background = background.convert_alpha()
+
+    # turn off the mouse pointer
+    pg.mouse.set_visible(0)
+    # main loop
+    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)
+        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
+            ):
+                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 bDown:
+            cursize[1] += 2
+        if bLeft:
+            cursize[0] -= 2
+            if cursize[0] < 1:
+                cursize[0] = 1
+        if bRight:
+            cursize[0] += 2
+    pg.quit()
+
+
+def SpeedTest(image):
+    print(f"\nImage Scaling Speed Test - Image Size {str(image.get_size())}\n")
+
+    imgsize = [image.get_width(), image.get_height()]
+    duration = 0.0
+    for i in range(128):
+        shrinkx = (imgsize[0] * i) // 128
+        shrinky = (imgsize[1] * i) // 128
+        start = time.time()
+        tempimg = pg.transform.smoothscale(image, (shrinkx, shrinky))
+        duration += time.time() - start
+        del tempimg
+
+    print(f"Average transform.smoothscale shrink time: {duration / 128 * 1000:.4f} ms.")
+
+    duration = 0.0
+    for i in range(128):
+        expandx = (imgsize[0] * (i + 129)) // 128
+        expandy = (imgsize[1] * (i + 129)) // 128
+        start = time.time()
+        tempimg = pg.transform.smoothscale(image, (expandx, expandy))
+        duration += time.time() - start
+        del tempimg
+
+    print(f"Average transform.smoothscale expand time: {duration / 128 * 1000:.4f} ms.")
+
+    duration = 0.0
+    for i in range(128):
+        shrinkx = (imgsize[0] * i) // 128
+        shrinky = (imgsize[1] * i) // 128
+        start = time.time()
+        tempimg = pg.transform.scale(image, (shrinkx, shrinky))
+        duration += time.time() - start
+        del tempimg
+
+    print(f"Average transform.scale shrink time: {duration / 128 * 1000:.4f} ms.")
+
+    duration = 0.0
+    for i in range(128):
+        expandx = (imgsize[0] * (i + 129)) // 128
+        expandy = (imgsize[1] * (i + 129)) // 128
+        start = time.time()
+        tempimg = pg.transform.scale(image, (expandx, expandy))
+        duration += time.time() - start
+        del tempimg
+
+    print(f"Average transform.scale expand time: {duration / 128 * 1000:.4f} ms.")
+
+
+if __name__ == "__main__":
+    # check input parameters
+    if len(sys.argv) < 2:
+        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")
+    else:
+        main(
+            sys.argv[1],
+            convert_alpha="-convert_alpha" in sys.argv,
+            run_speed_test="-t" in sys.argv,
+        )
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/scrap_clipboard.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/scrap_clipboard.py
new file mode 100644
index 0000000..e6b9773
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/scrap_clipboard.py
@@ -0,0 +1,94 @@
+#!/usr/bin/env python
+""" pygame.examples.scrap_clipboard
+
+Demonstrates the clipboard capabilities of pygame.
+
+Copy/paste!
+
+
+Keyboard Controls
+-----------------
+
+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 as pg
+import pygame.scrap as scrap
+
+from io import BytesIO
+
+
+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")
+
+
+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/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/scroll.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/scroll.py
new file mode 100644
index 0000000..7c61ebb
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/scroll.py
@@ -0,0 +1,197 @@
+#!/usr/bin/env python
+""" pygame.examples.scroll
+
+An zoomed image viewer that demonstrates Surface.scroll
+
+This example shows a scrollable image that has a zoom factor of eight.
+It uses the Surface.scroll function to shift the image on the display
+surface. A clip rectangle protects a margin area. If called as a function,
+the example accepts an optional image file path. If run as a program
+it takes an optional file path command line argument. If no file
+is provided a default image file is used.
+
+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 sys
+import os
+
+import pygame as pg
+from pygame.transform import scale
+
+main_dir = os.path.dirname(os.path.abspath(__file__))
+
+
+DIR_UP = 1
+DIR_DOWN = 2
+DIR_LEFT = 3
+DIR_RIGHT = 4
+
+zoom_factor = 8
+
+
+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))
+    elif direction == DIR_DOWN:
+        pointlist = ((x - 29, y - 29), (x + 30, y - 29), (x + 1, y + 30), (x, y + 30))
+    elif direction == DIR_LEFT:
+        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))
+    pg.draw.polygon(surf, color, pointlist)
+
+
+def add_arrow_button(screen, regions, posn, direction):
+    draw_arrow(screen, "black", posn, direction)
+    draw_arrow(regions, (direction, 0, 0), posn, direction)
+
+
+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:
+        if view_rect.top > 0:
+            screen.scroll(dy=zoom_factor)
+            view_rect.move_ip(0, -1)
+            src_rect = view_rect.copy()
+            src_rect.h = 1
+            dst_rect = zoom_view_rect.copy()
+            dst_rect.h = zoom_factor
+    elif direction == DIR_DOWN:
+        if view_rect.bottom < image_h:
+            screen.scroll(dy=-zoom_factor)
+            view_rect.move_ip(0, 1)
+            src_rect = view_rect.copy()
+            src_rect.h = 1
+            src_rect.bottom = view_rect.bottom
+            dst_rect = zoom_view_rect.copy()
+            dst_rect.h = zoom_factor
+            dst_rect.bottom = zoom_view_rect.bottom
+    elif direction == DIR_LEFT:
+        if view_rect.left > 0:
+            screen.scroll(dx=zoom_factor)
+            view_rect.move_ip(-1, 0)
+            src_rect = view_rect.copy()
+            src_rect.w = 1
+            dst_rect = zoom_view_rect.copy()
+            dst_rect.w = zoom_factor
+    elif direction == DIR_RIGHT:
+        if view_rect.right < image_w:
+            screen.scroll(dx=-zoom_factor)
+            view_rect.move_ip(1, 0)
+            src_rect = view_rect.copy()
+            src_rect.w = 1
+            src_rect.right = view_rect.right
+            dst_rect = zoom_view_rect.copy()
+            dst_rect.w = zoom_factor
+            dst_rect.right = zoom_view_rect.right
+
+    if src_rect is not None and dst_rect is not None:
+        scale(image.subsurface(src_rect), dst_rect.size, screen.subsurface(dst_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.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 = pg.Color("beige")
+
+    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 = pg.key.get_repeat()
+    pg.key.set_repeat(500, 30)
+
+    try:
+        screen = pg.display.set_mode(win_size)
+        screen.fill(background_color)
+        pg.display.flip()
+
+        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]:
+            print("The source image is too small for this example.")
+            print("A %i by %i or larger image is required." % zoom_view_size)
+            return
+
+        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
+        )
+        add_arrow_button(screen, regions, (win_size[0] // 2, 40), DIR_UP)
+        add_arrow_button(
+            screen, regions, (win_size[0] // 2, win_size[1] - 40), DIR_DOWN
+        )
+        pg.display.flip()
+
+        screen.set_clip((margin, margin, zoom_view_size[0], zoom_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()),
+        )
+        pg.display.flip()
+
+        # the direction we will scroll in.
+        direction = None
+
+        clock = pg.time.Clock()
+        clock.tick()
+
+        going = True
+
+        while going:
+            # wait for events before doing anything.
+            # events = [pg.event.wait()] + pg.event.get()
+            events = pg.event.get()
+
+            # During the loop, if a key is held, scroll the view.
+            keys = pg.key.get_pressed()
+            if keys[pg.K_UP]:
+                scroll_view(screen, image, DIR_UP, view_rect)
+            if keys[pg.K_DOWN]:
+                scroll_view(screen, image, DIR_DOWN, view_rect)
+            if keys[pg.K_LEFT]:
+                scroll_view(screen, image, DIR_LEFT, view_rect)
+            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 == pg.QUIT:
+                    going = False
+
+                # handle mouse button presses on arrows.
+                elif e.type == pg.MOUSEBUTTONDOWN:
+                    direction = regions.get_at(e.pos)[0]
+
+                elif e.type == pg.MOUSEBUTTONUP:
+                    direction = None
+
+            if direction:
+                scroll_view(screen, image, direction, view_rect)
+            clock.tick(30)
+
+    finally:
+        pg.key.set_repeat(old_k_delay, old_k_interval)
+        pg.quit()
+
+
+if __name__ == "__main__":
+    image_file = sys.argv[1] if len(sys.argv) > 1 else None
+    main(image_file)
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/setmodescale.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/setmodescale.py
new file mode 100644
index 0000000..3f427d2
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/setmodescale.py
@@ -0,0 +1,67 @@
+#!/usr/bin/env python
+""" 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
+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.
+
+Passing SCALED to pygame.display.set_mode means the resolution depends
+on desktop size and the graphics are scaled.
+"""
+
+import pygame as pg
+
+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)
+
+# MAIN LOOP
+
+done = False
+
+i = 0
+j = 0
+
+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)
+
+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)
+
+    i += 1
+    i = i % screen.get_width()
+    j += i % 2
+    j = j % screen.get_height()
+
+    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)
+
+    pg.display.flip()
+    clock.tick(FPS)
+pg.quit()
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/sound.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/sound.py
new file mode 100644
index 0000000..c5a23b9
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/sound.py
@@ -0,0 +1,45 @@
+#!/usr/bin/env python
+""" 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
+we don't even bother loading all of the pygame package.
+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 as pg
+
+main_dir = os.path.split(os.path.abspath(__file__))[0]
+
+
+def main(file_path=None):
+    """Play an audio file as a buffered sound sample
+
+    :param str file_path: audio file (default data/secosmic_low.wav)
+    """
+    # choose a desired audio format
+    pg.mixer.init(11025)  # raises exception on fail
+
+    # load the sound
+    sound = pg.mixer.Sound(file_path)
+
+    # start playing
+    print("Playing Sound...")
+    channel = sound.play()
+
+    # poll until finished
+    while channel.get_busy():  # still playing
+        print("  ...still going...")
+        pg.time.wait(1000)
+    print("...Finished")
+    pg.quit()
+
+
+if __name__ == "__main__":
+    if len(sys.argv) > 1:
+        main(sys.argv[1])
+    else:
+        main(os.path.join(main_dir, "data", "secosmic_lo.wav"))
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/sound_array_demos.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/sound_array_demos.py
new file mode 100644
index 0000000..855808b
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/sound_array_demos.py
@@ -0,0 +1,217 @@
+#!/usr/bin/env python
+""" pygame.examples.sound_array_demos
+
+Creates an echo effect on any Sound object.
+
+Uses sndarray and numpy to create offset faded copies of the
+original sound. Currently it just uses hardcoded values for the
+number of echos and the delay. Easy for you to recreate as
+needed.
+
+version 2. changes:
+- Should work with different sample rates now.
+- 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
+
+
+# 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):
+    """returns a sound which is echoed of the last one."""
+
+    echo_length = 3.5
+
+    a1 = pg.sndarray.array(sound)
+    if mydebug:
+        print(f"SHAPE1: {a1.shape}")
+
+    length = a1.shape[0]
+
+    # myarr = zeros(length+12000)
+    myarr = zeros(a1.shape, int32)
+
+    if len(a1.shape) > 1:
+        # mult = a1.shape[1]
+        size = (a1.shape[0] + int(echo_length * a1.shape[0]), a1.shape[1])
+        # size = (a1.shape[0] + int(a1.shape[0] + (echo_length * 3000)), a1.shape[1])
+    else:
+        # mult = 1
+        size = (a1.shape[0] + int(echo_length * a1.shape[0]),)
+        # size = (a1.shape[0] + int(a1.shape[0] + (echo_length * 3000)),)
+
+    if mydebug:
+        print(int(echo_length * a1.shape[0]))
+    myarr = zeros(size, int32)
+
+    if mydebug:
+        print(f"size {size}")
+        print(myarr.shape)
+    myarr[:length] = a1
+    # print(myarr[3000:length+3000])
+    # print(a1 >> 1)
+    # print("a1.shape %s" % (a1.shape,))
+    # c = myarr[3000:length+(3000*mult)]
+    # print("c.shape %s" % (c.shape,))
+
+    incr = int(samples_per_second / echo_length)
+    gap = length
+
+    myarr[incr : gap + incr] += a1 >> 1
+    myarr[incr * 2 : gap + (incr * 2)] += a1 >> 2
+    myarr[incr * 3 : gap + (incr * 3)] += a1 >> 3
+    myarr[incr * 4 : gap + (incr * 4)] += a1 >> 4
+
+    if mydebug:
+        print(f"SHAPE2: {myarr.shape}")
+
+    sound2 = pg.sndarray.make_sound(myarr.astype(int16))
+
+    return sound2
+
+
+def slow_down_sound(sound, rate):
+    """returns a sound which is a slowed down version of the original.
+    rate - at which the sound should be slowed down.  eg. 0.5 would be half speed.
+    """
+
+    raise NotImplementedError()
+    # grow_rate = 1 / rate
+    # make it 1/rate times longer.
+    # a1 = pg.sndarray.array(sound)
+    # surf = pg.surfarray.make_surface(a1)
+    # print(a1.shape[0] * grow_rate)
+    # scaled_surf = pg.transform.scale(surf, (int(a1.shape[0] * grow_rate), a1.shape[1]))
+    # print(scaled_surf)
+    # print(surf)
+
+    # a2 = a1 * rate
+    # print(a1.shape)
+    # print(a2.shape)
+    # print(a2)
+    # sound2 = pg.sndarray.make_sound(a2.astype(int16))
+    # return sound2
+
+
+def sound_from_pos(sound, start_pos, samples_per_second=None, inplace=1):
+    """returns a sound which begins at the start_pos.
+    start_pos - in seconds from the beginning.
+    samples_per_second -
+    """
+
+    # see if we want to reuse the sound data or not.
+    if inplace:
+        a1 = pg.sndarray.samples(sound)
+    else:
+        a1 = pg.sndarray.array(sound)
+
+    # 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 = pg.mixer.get_init()[0]
+
+    # figure out the start position in terms of samples.
+    start_pos_in_samples = int(start_pos * samples_per_second)
+
+    # cut the beginning off the sound at the start position.
+    a2 = a1[start_pos_in_samples:]
+
+    # make the Sound instance from the array.
+    sound2 = pg.sndarray.make_sound(a2)
+
+    return sound2
+
+
+def main():
+    """play various sndarray effects"""
+
+    main_dir = os.path.split(os.path.abspath(__file__))[0]
+    print(f"mixer.get_init {pg.mixer.get_init()}")
+
+    samples_per_second = pg.mixer.get_init()[0]
+
+    print(("-" * 30) + "\n")
+    print("loading sound")
+    sound = pg.mixer.Sound(os.path.join(main_dir, "data", "car_door.wav"))
+
+    print("-" * 30)
+    print("start positions")
+    print("-" * 30)
+
+    start_pos = 0.1
+    sound2 = sound_from_pos(sound, start_pos, samples_per_second)
+
+    print(f"sound.get_length {sound.get_length()}")
+    print(f"sound2.get_length {sound2.get_length()}")
+    sound2.play()
+    while pg.mixer.get_busy():
+        pg.time.wait(200)
+
+    print("waiting 2 seconds")
+    pg.time.wait(2000)
+    print("playing original sound")
+
+    sound.play()
+    while pg.mixer.get_busy():
+        pg.time.wait(200)
+
+    print("waiting 2 seconds")
+    pg.time.wait(2000)
+
+    # if 0:
+    #    #TODO: this is broken.
+    #    print(("-" * 30) + "\n")
+    #    print("Slow down the original sound.")
+    #    rate = 0.2
+    #    slowed_sound = slow_down_sound(sound, rate)
+    #    slowed_sound.play()
+    #    while pg.mixer.get_busy():
+    #        pg.time.wait(200)
+
+    print("-" * 30)
+    print("echoing")
+    print("-" * 30)
+
+    t1 = time.time()
+    sound2 = make_echo(sound, samples_per_second)
+    print("time to make echo %i" % (time.time() - t1,))
+
+    print("original sound")
+    sound.play()
+    while pg.mixer.get_busy():
+        pg.time.wait(200)
+
+    print("echoed sound")
+    sound2.play()
+    while pg.mixer.get_busy():
+        pg.time.wait(200)
+
+    sound = pg.mixer.Sound(os.path.join(main_dir, "data", "secosmic_lo.wav"))
+
+    t1 = time.time()
+    sound3 = make_echo(sound, samples_per_second)
+    print("time to make echo %i" % (time.time() - t1,))
+
+    print("original sound")
+    sound.play()
+    while pg.mixer.get_busy():
+        pg.time.wait(200)
+
+    print("echoed sound")
+    sound3.play()
+    while pg.mixer.get_busy():
+        pg.time.wait(200)
+
+    pg.quit()
+
+
+if __name__ == "__main__":
+    main()
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/sprite_texture.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/sprite_texture.py
new file mode 100644
index 0000000..fd7a63b
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/sprite_texture.py
@@ -0,0 +1,110 @@
+#!/usr/bin/env python
+""" pygame.examples.sprite_texture
+
+Experimental! Uses APIs which may disappear in the next release (_sdl2 is private).
+
+
+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
+
+
+data_dir = os.path.join(os.path.split(os.path.abspath(__file__))[0], "data")
+
+
+def load_img(file):
+    return pg.image.load(os.path.join(data_dir, file))
+
+
+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"))
+
+
+class Something(pg.sprite.Sprite):
+    def __init__(self, img):
+        pg.sprite.Sprite.__init__(self)
+
+        self.rect = img.get_rect()
+        self.image = img
+
+        self.rect.w *= 5
+        self.rect.h *= 5
+
+        img.origin = self.rect.w / 2, self.rect.h / 2
+
+
+sprite = Something(Image(tex, (0, 0, tex.width / 2, tex.height / 2)))
+sprite.rect.x = 250
+sprite.rect.y = 50
+
+# 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 = pg.sprite.Group()
+group.add(sprite2)
+group.add(sprite)
+
+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.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
+
+    img = sprite.image
+    img.angle += 1
+    try:
+        img.flip_x = t % 50 < 25
+        img.flip_y = t % 100 < 50
+    except AttributeError:
+        # backwards compatibility for <=2.1.2
+        img.flipX = t % 50 < 25
+        img.flipY = 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']))
+
+    group.draw(renderer)
+
+    renderer.present()
+
+    clock.tick(60)
+    win.title = str(f"FPS: {clock.get_fps()}")
+
+pg.quit()
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/stars.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/stars.py
new file mode 100644
index 0000000..f154511
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/stars.py
@@ -0,0 +1,100 @@
+#!/usr/bin/env python
+""" pg.examples.stars
+
+    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 show
+the basics of creating a window, simple pixel plotting, and input
+event management.
+"""
+import random
+import math
+import pygame as pg
+
+# constants
+WINSIZE = [640, 480]
+WINCENTER = [320, 240]
+NUMSTARS = 150
+
+
+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]
+
+    if steps is None:
+        return [vel, [WINCENTER[0] + (vel[0] * steps), WINCENTER[1] + (vel[1] * steps)]]
+    return [vel, WINCENTER[:]]
+
+
+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 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 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():
+    "This is the starfield code"
+    # create our starfield
+    stars = initialize_stars()
+
+    # 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)
+
+    clock = pg.time.Clock()
+
+    # 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/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/testsprite.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/testsprite.py
new file mode 100644
index 0000000..100ec25
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/testsprite.py
@@ -0,0 +1,250 @@
+#!/usr/bin/env python
+""" pg.examples.testsprite
+
+Like the testsprite.c that comes with libsdl, this pygame version shows
+lots of sprites moving around.
+
+It is an abomination of ugly code, and mostly used for testing.
+
+
+See pg.examples.aliens for some prettyier code.
+"""
+import sys
+import os
+
+from random import randint
+from time import time
+from typing import List
+
+import pygame as pg
+
+main_dir = os.path.split(os.path.abspath(__file__))[0]
+data_dir = os.path.join(main_dir, "data")
+
+
+# use this to use update rects or not.
+#  If the screen is mostly full, then update rects are not useful.
+update_rects = True
+if "-update_rects" in sys.argv:
+    update_rects = True
+if "-noupdate_rects" in sys.argv:
+    update_rects = False
+
+use_static = False
+if "-static" in sys.argv:
+    use_static = True
+
+
+use_layered_dirty = False
+if "-layered_dirty" in sys.argv:
+    update_rects = True
+    use_layered_dirty = True
+
+
+flags = 0
+if "-flip" in sys.argv:
+    flags ^= pg.DOUBLEBUF
+
+if "-fullscreen" in sys.argv:
+    flags ^= pg.FULLSCREEN
+
+if "-sw" in sys.argv:
+    flags ^= pg.SWSURFACE
+
+use_rle = True
+
+if "-hw" in sys.argv:
+    flags ^= pg.HWSURFACE
+    use_rle = False
+
+if "-scaled" in sys.argv:
+    flags ^= pg.SCALED
+
+screen_dims = [640, 480]
+
+if "-height" in sys.argv:
+    i = sys.argv.index("-height")
+    screen_dims[1] = int(sys.argv[i + 1])
+
+if "-width" in sys.argv:
+    i = sys.argv.index("-width")
+    screen_dims[0] = int(sys.argv[i + 1])
+
+use_alpha = "-alpha" in sys.argv
+
+print(screen_dims)
+
+
+##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):
+        ##        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])
+        self.rect.y = randint(0, screen_dims[1])
+        # self.vel = [randint(-10, 10), randint(-10, 10)]
+        self.vel = [randint(-1, 1), randint(-1, 1)]
+        self.dirty = 2
+
+    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:
+                self.vel[i] = -self.vel[i]
+                nv = self.rect[i] + self.vel[i]
+            self.rect[i] = nv
+
+
+class Static(pg.sprite.DirtySprite):
+    images: List[pg.Surface] = []
+
+    def __init__(self):
+        pg.sprite.DirtySprite.__init__(self)
+        self.image = Static.images[0]
+        self.rect = self.image.get_rect()
+        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),
+    use_alpha=False,
+    flags=0,
+):
+    """Show lots of sprites moving around
+
+    Optional keyword arguments:
+    update_rects - use the RenderUpdate sprite group class (default True)
+    use_static - include non-moving images (default False)
+    use_layered_dirty - Use the FastRenderGroup sprite group (default False)
+    screen_dims - Pygame window dimensions (default [640, 480])
+    use_alpha - use alpha blending (default False)
+    flags - additional display mode flags (default no additional flags)
+
+    """
+
+    if use_layered_dirty:
+        update_rects = True
+
+    pg.init()  # needed to initialise time module for get_ticks()
+    pg.display.init()
+
+    # if "-fast" 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.
+    pg.joystick.init()
+    num_joysticks = pg.joystick.get_count()
+    if num_joysticks > 0:
+        stick = pg.joystick.Joystick(0)
+        stick.init()  # now we will receive events for the joystick
+
+    screen.fill([0, 0, 0])
+    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], pg.SRCCOLORKEY | pg.RLEACCEL)
+        sprite_surface2.set_colorkey([0xFF, 0xFF, 0xFF], pg.SRCCOLORKEY | pg.RLEACCEL)
+    else:
+        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()
+        sprite_surface2 = sprite_surface2.convert_alpha()
+    else:
+        sprite_surface = sprite_surface.convert()
+        sprite_surface2 = sprite_surface2.convert()
+
+    Thingy.images = [sprite_surface]
+    if use_static:
+        Static.images = [sprite_surface2]
+
+    if len(sys.argv) > 1:
+        try:
+            numsprites = int(sys.argv[-1])
+        except Exception:
+            numsprites = 100
+    else:
+        numsprites = 100
+    sprites = None
+    if use_layered_dirty:
+        ##        sprites = pg.sprite.FastRenderGroup()
+        sprites = pg.sprite.LayeredDirty()
+    else:
+        if update_rects:
+            sprites = pg.sprite.RenderUpdates()
+        else:
+            sprites = pg.sprite.Group()
+
+    for i in range(0, numsprites):
+        if use_static and i % 2 == 0:
+            sprites.add(Static())
+        sprites.add(Thingy())
+
+    frames = 0
+    start = time()
+
+    background = pg.Surface(screen.get_size())
+    background = background.convert()
+    background.fill([0, 0, 0])
+
+    going = True
+    while going:
+        if not update_rects:
+            screen.fill([0, 0, 0])
+
+        ##        for sprite in sprites:
+        ##            sprite.move()
+
+        if update_rects:
+            sprites.clear(screen, background)
+        sprites.update()
+
+        rects = sprites.draw(screen)
+        if update_rects:
+            pg.display.update(rects)
+        else:
+            pg.display.flip()
+
+        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}")
+    pg.quit()
+
+
+if __name__ == "__main__":
+    main(update_rects, use_static, use_layered_dirty, screen_dims, use_alpha, flags)
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/textinput.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/textinput.py
new file mode 100644
index 0000000..8852a8f
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/textinput.py
@@ -0,0 +1,235 @@
+#!/usr/bin/env python
+""" pg.examples.textinput
+
+A little "console" where you can write in text.
+
+Shows how to use the TEXTEDITING and TEXTINPUT events.
+"""
+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
+os.environ["SDL_IME_SHOW_UI"] = "1"
+
+
+class TextInput:
+    """
+    A simple TextInput class that allows you to receive inputs in pygame.
+    """
+
+    # Add font name for each language,
+    # otherwise some text can't be correctly displayed.
+    FONT_NAMES = ",".join(
+        str(x)
+        for x in [
+            "notosanscjktcregular",
+            "notosansmonocjktcregular",
+            "notosansregular,",
+            "microsoftjhengheimicrosoftjhengheiuilight",
+            "microsoftyaheimicrosoftyaheiuilight",
+            "msgothicmsuigothicmspgothic",
+            "msmincho",
+            "Arial",
+        ]
+    )
+
+    def __init__(
+        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 = 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
+        self._ime_text = ""
+        self._ime_text_pos = 0
+        self._ime_editing_text = ""
+        self._ime_editing_pos = 0
+        self.chat_list: List[str] = []
+
+        # Freetype
+        # The font name can be a comma separated list
+        # of font names to search for.
+        self.font = freetype.SysFont(self.FONT_NAMES, 24)
+        self.font_small = freetype.SysFont(self.FONT_NAMES, 16)
+        self.text_color = text_color
+
+        print("Using font: " + self.font.name)
+
+    def update(self, events) -> None:
+        """
+        Updates the text input widget
+        """
+        for event in events:
+            if event.type == pg.KEYDOWN:
+                if self.print_event:
+                    print(event)
+
+                if self._ime_editing:
+                    if len(self._ime_editing_text) == 0:
+                        self._ime_editing = False
+                    continue
+
+                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)
+
+                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
+
+                    # 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
+
+            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
+
+            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 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
+        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 :]
+
+        rect_text_l = self.font.render_to(
+            screen, start_pos, ime_text_l, self.text_color
+        )
+        start_pos.x += rect_text_l.width
+
+        # 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:
+    """
+    A class that handles the game's events, mainloop etc.
+    """
+
+    # CONSTANTS
+    # Frames per second, the general speed of the program
+    FPS = 50
+    # Size of window
+    SCREEN_WIDTH, SCREEN_HEIGHT = 640, 480
+    BG_COLOR = "black"
+
+    def __init__(self, caption: str) -> None:
+        # Initialize
+        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
+        self.print_event = "showevent" in sys.argv
+        self.text_input = TextInput(
+            prompt="> ",
+            pos=(0, 20),
+            screen_dimensions=(self.SCREEN_WIDTH, self.SCREEN_HEIGHT),
+            print_event=self.print_event,
+            text_color="green",
+        )
+
+    def main_loop(self) -> None:
+        pg.key.start_text_input()
+        input_rect = pg.Rect(80, 80, 320, 40)
+        pg.key.set_text_input_rect(input_rect)
+
+        while True:
+            events = pg.event.get()
+            for event in events:
+                if event.type == pg.QUIT:
+                    pg.quit()
+                    return
+
+            self.text_input.update(events)
+
+            # Screen updates
+            self.screen.fill(self.BG_COLOR)
+            self.text_input.draw(self.screen)
+
+            pg.display.update()
+            self.clock.tick(self.FPS)
+
+
+# Main loop process
+def main():
+    game = Game("Text Input Example")
+    game.main_loop()
+
+
+if __name__ == "__main__":
+    main()
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/vgrade.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/vgrade.py
new file mode 100644
index 0000000..06202c2
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/vgrade.py
@@ -0,0 +1,102 @@
+#!/usr/bin/env python
+""" 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 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
+strange. Learning to use numpy for images like this takes a
+bit of learning, but the payoff is extremely fast image
+manipulation in python.
+
+For Pygame 1.9.2 and up, this example also showcases a new feature
+of surfarray.blit_surface: array broadcasting. If a source array
+has either a width or height of 1, the array is repeatedly blitted
+to the surface along that dimension to fill the surface. In fact,
+a (1, 1) or (1, 1, 3) array results in a simple surface color fill.
+
+Just so you know how this breaks down. For each sampling of
+time, 30% goes to each creating the gradient and blitting the
+array. The final 40% goes to flipping/updating the display surface
+
+The window will have no border decorations.
+
+The code also demonstrates use of the timer events.
+"""
+
+
+import os
+import pygame as pg
+
+try:
+    import numpy as np
+    import numpy.random as np_random
+except ImportError:
+    raise SystemExit("This example requires numpy and the pygame surfarray module")
+
+timer = 0
+
+
+def stopwatch(message=None):
+    "simple routine to time python code"
+    global timer
+    if not message:
+        timer = pg.time.get_ticks()
+        return
+    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 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
+    width, height = surf.get_size()
+    # create array from 0.0 to 1.0 triplets
+    column = np.arange(height, dtype="float") / height
+    column = np.repeat(column[:, np.newaxis], [3], 1)
+    # create a single column of gradient
+    column = topcolor + (diff * column).astype("int")
+    # make the column a 3d image column by adding X
+    column = column.astype("uint8")[np.newaxis, :, :]
+    # 3d array into 2d array
+    return pg.surfarray.map_array(surf, column)
+
+
+def DisplayGradient(surf):
+    "choose random colors and show them"
+    stopwatch()
+    colors = np_random.randint(0, 255, (2, 3))
+    column = VertGradientColumn(surf, colors[0], colors[1])
+    pg.surfarray.blit_array(surf, column)
+    pg.display.flip()
+    stopwatch("Gradient:")
+
+
+def main():
+    pg.init()
+    pg.mixer.quit()  # remove ALSA underflow messages for Debian squeeze
+    size = 600, 400
+    os.environ["SDL_VIDEO_CENTERED"] = "1"
+    screen = pg.display.set_mode(size, pg.NOFRAME, 0)
+
+    pg.event.set_blocked(pg.MOUSEMOTION)  # keep our queue cleaner
+    pg.time.set_timer(pg.USEREVENT, 500)
+
+    while True:
+        event = pg.event.wait()
+        if event.type in (pg.QUIT, pg.KEYDOWN, pg.MOUSEBUTTONDOWN):
+            break
+        elif event.type == pg.USEREVENT:
+            DisplayGradient(screen)
+
+    pg.quit()
+
+
+if __name__ == "__main__":
+    main()
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/video.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/video.py
new file mode 100644
index 0000000..7104f47
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/examples/video.py
@@ -0,0 +1,158 @@
+#!/usr/bin/env python
+""" pg.examples.video
+
+Experimental!
+
+* dialog message boxes with messagebox.
+* multiple windows with Window
+* driver selection
+* Renderer, Texture, and Image classes
+* Drawing lines, rects, and such onto Renderers.
+"""
+import os
+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 pg.image.load(os.path.join(data_dir, file))
+
+
+pg.display.init()
+pg.key.set_repeat(1000, 10)
+
+for driver in get_drivers():
+    print(driver)
+
+import random
+
+try:
+    answer = messagebox(
+        "I will open two windows! Continue?",
+        "Hello!",
+        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"))
+img = Image(tex)
+
+running = True
+
+x, y = 250, 50
+clock = pg.time.Clock()
+
+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]
+
+    renderer.present()
+
+    clock.tick(60)
+    win.title = str(f"FPS: {clock.get_fps()}")
+
+pg.quit()
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/fastevent.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/fastevent.py
new file mode 100644
index 0000000..e102fc4
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/fastevent.py
@@ -0,0 +1,88 @@
+"""
+A compatibility shim for pygame.fastevent based on pygame.event.
+This module was deprecated in pygame 2.2, and is scheduled for removal in a
+future pygame version. If you are using pygame.fastevent, please migrate to
+using regular pygame.event module
+"""
+
+import pygame.event
+import pygame.display
+from pygame import error, register_quit
+from pygame.event import Event
+
+_ft_init = False
+
+
+def _ft_init_check():
+    """
+    Raises error if module is not init
+    """
+    if not _ft_init:
+        raise error("fastevent system not initialized")
+
+
+def _quit_hook():
+    """
+    Hook that gets run to quit module
+    """
+    global _ft_init
+    _ft_init = False
+
+
+def init():
+    """init() -> None
+    initialize pygame.fastevent
+    """
+    global _ft_init
+    if not pygame.display.get_init():
+        raise error("video system not initialized")
+
+    register_quit(_quit_hook)
+    _ft_init = True
+
+
+def get_init():
+    """get_init() -> bool
+    returns True if the fastevent module is currently initialized
+    """
+    return _ft_init
+
+
+def pump():
+    """pump() -> None
+    internally process pygame event handlers
+    """
+    _ft_init_check()
+    pygame.event.pump()
+
+
+def wait():
+    """wait() -> Event
+    wait for an event
+    """
+    _ft_init_check()
+    return pygame.event.wait()
+
+
+def poll():
+    """poll() -> Event
+    get an available event
+    """
+    _ft_init_check()
+    return pygame.event.poll()
+
+
+def get():
+    """get() -> list of Events
+    get all events from the queue
+    """
+    _ft_init_check()
+    return pygame.event.get()
+
+
+def post(event: Event):
+    """post(Event) -> None
+    place an event on the queue
+    """
+    _ft_init_check()
+    pygame.event.post(event)
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/fastevent.pyi b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/fastevent.pyi
new file mode 100644
index 0000000..9cfa701
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/fastevent.pyi
@@ -0,0 +1,11 @@
+from typing import List
+
+from pygame.event import Event
+
+def init() -> None: ...
+def get_init() -> bool: ...
+def pump() -> None: ...
+def wait() -> Event: ...
+def poll() -> Event: ...
+def get() -> List[Event]: ...
+def post(event: Event) -> None: ...
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/font.cpython-312-darwin.so b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/font.cpython-312-darwin.so
new file mode 100755
index 0000000..1aa23ef
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/font.cpython-312-darwin.so differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/font.pyi b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/font.pyi
new file mode 100644
index 0000000..c49cd89
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/font.pyi
@@ -0,0 +1,61 @@
+from typing import Callable, Hashable, Iterable, List, Optional, Tuple, Union
+
+from pygame.surface import Surface
+
+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
+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]: ...
+def get_default_font() -> str: ...
+def get_fonts() -> List[str]: ...
+def match_font(
+    name: Union[str, bytes, Iterable[Union[str, bytes]]],
+    bold: Hashable = False,
+    italic: Hashable = False,
+) -> str: ...
+def SysFont(
+    name: Union[str, bytes, Iterable[Union[str, bytes]], None],
+    size: int,
+    bold: Hashable = False,
+    italic: Hashable = False,
+    constructor: Optional[Callable[[Optional[str], int, bool, bool], Font]] = None,
+) -> Font: ...
+
+class Font:
+    bold: bool
+    italic: bool
+    underline: bool
+    strikethrough: bool
+    def __init__(self, name: Optional[FileArg], size: int) -> None: ...
+    def render(
+        self,
+        text: Union[str, bytes, None],
+        antialias: bool | Literal[0] | Literal[1],
+        color: ColorValue,
+        background: Optional[ColorValue] = None,
+    ) -> Surface: ...
+    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: 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: ...
+
+FontType = Font
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/freesansbold.ttf b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/freesansbold.ttf
new file mode 100644
index 0000000..a98562f
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/freesansbold.ttf differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/freetype.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/freetype.py
new file mode 100644
index 0000000..50a63cf
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/freetype.py
@@ -0,0 +1,78 @@
+"""Enhanced Pygame module for loading and rendering computer fonts"""
+
+from pygame._freetype import (
+    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,
+)
+from pygame.sysfont import match_font, get_fonts, SysFont as _SysFont
+
+__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",
+]
+
+
+def SysFont(name, size, bold=False, italic=False, constructor=None):
+    """pygame.ftfont.SysFont(name, size, bold=False, italic=False, constructor=None) -> Font
+    Create a pygame Font from system font resources.
+
+    This will search the system fonts for the given font
+    name. You can also enable bold or italic styles, and
+    the appropriate system font will be selected if available.
+
+    This will always return a valid Font object, and will
+    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
+    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
+    a Font instance. If None, a pygame.freetype.Font object is created.
+    """
+    if constructor is None:
+
+        def constructor(fontpath, size, bold, italic):
+            font = Font(fontpath, size)
+            font.strong = bold
+            font.oblique = italic
+            return font
+
+    return _SysFont(name, size, bold, italic, constructor)
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/freetype.pyi b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/freetype.pyi
new file mode 100644
index 0000000..f097e3b
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/freetype.pyi
@@ -0,0 +1,128 @@
+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 ._common import ColorValue, FileArg, RectValue
+
+def get_error() -> str: ...
+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: ...
+def was_init() -> bool: ...
+def get_cache_size() -> int: ...
+def get_default_resolution() -> int: ...
+def set_default_resolution(resolution: int) -> None: ...
+def SysFont(
+    name: Union[str, bytes, Iterable[Union[str, bytes]], None],
+    size: int,
+    bold: int = False,
+    italic: int = False,
+    constructor: Optional[Callable[[Optional[str], int, bool, bool], Font]] = None,
+) -> Font: ...
+def get_default_font() -> str: ...
+def get_fonts() -> List[str]: ...
+def match_font(
+    name: Union[str, bytes, Iterable[Union[str, bytes]]],
+    bold: Any = False,
+    italic: Any = False,
+) -> str: ...
+
+STYLE_NORMAL: int
+STYLE_UNDERLINE: int
+STYLE_OBLIQUE: int
+STYLE_STRONG: int
+STYLE_WIDE: int
+STYLE_DEFAULT: int
+
+class Font:
+    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: Optional[FileArg],
+        size: float = 0,
+        font_index: int = 0,
+        resolution: int = 0,
+        ucs4: int = False,
+    ) -> None: ...
+    def get_rect(
+        self,
+        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]]: ...
+    def render(
+        self,
+        text: str,
+        fgcolor: Optional[ColorValue] = None,
+        bgcolor: Optional[ColorValue] = None,
+        style: int = STYLE_DEFAULT,
+        rotation: int = 0,
+        size: float = 0,
+    ) -> Tuple[Surface, Rect]: ...
+    def render_to(
+        self,
+        surf: Surface,
+        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,
+        style: int = STYLE_DEFAULT,
+        rotation: int = 0,
+        size: float = 0,
+        invert: bool = False,
+    ) -> Tuple[bytes, Tuple[int, int]]: ...
+    def render_raw_to(
+        self,
+        array: Any,
+        text: str,
+        dest: Optional[RectValue] = None,
+        style: int = STYLE_DEFAULT,
+        rotation: int = 0,
+        size: float = 0,
+        invert: bool = False,
+    ) -> Rect: ...
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/ftfont.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/ftfont.py
new file mode 100644
index 0000000..abd55f7
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/ftfont.py
@@ -0,0 +1,203 @@
+"""pygame module for loading and rendering fonts (freetype alternative)"""
+
+__all__ = [
+    "Font",
+    "init",
+    "quit",
+    "get_default_font",
+    "get_init",
+    "SysFont",
+    "match_font",
+    "get_fonts",
+]
+
+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):
+    """Font(filename, size) -> Font
+    Font(object, size) -> Font
+    create a new Font object from a file (freetype alternative)
+
+    This Font type differs from font.Font in that it can render glyphs
+    for Unicode code points in the supplementary planes (> 0xFFFF).
+    """
+
+    __encode_file_path = staticmethod(encode_file_path)
+    __get_default_resolution = staticmethod(get_default_resolution)
+    __default_font = encode_file_path(get_default_font())
+
+    __unull = "\x00"
+    __bnull = b"\x00"
+
+    def __init__(self, file=None, size=-1):
+        size = max(size, 1)
+        if isinstance(file, str):
+            try:
+                bfile = self.__encode_file_path(file, ValueError)
+            except ValueError:
+                bfile = ""
+        else:
+            bfile = file
+        if isinstance(bfile, bytes) and bfile == self.__default_font:
+            file = None
+        if file is None:
+            resolution = int(self.__get_default_resolution() * 0.6875)
+            if resolution == 0:
+                resolution = 1
+        else:
+            resolution = 0
+        super().__init__(file, size=size, resolution=resolution)
+        self.strength = 1.0 / 12.0
+        self.kerning = False
+        self.origin = True
+        self.pad = True
+        self.ucs4 = True
+        self.underline_adjustment = 1.0
+
+    def render(self, text, antialias, color, background=None):
+        """render(text, antialias, color, background=None) -> Surface
+        draw text on a new Surface"""
+
+        if text is None:
+            text = ""
+        if isinstance(text, str) and self.__unull in text:
+            raise ValueError("A null character was found in the text")
+        if isinstance(text, bytes) and self.__bnull in text:
+            raise ValueError("A null character was found in the text")
+        save_antialiased = (
+            self.antialiased  # pylint: disable = access-member-before-definition
+        )
+        self.antialiased = bool(antialias)
+        try:
+            s, _ = super().render(text, color, background)
+            return s
+        finally:
+            self.antialiased = save_antialiased
+
+    def set_bold(self, value):
+        """set_bold(bool) -> None
+        enable fake rendering of bold text"""
+
+        self.wide = bool(value)
+
+    def get_bold(self):
+        """get_bold() -> bool
+        check if text will be rendered bold"""
+
+        return self.wide
+
+    bold = property(get_bold, set_bold)
+
+    def set_italic(self, value):
+        """set_italic(bool) -> None
+        enable fake rendering of italic text"""
+
+        self.oblique = bool(value)
+
+    def get_italic(self):
+        """get_italic() -> bool
+        check if the text will be rendered italic"""
+
+        return self.oblique
+
+    italic = property(get_italic, set_italic)
+
+    def set_underline(self, value):
+        """set_underline(bool) -> None
+        control if text is rendered with an underline"""
+
+        self.underline = bool(value)
+
+    def get_underline(self):
+        """get_underline() -> bool
+        check if the text will be rendered with an underline"""
+
+        return self.underline
+
+    def metrics(self, text):
+        """metrics(text) -> list
+        Gets the metrics for each character in the passed string."""
+
+        return self.get_metrics(text)
+
+    def get_ascent(self):
+        """get_ascent() -> int
+        get the ascent of the font"""
+
+        return self.get_sized_ascender()
+
+    def get_descent(self):
+        """get_descent() -> int
+        get the descent of the font"""
+
+        return self.get_sized_descender()
+
+    def get_height(self):
+        """get_height() -> int
+        get the height of the font"""
+
+        return self.get_sized_ascender() - self.get_sized_descender() + 1
+
+    def get_linesize(self):
+        """get_linesize() -> int
+        get the line space of the font text"""
+
+        return self.get_sized_height()
+
+    def size(self, text):
+        """size(text) -> (width, height)
+        determine the amount of space needed to render text"""
+
+        return self.get_rect(text).size
+
+
+FontType = Font
+
+
+def get_init():
+    """get_init() -> bool
+    true if the font module is initialized"""
+
+    return _get_init()
+
+
+def SysFont(name, size, bold=0, italic=0, constructor=None):
+    """pygame.ftfont.SysFont(name, size, bold=False, italic=False, constructor=None) -> Font
+    Create a pygame Font from system font resources.
+
+    This will search the system fonts for the given font
+    name. You can also enable bold or italic styles, and
+    the appropriate system font will be selected if available.
+
+    This will always return a valid Font object, and will
+    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
+    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
+    a Font instance. If None, a pygame.ftfont.Font object is created.
+    """
+    if constructor is None:
+
+        def constructor(fontpath, size, bold, italic):
+            font = Font(fontpath, size)
+            font.set_bold(bold)
+            font.set_italic(italic)
+            return font
+
+    return _SysFont(name, size, bold, italic, constructor)
+
+
+del _Font, get_default_resolution, encode_file_path
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/gfxdraw.cpython-312-darwin.so b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/gfxdraw.cpython-312-darwin.so
new file mode 100755
index 0000000..0cb755e
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/gfxdraw.cpython-312-darwin.so differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/gfxdraw.pyi b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/gfxdraw.pyi
new file mode 100644
index 0000000..dca1334
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/gfxdraw.pyi
@@ -0,0 +1,91 @@
+from typing import Sequence
+
+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: ColorValue
+) -> 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: ColorValue
+) -> None: ...
+def ellipse(
+    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: ColorValue
+) -> None: ...
+def filled_ellipse(
+    surface: Surface, x: int, y: int, rx: int, ry: int, color: ColorValue
+) -> None: ...
+def arc(
+    surface: Surface,
+    x: int,
+    y: int,
+    r: int,
+    start_angle: int,
+    atp_angle: int,
+    color: ColorValue,
+) -> None: ...
+def pie(
+    surface: Surface,
+    x: int,
+    y: int,
+    r: int,
+    start_angle: int,
+    atp_angle: int,
+    color: ColorValue,
+) -> None: ...
+def trigon(
+    surface: Surface,
+    x1: int,
+    y1: int,
+    x2: int,
+    y2: int,
+    x3: int,
+    y3: int,
+    color: ColorValue,
+) -> None: ...
+def aatrigon(
+    surface: Surface,
+    x1: int,
+    y1: int,
+    x2: int,
+    y2: int,
+    x3: int,
+    y3: int,
+    color: ColorValue,
+) -> None: ...
+def filled_trigon(
+    surface: Surface,
+    x1: int,
+    y1: int,
+    x2: int,
+    y2: int,
+    x3: int,
+    y3: int,
+    color: ColorValue,
+) -> None: ...
+def polygon(
+    surface: Surface, points: Sequence[Coordinate], color: ColorValue
+) -> None: ...
+def aapolygon(
+    surface: Surface, points: Sequence[Coordinate], color: ColorValue
+) -> None: ...
+def filled_polygon(
+    surface: Surface, points: Sequence[Coordinate], color: ColorValue
+) -> None: ...
+def textured_polygon(
+    surface: Surface, points: Sequence[Coordinate], texture: Surface, tx: int, ty: int
+) -> None: ...
+def bezier(
+    surface: Surface, points: Sequence[Coordinate], steps: int, color: ColorValue
+) -> None: ...
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/image.cpython-312-darwin.so b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/image.cpython-312-darwin.so
new file mode 100755
index 0000000..06744fa
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/image.cpython-312-darwin.so differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/image.pyi b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/image.pyi
new file mode 100644
index 0000000..69e90cd
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/image.pyi
@@ -0,0 +1,45 @@
+from typing import Optional, Sequence, Tuple, Union
+
+from pygame.bufferproxy import BufferProxy
+from pygame.surface import Surface
+
+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(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: _to_string_format, flipped: bool = False
+) -> bytes: ...
+def fromstring(
+    bytes: bytes,
+    size: Union[Sequence[int], Tuple[int, int]],
+    format: _from_string_format,
+    flipped: bool = False,
+) -> 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: Union[Sequence[int], Tuple[int, int]],
+    format: _from_string_format,
+    flipped: bool = False,
+) -> Surface: ...
+def frombuffer(
+    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/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/imageext.cpython-312-darwin.so b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/imageext.cpython-312-darwin.so
new file mode 100755
index 0000000..9710288
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/imageext.cpython-312-darwin.so differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/joystick.cpython-312-darwin.so b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/joystick.cpython-312-darwin.so
new file mode 100755
index 0000000..8f1171e
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/joystick.cpython-312-darwin.so differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/joystick.pyi b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/joystick.pyi
new file mode 100644
index 0000000..760a39d
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/joystick.pyi
@@ -0,0 +1,35 @@
+from typing import Tuple, final
+
+def init() -> None: ...
+def quit() -> None: ...
+def get_init() -> bool: ...
+def get_count() -> int: ...
+@final
+class JoystickType:
+    def __init__(self, id: int) -> None: ...
+    def init(self) -> None: ...
+    def quit(self) -> None: ...
+    def get_init(self) -> bool: ...
+    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_numballs(self) -> int: ...
+    def get_ball(self, ball_number: int) -> Tuple[float, float]: ...
+    def get_numbuttons(self) -> int: ...
+    def get_button(self, button: int) -> bool: ...
+    def get_numhats(self) -> int: ...
+    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: ...
+
+# 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: ...
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/key.cpython-312-darwin.so b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/key.cpython-312-darwin.so
new file mode 100755
index 0000000..5a7e88b
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/key.cpython-312-darwin.so differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/key.pyi b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/key.pyi
new file mode 100644
index 0000000..fa75a16
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/key.pyi
@@ -0,0 +1,17 @@
+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/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/locals.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/locals.py
new file mode 100644
index 0000000..38801d5
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/locals.py
@@ -0,0 +1,30 @@
+#    pygame - Python Game Library
+#    Copyright (C) 2000-2003  Pete Shinners
+#
+#    This library is free software; you can redistribute it and/or
+#    modify it under the terms of the GNU Library General Public
+#    License as published by the Free Software Foundation; either
+#    version 2 of the License, or (at your option) any later version.
+#
+#    This library is distributed in the hope that it will be useful,
+#    but WITHOUT ANY WARRANTY; without even the implied warranty of
+#    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+#    Library General Public License for more details.
+#
+#    You should have received a copy of the GNU Library General Public
+#    License along with this library; if not, write to the Free
+#    Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
+#
+#    Pete Shinners
+#    pete@shinners.org
+
+
+"""Set of functions from pygame that are handy to have in
+the local namespace for your module"""
+
+import pygame
+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/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/locals.pyi b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/locals.pyi
new file mode 100644
index 0000000..b6c2dd0
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/locals.pyi
@@ -0,0 +1,562 @@
+# 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!
+
+ACTIVEEVENT: int
+ANYFORMAT: int
+APPACTIVE: int
+APPINPUTFOCUS: int
+APPMOUSEFOCUS: int
+APP_DIDENTERBACKGROUND: int
+APP_DIDENTERFOREGROUND: int
+APP_LOWMEMORY: int
+APP_TERMINATING: int
+APP_WILLENTERBACKGROUND: int
+APP_WILLENTERFOREGROUND: int
+ASYNCBLIT: int
+AUDIODEVICEADDED: int
+AUDIODEVICEREMOVED: int
+AUDIO_ALLOW_ANY_CHANGE: int
+AUDIO_ALLOW_CHANNELS_CHANGE: int
+AUDIO_ALLOW_FORMAT_CHANGE: int
+AUDIO_ALLOW_FREQUENCY_CHANGE: int
+AUDIO_S16: int
+AUDIO_S16LSB: int
+AUDIO_S16MSB: int
+AUDIO_S16SYS: int
+AUDIO_S8: int
+AUDIO_U16: int
+AUDIO_U16LSB: int
+AUDIO_U16MSB: int
+AUDIO_U16SYS: int
+AUDIO_U8: int
+BIG_ENDIAN: int
+BLENDMODE_ADD: int
+BLENDMODE_BLEND: int
+BLENDMODE_MOD: int
+BLENDMODE_NONE: int
+BLEND_ADD: int
+BLEND_ALPHA_SDL2: int
+BLEND_MAX: int
+BLEND_MIN: int
+BLEND_MULT: int
+BLEND_PREMULTIPLIED: int
+BLEND_RGBA_ADD: int
+BLEND_RGBA_MAX: int
+BLEND_RGBA_MIN: int
+BLEND_RGBA_MULT: int
+BLEND_RGBA_SUB: int
+BLEND_RGB_ADD: int
+BLEND_RGB_MAX: int
+BLEND_RGB_MIN: int
+BLEND_RGB_MULT: int
+BLEND_RGB_SUB: int
+BLEND_SUB: int
+BUTTON_LEFT: int
+BUTTON_MIDDLE: int
+BUTTON_RIGHT: int
+BUTTON_WHEELDOWN: int
+BUTTON_WHEELUP: int
+BUTTON_X1: int
+BUTTON_X2: int
+CLIPBOARDUPDATE: int
+CONTROLLERAXISMOTION: int
+CONTROLLERBUTTONDOWN: int
+CONTROLLERBUTTONUP: int
+CONTROLLERDEVICEADDED: int
+CONTROLLERDEVICEREMAPPED: int
+CONTROLLERDEVICEREMOVED: int
+CONTROLLERSENSORUPDATE: int
+CONTROLLERTOUCHPADDOWN: int
+CONTROLLERTOUCHPADMOTION: int
+CONTROLLERTOUCHPADUP: int
+CONTROLLER_AXIS_INVALID: int
+CONTROLLER_AXIS_LEFTX: int
+CONTROLLER_AXIS_LEFTY: int
+CONTROLLER_AXIS_MAX: int
+CONTROLLER_AXIS_RIGHTX: int
+CONTROLLER_AXIS_RIGHTY: int
+CONTROLLER_AXIS_TRIGGERLEFT: int
+CONTROLLER_AXIS_TRIGGERRIGHT: int
+CONTROLLER_BUTTON_A: int
+CONTROLLER_BUTTON_B: int
+CONTROLLER_BUTTON_BACK: int
+CONTROLLER_BUTTON_DPAD_DOWN: int
+CONTROLLER_BUTTON_DPAD_LEFT: int
+CONTROLLER_BUTTON_DPAD_RIGHT: int
+CONTROLLER_BUTTON_DPAD_UP: int
+CONTROLLER_BUTTON_GUIDE: int
+CONTROLLER_BUTTON_INVALID: int
+CONTROLLER_BUTTON_LEFTSHOULDER: int
+CONTROLLER_BUTTON_LEFTSTICK: int
+CONTROLLER_BUTTON_MAX: int
+CONTROLLER_BUTTON_RIGHTSHOULDER: int
+CONTROLLER_BUTTON_RIGHTSTICK: int
+CONTROLLER_BUTTON_START: int
+CONTROLLER_BUTTON_X: int
+CONTROLLER_BUTTON_Y: int
+Color: type
+DOUBLEBUF: int
+DROPBEGIN: int
+DROPCOMPLETE: int
+DROPFILE: int
+DROPTEXT: int
+FINGERDOWN: int
+FINGERMOTION: int
+FINGERUP: int
+FULLSCREEN: int
+GL_ACCELERATED_VISUAL: int
+GL_ACCUM_ALPHA_SIZE: int
+GL_ACCUM_BLUE_SIZE: int
+GL_ACCUM_GREEN_SIZE: int
+GL_ACCUM_RED_SIZE: int
+GL_ALPHA_SIZE: int
+GL_BLUE_SIZE: int
+GL_BUFFER_SIZE: int
+GL_CONTEXT_DEBUG_FLAG: int
+GL_CONTEXT_FLAGS: int
+GL_CONTEXT_FORWARD_COMPATIBLE_FLAG: int
+GL_CONTEXT_MAJOR_VERSION: int
+GL_CONTEXT_MINOR_VERSION: int
+GL_CONTEXT_PROFILE_COMPATIBILITY: int
+GL_CONTEXT_PROFILE_CORE: int
+GL_CONTEXT_PROFILE_ES: int
+GL_CONTEXT_PROFILE_MASK: int
+GL_CONTEXT_RELEASE_BEHAVIOR: int
+GL_CONTEXT_RELEASE_BEHAVIOR_FLUSH: int
+GL_CONTEXT_RELEASE_BEHAVIOR_NONE: int
+GL_CONTEXT_RESET_ISOLATION_FLAG: int
+GL_CONTEXT_ROBUST_ACCESS_FLAG: int
+GL_DEPTH_SIZE: int
+GL_DOUBLEBUFFER: int
+GL_FRAMEBUFFER_SRGB_CAPABLE: int
+GL_GREEN_SIZE: int
+GL_MULTISAMPLEBUFFERS: int
+GL_MULTISAMPLESAMPLES: int
+GL_RED_SIZE: int
+GL_SHARE_WITH_CURRENT_CONTEXT: int
+GL_STENCIL_SIZE: int
+GL_STEREO: int
+GL_SWAP_CONTROL: int
+HAT_CENTERED: int
+HAT_DOWN: int
+HAT_LEFT: int
+HAT_LEFTDOWN: int
+HAT_LEFTUP: int
+HAT_RIGHT: int
+HAT_RIGHTDOWN: int
+HAT_RIGHTUP: int
+HAT_UP: int
+HIDDEN: int
+HWACCEL: int
+HWPALETTE: int
+HWSURFACE: int
+JOYAXISMOTION: int
+JOYBALLMOTION: int
+JOYBUTTONDOWN: int
+JOYBUTTONUP: int
+JOYDEVICEADDED: int
+JOYDEVICEREMOVED: int
+JOYHATMOTION: int
+KEYDOWN: int
+KEYMAPCHANGED: int
+KEYUP: int
+KMOD_ALT: int
+KMOD_CAPS: int
+KMOD_CTRL: int
+KMOD_GUI: int
+KMOD_LALT: int
+KMOD_LCTRL: int
+KMOD_LGUI: int
+KMOD_LMETA: int
+KMOD_LSHIFT: int
+KMOD_META: int
+KMOD_MODE: int
+KMOD_NONE: int
+KMOD_NUM: int
+KMOD_RALT: int
+KMOD_RCTRL: int
+KMOD_RGUI: int
+KMOD_RMETA: int
+KMOD_RSHIFT: int
+KMOD_SHIFT: int
+KSCAN_0: int
+KSCAN_1: int
+KSCAN_2: int
+KSCAN_3: int
+KSCAN_4: int
+KSCAN_5: int
+KSCAN_6: int
+KSCAN_7: int
+KSCAN_8: int
+KSCAN_9: int
+KSCAN_A: int
+KSCAN_AC_BACK: int
+KSCAN_APOSTROPHE: int
+KSCAN_B: int
+KSCAN_BACKSLASH: int
+KSCAN_BACKSPACE: int
+KSCAN_BREAK: int
+KSCAN_C: int
+KSCAN_CAPSLOCK: int
+KSCAN_CLEAR: int
+KSCAN_COMMA: int
+KSCAN_CURRENCYSUBUNIT: int
+KSCAN_CURRENCYUNIT: int
+KSCAN_D: int
+KSCAN_DELETE: int
+KSCAN_DOWN: int
+KSCAN_E: int
+KSCAN_END: int
+KSCAN_EQUALS: int
+KSCAN_ESCAPE: int
+KSCAN_EURO: int
+KSCAN_F: int
+KSCAN_F1: int
+KSCAN_F10: int
+KSCAN_F11: int
+KSCAN_F12: int
+KSCAN_F13: int
+KSCAN_F14: int
+KSCAN_F15: int
+KSCAN_F2: int
+KSCAN_F3: int
+KSCAN_F4: int
+KSCAN_F5: int
+KSCAN_F6: int
+KSCAN_F7: int
+KSCAN_F8: int
+KSCAN_F9: int
+KSCAN_G: int
+KSCAN_GRAVE: int
+KSCAN_H: int
+KSCAN_HELP: int
+KSCAN_HOME: int
+KSCAN_I: int
+KSCAN_INSERT: int
+KSCAN_INTERNATIONAL1: int
+KSCAN_INTERNATIONAL2: int
+KSCAN_INTERNATIONAL3: int
+KSCAN_INTERNATIONAL4: int
+KSCAN_INTERNATIONAL5: int
+KSCAN_INTERNATIONAL6: int
+KSCAN_INTERNATIONAL7: int
+KSCAN_INTERNATIONAL8: int
+KSCAN_INTERNATIONAL9: int
+KSCAN_J: int
+KSCAN_K: int
+KSCAN_KP0: int
+KSCAN_KP1: int
+KSCAN_KP2: int
+KSCAN_KP3: int
+KSCAN_KP4: int
+KSCAN_KP5: int
+KSCAN_KP6: int
+KSCAN_KP7: int
+KSCAN_KP8: int
+KSCAN_KP9: int
+KSCAN_KP_0: int
+KSCAN_KP_1: int
+KSCAN_KP_2: int
+KSCAN_KP_3: int
+KSCAN_KP_4: int
+KSCAN_KP_5: int
+KSCAN_KP_6: int
+KSCAN_KP_7: int
+KSCAN_KP_8: int
+KSCAN_KP_9: int
+KSCAN_KP_DIVIDE: int
+KSCAN_KP_ENTER: int
+KSCAN_KP_EQUALS: int
+KSCAN_KP_MINUS: int
+KSCAN_KP_MULTIPLY: int
+KSCAN_KP_PERIOD: int
+KSCAN_KP_PLUS: int
+KSCAN_L: int
+KSCAN_LALT: int
+KSCAN_LANG1: int
+KSCAN_LANG2: int
+KSCAN_LANG3: int
+KSCAN_LANG4: int
+KSCAN_LANG5: int
+KSCAN_LANG6: int
+KSCAN_LANG7: int
+KSCAN_LANG8: int
+KSCAN_LANG9: int
+KSCAN_LCTRL: int
+KSCAN_LEFT: int
+KSCAN_LEFTBRACKET: int
+KSCAN_LGUI: int
+KSCAN_LMETA: int
+KSCAN_LSHIFT: int
+KSCAN_LSUPER: int
+KSCAN_M: int
+KSCAN_MENU: int
+KSCAN_MINUS: int
+KSCAN_MODE: int
+KSCAN_N: int
+KSCAN_NONUSBACKSLASH: int
+KSCAN_NONUSHASH: int
+KSCAN_NUMLOCK: int
+KSCAN_NUMLOCKCLEAR: int
+KSCAN_O: int
+KSCAN_P: int
+KSCAN_PAGEDOWN: int
+KSCAN_PAGEUP: int
+KSCAN_PAUSE: int
+KSCAN_PERIOD: int
+KSCAN_POWER: int
+KSCAN_PRINT: int
+KSCAN_PRINTSCREEN: int
+KSCAN_Q: int
+KSCAN_R: int
+KSCAN_RALT: int
+KSCAN_RCTRL: int
+KSCAN_RETURN: int
+KSCAN_RGUI: int
+KSCAN_RIGHT: int
+KSCAN_RIGHTBRACKET: int
+KSCAN_RMETA: int
+KSCAN_RSHIFT: int
+KSCAN_RSUPER: int
+KSCAN_S: int
+KSCAN_SCROLLLOCK: int
+KSCAN_SCROLLOCK: int
+KSCAN_SEMICOLON: int
+KSCAN_SLASH: int
+KSCAN_SPACE: int
+KSCAN_SYSREQ: int
+KSCAN_T: int
+KSCAN_TAB: int
+KSCAN_U: int
+KSCAN_UNKNOWN: int
+KSCAN_UP: int
+KSCAN_V: int
+KSCAN_W: int
+KSCAN_X: int
+KSCAN_Y: int
+KSCAN_Z: int
+K_0: int
+K_1: int
+K_2: int
+K_3: int
+K_4: int
+K_5: int
+K_6: int
+K_7: int
+K_8: int
+K_9: int
+K_AC_BACK: int
+K_AMPERSAND: int
+K_ASTERISK: int
+K_AT: int
+K_BACKQUOTE: int
+K_BACKSLASH: int
+K_BACKSPACE: int
+K_BREAK: int
+K_CAPSLOCK: int
+K_CARET: int
+K_CLEAR: int
+K_COLON: int
+K_COMMA: int
+K_CURRENCYSUBUNIT: int
+K_CURRENCYUNIT: int
+K_DELETE: int
+K_DOLLAR: int
+K_DOWN: int
+K_END: int
+K_EQUALS: int
+K_ESCAPE: int
+K_EURO: int
+K_EXCLAIM: int
+K_F1: int
+K_F10: int
+K_F11: int
+K_F12: int
+K_F13: int
+K_F14: int
+K_F15: int
+K_F2: int
+K_F3: int
+K_F4: int
+K_F5: int
+K_F6: int
+K_F7: int
+K_F8: int
+K_F9: int
+K_GREATER: int
+K_HASH: int
+K_HELP: int
+K_HOME: int
+K_INSERT: int
+K_KP0: int
+K_KP1: int
+K_KP2: int
+K_KP3: int
+K_KP4: int
+K_KP5: int
+K_KP6: int
+K_KP7: int
+K_KP8: int
+K_KP9: int
+K_KP_0: int
+K_KP_1: int
+K_KP_2: int
+K_KP_3: int
+K_KP_4: int
+K_KP_5: int
+K_KP_6: int
+K_KP_7: int
+K_KP_8: int
+K_KP_9: int
+K_KP_DIVIDE: int
+K_KP_ENTER: int
+K_KP_EQUALS: int
+K_KP_MINUS: int
+K_KP_MULTIPLY: int
+K_KP_PERIOD: int
+K_KP_PLUS: int
+K_LALT: int
+K_LCTRL: int
+K_LEFT: int
+K_LEFTBRACKET: int
+K_LEFTPAREN: int
+K_LESS: int
+K_LGUI: int
+K_LMETA: int
+K_LSHIFT: int
+K_LSUPER: int
+K_MENU: int
+K_MINUS: int
+K_MODE: int
+K_NUMLOCK: int
+K_NUMLOCKCLEAR: int
+K_PAGEDOWN: int
+K_PAGEUP: int
+K_PAUSE: int
+K_PERCENT: int
+K_PERIOD: int
+K_PLUS: int
+K_POWER: int
+K_PRINT: int
+K_PRINTSCREEN: int
+K_QUESTION: int
+K_QUOTE: int
+K_QUOTEDBL: int
+K_RALT: int
+K_RCTRL: int
+K_RETURN: int
+K_RGUI: int
+K_RIGHT: int
+K_RIGHTBRACKET: int
+K_RIGHTPAREN: int
+K_RMETA: int
+K_RSHIFT: int
+K_RSUPER: int
+K_SCROLLLOCK: int
+K_SCROLLOCK: int
+K_SEMICOLON: int
+K_SLASH: int
+K_SPACE: int
+K_SYSREQ: int
+K_TAB: int
+K_UNDERSCORE: int
+K_UNKNOWN: int
+K_UP: int
+K_a: int
+K_b: int
+K_c: int
+K_d: int
+K_e: int
+K_f: int
+K_g: int
+K_h: int
+K_i: int
+K_j: int
+K_k: int
+K_l: int
+K_m: int
+K_n: int
+K_o: int
+K_p: int
+K_q: int
+K_r: int
+K_s: int
+K_t: int
+K_u: int
+K_v: int
+K_w: int
+K_x: int
+K_y: int
+K_z: int
+LIL_ENDIAN: int
+LOCALECHANGED: int
+MIDIIN: int
+MIDIOUT: int
+MOUSEBUTTONDOWN: int
+MOUSEBUTTONUP: int
+MOUSEMOTION: int
+MOUSEWHEEL: int
+MULTIGESTURE: int
+NOEVENT: int
+NOFRAME: int
+NUMEVENTS: int
+OPENGL: int
+OPENGLBLIT: int
+PREALLOC: int
+QUIT: int
+RENDER_DEVICE_RESET: int
+RENDER_TARGETS_RESET: int
+RESIZABLE: int
+RLEACCEL: int
+RLEACCELOK: int
+Rect: type
+SCALED: int
+SCRAP_BMP: str
+SCRAP_CLIPBOARD: int
+SCRAP_PBM: str
+SCRAP_PPM: str
+SCRAP_SELECTION: int
+SCRAP_TEXT: str
+SHOWN: int
+SRCALPHA: int
+SRCCOLORKEY: int
+SWSURFACE: int
+SYSTEM_CURSOR_ARROW: int
+SYSTEM_CURSOR_CROSSHAIR: int
+SYSTEM_CURSOR_HAND: int
+SYSTEM_CURSOR_IBEAM: int
+SYSTEM_CURSOR_NO: int
+SYSTEM_CURSOR_SIZEALL: int
+SYSTEM_CURSOR_SIZENESW: int
+SYSTEM_CURSOR_SIZENS: int
+SYSTEM_CURSOR_SIZENWSE: int
+SYSTEM_CURSOR_SIZEWE: int
+SYSTEM_CURSOR_WAIT: int
+SYSTEM_CURSOR_WAITARROW: int
+SYSWMEVENT: int
+TEXTEDITING: int
+TEXTINPUT: int
+TIMER_RESOLUTION: int
+USEREVENT: int
+USEREVENT_DROPFILE: int
+VIDEOEXPOSE: int
+VIDEORESIZE: int
+WINDOWCLOSE: int
+WINDOWDISPLAYCHANGED: int
+WINDOWENTER: int
+WINDOWEXPOSED: int
+WINDOWFOCUSGAINED: int
+WINDOWFOCUSLOST: int
+WINDOWHIDDEN: int
+WINDOWHITTEST: int
+WINDOWICCPROFCHANGED: int
+WINDOWLEAVE: int
+WINDOWMAXIMIZED: int
+WINDOWMINIMIZED: int
+WINDOWMOVED: int
+WINDOWRESIZED: int
+WINDOWRESTORED: int
+WINDOWSHOWN: int
+WINDOWSIZECHANGED: int
+WINDOWTAKEFOCUS: int
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/macosx.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/macosx.py
new file mode 100644
index 0000000..0a16d31
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/macosx.py
@@ -0,0 +1,13 @@
+import platform
+import os
+import sys
+
+__all__ = ["Video_AutoInit"]
+
+
+def Video_AutoInit():
+    """Called from the base.c just before display module is initialized."""
+    if "Darwin" in platform.platform():
+        if (os.getcwd() == "/") and len(sys.argv) > 1:
+            os.chdir(os.path.dirname(sys.argv[0]))
+    return True
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/mask.cpython-312-darwin.so b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/mask.cpython-312-darwin.so
new file mode 100755
index 0000000..e0102b5
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/mask.cpython-312-darwin.so differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/mask.pyi b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/mask.pyi
new file mode 100644
index 0000000..dbe248f
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/mask.pyi
@@ -0,0 +1,59 @@
+from typing import Any, List, Optional, Sequence, Tuple, Union
+
+from pygame.rect import Rect
+from pygame.surface import Surface
+
+from ._common import ColorValue, Coordinate, RectValue
+
+def from_surface(surface: Surface, threshold: int = 127) -> Mask: ...
+def from_threshold(
+    surface: Surface,
+    color: ColorValue,
+    threshold: ColorValue = (0, 0, 0, 255),
+    othersurface: Optional[Surface] = None,
+    palette_colors: int = 1,
+) -> Mask: ...
+
+class Mask:
+    def __init__(self, size: Coordinate, fill: bool = False) -> None: ...
+    def __copy__(self) -> Mask: ...
+    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: 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: 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: ...
+
+MaskType = Mask
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/math.cpython-312-darwin.so b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/math.cpython-312-darwin.so
new file mode 100755
index 0000000..42c55cb
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/math.cpython-312-darwin.so differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/math.pyi b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/math.pyi
new file mode 100644
index 0000000..5ee662c
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/math.pyi
@@ -0,0 +1,342 @@
+import sys
+from typing import (
+    Any,
+    Generic,
+    Iterator,
+    List,
+    Literal,
+    Sequence,
+    Tuple,
+    Type,
+    TypeVar,
+    Union,
+    final,
+    overload,
+    Optional,
+)
+
+from typing_extensions import Protocol
+
+if sys.version_info >= (3, 9):
+    from collections.abc import Collection
+else:
+    from typing import Collection
+
+def lerp(a: float, b: float, weight: float) -> float: ...
+def clamp(value: float, min: float, max: float) -> float: ...
+
+_TVec = TypeVar("_TVec", bound=_GenericVector)
+
+# not implemented in code, only implemented here for ease of implementing
+# typestubs. Contains attributes/methods common to Vector2 and Vector3
+# Also used with _TVec generics
+class _GenericVector(Collection[float]):
+    epsilon: float
+    __hash__: None  # type: ignore
+    def __len__(self) -> int: ...
+    @overload
+    def __setitem__(self, key: int, value: float) -> None: ...
+    @overload
+    def __setitem__(self, key: slice, value: Union[Sequence[float], _TVec]) -> None: ...
+    @overload
+    def __getitem__(self, i: int) -> float: ...
+    @overload
+    def __getitem__(self, s: slice) -> List[float]: ...
+    def __iter__(self) -> VectorIterator: ...
+    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: Union[Sequence[float], _TVec]) -> float: ...
+    @overload
+    def __mul__(self: _TVec, other: float) -> _TVec: ...
+    def __rmul__(self: _TVec, other: float) -> _TVec: ...
+    def __truediv__(self: _TVec, other: float) -> _TVec: ...
+    def __rtruediv__(self: _TVec, other: float) -> _TVec: ...
+    def __floordiv__(self: _TVec, other: float) -> _TVec: ...
+    def __neg__(self: _TVec) -> _TVec: ...
+    def __pos__(self: _TVec) -> _TVec: ...
+    def __bool__(self) -> bool: ...
+    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: Union[Sequence[float], _TVec]) -> float: ...
+    @overload
+    def __imul__(self: _TVec, other: float) -> _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: Union[Sequence[float], _TVec]) -> float: ...
+    def magnitude(self) -> float: ...
+    def magnitude_squared(self) -> float: ...
+    def length(self) -> float: ...
+    def length_squared(self) -> 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: 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: Union[Sequence[float], _TVec]
+    ) -> float: ...
+    def lerp(
+        self: _TVec,
+        other: Union[Sequence[float], _TVec],
+        value: float,
+    ) -> _TVec: ...
+    def slerp(
+        self: _TVec,
+        other: Union[Sequence[float], _TVec],
+        value: float,
+    ) -> _TVec: ...
+    def elementwise(self: _TVec) -> VectorElementwiseProxy[_TVec]: ...
+    def angle_to(self: _TVec, other: Union[Sequence[float], _TVec]) -> float: ...
+    def move_towards(
+        self: _TVec,
+        target: Union[Sequence[float], _TVec],
+        max_distance: float,
+    ) -> _TVec: ...
+    def move_towards_ip(
+        self: _TVec,
+        target: Union[Sequence[float], _TVec],
+        max_distance: float,
+    ) -> None: ...
+    @overload
+    def clamp_magnitude(self: _TVec, max_length: float) -> _TVec: ...
+    @overload
+    def clamp_magnitude(
+        self: _TVec, min_length: float, max_length: float
+    ) -> _TVec: ...
+    @overload
+    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: 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
+@final
+class VectorElementwiseProxy(Generic[_TVec]):
+    def __add__(
+        self,
+        other: Union[float, _TVec, VectorElementwiseProxy[_TVec]],
+    ) -> _TVec: ...
+    def __radd__(
+        self,
+        other: Union[float, _TVec, VectorElementwiseProxy[_TVec]],
+    ) -> _TVec: ...
+    def __sub__(
+        self,
+        other: Union[float, _TVec, VectorElementwiseProxy[_TVec]],
+    ) -> _TVec: ...
+    def __rsub__(
+        self,
+        other: Union[float, _TVec, VectorElementwiseProxy[_TVec]],
+    ) -> _TVec: ...
+    def __mul__(
+        self,
+        other: Union[float, _TVec, VectorElementwiseProxy[_TVec]],
+    ) -> _TVec: ...
+    def __rmul__(
+        self,
+        other: Union[float, _TVec, VectorElementwiseProxy[_TVec]],
+    ) -> _TVec: ...
+    def __truediv__(
+        self,
+        other: Union[float, _TVec, VectorElementwiseProxy[_TVec]],
+    ) -> _TVec: ...
+    def __rtruediv__(
+        self,
+        other: Union[float, _TVec, VectorElementwiseProxy[_TVec]],
+    ) -> _TVec: ...
+    def __floordiv__(
+        self,
+        other: Union[float, _TVec, VectorElementwiseProxy[_TVec]],
+    ) -> _TVec: ...
+    def __rfloordiv__(
+        self,
+        other: Union[float, _TVec, VectorElementwiseProxy[_TVec]],
+    ) -> _TVec: ...
+    def __mod__(
+        self,
+        other: Union[float, _TVec, VectorElementwiseProxy[_TVec]],
+    ) -> _TVec: ...
+    def __rmod__(
+        self,
+        other: Union[float, _TVec, VectorElementwiseProxy[_TVec]],
+    ) -> _TVec: ...
+    def __pow__(
+        self,
+        power: Union[float, _TVec, VectorElementwiseProxy[_TVec]],
+        mod: None = None,
+    ) -> _TVec: ...
+    def __rpow__(
+        self,
+        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: Union[float, _TVec, VectorElementwiseProxy[_TVec]],
+    ) -> bool: ...
+    def __lt__(
+        self,
+        other: Union[float, _TVec, VectorElementwiseProxy[_TVec]],
+    ) -> bool: ...
+    def __ge__(
+        self,
+        other: Union[float, _TVec, VectorElementwiseProxy[_TVec]],
+    ) -> bool: ...
+    def __le__(
+        self,
+        other: Union[float, _TVec, VectorElementwiseProxy[_TVec]],
+    ) -> bool: ...
+    def __abs__(self) -> _TVec: ...
+    def __neg__(self) -> _TVec: ...
+    def __pos__(self) -> _TVec: ...
+    def __bool__(self) -> bool: ...
+
+@final
+class VectorIterator:
+    def __length_hint__(self) -> int: ...
+    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
+    xx: Vector2
+    xy: Vector2
+    yx: Vector2
+    yy: Vector2
+    from_polar: _from_polar_protocol
+    @overload
+    def __init__(
+        self: _TVec,
+        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: ...
+    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: 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
+    z: float
+    xx: Vector2
+    xy: Vector2
+    xz: Vector2
+    yx: Vector2
+    yy: Vector2
+    yz: Vector2
+    zx: Vector2
+    zy: Vector2
+    zz: Vector2
+    xxx: Vector3
+    xxy: Vector3
+    xxz: Vector3
+    xyx: Vector3
+    xyy: Vector3
+    xyz: Vector3
+    xzx: Vector3
+    xzy: Vector3
+    xzz: Vector3
+    yxx: Vector3
+    yxy: Vector3
+    yxz: Vector3
+    yyx: Vector3
+    yyy: Vector3
+    yyz: Vector3
+    yzx: Vector3
+    yzy: Vector3
+    yzz: Vector3
+    zxx: Vector3
+    zxy: Vector3
+    zxz: Vector3
+    zyx: Vector3
+    zyy: Vector3
+    zyz: Vector3
+    zzx: Vector3
+    zzy: Vector3
+    zzz: Vector3
+    from_spherical: _from_spherical_protocol
+    @overload
+    def __init__(
+        self: _TVec,
+        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: Union[Sequence[float], _TVec]) -> _TVec: ...
+    def rotate(
+        self: _TVec, angle: float, axis: Union[Sequence[float], _TVec]
+    ) -> _TVec: ...
+    def rotate_rad(
+        self: _TVec, angle: float, axis: Union[Sequence[float], _TVec]
+    ) -> _TVec: ...
+    def rotate_ip(
+        self: _TVec, angle: float, axis: Union[Sequence[float], _TVec]
+    ) -> None: ...
+    def rotate_rad_ip(
+        self: _TVec, angle: float, axis: Union[Sequence[float], _TVec]
+    ) -> None: ...
+    def rotate_ip_rad(
+        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: ...
+    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: Union[str, float, Sequence[float], _TVec] = 0,
+    ) -> None: ...
+    @overload
+    def update(self, x: int, y: int, z: int) -> None: ...
+
+# typehints for deprecated functions, to be removed in a future version
+def enable_swizzling() -> None: ...
+def disable_swizzling() -> None: ...
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/midi.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/midi.py
new file mode 100644
index 0000000..24830f6
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/midi.py
@@ -0,0 +1,717 @@
+"""pygame.midi
+pygame module for interacting with midi input and output.
+
+The midi module can send output to midi devices, and get input
+from midi devices.  It can also list midi devices on the system.
+
+Including real midi devices, and virtual ones.
+
+It uses the portmidi library.  Is portable to which ever platforms
+portmidi supports (currently windows, OSX, and linux).
+
+This uses pyportmidi for now, but may use its own bindings at some
+point in the future.  The pyportmidi bindings are included with pygame.
+
+New in pygame 1.9.0.
+"""
+
+# TODO: finish writing tests.
+#        - likely as interactive tests... so you'd need to plug in
+#          a midi device.
+# TODO: create a background thread version for input threads.
+#        - that can automatically inject input into the event queue
+#          once the input object is running.  Like joysticks.
+
+import math
+import atexit
+
+import pygame
+import pygame.locals
+
+import pygame.pypm as _pypm
+
+# For backward compatibility.
+MIDIIN = pygame.locals.MIDIIN
+MIDIOUT = pygame.locals.MIDIOUT
+
+__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",
+]
+
+__theclasses__ = ["Input", "Output"]
+
+
+def _module_init(state=None):
+    # this is a sneaky dodge to store module level state in a non-public
+    # function. Helps us dodge using globals.
+    if state is not None:
+        _module_init.value = state
+        return state
+
+    try:
+        _module_init.value
+    except AttributeError:
+        return False
+    return _module_init.value
+
+
+def init():
+    """initialize the midi module
+    pygame.midi.init(): return None
+
+    Call the initialisation function before using the midi module.
+
+    It is safe to call this more than once.
+    """
+    if not _module_init():
+        _pypm.Initialize()
+        _module_init(True)
+        atexit.register(quit)
+
+
+def quit():  # pylint: disable=redefined-builtin
+    """uninitialize the midi module
+    pygame.midi.quit(): return None
+
+
+    Called automatically atexit if you don't call it.
+
+    It is safe to call this function more than once.
+    """
+    if _module_init():
+        # TODO: find all Input and Output classes and close them first?
+        _pypm.Terminate()
+        _module_init(False)
+
+
+def get_init():
+    """returns True if the midi module is currently initialized
+    pygame.midi.get_init(): return bool
+
+    Returns True if the pygame.midi module is currently initialized.
+
+    New in pygame 1.9.5.
+    """
+    return _module_init()
+
+
+def _check_init():
+    if not _module_init():
+        raise RuntimeError("pygame.midi not initialised.")
+
+
+def get_count():
+    """gets the number of devices.
+    pygame.midi.get_count(): return num_devices
+
+
+    Device ids range from 0 to get_count() -1
+    """
+    _check_init()
+    return _pypm.CountDevices()
+
+
+def get_default_input_id():
+    """gets default input device number
+    pygame.midi.get_default_input_id(): return default_id
+
+
+    Return the default device ID or -1 if there are no devices.
+    The result can be passed to the Input()/Output() class.
+
+    On the PC, the user can specify a default device by
+    setting an environment variable. For example, to use device #1.
+
+        set PM_RECOMMENDED_INPUT_DEVICE=1
+
+    The user should first determine the available device ID by using
+    the supplied application "testin" or "testout".
+
+    In general, the registry is a better place for this kind of info,
+    and with USB devices that can come and go, using integers is not
+    very reliable for device identification. Under Windows, if
+    PM_RECOMMENDED_OUTPUT_DEVICE (or PM_RECOMMENDED_INPUT_DEVICE) is
+    *NOT* found in the environment, then the default device is obtained
+    by looking for a string in the registry under:
+        HKEY_LOCAL_MACHINE/SOFTWARE/PortMidi/Recommended_Input_Device
+    and HKEY_LOCAL_MACHINE/SOFTWARE/PortMidi/Recommended_Output_Device
+    for a string. The number of the first device with a substring that
+    matches the string exactly is returned. For example, if the string
+    in the registry is "USB", and device 1 is named
+    "In USB MidiSport 1x1", then that will be the default
+    input because it contains the string "USB".
+
+    In addition to the name, get_device_info() returns "interf", which
+    is the interface name. (The "interface" is the underlying software
+    system or API used by PortMidi to access devices. Examples are
+    MMSystem, DirectX (not implemented), ALSA, OSS (not implemented), etc.)
+    At present, the only Win32 interface is "MMSystem", the only Linux
+    interface is "ALSA", and the only Max OS X interface is "CoreMIDI".
+    To specify both the interface and the device name in the registry,
+    separate the two with a comma and a space, e.g.:
+        MMSystem, In USB MidiSport 1x1
+    In this case, the string before the comma must be a substring of
+    the "interf" string, and the string after the space must be a
+    substring of the "name" name string in order to match the device.
+
+    Note: in the current release, the default is simply the first device
+    (the input or output device with the lowest PmDeviceID).
+    """
+    _check_init()
+    return _pypm.GetDefaultInputDeviceID()
+
+
+def get_default_output_id():
+    """gets default output device number
+    pygame.midi.get_default_output_id(): return default_id
+
+
+    Return the default device ID or -1 if there are no devices.
+    The result can be passed to the Input()/Output() class.
+
+    On the PC, the user can specify a default device by
+    setting an environment variable. For example, to use device #1.
+
+        set PM_RECOMMENDED_OUTPUT_DEVICE=1
+
+    The user should first determine the available device ID by using
+    the supplied application "testin" or "testout".
+
+    In general, the registry is a better place for this kind of info,
+    and with USB devices that can come and go, using integers is not
+    very reliable for device identification. Under Windows, if
+    PM_RECOMMENDED_OUTPUT_DEVICE (or PM_RECOMMENDED_INPUT_DEVICE) is
+    *NOT* found in the environment, then the default device is obtained
+    by looking for a string in the registry under:
+        HKEY_LOCAL_MACHINE/SOFTWARE/PortMidi/Recommended_Input_Device
+    and HKEY_LOCAL_MACHINE/SOFTWARE/PortMidi/Recommended_Output_Device
+    for a string. The number of the first device with a substring that
+    matches the string exactly is returned. For example, if the string
+    in the registry is "USB", and device 1 is named
+    "In USB MidiSport 1x1", then that will be the default
+    input because it contains the string "USB".
+
+    In addition to the name, get_device_info() returns "interf", which
+    is the interface name. (The "interface" is the underlying software
+    system or API used by PortMidi to access devices. Examples are
+    MMSystem, DirectX (not implemented), ALSA, OSS (not implemented), etc.)
+    At present, the only Win32 interface is "MMSystem", the only Linux
+    interface is "ALSA", and the only Max OS X interface is "CoreMIDI".
+    To specify both the interface and the device name in the registry,
+    separate the two with a comma and a space, e.g.:
+        MMSystem, In USB MidiSport 1x1
+    In this case, the string before the comma must be a substring of
+    the "interf" string, and the string after the space must be a
+    substring of the "name" name string in order to match the device.
+
+    Note: in the current release, the default is simply the first device
+    (the input or output device with the lowest PmDeviceID).
+    """
+    _check_init()
+    return _pypm.GetDefaultOutputDeviceID()
+
+
+def get_device_info(an_id):
+    """returns information about a midi device
+    pygame.midi.get_device_info(an_id): return (interf, name,
+                                                input, output,
+                                                opened)
+
+    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.
+
+    If the id is out of range, the function returns None.
+    """
+    _check_init()
+    return _pypm.GetDeviceInfo(an_id)
+
+
+class Input:
+    """Input is used to get midi input from midi devices.
+    Input(device_id)
+    Input(device_id, buffer_size)
+
+    buffer_size - the number of input events to be buffered waiting to
+      be read using Input.read()
+    """
+
+    def __init__(self, device_id, buffer_size=4096):
+        """
+        The buffer_size specifies the number of input events to be buffered
+        waiting to be read using Input.read().
+        """
+        _check_init()
+
+        if device_id == -1:
+            raise MidiException(
+                "Device id is -1, not a valid output id.  "
+                "-1 usually means there were no default "
+                "Output devices."
+            )
+
+        try:
+            result = get_device_info(device_id)
+        except TypeError:
+            raise TypeError("an integer is required")
+        except OverflowError:
+            raise OverflowError("long int too large to convert to int")
+
+        # and now some nasty looking error checking, to provide nice error
+        #   messages to the kind, lovely, midi using people of wherever.
+        if result:
+            _, _, is_input, is_output, _ = result
+            if is_input:
+                try:
+                    self._input = _pypm.Input(device_id, buffer_size)
+                except TypeError:
+                    raise TypeError("an integer is required")
+                self.device_id = device_id
+
+            elif is_output:
+                raise MidiException(
+                    "Device id given is not a valid input id, it is an output id."
+                )
+            else:
+                raise MidiException("Device id given is not a valid input id.")
+        else:
+            raise MidiException("Device id invalid, out of range.")
+
+    def _check_open(self):
+        if self._input is None:
+            raise MidiException("midi not open.")
+
+    def close(self):
+        """closes a midi stream, flushing any pending buffers.
+        Input.close(): return None
+
+        PortMidi attempts to close open streams when the application
+        exits -- this is particularly difficult under Windows.
+        """
+        _check_init()
+        if self._input is not None:
+            self._input.Close()
+        self._input = None
+
+    def read(self, num_events):
+        """reads num_events midi events from the buffer.
+        Input.read(num_events): return midi_event_list
+
+        Reads from the Input buffer and gives back midi events.
+        [[[status,data1,data2,data3],timestamp],
+         [[status,data1,data2,data3],timestamp],...]
+        """
+        _check_init()
+        self._check_open()
+        return self._input.Read(num_events)
+
+    def poll(self):
+        """returns true if there's data, or false if not.
+        Input.poll(): return Bool
+
+        raises a MidiException on error.
+        """
+        _check_init()
+        self._check_open()
+
+        result = self._input.Poll()
+        if result == _pypm.TRUE:
+            return True
+
+        if result == _pypm.FALSE:
+            return False
+
+        err_text = _pypm.GetErrorText(result)
+        raise MidiException((result, err_text))
+
+
+class Output:
+    """Output is used to send midi to an output device
+    Output(device_id)
+    Output(device_id, latency = 0)
+    Output(device_id, buffer_size = 4096)
+    Output(device_id, latency, buffer_size)
+
+    The buffer_size specifies the number of output events to be
+    buffered waiting for output.  (In some cases -- see below --
+    PortMidi does not buffer output at all and merely passes data
+    to a lower-level API, in which case buffersize is ignored.)
+
+    latency is the delay in milliseconds applied to timestamps to determine
+    when the output should actually occur. (If latency is < 0, 0 is
+    assumed.)
+
+    If latency is zero, timestamps are ignored and all output is delivered
+    immediately. If latency is greater than zero, output is delayed until
+    the message timestamp plus the latency. (NOTE: time is measured
+    relative to the time source indicated by time_proc. Timestamps are
+    absolute, not relative delays or offsets.) In some cases, PortMidi
+    can obtain better timing than your application by passing timestamps
+    along to the device driver or hardware. Latency may also help you
+    to synchronize midi data to audio data by matching midi latency to
+    the audio buffer latency.
+
+    """
+
+    def __init__(self, device_id, latency=0, buffer_size=256):
+        """Output(device_id)
+        Output(device_id, latency = 0)
+        Output(device_id, buffer_size = 4096)
+        Output(device_id, latency, buffer_size)
+
+        The buffer_size specifies the number of output events to be
+        buffered waiting for output.  (In some cases -- see below --
+        PortMidi does not buffer output at all and merely passes data
+        to a lower-level API, in which case buffersize is ignored.)
+
+        latency is the delay in milliseconds applied to timestamps to determine
+        when the output should actually occur. (If latency is < 0, 0 is
+        assumed.)
+
+        If latency is zero, timestamps are ignored and all output is delivered
+        immediately. If latency is greater than zero, output is delayed until
+        the message timestamp plus the latency. (NOTE: time is measured
+        relative to the time source indicated by time_proc. Timestamps are
+        absolute, not relative delays or offsets.) In some cases, PortMidi
+        can obtain better timing than your application by passing timestamps
+        along to the device driver or hardware. Latency may also help you
+        to synchronize midi data to audio data by matching midi latency to
+        the audio buffer latency.
+        """
+
+        _check_init()
+        self._aborted = 0
+
+        if device_id == -1:
+            raise MidiException(
+                "Device id is -1, not a valid output id."
+                "  -1 usually means there were no default "
+                "Output devices."
+            )
+
+        try:
+            result = get_device_info(device_id)
+        except TypeError:
+            raise TypeError("an integer is required")
+        except OverflowError:
+            raise OverflowError("long int too large to convert to int")
+
+        # and now some nasty looking error checking, to provide nice error
+        #   messages to the kind, lovely, midi using people of wherever.
+        if result:
+            _, _, is_input, is_output, _ = result
+            if is_output:
+                try:
+                    self._output = _pypm.Output(device_id, latency, buffer_size)
+                except TypeError:
+                    raise TypeError("an integer is required")
+                self.device_id = device_id
+
+            elif is_input:
+                raise MidiException(
+                    "Device id given is not a valid output id, it is an input id."
+                )
+            else:
+                raise MidiException("Device id given is not a valid output id.")
+        else:
+            raise MidiException("Device id invalid, out of range.")
+
+    def _check_open(self):
+        if self._output is None:
+            raise MidiException("midi not open.")
+
+        if self._aborted:
+            raise MidiException("midi aborted.")
+
+    def close(self):
+        """closes a midi stream, flushing any pending buffers.
+        Output.close(): return None
+
+        PortMidi attempts to close open streams when the application
+        exits -- this is particularly difficult under Windows.
+        """
+        _check_init()
+        if self._output is not None:
+            self._output.Close()
+        self._output = None
+
+    def abort(self):
+        """terminates outgoing messages immediately
+        Output.abort(): return None
+
+        The caller should immediately close the output port;
+        this call may result in transmission of a partial midi message.
+        There is no abort for Midi input because the user can simply
+        ignore messages in the buffer and close an input device at
+        any time.
+        """
+
+        _check_init()
+        if self._output:
+            self._output.Abort()
+        self._aborted = 1
+
+    def write(self, data):
+        """writes a list of midi data to the Output
+        Output.write(data)
+
+        writes series of MIDI information in the form of a list:
+             write([[[status <,data1><,data2><,data3>],timestamp],
+                    [[status <,data1><,data2><,data3>],timestamp],...])
+         fields are optional
+        example: choose program change 1 at time 20000 and
+        send note 65 with velocity 100 500 ms later.
+             write([[[0xc0,0,0],20000],[[0x90,60,100],20500]])
+        notes:
+          1. timestamps will be ignored if latency = 0.
+          2. To get a note to play immediately, send MIDI info with
+             timestamp read from function Time.
+          3. understanding optional data fields:
+               write([[[0xc0,0,0],20000]]) is equivalent to
+               write([[[0xc0],20000]])
+
+        Can send up to 1024 elements in your data list, otherwise an
+         IndexError exception is raised.
+        """
+        _check_init()
+        self._check_open()
+
+        self._output.Write(data)
+
+    def write_short(self, status, data1=0, data2=0):
+        """write_short(status <, data1><, data2>)
+        Output.write_short(status)
+        Output.write_short(status, data1 = 0, data2 = 0)
+
+        output MIDI information of 3 bytes or less.
+        data fields are optional
+        status byte could be:
+             0xc0 = program change
+             0x90 = note on
+             etc.
+             data bytes are optional and assumed 0 if omitted
+        example: note 65 on with velocity 100
+             write_short(0x90,65,100)
+        """
+        _check_init()
+        self._check_open()
+        self._output.WriteShort(status, data1, data2)
+
+    def write_sys_ex(self, when, msg):
+        """writes a timestamped system-exclusive midi message.
+        Output.write_sys_ex(when, msg)
+
+        msg - can be a *list* or a *string*
+        when - a timestamp in milliseconds
+        example:
+          (assuming o is an onput MIDI stream)
+            o.write_sys_ex(0,'\\xF0\\x7D\\x10\\x11\\x12\\x13\\xF7')
+          is equivalent to
+            o.write_sys_ex(pygame.midi.time(),
+                           [0xF0,0x7D,0x10,0x11,0x12,0x13,0xF7])
+        """
+        _check_init()
+        self._check_open()
+        self._output.WriteSysEx(when, msg)
+
+    def note_on(self, note, velocity, channel=0):
+        """turns a midi note on.  Note must be off.
+        Output.note_on(note, velocity, channel=0)
+
+        note is an integer from 0 to 127
+        velocity is an integer from 0 to 127
+        channel is an integer from 0 to 15
+
+        Turn a note on in the output stream.  The note must already
+        be off for this to work correctly.
+        """
+        if not 0 <= channel <= 15:
+            raise ValueError("Channel not between 0 and 15.")
+
+        self.write_short(0x90 + channel, note, velocity)
+
+    def note_off(self, note, velocity=0, channel=0):
+        """turns a midi note off.  Note must be on.
+        Output.note_off(note, velocity=0, channel=0)
+
+        note is an integer from 0 to 127
+        velocity is an integer from 0 to 127 (release velocity)
+        channel is an integer from 0 to 15
+
+        Turn a note off in the output stream.  The note must already
+        be on for this to work correctly.
+        """
+        if not 0 <= channel <= 15:
+            raise ValueError("Channel not between 0 and 15.")
+
+        self.write_short(0x80 + channel, note, velocity)
+
+    def set_instrument(self, instrument_id, channel=0):
+        """select an instrument for a channel, with a value between 0 and 127
+        Output.set_instrument(instrument_id, channel=0)
+
+        Also called "patch change" or "program change".
+        """
+        if not 0 <= instrument_id <= 127:
+            raise ValueError(f"Undefined instrument id: {instrument_id}")
+
+        if not 0 <= channel <= 15:
+            raise ValueError("Channel not between 0 and 15.")
+
+        self.write_short(0xC0 + channel, instrument_id)
+
+    def pitch_bend(self, value=0, channel=0):
+        """modify the pitch of a channel.
+        Output.pitch_bend(value=0, channel=0)
+
+        Adjust the pitch of a channel.  The value is a signed integer
+        from -8192 to +8191.  For example, 0 means "no change", +4096 is
+        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".
+        """
+        if not 0 <= channel <= 15:
+            raise ValueError("Channel not between 0 and 15.")
+
+        if not -8192 <= value <= 8191:
+            raise ValueError(
+                f"Pitch bend value must be between -8192 and +8191, not {value}."
+            )
+
+        # "The 14 bit value of the pitch bend is defined so that a value of
+        # 0x2000 is the center corresponding to the normal pitch of the note
+        # (no pitch change)." so value=0 should send 0x2000
+        value = value + 0x2000
+        lsb = value & 0x7F  # keep least 7 bits
+        msb = value >> 7
+        self.write_short(0xE0 + channel, lsb, msb)
+
+
+# MIDI commands
+#
+#    0x80     Note Off    (note_off)
+#    0x90     Note On     (note_on)
+#    0xA0     Aftertouch
+#    0xB0     Continuous controller
+#    0xC0     Patch change    (set_instrument?)
+#    0xD0     Channel Pressure
+#    0xE0     Pitch bend
+#    0xF0     (non-musical commands)
+
+
+def time():
+    """returns the current time in ms of the PortMidi timer
+    pygame.midi.time(): return time
+
+    The time is reset to 0, when the module is inited.
+    """
+    _check_init()
+    return _pypm.Time()
+
+
+def midis2events(midis, device_id):
+    """converts midi events to pygame events
+    pygame.midi.midis2events(midis, device_id): return [Event, ...]
+
+    Takes a sequence of midi events and returns list of pygame events.
+    """
+    evs = []
+    for midi in midis:
+        ((status, data1, data2, data3), timestamp) = midi
+
+        event = pygame.event.Event(
+            MIDIIN,
+            status=status,
+            data1=data1,
+            data2=data2,
+            data3=data3,
+            timestamp=timestamp,
+            vice_id=device_id,
+        )
+        evs.append(event)
+
+    return evs
+
+
+class MidiException(Exception):
+    """exception that pygame.midi functions and classes can raise
+    MidiException(errno)
+    """
+
+    def __init__(self, value):
+        super().__init__(value)
+        self.parameter = value
+
+    def __str__(self):
+        return repr(self.parameter)
+
+
+def frequency_to_midi(frequency):
+    """converts a frequency into a MIDI note.
+
+    Rounds to the closest midi note.
+
+    ::Examples::
+
+    >>> frequency_to_midi(27.5)
+    21
+    >>> frequency_to_midi(36.7)
+    26
+    >>> frequency_to_midi(4186.0)
+    108
+    """
+    return int(round(69 + (12 * math.log(frequency / 440.0)) / math.log(2)))
+
+
+def midi_to_frequency(midi_note):
+    """Converts a midi note to a frequency.
+
+    ::Examples::
+
+    >>> midi_to_frequency(21)
+    27.5
+    >>> midi_to_frequency(26)
+    36.7
+    >>> midi_to_frequency(108)
+    4186.0
+    """
+    return round(440.0 * 2 ** ((midi_note - 69) * (1.0 / 12.0)), 1)
+
+
+def midi_to_ansi_note(midi_note):
+    """returns the Ansi Note name for a midi number.
+
+    ::Examples::
+
+    >>> midi_to_ansi_note(21)
+    'A0'
+    >>> midi_to_ansi_note(102)
+    'F#7'
+    >>> midi_to_ansi_note(108)
+    'C8'
+    """
+    notes = ["A", "A#", "B", "C", "C#", "D", "D#", "E", "F", "F#", "G", "G#"]
+    num_notes = 12
+    note_name = notes[int((midi_note - 21) % num_notes)]
+    note_number = (midi_note - 12) // num_notes
+    return f"{note_name}{note_number}"
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/midi.pyi b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/midi.pyi
new file mode 100644
index 0000000..ee383ef
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/midi.pyi
@@ -0,0 +1,49 @@
+from typing import List, Sequence, Tuple, Union
+
+from pygame.event import Event
+
+MIDIIN: int
+MIDIOUT: int
+
+class MidiException(Exception):
+    def __init__(self, value: str) -> None: ...
+
+def init() -> None: ...
+def quit() -> None: ...
+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[bytes, bytes, int, int, int]: ...
+def midis2events(
+    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: ...
+def midi_to_ansi_note(midi_note: int) -> str: ...
+
+class Input:
+    device_id: int
+    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[Union[List[int], int]]]: ...
+
+class Output:
+    device_id: int
+    def __init__(
+        self,
+        device_id: int,
+        latency: int = 0,
+        buffer_size: int = 256,
+    ) -> None: ...
+    def abort(self) -> None: ...
+    def close(self) -> None: ...
+    def note_off(self, note: int, velocity: int = 0, channel: int = 0) -> None: ...
+    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: 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: Union[List[int], str]) -> None: ...
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/mixer.cpython-312-darwin.so b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/mixer.cpython-312-darwin.so
new file mode 100755
index 0000000..739971d
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/mixer.cpython-312-darwin.so differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/mixer.pyi b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/mixer.pyi
new file mode 100644
index 0000000..5b0e13a
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/mixer.pyi
@@ -0,0 +1,98 @@
+from typing import Any, Dict, Optional, Tuple, Union, final, overload
+
+import numpy
+
+from pygame.event import Event
+
+from . import mixer_music
+from ._common import FileArg
+
+# export mixer_music as mixer.music
+music = mixer_music
+
+def init(
+    frequency: int = 44100,
+    size: int = -16,
+    channels: int = 2,
+    buffer: int = 512,
+    devicename: Optional[str] = None,
+    allowedchanges: int = 5,
+) -> None: ...
+def pre_init(
+    frequency: int = 44100,
+    size: int = -16,
+    channels: int = 2,
+    buffer: int = 512,
+    devicename: Optional[str] = None,
+    allowedchanges: int = 5,
+) -> None: ...
+def quit() -> None: ...
+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 get_num_channels() -> int: ...
+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]: ...
+
+class Sound:
+    @overload
+    def __init__(self, file: FileArg) -> None: ...
+    @overload
+    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,
+        maxtime: int = 0,
+        fade_ms: int = 0,
+    ) -> Channel: ...
+    # possibly going to be deprecated/removed soon, in which case these
+    # typestubs must be removed too
+    __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 get_volume(self) -> float: ...
+    def get_num_channels(self) -> int: ...
+    def get_length(self) -> float: ...
+    def get_raw(self) -> bytes: ...
+
+@final
+class Channel:
+    def __init__(self, id: int) -> None: ...
+    def play(
+        self,
+        sound: Sound,
+        loops: int = 0,
+        maxtime: int = 0,
+        fade_ms: int = 0,
+    ) -> None: ...
+    def stop(self) -> None: ...
+    def pause(self) -> None: ...
+    def unpause(self) -> None: ...
+    def fadeout(self, time: int) -> None: ...
+    def queue(self, sound: Sound) -> None: ...
+    @overload
+    def set_volume(self, value: float) -> None: ...
+    @overload
+    def set_volume(self, left: float, right: float) -> None: ...
+    def get_volume(self) -> float: ...
+    def get_busy(self) -> bool: ...
+    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: ...
+
+SoundType = Sound
+ChannelType = Channel
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/mixer_music.cpython-312-darwin.so b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/mixer_music.cpython-312-darwin.so
new file mode 100755
index 0000000..21d617e
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/mixer_music.cpython-312-darwin.so differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/mixer_music.pyi b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/mixer_music.pyi
new file mode 100644
index 0000000..0c0f198
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/mixer_music.pyi
@@ -0,0 +1,20 @@
+from typing import Optional
+
+from ._common import FileArg
+
+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 get_volume() -> float: ...
+def get_busy() -> bool: ...
+def set_pos(pos: float) -> None: ...
+def get_pos() -> int: ...
+def queue(filename: FileArg, namehint: str = "", loops: int = 0) -> None: ...
+def set_endevent(event_type: int) -> None: ...
+def get_endevent() -> int: ...
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/mouse.cpython-312-darwin.so b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/mouse.cpython-312-darwin.so
new file mode 100755
index 0000000..8e84e98
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/mouse.cpython-312-darwin.so differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/mouse.pyi b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/mouse.pyi
new file mode 100644
index 0000000..088f2ea
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/mouse.pyi
@@ -0,0 +1,35 @@
+from typing import Sequence, Tuple, Union, overload
+from typing_extensions import Literal
+from pygame.cursors import Cursor
+from pygame.surface import Surface
+
+@overload
+def get_pressed(num_buttons: Literal[3] = 3) -> Tuple[bool, bool, bool]: ...
+@overload
+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: Union[Sequence[float], Tuple[float, float]]) -> None: ...
+@overload
+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: 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: Union[Tuple[int, int], Sequence[int]], surface: Surface
+) -> None: ...
+def get_cursor() -> Cursor: ...
+def set_system_cursor(cursor: int) -> None: ...
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/newbuffer.cpython-312-darwin.so b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/newbuffer.cpython-312-darwin.so
new file mode 100755
index 0000000..801a928
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/newbuffer.cpython-312-darwin.so differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/pixelarray.cpython-312-darwin.so b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/pixelarray.cpython-312-darwin.so
new file mode 100755
index 0000000..aa8a497
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/pixelarray.cpython-312-darwin.so differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/pixelarray.pyi b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/pixelarray.pyi
new file mode 100644
index 0000000..a4c3e9d
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/pixelarray.pyi
@@ -0,0 +1,41 @@
+from typing import Any, Dict, Sequence, Tuple
+
+from pygame.surface import Surface
+
+from ._common import ColorValue
+
+class PixelArray:
+    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
+    __array_interface__: Dict[str, Any]
+    __array_struct__: Any
+    def __init__(self, surface: Surface) -> None: ...
+    def __enter__(self) -> PixelArray: ...
+    def __exit__(self, *args, **kwargs) -> None: ...
+    def make_surface(self) -> Surface: ...
+    def replace(
+        self,
+        color: ColorValue,
+        repcolor: ColorValue,
+        distance: float = 0,
+        weights: Sequence[float] = (0.299, 0.587, 0.114),
+    ) -> None: ...
+    def extract(
+        self,
+        color: ColorValue,
+        distance: float = 0,
+        weights: Sequence[float] = (0.299, 0.587, 0.114),
+    ) -> PixelArray: ...
+    def compare(
+        self,
+        array: PixelArray,
+        distance: float = 0,
+        weights: Sequence[float] = (0.299, 0.587, 0.114),
+    ) -> PixelArray: ...
+    def transpose(self) -> PixelArray: ...
+    def close(self) -> PixelArray: ...
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/pixelcopy.cpython-312-darwin.so b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/pixelcopy.cpython-312-darwin.so
new file mode 100755
index 0000000..2e7f3f9
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/pixelcopy.cpython-312-darwin.so differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/pixelcopy.pyi b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/pixelcopy.pyi
new file mode 100644
index 0000000..8bcbe89
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/pixelcopy.pyi
@@ -0,0 +1,20 @@
+import numpy
+
+from pygame.surface import Surface
+
+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",
+    opaque: int = 255,
+    clear: int = 0,
+) -> None: ...
+def array_to_surface(surface: Surface, array: numpy.ndarray) -> None: ...
+def map_array(
+    array1: numpy.ndarray, array2: numpy.ndarray, surface: Surface
+) -> None: ...
+def make_surface(array: numpy.ndarray) -> Surface: ...
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/pkgdata.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/pkgdata.py
new file mode 100644
index 0000000..767cbdf
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/pkgdata.py
@@ -0,0 +1,77 @@
+"""
+pkgdata is a simple, extensible way for a package to acquire data file
+resources.
+
+The getResource function is equivalent to the standard idioms, such as
+the following minimal implementation:
+
+    import sys, os
+
+    def getResource(identifier, pkgname=__name__):
+        pkgpath = os.path.dirname(sys.modules[pkgname].__file__)
+        path = os.path.join(pkgpath, identifier)
+        return file(os.path.normpath(path), mode='rb')
+
+When a __loader__ is present on the module given by __name__, it will defer
+getResource to its get_data implementation and return it as a file-like
+object (such as StringIO).
+"""
+
+__all__ = ["getResource"]
+import sys
+import os
+
+try:
+    from pkg_resources import resource_stream, resource_exists
+except ImportError:
+
+    def resource_exists(_package_or_requirement, _resource_name):
+        """
+        A stub for when we fail to import this function.
+
+        :return: Always returns False
+        """
+        return False
+
+    def resource_stream(_package_of_requirement, _resource_name):
+        """
+        A stub for when we fail to import this function.
+
+        Always raises a NotImplementedError when called.
+        """
+        raise NotImplementedError
+
+
+def getResource(identifier, pkgname=__name__):
+    """
+    Acquire a readable object for a given package name and identifier.
+    An IOError will be raised if the resource can not be found.
+
+    For example:
+        mydata = getResource('mypkgdata.jpg').read()
+
+    Note that the package name must be fully qualified, if given, such
+    that it would be found in sys.modules.
+
+    In some cases, getResource will return a real file object.  In that
+    case, it may be useful to use its name attribute to get the path
+    rather than use it as a file-like object.  For example, you may
+    be handing data off to a C API.
+    """
+
+    # When pyinstaller (or similar tools) are used, resource_exists may raise
+    # NotImplemented error
+    try:
+        if resource_exists(pkgname, identifier):
+            return resource_stream(pkgname, identifier)
+    except NotImplementedError:
+        pass
+
+    mod = sys.modules[pkgname]
+    path_to_file = getattr(mod, "__file__", None)
+    if path_to_file is None:
+        raise OSError(f"{repr(mod)} has no __file__!")
+    path = os.path.join(os.path.dirname(path_to_file), identifier)
+
+    # pylint: disable=consider-using-with
+    return open(os.path.normpath(path), "rb")
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/py.typed b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/py.typed
new file mode 100644
index 0000000..e69de29
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/pygame.ico b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/pygame.ico
new file mode 100644
index 0000000..06f699e
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/pygame.ico differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/pygame_icon.bmp b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/pygame_icon.bmp
new file mode 100644
index 0000000..74aea77
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/pygame_icon.bmp differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/pygame_icon.icns b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/pygame_icon.icns
new file mode 100644
index 0000000..44a67bb
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/pygame_icon.icns differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/pygame_icon_mac.bmp b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/pygame_icon_mac.bmp
new file mode 100644
index 0000000..7b58bb1
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/pygame_icon_mac.bmp differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/pypm.cpython-312-darwin.so b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/pypm.cpython-312-darwin.so
new file mode 100755
index 0000000..176cc9b
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/pypm.cpython-312-darwin.so differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/rect.cpython-312-darwin.so b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/rect.cpython-312-darwin.so
new file mode 100755
index 0000000..f3ba1d4
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/rect.cpython-312-darwin.so differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/rect.pyi b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/rect.pyi
new file mode 100644
index 0000000..52f79cc
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/rect.pyi
@@ -0,0 +1,208 @@
+import sys
+from typing import (
+    Dict,
+    Iterator,
+    List,
+    Sequence,
+    Tuple,
+    TypeVar,
+    Union,
+    overload,
+    Callable,
+    Any,
+    Optional,
+)
+
+from ._common import Coordinate, Literal, RectValue
+
+if sys.version_info >= (3, 9):
+    from collections.abc import Collection
+else:
+    from typing import Collection
+
+_K = TypeVar("_K")
+_V = TypeVar("_V")
+_T = TypeVar("_T")
+
+# Rect confirms to the Collection ABC, since it also confirms to
+# Sized, Iterable and Container ABCs
+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"]]: ...
+
+RectType = Rect
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/rwobject.cpython-312-darwin.so b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/rwobject.cpython-312-darwin.so
new file mode 100755
index 0000000..657ecd8
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/rwobject.cpython-312-darwin.so differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/rwobject.pyi b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/rwobject.pyi
new file mode 100644
index 0000000..3688279
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/rwobject.pyi
@@ -0,0 +1,18 @@
+from typing import Any, Optional, overload, Type
+
+from ._common import AnyPath
+
+def encode_string(
+    obj: Optional[AnyPath],
+    encoding: Optional[str] = "unicode_escape",
+    errors: Optional[str] = "backslashreplace",
+    etype: Optional[Type[Exception]] = UnicodeEncodeError,
+) -> bytes: ...
+@overload
+def encode_file_path(
+    obj: Optional[AnyPath], etype: Optional[Type[Exception]] = UnicodeEncodeError
+) -> bytes: ...
+@overload
+def encode_file_path(
+    obj: Any, etype: Optional[Type[Exception]] = UnicodeEncodeError
+) -> bytes: ...
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/scrap.cpython-312-darwin.so b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/scrap.cpython-312-darwin.so
new file mode 100755
index 0000000..5cb1442
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/scrap.cpython-312-darwin.so differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/scrap.pyi b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/scrap.pyi
new file mode 100644
index 0000000..762c36f
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/scrap.pyi
@@ -0,0 +1,11 @@
+from typing import List, Optional
+from collections.abc import ByteString
+
+def init() -> None: ...
+def get_init() -> bool: ...
+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: ...
+def set_mode(mode: int) -> None: ...
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/sdlmain_osx.cpython-312-darwin.so b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/sdlmain_osx.cpython-312-darwin.so
new file mode 100755
index 0000000..23f1134
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/sdlmain_osx.cpython-312-darwin.so differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/sndarray.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/sndarray.py
new file mode 100644
index 0000000..99ac4c7
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/sndarray.py
@@ -0,0 +1,139 @@
+##    pygame - Python Game Library
+##    Copyright (C) 2008 Marcus von Appen
+##
+##    This library is free software; you can redistribute it and/or
+##    modify it under the terms of the GNU Library General Public
+##    License as published by the Free Software Foundation; either
+##    version 2 of the License, or (at your option) any later version.
+##
+##    This library is distributed in the hope that it will be useful,
+##    but WITHOUT ANY WARRANTY; without even the implied warranty of
+##    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+##    Library General Public License for more details.
+##
+##    You should have received a copy of the GNU Library General Public
+##    License along with this library; if not, write to the Free
+##    Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
+##
+##    Marcus von Appen
+##    mva@sysfault.org
+
+"""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.
+
+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.
+
+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
+
+
+__all__ = [
+    "array",
+    "samples",
+    "make_sound",
+    "use_arraytype",
+    "get_arraytype",
+    "get_arraytypes",
+]
+
+
+def array(sound):
+    """pygame.sndarray.array(Sound): return array
+
+    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().
+    """
+
+    return numpy.array(sound, copy=True)
+
+
+def samples(sound):
+    """pygame.sndarray.samples(Sound): return array
+
+    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().
+    """
+
+    return numpy.array(sound, copy=False)
+
+
+def make_sound(array):
+    """pygame.sndarray.make_sound(array): return 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.
+    """
+
+    return mixer.Sound(array=array)
+
+
+def use_arraytype(arraytype):
+    """pygame.sndarray.use_arraytype(arraytype): return None
+
+    DEPRECATED - only numpy arrays are now supported.
+    """
+    warnings.warn(
+        DeprecationWarning(
+            "only numpy arrays are now supported, "
+            "this function will be removed in a "
+            "future version of the module"
+        )
+    )
+    arraytype = arraytype.lower()
+    if arraytype != "numpy":
+        raise ValueError("invalid array type")
+
+
+def get_arraytype():
+    """pygame.sndarray.get_arraytype(): return str
+
+    DEPRECATED - only numpy arrays are now supported.
+    """
+    warnings.warn(
+        DeprecationWarning(
+            "only numpy arrays are now supported, "
+            "this function will be removed in a "
+            "future version of the module"
+        )
+    )
+    return "numpy"
+
+
+def get_arraytypes():
+    """pygame.sndarray.get_arraytypes(): return tuple
+
+    DEPRECATED - only numpy arrays are now supported.
+    """
+    warnings.warn(
+        DeprecationWarning(
+            "only numpy arrays are now supported, "
+            "this function will be removed in a "
+            "future version of the module"
+        )
+    )
+    return ("numpy",)
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/sndarray.pyi b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/sndarray.pyi
new file mode 100644
index 0000000..8b0dd65
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/sndarray.pyi
@@ -0,0 +1,12 @@
+from typing import Tuple
+
+import numpy
+
+from pygame.mixer import Sound
+
+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/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/sprite.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/sprite.py
new file mode 100644
index 0000000..0d9c422
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/sprite.py
@@ -0,0 +1,1813 @@
+#    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
+#    modify it under the terms of the GNU Library General Public
+#    License as published by the Free Software Foundation; either
+#    version 2 of the License, or (at your option) any later version.
+#
+#    This library is distributed in the hope that it will be useful,
+#    but WITHOUT ANY WARRANTY; without even the implied warranty of
+#    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+#    Library General Public License for more details.
+#
+#    You should have received a copy of the GNU Library General Public
+#    License along with this library; if not, write to the Free
+#    Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
+#
+#    Pete Shinners
+#    pete@shinners.org
+
+"""pygame module with basic game object classes
+
+This module contains several simple classes to be used within games. There
+are the main Sprite class and several Group classes that contain Sprites.
+The use of these classes is entirely optional when using Pygame. The classes
+are fairly lightweight and only provide a starting place for the code
+that is common to most games.
+
+The Sprite class is intended to be used as a base class for the different
+types 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 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() 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 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 Group. A given Sprite can exist in any number of groups. A game could use
+some groups to control object rendering, and a completely separate set of
+groups to control interaction or player movement. Instead of adding type
+attributes or bools to a derived Sprite class, consider keeping the
+Sprites inside organized Groups. This will allow for easier lookup later
+in the game.
+
+Sprites and Groups manage their relationships with the add() and remove()
+methods. These methods can accept a single or multiple group arguments for
+membership.  The default initializers for these classes also take a
+single group or list of groups as arguments for initial membership. It is safe
+to repeatedly add and remove the same Sprite from a Group.
+
+While it is possible to design sprite and group classes that don't derive
+from the Sprite and AbstractGroup classes below, it is strongly recommended
+that you extend those when you create a new Sprite or Group class.
+
+Sprites are not thread safe, so lock them yourself if using threads.
+
+"""
+
+# TODO:  a group that holds only the 'n' most recent elements.
+#        sort of like the GroupSingle class, but holding more
+#        than one sprite
+#
+# drawing groups that can 'automatically' store the area
+# underneath so they can "clear" without needing a background
+# function. obviously a little slower than normal, but nice
+# to use in many situations. (also remember it must "clear"
+# in the reverse order that it draws :])
+#
+# the drawing groups should also be able to take a background
+# function, instead of just a background surface. the function
+# would take a surface and a rectangle on that surface to erase.
+#
+# perhaps more types of collision functions? the current two
+# 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
+
+from weakref import WeakSet
+from warnings import warn
+
+import pygame
+
+from pygame.rect import Rect
+from pygame.time import get_ticks
+from pygame.mask import from_surface
+
+
+class Sprite:
+    """simple base class for visible game objects
+
+    pygame.sprite.Sprite(*groups): return Sprite
+
+    The base class for visible game objects. Derived classes will want to
+    override the Sprite.update() method and assign Sprite.image and Sprite.rect
+    attributes.  The initializer can accept any number of Group instances that
+    the Sprite will become a member of.
+
+    When subclassing the Sprite class, be sure to call the base initializer
+    before adding the Sprite to Groups.
+
+    """
+
+    def __init__(self, *groups):
+        self.__g = set()  # The groups the sprite is in
+        if groups:
+            self.add(*groups)
+
+    def add(self, *groups):
+        """add the sprite to groups
+
+        Sprite.add(*groups): return None
+
+        Any number of Group instances can be passed as arguments. The
+        Sprite will be added to the Groups it is not already a member of.
+
+        """
+        has = self.__g.__contains__
+        for group in groups:
+            if hasattr(group, "_spritegroup"):
+                if not has(group):
+                    group.add_internal(self)
+                    self.add_internal(group)
+            else:
+                self.add(*group)
+
+    def remove(self, *groups):
+        """remove the sprite from groups
+
+        Sprite.remove(*groups): return None
+
+        Any number of Group instances can be passed as arguments. The Sprite
+        will be removed from the Groups it is currently a member of.
+
+        """
+        has = self.__g.__contains__
+        for group in groups:
+            if hasattr(group, "_spritegroup"):
+                if has(group):
+                    group.remove_internal(self)
+                    self.remove_internal(group)
+            else:
+                self.remove(*group)
+
+    def add_internal(self, group):
+        """
+        For adding this sprite to a group internally.
+
+        :param group: The group we are adding to.
+        """
+        self.__g.add(group)
+
+    def remove_internal(self, group):
+        """
+        For removing this sprite from a group internally.
+
+        :param group: The group we are removing from.
+        """
+        self.__g.remove(group)
+
+    def update(self, *args, **kwargs):
+        """method to control sprite behavior
+
+        Sprite.update(*args, **kwargs):
+
+        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 by the same name in the Group class.
+
+        """
+
+    def kill(self):
+        """remove the Sprite from all Groups
+
+        Sprite.kill(): return None
+
+        The Sprite is removed from all the Groups that contain it. This won't
+        change anything about the state of the Sprite. It is possible to
+        continue to use the Sprite after this method has been called, including
+        adding it to Groups.
+
+        """
+        for group in self.__g:
+            group.remove_internal(self)
+        self.__g.clear()
+
+    def groups(self):
+        """list of Groups that contain this Sprite
+
+        Sprite.groups(): return group_list
+
+        Returns a list of all the Groups that contain this Sprite.
+
+        """
+        return list(self.__g)
+
+    def alive(self):
+        """does the sprite belong to any groups
+
+        Sprite.alive(): return bool
+
+        Returns True when the Sprite belongs to one or more Groups.
+        """
+        return bool(self.__g)
+
+    def __repr__(self):
+        return f"<{self.__class__.__name__} Sprite(in {len(self.__g)} groups)>"
+
+    @property
+    def layer(self):
+        """
+        Dynamic, read only property for protected _layer attribute.
+        This will get the _layer variable if it exists.
+
+        If you try to get it before it is set it will raise an attribute error.
+
+        Layer property can only be set before the sprite is added to a group,
+        after that it is read only and a sprite's layer in a group should be
+        set via the group's change_layer() method.
+
+        :return: layer as an int, or raise AttributeError.
+        """
+        return self._layer
+
+    @layer.setter
+    def layer(self, value):
+        if not self.alive():
+            self._layer = value
+        else:
+            raise AttributeError(
+                "Can't set layer directly after "
+                "adding to group. Use "
+                "group.change_layer(sprite, new_layer) "
+                "instead."
+            )
+
+
+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
+
+    pygame.sprite.DirtySprite(*groups): return DirtySprite
+
+    Extra DirtySprite attributes with their default values:
+
+    dirty = 1
+        If set to 1, it is repainted and then set to 0 again.
+        If set to 2, it is always dirty (repainted each frame;
+        flag is not reset).
+        If set to 0, it is not dirty and therefore not repainted again.
+
+    blendmode = 0
+        It's the special_flags argument of Surface.blit; see the blendmodes in
+        the Surface.blit documentation
+
+    source_rect = None
+        This is the source rect to use. Remember that it is relative to the top
+        left corner (0, 0) of self.image.
+
+    visible = 1
+        Normally this is 1. If set to 0, it will not be repainted. (If you
+        change visible to 1, you must set dirty to 1 for it to be erased from
+        the screen.)
+
+    _layer = 0
+        0 is the default value but this is able to be set differently
+        when subclassing.
+
+    """
+
+    def __init__(self, *groups):
+        self.dirty = 1
+
+        # referred to as special_flags in the documentation of Surface.blit
+        self.blendmode = 0
+        self._visible = 1
+
+        # Default 0 unless initialized differently.
+        self._layer = getattr(self, "_layer", 0)
+        self.source_rect = None
+        Sprite.__init__(self, *groups)
+
+    def _set_visible(self, val):
+        """set the visible value (0 or 1) and makes the sprite dirty"""
+        self._visible = val
+        if self.dirty < 2:
+            self.dirty = 1
+
+    def _get_visible(self):
+        """return the visible value of that sprite"""
+        return self._visible
+
+    @property
+    def visible(self):
+        """
+        You can make this sprite disappear without removing it from the group
+        assign 0 for invisible and 1 for visible
+        """
+        return self._get_visible()
+
+    @visible.setter
+    def visible(self, value):
+        self._set_visible(value)
+
+    @property
+    def layer(self):
+        """
+        Layer property can only be set before the sprite is added to a group,
+        after that it is read only and a sprite's layer in a group should be
+        set via the group's change_layer() method.
+
+        Overwrites dynamic property from sprite class for speed.
+        """
+        return self._layer
+
+    @layer.setter
+    def layer(self, value):
+        if not self.alive():
+            self._layer = value
+        else:
+            raise AttributeError(
+                "Can't set layer directly after "
+                "adding to group. Use "
+                "group.change_layer(sprite, new_layer) "
+                "instead."
+            )
+
+    def __repr__(self):
+        return (
+            f"<{self.__class__.__name__} DirtySprite(in {len(self.groups())} groups)>"
+        )
+
+
+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
+    easily subclass a new group class from this or the other groups below if
+    you want to add more features.
+
+    Any AbstractGroup-derived sprite groups act like sequences and support
+    iteration, len, and so on.
+
+    """
+
+    # dummy val to identify sprite groups, and avoid infinite recursion
+    _spritegroup = True
+
+    def __init__(self):
+        self.spritedict = {}
+        self.lostsprites = []
+
+    def sprites(self):
+        """get a list of sprites in the group
+
+        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
+        pygame.) Alternatively, you can get the same information by iterating
+        directly over the sprite group, e.g. 'for sprite in group'.
+
+        """
+        return list(self.spritedict)
+
+    def add_internal(
+        self,
+        sprite,
+        layer=None,  # noqa pylint: disable=unused-argument; supporting legacy derived classes that override in non-pythonic way
+    ):
+        """
+        For adding a sprite to this group internally.
+
+        :param sprite: The sprite we are adding.
+        :param layer: the layer to add to, if the group type supports layers
+        """
+        self.spritedict[sprite] = None
+
+    def remove_internal(self, sprite):
+        """
+        For removing a sprite from this group internally.
+
+        :param sprite: The sprite we are removing.
+        """
+        lost_rect = self.spritedict[sprite]
+        if lost_rect:
+            self.lostsprites.append(lost_rect)
+        del self.spritedict[sprite]
+
+    def has_internal(self, sprite):
+        """
+        For checking if a sprite is in this group internally.
+
+        :param sprite: The sprite we are checking.
+        """
+        return sprite in self.spritedict
+
+    def copy(self):
+        """copy a group with all the same sprites
+
+        Group.copy(): return Group
+
+        Returns a copy of the group that is an instance of the same class
+        and has the same sprites in it.
+
+        """
+        return self.__class__(  # noqa pylint: disable=too-many-function-args
+            self.sprites()  # Needed because copy() won't work on AbstractGroup
+        )
+
+    def __iter__(self):
+        return iter(self.sprites())
+
+    def __contains__(self, sprite):
+        return self.has(sprite)
+
+    def add(self, *sprites):
+        """add sprite(s) to group
+
+        Group.add(sprite, list, group, ...): return None
+
+        Adds a sprite or sequence of sprites to a group.
+
+        """
+        for sprite in sprites:
+            # It's possible that some sprite is also an iterator.
+            # If this is the case, we should add the sprite itself,
+            # and not the iterator object.
+            if isinstance(sprite, Sprite):
+                if not self.has_internal(sprite):
+                    self.add_internal(sprite)
+                    sprite.add_internal(self)
+            else:
+                try:
+                    # See if sprite is an iterator, like a list or sprite
+                    # group.
+                    self.add(*sprite)
+                except (TypeError, AttributeError):
+                    # Not iterable. This is probably a sprite that is not an
+                    # instance of the Sprite class or is not an instance of a
+                    # subclass of the Sprite class. Alternately, it could be an
+                    # old-style sprite group.
+                    if hasattr(sprite, "_spritegroup"):
+                        for spr in sprite.sprites():
+                            if not self.has_internal(spr):
+                                self.add_internal(spr)
+                                spr.add_internal(self)
+                    elif not self.has_internal(sprite):
+                        self.add_internal(sprite)
+                        sprite.add_internal(self)
+
+    def remove(self, *sprites):
+        """remove sprite(s) from group
+
+        Group.remove(sprite, list, or group, ...): return None
+
+        Removes a sprite or sequence of sprites from a group.
+
+        """
+        # This function behaves essentially the same as Group.add. It first
+        # tries to handle each argument as an instance of the Sprite class. If
+        # that fails, then it tries to handle the argument as an iterable
+        # object. If that fails, then it tries to handle the argument as an
+        # old-style sprite group. Lastly, if that fails, it assumes that the
+        # normal Sprite methods should be used.
+        for sprite in sprites:
+            if isinstance(sprite, Sprite):
+                if self.has_internal(sprite):
+                    self.remove_internal(sprite)
+                    sprite.remove_internal(self)
+            else:
+                try:
+                    self.remove(*sprite)
+                except (TypeError, AttributeError):
+                    if hasattr(sprite, "_spritegroup"):
+                        for spr in sprite.sprites():
+                            if self.has_internal(spr):
+                                self.remove_internal(spr)
+                                spr.remove_internal(self)
+                    elif self.has_internal(sprite):
+                        self.remove_internal(sprite)
+                        sprite.remove_internal(self)
+
+    def has(self, *sprites):
+        """ask if group has a sprite or sprites
+
+        Group.has(sprite or group, ...): return bool
+
+        Returns True if the given sprite or sprites are contained in the
+        group. Alternatively, you can get the same information using the
+        'in' operator, e.g. 'sprite in group', 'subgroup in group'.
+
+        """
+        if not sprites:
+            return False  # return False if no sprites passed in
+
+        for sprite in sprites:
+            if isinstance(sprite, Sprite):
+                # Check for Sprite instance's membership in this group
+                if not self.has_internal(sprite):
+                    return False
+            else:
+                try:
+                    if not self.has(*sprite):
+                        return False
+                except (TypeError, AttributeError):
+                    if hasattr(sprite, "_spritegroup"):
+                        for spr in sprite.sprites():
+                            if not self.has_internal(spr):
+                                return False
+                    else:
+                        if not self.has_internal(sprite):
+                            return False
+
+        return True
+
+    def update(self, *args, **kwargs):
+        """call the update method of every member sprite
+
+        Group.update(*args, **kwargs): return None
+
+        Calls the update method of every member sprite. All arguments that
+        were passed to this method are passed to the Sprite update function.
+
+        """
+        for sprite in self.sprites():
+            sprite.update(*args, **kwargs)
+
+    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, special_flags=0): return Rect_list
+
+        Draws all of the member sprites onto the given surface.
+
+        """
+        sprites = self.sprites()
+        if hasattr(surface, "blits"):
+            self.spritedict.update(
+                zip(
+                    sprites,
+                    surface.blits(
+                        (spr.image, spr.rect, None, special_flags) for spr in sprites
+                    ),
+                )
+            )
+        else:
+            for spr in sprites:
+                self.spritedict[spr] = surface.blit(
+                    spr.image, spr.rect, None, special_flags
+                )
+        self.lostsprites = []
+        dirty = self.lostsprites
+
+        return dirty
+
+    def clear(self, surface, bgd):
+        """erase the previous position of all sprites
+
+        Group.clear(surface, bgd): return None
+
+        Clears the area under every drawn sprite in the group. The bgd
+        argument should be Surface which is the same dimensions as the
+        screen surface. The bgd could also be a function which accepts
+        the given surface and the area to be cleared as arguments.
+
+        """
+        if callable(bgd):
+            for lost_clear_rect in self.lostsprites:
+                bgd(surface, lost_clear_rect)
+            for clear_rect in self.spritedict.values():
+                if clear_rect:
+                    bgd(surface, clear_rect)
+        else:
+            surface_blit = surface.blit
+            for lost_clear_rect in self.lostsprites:
+                surface_blit(bgd, lost_clear_rect, lost_clear_rect)
+            for clear_rect in self.spritedict.values():
+                if clear_rect:
+                    surface_blit(bgd, clear_rect, clear_rect)
+
+    def empty(self):
+        """remove all sprites
+
+        Group.empty(): return None
+
+        Removes all the sprites from the group.
+
+        """
+        for sprite in self.sprites():
+            self.remove_internal(sprite)
+            sprite.remove_internal(self)
+
+    def __bool__(self):
+        return bool(self.sprites())
+
+    def __len__(self):
+        """return number of sprites in group
+
+        Group.len(group): return int
+
+        Returns the number of sprites contained in the group.
+
+        """
+        return len(self.sprites())
+
+    def __repr__(self):
+        return f"<{self.__class__.__name__}({len(self)} sprites)>"
+
+
+class Group(AbstractGroup):
+    """container class for many Sprites
+
+    pygame.sprite.Group(*sprites): return Group
+
+    A simple container for Sprite objects. This class can be subclassed to
+    create containers with more specific behaviors. The constructor takes any
+    number of 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
+        bool    test if any Sprites are contained
+        iter    iterate through all the Sprites
+
+    The Sprites in the Group are not ordered, so the Sprites are drawn and
+    iterated over in no particular order.
+
+    """
+
+    def __init__(self, *sprites):
+        AbstractGroup.__init__(self)
+        self.add(*sprites)
+
+
+RenderPlain = Group
+RenderClear = Group
+
+
+class RenderUpdates(Group):
+    """Group class that tracks dirty updates
+
+    pygame.sprite.RenderUpdates(*sprites): return RenderUpdates
+
+    This class is derived from pygame.sprite.Group(). It has an enhanced draw
+    method that tracks the changed areas of the screen.
+
+    """
+
+    def draw(self, surface, bgsurf=None, special_flags=0):
+        surface_blit = surface.blit
+        dirty = self.lostsprites
+        self.lostsprites = []
+        dirty_append = dirty.append
+        for sprite in self.sprites():
+            old_rect = self.spritedict[sprite]
+            new_rect = surface_blit(sprite.image, sprite.rect, None, special_flags)
+            if old_rect:
+                if new_rect.colliderect(old_rect):
+                    dirty_append(new_rect.union(old_rect))
+                else:
+                    dirty_append(new_rect)
+                    dirty_append(old_rect)
+            else:
+                dirty_append(new_rect)
+            self.spritedict[sprite] = new_rect
+        return dirty
+
+
+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):
+        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 OrderedUpdates
+
+    pygame.sprite.LayeredUpdates(*sprites, **kwargs): return LayeredUpdates
+
+    This group is fully compatible with pygame.sprite.Sprite.
+    New in pygame 1.8.0
+
+    """
+
+    _init_rect = Rect(0, 0, 0, 0)
+
+    def __init__(self, *sprites, **kwargs):
+        """initialize an instance of LayeredUpdates with the given attributes
+
+        You can set the default layer through kwargs using 'default_layer'
+        and an integer for the layer. The default layer is 0.
+
+        If the sprite you add has an attribute _layer, then that layer will be
+        used. If **kwarg contains 'layer', then the passed sprites will be
+        added to that layer (overriding the sprite._layer attribute). If
+        neither the sprite nor **kwarg has a 'layer', then the default layer is
+        used to add the sprites.
+
+        """
+        self._spritelayers = {}
+        self._spritelist = []
+        AbstractGroup.__init__(self)
+        self._default_layer = kwargs.get("default_layer", 0)
+
+        self.add(*sprites, **kwargs)
+
+    def add_internal(self, sprite, layer=None):
+        """Do not use this method directly.
+
+        It is used by the group to add a sprite internally.
+
+        """
+        self.spritedict[sprite] = self._init_rect
+
+        if layer is None:
+            try:
+                layer = sprite.layer
+            except AttributeError:
+                layer = self._default_layer
+                setattr(sprite, "_layer", layer)
+        elif hasattr(sprite, "_layer"):
+            setattr(sprite, "_layer", layer)
+
+        sprites = self._spritelist  # speedup
+        sprites_layers = self._spritelayers
+        sprites_layers[sprite] = layer
+
+        # add the sprite at the right position
+        # bisect algorithmus
+        leng = len(sprites)
+        low = mid = 0
+        high = leng - 1
+        while low <= high:
+            mid = low + (high - low) // 2
+            if sprites_layers[sprites[mid]] <= layer:
+                low = mid + 1
+            else:
+                high = mid - 1
+        # linear search to find final position
+        while mid < leng and sprites_layers[sprites[mid]] <= layer:
+            mid += 1
+        sprites.insert(mid, sprite)
+
+    def add(self, *sprites, **kwargs):
+        """add a sprite or sequence of sprites to a group
+
+        LayeredUpdates.add(*sprites, **kwargs): return None
+
+        If the sprite you add has an attribute _layer, then that layer will be
+        used. If **kwarg contains 'layer', then the passed sprites will be
+        added to that layer (overriding the sprite._layer attribute). If
+        neither the sprite nor **kwarg has a 'layer', then the default layer is
+        used to add the sprites.
+
+        """
+
+        if not sprites:
+            return
+        layer = kwargs["layer"] if "layer" in kwargs else None
+        for sprite in sprites:
+            # It's possible that some sprite is also an iterator.
+            # If this is the case, we should add the sprite itself,
+            # and not the iterator object.
+            if isinstance(sprite, Sprite):
+                if not self.has_internal(sprite):
+                    self.add_internal(sprite, layer)
+                    sprite.add_internal(self)
+            else:
+                try:
+                    # See if sprite is an iterator, like a list or sprite
+                    # group.
+                    self.add(*sprite, **kwargs)
+                except (TypeError, AttributeError):
+                    # Not iterable. This is probably a sprite that is not an
+                    # instance of the Sprite class or is not an instance of a
+                    # subclass of the Sprite class. Alternately, it could be an
+                    # old-style sprite group.
+                    if hasattr(sprite, "_spritegroup"):
+                        for spr in sprite.sprites():
+                            if not self.has_internal(spr):
+                                self.add_internal(spr, layer)
+                                spr.add_internal(self)
+                    elif not self.has_internal(sprite):
+                        self.add_internal(sprite, layer)
+                        sprite.add_internal(self)
+
+    def remove_internal(self, sprite):
+        """Do not use this method directly.
+
+        The group uses it to add a sprite.
+
+        """
+        self._spritelist.remove(sprite)
+        # these dirty rects are suboptimal for one frame
+        old_rect = self.spritedict[sprite]
+        if old_rect is not self._init_rect:
+            self.lostsprites.append(old_rect)  # dirty rect
+        if hasattr(sprite, "rect"):
+            self.lostsprites.append(sprite.rect)  # dirty rect
+
+        del self.spritedict[sprite]
+        del self._spritelayers[sprite]
+
+    def sprites(self):
+        """return a ordered list of sprites (first back, last top).
+
+        LayeredUpdates.sprites(): return sprites
+
+        """
+        return self._spritelist.copy()
+
+    def draw(self, surface, bgsurf=None, special_flags=0):
+        """draw all sprites in the right order onto the passed surface
+
+        LayeredUpdates.draw(surface, special_flags=0): return Rect_list
+
+        """
+        spritedict = self.spritedict
+        surface_blit = surface.blit
+        dirty = self.lostsprites
+        self.lostsprites = []
+        dirty_append = dirty.append
+        init_rect = self._init_rect
+        for spr in self.sprites():
+            rec = spritedict[spr]
+            newrect = surface_blit(spr.image, spr.rect, None, special_flags)
+            if rec is init_rect:
+                dirty_append(newrect)
+            else:
+                if newrect.colliderect(rec):
+                    dirty_append(newrect.union(rec))
+                else:
+                    dirty_append(newrect)
+                    dirty_append(rec)
+            spritedict[spr] = newrect
+        return dirty
+
+    def get_sprites_at(self, pos):
+        """return a list with all sprites at that position
+
+        LayeredUpdates.get_sprites_at(pos): return colliding_sprites
+
+        Bottom sprites are listed first; the top ones are listed last.
+
+        """
+        _sprites = self._spritelist
+        rect = Rect(pos, (1, 1))
+        colliding_idx = rect.collidelistall(_sprites)
+        return [_sprites[i] for i in colliding_idx]
+
+    def get_sprite(self, idx):
+        """return the sprite at the index idx from the groups sprites
+
+        LayeredUpdates.get_sprite(idx): return sprite
+
+        Raises IndexOutOfBounds if the idx is not within range.
+
+        """
+        return self._spritelist[idx]
+
+    def remove_sprites_of_layer(self, layer_nr):
+        """remove all sprites from a layer and return them as a list
+
+        LayeredUpdates.remove_sprites_of_layer(layer_nr): return sprites
+
+        """
+        sprites = self.get_sprites_from_layer(layer_nr)
+        self.remove(*sprites)
+        return sprites
+
+    # layer methods
+    def layers(self):
+        """return a list of unique defined layers defined.
+
+        LayeredUpdates.layers(): return layers
+
+        """
+        return sorted(set(self._spritelayers.values()))
+
+    def change_layer(self, sprite, new_layer):
+        """change the layer of the sprite
+
+        LayeredUpdates.change_layer(sprite, new_layer): return None
+
+        The sprite must have been added to the renderer already. This is not
+        checked.
+
+        """
+        sprites = self._spritelist  # speedup
+        sprites_layers = self._spritelayers  # speedup
+
+        sprites.remove(sprite)
+        sprites_layers.pop(sprite)
+
+        # add the sprite at the right position
+        # bisect algorithmus
+        leng = len(sprites)
+        low = mid = 0
+        high = leng - 1
+        while low <= high:
+            mid = low + (high - low) // 2
+            if sprites_layers[sprites[mid]] <= new_layer:
+                low = mid + 1
+            else:
+                high = mid - 1
+        # linear search to find final position
+        while mid < leng and sprites_layers[sprites[mid]] <= new_layer:
+            mid += 1
+        sprites.insert(mid, sprite)
+        if hasattr(sprite, "_layer"):
+            setattr(sprite, "_layer", new_layer)
+
+        # add layer info
+        sprites_layers[sprite] = new_layer
+
+    def get_layer_of_sprite(self, sprite):
+        """return the layer that sprite is currently in
+
+        If the sprite is not found, then it will return the default layer.
+
+        """
+        return self._spritelayers.get(sprite, self._default_layer)
+
+    def get_top_layer(self):
+        """return the top layer
+
+        LayeredUpdates.get_top_layer(): return layer
+
+        """
+        return self._spritelayers[self._spritelist[-1]]
+
+    def get_bottom_layer(self):
+        """return the bottom layer
+
+        LayeredUpdates.get_bottom_layer(): return layer
+
+        """
+        return self._spritelayers[self._spritelist[0]]
+
+    def move_to_front(self, sprite):
+        """bring the sprite to front layer
+
+        LayeredUpdates.move_to_front(sprite): return None
+
+        Brings the sprite to front by changing the sprite layer to the top-most
+        layer. The sprite is added at the end of the list of sprites in that
+        top-most layer.
+
+        """
+        self.change_layer(sprite, self.get_top_layer())
+
+    def move_to_back(self, sprite):
+        """move the sprite to the bottom layer
+
+        LayeredUpdates.move_to_back(sprite): return None
+
+        Moves the sprite to the bottom layer by moving it to a new layer below
+        the current bottom layer.
+
+        """
+        self.change_layer(sprite, self.get_bottom_layer() - 1)
+
+    def get_top_sprite(self):
+        """return the topmost sprite
+
+        LayeredUpdates.get_top_sprite(): return Sprite
+
+        """
+        return self._spritelist[-1]
+
+    def get_sprites_from_layer(self, layer):
+        """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 where added. (The sprites are not removed from the
+        layer.
+
+        """
+        sprites = []
+        sprites_append = sprites.append
+        sprite_layers = self._spritelayers
+        for spr in self._spritelist:
+            if sprite_layers[spr] == layer:
+                sprites_append(spr)
+            elif sprite_layers[spr] > layer:
+                # break after because no other will
+                # follow with same layer
+                break
+        return sprites
+
+    def switch_layer(self, layer1_nr, layer2_nr):
+        """switch the sprites from layer1_nr to layer2_nr
+
+        LayeredUpdates.switch_layer(layer1_nr, layer2_nr): return None
+
+        The layers number must exist. This method does not check for the
+        existence of the given layers.
+
+        """
+        sprites1 = self.remove_sprites_of_layer(layer1_nr)
+        for spr in self.get_sprites_from_layer(layer2_nr):
+            self.change_layer(spr, layer1_nr)
+        self.add(layer=layer2_nr, *sprites1)
+
+
+class LayeredDirty(LayeredUpdates):
+    """LayeredDirty Group is for DirtySprites; subclasses LayeredUpdates
+
+    pygame.sprite.LayeredDirty(*sprites, **kwargs): return LayeredDirty
+
+    This group requires pygame.sprite.DirtySprite or any sprite that
+    has the following attributes:
+        image, rect, dirty, visible, blendmode (see doc of DirtySprite).
+
+    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 no have to worry which would be faster.
+
+    As with the pygame.sprite.Group, you can specify some additional attributes
+    through kwargs:
+        _use_update: True/False   (default is False)
+        _default_layer: default layer where the sprites without a layer are
+            added
+        _time_threshold: threshold time for switching between dirty rect mode
+            and fullscreen mode; defaults to updating at 80 frames per second,
+            which is equal to 1000.0 / 80.0
+
+    New in pygame 1.8.0
+
+    """
+
+    def __init__(self, *sprites, **kwargs):
+        """initialize group.
+
+        pygame.sprite.LayeredDirty(*sprites, **kwargs): return LayeredDirty
+
+        You can specify some additional attributes through kwargs:
+            _use_update: True/False   (default is False)
+            _default_layer: default layer where the sprites without a layer are
+                added
+            _time_threshold: threshold time for switching between dirty rect
+                mode and fullscreen mode; defaults to updating at 80 frames per
+                second, which is equal to 1000.0 / 80.0
+
+        """
+        LayeredUpdates.__init__(self, *sprites, **kwargs)
+        self._clip = None
+
+        self._use_update = False
+
+        self._time_threshold = 1000.0 / 80.0  # 1000.0 / fps
+
+        self._bgd = None
+        for key, val in kwargs.items():
+            if key in ["_use_update", "_time_threshold", "_default_layer"] and hasattr(
+                self, key
+            ):
+                setattr(self, key, val)
+
+    def add_internal(self, sprite, layer=None):
+        """Do not use this method directly.
+
+        It is used by the group to add a sprite internally.
+
+        """
+        # check if all needed attributes are set
+        if not hasattr(sprite, "dirty"):
+            raise AttributeError()
+        if not hasattr(sprite, "visible"):
+            raise AttributeError()
+        if not hasattr(sprite, "blendmode"):
+            raise AttributeError()
+
+        if not isinstance(sprite, DirtySprite):
+            raise TypeError()
+
+        if sprite.dirty == 0:  # set it dirty if it is not
+            sprite.dirty = 1
+
+        LayeredUpdates.add_internal(self, sprite, layer)
+
+    def draw(self, surface, bgsurf=None, special_flags=None):
+        """draw all sprites in the right order onto the given surface
+
+        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 bgsurf argument has no effect.
+        Passing a value to special_flags will pass that value as the
+        special_flags argument to pass to all Surface.blit calls, overriding
+        the sprite.blendmode attribute
+
+        """
+        # functions and classes assigned locally to speed up loops
+        orig_clip = surface.get_clip()
+        latest_clip = self._clip
+        if latest_clip is None:
+            latest_clip = orig_clip
+
+        local_sprites = self._spritelist
+        local_old_rect = self.spritedict
+        local_update = self.lostsprites
+        rect_type = Rect
+
+        surf_blit_func = surface.blit
+        if bgsurf is not None:
+            self._bgd = bgsurf
+        local_bgd = self._bgd
+
+        surface.set_clip(latest_clip)
+        # -------
+        # 0. decide whether to render with update or flip
+        start_time = get_ticks()
+        if self._use_update:  # dirty rects mode
+            # 1. find dirty area on screen and put the rects into
+            # self.lostsprites still not happy with that part
+            self._find_dirty_area(
+                latest_clip,
+                local_old_rect,
+                rect_type,
+                local_sprites,
+                local_update,
+                local_update.append,
+                self._init_rect,
+            )
+            # can it be done better? because that is an O(n**2) algorithm in
+            # worst case
+
+            # clear using background
+            if local_bgd is not None:
+                flags = 0 if special_flags is None else special_flags
+                for rec in local_update:
+                    surf_blit_func(local_bgd, rec, rec, flags)
+
+            # 2. draw
+            self._draw_dirty_internal(
+                local_old_rect,
+                rect_type,
+                local_sprites,
+                surf_blit_func,
+                local_update,
+                special_flags,
+            )
+            local_ret = list(local_update)
+        else:  # flip, full screen mode
+            if local_bgd is not None:
+                flags = 0 if special_flags is None else special_flags
+                surf_blit_func(local_bgd, (0, 0), None, flags)
+            for spr in local_sprites:
+                if spr.visible:
+                    flags = spr.blendmode if special_flags is None else special_flags
+                    local_old_rect[spr] = surf_blit_func(
+                        spr.image, spr.rect, spr.source_rect, flags
+                    )
+            # return only the part of the screen changed
+            local_ret = [rect_type(latest_clip)]
+
+        # timing for switching modes
+        # How may a good threshold be found? It depends on the hardware.
+        end_time = get_ticks()
+        if end_time - start_time > self._time_threshold:
+            self._use_update = False
+        else:
+            self._use_update = True
+
+        # empty dirty rects list
+        local_update[:] = []
+
+        # -------
+        # restore original clip
+        surface.set_clip(orig_clip)
+        return local_ret
+
+    @staticmethod
+    def _draw_dirty_internal(
+        _old_rect, _rect, _sprites, _surf_blit, _update, _special_flags
+    ):
+        for spr in _sprites:
+            flags = spr.blendmode if _special_flags is None else _special_flags
+            if spr.dirty < 1 and spr.visible:
+                # sprite not dirty; blit only the intersecting part
+                if spr.source_rect is not None:
+                    # For possible future speed up, source_rect's data
+                    # can be pre-fetched outside of this loop.
+                    _spr_rect = _rect(spr.rect.topleft, spr.source_rect.size)
+                    rect_offset_x = spr.source_rect[0] - _spr_rect[0]
+                    rect_offset_y = spr.source_rect[1] - _spr_rect[1]
+                else:
+                    _spr_rect = spr.rect
+                    rect_offset_x = -_spr_rect[0]
+                    rect_offset_y = -_spr_rect[1]
+
+                _spr_rect_clip = _spr_rect.clip
+
+                for idx in _spr_rect.collidelistall(_update):
+                    # clip
+                    clip = _spr_rect_clip(_update[idx])
+                    _surf_blit(
+                        spr.image,
+                        clip,
+                        (
+                            clip[0] + rect_offset_x,
+                            clip[1] + rect_offset_y,
+                            clip[2],
+                            clip[3],
+                        ),
+                        flags,
+                    )
+            else:  # dirty sprite
+                if spr.visible:
+                    _old_rect[spr] = _surf_blit(
+                        spr.image, spr.rect, spr.source_rect, flags
+                    )
+                if spr.dirty == 1:
+                    spr.dirty = 0
+
+    @staticmethod
+    def _find_dirty_area(
+        _clip, _old_rect, _rect, _sprites, _update, _update_append, init_rect
+    ):
+        for spr in _sprites:
+            if spr.dirty > 0:
+                # chose the right rect
+                if spr.source_rect:
+                    _union_rect = _rect(spr.rect.topleft, spr.source_rect.size)
+                else:
+                    _union_rect = _rect(spr.rect)
+
+                _union_rect_collidelist = _union_rect.collidelist
+                _union_rect_union_ip = _union_rect.union_ip
+                i = _union_rect_collidelist(_update)
+                while i > -1:
+                    _union_rect_union_ip(_update[i])
+                    del _update[i]
+                    i = _union_rect_collidelist(_update)
+                _update_append(_union_rect.clip(_clip))
+
+                if _old_rect[spr] is not init_rect:
+                    _union_rect = _rect(_old_rect[spr])
+                    _union_rect_collidelist = _union_rect.collidelist
+                    _union_rect_union_ip = _union_rect.union_ip
+                    i = _union_rect_collidelist(_update)
+                    while i > -1:
+                        _union_rect_union_ip(_update[i])
+                        del _update[i]
+                        i = _union_rect_collidelist(_update)
+                    _update_append(_union_rect.clip(_clip))
+
+    def clear(self, surface, bgd):
+        """use to set background
+
+        Group.clear(surface, bgd): return None
+
+        """
+        self._bgd = bgd
+
+    def repaint_rect(self, screen_rect):
+        """repaint the given area
+
+        LayeredDirty.repaint_rect(screen_rect): return None
+
+        screen_rect is in screen coordinates.
+
+        """
+        if self._clip:
+            self.lostsprites.append(screen_rect.clip(self._clip))
+        else:
+            self.lostsprites.append(Rect(screen_rect))
+
+    def set_clip(self, screen_rect=None):
+        """clip the area where to draw; pass None (default) to reset the clip
+
+        LayeredDirty.set_clip(screen_rect=None): return None
+
+        """
+        if screen_rect is None:
+            self._clip = pygame.display.get_surface().get_rect()
+        else:
+            self._clip = screen_rect
+        self._use_update = False
+
+    def get_clip(self):
+        """get the area where drawing will occur
+
+        LayeredDirty.get_clip(): return Rect
+
+        """
+        return self._clip
+
+    def change_layer(self, sprite, new_layer):
+        """change the layer of the sprite
+
+        LayeredUpdates.change_layer(sprite, new_layer): return None
+
+        The sprite must have been added to the renderer already. This is not
+        checked.
+
+        """
+        LayeredUpdates.change_layer(self, sprite, new_layer)
+        if sprite.dirty == 0:
+            sprite.dirty = 1
+
+    def set_timing_treshold(self, time_ms):
+        """set the threshold in milliseconds
+
+        set_timing_treshold(time_ms): return None
+
+        Defaults to 1000.0 / 80.0. This means that the screen will be painted
+        using the flip method rather than the update method if the update
+        method is taking so long to update the screen that the frame rate falls
+        below 80 frames per second.
+
+        Raises TypeError if time_ms is not int or float.
+
+        """
+        warn(
+            "This function will be removed, use set_timing_threshold function instead",
+            DeprecationWarning,
+        )
+        self.set_timing_threshold(time_ms)
+
+    def set_timing_threshold(self, time_ms):
+        """set the threshold in milliseconds
+
+        set_timing_threshold(time_ms): return None
+
+        Defaults to 1000.0 / 80.0. This means that the screen will be painted
+        using the flip method rather than the update method if the update
+        method is taking so long to update the screen that the frame rate falls
+        below 80 frames per second.
+
+        Raises TypeError if time_ms is not int or float.
+
+        """
+        if isinstance(time_ms, (int, float)):
+            self._time_threshold = time_ms
+        else:
+            raise TypeError(
+                f"Expected numeric value, got {time_ms.__class__.__name__} instead"
+            )
+
+
+class GroupSingle(AbstractGroup):
+    """A group container that holds a single most recent item.
+
+    This class works just like a regular group, but it only keeps a single
+    sprite in the group. Whatever sprite has been added to the group last will
+    be the only sprite in the group.
+
+    You can access its one sprite as the .sprite attribute.  Assigning to this
+    attribute will properly remove the old sprite and then add the new one.
+
+    """
+
+    def __init__(self, sprite=None):
+        AbstractGroup.__init__(self)
+        self.__sprite = None
+        if sprite is not None:
+            self.add(sprite)
+
+    def copy(self):
+        return GroupSingle(self.__sprite)
+
+    def sprites(self):
+        if self.__sprite is not None:
+            return [self.__sprite]
+        return []
+
+    def add_internal(self, sprite, layer=None):
+        if self.__sprite is not None:
+            self.__sprite.remove_internal(self)
+            self.remove_internal(self.__sprite)
+        self.__sprite = sprite
+
+    def __bool__(self):
+        return self.__sprite is not None
+
+    def _get_sprite(self):
+        return self.__sprite
+
+    def _set_sprite(self, sprite):
+        self.add_internal(sprite)
+        sprite.add_internal(self)
+        return sprite
+
+    @property
+    def sprite(self):
+        """
+        Property for the single sprite contained in this group
+
+        :return: The sprite.
+        """
+        return self._get_sprite()
+
+    @sprite.setter
+    def sprite(self, sprite_to_set):
+        self._set_sprite(sprite_to_set)
+
+    def remove_internal(self, sprite):
+        if sprite is self.__sprite:
+            self.__sprite = None
+        if sprite in self.spritedict:
+            AbstractGroup.remove_internal(self, sprite)
+
+    def has_internal(self, sprite):
+        return self.__sprite is sprite
+
+    # Optimizations...
+    def __contains__(self, sprite):
+        return self.__sprite is sprite
+
+
+# Some different collision detection functions that could be used.
+def collide_rect(left, right):
+    """collision detection between two sprites, using rects.
+
+    pygame.sprite.collide_rect(left, right): return bool
+
+    Tests for collision between two sprites. Uses the pygame.Rect colliderect
+    function to calculate the collision. It is intended to be passed as a
+    collided callback function to the *collide functions. Sprites must have
+    "rect" attributes.
+
+    New in pygame 1.8.0
+
+    """
+    return left.rect.colliderect(right.rect)
+
+
+class collide_rect_ratio:  # noqa pylint: disable=invalid-name; this is a function-like class
+    """A callable class that checks for collisions using scaled rects
+
+    The class checks for collisions between two sprites using a scaled version
+    of the sprites' rects. Is created with a ratio; the instance is then
+    intended to be passed as a collided callback function to the *collide
+    functions.
+
+    New in pygame 1.8.1
+
+    """
+
+    def __init__(self, ratio):
+        """create a new collide_rect_ratio callable
+
+        Ratio is expected to be a floating point value used to scale
+        the underlying sprite rect before checking for collisions.
+
+        """
+        self.ratio = ratio
+
+    def __repr__(self):
+        """
+        Turn the class into a string.
+        """
+        # pylint: disable=consider-using-f-string
+        return "<{klass} @{id:x} {attrs}>".format(
+            klass=self.__class__.__name__,
+            id=id(self) & 0xFFFFFF,
+            attrs=" ".join(f"{k}={v!r}" for k, v in self.__dict__.items()),
+        )
+
+    def __call__(self, left, right):
+        """detect collision between two sprites using scaled rects
+
+        pygame.sprite.collide_rect_ratio(ratio)(left, right): return bool
+
+        Tests for collision between two sprites. Uses the pygame.Rect
+        colliderect function to calculate the collision after scaling the rects
+        by the stored ratio. Sprites must have "rect" attributes.
+
+        """
+
+        ratio = self.ratio
+
+        leftrect = left.rect
+        width = leftrect.width
+        height = leftrect.height
+        leftrect = leftrect.inflate(width * ratio - width, height * ratio - height)
+
+        rightrect = right.rect
+        width = rightrect.width
+        height = rightrect.height
+        rightrect = rightrect.inflate(width * ratio - width, height * ratio - height)
+
+        return leftrect.colliderect(rightrect)
+
+
+def collide_circle(left, right):
+    """detect collision between two sprites using circles
+
+    pygame.sprite.collide_circle(left, right): return bool
+
+    Tests for collision between two sprites by testing whether two circles
+    centered on the sprites overlap. If the sprites have a "radius" attribute,
+    then that radius is used to create the circle; otherwise, a circle is
+    created that is big enough to completely enclose the sprite's rect as
+    given by the "rect" attribute. This function is 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.0
+
+    """
+
+    xdistance = left.rect.centerx - right.rect.centerx
+    ydistance = left.rect.centery - right.rect.centery
+    distancesquared = xdistance**2 + ydistance**2
+
+    try:
+        leftradius = left.radius
+    except AttributeError:
+        leftrect = left.rect
+        # approximating the radius of a square by using half of the diagonal,
+        # 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
+
+    try:
+        rightradius = right.radius
+    except AttributeError:
+        rightrect = right.rect
+        # approximating the radius of a square by using half of the diagonal
+        # 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
+    return distancesquared <= (leftradius + rightradius) ** 2
+
+
+class collide_circle_ratio:  # noqa pylint: disable=invalid-name; this is a function-like class
+    """detect collision between two sprites using scaled circles
+
+    This callable class checks for collisions between two sprites using a
+    scaled version of a sprite's radius. It is created with a ratio as the
+    argument to the constructor. The instance is then intended to be passed as
+    a collided callback function to the *collide functions.
+
+    New in pygame 1.8.1
+
+    """
+
+    def __init__(self, ratio):
+        """creates a new collide_circle_ratio callable instance
+
+        The given ratio is expected to be a floating point value used to scale
+        the underlying sprite radius before checking for collisions.
+
+        When the ratio is ratio=1.0, then it behaves exactly like the
+        collide_circle method.
+
+        """
+        self.ratio = ratio
+
+    def __repr__(self):
+        """
+        Turn the class into a string.
+        """
+        # pylint: disable=consider-using-f-string
+        return "<{klass} @{id:x} {attrs}>".format(
+            klass=self.__class__.__name__,
+            id=id(self) & 0xFFFFFF,
+            attrs=" ".join(f"{k}={v!r}" for k, v in self.__dict__.items()),
+        )
+
+    def __call__(self, left, right):
+        """detect collision between two sprites using scaled circles
+
+        pygame.sprite.collide_circle_radio(ratio)(left, right): return bool
+
+        Tests for collision between two sprites by testing whether two circles
+        centered on the sprites overlap after scaling the circle's radius by
+        the stored ratio. If the sprites have a "radius" attribute, that is
+        used to create the circle; otherwise, a circle is created that is big
+        enough to completely enclose the sprite's 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.
+
+        """
+
+        ratio = self.ratio
+        xdistance = left.rect.centerx - right.rect.centerx
+        ydistance = left.rect.centery - right.rect.centery
+        distancesquared = xdistance**2 + ydistance**2
+
+        try:
+            leftradius = left.radius
+        except AttributeError:
+            leftrect = left.rect
+            leftradius = 0.5 * ((leftrect.width**2 + leftrect.height**2) ** 0.5)
+            # store the radius on the sprite for next time
+            left.radius = leftradius
+        leftradius *= ratio
+
+        try:
+            rightradius = right.radius
+        except AttributeError:
+            rightrect = right.rect
+            rightradius = 0.5 * ((rightrect.width**2 + rightrect.height**2) ** 0.5)
+            # store the radius on the sprite for next time
+            right.radius = rightradius
+        rightradius *= ratio
+
+        return distancesquared <= (leftradius + rightradius) ** 2
+
+
+def collide_mask(left, right):
+    """collision detection between two sprites, using masks.
+
+    pygame.sprite.collide_mask(SpriteLeft, SpriteRight): bool
+
+    Tests for collision between two sprites by testing if their bitmasks
+    overlap. If the sprites have a "mask" attribute, that is used as the mask;
+    otherwise, a mask is created from the sprite image. Intended to be passed
+    as a collided callback function to the *collide functions. Sprites must
+    have a "rect" and an optional "mask" attribute.
+
+    New in pygame 1.8.0
+
+    """
+    xoffset = right.rect[0] - left.rect[0]
+    yoffset = right.rect[1] - left.rect[1]
+    try:
+        leftmask = left.mask
+    except AttributeError:
+        leftmask = from_surface(left.image)
+    try:
+        rightmask = right.mask
+    except AttributeError:
+        rightmask = from_surface(right.image)
+    return leftmask.overlap(rightmask, (xoffset, yoffset))
+
+
+def spritecollide(sprite, group, dokill, collided=None):
+    """find Sprites in a Group that intersect another Sprite
+
+    pygame.sprite.spritecollide(sprite, group, dokill, collided=None):
+        return Sprite_list
+
+    Return a list containing all Sprites in a Group that intersect with another
+    Sprite. Intersection is determined by comparing the Sprite.rect attribute
+    of each Sprite.
+
+    The dokill argument is a bool. If set to True, all Sprites that collide
+    will be removed from the Group.
+
+    The collided argument is a callback function used to calculate if two
+    sprites are colliding. it should take two sprites as values, and return a
+    bool value indicating if they are colliding. If collided is not passed, all
+    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 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:
+        return [
+            group_sprite for group_sprite in group if collided(sprite, group_sprite)
+        ]
+
+    return [
+        group_sprite
+        for group_sprite in group
+        if default_sprite_collide_func(group_sprite.rect)
+    ]
+
+
+def groupcollide(groupa, groupb, dokilla, dokillb, collided=None):
+    """detect collision between a group and another group
+
+    pygame.sprite.groupcollide(groupa, groupb, dokilla, dokillb):
+        return dict
+
+    Given two groups, this will find the intersections between all sprites in
+    each group. It returns a dictionary of all sprites in the first group that
+    collide. The value for each item in the dictionary is a list of the sprites
+    in the second group it collides with. The two dokill arguments control if
+    the sprites from either group will be automatically removed from all
+    groups. Collided is a callback function used to calculate if two sprites
+    are colliding. it should take two sprites as values, and return a bool
+    value indicating if they are colliding. If collided is not passed, all
+    sprites must have a "rect" value, which is a rectangle of the sprite area
+    that will be used to calculate the collision.
+
+    """
+    crashed = {}
+    # pull the collision function in as a local variable outside
+    # the loop as this makes the loop run faster
+    sprite_collide_func = spritecollide
+    if dokilla:
+        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):
+    """finds any sprites in a group that collide with the given sprite
+
+    pygame.sprite.spritecollideany(sprite, group): return sprite
+
+    Given a sprite and a group of sprites, this will return any single
+    sprite that collides with the given sprite. If there are no
+    collisions, then this returns None.
+
+    If you don't need all the features of the spritecollide function, this
+    function will be a bit quicker.
+
+    Collided is a callback function used to calculate if two sprites are
+    colliding. It should take two sprites as values and return a bool value
+    indicating if they are colliding. If collided is not passed, then all
+    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:
+        # Special case old behaviour for speed.
+        for group_sprite in group:
+            if default_sprite_collide_func(group_sprite.rect):
+                return group_sprite
+    return None
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/sprite.pyi b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/sprite.pyi
new file mode 100644
index 0000000..752cc1f
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/sprite.pyi
@@ -0,0 +1,287 @@
+from typing import (
+    Any,
+    Callable,
+    Dict,
+    Generic,
+    Iterable,
+    Iterator,
+    List,
+    Literal,
+    Optional,
+    SupportsFloat,
+    Tuple,
+    TypeVar,
+    Union,
+)
+
+# Protocol added in python 3.8
+from typing_extensions import Protocol
+
+from pygame.rect import Rect
+from pygame.surface import Surface
+from pygame.mask import Mask
+
+from ._common import RectValue, Coordinate
+
+# non-generic Group, used in Sprite
+_Group = AbstractGroup[_SpriteSupportsGroup]
+
+# 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: _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]: ...
+
+# also a protocol
+class _SupportsDirtySprite(_SupportsSprite, Protocol):
+    dirty: int
+    blendmode: int
+    source_rect: Rect
+    visible: int
+    _layer: int
+    def _set_visible(self, val: int) -> None: ...
+    def _get_visible(self) -> int: ...
+
+# 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]: ...
+
+class WeakSprite(Sprite):
+    ...
+
+# 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[_TSprite]: ...
+    def __bool__(self) -> bool: ...
+    def __contains__(self, item: Any) -> 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, bgsurf: Optional[Surface] = None, special_flags: int = 0
+    ) -> List[Rect]: ...
+    def clear(
+        self, surface: Surface, bgd: Union[Surface, Callable[[Surface, Rect], Any]]
+    ) -> None: ...
+    def empty(self) -> None: ...
+
+class Group(AbstractGroup[_TSprite]):
+    def __init__(
+        self, *sprites: Union[_TSprite, AbstractGroup[_TSprite], Iterable[_TSprite]]
+    ) -> None: ...
+
+# these are aliased in the code too
+RenderPlain = Group
+RenderClear = Group
+
+class RenderUpdates(Group[_TSprite]): ...
+class OrderedUpdates(RenderUpdates[_TSprite]): ...
+
+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: _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[_TDirtySprite]):
+    def __init__(self, *sprites: _TDirtySprite, **kwargs: Any) -> None: ...
+    def draw(
+        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: 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[_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:
+    ratio: float
+    def __init__(self, ratio: float) -> None: ...
+    def __call__(self, left: _HasRect, right: _HasRect) -> bool: ...
+
+# must have rect attribute, may optionally have radius attribute
+_SupportsCollideCircle = Union[_HasRect, _HasRadiusAndRect]
+
+def collide_circle(
+    left: _SupportsCollideCircle, right: _SupportsCollideCircle
+) -> bool: ...
+
+class collide_circle_ratio:
+    ratio: float
+    def __init__(self, ratio: float) -> None: ...
+    def __call__(
+        self, left: _SupportsCollideCircle, right: _SupportsCollideCircle
+    ) -> bool: ...
+
+# argument to collide_mask must either have mask or have image attribute, in
+# addition to mandatorily having a rect attribute
+_SupportsCollideMask = Union[_HasImageAndRect, _HasMaskAndRect]
+
+def collide_mask(
+    left: _SupportsCollideMask, right: _SupportsCollideMask
+) -> Optional[Tuple[int, int]]: ...
+def spritecollide(
+    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[_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: _TSprite,
+    group: AbstractGroup[_TSprite2],
+    collided: Optional[
+        Callable[[_TSprite, _TSprite2], bool | Optional[Tuple[int, int]]]
+    ] = None,
+) -> Optional[_TSprite2]: ...
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/surface.cpython-312-darwin.so b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/surface.cpython-312-darwin.so
new file mode 100755
index 0000000..3ad56c3
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/surface.cpython-312-darwin.so differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/surface.pyi b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/surface.pyi
new file mode 100644
index 0000000..b1facba
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/surface.pyi
@@ -0,0 +1,149 @@
+from typing import Any, List, Optional, Sequence, Tuple, Union, overload
+
+from pygame.bufferproxy import BufferProxy
+from pygame.color import Color
+from pygame.rect import Rect
+
+from ._common import ColorValue, Coordinate, Literal, RectValue, RGBAOutput
+
+_ViewKind = Literal[
+    "0",
+    "1",
+    "2",
+    "3",
+    b"0",
+    b"1",
+    b"2",
+    b"3",
+    "r",
+    "g",
+    "b",
+    "a",
+    "R",
+    "G",
+    "B",
+    "A",
+    b"r",
+    b"g",
+    b"b",
+    b"a",
+    b"R",
+    b"G",
+    b"B",
+    b"A",
+]
+
+class Surface:
+    _pixels_address: int
+    @overload
+    def __init__(
+        self,
+        size: Coordinate,
+        flags: int = 0,
+        depth: int = 0,
+        masks: Optional[ColorValue] = None,
+    ) -> None: ...
+    @overload
+    def __init__(
+        self,
+        size: Coordinate,
+        flags: int = 0,
+        surface: Surface = ...,
+    ) -> None: ...
+    def __copy__(self) -> Surface: ...
+    copy = __copy__
+    def blit(
+        self,
+        source: Surface,
+        dest: Union[Coordinate, RectValue],
+        area: Optional[RectValue] = None,
+        special_flags: int = 0,
+    ) -> Rect: ...
+    def blits(
+        self,
+        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: Union[int, bool] = 1,
+    ) -> Union[List[Rect], None]: ...
+    @overload
+    def convert(self, surface: Surface) -> Surface: ...
+    @overload
+    def convert(self, depth: int, flags: int = 0) -> Surface: ...
+    @overload
+    def convert(self, masks: ColorValue, flags: int = 0) -> Surface: ...
+    @overload
+    def convert(self) -> Surface: ...
+    @overload
+    def convert_alpha(self, surface: Surface) -> Surface: ...
+    @overload
+    def convert_alpha(self) -> Surface: ...
+    def fill(
+        self,
+        color: ColorValue,
+        rect: Optional[RectValue] = None,
+        special_flags: int = 0,
+    ) -> Rect: ...
+    def scroll(self, dx: int = 0, dy: int = 0) -> None: ...
+    @overload
+    def set_colorkey(self, color: ColorValue, flags: int = 0) -> None: ...
+    @overload
+    def set_colorkey(self, color: None) -> None: ...
+    def get_colorkey(self) -> Optional[RGBAOutput]: ...
+    @overload
+    def set_alpha(self, value: int, flags: int = 0) -> None: ...
+    @overload
+    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: RectValue) -> Surface: ...
+    @overload
+    def subsurface(self, left_top: Coordinate, width_height: Coordinate) -> Surface: ...
+    @overload
+    def subsurface(
+        self, left: float, top: float, width: float, height: float
+    ) -> Surface: ...
+    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: ...
+
+SurfaceType = Surface
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/surfarray.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/surfarray.py
new file mode 100644
index 0000000..0bcd431
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/surfarray.py
@@ -0,0 +1,448 @@
+##    pygame - Python Game Library
+##    Copyright (C) 2007 Marcus von Appen
+##
+##    This library is free software; you can redistribute it and/or
+##    modify it under the terms of the GNU Library General Public
+##    License as published by the Free Software Foundation; either
+##    version 2 of the License, or (at your option) any later version.
+##
+##    This library is distributed in the hope that it will be useful,
+##    but WITHOUT ANY WARRANTY; without even the implied warranty of
+##    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+##    Library General Public License for more details.
+##
+##    You should have received a copy of the GNU Library General Public
+##    License along with this library; if not, write to the Free
+##    Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
+##
+##    Marcus von Appen
+##    mva@sysfault.org
+
+"""pygame module for accessing surface pixel data using array interfaces
+
+Functions to convert between NumPy arrays and Surface 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.
+
+Every pixel is stored as a single integer value to represent the red,
+green, and blue colors. The 8bit images use a value that looks into a
+colormap. Pixels with higher depth use a bit packing process to place
+three or four values into a single number.
+
+The arrays are indexed by the X axis first, followed by the Y
+axis. Arrays that treat the pixels as a single integer are referred to
+as 2D arrays. 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.
+"""
+
+
+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,
+    uint32 as numpy_uint32,
+    ndarray as numpy_ndarray,
+)
+
+import warnings  # will be removed in the future
+
+
+# float96 not available on all numpy versions.
+numpy_floats = [
+    getattr(numpy, type_name)
+    for type_name in "float32 float64 float96".split()
+    if hasattr(numpy, type_name)
+]
+# 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
+# permissible for 2D reference arrays.
+_pixel2d_bitdepths = {8, 16, 32}
+
+
+__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 blit_array(surface, array):
+    """pygame.surfarray.blit_array(Surface, array): return None
+
+    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. Only integer, ascii character and record arrays are accepted.
+
+    This function will temporarily lock the Surface as the new values are
+    copied.
+    """
+    if isinstance(array, numpy_ndarray) and array.dtype in numpy_floats:
+        array = array.round(0).astype(numpy_uint32)
+    return array_to_surface(surface, array)
+
+
+def make_surface(array):
+    """pygame.surfarray.make_surface (array): return Surface
+
+    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.
+    """
+    if isinstance(array, numpy_ndarray) and array.dtype in numpy_floats:
+        array = array.round(0).astype(numpy_uint32)
+    return pix_make_surface(array)
+
+
+def array2d(surface):
+    """pygame.surfarray.array2d(Surface): return array
+
+    copy pixels into a 2d array
+
+    Copy the pixels from a Surface 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 Surface.lock - lock the Surface memory for pixel access
+    method).
+    """
+    bpp = surface.get_bytesize()
+    try:
+        dtype = (numpy.uint8, numpy.uint16, numpy.int32, numpy.int32)[bpp - 1]
+    except IndexError:
+        raise ValueError(f"unsupported bit depth {bpp * 8} for 2D array")
+    size = surface.get_size()
+    array = numpy.empty(size, dtype)
+    surface_to_array(array, surface)
+    return array
+
+
+def pixels2d(surface):
+    """pygame.surfarray.pixels2d(Surface): return array
+
+    reference pixels into a 2d array
+
+    Create a new 2D array that directly references the pixel values in a
+    Surface. Any changes to the array will affect the pixels in the
+    Surface. This is a fast operation since no data is copied.
+
+    Pixels from a 24-bit Surface cannot be referenced, but all other
+    Surface bit depths can.
+
+    The Surface this references will remain locked for the lifetime of
+    the array (see the Surface.lock - lock the Surface memory for pixel
+    access method).
+    """
+    if surface.get_bitsize() not in _pixel2d_bitdepths:
+        raise ValueError("unsupported bit depth for 2D reference array")
+    try:
+        return numpy_array(surface.get_view("2"), copy=False)
+    except (ValueError, TypeError):
+        raise ValueError(
+            f"bit depth {surface.get_bitsize()} unsupported for 2D reference array"
+        )
+
+
+def array3d(surface):
+    """pygame.surfarray.array3d(Surface): return array
+
+    copy pixels into a 3d array
+
+    Copy the pixels from a Surface into a 3D 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 Surface.lock - lock the Surface memory for pixel access
+    method).
+    """
+    width, height = surface.get_size()
+    array = numpy.empty((width, height, 3), numpy.uint8)
+    surface_to_array(array, surface)
+    return array
+
+
+def pixels3d(surface):
+    """pygame.surfarray.pixels3d(Surface): return array
+
+    reference pixels into a 3d array
+
+    Create a new 3D array that directly references the pixel values in a
+    Surface. Any changes to the array will affect the pixels in the
+    Surface. This is a fast operation since no data is copied.
+
+    This will only work on Surfaces that have 24-bit or 32-bit
+    formats. Lower pixel formats cannot be referenced.
+
+    The Surface this references will remain locked for the lifetime of
+    the array (see the Surface.lock - lock the Surface memory for pixel
+    access method).
+    """
+    return numpy_array(surface.get_view("3"), copy=False)
+
+
+def array_alpha(surface):
+    """pygame.surfarray.array_alpha(Surface): return array
+
+    copy pixel alphas into a 2d array
+
+    Copy the pixel alpha values (degree of transparency) from a Surface
+    into a 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 Surface.lock - lock the Surface memory for pixel access
+    method).
+    """
+    size = surface.get_size()
+    array = numpy.empty(size, numpy.uint8)
+    surface_to_array(array, surface, "A")
+    return array
+
+
+def pixels_alpha(surface):
+    """pygame.surfarray.pixels_alpha(Surface): return array
+
+    reference pixel alphas into a 2d array
+
+    Create a new 2D array that directly references the alpha values
+    (degree of transparency) in a Surface. Any changes to the array will
+    affect the pixels 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 array references will remain locked for the
+    lifetime of the array.
+    """
+    return numpy.array(surface.get_view("A"), copy=False)
+
+
+def pixels_red(surface):
+    """pygame.surfarray.pixels_red(Surface): return array
+
+    Reference pixel red into a 2d array.
+
+    Create a new 2D array that directly references the red values
+    in a Surface. Any changes to the array will affect the pixels
+    in the Surface. This is a fast operation since no data is copied.
+
+    This can only work on 24-bit or 32-bit Surfaces.
+
+    The Surface this array references will remain locked for the
+    lifetime of the array.
+    """
+    return numpy.array(surface.get_view("R"), copy=False)
+
+
+def array_red(surface):
+    """pygame.surfarray.array_red(Surface): return array
+
+    copy pixel red into a 2d array
+
+    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 Surface.lock - lock the Surface memory for pixel access
+    method).
+    """
+    size = surface.get_size()
+    array = numpy.empty(size, numpy.uint8)
+    surface_to_array(array, surface, "R")
+    return array
+
+
+def pixels_green(surface):
+    """pygame.surfarray.pixels_green(Surface): return array
+
+    Reference pixel green into a 2d array.
+
+    Create a new 2D array that directly references the green values
+    in a Surface. Any changes to the array will affect the pixels
+    in the Surface. This is a fast operation since no data is copied.
+
+    This can only work on 24-bit or 32-bit Surfaces.
+
+    The Surface this array references will remain locked for the
+    lifetime of the array.
+    """
+    return numpy.array(surface.get_view("G"), copy=False)
+
+
+def array_green(surface):
+    """pygame.surfarray.array_green(Surface): return array
+
+    copy pixel green into a 2d array
+
+    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 Surface.lock - lock the Surface memory for pixel access
+    method).
+    """
+    size = surface.get_size()
+    array = numpy.empty(size, numpy.uint8)
+    surface_to_array(array, surface, "G")
+    return array
+
+
+def pixels_blue(surface):
+    """pygame.surfarray.pixels_blue(Surface): return array
+
+    Reference pixel blue into a 2d array.
+
+    Create a new 2D array that directly references the blue values
+    in a Surface. Any changes to the array will affect the pixels
+    in the Surface. This is a fast operation since no data is copied.
+
+    This can only work on 24-bit or 32-bit Surfaces.
+
+    The Surface this array references will remain locked for the
+    lifetime of the array.
+    """
+    return numpy.array(surface.get_view("B"), copy=False)
+
+
+def array_blue(surface):
+    """pygame.surfarray.array_blue(Surface): return array
+
+    copy pixel blue into a 2d array
+
+    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 Surface.lock - lock the Surface memory for pixel access
+    method).
+    """
+    size = surface.get_size()
+    array = numpy.empty(size, numpy.uint8)
+    surface_to_array(array, surface, "B")
+    return array
+
+
+def array_colorkey(surface):
+    """pygame.surfarray.array_colorkey(Surface): return array
+
+    copy the colorkey values into a 2d array
+
+    Create a new array with the colorkey transparency value from each
+    pixel. If the pixel matches the colorkey it will be fully
+    transparent; otherwise it will be fully opaque.
+
+    This will work on any type of Surface format. If the image has no
+    colorkey a solid opaque array will be returned.
+
+    This function will temporarily lock the Surface as pixels are
+    copied.
+    """
+    size = surface.get_size()
+    array = numpy.empty(size, numpy.uint8)
+    surface_to_array(array, surface, "C")
+    return array
+
+
+def map_array(surface, array):
+    """pygame.surfarray.map_array(Surface, array3d): return array2d
+
+    map a 3d array into a 2d array
+
+    Convert a 3D array into a 2D array. This will use the given Surface
+    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 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:
+        raise ValueError("array must have at least 1 dimension")
+    shape = array.shape
+    if shape[-1] != 3:
+        raise ValueError("array must be a 3d array of 3-value color data")
+    target = numpy_empty(shape[:-1], numpy.int32)
+    pix_map_array(target, array, surface)
+    return target
+
+
+def use_arraytype(arraytype):
+    """pygame.surfarray.use_arraytype(arraytype): return None
+
+    DEPRECATED - only numpy arrays are now supported.
+    """
+    warnings.warn(
+        DeprecationWarning(
+            "only numpy arrays are now supported, "
+            "this function will be removed in a "
+            "future version of the module"
+        )
+    )
+    arraytype = arraytype.lower()
+    if arraytype != "numpy":
+        raise ValueError("invalid array type")
+
+
+def get_arraytype():
+    """pygame.surfarray.get_arraytype(): return str
+
+    DEPRECATED - only numpy arrays are now supported.
+    """
+    warnings.warn(
+        DeprecationWarning(
+            "only numpy arrays are now supported, "
+            "this function will be removed in a "
+            "future version of the module"
+        )
+    )
+    return "numpy"
+
+
+def get_arraytypes():
+    """pygame.surfarray.get_arraytypes(): return tuple
+
+    DEPRECATED - only numpy arrays are now supported.
+    """
+    warnings.warn(
+        DeprecationWarning(
+            "only numpy arrays are now supported, "
+            "this function will be removed in a "
+            "future version of the module"
+        )
+    )
+    return ("numpy",)
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/surfarray.pyi b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/surfarray.pyi
new file mode 100644
index 0000000..bf15758
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/surfarray.pyi
@@ -0,0 +1,31 @@
+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,
+)
+
+def array2d(surface: Surface) -> numpy.ndarray: ...
+def pixels2d(surface: Surface) -> numpy.ndarray: ...
+def array3d(surface: Surface) -> numpy.ndarray: ...
+def pixels3d(surface: Surface) -> numpy.ndarray: ...
+def array_alpha(surface: Surface) -> numpy.ndarray: ...
+def pixels_alpha(surface: Surface) -> numpy.ndarray: ...
+def array_red(surface: Surface) -> numpy.ndarray: ...
+def pixels_red(surface: Surface) -> numpy.ndarray: ...
+def array_green(surface: Surface) -> numpy.ndarray: ...
+def pixels_green(surface: Surface) -> numpy.ndarray: ...
+def array_blue(surface: Surface) -> numpy.ndarray: ...
+def pixels_blue(surface: Surface) -> numpy.ndarray: ...
+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: ...
+def use_arraytype(arraytype: str) -> None: ...
+def get_arraytype() -> str: ...
+def get_arraytypes() -> Tuple[str]: ...
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/surflock.cpython-312-darwin.so b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/surflock.cpython-312-darwin.so
new file mode 100755
index 0000000..fd43a35
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/surflock.cpython-312-darwin.so differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/surflock.pyi b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/surflock.pyi
new file mode 100644
index 0000000..cd91285
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/surflock.pyi
@@ -0,0 +1,2 @@
+# surflock is a private pygame module that does not export any public API
+# this file is kept here to make stubtest happy
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/sysfont.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/sysfont.py
new file mode 100644
index 0000000..6ddcb78
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/sysfont.py
@@ -0,0 +1,515 @@
+# pygame - Python Game Library
+# Copyright (C) 2000-2003  Pete Shinners
+#
+# This library is free software; you can redistribute it and/or
+# modify it under the terms of the GNU Library General Public
+# License as published by the Free Software Foundation; either
+# version 2 of the License, or (at your option) any later version.
+#
+# This library is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+# Library General Public License for more details.
+#
+# You should have received a copy of the GNU Library General Public
+# License along with this library; if not, write to the Free
+# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
+#
+# Pete Shinners
+# pete@shinners.org
+"""sysfont, used in the font module to find system fonts"""
+
+import os
+import sys
+import warnings
+from os.path import basename, dirname, exists, join, splitext
+
+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 = {}
+
+is_init = False
+
+
+def _simplename(name):
+    """create simple version of the font name"""
+    # return alphanumeric characters of a string (converted to lowercase)
+    return "".join(c.lower() for c in name if c.isalnum())
+
+
+def _addfont(name, bold, italic, font, fontdict):
+    """insert a font and style into the font dictionary"""
+    if name not in fontdict:
+        fontdict[name] = {}
+    fontdict[name][bold, italic] = font
+
+
+def initsysfonts_win32():
+    """initialize fonts dictionary on Windows"""
+
+    fontdir = join(os.environ.get("WINDIR", "C:\\Windows"), "Fonts")
+    fonts = {}
+
+    # add fonts entered in the registry
+    microsoft_font_dirs = [
+        "SOFTWARE\\Microsoft\\Windows NT\\CurrentVersion\\Fonts",
+        "SOFTWARE\\Microsoft\\Windows\\CurrentVersion\\Fonts",
+    ]
+
+    for domain in [_winreg.HKEY_LOCAL_MACHINE, _winreg.HKEY_CURRENT_USER]:
+        for font_dir in microsoft_font_dirs:
+            try:
+                key = _winreg.OpenKey(domain, font_dir)
+            except FileNotFoundError:
+                continue
+
+            for i in range(_winreg.QueryInfoKey(key)[1]):
+                try:
+                    # name is the font's name e.g. Times New Roman (TrueType)
+                    # font is the font's filename e.g. times.ttf
+                    name, font, _ = _winreg.EnumValue(key, i)
+                except OSError:
+                    break
+
+                if splitext(font)[1].lower() not in OpenType_extensions:
+                    continue
+                if not dirname(font):
+                    font = join(fontdir, font)
+
+                # 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("&"):
+                    _parse_font_entry_win(name, font, fonts)
+
+    return fonts
+
+
+def _parse_font_entry_win(name, font, fonts):
+    """
+    Parse out a simpler name and the font style from the initial file name.
+
+    :param name: The font name
+    :param font: The font file path
+    :param fonts: The pygame font dictionary
+    """
+    true_type_suffix = "(TrueType)"
+    mods = ("demibold", "narrow", "light", "unicode", "bt", "mt")
+    if name.endswith(true_type_suffix):
+        name = name.rstrip(true_type_suffix).rstrip()
+    name = name.lower().split()
+    bold = italic = False
+    for mod in mods:
+        if mod in name:
+            name.remove(mod)
+    if "bold" in name:
+        name.remove("bold")
+        bold = True
+    if "italic" in name:
+        name.remove("italic")
+        italic = True
+    name = "".join(name)
+    name = _simplename(name)
+
+    _addfont(name, bold, italic, font, fonts)
+
+
+def _parse_font_entry_darwin(name, filepath, fonts):
+    """
+    Parses a font entry for macOS
+
+    :param name: The filepath without extensions or directories
+    :param filepath: The full path to the font
+    :param fonts: The pygame font dictionary to add the parsed font data to.
+    """
+
+    name = _simplename(name)
+
+    mods = ("regular",)
+
+    for mod in mods:
+        if mod in name:
+            name = name.replace(mod, "")
+
+    bold = italic = False
+    if "bold" in name:
+        name = name.replace("bold", "")
+        bold = True
+    if "italic" in name:
+        name = name.replace("italic", "")
+        italic = True
+
+    _addfont(name, bold, italic, filepath, fonts)
+
+
+def _font_finder_darwin():
+    locations = [
+        "/Library/Fonts",
+        "/Network/Library/Fonts",
+        "/System/Library/Fonts",
+        "/System/Library/Fonts/Supplemental",
+    ]
+
+    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}" for loc in os.listdir(strange_root)]
+
+    fonts = {}
+
+    for location in locations:
+        if not exists(location):
+            continue
+
+        files = os.listdir(location)
+        for file in files:
+            name, extension = splitext(file)
+            if extension in OpenType_extensions:
+                _parse_font_entry_darwin(name, join(location, file), fonts)
+
+    return fonts
+
+
+def initsysfonts_darwin():
+    """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
+
+
+# read the fonts on unix
+def initsysfonts_unix(path="fc-list"):
+    """use the fc-list from fontconfig to get a list of fonts"""
+    fonts = {}
+
+    if sys.platform == "emscripten":
+        return fonts
+
+    try:
+        proc = subprocess.run(
+            [path, ":", "file", "family", "style"],
+            stdout=subprocess.PIPE,  # capture stdout
+            stderr=subprocess.PIPE,  # capture stderr
+            check=True,  # so that errors raise python exception which is handled below
+            timeout=1,  # so that we don't hang the program waiting
+        )
+
+    except FileNotFoundError:
+        warnings.warn(
+            f"'{path}' is missing, system fonts cannot be loaded on your platform"
+        )
+
+    except subprocess.TimeoutExpired:
+        warnings.warn(
+            f"Process running '{path}' timed-out! System fonts cannot be loaded on "
+            "your platform"
+        )
+
+    except subprocess.CalledProcessError as e:
+        warnings.warn(
+            f"'{path}' failed with error code {e.returncode}! System fonts cannot be "
+            f"loaded on your platform. Error log is:\n{e.stderr}"
+        )
+
+    else:
+        for entry in proc.stdout.decode("ascii", "ignore").splitlines():
+            try:
+                _parse_font_entry_unix(entry, fonts)
+            except ValueError:  # noqa: PERF203
+                # try the next one.
+                pass
+
+    return fonts
+
+
+def _parse_font_entry_unix(entry, fonts):
+    """
+    Parses an entry in the unix font data to add to the pygame font
+    dictionary.
+
+    :param entry: A entry from the unix font list.
+    :param fonts: The pygame font dictionary to add the parsed font data to.
+
+    """
+    filename, family, style = entry.split(":", 2)
+    if splitext(filename)[1].lower() in OpenType_extensions:
+        bold = "Bold" in style
+        italic = "Italic" in style
+        oblique = "Oblique" in style
+        for name in family.strip().split(","):
+            if name:
+                break
+        else:
+            name = splitext(basename(filename))[0]
+
+        _addfont(_simplename(name), bold, italic or oblique, filename, fonts)
+
+
+def create_aliases():
+    """Map common fonts that are absent from the system to similar fonts
+    that are installed in the system
+    """
+    alias_groups = (
+        (
+            "monospace",
+            "misc-fixed",
+            "courier",
+            "couriernew",
+            "console",
+            "fixed",
+            "mono",
+            "freemono",
+            "bitstreamverasansmono",
+            "verasansmono",
+            "monotype",
+            "lucidaconsole",
+            "consolas",
+            "dejavusansmono",
+            "liberationmono",
+        ),
+        (
+            "sans",
+            "arial",
+            "helvetica",
+            "swiss",
+            "freesans",
+            "bitstreamverasans",
+            "verasans",
+            "verdana",
+            "tahoma",
+            "calibri",
+            "gillsans",
+            "segoeui",
+            "trebuchetms",
+            "ubuntu",
+            "dejavusans",
+            "liberationsans",
+        ),
+        (
+            "serif",
+            "times",
+            "freeserif",
+            "bitstreamveraserif",
+            "roman",
+            "timesroman",
+            "timesnewroman",
+            "dutch",
+            "veraserif",
+            "georgia",
+            "cambria",
+            "constantia",
+            "dejavuserif",
+            "liberationserif",
+        ),
+        ("wingdings", "wingbats"),
+        ("comicsansms", "comicsans"),
+    )
+    for alias_set in alias_groups:
+        for name in alias_set:
+            if name in Sysfonts:
+                found = Sysfonts[name]
+                break
+        else:
+            continue
+        for name in alias_set:
+            if name not in Sysfonts:
+                Sysalias[name] = found
+
+
+def initsysfonts():
+    """
+    Initialise the sysfont module, called once. Locates the installed fonts
+    and creates some aliases for common font categories.
+
+    Has different initialisation functions for different platforms.
+    """
+    global is_init
+    if is_init:
+        # no need to re-init
+        return
+
+    if sys.platform == "win32":
+        fonts = initsysfonts_win32()
+    elif sys.platform == "darwin":
+        fonts = initsysfonts_darwin()
+    else:
+        fonts = initsysfonts_unix()
+
+    Sysfonts.update(fonts)
+    create_aliases()
+    is_init = True
+
+
+def font_constructor(fontpath, size, bold, italic):
+    """
+    pygame.font specific declarations
+
+    :param fontpath: path to a font.
+    :param size: size of a font.
+    :param bold: bold style, True or False.
+    :param italic: italic style, True or False.
+
+    :return: A font.Font object.
+    """
+
+    font = Font(fontpath, size)
+    if bold:
+        font.set_bold(True)
+    if italic:
+        font.set_italic(True)
+
+    return font
+
+
+# the exported functions
+
+
+def SysFont(name, size, bold=False, italic=False, constructor=None):
+    """pygame.font.SysFont(name, size, bold=False, italic=False, constructor=None) -> Font
+    Create a pygame Font from system font resources.
+
+    This will search the system fonts for the given font
+    name. You can also enable bold or italic styles, and
+    the appropriate system font will be selected if available.
+
+    This will always return a valid Font object, and will
+    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
+    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
+    a Font instance. If None, a pygame.font.Font object is created.
+    """
+    if constructor is None:
+        constructor = font_constructor
+
+    initsysfonts()
+
+    gotbold = gotitalic = False
+    fontname = None
+    if name:
+        if isinstance(name, (str, bytes)):
+            name = name.split(b"," if isinstance(name, bytes) else ",")
+        for single_name in name:
+            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
+
+    set_bold = set_italic = False
+    if bold and not gotbold:
+        set_bold = True
+    if italic and not gotitalic:
+        set_italic = True
+
+    return constructor(fontname, size, set_bold, set_italic)
+
+
+def get_fonts():
+    """pygame.font.get_fonts() -> list
+    get a list of system font names
+
+    Returns the list of all found system fonts. Note that
+    the names of the fonts will be all lowercase with spaces
+    removed. This is how pygame internally stores the font
+    names for matching.
+    """
+    initsysfonts()
+    return list(Sysfonts)
+
+
+def match_font(name, bold=False, italic=False):
+    """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()
+    function, only it returns the path to the TTF file
+    that would be loaded. The font name can also be an
+    iterable of font names or a string/bytes of comma-separated
+    font names to try.
+
+    If no match is found, None is returned.
+    """
+    initsysfonts()
+
+    fontname = None
+    if isinstance(name, (str, bytes)):
+        name = name.split(b"," if isinstance(name, bytes) else ",")
+
+    for single_name in name:
+        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:
+            while not fontname:
+                fontname = styles.get((bold, italic))
+                if italic:
+                    italic = 0
+                elif bold:
+                    bold = 0
+                elif not fontname:
+                    fontname = list(styles.values())[0]
+
+        if fontname:
+            break
+
+    return fontname
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__init__.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__init__.py
new file mode 100644
index 0000000..dd26586
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__init__.py
@@ -0,0 +1,40 @@
+"""Pygame unit test suite package
+
+Exports function run()
+
+A quick way to run the test suite package from the command line
+is by importing the go submodule:
+
+python -m "import pygame.tests" []
+
+Command line option --help displays a usage message. Available options
+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, 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
+directly.
+
+"""
+
+if __name__ == "pygame.tests":
+    from pygame.tests.test_utils.run_tests import run
+elif __name__ == "__main__":
+    import os
+    import sys
+
+    pkg_dir = os.path.split(os.path.abspath(__file__))[0]
+    parent_dir, pkg_name = os.path.split(pkg_dir)
+    is_pygame_pkg = pkg_name == "tests" and os.path.split(parent_dir)[1] == "pygame"
+    if not is_pygame_pkg:
+        sys.path.insert(0, parent_dir)
+
+    if is_pygame_pkg:
+        import pygame.tests.__main__
+    else:
+        import test.__main__
+else:
+    from test.test_utils.run_tests import run
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__main__.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__main__.py
new file mode 100644
index 0000000..9b4cedd
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__main__.py
@@ -0,0 +1,143 @@
+"""Load and run the Pygame test suite
+
+python -c "import pygame.tests.go" []
+
+or
+
+python test/go.py []
+
+Command line option --help displays a command line usage message.
+
+run_tests.py in the main distribution directory is an alternative to test.go
+
+"""
+
+import sys
+
+if __name__ == "__main__":
+    import os
+
+    pkg_dir = os.path.split(os.path.abspath(__file__))[0]
+    parent_dir, pkg_name = os.path.split(pkg_dir)
+    is_pygame_pkg = pkg_name == "tests" and os.path.split(parent_dir)[1] == "pygame"
+    if not is_pygame_pkg:
+        sys.path.insert(0, parent_dir)
+else:
+    is_pygame_pkg = __name__.startswith("pygame.tests.")
+
+if is_pygame_pkg:
+    from pygame.tests.test_utils.run_tests import run_and_exit
+    from pygame.tests.test_utils.test_runner import opt_parser
+else:
+    from test.test_utils.run_tests import run_and_exit
+    from test.test_utils.test_runner import opt_parser
+
+if is_pygame_pkg:
+    test_pkg_name = "pygame.tests"
+else:
+    test_pkg_name = "test"
+program_name = sys.argv[0]
+if program_name == "-c":
+    program_name = f'python -c "import {test_pkg_name}.go"'
+
+###########################################################################
+# Set additional command line options
+#
+# Defined in test_runner.py as it shares options, added to here
+
+opt_parser.set_usage(
+    f"""
+
+Runs all or some of the {test_pkg_name}.xxxx_test tests.
+
+$ {program_name} sprite threads -sd
+
+Runs the sprite and threads module tests isolated in subprocesses, dumping
+all failing tests info in the form of a dict.
+
+"""
+)
+
+opt_parser.add_option(
+    "-d", "--dump", action="store_true", help="dump results as dict ready to eval"
+)
+
+opt_parser.add_option("-F", "--file", help="dump results to a file")
+
+opt_parser.add_option(
+    "-m",
+    "--multi_thread",
+    metavar="THREADS",
+    type="int",
+    help="run subprocessed tests in x THREADS",
+)
+
+opt_parser.add_option(
+    "-t",
+    "--time_out",
+    metavar="SECONDS",
+    type="int",
+    help="kill stalled subprocessed tests after SECONDS",
+)
+
+opt_parser.add_option(
+    "-f", "--fake", metavar="DIR", help="run fake tests in run_tests__tests/$DIR"
+)
+
+opt_parser.add_option(
+    "-p",
+    "--python",
+    metavar="PYTHON",
+    help="path to python executable to run subproccesed tests\n"
+    "default (sys.executable): %s" % sys.executable,
+)
+
+opt_parser.add_option(
+    "-I",
+    "--interactive",
+    action="store_true",
+    help="include tests requiring user input",
+)
+
+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 argumemts.
+
+options, args = opt_parser.parse_args()
+kwds = {}
+if options.incomplete:
+    kwds["incomplete"] = True
+if options.usesubprocess:
+    kwds["usesubprocess"] = True
+else:
+    kwds["usesubprocess"] = False
+if options.dump:
+    kwds["dump"] = True
+if options.file:
+    kwds["file"] = options.file
+if options.exclude:
+    kwds["exclude"] = options.exclude
+if options.unbuffered:
+    kwds["unbuffered"] = True
+if options.randomize:
+    kwds["randomize"] = True
+if options.seed is not None:
+    kwds["seed"] = options.seed
+if options.multi_thread is not None:
+    kwds["multi_thread"] = options.multi_thread
+if options.time_out is not None:
+    kwds["time_out"] = options.time_out
+if options.fake:
+    kwds["fake"] = options.fake
+if options.python:
+    kwds["python"] = options.python
+if options.interactive:
+    kwds["interactive"] = True
+kwds["verbosity"] = options.verbosity if options.verbosity is not None else 1
+
+
+###########################################################################
+# Run the test suite.
+run_and_exit(*args, **kwds)
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/__init__.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/__init__.cpython-312.pyc
new file mode 100644
index 0000000..c101560
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/__init__.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/__main__.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/__main__.cpython-312.pyc
new file mode 100644
index 0000000..138eed6
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/__main__.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/base_test.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/base_test.cpython-312.pyc
new file mode 100644
index 0000000..60fd4d2
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/base_test.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/blit_test.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/blit_test.cpython-312.pyc
new file mode 100644
index 0000000..834f82f
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/blit_test.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/bufferproxy_test.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/bufferproxy_test.cpython-312.pyc
new file mode 100644
index 0000000..6642bcf
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/bufferproxy_test.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/camera_test.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/camera_test.cpython-312.pyc
new file mode 100644
index 0000000..17e52de
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/camera_test.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/color_test.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/color_test.cpython-312.pyc
new file mode 100644
index 0000000..37c3371
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/color_test.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/constants_test.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/constants_test.cpython-312.pyc
new file mode 100644
index 0000000..01af44c
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/constants_test.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/controller_test.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/controller_test.cpython-312.pyc
new file mode 100644
index 0000000..3ec00e6
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/controller_test.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/cursors_test.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/cursors_test.cpython-312.pyc
new file mode 100644
index 0000000..ea327e5
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/cursors_test.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/display_test.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/display_test.cpython-312.pyc
new file mode 100644
index 0000000..f22e4e1
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/display_test.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/docs_test.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/docs_test.cpython-312.pyc
new file mode 100644
index 0000000..b9163be
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/docs_test.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/draw_test.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/draw_test.cpython-312.pyc
new file mode 100644
index 0000000..cd6c9ba
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/draw_test.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/event_test.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/event_test.cpython-312.pyc
new file mode 100644
index 0000000..78850df
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/event_test.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/font_test.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/font_test.cpython-312.pyc
new file mode 100644
index 0000000..8330bf9
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/font_test.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/freetype_tags.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/freetype_tags.cpython-312.pyc
new file mode 100644
index 0000000..54c599d
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/freetype_tags.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/freetype_test.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/freetype_test.cpython-312.pyc
new file mode 100644
index 0000000..0ffa677
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/freetype_test.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/ftfont_tags.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/ftfont_tags.cpython-312.pyc
new file mode 100644
index 0000000..cb6c898
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/ftfont_tags.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/ftfont_test.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/ftfont_test.cpython-312.pyc
new file mode 100644
index 0000000..3dddeff
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/ftfont_test.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/gfxdraw_test.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/gfxdraw_test.cpython-312.pyc
new file mode 100644
index 0000000..8625798
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/gfxdraw_test.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/image__save_gl_surface_test.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/image__save_gl_surface_test.cpython-312.pyc
new file mode 100644
index 0000000..fd8c889
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/image__save_gl_surface_test.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/image_tags.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/image_tags.cpython-312.pyc
new file mode 100644
index 0000000..61c1f55
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/image_tags.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/image_test.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/image_test.cpython-312.pyc
new file mode 100644
index 0000000..bd55358
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/image_test.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/imageext_tags.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/imageext_tags.cpython-312.pyc
new file mode 100644
index 0000000..22775f8
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/imageext_tags.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/imageext_test.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/imageext_test.cpython-312.pyc
new file mode 100644
index 0000000..48752c2
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/imageext_test.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/joystick_test.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/joystick_test.cpython-312.pyc
new file mode 100644
index 0000000..0c4e499
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/joystick_test.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/key_test.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/key_test.cpython-312.pyc
new file mode 100644
index 0000000..fe7ecaf
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/key_test.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/locals_test.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/locals_test.cpython-312.pyc
new file mode 100644
index 0000000..84f8fb6
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/locals_test.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/mask_test.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/mask_test.cpython-312.pyc
new file mode 100644
index 0000000..1acdae3
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/mask_test.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/math_test.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/math_test.cpython-312.pyc
new file mode 100644
index 0000000..afb0328
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/math_test.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/midi_test.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/midi_test.cpython-312.pyc
new file mode 100644
index 0000000..60ac222
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/midi_test.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/mixer_music_tags.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/mixer_music_tags.cpython-312.pyc
new file mode 100644
index 0000000..2bdcd55
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/mixer_music_tags.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/mixer_music_test.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/mixer_music_test.cpython-312.pyc
new file mode 100644
index 0000000..215eab1
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/mixer_music_test.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/mixer_tags.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/mixer_tags.cpython-312.pyc
new file mode 100644
index 0000000..5c17cc0
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/mixer_tags.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/mixer_test.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/mixer_test.cpython-312.pyc
new file mode 100644
index 0000000..1a33ed8
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/mixer_test.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/mouse_test.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/mouse_test.cpython-312.pyc
new file mode 100644
index 0000000..e4092f8
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/mouse_test.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/pixelarray_test.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/pixelarray_test.cpython-312.pyc
new file mode 100644
index 0000000..6c372a1
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/pixelarray_test.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/pixelcopy_test.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/pixelcopy_test.cpython-312.pyc
new file mode 100644
index 0000000..1993570
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/pixelcopy_test.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/rect_test.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/rect_test.cpython-312.pyc
new file mode 100644
index 0000000..9675168
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/rect_test.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/rwobject_test.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/rwobject_test.cpython-312.pyc
new file mode 100644
index 0000000..7598a6b
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/rwobject_test.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/scrap_tags.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/scrap_tags.cpython-312.pyc
new file mode 100644
index 0000000..e7f434d
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/scrap_tags.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/scrap_test.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/scrap_test.cpython-312.pyc
new file mode 100644
index 0000000..b4eb445
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/scrap_test.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/sndarray_tags.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/sndarray_tags.cpython-312.pyc
new file mode 100644
index 0000000..3be1148
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/sndarray_tags.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/sndarray_test.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/sndarray_test.cpython-312.pyc
new file mode 100644
index 0000000..e68de8b
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/sndarray_test.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/sprite_test.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/sprite_test.cpython-312.pyc
new file mode 100644
index 0000000..07f0cd3
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/sprite_test.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/surface_test.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/surface_test.cpython-312.pyc
new file mode 100644
index 0000000..5336182
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/surface_test.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/surfarray_tags.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/surfarray_tags.cpython-312.pyc
new file mode 100644
index 0000000..afa2024
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/surfarray_tags.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/surfarray_test.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/surfarray_test.cpython-312.pyc
new file mode 100644
index 0000000..dc60062
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/surfarray_test.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/surflock_test.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/surflock_test.cpython-312.pyc
new file mode 100644
index 0000000..309d8ed
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/surflock_test.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/sysfont_test.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/sysfont_test.cpython-312.pyc
new file mode 100644
index 0000000..e57bd4a
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/sysfont_test.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/threads_test.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/threads_test.cpython-312.pyc
new file mode 100644
index 0000000..28267aa
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/threads_test.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/time_test.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/time_test.cpython-312.pyc
new file mode 100644
index 0000000..1b7594b
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/time_test.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/touch_test.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/touch_test.cpython-312.pyc
new file mode 100644
index 0000000..9681aef
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/touch_test.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/transform_test.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/transform_test.cpython-312.pyc
new file mode 100644
index 0000000..cafc14e
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/transform_test.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/version_test.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/version_test.cpython-312.pyc
new file mode 100644
index 0000000..50a8577
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/version_test.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/video_test.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/video_test.cpython-312.pyc
new file mode 100644
index 0000000..28cf5c6
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/__pycache__/video_test.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/base_test.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/base_test.py
new file mode 100644
index 0000000..b11d2d6
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/base_test.py
@@ -0,0 +1,623 @@
+import sys
+import unittest
+
+import platform
+
+IS_PYPY = "PyPy" == platform.python_implementation()
+
+try:
+    from pygame.tests.test_utils import arrinter
+except NameError:
+    pass
+import pygame
+
+
+quit_count = 0
+
+
+def quit_hook():
+    global quit_count
+    quit_count += 1
+
+
+class BaseModuleTest(unittest.TestCase):
+    def tearDown(self):
+        # Clean up after each test method.
+        pygame.quit()
+
+    def test_get_sdl_byteorder(self):
+        """Ensure the SDL byte order is valid"""
+        byte_order = pygame.get_sdl_byteorder()
+        expected_options = (pygame.LIL_ENDIAN, pygame.BIG_ENDIAN)
+
+        self.assertIn(byte_order, expected_options)
+
+    def test_get_sdl_version(self):
+        """Ensure the SDL version is valid"""
+        self.assertEqual(len(pygame.get_sdl_version()), 3)
+
+    class ExporterBase:
+        def __init__(self, shape, typechar, itemsize):
+            import ctypes
+
+            ndim = len(shape)
+            self.ndim = ndim
+            self.shape = tuple(shape)
+            array_len = 1
+            for d in shape:
+                array_len *= d
+            self.size = itemsize * array_len
+            self.parent = ctypes.create_string_buffer(self.size)
+            self.itemsize = itemsize
+            strides = [itemsize] * ndim
+            for i in range(ndim - 1, 0, -1):
+                strides[i - 1] = strides[i] * shape[i]
+            self.strides = tuple(strides)
+            self.data = ctypes.addressof(self.parent), False
+            if self.itemsize == 1:
+                byteorder = "|"
+            elif sys.byteorder == "big":
+                byteorder = ">"
+            else:
+                byteorder = "<"
+            self.typestr = byteorder + typechar + str(self.itemsize)
+
+    def assertSame(self, proxy, obj):
+        self.assertEqual(proxy.length, obj.size)
+        iface = proxy.__array_interface__
+        self.assertEqual(iface["typestr"], obj.typestr)
+        self.assertEqual(iface["shape"], obj.shape)
+        self.assertEqual(iface["strides"], obj.strides)
+        self.assertEqual(iface["data"], obj.data)
+
+    def test_PgObject_GetBuffer_array_interface(self):
+        from pygame.bufferproxy import BufferProxy
+
+        class Exporter(self.ExporterBase):
+            def get__array_interface__(self):
+                return {
+                    "version": 3,
+                    "typestr": self.typestr,
+                    "shape": self.shape,
+                    "strides": self.strides,
+                    "data": self.data,
+                }
+
+            __array_interface__ = property(get__array_interface__)
+            # Should be ignored by PgObject_GetBuffer
+            __array_struct__ = property(lambda self: None)
+
+        _shape = [2, 3, 5, 7, 11]  # Some prime numbers
+        for ndim in range(1, len(_shape)):
+            o = Exporter(_shape[0:ndim], "i", 2)
+            v = BufferProxy(o)
+            self.assertSame(v, o)
+        ndim = 2
+        shape = _shape[0:ndim]
+        for typechar in ("i", "u"):
+            for itemsize in (1, 2, 4, 8):
+                o = Exporter(shape, typechar, itemsize)
+                v = BufferProxy(o)
+                self.assertSame(v, o)
+        for itemsize in (4, 8):
+            o = Exporter(shape, "f", itemsize)
+            v = BufferProxy(o)
+            self.assertSame(v, o)
+
+        # Is the dict received from an exporting object properly released?
+        # The dict should be freed before PgObject_GetBuffer returns.
+        # When the BufferProxy v's length property is referenced, v calls
+        # PgObject_GetBuffer, which in turn references Exporter2 o's
+        # __array_interface__ property. The Exporter2 instance o returns a
+        # dict subclass for which it keeps both a regular reference and a
+        # weak reference. The regular reference should be the only
+        # remaining reference when PgObject_GetBuffer returns. This is
+        # verified by first checking the weak reference both before and
+        # after the regular reference held by o is removed.
+
+        import weakref, gc
+
+        class NoDictError(RuntimeError):
+            pass
+
+        class WRDict(dict):
+            """Weak referenceable dict"""
+
+            pass
+
+        class Exporter2(Exporter):
+            def get__array_interface__2(self):
+                self.d = WRDict(Exporter.get__array_interface__(self))
+                self.dict_ref = weakref.ref(self.d)
+                return self.d
+
+            __array_interface__ = property(get__array_interface__2)
+
+            def free_dict(self):
+                self.d = None
+
+            def is_dict_alive(self):
+                try:
+                    return self.dict_ref() is not None
+                except AttributeError:
+                    raise NoDictError("__array_interface__ is unread")
+
+        o = Exporter2((2, 4), "u", 4)
+        v = BufferProxy(o)
+        self.assertRaises(NoDictError, o.is_dict_alive)
+        length = v.length
+        self.assertTrue(o.is_dict_alive())
+        o.free_dict()
+        gc.collect()
+        self.assertFalse(o.is_dict_alive())
+
+    def test_GetView_array_struct(self):
+        from pygame.bufferproxy import BufferProxy
+
+        class Exporter(self.ExporterBase):
+            def __init__(self, shape, typechar, itemsize):
+                super().__init__(shape, typechar, itemsize)
+                self.view = BufferProxy(self.__dict__)
+
+            def get__array_struct__(self):
+                return self.view.__array_struct__
+
+            __array_struct__ = property(get__array_struct__)
+            # Should not cause PgObject_GetBuffer to fail
+            __array_interface__ = property(lambda self: None)
+
+        _shape = [2, 3, 5, 7, 11]  # Some prime numbers
+        for ndim in range(1, len(_shape)):
+            o = Exporter(_shape[0:ndim], "i", 2)
+            v = BufferProxy(o)
+            self.assertSame(v, o)
+        ndim = 2
+        shape = _shape[0:ndim]
+        for typechar in ("i", "u"):
+            for itemsize in (1, 2, 4, 8):
+                o = Exporter(shape, typechar, itemsize)
+                v = BufferProxy(o)
+                self.assertSame(v, o)
+        for itemsize in (4, 8):
+            o = Exporter(shape, "f", itemsize)
+            v = BufferProxy(o)
+            self.assertSame(v, o)
+
+        # Check returned cobject/capsule reference count
+        try:
+            from sys import getrefcount
+        except ImportError:
+            # PyPy: no reference counting
+            pass
+        else:
+            o = Exporter(shape, typechar, itemsize)
+            self.assertEqual(getrefcount(o.__array_struct__), 1)
+
+    if pygame.HAVE_NEWBUF:
+        from pygame.tests.test_utils import buftools
+
+    def NEWBUF_assertSame(self, proxy, exp):
+        buftools = self.buftools
+        Importer = buftools.Importer
+        self.assertEqual(proxy.length, exp.len)
+        imp = Importer(proxy, buftools.PyBUF_RECORDS_RO)
+        self.assertEqual(imp.readonly, exp.readonly)
+        self.assertEqual(imp.format, exp.format)
+        self.assertEqual(imp.itemsize, exp.itemsize)
+        self.assertEqual(imp.ndim, exp.ndim)
+        self.assertEqual(imp.shape, exp.shape)
+        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
+
+        Exporter = self.buftools.Exporter
+        _shape = [2, 3, 5, 7, 11]  # Some prime numbers
+        for ndim in range(1, len(_shape)):
+            o = Exporter(_shape[0:ndim], "=h")
+            v = BufferProxy(o)
+            self.NEWBUF_assertSame(v, o)
+        ndim = 2
+        shape = _shape[0:ndim]
+        for format in [
+            "b",
+            "B",
+            "=h",
+            "=H",
+            "=i",
+            "=I",
+            "=q",
+            "=Q",
+            "f",
+            "d",
+            "1h",
+            "=1h",
+            "x",
+            "1x",
+            "2x",
+            "3x",
+            "4x",
+            "5x",
+            "6x",
+            "7x",
+            "8x",
+            "9x",
+        ]:
+            o = Exporter(shape, format)
+            v = BufferProxy(o)
+            self.NEWBUF_assertSame(v, o)
+
+    @unittest.skipIf(not pygame.HAVE_NEWBUF, "newbuf not implemented")
+    def test_bad_format(self):
+        from pygame.bufferproxy import BufferProxy
+        from pygame.newbuffer import BufferMixin
+        from ctypes import create_string_buffer, addressof
+
+        buftools = self.buftools
+        Exporter = buftools.Exporter
+        Importer = buftools.Importer
+        PyBUF_FORMAT = buftools.PyBUF_FORMAT
+
+        for format in [
+            "",
+            "=",
+            "1",
+            " ",
+            "2h",
+            "=2h",
+            "0x",
+            "11x",
+            "=!",
+            "h ",
+            " h",
+            "hh",
+            "?",
+        ]:
+            exp = Exporter((1,), format, itemsize=2)
+            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
+
+        is_lil_endian = pygame.get_sdl_byteorder() == pygame.LIL_ENDIAN
+        fsys, frev = ("<", ">") if is_lil_endian else (">", "<")
+        buftools = self.buftools
+        Importer = buftools.Importer
+        a = BufferProxy(
+            {"typestr": "|u4", "shape": (10, 2), "data": (9, False)}
+        )  # 9? No data accesses.
+        b = Importer(a, buftools.PyBUF_SIMPLE)
+        self.assertEqual(b.ndim, 0)
+        self.assertTrue(b.format is None)
+        self.assertEqual(b.len, a.length)
+        self.assertEqual(b.itemsize, 4)
+        self.assertTrue(b.shape is None)
+        self.assertTrue(b.strides is None)
+        self.assertTrue(b.suboffsets is None)
+        self.assertFalse(b.readonly)
+        self.assertEqual(b.buf, 9)
+        b = Importer(a, buftools.PyBUF_WRITABLE)
+        self.assertEqual(b.ndim, 0)
+        self.assertTrue(b.format is None)
+        self.assertEqual(b.len, a.length)
+        self.assertEqual(b.itemsize, 4)
+        self.assertTrue(b.shape is None)
+        self.assertTrue(b.strides is None)
+        self.assertTrue(b.suboffsets is None)
+        self.assertFalse(b.readonly)
+        self.assertEqual(b.buf, 9)
+        b = Importer(a, buftools.PyBUF_ND)
+        self.assertEqual(b.ndim, 2)
+        self.assertTrue(b.format is None)
+        self.assertEqual(b.len, a.length)
+        self.assertEqual(b.itemsize, 4)
+        self.assertEqual(b.shape, (10, 2))
+        self.assertTrue(b.strides is None)
+        self.assertTrue(b.suboffsets is None)
+        self.assertFalse(b.readonly)
+        self.assertEqual(b.buf, 9)
+        a = BufferProxy(
+            {
+                "typestr": fsys + "i2",
+                "shape": (5, 10),
+                "strides": (24, 2),
+                "data": (42, False),
+            }
+        )  # 42? No data accesses.
+        b = Importer(a, buftools.PyBUF_STRIDES)
+        self.assertEqual(b.ndim, 2)
+        self.assertTrue(b.format is None)
+        self.assertEqual(b.len, 100)
+        self.assertEqual(b.itemsize, 2)
+        self.assertEqual(b.shape, (5, 10))
+        self.assertEqual(b.strides, (24, 2))
+        self.assertTrue(b.suboffsets is None)
+        self.assertFalse(b.readonly)
+        self.assertEqual(b.buf, 42)
+        b = Importer(a, buftools.PyBUF_FULL_RO)
+        self.assertEqual(b.ndim, 2)
+        self.assertEqual(b.format, "=h")
+        self.assertEqual(b.len, 100)
+        self.assertEqual(b.itemsize, 2)
+        self.assertEqual(b.shape, (5, 10))
+        self.assertEqual(b.strides, (24, 2))
+        self.assertTrue(b.suboffsets is None)
+        self.assertFalse(b.readonly)
+        self.assertEqual(b.buf, 42)
+        self.assertRaises(BufferError, Importer, a, buftools.PyBUF_SIMPLE)
+        self.assertRaises(BufferError, Importer, a, buftools.PyBUF_ND)
+        self.assertRaises(BufferError, Importer, a, buftools.PyBUF_C_CONTIGUOUS)
+        self.assertRaises(BufferError, Importer, a, buftools.PyBUF_F_CONTIGUOUS)
+        self.assertRaises(BufferError, Importer, a, buftools.PyBUF_ANY_CONTIGUOUS)
+        self.assertRaises(BufferError, Importer, a, buftools.PyBUF_CONTIG)
+        self.assertRaises(BufferError, Importer, a, buftools.PyBUF_SIMPLE)
+        self.assertRaises(BufferError, Importer, a, buftools.PyBUF_ND)
+        self.assertRaises(BufferError, Importer, a, buftools.PyBUF_C_CONTIGUOUS)
+        self.assertRaises(BufferError, Importer, a, buftools.PyBUF_F_CONTIGUOUS)
+        self.assertRaises(BufferError, Importer, a, buftools.PyBUF_ANY_CONTIGUOUS)
+        self.assertRaises(BufferError, Importer, a, buftools.PyBUF_CONTIG)
+        a = BufferProxy(
+            {
+                "typestr": frev + "i2",
+                "shape": (3, 5, 10),
+                "strides": (120, 24, 2),
+                "data": (1000000, True),
+            }
+        )  # 1000000? No data accesses.
+        b = Importer(a, buftools.PyBUF_FULL_RO)
+        self.assertEqual(b.ndim, 3)
+        self.assertEqual(b.format, frev + "h")
+        self.assertEqual(b.len, 300)
+        self.assertEqual(b.itemsize, 2)
+        self.assertEqual(b.shape, (3, 5, 10))
+        self.assertEqual(b.strides, (120, 24, 2))
+        self.assertTrue(b.suboffsets is None)
+        self.assertTrue(b.readonly)
+        self.assertEqual(b.buf, 1000000)
+        self.assertRaises(BufferError, Importer, a, buftools.PyBUF_FULL)
+
+    @unittest.skipIf(IS_PYPY or (not pygame.HAVE_NEWBUF), "newbuf with ctypes")
+    def test_PgObject_AsBuffer_PyBUF_flags(self):
+        from pygame.bufferproxy import BufferProxy
+        import ctypes
+
+        is_lil_endian = pygame.get_sdl_byteorder() == pygame.LIL_ENDIAN
+        fsys, frev = ("<", ">") if is_lil_endian else (">", "<")
+        buftools = self.buftools
+        Importer = buftools.Importer
+        e = arrinter.Exporter(
+            (10, 2), typekind="f", itemsize=ctypes.sizeof(ctypes.c_double)
+        )
+        a = BufferProxy(e)
+        b = Importer(a, buftools.PyBUF_SIMPLE)
+        self.assertEqual(b.ndim, 0)
+        self.assertTrue(b.format is None)
+        self.assertEqual(b.len, e.len)
+        self.assertEqual(b.itemsize, e.itemsize)
+        self.assertTrue(b.shape is None)
+        self.assertTrue(b.strides is None)
+        self.assertTrue(b.suboffsets is None)
+        self.assertFalse(b.readonly)
+        self.assertEqual(b.buf, e.data)
+        b = Importer(a, buftools.PyBUF_WRITABLE)
+        self.assertEqual(b.ndim, 0)
+        self.assertTrue(b.format is None)
+        self.assertEqual(b.len, e.len)
+        self.assertEqual(b.itemsize, e.itemsize)
+        self.assertTrue(b.shape is None)
+        self.assertTrue(b.strides is None)
+        self.assertTrue(b.suboffsets is None)
+        self.assertFalse(b.readonly)
+        self.assertEqual(b.buf, e.data)
+        b = Importer(a, buftools.PyBUF_ND)
+        self.assertEqual(b.ndim, e.nd)
+        self.assertTrue(b.format is None)
+        self.assertEqual(b.len, a.length)
+        self.assertEqual(b.itemsize, e.itemsize)
+        self.assertEqual(b.shape, e.shape)
+        self.assertTrue(b.strides is None)
+        self.assertTrue(b.suboffsets is None)
+        self.assertFalse(b.readonly)
+        self.assertEqual(b.buf, e.data)
+        e = arrinter.Exporter((5, 10), typekind="i", itemsize=2, strides=(24, 2))
+        a = BufferProxy(e)
+        b = Importer(a, buftools.PyBUF_STRIDES)
+        self.assertEqual(b.ndim, e.nd)
+        self.assertTrue(b.format is None)
+        self.assertEqual(b.len, e.len)
+        self.assertEqual(b.itemsize, e.itemsize)
+        self.assertEqual(b.shape, e.shape)
+        self.assertEqual(b.strides, e.strides)
+        self.assertTrue(b.suboffsets is None)
+        self.assertFalse(b.readonly)
+        self.assertEqual(b.buf, e.data)
+        b = Importer(a, buftools.PyBUF_FULL_RO)
+        self.assertEqual(b.ndim, e.nd)
+        self.assertEqual(b.format, "=h")
+        self.assertEqual(b.len, e.len)
+        self.assertEqual(b.itemsize, e.itemsize)
+        self.assertEqual(b.shape, e.shape)
+        self.assertEqual(b.strides, e.strides)
+        self.assertTrue(b.suboffsets is None)
+        self.assertFalse(b.readonly)
+        self.assertEqual(b.buf, e.data)
+        self.assertRaises(BufferError, Importer, a, buftools.PyBUF_SIMPLE)
+        self.assertRaises(BufferError, Importer, a, buftools.PyBUF_WRITABLE)
+        self.assertRaises(BufferError, Importer, a, buftools.PyBUF_WRITABLE)
+        self.assertRaises(BufferError, Importer, a, buftools.PyBUF_ND)
+        self.assertRaises(BufferError, Importer, a, buftools.PyBUF_C_CONTIGUOUS)
+        self.assertRaises(BufferError, Importer, a, buftools.PyBUF_F_CONTIGUOUS)
+        self.assertRaises(BufferError, Importer, a, buftools.PyBUF_ANY_CONTIGUOUS)
+        self.assertRaises(BufferError, Importer, a, buftools.PyBUF_CONTIG)
+        self.assertRaises(BufferError, Importer, a, buftools.PyBUF_SIMPLE)
+        self.assertRaises(BufferError, Importer, a, buftools.PyBUF_ND)
+        self.assertRaises(BufferError, Importer, a, buftools.PyBUF_C_CONTIGUOUS)
+        self.assertRaises(BufferError, Importer, a, buftools.PyBUF_F_CONTIGUOUS)
+        self.assertRaises(BufferError, Importer, a, buftools.PyBUF_ANY_CONTIGUOUS)
+        self.assertRaises(BufferError, Importer, a, buftools.PyBUF_CONTIG)
+        e = arrinter.Exporter(
+            (3, 5, 10),
+            typekind="i",
+            itemsize=2,
+            strides=(120, 24, 2),
+            flags=arrinter.PAI_ALIGNED,
+        )
+        a = BufferProxy(e)
+        b = Importer(a, buftools.PyBUF_FULL_RO)
+        self.assertEqual(b.ndim, e.nd)
+        self.assertEqual(b.format, frev + "h")
+        self.assertEqual(b.len, e.len)
+        self.assertEqual(b.itemsize, e.itemsize)
+        self.assertEqual(b.shape, e.shape)
+        self.assertEqual(b.strides, e.strides)
+        self.assertTrue(b.suboffsets is None)
+        self.assertTrue(b.readonly)
+        self.assertEqual(b.buf, e.data)
+        self.assertRaises(BufferError, Importer, a, buftools.PyBUF_FULL)
+
+    def test_PgObject_GetBuffer_exception(self):
+        # For consistency with surfarray
+        from pygame.bufferproxy import BufferProxy
+
+        bp = BufferProxy(1)
+        self.assertRaises(ValueError, getattr, bp, "length")
+
+    def not_init_assertions(self):
+        self.assertFalse(pygame.get_init(), "pygame shouldn't be initialized")
+        self.assertFalse(pygame.display.get_init(), "display shouldn't be initialized")
+
+        if "pygame.mixer" in sys.modules:
+            self.assertFalse(pygame.mixer.get_init(), "mixer shouldn't be initialized")
+
+        if "pygame.font" in sys.modules:
+            self.assertFalse(pygame.font.get_init(), "init shouldn't be initialized")
+
+        ## !!! TODO : Remove when scrap works for OS X
+        import platform
+
+        if platform.system().startswith("Darwin"):
+            return
+
+        try:
+            self.assertRaises(pygame.error, pygame.scrap.get)
+        except NotImplementedError:
+            # Scrap is optional.
+            pass
+
+        # pygame.cdrom
+        # pygame.joystick
+
+    def init_assertions(self):
+        self.assertTrue(pygame.get_init())
+        self.assertTrue(pygame.display.get_init())
+
+        if "pygame.mixer" in sys.modules:
+            self.assertTrue(pygame.mixer.get_init())
+
+        if "pygame.font" in sys.modules:
+            self.assertTrue(pygame.font.get_init())
+
+    def test_quit__and_init(self):
+        # __doc__ (as of 2008-06-25) for pygame.base.quit:
+
+        # pygame.quit(): return None
+        # uninitialize all pygame modules
+
+        # Make sure everything is not init
+        self.not_init_assertions()
+
+        # Initiate it
+        pygame.init()
+
+        # Check
+        self.init_assertions()
+
+        # Quit
+        pygame.quit()
+
+        # All modules have quit
+        self.not_init_assertions()
+
+    def test_register_quit(self):
+        """Ensure that a registered function is called on quit()"""
+        self.assertEqual(quit_count, 0)
+
+        pygame.init()
+        pygame.register_quit(quit_hook)
+        pygame.quit()
+
+        self.assertEqual(quit_count, 1)
+
+    def test_get_error(self):
+        # __doc__ (as of 2008-08-02) for pygame.base.get_error:
+
+        # pygame.get_error(): return errorstr
+        # get the current error message
+        #
+        # SDL maintains an internal error message. This message will usually
+        # be given to you when pygame.error is raised. You will rarely need to
+        # call this function.
+        #
+
+        # The first error could be all sorts of nonsense or empty.
+        e = pygame.get_error()
+        pygame.set_error("hi")
+        self.assertEqual(pygame.get_error(), "hi")
+        pygame.set_error("")
+        self.assertEqual(pygame.get_error(), "")
+
+    def test_set_error(self):
+        # The first error could be all sorts of nonsense or empty.
+        e = pygame.get_error()
+        pygame.set_error("hi")
+        self.assertEqual(pygame.get_error(), "hi")
+        pygame.set_error("")
+        self.assertEqual(pygame.get_error(), "")
+
+    def test_unicode_error(self):
+        pygame.set_error("你好")
+        self.assertEqual("你好", pygame.get_error())
+
+    def test_init(self):
+        """Ensures init() works properly."""
+        # Make sure nothing initialized.
+        self.not_init_assertions()
+
+        # display and joystick must init, at minimum
+        expected_min_passes = 2
+
+        # All modules should pass.
+        expected_fails = 0
+
+        passes, fails = pygame.init()
+
+        self.init_assertions()
+        self.assertGreaterEqual(passes, expected_min_passes)
+        self.assertEqual(fails, expected_fails)
+
+    def test_get_init(self):
+        # Test if get_init() gets the init state.
+        self.assertFalse(pygame.get_init())
+
+    def test_get_init__after_init(self):
+        # Test if get_init() gets the init state after pygame.init() called.
+        pygame.init()
+
+        self.assertTrue(pygame.get_init())
+
+    def test_get_init__after_quit(self):
+        # Test if get_init() gets the init state after pygame.quit() called.
+        pygame.init()
+        pygame.quit()
+
+        self.assertFalse(pygame.get_init())
+
+
+if __name__ == "__main__":
+    unittest.main()
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/blit_test.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/blit_test.py
new file mode 100644
index 0000000..dcd7d4c
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/blit_test.py
@@ -0,0 +1,192 @@
+import unittest
+
+import pygame
+from pygame.locals import *
+
+from time import time
+
+
+class BlitTest(unittest.TestCase):
+    def test_SRCALPHA(self):
+        """SRCALPHA tests."""
+        # blend(s, 0, d) = d
+        s = pygame.Surface((1, 1), SRCALPHA, 32)
+        s.fill((255, 255, 255, 0))
+
+        d = pygame.Surface((1, 1), SRCALPHA, 32)
+        d.fill((0, 0, 255, 255))
+
+        s.blit(d, (0, 0))
+        self.assertEqual(s.get_at((0, 0)), d.get_at((0, 0)))
+
+        # blend(s, 255, d) = s
+        s = pygame.Surface((1, 1), SRCALPHA, 32)
+        s.fill((123, 0, 0, 255))
+        s1 = pygame.Surface((1, 1), SRCALPHA, 32)
+        s1.fill((123, 0, 0, 255))
+        d = pygame.Surface((1, 1), SRCALPHA, 32)
+        d.fill((10, 0, 0, 0))
+        s.blit(d, (0, 0))
+        self.assertEqual(s.get_at((0, 0)), s1.get_at((0, 0)))
+
+        # TODO: these should be true too.
+        # blend(0, sA, 0) = 0
+        # blend(255, sA, 255) = 255
+        # blend(s, sA, d) <= 255
+
+    def test_BLEND(self):
+        """BLEND_ tests."""
+
+        # test that it doesn't overflow, and that it is saturated.
+        s = pygame.Surface((1, 1), SRCALPHA, 32)
+        s.fill((255, 255, 255, 0))
+
+        d = pygame.Surface((1, 1), SRCALPHA, 32)
+        d.fill((0, 0, 255, 255))
+
+        s.blit(d, (0, 0), None, BLEND_ADD)
+
+        # print("d %s" % (d.get_at((0,0)),))
+        # print(s.get_at((0,0)))
+        # self.assertEqual(s.get_at((0,0))[2], 255 )
+        # self.assertEqual(s.get_at((0,0))[3], 0 )
+
+        s.blit(d, (0, 0), None, BLEND_RGBA_ADD)
+        # print(s.get_at((0,0)))
+        self.assertEqual(s.get_at((0, 0))[3], 255)
+
+        # test adding works.
+        s.fill((20, 255, 255, 0))
+        d.fill((10, 0, 255, 255))
+        s.blit(d, (0, 0), None, BLEND_ADD)
+        self.assertEqual(s.get_at((0, 0))[2], 255)
+
+        # test subbing works.
+        s.fill((20, 255, 255, 0))
+        d.fill((10, 0, 255, 255))
+        s.blit(d, (0, 0), None, BLEND_SUB)
+        self.assertEqual(s.get_at((0, 0))[0], 10)
+
+        # no overflow in sub blend.
+        s.fill((20, 255, 255, 0))
+        d.fill((30, 0, 255, 255))
+        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)
+            surf = pygame.Surface((10, 10), SRCALPHA, 32)
+            color = (i * 1, i * 1, i * 1)
+            surf.fill(color)
+            blit_list.append((surf, dest))
+        return blit_list
+
+    def custom_blits(self, blit_list):
+        """Custom blits method that manually iterates over the blit_list and blits
+        each surface onto the destination."""
+
+        for surface, dest in blit_list:
+            self.dst.blit(surface, dest)
+
+    def test_custom_blits_performance(self):
+        """Checks time performance of the custom blits method"""
+
+        t0 = time()
+        results = self.custom_blits(self.blit_list)
+        t1 = time()
+        if self.PRINT_TIMING:
+            print(f"python blits: {t1 - t0}")
+
+    def test_blits_performance(self):
+        """Checks time performance of blits"""
+
+        t0 = time()
+        results = self.dst.blits(self.blit_list)
+        t1 = time()
+        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}")
+
+        # Measure time performance of blits using a generator
+        t0 = time()
+        results = self.dst.blits(((surf, dest) for surf, dest in self.blit_list))
+        t1 = time()
+        if self.PRINT_TIMING:
+            print(f"Surface.blits generator: {t1 - t0}")
+
+    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."""
+
+        results = self.dst.blits(self.blit_list)
+        for i in range(self.NUM_SURFS):
+            color = (i * 1, i * 1, i * 1)
+            self.assertEqual(self.dst.get_at((i * 10, 0)), color)
+            self.assertEqual(self.dst.get_at(((i * 10) + 5, 5)), color)
+
+        self.assertEqual(len(results), self.NUM_SURFS)
+
+    def test_blits_doreturn(self):
+        """Tests that when doreturn=0, it returns None"""
+
+        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)
+        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)
+        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)
+        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)
+        with self.assertRaises(TypeError):
+            dst.blits([(pygame.Surface((10, 10), SRCALPHA, 32), None)])
+
+
+if __name__ == "__main__":
+    unittest.main()
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/bufferproxy_test.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/bufferproxy_test.py
new file mode 100644
index 0000000..1282e35
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/bufferproxy_test.py
@@ -0,0 +1,504 @@
+import re
+import weakref
+import gc
+import ctypes
+import unittest
+
+import pygame
+from pygame.bufferproxy import BufferProxy
+
+
+try:
+    BufferError
+except NameError:
+    from pygame import BufferError
+
+
+class BufferProxyTest(unittest.TestCase):
+    view_keywords = {
+        "shape": (5, 4, 3),
+        "typestr": "|u1",
+        "data": (0, True),
+        "strides": (4, 20, 1),
+    }
+
+    def test_module_name(self):
+        self.assertEqual(pygame.bufferproxy.__name__, "pygame.bufferproxy")
+
+    def test_class_name(self):
+        self.assertEqual(BufferProxy.__name__, "BufferProxy")
+
+    def test___array_struct___property(self):
+        kwds = self.view_keywords
+        v = BufferProxy(kwds)
+        d = pygame.get_array_interface(v)
+        self.assertEqual(len(d), 5)
+        self.assertEqual(d["version"], 3)
+        self.assertEqual(d["shape"], kwds["shape"])
+        self.assertEqual(d["typestr"], kwds["typestr"])
+        self.assertEqual(d["data"], kwds["data"])
+        self.assertEqual(d["strides"], kwds["strides"])
+
+    def test___array_interface___property(self):
+        kwds = self.view_keywords
+        v = BufferProxy(kwds)
+        d = v.__array_interface__
+        self.assertEqual(len(d), 5)
+        self.assertEqual(d["version"], 3)
+        self.assertEqual(d["shape"], kwds["shape"])
+        self.assertEqual(d["typestr"], kwds["typestr"])
+        self.assertEqual(d["data"], kwds["data"])
+        self.assertEqual(d["strides"], kwds["strides"])
+
+    def test_parent_property(self):
+        kwds = dict(self.view_keywords)
+        p = []
+        kwds["parent"] = p
+        v = BufferProxy(kwds)
+
+        self.assertIs(v.parent, p)
+
+    def test_before(self):
+        def callback(parent):
+            success.append(parent is p)
+
+        class MyException(Exception):
+            pass
+
+        def raise_exception(parent):
+            raise MyException("Just a test.")
+
+        kwds = dict(self.view_keywords)
+        p = []
+        kwds["parent"] = p
+
+        # For array interface
+        success = []
+        kwds["before"] = callback
+        v = BufferProxy(kwds)
+        self.assertEqual(len(success), 0)
+        d = v.__array_interface__
+        self.assertEqual(len(success), 1)
+        self.assertTrue(success[0])
+        d = v.__array_interface__
+        self.assertEqual(len(success), 1)
+        d = v = None
+        gc.collect()
+        self.assertEqual(len(success), 1)
+
+        # For array struct
+        success = []
+        kwds["before"] = callback
+        v = BufferProxy(kwds)
+        self.assertEqual(len(success), 0)
+        c = v.__array_struct__
+        self.assertEqual(len(success), 1)
+        self.assertTrue(success[0])
+        c = v.__array_struct__
+        self.assertEqual(len(success), 1)
+        c = v = None
+        gc.collect()
+        self.assertEqual(len(success), 1)
+
+        # Callback raises an exception
+        kwds["before"] = raise_exception
+        v = BufferProxy(kwds)
+        self.assertRaises(MyException, lambda: v.__array_struct__)
+
+    def test_after(self):
+        def callback(parent):
+            success.append(parent is p)
+
+        kwds = dict(self.view_keywords)
+        p = []
+        kwds["parent"] = p
+
+        # For array interface
+        success = []
+        kwds["after"] = callback
+        v = BufferProxy(kwds)
+        self.assertEqual(len(success), 0)
+        d = v.__array_interface__
+        self.assertEqual(len(success), 0)
+        d = v.__array_interface__
+        self.assertEqual(len(success), 0)
+        d = v = None
+        gc.collect()
+        self.assertEqual(len(success), 1)
+        self.assertTrue(success[0])
+
+        # For array struct
+        success = []
+        kwds["after"] = callback
+        v = BufferProxy(kwds)
+        self.assertEqual(len(success), 0)
+        c = v.__array_struct__
+        self.assertEqual(len(success), 0)
+        c = v.__array_struct__
+        self.assertEqual(len(success), 0)
+        c = v = None
+        gc.collect()
+        self.assertEqual(len(success), 1)
+        self.assertTrue(success[0])
+
+    def test_attribute(self):
+        v = BufferProxy(self.view_keywords)
+        self.assertRaises(AttributeError, getattr, v, "undefined")
+        v.undefined = 12
+        self.assertEqual(v.undefined, 12)
+        del v.undefined
+        self.assertRaises(AttributeError, getattr, v, "undefined")
+
+    def test_weakref(self):
+        v = BufferProxy(self.view_keywords)
+        weak_v = weakref.ref(v)
+
+        self.assertIs(weak_v(), v)
+
+        v = None
+        gc.collect()
+
+        self.assertIsNone(weak_v())
+
+    def test_gc(self):
+        """refcount agnostic check that contained objects are freed"""
+
+        def before_callback(parent):
+            return r[0]
+
+        def after_callback(parent):
+            return r[1]
+
+        class Obj:
+            pass
+
+        p = Obj()
+        a = Obj()
+        r = [Obj(), Obj()]
+        weak_p = weakref.ref(p)
+        weak_a = weakref.ref(a)
+        weak_r0 = weakref.ref(r[0])
+        weak_r1 = weakref.ref(r[1])
+        weak_before = weakref.ref(before_callback)
+        weak_after = weakref.ref(after_callback)
+        kwds = dict(self.view_keywords)
+        kwds["parent"] = p
+        kwds["before"] = before_callback
+        kwds["after"] = after_callback
+        v = BufferProxy(kwds)
+        v.some_attribute = a
+        weak_v = weakref.ref(v)
+        kwds = p = a = before_callback = after_callback = None
+        gc.collect()
+        self.assertTrue(weak_p() is not None)
+        self.assertTrue(weak_a() is not None)
+        self.assertTrue(weak_before() is not None)
+        self.assertTrue(weak_after() is not None)
+        v = None
+        [gc.collect() for x in range(4)]
+        self.assertTrue(weak_v() is None)
+        self.assertTrue(weak_p() is None)
+        self.assertTrue(weak_a() is None)
+        self.assertTrue(weak_before() is None)
+        self.assertTrue(weak_after() is None)
+        self.assertTrue(weak_r0() is not None)
+        self.assertTrue(weak_r1() is not None)
+        r = None
+        gc.collect()
+        self.assertTrue(weak_r0() is None)
+        self.assertTrue(weak_r1() is None)
+
+        # Cycle removal
+        kwds = dict(self.view_keywords)
+        kwds["parent"] = []
+        v = BufferProxy(kwds)
+        v.some_attribute = v
+        tracked = True
+        for o in gc.get_objects():
+            if o is v:
+                break
+        else:
+            tracked = False
+        self.assertTrue(tracked)
+        kwds["parent"].append(v)
+        kwds = None
+        gc.collect()
+        n1 = len(gc.garbage)
+        v = None
+        gc.collect()
+        n2 = len(gc.garbage)
+        self.assertEqual(n2, n1)
+
+    def test_c_api(self):
+        api = pygame.bufferproxy._PYGAME_C_API
+        api_type = type(pygame.base._PYGAME_C_API)
+
+        self.assertIsInstance(api, api_type)
+
+    def test_repr(self):
+        v = BufferProxy(self.view_keywords)
+        cname = BufferProxy.__name__
+        oname, ovalue = re.findall(r"<([^)]+)\(([^)]+)\)>", repr(v))[0]
+        self.assertEqual(oname, cname)
+        self.assertEqual(v.length, int(ovalue))
+
+    def test_subclassing(self):
+        class MyBufferProxy(BufferProxy):
+            def __repr__(self):
+                return f"*{BufferProxy.__repr__(self)}*"
+
+        kwds = dict(self.view_keywords)
+        kwds["parent"] = 0
+        v = MyBufferProxy(kwds)
+        self.assertEqual(v.parent, 0)
+        r = repr(v)
+        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
+
+        from pygame.tests.test_utils import buftools
+
+        Exporter = buftools.Exporter
+        Importer = buftools.Importer
+        exp = Exporter((10,), "B", readonly=True)
+        b = BufferProxy(exp)
+        self.assertEqual(b.length, exp.len)
+        self.assertEqual(b.raw, string_at(exp.buf, exp.len))
+        d = b.__array_interface__
+        try:
+            self.assertEqual(d["typestr"], "|u1")
+            self.assertEqual(d["shape"], exp.shape)
+            self.assertEqual(d["strides"], exp.strides)
+            self.assertEqual(d["data"], (exp.buf, True))
+        finally:
+            d = None
+        exp = Exporter((3,), "=h")
+        b = BufferProxy(exp)
+        self.assertEqual(b.length, exp.len)
+        self.assertEqual(b.raw, string_at(exp.buf, exp.len))
+        d = b.__array_interface__
+        try:
+            lil_endian = pygame.get_sdl_byteorder() == pygame.LIL_ENDIAN
+            f = f"{'<' if lil_endian else '>'}i{exp.itemsize}"
+            self.assertEqual(d["typestr"], f)
+            self.assertEqual(d["shape"], exp.shape)
+            self.assertEqual(d["strides"], exp.strides)
+            self.assertEqual(d["data"], (exp.buf, False))
+        finally:
+            d = None
+
+        exp = Exporter((10, 2), "=i")
+        b = BufferProxy(exp)
+        imp = Importer(b, buftools.PyBUF_RECORDS)
+        self.assertTrue(imp.obj is b)
+        self.assertEqual(imp.buf, exp.buf)
+        self.assertEqual(imp.ndim, exp.ndim)
+        self.assertEqual(imp.format, exp.format)
+        self.assertEqual(imp.readonly, exp.readonly)
+        self.assertEqual(imp.itemsize, exp.itemsize)
+        self.assertEqual(imp.len, exp.len)
+        self.assertEqual(imp.shape, exp.shape)
+        self.assertEqual(imp.strides, exp.strides)
+        self.assertTrue(imp.suboffsets is None)
+
+        d = {
+            "typestr": "|u1",
+            "shape": (10,),
+            "strides": (1,),
+            "data": (9, True),
+        }  # 9? Will not reading the data anyway.
+        b = BufferProxy(d)
+        imp = Importer(b, buftools.PyBUF_SIMPLE)
+        self.assertTrue(imp.obj is b)
+        self.assertEqual(imp.buf, 9)
+        self.assertEqual(imp.len, 10)
+        self.assertEqual(imp.format, None)
+        self.assertEqual(imp.itemsize, 1)
+        self.assertEqual(imp.ndim, 0)
+        self.assertTrue(imp.readonly)
+        self.assertTrue(imp.shape is None)
+        self.assertTrue(imp.strides is None)
+        self.assertTrue(imp.suboffsets is None)
+
+    try:
+        pygame.bufferproxy.get_segcount
+    except AttributeError:
+        pass
+    else:
+
+        def test_oldbuf_arg(self):
+            self.OLDBUF_test_oldbuf_arg()
+
+    def OLDBUF_test_oldbuf_arg(self):
+        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)
+        memaddr = ctypes.addressof(memory)
+
+        def raise_exception(o):
+            raise ValueError("An exception")
+
+        bf = BufferProxy(
+            {
+                "shape": (len(content),),
+                "typestr": "|u1",
+                "data": (memaddr, False),
+                "strides": (1,),
+            }
+        )
+        seglen, segaddr = get_read_buffer(bf, 0)
+        self.assertEqual(segaddr, 0)
+        self.assertEqual(seglen, 0)
+        seglen, segaddr = get_write_buffer(bf, 0)
+        self.assertEqual(segaddr, 0)
+        self.assertEqual(seglen, 0)
+        segcount, buflen = get_segcount(bf)
+        self.assertEqual(segcount, 1)
+        self.assertEqual(buflen, len(content))
+        seglen, segaddr = get_read_buffer(bf, 0)
+        self.assertEqual(segaddr, memaddr)
+        self.assertEqual(seglen, len(content))
+        seglen, segaddr = get_write_buffer(bf, 0)
+        self.assertEqual(segaddr, memaddr)
+        self.assertEqual(seglen, len(content))
+
+        bf = BufferProxy(
+            {
+                "shape": (len(content),),
+                "typestr": "|u1",
+                "data": (memaddr, True),
+                "strides": (1,),
+            }
+        )
+        segcount, buflen = get_segcount(bf)
+        self.assertEqual(segcount, 1)
+        self.assertEqual(buflen, len(content))
+        seglen, segaddr = get_read_buffer(bf, 0)
+        self.assertEqual(segaddr, memaddr)
+        self.assertEqual(seglen, len(content))
+        self.assertRaises(ValueError, get_write_buffer, bf, 0)
+
+        bf = BufferProxy(
+            {
+                "shape": (len(content),),
+                "typestr": "|u1",
+                "data": (memaddr, True),
+                "strides": (1,),
+                "before": raise_exception,
+            }
+        )
+        segcount, buflen = get_segcount(bf)
+        self.assertEqual(segcount, 0)
+        self.assertEqual(buflen, 0)
+
+        bf = BufferProxy(
+            {
+                "shape": (3, 4),
+                "typestr": "|u4",
+                "data": (memaddr, True),
+                "strides": (12, 4),
+            }
+        )
+        segcount, buflen = get_segcount(bf)
+        self.assertEqual(segcount, 3 * 4)
+        self.assertEqual(buflen, 3 * 4 * 4)
+        for i in range(0, 4):
+            seglen, segaddr = get_read_buffer(bf, i)
+            self.assertEqual(segaddr, memaddr + i * 4)
+            self.assertEqual(seglen, 4)
+
+
+class BufferProxyLegacyTest(unittest.TestCase):
+    content = b"\x01\x00\x00\x02" * 12
+    buffer = ctypes.create_string_buffer(content)
+    data = (ctypes.addressof(buffer), True)
+
+    def test_length(self):
+        # __doc__ (as of 2008-08-02) for pygame.bufferproxy.BufferProxy.length:
+
+        # The size of the buffer data in bytes.
+        bf = BufferProxy(
+            {"shape": (3, 4), "typestr": "|u4", "data": self.data, "strides": (12, 4)}
+        )
+        self.assertEqual(bf.length, len(self.content))
+        bf = BufferProxy(
+            {"shape": (3, 3), "typestr": "|u4", "data": self.data, "strides": (12, 4)}
+        )
+        self.assertEqual(bf.length, 3 * 3 * 4)
+
+    def test_raw(self):
+        # __doc__ (as of 2008-08-02) for pygame.bufferproxy.BufferProxy.raw:
+
+        # The raw buffer data as string. The string may contain NUL bytes.
+
+        bf = BufferProxy(
+            {"shape": (len(self.content),), "typestr": "|u1", "data": self.data}
+        )
+        self.assertEqual(bf.raw, self.content)
+        bf = BufferProxy(
+            {"shape": (3, 4), "typestr": "|u4", "data": self.data, "strides": (4, 12)}
+        )
+        self.assertEqual(bf.raw, self.content)
+        bf = BufferProxy(
+            {"shape": (3, 4), "typestr": "|u1", "data": self.data, "strides": (16, 4)}
+        )
+        self.assertRaises(ValueError, getattr, bf, "raw")
+
+    def test_write(self):
+        # __doc__ (as of 2008-08-02) for pygame.bufferproxy.BufferProxy.write:
+
+        # B.write (bufferproxy, buffer, offset) -> None
+        #
+        # Writes raw data to the bufferproxy.
+        #
+        # Writes the raw data from buffer to the BufferProxy object, starting
+        # 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 c_byte, sizeof, addressof, string_at, memset
+
+        nullbyte = b"\x00"
+        Buf = c_byte * 10
+        data_buf = Buf(*range(1, 3 * sizeof(Buf) + 1, 3))
+        data = string_at(data_buf, sizeof(data_buf))
+        buf = Buf()
+        bp = BufferProxy(
+            {"typestr": "|u1", "shape": (sizeof(buf),), "data": (addressof(buf), False)}
+        )
+        try:
+            self.assertEqual(bp.raw, nullbyte * sizeof(Buf))
+            bp.write(data)
+            self.assertEqual(bp.raw, data)
+            memset(buf, 0, sizeof(buf))
+            bp.write(data[:3], 2)
+            raw = bp.raw
+            self.assertEqual(raw[:2], nullbyte * 2)
+            self.assertEqual(raw[2:5], data[:3])
+            self.assertEqual(raw[5:], nullbyte * (sizeof(Buf) - 5))
+            bp.write(data[:3], bp.length - 3)
+            raw = bp.raw
+            self.assertEqual(raw[-3:], data[:3])
+            self.assertRaises(IndexError, bp.write, data, 1)
+            self.assertRaises(IndexError, bp.write, data[:5], -1)
+            self.assertRaises(IndexError, bp.write, data[:5], bp.length)
+            self.assertRaises(TypeError, bp.write, 12)
+            bp = BufferProxy(
+                {
+                    "typestr": "|u1",
+                    "shape": (sizeof(buf),),
+                    "data": (addressof(buf), True),
+                }
+            )
+            self.assertRaises(pygame.BufferError, bp.write, b"123")
+        finally:
+            # Make sure bp is garbage collected before buf
+            bp = None
+            gc.collect()
+
+
+if __name__ == "__main__":
+    unittest.main()
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/camera_test.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/camera_test.py
new file mode 100644
index 0000000..c15d4f0
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/camera_test.py
@@ -0,0 +1,35 @@
+import unittest
+import os
+import pygame
+import pygame.camera
+
+
+class CameraModuleTest(unittest.TestCase):
+    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/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/color_test.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/color_test.py
new file mode 100644
index 0000000..eee5c11
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/color_test.py
@@ -0,0 +1,1360 @@
+import math
+import operator
+import platform
+import unittest
+from collections.abc import Collection, Sequence
+
+import pygame
+from pygame.colordict import THECOLORS
+
+IS_PYPY = "PyPy" == platform.python_implementation()
+################################### CONSTANTS ##################################
+
+rgba_vals = [0, 1, 62, 63, 126, 127, 255]
+
+rgba_combinations = [
+    (r, g, b, a)
+    for r in rgba_vals
+    for g in rgba_vals
+    for b in rgba_vals
+    for a in rgba_vals
+]
+
+################################################################################
+
+
+def rgba_combos_Color_generator():
+    for rgba in rgba_combinations:
+        yield pygame.Color(*rgba)
+
+
+# Python gamma correct
+def gamma_correct(rgba_0_255, gamma):
+    corrected = round(255.0 * math.pow(rgba_0_255 / 255.0, gamma))
+    return max(min(int(corrected), 255), 0)
+
+
+################################################################################
+
+# TODO: add tests for
+# correct_gamma()  -- test against statically defined verified correct values
+# coerce ()        --  ??
+
+
+def _assignr(x, y):
+    x.r = y
+
+
+def _assigng(x, y):
+    x.g = y
+
+
+def _assignb(x, y):
+    x.b = y
+
+
+def _assigna(x, y):
+    x.a = y
+
+
+def _assign_item(x, p, y):
+    x[p] = y
+
+
+class ColorTypeTest(unittest.TestCase):
+    def test_new(self):
+        c = pygame.Color.__new__(pygame.Color)
+        self.assertEqual(c, pygame.Color(0, 0, 0, 255))
+        self.assertEqual(len(c), 4)
+
+    def test_init(self):
+        c = pygame.Color(10, 20, 30, 200)
+        self.assertEqual(c, (10, 20, 30, 200))
+        c.set_length(3)
+        self.assertEqual(len(c), 3)
+        c.__init__(100, 110, 120, 128)
+        self.assertEqual(len(c), 4)
+        self.assertEqual(c, (100, 110, 120, 128))
+
+    def test_invalid_html_hex_codes(self):
+        # This was a problem with the way 2 digit hex numbers were
+        # calculated. The test_hex_digits test is related to the fix.
+        Color = pygame.color.Color
+        self.assertRaises(ValueError, lambda: Color("# f000000"))
+        self.assertRaises(ValueError, lambda: Color("#f 000000"))
+        self.assertRaises(ValueError, lambda: Color("#-f000000"))
+
+    def test_hex_digits(self):
+        # This is an implementation specific test.
+        # Two digit hex numbers are calculated using table lookups
+        # for the upper and lower digits.
+        Color = pygame.color.Color
+        self.assertEqual(Color("#00000000").r, 0x00)
+        self.assertEqual(Color("#10000000").r, 0x10)
+        self.assertEqual(Color("#20000000").r, 0x20)
+        self.assertEqual(Color("#30000000").r, 0x30)
+        self.assertEqual(Color("#40000000").r, 0x40)
+        self.assertEqual(Color("#50000000").r, 0x50)
+        self.assertEqual(Color("#60000000").r, 0x60)
+        self.assertEqual(Color("#70000000").r, 0x70)
+        self.assertEqual(Color("#80000000").r, 0x80)
+        self.assertEqual(Color("#90000000").r, 0x90)
+        self.assertEqual(Color("#A0000000").r, 0xA0)
+        self.assertEqual(Color("#B0000000").r, 0xB0)
+        self.assertEqual(Color("#C0000000").r, 0xC0)
+        self.assertEqual(Color("#D0000000").r, 0xD0)
+        self.assertEqual(Color("#E0000000").r, 0xE0)
+        self.assertEqual(Color("#F0000000").r, 0xF0)
+        self.assertEqual(Color("#01000000").r, 0x01)
+        self.assertEqual(Color("#02000000").r, 0x02)
+        self.assertEqual(Color("#03000000").r, 0x03)
+        self.assertEqual(Color("#04000000").r, 0x04)
+        self.assertEqual(Color("#05000000").r, 0x05)
+        self.assertEqual(Color("#06000000").r, 0x06)
+        self.assertEqual(Color("#07000000").r, 0x07)
+        self.assertEqual(Color("#08000000").r, 0x08)
+        self.assertEqual(Color("#09000000").r, 0x09)
+        self.assertEqual(Color("#0A000000").r, 0x0A)
+        self.assertEqual(Color("#0B000000").r, 0x0B)
+        self.assertEqual(Color("#0C000000").r, 0x0C)
+        self.assertEqual(Color("#0D000000").r, 0x0D)
+        self.assertEqual(Color("#0E000000").r, 0x0E)
+        self.assertEqual(Color("#0F000000").r, 0x0F)
+
+    def test_comparison(self):
+        Color = pygame.color.Color
+
+        # Check valid comparisons
+        self.assertTrue(Color(255, 0, 0, 0) == Color(255, 0, 0, 0))
+        self.assertTrue(Color(0, 255, 0, 0) == Color(0, 255, 0, 0))
+        self.assertTrue(Color(0, 0, 255, 0) == Color(0, 0, 255, 0))
+        self.assertTrue(Color(0, 0, 0, 255) == Color(0, 0, 0, 255))
+        self.assertFalse(Color(0, 0, 0, 0) == Color(255, 0, 0, 0))
+        self.assertFalse(Color(0, 0, 0, 0) == Color(0, 255, 0, 0))
+        self.assertFalse(Color(0, 0, 0, 0) == Color(0, 0, 255, 0))
+        self.assertFalse(Color(0, 0, 0, 0) == Color(0, 0, 0, 255))
+        self.assertTrue(Color(0, 0, 0, 0) != Color(255, 0, 0, 0))
+        self.assertTrue(Color(0, 0, 0, 0) != Color(0, 255, 0, 0))
+        self.assertTrue(Color(0, 0, 0, 0) != Color(0, 0, 255, 0))
+        self.assertTrue(Color(0, 0, 0, 0) != Color(0, 0, 0, 255))
+        self.assertFalse(Color(255, 0, 0, 0) != Color(255, 0, 0, 0))
+        self.assertFalse(Color(0, 255, 0, 0) != Color(0, 255, 0, 0))
+        self.assertFalse(Color(0, 0, 255, 0) != Color(0, 0, 255, 0))
+        self.assertFalse(Color(0, 0, 0, 255) != Color(0, 0, 0, 255))
+
+        self.assertTrue(Color(255, 0, 0, 0) == (255, 0, 0, 0))
+        self.assertTrue(Color(0, 255, 0, 0) == (0, 255, 0, 0))
+        self.assertTrue(Color(0, 0, 255, 0) == (0, 0, 255, 0))
+        self.assertTrue(Color(0, 0, 0, 255) == (0, 0, 0, 255))
+        self.assertFalse(Color(0, 0, 0, 0) == (255, 0, 0, 0))
+        self.assertFalse(Color(0, 0, 0, 0) == (0, 255, 0, 0))
+        self.assertFalse(Color(0, 0, 0, 0) == (0, 0, 255, 0))
+        self.assertFalse(Color(0, 0, 0, 0) == (0, 0, 0, 255))
+        self.assertTrue(Color(0, 0, 0, 0) != (255, 0, 0, 0))
+        self.assertTrue(Color(0, 0, 0, 0) != (0, 255, 0, 0))
+        self.assertTrue(Color(0, 0, 0, 0) != (0, 0, 255, 0))
+        self.assertTrue(Color(0, 0, 0, 0) != (0, 0, 0, 255))
+        self.assertFalse(Color(255, 0, 0, 0) != (255, 0, 0, 0))
+        self.assertFalse(Color(0, 255, 0, 0) != (0, 255, 0, 0))
+        self.assertFalse(Color(0, 0, 255, 0) != (0, 0, 255, 0))
+        self.assertFalse(Color(0, 0, 0, 255) != (0, 0, 0, 255))
+
+        self.assertTrue((255, 0, 0, 0) == Color(255, 0, 0, 0))
+        self.assertTrue((0, 255, 0, 0) == Color(0, 255, 0, 0))
+        self.assertTrue((0, 0, 255, 0) == Color(0, 0, 255, 0))
+        self.assertTrue((0, 0, 0, 255) == Color(0, 0, 0, 255))
+        self.assertFalse((0, 0, 0, 0) == Color(255, 0, 0, 0))
+        self.assertFalse((0, 0, 0, 0) == Color(0, 255, 0, 0))
+        self.assertFalse((0, 0, 0, 0) == Color(0, 0, 255, 0))
+        self.assertFalse((0, 0, 0, 0) == Color(0, 0, 0, 255))
+        self.assertTrue((0, 0, 0, 0) != Color(255, 0, 0, 0))
+        self.assertTrue((0, 0, 0, 0) != Color(0, 255, 0, 0))
+        self.assertTrue((0, 0, 0, 0) != Color(0, 0, 255, 0))
+        self.assertTrue((0, 0, 0, 0) != Color(0, 0, 0, 255))
+        self.assertFalse((255, 0, 0, 0) != Color(255, 0, 0, 0))
+        self.assertFalse((0, 255, 0, 0) != Color(0, 255, 0, 0))
+        self.assertFalse((0, 0, 255, 0) != Color(0, 0, 255, 0))
+        self.assertFalse((0, 0, 0, 255) != Color(0, 0, 0, 255))
+
+        class TupleSubclass(tuple):
+            pass
+
+        self.assertTrue(Color(255, 0, 0, 0) == TupleSubclass((255, 0, 0, 0)))
+        self.assertTrue(TupleSubclass((255, 0, 0, 0)) == Color(255, 0, 0, 0))
+        self.assertFalse(Color(255, 0, 0, 0) != TupleSubclass((255, 0, 0, 0)))
+        self.assertFalse(TupleSubclass((255, 0, 0, 0)) != Color(255, 0, 0, 0))
+
+        # These are not supported so will be unequal.
+        self.assertFalse(Color(255, 0, 0, 0) == "#ff000000")
+        self.assertTrue(Color(255, 0, 0, 0) != "#ff000000")
+
+        self.assertFalse("#ff000000" == Color(255, 0, 0, 0))
+        self.assertTrue("#ff000000" != Color(255, 0, 0, 0))
+
+        self.assertFalse(Color(255, 0, 0, 0) == 0xFF000000)
+        self.assertTrue(Color(255, 0, 0, 0) != 0xFF000000)
+
+        self.assertFalse(0xFF000000 == Color(255, 0, 0, 0))
+        self.assertTrue(0xFF000000 != Color(255, 0, 0, 0))
+
+        self.assertFalse(Color(255, 0, 0, 0) == [255, 0, 0, 0])
+        self.assertTrue(Color(255, 0, 0, 0) != [255, 0, 0, 0])
+
+        self.assertFalse([255, 0, 0, 0] == Color(255, 0, 0, 0))
+        self.assertTrue([255, 0, 0, 0] != Color(255, 0, 0, 0))
+
+        # Comparison is not implemented for invalid color values.
+        class Test:
+            def __eq__(self, other):
+                return -1
+
+            def __ne__(self, other):
+                return -2
+
+        class TestTuple(tuple):
+            def __eq__(self, other):
+                return -1
+
+            def __ne__(self, other):
+                return -2
+
+        t = Test()
+        t_tuple = TestTuple(("a", 0, 0, 0))
+        black = Color("black")
+        self.assertEqual(black == t, -1)
+        self.assertEqual(t == black, -1)
+        self.assertEqual(black != t, -2)
+        self.assertEqual(t != black, -2)
+        self.assertEqual(black == t_tuple, -1)
+        self.assertEqual(black != t_tuple, -2)
+        self.assertEqual(t_tuple == black, -1)
+        self.assertEqual(t_tuple != black, -2)
+
+    def test_ignore_whitespace(self):
+        self.assertEqual(pygame.color.Color("red"), pygame.color.Color(" r e d "))
+
+    def test_slice(self):
+        # """|tags: python3_ignore|"""
+
+        # slicing a color gives you back a tuple.
+        # do all sorts of slice combinations.
+        c = pygame.Color(1, 2, 3, 4)
+
+        self.assertEqual((1, 2, 3, 4), c[:])
+        self.assertEqual((1, 2, 3), c[:-1])
+
+        self.assertEqual((), c[:-5])
+
+        self.assertEqual((1, 2, 3, 4), c[:4])
+        self.assertEqual((1, 2, 3, 4), c[:5])
+        self.assertEqual((1, 2), c[:2])
+        self.assertEqual((1,), c[:1])
+        self.assertEqual((), c[:0])
+
+        self.assertEqual((2,), c[1:-2])
+        self.assertEqual((3, 4), c[-2:])
+        self.assertEqual((4,), c[-1:])
+
+        # NOTE: assigning to a slice is currently unsupported.
+
+    def test_unpack(self):
+        # should be able to unpack to r,g,b,a and r,g,b
+        c = pygame.Color(1, 2, 3, 4)
+        r, g, b, a = c
+        self.assertEqual((1, 2, 3, 4), (r, g, b, a))
+        self.assertEqual(c, (r, g, b, a))
+
+        c.set_length(3)
+        r, g, b = c
+        self.assertEqual((1, 2, 3), (r, g, b))
+
+        # Checking if DeprecationWarning is triggered
+        # when function is called
+        for i in range(1, 5):
+            with self.assertWarns(DeprecationWarning):
+                c.set_length(i)
+
+    def test_length(self):
+        # should be able to unpack to r,g,b,a and r,g,b
+        c = pygame.Color(1, 2, 3, 4)
+        self.assertEqual(len(c), 4)
+
+        c.set_length(3)
+        self.assertEqual(len(c), 3)
+
+        # it keeps the old alpha anyway...
+        self.assertEqual(c.a, 4)
+
+        # however you can't get the alpha in this way:
+        self.assertRaises(IndexError, lambda x: c[x], 4)
+
+        c.set_length(4)
+        self.assertEqual(len(c), 4)
+        self.assertEqual(len(c), 4)
+
+        self.assertRaises(ValueError, c.set_length, 5)
+        self.assertRaises(ValueError, c.set_length, -1)
+        self.assertRaises(ValueError, c.set_length, 0)
+        self.assertRaises(ValueError, c.set_length, pow(2, 33))
+
+    def test_case_insensitivity_of_string_args(self):
+        self.assertEqual(pygame.color.Color("red"), pygame.color.Color("Red"))
+
+    def test_color(self):
+        """Ensures Color objects can be created."""
+        color = pygame.Color(0, 0, 0, 0)
+
+        self.assertIsInstance(color, pygame.Color)
+
+    def test_color__rgba_int_args(self):
+        """Ensures Color objects can be created using ints."""
+        color = pygame.Color(10, 20, 30, 40)
+
+        self.assertEqual(color.r, 10)
+        self.assertEqual(color.g, 20)
+        self.assertEqual(color.b, 30)
+        self.assertEqual(color.a, 40)
+
+    def test_color__rgba_int_args_without_alpha(self):
+        """Ensures Color objects can be created without providing alpha."""
+        color = pygame.Color(10, 20, 30)
+
+        self.assertEqual(color.r, 10)
+        self.assertEqual(color.g, 20)
+        self.assertEqual(color.b, 30)
+        self.assertEqual(color.a, 255)
+
+    def test_color__rgba_int_args_invalid_value(self):
+        """Ensures invalid values are detected when creating Color objects."""
+        self.assertRaises(ValueError, pygame.Color, 257, 10, 105, 44)
+        self.assertRaises(ValueError, pygame.Color, 10, 257, 105, 44)
+        self.assertRaises(ValueError, pygame.Color, 10, 105, 257, 44)
+        self.assertRaises(ValueError, pygame.Color, 10, 105, 44, 257)
+
+    def test_color__rgba_int_args_invalid_value_without_alpha(self):
+        """Ensures invalid values are detected when creating Color objects
+        without providing an alpha.
+        """
+        self.assertRaises(ValueError, pygame.Color, 256, 10, 105)
+        self.assertRaises(ValueError, pygame.Color, 10, 256, 105)
+        self.assertRaises(ValueError, pygame.Color, 10, 105, 256)
+
+    def test_color__color_object_arg(self):
+        """Ensures Color objects can be created using Color objects."""
+        color_args = (10, 20, 30, 40)
+        color_obj = pygame.Color(*color_args)
+
+        new_color_obj = pygame.Color(color_obj)
+
+        self.assertIsInstance(new_color_obj, pygame.Color)
+        self.assertEqual(new_color_obj, color_obj)
+        self.assertEqual(new_color_obj.r, color_args[0])
+        self.assertEqual(new_color_obj.g, color_args[1])
+        self.assertEqual(new_color_obj.b, color_args[2])
+        self.assertEqual(new_color_obj.a, color_args[3])
+
+    def test_color__name_str_arg(self):
+        """Ensures Color objects can be created using str names."""
+        for name in ("aquamarine3", "AQUAMARINE3", "AqUAmArIne3"):
+            color = pygame.Color(name)
+
+            self.assertEqual(color.r, 102)
+            self.assertEqual(color.g, 205)
+            self.assertEqual(color.b, 170)
+            self.assertEqual(color.a, 255)
+
+    def test_color__name_str_arg_from_colordict(self):
+        """Ensures Color objects can be created using str names
+        from the THECOLORS dict."""
+        for name, values in THECOLORS.items():
+            color = pygame.Color(name)
+
+            self.assertEqual(color.r, values[0])
+            self.assertEqual(color.g, values[1])
+            self.assertEqual(color.b, values[2])
+            self.assertEqual(color.a, values[3])
+
+    def test_color__html_str_arg(self):
+        """Ensures Color objects can be created using html strings."""
+        # See test_webstyle() for related tests.
+        color = pygame.Color("#a1B2c3D4")
+
+        self.assertEqual(color.r, 0xA1)
+        self.assertEqual(color.g, 0xB2)
+        self.assertEqual(color.b, 0xC3)
+        self.assertEqual(color.a, 0xD4)
+
+    def test_color__hex_str_arg(self):
+        """Ensures Color objects can be created using hex strings."""
+        # See test_webstyle() for related tests.
+        color = pygame.Color("0x1a2B3c4D")
+
+        self.assertEqual(color.r, 0x1A)
+        self.assertEqual(color.g, 0x2B)
+        self.assertEqual(color.b, 0x3C)
+        self.assertEqual(color.a, 0x4D)
+
+    def test_color__int_arg(self):
+        """Ensures Color objects can be created using one int value."""
+        for value in (0x0, 0xFFFFFFFF, 0xAABBCCDD):
+            color = pygame.Color(value)
+
+            self.assertEqual(color.r, (value >> 24) & 0xFF)
+            self.assertEqual(color.g, (value >> 16) & 0xFF)
+            self.assertEqual(color.b, (value >> 8) & 0xFF)
+            self.assertEqual(color.a, value & 0xFF)
+
+    def test_color__int_arg_invalid(self):
+        """Ensures invalid int values are detected when creating Color objects."""
+        with self.assertRaises(ValueError):
+            color = pygame.Color(0x1FFFFFFFF)
+
+    def test_color__sequence_arg(self):
+        """Ensures Color objects can be created using tuples/lists."""
+        color_values = (33, 44, 55, 66)
+        for seq_type in (tuple, list):
+            color = pygame.Color(seq_type(color_values))
+
+            self.assertEqual(color.r, color_values[0])
+            self.assertEqual(color.g, color_values[1])
+            self.assertEqual(color.b, color_values[2])
+            self.assertEqual(color.a, color_values[3])
+
+    def test_color__sequence_arg_without_alpha(self):
+        """Ensures Color objects can be created using tuples/lists
+        without providing an alpha value.
+        """
+        color_values = (33, 44, 55)
+        for seq_type in (tuple, list):
+            color = pygame.Color(seq_type(color_values))
+
+            self.assertEqual(color.r, color_values[0])
+            self.assertEqual(color.g, color_values[1])
+            self.assertEqual(color.b, color_values[2])
+            self.assertEqual(color.a, 255)
+
+    def test_color__sequence_arg_invalid_value(self):
+        """Ensures invalid sequences are detected when creating Color objects."""
+        cls = pygame.Color
+        for seq_type in (tuple, list):
+            self.assertRaises(ValueError, cls, seq_type((256, 90, 80, 70)))
+            self.assertRaises(ValueError, cls, seq_type((100, 256, 80, 70)))
+            self.assertRaises(ValueError, cls, seq_type((100, 90, 256, 70)))
+            self.assertRaises(ValueError, cls, seq_type((100, 90, 80, 256)))
+
+    def test_color__sequence_arg_invalid_value_without_alpha(self):
+        """Ensures invalid sequences are detected when creating Color objects
+        without providing an alpha.
+        """
+        cls = pygame.Color
+        for seq_type in (tuple, list):
+            self.assertRaises(ValueError, cls, seq_type((256, 90, 80)))
+            self.assertRaises(ValueError, cls, seq_type((100, 256, 80)))
+            self.assertRaises(ValueError, cls, seq_type((100, 90, 256)))
+
+    def test_color__sequence_arg_invalid_format(self):
+        """Ensures invalid sequences are detected when creating Color objects
+        with the wrong number of values.
+        """
+        cls = pygame.Color
+        for seq_type in (tuple, list):
+            self.assertRaises(ValueError, cls, seq_type((100,)))
+            self.assertRaises(ValueError, cls, seq_type((100, 90)))
+            self.assertRaises(ValueError, cls, seq_type((100, 90, 80, 70, 60)))
+
+    def test_rgba(self):
+        c = pygame.Color(0)
+        self.assertEqual(c.r, 0)
+        self.assertEqual(c.g, 0)
+        self.assertEqual(c.b, 0)
+        self.assertEqual(c.a, 0)
+
+        # Test simple assignments
+        c.r = 123
+        self.assertEqual(c.r, 123)
+        self.assertRaises(ValueError, _assignr, c, 537)
+        self.assertEqual(c.r, 123)
+        self.assertRaises(ValueError, _assignr, c, -3)
+        self.assertEqual(c.r, 123)
+
+        c.g = 55
+        self.assertEqual(c.g, 55)
+        self.assertRaises(ValueError, _assigng, c, 348)
+        self.assertEqual(c.g, 55)
+        self.assertRaises(ValueError, _assigng, c, -44)
+        self.assertEqual(c.g, 55)
+
+        c.b = 77
+        self.assertEqual(c.b, 77)
+        self.assertRaises(ValueError, _assignb, c, 256)
+        self.assertEqual(c.b, 77)
+        self.assertRaises(ValueError, _assignb, c, -12)
+        self.assertEqual(c.b, 77)
+
+        c.a = 255
+        self.assertEqual(c.a, 255)
+        self.assertRaises(ValueError, _assigna, c, 312)
+        self.assertEqual(c.a, 255)
+        self.assertRaises(ValueError, _assigna, c, -10)
+        self.assertEqual(c.a, 255)
+
+    def test_repr(self):
+        c = pygame.Color(68, 38, 26, 69)
+        t = "(68, 38, 26, 69)"
+        self.assertEqual(repr(c), t)
+
+    def test_add(self):
+        c1 = pygame.Color(0)
+        self.assertEqual(c1.r, 0)
+        self.assertEqual(c1.g, 0)
+        self.assertEqual(c1.b, 0)
+        self.assertEqual(c1.a, 0)
+
+        c2 = pygame.Color(20, 33, 82, 193)
+        self.assertEqual(c2.r, 20)
+        self.assertEqual(c2.g, 33)
+        self.assertEqual(c2.b, 82)
+        self.assertEqual(c2.a, 193)
+
+        c3 = c1 + c2
+        self.assertEqual(c3.r, 20)
+        self.assertEqual(c3.g, 33)
+        self.assertEqual(c3.b, 82)
+        self.assertEqual(c3.a, 193)
+
+        c3 = c3 + c2
+        self.assertEqual(c3.r, 40)
+        self.assertEqual(c3.g, 66)
+        self.assertEqual(c3.b, 164)
+        self.assertEqual(c3.a, 255)
+
+        # Issue #286: Is type checking done for Python 3.x?
+        self.assertRaises(TypeError, operator.add, c1, None)
+        self.assertRaises(TypeError, operator.add, None, c1)
+
+    def test_sub(self):
+        c1 = pygame.Color(0xFFFFFFFF)
+        self.assertEqual(c1.r, 255)
+        self.assertEqual(c1.g, 255)
+        self.assertEqual(c1.b, 255)
+        self.assertEqual(c1.a, 255)
+
+        c2 = pygame.Color(20, 33, 82, 193)
+        self.assertEqual(c2.r, 20)
+        self.assertEqual(c2.g, 33)
+        self.assertEqual(c2.b, 82)
+        self.assertEqual(c2.a, 193)
+
+        c3 = c1 - c2
+        self.assertEqual(c3.r, 235)
+        self.assertEqual(c3.g, 222)
+        self.assertEqual(c3.b, 173)
+        self.assertEqual(c3.a, 62)
+
+        c3 = c3 - c2
+        self.assertEqual(c3.r, 215)
+        self.assertEqual(c3.g, 189)
+        self.assertEqual(c3.b, 91)
+        self.assertEqual(c3.a, 0)
+
+        # Issue #286: Is type checking done for Python 3.x?
+        self.assertRaises(TypeError, operator.sub, c1, None)
+        self.assertRaises(TypeError, operator.sub, None, c1)
+
+    def test_mul(self):
+        c1 = pygame.Color(0x01010101)
+        self.assertEqual(c1.r, 1)
+        self.assertEqual(c1.g, 1)
+        self.assertEqual(c1.b, 1)
+        self.assertEqual(c1.a, 1)
+
+        c2 = pygame.Color(2, 5, 3, 22)
+        self.assertEqual(c2.r, 2)
+        self.assertEqual(c2.g, 5)
+        self.assertEqual(c2.b, 3)
+        self.assertEqual(c2.a, 22)
+
+        c3 = c1 * c2
+        self.assertEqual(c3.r, 2)
+        self.assertEqual(c3.g, 5)
+        self.assertEqual(c3.b, 3)
+        self.assertEqual(c3.a, 22)
+
+        c3 = c3 * c2
+        self.assertEqual(c3.r, 4)
+        self.assertEqual(c3.g, 25)
+        self.assertEqual(c3.b, 9)
+        self.assertEqual(c3.a, 255)
+
+        # Issue #286: Is type checking done for Python 3.x?
+        self.assertRaises(TypeError, operator.mul, c1, None)
+        self.assertRaises(TypeError, operator.mul, None, c1)
+
+    def test_div(self):
+        c1 = pygame.Color(0x80808080)
+        self.assertEqual(c1.r, 128)
+        self.assertEqual(c1.g, 128)
+        self.assertEqual(c1.b, 128)
+        self.assertEqual(c1.a, 128)
+
+        c2 = pygame.Color(2, 4, 8, 16)
+        self.assertEqual(c2.r, 2)
+        self.assertEqual(c2.g, 4)
+        self.assertEqual(c2.b, 8)
+        self.assertEqual(c2.a, 16)
+
+        c3 = c1 // c2
+        self.assertEqual(c3.r, 64)
+        self.assertEqual(c3.g, 32)
+        self.assertEqual(c3.b, 16)
+        self.assertEqual(c3.a, 8)
+
+        c3 = c3 // c2
+        self.assertEqual(c3.r, 32)
+        self.assertEqual(c3.g, 8)
+        self.assertEqual(c3.b, 2)
+        self.assertEqual(c3.a, 0)
+
+        # Issue #286: Is type checking done for Python 3.x?
+        self.assertRaises(TypeError, operator.floordiv, c1, None)
+        self.assertRaises(TypeError, operator.floordiv, None, c1)
+
+        # Division by zero check
+        dividend = pygame.Color(255, 255, 255, 255)
+        for i in range(4):
+            divisor = pygame.Color(64, 64, 64, 64)
+            divisor[i] = 0
+            quotient = pygame.Color(3, 3, 3, 3)
+            quotient[i] = 0
+            self.assertEqual(dividend // divisor, quotient)
+
+    def test_mod(self):
+        c1 = pygame.Color(0xFFFFFFFF)
+        self.assertEqual(c1.r, 255)
+        self.assertEqual(c1.g, 255)
+        self.assertEqual(c1.b, 255)
+        self.assertEqual(c1.a, 255)
+
+        c2 = pygame.Color(2, 4, 8, 16)
+        self.assertEqual(c2.r, 2)
+        self.assertEqual(c2.g, 4)
+        self.assertEqual(c2.b, 8)
+        self.assertEqual(c2.a, 16)
+
+        c3 = c1 % c2
+        self.assertEqual(c3.r, 1)
+        self.assertEqual(c3.g, 3)
+        self.assertEqual(c3.b, 7)
+        self.assertEqual(c3.a, 15)
+
+        # Issue #286: Is type checking done for Python 3.x?
+        self.assertRaises(TypeError, operator.mod, c1, None)
+        self.assertRaises(TypeError, operator.mod, None, c1)
+
+        # Division by zero check
+        dividend = pygame.Color(255, 255, 255, 255)
+        for i in range(4):
+            divisor = pygame.Color(64, 64, 64, 64)
+            divisor[i] = 0
+            quotient = pygame.Color(63, 63, 63, 63)
+            quotient[i] = 0
+            self.assertEqual(dividend % divisor, quotient)
+
+    def test_float(self):
+        c = pygame.Color(0xCC00CC00)
+        self.assertEqual(c.r, 204)
+        self.assertEqual(c.g, 0)
+        self.assertEqual(c.b, 204)
+        self.assertEqual(c.a, 0)
+        self.assertEqual(float(c), float(0xCC00CC00))
+
+        c = pygame.Color(0x33727592)
+        self.assertEqual(c.r, 51)
+        self.assertEqual(c.g, 114)
+        self.assertEqual(c.b, 117)
+        self.assertEqual(c.a, 146)
+        self.assertEqual(float(c), float(0x33727592))
+
+    def test_oct(self):
+        c = pygame.Color(0xCC00CC00)
+        self.assertEqual(c.r, 204)
+        self.assertEqual(c.g, 0)
+        self.assertEqual(c.b, 204)
+        self.assertEqual(c.a, 0)
+        self.assertEqual(oct(c), oct(0xCC00CC00))
+
+        c = pygame.Color(0x33727592)
+        self.assertEqual(c.r, 51)
+        self.assertEqual(c.g, 114)
+        self.assertEqual(c.b, 117)
+        self.assertEqual(c.a, 146)
+        self.assertEqual(oct(c), oct(0x33727592))
+
+    def test_hex(self):
+        c = pygame.Color(0xCC00CC00)
+        self.assertEqual(c.r, 204)
+        self.assertEqual(c.g, 0)
+        self.assertEqual(c.b, 204)
+        self.assertEqual(c.a, 0)
+        self.assertEqual(hex(c), hex(0xCC00CC00))
+
+        c = pygame.Color(0x33727592)
+        self.assertEqual(c.r, 51)
+        self.assertEqual(c.g, 114)
+        self.assertEqual(c.b, 117)
+        self.assertEqual(c.a, 146)
+        self.assertEqual(hex(c), hex(0x33727592))
+
+    def test_webstyle(self):
+        c = pygame.Color("#CC00CC11")
+        self.assertEqual(c.r, 204)
+        self.assertEqual(c.g, 0)
+        self.assertEqual(c.b, 204)
+        self.assertEqual(c.a, 17)
+        self.assertEqual(hex(c), hex(0xCC00CC11))
+
+        c = pygame.Color("#CC00CC")
+        self.assertEqual(c.r, 204)
+        self.assertEqual(c.g, 0)
+        self.assertEqual(c.b, 204)
+        self.assertEqual(c.a, 255)
+        self.assertEqual(hex(c), hex(0xCC00CCFF))
+
+        c = pygame.Color("0xCC00CC11")
+        self.assertEqual(c.r, 204)
+        self.assertEqual(c.g, 0)
+        self.assertEqual(c.b, 204)
+        self.assertEqual(c.a, 17)
+        self.assertEqual(hex(c), hex(0xCC00CC11))
+
+        c = pygame.Color("0xCC00CC")
+        self.assertEqual(c.r, 204)
+        self.assertEqual(c.g, 0)
+        self.assertEqual(c.b, 204)
+        self.assertEqual(c.a, 255)
+        self.assertEqual(hex(c), hex(0xCC00CCFF))
+
+        self.assertRaises(ValueError, pygame.Color, "#cc00qq")
+        self.assertRaises(ValueError, pygame.Color, "0xcc00qq")
+        self.assertRaises(ValueError, pygame.Color, "09abcdef")
+        self.assertRaises(ValueError, pygame.Color, "09abcde")
+        self.assertRaises(ValueError, pygame.Color, "quarky")
+
+    def test_int(self):
+        # This will be a long
+        c = pygame.Color(0xCC00CC00)
+        self.assertEqual(c.r, 204)
+        self.assertEqual(c.g, 0)
+        self.assertEqual(c.b, 204)
+        self.assertEqual(c.a, 0)
+        self.assertEqual(int(c), int(0xCC00CC00))
+
+        # This will be an int
+        c = pygame.Color(0x33727592)
+        self.assertEqual(c.r, 51)
+        self.assertEqual(c.g, 114)
+        self.assertEqual(c.b, 117)
+        self.assertEqual(c.a, 146)
+        self.assertEqual(int(c), int(0x33727592))
+
+    def test_long(self):
+        # This will be a long
+        c = pygame.Color(0xCC00CC00)
+        self.assertEqual(c.r, 204)
+        self.assertEqual(c.g, 0)
+        self.assertEqual(c.b, 204)
+        self.assertEqual(c.a, 0)
+        self.assertEqual(int(c), int(0xCC00CC00))
+
+        # This will be an int
+        c = pygame.Color(0x33727592)
+        self.assertEqual(c.r, 51)
+        self.assertEqual(c.g, 114)
+        self.assertEqual(c.b, 117)
+        self.assertEqual(c.a, 146)
+        self.assertEqual(int(c), int(0x33727592))
+
+    def test_normalize(self):
+        c = pygame.Color(204, 38, 194, 55)
+        self.assertEqual(c.r, 204)
+        self.assertEqual(c.g, 38)
+        self.assertEqual(c.b, 194)
+        self.assertEqual(c.a, 55)
+
+        t = c.normalize()
+
+        self.assertAlmostEqual(t[0], 0.800000, 5)
+        self.assertAlmostEqual(t[1], 0.149016, 5)
+        self.assertAlmostEqual(t[2], 0.760784, 5)
+        self.assertAlmostEqual(t[3], 0.215686, 5)
+
+    def test_len(self):
+        c = pygame.Color(204, 38, 194, 55)
+        self.assertEqual(len(c), 4)
+
+    def test_get_item(self):
+        c = pygame.Color(204, 38, 194, 55)
+        self.assertEqual(c[0], 204)
+        self.assertEqual(c[1], 38)
+        self.assertEqual(c[2], 194)
+        self.assertEqual(c[3], 55)
+
+    def test_set_item(self):
+        c = pygame.Color(204, 38, 194, 55)
+        self.assertEqual(c[0], 204)
+        self.assertEqual(c[1], 38)
+        self.assertEqual(c[2], 194)
+        self.assertEqual(c[3], 55)
+
+        c[0] = 33
+        self.assertEqual(c[0], 33)
+        c[1] = 48
+        self.assertEqual(c[1], 48)
+        c[2] = 173
+        self.assertEqual(c[2], 173)
+        c[3] = 213
+        self.assertEqual(c[3], 213)
+
+        # Now try some 'invalid' ones
+        self.assertRaises(TypeError, _assign_item, c, 0, 95.485)
+        self.assertEqual(c[0], 33)
+        self.assertRaises(ValueError, _assign_item, c, 1, -83)
+        self.assertEqual(c[1], 48)
+        self.assertRaises(TypeError, _assign_item, c, 2, "Hello")
+        self.assertEqual(c[2], 173)
+
+    def test_Color_type_works_for_Surface_get_and_set_colorkey(self):
+        s = pygame.Surface((32, 32))
+
+        c = pygame.Color(33, 22, 11, 255)
+        s.set_colorkey(c)
+
+        get_r, get_g, get_b, get_a = s.get_colorkey()
+
+        self.assertTrue(get_r == c.r)
+        self.assertTrue(get_g == c.g)
+        self.assertTrue(get_b == c.b)
+        self.assertTrue(get_a == c.a)
+
+    ########## HSLA, HSVA, CMY, I1I2I3 ALL ELEMENTS WITHIN SPECIFIED RANGE #########
+
+    def test_hsla__all_elements_within_limits(self):
+        for c in rgba_combos_Color_generator():
+            h, s, l, a = c.hsla
+            self.assertTrue(0 <= h <= 360)
+            self.assertTrue(0 <= s <= 100)
+            self.assertTrue(0 <= l <= 100)
+            self.assertTrue(0 <= a <= 100)
+
+    def test_hsva__all_elements_within_limits(self):
+        for c in rgba_combos_Color_generator():
+            h, s, v, a = c.hsva
+            self.assertTrue(0 <= h <= 360)
+            self.assertTrue(0 <= s <= 100)
+            self.assertTrue(0 <= v <= 100)
+            self.assertTrue(0 <= a <= 100)
+
+    def test_cmy__all_elements_within_limits(self):
+        for c in rgba_combos_Color_generator():
+            c, m, y = c.cmy
+            self.assertTrue(0 <= c <= 1)
+            self.assertTrue(0 <= m <= 1)
+            self.assertTrue(0 <= y <= 1)
+
+    def test_i1i2i3__all_elements_within_limits(self):
+        for c in rgba_combos_Color_generator():
+            i1, i2, i3 = c.i1i2i3
+            self.assertTrue(0 <= i1 <= 1)
+            self.assertTrue(-0.5 <= i2 <= 0.5)
+            self.assertTrue(-0.5 <= i3 <= 0.5)
+
+    def test_issue_269(self):
+        """PyColor OverflowError on HSVA with hue value of 360
+
+        >>> c = pygame.Color(0)
+        >>> c.hsva = (360,0,0,0)
+        Traceback (most recent call last):
+          File "", line 1, in 
+        OverflowError: this is not allowed to happen ever
+        >>> pygame.ver
+        '1.9.1release'
+        >>>
+
+        """
+
+        c = pygame.Color(0)
+        c.hsva = 360, 0, 0, 0
+        self.assertEqual(c.hsva, (0, 0, 0, 0))
+        c.hsva = 360, 100, 100, 100
+        self.assertEqual(c.hsva, (0, 100, 100, 100))
+        self.assertEqual(c, (255, 0, 0, 255))
+
+    ####################### COLORSPACE PROPERTY SANITY TESTS #######################
+
+    def colorspaces_converted_should_not_raise(self, prop):
+        fails = 0
+
+        x = 0
+        for c in rgba_combos_Color_generator():
+            x += 1
+
+            other = pygame.Color(0)
+
+            try:
+                setattr(other, prop, getattr(c, prop))
+                # eg other.hsla = c.hsla
+
+            except ValueError:
+                fails += 1
+
+        self.assertTrue(x > 0, "x is combination counter, 0 means no tests!")
+        self.assertTrue((fails, x) == (0, x))
+
+    def test_hsla__sanity_testing_converted_should_not_raise(self):
+        self.colorspaces_converted_should_not_raise("hsla")
+
+    def test_hsva__sanity_testing_converted_should_not_raise(self):
+        self.colorspaces_converted_should_not_raise("hsva")
+
+    def test_cmy__sanity_testing_converted_should_not_raise(self):
+        self.colorspaces_converted_should_not_raise("cmy")
+
+    def test_i1i2i3__sanity_testing_converted_should_not_raise(self):
+        self.colorspaces_converted_should_not_raise("i1i2i3")
+
+    ################################################################################
+
+    def colorspaces_converted_should_equate_bar_rounding(self, prop):
+        for c in rgba_combos_Color_generator():
+            other = pygame.Color(0)
+
+            try:
+                setattr(other, prop, getattr(c, prop))
+                # eg other.hsla = c.hsla
+
+                self.assertTrue(abs(other.r - c.r) <= 1)
+                self.assertTrue(abs(other.b - c.b) <= 1)
+                self.assertTrue(abs(other.g - c.g) <= 1)
+                # CMY and I1I2I3 do not care about the alpha
+                if prop not in ("cmy", "i1i2i3"):
+                    self.assertTrue(abs(other.a - c.a) <= 1)
+
+            except ValueError:
+                pass  # other tests will notify, this tests equation
+
+    def test_hsla__sanity_testing_converted_should_equate_bar_rounding(self):
+        self.colorspaces_converted_should_equate_bar_rounding("hsla")
+
+    def test_hsva__sanity_testing_converted_should_equate_bar_rounding(self):
+        self.colorspaces_converted_should_equate_bar_rounding("hsva")
+
+    def test_cmy__sanity_testing_converted_should_equate_bar_rounding(self):
+        self.colorspaces_converted_should_equate_bar_rounding("cmy")
+
+    def test_i1i2i3__sanity_testing_converted_should_equate_bar_rounding(self):
+        self.colorspaces_converted_should_equate_bar_rounding("i1i2i3")
+
+    ################################################################################
+
+    def test_correct_gamma__verified_against_python_implementation(self):
+        "|tags:slow|"
+        # gamma_correct defined at top of page
+
+        gammas = [i / 10.0 for i in range(1, 31)]  # [0.1 ... 3.0]
+        gammas_len = len(gammas)
+
+        for i, c in enumerate(rgba_combos_Color_generator()):
+            gamma = gammas[i % gammas_len]
+
+            corrected = pygame.Color(*[gamma_correct(x, gamma) for x in tuple(c)])
+            lib_corrected = c.correct_gamma(gamma)
+
+            self.assertTrue(corrected.r == lib_corrected.r)
+            self.assertTrue(corrected.g == lib_corrected.g)
+            self.assertTrue(corrected.b == lib_corrected.b)
+            self.assertTrue(corrected.a == lib_corrected.a)
+
+        # TODO: test against statically defined verified _correct_ values
+        # assert corrected.r == 125 etc.
+
+    def test_pickle(self):
+        import pickle
+
+        c1 = pygame.Color(1, 2, 3, 4)
+        # c2 = pygame.Color(255,254,253,252)
+        pickle_string = pickle.dumps(c1)
+        c1_frompickle = pickle.loads(pickle_string)
+        self.assertEqual(c1, c1_frompickle)
+
+    ################################################################################
+    # only available if ctypes module is also available
+
+    @unittest.skipIf(IS_PYPY, "PyPy has no ctypes")
+    def test_arraystruct(self):
+        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)
+        flags = ai.PAI_CONTIGUOUS | ai.PAI_FORTRAN | ai.PAI_ALIGNED | ai.PAI_NOTSWAPPED
+        for i in range(1, 5):
+            c.set_length(i)
+            inter = ai.ArrayInterface(c)
+            self.assertEqual(inter.two, 2)
+            self.assertEqual(inter.nd, 1)
+            self.assertEqual(inter.typekind, "u")
+            self.assertEqual(inter.itemsize, 1)
+            self.assertEqual(inter.flags, flags)
+            self.assertEqual(inter.shape[0], i)
+            self.assertEqual(inter.strides[0], 1)
+            data = ct.cast(inter.data, c_byte_p)
+            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 pygame.tests.test_utils import buftools
+        from ctypes import cast, POINTER, c_uint8
+
+        class ColorImporter(buftools.Importer):
+            def __init__(self, color, flags):
+                super().__init__(color, flags)
+                self.items = cast(self.buf, POINTER(c_uint8))
+
+            def __getitem__(self, index):
+                if 0 <= index < 4:
+                    return self.items[index]
+                raise IndexError(f"valid index values are between 0 and 3: got {index}")
+
+            def __setitem__(self, index, value):
+                if 0 <= index < 4:
+                    self.items[index] = value
+                else:
+                    raise IndexError(
+                        f"valid index values are between 0 and 3: got {index}"
+                    )
+
+        c = pygame.Color(50, 100, 150, 200)
+        imp = ColorImporter(c, buftools.PyBUF_SIMPLE)
+        self.assertTrue(imp.obj is c)
+        self.assertEqual(imp.ndim, 0)
+        self.assertEqual(imp.itemsize, 1)
+        self.assertEqual(imp.len, 4)
+        self.assertTrue(imp.readonly)
+        self.assertTrue(imp.format is None)
+        self.assertTrue(imp.shape is None)
+        self.assertTrue(imp.strides is None)
+        self.assertTrue(imp.suboffsets is None)
+        for i in range(4):
+            self.assertEqual(c[i], imp[i])
+        imp[0] = 60
+        self.assertEqual(c.r, 60)
+        imp[1] = 110
+        self.assertEqual(c.g, 110)
+        imp[2] = 160
+        self.assertEqual(c.b, 160)
+        imp[3] = 210
+        self.assertEqual(c.a, 210)
+        imp = ColorImporter(c, buftools.PyBUF_FORMAT)
+        self.assertEqual(imp.ndim, 0)
+        self.assertEqual(imp.itemsize, 1)
+        self.assertEqual(imp.len, 4)
+        self.assertEqual(imp.format, "B")
+        self.assertEqual(imp.ndim, 0)
+        self.assertEqual(imp.itemsize, 1)
+        self.assertEqual(imp.len, 4)
+        imp = ColorImporter(c, buftools.PyBUF_ND)
+        self.assertEqual(imp.ndim, 1)
+        self.assertEqual(imp.itemsize, 1)
+        self.assertEqual(imp.len, 4)
+        self.assertTrue(imp.format is None)
+        self.assertEqual(imp.shape, (4,))
+        self.assertEqual(imp.strides, None)
+        imp = ColorImporter(c, buftools.PyBUF_STRIDES)
+        self.assertEqual(imp.ndim, 1)
+        self.assertTrue(imp.format is None)
+        self.assertEqual(imp.shape, (4,))
+        self.assertEqual(imp.strides, (1,))
+        imp = ColorImporter(c, buftools.PyBUF_C_CONTIGUOUS)
+        self.assertEqual(imp.ndim, 1)
+        imp = ColorImporter(c, buftools.PyBUF_F_CONTIGUOUS)
+        self.assertEqual(imp.ndim, 1)
+        imp = ColorImporter(c, buftools.PyBUF_ANY_CONTIGUOUS)
+        self.assertEqual(imp.ndim, 1)
+        for i in range(1, 5):
+            c.set_length(i)
+            imp = ColorImporter(c, buftools.PyBUF_ND)
+            self.assertEqual(imp.ndim, 1)
+            self.assertEqual(imp.len, i)
+            self.assertEqual(imp.shape, (i,))
+        self.assertRaises(BufferError, ColorImporter, c, buftools.PyBUF_WRITABLE)
+
+    def test_color_iter(self):
+        c = pygame.Color(50, 100, 150, 200)
+
+        # call __iter__ explicitly to test that it is defined
+        color_iterator = c.__iter__()
+        for i, val in enumerate(color_iterator):
+            self.assertEqual(c[i], val)
+
+    def test_color_contains(self):
+        c = pygame.Color(50, 60, 70)
+
+        # call __contains__ explicitly to test that it is defined
+        self.assertTrue(c.__contains__(50))
+        self.assertTrue(60 in c)
+        self.assertTrue(70 in c)
+        self.assertFalse(100 in c)
+        self.assertFalse(c.__contains__(10))
+
+        self.assertRaises(TypeError, lambda: "string" in c)
+        self.assertRaises(TypeError, lambda: 3.14159 in c)
+
+    def test_grayscale(self):
+        Color = pygame.color.Color
+
+        color = Color(255, 0, 0, 255)
+        self.assertEqual(color.grayscale(), Color(76, 76, 76, 255))
+        color = Color(3, 5, 7, 255)
+        self.assertEqual(color.grayscale(), Color(4, 4, 4, 255))
+        color = Color(3, 5, 70, 255)
+        self.assertEqual(color.grayscale(), Color(11, 11, 11, 255))
+        color = Color(3, 50, 70, 255)
+        self.assertEqual(color.grayscale(), Color(38, 38, 38, 255))
+        color = Color(30, 50, 70, 255)
+        self.assertEqual(color.grayscale(), Color(46, 46, 46, 255))
+
+        color = Color(255, 0, 0, 144)
+        self.assertEqual(color.grayscale(), Color(76, 76, 76, 144))
+        color = Color(3, 5, 7, 144)
+        self.assertEqual(color.grayscale(), Color(4, 4, 4, 144))
+        color = Color(3, 5, 70, 144)
+        self.assertEqual(color.grayscale(), Color(11, 11, 11, 144))
+        color = Color(3, 50, 70, 144)
+        self.assertEqual(color.grayscale(), Color(38, 38, 38, 144))
+        color = Color(30, 50, 70, 144)
+        self.assertEqual(color.grayscale(), Color(46, 46, 46, 144))
+
+    def test_lerp(self):
+        # setup
+        Color = pygame.color.Color
+
+        color0 = Color(0, 0, 0, 0)
+        color128 = Color(128, 128, 128, 128)
+        color255 = Color(255, 255, 255, 255)
+        color100 = Color(100, 100, 100, 100)
+
+        # type checking
+        self.assertTrue(isinstance(color0.lerp(color128, 0.5), Color))
+
+        # common value testing
+        self.assertEqual(color0.lerp(color128, 0.5), Color(64, 64, 64, 64))
+        self.assertEqual(color0.lerp(color128, 0.5), Color(64, 64, 64, 64))
+        self.assertEqual(color128.lerp(color255, 0.5), Color(192, 192, 192, 192))
+        self.assertEqual(color0.lerp(color255, 0.5), Color(128, 128, 128, 128))
+
+        # testing extremes
+        self.assertEqual(color0.lerp(color100, 0), color0)
+        self.assertEqual(color0.lerp(color100, 0.01), Color(1, 1, 1, 1))
+        self.assertEqual(color0.lerp(color100, 0.99), Color(99, 99, 99, 99))
+        self.assertEqual(color0.lerp(color100, 1), color100)
+
+        # kwarg testing
+        self.assertEqual(color0.lerp(color=color100, amount=0.5), Color(50, 50, 50, 50))
+        self.assertEqual(color0.lerp(amount=0.5, color=color100), Color(50, 50, 50, 50))
+
+        # invalid input testing
+        self.assertRaises(ValueError, lambda: color0.lerp(color128, 2.5))
+        self.assertRaises(ValueError, lambda: color0.lerp(color128, -0.5))
+        self.assertRaises(ValueError, lambda: color0.lerp((256, 0, 0, 0), 0.5))
+        self.assertRaises(ValueError, lambda: color0.lerp((0, 256, 0, 0), 0.5))
+        self.assertRaises(ValueError, lambda: color0.lerp((0, 0, 256, 0), 0.5))
+        self.assertRaises(ValueError, lambda: color0.lerp((0, 0, 0, 256), 0.5))
+        self.assertRaises(TypeError, lambda: color0.lerp(0.2, 0.5))
+
+    def test_premul_alpha(self):
+        # setup
+        Color = pygame.color.Color
+
+        color0 = Color(0, 0, 0, 0)
+        alpha0 = Color(255, 255, 255, 0)
+        alpha49 = Color(255, 0, 0, 49)
+        alpha67 = Color(0, 255, 0, 67)
+        alpha73 = Color(0, 0, 255, 73)
+        alpha128 = Color(255, 255, 255, 128)
+        alpha199 = Color(255, 255, 255, 199)
+        alpha255 = Color(128, 128, 128, 255)
+
+        # type checking
+        self.assertTrue(isinstance(color0.premul_alpha(), Color))
+
+        # 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))
+        self.assertEqual(alpha73.premul_alpha(), Color(0, 0, 73, 73))
+        self.assertEqual(alpha128.premul_alpha(), Color(128, 128, 128, 128))
+        self.assertEqual(alpha199.premul_alpha(), Color(199, 199, 199, 199))
+        self.assertEqual(alpha255.premul_alpha(), Color(128, 128, 128, 255))
+
+        # full range of alpha auto sub-testing
+        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):
+                    alpha = a / 255.0
+                    self.assertEqual(
+                        Color(r, g, b, a).premul_alpha(),
+                        Color(
+                            ((r + 1) * a) >> 8,
+                            ((g + 1) * a) >> 8,
+                            ((b + 1) * a) >> 8,
+                            a,
+                        ),
+                    )
+
+    def test_update(self):
+        c = pygame.color.Color(0, 0, 0)
+        c.update(1, 2, 3, 4)
+
+        self.assertEqual(c.r, 1)
+        self.assertEqual(c.g, 2)
+        self.assertEqual(c.b, 3)
+        self.assertEqual(c.a, 4)
+
+        c = pygame.color.Color(0, 0, 0)
+        c.update([1, 2, 3, 4])
+
+        self.assertEqual(c.r, 1)
+        self.assertEqual(c.g, 2)
+        self.assertEqual(c.b, 3)
+        self.assertEqual(c.a, 4)
+
+        c = pygame.color.Color(0, 0, 0)
+        c2 = pygame.color.Color(1, 2, 3, 4)
+        c.update(c2)
+
+        self.assertEqual(c.r, 1)
+        self.assertEqual(c.g, 2)
+        self.assertEqual(c.b, 3)
+        self.assertEqual(c.a, 4)
+
+        c = pygame.color.Color(1, 1, 1)
+        c.update("black")
+
+        self.assertEqual(c.r, 0)
+        self.assertEqual(c.g, 0)
+        self.assertEqual(c.b, 0)
+        self.assertEqual(c.a, 255)
+
+        c = pygame.color.Color(0, 0, 0, 120)
+        c.set_length(3)
+        c.update(1, 2, 3)
+        self.assertEqual(len(c), 3)
+        c.set_length(4)
+        self.assertEqual(c[3], 120)
+
+        c.set_length(3)
+        c.update(1, 2, 3, 4)
+        self.assertEqual(len(c), 4)
+
+    def test_collection_abc(self):
+        c = pygame.Color(64, 70, 75, 255)
+        self.assertTrue(isinstance(c, Collection))
+        self.assertFalse(isinstance(c, Sequence))
+
+
+class SubclassTest(unittest.TestCase):
+    class MyColor(pygame.Color):
+        def __init__(self, *args, **kwds):
+            super(SubclassTest.MyColor, self).__init__(*args, **kwds)
+            self.an_attribute = True
+
+    def test_add(self):
+        mc1 = self.MyColor(128, 128, 128, 255)
+        self.assertTrue(mc1.an_attribute)
+        c2 = pygame.Color(64, 64, 64, 255)
+        mc2 = mc1 + c2
+        self.assertTrue(isinstance(mc2, self.MyColor))
+        self.assertRaises(AttributeError, getattr, mc2, "an_attribute")
+        c3 = c2 + mc1
+        self.assertTrue(type(c3) is pygame.Color)
+
+    def test_sub(self):
+        mc1 = self.MyColor(128, 128, 128, 255)
+        self.assertTrue(mc1.an_attribute)
+        c2 = pygame.Color(64, 64, 64, 255)
+        mc2 = mc1 - c2
+        self.assertTrue(isinstance(mc2, self.MyColor))
+        self.assertRaises(AttributeError, getattr, mc2, "an_attribute")
+        c3 = c2 - mc1
+        self.assertTrue(type(c3) is pygame.Color)
+
+    def test_mul(self):
+        mc1 = self.MyColor(128, 128, 128, 255)
+        self.assertTrue(mc1.an_attribute)
+        c2 = pygame.Color(64, 64, 64, 255)
+        mc2 = mc1 * c2
+        self.assertTrue(isinstance(mc2, self.MyColor))
+        self.assertRaises(AttributeError, getattr, mc2, "an_attribute")
+        c3 = c2 * mc1
+        self.assertTrue(type(c3) is pygame.Color)
+
+    def test_div(self):
+        mc1 = self.MyColor(128, 128, 128, 255)
+        self.assertTrue(mc1.an_attribute)
+        c2 = pygame.Color(64, 64, 64, 255)
+        mc2 = mc1 // c2
+        self.assertTrue(isinstance(mc2, self.MyColor))
+        self.assertRaises(AttributeError, getattr, mc2, "an_attribute")
+        c3 = c2 // mc1
+        self.assertTrue(type(c3) is pygame.Color)
+
+    def test_mod(self):
+        mc1 = self.MyColor(128, 128, 128, 255)
+        self.assertTrue(mc1.an_attribute)
+        c2 = pygame.Color(64, 64, 64, 255)
+        mc2 = mc1 % c2
+        self.assertTrue(isinstance(mc2, self.MyColor))
+        self.assertRaises(AttributeError, getattr, mc2, "an_attribute")
+        c3 = c2 % mc1
+        self.assertTrue(type(c3) is pygame.Color)
+
+    def test_inv(self):
+        mc1 = self.MyColor(64, 64, 64, 64)
+        self.assertTrue(mc1.an_attribute)
+        mc2 = ~mc1
+        self.assertTrue(isinstance(mc2, self.MyColor))
+        self.assertRaises(AttributeError, getattr, mc2, "an_attribute")
+
+    def test_correct_gamma(self):
+        mc1 = self.MyColor(64, 70, 75, 255)
+        self.assertTrue(mc1.an_attribute)
+        mc2 = mc1.correct_gamma(0.03)
+        self.assertTrue(isinstance(mc2, self.MyColor))
+        self.assertRaises(AttributeError, getattr, mc2, "an_attribute")
+
+    def test_collection_abc(self):
+        mc1 = self.MyColor(64, 70, 75, 255)
+        self.assertTrue(isinstance(mc1, Collection))
+        self.assertFalse(isinstance(mc1, Sequence))
+
+
+################################################################################
+
+if __name__ == "__main__":
+    unittest.main()
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/constants_test.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/constants_test.py
new file mode 100644
index 0000000..a028f98
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/constants_test.py
@@ -0,0 +1,426 @@
+import unittest
+import pygame.constants
+
+
+# K_* and KSCAN_* common names.
+K_AND_KSCAN_COMMON_NAMES = (
+    "UNKNOWN",
+    "BACKSPACE",
+    "TAB",
+    "CLEAR",
+    "RETURN",
+    "PAUSE",
+    "ESCAPE",
+    "SPACE",
+    "COMMA",
+    "MINUS",
+    "PERIOD",
+    "SLASH",
+    "0",
+    "1",
+    "2",
+    "3",
+    "4",
+    "5",
+    "6",
+    "7",
+    "8",
+    "9",
+    "SEMICOLON",
+    "EQUALS",
+    "LEFTBRACKET",
+    "BACKSLASH",
+    "RIGHTBRACKET",
+    "DELETE",
+    "KP0",
+    "KP1",
+    "KP2",
+    "KP3",
+    "KP4",
+    "KP5",
+    "KP6",
+    "KP7",
+    "KP8",
+    "KP9",
+    "KP_PERIOD",
+    "KP_DIVIDE",
+    "KP_MULTIPLY",
+    "KP_MINUS",
+    "KP_PLUS",
+    "KP_ENTER",
+    "KP_EQUALS",
+    "UP",
+    "DOWN",
+    "RIGHT",
+    "LEFT",
+    "INSERT",
+    "HOME",
+    "END",
+    "PAGEUP",
+    "PAGEDOWN",
+    "F1",
+    "F2",
+    "F3",
+    "F4",
+    "F5",
+    "F6",
+    "F7",
+    "F8",
+    "F9",
+    "F10",
+    "F11",
+    "F12",
+    "F13",
+    "F14",
+    "F15",
+    "NUMLOCK",
+    "CAPSLOCK",
+    "SCROLLOCK",
+    "RSHIFT",
+    "LSHIFT",
+    "RCTRL",
+    "LCTRL",
+    "RALT",
+    "LALT",
+    "RMETA",
+    "LMETA",
+    "LSUPER",
+    "RSUPER",
+    "MODE",
+    "HELP",
+    "PRINT",
+    "SYSREQ",
+    "BREAK",
+    "MENU",
+    "POWER",
+    "EURO",
+    "KP_0",
+    "KP_1",
+    "KP_2",
+    "KP_3",
+    "KP_4",
+    "KP_5",
+    "KP_6",
+    "KP_7",
+    "KP_8",
+    "KP_9",
+    "NUMLOCKCLEAR",
+    "SCROLLLOCK",
+    "RGUI",
+    "LGUI",
+    "PRINTSCREEN",
+    "CURRENCYUNIT",
+    "CURRENCYSUBUNIT",
+)
+
+# Constants that have the same value.
+K_AND_KSCAN_COMMON_OVERLAPS = (
+    ("KP0", "KP_0"),
+    ("KP1", "KP_1"),
+    ("KP2", "KP_2"),
+    ("KP3", "KP_3"),
+    ("KP4", "KP_4"),
+    ("KP5", "KP_5"),
+    ("KP6", "KP_6"),
+    ("KP7", "KP_7"),
+    ("KP8", "KP_8"),
+    ("KP9", "KP_9"),
+    ("NUMLOCK", "NUMLOCKCLEAR"),
+    ("SCROLLOCK", "SCROLLLOCK"),
+    ("LSUPER", "LMETA", "LGUI"),
+    ("RSUPER", "RMETA", "RGUI"),
+    ("PRINT", "PRINTSCREEN"),
+    ("BREAK", "PAUSE"),
+    ("EURO", "CURRENCYUNIT"),
+)
+
+
+def create_overlap_set(constant_names):
+    """Helper function to find overlapping constant values/names.
+
+    Returns a set of fronzensets:
+        set(frozenset(names of overlapping constants), ...)
+    """
+    # Create an overlap dict.
+    overlap_dict = {}
+
+    for name in constant_names:
+        value = getattr(pygame.constants, name)
+        overlap_dict.setdefault(value, set()).add(name)
+
+    # Get all entries with more than 1 value.
+    overlaps = set()
+
+    for overlap_names in overlap_dict.values():
+        if len(overlap_names) > 1:
+            overlaps.add(frozenset(overlap_names))
+
+    return overlaps
+
+
+class KConstantsTests(unittest.TestCase):
+    """Test K_* (key) constants."""
+
+    # K_* specific names.
+    K_SPECIFIC_NAMES = (
+        "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",
+        "QUOTE",
+        "BACKQUOTE",
+        "EXCLAIM",
+        "QUOTEDBL",
+        "HASH",
+        "DOLLAR",
+        "AMPERSAND",
+        "LEFTPAREN",
+        "RIGHTPAREN",
+        "ASTERISK",
+        "PLUS",
+        "COLON",
+        "LESS",
+        "GREATER",
+        "QUESTION",
+        "AT",
+        "CARET",
+        "UNDERSCORE",
+        "PERCENT",
+    )
+
+    # Create a sequence of all the K_* constant names.
+    K_NAMES = tuple("K_" + n for n in K_AND_KSCAN_COMMON_NAMES + K_SPECIFIC_NAMES)
+
+    def test_k__existence(self):
+        """Ensures K constants exist."""
+        for name in self.K_NAMES:
+            self.assertTrue(hasattr(pygame.constants, name), f"missing constant {name}")
+
+    def test_k__type(self):
+        """Ensures K constants are the correct type."""
+        for name in self.K_NAMES:
+            value = getattr(pygame.constants, name)
+
+            self.assertIs(type(value), int)
+
+    def test_k__value_overlap(self):
+        """Ensures no unexpected K constant values overlap."""
+        EXPECTED_OVERLAPS = {
+            frozenset("K_" + n for n in item) for item in K_AND_KSCAN_COMMON_OVERLAPS
+        }
+
+        overlaps = create_overlap_set(self.K_NAMES)
+
+        self.assertSetEqual(overlaps, EXPECTED_OVERLAPS)
+
+
+class KscanConstantsTests(unittest.TestCase):
+    """Test KSCAN_* (scancode) constants."""
+
+    # KSCAN_* specific names.
+    KSCAN_SPECIFIC_NAMES = (
+        "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",
+        "APOSTROPHE",
+        "GRAVE",
+        "INTERNATIONAL1",
+        "INTERNATIONAL2",
+        "INTERNATIONAL3",
+        "INTERNATIONAL4",
+        "INTERNATIONAL5",
+        "INTERNATIONAL6",
+        "INTERNATIONAL7",
+        "INTERNATIONAL8",
+        "INTERNATIONAL9",
+        "LANG1",
+        "LANG2",
+        "LANG3",
+        "LANG4",
+        "LANG5",
+        "LANG6",
+        "LANG7",
+        "LANG8",
+        "LANG9",
+        "NONUSBACKSLASH",
+        "NONUSHASH",
+    )
+
+    # Create a sequence of all the KSCAN_* constant names.
+    KSCAN_NAMES = tuple(
+        "KSCAN_" + n for n in K_AND_KSCAN_COMMON_NAMES + KSCAN_SPECIFIC_NAMES
+    )
+
+    def test_kscan__existence(self):
+        """Ensures KSCAN constants exist."""
+        for name in self.KSCAN_NAMES:
+            self.assertTrue(hasattr(pygame.constants, name), f"missing constant {name}")
+
+    def test_kscan__type(self):
+        """Ensures KSCAN constants are the correct type."""
+        for name in self.KSCAN_NAMES:
+            value = getattr(pygame.constants, name)
+
+            self.assertIs(type(value), int)
+
+    def test_kscan__value_overlap(self):
+        """Ensures no unexpected KSCAN constant values overlap."""
+        EXPECTED_OVERLAPS = {
+            frozenset("KSCAN_" + n for n in item)
+            for item in K_AND_KSCAN_COMMON_OVERLAPS
+        }
+
+        overlaps = create_overlap_set(self.KSCAN_NAMES)
+
+        self.assertSetEqual(overlaps, EXPECTED_OVERLAPS)
+
+
+class KmodConstantsTests(unittest.TestCase):
+    """Test KMOD_* (key modifier) constants."""
+
+    # KMOD_* constant names.
+    KMOD_CONSTANTS = (
+        "KMOD_NONE",
+        "KMOD_LSHIFT",
+        "KMOD_RSHIFT",
+        "KMOD_SHIFT",
+        "KMOD_LCTRL",
+        "KMOD_RCTRL",
+        "KMOD_CTRL",
+        "KMOD_LALT",
+        "KMOD_RALT",
+        "KMOD_ALT",
+        "KMOD_LMETA",
+        "KMOD_RMETA",
+        "KMOD_META",
+        "KMOD_NUM",
+        "KMOD_CAPS",
+        "KMOD_MODE",
+        "KMOD_LGUI",
+        "KMOD_RGUI",
+        "KMOD_GUI",
+    )
+
+    def test_kmod__existence(self):
+        """Ensures KMOD constants exist."""
+        for name in self.KMOD_CONSTANTS:
+            self.assertTrue(hasattr(pygame.constants, name), f"missing constant {name}")
+
+    def test_kmod__type(self):
+        """Ensures KMOD constants are the correct type."""
+        for name in self.KMOD_CONSTANTS:
+            value = getattr(pygame.constants, name)
+
+            self.assertIs(type(value), int)
+
+    def test_kmod__value_overlap(self):
+        """Ensures no unexpected KMOD constant values overlap."""
+        # KMODs that have the same values.
+        EXPECTED_OVERLAPS = {
+            frozenset(["KMOD_LGUI", "KMOD_LMETA"]),
+            frozenset(["KMOD_RGUI", "KMOD_RMETA"]),
+            frozenset(["KMOD_GUI", "KMOD_META"]),
+        }
+
+        overlaps = create_overlap_set(self.KMOD_CONSTANTS)
+
+        self.assertSetEqual(overlaps, EXPECTED_OVERLAPS)
+
+    def test_kmod__no_bitwise_overlap(self):
+        """Ensures certain KMOD constants have no overlapping bits."""
+        NO_BITWISE_OVERLAP = (
+            "KMOD_NONE",
+            "KMOD_LSHIFT",
+            "KMOD_RSHIFT",
+            "KMOD_LCTRL",
+            "KMOD_RCTRL",
+            "KMOD_LALT",
+            "KMOD_RALT",
+            "KMOD_LMETA",
+            "KMOD_RMETA",
+            "KMOD_NUM",
+            "KMOD_CAPS",
+            "KMOD_MODE",
+        )
+
+        kmods = 0
+
+        for name in NO_BITWISE_OVERLAP:
+            value = getattr(pygame.constants, name)
+
+            self.assertFalse(kmods & value)
+
+            kmods |= value
+
+    def test_kmod__bitwise_overlap(self):
+        """Ensures certain KMOD constants have overlapping bits."""
+        # KMODS that are comprised of other KMODs.
+        KMOD_COMPRISED_DICT = {
+            "KMOD_SHIFT": ("KMOD_LSHIFT", "KMOD_RSHIFT"),
+            "KMOD_CTRL": ("KMOD_LCTRL", "KMOD_RCTRL"),
+            "KMOD_ALT": ("KMOD_LALT", "KMOD_RALT"),
+            "KMOD_META": ("KMOD_LMETA", "KMOD_RMETA"),
+            "KMOD_GUI": ("KMOD_LGUI", "KMOD_RGUI"),
+        }
+
+        for base_name, seq_names in KMOD_COMPRISED_DICT.items():
+            expected_value = 0  # Reset.
+
+            for name in seq_names:
+                expected_value |= getattr(pygame.constants, name)
+
+            value = getattr(pygame.constants, base_name)
+
+            self.assertEqual(value, expected_value)
+
+
+################################################################################
+
+
+if __name__ == "__main__":
+    unittest.main()
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/controller_test.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/controller_test.py
new file mode 100644
index 0000000..f05c00c
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/controller_test.py
@@ -0,0 +1,357 @@
+import unittest
+import pygame
+import pygame._sdl2.controller as controller
+from pygame.tests.test_utils import prompt, question
+
+
+class ControllerModuleTest(unittest.TestCase):
+    def setUp(self):
+        controller.init()
+
+    def tearDown(self):
+        controller.quit()
+
+    def test_init(self):
+        controller.quit()
+        controller.init()
+        self.assertTrue(controller.get_init())
+
+    def test_init__multiple(self):
+        controller.init()
+        controller.init()
+        self.assertTrue(controller.get_init())
+
+    def test_quit(self):
+        controller.quit()
+        self.assertFalse(controller.get_init())
+
+    def test_quit__multiple(self):
+        controller.quit()
+        controller.quit()
+        self.assertFalse(controller.get_init())
+
+    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)
+
+    def test_is_controller(self):
+        for i in range(controller.get_count()):
+            if controller.is_controller(i):
+                c = controller.Controller(i)
+                self.assertIsInstance(c, controller.Controller)
+                c.quit()
+            else:
+                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):
+        controller.init()
+
+    def tearDown(self):
+        controller.quit()
+
+    def _get_first_controller(self):
+        for i in range(controller.get_count()):
+            if controller.is_controller(i):
+                return controller.Controller(i)
+
+    def test_construction(self):
+        c = self._get_first_controller()
+        if c:
+            self.assertIsInstance(c, controller.Controller)
+        else:
+            self.skipTest("No controller connected")
+
+    def test__auto_init(self):
+        c = self._get_first_controller()
+        if c:
+            self.assertTrue(c.get_init())
+        else:
+            self.skipTest("No controller connected")
+
+    def test_get_init(self):
+        c = self._get_first_controller()
+        if c:
+            self.assertTrue(c.get_init())
+            c.quit()
+            self.assertFalse(c.get_init())
+        else:
+            self.skipTest("No controller connected")
+
+    def test_from_joystick(self):
+        for i in range(controller.get_count()):
+            if controller.is_controller(i):
+                joy = pygame.joystick.Joystick(i)
+                break
+        else:
+            self.skipTest("No controller connected")
+
+        c = controller.Controller.from_joystick(joy)
+        self.assertIsInstance(c, controller.Controller)
+
+    def test_as_joystick(self):
+        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):
+        c = self._get_first_controller()
+        if c:
+            mapping = c.get_mapping()
+            self.assertIsInstance(mapping, dict)
+            self.assertIsNotNone(mapping["a"])
+        else:
+            self.skipTest("No controller connected")
+
+    def test_set_mapping(self):
+        c = self._get_first_controller()
+        if c:
+            mapping = c.get_mapping()
+            mapping["a"] = "b3"
+            mapping["y"] = "b0"
+            c.set_mapping(mapping)
+            new_mapping = c.get_mapping()
+
+            self.assertEqual(len(mapping), len(new_mapping))
+            for i in mapping:
+                if mapping[i] not in ("a", "y"):
+                    self.assertEqual(mapping[i], new_mapping[i])
+                else:
+                    if i == "a":
+                        self.assertEqual(new_mapping[i], mapping["y"])
+                    else:
+                        self.assertEqual(new_mapping[i], mapping["a"])
+        else:
+            self.skipTest("No controller connected")
+
+
+class ControllerInteractiveTest(unittest.TestCase):
+    __tags__ = ["interactive"]
+
+    def _get_first_controller(self):
+        for i in range(controller.get_count()):
+            if controller.is_controller(i):
+                return controller.Controller(i)
+
+    def setUp(self):
+        controller.init()
+
+    def tearDown(self):
+        controller.quit()
+
+    def test__get_count_interactive(self):
+        prompt(
+            "Please connect at least one controller "
+            "before the test for controller.get_count() starts"
+        )
+
+        # Reset the number of joysticks counted
+        controller.quit()
+        controller.init()
+
+        joystick_num = controller.get_count()
+        ans = question(
+            "get_count() thinks there are {} joysticks "
+            "connected. Is that correct?".format(joystick_num)
+        )
+
+        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:
+            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
+
+        label1 = font.render(
+            "Press button 'x' (on ps4) or 'a' (on xbox).", True, (0, 0, 0)
+        )
+
+        label2 = font.render(
+            'The two values should match up. Press "y" or "n" to confirm.',
+            True,
+            (0, 0, 0),
+        )
+
+        is_pressed = [False, False]  # event, get_button()
+        while running:
+            for event in pygame.event.get():
+                if event.type == pygame.QUIT:
+                    running = False
+                if event.type == pygame.CONTROLLERBUTTONDOWN and event.button == 0:
+                    is_pressed[0] = True
+                if event.type == pygame.CONTROLLERBUTTONUP and event.button == 0:
+                    is_pressed[0] = False
+
+                if event.type == pygame.KEYDOWN:
+                    if event.key == pygame.K_y:
+                        running = False
+                    if event.key == pygame.K_n:
+                        running = False
+                        pygame.display.quit()
+                        pygame.font.quit()
+                        self.fail()
+
+            is_pressed[1] = c.get_button(pygame.CONTROLLER_BUTTON_A)
+
+            screen.fill((255, 255, 255))
+            screen.blit(label1, (0, 0))
+            screen.blit(label2, (0, 20))
+            screen.blit(font.render(str(is_pressed), True, (0, 0, 0)), (0, 40))
+            pygame.display.update()
+
+        pygame.display.quit()
+        pygame.font.quit()
+
+    def test_get_axis_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
+
+        label1 = font.render(
+            "Press down the right trigger. The value on-screen should", True, (0, 0, 0)
+        )
+
+        label2 = font.render(
+            "indicate how far the trigger is pressed down. This value should",
+            True,
+            (0, 0, 0),
+        )
+
+        label3 = font.render(
+            'be in the range of 0-32767. Press "y" or "n" to confirm.', True, (0, 0, 0)
+        )
+
+        while running:
+            for event in pygame.event.get():
+                if event.type == pygame.QUIT:
+                    running = False
+
+                if event.type == pygame.KEYDOWN:
+                    if event.key == pygame.K_y:
+                        running = False
+                    if event.key == pygame.K_n:
+                        running = False
+                        pygame.display.quit()
+                        pygame.font.quit()
+                        self.fail()
+
+            right_trigger = c.get_axis(pygame.CONTROLLER_AXIS_TRIGGERRIGHT)
+
+            screen.fill((255, 255, 255))
+            screen.blit(label1, (0, 0))
+            screen.blit(label2, (0, 20))
+            screen.blit(label3, (0, 40))
+            screen.blit(font.render(str(right_trigger), True, (0, 0, 0)), (0, 60))
+            pygame.display.update()
+
+        pygame.display.quit()
+        pygame.font.quit()
+
+
+if __name__ == "__main__":
+    unittest.main()
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/cursors_test.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/cursors_test.py
new file mode 100644
index 0000000..8132c51
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/cursors_test.py
@@ -0,0 +1,290 @@
+import unittest
+from pygame.tests.test_utils import fixture_path
+import pygame
+
+
+class CursorsModuleTest(unittest.TestCase):
+    def test_compile(self):
+        # __doc__ (as of 2008-06-25) for pygame.cursors.compile:
+
+        # pygame.cursors.compile(strings, black, white,xor) -> data, mask
+        # compile cursor strings into cursor data
+        #
+        # 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.
+        #
+        # 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.
+        #
+        # 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().
+
+        # Various types of input strings
+        test_cursor1 = ("X.X.XXXX", "XXXXXX..", "  XXXX  ")
+
+        test_cursor2 = (
+            "X.X.XXXX",
+            "XXXXXX..",
+            "XXXXXX ",
+            "XXXXXX..",
+            "XXXXXX..",
+            "XXXXXX",
+            "XXXXXX..",
+            "XXXXXX..",
+        )
+        test_cursor3 = (".XX.", "  ", "..  ", "X.. X")
+
+        # Test such that total number of strings is not divisible by 8
+        with self.assertRaises(ValueError):
+            pygame.cursors.compile(test_cursor1)
+
+        # Test such that size of individual string is not divisible by 8
+        with self.assertRaises(ValueError):
+            pygame.cursors.compile(test_cursor2)
+
+        # Test such that neither size of individual string nor total number of strings is divisible by 8
+        with self.assertRaises(ValueError):
+            pygame.cursors.compile(test_cursor3)
+
+        # 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,
+        )
+
+        cursor = pygame.cursors.compile(pygame.cursors.thickarrow_strings)
+        self.assertEqual(cursor, actual_byte_data)
+
+        # Test such that cursor byte data obtained from compile function is valid in pygame.mouse.set_cursor()
+        pygame.display.init()
+        try:
+            pygame.mouse.set_cursor((24, 24), (0, 0), *cursor)
+        except pygame.error as e:
+            if "not currently supported" in str(e):
+                unittest.skip("skipping test as set_cursor() is not supported")
+        finally:
+            pygame.display.quit()
+
+    ################################################################################
+
+    def test_load_xbm(self):
+        # __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
+        #
+        # Arguments can either be filenames or filelike objects
+        # with the readlines method. Not largely tested, but
+        # should work with typical XBM files.
+
+        # Test that load_xbm will take filenames as arguments
+        cursorfile = fixture_path(r"xbm_cursors/white_sizing.xbm")
+        maskfile = fixture_path(r"xbm_cursors/white_sizing_mask.xbm")
+        cursor = pygame.cursors.load_xbm(cursorfile, maskfile)
+
+        # Test that load_xbm will take file objects as arguments
+        with open(cursorfile) as cursor_f, open(maskfile) as mask_f:
+            cursor = pygame.cursors.load_xbm(cursor_f, mask_f)
+
+        # Can it load using pathlib.Path?
+        import pathlib
+
+        cursor = pygame.cursors.load_xbm(
+            pathlib.Path(cursorfile), pathlib.Path(maskfile)
+        )
+
+        # Is it in a format that mouse.set_cursor won't blow up on?
+        pygame.display.init()
+        try:
+            pygame.mouse.set_cursor(*cursor)
+        except pygame.error as e:
+            if "not currently supported" in str(e):
+                unittest.skip("skipping test as set_cursor() is not supported")
+        finally:
+            pygame.display.quit()
+
+    def test_Cursor(self):
+        """Ensure that the cursor object parses information properly"""
+
+        c1 = pygame.cursors.Cursor(pygame.SYSTEM_CURSOR_CROSSHAIR)
+
+        self.assertEqual(c1.data, (pygame.SYSTEM_CURSOR_CROSSHAIR,))
+        self.assertEqual(c1.type, "system")
+
+        c2 = pygame.cursors.Cursor(c1)
+
+        self.assertEqual(c1, c2)
+
+        with self.assertRaises(TypeError):
+            pygame.cursors.Cursor(-34002)
+        with self.assertRaises(TypeError):
+            pygame.cursors.Cursor("a", "b", "c", "d")
+        with self.assertRaises(TypeError):
+            pygame.cursors.Cursor((2,))
+
+        c3 = pygame.cursors.Cursor((0, 0), pygame.Surface((20, 20)))
+
+        self.assertEqual(c3.data[0], (0, 0))
+        self.assertEqual(c3.data[1].get_size(), (20, 20))
+        self.assertEqual(c3.type, "color")
+
+        xormask, andmask = pygame.cursors.compile(pygame.cursors.thickarrow_strings)
+        c4 = pygame.cursors.Cursor((24, 24), (0, 0), xormask, andmask)
+
+        self.assertEqual(c4.data, ((24, 24), (0, 0), xormask, andmask))
+        self.assertEqual(c4.type, "bitmap")
+
+
+################################################################################
+
+if __name__ == "__main__":
+    unittest.main()
+
+################################################################################
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/display_test.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/display_test.py
new file mode 100644
index 0000000..eec521f
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/display_test.py
@@ -0,0 +1,1199 @@
+import unittest
+import os
+import sys
+import time
+
+import pygame, pygame.transform
+
+from pygame.tests.test_utils import question
+
+from pygame import display
+
+
+class DisplayModuleTest(unittest.TestCase):
+    default_caption = "pygame window"
+
+    def setUp(self):
+        display.init()
+
+    def tearDown(self):
+        display.quit()
+
+    def test_Info(self):
+        inf = pygame.display.Info()
+        self.assertNotEqual(inf.current_h, -1)
+        self.assertNotEqual(inf.current_w, -1)
+        # probably have an older SDL than 1.2.10 if -1.
+
+        screen = pygame.display.set_mode((128, 128))
+        inf = pygame.display.Info()
+        self.assertEqual(inf.current_h, 128)
+        self.assertEqual(inf.current_w, 128)
+
+    def test_flip(self):
+        screen = pygame.display.set_mode((100, 100))
+
+        # test without a change
+        self.assertIsNone(pygame.display.flip())
+
+        # test with a change
+        pygame.Surface.fill(screen, (66, 66, 53))
+        self.assertIsNone(pygame.display.flip())
+
+        # test without display init
+        pygame.display.quit()
+        with self.assertRaises(pygame.error):
+            (pygame.display.flip())
+
+        # test without window
+        del screen
+        with self.assertRaises(pygame.error):
+            (pygame.display.flip())
+
+    def test_get_active(self):
+        """Test the get_active function"""
+
+        # Initially, the display is not active
+        pygame.display.quit()
+        self.assertEqual(pygame.display.get_active(), False)
+
+        # get_active defaults to true after a set_mode
+        pygame.display.init()
+        pygame.display.set_mode((640, 480))
+        self.assertEqual(pygame.display.get_active(), True)
+
+        # get_active after init/quit should be False
+        # since no display is visible
+        pygame.display.quit()
+        pygame.display.init()
+        self.assertEqual(pygame.display.get_active(), False)
+
+    @unittest.skipIf(
+        os.environ.get("SDL_VIDEODRIVER") == "dummy",
+        "requires the SDL_VIDEODRIVER to be a non dummy value",
+    )
+    def test_get_active_iconify(self):
+        """Test the get_active function after an iconify"""
+
+        # According to the docs, get_active should return
+        # false if the display is iconified
+        pygame.display.set_mode((640, 480))
+
+        pygame.event.clear()
+        pygame.display.iconify()
+
+        for _ in range(100):
+            time.sleep(0.01)
+            pygame.event.pump()
+
+        self.assertEqual(pygame.display.get_active(), False)
+
+    def test_get_caption(self):
+        screen = display.set_mode((100, 100))
+
+        self.assertEqual(display.get_caption()[0], self.default_caption)
+
+    def test_set_caption(self):
+        TEST_CAPTION = "test"
+        screen = display.set_mode((100, 100))
+
+        self.assertIsNone(display.set_caption(TEST_CAPTION))
+        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)
+        self.assertEqual(display.get_caption()[0], TEST_CAPTION)
+
+    def test_get_driver(self):
+        drivers = [
+            "aalib",
+            "android",
+            "arm",
+            "cocoa",
+            "dga",
+            "directx",
+            "directfb",
+            "dummy",
+            "emscripten",
+            "fbcon",
+            "ggi",
+            "haiku",
+            "khronos",
+            "kmsdrm",
+            "nacl",
+            "offscreen",
+            "pandora",
+            "psp",
+            "qnx",
+            "raspberry",
+            "svgalib",
+            "uikit",
+            "vgl",
+            "vivante",
+            "wayland",
+            "windows",
+            "windib",
+            "winrt",
+            "x11",
+        ]
+        driver = display.get_driver()
+        self.assertIn(driver, drivers)
+
+        display.quit()
+        with self.assertRaises(pygame.error):
+            driver = display.get_driver()
+
+    def test_get_init(self):
+        """Ensures the module's initialization state can be retrieved."""
+        # 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."""
+        lengths = (1, 5, 100)
+
+        for expected_size in ((w, h) for w in lengths for h in lengths):
+            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_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."""
+        surface = pygame.display.get_surface()
+
+        self.assertIsNone(surface)
+
+    def test_get_wm_info(self):
+        wm_info = display.get_wm_info()
+        # Assert function returns a dictionary type
+        self.assertIsInstance(wm_info, dict)
+
+        wm_info_potential_keys = {
+            "colorbuffer",
+            "connection",
+            "data",
+            "dfb",
+            "display",
+            "framebuffer",
+            "fswindow",
+            "hdc",
+            "hglrc",
+            "hinstance",
+            "lock_func",
+            "resolveFramebuffer",
+            "shell_surface",
+            "surface",
+            "taskHandle",
+            "unlock_func",
+            "wimpVersion",
+            "window",
+            "wmwindow",
+        }
+
+        # If any unexpected dict keys are present, they
+        # will be stored in set wm_info_remaining_keys
+        wm_info_remaining_keys = set(wm_info.keys()).difference(wm_info_potential_keys)
+
+        # Assert set is empty (& therefore does not
+        # contain unexpected dict keys)
+        self.assertFalse(wm_info_remaining_keys)
+
+    @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_get_attribute(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(pygame.GL_ALPHA_SIZE))
+        original_values.append(pygame.display.gl_get_attribute(pygame.GL_DEPTH_SIZE))
+        original_values.append(pygame.display.gl_get_attribute(pygame.GL_STENCIL_SIZE))
+        original_values.append(
+            pygame.display.gl_get_attribute(pygame.GL_ACCUM_RED_SIZE)
+        )
+        original_values.append(
+            pygame.display.gl_get_attribute(pygame.GL_ACCUM_GREEN_SIZE)
+        )
+        original_values.append(
+            pygame.display.gl_get_attribute(pygame.GL_ACCUM_BLUE_SIZE)
+        )
+        original_values.append(
+            pygame.display.gl_get_attribute(pygame.GL_ACCUM_ALPHA_SIZE)
+        )
+        original_values.append(
+            pygame.display.gl_get_attribute(pygame.GL_MULTISAMPLEBUFFERS)
+        )
+        original_values.append(
+            pygame.display.gl_get_attribute(pygame.GL_MULTISAMPLESAMPLES)
+        )
+        original_values.append(pygame.display.gl_get_attribute(pygame.GL_STEREO))
+
+        original_values.append(
+            pygame.display.gl_get_attribute(pygame.GL_ACCELERATED_VISUAL)
+        )
+        original_values.append(
+            pygame.display.gl_get_attribute(pygame.GL_CONTEXT_MAJOR_VERSION)
+        )
+        original_values.append(
+            pygame.display.gl_get_attribute(pygame.GL_CONTEXT_MINOR_VERSION)
+        )
+        original_values.append(pygame.display.gl_get_attribute(pygame.GL_CONTEXT_FLAGS))
+        original_values.append(
+            pygame.display.gl_get_attribute(pygame.GL_CONTEXT_PROFILE_MASK)
+        )
+        original_values.append(
+            pygame.display.gl_get_attribute(pygame.GL_SHARE_WITH_CURRENT_CONTEXT)
+        )
+        original_values.append(
+            pygame.display.gl_get_attribute(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(pygame.GL_ALPHA_SIZE, 8)
+        pygame.display.gl_set_attribute(pygame.GL_DEPTH_SIZE, 24)
+        pygame.display.gl_set_attribute(pygame.GL_STENCIL_SIZE, 8)
+        pygame.display.gl_set_attribute(pygame.GL_ACCUM_RED_SIZE, 16)
+        pygame.display.gl_set_attribute(pygame.GL_ACCUM_GREEN_SIZE, 16)
+        pygame.display.gl_set_attribute(pygame.GL_ACCUM_BLUE_SIZE, 16)
+        pygame.display.gl_set_attribute(pygame.GL_ACCUM_ALPHA_SIZE, 16)
+        pygame.display.gl_set_attribute(pygame.GL_MULTISAMPLEBUFFERS, 1)
+        pygame.display.gl_set_attribute(pygame.GL_MULTISAMPLESAMPLES, 1)
+        pygame.display.gl_set_attribute(pygame.GL_STEREO, 0)
+        pygame.display.gl_set_attribute(pygame.GL_ACCELERATED_VISUAL, 0)
+        pygame.display.gl_set_attribute(pygame.GL_CONTEXT_MAJOR_VERSION, 1)
+        pygame.display.gl_set_attribute(pygame.GL_CONTEXT_MINOR_VERSION, 1)
+        pygame.display.gl_set_attribute(pygame.GL_CONTEXT_FLAGS, 0)
+        pygame.display.gl_set_attribute(pygame.GL_CONTEXT_PROFILE_MASK, 0)
+        pygame.display.gl_set_attribute(pygame.GL_SHARE_WITH_CURRENT_CONTEXT, 0)
+        pygame.display.gl_set_attribute(pygame.GL_FRAMEBUFFER_SRGB_CAPABLE, 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(pygame.GL_ALPHA_SIZE))
+        get_values.append(pygame.display.gl_get_attribute(pygame.GL_DEPTH_SIZE))
+        get_values.append(pygame.display.gl_get_attribute(pygame.GL_STENCIL_SIZE))
+        get_values.append(pygame.display.gl_get_attribute(pygame.GL_ACCUM_RED_SIZE))
+        get_values.append(pygame.display.gl_get_attribute(pygame.GL_ACCUM_GREEN_SIZE))
+        get_values.append(pygame.display.gl_get_attribute(pygame.GL_ACCUM_BLUE_SIZE))
+        get_values.append(pygame.display.gl_get_attribute(pygame.GL_ACCUM_ALPHA_SIZE))
+        get_values.append(pygame.display.gl_get_attribute(pygame.GL_MULTISAMPLEBUFFERS))
+        get_values.append(pygame.display.gl_get_attribute(pygame.GL_MULTISAMPLESAMPLES))
+        get_values.append(pygame.display.gl_get_attribute(pygame.GL_STEREO))
+        get_values.append(pygame.display.gl_get_attribute(pygame.GL_ACCELERATED_VISUAL))
+        get_values.append(
+            pygame.display.gl_get_attribute(pygame.GL_CONTEXT_MAJOR_VERSION)
+        )
+        get_values.append(
+            pygame.display.gl_get_attribute(pygame.GL_CONTEXT_MINOR_VERSION)
+        )
+        get_values.append(pygame.display.gl_get_attribute(pygame.GL_CONTEXT_FLAGS))
+        get_values.append(
+            pygame.display.gl_get_attribute(pygame.GL_CONTEXT_PROFILE_MASK)
+        )
+        get_values.append(
+            pygame.display.gl_get_attribute(pygame.GL_SHARE_WITH_CURRENT_CONTEXT)
+        )
+        get_values.append(
+            pygame.display.gl_get_attribute(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_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:
+
+        # 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(pygame.GL_ALPHA_SIZE, set_values[0])
+        pygame.display.gl_set_attribute(pygame.GL_DEPTH_SIZE, set_values[1])
+        pygame.display.gl_set_attribute(pygame.GL_STENCIL_SIZE, set_values[2])
+        pygame.display.gl_set_attribute(pygame.GL_ACCUM_RED_SIZE, set_values[3])
+        pygame.display.gl_set_attribute(pygame.GL_ACCUM_GREEN_SIZE, set_values[4])
+        pygame.display.gl_set_attribute(pygame.GL_ACCUM_BLUE_SIZE, set_values[5])
+        pygame.display.gl_set_attribute(pygame.GL_ACCUM_ALPHA_SIZE, set_values[6])
+        pygame.display.gl_set_attribute(pygame.GL_MULTISAMPLEBUFFERS, set_values[7])
+        pygame.display.gl_set_attribute(pygame.GL_MULTISAMPLESAMPLES, set_values[8])
+        pygame.display.gl_set_attribute(pygame.GL_STEREO, 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(pygame.GL_ALPHA_SIZE))
+        get_values.append(pygame.display.gl_get_attribute(pygame.GL_DEPTH_SIZE))
+        get_values.append(pygame.display.gl_get_attribute(pygame.GL_STENCIL_SIZE))
+        get_values.append(pygame.display.gl_get_attribute(pygame.GL_ACCUM_RED_SIZE))
+        get_values.append(pygame.display.gl_get_attribute(pygame.GL_ACCUM_GREEN_SIZE))
+        get_values.append(pygame.display.gl_get_attribute(pygame.GL_ACCUM_BLUE_SIZE))
+        get_values.append(pygame.display.gl_get_attribute(pygame.GL_ACCUM_ALPHA_SIZE))
+        get_values.append(pygame.display.gl_get_attribute(pygame.GL_MULTISAMPLEBUFFERS))
+        get_values.append(pygame.display.gl_get_attribute(pygame.GL_MULTISAMPLESAMPLES))
+        get_values.append(pygame.display.gl_get_attribute(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(
+        (
+            "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",
+    )
+    def test_iconify(self):
+        pygame.display.set_mode((640, 480))
+
+        self.assertEqual(pygame.display.get_active(), True)
+
+        success = pygame.display.iconify()
+
+        if success:
+            active_event = window_minimized_event = False
+            # make sure we cycle the event loop enough to get the display
+            # hidden. Test that both ACTIVEEVENT and WINDOWMINIMISED event appears
+            for _ in range(50):
+                time.sleep(0.01)
+                for event in pygame.event.get():
+                    if event.type == pygame.ACTIVEEVENT:
+                        if not event.gain and event.state == pygame.APPACTIVE:
+                            active_event = True
+                    if event.type == pygame.WINDOWMINIMIZED:
+                        window_minimized_event = True
+
+            self.assertTrue(window_minimized_event)
+            self.assertTrue(active_event)
+            self.assertFalse(pygame.display.get_active())
+
+        else:
+            self.fail("Iconify not supported on this platform, please skip")
+
+    def test_init(self):
+        """Ensures the module is initialized after init called."""
+        # display.init() already called in setUp(), so quit and re-init
+        display.quit()
+        display.init()
+
+        self.assertTrue(display.get_init())
+
+    def test_init__multiple(self):
+        """Ensures the module is initialized after multiple init calls."""
+        display.init()
+        display.init()
+
+        self.assertTrue(display.get_init())
+
+    def test_list_modes(self):
+        modes = pygame.display.list_modes(depth=0, flags=pygame.FULLSCREEN, display=0)
+        # modes == -1 means any mode is supported.
+        if modes != -1:
+            self.assertEqual(len(modes[0]), 2)
+            self.assertEqual(type(modes[0][0]), int)
+
+        modes = pygame.display.list_modes()
+        if modes != -1:
+            self.assertEqual(len(modes[0]), 2)
+            self.assertEqual(type(modes[0][0]), int)
+            self.assertEqual(len(modes), len(set(modes)))
+
+        modes = pygame.display.list_modes(depth=0, flags=0, display=0)
+        if modes != -1:
+            self.assertEqual(len(modes[0]), 2)
+            self.assertEqual(type(modes[0][0]), int)
+
+    def test_mode_ok(self):
+        pygame.display.mode_ok((128, 128))
+        modes = pygame.display.list_modes()
+        if modes != -1:
+            size = modes[0]
+            self.assertNotEqual(pygame.display.mode_ok(size), 0)
+
+        pygame.display.mode_ok((128, 128), 0, 32)
+        pygame.display.mode_ok((128, 128), flags=0, depth=32, display=0)
+
+    def test_mode_ok_fullscreen(self):
+        modes = pygame.display.list_modes()
+        if modes != -1:
+            size = modes[0]
+            self.assertNotEqual(
+                pygame.display.mode_ok(size, flags=pygame.FULLSCREEN), 0
+            )
+
+    def test_mode_ok_scaled(self):
+        modes = pygame.display.list_modes()
+        if modes != -1:
+            size = modes[0]
+            self.assertNotEqual(pygame.display.mode_ok(size, flags=pygame.SCALED), 0)
+
+    def test_get_num_displays(self):
+        self.assertGreater(pygame.display.get_num_displays(), 0)
+
+    def test_quit(self):
+        """Ensures the module is not initialized after quit called."""
+        display.quit()
+
+        self.assertFalse(display.get_init())
+
+    def test_quit__multiple(self):
+        """Ensures the module is not initialized after multiple quit calls."""
+        display.quit()
+        display.quit()
+
+        self.assertFalse(display.get_init())
+
+    @unittest.skipIf(
+        os.environ.get("SDL_VIDEODRIVER") == "dummy", "Needs a not dummy videodriver"
+    )
+    def test_set_gamma(self):
+        pygame.display.set_mode((1, 1))
+
+        gammas = [0.25, 0.5, 0.88, 1.0]
+        for gamma in gammas:
+            with self.subTest(gamma=gamma):
+                with self.assertWarns(DeprecationWarning):
+                    self.assertEqual(pygame.display.set_gamma(gamma), True)
+                self.assertEqual(pygame.display.set_gamma(gamma), True)
+
+    @unittest.skipIf(
+        os.environ.get("SDL_VIDEODRIVER") == "dummy", "Needs a not dummy videodriver"
+    )
+    def test_set_gamma__tuple(self):
+        pygame.display.set_mode((1, 1))
+
+        gammas = [(0.5, 0.5, 0.5), (1.0, 1.0, 1.0), (0.25, 0.33, 0.44)]
+        for r, g, b in gammas:
+            with self.subTest(r=r, g=g, b=b):
+                self.assertEqual(pygame.display.set_gamma(r, g, b), True)
+
+    @unittest.skipIf(
+        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:
+
+        # change the hardware gamma ramps with a custom lookup
+        # pygame.display.set_gamma_ramp(red, green, blue): return bool
+        # set_gamma_ramp(red, green, blue): return bool
+        #
+        # 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.
+        #
+        pygame.display.set_mode((5, 5))
+        r = list(range(256))
+        g = [number + 256 for number in r]
+        b = [number + 256 for number in g]
+        with self.assertWarns(DeprecationWarning):
+            isSupported = pygame.display.set_gamma_ramp(r, g, b)
+        if isSupported:
+            self.assertTrue(pygame.display.set_gamma_ramp(r, g, b))
+        else:
+            self.assertFalse(pygame.display.set_gamma_ramp(r, g, b))
+
+    def test_set_mode_kwargs(self):
+        pygame.display.set_mode(size=(1, 1), flags=0, depth=0, display=0)
+
+    def test_set_mode_scaled(self):
+        surf = pygame.display.set_mode(
+            size=(1, 1), flags=pygame.SCALED, depth=0, display=0
+        )
+        winsize = pygame.display.get_window_size()
+        self.assertEqual(
+            winsize[0] % surf.get_size()[0],
+            0,
+            "window width should be a multiple of the surface width",
+        )
+        self.assertEqual(
+            winsize[1] % surf.get_size()[1],
+            0,
+            "window height should be a multiple of the surface height",
+        )
+        self.assertEqual(
+            winsize[0] / surf.get_size()[0], winsize[1] / surf.get_size()[1]
+        )
+
+    def test_set_mode_vector2(self):
+        pygame.display.set_mode(pygame.Vector2(1, 1))
+
+    def test_set_mode_unscaled(self):
+        """Ensures a window created with SCALED can become smaller."""
+        # see https://github.com/pygame/pygame/issues/2327
+
+        screen = pygame.display.set_mode((300, 300), pygame.SCALED)
+        self.assertEqual(screen.get_size(), (300, 300))
+
+        screen = pygame.display.set_mode((200, 200))
+        self.assertEqual(screen.get_size(), (200, 200))
+
+    def test_screensaver_support(self):
+        pygame.display.set_allow_screensaver(True)
+        self.assertTrue(pygame.display.get_allow_screensaver())
+        pygame.display.set_allow_screensaver(False)
+        self.assertFalse(pygame.display.get_allow_screensaver())
+        pygame.display.set_allow_screensaver()
+        self.assertTrue(pygame.display.get_allow_screensaver())
+
+    # the following test fails always with SDL2
+    @unittest.skipIf(True, "set_palette() not supported in SDL2")
+    def test_set_palette(self):
+        with self.assertRaises(pygame.error):
+            palette = [1, 2, 3]
+            pygame.display.set_palette(palette)
+        pygame.display.set_mode((1024, 768), 0, 8)
+        palette = []
+        self.assertIsNone(pygame.display.set_palette(palette))
+
+        with self.assertRaises(ValueError):
+            palette = 12
+            pygame.display.set_palette(palette)
+        with self.assertRaises(TypeError):
+            palette = [[1, 2], [1, 2]]
+            pygame.display.set_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)
+        with self.assertRaises(TypeError):
+            palette = "qwerty"
+            pygame.display.set_palette(palette)
+        with self.assertRaises(TypeError):
+            palette = [[123, 123, 123] * 10000]
+            pygame.display.set_palette(palette)
+        with self.assertRaises(TypeError):
+            palette = [1, 2, 3]
+            pygame.display.set_palette(palette)
+
+    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 dummy",
+    )
+    def test_toggle_fullscreen(self):
+        """Test for toggle fullscreen"""
+
+        # try to toggle fullscreen with no active display
+        # this should result in an error
+        pygame.display.quit()
+        with self.assertRaises(pygame.error):
+            pygame.display.toggle_fullscreen()
+
+        pygame.display.init()
+        width_height = (640, 480)
+        test_surf = pygame.display.set_mode(width_height)
+
+        # try to toggle fullscreen
+        try:
+            pygame.display.toggle_fullscreen()
+
+        except pygame.error:
+            self.fail()
+
+        else:
+            # if toggle success, the width/height should be a
+            # value found in list_modes
+            if pygame.display.toggle_fullscreen() == 1:
+                boolean = (
+                    test_surf.get_width(),
+                    test_surf.get_height(),
+                ) in pygame.display.list_modes(
+                    depth=0, flags=pygame.FULLSCREEN, display=0
+                )
+
+                self.assertEqual(boolean, True)
+
+            # if not original width/height should be preserved
+            else:
+                self.assertEqual(
+                    (test_surf.get_width(), test_surf.get_height()), width_height
+                )
+
+
+class DisplayUpdateTest(unittest.TestCase):
+    def question(self, qstr):
+        """this is used in the interactive subclass."""
+
+    def setUp(self):
+        display.init()
+        self.screen = pygame.display.set_mode((500, 500))
+        self.screen.fill("black")
+        pygame.display.flip()
+        pygame.event.pump()  # so mac updates
+
+    def tearDown(self):
+        display.quit()
+
+    def test_update_negative(self):
+        """takes rects with negative values."""
+        self.screen.fill("green")
+
+        r1 = pygame.Rect(0, 0, 100, 100)
+        pygame.display.update(r1)
+
+        r2 = pygame.Rect(-10, 0, 100, 100)
+        pygame.display.update(r2)
+
+        r3 = pygame.Rect(-10, 0, -100, -100)
+        pygame.display.update(r3)
+
+        self.question("Is the screen green in (0, 0, 100, 100)?")
+
+    def test_update_sequence(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),
+        ]
+        pygame.display.update(rects)
+        pygame.event.pump()  # so mac updates
+
+        self.question(f"Is the screen green in {rects}?")
+
+    def test_update_none_skipped(self):
+        """None is skipped inside sequences."""
+        self.screen.fill("green")
+        rects = (
+            None,
+            pygame.Rect(100, 0, 100, 100),
+            None,
+            pygame.Rect(200, 0, 100, 100),
+            pygame.Rect(300, 300, 100, 100),
+        )
+        pygame.display.update(rects)
+        pygame.event.pump()  # so mac updates
+
+        self.question(f"Is the screen green in {rects}?")
+
+    def test_update_none(self):
+        """does NOT update the display."""
+        self.screen.fill("green")
+        pygame.display.update(None)
+        pygame.event.pump()  # so mac updates
+        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
+        self.question("Is the WHOLE screen green?")
+
+    def test_update_args(self):
+        """updates the display using the args as a rect."""
+        self.screen.fill("green")
+        pygame.display.update(100, 100, 100, 100)
+        pygame.event.pump()  # so mac updates
+        self.question("Is the screen green in (100, 100, 100, 100)?")
+
+    def test_update_incorrect_args(self):
+        """raises a ValueError when inputs are wrong."""
+
+        with self.assertRaises(ValueError):
+            pygame.display.update(100, "asdf", 100, 100)
+
+        with self.assertRaises(ValueError):
+            pygame.display.update([100, "asdf", 100, 100])
+
+    def test_update_no_init(self):
+        """raises a pygame.error."""
+
+        pygame.display.quit()
+        with self.assertRaises(pygame.error):
+            pygame.display.update()
+
+
+class DisplayUpdateInteractiveTest(DisplayUpdateTest):
+    """Because we want these tests to run as interactive and not interactive."""
+
+    __tags__ = ["interactive"]
+
+    def question(self, qstr):
+        """since this is the interactive subclass we ask a question."""
+        question(qstr)
+
+
+class DisplayInteractiveTest(unittest.TestCase):
+    __tags__ = ["interactive"]
+
+    def test_set_icon_interactive(self):
+        os.environ["SDL_VIDEO_WINDOW_POS"] = "100,250"
+        pygame.display.quit()
+        pygame.display.init()
+
+        test_icon = pygame.Surface((32, 32))
+        test_icon.fill((255, 0, 0))
+
+        pygame.display.set_icon(test_icon)
+        screen = pygame.display.set_mode((400, 100))
+        pygame.display.set_caption("Is the window icon a red square?")
+
+        response = question("Is the display icon red square?")
+
+        self.assertTrue(response)
+        pygame.display.quit()
+
+    def test_set_gamma_ramp(self):
+        os.environ["SDL_VIDEO_WINDOW_POS"] = "100,250"
+        pygame.display.quit()
+        pygame.display.init()
+
+        screen = pygame.display.set_mode((400, 100))
+        screen.fill((100, 100, 100))
+
+        blue_ramp = [x * 256 for x in range(0, 256)]
+        blue_ramp[100] = 150 * 256  # Can't tint too far or gamma ramps fail
+        normal_ramp = [x * 256 for x in range(0, 256)]
+        # test to see if this platform supports gamma ramps
+        gamma_success = False
+        if pygame.display.set_gamma_ramp(normal_ramp, normal_ramp, blue_ramp):
+            pygame.display.update()
+            gamma_success = True
+
+        if gamma_success:
+            response = question("Is the window background tinted blue?")
+            self.assertTrue(response)
+            # restore normal ramp
+            pygame.display.set_gamma_ramp(normal_ramp, normal_ramp, normal_ramp)
+
+        pygame.display.quit()
+
+
+class FullscreenToggleTests(unittest.TestCase):
+    __tags__ = ["interactive"]
+
+    screen = None
+    font = None
+    isfullscreen = False
+
+    WIDTH = 800
+    HEIGHT = 600
+
+    def setUp(self):
+        pygame.init()
+        if sys.platform == "win32":
+            # known issue with windows, must have mode from pygame.display.list_modes()
+            # or window created with flag pygame.SCALED
+            self.screen = pygame.display.set_mode(
+                (self.WIDTH, self.HEIGHT), flags=pygame.SCALED
+            )
+        else:
+            self.screen = pygame.display.set_mode((self.WIDTH, self.HEIGHT))
+        pygame.display.set_caption("Fullscreen Tests")
+        self.screen.fill((255, 255, 255))
+        pygame.display.flip()
+        self.font = pygame.font.Font(None, 32)
+
+    def tearDown(self):
+        if self.isfullscreen:
+            pygame.display.toggle_fullscreen()
+        pygame.quit()
+
+    def visual_test(self, fullscreen=False):
+        text = ""
+        if fullscreen:
+            if not self.isfullscreen:
+                pygame.display.toggle_fullscreen()
+                self.isfullscreen = True
+            text = "Is this in fullscreen? [y/n]"
+        else:
+            if self.isfullscreen:
+                pygame.display.toggle_fullscreen()
+                self.isfullscreen = False
+            text = "Is this not in fullscreen [y/n]"
+        s = self.font.render(text, False, (0, 0, 0))
+        self.screen.blit(s, (self.WIDTH / 2 - self.font.size(text)[0] / 2, 100))
+        pygame.display.flip()
+
+        while True:
+            for event in pygame.event.get():
+                if event.type == pygame.KEYDOWN:
+                    if event.key == pygame.K_ESCAPE:
+                        return False
+                    if event.key == pygame.K_y:
+                        return True
+                    if event.key == pygame.K_n:
+                        return False
+                if event.type == pygame.QUIT:
+                    return False
+
+    def test_fullscreen_true(self):
+        self.assertTrue(self.visual_test(fullscreen=True))
+
+    def test_fullscreen_false(self):
+        self.assertTrue(self.visual_test(fullscreen=False))
+
+
+@unittest.skipIf(
+    os.environ.get("SDL_VIDEODRIVER") == "dummy",
+    'OpenGL requires a non-"dummy" SDL_VIDEODRIVER',
+)
+class DisplayOpenGLTest(unittest.TestCase):
+    def test_screen_size_opengl(self):
+        """returns a surface with the same size requested.
+        |tags:display,slow,opengl|
+        """
+        pygame.display.init()
+        screen = pygame.display.set_mode((640, 480), pygame.OPENGL)
+        self.assertEqual((640, 480), screen.get_size())
+
+
+class X11CrashTest(unittest.TestCase):
+    def test_x11_set_mode_crash_gh1654(self):
+        # Test for https://github.com/pygame/pygame/issues/1654
+        # If unfixed, this will trip a segmentation fault
+        pygame.display.init()
+        pygame.display.quit()
+        screen = pygame.display.set_mode((640, 480), 0)
+        self.assertEqual((640, 480), screen.get_size())
+
+
+if __name__ == "__main__":
+    unittest.main()
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/docs_test.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/docs_test.py
new file mode 100644
index 0000000..de021a8
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/docs_test.py
@@ -0,0 +1,35 @@
+import os
+import subprocess
+import sys
+import unittest
+
+
+class DocsIncludedTest(unittest.TestCase):
+    def test_doc_import_works(self):
+        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.__main__ import has_local_docs
+
+        self.assertTrue(has_local_docs())
+
+    @unittest.skipIf("CI" not in os.environ, "Docs not required for local builds")
+    def test_docs_command(self):
+        try:
+            subprocess.run(
+                [sys.executable, "-m", "pygame.docs"],
+                timeout=5,
+                # check ensures an exception is raised when the process fails
+                check=True,
+                # pipe stdout/stderr so that they don't clutter main stdout
+                stdout=subprocess.PIPE,
+                stderr=subprocess.PIPE,
+            )
+        except subprocess.TimeoutExpired:
+            # timeout errors are not an issue
+            pass
+
+
+if __name__ == "__main__":
+    unittest.main()
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/draw_test.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/draw_test.py
new file mode 100644
index 0000000..a33f864
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/draw_test.py
@@ -0,0 +1,6577 @@
+import math
+import unittest
+import sys
+import warnings
+
+import pygame
+from pygame import draw
+from pygame import draw_py
+from pygame.locals import SRCALPHA
+from pygame.tests import test_utils
+from pygame.math import Vector2
+
+
+RED = BG_RED = pygame.Color("red")
+GREEN = FG_GREEN = pygame.Color("green")
+
+# Clockwise from the top left corner and ending with the center point.
+RECT_POSITION_ATTRIBUTES = (
+    "topleft",
+    "midtop",
+    "topright",
+    "midright",
+    "bottomright",
+    "midbottom",
+    "bottomleft",
+    "midleft",
+    "center",
+)
+
+
+def get_border_values(surface, width, height):
+    """Returns a list containing lists with the values of the surface's
+    borders.
+    """
+    border_top = [surface.get_at((x, 0)) for x in range(width)]
+    border_left = [surface.get_at((0, y)) for y in range(height)]
+    border_right = [surface.get_at((width - 1, y)) for y in range(height)]
+    border_bottom = [surface.get_at((x, height - 1)) for x in range(width)]
+
+    return [border_top, border_left, border_right, border_bottom]
+
+
+def corners(surface):
+    """Returns a tuple with the corner positions of the given surface.
+
+    Clockwise from the top left corner.
+    """
+    width, height = surface.get_size()
+    return ((0, 0), (width - 1, 0), (width - 1, height - 1), (0, height - 1))
+
+
+def rect_corners_mids_and_center(rect):
+    """Returns a tuple with each corner, mid, and the center for a given rect.
+
+    Clockwise from the top left corner and ending with the center point.
+    """
+    return (
+        rect.topleft,
+        rect.midtop,
+        rect.topright,
+        rect.midright,
+        rect.bottomright,
+        rect.midbottom,
+        rect.bottomleft,
+        rect.midleft,
+        rect.center,
+    )
+
+
+def border_pos_and_color(surface):
+    """Yields each border position and its color for a given surface.
+
+    Clockwise from the top left corner.
+    """
+    width, height = surface.get_size()
+    right, bottom = width - 1, height - 1
+
+    # Top edge.
+    for x in range(width):
+        pos = (x, 0)
+        yield pos, surface.get_at(pos)
+
+    # Right edge.
+    # Top right done in top edge loop.
+    for y in range(1, height):
+        pos = (right, y)
+        yield pos, surface.get_at(pos)
+
+    # Bottom edge.
+    # Bottom right done in right edge loop.
+    for x in range(right - 1, -1, -1):
+        pos = (x, bottom)
+        yield pos, surface.get_at(pos)
+
+    # Left edge.
+    # Bottom left done in bottom edge loop. Top left done in top edge loop.
+    for y in range(bottom - 1, 0, -1):
+        pos = (0, y)
+        yield pos, surface.get_at(pos)
+
+
+def get_color_points(surface, color, bounds_rect=None, match_color=True):
+    """Get all the points of a given color on the surface within the given
+    bounds.
+
+    If bounds_rect is None the full surface is checked.
+    If match_color is True, all points matching the color are returned,
+        otherwise all points not matching the color are returned.
+    """
+    get_at = surface.get_at  # For possible speed up.
+
+    if bounds_rect is None:
+        x_range = range(surface.get_width())
+        y_range = range(surface.get_height())
+    else:
+        x_range = range(bounds_rect.left, bounds_rect.right)
+        y_range = range(bounds_rect.top, bounds_rect.bottom)
+
+    surface.lock()  # For possible speed up.
+
+    if match_color:
+        pts = [(x, y) for x in x_range for y in y_range if get_at((x, y)) == color]
+    else:
+        pts = [(x, y) for x in x_range for y in y_range if get_at((x, y)) != color]
+
+    surface.unlock()
+    return pts
+
+
+def create_bounding_rect(surface, surf_color, default_pos):
+    """Create a rect to bound all the pixels that don't match surf_color.
+
+    The default_pos parameter is used to position the bounding rect for the
+    case where all pixels match the surf_color.
+    """
+    width, height = surface.get_clip().size
+    xmin, ymin = width, height
+    xmax, ymax = -1, -1
+    get_at = surface.get_at  # For possible speed up.
+
+    surface.lock()  # For possible speed up.
+
+    for y in range(height):
+        for x in range(width):
+            if get_at((x, y)) != surf_color:
+                xmin = min(x, xmin)
+                xmax = max(x, xmax)
+                ymin = min(y, ymin)
+                ymax = max(y, ymax)
+
+    surface.unlock()
+
+    if -1 == xmax:
+        # 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))
+
+
+class InvalidBool:
+    """To help test invalid bool values."""
+
+    __bool__ = None
+
+
+class DrawTestCase(unittest.TestCase):
+    """Base class to test draw module functions."""
+
+    draw_rect = staticmethod(draw.rect)
+    draw_polygon = staticmethod(draw.polygon)
+    draw_circle = staticmethod(draw.circle)
+    draw_ellipse = staticmethod(draw.ellipse)
+    draw_arc = staticmethod(draw.arc)
+    draw_line = staticmethod(draw.line)
+    draw_lines = staticmethod(draw.lines)
+    draw_aaline = staticmethod(draw.aaline)
+    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 ###########################################################
+
+
+class DrawEllipseMixin:
+    """Mixin tests for drawing ellipses.
+
+    This class contains all the general ellipse drawing tests.
+    """
+
+    def test_ellipse__args(self):
+        """Ensures draw ellipse accepts the correct args."""
+        bounds_rect = self.draw_ellipse(
+            pygame.Surface((3, 3)), (0, 10, 0, 50), pygame.Rect((0, 0), (3, 2)), 1
+        )
+
+        self.assertIsInstance(bounds_rect, pygame.Rect)
+
+    def test_ellipse__args_without_width(self):
+        """Ensures draw ellipse accepts the args without a width."""
+        bounds_rect = self.draw_ellipse(
+            pygame.Surface((2, 2)), (1, 1, 1, 99), pygame.Rect((1, 1), (1, 1))
+        )
+
+        self.assertIsInstance(bounds_rect, pygame.Rect)
+
+    def test_ellipse__args_with_negative_width(self):
+        """Ensures draw ellipse accepts the args with negative width."""
+        bounds_rect = self.draw_ellipse(
+            pygame.Surface((3, 3)), (0, 10, 0, 50), pygame.Rect((2, 3), (3, 2)), -1
+        )
+
+        self.assertIsInstance(bounds_rect, pygame.Rect)
+        self.assertEqual(bounds_rect, pygame.Rect(2, 3, 0, 0))
+
+    def test_ellipse__args_with_width_gt_radius(self):
+        """Ensures draw ellipse accepts the args with
+        width > rect.w // 2 and width > rect.h // 2.
+        """
+        rect = pygame.Rect((0, 0), (4, 4))
+        bounds_rect = self.draw_ellipse(
+            pygame.Surface((3, 3)), (0, 10, 0, 50), rect, rect.w // 2 + 1
+        )
+
+        self.assertIsInstance(bounds_rect, pygame.Rect)
+
+        bounds_rect = self.draw_ellipse(
+            pygame.Surface((3, 3)), (0, 10, 0, 50), rect, rect.h // 2 + 1
+        )
+
+        self.assertIsInstance(bounds_rect, pygame.Rect)
+
+    def test_ellipse__kwargs(self):
+        """Ensures draw ellipse accepts the correct kwargs
+        with and without a width arg.
+        """
+        kwargs_list = [
+            {
+                "surface": pygame.Surface((4, 4)),
+                "color": pygame.Color("yellow"),
+                "rect": pygame.Rect((0, 0), (3, 2)),
+                "width": 1,
+            },
+            {
+                "surface": pygame.Surface((2, 1)),
+                "color": (0, 10, 20),
+                "rect": (0, 0, 1, 1),
+            },
+        ]
+
+        for kwargs in kwargs_list:
+            bounds_rect = self.draw_ellipse(**kwargs)
+
+            self.assertIsInstance(bounds_rect, pygame.Rect)
+
+    def test_ellipse__kwargs_order_independent(self):
+        """Ensures draw ellipse's kwargs are not order dependent."""
+        bounds_rect = self.draw_ellipse(
+            color=(1, 2, 3),
+            surface=pygame.Surface((3, 2)),
+            width=0,
+            rect=pygame.Rect((1, 0), (1, 1)),
+        )
+
+        self.assertIsInstance(bounds_rect, pygame.Rect)
+
+    def test_ellipse__args_missing(self):
+        """Ensures draw ellipse detects any missing required args."""
+        surface = pygame.Surface((1, 1))
+
+        with self.assertRaises(TypeError):
+            bounds_rect = self.draw_ellipse(surface, pygame.Color("red"))
+
+        with self.assertRaises(TypeError):
+            bounds_rect = self.draw_ellipse(surface)
+
+        with self.assertRaises(TypeError):
+            bounds_rect = self.draw_ellipse()
+
+    def test_ellipse__kwargs_missing(self):
+        """Ensures draw ellipse detects any missing required kwargs."""
+        kwargs = {
+            "surface": pygame.Surface((1, 2)),
+            "color": pygame.Color("red"),
+            "rect": pygame.Rect((1, 0), (2, 2)),
+            "width": 2,
+        }
+
+        for name in ("rect", "color", "surface"):
+            invalid_kwargs = dict(kwargs)
+            invalid_kwargs.pop(name)  # Pop from a copy.
+
+            with self.assertRaises(TypeError):
+                bounds_rect = self.draw_ellipse(**invalid_kwargs)
+
+    def test_ellipse__arg_invalid_types(self):
+        """Ensures draw ellipse detects invalid arg types."""
+        surface = pygame.Surface((2, 2))
+        color = pygame.Color("blue")
+        rect = pygame.Rect((1, 1), (1, 1))
+
+        with self.assertRaises(TypeError):
+            # Invalid width.
+            bounds_rect = self.draw_ellipse(surface, color, rect, "1")
+
+        with self.assertRaises(TypeError):
+            # Invalid rect.
+            bounds_rect = self.draw_ellipse(surface, color, (1, 2, 3, 4, 5), 1)
+
+        with self.assertRaises(TypeError):
+            # Invalid color.
+            bounds_rect = self.draw_ellipse(surface, 2.3, rect, 0)
+
+        with self.assertRaises(TypeError):
+            # Invalid surface.
+            bounds_rect = self.draw_ellipse(rect, color, rect, 2)
+
+    def test_ellipse__kwarg_invalid_types(self):
+        """Ensures draw ellipse detects invalid kwarg types."""
+        surface = pygame.Surface((3, 3))
+        color = pygame.Color("green")
+        rect = pygame.Rect((0, 1), (1, 1))
+        kwargs_list = [
+            {
+                "surface": pygame.Surface,  # Invalid surface.
+                "color": color,
+                "rect": rect,
+                "width": 1,
+            },
+            {
+                "surface": surface,
+                "color": 2.3,  # Invalid color.
+                "rect": rect,
+                "width": 1,
+            },
+            {
+                "surface": surface,
+                "color": color,
+                "rect": (0, 0, 0),  # Invalid rect.
+                "width": 1,
+            },
+            {"surface": surface, "color": color, "rect": rect, "width": 1.1},
+        ]  # Invalid width.
+
+        for kwargs in kwargs_list:
+            with self.assertRaises(TypeError):
+                bounds_rect = self.draw_ellipse(**kwargs)
+
+    def test_ellipse__kwarg_invalid_name(self):
+        """Ensures draw ellipse detects invalid kwarg names."""
+        surface = pygame.Surface((2, 3))
+        color = pygame.Color("cyan")
+        rect = pygame.Rect((0, 1), (2, 2))
+        kwargs_list = [
+            {
+                "surface": surface,
+                "color": color,
+                "rect": rect,
+                "width": 1,
+                "invalid": 1,
+            },
+            {"surface": surface, "color": color, "rect": rect, "invalid": 1},
+        ]
+
+        for kwargs in kwargs_list:
+            with self.assertRaises(TypeError):
+                bounds_rect = self.draw_ellipse(**kwargs)
+
+    def test_ellipse__args_and_kwargs(self):
+        """Ensures draw ellipse accepts a combination of args/kwargs"""
+        surface = pygame.Surface((3, 1))
+        color = (255, 255, 0, 0)
+        rect = pygame.Rect((1, 0), (2, 1))
+        width = 0
+        kwargs = {"surface": surface, "color": color, "rect": rect, "width": width}
+
+        for name in ("surface", "color", "rect", "width"):
+            kwargs.pop(name)
+
+            if "surface" == name:
+                bounds_rect = self.draw_ellipse(surface, **kwargs)
+            elif "color" == name:
+                bounds_rect = self.draw_ellipse(surface, color, **kwargs)
+            elif "rect" == name:
+                bounds_rect = self.draw_ellipse(surface, color, rect, **kwargs)
+            else:
+                bounds_rect = self.draw_ellipse(surface, color, rect, width, **kwargs)
+
+            self.assertIsInstance(bounds_rect, pygame.Rect)
+
+    def test_ellipse__valid_width_values(self):
+        """Ensures draw ellipse accepts different width values."""
+        pos = (1, 1)
+        surface_color = pygame.Color("white")
+        surface = pygame.Surface((3, 4))
+        color = (10, 20, 30, 255)
+        kwargs = {
+            "surface": surface,
+            "color": color,
+            "rect": pygame.Rect(pos, (3, 2)),
+            "width": None,
+        }
+
+        for width in (-1000, -10, -1, 0, 1, 10, 1000):
+            surface.fill(surface_color)  # Clear for each test.
+            kwargs["width"] = width
+            expected_color = color if width >= 0 else surface_color
+
+            bounds_rect = self.draw_ellipse(**kwargs)
+
+            self.assertEqual(surface.get_at(pos), expected_color)
+            self.assertIsInstance(bounds_rect, pygame.Rect)
+
+    def test_ellipse__valid_rect_formats(self):
+        """Ensures draw ellipse accepts different rect formats."""
+        pos = (1, 1)
+        expected_color = pygame.Color("red")
+        surface_color = pygame.Color("black")
+        surface = pygame.Surface((4, 4))
+        kwargs = {"surface": surface, "color": expected_color, "rect": None, "width": 0}
+        rects = (pygame.Rect(pos, (1, 3)), (pos, (2, 1)), (pos[0], pos[1], 1, 1))
+
+        for rect in rects:
+            surface.fill(surface_color)  # Clear for each test.
+            kwargs["rect"] = rect
+
+            bounds_rect = self.draw_ellipse(**kwargs)
+
+            self.assertEqual(surface.get_at(pos), expected_color)
+            self.assertIsInstance(bounds_rect, pygame.Rect)
+
+    def test_ellipse__valid_color_formats(self):
+        """Ensures draw ellipse accepts different color formats."""
+        pos = (1, 1)
+        green_color = pygame.Color("green")
+        surface_color = pygame.Color("black")
+        surface = pygame.Surface((3, 4))
+        kwargs = {
+            "surface": surface,
+            "color": None,
+            "rect": pygame.Rect(pos, (1, 2)),
+            "width": 0,
+        }
+        reds = (
+            (0, 255, 0),
+            (0, 255, 0, 255),
+            surface.map_rgb(green_color),
+            green_color,
+        )
+
+        for color in reds:
+            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_ellipse(**kwargs)
+
+            self.assertEqual(surface.get_at(pos), expected_color)
+            self.assertIsInstance(bounds_rect, pygame.Rect)
+
+    def test_ellipse__invalid_color_formats(self):
+        """Ensures draw ellipse handles invalid color formats correctly."""
+        pos = (1, 1)
+        surface = pygame.Surface((4, 3))
+        kwargs = {
+            "surface": surface,
+            "color": None,
+            "rect": pygame.Rect(pos, (2, 2)),
+            "width": 1,
+        }
+
+        for expected_color in (2.3, surface):
+            kwargs["color"] = expected_color
+
+            with self.assertRaises(TypeError):
+                bounds_rect = self.draw_ellipse(**kwargs)
+
+    def test_ellipse(self):
+        """Tests ellipses of differing sizes on surfaces of differing sizes.
+
+        Checks if the number of sides touching the border of the surface is
+        correct.
+        """
+        left_top = [(0, 0), (1, 0), (0, 1), (1, 1)]
+        sizes = [(4, 4), (5, 4), (4, 5), (5, 5)]
+        color = (1, 13, 24, 255)
+
+        def same_size(width, height, border_width):
+            """Test for ellipses with the same size as the surface."""
+            surface = pygame.Surface((width, height))
+
+            self.draw_ellipse(surface, color, (0, 0, width, height), border_width)
+
+            # For each of the four borders check if it contains the color
+            borders = get_border_values(surface, width, height)
+            for border in borders:
+                self.assertTrue(color in border)
+
+        def not_same_size(width, height, border_width, left, top):
+            """Test for ellipses that aren't the same size as the surface."""
+            surface = pygame.Surface((width, height))
+
+            self.draw_ellipse(
+                surface, color, (left, top, width - 1, height - 1), border_width
+            )
+
+            borders = get_border_values(surface, width, height)
+
+            # Check if two sides of the ellipse are touching the border
+            sides_touching = [color in border for border in borders].count(True)
+            self.assertEqual(sides_touching, 2)
+
+        for width, height in sizes:
+            for border_width in (0, 1):
+                same_size(width, height, border_width)
+                for left, top in left_top:
+                    not_same_size(width, height, border_width, left, top)
+
+    def test_ellipse__big_ellipse(self):
+        """Test for big ellipse that could overflow in algorithm"""
+        width = 1025
+        height = 1025
+        border = 1
+        x_value_test = int(0.4 * height)
+        y_value_test = int(0.4 * height)
+        surface = pygame.Surface((width, height))
+
+        self.draw_ellipse(surface, (255, 0, 0), (0, 0, width, height), border)
+        colored_pixels = 0
+        for y in range(height):
+            if surface.get_at((x_value_test, y)) == (255, 0, 0):
+                colored_pixels += 1
+        for x in range(width):
+            if surface.get_at((x, y_value_test)) == (255, 0, 0):
+                colored_pixels += 1
+        self.assertEqual(colored_pixels, border * 4)
+
+    def test_ellipse__thick_line(self):
+        """Ensures a thick lined ellipse is drawn correctly."""
+        ellipse_color = pygame.Color("yellow")
+        surface_color = pygame.Color("black")
+        surface = pygame.Surface((40, 40))
+        rect = pygame.Rect((0, 0), (31, 23))
+        rect.center = surface.get_rect().center
+
+        # As the lines get thicker the internals of the ellipse are not
+        # cleanly defined. So only test up to a few thicknesses before the
+        # maximum thickness.
+        for thickness in range(1, min(*rect.size) // 2 - 2):
+            surface.fill(surface_color)  # Clear for each test.
+
+            self.draw_ellipse(surface, ellipse_color, rect, thickness)
+
+            surface.lock()  # For possible speed up.
+
+            # Check vertical thickness on the ellipse's top.
+            x = rect.centerx
+            y_start = rect.top
+            y_end = rect.top + thickness - 1
+
+            for y in range(y_start, y_end + 1):
+                self.assertEqual(surface.get_at((x, y)), ellipse_color, thickness)
+
+            # Check pixels above and below this line.
+            self.assertEqual(surface.get_at((x, y_start - 1)), surface_color, thickness)
+            self.assertEqual(surface.get_at((x, y_end + 1)), surface_color, thickness)
+
+            # Check vertical thickness on the ellipse's bottom.
+            x = rect.centerx
+            y_start = rect.bottom - thickness
+            y_end = rect.bottom - 1
+
+            for y in range(y_start, y_end + 1):
+                self.assertEqual(surface.get_at((x, y)), ellipse_color, thickness)
+
+            # Check pixels above and below this line.
+            self.assertEqual(surface.get_at((x, y_start - 1)), surface_color, thickness)
+            self.assertEqual(surface.get_at((x, y_end + 1)), surface_color, thickness)
+
+            # Check horizontal thickness on the ellipse's left.
+            x_start = rect.left
+            x_end = rect.left + thickness - 1
+            y = rect.centery
+
+            for x in range(x_start, x_end + 1):
+                self.assertEqual(surface.get_at((x, y)), ellipse_color, thickness)
+
+            # Check pixels to the left and right of this line.
+            self.assertEqual(surface.get_at((x_start - 1, y)), surface_color, thickness)
+            self.assertEqual(surface.get_at((x_end + 1, y)), surface_color, thickness)
+
+            # Check horizontal thickness on the ellipse's right.
+            x_start = rect.right - thickness
+            x_end = rect.right - 1
+            y = rect.centery
+
+            for x in range(x_start, x_end + 1):
+                self.assertEqual(surface.get_at((x, y)), ellipse_color, thickness)
+
+            # Check pixels to the left and right of this line.
+            self.assertEqual(surface.get_at((x_start - 1, y)), surface_color, thickness)
+            self.assertEqual(surface.get_at((x_end + 1, y)), surface_color, thickness)
+
+            surface.unlock()
+
+    def test_ellipse__no_holes(self):
+        width = 80
+        height = 70
+        surface = pygame.Surface((width + 1, height))
+        rect = pygame.Rect(0, 0, width, height)
+        for thickness in range(1, 37, 5):
+            surface.fill("BLACK")
+            self.draw_ellipse(surface, "RED", rect, thickness)
+            for y in range(height):
+                number_of_changes = 0
+                drawn_pixel = False
+                for x in range(width + 1):
+                    if (
+                        not drawn_pixel
+                        and surface.get_at((x, y)) == pygame.Color("RED")
+                        or drawn_pixel
+                        and surface.get_at((x, y)) == pygame.Color("BLACK")
+                    ):
+                        drawn_pixel = not drawn_pixel
+                        number_of_changes += 1
+                if y < thickness or y > height - thickness - 1:
+                    self.assertEqual(number_of_changes, 2)
+                else:
+                    self.assertEqual(number_of_changes, 4)
+
+    def test_ellipse__max_width(self):
+        """Ensures an ellipse with max width (and greater) is drawn correctly."""
+        ellipse_color = pygame.Color("yellow")
+        surface_color = pygame.Color("black")
+        surface = pygame.Surface((40, 40))
+        rect = pygame.Rect((0, 0), (31, 21))
+        rect.center = surface.get_rect().center
+        max_thickness = (min(*rect.size) + 1) // 2
+
+        for thickness in range(max_thickness, max_thickness + 3):
+            surface.fill(surface_color)  # Clear for each test.
+
+            self.draw_ellipse(surface, ellipse_color, rect, thickness)
+
+            surface.lock()  # For possible speed up.
+
+            # Check vertical thickness.
+            for y in range(rect.top, rect.bottom):
+                self.assertEqual(surface.get_at((rect.centerx, y)), ellipse_color)
+
+            # Check horizontal thickness.
+            for x in range(rect.left, rect.right):
+                self.assertEqual(surface.get_at((x, rect.centery)), ellipse_color)
+
+            # Check pixels above and below ellipse.
+            self.assertEqual(
+                surface.get_at((rect.centerx, rect.top - 1)), surface_color
+            )
+            self.assertEqual(
+                surface.get_at((rect.centerx, rect.bottom + 1)), surface_color
+            )
+
+            # Check pixels to the left and right of the ellipse.
+            self.assertEqual(
+                surface.get_at((rect.left - 1, rect.centery)), surface_color
+            )
+            self.assertEqual(
+                surface.get_at((rect.right + 1, rect.centery)), surface_color
+            )
+
+            surface.unlock()
+
+    def _check_1_pixel_sized_ellipse(
+        self, surface, collide_rect, surface_color, ellipse_color
+    ):
+        # Helper method to check the surface for 1 pixel wide and/or high
+        # ellipses.
+        surf_w, surf_h = surface.get_size()
+
+        surface.lock()  # For possible speed up.
+
+        for pos in ((x, y) for y in range(surf_h) for x in range(surf_w)):
+            # Since the ellipse is just a line we can use a rect to help find
+            # where it is expected to be drawn.
+            if collide_rect.collidepoint(pos):
+                expected_color = ellipse_color
+            else:
+                expected_color = surface_color
+
+            self.assertEqual(
+                surface.get_at(pos),
+                expected_color,
+                f"collide_rect={collide_rect}, pos={pos}",
+            )
+
+        surface.unlock()
+
+    def test_ellipse__1_pixel_width(self):
+        """Ensures an ellipse with a width of 1 is drawn correctly.
+
+        An ellipse with a width of 1 pixel is a vertical line.
+        """
+        ellipse_color = pygame.Color("red")
+        surface_color = pygame.Color("black")
+        surf_w, surf_h = 10, 20
+
+        surface = pygame.Surface((surf_w, surf_h))
+        rect = pygame.Rect((0, 0), (1, 0))
+        collide_rect = rect.copy()
+
+        # Calculate some positions.
+        off_left = -1
+        off_right = surf_w
+        off_bottom = surf_h
+        center_x = surf_w // 2
+        center_y = surf_h // 2
+
+        # Test some even and odd heights.
+        for ellipse_h in range(6, 10):
+            collide_rect.h = ellipse_h
+            rect.h = ellipse_h
+
+            # Calculate some variable positions.
+            off_top = -(ellipse_h + 1)
+            half_off_top = -(ellipse_h // 2)
+            half_off_bottom = surf_h - (ellipse_h // 2)
+
+            # Draw the ellipse in different positions: fully on-surface,
+            # partially off-surface, and fully off-surface.
+            positions = (
+                (off_left, off_top),
+                (off_left, half_off_top),
+                (off_left, center_y),
+                (off_left, half_off_bottom),
+                (off_left, off_bottom),
+                (center_x, off_top),
+                (center_x, half_off_top),
+                (center_x, center_y),
+                (center_x, half_off_bottom),
+                (center_x, off_bottom),
+                (off_right, off_top),
+                (off_right, half_off_top),
+                (off_right, center_y),
+                (off_right, half_off_bottom),
+                (off_right, off_bottom),
+            )
+
+            for rect_pos in positions:
+                surface.fill(surface_color)  # Clear before each draw.
+                rect.topleft = rect_pos
+                collide_rect.topleft = rect_pos
+
+                self.draw_ellipse(surface, ellipse_color, rect)
+
+                self._check_1_pixel_sized_ellipse(
+                    surface, collide_rect, surface_color, ellipse_color
+                )
+
+    def test_ellipse__1_pixel_width_spanning_surface(self):
+        """Ensures an ellipse with a width of 1 is drawn correctly
+        when spanning the height of the surface.
+
+        An ellipse with a width of 1 pixel is a vertical line.
+        """
+        ellipse_color = pygame.Color("red")
+        surface_color = pygame.Color("black")
+        surf_w, surf_h = 10, 20
+
+        surface = pygame.Surface((surf_w, surf_h))
+        rect = pygame.Rect((0, 0), (1, surf_h + 2))  # Longer than the surface.
+
+        # Draw the ellipse in different positions: on-surface and off-surface.
+        positions = (
+            (-1, -1),  # (off_left,   off_top)
+            (0, -1),  # (left_edge,  off_top)
+            (surf_w // 2, -1),  # (center_x,   off_top)
+            (surf_w - 1, -1),  # (right_edge, off_top)
+            (surf_w, -1),
+        )  # (off_right,  off_top)
+
+        for rect_pos in positions:
+            surface.fill(surface_color)  # Clear before each draw.
+            rect.topleft = rect_pos
+
+            self.draw_ellipse(surface, ellipse_color, rect)
+
+            self._check_1_pixel_sized_ellipse(
+                surface, rect, surface_color, ellipse_color
+            )
+
+    def test_ellipse__1_pixel_height(self):
+        """Ensures an ellipse with a height of 1 is drawn correctly.
+
+        An ellipse with a height of 1 pixel is a horizontal line.
+        """
+        ellipse_color = pygame.Color("red")
+        surface_color = pygame.Color("black")
+        surf_w, surf_h = 20, 10
+
+        surface = pygame.Surface((surf_w, surf_h))
+        rect = pygame.Rect((0, 0), (0, 1))
+        collide_rect = rect.copy()
+
+        # Calculate some positions.
+        off_right = surf_w
+        off_top = -1
+        off_bottom = surf_h
+        center_x = surf_w // 2
+        center_y = surf_h // 2
+
+        # Test some even and odd widths.
+        for ellipse_w in range(6, 10):
+            collide_rect.w = ellipse_w
+            rect.w = ellipse_w
+
+            # Calculate some variable positions.
+            off_left = -(ellipse_w + 1)
+            half_off_left = -(ellipse_w // 2)
+            half_off_right = surf_w - (ellipse_w // 2)
+
+            # Draw the ellipse in different positions: fully on-surface,
+            # partially off-surface, and fully off-surface.
+            positions = (
+                (off_left, off_top),
+                (half_off_left, off_top),
+                (center_x, off_top),
+                (half_off_right, off_top),
+                (off_right, off_top),
+                (off_left, center_y),
+                (half_off_left, center_y),
+                (center_x, center_y),
+                (half_off_right, center_y),
+                (off_right, center_y),
+                (off_left, off_bottom),
+                (half_off_left, off_bottom),
+                (center_x, off_bottom),
+                (half_off_right, off_bottom),
+                (off_right, off_bottom),
+            )
+
+            for rect_pos in positions:
+                surface.fill(surface_color)  # Clear before each draw.
+                rect.topleft = rect_pos
+                collide_rect.topleft = rect_pos
+
+                self.draw_ellipse(surface, ellipse_color, rect)
+
+                self._check_1_pixel_sized_ellipse(
+                    surface, collide_rect, surface_color, ellipse_color
+                )
+
+    def test_ellipse__1_pixel_height_spanning_surface(self):
+        """Ensures an ellipse with a height of 1 is drawn correctly
+        when spanning the width of the surface.
+
+        An ellipse with a height of 1 pixel is a horizontal line.
+        """
+        ellipse_color = pygame.Color("red")
+        surface_color = pygame.Color("black")
+        surf_w, surf_h = 20, 10
+
+        surface = pygame.Surface((surf_w, surf_h))
+        rect = pygame.Rect((0, 0), (surf_w + 2, 1))  # Wider than the surface.
+
+        # Draw the ellipse in different positions: on-surface and off-surface.
+        positions = (
+            (-1, -1),  # (off_left, off_top)
+            (-1, 0),  # (off_left, top_edge)
+            (-1, surf_h // 2),  # (off_left, center_y)
+            (-1, surf_h - 1),  # (off_left, bottom_edge)
+            (-1, surf_h),
+        )  # (off_left, off_bottom)
+
+        for rect_pos in positions:
+            surface.fill(surface_color)  # Clear before each draw.
+            rect.topleft = rect_pos
+
+            self.draw_ellipse(surface, ellipse_color, rect)
+
+            self._check_1_pixel_sized_ellipse(
+                surface, rect, surface_color, ellipse_color
+            )
+
+    def test_ellipse__1_pixel_width_and_height(self):
+        """Ensures an ellipse with a width and height of 1 is drawn correctly.
+
+        An ellipse with a width and height of 1 pixel is a single pixel.
+        """
+        ellipse_color = pygame.Color("red")
+        surface_color = pygame.Color("black")
+        surf_w, surf_h = 10, 10
+
+        surface = pygame.Surface((surf_w, surf_h))
+        rect = pygame.Rect((0, 0), (1, 1))
+
+        # Calculate some positions.
+        off_left = -1
+        off_right = surf_w
+        off_top = -1
+        off_bottom = surf_h
+        left_edge = 0
+        right_edge = surf_w - 1
+        top_edge = 0
+        bottom_edge = surf_h - 1
+        center_x = surf_w // 2
+        center_y = surf_h // 2
+
+        # Draw the ellipse in different positions: center surface,
+        # top/bottom/left/right edges, and off-surface.
+        positions = (
+            (off_left, off_top),
+            (off_left, top_edge),
+            (off_left, center_y),
+            (off_left, bottom_edge),
+            (off_left, off_bottom),
+            (left_edge, off_top),
+            (left_edge, top_edge),
+            (left_edge, center_y),
+            (left_edge, bottom_edge),
+            (left_edge, off_bottom),
+            (center_x, off_top),
+            (center_x, top_edge),
+            (center_x, center_y),
+            (center_x, bottom_edge),
+            (center_x, off_bottom),
+            (right_edge, off_top),
+            (right_edge, top_edge),
+            (right_edge, center_y),
+            (right_edge, bottom_edge),
+            (right_edge, off_bottom),
+            (off_right, off_top),
+            (off_right, top_edge),
+            (off_right, center_y),
+            (off_right, bottom_edge),
+            (off_right, off_bottom),
+        )
+
+        for rect_pos in positions:
+            surface.fill(surface_color)  # Clear before each draw.
+            rect.topleft = rect_pos
+
+            self.draw_ellipse(surface, ellipse_color, rect)
+
+            self._check_1_pixel_sized_ellipse(
+                surface, rect, surface_color, ellipse_color
+            )
+
+    def test_ellipse__bounding_rect(self):
+        """Ensures draw ellipse returns the correct bounding rect.
+
+        Tests ellipses on and off the surface and a range of width/thickness
+        values.
+        """
+        ellipse_color = pygame.Color("red")
+        surf_color = pygame.Color("black")
+        min_width = min_height = 5
+        max_width = max_height = 7
+        sizes = ((min_width, min_height), (max_width, max_height))
+        surface = pygame.Surface((20, 20), 0, 32)
+        surf_rect = surface.get_rect()
+        # Make a rect that is bigger than the surface to help test drawing
+        # ellipses off and partially off the surface.
+        big_rect = surf_rect.inflate(min_width * 2 + 1, min_height * 2 + 1)
+
+        for pos in rect_corners_mids_and_center(
+            surf_rect
+        ) + rect_corners_mids_and_center(big_rect):
+            # Each of the ellipse's rect position attributes will be set to
+            # the pos value.
+            for attr in RECT_POSITION_ATTRIBUTES:
+                # Test using different rect sizes and thickness values.
+                for width, height in sizes:
+                    ellipse_rect = pygame.Rect((0, 0), (width, height))
+                    setattr(ellipse_rect, attr, pos)
+
+                    for thickness in (0, 1, 2, 3, min(width, height)):
+                        surface.fill(surf_color)  # Clear for each test.
+
+                        bounding_rect = self.draw_ellipse(
+                            surface, ellipse_color, ellipse_rect, thickness
+                        )
+
+                        # Calculating the expected_rect after the ellipse
+                        # is drawn (it uses what is actually drawn).
+                        expected_rect = create_bounding_rect(
+                            surface, surf_color, ellipse_rect.topleft
+                        )
+
+                        self.assertEqual(bounding_rect, expected_rect)
+
+    def test_ellipse__surface_clip(self):
+        """Ensures draw ellipse respects a surface's clip area.
+
+        Tests drawing the ellipse filled and unfilled.
+        """
+        surfw = surfh = 30
+        ellipse_color = pygame.Color("red")
+        surface_color = pygame.Color("green")
+        surface = pygame.Surface((surfw, surfh))
+        surface.fill(surface_color)
+
+        clip_rect = pygame.Rect((0, 0), (11, 11))
+        clip_rect.center = surface.get_rect().center
+        pos_rect = clip_rect.copy()  # Manages the ellipse's pos.
+
+        for width in (0, 1):  # Filled and unfilled.
+            # Test centering the ellipse along the clip rect's edge.
+            for center in rect_corners_mids_and_center(clip_rect):
+                # Get the expected points by drawing the ellipse without the
+                # clip area set.
+                pos_rect.center = center
+                surface.set_clip(None)
+                surface.fill(surface_color)
+                self.draw_ellipse(surface, ellipse_color, pos_rect, width)
+                expected_pts = get_color_points(surface, ellipse_color, clip_rect)
+
+                # Clear the surface and set the clip area. Redraw the ellipse
+                # and check that only the clip area is modified.
+                surface.fill(surface_color)
+                surface.set_clip(clip_rect)
+
+                self.draw_ellipse(surface, ellipse_color, pos_rect, width)
+
+                surface.lock()  # For possible speed up.
+
+                # Check all the surface points to ensure only the expected_pts
+                # are the ellipse_color.
+                for pt in ((x, y) for x in range(surfw) for y in range(surfh)):
+                    if pt in expected_pts:
+                        expected_color = ellipse_color
+                    else:
+                        expected_color = surface_color
+
+                    self.assertEqual(surface.get_at(pt), expected_color, pt)
+
+                surface.unlock()
+
+
+class DrawEllipseTest(DrawEllipseMixin, DrawTestCase):
+    """Test draw module function ellipse.
+
+    This class inherits the general tests from DrawEllipseMixin. It is also
+    the class to add any draw.ellipse specific tests to.
+    """
+
+
+# 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 #########################################
+
+
+class BaseLineMixin:
+    """Mixin base for drawing various lines.
+
+    This class contains general helper methods and setup for testing the
+    different types of lines.
+    """
+
+    COLORS = (
+        (0, 0, 0),
+        (255, 0, 0),
+        (0, 255, 0),
+        (0, 0, 255),
+        (255, 255, 0),
+        (255, 0, 255),
+        (0, 255, 255),
+        (255, 255, 255),
+    )
+
+    @staticmethod
+    def _create_surfaces():
+        # Create some surfaces with different sizes, depths, and flags.
+        surfaces = []
+        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, depth)
+                    surfaces.append(surface)
+                    surfaces.append(surface.convert_alpha())
+        return surfaces
+
+    @staticmethod
+    def _rect_lines(rect):
+        # Yields pairs of end points and their reverse (to test symmetry).
+        # Uses a rect with the points radiating from its midleft.
+        for pt in rect_corners_mids_and_center(rect):
+            if pt in [rect.midleft, rect.center]:
+                # Don't bother with these points.
+                continue
+            yield (rect.midleft, pt)
+            yield (pt, rect.midleft)
+
+
+### Line Testing ##############################################################
+
+
+class LineMixin(BaseLineMixin):
+    """Mixin test for drawing a single line.
+
+    This class contains all the general single line drawing tests.
+    """
+
+    def test_line__args(self):
+        """Ensures draw line accepts the correct args."""
+        bounds_rect = self.draw_line(
+            pygame.Surface((3, 3)), (0, 10, 0, 50), (0, 0), (1, 1), 1
+        )
+
+        self.assertIsInstance(bounds_rect, pygame.Rect)
+
+    def test_line__args_without_width(self):
+        """Ensures draw line accepts the args without a width."""
+        bounds_rect = self.draw_line(
+            pygame.Surface((2, 2)), (0, 0, 0, 50), (0, 0), (2, 2)
+        )
+
+        self.assertIsInstance(bounds_rect, pygame.Rect)
+
+    def test_line__kwargs(self):
+        """Ensures draw line accepts the correct kwargs
+        with and without a width arg.
+        """
+        surface = pygame.Surface((4, 4))
+        color = pygame.Color("yellow")
+        start_pos = (1, 1)
+        end_pos = (2, 2)
+        kwargs_list = [
+            {
+                "surface": surface,
+                "color": color,
+                "start_pos": start_pos,
+                "end_pos": end_pos,
+                "width": 1,
+            },
+            {
+                "surface": surface,
+                "color": color,
+                "start_pos": start_pos,
+                "end_pos": end_pos,
+            },
+        ]
+
+        for kwargs in kwargs_list:
+            bounds_rect = self.draw_line(**kwargs)
+
+            self.assertIsInstance(bounds_rect, pygame.Rect)
+
+    def test_line__kwargs_order_independent(self):
+        """Ensures draw line's kwargs are not order dependent."""
+        bounds_rect = self.draw_line(
+            start_pos=(1, 2),
+            end_pos=(2, 1),
+            width=2,
+            color=(10, 20, 30),
+            surface=pygame.Surface((3, 2)),
+        )
+
+        self.assertIsInstance(bounds_rect, pygame.Rect)
+
+    def test_line__args_missing(self):
+        """Ensures draw line detects any missing required args."""
+        surface = pygame.Surface((1, 1))
+        color = pygame.Color("blue")
+
+        with self.assertRaises(TypeError):
+            bounds_rect = self.draw_line(surface, color, (0, 0))
+
+        with self.assertRaises(TypeError):
+            bounds_rect = self.draw_line(surface, color)
+
+        with self.assertRaises(TypeError):
+            bounds_rect = self.draw_line(surface)
+
+        with self.assertRaises(TypeError):
+            bounds_rect = self.draw_line()
+
+    def test_line__kwargs_missing(self):
+        """Ensures draw line detects any missing required kwargs."""
+        kwargs = {
+            "surface": pygame.Surface((3, 2)),
+            "color": pygame.Color("red"),
+            "start_pos": (2, 1),
+            "end_pos": (2, 2),
+            "width": 1,
+        }
+
+        for name in ("end_pos", "start_pos", "color", "surface"):
+            invalid_kwargs = dict(kwargs)
+            invalid_kwargs.pop(name)  # Pop from a copy.
+
+            with self.assertRaises(TypeError):
+                bounds_rect = self.draw_line(**invalid_kwargs)
+
+    def test_line__arg_invalid_types(self):
+        """Ensures draw line detects invalid arg types."""
+        surface = pygame.Surface((2, 2))
+        color = pygame.Color("blue")
+        start_pos = (0, 1)
+        end_pos = (1, 2)
+
+        with self.assertRaises(TypeError):
+            # Invalid width.
+            bounds_rect = self.draw_line(surface, color, start_pos, end_pos, "1")
+
+        with self.assertRaises(TypeError):
+            # Invalid end_pos.
+            bounds_rect = self.draw_line(surface, color, start_pos, (1, 2, 3))
+
+        with self.assertRaises(TypeError):
+            # Invalid start_pos.
+            bounds_rect = self.draw_line(surface, color, (1,), end_pos)
+
+        with self.assertRaises(TypeError):
+            # Invalid color.
+            bounds_rect = self.draw_line(surface, 2.3, start_pos, end_pos)
+
+        with self.assertRaises(TypeError):
+            # Invalid surface.
+            bounds_rect = self.draw_line((1, 2, 3, 4), color, start_pos, end_pos)
+
+    def test_line__kwarg_invalid_types(self):
+        """Ensures draw line detects invalid kwarg types."""
+        surface = pygame.Surface((3, 3))
+        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": end_pos,
+                "width": 1.2,
+            },
+        ]  # Invalid width.
+
+        for kwargs in kwargs_list:
+            with self.assertRaises(TypeError):
+                bounds_rect = self.draw_line(**kwargs)
+
+    def test_line__kwarg_invalid_name(self):
+        """Ensures draw line detects invalid kwarg names."""
+        surface = pygame.Surface((2, 3))
+        color = pygame.Color("cyan")
+        start_pos = (1, 1)
+        end_pos = (2, 0)
+        kwargs_list = [
+            {
+                "surface": surface,
+                "color": color,
+                "start_pos": start_pos,
+                "end_pos": end_pos,
+                "width": 1,
+                "invalid": 1,
+            },
+            {
+                "surface": surface,
+                "color": color,
+                "start_pos": start_pos,
+                "end_pos": end_pos,
+                "invalid": 1,
+            },
+        ]
+
+        for kwargs in kwargs_list:
+            with self.assertRaises(TypeError):
+                bounds_rect = self.draw_line(**kwargs)
+
+    def test_line__args_and_kwargs(self):
+        """Ensures draw line accepts a combination of args/kwargs"""
+        surface = pygame.Surface((3, 2))
+        color = (255, 255, 0, 0)
+        start_pos = (0, 1)
+        end_pos = (1, 2)
+        width = 0
+        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"):
+            kwargs.pop(name)
+
+            if "surface" == name:
+                bounds_rect = self.draw_line(surface, **kwargs)
+            elif "color" == name:
+                bounds_rect = self.draw_line(surface, color, **kwargs)
+            elif "start_pos" == name:
+                bounds_rect = self.draw_line(surface, color, start_pos, **kwargs)
+            elif "end_pos" == name:
+                bounds_rect = self.draw_line(
+                    surface, color, start_pos, end_pos, **kwargs
+                )
+            else:
+                bounds_rect = self.draw_line(
+                    surface, color, start_pos, end_pos, width, **kwargs
+                )
+
+            self.assertIsInstance(bounds_rect, pygame.Rect)
+
+    def test_line__valid_width_values(self):
+        """Ensures draw line 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
+            expected_color = line_color if width > 0 else surface_color
+
+            bounds_rect = self.draw_line(**kwargs)
+
+            self.assertEqual(surface.get_at(pos), expected_color)
+            self.assertIsInstance(bounds_rect, pygame.Rect)
+
+    def test_line__valid_start_pos_formats(self):
+        """Ensures draw line accepts different start_pos formats."""
+        expected_color = pygame.Color("red")
+        surface_color = pygame.Color("black")
+        surface = pygame.Surface((4, 4))
+        kwargs = {
+            "surface": surface,
+            "color": expected_color,
+            "start_pos": None,
+            "end_pos": (2, 2),
+            "width": 2,
+        }
+        x, y = 2, 1  # start position
+
+        # The point values can be ints or floats.
+        for start_pos in ((x, y), (x + 0.1, y), (x, y + 0.1), (x + 0.1, y + 0.1)):
+            # The point type can be a tuple/list/Vector2.
+            for seq_type in (tuple, list, Vector2):
+                surface.fill(surface_color)  # Clear for each test.
+                kwargs["start_pos"] = seq_type(start_pos)
+
+                bounds_rect = self.draw_line(**kwargs)
+
+                self.assertEqual(surface.get_at((x, y)), expected_color)
+                self.assertIsInstance(bounds_rect, pygame.Rect)
+
+    def test_line__valid_end_pos_formats(self):
+        """Ensures draw line accepts different end_pos formats."""
+        expected_color = pygame.Color("red")
+        surface_color = pygame.Color("black")
+        surface = pygame.Surface((4, 4))
+        kwargs = {
+            "surface": surface,
+            "color": expected_color,
+            "start_pos": (2, 1),
+            "end_pos": None,
+            "width": 2,
+        }
+        x, y = 2, 2  # end position
+
+        # The point values can be ints or floats.
+        for end_pos in ((x, y), (x + 0.2, y), (x, y + 0.2), (x + 0.2, y + 0.2)):
+            # The point type can be a tuple/list/Vector2.
+            for seq_type in (tuple, list, Vector2):
+                surface.fill(surface_color)  # Clear for each test.
+                kwargs["end_pos"] = seq_type(end_pos)
+
+                bounds_rect = self.draw_line(**kwargs)
+
+                self.assertEqual(surface.get_at((x, y)), expected_color)
+                self.assertIsInstance(bounds_rect, pygame.Rect)
+
+    def test_line__invalid_start_pos_formats(self):
+        """Ensures draw line handles invalid start_pos formats correctly."""
+        kwargs = {
+            "surface": pygame.Surface((4, 4)),
+            "color": pygame.Color("red"),
+            "start_pos": None,
+            "end_pos": (2, 2),
+            "width": 1,
+        }
+
+        start_pos_fmts = (
+            (2,),  # Too few coords.
+            (2, 1, 0),  # Too many coords.
+            (2, "1"),  # Wrong type.
+            {2, 1},  # Wrong type.
+            {2: 1},
+        )  # Wrong type.
+
+        for start_pos in start_pos_fmts:
+            kwargs["start_pos"] = start_pos
+
+            with self.assertRaises(TypeError):
+                bounds_rect = self.draw_line(**kwargs)
+
+    def test_line__invalid_end_pos_formats(self):
+        """Ensures draw line handles invalid end_pos formats correctly."""
+        kwargs = {
+            "surface": pygame.Surface((4, 4)),
+            "color": pygame.Color("red"),
+            "start_pos": (2, 2),
+            "end_pos": None,
+            "width": 1,
+        }
+
+        end_pos_fmts = (
+            (2,),  # Too few coords.
+            (2, 1, 0),  # Too many coords.
+            (2, "1"),  # Wrong type.
+            {2, 1},  # Wrong type.
+            {2: 1},
+        )  # Wrong type.
+
+        for end_pos in end_pos_fmts:
+            kwargs["end_pos"] = end_pos
+
+            with self.assertRaises(TypeError):
+                bounds_rect = self.draw_line(**kwargs)
+
+    def test_line__valid_color_formats(self):
+        """Ensures draw line accepts different color formats."""
+        green_color = pygame.Color("green")
+        surface_color = pygame.Color("black")
+        surface = pygame.Surface((3, 4))
+        pos = (1, 1)
+        kwargs = {
+            "surface": surface,
+            "color": None,
+            "start_pos": pos,
+            "end_pos": (2, 1),
+            "width": 3,
+        }
+        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_line(**kwargs)
+
+            self.assertEqual(surface.get_at(pos), expected_color)
+            self.assertIsInstance(bounds_rect, pygame.Rect)
+
+    def test_line__invalid_color_formats(self):
+        """Ensures draw line handles invalid color formats correctly."""
+        kwargs = {
+            "surface": pygame.Surface((4, 3)),
+            "color": None,
+            "start_pos": (1, 1),
+            "end_pos": (2, 1),
+            "width": 1,
+        }
+
+        for expected_color in (2.3, self):
+            kwargs["color"] = expected_color
+
+            with self.assertRaises(TypeError):
+                bounds_rect = self.draw_line(**kwargs)
+
+    def test_line__color(self):
+        """Tests if the line drawn is the correct color."""
+        pos = (0, 0)
+        for surface in self._create_surfaces():
+            for expected_color in self.COLORS:
+                self.draw_line(surface, expected_color, pos, (1, 0))
+
+                self.assertEqual(surface.get_at(pos), expected_color, f"pos={pos}")
+
+    def test_line__color_with_thickness(self):
+        """Ensures a thick line 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_line(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_line__gaps(self):
+        """Tests if the line drawn contains any gaps."""
+        expected_color = (255, 255, 255)
+        for surface in self._create_surfaces():
+            width = surface.get_width()
+            self.draw_line(surface, expected_color, (0, 0), (width - 1, 0))
+
+            for x in range(width):
+                pos = (x, 0)
+                self.assertEqual(surface.get_at(pos), expected_color, f"pos={pos}")
+
+    def test_line__gaps_with_thickness(self):
+        """Ensures a thick line is drawn without any gaps."""
+        expected_color = (255, 255, 255)
+        thickness = 5
+        for surface in self._create_surfaces():
+            width = surface.get_width() - 1
+            h = width // 5
+            w = h * 5
+            self.draw_line(surface, expected_color, (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.assertEqual(surface.get_at(pos), expected_color, f"pos={pos}")
+
+    def test_line__bounding_rect(self):
+        """Ensures draw line returns the correct bounding rect.
+
+        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")
+        width = height = 30
+        # Using a rect to help manage where the lines are drawn.
+        helper_rect = pygame.Rect((0, 0), (width, height))
+
+        # Testing surfaces of different sizes. One larger than the helper_rect
+        # and one smaller (to test lines that span the surface).
+        for size in ((width + 5, height + 5), (width - 5, height - 5)):
+            surface = pygame.Surface(size, 0, 32)
+            surf_rect = surface.get_rect()
+
+            # Move the helper rect to different positions to test line
+            # endpoints on and off the surface.
+            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.
+
+                        bounding_rect = self.draw_line(
+                            surface, line_color, start, end, thickness
+                        )
+
+                        if 0 < thickness:
+                            # Calculating the expected_rect after the line is
+                            # drawn (it uses what is actually drawn).
+                            expected_rect = create_bounding_rect(
+                                surface, surf_color, start
+                            )
+                        else:
+                            # Nothing drawn.
+                            expected_rect = pygame.Rect(start, (0, 0))
+
+                        self.assertEqual(
+                            bounding_rect,
+                            expected_rect,
+                            "start={}, end={}, size={}, thickness={}".format(
+                                start, end, size, thickness
+                            ),
+                        )
+
+    def test_line__surface_clip(self):
+        """Ensures draw line respects a surface's clip area."""
+        surfw = surfh = 30
+        line_color = pygame.Color("red")
+        surface_color = pygame.Color("green")
+        surface = pygame.Surface((surfw, surfh))
+        surface.fill(surface_color)
+
+        clip_rect = pygame.Rect((0, 0), (11, 11))
+        clip_rect.center = surface.get_rect().center
+        pos_rect = clip_rect.copy()  # Manages the line's pos.
+
+        for thickness in (1, 3):  # Test different line widths.
+            # Test centering the line along the clip rect's edge.
+            for center in rect_corners_mids_and_center(clip_rect):
+                # Get the expected points by drawing the line without the
+                # clip area set.
+                pos_rect.center = center
+                surface.set_clip(None)
+                surface.fill(surface_color)
+                self.draw_line(
+                    surface, line_color, pos_rect.midtop, pos_rect.midbottom, thickness
+                )
+                expected_pts = get_color_points(surface, line_color, clip_rect)
+
+                # Clear the surface and set the clip area. Redraw the line
+                # and check that only the clip area is modified.
+                surface.fill(surface_color)
+                surface.set_clip(clip_rect)
+
+                self.draw_line(
+                    surface, line_color, pos_rect.midtop, pos_rect.midbottom, thickness
+                )
+
+                surface.lock()  # For possible speed up.
+
+                # Check all the surface points to ensure only the expected_pts
+                # are the line_color.
+                for pt in ((x, y) for x in range(surfw) for y in range(surfh)):
+                    if pt in expected_pts:
+                        expected_color = line_color
+                    else:
+                        expected_color = surface_color
+
+                    self.assertEqual(surface.get_at(pt), expected_color, pt)
+
+                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.
+
+    This class inherits the general tests from LineMixin. It is also the class
+    to add any draw.line specific tests to.
+    """
+
+    def test_line_endianness(self):
+        """test color component order"""
+        for depth in (24, 32):
+            surface = pygame.Surface((5, 3), 0, depth)
+            surface.fill(pygame.Color(0, 0, 0))
+            self.draw_line(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_line(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")
+
+    def test_line(self):
+        # (l, t), (l, t)
+        self.surf_size = (320, 200)
+        self.surf = pygame.Surface(self.surf_size, pygame.SRCALPHA)
+        self.color = (1, 13, 24, 205)
+
+        drawn = draw.line(self.surf, self.color, (1, 0), (200, 0))
+        self.assertEqual(
+            drawn.right, 201, "end point arg should be (or at least was) inclusive"
+        )
+
+        # Should be colored where it's supposed to be
+        for pt in test_utils.rect_area_pts(drawn):
+            self.assertEqual(self.surf.get_at(pt), self.color)
+
+        # And not where it shouldn't
+        for pt in test_utils.rect_outer_bounds(drawn):
+            self.assertNotEqual(self.surf.get_at(pt), self.color)
+
+        # Line width greater that 1
+        line_width = 2
+        offset = 5
+        a = (offset, offset)
+        b = (self.surf_size[0] - offset, a[1])
+        c = (a[0], self.surf_size[1] - offset)
+        d = (b[0], c[1])
+        e = (a[0] + offset, c[1])
+        f = (b[0], c[0] + 5)
+        lines = [
+            (a, d),
+            (b, c),
+            (c, b),
+            (d, a),
+            (a, b),
+            (b, a),
+            (a, c),
+            (c, a),
+            (a, e),
+            (e, a),
+            (a, f),
+            (f, a),
+            (a, a),
+        ]
+
+        for p1, p2 in lines:
+            msg = f"{p1} - {p2}"
+            if p1[0] <= p2[0]:
+                plow = p1
+                phigh = p2
+            else:
+                plow = p2
+                phigh = p1
+
+            self.surf.fill((0, 0, 0))
+            rec = draw.line(self.surf, (255, 255, 255), p1, p2, line_width)
+            xinc = yinc = 0
+
+            if abs(p1[0] - p2[0]) > abs(p1[1] - p2[1]):
+                yinc = 1
+            else:
+                xinc = 1
+
+            for i in range(line_width):
+                p = (p1[0] + xinc * i, p1[1] + yinc * i)
+                self.assertEqual(self.surf.get_at(p), (255, 255, 255), msg)
+
+                p = (p2[0] + xinc * i, p2[1] + yinc * i)
+                self.assertEqual(self.surf.get_at(p), (255, 255, 255), msg)
+
+            p = (plow[0] - 1, plow[1])
+            self.assertEqual(self.surf.get_at(p), (0, 0, 0), msg)
+
+            p = (plow[0] + xinc * line_width, plow[1] + yinc * line_width)
+            self.assertEqual(self.surf.get_at(p), (0, 0, 0), msg)
+
+            p = (phigh[0] + xinc * line_width, phigh[1] + yinc * line_width)
+            self.assertEqual(self.surf.get_at(p), (0, 0, 0), msg)
+
+            if p1[0] < p2[0]:
+                rx = p1[0]
+            else:
+                rx = p2[0]
+
+            if p1[1] < p2[1]:
+                ry = p1[1]
+            else:
+                ry = p2[1]
+
+            w = abs(p2[0] - p1[0]) + 1 + xinc * (line_width - 1)
+            h = abs(p2[1] - p1[1]) + 1 + yinc * (line_width - 1)
+            msg += f", {rec}"
+
+            self.assertEqual(rec, (rx, ry, w, h), msg)
+
+    def test_line_for_gaps(self):
+        # This checks bug Thick Line Bug #448
+
+        width = 200
+        height = 200
+        surf = pygame.Surface((width, height), pygame.SRCALPHA)
+
+        def white_surrounded_pixels(x, y):
+            offsets = [(1, 0), (0, 1), (-1, 0), (0, -1)]
+            WHITE = (255, 255, 255, 255)
+            return len(
+                [1 for dx, dy in offsets if surf.get_at((x + dx, y + dy)) == WHITE]
+            )
+
+        def check_white_line(start, end):
+            surf.fill((0, 0, 0))
+            pygame.draw.line(surf, (255, 255, 255), start, end, 30)
+
+            BLACK = (0, 0, 0, 255)
+            for x in range(1, width - 1):
+                for y in range(1, height - 1):
+                    if surf.get_at((x, y)) == BLACK:
+                        self.assertTrue(white_surrounded_pixels(x, y) < 3)
+
+        check_white_line((50, 50), (140, 0))
+        check_white_line((50, 50), (0, 120))
+        check_white_line((50, 50), (199, 198))
+
+
+### Lines Testing #############################################################
+
+
+class LinesMixin(BaseLineMixin):
+    """Mixin test for drawing lines.
+
+    This class contains all the general lines drawing tests.
+    """
+
+    def test_lines__args(self):
+        """Ensures draw lines accepts the correct args."""
+        bounds_rect = self.draw_lines(
+            pygame.Surface((3, 3)), (0, 10, 0, 50), False, ((0, 0), (1, 1)), 1
+        )
+
+        self.assertIsInstance(bounds_rect, pygame.Rect)
+
+    def test_lines__args_without_width(self):
+        """Ensures draw lines accepts the args without a width."""
+        bounds_rect = self.draw_lines(
+            pygame.Surface((2, 2)), (0, 0, 0, 50), False, ((0, 0), (1, 1))
+        )
+
+        self.assertIsInstance(bounds_rect, pygame.Rect)
+
+    def test_lines__kwargs(self):
+        """Ensures draw lines accepts the correct kwargs
+        with and without a width arg.
+        """
+        surface = pygame.Surface((4, 4))
+        color = pygame.Color("yellow")
+        points = ((0, 0), (1, 1), (2, 2))
+        kwargs_list = [
+            {
+                "surface": surface,
+                "color": color,
+                "closed": False,
+                "points": points,
+                "width": 1,
+            },
+            {"surface": surface, "color": color, "closed": False, "points": points},
+        ]
+
+        for kwargs in kwargs_list:
+            bounds_rect = self.draw_lines(**kwargs)
+
+            self.assertIsInstance(bounds_rect, pygame.Rect)
+
+    def test_lines__kwargs_order_independent(self):
+        """Ensures draw lines's kwargs are not order dependent."""
+        bounds_rect = self.draw_lines(
+            closed=1,
+            points=((0, 0), (1, 1), (2, 2)),
+            width=2,
+            color=(10, 20, 30),
+            surface=pygame.Surface((3, 2)),
+        )
+
+        self.assertIsInstance(bounds_rect, pygame.Rect)
+
+    def test_lines__args_missing(self):
+        """Ensures draw lines detects any missing required args."""
+        surface = pygame.Surface((1, 1))
+        color = pygame.Color("blue")
+
+        with self.assertRaises(TypeError):
+            bounds_rect = self.draw_lines(surface, color, 0)
+
+        with self.assertRaises(TypeError):
+            bounds_rect = self.draw_lines(surface, color)
+
+        with self.assertRaises(TypeError):
+            bounds_rect = self.draw_lines(surface)
+
+        with self.assertRaises(TypeError):
+            bounds_rect = self.draw_lines()
+
+    def test_lines__kwargs_missing(self):
+        """Ensures draw lines detects any missing required kwargs."""
+        kwargs = {
+            "surface": pygame.Surface((3, 2)),
+            "color": pygame.Color("red"),
+            "closed": 1,
+            "points": ((2, 2), (1, 1)),
+            "width": 1,
+        }
+
+        for name in ("points", "closed", "color", "surface"):
+            invalid_kwargs = dict(kwargs)
+            invalid_kwargs.pop(name)  # Pop from a copy.
+
+            with self.assertRaises(TypeError):
+                bounds_rect = self.draw_lines(**invalid_kwargs)
+
+    def test_lines__arg_invalid_types(self):
+        """Ensures draw lines detects invalid arg types."""
+        surface = pygame.Surface((2, 2))
+        color = pygame.Color("blue")
+        closed = 0
+        points = ((1, 2), (2, 1))
+
+        with self.assertRaises(TypeError):
+            # Invalid width.
+            bounds_rect = self.draw_lines(surface, color, closed, points, "1")
+
+        with self.assertRaises(TypeError):
+            # Invalid points.
+            bounds_rect = self.draw_lines(surface, color, closed, (1, 2, 3))
+
+        with self.assertRaises(TypeError):
+            # Invalid closed.
+            bounds_rect = self.draw_lines(surface, color, InvalidBool(), points)
+
+        with self.assertRaises(TypeError):
+            # Invalid color.
+            bounds_rect = self.draw_lines(surface, 2.3, closed, points)
+
+        with self.assertRaises(TypeError):
+            # Invalid surface.
+            bounds_rect = self.draw_lines((1, 2, 3, 4), color, closed, points)
+
+    def test_lines__kwarg_invalid_types(self):
+        """Ensures draw lines detects invalid kwarg types."""
+        valid_kwargs = {
+            "surface": pygame.Surface((3, 3)),
+            "color": pygame.Color("green"),
+            "closed": False,
+            "points": ((1, 2), (2, 1)),
+            "width": 1,
+        }
+
+        invalid_kwargs = {
+            "surface": pygame.Surface,
+            "color": 2.3,
+            "closed": InvalidBool(),
+            "points": (0, 0, 0),
+            "width": 1.2,
+        }
+
+        for kwarg in ("surface", "color", "closed", "points", "width"):
+            kwargs = dict(valid_kwargs)
+            kwargs[kwarg] = invalid_kwargs[kwarg]
+
+            with self.assertRaises(TypeError):
+                bounds_rect = self.draw_lines(**kwargs)
+
+    def test_lines__kwarg_invalid_name(self):
+        """Ensures draw lines detects invalid kwarg names."""
+        surface = pygame.Surface((2, 3))
+        color = pygame.Color("cyan")
+        closed = 1
+        points = ((1, 2), (2, 1))
+        kwargs_list = [
+            {
+                "surface": surface,
+                "color": color,
+                "closed": closed,
+                "points": points,
+                "width": 1,
+                "invalid": 1,
+            },
+            {
+                "surface": surface,
+                "color": color,
+                "closed": closed,
+                "points": points,
+                "invalid": 1,
+            },
+        ]
+
+        for kwargs in kwargs_list:
+            with self.assertRaises(TypeError):
+                bounds_rect = self.draw_lines(**kwargs)
+
+    def test_lines__args_and_kwargs(self):
+        """Ensures draw lines accepts a combination of args/kwargs"""
+        surface = pygame.Surface((3, 2))
+        color = (255, 255, 0, 0)
+        closed = 0
+        points = ((1, 2), (2, 1))
+        width = 1
+        kwargs = {
+            "surface": surface,
+            "color": color,
+            "closed": closed,
+            "points": points,
+            "width": width,
+        }
+
+        for name in ("surface", "color", "closed", "points", "width"):
+            kwargs.pop(name)
+
+            if "surface" == name:
+                bounds_rect = self.draw_lines(surface, **kwargs)
+            elif "color" == name:
+                bounds_rect = self.draw_lines(surface, color, **kwargs)
+            elif "closed" == name:
+                bounds_rect = self.draw_lines(surface, color, closed, **kwargs)
+            elif "points" == name:
+                bounds_rect = self.draw_lines(surface, color, closed, points, **kwargs)
+            else:
+                bounds_rect = self.draw_lines(
+                    surface, color, closed, points, width, **kwargs
+                )
+
+            self.assertIsInstance(bounds_rect, pygame.Rect)
+
+    def test_lines__valid_width_values(self):
+        """Ensures draw lines accepts different width values."""
+        line_color = pygame.Color("yellow")
+        surface_color = pygame.Color("white")
+        surface = pygame.Surface((3, 4))
+        pos = (1, 1)
+        kwargs = {
+            "surface": surface,
+            "color": line_color,
+            "closed": False,
+            "points": (pos, (2, 1)),
+            "width": None,
+        }
+
+        for width in (-100, -10, -1, 0, 1, 10, 100):
+            surface.fill(surface_color)  # Clear for each test.
+            kwargs["width"] = width
+            expected_color = line_color if width > 0 else surface_color
+
+            bounds_rect = self.draw_lines(**kwargs)
+
+            self.assertEqual(surface.get_at(pos), expected_color)
+            self.assertIsInstance(bounds_rect, pygame.Rect)
+
+    def test_lines__valid_points_format(self):
+        """Ensures draw lines accepts different points formats."""
+        expected_color = (10, 20, 30, 255)
+        surface_color = pygame.Color("white")
+        surface = pygame.Surface((3, 4))
+        kwargs = {
+            "surface": surface,
+            "color": expected_color,
+            "closed": False,
+            "points": None,
+            "width": 1,
+        }
+
+        # The point type can be a tuple/list/Vector2.
+        point_types = (
+            (tuple, tuple, tuple, tuple),  # all tuples
+            (list, list, list, list),  # all lists
+            (Vector2, Vector2, Vector2, Vector2),  # all Vector2s
+            (list, Vector2, tuple, Vector2),
+        )  # mix
+
+        # The point values can be ints or floats.
+        point_values = (
+            ((1, 1), (2, 1), (2, 2), (1, 2)),
+            ((1, 1), (2.2, 1), (2.1, 2.2), (1, 2.1)),
+        )
+
+        # Each sequence of points can be a tuple or a list.
+        seq_types = (tuple, list)
+
+        for point_type in point_types:
+            for values in point_values:
+                check_pos = values[0]
+                points = [point_type[i](pt) for i, pt in enumerate(values)]
+
+                for seq_type in seq_types:
+                    surface.fill(surface_color)  # Clear for each test.
+                    kwargs["points"] = seq_type(points)
+
+                    bounds_rect = self.draw_lines(**kwargs)
+
+                    self.assertEqual(surface.get_at(check_pos), expected_color)
+                    self.assertIsInstance(bounds_rect, pygame.Rect)
+
+    def test_lines__invalid_points_formats(self):
+        """Ensures draw lines handles invalid points formats correctly."""
+        kwargs = {
+            "surface": pygame.Surface((4, 4)),
+            "color": pygame.Color("red"),
+            "closed": False,
+            "points": None,
+            "width": 1,
+        }
+
+        points_fmts = (
+            ((1, 1), (2,)),  # Too few coords.
+            ((1, 1), (2, 2, 2)),  # Too many coords.
+            ((1, 1), (2, "2")),  # Wrong type.
+            ((1, 1), {2, 3}),  # Wrong type.
+            ((1, 1), {2: 2, 3: 3}),  # Wrong type.
+            {(1, 1), (1, 2)},  # Wrong type.
+            {1: 1, 4: 4},
+        )  # Wrong type.
+
+        for points in points_fmts:
+            kwargs["points"] = points
+
+            with self.assertRaises(TypeError):
+                bounds_rect = self.draw_lines(**kwargs)
+
+    def test_lines__invalid_points_values(self):
+        """Ensures draw lines handles invalid points values correctly."""
+        kwargs = {
+            "surface": pygame.Surface((4, 4)),
+            "color": pygame.Color("red"),
+            "closed": False,
+            "points": None,
+            "width": 1,
+        }
+
+        for points in ([], ((1, 1),)):  # Too few points.
+            for seq_type in (tuple, list):  # Test as tuples and lists.
+                kwargs["points"] = seq_type(points)
+
+                with self.assertRaises(ValueError):
+                    bounds_rect = self.draw_lines(**kwargs)
+
+    def test_lines__valid_closed_values(self):
+        """Ensures draw lines accepts different closed values."""
+        line_color = pygame.Color("blue")
+        surface_color = pygame.Color("white")
+        surface = pygame.Surface((3, 4))
+        pos = (1, 2)
+        kwargs = {
+            "surface": surface,
+            "color": line_color,
+            "closed": None,
+            "points": ((1, 1), (3, 1), (3, 3), (1, 3)),
+            "width": 1,
+        }
+
+        true_values = (-7, 1, 10, "2", 3.1, (4,), [5], True)
+        false_values = (None, "", 0, (), [], False)
+
+        for closed in true_values + false_values:
+            surface.fill(surface_color)  # Clear for each test.
+            kwargs["closed"] = closed
+            expected_color = line_color if closed else surface_color
+
+            bounds_rect = self.draw_lines(**kwargs)
+
+            self.assertEqual(surface.get_at(pos), expected_color)
+            self.assertIsInstance(bounds_rect, pygame.Rect)
+
+    def test_lines__valid_color_formats(self):
+        """Ensures draw lines accepts different color formats."""
+        green_color = pygame.Color("green")
+        surface_color = pygame.Color("black")
+        surface = pygame.Surface((3, 4))
+        pos = (1, 1)
+        kwargs = {
+            "surface": surface,
+            "color": None,
+            "closed": False,
+            "points": (pos, (2, 1)),
+            "width": 3,
+        }
+        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_lines(**kwargs)
+
+            self.assertEqual(surface.get_at(pos), expected_color)
+            self.assertIsInstance(bounds_rect, pygame.Rect)
+
+    def test_lines__invalid_color_formats(self):
+        """Ensures draw lines handles invalid color formats correctly."""
+        kwargs = {
+            "surface": pygame.Surface((4, 3)),
+            "color": None,
+            "closed": False,
+            "points": ((1, 1), (1, 2)),
+            "width": 1,
+        }
+
+        for expected_color in (2.3, self):
+            kwargs["color"] = expected_color
+
+            with self.assertRaises(TypeError):
+                bounds_rect = self.draw_lines(**kwargs)
+
+    def test_lines__color(self):
+        """Tests if the lines drawn are the correct color.
+
+        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():
+            for expected_color in self.COLORS:
+                self.draw_lines(surface, expected_color, True, corners(surface))
+
+                for pos, color in border_pos_and_color(surface):
+                    self.assertEqual(color, expected_color, f"pos={pos}")
+
+    def test_lines__color_with_thickness(self):
+        """Ensures thick lines are drawn using the correct color."""
+        x_left = y_top = 5
+        for surface in self._create_surfaces():
+            x_right = surface.get_width() - 5
+            y_bottom = surface.get_height() - 5
+            endpoints = (
+                (x_left, y_top),
+                (x_right, y_top),
+                (x_right, y_bottom),
+                (x_left, y_bottom),
+            )
+            for expected_color in self.COLORS:
+                self.draw_lines(surface, expected_color, True, endpoints, 3)
+
+                for t in (-1, 0, 1):
+                    for x in range(x_left, x_right + 1):
+                        for y in (y_top, y_bottom):
+                            pos = (x, y + t)
+                            self.assertEqual(
+                                surface.get_at(pos),
+                                expected_color,
+                                f"pos={pos}",
+                            )
+                    for y in range(y_top, y_bottom + 1):
+                        for x in (x_left, x_right):
+                            pos = (x + t, y)
+                            self.assertEqual(
+                                surface.get_at(pos),
+                                expected_color,
+                                f"pos={pos}",
+                            )
+
+    def test_lines__gaps(self):
+        """Tests if the lines drawn contain any gaps.
+
+        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)
+        for surface in self._create_surfaces():
+            self.draw_lines(surface, expected_color, True, corners(surface))
+
+            for pos, color in border_pos_and_color(surface):
+                self.assertEqual(color, expected_color, f"pos={pos}")
+
+    def test_lines__gaps_with_thickness(self):
+        """Ensures thick lines are drawn without any gaps."""
+        expected_color = (255, 255, 255)
+        x_left = y_top = 5
+        for surface in self._create_surfaces():
+            h = (surface.get_width() - 11) // 5
+            w = h * 5
+            x_right = x_left + w
+            y_bottom = y_top + h
+            endpoints = ((x_left, y_top), (x_right, y_top), (x_right, y_bottom))
+            self.draw_lines(surface, expected_color, True, endpoints, 3)
+
+            for x in range(x_left, x_right + 1):
+                for t in (-1, 0, 1):
+                    pos = (x, y_top + t)
+                    self.assertEqual(surface.get_at(pos), expected_color, f"pos={pos}")
+                    pos = (x, y_top + t + ((x - 3) // 5))
+                    self.assertEqual(surface.get_at(pos), expected_color, f"pos={pos}")
+            for y in range(y_top, y_bottom + 1):
+                for t in (-1, 0, 1):
+                    pos = (x_right + t, y)
+                    self.assertEqual(surface.get_at(pos), expected_color, f"pos={pos}")
+
+    def test_lines__bounding_rect(self):
+        """Ensures draw lines returns the correct bounding rect.
+
+        Tests lines with endpoints on and off the surface and a range of
+        width/thickness values.
+        """
+        line_color = pygame.Color("red")
+        surf_color = pygame.Color("black")
+        width = height = 30
+        # Using a rect to help manage where the lines are drawn.
+        pos_rect = pygame.Rect((0, 0), (width, height))
+
+        # Testing surfaces of different sizes. One larger than the pos_rect
+        # and one smaller (to test lines that span the surface).
+        for size in ((width + 5, height + 5), (width - 5, height - 5)):
+            surface = pygame.Surface(size, 0, 32)
+            surf_rect = surface.get_rect()
+
+            # Move pos_rect to different positions to test line endpoints on
+            # and off the surface.
+            for pos in rect_corners_mids_and_center(surf_rect):
+                pos_rect.center = pos
+                # Shape: Triangle (if closed), ^ caret (if not closed).
+                pts = (pos_rect.midleft, pos_rect.midtop, pos_rect.midright)
+                pos = pts[0]  # Rect position if nothing drawn.
+
+                # Draw using different thickness and closed values.
+                for thickness in range(-1, 5):
+                    for closed in (True, False):
+                        surface.fill(surf_color)  # Clear for each test.
+
+                        bounding_rect = self.draw_lines(
+                            surface, line_color, closed, pts, thickness
+                        )
+
+                        if 0 < thickness:
+                            # Calculating the expected_rect after the lines are
+                            # drawn (it uses what is actually drawn).
+                            expected_rect = create_bounding_rect(
+                                surface, surf_color, pos
+                            )
+                        else:
+                            # Nothing drawn.
+                            expected_rect = pygame.Rect(pos, (0, 0))
+
+                        self.assertEqual(bounding_rect, expected_rect)
+
+    def test_lines__surface_clip(self):
+        """Ensures draw lines respects a surface's clip area."""
+        surfw = surfh = 30
+        line_color = pygame.Color("red")
+        surface_color = pygame.Color("green")
+        surface = pygame.Surface((surfw, surfh))
+        surface.fill(surface_color)
+
+        clip_rect = pygame.Rect((0, 0), (11, 11))
+        clip_rect.center = surface.get_rect().center
+        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.
+        for center in rect_corners_mids_and_center(clip_rect):
+            pos_rect.center = center
+            pts = (pos_rect.midtop, pos_rect.center, pos_rect.midbottom)
+
+            for closed in (True, False):  # Test closed and not closed.
+                for thickness in (1, 3):  # Test different line widths.
+                    # Get the expected points by drawing the lines without the
+                    # clip area set.
+                    surface.set_clip(None)
+                    surface.fill(surface_color)
+                    self.draw_lines(surface, line_color, closed, pts, thickness)
+                    expected_pts = get_color_points(surface, line_color, clip_rect)
+
+                    # Clear the surface and set the clip area. Redraw the lines
+                    # and check that only the clip area is modified.
+                    surface.fill(surface_color)
+                    surface.set_clip(clip_rect)
+
+                    self.draw_lines(surface, line_color, closed, pts, thickness)
+
+                    surface.lock()  # For possible speed up.
+
+                    # Check all the surface points to ensure only the
+                    # expected_pts are the line_color.
+                    for pt in ((x, y) for x in range(surfw) for y in range(surfh)):
+                        if pt in expected_pts:
+                            expected_color = line_color
+                        else:
+                            expected_color = surface_color
+
+                        self.assertEqual(surface.get_at(pt), expected_color, pt)
+
+                    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.
+
+    This class inherits the general tests from LinesMixin. It is also the class
+    to add any draw.lines specific tests to.
+    """
+
+
+### AALine Testing ############################################################
+
+
+class AALineMixin(BaseLineMixin):
+    """Mixin test for drawing a single aaline.
+
+    This class contains all the general single aaline drawing tests.
+    """
+
+    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), 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):
+        """From pygame 2, blend=False should raise DeprecationWarning."""
+        with warnings.catch_warnings(record=True) as w:
+            # 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"""
+        surface = pygame.Surface((4, 4))
+        color = pygame.Color("yellow")
+        start_pos = (1, 1)
+        end_pos = (2, 2)
+        kwargs_list = [
+            {
+                "surface": surface,
+                "color": color,
+                "start_pos": start_pos,
+                "end_pos": end_pos,
+            },
+        ]
+
+        for kwargs in kwargs_list:
+            bounds_rect = self.draw_aaline(**kwargs)
+
+            self.assertIsInstance(bounds_rect, pygame.Rect)
+
+    def test_aaline__kwargs_order_independent(self):
+        """Ensures draw aaline's kwargs are not order dependent."""
+        bounds_rect = self.draw_aaline(
+            start_pos=(1, 2),
+            end_pos=(2, 1),
+            color=(10, 20, 30),
+            surface=pygame.Surface((3, 2)),
+        )
+
+        self.assertIsInstance(bounds_rect, pygame.Rect)
+
+    def test_aaline__args_missing(self):
+        """Ensures draw aaline detects any missing required args."""
+        surface = pygame.Surface((1, 1))
+        color = pygame.Color("blue")
+
+        with self.assertRaises(TypeError):
+            bounds_rect = self.draw_aaline(surface, color, (0, 0))
+
+        with self.assertRaises(TypeError):
+            bounds_rect = self.draw_aaline(surface, color)
+
+        with self.assertRaises(TypeError):
+            bounds_rect = self.draw_aaline(surface)
+
+        with self.assertRaises(TypeError):
+            bounds_rect = self.draw_aaline()
+
+    def test_aaline__kwargs_missing(self):
+        """Ensures draw aaline detects any missing required kwargs."""
+        kwargs = {
+            "surface": pygame.Surface((3, 2)),
+            "color": pygame.Color("red"),
+            "start_pos": (2, 1),
+            "end_pos": (2, 2),
+        }
+
+        for name in ("end_pos", "start_pos", "color", "surface"):
+            invalid_kwargs = dict(kwargs)
+            invalid_kwargs.pop(name)  # Pop from a copy.
+
+            with self.assertRaises(TypeError):
+                bounds_rect = self.draw_aaline(**invalid_kwargs)
+
+    def test_aaline__arg_invalid_types(self):
+        """Ensures draw aaline detects invalid arg types."""
+        surface = pygame.Surface((2, 2))
+        color = pygame.Color("blue")
+        start_pos = (0, 1)
+        end_pos = (1, 2)
+
+        with self.assertRaises(TypeError):
+            # Invalid end_pos.
+            bounds_rect = self.draw_aaline(surface, color, start_pos, (1, 2, 3))
+
+        with self.assertRaises(TypeError):
+            # Invalid start_pos.
+            bounds_rect = self.draw_aaline(surface, color, (1,), end_pos)
+
+        with self.assertRaises(ValueError):
+            # Invalid color.
+            bounds_rect = self.draw_aaline(surface, "invalid-color", start_pos, end_pos)
+
+        with self.assertRaises(TypeError):
+            # Invalid surface.
+            bounds_rect = self.draw_aaline((1, 2, 3, 4), color, start_pos, end_pos)
+
+    def test_aaline__kwarg_invalid_types(self):
+        """Ensures draw aaline detects invalid kwarg types."""
+        surface = pygame.Surface((3, 3))
+        color = pygame.Color("green")
+        start_pos = (1, 0)
+        end_pos = (2, 0)
+        kwargs_list = [
+            {
+                "surface": pygame.Surface,  # Invalid surface.
+                "color": color,
+                "start_pos": start_pos,
+                "end_pos": end_pos,
+            },
+            {
+                "surface": surface,
+                "color": 2.3,  # Invalid color.
+                "start_pos": start_pos,
+                "end_pos": end_pos,
+            },
+            {
+                "surface": surface,
+                "color": color,
+                "start_pos": (0, 0, 0),  # Invalid start_pos.
+                "end_pos": end_pos,
+            },
+            {
+                "surface": surface,
+                "color": color,
+                "start_pos": start_pos,
+                "end_pos": (0,),  # Invalid end_pos.
+            },
+        ]
+
+        for kwargs in kwargs_list:
+            with self.assertRaises(TypeError):
+                bounds_rect = self.draw_aaline(**kwargs)
+
+    def test_aaline__kwarg_invalid_name(self):
+        """Ensures draw aaline detects invalid kwarg names."""
+        surface = pygame.Surface((2, 3))
+        color = pygame.Color("cyan")
+        start_pos = (1, 1)
+        end_pos = (2, 0)
+        kwargs_list = [
+            {
+                "surface": surface,
+                "color": color,
+                "start_pos": start_pos,
+                "end_pos": end_pos,
+                "invalid": 1,
+            },
+            {
+                "surface": surface,
+                "color": color,
+                "start_pos": start_pos,
+                "end_pos": end_pos,
+                "invalid": 1,
+            },
+        ]
+
+        for kwargs in kwargs_list:
+            with self.assertRaises(TypeError):
+                bounds_rect = self.draw_aaline(**kwargs)
+
+    def test_aaline__args_and_kwargs(self):
+        """Ensures draw aaline accepts a combination of args/kwargs"""
+        surface = pygame.Surface((3, 2))
+        color = (255, 255, 0, 0)
+        start_pos = (0, 1)
+        end_pos = (1, 2)
+        kwargs = {
+            "surface": surface,
+            "color": color,
+            "start_pos": start_pos,
+            "end_pos": end_pos,
+        }
+
+        for name in ("surface", "color", "start_pos", "end_pos"):
+            kwargs.pop(name)
+
+            if "surface" == name:
+                bounds_rect = self.draw_aaline(surface, **kwargs)
+            elif "color" == name:
+                bounds_rect = self.draw_aaline(surface, color, **kwargs)
+            elif "start_pos" == name:
+                bounds_rect = self.draw_aaline(surface, color, start_pos, **kwargs)
+            elif "end_pos" == name:
+                bounds_rect = self.draw_aaline(
+                    surface, color, start_pos, end_pos, **kwargs
+                )
+            else:
+                bounds_rect = self.draw_aaline(
+                    surface, color, start_pos, end_pos, **kwargs
+                )
+
+            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")
+        surface_color = pygame.Color("black")
+        surface = pygame.Surface((4, 4))
+        kwargs = {
+            "surface": surface,
+            "color": expected_color,
+            "start_pos": None,
+            "end_pos": (2, 2),
+        }
+        x, y = 2, 1  # start position
+        positions = ((x, y), (x + 0.01, y), (x, y + 0.01), (x + 0.01, y + 0.01))
+
+        for start_pos in positions:
+            for seq_type in (tuple, list, Vector2):
+                surface.fill(surface_color)  # Clear for each test.
+                kwargs["start_pos"] = seq_type(start_pos)
+
+                bounds_rect = self.draw_aaline(**kwargs)
+
+                color = surface.get_at((x, y))
+                for i, sub_color in enumerate(expected_color):
+                    # The color could be slightly off the expected color due to
+                    # any fractional position arguments.
+                    self.assertGreaterEqual(color[i] + 6, sub_color, start_pos)
+                self.assertIsInstance(bounds_rect, pygame.Rect, start_pos)
+
+    def test_aaline__valid_end_pos_formats(self):
+        """Ensures draw aaline accepts different end_pos formats."""
+        expected_color = pygame.Color("red")
+        surface_color = pygame.Color("black")
+        surface = pygame.Surface((4, 4))
+        kwargs = {
+            "surface": surface,
+            "color": expected_color,
+            "start_pos": (2, 1),
+            "end_pos": None,
+        }
+        x, y = 2, 2  # end position
+        positions = ((x, y), (x + 0.02, y), (x, y + 0.02), (x + 0.02, y + 0.02))
+
+        for end_pos in positions:
+            for seq_type in (tuple, list, Vector2):
+                surface.fill(surface_color)  # Clear for each test.
+                kwargs["end_pos"] = seq_type(end_pos)
+
+                bounds_rect = self.draw_aaline(**kwargs)
+
+                color = surface.get_at((x, y))
+                for i, sub_color in enumerate(expected_color):
+                    # The color could be slightly off the expected color due to
+                    # any fractional position arguments.
+                    self.assertGreaterEqual(color[i] + 15, sub_color, end_pos)
+                self.assertIsInstance(bounds_rect, pygame.Rect, end_pos)
+
+    def test_aaline__invalid_start_pos_formats(self):
+        """Ensures draw aaline handles invalid start_pos formats correctly."""
+        kwargs = {
+            "surface": pygame.Surface((4, 4)),
+            "color": pygame.Color("red"),
+            "start_pos": None,
+            "end_pos": (2, 2),
+        }
+
+        start_pos_fmts = (
+            (2,),  # Too few coords.
+            (2, 1, 0),  # Too many coords.
+            (2, "1"),  # Wrong type.
+            {2, 1},  # Wrong type.
+            {2: 1},
+        )  # Wrong type.
+
+        for start_pos in start_pos_fmts:
+            kwargs["start_pos"] = start_pos
+
+            with self.assertRaises(TypeError):
+                bounds_rect = self.draw_aaline(**kwargs)
+
+    def test_aaline__invalid_end_pos_formats(self):
+        """Ensures draw aaline handles invalid end_pos formats correctly."""
+        kwargs = {
+            "surface": pygame.Surface((4, 4)),
+            "color": pygame.Color("red"),
+            "start_pos": (2, 2),
+            "end_pos": None,
+        }
+
+        end_pos_fmts = (
+            (2,),  # Too few coords.
+            (2, 1, 0),  # Too many coords.
+            (2, "1"),  # Wrong type.
+            {2, 1},  # Wrong type.
+            {2: 1},
+        )  # Wrong type.
+
+        for end_pos in end_pos_fmts:
+            kwargs["end_pos"] = end_pos
+
+            with self.assertRaises(TypeError):
+                bounds_rect = self.draw_aaline(**kwargs)
+
+    def test_aaline__valid_color_formats(self):
+        """Ensures draw aaline accepts different color formats."""
+        green_color = pygame.Color("green")
+        surface_color = pygame.Color("black")
+        surface = pygame.Surface((3, 4))
+        pos = (1, 1)
+        kwargs = {
+            "surface": surface,
+            "color": None,
+            "start_pos": pos,
+            "end_pos": (2, 1),
+        }
+        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_aaline(**kwargs)
+
+            self.assertEqual(surface.get_at(pos), expected_color)
+            self.assertIsInstance(bounds_rect, pygame.Rect)
+
+    def test_aaline__invalid_color_formats(self):
+        """Ensures draw aaline handles invalid color formats correctly."""
+        kwargs = {
+            "surface": pygame.Surface((4, 3)),
+            "color": None,
+            "start_pos": (1, 1),
+            "end_pos": (2, 1),
+        }
+
+        for expected_color in (2.3, self):
+            kwargs["color"] = expected_color
+
+            with self.assertRaises(TypeError):
+                bounds_rect = self.draw_aaline(**kwargs)
+
+    def test_aaline__color(self):
+        """Tests if the aaline drawn is the correct color."""
+        pos = (0, 0)
+        for surface in self._create_surfaces():
+            for expected_color in self.COLORS:
+                self.draw_aaline(surface, expected_color, pos, (1, 0))
+
+                self.assertEqual(surface.get_at(pos), expected_color, f"pos={pos}")
+
+    def test_aaline__gaps(self):
+        """Tests if the aaline drawn contains any gaps.
+
+        See: #512
+        """
+        expected_color = (255, 255, 255)
+        for surface in self._create_surfaces():
+            width = surface.get_width()
+            self.draw_aaline(surface, expected_color, (0, 0), (width - 1, 0))
+
+            for x in range(width):
+                pos = (x, 0)
+                self.assertEqual(surface.get_at(pos), expected_color, f"pos={pos}")
+
+    def test_aaline__bounding_rect(self):
+        """Ensures draw aaline returns the correct bounding rect.
+
+        Tests lines with endpoints on and off the surface.
+        """
+        line_color = pygame.Color("red")
+        surf_color = pygame.Color("blue")
+        width = height = 30
+        # Using a rect to help manage where the lines are drawn.
+        helper_rect = pygame.Rect((0, 0), (width, height))
+
+        # Testing surfaces of different sizes. One larger than the helper_rect
+        # and one smaller (to test lines that span the surface).
+        for size in ((width + 5, height + 5), (width - 5, height - 5)):
+            surface = pygame.Surface(size, 0, 32)
+            surf_rect = surface.get_rect()
+
+            # Move the helper rect to different positions to test line
+            # endpoints on and off the surface.
+            for pos in rect_corners_mids_and_center(surf_rect):
+                helper_rect.center = pos
+
+                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)
+
+                    # 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)
+
+    def test_aaline__surface_clip(self):
+        """Ensures draw aaline respects a surface's clip area."""
+        surfw = surfh = 30
+        aaline_color = pygame.Color("red")
+        surface_color = pygame.Color("green")
+        surface = pygame.Surface((surfw, surfh))
+        surface.fill(surface_color)
+
+        clip_rect = pygame.Rect((0, 0), (11, 11))
+        clip_rect.center = surface.get_rect().center
+        pos_rect = clip_rect.copy()  # Manages the aaline's pos.
+
+        # 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, pos_rect.midtop, pos_rect.midbottom)
+
+            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)
+
+            self.draw_aaline(surface, aaline_color, pos_rect.midtop, pos_rect.midbottom)
+
+            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, pt)
+                else:
+                    self.assertEqual(surface.get_at(pt), surface_color, pt)
+
+            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):
+    """Test draw module function aaline.
+
+    This class inherits the general tests from AALineMixin. It is also the
+    class to add any draw.aaline specific tests to.
+    """
+
+    def test_aaline_endianness(self):
+        """test color component order"""
+        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), 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), 1)
+
+            self.assertGreater(surface.get_at((1, 1)).b, 0, "there should be blue here")
+
+    def _check_antialiasing(
+        self, from_point, to_point, should, check_points, set_endpoints=True
+    ):
+        """Draw a line between two points and check colors of check_points."""
+        if set_endpoints:
+            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, True)
+
+            for pt in check_points:
+                color = should.get(pt, BG_RED)
+                with self.subTest(from_pt=from_point, pt=pt, to=to_point):
+                    self.assertEqual(self.surface.get_at(pt), color)
+
+            # reset
+            draw.rect(self.surface, BG_RED, (0, 0, 10, 10), 0)
+
+        # it is important to test also opposite direction, the algorithm
+        # is (#512) or was not symmetric
+        check_one_direction(from_point, to_point, should)
+        if from_point != to_point:
+            check_one_direction(to_point, from_point, should)
+
+    def test_short_non_antialiased_lines(self):
+        """test very short not anti aliased lines in all directions."""
+
+        # Horizontal, vertical and diagonal lines should not be anti-aliased,
+        # even with draw.aaline ...
+        self.surface = pygame.Surface((10, 10))
+        draw.rect(self.surface, BG_RED, (0, 0, 10, 10), 0)
+
+        check_points = [(i, j) for i in range(3, 8) for j in range(3, 8)]
+
+        def check_both_directions(from_pt, to_pt, other_points):
+            should = {pt: FG_GREEN for pt in other_points}
+            self._check_antialiasing(from_pt, to_pt, should, check_points)
+
+        # 0. one point
+        check_both_directions((5, 5), (5, 5), [])
+        # 1. horizontal
+        check_both_directions((4, 7), (5, 7), [])
+        check_both_directions((5, 4), (7, 4), [(6, 4)])
+
+        # 2. vertical
+        check_both_directions((5, 5), (5, 6), [])
+        check_both_directions((6, 4), (6, 6), [(6, 5)])
+        # 3. diagonals
+        check_both_directions((5, 5), (6, 6), [])
+        check_both_directions((5, 5), (7, 7), [(6, 6)])
+        check_both_directions((5, 6), (6, 5), [])
+        check_both_directions((6, 4), (4, 6), [(5, 5)])
+
+    def test_short_line_anti_aliasing(self):
+        self.surface = pygame.Surface((10, 10))
+        draw.rect(self.surface, BG_RED, (0, 0, 10, 10), 0)
+
+        check_points = [(i, j) for i in range(3, 8) for j in range(3, 8)]
+
+        def check_both_directions(from_pt, to_pt, should):
+            self._check_antialiasing(from_pt, to_pt, should, check_points)
+
+        brown = (127, 127, 0)
+        reddish = (191, 63, 0)
+        greenish = (63, 191, 0)
+
+        # lets say dx = abs(x0 - x1) ; dy = abs(y0 - y1)
+
+        # dy / dx = 0.5
+        check_both_directions((4, 4), (6, 5), {(5, 4): brown, (5, 5): brown})
+        check_both_directions((4, 5), (6, 4), {(5, 4): brown, (5, 5): brown})
+
+        # dy / dx = 2
+        check_both_directions((4, 4), (5, 6), {(4, 5): brown, (5, 5): brown})
+        check_both_directions((5, 4), (4, 6), {(4, 5): brown, (5, 5): brown})
+
+        # some little longer lines; so we need to check more points:
+        check_points = [(i, j) for i in range(2, 9) for j in range(2, 9)]
+        # dy / dx = 0.25
+        should = {
+            (4, 3): greenish,
+            (5, 3): brown,
+            (6, 3): reddish,
+            (4, 4): reddish,
+            (5, 4): brown,
+            (6, 4): greenish,
+        }
+        check_both_directions((3, 3), (7, 4), should)
+
+        should = {
+            (4, 3): reddish,
+            (5, 3): brown,
+            (6, 3): greenish,
+            (4, 4): greenish,
+            (5, 4): brown,
+            (6, 4): reddish,
+        }
+        check_both_directions((3, 4), (7, 3), should)
+
+        # dy / dx = 4
+        should = {
+            (4, 4): greenish,
+            (4, 5): brown,
+            (4, 6): reddish,
+            (5, 4): reddish,
+            (5, 5): brown,
+            (5, 6): greenish,
+        }
+        check_both_directions((4, 3), (5, 7), should)
+
+        should = {
+            (4, 4): reddish,
+            (4, 5): brown,
+            (4, 6): greenish,
+            (5, 4): greenish,
+            (5, 5): brown,
+            (5, 6): reddish,
+        }
+        check_both_directions((5, 3), (4, 7), should)
+
+    def test_anti_aliasing_float_coordinates(self):
+        """Float coordinates should be blended smoothly."""
+
+        self.surface = pygame.Surface((10, 10))
+        draw.rect(self.surface, BG_RED, (0, 0, 10, 10), 0)
+
+        check_points = [(i, j) for i in range(5) for j in range(5)]
+        brown = (127, 127, 0)
+        reddish = (191, 63, 0)
+        greenish = (63, 191, 0)
+
+        # 0. identical point : current implementation does no smoothing...
+        expected = {(2, 2): FG_GREEN}
+        self._check_antialiasing(
+            (1.5, 2), (1.5, 2), expected, check_points, set_endpoints=False
+        )
+        expected = {(2, 3): FG_GREEN}
+        self._check_antialiasing(
+            (2.49, 2.7), (2.49, 2.7), expected, check_points, set_endpoints=False
+        )
+
+        # 1. horizontal lines
+        #  a) blend endpoints
+        expected = {(1, 2): brown, (2, 2): FG_GREEN}
+        self._check_antialiasing(
+            (1.5, 2), (2, 2), expected, check_points, set_endpoints=False
+        )
+        expected = {(1, 2): brown, (2, 2): FG_GREEN, (3, 2): brown}
+        self._check_antialiasing(
+            (1.5, 2), (2.5, 2), expected, check_points, set_endpoints=False
+        )
+        expected = {(2, 2): brown, (1, 2): FG_GREEN}
+        self._check_antialiasing(
+            (1, 2), (1.5, 2), expected, check_points, set_endpoints=False
+        )
+        expected = {(1, 2): brown, (2, 2): greenish}
+        self._check_antialiasing(
+            (1.5, 2), (1.75, 2), expected, check_points, set_endpoints=False
+        )
+
+        #  b) blend y-coordinate
+        expected = {(x, y): brown for x in range(2, 5) for y in (1, 2)}
+        self._check_antialiasing(
+            (2, 1.5), (4, 1.5), expected, check_points, set_endpoints=False
+        )
+
+        # 2. vertical lines
+        #  a) blend endpoints
+        expected = {(2, 1): brown, (2, 2): FG_GREEN, (2, 3): brown}
+        self._check_antialiasing(
+            (2, 1.5), (2, 2.5), expected, check_points, set_endpoints=False
+        )
+        expected = {(2, 1): brown, (2, 2): greenish}
+        self._check_antialiasing(
+            (2, 1.5), (2, 1.75), expected, check_points, set_endpoints=False
+        )
+        #  b) blend x-coordinate
+        expected = {(x, y): brown for x in (1, 2) for y in range(2, 5)}
+        self._check_antialiasing(
+            (1.5, 2), (1.5, 4), expected, check_points, set_endpoints=False
+        )
+        # 3. diagonal lines
+        #  a) blend endpoints
+        expected = {(1, 1): brown, (2, 2): FG_GREEN, (3, 3): brown}
+        self._check_antialiasing(
+            (1.5, 1.5), (2.5, 2.5), expected, check_points, set_endpoints=False
+        )
+        expected = {(3, 1): brown, (2, 2): FG_GREEN, (1, 3): brown}
+        self._check_antialiasing(
+            (2.5, 1.5), (1.5, 2.5), expected, check_points, set_endpoints=False
+        )
+        #  b) blend sidewards
+        expected = {(2, 1): brown, (2, 2): brown, (3, 2): brown, (3, 3): brown}
+        self._check_antialiasing(
+            (2, 1.5), (3, 2.5), expected, check_points, set_endpoints=False
+        )
+
+        expected = {
+            (2, 1): greenish,
+            (2, 2): reddish,
+            (3, 2): greenish,
+            (3, 3): reddish,
+            (4, 3): greenish,
+            (4, 4): reddish,
+        }
+
+        self._check_antialiasing(
+            (2, 1.25), (4, 3.25), expected, check_points, set_endpoints=False
+        )
+
+    def test_anti_aliasing_at_and_outside_the_border(self):
+        """Ensures antialiasing works correct at a surface's borders."""
+
+        self.surface = pygame.Surface((10, 10))
+        draw.rect(self.surface, BG_RED, (0, 0, 10, 10), 0)
+
+        check_points = [(i, j) for i in range(10) for j in range(10)]
+
+        reddish = (191, 63, 0)
+        brown = (127, 127, 0)
+        greenish = (63, 191, 0)
+        from_point, to_point = (3, 3), (7, 4)
+        should = {
+            (4, 3): greenish,
+            (5, 3): brown,
+            (6, 3): reddish,
+            (4, 4): reddish,
+            (5, 4): brown,
+            (6, 4): greenish,
+        }
+
+        for dx, dy in (
+            (-4, 0),
+            (4, 0),  # moved to left and right borders
+            (0, -5),
+            (0, -4),
+            (0, -3),  # upper border
+            (0, 5),
+            (0, 6),
+            (0, 7),  # lower border
+            (-4, -4),
+            (-4, -3),
+            (-3, -4),
+        ):  # upper left corner
+            first = from_point[0] + dx, from_point[1] + dy
+            second = to_point[0] + dx, to_point[1] + dy
+            expected = {(x + dx, y + dy): color for (x, y), color in should.items()}
+
+            self._check_antialiasing(first, second, expected, check_points)
+
+
+### AALines Testing ###########################################################
+
+
+class AALinesMixin(BaseLineMixin):
+    """Mixin test for drawing aalines.
+
+    This class contains all the general aalines drawing tests.
+    """
+
+    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)), 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):
+        """From pygame 2, blend=False should raise DeprecationWarning."""
+        with warnings.catch_warnings(record=True) as w:
+            # 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."""
+        surface = pygame.Surface((4, 4))
+        color = pygame.Color("yellow")
+        points = ((0, 0), (1, 1), (2, 2))
+        kwargs_list = [
+            {"surface": surface, "color": color, "closed": False, "points": points},
+        ]
+
+        for kwargs in kwargs_list:
+            bounds_rect = self.draw_aalines(**kwargs)
+
+            self.assertIsInstance(bounds_rect, pygame.Rect)
+
+    def test_aalines__kwargs_order_independent(self):
+        """Ensures draw aalines's kwargs are not order dependent."""
+        bounds_rect = self.draw_aalines(
+            closed=1,
+            points=((0, 0), (1, 1), (2, 2)),
+            color=(10, 20, 30),
+            surface=pygame.Surface((3, 2)),
+        )
+
+        self.assertIsInstance(bounds_rect, pygame.Rect)
+
+    def test_aalines__args_missing(self):
+        """Ensures draw aalines detects any missing required args."""
+        surface = pygame.Surface((1, 1))
+        color = pygame.Color("blue")
+
+        with self.assertRaises(TypeError):
+            bounds_rect = self.draw_aalines(surface, color, 0)
+
+        with self.assertRaises(TypeError):
+            bounds_rect = self.draw_aalines(surface, color)
+
+        with self.assertRaises(TypeError):
+            bounds_rect = self.draw_aalines(surface)
+
+        with self.assertRaises(TypeError):
+            bounds_rect = self.draw_aalines()
+
+    def test_aalines__kwargs_missing(self):
+        """Ensures draw aalines detects any missing required kwargs."""
+        kwargs = {
+            "surface": pygame.Surface((3, 2)),
+            "color": pygame.Color("red"),
+            "closed": 1,
+            "points": ((2, 2), (1, 1)),
+        }
+
+        for name in ("points", "closed", "color", "surface"):
+            invalid_kwargs = dict(kwargs)
+            invalid_kwargs.pop(name)  # Pop from a copy.
+
+            with self.assertRaises(TypeError):
+                bounds_rect = self.draw_aalines(**invalid_kwargs)
+
+    def test_aalines__arg_invalid_types(self):
+        """Ensures draw aalines detects invalid arg types."""
+        surface = pygame.Surface((2, 2))
+        color = pygame.Color("blue")
+        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))
+
+        with self.assertRaises(TypeError):
+            # Invalid closed.
+            bounds_rect = self.draw_aalines(surface, color, InvalidBool(), points)
+
+        with self.assertRaises(TypeError):
+            # Invalid color.
+            bounds_rect = self.draw_aalines(surface, 2.3, closed, points)
+
+        with self.assertRaises(TypeError):
+            # Invalid surface.
+            bounds_rect = self.draw_aalines((1, 2, 3, 4), color, closed, points)
+
+    def test_aalines__kwarg_invalid_types(self):
+        """Ensures draw aalines detects invalid kwarg types."""
+        valid_kwargs = {
+            "surface": pygame.Surface((3, 3)),
+            "color": pygame.Color("green"),
+            "closed": False,
+            "points": ((1, 2), (2, 1)),
+        }
+
+        invalid_kwargs = {
+            "surface": pygame.Surface,
+            "color": 2.3,
+            "closed": InvalidBool(),
+            "points": (0, 0, 0),
+        }
+
+        for kwarg in ("surface", "color", "closed", "points"):
+            kwargs = dict(valid_kwargs)
+            kwargs[kwarg] = invalid_kwargs[kwarg]
+
+            with self.assertRaises(TypeError):
+                bounds_rect = self.draw_aalines(**kwargs)
+
+    def test_aalines__kwarg_invalid_name(self):
+        """Ensures draw aalines detects invalid kwarg names."""
+        surface = pygame.Surface((2, 3))
+        color = pygame.Color("cyan")
+        closed = 1
+        points = ((1, 2), (2, 1))
+        kwargs_list = [
+            {
+                "surface": surface,
+                "color": color,
+                "closed": closed,
+                "points": points,
+                "invalid": 1,
+            },
+            {
+                "surface": surface,
+                "color": color,
+                "closed": closed,
+                "points": points,
+                "invalid": 1,
+            },
+        ]
+
+        for kwargs in kwargs_list:
+            with self.assertRaises(TypeError):
+                bounds_rect = self.draw_aalines(**kwargs)
+
+    def test_aalines__args_and_kwargs(self):
+        """Ensures draw aalines accepts a combination of args/kwargs"""
+        surface = pygame.Surface((3, 2))
+        color = (255, 255, 0, 0)
+        closed = 0
+        points = ((1, 2), (2, 1))
+        kwargs = {
+            "surface": surface,
+            "color": color,
+            "closed": closed,
+            "points": points,
+        }
+
+        for name in ("surface", "color", "closed", "points"):
+            kwargs.pop(name)
+
+            if "surface" == name:
+                bounds_rect = self.draw_aalines(surface, **kwargs)
+            elif "color" == name:
+                bounds_rect = self.draw_aalines(surface, color, **kwargs)
+            elif "closed" == name:
+                bounds_rect = self.draw_aalines(surface, color, closed, **kwargs)
+            elif "points" == name:
+                bounds_rect = self.draw_aalines(
+                    surface, color, closed, points, **kwargs
+                )
+            else:
+                bounds_rect = self.draw_aalines(
+                    surface, color, closed, points, **kwargs
+                )
+
+            self.assertIsInstance(bounds_rect, pygame.Rect)
+
+    def test_aalines__valid_points_format(self):
+        """Ensures draw aalines accepts different points formats."""
+        expected_color = (10, 20, 30, 255)
+        surface_color = pygame.Color("white")
+        surface = pygame.Surface((3, 4))
+        kwargs = {
+            "surface": surface,
+            "color": expected_color,
+            "closed": False,
+            "points": None,
+        }
+
+        # The point type can be a tuple/list/Vector2.
+        point_types = (
+            (tuple, tuple, tuple, tuple),  # all tuples
+            (list, list, list, list),  # all lists
+            (Vector2, Vector2, Vector2, Vector2),  # all Vector2s
+            (list, Vector2, tuple, Vector2),
+        )  # mix
+
+        # The point values can be ints or floats.
+        point_values = (
+            ((1, 1), (2, 1), (2, 2), (1, 2)),
+            ((1, 1), (2.2, 1), (2.1, 2.2), (1, 2.1)),
+        )
+
+        # Each sequence of points can be a tuple or a list.
+        seq_types = (tuple, list)
+
+        for point_type in point_types:
+            for values in point_values:
+                check_pos = values[0]
+                points = [point_type[i](pt) for i, pt in enumerate(values)]
+
+                for seq_type in seq_types:
+                    surface.fill(surface_color)  # Clear for each test.
+                    kwargs["points"] = seq_type(points)
+
+                    bounds_rect = self.draw_aalines(**kwargs)
+
+                    self.assertEqual(surface.get_at(check_pos), expected_color)
+                    self.assertIsInstance(bounds_rect, pygame.Rect)
+
+    def test_aalines__invalid_points_formats(self):
+        """Ensures draw aalines handles invalid points formats correctly."""
+        kwargs = {
+            "surface": pygame.Surface((4, 4)),
+            "color": pygame.Color("red"),
+            "closed": False,
+            "points": None,
+        }
+
+        points_fmts = (
+            ((1, 1), (2,)),  # Too few coords.
+            ((1, 1), (2, 2, 2)),  # Too many coords.
+            ((1, 1), (2, "2")),  # Wrong type.
+            ((1, 1), {2, 3}),  # Wrong type.
+            ((1, 1), {2: 2, 3: 3}),  # Wrong type.
+            {(1, 1), (1, 2)},  # Wrong type.
+            {1: 1, 4: 4},
+        )  # Wrong type.
+
+        for points in points_fmts:
+            kwargs["points"] = points
+
+            with self.assertRaises(TypeError):
+                bounds_rect = self.draw_aalines(**kwargs)
+
+    def test_aalines__invalid_points_values(self):
+        """Ensures draw aalines handles invalid points values correctly."""
+        kwargs = {
+            "surface": pygame.Surface((4, 4)),
+            "color": pygame.Color("red"),
+            "closed": False,
+            "points": None,
+        }
+
+        for points in ([], ((1, 1),)):  # Too few points.
+            for seq_type in (tuple, list):  # Test as tuples and lists.
+                kwargs["points"] = seq_type(points)
+
+                with self.assertRaises(ValueError):
+                    bounds_rect = self.draw_aalines(**kwargs)
+
+    def test_aalines__valid_closed_values(self):
+        """Ensures draw aalines accepts different closed values."""
+        line_color = pygame.Color("blue")
+        surface_color = pygame.Color("white")
+        surface = pygame.Surface((5, 5))
+        pos = (1, 3)
+        kwargs = {
+            "surface": surface,
+            "color": line_color,
+            "closed": None,
+            "points": ((1, 1), (4, 1), (4, 4), (1, 4)),
+        }
+
+        true_values = (-7, 1, 10, "2", 3.1, (4,), [5], True)
+        false_values = (None, "", 0, (), [], False)
+
+        for closed in true_values + false_values:
+            surface.fill(surface_color)  # Clear for each test.
+            kwargs["closed"] = closed
+            expected_color = line_color if closed else surface_color
+
+            bounds_rect = self.draw_aalines(**kwargs)
+
+            self.assertEqual(surface.get_at(pos), expected_color)
+            self.assertIsInstance(bounds_rect, pygame.Rect)
+
+    def test_aalines__valid_color_formats(self):
+        """Ensures draw aalines accepts different color formats."""
+        green_color = pygame.Color("green")
+        surface_color = pygame.Color("black")
+        surface = pygame.Surface((3, 4))
+        pos = (1, 1)
+        kwargs = {
+            "surface": surface,
+            "color": None,
+            "closed": False,
+            "points": (pos, (2, 1)),
+        }
+        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_aalines(**kwargs)
+
+            self.assertEqual(surface.get_at(pos), expected_color)
+            self.assertIsInstance(bounds_rect, pygame.Rect)
+
+    def test_aalines__invalid_color_formats(self):
+        """Ensures draw aalines handles invalid color formats correctly."""
+        kwargs = {
+            "surface": pygame.Surface((4, 3)),
+            "color": None,
+            "closed": False,
+            "points": ((1, 1), (1, 2)),
+        }
+
+        for expected_color in (2.3, self):
+            kwargs["color"] = expected_color
+
+            with self.assertRaises(TypeError):
+                bounds_rect = self.draw_aalines(**kwargs)
+
+    def test_aalines__color(self):
+        """Tests if the aalines drawn are the correct color.
+
+        Draws aalines 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():
+            for expected_color in self.COLORS:
+                self.draw_aalines(surface, expected_color, True, corners(surface))
+
+                for pos, color in border_pos_and_color(surface):
+                    self.assertEqual(color, expected_color, f"pos={pos}")
+
+    def test_aalines__gaps(self):
+        """Tests if the aalines drawn contain any gaps.
+
+        Draws aalines around the border of the given surface and checks if
+        all borders of the surface contain any gaps.
+
+        See: #512
+        """
+        expected_color = (255, 255, 255)
+        for surface in self._create_surfaces():
+            self.draw_aalines(surface, expected_color, True, corners(surface))
+
+            for pos, color in border_pos_and_color(surface):
+                self.assertEqual(color, expected_color, f"pos={pos}")
+
+    def test_aalines__bounding_rect(self):
+        """Ensures draw aalines returns the correct bounding rect.
+
+        Tests lines with endpoints on and off the surface and blending
+        enabled and disabled.
+        """
+        line_color = pygame.Color("red")
+        surf_color = pygame.Color("blue")
+        width = height = 30
+        # Using a rect to help manage where the lines are drawn.
+        pos_rect = pygame.Rect((0, 0), (width, height))
+
+        # Testing surfaces of different sizes. One larger than the pos_rect
+        # and one smaller (to test lines that span the surface).
+        for size in ((width + 5, height + 5), (width - 5, height - 5)):
+            surface = pygame.Surface(size, 0, 32)
+            surf_rect = surface.get_rect()
+
+            # Move pos_rect to different positions to test line endpoints on
+            # and off the surface.
+            for pos in rect_corners_mids_and_center(surf_rect):
+                pos_rect.center = pos
+                # Shape: Triangle (if closed), ^ caret (if not closed).
+                pts = (pos_rect.midleft, pos_rect.midtop, pos_rect.midright)
+                pos = pts[0]  # Rect position if nothing drawn.
+
+                for closed in (True, False):
+                    surface.fill(surf_color)  # Clear for each test.
+
+                    bounding_rect = self.draw_aalines(surface, line_color, closed, pts)
+
+                    # Calculating the expected_rect after the lines are
+                    # drawn (it uses what is actually drawn).
+                    expected_rect = create_bounding_rect(surface, surf_color, pos)
+
+                    self.assertEqual(bounding_rect, expected_rect)
+
+    def test_aalines__surface_clip(self):
+        """Ensures draw aalines respects a surface's clip area."""
+        surfw = surfh = 30
+        aaline_color = pygame.Color("red")
+        surface_color = pygame.Color("green")
+        surface = pygame.Surface((surfw, surfh))
+        surface.fill(surface_color)
+
+        clip_rect = pygame.Rect((0, 0), (11, 11))
+        clip_rect.center = surface.get_rect().center
+        pos_rect = clip_rect.copy()  # Manages the aalines's pos.
+
+        # Test centering the pos_rect along the clip rect's edge to allow for
+        # drawing the aalines over the clip_rect's bounds.
+        for center in rect_corners_mids_and_center(clip_rect):
+            pos_rect.center = center
+            pts = (pos_rect.midtop, pos_rect.center, pos_rect.midbottom)
+            for closed in (True, False):  # Test closed and not closed.
+                # Get the expected points by drawing the aalines without
+                # the clip area set.
+                surface.set_clip(None)
+                surface.fill(surface_color)
+                self.draw_aalines(surface, aaline_color, closed, pts)
+
+                expected_pts = get_color_points(
+                    surface, surface_color, clip_rect, False
+                )
+
+                # Clear the surface and set the clip area. Redraw the
+                # aalines and check that only the clip area is modified.
+                surface.fill(surface_color)
+                surface.set_clip(clip_rect)
+
+                self.draw_aalines(surface, aaline_color, closed, pts)
+
+                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, pt)
+                    else:
+                        self.assertEqual(surface.get_at(pt), surface_color, pt)
+
+                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.
+
+    This class inherits the general tests from AALinesMixin. It is also the
+    class to add any draw.aalines specific tests to.
+    """
+
+
+### Polygon Testing ###########################################################
+
+SQUARE = ([0, 0], [3, 0], [3, 3], [0, 3])
+DIAMOND = [(1, 3), (3, 5), (5, 3), (3, 1)]
+CROSS = (
+    [2, 0],
+    [4, 0],
+    [4, 2],
+    [6, 2],
+    [6, 4],
+    [4, 4],
+    [4, 6],
+    [2, 6],
+    [2, 4],
+    [0, 4],
+    [0, 2],
+    [2, 2],
+)
+
+
+class DrawPolygonMixin:
+    """Mixin tests for drawing polygons.
+
+    This class contains all the general polygon drawing tests.
+    """
+
+    def setUp(self):
+        self.surface = pygame.Surface((20, 20))
+
+    def test_polygon__args(self):
+        """Ensures draw polygon accepts the correct args."""
+        bounds_rect = self.draw_polygon(
+            pygame.Surface((3, 3)), (0, 10, 0, 50), ((0, 0), (1, 1), (2, 2)), 1
+        )
+
+        self.assertIsInstance(bounds_rect, pygame.Rect)
+
+    def test_polygon__args_without_width(self):
+        """Ensures draw polygon accepts the args without a width."""
+        bounds_rect = self.draw_polygon(
+            pygame.Surface((2, 2)), (0, 0, 0, 50), ((0, 0), (1, 1), (2, 2))
+        )
+
+        self.assertIsInstance(bounds_rect, pygame.Rect)
+
+    def test_polygon__kwargs(self):
+        """Ensures draw polygon accepts the correct kwargs
+        with and without a width arg.
+        """
+        surface = pygame.Surface((4, 4))
+        color = pygame.Color("yellow")
+        points = ((0, 0), (1, 1), (2, 2))
+        kwargs_list = [
+            {"surface": surface, "color": color, "points": points, "width": 1},
+            {"surface": surface, "color": color, "points": points},
+        ]
+
+        for kwargs in kwargs_list:
+            bounds_rect = self.draw_polygon(**kwargs)
+
+            self.assertIsInstance(bounds_rect, pygame.Rect)
+
+    def test_polygon__kwargs_order_independent(self):
+        """Ensures draw polygon's kwargs are not order dependent."""
+        bounds_rect = self.draw_polygon(
+            color=(10, 20, 30),
+            surface=pygame.Surface((3, 2)),
+            width=0,
+            points=((0, 1), (1, 2), (2, 3)),
+        )
+
+        self.assertIsInstance(bounds_rect, pygame.Rect)
+
+    def test_polygon__args_missing(self):
+        """Ensures draw polygon detects any missing required args."""
+        surface = pygame.Surface((1, 1))
+        color = pygame.Color("blue")
+
+        with self.assertRaises(TypeError):
+            bounds_rect = self.draw_polygon(surface, color)
+
+        with self.assertRaises(TypeError):
+            bounds_rect = self.draw_polygon(surface)
+
+        with self.assertRaises(TypeError):
+            bounds_rect = self.draw_polygon()
+
+    def test_polygon__kwargs_missing(self):
+        """Ensures draw polygon detects any missing required kwargs."""
+        kwargs = {
+            "surface": pygame.Surface((1, 2)),
+            "color": pygame.Color("red"),
+            "points": ((2, 1), (2, 2), (2, 3)),
+            "width": 1,
+        }
+
+        for name in ("points", "color", "surface"):
+            invalid_kwargs = dict(kwargs)
+            invalid_kwargs.pop(name)  # Pop from a copy.
+
+            with self.assertRaises(TypeError):
+                bounds_rect = self.draw_polygon(**invalid_kwargs)
+
+    def test_polygon__arg_invalid_types(self):
+        """Ensures draw polygon detects invalid arg types."""
+        surface = pygame.Surface((2, 2))
+        color = pygame.Color("blue")
+        points = ((0, 1), (1, 2), (1, 3))
+
+        with self.assertRaises(TypeError):
+            # Invalid width.
+            bounds_rect = self.draw_polygon(surface, color, points, "1")
+
+        with self.assertRaises(TypeError):
+            # Invalid points.
+            bounds_rect = self.draw_polygon(surface, color, (1, 2, 3))
+
+        with self.assertRaises(TypeError):
+            # Invalid color.
+            bounds_rect = self.draw_polygon(surface, 2.3, points)
+
+        with self.assertRaises(TypeError):
+            # Invalid surface.
+            bounds_rect = self.draw_polygon((1, 2, 3, 4), color, points)
+
+    def test_polygon__kwarg_invalid_types(self):
+        """Ensures draw polygon detects invalid kwarg types."""
+        surface = pygame.Surface((3, 3))
+        color = pygame.Color("green")
+        points = ((0, 0), (1, 0), (2, 0))
+        width = 1
+        kwargs_list = [
+            {
+                "surface": pygame.Surface,  # Invalid surface.
+                "color": color,
+                "points": points,
+                "width": width,
+            },
+            {
+                "surface": surface,
+                "color": 2.3,  # Invalid color.
+                "points": points,
+                "width": width,
+            },
+            {
+                "surface": surface,
+                "color": color,
+                "points": ((1,), (1,), (1,)),  # Invalid points.
+                "width": width,
+            },
+            {"surface": surface, "color": color, "points": points, "width": 1.2},
+        ]  # Invalid width.
+
+        for kwargs in kwargs_list:
+            with self.assertRaises(TypeError):
+                bounds_rect = self.draw_polygon(**kwargs)
+
+    def test_polygon__kwarg_invalid_name(self):
+        """Ensures draw polygon detects invalid kwarg names."""
+        surface = pygame.Surface((2, 3))
+        color = pygame.Color("cyan")
+        points = ((1, 1), (1, 2), (1, 3))
+        kwargs_list = [
+            {
+                "surface": surface,
+                "color": color,
+                "points": points,
+                "width": 1,
+                "invalid": 1,
+            },
+            {"surface": surface, "color": color, "points": points, "invalid": 1},
+        ]
+
+        for kwargs in kwargs_list:
+            with self.assertRaises(TypeError):
+                bounds_rect = self.draw_polygon(**kwargs)
+
+    def test_polygon__args_and_kwargs(self):
+        """Ensures draw polygon accepts a combination of args/kwargs"""
+        surface = pygame.Surface((3, 1))
+        color = (255, 255, 0, 0)
+        points = ((0, 1), (1, 2), (2, 3))
+        width = 0
+        kwargs = {"surface": surface, "color": color, "points": points, "width": width}
+
+        for name in ("surface", "color", "points", "width"):
+            kwargs.pop(name)
+
+            if "surface" == name:
+                bounds_rect = self.draw_polygon(surface, **kwargs)
+            elif "color" == name:
+                bounds_rect = self.draw_polygon(surface, color, **kwargs)
+            elif "points" == name:
+                bounds_rect = self.draw_polygon(surface, color, points, **kwargs)
+            else:
+                bounds_rect = self.draw_polygon(surface, color, points, width, **kwargs)
+
+            self.assertIsInstance(bounds_rect, pygame.Rect)
+
+    def test_polygon__valid_width_values(self):
+        """Ensures draw polygon accepts different width values."""
+        surface_color = pygame.Color("white")
+        surface = pygame.Surface((3, 4))
+        color = (10, 20, 30, 255)
+        kwargs = {
+            "surface": surface,
+            "color": color,
+            "points": ((1, 1), (2, 1), (2, 2), (1, 2)),
+            "width": None,
+        }
+        pos = kwargs["points"][0]
+
+        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_polygon(**kwargs)
+
+            self.assertEqual(surface.get_at(pos), expected_color)
+            self.assertIsInstance(bounds_rect, pygame.Rect)
+
+    def test_polygon__valid_points_format(self):
+        """Ensures draw polygon accepts different points formats."""
+        expected_color = (10, 20, 30, 255)
+        surface_color = pygame.Color("white")
+        surface = pygame.Surface((3, 4))
+        kwargs = {
+            "surface": surface,
+            "color": expected_color,
+            "points": None,
+            "width": 0,
+        }
+
+        # The point type can be a tuple/list/Vector2.
+        point_types = (
+            (tuple, tuple, tuple, tuple),  # all tuples
+            (list, list, list, list),  # all lists
+            (Vector2, Vector2, Vector2, Vector2),  # all Vector2s
+            (list, Vector2, tuple, Vector2),
+        )  # mix
+
+        # The point values can be ints or floats.
+        point_values = (
+            ((1, 1), (2, 1), (2, 2), (1, 2)),
+            ((1, 1), (2.2, 1), (2.1, 2.2), (1, 2.1)),
+        )
+
+        # Each sequence of points can be a tuple or a list.
+        seq_types = (tuple, list)
+
+        for point_type in point_types:
+            for values in point_values:
+                check_pos = values[0]
+                points = [point_type[i](pt) for i, pt in enumerate(values)]
+
+                for seq_type in seq_types:
+                    surface.fill(surface_color)  # Clear for each test.
+                    kwargs["points"] = seq_type(points)
+
+                    bounds_rect = self.draw_polygon(**kwargs)
+
+                    self.assertEqual(surface.get_at(check_pos), expected_color)
+                    self.assertIsInstance(bounds_rect, pygame.Rect)
+
+    def test_polygon__invalid_points_formats(self):
+        """Ensures draw polygon handles invalid points formats correctly."""
+        kwargs = {
+            "surface": pygame.Surface((4, 4)),
+            "color": pygame.Color("red"),
+            "points": None,
+            "width": 0,
+        }
+
+        points_fmts = (
+            ((1, 1), (2, 1), (2,)),  # Too few coords.
+            ((1, 1), (2, 1), (2, 2, 2)),  # Too many coords.
+            ((1, 1), (2, 1), (2, "2")),  # Wrong type.
+            ((1, 1), (2, 1), {2, 3}),  # Wrong type.
+            ((1, 1), (2, 1), {2: 2, 3: 3}),  # Wrong type.
+            {(1, 1), (2, 1), (2, 2), (1, 2)},  # Wrong type.
+            {1: 1, 2: 2, 3: 3, 4: 4},
+        )  # Wrong type.
+
+        for points in points_fmts:
+            kwargs["points"] = points
+
+            with self.assertRaises(TypeError):
+                bounds_rect = self.draw_polygon(**kwargs)
+
+    def test_polygon__invalid_points_values(self):
+        """Ensures draw polygon handles invalid points values correctly."""
+        kwargs = {
+            "surface": pygame.Surface((4, 4)),
+            "color": pygame.Color("red"),
+            "points": None,
+            "width": 0,
+        }
+
+        points_fmts = (
+            (),  # Too few points.
+            ((1, 1),),  # Too few points.
+            ((1, 1), (2, 1)),
+        )  # Too few points.
+
+        for points in points_fmts:
+            for seq_type in (tuple, list):  # Test as tuples and lists.
+                kwargs["points"] = seq_type(points)
+
+                with self.assertRaises(ValueError):
+                    bounds_rect = self.draw_polygon(**kwargs)
+
+    def test_polygon__valid_color_formats(self):
+        """Ensures draw polygon accepts different color formats."""
+        green_color = pygame.Color("green")
+        surface_color = pygame.Color("black")
+        surface = pygame.Surface((3, 4))
+        kwargs = {
+            "surface": surface,
+            "color": None,
+            "points": ((1, 1), (2, 1), (2, 2), (1, 2)),
+            "width": 0,
+        }
+        pos = kwargs["points"][0]
+        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_polygon(**kwargs)
+
+            self.assertEqual(surface.get_at(pos), expected_color)
+            self.assertIsInstance(bounds_rect, pygame.Rect)
+
+    def test_polygon__invalid_color_formats(self):
+        """Ensures draw polygon handles invalid color formats correctly."""
+        kwargs = {
+            "surface": pygame.Surface((4, 3)),
+            "color": None,
+            "points": ((1, 1), (2, 1), (2, 2), (1, 2)),
+            "width": 0,
+        }
+
+        for expected_color in (2.3, self):
+            kwargs["color"] = expected_color
+
+            with self.assertRaises(TypeError):
+                bounds_rect = self.draw_polygon(**kwargs)
+
+    def test_draw_square(self):
+        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,
+        # eg include those borders ...
+        for x in range(4):
+            for y in range(4):
+                self.assertEqual(self.surface.get_at((x, y)), RED)
+
+    def test_draw_diamond(self):
+        pygame.draw.rect(self.surface, RED, (0, 0, 10, 10), 0)
+        self.draw_polygon(self.surface, GREEN, DIAMOND, 0)
+        # this diamond shape is equivalent to its four corners, plus inner square
+        for x, y in DIAMOND:
+            self.assertEqual(self.surface.get_at((x, y)), GREEN, msg=str((x, y)))
+        for x in range(2, 5):
+            for y in range(2, 5):
+                self.assertEqual(self.surface.get_at((x, y)), GREEN)
+
+    def test_1_pixel_high_or_wide_shapes(self):
+        # 1. one-pixel-high, filled
+        pygame.draw.rect(self.surface, RED, (0, 0, 10, 10), 0)
+        self.draw_polygon(self.surface, GREEN, [(x, 2) for x, _y in CROSS], 0)
+        cross_size = 6  # the maximum x or y coordinate of the cross
+        for x in range(cross_size + 1):
+            self.assertEqual(self.surface.get_at((x, 1)), RED)
+            self.assertEqual(self.surface.get_at((x, 2)), GREEN)
+            self.assertEqual(self.surface.get_at((x, 3)), RED)
+        pygame.draw.rect(self.surface, RED, (0, 0, 10, 10), 0)
+        # 2. one-pixel-high, not filled
+        self.draw_polygon(self.surface, GREEN, [(x, 5) for x, _y in CROSS], 1)
+        for x in range(cross_size + 1):
+            self.assertEqual(self.surface.get_at((x, 4)), RED)
+            self.assertEqual(self.surface.get_at((x, 5)), GREEN)
+            self.assertEqual(self.surface.get_at((x, 6)), RED)
+        pygame.draw.rect(self.surface, RED, (0, 0, 10, 10), 0)
+        # 3. one-pixel-wide, filled
+        self.draw_polygon(self.surface, GREEN, [(3, y) for _x, y in CROSS], 0)
+        for y in range(cross_size + 1):
+            self.assertEqual(self.surface.get_at((2, y)), RED)
+            self.assertEqual(self.surface.get_at((3, y)), GREEN)
+            self.assertEqual(self.surface.get_at((4, y)), RED)
+        pygame.draw.rect(self.surface, RED, (0, 0, 10, 10), 0)
+        # 4. one-pixel-wide, not filled
+        self.draw_polygon(self.surface, GREEN, [(4, y) for _x, y in CROSS], 1)
+        for y in range(cross_size + 1):
+            self.assertEqual(self.surface.get_at((3, y)), RED)
+            self.assertEqual(self.surface.get_at((4, y)), GREEN)
+            self.assertEqual(self.surface.get_at((5, y)), RED)
+
+    def test_draw_symetric_cross(self):
+        """non-regression on issue #234 : x and y where handled inconsistently.
+
+        Also, the result is/was different whether we fill or not the polygon.
+        """
+        # 1. case width = 1 (not filled: `polygon` calls  internally the `lines` function)
+        pygame.draw.rect(self.surface, RED, (0, 0, 10, 10), 0)
+        self.draw_polygon(self.surface, GREEN, CROSS, 1)
+        inside = [(x, 3) for x in range(1, 6)] + [(3, y) for y in range(1, 6)]
+        for x in range(10):
+            for y in range(10):
+                if (x, y) in inside:
+                    self.assertEqual(self.surface.get_at((x, y)), RED)
+                elif (x in range(2, 5) and y < 7) or (y in range(2, 5) and x < 7):
+                    # we are on the border of the cross:
+                    self.assertEqual(self.surface.get_at((x, y)), GREEN)
+                else:
+                    # we are outside
+                    self.assertEqual(self.surface.get_at((x, y)), RED)
+
+        # 2. case width = 0 (filled; this is the example from #234)
+        pygame.draw.rect(self.surface, RED, (0, 0, 10, 10), 0)
+        self.draw_polygon(self.surface, GREEN, CROSS, 0)
+        inside = [(x, 3) for x in range(1, 6)] + [(3, y) for y in range(1, 6)]
+        for x in range(10):
+            for y in range(10):
+                if (x in range(2, 5) and y < 7) or (y in range(2, 5) and x < 7):
+                    # we are on the border of the cross:
+                    self.assertEqual(
+                        self.surface.get_at((x, y)), GREEN, msg=str((x, y))
+                    )
+                else:
+                    # we are outside
+                    self.assertEqual(self.surface.get_at((x, y)), RED)
+
+    def test_illumine_shape(self):
+        """non-regression on issue #313"""
+        rect = pygame.Rect((0, 0, 20, 20))
+        path_data = [
+            (0, 0),
+            (rect.width - 1, 0),  # upper border
+            (rect.width - 5, 5 - 1),
+            (5 - 1, 5 - 1),  # upper inner
+            (5 - 1, rect.height - 5),
+            (0, rect.height - 1),
+        ]  # lower diagonal
+        # The shape looks like this (the numbers are the indices of path_data)
+
+        # 0**********************1              <-- upper border
+        # ***********************
+        # **********************
+        # *********************
+        # ****3**************2                  <-- upper inner border
+        # *****
+        # *****                   (more lines here)
+        # *****
+        # ****4
+        # ****
+        # ***
+        # **
+        # 5
+        #
+
+        # the current bug is that the "upper inner" line is not drawn, but only
+        # if 4 or some lower corner exists
+        pygame.draw.rect(self.surface, RED, (0, 0, 20, 20), 0)
+
+        # 1. First without the corners 4 & 5
+        self.draw_polygon(self.surface, GREEN, path_data[:4], 0)
+        for x in range(20):
+            self.assertEqual(self.surface.get_at((x, 0)), GREEN)  # upper border
+        for x in range(4, rect.width - 5 + 1):
+            self.assertEqual(self.surface.get_at((x, 4)), GREEN)  # upper inner
+
+        # 2. with the corners 4 & 5
+        pygame.draw.rect(self.surface, RED, (0, 0, 20, 20), 0)
+        self.draw_polygon(self.surface, GREEN, path_data, 0)
+        for x in range(4, rect.width - 5 + 1):
+            self.assertEqual(self.surface.get_at((x, 4)), GREEN)  # upper inner
+
+    def test_invalid_points(self):
+        self.assertRaises(
+            TypeError,
+            lambda: self.draw_polygon(
+                self.surface, RED, ((0, 0), (0, 20), (20, 20), 20), 0
+            ),
+        )
+
+    def test_polygon__bounding_rect(self):
+        """Ensures draw polygon returns the correct bounding rect.
+
+        Tests polygons on and off the surface and a range of width/thickness
+        values.
+        """
+        polygon_color = pygame.Color("red")
+        surf_color = pygame.Color("black")
+        min_width = min_height = 5
+        max_width = max_height = 7
+        sizes = ((min_width, min_height), (max_width, max_height))
+        surface = pygame.Surface((20, 20), 0, 32)
+        surf_rect = surface.get_rect()
+        # Make a rect that is bigger than the surface to help test drawing
+        # polygons off and partially off the surface.
+        big_rect = surf_rect.inflate(min_width * 2 + 1, min_height * 2 + 1)
+
+        for pos in rect_corners_mids_and_center(
+            surf_rect
+        ) + rect_corners_mids_and_center(big_rect):
+            # A rect (pos_rect) is used to help create and position the
+            # polygon. Each of this rect's position attributes will be set to
+            # the pos value.
+            for attr in RECT_POSITION_ATTRIBUTES:
+                # Test using different rect sizes and thickness values.
+                for width, height in sizes:
+                    pos_rect = pygame.Rect((0, 0), (width, height))
+                    setattr(pos_rect, attr, pos)
+                    # Points form a triangle with no fully
+                    # horizontal/vertical lines.
+                    vertices = (
+                        pos_rect.midleft,
+                        pos_rect.midtop,
+                        pos_rect.bottomright,
+                    )
+
+                    for thickness in range(4):
+                        surface.fill(surf_color)  # Clear for each test.
+
+                        bounding_rect = self.draw_polygon(
+                            surface, polygon_color, vertices, thickness
+                        )
+
+                        # Calculating the expected_rect after the polygon
+                        # is drawn (it uses what is actually drawn).
+                        expected_rect = create_bounding_rect(
+                            surface, surf_color, vertices[0]
+                        )
+
+                        self.assertEqual(
+                            bounding_rect,
+                            expected_rect,
+                            f"thickness={thickness}",
+                        )
+
+    def test_polygon__surface_clip(self):
+        """Ensures draw polygon respects a surface's clip area.
+
+        Tests drawing the polygon filled and unfilled.
+        """
+        surfw = surfh = 30
+        polygon_color = pygame.Color("red")
+        surface_color = pygame.Color("green")
+        surface = pygame.Surface((surfw, surfh))
+        surface.fill(surface_color)
+
+        clip_rect = pygame.Rect((0, 0), (8, 10))
+        clip_rect.center = surface.get_rect().center
+        pos_rect = clip_rect.copy()  # Manages the polygon's pos.
+
+        for width in (0, 1):  # Filled and unfilled.
+            # Test centering the polygon along the clip rect's edge.
+            for center in rect_corners_mids_and_center(clip_rect):
+                # Get the expected points by drawing the polygon without the
+                # clip area set.
+                pos_rect.center = center
+                vertices = (
+                    pos_rect.topleft,
+                    pos_rect.topright,
+                    pos_rect.bottomright,
+                    pos_rect.bottomleft,
+                )
+                surface.set_clip(None)
+                surface.fill(surface_color)
+                self.draw_polygon(surface, polygon_color, vertices, width)
+                expected_pts = get_color_points(surface, polygon_color, clip_rect)
+
+                # Clear the surface and set the clip area. Redraw the polygon
+                # and check that only the clip area is modified.
+                surface.fill(surface_color)
+                surface.set_clip(clip_rect)
+
+                self.draw_polygon(surface, polygon_color, vertices, width)
+
+                surface.lock()  # For possible speed up.
+
+                # Check all the surface points to ensure only the expected_pts
+                # are the polygon_color.
+                for pt in ((x, y) for x in range(surfw) for y in range(surfh)):
+                    if pt in expected_pts:
+                        expected_color = polygon_color
+                    else:
+                        expected_color = surface_color
+
+                    self.assertEqual(surface.get_at(pt), expected_color, pt)
+
+                surface.unlock()
+
+    # Test cases for Issue #3989 (fixed on #4191)
+    # This tests the fill polygon bug to avoid
+    def test_polygon_large_coords_3989(self):
+        """
+        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):
+    """Test draw module function polygon.
+
+    This class inherits the general tests from DrawPolygonMixin. It is also
+    the class to add any draw.polygon specific tests to.
+    """
+
+
+# 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 ##############################################################
+
+
+class DrawRectMixin:
+    """Mixin tests for drawing rects.
+
+    This class contains all the general rect drawing tests.
+    """
+
+    def test_rect__args(self):
+        """Ensures draw rect accepts the correct args."""
+        bounds_rect = self.draw_rect(
+            pygame.Surface((2, 2)),
+            (20, 10, 20, 150),
+            pygame.Rect((0, 0), (1, 1)),
+            2,
+            1,
+            2,
+            3,
+            4,
+            5,
+        )
+
+        self.assertIsInstance(bounds_rect, pygame.Rect)
+
+    def test_rect__args_without_width(self):
+        """Ensures draw rect accepts the args without a width and borders."""
+        bounds_rect = self.draw_rect(
+            pygame.Surface((3, 5)), (0, 0, 0, 255), pygame.Rect((0, 0), (1, 1))
+        )
+
+        self.assertIsInstance(bounds_rect, pygame.Rect)
+
+    def test_rect__kwargs(self):
+        """Ensures draw rect accepts the correct kwargs
+        with and without a width and border_radius arg.
+        """
+        kwargs_list = [
+            {
+                "surface": pygame.Surface((5, 5)),
+                "color": pygame.Color("red"),
+                "rect": pygame.Rect((0, 0), (1, 2)),
+                "width": 1,
+                "border_radius": 10,
+                "border_top_left_radius": 5,
+                "border_top_right_radius": 20,
+                "border_bottom_left_radius": 15,
+                "border_bottom_right_radius": 0,
+            },
+            {
+                "surface": pygame.Surface((1, 2)),
+                "color": (0, 100, 200),
+                "rect": (0, 0, 1, 1),
+            },
+        ]
+
+        for kwargs in kwargs_list:
+            bounds_rect = self.draw_rect(**kwargs)
+
+            self.assertIsInstance(bounds_rect, pygame.Rect)
+
+    def test_rect__kwargs_order_independent(self):
+        """Ensures draw rect's kwargs are not order dependent."""
+        bounds_rect = self.draw_rect(
+            color=(0, 1, 2),
+            border_radius=10,
+            surface=pygame.Surface((2, 3)),
+            border_top_left_radius=5,
+            width=-2,
+            border_top_right_radius=20,
+            border_bottom_right_radius=0,
+            rect=pygame.Rect((0, 0), (0, 0)),
+            border_bottom_left_radius=15,
+        )
+
+        self.assertIsInstance(bounds_rect, pygame.Rect)
+
+    def test_rect__args_missing(self):
+        """Ensures draw rect detects any missing required args."""
+        surface = pygame.Surface((1, 1))
+
+        with self.assertRaises(TypeError):
+            bounds_rect = self.draw_rect(surface, pygame.Color("white"))
+
+        with self.assertRaises(TypeError):
+            bounds_rect = self.draw_rect(surface)
+
+        with self.assertRaises(TypeError):
+            bounds_rect = self.draw_rect()
+
+    def test_rect__kwargs_missing(self):
+        """Ensures draw rect detects any missing required kwargs."""
+        kwargs = {
+            "surface": pygame.Surface((1, 3)),
+            "color": pygame.Color("red"),
+            "rect": pygame.Rect((0, 0), (2, 2)),
+            "width": 5,
+            "border_radius": 10,
+            "border_top_left_radius": 5,
+            "border_top_right_radius": 20,
+            "border_bottom_left_radius": 15,
+            "border_bottom_right_radius": 0,
+        }
+
+        for name in ("rect", "color", "surface"):
+            invalid_kwargs = dict(kwargs)
+            invalid_kwargs.pop(name)  # Pop from a copy.
+
+            with self.assertRaises(TypeError):
+                bounds_rect = self.draw_rect(**invalid_kwargs)
+
+    def test_rect__arg_invalid_types(self):
+        """Ensures draw rect detects invalid arg types."""
+        surface = pygame.Surface((3, 3))
+        color = pygame.Color("white")
+        rect = pygame.Rect((1, 1), (1, 1))
+
+        with self.assertRaises(TypeError):
+            # Invalid border_bottom_right_radius.
+            bounds_rect = self.draw_rect(
+                surface, color, rect, 2, border_bottom_right_radius="rad"
+            )
+
+        with self.assertRaises(TypeError):
+            # Invalid border_bottom_left_radius.
+            bounds_rect = self.draw_rect(
+                surface, color, rect, 2, border_bottom_left_radius="rad"
+            )
+
+        with self.assertRaises(TypeError):
+            # Invalid border_top_right_radius.
+            bounds_rect = self.draw_rect(
+                surface, color, rect, 2, border_top_right_radius="rad"
+            )
+
+        with self.assertRaises(TypeError):
+            # Invalid border_top_left_radius.
+            bounds_rect = self.draw_rect(
+                surface, color, rect, 2, border_top_left_radius="draw"
+            )
+
+        with self.assertRaises(TypeError):
+            # Invalid border_radius.
+            bounds_rect = self.draw_rect(surface, color, rect, 2, "rad")
+
+        with self.assertRaises(TypeError):
+            # Invalid width.
+            bounds_rect = self.draw_rect(surface, color, rect, "2", 4)
+
+        with self.assertRaises(TypeError):
+            # Invalid rect.
+            bounds_rect = self.draw_rect(surface, color, (1, 2, 3), 2, 6)
+
+        with self.assertRaises(TypeError):
+            # Invalid color.
+            bounds_rect = self.draw_rect(surface, 2.3, rect, 3, 8)
+
+        with self.assertRaises(TypeError):
+            # Invalid surface.
+            bounds_rect = self.draw_rect(rect, color, rect, 4, 10)
+
+    def test_rect__kwarg_invalid_types(self):
+        """Ensures draw rect detects invalid kwarg types."""
+        surface = pygame.Surface((2, 3))
+        color = pygame.Color("red")
+        rect = pygame.Rect((0, 0), (1, 1))
+        kwargs_list = [
+            {
+                "surface": pygame.Surface,  # Invalid surface.
+                "color": color,
+                "rect": rect,
+                "width": 1,
+                "border_radius": 10,
+                "border_top_left_radius": 5,
+                "border_top_right_radius": 20,
+                "border_bottom_left_radius": 15,
+                "border_bottom_right_radius": 0,
+            },
+            {
+                "surface": surface,
+                "color": 2.3,  # Invalid color.
+                "rect": rect,
+                "width": 1,
+                "border_radius": 10,
+                "border_top_left_radius": 5,
+                "border_top_right_radius": 20,
+                "border_bottom_left_radius": 15,
+                "border_bottom_right_radius": 0,
+            },
+            {
+                "surface": surface,
+                "color": color,
+                "rect": (1, 1, 2),  # Invalid rect.
+                "width": 1,
+                "border_radius": 10,
+                "border_top_left_radius": 5,
+                "border_top_right_radius": 20,
+                "border_bottom_left_radius": 15,
+                "border_bottom_right_radius": 0,
+            },
+            {
+                "surface": surface,
+                "color": color,
+                "rect": rect,
+                "width": 1.1,  # Invalid width.
+                "border_radius": 10,
+                "border_top_left_radius": 5,
+                "border_top_right_radius": 20,
+                "border_bottom_left_radius": 15,
+                "border_bottom_right_radius": 0,
+            },
+            {
+                "surface": surface,
+                "color": color,
+                "rect": rect,
+                "width": 1,
+                "border_radius": 10.5,  # Invalid border_radius.
+                "border_top_left_radius": 5,
+                "border_top_right_radius": 20,
+                "border_bottom_left_radius": 15,
+                "border_bottom_right_radius": 0,
+            },
+            {
+                "surface": surface,
+                "color": color,
+                "rect": rect,
+                "width": 1,
+                "border_radius": 10,
+                "border_top_left_radius": 5.5,  # Invalid top_left_radius.
+                "border_top_right_radius": 20,
+                "border_bottom_left_radius": 15,
+                "border_bottom_right_radius": 0,
+            },
+            {
+                "surface": surface,
+                "color": color,
+                "rect": rect,
+                "width": 1,
+                "border_radius": 10,
+                "border_top_left_radius": 5,
+                "border_top_right_radius": "a",  # Invalid top_right_radius.
+                "border_bottom_left_radius": 15,
+                "border_bottom_right_radius": 0,
+            },
+            {
+                "surface": surface,
+                "color": color,
+                "rect": rect,
+                "width": 1,
+                "border_radius": 10,
+                "border_top_left_radius": 5,
+                "border_top_right_radius": 20,
+                "border_bottom_left_radius": "c",  # Invalid bottom_left_radius
+                "border_bottom_right_radius": 0,
+            },
+            {
+                "surface": surface,
+                "color": color,
+                "rect": rect,
+                "width": 1,
+                "border_radius": 10,
+                "border_top_left_radius": 5,
+                "border_top_right_radius": 20,
+                "border_bottom_left_radius": 15,
+                "border_bottom_right_radius": "d",  # Invalid bottom_right.
+            },
+        ]
+
+        for kwargs in kwargs_list:
+            with self.assertRaises(TypeError):
+                bounds_rect = self.draw_rect(**kwargs)
+
+    def test_rect__kwarg_invalid_name(self):
+        """Ensures draw rect detects invalid kwarg names."""
+        surface = pygame.Surface((2, 1))
+        color = pygame.Color("green")
+        rect = pygame.Rect((0, 0), (3, 3))
+        kwargs_list = [
+            {
+                "surface": surface,
+                "color": color,
+                "rect": rect,
+                "width": 1,
+                "border_radius": 10,
+                "border_top_left_radius": 5,
+                "border_top_right_radius": 20,
+                "border_bottom_left_radius": 15,
+                "border_bottom_right_radius": 0,
+                "invalid": 1,
+            },
+            {"surface": surface, "color": color, "rect": rect, "invalid": 1},
+        ]
+
+        for kwargs in kwargs_list:
+            with self.assertRaises(TypeError):
+                bounds_rect = self.draw_rect(**kwargs)
+
+    def test_rect__args_and_kwargs(self):
+        """Ensures draw rect accepts a combination of args/kwargs"""
+        surface = pygame.Surface((3, 1))
+        color = (255, 255, 255, 0)
+        rect = pygame.Rect((1, 0), (2, 5))
+        width = 0
+        kwargs = {"surface": surface, "color": color, "rect": rect, "width": width}
+
+        for name in ("surface", "color", "rect", "width"):
+            kwargs.pop(name)
+
+            if "surface" == name:
+                bounds_rect = self.draw_rect(surface, **kwargs)
+            elif "color" == name:
+                bounds_rect = self.draw_rect(surface, color, **kwargs)
+            elif "rect" == name:
+                bounds_rect = self.draw_rect(surface, color, rect, **kwargs)
+            else:
+                bounds_rect = self.draw_rect(surface, color, rect, width, **kwargs)
+            self.assertIsInstance(bounds_rect, pygame.Rect)
+
+    def test_rect__valid_width_values(self):
+        """Ensures draw rect accepts different width values."""
+        pos = (1, 1)
+        surface_color = pygame.Color("black")
+        surface = pygame.Surface((3, 4))
+        color = (1, 2, 3, 255)
+        kwargs = {
+            "surface": surface,
+            "color": color,
+            "rect": pygame.Rect(pos, (2, 2)),
+            "width": None,
+        }
+
+        for width in (-1000, -10, -1, 0, 1, 10, 1000):
+            surface.fill(surface_color)  # Clear for each test.
+            kwargs["width"] = width
+            expected_color = color if width >= 0 else surface_color
+
+            bounds_rect = self.draw_rect(**kwargs)
+
+            self.assertEqual(surface.get_at(pos), expected_color)
+            self.assertIsInstance(bounds_rect, pygame.Rect)
+
+    def test_rect__valid_rect_formats(self):
+        """Ensures draw rect accepts different rect formats."""
+        pos = (1, 1)
+        expected_color = pygame.Color("yellow")
+        surface_color = pygame.Color("black")
+        surface = pygame.Surface((3, 4))
+        kwargs = {"surface": surface, "color": expected_color, "rect": None, "width": 0}
+        rects = (
+            pygame.Rect(pos, (1, 1)),
+            (pos, (2, 2)),
+            (pos[0], pos[1], 3, 3),
+            [pos, (2.1, 2.2)],
+        )
+
+        for rect in rects:
+            surface.fill(surface_color)  # Clear for each test.
+            kwargs["rect"] = rect
+
+            bounds_rect = self.draw_rect(**kwargs)
+
+            self.assertEqual(surface.get_at(pos), expected_color)
+            self.assertIsInstance(bounds_rect, pygame.Rect)
+
+    def test_rect__invalid_rect_formats(self):
+        """Ensures draw rect handles invalid rect formats correctly."""
+        kwargs = {
+            "surface": pygame.Surface((4, 4)),
+            "color": pygame.Color("red"),
+            "rect": None,
+            "width": 0,
+        }
+
+        invalid_fmts = (
+            [],
+            [1],
+            [1, 2],
+            [1, 2, 3],
+            [1, 2, 3, 4, 5],
+            {1, 2, 3, 4},
+            [1, 2, 3, "4"],
+        )
+
+        for rect in invalid_fmts:
+            kwargs["rect"] = rect
+
+            with self.assertRaises(TypeError):
+                bounds_rect = self.draw_rect(**kwargs)
+
+    def test_rect__valid_color_formats(self):
+        """Ensures draw rect accepts different color formats."""
+        pos = (1, 1)
+        red_color = pygame.Color("red")
+        surface_color = pygame.Color("black")
+        surface = pygame.Surface((3, 4))
+        kwargs = {
+            "surface": surface,
+            "color": None,
+            "rect": pygame.Rect(pos, (1, 1)),
+            "width": 3,
+        }
+        reds = ((255, 0, 0), (255, 0, 0, 255), surface.map_rgb(red_color), red_color)
+
+        for color in reds:
+            surface.fill(surface_color)  # Clear for each test.
+            kwargs["color"] = color
+
+            if isinstance(color, int):
+                expected_color = surface.unmap_rgb(color)
+            else:
+                expected_color = red_color
+
+            bounds_rect = self.draw_rect(**kwargs)
+
+            self.assertEqual(surface.get_at(pos), expected_color)
+            self.assertIsInstance(bounds_rect, pygame.Rect)
+
+    def test_rect__invalid_color_formats(self):
+        """Ensures draw rect handles invalid color formats correctly."""
+        pos = (1, 1)
+        surface = pygame.Surface((3, 4))
+        kwargs = {
+            "surface": surface,
+            "color": None,
+            "rect": pygame.Rect(pos, (1, 1)),
+            "width": 1,
+        }
+
+        for expected_color in (2.3, self):
+            kwargs["color"] = expected_color
+
+            with self.assertRaises(TypeError):
+                bounds_rect = self.draw_rect(**kwargs)
+
+    def test_rect__fill(self):
+        self.surf_w, self.surf_h = self.surf_size = (320, 200)
+        self.surf = pygame.Surface(self.surf_size, pygame.SRCALPHA)
+        self.color = (1, 13, 24, 205)
+        rect = pygame.Rect(10, 10, 25, 20)
+        drawn = self.draw_rect(self.surf, self.color, rect, 0)
+
+        self.assertEqual(drawn, rect)
+
+        # Should be colored where it's supposed to be
+        for pt in test_utils.rect_area_pts(rect):
+            color_at_pt = self.surf.get_at(pt)
+
+            self.assertEqual(color_at_pt, self.color)
+
+        # And not where it shouldn't
+        for pt in test_utils.rect_outer_bounds(rect):
+            color_at_pt = self.surf.get_at(pt)
+
+            self.assertNotEqual(color_at_pt, self.color)
+
+        # 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)
+        vrect = pygame.Rect(1, 3, 1, self.surf_h - 4)
+
+        drawn = self.draw_rect(self.surf, self.color, hrect, 0)
+
+        self.assertEqual(drawn, hrect)
+
+        x, y = hrect.topleft
+        w, h = hrect.size
+
+        self.assertEqual(self.surf.get_at((x - 1, y)), bgcolor)
+        self.assertEqual(self.surf.get_at((x + w, y)), bgcolor)
+        for i in range(x, x + w):
+            self.assertEqual(self.surf.get_at((i, y)), self.color)
+
+        drawn = self.draw_rect(self.surf, self.color, vrect, 0)
+
+        self.assertEqual(drawn, vrect)
+
+        x, y = vrect.topleft
+        w, h = vrect.size
+
+        self.assertEqual(self.surf.get_at((x, y - 1)), bgcolor)
+        self.assertEqual(self.surf.get_at((x, y + h)), bgcolor)
+        for i in range(y, y + h):
+            self.assertEqual(self.surf.get_at((x, i)), self.color)
+
+    def test_rect__one_pixel_lines(self):
+        self.surf = pygame.Surface((320, 200), pygame.SRCALPHA)
+        self.color = (1, 13, 24, 205)
+
+        rect = pygame.Rect(10, 10, 56, 20)
+
+        drawn = self.draw_rect(self.surf, self.color, rect, 1)
+
+        self.assertEqual(drawn, rect)
+
+        # Should be colored where it's supposed to be
+        for pt in test_utils.rect_perimeter_pts(drawn):
+            color_at_pt = self.surf.get_at(pt)
+
+            self.assertEqual(color_at_pt, self.color)
+
+        # And not where it shouldn't
+        for pt in test_utils.rect_outer_bounds(drawn):
+            color_at_pt = self.surf.get_at(pt)
+
+            self.assertNotEqual(color_at_pt, self.color)
+
+    def test_rect__draw_line_width(self):
+        surface = pygame.Surface((100, 100))
+        surface.fill("black")
+        color = pygame.Color(255, 255, 255)
+        rect_width = 80
+        rect_height = 50
+        line_width = 10
+        pygame.draw.rect(
+            surface, color, pygame.Rect(0, 0, rect_width, rect_height), line_width
+        )
+        for i in range(line_width):
+            self.assertEqual(surface.get_at((i, i)), color)
+            self.assertEqual(surface.get_at((rect_width - i - 1, i)), color)
+            self.assertEqual(surface.get_at((i, rect_height - i - 1)), color)
+            self.assertEqual(
+                surface.get_at((rect_width - i - 1, rect_height - i - 1)), color
+            )
+        self.assertEqual(surface.get_at((line_width, line_width)), (0, 0, 0))
+        self.assertEqual(
+            surface.get_at((rect_width - line_width - 1, line_width)), (0, 0, 0)
+        )
+        self.assertEqual(
+            surface.get_at((line_width, rect_height - line_width - 1)), (0, 0, 0)
+        )
+        self.assertEqual(
+            surface.get_at((rect_width - line_width - 1, rect_height - line_width - 1)),
+            (0, 0, 0),
+        )
+
+    def test_rect__bounding_rect(self):
+        """Ensures draw rect returns the correct bounding rect.
+
+        Tests rects on and off the surface and a range of width/thickness
+        values.
+        """
+        rect_color = pygame.Color("red")
+        surf_color = pygame.Color("black")
+        min_width = min_height = 5
+        max_width = max_height = 7
+        sizes = ((min_width, min_height), (max_width, max_height))
+        surface = pygame.Surface((20, 20), 0, 32)
+        surf_rect = surface.get_rect()
+        # Make a rect that is bigger than the surface to help test drawing
+        # rects off and partially off the surface.
+        big_rect = surf_rect.inflate(min_width * 2 + 1, min_height * 2 + 1)
+
+        for pos in rect_corners_mids_and_center(
+            surf_rect
+        ) + rect_corners_mids_and_center(big_rect):
+            # Each of the rect's position attributes will be set to the pos
+            # value.
+            for attr in RECT_POSITION_ATTRIBUTES:
+                # Test using different rect sizes and thickness values.
+                for width, height in sizes:
+                    rect = pygame.Rect((0, 0), (width, height))
+                    setattr(rect, attr, pos)
+
+                    for thickness in range(4):
+                        surface.fill(surf_color)  # Clear for each test.
+
+                        bounding_rect = self.draw_rect(
+                            surface, rect_color, rect, thickness
+                        )
+
+                        # Calculating the expected_rect after the rect is
+                        # drawn (it uses what is actually drawn).
+                        expected_rect = create_bounding_rect(
+                            surface, surf_color, rect.topleft
+                        )
+
+                        self.assertEqual(
+                            bounding_rect,
+                            expected_rect,
+                            f"thickness={thickness}",
+                        )
+
+    def test_rect__surface_clip(self):
+        """Ensures draw rect respects a surface's clip area.
+
+        Tests drawing the rect filled and unfilled.
+        """
+        surfw = surfh = 30
+        rect_color = pygame.Color("red")
+        surface_color = pygame.Color("green")
+        surface = pygame.Surface((surfw, surfh))
+        surface.fill(surface_color)
+
+        clip_rect = pygame.Rect((0, 0), (8, 10))
+        clip_rect.center = surface.get_rect().center
+        test_rect = clip_rect.copy()  # Manages the rect's pos.
+
+        for width in (0, 1):  # Filled and unfilled.
+            # Test centering the rect along the clip rect's edge.
+            for center in rect_corners_mids_and_center(clip_rect):
+                # Get the expected points by drawing the rect without the
+                # clip area set.
+                test_rect.center = center
+                surface.set_clip(None)
+                surface.fill(surface_color)
+                self.draw_rect(surface, rect_color, test_rect, width)
+                expected_pts = get_color_points(surface, rect_color, clip_rect)
+
+                # Clear the surface and set the clip area. Redraw the rect
+                # and check that only the clip area is modified.
+                surface.fill(surface_color)
+                surface.set_clip(clip_rect)
+
+                self.draw_rect(surface, rect_color, test_rect, width)
+
+                surface.lock()  # For possible speed up.
+
+                # Check all the surface points to ensure only the expected_pts
+                # are the rect_color.
+                for pt in ((x, y) for x in range(surfw) for y in range(surfh)):
+                    if pt in expected_pts:
+                        expected_color = rect_color
+                    else:
+                        expected_color = surface_color
+
+                    self.assertEqual(surface.get_at(pt), expected_color, pt)
+
+                surface.unlock()
+
+
+class DrawRectTest(DrawRectMixin, DrawTestCase):
+    """Test draw module function rect.
+
+    This class inherits the general tests from DrawRectMixin. It is also the
+    class to add any draw.rect specific tests to.
+    """
+
+
+# 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 ############################################################
+
+
+class DrawCircleMixin:
+    """Mixin tests for drawing circles.
+
+    This class contains all the general circle drawing tests.
+    """
+
+    def test_circle__args(self):
+        """Ensures draw circle accepts the correct args."""
+        bounds_rect = self.draw_circle(
+            pygame.Surface((3, 3)), (0, 10, 0, 50), (0, 0), 3, 1, 1, 0, 1, 1
+        )
+
+        self.assertIsInstance(bounds_rect, pygame.Rect)
+
+    def test_circle__args_without_width(self):
+        """Ensures draw circle accepts the args without a width and
+        quadrants."""
+        bounds_rect = self.draw_circle(pygame.Surface((2, 2)), (0, 0, 0, 50), (1, 1), 1)
+
+        self.assertIsInstance(bounds_rect, pygame.Rect)
+
+    def test_circle__args_with_negative_width(self):
+        """Ensures draw circle accepts the args with negative width."""
+        bounds_rect = self.draw_circle(
+            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_circle__args_with_width_gt_radius(self):
+        """Ensures draw circle accepts the args with width > radius."""
+        bounds_rect = self.draw_circle(
+            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_circle__kwargs(self):
+        """Ensures draw circle 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_circle(**kwargs)
+
+            self.assertIsInstance(bounds_rect, pygame.Rect)
+
+    def test_circle__kwargs_order_independent(self):
+        """Ensures draw circle's kwargs are not order dependent."""
+        bounds_rect = self.draw_circle(
+            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_circle__args_missing(self):
+        """Ensures draw circle detects any missing required args."""
+        surface = pygame.Surface((1, 1))
+        color = pygame.Color("blue")
+
+        with self.assertRaises(TypeError):
+            bounds_rect = self.draw_circle(surface, color, (0, 0))
+
+        with self.assertRaises(TypeError):
+            bounds_rect = self.draw_circle(surface, color)
+
+        with self.assertRaises(TypeError):
+            bounds_rect = self.draw_circle(surface)
+
+        with self.assertRaises(TypeError):
+            bounds_rect = self.draw_circle()
+
+    def test_circle__kwargs_missing(self):
+        """Ensures draw circle 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_circle(**invalid_kwargs)
+
+    def test_circle__arg_invalid_types(self):
+        """Ensures draw circle 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_circle(
+                surface, color, center, radius, 1, "a", 1, 1, 1
+            )
+
+        with self.assertRaises(TypeError):
+            # Invalid draw_top_left.
+            bounds_rect = self.draw_circle(
+                surface, color, center, radius, 1, 1, "b", 1, 1
+            )
+
+        with self.assertRaises(TypeError):
+            # Invalid draw_bottom_left.
+            bounds_rect = self.draw_circle(
+                surface, color, center, radius, 1, 1, 1, "c", 1
+            )
+
+        with self.assertRaises(TypeError):
+            # Invalid draw_bottom_right.
+            bounds_rect = self.draw_circle(
+                surface, color, center, radius, 1, 1, 1, 1, "d"
+            )
+
+        with self.assertRaises(TypeError):
+            # Invalid width.
+            bounds_rect = self.draw_circle(surface, color, center, radius, "1")
+
+        with self.assertRaises(TypeError):
+            # Invalid radius.
+            bounds_rect = self.draw_circle(surface, color, center, "2")
+
+        with self.assertRaises(TypeError):
+            # Invalid center.
+            bounds_rect = self.draw_circle(surface, color, (1, 2, 3), radius)
+
+        with self.assertRaises(TypeError):
+            # Invalid color.
+            bounds_rect = self.draw_circle(surface, 2.3, center, radius)
+
+        with self.assertRaises(TypeError):
+            # Invalid surface.
+            bounds_rect = self.draw_circle((1, 2, 3, 4), color, center, radius)
+
+    def test_circle__kwarg_invalid_types(self):
+        """Ensures draw circle 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_circle(**kwargs)
+
+    def test_circle__kwarg_invalid_name(self):
+        """Ensures draw circle 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_circle(**kwargs)
+
+    def test_circle__args_and_kwargs(self):
+        """Ensures draw circle 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_circle(surface, **kwargs)
+            elif "color" == name:
+                bounds_rect = self.draw_circle(surface, color, **kwargs)
+            elif "center" == name:
+                bounds_rect = self.draw_circle(surface, color, center, **kwargs)
+            elif "radius" == name:
+                bounds_rect = self.draw_circle(surface, color, center, radius, **kwargs)
+            elif "width" == name:
+                bounds_rect = self.draw_circle(
+                    surface, color, center, radius, width, **kwargs
+                )
+            elif "draw_top_right" == name:
+                bounds_rect = self.draw_circle(
+                    surface, color, center, radius, width, draw_top_right, **kwargs
+                )
+            elif "draw_top_left" == name:
+                bounds_rect = self.draw_circle(
+                    surface,
+                    color,
+                    center,
+                    radius,
+                    width,
+                    draw_top_right,
+                    draw_top_left,
+                    **kwargs,
+                )
+            elif "draw_bottom_left" == name:
+                bounds_rect = self.draw_circle(
+                    surface,
+                    color,
+                    center,
+                    radius,
+                    width,
+                    draw_top_right,
+                    draw_top_left,
+                    draw_bottom_left,
+                    **kwargs,
+                )
+            else:
+                bounds_rect = self.draw_circle(
+                    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_circle__valid_width_values(self):
+        """Ensures draw circle 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_circle(**kwargs)
+
+            self.assertEqual(surface.get_at(pos), expected_color)
+            self.assertIsInstance(bounds_rect, pygame.Rect)
+
+    def test_circle__valid_radius_values(self):
+        """Ensures draw circle 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_circle(**kwargs)
+
+            self.assertEqual(surface.get_at(pos), expected_color)
+            self.assertIsInstance(bounds_rect, pygame.Rect)
+
+    def test_circle__valid_center_formats(self):
+        """Ensures draw circle 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_circle(**kwargs)
+
+                self.assertEqual(surface.get_at((x, y)), expected_color)
+                self.assertIsInstance(bounds_rect, pygame.Rect)
+
+    def test_circle__valid_color_formats(self):
+        """Ensures draw circle 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_circle(**kwargs)
+
+            self.assertEqual(surface.get_at(pos), expected_color)
+            self.assertIsInstance(bounds_rect, pygame.Rect)
+
+    def test_circle__invalid_color_formats(self):
+        """Ensures draw circle 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_circle(**kwargs)
+
+    def test_circle__floats(self):
+        """Ensure that floats are accepted."""
+        draw.circle(
+            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.circle(
+            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.circle(pygame.Surface((2, 2)), (0, 0, 0, 50), (1.3, 1.3), 1.2)
+
+    # def test_circle_clip(self):
+    #     """ maybe useful to help work out circle clip algorithm."""
+    #     MAX = max
+    #     MIN = min
+    #     posx=30
+    #     posy=15
+    #     radius=1
+    #     l=29
+    #     t=14
+    #     r=30
+    #     b=16
+    #     clip_rect_x=0
+    #     clip_rect_y=0
+    #     clip_rect_w=30
+    #     clip_rect_h=30
+
+    #     l = MAX(posx - radius, clip_rect_x)
+    #     t = MAX(posy - radius, clip_rect_y)
+    #     r = MIN(posx + radius, clip_rect_x + clip_rect_w)
+    #     b = MIN(posy + radius, clip_rect_y + clip_rect_h)
+
+    #     l, t, MAX(r - l, 0), MAX(b - t, 0)
+
+    def test_circle__bounding_rect(self):
+        """Ensures draw circle returns the correct bounding rect.
+
+        Tests 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 circle on one of its corners, the circle is
+        # drawn fully off the test surface, but a rect bounding the circle
+        # 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_circle(
+                        surface, circle_color, pos, radius, thickness
+                    )
+
+                    # 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)
+                    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."""
+        surf = pygame.Surface((200, 200))
+        color = (0, 0, 0, 50)
+        center = surf.get_height() // 2, surf.get_height() // 2
+
+        bounding_rect = self.draw_circle(surf, color, center, radius=-1, width=1)
+        self.assertEqual(bounding_rect.size, (0, 0))
+
+    def test_circle_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_circle(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_circle__surface_clip(self):
+        """Ensures draw circle respects a surface's clip area.
+
+        Tests drawing the circle filled and unfilled.
+        """
+        surfw = surfh = 25
+        circle_color = pygame.Color("red")
+        surface_color = pygame.Color("green")
+        surface = pygame.Surface((surfw, surfh))
+        surface.fill(surface_color)
+
+        clip_rect = pygame.Rect((0, 0), (10, 10))
+        clip_rect.center = surface.get_rect().center
+        radius = clip_rect.w // 2 + 1
+
+        for width in (0, 1):  # Filled and unfilled.
+            # Test centering the circle along the clip rect's edge.
+            for center in rect_corners_mids_and_center(clip_rect):
+                # Get the expected points by drawing the circle without the
+                # clip area set.
+                surface.set_clip(None)
+                surface.fill(surface_color)
+                self.draw_circle(surface, circle_color, center, radius, width)
+                expected_pts = get_color_points(surface, circle_color, clip_rect)
+
+                # Clear the surface and set the clip area. Redraw the circle
+                # and check that only the clip area is modified.
+                surface.fill(surface_color)
+                surface.set_clip(clip_rect)
+
+                self.draw_circle(surface, circle_color, center, radius, width)
+
+                surface.lock()  # For possible speed up.
+
+                # Check all the surface points to ensure only the expected_pts
+                # are the circle_color.
+                for pt in ((x, y) for x in range(surfw) for y in range(surfh)):
+                    if pt in expected_pts:
+                        expected_color = circle_color
+                    else:
+                        expected_color = surface_color
+
+                    self.assertEqual(surface.get_at(pt), expected_color, pt)
+
+                surface.unlock()
+
+    def test_circle_shape(self):
+        """Ensures there are no holes in the circle, and no overdrawing.
+
+        Tests drawing a thick circle.
+        Measures the distance of the drawn pixels from the circle 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_circle(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_circle__diameter(self):
+        """Ensures draw circle 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_circle(surf, color, center, radius, width)
+            self.assertEqual(bounding_rect.width, radius * 2)
+            self.assertEqual(bounding_rect.height, radius * 2)
+
+    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
+
+        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)
+
+        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)
+
+        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)
+
+        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):
+    """Test draw module function circle.
+
+    This class inherits the general tests from DrawCircleMixin. It is also
+    the class to add any draw.circle 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 ###############################################################
+
+
+class DrawArcMixin:
+    """Mixin tests for drawing arcs.
+
+    This class contains all the general arc drawing tests.
+    """
+
+    def test_arc__args(self):
+        """Ensures draw arc accepts the correct args."""
+        bounds_rect = self.draw_arc(
+            pygame.Surface((3, 3)), (0, 10, 0, 50), (1, 1, 2, 2), 0, 1, 1
+        )
+
+        self.assertIsInstance(bounds_rect, pygame.Rect)
+
+    def test_arc__args_without_width(self):
+        """Ensures draw arc accepts the args without a width."""
+        bounds_rect = self.draw_arc(
+            pygame.Surface((2, 2)), (1, 1, 1, 99), pygame.Rect((0, 0), (2, 2)), 1.1, 2.1
+        )
+
+        self.assertIsInstance(bounds_rect, pygame.Rect)
+
+    def test_arc__args_with_negative_width(self):
+        """Ensures draw arc accepts the args with negative width."""
+        bounds_rect = self.draw_arc(
+            pygame.Surface((3, 3)), (10, 10, 50, 50), (1, 1, 2, 2), 0, 1, -1
+        )
+
+        self.assertIsInstance(bounds_rect, pygame.Rect)
+        self.assertEqual(bounds_rect, pygame.Rect(1, 1, 0, 0))
+
+    def test_arc__args_with_width_gt_radius(self):
+        """Ensures draw arc accepts the args with
+        width > rect.w // 2 and width > rect.h // 2.
+        """
+        rect = pygame.Rect((0, 0), (4, 4))
+        bounds_rect = self.draw_arc(
+            pygame.Surface((3, 3)), (10, 10, 50, 50), rect, 0, 45, rect.w // 2 + 1
+        )
+
+        self.assertIsInstance(bounds_rect, pygame.Rect)
+
+        bounds_rect = self.draw_arc(
+            pygame.Surface((3, 3)), (10, 10, 50, 50), rect, 0, 45, rect.h // 2 + 1
+        )
+
+        self.assertIsInstance(bounds_rect, pygame.Rect)
+
+    def test_arc__kwargs(self):
+        """Ensures draw arc accepts the correct kwargs
+        with and without a width arg.
+        """
+        kwargs_list = [
+            {
+                "surface": pygame.Surface((4, 4)),
+                "color": pygame.Color("yellow"),
+                "rect": pygame.Rect((0, 0), (3, 2)),
+                "start_angle": 0.5,
+                "stop_angle": 3,
+                "width": 1,
+            },
+            {
+                "surface": pygame.Surface((2, 1)),
+                "color": (0, 10, 20),
+                "rect": (0, 0, 2, 2),
+                "start_angle": 1,
+                "stop_angle": 3.1,
+            },
+        ]
+
+        for kwargs in kwargs_list:
+            bounds_rect = self.draw_arc(**kwargs)
+
+            self.assertIsInstance(bounds_rect, pygame.Rect)
+
+    def test_arc__kwargs_order_independent(self):
+        """Ensures draw arc's kwargs are not order dependent."""
+        bounds_rect = self.draw_arc(
+            stop_angle=1,
+            start_angle=2.2,
+            color=(1, 2, 3),
+            surface=pygame.Surface((3, 2)),
+            width=1,
+            rect=pygame.Rect((1, 0), (2, 3)),
+        )
+
+        self.assertIsInstance(bounds_rect, pygame.Rect)
+
+    def test_arc__args_missing(self):
+        """Ensures draw arc detects any missing required args."""
+        surface = pygame.Surface((1, 1))
+        color = pygame.Color("red")
+        rect = pygame.Rect((0, 0), (2, 2))
+
+        with self.assertRaises(TypeError):
+            bounds_rect = self.draw_arc(surface, color, rect, 0.1)
+
+        with self.assertRaises(TypeError):
+            bounds_rect = self.draw_arc(surface, color, rect)
+
+        with self.assertRaises(TypeError):
+            bounds_rect = self.draw_arc(surface, color)
+
+        with self.assertRaises(TypeError):
+            bounds_rect = self.draw_arc(surface)
+
+        with self.assertRaises(TypeError):
+            bounds_rect = self.draw_arc()
+
+    def test_arc__kwargs_missing(self):
+        """Ensures draw arc detects any missing required kwargs."""
+        kwargs = {
+            "surface": pygame.Surface((1, 2)),
+            "color": pygame.Color("red"),
+            "rect": pygame.Rect((1, 0), (2, 2)),
+            "start_angle": 0.1,
+            "stop_angle": 2,
+            "width": 1,
+        }
+
+        for name in ("stop_angle", "start_angle", "rect", "color", "surface"):
+            invalid_kwargs = dict(kwargs)
+            invalid_kwargs.pop(name)  # Pop from a copy.
+
+            with self.assertRaises(TypeError):
+                bounds_rect = self.draw_arc(**invalid_kwargs)
+
+    def test_arc__arg_invalid_types(self):
+        """Ensures draw arc detects invalid arg types."""
+        surface = pygame.Surface((2, 2))
+        color = pygame.Color("blue")
+        rect = pygame.Rect((1, 1), (3, 3))
+
+        with self.assertRaises(TypeError):
+            # Invalid width.
+            bounds_rect = self.draw_arc(surface, color, rect, 0, 1, "1")
+
+        with self.assertRaises(TypeError):
+            # Invalid stop_angle.
+            bounds_rect = self.draw_arc(surface, color, rect, 0, "1", 1)
+
+        with self.assertRaises(TypeError):
+            # Invalid start_angle.
+            bounds_rect = self.draw_arc(surface, color, rect, "1", 0, 1)
+
+        with self.assertRaises(TypeError):
+            # Invalid rect.
+            bounds_rect = self.draw_arc(surface, color, (1, 2, 3, 4, 5), 0, 1, 1)
+
+        with self.assertRaises(TypeError):
+            # Invalid color.
+            bounds_rect = self.draw_arc(surface, 2.3, rect, 0, 1, 1)
+
+        with self.assertRaises(TypeError):
+            # Invalid surface.
+            bounds_rect = self.draw_arc(rect, color, rect, 0, 1, 1)
+
+    def test_arc__kwarg_invalid_types(self):
+        """Ensures draw arc detects invalid kwarg types."""
+        surface = pygame.Surface((3, 3))
+        color = pygame.Color("green")
+        rect = pygame.Rect((0, 1), (4, 2))
+        start = 3
+        stop = 4
+        kwargs_list = [
+            {
+                "surface": pygame.Surface,  # Invalid surface.
+                "color": color,
+                "rect": rect,
+                "start_angle": start,
+                "stop_angle": stop,
+                "width": 1,
+            },
+            {
+                "surface": surface,
+                "color": 2.3,  # Invalid color.
+                "rect": rect,
+                "start_angle": start,
+                "stop_angle": stop,
+                "width": 1,
+            },
+            {
+                "surface": surface,
+                "color": color,
+                "rect": (0, 0, 0),  # Invalid rect.
+                "start_angle": start,
+                "stop_angle": stop,
+                "width": 1,
+            },
+            {
+                "surface": surface,
+                "color": color,
+                "rect": rect,
+                "start_angle": "1",  # Invalid start_angle.
+                "stop_angle": stop,
+                "width": 1,
+            },
+            {
+                "surface": surface,
+                "color": color,
+                "rect": rect,
+                "start_angle": start,
+                "stop_angle": "1",  # Invalid stop_angle.
+                "width": 1,
+            },
+            {
+                "surface": surface,
+                "color": color,
+                "rect": rect,
+                "start_angle": start,
+                "stop_angle": stop,
+                "width": 1.1,
+            },
+        ]  # Invalid width.
+
+        for kwargs in kwargs_list:
+            with self.assertRaises(TypeError):
+                bounds_rect = self.draw_arc(**kwargs)
+
+    def test_arc__kwarg_invalid_name(self):
+        """Ensures draw arc detects invalid kwarg names."""
+        surface = pygame.Surface((2, 3))
+        color = pygame.Color("cyan")
+        rect = pygame.Rect((0, 1), (2, 2))
+        start = 0.9
+        stop = 2.3
+        kwargs_list = [
+            {
+                "surface": surface,
+                "color": color,
+                "rect": rect,
+                "start_angle": start,
+                "stop_angle": stop,
+                "width": 1,
+                "invalid": 1,
+            },
+            {
+                "surface": surface,
+                "color": color,
+                "rect": rect,
+                "start_angle": start,
+                "stop_angle": stop,
+                "invalid": 1,
+            },
+        ]
+
+        for kwargs in kwargs_list:
+            with self.assertRaises(TypeError):
+                bounds_rect = self.draw_arc(**kwargs)
+
+    def test_arc__args_and_kwargs(self):
+        """Ensures draw arc accepts a combination of args/kwargs"""
+        surface = pygame.Surface((3, 1))
+        color = (255, 255, 0, 0)
+        rect = pygame.Rect((1, 0), (2, 3))
+        start = 0.6
+        stop = 2
+        width = 1
+        kwargs = {
+            "surface": surface,
+            "color": color,
+            "rect": rect,
+            "start_angle": start,
+            "stop_angle": stop,
+            "width": width,
+        }
+
+        for name in ("surface", "color", "rect", "start_angle", "stop_angle"):
+            kwargs.pop(name)
+
+            if "surface" == name:
+                bounds_rect = self.draw_arc(surface, **kwargs)
+            elif "color" == name:
+                bounds_rect = self.draw_arc(surface, color, **kwargs)
+            elif "rect" == name:
+                bounds_rect = self.draw_arc(surface, color, rect, **kwargs)
+            elif "start_angle" == name:
+                bounds_rect = self.draw_arc(surface, color, rect, start, **kwargs)
+            elif "stop_angle" == name:
+                bounds_rect = self.draw_arc(surface, color, rect, start, stop, **kwargs)
+            else:
+                bounds_rect = self.draw_arc(
+                    surface, color, rect, start, stop, width, **kwargs
+                )
+
+            self.assertIsInstance(bounds_rect, pygame.Rect)
+
+    def test_arc__valid_width_values(self):
+        """Ensures draw arc accepts different width values."""
+        arc_color = pygame.Color("yellow")
+        surface_color = pygame.Color("white")
+        surface = pygame.Surface((6, 6))
+        rect = pygame.Rect((0, 0), (4, 4))
+        rect.center = surface.get_rect().center
+        pos = rect.centerx + 1, rect.centery + 1
+        kwargs = {
+            "surface": surface,
+            "color": arc_color,
+            "rect": rect,
+            "start_angle": 0,
+            "stop_angle": 7,
+            "width": None,
+        }
+
+        for width in (-50, -10, -3, -2, -1, 0, 1, 2, 3, 10, 50):
+            msg = f"width={width}"
+            surface.fill(surface_color)  # Clear for each test.
+            kwargs["width"] = width
+            expected_color = arc_color if width > 0 else surface_color
+
+            bounds_rect = self.draw_arc(**kwargs)
+
+            self.assertEqual(surface.get_at(pos), expected_color, msg)
+            self.assertIsInstance(bounds_rect, pygame.Rect, msg)
+
+    def test_arc__valid_stop_angle_values(self):
+        """Ensures draw arc accepts different stop_angle values."""
+        expected_color = pygame.Color("blue")
+        surface_color = pygame.Color("white")
+        surface = pygame.Surface((6, 6))
+        rect = pygame.Rect((0, 0), (4, 4))
+        rect.center = surface.get_rect().center
+        pos = rect.centerx, rect.centery + 1
+        kwargs = {
+            "surface": surface,
+            "color": expected_color,
+            "rect": rect,
+            "start_angle": -17,
+            "stop_angle": None,
+            "width": 1,
+        }
+
+        for stop_angle in (-10, -5.5, -1, 0, 1, 5.5, 10):
+            msg = f"stop_angle={stop_angle}"
+            surface.fill(surface_color)  # Clear for each test.
+            kwargs["stop_angle"] = stop_angle
+
+            bounds_rect = self.draw_arc(**kwargs)
+
+            self.assertEqual(surface.get_at(pos), expected_color, msg)
+            self.assertIsInstance(bounds_rect, pygame.Rect, msg)
+
+    def test_arc__valid_start_angle_values(self):
+        """Ensures draw arc accepts different start_angle values."""
+        expected_color = pygame.Color("blue")
+        surface_color = pygame.Color("white")
+        surface = pygame.Surface((6, 6))
+        rect = pygame.Rect((0, 0), (4, 4))
+        rect.center = surface.get_rect().center
+        pos = rect.centerx + 1, rect.centery + 1
+        kwargs = {
+            "surface": surface,
+            "color": expected_color,
+            "rect": rect,
+            "start_angle": None,
+            "stop_angle": 17,
+            "width": 1,
+        }
+
+        for start_angle in (-10.0, -5.5, -1, 0, 1, 5.5, 10.0):
+            msg = f"start_angle={start_angle}"
+            surface.fill(surface_color)  # Clear for each test.
+            kwargs["start_angle"] = start_angle
+
+            bounds_rect = self.draw_arc(**kwargs)
+
+            self.assertEqual(surface.get_at(pos), expected_color, msg)
+            self.assertIsInstance(bounds_rect, pygame.Rect, msg)
+
+    def test_arc__valid_rect_formats(self):
+        """Ensures draw arc accepts different rect formats."""
+        expected_color = pygame.Color("red")
+        surface_color = pygame.Color("black")
+        surface = pygame.Surface((6, 6))
+        rect = pygame.Rect((0, 0), (4, 4))
+        rect.center = surface.get_rect().center
+        pos = rect.centerx + 1, rect.centery + 1
+        kwargs = {
+            "surface": surface,
+            "color": expected_color,
+            "rect": None,
+            "start_angle": 0,
+            "stop_angle": 7,
+            "width": 1,
+        }
+        rects = (rect, (rect.topleft, rect.size), (rect.x, rect.y, rect.w, rect.h))
+
+        for rect in rects:
+            surface.fill(surface_color)  # Clear for each test.
+            kwargs["rect"] = rect
+
+            bounds_rect = self.draw_arc(**kwargs)
+
+            self.assertEqual(surface.get_at(pos), expected_color)
+            self.assertIsInstance(bounds_rect, pygame.Rect)
+
+    def test_arc__valid_color_formats(self):
+        """Ensures draw arc accepts different color formats."""
+        green_color = pygame.Color("green")
+        surface_color = pygame.Color("black")
+        surface = pygame.Surface((6, 6))
+        rect = pygame.Rect((0, 0), (4, 4))
+        rect.center = surface.get_rect().center
+        pos = rect.centerx + 1, rect.centery + 1
+        kwargs = {
+            "surface": surface,
+            "color": None,
+            "rect": rect,
+            "start_angle": 0,
+            "stop_angle": 7,
+            "width": 1,
+        }
+        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_arc(**kwargs)
+
+            self.assertEqual(surface.get_at(pos), expected_color)
+            self.assertIsInstance(bounds_rect, pygame.Rect)
+
+    def test_arc__invalid_color_formats(self):
+        """Ensures draw arc handles invalid color formats correctly."""
+        pos = (1, 1)
+        surface = pygame.Surface((4, 3))
+        kwargs = {
+            "surface": surface,
+            "color": None,
+            "rect": pygame.Rect(pos, (2, 2)),
+            "start_angle": 5,
+            "stop_angle": 6.1,
+            "width": 1,
+        }
+
+        for expected_color in (2.3, self):
+            kwargs["color"] = expected_color
+
+            with self.assertRaises(TypeError):
+                bounds_rect = self.draw_arc(**kwargs)
+
+    def test_arc(self):
+        """Ensure draw arc works correctly."""
+        black = pygame.Color("black")
+        red = pygame.Color("red")
+
+        # create an image object of width 100, height 150, filled with black.
+        surface = pygame.Surface((100, 150))
+        surface.fill(black)
+
+        # 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)
+
+        # angle of the arc in radians
+        start_angle = 0.0
+        stop_angle = 3.14
+
+        # thickness, and it grows inward from the rectangle
+        width = 3
+
+        # 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.
+
+        Tests arcs on and off the surface and a range of width/thickness
+        values.
+        """
+        arc_color = pygame.Color("red")
+        surf_color = pygame.Color("black")
+        min_width = min_height = 5
+        max_width = max_height = 7
+        sizes = ((min_width, min_height), (max_width, max_height))
+        surface = pygame.Surface((20, 20), 0, 32)
+        surf_rect = surface.get_rect()
+        # Make a rect that is bigger than the surface to help test drawing
+        # arcs off and partially off the surface.
+        big_rect = surf_rect.inflate(min_width * 2 + 1, min_height * 2 + 1)
+
+        # Max angle allows for a full circle to be drawn.
+        start_angle = 0
+        stop_angles = (0, 2, 3, 5, math.ceil(2 * math.pi))
+
+        for pos in rect_corners_mids_and_center(
+            surf_rect
+        ) + rect_corners_mids_and_center(big_rect):
+            # Each of the arc's rect position attributes will be set to the pos
+            # value.
+            for attr in RECT_POSITION_ATTRIBUTES:
+                # Test using different rect sizes, thickness values and stop
+                # angles.
+                for width, height in sizes:
+                    arc_rect = pygame.Rect((0, 0), (width, height))
+                    setattr(arc_rect, attr, pos)
+
+                    for thickness in (0, 1, 2, 3, min(width, height)):
+                        for stop_angle in stop_angles:
+                            surface.fill(surf_color)  # Clear for each test.
+
+                            bounding_rect = self.draw_arc(
+                                surface,
+                                arc_color,
+                                arc_rect,
+                                start_angle,
+                                stop_angle,
+                                thickness,
+                            )
+
+                            # Calculating the expected_rect after the arc
+                            # is drawn (it uses what is actually drawn).
+                            expected_rect = create_bounding_rect(
+                                surface, surf_color, arc_rect.topleft
+                            )
+
+                            self.assertEqual(
+                                bounding_rect,
+                                expected_rect,
+                                f"thickness={thickness}",
+                            )
+
+    def test_arc__surface_clip(self):
+        """Ensures draw arc respects a surface's clip area."""
+        surfw = surfh = 30
+        start = 0.1
+        end = 0  # end < start so a full circle will be drawn
+        arc_color = pygame.Color("red")
+        surface_color = pygame.Color("green")
+        surface = pygame.Surface((surfw, surfh))
+        surface.fill(surface_color)
+
+        clip_rect = pygame.Rect((0, 0), (11, 11))
+        clip_rect.center = surface.get_rect().center
+        pos_rect = clip_rect.copy()  # Manages the arc's pos.
+
+        for thickness in (1, 3):  # Different line widths.
+            # Test centering the arc along the clip rect's edge.
+            for center in rect_corners_mids_and_center(clip_rect):
+                # Get the expected points by drawing the arc without the
+                # clip area set.
+                pos_rect.center = center
+                surface.set_clip(None)
+                surface.fill(surface_color)
+                self.draw_arc(surface, arc_color, pos_rect, start, end, thickness)
+                expected_pts = get_color_points(surface, arc_color, clip_rect)
+
+                # Clear the surface and set the clip area. Redraw the arc
+                # and check that only the clip area is modified.
+                surface.fill(surface_color)
+                surface.set_clip(clip_rect)
+
+                self.draw_arc(surface, arc_color, pos_rect, start, end, thickness)
+
+                surface.lock()  # For possible speed up.
+
+                # Check all the surface points to ensure only the expected_pts
+                # are the arc_color.
+                for pt in ((x, y) for x in range(surfw) for y in range(surfh)):
+                    if pt in expected_pts:
+                        expected_color = arc_color
+                    else:
+                        expected_color = surface_color
+
+                    self.assertEqual(surface.get_at(pt), expected_color, pt)
+
+                surface.unlock()
+
+
+class DrawArcTest(DrawArcMixin, DrawTestCase):
+    """Test draw module function arc.
+
+    This class inherits the general tests from DrawArcMixin. It is also the
+    class to add any draw.arc specific tests to.
+    """
+
+
+# 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 #######################################################
+
+
+class DrawModuleTest(unittest.TestCase):
+    """General draw module tests."""
+
+    def test_path_data_validation(self):
+        """Test validation of multi-point drawing methods.
+
+        See bug #521
+        """
+        surf = pygame.Surface((5, 5))
+        rect = pygame.Rect(0, 0, 5, 5)
+        bad_values = (
+            "text",
+            b"bytes",
+            1 + 1j,  # string, bytes, complex,
+            object(),
+            (lambda x: x),
+        )  # object, function
+        bad_points = list(bad_values) + [(1,), (1, 2, 3)]  # wrong tuple length
+        bad_points.extend((1, v) for v in bad_values)  # one wrong value
+        good_path = [(1, 1), (1, 3), (3, 3), (3, 1)]
+        # A) draw.lines
+        check_pts = [(x, y) for x in range(5) for y in range(5)]
+
+        for method, is_polgon in (
+            (draw.lines, 0),
+            (draw.aalines, 0),
+            (draw.polygon, 1),
+        ):
+            for val in bad_values:
+                # 1. at the beginning
+                draw.rect(surf, RED, rect, 0)
+                with self.assertRaises(TypeError):
+                    if is_polgon:
+                        method(surf, GREEN, [val] + good_path, 0)
+                    else:
+                        method(surf, GREEN, True, [val] + good_path)
+
+                # make sure, nothing was drawn :
+                self.assertTrue(all(surf.get_at(pt) == RED for pt in check_pts))
+
+                # 2. not at the beginning (was not checked)
+                draw.rect(surf, RED, rect, 0)
+                with self.assertRaises(TypeError):
+                    path = good_path[:2] + [val] + good_path[2:]
+                    if is_polgon:
+                        method(surf, GREEN, path, 0)
+                    else:
+                        method(surf, GREEN, True, path)
+
+                # make sure, nothing was drawn :
+                self.assertTrue(all(surf.get_at(pt) == RED for pt in check_pts))
+
+    def test_color_validation(self):
+        surf = pygame.Surface((10, 10))
+        colors = 123456, (1, 10, 100), RED, "#ab12df", "red"
+        points = ((0, 0), (1, 1), (1, 0))
+
+        # 1. valid colors
+        for col in colors:
+            draw.line(surf, col, (0, 0), (1, 1))
+            draw.aaline(surf, col, (0, 0), (1, 1))
+            draw.aalines(surf, col, True, points)
+            draw.lines(surf, col, True, points)
+            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.polygon(surf, col, points, 0)
+
+        # 2. invalid colors
+        for col in (1.256, object(), None):
+            with self.assertRaises(TypeError):
+                draw.line(surf, col, (0, 0), (1, 1))
+
+            with self.assertRaises(TypeError):
+                draw.aaline(surf, col, (0, 0), (1, 1))
+
+            with self.assertRaises(TypeError):
+                draw.aalines(surf, col, True, points)
+
+            with self.assertRaises(TypeError):
+                draw.lines(surf, col, True, points)
+
+            with self.assertRaises(TypeError):
+                draw.arc(surf, col, pygame.Rect(0, 0, 3, 3), 15, 150)
+
+            with self.assertRaises(TypeError):
+                draw.ellipse(surf, col, pygame.Rect(0, 0, 3, 6), 1)
+
+            with self.assertRaises(TypeError):
+                draw.circle(surf, col, (7, 3), 2)
+
+            with self.assertRaises(TypeError):
+                draw.polygon(surf, col, points, 0)
+
+
+###############################################################################
+
+
+if __name__ == "__main__":
+    unittest.main()
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/event_test.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/event_test.py
new file mode 100644
index 0000000..eb7c437
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/event_test.py
@@ -0,0 +1,961 @@
+import collections
+import time
+import unittest
+import os
+
+import pygame
+
+EVENT_TYPES = (
+    #   pygame.NOEVENT,
+    #   pygame.ACTIVEEVENT,
+    pygame.KEYDOWN,
+    pygame.KEYUP,
+    pygame.MOUSEMOTION,
+    pygame.MOUSEBUTTONDOWN,
+    pygame.MOUSEBUTTONUP,
+    pygame.JOYAXISMOTION,
+    pygame.JOYBALLMOTION,
+    pygame.JOYHATMOTION,
+    pygame.JOYBUTTONDOWN,
+    pygame.JOYBUTTONUP,
+    pygame.VIDEORESIZE,
+    pygame.VIDEOEXPOSE,
+    pygame.QUIT,
+    pygame.SYSWMEVENT,
+    pygame.USEREVENT,
+    #   pygame.NUMEVENTS,
+)
+
+EVENT_TEST_PARAMS = collections.defaultdict(dict)
+EVENT_TEST_PARAMS.update(
+    {
+        pygame.KEYDOWN: {"key": pygame.K_SPACE},
+        pygame.KEYUP: {"key": pygame.K_SPACE},
+        pygame.MOUSEMOTION: {},
+        pygame.MOUSEBUTTONDOWN: {"button": 1},
+        pygame.MOUSEBUTTONUP: {"button": 1},
+    }
+)
+
+
+NAMES_AND_EVENTS = (
+    ("NoEvent", pygame.NOEVENT),
+    ("ActiveEvent", pygame.ACTIVEEVENT),
+    ("KeyDown", pygame.KEYDOWN),
+    ("KeyUp", pygame.KEYUP),
+    ("MouseMotion", pygame.MOUSEMOTION),
+    ("MouseButtonDown", pygame.MOUSEBUTTONDOWN),
+    ("MouseButtonUp", pygame.MOUSEBUTTONUP),
+    ("JoyAxisMotion", pygame.JOYAXISMOTION),
+    ("JoyBallMotion", pygame.JOYBALLMOTION),
+    ("JoyHatMotion", pygame.JOYHATMOTION),
+    ("JoyButtonDown", pygame.JOYBUTTONDOWN),
+    ("JoyButtonUp", pygame.JOYBUTTONUP),
+    ("VideoResize", pygame.VIDEORESIZE),
+    ("VideoExpose", pygame.VIDEOEXPOSE),
+    ("Quit", pygame.QUIT),
+    ("SysWMEvent", pygame.SYSWMEVENT),
+    ("MidiIn", pygame.MIDIIN),
+    ("MidiOut", pygame.MIDIOUT),
+    ("UserEvent", pygame.USEREVENT),
+    ("Unknown", 0xFFFF),
+    ("FingerMotion", pygame.FINGERMOTION),
+    ("FingerDown", pygame.FINGERDOWN),
+    ("FingerUp", pygame.FINGERUP),
+    ("MultiGesture", pygame.MULTIGESTURE),
+    ("MouseWheel", pygame.MOUSEWHEEL),
+    ("TextInput", pygame.TEXTINPUT),
+    ("TextEditing", pygame.TEXTEDITING),
+    ("ControllerAxisMotion", pygame.CONTROLLERAXISMOTION),
+    ("ControllerButtonDown", pygame.CONTROLLERBUTTONDOWN),
+    ("ControllerButtonUp", pygame.CONTROLLERBUTTONUP),
+    ("ControllerDeviceAdded", pygame.CONTROLLERDEVICEADDED),
+    ("ControllerDeviceRemoved", pygame.CONTROLLERDEVICEREMOVED),
+    ("ControllerDeviceMapped", pygame.CONTROLLERDEVICEREMAPPED),
+    ("DropFile", pygame.DROPFILE),
+    ("AudioDeviceAdded", pygame.AUDIODEVICEADDED),
+    ("AudioDeviceRemoved", pygame.AUDIODEVICEREMOVED),
+    ("DropText", pygame.DROPTEXT),
+    ("DropBegin", pygame.DROPBEGIN),
+    ("DropComplete", pygame.DROPCOMPLETE),
+)
+
+
+class EventTypeTest(unittest.TestCase):
+    def test_Event(self):
+        """Ensure an Event object can be created."""
+        e = pygame.event.Event(pygame.USEREVENT, some_attr=1, other_attr="1")
+
+        self.assertEqual(e.some_attr, 1)
+        self.assertEqual(e.other_attr, "1")
+
+        # Event now uses tp_dictoffset and tp_members:
+        # https://github.com/pygame/pygame/issues/62
+        self.assertEqual(e.type, pygame.USEREVENT)
+        self.assertIs(e.dict, e.__dict__)
+
+        e.some_attr = 12
+
+        self.assertEqual(e.some_attr, 12)
+
+        e.new_attr = 15
+
+        self.assertEqual(e.new_attr, 15)
+
+        self.assertRaises(AttributeError, setattr, e, "type", 0)
+        self.assertRaises(AttributeError, setattr, e, "dict", None)
+
+        # Ensure attributes are visible to dir(), part of the original
+        # posted request.
+        d = dir(e)
+        attrs = ("type", "dict", "__dict__", "some_attr", "other_attr", "new_attr")
+
+        for attr in attrs:
+            self.assertIn(attr, d)
+
+        # redundant type field as kwarg
+        self.assertRaises(ValueError, pygame.event.Event, 10, type=100)
+
+    def test_as_str(self):
+        # Bug reported on Pygame mailing list July 24, 2011:
+        # For Python 3.x str(event) to raises an UnicodeEncodeError when
+        # an event attribute is a string with a non-ascii character.
+        try:
+            str(pygame.event.Event(EVENT_TYPES[0], a="\xed"))
+        except UnicodeEncodeError:
+            self.fail("Event object raised exception for non-ascii character")
+        # Passed.
+
+    def test_event_bool(self):
+        self.assertFalse(pygame.event.Event(pygame.NOEVENT))
+        for event_type in [
+            pygame.MOUSEBUTTONDOWN,
+            pygame.ACTIVEEVENT,
+            pygame.WINDOWLEAVE,
+            pygame.USEREVENT_DROPFILE,
+        ]:
+            self.assertTrue(pygame.event.Event(event_type))
+
+    def test_event_equality(self):
+        """Ensure that events can be compared correctly."""
+        a = pygame.event.Event(EVENT_TYPES[0], a=1)
+        b = pygame.event.Event(EVENT_TYPES[0], a=1)
+        c = pygame.event.Event(EVENT_TYPES[1], a=1)
+        d = pygame.event.Event(EVENT_TYPES[0], a=2)
+
+        # 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
+
+        # 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
+
+        # 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
+
+        # 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 = """
+This test is dependent on timing. The event queue is cleared in preparation for
+tests. There is a small window where outside events from the OS may have effected
+results. Try running the test again.
+"""
+
+
+class EventModuleArgsTest(unittest.TestCase):
+    def setUp(self):
+        pygame.display.init()
+        pygame.event.clear()
+
+    def tearDown(self):
+        pygame.display.quit()
+
+    def test_get(self):
+        pygame.event.get()
+        pygame.event.get(None)
+        pygame.event.get(None, True)
+
+        pygame.event.get(pump=False)
+        pygame.event.get(pump=True)
+        pygame.event.get(eventtype=None)
+        pygame.event.get(eventtype=[pygame.KEYUP, pygame.KEYDOWN])
+        pygame.event.get(eventtype=pygame.USEREVENT, pump=False)
+
+        # event type out of range
+        self.assertRaises(ValueError, pygame.event.get, 0x00010000)
+        self.assertRaises(TypeError, pygame.event.get, 1 + 2j)
+        self.assertRaises(TypeError, pygame.event.get, "foo")
+
+    def test_clear(self):
+        pygame.event.clear()
+        pygame.event.clear(None)
+        pygame.event.clear(None, True)
+
+        pygame.event.clear(pump=False)
+        pygame.event.clear(pump=True)
+        pygame.event.clear(eventtype=None)
+        pygame.event.clear(eventtype=[pygame.KEYUP, pygame.KEYDOWN])
+        pygame.event.clear(eventtype=pygame.USEREVENT, pump=False)
+
+        # event type out of range
+        self.assertRaises(ValueError, pygame.event.clear, 0x0010FFFFF)
+        self.assertRaises(TypeError, pygame.event.get, ["a", "b", "c"])
+
+    def test_peek(self):
+        pygame.event.peek()
+        pygame.event.peek(None)
+        pygame.event.peek(None, True)
+
+        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
+
+        # event type out of range
+        self.assertRaises(ValueError, pygame.event.peek, -1)
+        self.assertRaises(ValueError, pygame.event.peek, [-10])
+        self.assertRaises(TypeError, pygame.event.peek, Foo())
+
+
+class EventCustomTypeTest(unittest.TestCase):
+    """Those tests are special in that they need the _custom_event counter to
+    be reset before and/or after being run."""
+
+    def setUp(self):
+        pygame.quit()
+        pygame.init()
+        pygame.display.init()
+
+    def tearDown(self):
+        pygame.quit()
+
+    def test_custom_type(self):
+        self.assertEqual(pygame.event.custom_type(), pygame.USEREVENT + 1)
+        atype = pygame.event.custom_type()
+        atype2 = pygame.event.custom_type()
+
+        self.assertEqual(atype, atype2 - 1)
+
+        ev = pygame.event.Event(atype)
+        pygame.event.post(ev)
+        queue = pygame.event.get(atype)
+        self.assertEqual(len(queue), 1)
+        self.assertEqual(queue[0].type, atype)
+
+    def test_custom_type__end_boundary(self):
+        """Ensure custom_type() raises error when no more custom types.
+
+        The last allowed custom type number should be (pygame.NUMEVENTS - 1).
+        """
+        last = -1
+        start = pygame.event.custom_type() + 1
+        for _ in range(start, pygame.NUMEVENTS):
+            last = pygame.event.custom_type()
+
+        self.assertEqual(last, pygame.NUMEVENTS - 1)
+        with self.assertRaises(pygame.error):
+            pygame.event.custom_type()
+
+    def test_custom_type__reset(self):
+        """Ensure custom events get 'deregistered' by quit()."""
+        before = pygame.event.custom_type()
+        self.assertEqual(before, pygame.event.custom_type() - 1)
+        pygame.quit()
+        pygame.init()
+        pygame.display.init()
+        self.assertEqual(before, pygame.event.custom_type())
+
+
+class EventModuleTest(unittest.TestCase):
+    def _assertCountEqual(self, *args, **kwargs):
+        # Handle method name differences between Python versions.
+        # Is this still needed?
+        self.assertCountEqual(*args, **kwargs)
+
+    def _assertExpectedEvents(self, expected, got):
+        """Find events like expected events, raise on unexpected or missing,
+        ignore additional event properties if expected properties are present."""
+
+        # This does greedy matching, don't encode an NP-hard problem
+        # into your input data, *please*
+        items_left = got[:]
+        for expected_element in expected:
+            for item in items_left:
+                for key in expected_element.__dict__:
+                    if item.__dict__[key] != expected_element.__dict__[key]:
+                        break
+                else:
+                    # found item!
+                    items_left.remove(item)
+                    break
+            else:
+                raise AssertionError(
+                    "Expected "
+                    + str(expected_element)
+                    + " among remaining events "
+                    + str(items_left)
+                    + " out of "
+                    + str(got)
+                )
+        if len(items_left) > 0:
+            raise AssertionError("Unexpected Events: " + str(items_left))
+
+    def setUp(self):
+        pygame.display.init()
+        pygame.event.clear()  # flush events
+
+    def tearDown(self):
+        pygame.event.clear()  # flush events
+        pygame.display.quit()
+
+    def test_event_numevents(self):
+        """Ensures NUMEVENTS does not exceed the maximum SDL number of events."""
+        # Ref: https://www.libsdl.org/tmp/SDL/include/SDL_events.h
+        MAX_SDL_EVENTS = 0xFFFF  # SDL_LASTEVENT = 0xFFFF
+
+        self.assertLessEqual(pygame.NUMEVENTS, MAX_SDL_EVENTS)
+
+    def test_event_attribute(self):
+        e1 = pygame.event.Event(pygame.USEREVENT, attr1="attr1")
+        self.assertEqual(e1.attr1, "attr1")
+
+    def test_set_blocked(self):
+        """Ensure events can be blocked from the queue."""
+        event = EVENT_TYPES[0]
+        unblocked_event = EVENT_TYPES[1]
+        pygame.event.set_blocked(event)
+
+        self.assertTrue(pygame.event.get_blocked(event))
+        self.assertFalse(pygame.event.get_blocked(unblocked_event))
+
+        posted = pygame.event.post(
+            pygame.event.Event(event, **EVENT_TEST_PARAMS[event])
+        )
+        self.assertFalse(posted)
+
+        # post an unblocked event
+        posted = pygame.event.post(
+            pygame.event.Event(unblocked_event, **EVENT_TEST_PARAMS[unblocked_event])
+        )
+        self.assertTrue(posted)
+
+        ret = pygame.event.get()
+        should_be_blocked = [e for e in ret if e.type == event]
+        should_be_allowed_types = [e.type for e in ret if e.type != event]
+
+        self.assertEqual(should_be_blocked, [])
+        self.assertTrue(unblocked_event in should_be_allowed_types)
+
+    def test_set_blocked__event_sequence(self):
+        """Ensure a sequence of event types can be blocked."""
+        event_types = [
+            pygame.KEYDOWN,
+            pygame.KEYUP,
+            pygame.MOUSEMOTION,
+            pygame.MOUSEBUTTONDOWN,
+            pygame.MOUSEBUTTONUP,
+            pygame.WINDOWFOCUSLOST,
+            pygame.USEREVENT,
+        ]
+
+        pygame.event.set_blocked(event_types)
+
+        for etype in event_types:
+            self.assertTrue(pygame.event.get_blocked(etype))
+
+    def test_set_blocked_all(self):
+        """Ensure all events can be unblocked at once."""
+        pygame.event.set_blocked(None)
+
+        for e in EVENT_TYPES:
+            self.assertTrue(pygame.event.get_blocked(e))
+
+    def test_post__and_poll(self):
+        """Ensure events can be posted to the queue."""
+        e1 = pygame.event.Event(pygame.USEREVENT, attr1="attr1")
+        pygame.event.post(e1)
+        posted_event = pygame.event.poll()
+
+        self.assertEqual(e1.attr1, posted_event.attr1, race_condition_notification)
+
+        # fuzzing event types
+        for i in range(1, 13):
+            pygame.event.post(
+                pygame.event.Event(EVENT_TYPES[i], **EVENT_TEST_PARAMS[EVENT_TYPES[i]])
+            )
+
+            self.assertEqual(
+                pygame.event.poll().type, EVENT_TYPES[i], race_condition_notification
+            )
+
+    def test_post_and_get_keydown(self):
+        """Ensure keydown events can be posted to the queue."""
+        activemodkeys = pygame.key.get_mods()
+
+        events = [
+            pygame.event.Event(pygame.KEYDOWN, key=pygame.K_p),
+            pygame.event.Event(pygame.KEYDOWN, key=pygame.K_y, mod=activemodkeys),
+            pygame.event.Event(pygame.KEYDOWN, key=pygame.K_g, unicode="g"),
+            pygame.event.Event(pygame.KEYDOWN, key=pygame.K_a, unicode=None),
+            pygame.event.Event(pygame.KEYDOWN, key=pygame.K_m, mod=None, window=None),
+            pygame.event.Event(
+                pygame.KEYDOWN, key=pygame.K_e, mod=activemodkeys, unicode="e"
+            ),
+        ]
+
+        for e in events:
+            pygame.event.post(e)
+            posted_event = pygame.event.poll()
+            self.assertEqual(e, posted_event, race_condition_notification)
+
+    def test_post_large_user_event(self):
+        pygame.event.post(
+            pygame.event.Event(
+                pygame.USEREVENT, {"a": "a" * 1024}, test=list(range(100))
+            )
+        )
+        e = pygame.event.poll()
+
+        self.assertEqual(e.type, pygame.USEREVENT)
+        self.assertEqual(e.a, "a" * 1024)
+        self.assertEqual(e.test, list(range(100)))
+
+    def test_post_blocked(self):
+        """
+        Test blocked events are not posted. Also test whether post()
+        returns a boolean correctly
+        """
+        pygame.event.set_blocked(pygame.USEREVENT)
+        self.assertFalse(pygame.event.post(pygame.event.Event(pygame.USEREVENT)))
+        self.assertFalse(pygame.event.poll())
+        pygame.event.set_allowed(pygame.USEREVENT)
+        self.assertTrue(pygame.event.post(pygame.event.Event(pygame.USEREVENT)))
+        self.assertEqual(pygame.event.poll(), pygame.event.Event(pygame.USEREVENT))
+
+    def test_get(self):
+        """Ensure get() retrieves all the events on the queue."""
+        event_cnt = 10
+        for _ in range(event_cnt):
+            pygame.event.post(pygame.event.Event(pygame.USEREVENT))
+
+        queue = pygame.event.get()
+
+        self.assertEqual(len(queue), event_cnt)
+        self.assertTrue(all(e.type == pygame.USEREVENT for e in queue))
+
+    def test_get_type(self):
+        ev = pygame.event.Event(pygame.USEREVENT)
+        pygame.event.post(ev)
+        queue = pygame.event.get(pygame.USEREVENT)
+        self.assertEqual(len(queue), 1)
+        self.assertEqual(queue[0].type, pygame.USEREVENT)
+
+        TESTEVENTS = 10
+        for _ in range(TESTEVENTS):
+            pygame.event.post(ev)
+        q = pygame.event.get([pygame.USEREVENT])
+        self.assertEqual(len(q), TESTEVENTS)
+        for event in q:
+            self.assertEqual(event, ev)
+
+    def test_get_exclude_throw(self):
+        self.assertRaises(
+            pygame.error, pygame.event.get, pygame.KEYDOWN, False, pygame.KEYUP
+        )
+
+    def test_get_exclude(self):
+        pygame.event.post(pygame.event.Event(pygame.USEREVENT))
+        pygame.event.post(pygame.event.Event(pygame.KEYDOWN))
+
+        queue = pygame.event.get(exclude=pygame.KEYDOWN)
+        self.assertEqual(len(queue), 1)
+        self.assertEqual(queue[0].type, pygame.USEREVENT)
+
+        pygame.event.post(pygame.event.Event(pygame.KEYUP))
+        pygame.event.post(pygame.event.Event(pygame.USEREVENT))
+        queue = pygame.event.get(exclude=(pygame.KEYDOWN, pygame.KEYUP))
+        self.assertEqual(len(queue), 1)
+        self.assertEqual(queue[0].type, pygame.USEREVENT)
+
+        queue = pygame.event.get()
+        self.assertEqual(len(queue), 2)
+
+    def test_get__empty_queue(self):
+        """Ensure get() works correctly on an empty queue."""
+        expected_events = []
+        pygame.event.clear()
+
+        # Ensure all events can be checked.
+        retrieved_events = pygame.event.get()
+
+        self.assertListEqual(retrieved_events, expected_events)
+
+        # Ensure events can be checked individually.
+        for event_type in EVENT_TYPES:
+            retrieved_events = pygame.event.get(event_type)
+
+            self.assertListEqual(retrieved_events, expected_events)
+
+        # Ensure events can be checked as a sequence.
+        retrieved_events = pygame.event.get(EVENT_TYPES)
+
+        self.assertListEqual(retrieved_events, expected_events)
+
+    def test_get__event_sequence(self):
+        """Ensure get() can handle a sequence of event types."""
+        event_types = [pygame.KEYDOWN, pygame.KEYUP, pygame.MOUSEMOTION]
+        other_event_type = pygame.MOUSEBUTTONUP
+
+        # Test when no events in the queue.
+        expected_events = []
+        pygame.event.clear()
+        retrieved_events = pygame.event.get(event_types)
+
+        # don't use self._assertCountEqual here. This checks for
+        # expected properties in events, and ignores unexpected ones, for
+        # forward compatibility with SDL2.
+        self._assertExpectedEvents(expected=expected_events, got=retrieved_events)
+
+        # Test when an event type not in the list is in the queue.
+        expected_events = []
+        pygame.event.clear()
+        pygame.event.post(
+            pygame.event.Event(other_event_type, **EVENT_TEST_PARAMS[other_event_type])
+        )
+
+        retrieved_events = pygame.event.get(event_types)
+
+        self._assertExpectedEvents(expected=expected_events, got=retrieved_events)
+
+        # Test when 1 event type in the list is in the queue.
+        expected_events = [
+            pygame.event.Event(event_types[0], **EVENT_TEST_PARAMS[event_types[0]])
+        ]
+        pygame.event.clear()
+        pygame.event.post(expected_events[0])
+
+        retrieved_events = pygame.event.get(event_types)
+
+        self._assertExpectedEvents(expected=expected_events, got=retrieved_events)
+
+        # Test all events in the list are in the queue.
+        pygame.event.clear()
+        expected_events = []
+
+        for etype in event_types:
+            expected_events.append(
+                pygame.event.Event(etype, **EVENT_TEST_PARAMS[etype])
+            )
+            pygame.event.post(expected_events[-1])
+
+        retrieved_events = pygame.event.get(event_types)
+
+        self._assertExpectedEvents(expected=expected_events, got=retrieved_events)
+
+    def test_get_clears_queue(self):
+        """Ensure get() clears the event queue after a call"""
+        pygame.event.get()  # should clear the queue completely by getting all events
+        self.assertEqual(pygame.event.get(), [])
+
+    def test_clear(self):
+        """Ensure clear() removes all the events on the queue."""
+        for e in EVENT_TYPES:
+            pygame.event.post(pygame.event.Event(e, **EVENT_TEST_PARAMS[e]))
+        poll_event = pygame.event.poll()
+
+        self.assertNotEqual(poll_event.type, pygame.NOEVENT)
+
+        pygame.event.clear()
+        poll_event = pygame.event.poll()
+
+        self.assertEqual(poll_event.type, pygame.NOEVENT, race_condition_notification)
+
+    def test_clear__empty_queue(self):
+        """Ensure clear() works correctly on an empty queue."""
+        expected_events = []
+        pygame.event.clear()
+
+        # Test calling clear() on an already empty queue.
+        pygame.event.clear()
+
+        retrieved_events = pygame.event.get()
+
+        self.assertListEqual(retrieved_events, expected_events)
+
+    def test_clear__event_sequence(self):
+        """Ensure a sequence of event types can be cleared from the queue."""
+        cleared_event_types = EVENT_TYPES[:5]
+        expected_event_types = EVENT_TYPES[5:10]
+        expected_events = []
+
+        # Add the events to the queue.
+        for etype in cleared_event_types:
+            pygame.event.post(pygame.event.Event(etype, **EVENT_TEST_PARAMS[etype]))
+
+        for etype in expected_events:
+            expected_events.append(
+                pygame.event.Event(etype, **EVENT_TEST_PARAMS[etype])
+            )
+            pygame.event.post(expected_events[-1])
+
+        # Clear the cleared_events from the queue.
+        pygame.event.clear(cleared_event_types)
+
+        # Check the rest of the events in the queue.
+        remaining_events = pygame.event.get()
+
+        self._assertCountEqual(remaining_events, expected_events)
+
+    def test_event_name(self):
+        """Ensure event_name() returns the correct event name."""
+        for expected_name, event in NAMES_AND_EVENTS:
+            self.assertEqual(
+                pygame.event.event_name(event), expected_name, f"0x{event:X}"
+            )
+
+    def test_event_name__userevent_range(self):
+        """Ensures event_name() returns the correct name for user events.
+
+        Tests the full range of user events.
+        """
+        expected_name = "UserEvent"
+
+        for event in range(pygame.USEREVENT, pygame.NUMEVENTS):
+            self.assertEqual(
+                pygame.event.event_name(event), expected_name, f"0x{event:X}"
+            )
+
+    def test_event_name__userevent_boundary(self):
+        """Ensures event_name() does not return 'UserEvent' for events
+        just outside the user event range.
+        """
+        unexpected_name = "UserEvent"
+
+        for event in (pygame.USEREVENT - 1, pygame.NUMEVENTS):
+            self.assertNotEqual(
+                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]
+
+        for event_type in event_types:
+            pygame.event.post(
+                pygame.event.Event(event_type, **EVENT_TEST_PARAMS[event_type])
+            )
+
+        # Ensure events can be checked individually.
+        for event_type in event_types:
+            self.assertTrue(pygame.event.peek(event_type))
+
+        # Ensure events can be checked as a sequence.
+        self.assertTrue(pygame.event.peek(event_types))
+
+    def test_peek__event_sequence(self):
+        """Ensure peek() can handle a sequence of event types."""
+        event_types = [pygame.KEYDOWN, pygame.KEYUP, pygame.MOUSEMOTION]
+        other_event_type = pygame.MOUSEBUTTONUP
+
+        # Test when no events in the queue.
+        pygame.event.clear()
+        peeked = pygame.event.peek(event_types)
+
+        self.assertFalse(peeked)
+
+        # Test when an event type not in the list is in the queue.
+        pygame.event.clear()
+        pygame.event.post(
+            pygame.event.Event(other_event_type, **EVENT_TEST_PARAMS[other_event_type])
+        )
+
+        peeked = pygame.event.peek(event_types)
+
+        self.assertFalse(peeked)
+
+        # Test when 1 event type in the list is in the queue.
+        pygame.event.clear()
+        pygame.event.post(
+            pygame.event.Event(event_types[0], **EVENT_TEST_PARAMS[event_types[0]])
+        )
+
+        peeked = pygame.event.peek(event_types)
+
+        self.assertTrue(peeked)
+
+        # Test all events in the list are in the queue.
+        pygame.event.clear()
+        for etype in event_types:
+            pygame.event.post(pygame.event.Event(etype, **EVENT_TEST_PARAMS[etype]))
+
+        peeked = pygame.event.peek(event_types)
+
+        self.assertTrue(peeked)
+
+    def test_peek__empty_queue(self):
+        """Ensure peek() works correctly on an empty queue."""
+        pygame.event.clear()
+
+        # Ensure all events can be checked.
+        peeked = pygame.event.peek()
+
+        self.assertFalse(peeked)
+
+        # Ensure events can be checked individually.
+        for event_type in EVENT_TYPES:
+            peeked = pygame.event.peek(event_type)
+            self.assertFalse(peeked)
+
+        # Ensure events can be checked as a sequence.
+        peeked = pygame.event.peek(EVENT_TYPES)
+
+        self.assertFalse(peeked)
+
+    def test_set_allowed(self):
+        """Ensure a blocked event type can be unblocked/allowed."""
+        event = EVENT_TYPES[0]
+        pygame.event.set_blocked(event)
+
+        self.assertTrue(pygame.event.get_blocked(event))
+
+        pygame.event.set_allowed(event)
+
+        self.assertFalse(pygame.event.get_blocked(event))
+
+    def test_set_allowed__event_sequence(self):
+        """Ensure a sequence of blocked event types can be unblocked/allowed."""
+        event_types = [
+            pygame.KEYDOWN,
+            pygame.KEYUP,
+            pygame.MOUSEMOTION,
+            pygame.MOUSEBUTTONDOWN,
+            pygame.MOUSEBUTTONUP,
+        ]
+        pygame.event.set_blocked(event_types)
+
+        pygame.event.set_allowed(event_types)
+
+        for etype in event_types:
+            self.assertFalse(pygame.event.get_blocked(etype))
+
+    def test_set_allowed_all(self):
+        """Ensure all events can be unblocked/allowed at once."""
+        pygame.event.set_blocked(None)
+
+        for e in EVENT_TYPES:
+            self.assertTrue(pygame.event.get_blocked(e))
+
+        pygame.event.set_allowed(None)
+
+        for e in EVENT_TYPES:
+            self.assertFalse(pygame.event.get_blocked(e))
+
+    def test_pump(self):
+        """Ensure pump() functions properly."""
+        pygame.event.pump()
+
+    # @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.
+
+        WARNING: Moving the mouse off the display during this test can cause it
+                 to fail.
+        """
+        surf = pygame.display.set_mode((10, 10))
+        pygame.event.set_grab(True)
+
+        self.assertTrue(pygame.event.get_grab())
+
+        pygame.event.set_grab(False)
+
+        self.assertFalse(pygame.event.get_grab())
+
+    def test_get_blocked(self):
+        """Ensure an event's blocked state can be retrieved."""
+        # Test each event is not blocked.
+        pygame.event.set_allowed(None)
+
+        for etype in EVENT_TYPES:
+            blocked = pygame.event.get_blocked(etype)
+
+            self.assertFalse(blocked)
+
+        # Test each event type is blocked.
+        pygame.event.set_blocked(None)
+
+        for etype in EVENT_TYPES:
+            blocked = pygame.event.get_blocked(etype)
+
+            self.assertTrue(blocked)
+
+    def test_get_blocked__event_sequence(self):
+        """Ensure get_blocked() can handle a sequence of event types."""
+        event_types = [
+            pygame.KEYDOWN,
+            pygame.KEYUP,
+            pygame.MOUSEMOTION,
+            pygame.MOUSEBUTTONDOWN,
+            pygame.MOUSEBUTTONUP,
+            pygame.WINDOWMINIMIZED,
+            pygame.USEREVENT,
+        ]
+
+        # Test no event types in the list are blocked.
+        blocked = pygame.event.get_blocked(event_types)
+
+        self.assertFalse(blocked)
+
+        # Test when 1 event type in the list is blocked.
+        pygame.event.set_blocked(event_types[2])
+
+        blocked = pygame.event.get_blocked(event_types)
+
+        self.assertTrue(blocked)
+
+        # Test all event types in the list are blocked.
+        pygame.event.set_blocked(event_types)
+
+        blocked = pygame.event.get_blocked(event_types)
+
+        self.assertTrue(blocked)
+
+    # @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))
+        # Test 5 times
+        for i in range(5):
+            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()
+        ev = pygame.event.poll()
+        # poll() on empty queue should return NOEVENT
+        self.assertEqual(ev.type, pygame.NOEVENT)
+
+        # test poll returns stuff in same order
+        e1 = pygame.event.Event(pygame.USEREVENT)
+        e2 = pygame.event.Event(pygame.KEYDOWN, key=pygame.K_a)
+        e3 = pygame.event.Event(pygame.KEYUP, key=pygame.K_a)
+        pygame.event.post(e1)
+        pygame.event.post(e2)
+        pygame.event.post(e3)
+
+        self.assertEqual(pygame.event.poll().type, e1.type)
+        self.assertEqual(pygame.event.poll().type, e2.type)
+        self.assertEqual(pygame.event.poll().type, e3.type)
+        self.assertEqual(pygame.event.poll().type, pygame.NOEVENT)
+
+
+class EventModuleTestsWithTiming(unittest.TestCase):
+    __tags__ = ["timing"]
+
+    def setUp(self):
+        pygame.display.init()
+        pygame.event.clear()  # flush events
+
+    def tearDown(self):
+        pygame.event.clear()  # flush events
+        pygame.display.quit()
+
+    def test_event_wait(self):
+        """Ensure wait() waits for an event on the queue."""
+        # Test case without timeout.
+        event = pygame.event.Event(EVENT_TYPES[0], **EVENT_TEST_PARAMS[EVENT_TYPES[0]])
+        pygame.event.post(event)
+        wait_event = pygame.event.wait()
+
+        self.assertEqual(wait_event.type, event.type)
+
+        # Test case with timeout and no event in the queue.
+        wait_event = pygame.event.wait(100)
+        self.assertEqual(wait_event.type, pygame.NOEVENT)
+
+        # Test case with timeout and an event in the queue.
+        event = pygame.event.Event(EVENT_TYPES[0], **EVENT_TEST_PARAMS[EVENT_TYPES[0]])
+        pygame.event.post(event)
+        wait_event = pygame.event.wait(100)
+
+        self.assertEqual(wait_event.type, event.type)
+
+        # test wait with timeout waits for the correct duration
+        pygame.time.set_timer(pygame.USEREVENT, 50, 3)
+
+        for wait_time, expected_type, expected_time in (
+            (60, pygame.USEREVENT, 50),
+            (65, pygame.USEREVENT, 50),
+            (20, pygame.NOEVENT, 20),
+            (45, pygame.USEREVENT, 30),
+            (70, pygame.NOEVENT, 70),
+        ):
+            start_time = time.perf_counter()
+            self.assertEqual(pygame.event.wait(wait_time).type, expected_type)
+            self.assertAlmostEqual(
+                time.perf_counter() - start_time, expected_time / 1000, delta=0.01
+            )
+
+        # test wait without timeout waits for the full duration
+        pygame.time.set_timer(pygame.USEREVENT, 100, 1)
+
+        start_time = time.perf_counter()
+        self.assertEqual(pygame.event.wait().type, pygame.USEREVENT)
+        self.assertAlmostEqual(time.perf_counter() - start_time, 0.1, delta=0.01)
+
+        # test wait returns no event if event is arriving later
+        pygame.time.set_timer(pygame.USEREVENT, 50, 1)
+        self.assertEqual(pygame.event.wait(40).type, pygame.NOEVENT)
+
+
+################################################################################
+
+if __name__ == "__main__":
+    unittest.main()
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/fixtures/fonts/A_PyGameMono-8.png b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/fixtures/fonts/A_PyGameMono-8.png
new file mode 100644
index 0000000..b15961f
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/fixtures/fonts/A_PyGameMono-8.png differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/fixtures/fonts/PlayfairDisplaySemibold.ttf b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/fixtures/fonts/PlayfairDisplaySemibold.ttf
new file mode 100644
index 0000000..c1213a7
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/fixtures/fonts/PlayfairDisplaySemibold.ttf differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/fixtures/fonts/PyGameMono-18-100dpi.bdf b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/fixtures/fonts/PyGameMono-18-100dpi.bdf
new file mode 100644
index 0000000..a88f083
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/fixtures/fonts/PyGameMono-18-100dpi.bdf
@@ -0,0 +1,165 @@
+STARTFONT 2.1
+FONT -FontForge-PyGameMono-Medium-R-Normal--25-180-100-100-M-250-ISO10646-1
+SIZE 18 100 100
+FONTBOUNDINGBOX 21 22 0 0
+COMMENT "Generated by fontforge, http://fontforge.sourceforge.net"
+COMMENT "Created by Lenard Lindstrom,,, with FontForge 2.0 (http://fontforge.sf.net)"
+STARTPROPERTIES 29
+FOUNDRY "FontForge"
+FAMILY_NAME "PyGameMono"
+WEIGHT_NAME "Medium"
+SLANT "R"
+SETWIDTH_NAME "Normal"
+ADD_STYLE_NAME ""
+PIXEL_SIZE 25
+POINT_SIZE 180
+RESOLUTION_X 100
+RESOLUTION_Y 100
+SPACING "M"
+AVERAGE_WIDTH 250
+CHARSET_REGISTRY "ISO10646"
+CHARSET_ENCODING "1"
+FONTNAME_REGISTRY ""
+CHARSET_COLLECTIONS "ISO10646-1"
+FONT_NAME "PyGameMono"
+FACE_NAME "PyGame Mono"
+FONT_VERSION "001.000"
+FONT_ASCENT 20
+FONT_DESCENT 5
+UNDERLINE_POSITION -2
+UNDERLINE_THICKNESS 2
+RAW_ASCENT 800
+RAW_DESCENT 200
+RELATIVE_WEIGHT 50
+RELATIVE_SETWIDTH 50
+FIGURE_WIDTH -1
+AVG_UPPERCASE_WIDTH 250
+ENDPROPERTIES
+CHARS 5
+STARTCHAR .notdef
+ENCODING 0
+SWIDTH 1000 0
+DWIDTH 25 0
+BBX 20 20 0 0
+BITMAP
+FFFFF0
+FFFFF0
+FE07F0
+F801F0
+F000F0
+E00070
+E00070
+C00030
+C00030
+C00030
+C00030
+C00030
+C00030
+E00070
+E00070
+F000F0
+F801F0
+FE07F0
+FFFFF0
+FFFFF0
+ENDCHAR
+STARTCHAR A
+ENCODING 65
+SWIDTH 1000 0
+DWIDTH 25 0
+BBX 20 21 0 1
+BITMAP
+03FC00
+1FFF80
+3FFFC0
+7C03E0
+F000F0
+E00070
+E00070
+F000F0
+FC03F0
+FFFFF0
+FFFFF0
+FFFFF0
+FF0FF0
+7C03F0
+7801E0
+7800E0
+7000E0
+700060
+600060
+200040
+200040
+ENDCHAR
+STARTCHAR B
+ENCODING 66
+SWIDTH 1000 0
+DWIDTH 25 0
+BBX 18 20 1 0
+BITMAP
+FFFE00
+FFFF80
+7E0780
+7801C0
+7000C0
+3000C0
+3000C0
+3801C0
+3E0780
+3FFF00
+3FFF00
+3E0780
+380180
+3000C0
+3000C0
+3000C0
+7801C0
+7E07C0
+FFFF80
+FFFE00
+ENDCHAR
+STARTCHAR C
+ENCODING 67
+SWIDTH 1000 0
+DWIDTH 25 0
+BBX 20 20 0 0
+BITMAP
+00FC00
+03FF00
+0FFF80
+1F03E0
+3E0070
+7C0010
+780000
+F80000
+F00000
+F00000
+F00000
+F00000
+F80000
+780000
+7C0010
+3E0070
+1F01E0
+0FFFC0
+03FF80
+00FE00
+ENDCHAR
+STARTCHAR u13079
+ENCODING 77945
+SWIDTH 1000 0
+DWIDTH 25 0
+BBX 21 10 0 5
+BITMAP
+03FC00
+0FFF80
+1E73C0
+78F8F0
+F0F878
+70F870
+3870E0
+1E03C0
+0FFF80
+03FC00
+ENDCHAR
+ENDFONT
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/fixtures/fonts/PyGameMono-18-75dpi.bdf b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/fixtures/fonts/PyGameMono-18-75dpi.bdf
new file mode 100644
index 0000000..127f704
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/fixtures/fonts/PyGameMono-18-75dpi.bdf
@@ -0,0 +1,143 @@
+STARTFONT 2.1
+FONT -FontForge-PyGameMono-Medium-R-Normal--19-180-75-75-M-190-ISO10646-1
+SIZE 18 75 75
+FONTBOUNDINGBOX 15 17 0 0
+COMMENT "Generated by fontforge, http://fontforge.sourceforge.net"
+COMMENT "Created by Lenard Lindstrom,,, with FontForge 2.0 (http://fontforge.sf.net)"
+STARTPROPERTIES 29
+FOUNDRY "FontForge"
+FAMILY_NAME "PyGameMono"
+WEIGHT_NAME "Medium"
+SLANT "R"
+SETWIDTH_NAME "Normal"
+ADD_STYLE_NAME ""
+PIXEL_SIZE 19
+POINT_SIZE 180
+RESOLUTION_X 75
+RESOLUTION_Y 75
+SPACING "M"
+AVERAGE_WIDTH 190
+CHARSET_REGISTRY "ISO10646"
+CHARSET_ENCODING "1"
+FONTNAME_REGISTRY ""
+CHARSET_COLLECTIONS "ISO10646-1"
+FONT_NAME "PyGameMono"
+FACE_NAME "PyGame Mono"
+FONT_VERSION "001.000"
+FONT_ASCENT 15
+FONT_DESCENT 4
+UNDERLINE_POSITION -2
+UNDERLINE_THICKNESS 1
+RAW_ASCENT 800
+RAW_DESCENT 200
+RELATIVE_WEIGHT 50
+RELATIVE_SETWIDTH 50
+FIGURE_WIDTH -1
+AVG_UPPERCASE_WIDTH 190
+ENDPROPERTIES
+CHARS 5
+STARTCHAR .notdef
+ENCODING 0
+SWIDTH 1000 0
+DWIDTH 19 0
+BBX 15 15 0 0
+BITMAP
+FFFE
+FFFE
+FC7E
+F01E
+E00E
+C006
+C006
+C006
+C006
+C006
+E00E
+F01E
+FC7E
+FFFE
+FFFE
+ENDCHAR
+STARTCHAR A
+ENCODING 65
+SWIDTH 1000 0
+DWIDTH 19 0
+BBX 15 17 0 0
+BITMAP
+0FE0
+3FF8
+783C
+F01E
+E00E
+E00E
+F01E
+F83E
+FFFE
+FFFE
+FC7E
+701C
+701C
+600C
+600C
+4004
+4004
+ENDCHAR
+STARTCHAR B
+ENCODING 66
+SWIDTH 1000 0
+DWIDTH 19 0
+BBX 15 15 0 0
+BITMAP
+FFF8
+7FFC
+780E
+3006
+3006
+380E
+3FF8
+3FF8
+3FF8
+380E
+3006
+3006
+7C1E
+7FFC
+FFF8
+ENDCHAR
+STARTCHAR C
+ENCODING 67
+SWIDTH 1000 0
+DWIDTH 19 0
+BBX 15 15 0 0
+BITMAP
+03E0
+0FF8
+3C1C
+7806
+7000
+E000
+E000
+E000
+E000
+E000
+7000
+7806
+3C1C
+0FF8
+03E0
+ENDCHAR
+STARTCHAR u13079
+ENCODING 77945
+SWIDTH 1000 0
+DWIDTH 19 0
+BBX 15 7 0 4
+BITMAP
+0FE0
+3838
+638C
+E38E
+638C
+3838
+0FE0
+ENDCHAR
+ENDFONT
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/fixtures/fonts/PyGameMono-8.bdf b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/fixtures/fonts/PyGameMono-8.bdf
new file mode 100644
index 0000000..17bef06
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/fixtures/fonts/PyGameMono-8.bdf
@@ -0,0 +1,103 @@
+STARTFONT 2.1
+FONT -FontForge-PyGameMono-Medium-R-Normal--8-80-75-75-C-80-ISO10646-1
+SIZE 8 75 75
+FONTBOUNDINGBOX 6 7 0 0
+COMMENT "Generated by fontforge, http://fontforge.sourceforge.net"
+COMMENT "Created by Lenard Lindstrom,,, with FontForge 2.0 (http://fontforge.sf.net)"
+STARTPROPERTIES 29
+FOUNDRY "FontForge"
+FAMILY_NAME "PyGameMono"
+WEIGHT_NAME "Medium"
+SLANT "R"
+SETWIDTH_NAME "Normal"
+ADD_STYLE_NAME ""
+PIXEL_SIZE 8
+POINT_SIZE 80
+RESOLUTION_X 75
+RESOLUTION_Y 75
+SPACING "C"
+AVERAGE_WIDTH 80
+CHARSET_REGISTRY "ISO10646"
+CHARSET_ENCODING "1"
+FONTNAME_REGISTRY ""
+CHARSET_COLLECTIONS "ISO10646-1"
+FONT_NAME "PyGameMono"
+FACE_NAME "PyGame Mono"
+FONT_VERSION "001.000"
+FONT_ASCENT 6
+FONT_DESCENT 2
+UNDERLINE_POSITION -1
+UNDERLINE_THICKNESS 1
+RAW_ASCENT 800
+RAW_DESCENT 200
+RELATIVE_WEIGHT 50
+RELATIVE_SETWIDTH 50
+FIGURE_WIDTH -1
+AVG_UPPERCASE_WIDTH 80
+ENDPROPERTIES
+CHARS 5
+STARTCHAR .notdef
+ENCODING 0
+SWIDTH 1000 0
+DWIDTH 8 0
+BBX 6 6 0 0
+BITMAP
+FC
+84
+84
+84
+84
+FC
+ENDCHAR
+STARTCHAR A
+ENCODING 65
+SWIDTH 1000 0
+DWIDTH 8 0
+BBX 6 7 0 0
+BITMAP
+78
+84
+84
+FC
+84
+84
+84
+ENDCHAR
+STARTCHAR B
+ENCODING 66
+SWIDTH 1000 0
+DWIDTH 8 0
+BBX 6 6 0 0
+BITMAP
+FC
+44
+78
+4C
+44
+FC
+ENDCHAR
+STARTCHAR C
+ENCODING 67
+SWIDTH 1000 0
+DWIDTH 8 0
+BBX 6 6 0 0
+BITMAP
+78
+C4
+C0
+C0
+C4
+78
+ENDCHAR
+STARTCHAR u13079
+ENCODING 77945
+SWIDTH 1000 0
+DWIDTH 8 0
+BBX 6 4 0 1
+BITMAP
+78
+B4
+B4
+78
+ENDCHAR
+ENDFONT
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/fixtures/fonts/PyGameMono.otf b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/fixtures/fonts/PyGameMono.otf
new file mode 100644
index 0000000..5e9b66c
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/fixtures/fonts/PyGameMono.otf differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/fixtures/fonts/test_fixed.otf b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/fixtures/fonts/test_fixed.otf
new file mode 100644
index 0000000..3488898
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/fixtures/fonts/test_fixed.otf differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/fixtures/fonts/test_sans.ttf b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/fixtures/fonts/test_sans.ttf
new file mode 100644
index 0000000..09fac2f
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/fixtures/fonts/test_sans.ttf differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/fixtures/fonts/u13079_PyGameMono-8.png b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/fixtures/fonts/u13079_PyGameMono-8.png
new file mode 100644
index 0000000..911da8a
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/fixtures/fonts/u13079_PyGameMono-8.png differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/fixtures/xbm_cursors/white_sizing.xbm b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/fixtures/xbm_cursors/white_sizing.xbm
new file mode 100644
index 0000000..d334d8d
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/fixtures/xbm_cursors/white_sizing.xbm
@@ -0,0 +1,8 @@
+#define resize_white_width 16
+#define resize_white_height 16
+#define resize_white_x_hot 7
+#define resize_white_y_hot 7
+static unsigned char resize_white_bits[] = {
+   0xff, 0x03, 0x01, 0x02, 0xfd, 0x03, 0x05, 0x00, 0xf5, 0x0f, 0x15, 0x08,
+   0xd5, 0xeb, 0x55, 0xaa, 0x55, 0xaa, 0xd7, 0xab, 0x10, 0xa8, 0xf0, 0xb7,
+   0x00, 0xa8, 0xc0, 0x9f, 0x40, 0x80, 0xc0, 0xff};
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/fixtures/xbm_cursors/white_sizing_mask.xbm b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/fixtures/xbm_cursors/white_sizing_mask.xbm
new file mode 100644
index 0000000..f00bc46
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/fixtures/xbm_cursors/white_sizing_mask.xbm
@@ -0,0 +1,8 @@
+#define resize_white_mask_width 16
+#define resize_white_mask_height 16
+#define resize_white_mask_x_hot 7
+#define resize_white_mask_y_hot 7
+static unsigned char resize_white_mask_bits[] = {
+   0xff, 0x03, 0xff, 0x03, 0xff, 0x03, 0x07, 0x00, 0xf7, 0x0f, 0xf7, 0x0f,
+   0xf7, 0xef, 0x77, 0xee, 0x77, 0xee, 0xf7, 0xef, 0xf0, 0xef, 0xf0, 0xff,
+   0x00, 0xf8, 0xc0, 0xff, 0xc0, 0xff, 0xc0, 0xff};
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/font_test.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/font_test.py
new file mode 100644
index 0000000..8d6dc6b
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/font_test.py
@@ -0,0 +1,748 @@
+# -*- coding: utf-8 -*-
+import sys
+import os
+import unittest
+import pathlib
+import platform
+
+import pygame
+from pygame import font as pygame_font  # So font can be replaced with ftfont
+
+
+FONTDIR = os.path.join(os.path.dirname(os.path.abspath(__file__)), "fixtures", "fonts")
+
+
+def equal_images(s1, s2):
+    size = s1.get_size()
+    if s2.get_size() != size:
+        return False
+    w, h = size
+    for x in range(w):
+        for y in range(h):
+            if s1.get_at((x, y)) != s2.get_at((x, y)):
+                return False
+    return True
+
+
+IS_PYPY = "PyPy" == platform.python_implementation()
+
+
+@unittest.skipIf(IS_PYPY, "pypy skip known failure")  # TODO
+class FontModuleTest(unittest.TestCase):
+    def setUp(self):
+        pygame_font.init()
+
+    def tearDown(self):
+        pygame_font.quit()
+
+    def test_get_sdl_ttf_version(self):
+        def test_ver_tuple(ver):
+            self.assertIsInstance(ver, tuple)
+            self.assertEqual(len(ver), 3)
+            for i in ver:
+                self.assertIsInstance(i, int)
+
+        if pygame_font.__name__ != "pygame.ftfont":
+            compiled = pygame_font.get_sdl_ttf_version()
+            linked = pygame_font.get_sdl_ttf_version(linked=True)
+
+            test_ver_tuple(compiled)
+            test_ver_tuple(linked)
+
+            self.assertTrue(linked >= compiled)
+
+    def test_SysFont(self):
+        # Can only check that a font object is returned.
+        fonts = pygame_font.get_fonts()
+        if "arial" in fonts:
+            # Try to use arial font if it is there, rather than a random font
+            #  which can be different depending on installed fonts on the system.
+            font_name = "arial"
+        else:
+            font_name = sorted(fonts)[0]
+        o = pygame_font.SysFont(font_name, 20)
+        self.assertTrue(isinstance(o, pygame_font.FontType))
+        o = pygame_font.SysFont(font_name, 20, italic=True)
+        self.assertTrue(isinstance(o, pygame_font.FontType))
+        o = pygame_font.SysFont(font_name, 20, bold=True)
+        self.assertTrue(isinstance(o, pygame_font.FontType))
+        o = pygame_font.SysFont("thisisnotafont", 20)
+        self.assertTrue(isinstance(o, pygame_font.FontType))
+
+    def test_get_default_font(self):
+        self.assertEqual(pygame_font.get_default_font(), "freesansbold.ttf")
+
+    def test_get_fonts_returns_something(self):
+        fnts = pygame_font.get_fonts()
+        self.assertTrue(fnts)
+
+    # to test if some files exist...
+    # def XXtest_has_file_osx_10_5_sdk(self):
+    #    import os
+    #    f = "/Developer/SDKs/MacOSX10.5.sdk/usr/X11/include/ft2build.h"
+    #    self.assertEqual(os.path.exists(f), True)
+
+    # def XXtest_has_file_osx_10_4_sdk(self):
+    #    import os
+    #    f = "/Developer/SDKs/MacOSX10.4u.sdk/usr/X11R6/include/ft2build.h"
+    #    self.assertEqual(os.path.exists(f), True)
+
+    def test_get_fonts(self):
+        fnts = pygame_font.get_fonts()
+
+        self.assertTrue(fnts, msg=repr(fnts))
+
+        for name in fnts:
+            # note, on ubuntu 2.6 they are all unicode strings.
+
+            self.assertTrue(isinstance(name, str), name)
+            # Font names can be comprised of only numeric characters, so
+            # just checking name.islower() will not work as expected here.
+            self.assertFalse(any(c.isupper() for c in name))
+            self.assertTrue(name.isalnum(), name)
+
+    def test_get_init(self):
+        self.assertTrue(pygame_font.get_init())
+        pygame_font.quit()
+        self.assertFalse(pygame_font.get_init())
+
+    def test_init(self):
+        pygame_font.init()
+
+    def test_match_font_all_exist(self):
+        fonts = pygame_font.get_fonts()
+
+        # Ensure all listed fonts are in fact available, and the returned file
+        # name is a full path.
+        for font in fonts:
+            path = pygame_font.match_font(font)
+            self.assertFalse(path is None)
+            self.assertTrue(os.path.isabs(path) and os.path.isfile(path))
+
+    def test_match_font_name(self):
+        """That match_font accepts names of various types"""
+        font = pygame_font.get_fonts()[0]
+        font_path = pygame_font.match_font(font)
+        self.assertIsNotNone(font_path)
+        font_b = font.encode()
+        not_a_font = "thisisnotafont"
+        not_a_font_b = b"thisisnotafont"
+        good_font_names = [
+            # Check single name bytes.
+            font_b,
+            # Check string of comma-separated names.
+            ",".join([not_a_font, font, not_a_font]),
+            # Check list of names.
+            [not_a_font, font, not_a_font],
+            # Check generator:
+            (name for name in [not_a_font, font, not_a_font]),
+            # Check comma-separated bytes.
+            b",".join([not_a_font_b, font_b, not_a_font_b]),
+            # Check list of bytes.
+            [not_a_font_b, font_b, not_a_font_b],
+            # Check mixed list of bytes and string.
+            [font, not_a_font, font_b, not_a_font_b],
+        ]
+        for font_name in good_font_names:
+            self.assertEqual(pygame_font.match_font(font_name), font_path, font_name)
+
+    def test_not_match_font_name(self):
+        """match_font return None when names of various types do not exist"""
+        not_a_font = "thisisnotafont"
+        not_a_font_b = b"thisisnotafont"
+        bad_font_names = [
+            not_a_font,
+            ",".join([not_a_font, not_a_font, not_a_font]),
+            [not_a_font, not_a_font, not_a_font],
+            (name for name in [not_a_font, not_a_font, not_a_font]),
+            not_a_font_b,
+            b",".join([not_a_font_b, not_a_font_b, not_a_font_b]),
+            [not_a_font_b, not_a_font_b, not_a_font_b],
+            [not_a_font, not_a_font_b, not_a_font],
+        ]
+        for font_name in bad_font_names:
+            self.assertIsNone(pygame_font.match_font(font_name), font_name)
+
+    def test_match_font_bold(self):
+        fonts = pygame_font.get_fonts()
+
+        # Look for a bold font.
+        self.assertTrue(any(pygame_font.match_font(font, bold=True) for font in fonts))
+
+    def test_match_font_italic(self):
+        fonts = pygame_font.get_fonts()
+
+        # Look for an italic font.
+        self.assertTrue(
+            any(pygame_font.match_font(font, italic=True) for font in fonts)
+        )
+
+    def test_issue_742(self):
+        """that the font background does not crash."""
+        surf = pygame.Surface((320, 240))
+        font = pygame_font.Font(None, 24)
+        image = font.render("Test", 0, (255, 255, 255), (0, 0, 0))
+        self.assertIsNone(image.get_colorkey())
+        image.set_alpha(255)
+        surf.blit(image, (0, 0))
+
+        # not issue 742, but be sure to test that background color is
+        # correctly issued on this mode
+        self.assertEqual(surf.get_at((0, 0)), pygame.Color(0, 0, 0))
+
+    def test_issue_font_alphablit(self):
+        """Check that blitting anti-aliased text doesn't
+        change the background blue"""
+        pygame.display.set_mode((600, 400))
+
+        font = pygame_font.Font(None, 24)
+
+        (color, text, center, pos) = ((160, 200, 250), "Music", (190, 170), "midright")
+        img1 = font.render(text, True, color)
+
+        img = pygame.Surface(img1.get_size(), depth=32)
+        pre_blit_corner_pixel = img.get_at((0, 0))
+        img.blit(img1, (0, 0))
+        post_blit_corner_pixel = img.get_at((0, 0))
+
+        self.assertEqual(pre_blit_corner_pixel, post_blit_corner_pixel)
+
+    def test_segfault_after_reinit(self):
+        """Reinitialization of font module should not cause
+        segmentation fault"""
+        import gc
+
+        font = pygame_font.Font(None, 20)
+        pygame_font.quit()
+        pygame_font.init()
+        del font
+        gc.collect()
+
+    def test_quit(self):
+        pygame_font.quit()
+
+
+@unittest.skipIf(IS_PYPY, "pypy skip known failure")  # TODO
+class FontTest(unittest.TestCase):
+    def setUp(self):
+        pygame_font.init()
+
+    def tearDown(self):
+        pygame_font.quit()
+
+    def test_render_args(self):
+        screen = pygame.display.set_mode((600, 400))
+        rect = screen.get_rect()
+        f = pygame_font.Font(None, 20)
+        screen.fill((10, 10, 10))
+        font_surface = f.render("   bar", True, (0, 0, 0), (255, 255, 255))
+        font_rect = font_surface.get_rect()
+        font_rect.topleft = rect.topleft
+        self.assertTrue(font_surface)
+        screen.blit(font_surface, font_rect, font_rect)
+        pygame.display.update()
+        self.assertEqual(tuple(screen.get_at((0, 0)))[:3], (255, 255, 255))
+        self.assertEqual(tuple(screen.get_at(font_rect.topleft))[:3], (255, 255, 255))
+
+        # If we don't have a real display, don't do this test.
+        # Transparent background doesn't seem to work without a read video card.
+        if os.environ.get("SDL_VIDEODRIVER") != "dummy":
+            screen.fill((10, 10, 10))
+            font_surface = f.render("   bar", True, (0, 0, 0), None)
+            font_rect = font_surface.get_rect()
+            font_rect.topleft = rect.topleft
+            self.assertTrue(font_surface)
+            screen.blit(font_surface, font_rect, font_rect)
+            pygame.display.update()
+            self.assertEqual(tuple(screen.get_at((0, 0)))[:3], (10, 10, 10))
+            self.assertEqual(tuple(screen.get_at(font_rect.topleft))[:3], (10, 10, 10))
+
+            screen.fill((10, 10, 10))
+            font_surface = f.render("   bar", True, (0, 0, 0))
+            font_rect = font_surface.get_rect()
+            font_rect.topleft = rect.topleft
+            self.assertTrue(font_surface)
+            screen.blit(font_surface, font_rect, font_rect)
+            pygame.display.update(rect)
+            self.assertEqual(tuple(screen.get_at((0, 0)))[:3], (10, 10, 10))
+            self.assertEqual(tuple(screen.get_at(font_rect.topleft))[:3], (10, 10, 10))
+
+
+@unittest.skipIf(IS_PYPY, "pypy skip known failure")  # TODO
+class FontTypeTest(unittest.TestCase):
+    def setUp(self):
+        pygame_font.init()
+
+    def tearDown(self):
+        pygame_font.quit()
+
+    def test_default_parameters(self):
+        f = pygame_font.Font()
+
+    def test_get_ascent(self):
+        # Checking ascent would need a custom test font to do properly.
+        f = pygame_font.Font(None, 20)
+        ascent = f.get_ascent()
+        self.assertTrue(isinstance(ascent, int))
+        self.assertTrue(ascent > 0)
+        s = f.render("X", False, (255, 255, 255))
+        self.assertTrue(s.get_size()[1] > ascent)
+
+    def test_get_descent(self):
+        # Checking descent would need a custom test font to do properly.
+        f = pygame_font.Font(None, 20)
+        descent = f.get_descent()
+        self.assertTrue(isinstance(descent, int))
+        self.assertTrue(descent < 0)
+
+    def test_get_height(self):
+        # Checking height would need a custom test font to do properly.
+        f = pygame_font.Font(None, 20)
+        height = f.get_height()
+        self.assertTrue(isinstance(height, int))
+        self.assertTrue(height > 0)
+        s = f.render("X", False, (255, 255, 255))
+        self.assertTrue(s.get_size()[1] == height)
+
+    def test_get_linesize(self):
+        # Checking linesize would need a custom test font to do properly.
+        # Questions: How do linesize, height and descent relate?
+        f = pygame_font.Font(None, 20)
+        linesize = f.get_linesize()
+        self.assertTrue(isinstance(linesize, int))
+        self.assertTrue(linesize > 0)
+
+    def test_metrics(self):
+        # Ensure bytes decoding works correctly. Can only compare results
+        # with unicode for now.
+        f = pygame_font.Font(None, 20)
+        um = f.metrics(".")
+        bm = f.metrics(b".")
+
+        self.assertEqual(len(um), 1)
+        self.assertEqual(len(bm), 1)
+        self.assertIsNotNone(um[0])
+        self.assertEqual(um, bm)
+
+        u = "\u212A"
+        b = u.encode("UTF-16")[2:]  # Keep byte order consistent. [2:] skips BOM
+        bm = f.metrics(b)
+
+        self.assertEqual(len(bm), 2)
+
+        try:  # FIXME why do we do this try/except ?
+            um = f.metrics(u)
+        except pygame.error:
+            pass
+        else:
+            self.assertEqual(len(um), 1)
+            self.assertNotEqual(bm[0], um[0])
+            self.assertNotEqual(bm[1], um[0])
+
+        u = "\U00013000"
+        bm = f.metrics(u)
+
+        self.assertEqual(len(bm), 1)
+        self.assertIsNone(bm[0])
+
+        return  # unfinished
+        # The documentation is useless here. How large a list?
+        # How do list positions relate to character codes?
+        # What about unicode characters?
+
+        # __doc__ (as of 2008-08-02) for pygame_font.Font.metrics:
+
+        # Font.metrics(text): return list
+        # Gets the metrics for each character in the passed string.
+        #
+        # 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), ...]
+
+        self.fail()
+
+    def test_render(self):
+        f = pygame_font.Font(None, 20)
+        s = f.render("foo", True, [0, 0, 0], [255, 255, 255])
+        s = f.render("xxx", True, [0, 0, 0], [255, 255, 255])
+        s = f.render("", True, [0, 0, 0], [255, 255, 255])
+        s = f.render("foo", False, [0, 0, 0], [255, 255, 255])
+        s = f.render("xxx", False, [0, 0, 0], [255, 255, 255])
+        s = f.render("xxx", False, [0, 0, 0])
+        s = f.render("   ", False, [0, 0, 0])
+        s = f.render("   ", False, [0, 0, 0], [255, 255, 255])
+        # null text should be 0 pixel wide.
+        s = f.render("", False, [0, 0, 0], [255, 255, 255])
+        self.assertEqual(s.get_size()[0], 0)
+        # None text should be 0 pixel wide.
+        s = f.render(None, False, [0, 0, 0], [255, 255, 255])
+        self.assertEqual(s.get_size()[0], 0)
+        # Non-text should raise a TypeError.
+        self.assertRaises(TypeError, f.render, [], False, [0, 0, 0], [255, 255, 255])
+        self.assertRaises(TypeError, f.render, 1, False, [0, 0, 0], [255, 255, 255])
+        # is background transparent for antialiasing?
+        s = f.render(".", True, [255, 255, 255])
+        self.assertEqual(s.get_at((0, 0))[3], 0)
+        # is Unicode and bytes encoding correct?
+        # Cannot really test if the correct characters are rendered, but
+        # at least can assert the encodings differ.
+        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"
+        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 ?
+            su = f.render(u, False, [0, 0, 0], [255, 255, 255])
+        except pygame.error:
+            pass
+        else:
+            self.assertFalse(equal_images(su, sb))
+
+        # test for internal null bytes
+        self.assertRaises(ValueError, f.render, b"ab\x00cd", 0, [0, 0, 0])
+        self.assertRaises(ValueError, f.render, "ab\x00cd", 0, [0, 0, 0])
+
+    def test_render_ucs2_ucs4(self):
+        """that it renders without raising if there is a new enough SDL_ttf."""
+        f = pygame_font.Font(None, 20)
+        # 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"
+            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])
+
+    def test_set_bold(self):
+        f = pygame_font.Font(None, 20)
+        self.assertFalse(f.get_bold())
+        f.set_bold(True)
+        self.assertTrue(f.get_bold())
+        f.set_bold(False)
+        self.assertFalse(f.get_bold())
+
+    def test_set_italic(self):
+        f = pygame_font.Font(None, 20)
+        self.assertFalse(f.get_italic())
+        f.set_italic(True)
+        self.assertTrue(f.get_italic())
+        f.set_italic(False)
+        self.assertFalse(f.get_italic())
+
+    def test_set_underline(self):
+        f = pygame_font.Font(None, 20)
+        self.assertFalse(f.get_underline())
+        f.set_underline(True)
+        self.assertTrue(f.get_underline())
+        f.set_underline(False)
+        self.assertFalse(f.get_underline())
+
+    def test_set_strikethrough(self):
+        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)
+        self.assertFalse(f.bold)
+        f.bold = True
+        self.assertTrue(f.bold)
+        f.bold = False
+        self.assertFalse(f.bold)
+
+    def test_set_italic_property(self):
+        f = pygame_font.Font(None, 20)
+        self.assertFalse(f.italic)
+        f.italic = True
+        self.assertTrue(f.italic)
+        f.italic = False
+        self.assertFalse(f.italic)
+
+    def test_set_underline_property(self):
+        f = pygame_font.Font(None, 20)
+        self.assertFalse(f.underline)
+        f.underline = True
+        self.assertTrue(f.underline)
+        f.underline = False
+        self.assertFalse(f.underline)
+
+    def test_set_strikethrough_property(self):
+        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)
+        text = "Xg"
+        size = f.size(text)
+        w, h = size
+        s = f.render(text, False, (255, 255, 255))
+        btext = text.encode("ascii")
+
+        self.assertIsInstance(w, int)
+        self.assertIsInstance(h, int)
+        self.assertEqual(s.get_size(), size)
+        self.assertEqual(f.size(btext), size)
+
+        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_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
+
+        pygame_font.init()
+        self.assertRaises(
+            FileNotFoundError, pygame_font.Font, "some-fictional-font.ttf", 20
+        )
+
+    def test_load_from_file(self):
+        font_name = pygame_font.get_default_font()
+        font_path = os.path.join(
+            os.path.split(pygame.__file__)[0], pygame_font.get_default_font()
+        )
+        f = pygame_font.Font(font_path, 20)
+
+    def test_load_from_file_default(self):
+        font_name = pygame_font.get_default_font()
+        font_path = os.path.join(
+            os.path.split(pygame.__file__)[0], pygame_font.get_default_font()
+        )
+        f = pygame_font.Font(font_path)
+
+    def test_load_from_pathlib(self):
+        font_name = pygame_font.get_default_font()
+        font_path = os.path.join(
+            os.path.split(pygame.__file__)[0], pygame_font.get_default_font()
+        )
+        f = pygame_font.Font(pathlib.Path(font_path), 20)
+        f = pygame_font.Font(pathlib.Path(font_path))
+
+    def test_load_from_pathlib_default(self):
+        font_name = pygame_font.get_default_font()
+        font_path = os.path.join(
+            os.path.split(pygame.__file__)[0], pygame_font.get_default_font()
+        )
+        f = pygame_font.Font(pathlib.Path(font_path))
+
+    def test_load_from_file_obj(self):
+        font_name = pygame_font.get_default_font()
+        font_path = os.path.join(
+            os.path.split(pygame.__file__)[0], pygame_font.get_default_font()
+        )
+        with open(font_path, "rb") as f:
+            font = pygame_font.Font(f, 20)
+
+    def test_load_from_file_obj_default(self):
+        font_name = pygame_font.get_default_font()
+        font_path = os.path.join(
+            os.path.split(pygame.__file__)[0], pygame_font.get_default_font()
+        )
+        with open(font_path, "rb") as f:
+            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.
+        f = pygame_font.Font(pygame_font.get_default_font(), 20)
+
+    def test_load_default_font_filename_default(self):
+        # In font_init, a special case is when the filename argument is
+        # identical to the default font file name.
+        f = pygame_font.Font(pygame_font.get_default_font())
+
+    def _load_unicode(self, path):
+        import shutil
+
+        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"""
+        self._load_unicode("temp_file.ttf")
+
+    def test_load_from_file_unicode_1(self):
+        self._load_unicode("你好.ttf")
+
+    def test_load_from_file_bytes(self):
+        font_path = os.path.join(
+            os.path.split(pygame.__file__)[0], pygame_font.get_default_font()
+        )
+        filesystem_encoding = sys.getfilesystemencoding()
+        filesystem_errors = "replace" if sys.platform == "win32" else "surrogateescape"
+        try:  # FIXME why do we do this try/except ?
+            font_path = font_path.decode(filesystem_encoding, filesystem_errors)
+        except AttributeError:
+            pass
+        bfont_path = font_path.encode(filesystem_encoding, filesystem_errors)
+        f = pygame_font.Font(bfont_path, 20)
+
+    def test_issue_3144(self):
+        fpath = os.path.join(FONTDIR, "PlayfairDisplaySemibold.ttf")
+
+        # issue in SDL_ttf 2.0.18 DLL on Windows
+        # tested to make us aware of any regressions
+        for size in (60, 40, 10, 20, 70, 45, 50, 10):
+            font = pygame_font.Font(fpath, size)
+            font.render("WHERE", True, "black")
+
+    def test_font_set_script(self):
+        if pygame_font.__name__ == "pygame.ftfont":
+            return  # this ain't 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_script)
+            self.assertRaises(TypeError, pygame.font.Font.set_script, font)
+            self.assertRaises(TypeError, pygame.font.Font.set_script, "hey", "Deva")
+            self.assertRaises(TypeError, font.set_script, 1)
+            self.assertRaises(TypeError, font.set_script, ["D", "e", "v", "a"])
+
+            self.assertRaises(ValueError, font.set_script, "too long by far")
+            self.assertRaises(ValueError, font.set_script, "")
+            self.assertRaises(ValueError, font.set_script, "a")
+
+            font.set_script("Deva")
+        else:
+            self.assertRaises(pygame.error, font.set_script, "Deva")
+
+
+@unittest.skipIf(IS_PYPY, "pypy skip known failure")  # TODO
+class VisualTests(unittest.TestCase):
+    __tags__ = ["interactive"]
+
+    screen = None
+    aborted = False
+
+    def setUp(self):
+        if self.screen is None:
+            pygame.init()
+            self.screen = pygame.display.set_mode((600, 200))
+            self.screen.fill((255, 255, 255))
+            pygame.display.flip()
+            self.f = pygame_font.Font(None, 32)
+
+    def abort(self):
+        if self.screen is not None:
+            pygame.quit()
+        self.aborted = True
+
+    def query(
+        self,
+        bold=False,
+        italic=False,
+        underline=False,
+        strikethrough=False,
+        antialiase=False,
+    ):
+        if self.aborted:
+            return False
+        spacing = 10
+        offset = 20
+        y = spacing
+        f = self.f
+        screen = self.screen
+        screen.fill((255, 255, 255))
+        pygame.display.flip()
+        if not (bold or italic or underline or strikethrough or antialiase):
+            text = "normal"
+        else:
+            modes = []
+            if bold:
+                modes.append("bold")
+            if italic:
+                modes.append("italic")
+            if underline:
+                modes.append("underlined")
+            if strikethrough:
+                modes.append("strikethrough")
+            if antialiase:
+                modes.append("antialiased")
+            text = f"{'-'.join(modes)} (y/n):"
+        f.set_bold(bold)
+        f.set_italic(italic)
+        f.set_underline(underline)
+        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)
+        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()
+        while True:
+            for evt in pygame.event.get():
+                if evt.type == pygame.KEYDOWN:
+                    if evt.key == pygame.K_ESCAPE:
+                        self.abort()
+                        return False
+                    if evt.key == pygame.K_y:
+                        return True
+                    if evt.key == pygame.K_n:
+                        return False
+                if evt.type == pygame.QUIT:
+                    self.abort()
+                    return False
+
+    def test_bold(self):
+        self.assertTrue(self.query(bold=True))
+
+    def test_italic(self):
+        self.assertTrue(self.query(italic=True))
+
+    def test_underline(self):
+        self.assertTrue(self.query(underline=True))
+
+    def test_strikethrough(self):
+        if pygame_font.__name__ != "pygame.ftfont":
+            self.assertTrue(self.query(strikethrough=True))
+
+    def test_antialiase(self):
+        self.assertTrue(self.query(antialiase=True))
+
+    def test_bold_antialiase(self):
+        self.assertTrue(self.query(bold=True, antialiase=True))
+
+    def test_italic_underline(self):
+        self.assertTrue(self.query(italic=True, underline=True))
+
+    def test_bold_strikethrough(self):
+        if pygame_font.__name__ != "pygame.ftfont":
+            self.assertTrue(self.query(bold=True, strikethrough=True))
+
+
+if __name__ == "__main__":
+    unittest.main()
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/freetype_tags.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/freetype_tags.py
new file mode 100644
index 0000000..d84cbb7
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/freetype_tags.py
@@ -0,0 +1,11 @@
+__tags__ = ["development"]
+
+exclude = False
+
+try:
+    import pygame.freetype
+except ImportError:
+    exclude = True
+
+if exclude:
+    __tags__.extend(["ignore", "subprocess_ignore"])
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/freetype_test.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/freetype_test.py
new file mode 100644
index 0000000..25551d8
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/freetype_test.py
@@ -0,0 +1,1796 @@
+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
+
+IS_PYPY = "PyPy" == platform.python_implementation()
+
+
+try:
+    from pygame.tests.test_utils import arrinter
+except NameError:
+    pass
+
+import pygame
+
+try:
+    import pygame.freetype as ft
+except ImportError:
+    ft = None
+
+
+FONTDIR = os.path.join(os.path.dirname(os.path.abspath(__file__)), "fixtures", "fonts")
+
+
+def nullfont():
+    """return an uninitialized font instance"""
+    return ft.Font.__new__(ft.Font)
+
+
+max_point_size_FX6 = 0x7FFFFFFF
+max_point_size = max_point_size_FX6 >> 6
+max_point_size_f = max_point_size_FX6 * 0.015625
+
+
+def surf_same_image(a, b):
+    """Return True if a's pixel buffer is identical to b's"""
+
+    a_sz = a.get_height() * a.get_pitch()
+    b_sz = b.get_height() * b.get_pitch()
+    if a_sz != b_sz:
+        return False
+    a_bytes = ctypes.string_at(a._pixels_address, a_sz)
+    b_bytes = ctypes.string_at(b._pixels_address, b_sz)
+    return a_bytes == b_bytes
+
+
+class FreeTypeFontTest(unittest.TestCase):
+    _fixed_path = os.path.join(FONTDIR, "test_fixed.otf")
+    _sans_path = os.path.join(FONTDIR, "test_sans.ttf")
+    _mono_path = os.path.join(FONTDIR, "PyGameMono.otf")
+    _bmp_8_75dpi_path = os.path.join(FONTDIR, "PyGameMono-8.bdf")
+    _bmp_18_75dpi_path = os.path.join(FONTDIR, "PyGameMono-18-75dpi.bdf")
+    _bmp_18_100dpi_path = os.path.join(FONTDIR, "PyGameMono-18-100dpi.bdf")
+    _TEST_FONTS = {}
+
+    @classmethod
+    def setUpClass(cls):
+        ft.init()
+
+        # Setup the test fonts.
+
+        # Inconsolata is an open-source font designed by Raph Levien.
+        # Licensed under the Open Font License.
+        # http://www.levien.com/type/myfonts/inconsolata.html
+        cls._TEST_FONTS["fixed"] = ft.Font(cls._fixed_path)
+
+        # Liberation Sans is an open-source font designed by Steve Matteson.
+        # Licensed under the GNU GPL.
+        # https://fedorahosted.org/liberation-fonts/
+        cls._TEST_FONTS["sans"] = ft.Font(cls._sans_path)
+
+        # A scalable mono test font made for pygame. It contains only
+        # a few glyphs: '\0', 'A', 'B', 'C', and U+13079.
+        # It also contains two bitmap sizes: 8.0 X 8.0 and 19.0 X 19.0.
+        cls._TEST_FONTS["mono"] = ft.Font(cls._mono_path)
+
+        # A fixed size bitmap mono test font made for pygame.
+        # It contains only a few glyphs: '\0', 'A', 'B', 'C', and U+13079.
+        # The size is 8.0 X 8.0.
+        cls._TEST_FONTS["bmp-8-75dpi"] = ft.Font(cls._bmp_8_75dpi_path)
+
+        # A fixed size bitmap mono test font made for pygame.
+        # It contains only a few glyphs: '\0', 'A', 'B', 'C', and U+13079.
+        # The size is 8.0 X 8.0.
+        cls._TEST_FONTS["bmp-18-75dpi"] = ft.Font(cls._bmp_18_75dpi_path)
+
+        # A fixed size bitmap mono test font made for pygame.
+        # It contains only a few glyphs: '\0', 'A', 'B', 'C', and U+13079.
+        # The size is 8.0 X 8.0.
+        cls._TEST_FONTS["bmp-18-100dpi"] = ft.Font(cls._bmp_18_100dpi_path)
+
+    @classmethod
+    def tearDownClass(cls):
+        ft.quit()
+
+    def test_freetype_defaultfont(self):
+        font = ft.Font(None)
+        self.assertEqual(font.name, "FreeSans")
+
+    def test_freetype_Font_init(self):
+        self.assertRaises(
+            FileNotFoundError, ft.Font, os.path.join(FONTDIR, "nonexistent.ttf")
+        )
+
+        f = self._TEST_FONTS["sans"]
+        self.assertIsInstance(f, ft.Font)
+
+        f = self._TEST_FONTS["fixed"]
+        self.assertIsInstance(f, ft.Font)
+
+        # Test keyword arguments
+        f = ft.Font(size=22, file=None)
+        self.assertEqual(f.size, 22)
+        f = ft.Font(font_index=0, file=None)
+        self.assertNotEqual(ft.get_default_resolution(), 100)
+        f = ft.Font(resolution=100, file=None)
+        self.assertEqual(f.resolution, 100)
+        f = ft.Font(ucs4=True, file=None)
+        self.assertTrue(f.ucs4)
+        self.assertRaises(OverflowError, ft.Font, file=None, size=(max_point_size + 1))
+        self.assertRaises(OverflowError, ft.Font, file=None, size=-1)
+
+        f = ft.Font(None, size=24)
+        self.assertTrue(f.height > 0)
+        self.assertRaises(
+            FileNotFoundError, f.__init__, os.path.join(FONTDIR, "nonexistent.ttf")
+        )
+
+        # 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)
+        self.assertFalse(f.fixed_width)
+        self.assertTrue(f.antialiased)
+        self.assertFalse(f.oblique)
+        self.assertTrue(f.ucs4)
+        f.antialiased = False
+        f.oblique = True
+        f.__init__(self._mono_path)
+        self.assertEqual(f.name, "PyGameMono")
+        self.assertTrue(f.scalable)
+        self.assertTrue(f.fixed_width)
+        self.assertFalse(f.antialiased)
+        self.assertTrue(f.oblique)
+        self.assertTrue(f.ucs4)
+
+        # For a bitmap font, the size is automatically set to the first
+        # size in the available sizes list.
+        f = ft.Font(self._bmp_8_75dpi_path)
+        sizes = f.get_sizes()
+        self.assertEqual(len(sizes), 1)
+        size_pt, width_px, height_px, x_ppem, y_ppem = sizes[0]
+        self.assertEqual(f.size, (x_ppem, y_ppem))
+        f.__init__(self._bmp_8_75dpi_path, size=12)
+        self.assertEqual(f.size, 12.0)
+
+    @unittest.skipIf(IS_PYPY, "PyPy doesn't use refcounting")
+    def test_freetype_Font_dealloc(self):
+        import sys
+
+        handle = open(self._sans_path, "rb")
+
+        def load_font():
+            tempFont = ft.Font(handle)
+
+        try:
+            load_font()
+
+            self.assertEqual(sys.getrefcount(handle), 2)
+        finally:
+            # Ensures file is closed even if test fails.
+            handle.close()
+
+    def test_freetype_Font_kerning(self):
+        """Ensures get/set works with the kerning property."""
+        ft_font = self._TEST_FONTS["sans"]
+
+        # Test default is disabled.
+        self.assertFalse(ft_font.kerning)
+
+        # Test setting to True.
+        ft_font.kerning = True
+
+        self.assertTrue(ft_font.kerning)
+
+        # Test setting to False.
+        ft_font.kerning = False
+
+        self.assertFalse(ft_font.kerning)
+
+    def test_freetype_Font_kerning__enabled(self):
+        """Ensures exceptions are not raised when calling freetype methods
+        while kerning is enabled.
+
+        Note: This does not test what changes occur to a rendered font by
+              having kerning enabled.
+
+        Related to issue #367.
+        """
+        surface = pygame.Surface((10, 10), 0, 32)
+        TEST_TEXT = "Freetype Font"
+        ft_font = self._TEST_FONTS["bmp-8-75dpi"]
+
+        ft_font.kerning = True
+
+        # Call different methods to ensure they don't raise an exception.
+        metrics = ft_font.get_metrics(TEST_TEXT)
+        self.assertIsInstance(metrics, list)
+
+        rect = ft_font.get_rect(TEST_TEXT)
+        self.assertIsInstance(rect, pygame.Rect)
+
+        font_surf, rect = ft_font.render(TEST_TEXT)
+        self.assertIsInstance(font_surf, pygame.Surface)
+        self.assertIsInstance(rect, pygame.Rect)
+
+        rect = ft_font.render_to(surface, (0, 0), TEST_TEXT)
+        self.assertIsInstance(rect, pygame.Rect)
+
+        buf, size = ft_font.render_raw(TEST_TEXT)
+        self.assertIsInstance(buf, bytes)
+        self.assertIsInstance(size, tuple)
+
+        rect = ft_font.render_raw_to(surface.get_view("2"), TEST_TEXT)
+        self.assertIsInstance(rect, pygame.Rect)
+
+    def test_freetype_Font_scalable(self):
+        f = self._TEST_FONTS["sans"]
+        self.assertTrue(f.scalable)
+
+        self.assertRaises(RuntimeError, lambda: nullfont().scalable)
+
+    def test_freetype_Font_fixed_width(self):
+        f = self._TEST_FONTS["sans"]
+        self.assertFalse(f.fixed_width)
+
+        f = self._TEST_FONTS["mono"]
+        self.assertTrue(f.fixed_width)
+
+        self.assertRaises(RuntimeError, lambda: nullfont().fixed_width)
+
+    def test_freetype_Font_fixed_sizes(self):
+        f = self._TEST_FONTS["sans"]
+        self.assertEqual(f.fixed_sizes, 0)
+        f = self._TEST_FONTS["bmp-8-75dpi"]
+        self.assertEqual(f.fixed_sizes, 1)
+        f = self._TEST_FONTS["mono"]
+        self.assertEqual(f.fixed_sizes, 2)
+
+    def test_freetype_Font_get_sizes(self):
+        f = self._TEST_FONTS["sans"]
+        szlist = f.get_sizes()
+        self.assertIsInstance(szlist, list)
+        self.assertEqual(len(szlist), 0)
+
+        f = self._TEST_FONTS["bmp-8-75dpi"]
+        szlist = f.get_sizes()
+        self.assertIsInstance(szlist, list)
+        self.assertEqual(len(szlist), 1)
+
+        size8 = szlist[0]
+        self.assertIsInstance(size8[0], int)
+        self.assertEqual(size8[0], 8)
+        self.assertIsInstance(size8[1], int)
+        self.assertIsInstance(size8[2], int)
+        self.assertIsInstance(size8[3], float)
+        self.assertEqual(int(size8[3] * 64.0 + 0.5), 8 * 64)
+        self.assertIsInstance(size8[4], float)
+        self.assertEqual(int(size8[4] * 64.0 + 0.5), 8 * 64)
+
+        f = self._TEST_FONTS["mono"]
+        szlist = f.get_sizes()
+        self.assertIsInstance(szlist, list)
+        self.assertEqual(len(szlist), 2)
+
+        size8 = szlist[0]
+        self.assertEqual(size8[3], 8)
+        self.assertEqual(int(size8[3] * 64.0 + 0.5), 8 * 64)
+        self.assertEqual(int(size8[4] * 64.0 + 0.5), 8 * 64)
+
+        size19 = szlist[1]
+        self.assertEqual(size19[3], 19)
+        self.assertEqual(int(size19[3] * 64.0 + 0.5), 19 * 64)
+        self.assertEqual(int(size19[4] * 64.0 + 0.5), 19 * 64)
+
+    def test_freetype_Font_use_bitmap_strikes(self):
+        f = self._TEST_FONTS["mono"]
+        try:
+            # use_bitmap_strikes == True
+            #
+            self.assertTrue(f.use_bitmap_strikes)
+
+            # bitmap compatible properties
+            s_strike, sz = f.render_raw("A", size=19)
+            try:
+                f.vertical = True
+                s_strike_vert, sz = f.render_raw("A", size=19)
+            finally:
+                f.vertical = False
+            try:
+                f.wide = True
+                s_strike_wide, sz = f.render_raw("A", size=19)
+            finally:
+                f.wide = False
+            try:
+                f.underline = True
+                s_strike_underline, sz = f.render_raw("A", size=19)
+            finally:
+                f.underline = False
+
+            # bitmap incompatible properties
+            s_strike_rot45, sz = f.render_raw("A", size=19, rotation=45)
+            try:
+                f.strong = True
+                s_strike_strong, sz = f.render_raw("A", size=19)
+            finally:
+                f.strong = False
+            try:
+                f.oblique = True
+                s_strike_oblique, sz = f.render_raw("A", size=19)
+            finally:
+                f.oblique = False
+
+            # compare with use_bitmap_strikes == False
+            #
+            f.use_bitmap_strikes = False
+            self.assertFalse(f.use_bitmap_strikes)
+
+            # bitmap compatible properties
+            s_outline, sz = f.render_raw("A", size=19)
+            self.assertNotEqual(s_outline, s_strike)
+            try:
+                f.vertical = True
+                s_outline, sz = f.render_raw("A", size=19)
+                self.assertNotEqual(s_outline, s_strike_vert)
+            finally:
+                f.vertical = False
+            try:
+                f.wide = True
+                s_outline, sz = f.render_raw("A", size=19)
+                self.assertNotEqual(s_outline, s_strike_wide)
+            finally:
+                f.wide = False
+            try:
+                f.underline = True
+                s_outline, sz = f.render_raw("A", size=19)
+                self.assertNotEqual(s_outline, s_strike_underline)
+            finally:
+                f.underline = False
+
+            # bitmap incompatible properties
+            s_outline, sz = f.render_raw("A", size=19, rotation=45)
+            self.assertEqual(s_outline, s_strike_rot45)
+            try:
+                f.strong = True
+                s_outline, sz = f.render_raw("A", size=19)
+                self.assertEqual(s_outline, s_strike_strong)
+            finally:
+                f.strong = False
+            try:
+                f.oblique = True
+                s_outline, sz = f.render_raw("A", size=19)
+                self.assertEqual(s_outline, s_strike_oblique)
+            finally:
+                f.oblique = False
+        finally:
+            f.use_bitmap_strikes = True
+
+    def test_freetype_Font_bitmap_files(self):
+        """Ensure bitmap file restrictions are caught"""
+        f = self._TEST_FONTS["bmp-8-75dpi"]
+        f_null = nullfont()
+        s = pygame.Surface((10, 10), 0, 32)
+        a = s.get_view("3")
+
+        exception = AttributeError
+        self.assertRaises(exception, setattr, f, "strong", True)
+        self.assertRaises(exception, setattr, f, "oblique", True)
+        self.assertRaises(exception, setattr, f, "style", ft.STYLE_STRONG)
+        self.assertRaises(exception, setattr, f, "style", ft.STYLE_OBLIQUE)
+        exception = RuntimeError
+        self.assertRaises(exception, setattr, f_null, "strong", True)
+        self.assertRaises(exception, setattr, f_null, "oblique", True)
+        self.assertRaises(exception, setattr, f_null, "style", ft.STYLE_STRONG)
+        self.assertRaises(exception, setattr, f_null, "style", ft.STYLE_OBLIQUE)
+        exception = ValueError
+        self.assertRaises(exception, f.render, "A", (0, 0, 0), size=8, rotation=1)
+        self.assertRaises(
+            exception, f.render, "A", (0, 0, 0), size=8, style=ft.STYLE_OBLIQUE
+        )
+        self.assertRaises(
+            exception, f.render, "A", (0, 0, 0), size=8, style=ft.STYLE_STRONG
+        )
+        self.assertRaises(exception, f.render_raw, "A", size=8, rotation=1)
+        self.assertRaises(exception, f.render_raw, "A", size=8, style=ft.STYLE_OBLIQUE)
+        self.assertRaises(exception, f.render_raw, "A", size=8, style=ft.STYLE_STRONG)
+        self.assertRaises(
+            exception, f.render_to, s, (0, 0), "A", (0, 0, 0), size=8, rotation=1
+        )
+        self.assertRaises(
+            exception,
+            f.render_to,
+            s,
+            (0, 0),
+            "A",
+            (0, 0, 0),
+            size=8,
+            style=ft.STYLE_OBLIQUE,
+        )
+        self.assertRaises(
+            exception,
+            f.render_to,
+            s,
+            (0, 0),
+            "A",
+            (0, 0, 0),
+            size=8,
+            style=ft.STYLE_STRONG,
+        )
+        self.assertRaises(exception, f.render_raw_to, a, "A", size=8, rotation=1)
+        self.assertRaises(
+            exception, f.render_raw_to, a, "A", size=8, style=ft.STYLE_OBLIQUE
+        )
+        self.assertRaises(
+            exception, f.render_raw_to, a, "A", size=8, style=ft.STYLE_STRONG
+        )
+        self.assertRaises(exception, f.get_rect, "A", size=8, rotation=1)
+        self.assertRaises(exception, f.get_rect, "A", size=8, style=ft.STYLE_OBLIQUE)
+        self.assertRaises(exception, f.get_rect, "A", size=8, style=ft.STYLE_STRONG)
+
+        # Unsupported point size
+        exception = pygame.error
+        self.assertRaises(exception, f.get_rect, "A", size=42)
+        self.assertRaises(exception, f.get_metrics, "A", size=42)
+        self.assertRaises(exception, f.get_sized_ascender, 42)
+        self.assertRaises(exception, f.get_sized_descender, 42)
+        self.assertRaises(exception, f.get_sized_height, 42)
+        self.assertRaises(exception, f.get_sized_glyph_height, 42)
+
+    def test_freetype_Font_get_metrics(self):
+        font = self._TEST_FONTS["sans"]
+
+        metrics = font.get_metrics("ABCD", size=24)
+        self.assertEqual(len(metrics), len("ABCD"))
+        self.assertIsInstance(metrics, list)
+
+        for metrics_tuple in metrics:
+            self.assertIsInstance(metrics_tuple, tuple, metrics_tuple)
+            self.assertEqual(len(metrics_tuple), 6)
+
+            for m in metrics_tuple[:4]:
+                self.assertIsInstance(m, int)
+
+            for m in metrics_tuple[4:]:
+                self.assertIsInstance(m, float)
+
+        # test for empty string
+        metrics = font.get_metrics("", size=24)
+        self.assertEqual(metrics, [])
+
+        # test for invalid string
+        self.assertRaises(TypeError, font.get_metrics, 24, 24)
+
+        # raises exception when uninitialized
+        self.assertRaises(RuntimeError, nullfont().get_metrics, "a", size=24)
+
+    def test_freetype_Font_get_rect(self):
+        font = self._TEST_FONTS["sans"]
+
+        def test_rect(r):
+            self.assertIsInstance(r, pygame.Rect)
+
+        rect_default = font.get_rect("ABCDabcd", size=24)
+        test_rect(rect_default)
+        self.assertTrue(rect_default.size > (0, 0))
+        self.assertTrue(rect_default.width > rect_default.height)
+
+        rect_bigger = font.get_rect("ABCDabcd", size=32)
+        test_rect(rect_bigger)
+        self.assertTrue(rect_bigger.size > rect_default.size)
+
+        rect_strong = font.get_rect("ABCDabcd", size=24, style=ft.STYLE_STRONG)
+        test_rect(rect_strong)
+        self.assertTrue(rect_strong.size > rect_default.size)
+
+        font.vertical = True
+        rect_vert = font.get_rect("ABCDabcd", size=24)
+        test_rect(rect_vert)
+        self.assertTrue(rect_vert.width < rect_vert.height)
+        font.vertical = False
+
+        rect_oblique = font.get_rect("ABCDabcd", size=24, style=ft.STYLE_OBLIQUE)
+        test_rect(rect_oblique)
+        self.assertTrue(rect_oblique.width > rect_default.width)
+        self.assertTrue(rect_oblique.height == rect_default.height)
+
+        rect_under = font.get_rect("ABCDabcd", size=24, style=ft.STYLE_UNDERLINE)
+        test_rect(rect_under)
+        self.assertTrue(rect_under.width == rect_default.width)
+        self.assertTrue(rect_under.height > rect_default.height)
+
+        # Rect size should change if UTF surrogate pairs are treated as
+        # 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)
+        self.assertEqual(rect_utf16, rect_utf32)
+        ufont.ucs4 = True
+        try:
+            rect_utf16 = ufont.get_rect("\uD80C\uDC79", size=24)
+        finally:
+            ufont.ucs4 = False
+        self.assertNotEqual(rect_utf16, rect_utf32)
+
+        self.assertRaises(RuntimeError, nullfont().get_rect, "a", size=24)
+
+        # text stretching
+        rect12 = font.get_rect("A", size=12.0)
+        rect24 = font.get_rect("A", size=24.0)
+        rect_x = font.get_rect("A", size=(24.0, 12.0))
+        self.assertEqual(rect_x.width, rect24.width)
+        self.assertEqual(rect_x.height, rect12.height)
+        rect_y = font.get_rect("A", size=(12.0, 24.0))
+        self.assertEqual(rect_y.width, rect12.width)
+        self.assertEqual(rect_y.height, rect24.height)
+
+    def test_freetype_Font_height(self):
+        f = self._TEST_FONTS["sans"]
+        self.assertEqual(f.height, 2355)
+
+        f = self._TEST_FONTS["fixed"]
+        self.assertEqual(f.height, 1100)
+
+        self.assertRaises(RuntimeError, lambda: nullfont().height)
+
+    def test_freetype_Font_name(self):
+        f = self._TEST_FONTS["sans"]
+        self.assertEqual(f.name, "Liberation Sans")
+
+        f = self._TEST_FONTS["fixed"]
+        self.assertEqual(f.name, "Inconsolata")
+
+        nf = nullfont()
+        self.assertEqual(nf.name, repr(nf))
+
+    def test_freetype_Font_size(self):
+        f = ft.Font(None, size=12)
+        self.assertEqual(f.size, 12)
+        f.size = 22
+        self.assertEqual(f.size, 22)
+        f.size = 0
+        self.assertEqual(f.size, 0)
+        f.size = max_point_size
+        self.assertEqual(f.size, max_point_size)
+        f.size = 6.5
+        self.assertEqual(f.size, 6.5)
+        f.size = max_point_size_f
+        self.assertEqual(f.size, max_point_size_f)
+        self.assertRaises(OverflowError, setattr, f, "size", -1)
+        self.assertRaises(OverflowError, setattr, f, "size", (max_point_size + 1))
+
+        f.size = 24.0, 0
+        size = f.size
+        self.assertIsInstance(size, float)
+        self.assertEqual(size, 24.0)
+
+        f.size = 16, 16
+        size = f.size
+        self.assertIsInstance(size, tuple)
+        self.assertEqual(len(size), 2)
+
+        x, y = size
+        self.assertIsInstance(x, float)
+        self.assertEqual(x, 16.0)
+        self.assertIsInstance(y, float)
+        self.assertEqual(y, 16.0)
+
+        f.size = 20.5, 22.25
+        x, y = f.size
+        self.assertEqual(x, 20.5)
+        self.assertEqual(y, 22.25)
+
+        f.size = 0, 0
+        size = f.size
+        self.assertIsInstance(size, float)
+        self.assertEqual(size, 0.0)
+        self.assertRaises(ValueError, setattr, f, "size", (0, 24.0))
+        self.assertRaises(TypeError, setattr, f, "size", (24.0,))
+        self.assertRaises(TypeError, setattr, f, "size", (24.0, 0, 0))
+        self.assertRaises(TypeError, setattr, f, "size", (24.0j, 24.0))
+        self.assertRaises(TypeError, setattr, f, "size", (24.0, 24.0j))
+        self.assertRaises(OverflowError, setattr, f, "size", (-1, 16))
+        self.assertRaises(OverflowError, setattr, f, "size", (max_point_size + 1, 16))
+        self.assertRaises(OverflowError, setattr, f, "size", (16, -1))
+        self.assertRaises(OverflowError, setattr, f, "size", (16, max_point_size + 1))
+
+        # bitmap files with identical point size but differing ppems.
+        f75 = self._TEST_FONTS["bmp-18-75dpi"]
+        sizes = f75.get_sizes()
+        self.assertEqual(len(sizes), 1)
+        size_pt, width_px, height_px, x_ppem, y_ppem = sizes[0]
+        self.assertEqual(size_pt, 18)
+        self.assertEqual(x_ppem, 19.0)
+        self.assertEqual(y_ppem, 19.0)
+        rect = f75.get_rect("A", size=18)
+        rect = f75.get_rect("A", size=19)
+        rect = f75.get_rect("A", size=(19.0, 19.0))
+        self.assertRaises(pygame.error, f75.get_rect, "A", size=17)
+        f100 = self._TEST_FONTS["bmp-18-100dpi"]
+        sizes = f100.get_sizes()
+        self.assertEqual(len(sizes), 1)
+        size_pt, width_px, height_px, x_ppem, y_ppem = sizes[0]
+        self.assertEqual(size_pt, 18)
+        self.assertEqual(x_ppem, 25.0)
+        self.assertEqual(y_ppem, 25.0)
+        rect = f100.get_rect("A", size=18)
+        rect = f100.get_rect("A", size=25)
+        rect = f100.get_rect("A", size=(25.0, 25.0))
+        self.assertRaises(pygame.error, f100.get_rect, "A", size=17)
+
+    def test_freetype_Font_rotation(self):
+        test_angles = [
+            (30, 30),
+            (360, 0),
+            (390, 30),
+            (720, 0),
+            (764, 44),
+            (-30, 330),
+            (-360, 0),
+            (-390, 330),
+            (-720, 0),
+            (-764, 316),
+        ]
+
+        f = ft.Font(None)
+        self.assertEqual(f.rotation, 0)
+        for r, r_reduced in test_angles:
+            f.rotation = r
+            self.assertEqual(
+                f.rotation,
+                r_reduced,
+                "for angle %d: %d != %d" % (r, f.rotation, r_reduced),
+            )
+        self.assertRaises(TypeError, setattr, f, "rotation", "12")
+
+    def test_freetype_Font_render_to(self):
+        # Rendering to an existing target surface is equivalent to
+        # blitting a surface returned by Font.render with the target.
+        font = self._TEST_FONTS["sans"]
+
+        surf = pygame.Surface((800, 600))
+        color = pygame.Color(0, 0, 0)
+
+        rrect = font.render_to(surf, (32, 32), "FoobarBaz", color, None, size=24)
+        self.assertIsInstance(rrect, pygame.Rect)
+        self.assertEqual(rrect.topleft, (32, 32))
+        self.assertNotEqual(rrect.bottomright, (32, 32))
+
+        rcopy = rrect.copy()
+        rcopy.topleft = (32, 32)
+        self.assertTrue(surf.get_rect().contains(rcopy))
+
+        rect = pygame.Rect(20, 20, 2, 2)
+        rrect = font.render_to(surf, rect, "FoobarBax", color, None, size=24)
+        self.assertEqual(rect.topleft, rrect.topleft)
+        self.assertNotEqual(rrect.size, rect.size)
+        rrect = font.render_to(surf, (20.1, 18.9), "FoobarBax", color, None, size=24)
+
+        rrect = font.render_to(surf, rect, "", color, None, size=24)
+        self.assertFalse(rrect)
+        self.assertEqual(rrect.height, font.get_sized_height(24))
+
+        # invalid surf test
+        self.assertRaises(TypeError, font.render_to, "not a surface", "text", color)
+        self.assertRaises(TypeError, font.render_to, pygame.Surface, "text", color)
+
+        # invalid dest test
+        for dest in [
+            None,
+            0,
+            "a",
+            "ab",
+            (),
+            (1,),
+            ("a", 2),
+            (1, "a"),
+            (1 + 2j, 2),
+            (1, 1 + 2j),
+            (1, int),
+            (int, 1),
+        ]:
+            self.assertRaises(
+                TypeError, font.render_to, surf, dest, "foobar", color, size=24
+            )
+
+        # misc parameter test
+        self.assertRaises(ValueError, font.render_to, surf, (0, 0), "foobar", color)
+        self.assertRaises(
+            TypeError, font.render_to, surf, (0, 0), "foobar", color, 2.3, size=24
+        )
+        self.assertRaises(
+            ValueError,
+            font.render_to,
+            surf,
+            (0, 0),
+            "foobar",
+            color,
+            None,
+            style=42,
+            size=24,
+        )
+        self.assertRaises(
+            TypeError,
+            font.render_to,
+            surf,
+            (0, 0),
+            "foobar",
+            color,
+            None,
+            style=None,
+            size=24,
+        )
+        self.assertRaises(
+            ValueError,
+            font.render_to,
+            surf,
+            (0, 0),
+            "foobar",
+            color,
+            None,
+            style=97,
+            size=24,
+        )
+
+    def test_freetype_Font_render(self):
+        font = self._TEST_FONTS["sans"]
+
+        surf = pygame.Surface((800, 600))
+        color = pygame.Color(0, 0, 0)
+
+        rend = font.render("FoobarBaz", pygame.Color(0, 0, 0), None, size=24)
+        self.assertIsInstance(rend, tuple)
+        self.assertEqual(len(rend), 2)
+        self.assertIsInstance(rend[0], pygame.Surface)
+        self.assertIsInstance(rend[1], pygame.Rect)
+        self.assertEqual(rend[0].get_rect().size, rend[1].size)
+
+        s, r = font.render("", pygame.Color(0, 0, 0), None, size=24)
+        self.assertEqual(r.width, 0)
+        self.assertEqual(r.height, font.get_sized_height(24))
+        self.assertEqual(s.get_size(), r.size)
+        self.assertEqual(s.get_bitsize(), 32)
+
+        # misc parameter test
+        self.assertRaises(ValueError, font.render, "foobar", color)
+        self.assertRaises(TypeError, font.render, "foobar", color, 2.3, size=24)
+        self.assertRaises(
+            ValueError, font.render, "foobar", color, None, style=42, size=24
+        )
+        self.assertRaises(
+            TypeError, font.render, "foobar", color, None, style=None, size=24
+        )
+        self.assertRaises(
+            ValueError, font.render, "foobar", color, None, style=97, size=24
+        )
+
+        # valid surrogate pairs
+        font2 = self._TEST_FONTS["mono"]
+        ucs4 = font2.ucs4
+        try:
+            font2.ucs4 = False
+            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)
+            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, "\uD7FF\uDCA7", color, size=24
+        )
+        self.assertRaises(
+            UnicodeEncodeError, font.render, "\uDC00\uDCA7", color, size=24
+        )
+        self.assertRaises(
+            UnicodeEncodeError, font.render, "\uD80C\uDBFF", color, size=24
+        )
+        self.assertRaises(
+            UnicodeEncodeError, font.render, "\uD80C\uE000", color, size=24
+        )
+
+        # raises exception when uninitialized
+        self.assertRaises(RuntimeError, nullfont().render, "a", (0, 0, 0), size=24)
+
+        # Confirm the correct glyphs are returned for a couple of
+        # unicode code points, 'A' and '\U00023079'. For each code point
+        # the rendered glyph is compared with an image of glyph bitmap
+        # as exported by FontForge.
+        path = os.path.join(FONTDIR, "A_PyGameMono-8.png")
+        A = pygame.image.load(path)
+        path = os.path.join(FONTDIR, "u13079_PyGameMono-8.png")
+        u13079 = pygame.image.load(path)
+
+        font = self._TEST_FONTS["mono"]
+        font.ucs4 = False
+        A_rendered, r = font.render("A", bgcolor=pygame.Color("white"), size=8)
+        u13079_rendered, r = font.render(
+            "\U00013079", bgcolor=pygame.Color("white"), size=8
+        )
+
+        # before comparing the surfaces, make sure they are the same
+        # pixel format. Use 32-bit SRCALPHA to avoid row padding and
+        # undefined bytes (the alpha byte will be set to 255.)
+        bitmap = pygame.Surface(A.get_size(), pygame.SRCALPHA, 32)
+        bitmap.blit(A, (0, 0))
+        rendering = pygame.Surface(A_rendered.get_size(), pygame.SRCALPHA, 32)
+        rendering.blit(A_rendered, (0, 0))
+        self.assertTrue(surf_same_image(rendering, bitmap))
+        bitmap = pygame.Surface(u13079.get_size(), pygame.SRCALPHA, 32)
+        bitmap.blit(u13079, (0, 0))
+        rendering = pygame.Surface(u13079_rendered.get_size(), pygame.SRCALPHA, 32)
+        rendering.blit(u13079_rendered, (0, 0))
+        self.assertTrue(surf_same_image(rendering, bitmap))
+
+    def test_freetype_Font_render_mono(self):
+        font = self._TEST_FONTS["sans"]
+        color = pygame.Color("black")
+        colorkey = pygame.Color("white")
+        text = "."
+
+        save_antialiased = font.antialiased
+        font.antialiased = False
+        try:
+            surf, r = font.render(text, color, size=24)
+            self.assertEqual(surf.get_bitsize(), 8)
+            flags = surf.get_flags()
+            self.assertTrue(flags & pygame.SRCCOLORKEY)
+            self.assertFalse(flags & (pygame.SRCALPHA | pygame.HWSURFACE))
+            self.assertEqual(surf.get_colorkey(), colorkey)
+            self.assertIsNone(surf.get_alpha())
+
+            translucent_color = pygame.Color(*color)
+            translucent_color.a = 55
+            surf, r = font.render(text, translucent_color, size=24)
+            self.assertEqual(surf.get_bitsize(), 8)
+            flags = surf.get_flags()
+            self.assertTrue(flags & (pygame.SRCCOLORKEY | pygame.SRCALPHA))
+            self.assertFalse(flags & pygame.HWSURFACE)
+            self.assertEqual(surf.get_colorkey(), colorkey)
+            self.assertEqual(surf.get_alpha(), translucent_color.a)
+
+            surf, r = font.render(text, color, colorkey, size=24)
+            self.assertEqual(surf.get_bitsize(), 32)
+        finally:
+            font.antialiased = save_antialiased
+
+    def test_freetype_Font_render_to_mono(self):
+        # Blitting is done in two stages. First the target is alpha filled
+        # with the background color, if any. Second, the foreground
+        # color is alpha blitted to the background.
+        font = self._TEST_FONTS["sans"]
+        text = " ."
+        rect = font.get_rect(text, size=24)
+        size = rect.size
+        fg = pygame.Surface((1, 1), pygame.SRCALPHA, 32)
+        bg = pygame.Surface((1, 1), pygame.SRCALPHA, 32)
+        surrogate = pygame.Surface((1, 1), pygame.SRCALPHA, 32)
+        surfaces = [
+            pygame.Surface(size, 0, 8),
+            pygame.Surface(size, 0, 16),
+            pygame.Surface(size, pygame.SRCALPHA, 16),
+            pygame.Surface(size, 0, 24),
+            pygame.Surface(size, 0, 32),
+            pygame.Surface(size, pygame.SRCALPHA, 32),
+        ]
+        fg_colors = [
+            surfaces[0].get_palette_at(2),
+            surfaces[1].unmap_rgb(surfaces[1].map_rgb((128, 64, 200))),
+            surfaces[2].unmap_rgb(surfaces[2].map_rgb((99, 0, 100, 64))),
+            (128, 97, 213),
+            (128, 97, 213),
+            (128, 97, 213, 60),
+        ]
+        fg_colors = [pygame.Color(*c) for c in fg_colors]
+        self.assertEqual(len(surfaces), len(fg_colors))  # integrity check
+        bg_colors = [
+            surfaces[0].get_palette_at(4),
+            surfaces[1].unmap_rgb(surfaces[1].map_rgb((220, 20, 99))),
+            surfaces[2].unmap_rgb(surfaces[2].map_rgb((55, 200, 0, 86))),
+            (255, 120, 13),
+            (255, 120, 13),
+            (255, 120, 13, 180),
+        ]
+        bg_colors = [pygame.Color(*c) for c in bg_colors]
+        self.assertEqual(len(surfaces), len(bg_colors))  # integrity check
+
+        save_antialiased = font.antialiased
+        font.antialiased = False
+        try:
+            fill_color = pygame.Color("black")
+            for i, surf in enumerate(surfaces):
+                surf.fill(fill_color)
+                fg_color = fg_colors[i]
+                fg.set_at((0, 0), fg_color)
+                surf.blit(fg, (0, 0))
+                r_fg_color = surf.get_at((0, 0))
+                surf.set_at((0, 0), fill_color)
+                rrect = font.render_to(surf, (0, 0), text, fg_color, size=24)
+                bottomleft = 0, rrect.height - 1
+                self.assertEqual(
+                    surf.get_at(bottomleft),
+                    fill_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),
+                )
+            for i, surf in enumerate(surfaces):
+                surf.fill(fill_color)
+                fg_color = fg_colors[i]
+                bg_color = bg_colors[i]
+                bg.set_at((0, 0), bg_color)
+                fg.set_at((0, 0), fg_color)
+                if surf.get_bitsize() == 24:
+                    # For a 24 bit target surface test against Pygame's alpha
+                    # blit as there appears to be a problem with SDL's alpha
+                    # blit:
+                    #
+                    # self.assertEqual(surf.get_at(bottomright), r_fg_color)
+                    #
+                    # raises
+                    #
+                    # AssertionError: (128, 97, 213, 255) != (129, 98, 213, 255)
+                    #
+                    surrogate.set_at((0, 0), fill_color)
+                    surrogate.blit(bg, (0, 0))
+                    r_bg_color = surrogate.get_at((0, 0))
+                    surrogate.blit(fg, (0, 0))
+                    r_fg_color = surrogate.get_at((0, 0))
+                else:
+                    # Surface blit values for comparison.
+                    surf.blit(bg, (0, 0))
+                    r_bg_color = surf.get_at((0, 0))
+                    surf.blit(fg, (0, 0))
+                    r_fg_color = surf.get_at((0, 0))
+                    surf.set_at((0, 0), fill_color)
+                rrect = font.render_to(surf, (0, 0), text, fg_color, bg_color, size=24)
+                bottomleft = 0, rrect.height - 1
+                self.assertEqual(surf.get_at(bottomleft), r_bg_color)
+                bottomright = rrect.width - 1, rrect.height - 1
+                self.assertEqual(surf.get_at(bottomright), r_fg_color)
+        finally:
+            font.antialiased = save_antialiased
+
+    def test_freetype_Font_render_raw(self):
+        font = self._TEST_FONTS["sans"]
+
+        text = "abc"
+        size = font.get_rect(text, size=24).size
+        rend = font.render_raw(text, size=24)
+        self.assertIsInstance(rend, tuple)
+        self.assertEqual(len(rend), 2)
+
+        r, s = rend
+        self.assertIsInstance(r, bytes)
+        self.assertIsInstance(s, tuple)
+        self.assertTrue(len(s), 2)
+
+        w, h = s
+        self.assertIsInstance(w, int)
+        self.assertIsInstance(h, int)
+        self.assertEqual(s, size)
+        self.assertEqual(len(r), w * h)
+
+        r, (w, h) = font.render_raw("", size=24)
+        self.assertEqual(w, 0)
+        self.assertEqual(h, font.height)
+        self.assertEqual(len(r), 0)
+
+        # bug with decenders: this would crash
+        rend = font.render_raw("render_raw", size=24)
+
+        # bug with non-printable characters: this would cause a crash
+        # because the text length was not adjusted for skipped characters.
+        text = "".join([chr(i) for i in range(31, 64)])
+        rend = font.render_raw(text, size=10)
+
+    def test_freetype_Font_render_raw_to(self):
+        # This only checks that blits do not crash. It needs to check:
+        # - int values
+        # - invert option
+        #
+
+        font = self._TEST_FONTS["sans"]
+        text = "abc"
+
+        # 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)
+        self.assertEqual(rrect, srect)
+
+        for bpp in [24, 32]:
+            surf = pygame.Surface(srect.size, 0, bpp)
+            rrect = font.render_raw_to(surf.get_view("r"), text, size=24)
+            self.assertEqual(rrect, srect)
+
+        # Underlining to int1 (__fill_glyph_INT)
+        srect = font.get_rect(text, size=24, style=ft.STYLE_UNDERLINE)
+        surf = pygame.Surface(srect.size, 0, 8)
+        rrect = font.render_raw_to(
+            surf.get_view("2"), text, size=24, style=ft.STYLE_UNDERLINE
+        )
+        self.assertEqual(rrect, srect)
+
+        for bpp in [24, 32]:
+            surf = pygame.Surface(srect.size, 0, bpp)
+            rrect = font.render_raw_to(
+                surf.get_view("r"), text, size=24, style=ft.STYLE_UNDERLINE
+            )
+            self.assertEqual(rrect, srect)
+
+        # Unaliased (mono) rendering to int1 (__render_glyph_MONO_as_INT)
+        font.antialiased = False
+        try:
+            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)
+            self.assertEqual(rrect, srect)
+
+            for bpp in [24, 32]:
+                surf = pygame.Surface(srect.size, 0, bpp)
+                rrect = font.render_raw_to(surf.get_view("r"), text, size=24)
+                self.assertEqual(rrect, srect)
+        finally:
+            font.antialiased = True
+
+        # Antialiased render to ints sized greater than 1 byte
+        # (__render_glyph_INT)
+        srect = font.get_rect(text, size=24)
+
+        for bpp in [16, 24, 32]:
+            surf = pygame.Surface(srect.size, 0, bpp)
+            rrect = font.render_raw_to(surf.get_view("2"), text, size=24)
+            self.assertEqual(rrect, srect)
+
+        # Underline render to ints sized greater than 1 byte
+        # (__fill_glyph_INT)
+        srect = font.get_rect(text, size=24, style=ft.STYLE_UNDERLINE)
+
+        for bpp in [16, 24, 32]:
+            surf = pygame.Surface(srect.size, 0, bpp)
+            rrect = font.render_raw_to(
+                surf.get_view("2"), text, size=24, style=ft.STYLE_UNDERLINE
+            )
+            self.assertEqual(rrect, srect)
+
+        # Unaliased (mono) rendering to ints greater than 1 byte
+        # (__render_glyph_MONO_as_INT)
+        font.antialiased = False
+        try:
+            srect = font.get_rect(text, size=24)
+
+            for bpp in [16, 24, 32]:
+                surf = pygame.Surface(srect.size, 0, bpp)
+                rrect = font.render_raw_to(surf.get_view("2"), text, size=24)
+                self.assertEqual(rrect, srect)
+        finally:
+            font.antialiased = True
+
+        # Invalid dest parameter test.
+        srect = font.get_rect(text, size=24)
+        surf_buf = pygame.Surface(srect.size, 0, 32).get_view("2")
+
+        for dest in [
+            0,
+            "a",
+            "ab",
+            (),
+            (1,),
+            ("a", 2),
+            (1, "a"),
+            (1 + 2j, 2),
+            (1, 1 + 2j),
+            (1, int),
+            (int, 1),
+        ]:
+            self.assertRaises(
+                TypeError, font.render_raw_to, surf_buf, text, dest, size=24
+            )
+
+    def test_freetype_Font_text_is_None_with_arr(self):
+        f = ft.Font(self._sans_path, 36)
+        f.style = ft.STYLE_NORMAL
+        f.rotation = 0
+        text = "ABCD"
+
+        # reference values
+        get_rect = f.get_rect(text)
+        f.vertical = True
+        get_rect_vert = f.get_rect(text)
+
+        self.assertTrue(get_rect_vert.width < get_rect.width)
+        self.assertTrue(get_rect_vert.height > get_rect.height)
+        f.vertical = False
+        render_to_surf = pygame.Surface(get_rect.size, pygame.SRCALPHA, 32)
+
+        if IS_PYPY:
+            return
+
+        arr = arrinter.Array(get_rect.size, "u", 1)
+        render = f.render(text, (0, 0, 0))
+        render_to = f.render_to(render_to_surf, (0, 0), text, (0, 0, 0))
+        render_raw = f.render_raw(text)
+        render_raw_to = f.render_raw_to(arr, text)
+
+        # comparisons
+        surf = pygame.Surface(get_rect.size, pygame.SRCALPHA, 32)
+        self.assertEqual(f.get_rect(None), get_rect)
+        s, r = f.render(None, (0, 0, 0))
+        self.assertEqual(r, render[1])
+        self.assertTrue(surf_same_image(s, render[0]))
+        r = f.render_to(surf, (0, 0), None, (0, 0, 0))
+        self.assertEqual(r, render_to)
+        self.assertTrue(surf_same_image(surf, render_to_surf))
+        px, sz = f.render_raw(None)
+        self.assertEqual(sz, render_raw[1])
+        self.assertEqual(px, render_raw[0])
+        sz = f.render_raw_to(arr, None)
+        self.assertEqual(sz, render_raw_to)
+
+    def test_freetype_Font_text_is_None(self):
+        f = ft.Font(self._sans_path, 36)
+        f.style = ft.STYLE_NORMAL
+        f.rotation = 0
+        text = "ABCD"
+
+        # reference values
+        get_rect = f.get_rect(text)
+        f.vertical = True
+        get_rect_vert = f.get_rect(text)
+
+        # vertical: trigger glyph positioning.
+        f.vertical = True
+        r = f.get_rect(None)
+        self.assertEqual(r, get_rect_vert)
+        f.vertical = False
+
+        # wide style: trigger glyph reload
+        r = f.get_rect(None, style=ft.STYLE_WIDE)
+        self.assertEqual(r.height, get_rect.height)
+        self.assertTrue(r.width > get_rect.width)
+        r = f.get_rect(None)
+        self.assertEqual(r, get_rect)
+
+        # rotated: trigger glyph reload
+        r = f.get_rect(None, rotation=90)
+        self.assertEqual(r.width, get_rect.height)
+        self.assertEqual(r.height, get_rect.width)
+
+        # this method will not support None text
+        self.assertRaises(TypeError, f.get_metrics, None)
+
+    def test_freetype_Font_fgcolor(self):
+        f = ft.Font(self._bmp_8_75dpi_path)
+        notdef = "\0"  # the PyGameMono .notdef glyph has a pixel at (0, 0)
+        f.origin = False
+        f.pad = False
+        black = pygame.Color("black")  # initial color
+        green = pygame.Color("green")
+        alpha128 = pygame.Color(10, 20, 30, 128)
+
+        c = f.fgcolor
+        self.assertIsInstance(c, pygame.Color)
+        self.assertEqual(c, black)
+
+        s, r = f.render(notdef)
+        self.assertEqual(s.get_at((0, 0)), black)
+
+        f.fgcolor = green
+        self.assertEqual(f.fgcolor, green)
+
+        s, r = f.render(notdef)
+        self.assertEqual(s.get_at((0, 0)), green)
+
+        f.fgcolor = alpha128
+        s, r = f.render(notdef)
+        self.assertEqual(s.get_at((0, 0)), alpha128)
+
+        surf = pygame.Surface(f.get_rect(notdef).size, pygame.SRCALPHA, 32)
+        f.render_to(surf, (0, 0), None)
+        self.assertEqual(surf.get_at((0, 0)), alpha128)
+
+        self.assertRaises(AttributeError, setattr, f, "fgcolor", None)
+
+    def test_freetype_Font_bgcolor(self):
+        f = ft.Font(None, 32)
+        zero = "0"  # the default font 0 glyph does not have a pixel at (0, 0)
+        f.origin = False
+        f.pad = False
+
+        transparent_black = pygame.Color(0, 0, 0, 0)  # initial color
+        green = pygame.Color("green")
+        alpha128 = pygame.Color(10, 20, 30, 128)
+
+        c = f.bgcolor
+        self.assertIsInstance(c, pygame.Color)
+        self.assertEqual(c, transparent_black)
+
+        s, r = f.render(zero, pygame.Color(255, 255, 255))
+        self.assertEqual(s.get_at((0, 0)), transparent_black)
+
+        f.bgcolor = green
+        self.assertEqual(f.bgcolor, green)
+
+        s, r = f.render(zero)
+        self.assertEqual(s.get_at((0, 0)), green)
+
+        f.bgcolor = alpha128
+        s, r = f.render(zero)
+        self.assertEqual(s.get_at((0, 0)), alpha128)
+
+        surf = pygame.Surface(f.get_rect(zero).size, pygame.SRCALPHA, 32)
+        f.render_to(surf, (0, 0), None)
+        self.assertEqual(surf.get_at((0, 0)), alpha128)
+
+        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
+
+        Exporter = buftools.Exporter
+        font = self._TEST_FONTS["sans"]
+        srect = font.get_rect("Hi", size=12)
+        for format in [
+            "b",
+            "B",
+            "h",
+            "H",
+            "i",
+            "I",
+            "l",
+            "L",
+            "q",
+            "Q",
+            "x",
+            "1x",
+            "2x",
+            "3x",
+            "4x",
+            "5x",
+            "6x",
+            "7x",
+            "8x",
+            "9x",
+            "h",
+            "=h",
+            "@h",
+            "!h",
+            "1h",
+            "=1h",
+        ]:
+            newbuf = Exporter(srect.size, format=format)
+            rrect = font.render_raw_to(newbuf, "Hi", size=12)
+            self.assertEqual(rrect, srect)
+        # Some unsupported formats
+        for format in ["f", "d", "2h", "?", "hh"]:
+            newbuf = Exporter(srect.size, format=format, itemsize=4)
+            self.assertRaises(ValueError, font.render_raw_to, newbuf, "Hi", size=12)
+
+    def test_freetype_Font_style(self):
+        font = self._TEST_FONTS["sans"]
+
+        # make sure STYLE_NORMAL is the default value
+        self.assertEqual(ft.STYLE_NORMAL, font.style)
+
+        # make sure we check for style type
+        with self.assertRaises(TypeError):
+            font.style = "None"
+        with self.assertRaises(TypeError):
+            font.style = None
+
+        # make sure we only accept valid constants
+        with self.assertRaises(ValueError):
+            font.style = 112
+
+        # make assure no assignments happened
+        self.assertEqual(ft.STYLE_NORMAL, font.style)
+
+        # test assignment
+        font.style = ft.STYLE_UNDERLINE
+        self.assertEqual(ft.STYLE_UNDERLINE, font.style)
+
+        # test complex styles
+        st = ft.STYLE_STRONG | ft.STYLE_UNDERLINE | ft.STYLE_OBLIQUE
+
+        font.style = st
+        self.assertEqual(st, font.style)
+
+        # and that STYLE_DEFAULT has no effect (continued from above)
+        self.assertNotEqual(st, ft.STYLE_DEFAULT)
+        font.style = ft.STYLE_DEFAULT
+        self.assertEqual(st, font.style)
+
+        # revert changes
+        font.style = ft.STYLE_NORMAL
+        self.assertEqual(ft.STYLE_NORMAL, font.style)
+
+    def test_freetype_Font_resolution(self):
+        text = "|"  # Differs in width and height
+        resolution = ft.get_default_resolution()
+        new_font = ft.Font(self._sans_path, resolution=2 * resolution)
+        self.assertEqual(new_font.resolution, 2 * resolution)
+        size_normal = self._TEST_FONTS["sans"].get_rect(text, size=24).size
+        size_scaled = new_font.get_rect(text, size=24).size
+        size_by_2 = size_normal[0] * 2
+        self.assertTrue(
+            size_by_2 + 2 >= size_scaled[0] >= size_by_2 - 2,
+            "%i not equal %i" % (size_scaled[1], size_by_2),
+        )
+        size_by_2 = size_normal[1] * 2
+        self.assertTrue(
+            size_by_2 + 2 >= size_scaled[1] >= size_by_2 - 2,
+            "%i not equal %i" % (size_scaled[1], size_by_2),
+        )
+        new_resolution = resolution + 10
+        ft.set_default_resolution(new_resolution)
+        try:
+            new_font = ft.Font(self._sans_path, resolution=0)
+            self.assertEqual(new_font.resolution, new_resolution)
+        finally:
+            ft.set_default_resolution()
+
+    def test_freetype_Font_path(self):
+        self.assertEqual(self._TEST_FONTS["sans"].path, self._sans_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.
+    def test_freetype_Font_cache(self):
+        glyphs = "abcde"
+        glen = len(glyphs)
+        other_glyphs = "123"
+        oglen = len(other_glyphs)
+        uempty = ""
+        ##        many_glyphs = (uempty.join([chr(i) for i in range(32,127)] +
+        ##                                   [chr(i) for i in range(161,172)] +
+        ##                                   [chr(i) for i in range(174,239)]))
+        many_glyphs = uempty.join([chr(i) for i in range(32, 127)])
+        mglen = len(many_glyphs)
+
+        count = 0
+        access = 0
+        hit = 0
+        miss = 0
+
+        f = ft.Font(None, size=24, font_index=0, resolution=72, ucs4=False)
+        f.style = ft.STYLE_NORMAL
+        f.antialiased = True
+
+        # Ensure debug counters are zero
+        self.assertEqual(f._debug_cache_stats, (0, 0, 0, 0, 0))
+        # Load some basic glyphs
+        count = access = miss = glen
+        f.render_raw(glyphs)
+        self.assertEqual(f._debug_cache_stats, (count, 0, access, hit, miss))
+        # Vertical should not affect the cache
+        access += glen
+        hit += glen
+        f.vertical = True
+        f.render_raw(glyphs)
+        f.vertical = False
+        self.assertEqual(f._debug_cache_stats, (count, 0, access, hit, miss))
+        # New glyphs will
+        count += oglen
+        access += oglen
+        miss += oglen
+        f.render_raw(other_glyphs)
+        self.assertEqual(f._debug_cache_stats, (count, 0, access, hit, miss))
+        # Point size does
+        count += glen
+        access += glen
+        miss += glen
+        f.render_raw(glyphs, size=12)
+        self.assertEqual(f._debug_cache_stats, (count, 0, access, hit, miss))
+        # Underline style does not
+        access += oglen
+        hit += oglen
+        f.underline = True
+        f.render_raw(other_glyphs)
+        f.underline = False
+        self.assertEqual(f._debug_cache_stats, (count, 0, access, hit, miss))
+        # Oblique style does
+        count += glen
+        access += glen
+        miss += glen
+        f.oblique = True
+        f.render_raw(glyphs)
+        f.oblique = False
+        self.assertEqual(f._debug_cache_stats, (count, 0, access, hit, miss))
+        # Strong style does; by this point cache clears can happen
+        count += glen
+        access += glen
+        miss += glen
+        f.strong = True
+        f.render_raw(glyphs)
+        f.strong = False
+        ccount, cdelete_count, caccess, chit, cmiss = f._debug_cache_stats
+        self.assertEqual(
+            (ccount + cdelete_count, caccess, chit, cmiss), (count, access, hit, miss)
+        )
+        # Rotation does
+        count += glen
+        access += glen
+        miss += glen
+        f.render_raw(glyphs, rotation=10)
+        ccount, cdelete_count, caccess, chit, cmiss = f._debug_cache_stats
+        self.assertEqual(
+            (ccount + cdelete_count, caccess, chit, cmiss), (count, access, hit, miss)
+        )
+        # aliased (mono) glyphs do
+        count += oglen
+        access += oglen
+        miss += oglen
+        f.antialiased = False
+        f.render_raw(other_glyphs)
+        f.antialiased = True
+        ccount, cdelete_count, caccess, chit, cmiss = f._debug_cache_stats
+        self.assertEqual(
+            (ccount + cdelete_count, caccess, chit, cmiss), (count, access, hit, miss)
+        )
+        # Trigger a cleanup for sure.
+        count += 2 * mglen
+        access += 2 * mglen
+        miss += 2 * mglen
+        f.get_metrics(many_glyphs, size=8)
+        f.get_metrics(many_glyphs, size=10)
+        ccount, cdelete_count, caccess, chit, cmiss = f._debug_cache_stats
+        self.assertTrue(ccount < count)
+        self.assertEqual(
+            (ccount + cdelete_count, caccess, chit, cmiss), (count, access, hit, miss)
+        )
+
+    try:
+        ft.Font._debug_cache_stats
+    except AttributeError:
+        del test_freetype_Font_cache
+
+    def test_undefined_character_code(self):
+        # To be consistent with pygame.font.Font, undefined codes
+        # are rendered as the undefined character, and has metrics
+        # of None.
+        font = self._TEST_FONTS["sans"]
+
+        img, size1 = font.render(chr(1), (0, 0, 0), size=24)
+        img, size0 = font.render("", (0, 0, 0), size=24)
+        self.assertTrue(size1.width > size0.width)
+
+        metrics = font.get_metrics(chr(1) + chr(48), size=24)
+        self.assertEqual(len(metrics), 2)
+        self.assertIsNone(metrics[0])
+        self.assertIsInstance(metrics[1], tuple)
+
+    def test_issue_242(self):
+        """Issue #242: get_rect() uses 0 as default style"""
+
+        # 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()
+        # should match the boundary of the same text rendered directly to a
+        # surface. This permits accurate text positioning. To work properly,
+        # get_rect() should calculate the text boundary to reflect text style,
+        # such as underline. Instead, it ignores the style settings for the
+        # Font object when the style argument is omitted.
+        #
+        # When the style argument is not given, freetype.get_rect() uses
+        # unstyled text when calculating the boundary rectangle. This is
+        # because _ftfont_getrect(), in _freetype.c, set the default
+        # style to 0 rather than FT_STYLE_DEFAULT.
+        #
+        font = self._TEST_FONTS["sans"]
+
+        # Try wide style on a wide character.
+        prev_style = font.wide
+        font.wide = True
+        try:
+            rect = font.get_rect("M", size=64)
+            surf, rrect = font.render(None, size=64)
+            self.assertEqual(rect, rrect)
+        finally:
+            font.wide = prev_style
+
+        # Try strong style on several wide characters.
+        prev_style = font.strong
+        font.strong = True
+        try:
+            rect = font.get_rect("Mm_", size=64)
+            surf, rrect = font.render(None, size=64)
+            self.assertEqual(rect, rrect)
+        finally:
+            font.strong = prev_style
+
+        # Try oblique style on a tall, narrow character.
+        prev_style = font.oblique
+        font.oblique = True
+        try:
+            rect = font.get_rect("|", size=64)
+            surf, rrect = font.render(None, size=64)
+            self.assertEqual(rect, rrect)
+        finally:
+            font.oblique = prev_style
+
+        # Try underline style on a glyphless character.
+        prev_style = font.underline
+        font.underline = True
+        try:
+            rect = font.get_rect(" ", size=64)
+            surf, rrect = font.render(None, size=64)
+            self.assertEqual(rect, rrect)
+        finally:
+            font.underline = prev_style
+
+    def test_issue_237(self):
+        """Issue #237: Memory overrun when rendered with underlining"""
+
+        # Issue #237: Memory overrun when text without descenders is rendered
+        #             with underlining
+        #
+        # The bug crashes the Python interpreter. The bug is caught with C
+        # assertions in ft_render_cb.c when the Pygame module is compiled
+        # for debugging. So far it is only known to affect Times New Roman.
+        #
+        name = "Times New Roman"
+        font = ft.SysFont(name, 19)
+        if font.name != name:
+            # The font is unavailable, so skip the test.
+            return
+        font.underline = True
+        s, r = font.render("Amazon", size=19)
+
+        # Some other checks to make sure nothing else broke.
+        for adj in [-2, -1.9, -1, 0, 1.9, 2]:
+            font.underline_adjustment = adj
+            s, r = font.render("Amazon", size=19)
+
+    def test_issue_243(self):
+        """Issue Y: trailing space ignored in boundary calculation"""
+
+        # Issue #243: For a string with trailing spaces, freetype ignores the
+        # last space in boundary calculations
+        #
+        font = self._TEST_FONTS["fixed"]
+        r1 = font.get_rect(" ", size=64)
+        self.assertTrue(r1.width > 1)
+        r2 = font.get_rect("  ", size=64)
+        self.assertEqual(r2.width, 2 * r1.width)
+
+    def test_garbage_collection(self):
+        """Check reference counting on returned new references"""
+
+        def ref_items(seq):
+            return [weakref.ref(o) for o in seq]
+
+        font = self._TEST_FONTS["bmp-8-75dpi"]
+        font.size = font.get_sizes()[0][0]
+        text = "A"
+        rect = font.get_rect(text)
+        surf = pygame.Surface(rect.size, pygame.SRCALPHA, 32)
+        refs = []
+        refs.extend(ref_items(font.render(text, (0, 0, 0))))
+        refs.append(weakref.ref(font.render_to(surf, (0, 0), text, (0, 0, 0))))
+        refs.append(weakref.ref(font.get_rect(text)))
+
+        n = len(refs)
+        self.assertTrue(n > 0)
+
+        # 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)
+
+        try:
+            from sys import getrefcount
+        except ImportError:
+            pass
+        else:
+            array = arrinter.Array(rect.size, "u", 1)
+            o = font.render_raw(text)
+            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.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.assertEqual(getrefcount(o), 2)
+            for i in range(len(o)):
+                self.assertEqual(getrefcount(o[i]), 2, "refcount fail for item %d" % i)
+
+    def test_display_surface_quit(self):
+        """Font.render_to() on a closed display surface"""
+
+        # The Font.render_to() method checks that PySurfaceObject.surf is NULL
+        # 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"]
+        self.assertRaises(
+            pygame.error, f.render_to, null_surface, (0, 0), "Crash!", size=12
+        )
+
+    def test_issue_565(self):
+        """get_metrics supporting rotation/styles/size"""
+
+        tests = [
+            {"method": "size", "value": 36, "msg": "metrics same for size"},
+            {"method": "rotation", "value": 90, "msg": "metrics same for rotation"},
+            {"method": "oblique", "value": True, "msg": "metrics same for oblique"},
+        ]
+        text = "|"
+
+        def run_test(method, value, msg):
+            font = ft.Font(self._sans_path, size=24)
+            before = font.get_metrics(text)
+            font.__setattr__(method, value)
+            after = font.get_metrics(text)
+            self.assertNotEqual(before, after, msg)
+
+        for test in tests:
+            run_test(test["method"], test["value"], test["msg"])
+
+    def test_freetype_SysFont_name(self):
+        """that SysFont accepts names of various types"""
+        fonts = pygame.font.get_fonts()
+        size = 12
+
+        # Check single name string:
+        font_name = ft.SysFont(fonts[0], size).name
+        self.assertFalse(font_name is None)
+
+        # Check string of comma-separated names.
+        names = ",".join(fonts)
+        font_name_2 = ft.SysFont(names, size).name
+        self.assertEqual(font_name_2, font_name)
+
+        # Check list of names.
+        font_name_2 = ft.SysFont(fonts, size).name
+        self.assertEqual(font_name_2, font_name)
+
+        # Check generator:
+        names = (name for name in fonts)
+        font_name_2 = ft.SysFont(names, size).name
+        self.assertEqual(font_name_2, font_name)
+
+        fonts_b = [f.encode() for f in fonts]
+
+        # Check single name bytes.
+        font_name_2 = ft.SysFont(fonts_b[0], size).name
+        self.assertEqual(font_name_2, font_name)
+
+        # Check comma-separated bytes.
+        names = b",".join(fonts_b)
+        font_name_2 = ft.SysFont(names, size).name
+        self.assertEqual(font_name_2, font_name)
+
+        # Check list of bytes.
+        font_name_2 = ft.SysFont(fonts_b, size).name
+        self.assertEqual(font_name_2, font_name)
+
+        # Check mixed list of bytes and string.
+        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)
+
+    def test_pathlib(self):
+        f = ft.Font(pathlib.Path(self._fixed_path), 20)
+
+
+class FreeTypeTest(unittest.TestCase):
+    def setUp(self):
+        ft.init()
+
+    def tearDown(self):
+        ft.quit()
+
+    def test_resolution(self):
+        try:
+            ft.set_default_resolution()
+            resolution = ft.get_default_resolution()
+            self.assertEqual(resolution, 72)
+            new_resolution = resolution + 10
+            ft.set_default_resolution(new_resolution)
+            self.assertEqual(ft.get_default_resolution(), new_resolution)
+            ft.init(resolution=resolution + 20)
+            self.assertEqual(ft.get_default_resolution(), new_resolution)
+        finally:
+            ft.set_default_resolution()
+
+    def test_autoinit_and_autoquit(self):
+        pygame.init()
+        self.assertTrue(ft.get_init())
+        pygame.quit()
+        self.assertFalse(ft.get_init())
+
+        # Ensure autoquit is replaced at init time
+        pygame.init()
+        self.assertTrue(ft.get_init())
+        pygame.quit()
+        self.assertFalse(ft.get_init())
+
+    def test_init(self):
+        # Test if module initialized after calling init().
+        ft.quit()
+        ft.init()
+
+        self.assertTrue(ft.get_init())
+
+    def test_init__multiple(self):
+        # Test if module initialized after multiple init() calls.
+        ft.init()
+        ft.init()
+
+        self.assertTrue(ft.get_init())
+
+    def test_quit(self):
+        # Test if module uninitialized after calling quit().
+        ft.quit()
+
+        self.assertFalse(ft.get_init())
+
+    def test_quit__multiple(self):
+        # Test if module initialized after multiple quit() calls.
+        ft.quit()
+        ft.quit()
+
+        self.assertFalse(ft.get_init())
+
+    def test_get_init(self):
+        # Test if get_init() gets the init state.
+        self.assertTrue(ft.get_init())
+
+    def test_cache_size(self):
+        DEFAULT_CACHE_SIZE = 64
+        self.assertEqual(ft.get_cache_size(), DEFAULT_CACHE_SIZE)
+        ft.quit()
+        self.assertEqual(ft.get_cache_size(), 0)
+        new_cache_size = DEFAULT_CACHE_SIZE * 2
+        ft.init(cache_size=new_cache_size)
+        self.assertEqual(ft.get_cache_size(), new_cache_size)
+
+    def test_get_error(self):
+        """Ensures get_error() is initially empty (None)."""
+        error_msg = ft.get_error()
+
+        self.assertIsNone(error_msg)
+
+    def test_get_version(self):
+        # Test that get_version() can be called before init()
+        # Also tests get_version
+        ft.quit()
+
+        # asserting not None just to have a test case
+        # there is no real fail condition other than
+        # raising an exception or a segfault, so a tuple of ints
+        # should be returned in all cases
+        self.assertIsNotNone(ft.get_version(linked=False))
+        self.assertIsNotNone(ft.get_version(linked=True))
+
+
+if __name__ == "__main__":
+    unittest.main()
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/ftfont_tags.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/ftfont_tags.py
new file mode 100644
index 0000000..0d538f4
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/ftfont_tags.py
@@ -0,0 +1,11 @@
+__tags__ = ["development"]
+
+exclude = False
+
+try:
+    import pygame.ftfont
+except ImportError:
+    exclude = True
+
+if exclude:
+    __tags__.extend(["ignore", "subprocess_ignore"])
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/ftfont_test.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/ftfont_test.py
new file mode 100644
index 0000000..cda708b
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/ftfont_test.py
@@ -0,0 +1,17 @@
+import sys
+import os
+import unittest
+from pygame.tests import font_test
+
+import pygame.ftfont
+
+font_test.pygame_font = pygame.ftfont
+
+for name in dir(font_test):
+    obj = getattr(font_test, name)
+    if isinstance(obj, type) and issubclass(obj, unittest.TestCase):  # conditional and
+        new_name = f"Ft{name}"
+        globals()[new_name] = type(new_name, (obj,), {})
+
+if __name__ == "__main__":
+    unittest.main()
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/gfxdraw_test.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/gfxdraw_test.py
new file mode 100644
index 0000000..33ee2c5
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/gfxdraw_test.py
@@ -0,0 +1,876 @@
+import unittest
+import pygame
+import pygame.gfxdraw
+from pygame.locals import *
+from pygame.tests.test_utils import SurfaceSubclass
+
+
+def intensity(c, i):
+    """Return color c changed by intensity i
+
+    For 0 <= i <= 127 the color is a shade, with 0 being black, 127 being the
+    unaltered color.
+
+    For 128 <= i <= 255 the color is a tint, with 255 being white, 128 the
+    unaltered color.
+
+    """
+    r, g, b = c[0:3]
+    if 0 <= i <= 127:
+        # Darken
+        return ((r * i) // 127, (g * i) // 127, (b * i) // 127)
+    # Lighten
+    return (
+        r + ((255 - r) * (255 - i)) // 127,
+        g + ((255 - g) * (255 - i)) // 127,
+        b + ((255 - b) * (255 - i)) // 127,
+    )
+
+
+class GfxdrawDefaultTest(unittest.TestCase):
+    is_started = False
+
+    foreground_color = (128, 64, 8)
+    background_color = (255, 255, 255)
+
+    def make_palette(base_color):
+        """Return color palette that is various intensities of base_color"""
+        # Need this function for Python 3.x so the base_color
+        # is within the scope of the list comprehension.
+        return [intensity(base_color, i) for i in range(0, 256)]
+
+    default_palette = make_palette(foreground_color)
+
+    default_size = (100, 100)
+
+    def check_at(self, surf, posn, color):
+        sc = surf.get_at(posn)
+        fail_msg = "%s != %s at %s, bitsize: %i, flags: %i, masks: %s" % (
+            sc,
+            color,
+            posn,
+            surf.get_bitsize(),
+            surf.get_flags(),
+            surf.get_masks(),
+        )
+        self.assertEqual(sc, color, fail_msg)
+
+    def check_not_at(self, surf, posn, color):
+        sc = surf.get_at(posn)
+        fail_msg = "%s != %s at %s, bitsize: %i, flags: %i, masks: %s" % (
+            sc,
+            color,
+            posn,
+            surf.get_bitsize(),
+            surf.get_flags(),
+            surf.get_masks(),
+        )
+        self.assertNotEqual(sc, color, fail_msg)
+
+    @classmethod
+    def setUpClass(cls):
+        # Necessary for Surface.set_palette.
+        pygame.init()
+        pygame.display.set_mode((1, 1))
+
+    @classmethod
+    def tearDownClass(cls):
+        pygame.quit()
+
+    def setUp(self):
+        # This makes sure pygame is always initialized before each test (in
+        # case a test calls pygame.quit()).
+        if not pygame.get_init():
+            pygame.init()
+
+        Surface = pygame.Surface
+        size = self.default_size
+        palette = self.default_palette
+        if not self.is_started:
+            # Create test surfaces
+            self.surfaces = [
+                Surface(size, 0, 8),
+                Surface(size, SRCALPHA, 16),
+                Surface(size, SRCALPHA, 32),
+            ]
+            self.surfaces[0].set_palette(palette)
+            nonpalette_fmts = (
+                # (8, (0xe0, 0x1c, 0x3, 0x0)),
+                (12, (0xF00, 0xF0, 0xF, 0x0)),
+                (15, (0x7C00, 0x3E0, 0x1F, 0x0)),
+                (15, (0x1F, 0x3E0, 0x7C00, 0x0)),
+                (16, (0xF00, 0xF0, 0xF, 0xF000)),
+                (16, (0xF000, 0xF00, 0xF0, 0xF)),
+                (16, (0xF, 0xF0, 0xF00, 0xF000)),
+                (16, (0xF0, 0xF00, 0xF000, 0xF)),
+                (16, (0x7C00, 0x3E0, 0x1F, 0x8000)),
+                (16, (0xF800, 0x7C0, 0x3E, 0x1)),
+                (16, (0x1F, 0x3E0, 0x7C00, 0x8000)),
+                (16, (0x3E, 0x7C0, 0xF800, 0x1)),
+                (16, (0xF800, 0x7E0, 0x1F, 0x0)),
+                (16, (0x1F, 0x7E0, 0xF800, 0x0)),
+                (24, (0xFF, 0xFF00, 0xFF0000, 0x0)),
+                (24, (0xFF0000, 0xFF00, 0xFF, 0x0)),
+                (32, (0xFF0000, 0xFF00, 0xFF, 0x0)),
+                (32, (0xFF000000, 0xFF0000, 0xFF00, 0x0)),
+                (32, (0xFF, 0xFF00, 0xFF0000, 0x0)),
+                (32, (0xFF00, 0xFF0000, 0xFF000000, 0x0)),
+                (32, (0xFF0000, 0xFF00, 0xFF, 0xFF000000)),
+                (32, (0xFF000000, 0xFF0000, 0xFF00, 0xFF)),
+                (32, (0xFF, 0xFF00, 0xFF0000, 0xFF000000)),
+                (32, (0xFF00, 0xFF0000, 0xFF000000, 0xFF)),
+            )
+            for bitsize, masks in nonpalette_fmts:
+                self.surfaces.append(Surface(size, 0, bitsize, masks))
+        for surf in self.surfaces:
+            surf.fill(self.background_color)
+
+    def test_gfxdraw__subclassed_surface(self):
+        """Ensure pygame.gfxdraw works on subclassed surfaces."""
+        surface = SurfaceSubclass((11, 13), SRCALPHA, 32)
+        surface.fill(pygame.Color("blue"))
+        expected_color = pygame.Color("red")
+        x, y = 1, 2
+
+        pygame.gfxdraw.pixel(surface, x, y, expected_color)
+
+        self.assertEqual(surface.get_at((x, y)), expected_color)
+
+    def test_pixel(self):
+        """pixel(surface, x, y, color): return None"""
+        fg = self.foreground_color
+        bg = self.background_color
+        for surf in self.surfaces:
+            fg_adjusted = surf.unmap_rgb(surf.map_rgb(fg))
+            bg_adjusted = surf.unmap_rgb(surf.map_rgb(bg))
+            pygame.gfxdraw.pixel(surf, 2, 2, fg)
+            for x in range(1, 4):
+                for y in range(1, 4):
+                    if x == 2 and y == 2:
+                        self.check_at(surf, (x, y), fg_adjusted)
+                    else:
+                        self.check_at(surf, (x, y), bg_adjusted)
+
+    def test_hline(self):
+        """hline(surface, x1, x2, y, color): return None"""
+        fg = self.foreground_color
+        bg = self.background_color
+        startx = 10
+        stopx = 80
+        y = 50
+        fg_test_points = [(startx, y), (stopx, y), ((stopx - startx) // 2, y)]
+        bg_test_points = [
+            (startx - 1, y),
+            (stopx + 1, y),
+            (startx, y - 1),
+            (startx, y + 1),
+            (stopx, y - 1),
+            (stopx, y + 1),
+        ]
+        for surf in self.surfaces:
+            fg_adjusted = surf.unmap_rgb(surf.map_rgb(fg))
+            bg_adjusted = surf.unmap_rgb(surf.map_rgb(bg))
+            pygame.gfxdraw.hline(surf, startx, stopx, y, fg)
+            for posn in fg_test_points:
+                self.check_at(surf, posn, fg_adjusted)
+            for posn in bg_test_points:
+                self.check_at(surf, posn, bg_adjusted)
+
+    def test_vline(self):
+        """vline(surface, x, y1, y2, color): return None"""
+        fg = self.foreground_color
+        bg = self.background_color
+        x = 50
+        starty = 10
+        stopy = 80
+        fg_test_points = [(x, starty), (x, stopy), (x, (stopy - starty) // 2)]
+        bg_test_points = [
+            (x, starty - 1),
+            (x, stopy + 1),
+            (x - 1, starty),
+            (x + 1, starty),
+            (x - 1, stopy),
+            (x + 1, stopy),
+        ]
+        for surf in self.surfaces:
+            fg_adjusted = surf.unmap_rgb(surf.map_rgb(fg))
+            bg_adjusted = surf.unmap_rgb(surf.map_rgb(bg))
+            pygame.gfxdraw.vline(surf, x, starty, stopy, fg)
+            for posn in fg_test_points:
+                self.check_at(surf, posn, fg_adjusted)
+            for posn in bg_test_points:
+                self.check_at(surf, posn, bg_adjusted)
+
+    def test_rectangle(self):
+        """rectangle(surface, rect, color): return None"""
+        fg = self.foreground_color
+        bg = self.background_color
+        rect = pygame.Rect(10, 15, 55, 62)
+        rect_tuple = tuple(rect)
+        fg_test_points = [
+            rect.topleft,
+            (rect.right - 1, rect.top),
+            (rect.left, rect.bottom - 1),
+            (rect.right - 1, rect.bottom - 1),
+        ]
+        bg_test_points = [
+            (rect.left - 1, rect.top - 1),
+            (rect.left + 1, rect.top + 1),
+            (rect.right, rect.top - 1),
+            (rect.right - 2, rect.top + 1),
+            (rect.left - 1, rect.bottom),
+            (rect.left + 1, rect.bottom - 2),
+            (rect.right, rect.bottom),
+            (rect.right - 2, rect.bottom - 2),
+        ]
+        for surf in self.surfaces:
+            fg_adjusted = surf.unmap_rgb(surf.map_rgb(fg))
+            bg_adjusted = surf.unmap_rgb(surf.map_rgb(bg))
+            pygame.gfxdraw.rectangle(surf, rect, fg)
+            for posn in fg_test_points:
+                self.check_at(surf, posn, fg_adjusted)
+            for posn in bg_test_points:
+                self.check_at(surf, posn, bg_adjusted)
+            surf.fill(bg)
+            pygame.gfxdraw.rectangle(surf, rect_tuple, fg)
+            for posn in fg_test_points:
+                self.check_at(surf, posn, fg_adjusted)
+            for posn in bg_test_points:
+                self.check_at(surf, posn, bg_adjusted)
+
+    def test_box(self):
+        """box(surface, rect, color): return None"""
+        fg = self.foreground_color
+        bg = self.background_color
+        rect = pygame.Rect(10, 15, 55, 62)
+        rect_tuple = tuple(rect)
+        fg_test_points = [
+            rect.topleft,
+            (rect.left + 1, rect.top + 1),
+            (rect.right - 1, rect.top),
+            (rect.right - 2, rect.top + 1),
+            (rect.left, rect.bottom - 1),
+            (rect.left + 1, rect.bottom - 2),
+            (rect.right - 1, rect.bottom - 1),
+            (rect.right - 2, rect.bottom - 2),
+        ]
+        bg_test_points = [
+            (rect.left - 1, rect.top - 1),
+            (rect.right, rect.top - 1),
+            (rect.left - 1, rect.bottom),
+            (rect.right, rect.bottom),
+        ]
+        for surf in self.surfaces:
+            fg_adjusted = surf.unmap_rgb(surf.map_rgb(fg))
+            bg_adjusted = surf.unmap_rgb(surf.map_rgb(bg))
+            pygame.gfxdraw.box(surf, rect, fg)
+            for posn in fg_test_points:
+                self.check_at(surf, posn, fg_adjusted)
+            for posn in bg_test_points:
+                self.check_at(surf, posn, bg_adjusted)
+            surf.fill(bg)
+            pygame.gfxdraw.box(surf, rect_tuple, fg)
+            for posn in fg_test_points:
+                self.check_at(surf, posn, fg_adjusted)
+            for posn in bg_test_points:
+                self.check_at(surf, posn, bg_adjusted)
+
+    def test_line(self):
+        """line(surface, x1, y1, x2, y2, color): return None"""
+        fg = self.foreground_color
+        bg = self.background_color
+        x1 = 10
+        y1 = 15
+        x2 = 92
+        y2 = 77
+        fg_test_points = [(x1, y1), (x2, y2)]
+        bg_test_points = [
+            (x1 - 1, y1),
+            (x1, y1 - 1),
+            (x1 - 1, y1 - 1),
+            (x2 + 1, y2),
+            (x2, y2 + 1),
+            (x2 + 1, y2 + 1),
+        ]
+        for surf in self.surfaces:
+            fg_adjusted = surf.unmap_rgb(surf.map_rgb(fg))
+            bg_adjusted = surf.unmap_rgb(surf.map_rgb(bg))
+            pygame.gfxdraw.line(surf, x1, y1, x2, y2, fg)
+            for posn in fg_test_points:
+                self.check_at(surf, posn, fg_adjusted)
+            for posn in bg_test_points:
+                self.check_at(surf, posn, bg_adjusted)
+
+    def test_circle(self):
+        """circle(surface, x, y, r, color): return None"""
+        fg = self.foreground_color
+        bg = self.background_color
+        x = 45
+        y = 40
+        r = 30
+        fg_test_points = [(x, y - r), (x, y + r), (x - r, y), (x + r, y)]
+        bg_test_points = [
+            (x, y),
+            (x, y - r + 1),
+            (x, y - r - 1),
+            (x, y + r + 1),
+            (x, y + r - 1),
+            (x - r - 1, y),
+            (x - r + 1, y),
+            (x + r + 1, y),
+            (x + r - 1, y),
+        ]
+        for surf in self.surfaces:
+            fg_adjusted = surf.unmap_rgb(surf.map_rgb(fg))
+            bg_adjusted = surf.unmap_rgb(surf.map_rgb(bg))
+            pygame.gfxdraw.circle(surf, x, y, r, fg)
+            for posn in fg_test_points:
+                self.check_at(surf, posn, fg_adjusted)
+            for posn in bg_test_points:
+                self.check_at(surf, posn, bg_adjusted)
+
+    def test_arc(self):
+        """arc(surface, x, y, r, start, end, color): return None"""
+        fg = self.foreground_color
+        bg = self.background_color
+        x = 45
+        y = 40
+        r = 30
+        start = 0  # +x direction, but not (x + r, y) (?)
+        end = 90  # -y direction, including (x, y + r)
+        fg_test_points = [(x, y + r), (x + r, y + 1)]
+        bg_test_points = [
+            (x, y),
+            (x, y - r),
+            (x - r, y),
+            (x, y + r + 1),
+            (x, y + r - 1),
+            (x - 1, y + r),
+            (x + r + 1, y),
+            (x + r - 1, y),
+            (x + r, y),
+        ]
+        for surf in self.surfaces:
+            fg_adjusted = surf.unmap_rgb(surf.map_rgb(fg))
+            bg_adjusted = surf.unmap_rgb(surf.map_rgb(bg))
+            pygame.gfxdraw.arc(surf, x, y, r, start, end, fg)
+            for posn in fg_test_points:
+                self.check_at(surf, posn, fg_adjusted)
+            for posn in bg_test_points:
+                self.check_at(surf, posn, bg_adjusted)
+
+    def test_aacircle(self):
+        """aacircle(surface, x, y, r, color): return None"""
+        fg = self.foreground_color
+        bg = self.background_color
+        x = 45
+        y = 40
+        r = 30
+        fg_test_points = [(x, y - r), (x, y + r), (x - r, y), (x + r, y)]
+        bg_test_points = [
+            (x, y),
+            (x, y - r + 1),
+            (x, y - r - 1),
+            (x, y + r + 1),
+            (x, y + r - 1),
+            (x - r - 1, y),
+            (x - r + 1, y),
+            (x + r + 1, y),
+            (x + r - 1, y),
+        ]
+        for surf in self.surfaces:
+            fg_adjusted = surf.unmap_rgb(surf.map_rgb(fg))
+            bg_adjusted = surf.unmap_rgb(surf.map_rgb(bg))
+            pygame.gfxdraw.aacircle(surf, x, y, r, fg)
+            for posn in fg_test_points:
+                self.check_not_at(surf, posn, bg_adjusted)
+            for posn in bg_test_points:
+                self.check_at(surf, posn, bg_adjusted)
+
+    def test_filled_circle(self):
+        """filled_circle(surface, x, y, r, color): return None"""
+        fg = self.foreground_color
+        bg = self.background_color
+        x = 45
+        y = 40
+        r = 30
+        fg_test_points = [
+            (x, y - r),
+            (x, y - r + 1),
+            (x, y + r),
+            (x, y + r - 1),
+            (x - r, y),
+            (x - r + 1, y),
+            (x + r, y),
+            (x + r - 1, y),
+            (x, y),
+        ]
+        bg_test_points = [
+            (x, y - r - 1),
+            (x, y + r + 1),
+            (x - r - 1, y),
+            (x + r + 1, y),
+        ]
+        for surf in self.surfaces:
+            fg_adjusted = surf.unmap_rgb(surf.map_rgb(fg))
+            bg_adjusted = surf.unmap_rgb(surf.map_rgb(bg))
+            pygame.gfxdraw.filled_circle(surf, x, y, r, fg)
+            for posn in fg_test_points:
+                self.check_at(surf, posn, fg_adjusted)
+            for posn in bg_test_points:
+                self.check_at(surf, posn, bg_adjusted)
+
+    def test_ellipse(self):
+        """ellipse(surface, x, y, rx, ry, color): return None"""
+        fg = self.foreground_color
+        bg = self.background_color
+        x = 45
+        y = 40
+        rx = 30
+        ry = 35
+        fg_test_points = [(x, y - ry), (x, y + ry), (x - rx, y), (x + rx, y)]
+        bg_test_points = [
+            (x, y),
+            (x, y - ry + 1),
+            (x, y - ry - 1),
+            (x, y + ry + 1),
+            (x, y + ry - 1),
+            (x - rx - 1, y),
+            (x - rx + 1, y),
+            (x + rx + 1, y),
+            (x + rx - 1, y),
+        ]
+        for surf in self.surfaces:
+            fg_adjusted = surf.unmap_rgb(surf.map_rgb(fg))
+            bg_adjusted = surf.unmap_rgb(surf.map_rgb(bg))
+            pygame.gfxdraw.ellipse(surf, x, y, rx, ry, fg)
+            for posn in fg_test_points:
+                self.check_at(surf, posn, fg_adjusted)
+            for posn in bg_test_points:
+                self.check_at(surf, posn, bg_adjusted)
+
+    def test_aaellipse(self):
+        """aaellipse(surface, x, y, rx, ry, color): return None"""
+        fg = self.foreground_color
+        bg = self.background_color
+        x = 45
+        y = 40
+        rx = 30
+        ry = 35
+        fg_test_points = [(x, y - ry), (x, y + ry), (x - rx, y), (x + rx, y)]
+        bg_test_points = [
+            (x, y),
+            (x, y - ry + 1),
+            (x, y - ry - 1),
+            (x, y + ry + 1),
+            (x, y + ry - 1),
+            (x - rx - 1, y),
+            (x - rx + 1, y),
+            (x + rx + 1, y),
+            (x + rx - 1, y),
+        ]
+        for surf in self.surfaces:
+            fg_adjusted = surf.unmap_rgb(surf.map_rgb(fg))
+            bg_adjusted = surf.unmap_rgb(surf.map_rgb(bg))
+            pygame.gfxdraw.aaellipse(surf, x, y, rx, ry, fg)
+            for posn in fg_test_points:
+                self.check_not_at(surf, posn, bg_adjusted)
+            for posn in bg_test_points:
+                self.check_at(surf, posn, bg_adjusted)
+
+    def test_filled_ellipse(self):
+        """filled_ellipse(surface, x, y, rx, ry, color): return None"""
+        fg = self.foreground_color
+        bg = self.background_color
+        x = 45
+        y = 40
+        rx = 30
+        ry = 35
+        fg_test_points = [
+            (x, y - ry),
+            (x, y - ry + 1),
+            (x, y + ry),
+            (x, y + ry - 1),
+            (x - rx, y),
+            (x - rx + 1, y),
+            (x + rx, y),
+            (x + rx - 1, y),
+            (x, y),
+        ]
+        bg_test_points = [
+            (x, y - ry - 1),
+            (x, y + ry + 1),
+            (x - rx - 1, y),
+            (x + rx + 1, y),
+        ]
+        for surf in self.surfaces:
+            fg_adjusted = surf.unmap_rgb(surf.map_rgb(fg))
+            bg_adjusted = surf.unmap_rgb(surf.map_rgb(bg))
+            pygame.gfxdraw.filled_ellipse(surf, x, y, rx, ry, fg)
+            for posn in fg_test_points:
+                self.check_at(surf, posn, fg_adjusted)
+            for posn in bg_test_points:
+                self.check_at(surf, posn, bg_adjusted)
+
+    def test_pie(self):
+        """pie(surface, x, y, r, start, end, color): return None"""
+        fg = self.foreground_color
+        bg = self.background_color
+        x = 45
+        y = 40
+        r = 30
+        start = 0  # +x direction, including (x + r, y)
+        end = 90  # -y direction, but not (x, y + r) (?)
+        fg_test_points = [(x, y), (x + 1, y), (x, y + 1), (x + r, y)]
+        bg_test_points = [
+            (x - 1, y),
+            (x, y - 1),
+            (x - 1, y - 1),
+            (x + 1, y + 1),
+            (x + r + 1, y),
+            (x + r, y - 1),
+            (x, y + r + 1),
+        ]
+        for surf in self.surfaces:
+            fg_adjusted = surf.unmap_rgb(surf.map_rgb(fg))
+            bg_adjusted = surf.unmap_rgb(surf.map_rgb(bg))
+            pygame.gfxdraw.pie(surf, x, y, r, start, end, fg)
+            for posn in fg_test_points:
+                self.check_at(surf, posn, fg_adjusted)
+            for posn in bg_test_points:
+                self.check_at(surf, posn, bg_adjusted)
+
+    def test_trigon(self):
+        """trigon(surface, x1, y1, x2, y2, x3, y3, color): return None"""
+        fg = self.foreground_color
+        bg = self.background_color
+        x1 = 10
+        y1 = 15
+        x2 = 92
+        y2 = 77
+        x3 = 20
+        y3 = 60
+        fg_test_points = [(x1, y1), (x2, y2), (x3, y3)]
+        bg_test_points = [
+            (x1 - 1, y1 - 1),
+            (x2 + 1, y2 + 1),
+            (x3 - 1, y3 + 1),
+            (x1 + 10, y1 + 30),
+        ]
+        for surf in self.surfaces:
+            fg_adjusted = surf.unmap_rgb(surf.map_rgb(fg))
+            bg_adjusted = surf.unmap_rgb(surf.map_rgb(bg))
+            pygame.gfxdraw.trigon(surf, x1, y1, x2, y2, x3, y3, fg)
+            for posn in fg_test_points:
+                self.check_at(surf, posn, fg_adjusted)
+            for posn in bg_test_points:
+                self.check_at(surf, posn, bg_adjusted)
+
+    def test_aatrigon(self):
+        """aatrigon(surface, x1, y1, x2, y2, x3, y3, color): return None"""
+        fg = self.foreground_color
+        bg = self.background_color
+        x1 = 10
+        y1 = 15
+        x2 = 92
+        y2 = 77
+        x3 = 20
+        y3 = 60
+        fg_test_points = [(x1, y1), (x2, y2), (x3, y3)]
+        bg_test_points = [
+            (x1 - 1, y1 - 1),
+            (x2 + 1, y2 + 1),
+            (x3 - 1, y3 + 1),
+            (x1 + 10, y1 + 30),
+        ]
+        for surf in self.surfaces:
+            fg_adjusted = surf.unmap_rgb(surf.map_rgb(fg))
+            bg_adjusted = surf.unmap_rgb(surf.map_rgb(bg))
+            pygame.gfxdraw.aatrigon(surf, x1, y1, x2, y2, x3, y3, fg)
+            for posn in fg_test_points:
+                self.check_not_at(surf, posn, bg_adjusted)
+            for posn in bg_test_points:
+                self.check_at(surf, posn, bg_adjusted)
+
+    def test_aatrigon__with_horizontal_edge(self):
+        """Ensure aatrigon draws horizontal edges correctly.
+
+        This test creates 2 surfaces and draws an aatrigon on each. The pixels
+        on each surface are compared to ensure they are the same. The only
+        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 issue #622.
+        """
+        bg_color = pygame.Color("white")
+        line_color = pygame.Color("black")
+        width, height = 11, 10
+        expected_surface = pygame.Surface((width, height), 0, 32)
+        expected_surface.fill(bg_color)
+        surface = pygame.Surface((width, height), 0, 32)
+        surface.fill(bg_color)
+
+        x1, y1 = width - 1, 0
+        x2, y2 = (width - 1) // 2, height - 1
+        x3, y3 = 0, 0
+
+        # The points in this order draw as expected.
+        pygame.gfxdraw.aatrigon(expected_surface, x1, y1, x2, y2, x3, y3, line_color)
+
+        # The points in reverse order fail to draw the horizontal edge along
+        # the top.
+        pygame.gfxdraw.aatrigon(surface, x3, y3, x2, y2, x1, y1, line_color)
+
+        # The surfaces are locked for a possible speed up of pixel access.
+        expected_surface.lock()
+        surface.lock()
+        for x in range(width):
+            for y in range(height):
+                self.assertEqual(
+                    expected_surface.get_at((x, y)),
+                    surface.get_at((x, y)),
+                    f"pos=({x}, {y})",
+                )
+
+        surface.unlock()
+        expected_surface.unlock()
+
+    def test_filled_trigon(self):
+        """filled_trigon(surface, x1, y1, x2, y2, x3, y3, color): return None"""
+        fg = self.foreground_color
+        bg = self.background_color
+        x1 = 10
+        y1 = 15
+        x2 = 92
+        y2 = 77
+        x3 = 20
+        y3 = 60
+        fg_test_points = [(x1, y1), (x2, y2), (x3, y3), (x1 + 10, y1 + 30)]
+        bg_test_points = [(x1 - 1, y1 - 1), (x2 + 1, y2 + 1), (x3 - 1, y3 + 1)]
+        for surf in self.surfaces:
+            fg_adjusted = surf.unmap_rgb(surf.map_rgb(fg))
+            bg_adjusted = surf.unmap_rgb(surf.map_rgb(bg))
+            pygame.gfxdraw.filled_trigon(surf, x1, y1, x2, y2, x3, y3, fg)
+            for posn in fg_test_points:
+                self.check_at(surf, posn, fg_adjusted)
+            for posn in bg_test_points:
+                self.check_at(surf, posn, bg_adjusted)
+
+    def test_polygon(self):
+        """polygon(surface, points, color): return None"""
+        fg = self.foreground_color
+        bg = self.background_color
+        points = [(10, 80), (10, 15), (92, 25), (92, 80)]
+        fg_test_points = points + [
+            (points[0][0], points[0][1] - 1),
+            (points[0][0] + 1, points[0][1]),
+            (points[3][0] - 1, points[3][1]),
+            (points[3][0], points[3][1] - 1),
+            (points[2][0], points[2][1] + 1),
+        ]
+        bg_test_points = [
+            (points[0][0] - 1, points[0][1]),
+            (points[0][0], points[0][1] + 1),
+            (points[0][0] - 1, points[0][1] + 1),
+            (points[0][0] + 1, points[0][1] - 1),
+            (points[3][0] + 1, points[3][1]),
+            (points[3][0], points[3][1] + 1),
+            (points[3][0] + 1, points[3][1] + 1),
+            (points[3][0] - 1, points[3][1] - 1),
+            (points[2][0] + 1, points[2][1]),
+            (points[2][0] - 1, points[2][1] + 1),
+            (points[1][0] - 1, points[1][1]),
+            (points[1][0], points[1][1] - 1),
+            (points[1][0] - 1, points[1][1] - 1),
+        ]
+        for surf in self.surfaces:
+            fg_adjusted = surf.unmap_rgb(surf.map_rgb(fg))
+            bg_adjusted = surf.unmap_rgb(surf.map_rgb(bg))
+            pygame.gfxdraw.polygon(surf, points, fg)
+            for posn in fg_test_points:
+                self.check_at(surf, posn, fg_adjusted)
+            for posn in bg_test_points:
+                self.check_at(surf, posn, bg_adjusted)
+
+    def test_aapolygon(self):
+        """aapolygon(surface, points, color): return None"""
+        fg = self.foreground_color
+        bg = self.background_color
+        points = [(10, 80), (10, 15), (92, 25), (92, 80)]
+        fg_test_points = points
+        bg_test_points = [
+            (points[0][0] - 1, points[0][1]),
+            (points[0][0], points[0][1] + 1),
+            (points[0][0] - 1, points[0][1] + 1),
+            (points[0][0] + 1, points[0][1] - 1),
+            (points[3][0] + 1, points[3][1]),
+            (points[3][0], points[3][1] + 1),
+            (points[3][0] + 1, points[3][1] + 1),
+            (points[3][0] - 1, points[3][1] - 1),
+            (points[2][0] + 1, points[2][1]),
+            (points[2][0] - 1, points[2][1] + 1),
+            (points[1][0] - 1, points[1][1]),
+            (points[1][0], points[1][1] - 1),
+            (points[1][0] - 1, points[1][1] - 1),
+        ]
+        for surf in self.surfaces:
+            fg_adjusted = surf.unmap_rgb(surf.map_rgb(fg))
+            bg_adjusted = surf.unmap_rgb(surf.map_rgb(bg))
+            pygame.gfxdraw.aapolygon(surf, points, fg)
+            for posn in fg_test_points:
+                self.check_at(surf, posn, fg_adjusted)
+            for posn in bg_test_points:
+                self.check_not_at(surf, posn, fg_adjusted)
+            for posn in bg_test_points:
+                self.check_at(surf, posn, bg_adjusted)
+
+    def test_aapolygon__with_horizontal_edge(self):
+        """Ensure aapolygon draws horizontal edges correctly.
+
+        This test creates 2 surfaces and draws a polygon on each. The pixels
+        on each surface are compared to ensure they are the same. The only
+        difference between the 2 polygons is that one is drawn using
+        aapolygon() and the other using multiple line() calls. They should
+        produce the same final drawing.
+
+        Related to issue #622.
+        """
+        bg_color = pygame.Color("white")
+        line_color = pygame.Color("black")
+        width, height = 11, 10
+        expected_surface = pygame.Surface((width, height), 0, 32)
+        expected_surface.fill(bg_color)
+        surface = pygame.Surface((width, height), 0, 32)
+        surface.fill(bg_color)
+
+        points = ((0, 0), (0, height - 1), (width - 1, height - 1), (width - 1, 0))
+
+        # The points are used to draw the expected aapolygon using the line()
+        # function.
+        for (x1, y1), (x2, y2) in zip(points, points[1:] + points[:1]):
+            pygame.gfxdraw.line(expected_surface, x1, y1, x2, y2, line_color)
+
+        # The points in this order fail to draw the horizontal edge along
+        # the top.
+        pygame.gfxdraw.aapolygon(surface, points, line_color)
+
+        # The surfaces are locked for a possible speed up of pixel access.
+        expected_surface.lock()
+        surface.lock()
+        for x in range(width):
+            for y in range(height):
+                self.assertEqual(
+                    expected_surface.get_at((x, y)),
+                    surface.get_at((x, y)),
+                    f"pos=({x}, {y})",
+                )
+
+        surface.unlock()
+        expected_surface.unlock()
+
+    def test_filled_polygon(self):
+        """filled_polygon(surface, points, color): return None"""
+        fg = self.foreground_color
+        bg = self.background_color
+        points = [(10, 80), (10, 15), (92, 25), (92, 80)]
+        fg_test_points = points + [
+            (points[0][0], points[0][1] - 1),
+            (points[0][0] + 1, points[0][1]),
+            (points[0][0] + 1, points[0][1] - 1),
+            (points[3][0] - 1, points[3][1]),
+            (points[3][0], points[3][1] - 1),
+            (points[3][0] - 1, points[3][1] - 1),
+            (points[2][0], points[2][1] + 1),
+            (points[2][0] - 1, points[2][1] + 1),
+        ]
+        bg_test_points = [
+            (points[0][0] - 1, points[0][1]),
+            (points[0][0], points[0][1] + 1),
+            (points[0][0] - 1, points[0][1] + 1),
+            (points[3][0] + 1, points[3][1]),
+            (points[3][0], points[3][1] + 1),
+            (points[3][0] + 1, points[3][1] + 1),
+            (points[2][0] + 1, points[2][1]),
+            (points[1][0] - 1, points[1][1]),
+            (points[1][0], points[1][1] - 1),
+            (points[1][0] - 1, points[1][1] - 1),
+        ]
+        for surf in self.surfaces:
+            fg_adjusted = surf.unmap_rgb(surf.map_rgb(fg))
+            bg_adjusted = surf.unmap_rgb(surf.map_rgb(bg))
+            pygame.gfxdraw.filled_polygon(surf, points, fg)
+            for posn in fg_test_points:
+                self.check_at(surf, posn, fg_adjusted)
+            for posn in bg_test_points:
+                self.check_at(surf, posn, bg_adjusted)
+
+    def test_textured_polygon(self):
+        """textured_polygon(surface, points, texture, tx, ty): return None"""
+        w, h = self.default_size
+        fg = self.foreground_color
+        bg = self.background_color
+        tx = 0
+        ty = 0
+        texture = pygame.Surface((w + tx, h + ty), 0, 24)
+        texture.fill(fg, (0, 0, w, h))
+        points = [(10, 80), (10, 15), (92, 25), (92, 80)]
+        # Don't know how to really check this as boarder points may
+        # or may not be included in the textured polygon.
+        fg_test_points = [(points[1][0] + 30, points[1][1] + 40)]
+        bg_test_points = [
+            (points[0][0] - 1, points[0][1]),
+            (points[0][0], points[0][1] + 1),
+            (points[0][0] - 1, points[0][1] + 1),
+            (points[3][0] + 1, points[3][1]),
+            (points[3][0], points[3][1] + 1),
+            (points[3][0] + 1, points[3][1] + 1),
+            (points[2][0] + 1, points[2][1]),
+            (points[1][0] - 1, points[1][1]),
+            (points[1][0], points[1][1] - 1),
+            (points[1][0] - 1, points[1][1] - 1),
+        ]
+        for surf in self.surfaces[1:]:
+            fg_adjusted = surf.unmap_rgb(surf.map_rgb(fg))
+            bg_adjusted = surf.unmap_rgb(surf.map_rgb(bg))
+            pygame.gfxdraw.textured_polygon(surf, points, texture, -tx, -ty)
+            for posn in fg_test_points:
+                self.check_at(surf, posn, fg_adjusted)
+            for posn in bg_test_points:
+                self.check_at(surf, posn, bg_adjusted)
+
+        # Alpha blit to 8 bits-per-pixel surface forbidden.
+        texture = pygame.Surface(self.default_size, SRCALPHA, 32)
+        self.assertRaises(
+            ValueError,
+            pygame.gfxdraw.textured_polygon,
+            self.surfaces[0],
+            points,
+            texture,
+            0,
+            0,
+        )
+
+    def test_bezier(self):
+        """bezier(surface, points, steps, color): return None"""
+        fg = self.foreground_color
+        bg = self.background_color
+        points = [(10, 50), (25, 15), (60, 80), (92, 30)]
+        fg_test_points = [points[0], points[3]]
+        bg_test_points = [
+            (points[0][0] - 1, points[0][1]),
+            (points[3][0] + 1, points[3][1]),
+            (points[1][0], points[1][1] + 3),
+            (points[2][0], points[2][1] - 3),
+        ]
+        for surf in self.surfaces:
+            fg_adjusted = surf.unmap_rgb(surf.map_rgb(fg))
+            bg_adjusted = surf.unmap_rgb(surf.map_rgb(bg))
+            pygame.gfxdraw.bezier(surf, points, 30, fg)
+            for posn in fg_test_points:
+                self.check_at(surf, posn, fg_adjusted)
+            for posn in bg_test_points:
+                self.check_at(surf, posn, bg_adjusted)
+
+
+if __name__ == "__main__":
+    unittest.main()
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/image__save_gl_surface_test.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/image__save_gl_surface_test.py
new file mode 100644
index 0000000..2932f42
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/image__save_gl_surface_test.py
@@ -0,0 +1,46 @@
+import os
+import unittest
+
+from pygame.tests import test_utils
+import pygame
+from pygame.locals import *
+
+
+@unittest.skipIf(
+    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):
+        """
+        |tags:display,slow,opengl|
+        """
+
+        pygame.display.init()
+        screen = pygame.display.set_mode((640, 480), OPENGL | DOUBLEBUF)
+        pygame.display.flip()
+
+        tmp_dir = test_utils.get_tmp_dir()
+        # Try the imageext module.
+        tmp_file = os.path.join(tmp_dir, "opengl_save_surface_test.png")
+        pygame.image.save(screen, tmp_file)
+
+        self.assertTrue(os.path.exists(tmp_file))
+
+        os.remove(tmp_file)
+
+        # Only test the image module.
+        tmp_file = os.path.join(tmp_dir, "opengl_save_surface_test.bmp")
+        pygame.image.save(screen, tmp_file)
+
+        self.assertTrue(os.path.exists(tmp_file))
+
+        os.remove(tmp_file)
+
+        # stops tonnes of tmp dirs building up in trunk dir
+        os.rmdir(tmp_dir)
+        pygame.display.quit()
+
+
+if __name__ == "__main__":
+    unittest.main()
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/image_tags.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/image_tags.py
new file mode 100644
index 0000000..d847903
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/image_tags.py
@@ -0,0 +1,7 @@
+__tags__ = []
+
+import pygame
+import sys
+
+if "pygame.image" not in sys.modules:
+    __tags__.extend(("ignore", "subprocess_ignore"))
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/image_test.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/image_test.py
new file mode 100644
index 0000000..77dff79
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/image_test.py
@@ -0,0 +1,1282 @@
+import array
+import binascii
+import io
+import os
+import tempfile
+import unittest
+import glob
+import pathlib
+
+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()
+if _sdl_image_ver is not None:
+    sdl_image_svg_jpeg_save_bug = (
+        _sdl_image_ver <= (2, 0, 5) and pygame.get_sdl_byteorder() == pygame.BIG_ENDIAN
+    )
+
+
+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):
+        return 0
+    for i, magic_hex in enumerate(magic_hexes):
+        if magic_hex != data[i]:
+            return 0
+    return 1
+
+
+class ImageModuleTest(unittest.TestCase):
+    def testLoadIcon(self):
+        """see if we can load the pygame icon."""
+        f = pygame.pkgdata.getResource("pygame_icon.bmp")
+        self.assertEqual(f.mode, "rb")
+
+        surf = pygame.image.load_basic(f)
+
+        self.assertEqual(surf.get_at((0, 0)), (5, 4, 5, 255))
+        self.assertEqual(surf.get_height(), 32)
+        self.assertEqual(surf.get_width(), 32)
+
+    def testLoadPNG(self):
+        """see if we can load a png with color values in the proper channels."""
+        # Create a PNG file with known colors
+        reddish_pixel = (210, 0, 0, 255)
+        greenish_pixel = (0, 220, 0, 255)
+        bluish_pixel = (0, 0, 230, 255)
+        greyish_pixel = (110, 120, 130, 140)
+        pixel_array = [reddish_pixel + greenish_pixel, bluish_pixel + greyish_pixel]
+
+        f_descriptor, f_path = tempfile.mkstemp(suffix=".png")
+
+        with os.fdopen(f_descriptor, "wb") as f:
+            w = png.Writer(2, 2, alpha=True)
+            w.write(f, pixel_array)
+
+        # Read the PNG file and verify that pygame interprets it correctly
+        surf = pygame.image.load(f_path)
+
+        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)), greyish_pixel)
+
+        # Read the PNG file obj. and verify that pygame interprets it correctly
+        with open(f_path, "rb") as f:
+            surf = pygame.image.load(f)
+
+        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)), greyish_pixel)
+
+        os.remove(f_path)
+
+    def testLoadJPG(self):
+        """to see if we can load a jpg."""
+        f = example_path("data/alien1.jpg")
+        surf = pygame.image.load(f)
+
+        with open(f, "rb") as f:
+            surf = pygame.image.load(f)
+
+    def testLoadBytesIO(self):
+        """to see if we can load images with BytesIO."""
+        files = [
+            "data/alien1.png",
+            "data/alien1.jpg",
+            "data/alien1.gif",
+            "data/asprite.bmp",
+        ]
+
+        for fname in files:
+            with self.subTest(fname=fname):
+                with open(example_path(fname), "rb") as f:
+                    img_bytes = f.read()
+                    img_file = io.BytesIO(img_bytes)
+                    image = pygame.image.load(img_file)
+
+    @unittest.skipIf(
+        sdl_image_svg_jpeg_save_bug,
+        "SDL_image 2.0.5 and older has a big endian bug in jpeg saving",
+    )
+    def testSaveJPG(self):
+        """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
+        """
+
+        from pygame import Color, Rect
+
+        # The source image is a 2 by 2 square of four colors. Since JPEG is
+        # lossy, there can be color bleed. Make each color square 16 by 16,
+        # to avoid the significantly color value distorts found at color
+        # boundaries due to the compression value set by Pygame.
+        square_len = 16
+        sz = 2 * square_len, 2 * square_len
+
+        #  +---------------------------------+
+        #  | red            | green          |
+        #  |----------------+----------------|
+        #  | blue           | (255, 128, 64) |
+        #  +---------------------------------+
+        #
+        #  as (rect, color) pairs.
+        def as_rect(square_x, square_y):
+            return Rect(
+                square_x * square_len, square_y * square_len, square_len, square_len
+            )
+
+        squares = [
+            (as_rect(0, 0), Color("red")),
+            (as_rect(1, 0), Color("green")),
+            (as_rect(0, 1), Color("blue")),
+            (as_rect(1, 1), Color(255, 128, 64)),
+        ]
+
+        # A surface format which is not directly usable with libjpeg.
+        surf = pygame.Surface(sz, 0, 32)
+        for rect, color in squares:
+            surf.fill(color, rect)
+
+        # Assume pygame.image.Load works correctly as it is handled by the
+        # third party SDL_image library.
+
+        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):
+            mask = 0xFC
+            return pygame.Color(c.r & mask, c.g & mask, c.b & mask)
+
+        offset = square_len // 2
+        for rect, color in squares:
+            posn = rect.move((offset, offset)).topleft
+            self.assertEqual(approx(jpg_surf.get_at(posn)), approx(color))
+
+        os.remove(temp_filename)
+
+    def testSavePNG32(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, 255)
+        greenish_pixel = (0, 225, 0, 255)
+        bluish_pixel = (0, 0, 235, 255)
+        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), greyish_pixel)
+
+        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=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)), greyish_pixel)
+
+        finally:
+            # Ensures proper clean up.
+            if not reader.file.closed:
+                reader.file.close()
+            del reader
+            os.remove(temp_filename)
+
+    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)
+        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), greyish_pixel)
+
+        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=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)), greyish_pixel)
+
+        finally:
+            # Ensures proper clean up.
+            if not reader.file.closed:
+                reader.file.close()
+            del reader
+            os.remove(temp_filename)
+
+    def testSavePNG8(self):
+        """see if we can save an 8 bit png correctly"""
+        # Create an 8-bit PNG file with known colors
+        set_pixels = [(255, 0, 0), (0, 255, 0), (0, 0, 255), (170, 146, 170)]
+
+        size = (1, len(set_pixels))
+        surf = pygame.Surface(size, depth=8)
+        for cnt, pix in enumerate(set_pixels):
+            surf.set_at((0, cnt), pix)
+
+        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=temp_filename)
+            width, height, pixels, _ = reader.asRGB8()
+
+            self.assertEqual(size, (width, height))
+
+            # pixels is a generator
+            self.assertEqual(list(map(tuple, pixels)), set_pixels)
+
+        finally:
+            # Ensures proper clean up.
+            if not reader.file.closed:
+                reader.file.close()
+            del reader
+            os.remove(temp_filename)
+
+    def testSavePaletteAsPNG8(self):
+        """see if we can save a png with color values in the proper channels."""
+        # Create a PNG file with known colors
+        pygame.display.init()
+
+        reddish_pixel = (215, 0, 0)
+        greenish_pixel = (0, 225, 0)
+        bluish_pixel = (0, 0, 235)
+        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, greyish_pixel)
+
+        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=temp_filename)
+            reader.read()
+            palette = reader.palette()
+
+            # pixels is a generator
+            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)), greyish_pixel)
+
+        finally:
+            # Ensures proper clean up.
+            if not reader.file.closed:
+                reader.file.close()
+            del reader
+            os.remove(temp_filename)
+
+    def test_save(self):
+        s = pygame.Surface((10, 10))
+        s.fill((23, 23, 23))
+        magic_hex = {}
+        magic_hex["jpg"] = [0xFF, 0xD8, 0xFF, 0xE0]
+        magic_hex["png"] = [0x89, 0x50, 0x4E, 0x47]
+        # magic_hex['tga'] = [0x0, 0x0, 0xa]
+        magic_hex["bmp"] = [0x42, 0x4D]
+
+        formats = ["jpg", "png", "bmp"]
+        # uppercase too... JPG
+        formats = formats + [x.upper() for x in formats]
+
+        for fmt in formats:
+            try:
+                temp_filename = f"tmpimg.{fmt}"
+                pygame.image.save(s, temp_filename)
+
+                # Using 'with' ensures the file is closed even if test fails.
+                with open(temp_filename, "rb") as handle:
+                    # Test the magic numbers at the start of the file to ensure
+                    # they are saved as the correct file type.
+                    self.assertEqual(
+                        (1, fmt), (test_magic(handle, magic_hex[fmt.lower()]), fmt)
+                    )
+
+                # load the file to make sure it was saved correctly.
+                #    Note load can load a jpg saved with a .png file name.
+                s2 = pygame.image.load(temp_filename)
+                # compare contents, might only work reliably for png...
+                #   but because it's all one color it seems to work with jpg.
+                self.assertEqual(s2.get_at((0, 0)), s.get_at((0, 0)))
+            finally:
+                # clean up the temp file, comment out to leave tmp file after run.
+                os.remove(temp_filename)
+
+    def test_save_to_fileobject(self):
+        s = pygame.Surface((1, 1))
+        s.fill((23, 23, 23))
+        bytes_stream = io.BytesIO()
+
+        pygame.image.save(s, bytes_stream)
+        bytes_stream.seek(0)
+        s2 = pygame.image.load(bytes_stream, "tga")
+        self.assertEqual(s.get_at((0, 0)), s2.get_at((0, 0)))
+
+    def test_save_tga(self):
+        s = pygame.Surface((1, 1))
+        s.fill((23, 23, 23))
+        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)
+            self.assertEqual(s2.get_at((0, 0)), s.get_at((0, 0)))
+        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))
+        with tempfile.NamedTemporaryFile(suffix=".tga", delete=False) as f:
+            temp_filename = f.name
+
+        path = pathlib.Path(temp_filename)
+        try:
+            pygame.image.save(surf, path)
+            s2 = pygame.image.load(path)
+            self.assertEqual(s2.get_at((0, 0)), surf.get_at((0, 0)))
+        finally:
+            os.remove(temp_filename)
+
+    def test_save__to_fileobject_w_namehint_argument(self):
+        s = pygame.Surface((10, 10))
+        s.fill((23, 23, 23))
+        magic_hex = {}
+        magic_hex["jpg"] = [0xFF, 0xD8, 0xFF, 0xE0]
+        magic_hex["png"] = [0x89, 0x50, 0x4E, 0x47]
+        magic_hex["bmp"] = [0x42, 0x4D]
+
+        formats = ["tga", "jpg", "bmp", "png"]
+        # uppercase too... JPG
+        formats = formats + [x.upper() for x in formats]
+
+        SDL_Im_version = pygame.image.get_sdl_image_version()
+        # We assume here that minor version and patch level of SDL_Image
+        # never goes above 99
+        isAtLeastSDL_image_2_0_2 = (SDL_Im_version is not None) and (
+            SDL_Im_version[0] * 10000 + SDL_Im_version[1] * 100 + SDL_Im_version[2]
+        ) >= 20002
+        for fmt in formats:
+            tmp_file, tmp_filename = tempfile.mkstemp(suffix=f".{fmt}")
+            if not isAtLeastSDL_image_2_0_2 and fmt.lower() == "jpg":
+                with os.fdopen(tmp_file, "wb") as handle:
+                    with self.assertRaises(pygame.error):
+                        pygame.image.save(s, handle, tmp_filename)
+            else:
+                with os.fdopen(tmp_file, "r+b") as handle:
+                    pygame.image.save(s, handle, tmp_filename)
+
+                    if fmt.lower() in magic_hex:
+                        # Test the magic numbers at the start of the file to
+                        # ensure they are saved as the correct file type.
+                        handle.seek(0)
+                        self.assertEqual(
+                            (1, fmt), (test_magic(handle, magic_hex[fmt.lower()]), fmt)
+                        )
+                    # load the file to make sure it was saved correctly.
+                    handle.flush()
+                    handle.seek(0)
+                    s2 = pygame.image.load(handle, tmp_filename)
+                    self.assertEqual(s2.get_at((0, 0)), s.get_at((0, 0)))
+            os.remove(tmp_filename)
+
+    def test_save_colorkey(self):
+        """make sure the color key is not changed when saving."""
+        s = pygame.Surface((10, 10), pygame.SRCALPHA, 32)
+        s.fill((23, 23, 23))
+        s.set_colorkey((0, 0, 0))
+        colorkey1 = s.get_colorkey()
+        p1 = s.get_at((0, 0))
+
+        temp_filename = "tmpimg.png"
+        try:
+            pygame.image.save(s, temp_filename)
+            s2 = pygame.image.load(temp_filename)
+        finally:
+            os.remove(temp_filename)
+
+        colorkey2 = s.get_colorkey()
+        # check that the pixel and the colorkey is correct.
+        self.assertEqual(colorkey1, colorkey2)
+        self.assertEqual(p1, s2.get_at((0, 0)))
+
+    def test_load_unicode_path(self):
+        import shutil
+
+        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))
+
+        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"""
+        self._unicode_save("你好.bmp")
+
+    def assertPremultipliedAreEqual(self, string1, string2, source_string):
+        self.assertEqual(len(string1), len(string2))
+        block_size = 20
+        if string1 != string2:
+            for block_start in range(0, len(string1), block_size):
+                block_end = min(block_start + block_size, len(string1))
+                block1 = string1[block_start:block_end]
+                block2 = string2[block_start:block_end]
+                if block1 != block2:
+                    source_block = source_string[block_start:block_end]
+                    msg = (
+                        "string difference in %d to %d of %d:\n%s\n%s\nsource:\n%s"
+                        % (
+                            block_start,
+                            block_end,
+                            len(string1),
+                            binascii.hexlify(block1),
+                            binascii.hexlify(block2),
+                            binascii.hexlify(source_block),
+                        )
+                    )
+                    self.fail(msg)
+
+    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] * color[3] / 255,
+                        color[1] * color[3] / 255,
+                        color[2] * color[3] / 255,
+                        color[3],
+                    )
+                    surface_to_modify.set_at((x, y), premult_color)
+
+        test_surface = pygame.Surface((256, 256), pygame.SRCALPHA, 32)
+        for x in range(test_surface.get_width()):
+            for y in range(test_surface.get_height()):
+                i = x + y * test_surface.get_width()
+                test_surface.set_at(
+                    (x, y), ((i * 7) % 256, (i * 13) % 256, (i * 27) % 256, y)
+                )
+        premultiplied_copy = test_surface.copy()
+        convertRGBAtoPremultiplied(premultiplied_copy)
+        self.assertPremultipliedAreEqual(
+            pygame.image.tostring(test_surface, "RGBA_PREMULT"),
+            pygame.image.tostring(premultiplied_copy, "RGBA"),
+            pygame.image.tostring(test_surface, "RGBA"),
+        )
+        self.assertPremultipliedAreEqual(
+            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.tostring, no_alpha_surface, "RGBA_PREMULT"
+        )
+
+    # Custom assert method to check for identical surfaces.
+    def _assertSurfaceEqual(self, surf_a, surf_b, msg=None):
+        a_width, a_height = surf_a.get_width(), surf_a.get_height()
+
+        # Check a few things to see if the surfaces are equal.
+        self.assertEqual(a_width, surf_b.get_width(), msg)
+        self.assertEqual(a_height, surf_b.get_height(), msg)
+        self.assertEqual(surf_a.get_size(), surf_b.get_size(), msg)
+        self.assertEqual(surf_a.get_rect(), surf_b.get_rect(), msg)
+        self.assertEqual(surf_a.get_colorkey(), surf_b.get_colorkey(), msg)
+        self.assertEqual(surf_a.get_alpha(), surf_b.get_alpha(), msg)
+        self.assertEqual(surf_a.get_flags(), surf_b.get_flags(), msg)
+        self.assertEqual(surf_a.get_bitsize(), surf_b.get_bitsize(), msg)
+        self.assertEqual(surf_a.get_bytesize(), surf_b.get_bytesize(), msg)
+        # Anything else?
+
+        # Making the method lookups local for a possible speed up.
+        surf_a_get_at = surf_a.get_at
+        surf_b_get_at = surf_b.get_at
+        for y in range(a_height):
+            for x in range(a_width):
+                self.assertEqual(
+                    surf_a_get_at((x, y)),
+                    surf_b_get_at((x, y)),
+                    "%s (pixel: %d, %d)" % (msg, x, y),
+                )
+
+    def test_fromstring__and_tostring(self):
+        """Ensure methods tostring() and fromstring() are symmetric."""
+
+        import itertools
+
+        fmts = ("RGBA", "ARGB", "BGRA")
+        fmt_permutations = itertools.permutations(fmts, 2)
+        fmt_combinations = itertools.combinations(fmts, 2)
+
+        def convert(fmt1, fmt2, str_buf):
+            pos_fmt1 = {k: v for v, k in enumerate(fmt1)}
+            pos_fmt2 = {k: v for v, k in enumerate(fmt2)}
+            byte_buf = array.array("B", str_buf)
+            num_quads = len(byte_buf) // 4
+            for i in range(num_quads):
+                i4 = i * 4
+                R = byte_buf[i4 + pos_fmt1["R"]]
+                G = byte_buf[i4 + pos_fmt1["G"]]
+                B = byte_buf[i4 + pos_fmt1["B"]]
+                A = byte_buf[i4 + pos_fmt1["A"]]
+                byte_buf[i4 + pos_fmt2["R"]] = R
+                byte_buf[i4 + pos_fmt2["G"]] = G
+                byte_buf[i4 + pos_fmt2["B"]] = B
+                byte_buf[i4 + pos_fmt2["A"]] = A
+            return tostring(byte_buf)
+
+        ####################################################################
+        test_surface = pygame.Surface((64, 256), flags=pygame.SRCALPHA, depth=32)
+        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 + 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.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.fromstring(
+                fmt1_convert_buf, test_surface.get_size(), pair[0]
+            )
+
+            self._assertSurfaceEqual(
+                test_surface,
+                test_convert_two_way,
+                f"converting {pair[0]} to {pair[1]} and back is not symmetric",
+            )
+
+        for pair in fmt_permutations:
+            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.fromstring(
+                fmt2_convert_buf, test_surface.get_size(), pair[1]
+            )
+
+            self._assertSurfaceEqual(
+                test_surface,
+                test_convert_one_way,
+                f"converting {pair[0]} to {pair[1]} failed",
+            )
+
+        for fmt in fmts:
+            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_string,
+                "tostring/fromstring functions are not "
+                f"symmetric with '{fmt}' format",
+            )
+
+    def test_tostring_depth_24(self):
+        test_surface = pygame.Surface((64, 256), depth=24)
+        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 + 32, i), (i, i, i, intensity))
+
+        fmt = "RGB"
+        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_string,
+            f'tostring/fromstring functions are not symmetric with "{fmt}" format',
+        )
+
+    def test_frombuffer_8bit(self):
+        """test reading pixel data from a bytes buffer"""
+        pygame.display.init()
+        eight_bit_palette_buffer = bytearray(
+            [0, 0, 0, 0, 1, 1, 1, 1, 2, 2, 2, 2, 3, 3, 3, 3]
+        )
+
+        eight_bit_surf = pygame.image.frombuffer(eight_bit_palette_buffer, (4, 4), "P")
+        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_RGB(self):
+        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))
+        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_BGR(self):
+        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))
+        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_BGRA(self):
+        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))
+        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_RGBX(self):
+        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))
+        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_RGBA(self):
+        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))
+        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_ARGB(self):
+        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))
+        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 = []
+        raw_image.append((200, 200, 200, 255, 100, 100, 100, 255))
+
+        f_descriptor, f_path = tempfile.mkstemp(suffix=".png")
+
+        with os.fdopen(f_descriptor, "wb") as file:
+            w = png.Writer(2, 1, alpha=True)
+            w.write(file, raw_image)
+
+        try:
+            surf = pygame.image.load(f_path)
+            loaded = True
+        except pygame.error:
+            loaded = False
+
+        self.assertEqual(pygame.image.get_extended(), loaded)
+        os.remove(f_path)
+
+    def test_get_sdl_image_version(self):
+        # If get_extended() returns False then get_sdl_image_version() should
+        # return None
+        if not pygame.image.get_extended():
+            self.assertIsNone(pygame.image.get_sdl_image_version())
+        else:
+            expected_length = 3
+            expected_type = tuple
+            expected_item_type = int
+
+            version = pygame.image.get_sdl_image_version()
+
+            self.assertIsInstance(version, expected_type)
+            self.assertEqual(len(version), expected_length)
+
+            for item in version:
+                self.assertIsInstance(item, expected_item_type)
+
+    def test_load_basic(self):
+        """to see if we can load bmp from files and/or file-like objects in memory"""
+
+        # pygame.image.load(filename): return Surface
+
+        # test loading from a file
+        s = pygame.image.load_basic(example_path("data/asprite.bmp"))
+        self.assertEqual(s.get_at((0, 0)), (255, 255, 255, 255))
+
+        # test loading from io.BufferedReader
+        f = pygame.pkgdata.getResource("pygame_icon.bmp")
+        self.assertEqual(f.mode, "rb")
+
+        surf = pygame.image.load_basic(f)
+
+        self.assertEqual(surf.get_at((0, 0)), (5, 4, 5, 255))
+        self.assertEqual(surf.get_height(), 32)
+        self.assertEqual(surf.get_width(), 32)
+
+        f.close()
+
+    def test_load_extended(self):
+        """can load different format images.
+
+        We test loading the following file types:
+            bmp, png, jpg, gif (non-animated), pcx, tga (uncompressed), tif, xpm, ppm, pgm
+        Following file types are tested when using SDL 2
+            svg, pnm, webp
+        All the loaded images are smaller than 32 x 32 pixels.
+        """
+
+        filename_expected_color = [
+            ("asprite.bmp", (255, 255, 255, 255)),
+            ("laplacian.png", (10, 10, 70, 255)),
+            ("red.jpg", (254, 0, 0, 255)),
+            ("blue.gif", (0, 0, 255, 255)),
+            ("green.pcx", (0, 255, 0, 255)),
+            ("yellow.tga", (255, 255, 0, 255)),
+            ("turquoise.tif", (0, 255, 255, 255)),
+            ("purple.xpm", (255, 0, 255, 255)),
+            ("black.ppm", (0, 0, 0, 255)),
+            ("grey.pgm", (120, 120, 120, 255)),
+            ("teal.svg", (0, 128, 128, 255)),
+            ("crimson.pnm", (220, 20, 60, 255)),
+            ("scarlet.webp", (252, 14, 53, 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
+                # endian platforms
+                continue
+
+            with self.subTest(
+                f'Test loading a {filename.split(".")[-1]}',
+                filename="examples/data/" + filename,
+                expected_color=expected_color,
+            ):
+                surf = pygame.image.load_extended(example_path("data/" + filename))
+                self.assertEqual(surf.get_at((0, 0)), expected_color)
+
+    def test_load_pathlib(self):
+        """works loading using a Path argument."""
+        path = pathlib.Path(example_path("data/asprite.bmp"))
+        surf = pygame.image.load_extended(path)
+        self.assertEqual(surf.get_at((0, 0)), (255, 255, 255, 255))
+
+    def test_save_extended(self):
+        surf = pygame.Surface((5, 5))
+        surf.fill((23, 23, 23))
+
+        passing_formats = ["jpg", "png"]
+        passing_formats += [fmt.upper() for fmt in passing_formats]
+
+        magic_hex = {}
+        magic_hex["jpg"] = [0xFF, 0xD8, 0xFF, 0xE0]
+        magic_hex["png"] = [0x89, 0x50, 0x4E, 0x47]
+
+        failing_formats = ["bmp", "tga"]
+        failing_formats += [fmt.upper() for fmt in failing_formats]
+
+        # check that .jpg and .png save
+        for fmt in passing_formats:
+            temp_file_name = f"temp_file.{fmt}"
+            # save image as .jpg and .png
+            pygame.image.save_extended(surf, temp_file_name)
+            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, (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)))
+            # clean up the temp file
+            os.remove(temp_file_name)
+        # check that .bmp and .tga do not save
+        for fmt in failing_formats:
+            self.assertRaises(
+                pygame.error, pygame.image.save_extended, surf, f"temp_file.{fmt}"
+            )
+
+    def threads_load(self, images):
+        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")))
+
+    def test_load_jpg_threads(self):
+        self.threads_load(glob.glob(example_path("data/*.jpg")))
+
+    def test_load_bmp_threads(self):
+        self.threads_load(glob.glob(example_path("data/*.bmp")))
+
+    def test_load_gif_threads(self):
+        self.threads_load(glob.glob(example_path("data/*.gif")))
+
+    def test_from_to_bytes_exists(self):
+        getattr(pygame.image, "frombytes")
+        getattr(pygame.image, "tobytes")
+
+
+if __name__ == "__main__":
+    unittest.main()
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/imageext_tags.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/imageext_tags.py
new file mode 100644
index 0000000..25cff74
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/imageext_tags.py
@@ -0,0 +1,7 @@
+__tags__ = []
+
+import pygame
+import sys
+
+if "pygame.imageext" not in sys.modules:
+    __tags__.extend(("ignore", "subprocess_ignore"))
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/imageext_test.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/imageext_test.py
new file mode 100644
index 0000000..c5ce759
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/imageext_test.py
@@ -0,0 +1,93 @@
+import os
+import os.path
+import sys
+import unittest
+
+from pygame.tests.test_utils import example_path
+import pygame, pygame.image, pygame.pkgdata
+
+
+imageext = sys.modules["pygame.imageext"]
+
+
+class ImageextModuleTest(unittest.TestCase):
+    # Most of the testing is done indirectly through image_test.py
+    # This just confirms file path encoding and error handling.
+    def test_save_non_string_file(self):
+        im = pygame.Surface((10, 10), 0, 32)
+        self.assertRaises(TypeError, imageext.save_extended, im, [])
+
+    def test_load_non_string_file(self):
+        self.assertRaises(TypeError, imageext.load_extended, [])
+
+    @unittest.skip("SDL silently removes invalid characters")
+    def test_save_bad_filename(self):
+        im = pygame.Surface((10, 10), 0, 32)
+        u = "a\x00b\x00c.png"
+        self.assertRaises(pygame.error, imageext.save_extended, im, u)
+
+    @unittest.skip("SDL silently removes invalid characters")
+    def test_load_bad_filename(self):
+        u = "a\x00b\x00c.png"
+        self.assertRaises(pygame.error, imageext.load_extended, u)
+
+    def test_save_unknown_extension(self):
+        im = pygame.Surface((10, 10), 0, 32)
+        s = "foo.bar"
+        self.assertRaises(pygame.error, imageext.save_extended, im, s)
+
+    def test_load_unknown_extension(self):
+        s = "foo.bar"
+        self.assertRaises(FileNotFoundError, imageext.load_extended, s)
+
+    def test_load_unknown_file(self):
+        s = "nonexistent.png"
+        self.assertRaises(FileNotFoundError, imageext.load_extended, s)
+
+    def test_load_unicode_path_0(self):
+        u = example_path("data/alien1.png")
+        im = imageext.load_extended(u)
+
+    def test_load_unicode_path_1(self):
+        """non-ASCII unicode"""
+        import shutil
+
+        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))
+
+        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"""
+        self._unicode_save("temp_file.png")
+
+    def test_save_unicode_path_1(self):
+        self._unicode_save("你好.png")
+
+
+if __name__ == "__main__":
+    unittest.main()
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/joystick_test.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/joystick_test.py
new file mode 100644
index 0000000..47ce3f8
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/joystick_test.py
@@ -0,0 +1,166 @@
+import unittest
+from pygame.tests.test_utils import question, prompt
+
+import pygame
+import pygame._sdl2.controller
+
+
+class JoystickTypeTest(unittest.TestCase):
+    def todo_test_Joystick(self):
+        # __doc__ (as of 2008-08-02) for pygame.joystick.Joystick:
+
+        # pygame.joystick.Joystick(id): return Joystick
+        # create a new Joystick object
+        #
+        # Create a new joystick to access a physical device. The id argument
+        # must be a value from 0 to pygame.joystick.get_count()-1.
+        #
+        # To access most of the Joystick methods, you'll need to init() the
+        # Joystick. This is separate from making sure the joystick module is
+        # initialized. When multiple Joysticks objects are created for the
+        # same physical joystick device (i.e., they have the same ID number),
+        # the state and values for those Joystick objects will be shared.
+        #
+        # The Joystick object allows you to get information about the types of
+        # controls on a joystick device. Once the device is initialized the
+        # Pygame event queue will start receiving events about its input.
+        #
+        # You can call the Joystick.get_name() and Joystick.get_id() functions
+        # without initializing the Joystick object.
+        #
+
+        self.fail()
+
+
+class JoystickModuleTest(unittest.TestCase):
+    def test_get_init(self):
+        # Check that get_init() matches what is actually happening
+        def error_check_get_init():
+            try:
+                pygame.joystick.get_count()
+            except pygame.error:
+                return False
+            return True
+
+        # Start uninitialised
+        self.assertEqual(pygame.joystick.get_init(), False)
+
+        pygame.joystick.init()
+        self.assertEqual(pygame.joystick.get_init(), error_check_get_init())  # True
+        pygame.joystick.quit()
+        self.assertEqual(pygame.joystick.get_init(), error_check_get_init())  # False
+
+        pygame.joystick.init()
+        pygame.joystick.init()
+        self.assertEqual(pygame.joystick.get_init(), error_check_get_init())  # True
+        pygame.joystick.quit()
+        self.assertEqual(pygame.joystick.get_init(), error_check_get_init())  # False
+
+        pygame.joystick.quit()
+        self.assertEqual(pygame.joystick.get_init(), error_check_get_init())  # False
+
+        for i in range(100):
+            pygame.joystick.init()
+        self.assertEqual(pygame.joystick.get_init(), error_check_get_init())  # True
+        pygame.joystick.quit()
+        self.assertEqual(pygame.joystick.get_init(), error_check_get_init())  # False
+
+        for i in range(100):
+            pygame.joystick.quit()
+        self.assertEqual(pygame.joystick.get_init(), error_check_get_init())  # False
+
+    def test_init(self):
+        """
+        This unit test is for joystick.init()
+        It was written to help reduce maintenance costs
+        and to help test against changes to the code or
+        different platforms.
+        """
+        pygame.quit()
+        # test that pygame.init automatically calls joystick.init
+        pygame.init()
+        self.assertEqual(pygame.joystick.get_init(), True)
+
+        # Controller module interferes with the joystick module.
+        pygame._sdl2.controller.quit()
+
+        # test that get_count doesn't work w/o joystick init
+        # this is done before and after an init to test
+        # that init activates the joystick functions
+        pygame.joystick.quit()
+        with self.assertRaises(pygame.error):
+            pygame.joystick.get_count()
+
+        # test explicit call(s) to joystick.init.
+        # Also test that get_count works once init is called
+        iterations = 20
+        for i in range(iterations):
+            pygame.joystick.init()
+        self.assertEqual(pygame.joystick.get_init(), True)
+        self.assertIsNotNone(pygame.joystick.get_count())
+
+    def test_quit(self):
+        """Test if joystick.quit works."""
+
+        pygame.joystick.init()
+
+        self.assertIsNotNone(pygame.joystick.get_count())  # Is not None before quit
+
+        pygame.joystick.quit()
+
+        with self.assertRaises(pygame.error):  # Raises error if quit worked
+            pygame.joystick.get_count()
+
+    def test_get_count(self):
+        # Test that get_count correctly returns a non-negative number of joysticks
+        pygame.joystick.init()
+
+        try:
+            count = pygame.joystick.get_count()
+            self.assertGreaterEqual(
+                count, 0, ("joystick.get_count() must " "return a value >= 0")
+            )
+        finally:
+            pygame.joystick.quit()
+
+
+class JoystickInteractiveTest(unittest.TestCase):
+    __tags__ = ["interactive"]
+
+    def test_get_count_interactive(self):
+        # Test get_count correctly identifies number of connected joysticks
+        prompt(
+            "Please connect any joysticks/controllers now before starting the "
+            "joystick.get_count() test."
+        )
+
+        pygame.joystick.init()
+        # pygame.joystick.get_count(): return count
+        # number of joysticks on the system, 0 means no joysticks connected
+        count = pygame.joystick.get_count()
+
+        response = question(
+            "NOTE: Having Steam open may add an extra virtual controller for "
+            "each joystick/controller physically plugged in.\n"
+            f"joystick.get_count() thinks there is [{count}] joystick(s)/controller(s)"
+            "connected to this system. Is this correct?"
+        )
+
+        self.assertTrue(response)
+
+        # When you create Joystick objects using Joystick(id), you pass an
+        # integer that must be lower than this count.
+        # Test Joystick(id) for each connected joystick
+        if count != 0:
+            for x in range(count):
+                pygame.joystick.Joystick(x)
+            with self.assertRaises(pygame.error):
+                pygame.joystick.Joystick(count)
+
+        pygame.joystick.quit()
+
+
+################################################################################
+
+if __name__ == "__main__":
+    unittest.main()
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/key_test.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/key_test.py
new file mode 100644
index 0000000..1899c73
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/key_test.py
@@ -0,0 +1,306 @@
+import os
+import time
+import unittest
+
+import pygame
+import pygame.key
+
+# keys that are not tested for const-name match
+SKIPPED_KEYS = {"K_UNKNOWN"}
+
+# This is the expected compat output
+KEY_NAME_COMPAT = {
+    "K_0": "0",
+    "K_1": "1",
+    "K_2": "2",
+    "K_3": "3",
+    "K_4": "4",
+    "K_5": "5",
+    "K_6": "6",
+    "K_7": "7",
+    "K_8": "8",
+    "K_9": "9",
+    "K_AC_BACK": "AC Back",
+    "K_AMPERSAND": "&",
+    "K_ASTERISK": "*",
+    "K_AT": "@",
+    "K_BACKQUOTE": "`",
+    "K_BACKSLASH": "\\",
+    "K_BACKSPACE": "backspace",
+    "K_BREAK": "break",
+    "K_CAPSLOCK": "caps lock",
+    "K_CARET": "^",
+    "K_CLEAR": "clear",
+    "K_COLON": ":",
+    "K_COMMA": ",",
+    "K_CURRENCYSUBUNIT": "CurrencySubUnit",
+    "K_CURRENCYUNIT": "euro",
+    "K_DELETE": "delete",
+    "K_DOLLAR": "$",
+    "K_DOWN": "down",
+    "K_END": "end",
+    "K_EQUALS": "=",
+    "K_ESCAPE": "escape",
+    "K_EURO": "euro",
+    "K_EXCLAIM": "!",
+    "K_F1": "f1",
+    "K_F10": "f10",
+    "K_F11": "f11",
+    "K_F12": "f12",
+    "K_F13": "f13",
+    "K_F14": "f14",
+    "K_F15": "f15",
+    "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_GREATER": ">",
+    "K_HASH": "#",
+    "K_HELP": "help",
+    "K_HOME": "home",
+    "K_INSERT": "insert",
+    "K_KP0": "[0]",
+    "K_KP1": "[1]",
+    "K_KP2": "[2]",
+    "K_KP3": "[3]",
+    "K_KP4": "[4]",
+    "K_KP5": "[5]",
+    "K_KP6": "[6]",
+    "K_KP7": "[7]",
+    "K_KP8": "[8]",
+    "K_KP9": "[9]",
+    "K_KP_0": "[0]",
+    "K_KP_1": "[1]",
+    "K_KP_2": "[2]",
+    "K_KP_3": "[3]",
+    "K_KP_4": "[4]",
+    "K_KP_5": "[5]",
+    "K_KP_6": "[6]",
+    "K_KP_7": "[7]",
+    "K_KP_8": "[8]",
+    "K_KP_9": "[9]",
+    "K_KP_DIVIDE": "[/]",
+    "K_KP_ENTER": "enter",
+    "K_KP_EQUALS": "equals",
+    "K_KP_MINUS": "[-]",
+    "K_KP_MULTIPLY": "[*]",
+    "K_KP_PERIOD": "[.]",
+    "K_KP_PLUS": "[+]",
+    "K_LALT": "left alt",
+    "K_LCTRL": "left ctrl",
+    "K_LEFT": "left",
+    "K_LEFTBRACKET": "[",
+    "K_LEFTPAREN": "(",
+    "K_LESS": "<",
+    "K_LGUI": "left meta",
+    "K_LMETA": "left meta",
+    "K_LSHIFT": "left shift",
+    "K_LSUPER": "left meta",
+    "K_MENU": "menu",
+    "K_MINUS": "-",
+    "K_MODE": "alt gr",
+    "K_NUMLOCK": "numlock",
+    "K_NUMLOCKCLEAR": "numlock",
+    "K_PAGEDOWN": "page down",
+    "K_PAGEUP": "page up",
+    "K_PAUSE": "break",
+    "K_PERCENT": "%",
+    "K_PERIOD": ".",
+    "K_PLUS": "+",
+    "K_POWER": "power",
+    "K_PRINT": "print screen",
+    "K_PRINTSCREEN": "print screen",
+    "K_QUESTION": "?",
+    "K_QUOTE": "'",
+    "K_QUOTEDBL": '"',
+    "K_RALT": "right alt",
+    "K_RCTRL": "right ctrl",
+    "K_RETURN": "return",
+    "K_RGUI": "right meta",
+    "K_RIGHT": "right",
+    "K_RIGHTBRACKET": "]",
+    "K_RIGHTPAREN": ")",
+    "K_RMETA": "right meta",
+    "K_RSHIFT": "right shift",
+    "K_RSUPER": "right meta",
+    "K_SCROLLLOCK": "scroll lock",
+    "K_SCROLLOCK": "scroll lock",
+    "K_SEMICOLON": ";",
+    "K_SLASH": "/",
+    "K_SPACE": "space",
+    "K_SYSREQ": "sys req",
+    "K_TAB": "tab",
+    "K_UNDERSCORE": "_",
+    "K_UP": "up",
+    "K_a": "a",
+    "K_b": "b",
+    "K_c": "c",
+    "K_d": "d",
+    "K_e": "e",
+    "K_f": "f",
+    "K_g": "g",
+    "K_h": "h",
+    "K_i": "i",
+    "K_j": "j",
+    "K_k": "k",
+    "K_l": "l",
+    "K_m": "m",
+    "K_n": "n",
+    "K_o": "o",
+    "K_p": "p",
+    "K_q": "q",
+    "K_r": "r",
+    "K_s": "s",
+    "K_t": "t",
+    "K_u": "u",
+    "K_v": "v",
+    "K_w": "w",
+    "K_x": "x",
+    "K_y": "y",
+    "K_z": "z",
+}
+
+
+class KeyModuleTest(unittest.TestCase):
+    @classmethod
+    def setUpClass(cls):
+        pygame.init()
+
+    @classmethod
+    def tearDownClass(cls):
+        pygame.quit()
+
+    def setUp(self):
+        # This makes sure pygame is always initialized before each test (in
+        # case a test calls pygame.quit()).
+        if not pygame.get_init():
+            pygame.init()
+        if not pygame.display.get_init():
+            pygame.display.init()
+
+    def test_import(self):
+        """does it import?"""
+        import pygame.key
+
+    # 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.
+        focused = pygame.key.get_focused()
+        self.assertFalse(focused)  # No window to focus
+        self.assertIsInstance(focused, int)
+        # Dummy video driver never gets keyboard focus.
+        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
+            pygame.event.pump()
+            focused = pygame.key.get_focused()
+            self.assertIsInstance(focused, int)
+            self.assertTrue(focused)
+            # Now test negative, iconify takes away focus
+            pygame.event.clear()
+            # TODO: iconify test fails in windows
+            if os.name != "nt":
+                pygame.display.iconify()
+                # Apparent need to pump event queue in order to make sure iconify
+                # happens. See display_test.py's test_get_active_iconify
+                for _ in range(50):
+                    time.sleep(0.01)
+                    pygame.event.pump()
+                self.assertFalse(pygame.key.get_focused())
+                # Test if focus is returned when iconify is gone
+                pygame.display.set_mode(size=display_sizes[-1], flags=pygame.FULLSCREEN)
+                for i in range(50):
+                    time.sleep(0.01)
+                    pygame.event.pump()
+                self.assertTrue(pygame.key.get_focused())
+        # Test if a quit display raises an error:
+        pygame.display.quit()
+        with self.assertRaises(pygame.error) as cm:
+            pygame.key.get_focused()
+
+    def test_get_pressed(self):
+        states = pygame.key.get_pressed()
+        self.assertEqual(states[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_name_and_key_code(self):
+        for const_name in dir(pygame):
+            if not const_name.startswith("K_") or const_name in SKIPPED_KEYS:
+                continue
+
+            try:
+                expected_str_name = KEY_NAME_COMPAT[const_name]
+            except KeyError:
+                self.fail(
+                    "If you are seeing this error in a test run, you probably added a "
+                    "new pygame key constant, but forgot to update key_test unitests"
+                )
+
+            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 others outputs
+
+            # test positional args
+            self.assertEqual(pygame.key.name(const_val), expected_str_name)
+            # test kwarg
+            self.assertEqual(pygame.key.name(key=const_val), expected_str_name)
+
+            # test positional args
+            self.assertEqual(pygame.key.key_code(expected_str_name), const_val)
+            # test kwarg
+            self.assertEqual(pygame.key.key_code(name=expected_str_name), const_val)
+
+            alt_name = pygame.key.name(const_val, use_compat=False)
+            self.assertIsInstance(alt_name, str)
+
+            # 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)
+            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)
+
+        self.assertRaises(ValueError, pygame.key.key_code, "fizzbuzz")
+
+    def test_set_and_get_mods(self):
+        pygame.key.set_mods(pygame.KMOD_CTRL)
+        self.assertEqual(pygame.key.get_mods(), pygame.KMOD_CTRL)
+
+        pygame.key.set_mods(pygame.KMOD_ALT)
+        self.assertEqual(pygame.key.get_mods(), pygame.KMOD_ALT)
+        pygame.key.set_mods(pygame.KMOD_CTRL | pygame.KMOD_ALT)
+        self.assertEqual(pygame.key.get_mods(), pygame.KMOD_CTRL | pygame.KMOD_ALT)
+
+    def test_set_and_get_repeat(self):
+        self.assertEqual(pygame.key.get_repeat(), (0, 0))
+
+        pygame.key.set_repeat(10, 15)
+        self.assertEqual(pygame.key.get_repeat(), (10, 15))
+
+        pygame.key.set_repeat()
+        self.assertEqual(pygame.key.get_repeat(), (0, 0))
+
+
+if __name__ == "__main__":
+    unittest.main()
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/locals_test.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/locals_test.py
new file mode 100644
index 0000000..973c46d
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/locals_test.py
@@ -0,0 +1,17 @@
+import unittest
+
+import pygame.constants
+import pygame.locals
+
+
+class LocalsTest(unittest.TestCase):
+    def test_locals_has_all_constants(self):
+        constants_set = set(pygame.constants.__all__)
+        locals_set = set(pygame.locals.__all__)
+
+        # locals should have everything that constants has
+        self.assertEqual(constants_set - locals_set, set())
+
+
+if __name__ == "__main__":
+    unittest.main()
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/mask_test.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/mask_test.py
new file mode 100644
index 0000000..bd7daf5
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/mask_test.py
@@ -0,0 +1,6441 @@
+from collections import OrderedDict
+import copy
+import platform
+import random
+import unittest
+import sys
+
+import pygame
+from pygame.locals import *
+from pygame.math import Vector2
+
+
+IS_PYPY = "PyPy" == platform.python_implementation()
+
+
+def random_mask(size=(100, 100)):
+    """random_mask(size=(100,100)): return Mask
+    Create a mask of the given size, with roughly half the bits set at random."""
+    m = pygame.Mask(size)
+    for i in range(size[0] * size[1] // 2):
+        x, y = random.randint(0, size[0] - 1), random.randint(0, size[1] - 1)
+        m.set_at((x, y))
+    return m
+
+
+def maskFromSurface(surface, threshold=127):
+    mask = pygame.Mask(surface.get_size())
+    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:
+                    mask.set_at((x, y), 1)
+    else:
+        for y in range(surface.get_height()):
+            for x in range(surface.get_width()):
+                if surface.get_at((x, y))[3] > threshold:
+                    mask.set_at((x, y), 1)
+    return mask
+
+
+def create_bounding_rect(points):
+    """Creates a bounding rect from the given points."""
+    xmin = xmax = points[0][0]
+    ymin = ymax = points[0][1]
+
+    for x, y in points[1:]:
+        xmin = min(x, xmin)
+        xmax = max(x, xmax)
+        ymin = min(y, ymin)
+        ymax = max(y, ymax)
+
+    return pygame.Rect((xmin, ymin), (xmax - xmin + 1, ymax - ymin + 1))
+
+
+def zero_size_pairs(width, height):
+    """Creates a generator which yields pairs of sizes.
+
+    For each pair of sizes at least one of the sizes will have a 0 in it.
+    """
+    sizes = ((width, height), (width, 0), (0, height), (0, 0))
+
+    return ((a, b) for a in sizes for b in sizes if 0 in a or 0 in b)
+
+
+def corners(mask):
+    """Returns a tuple with the corner positions of the given mask.
+
+    Clockwise from the top left corner.
+    """
+    width, height = mask.get_size()
+    return ((0, 0), (width - 1, 0), (width - 1, height - 1), (0, height - 1))
+
+
+def off_corners(rect):
+    """Returns a tuple with the positions off of the corners of the given rect.
+
+    Clockwise from the top left corner.
+    """
+    return (
+        (rect.left - 1, rect.top),
+        (rect.left - 1, rect.top - 1),
+        (rect.left, rect.top - 1),
+        (rect.right - 1, rect.top - 1),
+        (rect.right, rect.top - 1),
+        (rect.right, rect.top),
+        (rect.right, rect.bottom - 1),
+        (rect.right, rect.bottom),
+        (rect.right - 1, rect.bottom),
+        (rect.left, rect.bottom),
+        (rect.left - 1, rect.bottom),
+        (rect.left - 1, rect.bottom - 1),
+    )
+
+
+def assertSurfaceFilled(testcase, surface, expected_color, area_rect=None):
+    """Checks to see if the given surface is filled with the given color.
+
+    If an area_rect is provided, only check that area of the surface.
+    """
+    if area_rect is None:
+        x_range = range(surface.get_width())
+        y_range = range(surface.get_height())
+    else:
+        area_rect.normalize()
+        area_rect = area_rect.clip(surface.get_rect())
+        x_range = range(area_rect.left, area_rect.right)
+        y_range = range(area_rect.top, area_rect.bottom)
+
+    surface.lock()  # Lock for possible speed up.
+    for pos in ((x, y) for y in y_range for x in x_range):
+        testcase.assertEqual(surface.get_at(pos), expected_color, pos)
+    surface.unlock()
+
+
+def assertSurfaceFilledIgnoreArea(testcase, surface, expected_color, ignore_rect):
+    """Checks if the surface is filled with the given color. The
+    ignore_rect area is not checked.
+    """
+    x_range = range(surface.get_width())
+    y_range = range(surface.get_height())
+    ignore_rect.normalize()
+
+    surface.lock()  # Lock for possible speed up.
+    for pos in ((x, y) for y in y_range for x in x_range):
+        if not ignore_rect.collidepoint(pos):
+            testcase.assertEqual(surface.get_at(pos), expected_color, pos)
+    surface.unlock()
+
+
+def assertMaskEqual(testcase, m1, m2, msg=None):
+    """Checks to see if the 2 given masks are equal."""
+    m1_count = m1.count()
+
+    testcase.assertEqual(m1.get_size(), m2.get_size(), msg=msg)
+    testcase.assertEqual(m1_count, m2.count(), msg=msg)
+    testcase.assertEqual(m1_count, m1.overlap_area(m2, (0, 0)), msg=msg)
+
+    # This can be used to help debug exact locations.
+    ##for i in range(m1.get_size()[0]):
+    ##    for j in range(m1.get_size()[1]):
+    ##        testcase.assertEqual(m1.get_at((i, j)), m2.get_at((i, j)))
+
+
+# @unittest.skipIf(IS_PYPY, "pypy has lots of mask failures")  # TODO
+class MaskTypeTest(unittest.TestCase):
+    ORIGIN_OFFSETS = (
+        (0, 0),
+        (0, 1),
+        (1, 1),
+        (1, 0),
+        (1, -1),
+        (0, -1),
+        (-1, -1),
+        (-1, 0),
+        (-1, 1),
+    )
+
+    @unittest.skipIf(IS_PYPY, "Segfaults on pypy")
+    def test_mask(self):
+        """Ensure masks are created correctly without fill parameter."""
+        expected_count = 0
+        expected_size = (11, 23)
+
+        mask1 = pygame.mask.Mask(expected_size)
+        mask2 = pygame.mask.Mask(size=expected_size)
+
+        self.assertIsInstance(mask1, pygame.mask.Mask)
+        self.assertEqual(mask1.count(), expected_count)
+        self.assertEqual(mask1.get_size(), expected_size)
+
+        self.assertIsInstance(mask2, pygame.mask.Mask)
+        self.assertEqual(mask2.count(), expected_count)
+        self.assertEqual(mask2.get_size(), expected_size)
+
+    def test_mask__negative_size(self):
+        """Ensure the mask constructor handles negative sizes correctly."""
+        for size in ((1, -1), (-1, 1), (-1, -1)):
+            with self.assertRaises(ValueError):
+                mask = pygame.Mask(size)
+
+    def test_mask__fill_kwarg(self):
+        """Ensure masks are created correctly using the fill keyword."""
+        width, height = 37, 47
+        expected_size = (width, height)
+        fill_counts = {True: width * height, False: 0}
+
+        for fill, expected_count in fill_counts.items():
+            msg = f"fill={fill}"
+
+            mask = pygame.mask.Mask(expected_size, fill=fill)
+
+            self.assertIsInstance(mask, pygame.mask.Mask, msg)
+            self.assertEqual(mask.count(), expected_count, msg)
+            self.assertEqual(mask.get_size(), expected_size, msg)
+
+    @unittest.skipIf(IS_PYPY, "Segfaults on pypy")
+    def test_mask__fill_kwarg_bit_boundaries(self):
+        """Ensures masks are created correctly using the fill keyword
+        over a range of sizes.
+
+        Tests masks of different sizes, including:
+           -masks 31 to 33 bits wide (32 bit boundaries)
+           -masks 63 to 65 bits wide (64 bit boundaries)
+        """
+        for height in range(1, 4):
+            for width in range(1, 66):
+                expected_count = width * height
+                expected_size = (width, height)
+                msg = f"size={expected_size}"
+
+                mask = pygame.mask.Mask(expected_size, fill=True)
+
+                self.assertIsInstance(mask, pygame.mask.Mask, msg)
+                self.assertEqual(mask.count(), expected_count, msg)
+                self.assertEqual(mask.get_size(), expected_size, msg)
+
+    def test_mask__fill_arg(self):
+        """Ensure masks are created correctly using a fill arg."""
+        width, height = 59, 71
+        expected_size = (width, height)
+        fill_counts = {True: width * height, False: 0}
+
+        for fill, expected_count in fill_counts.items():
+            msg = f"fill={fill}"
+
+            mask = pygame.mask.Mask(expected_size, fill)
+
+            self.assertIsInstance(mask, pygame.mask.Mask, msg)
+            self.assertEqual(mask.count(), expected_count, msg)
+            self.assertEqual(mask.get_size(), expected_size, msg)
+
+    def test_mask__size_kwarg(self):
+        """Ensure masks are created correctly using the size keyword."""
+        width, height = 73, 83
+        expected_size = (width, height)
+        fill_counts = {True: width * height, False: 0}
+
+        for fill, expected_count in fill_counts.items():
+            msg = f"fill={fill}"
+
+            mask1 = pygame.mask.Mask(fill=fill, size=expected_size)
+            mask2 = pygame.mask.Mask(size=expected_size, fill=fill)
+
+            self.assertIsInstance(mask1, pygame.mask.Mask, msg)
+            self.assertIsInstance(mask2, pygame.mask.Mask, msg)
+            self.assertEqual(mask1.count(), expected_count, msg)
+            self.assertEqual(mask2.count(), expected_count, msg)
+            self.assertEqual(mask1.get_size(), expected_size, msg)
+            self.assertEqual(mask2.get_size(), expected_size, msg)
+
+    def test_copy(self):
+        """Ensures copy works correctly with some bits set and unset."""
+        # Test different widths and heights.
+        for width in (31, 32, 33, 63, 64, 65):
+            for height in (31, 32, 33, 63, 64, 65):
+                mask = pygame.mask.Mask((width, height))
+
+                # Create a checkerboard pattern of set/unset bits.
+                for x in range(width):
+                    for y in range(x & 1, height, 2):
+                        mask.set_at((x, y))
+
+                # Test both the copy() and __copy__() methods.
+                for mask_copy in (mask.copy(), copy.copy(mask)):
+                    self.assertIsInstance(mask_copy, pygame.mask.Mask)
+                    self.assertIsNot(mask_copy, mask)
+                    assertMaskEqual(self, mask_copy, mask)
+
+    def test_copy__full(self):
+        """Ensures copy works correctly on a filled masked."""
+        # Test different widths and heights.
+        for width in (31, 32, 33, 63, 64, 65):
+            for height in (31, 32, 33, 63, 64, 65):
+                mask = pygame.mask.Mask((width, height), fill=True)
+
+                # Test both the copy() and __copy__() methods.
+                for mask_copy in (mask.copy(), copy.copy(mask)):
+                    self.assertIsInstance(mask_copy, pygame.mask.Mask)
+                    self.assertIsNot(mask_copy, mask)
+                    assertMaskEqual(self, mask_copy, mask)
+
+    def test_copy__empty(self):
+        """Ensures copy works correctly on an empty mask."""
+        for width in (31, 32, 33, 63, 64, 65):
+            for height in (31, 32, 33, 63, 64, 65):
+                mask = pygame.mask.Mask((width, height))
+
+                # Test both the copy() and __copy__() methods.
+                for mask_copy in (mask.copy(), copy.copy(mask)):
+                    self.assertIsInstance(mask_copy, pygame.mask.Mask)
+                    self.assertIsNot(mask_copy, mask)
+                    assertMaskEqual(self, mask_copy, mask)
+
+    def test_copy__independent(self):
+        """Ensures copy makes an independent copy of the mask."""
+        mask_set_pos = (64, 1)
+        mask_copy_set_pos = (64, 2)
+        mask = pygame.mask.Mask((65, 3))
+
+        # Test both the copy() and __copy__() methods.
+        mask_copies = (mask.copy(), copy.copy(mask))
+        mask.set_at(mask_set_pos)
+
+        for mask_copy in mask_copies:
+            mask_copy.set_at(mask_copy_set_pos)
+
+            self.assertIsNot(mask_copy, mask)
+            self.assertNotEqual(
+                mask_copy.get_at(mask_set_pos), mask.get_at(mask_set_pos)
+            )
+            self.assertNotEqual(
+                mask_copy.get_at(mask_copy_set_pos), mask.get_at(mask_copy_set_pos)
+            )
+
+    def test_get_size(self):
+        """Ensure a mask's size is correctly retrieved."""
+        expected_size = (93, 101)
+        mask = pygame.mask.Mask(expected_size)
+
+        self.assertEqual(mask.get_size(), expected_size)
+
+    def test_get_rect(self):
+        """Ensures get_rect works correctly."""
+        expected_rect = pygame.Rect((0, 0), (11, 13))
+
+        # Test on full and empty masks.
+        for fill in (True, False):
+            mask = pygame.mask.Mask(expected_rect.size, fill=fill)
+
+            rect = mask.get_rect()
+
+            self.assertEqual(rect, expected_rect)
+
+    @unittest.skipIf(IS_PYPY, "Segfaults on pypy")
+    def test_get_rect__one_kwarg(self):
+        """Ensures get_rect supports a single rect attribute kwarg.
+
+        Tests all the rect attributes.
+        """
+        # Rect attributes that take a single value.
+        RECT_SINGLE_VALUE_ATTRIBUTES = (
+            "x",
+            "y",
+            "top",
+            "left",
+            "bottom",
+            "right",
+            "centerx",
+            "centery",
+            "width",
+            "height",
+            "w",
+            "h",
+        )
+
+        # Rect attributes that take 2 values.
+        RECT_DOUBLE_VALUE_ATTRIBUTES = (
+            "topleft",
+            "bottomleft",
+            "topright",
+            "bottomright",
+            "midtop",
+            "midleft",
+            "midbottom",
+            "midright",
+            "center",
+            "size",
+        )
+
+        # Testing ints/floats and tuples/lists/Vector2s.
+        # {attribute_names : attribute_values}
+        rect_attributes = {
+            RECT_SINGLE_VALUE_ATTRIBUTES: (3, 5.1),
+            RECT_DOUBLE_VALUE_ATTRIBUTES: ((1, 2.2), [2.3, 3], Vector2(0, 1)),
+        }
+
+        size = (7, 3)
+        mask = pygame.mask.Mask(size)
+
+        for attributes, values in rect_attributes.items():
+            for attribute in attributes:
+                for value in values:
+                    expected_rect = pygame.Rect((0, 0), size)
+                    setattr(expected_rect, attribute, value)
+
+                    rect = mask.get_rect(**{attribute: value})
+
+                    self.assertEqual(rect, expected_rect)
+
+    def test_get_rect__multiple_kwargs(self):
+        """Ensures get_rect supports multiple rect attribute kwargs."""
+        mask = pygame.mask.Mask((5, 4))
+        expected_rect = pygame.Rect((0, 0), (0, 0))
+        kwargs = {"x": 7.1, "top": -1, "size": Vector2(2, 3.2)}
+
+        for attrib, value in kwargs.items():
+            setattr(expected_rect, attrib, value)
+
+        rect = mask.get_rect(**kwargs)
+
+        self.assertEqual(rect, expected_rect)
+
+    def test_get_rect__no_arg_support(self):
+        """Ensures get_rect only supports kwargs."""
+        mask = pygame.mask.Mask((4, 5))
+
+        with self.assertRaises(TypeError):
+            rect = mask.get_rect(3)
+
+        with self.assertRaises(TypeError):
+            rect = mask.get_rect((1, 2))
+
+    @unittest.skipIf(IS_PYPY, "Segfaults on pypy")
+    def test_get_rect__invalid_kwarg_name(self):
+        """Ensures get_rect detects invalid kwargs."""
+        mask = pygame.mask.Mask((1, 2))
+
+        with self.assertRaises(AttributeError):
+            rect = mask.get_rect(righte=11)
+
+        with self.assertRaises(AttributeError):
+            rect = mask.get_rect(toplef=(1, 1))
+
+        with self.assertRaises(AttributeError):
+            rect = mask.get_rect(move=(3, 2))
+
+    def test_get_rect__invalid_kwarg_format(self):
+        """Ensures get_rect detects invalid kwarg formats."""
+        mask = pygame.mask.Mask((3, 11))
+
+        with self.assertRaises(TypeError):
+            rect = mask.get_rect(right="1")  # Wrong type.
+
+        with self.assertRaises(TypeError):
+            rect = mask.get_rect(bottom=(1,))  # Wrong type.
+
+        with self.assertRaises(TypeError):
+            rect = mask.get_rect(centerx=(1, 1))  # Wrong type.
+
+        with self.assertRaises(TypeError):
+            rect = mask.get_rect(midleft=(1, "1"))  # Wrong type.
+
+        with self.assertRaises(TypeError):
+            rect = mask.get_rect(topright=(1,))  # Too few.
+
+        with self.assertRaises(TypeError):
+            rect = mask.get_rect(bottomleft=(1, 2, 3))  # Too many.
+
+        with self.assertRaises(TypeError):
+            rect = mask.get_rect(midbottom=1)  # Wrong type.
+
+    def test_get_at(self):
+        """Ensure individual mask bits are correctly retrieved."""
+        width, height = 5, 7
+        mask0 = pygame.mask.Mask((width, height))
+        mask1 = pygame.mask.Mask((width, height), fill=True)
+        mask0_expected_bit = 0
+        mask1_expected_bit = 1
+        pos = (width - 1, height - 1)
+
+        # Check twice to make sure bits aren't toggled.
+        self.assertEqual(mask0.get_at(pos), mask0_expected_bit)
+        self.assertEqual(mask0.get_at(pos=pos), mask0_expected_bit)
+        self.assertEqual(mask1.get_at(Vector2(pos)), mask1_expected_bit)
+        self.assertEqual(mask1.get_at(pos=Vector2(pos)), mask1_expected_bit)
+
+    def test_get_at__out_of_bounds(self):
+        """Ensure get_at() checks bounds."""
+        width, height = 11, 3
+        mask = pygame.mask.Mask((width, height))
+
+        with self.assertRaises(IndexError):
+            mask.get_at((width, 0))
+
+        with self.assertRaises(IndexError):
+            mask.get_at((0, height))
+
+        with self.assertRaises(IndexError):
+            mask.get_at((-1, 0))
+
+        with self.assertRaises(IndexError):
+            mask.get_at((0, -1))
+
+    def test_set_at(self):
+        """Ensure individual mask bits are set to 1."""
+        width, height = 13, 17
+        mask0 = pygame.mask.Mask((width, height))
+        mask1 = pygame.mask.Mask((width, height), fill=True)
+        mask0_expected_count = 1
+        mask1_expected_count = mask1.count()
+        expected_bit = 1
+        pos = (width - 1, height - 1)
+
+        mask0.set_at(pos, expected_bit)  # set 0 to 1
+        mask1.set_at(pos=Vector2(pos), value=expected_bit)  # set 1 to 1
+
+        self.assertEqual(mask0.get_at(pos), expected_bit)
+        self.assertEqual(mask0.count(), mask0_expected_count)
+        self.assertEqual(mask1.get_at(pos), expected_bit)
+        self.assertEqual(mask1.count(), mask1_expected_count)
+
+    def test_set_at__to_0(self):
+        """Ensure individual mask bits are set to 0."""
+        width, height = 11, 7
+        mask0 = pygame.mask.Mask((width, height))
+        mask1 = pygame.mask.Mask((width, height), fill=True)
+        mask0_expected_count = 0
+        mask1_expected_count = mask1.count() - 1
+        expected_bit = 0
+        pos = (width - 1, height - 1)
+
+        mask0.set_at(pos, expected_bit)  # set 0 to 0
+        mask1.set_at(pos, expected_bit)  # set 1 to 0
+
+        self.assertEqual(mask0.get_at(pos), expected_bit)
+        self.assertEqual(mask0.count(), mask0_expected_count)
+        self.assertEqual(mask1.get_at(pos), expected_bit)
+        self.assertEqual(mask1.count(), mask1_expected_count)
+
+    def test_set_at__default_value(self):
+        """Ensure individual mask bits are set using the default value."""
+        width, height = 3, 21
+        mask0 = pygame.mask.Mask((width, height))
+        mask1 = pygame.mask.Mask((width, height), fill=True)
+        mask0_expected_count = 1
+        mask1_expected_count = mask1.count()
+        expected_bit = 1
+        pos = (width - 1, height - 1)
+
+        mask0.set_at(pos)  # set 0 to 1
+        mask1.set_at(pos)  # set 1 to 1
+
+        self.assertEqual(mask0.get_at(pos), expected_bit)
+        self.assertEqual(mask0.count(), mask0_expected_count)
+        self.assertEqual(mask1.get_at(pos), expected_bit)
+        self.assertEqual(mask1.count(), mask1_expected_count)
+
+    def test_set_at__out_of_bounds(self):
+        """Ensure set_at() checks bounds."""
+        width, height = 11, 3
+        mask = pygame.mask.Mask((width, height))
+
+        with self.assertRaises(IndexError):
+            mask.set_at((width, 0))
+
+        with self.assertRaises(IndexError):
+            mask.set_at((0, height))
+
+        with self.assertRaises(IndexError):
+            mask.set_at((-1, 0))
+
+        with self.assertRaises(IndexError):
+            mask.set_at((0, -1))
+
+    def test_overlap(self):
+        """Ensure the overlap intersection is correctly calculated.
+
+        Testing the different combinations of full/empty masks:
+            (mask1-filled) 1 overlap 1 (mask2-filled)
+            (mask1-empty)  0 overlap 1 (mask2-filled)
+            (mask1-filled) 1 overlap 0 (mask2-empty)
+            (mask1-empty)  0 overlap 0 (mask2-empty)
+        """
+        expected_size = (4, 4)
+        offset = (0, 0)
+        expected_default = None
+        expected_overlaps = {(True, True): offset}
+
+        for fill2 in (True, False):
+            mask2 = pygame.mask.Mask(expected_size, fill=fill2)
+            mask2_count = mask2.count()
+
+            for fill1 in (True, False):
+                key = (fill1, fill2)
+                msg = f"key={key}"
+                mask1 = pygame.mask.Mask(expected_size, fill=fill1)
+                mask1_count = mask1.count()
+                expected_pos = expected_overlaps.get(key, expected_default)
+
+                overlap_pos = mask1.overlap(mask2, offset)
+
+                self.assertEqual(overlap_pos, expected_pos, msg)
+
+                # Ensure mask1/mask2 unchanged.
+                self.assertEqual(mask1.count(), mask1_count, msg)
+                self.assertEqual(mask2.count(), mask2_count, msg)
+                self.assertEqual(mask1.get_size(), expected_size, msg)
+                self.assertEqual(mask2.get_size(), expected_size, msg)
+
+    def test_overlap__offset(self):
+        """Ensure an offset overlap intersection is correctly calculated."""
+        mask1 = pygame.mask.Mask((65, 3), fill=True)
+        mask2 = pygame.mask.Mask((66, 4), fill=True)
+        mask1_count = mask1.count()
+        mask2_count = mask2.count()
+        mask1_size = mask1.get_size()
+        mask2_size = mask2.get_size()
+
+        for offset in self.ORIGIN_OFFSETS:
+            msg = f"offset={offset}"
+            expected_pos = (max(offset[0], 0), max(offset[1], 0))
+
+            overlap_pos = mask1.overlap(other=mask2, offset=offset)
+
+            self.assertEqual(overlap_pos, expected_pos, msg)
+
+            # Ensure mask1/mask2 unchanged.
+            self.assertEqual(mask1.count(), mask1_count, msg)
+            self.assertEqual(mask2.count(), mask2_count, msg)
+            self.assertEqual(mask1.get_size(), mask1_size, msg)
+            self.assertEqual(mask2.get_size(), mask2_size, msg)
+
+    def test_overlap__offset_with_unset_bits(self):
+        """Ensure an offset overlap intersection is correctly calculated
+        when (0, 0) bits not set."""
+        mask1 = pygame.mask.Mask((65, 3), fill=True)
+        mask2 = pygame.mask.Mask((66, 4), fill=True)
+        unset_pos = (0, 0)
+        mask1.set_at(unset_pos, 0)
+        mask2.set_at(unset_pos, 0)
+        mask1_count = mask1.count()
+        mask2_count = mask2.count()
+        mask1_size = mask1.get_size()
+        mask2_size = mask2.get_size()
+
+        for offset in self.ORIGIN_OFFSETS:
+            msg = f"offset={offset}"
+            x, y = offset
+            expected_y = max(y, 0)
+            if 0 == y:
+                expected_x = max(x + 1, 1)
+            elif 0 < y:
+                expected_x = max(x + 1, 0)
+            else:
+                expected_x = max(x, 1)
+
+            overlap_pos = mask1.overlap(mask2, Vector2(offset))
+
+            self.assertEqual(overlap_pos, (expected_x, expected_y), msg)
+
+            # Ensure mask1/mask2 unchanged.
+            self.assertEqual(mask1.count(), mask1_count, msg)
+            self.assertEqual(mask2.count(), mask2_count, msg)
+            self.assertEqual(mask1.get_size(), mask1_size, msg)
+            self.assertEqual(mask2.get_size(), mask2_size, msg)
+            self.assertEqual(mask1.get_at(unset_pos), 0, msg)
+            self.assertEqual(mask2.get_at(unset_pos), 0, msg)
+
+    def test_overlap__no_overlap(self):
+        """Ensure an offset overlap intersection is correctly calculated
+        when there is no overlap."""
+        mask1 = pygame.mask.Mask((65, 3), fill=True)
+        mask1_count = mask1.count()
+        mask1_size = mask1.get_size()
+
+        mask2_w, mask2_h = 67, 5
+        mask2_size = (mask2_w, mask2_h)
+        mask2 = pygame.mask.Mask(mask2_size)
+        set_pos = (mask2_w - 1, mask2_h - 1)
+        mask2.set_at(set_pos)
+        mask2_count = 1
+
+        for offset in self.ORIGIN_OFFSETS:
+            msg = f"offset={offset}"
+
+            overlap_pos = mask1.overlap(mask2, offset)
+
+            self.assertIsNone(overlap_pos, msg)
+
+            # Ensure mask1/mask2 unchanged.
+            self.assertEqual(mask1.count(), mask1_count, msg)
+            self.assertEqual(mask2.count(), mask2_count, msg)
+            self.assertEqual(mask1.get_size(), mask1_size, msg)
+            self.assertEqual(mask2.get_size(), mask2_size, msg)
+            self.assertEqual(mask2.get_at(set_pos), 1, msg)
+
+    def test_overlap__offset_boundary(self):
+        """Ensures overlap handles offsets and boundaries correctly."""
+        mask1 = pygame.mask.Mask((13, 3), fill=True)
+        mask2 = pygame.mask.Mask((7, 5), fill=True)
+        mask1_count = mask1.count()
+        mask2_count = mask2.count()
+        mask1_size = mask1.get_size()
+        mask2_size = mask2.get_size()
+
+        # Check the 4 boundaries.
+        offsets = (
+            (mask1_size[0], 0),  # off right
+            (0, mask1_size[1]),  # off bottom
+            (-mask2_size[0], 0),  # off left
+            (0, -mask2_size[1]),
+        )  # off top
+
+        for offset in offsets:
+            msg = f"offset={offset}"
+
+            overlap_pos = mask1.overlap(mask2, offset)
+
+            self.assertIsNone(overlap_pos, msg)
+
+            # Ensure mask1/mask2 unchanged.
+            self.assertEqual(mask1.count(), mask1_count, msg)
+            self.assertEqual(mask2.count(), mask2_count, msg)
+            self.assertEqual(mask1.get_size(), mask1_size, msg)
+            self.assertEqual(mask2.get_size(), mask2_size, msg)
+
+    @unittest.skipIf(IS_PYPY, "Segfaults on pypy")
+    def test_overlap__bit_boundaries(self):
+        """Ensures overlap handles masks of different sizes correctly.
+
+        Tests masks of different sizes, including:
+           -masks 31 to 33 bits wide (32 bit boundaries)
+           -masks 63 to 65 bits wide (64 bit boundaries)
+        """
+        for height in range(2, 4):
+            for width in range(2, 66):
+                mask_size = (width, height)
+                mask_count = width * height
+                mask1 = pygame.mask.Mask(mask_size, fill=True)
+                mask2 = pygame.mask.Mask(mask_size, fill=True)
+
+                # Testing masks offset from each other.
+                for offset in self.ORIGIN_OFFSETS:
+                    msg = f"size={mask_size}, offset={offset}"
+                    expected_pos = (max(offset[0], 0), max(offset[1], 0))
+
+                    overlap_pos = mask1.overlap(mask2, offset)
+
+                    self.assertEqual(overlap_pos, expected_pos, msg)
+
+                    # Ensure mask1/mask2 unchanged.
+                    self.assertEqual(mask1.count(), mask_count, msg)
+                    self.assertEqual(mask2.count(), mask_count, msg)
+                    self.assertEqual(mask1.get_size(), mask_size, msg)
+                    self.assertEqual(mask2.get_size(), mask_size, msg)
+
+    @unittest.skipIf(IS_PYPY, "Segfaults on pypy")
+    def test_overlap__invalid_mask_arg(self):
+        """Ensure overlap handles invalid mask arguments correctly."""
+        size = (5, 3)
+        offset = (0, 0)
+        mask = pygame.mask.Mask(size)
+        invalid_mask = pygame.Surface(size)
+
+        with self.assertRaises(TypeError):
+            overlap_pos = mask.overlap(invalid_mask, offset)
+
+    def test_overlap__invalid_offset_arg(self):
+        """Ensure overlap handles invalid offset arguments correctly."""
+        size = (2, 7)
+        offset = "(0, 0)"
+        mask1 = pygame.mask.Mask(size)
+        mask2 = pygame.mask.Mask(size)
+
+        with self.assertRaises(TypeError):
+            overlap_pos = mask1.overlap(mask2, offset)
+
+    @unittest.skipIf(IS_PYPY, "Segfaults on pypy")
+    def test_overlap_area(self):
+        """Ensure the overlap_area is correctly calculated.
+
+        Testing the different combinations of full/empty masks:
+            (mask1-filled) 1 overlap_area 1 (mask2-filled)
+            (mask1-empty)  0 overlap_area 1 (mask2-filled)
+            (mask1-filled) 1 overlap_area 0 (mask2-empty)
+            (mask1-empty)  0 overlap_area 0 (mask2-empty)
+        """
+        expected_size = width, height = (4, 4)
+        offset = (0, 0)
+        expected_default = 0
+        expected_counts = {(True, True): width * height}
+
+        for fill2 in (True, False):
+            mask2 = pygame.mask.Mask(expected_size, fill=fill2)
+            mask2_count = mask2.count()
+
+            for fill1 in (True, False):
+                key = (fill1, fill2)
+                msg = f"key={key}"
+                mask1 = pygame.mask.Mask(expected_size, fill=fill1)
+                mask1_count = mask1.count()
+                expected_count = expected_counts.get(key, expected_default)
+
+                overlap_count = mask1.overlap_area(mask2, offset)
+
+                self.assertEqual(overlap_count, expected_count, msg)
+
+                # Ensure mask1/mask2 unchanged.
+                self.assertEqual(mask1.count(), mask1_count, msg)
+                self.assertEqual(mask2.count(), mask2_count, msg)
+                self.assertEqual(mask1.get_size(), expected_size, msg)
+                self.assertEqual(mask2.get_size(), expected_size, msg)
+
+    @unittest.skipIf(IS_PYPY, "Segfaults on pypy")
+    def test_overlap_area__offset(self):
+        """Ensure an offset overlap_area is correctly calculated."""
+        mask1 = pygame.mask.Mask((65, 3), fill=True)
+        mask2 = pygame.mask.Mask((66, 4), fill=True)
+        mask1_count = mask1.count()
+        mask2_count = mask2.count()
+        mask1_size = mask1.get_size()
+        mask2_size = mask2.get_size()
+
+        # Using rects to help determine the overlapping area.
+        rect1 = mask1.get_rect()
+        rect2 = mask2.get_rect()
+
+        for offset in self.ORIGIN_OFFSETS:
+            msg = f"offset={offset}"
+            rect2.topleft = offset
+            overlap_rect = rect1.clip(rect2)
+            expected_count = overlap_rect.w * overlap_rect.h
+
+            overlap_count = mask1.overlap_area(other=mask2, offset=offset)
+
+            self.assertEqual(overlap_count, expected_count, msg)
+
+            # Ensure mask1/mask2 unchanged.
+            self.assertEqual(mask1.count(), mask1_count, msg)
+            self.assertEqual(mask2.count(), mask2_count, msg)
+            self.assertEqual(mask1.get_size(), mask1_size, msg)
+            self.assertEqual(mask2.get_size(), mask2_size, msg)
+
+    def test_overlap_area__offset_boundary(self):
+        """Ensures overlap_area handles offsets and boundaries correctly."""
+        mask1 = pygame.mask.Mask((11, 3), fill=True)
+        mask2 = pygame.mask.Mask((5, 7), fill=True)
+        mask1_count = mask1.count()
+        mask2_count = mask2.count()
+        mask1_size = mask1.get_size()
+        mask2_size = mask2.get_size()
+        expected_count = 0
+
+        # Check the 4 boundaries.
+        offsets = (
+            (mask1_size[0], 0),  # off right
+            (0, mask1_size[1]),  # off bottom
+            (-mask2_size[0], 0),  # off left
+            (0, -mask2_size[1]),
+        )  # off top
+
+        for offset in offsets:
+            msg = f"offset={offset}"
+
+            overlap_count = mask1.overlap_area(mask2, Vector2(offset))
+
+            self.assertEqual(overlap_count, expected_count, msg)
+
+            # Ensure mask1/mask2 unchanged.
+            self.assertEqual(mask1.count(), mask1_count, msg)
+            self.assertEqual(mask2.count(), mask2_count, msg)
+            self.assertEqual(mask1.get_size(), mask1_size, msg)
+            self.assertEqual(mask2.get_size(), mask2_size, msg)
+
+    @unittest.skipIf(IS_PYPY, "Segfaults on pypy")
+    def test_overlap_area__bit_boundaries(self):
+        """Ensures overlap_area handles masks of different sizes correctly.
+
+        Tests masks of different sizes, including:
+           -masks 31 to 33 bits wide (32 bit boundaries)
+           -masks 63 to 65 bits wide (64 bit boundaries)
+        """
+        for height in range(2, 4):
+            for width in range(2, 66):
+                mask_size = (width, height)
+                mask_count = width * height
+                mask1 = pygame.mask.Mask(mask_size, fill=True)
+                mask2 = pygame.mask.Mask(mask_size, fill=True)
+
+                # Using rects to help determine the overlapping area.
+                rect1 = mask1.get_rect()
+                rect2 = mask2.get_rect()
+
+                # Testing masks offset from each other.
+                for offset in self.ORIGIN_OFFSETS:
+                    msg = f"size={mask_size}, offset={offset}"
+                    rect2.topleft = offset
+                    overlap_rect = rect1.clip(rect2)
+                    expected_overlap_count = overlap_rect.w * overlap_rect.h
+
+                    overlap_count = mask1.overlap_area(mask2, offset)
+
+                    self.assertEqual(overlap_count, expected_overlap_count, msg)
+
+                    # Ensure mask1/mask2 unchanged.
+                    self.assertEqual(mask1.count(), mask_count, msg)
+                    self.assertEqual(mask2.count(), mask_count, msg)
+                    self.assertEqual(mask1.get_size(), mask_size, msg)
+                    self.assertEqual(mask2.get_size(), mask_size, msg)
+
+    def test_overlap_area__invalid_mask_arg(self):
+        """Ensure overlap_area handles invalid mask arguments correctly."""
+        size = (3, 5)
+        offset = (0, 0)
+        mask = pygame.mask.Mask(size)
+        invalid_mask = pygame.Surface(size)
+
+        with self.assertRaises(TypeError):
+            overlap_count = mask.overlap_area(invalid_mask, offset)
+
+    def test_overlap_area__invalid_offset_arg(self):
+        """Ensure overlap_area handles invalid offset arguments correctly."""
+        size = (7, 2)
+        offset = "(0, 0)"
+        mask1 = pygame.mask.Mask(size)
+        mask2 = pygame.mask.Mask(size)
+
+        with self.assertRaises(TypeError):
+            overlap_count = mask1.overlap_area(mask2, offset)
+
+    def test_overlap_mask(self):
+        """Ensure overlap_mask's mask has correct bits set.
+
+        Testing the different combinations of full/empty masks:
+            (mask1-filled) 1 overlap_mask 1 (mask2-filled)
+            (mask1-empty)  0 overlap_mask 1 (mask2-filled)
+            (mask1-filled) 1 overlap_mask 0 (mask2-empty)
+            (mask1-empty)  0 overlap_mask 0 (mask2-empty)
+        """
+        expected_size = (4, 4)
+        offset = (0, 0)
+        expected_default = pygame.mask.Mask(expected_size)
+        expected_masks = {(True, True): pygame.mask.Mask(expected_size, fill=True)}
+
+        for fill2 in (True, False):
+            mask2 = pygame.mask.Mask(expected_size, fill=fill2)
+            mask2_count = mask2.count()
+
+            for fill1 in (True, False):
+                key = (fill1, fill2)
+                msg = f"key={key}"
+                mask1 = pygame.mask.Mask(expected_size, fill=fill1)
+                mask1_count = mask1.count()
+                expected_mask = expected_masks.get(key, expected_default)
+
+                overlap_mask = mask1.overlap_mask(other=mask2, offset=offset)
+
+                self.assertIsInstance(overlap_mask, pygame.mask.Mask, msg)
+                assertMaskEqual(self, overlap_mask, expected_mask, msg)
+
+                # Ensure mask1/mask2 unchanged.
+                self.assertEqual(mask1.count(), mask1_count, msg)
+                self.assertEqual(mask2.count(), mask2_count, msg)
+                self.assertEqual(mask1.get_size(), expected_size, msg)
+                self.assertEqual(mask2.get_size(), expected_size, msg)
+
+    @unittest.skipIf(IS_PYPY, "Segfaults on pypy")
+    def test_overlap_mask__bits_set(self):
+        """Ensure overlap_mask's mask has correct bits set."""
+        mask1 = pygame.mask.Mask((50, 50), fill=True)
+        mask2 = pygame.mask.Mask((300, 10), fill=True)
+        mask1_count = mask1.count()
+        mask2_count = mask2.count()
+        mask1_size = mask1.get_size()
+        mask2_size = mask2.get_size()
+
+        mask3 = mask1.overlap_mask(mask2, (-1, 0))
+
+        for i in range(50):
+            for j in range(10):
+                self.assertEqual(mask3.get_at((i, j)), 1, f"({i}, {j})")
+
+        for i in range(50):
+            for j in range(11, 50):
+                self.assertEqual(mask3.get_at((i, j)), 0, f"({i}, {j})")
+
+        # Ensure mask1/mask2 unchanged.
+        self.assertEqual(mask1.count(), mask1_count)
+        self.assertEqual(mask2.count(), mask2_count)
+        self.assertEqual(mask1.get_size(), mask1_size)
+        self.assertEqual(mask2.get_size(), mask2_size)
+
+    def test_overlap_mask__offset(self):
+        """Ensure an offset overlap_mask's mask is correctly calculated."""
+        mask1 = pygame.mask.Mask((65, 3), fill=True)
+        mask2 = pygame.mask.Mask((66, 4), fill=True)
+        mask1_count = mask1.count()
+        mask2_count = mask2.count()
+        mask1_size = mask1.get_size()
+        mask2_size = mask2.get_size()
+        expected_mask = pygame.Mask(mask1_size)
+
+        # Using rects to help determine the overlapping area.
+        rect1 = mask1.get_rect()
+        rect2 = mask2.get_rect()
+
+        for offset in self.ORIGIN_OFFSETS:
+            msg = f"offset={offset}"
+            rect2.topleft = offset
+            overlap_rect = rect1.clip(rect2)
+            expected_mask.clear()
+            expected_mask.draw(
+                pygame.Mask(overlap_rect.size, fill=True), overlap_rect.topleft
+            )
+
+            overlap_mask = mask1.overlap_mask(mask2, offset)
+
+            self.assertIsInstance(overlap_mask, pygame.mask.Mask, msg)
+            assertMaskEqual(self, overlap_mask, expected_mask, msg)
+
+            # Ensure mask1/mask2 unchanged.
+            self.assertEqual(mask1.count(), mask1_count, msg)
+            self.assertEqual(mask2.count(), mask2_count, msg)
+            self.assertEqual(mask1.get_size(), mask1_size, msg)
+            self.assertEqual(mask2.get_size(), mask2_size, msg)
+
+    @unittest.skipIf(IS_PYPY, "Segfaults on pypy")
+    def test_overlap_mask__specific_offsets(self):
+        """Ensure an offset overlap_mask's mask is correctly calculated.
+
+        Testing the specific case of:
+            -both masks are wider than 32 bits
+            -a positive offset is used
+            -the mask calling overlap_mask() is wider than the mask passed in
+        """
+        mask1 = pygame.mask.Mask((65, 5), fill=True)
+        mask2 = pygame.mask.Mask((33, 3), fill=True)
+        expected_mask = pygame.Mask(mask1.get_size())
+
+        # Using rects to help determine the overlapping area.
+        rect1 = mask1.get_rect()
+        rect2 = mask2.get_rect()
+
+        # This rect's corners are used to move rect2 around the inside of
+        # rect1.
+        corner_rect = rect1.inflate(-2, -2)
+
+        for corner in ("topleft", "topright", "bottomright", "bottomleft"):
+            setattr(rect2, corner, getattr(corner_rect, corner))
+            offset = rect2.topleft
+            msg = f"offset={offset}"
+            overlap_rect = rect1.clip(rect2)
+            expected_mask.clear()
+            expected_mask.draw(
+                pygame.Mask(overlap_rect.size, fill=True), overlap_rect.topleft
+            )
+
+            overlap_mask = mask1.overlap_mask(mask2, offset)
+
+            self.assertIsInstance(overlap_mask, pygame.mask.Mask, msg)
+            assertMaskEqual(self, overlap_mask, expected_mask, msg)
+
+    def test_overlap_mask__offset_boundary(self):
+        """Ensures overlap_mask handles offsets and boundaries correctly."""
+        mask1 = pygame.mask.Mask((9, 3), fill=True)
+        mask2 = pygame.mask.Mask((11, 5), fill=True)
+        mask1_count = mask1.count()
+        mask2_count = mask2.count()
+        mask1_size = mask1.get_size()
+        mask2_size = mask2.get_size()
+        expected_count = 0
+        expected_size = mask1_size
+
+        # Check the 4 boundaries.
+        offsets = (
+            (mask1_size[0], 0),  # off right
+            (0, mask1_size[1]),  # off bottom
+            (-mask2_size[0], 0),  # off left
+            (0, -mask2_size[1]),
+        )  # off top
+
+        for offset in offsets:
+            msg = f"offset={offset}"
+
+            overlap_mask = mask1.overlap_mask(mask2, offset)
+
+            self.assertIsInstance(overlap_mask, pygame.mask.Mask, msg)
+            self.assertEqual(overlap_mask.count(), expected_count, msg)
+            self.assertEqual(overlap_mask.get_size(), expected_size, msg)
+
+            # Ensure mask1/mask2 unchanged.
+            self.assertEqual(mask1.count(), mask1_count, msg)
+            self.assertEqual(mask2.count(), mask2_count, msg)
+            self.assertEqual(mask1.get_size(), mask1_size, msg)
+            self.assertEqual(mask2.get_size(), mask2_size, msg)
+
+    @unittest.skipIf(IS_PYPY, "Segfaults on pypy")
+    def test_overlap_mask__bit_boundaries(self):
+        """Ensures overlap_mask handles masks of different sizes correctly.
+
+        Tests masks of different sizes, including:
+           -masks 31 to 33 bits wide (32 bit boundaries)
+           -masks 63 to 65 bits wide (64 bit boundaries)
+        """
+        for height in range(2, 4):
+            for width in range(2, 66):
+                mask_size = (width, height)
+                mask_count = width * height
+                mask1 = pygame.mask.Mask(mask_size, fill=True)
+                mask2 = pygame.mask.Mask(mask_size, fill=True)
+                expected_mask = pygame.Mask(mask_size)
+
+                # Using rects to help determine the overlapping area.
+                rect1 = mask1.get_rect()
+                rect2 = mask2.get_rect()
+
+                # Testing masks offset from each other.
+                for offset in self.ORIGIN_OFFSETS:
+                    msg = f"size={mask_size}, offset={offset}"
+                    rect2.topleft = offset
+                    overlap_rect = rect1.clip(rect2)
+                    expected_mask.clear()
+                    expected_mask.draw(
+                        pygame.Mask(overlap_rect.size, fill=True), overlap_rect.topleft
+                    )
+
+                    overlap_mask = mask1.overlap_mask(mask2, offset)
+
+                    self.assertIsInstance(overlap_mask, pygame.mask.Mask, msg)
+                    assertMaskEqual(self, overlap_mask, expected_mask, msg)
+
+                    # Ensure mask1/mask2 unchanged.
+                    self.assertEqual(mask1.count(), mask_count, msg)
+                    self.assertEqual(mask2.count(), mask_count, msg)
+                    self.assertEqual(mask1.get_size(), mask_size, msg)
+                    self.assertEqual(mask2.get_size(), mask_size, msg)
+
+    def test_overlap_mask__invalid_mask_arg(self):
+        """Ensure overlap_mask handles invalid mask arguments correctly."""
+        size = (3, 2)
+        offset = (0, 0)
+        mask = pygame.mask.Mask(size)
+        invalid_mask = pygame.Surface(size)
+
+        with self.assertRaises(TypeError):
+            overlap_mask = mask.overlap_mask(invalid_mask, offset)
+
+    def test_overlap_mask__invalid_offset_arg(self):
+        """Ensure overlap_mask handles invalid offset arguments correctly."""
+        size = (5, 2)
+        offset = "(0, 0)"
+        mask1 = pygame.mask.Mask(size)
+        mask2 = pygame.mask.Mask(size)
+
+        with self.assertRaises(TypeError):
+            overlap_mask = mask1.overlap_mask(mask2, offset)
+
+    def test_mask_access(self):
+        """do the set_at, and get_at parts work correctly?"""
+        m = pygame.Mask((10, 10))
+        m.set_at((0, 0), 1)
+        self.assertEqual(m.get_at((0, 0)), 1)
+        m.set_at((9, 0), 1)
+        self.assertEqual(m.get_at((9, 0)), 1)
+
+        # s = pygame.Surface((10,10))
+        # s.set_at((1,0), (0, 0, 1, 255))
+        # self.assertEqual(s.get_at((1,0)), (0, 0, 1, 255))
+        # s.set_at((-1,0), (0, 0, 1, 255))
+
+        # out of bounds, should get IndexError
+        self.assertRaises(IndexError, lambda: m.get_at((-1, 0)))
+        self.assertRaises(IndexError, lambda: m.set_at((-1, 0), 1))
+        self.assertRaises(IndexError, lambda: m.set_at((10, 0), 1))
+        self.assertRaises(IndexError, lambda: m.set_at((0, 10), 1))
+
+    def test_fill(self):
+        """Ensure a mask can be filled."""
+        width, height = 11, 23
+        expected_count = width * height
+        expected_size = (width, height)
+        mask = pygame.mask.Mask(expected_size)
+
+        mask.fill()
+
+        self.assertEqual(mask.count(), expected_count)
+        self.assertEqual(mask.get_size(), expected_size)
+
+    @unittest.skipIf(IS_PYPY, "Segfaults on pypy")
+    def test_fill__bit_boundaries(self):
+        """Ensures masks of different sizes are filled correctly.
+
+        Tests masks of different sizes, including:
+           -masks 31 to 33 bits wide (32 bit boundaries)
+           -masks 63 to 65 bits wide (64 bit boundaries)
+        """
+        for height in range(1, 4):
+            for width in range(1, 66):
+                mask = pygame.mask.Mask((width, height))
+                expected_count = width * height
+
+                mask.fill()
+
+                self.assertEqual(
+                    mask.count(), expected_count, f"size=({width}, {height})"
+                )
+
+    def test_clear(self):
+        """Ensure a mask can be cleared."""
+        expected_count = 0
+        expected_size = (13, 27)
+        mask = pygame.mask.Mask(expected_size, fill=True)
+
+        mask.clear()
+
+        self.assertEqual(mask.count(), expected_count)
+        self.assertEqual(mask.get_size(), expected_size)
+
+    def test_clear__bit_boundaries(self):
+        """Ensures masks of different sizes are cleared correctly.
+
+        Tests masks of different sizes, including:
+           -masks 31 to 33 bits wide (32 bit boundaries)
+           -masks 63 to 65 bits wide (64 bit boundaries)
+        """
+        expected_count = 0
+
+        for height in range(1, 4):
+            for width in range(1, 66):
+                mask = pygame.mask.Mask((width, height), fill=True)
+
+                mask.clear()
+
+                self.assertEqual(
+                    mask.count(), expected_count, f"size=({width}, {height})"
+                )
+
+    @unittest.skipIf(IS_PYPY, "Segfaults on pypy")
+    def test_invert(self):
+        """Ensure a mask can be inverted."""
+        side = 73
+        expected_size = (side, side)
+        mask1 = pygame.mask.Mask(expected_size)
+        mask2 = pygame.mask.Mask(expected_size, fill=True)
+        expected_count1 = side * side
+        expected_count2 = 0
+
+        for i in range(side):
+            expected_count1 -= 1
+            expected_count2 += 1
+            pos = (i, i)
+            mask1.set_at(pos)
+            mask2.set_at(pos, 0)
+
+        mask1.invert()
+        mask2.invert()
+
+        self.assertEqual(mask1.count(), expected_count1)
+        self.assertEqual(mask2.count(), expected_count2)
+        self.assertEqual(mask1.get_size(), expected_size)
+        self.assertEqual(mask2.get_size(), expected_size)
+
+        for i in range(side):
+            pos = (i, i)
+            msg = f"pos={pos}"
+
+            self.assertEqual(mask1.get_at(pos), 0, msg)
+            self.assertEqual(mask2.get_at(pos), 1, msg)
+
+    def test_invert__full(self):
+        """Ensure a full mask can be inverted."""
+        expected_count = 0
+        expected_size = (43, 97)
+        mask = pygame.mask.Mask(expected_size, fill=True)
+
+        mask.invert()
+
+        self.assertEqual(mask.count(), expected_count)
+        self.assertEqual(mask.get_size(), expected_size)
+
+    def test_invert__empty(self):
+        """Ensure an empty mask can be inverted."""
+        width, height = 43, 97
+        expected_size = (width, height)
+        expected_count = width * height
+        mask = pygame.mask.Mask(expected_size)
+
+        mask.invert()
+
+        self.assertEqual(mask.count(), expected_count)
+        self.assertEqual(mask.get_size(), expected_size)
+
+    @unittest.skipIf(IS_PYPY, "Segfaults on pypy")
+    def test_invert__bit_boundaries(self):
+        """Ensures masks of different sizes are inverted correctly.
+
+        Tests masks of different sizes, including:
+           -masks 31 to 33 bits wide (32 bit boundaries)
+           -masks 63 to 65 bits wide (64 bit boundaries)
+        """
+        for fill in (True, False):
+            for height in range(1, 4):
+                for width in range(1, 66):
+                    mask = pygame.mask.Mask((width, height), fill=fill)
+                    expected_count = 0 if fill else width * height
+
+                    mask.invert()
+
+                    self.assertEqual(
+                        mask.count(),
+                        expected_count,
+                        f"fill={fill}, size=({width}, {height})",
+                    )
+
+    @unittest.skipIf(IS_PYPY, "Segfaults on pypy")
+    def test_scale(self):
+        """Ensure a mask can be scaled."""
+        width, height = 43, 61
+        original_size = (width, height)
+
+        for fill in (True, False):
+            original_mask = pygame.mask.Mask(original_size, fill=fill)
+            original_count = width * height if fill else 0
+
+            # Test a range of sizes. Also tests scaling to 'same'
+            # size when new_w, new_h = width, height
+            for new_w in range(width - 10, width + 10):
+                for new_h in range(height - 10, height + 10):
+                    expected_size = (new_w, new_h)
+                    expected_count = new_w * new_h if fill else 0
+                    msg = f"size={expected_size}"
+
+                    mask = original_mask.scale(scale=expected_size)
+
+                    self.assertIsInstance(mask, pygame.mask.Mask, msg)
+                    self.assertEqual(mask.count(), expected_count, msg)
+                    self.assertEqual(mask.get_size(), expected_size)
+
+                    # Ensure the original mask is unchanged.
+                    self.assertEqual(original_mask.count(), original_count, msg)
+                    self.assertEqual(original_mask.get_size(), original_size, msg)
+
+    def test_scale__negative_size(self):
+        """Ensure scale handles negative sizes correctly."""
+        mask = pygame.Mask((100, 100))
+
+        with self.assertRaises(ValueError):
+            mask.scale((-1, -1))
+
+        with self.assertRaises(ValueError):
+            mask.scale(Vector2(-1, 10))
+
+        with self.assertRaises(ValueError):
+            mask.scale((10, -1))
+
+    def test_draw(self):
+        """Ensure a mask can be drawn onto another mask.
+
+        Testing the different combinations of full/empty masks:
+            (mask1-filled) 1 draw 1 (mask2-filled)
+            (mask1-empty)  0 draw 1 (mask2-filled)
+            (mask1-filled) 1 draw 0 (mask2-empty)
+            (mask1-empty)  0 draw 0 (mask2-empty)
+        """
+        expected_size = (4, 4)
+        offset = (0, 0)
+        expected_default = pygame.mask.Mask(expected_size, fill=True)
+        expected_masks = {(False, False): pygame.mask.Mask(expected_size)}
+
+        for fill2 in (True, False):
+            mask2 = pygame.mask.Mask(expected_size, fill=fill2)
+            mask2_count = mask2.count()
+
+            for fill1 in (True, False):
+                key = (fill1, fill2)
+                msg = f"key={key}"
+                mask1 = pygame.mask.Mask(expected_size, fill=fill1)
+                expected_mask = expected_masks.get(key, expected_default)
+
+                mask1.draw(mask2, offset)
+
+                assertMaskEqual(self, mask1, expected_mask, msg)
+
+                # Ensure mask2 unchanged.
+                self.assertEqual(mask2.count(), mask2_count, msg)
+                self.assertEqual(mask2.get_size(), expected_size, msg)
+
+    def test_draw__offset(self):
+        """Ensure an offset mask can be drawn onto another mask."""
+        mask1 = pygame.mask.Mask((65, 3))
+        mask2 = pygame.mask.Mask((66, 4), fill=True)
+        mask2_count = mask2.count()
+        mask2_size = mask2.get_size()
+        expected_mask = pygame.Mask(mask1.get_size())
+
+        # Using rects to help determine the overlapping area.
+        rect1 = mask1.get_rect()
+        rect2 = mask2.get_rect()
+
+        for offset in self.ORIGIN_OFFSETS:
+            msg = f"offset={offset}"
+            rect2.topleft = offset
+            overlap_rect = rect1.clip(rect2)
+            expected_mask.clear()
+
+            # Normally draw() could be used to set these bits, but the draw()
+            # method is being tested here, so a loop is used instead.
+            for x in range(overlap_rect.left, overlap_rect.right):
+                for y in range(overlap_rect.top, overlap_rect.bottom):
+                    expected_mask.set_at((x, y))
+            mask1.clear()  # Ensure it's empty for testing each offset.
+
+            mask1.draw(other=mask2, offset=offset)
+
+            assertMaskEqual(self, mask1, expected_mask, msg)
+
+            # Ensure mask2 unchanged.
+            self.assertEqual(mask2.count(), mask2_count, msg)
+            self.assertEqual(mask2.get_size(), mask2_size, msg)
+
+    def test_draw__specific_offsets(self):
+        """Ensure an offset mask can be drawn onto another mask.
+
+        Testing the specific case of:
+            -both masks are wider than 32 bits
+            -a positive offset is used
+            -the mask calling draw() is wider than the mask passed in
+        """
+        mask1 = pygame.mask.Mask((65, 5))
+        mask2 = pygame.mask.Mask((33, 3), fill=True)
+        expected_mask = pygame.Mask(mask1.get_size())
+
+        # Using rects to help determine the overlapping area.
+        rect1 = mask1.get_rect()
+        rect2 = mask2.get_rect()
+
+        # This rect's corners are used to move rect2 around the inside of
+        # rect1.
+        corner_rect = rect1.inflate(-2, -2)
+
+        for corner in ("topleft", "topright", "bottomright", "bottomleft"):
+            setattr(rect2, corner, getattr(corner_rect, corner))
+            offset = rect2.topleft
+            msg = f"offset={offset}"
+            overlap_rect = rect1.clip(rect2)
+            expected_mask.clear()
+
+            # Normally draw() could be used to set these bits, but the draw()
+            # method is being tested here, so a loop is used instead.
+            for x in range(overlap_rect.left, overlap_rect.right):
+                for y in range(overlap_rect.top, overlap_rect.bottom):
+                    expected_mask.set_at((x, y))
+            mask1.clear()  # Ensure it's empty for testing each offset.
+
+            mask1.draw(mask2, offset)
+
+            assertMaskEqual(self, mask1, expected_mask, msg)
+
+    def test_draw__offset_boundary(self):
+        """Ensures draw handles offsets and boundaries correctly."""
+        mask1 = pygame.mask.Mask((13, 5))
+        mask2 = pygame.mask.Mask((7, 3), fill=True)
+        mask1_count = mask1.count()
+        mask2_count = mask2.count()
+        mask1_size = mask1.get_size()
+        mask2_size = mask2.get_size()
+
+        # Check the 4 boundaries.
+        offsets = (
+            (mask1_size[0], 0),  # off right
+            (0, mask1_size[1]),  # off bottom
+            (-mask2_size[0], 0),  # off left
+            (0, -mask2_size[1]),
+        )  # off top
+
+        for offset in offsets:
+            msg = f"offset={offset}"
+
+            mask1.draw(mask2, offset)
+
+            # Ensure mask1/mask2 unchanged.
+            self.assertEqual(mask1.count(), mask1_count, msg)
+            self.assertEqual(mask2.count(), mask2_count, msg)
+            self.assertEqual(mask1.get_size(), mask1_size, msg)
+            self.assertEqual(mask2.get_size(), mask2_size, msg)
+
+    @unittest.skipIf(IS_PYPY, "Segfaults on pypy")
+    def test_draw__bit_boundaries(self):
+        """Ensures draw handles masks of different sizes correctly.
+
+        Tests masks of different sizes, including:
+           -masks 31 to 33 bits wide (32 bit boundaries)
+           -masks 63 to 65 bits wide (64 bit boundaries)
+        """
+        for height in range(2, 4):
+            for width in range(2, 66):
+                mask_size = (width, height)
+                mask_count = width * height
+                mask1 = pygame.mask.Mask(mask_size)
+                mask2 = pygame.mask.Mask(mask_size, fill=True)
+                expected_mask = pygame.Mask(mask_size)
+
+                # Using rects to help determine the overlapping area.
+                rect1 = mask1.get_rect()
+                rect2 = mask2.get_rect()
+
+                # Testing masks offset from each other.
+                for offset in self.ORIGIN_OFFSETS:
+                    msg = f"size={mask_size}, offset={offset}"
+                    rect2.topleft = offset
+                    overlap_rect = rect1.clip(rect2)
+                    expected_mask.clear()
+
+                    # Normally draw() could be used to set these bits, but the
+                    # draw() method is being tested here, so a loop is used
+                    # instead.
+                    for x in range(overlap_rect.left, overlap_rect.right):
+                        for y in range(overlap_rect.top, overlap_rect.bottom):
+                            expected_mask.set_at((x, y))
+                    mask1.clear()  # Ensure it's empty for each test.
+
+                    mask1.draw(mask2, offset)
+
+                    assertMaskEqual(self, mask1, expected_mask, msg)
+
+                    # Ensure mask2 unchanged.
+                    self.assertEqual(mask2.count(), mask_count, msg)
+                    self.assertEqual(mask2.get_size(), mask_size, msg)
+
+    def test_draw__invalid_mask_arg(self):
+        """Ensure draw handles invalid mask arguments correctly."""
+        size = (7, 3)
+        offset = (0, 0)
+        mask = pygame.mask.Mask(size)
+        invalid_mask = pygame.Surface(size)
+
+        with self.assertRaises(TypeError):
+            mask.draw(invalid_mask, offset)
+
+    def test_draw__invalid_offset_arg(self):
+        """Ensure draw handles invalid offset arguments correctly."""
+        size = (5, 7)
+        offset = "(0, 0)"
+        mask1 = pygame.mask.Mask(size)
+        mask2 = pygame.mask.Mask(size)
+
+        with self.assertRaises(TypeError):
+            mask1.draw(mask2, offset)
+
+    def test_erase(self):
+        """Ensure a mask can erase another mask.
+
+        Testing the different combinations of full/empty masks:
+            (mask1-filled) 1 erase 1 (mask2-filled)
+            (mask1-empty)  0 erase 1 (mask2-filled)
+            (mask1-filled) 1 erase 0 (mask2-empty)
+            (mask1-empty)  0 erase 0 (mask2-empty)
+        """
+        expected_size = (4, 4)
+        offset = (0, 0)
+        expected_default = pygame.mask.Mask(expected_size)
+        expected_masks = {(True, False): pygame.mask.Mask(expected_size, fill=True)}
+
+        for fill2 in (True, False):
+            mask2 = pygame.mask.Mask(expected_size, fill=fill2)
+            mask2_count = mask2.count()
+
+            for fill1 in (True, False):
+                key = (fill1, fill2)
+                msg = f"key={key}"
+                mask1 = pygame.mask.Mask(expected_size, fill=fill1)
+                expected_mask = expected_masks.get(key, expected_default)
+
+                mask1.erase(mask2, offset)
+
+                assertMaskEqual(self, mask1, expected_mask, msg)
+
+                # Ensure mask2 unchanged.
+                self.assertEqual(mask2.count(), mask2_count, msg)
+                self.assertEqual(mask2.get_size(), expected_size, msg)
+
+    def test_erase__offset(self):
+        """Ensure an offset mask can erase another mask."""
+        mask1 = pygame.mask.Mask((65, 3))
+        mask2 = pygame.mask.Mask((66, 4), fill=True)
+        mask2_count = mask2.count()
+        mask2_size = mask2.get_size()
+        expected_mask = pygame.Mask(mask1.get_size())
+
+        # Using rects to help determine the overlapping area.
+        rect1 = mask1.get_rect()
+        rect2 = mask2.get_rect()
+
+        for offset in self.ORIGIN_OFFSETS:
+            msg = f"offset={offset}"
+            rect2.topleft = offset
+            overlap_rect = rect1.clip(rect2)
+            expected_mask.fill()
+
+            # Normally erase() could be used to clear these bits, but the
+            # erase() method is being tested here, so a loop is used instead.
+            for x in range(overlap_rect.left, overlap_rect.right):
+                for y in range(overlap_rect.top, overlap_rect.bottom):
+                    expected_mask.set_at((x, y), 0)
+            mask1.fill()  # Ensure it's filled for testing each offset.
+
+            mask1.erase(other=mask2, offset=offset)
+
+            assertMaskEqual(self, mask1, expected_mask, msg)
+
+            # Ensure mask2 unchanged.
+            self.assertEqual(mask2.count(), mask2_count, msg)
+            self.assertEqual(mask2.get_size(), mask2_size, msg)
+
+    def test_erase__specific_offsets(self):
+        """Ensure an offset mask can erase another mask.
+
+        Testing the specific case of:
+            -both masks are wider than 32 bits
+            -a positive offset is used
+            -the mask calling erase() is wider than the mask passed in
+        """
+        mask1 = pygame.mask.Mask((65, 5))
+        mask2 = pygame.mask.Mask((33, 3), fill=True)
+        expected_mask = pygame.Mask(mask1.get_size())
+
+        # Using rects to help determine the overlapping area.
+        rect1 = mask1.get_rect()
+        rect2 = mask2.get_rect()
+
+        # This rect's corners are used to move rect2 around the inside of
+        # rect1.
+        corner_rect = rect1.inflate(-2, -2)
+
+        for corner in ("topleft", "topright", "bottomright", "bottomleft"):
+            setattr(rect2, corner, getattr(corner_rect, corner))
+            offset = rect2.topleft
+            msg = f"offset={offset}"
+            overlap_rect = rect1.clip(rect2)
+            expected_mask.fill()
+
+            # Normally erase() could be used to clear these bits, but the
+            # erase() method is being tested here, so a loop is used instead.
+            for x in range(overlap_rect.left, overlap_rect.right):
+                for y in range(overlap_rect.top, overlap_rect.bottom):
+                    expected_mask.set_at((x, y), 0)
+            mask1.fill()  # Ensure it's filled for testing each offset.
+
+            mask1.erase(mask2, Vector2(offset))
+
+            assertMaskEqual(self, mask1, expected_mask, msg)
+
+    def test_erase__offset_boundary(self):
+        """Ensures erase handles offsets and boundaries correctly."""
+        mask1 = pygame.mask.Mask((7, 11), fill=True)
+        mask2 = pygame.mask.Mask((3, 13), fill=True)
+        mask1_count = mask1.count()
+        mask2_count = mask2.count()
+        mask1_size = mask1.get_size()
+        mask2_size = mask2.get_size()
+
+        # Check the 4 boundaries.
+        offsets = (
+            (mask1_size[0], 0),  # off right
+            (0, mask1_size[1]),  # off bottom
+            (-mask2_size[0], 0),  # off left
+            (0, -mask2_size[1]),
+        )  # off top
+
+        for offset in offsets:
+            msg = f"offset={offset}"
+
+            mask1.erase(mask2, offset)
+
+            # Ensure mask1/mask2 unchanged.
+            self.assertEqual(mask1.count(), mask1_count, msg)
+            self.assertEqual(mask2.count(), mask2_count, msg)
+            self.assertEqual(mask1.get_size(), mask1_size, msg)
+            self.assertEqual(mask2.get_size(), mask2_size, msg)
+
+    @unittest.skipIf(IS_PYPY, "Segfaults on pypy")
+    def test_erase__bit_boundaries(self):
+        """Ensures erase handles masks of different sizes correctly.
+
+        Tests masks of different sizes, including:
+           -masks 31 to 33 bits wide (32 bit boundaries)
+           -masks 63 to 65 bits wide (64 bit boundaries)
+        """
+        for height in range(2, 4):
+            for width in range(2, 66):
+                mask_size = (width, height)
+                mask_count = width * height
+                mask1 = pygame.mask.Mask(mask_size)
+                mask2 = pygame.mask.Mask(mask_size, fill=True)
+                expected_mask = pygame.Mask(mask_size)
+
+                # Using rects to help determine the overlapping area.
+                rect1 = mask1.get_rect()
+                rect2 = mask2.get_rect()
+
+                # Testing masks offset from each other.
+                for offset in self.ORIGIN_OFFSETS:
+                    msg = f"size={mask_size}, offset={offset}"
+                    rect2.topleft = offset
+                    overlap_rect = rect1.clip(rect2)
+                    expected_mask.fill()
+
+                    # Normally erase() could be used to clear these bits, but
+                    # the erase() method is being tested here, so a loop is
+                    # used instead.
+                    for x in range(overlap_rect.left, overlap_rect.right):
+                        for y in range(overlap_rect.top, overlap_rect.bottom):
+                            expected_mask.set_at((x, y), 0)
+                    mask1.fill()  # Ensure it's filled for each test.
+
+                    mask1.erase(mask2, offset)
+
+                    assertMaskEqual(self, mask1, expected_mask, msg)
+
+                    # Ensure mask2 unchanged.
+                    self.assertEqual(mask2.count(), mask_count, msg)
+                    self.assertEqual(mask2.get_size(), mask_size, msg)
+
+    def test_erase__invalid_mask_arg(self):
+        """Ensure erase handles invalid mask arguments correctly."""
+        size = (3, 7)
+        offset = (0, 0)
+        mask = pygame.mask.Mask(size)
+        invalid_mask = pygame.Surface(size)
+
+        with self.assertRaises(TypeError):
+            mask.erase(invalid_mask, offset)
+
+    def test_erase__invalid_offset_arg(self):
+        """Ensure erase handles invalid offset arguments correctly."""
+        size = (7, 5)
+        offset = "(0, 0)"
+        mask1 = pygame.mask.Mask(size)
+        mask2 = pygame.mask.Mask(size)
+
+        with self.assertRaises(TypeError):
+            mask1.erase(mask2, offset)
+
+    def test_count(self):
+        """Ensure a mask's set bits are correctly counted."""
+        side = 67
+        expected_size = (side, side)
+        expected_count = 0
+        mask = pygame.mask.Mask(expected_size)
+
+        for i in range(side):
+            expected_count += 1
+            mask.set_at((i, i))
+
+        count = mask.count()
+
+        self.assertEqual(count, expected_count)
+        self.assertEqual(mask.get_size(), expected_size)
+
+    @unittest.skipIf(IS_PYPY, "Segfaults on pypy")
+    def test_count__bit_boundaries(self):
+        """Ensures the set bits of different sized masks are counted correctly.
+
+        Tests masks of different sizes, including:
+           -masks 31 to 33 bits wide (32 bit boundaries)
+           -masks 63 to 65 bits wide (64 bit boundaries)
+        """
+        for fill in (True, False):
+            for height in range(1, 4):
+                for width in range(1, 66):
+                    mask = pygame.mask.Mask((width, height), fill=fill)
+                    expected_count = width * height if fill else 0
+
+                    # Test toggling each bit.
+                    for pos in ((x, y) for y in range(height) for x in range(width)):
+                        if fill:
+                            mask.set_at(pos, 0)
+                            expected_count -= 1
+                        else:
+                            mask.set_at(pos, 1)
+                            expected_count += 1
+
+                        count = mask.count()
+
+                        self.assertEqual(
+                            count,
+                            expected_count,
+                            f"fill={fill}, size=({width}, {height}), pos={pos}",
+                        )
+
+    def test_count__full_mask(self):
+        """Ensure a full mask's set bits are correctly counted."""
+        width, height = 17, 97
+        expected_size = (width, height)
+        expected_count = width * height
+        mask = pygame.mask.Mask(expected_size, fill=True)
+
+        count = mask.count()
+
+        self.assertEqual(count, expected_count)
+        self.assertEqual(mask.get_size(), expected_size)
+
+    def test_count__empty_mask(self):
+        """Ensure an empty mask's set bits are correctly counted."""
+        expected_count = 0
+        expected_size = (13, 27)
+        mask = pygame.mask.Mask(expected_size)
+
+        count = mask.count()
+
+        self.assertEqual(count, expected_count)
+        self.assertEqual(mask.get_size(), expected_size)
+
+    def test_centroid(self):
+        """Ensure a filled mask's centroid is correctly calculated."""
+        mask = pygame.mask.Mask((5, 7), fill=True)
+        expected_centroid = mask.get_rect().center
+
+        centroid = mask.centroid()
+
+        self.assertEqual(centroid, expected_centroid)
+
+    def test_centroid__empty_mask(self):
+        """Ensure an empty mask's centroid is correctly calculated."""
+        expected_centroid = (0, 0)
+        expected_size = (101, 103)
+        mask = pygame.mask.Mask(expected_size)
+
+        centroid = mask.centroid()
+
+        self.assertEqual(centroid, expected_centroid)
+        self.assertEqual(mask.get_size(), expected_size)
+
+    def test_centroid__single_row(self):
+        """Ensure a mask's centroid is correctly calculated
+        when setting points along a single row."""
+        width, height = (5, 7)
+        mask = pygame.mask.Mask((width, height))
+
+        for y in range(height):
+            mask.clear()  # Clear for each row.
+
+            for x in range(width):
+                mask.set_at((x, y))
+                expected_centroid = (x // 2, y)
+
+                centroid = mask.centroid()
+
+                self.assertEqual(centroid, expected_centroid)
+
+    def test_centroid__two_rows(self):
+        """Ensure a mask's centroid is correctly calculated
+        when setting points along two rows."""
+        width, height = (5, 7)
+        mask = pygame.mask.Mask((width, height))
+
+        # The first row is tested with each of the other rows.
+        for y in range(1, height):
+            mask.clear()  # Clear for each set of rows.
+
+            for x in range(width):
+                mask.set_at((x, 0))
+                mask.set_at((x, y))
+                expected_centroid = (x // 2, y // 2)
+
+                centroid = mask.centroid()
+
+                self.assertEqual(centroid, expected_centroid)
+
+    def test_centroid__single_column(self):
+        """Ensure a mask's centroid is correctly calculated
+        when setting points along a single column."""
+        width, height = (5, 7)
+        mask = pygame.mask.Mask((width, height))
+
+        for x in range(width):
+            mask.clear()  # Clear for each column.
+
+            for y in range(height):
+                mask.set_at((x, y))
+                expected_centroid = (x, y // 2)
+
+                centroid = mask.centroid()
+
+                self.assertEqual(centroid, expected_centroid)
+
+    def test_centroid__two_columns(self):
+        """Ensure a mask's centroid is correctly calculated
+        when setting points along two columns."""
+        width, height = (5, 7)
+        mask = pygame.mask.Mask((width, height))
+
+        # The first column is tested with each of the other columns.
+        for x in range(1, width):
+            mask.clear()  # Clear for each set of columns.
+
+            for y in range(height):
+                mask.set_at((0, y))
+                mask.set_at((x, y))
+                expected_centroid = (x // 2, y // 2)
+
+                centroid = mask.centroid()
+
+                self.assertEqual(centroid, expected_centroid)
+
+    def test_centroid__all_corners(self):
+        """Ensure a mask's centroid is correctly calculated
+        when its corners are set."""
+        mask = pygame.mask.Mask((5, 7))
+        expected_centroid = mask.get_rect().center
+
+        for corner in corners(mask):
+            mask.set_at(corner)
+
+        centroid = mask.centroid()
+
+        self.assertEqual(centroid, expected_centroid)
+
+    def test_centroid__two_corners(self):
+        """Ensure a mask's centroid is correctly calculated
+        when only two corners are set."""
+        mask = pygame.mask.Mask((5, 7))
+        mask_rect = mask.get_rect()
+        mask_corners = corners(mask)
+
+        for i, corner1 in enumerate(mask_corners):
+            for corner2 in mask_corners[i + 1 :]:
+                mask.clear()  # Clear for each pair of corners.
+                mask.set_at(corner1)
+                mask.set_at(corner2)
+
+                if corner1[0] == corner2[0]:
+                    expected_centroid = (corner1[0], abs(corner1[1] - corner2[1]) // 2)
+                elif corner1[1] == corner2[1]:
+                    expected_centroid = (abs(corner1[0] - corner2[0]) // 2, corner1[1])
+                else:
+                    expected_centroid = mask_rect.center
+
+                centroid = mask.centroid()
+
+                self.assertEqual(centroid, expected_centroid)
+
+    def test_angle(self):
+        """Ensure a mask's orientation angle is correctly calculated."""
+        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."""
+        expected_angle = 0.0
+        expected_size = (107, 43)
+        mask = pygame.mask.Mask(expected_size)
+
+        angle = mask.angle()
+
+        self.assertIsInstance(angle, float)
+        self.assertAlmostEqual(angle, expected_angle)
+        self.assertEqual(mask.get_size(), expected_size)
+
+    def test_drawing(self):
+        """Test fill, clear, invert, draw, erase"""
+        m = pygame.Mask((100, 100))
+        self.assertEqual(m.count(), 0)
+
+        m.fill()
+        self.assertEqual(m.count(), 10000)
+
+        m2 = pygame.Mask((10, 10), fill=True)
+        m.erase(m2, (50, 50))
+        self.assertEqual(m.count(), 9900)
+
+        m.invert()
+        self.assertEqual(m.count(), 100)
+
+        m.draw(m2, (0, 0))
+        self.assertEqual(m.count(), 200)
+
+        m.clear()
+        self.assertEqual(m.count(), 0)
+
+    def test_outline(self):
+        """ """
+
+        m = pygame.Mask((20, 20))
+        self.assertEqual(m.outline(), [])
+
+        m.set_at((10, 10), 1)
+        self.assertEqual(m.outline(), [(10, 10)])
+
+        m.set_at((10, 12), 1)
+        self.assertEqual(m.outline(10), [(10, 10)])
+
+        m.set_at((11, 11), 1)
+        self.assertEqual(
+            m.outline(), [(10, 10), (11, 11), (10, 12), (11, 11), (10, 10)]
+        )
+        self.assertEqual(m.outline(every=2), [(10, 10), (10, 12), (10, 10)])
+
+        # TODO: Test more corner case outlines.
+
+    def test_convolve__size(self):
+        sizes = [(1, 1), (31, 31), (32, 32), (100, 100)]
+        for s1 in sizes:
+            m1 = pygame.Mask(s1)
+            for s2 in sizes:
+                m2 = pygame.Mask(s2)
+                o = m1.convolve(m2)
+
+                self.assertIsInstance(o, pygame.mask.Mask)
+
+                for i in (0, 1):
+                    self.assertEqual(
+                        o.get_size()[i], m1.get_size()[i] + m2.get_size()[i] - 1
+                    )
+
+    def test_convolve__point_identities(self):
+        """Convolving with a single point is the identity, while convolving a point with something flips it."""
+        m = random_mask((100, 100))
+        k = pygame.Mask((1, 1))
+        k.set_at((0, 0))
+
+        convolve_mask = m.convolve(k)
+
+        self.assertIsInstance(convolve_mask, pygame.mask.Mask)
+        assertMaskEqual(self, m, convolve_mask)
+
+        convolve_mask = k.convolve(k.convolve(m))
+
+        self.assertIsInstance(convolve_mask, pygame.mask.Mask)
+        assertMaskEqual(self, m, convolve_mask)
+
+    def test_convolve__with_output(self):
+        """checks that convolution modifies only the correct portion of the output"""
+
+        m = random_mask((10, 10))
+        k = pygame.Mask((2, 2))
+        k.set_at((0, 0))
+
+        o = pygame.Mask((50, 50))
+        test = pygame.Mask((50, 50))
+
+        m.convolve(k, o)
+        test.draw(m, (1, 1))
+
+        self.assertIsInstance(o, pygame.mask.Mask)
+        assertMaskEqual(self, o, test)
+
+        o.clear()
+        test.clear()
+
+        m.convolve(other=k, output=o, offset=Vector2(10, 10))
+        test.draw(m, (11, 11))
+
+        self.assertIsInstance(o, pygame.mask.Mask)
+        assertMaskEqual(self, o, test)
+
+    def test_convolve__out_of_range(self):
+        full = pygame.Mask((2, 2), fill=True)
+        # Tuple of points (out of range) and the expected count for each.
+        pts_data = (((0, 3), 0), ((0, 2), 3), ((-2, -2), 1), ((-3, -3), 0))
+
+        for pt, expected_count in pts_data:
+            convolve_mask = full.convolve(full, None, pt)
+
+            self.assertIsInstance(convolve_mask, pygame.mask.Mask)
+            self.assertEqual(convolve_mask.count(), expected_count)
+
+    @unittest.skipIf(IS_PYPY, "Segfaults on pypy")
+    def test_convolve(self):
+        """Tests the definition of convolution"""
+        m1 = random_mask((100, 100))
+        m2 = random_mask((100, 100))
+        conv = m1.convolve(m2)
+
+        self.assertIsInstance(conv, pygame.mask.Mask)
+        for i in range(conv.get_size()[0]):
+            for j in range(conv.get_size()[1]):
+                self.assertEqual(
+                    conv.get_at((i, j)) == 0, m1.overlap(m2, (i - 99, j - 99)) is None
+                )
+
+    def _draw_component_pattern_box(self, mask, size, pos, inverse=False):
+        # Helper method to create/draw a 'box' pattern for testing.
+        #
+        # 111
+        # 101  3x3 example pattern
+        # 111
+        pattern = pygame.mask.Mask((size, size), fill=True)
+        pattern.set_at((size // 2, size // 2), 0)
+
+        if inverse:
+            mask.erase(pattern, pos)
+            pattern.invert()
+        else:
+            mask.draw(pattern, pos)
+
+        return pattern
+
+    def _draw_component_pattern_x(self, mask, size, pos, inverse=False):
+        # Helper method to create/draw an 'X' pattern for testing.
+        #
+        # 101
+        # 010  3x3 example pattern
+        # 101
+        pattern = pygame.mask.Mask((size, size))
+
+        ymax = size - 1
+        for y in range(size):
+            for x in range(size):
+                if x in [y, ymax - y]:
+                    pattern.set_at((x, y))
+
+        if inverse:
+            mask.erase(pattern, pos)
+            pattern.invert()
+        else:
+            mask.draw(pattern, pos)
+
+        return pattern
+
+    def _draw_component_pattern_plus(self, mask, size, pos, inverse=False):
+        # Helper method to create/draw a '+' pattern for testing.
+        #
+        # 010
+        # 111  3x3 example pattern
+        # 010
+        pattern = pygame.mask.Mask((size, size))
+
+        xmid = ymid = size // 2
+        for y in range(size):
+            for x in range(size):
+                if x == xmid or y == ymid:
+                    pattern.set_at((x, y))
+
+        if inverse:
+            mask.erase(pattern, pos)
+            pattern.invert()
+        else:
+            mask.draw(pattern, pos)
+
+        return pattern
+
+    def test_connected_component(self):
+        """Ensure a mask's connected component is correctly calculated."""
+        width, height = 41, 27
+        expected_size = (width, height)
+        original_mask = pygame.mask.Mask(expected_size)
+        patterns = []  # Patterns and offsets.
+
+        # Draw some connected patterns on the original mask.
+        offset = (0, 0)
+        pattern = self._draw_component_pattern_x(original_mask, 3, offset)
+        patterns.append((pattern, offset))
+
+        size = 4
+        offset = (width - size, 0)
+        pattern = self._draw_component_pattern_plus(original_mask, size, offset)
+        patterns.append((pattern, offset))
+
+        # Make this one the largest connected component.
+        offset = (width // 2, height // 2)
+        pattern = self._draw_component_pattern_box(original_mask, 7, offset)
+        patterns.append((pattern, offset))
+
+        expected_pattern, expected_offset = patterns[-1]
+        expected_count = expected_pattern.count()
+        original_count = sum(p.count() for p, _ in patterns)
+
+        mask = original_mask.connected_component()
+
+        self.assertIsInstance(mask, pygame.mask.Mask)
+        self.assertEqual(mask.count(), expected_count)
+        self.assertEqual(mask.get_size(), expected_size)
+        self.assertEqual(
+            mask.overlap_area(expected_pattern, expected_offset), expected_count
+        )
+
+        # Ensure the original mask is unchanged.
+        self.assertEqual(original_mask.count(), original_count)
+        self.assertEqual(original_mask.get_size(), expected_size)
+
+        for pattern, offset in patterns:
+            self.assertEqual(
+                original_mask.overlap_area(pattern, offset), pattern.count()
+            )
+
+    def test_connected_component__full_mask(self):
+        """Ensure a mask's connected component is correctly calculated
+        when the mask is full.
+        """
+        expected_size = (23, 31)
+        original_mask = pygame.mask.Mask(expected_size, fill=True)
+        expected_count = original_mask.count()
+
+        mask = original_mask.connected_component()
+
+        self.assertIsInstance(mask, pygame.mask.Mask)
+        self.assertEqual(mask.count(), expected_count)
+        self.assertEqual(mask.get_size(), expected_size)
+
+        # Ensure the original mask is unchanged.
+        self.assertEqual(original_mask.count(), expected_count)
+        self.assertEqual(original_mask.get_size(), expected_size)
+
+    def test_connected_component__empty_mask(self):
+        """Ensure a mask's connected component is correctly calculated
+        when the mask is empty.
+        """
+        expected_size = (37, 43)
+        original_mask = pygame.mask.Mask(expected_size)
+        original_count = original_mask.count()
+        expected_count = 0
+
+        mask = original_mask.connected_component()
+
+        self.assertIsInstance(mask, pygame.mask.Mask)
+        self.assertEqual(mask.count(), expected_count)
+        self.assertEqual(mask.get_size(), expected_size)
+
+        # Ensure the original mask is unchanged.
+        self.assertEqual(original_mask.count(), original_count)
+        self.assertEqual(original_mask.get_size(), expected_size)
+
+    def test_connected_component__one_set_bit(self):
+        """Ensure a mask's connected component is correctly calculated
+        when the coordinate's bit is set with a connected component of 1 bit.
+        """
+        width, height = 71, 67
+        expected_size = (width, height)
+        original_mask = pygame.mask.Mask(expected_size, fill=True)
+        xset, yset = width // 2, height // 2
+        set_pos = (xset, yset)
+        expected_offset = (xset - 1, yset - 1)
+
+        # This isolates the bit at set_pos from all the other bits.
+        expected_pattern = self._draw_component_pattern_box(
+            original_mask, 3, expected_offset, inverse=True
+        )
+        expected_count = 1
+        original_count = original_mask.count()
+
+        mask = original_mask.connected_component(set_pos)
+
+        self.assertIsInstance(mask, pygame.mask.Mask)
+        self.assertEqual(mask.count(), expected_count)
+        self.assertEqual(mask.get_size(), expected_size)
+        self.assertEqual(
+            mask.overlap_area(expected_pattern, expected_offset), expected_count
+        )
+
+        # Ensure the original mask is unchanged.
+        self.assertEqual(original_mask.count(), original_count)
+        self.assertEqual(original_mask.get_size(), expected_size)
+        self.assertEqual(
+            original_mask.overlap_area(expected_pattern, expected_offset),
+            expected_count,
+        )
+
+    def test_connected_component__multi_set_bits(self):
+        """Ensure a mask's connected component is correctly calculated
+        when the coordinate's bit is set with a connected component of > 1 bit.
+        """
+        expected_size = (113, 67)
+        original_mask = pygame.mask.Mask(expected_size)
+        p_width, p_height = 11, 13
+        set_pos = xset, yset = 11, 21
+        expected_offset = (xset - 1, yset - 1)
+        expected_pattern = pygame.mask.Mask((p_width, p_height), fill=True)
+
+        # Make an unsymmetrical pattern. All the set bits need to be connected
+        # in the resulting pattern for this to work properly.
+        for y in range(3, p_height):
+            for x in range(1, p_width):
+                if x in [y, y - 3, p_width - 4]:
+                    expected_pattern.set_at((x, y), 0)
+
+        expected_count = expected_pattern.count()
+        original_mask.draw(expected_pattern, expected_offset)
+
+        mask = original_mask.connected_component(set_pos)
+
+        self.assertIsInstance(mask, pygame.mask.Mask)
+        self.assertEqual(mask.count(), expected_count)
+        self.assertEqual(mask.get_size(), expected_size)
+        self.assertEqual(
+            mask.overlap_area(expected_pattern, expected_offset), expected_count
+        )
+
+        # Ensure the original mask is unchanged.
+        self.assertEqual(original_mask.count(), expected_count)
+        self.assertEqual(original_mask.get_size(), expected_size)
+        self.assertEqual(
+            original_mask.overlap_area(expected_pattern, expected_offset),
+            expected_count,
+        )
+
+    def test_connected_component__unset_bit(self):
+        """Ensure a mask's connected component is correctly calculated
+        when the coordinate's bit is unset.
+        """
+        width, height = 109, 101
+        expected_size = (width, height)
+        original_mask = pygame.mask.Mask(expected_size, fill=True)
+        unset_pos = (width // 2, height // 2)
+        original_mask.set_at(unset_pos, 0)
+        original_count = original_mask.count()
+        expected_count = 0
+
+        mask = original_mask.connected_component(unset_pos)
+
+        self.assertIsInstance(mask, pygame.mask.Mask)
+        self.assertEqual(mask.count(), expected_count)
+        self.assertEqual(mask.get_size(), expected_size)
+
+        # Ensure the original mask is unchanged.
+        self.assertEqual(original_mask.count(), original_count)
+        self.assertEqual(original_mask.get_size(), expected_size)
+        self.assertEqual(original_mask.get_at(unset_pos), 0)
+
+    def test_connected_component__out_of_bounds(self):
+        """Ensure connected_component() checks bounds."""
+        width, height = 19, 11
+        original_size = (width, height)
+        original_mask = pygame.mask.Mask(original_size, fill=True)
+        original_count = original_mask.count()
+
+        for pos in ((0, -1), (-1, 0), (0, height + 1), (width + 1, 0)):
+            with self.assertRaises(IndexError):
+                mask = original_mask.connected_component(pos)
+
+            # Ensure the original mask is unchanged.
+            self.assertEqual(original_mask.count(), original_count)
+            self.assertEqual(original_mask.get_size(), original_size)
+
+    def test_connected_components(self):
+        """ """
+        m = pygame.Mask((10, 10))
+
+        self.assertListEqual(m.connected_components(), [])
+
+        comp = m.connected_component()
+
+        self.assertEqual(m.count(), comp.count())
+
+        m.set_at((0, 0), 1)
+        m.set_at((1, 1), 1)
+        comp = m.connected_component()
+        comps = m.connected_components()
+        comps1 = m.connected_components(1)
+        comps2 = m.connected_components(2)
+        comps3 = m.connected_components(3)
+
+        self.assertEqual(comp.count(), comps[0].count())
+        self.assertEqual(comps1[0].count(), 2)
+        self.assertEqual(comps2[0].count(), 2)
+        self.assertListEqual(comps3, [])
+
+        m.set_at((9, 9), 1)
+        comp = m.connected_component()
+        comp1 = m.connected_component((1, 1))
+        comp2 = m.connected_component((2, 2))
+        comps = m.connected_components()
+        comps1 = m.connected_components(1)
+        comps2 = m.connected_components(minimum=2)
+        comps3 = m.connected_components(3)
+
+        self.assertEqual(comp.count(), 2)
+        self.assertEqual(comp1.count(), 2)
+        self.assertEqual(comp2.count(), 0)
+        self.assertEqual(len(comps), 2)
+        self.assertEqual(len(comps1), 2)
+        self.assertEqual(len(comps2), 1)
+        self.assertEqual(len(comps3), 0)
+
+        for mask in comps:
+            self.assertIsInstance(mask, pygame.mask.Mask)
+
+    def test_connected_components__negative_min_with_empty_mask(self):
+        """Ensures connected_components() properly handles negative min values
+        when the mask is empty.
+
+        Negative and zero values for the min parameter (minimum number of bits
+        per connected component) equate to setting it to one.
+        """
+        expected_comps = []
+        mask_count = 0
+        mask_size = (65, 13)
+        mask = pygame.mask.Mask(mask_size)
+
+        connected_comps = mask.connected_components(-1)
+
+        self.assertListEqual(connected_comps, expected_comps)
+
+        # Ensure the original mask is unchanged.
+        self.assertEqual(mask.count(), mask_count)
+        self.assertEqual(mask.get_size(), mask_size)
+
+    def test_connected_components__negative_min_with_full_mask(self):
+        """Ensures connected_components() properly handles negative min values
+        when the mask is full.
+
+        Negative and zero values for the min parameter (minimum number of bits
+        per connected component) equate to setting it to one.
+        """
+        mask_size = (64, 11)
+        mask = pygame.mask.Mask(mask_size, fill=True)
+        mask_count = mask.count()
+        expected_len = 1
+
+        connected_comps = mask.connected_components(-2)
+
+        self.assertEqual(len(connected_comps), expected_len)
+        assertMaskEqual(self, connected_comps[0], mask)
+
+        # Ensure the original mask is unchanged.
+        self.assertEqual(mask.count(), mask_count)
+        self.assertEqual(mask.get_size(), mask_size)
+
+    def test_connected_components__negative_min_with_some_bits_set(self):
+        """Ensures connected_components() properly handles negative min values
+        when the mask has some bits set.
+
+        Negative and zero values for the min parameter (minimum number of bits
+        per connected component) equate to setting it to one.
+        """
+        mask_size = (64, 12)
+        mask = pygame.mask.Mask(mask_size)
+        expected_comps = {}
+
+        # Set the corners and the center positions. A new expected component
+        # mask is created for each point.
+        for corner in corners(mask):
+            mask.set_at(corner)
+
+            new_mask = pygame.mask.Mask(mask_size)
+            new_mask.set_at(corner)
+            expected_comps[corner] = new_mask
+
+        center = (mask_size[0] // 2, mask_size[1] // 2)
+        mask.set_at(center)
+
+        new_mask = pygame.mask.Mask(mask_size)
+        new_mask.set_at(center)
+        expected_comps[center] = new_mask
+        mask_count = mask.count()
+
+        connected_comps = mask.connected_components(-3)
+
+        self.assertEqual(len(connected_comps), len(expected_comps))
+
+        for comp in connected_comps:
+            # Since the masks in the connected component list can be in any
+            # order, loop the expected components to find its match.
+            found = False
+
+            for pt in tuple(expected_comps.keys()):
+                if comp.get_at(pt):
+                    found = True
+                    assertMaskEqual(self, comp, expected_comps[pt])
+                    del expected_comps[pt]  # Entry removed so it isn't reused.
+                    break
+
+            self.assertTrue(found, f"missing component for pt={pt}")
+
+        # Ensure the original mask is unchanged.
+        self.assertEqual(mask.count(), mask_count)
+        self.assertEqual(mask.get_size(), mask_size)
+
+    @unittest.skipIf(IS_PYPY, "Segfaults on pypy")
+    def test_get_bounding_rects(self):
+        """Ensures get_bounding_rects works correctly."""
+        # Create masks with different set point groups. Each group of
+        # connected set points will be contained in its own bounding rect.
+        # Diagonal points are considered connected.
+        mask_data = []  # [((size), ((rect1_pts), ...)), ...]
+
+        # Mask 1:
+        #  |0123456789
+        # -+----------
+        # 0|1100000000
+        # 1|1000000000
+        # 2|0000000000
+        # 3|1001000000
+        # 4|0000000000
+        # 5|0000000000
+        # 6|0000000000
+        # 7|0000000000
+        # 8|0000000000
+        # 9|0000000000
+        mask_data.append(
+            (
+                (10, 10),  # size
+                # Points to set for the 3 bounding rects.
+                (((0, 0), (1, 0), (0, 1)), ((0, 3),), ((3, 3),)),  # rect1  # rect2
+            )
+        )  # rect3
+
+        # Mask 2:
+        #  |0123
+        # -+----
+        # 0|1100
+        # 1|1111
+        mask_data.append(
+            (
+                (4, 2),  # size
+                # Points to set for the 1 bounding rect.
+                (((0, 0), (1, 0), (0, 1), (1, 1), (2, 1), (3, 1)),),
+            )
+        )
+
+        # Mask 3:
+        #  |01234
+        # -+-----
+        # 0|00100
+        # 1|01110
+        # 2|00100
+        mask_data.append(
+            (
+                (5, 3),  # size
+                # Points to set for the 1 bounding rect.
+                (((2, 0), (1, 1), (2, 1), (3, 1), (2, 2)),),
+            )
+        )
+
+        # Mask 4:
+        #  |01234
+        # -+-----
+        # 0|00010
+        # 1|00100
+        # 2|01000
+        mask_data.append(
+            (
+                (5, 3),  # size
+                # Points to set for the 1 bounding rect.
+                (((3, 0), (2, 1), (1, 2)),),
+            )
+        )
+
+        # Mask 5:
+        #  |01234
+        # -+-----
+        # 0|00011
+        # 1|11111
+        mask_data.append(
+            (
+                (5, 2),  # size
+                # Points to set for the 1 bounding rect.
+                (((3, 0), (4, 0), (0, 1), (1, 1), (2, 1), (3, 1)),),
+            )
+        )
+
+        # Mask 6:
+        #  |01234
+        # -+-----
+        # 0|10001
+        # 1|00100
+        # 2|10001
+        mask_data.append(
+            (
+                (5, 3),  # size
+                # Points to set for the 5 bounding rects.
+                (
+                    ((0, 0),),  # rect1
+                    ((4, 0),),  # rect2
+                    ((2, 1),),  # rect3
+                    ((0, 2),),  # rect4
+                    ((4, 2),),
+                ),
+            )
+        )  # rect5
+
+        for size, rect_point_tuples in mask_data:
+            rects = []
+            mask = pygame.Mask(size)
+
+            for rect_points in rect_point_tuples:
+                rects.append(create_bounding_rect(rect_points))
+                for pt in rect_points:
+                    mask.set_at(pt)
+
+            expected_rects = sorted(rects, key=tuple)
+
+            rects = mask.get_bounding_rects()
+
+            self.assertListEqual(
+                sorted(mask.get_bounding_rects(), key=tuple),
+                expected_rects,
+                f"size={size}",
+            )
+
+    @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 = 3
+        size = (33, 65)
+        surface = pygame.Surface(size, SRCALPHA, 32)
+        surface_color = pygame.Color("red")
+        test_fills = ((pygame.Color("white"), True), (pygame.Color("black"), False))
+
+        for expected_color, fill in test_fills:
+            surface.fill(surface_color)
+            mask = pygame.mask.Mask(size, fill=fill)
+
+            to_surface = mask.to_surface(surface)
+
+            self.assertIs(to_surface, surface)
+            if not IS_PYPY:
+                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 = 2
+        expected_flag = SRCALPHA
+        expected_depth = 32
+        size = (33, 65)
+        test_fills = ((pygame.Color("white"), True), (pygame.Color("black"), False))
+
+        for expected_color, fill in test_fills:
+            mask = pygame.mask.Mask(size, fill=fill)
+
+            for use_arg in (True, False):
+                if use_arg:
+                    to_surface = mask.to_surface(None)
+                else:
+                    to_surface = mask.to_surface()
+
+                self.assertIsInstance(to_surface, pygame.Surface)
+                if not IS_PYPY:
+                    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__surface_param(self):
+        """Ensures to_surface accepts a surface arg/kwarg."""
+        expected_ref_count = 4
+        expected_color = pygame.Color("white")
+        surface_color = pygame.Color("red")
+        size = (5, 3)
+        mask = pygame.mask.Mask(size, fill=True)
+        surface = pygame.Surface(size)
+        kwargs = {"surface": surface}
+
+        for use_kwargs in (True, False):
+            surface.fill(surface_color)
+
+            if use_kwargs:
+                to_surface = mask.to_surface(**kwargs)
+            else:
+                to_surface = mask.to_surface(kwargs["surface"])
+
+            self.assertIs(to_surface, surface)
+            if not IS_PYPY:
+                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 = 2
+        expected_flag = SRCALPHA
+        expected_depth = 32
+        expected_color = pygame.Color("red")
+        size = (5, 3)
+        mask = pygame.mask.Mask(size, fill=True)
+        setsurface = pygame.Surface(size, expected_flag, expected_depth)
+        setsurface.fill(expected_color)
+        kwargs = {"setsurface": setsurface}
+
+        for use_kwargs in (True, False):
+            if use_kwargs:
+                to_surface = mask.to_surface(**kwargs)
+            else:
+                to_surface = mask.to_surface(None, kwargs["setsurface"])
+
+            self.assertIsInstance(to_surface, pygame.Surface)
+
+            if not IS_PYPY:
+                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__unsetsurface_param(self):
+        """Ensures to_surface accepts a unsetsurface arg/kwarg."""
+        expected_ref_count = 2
+        expected_flag = SRCALPHA
+        expected_depth = 32
+        expected_color = pygame.Color("red")
+        size = (5, 3)
+        mask = pygame.mask.Mask(size)
+        unsetsurface = pygame.Surface(size, expected_flag, expected_depth)
+        unsetsurface.fill(expected_color)
+        kwargs = {"unsetsurface": unsetsurface}
+
+        for use_kwargs in (True, False):
+            if use_kwargs:
+                to_surface = mask.to_surface(**kwargs)
+            else:
+                to_surface = mask.to_surface(None, None, kwargs["unsetsurface"])
+
+            self.assertIsInstance(to_surface, pygame.Surface)
+            if not IS_PYPY:
+                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__setcolor_param(self):
+        """Ensures to_surface accepts a setcolor arg/kwarg."""
+        expected_ref_count = 2
+        expected_flag = SRCALPHA
+        expected_depth = 32
+        expected_color = pygame.Color("red")
+        size = (5, 3)
+        mask = pygame.mask.Mask(size, fill=True)
+        kwargs = {"setcolor": expected_color}
+
+        for use_kwargs in (True, False):
+            if use_kwargs:
+                to_surface = mask.to_surface(**kwargs)
+            else:
+                to_surface = mask.to_surface(None, None, None, kwargs["setcolor"])
+
+            self.assertIsInstance(to_surface, pygame.Surface)
+            if not IS_PYPY:
+                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__setcolor_default(self):
+        """Ensures the default setcolor is correct."""
+        expected_color = pygame.Color("white")
+        size = (3, 7)
+        mask = pygame.mask.Mask(size, fill=True)
+
+        to_surface = mask.to_surface(
+            surface=None, setsurface=None, unsetsurface=None, unsetcolor=None
+        )
+
+        self.assertEqual(to_surface.get_size(), size)
+        assertSurfaceFilled(self, to_surface, expected_color)
+
+    def test_to_surface__unsetcolor_param(self):
+        """Ensures to_surface accepts a unsetcolor arg/kwarg."""
+        expected_ref_count = 2
+        expected_flag = SRCALPHA
+        expected_depth = 32
+        expected_color = pygame.Color("red")
+        size = (5, 3)
+        mask = pygame.mask.Mask(size)
+        kwargs = {"unsetcolor": expected_color}
+
+        for use_kwargs in (True, False):
+            if use_kwargs:
+                to_surface = mask.to_surface(**kwargs)
+            else:
+                to_surface = mask.to_surface(
+                    None, None, None, None, kwargs["unsetcolor"]
+                )
+
+            self.assertIsInstance(to_surface, pygame.Surface)
+            if not IS_PYPY:
+                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__unsetcolor_default(self):
+        """Ensures the default unsetcolor is correct."""
+        expected_color = pygame.Color("black")
+        size = (3, 7)
+        mask = pygame.mask.Mask(size)
+
+        to_surface = mask.to_surface(
+            surface=None, setsurface=None, unsetsurface=None, setcolor=None
+        )
+
+        self.assertEqual(to_surface.get_size(), size)
+        assertSurfaceFilled(self, to_surface, expected_color)
+
+    def test_to_surface__dest_param(self):
+        """Ensures to_surface accepts a dest arg/kwarg."""
+        expected_ref_count = 2
+        expected_flag = SRCALPHA
+        expected_depth = 32
+        default_surface_color = (0, 0, 0, 0)
+        default_unsetcolor = pygame.Color("black")
+        dest = (0, 0)
+        size = (5, 3)
+        mask = pygame.mask.Mask(size)
+        kwargs = {"dest": dest}
+
+        for use_kwargs in (True, False):
+            if use_kwargs:
+                expected_color = default_unsetcolor
+
+                to_surface = mask.to_surface(**kwargs)
+            else:
+                expected_color = default_surface_color
+
+                to_surface = mask.to_surface(
+                    None, None, None, None, None, kwargs["dest"]
+                )
+
+            self.assertIsInstance(to_surface, pygame.Surface)
+            if not IS_PYPY:
+                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__dest_default(self):
+        """Ensures the default dest is correct."""
+        expected_color = pygame.Color("white")
+        surface_color = pygame.Color("red")
+
+        mask_size = (3, 2)
+        mask = pygame.mask.Mask(mask_size, fill=True)
+        mask_rect = mask.get_rect()
+
+        # Make the surface bigger than the mask.
+        surf_size = (mask_size[0] + 2, mask_size[1] + 1)
+        surface = pygame.Surface(surf_size, SRCALPHA, 32)
+        surface.fill(surface_color)
+
+        to_surface = mask.to_surface(
+            surface, setsurface=None, unsetsurface=None, unsetcolor=None
+        )
+
+        self.assertIs(to_surface, surface)
+        self.assertEqual(to_surface.get_size(), surf_size)
+        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 = 2
+        expected_flag = SRCALPHA
+        expected_depth = 32
+        default_surface_color = (0, 0, 0, 0)
+        default_unsetcolor = pygame.Color("black")
+        size = (5, 3)
+        mask = pygame.mask.Mask(size)
+        kwargs = {"area": mask.get_rect()}
+
+        for use_kwargs in (True, False):
+            if use_kwargs:
+                expected_color = default_unsetcolor
+
+                to_surface = mask.to_surface(**kwargs)
+            else:
+                expected_color = default_surface_color
+
+                to_surface = mask.to_surface(
+                    None, None, None, None, None, (0, 0), kwargs["area"]
+                )
+
+            self.assertIsInstance(to_surface, pygame.Surface)
+            if not IS_PYPY:
+                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_default(self):
+        """Ensures the default area is correct."""
+        expected_color = pygame.Color("white")
+        surface_color = pygame.Color("red")
+
+        mask_size = (3, 2)
+        mask = pygame.mask.Mask(mask_size, fill=True)
+        mask_rect = mask.get_rect()
+
+        # Make the surface bigger than the mask. The default area is the full
+        # area of the mask.
+        surf_size = (mask_size[0] + 2, mask_size[1] + 1)
+        surface = pygame.Surface(surf_size, SRCALPHA, 32)
+        surface.fill(surface_color)
+
+        to_surface = mask.to_surface(
+            surface, setsurface=None, unsetsurface=None, unsetcolor=None
+        )
+
+        self.assertIs(to_surface, surface)
+        self.assertEqual(to_surface.get_size(), surf_size)
+        assertSurfaceFilled(self, to_surface, expected_color, mask_rect)
+        assertSurfaceFilledIgnoreArea(self, to_surface, surface_color, mask_rect)
+
+    def test_to_surface__kwargs(self):
+        """Ensures to_surface accepts the correct kwargs."""
+        expected_color = pygame.Color("white")
+        size = (5, 3)
+        mask = pygame.mask.Mask(size, fill=True)
+        surface = pygame.Surface(size)
+        surface_color = pygame.Color("red")
+        setsurface = surface.copy()
+        setsurface.fill(expected_color)
+
+        test_data = (
+            (None, None),  # None entry allows loop to test all kwargs on first pass.
+            ("dest", (0, 0)),
+            ("unsetcolor", pygame.Color("yellow")),
+            ("setcolor", expected_color),
+            ("unsetsurface", surface.copy()),
+            ("setsurface", setsurface),
+            ("surface", surface),
+        )
+
+        kwargs = dict(test_data)
+
+        for name, _ in test_data:
+            kwargs.pop(name)
+            surface.fill(surface_color)  # Clear for each test.
+
+            to_surface = mask.to_surface(**kwargs)
+
+            self.assertEqual(to_surface.get_size(), size)
+            assertSurfaceFilled(self, to_surface, expected_color)
+
+    def test_to_surface__kwargs_create_surface(self):
+        """Ensures to_surface accepts the correct kwargs
+        when creating a surface.
+        """
+        expected_color = pygame.Color("black")
+        size = (5, 3)
+        mask = pygame.mask.Mask(size)
+        setsurface = pygame.Surface(size, SRCALPHA, 32)
+        setsurface_color = pygame.Color("red")
+        setsurface.fill(setsurface_color)
+        unsetsurface = setsurface.copy()
+        unsetsurface.fill(expected_color)
+
+        test_data = (
+            (None, None),  # None entry allows loop to test all kwargs on first pass.
+            ("dest", (0, 0)),
+            ("unsetcolor", expected_color),
+            ("setcolor", pygame.Color("yellow")),
+            ("unsetsurface", unsetsurface),
+            ("setsurface", setsurface),
+            ("surface", None),
+        )
+        kwargs = dict(test_data)
+
+        for name, _ in test_data:
+            kwargs.pop(name)
+
+            to_surface = mask.to_surface(**kwargs)
+
+            self.assertIsInstance(to_surface, pygame.Surface)
+            self.assertEqual(to_surface.get_size(), size)
+            assertSurfaceFilled(self, to_surface, expected_color)
+
+    def test_to_surface__kwargs_order_independent(self):
+        """Ensures to_surface kwargs are not order dependent."""
+        expected_color = pygame.Color("blue")
+        size = (3, 2)
+        mask = pygame.mask.Mask(size, fill=True)
+        surface = pygame.Surface(size)
+
+        to_surface = mask.to_surface(
+            dest=(0, 0),
+            setcolor=expected_color,
+            unsetcolor=None,
+            surface=surface,
+            unsetsurface=pygame.Surface(size),
+            setsurface=None,
+        )
+
+        self.assertIs(to_surface, surface)
+        self.assertEqual(to_surface.get_size(), size)
+        assertSurfaceFilled(self, to_surface, expected_color)
+
+    def test_to_surface__args_invalid_types(self):
+        """Ensures to_surface detects invalid kwarg types."""
+        size = (3, 2)
+        mask = pygame.mask.Mask(size, fill=True)
+        invalid_surf = pygame.Color("green")
+        invalid_color = pygame.Surface(size)
+
+        with self.assertRaises(TypeError):
+            # Invalid dest.
+            mask.to_surface(None, None, None, None, None, (0,))
+
+        with self.assertRaises(TypeError):
+            # Invalid unsetcolor.
+            mask.to_surface(None, None, None, None, invalid_color)
+
+        with self.assertRaises(TypeError):
+            # Invalid setcolor.
+            mask.to_surface(None, None, None, invalid_color, None)
+
+        with self.assertRaises(TypeError):
+            # Invalid unsetsurface.
+            mask.to_surface(None, None, invalid_surf, None, None)
+
+        with self.assertRaises(TypeError):
+            # Invalid setsurface.
+            mask.to_surface(None, invalid_surf, None, None, None)
+
+        with self.assertRaises(TypeError):
+            # Invalid surface.
+            mask.to_surface(invalid_surf, None, None, None, None)
+
+    def test_to_surface__kwargs_invalid_types(self):
+        """Ensures to_surface detects invalid kwarg types."""
+        size = (3, 2)
+        mask = pygame.mask.Mask(size)
+
+        valid_kwargs = {
+            "surface": pygame.Surface(size),
+            "setsurface": pygame.Surface(size),
+            "unsetsurface": pygame.Surface(size),
+            "setcolor": pygame.Color("green"),
+            "unsetcolor": pygame.Color("green"),
+            "dest": (0, 0),
+        }
+
+        invalid_kwargs = {
+            "surface": (1, 2, 3, 4),
+            "setsurface": pygame.Color("green"),
+            "unsetsurface": ((1, 2), (2, 1)),
+            "setcolor": pygame.Mask((1, 2)),
+            "unsetcolor": pygame.Surface((2, 2)),
+            "dest": (0, 0, 0),
+        }
+
+        kwarg_order = (
+            "surface",
+            "setsurface",
+            "unsetsurface",
+            "setcolor",
+            "unsetcolor",
+            "dest",
+        )
+
+        for kwarg in kwarg_order:
+            kwargs = dict(valid_kwargs)
+            kwargs[kwarg] = invalid_kwargs[kwarg]
+
+            with self.assertRaises(TypeError):
+                mask.to_surface(**kwargs)
+
+    def test_to_surface__kwargs_invalid_name(self):
+        """Ensures to_surface detects invalid kwarg names."""
+        mask = pygame.mask.Mask((3, 2))
+        kwargs = {"setcolour": pygame.Color("red")}
+
+        with self.assertRaises(TypeError):
+            mask.to_surface(**kwargs)
+
+    def test_to_surface__args_and_kwargs(self):
+        """Ensures to_surface accepts a combination of args/kwargs"""
+        size = (5, 3)
+
+        surface_color = pygame.Color("red")
+        setsurface_color = pygame.Color("yellow")
+        unsetsurface_color = pygame.Color("blue")
+        setcolor = pygame.Color("green")
+        unsetcolor = pygame.Color("cyan")
+
+        surface = pygame.Surface(size, SRCALPHA, 32)
+        setsurface = surface.copy()
+        unsetsurface = surface.copy()
+
+        setsurface.fill(setsurface_color)
+        unsetsurface.fill(unsetsurface_color)
+
+        mask = pygame.mask.Mask(size, fill=True)
+        expected_color = setsurface_color
+
+        test_data = (
+            (None, None),  # None entry allows loop to test all kwargs on first pass.
+            ("surface", surface),
+            ("setsurface", setsurface),
+            ("unsetsurface", unsetsurface),
+            ("setcolor", setcolor),
+            ("unsetcolor", unsetcolor),
+            ("dest", (0, 0)),
+        )
+
+        args = []
+        kwargs = dict(test_data)
+
+        # Loop gradually moves the kwargs to args.
+        for name, value in test_data:
+            if name is not None:
+                args.append(value)
+            kwargs.pop(name)
+
+            surface.fill(surface_color)
+
+            to_surface = mask.to_surface(*args, **kwargs)
+
+            assertSurfaceFilled(self, to_surface, expected_color)
+
+    def test_to_surface__valid_setcolor_formats(self):
+        """Ensures to_surface handles valid setcolor formats correctly."""
+        size = (5, 3)
+        mask = pygame.mask.Mask(size, fill=True)
+        surface = pygame.Surface(size, SRCALPHA, 32)
+        expected_color = pygame.Color("green")
+        test_colors = (
+            (0, 255, 0),
+            (0, 255, 0, 255),
+            surface.map_rgb(expected_color),
+            expected_color,
+            "green",
+            "#00FF00FF",
+            "0x00FF00FF",
+        )
+
+        for setcolor in test_colors:
+            to_surface = mask.to_surface(setcolor=setcolor)
+
+            assertSurfaceFilled(self, to_surface, expected_color)
+
+    def test_to_surface__valid_unsetcolor_formats(self):
+        """Ensures to_surface handles valid unsetcolor formats correctly."""
+        size = (5, 3)
+        mask = pygame.mask.Mask(size)
+        surface = pygame.Surface(size, SRCALPHA, 32)
+        expected_color = pygame.Color("green")
+        test_colors = (
+            (0, 255, 0),
+            (0, 255, 0, 255),
+            surface.map_rgb(expected_color),
+            expected_color,
+            "green",
+            "#00FF00FF",
+            "0x00FF00FF",
+        )
+
+        for unsetcolor in test_colors:
+            to_surface = mask.to_surface(unsetcolor=unsetcolor)
+
+            assertSurfaceFilled(self, to_surface, expected_color)
+
+    def test_to_surface__invalid_setcolor_formats(self):
+        """Ensures to_surface handles invalid setcolor formats correctly."""
+        mask = pygame.mask.Mask((5, 3))
+
+        for setcolor in ("green color", "#00FF00FF0", "0x00FF00FF0", (1, 2)):
+            with self.assertRaises(ValueError):
+                mask.to_surface(setcolor=setcolor)
+
+        for setcolor in (pygame.Surface((1, 2)), pygame.Mask((2, 1)), 1.1):
+            with self.assertRaises(TypeError):
+                mask.to_surface(setcolor=setcolor)
+
+    def test_to_surface__invalid_unsetcolor_formats(self):
+        """Ensures to_surface handles invalid unsetcolor formats correctly."""
+        mask = pygame.mask.Mask((5, 3))
+
+        for unsetcolor in ("green color", "#00FF00FF0", "0x00FF00FF0", (1, 2)):
+            with self.assertRaises(ValueError):
+                mask.to_surface(unsetcolor=unsetcolor)
+
+        for unsetcolor in (pygame.Surface((1, 2)), pygame.Mask((2, 1)), 1.1):
+            with self.assertRaises(TypeError):
+                mask.to_surface(unsetcolor=unsetcolor)
+
+    def test_to_surface__valid_dest_formats(self):
+        """Ensures to_surface handles valid dest formats correctly."""
+        expected_color = pygame.Color("white")
+        mask = pygame.mask.Mask((3, 5), fill=True)
+        dests = (
+            (0, 0),
+            [0, 0],
+            Vector2(0, 0),
+            (0, 0, 100, 100),
+            pygame.Rect((0, 0), (10, 10)),
+        )
+
+        for dest in dests:
+            to_surface = mask.to_surface(dest=dest)
+
+            assertSurfaceFilled(self, to_surface, expected_color)
+
+    def test_to_surface__invalid_dest_formats(self):
+        """Ensures to_surface handles invalid dest formats correctly."""
+        mask = pygame.mask.Mask((3, 5))
+        invalid_dests = (
+            (0,),  # Incorrect size.
+            (0, 0, 0),  # Incorrect size.
+            {0, 1},  # Incorrect type.
+            {0: 1},  # Incorrect type.
+            Rect,
+        )  # Incorrect type.
+
+        for dest in invalid_dests:
+            with self.assertRaises(TypeError):
+                mask.to_surface(dest=dest)
+
+    def test_to_surface__negative_sized_dest_rect(self):
+        """Ensures to_surface correctly handles negative sized dest rects."""
+        expected_color = pygame.Color("white")
+        mask = pygame.mask.Mask((3, 5), fill=True)
+        dests = (
+            pygame.Rect((0, 0), (10, -10)),
+            pygame.Rect((0, 0), (-10, 10)),
+            pygame.Rect((0, 0), (-10, -10)),
+        )
+
+        for dest in dests:
+            to_surface = mask.to_surface(dest=dest)
+
+            assertSurfaceFilled(self, to_surface, expected_color)
+
+    def test_to_surface__zero_sized_dest_rect(self):
+        """Ensures to_surface correctly handles zero sized dest rects."""
+        expected_color = pygame.Color("white")
+        mask = pygame.mask.Mask((3, 5), fill=True)
+        dests = (
+            pygame.Rect((0, 0), (0, 10)),
+            pygame.Rect((0, 0), (10, 0)),
+            pygame.Rect((0, 0), (0, 0)),
+        )
+
+        for dest in dests:
+            to_surface = mask.to_surface(dest=dest)
+
+            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)
+        surface_color = pygame.Color("red")
+        expected_color = pygame.Color("white")
+        surface = pygame.Surface(size)
+        mask = pygame.mask.Mask(size, fill=True)
+        area_pos = (0, 0)
+        area_size = (2, 1)
+        areas = (
+            (area_pos[0], area_pos[1], area_size[0], area_size[1]),
+            (area_pos, area_size),
+            (area_pos, list(area_size)),
+            (list(area_pos), area_size),
+            (list(area_pos), list(area_size)),
+            [area_pos[0], area_pos[1], area_size[0], area_size[1]],
+            [area_pos, area_size],
+            [area_pos, list(area_size)],
+            [list(area_pos), area_size],
+            [list(area_pos), list(area_size)],
+            pygame.Rect(area_pos, area_size),
+        )
+
+        for area in areas:
+            surface.fill(surface_color)
+            area_rect = pygame.Rect(area)
+
+            to_surface = mask.to_surface(surface, area=area)
+
+            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))
+        invalid_areas = (
+            (0,),  # Incorrect size.
+            (0, 0),  # Incorrect size.
+            (0, 0, 1),  # Incorrect size.
+            ((0, 0), (1,)),  # Incorrect size.
+            ((0,), (1, 1)),  # Incorrect size.
+            {0, 1, 2, 3},  # Incorrect type.
+            {0: 1, 2: 3},  # Incorrect type.
+            Rect,  # Incorrect type.
+        )
+
+        for area in invalid_areas:
+            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)
+        surface_color = pygame.Color("red")
+        expected_color = pygame.Color("white")
+        surface = pygame.Surface(size)
+        mask = pygame.mask.Mask(size)
+        mask.set_at((0, 0))
+
+        # These rects should cause position (0, 0) of the mask to be drawn.
+        areas = (
+            pygame.Rect((0, 1), (1, -1)),
+            pygame.Rect((1, 0), (-1, 1)),
+            pygame.Rect((1, 1), (-1, -1)),
+        )
+
+        for area in areas:
+            surface.fill(surface_color)
+
+            to_surface = mask.to_surface(surface, area=area)
+
+            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)
+        expected_color = pygame.Color("red")
+        surface = pygame.Surface(size)
+        mask = pygame.mask.Mask(size, fill=True)
+
+        # Zero sized rect areas should cause none of the mask to be drawn.
+        areas = (
+            pygame.Rect((0, 0), (0, 1)),
+            pygame.Rect((0, 0), (1, 0)),
+            pygame.Rect((0, 0), (0, 0)),
+        )
+
+        for area in areas:
+            surface.fill(expected_color)
+
+            to_surface = mask.to_surface(surface, area=area)
+
+            assertSurfaceFilled(self, to_surface, expected_color)
+
+    def test_to_surface__default_surface_with_param_combinations(self):
+        """Ensures to_surface works with a default surface value
+        and combinations of other parameters.
+
+        This tests many different parameter combinations with full and empty
+        masks.
+        """
+        expected_ref_count = 2
+        expected_flag = SRCALPHA
+        expected_depth = 32
+        size = (5, 3)
+        dest = (0, 0)
+
+        default_surface_color = (0, 0, 0, 0)
+        setsurface_color = pygame.Color("yellow")
+        unsetsurface_color = pygame.Color("blue")
+        setcolor = pygame.Color("green")
+        unsetcolor = pygame.Color("cyan")
+
+        setsurface = pygame.Surface(size, expected_flag, expected_depth)
+        unsetsurface = setsurface.copy()
+
+        setsurface.fill(setsurface_color)
+        unsetsurface.fill(unsetsurface_color)
+
+        kwargs = {
+            "setsurface": None,
+            "unsetsurface": None,
+            "setcolor": None,
+            "unsetcolor": None,
+            "dest": None,
+        }
+
+        for fill in (True, False):
+            mask = pygame.mask.Mask(size, fill=fill)
+
+            # Test different combinations of parameters.
+            for setsurface_param in (setsurface, None):
+                kwargs["setsurface"] = setsurface_param
+
+                for unsetsurface_param in (unsetsurface, None):
+                    kwargs["unsetsurface"] = unsetsurface_param
+
+                    for setcolor_param in (setcolor, None):
+                        kwargs["setcolor"] = setcolor_param
+
+                        for unsetcolor_param in (unsetcolor, None):
+                            kwargs["unsetcolor"] = unsetcolor_param
+
+                            for dest_param in (dest, None):
+                                if dest_param is None:
+                                    kwargs.pop("dest", None)
+                                else:
+                                    kwargs["dest"] = dest_param
+
+                                if fill:
+                                    if setsurface_param is not None:
+                                        expected_color = setsurface_color
+                                    elif setcolor_param is not None:
+                                        expected_color = setcolor
+                                    else:
+                                        expected_color = default_surface_color
+                                else:
+                                    if unsetsurface_param is not None:
+                                        expected_color = unsetsurface_color
+                                    elif unsetcolor_param is not None:
+                                        expected_color = unsetcolor
+                                    else:
+                                        expected_color = default_surface_color
+
+                                to_surface = mask.to_surface(**kwargs)
+
+                                self.assertIsInstance(to_surface, pygame.Surface)
+                                if not IS_PYPY:
+                                    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__surface_with_param_combinations(self):
+        """Ensures to_surface works with a surface value
+        and combinations of other parameters.
+
+        This tests many different parameter combinations with full and empty
+        masks.
+        """
+        expected_ref_count = 4
+        expected_flag = SRCALPHA
+        expected_depth = 32
+        size = (5, 3)
+        dest = (0, 0)
+
+        surface_color = pygame.Color("red")
+        setsurface_color = pygame.Color("yellow")
+        unsetsurface_color = pygame.Color("blue")
+        setcolor = pygame.Color("green")
+        unsetcolor = pygame.Color("cyan")
+
+        surface = pygame.Surface(size, expected_flag, expected_depth)
+        setsurface = surface.copy()
+        unsetsurface = surface.copy()
+
+        setsurface.fill(setsurface_color)
+        unsetsurface.fill(unsetsurface_color)
+
+        kwargs = {
+            "surface": surface,
+            "setsurface": None,
+            "unsetsurface": None,
+            "setcolor": None,
+            "unsetcolor": None,
+            "dest": None,
+        }
+
+        for fill in (True, False):
+            mask = pygame.mask.Mask(size, fill=fill)
+
+            # Test different combinations of parameters.
+            for setsurface_param in (setsurface, None):
+                kwargs["setsurface"] = setsurface_param
+
+                for unsetsurface_param in (unsetsurface, None):
+                    kwargs["unsetsurface"] = unsetsurface_param
+
+                    for setcolor_param in (setcolor, None):
+                        kwargs["setcolor"] = setcolor_param
+
+                        for unsetcolor_param in (unsetcolor, None):
+                            kwargs["unsetcolor"] = unsetcolor_param
+                            surface.fill(surface_color)  # Clear for each test.
+
+                            for dest_param in (dest, None):
+                                if dest_param is None:
+                                    kwargs.pop("dest", None)
+                                else:
+                                    kwargs["dest"] = dest_param
+
+                                if fill:
+                                    if setsurface_param is not None:
+                                        expected_color = setsurface_color
+                                    elif setcolor_param is not None:
+                                        expected_color = setcolor
+                                    else:
+                                        expected_color = surface_color
+                                else:
+                                    if unsetsurface_param is not None:
+                                        expected_color = unsetsurface_color
+                                    elif unsetcolor_param is not None:
+                                        expected_color = unsetcolor
+                                    else:
+                                        expected_color = surface_color
+
+                                to_surface = mask.to_surface(**kwargs)
+
+                                self.assertIs(to_surface, surface)
+                                if not IS_PYPY:
+                                    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__set_and_unset_bits(self):
+        """Ensures that to_surface works correctly with with set/unset bits
+        when using the defaults for setcolor and unsetcolor.
+        """
+        default_setcolor = pygame.Color("white")
+        default_unsetcolor = pygame.Color("black")
+        width, height = size = (10, 20)
+        mask = pygame.mask.Mask(size)
+        mask_rect = mask.get_rect()
+
+        surface = pygame.Surface(size)
+        surface_color = pygame.Color("red")
+
+        # Create a checkerboard pattern of set/unset bits.
+        for pos in ((x, y) for x in range(width) for y in range(x & 1, height, 2)):
+            mask.set_at(pos)
+
+        # Test different dest values.
+        for dest in self.ORIGIN_OFFSETS:
+            mask_rect.topleft = dest
+            surface.fill(surface_color)
+
+            to_surface = mask.to_surface(surface, dest=dest)
+
+            to_surface.lock()  # Lock for possible speed up.
+            for pos in ((x, y) for x in range(width) for y in range(height)):
+                mask_pos = (pos[0] - dest[0], pos[1] - dest[1])
+                if not mask_rect.collidepoint(pos):
+                    expected_color = surface_color
+                elif mask.get_at(mask_pos):
+                    expected_color = default_setcolor
+                else:
+                    expected_color = default_unsetcolor
+
+                self.assertEqual(to_surface.get_at(pos), expected_color, (dest, pos))
+            to_surface.unlock()
+
+    def test_to_surface__set_and_unset_bits_with_setsurface_unsetsurface(self):
+        """Ensures that to_surface works correctly with with set/unset bits
+        when using setsurface and unsetsurface.
+        """
+        width, height = size = (10, 20)
+        mask = pygame.mask.Mask(size)
+        mask_rect = mask.get_rect()
+
+        surface = pygame.Surface(size)
+        surface_color = pygame.Color("red")
+
+        setsurface = surface.copy()
+        setsurface_color = pygame.Color("green")
+        setsurface.fill(setsurface_color)
+
+        unsetsurface = surface.copy()
+        unsetsurface_color = pygame.Color("blue")
+        unsetsurface.fill(unsetsurface_color)
+
+        # Create a checkerboard pattern of set/unset bits.
+        for pos in ((x, y) for x in range(width) for y in range(x & 1, height, 2)):
+            mask.set_at(pos)
+
+        # Test different dest values.
+        for dest in self.ORIGIN_OFFSETS:
+            mask_rect.topleft = dest
+
+            # Tests the color parameters set to None and also as their
+            # default values. Should have no effect as they are not being
+            # used, but this exercises different to_surface() code.
+            for disable_color_params in (True, False):
+                surface.fill(surface_color)  # Clear for each test.
+
+                if disable_color_params:
+                    to_surface = mask.to_surface(
+                        surface,
+                        dest=dest,
+                        setsurface=setsurface,
+                        unsetsurface=unsetsurface,
+                        setcolor=None,
+                        unsetcolor=None,
+                    )
+                else:
+                    to_surface = mask.to_surface(
+                        surface,
+                        dest=dest,
+                        setsurface=setsurface,
+                        unsetsurface=unsetsurface,
+                    )
+
+                to_surface.lock()  # Lock for possible speed up.
+
+                for pos in ((x, y) for x in range(width) for y in range(height)):
+                    mask_pos = (pos[0] - dest[0], pos[1] - dest[1])
+
+                    if not mask_rect.collidepoint(pos):
+                        expected_color = surface_color
+                    elif mask.get_at(mask_pos):
+                        expected_color = setsurface_color
+                    else:
+                        expected_color = unsetsurface_color
+
+                    self.assertEqual(to_surface.get_at(pos), expected_color)
+                to_surface.unlock()
+
+    def test_to_surface__surface_narrower_than_mask(self):
+        """Ensures that surfaces narrower than the mask work correctly.
+
+        For this test the surface's width is less than the mask's width.
+        """
+        default_setcolor = pygame.Color("white")
+        default_unsetcolor = pygame.Color("black")
+        mask_size = (10, 20)
+        narrow_size = (6, 20)
+
+        surface = pygame.Surface(narrow_size)
+        surface_color = pygame.Color("red")
+
+        for fill in (True, False):
+            mask = pygame.mask.Mask(mask_size, fill=fill)
+            surface.fill(surface_color)  # Clear for each test.
+            expected_color = default_setcolor if fill else default_unsetcolor
+
+            to_surface = mask.to_surface(surface)
+
+            self.assertIs(to_surface, surface)
+            self.assertEqual(to_surface.get_size(), narrow_size)
+            assertSurfaceFilled(self, to_surface, expected_color)
+
+    def test_to_surface__setsurface_narrower_than_mask(self):
+        """Ensures that setsurfaces narrower than the mask work correctly.
+
+        For this test the setsurface's width is less than the mask's width.
+        """
+        default_setcolor = pygame.Color("white")
+        default_unsetcolor = pygame.Color("black")
+        mask_size = (10, 20)
+        narrow_size = (6, 20)
+
+        setsurface = pygame.Surface(narrow_size, SRCALPHA, 32)
+        setsurface_color = pygame.Color("red")
+        setsurface.fill(setsurface_color)
+        setsurface_rect = setsurface.get_rect()
+
+        for fill in (True, False):
+            mask = pygame.mask.Mask(mask_size, fill=fill)
+
+            to_surface = mask.to_surface(setsurface=setsurface)
+
+            self.assertIsInstance(to_surface, pygame.Surface)
+            self.assertEqual(to_surface.get_size(), mask_size)
+
+            # Different checks depending on if the mask was filled or not.
+            if fill:
+                assertSurfaceFilled(self, to_surface, setsurface_color, setsurface_rect)
+                assertSurfaceFilledIgnoreArea(
+                    self, to_surface, default_setcolor, setsurface_rect
+                )
+            else:
+                assertSurfaceFilled(self, to_surface, default_unsetcolor)
+
+    def test_to_surface__unsetsurface_narrower_than_mask(self):
+        """Ensures that unsetsurfaces narrower than the mask work correctly.
+
+        For this test the unsetsurface's width is less than the mask's width.
+        """
+        default_setcolor = pygame.Color("white")
+        default_unsetcolor = pygame.Color("black")
+        mask_size = (10, 20)
+        narrow_size = (6, 20)
+
+        unsetsurface = pygame.Surface(narrow_size, SRCALPHA, 32)
+        unsetsurface_color = pygame.Color("red")
+        unsetsurface.fill(unsetsurface_color)
+        unsetsurface_rect = unsetsurface.get_rect()
+
+        for fill in (True, False):
+            mask = pygame.mask.Mask(mask_size, fill=fill)
+
+            to_surface = mask.to_surface(unsetsurface=unsetsurface)
+
+            self.assertIsInstance(to_surface, pygame.Surface)
+            self.assertEqual(to_surface.get_size(), mask_size)
+
+            # Different checks depending on if the mask was filled or not.
+            if fill:
+                assertSurfaceFilled(self, to_surface, default_setcolor)
+            else:
+                assertSurfaceFilled(
+                    self, to_surface, unsetsurface_color, unsetsurface_rect
+                )
+                assertSurfaceFilledIgnoreArea(
+                    self, to_surface, default_unsetcolor, unsetsurface_rect
+                )
+
+    def test_to_surface__setsurface_narrower_than_mask_and_colors_none(self):
+        """Ensures that setsurfaces narrower than the mask work correctly
+        when setcolor and unsetcolor are set to None.
+
+        For this test the setsurface's width is less than the mask's width.
+        """
+        default_surface_color = (0, 0, 0, 0)
+        mask_size = (10, 20)
+        narrow_size = (6, 20)
+
+        setsurface = pygame.Surface(narrow_size, SRCALPHA, 32)
+        setsurface_color = pygame.Color("red")
+        setsurface.fill(setsurface_color)
+        setsurface_rect = setsurface.get_rect()
+
+        for fill in (True, False):
+            mask = pygame.mask.Mask(mask_size, fill=fill)
+
+            to_surface = mask.to_surface(
+                setsurface=setsurface, setcolor=None, unsetcolor=None
+            )
+
+            self.assertIsInstance(to_surface, pygame.Surface)
+            self.assertEqual(to_surface.get_size(), mask_size)
+
+            # Different checks depending on if the mask was filled or not.
+            if fill:
+                assertSurfaceFilled(self, to_surface, setsurface_color, setsurface_rect)
+                assertSurfaceFilledIgnoreArea(
+                    self, to_surface, default_surface_color, setsurface_rect
+                )
+            else:
+                assertSurfaceFilled(self, to_surface, default_surface_color)
+
+    def test_to_surface__unsetsurface_narrower_than_mask_and_colors_none(self):
+        """Ensures that unsetsurfaces narrower than the mask work correctly
+        when setcolor and unsetcolor are set to None.
+
+        For this test the unsetsurface's width is less than the mask's width.
+        """
+        default_surface_color = (0, 0, 0, 0)
+        mask_size = (10, 20)
+        narrow_size = (6, 20)
+
+        unsetsurface = pygame.Surface(narrow_size, SRCALPHA, 32)
+        unsetsurface_color = pygame.Color("red")
+        unsetsurface.fill(unsetsurface_color)
+        unsetsurface_rect = unsetsurface.get_rect()
+
+        for fill in (True, False):
+            mask = pygame.mask.Mask(mask_size, fill=fill)
+
+            to_surface = mask.to_surface(
+                unsetsurface=unsetsurface, setcolor=None, unsetcolor=None
+            )
+
+            self.assertIsInstance(to_surface, pygame.Surface)
+            self.assertEqual(to_surface.get_size(), mask_size)
+
+            # Different checks depending on if the mask was filled or not.
+            if fill:
+                assertSurfaceFilled(self, to_surface, default_surface_color)
+            else:
+                assertSurfaceFilled(
+                    self, to_surface, unsetsurface_color, unsetsurface_rect
+                )
+                assertSurfaceFilledIgnoreArea(
+                    self, to_surface, default_surface_color, unsetsurface_rect
+                )
+
+    def test_to_surface__surface_wider_than_mask(self):
+        """Ensures that surfaces wider than the mask work correctly.
+
+        For this test the surface's width is greater than the mask's width.
+        """
+        default_setcolor = pygame.Color("white")
+        default_unsetcolor = pygame.Color("black")
+        mask_size = (6, 15)
+        wide_size = (11, 15)
+
+        surface = pygame.Surface(wide_size)
+        surface_color = pygame.Color("red")
+
+        for fill in (True, False):
+            mask = pygame.mask.Mask(mask_size, fill=fill)
+            mask_rect = mask.get_rect()
+            surface.fill(surface_color)  # Clear for each test.
+            expected_color = default_setcolor if fill else default_unsetcolor
+
+            to_surface = mask.to_surface(surface)
+
+            self.assertIs(to_surface, surface)
+            self.assertEqual(to_surface.get_size(), wide_size)
+            assertSurfaceFilled(self, to_surface, expected_color, mask_rect)
+            assertSurfaceFilledIgnoreArea(self, to_surface, surface_color, mask_rect)
+
+    def test_to_surface__setsurface_wider_than_mask(self):
+        """Ensures that setsurfaces wider than the mask work correctly.
+
+        For this test the setsurface's width is greater than the mask's width.
+        """
+        default_unsetcolor = pygame.Color("black")
+        mask_size = (6, 15)
+        wide_size = (11, 15)
+
+        setsurface = pygame.Surface(wide_size, SRCALPHA, 32)
+        setsurface_color = pygame.Color("red")
+        setsurface.fill(setsurface_color)
+
+        for fill in (True, False):
+            mask = pygame.mask.Mask(mask_size, fill=fill)
+            expected_color = setsurface_color if fill else default_unsetcolor
+
+            to_surface = mask.to_surface(setsurface=setsurface)
+
+            self.assertIsInstance(to_surface, pygame.Surface)
+            self.assertEqual(to_surface.get_size(), mask_size)
+            assertSurfaceFilled(self, to_surface, expected_color)
+
+    def test_to_surface__unsetsurface_wider_than_mask(self):
+        """Ensures that unsetsurfaces wider than the mask work correctly.
+
+        For this test the unsetsurface's width is greater than the mask's
+        width.
+        """
+        default_setcolor = pygame.Color("white")
+        mask_size = (6, 15)
+        wide_size = (11, 15)
+
+        unsetsurface = pygame.Surface(wide_size, SRCALPHA, 32)
+        unsetsurface_color = pygame.Color("red")
+        unsetsurface.fill(unsetsurface_color)
+
+        for fill in (True, False):
+            mask = pygame.mask.Mask(mask_size, fill=fill)
+            expected_color = default_setcolor if fill else unsetsurface_color
+
+            to_surface = mask.to_surface(unsetsurface=unsetsurface)
+
+            self.assertIsInstance(to_surface, pygame.Surface)
+            self.assertEqual(to_surface.get_size(), mask_size)
+            assertSurfaceFilled(self, to_surface, expected_color)
+
+    def test_to_surface__surface_shorter_than_mask(self):
+        """Ensures that surfaces shorter than the mask work correctly.
+
+        For this test the surface's height is less than the mask's height.
+        """
+        default_setcolor = pygame.Color("white")
+        default_unsetcolor = pygame.Color("black")
+        mask_size = (10, 11)
+        short_size = (10, 6)
+
+        surface = pygame.Surface(short_size)
+        surface_color = pygame.Color("red")
+
+        for fill in (True, False):
+            mask = pygame.mask.Mask(mask_size, fill=fill)
+            surface.fill(surface_color)  # Clear for each test.
+            expected_color = default_setcolor if fill else default_unsetcolor
+
+            to_surface = mask.to_surface(surface)
+
+            self.assertIs(to_surface, surface)
+            self.assertEqual(to_surface.get_size(), short_size)
+            assertSurfaceFilled(self, to_surface, expected_color)
+
+    def test_to_surface__setsurface_shorter_than_mask(self):
+        """Ensures that setsurfaces shorter than the mask work correctly.
+
+        For this test the setsurface's height is less than the mask's height.
+        """
+        default_setcolor = pygame.Color("white")
+        default_unsetcolor = pygame.Color("black")
+        mask_size = (10, 11)
+        short_size = (10, 6)
+
+        setsurface = pygame.Surface(short_size, SRCALPHA, 32)
+        setsurface_color = pygame.Color("red")
+        setsurface.fill(setsurface_color)
+        setsurface_rect = setsurface.get_rect()
+
+        for fill in (True, False):
+            mask = pygame.mask.Mask(mask_size, fill=fill)
+
+            to_surface = mask.to_surface(setsurface=setsurface)
+
+            self.assertIsInstance(to_surface, pygame.Surface)
+            self.assertEqual(to_surface.get_size(), mask_size)
+
+            # Different checks depending on if the mask was filled or not.
+            if fill:
+                assertSurfaceFilled(self, to_surface, setsurface_color, setsurface_rect)
+                assertSurfaceFilledIgnoreArea(
+                    self, to_surface, default_setcolor, setsurface_rect
+                )
+            else:
+                assertSurfaceFilled(self, to_surface, default_unsetcolor)
+
+    def test_to_surface__unsetsurface_shorter_than_mask(self):
+        """Ensures that unsetsurfaces shorter than the mask work correctly.
+
+        For this test the unsetsurface's height is less than the mask's height.
+        """
+        default_setcolor = pygame.Color("white")
+        default_unsetcolor = pygame.Color("black")
+        mask_size = (10, 11)
+        short_size = (10, 6)
+
+        unsetsurface = pygame.Surface(short_size, SRCALPHA, 32)
+        unsetsurface_color = pygame.Color("red")
+        unsetsurface.fill(unsetsurface_color)
+        unsetsurface_rect = unsetsurface.get_rect()
+
+        for fill in (True, False):
+            mask = pygame.mask.Mask(mask_size, fill=fill)
+
+            to_surface = mask.to_surface(unsetsurface=unsetsurface)
+
+            self.assertIsInstance(to_surface, pygame.Surface)
+            self.assertEqual(to_surface.get_size(), mask_size)
+
+            # Different checks depending on if the mask was filled or not.
+            if fill:
+                assertSurfaceFilled(self, to_surface, default_setcolor)
+            else:
+                assertSurfaceFilled(
+                    self, to_surface, unsetsurface_color, unsetsurface_rect
+                )
+                assertSurfaceFilledIgnoreArea(
+                    self, to_surface, default_unsetcolor, unsetsurface_rect
+                )
+
+    def test_to_surface__setsurface_shorter_than_mask_and_colors_none(self):
+        """Ensures that setsurfaces shorter than the mask work correctly
+        when setcolor and unsetcolor are set to None.
+
+        For this test the setsurface's height is less than the mask's height.
+        """
+        default_surface_color = (0, 0, 0, 0)
+        mask_size = (10, 11)
+        short_size = (10, 6)
+
+        setsurface = pygame.Surface(short_size, SRCALPHA, 32)
+        setsurface_color = pygame.Color("red")
+        setsurface.fill(setsurface_color)
+        setsurface_rect = setsurface.get_rect()
+
+        for fill in (True, False):
+            mask = pygame.mask.Mask(mask_size, fill=fill)
+
+            to_surface = mask.to_surface(
+                setsurface=setsurface, setcolor=None, unsetcolor=None
+            )
+
+            self.assertIsInstance(to_surface, pygame.Surface)
+            self.assertEqual(to_surface.get_size(), mask_size)
+
+            # Different checks depending on if the mask was filled or not.
+            if fill:
+                assertSurfaceFilled(self, to_surface, setsurface_color, setsurface_rect)
+                assertSurfaceFilledIgnoreArea(
+                    self, to_surface, default_surface_color, setsurface_rect
+                )
+            else:
+                assertSurfaceFilled(self, to_surface, default_surface_color)
+
+    def test_to_surface__unsetsurface_shorter_than_mask_and_colors_none(self):
+        """Ensures that unsetsurfaces shorter than the mask work correctly
+        when setcolor and unsetcolor are set to None.
+
+        For this test the unsetsurface's height is less than the mask's height.
+        """
+        default_surface_color = (0, 0, 0, 0)
+        mask_size = (10, 11)
+        short_size = (10, 6)
+
+        unsetsurface = pygame.Surface(short_size, SRCALPHA, 32)
+        unsetsurface_color = pygame.Color("red")
+        unsetsurface.fill(unsetsurface_color)
+        unsetsurface_rect = unsetsurface.get_rect()
+
+        for fill in (True, False):
+            mask = pygame.mask.Mask(mask_size, fill=fill)
+
+            to_surface = mask.to_surface(
+                unsetsurface=unsetsurface, setcolor=None, unsetcolor=None
+            )
+
+            self.assertIsInstance(to_surface, pygame.Surface)
+            self.assertEqual(to_surface.get_size(), mask_size)
+
+            # Different checks depending on if the mask was filled or not.
+            if fill:
+                assertSurfaceFilled(self, to_surface, default_surface_color)
+            else:
+                assertSurfaceFilled(
+                    self, to_surface, unsetsurface_color, unsetsurface_rect
+                )
+                assertSurfaceFilledIgnoreArea(
+                    self, to_surface, default_surface_color, unsetsurface_rect
+                )
+
+    def test_to_surface__surface_taller_than_mask(self):
+        """Ensures that surfaces taller than the mask work correctly.
+
+        For this test the surface's height is greater than the mask's height.
+        """
+        default_setcolor = pygame.Color("white")
+        default_unsetcolor = pygame.Color("black")
+        mask_size = (10, 6)
+        tall_size = (10, 11)
+
+        surface = pygame.Surface(tall_size)
+        surface_color = pygame.Color("red")
+
+        for fill in (True, False):
+            mask = pygame.mask.Mask(mask_size, fill=fill)
+            mask_rect = mask.get_rect()
+            surface.fill(surface_color)  # Clear for each test.
+            expected_color = default_setcolor if fill else default_unsetcolor
+
+            to_surface = mask.to_surface(surface)
+
+            self.assertIs(to_surface, surface)
+            self.assertEqual(to_surface.get_size(), tall_size)
+            assertSurfaceFilled(self, to_surface, expected_color, mask_rect)
+            assertSurfaceFilledIgnoreArea(self, to_surface, surface_color, mask_rect)
+
+    def test_to_surface__setsurface_taller_than_mask(self):
+        """Ensures that setsurfaces taller than the mask work correctly.
+
+        For this test the setsurface's height is greater than the mask's
+        height.
+        """
+        default_unsetcolor = pygame.Color("black")
+        mask_size = (10, 6)
+        tall_size = (10, 11)
+
+        setsurface = pygame.Surface(tall_size, SRCALPHA, 32)
+        setsurface_color = pygame.Color("red")
+        setsurface.fill(setsurface_color)
+
+        for fill in (True, False):
+            mask = pygame.mask.Mask(mask_size, fill=fill)
+            expected_color = setsurface_color if fill else default_unsetcolor
+
+            to_surface = mask.to_surface(setsurface=setsurface)
+
+            self.assertIsInstance(to_surface, pygame.Surface)
+            self.assertEqual(to_surface.get_size(), mask_size)
+            assertSurfaceFilled(self, to_surface, expected_color)
+
+    def test_to_surface__unsetsurface_taller_than_mask(self):
+        """Ensures that unsetsurfaces taller than the mask work correctly.
+
+        For this test the unsetsurface's height is greater than the mask's
+        height.
+        """
+        default_setcolor = pygame.Color("white")
+        mask_size = (10, 6)
+        tall_size = (10, 11)
+
+        unsetsurface = pygame.Surface(tall_size, SRCALPHA, 32)
+        unsetsurface_color = pygame.Color("red")
+        unsetsurface.fill(unsetsurface_color)
+
+        for fill in (True, False):
+            mask = pygame.mask.Mask(mask_size, fill=fill)
+            expected_color = default_setcolor if fill else unsetsurface_color
+
+            to_surface = mask.to_surface(unsetsurface=unsetsurface)
+
+            self.assertIsInstance(to_surface, pygame.Surface)
+            self.assertEqual(to_surface.get_size(), mask_size)
+            assertSurfaceFilled(self, to_surface, expected_color)
+
+    def test_to_surface__surface_wider_and_taller_than_mask(self):
+        """Ensures that surfaces wider and taller than the mask work correctly.
+
+        For this test the surface's width is greater than the mask's width and
+        the surface's height is greater than the mask's height.
+        """
+        default_setcolor = pygame.Color("white")
+        default_unsetcolor = pygame.Color("black")
+        mask_size = (6, 8)
+        wide_tall_size = (11, 15)
+
+        surface = pygame.Surface(wide_tall_size)
+        surface_color = pygame.Color("red")
+
+        for fill in (True, False):
+            mask = pygame.mask.Mask(mask_size, fill=fill)
+            mask_rect = mask.get_rect()
+            surface.fill(surface_color)  # Clear for each test.
+            expected_color = default_setcolor if fill else default_unsetcolor
+
+            to_surface = mask.to_surface(surface)
+
+            self.assertIs(to_surface, surface)
+            self.assertEqual(to_surface.get_size(), wide_tall_size)
+            assertSurfaceFilled(self, to_surface, expected_color, mask_rect)
+            assertSurfaceFilledIgnoreArea(self, to_surface, surface_color, mask_rect)
+
+    def test_to_surface__setsurface_wider_and_taller_than_mask(self):
+        """Ensures that setsurfaces wider and taller than the mask work
+        correctly.
+
+        For this test the setsurface's width is greater than the mask's width
+        and the setsurface's height is greater than the mask's height.
+        """
+        default_unsetcolor = pygame.Color("black")
+        mask_size = (6, 8)
+        wide_tall_size = (11, 15)
+
+        setsurface = pygame.Surface(wide_tall_size, SRCALPHA, 32)
+        setsurface_color = pygame.Color("red")
+        setsurface.fill(setsurface_color)
+
+        for fill in (True, False):
+            mask = pygame.mask.Mask(mask_size, fill=fill)
+            expected_color = setsurface_color if fill else default_unsetcolor
+
+            to_surface = mask.to_surface(setsurface=setsurface)
+
+            self.assertIsInstance(to_surface, pygame.Surface)
+            self.assertEqual(to_surface.get_size(), mask_size)
+            assertSurfaceFilled(self, to_surface, expected_color)
+
+    def test_to_surface__unsetsurface_wider_and_taller_than_mask(self):
+        """Ensures that unsetsurfaces wider and taller than the mask work
+        correctly.
+
+        For this test the unsetsurface's width is greater than the mask's width
+        and the unsetsurface's height is greater than the mask's height.
+        """
+        default_setcolor = pygame.Color("white")
+        mask_size = (6, 8)
+        wide_tall_size = (11, 15)
+
+        unsetsurface = pygame.Surface(wide_tall_size, SRCALPHA, 32)
+        unsetsurface_color = pygame.Color("red")
+        unsetsurface.fill(unsetsurface_color)
+
+        for fill in (True, False):
+            mask = pygame.mask.Mask(mask_size, fill=fill)
+            expected_color = default_setcolor if fill else unsetsurface_color
+
+            to_surface = mask.to_surface(unsetsurface=unsetsurface)
+
+            self.assertIsInstance(to_surface, pygame.Surface)
+            self.assertEqual(to_surface.get_size(), mask_size)
+            assertSurfaceFilled(self, to_surface, expected_color)
+
+    def test_to_surface__surface_wider_and_shorter_than_mask(self):
+        """Ensures that surfaces wider and shorter than the mask work
+        correctly.
+
+        For this test the surface's width is greater than the mask's width and
+        the surface's height is less than the mask's height.
+        """
+        default_setcolor = pygame.Color("white")
+        default_unsetcolor = pygame.Color("black")
+        mask_size = (7, 11)
+        wide_short_size = (13, 6)
+
+        surface = pygame.Surface(wide_short_size)
+        surface_color = pygame.Color("red")
+
+        for fill in (True, False):
+            mask = pygame.mask.Mask(mask_size, fill=fill)
+            mask_rect = mask.get_rect()
+            surface.fill(surface_color)  # Clear for each test.
+            expected_color = default_setcolor if fill else default_unsetcolor
+
+            to_surface = mask.to_surface(surface)
+
+            self.assertIs(to_surface, surface)
+            self.assertEqual(to_surface.get_size(), wide_short_size)
+            assertSurfaceFilled(self, to_surface, expected_color, mask_rect)
+            assertSurfaceFilledIgnoreArea(self, to_surface, surface_color, mask_rect)
+
+    def test_to_surface__setsurface_wider_and_shorter_than_mask(self):
+        """Ensures that setsurfaces wider and shorter than the mask work
+        correctly.
+
+        For this test the setsurface's width is greater than the mask's width
+        and the setsurface's height is less than the mask's height.
+        """
+        default_setcolor = pygame.Color("white")
+        default_unsetcolor = pygame.Color("black")
+        mask_size = (7, 11)
+        wide_short_size = (10, 6)
+
+        setsurface = pygame.Surface(wide_short_size, SRCALPHA, 32)
+        setsurface_color = pygame.Color("red")
+        setsurface.fill(setsurface_color)
+        setsurface_rect = setsurface.get_rect()
+
+        for fill in (True, False):
+            mask = pygame.mask.Mask(mask_size, fill=fill)
+
+            to_surface = mask.to_surface(setsurface=setsurface)
+
+            self.assertIsInstance(to_surface, pygame.Surface)
+            self.assertEqual(to_surface.get_size(), mask_size)
+
+            # Different checks depending on if the mask was filled or not.
+            if fill:
+                assertSurfaceFilled(self, to_surface, setsurface_color, setsurface_rect)
+                assertSurfaceFilledIgnoreArea(
+                    self, to_surface, default_setcolor, setsurface_rect
+                )
+            else:
+                assertSurfaceFilled(self, to_surface, default_unsetcolor)
+
+    def test_to_surface__unsetsurface_wider_and_shorter_than_mask(self):
+        """Ensures that unsetsurfaces wider and shorter than the mask work
+        correctly.
+
+        For this test the unsetsurface's width is greater than the mask's width
+        and the unsetsurface's height is less than the mask's height.
+        """
+        default_setcolor = pygame.Color("white")
+        default_unsetcolor = pygame.Color("black")
+        mask_size = (7, 11)
+        wide_short_size = (10, 6)
+
+        unsetsurface = pygame.Surface(wide_short_size, SRCALPHA, 32)
+        unsetsurface_color = pygame.Color("red")
+        unsetsurface.fill(unsetsurface_color)
+        unsetsurface_rect = unsetsurface.get_rect()
+
+        for fill in (True, False):
+            mask = pygame.mask.Mask(mask_size, fill=fill)
+
+            to_surface = mask.to_surface(unsetsurface=unsetsurface)
+
+            self.assertIsInstance(to_surface, pygame.Surface)
+            self.assertEqual(to_surface.get_size(), mask_size)
+
+            # Different checks depending on if the mask was filled or not.
+            if fill:
+                assertSurfaceFilled(self, to_surface, default_setcolor)
+            else:
+                assertSurfaceFilled(
+                    self, to_surface, unsetsurface_color, unsetsurface_rect
+                )
+                assertSurfaceFilledIgnoreArea(
+                    self, to_surface, default_unsetcolor, unsetsurface_rect
+                )
+
+    def test_to_surface__surface_narrower_and_taller_than_mask(self):
+        """Ensures that surfaces narrower and taller than the mask work
+        correctly.
+
+        For this test the surface's width is less than the mask's width and
+        the surface's height is greater than the mask's height.
+        """
+        default_setcolor = pygame.Color("white")
+        default_unsetcolor = pygame.Color("black")
+        mask_size = (10, 8)
+        narrow_tall_size = (6, 15)
+
+        surface = pygame.Surface(narrow_tall_size)
+        surface_color = pygame.Color("red")
+
+        for fill in (True, False):
+            mask = pygame.mask.Mask(mask_size, fill=fill)
+            mask_rect = mask.get_rect()
+            surface.fill(surface_color)  # Clear for each test.
+            expected_color = default_setcolor if fill else default_unsetcolor
+
+            to_surface = mask.to_surface(surface)
+
+            self.assertIs(to_surface, surface)
+            self.assertEqual(to_surface.get_size(), narrow_tall_size)
+            assertSurfaceFilled(self, to_surface, expected_color, mask_rect)
+            assertSurfaceFilledIgnoreArea(self, to_surface, surface_color, mask_rect)
+
+    def test_to_surface__setsurface_narrower_and_taller_than_mask(self):
+        """Ensures that setsurfaces narrower and taller than the mask work
+        correctly.
+
+        For this test the setsurface's width is less than the mask's width
+        and the setsurface's height is greater than the mask's height.
+        """
+        default_setcolor = pygame.Color("white")
+        default_unsetcolor = pygame.Color("black")
+        mask_size = (10, 8)
+        narrow_tall_size = (6, 15)
+
+        setsurface = pygame.Surface(narrow_tall_size, SRCALPHA, 32)
+        setsurface_color = pygame.Color("red")
+        setsurface.fill(setsurface_color)
+        setsurface_rect = setsurface.get_rect()
+
+        for fill in (True, False):
+            mask = pygame.mask.Mask(mask_size, fill=fill)
+
+            to_surface = mask.to_surface(setsurface=setsurface)
+
+            self.assertIsInstance(to_surface, pygame.Surface)
+            self.assertEqual(to_surface.get_size(), mask_size)
+
+            # Different checks depending on if the mask was filled or not.
+            if fill:
+                assertSurfaceFilled(self, to_surface, setsurface_color, setsurface_rect)
+                assertSurfaceFilledIgnoreArea(
+                    self, to_surface, default_setcolor, setsurface_rect
+                )
+            else:
+                assertSurfaceFilled(self, to_surface, default_unsetcolor)
+
+    def test_to_surface__unsetsurface_narrower_and_taller_than_mask(self):
+        """Ensures that unsetsurfaces narrower and taller than the mask work
+        correctly.
+
+        For this test the unsetsurface's width is less than the mask's width
+        and the unsetsurface's height is greater than the mask's height.
+        """
+        default_setcolor = pygame.Color("white")
+        default_unsetcolor = pygame.Color("black")
+        mask_size = (10, 8)
+        narrow_tall_size = (6, 15)
+
+        unsetsurface = pygame.Surface(narrow_tall_size, SRCALPHA, 32)
+        unsetsurface_color = pygame.Color("red")
+        unsetsurface.fill(unsetsurface_color)
+        unsetsurface_rect = unsetsurface.get_rect()
+
+        for fill in (True, False):
+            mask = pygame.mask.Mask(mask_size, fill=fill)
+
+            to_surface = mask.to_surface(unsetsurface=unsetsurface)
+
+            self.assertIsInstance(to_surface, pygame.Surface)
+            self.assertEqual(to_surface.get_size(), mask_size)
+
+            # Different checks depending on if the mask was filled or not.
+            if fill:
+                assertSurfaceFilled(self, to_surface, default_setcolor)
+            else:
+                assertSurfaceFilled(
+                    self, to_surface, unsetsurface_color, unsetsurface_rect
+                )
+                assertSurfaceFilledIgnoreArea(
+                    self, to_surface, default_unsetcolor, unsetsurface_rect
+                )
+
+    def test_to_surface__surface_narrower_and_shorter_than_mask(self):
+        """Ensures that surfaces narrower and shorter than the mask work
+        correctly.
+
+        For this test the surface's width is less than the mask's width and
+        the surface's height is less than the mask's height.
+        """
+        default_setcolor = pygame.Color("white")
+        default_unsetcolor = pygame.Color("black")
+        mask_size = (10, 18)
+        narrow_short_size = (6, 15)
+
+        surface = pygame.Surface(narrow_short_size)
+        surface_color = pygame.Color("red")
+
+        for fill in (True, False):
+            mask = pygame.mask.Mask(mask_size, fill=fill)
+            mask_rect = mask.get_rect()
+            surface.fill(surface_color)  # Clear for each test.
+            expected_color = default_setcolor if fill else default_unsetcolor
+
+            to_surface = mask.to_surface(surface)
+
+            self.assertIs(to_surface, surface)
+            self.assertEqual(to_surface.get_size(), narrow_short_size)
+            assertSurfaceFilled(self, to_surface, expected_color, mask_rect)
+            assertSurfaceFilledIgnoreArea(self, to_surface, surface_color, mask_rect)
+
+    def test_to_surface__setsurface_narrower_and_shorter_than_mask(self):
+        """Ensures that setsurfaces narrower and shorter than the mask work
+        correctly.
+
+        For this test the setsurface's width is less than the mask's width
+        and the setsurface's height is less than the mask's height.
+        """
+        default_setcolor = pygame.Color("white")
+        default_unsetcolor = pygame.Color("black")
+        mask_size = (10, 18)
+        narrow_short_size = (6, 15)
+
+        setsurface = pygame.Surface(narrow_short_size, SRCALPHA, 32)
+        setsurface_color = pygame.Color("red")
+        setsurface.fill(setsurface_color)
+        setsurface_rect = setsurface.get_rect()
+
+        for fill in (True, False):
+            mask = pygame.mask.Mask(mask_size, fill=fill)
+
+            to_surface = mask.to_surface(setsurface=setsurface)
+
+            self.assertIsInstance(to_surface, pygame.Surface)
+            self.assertEqual(to_surface.get_size(), mask_size)
+
+            # Different checks depending on if the mask was filled or not.
+            if fill:
+                assertSurfaceFilled(self, to_surface, setsurface_color, setsurface_rect)
+                assertSurfaceFilledIgnoreArea(
+                    self, to_surface, default_setcolor, setsurface_rect
+                )
+            else:
+                assertSurfaceFilled(self, to_surface, default_unsetcolor)
+
+    def test_to_surface__unsetsurface_narrower_and_shorter_than_mask(self):
+        """Ensures that unsetsurfaces narrower and shorter than the mask work
+        correctly.
+
+        For this test the unsetsurface's width is less than the mask's width
+        and the unsetsurface's height is less than the mask's height.
+        """
+        default_setcolor = pygame.Color("white")
+        default_unsetcolor = pygame.Color("black")
+        mask_size = (10, 18)
+        narrow_short_size = (6, 15)
+
+        unsetsurface = pygame.Surface(narrow_short_size, SRCALPHA, 32)
+        unsetsurface_color = pygame.Color("red")
+        unsetsurface.fill(unsetsurface_color)
+        unsetsurface_rect = unsetsurface.get_rect()
+
+        for fill in (True, False):
+            mask = pygame.mask.Mask(mask_size, fill=fill)
+
+            to_surface = mask.to_surface(unsetsurface=unsetsurface)
+
+            self.assertIsInstance(to_surface, pygame.Surface)
+            self.assertEqual(to_surface.get_size(), mask_size)
+
+            # Different checks depending on if the mask was filled or not.
+            if fill:
+                assertSurfaceFilled(self, to_surface, default_setcolor)
+            else:
+                assertSurfaceFilled(
+                    self, to_surface, unsetsurface_color, unsetsurface_rect
+                )
+                assertSurfaceFilledIgnoreArea(
+                    self, to_surface, default_unsetcolor, unsetsurface_rect
+                )
+
+    @unittest.skipIf(IS_PYPY, "Segfaults on pypy")
+    def test_to_surface__all_surfaces_different_sizes_than_mask(self):
+        """Ensures that all the surface parameters can be of different sizes."""
+        default_setcolor = pygame.Color("white")
+        default_unsetcolor = pygame.Color("black")
+        surface_color = pygame.Color("red")
+        setsurface_color = pygame.Color("green")
+        unsetsurface_color = pygame.Color("blue")
+
+        mask_size = (10, 15)
+        surface_size = (11, 14)
+        setsurface_size = (9, 8)
+        unsetsurface_size = (12, 16)
+
+        surface = pygame.Surface(surface_size)
+        setsurface = pygame.Surface(setsurface_size)
+        unsetsurface = pygame.Surface(unsetsurface_size)
+
+        surface.fill(surface_color)
+        setsurface.fill(setsurface_color)
+        unsetsurface.fill(unsetsurface_color)
+
+        surface_rect = surface.get_rect()
+        setsurface_rect = setsurface.get_rect()
+        unsetsurface_rect = unsetsurface.get_rect()
+
+        # Create a mask that is filled except for a rect in the center.
+        mask = pygame.mask.Mask(mask_size, fill=True)
+        mask_rect = mask.get_rect()
+        unfilled_rect = pygame.Rect((0, 0), (4, 5))
+        unfilled_rect.center = mask_rect.center
+
+        for pos in (
+            (x, y)
+            for x in range(unfilled_rect.x, unfilled_rect.w)
+            for y in range(unfilled_rect.y, unfilled_rect.h)
+        ):
+            mask.set_at(pos, 0)
+
+        to_surface = mask.to_surface(surface, setsurface, unsetsurface)
+
+        self.assertIs(to_surface, surface)
+        self.assertEqual(to_surface.get_size(), surface_size)
+
+        # Check each surface pixel for the correct color.
+        to_surface.lock()  # Lock for possible speed up.
+
+        for pos in (
+            (x, y) for x in range(surface_rect.w) for y in range(surface_rect.h)
+        ):
+            if not mask_rect.collidepoint(pos):
+                expected_color = surface_color
+            elif mask.get_at(pos):
+                # Checking set bit colors.
+                if setsurface_rect.collidepoint(pos):
+                    expected_color = setsurface_color
+                else:
+                    expected_color = default_setcolor
+            else:
+                # Checking unset bit colors.
+                if unsetsurface_rect.collidepoint(pos):
+                    expected_color = unsetsurface_color
+                else:
+                    expected_color = default_unsetcolor
+
+            self.assertEqual(to_surface.get_at(pos), expected_color)
+
+        to_surface.unlock()
+
+    def test_to_surface__dest_locations(self):
+        """Ensures dest values can be different locations on/off the surface."""
+        SIDE = 7
+        surface = pygame.Surface((SIDE, SIDE))
+        surface_rect = surface.get_rect()
+        dest_rect = surface_rect.copy()
+
+        surface_color = pygame.Color("red")
+        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
+        )
+
+        for fill in (True, False):
+            mask = pygame.mask.Mask((SIDE, SIDE), fill=fill)
+            expected_color = default_setcolor if fill else default_unsetcolor
+
+            for direction in directions:
+                for pos in direction:
+                    dest_rect.topleft = pos
+                    overlap_rect = dest_rect.clip(surface_rect)
+                    surface.fill(surface_color)
+
+                    to_surface = mask.to_surface(surface, dest=dest_rect)
+
+                    assertSurfaceFilled(self, to_surface, expected_color, overlap_rect)
+                    assertSurfaceFilledIgnoreArea(
+                        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
+        surface = pygame.Surface((SIDE, SIDE))
+
+        surface_color = pygame.Color("red")
+        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
+        )
+
+        for fill in (True, False):
+            mask = pygame.mask.Mask((SIDE, SIDE), fill=fill)
+            mask_rect = mask.get_rect()
+            area_rect = mask_rect.copy()
+            expected_color = default_setcolor if fill else default_unsetcolor
+
+            for direction in directions:
+                for pos in direction:
+                    area_rect.topleft = pos
+                    overlap_rect = area_rect.clip(mask_rect)
+                    overlap_rect.topleft = (0, 0)
+                    surface.fill(surface_color)
+
+                    to_surface = mask.to_surface(surface, area=area_rect)
+
+                    assertSurfaceFilled(self, to_surface, expected_color, overlap_rect)
+                    assertSurfaceFilledIgnoreArea(
+                        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.
+        """
+        SIDE = 5
+        surface = pygame.Surface((SIDE, SIDE))
+        surface_rect = surface.get_rect()
+        dest_rect = surface_rect.copy()
+
+        surface_color = pygame.Color("red")
+        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
+        )
+
+        # Using only the topleft to bottomright diagonal to test the area (to
+        # reduce the number of loop iterations).
+        area_positions = list(dest_directions[2])
+
+        for fill in (True, False):
+            mask = pygame.mask.Mask((SIDE, SIDE), fill=fill)
+            mask_rect = mask.get_rect()
+            area_rect = mask_rect.copy()
+            expected_color = default_setcolor if fill else default_unsetcolor
+
+            for dest_direction in dest_directions:
+                for dest_pos in dest_direction:
+                    dest_rect.topleft = dest_pos
+
+                    for area_pos in area_positions:
+                        area_rect.topleft = area_pos
+                        area_overlap_rect = area_rect.clip(mask_rect)
+                        area_overlap_rect.topleft = dest_rect.topleft
+                        dest_overlap_rect = dest_rect.clip(area_overlap_rect)
+
+                        surface.fill(surface_color)
+
+                        to_surface = mask.to_surface(
+                            surface, dest=dest_rect, area=area_rect
+                        )
+
+                        assertSurfaceFilled(
+                            self, to_surface, expected_color, dest_overlap_rect
+                        )
+                        assertSurfaceFilledIgnoreArea(
+                            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
+        SIZES = (
+            (0, 0),
+            (0, 1),
+            (1, 0),
+            (1, 1),
+            (SIDE - 1, SIDE - 1),
+            (SIDE - 1, SIDE),
+            (SIDE, SIDE - 1),
+            (SIDE, SIDE),
+            (SIDE + 1, SIDE),
+            (SIDE, SIDE + 1),
+            (SIDE + 1, SIDE + 1),
+        )
+
+        surface = pygame.Surface((SIDE, SIDE))
+        surface_color = pygame.Color("red")
+        default_setcolor = pygame.Color("white")
+        default_unsetcolor = pygame.Color("black")
+
+        for fill in (True, False):
+            mask = pygame.mask.Mask((SIDE, SIDE), fill=fill)
+            mask_rect = mask.get_rect()
+            expected_color = default_setcolor if fill else default_unsetcolor
+
+            for size in SIZES:
+                area_rect = pygame.Rect((0, 0), size)
+
+                for pos in self.ORIGIN_OFFSETS:
+                    area_rect.topleft = pos
+                    overlap_rect = area_rect.clip(mask_rect)
+                    overlap_rect.topleft = (0, 0)
+                    surface.fill(surface_color)
+
+                    to_surface = mask.to_surface(surface, area=area_rect)
+
+                    assertSurfaceFilled(self, to_surface, expected_color, overlap_rect)
+                    assertSurfaceFilledIgnoreArea(
+                        self, to_surface, surface_color, overlap_rect
+                    )
+
+    def test_to_surface__surface_color_alphas(self):
+        """Ensures the setsurface/unsetsurface color alpha values are respected."""
+        size = (13, 17)
+        setsurface_color = pygame.Color("green")
+        setsurface_color.a = 53
+        unsetsurface_color = pygame.Color("blue")
+        unsetsurface_color.a = 109
+
+        setsurface = pygame.Surface(size, flags=SRCALPHA, depth=32)
+        unsetsurface = pygame.Surface(size, flags=SRCALPHA, depth=32)
+
+        setsurface.fill(setsurface_color)
+        unsetsurface.fill(unsetsurface_color)
+
+        for fill in (True, False):
+            mask = pygame.mask.Mask(size, fill=fill)
+            expected_color = setsurface_color if fill else unsetsurface_color
+
+            to_surface = mask.to_surface(
+                setsurface=setsurface, unsetsurface=unsetsurface
+            )
+
+            self.assertIsInstance(to_surface, pygame.Surface)
+            self.assertEqual(to_surface.get_size(), size)
+            assertSurfaceFilled(self, to_surface, expected_color)
+
+    def test_to_surface__color_alphas(self):
+        """Ensures the setcolor/unsetcolor alpha values are respected."""
+        size = (13, 17)
+        setcolor = pygame.Color("green")
+        setcolor.a = 35
+        unsetcolor = pygame.Color("blue")
+        unsetcolor.a = 213
+
+        for fill in (True, False):
+            mask = pygame.mask.Mask(size, fill=fill)
+            expected_color = setcolor if fill else unsetcolor
+
+            to_surface = mask.to_surface(setcolor=setcolor, unsetcolor=unsetcolor)
+
+            self.assertIsInstance(to_surface, pygame.Surface)
+            self.assertEqual(to_surface.get_size(), size)
+            assertSurfaceFilled(self, to_surface, expected_color)
+
+    def test_to_surface__depths(self):
+        """Ensures to_surface works correctly with supported surface depths."""
+        size = (13, 17)
+        surface_color = pygame.Color("red")
+        setsurface_color = pygame.Color("green")
+        unsetsurface_color = pygame.Color("blue")
+
+        for depth in (8, 16, 24, 32):
+            surface = pygame.Surface(size, depth=depth)
+            setsurface = pygame.Surface(size, depth=depth)
+            unsetsurface = pygame.Surface(size, depth=depth)
+
+            surface.fill(surface_color)
+            setsurface.fill(setsurface_color)
+            unsetsurface.fill(unsetsurface_color)
+
+            for fill in (True, False):
+                mask = pygame.mask.Mask(size, fill=fill)
+
+                # For non-32 bit depths, the actual color can be different from
+                # what was filled.
+                expected_color = (
+                    setsurface.get_at((0, 0)) if fill else unsetsurface.get_at((0, 0))
+                )
+
+                to_surface = mask.to_surface(surface, setsurface, unsetsurface)
+
+                self.assertIsInstance(to_surface, pygame.Surface)
+                self.assertEqual(to_surface.get_size(), size)
+                assertSurfaceFilled(self, to_surface, expected_color)
+
+    def test_to_surface__different_depths(self):
+        """Ensures an exception is raised when surfaces have different depths."""
+        size = (13, 17)
+        surface_color = pygame.Color("red")
+        setsurface_color = pygame.Color("green")
+        unsetsurface_color = pygame.Color("blue")
+        mask = pygame.mask.Mask(size)
+
+        # Test different combinations of depths.
+        test_depths = (
+            (8, 8, 16),  # surface/setsurface/unsetsurface
+            (8, 8, 24),
+            (8, 8, 32),
+            (16, 16, 24),
+            (16, 16, 32),
+            (24, 16, 8),
+            (32, 16, 16),
+            (32, 32, 16),
+            (32, 24, 32),
+        )
+
+        for depths in test_depths:
+            surface = pygame.Surface(size, depth=depths[0])
+            setsurface = pygame.Surface(size, depth=depths[1])
+            unsetsurface = pygame.Surface(size, depth=depths[2])
+
+            surface.fill(surface_color)
+            setsurface.fill(setsurface_color)
+            unsetsurface.fill(unsetsurface_color)
+
+            with self.assertRaises(ValueError):
+                mask.to_surface(surface, setsurface, unsetsurface)
+
+    def test_to_surface__different_depths_with_created_surfaces(self):
+        """Ensures an exception is raised when surfaces have different depths
+        than the created surface.
+        """
+        size = (13, 17)
+        setsurface_color = pygame.Color("green")
+        unsetsurface_color = pygame.Color("blue")
+        mask = pygame.mask.Mask(size)
+
+        # Test different combinations of depths. The created surface always has
+        # a depth of 32.
+        test_depths = (
+            (8, 8),  # setsurface/unsetsurface
+            (16, 16),
+            (24, 24),
+            (24, 16),
+            (32, 8),
+            (32, 16),
+            (32, 24),
+            (16, 32),
+        )
+
+        for set_depth, unset_depth in test_depths:
+            setsurface = pygame.Surface(size, depth=set_depth)
+            unsetsurface = pygame.Surface(size, depth=unset_depth)
+
+            setsurface.fill(setsurface_color)
+            unsetsurface.fill(unsetsurface_color)
+
+            with self.assertRaises(ValueError):
+                mask.to_surface(setsurface=setsurface, unsetsurface=unsetsurface)
+
+    def test_to_surface__same_srcalphas(self):
+        """Ensures to_surface works correctly when the SRCALPHA flag is set or not."""
+        size = (13, 17)
+        surface_color = pygame.Color("red")
+        setsurface_color = pygame.Color("green")
+        unsetsurface_color = pygame.Color("blue")
+
+        for depth in (16, 32):
+            for flags in (0, SRCALPHA):
+                surface = pygame.Surface(size, flags=flags, depth=depth)
+                setsurface = pygame.Surface(size, flags=flags, depth=depth)
+                unsetsurface = pygame.Surface(size, flags=flags, depth=depth)
+
+                surface.fill(surface_color)
+                setsurface.fill(setsurface_color)
+                unsetsurface.fill(unsetsurface_color)
+
+                for fill in (True, False):
+                    mask = pygame.mask.Mask(size, fill=fill)
+                    expected_color = setsurface_color if fill else unsetsurface_color
+
+                    to_surface = mask.to_surface(surface, setsurface, unsetsurface)
+
+                    self.assertIsInstance(to_surface, pygame.Surface)
+                    self.assertEqual(to_surface.get_size(), size)
+                    assertSurfaceFilled(self, to_surface, expected_color)
+                    if flags:
+                        self.assertTrue(to_surface.get_flags() & flags)
+
+    def test_to_surface__same_srcalphas_with_created_surfaces(self):
+        """Ensures to_surface works correctly when it creates a surface
+        and the SRCALPHA flag is set on both setsurface and unsetsurface.
+        """
+        size = (13, 17)
+        setsurface_color = pygame.Color("green")
+        unsetsurface_color = pygame.Color("blue")
+        # The created surface always has a depth of 32 and the SRCALPHA flag set.
+        expected_flags = SRCALPHA
+
+        setsurface = pygame.Surface(size, flags=expected_flags, depth=32)
+        unsetsurface = pygame.Surface(size, flags=expected_flags, depth=32)
+
+        setsurface.fill(setsurface_color)
+        unsetsurface.fill(unsetsurface_color)
+
+        for fill in (True, False):
+            mask = pygame.mask.Mask(size, fill=fill)
+            expected_color = setsurface_color if fill else unsetsurface_color
+
+            to_surface = mask.to_surface(
+                setsurface=setsurface, unsetsurface=unsetsurface
+            )
+
+            self.assertIsInstance(to_surface, pygame.Surface)
+            self.assertEqual(to_surface.get_size(), size)
+            assertSurfaceFilled(self, to_surface, expected_color)
+            self.assertTrue(to_surface.get_flags() & expected_flags)
+
+    def test_to_surface__different_srcalphas(self):
+        """Ensures an exception is raised when surfaces have different SRCALPHA
+        flag settings.
+        """
+        size = (13, 17)
+        surface_color = pygame.Color("red")
+        setsurface_color = pygame.Color("green")
+        unsetsurface_color = pygame.Color("blue")
+        mask = pygame.mask.Mask(size)
+
+        # Test different combinations of SRCALPHA flags.
+        test_flags = (
+            (SRCALPHA, 0, 0),  # surface/setsurface/unsetsurface
+            (SRCALPHA, SRCALPHA, 0),
+            (0, SRCALPHA, SRCALPHA),
+            (0, 0, SRCALPHA),
+        )
+
+        for depth in (16, 32):
+            for flags in test_flags:
+                surface = pygame.Surface(size, flags=flags[0], depth=depth)
+                setsurface = pygame.Surface(size, flags=flags[1], depth=depth)
+                unsetsurface = pygame.Surface(size, flags=flags[2], depth=depth)
+
+                surface.fill(surface_color)
+                setsurface.fill(setsurface_color)
+                unsetsurface.fill(unsetsurface_color)
+
+                with self.assertRaises(ValueError):
+                    mask.to_surface(surface, setsurface, unsetsurface)
+
+    def test_to_surface__different_srcalphas_with_created_surfaces(self):
+        """Ensures an exception is raised when surfaces have different SRCALPHA
+        flag settings than the created surface.
+        """
+        size = (13, 17)
+        setsurface_color = pygame.Color("green")
+        unsetsurface_color = pygame.Color("blue")
+        mask = pygame.mask.Mask(size)
+
+        for depth in (16, 32):
+            # Test different combinations of SRCALPHA flags. The created
+            # surface always has the SRCALPHA flag set.
+            for flags in ((0, 0), (SRCALPHA, 0), (0, SRCALPHA)):
+                setsurface = pygame.Surface(size, flags=flags[0], depth=depth)
+                unsetsurface = pygame.Surface(size, flags=flags[1], depth=depth)
+
+                setsurface.fill(setsurface_color)
+                unsetsurface.fill(unsetsurface_color)
+
+                with self.assertRaises(ValueError):
+                    mask.to_surface(setsurface=setsurface, unsetsurface=unsetsurface)
+
+    def test_to_surface__dest_on_surface(self):
+        """Ensures dest values on the surface work correctly
+        when using the defaults for setcolor and unsetcolor.
+        """
+        default_setcolor = pygame.Color("white")
+        default_unsetcolor = pygame.Color("black")
+        width, height = size = (5, 9)
+        surface = pygame.Surface(size, SRCALPHA, 32)
+        surface_color = pygame.Color("red")
+
+        for fill in (True, False):
+            mask = pygame.mask.Mask(size, fill=fill)
+            mask_rect = mask.get_rect()
+            expected_color = default_setcolor if fill else default_unsetcolor
+
+            # Test the dest parameter at different locations on the surface.
+            for dest in ((x, y) for y in range(height) for x in range(width)):
+                surface.fill(surface_color)  # Clear for each test.
+                mask_rect.topleft = dest
+
+                to_surface = mask.to_surface(surface, dest=dest)
+
+                self.assertIs(to_surface, surface)
+                self.assertEqual(to_surface.get_size(), size)
+                assertSurfaceFilled(self, to_surface, expected_color, mask_rect)
+                assertSurfaceFilledIgnoreArea(
+                    self, to_surface, surface_color, mask_rect
+                )
+
+    def test_to_surface__dest_on_surface_with_setsurface_unsetsurface(self):
+        """Ensures dest values on the surface work correctly
+        when using setsurface and unsetsurface.
+        """
+        width, height = size = (5, 9)
+        surface = pygame.Surface(size, SRCALPHA, 32)
+        surface_color = pygame.Color("red")
+
+        setsurface = surface.copy()
+        setsurface_color = pygame.Color("green")
+        setsurface.fill(setsurface_color)
+
+        unsetsurface = surface.copy()
+        unsetsurface_color = pygame.Color("blue")
+        unsetsurface.fill(unsetsurface_color)
+
+        # Using different kwargs to exercise different to_surface() code.
+        # Should not have any impact on the resulting drawn surfaces.
+        kwargs = {
+            "surface": surface,
+            "setsurface": setsurface,
+            "unsetsurface": unsetsurface,
+            "dest": None,
+        }
+
+        color_kwargs = dict(kwargs)
+        color_kwargs.update((("setcolor", None), ("unsetcolor", None)))
+
+        for fill in (True, False):
+            mask = pygame.mask.Mask(size, fill=fill)
+            mask_rect = mask.get_rect()
+            expected_color = setsurface_color if fill else unsetsurface_color
+
+            # Test the dest parameter at different locations on the surface.
+            for dest in ((x, y) for y in range(height) for x in range(width)):
+                mask_rect.topleft = dest
+
+                for use_color_params in (True, False):
+                    surface.fill(surface_color)  # Clear for each test.
+
+                    test_kwargs = color_kwargs if use_color_params else kwargs
+                    test_kwargs["dest"] = dest
+                    to_surface = mask.to_surface(**test_kwargs)
+
+                    self.assertIs(to_surface, surface)
+                    self.assertEqual(to_surface.get_size(), size)
+                    assertSurfaceFilled(self, to_surface, expected_color, mask_rect)
+                    assertSurfaceFilledIgnoreArea(
+                        self, to_surface, surface_color, mask_rect
+                    )
+
+    def test_to_surface__dest_off_surface(self):
+        """Ensures dest values off the surface work correctly
+        when using the defaults for setcolor and unsetcolor.
+        """
+        default_setcolor = pygame.Color("white")
+        default_unsetcolor = pygame.Color("black")
+        width, height = size = (5, 7)
+        surface = pygame.Surface(size, SRCALPHA, 32)
+        surface_color = pygame.Color("red")
+
+        # Test different dests off the surface.
+        dests = [(-width, -height), (-width, 0), (0, -height)]
+        dests.extend(off_corners(surface.get_rect()))
+
+        for fill in (True, False):
+            mask = pygame.mask.Mask(size, fill=fill)
+            mask_rect = mask.get_rect()
+            expected_color = default_setcolor if fill else default_unsetcolor
+
+            for dest in dests:
+                surface.fill(surface_color)  # Clear for each test.
+                mask_rect.topleft = dest
+
+                to_surface = mask.to_surface(surface, dest=dest)
+
+                self.assertIs(to_surface, surface)
+                self.assertEqual(to_surface.get_size(), size)
+                assertSurfaceFilled(self, to_surface, expected_color, mask_rect)
+                assertSurfaceFilledIgnoreArea(
+                    self, to_surface, surface_color, mask_rect
+                )
+
+    def test_to_surface__dest_off_surface_with_setsurface_unsetsurface(self):
+        """Ensures dest values off the surface work correctly
+        when using setsurface and unsetsurface.
+        """
+        width, height = size = (5, 7)
+        surface = pygame.Surface(size, SRCALPHA, 32)
+        surface_color = pygame.Color("red")
+
+        setsurface = surface.copy()
+        setsurface_color = pygame.Color("green")
+        setsurface.fill(setsurface_color)
+
+        unsetsurface = surface.copy()
+        unsetsurface_color = pygame.Color("blue")
+        unsetsurface.fill(unsetsurface_color)
+
+        # Test different dests off the surface.
+        dests = [(-width, -height), (-width, 0), (0, -height)]
+        dests.extend(off_corners(surface.get_rect()))
+
+        # Using different kwargs to exercise different to_surface() code.
+        # Should not have any impact on the resulting drawn surfaces.
+        kwargs = {
+            "surface": surface,
+            "setsurface": setsurface,
+            "unsetsurface": unsetsurface,
+            "dest": None,
+        }
+
+        color_kwargs = dict(kwargs)
+        color_kwargs.update((("setcolor", None), ("unsetcolor", None)))
+
+        for fill in (True, False):
+            mask = pygame.mask.Mask(size, fill=fill)
+            mask_rect = mask.get_rect()
+            expected_color = setsurface_color if fill else unsetsurface_color
+
+            for dest in dests:
+                mask_rect.topleft = dest
+
+                for use_color_params in (True, False):
+                    surface.fill(surface_color)  # Clear for each test.
+                    test_kwargs = color_kwargs if use_color_params else kwargs
+                    test_kwargs["dest"] = dest
+                    to_surface = mask.to_surface(**test_kwargs)
+
+                    self.assertIs(to_surface, surface)
+                    self.assertEqual(to_surface.get_size(), size)
+                    assertSurfaceFilled(self, to_surface, expected_color, mask_rect)
+                    assertSurfaceFilledIgnoreArea(
+                        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.
+        """
+        default_setcolor = pygame.Color("white")
+        default_unsetcolor = pygame.Color("black")
+        width, height = size = (5, 9)
+        surface = pygame.Surface(size, SRCALPHA, 32)
+        surface_color = pygame.Color("red")
+
+        for fill in (True, False):
+            mask = pygame.mask.Mask(size, fill=fill)
+            mask_rect = mask.get_rect()
+            area_rect = mask_rect.copy()
+            expected_color = default_setcolor if fill else default_unsetcolor
+
+            # Testing the area parameter at different locations on the mask.
+            for pos in ((x, y) for y in range(height) for x in range(width)):
+                surface.fill(surface_color)  # Clear for each test.
+                area_rect.topleft = pos
+                overlap_rect = mask_rect.clip(area_rect)
+                overlap_rect.topleft = (0, 0)
+
+                to_surface = mask.to_surface(surface, area=area_rect)
+
+                self.assertIs(to_surface, surface)
+                self.assertEqual(to_surface.get_size(), size)
+                assertSurfaceFilled(self, to_surface, expected_color, overlap_rect)
+                assertSurfaceFilledIgnoreArea(
+                    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.
+        """
+        width, height = size = (5, 9)
+        surface = pygame.Surface(size, SRCALPHA, 32)
+        surface_color = pygame.Color("red")
+
+        setsurface = surface.copy()
+        setsurface_color = pygame.Color("green")
+        setsurface.fill(setsurface_color)
+
+        unsetsurface = surface.copy()
+        unsetsurface_color = pygame.Color("blue")
+        unsetsurface.fill(unsetsurface_color)
+
+        # Using the values in kwargs vs color_kwargs tests different to_surface
+        # code. Should not have any impact on the resulting drawn surfaces.
+        kwargs = {
+            "surface": surface,
+            "setsurface": setsurface,
+            "unsetsurface": unsetsurface,
+            "area": pygame.Rect((0, 0), size),
+        }
+
+        color_kwargs = dict(kwargs)
+        color_kwargs.update((("setcolor", None), ("unsetcolor", None)))
+
+        for fill in (True, False):
+            mask = pygame.mask.Mask(size, fill=fill)
+            mask_rect = mask.get_rect()
+            area_rect = mask_rect.copy()
+            expected_color = setsurface_color if fill else unsetsurface_color
+
+            # Testing the area parameter at different locations on the mask.
+            for pos in ((x, y) for y in range(height) for x in range(width)):
+                area_rect.topleft = pos
+                overlap_rect = mask_rect.clip(area_rect)
+                overlap_rect.topleft = (0, 0)
+
+                for use_color_params in (True, False):
+                    surface.fill(surface_color)  # Clear for each test.
+                    test_kwargs = color_kwargs if use_color_params else kwargs
+                    test_kwargs["area"].topleft = pos
+                    overlap_rect = mask_rect.clip(test_kwargs["area"])
+                    overlap_rect.topleft = (0, 0)
+
+                    to_surface = mask.to_surface(**test_kwargs)
+
+                    self.assertIs(to_surface, surface)
+                    self.assertEqual(to_surface.get_size(), size)
+                    assertSurfaceFilled(self, to_surface, expected_color, overlap_rect)
+                    assertSurfaceFilledIgnoreArea(
+                        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.
+        """
+        default_setcolor = pygame.Color("white")
+        default_unsetcolor = pygame.Color("black")
+        width, height = size = (5, 7)
+        surface = pygame.Surface(size, SRCALPHA, 32)
+        surface_color = pygame.Color("red")
+
+        # Testing positions off the mask.
+        positions = [(-width, -height), (-width, 0), (0, -height)]
+        positions.extend(off_corners(pygame.Rect((0, 0), (width, height))))
+
+        for fill in (True, False):
+            mask = pygame.mask.Mask(size, fill=fill)
+            mask_rect = mask.get_rect()
+            area_rect = mask_rect.copy()
+            expected_color = default_setcolor if fill else default_unsetcolor
+
+            for pos in positions:
+                surface.fill(surface_color)  # Clear for each test.
+                area_rect.topleft = pos
+                overlap_rect = mask_rect.clip(area_rect)
+                overlap_rect.topleft = (0, 0)
+
+                to_surface = mask.to_surface(surface, area=area_rect)
+
+                self.assertIs(to_surface, surface)
+                self.assertEqual(to_surface.get_size(), size)
+                assertSurfaceFilled(self, to_surface, expected_color, overlap_rect)
+                assertSurfaceFilledIgnoreArea(
+                    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.
+        """
+        width, height = size = (5, 7)
+        surface = pygame.Surface(size, SRCALPHA, 32)
+        surface_color = pygame.Color("red")
+
+        setsurface = surface.copy()
+        setsurface_color = pygame.Color("green")
+        setsurface.fill(setsurface_color)
+
+        unsetsurface = surface.copy()
+        unsetsurface_color = pygame.Color("blue")
+        unsetsurface.fill(unsetsurface_color)
+
+        # Testing positions off the mask.
+        positions = [(-width, -height), (-width, 0), (0, -height)]
+        positions.extend(off_corners(pygame.Rect((0, 0), (width, height))))
+
+        # Using the values in kwargs vs color_kwargs tests different to_surface
+        # code. Should not have any impact on the resulting drawn surfaces.
+        kwargs = {
+            "surface": surface,
+            "setsurface": setsurface,
+            "unsetsurface": unsetsurface,
+            "area": pygame.Rect((0, 0), size),
+        }
+
+        color_kwargs = dict(kwargs)
+        color_kwargs.update((("setcolor", None), ("unsetcolor", None)))
+
+        for fill in (True, False):
+            mask = pygame.mask.Mask(size, fill=fill)
+            mask_rect = mask.get_rect()
+            expected_color = setsurface_color if fill else unsetsurface_color
+
+            for pos in positions:
+                for use_color_params in (True, False):
+                    surface.fill(surface_color)  # Clear for each test.
+                    test_kwargs = color_kwargs if use_color_params else kwargs
+                    test_kwargs["area"].topleft = pos
+                    overlap_rect = mask_rect.clip(test_kwargs["area"])
+                    overlap_rect.topleft = (0, 0)
+
+                    to_surface = mask.to_surface(**test_kwargs)
+
+                    self.assertIs(to_surface, surface)
+                    self.assertEqual(to_surface.get_size(), size)
+                    assertSurfaceFilled(self, to_surface, expected_color, overlap_rect)
+                    assertSurfaceFilledIgnoreArea(
+                        self, to_surface, surface_color, overlap_rect
+                    )
+
+    def test_to_surface__surface_with_zero_size(self):
+        """Ensures zero sized surfaces are handled correctly."""
+        expected_ref_count = 3
+        size = (0, 0)
+        surface = pygame.Surface(size)
+        mask = pygame.mask.Mask((3, 4), fill=True)
+
+        to_surface = mask.to_surface(surface)
+
+        self.assertIs(to_surface, surface)
+        if not IS_PYPY:
+            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 = 2
+        expected_flag = SRCALPHA
+        expected_depth = 32
+        expected_color = pygame.Color("white")  # Default setcolor.
+        mask_size = (2, 4)
+        mask = pygame.mask.Mask(mask_size, fill=True)
+        setsurface = pygame.Surface((0, 0), expected_flag, expected_depth)
+
+        to_surface = mask.to_surface(setsurface=setsurface)
+
+        self.assertIsInstance(to_surface, pygame.Surface)
+        if not IS_PYPY:
+            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)
+        assertSurfaceFilled(self, to_surface, expected_color)
+
+    def test_to_surface__unsetsurface_with_zero_size(self):
+        """Ensures zero sized unsetsurfaces are handled correctly."""
+        expected_ref_count = 2
+        expected_flag = SRCALPHA
+        expected_depth = 32
+        expected_color = pygame.Color("black")  # Default unsetcolor.
+        mask_size = (4, 2)
+        mask = pygame.mask.Mask(mask_size)
+        unsetsurface = pygame.Surface((0, 0), expected_flag, expected_depth)
+
+        to_surface = mask.to_surface(unsetsurface=unsetsurface)
+
+        self.assertIsInstance(to_surface, pygame.Surface)
+        if not IS_PYPY:
+            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)
+        assertSurfaceFilled(self, to_surface, expected_color)
+
+    def test_zero_mask(self):
+        """Ensures masks can be created with zero sizes."""
+        for size in ((100, 0), (0, 100), (0, 0)):
+            for fill in (True, False):
+                msg = f"size={size}, fill={fill}"
+
+                mask = pygame.mask.Mask(size, fill=fill)
+
+                self.assertIsInstance(mask, pygame.mask.Mask, msg)
+                self.assertEqual(mask.get_size(), size, msg)
+
+    def test_zero_mask_copy(self):
+        """Ensures copy correctly handles zero sized masks."""
+        for expected_size in ((11, 0), (0, 11), (0, 0)):
+            mask = pygame.mask.Mask(expected_size)
+
+            mask_copy = mask.copy()
+
+            self.assertIsInstance(mask_copy, pygame.mask.Mask)
+            self.assertIsNot(mask_copy, mask)
+            assertMaskEqual(self, mask_copy, mask)
+
+    def test_zero_mask_get_size(self):
+        """Ensures get_size correctly handles zero sized masks."""
+        for expected_size in ((41, 0), (0, 40), (0, 0)):
+            mask = pygame.mask.Mask(expected_size)
+
+            size = mask.get_size()
+
+            self.assertEqual(size, expected_size)
+
+    def test_zero_mask_get_rect(self):
+        """Ensures get_rect correctly handles zero sized masks."""
+        for expected_size in ((4, 0), (0, 4), (0, 0)):
+            expected_rect = pygame.Rect((0, 0), expected_size)
+            mask = pygame.mask.Mask(expected_size)
+
+            rect = mask.get_rect()
+
+            self.assertEqual(rect, expected_rect)
+
+    def test_zero_mask_get_at(self):
+        """Ensures get_at correctly handles zero sized masks."""
+        for size in ((51, 0), (0, 50), (0, 0)):
+            mask = pygame.mask.Mask(size)
+
+            with self.assertRaises(IndexError):
+                value = mask.get_at((0, 0))
+
+    def test_zero_mask_set_at(self):
+        """Ensures set_at correctly handles zero sized masks."""
+        for size in ((31, 0), (0, 30), (0, 0)):
+            mask = pygame.mask.Mask(size)
+
+            with self.assertRaises(IndexError):
+                mask.set_at((0, 0))
+
+    def test_zero_mask_overlap(self):
+        """Ensures overlap correctly handles zero sized masks.
+
+        Tests combinations of sized and zero sized masks.
+        """
+        offset = (0, 0)
+
+        for size1, size2 in zero_size_pairs(51, 42):
+            msg = f"size1={size1}, size2={size2}"
+            mask1 = pygame.mask.Mask(size1, fill=True)
+            mask2 = pygame.mask.Mask(size2, fill=True)
+
+            overlap_pos = mask1.overlap(mask2, offset)
+
+            self.assertIsNone(overlap_pos, msg)
+
+    def test_zero_mask_overlap_area(self):
+        """Ensures overlap_area correctly handles zero sized masks.
+
+        Tests combinations of sized and zero sized masks.
+        """
+        offset = (0, 0)
+        expected_count = 0
+
+        for size1, size2 in zero_size_pairs(41, 52):
+            msg = f"size1={size1}, size2={size2}"
+            mask1 = pygame.mask.Mask(size1, fill=True)
+            mask2 = pygame.mask.Mask(size2, fill=True)
+
+            overlap_count = mask1.overlap_area(mask2, offset)
+
+            self.assertEqual(overlap_count, expected_count, msg)
+
+    def test_zero_mask_overlap_mask(self):
+        """Ensures overlap_mask correctly handles zero sized masks.
+
+        Tests combinations of sized and zero sized masks.
+        """
+        offset = (0, 0)
+        expected_count = 0
+
+        for size1, size2 in zero_size_pairs(43, 53):
+            msg = f"size1={size1}, size2={size2}"
+            mask1 = pygame.mask.Mask(size1, fill=True)
+            mask2 = pygame.mask.Mask(size2, fill=True)
+
+            overlap_mask = mask1.overlap_mask(mask2, offset)
+
+            self.assertIsInstance(overlap_mask, pygame.mask.Mask, msg)
+            self.assertEqual(overlap_mask.count(), expected_count, msg)
+            self.assertEqual(overlap_mask.get_size(), size1, msg)
+
+    def test_zero_mask_fill(self):
+        """Ensures fill correctly handles zero sized masks."""
+        expected_count = 0
+
+        for size in ((100, 0), (0, 100), (0, 0)):
+            mask = pygame.mask.Mask(size)
+
+            mask.fill()
+
+            self.assertEqual(mask.count(), expected_count, f"size={size}")
+
+    def test_zero_mask_clear(self):
+        sizes = ((100, 0), (0, 100), (0, 0))
+
+        for size in sizes:
+            mask = pygame.mask.Mask(size)
+            mask.clear()
+            self.assertEqual(mask.count(), 0)
+
+    def test_zero_mask_flip(self):
+        sizes = ((100, 0), (0, 100), (0, 0))
+
+        for size in sizes:
+            mask = pygame.mask.Mask(size)
+            mask.invert()
+            self.assertEqual(mask.count(), 0)
+
+    def test_zero_mask_scale(self):
+        sizes = ((100, 0), (0, 100), (0, 0))
+
+        for size in sizes:
+            mask = pygame.mask.Mask(size)
+            mask2 = mask.scale((2, 3))
+
+            self.assertIsInstance(mask2, pygame.mask.Mask)
+            self.assertEqual(mask2.get_size(), (2, 3))
+
+    def test_zero_mask_draw(self):
+        """Ensures draw correctly handles zero sized masks.
+
+        Tests combinations of sized and zero sized masks.
+        """
+        offset = (0, 0)
+
+        for size1, size2 in zero_size_pairs(31, 37):
+            msg = f"size1={size1}, size2={size2}"
+            mask1 = pygame.mask.Mask(size1, fill=True)
+            mask2 = pygame.mask.Mask(size2, fill=True)
+            expected_count = mask1.count()
+
+            mask1.draw(mask2, offset)
+
+            self.assertEqual(mask1.count(), expected_count, msg)
+            self.assertEqual(mask1.get_size(), size1, msg)
+
+    def test_zero_mask_erase(self):
+        """Ensures erase correctly handles zero sized masks.
+
+        Tests combinations of sized and zero sized masks.
+        """
+        offset = (0, 0)
+
+        for size1, size2 in zero_size_pairs(29, 23):
+            msg = f"size1={size1}, size2={size2}"
+            mask1 = pygame.mask.Mask(size1, fill=True)
+            mask2 = pygame.mask.Mask(size2, fill=True)
+            expected_count = mask1.count()
+
+            mask1.erase(mask2, offset)
+
+            self.assertEqual(mask1.count(), expected_count, msg)
+            self.assertEqual(mask1.get_size(), size1, msg)
+
+    def test_zero_mask_count(self):
+        sizes = ((100, 0), (0, 100), (0, 0))
+
+        for size in sizes:
+            mask = pygame.mask.Mask(size, fill=True)
+            self.assertEqual(mask.count(), 0)
+
+    def test_zero_mask_centroid(self):
+        sizes = ((100, 0), (0, 100), (0, 0))
+
+        for size in sizes:
+            mask = pygame.mask.Mask(size)
+            self.assertEqual(mask.centroid(), (0, 0))
+
+    def test_zero_mask_angle(self):
+        sizes = ((100, 0), (0, 100), (0, 0))
+
+        for size in sizes:
+            mask = pygame.mask.Mask(size)
+            self.assertEqual(mask.angle(), 0.0)
+
+    def test_zero_mask_outline(self):
+        """Ensures outline correctly handles zero sized masks."""
+        expected_points = []
+
+        for size in ((61, 0), (0, 60), (0, 0)):
+            mask = pygame.mask.Mask(size)
+
+            points = mask.outline()
+
+            self.assertListEqual(points, expected_points, f"size={size}")
+
+    def test_zero_mask_outline__with_arg(self):
+        """Ensures outline correctly handles zero sized masks
+        when using the skip pixels argument."""
+        expected_points = []
+
+        for size in ((66, 0), (0, 65), (0, 0)):
+            mask = pygame.mask.Mask(size)
+
+            points = mask.outline(10)
+
+            self.assertListEqual(points, expected_points, f"size={size}")
+
+    def test_zero_mask_convolve(self):
+        """Ensures convolve correctly handles zero sized masks.
+
+        Tests the different combinations of sized and zero sized masks.
+        """
+        for size1 in ((17, 13), (71, 0), (0, 70), (0, 0)):
+            mask1 = pygame.mask.Mask(size1, fill=True)
+
+            for size2 in ((11, 7), (81, 0), (0, 60), (0, 0)):
+                msg = f"sizes={size1}, {size2}"
+                mask2 = pygame.mask.Mask(size2, fill=True)
+                expected_size = (
+                    max(0, size1[0] + size2[0] - 1),
+                    max(0, size1[1] + size2[1] - 1),
+                )
+
+                mask = mask1.convolve(mask2)
+
+                self.assertIsInstance(mask, pygame.mask.Mask, msg)
+                self.assertIsNot(mask, mask2, msg)
+                self.assertEqual(mask.get_size(), expected_size, msg)
+
+    def test_zero_mask_convolve__with_output_mask(self):
+        """Ensures convolve correctly handles zero sized masks
+        when using an output mask argument.
+
+        Tests the different combinations of sized and zero sized masks.
+        """
+        for size1 in ((11, 17), (91, 0), (0, 90), (0, 0)):
+            mask1 = pygame.mask.Mask(size1, fill=True)
+
+            for size2 in ((13, 11), (83, 0), (0, 62), (0, 0)):
+                mask2 = pygame.mask.Mask(size2, fill=True)
+
+                for output_size in ((7, 5), (71, 0), (0, 70), (0, 0)):
+                    msg = f"sizes={size1}, {size2}, {output_size}"
+                    output_mask = pygame.mask.Mask(output_size)
+
+                    mask = mask1.convolve(mask2, output_mask)
+
+                    self.assertIsInstance(mask, pygame.mask.Mask, msg)
+                    self.assertIs(mask, output_mask, msg)
+                    self.assertEqual(mask.get_size(), output_size, msg)
+
+    def test_zero_mask_connected_component(self):
+        """Ensures connected_component correctly handles zero sized masks."""
+        expected_count = 0
+
+        for size in ((81, 0), (0, 80), (0, 0)):
+            msg = f"size={size}"
+            mask = pygame.mask.Mask(size)
+
+            cc_mask = mask.connected_component()
+
+            self.assertIsInstance(cc_mask, pygame.mask.Mask, msg)
+            self.assertEqual(cc_mask.get_size(), size)
+            self.assertEqual(cc_mask.count(), expected_count, msg)
+
+    def test_zero_mask_connected_component__indexed(self):
+        """Ensures connected_component correctly handles zero sized masks
+        when using an index argument."""
+        for size in ((91, 0), (0, 90), (0, 0)):
+            mask = pygame.mask.Mask(size)
+
+            with self.assertRaises(IndexError):
+                cc_mask = mask.connected_component((0, 0))
+
+    def test_zero_mask_connected_components(self):
+        """Ensures connected_components correctly handles zero sized masks."""
+        expected_cc_masks = []
+
+        for size in ((11, 0), (0, 10), (0, 0)):
+            mask = pygame.mask.Mask(size)
+
+            cc_masks = mask.connected_components()
+
+            self.assertListEqual(cc_masks, expected_cc_masks, f"size={size}")
+
+    def test_zero_mask_get_bounding_rects(self):
+        """Ensures get_bounding_rects correctly handles zero sized masks."""
+        expected_bounding_rects = []
+
+        for size in ((21, 0), (0, 20), (0, 0)):
+            mask = pygame.mask.Mask(size)
+
+            bounding_rects = mask.get_bounding_rects()
+
+            self.assertListEqual(
+                bounding_rects, expected_bounding_rects, f"size={size}"
+            )
+
+    def test_zero_mask_to_surface(self):
+        """Ensures to_surface correctly handles zero sized masks and surfaces."""
+        mask_color = pygame.Color("blue")
+        surf_color = pygame.Color("red")
+
+        for surf_size in ((7, 3), (7, 0), (0, 7), (0, 0)):
+            surface = pygame.Surface(surf_size, SRCALPHA, 32)
+            surface.fill(surf_color)
+
+            for mask_size in ((5, 0), (0, 5), (0, 0)):
+                mask = pygame.mask.Mask(mask_size, fill=True)
+
+                to_surface = mask.to_surface(surface, setcolor=mask_color)
+
+                self.assertIs(to_surface, surface)
+                self.assertEqual(to_surface.get_size(), surf_size)
+
+                if 0 not in surf_size:
+                    assertSurfaceFilled(self, to_surface, surf_color)
+
+    def test_zero_mask_to_surface__create_surface(self):
+        """Ensures to_surface correctly handles zero sized masks and surfaces
+        when it has to create a default surface.
+        """
+        mask_color = pygame.Color("blue")
+
+        for mask_size in ((3, 0), (0, 3), (0, 0)):
+            mask = pygame.mask.Mask(mask_size, fill=True)
+
+            to_surface = mask.to_surface(setcolor=mask_color)
+
+            self.assertIsInstance(to_surface, pygame.Surface)
+            self.assertEqual(to_surface.get_size(), mask_size)
+
+
+class SubMask(pygame.mask.Mask):
+    """Subclass of the Mask class to help test subclassing."""
+
+    def __init__(self, *args, **kwargs):
+        super().__init__(*args, **kwargs)
+        self.test_attribute = True
+
+
+class SubMaskCopy(SubMask):
+    """Subclass of the Mask class to help test copying subclasses."""
+
+    def copy(self):
+        mask_copy = super().copy()
+        mask_copy.test_attribute = self.test_attribute
+        return mask_copy
+
+
+class SubMaskDunderCopy(SubMask):
+    """Subclass of the Mask class to help test copying subclasses."""
+
+    def __copy__(self):
+        mask_copy = super().__copy__()
+        mask_copy.test_attribute = self.test_attribute
+        return mask_copy
+
+
+class SubMaskCopyAndDunderCopy(SubMaskDunderCopy):
+    """Subclass of the Mask class to help test copying subclasses."""
+
+    def copy(self):
+        return super().copy()
+
+
+class MaskSubclassTest(unittest.TestCase):
+    """Test subclassed Masks."""
+
+    def test_subclass_mask(self):
+        """Ensures the Mask class can be subclassed."""
+        mask = SubMask((5, 3), fill=True)
+
+        self.assertIsInstance(mask, pygame.mask.Mask)
+        self.assertIsInstance(mask, SubMask)
+        self.assertTrue(mask.test_attribute)
+
+    def test_subclass_copy(self):
+        """Ensures copy works for subclassed Masks."""
+        mask = SubMask((65, 2), fill=True)
+
+        # Test both the copy() and __copy__() methods.
+        for mask_copy in (mask.copy(), copy.copy(mask)):
+            self.assertIsInstance(mask_copy, pygame.mask.Mask)
+            self.assertIsInstance(mask_copy, SubMask)
+            self.assertIsNot(mask_copy, mask)
+            assertMaskEqual(self, mask_copy, mask)
+            # No subclass attributes because copy()/__copy__() not overridden.
+            self.assertFalse(hasattr(mask_copy, "test_attribute"))
+
+    def test_subclass_copy__override_copy(self):
+        """Ensures copy works for subclassed Masks overriding copy."""
+        mask = SubMaskCopy((65, 2), fill=True)
+
+        # Test both the copy() and __copy__() methods.
+        for i, mask_copy in enumerate((mask.copy(), copy.copy(mask))):
+            self.assertIsInstance(mask_copy, pygame.mask.Mask)
+            self.assertIsInstance(mask_copy, SubMaskCopy)
+            self.assertIsNot(mask_copy, mask)
+            assertMaskEqual(self, mask_copy, mask)
+
+            if 1 == i:
+                # No subclass attributes because __copy__() not overridden.
+                self.assertFalse(hasattr(mask_copy, "test_attribute"))
+            else:
+                self.assertTrue(mask_copy.test_attribute)
+
+    def test_subclass_copy__override_dunder_copy(self):
+        """Ensures copy works for subclassed Masks overriding __copy__."""
+        mask = SubMaskDunderCopy((65, 2), fill=True)
+
+        # Test both the copy() and __copy__() methods.
+        for mask_copy in (mask.copy(), copy.copy(mask)):
+            self.assertIsInstance(mask_copy, pygame.mask.Mask)
+            self.assertIsInstance(mask_copy, SubMaskDunderCopy)
+            self.assertIsNot(mask_copy, mask)
+            assertMaskEqual(self, mask_copy, mask)
+            # Calls to copy() eventually call __copy__() internally so the
+            # attributes will be copied.
+            self.assertTrue(mask_copy.test_attribute)
+
+    def test_subclass_copy__override_both_copy_methods(self):
+        """Ensures copy works for subclassed Masks overriding copy/__copy__."""
+        mask = SubMaskCopyAndDunderCopy((65, 2), fill=True)
+
+        # Test both the copy() and __copy__() methods.
+        for mask_copy in (mask.copy(), copy.copy(mask)):
+            self.assertIsInstance(mask_copy, pygame.mask.Mask)
+            self.assertIsInstance(mask_copy, SubMaskCopyAndDunderCopy)
+            self.assertIsNot(mask_copy, mask)
+            assertMaskEqual(self, mask_copy, mask)
+            self.assertTrue(mask_copy.test_attribute)
+
+    def test_subclass_get_size(self):
+        """Ensures get_size works for subclassed Masks."""
+        expected_size = (2, 3)
+        mask = SubMask(expected_size)
+
+        size = mask.get_size()
+
+        self.assertEqual(size, expected_size)
+
+    def test_subclass_mask_get_rect(self):
+        """Ensures get_rect works for subclassed Masks."""
+        expected_rect = pygame.Rect((0, 0), (65, 33))
+        mask = SubMask(expected_rect.size, fill=True)
+
+        rect = mask.get_rect()
+
+        self.assertEqual(rect, expected_rect)
+
+    def test_subclass_get_at(self):
+        """Ensures get_at works for subclassed Masks."""
+        expected_bit = 1
+        mask = SubMask((3, 2), fill=True)
+
+        bit = mask.get_at((0, 0))
+
+        self.assertEqual(bit, expected_bit)
+
+    def test_subclass_set_at(self):
+        """Ensures set_at works for subclassed Masks."""
+        expected_bit = 1
+        expected_count = 1
+        pos = (0, 0)
+        mask = SubMask(fill=False, size=(4, 2))
+
+        mask.set_at(pos)
+
+        self.assertEqual(mask.get_at(pos), expected_bit)
+        self.assertEqual(mask.count(), expected_count)
+
+    def test_subclass_overlap(self):
+        """Ensures overlap works for subclassed Masks."""
+        expected_pos = (0, 0)
+        mask_size = (2, 3)
+        masks = (pygame.mask.Mask(fill=True, size=mask_size), SubMask(mask_size, True))
+        arg_masks = (
+            pygame.mask.Mask(fill=True, size=mask_size),
+            SubMask(mask_size, True),
+        )
+
+        # Test different combinations of subclassed and non-subclassed Masks.
+        for mask in masks:
+            for arg_mask in arg_masks:
+                overlap_pos = mask.overlap(arg_mask, (0, 0))
+
+                self.assertEqual(overlap_pos, expected_pos)
+
+    def test_subclass_overlap_area(self):
+        """Ensures overlap_area works for subclassed Masks."""
+        mask_size = (3, 2)
+        expected_count = mask_size[0] * mask_size[1]
+        masks = (pygame.mask.Mask(fill=True, size=mask_size), SubMask(mask_size, True))
+        arg_masks = (
+            pygame.mask.Mask(fill=True, size=mask_size),
+            SubMask(mask_size, True),
+        )
+
+        # Test different combinations of subclassed and non-subclassed Masks.
+        for mask in masks:
+            for arg_mask in arg_masks:
+                overlap_count = mask.overlap_area(arg_mask, (0, 0))
+
+                self.assertEqual(overlap_count, expected_count)
+
+    def test_subclass_overlap_mask(self):
+        """Ensures overlap_mask works for subclassed Masks."""
+        expected_size = (4, 5)
+        expected_count = expected_size[0] * expected_size[1]
+        masks = (
+            pygame.mask.Mask(fill=True, size=expected_size),
+            SubMask(expected_size, True),
+        )
+        arg_masks = (
+            pygame.mask.Mask(fill=True, size=expected_size),
+            SubMask(expected_size, True),
+        )
+
+        # Test different combinations of subclassed and non-subclassed Masks.
+        for mask in masks:
+            for arg_mask in arg_masks:
+                overlap_mask = mask.overlap_mask(arg_mask, (0, 0))
+
+                self.assertIsInstance(overlap_mask, pygame.mask.Mask)
+                self.assertNotIsInstance(overlap_mask, SubMask)
+                self.assertEqual(overlap_mask.count(), expected_count)
+                self.assertEqual(overlap_mask.get_size(), expected_size)
+
+    def test_subclass_fill(self):
+        """Ensures fill works for subclassed Masks."""
+        mask_size = (2, 4)
+        expected_count = mask_size[0] * mask_size[1]
+        mask = SubMask(fill=False, size=mask_size)
+
+        mask.fill()
+
+        self.assertEqual(mask.count(), expected_count)
+
+    def test_subclass_clear(self):
+        """Ensures clear works for subclassed Masks."""
+        mask_size = (4, 3)
+        expected_count = 0
+        mask = SubMask(mask_size, True)
+
+        mask.clear()
+
+        self.assertEqual(mask.count(), expected_count)
+
+    def test_subclass_invert(self):
+        """Ensures invert works for subclassed Masks."""
+        mask_size = (1, 4)
+        expected_count = mask_size[0] * mask_size[1]
+        mask = SubMask(fill=False, size=mask_size)
+
+        mask.invert()
+
+        self.assertEqual(mask.count(), expected_count)
+
+    def test_subclass_scale(self):
+        """Ensures scale works for subclassed Masks."""
+        expected_size = (5, 2)
+        mask = SubMask((1, 4))
+
+        scaled_mask = mask.scale(expected_size)
+
+        self.assertIsInstance(scaled_mask, pygame.mask.Mask)
+        self.assertNotIsInstance(scaled_mask, SubMask)
+        self.assertEqual(scaled_mask.get_size(), expected_size)
+
+    def test_subclass_draw(self):
+        """Ensures draw works for subclassed Masks."""
+        mask_size = (5, 4)
+        expected_count = mask_size[0] * mask_size[1]
+        arg_masks = (
+            pygame.mask.Mask(fill=True, size=mask_size),
+            SubMask(mask_size, True),
+        )
+
+        # Test different combinations of subclassed and non-subclassed Masks.
+        for mask in (pygame.mask.Mask(mask_size), SubMask(mask_size)):
+            for arg_mask in arg_masks:
+                mask.clear()  # Clear for each test.
+
+                mask.draw(arg_mask, (0, 0))
+
+                self.assertEqual(mask.count(), expected_count)
+
+    def test_subclass_erase(self):
+        """Ensures erase works for subclassed Masks."""
+        mask_size = (3, 4)
+        expected_count = 0
+        masks = (pygame.mask.Mask(mask_size, True), SubMask(mask_size, True))
+        arg_masks = (pygame.mask.Mask(mask_size, True), SubMask(mask_size, True))
+
+        # Test different combinations of subclassed and non-subclassed Masks.
+        for mask in masks:
+            for arg_mask in arg_masks:
+                mask.fill()  # Fill for each test.
+
+                mask.erase(arg_mask, (0, 0))
+
+                self.assertEqual(mask.count(), expected_count)
+
+    def test_subclass_count(self):
+        """Ensures count works for subclassed Masks."""
+        mask_size = (5, 2)
+        expected_count = mask_size[0] * mask_size[1] - 1
+        mask = SubMask(fill=True, size=mask_size)
+        mask.set_at((1, 1), 0)
+
+        count = mask.count()
+
+        self.assertEqual(count, expected_count)
+
+    def test_subclass_centroid(self):
+        """Ensures centroid works for subclassed Masks."""
+        expected_centroid = (0, 0)
+        mask_size = (3, 2)
+        mask = SubMask((3, 2))
+
+        centroid = mask.centroid()
+
+        self.assertEqual(centroid, expected_centroid)
+
+    def test_subclass_angle(self):
+        """Ensures angle works for subclassed Masks."""
+        expected_angle = 0.0
+        mask = SubMask(size=(5, 4))
+
+        angle = mask.angle()
+
+        self.assertAlmostEqual(angle, expected_angle)
+
+    def test_subclass_outline(self):
+        """Ensures outline works for subclassed Masks."""
+        expected_outline = []
+        mask = SubMask((3, 4))
+
+        outline = mask.outline()
+
+        self.assertListEqual(outline, expected_outline)
+
+    def test_subclass_convolve(self):
+        """Ensures convolve works for subclassed Masks."""
+        width, height = 7, 5
+        mask_size = (width, height)
+        expected_count = 0
+        expected_size = (max(0, width * 2 - 1), max(0, height * 2 - 1))
+
+        arg_masks = (pygame.mask.Mask(mask_size), SubMask(mask_size))
+        output_masks = (pygame.mask.Mask(mask_size), SubMask(mask_size))
+
+        # Test different combinations of subclassed and non-subclassed Masks.
+        for mask in (pygame.mask.Mask(mask_size), SubMask(mask_size)):
+            for arg_mask in arg_masks:
+                convolve_mask = mask.convolve(arg_mask)
+
+                self.assertIsInstance(convolve_mask, pygame.mask.Mask)
+                self.assertNotIsInstance(convolve_mask, SubMask)
+                self.assertEqual(convolve_mask.count(), expected_count)
+                self.assertEqual(convolve_mask.get_size(), expected_size)
+
+                # Test subclassed masks for the output_mask as well.
+                for output_mask in output_masks:
+                    convolve_mask = mask.convolve(arg_mask, output_mask)
+
+                    self.assertIsInstance(convolve_mask, pygame.mask.Mask)
+                    self.assertEqual(convolve_mask.count(), expected_count)
+                    self.assertEqual(convolve_mask.get_size(), mask_size)
+
+                    if isinstance(output_mask, SubMask):
+                        self.assertIsInstance(convolve_mask, SubMask)
+                    else:
+                        self.assertNotIsInstance(convolve_mask, SubMask)
+
+    def test_subclass_connected_component(self):
+        """Ensures connected_component works for subclassed Masks."""
+        expected_count = 0
+        expected_size = (3, 4)
+        mask = SubMask(expected_size)
+
+        cc_mask = mask.connected_component()
+
+        self.assertIsInstance(cc_mask, pygame.mask.Mask)
+        self.assertNotIsInstance(cc_mask, SubMask)
+        self.assertEqual(cc_mask.count(), expected_count)
+        self.assertEqual(cc_mask.get_size(), expected_size)
+
+    def test_subclass_connected_components(self):
+        """Ensures connected_components works for subclassed Masks."""
+        expected_ccs = []
+        mask = SubMask((5, 4))
+
+        ccs = mask.connected_components()
+
+        self.assertListEqual(ccs, expected_ccs)
+
+    def test_subclass_get_bounding_rects(self):
+        """Ensures get_bounding_rects works for subclassed Masks."""
+        expected_bounding_rects = []
+        mask = SubMask((3, 2))
+
+        bounding_rects = mask.get_bounding_rects()
+
+        self.assertListEqual(bounding_rects, expected_bounding_rects)
+
+    def test_subclass_to_surface(self):
+        """Ensures to_surface works for subclassed Masks."""
+        expected_color = pygame.Color("blue")
+        size = (5, 3)
+        mask = SubMask(size, fill=True)
+        surface = pygame.Surface(size, SRCALPHA, 32)
+        surface.fill(pygame.Color("red"))
+
+        to_surface = mask.to_surface(surface, setcolor=expected_color)
+
+        self.assertIs(to_surface, surface)
+        self.assertEqual(to_surface.get_size(), size)
+        assertSurfaceFilled(self, to_surface, expected_color)
+
+
+@unittest.skipIf(IS_PYPY, "pypy has lots of mask failures")  # TODO
+class MaskModuleTest(unittest.TestCase):
+    def test_from_surface(self):
+        """Ensures from_surface creates a mask with the correct bits set.
+
+        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 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.
+        """
+        threshold_count = 256
+        surface_color = [55, 155, 255, 0]
+        expected_size = (11, 9)
+        all_set_count = expected_size[0] * expected_size[1]
+        none_set_count = 0
+
+        for depth in (16, 32):
+            surface = pygame.Surface(expected_size, SRCALPHA, depth)
+
+            for alpha in range(threshold_count):
+                surface_color[3] = alpha
+                surface.fill(surface_color)
+
+                if depth < 32:
+                    # On surfaces with depths < 32 the requested alpha can be
+                    # different than what gets set. Use the value read from the
+                    # surface.
+                    alpha = surface.get_at((0, 0))[3]
+
+                # Test the mask created at threshold values low, high and
+                # around alpha.
+                threshold_test_values = {-1, 0, alpha - 1, alpha, alpha + 1, 255, 256}
+
+                for threshold in threshold_test_values:
+                    msg = f"depth={depth}, alpha={alpha}, threshold={threshold}"
+
+                    if alpha > threshold:
+                        expected_count = all_set_count
+                    else:
+                        expected_count = none_set_count
+
+                    mask = pygame.mask.from_surface(
+                        surface=surface, threshold=threshold
+                    )
+
+                    self.assertIsInstance(mask, pygame.mask.Mask, msg)
+                    self.assertEqual(mask.get_size(), expected_size, msg)
+                    self.assertEqual(mask.count(), expected_count, msg)
+
+    def test_from_surface__different_alphas_32bit(self):
+        """Ensures from_surface creates a mask with the correct bits set
+        when pixels have different alpha values (32 bits surfaces).
+
+        This test checks the masks created by the from_surface function using
+        a 32 bit surface. The surface is created with each pixel having a
+        different alpha value (0-255). This surface is tested over a range
+        of threshold values (0-255).
+        """
+        offset = (0, 0)
+        threshold_count = 256
+        surface_color = [10, 20, 30, 0]
+        expected_size = (threshold_count, 1)
+        expected_mask = pygame.Mask(expected_size, fill=True)
+        surface = pygame.Surface(expected_size, SRCALPHA, 32)
+
+        # Give each pixel a different alpha.
+        surface.lock()  # Lock for possible speed up.
+        for a in range(threshold_count):
+            surface_color[3] = a
+            surface.set_at((a, 0), surface_color)
+        surface.unlock()
+
+        # Test the mask created for each different alpha threshold.
+        for threshold in range(threshold_count):
+            msg = f"threshold={threshold}"
+            expected_mask.set_at((threshold, 0), 0)
+            expected_count = expected_mask.count()
+
+            mask = pygame.mask.from_surface(surface, threshold)
+
+            self.assertIsInstance(mask, pygame.mask.Mask, msg)
+            self.assertEqual(mask.get_size(), expected_size, msg)
+            self.assertEqual(mask.count(), expected_count, msg)
+            self.assertEqual(
+                mask.overlap_area(expected_mask, offset), expected_count, msg
+            )
+
+    def test_from_surface__different_alphas_16bit(self):
+        """Ensures from_surface creates a mask with the correct bits set
+        when pixels have different alpha values (16 bit surfaces).
+
+        This test checks the masks created by the from_surface function using
+        a 16 bit surface. Each pixel of the surface is set with a different
+        alpha value (0-255), but since this is a 16 bit surface the requested
+        alpha value can differ from what is actually set. The resulting surface
+        will have groups of alpha values which complicates the test as the
+        alpha groups will all be set/unset at a given threshold. The setup
+        calculates these groups and an expected mask for each. This test data
+        is then used to test each alpha grouping over a range of threshold
+        values.
+        """
+        threshold_count = 256
+        surface_color = [110, 120, 130, 0]
+        expected_size = (threshold_count, 1)
+        surface = pygame.Surface(expected_size, SRCALPHA, 16)
+
+        # Give each pixel a different alpha.
+        surface.lock()  # Lock for possible speed up.
+        for a in range(threshold_count):
+            surface_color[3] = a
+            surface.set_at((a, 0), surface_color)
+        surface.unlock()
+
+        alpha_thresholds = OrderedDict()
+        special_thresholds = set()
+
+        # Create the threshold ranges and identify any thresholds that need
+        # special handling.
+        for threshold in range(threshold_count):
+            # On surfaces with depths < 32 the requested alpha can be different
+            # than what gets set. Use the value read from the surface.
+            alpha = surface.get_at((threshold, 0))[3]
+
+            if alpha not in alpha_thresholds:
+                alpha_thresholds[alpha] = [threshold]
+            else:
+                alpha_thresholds[alpha].append(threshold)
+
+            if threshold < alpha:
+                special_thresholds.add(threshold)
+
+        # Use each threshold group to create an expected mask.
+        test_data = []  # [(from_threshold, to_threshold, expected_mask), ...]
+        offset = (0, 0)
+        erase_mask = pygame.Mask(expected_size)
+        exp_mask = pygame.Mask(expected_size, fill=True)
+
+        for thresholds in alpha_thresholds.values():
+            for threshold in thresholds:
+                if threshold in special_thresholds:
+                    # Any special thresholds just reuse previous exp_mask.
+                    test_data.append((threshold, threshold + 1, exp_mask))
+                else:
+                    to_threshold = thresholds[-1] + 1
+
+                    # Make the expected mask by erasing the unset bits.
+                    for thres in range(to_threshold):
+                        erase_mask.set_at((thres, 0), 1)
+
+                    exp_mask = pygame.Mask(expected_size, fill=True)
+                    exp_mask.erase(erase_mask, offset)
+                    test_data.append((threshold, to_threshold, exp_mask))
+                    break
+
+        # All the setup is done. Now test the masks created over the threshold
+        # ranges.
+        for from_threshold, to_threshold, expected_mask in test_data:
+            expected_count = expected_mask.count()
+
+            for threshold in range(from_threshold, to_threshold):
+                msg = f"threshold={threshold}"
+
+                mask = pygame.mask.from_surface(surface, threshold)
+
+                self.assertIsInstance(mask, pygame.mask.Mask, msg)
+                self.assertEqual(mask.get_size(), expected_size, msg)
+                self.assertEqual(mask.count(), expected_count, msg)
+                self.assertEqual(
+                    mask.overlap_area(expected_mask, offset), expected_count, msg
+                )
+
+    def test_from_surface__with_colorkey_mask_cleared(self):
+        """Ensures from_surface creates a mask with the correct bits set
+        when the surface uses a colorkey.
+
+        The surface is filled with the colorkey color so the resulting masks
+        are expected to have no bits set.
+        """
+        colorkeys = ((0, 0, 0), (1, 2, 3), (50, 100, 200), (255, 255, 255))
+        expected_size = (7, 11)
+        expected_count = 0
+
+        for depth in (8, 16, 24, 32):
+            msg = f"depth={depth}"
+            surface = pygame.Surface(expected_size, 0, depth)
+
+            for colorkey in colorkeys:
+                surface.set_colorkey(colorkey)
+                # With some depths (i.e. 8 and 16) the actual colorkey can be
+                # different than what was requested via the set.
+                surface.fill(surface.get_colorkey())
+
+                mask = pygame.mask.from_surface(surface)
+
+                self.assertIsInstance(mask, pygame.mask.Mask, msg)
+                self.assertEqual(mask.get_size(), expected_size, msg)
+                self.assertEqual(mask.count(), expected_count, msg)
+
+    def test_from_surface__with_colorkey_mask_filled(self):
+        """Ensures from_surface creates a mask with the correct bits set
+        when the surface uses a colorkey.
+
+        The surface is filled with a color that is not the colorkey color so
+        the resulting masks are expected to have all bits set.
+        """
+        colorkeys = ((0, 0, 0), (1, 2, 3), (10, 100, 200), (255, 255, 255))
+        surface_color = (50, 100, 200)
+        expected_size = (11, 7)
+        expected_count = expected_size[0] * expected_size[1]
+
+        for depth in (8, 16, 24, 32):
+            msg = f"depth={depth}"
+            surface = pygame.Surface(expected_size, 0, depth)
+            surface.fill(surface_color)
+
+            for colorkey in colorkeys:
+                surface.set_colorkey(colorkey)
+
+                mask = pygame.mask.from_surface(surface)
+
+                self.assertIsInstance(mask, pygame.mask.Mask, msg)
+                self.assertEqual(mask.get_size(), expected_size, msg)
+                self.assertEqual(mask.count(), expected_count, msg)
+
+    def test_from_surface__with_colorkey_mask_pattern(self):
+        """Ensures from_surface creates a mask with the correct bits set
+        when the surface uses a colorkey.
+
+        The surface is filled with alternating pixels of colorkey and
+        non-colorkey colors, so the resulting masks are expected to have
+        alternating bits set.
+        """
+
+        def alternate(func, set_value, unset_value, width, height):
+            # Helper function to set alternating values.
+            setbit = False
+            for pos in ((x, y) for x in range(width) for y in range(height)):
+                func(pos, set_value if setbit else unset_value)
+                setbit = not setbit
+
+        surface_color = (5, 10, 20)
+        colorkey = (50, 60, 70)
+        expected_size = (11, 2)
+        expected_mask = pygame.mask.Mask(expected_size)
+        alternate(expected_mask.set_at, 1, 0, *expected_size)
+        expected_count = expected_mask.count()
+        offset = (0, 0)
+
+        for depth in (8, 16, 24, 32):
+            msg = f"depth={depth}"
+            surface = pygame.Surface(expected_size, 0, depth)
+            # Fill the surface with alternating colors.
+            alternate(surface.set_at, surface_color, colorkey, *expected_size)
+            surface.set_colorkey(colorkey)
+
+            mask = pygame.mask.from_surface(surface)
+
+            self.assertIsInstance(mask, pygame.mask.Mask, msg)
+            self.assertEqual(mask.get_size(), expected_size, msg)
+            self.assertEqual(mask.count(), expected_count, msg)
+            self.assertEqual(
+                mask.overlap_area(expected_mask, offset), expected_count, msg
+            )
+
+    def test_from_threshold(self):
+        """Does mask.from_threshold() work correctly?"""
+
+        a = [16, 24, 32]
+
+        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 a:
+            surf = pygame.surface.Surface((70, 70), 0, i)
+            surf2 = pygame.surface.Surface((70, 70), 0, i)
+            surf.fill((100, 100, 100))
+            surf2.fill((150, 150, 150))
+            surf2.fill((100, 100, 100), (40, 40, 10, 10))
+            mask = pygame.mask.from_threshold(
+                surface=surf,
+                color=(0, 0, 0, 0),
+                threshold=(10, 10, 10, 255),
+                othersurface=surf2,
+            )
+
+            self.assertIsInstance(mask, pygame.mask.Mask)
+            self.assertEqual(mask.count(), 100)
+            self.assertEqual(mask.get_bounding_rects(), [pygame.Rect((40, 40, 10, 10))])
+
+    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)):
+            mask = pygame.mask.from_surface(pygame.Surface(size))
+
+            self.assertIsInstance(mask, pygame.mask.MaskType, f"size={size}")
+            self.assertEqual(mask.get_size(), size)
+
+    def test_zero_size_from_threshold(self):
+        a = [16, 24, 32]
+        sizes = ((100, 0), (0, 100), (0, 0))
+
+        for size in sizes:
+            for i in a:
+                surf = pygame.surface.Surface(size, 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)
+                )
+
+                self.assertEqual(mask.count(), 0)
+
+                rects = mask.get_bounding_rects()
+                self.assertEqual(rects, [])
+
+            for i in a:
+                surf = pygame.surface.Surface(size, 0, i)
+                surf2 = pygame.surface.Surface(size, 0, i)
+                surf.fill((100, 100, 100))
+                surf2.fill((150, 150, 150))
+                surf2.fill((100, 100, 100), (40, 40, 10, 10))
+                mask = pygame.mask.from_threshold(
+                    surf, (0, 0, 0, 0), (10, 10, 10, 255), surf2
+                )
+
+                self.assertIsInstance(mask, pygame.mask.Mask)
+                self.assertEqual(mask.count(), 0)
+
+                rects = mask.get_bounding_rects()
+                self.assertEqual(rects, [])
+
+    def test_buffer_interface(self):
+        size = (1000, 100)
+        pixels_set = ((0, 1), (100, 10), (173, 90))
+        pixels_unset = ((0, 0), (101, 10), (173, 91))
+
+        mask = pygame.Mask(size)
+        for point in pixels_set:
+            mask.set_at(point, 1)
+
+        view = memoryview(mask)
+        intwidth = 8 * view.strides[1]
+
+        for point in pixels_set:
+            x, y = point
+            col = x // intwidth
+            self.assertEqual(
+                (view[col, y] >> (x % intwidth)) & 1,
+                1,
+                f"the pixel at {point} is not set to 1",
+            )
+
+        for point in pixels_unset:
+            x, y = point
+            col = x // intwidth
+            self.assertEqual(
+                (view[col, y] >> (x % intwidth)) & 1,
+                0,
+                f"the pixel at {point} is not set to 0",
+            )
+
+
+if __name__ == "__main__":
+    unittest.main()
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/math_test.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/math_test.py
new file mode 100644
index 0000000..3cedf23
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/math_test.py
@@ -0,0 +1,2929 @@
+import math
+import platform
+import unittest
+from collections.abc import Collection, Sequence
+
+import pygame.math
+from pygame.math import Vector2, Vector3
+
+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."""
+
+        # Int tests
+        # Test going above max
+        result = pygame.math.clamp(10, 1, 5)
+        self.assertEqual(result, 5)
+        # Test going below min
+        result = pygame.math.clamp(-10, 1, 5)
+        self.assertEqual(result, 1)
+        # Test equal to max
+        result = pygame.math.clamp(5, 1, 5)
+        self.assertEqual(result, 5)
+        # Test equal to min
+        result = pygame.math.clamp(1, 1, 5)
+        self.assertEqual(result, 1)
+        # Test between min and max
+        result = pygame.math.clamp(3, 1, 5)
+        self.assertEqual(result, 3)
+
+        # Float tests
+        # Test going above max
+        result = pygame.math.clamp(10.0, 1.12, 5.0)
+        self.assertAlmostEqual(result, 5.0)
+        # Test going below min
+        result = pygame.math.clamp(-10.0, 1.12, 5.0)
+        self.assertAlmostEqual(result, 1.12)
+        # Test equal to max
+        result = pygame.math.clamp(5.0, 1.12, 5.0)
+        self.assertAlmostEqual(result, 5.0)
+        # Test equal to min
+        result = pygame.math.clamp(1.12, 1.12, 5.0)
+        self.assertAlmostEqual(result, 1.12)
+        # Test between min and max
+        result = pygame.math.clamp(2.5, 1.12, 5.0)
+        self.assertAlmostEqual(result, 2.5)
+
+        # Error tests
+        # Not enough args
+        self.assertRaises(TypeError, pygame.math.clamp, 10)
+        # Non numeric args
+        self.assertRaises(TypeError, pygame.math.clamp, "hello", "py", "thon")
+
+
+class Vector2TypeTest(unittest.TestCase):
+    def setUp(self):
+        self.zeroVec = Vector2()
+        self.e1 = Vector2(1, 0)
+        self.e2 = Vector2(0, 1)
+        self.t1 = (1.2, 3.4)
+        self.l1 = list(self.t1)
+        self.v1 = Vector2(self.t1)
+        self.t2 = (5.6, 7.8)
+        self.l2 = list(self.t2)
+        self.v2 = Vector2(self.t2)
+        self.s1 = 5.6
+        self.s2 = 7.8
+
+    def testConstructionDefault(self):
+        v = Vector2()
+        self.assertEqual(v.x, 0.0)
+        self.assertEqual(v.y, 0.0)
+
+    def testConstructionScalar(self):
+        v = Vector2(1)
+        self.assertEqual(v.x, 1.0)
+        self.assertEqual(v.y, 1.0)
+
+    def testConstructionScalarKeywords(self):
+        v = Vector2(x=1)
+        self.assertEqual(v.x, 1.0)
+        self.assertEqual(v.y, 1.0)
+
+    def testConstructionKeywords(self):
+        v = Vector2(x=1, y=2)
+        self.assertEqual(v.x, 1.0)
+        self.assertEqual(v.y, 2.0)
+
+    def testConstructionXY(self):
+        v = Vector2(1.2, 3.4)
+        self.assertEqual(v.x, 1.2)
+        self.assertEqual(v.y, 3.4)
+
+    def testConstructionTuple(self):
+        v = Vector2((1.2, 3.4))
+        self.assertEqual(v.x, 1.2)
+        self.assertEqual(v.y, 3.4)
+
+    def testConstructionList(self):
+        v = Vector2([1.2, 3.4])
+        self.assertEqual(v.x, 1.2)
+        self.assertEqual(v.y, 3.4)
+
+    def testConstructionVector2(self):
+        v = Vector2(Vector2(1.2, 3.4))
+        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)
+        self.assertEqual(tmp, self.v1[0])
+        tmp = self.v1.y
+        self.assertEqual(tmp, self.v1.y)
+        self.assertEqual(tmp, self.v1[1])
+        self.v1.x = 3.141
+        self.assertEqual(self.v1.x, 3.141)
+        self.v1.y = 3.141
+        self.assertEqual(self.v1.y, 3.141)
+
+        def assign_nonfloat():
+            v = Vector2()
+            v.x = "spam"
+
+        self.assertRaises(TypeError, assign_nonfloat)
+
+    def test___round___basic(self):
+        self.assertEqual(round(pygame.Vector2(0.0, 0.0)), pygame.Vector2(0.0, 0.0))
+        self.assertEqual(type(round(pygame.Vector2(0.0, 0.0))), pygame.Vector2)
+        self.assertEqual(
+            round(pygame.Vector2(1.0, 1.0)), round(pygame.Vector2(1.0, 1.0))
+        )
+        self.assertEqual(
+            round(pygame.Vector2(10.0, 10.0)), round(pygame.Vector2(10.0, 10.0))
+        )
+        self.assertEqual(
+            round(pygame.Vector2(1000000000.0, 1000000000.0)),
+            pygame.Vector2(1000000000.0, 1000000000.0),
+        )
+        self.assertEqual(round(pygame.Vector2(1e20, 1e20)), pygame.Vector2(1e20, 1e20))
+
+        self.assertEqual(round(pygame.Vector2(-1.0, -1.0)), pygame.Vector2(-1.0, -1.0))
+        self.assertEqual(
+            round(pygame.Vector2(-10.0, -10.0)), pygame.Vector2(-10.0, -10.0)
+        )
+        self.assertEqual(
+            round(pygame.Vector2(-1000000000.0, -1000000000.0)),
+            pygame.Vector2(-1000000000.0, -1000000000.0),
+        )
+        self.assertEqual(
+            round(pygame.Vector2(-1e20, -1e20)), pygame.Vector2(-1e20, -1e20)
+        )
+
+        self.assertEqual(round(pygame.Vector2(0.1, 0.1)), pygame.Vector2(0.0, 0.0))
+        self.assertEqual(round(pygame.Vector2(1.1, 1.1)), pygame.Vector2(1.0, 1.0))
+        self.assertEqual(round(pygame.Vector2(10.1, 10.1)), pygame.Vector2(10.0, 10.0))
+        self.assertEqual(
+            round(pygame.Vector2(1000000000.1, 1000000000.1)),
+            pygame.Vector2(1000000000.0, 1000000000.0),
+        )
+
+        self.assertEqual(round(pygame.Vector2(-1.1, -1.1)), pygame.Vector2(-1.0, -1.0))
+        self.assertEqual(
+            round(pygame.Vector2(-10.1, -10.1)), pygame.Vector2(-10.0, -10.0)
+        )
+        self.assertEqual(
+            round(pygame.Vector2(-1000000000.1, -1000000000.1)),
+            pygame.Vector2(-1000000000.0, -1000000000.0),
+        )
+
+        self.assertEqual(round(pygame.Vector2(0.9, 0.9)), pygame.Vector2(1.0, 1.0))
+        self.assertEqual(round(pygame.Vector2(9.9, 9.9)), pygame.Vector2(10.0, 10.0))
+        self.assertEqual(
+            round(pygame.Vector2(999999999.9, 999999999.9)),
+            pygame.Vector2(1000000000.0, 1000000000.0),
+        )
+
+        self.assertEqual(round(pygame.Vector2(-0.9, -0.9)), pygame.Vector2(-1.0, -1.0))
+        self.assertEqual(
+            round(pygame.Vector2(-9.9, -9.9)), pygame.Vector2(-10.0, -10.0)
+        )
+        self.assertEqual(
+            round(pygame.Vector2(-999999999.9, -999999999.9)),
+            pygame.Vector2(-1000000000.0, -1000000000.0),
+        )
+
+        self.assertEqual(
+            round(pygame.Vector2(-8.0, -8.0), -1), pygame.Vector2(-10.0, -10.0)
+        )
+        self.assertEqual(type(round(pygame.Vector2(-8.0, -8.0), -1)), pygame.Vector2)
+
+        self.assertEqual(type(round(pygame.Vector2(-8.0, -8.0), 0)), pygame.Vector2)
+        self.assertEqual(type(round(pygame.Vector2(-8.0, -8.0), 1)), pygame.Vector2)
+
+        # Check even / odd rounding behaviour
+        self.assertEqual(round(pygame.Vector2(5.5, 5.5)), pygame.Vector2(6, 6))
+        self.assertEqual(round(pygame.Vector2(5.4, 5.4)), pygame.Vector2(5.0, 5.0))
+        self.assertEqual(round(pygame.Vector2(5.6, 5.6)), pygame.Vector2(6.0, 6.0))
+        self.assertEqual(round(pygame.Vector2(-5.5, -5.5)), pygame.Vector2(-6, -6))
+        self.assertEqual(round(pygame.Vector2(-5.4, -5.4)), pygame.Vector2(-5, -5))
+        self.assertEqual(round(pygame.Vector2(-5.6, -5.6)), pygame.Vector2(-6, -6))
+
+        self.assertRaises(TypeError, round, pygame.Vector2(1.0, 1.0), 1.5)
+        self.assertRaises(TypeError, round, pygame.Vector2(1.0, 1.0), "a")
+
+    def testCopy(self):
+        v_copy0 = Vector2(2004.0, 2022.0)
+        v_copy1 = v_copy0.copy()
+        self.assertEqual(v_copy0.x, v_copy1.x)
+        self.assertEqual(v_copy0.y, v_copy1.y)
+
+    def test_move_towards_basic(self):
+        expected = Vector2(8.08, 2006.87)
+        origin = Vector2(7.22, 2004.0)
+        target = Vector2(12.30, 2021.0)
+        change_ip = Vector2(7.22, 2004.0)
+
+        change = origin.move_towards(target, 3)
+        change_ip.move_towards_ip(target, 3)
+
+        self.assertEqual(round(change.x, 2), expected.x)
+        self.assertEqual(round(change.y, 2), expected.y)
+        self.assertEqual(round(change_ip.x, 2), expected.x)
+        self.assertEqual(round(change_ip.y, 2), expected.y)
+
+    def test_move_towards_max_distance(self):
+        expected = Vector2(12.30, 2021)
+        origin = Vector2(7.22, 2004.0)
+        target = Vector2(12.30, 2021.0)
+        change_ip = Vector2(7.22, 2004.0)
+
+        change = origin.move_towards(target, 25)
+        change_ip.move_towards_ip(target, 25)
+
+        self.assertEqual(round(change.x, 2), expected.x)
+        self.assertEqual(round(change.y, 2), expected.y)
+        self.assertEqual(round(change_ip.x, 2), expected.x)
+        self.assertEqual(round(change_ip.y, 2), expected.y)
+
+    def test_move_nowhere(self):
+        expected = Vector2(7.22, 2004.0)
+        origin = Vector2(7.22, 2004.0)
+        target = Vector2(12.30, 2021.0)
+        change_ip = Vector2(7.22, 2004.0)
+
+        change = origin.move_towards(target, 0)
+        change_ip.move_towards_ip(target, 0)
+
+        self.assertEqual(round(change.x, 2), expected.x)
+        self.assertEqual(round(change.y, 2), expected.y)
+        self.assertEqual(round(change_ip.x, 2), expected.x)
+        self.assertEqual(round(change_ip.y, 2), expected.y)
+
+    def test_move_away(self):
+        expected = Vector2(6.36, 2001.13)
+        origin = Vector2(7.22, 2004.0)
+        target = Vector2(12.30, 2021.0)
+        change_ip = Vector2(7.22, 2004.0)
+
+        change = origin.move_towards(target, -3)
+        change_ip.move_towards_ip(target, -3)
+
+        self.assertEqual(round(change.x, 2), expected.x)
+        self.assertEqual(round(change.y, 2), expected.y)
+        self.assertEqual(round(change_ip.x, 2), expected.x)
+        self.assertEqual(round(change_ip.y, 2), expected.y)
+
+    def test_move_towards_self(self):
+        vec = Vector2(6.36, 2001.13)
+        vec2 = vec.copy()
+        for dist in (-3.54, -1, 0, 0.234, 12):
+            self.assertEqual(vec.move_towards(vec2, dist), vec)
+            vec2.move_towards_ip(vec, dist)
+            self.assertEqual(vec, vec2)
+
+    def test_move_towards_errors(self):
+        def overpopulate():
+            origin = Vector2(7.22, 2004.0)
+            target = Vector2(12.30, 2021.0)
+            origin.move_towards(target, 3, 2)
+
+        def overpopulate_ip():
+            origin = Vector2(7.22, 2004.0)
+            target = Vector2(12.30, 2021.0)
+            origin.move_towards_ip(target, 3, 2)
+
+        def invalid_types1():
+            origin = Vector2(7.22, 2004.0)
+            target = Vector2(12.30, 2021.0)
+            origin.move_towards(target, "novial")
+
+        def invalid_types_ip1():
+            origin = Vector2(7.22, 2004.0)
+            target = Vector2(12.30, 2021.0)
+            origin.move_towards_ip(target, "is")
+
+        def invalid_types2():
+            origin = Vector2(7.22, 2004.0)
+            target = Vector2(12.30, 2021.0)
+            origin.move_towards("kinda", 3)
+
+        def invalid_types_ip2():
+            origin = Vector2(7.22, 2004.0)
+            target = Vector2(12.30, 2021.0)
+            origin.move_towards_ip("cool", 3)
+
+        self.assertRaises(TypeError, overpopulate)
+        self.assertRaises(TypeError, overpopulate_ip)
+        self.assertRaises(TypeError, invalid_types1)
+        self.assertRaises(TypeError, invalid_types_ip1)
+        self.assertRaises(TypeError, invalid_types2)
+        self.assertRaises(TypeError, invalid_types_ip2)
+
+    def testSequence(self):
+        v = Vector2(1.2, 3.4)
+        Vector2()[:]
+        self.assertEqual(len(v), 2)
+        self.assertEqual(v[0], 1.2)
+        self.assertEqual(v[1], 3.4)
+        self.assertRaises(IndexError, lambda: v[2])
+        self.assertEqual(v[-1], 3.4)
+        self.assertEqual(v[-2], 1.2)
+        self.assertRaises(IndexError, lambda: v[-3])
+        self.assertEqual(v[:], [1.2, 3.4])
+        self.assertEqual(v[1:], [3.4])
+        self.assertEqual(v[:1], [1.2])
+        self.assertEqual(list(v), [1.2, 3.4])
+        self.assertEqual(tuple(v), (1.2, 3.4))
+        v[0] = 5.6
+        v[1] = 7.8
+        self.assertEqual(v.x, 5.6)
+        self.assertEqual(v.y, 7.8)
+        v[:] = [9.1, 11.12]
+        self.assertEqual(v.x, 9.1)
+        self.assertEqual(v.y, 11.12)
+
+        def overpopulate():
+            v = Vector2()
+            v[:] = [1, 2, 3]
+
+        self.assertRaises(ValueError, overpopulate)
+
+        def underpopulate():
+            v = Vector2()
+            v[:] = [1]
+
+        self.assertRaises(ValueError, underpopulate)
+
+        def assign_nonfloat():
+            v = Vector2()
+            v[0] = "spam"
+
+        self.assertRaises(TypeError, assign_nonfloat)
+
+    def testExtendedSlicing(self):
+        #  deletion
+        def delSlice(vec, start=None, stop=None, step=None):
+            if start is not None and stop is not None and step is not None:
+                del vec[start:stop:step]
+            elif start is not None and stop is None and step is not None:
+                del vec[start::step]
+            elif start is None and stop is None and step is not None:
+                del vec[::step]
+
+        v = Vector2(self.v1)
+        self.assertRaises(TypeError, delSlice, v, None, None, 2)
+        self.assertRaises(TypeError, delSlice, v, 1, None, 2)
+        self.assertRaises(TypeError, delSlice, v, 1, 2, 1)
+
+        #  assignment
+        v = Vector2(self.v1)
+        v[::2] = [-1]
+        self.assertEqual(v, [-1, self.v1.y])
+        v = Vector2(self.v1)
+        v[::-2] = [10]
+        self.assertEqual(v, [self.v1.x, 10])
+        v = Vector2(self.v1)
+        v[::-1] = v
+        self.assertEqual(v, [self.v1.y, self.v1.x])
+        a = Vector2(self.v1)
+        b = Vector2(self.v1)
+        c = Vector2(self.v1)
+        a[1:2] = [2.2]
+        b[slice(1, 2)] = [2.2]
+        c[1:2:] = (2.2,)
+        self.assertEqual(a, b)
+        self.assertEqual(a, c)
+        self.assertEqual(type(a), type(self.v1))
+        self.assertEqual(type(b), type(self.v1))
+        self.assertEqual(type(c), type(self.v1))
+
+    def test_contains(self):
+        c = Vector2(0, 1)
+
+        # call __contains__ explicitly to test that it is defined
+        self.assertTrue(c.__contains__(0))
+        self.assertTrue(0 in c)
+        self.assertTrue(1 in c)
+        self.assertTrue(2 not in c)
+        self.assertFalse(c.__contains__(2))
+
+        self.assertRaises(TypeError, lambda: "string" in c)
+        self.assertRaises(TypeError, lambda: 3 + 4j in c)
+
+    def testAdd(self):
+        v3 = self.v1 + self.v2
+        self.assertTrue(isinstance(v3, type(self.v1)))
+        self.assertEqual(v3.x, self.v1.x + self.v2.x)
+        self.assertEqual(v3.y, self.v1.y + self.v2.y)
+        v3 = self.v1 + self.t2
+        self.assertTrue(isinstance(v3, type(self.v1)))
+        self.assertEqual(v3.x, self.v1.x + self.t2[0])
+        self.assertEqual(v3.y, self.v1.y + self.t2[1])
+        v3 = self.v1 + self.l2
+        self.assertTrue(isinstance(v3, type(self.v1)))
+        self.assertEqual(v3.x, self.v1.x + self.l2[0])
+        self.assertEqual(v3.y, self.v1.y + self.l2[1])
+        v3 = self.t1 + self.v2
+        self.assertTrue(isinstance(v3, type(self.v1)))
+        self.assertEqual(v3.x, self.t1[0] + self.v2.x)
+        self.assertEqual(v3.y, self.t1[1] + self.v2.y)
+        v3 = self.l1 + self.v2
+        self.assertTrue(isinstance(v3, type(self.v1)))
+        self.assertEqual(v3.x, self.l1[0] + self.v2.x)
+        self.assertEqual(v3.y, self.l1[1] + self.v2.y)
+
+    def testSub(self):
+        v3 = self.v1 - self.v2
+        self.assertTrue(isinstance(v3, type(self.v1)))
+        self.assertEqual(v3.x, self.v1.x - self.v2.x)
+        self.assertEqual(v3.y, self.v1.y - self.v2.y)
+        v3 = self.v1 - self.t2
+        self.assertTrue(isinstance(v3, type(self.v1)))
+        self.assertEqual(v3.x, self.v1.x - self.t2[0])
+        self.assertEqual(v3.y, self.v1.y - self.t2[1])
+        v3 = self.v1 - self.l2
+        self.assertTrue(isinstance(v3, type(self.v1)))
+        self.assertEqual(v3.x, self.v1.x - self.l2[0])
+        self.assertEqual(v3.y, self.v1.y - self.l2[1])
+        v3 = self.t1 - self.v2
+        self.assertTrue(isinstance(v3, type(self.v1)))
+        self.assertEqual(v3.x, self.t1[0] - self.v2.x)
+        self.assertEqual(v3.y, self.t1[1] - self.v2.y)
+        v3 = self.l1 - self.v2
+        self.assertTrue(isinstance(v3, type(self.v1)))
+        self.assertEqual(v3.x, self.l1[0] - self.v2.x)
+        self.assertEqual(v3.y, self.l1[1] - self.v2.y)
+
+    def testScalarMultiplication(self):
+        v = self.s1 * self.v1
+        self.assertTrue(isinstance(v, type(self.v1)))
+        self.assertEqual(v.x, self.s1 * self.v1.x)
+        self.assertEqual(v.y, self.s1 * self.v1.y)
+        v = self.v1 * self.s2
+        self.assertEqual(v.x, self.v1.x * self.s2)
+        self.assertEqual(v.y, self.v1.y * self.s2)
+
+    def testScalarDivision(self):
+        v = self.v1 / self.s1
+        self.assertTrue(isinstance(v, type(self.v1)))
+        self.assertAlmostEqual(v.x, self.v1.x / self.s1)
+        self.assertAlmostEqual(v.y, self.v1.y / self.s1)
+        v = self.v1 // self.s2
+        self.assertTrue(isinstance(v, type(self.v1)))
+        self.assertEqual(v.x, self.v1.x // self.s2)
+        self.assertEqual(v.y, self.v1.y // self.s2)
+
+    def testBool(self):
+        self.assertEqual(bool(self.zeroVec), False)
+        self.assertEqual(bool(self.v1), True)
+        self.assertTrue(not self.zeroVec)
+        self.assertTrue(self.v1)
+
+    def testUnary(self):
+        v = +self.v1
+        self.assertTrue(isinstance(v, type(self.v1)))
+        self.assertEqual(v.x, self.v1.x)
+        self.assertEqual(v.y, self.v1.y)
+        self.assertNotEqual(id(v), id(self.v1))
+        v = -self.v1
+        self.assertTrue(isinstance(v, type(self.v1)))
+        self.assertEqual(v.x, -self.v1.x)
+        self.assertEqual(v.y, -self.v1.y)
+        self.assertNotEqual(id(v), id(self.v1))
+
+    def testCompare(self):
+        int_vec = Vector2(3, -2)
+        flt_vec = Vector2(3.0, -2.0)
+        zero_vec = Vector2(0, 0)
+        self.assertEqual(int_vec == flt_vec, True)
+        self.assertEqual(int_vec != flt_vec, False)
+        self.assertEqual(int_vec != zero_vec, True)
+        self.assertEqual(flt_vec == zero_vec, False)
+        self.assertEqual(int_vec == (3, -2), True)
+        self.assertEqual(int_vec != (3, -2), False)
+        self.assertEqual(int_vec != [0, 0], True)
+        self.assertEqual(int_vec == [0, 0], False)
+        self.assertEqual(int_vec != 5, True)
+        self.assertEqual(int_vec == 5, False)
+        self.assertEqual(int_vec != [3, -2, 0], True)
+        self.assertEqual(int_vec == [3, -2, 0], False)
+
+    def testStr(self):
+        v = Vector2(1.2, 3.4)
+        self.assertEqual(str(v), "[1.2, 3.4]")
+
+    def testRepr(self):
+        v = Vector2(1.2, 3.4)
+        self.assertEqual(v.__repr__(), "")
+        self.assertEqual(v, Vector2(v.__repr__()))
+
+    def testIter(self):
+        it = self.v1.__iter__()
+        next_ = it.__next__
+        self.assertEqual(next_(), self.v1[0])
+        self.assertEqual(next_(), self.v1[1])
+        self.assertRaises(StopIteration, lambda: next_())
+        it1 = self.v1.__iter__()
+        it2 = self.v1.__iter__()
+        self.assertNotEqual(id(it1), id(it2))
+        self.assertEqual(id(it1), id(it1.__iter__()))
+        self.assertEqual(list(it1), list(it2))
+        self.assertEqual(list(self.v1.__iter__()), self.l1)
+        idx = 0
+        for val in self.v1:
+            self.assertEqual(val, self.v1[idx])
+            idx += 1
+
+    def test_rotate(self):
+        v1 = Vector2(1, 0)
+        v2 = v1.rotate(90)
+        v3 = v1.rotate(90 + 360)
+        self.assertEqual(v1.x, 1)
+        self.assertEqual(v1.y, 0)
+        self.assertEqual(v2.x, 0)
+        self.assertEqual(v2.y, 1)
+        self.assertEqual(v3.x, v2.x)
+        self.assertEqual(v3.y, v2.y)
+        v1 = Vector2(-1, -1)
+        v2 = v1.rotate(-90)
+        self.assertEqual(v2.x, -1)
+        self.assertEqual(v2.y, 1)
+        v2 = v1.rotate(360)
+        self.assertEqual(v1.x, v2.x)
+        self.assertEqual(v1.y, v2.y)
+        v2 = v1.rotate(0)
+        self.assertEqual(v1.x, v2.x)
+        self.assertEqual(v1.y, v2.y)
+        # issue 214
+        self.assertEqual(Vector2(0, 1).rotate(359.99999999), Vector2(0, 1))
+
+    def test_rotate_rad(self):
+        tests = (
+            ((1, 0), math.pi),
+            ((1, 0), math.pi / 2),
+            ((1, 0), -math.pi / 2),
+            ((1, 0), math.pi / 4),
+        )
+        for initialVec, radians in tests:
+            self.assertEqual(
+                Vector2(initialVec).rotate_rad(radians),
+                (math.cos(radians), math.sin(radians)),
+            )
+
+    def test_rotate_ip(self):
+        v = Vector2(1, 0)
+        self.assertEqual(v.rotate_ip(90), None)
+        self.assertEqual(v.x, 0)
+        self.assertEqual(v.y, 1)
+        v = Vector2(-1, -1)
+        v.rotate_ip(-90)
+        self.assertEqual(v.x, -1)
+        self.assertEqual(v.y, 1)
+
+    def test_rotate_rad_ip(self):
+        tests = (
+            ((1, 0), math.pi),
+            ((1, 0), math.pi / 2),
+            ((1, 0), -math.pi / 2),
+            ((1, 0), math.pi / 4),
+        )
+        for initialVec, radians in tests:
+            vec = Vector2(initialVec)
+            vec.rotate_rad_ip(radians)
+            self.assertEqual(vec, (math.cos(radians), math.sin(radians)))
+
+    def test_normalize(self):
+        v = self.v1.normalize()
+        # length is 1
+        self.assertAlmostEqual(v.x * v.x + v.y * v.y, 1.0)
+        # v1 is unchanged
+        self.assertEqual(self.v1.x, self.l1[0])
+        self.assertEqual(self.v1.y, self.l1[1])
+        # v2 is parallel to v1
+        self.assertAlmostEqual(self.v1.x * v.y - self.v1.y * v.x, 0.0)
+        self.assertRaises(ValueError, lambda: self.zeroVec.normalize())
+
+    def test_normalize_ip(self):
+        v = +self.v1
+        # v has length != 1 before normalizing
+        self.assertNotEqual(v.x * v.x + v.y * v.y, 1.0)
+        # inplace operations should return None
+        self.assertEqual(v.normalize_ip(), None)
+        # length is 1
+        self.assertAlmostEqual(v.x * v.x + v.y * v.y, 1.0)
+        # v2 is parallel to v1
+        self.assertAlmostEqual(self.v1.x * v.y - self.v1.y * v.x, 0.0)
+        self.assertRaises(ValueError, lambda: self.zeroVec.normalize_ip())
+
+    def test_is_normalized(self):
+        self.assertEqual(self.v1.is_normalized(), False)
+        v = self.v1.normalize()
+        self.assertEqual(v.is_normalized(), True)
+        self.assertEqual(self.e2.is_normalized(), True)
+        self.assertEqual(self.zeroVec.is_normalized(), False)
+
+    def test_cross(self):
+        self.assertEqual(
+            self.v1.cross(self.v2), self.v1.x * self.v2.y - self.v1.y * self.v2.x
+        )
+        self.assertEqual(
+            self.v1.cross(self.l2), self.v1.x * self.l2[1] - self.v1.y * self.l2[0]
+        )
+        self.assertEqual(
+            self.v1.cross(self.t2), self.v1.x * self.t2[1] - self.v1.y * self.t2[0]
+        )
+        self.assertEqual(self.v1.cross(self.v2), -self.v2.cross(self.v1))
+        self.assertEqual(self.v1.cross(self.v1), 0)
+
+    def test_dot(self):
+        self.assertAlmostEqual(
+            self.v1.dot(self.v2), self.v1.x * self.v2.x + self.v1.y * self.v2.y
+        )
+        self.assertAlmostEqual(
+            self.v1.dot(self.l2), self.v1.x * self.l2[0] + self.v1.y * self.l2[1]
+        )
+        self.assertAlmostEqual(
+            self.v1.dot(self.t2), self.v1.x * self.t2[0] + self.v1.y * self.t2[1]
+        )
+        self.assertEqual(self.v1.dot(self.v2), self.v2.dot(self.v1))
+        self.assertEqual(self.v1.dot(self.v2), self.v1 * self.v2)
+
+    def test_angle_to(self):
+        self.assertEqual(
+            self.v1.rotate(self.v1.angle_to(self.v2)).normalize(), self.v2.normalize()
+        )
+        self.assertEqual(Vector2(1, 1).angle_to((-1, 1)), 90)
+        self.assertEqual(Vector2(1, 0).angle_to((0, -1)), -90)
+        self.assertEqual(Vector2(1, 0).angle_to((-1, 1)), 135)
+        self.assertEqual(abs(Vector2(1, 0).angle_to((-1, 0))), 180)
+
+    def test_scale_to_length(self):
+        v = Vector2(1, 1)
+        v.scale_to_length(2.5)
+        self.assertEqual(v, Vector2(2.5, 2.5) / math.sqrt(2))
+        self.assertRaises(ValueError, lambda: self.zeroVec.scale_to_length(1))
+        self.assertEqual(v.scale_to_length(0), None)
+        self.assertEqual(v, self.zeroVec)
+
+    def test_length(self):
+        self.assertEqual(Vector2(3, 4).length(), 5)
+        self.assertEqual(Vector2(-3, 4).length(), 5)
+        self.assertEqual(self.zeroVec.length(), 0)
+
+    def test_length_squared(self):
+        self.assertEqual(Vector2(3, 4).length_squared(), 25)
+        self.assertEqual(Vector2(-3, 4).length_squared(), 25)
+        self.assertEqual(self.zeroVec.length_squared(), 0)
+
+    def test_reflect(self):
+        v = Vector2(1, -1)
+        n = Vector2(0, 1)
+        self.assertEqual(v.reflect(n), Vector2(1, 1))
+        self.assertEqual(v.reflect(3 * n), v.reflect(n))
+        self.assertEqual(v.reflect(-v), -v)
+        self.assertRaises(ValueError, lambda: v.reflect(self.zeroVec))
+
+    def test_reflect_ip(self):
+        v1 = Vector2(1, -1)
+        v2 = Vector2(v1)
+        n = Vector2(0, 1)
+        self.assertEqual(v2.reflect_ip(n), None)
+        self.assertEqual(v2, Vector2(1, 1))
+        v2 = Vector2(v1)
+        v2.reflect_ip(3 * n)
+        self.assertEqual(v2, v1.reflect(n))
+        v2 = Vector2(v1)
+        v2.reflect_ip(-v1)
+        self.assertEqual(v2, -v1)
+        self.assertRaises(ValueError, lambda: v2.reflect_ip(Vector2()))
+
+    def test_distance_to(self):
+        diff = self.v1 - self.v2
+        self.assertEqual(self.e1.distance_to(self.e2), math.sqrt(2))
+        self.assertEqual(self.e1.distance_to((0, 1)), math.sqrt(2))
+        self.assertEqual(self.e1.distance_to([0, 1]), math.sqrt(2))
+        self.assertAlmostEqual(
+            self.v1.distance_to(self.v2), math.sqrt(diff.x * diff.x + diff.y * diff.y)
+        )
+        self.assertAlmostEqual(
+            self.v1.distance_to(self.t2), math.sqrt(diff.x * diff.x + diff.y * diff.y)
+        )
+        self.assertAlmostEqual(
+            self.v1.distance_to(self.l2), math.sqrt(diff.x * diff.x + diff.y * diff.y)
+        )
+        self.assertEqual(self.v1.distance_to(self.v1), 0)
+        self.assertEqual(self.v1.distance_to(self.t1), 0)
+        self.assertEqual(self.v1.distance_to(self.l1), 0)
+        self.assertEqual(self.v1.distance_to(self.t2), self.v2.distance_to(self.t1))
+        self.assertEqual(self.v1.distance_to(self.l2), self.v2.distance_to(self.l1))
+        self.assertEqual(self.v1.distance_to(self.v2), self.v2.distance_to(self.v1))
+
+    def test_distance_squared_to(self):
+        diff = self.v1 - self.v2
+        self.assertEqual(self.e1.distance_squared_to(self.e2), 2)
+        self.assertEqual(self.e1.distance_squared_to((0, 1)), 2)
+        self.assertEqual(self.e1.distance_squared_to([0, 1]), 2)
+        self.assertAlmostEqual(
+            self.v1.distance_squared_to(self.v2), diff.x * diff.x + diff.y * diff.y
+        )
+        self.assertAlmostEqual(
+            self.v1.distance_squared_to(self.t2), diff.x * diff.x + diff.y * diff.y
+        )
+        self.assertAlmostEqual(
+            self.v1.distance_squared_to(self.l2), diff.x * diff.x + diff.y * diff.y
+        )
+        self.assertEqual(self.v1.distance_squared_to(self.v1), 0)
+        self.assertEqual(self.v1.distance_squared_to(self.t1), 0)
+        self.assertEqual(self.v1.distance_squared_to(self.l1), 0)
+        self.assertEqual(
+            self.v1.distance_squared_to(self.v2), self.v2.distance_squared_to(self.v1)
+        )
+        self.assertEqual(
+            self.v1.distance_squared_to(self.t2), self.v2.distance_squared_to(self.t1)
+        )
+        self.assertEqual(
+            self.v1.distance_squared_to(self.l2), self.v2.distance_squared_to(self.l1)
+        )
+
+    def test_update(self):
+        v = Vector2(3, 4)
+        v.update(0)
+        self.assertEqual(v, Vector2((0, 0)))
+        v.update(5, 1)
+        self.assertEqual(v, Vector2(5, 1))
+        v.update((4, 1))
+        self.assertNotEqual(v, Vector2((5, 1)))
+
+    def test_swizzle(self):
+        self.assertEqual(self.v1.yx, (self.v1.y, self.v1.x))
+        self.assertEqual(
+            self.v1.xxyyxy,
+            (self.v1.x, self.v1.x, self.v1.y, self.v1.y, self.v1.x, self.v1.y),
+        )
+        self.v1.xy = self.t2
+        self.assertEqual(self.v1, self.t2)
+        self.v1.yx = self.t2
+        self.assertEqual(self.v1, (self.t2[1], self.t2[0]))
+        self.assertEqual(type(self.v1), Vector2)
+
+        def invalidSwizzleX():
+            Vector2().xx = (1, 2)
+
+        def invalidSwizzleY():
+            Vector2().yy = (1, 2)
+
+        self.assertRaises(AttributeError, invalidSwizzleX)
+        self.assertRaises(AttributeError, invalidSwizzleY)
+
+        def invalidAssignment():
+            Vector2().xy = 3
+
+        self.assertRaises(TypeError, invalidAssignment)
+
+        def unicodeAttribute():
+            getattr(Vector2(), "ä")
+
+        self.assertRaises(AttributeError, unicodeAttribute)
+
+    def test_swizzle_return_types(self):
+        self.assertEqual(type(self.v1.x), float)
+        self.assertEqual(type(self.v1.xy), Vector2)
+        self.assertEqual(type(self.v1.xyx), Vector3)
+        # but we don't have vector4 or above... so tuple.
+        self.assertEqual(type(self.v1.xyxy), tuple)
+        self.assertEqual(type(self.v1.xyxyx), tuple)
+
+    def test_elementwise(self):
+        v1 = self.v1
+        v2 = self.v2
+        s1 = self.s1
+        s2 = self.s2
+        # behaviour for "elementwise op scalar"
+        self.assertEqual(v1.elementwise() + s1, (v1.x + s1, v1.y + s1))
+        self.assertEqual(v1.elementwise() - s1, (v1.x - s1, v1.y - s1))
+        self.assertEqual(v1.elementwise() * s2, (v1.x * s2, v1.y * s2))
+        self.assertEqual(v1.elementwise() / s2, (v1.x / s2, v1.y / s2))
+        self.assertEqual(v1.elementwise() // s1, (v1.x // s1, v1.y // s1))
+        self.assertEqual(v1.elementwise() ** s1, (v1.x**s1, v1.y**s1))
+        self.assertEqual(v1.elementwise() % s1, (v1.x % s1, v1.y % s1))
+        self.assertEqual(v1.elementwise() > s1, v1.x > s1 and v1.y > s1)
+        self.assertEqual(v1.elementwise() < s1, v1.x < s1 and v1.y < s1)
+        self.assertEqual(v1.elementwise() == s1, v1.x == s1 and v1.y == s1)
+        self.assertEqual(v1.elementwise() != s1, s1 not in [v1.x, v1.y])
+        self.assertEqual(v1.elementwise() >= s1, v1.x >= s1 and v1.y >= s1)
+        self.assertEqual(v1.elementwise() <= s1, v1.x <= s1 and v1.y <= s1)
+        self.assertEqual(v1.elementwise() != s1, s1 not in [v1.x, v1.y])
+        # behaviour for "scalar op elementwise"
+        self.assertEqual(s1 + v1.elementwise(), (s1 + v1.x, s1 + v1.y))
+        self.assertEqual(s1 - v1.elementwise(), (s1 - v1.x, s1 - v1.y))
+        self.assertEqual(s1 * v1.elementwise(), (s1 * v1.x, s1 * v1.y))
+        self.assertEqual(s1 / v1.elementwise(), (s1 / v1.x, s1 / v1.y))
+        self.assertEqual(s1 // v1.elementwise(), (s1 // v1.x, s1 // v1.y))
+        self.assertEqual(s1 ** v1.elementwise(), (s1**v1.x, s1**v1.y))
+        self.assertEqual(s1 % v1.elementwise(), (s1 % v1.x, s1 % v1.y))
+        self.assertEqual(s1 < v1.elementwise(), s1 < v1.x and s1 < v1.y)
+        self.assertEqual(s1 > v1.elementwise(), s1 > v1.x and s1 > v1.y)
+        self.assertEqual(s1 == v1.elementwise(), s1 == v1.x and s1 == v1.y)
+        self.assertEqual(s1 != v1.elementwise(), s1 not in [v1.x, v1.y])
+        self.assertEqual(s1 <= v1.elementwise(), s1 <= v1.x and s1 <= v1.y)
+        self.assertEqual(s1 >= v1.elementwise(), s1 >= v1.x and s1 >= v1.y)
+        self.assertEqual(s1 != v1.elementwise(), s1 not in [v1.x, v1.y])
+
+        # behaviour for "elementwise op vector"
+        self.assertEqual(type(v1.elementwise() * v2), type(v1))
+        self.assertEqual(v1.elementwise() + v2, v1 + v2)
+        self.assertEqual(v1.elementwise() - v2, v1 - v2)
+        self.assertEqual(v1.elementwise() * v2, (v1.x * v2.x, v1.y * v2.y))
+        self.assertEqual(v1.elementwise() / v2, (v1.x / v2.x, v1.y / v2.y))
+        self.assertEqual(v1.elementwise() // v2, (v1.x // v2.x, v1.y // v2.y))
+        self.assertEqual(v1.elementwise() ** v2, (v1.x**v2.x, v1.y**v2.y))
+        self.assertEqual(v1.elementwise() % v2, (v1.x % v2.x, v1.y % v2.y))
+        self.assertEqual(v1.elementwise() > v2, v1.x > v2.x and v1.y > v2.y)
+        self.assertEqual(v1.elementwise() < v2, v1.x < v2.x and v1.y < v2.y)
+        self.assertEqual(v1.elementwise() >= v2, v1.x >= v2.x and v1.y >= v2.y)
+        self.assertEqual(v1.elementwise() <= v2, v1.x <= v2.x and v1.y <= v2.y)
+        self.assertEqual(v1.elementwise() == v2, v1.x == v2.x and v1.y == v2.y)
+        self.assertEqual(v1.elementwise() != v2, v1.x != v2.x and v1.y != v2.y)
+        # behaviour for "vector op elementwise"
+        self.assertEqual(v2 + v1.elementwise(), v2 + v1)
+        self.assertEqual(v2 - v1.elementwise(), v2 - v1)
+        self.assertEqual(v2 * v1.elementwise(), (v2.x * v1.x, v2.y * v1.y))
+        self.assertEqual(v2 / v1.elementwise(), (v2.x / v1.x, v2.y / v1.y))
+        self.assertEqual(v2 // v1.elementwise(), (v2.x // v1.x, v2.y // v1.y))
+        self.assertEqual(v2 ** v1.elementwise(), (v2.x**v1.x, v2.y**v1.y))
+        self.assertEqual(v2 % v1.elementwise(), (v2.x % v1.x, v2.y % v1.y))
+        self.assertEqual(v2 < v1.elementwise(), v2.x < v1.x and v2.y < v1.y)
+        self.assertEqual(v2 > v1.elementwise(), v2.x > v1.x and v2.y > v1.y)
+        self.assertEqual(v2 <= v1.elementwise(), v2.x <= v1.x and v2.y <= v1.y)
+        self.assertEqual(v2 >= v1.elementwise(), v2.x >= v1.x and v2.y >= v1.y)
+        self.assertEqual(v2 == v1.elementwise(), v2.x == v1.x and v2.y == v1.y)
+        self.assertEqual(v2 != v1.elementwise(), v2.x != v1.x and v2.y != v1.y)
+
+        # behaviour for "elementwise op elementwise"
+        self.assertEqual(v2.elementwise() + v1.elementwise(), v2 + v1)
+        self.assertEqual(v2.elementwise() - v1.elementwise(), v2 - v1)
+        self.assertEqual(
+            v2.elementwise() * v1.elementwise(), (v2.x * v1.x, v2.y * v1.y)
+        )
+        self.assertEqual(
+            v2.elementwise() / v1.elementwise(), (v2.x / v1.x, v2.y / v1.y)
+        )
+        self.assertEqual(
+            v2.elementwise() // v1.elementwise(), (v2.x // v1.x, v2.y // v1.y)
+        )
+        self.assertEqual(v2.elementwise() ** v1.elementwise(), (v2.x**v1.x, v2.y**v1.y))
+        self.assertEqual(
+            v2.elementwise() % v1.elementwise(), (v2.x % v1.x, v2.y % v1.y)
+        )
+        self.assertEqual(
+            v2.elementwise() < v1.elementwise(), v2.x < v1.x and v2.y < v1.y
+        )
+        self.assertEqual(
+            v2.elementwise() > v1.elementwise(), v2.x > v1.x and v2.y > v1.y
+        )
+        self.assertEqual(
+            v2.elementwise() <= v1.elementwise(), v2.x <= v1.x and v2.y <= v1.y
+        )
+        self.assertEqual(
+            v2.elementwise() >= v1.elementwise(), v2.x >= v1.x and v2.y >= v1.y
+        )
+        self.assertEqual(
+            v2.elementwise() == v1.elementwise(), v2.x == v1.x and v2.y == v1.y
+        )
+        self.assertEqual(
+            v2.elementwise() != v1.elementwise(), v2.x != v1.x and v2.y != v1.y
+        )
+
+        # other behaviour
+        self.assertEqual(abs(v1.elementwise()), (abs(v1.x), abs(v1.y)))
+        self.assertEqual(-v1.elementwise(), -v1)
+        self.assertEqual(+v1.elementwise(), +v1)
+        self.assertEqual(bool(v1.elementwise()), bool(v1))
+        self.assertEqual(bool(Vector2().elementwise()), bool(Vector2()))
+        self.assertEqual(self.zeroVec.elementwise() ** 0, (1, 1))
+        self.assertRaises(ValueError, lambda: pow(Vector2(-1, 0).elementwise(), 1.2))
+        self.assertRaises(ZeroDivisionError, lambda: self.zeroVec.elementwise() ** -1)
+        self.assertRaises(ZeroDivisionError, lambda: self.zeroVec.elementwise() ** -1)
+        self.assertRaises(ZeroDivisionError, lambda: Vector2(1, 1).elementwise() / 0)
+        self.assertRaises(ZeroDivisionError, lambda: Vector2(1, 1).elementwise() // 0)
+        self.assertRaises(ZeroDivisionError, lambda: Vector2(1, 1).elementwise() % 0)
+        self.assertRaises(
+            ZeroDivisionError, lambda: Vector2(1, 1).elementwise() / self.zeroVec
+        )
+        self.assertRaises(
+            ZeroDivisionError, lambda: Vector2(1, 1).elementwise() // self.zeroVec
+        )
+        self.assertRaises(
+            ZeroDivisionError, lambda: Vector2(1, 1).elementwise() % self.zeroVec
+        )
+        self.assertRaises(ZeroDivisionError, lambda: 2 / self.zeroVec.elementwise())
+        self.assertRaises(ZeroDivisionError, lambda: 2 // self.zeroVec.elementwise())
+        self.assertRaises(ZeroDivisionError, lambda: 2 % self.zeroVec.elementwise())
+
+    def test_slerp(self):
+        self.assertRaises(ValueError, lambda: self.zeroVec.slerp(self.v1, 0.5))
+        self.assertRaises(ValueError, lambda: self.v1.slerp(self.zeroVec, 0.5))
+        self.assertRaises(ValueError, lambda: self.zeroVec.slerp(self.zeroVec, 0.5))
+        v1 = Vector2(1, 0)
+        v2 = Vector2(0, 1)
+        steps = 10
+        angle_step = v1.angle_to(v2) / steps
+        for i, u in ((i, v1.slerp(v2, i / float(steps))) for i in range(steps + 1)):
+            self.assertAlmostEqual(u.length(), 1)
+            self.assertAlmostEqual(v1.angle_to(u), i * angle_step)
+        self.assertEqual(u, v2)
+
+        v1 = Vector2(100, 0)
+        v2 = Vector2(0, 10)
+        radial_factor = v2.length() / v1.length()
+        for i, u in ((i, v1.slerp(v2, -i / float(steps))) for i in range(steps + 1)):
+            self.assertAlmostEqual(
+                u.length(),
+                (v2.length() - v1.length()) * (float(i) / steps) + v1.length(),
+            )
+        self.assertEqual(u, v2)
+        self.assertEqual(v1.slerp(v1, 0.5), v1)
+        self.assertEqual(v2.slerp(v2, 0.5), v2)
+        self.assertRaises(ValueError, lambda: v1.slerp(-v1, 0.5))
+
+    def test_lerp(self):
+        v1 = Vector2(0, 0)
+        v2 = Vector2(10, 10)
+        self.assertEqual(v1.lerp(v2, 0.5), (5, 5))
+        self.assertRaises(ValueError, lambda: v1.lerp(v2, 2.5))
+
+        v1 = Vector2(-10, -5)
+        v2 = Vector2(10, 10)
+        self.assertEqual(v1.lerp(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))
+        self.assertRaises(TypeError, lambda: v.from_polar((None, None)))
+        self.assertRaises(TypeError, lambda: v.from_polar("ab"))
+        self.assertRaises(TypeError, lambda: v.from_polar((None, 1)))
+        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_a = Vector(2, 0)
+        vec_b = Vector(0, 1)
+
+        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."""
+        # arrange
+        v = Vector2(2, 2)
+        x_axis = Vector2(10, 0)
+
+        # act
+        actual = v.project(x_axis)
+
+        # assert
+        self.assertEqual(v.x, actual.x)
+        self.assertEqual(0, actual.y)
+
+    def test_project_v2_onto_y_axis(self):
+        """Project onto y-axis, e.g. get the component pointing in the y-axis direction."""
+        # arrange
+        v = Vector2(2, 2)
+        y_axis = Vector2(0, 100)
+
+        # act
+        actual = v.project(y_axis)
+
+        # assert
+        self.assertEqual(0, actual.x)
+        self.assertEqual(v.y, actual.y)
+
+    def test_project_v2_onto_other(self):
+        """Project onto other vector."""
+        # arrange
+        v = Vector2(2, 3)
+        other = Vector2(3, 5)
+
+        # act
+        actual = v.project(other)
+
+        # assert
+        expected = v.dot(other) / other.dot(other) * other
+        self.assertEqual(expected.x, actual.x)
+        self.assertEqual(expected.y, actual.y)
+
+    def test_project_v2_onto_other_as_tuple(self):
+        """Project onto other tuple as vector."""
+        # arrange
+        v = Vector2(2, 3)
+        other = Vector2(3, 5)
+
+        # act
+        actual = v.project(tuple(other))
+
+        # assert
+        expected = v.dot(other) / other.dot(other) * other
+        self.assertEqual(expected.x, actual.x)
+        self.assertEqual(expected.y, actual.y)
+
+    def test_project_v2_onto_other_as_list(self):
+        """Project onto other list as vector."""
+        # arrange
+        v = Vector2(2, 3)
+        other = Vector2(3, 5)
+
+        # act
+        actual = v.project(list(other))
+
+        # assert
+        expected = v.dot(other) / other.dot(other) * other
+        self.assertEqual(expected.x, actual.x)
+        self.assertEqual(expected.y, actual.y)
+
+    def test_project_v2_raises_if_other_has_zero_length(self):
+        """Check if exception is raise when projected on vector has zero length."""
+        # arrange
+        v = Vector2(2, 3)
+        other = Vector2(0, 0)
+
+        # act / assert
+        self.assertRaises(ValueError, v.project, other)
+
+    def test_project_v2_raises_if_other_is_not_iterable(self):
+        """Check if exception is raise when projected on vector is not iterable."""
+        # arrange
+        v = Vector2(2, 3)
+        other = 10
+
+        # act / assert
+        self.assertRaises(TypeError, v.project, other)
+
+    def test_collection_abc(self):
+        v = Vector2(3, 4)
+        self.assertTrue(isinstance(v, Collection))
+        self.assertFalse(isinstance(v, Sequence))
+
+    def test_clamp_mag_v2_max(self):
+        v1 = Vector2(7, 2)
+        v2 = v1.clamp_magnitude(5)
+        v3 = v1.clamp_magnitude(0, 5)
+        self.assertEqual(v2, v3)
+
+        v1.clamp_magnitude_ip(5)
+        self.assertEqual(v1, v2)
+
+        v1.clamp_magnitude_ip(0, 5)
+        self.assertEqual(v1, v2)
+
+        expected_v2 = Vector2(4.807619738204116, 1.3736056394868903)
+        self.assertEqual(expected_v2, v2)
+
+    def test_clamp_mag_v2_min(self):
+        v1 = Vector2(1, 2)
+        v2 = v1.clamp_magnitude(3, 5)
+        v1.clamp_magnitude_ip(3, 5)
+        expected_v2 = Vector2(1.3416407864998738, 2.6832815729997477)
+        self.assertEqual(expected_v2, v2)
+        self.assertEqual(expected_v2, v1)
+
+    def test_clamp_mag_v2_no_change(self):
+        v1 = Vector2(1, 2)
+        for args in (
+            (1, 6),
+            (1.12, 3.55),
+            (0.93, 2.83),
+            (7.6,),
+        ):
+            with self.subTest(args=args):
+                v2 = v1.clamp_magnitude(*args)
+                v1.clamp_magnitude_ip(*args)
+                self.assertEqual(v1, v2)
+                self.assertEqual(v1, Vector2(1, 2))
+
+    def test_clamp_mag_v2_edge_cases(self):
+        v1 = Vector2(1, 2)
+        v2 = v1.clamp_magnitude(6, 6)
+        v1.clamp_magnitude_ip(6, 6)
+        self.assertEqual(v1, v2)
+        self.assertAlmostEqual(v1.length(), 6)
+
+        v2 = v1.clamp_magnitude(0)
+        v1.clamp_magnitude_ip(0, 0)
+        self.assertEqual(v1, v2)
+        self.assertEqual(v1, Vector2())
+
+    def test_clamp_mag_v2_errors(self):
+        v1 = Vector2(1, 2)
+        for invalid_args in (
+            ("foo", "bar"),
+            (1, 2, 3),
+            (342.234, "test"),
+        ):
+            with self.subTest(invalid_args=invalid_args):
+                self.assertRaises(TypeError, v1.clamp_magnitude, *invalid_args)
+                self.assertRaises(TypeError, v1.clamp_magnitude_ip, *invalid_args)
+
+        for invalid_args in (
+            (-1,),
+            (4, 3),  # min > max
+            (-4, 10),
+            (-4, -2),
+        ):
+            with self.subTest(invalid_args=invalid_args):
+                self.assertRaises(ValueError, v1.clamp_magnitude, *invalid_args)
+                self.assertRaises(ValueError, v1.clamp_magnitude_ip, *invalid_args)
+
+        # 0 vector
+        v2 = Vector2()
+        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"""
+        v = Vector2(4, 2)
+
+        class TestVector(Vector2):
+            def supermariobrosiscool(self):
+                return 722
+
+        other = TestVector(4, 1)
+
+        self.assertEqual(other.supermariobrosiscool(), 722)
+        self.assertNotEqual(type(v), TestVector)
+        self.assertNotEqual(type(v), type(other.copy()))
+        self.assertEqual(TestVector, type(other.reflect(v)))
+        self.assertEqual(TestVector, type(other.lerp(v, 1)))
+        self.assertEqual(TestVector, type(other.slerp(v, 1)))
+        self.assertEqual(TestVector, type(other.rotate(5)))
+        self.assertEqual(TestVector, type(other.rotate_rad(5)))
+        self.assertEqual(TestVector, type(other.project(v)))
+        self.assertEqual(TestVector, type(other.move_towards(v, 5)))
+        self.assertEqual(TestVector, type(other.clamp_magnitude(5)))
+        self.assertEqual(TestVector, type(other.clamp_magnitude(1, 5)))
+        self.assertEqual(TestVector, type(other.elementwise() + other))
+
+        other1 = TestVector(4, 2)
+
+        self.assertEqual(type(other + other1), TestVector)
+        self.assertEqual(type(other - other1), TestVector)
+        self.assertEqual(type(other * 3), TestVector)
+        self.assertEqual(type(other / 3), TestVector)
+        self.assertEqual(type(other.elementwise() ** 3), TestVector)
+
+
+class Vector3TypeTest(unittest.TestCase):
+    def setUp(self):
+        self.zeroVec = Vector3()
+        self.e1 = Vector3(1, 0, 0)
+        self.e2 = Vector3(0, 1, 0)
+        self.e3 = Vector3(0, 0, 1)
+        self.t1 = (1.2, 3.4, 9.6)
+        self.l1 = list(self.t1)
+        self.v1 = Vector3(self.t1)
+        self.t2 = (5.6, 7.8, 2.1)
+        self.l2 = list(self.t2)
+        self.v2 = Vector3(self.t2)
+        self.s1 = 5.6
+        self.s2 = 7.8
+
+    def testConstructionDefault(self):
+        v = Vector3()
+        self.assertEqual(v.x, 0.0)
+        self.assertEqual(v.y, 0.0)
+        self.assertEqual(v.z, 0.0)
+
+    def testConstructionXYZ(self):
+        v = Vector3(1.2, 3.4, 9.6)
+        self.assertEqual(v.x, 1.2)
+        self.assertEqual(v.y, 3.4)
+        self.assertEqual(v.z, 9.6)
+
+    def testConstructionTuple(self):
+        v = Vector3((1.2, 3.4, 9.6))
+        self.assertEqual(v.x, 1.2)
+        self.assertEqual(v.y, 3.4)
+        self.assertEqual(v.z, 9.6)
+
+    def testConstructionList(self):
+        v = Vector3([1.2, 3.4, -9.6])
+        self.assertEqual(v.x, 1.2)
+        self.assertEqual(v.y, 3.4)
+        self.assertEqual(v.z, -9.6)
+
+    def testConstructionVector3(self):
+        v = Vector3(Vector3(1.2, 3.4, -9.6))
+        self.assertEqual(v.x, 1.2)
+        self.assertEqual(v.y, 3.4)
+        self.assertEqual(v.z, -9.6)
+
+    def testConstructionScalar(self):
+        v = Vector3(1)
+        self.assertEqual(v.x, 1.0)
+        self.assertEqual(v.y, 1.0)
+        self.assertEqual(v.z, 1.0)
+
+    def testConstructionScalarKeywords(self):
+        v = Vector3(x=1)
+        self.assertEqual(v.x, 1.0)
+        self.assertEqual(v.y, 1.0)
+        self.assertEqual(v.z, 1.0)
+
+    def testConstructionKeywords(self):
+        v = Vector3(x=1, y=2, z=3)
+        self.assertEqual(v.x, 1.0)
+        self.assertEqual(v.y, 2.0)
+        self.assertEqual(v.z, 3.0)
+
+    def testConstructionMissing(self):
+        self.assertRaises(ValueError, Vector3, 1, 2)
+        self.assertRaises(ValueError, Vector3, x=1, y=2)
+
+    def testAttributeAccess(self):
+        tmp = self.v1.x
+        self.assertEqual(tmp, self.v1.x)
+        self.assertEqual(tmp, self.v1[0])
+        tmp = self.v1.y
+        self.assertEqual(tmp, self.v1.y)
+        self.assertEqual(tmp, self.v1[1])
+        tmp = self.v1.z
+        self.assertEqual(tmp, self.v1.z)
+        self.assertEqual(tmp, self.v1[2])
+        self.v1.x = 3.141
+        self.assertEqual(self.v1.x, 3.141)
+        self.v1.y = 3.141
+        self.assertEqual(self.v1.y, 3.141)
+        self.v1.z = 3.141
+        self.assertEqual(self.v1.z, 3.141)
+
+        def assign_nonfloat():
+            v = Vector2()
+            v.x = "spam"
+
+        self.assertRaises(TypeError, assign_nonfloat)
+
+    def testCopy(self):
+        v_copy0 = Vector3(2014.0, 2032.0, 2076.0)
+        v_copy1 = v_copy0.copy()
+        self.assertEqual(v_copy0.x, v_copy1.x)
+        self.assertEqual(v_copy0.y, v_copy1.y)
+        self.assertEqual(v_copy0.z, v_copy1.z)
+
+    def testSequence(self):
+        v = Vector3(1.2, 3.4, -9.6)
+        self.assertEqual(len(v), 3)
+        self.assertEqual(v[0], 1.2)
+        self.assertEqual(v[1], 3.4)
+        self.assertEqual(v[2], -9.6)
+        self.assertRaises(IndexError, lambda: v[3])
+        self.assertEqual(v[-1], -9.6)
+        self.assertEqual(v[-2], 3.4)
+        self.assertEqual(v[-3], 1.2)
+        self.assertRaises(IndexError, lambda: v[-4])
+        self.assertEqual(v[:], [1.2, 3.4, -9.6])
+        self.assertEqual(v[1:], [3.4, -9.6])
+        self.assertEqual(v[:1], [1.2])
+        self.assertEqual(v[:-1], [1.2, 3.4])
+        self.assertEqual(v[1:2], [3.4])
+        self.assertEqual(list(v), [1.2, 3.4, -9.6])
+        self.assertEqual(tuple(v), (1.2, 3.4, -9.6))
+        v[0] = 5.6
+        v[1] = 7.8
+        v[2] = -2.1
+        self.assertEqual(v.x, 5.6)
+        self.assertEqual(v.y, 7.8)
+        self.assertEqual(v.z, -2.1)
+        v[:] = [9.1, 11.12, -13.41]
+        self.assertEqual(v.x, 9.1)
+        self.assertEqual(v.y, 11.12)
+        self.assertEqual(v.z, -13.41)
+
+        def overpopulate():
+            v = Vector3()
+            v[:] = [1, 2, 3, 4]
+
+        self.assertRaises(ValueError, overpopulate)
+
+        def underpopulate():
+            v = Vector3()
+            v[:] = [1]
+
+        self.assertRaises(ValueError, underpopulate)
+
+        def assign_nonfloat():
+            v = Vector2()
+            v[0] = "spam"
+
+        self.assertRaises(TypeError, assign_nonfloat)
+
+    def testExtendedSlicing(self):
+        #  deletion
+        def delSlice(vec, start=None, stop=None, step=None):
+            if start is not None and stop is not None and step is not None:
+                del vec[start:stop:step]
+            elif start is not None and stop is None and step is not None:
+                del vec[start::step]
+            elif start is None and stop is None and step is not None:
+                del vec[::step]
+
+        v = Vector3(self.v1)
+        self.assertRaises(TypeError, delSlice, v, None, None, 2)
+        self.assertRaises(TypeError, delSlice, v, 1, None, 2)
+        self.assertRaises(TypeError, delSlice, v, 1, 2, 1)
+
+        #  assignment
+        v = Vector3(self.v1)
+        v[::2] = [-1.1, -2.2]
+        self.assertEqual(v, [-1.1, self.v1.y, -2.2])
+        v = Vector3(self.v1)
+        v[::-2] = [10, 20]
+        self.assertEqual(v, [20, self.v1.y, 10])
+        v = Vector3(self.v1)
+        v[::-1] = v
+        self.assertEqual(v, [self.v1.z, self.v1.y, self.v1.x])
+        a = Vector3(self.v1)
+        b = Vector3(self.v1)
+        c = Vector3(self.v1)
+        a[1:2] = [2.2]
+        b[slice(1, 2)] = [2.2]
+        c[1:2:] = (2.2,)
+        self.assertEqual(a, b)
+        self.assertEqual(a, c)
+        self.assertEqual(type(a), type(self.v1))
+        self.assertEqual(type(b), type(self.v1))
+        self.assertEqual(type(c), type(self.v1))
+
+    def test_contains(self):
+        c = Vector3(0, 1, 2)
+
+        # call __contains__ explicitly to test that it is defined
+        self.assertTrue(c.__contains__(0))
+        self.assertTrue(0 in c)
+        self.assertTrue(1 in c)
+        self.assertTrue(2 in c)
+        self.assertTrue(3 not in c)
+        self.assertFalse(c.__contains__(10))
+
+        self.assertRaises(TypeError, lambda: "string" in c)
+        self.assertRaises(TypeError, lambda: 3 + 4j in c)
+
+    def testAdd(self):
+        v3 = self.v1 + self.v2
+        self.assertTrue(isinstance(v3, type(self.v1)))
+        self.assertEqual(v3.x, self.v1.x + self.v2.x)
+        self.assertEqual(v3.y, self.v1.y + self.v2.y)
+        self.assertEqual(v3.z, self.v1.z + self.v2.z)
+        v3 = self.v1 + self.t2
+        self.assertTrue(isinstance(v3, type(self.v1)))
+        self.assertEqual(v3.x, self.v1.x + self.t2[0])
+        self.assertEqual(v3.y, self.v1.y + self.t2[1])
+        self.assertEqual(v3.z, self.v1.z + self.t2[2])
+        v3 = self.v1 + self.l2
+        self.assertTrue(isinstance(v3, type(self.v1)))
+        self.assertEqual(v3.x, self.v1.x + self.l2[0])
+        self.assertEqual(v3.y, self.v1.y + self.l2[1])
+        self.assertEqual(v3.z, self.v1.z + self.l2[2])
+        v3 = self.t1 + self.v2
+        self.assertTrue(isinstance(v3, type(self.v1)))
+        self.assertEqual(v3.x, self.t1[0] + self.v2.x)
+        self.assertEqual(v3.y, self.t1[1] + self.v2.y)
+        self.assertEqual(v3.z, self.t1[2] + self.v2.z)
+        v3 = self.l1 + self.v2
+        self.assertTrue(isinstance(v3, type(self.v1)))
+        self.assertEqual(v3.x, self.l1[0] + self.v2.x)
+        self.assertEqual(v3.y, self.l1[1] + self.v2.y)
+        self.assertEqual(v3.z, self.l1[2] + self.v2.z)
+
+    def testSub(self):
+        v3 = self.v1 - self.v2
+        self.assertTrue(isinstance(v3, type(self.v1)))
+        self.assertEqual(v3.x, self.v1.x - self.v2.x)
+        self.assertEqual(v3.y, self.v1.y - self.v2.y)
+        self.assertEqual(v3.z, self.v1.z - self.v2.z)
+        v3 = self.v1 - self.t2
+        self.assertTrue(isinstance(v3, type(self.v1)))
+        self.assertEqual(v3.x, self.v1.x - self.t2[0])
+        self.assertEqual(v3.y, self.v1.y - self.t2[1])
+        self.assertEqual(v3.z, self.v1.z - self.t2[2])
+        v3 = self.v1 - self.l2
+        self.assertTrue(isinstance(v3, type(self.v1)))
+        self.assertEqual(v3.x, self.v1.x - self.l2[0])
+        self.assertEqual(v3.y, self.v1.y - self.l2[1])
+        self.assertEqual(v3.z, self.v1.z - self.l2[2])
+        v3 = self.t1 - self.v2
+        self.assertTrue(isinstance(v3, type(self.v1)))
+        self.assertEqual(v3.x, self.t1[0] - self.v2.x)
+        self.assertEqual(v3.y, self.t1[1] - self.v2.y)
+        self.assertEqual(v3.z, self.t1[2] - self.v2.z)
+        v3 = self.l1 - self.v2
+        self.assertTrue(isinstance(v3, type(self.v1)))
+        self.assertEqual(v3.x, self.l1[0] - self.v2.x)
+        self.assertEqual(v3.y, self.l1[1] - self.v2.y)
+        self.assertEqual(v3.z, self.l1[2] - self.v2.z)
+
+    def testScalarMultiplication(self):
+        v = self.s1 * self.v1
+        self.assertTrue(isinstance(v, type(self.v1)))
+        self.assertEqual(v.x, self.s1 * self.v1.x)
+        self.assertEqual(v.y, self.s1 * self.v1.y)
+        self.assertEqual(v.z, self.s1 * self.v1.z)
+        v = self.v1 * self.s2
+        self.assertEqual(v.x, self.v1.x * self.s2)
+        self.assertEqual(v.y, self.v1.y * self.s2)
+        self.assertEqual(v.z, self.v1.z * self.s2)
+
+    def testScalarDivision(self):
+        v = self.v1 / self.s1
+        self.assertTrue(isinstance(v, type(self.v1)))
+        self.assertAlmostEqual(v.x, self.v1.x / self.s1)
+        self.assertAlmostEqual(v.y, self.v1.y / self.s1)
+        self.assertAlmostEqual(v.z, self.v1.z / self.s1)
+        v = self.v1 // self.s2
+        self.assertTrue(isinstance(v, type(self.v1)))
+        self.assertEqual(v.x, self.v1.x // self.s2)
+        self.assertEqual(v.y, self.v1.y // self.s2)
+        self.assertEqual(v.z, self.v1.z // self.s2)
+
+    def testBool(self):
+        self.assertEqual(bool(self.zeroVec), False)
+        self.assertEqual(bool(self.v1), True)
+        self.assertTrue(not self.zeroVec)
+        self.assertTrue(self.v1)
+
+    def testUnary(self):
+        v = +self.v1
+        self.assertTrue(isinstance(v, type(self.v1)))
+        self.assertEqual(v.x, self.v1.x)
+        self.assertEqual(v.y, self.v1.y)
+        self.assertEqual(v.z, self.v1.z)
+        self.assertNotEqual(id(v), id(self.v1))
+        v = -self.v1
+        self.assertTrue(isinstance(v, type(self.v1)))
+        self.assertEqual(v.x, -self.v1.x)
+        self.assertEqual(v.y, -self.v1.y)
+        self.assertEqual(v.z, -self.v1.z)
+        self.assertNotEqual(id(v), id(self.v1))
+
+    def testCompare(self):
+        int_vec = Vector3(3, -2, 13)
+        flt_vec = Vector3(3.0, -2.0, 13.0)
+        zero_vec = Vector3(0, 0, 0)
+        self.assertEqual(int_vec == flt_vec, True)
+        self.assertEqual(int_vec != flt_vec, False)
+        self.assertEqual(int_vec != zero_vec, True)
+        self.assertEqual(flt_vec == zero_vec, False)
+        self.assertEqual(int_vec == (3, -2, 13), True)
+        self.assertEqual(int_vec != (3, -2, 13), False)
+        self.assertEqual(int_vec != [0, 0], True)
+        self.assertEqual(int_vec == [0, 0], False)
+        self.assertEqual(int_vec != 5, True)
+        self.assertEqual(int_vec == 5, False)
+        self.assertEqual(int_vec != [3, -2, 0, 1], True)
+        self.assertEqual(int_vec == [3, -2, 0, 1], False)
+
+    def testStr(self):
+        v = Vector3(1.2, 3.4, 5.6)
+        self.assertEqual(str(v), "[1.2, 3.4, 5.6]")
+
+    def testRepr(self):
+        v = Vector3(1.2, 3.4, -9.6)
+        self.assertEqual(v.__repr__(), "")
+        self.assertEqual(v, Vector3(v.__repr__()))
+
+    def testIter(self):
+        it = self.v1.__iter__()
+        next_ = it.__next__
+        self.assertEqual(next_(), self.v1[0])
+        self.assertEqual(next_(), self.v1[1])
+        self.assertEqual(next_(), self.v1[2])
+        self.assertRaises(StopIteration, lambda: next_())
+        it1 = self.v1.__iter__()
+        it2 = self.v1.__iter__()
+        self.assertNotEqual(id(it1), id(it2))
+        self.assertEqual(id(it1), id(it1.__iter__()))
+        self.assertEqual(list(it1), list(it2))
+        self.assertEqual(list(self.v1.__iter__()), self.l1)
+        idx = 0
+        for val in self.v1:
+            self.assertEqual(val, self.v1[idx])
+            idx += 1
+
+    def test___round___basic(self):
+        self.assertEqual(
+            round(pygame.Vector3(0.0, 0.0, 0.0)), pygame.Vector3(0.0, 0.0, 0.0)
+        )
+        self.assertEqual(type(round(pygame.Vector3(0.0, 0.0, 0.0))), pygame.Vector3)
+        self.assertEqual(
+            round(pygame.Vector3(1.0, 1.0, 1.0)), round(pygame.Vector3(1.0, 1.0, 1.0))
+        )
+        self.assertEqual(
+            round(pygame.Vector3(10.0, 10.0, 10.0)),
+            round(pygame.Vector3(10.0, 10.0, 10.0)),
+        )
+        self.assertEqual(
+            round(pygame.Vector3(1000000000.0, 1000000000.0, 1000000000.0)),
+            pygame.Vector3(1000000000.0, 1000000000.0, 1000000000.0),
+        )
+        self.assertEqual(
+            round(pygame.Vector3(1e20, 1e20, 1e20)), pygame.Vector3(1e20, 1e20, 1e20)
+        )
+
+        self.assertEqual(
+            round(pygame.Vector3(-1.0, -1.0, -1.0)), pygame.Vector3(-1.0, -1.0, -1.0)
+        )
+        self.assertEqual(
+            round(pygame.Vector3(-10.0, -10.0, -10.0)),
+            pygame.Vector3(-10.0, -10.0, -10.0),
+        )
+        self.assertEqual(
+            round(pygame.Vector3(-1000000000.0, -1000000000.0, -1000000000.0)),
+            pygame.Vector3(-1000000000.0, -1000000000.0, -1000000000.0),
+        )
+        self.assertEqual(
+            round(pygame.Vector3(-1e20, -1e20, -1e20)),
+            pygame.Vector3(-1e20, -1e20, -1e20),
+        )
+
+        self.assertEqual(
+            round(pygame.Vector3(0.1, 0.1, 0.1)), pygame.Vector3(0.0, 0.0, 0.0)
+        )
+        self.assertEqual(
+            round(pygame.Vector3(1.1, 1.1, 1.1)), pygame.Vector3(1.0, 1.0, 1.0)
+        )
+        self.assertEqual(
+            round(pygame.Vector3(10.1, 10.1, 10.1)), pygame.Vector3(10.0, 10.0, 10.0)
+        )
+        self.assertEqual(
+            round(pygame.Vector3(1000000000.1, 1000000000.1, 1000000000.1)),
+            pygame.Vector3(1000000000.0, 1000000000.0, 1000000000.0),
+        )
+
+        self.assertEqual(
+            round(pygame.Vector3(-1.1, -1.1, -1.1)), pygame.Vector3(-1.0, -1.0, -1.0)
+        )
+        self.assertEqual(
+            round(pygame.Vector3(-10.1, -10.1, -10.1)),
+            pygame.Vector3(-10.0, -10.0, -10.0),
+        )
+        self.assertEqual(
+            round(pygame.Vector3(-1000000000.1, -1000000000.1, -1000000000.1)),
+            pygame.Vector3(-1000000000.0, -1000000000.0, -1000000000.0),
+        )
+
+        self.assertEqual(
+            round(pygame.Vector3(0.9, 0.9, 0.9)), pygame.Vector3(1.0, 1.0, 1.0)
+        )
+        self.assertEqual(
+            round(pygame.Vector3(9.9, 9.9, 9.9)), pygame.Vector3(10.0, 10.0, 10.0)
+        )
+        self.assertEqual(
+            round(pygame.Vector3(999999999.9, 999999999.9, 999999999.9)),
+            pygame.Vector3(1000000000.0, 1000000000.0, 1000000000.0),
+        )
+
+        self.assertEqual(
+            round(pygame.Vector3(-0.9, -0.9, -0.9)), pygame.Vector3(-1.0, -1.0, -1.0)
+        )
+        self.assertEqual(
+            round(pygame.Vector3(-9.9, -9.9, -9.9)), pygame.Vector3(-10.0, -10.0, -10.0)
+        )
+        self.assertEqual(
+            round(pygame.Vector3(-999999999.9, -999999999.9, -999999999.9)),
+            pygame.Vector3(-1000000000.0, -1000000000.0, -1000000000.0),
+        )
+
+        self.assertEqual(
+            round(pygame.Vector3(-8.0, -8.0, -8.0), -1),
+            pygame.Vector3(-10.0, -10.0, -10.0),
+        )
+        self.assertEqual(
+            type(round(pygame.Vector3(-8.0, -8.0, -8.0), -1)), pygame.Vector3
+        )
+
+        self.assertEqual(
+            type(round(pygame.Vector3(-8.0, -8.0, -8.0), 0)), pygame.Vector3
+        )
+        self.assertEqual(
+            type(round(pygame.Vector3(-8.0, -8.0, -8.0), 1)), pygame.Vector3
+        )
+
+        # Check even / odd rounding behaviour
+        self.assertEqual(round(pygame.Vector3(5.5, 5.5, 5.5)), pygame.Vector3(6, 6, 6))
+        self.assertEqual(
+            round(pygame.Vector3(5.4, 5.4, 5.4)), pygame.Vector3(5.0, 5.0, 5.0)
+        )
+        self.assertEqual(
+            round(pygame.Vector3(5.6, 5.6, 5.6)), pygame.Vector3(6.0, 6.0, 6.0)
+        )
+        self.assertEqual(
+            round(pygame.Vector3(-5.5, -5.5, -5.5)), pygame.Vector3(-6, -6, -6)
+        )
+        self.assertEqual(
+            round(pygame.Vector3(-5.4, -5.4, -5.4)), pygame.Vector3(-5, -5, -5)
+        )
+        self.assertEqual(
+            round(pygame.Vector3(-5.6, -5.6, -5.6)), pygame.Vector3(-6, -6, -6)
+        )
+
+        self.assertRaises(TypeError, round, pygame.Vector3(1.0, 1.0, 1.0), 1.5)
+        self.assertRaises(TypeError, round, pygame.Vector3(1.0, 1.0, 1.0), "a")
+
+    def test_rotate(self):
+        v1 = Vector3(1, 0, 0)
+        axis = Vector3(0, 1, 0)
+        v2 = v1.rotate(90, axis)
+        v3 = v1.rotate(90 + 360, axis)
+        self.assertEqual(v1.x, 1)
+        self.assertEqual(v1.y, 0)
+        self.assertEqual(v1.z, 0)
+        self.assertEqual(v2.x, 0)
+        self.assertEqual(v2.y, 0)
+        self.assertEqual(v2.z, -1)
+        self.assertEqual(v3.x, v2.x)
+        self.assertEqual(v3.y, v2.y)
+        self.assertEqual(v3.z, v2.z)
+        v1 = Vector3(-1, -1, -1)
+        v2 = v1.rotate(-90, axis)
+        self.assertEqual(v2.x, 1)
+        self.assertEqual(v2.y, -1)
+        self.assertEqual(v2.z, -1)
+        v2 = v1.rotate(360, axis)
+        self.assertEqual(v1.x, v2.x)
+        self.assertEqual(v1.y, v2.y)
+        self.assertEqual(v1.z, v2.z)
+        v2 = v1.rotate(0, axis)
+        self.assertEqual(v1.x, v2.x)
+        self.assertEqual(v1.y, v2.y)
+        self.assertEqual(v1.z, v2.z)
+        # issue 214
+        self.assertEqual(
+            Vector3(0, 1, 0).rotate(359.9999999, Vector3(0, 0, 1)), Vector3(0, 1, 0)
+        )
+
+    def test_rotate_rad(self):
+        axis = Vector3(0, 0, 1)
+        tests = (
+            ((1, 0, 0), math.pi),
+            ((1, 0, 0), math.pi / 2),
+            ((1, 0, 0), -math.pi / 2),
+            ((1, 0, 0), math.pi / 4),
+        )
+        for initialVec, radians in tests:
+            vec = Vector3(initialVec).rotate_rad(radians, axis)
+            self.assertEqual(vec, (math.cos(radians), math.sin(radians), 0))
+
+    def test_rotate_ip(self):
+        v = Vector3(1, 0, 0)
+        axis = Vector3(0, 1, 0)
+        self.assertEqual(v.rotate_ip(90, axis), None)
+        self.assertEqual(v.x, 0)
+        self.assertEqual(v.y, 0)
+        self.assertEqual(v.z, -1)
+        v = Vector3(-1, -1, 1)
+        v.rotate_ip(-90, axis)
+        self.assertEqual(v.x, -1)
+        self.assertEqual(v.y, -1)
+        self.assertEqual(v.z, -1)
+
+    def test_rotate_rad_ip(self):
+        axis = Vector3(0, 0, 1)
+        tests = (
+            ((1, 0, 0), math.pi),
+            ((1, 0, 0), math.pi / 2),
+            ((1, 0, 0), -math.pi / 2),
+            ((1, 0, 0), math.pi / 4),
+        )
+        for initialVec, radians in tests:
+            vec = Vector3(initialVec)
+            vec.rotate_rad_ip(radians, axis)
+            self.assertEqual(vec, (math.cos(radians), math.sin(radians), 0))
+
+    def test_rotate_x(self):
+        v1 = Vector3(1, 0, 0)
+        v2 = v1.rotate_x(90)
+        v3 = v1.rotate_x(90 + 360)
+        self.assertEqual(v1.x, 1)
+        self.assertEqual(v1.y, 0)
+        self.assertEqual(v1.z, 0)
+        self.assertEqual(v2.x, 1)
+        self.assertEqual(v2.y, 0)
+        self.assertEqual(v2.z, 0)
+        self.assertEqual(v3.x, v2.x)
+        self.assertEqual(v3.y, v2.y)
+        self.assertEqual(v3.z, v2.z)
+        v1 = Vector3(-1, -1, -1)
+        v2 = v1.rotate_x(-90)
+        self.assertEqual(v2.x, -1)
+        self.assertAlmostEqual(v2.y, -1)
+        self.assertAlmostEqual(v2.z, 1)
+        v2 = v1.rotate_x(360)
+        self.assertAlmostEqual(v1.x, v2.x)
+        self.assertAlmostEqual(v1.y, v2.y)
+        self.assertAlmostEqual(v1.z, v2.z)
+        v2 = v1.rotate_x(0)
+        self.assertEqual(v1.x, v2.x)
+        self.assertAlmostEqual(v1.y, v2.y)
+        self.assertAlmostEqual(v1.z, v2.z)
+
+    def test_rotate_x_rad(self):
+        vec = Vector3(0, 1, 0)
+        result = vec.rotate_x_rad(math.pi / 2)
+        self.assertEqual(result, (0, 0, 1))
+
+    def test_rotate_x_ip(self):
+        v = Vector3(1, 0, 0)
+        self.assertEqual(v.rotate_x_ip(90), None)
+        self.assertEqual(v.x, 1)
+        self.assertEqual(v.y, 0)
+        self.assertEqual(v.z, 0)
+        v = Vector3(-1, -1, 1)
+        v.rotate_x_ip(-90)
+        self.assertEqual(v.x, -1)
+        self.assertAlmostEqual(v.y, 1)
+        self.assertAlmostEqual(v.z, 1)
+
+    def test_rotate_x_rad_ip(self):
+        vec = Vector3(0, 1, 0)
+        vec.rotate_x_rad_ip(math.pi / 2)
+        self.assertEqual(vec, (0, 0, 1))
+
+    def test_rotate_y(self):
+        v1 = Vector3(1, 0, 0)
+        v2 = v1.rotate_y(90)
+        v3 = v1.rotate_y(90 + 360)
+        self.assertEqual(v1.x, 1)
+        self.assertEqual(v1.y, 0)
+        self.assertEqual(v1.z, 0)
+        self.assertAlmostEqual(v2.x, 0)
+        self.assertEqual(v2.y, 0)
+        self.assertAlmostEqual(v2.z, -1)
+        self.assertAlmostEqual(v3.x, v2.x)
+        self.assertEqual(v3.y, v2.y)
+        self.assertAlmostEqual(v3.z, v2.z)
+        v1 = Vector3(-1, -1, -1)
+        v2 = v1.rotate_y(-90)
+        self.assertAlmostEqual(v2.x, 1)
+        self.assertEqual(v2.y, -1)
+        self.assertAlmostEqual(v2.z, -1)
+        v2 = v1.rotate_y(360)
+        self.assertAlmostEqual(v1.x, v2.x)
+        self.assertEqual(v1.y, v2.y)
+        self.assertAlmostEqual(v1.z, v2.z)
+        v2 = v1.rotate_y(0)
+        self.assertEqual(v1.x, v2.x)
+        self.assertEqual(v1.y, v2.y)
+        self.assertEqual(v1.z, v2.z)
+
+    def test_rotate_y_rad(self):
+        vec = Vector3(1, 0, 0)
+        result = vec.rotate_y_rad(math.pi / 2)
+        self.assertEqual(result, (0, 0, -1))
+
+    def test_rotate_y_ip(self):
+        v = Vector3(1, 0, 0)
+        self.assertEqual(v.rotate_y_ip(90), None)
+        self.assertAlmostEqual(v.x, 0)
+        self.assertEqual(v.y, 0)
+        self.assertAlmostEqual(v.z, -1)
+        v = Vector3(-1, -1, 1)
+        v.rotate_y_ip(-90)
+        self.assertAlmostEqual(v.x, -1)
+        self.assertEqual(v.y, -1)
+        self.assertAlmostEqual(v.z, -1)
+
+    def test_rotate_y_rad_ip(self):
+        vec = Vector3(1, 0, 0)
+        vec.rotate_y_rad_ip(math.pi / 2)
+        self.assertEqual(vec, (0, 0, -1))
+
+    def test_rotate_z(self):
+        v1 = Vector3(1, 0, 0)
+        v2 = v1.rotate_z(90)
+        v3 = v1.rotate_z(90 + 360)
+        self.assertEqual(v1.x, 1)
+        self.assertEqual(v1.y, 0)
+        self.assertEqual(v1.z, 0)
+        self.assertAlmostEqual(v2.x, 0)
+        self.assertAlmostEqual(v2.y, 1)
+        self.assertEqual(v2.z, 0)
+        self.assertAlmostEqual(v3.x, v2.x)
+        self.assertAlmostEqual(v3.y, v2.y)
+        self.assertEqual(v3.z, v2.z)
+        v1 = Vector3(-1, -1, -1)
+        v2 = v1.rotate_z(-90)
+        self.assertAlmostEqual(v2.x, -1)
+        self.assertAlmostEqual(v2.y, 1)
+        self.assertEqual(v2.z, -1)
+        v2 = v1.rotate_z(360)
+        self.assertAlmostEqual(v1.x, v2.x)
+        self.assertAlmostEqual(v1.y, v2.y)
+        self.assertEqual(v1.z, v2.z)
+        v2 = v1.rotate_z(0)
+        self.assertAlmostEqual(v1.x, v2.x)
+        self.assertAlmostEqual(v1.y, v2.y)
+        self.assertEqual(v1.z, v2.z)
+
+    def test_rotate_z_rad(self):
+        vec = Vector3(1, 0, 0)
+        result = vec.rotate_z_rad(math.pi / 2)
+        self.assertEqual(result, (0, 1, 0))
+
+    def test_rotate_z_ip(self):
+        v = Vector3(1, 0, 0)
+        self.assertEqual(v.rotate_z_ip(90), None)
+        self.assertAlmostEqual(v.x, 0)
+        self.assertAlmostEqual(v.y, 1)
+        self.assertEqual(v.z, 0)
+        v = Vector3(-1, -1, 1)
+        v.rotate_z_ip(-90)
+        self.assertAlmostEqual(v.x, -1)
+        self.assertAlmostEqual(v.y, 1)
+        self.assertEqual(v.z, 1)
+
+    def test_rotate_z_rad_ip(self):
+        vec = Vector3(1, 0, 0)
+        vec.rotate_z_rad_ip(math.pi / 2)
+        self.assertEqual(vec, (0, 1, 0))
+
+    def test_normalize(self):
+        v = self.v1.normalize()
+        # length is 1
+        self.assertAlmostEqual(v.x * v.x + v.y * v.y + v.z * v.z, 1.0)
+        # v1 is unchanged
+        self.assertEqual(self.v1.x, self.l1[0])
+        self.assertEqual(self.v1.y, self.l1[1])
+        self.assertEqual(self.v1.z, self.l1[2])
+        # v2 is parallel to v1 (tested via cross product)
+        cross = (
+            (self.v1.y * v.z - self.v1.z * v.y) ** 2
+            + (self.v1.z * v.x - self.v1.x * v.z) ** 2
+            + (self.v1.x * v.y - self.v1.y * v.x) ** 2
+        )
+        self.assertAlmostEqual(cross, 0.0)
+        self.assertRaises(ValueError, lambda: self.zeroVec.normalize())
+
+    def test_normalize_ip(self):
+        v = +self.v1
+        # v has length != 1 before normalizing
+        self.assertNotEqual(v.x * v.x + v.y * v.y + v.z * v.z, 1.0)
+        # inplace operations should return None
+        self.assertEqual(v.normalize_ip(), None)
+        # length is 1
+        self.assertAlmostEqual(v.x * v.x + v.y * v.y + v.z * v.z, 1.0)
+        # v2 is parallel to v1 (tested via cross product)
+        cross = (
+            (self.v1.y * v.z - self.v1.z * v.y) ** 2
+            + (self.v1.z * v.x - self.v1.x * v.z) ** 2
+            + (self.v1.x * v.y - self.v1.y * v.x) ** 2
+        )
+        self.assertAlmostEqual(cross, 0.0)
+        self.assertRaises(ValueError, lambda: self.zeroVec.normalize_ip())
+
+    def test_is_normalized(self):
+        self.assertEqual(self.v1.is_normalized(), False)
+        v = self.v1.normalize()
+        self.assertEqual(v.is_normalized(), True)
+        self.assertEqual(self.e2.is_normalized(), True)
+        self.assertEqual(self.zeroVec.is_normalized(), False)
+
+    def test_cross(self):
+        def cross(a, b):
+            return Vector3(
+                a[1] * b[2] - a[2] * b[1],
+                a[2] * b[0] - a[0] * b[2],
+                a[0] * b[1] - a[1] * b[0],
+            )
+
+        self.assertEqual(self.v1.cross(self.v2), cross(self.v1, self.v2))
+        self.assertEqual(self.v1.cross(self.l2), cross(self.v1, self.l2))
+        self.assertEqual(self.v1.cross(self.t2), cross(self.v1, self.t2))
+        self.assertEqual(self.v1.cross(self.v2), -self.v2.cross(self.v1))
+        self.assertEqual(self.v1.cross(self.v1), self.zeroVec)
+
+    def test_dot(self):
+        self.assertAlmostEqual(
+            self.v1.dot(self.v2),
+            self.v1.x * self.v2.x + self.v1.y * self.v2.y + self.v1.z * self.v2.z,
+        )
+        self.assertAlmostEqual(
+            self.v1.dot(self.l2),
+            self.v1.x * self.l2[0] + self.v1.y * self.l2[1] + self.v1.z * self.l2[2],
+        )
+        self.assertAlmostEqual(
+            self.v1.dot(self.t2),
+            self.v1.x * self.t2[0] + self.v1.y * self.t2[1] + self.v1.z * self.t2[2],
+        )
+        self.assertAlmostEqual(self.v1.dot(self.v2), self.v2.dot(self.v1))
+        self.assertAlmostEqual(self.v1.dot(self.v2), self.v1 * self.v2)
+
+    def test_angle_to(self):
+        self.assertEqual(Vector3(1, 1, 0).angle_to((-1, 1, 0)), 90)
+        self.assertEqual(Vector3(1, 0, 0).angle_to((0, 0, -1)), 90)
+        self.assertEqual(Vector3(1, 0, 0).angle_to((-1, 0, 1)), 135)
+        self.assertEqual(abs(Vector3(1, 0, 1).angle_to((-1, 0, -1))), 180)
+        # if we rotate v1 by the angle_to v2 around their cross product
+        # we should look in the same direction
+        self.assertEqual(
+            self.v1.rotate(
+                self.v1.angle_to(self.v2), self.v1.cross(self.v2)
+            ).normalize(),
+            self.v2.normalize(),
+        )
+
+    def test_scale_to_length(self):
+        v = Vector3(1, 1, 1)
+        v.scale_to_length(2.5)
+        self.assertEqual(v, Vector3(2.5, 2.5, 2.5) / math.sqrt(3))
+        self.assertRaises(ValueError, lambda: self.zeroVec.scale_to_length(1))
+        self.assertEqual(v.scale_to_length(0), None)
+        self.assertEqual(v, self.zeroVec)
+
+    def test_length(self):
+        self.assertEqual(Vector3(3, 4, 5).length(), math.sqrt(3 * 3 + 4 * 4 + 5 * 5))
+        self.assertEqual(Vector3(-3, 4, 5).length(), math.sqrt(-3 * -3 + 4 * 4 + 5 * 5))
+        self.assertEqual(self.zeroVec.length(), 0)
+
+    def test_length_squared(self):
+        self.assertEqual(Vector3(3, 4, 5).length_squared(), 3 * 3 + 4 * 4 + 5 * 5)
+        self.assertEqual(Vector3(-3, 4, 5).length_squared(), -3 * -3 + 4 * 4 + 5 * 5)
+        self.assertEqual(self.zeroVec.length_squared(), 0)
+
+    def test_reflect(self):
+        v = Vector3(1, -1, 1)
+        n = Vector3(0, 1, 0)
+        self.assertEqual(v.reflect(n), Vector3(1, 1, 1))
+        self.assertEqual(v.reflect(3 * n), v.reflect(n))
+        self.assertEqual(v.reflect(-v), -v)
+        self.assertRaises(ValueError, lambda: v.reflect(self.zeroVec))
+
+    def test_reflect_ip(self):
+        v1 = Vector3(1, -1, 1)
+        v2 = Vector3(v1)
+        n = Vector3(0, 1, 0)
+        self.assertEqual(v2.reflect_ip(n), None)
+        self.assertEqual(v2, Vector3(1, 1, 1))
+        v2 = Vector3(v1)
+        v2.reflect_ip(3 * n)
+        self.assertEqual(v2, v1.reflect(n))
+        v2 = Vector3(v1)
+        v2.reflect_ip(-v1)
+        self.assertEqual(v2, -v1)
+        self.assertRaises(ValueError, lambda: v2.reflect_ip(self.zeroVec))
+
+    def test_distance_to(self):
+        diff = self.v1 - self.v2
+        self.assertEqual(self.e1.distance_to(self.e2), math.sqrt(2))
+        self.assertEqual(self.e1.distance_to((0, 1, 0)), math.sqrt(2))
+        self.assertEqual(self.e1.distance_to([0, 1, 0]), math.sqrt(2))
+        self.assertEqual(
+            self.v1.distance_to(self.v2),
+            math.sqrt(diff.x * diff.x + diff.y * diff.y + diff.z * diff.z),
+        )
+        self.assertEqual(
+            self.v1.distance_to(self.t2),
+            math.sqrt(diff.x * diff.x + diff.y * diff.y + diff.z * diff.z),
+        )
+        self.assertEqual(
+            self.v1.distance_to(self.l2),
+            math.sqrt(diff.x * diff.x + diff.y * diff.y + diff.z * diff.z),
+        )
+        self.assertEqual(self.v1.distance_to(self.v1), 0)
+        self.assertEqual(self.v1.distance_to(self.t1), 0)
+        self.assertEqual(self.v1.distance_to(self.l1), 0)
+        self.assertEqual(self.v1.distance_to(self.v2), self.v2.distance_to(self.v1))
+        self.assertEqual(self.v1.distance_to(self.t2), self.v2.distance_to(self.t1))
+        self.assertEqual(self.v1.distance_to(self.l2), self.v2.distance_to(self.l1))
+
+    def test_distance_to_exceptions(self):
+        v2 = Vector2(10, 10)
+        v3 = Vector3(1, 1, 1)
+
+        # illegal distance Vector3-Vector2 / Vector2-Vector3
+        self.assertRaises(ValueError, v2.distance_to, v3)
+        self.assertRaises(ValueError, v3.distance_to, v2)
+
+        # distance to illegal tuple/list positions
+        self.assertRaises(ValueError, v2.distance_to, (1, 1, 1))
+        self.assertRaises(ValueError, v2.distance_to, (1, 1, 0))
+        self.assertRaises(ValueError, v2.distance_to, (1,))
+        self.assertRaises(ValueError, v2.distance_to, [1, 1, 1])
+        self.assertRaises(ValueError, v2.distance_to, [1, 1, 0])
+        self.assertRaises(
+            ValueError,
+            v2.distance_to,
+            [
+                1,
+            ],
+        )
+        self.assertRaises(ValueError, v2.distance_to, (1, 1, 1))
+        # vec3
+        self.assertRaises(ValueError, v3.distance_to, (1, 1))
+        self.assertRaises(ValueError, v3.distance_to, (1,))
+        self.assertRaises(ValueError, v3.distance_to, [1, 1])
+        self.assertRaises(
+            ValueError,
+            v3.distance_to,
+            [
+                1,
+            ],
+        )
+
+        # illegal types as positions
+        self.assertRaises(TypeError, v2.distance_to, (1, "hello"))
+        self.assertRaises(TypeError, v2.distance_to, ([], []))
+        self.assertRaises(TypeError, v2.distance_to, (1, ("hello",)))
+
+        # illegal args number
+        self.assertRaises(TypeError, v2.distance_to)
+        self.assertRaises(TypeError, v2.distance_to, (1, 1), (1, 2))
+        self.assertRaises(TypeError, v2.distance_to, (1, 1), (1, 2), 1)
+
+    def test_distance_squared_to_exceptions(self):
+        v2 = Vector2(10, 10)
+        v3 = Vector3(1, 1, 1)
+        dist_t = v2.distance_squared_to
+        dist_t3 = v3.distance_squared_to
+        # illegal distance Vector3-Vector2 / Vector2-Vector3
+        self.assertRaises(ValueError, dist_t, v3)
+        self.assertRaises(ValueError, dist_t3, v2)
+
+        # distance to illegal tuple/list positions
+        self.assertRaises(ValueError, dist_t, (1, 1, 1))
+        self.assertRaises(ValueError, dist_t, (1, 1, 0))
+        self.assertRaises(ValueError, dist_t, (1,))
+        self.assertRaises(ValueError, dist_t, [1, 1, 1])
+        self.assertRaises(ValueError, dist_t, [1, 1, 0])
+        self.assertRaises(
+            ValueError,
+            dist_t,
+            [
+                1,
+            ],
+        )
+        self.assertRaises(ValueError, dist_t, (1, 1, 1))
+        # vec3
+        self.assertRaises(ValueError, dist_t3, (1, 1))
+        self.assertRaises(ValueError, dist_t3, (1,))
+        self.assertRaises(ValueError, dist_t3, [1, 1])
+        self.assertRaises(
+            ValueError,
+            dist_t3,
+            [
+                1,
+            ],
+        )
+
+        # illegal types as positions
+        self.assertRaises(TypeError, dist_t, (1, "hello"))
+        self.assertRaises(TypeError, dist_t, ([], []))
+        self.assertRaises(TypeError, dist_t, (1, ("hello",)))
+
+        # illegal args number
+        self.assertRaises(TypeError, dist_t)
+        self.assertRaises(TypeError, dist_t, (1, 1), (1, 2))
+        self.assertRaises(TypeError, dist_t, (1, 1), (1, 2), 1)
+
+    def test_distance_squared_to(self):
+        diff = self.v1 - self.v2
+        self.assertEqual(self.e1.distance_squared_to(self.e2), 2)
+        self.assertEqual(self.e1.distance_squared_to((0, 1, 0)), 2)
+        self.assertEqual(self.e1.distance_squared_to([0, 1, 0]), 2)
+        self.assertAlmostEqual(
+            self.v1.distance_squared_to(self.v2),
+            diff.x * diff.x + diff.y * diff.y + diff.z * diff.z,
+        )
+        self.assertAlmostEqual(
+            self.v1.distance_squared_to(self.t2),
+            diff.x * diff.x + diff.y * diff.y + diff.z * diff.z,
+        )
+        self.assertAlmostEqual(
+            self.v1.distance_squared_to(self.l2),
+            diff.x * diff.x + diff.y * diff.y + diff.z * diff.z,
+        )
+        self.assertEqual(self.v1.distance_squared_to(self.v1), 0)
+        self.assertEqual(self.v1.distance_squared_to(self.t1), 0)
+        self.assertEqual(self.v1.distance_squared_to(self.l1), 0)
+        self.assertEqual(
+            self.v1.distance_squared_to(self.v2), self.v2.distance_squared_to(self.v1)
+        )
+        self.assertEqual(
+            self.v1.distance_squared_to(self.t2), self.v2.distance_squared_to(self.t1)
+        )
+        self.assertEqual(
+            self.v1.distance_squared_to(self.l2), self.v2.distance_squared_to(self.l1)
+        )
+
+    def test_swizzle(self):
+        self.assertEqual(self.v1.yxz, (self.v1.y, self.v1.x, self.v1.z))
+        self.assertEqual(
+            self.v1.xxyyzzxyz,
+            (
+                self.v1.x,
+                self.v1.x,
+                self.v1.y,
+                self.v1.y,
+                self.v1.z,
+                self.v1.z,
+                self.v1.x,
+                self.v1.y,
+                self.v1.z,
+            ),
+        )
+        self.v1.xyz = self.t2
+        self.assertEqual(self.v1, self.t2)
+        self.v1.zxy = self.t2
+        self.assertEqual(self.v1, (self.t2[1], self.t2[2], self.t2[0]))
+        self.v1.yz = self.t2[:2]
+        self.assertEqual(self.v1, (self.t2[1], self.t2[0], self.t2[1]))
+        self.assertEqual(type(self.v1), Vector3)
+
+    @unittest.skipIf(IS_PYPY, "known pypy failure")
+    def test_invalid_swizzle(self):
+        def invalidSwizzleX():
+            Vector3().xx = (1, 2)
+
+        def invalidSwizzleY():
+            Vector3().yy = (1, 2)
+
+        def invalidSwizzleZ():
+            Vector3().zz = (1, 2)
+
+        def invalidSwizzleW():
+            Vector3().ww = (1, 2)
+
+        self.assertRaises(AttributeError, invalidSwizzleX)
+        self.assertRaises(AttributeError, invalidSwizzleY)
+        self.assertRaises(AttributeError, invalidSwizzleZ)
+        self.assertRaises(AttributeError, invalidSwizzleW)
+
+        def invalidAssignment():
+            Vector3().xy = 3
+
+        self.assertRaises(TypeError, invalidAssignment)
+
+    def test_swizzle_return_types(self):
+        self.assertEqual(type(self.v1.x), float)
+        self.assertEqual(type(self.v1.xy), Vector2)
+        self.assertEqual(type(self.v1.xyz), Vector3)
+        # but we don't have vector4 or above... so tuple.
+        self.assertEqual(type(self.v1.xyxy), tuple)
+        self.assertEqual(type(self.v1.xyxyx), tuple)
+
+    def test_dir_works(self):
+        # not every single one of the attributes...
+        attributes = {"lerp", "normalize", "normalize_ip", "reflect", "slerp", "x", "y"}
+        # check if this selection of attributes are all there.
+        self.assertTrue(attributes.issubset(set(dir(self.v1))))
+
+    def test_elementwise(self):
+        # behaviour for "elementwise op scalar"
+        self.assertEqual(
+            self.v1.elementwise() + self.s1,
+            (self.v1.x + self.s1, self.v1.y + self.s1, self.v1.z + self.s1),
+        )
+        self.assertEqual(
+            self.v1.elementwise() - self.s1,
+            (self.v1.x - self.s1, self.v1.y - self.s1, self.v1.z - self.s1),
+        )
+        self.assertEqual(
+            self.v1.elementwise() * self.s2,
+            (self.v1.x * self.s2, self.v1.y * self.s2, self.v1.z * self.s2),
+        )
+        self.assertEqual(
+            self.v1.elementwise() / self.s2,
+            (self.v1.x / self.s2, self.v1.y / self.s2, self.v1.z / self.s2),
+        )
+        self.assertEqual(
+            self.v1.elementwise() // self.s1,
+            (self.v1.x // self.s1, self.v1.y // self.s1, self.v1.z // self.s1),
+        )
+        self.assertEqual(
+            self.v1.elementwise() ** self.s1,
+            (self.v1.x**self.s1, self.v1.y**self.s1, self.v1.z**self.s1),
+        )
+        self.assertEqual(
+            self.v1.elementwise() % self.s1,
+            (self.v1.x % self.s1, self.v1.y % self.s1, self.v1.z % self.s1),
+        )
+        self.assertEqual(
+            self.v1.elementwise() > self.s1,
+            self.v1.x > self.s1 and self.v1.y > self.s1 and self.v1.z > self.s1,
+        )
+        self.assertEqual(
+            self.v1.elementwise() < self.s1,
+            self.v1.x < self.s1 and self.v1.y < self.s1 and self.v1.z < self.s1,
+        )
+        self.assertEqual(
+            self.v1.elementwise() == self.s1,
+            self.v1.x == self.s1 and self.v1.y == self.s1 and self.v1.z == self.s1,
+        )
+        self.assertEqual(
+            self.v1.elementwise() != self.s1,
+            self.v1.x != self.s1 and self.v1.y != self.s1 and self.v1.z != self.s1,
+        )
+        self.assertEqual(
+            self.v1.elementwise() >= self.s1,
+            self.v1.x >= self.s1 and self.v1.y >= self.s1 and self.v1.z >= self.s1,
+        )
+        self.assertEqual(
+            self.v1.elementwise() <= self.s1,
+            self.v1.x <= self.s1 and self.v1.y <= self.s1 and self.v1.z <= self.s1,
+        )
+        # behaviour for "scalar op elementwise"
+        self.assertEqual(5 + self.v1.elementwise(), Vector3(5, 5, 5) + self.v1)
+        self.assertEqual(3.5 - self.v1.elementwise(), Vector3(3.5, 3.5, 3.5) - self.v1)
+        self.assertEqual(7.5 * self.v1.elementwise(), 7.5 * self.v1)
+        self.assertEqual(
+            -3.5 / self.v1.elementwise(),
+            (-3.5 / self.v1.x, -3.5 / self.v1.y, -3.5 / self.v1.z),
+        )
+        self.assertEqual(
+            -3.5 // self.v1.elementwise(),
+            (-3.5 // self.v1.x, -3.5 // self.v1.y, -3.5 // self.v1.z),
+        )
+        self.assertEqual(
+            -(3.5 ** self.v1.elementwise()),
+            (-(3.5**self.v1.x), -(3.5**self.v1.y), -(3.5**self.v1.z)),
+        )
+        self.assertEqual(
+            3 % self.v1.elementwise(), (3 % self.v1.x, 3 % self.v1.y, 3 % self.v1.z)
+        )
+        self.assertEqual(
+            2 < self.v1.elementwise(), 2 < self.v1.x and 2 < self.v1.y and 2 < self.v1.z
+        )
+        self.assertEqual(
+            2 > self.v1.elementwise(), 2 > self.v1.x and 2 > self.v1.y and 2 > self.v1.z
+        )
+        self.assertEqual(
+            1 == self.v1.elementwise(),
+            1 == self.v1.x and 1 == self.v1.y and 1 == self.v1.z,
+        )
+        self.assertEqual(
+            1 != self.v1.elementwise(),
+            1 != self.v1.x and 1 != self.v1.y and 1 != self.v1.z,
+        )
+        self.assertEqual(
+            2 <= self.v1.elementwise(),
+            2 <= self.v1.x and 2 <= self.v1.y and 2 <= self.v1.z,
+        )
+        self.assertEqual(
+            -7 >= self.v1.elementwise(),
+            -7 >= self.v1.x and -7 >= self.v1.y and -7 >= self.v1.z,
+        )
+        self.assertEqual(
+            -7 != self.v1.elementwise(),
+            -7 != self.v1.x and -7 != self.v1.y and -7 != self.v1.z,
+        )
+
+        # behaviour for "elementwise op vector"
+        self.assertEqual(type(self.v1.elementwise() * self.v2), type(self.v1))
+        self.assertEqual(self.v1.elementwise() + self.v2, self.v1 + self.v2)
+        self.assertEqual(self.v1.elementwise() + self.v2, self.v1 + self.v2)
+        self.assertEqual(self.v1.elementwise() - self.v2, self.v1 - self.v2)
+        self.assertEqual(
+            self.v1.elementwise() * self.v2,
+            (self.v1.x * self.v2.x, self.v1.y * self.v2.y, self.v1.z * self.v2.z),
+        )
+        self.assertEqual(
+            self.v1.elementwise() / self.v2,
+            (self.v1.x / self.v2.x, self.v1.y / self.v2.y, self.v1.z / self.v2.z),
+        )
+        self.assertEqual(
+            self.v1.elementwise() // self.v2,
+            (self.v1.x // self.v2.x, self.v1.y // self.v2.y, self.v1.z // self.v2.z),
+        )
+        self.assertEqual(
+            self.v1.elementwise() ** self.v2,
+            (self.v1.x**self.v2.x, self.v1.y**self.v2.y, self.v1.z**self.v2.z),
+        )
+        self.assertEqual(
+            self.v1.elementwise() % self.v2,
+            (self.v1.x % self.v2.x, self.v1.y % self.v2.y, self.v1.z % self.v2.z),
+        )
+        self.assertEqual(
+            self.v1.elementwise() > self.v2,
+            self.v1.x > self.v2.x and self.v1.y > self.v2.y and self.v1.z > self.v2.z,
+        )
+        self.assertEqual(
+            self.v1.elementwise() < self.v2,
+            self.v1.x < self.v2.x and self.v1.y < self.v2.y and self.v1.z < self.v2.z,
+        )
+        self.assertEqual(
+            self.v1.elementwise() >= self.v2,
+            self.v1.x >= self.v2.x
+            and self.v1.y >= self.v2.y
+            and self.v1.z >= self.v2.z,
+        )
+        self.assertEqual(
+            self.v1.elementwise() <= self.v2,
+            self.v1.x <= self.v2.x
+            and self.v1.y <= self.v2.y
+            and self.v1.z <= self.v2.z,
+        )
+        self.assertEqual(
+            self.v1.elementwise() == self.v2,
+            self.v1.x == self.v2.x
+            and self.v1.y == self.v2.y
+            and self.v1.z == self.v2.z,
+        )
+        self.assertEqual(
+            self.v1.elementwise() != self.v2,
+            self.v1.x != self.v2.x
+            and self.v1.y != self.v2.y
+            and self.v1.z != self.v2.z,
+        )
+        # behaviour for "vector op elementwise"
+        self.assertEqual(self.v2 + self.v1.elementwise(), self.v2 + self.v1)
+        self.assertEqual(self.v2 - self.v1.elementwise(), self.v2 - self.v1)
+        self.assertEqual(
+            self.v2 * self.v1.elementwise(),
+            (self.v2.x * self.v1.x, self.v2.y * self.v1.y, self.v2.z * self.v1.z),
+        )
+        self.assertEqual(
+            self.v2 / self.v1.elementwise(),
+            (self.v2.x / self.v1.x, self.v2.y / self.v1.y, self.v2.z / self.v1.z),
+        )
+        self.assertEqual(
+            self.v2 // self.v1.elementwise(),
+            (self.v2.x // self.v1.x, self.v2.y // self.v1.y, self.v2.z // self.v1.z),
+        )
+        self.assertEqual(
+            self.v2 ** self.v1.elementwise(),
+            (self.v2.x**self.v1.x, self.v2.y**self.v1.y, self.v2.z**self.v1.z),
+        )
+        self.assertEqual(
+            self.v2 % self.v1.elementwise(),
+            (self.v2.x % self.v1.x, self.v2.y % self.v1.y, self.v2.z % self.v1.z),
+        )
+        self.assertEqual(
+            self.v2 < self.v1.elementwise(),
+            self.v2.x < self.v1.x and self.v2.y < self.v1.y and self.v2.z < self.v1.z,
+        )
+        self.assertEqual(
+            self.v2 > self.v1.elementwise(),
+            self.v2.x > self.v1.x and self.v2.y > self.v1.y and self.v2.z > self.v1.z,
+        )
+        self.assertEqual(
+            self.v2 <= self.v1.elementwise(),
+            self.v2.x <= self.v1.x
+            and self.v2.y <= self.v1.y
+            and self.v2.z <= self.v1.z,
+        )
+        self.assertEqual(
+            self.v2 >= self.v1.elementwise(),
+            self.v2.x >= self.v1.x
+            and self.v2.y >= self.v1.y
+            and self.v2.z >= self.v1.z,
+        )
+        self.assertEqual(
+            self.v2 == self.v1.elementwise(),
+            self.v2.x == self.v1.x
+            and self.v2.y == self.v1.y
+            and self.v2.z == self.v1.z,
+        )
+        self.assertEqual(
+            self.v2 != self.v1.elementwise(),
+            self.v2.x != self.v1.x
+            and self.v2.y != self.v1.y
+            and self.v2.z != self.v1.z,
+        )
+
+        # behaviour for "elementwise op elementwise"
+        self.assertEqual(
+            self.v2.elementwise() + self.v1.elementwise(), self.v2 + self.v1
+        )
+        self.assertEqual(
+            self.v2.elementwise() - self.v1.elementwise(), self.v2 - self.v1
+        )
+        self.assertEqual(
+            self.v2.elementwise() * self.v1.elementwise(),
+            (self.v2.x * self.v1.x, self.v2.y * self.v1.y, self.v2.z * self.v1.z),
+        )
+        self.assertEqual(
+            self.v2.elementwise() / self.v1.elementwise(),
+            (self.v2.x / self.v1.x, self.v2.y / self.v1.y, self.v2.z / self.v1.z),
+        )
+        self.assertEqual(
+            self.v2.elementwise() // self.v1.elementwise(),
+            (self.v2.x // self.v1.x, self.v2.y // self.v1.y, self.v2.z // self.v1.z),
+        )
+        self.assertEqual(
+            self.v2.elementwise() ** self.v1.elementwise(),
+            (self.v2.x**self.v1.x, self.v2.y**self.v1.y, self.v2.z**self.v1.z),
+        )
+        self.assertEqual(
+            self.v2.elementwise() % self.v1.elementwise(),
+            (self.v2.x % self.v1.x, self.v2.y % self.v1.y, self.v2.z % self.v1.z),
+        )
+        self.assertEqual(
+            self.v2.elementwise() < self.v1.elementwise(),
+            self.v2.x < self.v1.x and self.v2.y < self.v1.y and self.v2.z < self.v1.z,
+        )
+        self.assertEqual(
+            self.v2.elementwise() > self.v1.elementwise(),
+            self.v2.x > self.v1.x and self.v2.y > self.v1.y and self.v2.z > self.v1.z,
+        )
+        self.assertEqual(
+            self.v2.elementwise() <= self.v1.elementwise(),
+            self.v2.x <= self.v1.x
+            and self.v2.y <= self.v1.y
+            and self.v2.z <= self.v1.z,
+        )
+        self.assertEqual(
+            self.v2.elementwise() >= self.v1.elementwise(),
+            self.v2.x >= self.v1.x
+            and self.v2.y >= self.v1.y
+            and self.v2.z >= self.v1.z,
+        )
+        self.assertEqual(
+            self.v2.elementwise() == self.v1.elementwise(),
+            self.v2.x == self.v1.x
+            and self.v2.y == self.v1.y
+            and self.v2.z == self.v1.z,
+        )
+        self.assertEqual(
+            self.v2.elementwise() != self.v1.elementwise(),
+            self.v2.x != self.v1.x
+            and self.v2.y != self.v1.y
+            and self.v2.z != self.v1.z,
+        )
+
+        # other behaviour
+        self.assertEqual(
+            abs(self.v1.elementwise()), (abs(self.v1.x), abs(self.v1.y), abs(self.v1.z))
+        )
+        self.assertEqual(-self.v1.elementwise(), -self.v1)
+        self.assertEqual(+self.v1.elementwise(), +self.v1)
+        self.assertEqual(bool(self.v1.elementwise()), bool(self.v1))
+        self.assertEqual(bool(Vector3().elementwise()), bool(Vector3()))
+        self.assertEqual(self.zeroVec.elementwise() ** 0, (1, 1, 1))
+        self.assertRaises(ValueError, lambda: pow(Vector3(-1, 0, 0).elementwise(), 1.2))
+        self.assertRaises(ZeroDivisionError, lambda: self.zeroVec.elementwise() ** -1)
+        self.assertRaises(ZeroDivisionError, lambda: Vector3(1, 1, 1).elementwise() / 0)
+        self.assertRaises(
+            ZeroDivisionError, lambda: Vector3(1, 1, 1).elementwise() // 0
+        )
+        self.assertRaises(ZeroDivisionError, lambda: Vector3(1, 1, 1).elementwise() % 0)
+        self.assertRaises(
+            ZeroDivisionError, lambda: Vector3(1, 1, 1).elementwise() / self.zeroVec
+        )
+        self.assertRaises(
+            ZeroDivisionError, lambda: Vector3(1, 1, 1).elementwise() // self.zeroVec
+        )
+        self.assertRaises(
+            ZeroDivisionError, lambda: Vector3(1, 1, 1).elementwise() % self.zeroVec
+        )
+        self.assertRaises(ZeroDivisionError, lambda: 2 / self.zeroVec.elementwise())
+        self.assertRaises(ZeroDivisionError, lambda: 2 // self.zeroVec.elementwise())
+        self.assertRaises(ZeroDivisionError, lambda: 2 % self.zeroVec.elementwise())
+
+    def test_slerp(self):
+        self.assertRaises(ValueError, lambda: self.zeroVec.slerp(self.v1, 0.5))
+        self.assertRaises(ValueError, lambda: self.v1.slerp(self.zeroVec, 0.5))
+        self.assertRaises(ValueError, lambda: self.zeroVec.slerp(self.zeroVec, 0.5))
+        steps = 10
+        angle_step = self.e1.angle_to(self.e2) / steps
+        for i, u in (
+            (i, self.e1.slerp(self.e2, i / float(steps))) for i in range(steps + 1)
+        ):
+            self.assertAlmostEqual(u.length(), 1)
+            self.assertAlmostEqual(self.e1.angle_to(u), i * angle_step)
+        self.assertEqual(u, self.e2)
+
+        v1 = Vector3(100, 0, 0)
+        v2 = Vector3(0, 10, 7)
+        radial_factor = v2.length() / v1.length()
+        for i, u in ((i, v1.slerp(v2, -i / float(steps))) for i in range(steps + 1)):
+            self.assertAlmostEqual(
+                u.length(),
+                (v2.length() - v1.length()) * (float(i) / steps) + v1.length(),
+            )
+        self.assertEqual(u, v2)
+        self.assertEqual(v1.slerp(v1, 0.5), v1)
+        self.assertEqual(v2.slerp(v2, 0.5), v2)
+        self.assertRaises(ValueError, lambda: v1.slerp(-v1, 0.5))
+
+    def test_lerp(self):
+        v1 = Vector3(0, 0, 0)
+        v2 = Vector3(10, 10, 10)
+        self.assertEqual(v1.lerp(v2, 0.5), (5, 5, 5))
+        self.assertRaises(ValueError, lambda: v1.lerp(v2, 2.5))
+
+        v1 = Vector3(-10, -5, -20)
+        v2 = Vector3(10, 10, -20)
+        self.assertEqual(v1.lerp(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))
+        self.assertEqual((2 * self.e2).as_spherical(), (2, 90, 90))
+        self.assertRaises(TypeError, lambda: v.from_spherical((None, None, None)))
+        self.assertRaises(TypeError, lambda: v.from_spherical("abc"))
+        self.assertRaises(TypeError, lambda: v.from_spherical((None, 1, 2)))
+        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)
+        v *= 2
+        self.assertEqual(v, (2.0, 2.0, 2.0))
+
+        v = Vector3(4, 4, 4)
+        v /= 2
+        self.assertEqual(v, (2.0, 2.0, 2.0))
+
+        v = Vector3(3.0, 3.0, 3.0)
+        v -= (1, 1, 1)
+        self.assertEqual(v, (2.0, 2.0, 2.0))
+
+        v = Vector3(3.0, 3.0, 3.0)
+        v += (1, 1, 1)
+        self.assertEqual(v, (4.0, 4.0, 4.0))
+
+    def test_pickle(self):
+        import pickle
+
+        v2 = Vector2(1, 2)
+        v3 = Vector3(1, 2, 3)
+        self.assertEqual(pickle.loads(pickle.dumps(v2)), v2)
+        self.assertEqual(pickle.loads(pickle.dumps(v3)), v3)
+
+    def test_subclass_operation(self):
+        class Vector(pygame.math.Vector3):
+            pass
+
+        v = Vector(2.0, 2.0, 2.0)
+        v *= 2
+        self.assertEqual(v, (4.0, 4.0, 4.0))
+
+    def test_swizzle_constants(self):
+        """We can get constant values from a swizzle."""
+        v = Vector2(7, 6)
+        self.assertEqual(
+            v.xy1,
+            (7.0, 6.0, 1.0),
+        )
+
+    def test_swizzle_four_constants(self):
+        """We can get 4 constant values from a swizzle."""
+        v = Vector2(7, 6)
+        self.assertEqual(
+            v.xy01,
+            (7.0, 6.0, 0.0, 1.0),
+        )
+
+    def test_swizzle_oob(self):
+        """An out-of-bounds swizzle raises an AttributeError."""
+        v = Vector2(7, 6)
+        with self.assertRaises(AttributeError):
+            v.xyz
+
+    @unittest.skipIf(IS_PYPY, "known pypy failure")
+    def test_swizzle_set_oob(self):
+        """An out-of-bounds swizzle set raises an AttributeError."""
+        v = Vector2(7, 6)
+        with self.assertRaises(AttributeError):
+            v.xz = (1, 1)
+
+    def test_project_v3_onto_x_axis(self):
+        """Project onto x-axis, e.g. get the component pointing in the x-axis direction."""
+        # arrange
+        v = Vector3(2, 3, 4)
+        x_axis = Vector3(10, 0, 0)
+
+        # act
+        actual = v.project(x_axis)
+
+        # assert
+        self.assertEqual(v.x, actual.x)
+        self.assertEqual(0, actual.y)
+        self.assertEqual(0, actual.z)
+
+    def test_project_v3_onto_y_axis(self):
+        """Project onto y-axis, e.g. get the component pointing in the y-axis direction."""
+        # arrange
+        v = Vector3(2, 3, 4)
+        y_axis = Vector3(0, 100, 0)
+
+        # act
+        actual = v.project(y_axis)
+
+        # assert
+        self.assertEqual(0, actual.x)
+        self.assertEqual(v.y, actual.y)
+        self.assertEqual(0, actual.z)
+
+    def test_project_v3_onto_z_axis(self):
+        """Project onto z-axis, e.g. get the component pointing in the z-axis direction."""
+        # arrange
+        v = Vector3(2, 3, 4)
+        y_axis = Vector3(0, 0, 77)
+
+        # act
+        actual = v.project(y_axis)
+
+        # assert
+        self.assertEqual(0, actual.x)
+        self.assertEqual(0, actual.y)
+        self.assertEqual(v.z, actual.z)
+
+    def test_project_v3_onto_other(self):
+        """Project onto other vector."""
+        # arrange
+        v = Vector3(2, 3, 4)
+        other = Vector3(3, 5, 7)
+
+        # act
+        actual = v.project(other)
+
+        # assert
+        expected = v.dot(other) / other.dot(other) * other
+        self.assertAlmostEqual(expected.x, actual.x)
+        self.assertAlmostEqual(expected.y, actual.y)
+        self.assertAlmostEqual(expected.z, actual.z)
+
+    def test_project_v3_onto_other_as_tuple(self):
+        """Project onto other tuple as vector."""
+        # arrange
+        v = Vector3(2, 3, 4)
+        other = Vector3(3, 5, 7)
+
+        # act
+        actual = v.project(tuple(other))
+
+        # assert
+        expected = v.dot(other) / other.dot(other) * other
+        self.assertAlmostEqual(expected.x, actual.x)
+        self.assertAlmostEqual(expected.y, actual.y)
+        self.assertAlmostEqual(expected.z, actual.z)
+
+    def test_project_v3_onto_other_as_list(self):
+        """Project onto other list as vector."""
+        # arrange
+        v = Vector3(2, 3, 4)
+        other = Vector3(3, 5, 7)
+
+        # act
+        actual = v.project(list(other))
+
+        # assert
+        expected = v.dot(other) / other.dot(other) * other
+        self.assertAlmostEqual(expected.x, actual.x)
+        self.assertAlmostEqual(expected.y, actual.y)
+        self.assertAlmostEqual(expected.z, actual.z)
+
+    def test_project_v3_raises_if_other_has_zero_length(self):
+        """Check if exception is raise when projected on vector has zero length."""
+        # arrange
+        v = Vector3(2, 3, 4)
+        other = Vector3(0, 0, 0)
+
+        # act / assert
+        self.assertRaises(ValueError, v.project, other)
+
+    def test_project_v3_raises_if_other_is_not_iterable(self):
+        """Check if exception is raise when projected on vector is not iterable."""
+        # arrange
+        v = Vector3(2, 3, 4)
+        other = 10
+
+        # act / assert
+        self.assertRaises(TypeError, v.project, other)
+
+    def test_collection_abc(self):
+        v = Vector3(3, 4, 5)
+        self.assertTrue(isinstance(v, Collection))
+        self.assertFalse(isinstance(v, Sequence))
+
+    def test_clamp_mag_v3_max(self):
+        v1 = Vector3(7, 2, 2)
+        v2 = v1.clamp_magnitude(5)
+        v3 = v1.clamp_magnitude(0, 5)
+        self.assertEqual(v2, v3)
+
+        v1.clamp_magnitude_ip(5)
+        self.assertEqual(v1, v2)
+
+        v1.clamp_magnitude_ip(0, 5)
+        self.assertEqual(v1, v2)
+
+        expected_v2 = Vector3(4.635863249727653, 1.3245323570650438, 1.3245323570650438)
+        self.assertEqual(expected_v2, v2)
+
+    def test_clamp_mag_v3_min(self):
+        v1 = Vector3(3, 1, 2)
+        v2 = v1.clamp_magnitude(5, 10)
+        v1.clamp_magnitude_ip(5, 10)
+        expected_v2 = Vector3(4.008918628686366, 1.3363062095621219, 2.6726124191242437)
+        self.assertEqual(expected_v2, v1)
+        self.assertEqual(expected_v2, v2)
+
+    def test_clamp_mag_v3_no_change(self):
+        v1 = Vector3(1, 2, 3)
+        for args in (
+            (1, 6),
+            (1.12, 5.55),
+            (0.93, 6.83),
+            (7.6,),
+        ):
+            with self.subTest(args=args):
+                v2 = v1.clamp_magnitude(*args)
+                v1.clamp_magnitude_ip(*args)
+                self.assertEqual(v1, v2)
+                self.assertEqual(v1, Vector3(1, 2, 3))
+
+    def test_clamp_mag_v3_edge_cases(self):
+        v1 = Vector3(1, 2, 1)
+        v2 = v1.clamp_magnitude(6, 6)
+        v1.clamp_magnitude_ip(6, 6)
+        self.assertEqual(v1, v2)
+        self.assertAlmostEqual(v1.length(), 6)
+
+        v2 = v1.clamp_magnitude(0)
+        v1.clamp_magnitude_ip(0, 0)
+        self.assertEqual(v1, v2)
+        self.assertEqual(v1, Vector3())
+
+    def test_clamp_mag_v3_errors(self):
+        v1 = Vector3(1, 2, 2)
+        for invalid_args in (
+            ("foo", "bar"),
+            (1, 2, 3),
+            (342.234, "test"),
+        ):
+            with self.subTest(invalid_args=invalid_args):
+                self.assertRaises(TypeError, v1.clamp_magnitude, *invalid_args)
+                self.assertRaises(TypeError, v1.clamp_magnitude_ip, *invalid_args)
+
+        for invalid_args in (
+            (-1,),
+            (4, 3),  # min > max
+            (-4, 10),
+            (-4, -2),
+        ):
+            with self.subTest(invalid_args=invalid_args):
+                self.assertRaises(ValueError, v1.clamp_magnitude, *invalid_args)
+                self.assertRaises(ValueError, v1.clamp_magnitude_ip, *invalid_args)
+
+        # 0 vector
+        v2 = Vector3()
+        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"""
+        v = Vector3(4, 2, 0)
+
+        class TestVector(Vector3):
+            def supermariobrosiscool(self):
+                return 722
+
+        other = TestVector(4, 1, 0)
+
+        self.assertEqual(other.supermariobrosiscool(), 722)
+        self.assertNotEqual(type(v), TestVector)
+        self.assertNotEqual(type(v), type(other.copy()))
+        self.assertEqual(TestVector, type(other.reflect(v)))
+        self.assertEqual(TestVector, type(other.lerp(v, 1)))
+        self.assertEqual(TestVector, type(other.slerp(v, 1)))
+        self.assertEqual(TestVector, type(other.rotate(5, v)))
+        self.assertEqual(TestVector, type(other.rotate_rad(5, v)))
+        self.assertEqual(TestVector, type(other.project(v)))
+        self.assertEqual(TestVector, type(other.move_towards(v, 5)))
+        self.assertEqual(TestVector, type(other.clamp_magnitude(5)))
+        self.assertEqual(TestVector, type(other.clamp_magnitude(1, 5)))
+        self.assertEqual(TestVector, type(other.elementwise() + other))
+
+        other1 = TestVector(4, 2, 0)
+
+        self.assertEqual(type(other + other1), TestVector)
+        self.assertEqual(type(other - other1), TestVector)
+        self.assertEqual(type(other * 3), TestVector)
+        self.assertEqual(type(other / 3), TestVector)
+        self.assertEqual(type(other.elementwise() ** 3), TestVector)
+
+    def test_move_towards_basic(self):
+        expected = Vector3(7.93205057, 2006.38284641, 43.80780420)
+        origin = Vector3(7.22, 2004.0, 42.13)
+        target = Vector3(12.30, 2021.0, 54.1)
+        change_ip = origin.copy()
+
+        change = origin.move_towards(target, 3)
+        change_ip.move_towards_ip(target, 3)
+
+        self.assertEqual(change, expected)
+        self.assertEqual(change_ip, expected)
+
+    def test_move_towards_max_distance(self):
+        expected = Vector3(12.30, 2021, 42.5)
+        origin = Vector3(7.22, 2004.0, 17.5)
+        change_ip = origin.copy()
+
+        change = origin.move_towards(expected, 100)
+        change_ip.move_towards_ip(expected, 100)
+
+        self.assertEqual(change, expected)
+        self.assertEqual(change_ip, expected)
+
+    def test_move_nowhere(self):
+        origin = Vector3(7.22, 2004.0, 24.5)
+        target = Vector3(12.30, 2021.0, 3.2)
+        change_ip = origin.copy()
+
+        change = origin.move_towards(target, 0)
+        change_ip.move_towards_ip(target, 0)
+
+        self.assertEqual(change, origin)
+        self.assertEqual(change_ip, origin)
+
+    def test_move_away(self):
+        expected = Vector3(6.74137906, 2002.39831577, 49.70890994)
+        origin = Vector3(7.22, 2004.0, 52.2)
+        target = Vector3(12.30, 2021.0, 78.64)
+        change_ip = origin.copy()
+
+        change = origin.move_towards(target, -3)
+        change_ip.move_towards_ip(target, -3)
+
+        self.assertEqual(change, expected)
+        self.assertEqual(change_ip, expected)
+
+    def test_move_towards_self(self):
+        vec = Vector3(6.36, 2001.13, -123.14)
+        vec2 = vec.copy()
+        for dist in (-3.54, -1, 0, 0.234, 12):
+            self.assertEqual(vec.move_towards(vec2, dist), vec)
+            vec2.move_towards_ip(vec, dist)
+            self.assertEqual(vec, vec2)
+
+    def test_move_towards_errors(self):
+        origin = Vector3(7.22, 2004.0, 4.1)
+        target = Vector3(12.30, 2021.0, -421.5)
+
+        self.assertRaises(TypeError, origin.move_towards, target, 3, 2)
+        self.assertRaises(TypeError, origin.move_towards_ip, target, 3, 2)
+        self.assertRaises(TypeError, origin.move_towards, target, "a")
+        self.assertRaises(TypeError, origin.move_towards_ip, target, "b")
+        self.assertRaises(TypeError, origin.move_towards, "c", 3)
+        self.assertRaises(TypeError, origin.move_towards_ip, "d", 3)
+
+
+if __name__ == "__main__":
+    unittest.main()
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/midi_test.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/midi_test.py
new file mode 100644
index 0000000..f4189a2
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/midi_test.py
@@ -0,0 +1,463 @@
+import unittest
+
+
+import pygame
+
+
+class MidiInputTest(unittest.TestCase):
+    __tags__ = ["interactive"]
+
+    def setUp(self):
+        import pygame.midi
+
+        pygame.midi.init()
+        in_id = pygame.midi.get_default_input_id()
+        if in_id != -1:
+            self.midi_input = pygame.midi.Input(in_id)
+        else:
+            self.midi_input = None
+
+    def tearDown(self):
+        if self.midi_input:
+            self.midi_input.close()
+        pygame.midi.quit()
+
+    def test_Input(self):
+        i = pygame.midi.get_default_input_id()
+        if self.midi_input:
+            self.assertEqual(self.midi_input.device_id, i)
+
+        # try feeding it an input id.
+        i = pygame.midi.get_default_output_id()
+
+        # can handle some invalid input too.
+        self.assertRaises(pygame.midi.MidiException, pygame.midi.Input, i)
+        self.assertRaises(pygame.midi.MidiException, pygame.midi.Input, 9009)
+        self.assertRaises(pygame.midi.MidiException, pygame.midi.Input, -1)
+        self.assertRaises(TypeError, pygame.midi.Input, "1234")
+        self.assertRaises(OverflowError, pygame.midi.Input, pow(2, 99))
+
+    def test_poll(self):
+        if not self.midi_input:
+            self.skipTest("No midi Input device")
+
+        self.assertFalse(self.midi_input.poll())
+        # TODO fake some incoming data
+
+        pygame.midi.quit()
+        self.assertRaises(RuntimeError, self.midi_input.poll)
+        # set midi_input to None to avoid error in tearDown
+        self.midi_input = None
+
+    def test_read(self):
+        if not self.midi_input:
+            self.skipTest("No midi Input device")
+
+        read = self.midi_input.read(5)
+        self.assertEqual(read, [])
+        # TODO fake some  incoming data
+
+        pygame.midi.quit()
+        self.assertRaises(RuntimeError, self.midi_input.read, 52)
+        # set midi_input to None to avoid error in tearDown
+        self.midi_input = None
+
+    def test_close(self):
+        if not self.midi_input:
+            self.skipTest("No midi Input device")
+
+        self.assertIsNotNone(self.midi_input._input)
+        self.midi_input.close()
+        self.assertIsNone(self.midi_input._input)
+
+
+class MidiOutputTest(unittest.TestCase):
+    __tags__ = ["interactive"]
+
+    def setUp(self):
+        import pygame.midi
+
+        pygame.midi.init()
+        m_out_id = pygame.midi.get_default_output_id()
+        if m_out_id != -1:
+            self.midi_output = pygame.midi.Output(m_out_id)
+        else:
+            self.midi_output = None
+
+    def tearDown(self):
+        if self.midi_output:
+            self.midi_output.close()
+        pygame.midi.quit()
+
+    def test_Output(self):
+        i = pygame.midi.get_default_output_id()
+        if self.midi_output:
+            self.assertEqual(self.midi_output.device_id, i)
+
+        # try feeding it an input id.
+        i = pygame.midi.get_default_input_id()
+
+        # can handle some invalid input too.
+        self.assertRaises(pygame.midi.MidiException, pygame.midi.Output, i)
+        self.assertRaises(pygame.midi.MidiException, pygame.midi.Output, 9009)
+        self.assertRaises(pygame.midi.MidiException, pygame.midi.Output, -1)
+        self.assertRaises(TypeError, pygame.midi.Output, "1234")
+        self.assertRaises(OverflowError, pygame.midi.Output, pow(2, 99))
+
+    def test_note_off(self):
+        if self.midi_output:
+            out = self.midi_output
+            out.note_on(5, 30, 0)
+            out.note_off(5, 30, 0)
+            with self.assertRaises(ValueError) as cm:
+                out.note_off(5, 30, 25)
+            self.assertEqual(str(cm.exception), "Channel not between 0 and 15.")
+            with self.assertRaises(ValueError) as cm:
+                out.note_off(5, 30, -1)
+            self.assertEqual(str(cm.exception), "Channel not between 0 and 15.")
+
+    def test_note_on(self):
+        if self.midi_output:
+            out = self.midi_output
+            out.note_on(5, 30, 0)
+            out.note_on(5, 42, 10)
+            with self.assertRaises(ValueError) as cm:
+                out.note_on(5, 30, 25)
+            self.assertEqual(str(cm.exception), "Channel not between 0 and 15.")
+            with self.assertRaises(ValueError) as cm:
+                out.note_on(5, 30, -1)
+            self.assertEqual(str(cm.exception), "Channel not between 0 and 15.")
+
+    def test_set_instrument(self):
+        if not self.midi_output:
+            self.skipTest("No midi device")
+        out = self.midi_output
+        out.set_instrument(5)
+        out.set_instrument(42, channel=2)
+        with self.assertRaises(ValueError) as cm:
+            out.set_instrument(-6)
+        self.assertEqual(str(cm.exception), "Undefined instrument id: -6")
+        with self.assertRaises(ValueError) as cm:
+            out.set_instrument(156)
+        self.assertEqual(str(cm.exception), "Undefined instrument id: 156")
+        with self.assertRaises(ValueError) as cm:
+            out.set_instrument(5, -1)
+        self.assertEqual(str(cm.exception), "Channel not between 0 and 15.")
+        with self.assertRaises(ValueError) as cm:
+            out.set_instrument(5, 16)
+        self.assertEqual(str(cm.exception), "Channel not between 0 and 15.")
+
+    def test_write(self):
+        if not self.midi_output:
+            self.skipTest("No midi device")
+
+        out = self.midi_output
+        out.write([[[0xC0, 0, 0], 20000]])
+        # is equivalent to
+        out.write([[[0xC0], 20000]])
+        # example from the docstring :
+        # 1. choose program change 1 at time 20000 and
+        # 2. send note 65 with velocity 100 500 ms later
+        out.write([[[0xC0, 0, 0], 20000], [[0x90, 60, 100], 20500]])
+
+        out.write([])
+        verrry_long = [[[0x90, 60, i % 100], 20000 + 100 * i] for i in range(1024)]
+        out.write(verrry_long)
+
+        too_long = [[[0x90, 60, i % 100], 20000 + 100 * i] for i in range(1025)]
+        self.assertRaises(IndexError, out.write, too_long)
+        # test wrong data
+        with self.assertRaises(TypeError) as cm:
+            out.write("Non sens ?")
+        error_msg = "unsupported operand type(s) for &: 'str' and 'int'"
+        self.assertEqual(str(cm.exception), error_msg)
+
+        with self.assertRaises(TypeError) as cm:
+            out.write(["Hey what's that?"])
+        self.assertEqual(str(cm.exception), error_msg)
+
+    def test_write_short(self):
+        if not self.midi_output:
+            self.skipTest("No midi device")
+
+        out = self.midi_output
+        # program change
+        out.write_short(0xC0)
+        # put a note on, then off.
+        out.write_short(0x90, 65, 100)
+        out.write_short(0x80, 65, 100)
+        out.write_short(0x90)
+
+    def test_write_sys_ex(self):
+        if not self.midi_output:
+            self.skipTest("No midi device")
+
+        out = self.midi_output
+        out.write_sys_ex(pygame.midi.time(), [0xF0, 0x7D, 0x10, 0x11, 0x12, 0x13, 0xF7])
+
+    def test_pitch_bend(self):
+        # FIXME : pitch_bend in the code, but not in documentation
+        if not self.midi_output:
+            self.skipTest("No midi device")
+
+        out = self.midi_output
+        with self.assertRaises(ValueError) as cm:
+            out.pitch_bend(5, channel=-1)
+        self.assertEqual(str(cm.exception), "Channel not between 0 and 15.")
+        with self.assertRaises(ValueError) as cm:
+            out.pitch_bend(5, channel=16)
+        with self.assertRaises(ValueError) as cm:
+            out.pitch_bend(-10001, 1)
+        self.assertEqual(
+            str(cm.exception),
+            "Pitch bend value must be between " "-8192 and +8191, not -10001.",
+        )
+        with self.assertRaises(ValueError) as cm:
+            out.pitch_bend(10665, 2)
+
+    def test_close(self):
+        if not self.midi_output:
+            self.skipTest("No midi device")
+        self.assertIsNotNone(self.midi_output._output)
+        self.midi_output.close()
+        self.assertIsNone(self.midi_output._output)
+
+    def test_abort(self):
+        if not self.midi_output:
+            self.skipTest("No midi device")
+        self.assertEqual(self.midi_output._aborted, 0)
+        self.midi_output.abort()
+        self.assertEqual(self.midi_output._aborted, 1)
+
+
+class MidiModuleTest(unittest.TestCase):
+    """Midi module tests that require midi hardware or midi.init().
+
+    See MidiModuleNonInteractiveTest for non-interactive module tests.
+    """
+
+    __tags__ = ["interactive"]
+
+    def setUp(self):
+        import pygame.midi
+
+        pygame.midi.init()
+
+    def tearDown(self):
+        pygame.midi.quit()
+
+    def test_get_count(self):
+        c = pygame.midi.get_count()
+        self.assertIsInstance(c, int)
+        self.assertTrue(c >= 0)
+
+    def test_get_default_input_id(self):
+        midin_id = pygame.midi.get_default_input_id()
+        # if there is a not None return make sure it is an int.
+        self.assertIsInstance(midin_id, int)
+        self.assertTrue(midin_id >= -1)
+        pygame.midi.quit()
+        self.assertRaises(RuntimeError, pygame.midi.get_default_output_id)
+
+    def test_get_default_output_id(self):
+        c = pygame.midi.get_default_output_id()
+        self.assertIsInstance(c, int)
+        self.assertTrue(c >= -1)
+        pygame.midi.quit()
+        self.assertRaises(RuntimeError, pygame.midi.get_default_output_id)
+
+    def test_get_device_info(self):
+        an_id = pygame.midi.get_default_output_id()
+        if an_id != -1:
+            interf, name, input, output, opened = pygame.midi.get_device_info(an_id)
+            self.assertEqual(output, 1)
+            self.assertEqual(input, 0)
+            self.assertEqual(opened, 0)
+
+        an_in_id = pygame.midi.get_default_input_id()
+        if an_in_id != -1:
+            r = pygame.midi.get_device_info(an_in_id)
+            # if r is None, it means that the id is out of range.
+            interf, name, input, output, opened = r
+
+            self.assertEqual(output, 0)
+            self.assertEqual(input, 1)
+            self.assertEqual(opened, 0)
+        out_of_range = pygame.midi.get_count()
+        for num in range(out_of_range):
+            self.assertIsNotNone(pygame.midi.get_device_info(num))
+        info = pygame.midi.get_device_info(out_of_range)
+        self.assertIsNone(info)
+
+    def test_init(self):
+        pygame.midi.quit()
+        self.assertRaises(RuntimeError, pygame.midi.get_count)
+        # initialising many times should be fine.
+        pygame.midi.init()
+        pygame.midi.init()
+        pygame.midi.init()
+        pygame.midi.init()
+
+        self.assertTrue(pygame.midi.get_init())
+
+    def test_quit(self):
+        # It is safe to call this more than once.
+        pygame.midi.quit()
+        pygame.midi.init()
+        pygame.midi.quit()
+        pygame.midi.quit()
+        pygame.midi.init()
+        pygame.midi.init()
+        pygame.midi.quit()
+
+        self.assertFalse(pygame.midi.get_init())
+
+    def test_get_init(self):
+        # Already initialized as pygame.midi.init() was called in setUp().
+        self.assertTrue(pygame.midi.get_init())
+
+    def test_time(self):
+        mtime = pygame.midi.time()
+        self.assertIsInstance(mtime, int)
+        # should be close to 2-3... since the timer is just init'd.
+        self.assertTrue(0 <= mtime < 100)
+
+
+class MidiModuleNonInteractiveTest(unittest.TestCase):
+    """Midi module tests that do not require midi hardware or midi.init().
+
+    See MidiModuleTest for interactive module tests.
+    """
+
+    def setUp(self):
+        import pygame.midi
+
+    def test_midiin(self):
+        """Ensures the MIDIIN event id exists in the midi module.
+
+        The MIDIIN event id can be accessed via the midi module for backward
+        compatibility.
+        """
+        self.assertEqual(pygame.midi.MIDIIN, pygame.MIDIIN)
+        self.assertEqual(pygame.midi.MIDIIN, pygame.locals.MIDIIN)
+
+        self.assertNotEqual(pygame.midi.MIDIIN, pygame.MIDIOUT)
+        self.assertNotEqual(pygame.midi.MIDIIN, pygame.locals.MIDIOUT)
+
+    def test_midiout(self):
+        """Ensures the MIDIOUT event id exists in the midi module.
+
+        The MIDIOUT event id can be accessed via the midi module for backward
+        compatibility.
+        """
+        self.assertEqual(pygame.midi.MIDIOUT, pygame.MIDIOUT)
+        self.assertEqual(pygame.midi.MIDIOUT, pygame.locals.MIDIOUT)
+
+        self.assertNotEqual(pygame.midi.MIDIOUT, pygame.MIDIIN)
+        self.assertNotEqual(pygame.midi.MIDIOUT, pygame.locals.MIDIIN)
+
+    def test_MidiException(self):
+        """Ensures the MidiException is raised as expected."""
+
+        def raiseit():
+            raise pygame.midi.MidiException("Hello Midi param")
+
+        with self.assertRaises(pygame.midi.MidiException) as cm:
+            raiseit()
+
+        self.assertEqual(cm.exception.parameter, "Hello Midi param")
+
+    def test_midis2events(self):
+        """Ensures midi events are properly converted to pygame events."""
+        # List/tuple indexes.
+        MIDI_DATA = 0
+        MD_STATUS = 0
+        MD_DATA1 = 1
+        MD_DATA2 = 2
+        MD_DATA3 = 3
+
+        TIMESTAMP = 1
+
+        # Midi events take the form of:
+        # ((status, data1, data2, data3), timestamp)
+        midi_events = (
+            ((0xC0, 0, 1, 2), 20000),
+            ((0x90, 60, 1000, "string_data"), 20001),
+            (("0", "1", "2", "3"), "4"),
+        )
+        expected_num_events = len(midi_events)
+
+        # Test different device ids.
+        for device_id in range(3):
+            pg_events = pygame.midi.midis2events(midi_events, device_id)
+
+            self.assertEqual(len(pg_events), expected_num_events)
+
+            for i, pg_event in enumerate(pg_events):
+                # Get the original midi data for comparison.
+                midi_event = midi_events[i]
+                midi_event_data = midi_event[MIDI_DATA]
+
+                # Can't directly check event instance as pygame.event.Event is
+                # a function.
+                # self.assertIsInstance(pg_event, pygame.event.Event)
+                self.assertEqual(pg_event.__class__.__name__, "Event")
+                self.assertEqual(pg_event.type, pygame.MIDIIN)
+                self.assertEqual(pg_event.status, midi_event_data[MD_STATUS])
+                self.assertEqual(pg_event.data1, midi_event_data[MD_DATA1])
+                self.assertEqual(pg_event.data2, midi_event_data[MD_DATA2])
+                self.assertEqual(pg_event.data3, midi_event_data[MD_DATA3])
+                self.assertEqual(pg_event.timestamp, midi_event[TIMESTAMP])
+                self.assertEqual(pg_event.vice_id, device_id)
+
+    def test_midis2events__missing_event_data(self):
+        """Ensures midi events with missing values are handled properly."""
+        midi_event_missing_data = ((0xC0, 0, 1), 20000)
+        midi_event_missing_timestamp = ((0xC0, 0, 1, 2),)
+
+        for midi_event in (midi_event_missing_data, midi_event_missing_timestamp):
+            with self.assertRaises(ValueError):
+                events = pygame.midi.midis2events([midi_event], 0)
+
+    def test_midis2events__extra_event_data(self):
+        """Ensures midi events with extra values are handled properly."""
+        midi_event_extra_data = ((0xC0, 0, 1, 2, "extra"), 20000)
+        midi_event_extra_timestamp = ((0xC0, 0, 1, 2), 20000, "extra")
+
+        for midi_event in (midi_event_extra_data, midi_event_extra_timestamp):
+            with self.assertRaises(ValueError):
+                events = pygame.midi.midis2events([midi_event], 0)
+
+    def test_midis2events__extra_event_data_missing_timestamp(self):
+        """Ensures midi events with extra data and no timestamps are handled
+        properly.
+        """
+        midi_event_extra_data_no_timestamp = ((0xC0, 0, 1, 2, "extra"),)
+
+        with self.assertRaises(ValueError):
+            events = pygame.midi.midis2events([midi_event_extra_data_no_timestamp], 0)
+
+    def test_conversions(self):
+        """of frequencies to midi note numbers and ansi note names."""
+        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)
+        self.assertEqual(frequency_to_midi(4186.0), 108)
+        self.assertEqual(midi_to_frequency(21), 27.5)
+        self.assertEqual(midi_to_frequency(26), 36.7)
+        self.assertEqual(midi_to_frequency(108), 4186.0)
+        self.assertEqual(midi_to_ansi_note(21), "A0")
+        self.assertEqual(midi_to_ansi_note(71), "B4")
+        self.assertEqual(midi_to_ansi_note(82), "A#5")
+        self.assertEqual(midi_to_ansi_note(83), "B5")
+        self.assertEqual(midi_to_ansi_note(93), "A6")
+        self.assertEqual(midi_to_ansi_note(94), "A#6")
+        self.assertEqual(midi_to_ansi_note(95), "B6")
+        self.assertEqual(midi_to_ansi_note(96), "C7")
+        self.assertEqual(midi_to_ansi_note(102), "F#7")
+        self.assertEqual(midi_to_ansi_note(108), "C8")
+
+
+if __name__ == "__main__":
+    unittest.main()
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/mixer_music_tags.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/mixer_music_tags.py
new file mode 100644
index 0000000..30f6893
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/mixer_music_tags.py
@@ -0,0 +1,7 @@
+__tags__ = []
+
+import pygame
+import sys
+
+if "pygame.mixer_music" not in sys.modules:
+    __tags__.extend(("ignore", "subprocess_ignore"))
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/mixer_music_test.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/mixer_music_test.py
new file mode 100644
index 0000000..8d32030
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/mixer_music_test.py
@@ -0,0 +1,493 @@
+import os
+import sys
+import platform
+import unittest
+import time
+
+from pygame.tests.test_utils import example_path
+import pygame
+
+
+class MixerMusicModuleTest(unittest.TestCase):
+    @classmethod
+    def setUpClass(cls):
+        # Initializing the mixer is slow, so minimize the times it is called.
+        pygame.mixer.init()
+
+    @classmethod
+    def tearDownClass(cls):
+        pygame.mixer.quit()
+
+    def setUp(cls):
+        # This makes sure the mixer is always initialized before each test (in
+        # case a test calls pygame.mixer.quit()).
+        if pygame.mixer.get_init() is None:
+            pygame.mixer.init()
+
+    def test_load_mp3(self):
+        "|tags:music|"
+        self.music_load("mp3")
+
+    def test_load_ogg(self):
+        "|tags:music|"
+        self.music_load("ogg")
+
+    def test_load_wav(self):
+        "|tags:music|"
+        self.music_load("wav")
+
+    def music_load(self, format):
+        data_fname = example_path("data")
+
+        path = os.path.join(data_fname, f"house_lo.{format}")
+        if os.sep == "\\":
+            path = path.replace("\\", "\\\\")
+        umusfn = str(path)
+        bmusfn = umusfn.encode()
+
+        pygame.mixer.music.load(umusfn)
+        pygame.mixer.music.load(bmusfn)
+
+    def test_load_object(self):
+        """test loading music from file-like objects."""
+        formats = ["ogg", "wav"]
+        data_fname = example_path("data")
+        for f in formats:
+            path = os.path.join(data_fname, f"house_lo.{f}")
+            if os.sep == "\\":
+                path = path.replace("\\", "\\\\")
+            bmusfn = path.encode()
+
+            with open(bmusfn, "rb") as musf:
+                pygame.mixer.music.load(musf)
+
+    def test_object_namehint(self):
+        """test loading & queuing music from file-like objects with namehint argument."""
+        formats = ["wav", "ogg"]
+        data_fname = example_path("data")
+        for f in formats:
+            path = os.path.join(data_fname, f"house_lo.{f}")
+            if os.sep == "\\":
+                path = path.replace("\\", "\\\\")
+            bmusfn = path.encode()
+
+            # these two "with open" blocks need to be separate, which is kinda weird
+            with open(bmusfn, "rb") as musf:
+                pygame.mixer.music.load(musf, f)
+
+            with open(bmusfn, "rb") as musf:
+                pygame.mixer.music.queue(musf, f)
+
+            with open(bmusfn, "rb") as musf:
+                pygame.mixer.music.load(musf, namehint=f)
+
+            with open(bmusfn, "rb") as musf:
+                pygame.mixer.music.queue(musf, namehint=f)
+
+    def test_load_unicode(self):
+        """test non-ASCII unicode path"""
+        import shutil
+
+        ep = example_path("data")
+        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
+        import tempfile
+
+        ep = example_path("data")
+        org_file = os.path.join(ep, "house_lo.wav")
+        tmpfd, tmppath = tempfile.mkstemp(".wav")
+        os.close(tmpfd)
+        shutil.copy(org_file, tmppath)
+        try:
+            pygame.mixer.music.load(tmppath)
+            pygame.mixer.music.unload()
+        finally:
+            os.remove(tmppath)
+
+    def test_queue_mp3(self):
+        """Ensures queue() accepts mp3 files.
+
+        |tags:music|
+        """
+        filename = example_path(os.path.join("data", "house_lo.mp3"))
+        pygame.mixer.music.queue(filename)
+
+    def test_queue_ogg(self):
+        """Ensures queue() accepts ogg files.
+
+        |tags:music|
+        """
+        filename = example_path(os.path.join("data", "house_lo.ogg"))
+        pygame.mixer.music.queue(filename)
+
+    def test_queue_wav(self):
+        """Ensures queue() accepts wav files.
+
+        |tags:music|
+        """
+        filename = example_path(os.path.join("data", "house_lo.wav"))
+        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"))
+        wav_file = example_path(os.path.join("data", "house_lo.wav"))
+
+        pygame.mixer.music.queue(ogg_file)
+        pygame.mixer.music.queue(wav_file)
+
+    def test_queue__arguments(self):
+        """Ensures queue() can be called with proper arguments."""
+        wav_file = example_path(os.path.join("data", "house_lo.wav"))
+
+        pygame.mixer.music.queue(wav_file, loops=2)
+        pygame.mixer.music.queue(wav_file, namehint="")
+        pygame.mixer.music.queue(wav_file, "")
+        pygame.mixer.music.queue(wav_file, "", 2)
+
+    def test_queue__no_file(self):
+        """Ensures queue() correctly handles missing the file argument."""
+        with self.assertRaises(TypeError):
+            pygame.mixer.music.queue()
+
+    def test_queue__invalid_sound_type(self):
+        """Ensures queue() correctly handles invalid file types."""
+        not_a_sound_file = example_path(os.path.join("data", "city.png"))
+
+        with self.assertRaises(pygame.error):
+            pygame.mixer.music.queue(not_a_sound_file)
+
+    def test_queue__invalid_filename(self):
+        """Ensures queue() correctly handles invalid filenames."""
+        with self.assertRaises(pygame.error):
+            pygame.mixer.music.queue("")
+
+    def test_music_pause__unpause(self):
+        """Ensure music has the correct position immediately after unpausing
+
+        |tags:music|
+        """
+        filename = example_path(os.path.join("data", "house_lo.mp3"))
+        pygame.mixer.music.load(filename)
+        pygame.mixer.music.play()
+
+        # Wait 0.05s, then pause
+        time.sleep(0.05)
+        pygame.mixer.music.pause()
+        # Wait 0.05s, get position, unpause, then get position again
+        time.sleep(0.05)
+        before_unpause = pygame.mixer.music.get_pos()
+        pygame.mixer.music.unpause()
+        after_unpause = pygame.mixer.music.get_pos()
+
+        self.assertEqual(before_unpause, after_unpause)
+
+    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()
+
+        pygame.mixer.music.stop()
+        self.assertEqual(pygame.mixer.music.get_busy(), False)
+
+    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()
+
+        # 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:
+
+        # 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.
+        #
+
+        self.fail()
+
+    # def test_fadeout(self):
+    #     filename = example_path(os.path.join("data", "house_lo.mp3"))
+    #     pygame.mixer.music.load(filename)
+    #     pygame.mixer.music.play()
+
+    #     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",
+        'disk audio driver "playback" writing to disk is slow',
+    )
+    def test_play__start_time(self):
+        pygame.display.init()
+
+        # music file is 7 seconds long
+        filename = example_path(os.path.join("data", "house_lo.ogg"))
+        pygame.mixer.music.load(filename)
+        start_time_in_seconds = 6.0  # 6 seconds
+
+        music_finished = False
+        clock = pygame.time.Clock()
+        start_time_in_ms = clock.tick()
+        # should play the last 1 second
+        pygame.mixer.music.play(0, start=start_time_in_seconds)
+        running = True
+        while running:
+            pygame.event.pump()
+
+            if not (pygame.mixer.music.get_busy() or music_finished):
+                music_finished = True
+                time_to_finish = (clock.tick() - start_time_in_ms) // 1000
+                self.assertEqual(time_to_finish, 1)
+                running = False
+
+    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
+        # playing it will be restarted.
+        #
+        # The loops argument controls the number of repeats a music will play.
+        # play(5) will cause the music to played once, then repeated five
+        # times, for a total of six. If the loops is -1 then the music will
+        # repeat indefinitely.
+        #
+        # The starting position argument controls where in the music the song
+        # starts playing. The starting position is dependent on the format of
+        # music playing. MP3 and OGG use the position as time (in seconds).
+        # 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.assertTrue(pygame.mixer.music.get_busy())
+
+        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
+        # stream is already playing it will be stopped. This does not start
+        # the music playing.
+        #
+        # Music can only be loaded from filenames, not python file objects
+        # like the other pygame loading functions.
+        #
+
+        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())
+
+        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()
+
+        vol = pygame.mixer.music.get_volume()
+        self.assertGreaterEqual(vol, 0)
+        self.assertLessEqual(vol, 1)
+
+        pygame.mixer.music.stop()
+
+    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.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:
+
+        # Returns True when the music stream is actively playing. When the
+        # music is idle this returns False.
+        #
+
+        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_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.
+
+        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)
+
+        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()
+
+        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:
+
+        # 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. Newer versions of SDL_mixer have better
+        # positioning support than earlier. An SDLError is raised if a particular
+        # format does not support positioning.
+        #
+
+        self.fail()
+
+    def test_init(self):
+        """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")
+
+        for i in range(10):
+            pygame.mixer.init()
+            try:
+                shutil.copy2(testfile, tempcopy)
+                pygame.mixer.music.load(tempcopy)
+                pygame.mixer.quit()
+            finally:
+                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/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/mixer_tags.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/mixer_tags.py
new file mode 100644
index 0000000..06a9de2
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/mixer_tags.py
@@ -0,0 +1,7 @@
+__tags__ = []
+
+import pygame
+import sys
+
+if "pygame.mixer" not in sys.modules:
+    __tags__.extend(("ignore", "subprocess_ignore"))
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/mixer_test.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/mixer_test.py
new file mode 100644
index 0000000..0b11c5a
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/mixer_test.py
@@ -0,0 +1,1479 @@
+import sys
+import os
+import unittest
+import pathlib
+import platform
+import time
+from array import array
+
+from pygame.tests.test_utils import example_path
+
+import pygame
+from pygame import mixer
+
+IS_PYPY = "PyPy" == platform.python_implementation()
+
+################################### CONSTANTS ##################################
+
+FREQUENCIES = [11025, 22050, 44100, 48000]
+SIZES = [-16, -8, 8, 16]  # fixme
+# size 32 failed in test_get_init__returns_exact_values_used_for_init
+CHANNELS = [1, 2]
+BUFFERS = [3024]
+
+CONFIGS = [
+    {"frequency": f, "size": s, "channels": c}
+    for f in FREQUENCIES
+    for s in SIZES
+    for c in CHANNELS
+]
+# Using all CONFIGS fails on a Mac; probably older SDL_mixer; we could do:
+# if platform.system() == 'Darwin':
+# But using all CONFIGS is very slow (> 10 sec for example)
+# And probably, we don't need to be so exhaustive, hence:
+
+CONFIG = {"frequency": 44100, "size": 32, "channels": 2, "allowedchanges": 0}
+
+
+class InvalidBool:
+    """To help test invalid bool values."""
+
+    __bool__ = None
+
+
+############################## MODULE LEVEL TESTS #############################
+
+
+class MixerModuleTest(unittest.TestCase):
+    def tearDown(self):
+        mixer.quit()
+        mixer.pre_init(0, 0, 0, 0)
+
+    def test_init__keyword_args(self):
+        # note: this test used to loop over all CONFIGS, but it's very slow..
+        mixer.init(**CONFIG)
+        mixer_conf = mixer.get_init()
+
+        self.assertEqual(mixer_conf[0], CONFIG["frequency"])
+        # Not all "sizes" are supported on all systems,  hence "abs".
+        self.assertEqual(abs(mixer_conf[1]), abs(CONFIG["size"]))
+        self.assertGreaterEqual(mixer_conf[2], CONFIG["channels"])
+
+    def test_pre_init__keyword_args(self):
+        # note: this test used to loop over all CONFIGS, but it's very slow..
+        mixer.pre_init(**CONFIG)
+        mixer.init()
+
+        mixer_conf = mixer.get_init()
+
+        self.assertEqual(mixer_conf[0], CONFIG["frequency"])
+        # Not all "sizes" are supported on all systems,  hence "abs".
+        self.assertEqual(abs(mixer_conf[1]), abs(CONFIG["size"]))
+        self.assertGreaterEqual(mixer_conf[2], CONFIG["channels"])
+
+    def test_pre_init__zero_values(self):
+        # Ensure that argument values of 0 are replaced with
+        # default values. No way to check buffer size though.
+        mixer.pre_init(22050, -8, 1)  # Non default values
+        mixer.pre_init(0, 0, 0)  # Should reset to default values
+        mixer.init(allowedchanges=0)
+        self.assertEqual(mixer.get_init()[0], 44100)
+        self.assertEqual(mixer.get_init()[1], -16)
+        self.assertGreaterEqual(mixer.get_init()[2], 2)
+
+    def test_init__zero_values(self):
+        # Ensure that argument values of 0 are replaced with
+        # preset values. No way to check buffer size though.
+        mixer.pre_init(44100, 8, 1, allowedchanges=0)  # None default values
+        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)
+
+    #     # 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
+
+    #     for init_conf in CONFIGS:
+    #         frequency, size, channels = init_conf.values()
+    #         if (frequency, size) == (22050, 16):
+    #             continue
+    #         mixer.init(frequency, size, channels)
+
+    #         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())
+
+    def test_get_num_channels__defaults_eight_after_init(self):
+        mixer.init()
+        self.assertEqual(mixer.get_num_channels(), 8)
+
+    def test_set_num_channels(self):
+        mixer.init()
+
+        default_num_channels = mixer.get_num_channels()
+        for i in range(1, default_num_channels + 1):
+            mixer.set_num_channels(i)
+            self.assertEqual(mixer.get_num_channels(), i)
+
+    def test_quit(self):
+        """get_num_channels() Should throw pygame.error if uninitialized
+        after mixer.quit()"""
+        mixer.init()
+        mixer.quit()
+        self.assertRaises(pygame.error, mixer.get_num_channels)
+
+    # 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):
+            return snd.get_raw()
+
+        mixer.init()
+
+        sample = b"\x00\xff" * 24
+        wave_path = example_path(os.path.join("data", "house_lo.wav"))
+        uwave_path = str(wave_path)
+        bwave_path = uwave_path.encode(sys.getfilesystemencoding())
+        snd = mixer.Sound(file=wave_path)
+        self.assertTrue(snd.get_length() > 0.5)
+        snd_bytes = get_bytes(snd)
+        self.assertTrue(len(snd_bytes) > 1000)
+
+        self.assertEqual(get_bytes(mixer.Sound(wave_path)), snd_bytes)
+
+        self.assertEqual(get_bytes(mixer.Sound(file=uwave_path)), snd_bytes)
+        self.assertEqual(get_bytes(mixer.Sound(uwave_path)), snd_bytes)
+        arg_emsg = "Sound takes either 1 positional or 1 keyword argument"
+
+        with self.assertRaises(TypeError) as cm:
+            mixer.Sound()
+        self.assertEqual(str(cm.exception), arg_emsg)
+        with self.assertRaises(TypeError) as cm:
+            mixer.Sound(wave_path, buffer=sample)
+        self.assertEqual(str(cm.exception), arg_emsg)
+        with self.assertRaises(TypeError) as cm:
+            mixer.Sound(sample, file=wave_path)
+        self.assertEqual(str(cm.exception), arg_emsg)
+        with self.assertRaises(TypeError) as cm:
+            mixer.Sound(buffer=sample, file=wave_path)
+        self.assertEqual(str(cm.exception), arg_emsg)
+
+        with self.assertRaises(TypeError) as cm:
+            mixer.Sound(foobar=sample)
+        self.assertEqual(str(cm.exception), "Unrecognized keyword argument 'foobar'")
+
+        snd = mixer.Sound(wave_path, **{})
+        self.assertEqual(get_bytes(snd), snd_bytes)
+        snd = mixer.Sound(*[], **{"file": wave_path})
+
+        with self.assertRaises(TypeError) as cm:
+            mixer.Sound([])
+        self.assertEqual(str(cm.exception), "Unrecognized argument (type list)")
+
+        with self.assertRaises(TypeError) as cm:
+            snd = mixer.Sound(buffer=[])
+        emsg = "Expected object with buffer interface: got a list"
+        self.assertEqual(str(cm.exception), emsg)
+
+        ufake_path = "12345678"
+        self.assertRaises(IOError, mixer.Sound, ufake_path)
+        self.assertRaises(IOError, mixer.Sound, "12345678")
+
+        with self.assertRaises(TypeError) as cm:
+            mixer.Sound(buffer="something")
+        emsg = "Unicode object not allowed as buffer object"
+        self.assertEqual(str(cm.exception), emsg)
+        self.assertEqual(get_bytes(mixer.Sound(buffer=sample)), sample)
+        if type(sample) != str:
+            somebytes = get_bytes(mixer.Sound(sample))
+            # on python 2 we do not allow using string except as file name.
+            self.assertEqual(somebytes, sample)
+        self.assertEqual(get_bytes(mixer.Sound(file=bwave_path)), snd_bytes)
+        self.assertEqual(get_bytes(mixer.Sound(bwave_path)), snd_bytes)
+
+        snd = mixer.Sound(wave_path)
+        with self.assertRaises(TypeError) as cm:
+            mixer.Sound(wave_path, array=snd)
+        self.assertEqual(str(cm.exception), arg_emsg)
+        with self.assertRaises(TypeError) as cm:
+            mixer.Sound(buffer=sample, array=snd)
+        self.assertEqual(str(cm.exception), arg_emsg)
+        snd2 = mixer.Sound(array=snd)
+        self.assertEqual(snd.get_raw(), snd2.get_raw())
+
+    def test_sound_unicode(self):
+        """test non-ASCII unicode path"""
+        mixer.init()
+        import shutil
+
+        ep = example_path("data")
+        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",
+        "this test fails without real sound card",
+    )
+    def test_array_keyword(self):
+        try:
+            from numpy import (
+                array,
+                arange,
+                zeros,
+                int8,
+                uint8,
+                int16,
+                uint16,
+                int32,
+                uint32,
+            )
+        except ImportError:
+            self.skipTest("requires numpy")
+
+        freq = 22050
+        format_list = [-8, 8, -16, 16]
+        channels_list = [1, 2]
+
+        a_lists = {f: [] for f in format_list}
+        a32u_mono = arange(0, 256, 1, uint32)
+        a16u_mono = a32u_mono.astype(uint16)
+        a8u_mono = a32u_mono.astype(uint8)
+        au_list_mono = [(1, a) for a in [a8u_mono, a16u_mono, a32u_mono]]
+        for format in format_list:
+            if format > 0:
+                a_lists[format].extend(au_list_mono)
+        a32s_mono = arange(-128, 128, 1, int32)
+        a16s_mono = a32s_mono.astype(int16)
+        a8s_mono = a32s_mono.astype(int8)
+        as_list_mono = [(1, a) for a in [a8s_mono, a16s_mono, a32s_mono]]
+        for format in format_list:
+            if format < 0:
+                a_lists[format].extend(as_list_mono)
+        a32u_stereo = zeros([a32u_mono.shape[0], 2], uint32)
+        a32u_stereo[:, 0] = a32u_mono
+        a32u_stereo[:, 1] = 255 - a32u_mono
+        a16u_stereo = a32u_stereo.astype(uint16)
+        a8u_stereo = a32u_stereo.astype(uint8)
+        au_list_stereo = [(2, a) for a in [a8u_stereo, a16u_stereo, a32u_stereo]]
+        for format in format_list:
+            if format > 0:
+                a_lists[format].extend(au_list_stereo)
+        a32s_stereo = zeros([a32s_mono.shape[0], 2], int32)
+        a32s_stereo[:, 0] = a32s_mono
+        a32s_stereo[:, 1] = -1 - a32s_mono
+        a16s_stereo = a32s_stereo.astype(int16)
+        a8s_stereo = a32s_stereo.astype(int8)
+        as_list_stereo = [(2, a) for a in [a8s_stereo, a16s_stereo, a32s_stereo]]
+        for format in format_list:
+            if format < 0:
+                a_lists[format].extend(as_list_stereo)
+
+        for format in format_list:
+            for channels in channels_list:
+                try:
+                    mixer.init(freq, format, channels)
+                except pygame.error:
+                    # Some formats (e.g. 16) may not be supported.
+                    continue
+                try:
+                    __, f, c = mixer.get_init()
+                    if f != format or c != channels:
+                        # Some formats (e.g. -8) may not be supported.
+                        continue
+                    for c, a in a_lists[format]:
+                        self._test_array_argument(format, a, c == channels)
+                finally:
+                    mixer.quit()
+
+    def _test_array_argument(self, format, a, test_pass):
+        from numpy import array, all as all_
+
+        try:
+            snd = mixer.Sound(array=a)
+        except ValueError:
+            if not test_pass:
+                return
+            self.fail("Raised ValueError: Format %i, dtype %s" % (format, a.dtype))
+        if not test_pass:
+            self.fail(
+                "Did not raise ValueError: Format %i, dtype %s" % (format, a.dtype)
+            )
+        a2 = array(snd)
+        a3 = a.astype(a2.dtype)
+        lshift = abs(format) - 8 * a.itemsize
+        if lshift >= 0:
+            # This is asymmetric with respect to downcasting.
+            a3 <<= lshift
+        self.assertTrue(all_(a2 == a3), "Format %i, dtype %s" % (format, a.dtype))
+
+    def _test_array_interface_fail(self, a):
+        self.assertRaises(ValueError, mixer.Sound, array=a)
+
+    def test_array_interface(self):
+        mixer.init(22050, -16, 1, allowedchanges=0)
+        snd = mixer.Sound(buffer=b"\x00\x7f" * 20)
+        d = snd.__array_interface__
+        self.assertTrue(isinstance(d, dict))
+        if pygame.get_sdl_byteorder() == pygame.LIL_ENDIAN:
+            typestr = "") if is_lil_endian else (">", "<")
+        shape = (10, channels)[:ndim]
+        strides = (channels * itemsize, itemsize)[2 - ndim :]
+        exp = Exporter(shape, format=frev + "i")
+        snd = mixer.Sound(array=exp)
+        buflen = len(exp) * itemsize * channels
+        imp = Importer(snd, buftools.PyBUF_SIMPLE)
+        self.assertEqual(imp.ndim, 0)
+        self.assertTrue(imp.format is None)
+        self.assertEqual(imp.len, buflen)
+        self.assertEqual(imp.itemsize, itemsize)
+        self.assertTrue(imp.shape is None)
+        self.assertTrue(imp.strides is None)
+        self.assertTrue(imp.suboffsets is None)
+        self.assertFalse(imp.readonly)
+        self.assertEqual(imp.buf, snd._samples_address)
+        imp = Importer(snd, buftools.PyBUF_WRITABLE)
+        self.assertEqual(imp.ndim, 0)
+        self.assertTrue(imp.format is None)
+        self.assertEqual(imp.len, buflen)
+        self.assertEqual(imp.itemsize, itemsize)
+        self.assertTrue(imp.shape is None)
+        self.assertTrue(imp.strides is None)
+        self.assertTrue(imp.suboffsets is None)
+        self.assertFalse(imp.readonly)
+        self.assertEqual(imp.buf, snd._samples_address)
+        imp = Importer(snd, buftools.PyBUF_FORMAT)
+        self.assertEqual(imp.ndim, 0)
+        self.assertEqual(imp.format, format)
+        self.assertEqual(imp.len, buflen)
+        self.assertEqual(imp.itemsize, itemsize)
+        self.assertTrue(imp.shape is None)
+        self.assertTrue(imp.strides is None)
+        self.assertTrue(imp.suboffsets is None)
+        self.assertFalse(imp.readonly)
+        self.assertEqual(imp.buf, snd._samples_address)
+        imp = Importer(snd, buftools.PyBUF_ND)
+        self.assertEqual(imp.ndim, ndim)
+        self.assertTrue(imp.format is None)
+        self.assertEqual(imp.len, buflen)
+        self.assertEqual(imp.itemsize, itemsize)
+        self.assertEqual(imp.shape, shape)
+        self.assertTrue(imp.strides is None)
+        self.assertTrue(imp.suboffsets is None)
+        self.assertFalse(imp.readonly)
+        self.assertEqual(imp.buf, snd._samples_address)
+        imp = Importer(snd, buftools.PyBUF_STRIDES)
+        self.assertEqual(imp.ndim, ndim)
+        self.assertTrue(imp.format is None)
+        self.assertEqual(imp.len, buflen)
+        self.assertEqual(imp.itemsize, itemsize)
+        self.assertEqual(imp.shape, shape)
+        self.assertEqual(imp.strides, strides)
+        self.assertTrue(imp.suboffsets is None)
+        self.assertFalse(imp.readonly)
+        self.assertEqual(imp.buf, snd._samples_address)
+        imp = Importer(snd, buftools.PyBUF_FULL_RO)
+        self.assertEqual(imp.ndim, ndim)
+        self.assertEqual(imp.format, format)
+        self.assertEqual(imp.len, buflen)
+        self.assertEqual(imp.itemsize, 2)
+        self.assertEqual(imp.shape, shape)
+        self.assertEqual(imp.strides, strides)
+        self.assertTrue(imp.suboffsets is None)
+        self.assertFalse(imp.readonly)
+        self.assertEqual(imp.buf, snd._samples_address)
+        imp = Importer(snd, buftools.PyBUF_FULL_RO)
+        self.assertEqual(imp.ndim, ndim)
+        self.assertEqual(imp.format, format)
+        self.assertEqual(imp.len, buflen)
+        self.assertEqual(imp.itemsize, itemsize)
+        self.assertEqual(imp.shape, exp.shape)
+        self.assertEqual(imp.strides, strides)
+        self.assertTrue(imp.suboffsets is None)
+        self.assertFalse(imp.readonly)
+        self.assertEqual(imp.buf, snd._samples_address)
+        imp = Importer(snd, buftools.PyBUF_C_CONTIGUOUS)
+        self.assertEqual(imp.ndim, ndim)
+        self.assertTrue(imp.format is None)
+        self.assertEqual(imp.strides, strides)
+        imp = Importer(snd, buftools.PyBUF_ANY_CONTIGUOUS)
+        self.assertEqual(imp.ndim, ndim)
+        self.assertTrue(imp.format is None)
+        self.assertEqual(imp.strides, strides)
+        if ndim == 1:
+            imp = Importer(snd, buftools.PyBUF_F_CONTIGUOUS)
+            self.assertEqual(imp.ndim, 1)
+            self.assertTrue(imp.format is None)
+            self.assertEqual(imp.strides, strides)
+        else:
+            self.assertRaises(BufferError, Importer, snd, buftools.PyBUF_F_CONTIGUOUS)
+
+    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)
+
+        # 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:
+
+        # pygame.mixer.find_channel(force=False): return Channel
+        # find an unused channel
+        mixer.init()
+
+        filename = example_path(os.path.join("data", "house_lo.wav"))
+        sound = mixer.Sound(file=filename)
+
+        num_channels = mixer.get_num_channels()
+
+        if num_channels > 0:
+            found_channel = mixer.find_channel()
+            self.assertIsNotNone(found_channel)
+
+            # try playing on all channels
+            channels = []
+            for channel_id in range(0, num_channels):
+                channel = mixer.Channel(channel_id)
+                channel.play(sound)
+                channels.append(channel)
+
+            # should fail without being forceful
+            found_channel = mixer.find_channel()
+            self.assertIsNone(found_channel)
+
+            # try forcing without keyword
+            found_channel = mixer.find_channel(True)
+            self.assertIsNotNone(found_channel)
+
+            # try forcing with keyword
+            found_channel = mixer.find_channel(force=True)
+            self.assertIsNotNone(found_channel)
+
+            for channel in channels:
+                channel.stop()
+            found_channel = mixer.find_channel()
+            self.assertIsNotNone(found_channel)
+
+    @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)
+
+        mixer.pause()
+
+        # TODO: this currently fails?
+        # Ensure the channel is paused
+        self.assertFalse(channel.get_busy())
+
+        mixer.unpause()
+
+        # Ensure the channel is no longer paused
+        self.assertTrue(channel.get_busy())
+
+    def test_set_reserved(self):
+        """Ensure pygame.mixer.set_reserved() reserves the given number of channels."""
+
+        # pygame.mixer.set_reserved(count): return count
+        mixer.init()
+        default_num_channels = mixer.get_num_channels()
+
+        # try reserving all the channels
+        result = mixer.set_reserved(default_num_channels)
+        self.assertEqual(result, default_num_channels)
+
+        # try reserving all the channels + 1
+        result = mixer.set_reserved(default_num_channels + 1)
+        # should still be default
+        self.assertEqual(result, default_num_channels)
+
+        # try unreserving all
+        result = mixer.set_reserved(0)
+        # should still be default
+        self.assertEqual(result, 0)
+
+        # try reserving half
+        result = mixer.set_reserved(int(default_num_channels / 2))
+        # should still be default
+        self.assertEqual(result, int(default_num_channels / 2))
+
+    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."""
+        expected_length = 3
+        expected_type = tuple
+        expected_item_type = int
+
+        version = pygame.mixer.get_sdl_mixer_version()
+
+        self.assertIsInstance(version, expected_type)
+        self.assertEqual(len(version), expected_length)
+
+        for item in version:
+            self.assertIsInstance(item, expected_item_type)
+
+    def test_get_sdl_mixer_version__args(self):
+        """Ensures get_sdl_mixer_version works correctly using args."""
+        expected_length = 3
+        expected_type = tuple
+        expected_item_type = int
+
+        for value in (True, False):
+            version = pygame.mixer.get_sdl_mixer_version(value)
+
+            self.assertIsInstance(version, expected_type)
+            self.assertEqual(len(version), expected_length)
+
+            for item in version:
+                self.assertIsInstance(item, expected_item_type)
+
+    def test_get_sdl_mixer_version__kwargs(self):
+        """Ensures get_sdl_mixer_version works correctly using kwargs."""
+        expected_length = 3
+        expected_type = tuple
+        expected_item_type = int
+
+        for value in (True, False):
+            version = pygame.mixer.get_sdl_mixer_version(linked=value)
+
+            self.assertIsInstance(version, expected_type)
+            self.assertEqual(len(version), expected_length)
+
+            for item in version:
+                self.assertIsInstance(item, expected_item_type)
+
+    def test_get_sdl_mixer_version__invalid_args_kwargs(self):
+        """Ensures get_sdl_mixer_version handles invalid args and kwargs."""
+        invalid_bool = InvalidBool()
+
+        with self.assertRaises(TypeError):
+            version = pygame.mixer.get_sdl_mixer_version(invalid_bool)
+
+        with self.assertRaises(TypeError):
+            version = pygame.mixer.get_sdl_mixer_version(linked=invalid_bool)
+
+    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)
+        complied_version = pygame.mixer.get_sdl_mixer_version(linked=False)
+
+        self.assertTupleEqual(linked_version, complied_version)
+
+
+############################## CHANNEL CLASS TESTS #############################
+
+
+class ChannelTypeTest(unittest.TestCase):
+    @classmethod
+    def setUpClass(cls):
+        # Initializing the mixer is slow, so minimize the times it is called.
+        mixer.init()
+
+    @classmethod
+    def tearDownClass(cls):
+        mixer.quit()
+
+    def setUp(cls):
+        # This makes sure the mixer is always initialized before each test (in
+        # case a test calls pygame.mixer.quit()).
+        if mixer.get_init() is None:
+            mixer.init()
+
+    def test_channel(self):
+        """Ensure Channel() creation works."""
+        channel = mixer.Channel(0)
+
+        self.assertIsInstance(channel, mixer.ChannelType)
+        self.assertEqual(channel.__class__.__name__, "Channel")
+
+    def test_channel__without_arg(self):
+        """Ensure exception for Channel() creation with no argument."""
+        with self.assertRaises(TypeError):
+            mixer.Channel()
+
+    def test_channel__invalid_id(self):
+        """Ensure exception for Channel() creation with an invalid id."""
+        with self.assertRaises(IndexError):
+            mixer.Channel(-1)
+
+    def test_channel__before_init(self):
+        """Ensure exception for Channel() creation with non-init mixer."""
+        mixer.quit()
+
+        with self.assertRaisesRegex(pygame.error, "mixer not initialized"):
+            mixer.Channel(0)
+
+    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)
+
+        fadeout_time = 1000
+        channel.fadeout(fadeout_time)
+
+        # 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."""
+        expected_busy = False
+        channel = mixer.Channel(0)
+
+        busy = channel.get_busy()
+
+        self.assertEqual(busy, expected_busy)
+
+    def test_get_busy__active(self):
+        """Ensure an active channel's busy state is correct."""
+        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:
+
+        # Channel.get_endevent(): return type
+        # get the event a channel sends when playback stops
+        #
+        # Returns the event type to be sent every time the Channel finishes
+        # playback of a Sound. If there is no endevent the function returns
+        # pygame.NOEVENT.
+        #
+
+        self.fail()
+
+    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.play(sound1)
+        channel.queue(sound2)
+
+        # Ensure the second queued sound is returned.
+        self.assertEqual(channel.get_queue().get_length(), sound2.get_length())
+
+        pygame.time.wait(sound_length_in_ms + 100)
+        self.assertIsNone(channel.get_queue())
+
+        # 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)
+
+        # 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."""
+        expected_volume = 1.0  # default
+        channel = mixer.Channel(0)
+
+        volume = channel.get_volume()
+
+        self.assertAlmostEqual(volume, expected_volume)
+
+    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 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()
+
+        with self.assertRaisesRegex(pygame.error, "mixer not initialized"):
+            channel.pause()
+
+        with self.assertRaisesRegex(pygame.error, "mixer not initialized"):
+            channel.unpause()
+
+    def test_queue(self):
+        """
+        Ensure the Channel.queue() works correctly
+        """
+        if os.environ.get("PYGAME_MSYS2") == "1":
+            self.skipTest("Skip test on MSYS2")
+
+        # 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)))
+
+        # 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())
+
+        pygame.time.wait(sound_length_in_ms_2 + 100)
+
+        # Test when no sound playing
+        channel.queue(sound1)
+        self.assertTrue(channel.get_busy())
+        self.assertEqual(channel.get_sound(), sound1)
+
+        pygame.time.wait(sound_length_in_ms + 100)
+
+        # 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())
+
+        pygame.time.wait(sound_length_in_ms_3 + 100)
+        self.assertFalse(channel.get_busy())
+
+        # 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())
+
+        # 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)
+
+    def test_stop(self):
+        # __doc__ (as of 2008-08-02) for pygame.mixer.Channel.stop:
+
+        # Channel.stop(): return None
+        # stop playback on a Channel
+        #
+        # Stop sound playback on a channel. After playback is stopped the
+        # channel becomes available for new Sounds to play on it.
+        #
+
+        channel = mixer.Channel(0)
+        sound = mixer.Sound(example_path("data/house_lo.wav"))
+
+        # 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 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()
+
+    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):
+        pygame.display.init()
+        pygame.display.set_mode((40, 40))
+        if mixer.get_init() is None:
+            mixer.init()
+
+    def tearDown(self):
+        pygame.display.quit()
+        mixer.quit()
+
+    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)
+
+        # 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):
+        mixer.quit()
+
+    def setUp(cls):
+        # This makes sure the mixer is always initialized before each test (in
+        # case a test calls pygame.mixer.quit()).
+        if mixer.get_init() is None:
+            mixer.init()
+
+    # See MixerModuleTest's methods test_sound_args(), test_sound_unicode(),
+    # and test_array_keyword() for additional testing of Sound() creation.
+    def test_sound(self):
+        """Ensure Sound() creation with a filename works."""
+        filename = example_path(os.path.join("data", "house_lo.wav"))
+        sound1 = mixer.Sound(filename)
+        sound2 = mixer.Sound(file=filename)
+
+        self.assertIsInstance(sound1, mixer.Sound)
+        self.assertIsInstance(sound2, mixer.Sound)
+
+    def test_sound__from_file_object(self):
+        """Ensure Sound() creation with a file object works."""
+        filename = example_path(os.path.join("data", "house_lo.wav"))
+
+        # Using 'with' ensures the file is closed even if test fails.
+        with open(filename, "rb") as file_obj:
+            sound = mixer.Sound(file_obj)
+
+            self.assertIsInstance(sound, mixer.Sound)
+
+    def test_sound__from_sound_object(self):
+        """Ensure Sound() creation with a Sound() object works."""
+        filename = example_path(os.path.join("data", "house_lo.wav"))
+        sound_obj = mixer.Sound(file=filename)
+
+        sound = mixer.Sound(sound_obj)
+
+        self.assertIsInstance(sound, mixer.Sound)
+
+    def test_sound__from_pathlib(self):
+        """Ensure Sound() creation with a pathlib.Path object works."""
+        path = pathlib.Path(example_path(os.path.join("data", "house_lo.wav")))
+        sound1 = mixer.Sound(path)
+        sound2 = mixer.Sound(file=path)
+        self.assertIsInstance(sound1, mixer.Sound)
+        self.assertIsInstance(sound2, mixer.Sound)
+
+    def todo_test_sound__from_buffer(self):
+        """Ensure Sound() creation with a buffer works."""
+        self.fail()
+
+    def test_sound__from_array(self):
+        """Ensure Sound() creation with an array works."""
+        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."""
+        with self.assertRaises(TypeError):
+            mixer.Sound()
+
+    def test_sound__before_init(self):
+        """Ensure exception raised for Sound() creation with non-init mixer."""
+        mixer.quit()
+        filename = example_path(os.path.join("data", "house_lo.wav"))
+
+        with self.assertRaisesRegex(pygame.error, "mixer not initialized"):
+            mixer.Sound(file=filename)
+
+    @unittest.skipIf(IS_PYPY, "pypy skip")
+    def test_samples_address(self):
+        """Test the _samples_address getter."""
+        try:
+            from ctypes import pythonapi, c_void_p, py_object
+
+            Bytes_FromString = pythonapi.PyBytes_FromString
+
+            Bytes_FromString.restype = c_void_p
+            Bytes_FromString.argtypes = [py_object]
+            samples = b"abcdefgh"  # keep byte size a multiple of 4
+            sample_bytes = Bytes_FromString(samples)
+
+            snd = mixer.Sound(buffer=samples)
+
+            self.assertNotEqual(snd._samples_address, sample_bytes)
+        finally:
+            pygame.mixer.quit()
+            with self.assertRaisesRegex(pygame.error, "mixer not initialized"):
+                snd._samples_address
+
+    def test_get_length(self):
+        """Tests if get_length returns a correct length."""
+        try:
+            for size in SIZES:
+                pygame.mixer.quit()
+                pygame.mixer.init(size=size)
+                filename = example_path(os.path.join("data", "punch.wav"))
+                sound = mixer.Sound(file=filename)
+                # The sound data is in the mixer output format. So dividing the
+                # length of the raw sound data by the mixer settings gives
+                # the expected length of the sound.
+                sound_bytes = sound.get_raw()
+                mix_freq, mix_bits, mix_channels = pygame.mixer.get_init()
+                mix_bytes = abs(mix_bits) / 8
+                expected_length = (
+                    float(len(sound_bytes)) / mix_freq / mix_bytes / mix_channels
+                )
+                self.assertAlmostEqual(expected_length, sound.get_length())
+        finally:
+            pygame.mixer.quit()
+            with self.assertRaisesRegex(pygame.error, "mixer not initialized"):
+                sound.get_length()
+
+    def test_get_num_channels(self):
+        """
+        Tests if Sound.get_num_channels returns the correct number
+        of channels playing a specific sound.
+        """
+        try:
+            filename = example_path(os.path.join("data", "house_lo.wav"))
+            sound = mixer.Sound(file=filename)
+
+            self.assertEqual(sound.get_num_channels(), 0)
+            sound.play()
+            self.assertEqual(sound.get_num_channels(), 1)
+            sound.play()
+            self.assertEqual(sound.get_num_channels(), 2)
+            sound.stop()
+            self.assertEqual(sound.get_num_channels(), 0)
+        finally:
+            pygame.mixer.quit()
+            with self.assertRaisesRegex(pygame.error, "mixer not initialized"):
+                sound.get_num_channels()
+
+    def test_get_volume(self):
+        """Ensure a sound's volume can be retrieved."""
+        try:
+            expected_volume = 1.0  # default
+            filename = example_path(os.path.join("data", "house_lo.wav"))
+            sound = mixer.Sound(file=filename)
+
+            volume = sound.get_volume()
+
+            self.assertAlmostEqual(volume, expected_volume)
+        finally:
+            pygame.mixer.quit()
+            with self.assertRaisesRegex(pygame.error, "mixer not initialized"):
+                sound.get_volume()
+
+    def test_get_volume__while_playing(self):
+        """Ensure a sound's volume can be retrieved while playing."""
+        try:
+            expected_volume = 1.0  # default
+            filename = example_path(os.path.join("data", "house_lo.wav"))
+            sound = mixer.Sound(file=filename)
+            sound.play(-1)
+
+            volume = sound.get_volume()
+
+            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."""
+        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),
+            )
+
+            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_set_volume__while_playing(self):
+        """Ensure a sound's volume can be set while playing."""
+        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."""
+        try:
+            expected_channels = 0
+            filename = example_path(os.path.join("data", "house_lo.wav"))
+            sound = mixer.Sound(file=filename)
+
+            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_stop__while_playing(self):
+        """Ensure stop stops a playing sound."""
+        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."""
+        try:
+            samples = b"abcdefgh"  # keep byte size a multiple of 4
+            snd = mixer.Sound(buffer=samples)
+
+            raw = snd.get_raw()
+
+            self.assertIsInstance(raw, bytes)
+            self.assertEqual(raw, samples)
+        finally:
+            pygame.mixer.quit()
+            with self.assertRaisesRegex(pygame.error, "mixer not initialized"):
+                snd.get_raw()
+
+    def test_correct_subclassing(self):
+        class CorrectSublass(mixer.Sound):
+            def __init__(self, file):
+                super().__init__(file=file)
+
+        filename = example_path(os.path.join("data", "house_lo.wav"))
+        correct = CorrectSublass(filename)
+
+        try:
+            correct.get_volume()
+        except Exception:
+            self.fail("This should not raise an exception.")
+
+    def test_incorrect_subclassing(self):
+        class IncorrectSuclass(mixer.Sound):
+            def __init__(self):
+                pass
+
+        incorrect = IncorrectSuclass()
+
+        self.assertRaises(RuntimeError, incorrect.get_volume)
+
+
+class TestSoundFadeout(unittest.TestCase):
+    def setUp(self):
+        if mixer.get_init() is None:
+            pygame.mixer.init()
+
+    def tearDown(self):
+        pygame.mixer.quit()
+
+    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())
+
+    # 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())
+
+    # 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())
+
+    # 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())
+
+
+class TestGetBusy(unittest.TestCase):
+    """Test pygame.mixer.get_busy.
+
+    |tags:slow|
+    """
+
+    def setUp(self):
+        pygame.mixer.init()
+
+    def tearDown(self):
+        pygame.mixer.quit()
+
+    def test_no_sound_playing(self):
+        """
+        Test that get_busy returns False when no sound is playing.
+        """
+        self.assertFalse(pygame.mixer.get_busy())
+
+    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()
+
+    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 #####################################
+
+if __name__ == "__main__":
+    unittest.main()
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/mouse_test.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/mouse_test.py
new file mode 100644
index 0000000..53eac3a
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/mouse_test.py
@@ -0,0 +1,348 @@
+import unittest
+import os
+import platform
+import warnings
+import pygame
+
+
+DARWIN = "Darwin" in platform.platform()
+
+
+class MouseTests(unittest.TestCase):
+    @classmethod
+    def setUpClass(cls):
+        # The display needs to be initialized for mouse functions.
+        pygame.display.init()
+
+    @classmethod
+    def tearDownClass(cls):
+        pygame.display.quit()
+
+
+class MouseModuleInteractiveTest(MouseTests):
+    __tags__ = ["interactive"]
+
+    def test_set_pos(self):
+        """Ensures set_pos works correctly.
+        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.
+
+        if not pygame.mouse.get_focused():
+            # The window needs to be focused for the mouse.set_pos to work on macos.
+            return
+        clock = pygame.time.Clock()
+
+        expected_pos = ((10, 0), (0, 0), (499, 0), (499, 499), (341, 143), (94, 49))
+
+        for x, y in expected_pos:
+            pygame.mouse.set_pos(x, y)
+            pygame.event.get()
+            found_pos = pygame.mouse.get_pos()
+
+            clock.tick()
+            time_passed = 0.0
+            ready_to_test = False
+
+            while not ready_to_test and time_passed <= 1000.0:  # Avoid endless loop
+                time_passed += clock.tick()
+                for event in pygame.event.get():
+                    if event.type == pygame.MOUSEMOTION:
+                        ready_to_test = True
+
+            self.assertEqual(found_pos, (x, y))
+
+
+class MouseModuleTest(MouseTests):
+    @unittest.skipIf(
+        os.environ.get("SDL_VIDEODRIVER", "") == "dummy",
+        "Cursors not supported on headless test machines",
+    )
+    def test_get_cursor(self):
+        """Ensures get_cursor works correctly."""
+
+        # error should be raised when the display is uninitialized
+        with self.assertRaises(pygame.error):
+            pygame.display.quit()
+            pygame.mouse.get_cursor()
+
+        pygame.display.init()
+
+        size = (8, 8)
+        hotspot = (0, 0)
+        xormask = (0, 96, 120, 126, 112, 96, 0, 0)
+        andmask = (224, 240, 254, 255, 254, 240, 96, 0)
+
+        expected_length = 4
+        expected_cursor = pygame.cursors.Cursor(size, hotspot, xormask, andmask)
+        pygame.mouse.set_cursor(expected_cursor)
+
+        try:
+            cursor = pygame.mouse.get_cursor()
+
+            self.assertIsInstance(cursor, pygame.cursors.Cursor)
+            self.assertEqual(len(cursor), expected_length)
+
+            for info in cursor:
+                self.assertIsInstance(info, tuple)
+
+            pygame.mouse.set_cursor(size, hotspot, xormask, andmask)
+            self.assertEqual(pygame.mouse.get_cursor(), expected_cursor)
+
+        # SDLError should be raised when the mouse cursor is NULL
+        except pygame.error:
+            with self.assertRaises(pygame.error):
+                pygame.mouse.get_cursor()
+
+    @unittest.skipIf(
+        os.environ.get("SDL_VIDEODRIVER", "") == "dummy",
+        "mouse.set_system_cursor only available in SDL2",
+    )
+    def test_set_system_cursor(self):
+        """Ensures set_system_cursor works correctly."""
+
+        with warnings.catch_warnings(record=True) as w:
+            """From Pygame 2.0.1, set_system_cursor() should raise a deprecation warning"""
+            # Cause all warnings to always be triggered.
+            warnings.simplefilter("always")
+
+            # Error should be raised when the display is uninitialized
+            with self.assertRaises(pygame.error):
+                pygame.display.quit()
+                pygame.mouse.set_system_cursor(pygame.SYSTEM_CURSOR_HAND)
+
+            pygame.display.init()
+
+            # TypeError raised when PyArg_ParseTuple fails to parse parameters
+            with self.assertRaises(TypeError):
+                pygame.mouse.set_system_cursor("b")
+            with self.assertRaises(TypeError):
+                pygame.mouse.set_system_cursor(None)
+            with self.assertRaises(TypeError):
+                pygame.mouse.set_system_cursor((8, 8), (0, 0))
+
+            # Right type, invalid value
+            with self.assertRaises(pygame.error):
+                pygame.mouse.set_system_cursor(2000)
+
+            # Working as intended
+            self.assertEqual(
+                pygame.mouse.set_system_cursor(pygame.SYSTEM_CURSOR_ARROW), None
+            )
+
+            # Making sure the warnings are working properly
+            self.assertEqual(len(w), 6)
+            self.assertTrue(
+                all(issubclass(warn.category, DeprecationWarning) for warn in w)
+            )
+
+    @unittest.skipIf(
+        os.environ.get("SDL_VIDEODRIVER", "") == "dummy",
+        "Cursors not supported on headless test machines",
+    )
+    def test_set_cursor(self):
+        """Ensures set_cursor works correctly."""
+
+        # Bitmap cursor information
+        size = (8, 8)
+        hotspot = (0, 0)
+        xormask = (0, 126, 64, 64, 32, 16, 0, 0)
+        andmask = (254, 255, 254, 112, 56, 28, 12, 0)
+        bitmap_cursor = pygame.cursors.Cursor(size, hotspot, xormask, andmask)
+
+        # System cursor information
+        constant = pygame.SYSTEM_CURSOR_ARROW
+        system_cursor = pygame.cursors.Cursor(constant)
+
+        # Color cursor information (also uses hotspot variable from Bitmap cursor info)
+        surface = pygame.Surface((10, 10))
+        color_cursor = pygame.cursors.Cursor(hotspot, surface)
+
+        pygame.display.quit()
+
+        # Bitmap: Error should be raised when the display is uninitialized
+        with self.assertRaises(pygame.error):
+            pygame.mouse.set_cursor(bitmap_cursor)
+
+        # System: Error should be raised when the display is uninitialized
+        with self.assertRaises(pygame.error):
+            pygame.mouse.set_cursor(system_cursor)
+
+        # Color: Error should be raised when the display is uninitialized
+        with self.assertRaises(pygame.error):
+            pygame.mouse.set_cursor(color_cursor)
+
+        pygame.display.init()
+
+        # Bitmap: TypeError raised when PyArg_ParseTuple fails to parse parameters
+        with self.assertRaises(TypeError):
+            pygame.mouse.set_cursor(("w", "h"), hotspot, xormask, andmask)
+        with self.assertRaises(TypeError):
+            pygame.mouse.set_cursor(size, ("0", "0"), xormask, andmask)
+        with self.assertRaises(TypeError):
+            pygame.mouse.set_cursor(size, ("x", "y", "z"), xormask, andmask)
+
+        # Bitmap: TypeError raised when either mask is not a sequence
+        with self.assertRaises(TypeError):
+            pygame.mouse.set_cursor(size, hotspot, 12345678, andmask)
+        with self.assertRaises(TypeError):
+            pygame.mouse.set_cursor(size, hotspot, xormask, 12345678)
+
+        # Bitmap: TypeError raised when element of mask is not an integer
+        with self.assertRaises(TypeError):
+            pygame.mouse.set_cursor(size, hotspot, "00000000", andmask)
+        with self.assertRaises(TypeError):
+            pygame.mouse.set_cursor(size, hotspot, xormask, (2, [0], 4, 0, 0, 8, 0, 1))
+
+        # Bitmap: ValueError raised when width not divisible by 8
+        with self.assertRaises(ValueError):
+            pygame.mouse.set_cursor((3, 8), hotspot, xormask, andmask)
+
+        # Bitmap: ValueError raised when length of either mask != width * height / 8
+        with self.assertRaises(ValueError):
+            pygame.mouse.set_cursor((16, 2), hotspot, (128, 64, 32), andmask)
+        with self.assertRaises(ValueError):
+            pygame.mouse.set_cursor((16, 2), hotspot, xormask, (192, 96, 48, 0, 1))
+
+        # Bitmap: Working as intended
+        self.assertEqual(
+            pygame.mouse.set_cursor((16, 1), hotspot, (8, 0), (0, 192)), None
+        )
+        pygame.mouse.set_cursor(size, hotspot, xormask, andmask)
+        self.assertEqual(pygame.mouse.get_cursor(), bitmap_cursor)
+
+        # Bitmap: Working as intended + lists + masks with no references
+        pygame.mouse.set_cursor(size, hotspot, list(xormask), list(andmask))
+        self.assertEqual(pygame.mouse.get_cursor(), bitmap_cursor)
+
+        # System: TypeError raised when constant is invalid
+        with self.assertRaises(TypeError):
+            pygame.mouse.set_cursor(-50021232)
+        with self.assertRaises(TypeError):
+            pygame.mouse.set_cursor("yellow")
+
+        # System: Working as intended
+        self.assertEqual(pygame.mouse.set_cursor(constant), None)
+        pygame.mouse.set_cursor(constant)
+        self.assertEqual(pygame.mouse.get_cursor(), system_cursor)
+        pygame.mouse.set_cursor(system_cursor)
+        self.assertEqual(pygame.mouse.get_cursor(), system_cursor)
+
+        # Color: TypeError raised with invalid parameters
+        with self.assertRaises(TypeError):
+            pygame.mouse.set_cursor(("x", "y"), surface)
+        with self.assertRaises(TypeError):
+            pygame.mouse.set_cursor(hotspot, "not_a_surface")
+
+        # Color: Working as intended
+        self.assertEqual(pygame.mouse.set_cursor(hotspot, surface), None)
+        pygame.mouse.set_cursor(hotspot, surface)
+        self.assertEqual(pygame.mouse.get_cursor(), color_cursor)
+        pygame.mouse.set_cursor(color_cursor)
+        self.assertEqual(pygame.mouse.get_cursor(), color_cursor)
+
+        # Color: Working as intended + Surface with no references is returned okay
+        pygame.mouse.set_cursor((0, 0), pygame.Surface((20, 20)))
+        cursor = pygame.mouse.get_cursor()
+        self.assertEqual(cursor.type, "color")
+        self.assertEqual(cursor.data[0], (0, 0))
+        self.assertEqual(cursor.data[1].get_size(), (20, 20))
+
+    def test_get_focused(self):
+        """Ensures get_focused returns the correct type."""
+        focused = pygame.mouse.get_focused()
+
+        self.assertIsInstance(focused, int)
+
+    def test_get_pressed(self):
+        """Ensures get_pressed returns the correct types."""
+        expected_length = 3
+        buttons_pressed = pygame.mouse.get_pressed()
+        self.assertIsInstance(buttons_pressed, tuple)
+        self.assertEqual(len(buttons_pressed), expected_length)
+        for value in buttons_pressed:
+            self.assertIsInstance(value, bool)
+
+        expected_length = 5
+        buttons_pressed = pygame.mouse.get_pressed(num_buttons=5)
+        self.assertIsInstance(buttons_pressed, tuple)
+        self.assertEqual(len(buttons_pressed), expected_length)
+        for value in buttons_pressed:
+            self.assertIsInstance(value, bool)
+
+        expected_length = 3
+        buttons_pressed = pygame.mouse.get_pressed(3)
+        self.assertIsInstance(buttons_pressed, tuple)
+        self.assertEqual(len(buttons_pressed), expected_length)
+        for value in buttons_pressed:
+            self.assertIsInstance(value, bool)
+
+        expected_length = 5
+        buttons_pressed = pygame.mouse.get_pressed(5)
+        self.assertIsInstance(buttons_pressed, tuple)
+        self.assertEqual(len(buttons_pressed), expected_length)
+        for value in buttons_pressed:
+            self.assertIsInstance(value, bool)
+
+        with self.assertRaises(ValueError):
+            pygame.mouse.get_pressed(4)
+
+    def test_get_pos(self):
+        """Ensures get_pos returns the correct types."""
+        expected_length = 2
+
+        pos = pygame.mouse.get_pos()
+
+        self.assertIsInstance(pos, tuple)
+        self.assertEqual(len(pos), expected_length)
+        for value in 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"), []):
+            with self.assertRaises(TypeError):
+                pygame.mouse.set_pos(invalid_pos)
+
+    def test_get_rel(self):
+        """Ensures get_rel returns the correct types."""
+        expected_length = 2
+
+        rel = pygame.mouse.get_rel()
+
+        self.assertIsInstance(rel, tuple)
+        self.assertEqual(len(rel), expected_length)
+        for value in rel:
+            self.assertIsInstance(value, int)
+
+    def test_get_visible(self):
+        """Ensures get_visible works correctly."""
+        for expected_value in (False, True):
+            pygame.mouse.set_visible(expected_value)
+
+            visible = pygame.mouse.get_visible()
+
+            self.assertEqual(visible, expected_value)
+
+    def test_set_visible(self):
+        """Ensures set_visible returns the correct values."""
+        # Set to a known state.
+        pygame.mouse.set_visible(True)
+
+        for expected_visible in (False, True):
+            prev_visible = pygame.mouse.set_visible(expected_visible)
+
+            self.assertEqual(prev_visible, not expected_visible)
+
+    def test_set_visible__invalid_value(self):
+        """Ensures set_visible handles invalid positions correctly."""
+        for invalid_value in ((1,), [1, 2, 3], 1.1, "1", (1, "1"), []):
+            with self.assertRaises(TypeError):
+                prev_visible = pygame.mouse.set_visible(invalid_value)
+
+
+################################################################################
+
+if __name__ == "__main__":
+    unittest.main()
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/pixelarray_test.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/pixelarray_test.py
new file mode 100644
index 0000000..7b1cf42
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/pixelarray_test.py
@@ -0,0 +1,1667 @@
+import gc
+import operator
+import platform
+import sys
+import unittest
+import weakref
+from functools import reduce
+
+from pygame.tests.test_utils import SurfaceSubclass
+
+try:
+    from pygame.tests.test_utils import arrinter
+except NameError:
+    pass
+
+import pygame
+
+
+IS_PYPY = "PyPy" == platform.python_implementation()
+
+
+class TestMixin:
+    def assert_surfaces_equal(self, s1, s2, msg=None):
+        """Checks if two surfaces are equal in size and color."""
+        w, h = s1.get_size()
+
+        self.assertTupleEqual((w, h), s2.get_size(), msg)
+
+        msg = "" if msg is None else f"{msg}, "
+        msg += f"size: ({w}, {h})"
+
+        for x in range(w):
+            for y in range(h):
+                self.assertEqual(
+                    s1.get_at((x, y)),
+                    s2.get_at((x, y)),
+                    f"{msg}, position: ({x}, {y})",
+                )
+
+    def assert_surface_filled(self, surface, expected_color, msg=None):
+        """Checks if the surface is filled with the given color."""
+        width, height = surface.get_size()
+
+        surface.lock()  # Lock for possible speed up.
+        for pos in ((x, y) for y in range(height) for x in range(width)):
+            self.assertEqual(surface.get_at(pos), expected_color, msg)
+        surface.unlock()
+
+
+@unittest.skipIf(IS_PYPY, "pypy having issues")
+class PixelArrayTypeTest(unittest.TestCase, TestMixin):
+    def test_compare(self):
+        # __doc__ (as of 2008-06-25) for pygame.pixelarray.PixelArray.compare:
+
+        # PixelArray.compare (array, distance=0, weights=(0.299, 0.587, 0.114)): Return PixelArray
+        # Compares the PixelArray with another one.
+
+        w = 10
+        h = 20
+        size = w, h
+        sf = pygame.Surface(size, 0, 32)
+        ar = pygame.PixelArray(sf)
+        sf2 = pygame.Surface(size, 0, 32)
+        self.assertRaises(TypeError, ar.compare, sf2)
+        ar2 = pygame.PixelArray(sf2)
+        ar3 = ar.compare(ar2)
+        self.assertTrue(isinstance(ar3, pygame.PixelArray))
+        self.assertEqual(ar3.shape, size)
+        sf2.fill(pygame.Color("white"))
+        self.assert_surfaces_equal(sf2, ar3.surface)
+        del ar3
+        r = pygame.Rect(2, 5, 6, 13)
+        sf.fill(pygame.Color("blue"), r)
+        sf2.fill(pygame.Color("red"))
+        sf2.fill(pygame.Color("blue"), r)
+        ar3 = ar.compare(ar2)
+        sf.fill(pygame.Color("white"), r)
+        self.assert_surfaces_equal(sf, ar3.surface)
+
+        # FINISH ME!
+        # Test other bit depths, slices, and distance != 0.
+
+    def test_compare__same_colors_within_distance(self):
+        """Ensures compare works correctly with same colored surfaces."""
+        size = (3, 5)
+        pixelarray_result_color = pygame.Color("white")
+        surface_color = (127, 127, 127, 255)
+
+        for depth in (8, 16, 24, 32):
+            expected_pixelarray_surface = pygame.Surface(size, depth=depth)
+            expected_pixelarray_surface.fill(pixelarray_result_color)
+
+            # Copy the surface to ensure same dimensions/formatting.
+            surf_a = expected_pixelarray_surface.copy()
+            surf_a.fill(surface_color)
+            # For non-32 bit depths, the actual color can be different from what
+            # was filled.
+            expected_surface_color = surf_a.get_at((0, 0))
+
+            pixelarray_a = pygame.PixelArray(surf_a)
+            pixelarray_b = pygame.PixelArray(surf_a.copy())
+
+            for distance in (0.0, 0.01, 0.1, 1.0):
+                pixelarray_result = pixelarray_a.compare(
+                    pixelarray_b, distance=distance
+                )
+
+                # Ensure the resulting pixelarray is correct and that the original
+                # surfaces were not changed.
+                self.assert_surfaces_equal(
+                    pixelarray_result.surface,
+                    expected_pixelarray_surface,
+                    (depth, distance),
+                )
+                self.assert_surface_filled(
+                    pixelarray_a.surface, expected_surface_color, (depth, distance)
+                )
+                self.assert_surface_filled(
+                    pixelarray_b.surface, expected_surface_color, (depth, distance)
+                )
+
+            pixelarray_a.close()
+            pixelarray_b.close()
+            pixelarray_result.close()
+
+    def test_compare__different_colors_within_distance(self):
+        """Ensures compare works correctly with different colored surfaces
+        and the color difference is within the given distance.
+        """
+        size = (3, 5)
+        pixelarray_result_color = pygame.Color("white")
+        surface_a_color = (127, 127, 127, 255)
+        surface_b_color = (128, 127, 127, 255)
+
+        for depth in (8, 16, 24, 32):
+            expected_pixelarray_surface = pygame.Surface(size, depth=depth)
+            expected_pixelarray_surface.fill(pixelarray_result_color)
+
+            # Copy the surface to ensure same dimensions/formatting.
+            surf_a = expected_pixelarray_surface.copy()
+            surf_a.fill(surface_a_color)
+            # For non-32 bit depths, the actual color can be different from what
+            # was filled.
+            expected_surface_a_color = surf_a.get_at((0, 0))
+            pixelarray_a = pygame.PixelArray(surf_a)
+
+            surf_b = expected_pixelarray_surface.copy()
+            surf_b.fill(surface_b_color)
+            # For non-32 bit depths, the actual color can be different from what
+            # was filled.
+            expected_surface_b_color = surf_b.get_at((0, 0))
+            pixelarray_b = pygame.PixelArray(surf_b)
+
+            for distance in (0.2, 0.3, 0.5, 1.0):
+                pixelarray_result = pixelarray_a.compare(
+                    pixelarray_b, distance=distance
+                )
+
+                # Ensure the resulting pixelarray is correct and that the original
+                # surfaces were not changed.
+                self.assert_surfaces_equal(
+                    pixelarray_result.surface,
+                    expected_pixelarray_surface,
+                    (depth, distance),
+                )
+                self.assert_surface_filled(
+                    pixelarray_a.surface, expected_surface_a_color, (depth, distance)
+                )
+                self.assert_surface_filled(
+                    pixelarray_b.surface, expected_surface_b_color, (depth, distance)
+                )
+
+            pixelarray_a.close()
+            pixelarray_b.close()
+            pixelarray_result.close()
+
+    def test_compare__different_colors_not_within_distance(self):
+        """Ensures compare works correctly with different colored surfaces
+        and the color difference is not within the given distance.
+        """
+        size = (3, 5)
+        pixelarray_result_color = pygame.Color("black")
+        surface_a_color = (127, 127, 127, 255)
+        surface_b_color = (128, 127, 127, 255)
+
+        for depth in (8, 16, 24, 32):
+            expected_pixelarray_surface = pygame.Surface(size, depth=depth)
+            expected_pixelarray_surface.fill(pixelarray_result_color)
+
+            # Copy the surface to ensure same dimensions/formatting.
+            surf_a = expected_pixelarray_surface.copy()
+            surf_a.fill(surface_a_color)
+            # For non-32 bit depths, the actual color can be different from what
+            # was filled.
+            expected_surface_a_color = surf_a.get_at((0, 0))
+            pixelarray_a = pygame.PixelArray(surf_a)
+
+            surf_b = expected_pixelarray_surface.copy()
+            surf_b.fill(surface_b_color)
+            # For non-32 bit depths, the actual color can be different from what
+            # was filled.
+            expected_surface_b_color = surf_b.get_at((0, 0))
+            pixelarray_b = pygame.PixelArray(surf_b)
+
+            for distance in (0.0, 0.00001, 0.0001, 0.001):
+                pixelarray_result = pixelarray_a.compare(
+                    pixelarray_b, distance=distance
+                )
+
+                # Ensure the resulting pixelarray is correct and that the original
+                # surfaces were not changed.
+                self.assert_surfaces_equal(
+                    pixelarray_result.surface,
+                    expected_pixelarray_surface,
+                    (depth, distance),
+                )
+                self.assert_surface_filled(
+                    pixelarray_a.surface, expected_surface_a_color, (depth, distance)
+                )
+                self.assert_surface_filled(
+                    pixelarray_b.surface, expected_surface_b_color, (depth, distance)
+                )
+
+            pixelarray_a.close()
+            pixelarray_b.close()
+            pixelarray_result.close()
+
+    def test_close(self):
+        """does not crash when it is deleted."""
+        s = pygame.Surface((10, 10))
+        a = pygame.PixelArray(s)
+        a.close()
+        del a
+
+    def test_close_raises(self):
+        """when you try to do an operation after it is closed."""
+        s = pygame.Surface((10, 10))
+        a = pygame.PixelArray(s)
+        a.close()
+
+        def access_after():
+            a[:]
+
+        self.assertRaises(ValueError, access_after)
+
+        def assign_all_after():
+            a[:] = 1
+
+        self.assertRaises(ValueError, assign_all_after)
+
+        def make_surface_after():
+            a.make_surface()
+
+        self.assertRaises(ValueError, make_surface_after)
+
+        def iter_after():
+            for x in a:
+                pass
+
+        self.assertRaises(ValueError, iter_after)
+
+        def close_after():
+            a.close()
+
+        self.assertRaises(ValueError, close_after)
+
+        def surface_after():
+            a.surface
+
+        self.assertRaises(ValueError, surface_after)
+
+        def itemsize_after():
+            a.itemsize
+
+        self.assertRaises(ValueError, itemsize_after)
+
+        def transpose_after():
+            a.transpose()
+
+        self.assertRaises(ValueError, transpose_after)
+
+    def test_context_manager(self):
+        """closes properly."""
+        s = pygame.Surface((10, 10))
+        with pygame.PixelArray(s) as a:
+            a[:]
+
+        # Test pixel array write... will also catch refcount issues and
+        # segfault
+        with pygame.PixelArray(s) as a:
+            a[:] = pygame.Color("deepskyblue")
+
+    def test_pixel_array(self):
+        for bpp in (8, 16, 24, 32):
+            sf = pygame.Surface((10, 20), 0, bpp)
+            sf.fill((0, 0, 0))
+            ar = pygame.PixelArray(sf)
+
+            self.assertEqual(ar._pixels_address, sf._pixels_address)
+
+            if sf.mustlock():
+                self.assertTrue(sf.get_locked())
+
+            self.assertEqual(len(ar), 10)
+
+            del ar
+            if sf.mustlock():
+                self.assertFalse(sf.get_locked())
+
+    def test_as_class(self):
+        # Check general new-style class freatures.
+        sf = pygame.Surface((2, 3), 0, 32)
+        ar = pygame.PixelArray(sf)
+        self.assertRaises(AttributeError, getattr, ar, "nonnative")
+        ar.nonnative = "value"
+        self.assertEqual(ar.nonnative, "value")
+        r = weakref.ref(ar)
+        self.assertTrue(r() is ar)
+        del ar
+        gc.collect()
+        self.assertTrue(r() is None)
+
+        class C(pygame.PixelArray):
+            def __str__(self):
+                return "string (%i, %i)" % self.shape
+
+        ar = C(sf)
+        self.assertEqual(str(ar), "string (2, 3)")
+        r = weakref.ref(ar)
+        self.assertTrue(r() is ar)
+        del ar
+        gc.collect()
+        self.assertTrue(r() is None)
+
+    def test_pixelarray__subclassed_surface(self):
+        """Ensure the PixelArray constructor accepts subclassed surfaces."""
+        surface = SurfaceSubclass((3, 5), 0, 32)
+        pixelarray = pygame.PixelArray(surface)
+
+        self.assertIsInstance(pixelarray, pygame.PixelArray)
+
+    # Sequence interfaces
+    def test_get_column(self):
+        for bpp in (8, 16, 24, 32):
+            sf = pygame.Surface((6, 8), 0, bpp)
+            sf.fill((0, 0, 255))
+            val = sf.map_rgb((0, 0, 255))
+            ar = pygame.PixelArray(sf)
+
+            ar2 = ar.__getitem__(1)
+            self.assertEqual(len(ar2), 8)
+            self.assertEqual(ar2.__getitem__(0), val)
+            self.assertEqual(ar2.__getitem__(1), val)
+            self.assertEqual(ar2.__getitem__(2), val)
+
+            ar2 = ar.__getitem__(-1)
+            self.assertEqual(len(ar2), 8)
+            self.assertEqual(ar2.__getitem__(0), val)
+            self.assertEqual(ar2.__getitem__(1), val)
+            self.assertEqual(ar2.__getitem__(2), val)
+
+    @unittest.skipIf(IS_PYPY, "pypy malloc abort")
+    def test_get_pixel(self):
+        w = 10
+        h = 20
+        size = w, h
+        bg_color = (0, 0, 255)
+        fg_color_y = (0, 0, 128)
+        fg_color_x = (0, 0, 11)
+        for bpp in (8, 16, 24, 32):
+            sf = pygame.Surface(size, 0, bpp)
+            mapped_bg_color = sf.map_rgb(bg_color)
+            mapped_fg_color_y = sf.map_rgb(fg_color_y)
+            mapped_fg_color_x = sf.map_rgb(fg_color_x)
+            self.assertNotEqual(
+                mapped_fg_color_y,
+                mapped_bg_color,
+                "Unusable test colors for bpp %i" % (bpp,),
+            )
+            self.assertNotEqual(
+                mapped_fg_color_x,
+                mapped_bg_color,
+                "Unusable test colors for bpp %i" % (bpp,),
+            )
+            self.assertNotEqual(
+                mapped_fg_color_y,
+                mapped_fg_color_x,
+                "Unusable test colors for bpp %i" % (bpp,),
+            )
+            sf.fill(bg_color)
+
+            ar = pygame.PixelArray(sf)
+
+            ar_y = ar.__getitem__(1)
+            for y in range(h):
+                ar2 = ar_y.__getitem__(y)
+                self.assertEqual(
+                    ar2,
+                    mapped_bg_color,
+                    "ar[1][%i] == %i, mapped_bg_color == %i"
+                    % (y, ar2, mapped_bg_color),
+                )
+
+                sf.set_at((1, y), fg_color_y)
+                ar2 = ar_y.__getitem__(y)
+                self.assertEqual(
+                    ar2,
+                    mapped_fg_color_y,
+                    "ar[1][%i] == %i, mapped_fg_color_y == %i"
+                    % (y, ar2, mapped_fg_color_y),
+                )
+
+            sf.set_at((1, 1), bg_color)
+            for x in range(w):
+                ar2 = ar.__getitem__(x).__getitem__(1)
+                self.assertEqual(
+                    ar2,
+                    mapped_bg_color,
+                    "ar[%i][1] = %i, mapped_bg_color = %i" % (x, ar2, mapped_bg_color),
+                )
+                sf.set_at((x, 1), fg_color_x)
+                ar2 = ar.__getitem__(x).__getitem__(1)
+                self.assertEqual(
+                    ar2,
+                    mapped_fg_color_x,
+                    "ar[%i][1] = %i, mapped_fg_color_x = %i"
+                    % (x, ar2, mapped_fg_color_x),
+                )
+
+            ar2 = ar.__getitem__(0).__getitem__(0)
+            self.assertEqual(ar2, mapped_bg_color, "bpp = %i" % (bpp,))
+
+            ar2 = ar.__getitem__(1).__getitem__(0)
+            self.assertEqual(ar2, mapped_fg_color_y, "bpp = %i" % (bpp,))
+
+            ar2 = ar.__getitem__(-4).__getitem__(1)
+            self.assertEqual(ar2, mapped_fg_color_x, "bpp = %i" % (bpp,))
+
+            ar2 = ar.__getitem__(-4).__getitem__(5)
+            self.assertEqual(ar2, mapped_bg_color, "bpp = %i" % (bpp,))
+
+            ar2 = ar.__getitem__(-4).__getitem__(0)
+            self.assertEqual(ar2, mapped_bg_color, "bpp = %i" % (bpp,))
+
+            ar2 = ar.__getitem__(-w + 1).__getitem__(0)
+            self.assertEqual(ar2, mapped_fg_color_y, "bpp = %i" % (bpp,))
+
+            ar2 = ar.__getitem__(-w).__getitem__(0)
+            self.assertEqual(ar2, mapped_bg_color, "bpp = %i" % (bpp,))
+
+            ar2 = ar.__getitem__(5).__getitem__(-4)
+            self.assertEqual(ar2, mapped_bg_color, "bpp = %i" % (bpp,))
+
+            ar2 = ar.__getitem__(5).__getitem__(-h + 1)
+            self.assertEqual(ar2, mapped_fg_color_x, "bpp = %i" % (bpp,))
+
+            ar2 = ar.__getitem__(5).__getitem__(-h)
+            self.assertEqual(ar2, mapped_bg_color, "bpp = %i" % (bpp,))
+
+            ar2 = ar.__getitem__(0).__getitem__(-h + 1)
+            self.assertEqual(ar2, mapped_fg_color_x, "bpp = %i" % (bpp,))
+
+            ar2 = ar.__getitem__(0).__getitem__(-h)
+            self.assertEqual(ar2, mapped_bg_color, "bpp = %i" % (bpp,))
+
+    def test_set_pixel(self):
+        for bpp in (8, 16, 24, 32):
+            sf = pygame.Surface((10, 20), 0, bpp)
+            sf.fill((0, 0, 0))
+            ar = pygame.PixelArray(sf)
+
+            ar.__getitem__(0).__setitem__(0, (0, 255, 0))
+            self.assertEqual(ar[0][0], sf.map_rgb((0, 255, 0)))
+
+            ar.__getitem__(1).__setitem__(1, (128, 128, 128))
+            self.assertEqual(ar[1][1], sf.map_rgb((128, 128, 128)))
+
+            ar.__getitem__(-1).__setitem__(-1, (128, 128, 128))
+            self.assertEqual(ar[9][19], sf.map_rgb((128, 128, 128)))
+
+            ar.__getitem__(-2).__setitem__(-2, (128, 128, 128))
+            self.assertEqual(ar[8][-2], sf.map_rgb((128, 128, 128)))
+
+    def test_set_column(self):
+        for bpp in (8, 16, 24, 32):
+            sf = pygame.Surface((6, 8), 0, bpp)
+            sf.fill((0, 0, 0))
+            ar = pygame.PixelArray(sf)
+
+            sf2 = pygame.Surface((6, 8), 0, bpp)
+            sf2.fill((0, 255, 255))
+            ar2 = pygame.PixelArray(sf2)
+
+            # Test single value assignment
+            ar.__setitem__(2, (128, 128, 128))
+            self.assertEqual(ar[2][0], sf.map_rgb((128, 128, 128)))
+            self.assertEqual(ar[2][1], sf.map_rgb((128, 128, 128)))
+
+            ar.__setitem__(-1, (0, 255, 255))
+            self.assertEqual(ar[5][0], sf.map_rgb((0, 255, 255)))
+            self.assertEqual(ar[-1][1], sf.map_rgb((0, 255, 255)))
+
+            ar.__setitem__(-2, (255, 255, 0))
+            self.assertEqual(ar[4][0], sf.map_rgb((255, 255, 0)))
+            self.assertEqual(ar[-2][1], sf.map_rgb((255, 255, 0)))
+
+            # Test list assignment.
+            ar.__setitem__(0, [(255, 255, 255)] * 8)
+            self.assertEqual(ar[0][0], sf.map_rgb((255, 255, 255)))
+            self.assertEqual(ar[0][1], sf.map_rgb((255, 255, 255)))
+
+            # Test tuple assignment.
+            # Changed in Pygame 1.9.2 - Raises an exception.
+            self.assertRaises(
+                ValueError,
+                ar.__setitem__,
+                1,
+                (
+                    (204, 0, 204),
+                    (17, 17, 17),
+                    (204, 0, 204),
+                    (17, 17, 17),
+                    (204, 0, 204),
+                    (17, 17, 17),
+                    (204, 0, 204),
+                    (17, 17, 17),
+                ),
+            )
+
+            # Test pixel array assignment.
+            ar.__setitem__(1, ar2.__getitem__(3))
+            self.assertEqual(ar[1][0], sf.map_rgb((0, 255, 255)))
+            self.assertEqual(ar[1][1], sf.map_rgb((0, 255, 255)))
+
+    def test_get_slice(self):
+        for bpp in (8, 16, 24, 32):
+            sf = pygame.Surface((10, 20), 0, bpp)
+            sf.fill((0, 0, 0))
+            ar = pygame.PixelArray(sf)
+
+            self.assertEqual(len(ar[0:2]), 2)
+            self.assertEqual(len(ar[3:7][3]), 20)
+
+            self.assertEqual(ar[0:0], None)
+            self.assertEqual(ar[5:5], None)
+            self.assertEqual(ar[9:9], None)
+
+            # Has to resolve to ar[7:8]
+            self.assertEqual(len(ar[-3:-2]), 1)  # 2D
+            self.assertEqual(len(ar[-3:-2][0]), 20)  # 1D
+
+            # Try assignments.
+
+            # 2D assignment.
+            ar[2:5] = (255, 255, 255)
+
+            # 1D assignment
+            ar[3][3:7] = (10, 10, 10)
+            self.assertEqual(ar[3][5], sf.map_rgb((10, 10, 10)))
+            self.assertEqual(ar[3][6], sf.map_rgb((10, 10, 10)))
+
+    @unittest.skipIf(IS_PYPY, "skipping for PyPy (segfaults on mac pypy3 6.0.0)")
+    def test_contains(self):
+        for bpp in (8, 16, 24, 32):
+            sf = pygame.Surface((10, 20), 0, bpp)
+            sf.fill((0, 0, 0))
+            sf.set_at((8, 8), (255, 255, 255))
+
+            ar = pygame.PixelArray(sf)
+            self.assertTrue((0, 0, 0) in ar)
+            self.assertTrue((255, 255, 255) in ar)
+            self.assertFalse((255, 255, 0) in ar)
+            self.assertFalse(0x0000FF in ar)
+
+            # Test sliced array
+            self.assertTrue((0, 0, 0) in ar[8])
+            self.assertTrue((255, 255, 255) in ar[8])
+            self.assertFalse((255, 255, 0) in ar[8])
+            self.assertFalse(0x0000FF in ar[8])
+
+    def test_get_surface(self):
+        for bpp in (8, 16, 24, 32):
+            sf = pygame.Surface((10, 20), 0, bpp)
+            sf.fill((0, 0, 0))
+            ar = pygame.PixelArray(sf)
+            self.assertTrue(ar.surface is sf)
+
+    def test_get_surface__subclassed_surface(self):
+        """Ensure the surface attribute can handle subclassed surfaces."""
+        expected_surface = SurfaceSubclass((5, 3), 0, 32)
+        pixelarray = pygame.PixelArray(expected_surface)
+
+        surface = pixelarray.surface
+
+        self.assertIs(surface, expected_surface)
+        self.assertIsInstance(surface, pygame.Surface)
+        self.assertIsInstance(surface, SurfaceSubclass)
+
+    def test_set_slice(self):
+        for bpp in (8, 16, 24, 32):
+            sf = pygame.Surface((6, 8), 0, bpp)
+            sf.fill((0, 0, 0))
+            ar = pygame.PixelArray(sf)
+
+            # Test single value assignment
+            val = sf.map_rgb((128, 128, 128))
+            ar[0:2] = val
+            self.assertEqual(ar[0][0], val)
+            self.assertEqual(ar[0][1], val)
+            self.assertEqual(ar[1][0], val)
+            self.assertEqual(ar[1][1], val)
+
+            val = sf.map_rgb((0, 255, 255))
+            ar[-3:-1] = val
+            self.assertEqual(ar[3][0], val)
+            self.assertEqual(ar[-2][1], val)
+
+            val = sf.map_rgb((255, 255, 255))
+            ar[-3:] = (255, 255, 255)
+            self.assertEqual(ar[4][0], val)
+            self.assertEqual(ar[-1][1], val)
+
+            # Test array size mismatch.
+            # Changed in ver. 1.9.2
+            # (was "Test list assignment, this is a vertical assignment.")
+            val = sf.map_rgb((0, 255, 0))
+            self.assertRaises(ValueError, ar.__setitem__, slice(2, 4), [val] * 8)
+
+            # And the horizontal assignment.
+            val = sf.map_rgb((255, 0, 0))
+            val2 = sf.map_rgb((128, 0, 255))
+            ar[0:2] = [val, val2]
+            self.assertEqual(ar[0][0], val)
+            self.assertEqual(ar[1][0], val2)
+            self.assertEqual(ar[0][1], val)
+            self.assertEqual(ar[1][1], val2)
+            self.assertEqual(ar[0][4], val)
+            self.assertEqual(ar[1][4], val2)
+            self.assertEqual(ar[0][5], val)
+            self.assertEqual(ar[1][5], val2)
+
+            # Test pixelarray assignment.
+            ar[:] = (0, 0, 0)
+            sf2 = pygame.Surface((6, 8), 0, bpp)
+            sf2.fill((255, 0, 255))
+
+            val = sf.map_rgb((255, 0, 255))
+            ar2 = pygame.PixelArray(sf2)
+
+            ar[:] = ar2[:]
+            self.assertEqual(ar[0][0], val)
+            self.assertEqual(ar[5][7], val)
+
+            # Ensure p1 ... pn are freed for array[...] = [p1, ..., pn]
+            # Bug fix: reference counting.
+            if hasattr(sys, "getrefcount"):
+
+                class Int(int):
+                    """Unique int instances"""
+
+                    pass
+
+                sf = pygame.Surface((5, 2), 0, 32)
+                ar = pygame.PixelArray(sf)
+                pixel_list = [Int(i) for i in range(ar.shape[0])]
+                refcnts_before = [sys.getrefcount(i) for i in pixel_list]
+                ar[...] = pixel_list
+                refcnts_after = [sys.getrefcount(i) for i in pixel_list]
+                gc.collect()
+                self.assertEqual(refcnts_after, refcnts_before)
+
+    def test_subscript(self):
+        # 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):
+            sf = pygame.Surface((6, 8), 0, bpp)
+            sf.set_at((1, 3), (0, 255, 0))
+            sf.set_at((0, 0), (0, 255, 0))
+            sf.set_at((4, 4), (0, 255, 0))
+            val = sf.map_rgb((0, 255, 0))
+
+            ar = pygame.PixelArray(sf)
+
+            # Test single value requests.
+            self.assertEqual(ar[1, 3], val)
+            self.assertEqual(ar[0, 0], val)
+            self.assertEqual(ar[4, 4], val)
+            self.assertEqual(ar[1][3], val)
+            self.assertEqual(ar[0][0], val)
+            self.assertEqual(ar[4][4], val)
+
+            # Test ellipse working.
+            self.assertEqual(len(ar[..., ...]), 6)
+            self.assertEqual(len(ar[1, ...]), 8)
+            self.assertEqual(len(ar[..., 3]), 6)
+
+            # Test simple slicing
+            self.assertEqual(len(ar[:, :]), 6)
+            self.assertEqual(
+                len(ar[:,]),
+                6,
+            )
+            self.assertEqual(len(ar[1, :]), 8)
+            self.assertEqual(len(ar[:, 2]), 6)
+            # Empty slices
+            self.assertEqual(
+                ar[4:4,],
+                None,
+            )
+            self.assertEqual(ar[4:4, ...], None)
+            self.assertEqual(ar[4:4, 2:2], None)
+            self.assertEqual(ar[4:4, 1:4], None)
+            self.assertEqual(
+                ar[4:4:2,],
+                None,
+            )
+            self.assertEqual(
+                ar[4:4:-2,],
+                None,
+            )
+            self.assertEqual(ar[4:4:1, ...], None)
+            self.assertEqual(ar[4:4:-1, ...], None)
+            self.assertEqual(ar[4:4:1, 2:2], None)
+            self.assertEqual(ar[4:4:-1, 1:4], None)
+            self.assertEqual(ar[..., 4:4], None)
+            self.assertEqual(ar[1:4, 4:4], None)
+            self.assertEqual(ar[..., 4:4:1], None)
+            self.assertEqual(ar[..., 4:4:-1], None)
+            self.assertEqual(ar[2:2, 4:4:1], None)
+            self.assertEqual(ar[1:4, 4:4:-1], None)
+
+            # Test advanced slicing
+            ar[0] = 0
+            ar[1] = 1
+            ar[2] = 2
+            ar[3] = 3
+            ar[4] = 4
+            ar[5] = 5
+
+            # We should receive something like [0,2,4]
+            self.assertEqual(ar[::2, 1][0], 0)
+            self.assertEqual(ar[::2, 1][1], 2)
+            self.assertEqual(ar[::2, 1][2], 4)
+            # We should receive something like [2,2,2]
+            self.assertEqual(ar[2, ::2][0], 2)
+            self.assertEqual(ar[2, ::2][1], 2)
+            self.assertEqual(ar[2, ::2][2], 2)
+
+            # Should create a 3x3 array of [0,2,4]
+            ar2 = ar[::2, ::2]
+            self.assertEqual(len(ar2), 3)
+            self.assertEqual(ar2[0][0], 0)
+            self.assertEqual(ar2[0][1], 0)
+            self.assertEqual(ar2[0][2], 0)
+            self.assertEqual(ar2[2][0], 4)
+            self.assertEqual(ar2[2][1], 4)
+            self.assertEqual(ar2[2][2], 4)
+            self.assertEqual(ar2[1][0], 2)
+            self.assertEqual(ar2[2][0], 4)
+            self.assertEqual(ar2[1][1], 2)
+
+            # Should create a reversed 3x8 array over X of [1,2,3] -> [3,2,1]
+            ar2 = ar[3:0:-1]
+            self.assertEqual(len(ar2), 3)
+            self.assertEqual(ar2[0][0], 3)
+            self.assertEqual(ar2[0][1], 3)
+            self.assertEqual(ar2[0][2], 3)
+            self.assertEqual(ar2[0][7], 3)
+            self.assertEqual(ar2[2][0], 1)
+            self.assertEqual(ar2[2][1], 1)
+            self.assertEqual(ar2[2][2], 1)
+            self.assertEqual(ar2[2][7], 1)
+            self.assertEqual(ar2[1][0], 2)
+            self.assertEqual(ar2[1][1], 2)
+            # Should completely reverse the array over X -> [5,4,3,2,1,0]
+            ar2 = ar[::-1]
+            self.assertEqual(len(ar2), 6)
+            self.assertEqual(ar2[0][0], 5)
+            self.assertEqual(ar2[0][1], 5)
+            self.assertEqual(ar2[0][3], 5)
+            self.assertEqual(ar2[0][-1], 5)
+            self.assertEqual(ar2[1][0], 4)
+            self.assertEqual(ar2[1][1], 4)
+            self.assertEqual(ar2[1][3], 4)
+            self.assertEqual(ar2[1][-1], 4)
+            self.assertEqual(ar2[-1][-1], 0)
+            self.assertEqual(ar2[-2][-2], 1)
+            self.assertEqual(ar2[-3][-1], 2)
+
+            # Test advanced slicing
+            ar[:] = 0
+            ar2 = ar[:, 1]
+            ar2[:] = [99] * len(ar2)
+            self.assertEqual(ar2[0], 99)
+            self.assertEqual(ar2[-1], 99)
+            self.assertEqual(ar2[-2], 99)
+            self.assertEqual(ar2[2], 99)
+            self.assertEqual(ar[0, 1], 99)
+            self.assertEqual(ar[1, 1], 99)
+            self.assertEqual(ar[2, 1], 99)
+            self.assertEqual(ar[-1, 1], 99)
+            self.assertEqual(ar[-2, 1], 99)
+
+            # Cases where a 2d array should have a dimension of length 1.
+            ar2 = ar[1:2, :]
+            self.assertEqual(ar2.shape, (1, ar.shape[1]))
+            ar2 = ar[:, 1:2]
+            self.assertEqual(ar2.shape, (ar.shape[0], 1))
+            sf2 = pygame.Surface((1, 5), 0, 32)
+            ar2 = pygame.PixelArray(sf2)
+            self.assertEqual(ar2.shape, sf2.get_size())
+            sf2 = pygame.Surface((7, 1), 0, 32)
+            ar2 = pygame.PixelArray(sf2)
+            self.assertEqual(ar2.shape, sf2.get_size())
+
+            # Array has a single ellipsis subscript: the identity operator
+            ar2 = ar[...]
+            self.assertTrue(ar2 is ar)
+
+            # Ensure x and y are freed for p = array[x, y]
+            # Bug fix: reference counting
+            if hasattr(sys, "getrefcount"):
+
+                class Int(int):
+                    """Unique int instances"""
+
+                    pass
+
+                sf = pygame.Surface((2, 2), 0, 32)
+                ar = pygame.PixelArray(sf)
+                x, y = Int(0), Int(1)
+                rx_before, ry_before = sys.getrefcount(x), sys.getrefcount(y)
+                p = ar[x, y]
+                rx_after, ry_after = sys.getrefcount(x), sys.getrefcount(y)
+                self.assertEqual(rx_after, rx_before)
+                self.assertEqual(ry_after, ry_before)
+
+    def test_ass_subscript(self):
+        for bpp in (8, 16, 24, 32):
+            sf = pygame.Surface((6, 8), 0, bpp)
+            sf.fill((255, 255, 255))
+            ar = pygame.PixelArray(sf)
+
+            # Test ellipse working
+            ar[..., ...] = (0, 0, 0)
+            self.assertEqual(ar[0, 0], 0)
+            self.assertEqual(ar[1, 0], 0)
+            self.assertEqual(ar[-1, -1], 0)
+            ar[...,] = (0, 0, 255)
+            self.assertEqual(ar[0, 0], sf.map_rgb((0, 0, 255)))
+            self.assertEqual(ar[1, 0], sf.map_rgb((0, 0, 255)))
+            self.assertEqual(ar[-1, -1], sf.map_rgb((0, 0, 255)))
+            ar[:, ...] = (255, 0, 0)
+            self.assertEqual(ar[0, 0], sf.map_rgb((255, 0, 0)))
+            self.assertEqual(ar[1, 0], sf.map_rgb((255, 0, 0)))
+            self.assertEqual(ar[-1, -1], sf.map_rgb((255, 0, 0)))
+            ar[...] = (0, 255, 0)
+            self.assertEqual(ar[0, 0], sf.map_rgb((0, 255, 0)))
+            self.assertEqual(ar[1, 0], sf.map_rgb((0, 255, 0)))
+            self.assertEqual(ar[-1, -1], sf.map_rgb((0, 255, 0)))
+
+            # Ensure x and y are freed for array[x, y] = p
+            # Bug fix: reference counting
+            if hasattr(sys, "getrefcount"):
+
+                class Int(int):
+                    """Unique int instances"""
+
+                    pass
+
+                sf = pygame.Surface((2, 2), 0, 32)
+                ar = pygame.PixelArray(sf)
+                x, y = Int(0), Int(1)
+                rx_before, ry_before = sys.getrefcount(x), sys.getrefcount(y)
+                ar[x, y] = 0
+                rx_after, ry_after = sys.getrefcount(x), sys.getrefcount(y)
+                self.assertEqual(rx_after, rx_before)
+                self.assertEqual(ry_after, ry_before)
+
+    def test_pixels_field(self):
+        for bpp in [1, 2, 3, 4]:
+            sf = pygame.Surface((11, 7), 0, bpp * 8)
+            ar = pygame.PixelArray(sf)
+            ar2 = ar[1:, :]
+            self.assertEqual(ar2._pixels_address - ar._pixels_address, ar.itemsize)
+            ar2 = ar[:, 1:]
+            self.assertEqual(ar2._pixels_address - ar._pixels_address, ar.strides[1])
+            ar2 = ar[::-1, :]
+            self.assertEqual(
+                ar2._pixels_address - ar._pixels_address,
+                (ar.shape[0] - 1) * ar.itemsize,
+            )
+            ar2 = ar[::-2, :]
+            self.assertEqual(
+                ar2._pixels_address - ar._pixels_address,
+                (ar.shape[0] - 1) * ar.itemsize,
+            )
+            ar2 = ar[:, ::-1]
+            self.assertEqual(
+                ar2._pixels_address - ar._pixels_address,
+                (ar.shape[1] - 1) * ar.strides[1],
+            )
+            ar3 = ar2[::-1, :]
+            self.assertEqual(
+                ar3._pixels_address - ar._pixels_address,
+                (ar.shape[0] - 1) * ar.strides[0] + (ar.shape[1] - 1) * ar.strides[1],
+            )
+            ar2 = ar[:, ::-2]
+            self.assertEqual(
+                ar2._pixels_address - ar._pixels_address,
+                (ar.shape[1] - 1) * ar.strides[1],
+            )
+            ar2 = ar[2::, 3::]
+            self.assertEqual(
+                ar2._pixels_address - ar._pixels_address,
+                ar.strides[0] * 2 + ar.strides[1] * 3,
+            )
+            ar2 = ar[2::2, 3::4]
+            self.assertEqual(
+                ar2._pixels_address - ar._pixels_address,
+                ar.strides[0] * 2 + ar.strides[1] * 3,
+            )
+            ar2 = ar[9:2:-1, :]
+            self.assertEqual(
+                ar2._pixels_address - ar._pixels_address, ar.strides[0] * 9
+            )
+            ar2 = ar[:, 5:2:-1]
+            self.assertEqual(
+                ar2._pixels_address - ar._pixels_address, ar.strides[1] * 5
+            )
+            ##? ar2 = ar[:,9:2:-1]
+
+    def test_make_surface(self):
+        bg_color = pygame.Color(255, 255, 255)
+        fg_color = pygame.Color(128, 100, 0)
+        for bpp in (8, 16, 24, 32):
+            sf = pygame.Surface((10, 20), 0, bpp)
+            bg_color_adj = sf.unmap_rgb(sf.map_rgb(bg_color))
+            fg_color_adj = sf.unmap_rgb(sf.map_rgb(fg_color))
+            sf.fill(bg_color_adj)
+            sf.fill(fg_color_adj, (2, 5, 4, 11))
+            ar = pygame.PixelArray(sf)
+            newsf = ar[::2, ::2].make_surface()
+            rect = newsf.get_rect()
+            self.assertEqual(rect.width, 5)
+            self.assertEqual(rect.height, 10)
+            for p in [
+                (0, 2),
+                (0, 3),
+                (1, 2),
+                (2, 2),
+                (3, 2),
+                (3, 3),
+                (0, 7),
+                (0, 8),
+                (1, 8),
+                (2, 8),
+                (3, 8),
+                (3, 7),
+            ]:
+                self.assertEqual(newsf.get_at(p), bg_color_adj)
+            for p in [(1, 3), (2, 3), (1, 5), (2, 5), (1, 7), (2, 7)]:
+                self.assertEqual(newsf.get_at(p), fg_color_adj)
+
+        # Bug when array width is not a multiple of the slice step.
+        w = 17
+        lst = list(range(w))
+        w_slice = len(lst[::2])
+        h = 3
+        sf = pygame.Surface((w, h), 0, 32)
+        ar = pygame.PixelArray(sf)
+        ar2 = ar[::2, :]
+        sf2 = ar2.make_surface()
+        w2, h2 = sf2.get_size()
+        self.assertEqual(w2, w_slice)
+        self.assertEqual(h2, h)
+
+        # Bug when array height is not a multiple of the slice step.
+        # This can hang the Python interpreter.
+        h = 17
+        lst = list(range(h))
+        h_slice = len(lst[::2])
+        w = 3
+        sf = pygame.Surface((w, h), 0, 32)
+        ar = pygame.PixelArray(sf)
+        ar2 = ar[:, ::2]
+        sf2 = ar2.make_surface()  # Hangs here.
+        w2, h2 = sf2.get_size()
+        self.assertEqual(w2, w)
+        self.assertEqual(h2, h_slice)
+
+    def test_make_surface__subclassed_surface(self):
+        """Ensure make_surface can handle subclassed surfaces."""
+        expected_size = (3, 5)
+        expected_flags = 0
+        expected_depth = 32
+        original_surface = SurfaceSubclass(
+            expected_size, expected_flags, expected_depth
+        )
+        pixelarray = pygame.PixelArray(original_surface)
+
+        surface = pixelarray.make_surface()
+
+        self.assertIsNot(surface, original_surface)
+        self.assertIsInstance(surface, pygame.Surface)
+        self.assertNotIsInstance(surface, SurfaceSubclass)
+        self.assertEqual(surface.get_size(), expected_size)
+        self.assertEqual(surface.get_flags(), expected_flags)
+        self.assertEqual(surface.get_bitsize(), expected_depth)
+
+    def test_iter(self):
+        for bpp in (8, 16, 24, 32):
+            sf = pygame.Surface((5, 10), 0, bpp)
+            ar = pygame.PixelArray(sf)
+            iterations = 0
+            for col in ar:
+                self.assertEqual(len(col), 10)
+                iterations += 1
+            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))
+            rval = sf.map_rgb((0, 0, 255))
+            oval = sf.map_rgb((255, 0, 0))
+            ar = pygame.PixelArray(sf)
+            ar[::2].replace((255, 0, 0), (0, 0, 255))
+            self.assertEqual(ar[0][0], rval)
+            self.assertEqual(ar[1][0], oval)
+            self.assertEqual(ar[2][3], rval)
+            self.assertEqual(ar[3][6], oval)
+            self.assertEqual(ar[8][9], rval)
+            self.assertEqual(ar[9][9], oval)
+
+            ar[::2].replace((0, 0, 255), (255, 0, 0), weights=(10, 20, 50))
+            self.assertEqual(ar[0][0], oval)
+            self.assertEqual(ar[2][3], oval)
+            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))
+            sf.fill((255, 0, 0), (2, 2, 6, 6))
+
+            white = sf.map_rgb((255, 255, 255))
+            black = sf.map_rgb((0, 0, 0))
+
+            ar = pygame.PixelArray(sf)
+            newar = ar.extract((255, 0, 0))
+
+            self.assertEqual(newar[0][0], black)
+            self.assertEqual(newar[1][0], black)
+            self.assertEqual(newar[2][3], white)
+            self.assertEqual(newar[3][6], white)
+            self.assertEqual(newar[8][9], black)
+            self.assertEqual(newar[9][9], black)
+
+            newar = ar.extract((255, 0, 0), weights=(10, 0.1, 50))
+            self.assertEqual(newar[0][0], black)
+            self.assertEqual(newar[1][0], black)
+            self.assertEqual(newar[2][3], white)
+            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
+        h = 3 * 5 * 9
+        sf = pygame.Surface((w, h), 0, 32)
+        ar = pygame.PixelArray(sf)
+        size = (w, h)
+        strides = (1, w)
+        offset = 0
+        self._test_assignment(sf, ar, size, strides, offset)
+        xslice = slice(None, None, 2)
+        yslice = slice(None, None, 3)
+        ar, size, strides, offset = self._array_slice(
+            ar, size, (xslice, yslice), strides, offset
+        )
+        self._test_assignment(sf, ar, size, strides, offset)
+        xslice = slice(5, None, 5)
+        yslice = slice(5, None, 5)
+        ar, size, strides, offset = self._array_slice(
+            ar, size, (xslice, yslice), strides, offset
+        )
+        self._test_assignment(sf, ar, size, strides, offset)
+
+    def _test_assignment(self, sf, ar, ar_size, ar_strides, ar_offset):
+        self.assertEqual(ar.shape, ar_size)
+        ar_w, ar_h = ar_size
+        ar_xstride, ar_ystride = ar_strides
+        sf_w, sf_h = sf.get_size()
+        black = pygame.Color("black")
+        color = pygame.Color(0, 0, 12)
+        pxcolor = sf.map_rgb(color)
+        sf.fill(black)
+        for ar_x, ar_y in [
+            (0, 0),
+            (0, ar_h - 4),
+            (ar_w - 3, 0),
+            (0, ar_h - 1),
+            (ar_w - 1, 0),
+            (ar_w - 1, ar_h - 1),
+        ]:
+            sf_offset = ar_offset + ar_x * ar_xstride + ar_y * ar_ystride
+            sf_y = sf_offset // sf_w
+            sf_x = sf_offset - sf_y * sf_w
+            sf_posn = (sf_x, sf_y)
+            sf_pix = sf.get_at(sf_posn)
+            self.assertEqual(
+                sf_pix,
+                black,
+                "at pixarr posn (%i, %i) (surf posn (%i, %i)): "
+                "%s != %s" % (ar_x, ar_y, sf_x, sf_y, sf_pix, black),
+            )
+            ar[ar_x, ar_y] = pxcolor
+            sf_pix = sf.get_at(sf_posn)
+            self.assertEqual(
+                sf_pix,
+                color,
+                "at pixarr posn (%i, %i) (surf posn (%i, %i)): "
+                "%s != %s" % (ar_x, ar_y, sf_x, sf_y, sf_pix, color),
+            )
+
+    def _array_slice(self, ar, size, slices, strides, offset):
+        ar = ar[slices]
+        xslice, yslice = slices
+        w, h = size
+        xstart, xstop, xstep = xslice.indices(w)
+        ystart, ystop, ystep = yslice.indices(h)
+        w = (xstop - xstart + xstep - 1) // xstep
+        h = (ystop - ystart + ystep - 1) // ystep
+        xstride, ystride = strides
+        offset += xstart * xstride + ystart * ystride
+        xstride *= xstep
+        ystride *= ystep
+        return ar, (w, h), (xstride, ystride), offset
+
+    def test_array_properties(self):
+        # itemsize, ndim, shape, and strides.
+        for bpp in [1, 2, 3, 4]:
+            sf = pygame.Surface((2, 2), 0, bpp * 8)
+            ar = pygame.PixelArray(sf)
+            self.assertEqual(ar.itemsize, bpp)
+
+        for shape in [(4, 16), (5, 13)]:
+            w, h = shape
+            sf = pygame.Surface(shape, 0, 32)
+            bpp = sf.get_bytesize()
+            pitch = sf.get_pitch()
+            ar = pygame.PixelArray(sf)
+            self.assertEqual(ar.ndim, 2)
+            self.assertEqual(ar.shape, shape)
+            self.assertEqual(ar.strides, (bpp, pitch))
+            ar2 = ar[::2, :]
+            w2 = len(([0] * w)[::2])
+            self.assertEqual(ar2.ndim, 2)
+            self.assertEqual(ar2.shape, (w2, h))
+            self.assertEqual(ar2.strides, (2 * bpp, pitch))
+            ar2 = ar[:, ::2]
+            h2 = len(([0] * h)[::2])
+            self.assertEqual(ar2.ndim, 2)
+            self.assertEqual(ar2.shape, (w, h2))
+            self.assertEqual(ar2.strides, (bpp, 2 * pitch))
+            ar2 = ar[1]
+            self.assertEqual(ar2.ndim, 1)
+            self.assertEqual(ar2.shape, (h,))
+            self.assertEqual(ar2.strides, (pitch,))
+            ar2 = ar[:, 1]
+            self.assertEqual(ar2.ndim, 1)
+            self.assertEqual(ar2.shape, (w,))
+            self.assertEqual(ar2.strides, (bpp,))
+
+    def test_self_assign(self):
+        # This differs from NumPy arrays.
+        w = 10
+        max_x = w - 1
+        h = 20
+        max_y = h - 1
+        for bpp in [1, 2, 3, 4]:
+            sf = pygame.Surface((w, h), 0, bpp * 8)
+            ar = pygame.PixelArray(sf)
+            for i in range(w * h):
+                ar[i % w, i // w] = i
+            ar[:, :] = ar[::-1, :]
+            for i in range(w * h):
+                self.assertEqual(ar[max_x - i % w, i // w], i)
+            ar = pygame.PixelArray(sf)
+            for i in range(w * h):
+                ar[i % w, i // w] = i
+            ar[:, :] = ar[:, ::-1]
+            for i in range(w * h):
+                self.assertEqual(ar[i % w, max_y - i // w], i)
+            ar = pygame.PixelArray(sf)
+            for i in range(w * h):
+                ar[i % w, i // w] = i
+            ar[:, :] = ar[::-1, ::-1]
+            for i in range(w * h):
+                self.assertEqual(ar[max_x - i % w, max_y - i // w], i)
+
+    def test_color_value(self):
+        # Confirm that a PixelArray slice assignment distinguishes between
+        # pygame.Color and tuple objects as single (r, g, b[, a]) colors
+        # and other sequences as sequences of colors to be treated as
+        # slices.
+        sf = pygame.Surface((5, 5), 0, 32)
+        ar = pygame.PixelArray(sf)
+        index = slice(None, None, 1)
+        ar.__setitem__(index, (1, 2, 3))
+        self.assertEqual(ar[0, 0], sf.map_rgb((1, 2, 3)))
+        ar.__setitem__(index, pygame.Color(10, 11, 12))
+        self.assertEqual(ar[0, 0], sf.map_rgb((10, 11, 12)))
+        self.assertRaises(ValueError, ar.__setitem__, index, (1, 2, 3, 4, 5))
+        self.assertRaises(ValueError, ar.__setitem__, (index, index), (1, 2, 3, 4, 5))
+        self.assertRaises(ValueError, ar.__setitem__, index, [1, 2, 3])
+        self.assertRaises(ValueError, ar.__setitem__, (index, index), [1, 2, 3])
+        sf = pygame.Surface((3, 3), 0, 32)
+        ar = pygame.PixelArray(sf)
+        ar[:] = (20, 30, 40)
+        self.assertEqual(ar[0, 0], sf.map_rgb((20, 30, 40)))
+        ar[:] = [20, 30, 40]
+        self.assertEqual(ar[0, 0], 20)
+        self.assertEqual(ar[1, 0], 30)
+        self.assertEqual(ar[2, 0], 40)
+
+    def test_transpose(self):
+        # PixelArray.transpose(): swap axis on a 2D array, add a length
+        # 1 x axis to a 1D array.
+        sf = pygame.Surface((3, 7), 0, 32)
+        ar = pygame.PixelArray(sf)
+        w, h = ar.shape
+        dx, dy = ar.strides
+        for i in range(w * h):
+            x = i % w
+            y = i // w
+            ar[x, y] = i
+        ar_t = ar.transpose()
+        self.assertEqual(ar_t.shape, (h, w))
+        self.assertEqual(ar_t.strides, (dy, dx))
+        for i in range(w * h):
+            x = i % w
+            y = i // w
+            self.assertEqual(ar_t[y, x], ar[x, y])
+        ar1D = ar[0]
+        ar2D = ar1D.transpose()
+        self.assertEqual(ar2D.shape, (1, h))
+        for y in range(h):
+            self.assertEqual(ar1D[y], ar2D[0, y])
+        ar1D = ar[:, 0]
+        ar2D = ar1D.transpose()
+        self.assertEqual(ar2D.shape, (1, w))
+        for x in range(2):
+            self.assertEqual(ar1D[x], ar2D[0, x])
+
+    def test_length_1_dimension_broadcast(self):
+        w = 5
+        sf = pygame.Surface((w, w), 0, 32)
+        ar = pygame.PixelArray(sf)
+        # y-axis broadcast.
+        sf_x = pygame.Surface((w, 1), 0, 32)
+        ar_x = pygame.PixelArray(sf_x)
+        for i in range(w):
+            ar_x[i, 0] = (w + 1) * 10
+        ar[...] = ar_x
+        for y in range(w):
+            for x in range(w):
+                self.assertEqual(ar[x, y], ar_x[x, 0])
+        # x-axis broadcast.
+        ar[...] = 0
+        sf_y = pygame.Surface((1, w), 0, 32)
+        ar_y = pygame.PixelArray(sf_y)
+        for i in range(w):
+            ar_y[0, i] = (w + 1) * 10
+        ar[...] = ar_y
+        for x in range(w):
+            for y in range(w):
+                self.assertEqual(ar[x, y], ar_y[0, y])
+        # (1, 1) array broadcast.
+        ar[...] = 0
+        sf_1px = pygame.Surface((1, 1), 0, 32)
+        ar_1px = pygame.PixelArray(sf_1px)
+        ar_1px[0, 0] = 42  # Well it had to show up somewhere.
+        ar[...] = ar_1px
+        for y in range(w):
+            for x in range(w):
+                self.assertEqual(ar[x, y], 42)
+
+    def test_assign_size_mismatch(self):
+        sf = pygame.Surface((7, 11), 0, 32)
+        ar = pygame.PixelArray(sf)
+        self.assertRaises(ValueError, ar.__setitem__, Ellipsis, ar[:, 0:2])
+        self.assertRaises(ValueError, ar.__setitem__, Ellipsis, ar[0:2, :])
+
+    def test_repr(self):
+        # Python 3.x bug: the tp_repr slot function returned NULL instead
+        # of a Unicode string, triggering an exception.
+        sf = pygame.Surface((3, 1), pygame.SRCALPHA, 16)
+        ar = pygame.PixelArray(sf)
+        ar[...] = 42
+        pixel = sf.get_at_mapped((0, 0))
+        self.assertEqual(repr(ar), type(ar).__name__ + "([\n  [42, 42, 42]]\n)")
+
+
+@unittest.skipIf(IS_PYPY, "pypy having issues")
+class PixelArrayArrayInterfaceTest(unittest.TestCase, TestMixin):
+    @unittest.skipIf(IS_PYPY, "skipping for PyPy (why?)")
+    def test_basic(self):
+        # Check unchanging fields.
+        sf = pygame.Surface((2, 2), 0, 32)
+        ar = pygame.PixelArray(sf)
+
+        ai = arrinter.ArrayInterface(ar)
+        self.assertEqual(ai.two, 2)
+        self.assertEqual(ai.typekind, "u")
+        self.assertEqual(ai.nd, 2)
+        self.assertEqual(ai.data, ar._pixels_address)
+
+    @unittest.skipIf(IS_PYPY, "skipping for PyPy (why?)")
+    def test_shape(self):
+        for shape in [[4, 16], [5, 13]]:
+            w, h = shape
+            sf = pygame.Surface(shape, 0, 32)
+            ar = pygame.PixelArray(sf)
+            ai = arrinter.ArrayInterface(ar)
+            ai_shape = [ai.shape[i] for i in range(ai.nd)]
+            self.assertEqual(ai_shape, shape)
+            ar2 = ar[::2, :]
+            ai2 = arrinter.ArrayInterface(ar2)
+            w2 = len(([0] * w)[::2])
+            ai_shape = [ai2.shape[i] for i in range(ai2.nd)]
+            self.assertEqual(ai_shape, [w2, h])
+            ar2 = ar[:, ::2]
+            ai2 = arrinter.ArrayInterface(ar2)
+            h2 = len(([0] * h)[::2])
+            ai_shape = [ai2.shape[i] for i in range(ai2.nd)]
+            self.assertEqual(ai_shape, [w, h2])
+
+    @unittest.skipIf(IS_PYPY, "skipping for PyPy (why?)")
+    def test_itemsize(self):
+        for bytes_per_pixel in range(1, 5):
+            bits_per_pixel = 8 * bytes_per_pixel
+            sf = pygame.Surface((2, 2), 0, bits_per_pixel)
+            ar = pygame.PixelArray(sf)
+            ai = arrinter.ArrayInterface(ar)
+            self.assertEqual(ai.itemsize, bytes_per_pixel)
+
+    @unittest.skipIf(IS_PYPY, "skipping for PyPy (why?)")
+    def test_flags(self):
+        aim = arrinter
+        common_flags = aim.PAI_NOTSWAPPED | aim.PAI_WRITEABLE | aim.PAI_ALIGNED
+        s = pygame.Surface((10, 2), 0, 32)
+        ar = pygame.PixelArray(s)
+        ai = aim.ArrayInterface(ar)
+        self.assertEqual(ai.flags, common_flags | aim.PAI_FORTRAN)
+
+        ar2 = ar[::2, :]
+        ai = aim.ArrayInterface(ar2)
+        self.assertEqual(ai.flags, common_flags)
+
+        s = pygame.Surface((8, 2), 0, 24)
+        ar = pygame.PixelArray(s)
+        ai = aim.ArrayInterface(ar)
+        self.assertEqual(ai.flags, common_flags | aim.PAI_FORTRAN)
+
+        s = pygame.Surface((7, 2), 0, 24)
+        ar = pygame.PixelArray(s)
+        ai = aim.ArrayInterface(ar)
+        self.assertEqual(ai.flags, common_flags)
+
+    def test_slicing(self):
+        # This will implicitly test data and strides fields.
+        #
+        # Need an 8 bit test surfaces because pixelcopy.make_surface
+        # returns an 8 bit surface for a 2d array.
+
+        factors = [7, 3, 11]
+
+        w = reduce(operator.mul, factors, 1)
+        h = 13
+        sf = pygame.Surface((w, h), 0, 8)
+        color = sf.map_rgb((1, 17, 128))
+        ar = pygame.PixelArray(sf)
+        for f in factors[:-1]:
+            w = w // f
+            sf.fill((0, 0, 0))
+            ar = ar[f : f + w, :]
+            ar[0][0] = color
+            ar[-1][-2] = color
+            ar[0][-3] = color
+            sf2 = ar.make_surface()
+            sf3 = pygame.pixelcopy.make_surface(ar)
+            self.assert_surfaces_equal(sf3, sf2)
+
+        h = reduce(operator.mul, factors, 1)
+        w = 13
+        sf = pygame.Surface((w, h), 0, 8)
+        color = sf.map_rgb((1, 17, 128))
+        ar = pygame.PixelArray(sf)
+        for f in factors[:-1]:
+            h = h // f
+            sf.fill((0, 0, 0))
+            ar = ar[:, f : f + h]
+            ar[0][0] = color
+            ar[-1][-2] = color
+            ar[0][-3] = color
+            sf2 = ar.make_surface()
+            sf3 = pygame.pixelcopy.make_surface(ar)
+            self.assert_surfaces_equal(sf3, sf2)
+
+        w = 20
+        h = 10
+        sf = pygame.Surface((w, h), 0, 8)
+        color = sf.map_rgb((1, 17, 128))
+        ar = pygame.PixelArray(sf)
+        for slices in [
+            (slice(w), slice(h)),
+            (slice(0, w, 2), slice(h)),
+            (slice(0, w, 3), slice(h)),
+            (slice(w), slice(0, h, 2)),
+            (slice(w), slice(0, h, 3)),
+            (slice(0, w, 2), slice(0, h, 2)),
+            (slice(0, w, 3), slice(0, h, 3)),
+        ]:
+            sf.fill((0, 0, 0))
+            ar2 = ar[slices]
+            ar2[0][0] = color
+            ar2[-1][-2] = color
+            ar2[0][-3] = color
+            sf2 = ar2.make_surface()
+            sf3 = pygame.pixelcopy.make_surface(ar2)
+            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):
+    if pygame.HAVE_NEWBUF:
+        from pygame.tests.test_utils import buftools
+
+    bitsize_to_format = {8: "B", 16: "=H", 24: "3x", 32: "=I"}
+
+    def test_newbuf_2D(self):
+        buftools = self.buftools
+        Importer = buftools.Importer
+
+        for bit_size in [8, 16, 24, 32]:
+            s = pygame.Surface((10, 2), 0, bit_size)
+            ar = pygame.PixelArray(s)
+            format = self.bitsize_to_format[bit_size]
+            itemsize = ar.itemsize
+            shape = ar.shape
+            w, h = shape
+            strides = ar.strides
+            length = w * h * itemsize
+            imp = Importer(ar, buftools.PyBUF_FULL)
+            self.assertTrue(imp.obj, ar)
+            self.assertEqual(imp.len, length)
+            self.assertEqual(imp.ndim, 2)
+            self.assertEqual(imp.itemsize, itemsize)
+            self.assertEqual(imp.format, format)
+            self.assertFalse(imp.readonly)
+            self.assertEqual(imp.shape, shape)
+            self.assertEqual(imp.strides, strides)
+            self.assertTrue(imp.suboffsets is None)
+            self.assertEqual(imp.buf, s._pixels_address)
+
+        s = pygame.Surface((8, 16), 0, 32)
+        ar = pygame.PixelArray(s)
+        format = self.bitsize_to_format[s.get_bitsize()]
+        itemsize = ar.itemsize
+        shape = ar.shape
+        w, h = shape
+        strides = ar.strides
+        length = w * h * itemsize
+        imp = Importer(ar, buftools.PyBUF_SIMPLE)
+        self.assertTrue(imp.obj, ar)
+        self.assertEqual(imp.len, length)
+        self.assertEqual(imp.ndim, 0)
+        self.assertEqual(imp.itemsize, itemsize)
+        self.assertTrue(imp.format is None)
+        self.assertFalse(imp.readonly)
+        self.assertTrue(imp.shape is None)
+        self.assertTrue(imp.strides is None)
+        self.assertTrue(imp.suboffsets is None)
+        self.assertEqual(imp.buf, s._pixels_address)
+        imp = Importer(ar, buftools.PyBUF_FORMAT)
+        self.assertEqual(imp.ndim, 0)
+        self.assertEqual(imp.format, format)
+        imp = Importer(ar, buftools.PyBUF_WRITABLE)
+        self.assertEqual(imp.ndim, 0)
+        self.assertTrue(imp.format is None)
+        imp = Importer(ar, buftools.PyBUF_F_CONTIGUOUS)
+        self.assertEqual(imp.ndim, 2)
+        self.assertTrue(imp.format is None)
+        self.assertEqual(imp.shape, shape)
+        self.assertEqual(imp.strides, strides)
+        imp = Importer(ar, buftools.PyBUF_ANY_CONTIGUOUS)
+        self.assertEqual(imp.ndim, 2)
+        self.assertTrue(imp.format is None)
+        self.assertEqual(imp.shape, shape)
+        self.assertEqual(imp.strides, strides)
+        self.assertRaises(BufferError, Importer, ar, buftools.PyBUF_C_CONTIGUOUS)
+        self.assertRaises(BufferError, Importer, ar, buftools.PyBUF_ND)
+
+        ar_sliced = ar[:, ::2]
+        format = self.bitsize_to_format[s.get_bitsize()]
+        itemsize = ar_sliced.itemsize
+        shape = ar_sliced.shape
+        w, h = shape
+        strides = ar_sliced.strides
+        length = w * h * itemsize
+        imp = Importer(ar_sliced, buftools.PyBUF_STRIDED)
+        self.assertEqual(imp.len, length)
+        self.assertEqual(imp.ndim, 2)
+        self.assertEqual(imp.itemsize, itemsize)
+        self.assertTrue(imp.format is None)
+        self.assertFalse(imp.readonly)
+        self.assertEqual(imp.shape, shape)
+        self.assertEqual(imp.strides, strides)
+        self.assertEqual(imp.buf, s._pixels_address)
+        self.assertRaises(BufferError, Importer, ar_sliced, buftools.PyBUF_SIMPLE)
+        self.assertRaises(BufferError, Importer, ar_sliced, buftools.PyBUF_ND)
+        self.assertRaises(BufferError, Importer, ar_sliced, buftools.PyBUF_C_CONTIGUOUS)
+        self.assertRaises(BufferError, Importer, ar_sliced, buftools.PyBUF_F_CONTIGUOUS)
+        self.assertRaises(
+            BufferError, Importer, ar_sliced, buftools.PyBUF_ANY_CONTIGUOUS
+        )
+
+        ar_sliced = ar[::2, :]
+        format = self.bitsize_to_format[s.get_bitsize()]
+        itemsize = ar_sliced.itemsize
+        shape = ar_sliced.shape
+        w, h = shape
+        strides = ar_sliced.strides
+        length = w * h * itemsize
+        imp = Importer(ar_sliced, buftools.PyBUF_STRIDED)
+        self.assertEqual(imp.len, length)
+        self.assertEqual(imp.ndim, 2)
+        self.assertEqual(imp.itemsize, itemsize)
+        self.assertTrue(imp.format is None)
+        self.assertFalse(imp.readonly)
+        self.assertEqual(imp.shape, shape)
+        self.assertEqual(imp.strides, strides)
+        self.assertEqual(imp.buf, s._pixels_address)
+        self.assertRaises(BufferError, Importer, ar_sliced, buftools.PyBUF_SIMPLE)
+        self.assertRaises(BufferError, Importer, ar_sliced, buftools.PyBUF_ND)
+        self.assertRaises(BufferError, Importer, ar_sliced, buftools.PyBUF_C_CONTIGUOUS)
+        self.assertRaises(BufferError, Importer, ar_sliced, buftools.PyBUF_F_CONTIGUOUS)
+        self.assertRaises(
+            BufferError, Importer, ar_sliced, buftools.PyBUF_ANY_CONTIGUOUS
+        )
+
+        s2 = s.subsurface((2, 3, 5, 7))
+        ar = pygame.PixelArray(s2)
+        format = self.bitsize_to_format[s.get_bitsize()]
+        itemsize = ar.itemsize
+        shape = ar.shape
+        w, h = shape
+        strides = ar.strides
+        length = w * h * itemsize
+        imp = Importer(ar, buftools.PyBUF_STRIDES)
+        self.assertTrue(imp.obj, ar)
+        self.assertEqual(imp.len, length)
+        self.assertEqual(imp.ndim, 2)
+        self.assertEqual(imp.itemsize, itemsize)
+        self.assertTrue(imp.format is None)
+        self.assertFalse(imp.readonly)
+        self.assertEqual(imp.shape, shape)
+        self.assertEqual(imp.strides, strides)
+        self.assertTrue(imp.suboffsets is None)
+        self.assertEqual(imp.buf, s2._pixels_address)
+        self.assertRaises(BufferError, Importer, ar, buftools.PyBUF_SIMPLE)
+        self.assertRaises(BufferError, Importer, ar, buftools.PyBUF_FORMAT)
+        self.assertRaises(BufferError, Importer, ar, buftools.PyBUF_WRITABLE)
+        self.assertRaises(BufferError, Importer, ar, buftools.PyBUF_ND)
+        self.assertRaises(BufferError, Importer, ar, buftools.PyBUF_C_CONTIGUOUS)
+        self.assertRaises(BufferError, Importer, ar, buftools.PyBUF_F_CONTIGUOUS)
+        self.assertRaises(BufferError, Importer, ar, buftools.PyBUF_ANY_CONTIGUOUS)
+
+    def test_newbuf_1D(self):
+        buftools = self.buftools
+        Importer = buftools.Importer
+
+        s = pygame.Surface((2, 16), 0, 32)
+        ar_2D = pygame.PixelArray(s)
+        x = 0
+        ar = ar_2D[x]
+        format = self.bitsize_to_format[s.get_bitsize()]
+        itemsize = ar.itemsize
+        shape = ar.shape
+        h = shape[0]
+        strides = ar.strides
+        length = h * itemsize
+        buf = s._pixels_address + x * itemsize
+        imp = Importer(ar, buftools.PyBUF_STRIDES)
+        self.assertTrue(imp.obj, ar)
+        self.assertEqual(imp.len, length)
+        self.assertEqual(imp.ndim, 1)
+        self.assertEqual(imp.itemsize, itemsize)
+        self.assertTrue(imp.format is None)
+        self.assertFalse(imp.readonly)
+        self.assertEqual(imp.shape, shape)
+        self.assertEqual(imp.strides, strides)
+        self.assertTrue(imp.suboffsets is None)
+        self.assertEqual(imp.buf, buf)
+        imp = Importer(ar, buftools.PyBUF_FULL)
+        self.assertEqual(imp.ndim, 1)
+        self.assertEqual(imp.format, format)
+        self.assertRaises(BufferError, Importer, ar, buftools.PyBUF_SIMPLE)
+        self.assertRaises(BufferError, Importer, ar, buftools.PyBUF_FORMAT)
+        self.assertRaises(BufferError, Importer, ar, buftools.PyBUF_WRITABLE)
+        self.assertRaises(BufferError, Importer, ar, buftools.PyBUF_ND)
+        self.assertRaises(BufferError, Importer, ar, buftools.PyBUF_C_CONTIGUOUS)
+        self.assertRaises(BufferError, Importer, ar, buftools.PyBUF_F_CONTIGUOUS)
+        self.assertRaises(BufferError, Importer, ar, buftools.PyBUF_ANY_CONTIGUOUS)
+        y = 10
+        ar = ar_2D[:, y]
+        shape = ar.shape
+        w = shape[0]
+        strides = ar.strides
+        length = w * itemsize
+        buf = s._pixels_address + y * s.get_pitch()
+        imp = Importer(ar, buftools.PyBUF_FULL)
+        self.assertEqual(imp.len, length)
+        self.assertEqual(imp.ndim, 1)
+        self.assertEqual(imp.itemsize, itemsize)
+        self.assertEqual(imp.format, format)
+        self.assertFalse(imp.readonly)
+        self.assertEqual(imp.shape, shape)
+        self.assertEqual(imp.strides, strides)
+        self.assertEqual(imp.buf, buf)
+        self.assertTrue(imp.suboffsets is None)
+        imp = Importer(ar, buftools.PyBUF_SIMPLE)
+        self.assertEqual(imp.len, length)
+        self.assertEqual(imp.ndim, 0)
+        self.assertEqual(imp.itemsize, itemsize)
+        self.assertTrue(imp.format is None)
+        self.assertFalse(imp.readonly)
+        self.assertTrue(imp.shape is None)
+        self.assertTrue(imp.strides is None)
+        imp = Importer(ar, buftools.PyBUF_ND)
+        self.assertEqual(imp.len, length)
+        self.assertEqual(imp.ndim, 1)
+        self.assertEqual(imp.itemsize, itemsize)
+        self.assertTrue(imp.format is None)
+        self.assertFalse(imp.readonly)
+        self.assertEqual(imp.shape, shape)
+        self.assertTrue(imp.strides is None)
+        imp = Importer(ar, buftools.PyBUF_C_CONTIGUOUS)
+        self.assertEqual(imp.ndim, 1)
+        imp = Importer(ar, buftools.PyBUF_F_CONTIGUOUS)
+        self.assertEqual(imp.ndim, 1)
+        imp = Importer(ar, buftools.PyBUF_ANY_CONTIGUOUS)
+        self.assertEqual(imp.ndim, 1)
+
+
+if __name__ == "__main__":
+    unittest.main()
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/pixelcopy_test.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/pixelcopy_test.py
new file mode 100644
index 0000000..46051cd
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/pixelcopy_test.py
@@ -0,0 +1,710 @@
+import platform
+import unittest
+
+try:
+    from pygame.tests.test_utils import arrinter
+except NameError:
+    pass
+import pygame
+from pygame.locals import *
+from pygame.pixelcopy import surface_to_array, map_array, array_to_surface, make_surface
+
+IS_PYPY = "PyPy" == platform.python_implementation()
+
+
+def unsigned32(i):
+    """cast signed 32 bit integer to an unsigned integer"""
+    return i & 0xFFFFFFFF
+
+
+@unittest.skipIf(IS_PYPY, "pypy having illegal instruction on mac")
+class PixelcopyModuleTest(unittest.TestCase):
+    bitsizes = [8, 16, 32]
+
+    test_palette = [
+        (0, 0, 0, 255),
+        (10, 30, 60, 255),
+        (25, 75, 100, 255),
+        (100, 150, 200, 255),
+        (0, 100, 200, 255),
+    ]
+
+    surf_size = (10, 12)
+    test_points = [
+        ((0, 0), 1),
+        ((4, 5), 1),
+        ((9, 0), 2),
+        ((5, 5), 2),
+        ((0, 11), 3),
+        ((4, 6), 3),
+        ((9, 11), 4),
+        ((5, 6), 4),
+    ]
+
+    def __init__(self, *args, **kwds):
+        pygame.display.init()
+        try:
+            unittest.TestCase.__init__(self, *args, **kwds)
+            self.sources = [
+                self._make_src_surface(8),
+                self._make_src_surface(16),
+                self._make_src_surface(16, srcalpha=True),
+                self._make_src_surface(24),
+                self._make_src_surface(32),
+                self._make_src_surface(32, srcalpha=True),
+            ]
+        finally:
+            pygame.display.quit()
+
+    def _make_surface(self, bitsize, srcalpha=False, palette=None):
+        if palette is None:
+            palette = self.test_palette
+        flags = 0
+        if srcalpha:
+            flags |= SRCALPHA
+        surf = pygame.Surface(self.surf_size, flags, bitsize)
+        if bitsize == 8:
+            surf.set_palette([c[:3] for c in palette])
+        return surf
+
+    def _fill_surface(self, surf, palette=None):
+        if palette is None:
+            palette = self.test_palette
+        surf.fill(palette[1], (0, 0, 5, 6))
+        surf.fill(palette[2], (5, 0, 5, 6))
+        surf.fill(palette[3], (0, 6, 5, 6))
+        surf.fill(palette[4], (5, 6, 5, 6))
+
+    def _make_src_surface(self, bitsize, srcalpha=False, palette=None):
+        surf = self._make_surface(bitsize, srcalpha, palette)
+        self._fill_surface(surf, palette)
+        return surf
+
+    def setUp(self):
+        pygame.display.init()
+
+    def tearDown(self):
+        pygame.display.quit()
+
+    def test_surface_to_array_2d(self):
+        alpha_color = (0, 0, 0, 128)
+
+        for surf in self.sources:
+            src_bitsize = surf.get_bitsize()
+            for dst_bitsize in self.bitsizes:
+                # dst in a surface standing in for a 2 dimensional array
+                # of unsigned integers. The byte order is system dependent.
+                dst = pygame.Surface(surf.get_size(), 0, dst_bitsize)
+                dst.fill((0, 0, 0, 0))
+                view = dst.get_view("2")
+                self.assertFalse(surf.get_locked())
+                if dst_bitsize < src_bitsize:
+                    self.assertRaises(ValueError, surface_to_array, view, surf)
+                    self.assertFalse(surf.get_locked())
+                    continue
+                surface_to_array(view, surf)
+                self.assertFalse(surf.get_locked())
+                for posn, i in self.test_points:
+                    sp = surf.get_at_mapped(posn)
+                    dp = dst.get_at_mapped(posn)
+                    self.assertEqual(
+                        dp,
+                        sp,
+                        "%s != %s: flags: %i"
+                        ", bpp: %i, posn: %s"
+                        % (dp, sp, surf.get_flags(), surf.get_bitsize(), posn),
+                    )
+                del view
+
+                if surf.get_masks()[3]:
+                    dst.fill((0, 0, 0, 0))
+                    view = dst.get_view("2")
+                    posn = (2, 1)
+                    surf.set_at(posn, alpha_color)
+                    self.assertFalse(surf.get_locked())
+                    surface_to_array(view, surf)
+                    self.assertFalse(surf.get_locked())
+                    sp = surf.get_at_mapped(posn)
+                    dp = dst.get_at_mapped(posn)
+                    self.assertEqual(
+                        dp, sp, "%s != %s: bpp: %i" % (dp, sp, surf.get_bitsize())
+                    )
+
+        if IS_PYPY:
+            return
+        # Swapped endian destination array
+        pai_flags = arrinter.PAI_ALIGNED | arrinter.PAI_WRITEABLE
+        for surf in self.sources:
+            for itemsize in [1, 2, 4, 8]:
+                if itemsize < surf.get_bytesize():
+                    continue
+                a = arrinter.Array(surf.get_size(), "u", itemsize, flags=pai_flags)
+                surface_to_array(a, surf)
+                for posn, i in self.test_points:
+                    sp = unsigned32(surf.get_at_mapped(posn))
+                    dp = a[posn]
+                    self.assertEqual(
+                        dp,
+                        sp,
+                        "%s != %s: itemsize: %i, flags: %i"
+                        ", bpp: %i, posn: %s"
+                        % (
+                            dp,
+                            sp,
+                            itemsize,
+                            surf.get_flags(),
+                            surf.get_bitsize(),
+                            posn,
+                        ),
+                    )
+
+    def test_surface_to_array_3d(self):
+        self.iter_surface_to_array_3d((0xFF, 0xFF00, 0xFF0000, 0))
+        self.iter_surface_to_array_3d((0xFF0000, 0xFF00, 0xFF, 0))
+
+    def iter_surface_to_array_3d(self, rgba_masks):
+        dst = pygame.Surface(self.surf_size, 0, 24, masks=rgba_masks)
+
+        for surf in self.sources:
+            dst.fill((0, 0, 0, 0))
+            src_bitsize = surf.get_bitsize()
+            view = dst.get_view("3")
+            self.assertFalse(surf.get_locked())
+            surface_to_array(view, surf)
+            self.assertFalse(surf.get_locked())
+            for posn, i in self.test_points:
+                sc = surf.get_at(posn)[0:3]
+                dc = dst.get_at(posn)[0:3]
+                self.assertEqual(
+                    dc,
+                    sc,
+                    "%s != %s: flags: %i"
+                    ", bpp: %i, posn: %s"
+                    % (dc, sc, surf.get_flags(), surf.get_bitsize(), posn),
+                )
+            view = None
+
+    def test_map_array(self):
+        targets = [
+            self._make_surface(8),
+            self._make_surface(16),
+            self._make_surface(16, srcalpha=True),
+            self._make_surface(24),
+            self._make_surface(32),
+            self._make_surface(32, srcalpha=True),
+        ]
+        source = pygame.Surface(
+            self.surf_size, 0, 24, masks=[0xFF, 0xFF00, 0xFF0000, 0]
+        )
+        self._fill_surface(source)
+        source_view = source.get_view("3")  # (w, h, 3)
+        for t in targets:
+            map_array(t.get_view("2"), source_view, t)
+            for posn, i in self.test_points:
+                sc = t.map_rgb(source.get_at(posn))
+                dc = t.get_at_mapped(posn)
+                self.assertEqual(
+                    dc,
+                    sc,
+                    "%s != %s: flags: %i"
+                    ", bpp: %i, posn: %s"
+                    % (dc, sc, t.get_flags(), t.get_bitsize(), posn),
+                )
+
+        color = pygame.Color("salmon")
+        color.set_length(3)
+        for t in targets:
+            map_array(t.get_view("2"), color, t)
+            sc = t.map_rgb(color)
+            for posn, i in self.test_points:
+                dc = t.get_at_mapped(posn)
+                self.assertEqual(
+                    dc,
+                    sc,
+                    "%s != %s: flags: %i"
+                    ", bpp: %i, posn: %s"
+                    % (dc, sc, t.get_flags(), t.get_bitsize(), posn),
+                )
+
+        # mismatched shapes
+        w, h = source.get_size()
+        target = pygame.Surface((w, h + 1), 0, 32)
+        self.assertRaises(ValueError, map_array, target, source, target)
+        target = pygame.Surface((w - 1, h), 0, 32)
+        self.assertRaises(ValueError, map_array, target, source, target)
+
+    def test_array_to_surface_broadcasting(self):
+        # target surfaces
+        targets = [
+            self._make_surface(8),
+            self._make_surface(16),
+            self._make_surface(16, srcalpha=True),
+            self._make_surface(24),
+            self._make_surface(32),
+            self._make_surface(32, srcalpha=True),
+        ]
+
+        w, h = self.surf_size
+
+        # broadcast column
+        column = pygame.Surface((1, h), 0, 32)
+        for target in targets:
+            source = pygame.Surface((1, h), 0, target)
+            for y in range(h):
+                source.set_at((0, y), pygame.Color(y + 1, y + h + 1, y + 2 * h + 1))
+            pygame.pixelcopy.surface_to_array(column.get_view("2"), source)
+            pygame.pixelcopy.array_to_surface(target, column.get_view("2"))
+            for x in range(w):
+                for y in range(h):
+                    self.assertEqual(
+                        target.get_at_mapped((x, y)), column.get_at_mapped((0, y))
+                    )
+
+        # broadcast row
+        row = pygame.Surface((w, 1), 0, 32)
+        for target in targets:
+            source = pygame.Surface((w, 1), 0, target)
+            for x in range(w):
+                source.set_at((x, 0), pygame.Color(x + 1, x + w + 1, x + 2 * w + 1))
+            pygame.pixelcopy.surface_to_array(row.get_view("2"), source)
+            pygame.pixelcopy.array_to_surface(target, row.get_view("2"))
+            for x in range(w):
+                for y in range(h):
+                    self.assertEqual(
+                        target.get_at_mapped((x, y)), row.get_at_mapped((x, 0))
+                    )
+
+        # broadcast pixel
+        pixel = pygame.Surface((1, 1), 0, 32)
+        for target in targets:
+            source = pygame.Surface((1, 1), 0, target)
+            source.set_at((0, 0), pygame.Color(13, 47, 101))
+            pygame.pixelcopy.surface_to_array(pixel.get_view("2"), source)
+            pygame.pixelcopy.array_to_surface(target, pixel.get_view("2"))
+            p = pixel.get_at_mapped((0, 0))
+            for x in range(w):
+                for y in range(h):
+                    self.assertEqual(target.get_at_mapped((x, y)), p)
+
+
+@unittest.skipIf(IS_PYPY, "pypy having illegal instruction on mac")
+class PixelCopyTestWithArrayNumpy(unittest.TestCase):
+    try:
+        import numpy
+    except ImportError:
+        __tags__ = ["ignore", "subprocess_ignore"]
+    else:
+        pygame.surfarray.use_arraytype("numpy")
+
+    bitsizes = [8, 16, 32]
+
+    test_palette = [
+        (0, 0, 0, 255),
+        (10, 30, 60, 255),
+        (25, 75, 100, 255),
+        (100, 150, 200, 255),
+        (0, 100, 200, 255),
+    ]
+
+    surf_size = (10, 12)
+    test_points = [
+        ((0, 0), 1),
+        ((4, 5), 1),
+        ((9, 0), 2),
+        ((5, 5), 2),
+        ((0, 11), 3),
+        ((4, 6), 3),
+        ((9, 11), 4),
+        ((5, 6), 4),
+    ]
+
+    pixels2d = {8, 16, 32}
+    pixels3d = {24, 32}
+    array2d = {8, 16, 24, 32}
+    array3d = {24, 32}
+
+    def __init__(self, *args, **kwds):
+        import numpy
+
+        self.dst_types = [numpy.uint8, numpy.uint16, numpy.uint32]
+        try:
+            self.dst_types.append(numpy.uint64)
+        except AttributeError:
+            pass
+        pygame.display.init()
+        try:
+            unittest.TestCase.__init__(self, *args, **kwds)
+            self.sources = [
+                self._make_src_surface(8),
+                self._make_src_surface(16),
+                self._make_src_surface(16, srcalpha=True),
+                self._make_src_surface(24),
+                self._make_src_surface(32),
+                self._make_src_surface(32, srcalpha=True),
+            ]
+        finally:
+            pygame.display.quit()
+
+    def _make_surface(self, bitsize, srcalpha=False, palette=None):
+        if palette is None:
+            palette = self.test_palette
+        flags = 0
+        if srcalpha:
+            flags |= SRCALPHA
+        surf = pygame.Surface(self.surf_size, flags, bitsize)
+        if bitsize == 8:
+            surf.set_palette([c[:3] for c in palette])
+        return surf
+
+    def _fill_surface(self, surf, palette=None):
+        if palette is None:
+            palette = self.test_palette
+        surf.fill(palette[1], (0, 0, 5, 6))
+        surf.fill(palette[2], (5, 0, 5, 6))
+        surf.fill(palette[3], (0, 6, 5, 6))
+        surf.fill(palette[4], (5, 6, 5, 6))
+
+    def _make_src_surface(self, bitsize, srcalpha=False, palette=None):
+        surf = self._make_surface(bitsize, srcalpha, palette)
+        self._fill_surface(surf, palette)
+        return surf
+
+    def setUp(self):
+        pygame.display.init()
+
+    def tearDown(self):
+        pygame.display.quit()
+
+    def test_surface_to_array_2d(self):
+        try:
+            from numpy import empty, dtype
+        except ImportError:
+            return
+
+        palette = self.test_palette
+        alpha_color = (0, 0, 0, 128)
+
+        dst_dims = self.surf_size
+        destinations = [empty(dst_dims, t) for t in self.dst_types]
+        if pygame.get_sdl_byteorder() == pygame.LIL_ENDIAN:
+            swapped_dst = empty(dst_dims, dtype(">u4"))
+        else:
+            swapped_dst = empty(dst_dims, dtype("u4"))
+        else:
+            swapped_dst = empty(dst_dims, dtype("i",
+            "!i",
+            "1i",
+            "=1i",
+            "@q",
+            "q",
+            "4x",
+            "8x",
+        ]:
+            surface.fill((255, 254, 253))
+            exp = Exporter(shape, format=format)
+            exp._buf[:] = [42] * exp.buflen
+            array_to_surface(surface, exp)
+            for x in range(w):
+                for y in range(h):
+                    self.assertEqual(surface.get_at((x, y)), (42, 42, 42, 255))
+        # Some unsupported formats for array_to_surface and a 32 bit surface
+        for format in ["f", "d", "?", "x", "1x", "2x", "3x", "5x", "6x", "7x", "9x"]:
+            exp = Exporter(shape, format=format)
+            self.assertRaises(ValueError, array_to_surface, surface, exp)
+
+
+if __name__ == "__main__":
+    unittest.main()
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/rect_test.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/rect_test.py
new file mode 100644
index 0000000..71a7521
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/rect_test.py
@@ -0,0 +1,3312 @@
+import math
+import unittest
+from collections.abc import Collection, Sequence
+import platform
+import random
+
+from pygame import Rect, Vector2
+from pygame.tests import test_utils
+
+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 _assertCountEqual(self, *args, **kwargs):
+        self.assertCountEqual(*args, **kwargs)
+
+    def testConstructionXYWidthHeight(self):
+        r = Rect(1, 2, 3, 4)
+        self.assertEqual(1, r.left)
+        self.assertEqual(2, r.top)
+        self.assertEqual(3, r.width)
+        self.assertEqual(4, r.height)
+
+    def testConstructionTopLeftSize(self):
+        r = Rect((1, 2), (3, 4))
+        self.assertEqual(1, r.left)
+        self.assertEqual(2, r.top)
+        self.assertEqual(3, r.width)
+        self.assertEqual(4, r.height)
+
+    def testCalculatedAttributes(self):
+        r = Rect(1, 2, 3, 4)
+
+        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
+
+        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 test_rect_iter(self):
+        rect = Rect(50, 100, 150, 200)
+
+        # call __iter__ explicitly to test that it is defined
+        rect_iterator = rect.__iter__()
+        for i, val in enumerate(rect_iterator):
+            self.assertEqual(rect[i], val)
+
+    def test_normalize(self):
+        """Ensures normalize works when width and height are both negative."""
+        test_rect = Rect((1, 2), (-3, -6))
+        expected_normalized_rect = (
+            (test_rect.x + test_rect.w, test_rect.y + test_rect.h),
+            (-test_rect.w, -test_rect.h),
+        )
+
+        test_rect.normalize()
+
+        self.assertEqual(test_rect, expected_normalized_rect)
+
+    def test_normalize__positive_height(self):
+        """Ensures normalize works with a negative width and a positive height."""
+        test_rect = Rect((1, 2), (-3, 6))
+        expected_normalized_rect = (
+            (test_rect.x + test_rect.w, test_rect.y),
+            (-test_rect.w, test_rect.h),
+        )
+
+        test_rect.normalize()
+
+        self.assertEqual(test_rect, expected_normalized_rect)
+
+    def test_normalize__positive_width(self):
+        """Ensures normalize works with a positive width and a negative height."""
+        test_rect = Rect((1, 2), (3, -6))
+        expected_normalized_rect = (
+            (test_rect.x, test_rect.y + test_rect.h),
+            (test_rect.w, -test_rect.h),
+        )
+
+        test_rect.normalize()
+
+        self.assertEqual(test_rect, expected_normalized_rect)
+
+    def test_normalize__zero_height(self):
+        """Ensures normalize works with a negative width and a zero height."""
+        test_rect = Rect((1, 2), (-3, 0))
+        expected_normalized_rect = (
+            (test_rect.x + test_rect.w, test_rect.y),
+            (-test_rect.w, test_rect.h),
+        )
+
+        test_rect.normalize()
+
+        self.assertEqual(test_rect, expected_normalized_rect)
+
+    def test_normalize__zero_width(self):
+        """Ensures normalize works with a zero width and a negative height."""
+        test_rect = Rect((1, 2), (0, -6))
+        expected_normalized_rect = (
+            (test_rect.x, test_rect.y + test_rect.h),
+            (test_rect.w, -test_rect.h),
+        )
+
+        test_rect.normalize()
+
+        self.assertEqual(test_rect, expected_normalized_rect)
+
+    def test_normalize__non_negative(self):
+        """Ensures normalize works when width and height are both non-negative.
+
+        Tests combinations of positive and zero values for width and height.
+        The normalize method has no impact when both width and height are
+        non-negative.
+        """
+        for size in ((3, 6), (3, 0), (0, 6), (0, 0)):
+            test_rect = Rect((1, 2), size)
+            expected_normalized_rect = Rect(test_rect)
+
+            test_rect.normalize()
+
+            self.assertEqual(test_rect, expected_normalized_rect)
+
+    def test_x(self):
+        """Ensures changing the x attribute moves the rect and does not change
+        the rect's size.
+        """
+        expected_x = 10
+        expected_y = 2
+        expected_size = (3, 4)
+        r = Rect((1, expected_y), expected_size)
+
+        r.x = expected_x
+
+        self.assertEqual(r.x, expected_x)
+        self.assertEqual(r.x, r.left)
+        self.assertEqual(r.y, expected_y)
+        self.assertEqual(r.size, expected_size)
+
+    def test_x__invalid_value(self):
+        """Ensures the x attribute handles invalid values correctly."""
+        r = Rect(0, 0, 1, 1)
+
+        for value in (None, [], "1", (1,), [1, 2, 3]):
+            with self.assertRaises(TypeError):
+                r.x = value
+
+    def test_x__del(self):
+        """Ensures the x attribute can't be deleted."""
+        r = Rect(0, 0, 1, 1)
+
+        with self.assertRaises(AttributeError):
+            del r.x
+
+    def test_y(self):
+        """Ensures changing the y attribute moves the rect and does not change
+        the rect's size.
+        """
+        expected_x = 1
+        expected_y = 20
+        expected_size = (3, 4)
+        r = Rect((expected_x, 2), expected_size)
+
+        r.y = expected_y
+
+        self.assertEqual(r.y, expected_y)
+        self.assertEqual(r.y, r.top)
+        self.assertEqual(r.x, expected_x)
+        self.assertEqual(r.size, expected_size)
+
+    def test_y__invalid_value(self):
+        """Ensures the y attribute handles invalid values correctly."""
+        r = Rect(0, 0, 1, 1)
+
+        for value in (None, [], "1", (1,), [1, 2, 3]):
+            with self.assertRaises(TypeError):
+                r.y = value
+
+    def test_y__del(self):
+        """Ensures the y attribute can't be deleted."""
+        r = Rect(0, 0, 1, 1)
+
+        with self.assertRaises(AttributeError):
+            del r.y
+
+    def test_left(self):
+        """Changing the left attribute moves the rect and does not change
+        the rect's width
+        """
+        r = Rect(1, 2, 3, 4)
+        new_left = 10
+
+        r.left = new_left
+        self.assertEqual(new_left, r.left)
+        self.assertEqual(Rect(new_left, 2, 3, 4), r)
+
+    def test_left__invalid_value(self):
+        """Ensures the left attribute handles invalid values correctly."""
+        r = Rect(0, 0, 1, 1)
+
+        for value in (None, [], "1", (1,), [1, 2, 3]):
+            with self.assertRaises(TypeError):
+                r.left = value
+
+    def test_left__del(self):
+        """Ensures the left attribute can't be deleted."""
+        r = Rect(0, 0, 1, 1)
+
+        with self.assertRaises(AttributeError):
+            del r.left
+
+    def test_right(self):
+        """Changing the right attribute moves the rect and does not change
+        the rect's width
+        """
+        r = Rect(1, 2, 3, 4)
+        new_right = r.right + 20
+        expected_left = r.left + 20
+        old_width = r.width
+
+        r.right = new_right
+        self.assertEqual(new_right, r.right)
+        self.assertEqual(expected_left, r.left)
+        self.assertEqual(old_width, r.width)
+
+    def test_right__invalid_value(self):
+        """Ensures the right attribute handles invalid values correctly."""
+        r = Rect(0, 0, 1, 1)
+
+        for value in (None, [], "1", (1,), [1, 2, 3]):
+            with self.assertRaises(TypeError):
+                r.right = value
+
+    def test_right__del(self):
+        """Ensures the right attribute can't be deleted."""
+        r = Rect(0, 0, 1, 1)
+
+        with self.assertRaises(AttributeError):
+            del r.right
+
+    def test_top(self):
+        """Changing the top attribute moves the rect and does not change
+        the rect's width
+        """
+        r = Rect(1, 2, 3, 4)
+        new_top = 10
+
+        r.top = new_top
+        self.assertEqual(Rect(1, new_top, 3, 4), r)
+        self.assertEqual(new_top, r.top)
+
+    def test_top__invalid_value(self):
+        """Ensures the top attribute handles invalid values correctly."""
+        r = Rect(0, 0, 1, 1)
+
+        for value in (None, [], "1", (1,), [1, 2, 3]):
+            with self.assertRaises(TypeError):
+                r.top = value
+
+    def test_top__del(self):
+        """Ensures the top attribute can't be deleted."""
+        r = Rect(0, 0, 1, 1)
+
+        with self.assertRaises(AttributeError):
+            del r.top
+
+    def test_bottom(self):
+        """Changing the bottom attribute moves the rect and does not change
+        the rect's height
+        """
+        r = Rect(1, 2, 3, 4)
+        new_bottom = r.bottom + 20
+        expected_top = r.top + 20
+        old_height = r.height
+
+        r.bottom = new_bottom
+        self.assertEqual(new_bottom, r.bottom)
+        self.assertEqual(expected_top, r.top)
+        self.assertEqual(old_height, r.height)
+
+    def test_bottom__invalid_value(self):
+        """Ensures the bottom attribute handles invalid values correctly."""
+        r = Rect(0, 0, 1, 1)
+
+        for value in (None, [], "1", (1,), [1, 2, 3]):
+            with self.assertRaises(TypeError):
+                r.bottom = value
+
+    def test_bottom__del(self):
+        """Ensures the bottom attribute can't be deleted."""
+        r = Rect(0, 0, 1, 1)
+
+        with self.assertRaises(AttributeError):
+            del r.bottom
+
+    def test_centerx(self):
+        """Changing the centerx attribute moves the rect and does not change
+        the rect's width
+        """
+        r = Rect(1, 2, 3, 4)
+        new_centerx = r.centerx + 20
+        expected_left = r.left + 20
+        old_width = r.width
+
+        r.centerx = new_centerx
+        self.assertEqual(new_centerx, r.centerx)
+        self.assertEqual(expected_left, r.left)
+        self.assertEqual(old_width, r.width)
+
+    def test_centerx__invalid_value(self):
+        """Ensures the centerx attribute handles invalid values correctly."""
+        r = Rect(0, 0, 1, 1)
+
+        for value in (None, [], "1", (1,), [1, 2, 3]):
+            with self.assertRaises(TypeError):
+                r.centerx = value
+
+    def test_centerx__del(self):
+        """Ensures the centerx attribute can't be deleted."""
+        r = Rect(0, 0, 1, 1)
+
+        with self.assertRaises(AttributeError):
+            del r.centerx
+
+    def test_centery(self):
+        """Changing the centery attribute moves the rect and does not change
+        the rect's width
+        """
+        r = Rect(1, 2, 3, 4)
+        new_centery = r.centery + 20
+        expected_top = r.top + 20
+        old_height = r.height
+
+        r.centery = new_centery
+        self.assertEqual(new_centery, r.centery)
+        self.assertEqual(expected_top, r.top)
+        self.assertEqual(old_height, r.height)
+
+    def test_centery__invalid_value(self):
+        """Ensures the centery attribute handles invalid values correctly."""
+        r = Rect(0, 0, 1, 1)
+
+        for value in (None, [], "1", (1,), [1, 2, 3]):
+            with self.assertRaises(TypeError):
+                r.centery = value
+
+    def test_centery__del(self):
+        """Ensures the centery attribute can't be deleted."""
+        r = Rect(0, 0, 1, 1)
+
+        with self.assertRaises(AttributeError):
+            del r.centery
+
+    def test_topleft(self):
+        """Changing the topleft attribute moves the rect and does not change
+        the rect's size
+        """
+        r = Rect(1, 2, 3, 4)
+        new_topleft = (r.left + 20, r.top + 30)
+        old_size = r.size
+
+        r.topleft = new_topleft
+        self.assertEqual(new_topleft, r.topleft)
+        self.assertEqual(old_size, r.size)
+
+    def test_topleft__invalid_value(self):
+        """Ensures the topleft 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.topleft = value
+
+    def test_topleft__del(self):
+        """Ensures the topleft attribute can't be deleted."""
+        r = Rect(0, 0, 1, 1)
+
+        with self.assertRaises(AttributeError):
+            del r.topleft
+
+    def test_bottomleft(self):
+        """Changing the bottomleft attribute moves the rect and does not change
+        the rect's size
+        """
+        r = Rect(1, 2, 3, 4)
+        new_bottomleft = (r.left + 20, r.bottom + 30)
+        expected_topleft = (r.left + 20, r.top + 30)
+        old_size = r.size
+
+        r.bottomleft = new_bottomleft
+        self.assertEqual(new_bottomleft, r.bottomleft)
+        self.assertEqual(expected_topleft, r.topleft)
+        self.assertEqual(old_size, r.size)
+
+    def test_bottomleft__invalid_value(self):
+        """Ensures the bottomleft 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.bottomleft = value
+
+    def test_bottomleft__del(self):
+        """Ensures the bottomleft attribute can't be deleted."""
+        r = Rect(0, 0, 1, 1)
+
+        with self.assertRaises(AttributeError):
+            del r.bottomleft
+
+    def test_topright(self):
+        """Changing the topright attribute moves the rect and does not change
+        the rect's size
+        """
+        r = Rect(1, 2, 3, 4)
+        new_topright = (r.right + 20, r.top + 30)
+        expected_topleft = (r.left + 20, r.top + 30)
+        old_size = r.size
+
+        r.topright = new_topright
+        self.assertEqual(new_topright, r.topright)
+        self.assertEqual(expected_topleft, r.topleft)
+        self.assertEqual(old_size, r.size)
+
+    def test_topright__invalid_value(self):
+        """Ensures the topright 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.topright = value
+
+    def test_topright__del(self):
+        """Ensures the topright attribute can't be deleted."""
+        r = Rect(0, 0, 1, 1)
+
+        with self.assertRaises(AttributeError):
+            del r.topright
+
+    def test_bottomright(self):
+        """Changing the bottomright attribute moves the rect and does not change
+        the rect's size
+        """
+        r = Rect(1, 2, 3, 4)
+        new_bottomright = (r.right + 20, r.bottom + 30)
+        expected_topleft = (r.left + 20, r.top + 30)
+        old_size = r.size
+
+        r.bottomright = new_bottomright
+        self.assertEqual(new_bottomright, r.bottomright)
+        self.assertEqual(expected_topleft, r.topleft)
+        self.assertEqual(old_size, r.size)
+
+    def test_bottomright__invalid_value(self):
+        """Ensures the bottomright 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.bottomright = value
+
+    def test_bottomright__del(self):
+        """Ensures the bottomright attribute can't be deleted."""
+        r = Rect(0, 0, 1, 1)
+
+        with self.assertRaises(AttributeError):
+            del r.bottomright
+
+    def test_center(self):
+        """Changing the center attribute moves the rect and does not change
+        the rect's size
+        """
+        r = Rect(1, 2, 3, 4)
+        new_center = (r.centerx + 20, r.centery + 30)
+        expected_topleft = (r.left + 20, r.top + 30)
+        old_size = r.size
+
+        r.center = new_center
+        self.assertEqual(new_center, r.center)
+        self.assertEqual(expected_topleft, r.topleft)
+        self.assertEqual(old_size, r.size)
+
+    def test_center__invalid_value(self):
+        """Ensures the center 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.center = value
+
+    def test_center__del(self):
+        """Ensures the center attribute can't be deleted."""
+        r = Rect(0, 0, 1, 1)
+
+        with self.assertRaises(AttributeError):
+            del r.center
+
+    def test_midleft(self):
+        """Changing the midleft attribute moves the rect and does not change
+        the rect's size
+        """
+        r = Rect(1, 2, 3, 4)
+        new_midleft = (r.left + 20, r.centery + 30)
+        expected_topleft = (r.left + 20, r.top + 30)
+        old_size = r.size
+
+        r.midleft = new_midleft
+        self.assertEqual(new_midleft, r.midleft)
+        self.assertEqual(expected_topleft, r.topleft)
+        self.assertEqual(old_size, r.size)
+
+    def test_midleft__invalid_value(self):
+        """Ensures the midleft 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.midleft = value
+
+    def test_midleft__del(self):
+        """Ensures the midleft attribute can't be deleted."""
+        r = Rect(0, 0, 1, 1)
+
+        with self.assertRaises(AttributeError):
+            del r.midleft
+
+    def test_midright(self):
+        """Changing the midright attribute moves the rect and does not change
+        the rect's size
+        """
+        r = Rect(1, 2, 3, 4)
+        new_midright = (r.right + 20, r.centery + 30)
+        expected_topleft = (r.left + 20, r.top + 30)
+        old_size = r.size
+
+        r.midright = new_midright
+        self.assertEqual(new_midright, r.midright)
+        self.assertEqual(expected_topleft, r.topleft)
+        self.assertEqual(old_size, r.size)
+
+    def test_midright__invalid_value(self):
+        """Ensures the midright 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.midright = value
+
+    def test_midright__del(self):
+        """Ensures the midright attribute can't be deleted."""
+        r = Rect(0, 0, 1, 1)
+
+        with self.assertRaises(AttributeError):
+            del r.midright
+
+    def test_midtop(self):
+        """Changing the midtop attribute moves the rect and does not change
+        the rect's size
+        """
+        r = Rect(1, 2, 3, 4)
+        new_midtop = (r.centerx + 20, r.top + 30)
+        expected_topleft = (r.left + 20, r.top + 30)
+        old_size = r.size
+
+        r.midtop = new_midtop
+        self.assertEqual(new_midtop, r.midtop)
+        self.assertEqual(expected_topleft, r.topleft)
+        self.assertEqual(old_size, r.size)
+
+    def test_midtop__invalid_value(self):
+        """Ensures the midtop 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.midtop = value
+
+    def test_midtop__del(self):
+        """Ensures the midtop attribute can't be deleted."""
+        r = Rect(0, 0, 1, 1)
+
+        with self.assertRaises(AttributeError):
+            del r.midtop
+
+    def test_midbottom(self):
+        """Changing the midbottom attribute moves the rect and does not change
+        the rect's size
+        """
+        r = Rect(1, 2, 3, 4)
+        new_midbottom = (r.centerx + 20, r.bottom + 30)
+        expected_topleft = (r.left + 20, r.top + 30)
+        old_size = r.size
+
+        r.midbottom = new_midbottom
+        self.assertEqual(new_midbottom, r.midbottom)
+        self.assertEqual(expected_topleft, r.topleft)
+        self.assertEqual(old_size, r.size)
+
+    def test_midbottom__invalid_value(self):
+        """Ensures the midbottom 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.midbottom = value
+
+    def test_midbottom__del(self):
+        """Ensures the midbottom attribute can't be deleted."""
+        r = Rect(0, 0, 1, 1)
+
+        with self.assertRaises(AttributeError):
+            del r.midbottom
+
+    def test_width(self):
+        """Changing the width resizes the rect from the top-left corner"""
+        r = Rect(1, 2, 3, 4)
+        new_width = 10
+        old_topleft = r.topleft
+        old_height = r.height
+
+        r.width = new_width
+        self.assertEqual(new_width, r.width)
+        self.assertEqual(old_height, r.height)
+        self.assertEqual(old_topleft, r.topleft)
+
+    def test_width__invalid_value(self):
+        """Ensures the width attribute handles invalid values correctly."""
+        r = Rect(0, 0, 1, 1)
+
+        for value in (None, [], "1", (1,), [1, 2, 3]):
+            with self.assertRaises(TypeError):
+                r.width = value
+
+    def test_width__del(self):
+        """Ensures the width attribute can't be deleted."""
+        r = Rect(0, 0, 1, 1)
+
+        with self.assertRaises(AttributeError):
+            del r.width
+
+    def test_height(self):
+        """Changing the height resizes the rect from the top-left corner"""
+        r = Rect(1, 2, 3, 4)
+        new_height = 10
+        old_topleft = r.topleft
+        old_width = r.width
+
+        r.height = new_height
+        self.assertEqual(new_height, r.height)
+        self.assertEqual(old_width, r.width)
+        self.assertEqual(old_topleft, r.topleft)
+
+    def test_height__invalid_value(self):
+        """Ensures the height attribute handles invalid values correctly."""
+        r = Rect(0, 0, 1, 1)
+
+        for value in (None, [], "1", (1,), [1, 2, 3]):
+            with self.assertRaises(TypeError):
+                r.height = value
+
+    def test_height__del(self):
+        """Ensures the height attribute can't be deleted."""
+        r = Rect(0, 0, 1, 1)
+
+        with self.assertRaises(AttributeError):
+            del r.height
+
+    def test_size(self):
+        """Changing the size resizes the rect from the top-left corner"""
+        r = Rect(1, 2, 3, 4)
+        new_size = (10, 20)
+        old_topleft = r.topleft
+
+        r.size = new_size
+        self.assertEqual(new_size, r.size)
+        self.assertEqual(old_topleft, r.topleft)
+
+    def test_size__invalid_value(self):
+        """Ensures the size 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.size = value
+
+    def test_size__del(self):
+        """Ensures the size attribute can't be deleted."""
+        r = Rect(0, 0, 1, 1)
+
+        with self.assertRaises(AttributeError):
+            del r.size
+
+    def test_contains(self):
+        r = Rect(1, 2, 3, 4)
+
+        self.assertTrue(
+            r.contains(Rect(2, 3, 1, 1)), "r does not contain Rect(2, 3, 1, 1)"
+        )
+        self.assertTrue(Rect(2, 3, 1, 1) in r, "r does not contain Rect(2, 3, 1, 1) 2")
+        self.assertTrue(
+            r.contains(Rect(r)), "r does not contain the same rect as itself"
+        )
+        self.assertTrue(r in Rect(r), "r does not contain the same rect as itself")
+        self.assertTrue(
+            r.contains(Rect(2, 3, 0, 0)),
+            "r does not contain an empty rect within its bounds",
+        )
+        self.assertTrue(
+            Rect(2, 3, 0, 0) in r,
+            "r does not contain an empty rect within its bounds",
+        )
+        self.assertFalse(r.contains(Rect(0, 0, 1, 2)), "r contains Rect(0, 0, 1, 2)")
+        self.assertFalse(r.contains(Rect(4, 6, 1, 1)), "r contains Rect(4, 6, 1, 1)")
+        self.assertFalse(r.contains(Rect(4, 6, 0, 0)), "r contains Rect(4, 6, 0, 0)")
+        self.assertFalse(Rect(0, 0, 1, 2) in r, "r contains Rect(0, 0, 1, 2)")
+        self.assertFalse(Rect(4, 6, 1, 1) in r, "r contains Rect(4, 6, 1, 1)")
+        self.assertFalse(Rect(4, 6, 0, 0) in r, "r contains Rect(4, 6, 0, 0)")
+        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: "string" in Rect(0, 0, 1, 2))
+        self.assertRaises(TypeError, lambda: 4 + 3j in Rect(0, 0, 1, 2))
+
+    def test_collidepoint(self):
+        r = Rect(1, 2, 3, 4)
+
+        self.assertTrue(
+            r.collidepoint(r.left, r.top), "r does not collide with point (left, top)"
+        )
+        self.assertFalse(
+            r.collidepoint(r.left - 1, r.top), "r collides with point (left - 1, top)"
+        )
+        self.assertFalse(
+            r.collidepoint(r.left, r.top - 1), "r collides with point (left, top - 1)"
+        )
+        self.assertFalse(
+            r.collidepoint(r.left - 1, r.top - 1),
+            "r collides with point (left - 1, top - 1)",
+        )
+
+        self.assertTrue(
+            r.collidepoint(r.right - 1, r.bottom - 1),
+            "r does not collide with point (right - 1, bottom - 1)",
+        )
+        self.assertFalse(
+            r.collidepoint(r.right, r.bottom), "r collides with point (right, bottom)"
+        )
+        self.assertFalse(
+            r.collidepoint(r.right - 1, r.bottom),
+            "r collides with point (right - 1, bottom)",
+        )
+        self.assertFalse(
+            r.collidepoint(r.right, r.bottom - 1),
+            "r collides with point (right, bottom - 1)",
+        )
+
+    def test_inflate__larger(self):
+        """The inflate method inflates around the center of the rectangle"""
+        r = Rect(2, 4, 6, 8)
+        r2 = r.inflate(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_inflate__smaller(self):
+        """The inflate method inflates around the center of the rectangle"""
+        r = Rect(2, 4, 6, 8)
+        r2 = r.inflate(-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_inflate_ip__larger(self):
+        """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)
+
+        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)
+
+        self.assertEqual(r.center, r2.center)
+        self.assertEqual(r.left - 3, r2.left)
+        self.assertEqual(r.top - 4, r2.top)
+        self.assertEqual(r.right + 3, r2.right)
+        self.assertEqual(r.bottom + 4, r2.bottom)
+        self.assertEqual(r.width * 2, r2.width)
+        self.assertEqual(r.height * 2, 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 = Rect(2, 4, 6, 8)
+        r2 = r.scale_by(x=2)
+
+        self.assertEqual(r.center, r2.center)
+        self.assertEqual(r.left - 3, r2.left)
+        self.assertEqual(r.top - 4, r2.top)
+        self.assertEqual(r.right + 3, r2.right)
+        self.assertEqual(r.bottom + 4, r2.bottom)
+        self.assertEqual(r.width * 2, r2.width)
+        self.assertEqual(r.height * 2, r2.height)
+
+    def test_scale_by__smaller_single_argument(self):
+        """The scale method scales around the center of the rectangle"""
+        r = Rect(2, 4, 8, 8)
+        r2 = r.scale_by(0.5)
+
+        self.assertEqual(r.center, r2.center)
+        self.assertEqual(r.left + 2, r2.left)
+        self.assertEqual(r.top + 2, r2.top)
+        self.assertEqual(r.right - 2, r2.right)
+        self.assertEqual(r.bottom - 2, r2.bottom)
+        self.assertEqual(r.width - 4, r2.width)
+        self.assertEqual(r.height - 4, r2.height)
+
+    def test_scale_by__larger(self):
+        """The scale method scales around the center of the rectangle"""
+        # arrange
+        r = Rect(2, 4, 6, 8)
+        # act
+        r2 = r.scale_by(2, 4)
+        # assert
+        self.assertEqual(r.center, r2.center)
+        self.assertEqual(r.left - 3, r2.left)
+        self.assertEqual(r.centery - r.h * 4 / 2, r2.top)
+        self.assertEqual(r.right + 3, r2.right)
+        self.assertEqual(r.centery + r.h * 4 / 2, r2.bottom)
+        self.assertEqual(r.width * 2, r2.width)
+        self.assertEqual(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 = Rect(2, 4, 6, 8)
+        # act
+        r2 = r.scale_by(scale_by=(2, 4))
+        # assert
+        self.assertEqual(r.center, r2.center)
+        self.assertEqual(r.left - 3, r2.left)
+        self.assertEqual(r.centery - r.h * 4 / 2, r2.top)
+        self.assertEqual(r.right + 3, r2.right)
+        self.assertEqual(r.centery + r.h * 4 / 2, r2.bottom)
+        self.assertEqual(r.width * 2, r2.width)
+        self.assertEqual(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 = Rect(2, 4, 6, 8)
+        # act
+        r2 = r.scale_by(x=2, y=4)
+        # assert
+        self.assertEqual(r.center, r2.center)
+        self.assertEqual(r.left - 3, r2.left)
+        self.assertEqual(r.centery - r.h * 4 / 2, r2.top)
+        self.assertEqual(r.right + 3, r2.right)
+        self.assertEqual(r.centery + r.h * 4 / 2, r2.bottom)
+        self.assertEqual(r.width * 2, r2.width)
+        self.assertEqual(r.height * 4, r2.height)
+
+    def test_scale_by__smaller(self):
+        """The scale method scales around the center of the rectangle"""
+        # arrange
+        r = Rect(2, 4, 8, 8)
+        # act
+        r2 = r.scale_by(0.5, 0.25)
+        # assert
+        self.assertEqual(r.center, r2.center)
+        self.assertEqual(r.left + 2, r2.left)
+        self.assertEqual(r.centery - r.h / 4 / 2, r2.top)
+        self.assertEqual(r.right - 2, r2.right)
+        self.assertEqual(r.centery + r.h / 4 / 2, r2.bottom)
+        self.assertEqual(r.width - 4, r2.width)
+        self.assertEqual(r.height // 4, r2.height)
+
+    def test_scale_by__subzero(self):
+        """The scale method scales around the center of the rectangle"""
+        r = Rect(2, 4, 6, 8)
+        r.scale_by(0)
+        r.scale_by(-1)
+        r.scale_by(-0.000001)
+        r.scale_by(0.00001)
+
+        rx1 = r.scale_by(10, 1)
+        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)
+        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)
+        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)
+        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)
+        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)
+        self.assertEqual(r.h * 10, r1.h)
+
+    def test_scale_by_identity(self):
+        """The scale method scales around the center of the rectangle"""
+        # arrange
+        r = Rect(2, 4, 6, 8)
+        # 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 = Rect(2, 4, 6, 8)
+        # 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 = Rect(2, 4, 6, 8)
+        # 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_argment(self):
+        """The scale method scales around the center of the rectangle"""
+        # arrange
+        r = Rect(2, 4, 6, 8)
+        # 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 = Rect(2, 4, 6, 8)
+        r2 = Rect(r)
+        r2.scale_by_ip(2)
+
+        self.assertEqual(r.center, r2.center)
+        self.assertEqual(r.left - 3, r2.left)
+        self.assertEqual(r.top - 4, r2.top)
+        self.assertEqual(r.right + 3, r2.right)
+        self.assertEqual(r.bottom + 4, r2.bottom)
+        self.assertEqual(r.width * 2, r2.width)
+        self.assertEqual(r.height * 2, r2.height)
+
+    def test_scale_by_ip__smaller(self):
+        """The scale method scales around the center of the rectangle"""
+        r = Rect(2, 4, 8, 8)
+        r2 = Rect(r)
+        r2.scale_by_ip(0.5)
+
+        self.assertEqual(r.center, r2.center)
+        self.assertEqual(r.left + 2, r2.left)
+        self.assertEqual(r.top + 2, r2.top)
+        self.assertEqual(r.right - 2, r2.right)
+        self.assertEqual(r.bottom - 2, r2.bottom)
+        self.assertEqual(r.width / 2, r2.width)
+        self.assertEqual(r.height / 2, r2.height)
+
+    def test_scale_by_ip__subzero(self):
+        """The scale method scales around the center of the rectangle"""
+        r = Rect(2, 4, 6, 8)
+        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 = Rect(2, 4, 6, 8)
+        r2 = Rect(r)
+        r2.scale_by_ip(x=2, y=4)
+
+        # assert
+        self.assertEqual(r.center, r2.center)
+        self.assertEqual(r.left - 3, r2.left)
+        self.assertEqual(r.centery - r.h * 4 / 2, r2.top)
+        self.assertEqual(r.right + 3, r2.right)
+        self.assertEqual(r.centery + r.h * 4 / 2, r2.bottom)
+        self.assertEqual(r.width * 2, r2.width)
+        self.assertEqual(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 = Rect(2, 4, 6, 8)
+
+        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_clamp(self):
+        r = Rect(10, 10, 10, 10)
+        c = Rect(19, 12, 5, 5).clamp(r)
+        self.assertEqual(c.right, r.right)
+        self.assertEqual(c.top, 12)
+        c = Rect(1, 2, 3, 4).clamp(r)
+        self.assertEqual(c.topleft, r.topleft)
+        c = Rect(5, 500, 22, 33).clamp(r)
+        self.assertEqual(c.center, r.center)
+
+    def test_clamp_ip(self):
+        r = Rect(10, 10, 10, 10)
+        c = Rect(19, 12, 5, 5)
+        c.clamp_ip(r)
+        self.assertEqual(c.right, r.right)
+        self.assertEqual(c.top, 12)
+        c = Rect(1, 2, 3, 4)
+        c.clamp_ip(r)
+        self.assertEqual(c.topleft, r.topleft)
+        c = Rect(5, 500, 22, 33)
+        c.clamp_ip(r)
+        self.assertEqual(c.center, r.center)
+
+    def test_clip(self):
+        r1 = Rect(1, 2, 3, 4)
+        self.assertEqual(Rect(1, 2, 2, 2), r1.clip(Rect(0, 0, 3, 4)))
+        self.assertEqual(Rect(2, 2, 2, 4), r1.clip(Rect(2, 2, 10, 20)))
+        self.assertEqual(Rect(2, 3, 1, 2), r1.clip(Rect(2, 3, 1, 2)))
+        self.assertEqual((0, 0), r1.clip(20, 30, 5, 6).size)
+        self.assertEqual(
+            r1, r1.clip(Rect(r1)), "r1 does not clip an identical rect to itself"
+        )
+
+    def test_clipline(self):
+        """Ensures clipline handles four int parameters.
+
+        Tests the clipline(x1, y1, x2, y2) format.
+        """
+        rect = Rect((1, 2), (35, 40))
+        x1 = 5
+        y1 = 6
+        x2 = 11
+        y2 = 19
+        expected_line = ((x1, y1), (x2, y2))
+
+        clipped_line = rect.clipline(x1, y1, x2, y2)
+
+        self.assertIsInstance(clipped_line, tuple)
+        self.assertTupleEqual(clipped_line, expected_line)
+
+    def test_clipline__two_sequences(self):
+        """Ensures clipline handles a sequence of two sequences.
+
+        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((endpt1, inner_seq2(pt2)))
+
+                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.
+
+        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(outer_seq(line))
+
+            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.
+
+        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(outer_seq((endpt1, endpt2)))
+
+                    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))
+        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, y1, x2, y2)
+
+        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))
+        # Use a bigger rect to help create test lines.
+        big_rect = rect.inflate(2, 2)
+        lines = (
+            (big_rect.bottomleft, big_rect.topleft),  # Left edge.
+            (big_rect.topleft, big_rect.topright),  # Top edge.
+            (big_rect.topright, big_rect.bottomright),  # Right edge.
+            (big_rect.bottomright, big_rect.bottomleft),
+        )  # Bottom edge.
+        expected_line = ()
+
+        # Test lines outside rect.
+        for line in lines:
+            clipped_line = rect.clipline(line)
+
+            self.assertTupleEqual(clipped_line, expected_line)
+
+    def test_clipline__both_endpoints_outside(self):
+        """Ensures lines that overlap the rect are clipped.
+
+        Testing lines with both endpoints outside the rect.
+        """
+        rect = Rect((0, 0), (20, 20))
+        # 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, big_rect.midright): (
+                rect.midleft,
+                (rect.midright[0] - 1, rect.midright[1]),
+            ),
+            (big_rect.midtop, big_rect.midbottom): (
+                rect.midtop,
+                (rect.midbottom[0], rect.midbottom[1] - 1),
+            ),
+            # Diagonals.
+            (big_rect.topleft, big_rect.bottomright): (
+                rect.topleft,
+                (rect.bottomright[0] - 1, rect.bottomright[1] - 1),
+            ),
+            # This line needs a small adjustment to make sure it intersects
+            # the rect correctly.
+            (
+                (big_rect.topright[0] - 1, big_rect.topright[1]),
+                (big_rect.bottomleft[0], big_rect.bottomleft[1] - 1),
+            ): (
+                (rect.topright[0] - 1, rect.topright[1]),
+                (rect.bottomleft[0], rect.bottomleft[1] - 1),
+            ),
+        }
+
+        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_clipline__both_endpoints_inside(self):
+        """Ensures lines that overlap the rect are clipped.
+
+        Testing lines with both endpoints inside the rect.
+        """
+        rect = Rect((-10, -5), (20, 20))
+        # Use a smaller rect to help create test lines.
+        small_rect = rect.inflate(-2, -2)
+
+        lines = (
+            (small_rect.midleft, small_rect.midright),
+            (small_rect.midtop, small_rect.midbottom),
+            # Diagonals.
+            (small_rect.topleft, small_rect.bottomright),
+            (small_rect.topright, small_rect.bottomleft),
+        )
+
+        for line in lines:
+            expected_line = line
+
+            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_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 is
+        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,
+            ),
+            # Diagonals.
+            (big_rect.topleft, rect.center): (rect.topleft, rect.center),
+            (big_rect.topright, rect.center): (
+                (rect.topright[0] - 1, rect.topright[1]),
+                rect.center,
+            ),
+            (big_rect.bottomright, rect.center): (
+                (rect.bottomright[0] - 1, rect.bottomright[1] - 1),
+                rect.center,
+            ),
+            # This line needs a small adjustment to make sure it intersects
+            # the rect correctly.
+            ((big_rect.bottomleft[0], big_rect.bottomleft[1] - 1), rect.center): (
+                (rect.bottomleft[0], rect.bottomleft[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_clipline__edges(self):
+        """Ensures clipline properly clips line that are along the rect edges."""
+        rect = Rect((10, 25), (15, 20))
+
+        # Create a dict of edges and expected results.
+        edge_dict = {
+            # Left edge.
+            (rect.bottomleft, rect.topleft): (
+                (rect.bottomleft[0], rect.bottomleft[1] - 1),
+                rect.topleft,
+            ),
+            # Top edge.
+            (rect.topleft, rect.topright): (
+                rect.topleft,
+                (rect.topright[0] - 1, rect.topright[1]),
+            ),
+            # Right edge.
+            (rect.topright, rect.bottomright): (),
+            # Bottom edge.
+            (rect.bottomright, rect.bottomleft): (),
+        }
+
+        for edge, expected_line in edge_dict.items():
+            clipped_line = rect.clipline(edge)
+
+            self.assertTupleEqual(clipped_line, expected_line)
+
+            # Swap endpoints to test for symmetry.
+            if expected_line:
+                expected_line = (expected_line[1], expected_line[0])
+
+            clipped_line = rect.clipline((edge[1], edge[0]))
+
+            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 = Rect((10, 25), (15, 20))
+
+        # Test all the points in and on a rect.
+        pts = (
+            (x, y)
+            for x in range(rect.left, rect.right)
+            for y in range(rect.top, 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__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 = Rect((10, 25), (15, 20))
+
+        # Test points outside rect.
+        for pt in test_utils.rect_perimeter_pts(rect.inflate(2, 2)):
+            clipped_line = rect.clipline((pt, pt))
+
+            self.assertTupleEqual(clipped_line, expected_line)
+
+    def test_clipline__zero_size_rect(self):
+        """Ensures clipline handles zero sized rects correctly."""
+        expected_line = ()
+
+        for size in ((0, 15), (15, 0), (0, 0)):
+            rect = Rect((10, 25), size)
+
+            clipped_line = rect.clipline(rect.topleft, rect.topleft)
+
+            self.assertTupleEqual(clipped_line, expected_line)
+
+    def test_clipline__negative_size_rect(self):
+        """Ensures clipline handles negative sized rects correctly."""
+        expected_line = ()
+
+        for size in ((-15, 20), (15, -20), (-15, -20)):
+            rect = Rect((10, 25), size)
+            norm_rect = rect.copy()
+            norm_rect.normalize()
+            # Use a bigger rect to help create test lines.
+            big_rect = norm_rect.inflate(2, 2)
+
+            # Create a dict of lines and expected results. Some line have both
+            # endpoints outside the rect and some have one inside and one
+            # outside.
+            line_dict = {
+                (big_rect.midleft, big_rect.midright): (
+                    norm_rect.midleft,
+                    (norm_rect.midright[0] - 1, norm_rect.midright[1]),
+                ),
+                (big_rect.midtop, big_rect.midbottom): (
+                    norm_rect.midtop,
+                    (norm_rect.midbottom[0], norm_rect.midbottom[1] - 1),
+                ),
+                (big_rect.midleft, norm_rect.center): (
+                    norm_rect.midleft,
+                    norm_rect.center,
+                ),
+                (big_rect.midtop, norm_rect.center): (
+                    norm_rect.midtop,
+                    norm_rect.center,
+                ),
+                (big_rect.midright, norm_rect.center): (
+                    (norm_rect.midright[0] - 1, norm_rect.midright[1]),
+                    norm_rect.center,
+                ),
+                (big_rect.midbottom, norm_rect.center): (
+                    (norm_rect.midbottom[0], norm_rect.midbottom[1] - 1),
+                    norm_rect.center,
+                ),
+            }
+
+            for line, expected_line in line_dict.items():
+                clipped_line = rect.clipline(line)
+
+                # Make sure rect wasn't normalized.
+                self.assertNotEqual(rect, norm_rect)
+                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_clipline__invalid_line(self):
+        """Ensures clipline handles invalid lines correctly."""
+        rect = Rect((0, 0), (10, 20))
+        invalid_lines = (
+            (),
+            (1,),
+            (1, 2),
+            (1, 2, 3),
+            (1, 2, 3, 4, 5),
+            ((1, 2),),
+            ((1, 2), (3,)),
+            ((1, 2), 3),
+            ((1, 2, 5), (3, 4)),
+            ((1, 2), (3, 4, 5)),
+            ((1, 2), (3, 4), (5, 6)),
+        )
+
+        for line in invalid_lines:
+            with self.assertRaises(TypeError):
+                clipped_line = rect.clipline(line)
+
+            with self.assertRaises(TypeError):
+                clipped_line = rect.clipline(*line)
+
+    def test_move(self):
+        r = Rect(1, 2, 3, 4)
+        move_x = 10
+        move_y = 20
+        r2 = r.move(move_x, move_y)
+        expected_r2 = Rect(r.left + move_x, r.top + move_y, r.width, r.height)
+        self.assertEqual(expected_r2, r2)
+
+    def test_move_ip(self):
+        r = Rect(1, 2, 3, 4)
+        r2 = Rect(r)
+        move_x = 10
+        move_y = 20
+        r2.move_ip(move_x, move_y)
+        expected_r2 = Rect(r.left + move_x, r.top + move_y, r.width, r.height)
+        self.assertEqual(expected_r2, r2)
+
+    @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
+        ]
+
+        single_value_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:
+            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))
+
+            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))
+
+                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))
+
+    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)"""
+        rect = Rect(0, 0, 1, 1)
+        rect.update(1, 2, 3, 4)
+
+        self.assertEqual(1, rect.left)
+        self.assertEqual(2, rect.top)
+        self.assertEqual(3, rect.width)
+        self.assertEqual(4, rect.height)
+
+    def test_update__TopLeftSize(self):
+        """Test update with 2 tuples((x, y), (w, h))"""
+        rect = Rect(0, 0, 1, 1)
+        rect.update((1, 2), (3, 4))
+
+        self.assertEqual(1, rect.left)
+        self.assertEqual(2, rect.top)
+        self.assertEqual(3, rect.width)
+        self.assertEqual(4, rect.height)
+
+    def test_update__List(self):
+        """Test update with list"""
+        rect = Rect(0, 0, 1, 1)
+        rect2 = [1, 2, 3, 4]
+        rect.update(rect2)
+
+        self.assertEqual(1, rect.left)
+        self.assertEqual(2, rect.top)
+        self.assertEqual(3, rect.width)
+        self.assertEqual(4, rect.height)
+
+    def test_update__RectObject(self):
+        """Test update with other rect object"""
+        rect = Rect(0, 0, 1, 1)
+        rect2 = Rect(1, 2, 3, 4)
+        rect.update(rect2)
+
+        self.assertEqual(1, rect.left)
+        self.assertEqual(2, rect.top)
+        self.assertEqual(3, rect.width)
+        self.assertEqual(4, rect.height)
+
+    def test_union(self):
+        r1 = Rect(1, 1, 1, 2)
+        r2 = Rect(-2, -2, 1, 2)
+        self.assertEqual(Rect(-2, -2, 4, 5), r1.union(r2))
+
+    def test_union__with_identical_Rect(self):
+        r1 = Rect(1, 2, 3, 4)
+        self.assertEqual(r1, r1.union(Rect(r1)))
+
+    def test_union_ip(self):
+        r1 = Rect(1, 1, 1, 2)
+        r2 = Rect(-2, -2, 1, 2)
+        r1.union_ip(r2)
+        self.assertEqual(Rect(-2, -2, 4, 5), r1)
+
+    def test_unionall(self):
+        r1 = Rect(0, 0, 1, 1)
+        r2 = Rect(-2, -2, 1, 1)
+        r3 = Rect(2, 2, 1, 1)
+
+        r4 = r1.unionall([r2, r3])
+        self.assertEqual(Rect(-2, -2, 5, 5), r4)
+
+    def test_unionall__invalid_rect_format(self):
+        """Ensures unionall correctly handles invalid rect parameters."""
+        numbers = [0, 1.2, 2, 3.3]
+        strs = ["a", "b", "c"]
+        nones = [None, None]
+
+        for invalid_rects in (numbers, strs, nones):
+            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)
+        r3 = Rect(2, 2, 1, 1)
+
+        r1.unionall_ip([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_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(
+            r1.colliderect(Rect(0, 0, 2, 3)),
+            "r1 does not collide with Rect(0, 0, 2, 3)",
+        )
+        self.assertFalse(
+            r1.colliderect(Rect(0, 0, 1, 2)), "r1 collides with Rect(0, 0, 1, 2)"
+        )
+        self.assertFalse(
+            r1.colliderect(Rect(r1.right, r1.bottom, 2, 2)),
+            "r1 collides with Rect(r1.right, r1.bottom, 2, 2)",
+        )
+        self.assertTrue(
+            r1.colliderect(Rect(r1.left + 1, r1.top + 1, r1.width - 2, r1.height - 2)),
+            "r1 does not collide with Rect(r1.left + 1, r1.top + 1, "
+            + "r1.width - 2, r1.height - 2)",
+        )
+        self.assertTrue(
+            r1.colliderect(Rect(r1.left - 1, r1.top - 1, r1.width + 2, r1.height + 2)),
+            "r1 does not collide with Rect(r1.left - 1, r1.top - 1, "
+            + "r1.width + 2, r1.height + 2)",
+        )
+        self.assertTrue(
+            r1.colliderect(Rect(r1)), "r1 does not collide with an identical rect"
+        )
+        self.assertFalse(
+            r1.colliderect(Rect(r1.right, r1.bottom, 0, 0)),
+            "r1 collides with Rect(r1.right, r1.bottom, 0, 0)",
+        )
+        self.assertFalse(
+            r1.colliderect(Rect(r1.right, r1.bottom, 1, 1)),
+            "r1 collides with Rect(r1.right, r1.bottom, 1, 1)",
+        )
+
+    def testEquals(self):
+        """check to see how the rect uses __eq__"""
+        r1 = Rect(1, 2, 3, 4)
+        r2 = Rect(10, 20, 30, 40)
+        r3 = (10, 20, 30, 40)
+        r4 = Rect(10, 20, 30, 40)
+
+        class foo(Rect):
+            def __eq__(self, other):
+                return id(self) == id(other)
+
+            def __ne__(self, other):
+                return id(self) != id(other)
+
+        class foo2(Rect):
+            pass
+
+        r5 = foo(10, 20, 30, 40)
+        r6 = foo2(10, 20, 30, 40)
+
+        self.assertNotEqual(r5, r2)
+
+        # because we define equality differently for this subclass.
+        self.assertEqual(r6, r2)
+
+        rect_list = [r1, r2, r3, r4, r6]
+
+        # see if we can remove 4 of these.
+        rect_list.remove(r2)
+        rect_list.remove(r2)
+        rect_list.remove(r2)
+        rect_list.remove(r2)
+        self.assertRaises(ValueError, rect_list.remove, r2)
+
+    def test_collidedict(self):
+        """Ensures collidedict detects collisions."""
+        rect = Rect(1, 1, 10, 10)
+
+        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(d, use_values)
+
+            # The detected collision could be any of the possible items.
+            self.assertIn(collide_item, expected_items)
+
+    def test_collidedict__no_collision(self):
+        """Ensures collidedict returns None when no collisions."""
+        rect = Rect(1, 1, 10, 10)
+
+        no_collide_item1 = ("no collide 1", Rect(50, 50, 10, 10))
+        no_collide_item2 = ("no collide 2", Rect(60, 60, 10, 10))
+        no_collide_item3 = ("no collide 3", Rect(70, 70, 10, 10))
+
+        # Dict to check collisions with values.
+        rect_values = dict((no_collide_item1, no_collide_item2, no_collide_item3))
+
+        # Dict to check collisions with keys.
+        rect_keys = {tuple(v): k for k, v in rect_values.items()}
+
+        for use_values in (True, False):
+            d = rect_values if use_values else rect_keys
+
+            collide_item = rect.collidedict(d, use_values)
+
+            self.assertIsNone(collide_item)
+
+    def test_collidedict__barely_touching(self):
+        """Ensures collidedict works correctly for rects that barely touch."""
+        rect = Rect(1, 1, 10, 10)
+        # Small rect to test barely touching collisions.
+        collide_rect = Rect(0, 0, 1, 1)
+
+        collide_item1 = ("collide 1", collide_rect)
+        no_collide_item1 = ("no collide 1", Rect(50, 50, 10, 10))
+        no_collide_item2 = ("no collide 2", Rect(60, 60, 10, 10))
+        no_collide_item3 = ("no collide 3", Rect(70, 70, 10, 10))
+
+        # Dict to check collisions with values.
+        no_collide_rect_values = dict(
+            (no_collide_item1, no_collide_item2, no_collide_item3)
+        )
+
+        # Dict to check collisions with keys.
+        no_collide_rect_keys = {tuple(v): k for k, v in no_collide_rect_values.items()}
+
+        # Tests the collide_rect on each of the rect's corners.
+        for attr in ("topleft", "topright", "bottomright", "bottomleft"):
+            setattr(collide_rect, attr, getattr(rect, attr))
+
+            for use_values in (True, False):
+                if use_values:
+                    expected_item = collide_item1
+                    d = dict(no_collide_rect_values)
+                else:
+                    expected_item = (tuple(collide_item1[1]), collide_item1[0])
+                    d = dict(no_collide_rect_keys)
+
+                d.update((expected_item,))  # Add in the expected item.
+
+                collide_item = rect.collidedict(d, use_values)
+
+                self.assertTupleEqual(collide_item, expected_item)
+
+    def test_collidedict__zero_sized_rects(self):
+        """Ensures collidedict works correctly with zero sized rects.
+
+        There should be no collisions with zero sized rects.
+        """
+        zero_rect1 = Rect(1, 1, 0, 0)
+        zero_rect2 = Rect(1, 1, 1, 0)
+        zero_rect3 = Rect(1, 1, 0, 1)
+        zero_rect4 = Rect(1, 1, -1, 0)
+        zero_rect5 = Rect(1, 1, 0, -1)
+
+        no_collide_item1 = ("no collide 1", zero_rect1.copy())
+        no_collide_item2 = ("no collide 2", zero_rect2.copy())
+        no_collide_item3 = ("no collide 3", zero_rect3.copy())
+        no_collide_item4 = ("no collide 4", zero_rect4.copy())
+        no_collide_item5 = ("no collide 5", zero_rect5.copy())
+        no_collide_item6 = ("no collide 6", Rect(0, 0, 10, 10))
+        no_collide_item7 = ("no collide 7", Rect(0, 0, 2, 2))
+
+        # Dict to check collisions with values.
+        rect_values = dict(
+            (
+                no_collide_item1,
+                no_collide_item2,
+                no_collide_item3,
+                no_collide_item4,
+                no_collide_item5,
+                no_collide_item6,
+                no_collide_item7,
+            )
+        )
+
+        # Dict to check collisions with keys.
+        rect_keys = {tuple(v): k for k, v in rect_values.items()}
+
+        for use_values in (True, False):
+            d = rect_values if use_values else rect_keys
+
+            for zero_rect in (
+                zero_rect1,
+                zero_rect2,
+                zero_rect3,
+                zero_rect4,
+                zero_rect5,
+            ):
+                collide_item = zero_rect.collidedict(d, use_values)
+
+                self.assertIsNone(collide_item)
+
+    def test_collidedict__zero_sized_rects_as_args(self):
+        """Ensures collidedict works correctly with zero sized rects as args.
+
+        There should be no collisions with zero sized rects.
+        """
+        rect = Rect(0, 0, 10, 10)
+
+        no_collide_item1 = ("no collide 1", Rect(1, 1, 0, 0))
+        no_collide_item2 = ("no collide 2", Rect(1, 1, 1, 0))
+        no_collide_item3 = ("no collide 3", Rect(1, 1, 0, 1))
+
+        # Dict to check collisions with values.
+        rect_values = dict((no_collide_item1, no_collide_item2, no_collide_item3))
+
+        # Dict to check collisions with keys.
+        rect_keys = {tuple(v): k for k, v in rect_values.items()}
+
+        for use_values in (True, False):
+            d = rect_values if use_values else rect_keys
+
+            collide_item = rect.collidedict(d, use_values)
+
+            self.assertIsNone(collide_item)
+
+    def test_collidedict__negative_sized_rects(self):
+        """Ensures collidedict works correctly with negative sized rects."""
+        neg_rect = Rect(1, 1, -1, -1)
+
+        collide_item1 = ("collide 1", neg_rect.copy())
+        collide_item2 = ("collide 2", Rect(0, 0, 10, 10))
+        no_collide_item1 = ("no collide 1", Rect(1, 1, 10, 10))
+
+        # Dict to check collisions with values.
+        rect_values = dict((collide_item1, collide_item2, no_collide_item1))
+        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:
+                collide_items = value_collide_items
+                d = rect_values
+            else:
+                collide_items = key_collide_items
+                d = rect_keys
+
+            collide_item = neg_rect.collidedict(d, use_values)
+
+            # The detected collision could be any of the possible items.
+            self.assertIn(collide_item, collide_items)
+
+    def test_collidedict__negative_sized_rects_as_args(self):
+        """Ensures collidedict works correctly with negative sized rect args."""
+        rect = Rect(0, 0, 10, 10)
+
+        collide_item1 = ("collide 1", Rect(1, 1, -1, -1))
+        no_collide_item1 = ("no collide 1", Rect(1, 1, -1, 0))
+        no_collide_item2 = ("no collide 2", Rect(1, 1, 0, -1))
+
+        # Dict to check collisions with values.
+        rect_values = dict((collide_item1, no_collide_item1, no_collide_item2))
+
+        # Dict to check collisions with keys.
+        rect_keys = {tuple(v): k for k, v in rect_values.items()}
+
+        for use_values in (True, False):
+            if use_values:
+                expected_item = collide_item1
+                d = rect_values
+            else:
+                expected_item = (tuple(collide_item1[1]), collide_item1[0])
+                d = rect_keys
+
+            collide_item = rect.collidedict(d, use_values)
+
+            self.assertTupleEqual(collide_item, expected_item)
+
+    def test_collidedict__invalid_dict_format(self):
+        """Ensures collidedict correctly handles invalid dict parameters."""
+        rect = Rect(0, 0, 10, 10)
+
+        invalid_value_dict = ("collide", rect.copy())
+        invalid_key_dict = tuple(invalid_value_dict[1]), invalid_value_dict[0]
+
+        for use_values in (True, False):
+            d = invalid_value_dict if use_values else invalid_key_dict
+
+            with self.assertRaises(TypeError):
+                collide_item = rect.collidedict(d, use_values)
+
+    def test_collidedict__invalid_dict_value_format(self):
+        """Ensures collidedict correctly handles dicts with invalid values."""
+        rect = Rect(0, 0, 10, 10)
+        rect_keys = {tuple(rect): "collide"}
+
+        with self.assertRaises(TypeError):
+            collide_item = rect.collidedict(rect_keys, 1)
+
+    def test_collidedict__invalid_dict_key_format(self):
+        """Ensures collidedict correctly handles dicts with invalid keys."""
+        rect = Rect(0, 0, 10, 10)
+        rect_values = {"collide": rect.copy()}
+
+        with self.assertRaises(TypeError):
+            collide_item = rect.collidedict(rect_values)
+
+    def test_collidedict__invalid_use_values_format(self):
+        """Ensures collidedict correctly handles invalid use_values parameters."""
+        rect = Rect(0, 0, 1, 1)
+        d = {}
+
+        for invalid_param in (None, d, 1.1):
+            with self.assertRaises(TypeError):
+                collide_item = rect.collidedict(d, invalid_param)
+
+    def test_collidedict__kwargs(self):
+        """Ensures collidedict detects collisions via keyword arguments."""
+        rect = Rect(1, 1, 10, 10)
+
+        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."""
+        rect = Rect(1, 1, 10, 10)
+
+        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(d, use_values)
+
+            self._assertCountEqual(collide_items, expected_items)
+
+    def test_collidedictall__no_collision(self):
+        """Ensures collidedictall returns an empty list when no collisions."""
+        rect = Rect(1, 1, 10, 10)
+
+        no_collide_item1 = ("no collide 1", Rect(50, 50, 20, 20))
+        no_collide_item2 = ("no collide 2", Rect(60, 60, 20, 20))
+        no_collide_item3 = ("no collide 3", Rect(70, 70, 20, 20))
+
+        # Dict to check collisions with values.
+        rect_values = dict((no_collide_item1, no_collide_item2, no_collide_item3))
+
+        # Dict to check collisions with keys.
+        rect_keys = {tuple(v): k for k, v in rect_values.items()}
+
+        expected_items = []
+
+        for use_values in (True, False):
+            d = rect_values if use_values else rect_keys
+
+            collide_items = rect.collidedictall(d, use_values)
+
+            self._assertCountEqual(collide_items, expected_items)
+
+    def test_collidedictall__barely_touching(self):
+        """Ensures collidedictall works correctly for rects that barely touch."""
+        rect = Rect(1, 1, 10, 10)
+        # Small rect to test barely touching collisions.
+        collide_rect = Rect(0, 0, 1, 1)
+
+        collide_item1 = ("collide 1", collide_rect)
+        no_collide_item1 = ("no collide 1", Rect(50, 50, 20, 20))
+        no_collide_item2 = ("no collide 2", Rect(60, 60, 20, 20))
+        no_collide_item3 = ("no collide 3", Rect(70, 70, 20, 20))
+
+        # Dict to check collisions with values.
+        no_collide_rect_values = dict(
+            (no_collide_item1, no_collide_item2, no_collide_item3)
+        )
+
+        # Dict to check collisions with keys.
+        no_collide_rect_keys = {tuple(v): k for k, v in no_collide_rect_values.items()}
+
+        # Tests the collide_rect on each of the rect's corners.
+        for attr in ("topleft", "topright", "bottomright", "bottomleft"):
+            setattr(collide_rect, attr, getattr(rect, attr))
+
+            for use_values in (True, False):
+                if use_values:
+                    expected_items = [collide_item1]
+                    d = dict(no_collide_rect_values)
+                else:
+                    expected_items = [(tuple(collide_item1[1]), collide_item1[0])]
+                    d = dict(no_collide_rect_keys)
+
+                d.update(expected_items)  # Add in the expected items.
+
+                collide_items = rect.collidedictall(d, use_values)
+
+                self._assertCountEqual(collide_items, expected_items)
+
+    def test_collidedictall__zero_sized_rects(self):
+        """Ensures collidedictall works correctly with zero sized rects.
+
+        There should be no collisions with zero sized rects.
+        """
+        zero_rect1 = Rect(2, 2, 0, 0)
+        zero_rect2 = Rect(2, 2, 2, 0)
+        zero_rect3 = Rect(2, 2, 0, 2)
+        zero_rect4 = Rect(2, 2, -2, 0)
+        zero_rect5 = Rect(2, 2, 0, -2)
+
+        no_collide_item1 = ("no collide 1", zero_rect1.copy())
+        no_collide_item2 = ("no collide 2", zero_rect2.copy())
+        no_collide_item3 = ("no collide 3", zero_rect3.copy())
+        no_collide_item4 = ("no collide 4", zero_rect4.copy())
+        no_collide_item5 = ("no collide 5", zero_rect5.copy())
+        no_collide_item6 = ("no collide 6", Rect(0, 0, 10, 10))
+        no_collide_item7 = ("no collide 7", Rect(0, 0, 2, 2))
+
+        # Dict to check collisions with values.
+        rect_values = dict(
+            (
+                no_collide_item1,
+                no_collide_item2,
+                no_collide_item3,
+                no_collide_item4,
+                no_collide_item5,
+                no_collide_item6,
+                no_collide_item7,
+            )
+        )
+
+        # Dict to check collisions with keys.
+        rect_keys = {tuple(v): k for k, v in rect_values.items()}
+
+        expected_items = []
+
+        for use_values in (True, False):
+            d = rect_values if use_values else rect_keys
+
+            for zero_rect in (
+                zero_rect1,
+                zero_rect2,
+                zero_rect3,
+                zero_rect4,
+                zero_rect5,
+            ):
+                collide_items = zero_rect.collidedictall(d, use_values)
+
+                self._assertCountEqual(collide_items, expected_items)
+
+    def test_collidedictall__zero_sized_rects_as_args(self):
+        """Ensures collidedictall works correctly with zero sized rects
+        as args.
+
+        There should be no collisions with zero sized rects.
+        """
+        rect = Rect(0, 0, 20, 20)
+
+        no_collide_item1 = ("no collide 1", Rect(2, 2, 0, 0))
+        no_collide_item2 = ("no collide 2", Rect(2, 2, 2, 0))
+        no_collide_item3 = ("no collide 3", Rect(2, 2, 0, 2))
+
+        # Dict to check collisions with values.
+        rect_values = dict((no_collide_item1, no_collide_item2, no_collide_item3))
+
+        # Dict to check collisions with keys.
+        rect_keys = {tuple(v): k for k, v in rect_values.items()}
+
+        expected_items = []
+
+        for use_values in (True, False):
+            d = rect_values if use_values else rect_keys
+
+            collide_items = rect.collidedictall(d, use_values)
+
+            self._assertCountEqual(collide_items, expected_items)
+
+    def test_collidedictall__negative_sized_rects(self):
+        """Ensures collidedictall works correctly with negative sized rects."""
+        neg_rect = Rect(2, 2, -2, -2)
+
+        collide_item1 = ("collide 1", neg_rect.copy())
+        collide_item2 = ("collide 2", Rect(0, 0, 20, 20))
+        no_collide_item1 = ("no collide 1", Rect(2, 2, 20, 20))
+
+        # Dict to check collisions with values.
+        rect_values = dict((collide_item1, collide_item2, no_collide_item1))
+        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 = neg_rect.collidedictall(d, use_values)
+
+            self._assertCountEqual(collide_items, expected_items)
+
+    def test_collidedictall__negative_sized_rects_as_args(self):
+        """Ensures collidedictall works correctly with negative sized rect
+        args.
+        """
+        rect = Rect(0, 0, 10, 10)
+
+        collide_item1 = ("collide 1", Rect(1, 1, -1, -1))
+        no_collide_item1 = ("no collide 1", Rect(1, 1, -1, 0))
+        no_collide_item2 = ("no collide 2", Rect(1, 1, 0, -1))
+
+        # Dict to check collisions with values.
+        rect_values = dict((collide_item1, no_collide_item1, no_collide_item2))
+        value_collide_items = [collide_item1]
+
+        # 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(d, use_values)
+
+            self._assertCountEqual(collide_items, expected_items)
+
+    def test_collidedictall__invalid_dict_format(self):
+        """Ensures collidedictall correctly handles invalid dict parameters."""
+        rect = Rect(0, 0, 10, 10)
+
+        invalid_value_dict = ("collide", rect.copy())
+        invalid_key_dict = tuple(invalid_value_dict[1]), invalid_value_dict[0]
+
+        for use_values in (True, False):
+            d = invalid_value_dict if use_values else invalid_key_dict
+
+            with self.assertRaises(TypeError):
+                collide_item = rect.collidedictall(d, use_values)
+
+    def test_collidedictall__invalid_dict_value_format(self):
+        """Ensures collidedictall correctly handles dicts with invalid values."""
+        rect = Rect(0, 0, 10, 10)
+        rect_keys = {tuple(rect): "collide"}
+
+        with self.assertRaises(TypeError):
+            collide_items = rect.collidedictall(rect_keys, 1)
+
+    def test_collidedictall__invalid_dict_key_format(self):
+        """Ensures collidedictall correctly handles dicts with invalid keys."""
+        rect = Rect(0, 0, 10, 10)
+        rect_values = {"collide": rect.copy()}
+
+        with self.assertRaises(TypeError):
+            collide_items = rect.collidedictall(rect_values)
+
+    def test_collidedictall__invalid_use_values_format(self):
+        """Ensures collidedictall correctly handles invalid use_values
+        parameters.
+        """
+        rect = Rect(0, 0, 1, 1)
+        d = {}
+
+        for invalid_param in (None, d, 1.1):
+            with self.assertRaises(TypeError):
+                collide_items = rect.collidedictall(d, invalid_param)
+
+    def test_collidedictall__kwargs(self):
+        """Ensures collidedictall detects collisions via keyword arguments."""
+        rect = Rect(1, 1, 10, 10)
+
+        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:
+
+        # 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. 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(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:
+
+        # Rect.collidelistall(list): return indices
+        # test if all rectangles in a list intersect
+        #
+        # 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(f))
+
+    def test_collidelistall_returns_empty_list(self):
+        r = Rect(1, 1, 10, 10)
+
+        l = [
+            Rect(112, 1, 10, 10),
+            Rect(50, 5, 10, 10),
+            Rect(15, 15, 1, 1),
+            Rect(-20, 2, 1, 1),
+        ]
+        self.assertEqual(r.collidelistall(l), [])
+
+    def test_collidelistall_list_of_tuples(self):
+        r = Rect(1, 1, 10, 10)
+
+        l = [
+            (1, 1, 10, 10),
+            (5, 5, 10, 10),
+            (15, 15, 1, 1),
+            (2, 2, 1, 1),
+        ]
+        self.assertEqual(r.collidelistall(l), [0, 1, 3])
+
+        f = [(50, 50, 1, 1), (20, 20, 5, 5)]
+        self.assertFalse(r.collidelistall(f))
+
+    def test_collidelistall_list_of_two_tuples(self):
+        r = Rect(1, 1, 10, 10)
+
+        l = [
+            ((1, 1), (10, 10)),
+            ((5, 5), (10, 10)),
+            ((15, 15), (1, 1)),
+            ((2, 2), (1, 1)),
+        ]
+        self.assertEqual(r.collidelistall(l), [0, 1, 3])
+
+        f = [((50, 50), (1, 1)), ((20, 20), (5, 5))]
+        self.assertFalse(r.collidelistall(f))
+
+    def test_collidelistall_list_of_lists(self):
+        r = Rect(1, 1, 10, 10)
+
+        l = [
+            [1, 1, 10, 10],
+            [5, 5, 10, 10],
+            [15, 15, 1, 1],
+            [2, 2, 1, 1],
+        ]
+        self.assertEqual(r.collidelistall(l), [0, 1, 3])
+
+        f = [[50, 50, 1, 1], [20, 20, 5, 5]]
+        self.assertFalse(r.collidelistall(f))
+
+    class _ObjectWithRectAttribute:
+        def __init__(self, r):
+            self.rect = r
+
+    class _ObjectWithCallableRectAttribute:
+        def __init__(self, r):
+            self._rect = r
+
+        def rect(self):
+            return self._rect
+
+    class _ObjectWithRectProperty:
+        def __init__(self, r):
+            self._rect = r
+
+        @property
+        def rect(self):
+            return self._rect
+
+    class _ObjectWithMultipleRectAttribute:
+        def __init__(self, r1, r2, r3):
+            self.rect1 = r1
+            self.rect2 = r2
+            self.rect3 = r3
+
+    def test_collidelistall_list_of_object_with_rect_attribute(self):
+        r = Rect(1, 1, 10, 10)
+
+        l = [
+            self._ObjectWithRectAttribute(Rect(1, 1, 10, 10)),
+            self._ObjectWithRectAttribute(Rect(5, 5, 10, 10)),
+            self._ObjectWithRectAttribute(Rect(15, 15, 1, 1)),
+            self._ObjectWithRectAttribute(Rect(2, 2, 1, 1)),
+        ]
+        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))
+
+    def test_collidelistall_list_of_object_with_callable_rect_attribute(self):
+        r = Rect(1, 1, 10, 10)
+
+        l = [
+            self._ObjectWithCallableRectAttribute(Rect(1, 1, 10, 10)),
+            self._ObjectWithCallableRectAttribute(Rect(5, 5, 10, 10)),
+            self._ObjectWithCallableRectAttribute(Rect(15, 15, 1, 1)),
+            self._ObjectWithCallableRectAttribute(Rect(2, 2, 1, 1)),
+        ]
+        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))
+
+    def test_collidelistall_list_of_object_with_callable_rect_returning_object_with_rect_attribute(
+        self,
+    ):
+        r = Rect(1, 1, 10, 10)
+
+        l = [
+            self._ObjectWithCallableRectAttribute(
+                self._ObjectWithRectAttribute(Rect(1, 1, 10, 10))
+            ),
+            self._ObjectWithCallableRectAttribute(
+                self._ObjectWithRectAttribute(Rect(5, 5, 10, 10))
+            ),
+            self._ObjectWithCallableRectAttribute(
+                self._ObjectWithRectAttribute(Rect(15, 15, 1, 1))
+            ),
+            self._ObjectWithCallableRectAttribute(
+                self._ObjectWithRectAttribute(Rect(2, 2, 1, 1))
+            ),
+        ]
+        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))
+
+    def test_collidelistall_list_of_object_with_rect_property(self):
+        r = Rect(1, 1, 10, 10)
+
+        l = [
+            self._ObjectWithRectProperty(Rect(1, 1, 10, 10)),
+            self._ObjectWithRectProperty(Rect(5, 5, 10, 10)),
+            self._ObjectWithRectProperty(Rect(15, 15, 1, 1)),
+            self._ObjectWithRectProperty(Rect(2, 2, 1, 1)),
+        ]
+        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))
+
+    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
+        r = Rect(1, 1, 10, 10)
+        rects = [Rect(1, 2, 3, 4), Rect(10, 20, 30, 40)]
+        objects = [
+            self._ObjectWithMultipleRectAttribute(
+                Rect(1, 2, 3, 4), Rect(10, 20, 30, 40), Rect(100, 200, 300, 400)
+            ),
+            self._ObjectWithMultipleRectAttribute(
+                Rect(1, 2, 3, 4), Rect(10, 20, 30, 40), Rect(100, 200, 300, 400)
+            ),
+        ]
+
+        # act / verify
+        r.collideobjects(rects)
+        r.collideobjects(rects, key=None)
+        r.collideobjects(objects, key=lambda o: o.rect1)
+        self.assertRaises(TypeError, r.collideobjects, objects)
+
+    def test_collideobjects_without_key(self):
+        r = Rect(1, 1, 10, 10)
+        types_to_test = [
+            [Rect(50, 50, 1, 1), Rect(5, 5, 10, 10), Rect(4, 4, 1, 1)],
+            [
+                self._ObjectWithRectAttribute(Rect(50, 50, 1, 1)),
+                self._ObjectWithRectAttribute(Rect(5, 5, 10, 10)),
+                self._ObjectWithRectAttribute(Rect(4, 4, 1, 1)),
+            ],
+            [
+                self._ObjectWithRectProperty(Rect(50, 50, 1, 1)),
+                self._ObjectWithRectProperty(Rect(5, 5, 10, 10)),
+                self._ObjectWithRectProperty(Rect(4, 4, 1, 1)),
+            ],
+            [
+                self._ObjectWithCallableRectAttribute(Rect(50, 50, 1, 1)),
+                self._ObjectWithCallableRectAttribute(Rect(5, 5, 10, 10)),
+                self._ObjectWithCallableRectAttribute(Rect(4, 4, 1, 1)),
+            ],
+            [
+                self._ObjectWithCallableRectAttribute(
+                    self._ObjectWithRectAttribute(Rect(50, 50, 1, 1))
+                ),
+                self._ObjectWithCallableRectAttribute(
+                    self._ObjectWithRectAttribute(Rect(5, 5, 10, 10))
+                ),
+                self._ObjectWithCallableRectAttribute(
+                    self._ObjectWithRectAttribute(Rect(4, 4, 1, 1))
+                ),
+            ],
+            [(50, 50, 1, 1), (5, 5, 10, 10), (4, 4, 1, 1)],
+            [((50, 50), (1, 1)), ((5, 5), (10, 10)), ((4, 4), (1, 1))],
+            [[50, 50, 1, 1], [5, 5, 10, 10], [4, 4, 1, 1]],
+            [
+                Rect(50, 50, 1, 1),
+                self._ObjectWithRectAttribute(Rect(5, 5, 10, 10)),
+                (4, 4, 1, 1),
+            ],  # mix
+        ]
+
+        for l in types_to_test:
+            with self.subTest(type=l[0].__class__.__name__):
+                # act
+                actual = r.collideobjects(l)
+                # assert
+                self.assertEqual(actual, l[1])
+
+        types_to_test = [
+            [Rect(50, 50, 1, 1), Rect(100, 100, 4, 4)],
+            [
+                self._ObjectWithRectAttribute(Rect(50, 50, 1, 1)),
+                self._ObjectWithRectAttribute(Rect(100, 100, 4, 4)),
+            ],
+            [
+                self._ObjectWithRectProperty(Rect(50, 50, 1, 1)),
+                self._ObjectWithRectProperty(Rect(100, 100, 4, 4)),
+            ],
+            [
+                self._ObjectWithCallableRectAttribute(Rect(50, 50, 1, 1)),
+                self._ObjectWithCallableRectAttribute(Rect(100, 100, 4, 4)),
+            ],
+            [
+                self._ObjectWithCallableRectAttribute(
+                    self._ObjectWithRectAttribute(Rect(50, 50, 1, 1))
+                ),
+                self._ObjectWithCallableRectAttribute(
+                    self._ObjectWithRectAttribute(Rect(100, 100, 4, 4))
+                ),
+            ],
+            [(50, 50, 1, 1), (100, 100, 4, 4)],
+            [((50, 50), (1, 1)), ((100, 100), (4, 4))],
+            [[50, 50, 1, 1], [100, 100, 4, 4]],
+            [Rect(50, 50, 1, 1), [100, 100, 4, 4]],  # mix
+        ]
+
+        for f in types_to_test:
+            with self.subTest(type=f[0].__class__.__name__, expected=None):
+                # act
+                actual = r.collideobjects(f)
+                # assert
+                self.assertEqual(actual, None)
+
+    def test_collideobjects_list_of_object_with_multiple_rect_attribute(self):
+        r = Rect(1, 1, 10, 10)
+
+        things = [
+            self._ObjectWithMultipleRectAttribute(
+                Rect(1, 1, 10, 10), Rect(5, 5, 1, 1), Rect(-73, 3, 3, 3)
+            ),
+            self._ObjectWithMultipleRectAttribute(
+                Rect(5, 5, 10, 10), Rect(-5, -5, 10, 10), Rect(3, 3, 3, 3)
+            ),
+            self._ObjectWithMultipleRectAttribute(
+                Rect(15, 15, 1, 1), Rect(100, 1, 1, 1), Rect(3, 83, 3, 3)
+            ),
+            self._ObjectWithMultipleRectAttribute(
+                Rect(2, 2, 1, 1), Rect(1, -81, 10, 10), Rect(3, 8, 3, 3)
+            ),
+        ]
+        self.assertEqual(r.collideobjects(things, key=lambda o: o.rect1), things[0])
+        self.assertEqual(r.collideobjects(things, key=lambda o: o.rect2), things[0])
+        self.assertEqual(r.collideobjects(things, key=lambda o: o.rect3), things[1])
+
+        f = [
+            self._ObjectWithMultipleRectAttribute(
+                Rect(50, 50, 1, 1), Rect(11, 1, 1, 1), Rect(2, -32, 2, 2)
+            ),
+            self._ObjectWithMultipleRectAttribute(
+                Rect(20, 20, 5, 5), Rect(1, 11, 1, 1), Rect(-20, 2, 2, 2)
+            ),
+        ]
+        self.assertFalse(r.collideobjectsall(f, key=lambda o: o.rect1))
+        self.assertFalse(r.collideobjectsall(f, key=lambda o: o.rect2))
+        self.assertFalse(r.collideobjectsall(f, key=lambda o: o.rect3))
+
+    def test_collideobjectsall_call_variants(self):
+        # arrange
+        r = Rect(1, 1, 10, 10)
+        rects = [Rect(1, 2, 3, 4), Rect(10, 20, 30, 40)]
+        objects = [
+            self._ObjectWithMultipleRectAttribute(
+                Rect(1, 2, 3, 4), Rect(10, 20, 30, 40), Rect(100, 200, 300, 400)
+            ),
+            self._ObjectWithMultipleRectAttribute(
+                Rect(1, 2, 3, 4), Rect(10, 20, 30, 40), Rect(100, 200, 300, 400)
+            ),
+        ]
+
+        # act / verify
+        r.collideobjectsall(rects)
+        r.collideobjectsall(rects, key=None)
+        r.collideobjectsall(objects, key=lambda o: o.rect1)
+        self.assertRaises(TypeError, r.collideobjectsall, objects)
+
+    def test_collideobjectsall(self):
+        r = Rect(1, 1, 10, 10)
+
+        types_to_test = [
+            [
+                Rect(1, 1, 10, 10),
+                Rect(5, 5, 10, 10),
+                Rect(15, 15, 1, 1),
+                Rect(2, 2, 1, 1),
+            ],
+            [
+                (1, 1, 10, 10),
+                (5, 5, 10, 10),
+                (15, 15, 1, 1),
+                (2, 2, 1, 1),
+            ],
+            [
+                ((1, 1), (10, 10)),
+                ((5, 5), (10, 10)),
+                ((15, 15), (1, 1)),
+                ((2, 2), (1, 1)),
+            ],
+            [
+                [1, 1, 10, 10],
+                [5, 5, 10, 10],
+                [15, 15, 1, 1],
+                [2, 2, 1, 1],
+            ],
+            [
+                self._ObjectWithRectAttribute(Rect(1, 1, 10, 10)),
+                self._ObjectWithRectAttribute(Rect(5, 5, 10, 10)),
+                self._ObjectWithRectAttribute(Rect(15, 15, 1, 1)),
+                self._ObjectWithRectAttribute(Rect(2, 2, 1, 1)),
+            ],
+            [
+                self._ObjectWithCallableRectAttribute(Rect(1, 1, 10, 10)),
+                self._ObjectWithCallableRectAttribute(Rect(5, 5, 10, 10)),
+                self._ObjectWithCallableRectAttribute(Rect(15, 15, 1, 1)),
+                self._ObjectWithCallableRectAttribute(Rect(2, 2, 1, 1)),
+            ],
+            [
+                self._ObjectWithCallableRectAttribute(
+                    self._ObjectWithRectAttribute(Rect(1, 1, 10, 10))
+                ),
+                self._ObjectWithCallableRectAttribute(
+                    self._ObjectWithRectAttribute(Rect(5, 5, 10, 10))
+                ),
+                self._ObjectWithCallableRectAttribute(
+                    self._ObjectWithRectAttribute(Rect(15, 15, 1, 1))
+                ),
+                self._ObjectWithCallableRectAttribute(
+                    self._ObjectWithRectAttribute(Rect(2, 2, 1, 1))
+                ),
+            ],
+            [
+                self._ObjectWithRectProperty(Rect(1, 1, 10, 10)),
+                self._ObjectWithRectProperty(Rect(5, 5, 10, 10)),
+                self._ObjectWithRectProperty(Rect(15, 15, 1, 1)),
+                self._ObjectWithRectProperty(Rect(2, 2, 1, 1)),
+            ],
+        ]
+        for things in types_to_test:
+            with self.subTest(type=things[0].__class__.__name__):
+                # act
+                actual = r.collideobjectsall(things, key=None)
+                # assert
+                self.assertEqual(actual, [things[0], things[1], things[3]])
+
+        types_to_test = [
+            [Rect(50, 50, 1, 1), Rect(20, 20, 5, 5)],
+            [(50, 50, 1, 1), (20, 20, 5, 5)],
+            [((50, 50), (1, 1)), ((20, 20), (5, 5))],
+            [[50, 50, 1, 1], [20, 20, 5, 5]],
+            [
+                self._ObjectWithRectAttribute(Rect(50, 50, 1, 1)),
+                self._ObjectWithRectAttribute(Rect(20, 20, 5, 5)),
+            ],
+            [
+                self._ObjectWithCallableRectAttribute(Rect(50, 50, 1, 1)),
+                self._ObjectWithCallableRectAttribute(Rect(20, 20, 5, 5)),
+            ],
+            [
+                self._ObjectWithCallableRectAttribute(Rect(50, 50, 1, 1)),
+                self._ObjectWithCallableRectAttribute(Rect(20, 20, 5, 5)),
+            ],
+            [
+                self._ObjectWithRectProperty(Rect(50, 50, 1, 1)),
+                self._ObjectWithRectProperty(Rect(20, 20, 5, 5)),
+            ],
+        ]
+        for f in types_to_test:
+            with self.subTest(type=f[0].__class__.__name__, expected=None):
+                # act
+                actual = r.collideobjectsall(f)
+                # assert
+                self.assertFalse(actual)
+
+    def test_collideobjectsall_list_of_object_with_multiple_rect_attribute(self):
+        r = Rect(1, 1, 10, 10)
+
+        things = [
+            self._ObjectWithMultipleRectAttribute(
+                Rect(1, 1, 10, 10), Rect(5, 5, 1, 1), Rect(-73, 3, 3, 3)
+            ),
+            self._ObjectWithMultipleRectAttribute(
+                Rect(5, 5, 10, 10), Rect(-5, -5, 10, 10), Rect(3, 3, 3, 3)
+            ),
+            self._ObjectWithMultipleRectAttribute(
+                Rect(15, 15, 1, 1), Rect(100, 1, 1, 1), Rect(3, 83, 3, 3)
+            ),
+            self._ObjectWithMultipleRectAttribute(
+                Rect(2, 2, 1, 1), Rect(1, -81, 10, 10), Rect(3, 8, 3, 3)
+            ),
+        ]
+        self.assertEqual(
+            r.collideobjectsall(things, key=lambda o: o.rect1),
+            [things[0], things[1], things[3]],
+        )
+        self.assertEqual(
+            r.collideobjectsall(things, key=lambda o: o.rect2), [things[0], things[1]]
+        )
+        self.assertEqual(
+            r.collideobjectsall(things, key=lambda o: o.rect3), [things[1], things[3]]
+        )
+
+        f = [
+            self._ObjectWithMultipleRectAttribute(
+                Rect(50, 50, 1, 1), Rect(11, 1, 1, 1), Rect(2, -32, 2, 2)
+            ),
+            self._ObjectWithMultipleRectAttribute(
+                Rect(20, 20, 5, 5), Rect(1, 11, 1, 1), Rect(-20, 2, 2, 2)
+            ),
+        ]
+        self.assertFalse(r.collideobjectsall(f, key=lambda o: o.rect1))
+        self.assertFalse(r.collideobjectsall(f, key=lambda o: o.rect2))
+        self.assertFalse(r.collideobjectsall(f, key=lambda o: o.rect3))
+
+    def test_fit(self):
+        # __doc__ (as of 2008-08-02) for pygame.rect.Rect.fit:
+
+        # Rect.fit(Rect): return Rect
+        # resize and move a rectangle with aspect ratio
+        #
+        # 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 be smaller than the target in either width or height.
+
+        r = Rect(10, 10, 30, 30)
+
+        r2 = Rect(30, 30, 15, 10)
+
+        f = r.fit(r2)
+        self.assertTrue(r2.contains(f))
+
+        f2 = r2.fit(r)
+        self.assertTrue(r.contains(f2))
+
+    def test_copy(self):
+        r = Rect(1, 2, 10, 20)
+        c = r.copy()
+        self.assertEqual(c, r)
+
+    def test_subscript(self):
+        r = Rect(1, 2, 3, 4)
+        self.assertEqual(r[0], 1)
+        self.assertEqual(r[1], 2)
+        self.assertEqual(r[2], 3)
+        self.assertEqual(r[3], 4)
+        self.assertEqual(r[-1], 4)
+        self.assertEqual(r[-2], 3)
+        self.assertEqual(r[-4], 1)
+        self.assertRaises(IndexError, r.__getitem__, 5)
+        self.assertRaises(IndexError, r.__getitem__, -5)
+        self.assertEqual(r[0:2], [1, 2])
+        self.assertEqual(r[0:4], [1, 2, 3, 4])
+        self.assertEqual(r[0:-1], [1, 2, 3])
+        self.assertEqual(r[:], [1, 2, 3, 4])
+        self.assertEqual(r[...], [1, 2, 3, 4])
+        self.assertEqual(r[0:4:2], [1, 3])
+        self.assertEqual(r[0:4:3], [1, 4])
+        self.assertEqual(r[3::-1], [4, 3, 2, 1])
+        self.assertRaises(TypeError, r.__getitem__, None)
+
+    def test_ass_subscript(self):
+        r = Rect(0, 0, 0, 0)
+        r[...] = 1, 2, 3, 4
+        self.assertEqual(r, [1, 2, 3, 4])
+        self.assertRaises(TypeError, r.__setitem__, None, 0)
+        self.assertEqual(r, [1, 2, 3, 4])
+        self.assertRaises(TypeError, r.__setitem__, 0, "")
+        self.assertEqual(r, [1, 2, 3, 4])
+        self.assertRaises(IndexError, r.__setitem__, 4, 0)
+        self.assertEqual(r, [1, 2, 3, 4])
+        self.assertRaises(IndexError, r.__setitem__, -5, 0)
+        self.assertEqual(r, [1, 2, 3, 4])
+        r[0] = 10
+        self.assertEqual(r, [10, 2, 3, 4])
+        r[3] = 40
+        self.assertEqual(r, [10, 2, 3, 40])
+        r[-1] = 400
+        self.assertEqual(r, [10, 2, 3, 400])
+        r[-4] = 100
+        self.assertEqual(r, [100, 2, 3, 400])
+        r[1:3] = 0
+        self.assertEqual(r, [100, 0, 0, 400])
+        r[...] = 0
+        self.assertEqual(r, [0, 0, 0, 0])
+        r[:] = 9
+        self.assertEqual(r, [9, 9, 9, 9])
+        r[:] = 11, 12, 13, 14
+        self.assertEqual(r, [11, 12, 13, 14])
+        r[::-1] = r
+        self.assertEqual(r, [14, 13, 12, 11])
+
+    def test_ass_subscript_deletion(self):
+        r = Rect(0, 0, 0, 0)
+        with self.assertRaises(TypeError):
+            del r[0]
+
+        with self.assertRaises(TypeError):
+            del r[0:2]
+
+        with self.assertRaises(TypeError):
+            del r[...]
+
+    def test_collection_abc(self):
+        r = Rect(64, 70, 75, 30)
+        self.assertTrue(isinstance(r, Collection))
+        self.assertFalse(isinstance(r, Sequence))
+
+
+class SubclassTest(unittest.TestCase):
+    class MyRect(Rect):
+        def __init__(self, *args, **kwds):
+            super(SubclassTest.MyRect, self).__init__(*args, **kwds)
+            self.an_attribute = True
+
+    def test_copy(self):
+        mr1 = self.MyRect(1, 2, 10, 20)
+        self.assertTrue(mr1.an_attribute)
+        mr2 = mr1.copy()
+        self.assertTrue(isinstance(mr2, self.MyRect))
+        self.assertRaises(AttributeError, getattr, mr2, "an_attribute")
+
+    def test_move(self):
+        mr1 = self.MyRect(1, 2, 10, 20)
+        self.assertTrue(mr1.an_attribute)
+        mr2 = mr1.move(1, 2)
+        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)
+        mr2 = mr1.inflate(2, 4)
+        self.assertTrue(isinstance(mr2, self.MyRect))
+        self.assertRaises(AttributeError, getattr, mr2, "an_attribute")
+
+    def test_clamp(self):
+        mr1 = self.MyRect(19, 12, 5, 5)
+        self.assertTrue(mr1.an_attribute)
+        mr2 = mr1.clamp(Rect(10, 10, 10, 10))
+        self.assertTrue(isinstance(mr2, self.MyRect))
+        self.assertRaises(AttributeError, getattr, mr2, "an_attribute")
+
+    def test_clip(self):
+        mr1 = self.MyRect(1, 2, 3, 4)
+        self.assertTrue(mr1.an_attribute)
+        mr2 = mr1.clip(Rect(0, 0, 3, 4))
+        self.assertTrue(isinstance(mr2, self.MyRect))
+        self.assertRaises(AttributeError, getattr, mr2, "an_attribute")
+
+    def test_union(self):
+        mr1 = self.MyRect(1, 1, 1, 2)
+        self.assertTrue(mr1.an_attribute)
+        mr2 = mr1.union(Rect(-2, -2, 1, 2))
+        self.assertTrue(isinstance(mr2, self.MyRect))
+        self.assertRaises(AttributeError, getattr, mr2, "an_attribute")
+
+    def test_unionall(self):
+        mr1 = self.MyRect(0, 0, 1, 1)
+        self.assertTrue(mr1.an_attribute)
+        mr2 = mr1.unionall([Rect(-2, -2, 1, 1), Rect(2, 2, 1, 1)])
+        self.assertTrue(isinstance(mr2, self.MyRect))
+        self.assertRaises(AttributeError, getattr, mr2, "an_attribute")
+
+    def test_fit(self):
+        mr1 = self.MyRect(10, 10, 30, 30)
+        self.assertTrue(mr1.an_attribute)
+        mr2 = mr1.fit(Rect(30, 30, 15, 10))
+        self.assertTrue(isinstance(mr2, self.MyRect))
+        self.assertRaises(AttributeError, getattr, mr2, "an_attribute")
+
+    def test_collection_abc(self):
+        mr1 = self.MyRect(64, 70, 75, 30)
+        self.assertTrue(isinstance(mr1, Collection))
+        self.assertFalse(isinstance(mr1, Sequence))
+
+
+if __name__ == "__main__":
+    unittest.main()
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/__init__.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/__init__.py
new file mode 100644
index 0000000..1bb8bf6
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/__init__.py
@@ -0,0 +1 @@
+# empty
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/__pycache__/__init__.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/__pycache__/__init__.cpython-312.pyc
new file mode 100644
index 0000000..69d76f2
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/__pycache__/__init__.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/__pycache__/run_tests__test.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/__pycache__/run_tests__test.cpython-312.pyc
new file mode 100644
index 0000000..b76ae1c
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/__pycache__/run_tests__test.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/all_ok/__init__.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/all_ok/__init__.py
new file mode 100644
index 0000000..1bb8bf6
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/all_ok/__init__.py
@@ -0,0 +1 @@
+# empty
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/all_ok/__pycache__/__init__.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/all_ok/__pycache__/__init__.cpython-312.pyc
new file mode 100644
index 0000000..a9624b4
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/all_ok/__pycache__/__init__.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/all_ok/__pycache__/fake_2_test.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/all_ok/__pycache__/fake_2_test.cpython-312.pyc
new file mode 100644
index 0000000..a4009b5
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/all_ok/__pycache__/fake_2_test.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/all_ok/__pycache__/fake_3_test.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/all_ok/__pycache__/fake_3_test.cpython-312.pyc
new file mode 100644
index 0000000..4bbd391
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/all_ok/__pycache__/fake_3_test.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/all_ok/__pycache__/fake_4_test.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/all_ok/__pycache__/fake_4_test.cpython-312.pyc
new file mode 100644
index 0000000..b666467
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/all_ok/__pycache__/fake_4_test.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/all_ok/__pycache__/fake_5_test.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/all_ok/__pycache__/fake_5_test.cpython-312.pyc
new file mode 100644
index 0000000..26c9396
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/all_ok/__pycache__/fake_5_test.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/all_ok/__pycache__/fake_6_test.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/all_ok/__pycache__/fake_6_test.cpython-312.pyc
new file mode 100644
index 0000000..4d3ae7f
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/all_ok/__pycache__/fake_6_test.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/all_ok/__pycache__/no_assertions__ret_code_of_1__test.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/all_ok/__pycache__/no_assertions__ret_code_of_1__test.cpython-312.pyc
new file mode 100644
index 0000000..7f456d5
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/all_ok/__pycache__/no_assertions__ret_code_of_1__test.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/all_ok/__pycache__/zero_tests_test.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/all_ok/__pycache__/zero_tests_test.cpython-312.pyc
new file mode 100644
index 0000000..7f08916
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/all_ok/__pycache__/zero_tests_test.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/all_ok/fake_2_test.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/all_ok/fake_2_test.py
new file mode 100644
index 0000000..3be92e1
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/all_ok/fake_2_test.py
@@ -0,0 +1,39 @@
+if __name__ == "__main__":
+    import sys
+    import os
+
+    pkg_dir = os.path.split(
+        os.path.split(os.path.split(os.path.abspath(__file__))[0])[0]
+    )[0]
+    parent_dir, pkg_name = os.path.split(pkg_dir)
+    is_pygame_pkg = pkg_name == "tests" and os.path.split(parent_dir)[1] == "pygame"
+    if not is_pygame_pkg:
+        sys.path.insert(0, parent_dir)
+else:
+    is_pygame_pkg = __name__.startswith("pygame.tests.")
+
+import unittest
+
+
+class KeyModuleTest(unittest.TestCase):
+    def test_get_focused(self):
+        self.assertTrue(True)
+
+    def test_get_mods(self):
+        self.assertTrue(True)
+
+    def test_get_pressed(self):
+        self.assertTrue(True)
+
+    def test_name(self):
+        self.assertTrue(True)
+
+    def test_set_mods(self):
+        self.assertTrue(True)
+
+    def test_set_repeat(self):
+        self.assertTrue(True)
+
+
+if __name__ == "__main__":
+    unittest.main()
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/all_ok/fake_3_test.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/all_ok/fake_3_test.py
new file mode 100644
index 0000000..3be92e1
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/all_ok/fake_3_test.py
@@ -0,0 +1,39 @@
+if __name__ == "__main__":
+    import sys
+    import os
+
+    pkg_dir = os.path.split(
+        os.path.split(os.path.split(os.path.abspath(__file__))[0])[0]
+    )[0]
+    parent_dir, pkg_name = os.path.split(pkg_dir)
+    is_pygame_pkg = pkg_name == "tests" and os.path.split(parent_dir)[1] == "pygame"
+    if not is_pygame_pkg:
+        sys.path.insert(0, parent_dir)
+else:
+    is_pygame_pkg = __name__.startswith("pygame.tests.")
+
+import unittest
+
+
+class KeyModuleTest(unittest.TestCase):
+    def test_get_focused(self):
+        self.assertTrue(True)
+
+    def test_get_mods(self):
+        self.assertTrue(True)
+
+    def test_get_pressed(self):
+        self.assertTrue(True)
+
+    def test_name(self):
+        self.assertTrue(True)
+
+    def test_set_mods(self):
+        self.assertTrue(True)
+
+    def test_set_repeat(self):
+        self.assertTrue(True)
+
+
+if __name__ == "__main__":
+    unittest.main()
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/all_ok/fake_4_test.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/all_ok/fake_4_test.py
new file mode 100644
index 0000000..3be92e1
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/all_ok/fake_4_test.py
@@ -0,0 +1,39 @@
+if __name__ == "__main__":
+    import sys
+    import os
+
+    pkg_dir = os.path.split(
+        os.path.split(os.path.split(os.path.abspath(__file__))[0])[0]
+    )[0]
+    parent_dir, pkg_name = os.path.split(pkg_dir)
+    is_pygame_pkg = pkg_name == "tests" and os.path.split(parent_dir)[1] == "pygame"
+    if not is_pygame_pkg:
+        sys.path.insert(0, parent_dir)
+else:
+    is_pygame_pkg = __name__.startswith("pygame.tests.")
+
+import unittest
+
+
+class KeyModuleTest(unittest.TestCase):
+    def test_get_focused(self):
+        self.assertTrue(True)
+
+    def test_get_mods(self):
+        self.assertTrue(True)
+
+    def test_get_pressed(self):
+        self.assertTrue(True)
+
+    def test_name(self):
+        self.assertTrue(True)
+
+    def test_set_mods(self):
+        self.assertTrue(True)
+
+    def test_set_repeat(self):
+        self.assertTrue(True)
+
+
+if __name__ == "__main__":
+    unittest.main()
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/all_ok/fake_5_test.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/all_ok/fake_5_test.py
new file mode 100644
index 0000000..3be92e1
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/all_ok/fake_5_test.py
@@ -0,0 +1,39 @@
+if __name__ == "__main__":
+    import sys
+    import os
+
+    pkg_dir = os.path.split(
+        os.path.split(os.path.split(os.path.abspath(__file__))[0])[0]
+    )[0]
+    parent_dir, pkg_name = os.path.split(pkg_dir)
+    is_pygame_pkg = pkg_name == "tests" and os.path.split(parent_dir)[1] == "pygame"
+    if not is_pygame_pkg:
+        sys.path.insert(0, parent_dir)
+else:
+    is_pygame_pkg = __name__.startswith("pygame.tests.")
+
+import unittest
+
+
+class KeyModuleTest(unittest.TestCase):
+    def test_get_focused(self):
+        self.assertTrue(True)
+
+    def test_get_mods(self):
+        self.assertTrue(True)
+
+    def test_get_pressed(self):
+        self.assertTrue(True)
+
+    def test_name(self):
+        self.assertTrue(True)
+
+    def test_set_mods(self):
+        self.assertTrue(True)
+
+    def test_set_repeat(self):
+        self.assertTrue(True)
+
+
+if __name__ == "__main__":
+    unittest.main()
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/all_ok/fake_6_test.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/all_ok/fake_6_test.py
new file mode 100644
index 0000000..3be92e1
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/all_ok/fake_6_test.py
@@ -0,0 +1,39 @@
+if __name__ == "__main__":
+    import sys
+    import os
+
+    pkg_dir = os.path.split(
+        os.path.split(os.path.split(os.path.abspath(__file__))[0])[0]
+    )[0]
+    parent_dir, pkg_name = os.path.split(pkg_dir)
+    is_pygame_pkg = pkg_name == "tests" and os.path.split(parent_dir)[1] == "pygame"
+    if not is_pygame_pkg:
+        sys.path.insert(0, parent_dir)
+else:
+    is_pygame_pkg = __name__.startswith("pygame.tests.")
+
+import unittest
+
+
+class KeyModuleTest(unittest.TestCase):
+    def test_get_focused(self):
+        self.assertTrue(True)
+
+    def test_get_mods(self):
+        self.assertTrue(True)
+
+    def test_get_pressed(self):
+        self.assertTrue(True)
+
+    def test_name(self):
+        self.assertTrue(True)
+
+    def test_set_mods(self):
+        self.assertTrue(True)
+
+    def test_set_repeat(self):
+        self.assertTrue(True)
+
+
+if __name__ == "__main__":
+    unittest.main()
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/all_ok/no_assertions__ret_code_of_1__test.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/all_ok/no_assertions__ret_code_of_1__test.py
new file mode 100644
index 0000000..0ba0e94
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/all_ok/no_assertions__ret_code_of_1__test.py
@@ -0,0 +1,39 @@
+if __name__ == "__main__":
+    import sys
+    import os
+
+    pkg_dir = os.path.split(
+        os.path.split(os.path.split(os.path.abspath(__file__))[0])[0]
+    )[0]
+    parent_dir, pkg_name = os.path.split(pkg_dir)
+    is_pygame_pkg = pkg_name == "tests" and os.path.split(parent_dir)[1] == "pygame"
+    if not is_pygame_pkg:
+        sys.path.insert(0, parent_dir)
+else:
+    is_pygame_pkg = __name__.startswith("pygame.tests.")
+
+import unittest
+
+
+class KeyModuleTest(unittest.TestCase):
+    def test_get_focused(self):
+        pass
+
+    def test_get_mods(self):
+        pass
+
+    def test_get_pressed(self):
+        pass
+
+    def test_name(self):
+        pass
+
+    def test_set_mods(self):
+        pass
+
+    def test_set_repeat(self):
+        pass
+
+
+if __name__ == "__main__":
+    unittest.main()
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/all_ok/zero_tests_test.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/all_ok/zero_tests_test.py
new file mode 100644
index 0000000..649055a
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/all_ok/zero_tests_test.py
@@ -0,0 +1,23 @@
+if __name__ == "__main__":
+    import sys
+    import os
+
+    pkg_dir = os.path.split(
+        os.path.split(os.path.split(os.path.abspath(__file__))[0])[0]
+    )[0]
+    parent_dir, pkg_name = os.path.split(pkg_dir)
+    is_pygame_pkg = pkg_name == "tests" and os.path.split(parent_dir)[1] == "pygame"
+    if not is_pygame_pkg:
+        sys.path.insert(0, parent_dir)
+else:
+    is_pygame_pkg = __name__.startswith("pygame.tests.")
+
+import unittest
+
+
+class KeyModuleTest(unittest.TestCase):
+    pass
+
+
+if __name__ == "__main__":
+    unittest.main()
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/everything/__init__.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/everything/__init__.py
new file mode 100644
index 0000000..1bb8bf6
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/everything/__init__.py
@@ -0,0 +1 @@
+# empty
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/everything/__pycache__/__init__.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/everything/__pycache__/__init__.cpython-312.pyc
new file mode 100644
index 0000000..dc2dd28
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/everything/__pycache__/__init__.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/everything/__pycache__/fake_2_test.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/everything/__pycache__/fake_2_test.cpython-312.pyc
new file mode 100644
index 0000000..3085e52
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/everything/__pycache__/fake_2_test.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/everything/__pycache__/incomplete_todo_test.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/everything/__pycache__/incomplete_todo_test.cpython-312.pyc
new file mode 100644
index 0000000..40904ae
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/everything/__pycache__/incomplete_todo_test.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/everything/__pycache__/magic_tag_test.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/everything/__pycache__/magic_tag_test.cpython-312.pyc
new file mode 100644
index 0000000..b38ae61
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/everything/__pycache__/magic_tag_test.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/everything/__pycache__/sleep_test.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/everything/__pycache__/sleep_test.cpython-312.pyc
new file mode 100644
index 0000000..e4ee200
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/everything/__pycache__/sleep_test.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/everything/fake_2_test.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/everything/fake_2_test.py
new file mode 100644
index 0000000..3be92e1
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/everything/fake_2_test.py
@@ -0,0 +1,39 @@
+if __name__ == "__main__":
+    import sys
+    import os
+
+    pkg_dir = os.path.split(
+        os.path.split(os.path.split(os.path.abspath(__file__))[0])[0]
+    )[0]
+    parent_dir, pkg_name = os.path.split(pkg_dir)
+    is_pygame_pkg = pkg_name == "tests" and os.path.split(parent_dir)[1] == "pygame"
+    if not is_pygame_pkg:
+        sys.path.insert(0, parent_dir)
+else:
+    is_pygame_pkg = __name__.startswith("pygame.tests.")
+
+import unittest
+
+
+class KeyModuleTest(unittest.TestCase):
+    def test_get_focused(self):
+        self.assertTrue(True)
+
+    def test_get_mods(self):
+        self.assertTrue(True)
+
+    def test_get_pressed(self):
+        self.assertTrue(True)
+
+    def test_name(self):
+        self.assertTrue(True)
+
+    def test_set_mods(self):
+        self.assertTrue(True)
+
+    def test_set_repeat(self):
+        self.assertTrue(True)
+
+
+if __name__ == "__main__":
+    unittest.main()
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/everything/incomplete_todo_test.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/everything/incomplete_todo_test.py
new file mode 100644
index 0000000..bdd8a3b
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/everything/incomplete_todo_test.py
@@ -0,0 +1,39 @@
+if __name__ == "__main__":
+    import sys
+    import os
+
+    pkg_dir = os.path.split(
+        os.path.split(os.path.split(os.path.abspath(__file__))[0])[0]
+    )[0]
+    parent_dir, pkg_name = os.path.split(pkg_dir)
+    is_pygame_pkg = pkg_name == "tests" and os.path.split(parent_dir)[1] == "pygame"
+    if not is_pygame_pkg:
+        sys.path.insert(0, parent_dir)
+else:
+    is_pygame_pkg = __name__.startswith("pygame.tests.")
+
+import unittest
+
+
+class KeyModuleTest(unittest.TestCase):
+    def test_get_focused(self):
+        self.assertTrue(True)
+
+    def test_get_mods(self):
+        self.assertTrue(True)
+
+    def todo_test_get_pressed(self):
+        self.assertTrue(True)
+
+    def test_name(self):
+        self.assertTrue(True)
+
+    def todo_test_set_mods(self):
+        self.assertTrue(True)
+
+    def test_set_repeat(self):
+        self.assertTrue(True)
+
+
+if __name__ == "__main__":
+    unittest.main()
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/everything/magic_tag_test.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/everything/magic_tag_test.py
new file mode 100644
index 0000000..126bc2b
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/everything/magic_tag_test.py
@@ -0,0 +1,38 @@
+__tags__ = ["magic"]
+
+if __name__ == "__main__":
+    import sys
+    import os
+
+    pkg_dir = os.path.split(
+        os.path.split(os.path.split(os.path.abspath(__file__))[0])[0]
+    )[0]
+    parent_dir, pkg_name = os.path.split(pkg_dir)
+    is_pygame_pkg = pkg_name == "tests" and os.path.split(parent_dir)[1] == "pygame"
+    if not is_pygame_pkg:
+        sys.path.insert(0, parent_dir)
+else:
+    is_pygame_pkg = __name__.startswith("pygame.tests.")
+
+import unittest
+
+
+class KeyModuleTest(unittest.TestCase):
+    def test_get_focused(self):
+        self.assertTrue(True)
+
+    def test_get_mods(self):
+        self.assertTrue(True)
+
+    def test_get_pressed(self):
+        self.assertTrue(True)
+
+    def test_name(self):
+        self.assertTrue(True)
+
+    def test_set_mods(self):
+        self.assertTrue(True)
+
+
+if __name__ == "__main__":
+    unittest.main()
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/everything/sleep_test.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/everything/sleep_test.py
new file mode 100644
index 0000000..468c75f
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/everything/sleep_test.py
@@ -0,0 +1,29 @@
+if __name__ == "__main__":
+    import sys
+    import os
+
+    pkg_dir = os.path.split(
+        os.path.split(os.path.split(os.path.abspath(__file__))[0])[0]
+    )[0]
+    parent_dir, pkg_name = os.path.split(pkg_dir)
+    is_pygame_pkg = pkg_name == "tests" and os.path.split(parent_dir)[1] == "pygame"
+    if not is_pygame_pkg:
+        sys.path.insert(0, parent_dir)
+else:
+    is_pygame_pkg = __name__.startswith("pygame.tests.")
+
+import unittest
+
+import time
+
+
+class KeyModuleTest(unittest.TestCase):
+    def test_get_focused(self):
+        stop_time = time.time() + 10.0
+        while time.time() < stop_time:
+            time.sleep(1)
+        self.assertTrue(True)
+
+
+if __name__ == "__main__":
+    unittest.main()
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/exclude/__init__.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/exclude/__init__.py
new file mode 100644
index 0000000..1bb8bf6
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/exclude/__init__.py
@@ -0,0 +1 @@
+# empty
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/exclude/__pycache__/__init__.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/exclude/__pycache__/__init__.cpython-312.pyc
new file mode 100644
index 0000000..613e499
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/exclude/__pycache__/__init__.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/exclude/__pycache__/fake_2_test.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/exclude/__pycache__/fake_2_test.cpython-312.pyc
new file mode 100644
index 0000000..47f4892
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/exclude/__pycache__/fake_2_test.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/exclude/__pycache__/invisible_tag_test.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/exclude/__pycache__/invisible_tag_test.cpython-312.pyc
new file mode 100644
index 0000000..da4ae8b
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/exclude/__pycache__/invisible_tag_test.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/exclude/__pycache__/magic_tag_test.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/exclude/__pycache__/magic_tag_test.cpython-312.pyc
new file mode 100644
index 0000000..59e9159
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/exclude/__pycache__/magic_tag_test.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/exclude/fake_2_test.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/exclude/fake_2_test.py
new file mode 100644
index 0000000..3be92e1
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/exclude/fake_2_test.py
@@ -0,0 +1,39 @@
+if __name__ == "__main__":
+    import sys
+    import os
+
+    pkg_dir = os.path.split(
+        os.path.split(os.path.split(os.path.abspath(__file__))[0])[0]
+    )[0]
+    parent_dir, pkg_name = os.path.split(pkg_dir)
+    is_pygame_pkg = pkg_name == "tests" and os.path.split(parent_dir)[1] == "pygame"
+    if not is_pygame_pkg:
+        sys.path.insert(0, parent_dir)
+else:
+    is_pygame_pkg = __name__.startswith("pygame.tests.")
+
+import unittest
+
+
+class KeyModuleTest(unittest.TestCase):
+    def test_get_focused(self):
+        self.assertTrue(True)
+
+    def test_get_mods(self):
+        self.assertTrue(True)
+
+    def test_get_pressed(self):
+        self.assertTrue(True)
+
+    def test_name(self):
+        self.assertTrue(True)
+
+    def test_set_mods(self):
+        self.assertTrue(True)
+
+    def test_set_repeat(self):
+        self.assertTrue(True)
+
+
+if __name__ == "__main__":
+    unittest.main()
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/exclude/invisible_tag_test.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/exclude/invisible_tag_test.py
new file mode 100644
index 0000000..3ef959a
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/exclude/invisible_tag_test.py
@@ -0,0 +1,41 @@
+__tags__ = ["invisible"]
+
+if __name__ == "__main__":
+    import sys
+    import os
+
+    pkg_dir = os.path.split(
+        os.path.split(os.path.split(os.path.abspath(__file__))[0])[0]
+    )[0]
+    parent_dir, pkg_name = os.path.split(pkg_dir)
+    is_pygame_pkg = pkg_name == "tests" and os.path.split(parent_dir)[1] == "pygame"
+    if not is_pygame_pkg:
+        sys.path.insert(0, parent_dir)
+else:
+    is_pygame_pkg = __name__.startswith("pygame.tests.")
+
+import unittest
+
+
+class KeyModuleTest(unittest.TestCase):
+    def test_get_focused(self):
+        self.assertTrue(True)
+
+    def test_get_mods(self):
+        self.assertTrue(True)
+
+    def test_get_pressed(self):
+        self.assertTrue(True)
+
+    def test_name(self):
+        self.assertTrue(True)
+
+    def test_set_mods(self):
+        self.assertTrue(True)
+
+    def test_set_repeat(self):
+        self.assertTrue(True)
+
+
+if __name__ == "__main__":
+    unittest.main()
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/exclude/magic_tag_test.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/exclude/magic_tag_test.py
new file mode 100644
index 0000000..126bc2b
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/exclude/magic_tag_test.py
@@ -0,0 +1,38 @@
+__tags__ = ["magic"]
+
+if __name__ == "__main__":
+    import sys
+    import os
+
+    pkg_dir = os.path.split(
+        os.path.split(os.path.split(os.path.abspath(__file__))[0])[0]
+    )[0]
+    parent_dir, pkg_name = os.path.split(pkg_dir)
+    is_pygame_pkg = pkg_name == "tests" and os.path.split(parent_dir)[1] == "pygame"
+    if not is_pygame_pkg:
+        sys.path.insert(0, parent_dir)
+else:
+    is_pygame_pkg = __name__.startswith("pygame.tests.")
+
+import unittest
+
+
+class KeyModuleTest(unittest.TestCase):
+    def test_get_focused(self):
+        self.assertTrue(True)
+
+    def test_get_mods(self):
+        self.assertTrue(True)
+
+    def test_get_pressed(self):
+        self.assertTrue(True)
+
+    def test_name(self):
+        self.assertTrue(True)
+
+    def test_set_mods(self):
+        self.assertTrue(True)
+
+
+if __name__ == "__main__":
+    unittest.main()
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/failures1/__init__.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/failures1/__init__.py
new file mode 100644
index 0000000..1bb8bf6
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/failures1/__init__.py
@@ -0,0 +1 @@
+# empty
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/failures1/__pycache__/__init__.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/failures1/__pycache__/__init__.cpython-312.pyc
new file mode 100644
index 0000000..850c713
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/failures1/__pycache__/__init__.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/failures1/__pycache__/fake_2_test.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/failures1/__pycache__/fake_2_test.cpython-312.pyc
new file mode 100644
index 0000000..cc03e38
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/failures1/__pycache__/fake_2_test.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/failures1/__pycache__/fake_3_test.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/failures1/__pycache__/fake_3_test.cpython-312.pyc
new file mode 100644
index 0000000..0aea4b2
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/failures1/__pycache__/fake_3_test.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/failures1/__pycache__/fake_4_test.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/failures1/__pycache__/fake_4_test.cpython-312.pyc
new file mode 100644
index 0000000..960cf06
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/failures1/__pycache__/fake_4_test.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/failures1/fake_2_test.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/failures1/fake_2_test.py
new file mode 100644
index 0000000..3be92e1
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/failures1/fake_2_test.py
@@ -0,0 +1,39 @@
+if __name__ == "__main__":
+    import sys
+    import os
+
+    pkg_dir = os.path.split(
+        os.path.split(os.path.split(os.path.abspath(__file__))[0])[0]
+    )[0]
+    parent_dir, pkg_name = os.path.split(pkg_dir)
+    is_pygame_pkg = pkg_name == "tests" and os.path.split(parent_dir)[1] == "pygame"
+    if not is_pygame_pkg:
+        sys.path.insert(0, parent_dir)
+else:
+    is_pygame_pkg = __name__.startswith("pygame.tests.")
+
+import unittest
+
+
+class KeyModuleTest(unittest.TestCase):
+    def test_get_focused(self):
+        self.assertTrue(True)
+
+    def test_get_mods(self):
+        self.assertTrue(True)
+
+    def test_get_pressed(self):
+        self.assertTrue(True)
+
+    def test_name(self):
+        self.assertTrue(True)
+
+    def test_set_mods(self):
+        self.assertTrue(True)
+
+    def test_set_repeat(self):
+        self.assertTrue(True)
+
+
+if __name__ == "__main__":
+    unittest.main()
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/failures1/fake_3_test.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/failures1/fake_3_test.py
new file mode 100644
index 0000000..3be92e1
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/failures1/fake_3_test.py
@@ -0,0 +1,39 @@
+if __name__ == "__main__":
+    import sys
+    import os
+
+    pkg_dir = os.path.split(
+        os.path.split(os.path.split(os.path.abspath(__file__))[0])[0]
+    )[0]
+    parent_dir, pkg_name = os.path.split(pkg_dir)
+    is_pygame_pkg = pkg_name == "tests" and os.path.split(parent_dir)[1] == "pygame"
+    if not is_pygame_pkg:
+        sys.path.insert(0, parent_dir)
+else:
+    is_pygame_pkg = __name__.startswith("pygame.tests.")
+
+import unittest
+
+
+class KeyModuleTest(unittest.TestCase):
+    def test_get_focused(self):
+        self.assertTrue(True)
+
+    def test_get_mods(self):
+        self.assertTrue(True)
+
+    def test_get_pressed(self):
+        self.assertTrue(True)
+
+    def test_name(self):
+        self.assertTrue(True)
+
+    def test_set_mods(self):
+        self.assertTrue(True)
+
+    def test_set_repeat(self):
+        self.assertTrue(True)
+
+
+if __name__ == "__main__":
+    unittest.main()
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/failures1/fake_4_test.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/failures1/fake_4_test.py
new file mode 100644
index 0000000..1e75fea
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/failures1/fake_4_test.py
@@ -0,0 +1,41 @@
+if __name__ == "__main__":
+    import sys
+    import os
+
+    pkg_dir = os.path.split(
+        os.path.split(os.path.split(os.path.abspath(__file__))[0])[0]
+    )[0]
+    parent_dir, pkg_name = os.path.split(pkg_dir)
+    is_pygame_pkg = pkg_name == "tests" and os.path.split(parent_dir)[1] == "pygame"
+    if not is_pygame_pkg:
+        sys.path.insert(0, parent_dir)
+else:
+    is_pygame_pkg = __name__.startswith("pygame.tests.")
+
+import unittest
+
+
+class KeyModuleTest(unittest.TestCase):
+    def test_get_focused(self):
+        self.assertTrue(True)
+
+    def test_get_mods(self):
+        self.assertTrue(True)
+
+    def test_get_pressed(self):
+        self.assertTrue(False, "Some Jibberish")
+
+    def test_name(self):
+        self.assertTrue(True)
+
+    def test_set_mods(self):
+        if 1:
+            if 1:
+                assert False
+
+    def test_set_repeat(self):
+        self.assertTrue(True)
+
+
+if __name__ == "__main__":
+    unittest.main()
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/incomplete/__init__.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/incomplete/__init__.py
new file mode 100644
index 0000000..1bb8bf6
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/incomplete/__init__.py
@@ -0,0 +1 @@
+# empty
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/incomplete/__pycache__/__init__.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/incomplete/__pycache__/__init__.cpython-312.pyc
new file mode 100644
index 0000000..e814fcc
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/incomplete/__pycache__/__init__.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/incomplete/__pycache__/fake_2_test.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/incomplete/__pycache__/fake_2_test.cpython-312.pyc
new file mode 100644
index 0000000..7d694a3
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/incomplete/__pycache__/fake_2_test.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/incomplete/__pycache__/fake_3_test.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/incomplete/__pycache__/fake_3_test.cpython-312.pyc
new file mode 100644
index 0000000..72d3c50
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/incomplete/__pycache__/fake_3_test.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/incomplete/fake_2_test.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/incomplete/fake_2_test.py
new file mode 100644
index 0000000..b88f1ae
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/incomplete/fake_2_test.py
@@ -0,0 +1,39 @@
+if __name__ == "__main__":
+    import sys
+    import os
+
+    pkg_dir = os.path.split(
+        os.path.split(os.path.split(os.path.abspath(__file__))[0])[0]
+    )[0]
+    parent_dir, pkg_name = os.path.split(pkg_dir)
+    is_pygame_pkg = pkg_name == "tests" and os.path.split(parent_dir)[1] == "pygame"
+    if not is_pygame_pkg:
+        sys.path.insert(0, parent_dir)
+else:
+    is_pygame_pkg = __name__.startswith("pygame.tests.")
+
+import unittest
+
+
+class KeyModuleTest(unittest.TestCase):
+    def test_get_focused(self):
+        self.assertTrue(True)
+
+    def test_get_mods(self):
+        self.assertTrue(True)
+
+    def todo_test_get_pressed(self):
+        self.fail()
+
+    def test_name(self):
+        self.assertTrue(True)
+
+    def todo_test_set_mods(self):
+        self.fail()
+
+    def test_set_repeat(self):
+        self.assertTrue(True)
+
+
+if __name__ == "__main__":
+    unittest.main()
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/incomplete/fake_3_test.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/incomplete/fake_3_test.py
new file mode 100644
index 0000000..3be92e1
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/incomplete/fake_3_test.py
@@ -0,0 +1,39 @@
+if __name__ == "__main__":
+    import sys
+    import os
+
+    pkg_dir = os.path.split(
+        os.path.split(os.path.split(os.path.abspath(__file__))[0])[0]
+    )[0]
+    parent_dir, pkg_name = os.path.split(pkg_dir)
+    is_pygame_pkg = pkg_name == "tests" and os.path.split(parent_dir)[1] == "pygame"
+    if not is_pygame_pkg:
+        sys.path.insert(0, parent_dir)
+else:
+    is_pygame_pkg = __name__.startswith("pygame.tests.")
+
+import unittest
+
+
+class KeyModuleTest(unittest.TestCase):
+    def test_get_focused(self):
+        self.assertTrue(True)
+
+    def test_get_mods(self):
+        self.assertTrue(True)
+
+    def test_get_pressed(self):
+        self.assertTrue(True)
+
+    def test_name(self):
+        self.assertTrue(True)
+
+    def test_set_mods(self):
+        self.assertTrue(True)
+
+    def test_set_repeat(self):
+        self.assertTrue(True)
+
+
+if __name__ == "__main__":
+    unittest.main()
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/incomplete_todo/__init__.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/incomplete_todo/__init__.py
new file mode 100644
index 0000000..1bb8bf6
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/incomplete_todo/__init__.py
@@ -0,0 +1 @@
+# empty
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/incomplete_todo/__pycache__/__init__.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/incomplete_todo/__pycache__/__init__.cpython-312.pyc
new file mode 100644
index 0000000..94cc272
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/incomplete_todo/__pycache__/__init__.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/incomplete_todo/__pycache__/fake_2_test.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/incomplete_todo/__pycache__/fake_2_test.cpython-312.pyc
new file mode 100644
index 0000000..6764626
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/incomplete_todo/__pycache__/fake_2_test.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/incomplete_todo/__pycache__/fake_3_test.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/incomplete_todo/__pycache__/fake_3_test.cpython-312.pyc
new file mode 100644
index 0000000..2c28827
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/incomplete_todo/__pycache__/fake_3_test.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/incomplete_todo/fake_2_test.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/incomplete_todo/fake_2_test.py
new file mode 100644
index 0000000..bdd8a3b
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/incomplete_todo/fake_2_test.py
@@ -0,0 +1,39 @@
+if __name__ == "__main__":
+    import sys
+    import os
+
+    pkg_dir = os.path.split(
+        os.path.split(os.path.split(os.path.abspath(__file__))[0])[0]
+    )[0]
+    parent_dir, pkg_name = os.path.split(pkg_dir)
+    is_pygame_pkg = pkg_name == "tests" and os.path.split(parent_dir)[1] == "pygame"
+    if not is_pygame_pkg:
+        sys.path.insert(0, parent_dir)
+else:
+    is_pygame_pkg = __name__.startswith("pygame.tests.")
+
+import unittest
+
+
+class KeyModuleTest(unittest.TestCase):
+    def test_get_focused(self):
+        self.assertTrue(True)
+
+    def test_get_mods(self):
+        self.assertTrue(True)
+
+    def todo_test_get_pressed(self):
+        self.assertTrue(True)
+
+    def test_name(self):
+        self.assertTrue(True)
+
+    def todo_test_set_mods(self):
+        self.assertTrue(True)
+
+    def test_set_repeat(self):
+        self.assertTrue(True)
+
+
+if __name__ == "__main__":
+    unittest.main()
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/incomplete_todo/fake_3_test.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/incomplete_todo/fake_3_test.py
new file mode 100644
index 0000000..3be92e1
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/incomplete_todo/fake_3_test.py
@@ -0,0 +1,39 @@
+if __name__ == "__main__":
+    import sys
+    import os
+
+    pkg_dir = os.path.split(
+        os.path.split(os.path.split(os.path.abspath(__file__))[0])[0]
+    )[0]
+    parent_dir, pkg_name = os.path.split(pkg_dir)
+    is_pygame_pkg = pkg_name == "tests" and os.path.split(parent_dir)[1] == "pygame"
+    if not is_pygame_pkg:
+        sys.path.insert(0, parent_dir)
+else:
+    is_pygame_pkg = __name__.startswith("pygame.tests.")
+
+import unittest
+
+
+class KeyModuleTest(unittest.TestCase):
+    def test_get_focused(self):
+        self.assertTrue(True)
+
+    def test_get_mods(self):
+        self.assertTrue(True)
+
+    def test_get_pressed(self):
+        self.assertTrue(True)
+
+    def test_name(self):
+        self.assertTrue(True)
+
+    def test_set_mods(self):
+        self.assertTrue(True)
+
+    def test_set_repeat(self):
+        self.assertTrue(True)
+
+
+if __name__ == "__main__":
+    unittest.main()
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/infinite_loop/__init__.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/infinite_loop/__init__.py
new file mode 100644
index 0000000..1bb8bf6
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/infinite_loop/__init__.py
@@ -0,0 +1 @@
+# empty
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/infinite_loop/__pycache__/__init__.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/infinite_loop/__pycache__/__init__.cpython-312.pyc
new file mode 100644
index 0000000..b7dd850
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/infinite_loop/__pycache__/__init__.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/infinite_loop/__pycache__/fake_1_test.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/infinite_loop/__pycache__/fake_1_test.cpython-312.pyc
new file mode 100644
index 0000000..f1a5b2c
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/infinite_loop/__pycache__/fake_1_test.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/infinite_loop/__pycache__/fake_2_test.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/infinite_loop/__pycache__/fake_2_test.cpython-312.pyc
new file mode 100644
index 0000000..1e7d9e3
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/infinite_loop/__pycache__/fake_2_test.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/infinite_loop/fake_1_test.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/infinite_loop/fake_1_test.py
new file mode 100644
index 0000000..3e9e936
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/infinite_loop/fake_1_test.py
@@ -0,0 +1,40 @@
+if __name__ == "__main__":
+    import sys
+    import os
+
+    pkg_dir = os.path.split(
+        os.path.split(os.path.split(os.path.abspath(__file__))[0])[0]
+    )[0]
+    parent_dir, pkg_name = os.path.split(pkg_dir)
+    is_pygame_pkg = pkg_name == "tests" and os.path.split(parent_dir)[1] == "pygame"
+    if not is_pygame_pkg:
+        sys.path.insert(0, parent_dir)
+else:
+    is_pygame_pkg = __name__.startswith("pygame.tests.")
+
+import unittest
+
+
+class KeyModuleTest(unittest.TestCase):
+    def test_get_focused(self):
+        self.assertTrue(True)
+
+    def test_get_mods(self):
+        while True:
+            pass
+
+    def test_get_pressed(self):
+        self.assertTrue(True)
+
+    def test_name(self):
+        self.assertTrue(True)
+
+    def test_set_mods(self):
+        self.assertTrue(True)
+
+    def test_set_repeat(self):
+        self.assertTrue(True)
+
+
+if __name__ == "__main__":
+    unittest.main()
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/infinite_loop/fake_2_test.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/infinite_loop/fake_2_test.py
new file mode 100644
index 0000000..3be92e1
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/infinite_loop/fake_2_test.py
@@ -0,0 +1,39 @@
+if __name__ == "__main__":
+    import sys
+    import os
+
+    pkg_dir = os.path.split(
+        os.path.split(os.path.split(os.path.abspath(__file__))[0])[0]
+    )[0]
+    parent_dir, pkg_name = os.path.split(pkg_dir)
+    is_pygame_pkg = pkg_name == "tests" and os.path.split(parent_dir)[1] == "pygame"
+    if not is_pygame_pkg:
+        sys.path.insert(0, parent_dir)
+else:
+    is_pygame_pkg = __name__.startswith("pygame.tests.")
+
+import unittest
+
+
+class KeyModuleTest(unittest.TestCase):
+    def test_get_focused(self):
+        self.assertTrue(True)
+
+    def test_get_mods(self):
+        self.assertTrue(True)
+
+    def test_get_pressed(self):
+        self.assertTrue(True)
+
+    def test_name(self):
+        self.assertTrue(True)
+
+    def test_set_mods(self):
+        self.assertTrue(True)
+
+    def test_set_repeat(self):
+        self.assertTrue(True)
+
+
+if __name__ == "__main__":
+    unittest.main()
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/print_stderr/__init__.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/print_stderr/__init__.py
new file mode 100644
index 0000000..1bb8bf6
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/print_stderr/__init__.py
@@ -0,0 +1 @@
+# empty
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/print_stderr/__pycache__/__init__.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/print_stderr/__pycache__/__init__.cpython-312.pyc
new file mode 100644
index 0000000..40b1e85
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/print_stderr/__pycache__/__init__.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/print_stderr/__pycache__/fake_2_test.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/print_stderr/__pycache__/fake_2_test.cpython-312.pyc
new file mode 100644
index 0000000..77623f8
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/print_stderr/__pycache__/fake_2_test.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/print_stderr/__pycache__/fake_3_test.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/print_stderr/__pycache__/fake_3_test.cpython-312.pyc
new file mode 100644
index 0000000..8c937ad
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/print_stderr/__pycache__/fake_3_test.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/print_stderr/__pycache__/fake_4_test.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/print_stderr/__pycache__/fake_4_test.cpython-312.pyc
new file mode 100644
index 0000000..5ffd5a7
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/print_stderr/__pycache__/fake_4_test.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/print_stderr/fake_2_test.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/print_stderr/fake_2_test.py
new file mode 100644
index 0000000..3be92e1
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/print_stderr/fake_2_test.py
@@ -0,0 +1,39 @@
+if __name__ == "__main__":
+    import sys
+    import os
+
+    pkg_dir = os.path.split(
+        os.path.split(os.path.split(os.path.abspath(__file__))[0])[0]
+    )[0]
+    parent_dir, pkg_name = os.path.split(pkg_dir)
+    is_pygame_pkg = pkg_name == "tests" and os.path.split(parent_dir)[1] == "pygame"
+    if not is_pygame_pkg:
+        sys.path.insert(0, parent_dir)
+else:
+    is_pygame_pkg = __name__.startswith("pygame.tests.")
+
+import unittest
+
+
+class KeyModuleTest(unittest.TestCase):
+    def test_get_focused(self):
+        self.assertTrue(True)
+
+    def test_get_mods(self):
+        self.assertTrue(True)
+
+    def test_get_pressed(self):
+        self.assertTrue(True)
+
+    def test_name(self):
+        self.assertTrue(True)
+
+    def test_set_mods(self):
+        self.assertTrue(True)
+
+    def test_set_repeat(self):
+        self.assertTrue(True)
+
+
+if __name__ == "__main__":
+    unittest.main()
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/print_stderr/fake_3_test.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/print_stderr/fake_3_test.py
new file mode 100644
index 0000000..f59ad40
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/print_stderr/fake_3_test.py
@@ -0,0 +1,41 @@
+import sys
+
+if __name__ == "__main__":
+    import os
+
+    pkg_dir = os.path.split(
+        os.path.split(os.path.split(os.path.abspath(__file__))[0])[0]
+    )[0]
+    parent_dir, pkg_name = os.path.split(pkg_dir)
+    is_pygame_pkg = pkg_name == "tests" and os.path.split(parent_dir)[1] == "pygame"
+    if not is_pygame_pkg:
+        sys.path.insert(0, parent_dir)
+else:
+    is_pygame_pkg = __name__.startswith("pygame.tests.")
+
+import unittest
+
+
+class KeyModuleTest(unittest.TestCase):
+    def test_get_focused(self):
+        self.assertTrue(True)
+
+    def test_get_mods(self):
+        self.assertTrue(True)
+
+    def test_get_pressed(self):
+        self.assertTrue(True)
+
+    def test_name(self):
+        sys.stderr.write("jibberish messes things up\n")
+        self.assertTrue(False)
+
+    def test_set_mods(self):
+        self.assertTrue(True)
+
+    def test_set_repeat(self):
+        self.assertTrue(True)
+
+
+if __name__ == "__main__":
+    unittest.main()
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/print_stderr/fake_4_test.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/print_stderr/fake_4_test.py
new file mode 100644
index 0000000..1e75fea
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/print_stderr/fake_4_test.py
@@ -0,0 +1,41 @@
+if __name__ == "__main__":
+    import sys
+    import os
+
+    pkg_dir = os.path.split(
+        os.path.split(os.path.split(os.path.abspath(__file__))[0])[0]
+    )[0]
+    parent_dir, pkg_name = os.path.split(pkg_dir)
+    is_pygame_pkg = pkg_name == "tests" and os.path.split(parent_dir)[1] == "pygame"
+    if not is_pygame_pkg:
+        sys.path.insert(0, parent_dir)
+else:
+    is_pygame_pkg = __name__.startswith("pygame.tests.")
+
+import unittest
+
+
+class KeyModuleTest(unittest.TestCase):
+    def test_get_focused(self):
+        self.assertTrue(True)
+
+    def test_get_mods(self):
+        self.assertTrue(True)
+
+    def test_get_pressed(self):
+        self.assertTrue(False, "Some Jibberish")
+
+    def test_name(self):
+        self.assertTrue(True)
+
+    def test_set_mods(self):
+        if 1:
+            if 1:
+                assert False
+
+    def test_set_repeat(self):
+        self.assertTrue(True)
+
+
+if __name__ == "__main__":
+    unittest.main()
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/print_stdout/__init__.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/print_stdout/__init__.py
new file mode 100644
index 0000000..1bb8bf6
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/print_stdout/__init__.py
@@ -0,0 +1 @@
+# empty
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/print_stdout/__pycache__/__init__.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/print_stdout/__pycache__/__init__.cpython-312.pyc
new file mode 100644
index 0000000..98c0bd1
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/print_stdout/__pycache__/__init__.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/print_stdout/__pycache__/fake_2_test.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/print_stdout/__pycache__/fake_2_test.cpython-312.pyc
new file mode 100644
index 0000000..ff44019
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/print_stdout/__pycache__/fake_2_test.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/print_stdout/__pycache__/fake_3_test.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/print_stdout/__pycache__/fake_3_test.cpython-312.pyc
new file mode 100644
index 0000000..e0cee7e
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/print_stdout/__pycache__/fake_3_test.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/print_stdout/__pycache__/fake_4_test.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/print_stdout/__pycache__/fake_4_test.cpython-312.pyc
new file mode 100644
index 0000000..2c855d3
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/print_stdout/__pycache__/fake_4_test.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/print_stdout/fake_2_test.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/print_stdout/fake_2_test.py
new file mode 100644
index 0000000..3be92e1
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/print_stdout/fake_2_test.py
@@ -0,0 +1,39 @@
+if __name__ == "__main__":
+    import sys
+    import os
+
+    pkg_dir = os.path.split(
+        os.path.split(os.path.split(os.path.abspath(__file__))[0])[0]
+    )[0]
+    parent_dir, pkg_name = os.path.split(pkg_dir)
+    is_pygame_pkg = pkg_name == "tests" and os.path.split(parent_dir)[1] == "pygame"
+    if not is_pygame_pkg:
+        sys.path.insert(0, parent_dir)
+else:
+    is_pygame_pkg = __name__.startswith("pygame.tests.")
+
+import unittest
+
+
+class KeyModuleTest(unittest.TestCase):
+    def test_get_focused(self):
+        self.assertTrue(True)
+
+    def test_get_mods(self):
+        self.assertTrue(True)
+
+    def test_get_pressed(self):
+        self.assertTrue(True)
+
+    def test_name(self):
+        self.assertTrue(True)
+
+    def test_set_mods(self):
+        self.assertTrue(True)
+
+    def test_set_repeat(self):
+        self.assertTrue(True)
+
+
+if __name__ == "__main__":
+    unittest.main()
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/print_stdout/fake_3_test.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/print_stdout/fake_3_test.py
new file mode 100644
index 0000000..467c725
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/print_stdout/fake_3_test.py
@@ -0,0 +1,42 @@
+import sys
+
+if __name__ == "__main__":
+    import os
+
+    pkg_dir = os.path.split(
+        os.path.split(os.path.split(os.path.abspath(__file__))[0])[0]
+    )[0]
+    parent_dir, pkg_name = os.path.split(pkg_dir)
+    is_pygame_pkg = pkg_name == "tests" and os.path.split(parent_dir)[1] == "pygame"
+    if not is_pygame_pkg:
+        sys.path.insert(0, parent_dir)
+else:
+    is_pygame_pkg = __name__.startswith("pygame.tests.")
+
+import unittest
+
+
+class KeyModuleTest(unittest.TestCase):
+    def test_get_focused(self):
+        self.assertTrue(True)
+
+    def test_get_mods(self):
+        self.assertTrue(True)
+
+    def test_get_pressed(self):
+        sys.stdout.write("jibberish ruins everything\n")
+        self.assertTrue(False)
+
+    def test_name(self):
+        sys.stdout.write("forgot to remove debug crap\n")
+        self.assertTrue(True)
+
+    def test_set_mods(self):
+        self.assertTrue(True)
+
+    def test_set_repeat(self):
+        self.assertTrue(True)
+
+
+if __name__ == "__main__":
+    unittest.main()
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/print_stdout/fake_4_test.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/print_stdout/fake_4_test.py
new file mode 100644
index 0000000..1e75fea
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/print_stdout/fake_4_test.py
@@ -0,0 +1,41 @@
+if __name__ == "__main__":
+    import sys
+    import os
+
+    pkg_dir = os.path.split(
+        os.path.split(os.path.split(os.path.abspath(__file__))[0])[0]
+    )[0]
+    parent_dir, pkg_name = os.path.split(pkg_dir)
+    is_pygame_pkg = pkg_name == "tests" and os.path.split(parent_dir)[1] == "pygame"
+    if not is_pygame_pkg:
+        sys.path.insert(0, parent_dir)
+else:
+    is_pygame_pkg = __name__.startswith("pygame.tests.")
+
+import unittest
+
+
+class KeyModuleTest(unittest.TestCase):
+    def test_get_focused(self):
+        self.assertTrue(True)
+
+    def test_get_mods(self):
+        self.assertTrue(True)
+
+    def test_get_pressed(self):
+        self.assertTrue(False, "Some Jibberish")
+
+    def test_name(self):
+        self.assertTrue(True)
+
+    def test_set_mods(self):
+        if 1:
+            if 1:
+                assert False
+
+    def test_set_repeat(self):
+        self.assertTrue(True)
+
+
+if __name__ == "__main__":
+    unittest.main()
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/run_tests__test.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/run_tests__test.py
new file mode 100644
index 0000000..a1eadd1
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/run_tests__test.py
@@ -0,0 +1,145 @@
+################################################################################
+
+import subprocess, os, sys, re, difflib
+
+################################################################################
+
+IGNORE = (".svn", "infinite_loop")
+NORMALIZERS = (
+    (r"Ran (\d+) tests in (\d+\.\d+)s", "Ran \\1 tests in X.XXXs"),
+    (r'File ".*?([^/\\.]+\.py)"', 'File "\\1"'),
+)
+
+################################################################################
+
+
+def norm_result(result):
+    "normalize differences, such as timing between output"
+    for normalizer, replacement in NORMALIZERS:
+        if hasattr(normalizer, "__call__"):
+            result = normalizer(result)
+        else:
+            result = re.sub(normalizer, replacement, result)
+
+    return result
+
+
+def call_proc(cmd, cd=None):
+    proc = subprocess.Popen(
+        cmd,
+        stdout=subprocess.PIPE,
+        stderr=subprocess.STDOUT,
+        cwd=cd,
+        universal_newlines=True,
+    )
+    if proc.wait():
+        print(f"{cmd} {proc.wait()}")
+        raise Exception(proc.stdout.read())
+
+    return proc.stdout.read()
+
+
+################################################################################
+
+unnormed_diff = "-u" in sys.argv
+verbose = "-v" in sys.argv or unnormed_diff
+if "-h" in sys.argv or "--help" in sys.argv:
+    sys.exit(
+        "\nCOMPARES OUTPUT OF SINGLE VS SUBPROCESS MODE OF RUN_TESTS.PY\n\n"
+        "-v, to output diffs even on success\n"
+        "-u, to output diffs of unnormalized tests\n\n"
+        "Each line of a Differ delta begins with a two-letter code:\n\n"
+        "    '- '    line unique to sequence 1\n"
+        "    '+ '    line unique to sequence 2\n"
+        "    '  '    line common to both sequences\n"
+        "    '? '    line not present in either input sequence\n"
+    )
+
+main_dir = os.path.split(os.path.abspath(sys.argv[0]))[0]
+trunk_dir = os.path.normpath(os.path.join(main_dir, "../../"))
+
+test_suite_dirs = [
+    x
+    for x in os.listdir(main_dir)
+    if os.path.isdir(os.path.join(main_dir, x)) and x not in IGNORE
+]
+
+
+################################################################################
+
+
+def assert_on_results(suite, single, sub):
+    test = globals().get(f"{suite}_test")
+    if hasattr(test, "__call_"):
+        test(suite, single, sub)
+        print(f"assertions on {suite} OK")
+
+
+# Don't modify tests in suites below. These assertions are in place to make sure
+# that tests are actually being ran
+
+
+def all_ok_test(suite, *args):
+    for results in args:
+        assert "Ran 36 tests" in results  # some tests are running
+        assert "OK" in results  # OK
+
+
+def failures1_test(suite, *args):
+    for results in args:
+        assert "FAILED (failures=2)" in results
+        assert "Ran 18 tests" in results
+
+
+################################################################################
+# Test that output is the same in single process and subprocess modes
+#
+
+base_cmd = [sys.executable, "run_tests.py", "-i"]
+
+cmd = base_cmd + ["-n", "-f"]
+sub_cmd = base_cmd + ["-f"]
+time_out_cmd = base_cmd + ["-t", "4", "-f", "infinite_loop"]
+
+passes = 0
+failed = False
+
+for suite in test_suite_dirs:
+    single = call_proc(cmd + [suite], trunk_dir)
+    subs = call_proc(sub_cmd + [suite], trunk_dir)
+
+    normed_single, normed_subs = map(norm_result, (single, subs))
+
+    failed = normed_single != normed_subs
+    if failed:
+        print(f"{suite} suite comparison FAILED\n")
+    else:
+        passes += 1
+        print(f"{suite} suite comparison OK")
+
+    assert_on_results(suite, single, subs)
+
+    if verbose or failed:
+        print("difflib.Differ().compare(single, suprocessed):\n")
+        print(
+            "".join(
+                list(
+                    difflib.Differ().compare(
+                        (unnormed_diff and single or normed_single).splitlines(1),
+                        (unnormed_diff and subs or normed_subs).splitlines(1),
+                    )
+                )
+            )
+        )
+
+sys.stdout.write("infinite_loop suite (subprocess mode timeout) ")
+loop_test = call_proc(time_out_cmd, trunk_dir)
+assert "successfully terminated" in loop_test
+passes += 1
+print("OK")
+
+print(f"\n{passes}/{len(test_suite_dirs) + 1} suites pass")
+
+print("\n-h for help")
+
+################################################################################
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/timeout/__init__.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/timeout/__init__.py
new file mode 100644
index 0000000..1bb8bf6
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/timeout/__init__.py
@@ -0,0 +1 @@
+# empty
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/timeout/__pycache__/__init__.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/timeout/__pycache__/__init__.cpython-312.pyc
new file mode 100644
index 0000000..5635cd2
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/timeout/__pycache__/__init__.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/timeout/__pycache__/fake_2_test.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/timeout/__pycache__/fake_2_test.cpython-312.pyc
new file mode 100644
index 0000000..6f6535a
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/timeout/__pycache__/fake_2_test.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/timeout/__pycache__/sleep_test.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/timeout/__pycache__/sleep_test.cpython-312.pyc
new file mode 100644
index 0000000..702a86e
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/timeout/__pycache__/sleep_test.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/timeout/fake_2_test.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/timeout/fake_2_test.py
new file mode 100644
index 0000000..3be92e1
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/timeout/fake_2_test.py
@@ -0,0 +1,39 @@
+if __name__ == "__main__":
+    import sys
+    import os
+
+    pkg_dir = os.path.split(
+        os.path.split(os.path.split(os.path.abspath(__file__))[0])[0]
+    )[0]
+    parent_dir, pkg_name = os.path.split(pkg_dir)
+    is_pygame_pkg = pkg_name == "tests" and os.path.split(parent_dir)[1] == "pygame"
+    if not is_pygame_pkg:
+        sys.path.insert(0, parent_dir)
+else:
+    is_pygame_pkg = __name__.startswith("pygame.tests.")
+
+import unittest
+
+
+class KeyModuleTest(unittest.TestCase):
+    def test_get_focused(self):
+        self.assertTrue(True)
+
+    def test_get_mods(self):
+        self.assertTrue(True)
+
+    def test_get_pressed(self):
+        self.assertTrue(True)
+
+    def test_name(self):
+        self.assertTrue(True)
+
+    def test_set_mods(self):
+        self.assertTrue(True)
+
+    def test_set_repeat(self):
+        self.assertTrue(True)
+
+
+if __name__ == "__main__":
+    unittest.main()
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/timeout/sleep_test.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/timeout/sleep_test.py
new file mode 100644
index 0000000..bab528a
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/run_tests__tests/timeout/sleep_test.py
@@ -0,0 +1,30 @@
+if __name__ == "__main__":
+    import sys
+    import os
+
+    pkg_dir = os.path.split(
+        os.path.split(os.path.split(os.path.abspath(__file__))[0])[0]
+    )[0]
+    parent_dir, pkg_name = os.path.split(pkg_dir)
+    is_pygame_pkg = pkg_name == "tests" and os.path.split(parent_dir)[1] == "pygame"
+    if not is_pygame_pkg:
+        sys.path.insert(0, parent_dir)
+else:
+    is_pygame_pkg = __name__.startswith("pygame.tests.")
+
+import unittest
+
+import time
+
+
+class KeyModuleTest(unittest.TestCase):
+    def test_get_focused(self):
+        stop_time = time.time() + 10.0
+        while time.time() < stop_time:
+            time.sleep(1)
+
+        self.assertTrue(True)
+
+
+if __name__ == "__main__":
+    unittest.main()
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/rwobject_test.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/rwobject_test.py
new file mode 100644
index 0000000..31723ae
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/rwobject_test.py
@@ -0,0 +1,139 @@
+import pathlib
+import unittest
+
+from pygame import encode_string, encode_file_path
+
+
+class RWopsEncodeStringTest(unittest.TestCase):
+    global getrefcount
+
+    def test_obj_None(self):
+        encoded_string = encode_string(None)
+
+        self.assertIsNone(encoded_string)
+
+    def test_returns_bytes(self):
+        u = "Hello"
+        encoded_string = encode_string(u)
+
+        self.assertIsInstance(encoded_string, bytes)
+
+    def test_obj_bytes(self):
+        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"
+        b = u.encode("utf-8")
+        self.assertEqual(encode_string(u, "utf-8"), b)
+
+    def test_error_fowarding(self):
+        self.assertRaises(SyntaxError, encode_string)
+
+    def test_errors(self):
+        u = "abc\u0109defg\u011Dh\u0125ij\u0135klmnoprs\u015Dtu\u016Dvz"
+        b = u.encode("ascii", "ignore")
+        self.assertEqual(encode_string(u, "ascii", "ignore"), b)
+
+    def test_encoding_error(self):
+        u = "a\x80b"
+        encoded_string = encode_string(u, "ascii", "strict")
+
+        self.assertIsNone(encoded_string)
+
+    def test_check_defaults(self):
+        u = "a\u01F7b"
+        b = u.encode("unicode_escape", "backslashreplace")
+        encoded_string = encode_string(u)
+
+        self.assertEqual(encoded_string, b)
+
+    def test_etype(self):
+        u = "a\x80b"
+        self.assertRaises(SyntaxError, encode_string, u, "ascii", "strict", SyntaxError)
+
+    def test_etype__invalid(self):
+        """Ensures invalid etypes are properly handled."""
+
+        for etype in ("SyntaxError", self):
+            self.assertRaises(TypeError, encode_string, "test", etype=etype)
+
+    def test_string_with_null_bytes(self):
+        b = b"a\x00b\x00c"
+        encoded_string = encode_string(b, etype=SyntaxError)
+        encoded_decode_string = encode_string(b.decode(), "ascii", "strict")
+
+        self.assertIs(encoded_string, b)
+        self.assertEqual(encoded_decode_string, b)
+
+    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"
+        b = encode_string(u, "utf-8", "strict", AssertionError)
+        self.assertEqual(b, utf_8)
+
+    def test_pathlib_obj(self):
+        """Test loading string representation of pathlib object"""
+        """
+        We do this because pygame functions internally use pg_EncodeString
+        to decode the filenames passed to them. So if we test that here, we
+        can safely assume that all those functions do not have any issues
+        with pathlib objects
+        """
+        encoded = encode_string(pathlib.PurePath("foo"), "utf-8")
+        self.assertEqual(encoded, b"foo")
+
+        encoded = encode_string(pathlib.Path("baz"))
+        self.assertEqual(encoded, b"baz")
+
+
+class RWopsEncodeFilePathTest(unittest.TestCase):
+    # Most tests can be skipped since RWopsEncodeFilePath wraps
+    # RWopsEncodeString
+    def test_encoding(self):
+        u = "Hello"
+        encoded_file_path = encode_file_path(u)
+
+        self.assertIsInstance(encoded_file_path, bytes)
+
+    def test_error_fowarding(self):
+        self.assertRaises(SyntaxError, encode_file_path)
+
+    def test_path_with_null_bytes(self):
+        b = b"a\x00b\x00c"
+        encoded_file_path = encode_file_path(b)
+
+        self.assertIsNone(encoded_file_path)
+
+    def test_etype(self):
+        b = b"a\x00b\x00c"
+        self.assertRaises(TypeError, encode_file_path, b, TypeError)
+
+    def test_etype__invalid(self):
+        """Ensures invalid etypes are properly handled."""
+
+        for etype in ("SyntaxError", self):
+            self.assertRaises(TypeError, encode_file_path, "test", etype)
+
+
+if __name__ == "__main__":
+    unittest.main()
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/scrap_tags.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/scrap_tags.py
new file mode 100644
index 0000000..17a82ff
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/scrap_tags.py
@@ -0,0 +1,26 @@
+__tags__ = ["ignore", "subprocess_ignore"]
+
+# TODO: make scrap_test.py work
+# This test used to work only on linux and windows.
+# Currently it only work in windows, and in linux it throws:
+# `pygame.error: content could not be placed in clipboard.`
+# The old test and tags kept here for reference when fixing.
+
+# import sys
+#
+# exclude = False
+#
+# if sys.platform == "win32" or sys.platform.startswith("linux"):
+#     try:
+#         import pygame
+#
+#         pygame.scrap._NOT_IMPLEMENTED_
+#     except AttributeError:
+#         pass
+#     else:
+#         exclude = True
+# else:
+#     exclude = True
+#
+# if exclude:
+#     __tags__.extend(["ignore", "subprocess_ignore"])
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/scrap_test.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/scrap_test.py
new file mode 100644
index 0000000..6b7f6fa
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/scrap_test.py
@@ -0,0 +1,301 @@
+import os
+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
+
+
+class ScrapModuleTest(unittest.TestCase):
+    @classmethod
+    def setUpClass(cls):
+        pygame.display.init()
+        pygame.display.set_mode((1, 1))
+        scrap.init()
+
+    @classmethod
+    def tearDownClass(cls):
+        # scrap.quit()  # Does not exist!
+        pygame.display.quit()
+
+    def test_init(self):
+        """Ensures scrap module still initialized after multiple init calls."""
+        scrap.init()
+        scrap.init()
+
+        self.assertTrue(scrap.get_init())
+
+    def test_init__reinit(self):
+        """Ensures reinitializing the scrap module doesn't clear its data."""
+        data_type = pygame.SCRAP_TEXT
+        expected_data = b"test_init__reinit"
+        scrap.put(data_type, expected_data)
+
+        scrap.init()
+
+        self.assertEqual(scrap.get(data_type), expected_data)
+
+    def test_get_init(self):
+        """Ensures get_init gets the init state."""
+        self.assertTrue(scrap.get_init())
+
+    def todo_test_contains(self):
+        """Ensures contains works as expected."""
+        self.fail()
+
+    def todo_test_get(self):
+        """Ensures get works as expected."""
+        self.fail()
+
+    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.
+        """
+        # Use a unique data type identifier to ensure there is no preexisting
+        # data.
+        DATA_TYPE = "test_get__owned_empty_type"
+
+        if scrap.lost():
+            # Try to acquire the clipboard.
+            scrap.put(pygame.SCRAP_TEXT, b"text to clipboard")
+
+            if scrap.lost():
+                self.skipTest("requires the pygame application to own the clipboard")
+
+        data = scrap.get(DATA_TYPE)
+
+        self.assertIsNone(data)
+
+    def todo_test_get_types(self):
+        """Ensures get_types works as expected."""
+        self.fail()
+
+    def todo_test_lost(self):
+        """Ensures lost works as expected."""
+        self.fail()
+
+    def test_set_mode(self):
+        """Ensures set_mode works as expected."""
+        scrap.set_mode(pygame.SCRAP_SELECTION)
+        scrap.set_mode(pygame.SCRAP_CLIPBOARD)
+
+        self.assertRaises(ValueError, scrap.set_mode, 1099)
+
+    def test_put__text(self):
+        """Ensures put can place text into the clipboard."""
+        scrap.put(pygame.SCRAP_TEXT, b"Hello world")
+
+        self.assertEqual(scrap.get(pygame.SCRAP_TEXT), b"Hello world")
+
+        scrap.put(pygame.SCRAP_TEXT, b"Another String")
+
+        self.assertEqual(scrap.get(pygame.SCRAP_TEXT), b"Another String")
+
+    @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_string = pygame.image.tostring(sf, "RGBA")
+        scrap.put(pygame.SCRAP_BMP, expected_string)
+
+        self.assertEqual(scrap.get(pygame.SCRAP_BMP), expected_string)
+
+    def test_put(self):
+        """Ensures put can place data into the clipboard
+        when using a user defined type identifier.
+        """
+        DATA_TYPE = "arbitrary buffer"
+
+        scrap.put(DATA_TYPE, b"buf")
+        r = scrap.get(DATA_TYPE)
+
+        self.assertEqual(r, b"buf")
+
+
+class ScrapModuleClipboardNotOwnedTest(unittest.TestCase):
+    """Test the scrap module's functionality when the pygame application is
+    not the current owner of the clipboard.
+
+    A separate class is used to prevent tests that acquire the clipboard from
+    interfering with these tests.
+    """
+
+    @classmethod
+    def setUpClass(cls):
+        pygame.display.init()
+        pygame.display.set_mode((1, 1))
+        scrap.init()
+
+    @classmethod
+    def tearDownClass(cls):
+        # scrap.quit()  # Does not exist!
+        pygame.quit()
+        pygame.display.quit()
+
+    def _skip_if_clipboard_owned(self):
+        # Skip test if the pygame application owns the clipboard. Currently,
+        # there is no way to give up ownership.
+        if not scrap.lost():
+            self.skipTest("requires the pygame application to not own the clipboard")
+
+    def test_get__not_owned(self):
+        """Ensures get works when there is no data of the requested type
+        in the clipboard and the clipboard is not owned by the pygame
+        application.
+        """
+        self._skip_if_clipboard_owned()
+
+        # Use a unique data type identifier to ensure there is no preexisting
+        # data.
+        DATA_TYPE = "test_get__not_owned"
+
+        data = scrap.get(DATA_TYPE)
+
+        self.assertIsNone(data)
+
+    def test_get_types__not_owned(self):
+        """Ensures get_types works when the clipboard is not owned
+        by the pygame application.
+        """
+        self._skip_if_clipboard_owned()
+
+        data_types = scrap.get_types()
+
+        self.assertIsInstance(data_types, list)
+
+    def test_contains__not_owned(self):
+        """Ensures contains works when the clipboard is not owned
+        by the pygame application.
+        """
+        self._skip_if_clipboard_owned()
+
+        # Use a unique data type identifier to ensure there is no preexisting
+        # data.
+        DATA_TYPE = "test_contains__not_owned"
+
+        contains = scrap.contains(DATA_TYPE)
+
+        self.assertFalse(contains)
+
+    def test_lost__not_owned(self):
+        """Ensures lost works when the clipboard is not owned
+        by the pygame application.
+        """
+        self._skip_if_clipboard_owned()
+
+        lost = scrap.lost()
+
+        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/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/sndarray_tags.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/sndarray_tags.py
new file mode 100644
index 0000000..68fa7a5
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/sndarray_tags.py
@@ -0,0 +1,12 @@
+__tags__ = ["array"]
+
+exclude = False
+
+try:
+    import pygame.mixer
+    import numpy
+except ImportError:
+    exclude = True
+
+if exclude:
+    __tags__.extend(("ignore", "subprocess_ignore"))
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/sndarray_test.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/sndarray_test.py
new file mode 100644
index 0000000..57eb71c
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/sndarray_test.py
@@ -0,0 +1,154 @@
+import unittest
+
+from numpy import int8, int16, uint8, uint16, float32, array, all as alltrue
+
+import pygame
+import pygame.sndarray
+
+
+class SndarrayTest(unittest.TestCase):
+    array_dtypes = {8: uint8, -8: int8, 16: uint16, -16: int16, 32: float32}
+
+    def _assert_compatible(self, arr, size):
+        dtype = self.array_dtypes[size]
+        self.assertEqual(arr.dtype, dtype)
+
+    def test_array(self):
+        def check_array(size, channels, test_data):
+            try:
+                pygame.mixer.init(22050, size, channels, allowedchanges=0)
+            except pygame.error:
+                # Not all sizes are supported on all systems.
+                return
+            try:
+                __, sz, __ = pygame.mixer.get_init()
+                if sz == size:
+                    srcarr = array(test_data, self.array_dtypes[size])
+                    snd = pygame.sndarray.make_sound(srcarr)
+                    arr = pygame.sndarray.array(snd)
+                    self._assert_compatible(arr, size)
+                    self.assertTrue(
+                        alltrue(arr == srcarr),
+                        "size: %i\n%s\n%s" % (size, arr, test_data),
+                    )
+            finally:
+                pygame.mixer.quit()
+
+        check_array(8, 1, [0, 0x0F, 0xF0, 0xFF])
+        check_array(8, 2, [[0, 0x80], [0x2D, 0x41], [0x64, 0xA1], [0xFF, 0x40]])
+        check_array(16, 1, [0, 0x00FF, 0xFF00, 0xFFFF])
+        check_array(
+            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], [-1, 0]])
+        check_array(-16, 1, [0, 0x7FFF, -0x7FFF, -1])
+        check_array(-16, 2, [[0, -0x7FFF], [-0x7FFF, 0], [0x7FFF, 0], [0, 0x7FFF]])
+
+    def test_get_arraytype(self):
+        array_type = pygame.sndarray.get_arraytype()
+
+        self.assertEqual(array_type, "numpy", f"unknown array type {array_type}")
+
+    def test_get_arraytypes(self):
+        arraytypes = pygame.sndarray.get_arraytypes()
+        self.assertIn("numpy", arraytypes)
+
+        for atype in arraytypes:
+            self.assertEqual(atype, "numpy", f"unknown array type {atype}")
+
+    def test_make_sound(self):
+        def check_sound(size, channels, test_data):
+            try:
+                pygame.mixer.init(22050, size, channels, allowedchanges=0)
+            except pygame.error:
+                # Not all sizes are supported on all systems.
+                return
+            try:
+                __, sz, __ = pygame.mixer.get_init()
+                if sz == size:
+                    srcarr = array(test_data, self.array_dtypes[size])
+                    snd = pygame.sndarray.make_sound(srcarr)
+                    arr = pygame.sndarray.samples(snd)
+                    self.assertTrue(
+                        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], [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], [-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]])
+
+    def test_samples(self):
+        null_byte = b"\x00"
+
+        def check_sample(size, channels, test_data):
+            try:
+                pygame.mixer.init(22050, size, channels, allowedchanges=0)
+            except pygame.error:
+                # Not all sizes are supported on all systems.
+                return
+            try:
+                __, sz, __ = pygame.mixer.get_init()
+                if sz == size:
+                    zeroed = null_byte * ((abs(size) // 8) * len(test_data) * channels)
+                    snd = pygame.mixer.Sound(buffer=zeroed)
+                    samples = pygame.sndarray.samples(snd)
+                    self._assert_compatible(samples, size)
+                    ##print('X %s' % (samples.shape,))
+                    ##print('Y %s' % (test_data,))
+                    samples[...] = test_data
+                    arr = pygame.sndarray.array(snd)
+                    self.assertTrue(
+                        alltrue(samples == arr),
+                        "size: %i\n%s\n%s" % (size, arr, test_data),
+                    )
+            finally:
+                pygame.mixer.quit()
+
+        check_sample(8, 1, [0, 0x0F, 0xF0, 0xFF])
+        check_sample(8, 2, [[0, 0x80], [0x2D, 0x41], [0x64, 0xA1], [0xFF, 0x40]])
+        check_sample(16, 1, [0, 0x00FF, 0xFF00, 0xFFFF])
+        check_sample(
+            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], [-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]])
+
+    def test_use_arraytype(self):
+        def do_use_arraytype(atype):
+            pygame.sndarray.use_arraytype(atype)
+
+        pygame.sndarray.use_arraytype("numpy")
+        self.assertEqual(pygame.sndarray.get_arraytype(), "numpy")
+
+        self.assertRaises(ValueError, do_use_arraytype, "not an option")
+
+    def test_float32(self):
+        """sized arrays work with Sounds and 32bit float arrays."""
+        try:
+            pygame.mixer.init(22050, 32, 2, allowedchanges=0)
+        except pygame.error:
+            # Not all sizes are supported on all systems.
+            self.skipTest("unsupported mixer configuration")
+
+        arr = array([[0.0, -1.0], [-1.0, 0], [1.0, 0], [0, 1.0]], float32)
+        newsound = pygame.mixer.Sound(array=arr)
+        pygame.mixer.quit()
+
+
+if __name__ == "__main__":
+    unittest.main()
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/sprite_test.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/sprite_test.py
new file mode 100644
index 0000000..531263c
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/sprite_test.py
@@ -0,0 +1,1412 @@
+#################################### IMPORTS ###################################
+
+
+import unittest
+
+import pygame
+from pygame import sprite
+
+
+################################# MODULE LEVEL #################################
+
+
+class SpriteModuleTest(unittest.TestCase):
+    pass
+
+
+######################### SPRITECOLLIDE FUNCTIONS TEST #########################
+
+
+class SpriteCollideTest(unittest.TestCase):
+    def setUp(self):
+        self.ag = sprite.AbstractGroup()
+        self.ag2 = sprite.AbstractGroup()
+        self.s1 = sprite.Sprite(self.ag)
+        self.s2 = sprite.Sprite(self.ag2)
+        self.s3 = sprite.Sprite(self.ag2)
+
+        self.s1.image = pygame.Surface((50, 10), pygame.SRCALPHA, 32)
+        self.s2.image = pygame.Surface((10, 10), pygame.SRCALPHA, 32)
+        self.s3.image = pygame.Surface((10, 10), pygame.SRCALPHA, 32)
+
+        self.s1.rect = self.s1.image.get_rect()
+        self.s2.rect = self.s2.image.get_rect()
+        self.s3.rect = self.s3.image.get_rect()
+        self.s2.rect.move_ip(40, 0)
+        self.s3.rect.move_ip(100, 100)
+
+    def test_spritecollide__works_if_collided_cb_is_None(self):
+        # Test that sprites collide without collided function.
+        self.assertEqual(
+            sprite.spritecollide(self.s1, self.ag2, dokill=False, collided=None),
+            [self.s2],
+        )
+
+    def test_spritecollide__works_if_collided_cb_not_passed(self):
+        # Should also work when collided function isn't passed at all.
+        self.assertEqual(
+            sprite.spritecollide(self.s1, self.ag2, dokill=False), [self.s2]
+        )
+
+    def test_spritecollide__collided_must_be_a_callable(self):
+        # Need to pass a callable.
+        self.assertRaises(
+            TypeError, sprite.spritecollide, self.s1, self.ag2, dokill=False, collided=1
+        )
+
+    def test_spritecollide__collided_defaults_to_collide_rect(self):
+        # collide_rect should behave the same as default.
+        self.assertEqual(
+            sprite.spritecollide(
+                self.s1, self.ag2, dokill=False, collided=sprite.collide_rect
+            ),
+            [self.s2],
+        )
+
+    def test_collide_rect_ratio__ratio_of_one_like_default(self):
+        # collide_rect_ratio should behave the same as default at a 1.0 ratio.
+        self.assertEqual(
+            sprite.spritecollide(
+                self.s1, self.ag2, dokill=False, collided=sprite.collide_rect_ratio(1.0)
+            ),
+            [self.s2],
+        )
+
+    def test_collide_rect_ratio__collides_all_at_ratio_of_twenty(self):
+        # collide_rect_ratio should collide all at a 20.0 ratio.
+        collided_func = sprite.collide_rect_ratio(20.0)
+        expected_sprites = sorted(self.ag2.sprites(), key=id)
+
+        collided_sprites = sorted(
+            sprite.spritecollide(
+                self.s1, self.ag2, dokill=False, collided=collided_func
+            ),
+            key=id,
+        )
+
+        self.assertListEqual(collided_sprites, expected_sprites)
+
+    def test_collide_circle__no_radius_set(self):
+        # collide_circle with no radius set.
+        self.assertEqual(
+            sprite.spritecollide(
+                self.s1, self.ag2, dokill=False, collided=sprite.collide_circle
+            ),
+            [self.s2],
+        )
+
+    def test_collide_circle_ratio__no_radius_and_ratio_of_one(self):
+        # collide_circle_ratio with no radius set, at a 1.0 ratio.
+        self.assertEqual(
+            sprite.spritecollide(
+                self.s1,
+                self.ag2,
+                dokill=False,
+                collided=sprite.collide_circle_ratio(1.0),
+            ),
+            [self.s2],
+        )
+
+    def test_collide_circle_ratio__no_radius_and_ratio_of_twenty(self):
+        # collide_circle_ratio with no radius set, at a 20.0 ratio.
+        collided_func = sprite.collide_circle_ratio(20.0)
+        expected_sprites = sorted(self.ag2.sprites(), key=id)
+
+        collided_sprites = sorted(
+            sprite.spritecollide(
+                self.s1, self.ag2, dokill=False, collided=collided_func
+            ),
+            key=id,
+        )
+
+        self.assertListEqual(expected_sprites, collided_sprites)
+
+    def test_collide_circle__radius_set_by_collide_circle_ratio(self):
+        # Call collide_circle_ratio with no radius set, at a 20.0 ratio.
+        # That should return group ag2 AND set the radius attribute of the
+        # sprites in such a way that collide_circle would give same result as
+        # if it had been called without the radius being set.
+        collided_func = sprite.collide_circle_ratio(20.0)
+
+        sprite.spritecollide(self.s1, self.ag2, dokill=False, collided=collided_func)
+
+        self.assertEqual(
+            sprite.spritecollide(
+                self.s1, self.ag2, dokill=False, collided=sprite.collide_circle
+            ),
+            [self.s2],
+        )
+
+    def test_collide_circle_ratio__no_radius_and_ratio_of_two_twice(self):
+        # collide_circle_ratio with no radius set, at a 2.0 ratio,
+        # called twice to check if the bug where the calculated radius
+        # is not stored correctly in the radius attribute of each sprite.
+        collided_func = sprite.collide_circle_ratio(2.0)
+
+        # Calling collide_circle_ratio will set the radius attribute of the
+        # sprites. If an incorrect value is stored then we will not get the
+        # same result next time it is called:
+        expected_sprites = sorted(
+            sprite.spritecollide(
+                self.s1, self.ag2, dokill=False, collided=collided_func
+            ),
+            key=id,
+        )
+        collided_sprites = sorted(
+            sprite.spritecollide(
+                self.s1, self.ag2, dokill=False, collided=collided_func
+            ),
+            key=id,
+        )
+
+        self.assertListEqual(expected_sprites, collided_sprites)
+
+    def test_collide_circle__with_radii_set(self):
+        # collide_circle with a radius set.
+        self.s1.radius = 50
+        self.s2.radius = 10
+        self.s3.radius = 400
+        collided_func = sprite.collide_circle
+        expected_sprites = sorted(self.ag2.sprites(), key=id)
+
+        collided_sprites = sorted(
+            sprite.spritecollide(
+                self.s1, self.ag2, dokill=False, collided=collided_func
+            ),
+            key=id,
+        )
+
+        self.assertListEqual(expected_sprites, collided_sprites)
+
+    def test_collide_circle_ratio__with_radii_set(self):
+        # collide_circle_ratio with a radius set.
+        self.s1.radius = 50
+        self.s2.radius = 10
+        self.s3.radius = 400
+        collided_func = sprite.collide_circle_ratio(0.5)
+        expected_sprites = sorted(self.ag2.sprites(), key=id)
+
+        collided_sprites = sorted(
+            sprite.spritecollide(
+                self.s1, self.ag2, dokill=False, collided=collided_func
+            ),
+            key=id,
+        )
+
+        self.assertListEqual(expected_sprites, collided_sprites)
+
+    def test_collide_mask__opaque(self):
+        # make some fully opaque sprites that will collide with masks.
+        self.s1.image.fill((255, 255, 255, 255))
+        self.s2.image.fill((255, 255, 255, 255))
+        self.s3.image.fill((255, 255, 255, 255))
+
+        # masks should be autogenerated from image if they don't exist.
+        self.assertEqual(
+            sprite.spritecollide(
+                self.s1, self.ag2, dokill=False, collided=sprite.collide_mask
+            ),
+            [self.s2],
+        )
+
+        self.s1.mask = pygame.mask.from_surface(self.s1.image)
+        self.s2.mask = pygame.mask.from_surface(self.s2.image)
+        self.s3.mask = pygame.mask.from_surface(self.s3.image)
+
+        # with set masks.
+        self.assertEqual(
+            sprite.spritecollide(
+                self.s1, self.ag2, dokill=False, collided=sprite.collide_mask
+            ),
+            [self.s2],
+        )
+
+    def test_collide_mask__transparent(self):
+        # make some sprites that are fully transparent, so they won't collide.
+        self.s1.image.fill((255, 255, 255, 0))
+        self.s2.image.fill((255, 255, 255, 0))
+        self.s3.image.fill((255, 255, 255, 0))
+
+        self.s1.mask = pygame.mask.from_surface(self.s1.image, 255)
+        self.s2.mask = pygame.mask.from_surface(self.s2.image, 255)
+        self.s3.mask = pygame.mask.from_surface(self.s3.image, 255)
+
+        self.assertFalse(
+            sprite.spritecollide(
+                self.s1, self.ag2, dokill=False, collided=sprite.collide_mask
+            )
+        )
+
+    def test_spritecollideany__without_collided_callback(self):
+        # pygame.sprite.spritecollideany(sprite, group) -> sprite
+        # finds any sprites that collide
+
+        # if collided is not passed, all
+        # sprites must have a "rect" value, which is a
+        # rectangle of the sprite area, which will be used
+        # to calculate the collision.
+
+        # s2 in, s3 out
+        expected_sprite = self.s2
+        collided_sprite = sprite.spritecollideany(self.s1, self.ag2)
+
+        self.assertEqual(collided_sprite, expected_sprite)
+
+        # s2 and s3 out
+        self.s2.rect.move_ip(0, 10)
+        collided_sprite = sprite.spritecollideany(self.s1, self.ag2)
+
+        self.assertIsNone(collided_sprite)
+
+        # s2 out, s3 in
+        self.s3.rect.move_ip(-105, -105)
+        expected_sprite = self.s3
+        collided_sprite = sprite.spritecollideany(self.s1, self.ag2)
+
+        self.assertEqual(collided_sprite, expected_sprite)
+
+        # s2 and s3 in
+        self.s2.rect.move_ip(0, -10)
+        expected_sprite_choices = self.ag2.sprites()
+        collided_sprite = sprite.spritecollideany(self.s1, self.ag2)
+
+        self.assertIn(collided_sprite, expected_sprite_choices)
+
+    def test_spritecollideany__with_collided_callback(self):
+        # pygame.sprite.spritecollideany(sprite, group) -> sprite
+        # finds any sprites that collide
+
+        # collided is a callback function used to calculate if
+        # two sprites are colliding. it should take two sprites
+        # as values, and return a bool value indicating if
+        # they are colliding.
+
+        # This collision test can be faster than pygame.sprite.spritecollide()
+        # since it has less work to do.
+
+        arg_dict_a = {}
+        arg_dict_b = {}
+        return_container = [True]
+
+        # This function is configurable using the mutable default arguments!
+        def collided_callback(
+            spr_a,
+            spr_b,
+            arg_dict_a=arg_dict_a,
+            arg_dict_b=arg_dict_b,
+            return_container=return_container,
+        ):
+            count = arg_dict_a.get(spr_a, 0)
+            arg_dict_a[spr_a] = 1 + count
+
+            count = arg_dict_b.get(spr_b, 0)
+            arg_dict_b[spr_b] = 1 + count
+
+            return return_container[0]
+
+        # This should return a sprite from self.ag2 because the callback
+        # function (collided_callback()) currently returns True.
+        expected_sprite_choices = self.ag2.sprites()
+        collided_sprite = sprite.spritecollideany(self.s1, self.ag2, collided_callback)
+
+        self.assertIn(collided_sprite, expected_sprite_choices)
+
+        # The callback function should have been called only once, so self.s1
+        # should have only been passed as an argument once
+        self.assertEqual(len(arg_dict_a), 1)
+        self.assertEqual(arg_dict_a[self.s1], 1)
+
+        # The callback function should have been called only once, so self.s2
+        # exclusive-or self.s3 should have only been passed as an argument
+        # once
+        self.assertEqual(len(arg_dict_b), 1)
+        self.assertEqual(list(arg_dict_b.values())[0], 1)
+        self.assertTrue(self.s2 in arg_dict_b or self.s3 in arg_dict_b)
+
+        arg_dict_a.clear()
+        arg_dict_b.clear()
+        return_container[0] = False
+
+        # This should return None because the callback function
+        # (collided_callback()) currently returns False.
+        collided_sprite = sprite.spritecollideany(self.s1, self.ag2, collided_callback)
+
+        self.assertIsNone(collided_sprite)
+
+        # The callback function should have been called as many times as
+        # there are sprites in self.ag2
+        self.assertEqual(len(arg_dict_a), 1)
+        self.assertEqual(arg_dict_a[self.s1], len(self.ag2))
+        self.assertEqual(len(arg_dict_b), len(self.ag2))
+
+        # Each sprite in self.ag2 should be called once.
+        for s in self.ag2:
+            self.assertEqual(arg_dict_b[s], 1)
+
+    def test_groupcollide__without_collided_callback(self):
+        # pygame.sprite.groupcollide(groupa, groupb, dokilla, dokillb) -> dict
+        # collision detection between group and group
+
+        # test no kill
+        expected_dict = {self.s1: [self.s2]}
+        crashed = pygame.sprite.groupcollide(self.ag, self.ag2, False, False)
+
+        self.assertDictEqual(expected_dict, crashed)
+
+        crashed = pygame.sprite.groupcollide(self.ag, self.ag2, False, False)
+
+        self.assertDictEqual(expected_dict, crashed)
+
+        # Test dokill2=True (kill colliding sprites in second group).
+        crashed = pygame.sprite.groupcollide(self.ag, self.ag2, False, True)
+
+        self.assertDictEqual(expected_dict, crashed)
+
+        expected_dict = {}
+        crashed = pygame.sprite.groupcollide(self.ag, self.ag2, False, False)
+
+        self.assertDictEqual(expected_dict, crashed)
+
+        # Test dokill1=True (kill colliding sprites in first group).
+        self.s3.rect.move_ip(-100, -100)
+        expected_dict = {self.s1: [self.s3]}
+        crashed = pygame.sprite.groupcollide(self.ag, self.ag2, True, False)
+
+        self.assertDictEqual(expected_dict, crashed)
+
+        expected_dict = {}
+        crashed = pygame.sprite.groupcollide(self.ag, self.ag2, False, False)
+
+        self.assertDictEqual(expected_dict, crashed)
+
+    def test_groupcollide__with_collided_callback(self):
+        collided_callback_true = lambda spr_a, spr_b: True
+        collided_callback_false = lambda spr_a, spr_b: False
+
+        # test no kill
+        expected_dict = {}
+        crashed = pygame.sprite.groupcollide(
+            self.ag, self.ag2, False, False, collided_callback_false
+        )
+
+        self.assertDictEqual(expected_dict, crashed)
+
+        expected_dict = {self.s1: sorted(self.ag2.sprites(), key=id)}
+        crashed = pygame.sprite.groupcollide(
+            self.ag, self.ag2, False, False, collided_callback_true
+        )
+        for value in crashed.values():
+            value.sort(key=id)
+
+        self.assertDictEqual(expected_dict, crashed)
+
+        # expected_dict is the same again for this collide
+        crashed = pygame.sprite.groupcollide(
+            self.ag, self.ag2, False, False, collided_callback_true
+        )
+        for value in crashed.values():
+            value.sort(key=id)
+
+        self.assertDictEqual(expected_dict, crashed)
+
+        # Test dokill2=True (kill colliding sprites in second group).
+        expected_dict = {}
+        crashed = pygame.sprite.groupcollide(
+            self.ag, self.ag2, False, True, collided_callback_false
+        )
+
+        self.assertDictEqual(expected_dict, crashed)
+
+        expected_dict = {self.s1: sorted(self.ag2.sprites(), key=id)}
+        crashed = pygame.sprite.groupcollide(
+            self.ag, self.ag2, False, True, collided_callback_true
+        )
+        for value in crashed.values():
+            value.sort(key=id)
+
+        self.assertDictEqual(expected_dict, crashed)
+
+        expected_dict = {}
+        crashed = pygame.sprite.groupcollide(
+            self.ag, self.ag2, False, True, collided_callback_true
+        )
+
+        self.assertDictEqual(expected_dict, crashed)
+
+        # Test dokill1=True (kill colliding sprites in first group).
+        self.ag.add(self.s2)
+        self.ag2.add(self.s3)
+        expected_dict = {}
+        crashed = pygame.sprite.groupcollide(
+            self.ag, self.ag2, True, False, collided_callback_false
+        )
+
+        self.assertDictEqual(expected_dict, crashed)
+
+        expected_dict = {self.s1: [self.s3], self.s2: [self.s3]}
+        crashed = pygame.sprite.groupcollide(
+            self.ag, self.ag2, True, False, collided_callback_true
+        )
+
+        self.assertDictEqual(expected_dict, crashed)
+
+        expected_dict = {}
+        crashed = pygame.sprite.groupcollide(
+            self.ag, self.ag2, True, False, collided_callback_true
+        )
+
+        self.assertDictEqual(expected_dict, crashed)
+
+    def test_collide_rect(self):
+        # Test colliding - some edges touching
+        self.assertTrue(pygame.sprite.collide_rect(self.s1, self.s2))
+        self.assertTrue(pygame.sprite.collide_rect(self.s2, self.s1))
+
+        # Test colliding - all edges touching
+        self.s2.rect.center = self.s3.rect.center
+
+        self.assertTrue(pygame.sprite.collide_rect(self.s2, self.s3))
+        self.assertTrue(pygame.sprite.collide_rect(self.s3, self.s2))
+
+        # Test colliding - no edges touching
+        self.s2.rect.inflate_ip(10, 10)
+
+        self.assertTrue(pygame.sprite.collide_rect(self.s2, self.s3))
+        self.assertTrue(pygame.sprite.collide_rect(self.s3, self.s2))
+
+        # Test colliding - some edges intersecting
+        self.s2.rect.center = (self.s1.rect.right, self.s1.rect.bottom)
+
+        self.assertTrue(pygame.sprite.collide_rect(self.s1, self.s2))
+        self.assertTrue(pygame.sprite.collide_rect(self.s2, self.s1))
+
+        # Test not colliding
+        self.assertFalse(pygame.sprite.collide_rect(self.s1, self.s3))
+        self.assertFalse(pygame.sprite.collide_rect(self.s3, self.s1))
+
+
+################################################################################
+
+
+class AbstractGroupTypeTest(unittest.TestCase):
+    def setUp(self):
+        self.ag = sprite.AbstractGroup()
+        self.ag2 = sprite.AbstractGroup()
+        self.s1 = sprite.Sprite(self.ag)
+        self.s2 = sprite.Sprite(self.ag)
+        self.s3 = sprite.Sprite(self.ag2)
+        self.s4 = sprite.Sprite(self.ag2)
+
+        self.s1.image = pygame.Surface((10, 10))
+        self.s1.image.fill(pygame.Color("red"))
+        self.s1.rect = self.s1.image.get_rect()
+
+        self.s2.image = pygame.Surface((10, 10))
+        self.s2.image.fill(pygame.Color("green"))
+        self.s2.rect = self.s2.image.get_rect()
+        self.s2.rect.left = 10
+
+        self.s3.image = pygame.Surface((10, 10))
+        self.s3.image.fill(pygame.Color("blue"))
+        self.s3.rect = self.s3.image.get_rect()
+        self.s3.rect.top = 10
+
+        self.s4.image = pygame.Surface((10, 10))
+        self.s4.image.fill(pygame.Color("white"))
+        self.s4.rect = self.s4.image.get_rect()
+        self.s4.rect.left = 10
+        self.s4.rect.top = 10
+
+        self.bg = pygame.Surface((20, 20))
+        self.scr = pygame.Surface((20, 20))
+        self.scr.fill(pygame.Color("grey"))
+
+    def test_has(self):
+        "See if AbstractGroup.has() works as expected."
+
+        self.assertEqual(True, self.s1 in self.ag)
+
+        self.assertEqual(True, self.ag.has(self.s1))
+
+        self.assertEqual(True, self.ag.has([self.s1, self.s2]))
+
+        # see if one of them not being in there.
+        self.assertNotEqual(True, self.ag.has([self.s1, self.s2, self.s3]))
+        self.assertNotEqual(True, self.ag.has(self.s1, self.s2, self.s3))
+        self.assertNotEqual(True, self.ag.has(self.s1, sprite.Group(self.s2, self.s3)))
+        self.assertNotEqual(True, self.ag.has(self.s1, [self.s2, self.s3]))
+
+        # test empty list processing
+        self.assertFalse(self.ag.has(*[]))
+        self.assertFalse(self.ag.has([]))
+        self.assertFalse(self.ag.has([[]]))
+
+        # see if a second AbstractGroup works.
+        self.assertEqual(True, self.ag2.has(self.s3))
+
+    def test_add(self):
+        ag3 = sprite.AbstractGroup()
+        sprites = (self.s1, self.s2, self.s3, self.s4)
+
+        for s in sprites:
+            self.assertNotIn(s, ag3)
+
+        ag3.add(self.s1, [self.s2], self.ag2)
+
+        for s in sprites:
+            self.assertIn(s, ag3)
+
+    def test_add_internal(self):
+        self.assertNotIn(self.s1, self.ag2)
+
+        self.ag2.add_internal(self.s1)
+
+        self.assertIn(self.s1, self.ag2)
+
+    def test_clear(self):
+        self.ag.draw(self.scr)
+        self.ag.clear(self.scr, self.bg)
+        self.assertEqual((0, 0, 0, 255), self.scr.get_at((5, 5)))
+        self.assertEqual((0, 0, 0, 255), self.scr.get_at((15, 5)))
+
+    def test_draw(self):
+        self.ag.draw(self.scr)
+        self.assertEqual((255, 0, 0, 255), self.scr.get_at((5, 5)))
+        self.assertEqual((0, 255, 0, 255), self.scr.get_at((15, 5)))
+
+        self.assertEqual(self.ag.spritedict[self.s1], pygame.Rect(0, 0, 10, 10))
+        self.assertEqual(self.ag.spritedict[self.s2], pygame.Rect(10, 0, 10, 10))
+
+    def test_empty(self):
+        self.ag.empty()
+        self.assertFalse(self.s1 in self.ag)
+        self.assertFalse(self.s2 in self.ag)
+
+    def test_has_internal(self):
+        self.assertTrue(self.ag.has_internal(self.s1))
+        self.assertFalse(self.ag.has_internal(self.s3))
+
+    def test_remove(self):
+        # Test removal of 1 sprite
+        self.ag.remove(self.s1)
+        self.assertFalse(self.ag in self.s1.groups())
+        self.assertFalse(self.ag.has(self.s1))
+
+        # Test removal of 2 sprites as 2 arguments
+        self.ag2.remove(self.s3, self.s4)
+        self.assertFalse(self.ag2 in self.s3.groups())
+        self.assertFalse(self.ag2 in self.s4.groups())
+        self.assertFalse(self.ag2.has(self.s3, self.s4))
+
+        # Test removal of 4 sprites as a list containing a sprite and a group
+        # containing a sprite and another group containing 2 sprites.
+        self.ag.add(self.s1, self.s3, self.s4)
+        self.ag2.add(self.s3, self.s4)
+        g = sprite.Group(self.s2)
+        self.ag.remove([self.s1, g], self.ag2)
+        self.assertFalse(self.ag in self.s1.groups())
+        self.assertFalse(self.ag in self.s2.groups())
+        self.assertFalse(self.ag in self.s3.groups())
+        self.assertFalse(self.ag in self.s4.groups())
+        self.assertFalse(self.ag.has(self.s1, self.s2, self.s3, self.s4))
+
+    def test_remove_internal(self):
+        self.ag.remove_internal(self.s1)
+        self.assertFalse(self.ag.has_internal(self.s1))
+
+    def test_sprites(self):
+        expected_sprites = sorted((self.s1, self.s2), key=id)
+        sprite_list = sorted(self.ag.sprites(), key=id)
+
+        self.assertListEqual(sprite_list, expected_sprites)
+
+    def test_update(self):
+        class test_sprite(pygame.sprite.Sprite):
+            sink = []
+
+            def __init__(self, *groups):
+                pygame.sprite.Sprite.__init__(self, *groups)
+
+            def update(self, *args):
+                self.sink += args
+
+        s = test_sprite(self.ag)
+        self.ag.update(1, 2, 3)
+
+        self.assertEqual(test_sprite.sink, [1, 2, 3])
+
+    def test_update_with_kwargs(self):
+        class test_sprite(pygame.sprite.Sprite):
+            sink = []
+            sink_kwargs = {}
+
+            def __init__(self, *groups):
+                pygame.sprite.Sprite.__init__(self, *groups)
+
+            def update(self, *args, **kwargs):
+                self.sink += args
+                self.sink_kwargs.update(kwargs)
+
+        s = test_sprite(self.ag)
+        self.ag.update(1, 2, 3, foo=4, bar=5)
+
+        self.assertEqual(test_sprite.sink, [1, 2, 3])
+        self.assertEqual(test_sprite.sink_kwargs, {"foo": 4, "bar": 5})
+
+
+################################################################################
+
+# A base class to share tests between similar classes
+
+
+class LayeredGroupBase:
+    def test_get_layer_of_sprite(self):
+        expected_layer = 666
+        spr = self.sprite()
+        self.LG.add(spr, layer=expected_layer)
+        layer = self.LG.get_layer_of_sprite(spr)
+
+        self.assertEqual(len(self.LG._spritelist), 1)
+        self.assertEqual(layer, self.LG.get_layer_of_sprite(spr))
+        self.assertEqual(layer, expected_layer)
+        self.assertEqual(layer, self.LG._spritelayers[spr])
+
+    def test_add(self):
+        expected_layer = self.LG._default_layer
+        spr = self.sprite()
+        self.LG.add(spr)
+        layer = self.LG.get_layer_of_sprite(spr)
+
+        self.assertEqual(len(self.LG._spritelist), 1)
+        self.assertEqual(layer, expected_layer)
+
+    def test_add__sprite_with_layer_attribute(self):
+        expected_layer = 100
+        spr = self.sprite()
+        spr._layer = expected_layer
+        self.LG.add(spr)
+        layer = self.LG.get_layer_of_sprite(spr)
+
+        self.assertEqual(len(self.LG._spritelist), 1)
+        self.assertEqual(layer, expected_layer)
+
+    def test_add__passing_layer_keyword(self):
+        expected_layer = 100
+        spr = self.sprite()
+        self.LG.add(spr, layer=expected_layer)
+        layer = self.LG.get_layer_of_sprite(spr)
+
+        self.assertEqual(len(self.LG._spritelist), 1)
+        self.assertEqual(layer, expected_layer)
+
+    def test_add__overriding_sprite_layer_attr(self):
+        expected_layer = 200
+        spr = self.sprite()
+        spr._layer = 100
+        self.LG.add(spr, layer=expected_layer)
+        layer = self.LG.get_layer_of_sprite(spr)
+
+        self.assertEqual(len(self.LG._spritelist), 1)
+        self.assertEqual(layer, expected_layer)
+
+    def test_add__adding_sprite_on_init(self):
+        spr = self.sprite()
+        lrg2 = sprite.LayeredUpdates(spr)
+        expected_layer = lrg2._default_layer
+        layer = lrg2._spritelayers[spr]
+
+        self.assertEqual(len(lrg2._spritelist), 1)
+        self.assertEqual(layer, expected_layer)
+
+    def test_add__sprite_init_layer_attr(self):
+        expected_layer = 20
+        spr = self.sprite()
+        spr._layer = expected_layer
+        lrg2 = sprite.LayeredUpdates(spr)
+        layer = lrg2._spritelayers[spr]
+
+        self.assertEqual(len(lrg2._spritelist), 1)
+        self.assertEqual(layer, expected_layer)
+
+    def test_add__sprite_init_passing_layer(self):
+        expected_layer = 33
+        spr = self.sprite()
+        lrg2 = sprite.LayeredUpdates(spr, layer=expected_layer)
+        layer = lrg2._spritelayers[spr]
+
+        self.assertEqual(len(lrg2._spritelist), 1)
+        self.assertEqual(layer, expected_layer)
+
+    def test_add__sprite_init_overiding_layer(self):
+        expected_layer = 33
+        spr = self.sprite()
+        spr._layer = 55
+        lrg2 = sprite.LayeredUpdates(spr, layer=expected_layer)
+        layer = lrg2._spritelayers[spr]
+
+        self.assertEqual(len(lrg2._spritelist), 1)
+        self.assertEqual(layer, expected_layer)
+
+    def test_add__spritelist(self):
+        expected_layer = self.LG._default_layer
+        sprite_count = 10
+        sprites = [self.sprite() for _ in range(sprite_count)]
+
+        self.LG.add(sprites)
+
+        self.assertEqual(len(self.LG._spritelist), sprite_count)
+
+        for i in range(sprite_count):
+            layer = self.LG.get_layer_of_sprite(sprites[i])
+
+            self.assertEqual(layer, expected_layer)
+
+    def test_add__spritelist_with_layer_attr(self):
+        sprites = []
+        sprite_and_layer_count = 10
+        for i in range(sprite_and_layer_count):
+            sprites.append(self.sprite())
+            sprites[-1]._layer = i
+
+        self.LG.add(sprites)
+
+        self.assertEqual(len(self.LG._spritelist), sprite_and_layer_count)
+
+        for i in range(sprite_and_layer_count):
+            layer = self.LG.get_layer_of_sprite(sprites[i])
+
+            self.assertEqual(layer, i)
+
+    def test_add__spritelist_passing_layer(self):
+        expected_layer = 33
+        sprite_count = 10
+        sprites = [self.sprite() for _ in range(sprite_count)]
+
+        self.LG.add(sprites, layer=expected_layer)
+
+        self.assertEqual(len(self.LG._spritelist), sprite_count)
+
+        for i in range(sprite_count):
+            layer = self.LG.get_layer_of_sprite(sprites[i])
+
+            self.assertEqual(layer, expected_layer)
+
+    def test_add__spritelist_overriding_layer(self):
+        expected_layer = 33
+        sprites = []
+        sprite_and_layer_count = 10
+        for i in range(sprite_and_layer_count):
+            sprites.append(self.sprite())
+            sprites[-1].layer = i
+
+        self.LG.add(sprites, layer=expected_layer)
+
+        self.assertEqual(len(self.LG._spritelist), sprite_and_layer_count)
+
+        for i in range(sprite_and_layer_count):
+            layer = self.LG.get_layer_of_sprite(sprites[i])
+
+            self.assertEqual(layer, expected_layer)
+
+    def test_add__spritelist_init(self):
+        sprite_count = 10
+        sprites = [self.sprite() for _ in range(sprite_count)]
+
+        lrg2 = sprite.LayeredUpdates(sprites)
+        expected_layer = lrg2._default_layer
+
+        self.assertEqual(len(lrg2._spritelist), sprite_count)
+
+        for i in range(sprite_count):
+            layer = lrg2.get_layer_of_sprite(sprites[i])
+
+            self.assertEqual(layer, expected_layer)
+
+    def test_remove__sprite(self):
+        sprites = []
+        sprite_count = 10
+        for i in range(sprite_count):
+            sprites.append(self.sprite())
+            sprites[-1].rect = pygame.Rect((0, 0, 0, 0))
+
+        self.LG.add(sprites)
+
+        self.assertEqual(len(self.LG._spritelist), sprite_count)
+
+        for i in range(sprite_count):
+            self.LG.remove(sprites[i])
+
+        self.assertEqual(len(self.LG._spritelist), 0)
+
+    def test_sprites(self):
+        sprites = []
+        sprite_and_layer_count = 10
+        for i in range(sprite_and_layer_count, 0, -1):
+            sprites.append(self.sprite())
+            sprites[-1]._layer = i
+
+        self.LG.add(sprites)
+
+        self.assertEqual(len(self.LG._spritelist), sprite_and_layer_count)
+
+        # Sprites should be ordered based on their layer (bottom to top),
+        # which is the reverse order of the sprites list.
+        expected_sprites = list(reversed(sprites))
+        actual_sprites = self.LG.sprites()
+
+        self.assertListEqual(actual_sprites, expected_sprites)
+
+    def test_layers(self):
+        sprites = []
+        expected_layers = []
+        layer_count = 10
+        for i in range(layer_count):
+            expected_layers.append(i)
+            for j in range(5):
+                sprites.append(self.sprite())
+                sprites[-1]._layer = i
+        self.LG.add(sprites)
+
+        layers = self.LG.layers()
+
+        self.assertListEqual(layers, expected_layers)
+
+    def test_add__layers_are_correct(self):
+        layers = [1, 4, 6, 8, 3, 6, 2, 6, 4, 5, 6, 1, 0, 9, 7, 6, 54, 8, 2, 43, 6, 1]
+        for lay in layers:
+            self.LG.add(self.sprite(), layer=lay)
+        layers.sort()
+
+        for idx, spr in enumerate(self.LG.sprites()):
+            layer = self.LG.get_layer_of_sprite(spr)
+
+            self.assertEqual(layer, layers[idx])
+
+    def test_change_layer(self):
+        expected_layer = 99
+        spr = self.sprite()
+        self.LG.add(spr, layer=expected_layer)
+
+        self.assertEqual(self.LG._spritelayers[spr], expected_layer)
+
+        expected_layer = 44
+        self.LG.change_layer(spr, expected_layer)
+
+        self.assertEqual(self.LG._spritelayers[spr], expected_layer)
+
+        expected_layer = 77
+        spr2 = self.sprite()
+        spr2.layer = 55
+        self.LG.add(spr2)
+        self.LG.change_layer(spr2, expected_layer)
+
+        self.assertEqual(spr2.layer, expected_layer)
+
+    def test_get_sprites_at(self):
+        sprites = []
+        expected_sprites = []
+        for i in range(3):
+            spr = self.sprite()
+            spr.rect = pygame.Rect(i * 50, i * 50, 100, 100)
+            sprites.append(spr)
+            if i < 2:
+                expected_sprites.append(spr)
+        self.LG.add(sprites)
+        result = self.LG.get_sprites_at((50, 50))
+        self.assertEqual(result, expected_sprites)
+
+    def test_get_top_layer(self):
+        layers = [1, 5, 2, 8, 4, 5, 3, 88, 23, 0]
+        for i in layers:
+            self.LG.add(self.sprite(), layer=i)
+        top_layer = self.LG.get_top_layer()
+
+        self.assertEqual(top_layer, self.LG.get_top_layer())
+        self.assertEqual(top_layer, max(layers))
+        self.assertEqual(top_layer, max(self.LG._spritelayers.values()))
+        self.assertEqual(top_layer, self.LG._spritelayers[self.LG._spritelist[-1]])
+
+    def test_get_bottom_layer(self):
+        layers = [1, 5, 2, 8, 4, 5, 3, 88, 23, 0]
+        for i in layers:
+            self.LG.add(self.sprite(), layer=i)
+        bottom_layer = self.LG.get_bottom_layer()
+
+        self.assertEqual(bottom_layer, self.LG.get_bottom_layer())
+        self.assertEqual(bottom_layer, min(layers))
+        self.assertEqual(bottom_layer, min(self.LG._spritelayers.values()))
+        self.assertEqual(bottom_layer, self.LG._spritelayers[self.LG._spritelist[0]])
+
+    def test_move_to_front(self):
+        layers = [1, 5, 2, 8, 4, 5, 3, 88, 23, 0]
+        for i in layers:
+            self.LG.add(self.sprite(), layer=i)
+        spr = self.sprite()
+        self.LG.add(spr, layer=3)
+
+        self.assertNotEqual(spr, self.LG._spritelist[-1])
+
+        self.LG.move_to_front(spr)
+
+        self.assertEqual(spr, self.LG._spritelist[-1])
+
+    def test_move_to_back(self):
+        layers = [1, 5, 2, 8, 4, 5, 3, 88, 23, 0]
+        for i in layers:
+            self.LG.add(self.sprite(), layer=i)
+        spr = self.sprite()
+        self.LG.add(spr, layer=55)
+
+        self.assertNotEqual(spr, self.LG._spritelist[0])
+
+        self.LG.move_to_back(spr)
+
+        self.assertEqual(spr, self.LG._spritelist[0])
+
+    def test_get_top_sprite(self):
+        layers = [1, 5, 2, 8, 4, 5, 3, 88, 23, 0]
+        for i in layers:
+            self.LG.add(self.sprite(), layer=i)
+        expected_layer = self.LG.get_top_layer()
+        layer = self.LG.get_layer_of_sprite(self.LG.get_top_sprite())
+
+        self.assertEqual(layer, expected_layer)
+
+    def test_get_sprites_from_layer(self):
+        sprites = {}
+        layers = [
+            1,
+            4,
+            5,
+            6,
+            3,
+            7,
+            8,
+            2,
+            1,
+            3,
+            4,
+            5,
+            6,
+            7,
+            8,
+            9,
+            1,
+            2,
+            3,
+            4,
+            5,
+            6,
+            7,
+            8,
+            9,
+            0,
+            1,
+            6,
+            5,
+            4,
+            3,
+            2,
+        ]
+        for lay in layers:
+            spr = self.sprite()
+            spr._layer = lay
+            self.LG.add(spr)
+            if lay not in sprites:
+                sprites[lay] = []
+            sprites[lay].append(spr)
+
+        for lay in self.LG.layers():
+            for spr in self.LG.get_sprites_from_layer(lay):
+                self.assertIn(spr, sprites[lay])
+
+                sprites[lay].remove(spr)
+                if len(sprites[lay]) == 0:
+                    del sprites[lay]
+
+        self.assertEqual(len(sprites.values()), 0)
+
+    def test_switch_layer(self):
+        sprites1 = []
+        sprites2 = []
+        layers = [3, 2, 3, 2, 3, 3, 2, 2, 3, 2, 3, 2, 3, 2, 3, 2, 3, 3, 2, 2, 3, 2, 3]
+        for lay in layers:
+            spr = self.sprite()
+            spr._layer = lay
+            self.LG.add(spr)
+            if lay == 2:
+                sprites1.append(spr)
+            else:
+                sprites2.append(spr)
+
+        sprites1.sort(key=id)
+        sprites2.sort(key=id)
+        layer2_sprites = sorted(self.LG.get_sprites_from_layer(2), key=id)
+        layer3_sprites = sorted(self.LG.get_sprites_from_layer(3), key=id)
+
+        self.assertListEqual(sprites1, layer2_sprites)
+        self.assertListEqual(sprites2, layer3_sprites)
+        self.assertEqual(len(self.LG), len(sprites1) + len(sprites2))
+
+        self.LG.switch_layer(2, 3)
+        layer2_sprites = sorted(self.LG.get_sprites_from_layer(2), key=id)
+        layer3_sprites = sorted(self.LG.get_sprites_from_layer(3), key=id)
+
+        self.assertListEqual(sprites1, layer3_sprites)
+        self.assertListEqual(sprites2, layer2_sprites)
+        self.assertEqual(len(self.LG), len(sprites1) + len(sprites2))
+
+    def test_copy(self):
+        self.LG.add(self.sprite())
+        spr = self.LG.sprites()[0]
+        lg_copy = self.LG.copy()
+
+        self.assertIsInstance(lg_copy, type(self.LG))
+        self.assertIn(spr, lg_copy)
+        self.assertIn(lg_copy, spr.groups())
+
+
+########################## LAYERED RENDER GROUP TESTS ##########################
+
+
+class LayeredUpdatesTypeTest__SpriteTest(LayeredGroupBase, unittest.TestCase):
+    sprite = sprite.Sprite
+
+    def setUp(self):
+        self.LG = sprite.LayeredUpdates()
+
+
+class LayeredUpdatesTypeTest__DirtySprite(LayeredGroupBase, unittest.TestCase):
+    sprite = sprite.DirtySprite
+
+    def setUp(self):
+        self.LG = sprite.LayeredUpdates()
+
+
+class LayeredDirtyTypeTest__DirtySprite(LayeredGroupBase, unittest.TestCase):
+    sprite = sprite.DirtySprite
+
+    def setUp(self):
+        self.LG = sprite.LayeredDirty()
+
+    def test_repaint_rect(self):
+        group = self.LG
+        surface = pygame.Surface((100, 100))
+
+        group.repaint_rect(pygame.Rect(0, 0, 100, 100))
+        group.draw(surface)
+
+    def test_repaint_rect_with_clip(self):
+        group = self.LG
+        surface = pygame.Surface((100, 100))
+
+        group.set_clip(pygame.Rect(0, 0, 100, 100))
+        group.repaint_rect(pygame.Rect(0, 0, 100, 100))
+        group.draw(surface)
+
+    def _nondirty_intersections_redrawn(self, use_source_rect=False):
+        # Helper method to ensure non-dirty sprites are redrawn correctly.
+        #
+        # Parameters:
+        #     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 issue #898.
+        # A non-dirty sprite (using source_rect) was being redrawn incorrectly
+        # after a dirty sprite intersected with it.
+        #
+        # This test does the following.
+        # 1. Creates a surface filled with white. Also creates an image_source
+        #    with a default fill color of yellow and adds 2 images to it
+        #    (red and blue rectangles).
+        # 2. Creates 2 DirtySprites (red_sprite and blue_sprite) using the
+        #    image_source and adds them to a LayeredDirty group.
+        # 3. Moves the red_sprite and calls LayeredDirty.draw(surface) a few
+        #    times.
+        # 4. Checks to make sure the sprites were redrawn correctly.
+        RED = pygame.Color("red")
+        BLUE = pygame.Color("blue")
+        WHITE = pygame.Color("white")
+        YELLOW = pygame.Color("yellow")
+
+        surface = pygame.Surface((60, 80))
+        surface.fill(WHITE)
+        start_pos = (10, 10)
+
+        # These rects define each sprite's image area in the image_source.
+        red_sprite_source = pygame.Rect((45, 0), (5, 4))
+        blue_sprite_source = pygame.Rect((0, 40), (20, 10))
+
+        # Create a source image/surface.
+        image_source = pygame.Surface((50, 50))
+        image_source.fill(YELLOW)
+        image_source.fill(RED, red_sprite_source)
+        image_source.fill(BLUE, blue_sprite_source)
+
+        # The blue_sprite is stationary and will not reset its dirty flag. It
+        # will be the non-dirty sprite in this test. Its values are dependent
+        # on the use_source_rect flag.
+        blue_sprite = pygame.sprite.DirtySprite(self.LG)
+
+        if use_source_rect:
+            blue_sprite.image = image_source
+            # The rect is a bit smaller than the source_rect to make sure
+            # LayeredDirty.draw() is using the correct dimensions.
+            blue_sprite.rect = pygame.Rect(
+                start_pos, (blue_sprite_source.w - 7, blue_sprite_source.h - 7)
+            )
+            blue_sprite.source_rect = blue_sprite_source
+            start_x, start_y = blue_sprite.rect.topleft
+            end_x = start_x + blue_sprite.source_rect.w
+            end_y = start_y + blue_sprite.source_rect.h
+        else:
+            blue_sprite.image = image_source.subsurface(blue_sprite_source)
+            blue_sprite.rect = pygame.Rect(start_pos, blue_sprite_source.size)
+            start_x, start_y = blue_sprite.rect.topleft
+            end_x, end_y = blue_sprite.rect.bottomright
+
+        # The red_sprite is moving and will always be dirty.
+        red_sprite = pygame.sprite.DirtySprite(self.LG)
+        red_sprite.image = image_source
+        red_sprite.rect = pygame.Rect(start_pos, red_sprite_source.size)
+        red_sprite.source_rect = red_sprite_source
+        red_sprite.dirty = 2
+
+        # Draw the red_sprite as it moves a few steps.
+        for _ in range(4):
+            red_sprite.rect.move_ip(2, 1)
+
+            # This is the method being tested.
+            self.LG.draw(surface)
+
+        # Check colors where the blue_sprite is drawn. We expect red where the
+        # red_sprite is drawn over the blue_sprite, but the rest should be
+        # blue.
+        surface.lock()  # Lock surface for possible speed up.
+        try:
+            for y in range(start_y, end_y):
+                for x in range(start_x, end_x):
+                    if red_sprite.rect.collidepoint(x, y):
+                        expected_color = RED
+                    else:
+                        expected_color = BLUE
+
+                    color = surface.get_at((x, y))
+
+                    self.assertEqual(color, expected_color, f"pos=({x}, {y})")
+        finally:
+            surface.unlock()
+
+    def test_nondirty_intersections_redrawn(self):
+        """Ensure non-dirty sprites are correctly redrawn
+        when dirty sprites intersect with them.
+        """
+        self._nondirty_intersections_redrawn()
+
+    def test_nondirty_intersections_redrawn__with_source_rect(self):
+        """Ensure non-dirty sprites using source_rects are correctly redrawn
+        when dirty sprites intersect with them.
+
+        Related to issue #898.
+        """
+        self._nondirty_intersections_redrawn(True)
+
+
+############################### SPRITE BASE CLASS ##############################
+#
+# tests common between sprite classes
+
+
+class SpriteBase:
+    def setUp(self):
+        self.groups = []
+        for Group in self.Groups:
+            self.groups.append(Group())
+
+        self.sprite = self.Sprite()
+
+    def test_add_internal(self):
+        for g in self.groups:
+            self.sprite.add_internal(g)
+
+        for g in self.groups:
+            self.assertIn(g, self.sprite.groups())
+
+    def test_remove_internal(self):
+        for g in self.groups:
+            self.sprite.add_internal(g)
+
+        for g in self.groups:
+            self.sprite.remove_internal(g)
+
+        for g in self.groups:
+            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 = []
+
+            def __init__(self, *groups):
+                pygame.sprite.Sprite.__init__(self, *groups)
+
+            def update(self, *args):
+                self.sink += args
+
+        s = test_sprite()
+        s.update(1, 2, 3)
+
+        self.assertEqual(test_sprite.sink, [1, 2, 3])
+
+    def test_update_with_kwargs(self):
+        class test_sprite(pygame.sprite.Sprite):
+            sink = []
+            sink_dict = {}
+
+            def __init__(self, *groups):
+                pygame.sprite.Sprite.__init__(self, *groups)
+
+            def update(self, *args, **kwargs):
+                self.sink += args
+                self.sink_dict.update(kwargs)
+
+        s = test_sprite()
+        s.update(1, 2, 3, foo=4, bar=5)
+
+        self.assertEqual(test_sprite.sink, [1, 2, 3])
+        self.assertEqual(test_sprite.sink_dict, {"foo": 4, "bar": 5})
+
+    def test___init____added_to_groups_passed(self):
+        expected_groups = sorted(self.groups, key=id)
+        sprite = self.Sprite(self.groups)
+        groups = sorted(sprite.groups(), key=id)
+
+        self.assertListEqual(groups, expected_groups)
+
+    def test_add(self):
+        expected_groups = sorted(self.groups, key=id)
+        self.sprite.add(self.groups)
+        groups = sorted(self.sprite.groups(), key=id)
+
+        self.assertListEqual(groups, expected_groups)
+
+    def test_alive(self):
+        self.assertFalse(
+            self.sprite.alive(), "Sprite should not be alive if in no groups"
+        )
+
+        self.sprite.add(self.groups)
+
+        self.assertTrue(self.sprite.alive())
+
+    def test_groups(self):
+        for i, g in enumerate(self.groups):
+            expected_groups = sorted(self.groups[: i + 1], key=id)
+            self.sprite.add(g)
+            groups = sorted(self.sprite.groups(), key=id)
+
+            self.assertListEqual(groups, expected_groups)
+
+    def test_kill(self):
+        self.sprite.add(self.groups)
+
+        self.assertTrue(self.sprite.alive())
+
+        self.sprite.kill()
+
+        self.assertListEqual(self.sprite.groups(), [])
+        self.assertFalse(self.sprite.alive())
+
+    def test_remove(self):
+        self.sprite.add(self.groups)
+        self.sprite.remove(self.groups)
+
+        self.assertListEqual(self.sprite.groups(), [])
+
+
+############################## SPRITE CLASS TESTS ##############################
+
+
+class SpriteTypeTest(SpriteBase, unittest.TestCase):
+    Sprite = sprite.Sprite
+
+    Groups = [
+        sprite.Group,
+        sprite.LayeredUpdates,
+        sprite.RenderUpdates,
+        sprite.OrderedUpdates,
+    ]
+
+
+class DirtySpriteTypeTest(SpriteBase, unittest.TestCase):
+    Sprite = sprite.DirtySprite
+
+    Groups = [
+        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 memoryleak bug posted to mailing list by Tobias Steinrücken on 16/11/10.
+        # Fixed in revision 2953.
+
+        import weakref
+        import gc
+
+        class MySprite(sprite.Sprite):
+            def __init__(self, *args, **kwargs):
+                sprite.Sprite.__init__(self, *args, **kwargs)
+                self.image = pygame.Surface((2, 4), 0, 24)
+                self.rect = self.image.get_rect()
+
+        g = sprite.GroupSingle()
+        screen = pygame.Surface((4, 8), 0, 24)
+        s = MySprite()
+        r = weakref.ref(s)
+        g.sprite = s
+        del s
+        gc.collect()
+
+        self.assertIsNotNone(r())
+
+        g.update()
+        g.draw(screen)
+        g.sprite = MySprite()
+        gc.collect()
+
+        self.assertIsNone(r())
+
+
+################################################################################
+
+if __name__ == "__main__":
+    unittest.main()
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/surface_test.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/surface_test.py
new file mode 100644
index 0000000..b1147d2
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/surface_test.py
@@ -0,0 +1,4064 @@
+import os
+import unittest
+from pygame.tests import test_utils
+from pygame.tests.test_utils import (
+    example_path,
+    SurfaceSubclass,
+)
+
+try:
+    from pygame.tests.test_utils.arrinter import *
+except (ImportError, NameError):
+    pass
+import pygame
+from pygame.locals import *
+from pygame.bufferproxy import BufferProxy
+
+import platform
+import gc
+import weakref
+import ctypes
+
+IS_PYPY = "PyPy" == platform.python_implementation()
+
+
+class SurfaceTypeTest(unittest.TestCase):
+    def test_surface__pixel_format_as_surface_subclass(self):
+        """Ensure a subclassed surface can be used for pixel format
+        when creating a new surface."""
+        expected_depth = 16
+        expected_flags = SRCALPHA
+        expected_size = (13, 37)
+        depth_surface = SurfaceSubclass((11, 21), expected_flags, expected_depth)
+
+        surface = pygame.Surface(expected_size, expected_flags, depth_surface)
+
+        self.assertIsNot(surface, depth_surface)
+        self.assertIsInstance(surface, pygame.Surface)
+        self.assertNotIsInstance(surface, SurfaceSubclass)
+        self.assertEqual(surface.get_size(), expected_size)
+        self.assertEqual(surface.get_flags(), expected_flags)
+        self.assertEqual(surface.get_bitsize(), expected_depth)
+
+    def test_surface_created_opaque_black(self):
+        surf = pygame.Surface((20, 20))
+        self.assertEqual(surf.get_at((0, 0)), (0, 0, 0, 255))
+
+        # 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))
+
+    def test_set_clip(self):
+        """see if surface.set_clip(None) works correctly."""
+        s = pygame.Surface((800, 600))
+        r = pygame.Rect(10, 10, 10, 10)
+        s.set_clip(r)
+        r.move_ip(10, 0)
+        s.set_clip(None)
+        res = s.get_clip()
+        # this was garbled before.
+        self.assertEqual(res[0], 0)
+        self.assertEqual(res[2], 800)
+
+    def test_print(self):
+        surf = pygame.Surface((70, 70), 0, 32)
+        self.assertEqual(repr(surf), "")
+
+    def test_keyword_arguments(self):
+        surf = pygame.Surface((70, 70), flags=SRCALPHA, depth=32)
+        self.assertEqual(surf.get_flags() & SRCALPHA, SRCALPHA)
+        self.assertEqual(surf.get_bitsize(), 32)
+
+        # sanity check to make sure the check below is valid
+        surf_16 = pygame.Surface((70, 70), 0, 16)
+        self.assertEqual(surf_16.get_bytesize(), 2)
+
+        # try again with an argument list
+        surf_16 = pygame.Surface((70, 70), depth=16)
+        self.assertEqual(surf_16.get_bytesize(), 2)
+
+    def test_set_at(self):
+        # 24bit surfaces
+        s = pygame.Surface((100, 100), 0, 24)
+        s.fill((0, 0, 0))
+
+        # set it with a tuple.
+        s.set_at((0, 0), (10, 10, 10, 255))
+        r = s.get_at((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)
+        r = s.get_at((10, 1))
+        self.assertEqual(r, (0, 0, 255, 255))
+
+    def test_set_at__big_endian(self):
+        """png files are loaded in big endian format (BGR rather than RGB)"""
+        pygame.display.init()
+        try:
+            image = pygame.image.load(example_path(os.path.join("data", "BGR.png")))
+            # Check they start red, green and blue
+            self.assertEqual(image.get_at((10, 10)), pygame.Color(255, 0, 0))
+            self.assertEqual(image.get_at((10, 20)), pygame.Color(0, 255, 0))
+            self.assertEqual(image.get_at((10, 40)), pygame.Color(0, 0, 255))
+            # Set three pixels that are already red, green, blue
+            # to red, green and, blue with set_at:
+            image.set_at((10, 10), pygame.Color(255, 0, 0))
+            image.set_at((10, 20), pygame.Color(0, 255, 0))
+            image.set_at((10, 40), pygame.Color(0, 0, 255))
+
+            # Check they still are
+            self.assertEqual(image.get_at((10, 10)), pygame.Color(255, 0, 0))
+            self.assertEqual(image.get_at((10, 20)), pygame.Color(0, 255, 0))
+            self.assertEqual(image.get_at((10, 40)), pygame.Color(0, 0, 255))
+
+        finally:
+            pygame.display.quit()
+
+    def test_SRCALPHA(self):
+        # has the flag been passed in ok?
+        surf = pygame.Surface((70, 70), SRCALPHA, 32)
+        self.assertEqual(surf.get_flags() & SRCALPHA, SRCALPHA)
+
+        # 24bit surfaces can not have SRCALPHA.
+        self.assertRaises(ValueError, pygame.Surface, (100, 100), pygame.SRCALPHA, 24)
+
+        # if we have a 32 bit surface, the SRCALPHA should have worked too.
+        surf2 = pygame.Surface((70, 70), SRCALPHA)
+        if surf2.get_bitsize() == 32:
+            self.assertEqual(surf2.get_flags() & SRCALPHA, SRCALPHA)
+
+    def test_flags_default0_nodisplay(self):
+        """is set to zero, and SRCALPHA is not set by default with no display initialized."""
+        pygame.display.quit()
+        surf = pygame.Surface((70, 70))
+        self.assertEqual(surf.get_flags() & SRCALPHA, 0)
+
+    def test_flags_default0_display(self):
+        """is set to zero, and SRCALPH is not set by default even when the display is initialized."""
+        pygame.display.set_mode((320, 200))
+        try:
+            surf = pygame.Surface((70, 70))
+            self.assertEqual(surf.get_flags() & SRCALPHA, 0)
+        finally:
+            pygame.display.quit()
+
+    def test_masks(self):
+        def make_surf(bpp, flags, masks):
+            pygame.Surface((10, 10), flags, bpp, masks)
+
+        # With some masks SDL_CreateRGBSurface does not work properly.
+        masks = (0xFF000000, 0xFF0000, 0xFF00, 0)
+        self.assertEqual(make_surf(32, 0, masks), None)
+        # For 24 and 32 bit surfaces Pygame assumes no losses.
+        masks = (0x7F0000, 0xFF00, 0xFF, 0)
+        self.assertRaises(ValueError, make_surf, 24, 0, masks)
+        self.assertRaises(ValueError, make_surf, 32, 0, masks)
+        # What contiguous bits in a mask.
+        masks = (0x6F0000, 0xFF00, 0xFF, 0)
+        self.assertRaises(ValueError, make_surf, 32, 0, masks)
+
+    def test_get_bounding_rect(self):
+        surf = pygame.Surface((70, 70), SRCALPHA, 32)
+        surf.fill((0, 0, 0, 0))
+        bound_rect = surf.get_bounding_rect()
+        self.assertEqual(bound_rect.width, 0)
+        self.assertEqual(bound_rect.height, 0)
+        surf.set_at((30, 30), (255, 255, 255, 1))
+        bound_rect = surf.get_bounding_rect()
+        self.assertEqual(bound_rect.left, 30)
+        self.assertEqual(bound_rect.top, 30)
+        self.assertEqual(bound_rect.width, 1)
+        self.assertEqual(bound_rect.height, 1)
+        surf.set_at((29, 29), (255, 255, 255, 1))
+        bound_rect = surf.get_bounding_rect()
+        self.assertEqual(bound_rect.left, 29)
+        self.assertEqual(bound_rect.top, 29)
+        self.assertEqual(bound_rect.width, 2)
+        self.assertEqual(bound_rect.height, 2)
+
+        surf = pygame.Surface((70, 70), 0, 24)
+        surf.fill((0, 0, 0))
+        bound_rect = surf.get_bounding_rect()
+        self.assertEqual(bound_rect.width, surf.get_width())
+        self.assertEqual(bound_rect.height, surf.get_height())
+
+        surf.set_colorkey((0, 0, 0))
+        bound_rect = surf.get_bounding_rect()
+        self.assertEqual(bound_rect.width, 0)
+        self.assertEqual(bound_rect.height, 0)
+        surf.set_at((30, 30), (255, 255, 255))
+        bound_rect = surf.get_bounding_rect()
+        self.assertEqual(bound_rect.left, 30)
+        self.assertEqual(bound_rect.top, 30)
+        self.assertEqual(bound_rect.width, 1)
+        self.assertEqual(bound_rect.height, 1)
+        surf.set_at((60, 60), (255, 255, 255))
+        bound_rect = surf.get_bounding_rect()
+        self.assertEqual(bound_rect.left, 30)
+        self.assertEqual(bound_rect.top, 30)
+        self.assertEqual(bound_rect.width, 31)
+        self.assertEqual(bound_rect.height, 31)
+
+        # Issue #180
+        pygame.display.init()
+        try:
+            surf = pygame.Surface((4, 1), 0, 8)
+            surf.fill((255, 255, 255))
+            surf.get_bounding_rect()  # Segfault.
+        finally:
+            pygame.display.quit()
+
+    def test_copy(self):
+        """Ensure a surface can be copied."""
+        color = (25, 25, 25, 25)
+        s1 = pygame.Surface((32, 32), pygame.SRCALPHA, 32)
+        s1.fill(color)
+
+        s2 = s1.copy()
+
+        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)
+        fill_rect = pygame.Rect(0, 0, 16, 16)
+        s1 = pygame.Surface((32, 32), pygame.SRCALPHA, 32)
+        s1.fill(color, fill_rect)
+
+        for pt in test_utils.rect_area_pts(fill_rect):
+            self.assertEqual(s1.get_at(pt), color)
+
+        for pt in test_utils.rect_outer_bounds(fill_rect):
+            self.assertNotEqual(s1.get_at(pt), color)
+
+    def test_fill_rle(self):
+        """Test RLEACCEL flag with fill()"""
+        color = (250, 25, 25, 255)
+
+        surf = pygame.Surface((32, 32))
+        blit_surf = pygame.Surface((32, 32))
+
+        blit_surf.set_colorkey((255, 0, 255), pygame.RLEACCEL)
+        self.assertTrue(blit_surf.get_flags() & pygame.RLEACCELOK)
+        surf.blit(blit_surf, (0, 0))
+        blit_surf.fill(color)
+        self.assertEqual(
+            blit_surf.mustlock(), (blit_surf.get_flags() & pygame.RLEACCEL) != 0
+        )
+        self.assertTrue(blit_surf.get_flags() & pygame.RLEACCEL)
+
+    def test_mustlock_rle(self):
+        """Test RLEACCEL flag with mustlock()"""
+        surf = pygame.Surface((100, 100))
+        blit_surf = pygame.Surface((100, 100))
+        blit_surf.set_colorkey((0, 0, 255), pygame.RLEACCEL)
+        self.assertTrue(blit_surf.get_flags() & pygame.RLEACCELOK)
+        surf.blit(blit_surf, (0, 0))
+        self.assertTrue(blit_surf.get_flags() & pygame.RLEACCEL)
+        self.assertTrue(blit_surf.mustlock())
+
+    def test_mustlock_surf_alpha_rle(self):
+        """Test RLEACCEL flag with mustlock() on a surface
+        with per pixel alpha - new feature in SDL2"""
+        surf = pygame.Surface((100, 100))
+        blit_surf = pygame.Surface((100, 100), depth=32, flags=pygame.SRCALPHA)
+        blit_surf.set_colorkey((192, 191, 192, 255), pygame.RLEACCEL)
+        self.assertTrue(blit_surf.get_flags() & pygame.RLEACCELOK)
+        surf.blit(blit_surf, (0, 0))
+        self.assertTrue(blit_surf.get_flags() & pygame.RLEACCEL)
+        self.assertTrue(blit_surf.get_flags() & pygame.SRCALPHA)
+        self.assertTrue(blit_surf.mustlock())
+
+    def test_copy_rle(self):
+        """Test copying a surface set to use run length encoding"""
+        s1 = pygame.Surface((32, 32), 24)
+        s1.set_colorkey((255, 0, 255), pygame.RLEACCEL)
+        self.assertTrue(s1.get_flags() & pygame.RLEACCELOK)
+
+        newsurf = s1.copy()
+        self.assertTrue(s1.get_flags() & pygame.RLEACCELOK)
+        self.assertTrue(newsurf.get_flags() & pygame.RLEACCELOK)
+
+    def test_subsurface_rle(self):
+        """Ensure an RLE sub-surface works independently of its parent."""
+        color = (250, 25, 25, 255)
+        color2 = (200, 200, 250, 255)
+        sub_rect = pygame.Rect(16, 16, 16, 16)
+        s0 = pygame.Surface((32, 32), 24)
+        s1 = pygame.Surface((32, 32), 24)
+        s1.set_colorkey((255, 0, 255), pygame.RLEACCEL)
+        s1.fill(color)
+        s2 = s1.subsurface(sub_rect)
+        s2.fill(color2)
+        s0.blit(s1, (0, 0))
+        self.assertTrue(s1.get_flags() & pygame.RLEACCEL)
+        self.assertTrue(not s2.get_flags() & pygame.RLEACCEL)
+
+    def test_subsurface_rle2(self):
+        """Ensure an RLE sub-surface works independently of its parent."""
+        color = (250, 25, 25, 255)
+        color2 = (200, 200, 250, 255)
+        sub_rect = pygame.Rect(16, 16, 16, 16)
+
+        s0 = pygame.Surface((32, 32), 24)
+        s1 = pygame.Surface((32, 32), 24)
+        s1.set_colorkey((255, 0, 255), pygame.RLEACCEL)
+        s1.fill(color)
+        s2 = s1.subsurface(sub_rect)
+        s2.fill(color2)
+        s0.blit(s2, (0, 0))
+        self.assertTrue(s1.get_flags() & pygame.RLEACCELOK)
+        self.assertTrue(not s2.get_flags() & pygame.RLEACCELOK)
+
+    def test_solarwolf_rle_usage(self):
+        """Test for error/crash when calling set_colorkey() followed
+        by convert twice in succession. Code originally taken
+        from solarwolf."""
+
+        def optimize(img):
+            clear = img.get_colorkey()
+            img.set_colorkey(clear, RLEACCEL)
+            self.assertEqual(img.get_colorkey(), clear)
+            return img.convert()
+
+        pygame.display.init()
+        try:
+            pygame.display.set_mode((640, 480))
+
+            image = pygame.image.load(example_path(os.path.join("data", "alien1.png")))
+            image = image.convert()
+            orig_colorkey = image.get_colorkey()
+
+            image = optimize(image)
+            image = optimize(image)
+            self.assertTrue(image.get_flags() & pygame.RLEACCELOK)
+            self.assertTrue(not image.get_flags() & pygame.RLEACCEL)
+            self.assertEqual(image.get_colorkey(), orig_colorkey)
+            self.assertTrue(isinstance(image, pygame.Surface))
+        finally:
+            pygame.display.quit()
+
+    def test_solarwolf_rle_usage_2(self):
+        """Test for RLE status after setting alpha"""
+
+        pygame.display.init()
+        try:
+            pygame.display.set_mode((640, 480), depth=32)
+            blit_to_surf = pygame.Surface((100, 100))
+
+            image = pygame.image.load(example_path(os.path.join("data", "alien1.png")))
+            image = image.convert()
+            orig_colorkey = image.get_colorkey()
+
+            # set the colorkey with RLEACCEL, should add the RLEACCELOK flag
+            image.set_colorkey(orig_colorkey, RLEACCEL)
+            self.assertTrue(image.get_flags() & pygame.RLEACCELOK)
+            self.assertTrue(not image.get_flags() & pygame.RLEACCEL)
+
+            # now blit the surface - should add the RLEACCEL flag
+            blit_to_surf.blit(image, (0, 0))
+            self.assertTrue(image.get_flags() & pygame.RLEACCELOK)
+            self.assertTrue(image.get_flags() & pygame.RLEACCEL)
+
+            # Now set the alpha, without RLE acceleration - should strip all
+            # RLE flags
+            image.set_alpha(90)
+            self.assertTrue(not image.get_flags() & pygame.RLEACCELOK)
+            self.assertTrue(not image.get_flags() & pygame.RLEACCEL)
+
+        finally:
+            pygame.display.quit()
+
+    def test_set_alpha__set_colorkey_rle(self):
+        pygame.display.init()
+        try:
+            pygame.display.set_mode((640, 480))
+            blit_to_surf = pygame.Surface((80, 71))
+            blit_to_surf.fill((255, 255, 255))
+
+            image = pygame.image.load(example_path(os.path.join("data", "alien1.png")))
+            image = image.convert()
+            orig_colorkey = image.get_colorkey()
+
+            # Add the RLE flag while setting alpha for the whole surface
+            image.set_alpha(90, RLEACCEL)
+            blit_to_surf.blit(image, (0, 0))
+            sample_pixel_rle = blit_to_surf.get_at((50, 50))
+
+            # Now reset the colorkey to the original value with RLE
+            self.assertEqual(image.get_colorkey(), orig_colorkey)
+            image.set_colorkey(orig_colorkey, RLEACCEL)
+            blit_to_surf.fill((255, 255, 255))
+            blit_to_surf.blit(image, (0, 0))
+            sample_pixel_no_rle = blit_to_surf.get_at((50, 50))
+
+            self.assertAlmostEqual(sample_pixel_rle.r, sample_pixel_no_rle.r, delta=2)
+            self.assertAlmostEqual(sample_pixel_rle.g, sample_pixel_no_rle.g, delta=2)
+            self.assertAlmostEqual(sample_pixel_rle.b, sample_pixel_no_rle.b, delta=2)
+
+        finally:
+            pygame.display.quit()
+
+    def test_fill_negative_coordinates(self):
+        # negative coordinates should be clipped by fill, and not draw outside the surface.
+        color = (25, 25, 25, 25)
+        color2 = (20, 20, 20, 25)
+        fill_rect = pygame.Rect(-10, -10, 16, 16)
+
+        s1 = pygame.Surface((32, 32), pygame.SRCALPHA, 32)
+        r1 = s1.fill(color, fill_rect)
+        c = s1.get_at((0, 0))
+        self.assertEqual(c, color)
+
+        # 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))
+        self.assertEqual(c, color)
+
+        # rect returns the area we actually fill.
+        r3 = s2.fill(color2, (-30, -30, 5, 5))
+        # 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):
+        """Ensure fill() accepts keyword arguments."""
+        color = (1, 2, 3, 255)
+        area = (1, 1, 2, 2)
+        s1 = pygame.Surface((4, 4), 0, 32)
+        s1.fill(special_flags=pygame.BLEND_ADD, color=color, rect=area)
+
+        self.assertEqual(s1.get_at((0, 0)), (0, 0, 0, 255))
+        self.assertEqual(s1.get_at((1, 1)), color)
+
+    ########################################################################
+
+    def test_get_alpha(self):
+        """Ensure a surface's alpha value can be retrieved."""
+        s1 = pygame.Surface((32, 32), pygame.SRCALPHA, 32)
+
+        self.assertEqual(s1.get_alpha(), 255)
+
+        for alpha in (0, 32, 127, 255):
+            s1.set_alpha(alpha)
+            for t in range(4):
+                s1.set_alpha(s1.get_alpha())
+
+            self.assertEqual(s1.get_alpha(), alpha)
+
+    ########################################################################
+
+    def test_get_bytesize(self):
+        """Ensure a surface's bit and byte sizes can be retrieved."""
+        pygame.display.init()
+        try:
+            depth = 32
+            depth_bytes = 4
+            s1 = pygame.Surface((32, 32), pygame.SRCALPHA, depth)
+
+            self.assertEqual(s1.get_bytesize(), depth_bytes)
+            self.assertEqual(s1.get_bitsize(), depth)
+
+            depth = 15
+            depth_bytes = 2
+            s1 = pygame.Surface((32, 32), 0, depth)
+
+            self.assertEqual(s1.get_bytesize(), depth_bytes)
+            self.assertEqual(s1.get_bitsize(), depth)
+
+            depth = 12
+            depth_bytes = 2
+            s1 = pygame.Surface((32, 32), 0, depth)
+
+            self.assertEqual(s1.get_bytesize(), depth_bytes)
+            self.assertEqual(s1.get_bitsize(), depth)
+
+            with self.assertRaises(pygame.error):
+                surface = pygame.display.set_mode()
+                pygame.display.quit()
+                surface.get_bytesize()
+        finally:
+            pygame.display.quit()
+
+    ########################################################################
+
+    def test_get_flags(self):
+        """Ensure a surface's flags can be retrieved."""
+        s1 = pygame.Surface((32, 32), pygame.SRCALPHA, 32)
+
+        self.assertEqual(s1.get_flags(), pygame.SRCALPHA)
+
+    @unittest.skipIf(
+        os.environ.get("SDL_VIDEODRIVER") == "dummy",
+        'requires a non-"dummy" SDL_VIDEODRIVER',
+    )
+    def test_get_flags__display_surf(self):
+        pygame.display.init()
+        try:
+            # FULLSCREEN
+            screen_surf = pygame.display.set_mode((600, 400), flags=0)
+            self.assertFalse(screen_surf.get_flags() & pygame.FULLSCREEN)
+
+            screen_surf = pygame.display.set_mode((600, 400), flags=pygame.FULLSCREEN)
+            self.assertTrue(screen_surf.get_flags() & pygame.FULLSCREEN)
+
+            # NOFRAME
+            screen_surf = pygame.display.set_mode((600, 400), flags=0)
+            self.assertFalse(screen_surf.get_flags() & pygame.NOFRAME)
+
+            screen_surf = pygame.display.set_mode((600, 400), flags=pygame.NOFRAME)
+            self.assertTrue(screen_surf.get_flags() & pygame.NOFRAME)
+
+            # RESIZABLE
+            screen_surf = pygame.display.set_mode((600, 400), flags=0)
+            self.assertFalse(screen_surf.get_flags() & pygame.RESIZABLE)
+
+            screen_surf = pygame.display.set_mode((600, 400), flags=pygame.RESIZABLE)
+            self.assertTrue(screen_surf.get_flags() & pygame.RESIZABLE)
+
+            # OPENGL
+            screen_surf = pygame.display.set_mode((600, 400), flags=0)
+            # 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)
+
+            try:
+                pygame.display.set_mode((200, 200), pygame.OPENGL, 32)
+            except pygame.error:
+                pass  # If we can't create OPENGL surface don't try this test
+            else:
+                self.assertTrue(screen_surf.get_flags() & pygame.OPENGL)
+        finally:
+            pygame.display.quit()
+
+    ########################################################################
+
+    def test_get_parent(self):
+        """Ensure a surface's parent can be retrieved."""
+        pygame.display.init()
+        try:
+            parent = pygame.Surface((16, 16))
+            child = parent.subsurface((0, 0, 5, 5))
+
+            self.assertIs(child.get_parent(), parent)
+
+            with self.assertRaises(pygame.error):
+                surface = pygame.display.set_mode()
+                pygame.display.quit()
+                surface.get_parent()
+        finally:
+            pygame.display.quit()
+
+    ########################################################################
+
+    def test_get_rect(self):
+        """Ensure a surface's rect can be retrieved."""
+        size = (16, 16)
+        surf = pygame.Surface(size)
+        rect = surf.get_rect()
+
+        self.assertEqual(rect.size, size)
+
+    ########################################################################
+
+    def test_get_width__size_and_height(self):
+        """Ensure a surface's size, width and height can be retrieved."""
+        for w in range(0, 255, 32):
+            for h in range(0, 127, 15):
+                s = pygame.Surface((w, h))
+                self.assertEqual(s.get_width(), w)
+                self.assertEqual(s.get_height(), h)
+                self.assertEqual(s.get_size(), (w, h))
+
+    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,
+        # ValueErrors returned otherwise.
+        Error = ValueError
+        s = pygame.Surface((5, 7), 0, 8)
+        v2 = s.get_view("2")
+
+        self.assertRaises(Error, s.get_view, "0")
+        self.assertRaises(Error, s.get_view, "1")
+        self.assertIsInstance(v2, BufferProxy)
+        self.assertRaises(Error, s.get_view, "3")
+
+        s = pygame.Surface((8, 7), 0, 8)
+        length = s.get_bytesize() * s.get_width() * s.get_height()
+        v0 = s.get_view("0")
+        v1 = s.get_view("1")
+
+        self.assertIsInstance(v0, BufferProxy)
+        self.assertEqual(v0.length, length)
+        self.assertIsInstance(v1, BufferProxy)
+        self.assertEqual(v1.length, length)
+
+        s = pygame.Surface((5, 7), 0, 16)
+        v2 = s.get_view("2")
+
+        self.assertRaises(Error, s.get_view, "0")
+        self.assertRaises(Error, s.get_view, "1")
+        self.assertIsInstance(v2, BufferProxy)
+        self.assertRaises(Error, s.get_view, "3")
+
+        s = pygame.Surface((8, 7), 0, 16)
+        length = s.get_bytesize() * s.get_width() * s.get_height()
+        v0 = s.get_view("0")
+        v1 = s.get_view("1")
+
+        self.assertIsInstance(v0, BufferProxy)
+        self.assertEqual(v0.length, length)
+        self.assertIsInstance(v1, BufferProxy)
+        self.assertEqual(v1.length, length)
+
+        s = pygame.Surface((5, 7), pygame.SRCALPHA, 16)
+        v2 = s.get_view("2")
+
+        self.assertIsInstance(v2, BufferProxy)
+        self.assertRaises(Error, s.get_view, "3")
+
+        s = pygame.Surface((5, 7), 0, 24)
+        v2 = s.get_view("2")
+        v3 = s.get_view("3")
+
+        self.assertRaises(Error, s.get_view, "0")
+        self.assertRaises(Error, s.get_view, "1")
+        self.assertIsInstance(v2, BufferProxy)
+        self.assertIsInstance(v3, BufferProxy)
+
+        s = pygame.Surface((8, 7), 0, 24)
+        length = s.get_bytesize() * s.get_width() * s.get_height()
+        v0 = s.get_view("0")
+        v1 = s.get_view("1")
+
+        self.assertIsInstance(v0, BufferProxy)
+        self.assertEqual(v0.length, length)
+        self.assertIsInstance(v1, BufferProxy)
+        self.assertEqual(v1.length, length)
+
+        s = pygame.Surface((5, 7), 0, 32)
+        length = s.get_bytesize() * s.get_width() * s.get_height()
+        v0 = s.get_view("0")
+        v1 = s.get_view("1")
+        v2 = s.get_view("2")
+        v3 = s.get_view("3")
+
+        self.assertIsInstance(v0, BufferProxy)
+        self.assertEqual(v0.length, length)
+        self.assertIsInstance(v1, BufferProxy)
+        self.assertEqual(v1.length, length)
+        self.assertIsInstance(v2, BufferProxy)
+        self.assertIsInstance(v3, BufferProxy)
+
+        s2 = s.subsurface((0, 0, 4, 7))
+
+        self.assertRaises(Error, s2.get_view, "0")
+        self.assertRaises(Error, s2.get_view, "1")
+
+        s2 = None
+        s = pygame.Surface((5, 7), pygame.SRCALPHA, 32)
+
+        for kind in ("2", "3", "a", "A", "r", "R", "g", "G", "b", "B"):
+            self.assertIsInstance(s.get_view(kind), BufferProxy)
+
+        # Check default argument value: '2'
+        s = pygame.Surface((2, 4), 0, 32)
+        v = s.get_view()
+        if not IS_PYPY:
+            ai = ArrayInterface(v)
+            self.assertEqual(ai.nd, 2)
+
+        # Check locking.
+        s = pygame.Surface((2, 4), 0, 32)
+
+        self.assertFalse(s.get_locked())
+
+        v = s.get_view("2")
+
+        self.assertFalse(s.get_locked())
+
+        c = v.__array_interface__
+
+        self.assertTrue(s.get_locked())
+
+        c = None
+        gc.collect()
+
+        self.assertTrue(s.get_locked())
+
+        v = None
+        gc.collect()
+
+        self.assertFalse(s.get_locked())
+
+        # Check invalid view kind values.
+        s = pygame.Surface((2, 4), pygame.SRCALPHA, 32)
+        self.assertRaises(TypeError, s.get_view, "")
+        self.assertRaises(TypeError, s.get_view, "9")
+        self.assertRaises(TypeError, s.get_view, "RGBA")
+        self.assertRaises(TypeError, s.get_view, 2)
+
+        # Both unicode and bytes strings are allowed for kind.
+        s = pygame.Surface((2, 4), 0, 32)
+        s.get_view("2")
+        s.get_view(b"2")
+
+        # Garbage collection
+        s = pygame.Surface((2, 4), 0, 32)
+        weak_s = weakref.ref(s)
+        v = s.get_view("3")
+        weak_v = weakref.ref(v)
+        gc.collect()
+        self.assertTrue(weak_s() is s)
+        self.assertTrue(weak_v() is v)
+        del v
+        gc.collect()
+        self.assertTrue(weak_s() is s)
+        self.assertTrue(weak_v() is None)
+        del s
+        gc.collect()
+        self.assertTrue(weak_s() is None)
+
+    def test_get_buffer(self):
+        # Check that get_buffer works for all pixel sizes and for a subsurface.
+
+        # Check for all pixel sizes
+        for bitsize in [8, 16, 24, 32]:
+            s = pygame.Surface((5, 7), 0, bitsize)
+            length = s.get_pitch() * s.get_height()
+            v = s.get_buffer()
+
+            self.assertIsInstance(v, BufferProxy)
+            self.assertEqual(v.length, length)
+            self.assertEqual(repr(v), f"")
+
+        # Check for a subsurface (not contiguous)
+        s = pygame.Surface((7, 10), 0, 32)
+        s2 = s.subsurface((1, 2, 5, 7))
+        length = s2.get_pitch() * s2.get_height()
+        v = s2.get_buffer()
+
+        self.assertIsInstance(v, BufferProxy)
+        self.assertEqual(v.length, length)
+
+        # Check locking.
+        s = pygame.Surface((2, 4), 0, 32)
+        v = s.get_buffer()
+        self.assertTrue(s.get_locked())
+        v = None
+        gc.collect()
+        self.assertFalse(s.get_locked())
+
+    OLDBUF = hasattr(pygame.bufferproxy, "get_segcount")
+
+    @unittest.skipIf(not OLDBUF, "old buffer not available")
+    def test_get_buffer_oldbuf(self):
+        from pygame.bufferproxy import get_segcount, get_write_buffer
+
+        s = pygame.Surface((2, 4), pygame.SRCALPHA, 32)
+        v = s.get_buffer()
+        segcount, buflen = get_segcount(v)
+        self.assertEqual(segcount, 1)
+        self.assertEqual(buflen, s.get_pitch() * s.get_height())
+        seglen, segaddr = get_write_buffer(v, 0)
+        self.assertEqual(segaddr, s._pixels_address)
+        self.assertEqual(seglen, buflen)
+
+    @unittest.skipIf(not OLDBUF, "old buffer not available")
+    def test_get_view_oldbuf(self):
+        from pygame.bufferproxy import get_segcount, get_write_buffer
+
+        s = pygame.Surface((2, 4), pygame.SRCALPHA, 32)
+        v = s.get_view("1")
+        segcount, buflen = get_segcount(v)
+        self.assertEqual(segcount, 8)
+        self.assertEqual(buflen, s.get_pitch() * s.get_height())
+        seglen, segaddr = get_write_buffer(v, 7)
+        self.assertEqual(segaddr, s._pixels_address + s.get_bytesize() * 7)
+        self.assertEqual(seglen, s.get_bytesize())
+
+    def test_set_colorkey(self):
+        # __doc__ (as of 2008-06-25) for pygame.surface.Surface.set_colorkey:
+
+        # Surface.set_colorkey(Color, flags=0): return None
+        # Surface.set_colorkey(None): return None
+        # Set the transparent colorkey
+
+        s = pygame.Surface((16, 16), pygame.SRCALPHA, 32)
+
+        colorkeys = ((20, 189, 20, 255), (128, 50, 50, 255), (23, 21, 255, 255))
+
+        for colorkey in colorkeys:
+            s.set_colorkey(colorkey)
+
+            for t in range(4):
+                s.set_colorkey(s.get_colorkey())
+
+            self.assertEqual(s.get_colorkey(), colorkey)
+
+    def test_set_masks(self):
+        s = pygame.Surface((32, 32))
+        r, g, b, a = s.get_masks()
+        self.assertRaises(TypeError, s.set_masks, (b, g, r, a))
+
+    def test_set_shifts(self):
+        s = pygame.Surface((32, 32))
+        r, g, b, a = s.get_shifts()
+        self.assertRaises(TypeError, s.set_shifts, (b, g, r, a))
+
+    def test_blit_keyword_args(self):
+        color = (1, 2, 3, 255)
+        s1 = pygame.Surface((4, 4), 0, 32)
+        s2 = pygame.Surface((2, 2), 0, 32)
+        s2.fill((1, 2, 3))
+        s1.blit(special_flags=BLEND_ADD, source=s2, dest=(1, 1), area=s2.get_rect())
+        self.assertEqual(s1.get_at((0, 0)), (0, 0, 0, 255))
+        self.assertEqual(s1.get_at((1, 1)), color)
+
+    def test_blit_big_rects(self):
+        """SDL2 can have more than 16 bits for x, y, width, height."""
+        big_surf = pygame.Surface((100, 68000), 0, 32)
+        big_surf_color = (255, 0, 0)
+        big_surf.fill(big_surf_color)
+
+        background = pygame.Surface((500, 500), 0, 32)
+        background_color = (0, 255, 0)
+        background.fill(background_color)
+
+        # copy parts of the big_surf using more than 16bit parts.
+        background.blit(big_surf, (100, 100), area=(0, 16000, 100, 100))
+        background.blit(big_surf, (200, 200), area=(0, 32000, 100, 100))
+        background.blit(big_surf, (300, 300), area=(0, 66000, 100, 100))
+
+        # check that all three areas are drawn.
+        self.assertEqual(background.get_at((101, 101)), big_surf_color)
+        self.assertEqual(background.get_at((201, 201)), big_surf_color)
+        self.assertEqual(background.get_at((301, 301)), big_surf_color)
+
+        # areas outside the 3 blitted areas not covered by those blits.
+        self.assertEqual(background.get_at((400, 301)), background_color)
+        self.assertEqual(background.get_at((400, 201)), background_color)
+        self.assertEqual(background.get_at((100, 201)), background_color)
+        self.assertEqual(background.get_at((99, 99)), background_color)
+        self.assertEqual(background.get_at((450, 450)), background_color)
+
+
+class TestSurfaceBlit(unittest.TestCase):
+    """Tests basic blitting functionality and options."""
+
+    # __doc__ (as of 2008-08-02) for pygame.surface.Surface.blit:
+
+    # Surface.blit(source, dest, area=None, special_flags = 0): return Rect
+    # draw one image onto another
+    #
+    # Draws a source Surface onto this Surface. The draw can be positioned
+    # 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 effect the blit.
+    #
+    # An optional area rectangle can be passed as well. This represents a
+    # smaller portion of the source Surface to draw.
+    #
+    # An optional special flags is for passing in new in 1.8.0: BLEND_ADD,
+    # BLEND_SUB, BLEND_MULT, BLEND_MIN, BLEND_MAX new in 1.8.1:
+    # 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 With other special blitting flags
+    # perhaps added in the future.
+    #
+    # 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.
+    # special_flags new in pygame 1.8.
+
+    def setUp(self):
+        """Resets starting surfaces."""
+        self.src_surface = pygame.Surface((256, 256), 32)
+        self.src_surface.fill(pygame.Color(255, 255, 255))
+        self.dst_surface = pygame.Surface((64, 64), 32)
+        self.dst_surface.fill(pygame.Color(0, 0, 0))
+
+    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))
+        for k in [(x, x) for x in range(64)]:
+            self.assertEqual(self.dst_surface.get_at(k), (255, 255, 255))
+
+    def test_blit_overflow_rect(self):
+        """Full coverage w/ overflow, specified with a Rect"""
+        result = self.dst_surface.blit(self.src_surface, pygame.Rect(-1, -1, 300, 300))
+        self.assertIsInstance(result, pygame.Rect)
+        self.assertEqual(result.size, (64, 64))
+        for k in [(x, x) for x in range(64)]:
+            self.assertEqual(self.dst_surface.get_at(k), (255, 255, 255))
+
+    def test_blit_overflow_nonorigin(self):
+        """Test Rectangle Dest, with overflow but with starting rect with top-left at (1,1)"""
+        result = self.dst_surface.blit(self.src_surface, dest=pygame.Rect((1, 1, 1, 1)))
+        self.assertIsInstance(result, pygame.Rect)
+        self.assertEqual(result.size, (63, 63))
+        self.assertEqual(self.dst_surface.get_at((0, 0)), (0, 0, 0))
+        self.assertEqual(self.dst_surface.get_at((63, 0)), (0, 0, 0))
+        self.assertEqual(self.dst_surface.get_at((0, 63)), (0, 0, 0))
+        self.assertEqual(self.dst_surface.get_at((1, 1)), (255, 255, 255))
+        self.assertEqual(self.dst_surface.get_at((63, 63)), (255, 255, 255))
+
+    def test_blit_area_contraint(self):
+        """Testing area constraint"""
+        result = self.dst_surface.blit(
+            self.src_surface,
+            dest=pygame.Rect((1, 1, 1, 1)),
+            area=pygame.Rect((2, 2, 2, 2)),
+        )
+        self.assertIsInstance(result, pygame.Rect)
+        self.assertEqual(result.size, (2, 2))
+        self.assertEqual(self.dst_surface.get_at((0, 0)), (0, 0, 0))  # Corners
+        self.assertEqual(self.dst_surface.get_at((63, 0)), (0, 0, 0))
+        self.assertEqual(self.dst_surface.get_at((0, 63)), (0, 0, 0))
+        self.assertEqual(self.dst_surface.get_at((63, 63)), (0, 0, 0))
+        self.assertEqual(
+            self.dst_surface.get_at((1, 1)), (255, 255, 255)
+        )  # Blitted Area
+        self.assertEqual(self.dst_surface.get_at((2, 2)), (255, 255, 255))
+        self.assertEqual(self.dst_surface.get_at((3, 3)), (0, 0, 0))
+        # Should stop short of filling in (3,3)
+
+    def test_blit_zero_overlap(self):
+        """Testing zero-overlap condition."""
+        result = self.dst_surface.blit(
+            self.src_surface,
+            dest=pygame.Rect((-256, -256, 1, 1)),
+            area=pygame.Rect((2, 2, 256, 256)),
+        )
+        self.assertIsInstance(result, pygame.Rect)
+        self.assertEqual(result.size, (0, 0))  # No blitting expected
+        for k in [(x, x) for x in range(64)]:
+            self.assertEqual(self.dst_surface.get_at(k), (0, 0, 0))  # Diagonal
+        self.assertEqual(
+            self.dst_surface.get_at((63, 0)), (0, 0, 0)
+        )  # Remaining corners
+        self.assertEqual(self.dst_surface.get_at((0, 63)), (0, 0, 0))
+
+    def test_blit__SRCALPHA_opaque_source(self):
+        src = pygame.Surface((256, 256), SRCALPHA, 32)
+        dst = src.copy()
+
+        for i, j in test_utils.rect_area_pts(src.get_rect()):
+            dst.set_at((i, j), (i, 0, 0, j))
+            src.set_at((i, j), (0, i, 0, 255))
+
+        dst.blit(src, (0, 0))
+
+        for pt in test_utils.rect_area_pts(src.get_rect()):
+            self.assertEqual(dst.get_at(pt)[1], src.get_at(pt)[1])
+
+    def test_blit__blit_to_self(self):
+        """Test that blit operation works on self, alpha value is
+        correct, and that no RGB distortion occurs."""
+        test_surface = pygame.Surface((128, 128), SRCALPHA, 32)
+        area = test_surface.get_rect()
+
+        for pt, test_color in test_utils.gradient(area.width, area.height):
+            test_surface.set_at(pt, test_color)
+
+        reference_surface = test_surface.copy()
+
+        test_surface.blit(test_surface, (0, 0))
+
+        for x in range(area.width):
+            for y in range(area.height):
+                (r, g, b, a) = reference_color = reference_surface.get_at((x, y))
+                expected_color = (r, g, b, (a + (a * ((256 - a) // 256))))
+                self.assertEqual(reference_color, expected_color)
+
+        self.assertEqual(reference_surface.get_rect(), test_surface.get_rect())
+
+    def test_blit__SRCALPHA_to_SRCALPHA_non_zero(self):
+        """Tests blitting a nonzero alpha surface to another nonzero alpha surface
+        both straight alpha compositing method. Test is fuzzy (+/- 1/256) to account for
+        different implementations in SDL1 and SDL2.
+        """
+
+        size = (32, 32)
+
+        def check_color_diff(color1, color2):
+            """Returns True if two colors are within (1, 1, 1, 1) of each other."""
+            for val in color1 - color2:
+                if abs(val) > 1:
+                    return False
+            return True
+
+        def high_a_onto_low(high, low):
+            """Tests straight alpha case. Source is low alpha, destination is high alpha"""
+            high_alpha_surface = pygame.Surface(size, pygame.SRCALPHA, 32)
+            low_alpha_surface = high_alpha_surface.copy()
+            high_alpha_color = Color(
+                (high, high, low, high)
+            )  # Injecting some RGB variance.
+            low_alpha_color = Color((high, low, low, low))
+            high_alpha_surface.fill(high_alpha_color)
+            low_alpha_surface.fill(low_alpha_color)
+
+            high_alpha_surface.blit(low_alpha_surface, (0, 0))
+
+            expected_color = low_alpha_color + Color(
+                tuple(
+                    ((x * (255 - low_alpha_color.a)) // 255) for x in high_alpha_color
+                )
+            )
+            self.assertTrue(
+                check_color_diff(high_alpha_surface.get_at((0, 0)), expected_color)
+            )
+
+        def low_a_onto_high(high, low):
+            """Tests straight alpha case. Source is high alpha, destination is low alpha"""
+            high_alpha_surface = pygame.Surface(size, pygame.SRCALPHA, 32)
+            low_alpha_surface = high_alpha_surface.copy()
+            high_alpha_color = Color(
+                (high, high, low, high)
+            )  # Injecting some RGB variance.
+            low_alpha_color = Color((high, low, low, low))
+            high_alpha_surface.fill(high_alpha_color)
+            low_alpha_surface.fill(low_alpha_color)
+
+            low_alpha_surface.blit(high_alpha_surface, (0, 0))
+
+            expected_color = high_alpha_color + Color(
+                tuple(
+                    ((x * (255 - high_alpha_color.a)) // 255) for x in low_alpha_color
+                )
+            )
+            self.assertTrue(
+                check_color_diff(low_alpha_surface.get_at((0, 0)), expected_color)
+            )
+
+        for low_a in range(0, 128):
+            for high_a in range(128, 256):
+                high_a_onto_low(high_a, low_a)
+                low_a_onto_high(high_a, low_a)
+
+    def test_blit__SRCALPHA32_to_8(self):
+        # Bug: fatal
+        # SDL_DisplayConvert segfaults when video is uninitialized.
+        target = pygame.Surface((11, 8), 0, 8)
+        test_color = target.get_palette_at(2)
+        source = pygame.Surface((1, 1), pygame.SRCALPHA, 32)
+        source.set_at((0, 0), test_color)
+        target.blit(source, (0, 0))
+
+
+class GeneralSurfaceTests(unittest.TestCase):
+    @unittest.skipIf(
+        os.environ.get("SDL_VIDEODRIVER") == "dummy",
+        'requires a non-"dummy" SDL_VIDEODRIVER',
+    )
+    def test_image_convert_bug_131(self):
+        # 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")))
+
+            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)), "")
+
+            # Ensure a palette format to palette format works.
+            im3 = im.convert(8)
+            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))
+
+        self.assertRaisesRegex(pygame.error, "display initialized", surf.convert)
+
+        pygame.display.init()
+        try:
+            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 video mode", surf.convert)
+
+            pygame.display.set_mode((640, 480))
+            try:
+                surf.convert()
+            except pygame.error:
+                self.fail("convert() should not raise an exception here.")
+        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()."""
+        pygame.display.quit()
+        surf = pygame.Surface((1, 1))
+
+        self.assertRaisesRegex(pygame.error, "display initialized", surf.convert_alpha)
+
+        pygame.display.init()
+        try:
+            self.assertRaisesRegex(pygame.error, "No video mode", surf.convert_alpha)
+
+            pygame.display.set_mode((640, 480))
+            try:
+                surf.convert_alpha()
+            except pygame.error:
+                self.fail("convert_alpha() should not raise an exception here.")
+        finally:
+            pygame.display.quit()
+
+    def test_convert_alpha_SRCALPHA(self):
+        """Ensure that the surface returned by surf.convert_alpha()
+        has alpha blending enabled"""
+        pygame.display.init()
+        try:
+            pygame.display.set_mode((640, 480))
+
+            s1 = pygame.Surface((100, 100), 0, 32)
+            # s2=pygame.Surface((100,100), pygame.SRCALPHA, 32)
+            s1_alpha = s1.convert_alpha()
+            self.assertEqual(s1_alpha.get_flags() & SRCALPHA, SRCALPHA)
+            self.assertEqual(s1_alpha.get_alpha(), 255)
+        finally:
+            pygame.display.quit()
+
+    def test_src_alpha_issue_1289(self):
+        """blit should be white."""
+        surf1 = pygame.Surface((1, 1), pygame.SRCALPHA, 32)
+        surf1.fill((255, 255, 255, 100))
+
+        surf2 = pygame.Surface((1, 1), pygame.SRCALPHA, 32)
+        self.assertEqual(surf2.get_at((0, 0)), (0, 0, 0, 0))
+        surf2.blit(surf1, (0, 0))
+
+        self.assertEqual(surf1.get_at((0, 0)), (255, 255, 255, 100))
+        self.assertEqual(surf2.get_at((0, 0)), (255, 255, 255, 100))
+
+    def test_src_alpha_compatible(self):
+        """ "What pygame 1.9.x did". Is the alpha blitter as before?"""
+
+        # The table below was generated with the SDL1 blit.
+        # def print_table():
+        #     nums = [0, 1, 65, 126, 127, 199, 254, 255]
+        #     results = {}
+        #     for dest_r, dest_b, dest_a in zip(nums, reversed(nums), reversed(nums)):
+        #         for src_r, src_b, src_a in zip(nums, reversed(nums), nums):
+        #             src_surf = pygame.Surface((66, 66), pygame.SRCALPHA, 32)
+        #             src_surf.fill((src_r, 255, src_b, src_a))
+        #             dest_surf = pygame.Surface((66, 66), pygame.SRCALPHA, 32)
+        #             dest_surf.fill((dest_r, 255, dest_b, dest_a))
+        #             dest_surf.blit(src_surf, (0, 0))
+        #             key = ((dest_r, dest_b, dest_a), (src_r, src_b, src_a))
+        #             results[key] = dest_surf.get_at((65, 33))
+        #     print("(dest_r, dest_b, dest_a), (src_r, src_b, src_a): color")
+        #     pprint(results)
+
+        results_expected = {
+            ((0, 255, 255), (0, 255, 0)): (0, 255, 255, 255),
+            ((0, 255, 255), (1, 254, 1)): (0, 255, 255, 255),
+            ((0, 255, 255), (65, 199, 65)): (16, 255, 241, 255),
+            ((0, 255, 255), (126, 127, 126)): (62, 255, 192, 255),
+            ((0, 255, 255), (127, 126, 127)): (63, 255, 191, 255),
+            ((0, 255, 255), (199, 65, 199)): (155, 255, 107, 255),
+            ((0, 255, 255), (254, 1, 254)): (253, 255, 2, 255),
+            ((0, 255, 255), (255, 0, 255)): (255, 255, 0, 255),
+            ((1, 254, 254), (0, 255, 0)): (1, 255, 254, 254),
+            ((1, 254, 254), (1, 254, 1)): (1, 255, 254, 255),
+            ((1, 254, 254), (65, 199, 65)): (17, 255, 240, 255),
+            ((1, 254, 254), (126, 127, 126)): (63, 255, 191, 255),
+            ((1, 254, 254), (127, 126, 127)): (64, 255, 190, 255),
+            ((1, 254, 254), (199, 65, 199)): (155, 255, 107, 255),
+            ((1, 254, 254), (254, 1, 254)): (253, 255, 2, 255),
+            ((1, 254, 254), (255, 0, 255)): (255, 255, 0, 255),
+            ((65, 199, 199), (0, 255, 0)): (65, 255, 199, 199),
+            ((65, 199, 199), (1, 254, 1)): (64, 255, 200, 200),
+            ((65, 199, 199), (65, 199, 65)): (65, 255, 199, 214),
+            ((65, 199, 199), (126, 127, 126)): (95, 255, 164, 227),
+            ((65, 199, 199), (127, 126, 127)): (96, 255, 163, 227),
+            ((65, 199, 199), (199, 65, 199)): (169, 255, 95, 243),
+            ((65, 199, 199), (254, 1, 254)): (253, 255, 2, 255),
+            ((65, 199, 199), (255, 0, 255)): (255, 255, 0, 255),
+            ((126, 127, 127), (0, 255, 0)): (126, 255, 127, 127),
+            ((126, 127, 127), (1, 254, 1)): (125, 255, 128, 128),
+            ((126, 127, 127), (65, 199, 65)): (110, 255, 146, 160),
+            ((126, 127, 127), (126, 127, 126)): (126, 255, 127, 191),
+            ((126, 127, 127), (127, 126, 127)): (126, 255, 126, 191),
+            ((126, 127, 127), (199, 65, 199)): (183, 255, 79, 227),
+            ((126, 127, 127), (254, 1, 254)): (253, 255, 1, 255),
+            ((126, 127, 127), (255, 0, 255)): (255, 255, 0, 255),
+            ((127, 126, 126), (0, 255, 0)): (127, 255, 126, 126),
+            ((127, 126, 126), (1, 254, 1)): (126, 255, 127, 127),
+            ((127, 126, 126), (65, 199, 65)): (111, 255, 145, 159),
+            ((127, 126, 126), (126, 127, 126)): (127, 255, 126, 190),
+            ((127, 126, 126), (127, 126, 127)): (127, 255, 126, 191),
+            ((127, 126, 126), (199, 65, 199)): (183, 255, 78, 227),
+            ((127, 126, 126), (254, 1, 254)): (254, 255, 1, 255),
+            ((127, 126, 126), (255, 0, 255)): (255, 255, 0, 255),
+            ((199, 65, 65), (0, 255, 0)): (199, 255, 65, 65),
+            ((199, 65, 65), (1, 254, 1)): (198, 255, 66, 66),
+            ((199, 65, 65), (65, 199, 65)): (165, 255, 99, 114),
+            ((199, 65, 65), (126, 127, 126)): (163, 255, 96, 159),
+            ((199, 65, 65), (127, 126, 127)): (163, 255, 95, 160),
+            ((199, 65, 65), (199, 65, 199)): (199, 255, 65, 214),
+            ((199, 65, 65), (254, 1, 254)): (254, 255, 1, 255),
+            ((199, 65, 65), (255, 0, 255)): (255, 255, 0, 255),
+            ((254, 1, 1), (0, 255, 0)): (254, 255, 1, 1),
+            ((254, 1, 1), (1, 254, 1)): (253, 255, 2, 2),
+            ((254, 1, 1), (65, 199, 65)): (206, 255, 52, 66),
+            ((254, 1, 1), (126, 127, 126)): (191, 255, 63, 127),
+            ((254, 1, 1), (127, 126, 127)): (191, 255, 63, 128),
+            ((254, 1, 1), (199, 65, 199)): (212, 255, 51, 200),
+            ((254, 1, 1), (254, 1, 254)): (254, 255, 1, 255),
+            ((254, 1, 1), (255, 0, 255)): (255, 255, 0, 255),
+            ((255, 0, 0), (0, 255, 0)): (0, 255, 255, 0),
+            ((255, 0, 0), (1, 254, 1)): (1, 255, 254, 1),
+            ((255, 0, 0), (65, 199, 65)): (65, 255, 199, 65),
+            ((255, 0, 0), (126, 127, 126)): (126, 255, 127, 126),
+            ((255, 0, 0), (127, 126, 127)): (127, 255, 126, 127),
+            ((255, 0, 0), (199, 65, 199)): (199, 255, 65, 199),
+            ((255, 0, 0), (254, 1, 254)): (254, 255, 1, 254),
+            ((255, 0, 0), (255, 0, 255)): (255, 255, 0, 255),
+        }
+
+        # chosen because they contain edge cases.
+        nums = [0, 1, 65, 126, 127, 199, 254, 255]
+        results = {}
+        for dst_r, dst_b, dst_a in zip(nums, reversed(nums), reversed(nums)):
+            for src_r, src_b, src_a in zip(nums, reversed(nums), nums):
+                with self.subTest(
+                    src_r=src_r,
+                    src_b=src_b,
+                    src_a=src_a,
+                    dest_r=dst_r,
+                    dest_b=dst_b,
+                    dest_a=dst_a,
+                ):
+                    src_surf = pygame.Surface((66, 66), pygame.SRCALPHA, 32)
+                    src_surf.fill((src_r, 255, src_b, src_a))
+                    dest_surf = pygame.Surface((66, 66), pygame.SRCALPHA, 32)
+                    dest_surf.fill((dst_r, 255, dst_b, dst_a))
+
+                    dest_surf.blit(src_surf, (0, 0))
+                    key = ((dst_r, dst_b, dst_a), (src_r, src_b, src_a))
+                    results[key] = dest_surf.get_at((65, 33))
+                    self.assertEqual(results[key], results_expected[key])
+
+        self.assertEqual(results, results_expected)
+
+    def test_src_alpha_compatible_16bit(self):
+        """ "What pygame 1.9.x did". Is the alpha blitter as before?"""
+
+        # The table below was generated with the SDL1 blit.
+        # def print_table():
+        #     nums = [0, 1, 65, 126, 127, 199, 254, 255]
+        #     results = {}
+        #     for dest_r, dest_b, dest_a in zip(nums, reversed(nums), reversed(nums)):
+        #         for src_r, src_b, src_a in zip(nums, reversed(nums), nums):
+        #             src_surf = pygame.Surface((66, 66), pygame.SRCALPHA, 16)
+        #             src_surf.fill((src_r, 255, src_b, src_a))
+        #             dest_surf = pygame.Surface((66, 66), pygame.SRCALPHA, 16)
+        #             dest_surf.fill((dest_r, 255, dest_b, dest_a))
+        #             dest_surf.blit(src_surf, (0, 0))
+        #             key = ((dest_r, dest_b, dest_a), (src_r, src_b, src_a))
+        #             results[key] = dest_surf.get_at((65, 33))
+        #     print("(dest_r, dest_b, dest_a), (src_r, src_b, src_a): color")
+        #     pprint(results)
+
+        results_expected = {
+            ((0, 255, 255), (0, 255, 0)): (0, 255, 255, 255),
+            ((0, 255, 255), (1, 254, 1)): (0, 255, 255, 255),
+            ((0, 255, 255), (65, 199, 65)): (17, 255, 255, 255),
+            ((0, 255, 255), (126, 127, 126)): (51, 255, 204, 255),
+            ((0, 255, 255), (127, 126, 127)): (51, 255, 204, 255),
+            ((0, 255, 255), (199, 65, 199)): (170, 255, 102, 255),
+            ((0, 255, 255), (254, 1, 254)): (255, 255, 0, 255),
+            ((0, 255, 255), (255, 0, 255)): (255, 255, 0, 255),
+            ((1, 254, 254), (0, 255, 0)): (0, 255, 255, 255),
+            ((1, 254, 254), (1, 254, 1)): (0, 255, 255, 255),
+            ((1, 254, 254), (65, 199, 65)): (17, 255, 255, 255),
+            ((1, 254, 254), (126, 127, 126)): (51, 255, 204, 255),
+            ((1, 254, 254), (127, 126, 127)): (51, 255, 204, 255),
+            ((1, 254, 254), (199, 65, 199)): (170, 255, 102, 255),
+            ((1, 254, 254), (254, 1, 254)): (255, 255, 0, 255),
+            ((1, 254, 254), (255, 0, 255)): (255, 255, 0, 255),
+            ((65, 199, 199), (0, 255, 0)): (68, 255, 204, 204),
+            ((65, 199, 199), (1, 254, 1)): (68, 255, 204, 204),
+            ((65, 199, 199), (65, 199, 65)): (68, 255, 204, 221),
+            ((65, 199, 199), (126, 127, 126)): (85, 255, 170, 238),
+            ((65, 199, 199), (127, 126, 127)): (85, 255, 170, 238),
+            ((65, 199, 199), (199, 65, 199)): (187, 255, 85, 255),
+            ((65, 199, 199), (254, 1, 254)): (255, 255, 0, 255),
+            ((65, 199, 199), (255, 0, 255)): (255, 255, 0, 255),
+            ((126, 127, 127), (0, 255, 0)): (119, 255, 119, 119),
+            ((126, 127, 127), (1, 254, 1)): (119, 255, 119, 119),
+            ((126, 127, 127), (65, 199, 65)): (102, 255, 136, 153),
+            ((126, 127, 127), (126, 127, 126)): (119, 255, 119, 187),
+            ((126, 127, 127), (127, 126, 127)): (119, 255, 119, 187),
+            ((126, 127, 127), (199, 65, 199)): (187, 255, 68, 238),
+            ((126, 127, 127), (254, 1, 254)): (255, 255, 0, 255),
+            ((126, 127, 127), (255, 0, 255)): (255, 255, 0, 255),
+            ((127, 126, 126), (0, 255, 0)): (119, 255, 119, 119),
+            ((127, 126, 126), (1, 254, 1)): (119, 255, 119, 119),
+            ((127, 126, 126), (65, 199, 65)): (102, 255, 136, 153),
+            ((127, 126, 126), (126, 127, 126)): (119, 255, 119, 187),
+            ((127, 126, 126), (127, 126, 127)): (119, 255, 119, 187),
+            ((127, 126, 126), (199, 65, 199)): (187, 255, 68, 238),
+            ((127, 126, 126), (254, 1, 254)): (255, 255, 0, 255),
+            ((127, 126, 126), (255, 0, 255)): (255, 255, 0, 255),
+            ((199, 65, 65), (0, 255, 0)): (204, 255, 68, 68),
+            ((199, 65, 65), (1, 254, 1)): (204, 255, 68, 68),
+            ((199, 65, 65), (65, 199, 65)): (170, 255, 102, 119),
+            ((199, 65, 65), (126, 127, 126)): (170, 255, 85, 153),
+            ((199, 65, 65), (127, 126, 127)): (170, 255, 85, 153),
+            ((199, 65, 65), (199, 65, 199)): (204, 255, 68, 221),
+            ((199, 65, 65), (254, 1, 254)): (255, 255, 0, 255),
+            ((199, 65, 65), (255, 0, 255)): (255, 255, 0, 255),
+            ((254, 1, 1), (0, 255, 0)): (0, 255, 255, 0),
+            ((254, 1, 1), (1, 254, 1)): (0, 255, 255, 0),
+            ((254, 1, 1), (65, 199, 65)): (68, 255, 204, 68),
+            ((254, 1, 1), (126, 127, 126)): (119, 255, 119, 119),
+            ((254, 1, 1), (127, 126, 127)): (119, 255, 119, 119),
+            ((254, 1, 1), (199, 65, 199)): (204, 255, 68, 204),
+            ((254, 1, 1), (254, 1, 254)): (255, 255, 0, 255),
+            ((254, 1, 1), (255, 0, 255)): (255, 255, 0, 255),
+            ((255, 0, 0), (0, 255, 0)): (0, 255, 255, 0),
+            ((255, 0, 0), (1, 254, 1)): (0, 255, 255, 0),
+            ((255, 0, 0), (65, 199, 65)): (68, 255, 204, 68),
+            ((255, 0, 0), (126, 127, 126)): (119, 255, 119, 119),
+            ((255, 0, 0), (127, 126, 127)): (119, 255, 119, 119),
+            ((255, 0, 0), (199, 65, 199)): (204, 255, 68, 204),
+            ((255, 0, 0), (254, 1, 254)): (255, 255, 0, 255),
+            ((255, 0, 0), (255, 0, 255)): (255, 255, 0, 255),
+        }
+
+        # chosen because they contain edge cases.
+        nums = [0, 1, 65, 126, 127, 199, 254, 255]
+        results = {}
+        for dst_r, dst_b, dst_a in zip(nums, reversed(nums), reversed(nums)):
+            for src_r, src_b, src_a in zip(nums, reversed(nums), nums):
+                with self.subTest(
+                    src_r=src_r,
+                    src_b=src_b,
+                    src_a=src_a,
+                    dest_r=dst_r,
+                    dest_b=dst_b,
+                    dest_a=dst_a,
+                ):
+                    src_surf = pygame.Surface((66, 66), pygame.SRCALPHA, 16)
+                    src_surf.fill((src_r, 255, src_b, src_a))
+                    dest_surf = pygame.Surface((66, 66), pygame.SRCALPHA, 16)
+                    dest_surf.fill((dst_r, 255, dst_b, dst_a))
+
+                    dest_surf.blit(src_surf, (0, 0))
+                    key = ((dst_r, dst_b, dst_a), (src_r, src_b, src_a))
+                    results[key] = dest_surf.get_at((65, 33))
+                    self.assertEqual(results[key], results_expected[key])
+
+        self.assertEqual(results, results_expected)
+
+    def test_sdl1_mimic_blitter_with_set_alpha(self):
+        """does the SDL 1 style blitter in pygame 2 work with set_alpha(),
+        this feature only exists in pygame 2/SDL2 SDL1 did not support
+        combining surface and pixel alpha"""
+
+        results_expected = {
+            ((0, 255, 255), (0, 255, 0)): (0, 255, 255, 255),
+            ((0, 255, 255), (1, 254, 1)): (0, 255, 255, 255),
+            ((0, 255, 255), (65, 199, 65)): (16, 255, 241, 255),
+            ((0, 255, 255), (126, 127, 126)): (62, 255, 192, 255),
+            ((0, 255, 255), (127, 126, 127)): (63, 255, 191, 255),
+            ((0, 255, 255), (199, 65, 199)): (155, 255, 107, 255),
+            ((0, 255, 255), (254, 1, 254)): (253, 255, 2, 255),
+            ((0, 255, 255), (255, 0, 255)): (255, 255, 0, 255),
+            ((1, 254, 254), (0, 255, 0)): (1, 255, 254, 254),
+            ((1, 254, 254), (1, 254, 1)): (1, 255, 254, 255),
+            ((1, 254, 254), (65, 199, 65)): (17, 255, 240, 255),
+            ((1, 254, 254), (126, 127, 126)): (63, 255, 191, 255),
+            ((1, 254, 254), (127, 126, 127)): (64, 255, 190, 255),
+            ((1, 254, 254), (199, 65, 199)): (155, 255, 107, 255),
+            ((1, 254, 254), (254, 1, 254)): (253, 255, 2, 255),
+            ((1, 254, 254), (255, 0, 255)): (255, 255, 0, 255),
+            ((65, 199, 199), (0, 255, 0)): (65, 255, 199, 199),
+            ((65, 199, 199), (1, 254, 1)): (64, 255, 200, 200),
+            ((65, 199, 199), (65, 199, 65)): (65, 255, 199, 214),
+            ((65, 199, 199), (126, 127, 126)): (95, 255, 164, 227),
+            ((65, 199, 199), (127, 126, 127)): (96, 255, 163, 227),
+            ((65, 199, 199), (199, 65, 199)): (169, 255, 95, 243),
+            ((65, 199, 199), (254, 1, 254)): (253, 255, 2, 255),
+            ((65, 199, 199), (255, 0, 255)): (255, 255, 0, 255),
+            ((126, 127, 127), (0, 255, 0)): (126, 255, 127, 127),
+            ((126, 127, 127), (1, 254, 1)): (125, 255, 128, 128),
+            ((126, 127, 127), (65, 199, 65)): (110, 255, 146, 160),
+            ((126, 127, 127), (126, 127, 126)): (126, 255, 127, 191),
+            ((126, 127, 127), (127, 126, 127)): (126, 255, 126, 191),
+            ((126, 127, 127), (199, 65, 199)): (183, 255, 79, 227),
+            ((126, 127, 127), (254, 1, 254)): (253, 255, 1, 255),
+            ((126, 127, 127), (255, 0, 255)): (255, 255, 0, 255),
+            ((127, 126, 126), (0, 255, 0)): (127, 255, 126, 126),
+            ((127, 126, 126), (1, 254, 1)): (126, 255, 127, 127),
+            ((127, 126, 126), (65, 199, 65)): (111, 255, 145, 159),
+            ((127, 126, 126), (126, 127, 126)): (127, 255, 126, 190),
+            ((127, 126, 126), (127, 126, 127)): (127, 255, 126, 191),
+            ((127, 126, 126), (199, 65, 199)): (183, 255, 78, 227),
+            ((127, 126, 126), (254, 1, 254)): (254, 255, 1, 255),
+            ((127, 126, 126), (255, 0, 255)): (255, 255, 0, 255),
+            ((199, 65, 65), (0, 255, 0)): (199, 255, 65, 65),
+            ((199, 65, 65), (1, 254, 1)): (198, 255, 66, 66),
+            ((199, 65, 65), (65, 199, 65)): (165, 255, 99, 114),
+            ((199, 65, 65), (126, 127, 126)): (163, 255, 96, 159),
+            ((199, 65, 65), (127, 126, 127)): (163, 255, 95, 160),
+            ((199, 65, 65), (199, 65, 199)): (199, 255, 65, 214),
+            ((199, 65, 65), (254, 1, 254)): (254, 255, 1, 255),
+            ((199, 65, 65), (255, 0, 255)): (255, 255, 0, 255),
+            ((254, 1, 1), (0, 255, 0)): (254, 255, 1, 1),
+            ((254, 1, 1), (1, 254, 1)): (253, 255, 2, 2),
+            ((254, 1, 1), (65, 199, 65)): (206, 255, 52, 66),
+            ((254, 1, 1), (126, 127, 126)): (191, 255, 63, 127),
+            ((254, 1, 1), (127, 126, 127)): (191, 255, 63, 128),
+            ((254, 1, 1), (199, 65, 199)): (212, 255, 51, 200),
+            ((254, 1, 1), (254, 1, 254)): (254, 255, 1, 255),
+            ((254, 1, 1), (255, 0, 255)): (255, 255, 0, 255),
+            ((255, 0, 0), (0, 255, 0)): (0, 255, 255, 0),
+            ((255, 0, 0), (1, 254, 1)): (1, 255, 254, 1),
+            ((255, 0, 0), (65, 199, 65)): (65, 255, 199, 65),
+            ((255, 0, 0), (126, 127, 126)): (126, 255, 127, 126),
+            ((255, 0, 0), (127, 126, 127)): (127, 255, 126, 127),
+            ((255, 0, 0), (199, 65, 199)): (199, 255, 65, 199),
+            ((255, 0, 0), (254, 1, 254)): (254, 255, 1, 254),
+            ((255, 0, 0), (255, 0, 255)): (255, 255, 0, 255),
+        }
+
+        # chosen because they contain edge cases.
+        nums = [0, 1, 65, 126, 127, 199, 254, 255]
+        results = {}
+        for dst_r, dst_b, dst_a in zip(nums, reversed(nums), reversed(nums)):
+            for src_r, src_b, src_a in zip(nums, reversed(nums), nums):
+                with self.subTest(
+                    src_r=src_r,
+                    src_b=src_b,
+                    src_a=src_a,
+                    dest_r=dst_r,
+                    dest_b=dst_b,
+                    dest_a=dst_a,
+                ):
+                    src_surf = pygame.Surface((66, 66), pygame.SRCALPHA, 32)
+                    src_surf.fill((src_r, 255, src_b, 255))
+                    src_surf.set_alpha(src_a)
+                    dest_surf = pygame.Surface((66, 66), pygame.SRCALPHA, 32)
+                    dest_surf.fill((dst_r, 255, dst_b, dst_a))
+
+                    dest_surf.blit(src_surf, (0, 0))
+                    key = ((dst_r, dst_b, dst_a), (src_r, src_b, src_a))
+                    results[key] = dest_surf.get_at((65, 33))
+                    self.assertEqual(results[key], results_expected[key])
+
+        self.assertEqual(results, results_expected)
+
+    @unittest.skipIf(
+        "arm" in platform.machine() or "aarch64" in platform.machine(),
+        "sdl2 blitter produces different results on arm",
+    )
+    def test_src_alpha_sdl2_blitter(self):
+        """Checking that the BLEND_ALPHA_SDL2 flag works - this feature
+        only exists when using SDL2"""
+
+        results_expected = {
+            ((0, 255, 255), (0, 255, 0)): (0, 255, 255, 255),
+            ((0, 255, 255), (1, 254, 1)): (0, 253, 253, 253),
+            ((0, 255, 255), (65, 199, 65)): (16, 253, 239, 253),
+            ((0, 255, 255), (126, 127, 126)): (62, 253, 190, 253),
+            ((0, 255, 255), (127, 126, 127)): (63, 253, 189, 253),
+            ((0, 255, 255), (199, 65, 199)): (154, 253, 105, 253),
+            ((0, 255, 255), (254, 1, 254)): (252, 253, 0, 253),
+            ((0, 255, 255), (255, 0, 255)): (255, 255, 0, 255),
+            ((1, 254, 254), (0, 255, 0)): (1, 255, 254, 254),
+            ((1, 254, 254), (1, 254, 1)): (0, 253, 252, 252),
+            ((1, 254, 254), (65, 199, 65)): (16, 253, 238, 252),
+            ((1, 254, 254), (126, 127, 126)): (62, 253, 189, 252),
+            ((1, 254, 254), (127, 126, 127)): (63, 253, 189, 253),
+            ((1, 254, 254), (199, 65, 199)): (154, 253, 105, 253),
+            ((1, 254, 254), (254, 1, 254)): (252, 253, 0, 253),
+            ((1, 254, 254), (255, 0, 255)): (255, 255, 0, 255),
+            ((65, 199, 199), (0, 255, 0)): (65, 255, 199, 199),
+            ((65, 199, 199), (1, 254, 1)): (64, 253, 197, 197),
+            ((65, 199, 199), (65, 199, 65)): (64, 253, 197, 211),
+            ((65, 199, 199), (126, 127, 126)): (94, 253, 162, 225),
+            ((65, 199, 199), (127, 126, 127)): (95, 253, 161, 225),
+            ((65, 199, 199), (199, 65, 199)): (168, 253, 93, 241),
+            ((65, 199, 199), (254, 1, 254)): (252, 253, 0, 253),
+            ((65, 199, 199), (255, 0, 255)): (255, 255, 0, 255),
+            ((126, 127, 127), (0, 255, 0)): (126, 255, 127, 127),
+            ((126, 127, 127), (1, 254, 1)): (125, 253, 126, 126),
+            ((126, 127, 127), (65, 199, 65)): (109, 253, 144, 158),
+            ((126, 127, 127), (126, 127, 126)): (125, 253, 125, 188),
+            ((126, 127, 127), (127, 126, 127)): (126, 253, 125, 189),
+            ((126, 127, 127), (199, 65, 199)): (181, 253, 77, 225),
+            ((126, 127, 127), (254, 1, 254)): (252, 253, 0, 253),
+            ((126, 127, 127), (255, 0, 255)): (255, 255, 0, 255),
+            ((127, 126, 126), (0, 255, 0)): (127, 255, 126, 126),
+            ((127, 126, 126), (1, 254, 1)): (126, 253, 125, 125),
+            ((127, 126, 126), (65, 199, 65)): (110, 253, 143, 157),
+            ((127, 126, 126), (126, 127, 126)): (125, 253, 125, 188),
+            ((127, 126, 126), (127, 126, 127)): (126, 253, 125, 189),
+            ((127, 126, 126), (199, 65, 199)): (181, 253, 77, 225),
+            ((127, 126, 126), (254, 1, 254)): (252, 253, 0, 253),
+            ((127, 126, 126), (255, 0, 255)): (255, 255, 0, 255),
+            ((199, 65, 65), (0, 255, 0)): (199, 255, 65, 65),
+            ((199, 65, 65), (1, 254, 1)): (197, 253, 64, 64),
+            ((199, 65, 65), (65, 199, 65)): (163, 253, 98, 112),
+            ((199, 65, 65), (126, 127, 126)): (162, 253, 94, 157),
+            ((199, 65, 65), (127, 126, 127)): (162, 253, 94, 158),
+            ((199, 65, 65), (199, 65, 199)): (197, 253, 64, 212),
+            ((199, 65, 65), (254, 1, 254)): (252, 253, 0, 253),
+            ((199, 65, 65), (255, 0, 255)): (255, 255, 0, 255),
+            ((254, 1, 1), (0, 255, 0)): (254, 255, 1, 1),
+            ((254, 1, 1), (1, 254, 1)): (252, 253, 0, 0),
+            ((254, 1, 1), (65, 199, 65)): (204, 253, 50, 64),
+            ((254, 1, 1), (126, 127, 126)): (189, 253, 62, 125),
+            ((254, 1, 1), (127, 126, 127)): (190, 253, 62, 126),
+            ((254, 1, 1), (199, 65, 199)): (209, 253, 50, 198),
+            ((254, 1, 1), (254, 1, 254)): (252, 253, 0, 253),
+            ((254, 1, 1), (255, 0, 255)): (255, 255, 0, 255),
+            ((255, 0, 0), (0, 255, 0)): (255, 255, 0, 0),
+            ((255, 0, 0), (1, 254, 1)): (253, 253, 0, 0),
+            ((255, 0, 0), (65, 199, 65)): (205, 253, 50, 64),
+            ((255, 0, 0), (126, 127, 126)): (190, 253, 62, 125),
+            ((255, 0, 0), (127, 126, 127)): (190, 253, 62, 126),
+            ((255, 0, 0), (199, 65, 199)): (209, 253, 50, 198),
+            ((255, 0, 0), (254, 1, 254)): (252, 253, 0, 253),
+            ((255, 0, 0), (255, 0, 255)): (255, 255, 0, 255),
+        }
+
+        # chosen because they contain edge cases.
+        nums = [0, 1, 65, 126, 127, 199, 254, 255]
+        results = {}
+        for dst_r, dst_b, dst_a in zip(nums, reversed(nums), reversed(nums)):
+            for src_r, src_b, src_a in zip(nums, reversed(nums), nums):
+                with self.subTest(
+                    src_r=src_r,
+                    src_b=src_b,
+                    src_a=src_a,
+                    dest_r=dst_r,
+                    dest_b=dst_b,
+                    dest_a=dst_a,
+                ):
+                    src_surf = pygame.Surface((66, 66), pygame.SRCALPHA, 32)
+                    src_surf.fill((src_r, 255, src_b, src_a))
+                    dest_surf = pygame.Surface((66, 66), pygame.SRCALPHA, 32)
+                    dest_surf.fill((dst_r, 255, dst_b, dst_a))
+
+                    dest_surf.blit(
+                        src_surf, (0, 0), special_flags=pygame.BLEND_ALPHA_SDL2
+                    )
+                    key = ((dst_r, dst_b, dst_a), (src_r, src_b, src_a))
+                    results[key] = tuple(dest_surf.get_at((65, 33)))
+                    for i in range(4):
+                        self.assertAlmostEqual(
+                            results[key][i], results_expected[key][i], delta=4
+                        )
+
+        # print("(dest_r, dest_b, dest_a), (src_r, src_b, src_a): color")
+        # pprint(results)
+
+    def test_opaque_destination_blit_with_set_alpha(self):
+        # no set_alpha()
+        src_surf = pygame.Surface((32, 32), pygame.SRCALPHA, 32)
+        src_surf.fill((255, 255, 255, 200))
+        dest_surf = pygame.Surface((32, 32))
+        dest_surf.fill((100, 100, 100))
+
+        dest_surf.blit(src_surf, (0, 0))
+
+        no_surf_alpha_col = dest_surf.get_at((0, 0))
+
+        dest_surf.fill((100, 100, 100))
+        dest_surf.set_alpha(200)
+        dest_surf.blit(src_surf, (0, 0))
+
+        surf_alpha_col = dest_surf.get_at((0, 0))
+
+        self.assertEqual(no_surf_alpha_col, surf_alpha_col)
+
+    def todo_test_convert(self):
+        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)
+        convert_surface = SurfaceSubclass(expected_size, 0, 32)
+        depth_surface = SurfaceSubclass((31, 61), 0, 32)
+
+        pygame.display.init()
+        try:
+            surface = convert_surface.convert(depth_surface)
+
+            self.assertIsNot(surface, depth_surface)
+            self.assertIsNot(surface, convert_surface)
+            self.assertIsInstance(surface, pygame.Surface)
+            self.assertIsInstance(surface, SurfaceSubclass)
+            self.assertEqual(surface.get_size(), expected_size)
+        finally:
+            pygame.display.quit()
+
+    def test_convert_alpha(self):
+        """Ensure the surface returned by surf.convert_alpha
+        has alpha values added"""
+        pygame.display.init()
+        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()
+
+            s3 = pygame.Surface((100, 100), 0, 8)
+            s3_alpha = s3.convert_alpha()
+
+            s4 = pygame.Surface((100, 100), 0, 12)
+            s4_alpha = s4.convert_alpha()
+
+            s5 = pygame.Surface((100, 100), 0, 15)
+            s5_alpha = s5.convert_alpha()
+
+            s6 = pygame.Surface((100, 100), 0, 16)
+            s6_alpha = s6.convert_alpha()
+
+            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)
+            self.assertEqual(s5_alpha.get_alpha(), 255)
+            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)
+            self.assertEqual(s5_alpha.get_bitsize(), 32)
+            self.assertEqual(s6_alpha.get_bitsize(), 32)
+            self.assertEqual(s6_alpha.get_bitsize(), 32)
+
+            with self.assertRaises(pygame.error):
+                surface = pygame.display.set_mode()
+                pygame.display.quit()
+                surface.convert_alpha()
+
+        finally:
+            pygame.display.quit()
+
+    def test_convert_alpha__pixel_format_as_surface_subclass(self):
+        """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))
+
+            # 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)
+            self.assertEqual(surface.get_size(), expected_size)
+        finally:
+            pygame.display.quit()
+
+    def test_get_abs_offset(self):
+        pygame.display.init()
+        try:
+            parent = pygame.Surface((64, 64), SRCALPHA, 32)
+
+            # 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))
+            sub_level_4 = sub_level_3.subsurface((6, 1), (14, 14))
+            sub_level_5 = sub_level_4.subsurface((5, 6), (3, 4))
+
+            # Parent is always (0, 0)
+            self.assertEqual(parent.get_abs_offset(), (0, 0))
+            # Total offset: (0+2, 0+2) = (2, 2)
+            self.assertEqual(sub_level_1.get_abs_offset(), (2, 2))
+            # Total offset: (0+2+0, 0+2+0) = (2, 2)
+            self.assertEqual(sub_level_2.get_abs_offset(), (2, 2))
+            # Total offset: (0+2+0+3, 0+2+0+7) = (5, 9)
+            self.assertEqual(sub_level_3.get_abs_offset(), (5, 9))
+            # Total offset: (0+2+0+3+6, 0+2+0+7+1) = (11, 10)
+            self.assertEqual(sub_level_4.get_abs_offset(), (11, 10))
+            # Total offset: (0+2+0+3+6+5, 0+2+0+7+1+6) = (16, 16)
+            self.assertEqual(sub_level_5.get_abs_offset(), (16, 16))
+
+            with self.assertRaises(pygame.error):
+                surface = pygame.display.set_mode()
+                pygame.display.quit()
+                surface.get_abs_offset()
+        finally:
+            pygame.display.quit()
+
+    def test_get_abs_parent(self):
+        pygame.display.init()
+        try:
+            parent = pygame.Surface((32, 32), SRCALPHA, 32)
+
+            # 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))
+            sub_level_4 = sub_level_3.subsurface((1, 1), (8, 8))
+            sub_level_5 = sub_level_4.subsurface((2, 2), (3, 4))
+            sub_level_6 = sub_level_5.subsurface((0, 0), (2, 1))
+
+            # Can't have subsurfaces bigger than parents
+            self.assertRaises(ValueError, parent.subsurface, (5, 5), (100, 100))
+            self.assertRaises(ValueError, sub_level_3.subsurface, (0, 0), (11, 5))
+            self.assertRaises(ValueError, sub_level_6.subsurface, (0, 0), (5, 5))
+
+            # Calling get_abs_parent on parent should return itself
+            self.assertEqual(parent.get_abs_parent(), parent)
+
+            # On subclass "depth" of 1, get_abs_parent and get_parent should return the same
+            self.assertEqual(sub_level_1.get_abs_parent(), sub_level_1.get_parent())
+            self.assertEqual(sub_level_2.get_abs_parent(), parent)
+            self.assertEqual(sub_level_3.get_abs_parent(), parent)
+            self.assertEqual(sub_level_4.get_abs_parent(), parent)
+            self.assertEqual(sub_level_5.get_abs_parent(), parent)
+            self.assertEqual(
+                sub_level_6.get_abs_parent(), sub_level_6.get_parent().get_abs_parent()
+            )
+
+            with self.assertRaises(pygame.error):
+                surface = pygame.display.set_mode()
+                pygame.display.quit()
+                surface.get_abs_parent()
+        finally:
+            pygame.display.quit()
+
+    def test_get_at(self):
+        surf = pygame.Surface((2, 2), 0, 24)
+        c00 = pygame.Color(1, 2, 3)
+        c01 = pygame.Color(5, 10, 15)
+        c10 = pygame.Color(100, 50, 0)
+        c11 = pygame.Color(4, 5, 6)
+        surf.set_at((0, 0), c00)
+        surf.set_at((0, 1), c01)
+        surf.set_at((1, 0), c10)
+        surf.set_at((1, 1), c11)
+        c = surf.get_at((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)
+        for p in [(-1, 0), (0, -1), (2, 0), (0, 2)]:
+            self.assertRaises(IndexError, surf.get_at, p)
+
+    def test_get_at_mapped(self):
+        color = pygame.Color(10, 20, 30)
+        for bitsize in [8, 16, 24, 32]:
+            surf = pygame.Surface((2, 2), 0, bitsize)
+            surf.fill(color)
+            pixel = surf.get_at_mapped((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()
+        try:
+            expected_size = (11, 21)
+
+            # Check that get_bitsize returns passed depth
+            expected_depth = 32
+            surface = pygame.Surface(expected_size, pygame.SRCALPHA, expected_depth)
+            self.assertEqual(surface.get_size(), expected_size)
+            self.assertEqual(surface.get_bitsize(), expected_depth)
+
+            expected_depth = 16
+            surface = pygame.Surface(expected_size, pygame.SRCALPHA, expected_depth)
+            self.assertEqual(surface.get_size(), expected_size)
+            self.assertEqual(surface.get_bitsize(), expected_depth)
+
+            expected_depth = 15
+            surface = pygame.Surface(expected_size, 0, expected_depth)
+            self.assertEqual(surface.get_size(), expected_size)
+            self.assertEqual(surface.get_bitsize(), expected_depth)
+            # Check for invalid depths
+            expected_depth = -1
+            self.assertRaises(
+                ValueError, pygame.Surface, expected_size, 0, expected_depth
+            )
+            expected_depth = 11
+            self.assertRaises(
+                ValueError, pygame.Surface, expected_size, 0, expected_depth
+            )
+            expected_depth = 1024
+            self.assertRaises(
+                ValueError, pygame.Surface, expected_size, 0, expected_depth
+            )
+
+            with self.assertRaises(pygame.error):
+                surface = pygame.display.set_mode()
+                pygame.display.quit()
+                surface.get_bitsize()
+        finally:
+            pygame.display.quit()
+
+    def test_get_clip(self):
+        s = pygame.Surface((800, 600))
+        rectangle = s.get_clip()
+        self.assertEqual(rectangle, (0, 0, 800, 600))
+
+    def test_get_colorkey(self):
+        pygame.display.init()
+        try:
+            # if set_colorkey is not used
+            s = pygame.Surface((800, 600), 0, 32)
+            self.assertIsNone(s.get_colorkey())
+
+            # if set_colorkey is used
+            s.set_colorkey(None)
+            self.assertIsNone(s.get_colorkey())
+
+            # setting up remainder of tests...
+            r, g, b, a = 20, 40, 60, 12
+            colorkey = pygame.Color(r, g, b)
+            s.set_colorkey(colorkey)
+
+            # test for ideal case
+            self.assertEqual(s.get_colorkey(), (r, g, b, 255))
+
+            # test for if the color_key is set using pygame.RLEACCEL
+            s.set_colorkey(colorkey, pygame.RLEACCEL)
+            self.assertEqual(s.get_colorkey(), (r, g, b, 255))
+
+            # test for if the color key is not what's expected
+            s.set_colorkey(pygame.Color(r + 1, g + 1, b + 1))
+            self.assertNotEqual(s.get_colorkey(), (r, g, b, 255))
+
+            s.set_colorkey(pygame.Color(r, g, b, a))
+            # regardless of whether alpha is not 255
+            # colorkey returned from surface is always 255
+            self.assertEqual(s.get_colorkey(), (r, g, b, 255))
+        finally:
+            # test for using method after display.quit() is called...
+            s = pygame.display.set_mode((200, 200), 0, 32)
+            pygame.display.quit()
+            with self.assertRaises(pygame.error):
+                s.get_colorkey()
+
+    def test_get_height(self):
+        sizes = ((1, 1), (119, 10), (10, 119), (1, 1000), (1000, 1), (1000, 1000))
+        for width, height in sizes:
+            surf = pygame.Surface((width, height))
+            found_height = surf.get_height()
+            self.assertEqual(height, found_height)
+
+    def test_get_locked(self):
+        def blit_locked_test(surface):
+            newSurf = pygame.Surface((10, 10))
+            try:
+                newSurf.blit(surface, (0, 0))
+            except pygame.error:
+                return True
+            else:
+                return False
+
+        surf = pygame.Surface((100, 100))
+
+        self.assertIs(surf.get_locked(), blit_locked_test(surf))  # Unlocked
+        # Surface should lock
+        surf.lock()
+        self.assertIs(surf.get_locked(), blit_locked_test(surf))  # Locked
+        # Surface should unlock
+        surf.unlock()
+        self.assertIs(surf.get_locked(), blit_locked_test(surf))  # Unlocked
+
+        # Check multiple locks
+        surf = pygame.Surface((100, 100))
+        surf.lock()
+        surf.lock()
+        self.assertIs(surf.get_locked(), blit_locked_test(surf))  # Locked
+        surf.unlock()
+        self.assertIs(surf.get_locked(), blit_locked_test(surf))  # Locked
+        surf.unlock()
+        self.assertIs(surf.get_locked(), blit_locked_test(surf))  # Unlocked
+
+        # Check many locks
+        surf = pygame.Surface((100, 100))
+        for i in range(1000):
+            surf.lock()
+        self.assertIs(surf.get_locked(), blit_locked_test(surf))  # Locked
+        for i in range(1000):
+            surf.unlock()
+        self.assertFalse(surf.get_locked())  # Unlocked
+
+        # Unlocking an unlocked surface
+        surf = pygame.Surface((100, 100))
+        surf.unlock()
+        self.assertIs(surf.get_locked(), blit_locked_test(surf))  # Unlocked
+        surf.unlock()
+        self.assertIs(surf.get_locked(), blit_locked_test(surf))  # Unlocked
+
+    def test_get_locks(self):
+        # __doc__ (as of 2008-08-02) for pygame.surface.Surface.get_locks:
+
+        # Surface.get_locks(): return tuple
+        # Gets the locks for the Surface
+        #
+        # Returns the currently existing locks for the Surface.
+
+        # test on a surface that is not initially locked
+        surface = pygame.Surface((100, 100))
+        self.assertEqual(surface.get_locks(), ())
+
+        # test on the same surface after it has been locked
+        surface.lock()
+        self.assertEqual(surface.get_locks(), (surface,))
+
+        # test on the same surface after it has been unlocked
+        surface.unlock()
+        self.assertEqual(surface.get_locks(), ())
+
+        # test with PixelArray initialization: locks surface
+        pxarray = pygame.PixelArray(surface)
+        self.assertNotEqual(surface.get_locks(), ())
+
+        # closing the PixelArray releases the surface lock
+        pxarray.close()
+        self.assertEqual(surface.get_locks(), ())
+
+        # AttributeError raised when called on invalid object type (i.e. not a pygame.Surface object)
+        with self.assertRaises(AttributeError):
+            "DUMMY".get_locks()
+
+        # test multiple locks and unlocks on the same surface
+        surface.lock()
+        surface.lock()
+        surface.lock()
+        self.assertEqual(surface.get_locks(), (surface, surface, surface))
+
+        surface.unlock()
+        surface.unlock()
+        self.assertEqual(surface.get_locks(), (surface,))
+        surface.unlock()
+        self.assertEqual(surface.get_locks(), ())
+
+    def test_get_losses(self):
+        """Ensure a surface's losses can be retrieved"""
+        pygame.display.init()
+        try:
+            # Masks for different color component configurations
+            mask8 = (224, 28, 3, 0)
+            mask15 = (31744, 992, 31, 0)
+            mask16 = (63488, 2016, 31, 0)
+            mask24 = (16711680, 65280, 255, 0)
+            mask32 = (4278190080, 16711680, 65280, 255)
+
+            # Surfaces with standard depths and masks
+            display_surf = pygame.display.set_mode((100, 100))
+            surf = pygame.Surface((100, 100))
+            surf_8bit = pygame.Surface((100, 100), depth=8, masks=mask8)
+            surf_15bit = pygame.Surface((100, 100), depth=15, masks=mask15)
+            surf_16bit = pygame.Surface((100, 100), depth=16, masks=mask16)
+            surf_24bit = pygame.Surface((100, 100), depth=24, masks=mask24)
+            surf_32bit = pygame.Surface((100, 100), depth=32, masks=mask32)
+
+            # Test output is correct type, length, and value range
+            losses = surf.get_losses()
+            self.assertIsInstance(losses, tuple)
+            self.assertEqual(len(losses), 4)
+            for loss in losses:
+                self.assertIsInstance(loss, int)
+                self.assertGreaterEqual(loss, 0)
+                self.assertLessEqual(loss, 8)
+
+            # Test each surface for correct losses
+            # Display surface losses gives idea of default surface losses
+            if display_surf.get_losses() == (0, 0, 0, 8):
+                self.assertEqual(losses, (0, 0, 0, 8))
+            elif display_surf.get_losses() == (8, 8, 8, 8):
+                self.assertEqual(losses, (8, 8, 8, 8))
+
+            self.assertEqual(surf_8bit.get_losses(), (5, 5, 6, 8))
+            self.assertEqual(surf_15bit.get_losses(), (3, 3, 3, 8))
+            self.assertEqual(surf_16bit.get_losses(), (3, 2, 3, 8))
+            self.assertEqual(surf_24bit.get_losses(), (0, 0, 0, 8))
+            self.assertEqual(surf_32bit.get_losses(), (0, 0, 0, 0))
+
+            # Method should fail when display is not initialized
+            with self.assertRaises(pygame.error):
+                surface = pygame.display.set_mode((100, 100))
+                pygame.display.quit()
+                surface.get_losses()
+        finally:
+            pygame.display.quit()
+
+    def test_get_masks__rgba(self):
+        """
+        Ensure that get_mask can return RGBA mask.
+        """
+        masks = [
+            (0x0F00, 0x00F0, 0x000F, 0xF000),
+            (0x00FF0000, 0x0000FF00, 0x000000FF, 0xFF000000),
+        ]
+        depths = [16, 32]
+        for expected, depth in list(zip(masks, depths)):
+            surface = pygame.Surface((10, 10), pygame.SRCALPHA, depth)
+            self.assertEqual(expected, surface.get_masks())
+
+    def test_get_masks__rgb(self):
+        """
+        Ensure that get_mask can return RGB mask.
+        """
+        masks = [
+            (0x60, 0x1C, 0x03, 0x00),
+            (0xF00, 0x0F0, 0x00F, 0x000),
+            (0x7C00, 0x03E0, 0x001F, 0x0000),
+            (0xF800, 0x07E0, 0x001F, 0x0000),
+            (0xFF0000, 0x00FF00, 0x0000FF, 0x000000),
+            (0xFF0000, 0x00FF00, 0x0000FF, 0x000000),
+        ]
+        depths = [8, 12, 15, 16, 24, 32]
+        for expected, depth in list(zip(masks, depths)):
+            surface = pygame.Surface((10, 10), 0, depth)
+            if depth == 8:
+                expected = (0x00, 0x00, 0x00, 0x00)
+            self.assertEqual(expected, surface.get_masks())
+
+    def test_get_masks__no_surface(self):
+        """
+        Ensure that after display.quit, calling get_masks raises pygame.error.
+        """
+        with self.assertRaises(pygame.error):
+            surface = pygame.display.set_mode((10, 10))
+            pygame.display.quit()
+            surface.get_masks()
+
+    def test_get_offset(self):
+        """get_offset returns the (0,0) if surface is not a child
+        returns the position of child subsurface inside of parent
+        """
+        pygame.display.init()
+        try:
+            surf = pygame.Surface((100, 100))
+            self.assertEqual(surf.get_offset(), (0, 0))
+
+            # subsurface offset test
+            subsurf = surf.subsurface(1, 1, 10, 10)
+            self.assertEqual(subsurf.get_offset(), (1, 1))
+
+            with self.assertRaises(pygame.error):
+                surface = pygame.display.set_mode()
+                pygame.display.quit()
+                surface.get_offset()
+        finally:
+            pygame.display.quit()
+
+    def test_get_palette(self):
+        palette = [Color(i, i, i) for i in range(256)]
+        surf = pygame.Surface((2, 2), 0, 8)
+        surf.set_palette(palette)
+        palette2 = surf.get_palette()
+
+        self.assertEqual(len(palette2), len(palette))
+        for c2, c in zip(palette2, palette):
+            self.assertEqual(c2, c)
+        for c in palette2:
+            self.assertIsInstance(c, pygame.Color)
+
+    def test_get_palette_at(self):
+        # See also test_get_palette
+        surf = pygame.Surface((2, 2), 0, 8)
+        color = pygame.Color(1, 2, 3, 255)
+        surf.set_palette_at(0, color)
+        color2 = surf.get_palette_at(0)
+        self.assertIsInstance(color2, pygame.Color)
+        self.assertEqual(color2, color)
+        self.assertRaises(IndexError, surf.get_palette_at, -1)
+        self.assertRaises(IndexError, surf.get_palette_at, 256)
+
+    def test_get_pitch(self):
+        # Test get_pitch() on several surfaces of varying size/depth
+        sizes = ((2, 2), (7, 33), (33, 7), (2, 734), (734, 2), (734, 734))
+        depths = [8, 24, 32]
+        for width, height in sizes:
+            for depth in depths:
+                # Test get_pitch() on parent surface
+                surf = pygame.Surface((width, height), depth=depth)
+                buff = surf.get_buffer()
+                pitch = buff.length / surf.get_height()
+                test_pitch = surf.get_pitch()
+                self.assertEqual(pitch, test_pitch)
+                # Test get_pitch() on subsurface with same rect as parent
+                rect1 = surf.get_rect()
+                subsurf1 = surf.subsurface(rect1)
+                sub_buff1 = subsurf1.get_buffer()
+                sub_pitch1 = sub_buff1.length / subsurf1.get_height()
+                test_sub_pitch1 = subsurf1.get_pitch()
+                self.assertEqual(sub_pitch1, test_sub_pitch1)
+                # Test get_pitch on subsurface with modified rect
+                rect2 = rect1.inflate(-width / 2, -height / 2)
+                subsurf2 = surf.subsurface(rect2)
+                sub_buff2 = subsurf2.get_buffer()
+                sub_pitch2 = sub_buff2.length / float(subsurf2.get_height())
+                test_sub_pitch2 = subsurf2.get_pitch()
+                self.assertEqual(sub_pitch2, test_sub_pitch2)
+
+    def test_get_shifts(self):
+        """
+        Tests whether Surface.get_shifts returns proper
+        RGBA shifts under various conditions.
+        """
+        # __doc__ (as of 2008-08-02) for pygame.surface.Surface.get_shifts:
+        # Surface.get_shifts(): return (R, G, B, A)
+        # the bit shifts needed to convert between color and 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.
+
+        # Test for SDL2 on surfaces with various depths and alpha on/off
+        depths = [8, 24, 32]
+        alpha = 128
+        off = None
+        for bit_depth in depths:
+            surface = pygame.Surface((32, 32), depth=bit_depth)
+            surface.set_alpha(alpha)
+            r1, g1, b1, a1 = surface.get_shifts()
+            surface.set_alpha(off)
+            r2, g2, b2, a2 = surface.get_shifts()
+            self.assertEqual((r1, g1, b1, a1), (r2, g2, b2, a2))
+
+    def test_get_size(self):
+        sizes = ((1, 1), (119, 10), (1000, 1000), (1, 5000), (1221, 1), (99, 999))
+        for width, height in sizes:
+            surf = pygame.Surface((width, height))
+            found_size = surf.get_size()
+            self.assertEqual((width, height), found_size)
+
+    def test_lock(self):
+        # __doc__ (as of 2008-08-02) for pygame.surface.Surface.lock:
+
+        # Surface.lock(): return 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 Surface.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.
+        #
+
+        # Basic
+        surf = pygame.Surface((100, 100))
+        surf.lock()
+        self.assertTrue(surf.get_locked())
+
+        # Nested
+        surf = pygame.Surface((100, 100))
+        surf.lock()
+        surf.lock()
+        surf.unlock()
+        self.assertTrue(surf.get_locked())
+        surf.unlock()
+        surf.lock()
+        surf.lock()
+        self.assertTrue(surf.get_locked())
+        surf.unlock()
+        self.assertTrue(surf.get_locked())
+        surf.unlock()
+        self.assertFalse(surf.get_locked())
+
+        # Already Locked
+        surf = pygame.Surface((100, 100))
+        surf.lock()
+        surf.lock()
+        self.assertTrue(surf.get_locked())
+        surf.unlock()
+        self.assertTrue(surf.get_locked())
+        surf.unlock()
+        self.assertFalse(surf.get_locked())
+
+    def test_map_rgb(self):
+        color = Color(0, 128, 255, 64)
+        surf = pygame.Surface((5, 5), SRCALPHA, 32)
+        c = surf.map_rgb(color)
+        self.assertEqual(surf.unmap_rgb(c), color)
+
+        self.assertEqual(surf.get_at((0, 0)), (0, 0, 0, 0))
+        surf.fill(c)
+        self.assertEqual(surf.get_at((0, 0)), color)
+
+        surf.fill((0, 0, 0, 0))
+        self.assertEqual(surf.get_at((0, 0)), (0, 0, 0, 0))
+        surf.set_at((0, 0), c)
+        self.assertEqual(surf.get_at((0, 0)), color)
+
+    def test_mustlock(self):
+        # Test that subsurfaces mustlock
+        surf = pygame.Surface((1024, 1024))
+        subsurf = surf.subsurface((0, 0, 1024, 1024))
+        self.assertTrue(subsurf.mustlock())
+        self.assertFalse(surf.mustlock())
+        # Tests nested subsurfaces
+        rects = ((0, 0, 512, 512), (0, 0, 256, 256), (0, 0, 128, 128))
+        surf_stack = []
+        surf_stack.append(surf)
+        surf_stack.append(subsurf)
+        for rect in rects:
+            surf_stack.append(surf_stack[-1].subsurface(rect))
+            self.assertTrue(surf_stack[-1].mustlock())
+            self.assertTrue(surf_stack[-2].mustlock())
+
+    def test_set_alpha_none(self):
+        """surf.set_alpha(None) disables blending"""
+        s = pygame.Surface((1, 1), SRCALPHA, 32)
+        s.fill((0, 255, 0, 128))
+        s.set_alpha(None)
+        self.assertEqual(None, s.get_alpha())
+
+        s2 = pygame.Surface((1, 1), SRCALPHA, 32)
+        s2.fill((255, 0, 0, 255))
+        s2.blit(s, (0, 0))
+        self.assertEqual(s2.get_at((0, 0))[0], 0, "the red component should be 0")
+
+    def test_set_alpha_value(self):
+        """surf.set_alpha(x), where x != None, enables blending"""
+        s = pygame.Surface((1, 1), SRCALPHA, 32)
+        s.fill((0, 255, 0, 128))
+        s.set_alpha(255)
+
+        s2 = pygame.Surface((1, 1), SRCALPHA, 32)
+        s2.fill((255, 0, 0, 255))
+        s2.blit(s, (0, 0))
+        self.assertGreater(
+            s2.get_at((0, 0))[0], 0, "the red component should be above 0"
+        )
+
+    def test_palette_colorkey(self):
+        """test bug discovered by robertpfeiffer
+        https://github.com/pygame/pygame/issues/721
+        """
+        surf = pygame.image.load(example_path(os.path.join("data", "alien2.png")))
+        key = surf.get_colorkey()
+        self.assertEqual(surf.get_palette()[surf.map_rgb(key)], key)
+
+    def test_palette_colorkey_set_px(self):
+        surf = pygame.image.load(example_path(os.path.join("data", "alien2.png")))
+        key = surf.get_colorkey()
+        surf.set_at((0, 0), key)
+        self.assertEqual(surf.get_at((0, 0)), key)
+
+    def test_palette_colorkey_fill(self):
+        surf = pygame.image.load(example_path(os.path.join("data", "alien2.png")))
+        key = surf.get_colorkey()
+        surf.fill(key)
+        self.assertEqual(surf.get_at((0, 0)), key)
+
+    def test_set_palette(self):
+        palette = [pygame.Color(i, i, i) for i in range(256)]
+        palette[10] = tuple(palette[10])  # 4 element tuple
+        palette[11] = tuple(palette[11])[0:3]  # 3 element tuple
+
+        surf = pygame.Surface((2, 2), 0, 8)
+        surf.set_palette(palette)
+        for i in range(256):
+            self.assertEqual(surf.map_rgb(palette[i]), i, "palette color %i" % (i,))
+            c = palette[i]
+            surf.fill(c)
+            self.assertEqual(surf.get_at((0, 0)), c, "palette color %i" % (i,))
+        for i in range(10):
+            palette[i] = pygame.Color(255 - i, 0, 0)
+        surf.set_palette(palette[0:10])
+        for i in range(256):
+            self.assertEqual(surf.map_rgb(palette[i]), i, "palette color %i" % (i,))
+            c = palette[i]
+            surf.fill(c)
+            self.assertEqual(surf.get_at((0, 0)), c, "palette color %i" % (i,))
+        self.assertRaises(ValueError, surf.set_palette, [Color(1, 2, 3, 254)])
+        self.assertRaises(ValueError, surf.set_palette, (1, 2, 3, 254))
+
+    def test_set_palette__fail(self):
+        palette = 256 * [(10, 20, 30)]
+        surf = pygame.Surface((2, 2), 0, 32)
+        self.assertRaises(pygame.error, surf.set_palette, palette)
+
+    def test_set_palette__set_at(self):
+        surf = pygame.Surface((2, 2), depth=8)
+        palette = 256 * [(10, 20, 30)]
+        palette[1] = (50, 40, 30)
+        surf.set_palette(palette)
+
+        # calling set_at on a palettized surface should set the pixel to
+        # the closest color in the palette.
+        surf.set_at((0, 0), (60, 50, 40))
+        self.assertEqual(surf.get_at((0, 0)), (50, 40, 30, 255))
+        self.assertEqual(surf.get_at((1, 0)), (10, 20, 30, 255))
+
+    def test_set_palette_at(self):
+        surf = pygame.Surface((2, 2), 0, 8)
+        original = surf.get_palette_at(10)
+        replacement = Color(1, 1, 1, 255)
+        if replacement == original:
+            replacement = Color(2, 2, 2, 255)
+        surf.set_palette_at(10, replacement)
+        self.assertEqual(surf.get_palette_at(10), replacement)
+        next = tuple(original)
+        surf.set_palette_at(10, next)
+        self.assertEqual(surf.get_palette_at(10), next)
+        next = tuple(original)[0:3]
+        surf.set_palette_at(10, next)
+        self.assertEqual(surf.get_palette_at(10), next)
+        self.assertRaises(IndexError, surf.set_palette_at, 256, replacement)
+        self.assertRaises(IndexError, surf.set_palette_at, -1, replacement)
+
+    def test_subsurface(self):
+        # __doc__ (as of 2008-08-02) for pygame.surface.Surface.subsurface:
+
+        # Surface.subsurface(Rect): return Surface
+        # 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 the Surface.get_offset(), Surface.get_parent() to learn more
+        # about the state of a subsurface.
+        #
+
+        surf = pygame.Surface((16, 16))
+        s = surf.subsurface(0, 0, 1, 1)
+        s = surf.subsurface((0, 0, 1, 1))
+
+        # s = surf.subsurface((0,0,1,1), 1)
+        # This form is not acceptable.
+        # s = surf.subsurface(0,0,10,10, 1)
+
+        self.assertRaises(ValueError, surf.subsurface, (0, 0, 1, 1, 666))
+
+        self.assertEqual(s.get_shifts(), surf.get_shifts())
+        self.assertEqual(s.get_masks(), surf.get_masks())
+        self.assertEqual(s.get_losses(), surf.get_losses())
+
+        # Issue https://github.com/pygame/pygame/issues/2
+        surf = pygame.Surface.__new__(pygame.Surface)
+        self.assertRaises(pygame.error, surf.subsurface, (0, 0, 0, 0))
+
+    def test_unlock(self):
+        # Basic
+        surf = pygame.Surface((100, 100))
+        surf.lock()
+        surf.unlock()
+        self.assertFalse(surf.get_locked())
+
+        # Nested
+        surf = pygame.Surface((100, 100))
+        surf.lock()
+        surf.lock()
+        surf.unlock()
+        self.assertTrue(surf.get_locked())
+        surf.unlock()
+        self.assertFalse(surf.get_locked())
+
+        # Already Unlocked
+        surf = pygame.Surface((100, 100))
+        surf.unlock()
+        self.assertFalse(surf.get_locked())
+        surf.unlock()
+        self.assertFalse(surf.get_locked())
+
+        # Surface can be relocked
+        surf = pygame.Surface((100, 100))
+        surf.lock()
+        surf.unlock()
+        self.assertFalse(surf.get_locked())
+        surf.lock()
+        surf.unlock()
+        self.assertFalse(surf.get_locked())
+
+    def test_unmap_rgb(self):
+        # Special case, 8 bit-per-pixel surface (has a palette).
+        surf = pygame.Surface((2, 2), 0, 8)
+        c = (1, 1, 1)  # Unlikely to be in a default palette.
+        i = 67
+        surf.set_palette_at(i, c)
+        unmapped_c = surf.unmap_rgb(i)
+        self.assertEqual(unmapped_c, c)
+        # Confirm it is a Color instance
+        self.assertIsInstance(unmapped_c, pygame.Color)
+
+        # 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:
+            surf = pygame.Surface((2, 2), flags, bitsize)
+            unmapped_c = surf.unmap_rgb(surf.map_rgb(c))
+            surf.fill(c)
+            comparison_c = surf.get_at((0, 0))
+            self.assertEqual(
+                unmapped_c,
+                comparison_c,
+                "%s != %s, flags: %i, bitsize: %i"
+                % (unmapped_c, comparison_c, flags, bitsize),
+            )
+            # Confirm it is a Color instance
+            self.assertIsInstance(unmapped_c, pygame.Color)
+
+    def test_scroll(self):
+        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):
+    """Issue #280: Methods that return a new Surface preserve subclasses"""
+
+    def setUp(self):
+        pygame.display.init()
+
+    def tearDown(self):
+        pygame.display.quit()
+
+    def test_copy(self):
+        """Ensure method copy() preserves the surface's class
+
+        When Surface is subclassed, the inherited copy() method will return
+        instances of the subclass. Non Surface fields are uncopied, however.
+        This includes instance attributes.
+        """
+        expected_size = (32, 32)
+        ms1 = SurfaceSubclass(expected_size, SRCALPHA, 32)
+        ms2 = ms1.copy()
+
+        self.assertIsNot(ms1, ms2)
+        self.assertIsInstance(ms1, pygame.Surface)
+        self.assertIsInstance(ms2, pygame.Surface)
+        self.assertIsInstance(ms1, SurfaceSubclass)
+        self.assertIsInstance(ms2, SurfaceSubclass)
+        self.assertTrue(ms1.test_attribute)
+        self.assertRaises(AttributeError, getattr, ms2, "test_attribute")
+        self.assertEqual(ms2.get_size(), expected_size)
+
+    def test_convert(self):
+        """Ensure method convert() preserves the surface's class
+
+        When Surface is subclassed, the inherited convert() method will return
+        instances of the subclass. Non Surface fields are omitted, however.
+        This includes instance attributes.
+        """
+        expected_size = (32, 32)
+        ms1 = SurfaceSubclass(expected_size, 0, 24)
+        ms2 = ms1.convert(24)
+
+        self.assertIsNot(ms1, ms2)
+        self.assertIsInstance(ms1, pygame.Surface)
+        self.assertIsInstance(ms2, pygame.Surface)
+        self.assertIsInstance(ms1, SurfaceSubclass)
+        self.assertIsInstance(ms2, SurfaceSubclass)
+        self.assertTrue(ms1.test_attribute)
+        self.assertRaises(AttributeError, getattr, ms2, "test_attribute")
+        self.assertEqual(ms2.get_size(), expected_size)
+
+    def test_convert_alpha(self):
+        """Ensure method convert_alpha() preserves the surface's class
+
+        When Surface is subclassed, the inherited convert_alpha() method will
+        return instances of the subclass. Non Surface fields are omitted,
+        however. This includes instance attributes.
+        """
+        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(s)
+
+        self.assertIsNot(ms1, ms2)
+        self.assertIsInstance(ms1, pygame.Surface)
+        self.assertIsInstance(ms2, pygame.Surface)
+        self.assertIsInstance(ms1, SurfaceSubclass)
+        self.assertIsInstance(ms2, SurfaceSubclass)
+        self.assertTrue(ms1.test_attribute)
+        self.assertRaises(AttributeError, getattr, ms2, "test_attribute")
+        self.assertEqual(ms2.get_size(), expected_size)
+
+    def test_subsurface(self):
+        """Ensure method subsurface() preserves the surface's class
+
+        When Surface is subclassed, the inherited subsurface() method will
+        return instances of the subclass. Non Surface fields are uncopied,
+        however. This includes instance attributes.
+        """
+        expected_size = (10, 12)
+        ms1 = SurfaceSubclass((32, 32), SRCALPHA, 32)
+        ms2 = ms1.subsurface((4, 5), expected_size)
+
+        self.assertIsNot(ms1, ms2)
+        self.assertIsInstance(ms1, pygame.Surface)
+        self.assertIsInstance(ms2, pygame.Surface)
+        self.assertIsInstance(ms1, SurfaceSubclass)
+        self.assertIsInstance(ms2, SurfaceSubclass)
+        self.assertTrue(ms1.test_attribute)
+        self.assertRaises(AttributeError, getattr, ms2, "test_attribute")
+        self.assertEqual(ms2.get_size(), expected_size)
+
+
+class SurfaceGetBufferTest(unittest.TestCase):
+    # These tests requires ctypes. They are disabled if ctypes
+    # is not installed.
+    try:
+        ArrayInterface
+    except NameError:
+        __tags__ = ("ignore", "subprocess_ignore")
+
+    lilendian = pygame.get_sdl_byteorder() == pygame.LIL_ENDIAN
+
+    def _check_interface_2D(self, s):
+        s_w, s_h = s.get_size()
+        s_bytesize = s.get_bytesize()
+        s_pitch = s.get_pitch()
+        s_pixels = s._pixels_address
+
+        # check the array interface structure fields.
+        v = s.get_view("2")
+        if not IS_PYPY:
+            flags = PAI_ALIGNED | PAI_NOTSWAPPED | PAI_WRITEABLE
+            if s.get_pitch() == s_w * s_bytesize:
+                flags |= PAI_FORTRAN
+
+            inter = ArrayInterface(v)
+
+            self.assertEqual(inter.two, 2)
+            self.assertEqual(inter.nd, 2)
+            self.assertEqual(inter.typekind, "u")
+            self.assertEqual(inter.itemsize, s_bytesize)
+            self.assertEqual(inter.shape[0], s_w)
+            self.assertEqual(inter.shape[1], s_h)
+            self.assertEqual(inter.strides[0], s_bytesize)
+            self.assertEqual(inter.strides[1], s_pitch)
+            self.assertEqual(inter.flags, flags)
+            self.assertEqual(inter.data, s_pixels)
+
+    def _check_interface_3D(self, s):
+        s_w, s_h = s.get_size()
+        s_bytesize = s.get_bytesize()
+        s_pitch = s.get_pitch()
+        s_pixels = s._pixels_address
+        s_shifts = list(s.get_shifts())
+
+        # Check for RGB or BGR surface.
+        if s_shifts[0:3] == [0, 8, 16]:
+            if self.lilendian:
+                # RGB
+                offset = 0
+                step = 1
+            else:
+                # BGR
+                offset = s_bytesize - 1
+                step = -1
+        elif s_shifts[0:3] == [8, 16, 24]:
+            if self.lilendian:
+                # xRGB
+                offset = 1
+                step = 1
+            else:
+                # BGRx
+                offset = s_bytesize - 2
+                step = -1
+        elif s_shifts[0:3] == [16, 8, 0]:
+            if self.lilendian:
+                # BGR
+                offset = 2
+                step = -1
+            else:
+                # RGB
+                offset = s_bytesize - 3
+                step = 1
+        elif s_shifts[0:3] == [24, 16, 8]:
+            if self.lilendian:
+                # BGRx
+                offset = 2
+                step = -1
+            else:
+                # RGBx
+                offset = s_bytesize - 4
+                step = -1
+        else:
+            return
+
+        # check the array interface structure fields.
+        v = s.get_view("3")
+        if not IS_PYPY:
+            inter = ArrayInterface(v)
+            flags = PAI_ALIGNED | PAI_NOTSWAPPED | PAI_WRITEABLE
+            self.assertEqual(inter.two, 2)
+            self.assertEqual(inter.nd, 3)
+            self.assertEqual(inter.typekind, "u")
+            self.assertEqual(inter.itemsize, 1)
+            self.assertEqual(inter.shape[0], s_w)
+            self.assertEqual(inter.shape[1], s_h)
+            self.assertEqual(inter.shape[2], 3)
+            self.assertEqual(inter.strides[0], s_bytesize)
+            self.assertEqual(inter.strides[1], s_pitch)
+            self.assertEqual(inter.strides[2], step)
+            self.assertEqual(inter.flags, flags)
+            self.assertEqual(inter.data, s_pixels + offset)
+
+    def _check_interface_rgba(self, s, plane):
+        s_w, s_h = s.get_size()
+        s_bytesize = s.get_bytesize()
+        s_pitch = s.get_pitch()
+        s_pixels = s._pixels_address
+        s_shifts = s.get_shifts()
+        s_masks = s.get_masks()
+
+        # Find the color plane position within the pixel.
+        if not s_masks[plane]:
+            return
+        alpha_shift = s_shifts[plane]
+        offset = alpha_shift // 8
+        if not self.lilendian:
+            offset = s_bytesize - offset - 1
+
+        # check the array interface structure fields.
+        v = s.get_view("rgba"[plane])
+        if not IS_PYPY:
+            inter = ArrayInterface(v)
+            flags = PAI_ALIGNED | PAI_NOTSWAPPED | PAI_WRITEABLE
+            self.assertEqual(inter.two, 2)
+            self.assertEqual(inter.nd, 2)
+            self.assertEqual(inter.typekind, "u")
+            self.assertEqual(inter.itemsize, 1)
+            self.assertEqual(inter.shape[0], s_w)
+            self.assertEqual(inter.shape[1], s_h)
+            self.assertEqual(inter.strides[0], s_bytesize)
+            self.assertEqual(inter.strides[1], s_pitch)
+            self.assertEqual(inter.flags, flags)
+            self.assertEqual(inter.data, s_pixels + offset)
+
+    def test_array_interface(self):
+        self._check_interface_2D(pygame.Surface((5, 7), 0, 8))
+        self._check_interface_2D(pygame.Surface((5, 7), 0, 16))
+        self._check_interface_2D(pygame.Surface((5, 7), pygame.SRCALPHA, 16))
+        self._check_interface_3D(pygame.Surface((5, 7), 0, 24))
+        self._check_interface_3D(pygame.Surface((8, 4), 0, 24))  # No gaps
+        self._check_interface_2D(pygame.Surface((5, 7), 0, 32))
+        self._check_interface_3D(pygame.Surface((5, 7), 0, 32))
+        self._check_interface_2D(pygame.Surface((5, 7), pygame.SRCALPHA, 32))
+        self._check_interface_3D(pygame.Surface((5, 7), pygame.SRCALPHA, 32))
+
+    def test_array_interface_masks(self):
+        """Test non-default color byte orders on 3D views"""
+
+        sz = (5, 7)
+        # Reversed RGB byte order
+        s = pygame.Surface(sz, 0, 32)
+        s_masks = list(s.get_masks())
+        masks = [0xFF, 0xFF00, 0xFF0000]
+        if s_masks[0:3] == masks or s_masks[0:3] == masks[::-1]:
+            masks = s_masks[2::-1] + s_masks[3:4]
+            self._check_interface_3D(pygame.Surface(sz, 0, 32, masks))
+        s = pygame.Surface(sz, 0, 24)
+        s_masks = list(s.get_masks())
+        masks = [0xFF, 0xFF00, 0xFF0000]
+        if s_masks[0:3] == masks or s_masks[0:3] == masks[::-1]:
+            masks = s_masks[2::-1] + s_masks[3:4]
+            self._check_interface_3D(pygame.Surface(sz, 0, 24, masks))
+
+        masks = [0xFF00, 0xFF0000, 0xFF000000, 0]
+        self._check_interface_3D(pygame.Surface(sz, 0, 32, masks))
+
+    def test_array_interface_alpha(self):
+        for shifts in [[0, 8, 16, 24], [8, 16, 24, 0], [24, 16, 8, 0], [16, 8, 0, 24]]:
+            masks = [0xFF << s for s in shifts]
+            s = pygame.Surface((4, 2), pygame.SRCALPHA, 32, masks)
+            self._check_interface_rgba(s, 3)
+
+    def test_array_interface_rgb(self):
+        for shifts in [[0, 8, 16, 24], [8, 16, 24, 0], [24, 16, 8, 0], [16, 8, 0, 24]]:
+            masks = [0xFF << s for s in shifts]
+            masks[3] = 0
+            for plane in range(3):
+                s = pygame.Surface((4, 2), 0, 24)
+                self._check_interface_rgba(s, plane)
+                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
+
+        Importer = buftools.Importer
+        s = pygame.Surface((10, 6), 0, 32)
+        a = s.get_buffer()
+        b = Importer(a, buftools.PyBUF_SIMPLE)
+        self.assertEqual(b.ndim, 0)
+        self.assertTrue(b.format is None)
+        self.assertEqual(b.len, a.length)
+        self.assertEqual(b.itemsize, 1)
+        self.assertTrue(b.shape is None)
+        self.assertTrue(b.strides is None)
+        self.assertTrue(b.suboffsets is None)
+        self.assertFalse(b.readonly)
+        self.assertEqual(b.buf, s._pixels_address)
+        b = Importer(a, buftools.PyBUF_WRITABLE)
+        self.assertEqual(b.ndim, 0)
+        self.assertTrue(b.format is None)
+        self.assertFalse(b.readonly)
+        b = Importer(a, buftools.PyBUF_FORMAT)
+        self.assertEqual(b.ndim, 0)
+        self.assertEqual(b.format, "B")
+        b = Importer(a, buftools.PyBUF_ND)
+        self.assertEqual(b.ndim, 1)
+        self.assertTrue(b.format is None)
+        self.assertEqual(b.len, a.length)
+        self.assertEqual(b.itemsize, 1)
+        self.assertEqual(b.shape, (a.length,))
+        self.assertTrue(b.strides is None)
+        self.assertTrue(b.suboffsets is None)
+        self.assertFalse(b.readonly)
+        self.assertEqual(b.buf, s._pixels_address)
+        b = Importer(a, buftools.PyBUF_STRIDES)
+        self.assertEqual(b.ndim, 1)
+        self.assertTrue(b.format is None)
+        self.assertEqual(b.strides, (1,))
+        s2 = s.subsurface((1, 1, 7, 4))  # Not contiguous
+        a = s2.get_buffer()
+        b = Importer(a, buftools.PyBUF_SIMPLE)
+        self.assertEqual(b.ndim, 0)
+        self.assertTrue(b.format is None)
+        self.assertEqual(b.len, a.length)
+        self.assertEqual(b.itemsize, 1)
+        self.assertTrue(b.shape is None)
+        self.assertTrue(b.strides is None)
+        self.assertTrue(b.suboffsets is None)
+        self.assertFalse(b.readonly)
+        self.assertEqual(b.buf, s2._pixels_address)
+        b = Importer(a, buftools.PyBUF_C_CONTIGUOUS)
+        self.assertEqual(b.ndim, 1)
+        self.assertEqual(b.strides, (1,))
+        b = Importer(a, buftools.PyBUF_F_CONTIGUOUS)
+        self.assertEqual(b.ndim, 1)
+        self.assertEqual(b.strides, (1,))
+        b = Importer(a, buftools.PyBUF_ANY_CONTIGUOUS)
+        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.
+        from pygame.tests.test_utils import buftools
+
+        Importer = buftools.Importer
+        s = pygame.Surface((10, 6), 0, 32)
+        a = s.get_view("0")
+        b = Importer(a, buftools.PyBUF_SIMPLE)
+        self.assertEqual(b.ndim, 0)
+        self.assertTrue(b.format is None)
+        self.assertEqual(b.len, a.length)
+        self.assertEqual(b.itemsize, 1)
+        self.assertTrue(b.shape is None)
+        self.assertTrue(b.strides is None)
+        self.assertTrue(b.suboffsets is None)
+        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
+
+        Importer = buftools.Importer
+        s = pygame.Surface((10, 6), 0, 32)
+        a = s.get_view("1")
+        b = Importer(a, buftools.PyBUF_SIMPLE)
+        self.assertEqual(b.ndim, 0)
+        self.assertTrue(b.format is None)
+        self.assertEqual(b.len, a.length)
+        self.assertEqual(b.itemsize, s.get_bytesize())
+        self.assertTrue(b.shape is None)
+        self.assertTrue(b.strides is None)
+        self.assertTrue(b.suboffsets is None)
+        self.assertFalse(b.readonly)
+        self.assertEqual(b.buf, s._pixels_address)
+        b = Importer(a, buftools.PyBUF_WRITABLE)
+        self.assertEqual(b.ndim, 0)
+        self.assertTrue(b.format is None)
+        self.assertFalse(b.readonly)
+        b = Importer(a, buftools.PyBUF_FORMAT)
+        self.assertEqual(b.ndim, 0)
+        self.assertEqual(b.format, "=I")
+        b = Importer(a, buftools.PyBUF_ND)
+        self.assertEqual(b.ndim, 1)
+        self.assertTrue(b.format is None)
+        self.assertEqual(b.len, a.length)
+        self.assertEqual(b.itemsize, s.get_bytesize())
+        self.assertEqual(b.shape, (s.get_width() * s.get_height(),))
+        self.assertTrue(b.strides is None)
+        self.assertTrue(b.suboffsets is None)
+        self.assertFalse(b.readonly)
+        self.assertEqual(b.buf, s._pixels_address)
+        b = Importer(a, buftools.PyBUF_STRIDES)
+        self.assertEqual(b.ndim, 1)
+        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
+        # 1D surface buffer code, so only need to confirm a success.
+        b = Importer(a, buftools.PyBUF_SIMPLE)
+        self.assertEqual(b.ndim, 0)
+        self.assertTrue(b.format is None)
+        self.assertEqual(b.len, a.length)
+        self.assertEqual(b.itemsize, s.get_bytesize())
+        self.assertTrue(b.shape is None)
+        self.assertTrue(b.strides is None)
+        self.assertTrue(b.suboffsets is None)
+        self.assertFalse(b.readonly)
+        self.assertEqual(b.buf, s._pixels_address)
+        # Uniquely 2D
+        b = Importer(a, buftools.PyBUF_STRIDES)
+        self.assertEqual(b.ndim, 2)
+        self.assertTrue(b.format is None)
+        self.assertEqual(b.len, a.length)
+        self.assertEqual(b.itemsize, s.get_bytesize())
+        self.assertEqual(b.shape, s.get_size())
+        self.assertEqual(b.strides, (s.get_bytesize(), s.get_pitch()))
+        self.assertTrue(b.suboffsets is None)
+        self.assertFalse(b.readonly)
+        self.assertEqual(b.buf, s._pixels_address)
+        b = Importer(a, buftools.PyBUF_RECORDS_RO)
+        self.assertEqual(b.ndim, 2)
+        self.assertEqual(b.format, "=I")
+        self.assertEqual(b.strides, (s.get_bytesize(), s.get_pitch()))
+        b = Importer(a, buftools.PyBUF_RECORDS)
+        self.assertEqual(b.ndim, 2)
+        self.assertEqual(b.format, "=I")
+        self.assertEqual(b.strides, (s.get_bytesize(), s.get_pitch()))
+        b = Importer(a, buftools.PyBUF_F_CONTIGUOUS)
+        self.assertEqual(b.ndim, 2)
+        self.assertEqual(b.format, None)
+        self.assertEqual(b.strides, (s.get_bytesize(), s.get_pitch()))
+        b = Importer(a, buftools.PyBUF_ANY_CONTIGUOUS)
+        self.assertEqual(b.ndim, 2)
+        self.assertEqual(b.format, None)
+        self.assertEqual(b.strides, (s.get_bytesize(), s.get_pitch()))
+        self.assertRaises(BufferError, Importer, a, buftools.PyBUF_ND)
+        self.assertRaises(BufferError, Importer, a, buftools.PyBUF_C_CONTIGUOUS)
+        s2 = s.subsurface((1, 1, 7, 4))  # Not contiguous
+        a = s2.get_view("2")
+        b = Importer(a, buftools.PyBUF_STRIDES)
+        self.assertEqual(b.ndim, 2)
+        self.assertTrue(b.format is None)
+        self.assertEqual(b.len, a.length)
+        self.assertEqual(b.itemsize, s2.get_bytesize())
+        self.assertEqual(b.shape, s2.get_size())
+        self.assertEqual(b.strides, (s2.get_bytesize(), s.get_pitch()))
+        self.assertTrue(b.suboffsets is None)
+        self.assertFalse(b.readonly)
+        self.assertEqual(b.buf, s2._pixels_address)
+        b = Importer(a, buftools.PyBUF_RECORDS)
+        self.assertEqual(b.ndim, 2)
+        self.assertEqual(b.format, "=I")
+        self.assertRaises(BufferError, Importer, a, buftools.PyBUF_SIMPLE)
+        self.assertRaises(BufferError, Importer, a, buftools.PyBUF_FORMAT)
+        self.assertRaises(BufferError, Importer, a, buftools.PyBUF_WRITABLE)
+        self.assertRaises(BufferError, Importer, a, buftools.PyBUF_ND)
+        self.assertRaises(BufferError, Importer, a, buftools.PyBUF_C_CONTIGUOUS)
+        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
+
+        Importer = buftools.Importer
+        s = pygame.Surface((12, 6), 0, 24)
+        rmask, gmask, bmask, amask = s.get_masks()
+        if self.lilendian:
+            if rmask == 0x0000FF:
+                color_step = 1
+                addr_offset = 0
+            else:
+                color_step = -1
+                addr_offset = 2
+        else:
+            if rmask == 0xFF0000:
+                color_step = 1
+                addr_offset = 0
+            else:
+                color_step = -1
+                addr_offset = 2
+        a = s.get_view("3")
+        b = Importer(a, buftools.PyBUF_STRIDES)
+        w, h = s.get_size()
+        shape = w, h, 3
+        strides = 3, s.get_pitch(), color_step
+        self.assertEqual(b.ndim, 3)
+        self.assertTrue(b.format is None)
+        self.assertEqual(b.len, a.length)
+        self.assertEqual(b.itemsize, 1)
+        self.assertEqual(b.shape, shape)
+        self.assertEqual(b.strides, strides)
+        self.assertTrue(b.suboffsets is None)
+        self.assertFalse(b.readonly)
+        self.assertEqual(b.buf, s._pixels_address + addr_offset)
+        b = Importer(a, buftools.PyBUF_RECORDS_RO)
+        self.assertEqual(b.ndim, 3)
+        self.assertEqual(b.format, "B")
+        self.assertEqual(b.strides, strides)
+        b = Importer(a, buftools.PyBUF_RECORDS)
+        self.assertEqual(b.ndim, 3)
+        self.assertEqual(b.format, "B")
+        self.assertEqual(b.strides, strides)
+        self.assertRaises(BufferError, Importer, a, buftools.PyBUF_SIMPLE)
+        self.assertRaises(BufferError, Importer, a, buftools.PyBUF_FORMAT)
+        self.assertRaises(BufferError, Importer, a, buftools.PyBUF_WRITABLE)
+        self.assertRaises(BufferError, Importer, a, buftools.PyBUF_ND)
+        self.assertRaises(BufferError, Importer, a, buftools.PyBUF_C_CONTIGUOUS)
+        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.
+        from pygame.tests.test_utils import buftools
+
+        Importer = buftools.Importer
+        s = pygame.Surface((12, 6), 0, 24)
+        rmask, gmask, bmask, amask = s.get_masks()
+        if self.lilendian:
+            if rmask == 0x0000FF:
+                addr_offset = 0
+            else:
+                addr_offset = 2
+        else:
+            if rmask == 0xFF0000:
+                addr_offset = 0
+            else:
+                addr_offset = 2
+        a = s.get_view("R")
+        b = Importer(a, buftools.PyBUF_STRIDES)
+        w, h = s.get_size()
+        shape = w, h
+        strides = s.get_bytesize(), s.get_pitch()
+        self.assertEqual(b.ndim, 2)
+        self.assertTrue(b.format is None)
+        self.assertEqual(b.len, a.length)
+        self.assertEqual(b.itemsize, 1)
+        self.assertEqual(b.shape, shape)
+        self.assertEqual(b.strides, strides)
+        self.assertTrue(b.suboffsets is None)
+        self.assertFalse(b.readonly)
+        self.assertEqual(b.buf, s._pixels_address + addr_offset)
+        b = Importer(a, buftools.PyBUF_RECORDS_RO)
+        self.assertEqual(b.ndim, 2)
+        self.assertEqual(b.format, "B")
+        self.assertEqual(b.strides, strides)
+        b = Importer(a, buftools.PyBUF_RECORDS)
+        self.assertEqual(b.ndim, 2)
+        self.assertEqual(b.format, "B")
+        self.assertEqual(b.strides, strides)
+        self.assertRaises(BufferError, Importer, a, buftools.PyBUF_SIMPLE)
+        self.assertRaises(BufferError, Importer, a, buftools.PyBUF_FORMAT)
+        self.assertRaises(BufferError, Importer, a, buftools.PyBUF_WRITABLE)
+        self.assertRaises(BufferError, Importer, a, buftools.PyBUF_ND)
+        self.assertRaises(BufferError, Importer, a, buftools.PyBUF_C_CONTIGUOUS)
+        self.assertRaises(BufferError, Importer, a, buftools.PyBUF_F_CONTIGUOUS)
+        self.assertRaises(BufferError, Importer, a, buftools.PyBUF_ANY_CONTIGUOUS)
+
+
+class SurfaceBlendTest(unittest.TestCase):
+    def setUp(self):
+        # Needed for 8 bits-per-pixel color palette surface tests.
+        pygame.display.init()
+
+    def tearDown(self):
+        pygame.display.quit()
+
+    _test_palette = [
+        (0, 0, 0, 255),
+        (10, 30, 60, 0),
+        (25, 75, 100, 128),
+        (200, 150, 100, 200),
+        (0, 100, 200, 255),
+    ]
+    surf_size = (10, 12)
+    _test_points = [
+        ((0, 0), 1),
+        ((4, 5), 1),
+        ((9, 0), 2),
+        ((5, 5), 2),
+        ((0, 11), 3),
+        ((4, 6), 3),
+        ((9, 11), 4),
+        ((5, 6), 4),
+    ]
+
+    def _make_surface(self, bitsize, srcalpha=False, palette=None):
+        if palette is None:
+            palette = self._test_palette
+        flags = 0
+        if srcalpha:
+            flags |= SRCALPHA
+        surf = pygame.Surface(self.surf_size, flags, bitsize)
+        if bitsize == 8:
+            surf.set_palette([c[:3] for c in palette])
+        return surf
+
+    def _fill_surface(self, surf, palette=None):
+        if palette is None:
+            palette = self._test_palette
+        surf.fill(palette[1], (0, 0, 5, 6))
+        surf.fill(palette[2], (5, 0, 5, 6))
+        surf.fill(palette[3], (0, 6, 5, 6))
+        surf.fill(palette[4], (5, 6, 5, 6))
+
+    def _make_src_surface(self, bitsize, srcalpha=False, palette=None):
+        surf = self._make_surface(bitsize, srcalpha, palette)
+        self._fill_surface(surf, palette)
+        return surf
+
+    def _assert_surface(self, surf, palette=None, msg=""):
+        if palette is None:
+            palette = self._test_palette
+        if surf.get_bitsize() == 16:
+            palette = [surf.unmap_rgb(surf.map_rgb(c)) for c in palette]
+        for posn, i in self._test_points:
+            self.assertEqual(
+                surf.get_at(posn),
+                palette[i],
+                "%s != %s: flags: %i, bpp: %i, posn: %s%s"
+                % (
+                    surf.get_at(posn),
+                    palette[i],
+                    surf.get_flags(),
+                    surf.get_bitsize(),
+                    posn,
+                    msg,
+                ),
+            )
+
+    def test_blit_blend(self):
+        sources = [
+            self._make_src_surface(8),
+            self._make_src_surface(16),
+            self._make_src_surface(16, srcalpha=True),
+            self._make_src_surface(24),
+            self._make_src_surface(32),
+            self._make_src_surface(32, srcalpha=True),
+        ]
+        destinations = [
+            self._make_surface(8),
+            self._make_surface(16),
+            self._make_surface(16, srcalpha=True),
+            self._make_surface(24),
+            self._make_surface(32),
+            self._make_surface(32, srcalpha=True),
+        ]
+        blend = [
+            ("BLEND_ADD", (0, 25, 100, 255), lambda a, b: min(a + b, 255)),
+            ("BLEND_SUB", (100, 25, 0, 100), lambda a, b: max(a - b, 0)),
+            ("BLEND_MULT", (100, 200, 0, 0), lambda a, b: ((a * b) + 255) >> 8),
+            ("BLEND_MIN", (255, 0, 0, 255), min),
+            ("BLEND_MAX", (0, 255, 0, 255), max),
+        ]
+
+        for src in sources:
+            src_palette = [src.unmap_rgb(src.map_rgb(c)) for c in self._test_palette]
+            for dst in destinations:
+                for blend_name, dst_color, op in blend:
+                    dc = dst.unmap_rgb(dst.map_rgb(dst_color))
+                    p = []
+                    for sc in src_palette:
+                        c = [op(dc[i], sc[i]) for i in range(3)]
+                        if dst.get_masks()[3]:
+                            c.append(dc[3])
+                        else:
+                            c.append(255)
+                        c = dst.unmap_rgb(dst.map_rgb(c))
+                        p.append(c)
+                    dst.fill(dst_color)
+                    dst.blit(src, (0, 0), special_flags=getattr(pygame, blend_name))
+                    self._assert_surface(
+                        dst,
+                        p,
+                        (
+                            ", op: %s, src bpp: %i"
+                            ", src flags: %i"
+                            % (blend_name, src.get_bitsize(), src.get_flags())
+                        ),
+                    )
+
+        src = self._make_src_surface(32)
+        masks = src.get_masks()
+        dst = pygame.Surface(
+            src.get_size(), 0, 32, [masks[2], masks[1], masks[0], masks[3]]
+        )
+        for blend_name, dst_color, op in blend:
+            p = []
+            for src_color in self._test_palette:
+                c = [op(dst_color[i], src_color[i]) for i in range(3)]
+                c.append(255)
+                p.append(tuple(c))
+            dst.fill(dst_color)
+            dst.blit(src, (0, 0), special_flags=getattr(pygame, blend_name))
+            self._assert_surface(dst, p, f", {blend_name}")
+
+        # Blend blits are special cased for 32 to 32 bit surfaces.
+        #
+        # Confirm that it works when the rgb bytes are not the
+        # least significant bytes.
+        pat = self._make_src_surface(32)
+        masks = pat.get_masks()
+        if min(masks) == 0xFF000000:
+            masks = [m >> 8 for m in masks]
+        else:
+            masks = [m << 8 for m in masks]
+        src = pygame.Surface(pat.get_size(), 0, 32, masks)
+        self._fill_surface(src)
+        dst = pygame.Surface(src.get_size(), 0, 32, masks)
+        for blend_name, dst_color, op in blend:
+            p = []
+            for src_color in self._test_palette:
+                c = [op(dst_color[i], src_color[i]) for i in range(3)]
+                c.append(255)
+                p.append(tuple(c))
+            dst.fill(dst_color)
+            dst.blit(src, (0, 0), special_flags=getattr(pygame, blend_name))
+            self._assert_surface(dst, p, f", {blend_name}")
+
+    def test_blit_blend_rgba(self):
+        sources = [
+            self._make_src_surface(8),
+            self._make_src_surface(16),
+            self._make_src_surface(16, srcalpha=True),
+            self._make_src_surface(24),
+            self._make_src_surface(32),
+            self._make_src_surface(32, srcalpha=True),
+        ]
+        destinations = [
+            self._make_surface(8),
+            self._make_surface(16),
+            self._make_surface(16, srcalpha=True),
+            self._make_surface(24),
+            self._make_surface(32),
+            self._make_surface(32, srcalpha=True),
+        ]
+        blend = [
+            ("BLEND_RGBA_ADD", (0, 25, 100, 255), lambda a, b: min(a + b, 255)),
+            ("BLEND_RGBA_SUB", (0, 25, 100, 255), lambda a, b: max(a - b, 0)),
+            ("BLEND_RGBA_MULT", (0, 7, 100, 255), lambda a, b: ((a * b) + 255) >> 8),
+            ("BLEND_RGBA_MIN", (0, 255, 0, 255), min),
+            ("BLEND_RGBA_MAX", (0, 255, 0, 255), max),
+        ]
+
+        for src in sources:
+            src_palette = [src.unmap_rgb(src.map_rgb(c)) for c in self._test_palette]
+            for dst in destinations:
+                for blend_name, dst_color, op in blend:
+                    dc = dst.unmap_rgb(dst.map_rgb(dst_color))
+                    p = []
+                    for sc in src_palette:
+                        c = [op(dc[i], sc[i]) for i in range(4)]
+                        if not dst.get_masks()[3]:
+                            c[3] = 255
+                        c = dst.unmap_rgb(dst.map_rgb(c))
+                        p.append(c)
+                    dst.fill(dst_color)
+                    dst.blit(src, (0, 0), special_flags=getattr(pygame, blend_name))
+                    self._assert_surface(
+                        dst,
+                        p,
+                        (
+                            ", op: %s, src bpp: %i"
+                            ", src flags: %i"
+                            % (blend_name, src.get_bitsize(), src.get_flags())
+                        ),
+                    )
+
+        # Blend blits are special cased for 32 to 32 bit surfaces
+        # with per-pixel alpha.
+        #
+        # Confirm the general case is used instead when the formats differ.
+        src = self._make_src_surface(32, srcalpha=True)
+        masks = src.get_masks()
+        dst = pygame.Surface(
+            src.get_size(), SRCALPHA, 32, (masks[2], masks[1], masks[0], masks[3])
+        )
+        for blend_name, dst_color, op in blend:
+            p = [
+                tuple(op(dst_color[i], src_color[i]) for i in range(4))
+                for src_color in self._test_palette
+            ]
+            dst.fill(dst_color)
+            dst.blit(src, (0, 0), special_flags=getattr(pygame, blend_name))
+            self._assert_surface(dst, p, f", {blend_name}")
+
+        # Confirm this special case handles subsurfaces.
+        src = pygame.Surface((8, 10), SRCALPHA, 32)
+        dst = pygame.Surface((8, 10), SRCALPHA, 32)
+        tst = pygame.Surface((8, 10), SRCALPHA, 32)
+        src.fill((1, 2, 3, 4))
+        dst.fill((40, 30, 20, 10))
+        subsrc = src.subsurface((2, 3, 4, 4))
+        subdst = dst.subsurface((2, 3, 4, 4))
+        subdst.blit(subsrc, (0, 0), special_flags=BLEND_RGBA_ADD)
+        tst.fill((40, 30, 20, 10))
+        tst.fill((41, 32, 23, 14), (2, 3, 4, 4))
+        for x in range(8):
+            for y in range(10):
+                self.assertEqual(
+                    dst.get_at((x, y)),
+                    tst.get_at((x, y)),
+                    "%s != %s at (%i, %i)"
+                    % (dst.get_at((x, y)), tst.get_at((x, y)), x, y),
+                )
+
+    def test_blit_blend_premultiplied(self):
+        def test_premul_surf(
+            src_col,
+            dst_col,
+            src_size=(16, 16),
+            dst_size=(16, 16),
+            src_bit_depth=32,
+            dst_bit_depth=32,
+            src_has_alpha=True,
+            dst_has_alpha=True,
+        ):
+            if src_bit_depth == 8:
+                src = pygame.Surface(src_size, 0, src_bit_depth)
+                palette = [src_col, dst_col]
+                src.set_palette(palette)
+                src.fill(palette[0])
+            elif src_has_alpha:
+                src = pygame.Surface(src_size, SRCALPHA, src_bit_depth)
+                src.fill(src_col)
+            else:
+                src = pygame.Surface(src_size, 0, src_bit_depth)
+                src.fill(src_col)
+
+            if dst_bit_depth == 8:
+                dst = pygame.Surface(dst_size, 0, dst_bit_depth)
+                palette = [src_col, dst_col]
+                dst.set_palette(palette)
+                dst.fill(palette[1])
+            elif dst_has_alpha:
+                dst = pygame.Surface(dst_size, SRCALPHA, dst_bit_depth)
+                dst.fill(dst_col)
+            else:
+                dst = pygame.Surface(dst_size, 0, dst_bit_depth)
+                dst.fill(dst_col)
+
+            dst.blit(src, (0, 0), special_flags=BLEND_PREMULTIPLIED)
+
+            actual_col = dst.get_at(
+                (int(float(src_size[0] / 2.0)), int(float(src_size[0] / 2.0)))
+            )
+
+            # This is the blend pre-multiplied formula
+            if src_col.a == 0:
+                expected_col = dst_col
+            elif src_col.a == 255:
+                expected_col = src_col
+            else:
+                # sC + dC - (((dC + 1) * sA >> 8)
+                expected_col = pygame.Color(
+                    (src_col.r + dst_col.r - ((dst_col.r + 1) * src_col.a >> 8)),
+                    (src_col.g + dst_col.g - ((dst_col.g + 1) * src_col.a >> 8)),
+                    (src_col.b + dst_col.b - ((dst_col.b + 1) * src_col.a >> 8)),
+                    (src_col.a + dst_col.a - ((dst_col.a + 1) * src_col.a >> 8)),
+                )
+            if not dst_has_alpha:
+                expected_col.a = 255
+
+            return (expected_col, actual_col)
+
+        # # Colour Tests
+        self.assertEqual(
+            *test_premul_surf(pygame.Color(40, 20, 0, 51), pygame.Color(40, 20, 0, 51))
+        )
+
+        self.assertEqual(
+            *test_premul_surf(pygame.Color(0, 0, 0, 0), pygame.Color(40, 20, 0, 51))
+        )
+
+        self.assertEqual(
+            *test_premul_surf(pygame.Color(40, 20, 0, 51), pygame.Color(0, 0, 0, 0))
+        )
+
+        self.assertEqual(
+            *test_premul_surf(pygame.Color(0, 0, 0, 0), pygame.Color(0, 0, 0, 0))
+        )
+
+        self.assertEqual(
+            *test_premul_surf(pygame.Color(2, 2, 2, 2), pygame.Color(40, 20, 0, 51))
+        )
+
+        self.assertEqual(
+            *test_premul_surf(pygame.Color(40, 20, 0, 51), pygame.Color(2, 2, 2, 2))
+        )
+
+        self.assertEqual(
+            *test_premul_surf(pygame.Color(2, 2, 2, 2), pygame.Color(2, 2, 2, 2))
+        )
+
+        self.assertEqual(
+            *test_premul_surf(pygame.Color(9, 9, 9, 9), pygame.Color(40, 20, 0, 51))
+        )
+
+        self.assertEqual(
+            *test_premul_surf(pygame.Color(40, 20, 0, 51), pygame.Color(9, 9, 9, 9))
+        )
+
+        self.assertEqual(
+            *test_premul_surf(pygame.Color(9, 9, 9, 9), pygame.Color(9, 9, 9, 9))
+        )
+
+        self.assertEqual(
+            *test_premul_surf(
+                pygame.Color(127, 127, 127, 127), pygame.Color(40, 20, 0, 51)
+            )
+        )
+
+        self.assertEqual(
+            *test_premul_surf(
+                pygame.Color(40, 20, 0, 51), pygame.Color(127, 127, 127, 127)
+            )
+        )
+
+        self.assertEqual(
+            *test_premul_surf(
+                pygame.Color(127, 127, 127, 127), pygame.Color(127, 127, 127, 127)
+            )
+        )
+
+        self.assertEqual(
+            *test_premul_surf(
+                pygame.Color(200, 200, 200, 200), pygame.Color(40, 20, 0, 51)
+            )
+        )
+
+        self.assertEqual(
+            *test_premul_surf(
+                pygame.Color(40, 20, 0, 51), pygame.Color(200, 200, 200, 200)
+            )
+        )
+
+        self.assertEqual(
+            *test_premul_surf(
+                pygame.Color(200, 200, 200, 200), pygame.Color(200, 200, 200, 200)
+            )
+        )
+
+        self.assertEqual(
+            *test_premul_surf(
+                pygame.Color(255, 255, 255, 255), pygame.Color(40, 20, 0, 51)
+            )
+        )
+
+        self.assertEqual(
+            *test_premul_surf(
+                pygame.Color(40, 20, 0, 51), pygame.Color(255, 255, 255, 255)
+            )
+        )
+
+        self.assertEqual(
+            *test_premul_surf(
+                pygame.Color(255, 255, 255, 255), pygame.Color(255, 255, 255, 255)
+            )
+        )
+
+        # Surface format tests
+        self.assertRaises(
+            IndexError,
+            test_premul_surf,
+            pygame.Color(255, 255, 255, 255),
+            pygame.Color(255, 255, 255, 255),
+            src_size=(0, 0),
+            dst_size=(0, 0),
+        )
+
+        self.assertEqual(
+            *test_premul_surf(
+                pygame.Color(40, 20, 0, 51),
+                pygame.Color(30, 20, 0, 51),
+                src_size=(4, 4),
+                dst_size=(9, 9),
+            )
+        )
+
+        self.assertEqual(
+            *test_premul_surf(
+                pygame.Color(30, 20, 0, 51),
+                pygame.Color(40, 20, 0, 51),
+                src_size=(17, 67),
+                dst_size=(69, 69),
+            )
+        )
+
+        self.assertEqual(
+            *test_premul_surf(
+                pygame.Color(30, 20, 0, 255),
+                pygame.Color(40, 20, 0, 51),
+                src_size=(17, 67),
+                dst_size=(69, 69),
+                src_has_alpha=True,
+            )
+        )
+        self.assertEqual(
+            *test_premul_surf(
+                pygame.Color(30, 20, 0, 51),
+                pygame.Color(40, 20, 0, 255),
+                src_size=(17, 67),
+                dst_size=(69, 69),
+                dst_has_alpha=False,
+            )
+        )
+
+        self.assertEqual(
+            *test_premul_surf(
+                pygame.Color(30, 20, 0, 255),
+                pygame.Color(40, 20, 0, 255),
+                src_size=(17, 67),
+                dst_size=(69, 69),
+                src_has_alpha=False,
+                dst_has_alpha=False,
+            )
+        )
+
+        self.assertEqual(
+            *test_premul_surf(
+                pygame.Color(30, 20, 0, 255),
+                pygame.Color(40, 20, 0, 255),
+                src_size=(17, 67),
+                dst_size=(69, 69),
+                dst_bit_depth=24,
+                src_has_alpha=True,
+                dst_has_alpha=False,
+            )
+        )
+
+        self.assertEqual(
+            *test_premul_surf(
+                pygame.Color(30, 20, 0, 255),
+                pygame.Color(40, 20, 0, 255),
+                src_size=(17, 67),
+                dst_size=(69, 69),
+                src_bit_depth=24,
+                src_has_alpha=False,
+                dst_has_alpha=True,
+            )
+        )
+
+        self.assertEqual(
+            *test_premul_surf(
+                pygame.Color(30, 20, 0, 255),
+                pygame.Color(40, 20, 0, 255),
+                src_size=(17, 67),
+                dst_size=(69, 69),
+                src_bit_depth=24,
+                dst_bit_depth=24,
+                src_has_alpha=False,
+                dst_has_alpha=False,
+            )
+        )
+
+        self.assertEqual(
+            *test_premul_surf(
+                pygame.Color(30, 20, 0, 255),
+                pygame.Color(40, 20, 0, 255),
+                src_size=(17, 67),
+                dst_size=(69, 69),
+                src_bit_depth=8,
+            )
+        )
+
+        self.assertEqual(
+            *test_premul_surf(
+                pygame.Color(30, 20, 0, 255),
+                pygame.Color(40, 20, 0, 255),
+                src_size=(17, 67),
+                dst_size=(69, 69),
+                dst_bit_depth=8,
+            )
+        )
+
+        self.assertEqual(
+            *test_premul_surf(
+                pygame.Color(30, 20, 0, 255),
+                pygame.Color(40, 20, 0, 255),
+                src_size=(17, 67),
+                dst_size=(69, 69),
+                src_bit_depth=8,
+                dst_bit_depth=8,
+            )
+        )
+
+    def test_blit_blend_big_rect(self):
+        """test that an oversized rect works ok."""
+        color = (1, 2, 3, 255)
+        area = (1, 1, 30, 30)
+        s1 = pygame.Surface((4, 4), 0, 32)
+        r = s1.fill(special_flags=pygame.BLEND_ADD, color=color, rect=area)
+
+        self.assertEqual(pygame.Rect((1, 1, 3, 3)), r)
+        self.assertEqual(s1.get_at((0, 0)), (0, 0, 0, 255))
+        self.assertEqual(s1.get_at((1, 1)), color)
+
+        black = pygame.Color("black")
+        red = pygame.Color("red")
+        self.assertNotEqual(black, red)
+
+        surf = pygame.Surface((10, 10), 0, 32)
+        surf.fill(black)
+        subsurf = surf.subsurface(pygame.Rect(0, 1, 10, 8))
+        self.assertEqual(surf.get_at((0, 0)), black)
+        self.assertEqual(surf.get_at((0, 9)), black)
+
+        subsurf.fill(red, (0, -1, 10, 1), pygame.BLEND_RGB_ADD)
+        self.assertEqual(surf.get_at((0, 0)), black)
+        self.assertEqual(surf.get_at((0, 9)), black)
+
+        subsurf.fill(red, (0, 8, 10, 1), pygame.BLEND_RGB_ADD)
+        self.assertEqual(surf.get_at((0, 0)), black)
+        self.assertEqual(surf.get_at((0, 9)), black)
+
+    def test_GET_PIXELVALS(self):
+        # surface.h GET_PIXELVALS bug regarding whether of not
+        # a surface has per-pixel alpha. Looking at the Amask
+        # is not enough. The surface's SRCALPHA flag must also
+        # be considered. Fix rev. 1923.
+        src = self._make_surface(32, srcalpha=True)
+        src.fill((0, 0, 0, 128))
+        src.set_alpha(None)  # Clear SRCALPHA flag.
+        dst = self._make_surface(32, srcalpha=True)
+        dst.blit(src, (0, 0), special_flags=BLEND_RGBA_ADD)
+        self.assertEqual(dst.get_at((0, 0)), (0, 0, 0, 255))
+
+    def test_fill_blend(self):
+        destinations = [
+            self._make_surface(8),
+            self._make_surface(16),
+            self._make_surface(16, srcalpha=True),
+            self._make_surface(24),
+            self._make_surface(32),
+            self._make_surface(32, srcalpha=True),
+        ]
+        blend = [
+            ("BLEND_ADD", (0, 25, 100, 255), lambda a, b: min(a + b, 255)),
+            ("BLEND_SUB", (0, 25, 100, 255), lambda a, b: max(a - b, 0)),
+            ("BLEND_MULT", (0, 7, 100, 255), lambda a, b: ((a * b) + 255) >> 8),
+            ("BLEND_MIN", (0, 255, 0, 255), min),
+            ("BLEND_MAX", (0, 255, 0, 255), max),
+        ]
+
+        for dst in destinations:
+            dst_palette = [dst.unmap_rgb(dst.map_rgb(c)) for c in self._test_palette]
+            for blend_name, fill_color, op in blend:
+                fc = dst.unmap_rgb(dst.map_rgb(fill_color))
+                self._fill_surface(dst)
+                p = []
+                for dc in dst_palette:
+                    c = [op(dc[i], fc[i]) for i in range(3)]
+                    if dst.get_masks()[3]:
+                        c.append(dc[3])
+                    else:
+                        c.append(255)
+                    c = dst.unmap_rgb(dst.map_rgb(c))
+                    p.append(c)
+                dst.fill(fill_color, special_flags=getattr(pygame, blend_name))
+                self._assert_surface(dst, p, f", {blend_name}")
+
+    def test_fill_blend_rgba(self):
+        destinations = [
+            self._make_surface(8),
+            self._make_surface(16),
+            self._make_surface(16, srcalpha=True),
+            self._make_surface(24),
+            self._make_surface(32),
+            self._make_surface(32, srcalpha=True),
+        ]
+        blend = [
+            ("BLEND_RGBA_ADD", (0, 25, 100, 255), lambda a, b: min(a + b, 255)),
+            ("BLEND_RGBA_SUB", (0, 25, 100, 255), lambda a, b: max(a - b, 0)),
+            ("BLEND_RGBA_MULT", (0, 7, 100, 255), lambda a, b: ((a * b) + 255) >> 8),
+            ("BLEND_RGBA_MIN", (0, 255, 0, 255), min),
+            ("BLEND_RGBA_MAX", (0, 255, 0, 255), max),
+        ]
+
+        for dst in destinations:
+            dst_palette = [dst.unmap_rgb(dst.map_rgb(c)) for c in self._test_palette]
+            for blend_name, fill_color, op in blend:
+                fc = dst.unmap_rgb(dst.map_rgb(fill_color))
+                self._fill_surface(dst)
+                p = []
+                for dc in dst_palette:
+                    c = [op(dc[i], fc[i]) for i in range(4)]
+                    if not dst.get_masks()[3]:
+                        c[3] = 255
+                    c = dst.unmap_rgb(dst.map_rgb(c))
+                    p.append(c)
+                dst.fill(fill_color, special_flags=getattr(pygame, blend_name))
+                self._assert_surface(dst, p, f", {blend_name}")
+
+    def test_surface_premul_alpha(self):
+        """Ensure that .premul_alpha() 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_alpha = s1.premul_alpha()
+        self.assertEqual(s1_alpha.get_at((50, 50)), pygame.Color(100, 100, 100, 100))
+
+        # 16 bit colour has less precision
+        s2 = pygame.Surface((100, 100), pygame.SRCALPHA, 16)
+        s2.fill(pygame.Color(255, 255, 255, 170))
+        s2_alpha = s2.premul_alpha()
+        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)
+        invalid_surf.fill(pygame.Color(255, 255, 255, 100))
+        with self.assertRaises(ValueError):
+            invalid_surf.premul_alpha()
+
+        # 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 = surf.premul_alpha()
+                    self.assertEqual(
+                        surf.get_at((5, 5)),
+                        Color(
+                            ((r + 1) * a) >> 8,
+                            ((g + 1) * a) >> 8,
+                            ((b + 1) * a) >> 8,
+                            a,
+                        ),
+                    )
+
+
+class SurfaceSelfBlitTest(unittest.TestCase):
+    """Blit to self tests.
+
+    This test case is in response to https://github.com/pygame/pygame/issues/19
+    """
+
+    def setUp(self):
+        # Needed for 8 bits-per-pixel color palette surface tests.
+        pygame.display.init()
+
+    def tearDown(self):
+        pygame.display.quit()
+
+    _test_palette = [(0, 0, 0, 255), (255, 0, 0, 0), (0, 255, 0, 255)]
+    surf_size = (9, 6)
+
+    def _fill_surface(self, surf, palette=None):
+        if palette is None:
+            palette = self._test_palette
+        surf.fill(palette[1])
+        surf.fill(palette[2], (1, 2, 1, 2))
+
+    def _make_surface(self, bitsize, srcalpha=False, palette=None):
+        if palette is None:
+            palette = self._test_palette
+        flags = 0
+        if srcalpha:
+            flags |= SRCALPHA
+        surf = pygame.Surface(self.surf_size, flags, bitsize)
+        if bitsize == 8:
+            surf.set_palette([c[:3] for c in palette])
+        self._fill_surface(surf, palette)
+        return surf
+
+    def _assert_same(self, a, b):
+        w, h = a.get_size()
+        for x in range(w):
+            for y in range(h):
+                self.assertEqual(
+                    a.get_at((x, y)),
+                    b.get_at((x, y)),
+                    (
+                        "%s != %s, bpp: %i"
+                        % (a.get_at((x, y)), b.get_at((x, y)), a.get_bitsize())
+                    ),
+                )
+
+    def test_overlap_check(self):
+        # Ensure overlapping blits are properly detected. There are two
+        # places where this is done, within SoftBlitPyGame() in alphablit.c
+        # and PySurface_Blit() in surface.c. SoftBlitPyGame should catch the
+        # per-pixel alpha surface, PySurface_Blit the colorkey and blanket
+        # alpha surface. per-pixel alpha and blanket alpha self blits are
+        # not properly handled by SDL 1.2.13, so Pygame does them.
+        bgc = (0, 0, 0, 255)
+        rectc_left = (128, 64, 32, 255)
+        rectc_right = (255, 255, 255, 255)
+        colors = [(255, 255, 255, 255), (128, 64, 32, 255)]
+        overlaps = [
+            (0, 0, 1, 0, (50, 0)),
+            (0, 0, 49, 1, (98, 2)),
+            (0, 0, 49, 49, (98, 98)),
+            (49, 0, 0, 1, (0, 2)),
+            (49, 0, 0, 49, (0, 98)),
+        ]
+        surfs = [pygame.Surface((100, 100), SRCALPHA, 32)]
+        surf = pygame.Surface((100, 100), 0, 32)
+        surf.set_alpha(255)
+        surfs.append(surf)
+        surf = pygame.Surface((100, 100), 0, 32)
+        surf.set_colorkey((0, 1, 0))
+        surfs.append(surf)
+        for surf in surfs:
+            for s_x, s_y, d_x, d_y, test_posn in overlaps:
+                surf.fill(bgc)
+                surf.fill(rectc_right, (25, 0, 25, 50))
+                surf.fill(rectc_left, (0, 0, 25, 50))
+                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/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/pygame/issues/19
+        pygame.display.set_mode((100, 50))  # Needed for 8bit surface
+        bitsizes = [8, 16, 24, 32]
+        for bitsize in bitsizes:
+            surf = self._make_surface(bitsize)
+            surf.set_colorkey(self._test_palette[1])
+            surf.blit(surf, (3, 0))
+            p = []
+            for c in self._test_palette:
+                c = surf.unmap_rgb(surf.map_rgb(c))
+                p.append(c)
+            p[1] = (p[1][0], p[1][1], p[1][2], 0)
+            tmp = self._make_surface(32, srcalpha=True, palette=p)
+            tmp.blit(tmp, (3, 0))
+            tmp.set_alpha(None)
+            comp = self._make_surface(bitsize)
+            comp.blit(tmp, (0, 0))
+            self._assert_same(surf, comp)
+
+    # 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/pygame/issues/19
+        pygame.display.set_mode((100, 50))  # Needed for 8bit surface
+        bitsizes = [8, 16, 24, 32]
+        for bitsize in bitsizes:
+            surf = self._make_surface(bitsize)
+            surf.set_alpha(128)
+            surf.blit(surf, (3, 0))
+            p = []
+            for c in self._test_palette:
+                c = surf.unmap_rgb(surf.map_rgb(c))
+                p.append((c[0], c[1], c[2], 128))
+            tmp = self._make_surface(32, srcalpha=True, palette=p)
+            tmp.blit(tmp, (3, 0))
+            tmp.set_alpha(None)
+            comp = self._make_surface(bitsize)
+            comp.blit(tmp, (0, 0))
+            self._assert_same(surf, comp)
+
+    def test_pixel_alpha(self):
+        bitsizes = [16, 32]
+        for bitsize in bitsizes:
+            surf = self._make_surface(bitsize, srcalpha=True)
+            comp = self._make_surface(bitsize, srcalpha=True)
+            comp.blit(surf, (3, 0))
+            surf.blit(surf, (3, 0))
+            self._assert_same(surf, comp)
+
+    def test_blend(self):
+        bitsizes = [8, 16, 24, 32]
+        blends = ["BLEND_ADD", "BLEND_SUB", "BLEND_MULT", "BLEND_MIN", "BLEND_MAX"]
+        for bitsize in bitsizes:
+            surf = self._make_surface(bitsize)
+            comp = self._make_surface(bitsize)
+            for blend in blends:
+                self._fill_surface(surf)
+                self._fill_surface(comp)
+                comp.blit(surf, (3, 0), special_flags=getattr(pygame, blend))
+                surf.blit(surf, (3, 0), special_flags=getattr(pygame, blend))
+                self._assert_same(surf, comp)
+
+    def test_blend_rgba(self):
+        bitsizes = [16, 32]
+        blends = [
+            "BLEND_RGBA_ADD",
+            "BLEND_RGBA_SUB",
+            "BLEND_RGBA_MULT",
+            "BLEND_RGBA_MIN",
+            "BLEND_RGBA_MAX",
+        ]
+        for bitsize in bitsizes:
+            surf = self._make_surface(bitsize, srcalpha=True)
+            comp = self._make_surface(bitsize, srcalpha=True)
+            for blend in blends:
+                self._fill_surface(surf)
+                self._fill_surface(comp)
+                comp.blit(surf, (3, 0), special_flags=getattr(pygame, blend))
+                surf.blit(surf, (3, 0), special_flags=getattr(pygame, blend))
+                self._assert_same(surf, comp)
+
+    def test_subsurface(self):
+        # Blitting a surface to its subsurface is allowed.
+        surf = self._make_surface(32, srcalpha=True)
+        comp = surf.copy()
+        comp.blit(surf, (3, 0))
+        sub = surf.subsurface((3, 0, 6, 6))
+        sub.blit(surf, (0, 0))
+        del sub
+        self._assert_same(surf, comp)
+
+        # Blitting a subsurface to its owner is forbidden because of
+        # lock conflicts. This limitation allows the overlap check
+        # in PySurface_Blit of alphablit.c to be simplified.
+        def do_blit(d, s):
+            d.blit(s, (0, 0))
+
+        sub = surf.subsurface((1, 1, 2, 2))
+        self.assertRaises(pygame.error, do_blit, surf, sub)
+
+    def test_copy_alpha(self):
+        """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()
+        self.assertEqual(surf2.get_alpha(), 255)
+
+
+class SurfaceFillTest(unittest.TestCase):
+    def setUp(self):
+        pygame.display.init()
+
+    def tearDown(self):
+        pygame.display.quit()
+
+    def test_fill(self):
+        screen = pygame.display.set_mode((640, 480))
+
+        # Green and blue test pattern
+        screen.fill((0, 255, 0), (0, 0, 320, 240))
+        screen.fill((0, 255, 0), (320, 240, 320, 240))
+        screen.fill((0, 0, 255), (320, 0, 320, 240))
+        screen.fill((0, 0, 255), (0, 240, 320, 240))
+
+        # Now apply a clip rect, such that only the left side of the
+        # screen should be effected by blit operations.
+        screen.set_clip((0, 0, 320, 480))
+
+        # Test fills with each special flag, and additionally without any.
+        screen.fill((255, 0, 0, 127), (160, 0, 320, 30), 0)
+        screen.fill((255, 0, 0, 127), (160, 30, 320, 30), pygame.BLEND_ADD)
+        screen.fill((0, 127, 127, 127), (160, 60, 320, 30), pygame.BLEND_SUB)
+        screen.fill((0, 63, 63, 127), (160, 90, 320, 30), pygame.BLEND_MULT)
+        screen.fill((0, 127, 127, 127), (160, 120, 320, 30), pygame.BLEND_MIN)
+        screen.fill((127, 0, 0, 127), (160, 150, 320, 30), pygame.BLEND_MAX)
+        screen.fill((255, 0, 0, 127), (160, 180, 320, 30), pygame.BLEND_RGBA_ADD)
+        screen.fill((0, 127, 127, 127), (160, 210, 320, 30), pygame.BLEND_RGBA_SUB)
+        screen.fill((0, 63, 63, 127), (160, 240, 320, 30), pygame.BLEND_RGBA_MULT)
+        screen.fill((0, 127, 127, 127), (160, 270, 320, 30), pygame.BLEND_RGBA_MIN)
+        screen.fill((127, 0, 0, 127), (160, 300, 320, 30), pygame.BLEND_RGBA_MAX)
+        screen.fill((255, 0, 0, 127), (160, 330, 320, 30), pygame.BLEND_RGB_ADD)
+        screen.fill((0, 127, 127, 127), (160, 360, 320, 30), pygame.BLEND_RGB_SUB)
+        screen.fill((0, 63, 63, 127), (160, 390, 320, 30), pygame.BLEND_RGB_MULT)
+        screen.fill((0, 127, 127, 127), (160, 420, 320, 30), pygame.BLEND_RGB_MIN)
+        screen.fill((255, 0, 0, 127), (160, 450, 320, 30), pygame.BLEND_RGB_MAX)
+
+        # Update the display so we can see the results
+        pygame.display.flip()
+
+        # Compare colors on both sides of window
+        for y in range(5, 480, 10):
+            self.assertEqual(screen.get_at((10, y)), screen.get_at((330, 480 - y)))
+
+
+if __name__ == "__main__":
+    unittest.main()
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/surfarray_tags.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/surfarray_tags.py
new file mode 100644
index 0000000..baa535c
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/surfarray_tags.py
@@ -0,0 +1,16 @@
+__tags__ = ["array"]
+
+exclude = False
+
+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/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/surfarray_test.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/surfarray_test.py
new file mode 100644
index 0000000..ee74290
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/surfarray_test.py
@@ -0,0 +1,743 @@
+import unittest
+import platform
+
+from numpy import (
+    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()
+
+
+@unittest.skipIf(IS_PYPY, "pypy skip known failure")  # TODO
+class SurfarrayModuleTest(unittest.TestCase):
+    pixels2d = {8: True, 16: True, 24: False, 32: True}
+    pixels3d = {8: False, 16: False, 24: True, 32: True}
+    array2d = {8: True, 16: True, 24: True, 32: True}
+    array3d = {8: False, 16: False, 24: True, 32: True}
+
+    test_palette = [
+        (0, 0, 0, 255),
+        (10, 30, 60, 255),
+        (25, 75, 100, 255),
+        (100, 150, 200, 255),
+        (0, 100, 200, 255),
+    ]
+    surf_size = (10, 12)
+    test_points = [
+        ((0, 0), 1),
+        ((4, 5), 1),
+        ((9, 0), 2),
+        ((5, 5), 2),
+        ((0, 11), 3),
+        ((4, 6), 3),
+        ((9, 11), 4),
+        ((5, 6), 4),
+    ]
+
+    @classmethod
+    def setUpClass(cls):
+        # Needed for 8 bits-per-pixel color palette surface tests.
+        pygame.init()
+
+    @classmethod
+    def tearDownClass(cls):
+        pygame.quit()
+
+    def setUp(cls):
+        # This makes sure pygame is always initialized before each test (in
+        # case a test calls pygame.quit()).
+        if not pygame.get_init():
+            pygame.init()
+
+    def _make_surface(self, bitsize, srcalpha=False, palette=None):
+        if palette is None:
+            palette = self.test_palette
+        flags = 0
+        if srcalpha:
+            flags |= SRCALPHA
+        surf = pygame.Surface(self.surf_size, flags, bitsize)
+        if bitsize == 8:
+            surf.set_palette([c[:3] for c in palette])
+        return surf
+
+    def _fill_surface(self, surf, palette=None):
+        if palette is None:
+            palette = self.test_palette
+        surf.fill(palette[1], (0, 0, 5, 6))
+        surf.fill(palette[2], (5, 0, 5, 6))
+        surf.fill(palette[3], (0, 6, 5, 6))
+        surf.fill(palette[4], (5, 6, 5, 6))
+
+    def _make_src_surface(self, bitsize, srcalpha=False, palette=None):
+        surf = self._make_surface(bitsize, srcalpha, palette)
+        self._fill_surface(surf, palette)
+        return surf
+
+    def _assert_surface(self, surf, palette=None, msg=""):
+        if palette is None:
+            palette = self.test_palette
+        if surf.get_bitsize() == 16:
+            palette = [surf.unmap_rgb(surf.map_rgb(c)) for c in palette]
+        for posn, i in self.test_points:
+            self.assertEqual(
+                surf.get_at(posn),
+                palette[i],
+                "%s != %s: flags: %i, bpp: %i, posn: %s%s"
+                % (
+                    surf.get_at(posn),
+                    palette[i],
+                    surf.get_flags(),
+                    surf.get_bitsize(),
+                    posn,
+                    msg,
+                ),
+            )
+
+    def _make_array3d(self, dtype):
+        return zeros((self.surf_size[0], self.surf_size[1], 3), dtype)
+
+    def _fill_array2d(self, arr, surf):
+        palette = self.test_palette
+        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
+        arr[:5, :6] = palette[1][:3]
+        arr[5:, :6] = palette[2][:3]
+        arr[:5, 6:] = palette[3][:3]
+        arr[5:, 6:] = palette[4][:3]
+
+    def _make_src_array3d(self, dtype):
+        arr = self._make_array3d(dtype)
+        self._fill_array3d(arr)
+        return arr
+
+    def _make_array2d(self, dtype):
+        return zeros(self.surf_size, dtype)
+
+    def test_array2d(self):
+        sources = [
+            self._make_src_surface(8),
+            self._make_src_surface(16),
+            self._make_src_surface(16, srcalpha=True),
+            self._make_src_surface(24),
+            self._make_src_surface(32),
+            self._make_src_surface(32, srcalpha=True),
+        ]
+        palette = self.test_palette
+        alpha_color = (0, 0, 0, 128)
+
+        for surf in sources:
+            arr = pygame.surfarray.array2d(surf)
+            for posn, i in self.test_points:
+                self.assertEqual(
+                    arr[posn],
+                    surf.get_at_mapped(posn),
+                    "%s != %s: flags: %i, bpp: %i, posn: %s"
+                    % (
+                        arr[posn],
+                        surf.get_at_mapped(posn),
+                        surf.get_flags(),
+                        surf.get_bitsize(),
+                        posn,
+                    ),
+                )
+
+            if surf.get_masks()[3]:
+                surf.fill(alpha_color)
+                arr = pygame.surfarray.array2d(surf)
+                posn = (0, 0)
+                self.assertEqual(
+                    arr[posn],
+                    surf.get_at_mapped(posn),
+                    "%s != %s: bpp: %i"
+                    % (arr[posn], surf.get_at_mapped(posn), surf.get_bitsize()),
+                )
+
+    def test_array3d(self):
+        sources = [
+            self._make_src_surface(16),
+            self._make_src_surface(16, srcalpha=True),
+            self._make_src_surface(24),
+            self._make_src_surface(32),
+            self._make_src_surface(32, srcalpha=True),
+        ]
+        palette = self.test_palette
+
+        for surf in sources:
+            arr = pygame.surfarray.array3d(surf)
+
+            def same_color(ac, sc):
+                return ac[0] == sc[0] and ac[1] == sc[1] and ac[2] == sc[2]
+
+            for posn, i in self.test_points:
+                self.assertTrue(
+                    same_color(arr[posn], surf.get_at(posn)),
+                    "%s != %s: flags: %i, bpp: %i, posn: %s"
+                    % (
+                        tuple(arr[posn]),
+                        surf.get_at(posn),
+                        surf.get_flags(),
+                        surf.get_bitsize(),
+                        posn,
+                    ),
+                )
+
+    def test_array_alpha(self):
+        palette = [
+            (0, 0, 0, 0),
+            (10, 50, 100, 255),
+            (60, 120, 240, 130),
+            (64, 128, 255, 0),
+            (255, 128, 0, 65),
+        ]
+        targets = [
+            self._make_src_surface(8, palette=palette),
+            self._make_src_surface(16, palette=palette),
+            self._make_src_surface(16, palette=palette, srcalpha=True),
+            self._make_src_surface(24, palette=palette),
+            self._make_src_surface(32, palette=palette),
+            self._make_src_surface(32, palette=palette, srcalpha=True),
+        ]
+
+        for surf in targets:
+            p = palette
+            if surf.get_bitsize() == 16:
+                p = [surf.unmap_rgb(surf.map_rgb(c)) for c in p]
+            arr = pygame.surfarray.array_alpha(surf)
+            if surf.get_masks()[3]:
+                for (x, y), i in self.test_points:
+                    self.assertEqual(
+                        arr[x, y],
+                        p[i][3],
+                        (
+                            "%i != %i, posn: (%i, %i), "
+                            "bitsize: %i"
+                            % (arr[x, y], p[i][3], x, y, surf.get_bitsize())
+                        ),
+                    )
+            else:
+                self.assertTrue(alltrue(arr == 255))
+
+        # No per-pixel alpha when blanket alpha is None.
+        for surf in targets:
+            blanket_alpha = surf.get_alpha()
+            surf.set_alpha(None)
+            arr = pygame.surfarray.array_alpha(surf)
+            self.assertTrue(
+                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()),
+            )
+            surf.set_alpha(blanket_alpha)
+
+        # Bug for per-pixel alpha surface when blanket alpha 0.
+        for surf in targets:
+            blanket_alpha = surf.get_alpha()
+            surf.set_alpha(0)
+            arr = pygame.surfarray.array_alpha(surf)
+            if surf.get_masks()[3]:
+                self.assertFalse(
+                    alltrue(arr == 255),
+                    "bitsize: %i, flags: %i" % (surf.get_bitsize(), surf.get_flags()),
+                )
+            else:
+                self.assertTrue(
+                    alltrue(arr == 255),
+                    "bitsize: %i, flags: %i" % (surf.get_bitsize(), surf.get_flags()),
+                )
+            surf.set_alpha(blanket_alpha)
+
+    def test_array_colorkey(self):
+        palette = [
+            (0, 0, 0, 0),
+            (10, 50, 100, 255),
+            (60, 120, 240, 130),
+            (64, 128, 255, 0),
+            (255, 128, 0, 65),
+        ]
+        targets = [
+            self._make_src_surface(8, palette=palette),
+            self._make_src_surface(16, palette=palette),
+            self._make_src_surface(16, palette=palette, srcalpha=True),
+            self._make_src_surface(24, palette=palette),
+            self._make_src_surface(32, palette=palette),
+            self._make_src_surface(32, palette=palette, srcalpha=True),
+        ]
+
+        for surf in targets:
+            p = palette
+            if surf.get_bitsize() == 16:
+                p = [surf.unmap_rgb(surf.map_rgb(c)) for c in p]
+            surf.set_colorkey(None)
+            arr = pygame.surfarray.array_colorkey(surf)
+            self.assertTrue(alltrue(arr == 255))
+
+            for i in range(1, len(palette)):
+                surf.set_colorkey(p[i])
+                alphas = [255] * len(p)
+                alphas[i] = 0
+                arr = pygame.surfarray.array_colorkey(surf)
+                for (x, y), j in self.test_points:
+                    self.assertEqual(
+                        arr[x, y],
+                        alphas[j],
+                        (
+                            "%i != %i, posn: (%i, %i), "
+                            "bitsize: %i"
+                            % (arr[x, y], alphas[j], x, y, surf.get_bitsize())
+                        ),
+                    )
+
+    def test_array_red(self):
+        self._test_array_rgb("red", 0)
+
+    def test_array_green(self):
+        self._test_array_rgb("green", 1)
+
+    def test_array_blue(self):
+        self._test_array_rgb("blue", 2)
+
+    def _test_array_rgb(self, operation, mask_posn):
+        method_name = "array_" + operation
+
+        array_rgb = getattr(pygame.surfarray, method_name)
+        palette = [
+            (0, 0, 0, 255),
+            (5, 13, 23, 255),
+            (29, 31, 37, 255),
+            (131, 157, 167, 255),
+            (179, 191, 251, 255),
+        ]
+        plane = [c[mask_posn] for c in palette]
+
+        targets = [
+            self._make_src_surface(24, palette=palette),
+            self._make_src_surface(32, palette=palette),
+            self._make_src_surface(32, palette=palette, srcalpha=True),
+        ]
+
+        for surf in targets:
+            self.assertFalse(surf.get_locked())
+            for (x, y), i in self.test_points:
+                surf.fill(palette[i])
+                arr = array_rgb(surf)
+                self.assertEqual(arr[x, y], plane[i])
+                surf.fill((100, 100, 100, 250))
+                self.assertEqual(arr[x, y], plane[i])
+                self.assertFalse(surf.get_locked())
+                del arr
+
+    def test_blit_array(self):
+        s = pygame.Surface((10, 10), 0, 24)
+        a = pygame.surfarray.array3d(s)
+        pygame.surfarray.blit_array(s, a)
+
+        # target surfaces
+        targets = [
+            self._make_surface(8),
+            self._make_surface(16),
+            self._make_surface(16, srcalpha=True),
+            self._make_surface(24),
+            self._make_surface(32),
+            self._make_surface(32, srcalpha=True),
+        ]
+
+        # source arrays
+        arrays3d = []
+        dtypes = [(8, uint8), (16, uint16), (32, uint32)]
+        try:
+            dtypes.append((64, uint64))
+        except NameError:
+            pass
+        arrays3d = [(self._make_src_array3d(dtype), None) for __, dtype in dtypes]
+        for bitsize in [8, 16, 24, 32]:
+            palette = None
+            if bitsize == 16:
+                s = pygame.Surface((1, 1), 0, 16)
+                palette = [s.unmap_rgb(s.map_rgb(c)) for c in self.test_palette]
+            if self.pixels3d[bitsize]:
+                surf = self._make_src_surface(bitsize)
+                arr = pygame.surfarray.pixels3d(surf)
+                arrays3d.append((arr, palette))
+            if self.array3d[bitsize]:
+                surf = self._make_src_surface(bitsize)
+                arr = pygame.surfarray.array3d(surf)
+                arrays3d.append((arr, palette))
+                for sz, dtype in dtypes:
+                    arrays3d.append((arr.astype(dtype), palette))
+
+        # tests on arrays
+        def do_blit(surf, arr):
+            pygame.surfarray.blit_array(surf, arr)
+
+        for surf in targets:
+            bitsize = surf.get_bitsize()
+            for arr, palette in arrays3d:
+                surf.fill((0, 0, 0, 0))
+                if bitsize == 8:
+                    self.assertRaises(ValueError, do_blit, surf, arr)
+                else:
+                    pygame.surfarray.blit_array(surf, arr)
+                    self._assert_surface(surf, palette)
+
+            if self.pixels2d[bitsize]:
+                surf.fill((0, 0, 0, 0))
+                s = self._make_src_surface(bitsize, surf.get_flags() & SRCALPHA)
+                arr = pygame.surfarray.pixels2d(s)
+                pygame.surfarray.blit_array(surf, arr)
+                self._assert_surface(surf)
+
+            if self.array2d[bitsize]:
+                s = self._make_src_surface(bitsize, surf.get_flags() & SRCALPHA)
+                arr = pygame.surfarray.array2d(s)
+                for sz, dtype in dtypes:
+                    surf.fill((0, 0, 0, 0))
+                    if sz >= bitsize:
+                        pygame.surfarray.blit_array(surf, arr.astype(dtype))
+                        self._assert_surface(surf)
+                    else:
+                        self.assertRaises(
+                            ValueError, do_blit, surf, self._make_array2d(dtype)
+                        )
+
+        # Check alpha for 2D arrays
+        surf = self._make_surface(16, srcalpha=True)
+        arr = zeros(surf.get_size(), uint16)
+        arr[...] = surf.map_rgb((0, 128, 255, 64))
+        color = surf.unmap_rgb(arr[0, 0])
+        pygame.surfarray.blit_array(surf, arr)
+        self.assertEqual(surf.get_at((5, 5)), color)
+
+        surf = self._make_surface(32, srcalpha=True)
+        arr = zeros(surf.get_size(), uint32)
+        color = (0, 111, 255, 63)
+        arr[...] = surf.map_rgb(color)
+        pygame.surfarray.blit_array(surf, arr)
+        self.assertEqual(surf.get_at((5, 5)), color)
+
+        # Check shifts
+        arr3d = self._make_src_array3d(uint8)
+
+        shift_tests = [
+            (16, [12, 0, 8, 4], [0xF000, 0xF, 0xF00, 0xF0]),
+            (24, [16, 0, 8, 0], [0xFF0000, 0xFF, 0xFF00, 0]),
+            (32, [0, 16, 24, 8], [0xFF, 0xFF0000, 0xFF000000, 0xFF00]),
+        ]
+
+        for bitsize, shifts, masks in shift_tests:
+            surf = self._make_surface(bitsize, srcalpha=(shifts[3] != 0))
+            palette = None
+            if bitsize == 16:
+                palette = [surf.unmap_rgb(surf.map_rgb(c)) for c in self.test_palette]
+
+            self.assertRaises(TypeError, surf.set_shifts, shifts)
+            self.assertRaises(TypeError, surf.set_masks, masks)
+
+        # Invalid arrays
+        surf = pygame.Surface((1, 1), 0, 32)
+        t = "abcd"
+        self.assertRaises(ValueError, do_blit, surf, t)
+
+        surf_size = self.surf_size
+        surf = pygame.Surface(surf_size, 0, 32)
+        arr = zeros([surf_size[0], surf_size[1] + 1, 3], uint32)
+        self.assertRaises(ValueError, do_blit, surf, arr)
+        arr = zeros([surf_size[0] + 1, surf_size[1], 3], uint32)
+        self.assertRaises(ValueError, do_blit, surf, arr)
+
+        surf = pygame.Surface((1, 4), 0, 32)
+        arr = zeros((4,), uint32)
+        self.assertRaises(ValueError, do_blit, surf, arr)
+        arr.shape = (1, 1, 1, 4)
+        self.assertRaises(ValueError, do_blit, surf, arr)
+
+        # 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):
+        array_type = pygame.surfarray.get_arraytype()
+
+        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):
+        arraytypes = pygame.surfarray.get_arraytypes()
+        self.assertIn("numpy", arraytypes)
+
+        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
+        # since the pixel format is not entirely dependent on element size.
+        # Just make sure the surface pixel size is at least as large as the
+        # array element size I guess.
+        #
+        for bitsize, dtype in [(8, uint8), (16, uint16), (24, uint32)]:
+            ## Even this simple assertion fails for 2d arrays. Where's the problem?
+            ##            surf = pygame.surfarray.make_surface(self._make_array2d(dtype))
+            ##            self.assertGreaterEqual(surf.get_bitsize(), bitsize,
+            ##                            "not %i >= %i)" % (surf.get_bitsize(), bitsize))
+            ##
+            surf = pygame.surfarray.make_surface(self._make_src_array3d(dtype))
+            self._assert_surface(surf)
+
+        # 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)
+        targets = [
+            self._make_surface(8),
+            self._make_surface(16),
+            self._make_surface(16, srcalpha=True),
+            self._make_surface(24),
+            self._make_surface(32),
+            self._make_surface(32, srcalpha=True),
+        ]
+        palette = self.test_palette
+
+        for surf in targets:
+            arr2d = pygame.surfarray.map_array(surf, arr3d)
+            for posn, i in self.test_points:
+                self.assertEqual(
+                    arr2d[posn],
+                    surf.map_rgb(palette[i]),
+                    "%i != %i, bitsize: %i, flags: %i"
+                    % (
+                        arr2d[posn],
+                        surf.map_rgb(palette[i]),
+                        surf.get_bitsize(),
+                        surf.get_flags(),
+                    ),
+                )
+
+        # Exception checks
+        self.assertRaises(
+            ValueError,
+            pygame.surfarray.map_array,
+            self._make_surface(32),
+            self._make_array2d(uint8),
+        )
+
+    def test_pixels2d(self):
+        sources = [
+            self._make_surface(8),
+            self._make_surface(16, srcalpha=True),
+            self._make_surface(32, srcalpha=True),
+        ]
+
+        for surf in sources:
+            self.assertFalse(surf.get_locked())
+            arr = pygame.surfarray.pixels2d(surf)
+            self.assertTrue(surf.get_locked())
+            self._fill_array2d(arr, surf)
+            surf.unlock()
+            self.assertTrue(surf.get_locked())
+            del arr
+            self.assertFalse(surf.get_locked())
+            self.assertEqual(surf.get_locks(), ())
+            self._assert_surface(surf)
+
+        # Error checks
+        self.assertRaises(ValueError, pygame.surfarray.pixels2d, self._make_surface(24))
+
+    def test_pixels3d(self):
+        sources = [self._make_surface(24), self._make_surface(32)]
+
+        for surf in sources:
+            self.assertFalse(surf.get_locked())
+            arr = pygame.surfarray.pixels3d(surf)
+            self.assertTrue(surf.get_locked())
+            self._fill_array3d(arr)
+            surf.unlock()
+            self.assertTrue(surf.get_locked())
+            del arr
+            self.assertFalse(surf.get_locked())
+            self.assertEqual(surf.get_locks(), ())
+            self._assert_surface(surf)
+
+        # Alpha check
+        color = (1, 2, 3, 0)
+        surf = self._make_surface(32, srcalpha=True)
+        arr = pygame.surfarray.pixels3d(surf)
+        arr[0, 0] = color[:3]
+        self.assertEqual(surf.get_at((0, 0)), color)
+
+        # Error checks
+        def do_pixels3d(surf):
+            pygame.surfarray.pixels3d(surf)
+
+        self.assertRaises(ValueError, do_pixels3d, self._make_surface(8))
+        self.assertRaises(ValueError, do_pixels3d, self._make_surface(16))
+
+    def test_pixels_alpha(self):
+        palette = [
+            (0, 0, 0, 0),
+            (127, 127, 127, 0),
+            (127, 127, 127, 85),
+            (127, 127, 127, 170),
+            (127, 127, 127, 255),
+        ]
+        alphas = [0, 45, 86, 99, 180]
+
+        surf = self._make_src_surface(32, srcalpha=True, palette=palette)
+
+        self.assertFalse(surf.get_locked())
+        arr = pygame.surfarray.pixels_alpha(surf)
+        self.assertTrue(surf.get_locked())
+        surf.unlock()
+        self.assertTrue(surf.get_locked())
+
+        for (x, y), i in self.test_points:
+            self.assertEqual(arr[x, y], palette[i][3])
+
+        for (x, y), i in self.test_points:
+            alpha = alphas[i]
+            arr[x, y] = alpha
+            color = (127, 127, 127, alpha)
+            self.assertEqual(surf.get_at((x, y)), color, "posn: (%i, %i)" % (x, y))
+
+        del arr
+        self.assertFalse(surf.get_locked())
+        self.assertEqual(surf.get_locks(), ())
+
+        # Check exceptions.
+        def do_pixels_alpha(surf):
+            pygame.surfarray.pixels_alpha(surf)
+
+        targets = [(8, False), (16, False), (16, True), (24, False), (32, False)]
+
+        for bitsize, srcalpha in targets:
+            self.assertRaises(
+                ValueError, do_pixels_alpha, self._make_surface(bitsize, srcalpha)
+            )
+
+    def test_pixels_red(self):
+        self._test_pixels_rgb("red", 0)
+
+    def test_pixels_green(self):
+        self._test_pixels_rgb("green", 1)
+
+    def test_pixels_blue(self):
+        self._test_pixels_rgb("blue", 2)
+
+    def _test_pixels_rgb(self, operation, mask_posn):
+        method_name = "pixels_" + operation
+
+        pixels_rgb = getattr(pygame.surfarray, method_name)
+        palette = [
+            (0, 0, 0, 255),
+            (5, 13, 23, 255),
+            (29, 31, 37, 255),
+            (131, 157, 167, 255),
+            (179, 191, 251, 255),
+        ]
+        plane = [c[mask_posn] for c in palette]
+
+        surf24 = self._make_src_surface(24, srcalpha=False, palette=palette)
+        surf32 = self._make_src_surface(32, srcalpha=False, palette=palette)
+        surf32a = self._make_src_surface(32, srcalpha=True, palette=palette)
+
+        for surf in [surf24, surf32, surf32a]:
+            self.assertFalse(surf.get_locked())
+            arr = pixels_rgb(surf)
+            self.assertTrue(surf.get_locked())
+            surf.unlock()
+            self.assertTrue(surf.get_locked())
+
+            for (x, y), i in self.test_points:
+                self.assertEqual(arr[x, y], plane[i])
+
+            del arr
+            self.assertFalse(surf.get_locked())
+            self.assertEqual(surf.get_locks(), ())
+
+        # Check exceptions.
+        targets = [(8, False), (16, False), (16, True)]
+
+        for bitsize, srcalpha in targets:
+            self.assertRaises(
+                ValueError, pixels_rgb, self._make_surface(bitsize, srcalpha)
+            )
+
+    def test_use_arraytype(self):
+        def do_use_arraytype(atype):
+            pygame.surfarray.use_arraytype(atype)
+
+        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())
+
+            sf.unlock()
+            self.assertTrue(sf.get_locked())
+
+            del ar
+            self.assertFalse(sf.get_locked())
+            self.assertEqual(sf.get_locks(), ())
+
+
+if __name__ == "__main__":
+    unittest.main()
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/surflock_test.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/surflock_test.py
new file mode 100644
index 0000000..19f354b
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/surflock_test.py
@@ -0,0 +1,144 @@
+import unittest
+import sys
+import platform
+
+import pygame
+
+IS_PYPY = "PyPy" == platform.python_implementation()
+
+
+@unittest.skipIf(IS_PYPY, "pypy skip known failure")  # TODO
+class SurfaceLockTest(unittest.TestCase):
+    def test_lock(self):
+        sf = pygame.Surface((5, 5))
+
+        sf.lock()
+        self.assertEqual(sf.get_locked(), True)
+        self.assertEqual(sf.get_locks(), (sf,))
+
+        sf.lock()
+        self.assertEqual(sf.get_locked(), True)
+        self.assertEqual(sf.get_locks(), (sf, sf))
+
+        sf.unlock()
+        self.assertEqual(sf.get_locked(), True)
+        self.assertEqual(sf.get_locks(), (sf,))
+
+        sf.unlock()
+        self.assertEqual(sf.get_locked(), False)
+        self.assertEqual(sf.get_locks(), ())
+
+    def test_subsurface_lock(self):
+        sf = pygame.Surface((5, 5))
+        subsf = sf.subsurface((1, 1, 2, 2))
+        sf2 = pygame.Surface((5, 5))
+
+        # Simple blits, nothing should happen here.
+        sf2.blit(subsf, (0, 0))
+        sf2.blit(sf, (0, 0))
+
+        # Test blitting on self:
+        self.assertRaises(pygame.error, sf.blit, subsf, (0, 0))
+        # self.assertRaises(pygame.error, subsf.blit, sf, (0, 0))
+        # ^ Fails although it should not in my opinion. If I cannot
+        # blit the subsurface to the surface, it should not be allowed
+        # the other way around as well.
+
+        # Test additional locks.
+        sf.lock()
+        sf2.blit(subsf, (0, 0))
+        self.assertRaises(pygame.error, sf2.blit, sf, (0, 0))
+
+        subsf.lock()
+        self.assertRaises(pygame.error, sf2.blit, subsf, (0, 0))
+        self.assertRaises(pygame.error, sf2.blit, sf, (0, 0))
+
+        # sf and subsf are now explicitly locked. Unlock sf, so we can
+        # (assume) to blit it.
+        # It will fail though as the subsurface still has a lock around,
+        # which is okay and correct behaviour.
+        sf.unlock()
+        self.assertRaises(pygame.error, sf2.blit, subsf, (0, 0))
+        self.assertRaises(pygame.error, sf2.blit, sf, (0, 0))
+
+        # Run a second unlock on the surface. This should ideally have
+        # no effect as the subsurface is the locking reason!
+        sf.unlock()
+        self.assertRaises(pygame.error, sf2.blit, sf, (0, 0))
+        self.assertRaises(pygame.error, sf2.blit, subsf, (0, 0))
+        subsf.unlock()
+
+        sf.lock()
+        self.assertEqual(sf.get_locked(), True)
+        self.assertEqual(sf.get_locks(), (sf,))
+        self.assertEqual(subsf.get_locked(), False)
+        self.assertEqual(subsf.get_locks(), ())
+
+        subsf.lock()
+        self.assertEqual(sf.get_locked(), True)
+        self.assertEqual(sf.get_locks(), (sf, subsf))
+        self.assertEqual(subsf.get_locked(), True)
+        self.assertEqual(subsf.get_locks(), (subsf,))
+
+        sf.unlock()
+        self.assertEqual(sf.get_locked(), True)
+        self.assertEqual(sf.get_locks(), (subsf,))
+        self.assertEqual(subsf.get_locked(), True)
+        self.assertEqual(subsf.get_locks(), (subsf,))
+
+        subsf.unlock()
+        self.assertEqual(sf.get_locked(), False)
+        self.assertEqual(sf.get_locks(), ())
+        self.assertEqual(subsf.get_locked(), False)
+        self.assertEqual(subsf.get_locks(), ())
+
+        subsf.lock()
+        self.assertEqual(sf.get_locked(), True)
+        self.assertEqual(sf.get_locks(), (subsf,))
+        self.assertEqual(subsf.get_locked(), True)
+        self.assertEqual(subsf.get_locks(), (subsf,))
+
+        subsf.lock()
+        self.assertEqual(sf.get_locked(), True)
+        self.assertEqual(sf.get_locks(), (subsf, subsf))
+        self.assertEqual(subsf.get_locked(), True)
+        self.assertEqual(subsf.get_locks(), (subsf, subsf))
+
+    def test_pxarray_ref(self):
+        sf = pygame.Surface((5, 5))
+        ar = pygame.PixelArray(sf)
+        ar2 = pygame.PixelArray(sf)
+
+        self.assertEqual(sf.get_locked(), True)
+        self.assertEqual(sf.get_locks(), (ar, ar2))
+
+        del ar
+        self.assertEqual(sf.get_locked(), True)
+        self.assertEqual(sf.get_locks(), (ar2,))
+
+        ar = ar2[:]
+        self.assertEqual(sf.get_locked(), True)
+        self.assertEqual(sf.get_locks(), (ar2,))
+
+        del ar
+        self.assertEqual(sf.get_locked(), True)
+        self.assertEqual(len(sf.get_locks()), 1)
+
+    def test_buffer(self):
+        sf = pygame.Surface((5, 5))
+        buf = sf.get_buffer()
+
+        self.assertEqual(sf.get_locked(), True)
+        self.assertEqual(sf.get_locks(), (buf,))
+
+        sf.unlock()
+        self.assertEqual(sf.get_locked(), True)
+        self.assertEqual(sf.get_locks(), (buf,))
+
+        del buf
+        self.assertEqual(sf.get_locked(), False)
+        self.assertEqual(sf.get_locks(), ())
+
+
+if __name__ == "__main__":
+    unittest.main()
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/sysfont_test.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/sysfont_test.py
new file mode 100644
index 0000000..0ae380a
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/sysfont_test.py
@@ -0,0 +1,51 @@
+import unittest
+import platform
+
+
+class SysfontModuleTest(unittest.TestCase):
+    def test_create_aliases(self):
+        import pygame.sysfont
+
+        pygame.sysfont.initsysfonts()
+        pygame.sysfont.create_aliases()
+        self.assertTrue(len(pygame.sysfont.Sysalias) > 0)
+
+    def test_initsysfonts(self):
+        import pygame.sysfont
+
+        pygame.sysfont.initsysfonts()
+        self.assertTrue(len(pygame.sysfont.get_fonts()) > 0)
+
+    @unittest.skipIf("Darwin" not in platform.platform(), "Not mac we skip.")
+    def test_initsysfonts_darwin(self):
+        import pygame.sysfont
+
+        self.assertTrue(len(pygame.sysfont.get_fonts()) > 10)
+
+    def test_sysfont(self):
+        import pygame.font
+
+        pygame.font.init()
+        arial = pygame.font.SysFont("Arial", 40)
+        self.assertTrue(isinstance(arial, pygame.font.Font))
+
+    @unittest.skipIf(
+        ("Darwin" in platform.platform() or "Windows" in platform.platform()),
+        "Not unix we skip.",
+    )
+    def test_initsysfonts_unix(self):
+        import pygame.sysfont
+
+        self.assertTrue(len(pygame.sysfont.get_fonts()) > 0)
+
+    @unittest.skipIf("Windows" not in platform.platform(), "Not windows we skip.")
+    def test_initsysfonts_win32(self):
+        import pygame.sysfont
+
+        self.assertTrue(len(pygame.sysfont.get_fonts()) > 10)
+
+
+###############################################################################
+
+if __name__ == "__main__":
+    unittest.main()
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/test_utils/__init__.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/test_utils/__init__.py
new file mode 100644
index 0000000..a4994f2
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/test_utils/__init__.py
@@ -0,0 +1,201 @@
+import os
+import pygame
+import sys
+import tempfile
+import time
+
+is_pygame_pkg = __name__.startswith("pygame.tests.")
+
+###############################################################################
+
+
+def tostring(row):
+    """Convert row of bytes to string.  Expects `row` to be an
+    ``array``.
+    """
+    return row.tobytes()
+
+
+def geterror():
+    return sys.exc_info()[1]
+
+
+###############################################################################
+
+this_dir = os.path.dirname(os.path.abspath(__file__))
+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):
+    return os.path.normpath(os.path.join(trunk_dir, relative))
+
+
+def fixture_path(path):
+    return trunk_relative_path(os.path.join(test_module, "fixtures", path))
+
+
+def example_path(path):
+    return trunk_relative_path(os.path.join("examples", path))
+
+
+sys.path.insert(0, trunk_relative_path("."))
+
+
+################################## TEMP FILES #################################
+
+
+def get_tmp_dir():
+    return tempfile.mkdtemp()
+
+
+###############################################################################
+
+
+def question(q):
+    return input(f"\n{q.rstrip(' ')} (y/n): ").lower().strip() == "y"
+
+
+def prompt(p):
+    return input(f"\n{p.rstrip(' ')} (press enter to continue): ")
+
+
+#################################### HELPERS ##################################
+
+
+def rgba_between(value, minimum=0, maximum=255):
+    if value < minimum:
+        return minimum
+    elif value > maximum:
+        return maximum
+    else:
+        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):
+    """
+
+    Yields a pt and corresponding RGBA tuple, for every (width, height) combo.
+    Useful for generating gradients.
+
+    Actual gradient may be changed, no tests rely on specific values.
+
+    Used in transform.rotate lossless tests to generate a fixture.
+
+    """
+
+    for l in range(width):
+        for t in range(height):
+            yield (l, t), tuple(map(rgba_between, (l, t, l, l + t)))
+
+
+def rect_area_pts(rect):
+    for l in range(rect.left, rect.right):
+        for t in range(rect.top, rect.bottom):
+            yield l, t
+
+
+def rect_perimeter_pts(rect):
+    """
+
+    Returns pts ((L, T) tuples) encompassing the perimeter of a rect.
+
+    The order is clockwise:
+
+          topleft to topright
+         topright to bottomright
+      bottomright to bottomleft
+       bottomleft to topleft
+
+    Duplicate pts are not returned
+
+    """
+    clock_wise_from_top_left = (
+        [(l, rect.top) for l in range(rect.left, rect.right)],
+        [(rect.right - 1, t) for t in range(rect.top + 1, rect.bottom)],
+        [(l, rect.bottom - 1) for l in range(rect.right - 2, rect.left - 1, -1)],
+        [(rect.left, t) for t in range(rect.bottom - 2, rect.top, -1)],
+    )
+
+    for line in clock_wise_from_top_left:
+        yield from line
+
+
+def rect_outer_bounds(rect):
+    """
+
+     Returns topleft outerbound if possible and then the other pts, that are
+     "exclusive" bounds of the rect
+
+    ?------O
+     |RECT|      ?|0)uterbound
+     |----|
+    O      O
+
+    """
+    return ([(rect.left - 1, rect.top)] if rect.left else []) + [
+        rect.topright,
+        rect.bottomleft,
+        rect.bottomright,
+    ]
+
+
+def import_submodule(module):
+    m = __import__(module)
+    for n in module.split(".")[1:]:
+        m = getattr(m, n)
+    return m
+
+
+class SurfaceSubclass(pygame.Surface):
+    """A subclassed Surface to test inheritance."""
+
+    def __init__(self, *args, **kwargs):
+        super().__init__(*args, **kwargs)
+        self.test_attribute = True
+
+
+def test():
+    """
+
+    Lightweight test for helpers
+
+    """
+
+    r = pygame.Rect(0, 0, 10, 10)
+    assert rect_outer_bounds(r) == [(10, 0), (0, 10), (10, 10)]  # tr # bl # br
+
+    assert len(list(rect_area_pts(r))) == 100
+
+    r = pygame.Rect(0, 0, 3, 3)
+    assert list(rect_perimeter_pts(r)) == [
+        (0, 0),
+        (1, 0),
+        (2, 0),  # tl -> tr
+        (2, 1),
+        (2, 2),  # tr -> br
+        (1, 2),
+        (0, 2),  # br -> bl
+        (0, 1),  # bl -> tl
+    ]
+
+    print("Tests: OK")
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/test_utils/__pycache__/__init__.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/test_utils/__pycache__/__init__.cpython-312.pyc
new file mode 100644
index 0000000..9ed09f5
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/test_utils/__pycache__/__init__.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/test_utils/__pycache__/arrinter.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/test_utils/__pycache__/arrinter.cpython-312.pyc
new file mode 100644
index 0000000..3b126ee
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/test_utils/__pycache__/arrinter.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/test_utils/__pycache__/async_sub.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/test_utils/__pycache__/async_sub.cpython-312.pyc
new file mode 100644
index 0000000..8e4cbcc
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/test_utils/__pycache__/async_sub.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/test_utils/__pycache__/buftools.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/test_utils/__pycache__/buftools.cpython-312.pyc
new file mode 100644
index 0000000..784b830
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/test_utils/__pycache__/buftools.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/test_utils/__pycache__/endian.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/test_utils/__pycache__/endian.cpython-312.pyc
new file mode 100644
index 0000000..e7a064d
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/test_utils/__pycache__/endian.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/test_utils/__pycache__/png.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/test_utils/__pycache__/png.cpython-312.pyc
new file mode 100644
index 0000000..991d06a
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/test_utils/__pycache__/png.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/test_utils/__pycache__/run_tests.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/test_utils/__pycache__/run_tests.cpython-312.pyc
new file mode 100644
index 0000000..050ed9f
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/test_utils/__pycache__/run_tests.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/test_utils/__pycache__/test_machinery.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/test_utils/__pycache__/test_machinery.cpython-312.pyc
new file mode 100644
index 0000000..e2dde05
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/test_utils/__pycache__/test_machinery.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/test_utils/__pycache__/test_runner.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/test_utils/__pycache__/test_runner.cpython-312.pyc
new file mode 100644
index 0000000..78c7c6a
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/test_utils/__pycache__/test_runner.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/test_utils/arrinter.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/test_utils/arrinter.py
new file mode 100644
index 0000000..626913c
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/test_utils/arrinter.py
@@ -0,0 +1,438 @@
+import sys
+import ctypes
+from ctypes import *
+import unittest
+
+__all__ = [
+    "PAI_CONTIGUOUS",
+    "PAI_FORTRAN",
+    "PAI_ALIGNED",
+    "PAI_NOTSWAPPED",
+    "PAI_WRITEABLE",
+    "PAI_ARR_HAS_DESCR",
+    "ArrayInterface",
+]
+
+if sizeof(c_uint) == sizeof(c_void_p):
+    c_size_t = c_uint
+    c_ssize_t = c_int
+elif sizeof(c_ulong) == sizeof(c_void_p):
+    c_size_t = c_ulong
+    c_ssize_t = c_long
+elif sizeof(c_ulonglong) == sizeof(c_void_p):
+    c_size_t = c_ulonglong
+    c_ssize_t = c_longlong
+
+
+SIZEOF_VOID_P = sizeof(c_void_p)
+if SIZEOF_VOID_P <= sizeof(c_int):
+    Py_intptr_t = c_int
+elif SIZEOF_VOID_P <= sizeof(c_long):
+    Py_intptr_t = c_long
+elif "c_longlong" in globals() and SIZEOF_VOID_P <= sizeof(c_longlong):
+    Py_intptr_t = c_longlong
+else:
+    raise RuntimeError("Unrecognized pointer size %i" % (SIZEOF_VOID_P,))
+
+
+class PyArrayInterface(Structure):
+    _fields_ = [
+        ("two", c_int),
+        ("nd", c_int),
+        ("typekind", c_char),
+        ("itemsize", c_int),
+        ("flags", c_int),
+        ("shape", POINTER(Py_intptr_t)),
+        ("strides", POINTER(Py_intptr_t)),
+        ("data", c_void_p),
+        ("descr", py_object),
+    ]
+
+
+PAI_Ptr = POINTER(PyArrayInterface)
+
+try:
+    PyCObject_AsVoidPtr = pythonapi.PyCObject_AsVoidPtr
+except AttributeError:
+
+    def PyCObject_AsVoidPtr(o):
+        raise TypeError("Not available")
+
+else:
+    PyCObject_AsVoidPtr.restype = c_void_p
+    PyCObject_AsVoidPtr.argtypes = [py_object]
+    PyCObject_GetDesc = pythonapi.PyCObject_GetDesc
+    PyCObject_GetDesc.restype = c_void_p
+    PyCObject_GetDesc.argtypes = [py_object]
+
+try:
+    PyCapsule_IsValid = pythonapi.PyCapsule_IsValid
+except AttributeError:
+
+    def PyCapsule_IsValid(capsule, name):
+        return 0
+
+else:
+    PyCapsule_IsValid.restype = c_int
+    PyCapsule_IsValid.argtypes = [py_object, c_char_p]
+    PyCapsule_GetPointer = pythonapi.PyCapsule_GetPointer
+    PyCapsule_GetPointer.restype = c_void_p
+    PyCapsule_GetPointer.argtypes = [py_object, c_char_p]
+    PyCapsule_GetContext = pythonapi.PyCapsule_GetContext
+    PyCapsule_GetContext.restype = c_void_p
+    PyCapsule_GetContext.argtypes = [py_object]
+
+PyCapsule_Destructor = CFUNCTYPE(None, py_object)
+PyCapsule_New = pythonapi.PyCapsule_New
+PyCapsule_New.restype = py_object
+PyCapsule_New.argtypes = [c_void_p, c_char_p, POINTER(PyCapsule_Destructor)]
+
+
+def capsule_new(p):
+    return PyCapsule_New(addressof(p), None, None)
+
+
+PAI_CONTIGUOUS = 0x01
+PAI_FORTRAN = 0x02
+PAI_ALIGNED = 0x100
+PAI_NOTSWAPPED = 0x200
+PAI_WRITEABLE = 0x400
+PAI_ARR_HAS_DESCR = 0x800
+
+
+class ArrayInterface:
+    def __init__(self, arr):
+        try:
+            self._cobj = arr.__array_struct__
+        except AttributeError:
+            raise TypeError("The array object lacks an array structure")
+        if not self._cobj:
+            raise TypeError("The array object has a NULL array structure value")
+        try:
+            vp = PyCObject_AsVoidPtr(self._cobj)
+        except TypeError:
+            if PyCapsule_IsValid(self._cobj, None):
+                vp = PyCapsule_GetPointer(self._cobj, None)
+            else:
+                raise TypeError("The array object has an invalid array structure")
+            self.desc = PyCapsule_GetContext(self._cobj)
+        else:
+            self.desc = PyCObject_GetDesc(self._cobj)
+        self._inter = cast(vp, PAI_Ptr)[0]
+
+    def __getattr__(self, name):
+        if name == "typekind":
+            return self._inter.typekind.decode("latin-1")
+        return getattr(self._inter, name)
+
+    def __str__(self):
+        if isinstance(self.desc, tuple):
+            ver = self.desc[0]
+        else:
+            ver = "N/A"
+        return (
+            "nd: %i\n"
+            "typekind: %s\n"
+            "itemsize: %i\n"
+            "flags: %s\n"
+            "shape: %s\n"
+            "strides: %s\n"
+            "ver: %s\n"
+            % (
+                self.nd,
+                self.typekind,
+                self.itemsize,
+                format_flags(self.flags),
+                format_shape(self.nd, self.shape),
+                format_strides(self.nd, self.strides),
+                ver,
+            )
+        )
+
+
+def format_flags(flags):
+    names = []
+    for flag, name in [
+        (PAI_CONTIGUOUS, "CONTIGUOUS"),
+        (PAI_FORTRAN, "FORTRAN"),
+        (PAI_ALIGNED, "ALIGNED"),
+        (PAI_NOTSWAPPED, "NOTSWAPPED"),
+        (PAI_WRITEABLE, "WRITEABLE"),
+        (PAI_ARR_HAS_DESCR, "ARR_HAS_DESCR"),
+    ]:
+        if flag & flags:
+            names.append(name)
+    return ", ".join(names)
+
+
+def format_shape(nd, shape):
+    return ", ".join([str(shape[i]) for i in range(nd)])
+
+
+def format_strides(nd, strides):
+    return ", ".join([str(strides[i]) for i in range(nd)])
+
+
+class Exporter:
+    def __init__(
+        self, shape, typekind=None, itemsize=None, strides=None, descr=None, flags=None
+    ):
+        if typekind is None:
+            typekind = "u"
+        if itemsize is None:
+            itemsize = 1
+        if flags is None:
+            flags = PAI_WRITEABLE | PAI_ALIGNED | PAI_NOTSWAPPED
+        if descr is not None:
+            flags |= PAI_ARR_HAS_DESCR
+        if len(typekind) != 1:
+            raise ValueError("Argument 'typekind' must be length 1 string")
+        nd = len(shape)
+        self.typekind = typekind
+        self.itemsize = itemsize
+        self.nd = nd
+        self.shape = tuple(shape)
+        self._shape = (c_ssize_t * self.nd)(*self.shape)
+        if strides is None:
+            self._strides = (c_ssize_t * self.nd)()
+            self._strides[self.nd - 1] = self.itemsize
+            for i in range(self.nd - 1, 0, -1):
+                self._strides[i - 1] = self.shape[i] * self._strides[i]
+            strides = tuple(self._strides)
+            self.strides = strides
+        elif len(strides) == nd:
+            self.strides = tuple(strides)
+            self._strides = (c_ssize_t * self.nd)(*self.strides)
+        else:
+            raise ValueError("Mismatch in length of strides and shape")
+        self.descr = descr
+        if self.is_contiguous("C"):
+            flags |= PAI_CONTIGUOUS
+        if self.is_contiguous("F"):
+            flags |= PAI_FORTRAN
+        self.flags = flags
+        sz = max(shape[i] * strides[i] for i in range(nd))
+        self._data = (c_ubyte * sz)()
+        self.data = addressof(self._data)
+        self._inter = PyArrayInterface(
+            2,
+            nd,
+            typekind.encode("latin_1"),
+            itemsize,
+            flags,
+            self._shape,
+            self._strides,
+            self.data,
+            descr,
+        )
+        self.len = itemsize
+        for i in range(nd):
+            self.len *= self.shape[i]
+
+    __array_struct__ = property(lambda self: capsule_new(self._inter))
+
+    def is_contiguous(self, fortran):
+        if fortran in "CA":
+            if self.strides[-1] == self.itemsize:
+                for i in range(self.nd - 1, 0, -1):
+                    if self.strides[i - 1] != self.shape[i] * self.strides[i]:
+                        break
+                else:
+                    return True
+        if fortran in "FA":
+            if self.strides[0] == self.itemsize:
+                for i in range(0, self.nd - 1):
+                    if self.strides[i + 1] != self.shape[i] * self.strides[i]:
+                        break
+                else:
+                    return True
+        return False
+
+
+class Array(Exporter):
+    _ctypes = {
+        ("u", 1): c_uint8,
+        ("u", 2): c_uint16,
+        ("u", 4): c_uint32,
+        ("u", 8): c_uint64,
+        ("i", 1): c_int8,
+        ("i", 2): c_int16,
+        ("i", 4): c_int32,
+        ("i", 8): c_int64,
+    }
+
+    def __init__(self, *args, **kwds):
+        super().__init__(*args, **kwds)
+        try:
+            if self.flags & PAI_NOTSWAPPED:
+                ct = self._ctypes[self.typekind, self.itemsize]
+            elif c_int.__ctype_le__ is c_int:
+                ct = self._ctypes[self.typekind, self.itemsize].__ctype_be__
+            else:
+                ct = self._ctypes[self.typekind, self.itemsize].__ctype_le__
+        except KeyError:
+            ct = c_uint8 * self.itemsize
+        self._ctype = ct
+        self._ctype_p = POINTER(ct)
+
+    def __getitem__(self, key):
+        return cast(self._addr_at(key), self._ctype_p)[0]
+
+    def __setitem__(self, key, value):
+        cast(self._addr_at(key), self._ctype_p)[0] = value
+
+    def _addr_at(self, key):
+        if not isinstance(key, tuple):
+            key = (key,)
+        if len(key) != self.nd:
+            raise ValueError("wrong number of indexes")
+        for i in range(self.nd):
+            if not (0 <= key[i] < self.shape[i]):
+                raise IndexError(f"index {i} out of range")
+        return self.data + sum(i * s for i, s in zip(key, self.strides))
+
+
+class ExporterTest(unittest.TestCase):
+    def test_strides(self):
+        self.check_args(0, (10,), "u", (2,), 20, 20, 2)
+        self.check_args(0, (5, 3), "u", (6, 2), 30, 30, 2)
+        self.check_args(0, (7, 3, 5), "u", (30, 10, 2), 210, 210, 2)
+        self.check_args(0, (13, 5, 11, 3), "u", (330, 66, 6, 2), 4290, 4290, 2)
+        self.check_args(3, (7, 3, 5), "i", (2, 14, 42), 210, 210, 2)
+        self.check_args(3, (7, 3, 5), "x", (2, 16, 48), 210, 240, 2)
+        self.check_args(3, (13, 5, 11, 3), "%", (440, 88, 8, 2), 4290, 5720, 2)
+        self.check_args(3, (7, 5), "-", (15, 3), 105, 105, 3)
+        self.check_args(3, (7, 5), "*", (3, 21), 105, 105, 3)
+        self.check_args(3, (7, 5), " ", (3, 24), 105, 120, 3)
+
+    def test_is_contiguous(self):
+        a = Exporter((10,), itemsize=2)
+        self.assertTrue(a.is_contiguous("C"))
+        self.assertTrue(a.is_contiguous("F"))
+        self.assertTrue(a.is_contiguous("A"))
+        a = Exporter((10, 4), itemsize=2)
+        self.assertTrue(a.is_contiguous("C"))
+        self.assertTrue(a.is_contiguous("A"))
+        self.assertFalse(a.is_contiguous("F"))
+        a = Exporter((13, 5, 11, 3), itemsize=2, strides=(330, 66, 6, 2))
+        self.assertTrue(a.is_contiguous("C"))
+        self.assertTrue(a.is_contiguous("A"))
+        self.assertFalse(a.is_contiguous("F"))
+        a = Exporter((10, 4), itemsize=2, strides=(2, 20))
+        self.assertTrue(a.is_contiguous("F"))
+        self.assertTrue(a.is_contiguous("A"))
+        self.assertFalse(a.is_contiguous("C"))
+        a = Exporter((13, 5, 11, 3), itemsize=2, strides=(2, 26, 130, 1430))
+        self.assertTrue(a.is_contiguous("F"))
+        self.assertTrue(a.is_contiguous("A"))
+        self.assertFalse(a.is_contiguous("C"))
+        a = Exporter((2, 11, 6, 4), itemsize=2, strides=(576, 48, 8, 2))
+        self.assertFalse(a.is_contiguous("A"))
+        a = Exporter((2, 11, 6, 4), itemsize=2, strides=(2, 4, 48, 288))
+        self.assertFalse(a.is_contiguous("A"))
+        a = Exporter((3, 2, 2), itemsize=2, strides=(16, 8, 4))
+        self.assertFalse(a.is_contiguous("A"))
+        a = Exporter((3, 2, 2), itemsize=2, strides=(4, 12, 24))
+        self.assertFalse(a.is_contiguous("A"))
+
+    def check_args(
+        self, call_flags, shape, typekind, strides, length, bufsize, itemsize, offset=0
+    ):
+        if call_flags & 1:
+            typekind_arg = typekind
+        else:
+            typekind_arg = None
+        if call_flags & 2:
+            strides_arg = strides
+        else:
+            strides_arg = None
+        a = Exporter(shape, itemsize=itemsize, strides=strides_arg)
+        self.assertEqual(sizeof(a._data), bufsize)
+        self.assertEqual(a.data, ctypes.addressof(a._data) + offset)
+        m = ArrayInterface(a)
+        self.assertEqual(m.data, a.data)
+        self.assertEqual(m.itemsize, itemsize)
+        self.assertEqual(tuple(m.shape[0 : m.nd]), shape)
+        self.assertEqual(tuple(m.strides[0 : m.nd]), strides)
+
+
+class ArrayTest(unittest.TestCase):
+    def __init__(self, *args, **kwds):
+        unittest.TestCase.__init__(self, *args, **kwds)
+        self.a = Array((20, 15), "i", 4)
+
+    def setUp(self):
+        # Every test starts with a zeroed array.
+        memset(self.a.data, 0, sizeof(self.a._data))
+
+    def test__addr_at(self):
+        a = self.a
+        self.assertEqual(a._addr_at((0, 0)), a.data)
+        self.assertEqual(a._addr_at((0, 1)), a.data + 4)
+        self.assertEqual(a._addr_at((1, 0)), a.data + 60)
+        self.assertEqual(a._addr_at((1, 1)), a.data + 64)
+
+    def test_indices(self):
+        a = self.a
+        self.assertEqual(a[0, 0], 0)
+        self.assertEqual(a[19, 0], 0)
+        self.assertEqual(a[0, 14], 0)
+        self.assertEqual(a[19, 14], 0)
+        self.assertEqual(a[5, 8], 0)
+        a[0, 0] = 12
+        a[5, 8] = 99
+        self.assertEqual(a[0, 0], 12)
+        self.assertEqual(a[5, 8], 99)
+        self.assertRaises(IndexError, a.__getitem__, (-1, 0))
+        self.assertRaises(IndexError, a.__getitem__, (0, -1))
+        self.assertRaises(IndexError, a.__getitem__, (20, 0))
+        self.assertRaises(IndexError, a.__getitem__, (0, 15))
+        self.assertRaises(ValueError, a.__getitem__, 0)
+        self.assertRaises(ValueError, a.__getitem__, (0, 0, 0))
+        a = Array((3,), "i", 4)
+        a[1] = 333
+        self.assertEqual(a[1], 333)
+
+    def test_typekind(self):
+        a = Array((1,), "i", 4)
+        self.assertTrue(a._ctype is c_int32)
+        self.assertTrue(a._ctype_p is POINTER(c_int32))
+        a = Array((1,), "u", 4)
+        self.assertTrue(a._ctype is c_uint32)
+        self.assertTrue(a._ctype_p is POINTER(c_uint32))
+        a = Array((1,), "f", 4)  # float types unsupported: size system dependent
+        ct = a._ctype
+        self.assertTrue(issubclass(ct, ctypes.Array))
+        self.assertEqual(sizeof(ct), 4)
+
+    def test_itemsize(self):
+        for size in [1, 2, 4, 8]:
+            a = Array((1,), "i", size)
+            ct = a._ctype
+            self.assertTrue(issubclass(ct, ctypes._SimpleCData))
+            self.assertEqual(sizeof(ct), size)
+
+    def test_oddball_itemsize(self):
+        for size in [3, 5, 6, 7, 9]:
+            a = Array((1,), "i", size)
+            ct = a._ctype
+            self.assertTrue(issubclass(ct, ctypes.Array))
+            self.assertEqual(sizeof(ct), size)
+
+    def test_byteswapped(self):
+        a = Array((1,), "u", 4, flags=(PAI_ALIGNED | PAI_WRITEABLE))
+        ct = a._ctype
+        self.assertTrue(ct is not c_uint32)
+        if sys.byteorder == "little":
+            self.assertTrue(ct is c_uint32.__ctype_be__)
+        else:
+            self.assertTrue(ct is c_uint32.__ctype_le__)
+        i = 0xA0B0C0D
+        n = c_uint32(i)
+        a[0] = i
+        self.assertEqual(a[0], i)
+        self.assertEqual(a._data[0:4], cast(addressof(n), POINTER(c_uint8))[3:-1:-1])
+
+
+if __name__ == "__main__":
+    unittest.main()
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/test_utils/async_sub.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/test_utils/async_sub.py
new file mode 100644
index 0000000..560d377
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/test_utils/async_sub.py
@@ -0,0 +1,301 @@
+################################################################################
+"""
+
+Modification of http://aspn.activestate.com/ASPN/Cookbook/Python/Recipe/440554
+
+"""
+
+#################################### IMPORTS ###################################
+
+import os
+import platform
+import subprocess
+import errno
+import time
+import sys
+import unittest
+import tempfile
+
+
+def geterror():
+    return sys.exc_info()[1]
+
+
+null_byte = "\x00".encode("ascii")
+
+if platform.system() == "Windows":
+
+    def encode(s):
+        return s.encode("ascii")
+
+    def decode(b):
+        return b.decode("ascii")
+
+    try:
+        import ctypes
+        from ctypes.wintypes import DWORD
+
+        kernel32 = ctypes.windll.kernel32
+        TerminateProcess = ctypes.windll.kernel32.TerminateProcess
+
+        def WriteFile(handle, data, ol=None):
+            c_written = DWORD()
+            success = ctypes.windll.kernel32.WriteFile(
+                handle,
+                ctypes.create_string_buffer(encode(data)),
+                len(data),
+                ctypes.byref(c_written),
+                ol,
+            )
+            return ctypes.windll.kernel32.GetLastError(), c_written.value
+
+        def ReadFile(handle, desired_bytes, ol=None):
+            c_read = DWORD()
+            buffer = ctypes.create_string_buffer(desired_bytes + 1)
+            success = ctypes.windll.kernel32.ReadFile(
+                handle, buffer, desired_bytes, ctypes.byref(c_read), ol
+            )
+            buffer[c_read.value] = null_byte
+            return ctypes.windll.kernel32.GetLastError(), decode(buffer.value)
+
+        def PeekNamedPipe(handle, desired_bytes):
+            c_avail = DWORD()
+            c_message = DWORD()
+            if desired_bytes > 0:
+                c_read = DWORD()
+                buffer = ctypes.create_string_buffer(desired_bytes + 1)
+                success = ctypes.windll.kernel32.PeekNamedPipe(
+                    handle,
+                    buffer,
+                    desired_bytes,
+                    ctypes.byref(c_read),
+                    ctypes.byref(c_avail),
+                    ctypes.byref(c_message),
+                )
+                buffer[c_read.value] = null_byte
+                return decode(buffer.value), c_avail.value, c_message.value
+            else:
+                success = ctypes.windll.kernel32.PeekNamedPipe(
+                    handle,
+                    None,
+                    desired_bytes,
+                    None,
+                    ctypes.byref(c_avail),
+                    ctypes.byref(c_message),
+                )
+                return "", c_avail.value, c_message.value
+
+    except ImportError:
+        from win32file import ReadFile, WriteFile
+        from win32pipe import PeekNamedPipe
+        from win32api import TerminateProcess
+    import msvcrt
+
+else:
+    from signal import SIGINT, SIGTERM, SIGKILL
+    import select
+    import fcntl
+
+################################### CONSTANTS ##################################
+
+PIPE = subprocess.PIPE
+
+################################################################################
+
+
+class Popen(subprocess.Popen):
+    def recv(self, maxsize=None):
+        return self._recv("stdout", maxsize)
+
+    def recv_err(self, maxsize=None):
+        return self._recv("stderr", maxsize)
+
+    def send_recv(self, input="", maxsize=None):
+        return self.send(input), self.recv(maxsize), self.recv_err(maxsize)
+
+    def read_async(self, wait=0.1, e=1, tr=5, stderr=0):
+        if tr < 1:
+            tr = 1
+        x = time.time() + wait
+        y = []
+        r = ""
+        pr = self.recv
+        if stderr:
+            pr = self.recv_err
+        while time.time() < x or r:
+            r = pr()
+            if r is None:
+                if e:
+                    raise Exception("Other end disconnected!")
+                else:
+                    break
+            elif r:
+                y.append(r)
+            else:
+                time.sleep(max((x - time.time()) / tr, 0))
+        return "".join(y)
+
+    def send_all(self, data):
+        while len(data):
+            sent = self.send(data)
+            if sent is None:
+                raise Exception("Other end disconnected!")
+            data = memoryview(data, sent)
+
+    def get_conn_maxsize(self, which, maxsize):
+        if maxsize is None:
+            maxsize = 1024
+        elif maxsize < 1:
+            maxsize = 1
+        return getattr(self, which), maxsize
+
+    def _close(self, which):
+        getattr(self, which).close()
+        setattr(self, which, None)
+
+    if platform.system() == "Windows":
+
+        def kill(self):
+            # Recipes
+            # http://me.in-berlin.de/doc/python/faq/windows.html#how-do-i-emulate-os-kill-in-windows
+            # http://aspn.activestate.com/ASPN/Cookbook/Python/Recipe/347462
+
+            """kill function for Win32"""
+            TerminateProcess(int(self._handle), 0)  # returns None
+
+        def send(self, input):
+            if not self.stdin:
+                return None
+
+            try:
+                x = msvcrt.get_osfhandle(self.stdin.fileno())
+                (errCode, written) = WriteFile(x, input)
+            except ValueError:
+                return self._close("stdin")
+            except (subprocess.pywintypes.error, Exception):
+                if geterror()[0] in (109, errno.ESHUTDOWN):
+                    return self._close("stdin")
+                raise
+
+            return written
+
+        def _recv(self, which, maxsize):
+            conn, maxsize = self.get_conn_maxsize(which, maxsize)
+            if conn is None:
+                return None
+
+            try:
+                x = msvcrt.get_osfhandle(conn.fileno())
+                (read, nAvail, nMessage) = PeekNamedPipe(x, 0)
+                if maxsize < nAvail:
+                    nAvail = maxsize
+                if nAvail > 0:
+                    (errCode, read) = ReadFile(x, nAvail, None)
+            except ValueError:
+                return self._close(which)
+            except (subprocess.pywintypes.error, Exception):
+                if geterror()[0] in (109, errno.ESHUTDOWN):
+                    return self._close(which)
+                raise
+
+            if self.universal_newlines:
+                # Translate newlines. For Python 3.x assume read is text.
+                # If bytes then another solution is needed.
+                read = read.replace("\r\n", "\n").replace("\r", "\n")
+            return read
+
+    else:
+
+        def kill(self):
+            for i, sig in enumerate([SIGTERM, SIGKILL] * 2):
+                if i % 2 == 0:
+                    os.kill(self.pid, sig)
+                time.sleep((i * (i % 2) / 5.0) + 0.01)
+
+                killed_pid, stat = os.waitpid(self.pid, os.WNOHANG)
+                if killed_pid != 0:
+                    return
+
+        def send(self, input):
+            if not self.stdin:
+                return None
+
+            if not select.select([], [self.stdin], [], 0)[1]:
+                return 0
+
+            try:
+                written = os.write(self.stdin.fileno(), input)
+            except OSError:
+                if geterror()[0] == errno.EPIPE:  # broken pipe
+                    return self._close("stdin")
+                raise
+
+            return written
+
+        def _recv(self, which, maxsize):
+            conn, maxsize = self.get_conn_maxsize(which, maxsize)
+            if conn is None:
+                return None
+
+            if not select.select([conn], [], [], 0)[0]:
+                return ""
+
+            r = conn.read(maxsize)
+            if not r:
+                return self._close(which)
+
+            if self.universal_newlines:
+                r = r.replace("\r\n", "\n").replace("\r", "\n")
+            return r
+
+
+################################################################################
+
+
+def proc_in_time_or_kill(cmd, time_out, wd=None, env=None):
+    proc = Popen(
+        cmd,
+        cwd=wd,
+        env=env,
+        stdin=subprocess.PIPE,
+        stdout=subprocess.PIPE,
+        stderr=subprocess.STDOUT,
+        universal_newlines=1,
+    )
+
+    ret_code = None
+    response = []
+
+    t = time.time()
+    while ret_code is None and ((time.time() - t) < time_out):
+        ret_code = proc.poll()
+        response += [proc.read_async(wait=0.1, e=0)]
+
+    if ret_code is None:
+        ret_code = f'"Process timed out (time_out = {time_out} secs) '
+        try:
+            proc.kill()
+            ret_code += 'and was successfully terminated"'
+        except Exception:
+            ret_code += f'and termination failed (exception: {geterror()})"'
+
+    return ret_code, "".join(response)
+
+
+################################################################################
+
+
+class AsyncTest(unittest.TestCase):
+    def test_proc_in_time_or_kill(self):
+        ret_code, response = proc_in_time_or_kill(
+            [sys.executable, "-c", "while True: pass"], time_out=1
+        )
+
+        self.assertIn("rocess timed out", ret_code)
+        self.assertIn("successfully terminated", ret_code)
+
+
+################################################################################
+
+if __name__ == "__main__":
+    unittest.main()
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/test_utils/buftools.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/test_utils/buftools.py
new file mode 100644
index 0000000..de1f316
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/test_utils/buftools.py
@@ -0,0 +1,607 @@
+"""Module pygame.tests.test_utils.array
+
+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.
+
+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 simular Python builtin memoryview currently
+does not support configurable PyBUF_* flags.
+
+This module contains its own unit tests. When Pygame is installed, these tests
+can be run with the following command line statement:
+
+python -m pygame.tests.test_utils.array
+
+"""
+
+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_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_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:
+    ctypes.c_ssize_t
+except AttributeError:
+    void_p_sz = ctypes.sizeof(ctypes.c_void_p)
+    if ctypes.sizeof(ctypes.c_short) == void_p_sz:
+        ctypes.c_ssize_t = ctypes.c_short
+    elif ctypes.sizeof(ctypes.c_int) == void_p_sz:
+        ctypes.c_ssize_t = ctypes.c_int
+    elif ctypes.sizeof(ctypes.c_long) == void_p_sz:
+        ctypes.c_ssize_t = ctypes.c_long
+    elif ctypes.sizeof(ctypes.c_longlong) == void_p_sz:
+        ctypes.c_ssize_t = ctypes.c_longlong
+    else:
+        raise RuntimeError("Cannot set c_ssize_t: sizeof(void *) is %i" % void_p_sz)
+
+
+def _prop_get(fn):
+    return property(fn)
+
+
+class Exporter(pygame.newbuffer.BufferMixin):
+    """An object that exports a multi-dimension new buffer interface
+
+    The only array operation this type supports is to export a buffer.
+    """
+
+    prefixes = {
+        "@": "",
+        "=": "=",
+        "<": "=",
+        ">": "=",
+        "!": "=",
+        "2": "2",
+        "3": "3",
+        "4": "4",
+        "5": "5",
+        "6": "6",
+        "7": "7",
+        "8": "8",
+        "9": "9",
+    }
+    types = {
+        "c": ctypes.c_char,
+        "b": ctypes.c_byte,
+        "B": ctypes.c_ubyte,
+        "=c": ctypes.c_int8,
+        "=b": ctypes.c_int8,
+        "=B": ctypes.c_uint8,
+        "?": ctypes.c_bool,
+        "=?": ctypes.c_int8,
+        "h": ctypes.c_short,
+        "H": ctypes.c_ushort,
+        "=h": ctypes.c_int16,
+        "=H": ctypes.c_uint16,
+        "i": ctypes.c_int,
+        "I": ctypes.c_uint,
+        "=i": ctypes.c_int32,
+        "=I": ctypes.c_uint32,
+        "l": ctypes.c_long,
+        "L": ctypes.c_ulong,
+        "=l": ctypes.c_int32,
+        "=L": ctypes.c_uint32,
+        "q": ctypes.c_longlong,
+        "Q": ctypes.c_ulonglong,
+        "=q": ctypes.c_int64,
+        "=Q": ctypes.c_uint64,
+        "f": ctypes.c_float,
+        "d": ctypes.c_double,
+        "P": ctypes.c_void_p,
+        "x": ctypes.c_ubyte * 1,
+        "2x": ctypes.c_ubyte * 2,
+        "3x": ctypes.c_ubyte * 3,
+        "4x": ctypes.c_ubyte * 4,
+        "5x": ctypes.c_ubyte * 5,
+        "6x": ctypes.c_ubyte * 6,
+        "7x": ctypes.c_ubyte * 7,
+        "8x": ctypes.c_ubyte * 8,
+        "9x": ctypes.c_ubyte * 9,
+    }
+
+    def __init__(self, shape, format=None, strides=None, readonly=None, itemsize=None):
+        if format is None:
+            format = "B"
+        if readonly is None:
+            readonly = False
+        prefix = ""
+        typecode = ""
+        i = 0
+        if i < len(format):
+            try:
+                prefix = self.prefixes[format[i]]
+                i += 1
+            except LookupError:
+                pass
+        if i < len(format) and format[i] == "1":
+            i += 1
+        if i == len(format) - 1:
+            typecode = format[i]
+        if itemsize is None:
+            try:
+                itemsize = ctypes.sizeof(self.types[prefix + typecode])
+            except KeyError:
+                raise ValueError("Unknown item format '" + format + "'")
+        self.readonly = bool(readonly)
+        self.format = format
+        self._format = ctypes.create_string_buffer(format.encode("latin_1"))
+        self.ndim = len(shape)
+        self.itemsize = itemsize
+        self.len = reduce(operator.mul, shape, 1) * self.itemsize
+        self.shape = tuple(shape)
+        self._shape = (ctypes.c_ssize_t * self.ndim)(*self.shape)
+        if strides is None:
+            self._strides = (ctypes.c_ssize_t * self.ndim)()
+            self._strides[self.ndim - 1] = itemsize
+            for i in range(self.ndim - 1, 0, -1):
+                self._strides[i - 1] = self.shape[i] * self._strides[i]
+            self.strides = tuple(self._strides)
+        elif len(strides) == self.ndim:
+            self.strides = tuple(strides)
+            self._strides = (ctypes.c_ssize_t * self.ndim)(*self.strides)
+        else:
+            raise ValueError("Mismatch in length of strides and shape")
+        buflen = max(d * abs(s) for d, s in zip(self.shape, self.strides))
+        self.buflen = buflen
+        self._buf = (ctypes.c_ubyte * buflen)()
+        offset = sum(
+            (d - 1) * abs(s) for d, s in zip(self.shape, self.strides) if s < 0
+        )
+        self.buf = ctypes.addressof(self._buf) + offset
+
+    def buffer_info(self):
+        return (ctypes.addressof(self.buffer), self.shape[0])
+
+    def tobytes(self):
+        return ctypes.cast(self.buffer, ctypes.POINTER(ctypes.c_char))[0 : self._len]
+
+    def __len__(self):
+        return self.shape[0]
+
+    def _get_buffer(self, view, flags):
+        from ctypes import addressof
+
+        if (flags & PyBUF_WRITABLE) == PyBUF_WRITABLE and self.readonly:
+            raise BufferError("buffer is read-only")
+        if (
+            flags & PyBUF_C_CONTIGUOUS
+        ) == PyBUF_C_CONTIGUOUS and not self.is_contiguous("C"):
+            raise BufferError("data is not C contiguous")
+        if (
+            flags & PyBUF_F_CONTIGUOUS
+        ) == PyBUF_F_CONTIGUOUS and not self.is_contiguous("F"):
+            raise BufferError("data is not F contiguous")
+        if (
+            flags & PyBUF_ANY_CONTIGUOUS
+        ) == PyBUF_ANY_CONTIGUOUS and not self.is_contiguous("A"):
+            raise BufferError("data is not contiguous")
+        view.buf = self.buf
+        view.readonly = self.readonly
+        view.len = self.len
+        if flags | PyBUF_WRITABLE == PyBUF_WRITABLE:
+            view.ndim = 0
+        else:
+            view.ndim = self.ndim
+        view.itemsize = self.itemsize
+        if (flags & PyBUF_FORMAT) == PyBUF_FORMAT:
+            view.format = addressof(self._format)
+        else:
+            view.format = None
+        if (flags & PyBUF_ND) == PyBUF_ND:
+            view.shape = addressof(self._shape)
+        elif self.is_contiguous("C"):
+            view.shape = None
+        else:
+            raise BufferError(f"shape required for {self.ndim} dimensional data")
+        if (flags & PyBUF_STRIDES) == PyBUF_STRIDES:
+            view.strides = ctypes.addressof(self._strides)
+        elif view.shape is None or self.is_contiguous("C"):
+            view.strides = None
+        else:
+            raise BufferError("strides required for none C contiguous data")
+        view.suboffsets = None
+        view.internal = None
+        view.obj = self
+
+    def is_contiguous(self, fortran):
+        if fortran in "CA":
+            if self.strides[-1] == self.itemsize:
+                for i in range(self.ndim - 1, 0, -1):
+                    if self.strides[i - 1] != self.shape[i] * self.strides[i]:
+                        break
+                else:
+                    return True
+        if fortran in "FA":
+            if self.strides[0] == self.itemsize:
+                for i in range(0, self.ndim - 1):
+                    if self.strides[i + 1] != self.shape[i] * self.strides[i]:
+                        break
+                else:
+                    return True
+        return False
+
+
+class Importer:
+    """An object that imports a new buffer interface
+
+    The fields of the Py_buffer C struct are exposed by identically
+    named Importer read-only properties.
+    """
+
+    def __init__(self, obj, flags):
+        self._view = pygame.newbuffer.Py_buffer()
+        self._view.get_buffer(obj, flags)
+
+    @property
+    def obj(self):
+        """return object or None for NULL field"""
+        return self._view.obj
+
+    @property
+    def buf(self):
+        """return int or None for NULL field"""
+        return self._view.buf
+
+    @property
+    def len(self):
+        """return int"""
+        return self._view.len
+
+    @property
+    def readonly(self):
+        """return bool"""
+        return self._view.readonly
+
+    @property
+    def format(self):
+        """return bytes or None for NULL field"""
+        format_addr = self._view.format
+        if format_addr is None:
+            return None
+        return ctypes.cast(format_addr, ctypes.c_char_p).value.decode("ascii")
+
+    @property
+    def itemsize(self):
+        """return int"""
+        return self._view.itemsize
+
+    @property
+    def ndim(self):
+        """return int"""
+        return self._view.ndim
+
+    @property
+    def shape(self):
+        """return int tuple or None for NULL field"""
+        return self._to_ssize_tuple(self._view.shape)
+
+    @property
+    def strides(self):
+        """return int tuple or None for NULL field"""
+        return self._to_ssize_tuple(self._view.strides)
+
+    @property
+    def suboffsets(self):
+        """return int tuple or None for NULL field"""
+        return self._to_ssize_tuple(self._view.suboffsets)
+
+    @property
+    def internal(self):
+        """return int or None for NULL field"""
+        return self._view.internal
+
+    def _to_ssize_tuple(self, addr):
+        from ctypes import cast, POINTER, c_ssize_t
+
+        if addr is None:
+            return None
+        return tuple(cast(addr, POINTER(c_ssize_t))[0 : self._view.ndim])
+
+
+class ExporterTest(unittest.TestCase):
+    """Class Exporter unit tests"""
+
+    def test_formats(self):
+        char_sz = ctypes.sizeof(ctypes.c_char)
+        short_sz = ctypes.sizeof(ctypes.c_short)
+        int_sz = ctypes.sizeof(ctypes.c_int)
+        long_sz = ctypes.sizeof(ctypes.c_long)
+        longlong_sz = ctypes.sizeof(ctypes.c_longlong)
+        float_sz = ctypes.sizeof(ctypes.c_float)
+        double_sz = ctypes.sizeof(ctypes.c_double)
+        voidp_sz = ctypes.sizeof(ctypes.c_void_p)
+        bool_sz = ctypes.sizeof(ctypes.c_bool)
+
+        self.check_args(0, (1,), "B", (1,), 1, 1, 1)
+        self.check_args(1, (1,), "b", (1,), 1, 1, 1)
+        self.check_args(1, (1,), "B", (1,), 1, 1, 1)
+        self.check_args(1, (1,), "c", (char_sz,), char_sz, char_sz, char_sz)
+        self.check_args(1, (1,), "h", (short_sz,), short_sz, short_sz, short_sz)
+        self.check_args(1, (1,), "H", (short_sz,), short_sz, short_sz, short_sz)
+        self.check_args(1, (1,), "i", (int_sz,), int_sz, int_sz, int_sz)
+        self.check_args(1, (1,), "I", (int_sz,), int_sz, int_sz, int_sz)
+        self.check_args(1, (1,), "l", (long_sz,), long_sz, long_sz, long_sz)
+        self.check_args(1, (1,), "L", (long_sz,), long_sz, long_sz, long_sz)
+        self.check_args(
+            1, (1,), "q", (longlong_sz,), longlong_sz, longlong_sz, longlong_sz
+        )
+        self.check_args(
+            1, (1,), "Q", (longlong_sz,), longlong_sz, longlong_sz, longlong_sz
+        )
+        self.check_args(1, (1,), "f", (float_sz,), float_sz, float_sz, float_sz)
+        self.check_args(1, (1,), "d", (double_sz,), double_sz, double_sz, double_sz)
+        self.check_args(1, (1,), "x", (1,), 1, 1, 1)
+        self.check_args(1, (1,), "P", (voidp_sz,), voidp_sz, voidp_sz, voidp_sz)
+        self.check_args(1, (1,), "?", (bool_sz,), bool_sz, bool_sz, bool_sz)
+        self.check_args(1, (1,), "@b", (1,), 1, 1, 1)
+        self.check_args(1, (1,), "@B", (1,), 1, 1, 1)
+        self.check_args(1, (1,), "@c", (char_sz,), char_sz, char_sz, char_sz)
+        self.check_args(1, (1,), "@h", (short_sz,), short_sz, short_sz, short_sz)
+        self.check_args(1, (1,), "@H", (short_sz,), short_sz, short_sz, short_sz)
+        self.check_args(1, (1,), "@i", (int_sz,), int_sz, int_sz, int_sz)
+        self.check_args(1, (1,), "@I", (int_sz,), int_sz, int_sz, int_sz)
+        self.check_args(1, (1,), "@l", (long_sz,), long_sz, long_sz, long_sz)
+        self.check_args(1, (1,), "@L", (long_sz,), long_sz, long_sz, long_sz)
+        self.check_args(
+            1, (1,), "@q", (longlong_sz,), longlong_sz, longlong_sz, longlong_sz
+        )
+        self.check_args(
+            1, (1,), "@Q", (longlong_sz,), longlong_sz, longlong_sz, longlong_sz
+        )
+        self.check_args(1, (1,), "@f", (float_sz,), float_sz, float_sz, float_sz)
+        self.check_args(1, (1,), "@d", (double_sz,), double_sz, double_sz, double_sz)
+        self.check_args(1, (1,), "@?", (bool_sz,), bool_sz, bool_sz, bool_sz)
+        self.check_args(1, (1,), "=b", (1,), 1, 1, 1)
+        self.check_args(1, (1,), "=B", (1,), 1, 1, 1)
+        self.check_args(1, (1,), "=c", (1,), 1, 1, 1)
+        self.check_args(1, (1,), "=h", (2,), 2, 2, 2)
+        self.check_args(1, (1,), "=H", (2,), 2, 2, 2)
+        self.check_args(1, (1,), "=i", (4,), 4, 4, 4)
+        self.check_args(1, (1,), "=I", (4,), 4, 4, 4)
+        self.check_args(1, (1,), "=l", (4,), 4, 4, 4)
+        self.check_args(1, (1,), "=L", (4,), 4, 4, 4)
+        self.check_args(1, (1,), "=q", (8,), 8, 8, 8)
+        self.check_args(1, (1,), "=Q", (8,), 8, 8, 8)
+        self.check_args(1, (1,), "=?", (1,), 1, 1, 1)
+        self.check_args(1, (1,), "h", (2,), 2, 2, 2)
+        self.check_args(1, (1,), "!h", (2,), 2, 2, 2)
+        self.check_args(1, (1,), "q", (8,), 8, 8, 8)
+        self.check_args(1, (1,), "!q", (8,), 8, 8, 8)
+        self.check_args(1, (1,), "1x", (1,), 1, 1, 1)
+        self.check_args(1, (1,), "2x", (2,), 2, 2, 2)
+        self.check_args(1, (1,), "3x", (3,), 3, 3, 3)
+        self.check_args(1, (1,), "4x", (4,), 4, 4, 4)
+        self.check_args(1, (1,), "5x", (5,), 5, 5, 5)
+        self.check_args(1, (1,), "6x", (6,), 6, 6, 6)
+        self.check_args(1, (1,), "7x", (7,), 7, 7, 7)
+        self.check_args(1, (1,), "8x", (8,), 8, 8, 8)
+        self.check_args(1, (1,), "9x", (9,), 9, 9, 9)
+        self.check_args(1, (1,), "1h", (2,), 2, 2, 2)
+        self.check_args(1, (1,), "=1h", (2,), 2, 2, 2)
+        self.assertRaises(ValueError, Exporter, (2, 1), "")
+        self.assertRaises(ValueError, Exporter, (2, 1), "W")
+        self.assertRaises(ValueError, Exporter, (2, 1), "^Q")
+        self.assertRaises(ValueError, Exporter, (2, 1), "=W")
+        self.assertRaises(ValueError, Exporter, (2, 1), "=f")
+        self.assertRaises(ValueError, Exporter, (2, 1), "=d")
+        self.assertRaises(ValueError, Exporter, (2, 1), "f")
+        self.assertRaises(ValueError, Exporter, (2, 1), ">d")
+        self.assertRaises(ValueError, Exporter, (2, 1), "!f")
+        self.assertRaises(ValueError, Exporter, (2, 1), "!d")
+        self.assertRaises(ValueError, Exporter, (2, 1), "0x")
+        self.assertRaises(ValueError, Exporter, (2, 1), "11x")
+        self.assertRaises(ValueError, Exporter, (2, 1), "BB")
+
+    def test_strides(self):
+        self.check_args(1, (10,), "=h", (2,), 20, 20, 2)
+        self.check_args(1, (5, 3), "=h", (6, 2), 30, 30, 2)
+        self.check_args(1, (7, 3, 5), "=h", (30, 10, 2), 210, 210, 2)
+        self.check_args(1, (13, 5, 11, 3), "=h", (330, 66, 6, 2), 4290, 4290, 2)
+        self.check_args(3, (7, 3, 5), "=h", (2, 14, 42), 210, 210, 2)
+        self.check_args(3, (7, 3, 5), "=h", (2, 16, 48), 210, 240, 2)
+        self.check_args(3, (13, 5, 11, 3), "=h", (440, 88, 8, 2), 4290, 5720, 2)
+        self.check_args(3, (7, 5), "3x", (15, 3), 105, 105, 3)
+        self.check_args(3, (7, 5), "3x", (3, 21), 105, 105, 3)
+        self.check_args(3, (7, 5), "3x", (3, 24), 105, 120, 3)
+
+    def test_readonly(self):
+        a = Exporter((2,), "h", readonly=True)
+        self.assertTrue(a.readonly)
+        b = Importer(a, PyBUF_STRIDED_RO)
+        self.assertRaises(BufferError, Importer, a, PyBUF_STRIDED)
+        b = Importer(a, PyBUF_STRIDED_RO)
+
+    def test_is_contiguous(self):
+        a = Exporter((10,), "=h")
+        self.assertTrue(a.is_contiguous("C"))
+        self.assertTrue(a.is_contiguous("F"))
+        self.assertTrue(a.is_contiguous("A"))
+        a = Exporter((10, 4), "=h")
+        self.assertTrue(a.is_contiguous("C"))
+        self.assertTrue(a.is_contiguous("A"))
+        self.assertFalse(a.is_contiguous("F"))
+        a = Exporter((13, 5, 11, 3), "=h", (330, 66, 6, 2))
+        self.assertTrue(a.is_contiguous("C"))
+        self.assertTrue(a.is_contiguous("A"))
+        self.assertFalse(a.is_contiguous("F"))
+        a = Exporter((10, 4), "=h", (2, 20))
+        self.assertTrue(a.is_contiguous("F"))
+        self.assertTrue(a.is_contiguous("A"))
+        self.assertFalse(a.is_contiguous("C"))
+        a = Exporter((13, 5, 11, 3), "=h", (2, 26, 130, 1430))
+        self.assertTrue(a.is_contiguous("F"))
+        self.assertTrue(a.is_contiguous("A"))
+        self.assertFalse(a.is_contiguous("C"))
+        a = Exporter((2, 11, 6, 4), "=h", (576, 48, 8, 2))
+        self.assertFalse(a.is_contiguous("A"))
+        a = Exporter((2, 11, 6, 4), "=h", (2, 4, 48, 288))
+        self.assertFalse(a.is_contiguous("A"))
+        a = Exporter((3, 2, 2), "=h", (16, 8, 4))
+        self.assertFalse(a.is_contiguous("A"))
+        a = Exporter((3, 2, 2), "=h", (4, 12, 24))
+        self.assertFalse(a.is_contiguous("A"))
+
+    def test_PyBUF_flags(self):
+        a = Exporter((10, 2), "d")
+        b = Importer(a, PyBUF_SIMPLE)
+        self.assertTrue(b.obj is a)
+        self.assertTrue(b.format is None)
+        self.assertEqual(b.len, a.len)
+        self.assertEqual(b.itemsize, a.itemsize)
+        self.assertTrue(b.shape is None)
+        self.assertTrue(b.strides is None)
+        self.assertTrue(b.suboffsets is None)
+        self.assertTrue(b.internal is None)
+        self.assertFalse(b.readonly)
+        b = Importer(a, PyBUF_WRITABLE)
+        self.assertTrue(b.obj is a)
+        self.assertTrue(b.format is None)
+        self.assertEqual(b.len, a.len)
+        self.assertEqual(b.itemsize, a.itemsize)
+        self.assertTrue(b.shape is None)
+        self.assertTrue(b.strides is None)
+        self.assertTrue(b.suboffsets is None)
+        self.assertTrue(b.internal is None)
+        self.assertFalse(b.readonly)
+        b = Importer(a, PyBUF_ND)
+        self.assertTrue(b.obj is a)
+        self.assertTrue(b.format is None)
+        self.assertEqual(b.len, a.len)
+        self.assertEqual(b.itemsize, a.itemsize)
+        self.assertEqual(b.shape, a.shape)
+        self.assertTrue(b.strides is None)
+        self.assertTrue(b.suboffsets is None)
+        self.assertTrue(b.internal is None)
+        self.assertFalse(b.readonly)
+        a = Exporter((5, 10), "=h", (24, 2))
+        b = Importer(a, PyBUF_STRIDES)
+        self.assertTrue(b.obj is a)
+        self.assertTrue(b.format is None)
+        self.assertEqual(b.len, a.len)
+        self.assertEqual(b.itemsize, a.itemsize)
+        self.assertEqual(b.shape, a.shape)
+        self.assertEqual(b.strides, a.strides)
+        self.assertTrue(b.suboffsets is None)
+        self.assertTrue(b.internal is None)
+        self.assertFalse(b.readonly)
+        b = Importer(a, PyBUF_FULL)
+        self.assertTrue(b.obj is a)
+        self.assertEqual(b.format, "=h")
+        self.assertEqual(b.len, a.len)
+        self.assertEqual(b.itemsize, a.itemsize)
+        self.assertEqual(b.shape, a.shape)
+        self.assertEqual(b.strides, a.strides)
+        self.assertTrue(b.suboffsets is None)
+        self.assertTrue(b.internal is None)
+        self.assertFalse(b.readonly)
+        self.assertRaises(BufferError, Importer, a, PyBUF_SIMPLE)
+        self.assertRaises(BufferError, Importer, a, PyBUF_WRITABLE)
+        self.assertRaises(BufferError, Importer, a, PyBUF_ND)
+        self.assertRaises(BufferError, Importer, a, PyBUF_C_CONTIGUOUS)
+        self.assertRaises(BufferError, Importer, a, PyBUF_F_CONTIGUOUS)
+        self.assertRaises(BufferError, Importer, a, PyBUF_ANY_CONTIGUOUS)
+        self.assertRaises(BufferError, Importer, a, PyBUF_CONTIG)
+
+    def test_negative_strides(self):
+        self.check_args(3, (3, 5, 4), "B", (20, 4, -1), 60, 60, 1, 3)
+        self.check_args(3, (3, 5, 3), "B", (20, 4, -1), 45, 60, 1, 2)
+        self.check_args(3, (3, 5, 4), "B", (20, -4, 1), 60, 60, 1, 16)
+        self.check_args(3, (3, 5, 4), "B", (-20, -4, -1), 60, 60, 1, 59)
+        self.check_args(3, (3, 5, 3), "B", (-20, -4, -1), 45, 60, 1, 58)
+
+    def test_attributes(self):
+        a = Exporter((13, 5, 11, 3), "=h", (440, 88, 8, 2))
+        self.assertEqual(a.ndim, 4)
+        self.assertEqual(a.itemsize, 2)
+        self.assertFalse(a.readonly)
+        self.assertEqual(a.shape, (13, 5, 11, 3))
+        self.assertEqual(a.format, "=h")
+        self.assertEqual(a.strides, (440, 88, 8, 2))
+        self.assertEqual(a.len, 4290)
+        self.assertEqual(a.buflen, 5720)
+        self.assertEqual(a.buf, ctypes.addressof(a._buf))
+        a = Exporter((8,))
+        self.assertEqual(a.ndim, 1)
+        self.assertEqual(a.itemsize, 1)
+        self.assertFalse(a.readonly)
+        self.assertEqual(a.shape, (8,))
+        self.assertEqual(a.format, "B")
+        self.assertTrue(isinstance(a.strides, tuple))
+        self.assertEqual(a.strides, (1,))
+        self.assertEqual(a.len, 8)
+        self.assertEqual(a.buflen, 8)
+        a = Exporter([13, 5, 11, 3], "=h", [440, 88, 8, 2])
+        self.assertTrue(isinstance(a.shape, tuple))
+        self.assertTrue(isinstance(a.strides, tuple))
+        self.assertEqual(a.shape, (13, 5, 11, 3))
+        self.assertEqual(a.strides, (440, 88, 8, 2))
+
+    def test_itemsize(self):
+        exp = Exporter((4, 5), format="B", itemsize=8)
+        imp = Importer(exp, PyBUF_RECORDS)
+        self.assertEqual(imp.itemsize, 8)
+        self.assertEqual(imp.format, "B")
+        self.assertEqual(imp.strides, (40, 8))
+        exp = Exporter((4, 5), format="weird", itemsize=5)
+        imp = Importer(exp, PyBUF_RECORDS)
+        self.assertEqual(imp.itemsize, 5)
+        self.assertEqual(imp.format, "weird")
+        self.assertEqual(imp.strides, (25, 5))
+
+    def check_args(
+        self, call_flags, shape, format, strides, length, bufsize, itemsize, offset=0
+    ):
+        format_arg = format if call_flags & 1 else None
+        strides_arg = strides if call_flags & 2 else None
+        a = Exporter(shape, format_arg, strides_arg)
+        self.assertEqual(a.buflen, bufsize)
+        self.assertEqual(a.buf, ctypes.addressof(a._buf) + offset)
+        m = Importer(a, PyBUF_RECORDS_RO)
+        self.assertEqual(m.buf, a.buf)
+        self.assertEqual(m.len, length)
+        self.assertEqual(m.format, format)
+        self.assertEqual(m.itemsize, itemsize)
+        self.assertEqual(m.shape, shape)
+        self.assertEqual(m.strides, strides)
+
+
+if __name__ == "__main__":
+    unittest.main()
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/test_utils/endian.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/test_utils/endian.py
new file mode 100644
index 0000000..64ba1b3
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/test_utils/endian.py
@@ -0,0 +1,20 @@
+# Module pygame.tests.test_utils.endian
+#
+# Machine independent conversion to little-endian and big-endian Python
+# integer values.
+
+import struct
+
+
+def little_endian_uint32(i):
+    """Return the 32 bit unsigned integer little-endian representation of i"""
+
+    s = struct.pack("I", i)
+    return struct.unpack("=I", s)[0]
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/test_utils/png.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/test_utils/png.py
new file mode 100644
index 0000000..5d055ea
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/test_utils/png.py
@@ -0,0 +1,4005 @@
+#!/usr/bin/env python
+
+# $URL: http://pypng.googlecode.com/svn/trunk/code/png.py $
+# $Rev: 228 $
+
+# png.py - PNG encoder/decoder in pure Python
+#
+# Modified for Pygame in Oct., 2012 to work with Python 3.x.
+#
+# Copyright (C) 2006 Johann C. Rocholl 
+# Portions Copyright (C) 2009 David Jones 
+# And probably portions Copyright (C) 2006 Nicko van Someren 
+#
+# Original concept by Johann C. Rocholl.
+#
+# LICENSE (The MIT License)
+#
+# 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.
+#
+# Changelog (recent first):
+# 2009-03-11 David: interlaced bit depth < 8 (writing).
+# 2009-03-10 David: interlaced bit depth < 8 (reading).
+# 2009-03-04 David: Flat and Boxed pixel formats.
+# 2009-02-26 David: Palette support (writing).
+# 2009-02-23 David: Bit-depths < 8; better PNM support.
+# 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, 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.
+
+# Incorporated into Bangai-O Development Tools by drj on 2009-02-11 from
+# http://trac.browsershots.org/browser/trunk/pypng/lib/png.py?rev=2885
+
+# Incorporated into pypng by drj on 2009-03-12 from
+# //depot/prj/bangaio/master/code/png.py#67
+
+
+"""
+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 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``.
+
+For help, type ``import png; help(png)`` in your python interpreter.
+
+A good place to start is the :class:`Reader` and :class:`Writer` classes.
+
+This file can also be used as a command-line utility to convert
+`Netpbm `_ PNM files to PNG, and the reverse conversion from PNG to
+PNM. The interface is similar to that of the ``pnmtopng`` program from
+Netpbm.  Type ``python png.py --help`` at the shell prompt
+for usage and a list of options.
+
+A note on spelling and terminology
+----------------------------------
+
+Generally British English spelling is used in the documentation.  So
+that's "greyscale" and "colour".  This not only matches the author's
+native language, it's also used by the PNG specification.
+
+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 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).
+
+A note on formats
+-----------------
+
+When getting pixel data out of this module (reading) and presenting
+data to this module (writing) there are a number of ways the data could
+be represented as a Python value.  Generally this module uses one of
+three formats called "flat row flat pixel", "boxed row flat pixel", and
+"boxed row boxed pixel".  Basically the concern is whether each pixel
+and each row comes in its own little tuple (box), or not.
+
+Consider an image that is 3 pixels wide by 2 pixels high, and each pixel
+has RGB components:
+
+Boxed row flat pixel::
+
+  list([R,G,B, R,G,B, R,G,B],
+       [R,G,B, R,G,B, R,G,B])
+
+Each row appears as its own list, but the pixels are flattened so that
+three values for one pixel simply follow the three values for the previous
+pixel.  This is the most common format used, because it provides a good
+compromise between space and convenience.  PyPNG regards itself as
+at liberty to replace any sequence type with any sufficiently compatible
+other sequence type; in practice each row is an array (from the array
+module), and the outer list is sometimes an iterator rather than an
+explicit list (so that streaming is possible).
+
+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 colour values.
+Generally an array will be used (to save space), not a list.
+
+Boxed row boxed pixel::
+
+  list([ (R,G,B), (R,G,B), (R,G,B) ],
+       [ (R,G,B), (R,G,B), (R,G,B) ])
+
+Each row appears in its own list, but each pixel also appears in its own
+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 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
+from the public API.  This format is called packed.  When packed,
+each row is a sequence of bytes (integers from 0 to 255), just as
+it is before PNG scanline filtering is applied.  When the bit depth
+is 8 this is essentially the same as boxed row flat pixel; when the
+bit depth is less than 8, several pixels are packed into each byte;
+when the bit depth is 16 (the only value more than 8 that is supported
+by the PNG image format) each pixel value is decomposed into 2 bytes
+(and `packed` is a misnomer).  This format is used by the
+:meth:`Writer.write_packed` method.  It isn't usually a convenient
+format, but may be just right if the source data for the PNG image
+comes from something that uses a similar format (for example, 1-bit
+BMPs, or another PNG file).
+
+And now, my famous members
+--------------------------
+"""
+
+__version__ = "$URL: http://pypng.googlecode.com/svn/trunk/code/png.py $ $Rev: 228 $"
+
+import io
+import itertools
+import math
+import operator
+import struct
+import sys
+import zlib
+import warnings
+from array import array
+from functools import reduce
+
+from pygame.tests.test_utils import tostring
+
+__all__ = ["Image", "Reader", "Writer", "write_chunks", "from_array"]
+
+
+# The PNG signature.
+# http://www.w3.org/TR/PNG/#5PNG-file-signature
+_signature = struct.pack("8B", 137, 80, 78, 71, 13, 10, 26, 10)
+
+_adam7 = (
+    (0, 0, 8, 8),
+    (4, 0, 8, 8),
+    (0, 4, 4, 8),
+    (2, 0, 4, 4),
+    (0, 2, 2, 4),
+    (1, 0, 2, 2),
+    (0, 1, 1, 2),
+)
+
+
+def group(s, n):
+    # See
+    # http://www.python.org/doc/2.6/library/functions.html#zip
+    return zip(*[iter(s)] * n)
+
+
+def isarray(x):
+    """Same as ``isinstance(x, array)``."""
+    return isinstance(x, array)
+
+
+# Conditionally convert to bytes.  Works on Python 2 and Python 3.
+try:
+    bytes("", "ascii")
+
+    def strtobytes(x):
+        return bytes(x, "iso8859-1")
+
+    def bytestostr(x):
+        return str(x, "iso8859-1")
+
+except:
+    strtobytes = str
+    bytestostr = str
+
+
+def interleave_planes(ipixels, apixels, ipsize, apsize):
+    """
+    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
+    from each pixel in `apixels`.  Conventionally `ipixels` and
+    `apixels` are byte arrays so the sizes are bytes, but it actually
+    works with any arrays of the same type.  The returned array is the
+    same type as the input arrays which should be the same type as each other.
+    """
+
+    itotal = len(ipixels)
+    atotal = len(apixels)
+    newtotal = itotal + atotal
+    newpsize = ipsize + apsize
+    # Set up the output buffer
+    # See http://www.python.org/doc/2.4.4/lib/module-array.html#l2h-1356
+    out = array(ipixels.typecode)
+    # It's annoying that there is no cheap way to set the array size :-(
+    out.extend(ipixels)
+    out.extend(apixels)
+    # Interleave in the pixel data
+    for i in range(ipsize):
+        out[i:newtotal:newpsize] = ipixels[i:itotal:ipsize]
+    for i in range(apsize):
+        out[i + ipsize : newtotal : newpsize] = apixels[i:atotal:apsize]
+    return out
+
+
+def check_palette(palette):
+    """Check a palette argument (to the :class:`Writer` class) for validity.
+    Returns the palette as a list if okay; raises an exception otherwise.
+    """
+
+    # None is the default and is allowed.
+    if palette is None:
+        return None
+
+    p = list(palette)
+    if not (0 < len(p) <= 256):
+        raise ValueError("a palette must have between 1 and 256 entries")
+    seen_triple = False
+    for i, t in enumerate(p):
+        if len(t) not in (3, 4):
+            raise ValueError("palette entry %d: entries must be 3- or 4-tuples." % i)
+        if len(t) == 3:
+            seen_triple = True
+        if seen_triple and len(t) == 4:
+            raise ValueError(
+                "palette entry %d: all 4-tuples must precede all 3-tuples" % i
+            )
+        for x in t:
+            if int(x) != x or not (0 <= x <= 255):
+                raise ValueError(
+                    "palette entry %d: values must be integer: 0 <= x <= 255" % i
+                )
+    return p
+
+
+class Error(Exception):
+    prefix = "Error"
+
+    def __str__(self):
+        return f'{self.prefix}: {" ".join(self.args)}'
+
+
+class FormatError(Error):
+    """Problem with input file format.  In other words, PNG file does
+    not conform to the specification in some way and is invalid.
+    """
+
+    prefix = "FormatError"
+
+
+class ChunkError(FormatError):
+    prefix = "ChunkError"
+
+
+class Writer:
+    """
+    PNG encoder in pure Python.
+    """
+
+    def __init__(
+        self,
+        width=None,
+        height=None,
+        size=None,
+        greyscale=False,
+        alpha=False,
+        bitdepth=8,
+        palette=None,
+        transparent=None,
+        background=None,
+        gamma=None,
+        compression=None,
+        interlace=False,
+        bytes_per_sample=None,  # deprecated
+        planes=None,
+        colormap=None,
+        maxval=None,
+        chunk_limit=2**20,
+    ):
+        """
+        Create a PNG encoder object.
+
+        Arguments:
+
+        width, height
+          Image size in pixels, as two separate arguments.
+        size
+          Image size (w,h) in pixels, as single argument.
+        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 colour mapped image (colour type 3).
+        transparent
+          Specify a transparent colour (create a ``tRNS`` chunk).
+        background
+          Specify a default background colour (create a ``bKGD`` chunk).
+        gamma
+          Specify a gamma value (create a ``gAMA`` chunk).
+        compression
+          zlib compression level (1-9).
+        interlace
+          Create an interlaced image.
+        chunk_limit
+          Write multiple ``IDAT`` chunks to save memory.
+
+        The image size (in pixels) can be specified either by using the
+        `width` and `height` arguments, or with the single `size`
+        argument.  If `size` is used it should be a pair (*width*,
+        *height*).
+
+        `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.
+        Each source pixel value must be an integer between 0 and
+        ``2**bitdepth-1``.  For example, 8-bit images have values
+        between 0 and 255.  PNG only stores images with bit depths of
+        1,2,4,8, or 16.  When `bitdepth` is not one of these values,
+        the next highest valid bit depth is selected, and an ``sBIT``
+        (significant bits) chunk is generated that specifies the original
+        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 / 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 greyscale and
+        colour mapped images; colour mapped images cannot have bit depth
+        16.
+
+        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 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 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 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
+        specify RGBA palette entries.  If both 4-tuples and 3-tuples
+        appear in the sequence then all the 4-tuples must come
+        before all the 3-tuples.  A ``PLTE`` chunk is created; if there
+        are 4-tuples then a ``tRNS`` chunk is created as well.  The
+        ``PLTE`` chunk will contain all the RGB triples in the same
+        sequence; the ``tRNS`` chunk will contain the alpha channel for
+        all the 4-tuples, in the same sequence.  Palette entries
+        are always 8-bit.
+
+        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 greyscale image.
+
+        If specified, the `gamma` parameter must be a positive number
+        (generally, a float).  A ``gAMA`` chunk will be created.  Note that
+        this will not change the values of the pixels as they appear in
+        the PNG file, they are assumed to have already been converted
+        appropriately for the gamma specified.
+
+        The `compression` argument specifies the compression level
+        to be used by the ``zlib`` module.  Higher values are likely
+        to compress better, but will be slower to compress.  The
+        default for this argument is ``None``; this does not mean
+        no compression, rather it means that the default from the
+        ``zlib`` module is used (which is generally acceptable).
+
+        If `interlace` is true then an interlaced image is created
+        (using PNG's so far only interlace method, *Adam7*).  This does not
+        affect how the pixels should be presented to the encoder, rather
+        it changes how they are arranged into the PNG file.  On slow
+        connexions interlaced images can be partially decoded by the
+        browser to give a rough view of the image that is successively
+        refined as more image data appears.
+
+        .. note ::
+
+          Enabling the `interlace` option requires the entire image
+          to be processed in working memory.
+
+        `chunk_limit` is used to limit the amount of memory used whilst
+        compressing the image.  In order to avoid using large amounts of
+        memory, multiple ``IDAT`` chunks may be created.
+        """
+
+        # At the moment the `planes` argument is ignored;
+        # 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`.
+
+        # A couple of helper functions come first.  Best skipped if you
+        # are reading through.
+
+        def isinteger(x):
+            try:
+                return int(x) == x
+            except:
+                return False
+
+        def check_color(c, which):
+            """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 greyscale:
+                try:
+                    l = len(c)
+                except TypeError:
+                    c = (c,)
+                if len(c) != 1:
+                    raise ValueError(f"{which} for greyscale must be 1-tuple")
+                if not isinteger(c[0]):
+                    raise ValueError(f"{which} colour for greyscale must be integer")
+            else:
+                if not (
+                    len(c) == 3
+                    and isinteger(c[0])
+                    and isinteger(c[1])
+                    and isinteger(c[2])
+                ):
+                    raise ValueError(f"{which} colour must be a triple of integers")
+            return c
+
+        if size:
+            if len(size) != 2:
+                raise ValueError("size argument should be a pair (width, height)")
+            if width is not None and width != size[0]:
+                raise ValueError(
+                    "size[0] (%r) and width (%r) should match when both are used."
+                    % (size[0], width)
+                )
+            if height is not None and height != size[1]:
+                raise ValueError(
+                    "size[1] (%r) and height (%r) should match when both are used."
+                    % (size[1], height)
+                )
+            width, height = size
+        del size
+
+        if width <= 0 or height <= 0:
+            raise ValueError("width and height must be greater than zero")
+        if not isinteger(width) or not isinteger(height):
+            raise ValueError("width and height must be integers")
+        # http://www.w3.org/TR/PNG/#7Integers-and-byte-order
+        if width > 2**32 - 1 or height > 2**32 - 1:
+            raise ValueError("width and height cannot exceed 2**32-1")
+
+        if alpha and transparent is not None:
+            raise ValueError("transparent colour not allowed with alpha channel")
+
+        if bytes_per_sample is not None:
+            warnings.warn(
+                "please use bitdepth instead of bytes_per_sample", DeprecationWarning
+            )
+            if bytes_per_sample not in (0.125, 0.25, 0.5, 1, 2):
+                raise ValueError("bytes per sample must be .125, .25, .5, 1, or 2")
+            bitdepth = int(8 * bytes_per_sample)
+        del bytes_per_sample
+        if not isinteger(bitdepth) or bitdepth < 1 or 16 < bitdepth:
+            raise ValueError(
+                f"bitdepth ({bitdepth!r}) must be a positive integer <= 16"
+            )
+
+        self.rescale = None
+        if palette:
+            if bitdepth not in (1, 2, 4, 8):
+                raise ValueError("with palette, bitdepth must be 1, 2, 4, or 8")
+            if transparent is not None:
+                raise ValueError("transparent and palette not compatible")
+            if alpha:
+                raise ValueError("alpha 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 greyscale:
+                if bitdepth not in (8, 16):
+                    targetbitdepth = (8, 16)[bitdepth > 8]
+                    self.rescale = (bitdepth, targetbitdepth)
+                    bitdepth = targetbitdepth
+                    del targetbitdepth
+            else:
+                assert greyscale
+                assert not alpha
+                if bitdepth not in (1, 2, 4, 8, 16):
+                    if bitdepth > 8:
+                        targetbitdepth = 16
+                    elif bitdepth == 3:
+                        targetbitdepth = 4
+                    else:
+                        assert bitdepth in (5, 6, 7)
+                        targetbitdepth = 8
+                    self.rescale = (bitdepth, targetbitdepth)
+                    bitdepth = targetbitdepth
+                    del targetbitdepth
+
+        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 (greyscale, alpha,
+        # colormap, interlace) are converted to bool because Iverson's
+        # convention is relied upon later on.
+        self.width = width
+        self.height = height
+        self.transparent = transparent
+        self.background = background
+        self.gamma = gamma
+        self.greyscale = bool(greyscale)
+        self.alpha = bool(alpha)
+        self.colormap = bool(palette)
+        self.bitdepth = int(bitdepth)
+        self.compression = compression
+        self.chunk_limit = chunk_limit
+        self.interlace = bool(interlace)
+        self.palette = check_palette(palette)
+
+        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.greyscale or self.colormap]
+        self.planes = self.color_planes + self.alpha
+        # :todo: fix for bitdepth < 8
+        self.psize = (self.bitdepth / 8) * self.planes
+
+    def make_palette(self):
+        """Create the byte sequences for a ``PLTE`` and if necessary a
+        ``tRNS`` chunk.  Returned as a pair (*p*, *t*).  *t* will be
+        ``None`` if no ``tRNS`` chunk is necessary.
+        """
+
+        p = array("B")
+        t = array("B")
+
+        for x in self.palette:
+            p.extend(x[0:3])
+            if len(x) > 3:
+                t.append(x[3])
+        p = tostring(p)
+        t = tostring(t)
+        if t:
+            return p, t
+        return p, None
+
+    def write(self, outfile, rows):
+        """Write a PNG image to the output file.  `rows` should be
+        an iterable that yields each row in boxed row flat pixel format.
+        The rows should be the rows of the original image, so there
+        should be ``self.height`` rows of ``self.width * self.planes`` values.
+        If `interlace` is specified (when creating the instance), then
+        an interlaced PNG file will be written.  Supply the rows in the
+        normal image order; the interlacing is carried out internally.
+
+        .. note ::
+
+          Interlacing will require the entire image to be in working memory.
+        """
+
+        if self.interlace:
+            fmt = "BH"[self.bitdepth > 8]
+            a = array(fmt, itertools.chain(*rows))
+            return self.write_array(outfile, a)
+        else:
+            nrows = self.write_passes(outfile, rows)
+            if nrows != self.height:
+                raise ValueError(
+                    "rows supplied (%d) does not match height (%d)"
+                    % (nrows, self.height)
+                )
+
+    def write_passes(self, outfile, rows, packed=False):
+        """
+        Write a PNG image to the output file.
+
+        Most users are expected to find the :meth:`write` or
+        :meth:`write_array` method more convenient.
+
+        The rows should be given to this method in the order that
+        they appear in the output file.  For straightlaced images,
+        this is the usual top to bottom ordering, but for interlaced
+        images the rows should have already been interlaced before
+        passing them to this function.
+
+        `rows` should be an iterable that yields each row.  When
+        `packed` is ``False`` the rows should be in boxed row flat pixel
+        format; when `packed` is ``True`` each row should be a packed
+        sequence of bytes.
+
+        """
+
+        # http://www.w3.org/TR/PNG/#5PNG-file-signature
+        outfile.write(_signature)
+
+        # http://www.w3.org/TR/PNG/#11IHDR
+        write_chunk(
+            outfile,
+            "IHDR",
+            struct.pack(
+                "!2I5B",
+                self.width,
+                self.height,
+                self.bitdepth,
+                self.color_type,
+                0,
+                0,
+                self.interlace,
+            ),
+        )
+
+        # See :chunk:order
+        # http://www.w3.org/TR/PNG/#11gAMA
+        if self.gamma is not None:
+            write_chunk(
+                outfile, "gAMA", struct.pack("!L", int(round(self.gamma * 1e5)))
+            )
+
+        # See :chunk:order
+        # http://www.w3.org/TR/PNG/#11sBIT
+        if self.rescale:
+            write_chunk(
+                outfile,
+                "sBIT",
+                struct.pack("%dB" % self.planes, *[self.rescale[0]] * self.planes),
+            )
+
+        # :chunk:order: Without a palette (PLTE chunk), ordering is
+        # relatively relaxed.  With one, gAMA chunk must precede PLTE
+        # chunk which must precede tRNS and bKGD.
+        # See http://www.w3.org/TR/PNG/#5ChunkOrdering
+        if self.palette:
+            p, t = self.make_palette()
+            write_chunk(outfile, "PLTE", p)
+            if t:
+                # tRNS chunk is optional.  Only needed if palette entries
+                # have alpha.
+                write_chunk(outfile, "tRNS", t)
+
+        # http://www.w3.org/TR/PNG/#11tRNS
+        if self.transparent is not None:
+            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.greyscale:
+                write_chunk(outfile, "bKGD", struct.pack("!1H", *self.background))
+            else:
+                write_chunk(outfile, "bKGD", struct.pack("!3H", *self.background))
+
+        # http://www.w3.org/TR/PNG/#11IDAT
+        if self.compression is not None:
+            compressor = zlib.compressobj(self.compression)
+        else:
+            compressor = zlib.compressobj()
+
+        # Choose an extend function based on the bitdepth.  The extend
+        # function packs/decomposes the pixel values into bytes and
+        # stuffs them onto the data array.
+        data = array("B")
+        if self.bitdepth == 8 or packed:
+            extend = data.extend
+        elif self.bitdepth == 16:
+            # Decompose into bytes
+            def extend(sl):
+                fmt = f"!{len(sl)}H"
+                data.extend(array("B", struct.pack(fmt, *sl)))
+
+        else:
+            # Pack into bytes
+            assert self.bitdepth < 8
+            # samples per byte
+            spb = int(8 / self.bitdepth)
+
+            def extend(sl):
+                a = array("B", sl)
+                # Adding padding bytes so we can group into a whole
+                # number of spb-tuples.
+                l = float(len(a))
+                extra = math.ceil(l / float(spb)) * spb - l
+                a.extend([0] * int(extra))
+                # Pack into bytes
+                l = group(a, spb)
+                l = (reduce(lambda x, y: (x << self.bitdepth) + y, e) for e in l)
+                data.extend(l)
+
+        if self.rescale:
+            oldextend = extend
+            factor = float(2 ** self.rescale[1] - 1) / float(2 ** self.rescale[0] - 1)
+
+            def extend(sl):
+                oldextend((int(round(factor * x)) for x in sl))
+
+        # Build the first row, testing mostly to see if we need to
+        # 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
+        enumrows = enumerate(rows)
+        del rows
+
+        # First row's filter type.
+        data.append(0)
+        # :todo: Certain exceptions in the call to ``.next()`` or the
+        # following try would indicate no row data supplied.
+        # Should catch.
+        i, row = next(enumrows)
+        try:
+            # If this fails...
+            extend(row)
+        except:
+            # ... try a version that converts the values to int first.
+            # Not only does this work for the (slightly broken) NumPy
+            # types, there are probably lots of other, unknown, "nearly"
+            # int types it works for.
+            def wrapmapint(f):
+                return lambda sl: f(map(int, sl))
+
+            extend = wrapmapint(extend)
+            del wrapmapint
+            extend(row)
+
+        for i, row in enumrows:
+            # Add "None" filter type.  Currently, it's essential that
+            # this filter type be used for every scanline as we do not
+            # mark the first row of a reduced pass image; that means we
+            # could accidentally compute the wrong filtered scanline if
+            # we used "up", "average", or "paeth" on such a line.
+            data.append(0)
+            extend(row)
+            if len(data) > self.chunk_limit:
+                compressed = compressor.compress(tostring(data))
+                if len(compressed):
+                    # print(len(data), len(compressed), file= >> sys.stderr)
+                    write_chunk(outfile, "IDAT", compressed)
+                # Because of our very witty definition of ``extend``,
+                # 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[:]
+        if len(data):
+            compressed = compressor.compress(tostring(data))
+        else:
+            compressed = ""
+        flushed = compressor.flush()
+        if len(compressed) or len(flushed):
+            # print(len(data), len(compressed), len(flushed), file=sys.stderr)
+            write_chunk(outfile, "IDAT", compressed + flushed)
+        # http://www.w3.org/TR/PNG/#11IEND
+        write_chunk(outfile, "IEND")
+        return i + 1
+
+    def write_array(self, outfile, pixels):
+        """
+        Write an array in flat row flat pixel format as a PNG file on
+        the output file.  See also :meth:`write` method.
+        """
+
+        if self.interlace:
+            self.write_passes(outfile, self.array_scanlines_interlace(pixels))
+        else:
+            self.write_passes(outfile, self.array_scanlines(pixels))
+
+    def write_packed(self, outfile, rows):
+        """
+        Write PNG file to `outfile`.  The pixel data comes from `rows`
+        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
+        is best avoided.  For interlaced images, the rows should be
+        presented in the order that they appear in the file.
+
+        This method should not be used when the source image bit depth
+        is not one naturally supported by PNG; the bit depth should be
+        1, 2, 4, 8, or 16.
+        """
+
+        if self.rescale:
+            raise Error(
+                "write_packed method not suitable for bit depth %d" % self.rescale[0]
+            )
+        return self.write_passes(outfile, rows, packed=True)
+
+    def convert_pnm(self, infile, outfile):
+        """
+        Convert a PNM file containing raw pixel data into a PNG file
+        with the parameters set in the writer object.  Works for
+        (binary) PGM, PPM, and PAM formats.
+        """
+
+        if self.interlace:
+            pixels = array("B")
+            pixels.fromfile(
+                infile,
+                (self.bitdepth / 8) * self.color_planes * self.width * self.height,
+            )
+            self.write_passes(outfile, self.array_scanlines_interlace(pixels))
+        else:
+            self.write_passes(outfile, self.file_scanlines(infile))
+
+    def convert_ppm_and_pgm(self, ppmfile, pgmfile, outfile):
+        """
+        Convert a PPM and PGM file containing raw pixel data into a
+        PNG outfile with the parameters set in the writer object.
+        """
+        pixels = array("B")
+        pixels.fromfile(
+            ppmfile, (self.bitdepth / 8) * self.color_planes * self.width * self.height
+        )
+        apixels = array("B")
+        apixels.fromfile(pgmfile, (self.bitdepth / 8) * self.width * self.height)
+        pixels = interleave_planes(
+            pixels,
+            apixels,
+            (self.bitdepth / 8) * self.color_planes,
+            (self.bitdepth / 8),
+        )
+        if self.interlace:
+            self.write_passes(outfile, self.array_scanlines_interlace(pixels))
+        else:
+            self.write_passes(outfile, self.array_scanlines(pixels))
+
+    def file_scanlines(self, infile):
+        """
+        Generates boxed rows in flat pixel format, from the input file
+        `infile`.  It assumes that the input file is in a "Netpbm-like"
+        binary format, and is positioned at the beginning of the first
+        pixel.  The number of pixels to read is taken from the image
+        dimensions (`width`, `height`, `planes`) and the number of bytes
+        per value is implied by the image `bitdepth`.
+        """
+
+        # Values per row
+        vpr = self.width * self.planes
+        row_bytes = vpr
+        if self.bitdepth > 8:
+            assert self.bitdepth == 16
+            row_bytes *= 2
+            fmt = ">%dH" % vpr
+
+            def line():
+                return array("H", struct.unpack(fmt, infile.read(row_bytes)))
+
+        else:
+
+            def line():
+                scanline = array("B", infile.read(row_bytes))
+                return scanline
+
+        for y in range(self.height):
+            yield line()
+
+    def array_scanlines(self, pixels):
+        """
+        Generates boxed rows (flat pixels) from flat rows (flat pixels)
+        in an array.
+        """
+
+        # Values per row
+        vpr = self.width * self.planes
+        stop = 0
+        for y in range(self.height):
+            start = stop
+            stop = start + vpr
+            yield pixels[start:stop]
+
+    def array_scanlines_interlace(self, pixels):
+        """
+        Generator for interlaced scanlines from an array.  `pixels` is
+        the full source image in flat row flat pixel format.  The
+        generator yields each scanline of the reduced passes in turn, in
+        boxed row flat pixel format.
+        """
+
+        # http://www.w3.org/TR/PNG/#8InterlaceMethods
+        # Array type.
+        fmt = "BH"[self.bitdepth > 8]
+        # Value per row
+        vpr = self.width * self.planes
+        for xstart, ystart, xstep, ystep in _adam7:
+            if xstart >= self.width:
+                continue
+            # Pixels per row (of reduced image)
+            ppr = int(math.ceil((self.width - xstart) / float(xstep)))
+            # number of values in reduced image row.
+            row_len = ppr * self.planes
+            for y in range(ystart, self.height, ystep):
+                if xstep == 1:
+                    offset = y * vpr
+                    yield pixels[offset : offset + vpr]
+                else:
+                    row = array(fmt)
+                    # There's no easier way to set the length of an array
+                    row.extend(pixels[0:row_len])
+                    offset = y * vpr + xstart * self.planes
+                    end_offset = (y + 1) * vpr
+                    skip = self.planes * xstep
+                    for i in range(self.planes):
+                        row[i :: self.planes] = pixels[offset + i : end_offset : skip]
+                    yield row
+
+
+def write_chunk(outfile, tag, data=strtobytes("")):
+    """
+    Write a PNG chunk to the output file, including length and
+    checksum.
+    """
+
+    # http://www.w3.org/TR/PNG/#5Chunk-layout
+    outfile.write(struct.pack("!I", len(data)))
+    tag = strtobytes(tag)
+    outfile.write(tag)
+    outfile.write(data)
+    checksum = zlib.crc32(tag)
+    checksum = zlib.crc32(data, checksum)
+    checksum &= 2**32 - 1
+    outfile.write(struct.pack("!I", checksum))
+
+
+def write_chunks(out, chunks):
+    """Create a PNG file by writing out the chunks."""
+
+    out.write(_signature)
+    for chunk in chunks:
+        write_chunk(out, *chunk)
+
+
+def filter_scanline(type, line, fo, prev=None):
+    """Apply a scanline filter to a scanline.  `type` specifies the
+    filter type (0 to 4); `line` specifies the current (unfiltered)
+    scanline as a sequence of bytes; `prev` specifies the previous
+    (unfiltered) scanline as a sequence of bytes. `fo` specifies the
+    filter offset; normally this is size of a pixel in bytes (the number
+    of bytes per sample times the number of channels), but when this is
+    < 1 (for bit depths < 8) then the filter offset is 1.
+    """
+
+    assert 0 <= type < 5
+
+    # The output array.  Which, pathetically, we extend one-byte at a
+    # time (fortunately this is linear).
+    out = array("B", [type])
+
+    def sub():
+        ai = -fo
+        for x in line:
+            if ai >= 0:
+                x = (x - line[ai]) & 0xFF
+            out.append(x)
+            ai += 1
+
+    def up():
+        for i, x in enumerate(line):
+            x = (x - prev[i]) & 0xFF
+            out.append(x)
+
+    def average():
+        ai = -fo
+        for i, x in enumerate(line):
+            if ai >= 0:
+                x = (x - ((line[ai] + prev[i]) >> 1)) & 0xFF
+            else:
+                x = (x - (prev[i] >> 1)) & 0xFF
+            out.append(x)
+            ai += 1
+
+    def paeth():
+        # http://www.w3.org/TR/PNG/#9Filter-type-4-Paeth
+        ai = -fo  # also used for ci
+        for i, x in enumerate(line):
+            a = 0
+            b = prev[i]
+            c = 0
+
+            if ai >= 0:
+                a = line[ai]
+                c = prev[ai]
+            p = a + b - c
+            pa = abs(p - a)
+            pb = abs(p - b)
+            pc = abs(p - c)
+            if pa <= pb and pa <= pc:
+                Pr = a
+            elif pb <= pc:
+                Pr = b
+            else:
+                Pr = c
+
+            x = (x - Pr) & 0xFF
+            out.append(x)
+            ai += 1
+
+    if not prev:
+        # 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
+        # "left" (non-trivial, but true). "average" needs to be handled
+        # specially.
+        if type == 2:  # "up"
+            return line  # type = 0
+        elif type == 3:
+            prev = [0] * len(line)
+        elif type == 4:  # "paeth"
+            type = 1
+    if type == 0:
+        out.extend(line)
+    elif type == 1:
+        sub()
+    elif type == 2:
+        up()
+    elif type == 3:
+        average()
+    else:  # type == 4
+        paeth()
+    return out
+
+
+def from_array(a, mode=None, info={}):
+    """Create a PNG :class:`Image` object from a 2- or 3-dimensional array.
+    One application of this function is easy PIL-style saving:
+    ``png.from_array(pixels, 'L').save('foo.png')``.
+
+    .. note :
+
+      The use of the term *3-dimensional* is for marketing purposes
+      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
+    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 colour format in a
+    PIL-style mode.  It can be:
+
+    ``'L'``
+      greyscale (1 channel)
+    ``'LA'``
+      greyscale with alpha (2 channel)
+    ``'RGB'``
+      colour image (3 channel)
+    ``'RGBA'``
+      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
+    ``';16'`` to the mode will cause the PNG to be 16 bits per channel;
+    any decimal from 1 to 16 can be used to specify the bit depth.
+
+    When a 2-dimensional array is used *mode* determines how many
+    channels the image has, and so allows the width to be derived from
+    the second array dimension.
+
+    The array is expected to be a ``numpy`` array, but it can be any
+    suitable Python sequence.  For example, a list of lists can be used:
+    ``png.from_array([[0, 255, 0], [255, 0, 255]], 'L')``.  The exact
+    rules are: ``len(a)`` gives the first dimension, height;
+    ``len(a[0])`` gives the second dimension; ``len(a[0][0])`` gives the
+    third dimension, unless an exception is raised in which case a
+    2-dimensional array is assumed.  It's slightly more complicated than
+    that because an iterator of rows can be used, and it all still
+    works.  Using an iterator allows data to be streamed efficiently.
+
+    The bit depth of the PNG is normally taken from the array element's
+    datatype (but if *mode* specifies a bitdepth then that is used
+    instead).  The array element's datatype is determined in a way which
+    is supposed to work both for ``numpy`` arrays and for Python
+    ``array.array`` objects.  A 1 byte datatype will give a bit depth of
+    8, a 2 byte datatype will give a bit depth of 16.  If the datatype
+    does not have an implicit size, for example it is a plain Python
+    list of lists, as above, then a default of 8 is used.
+
+    The *info* parameter is a dictionary that can be used to specify
+    metadata (in the same style as the arguments to the
+    :class:``png.Writer`` class).  For this function the keys that are
+    useful are:
+
+    height
+      overrides the height derived from the array dimensions and allows
+      *a* to be an iterable.
+    width
+      overrides the width derived from the array dimensions.
+    bitdepth
+      overrides the bit depth derived from the element datatype (but
+      must match *mode* if that also specifies a bit depth).
+
+    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 ``greyscale`` key then
+    this must be true when mode is ``'L'`` or ``'LA'`` and false when
+    mode is ``'RGB'`` or ``'RGBA'``.
+    """
+
+    # We abuse the *info* parameter by modifying it.  Take a copy here.
+    # (Also typechecks *info* to some extent).
+    info = dict(info)
+
+    # Syntax check mode string.
+    bitdepth = None
+    try:
+        mode = mode.split(";")
+        if len(mode) not in (1, 2):
+            raise Error()
+        if mode[0] not in ("L", "LA", "RGB", "RGBA"):
+            raise Error()
+        if len(mode) == 2:
+            try:
+                bitdepth = int(mode[1])
+            except:
+                raise Error()
+    except Error:
+        raise Error("mode string should be 'RGB' or 'L;16' or similar.")
+    mode = mode[0]
+
+    # Get bitdepth from *mode* if possible.
+    if bitdepth:
+        if info.get("bitdepth") and bitdepth != info["bitdepth"]:
+            raise Error(
+                "mode bitdepth (%d) should match info bitdepth (%d)."
+                % (bitdepth, info["bitdepth"])
+            )
+        info["bitdepth"] = bitdepth
+
+    # Fill in and/or check entries in *info*.
+    # Dimensions.
+    if "size" in info:
+        # Check width, height, size all match where used.
+        for dimension, axis in [("width", 0), ("height", 1)]:
+            if dimension in info:
+                if info[dimension] != info["size"][axis]:
+                    raise Error(
+                        f"info[{dimension!r}] should match info['size'][{axis!r}]."
+                    )
+        info["width"], info["height"] = info["size"]
+    if "height" not in info:
+        try:
+            l = len(a)
+        except:
+            raise Error("len(a) does not work, supply info['height'] instead.")
+        info["height"] = l
+    # 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.")
+    info["alpha"] = "A" in mode
+
+    planes = len(mode)
+    if "planes" in info:
+        if info["planes"] != planes:
+            raise Error("info['planes'] should match mode.")
+
+    # In order to work out whether we the array is 2D or 3D we need its
+    # first row, which requires that we take a copy of its iterator.
+    # We may also need the first row to derive width and bitdepth.
+    a, t = itertools.tee(a)
+    row = next(t)
+    del t
+    try:
+        row[0][0]
+        threed = True
+        testelement = row[0]
+    except:
+        threed = False
+        testelement = row
+    if "width" not in info:
+        if threed:
+            width = len(row)
+        else:
+            width = len(row) // planes
+        info["width"] = width
+
+    # Not implemented yet
+    assert not threed
+
+    if "bitdepth" not in info:
+        try:
+            dtype = testelement.dtype
+            # goto the "else:" clause.  Sorry.
+        except:
+            try:
+                # Try a Python array.array.
+                bitdepth = 8 * testelement.itemsize
+            except:
+                # We can't determine it from the array element's
+                # datatype, use a default of 8.
+                bitdepth = 8
+        else:
+            # If we got here without exception, we now assume that
+            # the array is a numpy array.
+            if dtype.kind == "b":
+                bitdepth = 1
+            else:
+                bitdepth = 8 * dtype.itemsize
+        info["bitdepth"] = bitdepth
+
+    for thing in "width height bitdepth greyscale alpha".split():
+        assert thing in info
+    return Image(a, info)
+
+
+# So that refugee's from PIL feel more at home.  Not documented.
+fromarray = from_array
+
+
+class Image:
+    """A PNG image.
+    You can create an :class:`Image` object from an array of pixels by calling
+    :meth:`png.from_array`.  It can be saved to disk with the
+    :meth:`save` method."""
+
+    def __init__(self, rows, info):
+        """
+        .. note ::
+
+          The constructor is not public.  Please do not call it.
+        """
+
+        self.rows = rows
+        self.info = info
+
+    def save(self, file):
+        """Save the image to *file*.  If *file* looks like an open file
+        descriptor then it is used, otherwise it is treated as a
+        filename and a fresh file is opened.
+
+        In general, you can only call this method once; after it has
+        been called the first time and the PNG image has been saved, the
+        source data will have been streamed, and cannot be streamed
+        again.
+        """
+
+        w = Writer(**self.info)
+
+        try:
+            file.write
+
+            def close():
+                pass
+
+        except:
+            file = open(file, "wb")
+
+            def close():
+                file.close()
+
+        try:
+            w.write(file, self.rows)
+        finally:
+            close()
+
+
+class _readable:
+    """
+    A simple file-like interface for strings and arrays.
+    """
+
+    def __init__(self, buf):
+        self.buf = buf
+        self.offset = 0
+
+    def read(self, n):
+        r = self.buf[self.offset : self.offset + n]
+        if isarray(r):
+            r = tostring(r)
+        self.offset += n
+        return r
+
+
+class Reader:
+    """
+    PNG decoder in pure Python.
+    """
+
+    def __init__(self, _guess=None, **kw):
+        """
+        Create a PNG decoder object.
+
+        The constructor expects exactly one keyword argument. If you
+        supply a positional argument instead, it will guess the input
+        type. You can choose among the following keyword arguments:
+
+        filename
+          Name of input file (a PNG file).
+        file
+          A file-like object (object with a read() method).
+        bytes
+          ``array`` or ``string`` with PNG data.
+
+        """
+        if (_guess is not None and len(kw) != 0) or (_guess is None and len(kw) != 1):
+            raise TypeError("Reader() takes exactly 1 argument")
+
+        # Will be the first 8 bytes, later on.  See validate_signature.
+        self.signature = None
+        self.transparent = None
+        # A pair of (len,type) if a chunk has been read but its data and
+        # checksum have not (in other words the file position is just
+        # past the 4 bytes that specify the chunk type).  See preamble
+        # method for how this is used.
+        self.atchunk = None
+
+        if _guess is not None:
+            if isarray(_guess):
+                kw["bytes"] = _guess
+            elif isinstance(_guess, str):
+                kw["filename"] = _guess
+            elif isinstance(_guess, io.IOBase):
+                kw["file"] = _guess
+
+        if "filename" in kw:
+            self.file = open(kw["filename"], "rb")
+        elif "file" in kw:
+            self.file = kw["file"]
+        elif "bytes" in kw:
+            self.file = _readable(kw["bytes"])
+        else:
+            raise TypeError("expecting filename, file or bytes array")
+
+    def chunk(self, seek=None):
+        """
+        Read the next PNG chunk from the input file; returns a
+        (*type*,*data*) tuple.  *type* is the chunk's type as a string
+        (all PNG chunk types are 4 characters long).  *data* is the
+        chunk's data content, as a string.
+
+        If the optional `seek` argument is
+        specified then it will keep reading chunks until it either runs
+        out of file or finds the type specified by the argument.  Note
+        that in general the order of chunks in PNGs is unspecified, so
+        using `seek` can cause you to miss chunks.
+        """
+
+        self.validate_signature()
+
+        while True:
+            # http://www.w3.org/TR/PNG/#5Chunk-layout
+            if not self.atchunk:
+                self.atchunk = self.chunklentype()
+            length, type = self.atchunk
+            self.atchunk = None
+            data = self.file.read(length)
+            if len(data) != length:
+                raise ChunkError(
+                    "Chunk %s too short for required %i octets." % (type, length)
+                )
+            checksum = self.file.read(4)
+            if len(checksum) != 4:
+                raise ValueError("Chunk %s too short for checksum.", checksum)
+            if seek and type != seek:
+                continue
+            verify = zlib.crc32(strtobytes(type))
+            verify = zlib.crc32(data, verify)
+            # Whether the output from zlib.crc32 is signed or not varies
+            # according to hideous implementation details, see
+            # http://bugs.python.org/issue1202 .
+            # We coerce it to be positive here (in a way which works on
+            # Python 2.3 and older).
+            verify &= 2**32 - 1
+            verify = struct.pack("!I", verify)
+            if checksum != verify:
+                # print(repr(checksum))
+                (a,) = struct.unpack("!I", checksum)
+                (b,) = struct.unpack("!I", verify)
+                raise ChunkError(
+                    f"Checksum error in {type} chunk: 0x{a:08X} != 0x{b:08X}."
+                )
+            return type, data
+
+    def chunks(self):
+        """Return an iterator that will yield each chunk as a
+        (*chunktype*, *content*) pair.
+        """
+
+        while True:
+            t, v = self.chunk()
+            yield t, v
+            if t == "IEND":
+                break
+
+    def undo_filter(self, filter_type, scanline, previous):
+        """Undo the filter for a scanline.  `scanline` is a sequence of
+        bytes that does not include the initial filter type byte.
+        `previous` is decoded previous scanline (for straightlaced
+        images this is the previous pixel row, but for interlaced
+        images, it is the previous scanline in the reduced image, which
+        in general is not the previous pixel row in the final image).
+        When there is no previous scanline (the first row of a
+        straightlaced image, or the first row in one of the passes in an
+        interlaced image), then this argument should be ``None``.
+
+        The scanline will have the effects of filtering removed, and the
+        result will be returned as a fresh sequence of bytes.
+        """
+
+        # :todo: Would it be better to update scanline in place?
+
+        # Create the result byte array.  It seems that the best way to
+        # create the array to be the right size is to copy from an
+        # existing sequence.  *sigh*
+        # If we fill the result with scanline, then this allows a
+        # micro-optimisation in the "null" and "sub" cases.
+        result = array("B", scanline)
+
+        if filter_type == 0:
+            # And here, we _rely_ on filling the result with scanline,
+            # above.
+            return result
+
+        if filter_type not in (1, 2, 3, 4):
+            raise FormatError(
+                "Invalid PNG Filter Type."
+                "  See http://www.w3.org/TR/2003/REC-PNG-20031110/#9Filters ."
+            )
+
+        # Filter unit.  The stride from one pixel to the corresponding
+        # 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 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.
+        if not previous:
+            previous = array("B", [0] * len(scanline))
+
+        def sub():
+            """Undo sub filter."""
+
+            ai = 0
+            # Loops starts at index fu.  Observe that the initial part
+            # of the result is already filled in correctly with
+            # scanline.
+            for i in range(fu, len(result)):
+                x = scanline[i]
+                a = result[ai]
+                result[i] = (x + a) & 0xFF
+                ai += 1
+
+        def up():
+            """Undo up filter."""
+            for i in range(len(result)):  # pylint: disable=consider-using-enumerate
+                x = scanline[i]
+                b = previous[i]
+                result[i] = (x + b) & 0xFF
+
+        def average():
+            """Undo average filter."""
+
+            ai = -fu
+            for i in range(len(result)):  # pylint: disable=consider-using-enumerate
+                x = scanline[i]
+                if ai < 0:
+                    a = 0
+                else:
+                    a = result[ai]
+                b = previous[i]
+                result[i] = (x + ((a + b) >> 1)) & 0xFF
+                ai += 1
+
+        def paeth():
+            """Undo Paeth filter."""
+
+            # Also used for ci.
+            ai = -fu
+            for i in range(len(result)):  # pylint: disable=consider-using-enumerate
+                x = scanline[i]
+                if ai < 0:
+                    a = c = 0
+                else:
+                    a = result[ai]
+                    c = previous[ai]
+                b = previous[i]
+                p = a + b - c
+                pa = abs(p - a)
+                pb = abs(p - b)
+                pc = abs(p - c)
+                if pa <= pb and pa <= pc:
+                    pr = a
+                elif pb <= pc:
+                    pr = b
+                else:
+                    pr = c
+                result[i] = (x + pr) & 0xFF
+                ai += 1
+
+        # Call appropriate filter algorithm.  Note that 0 has already
+        # been dealt with.
+        (None, sub, up, average, paeth)[filter_type]()
+        return result
+
+    def deinterlace(self, raw):
+        """
+        Read raw pixel data, undo filters, deinterlace, and flatten.
+        Return in flat row flat pixel format.
+        """
+
+        # print("Reading interlaced, w=%s, r=%s, planes=%s, bpp=%s"
+        # % (self.width, self.height, self.planes, self.bps, file=sys.stderr))
+        # Values per row (of the target image)
+        vpr = self.width * self.planes
+
+        # Make a result array, and make it big enough.  Interleaving
+        # writes to the output array randomly (well, not quite), so the
+        # entire output array must be in memory.
+        fmt = "BH"[self.bitdepth > 8]
+        a = array(fmt, [0] * vpr * self.height)
+        source_offset = 0
+
+        for xstart, ystart, xstep, ystep in _adam7:
+            # print("Adam7: start=%s,%s step=%s,%s" % (
+            #     xstart, ystart, xstep, ystep, file=sys.stderr))
+            if xstart >= self.width:
+                continue
+            # The previous (reconstructed) scanline.  None at the
+            # beginning of a pass to indicate that there is no previous
+            # line.
+            recon = None
+            # Pixels per row (reduced pass image)
+            ppr = int(math.ceil((self.width - xstart) / float(xstep)))
+            # Row size in bytes for this pass.
+            row_size = int(math.ceil(self.psize * ppr))
+            for y in range(ystart, self.height, ystep):
+                filter_type = raw[source_offset]
+                source_offset += 1
+                scanline = raw[source_offset : source_offset + row_size]
+                source_offset += row_size
+                recon = self.undo_filter(filter_type, scanline, recon)
+                # Convert so that there is one element per pixel value
+                flat = self.serialtoflat(recon, ppr)
+                if xstep == 1:
+                    assert xstart == 0
+                    offset = y * vpr
+                    a[offset : offset + vpr] = flat
+                else:
+                    offset = y * vpr + xstart * self.planes
+                    end_offset = (y + 1) * vpr
+                    skip = self.planes * xstep
+                    for i in range(self.planes):
+                        a[offset + i : end_offset : skip] = flat[i :: self.planes]
+        return a
+
+    def iterboxed(self, rows):
+        """Iterator that yields each scanline in boxed row flat pixel
+        format.  `rows` should be an iterator that yields the bytes of
+        each row in turn.
+        """
+
+        def asvalues(raw):
+            """Convert a row of raw bytes into a flat row.  Result may
+            or may not share with argument"""
+
+            if self.bitdepth == 8:
+                return raw
+            if self.bitdepth == 16:
+                raw = tostring(raw)
+                return array("H", struct.unpack("!%dH" % (len(raw) // 2), raw))
+            assert self.bitdepth < 8
+            width = self.width
+            # Samples per byte
+            spb = 8 // self.bitdepth
+            out = array("B")
+            mask = 2**self.bitdepth - 1
+            shifts = map(self.bitdepth.__mul__, reversed(range(spb)))
+            for o in raw:
+                out.extend((mask & (o >> i) for i in shifts))
+            return out[:width]
+
+        return map(asvalues, rows)
+
+    def serialtoflat(self, bytes, width=None):
+        """Convert serial format (byte stream) pixel data to flat row
+        flat pixel.
+        """
+
+        if self.bitdepth == 8:
+            return bytes
+        if self.bitdepth == 16:
+            bytes = tostring(bytes)
+            return array("H", struct.unpack("!%dH" % (len(bytes) // 2), bytes))
+        assert self.bitdepth < 8
+        if width is None:
+            width = self.width
+        # Samples per byte
+        spb = 8 // self.bitdepth
+        out = array("B")
+        mask = 2**self.bitdepth - 1
+        shifts = map(self.bitdepth.__mul__, reversed(range(spb)))
+        l = width
+        for o in bytes:
+            out.extend([(mask & (o >> s)) for s in shifts][:l])
+            l -= spb
+            if l <= 0:
+                l = width
+        return out
+
+    def iterstraight(self, raw):
+        """Iterator that undoes the effect of filtering, and yields each
+        row in serialised format (as a sequence of bytes).  Assumes input
+        is straightlaced.  `raw` should be an iterable that yields the
+        raw bytes in chunks of arbitrary size."""
+
+        # length of row, in bytes
+        rb = self.row_bytes
+        a = array("B")
+        # The previous (reconstructed) scanline.  None indicates first
+        # line of image.
+        recon = None
+        for some in raw:
+            a.extend(some)
+            while len(a) >= rb + 1:
+                filter_type = a[0]
+                scanline = a[1 : rb + 1]
+                del a[: rb + 1]
+                recon = self.undo_filter(filter_type, scanline, recon)
+                yield recon
+        if len(a) != 0:
+            # :file:format We get here with a file format error: when the
+            # available bytes (after decompressing) do not pack into exact
+            # rows.
+            raise FormatError("Wrong size for decompressed IDAT chunk.")
+        assert len(a) == 0
+
+    def validate_signature(self):
+        """If signature (header) has not been read then read and
+        validate it; otherwise do nothing.
+        """
+
+        if self.signature:
+            return
+        self.signature = self.file.read(8)
+        if self.signature != _signature:
+            raise FormatError("PNG file has invalid signature.")
+
+    def preamble(self):
+        """
+        Extract the image metadata by reading the initial part of the PNG
+        file up to the start of the ``IDAT`` chunk.  All the chunks that
+        precede the ``IDAT`` chunk are read and either processed for
+        metadata or discarded.
+        """
+
+        self.validate_signature()
+
+        while True:
+            if not self.atchunk:
+                self.atchunk = self.chunklentype()
+                if self.atchunk is None:
+                    raise FormatError("This PNG file has no IDAT chunks.")
+            if self.atchunk[1] == "IDAT":
+                return
+            self.process_chunk()
+
+    def chunklentype(self):
+        """Reads just enough of the input to determine the next
+        chunk's length and type, returned as a (*length*, *type*) pair
+        where *type* is a string.  If there are no more chunks, ``None``
+        is returned.
+        """
+
+        x = self.file.read(8)
+        if not x:
+            return None
+        if len(x) != 8:
+            raise FormatError("End of file whilst reading chunk length and type.")
+        length, type = struct.unpack("!I4s", x)
+        type = bytestostr(type)
+        if length > 2**31 - 1:
+            raise FormatError("Chunk %s is too large: %d." % (type, length))
+        return length, type
+
+    def process_chunk(self):
+        """Process the next chunk and its data.  This only processes the
+        following chunk types, all others are ignored: ``IHDR``,
+        ``PLTE``, ``bKGD``, ``tRNS``, ``gAMA``, ``sBIT``.
+        """
+
+        type, data = self.chunk()
+        if type == "IHDR":
+            # http://www.w3.org/TR/PNG/#11IHDR
+            if len(data) != 13:
+                raise FormatError("IHDR chunk has incorrect length.")
+            (
+                self.width,
+                self.height,
+                self.bitdepth,
+                self.color_type,
+                self.compression,
+                self.filter,
+                self.interlace,
+            ) = struct.unpack("!2I5B", data)
+
+            # Check that the header specifies only valid combinations.
+            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 colour type %d" % self.color_type)
+            # Check indexed (palettized) images have 8 or fewer bits
+            # 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 colour type (%d)."
+                    " See http://www.w3.org/TR/2003/REC-PNG-20031110/#table111 ."
+                    % (self.bitdepth, self.color_type)
+                )
+            if self.compression != 0:
+                raise Error("unknown compression method %d" % self.compression)
+            if self.filter != 0:
+                raise FormatError(
+                    "Unknown filter method %d,"
+                    " see http://www.w3.org/TR/2003/REC-PNG-20031110/#9Filters ."
+                    % self.filter
+                )
+            if self.interlace not in (0, 1):
+                raise FormatError(
+                    "Unknown interlace method %d,"
+                    " see http://www.w3.org/TR/2003/REC-PNG-20031110/#8InterlaceMethods ."
+                    % self.interlace
+                )
+
+            # Derived values
+            # http://www.w3.org/TR/PNG/#6Colour-values
+            colormap = bool(self.color_type & 1)
+            greyscale = not (self.color_type & 2)
+            alpha = bool(self.color_type & 4)
+            color_planes = (3, 1)[greyscale or colormap]
+            planes = color_planes + alpha
+
+            self.colormap = colormap
+            self.greyscale = greyscale
+            self.alpha = alpha
+            self.color_planes = color_planes
+            self.planes = planes
+            self.psize = float(self.bitdepth) / float(8) * planes
+            if int(self.psize) == self.psize:
+                self.psize = int(self.psize)
+            self.row_bytes = int(math.ceil(self.width * self.psize))
+            # Stores PLTE chunk if present, and is used to check
+            # chunk ordering constraints.
+            self.plte = None
+            # Stores tRNS chunk if present, and is used to check chunk
+            # ordering constraints.
+            self.trns = None
+            # Stores sbit chunk if present.
+            self.sbit = None
+        elif type == "PLTE":
+            # http://www.w3.org/TR/PNG/#11PLTE
+            if self.plte:
+                warnings.warn("Multiple PLTE chunks present.")
+            self.plte = data
+            if len(data) % 3 != 0:
+                raise FormatError("PLTE chunk's length should be a multiple of 3.")
+            if len(data) > (2**self.bitdepth) * 3:
+                raise FormatError("PLTE chunk is too long.")
+            if len(data) == 0:
+                raise FormatError("Empty PLTE is not allowed.")
+        elif type == "bKGD":
+            try:
+                if self.colormap:
+                    if not self.plte:
+                        warnings.warn("PLTE chunk is required before bKGD chunk.")
+                    self.background = struct.unpack("B", data)
+                else:
+                    self.background = struct.unpack("!%dH" % self.color_planes, data)
+            except struct.error:
+                raise FormatError("bKGD chunk has incorrect length.")
+        elif type == "tRNS":
+            # http://www.w3.org/TR/PNG/#11tRNS
+            self.trns = data
+            if self.colormap:
+                if not self.plte:
+                    warnings.warn("PLTE chunk is required before tRNS chunk.")
+                else:
+                    if len(data) > len(self.plte) / 3:
+                        # Was warning, but promoted to Error as it
+                        # would otherwise cause pain later on.
+                        raise FormatError("tRNS chunk is too long.")
+            else:
+                if self.alpha:
+                    raise FormatError(
+                        "tRNS chunk is not valid with colour type %d." % self.color_type
+                    )
+                try:
+                    self.transparent = struct.unpack("!%dH" % self.color_planes, data)
+                except struct.error:
+                    raise FormatError("tRNS chunk has incorrect length.")
+        elif type == "gAMA":
+            try:
+                self.gamma = struct.unpack("!L", data)[0] / 100000.0
+            except struct.error:
+                raise FormatError("gAMA chunk has incorrect length.")
+        elif type == "sBIT":
+            self.sbit = data
+            if (
+                self.colormap
+                and len(data) != 3
+                or not self.colormap
+                and len(data) != self.planes
+            ):
+                raise FormatError("sBIT chunk has incorrect length.")
+
+    def read(self):
+        """
+        Read the PNG file and decode it.  Returns (`width`, `height`,
+        `pixels`, `metadata`).
+
+        May use excessive memory.
+
+        `pixels` are returned in boxed row flat pixel format.
+        """
+
+        def iteridat():
+            """Iterator that yields all the ``IDAT`` chunks as strings."""
+            while True:
+                try:
+                    type, data = self.chunk()
+                except ValueError as e:
+                    raise ChunkError(e.args[0])
+                if type == "IEND":
+                    # http://www.w3.org/TR/PNG/#11IEND
+                    break
+                if type != "IDAT":
+                    continue
+                # type == 'IDAT'
+                # http://www.w3.org/TR/PNG/#11IDAT
+                if self.colormap and not self.plte:
+                    warnings.warn("PLTE chunk is required before IDAT chunk")
+                yield data
+
+        def iterdecomp(idat):
+            """Iterator that yields decompressed strings.  `idat` should
+            be an iterator that yields the ``IDAT`` chunk data.
+            """
+
+            # Currently, with no max_length parameter to decompress, this
+            # routine will do one yield per IDAT chunk.  So not very
+            # incremental.
+            d = zlib.decompressobj()
+            # Each IDAT chunk is passed to the decompressor, then any
+            # remaining state is decompressed out.
+            for data in idat:
+                # :todo: add a max_length argument here to limit output
+                # size.
+                yield array("B", d.decompress(data))
+            yield array("B", d.flush())
+
+        self.preamble()
+        raw = iterdecomp(iteridat())
+
+        if self.interlace:
+            raw = array("B", itertools.chain(*raw))
+            arraycode = "BH"[self.bitdepth > 8]
+            # Like :meth:`group` but producing an array.array object for
+            # each row.
+            pixels = map(
+                lambda *row: array(arraycode, row),
+                *[iter(self.deinterlace(raw))] * self.width * self.planes,
+            )
+        else:
+            pixels = self.iterboxed(self.iterstraight(raw))
+        meta = {}
+        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():
+            a = getattr(self, attr, None)
+            if a is not None:
+                meta[attr] = a
+        return self.width, self.height, pixels, meta
+
+    def read_flat(self):
+        """
+        Read a PNG file and decode it into flat row flat pixel format.
+        Returns (*width*, *height*, *pixels*, *metadata*).
+
+        May use excessive memory.
+
+        `pixels` are returned in flat row flat pixel format.
+
+        See also the :meth:`read` method which returns pixels in the
+        more stream-friendly boxed row flat pixel format.
+        """
+
+        x, y, pixel, meta = self.read()
+        arraycode = "BH"[meta["bitdepth"] > 8]
+        pixel = array(arraycode, itertools.chain(*pixel))
+        return x, y, pixel, meta
+
+    def palette(self, alpha="natural"):
+        """Returns a palette that is a sequence of 3-tuples or 4-tuples,
+        synthesizing it from the ``PLTE`` and ``tRNS`` chunks.  These
+        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 colour type
+        3 and therefore a ``PLTE`` chunk is required.
+
+        If the `alpha` argument is ``'force'`` then an alpha channel is
+        always added, forcing the result to be a sequence of 4-tuples.
+        """
+
+        if not self.plte:
+            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 "")
+            trns.extend([255] * (len(plte) - len(trns)))
+            plte = map(operator.add, plte, group(trns, 1))
+        return plte
+
+    def asDirect(self):
+        """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 (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
+        colour value directly without needing to refer to palettes or
+        transparency information.
+
+        Like the :meth:`read` method this method returns a 4-tuple:
+
+        (*width*, *height*, *pixels*, *meta*)
+
+        This method normally returns pixel values with the bit depth
+        they have in the source image, but when the source PNG has an
+        ``sBIT`` chunk it is inspected and can reduce the bit depth of
+        the result pixels; pixel values will be reduced according to
+        the bit depth specified in the ``sBIT`` chunk (PNG nerds should
+        note a single result bit depth is used for all channels; the
+        maximum of the ones specified in the ``sBIT`` chunk.  An RGB565
+        image will be rescaled to 6-bit RGB666).
+
+        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
+        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.
+
+        *pixels* is the pixel data in boxed row flat pixel format (just
+        like the :meth:`read` method).
+
+        All the other aspects of the image data are not changed.
+        """
+
+        self.preamble()
+
+        # Simple case, no conversion necessary.
+        if not self.colormap and not self.trns and not self.sbit:
+            return self.read()
+
+        x, y, pixels, meta = self.read()
+
+        if self.colormap:
+            meta["colormap"] = False
+            meta["alpha"] = bool(self.trns)
+            meta["bitdepth"] = 8
+            meta["planes"] = 3 + bool(self.trns)
+            plte = list(self.palette())
+
+            def iterpal(pixels):
+                for row in pixels:
+                    row = map(plte.__getitem__, row)
+                    yield array("B", itertools.chain(*row))
+
+            pixels = iterpal(pixels)
+        elif self.trns:
+            # It would be nice if there was some reasonable way of doing
+            # this without generating a whole load of intermediate tuples.
+            # But tuples does seem like the easiest way, with no other way
+            # clearly much simpler or much faster.  (Actually, the L to LA
+            # conversion could perhaps go faster (all those 1-tuples!), but
+            # I still wonder whether the code proliferation is worth it)
+            it = self.transparent
+            maxval = 2 ** meta["bitdepth"] - 1
+            planes = meta["planes"]
+            meta["alpha"] = True
+            meta["planes"] += 1
+            typecode = "BH"[meta["bitdepth"] > 8]
+
+            def itertrns(pixels):
+                for row in pixels:
+                    # For each row we group it into pixels, then form a
+                    # characterisation vector that says whether each pixel
+                    # is opaque or not.  Then we convert True/False to
+                    # 0/maxval (by multiplication), and add it as the extra
+                    # channel.
+                    row = group(row, planes)
+                    opa = map(it.__ne__, row)
+                    opa = map(maxval.__mul__, opa)
+                    opa = zip(opa)  # convert to 1-tuples
+                    yield array(typecode, itertools.chain(*map(operator.add, row, opa)))
+
+            pixels = itertrns(pixels)
+        targetbitdepth = None
+        if self.sbit:
+            sbit = struct.unpack(f"{len(self.sbit)}B", self.sbit)
+            targetbitdepth = max(sbit)
+            if targetbitdepth > meta["bitdepth"]:
+                raise Error("sBIT chunk %r exceeds bitdepth %d" % (sbit, self.bitdepth))
+            if min(sbit) <= 0:
+                raise Error(f"sBIT chunk {sbit!r} has a 0-entry")
+            if targetbitdepth == meta["bitdepth"]:
+                targetbitdepth = None
+        if targetbitdepth:
+            shift = meta["bitdepth"] - targetbitdepth
+            meta["bitdepth"] = targetbitdepth
+
+            def itershift(pixels):
+                for row in pixels:
+                    yield map(shift.__rrshift__, row)
+
+            pixels = itershift(pixels)
+        return x, y, pixels, meta
+
+    def asFloat(self, maxval=1.0):
+        """Return image pixels as per :meth:`asDirect` method, but scale
+        all pixel values to be floating point values between 0.0 and
+        *maxval*.
+        """
+
+        x, y, pixels, info = self.asDirect()
+        sourcemaxval = 2 ** info["bitdepth"] - 1
+        del info["bitdepth"]
+        info["maxval"] = float(maxval)
+        factor = float(maxval) / float(sourcemaxval)
+
+        def iterfloat():
+            for row in pixels:
+                yield map(factor.__mul__, row)
+
+        return x, y, iterfloat(), info
+
+    def _as_rescale(self, get, targetbitdepth):
+        """Helper used by :meth:`asRGB8` and :meth:`asRGBA8`."""
+
+        width, height, pixels, meta = get()
+        maxval = 2 ** meta["bitdepth"] - 1
+        targetmaxval = 2**targetbitdepth - 1
+        factor = float(targetmaxval) / float(maxval)
+        meta["bitdepth"] = targetbitdepth
+
+        def iterscale():
+            for row in pixels:
+                yield (int(round(x * factor)) for x in row)
+
+        return width, height, iterscale(), meta
+
+    def asRGB8(self):
+        """Return the image data as an RGB pixels with 8-bits per
+        sample.  This is like the :meth:`asRGB` method except that
+        this method additionally rescales the values so that they
+        are all between 0 and 255 (8-bit).  In the case where the
+        source image has a bit depth < 8 the transformation preserves
+        all the information; where the source image has bit depth
+        > 8, then rescaling to 8-bit values loses precision.  No
+        dithering is performed.  Like :meth:`asRGB`, an alpha channel
+        in the source image will raise an exception.
+
+        This function returns a 4-tuple:
+        (*width*, *height*, *pixels*, *metadata*).
+        *width*, *height*, *metadata* are as per the :meth:`read` method.
+
+        *pixels* is the pixel data in boxed row flat pixel format.
+        """
+
+        return self._as_rescale(self.asRGB, 8)
+
+    def asRGBA8(self):
+        """Return the image data as RGBA pixels with 8-bits per
+        sample.  This method is similar to :meth:`asRGB8` and
+        :meth:`asRGBA`:  The result pixels have an alpha channel, *and*
+        values are rescaled to the range 0 to 255.  The alpha channel is
+        synthesized if necessary (with a small speed penalty).
+        """
+
+        return self._as_rescale(self.asRGBA, 8)
+
+    def asRGB(self):
+        """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
+        exception.
+
+        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['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["greyscale"]:
+            return width, height, pixels, meta
+        meta["greyscale"] = False
+        typecode = "BH"[meta["bitdepth"] > 8]
+
+        def iterrgb():
+            for row in pixels:
+                a = array(typecode, [0]) * 3 * width
+                for i in range(3):
+                    a[i::3] = row
+                yield a
+
+        return width, height, iterrgb(), meta
+
+    def asRGBA(self):
+        """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['greyscale']`` will be ``False``, and
+        ``metadata['alpha']`` will be ``True``.
+        """
+
+        width, height, pixels, meta = self.asDirect()
+        if meta["alpha"] and not meta["greyscale"]:
+            return width, height, pixels, meta
+        typecode = "BH"[meta["bitdepth"] > 8]
+        maxval = 2 ** meta["bitdepth"] - 1
+
+        def newarray():
+            return array(typecode, [0]) * 4 * width
+
+        if meta["alpha"] and meta["greyscale"]:
+            # LA to RGBA
+            def convert():
+                for row in pixels:
+                    # Create a fresh target row, then copy L channel
+                    # into first three target channels, and A channel
+                    # into fourth channel.
+                    a = newarray()
+                    for i in range(3):
+                        a[i::4] = row[0::2]
+                    a[3::4] = row[1::2]
+                    yield a
+
+        elif meta["greyscale"]:
+            # L to RGBA
+            def convert():
+                for row in pixels:
+                    a = newarray()
+                    for i in range(3):
+                        a[i::4] = row
+                    a[3::4] = array(typecode, [maxval]) * width
+                    yield a
+
+        else:
+            assert not meta["alpha"] and not meta["greyscale"]
+
+            # RGB to RGBA
+            def convert():
+                for row in pixels:
+                    a = newarray()
+                    for i in range(3):
+                        a[i::4] = row[i::3]
+                    a[3::4] = array(typecode, [maxval]) * width
+                    yield a
+
+        meta["alpha"] = True
+        meta["greyscale"] = False
+        return width, height, convert(), meta
+
+
+# === Internal Test Support ===
+
+# This section comprises the tests that are internally validated (as
+# opposed to tests which produce output files that are externally
+# validated).  Primarily they are unittests.
+
+# Note that it is difficult to internally validate the results of
+# writing a PNG file.  The only thing we can do is read it back in
+# again, which merely checks consistency, not that the PNG file we
+# produce is valid.
+
+# Run the tests from the command line:
+# python -c 'import png;png.test()'
+
+# (For an in-memory binary file IO object) We use BytesIO where
+# available, otherwise we use StringIO, but name it BytesIO.
+try:
+    from io import BytesIO
+except:
+    from StringIO import StringIO as BytesIO
+import tempfile
+import unittest
+
+
+def test():
+    unittest.main(__name__)
+
+
+def topngbytes(name, rows, x, y, **k):
+    """Convenience function for creating a PNG file "in memory" as a
+    string.  Creates a :class:`Writer` instance using the keyword arguments,
+    then passes `rows` to its :meth:`Writer.write` method.  The resulting
+    PNG file is returned as a string.  `name` is used to identify the file for
+    debugging.
+    """
+
+    import os
+
+    print(name)
+    f = BytesIO()
+    w = Writer(x, y, **k)
+    w.write(f, rows)
+    if os.environ.get("PYPNG_TEST_TMP"):
+        w = open(name, "wb")
+        w.write(f.getvalue())
+        w.close()
+    return f.getvalue()
+
+
+def testWithIO(inp, out, f):
+    """Calls the function `f` with ``sys.stdin`` changed to `inp`
+    and ``sys.stdout`` changed to `out`.  They are restored when `f`
+    returns.  This function returns whatever `f` returns.
+    """
+
+    import os
+
+    try:
+        oldin, sys.stdin = sys.stdin, inp
+        oldout, sys.stdout = sys.stdout, out
+        x = f()
+    finally:
+        sys.stdin = oldin
+        sys.stdout = oldout
+    if os.environ.get("PYPNG_TEST_TMP") and hasattr(out, "getvalue"):
+        name = mycallersname()
+        if name:
+            w = open(name + ".png", "wb")
+            w.write(out.getvalue())
+            w.close()
+    return x
+
+
+def mycallersname():
+    """Returns the name of the caller of the caller of this function
+    (hence the name of the caller of the function in which
+    "mycallersname()" textually appears).  Returns None if this cannot
+    be determined."""
+
+    # http://docs.python.org/library/inspect.html#the-interpreter-stack
+    import inspect
+
+    frame = inspect.currentframe()
+    if not frame:
+        return None
+    frame_, filename_, lineno_, funname, linelist_, listi_ = inspect.getouterframes(
+        frame
+    )[2]
+    return funname
+
+
+def seqtobytes(s):
+    """Convert a sequence of integers to a *bytes* instance.  Good for
+    plastering over Python 2 / Python 3 cracks.
+    """
+
+    return strtobytes("".join(chr(x) for x in s))
+
+
+class Test(unittest.TestCase):
+    # This member is used by the superclass.  If we don't define a new
+    # class here then when we use self.assertRaises() and the PyPNG code
+    # raises an assertion then we get no proper traceback.  I can't work
+    # out why, but defining a new class here means we get a proper
+    # traceback.
+    class failureException(Exception):
+        pass
+
+    def helperLN(self, n):
+        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, 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())
+        x, y, pixels, meta = r.read()
+        self.assertEqual(x, 15)
+        self.assertEqual(y, 17)
+        self.assertEqual(
+            list(itertools.chain(*pixels)), map(mask.__and__, range(1, 256))
+        )
+
+    def testL8(self):
+        return self.helperLN(8)
+
+    def testL4(self):
+        return self.helperLN(4)
+
+    def testL2(self):
+        "Also tests asRGB8."
+        w = Writer(1, 4, greyscale=True, bitdepth=2)
+        f = BytesIO()
+        w.write_array(f, array("B", range(4)))
+        r = Reader(bytes=f.getvalue())
+        x, y, pixels, meta = r.asRGB8()
+        self.assertEqual(x, 1)
+        self.assertEqual(y, 4)
+        for i, row in enumerate(pixels):
+            self.assertEqual(len(row), 3)
+            self.assertEqual(list(row), [0x55 * i] * 3)
+
+    def testP2(self):
+        "2-bit palette."
+        a = (255, 255, 255)
+        b = (200, 120, 120)
+        c = (50, 99, 50)
+        w = Writer(1, 4, bitdepth=2, palette=[a, b, c])
+        f = BytesIO()
+        w.write_array(f, array("B", (0, 1, 1, 2)))
+        r = Reader(bytes=f.getvalue())
+        x, y, pixels, meta = r.asRGB8()
+        self.assertEqual(x, 1)
+        self.assertEqual(y, 4)
+        self.assertEqual(list(pixels), map(list, [a, b, b, c]))
+
+    def testPtrns(self):
+        "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)
+        d = (200, 120, 120)
+        e = (50, 99, 50)
+        w = Writer(3, 3, bitdepth=4, palette=[a, b, c, d, e])
+        f = BytesIO()
+        w.write_array(f, array("B", (4, 3, 2, 3, 2, 0, 2, 0, 1)))
+        r = Reader(bytes=f.getvalue())
+        x, y, pixels, meta = r.asRGBA8()
+        self.assertEqual(x, 3)
+        self.assertEqual(y, 3)
+        c = c + (255,)
+        d = d + (255,)
+        e = e + (255,)
+        boxed = [(e, d, c), (d, c, a), (c, a, b)]
+        flat = (itertools.chain(*row) for row in boxed)
+        self.assertEqual(map(list, pixels), map(list, flat))
+
+    def testRGBtoRGBA(self):
+        "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.
+        row9 = list(pixels)[9]
+        self.assertEqual(row9[0:8], [0xFF, 0xDF, 0xFF, 0xFF, 0xFF, 0xDE, 0xFF, 0xFF])
+
+    def testLtoRGBA(self):
+        "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 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
+        row0 = list(pixels)[0]
+        self.assertEqual(tuple(row0[0:4]), (0x7F, 0x7F, 0x7F, 0x00))
+
+    def testAdam7read(self):
+        """Adam7 interlace reading.
+        Specifically, test that for images in the PngSuite that
+        have both an interlaced and straightlaced pair that both
+        images from the pair produce the same array of pixels."""
+        for candidate in _pngsuite:
+            if not candidate.startswith("basn"):
+                continue
+            candi = candidate.replace("n", "i")
+            if candi not in _pngsuite:
+                continue
+            print(f"adam7 read {candidate}")
+            straight = Reader(bytes=_pngsuite[candidate])
+            adam7 = Reader(bytes=_pngsuite[candi])
+            # Just compare the pixels.  Ignore x,y (because they're
+            # likely to be correct?); metadata is ignored because the
+            # "interlace" member differs.  Lame.
+            straight = straight.read()[2]
+            adam7 = adam7.read()[2]
+            self.assertEqual(map(list, straight), map(list, adam7))
+
+    def testAdam7write(self):
+        """Adam7 interlace writing.
+        For each test image in the PngSuite, write an interlaced
+        and a straightlaced version.  Decode both, and compare results.
+        """
+        # Not such a great test, because the only way we can check what
+        # we have written is to read it back again.
+
+        for name, bytes in _pngsuite.items():
+            # Only certain colour types supported for this test.
+            if name[3:5] not in ["n0", "n2", "n4", "n6"]:
+                continue
+            it = Reader(bytes=bytes)
+            x, y, pixels, meta = it.read()
+            pngi = topngbytes(
+                f"adam7wn{name}.png",
+                pixels,
+                x=x,
+                y=y,
+                bitdepth=it.bitdepth,
+                greyscale=it.greyscale,
+                alpha=it.alpha,
+                transparent=it.transparent,
+                interlace=False,
+            )
+            x, y, ps, meta = Reader(bytes=pngi).read()
+            it = Reader(bytes=bytes)
+            x, y, pixels, meta = it.read()
+            pngs = topngbytes(
+                f"adam7wi{name}.png",
+                pixels,
+                x=x,
+                y=y,
+                bitdepth=it.bitdepth,
+                greyscale=it.greyscale,
+                alpha=it.alpha,
+                transparent=it.transparent,
+                interlace=True,
+            )
+            x, y, pi, meta = Reader(bytes=pngs).read()
+            self.assertEqual(map(list, ps), map(list, pi))
+
+    def testPGMin(self):
+        """Test that the command line tool can read PGM files."""
+
+        def do():
+            return _main(["testPGMin"])
+
+        s = BytesIO()
+        s.write(strtobytes("P5 2 2 3\n"))
+        s.write(strtobytes("\x00\x01\x02\x03"))
+        s.flush()
+        s.seek(0)
+        o = BytesIO()
+        testWithIO(s, o, do)
+        r = Reader(bytes=o.getvalue())
+        x, y, pixels, meta = r.read()
+        self.assertTrue(r.greyscale)
+        self.assertEqual(r.bitdepth, 2)
+
+    def testPAMin(self):
+        """Test that the command line tool can read PAM file."""
+
+        def do():
+            return _main(["testPAMin"])
+
+        s = BytesIO()
+        s.write(
+            strtobytes(
+                "P7\nWIDTH 3\nHEIGHT 1\nDEPTH 4\nMAXVAL 255\n"
+                "TUPLTYPE RGB_ALPHA\nENDHDR\n"
+            )
+        )
+        # The pixels in flat row flat pixel format
+        flat = [255, 0, 0, 255, 0, 255, 0, 120, 0, 0, 255, 30]
+        asbytes = seqtobytes(flat)
+        s.write(asbytes)
+        s.flush()
+        s.seek(0)
+        o = BytesIO()
+        testWithIO(s, o, do)
+        r = Reader(bytes=o.getvalue())
+        x, y, pixels, meta = r.read()
+        self.assertTrue(r.alpha)
+        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, 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 generates sBIT chunk."""
+
+        def do():
+            return _main(["testPNMsbit"])
+
+        s = BytesIO()
+        s.write(strtobytes("P6 8 1 1\n"))
+        for pixel in range(8):
+            s.write(struct.pack(" 255:
+            a = array("H")
+        else:
+            a = array("B")
+        fw = float(width)
+        fh = float(height)
+        pfun = test_patterns[pattern]
+        for y in range(height):
+            fy = float(y) / fh
+            for x in range(width):
+                a.append(int(round(pfun(float(x) / fw, fy) * maxval)))
+        return a
+
+    def test_rgba(size=256, bitdepth=8, red="GTB", green="GLR", blue="RTL", alpha=None):
+        """
+        Create a test image.  Each channel is generated from the
+        specified pattern; any channel apart from red can be set to
+        None, which will cause it not to be in the image.  It
+        is possible to create all PNG channel types (L, RGB, LA, RGBA),
+        as well as non PNG channel types (RGA, and so on).
+        """
+
+        i = test_pattern(size, size, bitdepth, red)
+        psize = 1
+        for channel in (green, blue, alpha):
+            if channel:
+                c = test_pattern(size, size, bitdepth, channel)
+                i = interleave_planes(i, c, psize, 1)
+                psize += 1
+        return i
+
+    def pngsuite_image(name):
+        """
+        Create a test image by reading an internal copy of the files
+        from the PngSuite.  Returned in flat row flat pixel format.
+        """
+
+        if name not in _pngsuite:
+            raise NotImplementedError(
+                f"cannot find PngSuite file {name} (use -L for a list)"
+            )
+        r = Reader(bytes=_pngsuite[name])
+        w, h, pixels, meta = r.asDirect()
+        assert w == h
+        # LAn for n < 8 is a special case for which we need to rescale
+        # the data.
+        if meta["greyscale"] and meta["alpha"] and meta["bitdepth"] < 8:
+            factor = 255 // (2 ** meta["bitdepth"] - 1)
+
+            def rescale(data):
+                for row in data:
+                    yield map(factor.__mul__, row)
+
+            pixels = rescale(pixels)
+            meta["bitdepth"] = 8
+        arraycode = "BH"[meta["bitdepth"] > 8]
+        return w, array(arraycode, itertools.chain(*pixels)), meta
+
+    # The body of test_suite()
+    size = 256
+    if options.test_size:
+        size = options.test_size
+    options.bitdepth = options.test_depth
+    options.greyscale = bool(options.test_black)
+
+    kwargs = {}
+    if options.test_red:
+        kwargs["red"] = options.test_red
+    if options.test_green:
+        kwargs["green"] = options.test_green
+    if options.test_blue:
+        kwargs["blue"] = options.test_blue
+    if options.test_alpha:
+        kwargs["alpha"] = options.test_alpha
+    if options.greyscale:
+        if options.test_red or options.test_green or options.test_blue:
+            raise ValueError(
+                "cannot specify colours (R, G, B) when greyscale image (black channel, K) is specified"
+            )
+        kwargs["red"] = options.test_black
+        kwargs["green"] = None
+        kwargs["blue"] = None
+    options.alpha = bool(options.test_alpha)
+    if not args:
+        pixels = test_rgba(size, options.bitdepth, **kwargs)
+    else:
+        size, pixels, meta = pngsuite_image(args[0])
+        for k in ["bitdepth", "alpha", "greyscale"]:
+            setattr(options, k, meta[k])
+
+    writer = Writer(
+        size,
+        size,
+        bitdepth=options.bitdepth,
+        transparent=options.transparent,
+        background=options.background,
+        gamma=options.gamma,
+        greyscale=options.greyscale,
+        alpha=options.alpha,
+        compression=options.compression,
+        interlace=options.interlace,
+    )
+    writer.write_array(sys.stdout, pixels)
+
+
+def read_pam_header(infile):
+    """
+    Read (the rest of a) PAM header.  `infile` should be positioned
+    immediately after the initial 'P7' line (at the beginning of the
+    second line).  Returns are as for `read_pnm_header`.
+    """
+
+    # Unlike PBM, PGM, and PPM, we can read the header a line at a time.
+    header = {}
+    while True:
+        l = infile.readline().strip()
+        if l == strtobytes("ENDHDR"):
+            break
+        if not l:
+            raise EOFError("PAM ended prematurely")
+        if l[0] == strtobytes("#"):
+            continue
+        l = l.split(None, 1)
+        if l[0] not in header:
+            header[l[0]] = l[1]
+        else:
+            header[l[0]] += strtobytes(" ") + l[1]
+
+    required = ["WIDTH", "HEIGHT", "DEPTH", "MAXVAL"]
+    required = [strtobytes(x) for x in required]
+    WIDTH, HEIGHT, DEPTH, MAXVAL = required
+    present = [x for x in required if x in header]
+    if len(present) != len(required):
+        raise Error("PAM file must specify WIDTH, HEIGHT, DEPTH, and MAXVAL")
+    width = int(header[WIDTH])
+    height = int(header[HEIGHT])
+    depth = int(header[DEPTH])
+    maxval = int(header[MAXVAL])
+    if width <= 0 or height <= 0 or depth <= 0 or maxval <= 0:
+        raise Error("WIDTH, HEIGHT, DEPTH, MAXVAL must all be positive integers")
+    return "P7", width, height, depth, maxval
+
+
+def read_pnm_header(infile, supported=("P5", "P6")):
+    """
+    Read a PNM header, returning (format,width,height,depth,maxval).
+    `width` and `height` are in pixels.  `depth` is the number of
+    channels in the image; for PBM and PGM it is synthesized as 1, for
+    PPM as 3; for PAM images it is read from the header.  `maxval` is
+    synthesized (as 1) for PBM images.
+    """
+
+    # Generally, see http://netpbm.sourceforge.net/doc/ppm.html
+    # and http://netpbm.sourceforge.net/doc/pam.html
+
+    supported = [strtobytes(x) for x in supported]
+
+    # Technically 'P7' must be followed by a newline, so by using
+    # rstrip() we are being liberal in what we accept.  I think this
+    # is acceptable.
+    type = infile.read(3).rstrip()
+    if type not in supported:
+        raise NotImplementedError(f"file format {type} not supported")
+    if type == strtobytes("P7"):
+        # PAM header parsing is completely different.
+        return read_pam_header(infile)
+    # Expected number of tokens in header (3 for P4, 4 for P6)
+    expected = 4
+    pbm = ("P1", "P4")
+    if type in pbm:
+        expected = 3
+    header = [type]
+
+    # We have to read the rest of the header byte by byte because the
+    # final whitespace character (immediately following the MAXVAL in
+    # the case of P6) may not be a newline.  Of course all PNM files in
+    # the wild use a newline at this point, so it's tempting to use
+    # readline; but it would be wrong.
+    def getc():
+        c = infile.read(1)
+        if not c:
+            raise Error("premature EOF reading PNM header")
+        return c
+
+    c = getc()
+    while True:
+        # Skip whitespace that precedes a token.
+        while c.isspace():
+            c = getc()
+        # Skip comments.
+        while c == "#":
+            while c not in "\n\r":
+                c = getc()
+        if not c.isdigit():
+            raise Error(f"unexpected character {c} found in header")
+        # According to the specification it is legal to have comments
+        # that appear in the middle of a token.
+        # This is bonkers; I've never seen it; and it's a bit awkward to
+        # code good lexers in Python (no goto).  So we break on such
+        # cases.
+        token = strtobytes("")
+        while c.isdigit():
+            token += c
+            c = getc()
+        # Slight hack.  All "tokens" are decimal integers, so convert
+        # them here.
+        header.append(int(token))
+        if len(header) == expected:
+            break
+    # Skip comments (again)
+    while c == "#":
+        while c not in "\n\r":
+            c = getc()
+    if not c.isspace():
+        raise Error(f"expected header to end with whitespace, not {c}")
+
+    if type in pbm:
+        # synthesize a MAXVAL
+        header.append(1)
+    depth = (1, 3)[type == strtobytes("P6")]
+    return header[0], header[1], header[2], depth, header[3]
+
+
+def write_pnm(file, width, height, pixels, meta):
+    """Write a Netpbm PNM/PAM file."""
+
+    bitdepth = meta["bitdepth"]
+    maxval = 2**bitdepth - 1
+    # Rudely, the number of image planes can be used to determine
+    # whether we are L (PGM), LA (PAM), RGB (PPM), or RGBA (PAM).
+    planes = meta["planes"]
+    # Can be an assert as long as we assume that pixels and meta came
+    # from a PNG file.
+    assert planes in (1, 2, 3, 4)
+    if planes in (1, 3):
+        if 1 == planes:
+            # PGM
+            # Could generate PBM if maxval is 1, but we don't (for one
+            # thing, we'd have to convert the data, not just blat it
+            # out).
+            fmt = "P5"
+        else:
+            # PPM
+            fmt = "P6"
+        file.write("%s %d %d %d\n" % (fmt, width, height, maxval))
+    if planes in (2, 4):
+        # PAM
+        # See http://netpbm.sourceforge.net/doc/pam.html
+        if 2 == planes:
+            tupltype = "GRAYSCALE_ALPHA"
+        else:
+            tupltype = "RGB_ALPHA"
+        file.write(
+            "P7\nWIDTH %d\nHEIGHT %d\nDEPTH %d\nMAXVAL %d\n"
+            "TUPLTYPE %s\nENDHDR\n" % (width, height, planes, maxval, tupltype)
+        )
+    # Values per row
+    vpr = planes * width
+    # struct format
+    fmt = ">%d" % vpr
+    if maxval > 0xFF:
+        fmt = fmt + "H"
+    else:
+        fmt = fmt + "B"
+    for row in pixels:
+        file.write(struct.pack(fmt, *row))
+    file.flush()
+
+
+def color_triple(color):
+    """
+    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))
+    if color.startswith("#") and len(color) == 7:
+        return (int(color[1:3], 16), int(color[3:5], 16), int(color[5:7], 16))
+    elif color.startswith("#") and len(color) == 13:
+        return (int(color[1:5], 16), int(color[5:9], 16), int(color[9:13], 16))
+
+
+def _main(argv):
+    """
+    Run the PNG encoder with options from the command line.
+    """
+
+    # Parse command line arguments
+    from optparse import OptionParser
+    import re
+
+    version = "%prog " + re.sub(r"( ?\$|URL: |Rev:)", "", __version__)
+    parser = OptionParser(version=version)
+    parser.set_usage("%prog [options] [imagefile]")
+    parser.add_option(
+        "-r",
+        "--read-png",
+        default=False,
+        action="store_true",
+        help="Read PNG, write PNM",
+    )
+    parser.add_option(
+        "-i",
+        "--interlace",
+        default=False,
+        action="store_true",
+        help="create an interlaced PNG file (Adam7)",
+    )
+    parser.add_option(
+        "-t",
+        "--transparent",
+        action="store",
+        type="string",
+        metavar="color",
+        help="mark the specified colour (#RRGGBB) as transparent",
+    )
+    parser.add_option(
+        "-b",
+        "--background",
+        action="store",
+        type="string",
+        metavar="color",
+        help="save the specified background colour",
+    )
+    parser.add_option(
+        "-a",
+        "--alpha",
+        action="store",
+        type="string",
+        metavar="pgmfile",
+        help="alpha channel transparency (RGBA)",
+    )
+    parser.add_option(
+        "-g",
+        "--gamma",
+        action="store",
+        type="float",
+        metavar="value",
+        help="save the specified gamma value",
+    )
+    parser.add_option(
+        "-c",
+        "--compression",
+        action="store",
+        type="int",
+        metavar="level",
+        help="zlib compression level (0-9)",
+    )
+    parser.add_option(
+        "-T",
+        "--test",
+        default=False,
+        action="store_true",
+        help="create a test image (a named PngSuite image if an argument is supplied)",
+    )
+    parser.add_option(
+        "-L",
+        "--list",
+        default=False,
+        action="store_true",
+        help="print list of named test images",
+    )
+    parser.add_option(
+        "-R",
+        "--test-red",
+        action="store",
+        type="string",
+        metavar="pattern",
+        help="test pattern for the red image layer",
+    )
+    parser.add_option(
+        "-G",
+        "--test-green",
+        action="store",
+        type="string",
+        metavar="pattern",
+        help="test pattern for the green image layer",
+    )
+    parser.add_option(
+        "-B",
+        "--test-blue",
+        action="store",
+        type="string",
+        metavar="pattern",
+        help="test pattern for the blue image layer",
+    )
+    parser.add_option(
+        "-A",
+        "--test-alpha",
+        action="store",
+        type="string",
+        metavar="pattern",
+        help="test pattern for the alpha image layer",
+    )
+    parser.add_option(
+        "-K",
+        "--test-black",
+        action="store",
+        type="string",
+        metavar="pattern",
+        help="test pattern for greyscale image",
+    )
+    parser.add_option(
+        "-d",
+        "--test-depth",
+        default=8,
+        action="store",
+        type="int",
+        metavar="NBITS",
+        help="create test PNGs that are NBITS bits per channel",
+    )
+    parser.add_option(
+        "-S",
+        "--test-size",
+        action="store",
+        type="int",
+        metavar="size",
+        help="width and height of the test image",
+    )
+    (options, args) = parser.parse_args(args=argv[1:])
+
+    # Convert options
+    if options.transparent is not None:
+        options.transparent = color_triple(options.transparent)
+    if options.background is not None:
+        options.background = color_triple(options.background)
+
+    if options.list:
+        names = list(_pngsuite)
+        names.sort()
+        for name in names:
+            print(name)
+        return
+
+    # Run regression tests
+    if options.test:
+        return test_suite(options, args)
+
+    # Prepare input and output files
+    if len(args) == 0:
+        infilename = "-"
+        infile = sys.stdin
+    elif len(args) == 1:
+        infilename = args[0]
+        infile = open(infilename, "rb")
+    else:
+        parser.error("more than one input file")
+    outfile = sys.stdout
+
+    if options.read_png:
+        # Encode PNG to PPM
+        png = Reader(file=infile)
+        width, height, pixels, meta = png.asDirect()
+        write_pnm(outfile, width, height, pixels, meta)
+    else:
+        # Encode PNM to PNG
+        format, width, height, depth, maxval = read_pnm_header(
+            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 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.
+        greyscale = depth <= 2
+        pamalpha = depth in (2, 4)
+        supported = (2**x - 1 for x in range(1, 17))
+        try:
+            mi = supported.index(maxval)
+        except ValueError:
+            raise NotImplementedError(
+                f"your maxval ({maxval}) not in supported list {str(supported)}"
+            )
+        bitdepth = mi + 1
+        writer = Writer(
+            width,
+            height,
+            greyscale=greyscale,
+            bitdepth=bitdepth,
+            interlace=options.interlace,
+            transparent=options.transparent,
+            background=options.background,
+            alpha=bool(pamalpha or options.alpha),
+            gamma=options.gamma,
+            compression=options.compression,
+        )
+        if options.alpha:
+            pgmfile = open(options.alpha, "rb")
+            format, awidth, aheight, adepth, amaxval = read_pnm_header(pgmfile, "P5")
+            if amaxval != "255":
+                raise NotImplementedError(
+                    f"maxval {amaxval} not supported for alpha channel"
+                )
+            if (awidth, aheight) != (width, height):
+                raise ValueError(
+                    "alpha channel image size mismatch"
+                    " (%s has %sx%s but %s has %sx%s)"
+                    % (infilename, width, height, options.alpha, awidth, aheight)
+                )
+            writer.convert_ppm_and_pgm(infile, pgmfile, outfile)
+        else:
+            writer.convert_pnm(infile, outfile)
+
+
+if __name__ == "__main__":
+    try:
+        _main(sys.argv)
+    except Error as e:
+        sys.stderr.write(f"{e}\n")
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/test_utils/run_tests.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/test_utils/run_tests.py
new file mode 100644
index 0000000..69c1abb
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/test_utils/run_tests.py
@@ -0,0 +1,350 @@
+import sys
+
+if __name__ == "__main__":
+    raise RuntimeError("This module is for import only")
+test_pkg_name = ".".join(__name__.split(".")[0:-2])
+is_pygame_pkg = test_pkg_name == "pygame.tests"
+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 (
+        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 (
+        prepare_test_env,
+        run_test,
+        combine_results,
+        get_test_results,
+        TEST_RESULTS_START,
+    )
+import pygame
+import pygame.threads
+
+import os
+import re
+import shutil
+import tempfile
+import time
+import random
+from pprint import pformat
+
+was_run = False
+
+
+def run(*args, **kwds):
+    """Run the Pygame unit test suite and return (total tests run, fails dict)
+
+    Positional arguments (optional):
+    The names of tests to include. If omitted then all tests are run. Test
+    names need not include the trailing '_test'.
+
+    Keyword arguments:
+    incomplete - fail incomplete tests (default False)
+    usesubprocess - run all test suites in the current process
+                   (default False, use separate subprocesses)
+    dump - dump failures/errors as dict ready to eval (default False)
+    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. The items may be
+              comma or space separated.
+    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)
+    seed - if provided, a seed randomizer integer
+    multi_thread - if provided, the number of THREADS in which to run
+                   subprocessed tests
+    time_out - if subprocess is True then the time limit in seconds before
+               killing a test (default 30)
+    fake - if provided, the name of the fake tests package in the
+           run_tests__tests subpackage to run instead of the normal
+           Pygame tests
+    python - the path to a python executable to run subprocessed tests
+             (default sys.executable)
+    interactive - allow tests tagged 'interactive'.
+
+    Return value:
+    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
+    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 there 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.
+
+    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.
+
+    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
+    'subprocess_ignore' tags are ignored. 'interactive' is for modules that
+    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.
+
+    This function can only be called once per Python session. It is not
+    reentrant.
+
+    """
+
+    global was_run
+
+    if was_run:
+        raise RuntimeError("run() was already called this session")
+    was_run = True
+
+    options = kwds.copy()
+    option_usesubprocess = options.get("usesubprocess", False)
+    option_dump = options.pop("dump", False)
+    option_file = options.pop("file", None)
+    option_randomize = options.get("randomize", False)
+    option_seed = options.get("seed", None)
+    option_multi_thread = options.pop("multi_thread", 1)
+    option_time_out = options.pop("time_out", 120)
+    option_fake = options.pop("fake", None)
+    option_python = options.pop("python", sys.executable)
+    option_exclude = options.pop("exclude", ())
+    option_interactive = options.pop("interactive", False)
+
+    if not option_interactive and "interactive" not in option_exclude:
+        option_exclude += ("interactive",)
+    if option_usesubprocess and "subprocess_ignore" not in option_exclude:
+        option_exclude += ("subprocess_ignore",)
+    elif "ignore" not in option_exclude:
+        option_exclude += ("ignore",)
+
+    option_exclude += ("python3_ignore",)
+    option_exclude += ("SDL2_ignore",)
+
+    main_dir, test_subdir, fake_test_subdir = prepare_test_env()
+
+    ###########################################################################
+    # Compile a list of test modules. If fake, then compile list of fake
+    # xxxx_test.py from run_tests__tests
+
+    TEST_MODULE_RE = re.compile(r"^(.+_test)\.py$")
+
+    test_mods_pkg_name = test_pkg_name
+
+    working_dir_temp = tempfile.mkdtemp()
+
+    if option_fake is not None:
+        test_mods_pkg_name = ".".join(
+            [test_mods_pkg_name, "run_tests__tests", option_fake]
+        )
+        test_subdir = os.path.join(fake_test_subdir, option_fake)
+        working_dir = test_subdir
+    else:
+        working_dir = working_dir_temp
+
+    # Added in because some machines will need os.environ else there will be
+    # false failures in subprocess mode. Same issue as python2.6. Needs some
+    # env vars.
+
+    test_env = os.environ
+
+    fmt1 = "%s.%%s" % test_mods_pkg_name
+    fmt2 = "%s.%%s_test" % test_mods_pkg_name
+    if args:
+        test_modules = [m.endswith("_test") and (fmt1 % m) or (fmt2 % m) for m in args]
+    else:
+        test_modules = []
+        for f in sorted(os.listdir(test_subdir)):
+            for match in TEST_MODULE_RE.findall(f):
+                test_modules.append(fmt1 % (match,))
+
+    ###########################################################################
+    # Remove modules to be excluded.
+
+    tmp = test_modules
+    test_modules = []
+    for name in tmp:
+        tag_module_name = f"{name[0:-5]}_tags"
+        try:
+            tag_module = import_submodule(tag_module_name)
+        except ImportError:
+            test_modules.append(name)
+        else:
+            try:
+                tags = tag_module.__tags__
+            except AttributeError:
+                print(f"{tag_module_name} has no tags: ignoring")
+                test_modules.append(name)
+            else:
+                for tag in tags:
+                    if tag in option_exclude:
+                        print(f"skipping {name} (tag '{tag}')")
+                        break
+                else:
+                    test_modules.append(name)
+    del tmp, tag_module_name, name
+
+    ###########################################################################
+    # Meta results
+
+    results = {}
+    meta_results = {"__meta__": {}}
+    meta = meta_results["__meta__"]
+
+    ###########################################################################
+    # Randomization
+
+    if option_randomize or option_seed is not None:
+        if option_seed is None:
+            option_seed = time.time()
+        meta["random_seed"] = option_seed
+        print(f"\nRANDOM SEED USED: {option_seed}\n")
+        random.seed(option_seed)
+        random.shuffle(test_modules)
+
+    ###########################################################################
+    # Single process mode
+
+    if not option_usesubprocess:
+        options["exclude"] = option_exclude
+        t = time.time()
+        for module in test_modules:
+            results.update(run_test(module, **options))
+        t = time.time() - t
+
+    ###########################################################################
+    # Subprocess mode
+    #
+
+    else:
+        if is_pygame_pkg:
+            from pygame.tests.test_utils.async_sub import proc_in_time_or_kill
+        else:
+            from test.test_utils.async_sub import proc_in_time_or_kill
+
+        pass_on_args = ["--exclude", ",".join(option_exclude)] + [
+            "--" + field
+            for field in ("randomize", "incomplete", "unbuffered", "verbosity")
+            if kwds.get(field)
+        ]
+
+        def sub_test(module):
+            print(f"loading {module}")
+
+            cmd = [option_python, "-m", test_runner_mod, module] + pass_on_args
+
+            return (
+                module,
+                (cmd, test_env, working_dir),
+                proc_in_time_or_kill(
+                    cmd, option_time_out, env=test_env, wd=working_dir
+                ),
+            )
+
+        if option_multi_thread > 1:
+
+            def tmap(f, args):
+                return pygame.threads.tmap(
+                    f, args, stop_on_error=False, num_workers=option_multi_thread
+                )
+
+        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
+    #
+
+    untrusty_total, combined = combine_results(results, t)
+    total, n_errors, n_failures = count_results(results)
+
+    meta["total_tests"] = total
+    meta["combined"] = combined
+    meta["total_errors"] = n_errors
+    meta["total_failures"] = n_failures
+    results.update(meta_results)
+
+    if not option_usesubprocess and total != untrusty_total:
+        raise AssertionError(
+            "Something went wrong in the Test Machinery:\n"
+            "total: %d != untrusty_total: %d" % (total, untrusty_total)
+        )
+
+    if not option_dump:
+        print(combined)
+    else:
+        print(TEST_RESULTS_START)
+        print(pformat(results))
+
+    if option_file is not None:
+        results_file = open(option_file, "w")
+        try:
+            results_file.write(pformat(results))
+        finally:
+            results_file.close()
+
+    shutil.rmtree(working_dir_temp)
+
+    return total, n_errors + n_failures
+
+
+def count_results(results):
+    total = errors = failures = 0
+    for result in results.values():
+        if result.get("return_code", 0):
+            total += 1
+            errors += 1
+        else:
+            total += result["num_tests"]
+            errors += result["num_errors"]
+            failures += result["num_failures"]
+
+    return total, errors, failures
+
+
+def run_and_exit(*args, **kwargs):
+    """Run the tests, and if there are failures, exit with a return code of 1.
+
+    This is needed for various buildbots to recognise that the tests have
+    failed.
+    """
+    total, fails = run(*args, **kwargs)
+    if fails:
+        sys.exit(1)
+    sys.exit(0)
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/test_utils/test_machinery.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/test_utils/test_machinery.py
new file mode 100644
index 0000000..0531cc2
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/test_utils/test_machinery.py
@@ -0,0 +1,89 @@
+import inspect
+import random
+import re
+import unittest
+
+try:
+    from StringIO import StringIO
+except ImportError:
+    from io import StringIO
+
+from . import import_submodule
+
+
+class PygameTestLoader(unittest.TestLoader):
+    def __init__(
+        self, randomize_tests=False, include_incomplete=False, exclude=("interactive",)
+    ):
+        super().__init__()
+        self.randomize_tests = randomize_tests
+
+        if exclude is None:
+            self.exclude = set()
+        else:
+            self.exclude = set(exclude)
+
+        if include_incomplete:
+            self.testMethodPrefix = ("test", "todo_")
+
+    def getTestCaseNames(self, testCaseClass):
+        res = []
+        for name in super().getTestCaseNames(testCaseClass):
+            tags = get_tags(testCaseClass, getattr(testCaseClass, name))
+            if self.exclude.isdisjoint(tags):
+                res.append(name)
+
+        if self.randomize_tests:
+            random.shuffle(res)
+
+        return res
+
+
+# Exclude by tags:
+
+TAGS_RE = re.compile(r"\|[tT]ags:(-?[ a-zA-Z,0-9_\n]+)\|", re.M)
+
+
+class TestTags:
+    def __init__(self):
+        self.memoized = {}
+        self.parent_modules = {}
+
+    def get_parent_module(self, class_):
+        if class_ not in self.parent_modules:
+            self.parent_modules[class_] = import_submodule(class_.__module__)
+        return self.parent_modules[class_]
+
+    def __call__(self, parent_class, meth):
+        key = (parent_class, meth.__name__)
+        if key not in self.memoized:
+            parent_module = self.get_parent_module(parent_class)
+
+            module_tags = getattr(parent_module, "__tags__", [])
+            class_tags = getattr(parent_class, "__tags__", [])
+
+            tags = TAGS_RE.search(inspect.getdoc(meth) or "")
+            if tags:
+                test_tags = [t.strip() for t in tags.group(1).split(",")]
+            else:
+                test_tags = []
+
+            combined = set()
+            for tags in (module_tags, class_tags, test_tags):
+                if not tags:
+                    continue
+
+                add = {t for t in tags if not t.startswith("-")}
+                remove = {t[1:] for t in tags if t not in add}
+
+                if add:
+                    combined.update(add)
+                if remove:
+                    combined.difference_update(remove)
+
+            self.memoized[key] = combined
+
+        return self.memoized[key]
+
+
+get_tags = TestTags()
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/test_utils/test_runner.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/test_utils/test_runner.py
new file mode 100644
index 0000000..a19d7b0
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/test_utils/test_runner.py
@@ -0,0 +1,324 @@
+import sys
+import os
+
+if __name__ == "__main__":
+    pkg_dir = os.path.split(os.path.split(os.path.abspath(__file__))[0])[0]
+    parent_dir, pkg_name = os.path.split(pkg_dir)
+    is_pygame_pkg = pkg_name == "tests" and os.path.split(parent_dir)[1] == "pygame"
+    if not is_pygame_pkg:
+        sys.path.insert(0, parent_dir)
+else:
+    is_pygame_pkg = __name__.startswith("pygame.tests.")
+
+import io
+import optparse
+import re
+import unittest
+from pprint import pformat
+
+from .test_machinery import PygameTestLoader
+
+
+def prepare_test_env():
+    test_subdir = os.path.split(os.path.split(os.path.abspath(__file__))[0])[0]
+    main_dir = os.path.split(test_subdir)[0]
+    sys.path.insert(0, test_subdir)
+    fake_test_subdir = os.path.join(test_subdir, "run_tests__tests")
+    return main_dir, test_subdir, fake_test_subdir
+
+
+main_dir, test_subdir, fake_test_subdir = prepare_test_env()
+
+################################################################################
+# Set the command line options
+#
+# 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_]+"
+TAG_RE = re.compile(TAG_PAT)
+EXCLUDE_RE = re.compile(rf"({TAG_PAT},?\s*)+$")
+
+
+def exclude_callback(option, opt, value, parser):
+    if EXCLUDE_RE.match(value) is None:
+        raise optparse.OptionValueError(f"{opt} argument has invalid value")
+    parser.values.exclude = TAG_RE.findall(value)
+
+
+opt_parser = optparse.OptionParser()
+
+opt_parser.add_option(
+    "-i", "--incomplete", action="store_true", help="fail incomplete tests"
+)
+
+opt_parser.add_option(
+    "-s",
+    "--usesubprocess",
+    action="store_true",
+    help="run everything in a single process " " (default: use no subprocesses)",
+)
+
+opt_parser.add_option(
+    "-e",
+    "--exclude",
+    action="callback",
+    type="string",
+    help="exclude tests containing any of TAGS",
+    callback=exclude_callback,
+)
+
+opt_parser.add_option(
+    "-u",
+    "--unbuffered",
+    action="store_true",
+    help="Show stdout/stderr as tests run, rather than storing it and showing on failures",
+)
+
+opt_parser.add_option(
+    "-v",
+    "--verbose",
+    dest="verbosity",
+    action="store_const",
+    const=2,
+    help="Verbose output",
+)
+opt_parser.add_option(
+    "-q",
+    "--quiet",
+    dest="verbosity",
+    action="store_const",
+    const=0,
+    help="Quiet output",
+)
+
+opt_parser.add_option(
+    "-r", "--randomize", action="store_true", help="randomize order of tests"
+)
+
+################################################################################
+# If an xxxx_test.py takes longer than TIME_OUT seconds it will be killed
+# This is only the default, can be over-ridden on command line
+
+TIME_OUT = 30
+
+# DEFAULTS
+
+################################################################################
+# Human readable output
+#
+
+COMPLETE_FAILURE_TEMPLATE = """
+======================================================================
+ERROR: all_tests_for (%(module)s.AllTestCases)
+----------------------------------------------------------------------
+Traceback (most recent call last):
+  File "test/%(module)s.py", line 1, in all_tests_for
+subprocess completely failed with return code of %(return_code)s
+cmd:          %(cmd)s
+test_env:     %(test_env)s
+working_dir:  %(working_dir)s
+return (first 10 and last 10 lines):
+%(raw_return)s
+
+"""  # Leave that last empty line else build page regex won't match
+# Text also needs to be vertically compressed
+
+
+RAN_TESTS_DIV = (70 * "-") + "\nRan"
+
+DOTS = re.compile("^([FE.sux]*)$", re.MULTILINE)
+
+
+def extract_tracebacks(output):
+    """from test runner output return the tracebacks."""
+    verbose_mode = " ..." in output
+
+    if verbose_mode:
+        if "ERROR" in output or "FAILURE" in output:
+            return "\n\n==".join(output.split("\n\n==")[1:])
+    else:
+        dots = DOTS.search(output).group(1)
+        if "E" in dots or "F" in dots:
+            return output[len(dots) + 1 :].split(RAN_TESTS_DIV)[0]
+    return ""
+
+
+def output_into_dots(output):
+    """convert the test runner output into dots."""
+    # verbose_mode = ") ..." in output
+    verbose_mode = " ..." in output
+
+    if verbose_mode:
+        # a map from the verbose output to the dots output.
+        reasons = {
+            "... ERROR": "E",
+            "... unexpected success": "u",
+            "... skipped": "s",
+            "... expected failure": "x",
+            "... ok": ".",
+            "... FAIL": "F",
+        }
+        results = output.split("\n\n==")[0]
+        lines = [l for l in results.split("\n") if l and "..." in l]
+        dotlist = []
+        for l in lines:
+            found = False
+            for reason in reasons:
+                if reason in l:
+                    dotlist.append(reasons[reason])
+                    found = True
+                    break
+            if not found:
+                raise ValueError(f"Not sure what this is. Add to reasons. :{l}")
+
+        return "".join(dotlist)
+    dots = DOTS.search(output).group(1)
+    return dots
+
+
+def combine_results(all_results, t):
+    """
+
+    Return pieced together results in a form fit for human consumption. Don't
+    rely on results if  piecing together subprocessed  results (single process
+    mode is fine). Was originally meant for that  purpose but was found to be
+    unreliable.  See the dump option for reliable results.
+
+    """
+
+    all_dots = ""
+    failures = []
+
+    for module, results in sorted(all_results.items()):
+        output, return_code, raw_return = map(
+            results.get, ("output", "return_code", "raw_return")
+        )
+
+        if not output or (return_code and RAN_TESTS_DIV not in output):
+            # would this effect the original dict? TODO
+            output_lines = raw_return.splitlines()
+            if len(output_lines) > 20:
+                results["raw_return"] = "\n".join(
+                    output_lines[:10] + ["..."] + output_lines[-10:]
+                )
+            failures.append(COMPLETE_FAILURE_TEMPLATE % results)
+            all_dots += "E"
+            continue
+
+        dots = output_into_dots(output)
+        all_dots += dots
+        tracebacks = extract_tracebacks(output)
+        if tracebacks:
+            failures.append(tracebacks)
+
+    total_fails, total_errors = map(all_dots.count, "FE")
+    total_tests = len(all_dots)
+
+    combined = [all_dots]
+    if failures:
+        combined += ["".join(failures).lstrip("\n")[:-1]]
+    combined += [f"{RAN_TESTS_DIV} {total_tests} tests in {t:.3f}s\n"]
+
+    if failures:
+        infos = ([f"failures={total_fails}"] if total_fails else []) + (
+            [f"errors={total_errors}"] if total_errors else []
+        )
+        combined += [f"FAILED ({', '.join(infos)})\n"]
+    else:
+        combined += ["OK\n"]
+
+    return total_tests, "\n".join(combined)
+
+
+################################################################################
+
+TEST_RESULTS_START = "<--!! TEST RESULTS START HERE !!-->"
+TEST_RESULTS_END = "<--!! TEST RESULTS END HERE !!-->"
+_test_re_str = f"{TEST_RESULTS_START}\n(.*){TEST_RESULTS_END}"
+TEST_RESULTS_RE = re.compile(_test_re_str, re.DOTALL | re.M)
+
+
+def get_test_results(raw_return):
+    test_results = TEST_RESULTS_RE.search(raw_return)
+    if test_results:
+        try:
+            return eval(test_results.group(1))
+        except:
+            print(f"BUGGY TEST RESULTS EVAL:\n {test_results.group(1)}")
+            raise
+
+
+################################################################################
+
+
+def run_test(
+    module,
+    incomplete=False,
+    usesubprocess=True,
+    randomize=False,
+    exclude=("interactive",),
+    buffer=True,
+    unbuffered=None,
+    verbosity=1,
+):
+    """Run a unit test module"""
+    suite = unittest.TestSuite()
+
+    if verbosity is None:
+        verbosity = 1
+
+    if verbosity:
+        print(f"loading {module}")
+
+    loader = PygameTestLoader(
+        randomize_tests=randomize, include_incomplete=incomplete, exclude=exclude
+    )
+    suite.addTest(loader.loadTestsFromName(module))
+
+    output = io.StringIO()
+    runner = unittest.TextTestRunner(stream=output, buffer=buffer, verbosity=verbosity)
+    results = runner.run(suite)
+
+    if verbosity == 2:
+        output.seek(0)
+        print(output.read())
+        output.seek(0)
+
+    results = {
+        module: {
+            "output": output.getvalue(),
+            "num_tests": results.testsRun,
+            "num_errors": len(results.errors),
+            "num_failures": len(results.failures),
+        }
+    }
+
+    if usesubprocess:
+        print(TEST_RESULTS_START)
+        print(pformat(results))
+        print(TEST_RESULTS_END)
+    else:
+        return results
+
+
+################################################################################
+
+if __name__ == "__main__":
+    options, args = opt_parser.parse_args()
+    if not args:
+        if is_pygame_pkg:
+            run_from = "pygame.tests.go"
+        else:
+            run_from = os.path.join(main_dir, "run_tests.py")
+        sys.exit(f"No test module provided; consider using {run_from} instead")
+    run_test(
+        args[0],
+        incomplete=options.incomplete,
+        usesubprocess=options.usesubprocess,
+        randomize=options.randomize,
+        exclude=options.exclude,
+        buffer=(not options.unbuffered),
+    )
+
+################################################################################
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/threads_test.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/threads_test.py
new file mode 100644
index 0000000..ca9e1ae
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/threads_test.py
@@ -0,0 +1,238 @@
+import unittest
+from pygame.threads import FuncResult, tmap, WorkerQueue, Empty, STOP
+from pygame import threads, Surface, transform
+
+
+import time
+
+
+class WorkerQueueTypeTest(unittest.TestCase):
+    def test_usage_with_different_functions(self):
+        def f(x):
+            return x + 1
+
+        def f2(x):
+            return x + 2
+
+        wq = WorkerQueue()
+        fr = FuncResult(f)
+        fr2 = FuncResult(f2)
+        wq.do(fr, 1)
+        wq.do(fr2, 1)
+        wq.wait()
+        wq.stop()
+
+        self.assertEqual(fr.result, 2)
+        self.assertEqual(fr2.result, 3)
+
+    def test_do(self):
+        """Tests function placement on queue and execution after blocking function completion."""
+        # __doc__ (as of 2008-06-28) for pygame.threads.WorkerQueue.do:
+
+        # puts a function on a queue for running _later_.
+
+        # TODO: This tests needs refactoring to avoid sleep.
+        #       sleep is slow and unreliable (especially on VMs).
+
+        # def sleep_test():
+        #     time.sleep(0.5)
+
+        # def calc_test(x):
+        #     return x + 1
+
+        # worker_queue = WorkerQueue(num_workers=1)
+        # sleep_return = FuncResult(sleep_test)
+        # calc_return = FuncResult(calc_test)
+        # init_time = time.time()
+        # worker_queue.do(sleep_return)
+        # worker_queue.do(calc_return, 1)
+        # worker_queue.wait()
+        # worker_queue.stop()
+        # time_diff = time.time() - init_time
+
+        # self.assertEqual(sleep_return.result, None)
+        # self.assertEqual(calc_return.result, 2)
+        # self.assertGreaterEqual(time_diff, 0.5)
+
+    def test_stop(self):
+        """Ensure stop() stops the worker queue"""
+        wq = WorkerQueue()
+
+        self.assertGreater(len(wq.pool), 0)
+
+        for t in wq.pool:
+            self.assertTrue(t.is_alive())
+
+        for i in range(200):
+            wq.do(lambda x: x + 1, i)
+
+        wq.stop()
+
+        for t in wq.pool:
+            self.assertFalse(t.is_alive())
+
+        self.assertIs(wq.queue.get(), STOP)
+
+    def test_threadloop(self):
+        # __doc__ (as of 2008-06-28) for pygame.threads.WorkerQueue.threadloop:
+
+        # Loops until all of the tasks are finished.
+
+        # Make a worker queue with only one thread
+        wq = WorkerQueue(1)
+
+        # Ocuppy the one worker with the threadloop
+        # wq threads are just threadloop, so this makes an embedded threadloop
+        wq.do(wq.threadloop)
+
+        # Make sure wq can still do work
+        # If wq can still do work, threadloop works
+        l = []
+        wq.do(l.append, 1)
+        # Wait won't work because the primary thread is in an infinite loop
+        time.sleep(0.5)
+        self.assertEqual(l[0], 1)
+
+        # Kill the embedded threadloop by sending stop onto the stack
+        # Threadloop puts STOP back onto the queue when it STOPs so this kills both loops
+        wq.stop()
+
+        # Make sure wq has stopped
+        self.assertFalse(wq.pool[0].is_alive())
+
+    def test_wait(self):
+        # __doc__ (as of 2008-06-28) for pygame.threads.WorkerQueue.wait:
+
+        # waits until all tasks are complete.
+
+        wq = WorkerQueue()
+
+        for i in range(2000):
+            wq.do(lambda x: x + 1, i)
+        wq.wait()
+
+        self.assertRaises(Empty, wq.queue.get_nowait)
+
+        wq.stop()
+
+
+class ThreadsModuleTest(unittest.TestCase):
+    def test_benchmark_workers(self):
+        """Ensure benchmark_workers performance measure functions properly with both default and specified inputs"""
+        "tags:long_running"
+
+        # __doc__ (as of 2008-06-28) for pygame.threads.benchmark_workers:
+
+        # does a little test to see if workers are at all faster.
+        # Returns the number of workers which works best.
+        # Takes a little bit of time to run, so you should only really call
+        #   it once.
+        # You can pass in benchmark data, and functions if you want.
+        # a_bench_func - f(data)
+        # the_data - data to work on.
+        optimal_workers = threads.benchmark_workers()
+        self.assertIsInstance(optimal_workers, int)
+        self.assertTrue(0 <= optimal_workers < 64)
+
+        # Test passing benchmark data and function explicitly
+        def smooth_scale_bench(data):
+            transform.smoothscale(data, (128, 128))
+
+        surf_data = [Surface((x, x), 0, 32) for x in range(12, 64, 12)]
+        best_num_workers = threads.benchmark_workers(smooth_scale_bench, surf_data)
+        self.assertIsInstance(best_num_workers, int)
+
+    def test_init(self):
+        """Ensure init() sets up the worker queue"""
+        threads.init(8)
+
+        self.assertIsInstance(threads._wq, WorkerQueue)
+
+        threads.quit()
+
+    def test_quit(self):
+        """Ensure quit() cleans up the worker queue"""
+        threads.init(8)
+        threads.quit()
+
+        self.assertIsNone(threads._wq)
+
+    def test_tmap(self):
+        # __doc__ (as of 2008-06-28) for pygame.threads.tmap:
+
+        # like map, but uses a thread pool to execute.
+        # num_workers - the number of worker threads that will be used.  If pool
+        #                 is passed in, then the num_workers arg is ignored.
+        # worker_queue - you can optionally pass in an existing WorkerQueue.
+        # wait - True means that the results are returned when everything is finished.
+        #        False means that we return the [worker_queue, results] right away instead.
+        #        results, is returned as a list of FuncResult instances.
+        # stop_on_error -
+
+        ## test that the outcomes of map and tmap are the same
+        func, data = lambda x: x + 1, range(100)
+
+        tmapped = list(tmap(func, data))
+        mapped = list(map(func, data))
+
+        self.assertEqual(tmapped, mapped)
+
+        ## Test that setting tmap to not stop on errors produces the expected result
+        data2 = range(100)
+        always_excepts = lambda x: 1 / 0
+
+        tmapped2 = list(tmap(always_excepts, data2, stop_on_error=False))
+
+        # Use list comprehension to check all entries are None as all function
+        # calls made by tmap will have thrown an exception (ZeroDivisionError)
+        # Condense to single bool with `all`, which will return true if all
+        # entries are true
+        self.assertTrue(all(x is None for x in tmapped2))
+
+    def todo_test_tmap__None_func_and_multiple_sequences(self):
+        """Using a None as func and multiple sequences"""
+        self.fail()
+
+        res = tmap(None, [1, 2, 3, 4])
+        res2 = tmap(None, [1, 2, 3, 4], [22, 33, 44, 55])
+        res3 = tmap(None, [1, 2, 3, 4], [22, 33, 44, 55, 66])
+        res4 = tmap(None, [1, 2, 3, 4, 5], [22, 33, 44, 55])
+
+        self.assertEqual([1, 2, 3, 4], res)
+        self.assertEqual([(1, 22), (2, 33), (3, 44), (4, 55)], res2)
+        self.assertEqual([(1, 22), (2, 33), (3, 44), (4, 55), (None, 66)], res3)
+        self.assertEqual([(1, 22), (2, 33), (3, 44), (4, 55), (5, None)], res4)
+
+    def test_tmap__wait(self):
+        r = range(1000)
+        wq, results = tmap(lambda x: x, r, num_workers=5, wait=False)
+        wq.wait()
+        r2 = (x.result for x in results)
+        self.assertEqual(list(r), list(r2))
+
+    def test_FuncResult(self):
+        """Ensure FuncResult sets its result and exception attributes"""
+        # Results are stored in result attribute
+        fr = FuncResult(lambda x: x + 1)
+        fr(2)
+
+        self.assertEqual(fr.result, 3)
+
+        # Exceptions are store in exception attribute
+        self.assertIsNone(fr.exception, "no exception should be raised")
+
+        exception = ValueError("rast")
+
+        def x(sdf):
+            raise exception
+
+        fr = FuncResult(x)
+        fr(None)
+
+        self.assertIs(fr.exception, exception)
+
+
+################################################################################
+
+if __name__ == "__main__":
+    unittest.main()
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/time_test.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/time_test.py
new file mode 100644
index 0000000..95e04f0
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/time_test.py
@@ -0,0 +1,410 @@
+import os
+import platform
+import unittest
+import pygame
+import time
+
+Clock = pygame.time.Clock
+
+
+class ClockTypeTest(unittest.TestCase):
+    __tags__ = ["timing"]
+
+    def test_construction(self):
+        """Ensure a Clock object can be created"""
+        c = Clock()
+
+        self.assertTrue(c, "Clock cannot be constructed")
+
+    def test_get_fps(self):
+        """test_get_fps tests pygame.time.get_fps()"""
+        # Initialization check, first call should return 0 fps
+        c = Clock()
+        self.assertEqual(c.get_fps(), 0)
+        # Type check get_fps should return float
+        self.assertTrue(type(c.get_fps()) == float)
+        # Allowable margin of error in percentage
+        delta = 0.30
+        # Test fps correctness for 100, 60 and 30 fps
+        self._fps_test(c, 100, delta)
+        self._fps_test(c, 60, delta)
+        self._fps_test(c, 30, delta)
+
+    def _fps_test(self, clock, fps, delta):
+        """ticks fps times each second, hence get_fps() should return fps"""
+        delay_per_frame = 1.0 / fps
+        for f in range(fps):  # For one second tick and sleep
+            clock.tick()
+            time.sleep(delay_per_frame)
+        # We should get around fps (+- fps*delta -- delta % of fps)
+        self.assertAlmostEqual(clock.get_fps(), fps, delta=fps * delta)
+
+    def test_get_rawtime(self):
+        iterations = 10
+        delay = 0.1
+        delay_miliseconds = delay * (10**3)  # actual time difference between ticks
+        framerate_limit = 5
+        delta = 50  # allowable error in milliseconds
+
+        # Testing Clock Initialization
+        c = Clock()
+        self.assertEqual(c.get_rawtime(), 0)
+
+        # Testing Raw Time with Frame Delay
+        for f in range(iterations):
+            time.sleep(delay)
+            c.tick(framerate_limit)
+            c1 = c.get_rawtime()
+            self.assertAlmostEqual(delay_miliseconds, c1, delta=delta)
+
+        # Testing get_rawtime() = get_time()
+        for f in range(iterations):
+            time.sleep(delay)
+            c.tick()
+            c1 = c.get_rawtime()
+            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
+        delay_miliseconds = delay * (10**3)
+        iterations = 10
+        delta = 50  # milliseconds
+
+        # Testing Clock Initialization
+        c = Clock()
+        self.assertEqual(c.get_time(), 0)
+
+        # Testing within delay parameter range
+        for i in range(iterations):
+            time.sleep(delay)
+            c.tick()
+            c1 = c.get_time()
+            self.assertAlmostEqual(delay_miliseconds, c1, delta=delta)
+
+        # Comparing get_time() results with the 'time' module
+        for i in range(iterations):
+            t0 = time.time()
+            time.sleep(delay)
+            c.tick()
+            t1 = time.time()
+            c1 = c.get_time()  # elapsed time in milliseconds
+            d0 = (t1 - t0) * (
+                10**3
+            )  #'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()"""
+        """
+        Loops with a set delay a few times then checks what tick reports to
+        verify its accuracy. Then calls tick with a desired frame-rate and
+        verifies it is not faster than the desired frame-rate nor is it taking
+        a dramatically long time to complete
+        """
+
+        # Adjust this value to increase the acceptable sleep jitter
+        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
+        epsilon3 = 20
+        testing_framerate = 60
+        milliseconds = 5.0
+
+        collection = []
+        c = Clock()
+
+        # verify time.Clock.tick() will measure the time correctly
+        c.tick()
+        for i in range(100):
+            time.sleep(milliseconds / 1000)  # convert to seconds
+            collection.append(c.tick())
+
+        # removes the first highest and lowest value
+        for outlier in [min(collection), max(collection)]:
+            if outlier != milliseconds:
+                collection.remove(outlier)
+
+        average_time = float(sum(collection)) / len(collection)
+
+        # assert the deviation from the intended frame-rate is within the
+        # acceptable amount (the delay is not taking a dramatically long time)
+        self.assertAlmostEqual(average_time, milliseconds, delta=epsilon)
+
+        # verify tick will control the frame-rate
+
+        c = Clock()
+        collection = []
+
+        start = time.time()
+
+        for i in range(testing_framerate):
+            collection.append(c.tick(testing_framerate))
+
+        # remove the highest and lowest outliers
+        for outlier in [min(collection), max(collection)]:
+            if outlier != round(1000 / testing_framerate):
+                collection.remove(outlier)
+
+        end = time.time()
+
+        # Since calling tick with a desired fps will prevent the program from
+        # running at greater than the given fps, 100 iterations at 100 fps
+        # should last no less than 1 second
+        self.assertAlmostEqual(end - start, 1, delta=epsilon2)
+
+        average_tick_time = float(sum(collection)) / len(collection)
+        self.assertAlmostEqual(
+            1000 / average_tick_time, testing_framerate, delta=epsilon3
+        )
+
+    def test_tick_busy_loop(self):
+        """Test tick_busy_loop"""
+
+        c = Clock()
+
+        # Test whether the return value of tick_busy_loop is equal to
+        # (FPS is accurate) or greater than (slower than the set FPS)
+        # with a small margin for error based on differences in how this
+        # test runs in practise - it either sometimes runs slightly fast
+        # or seems to based on a rounding error.
+        second_length = 1000
+        shortfall_tolerance = 1  # (ms) The amount of time a tick is allowed to run short of, to account for underlying rounding errors
+        sample_fps = 40
+
+        self.assertGreaterEqual(
+            c.tick_busy_loop(sample_fps),
+            (second_length / sample_fps) - shortfall_tolerance,
+        )
+        pygame.time.wait(10)  # incur delay between ticks that's faster than sample_fps
+        self.assertGreaterEqual(
+            c.tick_busy_loop(sample_fps),
+            (second_length / sample_fps) - shortfall_tolerance,
+        )
+        pygame.time.wait(200)  # incur delay between ticks that's slower than sample_fps
+        self.assertGreaterEqual(
+            c.tick_busy_loop(sample_fps),
+            (second_length / sample_fps) - shortfall_tolerance,
+        )
+
+        high_fps = 500
+        self.assertGreaterEqual(
+            c.tick_busy_loop(high_fps), (second_length / high_fps) - shortfall_tolerance
+        )
+
+        low_fps = 1
+        self.assertGreaterEqual(
+            c.tick_busy_loop(low_fps), (second_length / low_fps) - shortfall_tolerance
+        )
+
+        low_non_factor_fps = 35  # 1000/35 makes 28.5714285714
+        frame_length_without_decimal_places = int(
+            second_length / low_non_factor_fps
+        )  # Same result as math.floor
+        self.assertGreaterEqual(
+            c.tick_busy_loop(low_non_factor_fps),
+            frame_length_without_decimal_places - shortfall_tolerance,
+        )
+
+        high_non_factor_fps = 750  # 1000/750 makes 1.3333...
+        frame_length_without_decimal_places_2 = int(
+            second_length / high_non_factor_fps
+        )  # Same result as math.floor
+        self.assertGreaterEqual(
+            c.tick_busy_loop(high_non_factor_fps),
+            frame_length_without_decimal_places_2 - shortfall_tolerance,
+        )
+
+        zero_fps = 0
+        self.assertEqual(c.tick_busy_loop(zero_fps), 0)
+
+        # Check behaviour of unexpected values
+
+        negative_fps = -1
+        self.assertEqual(c.tick_busy_loop(negative_fps), 0)
+
+        fractional_fps = 32.75
+        frame_length_without_decimal_places_3 = int(second_length / fractional_fps)
+        self.assertGreaterEqual(
+            c.tick_busy_loop(fractional_fps),
+            frame_length_without_decimal_places_3 - shortfall_tolerance,
+        )
+
+        bool_fps = True
+        self.assertGreaterEqual(
+            c.tick_busy_loop(bool_fps), (second_length / bool_fps) - shortfall_tolerance
+        )
+
+
+class TimeModuleTest(unittest.TestCase):
+    __tags__ = ["timing"]
+
+    @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
+        iterations = 20  # number of iterations
+        delta = 150  # Represents acceptable margin of error for wait in ms
+        # Call checking function
+        self._wait_delay_check(pygame.time.delay, millis, iterations, delta)
+        # After timing behaviour, check argument type exceptions
+        self._type_error_checks(pygame.time.delay)
+
+    def test_get_ticks(self):
+        """Tests time.get_ticks()"""
+        """
+         Iterates and delays for arbitrary amount of time for each iteration,
+         check get_ticks to equal correct gap time
+        """
+        iterations = 20
+        millis = 50
+        delta = 15  # Acceptable margin of error in ms
+        # Assert return type to be int
+        self.assertTrue(type(pygame.time.get_ticks()) == int)
+        for i in range(iterations):
+            curr_ticks = pygame.time.get_ticks()  # Save current tick count
+            curr_time = time.time()  # Save current time
+            pygame.time.delay(millis)  # Delay for millis
+            # Time and Ticks difference from start of the iteration
+            time_diff = round((time.time() - curr_time) * 1000)
+            ticks_diff = pygame.time.get_ticks() - curr_ticks
+            # 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()"""
+        """
+        Tests if a timer will post the correct amount of eventid events in
+        the specified delay. Test is posting event objects work.
+        Also tests if setting milliseconds to 0 stops the timer and if
+        the once argument and repeat arguments work.
+        """
+        pygame.init()
+        TIMER_EVENT_TYPE = pygame.event.custom_type()
+        timer_event = pygame.event.Event(TIMER_EVENT_TYPE)
+        delta = 50
+        timer_delay = 100
+        test_number = 8  # Number of events to read for the test
+        events = 0  # Events read
+
+        pygame.event.clear()
+        pygame.time.set_timer(TIMER_EVENT_TYPE, timer_delay)
+
+        # Test that 'test_number' events are posted in the right amount of time
+        t1 = pygame.time.get_ticks()
+        max_test_time = t1 + timer_delay * test_number + delta
+        while events < test_number:
+            for event in pygame.event.get():
+                if event == timer_event:
+                    events += 1
+
+            # The test takes too much time
+            if pygame.time.get_ticks() > max_test_time:
+                break
+
+        pygame.time.set_timer(TIMER_EVENT_TYPE, 0)
+        t2 = pygame.time.get_ticks()
+        # Is the number ef events and the timing right?
+        self.assertEqual(events, test_number)
+        self.assertAlmostEqual(timer_delay * test_number, t2 - t1, delta=delta)
+
+        # Test that the timer stopped when set with 0ms delay.
+        pygame.time.delay(200)
+        self.assertNotIn(timer_event, pygame.event.get())
+
+        # Test that the old timer for an event is deleted when a new timer is set
+        pygame.time.set_timer(TIMER_EVENT_TYPE, timer_delay)
+        pygame.time.delay(int(timer_delay * 3.5))
+        self.assertEqual(pygame.event.get().count(timer_event), 3)
+        pygame.time.set_timer(TIMER_EVENT_TYPE, timer_delay * 10)  # long wait time
+        pygame.time.delay(timer_delay * 5)
+        self.assertNotIn(timer_event, pygame.event.get())
+        pygame.time.set_timer(TIMER_EVENT_TYPE, timer_delay * 3)
+        pygame.time.delay(timer_delay * 7)
+        self.assertEqual(pygame.event.get().count(timer_event), 2)
+        pygame.time.set_timer(TIMER_EVENT_TYPE, timer_delay)
+        pygame.time.delay(int(timer_delay * 5.5))
+        self.assertEqual(pygame.event.get().count(timer_event), 5)
+
+        # Test that the loops=True works
+        pygame.time.set_timer(TIMER_EVENT_TYPE, 10, True)
+        pygame.time.delay(40)
+        self.assertEqual(pygame.event.get().count(timer_event), 1)
+
+        # Test a variety of event objects, test loops argument
+        events_to_test = [
+            pygame.event.Event(TIMER_EVENT_TYPE),
+            pygame.event.Event(
+                TIMER_EVENT_TYPE, foo="9gwz5", baz=12, lol=[124, (34, "")]
+            ),
+            pygame.event.Event(pygame.KEYDOWN, key=pygame.K_a, unicode="a"),
+        ]
+        repeat = 3
+        millis = 50
+        for e in events_to_test:
+            pygame.time.set_timer(e, millis, loops=repeat)
+            pygame.time.delay(2 * millis * repeat)
+            self.assertEqual(pygame.event.get().count(e), repeat)
+        pygame.quit()
+
+    def test_wait(self):
+        """Tests time.wait() function."""
+        millis = 100  # millisecond to wait on each iteration
+        iterations = 10  # number of iterations
+        delta = 50  # Represents acceptable margin of error for wait in ms
+        # Call checking function
+        self._wait_delay_check(pygame.time.wait, millis, iterations, delta)
+        # After timing behaviour, check argument type exceptions
+        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
+        be equal to millis (+- delta - acceptable margin of error).
+        *Created to avoid code duplication during delay and wait tests
+        """
+        # take starting time for duration calculation
+        start_time = time.time()
+        for i in range(iterations):
+            wait_time = func_to_check(millis)
+            # Check equality of wait_time and millis with margin of error delta
+            self.assertAlmostEqual(wait_time, millis, delta=delta)
+        stop_time = time.time()
+        # Cycle duration in millisecond
+        duration = round((stop_time - start_time) * 1000)
+        # Duration/Iterations should be (almost) equal to predefined millis
+        self.assertAlmostEqual(duration / iterations, millis, delta=delta)
+
+    def _type_error_checks(self, func_to_check):
+        """Checks 3 TypeError (float, tuple, string) for the func_to_check"""
+        """Intended for time.delay and time.wait functions"""
+        # Those methods throw no exceptions on negative integers
+        self.assertRaises(TypeError, func_to_check, 0.1)  # check float
+        self.assertRaises(TypeError, pygame.time.delay, (0, 1))  # check tuple
+        self.assertRaises(TypeError, pygame.time.delay, "10")  # check string
+
+
+###############################################################################
+
+if __name__ == "__main__":
+    unittest.main()
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/touch_test.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/touch_test.py
new file mode 100644
index 0000000..259a2c7
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/touch_test.py
@@ -0,0 +1,97 @@
+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):
+        pygame.display.init()
+
+    @classmethod
+    def tearDownClass(cls):
+        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):
+        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):
+        touch.get_num_fingers(touch.get_device(0))
+
+    def test_num_fingers__invalid(self):
+        self.assertRaises(TypeError, touch.get_num_fingers, "test")
+        self.assertRaises(pygame.error, touch.get_num_fingers, -1234)
+
+
+class TouchInteractiveTest(unittest.TestCase):
+    __tags__ = ["interactive"]
+
+    @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((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"
+        )
+        inst_1_render = font.render(instructions_str_1, True, pygame.Color("#000000"))
+        inst_2_render = font.render(instructions_str_2, True, pygame.Color("#000000"))
+
+        running = True
+        while running:
+            for event in pygame.event.get():
+                if event.type == pygame.QUIT:
+                    running = False
+
+            finger_data_renders = []
+            num_devices = pygame._sdl2.touch.get_num_devices()
+            if num_devices > 0:
+                first_device = pygame._sdl2.touch.get_device(0)
+                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)
+                        render = font.render(
+                            f"finger - {data}", True, pygame.Color("#000000")
+                        )
+
+                        finger_data_renders.append(render)
+
+            screen.fill((255, 255, 255))
+            screen.blit(inst_1_render, (5, 5))
+            screen.blit(inst_2_render, (5, 40))
+            for index, finger in enumerate(finger_data_renders):
+                screen.blit(finger, (5, 80 + (index * 40)))
+
+            pygame.display.update()
+
+        response = question("Does the finger data seem correct?")
+        self.assertTrue(response)
+
+        pygame.display.quit()
+
+
+if __name__ == "__main__":
+    unittest.main()
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/transform_test.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/transform_test.py
new file mode 100644
index 0000000..b7c64e9
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/transform_test.py
@@ -0,0 +1,1420 @@
+import unittest
+import os
+import platform
+
+from pygame.tests import test_utils
+from pygame.tests.test_utils import example_path
+
+import pygame
+import pygame.transform
+from pygame.locals import *
+
+
+def show_image(s, images=[]):
+    # pygame.display.init()
+    size = s.get_rect()[2:]
+    screen = pygame.display.set_mode(size)
+    screen.blit(s, (0, 0))
+    pygame.display.flip()
+    pygame.event.pump()
+    going = True
+    idx = 0
+    while going:
+        events = pygame.event.get()
+        for e in events:
+            if e.type == QUIT:
+                going = False
+            if e.type == KEYDOWN:
+                if e.key in [K_s, K_a]:
+                    if e.key == K_s:
+                        idx += 1
+                    if e.key == K_a:
+                        idx -= 1
+                    s = images[idx]
+                    screen.blit(s, (0, 0))
+                    pygame.display.flip()
+                    pygame.event.pump()
+                elif e.key in [K_ESCAPE]:
+                    going = False
+    pygame.display.quit()
+    pygame.display.init()
+
+
+def threshold(
+    return_surf,
+    surf,
+    color,
+    threshold=(0, 0, 0),
+    diff_color=(0, 0, 0),
+    change_return=True,
+):
+    """given the color it makes return_surf only have areas with the given colour."""
+
+    width, height = surf.get_width(), surf.get_height()
+
+    if change_return:
+        return_surf.fill(diff_color)
+
+    try:
+        r, g, b = color
+    except ValueError:
+        r, g, b, a = color
+
+    try:
+        tr, tg, tb = color
+    except ValueError:
+        tr, tg, tb, ta = color
+
+    similar = 0
+    for y in range(height):
+        for x in range(width):
+            c1 = surf.get_at((x, y))
+
+            if (abs(c1[0] - r) < tr) & (abs(c1[1] - g) < tg) & (abs(c1[2] - b) < tb):
+                # this pixel is within the threshold.
+                if change_return:
+                    return_surf.set_at((x, y), c1)
+                similar += 1
+            # else:
+            #    print(c1, c2)
+
+    return similar
+
+
+class TransformModuleTest(unittest.TestCase):
+    def test_scale__alpha(self):
+        """see if set_alpha information is kept."""
+
+        s = pygame.Surface((32, 32))
+        s.set_alpha(55)
+        self.assertEqual(s.get_alpha(), 55)
+
+        s = pygame.Surface((32, 32))
+        s.set_alpha(55)
+        s2 = pygame.transform.scale(s, (64, 64))
+        s3 = s.copy()
+        self.assertEqual(s.get_alpha(), s3.get_alpha())
+        self.assertEqual(s.get_alpha(), s2.get_alpha())
+
+    def test_scale__destination(self):
+        """see if the destination surface can be passed in to use."""
+
+        s = pygame.Surface((32, 32))
+        s2 = pygame.transform.scale(s, (64, 64))
+        s3 = s2.copy()
+
+        # Also validate keyword arguments
+        s3 = pygame.transform.scale(surface=s, size=(64, 64), dest_surface=s3)
+        pygame.transform.scale(s, (64, 64), s2)
+
+        # the wrong size surface is past in.  Should raise an error.
+        self.assertRaises(ValueError, pygame.transform.scale, s, (33, 64), s3)
+
+        s = pygame.Surface((32, 32))
+        s2 = pygame.transform.smoothscale(s, (64, 64))
+        s3 = s2.copy()
+
+        # Also validate keyword arguments
+        s3 = pygame.transform.smoothscale(surface=s, size=(64, 64), dest_surface=s3)
+
+        # the wrong size surface is past in.  Should raise an error.
+        self.assertRaises(ValueError, pygame.transform.smoothscale, s, (33, 64), s3)
+
+    def test_scale__vector2(self):
+        s = pygame.Surface((32, 32))
+        s2 = pygame.transform.scale(s, pygame.Vector2(64, 64))
+        s3 = pygame.transform.smoothscale(s, pygame.Vector2(64, 64))
+
+        self.assertEqual((64, 64), s2.get_size())
+        self.assertEqual((64, 64), s3.get_size())
+
+    def test_scale__zero_surface_transform(self):
+        tmp_surface = pygame.transform.scale(pygame.Surface((128, 128)), (0, 0))
+        self.assertEqual(tmp_surface.get_size(), (0, 0))
+        tmp_surface = pygame.transform.scale(tmp_surface, (128, 128))
+        self.assertEqual(tmp_surface.get_size(), (128, 128))
+
+    def test_scale_by(self):
+        s = pygame.Surface((32, 32))
+
+        s2 = pygame.transform.scale_by(s, 2)
+        self.assertEqual((64, 64), s2.get_size())
+
+        s2 = pygame.transform.scale_by(s, factor=(2.0, 1.5))
+        self.assertEqual((64, 48), s2.get_size())
+
+        dest = pygame.Surface((64, 48))
+        pygame.transform.scale_by(s, (2.0, 1.5), dest_surface=dest)
+
+    def test_smoothscale_by(self):
+        s = pygame.Surface((32, 32))
+
+        s2 = pygame.transform.smoothscale_by(s, 2)
+        self.assertEqual((64, 64), s2.get_size())
+
+        s2 = pygame.transform.smoothscale_by(s, factor=(2.0, 1.5))
+        self.assertEqual((64, 48), s2.get_size())
+
+        dest = pygame.Surface((64, 48))
+        pygame.transform.smoothscale_by(s, (2.0, 1.5), dest_surface=dest)
+
+    def test_grayscale(self):
+        s = pygame.Surface((32, 32))
+        s.fill((255, 0, 0))
+
+        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)
+        self.assertEqual(pygame.transform.average_color(dest)[0], 76)
+        self.assertEqual(pygame.transform.average_color(dest)[1], 76)
+        self.assertEqual(pygame.transform.average_color(dest)[2], 76)
+
+        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], 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], [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))
+        dest = pygame.Surface((32, 32), depth=24)
+        pygame.transform.grayscale(s, dest)
+        self.assertEqual(pygame.transform.average_color(dest)[0], 76)
+        self.assertEqual(pygame.transform.average_color(dest)[1], 76)
+        self.assertEqual(pygame.transform.average_color(dest)[2], 76)
+
+        s = pygame.Surface((32, 32), depth=16)
+        s.fill((255, 0, 0))
+        dest = pygame.Surface((32, 32), depth=16)
+        pygame.transform.grayscale(s, dest)
+        self.assertEqual(pygame.transform.average_color(dest)[0], 72)
+        self.assertEqual(pygame.transform.average_color(dest)[1], 76)
+        self.assertEqual(pygame.transform.average_color(dest)[2], 72)
+
+    def test_threshold__honors_third_surface(self):
+        # __doc__ for threshold as of Tue 07/15/2008
+
+        # pygame.transform.threshold(DestSurface, Surface, color, threshold =
+        # (0,0,0,0), diff_color = (0,0,0,0), change_return = True, Surface =
+        # None): return num_threshold_pixels
+
+        # When given the optional third
+        # surface, it would use the colors in that rather than the "color"
+        # specified in the function to check against.
+
+        # New in pygame 1.8
+
+        ################################################################
+        # Sizes
+        (w, h) = size = (32, 32)
+
+        # the original_color is within the threshold of the threshold_color
+        threshold = (20, 20, 20, 20)
+
+        original_color = (25, 25, 25, 25)
+        threshold_color = (10, 10, 10, 10)
+
+        # Surfaces
+        original_surface = pygame.Surface(size, pygame.SRCALPHA, 32)
+        dest_surface = pygame.Surface(size, pygame.SRCALPHA, 32)
+
+        # Third surface is used in lieu of 3rd position arg color
+        third_surface = pygame.Surface(size, pygame.SRCALPHA, 32)
+
+        # Color filling
+        original_surface.fill(original_color)
+        third_surface.fill(threshold_color)
+
+        ################################################################
+        # All pixels for color should be within threshold
+        #
+        pixels_within_threshold = pygame.transform.threshold(
+            dest_surface=None,
+            surface=original_surface,
+            search_color=threshold_color,
+            threshold=threshold,
+            set_color=None,
+            set_behavior=0,
+        )
+
+        self.assertEqual(w * h, pixels_within_threshold)
+
+        ################################################################
+        # This should respect third_surface colors in place of 3rd arg
+        # color Should be the same as: surface.fill(threshold_color)
+        # all within threshold
+
+        pixels_within_threshold = pygame.transform.threshold(
+            dest_surface=None,
+            surface=original_surface,
+            search_color=None,
+            threshold=threshold,
+            set_color=None,
+            set_behavior=0,
+            search_surf=third_surface,
+        )
+        self.assertEqual(w * h, pixels_within_threshold)
+
+    def test_threshold_dest_surf_not_change(self):
+        """the pixels within the threshold.
+
+        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)
+
+    def test_threshold_dest_surf_all_changed(self):
+        """Lowering the threshold, expecting changed surface"""
+
+        (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)
+
+        THRESHOLD_BEHAVIOR_FROM_SEARCH_COLOR = 1
+        pixels_within_threshold = pygame.transform.threshold(
+            dest_surf,
+            surf,
+            search_color=None,
+            set_color=set_color,
+            set_behavior=THRESHOLD_BEHAVIOR_FROM_SEARCH_COLOR,
+            search_surf=search_surf,
+        )
+
+        self.assertEqual(0, pixels_within_threshold)
+
+        dest_rect = dest_surf.get_rect()
+        dest_size = dest_rect.size
+        self.assertEqual(size, dest_size)
+
+        # The color is the set_color specified for every pixel As all
+        # pixels are not within threshold
+        for pt in test_utils.rect_area_pts(dest_rect):
+            self.assertEqual(dest_surf.get_at(pt), set_color)
+
+    def test_threshold_count(self):
+        """counts the colors, and not changes them."""
+        surf_size = (32, 32)
+        surf = pygame.Surface(surf_size, pygame.SRCALPHA, 32)
+        search_surf = pygame.Surface(surf_size, pygame.SRCALPHA, 32)
+        search_color = (55, 55, 55, 255)
+        original_color = (10, 10, 10, 255)
+
+        surf.fill(original_color)
+        # set 2 pixels to the color we are searching for.
+        surf.set_at((0, 0), search_color)
+        surf.set_at((12, 5), search_color)
+
+        # There is no destination surface, but we ask to change it.
+        #   This should be an error.
+        self.assertRaises(
+            TypeError, pygame.transform.threshold, None, surf, search_color
+        )
+        # from pygame.transform import THRESHOLD_BEHAVIOR_COUNT
+        THRESHOLD_BEHAVIOR_FROM_SEARCH_SURF = 2
+        self.assertRaises(
+            TypeError,
+            pygame.transform.threshold,
+            None,
+            surf,
+            search_color,
+            set_behavior=THRESHOLD_BEHAVIOR_FROM_SEARCH_SURF,
+        )
+
+        THRESHOLD_BEHAVIOR_COUNT = 0
+        num_threshold_pixels = pygame.transform.threshold(
+            dest_surface=None,
+            surface=surf,
+            search_color=search_color,
+            set_behavior=THRESHOLD_BEHAVIOR_COUNT,
+        )
+        self.assertEqual(num_threshold_pixels, 2)
+
+    def test_threshold_search_surf(self):
+        surf_size = (32, 32)
+        surf = pygame.Surface(surf_size, pygame.SRCALPHA, 32)
+        search_surf = pygame.Surface(surf_size, pygame.SRCALPHA, 32)
+        dest_surf = pygame.Surface(surf_size, pygame.SRCALPHA, 32)
+
+        original_color = (10, 10, 10, 255)
+        search_color = (55, 55, 55, 255)
+
+        surf.fill(original_color)
+        dest_surf.fill(original_color)
+        # set 2 pixels to the color we are searching for.
+        surf.set_at((0, 0), search_color)
+        surf.set_at((12, 5), search_color)
+
+        search_surf.fill(search_color)
+
+        # We look in the other surface for matching colors.
+        #  Change it in dest_surf
+        THRESHOLD_BEHAVIOR_FROM_SEARCH_SURF = 2
+
+        # TypeError: if search_surf is used, search_color should be None
+        self.assertRaises(
+            TypeError,
+            pygame.transform.threshold,
+            dest_surf,
+            surf,
+            search_color,
+            set_behavior=THRESHOLD_BEHAVIOR_FROM_SEARCH_SURF,
+            search_surf=search_surf,
+        )
+
+        # surf, dest_surf, and search_surf should all be the same size.
+        # Check surface sizes are the same size.
+        different_sized_surf = pygame.Surface((22, 33), pygame.SRCALPHA, 32)
+        self.assertRaises(
+            TypeError,
+            pygame.transform.threshold,
+            different_sized_surf,
+            surf,
+            search_color=None,
+            set_color=None,
+            set_behavior=THRESHOLD_BEHAVIOR_FROM_SEARCH_SURF,
+            search_surf=search_surf,
+        )
+
+        self.assertRaises(
+            TypeError,
+            pygame.transform.threshold,
+            dest_surf,
+            surf,
+            search_color=None,
+            set_color=None,
+            set_behavior=THRESHOLD_BEHAVIOR_FROM_SEARCH_SURF,
+            search_surf=different_sized_surf,
+        )
+
+        # We look to see if colors in search_surf are in surf.
+        num_threshold_pixels = pygame.transform.threshold(
+            dest_surface=dest_surf,
+            surface=surf,
+            search_color=None,
+            set_color=None,
+            set_behavior=THRESHOLD_BEHAVIOR_FROM_SEARCH_SURF,
+            search_surf=search_surf,
+        )
+
+        num_pixels_within = 2
+        self.assertEqual(num_threshold_pixels, num_pixels_within)
+
+        dest_surf.fill(original_color)
+        num_threshold_pixels = pygame.transform.threshold(
+            dest_surf,
+            surf,
+            search_color=None,
+            set_color=None,
+            set_behavior=THRESHOLD_BEHAVIOR_FROM_SEARCH_SURF,
+            search_surf=search_surf,
+            inverse_set=True,
+        )
+
+        self.assertEqual(num_threshold_pixels, 2)
+
+    def test_threshold_inverse_set(self):
+        """changes the pixels within the threshold, and not outside."""
+        surf_size = (32, 32)
+        _dest_surf = pygame.Surface(surf_size, pygame.SRCALPHA, 32)
+        _surf = pygame.Surface(surf_size, pygame.SRCALPHA, 32)
+
+        dest_surf = _dest_surf  # surface we are changing.
+        surf = _surf  # surface we are looking at
+        search_color = (55, 55, 55, 255)  # color we are searching for.
+        threshold = (0, 0, 0, 0)  # within this distance from search_color.
+        set_color = (245, 245, 245, 255)  # color we set.
+        inverse_set = 1  # pixels within threshold are changed to 'set_color'
+
+        original_color = (10, 10, 10, 255)
+        surf.fill(original_color)
+        # set 2 pixels to the color we are searching for.
+        surf.set_at((0, 0), search_color)
+        surf.set_at((12, 5), search_color)
+
+        dest_surf.fill(original_color)
+        # set 2 pixels to the color we are searching for.
+        dest_surf.set_at((0, 0), search_color)
+        dest_surf.set_at((12, 5), search_color)
+
+        THRESHOLD_BEHAVIOR_FROM_SEARCH_COLOR = 1
+        num_threshold_pixels = pygame.transform.threshold(
+            dest_surf,
+            surf,
+            search_color=search_color,
+            threshold=threshold,
+            set_color=set_color,
+            set_behavior=THRESHOLD_BEHAVIOR_FROM_SEARCH_COLOR,
+            inverse_set=1,
+        )
+
+        self.assertEqual(num_threshold_pixels, 2)
+        # only two pixels changed to diff_color.
+        self.assertEqual(dest_surf.get_at((0, 0)), set_color)
+        self.assertEqual(dest_surf.get_at((12, 5)), set_color)
+
+        # other pixels should be the same as they were before.
+        # We just check one other pixel, not all of them.
+        self.assertEqual(dest_surf.get_at((2, 2)), original_color)
+
+    # XXX
+    def test_threshold_non_src_alpha(self):
+        result = pygame.Surface((10, 10))
+        s1 = pygame.Surface((10, 10))
+        s2 = pygame.Surface((10, 10))
+        s3 = pygame.Surface((10, 10))
+        s4 = pygame.Surface((10, 10))
+
+        x = s1.fill((0, 0, 0))
+        s1.set_at((0, 0), (32, 20, 0))
+
+        x = s2.fill((0, 20, 0))
+        x = s3.fill((0, 0, 0))
+        x = s4.fill((0, 0, 0))
+        s2.set_at((0, 0), (33, 21, 0))
+        s2.set_at((3, 0), (63, 61, 0))
+        s3.set_at((0, 0), (112, 31, 0))
+        s4.set_at((0, 0), (11, 31, 0))
+        s4.set_at((1, 1), (12, 31, 0))
+
+        self.assertEqual(s1.get_at((0, 0)), (32, 20, 0, 255))
+        self.assertEqual(s2.get_at((0, 0)), (33, 21, 0, 255))
+        self.assertEqual((0, 0), (s1.get_flags(), s2.get_flags()))
+
+        similar_color = (255, 255, 255, 255)
+        diff_color = (222, 0, 0, 255)
+        threshold_color = (20, 20, 20, 255)
+
+        THRESHOLD_BEHAVIOR_FROM_SEARCH_COLOR = 1
+        num_threshold_pixels = pygame.transform.threshold(
+            dest_surface=result,
+            surface=s1,
+            search_color=similar_color,
+            threshold=threshold_color,
+            set_color=diff_color,
+            set_behavior=THRESHOLD_BEHAVIOR_FROM_SEARCH_COLOR,
+        )
+        self.assertEqual(num_threshold_pixels, 0)
+
+        num_threshold_pixels = pygame.transform.threshold(
+            dest_surface=result,
+            surface=s1,
+            search_color=(40, 40, 0),
+            threshold=threshold_color,
+            set_color=diff_color,
+            set_behavior=THRESHOLD_BEHAVIOR_FROM_SEARCH_COLOR,
+        )
+        self.assertEqual(num_threshold_pixels, 1)
+
+        self.assertEqual(result.get_at((0, 0)), diff_color)
+
+    def test_threshold__uneven_colors(self):
+        (w, h) = size = (16, 16)
+
+        original_surface = pygame.Surface(size, pygame.SRCALPHA, 32)
+        dest_surface = pygame.Surface(size, pygame.SRCALPHA, 32)
+
+        original_surface.fill(0)
+
+        threshold_color_template = [5, 5, 5, 5]
+        threshold_template = [6, 6, 6, 6]
+
+        ################################################################
+
+        for pos in range(len("rgb")):
+            threshold_color = threshold_color_template[:]
+            threshold = threshold_template[:]
+
+            threshold_color[pos] = 45
+            threshold[pos] = 50
+
+            pixels_within_threshold = pygame.transform.threshold(
+                None,
+                original_surface,
+                threshold_color,
+                threshold,
+                set_color=None,
+                set_behavior=0,
+            )
+
+            self.assertEqual(w * h, pixels_within_threshold)
+
+        ################################################################
+
+    def test_threshold_set_behavior2(self):
+        """raises an error when set_behavior=2 and set_color is not None."""
+        from pygame.transform import threshold
+
+        s1 = pygame.Surface((32, 32), SRCALPHA, 32)
+        s2 = pygame.Surface((32, 32), SRCALPHA, 32)
+        THRESHOLD_BEHAVIOR_FROM_SEARCH_SURF = 2
+        self.assertRaises(
+            TypeError,
+            threshold,
+            dest_surface=s2,
+            surface=s1,
+            search_color=(30, 30, 30),
+            threshold=(11, 11, 11),
+            set_color=(255, 0, 0),
+            set_behavior=THRESHOLD_BEHAVIOR_FROM_SEARCH_SURF,
+        )
+
+    def test_threshold_set_behavior0(self):
+        """raises an error when set_behavior=1
+        and set_color is not None,
+        and dest_surf is not None.
+        """
+        from pygame.transform import threshold
+
+        s1 = pygame.Surface((32, 32), SRCALPHA, 32)
+        s2 = pygame.Surface((32, 32), SRCALPHA, 32)
+        THRESHOLD_BEHAVIOR_COUNT = 0
+
+        self.assertRaises(
+            TypeError,
+            threshold,
+            dest_surface=None,
+            surface=s2,
+            search_color=(30, 30, 30),
+            threshold=(11, 11, 11),
+            set_color=(0, 0, 0),
+            set_behavior=THRESHOLD_BEHAVIOR_COUNT,
+        )
+
+        self.assertRaises(
+            TypeError,
+            threshold,
+            dest_surface=s1,
+            surface=s2,
+            search_color=(30, 30, 30),
+            threshold=(11, 11, 11),
+            set_color=None,
+            set_behavior=THRESHOLD_BEHAVIOR_COUNT,
+        )
+
+        threshold(
+            dest_surface=None,
+            surface=s2,
+            search_color=(30, 30, 30),
+            threshold=(11, 11, 11),
+            set_color=None,
+            set_behavior=THRESHOLD_BEHAVIOR_COUNT,
+        )
+
+    def test_threshold_from_surface(self):
+        """Set similar pixels in 'dest_surf' to color in the 'surf'."""
+        from pygame.transform import threshold
+
+        surf = pygame.Surface((32, 32), SRCALPHA, 32)
+        dest_surf = pygame.Surface((32, 32), SRCALPHA, 32)
+        surf_color = (40, 40, 40, 255)
+        dest_color = (255, 255, 255)
+        surf.fill(surf_color)
+        dest_surf.fill(dest_color)
+        THRESHOLD_BEHAVIOR_FROM_SEARCH_SURF = 2
+
+        num_threshold_pixels = threshold(
+            dest_surface=dest_surf,
+            surface=surf,
+            search_color=(30, 30, 30),
+            threshold=(11, 11, 11),
+            set_color=None,
+            set_behavior=THRESHOLD_BEHAVIOR_FROM_SEARCH_SURF,
+            inverse_set=1,
+        )
+
+        self.assertEqual(
+            num_threshold_pixels, dest_surf.get_height() * dest_surf.get_width()
+        )
+        self.assertEqual(dest_surf.get_at((0, 0)), surf_color)
+
+    def test_threshold__surface(self):
+        """ """
+        from pygame.transform import threshold
+
+        s1 = pygame.Surface((32, 32), SRCALPHA, 32)
+        s2 = pygame.Surface((32, 32), SRCALPHA, 32)
+        s3 = pygame.Surface((1, 1), SRCALPHA, 32)
+        THRESHOLD_BEHAVIOR_FROM_SEARCH_SURF = 2
+
+        #     # only one pixel should not be changed.
+        #     s1.fill((40,40,40))
+        #     s2.fill((255,255,255))
+        #     s1.set_at( (0,0), (170, 170, 170) )
+        #     # set the similar pixels in destination surface to the color
+        #     #     in the first surface.
+        #     num_threshold_pixels = threshold(
+        #         dest_surface=s2,
+        #         surface=s1,
+        #         search_color=(30,30,30),
+        #         threshold=(11,11,11),
+        #         set_color=None,
+        #         set_behavior=THRESHOLD_BEHAVIOR_FROM_SEARCH_SURF)
+
+        #     #num_threshold_pixels = threshold(s2, s1, (30,30,30))
+        #     self.assertEqual(num_threshold_pixels, (s1.get_height() * s1.get_width()) -1)
+        #     self.assertEqual(s2.get_at((0,0)), (0,0,0, 255))
+        #     self.assertEqual(s2.get_at((0,1)), (40, 40, 40, 255))
+        #     self.assertEqual(s2.get_at((17,1)), (40, 40, 40, 255))
+
+        # # abs(40 - 255) < 100
+        # #(abs(c1[0] - r) < tr)
+
+        #     s1.fill((160,160,160))
+        #     s2.fill((255,255,255))
+        #     num_threshold_pixels = threshold(s2, s1, (255,255,255), (100,100,100), (0,0,0), True)
+
+        #     self.assertEqual(num_threshold_pixels, (s1.get_height() * s1.get_width()))
+
+        # only one pixel should not be changed.
+        s1.fill((40, 40, 40))
+        s1.set_at((0, 0), (170, 170, 170))
+        THRESHOLD_BEHAVIOR_COUNT = 0
+
+        num_threshold_pixels = threshold(
+            dest_surface=None,
+            surface=s1,
+            search_color=(30, 30, 30),
+            threshold=(11, 11, 11),
+            set_color=None,
+            set_behavior=THRESHOLD_BEHAVIOR_COUNT,
+        )
+
+        # num_threshold_pixels = threshold(s2, s1, (30,30,30))
+        self.assertEqual(num_threshold_pixels, (s1.get_height() * s1.get_width()) - 1)
+
+        # test end markers.  0, and 255
+
+        # the pixels are different by 1.
+        s1.fill((254, 254, 254))
+        s2.fill((255, 255, 255))
+        s3.fill((255, 255, 255))
+        s1.set_at((0, 0), (170, 170, 170))
+        num_threshold_pixels = threshold(
+            None, s1, (254, 254, 254), (1, 1, 1), None, THRESHOLD_BEHAVIOR_COUNT
+        )
+        self.assertEqual(num_threshold_pixels, (s1.get_height() * s1.get_width()) - 1)
+
+        # compare the two surfaces.  Should be all but one matching.
+        num_threshold_pixels = threshold(
+            None, s1, None, (1, 1, 1), None, THRESHOLD_BEHAVIOR_COUNT, s2
+        )
+        self.assertEqual(num_threshold_pixels, (s1.get_height() * s1.get_width()) - 1)
+
+        # within (0,0,0) threshold?  Should match no pixels.
+        num_threshold_pixels = threshold(
+            None, s1, (253, 253, 253), (0, 0, 0), None, THRESHOLD_BEHAVIOR_COUNT
+        )
+        self.assertEqual(num_threshold_pixels, 0)
+
+        # other surface within (0,0,0) threshold?  Should match no pixels.
+        num_threshold_pixels = threshold(
+            None, s1, None, (0, 0, 0), None, THRESHOLD_BEHAVIOR_COUNT, s2
+        )
+        self.assertEqual(num_threshold_pixels, 0)
+
+    def test_threshold__subclassed_surface(self):
+        """Ensure threshold accepts subclassed surfaces."""
+        expected_size = (13, 11)
+        expected_flags = 0
+        expected_depth = 32
+        expected_color = (90, 80, 70, 255)
+        expected_count = 0
+        surface = test_utils.SurfaceSubclass(
+            expected_size, expected_flags, expected_depth
+        )
+        dest_surface = test_utils.SurfaceSubclass(
+            expected_size, expected_flags, expected_depth
+        )
+        search_surface = test_utils.SurfaceSubclass(
+            expected_size, expected_flags, expected_depth
+        )
+        surface.fill((10, 10, 10))
+        dest_surface.fill((255, 255, 255))
+        search_surface.fill((20, 20, 20))
+
+        count = pygame.transform.threshold(
+            dest_surface=dest_surface,
+            surface=surface,
+            threshold=(1, 1, 1),
+            set_color=expected_color,
+            search_color=None,
+            search_surf=search_surface,
+        )
+
+        self.assertIsInstance(dest_surface, pygame.Surface)
+        self.assertIsInstance(dest_surface, test_utils.SurfaceSubclass)
+        self.assertEqual(count, expected_count)
+        self.assertEqual(dest_surface.get_at((0, 0)), expected_color)
+        self.assertEqual(dest_surface.get_bitsize(), expected_depth)
+        self.assertEqual(dest_surface.get_size(), expected_size)
+        self.assertEqual(dest_surface.get_flags(), expected_flags)
+
+    def test_laplacian(self):
+        """ """
+
+        SIZE = 32
+        s1 = pygame.Surface((SIZE, SIZE))
+        s2 = pygame.Surface((SIZE, SIZE))
+        s1.fill((10, 10, 70))
+        pygame.draw.line(s1, (255, 0, 0), (3, 10), (20, 20))
+
+        # a line at the last row of the image.
+        pygame.draw.line(s1, (255, 0, 0), (0, 31), (31, 31))
+
+        pygame.transform.laplacian(s1, s2)
+
+        # show_image(s1)
+        # show_image(s2)
+
+        self.assertEqual(s2.get_at((0, 0)), (0, 0, 0, 255))
+        self.assertEqual(s2.get_at((3, 10)), (255, 0, 0, 255))
+        self.assertEqual(s2.get_at((0, 31)), (255, 0, 0, 255))
+        self.assertEqual(s2.get_at((31, 31)), (255, 0, 0, 255))
+
+        # here we create the return surface.
+        s2 = pygame.transform.laplacian(s1)
+
+        self.assertEqual(s2.get_at((0, 0)), (0, 0, 0, 255))
+        self.assertEqual(s2.get_at((3, 10)), (255, 0, 0, 255))
+        self.assertEqual(s2.get_at((0, 31)), (255, 0, 0, 255))
+        self.assertEqual(s2.get_at((31, 31)), (255, 0, 0, 255))
+
+    def test_laplacian__24_big_endian(self):
+        """ """
+        pygame.display.init()
+        try:
+            surf_1 = pygame.image.load(
+                example_path(os.path.join("data", "laplacian.png"))
+            )
+            SIZE = 32
+            surf_2 = pygame.Surface((SIZE, SIZE), 0, 24)
+            # s1.fill((10, 10, 70))
+            # pygame.draw.line(s1, (255, 0, 0), (3, 10), (20, 20))
+
+            # a line at the last row of the image.
+            # pygame.draw.line(s1, (255, 0, 0), (0, 31), (31, 31))
+
+            # Also validate keyword arguments
+            pygame.transform.laplacian(surface=surf_1, dest_surface=surf_2)
+
+            # show_image(s1)
+            # show_image(s2)
+
+            self.assertEqual(surf_2.get_at((0, 0)), (0, 0, 0, 255))
+            self.assertEqual(surf_2.get_at((3, 10)), (255, 0, 0, 255))
+            self.assertEqual(surf_2.get_at((0, 31)), (255, 0, 0, 255))
+            self.assertEqual(surf_2.get_at((31, 31)), (255, 0, 0, 255))
+
+            # here we create the return surface.
+            surf_2 = pygame.transform.laplacian(surf_1)
+
+            self.assertEqual(surf_2.get_at((0, 0)), (0, 0, 0, 255))
+            self.assertEqual(surf_2.get_at((3, 10)), (255, 0, 0, 255))
+            self.assertEqual(surf_2.get_at((0, 31)), (255, 0, 0, 255))
+            self.assertEqual(surf_2.get_at((31, 31)), (255, 0, 0, 255))
+        finally:
+            pygame.display.quit()
+
+    def test_average_surfaces(self):
+        """ """
+
+        SIZE = 32
+        s1 = pygame.Surface((SIZE, SIZE))
+        s2 = pygame.Surface((SIZE, SIZE))
+        s3 = pygame.Surface((SIZE, SIZE))
+        s1.fill((10, 10, 70))
+        s2.fill((10, 20, 70))
+        s3.fill((10, 130, 10))
+
+        surfaces = [s1, s2, s3]
+        surfaces = [s1, s2]
+        sr = pygame.transform.average_surfaces(surfaces)
+
+        self.assertEqual(sr.get_at((0, 0)), (10, 15, 70, 255))
+
+        self.assertRaises(TypeError, pygame.transform.average_surfaces, 1)
+        self.assertRaises(TypeError, pygame.transform.average_surfaces, [])
+
+        self.assertRaises(TypeError, pygame.transform.average_surfaces, [1])
+        self.assertRaises(TypeError, pygame.transform.average_surfaces, [s1, 1])
+        self.assertRaises(TypeError, pygame.transform.average_surfaces, [1, s1])
+        self.assertRaises(TypeError, pygame.transform.average_surfaces, [s1, s2, 1])
+
+        self.assertRaises(
+            TypeError, pygame.transform.average_surfaces, (s for s in [s1, s2, s3])
+        )
+
+    def test_average_surfaces__24(self):
+        SIZE = 32
+        depth = 24
+        s1 = pygame.Surface((SIZE, SIZE), 0, depth)
+        s2 = pygame.Surface((SIZE, SIZE), 0, depth)
+        s3 = pygame.Surface((SIZE, SIZE), 0, depth)
+        s1.fill((10, 10, 70, 255))
+        s2.fill((10, 20, 70, 255))
+        s3.fill((10, 130, 10, 255))
+
+        surfaces = [s1, s2, s3]
+        sr = pygame.transform.average_surfaces(surfaces)
+        self.assertEqual(sr.get_masks(), s1.get_masks())
+        self.assertEqual(sr.get_flags(), s1.get_flags())
+        self.assertEqual(sr.get_losses(), s1.get_losses())
+
+        if 0:
+            print(sr, s1)
+            print(sr.get_masks(), s1.get_masks())
+            print(sr.get_flags(), s1.get_flags())
+            print(sr.get_losses(), s1.get_losses())
+            print(sr.get_shifts(), s1.get_shifts())
+
+        self.assertEqual(sr.get_at((0, 0)), (10, 53, 50, 255))
+
+    def test_average_surfaces__24_big_endian(self):
+        pygame.display.init()
+        try:
+            surf_1 = pygame.image.load(example_path(os.path.join("data", "BGR.png")))
+
+            surf_2 = surf_1.copy()
+
+            surfaces = [surf_1, surf_2]
+            self.assertEqual(surf_1.get_at((0, 0)), (255, 0, 0, 255))
+            self.assertEqual(surf_2.get_at((0, 0)), (255, 0, 0, 255))
+
+            surf_av = pygame.transform.average_surfaces(surfaces)
+            self.assertEqual(surf_av.get_masks(), surf_1.get_masks())
+            self.assertEqual(surf_av.get_flags(), surf_1.get_flags())
+            self.assertEqual(surf_av.get_losses(), surf_1.get_losses())
+
+            self.assertEqual(surf_av.get_at((0, 0)), (255, 0, 0, 255))
+        finally:
+            pygame.display.quit()
+
+    def test_average_surfaces__subclassed_surfaces(self):
+        """Ensure average_surfaces accepts subclassed surfaces."""
+        expected_size = (23, 17)
+        expected_flags = 0
+        expected_depth = 32
+        expected_color = (50, 50, 50, 255)
+        surfaces = []
+
+        for color in ((40, 60, 40), (60, 40, 60)):
+            s = test_utils.SurfaceSubclass(
+                expected_size, expected_flags, expected_depth
+            )
+            s.fill(color)
+            surfaces.append(s)
+
+        surface = pygame.transform.average_surfaces(surfaces)
+
+        self.assertIsInstance(surface, pygame.Surface)
+        self.assertNotIsInstance(surface, test_utils.SurfaceSubclass)
+        self.assertEqual(surface.get_at((0, 0)), expected_color)
+        self.assertEqual(surface.get_bitsize(), expected_depth)
+        self.assertEqual(surface.get_size(), expected_size)
+        self.assertEqual(surface.get_flags(), expected_flags)
+
+    def test_average_surfaces__subclassed_destination_surface(self):
+        """Ensure average_surfaces accepts a destination subclassed surface."""
+        expected_size = (13, 27)
+        expected_flags = 0
+        expected_depth = 32
+        expected_color = (15, 15, 15, 255)
+        surfaces = []
+
+        for color in ((10, 10, 20), (20, 20, 10), (30, 30, 30)):
+            s = test_utils.SurfaceSubclass(
+                expected_size, expected_flags, expected_depth
+            )
+            s.fill(color)
+            surfaces.append(s)
+        expected_dest_surface = surfaces.pop()
+
+        # Also validate keyword arguments
+        dest_surface = pygame.transform.average_surfaces(
+            surfaces=surfaces, dest_surface=expected_dest_surface
+        )
+
+        self.assertIsInstance(dest_surface, pygame.Surface)
+        self.assertIsInstance(dest_surface, test_utils.SurfaceSubclass)
+        self.assertIs(dest_surface, expected_dest_surface)
+        self.assertEqual(dest_surface.get_at((0, 0)), expected_color)
+        self.assertEqual(dest_surface.get_bitsize(), expected_depth)
+        self.assertEqual(dest_surface.get_size(), expected_size)
+        self.assertEqual(dest_surface.get_flags(), expected_flags)
+
+    def test_average_color(self):
+        """ """
+        for i in (24, 32):
+            with self.subTest(f"Testing {i}-bit surface"):
+                s = pygame.Surface((32, 32), 0, i)
+                s.fill((0, 100, 200))
+                s.fill((10, 50, 100), (0, 0, 16, 32))
+
+                self.assertEqual(pygame.transform.average_color(s), (5, 75, 150, 0))
+
+                # Also validate keyword arguments
+                avg_color = pygame.transform.average_color(
+                    surface=s, rect=(16, 0, 16, 32)
+                )
+                self.assertEqual(avg_color, (0, 100, 200, 0))
+
+    def test_average_color_considering_alpha_all_pixels_opaque(self):
+        """ """
+        s = pygame.Surface((32, 32), pygame.SRCALPHA, 32)
+        s.fill((0, 100, 200, 255))
+        s.fill((10, 50, 100, 255), (0, 0, 16, 32))
+
+        self.assertEqual(
+            pygame.transform.average_color(s, consider_alpha=True), (5, 75, 150, 255)
+        )
+
+        # Also validate keyword arguments
+        avg_color = pygame.transform.average_color(
+            surface=s, rect=(16, 0, 16, 32), consider_alpha=True
+        )
+        self.assertEqual(avg_color, (0, 100, 200, 255))
+
+    def test_average_color_considering_alpha(self):
+        """ """
+        s = pygame.Surface((32, 32), pygame.SRCALPHA, 32)
+        s.fill((0, 100, 200, 255))
+        s.fill((10, 50, 100, 128), (0, 0, 16, 32))
+
+        # formula for this example of half filled square
+        # n = number of pixels, e.g. 32 * 32
+        # rgb = (n/2 * ( a_left * rgb_left) + n/2 (a_right * rgb_right) ) / (n/2 * a_left + n/2 * a_right)
+        # a = (n/2 * a_left + n/2 * a_right) / n
+        self.assertEqual(
+            pygame.transform.average_color(s, consider_alpha=True), (3, 83, 166, 191)
+        )
+
+        # Also validate keyword arguments
+        avg_color = pygame.transform.average_color(
+            surface=s, rect=(0, 0, 16, 32), consider_alpha=True
+        )
+        self.assertEqual(avg_color, (10, 50, 100, 128))
+
+    def test_rotate(self):
+        # setting colors and canvas
+        blue = (0, 0, 255, 255)
+        red = (255, 0, 0, 255)
+        black = (0, 0, 0)
+        canvas = pygame.Surface((3, 3))
+        rotation = 0
+
+        canvas.set_at((2, 0), blue)
+        canvas.set_at((0, 2), red)
+
+        self.assertEqual(canvas.get_at((0, 0)), black)
+        self.assertEqual(canvas.get_at((2, 0)), blue)
+        self.assertEqual(canvas.get_at((0, 2)), red)
+
+        for i in range(0, 4):
+            if i % 2 == 0:
+                self.assertEqual(canvas.get_at((0, 0)), black)
+            elif i == 1:
+                self.assertEqual(canvas.get_at((0, 0)), blue)
+            elif i == 3:
+                self.assertEqual(canvas.get_at((0, 0)), red)
+
+            rotation += 90
+            # Also validate keyword arguments
+            canvas = pygame.transform.rotate(surface=canvas, angle=90)
+
+        self.assertEqual(canvas.get_at((0, 0)), black)
+
+    def test_rotate_of_0_sized_surface(self):
+        # This function just tests possible Segmentation Fault
+        canvas1 = pygame.Surface((0, 1))
+        canvas2 = pygame.Surface((1, 0))
+        pygame.transform.rotate(canvas1, 42)
+        pygame.transform.rotate(canvas2, 42)
+
+    def test_rotate__lossless_at_90_degrees(self):
+        w, h = 32, 32
+        s = pygame.Surface((w, h), pygame.SRCALPHA)
+
+        gradient = list(test_utils.gradient(w, h))
+
+        for pt, color in gradient:
+            s.set_at(pt, color)
+
+        for rotation in (90, -90):
+            s = pygame.transform.rotate(s, rotation)
+
+        for pt, color in gradient:
+            self.assertTrue(s.get_at(pt) == color)
+
+    def test_scale2x(self):
+        # __doc__ (as of 2008-06-25) for pygame.transform.scale2x:
+
+        # pygame.transform.scale2x(Surface, DestSurface = None): Surface
+        # specialized image doubler
+
+        w, h = 32, 32
+        s = pygame.Surface((w, h), pygame.SRCALPHA, 32)
+
+        # s.set_at((0,0), (20, 20, 20, 255))
+
+        s1 = pygame.transform.scale2x(s)
+        # Also validate keyword arguments
+        s2 = pygame.transform.scale2x(surface=s)
+        self.assertEqual(s1.get_rect().size, (64, 64))
+        self.assertEqual(s2.get_rect().size, (64, 64))
+
+    def test_scale2xraw(self):
+        w, h = 32, 32
+        s = pygame.Surface((w, h), pygame.SRCALPHA, 32)
+        s.fill((0, 0, 0))
+        pygame.draw.circle(s, (255, 0, 0), (w // 2, h // 2), (w // 3))
+
+        s2 = pygame.transform.scale(s, (w * 2, h * 2))
+        s2_2 = pygame.transform.scale(s2, (w * 4, h * 4))
+        s4 = pygame.transform.scale(s, (w * 4, h * 4))
+
+        self.assertEqual(s2_2.get_rect().size, (128, 128))
+
+        for pt in test_utils.rect_area_pts(s2_2.get_rect()):
+            self.assertEqual(s2_2.get_at(pt), s4.get_at(pt))
+
+    def test_get_smoothscale_backend(self):
+        filter_type = pygame.transform.get_smoothscale_backend()
+        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'.
+
+    def test_set_smoothscale_backend(self):
+        # All machines should allow 'GENERIC'.
+        original_type = pygame.transform.get_smoothscale_backend()
+        pygame.transform.set_smoothscale_backend("GENERIC")
+        filter_type = pygame.transform.get_smoothscale_backend()
+        self.assertEqual(filter_type, "GENERIC")
+        # All machines should allow returning to original value.
+        # Also check that keyword argument works.
+        pygame.transform.set_smoothscale_backend(backend=original_type)
+
+        # Something invalid.
+        def change():
+            pygame.transform.set_smoothscale_backend("mmx")
+
+        self.assertRaises(ValueError, change)
+
+        # Invalid argument keyword.
+        def change():
+            pygame.transform.set_smoothscale_backend(t="GENERIC")
+
+        self.assertRaises(TypeError, change)
+
+        # Invalid argument type.
+        def change():
+            pygame.transform.set_smoothscale_backend(1)
+
+        self.assertRaises(TypeError, change)
+        # Unsupported type, if possible.
+        if original_type != "SSE":
+
+            def change():
+                pygame.transform.set_smoothscale_backend("SSE")
+
+            self.assertRaises(ValueError, change)
+        # Should be back where we started.
+        filter_type = pygame.transform.get_smoothscale_backend()
+        self.assertEqual(filter_type, original_type)
+
+    def test_chop(self):
+        original_surface = pygame.Surface((20, 20))
+        pygame.draw.rect(original_surface, (255, 0, 0), (0, 0, 10, 10))
+        pygame.draw.rect(original_surface, (0, 255, 0), (0, 10, 10, 10))
+        pygame.draw.rect(original_surface, (0, 0, 255), (10, 0, 10, 10))
+        pygame.draw.rect(original_surface, (255, 255, 0), (10, 10, 10, 10))
+        # Test chopping the corner of image
+        rect = pygame.Rect(0, 0, 5, 15)
+        test_surface = pygame.transform.chop(original_surface, rect)
+        # Check the size of chopped image
+        self.assertEqual(test_surface.get_size(), (15, 5))
+        # Check if the colors of the chopped image are correct
+        for x in range(15):
+            for y in range(5):
+                if x < 5:
+                    self.assertEqual(test_surface.get_at((x, y)), (0, 255, 0))
+                else:
+                    self.assertEqual(test_surface.get_at((x, y)), (255, 255, 0))
+        # Check if the original image stayed the same
+        self.assertEqual(original_surface.get_size(), (20, 20))
+        for x in range(20):
+            for y in range(20):
+                if x < 10 and y < 10:
+                    self.assertEqual(original_surface.get_at((x, y)), (255, 0, 0))
+                if x < 10 < y:
+                    self.assertEqual(original_surface.get_at((x, y)), (0, 255, 0))
+                if x > 10 > y:
+                    self.assertEqual(original_surface.get_at((x, y)), (0, 0, 255))
+                if x > 10 and y > 10:
+                    self.assertEqual(original_surface.get_at((x, y)), (255, 255, 0))
+        # Test chopping the center of the surface:
+        rect = pygame.Rect(0, 0, 10, 10)
+        rect.center = original_surface.get_rect().center
+        # Also validate keyword arguments
+        test_surface = pygame.transform.chop(surface=original_surface, rect=rect)
+        self.assertEqual(test_surface.get_size(), (10, 10))
+        for x in range(10):
+            for y in range(10):
+                if x < 5 and y < 5:
+                    self.assertEqual(test_surface.get_at((x, y)), (255, 0, 0))
+                if x < 5 < y:
+                    self.assertEqual(test_surface.get_at((x, y)), (0, 255, 0))
+                if x > 5 > y:
+                    self.assertEqual(test_surface.get_at((x, y)), (0, 0, 255))
+                if x > 5 and y > 5:
+                    self.assertEqual(test_surface.get_at((x, y)), (255, 255, 0))
+        # Test chopping with the empty rect
+        rect = pygame.Rect(10, 10, 0, 0)
+        test_surface = pygame.transform.chop(original_surface, rect)
+        self.assertEqual(test_surface.get_size(), (20, 20))
+        # Test chopping the entire surface
+        rect = pygame.Rect(0, 0, 20, 20)
+        test_surface = pygame.transform.chop(original_surface, rect)
+        self.assertEqual(test_surface.get_size(), (0, 0))
+        # Test chopping outside of surface
+        rect = pygame.Rect(5, 15, 20, 20)
+        test_surface = pygame.transform.chop(original_surface, rect)
+        self.assertEqual(test_surface.get_size(), (5, 15))
+        rect = pygame.Rect(400, 400, 10, 10)
+        test_surface = pygame.transform.chop(original_surface, rect)
+        self.assertEqual(test_surface.get_size(), (20, 20))
+
+    def test_rotozoom(self):
+        # __doc__ (as of 2008-08-02) for pygame.transform.rotozoom:
+
+        # pygame.transform.rotozoom(Surface, angle, scale): return 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.
+
+        s = pygame.Surface((10, 0))
+        pygame.transform.scale(s, (10, 2))
+        s1 = pygame.transform.rotozoom(s, 30, 1)
+        # Also validate keyword arguments
+        s2 = pygame.transform.rotozoom(surface=s, angle=30, scale=1)
+
+        self.assertEqual(s1.get_rect(), pygame.Rect(0, 0, 0, 0))
+        self.assertEqual(s2.get_rect(), pygame.Rect(0, 0, 0, 0))
+
+    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:
+
+        # pygame.transform.smoothscale(Surface, (width, height), DestSurface =
+        # None): return 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.  For expansion, a bilinear
+        # filter is used. For the amd64 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
+
+        # check stated exceptions
+        def smoothscale_low_bpp():
+            starting_surface = pygame.Surface((20, 20), depth=12)
+            smoothscaled_surface = pygame.transform.smoothscale(
+                starting_surface, (10, 10)
+            )
+
+        self.assertRaises(ValueError, smoothscale_low_bpp)
+
+        def smoothscale_high_bpp():
+            starting_surface = pygame.Surface((20, 20), depth=48)
+            smoothscaled_surface = pygame.transform.smoothscale(
+                starting_surface, (10, 10)
+            )
+
+        self.assertRaises(ValueError, smoothscale_high_bpp)
+
+        def smoothscale_invalid_scale():
+            starting_surface = pygame.Surface((20, 20), depth=32)
+            smoothscaled_surface = pygame.transform.smoothscale(
+                starting_surface, (-1, -1)
+            )
+
+        self.assertRaises(ValueError, smoothscale_invalid_scale)
+
+        # Test Color Blending Scaling-Up
+        two_pixel_surface = pygame.Surface((2, 1), depth=32)
+        two_pixel_surface.fill(pygame.Color(0, 0, 0), pygame.Rect(0, 0, 1, 1))
+        two_pixel_surface.fill(pygame.Color(255, 255, 255), pygame.Rect(1, 0, 1, 1))
+        for k in [2**x for x in range(5, 8)]:  # Enlarge to targets 32, 64...256
+            bigger_surface = pygame.transform.smoothscale(two_pixel_surface, (k, 1))
+            self.assertEqual(
+                bigger_surface.get_at((k // 2, 0)), pygame.Color(127, 127, 127)
+            )
+            self.assertEqual(bigger_surface.get_size(), (k, 1))
+        # Test Color Blending Scaling-Down
+        two_five_six_surf = pygame.Surface((256, 1), depth=32)
+        two_five_six_surf.fill(pygame.Color(0, 0, 0), pygame.Rect(0, 0, 128, 1))
+        two_five_six_surf.fill(pygame.Color(255, 255, 255), pygame.Rect(128, 0, 128, 1))
+        for k in range(3, 11, 2):  # Shrink to targets 3, 5...11 pixels wide
+            smaller_surface = pygame.transform.smoothscale(two_five_six_surf, (k, 1))
+            self.assertEqual(
+                smaller_surface.get_at(((k // 2), 0)), pygame.Color(127, 127, 127)
+            )
+            self.assertEqual(smaller_surface.get_size(), (k, 1))
+
+
+class TransformDisplayModuleTest(unittest.TestCase):
+    def setUp(self):
+        pygame.display.init()
+        pygame.display.set_mode((320, 200))
+
+    def tearDown(self):
+        pygame.display.quit()
+
+    def test_flip(self):
+        """honors the set_color key on the returned surface from flip."""
+        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))
+
+        image_converted = image_loaded.convert()
+
+        self.assertFalse(image.get_flags() & pygame.SRCALPHA)
+        self.assertFalse(image_converted.get_flags() & pygame.SRCALPHA)
+
+        surf = pygame.Surface(image.get_size(), 0, 32)
+        surf2 = pygame.Surface(image.get_size(), 0, 32)
+
+        surf.fill((255, 255, 255))
+        surf2.fill((255, 255, 255))
+
+        colorkey = image.get_at((0, 0))
+        image.set_colorkey(colorkey, RLEACCEL)
+        timage = pygame.transform.flip(image, 1, 0)
+
+        colorkey = image_converted.get_at((0, 0))
+        image_converted.set_colorkey(colorkey, RLEACCEL)
+        # Also validate keyword arguments
+        timage_converted = pygame.transform.flip(
+            surface=image_converted, flip_x=1, flip_y=0
+        )
+
+        # blit the flipped surface, and non flipped surface.
+        surf.blit(timage, (0, 0))
+        surf2.blit(image, (0, 0))
+
+        # the results should be the same.
+        self.assertEqual(surf.get_at((0, 0)), surf2.get_at((0, 0)))
+        self.assertEqual(surf2.get_at((0, 0)), (255, 255, 255, 255))
+
+        # now we test the convert() ed image also works.
+        surf.fill((255, 255, 255))
+        surf2.fill((255, 255, 255))
+        surf.blit(timage_converted, (0, 0))
+        surf2.blit(image_converted, (0, 0))
+        self.assertEqual(surf.get_at((0, 0)), surf2.get_at((0, 0)))
+
+    def test_flip_alpha(self):
+        """returns a surface with the same properties as the input."""
+        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))
+
+        surf = pygame.Surface(image_loaded.get_size(), 0, 32)
+        surf2 = pygame.Surface(image_loaded.get_size(), 0, 32)
+
+        colorkey = image_alpha.get_at((0, 0))
+        image_alpha.set_colorkey(colorkey, RLEACCEL)
+        timage_alpha = pygame.transform.flip(image_alpha, 1, 0)
+
+        self.assertTrue(image_alpha.get_flags() & pygame.SRCALPHA)
+        self.assertTrue(timage_alpha.get_flags() & pygame.SRCALPHA)
+
+        # now we test the alpha image works.
+        surf.fill((255, 255, 255))
+        surf2.fill((255, 255, 255))
+        surf.blit(timage_alpha, (0, 0))
+        surf2.blit(image_alpha, (0, 0))
+        self.assertEqual(surf.get_at((0, 0)), surf2.get_at((0, 0)))
+        self.assertEqual(surf2.get_at((0, 0)), (255, 0, 0, 255))
+
+
+if __name__ == "__main__":
+    unittest.main()
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/version_test.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/version_test.py
new file mode 100644
index 0000000..ba0bb3d
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/version_test.py
@@ -0,0 +1,48 @@
+import os
+import unittest
+
+
+pg_header = os.path.join("src_c", "include", "_pygame.h")
+
+
+class VersionTest(unittest.TestCase):
+    @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):
+        from pygame import version
+
+        self.assertEqual(len(version.SDL), 3)
+
+
+if __name__ == "__main__":
+    unittest.main()
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/video_test.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/video_test.py
new file mode 100644
index 0000000..55ef414
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/tests/video_test.py
@@ -0,0 +1,26 @@
+import unittest
+import sys
+import pygame
+
+from pygame._sdl2 import video
+
+
+class VideoModuleTest(unittest.TestCase):
+    default_caption = "pygame window"
+
+    @unittest.skipIf(
+        not (sys.maxsize > 2**32),
+        "32 bit SDL 2.0.16 has an issue.",
+    )
+    def test_renderer_set_viewport(self):
+        """works."""
+        window = video.Window(title=self.default_caption, size=(800, 600))
+        renderer = video.Renderer(window=window)
+        renderer.logical_size = (1920, 1080)
+        rect = pygame.Rect(0, 0, 1920, 1080)
+        renderer.set_viewport(rect)
+        self.assertEqual(renderer.get_viewport(), (0, 0, 1920, 1080))
+
+
+if __name__ == "__main__":
+    unittest.main()
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/threads/__init__.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/threads/__init__.py
new file mode 100644
index 0000000..dc067f4
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/threads/__init__.py
@@ -0,0 +1,271 @@
+"""
+* Experimental *
+
+Like the map function, but can use a pool of threads.
+
+Really easy to use threads.  eg.  tmap(f, alist)
+
+If you know how to use the map function, you can use threads.
+"""
+
+__author__ = "Rene Dudfield"
+__version__ = "0.3.0"
+__license__ = "Python license"
+
+from queue import Queue, Empty
+import threading
+
+
+Thread = threading.Thread
+
+STOP = object()
+FINISH = object()
+
+# DONE_ONE = object()
+# DONE_TWO = object()
+
+# a default worker queue.
+_wq = None
+
+# if we are using threads or not.  This is the number of workers.
+_use_workers = 0
+
+# Set this to the maximum for the amount of Cores/CPUs
+#    Note, that the tests early out.
+#    So it should only test the best number of workers +2
+MAX_WORKERS_TO_TEST = 64
+
+
+def init(number_of_workers=0):
+    """Does a little test to see if threading is worth it.
+      Sets up a global worker queue if it's worth it.
+
+    Calling init() is not required, but is generally better to do.
+    """
+    global _wq, _use_workers
+
+    if number_of_workers:
+        _use_workers = number_of_workers
+    else:
+        _use_workers = benchmark_workers()
+
+    # if it is best to use zero workers, then use that.
+    _wq = WorkerQueue(_use_workers)
+
+
+def quit():
+    """cleans up everything."""
+    global _wq, _use_workers
+    _wq.stop()
+    _wq = None
+    _use_workers = False
+
+
+def benchmark_workers(a_bench_func=None, the_data=None):
+    """does a little test to see if workers are at all faster.
+    Returns the number of workers which works best.
+    Takes a little bit of time to run, so you should only really call
+      it once.
+    You can pass in benchmark data, and functions if you want.
+    a_bench_func - f(data)
+    the_data - data to work on.
+    """
+    # TODO: try and make this scale better with slower/faster cpus.
+    #  first find some variables so that using 0 workers takes about 1.0 seconds.
+    #  then go from there.
+
+    # note, this will only work with pygame 1.8rc3+
+    # replace the doit() and the_data with something that releases the GIL
+
+    import pygame
+    import pygame.transform
+    import time
+
+    if not a_bench_func:
+
+        def doit(x):
+            return pygame.transform.scale(x, (544, 576))
+
+    else:
+        doit = a_bench_func
+
+    if not the_data:
+        thedata = [pygame.Surface((155, 155), 0, 32) for x in range(10)]
+    else:
+        thedata = the_data
+
+    best = time.time() + 100000000
+    best_number = 0
+    # last_best = -1
+
+    for num_workers in range(0, MAX_WORKERS_TO_TEST):
+        wq = WorkerQueue(num_workers)
+        t1 = time.time()
+        for _ in range(20):
+            print(f"active count:{threading.active_count()}")
+            tmap(doit, thedata, worker_queue=wq)
+        t2 = time.time()
+
+        wq.stop()
+
+        total_time = t2 - t1
+        print(f"total time num_workers:{num_workers}: time:{total_time}:")
+
+        if total_time < best:
+            # last_best = best_number
+            best_number = num_workers
+            best = total_time
+
+        if num_workers - best_number > 1:
+            # We tried to add more, but it didn't like it.
+            #   so we stop with testing at this number.
+            break
+
+    return best_number
+
+
+class WorkerQueue:
+    def __init__(self, num_workers=20):
+        self.queue = Queue()
+        self.pool = []
+        self._setup_workers(num_workers)
+
+    def _setup_workers(self, num_workers):
+        """Sets up the worker threads
+        NOTE: undefined behaviour if you call this again.
+        """
+        self.pool = []
+
+        for _ in range(num_workers):
+            self.pool.append(Thread(target=self.threadloop))
+
+        for a_thread in self.pool:
+            a_thread.setDaemon(True)
+            a_thread.start()
+
+    def do(self, f, *args, **kwArgs):
+        """puts a function on a queue for running later."""
+        self.queue.put((f, args, kwArgs))
+
+    def stop(self):
+        """Stops the WorkerQueue, waits for all of the threads to finish up."""
+        self.queue.put(STOP)
+        for thread in self.pool:
+            thread.join()
+
+    def threadloop(self):  # , finish=False):
+        """Loops until all of the tasks are finished."""
+        while True:
+            args = self.queue.get()
+            if args is STOP:
+                self.queue.put(STOP)
+                self.queue.task_done()
+                break
+            try:
+                args[0](*args[1], **args[2])
+            finally:
+                # clean up the queue, raise the exception.
+                self.queue.task_done()
+                # raise
+
+    def wait(self):
+        """waits until all tasks are complete."""
+        self.queue.join()
+
+
+class FuncResult:
+    """Used for wrapping up a function call so that the results are stored
+    inside the instances result attribute.
+    """
+
+    def __init__(self, f, callback=None, errback=None):
+        """f - is the function we that we call
+        callback(result) - this is called when the function(f) returns
+        errback(exception) - this is called when the function(f) raises
+                               an exception.
+        """
+        self.f = f
+        self.exception = None
+        self.result = None
+        self.callback = callback
+        self.errback = errback
+
+    def __call__(self, *args, **kwargs):
+        # we try to call the function here.  If it fails we store the exception.
+        try:
+            self.result = self.f(*args, **kwargs)
+            if self.callback:
+                self.callback(self.result)
+        except Exception as e:
+            self.exception = e
+            if self.errback:
+                self.errback(self.exception)
+
+
+def tmap(f, seq_args, num_workers=20, worker_queue=None, wait=True, stop_on_error=True):
+    """like map, but uses a thread pool to execute.
+    num_workers - the number of worker threads that will be used.  If pool
+                    is passed in, then the num_workers arg is ignored.
+    worker_queue - you can optionally pass in an existing WorkerQueue.
+    wait - True means that the results are returned when everything is finished.
+           False means that we return the [worker_queue, results] right away instead.
+           results, is returned as a list of FuncResult instances.
+    stop_on_error -
+    """
+
+    if worker_queue:
+        wq = worker_queue
+    else:
+        # see if we have a global queue to work with.
+        if _wq:
+            wq = _wq
+        else:
+            if num_workers == 0:
+                return map(f, seq_args)
+
+            wq = WorkerQueue(num_workers)
+
+    # we short cut it here if the number of workers is 0.
+    # normal map should be faster in this case.
+    if len(wq.pool) == 0:
+        return map(f, seq_args)
+
+    # print("queue size:%s" % wq.queue.qsize())
+
+    # TODO: divide the data (seq_args) into even chunks and
+    #       then pass each thread a map(f, equal_part(seq_args))
+    #      That way there should be less locking, and overhead.
+
+    results = []
+    for sa in seq_args:
+        results.append(FuncResult(f))
+        wq.do(results[-1], sa)
+
+    # wq.stop()
+
+    if wait:
+        # print("wait")
+        wq.wait()
+        # print("after wait")
+        # print("queue size:%s" % wq.queue.qsize())
+        if wq.queue.qsize():
+            raise RuntimeError("buggy threadmap")
+        # if we created a worker queue, we need to stop it.
+        if not worker_queue and not _wq:
+            # print("stopping")
+            wq.stop()
+            if wq.queue.qsize():
+                um = wq.queue.get()
+                if um is not STOP:
+                    raise RuntimeError("buggy threadmap")
+
+        # see if there were any errors.  If so raise the first one.  This matches map behaviour.
+        # TODO: the traceback doesn't show up nicely.
+        # NOTE: TODO: we might want to return the results anyway?  This should be an option.
+        if stop_on_error:
+            error_ones = list(filter(lambda x: x.exception, results))
+            if error_ones:
+                raise error_ones[0].exception
+
+        return (x.result for x in results)
+    return [wq, results]
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/threads/__pycache__/__init__.cpython-312.pyc b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/threads/__pycache__/__init__.cpython-312.pyc
new file mode 100644
index 0000000..0994414
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/threads/__pycache__/__init__.cpython-312.pyc differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/time.cpython-312-darwin.so b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/time.cpython-312-darwin.so
new file mode 100755
index 0000000..af2f049
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/time.cpython-312-darwin.so differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/time.pyi b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/time.pyi
new file mode 100644
index 0000000..6183def
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/time.pyi
@@ -0,0 +1,15 @@
+from typing import Union, final
+
+from pygame.event import Event
+
+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:
+    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/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/transform.cpython-312-darwin.so b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/transform.cpython-312-darwin.so
new file mode 100755
index 0000000..81f0a5e
Binary files /dev/null and b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/transform.cpython-312-darwin.so differ
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/transform.pyi b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/transform.pyi
new file mode 100644
index 0000000..92fd10c
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/transform.pyi
@@ -0,0 +1,58 @@
+from typing import Literal, Optional, Sequence, Union
+
+from pygame.color import Color
+from pygame.surface import Surface
+
+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: Coordinate,
+    dest_surface: Optional[Surface] = None,
+) -> Surface: ...
+def scale_by(
+    surface: 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: Coordinate,
+    dest_surface: Optional[Surface] = None,
+) -> Surface: ...
+def smoothscale_by(
+    surface: Surface,
+    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: Sequence[Surface],
+    dest_surface: Optional[Surface] = None,
+    palette_colors: Union[bool, int] = 1,
+) -> Surface: ...
+def average_color(
+    surface: Surface, rect: Optional[RectValue] = None, consider_alpha: bool = False
+) -> Color: ...
+def threshold(
+    dest_surface: Optional[Surface],
+    surface: Surface,
+    search_color: Optional[ColorValue],
+    threshold: ColorValue = (0, 0, 0, 0),
+    set_color: Optional[ColorValue] = (0, 0, 0, 0),
+    set_behavior: int = 1,
+    search_surf: Optional[Surface] = None,
+    inverse_set: bool = False,
+) -> int: ...
diff --git a/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/version.py b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/version.py
new file mode 100644
index 0000000..7f489da
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/version.py
@@ -0,0 +1,72 @@
+##    pygame - Python Game Library
+##    Copyright (C) 2000-2003  Pete Shinners
+##
+##    This library is free software; you can redistribute it and/or
+##    modify it under the terms of the GNU Library General Public
+##    License as published by the Free Software Foundation; either
+##    version 2 of the License, or (at your option) any later version.
+##
+##    This library is distributed in the hope that it will be useful,
+##    but WITHOUT ANY WARRANTY; without even the implied warranty of
+##    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+##    Library General Public License for more details.
+##
+##    You should have received a copy of the GNU Library General Public
+##    License along with this library; if not, write to the Free
+##    Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
+##
+##    Pete Shinners
+##    pete@shinners.org
+
+"""Simply the current installed pygame version. The version information is
+stored in the regular pygame module as 'pygame.ver'. Keeping the version
+information also available in a separate module allows you to test the
+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
+
+###############
+# This file is generated with version.py.in
+##
+
+class SoftwareVersion(tuple):
+    """
+    A class for storing data about software versions.
+    """
+    __slots__ = ()
+    fields = "major", "minor", "patch"
+
+    def __new__(cls, major, minor, patch):
+        return tuple.__new__(cls, (major, minor, patch))
+
+    def __repr__(self):
+        fields = (f"{fld}={val}" for fld, val in zip(self.fields, self))
+        return f"{str(self.__class__.__name__)}({', '.join(fields)})"
+
+    def __str__(self):
+        return f"{self.major}.{self.minor}.{self.patch}"
+
+    major = property(lambda self: self[0])
+    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 = "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/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/version.pyi b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/version.pyi
new file mode 100644
index 0000000..69a3b6f
--- /dev/null
+++ b/yap_lab_3/.venv/lib/python3.12/site-packages/pygame/version.pyi
@@ -0,0 +1,23 @@
+from typing import Tuple
+
+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: ...
+    @property
+    def major(self) -> int: ...
+    @property
+    def minor(self) -> int: ...
+    @property
+    def patch(self) -> int: ...
+    fields: Tuple[Literal["major"], Literal["minor"], Literal["patch"]]
+
+class PygameVersion(SoftwareVersion): ...
+class SDLVersion(SoftwareVersion): ...
+
+SDL: SDLVersion
+ver: str
+vernum: PygameVersion
+rev: str
diff --git a/yap_lab_3/.venv/pyvenv.cfg b/yap_lab_3/.venv/pyvenv.cfg
new file mode 100644
index 0000000..9cd8200
--- /dev/null
+++ b/yap_lab_3/.venv/pyvenv.cfg
@@ -0,0 +1,5 @@
+home = /Library/Frameworks/Python.framework/Versions/3.12/bin
+include-system-site-packages = false
+version = 3.12.4
+executable = /Library/Frameworks/Python.framework/Versions/3.12/bin/python3.12
+command = /usr/local/bin/python3 -m venv /Users/danilkapnik/yap_lab_3/.venv
diff --git a/yap_lab_3/num1.py b/yap_lab_3/num1.py
new file mode 100644
index 0000000..0e76a75
--- /dev/null
+++ b/yap_lab_3/num1.py
@@ -0,0 +1,72 @@
+import pygame
+from pygame.draw import *
+
+pygame.init()
+
+# Настройки экрана
+WIDTH, HEIGHT = 600, 600
+screen = pygame.display.set_mode((WIDTH, HEIGHT))
+pygame.display.set_caption("Злой Смайлик")
+
+# Цвета
+BLACK = (0, 0, 0)
+YELLOW = (255, 255, 0)
+RED = (255, 0, 0)
+WHITE = (255, 255, 255)
+GRAY = (100, 100, 100)
+
+def draw_angry_smiley():
+    screen.fill(GRAY)
+    
+    # Голова
+    circle(screen, YELLOW, (WIDTH//2, HEIGHT//2), 250)
+    circle(screen, BLACK, (WIDTH//2, HEIGHT//2), 250, 3)
+    
+    # Глаза (сузившиеся от злости)
+    # Левый глаз
+    circle(screen, RED, (WIDTH//2 - 140, HEIGHT//2 - 60), 80)
+    circle(screen, BLACK, (WIDTH//2 - 140, HEIGHT//2 - 60), 40)
+    
+    # Правый глаз
+    circle(screen, RED, (WIDTH//2 + 140, HEIGHT//2 - 60), 80)
+    circle(screen, BLACK, (WIDTH//2 + 140, HEIGHT//2 - 60), 40)
+    
+    # Брови (сведенные к переносице)
+    # Левая бровь
+    polygon(screen, BLACK, [
+        (WIDTH//2 - 200, HEIGHT//2 - 220),
+        (WIDTH//2 - 100, HEIGHT//2 - 150),
+        (WIDTH//2 - 80, HEIGHT//2 - 140),
+        (WIDTH//2 - 100, HEIGHT//2 - 110)
+    ])
+    
+    # Правая бровь
+    polygon(screen, BLACK, [
+        (WIDTH//2 + 200, HEIGHT//2 - 220),
+        (WIDTH//2 + 100, HEIGHT//2 - 150),
+        (WIDTH//2 + 80, HEIGHT//2 - 140),
+        (WIDTH//2 + 100, HEIGHT//2 - 110)
+    ])
+    
+
+    polygon(screen, BLACK, [
+        (WIDTH//2 - 100, HEIGHT//2 + 100),
+        (WIDTH//2 + 100, HEIGHT//2 + 100),
+        (WIDTH//2 + 100, HEIGHT//2 + 130),
+        (WIDTH//2 - 100, HEIGHT//2 + 130)
+    ])
+    
+
+# Основной цикл
+clock = pygame.time.Clock()
+running = True
+while running:
+    for event in pygame.event.get():
+        if event.type == pygame.QUIT:
+            running = False
+    
+    draw_angry_smiley()
+    pygame.display.flip()
+    clock.tick(30)
+
+pygame.quit()
\ No newline at end of file
diff --git a/yap_lab_3/num2.py b/yap_lab_3/num2.py
new file mode 100644
index 0000000..fa094e8
--- /dev/null
+++ b/yap_lab_3/num2.py
@@ -0,0 +1,91 @@
+import pygame
+from pygame.draw import *
+
+pygame.init()
+
+WIDTH, HEIGHT = 600, 600
+screen = pygame.display.set_mode((WIDTH, HEIGHT))
+pygame.display.set_caption("Пейзаж с горами")
+
+BLACK = (0, 0, 0)
+YELLOW = (255, 255, 0)
+RED = (255, 0, 0)
+WHITE = (255, 255, 255)
+GRAY = (100, 100, 100)
+FONE = (255, 222, 173)
+DARKORANGE = (255, 160, 0)
+DARKRED = (139, 0, 0)
+PERPLE = (255, 192, 203)
+ROSYBROWN = (188, 143, 143)
+
+def draw_landscape():
+    screen.fill(FONE)
+
+    polygon(screen, PERPLE, [
+        (0, HEIGHT//2+20),
+        (0, HEIGHT//2-130),
+        (WIDTH, HEIGHT//2-130),
+        (WIDTH, HEIGHT//2+20)
+    ])
+
+    polygon(screen, DARKORANGE, [
+        (0, HEIGHT//2+20),
+        (10, HEIGHT//2 - 20),
+        (140, HEIGHT//2 -50),
+        (200, HEIGHT//2 - 120),
+        (250, HEIGHT//2 - 100),
+        (300, HEIGHT//2 - 70),
+        (320, HEIGHT//2 - 50),
+        (340, HEIGHT//2 - 50),
+        (350, HEIGHT//2 - 15),
+        (370, HEIGHT//2 - 100),
+        (390, HEIGHT//2 - 80),
+        (420, HEIGHT//2 - 95),
+        (450, HEIGHT//2 - 120),
+        (480, HEIGHT//2 - 90),
+        (490, HEIGHT//2 - 70),
+        (510, HEIGHT//2 - 50),
+        (WIDTH, HEIGHT//2-40)
+    ])
+
+    circle(screen, YELLOW, (WIDTH//2, HEIGHT//2 - 130), 30)
+    
+    polygon(screen, DARKRED, [
+        (0, HEIGHT//2 + 150),      
+        (50, HEIGHT//2 + 50),      
+        (100, HEIGHT//2 + 30),     
+        (110, HEIGHT//2 + 10),
+        (190, HEIGHT//2 + 10),
+        (210, HEIGHT//2 + 30),
+        (224, HEIGHT//2 + 40),
+        (280, HEIGHT//2 + 15),
+        (310, HEIGHT//2 + 60),
+        (340, HEIGHT//2 + 120),  
+        (390, HEIGHT//2 + 145),  
+        (450, HEIGHT//2 + 40),      
+        (500, HEIGHT//2 + 60),      
+        (550, HEIGHT//2 + 80),     
+        (WIDTH, HEIGHT//2 + 150)   
+    ])
+
+    circle(screen, DARKRED, (150, HEIGHT//2 + 10), 40)
+
+    polygon(screen, ROSYBROWN, [
+        (0, HEIGHT),
+        (0, HEIGHT-150),
+        (WIDTH, HEIGHT-150),
+        (WIDTH, HEIGHT)
+    ])
+
+clock = pygame.time.Clock()
+running = True
+while running:
+    for event in pygame.event.get():
+        if event.type == pygame.QUIT:
+            running = False
+    
+    draw_landscape()
+    pygame.display.flip()
+    clock.tick(30)
+
+pygame.quit()
\ No newline at end of file
diff --git a/yap_lab_3/num3.py b/yap_lab_3/num3.py
new file mode 100644
index 0000000..b8425d7
--- /dev/null
+++ b/yap_lab_3/num3.py
@@ -0,0 +1,134 @@
+import pygame
+from pygame.draw import *
+
+pygame.init()
+
+WIDTH, HEIGHT = 600, 600
+screen = pygame.display.set_mode((WIDTH, HEIGHT))
+pygame.display.set_caption("Пейзаж с горами")
+
+BLACK = (0, 0, 0)
+YELLOW = (255, 255, 0)
+RED = (255, 0, 0)
+WHITE = (255, 255, 255)
+GRAY = (100, 100, 100)
+FONE = (255, 222, 173)
+DARKORANGE = (255, 160, 0)
+DARKRED = (139, 0, 0)
+PERPLE = (255, 192, 203)
+FIOL = (106, 90, 205)
+ROSYBROWN = (188, 143, 143)
+
+def draw_bird(surface, color, pos, size=1):
+    x, y = pos
+    points1 = [(x, y), (x - 10*size, y - 5*size)]  
+    points2 = [(x - 10*size, y - 5*size), (x - 20*size, y + 5*size)]  
+    pygame.draw.lines(surface, color, False, points1, 2)
+    pygame.draw.lines(surface, color, False, points2, 2)
+
+def draw_landscape():
+    screen.fill(FONE)
+
+    polygon(screen, PERPLE, [
+        (0, HEIGHT//2+20),
+        (0, HEIGHT//2-130),
+        (WIDTH, HEIGHT//2-130),
+        (WIDTH, HEIGHT//2+20)
+    ])
+
+    polygon(screen, DARKORANGE, [
+        (0, HEIGHT//2+20),
+        (10, HEIGHT//2 - 20),
+        (140, HEIGHT//2 -50),
+        (200, HEIGHT//2 - 120),
+        (250, HEIGHT//2 - 100),
+        (300, HEIGHT//2 - 70),
+        (320, HEIGHT//2 - 50),
+        (340, HEIGHT//2 - 50),
+        (350, HEIGHT//2 - 15),
+        (370, HEIGHT//2 - 100),
+        (390, HEIGHT//2 - 80),
+        (420, HEIGHT//2 - 95),
+        (450, HEIGHT//2 - 120),
+        (480, HEIGHT//2 - 90),
+        (490, HEIGHT//2 - 70),
+        (510, HEIGHT//2 - 50),
+        (WIDTH, HEIGHT//2-40)
+    ])
+
+    circle(screen, YELLOW, (WIDTH//2, HEIGHT//2 - 130), 30)
+    
+    draw_bird(screen, BLACK, (WIDTH//2 - 80, HEIGHT//2 - 100))
+    draw_bird(screen, BLACK, (WIDTH//2 - 50, HEIGHT//2 - 120))
+    draw_bird(screen, BLACK, (WIDTH//2 + 30, HEIGHT//2 - 110))
+    draw_bird(screen, BLACK, (WIDTH//2 + 70, HEIGHT//2 - 90))
+    
+    polygon(screen, DARKRED, [
+        (0, HEIGHT//2 + 150),      
+        (50, HEIGHT//2 + 50),      
+        (100, HEIGHT//2 + 30),     
+        (110, HEIGHT//2 + 10),
+        (190, HEIGHT//2 + 10),
+        (210, HEIGHT//2 + 30),
+        (224, HEIGHT//2 + 40),
+        (280, HEIGHT//2 + 15),
+        (310, HEIGHT//2 + 60),
+        (340, HEIGHT//2 + 120),  
+        (390, HEIGHT//2 + 145),  
+        (450, HEIGHT//2 + 40),      
+        (500, HEIGHT//2 + 60),      
+        (550, HEIGHT//2 + 80),     
+        (WIDTH, HEIGHT//2 + 150)   
+    ])
+
+    circle(screen, DARKRED, (150, HEIGHT//2 + 10), 40)
+
+    circle(screen, FIOL, (0, HEIGHT - 300), 40)
+
+    polygon(screen, ROSYBROWN, [
+        (0, HEIGHT),
+        (0, HEIGHT-150),
+        (WIDTH, HEIGHT-150),
+        (WIDTH, HEIGHT)
+    ])
+    
+    draw_bird(screen, BLACK, (50, HEIGHT - 80), 1.5)
+    draw_bird(screen, BLACK, (100, HEIGHT - 100), 1.5)
+    draw_bird(screen, BLACK, (400, HEIGHT - 90), 1.5)
+    draw_bird(screen, BLACK, (450, HEIGHT - 70), 1.5)
+    
+    polygon(screen, FIOL, [
+        (0, HEIGHT),
+        (0, HEIGHT - 300),
+        (40, HEIGHT - 300),
+        (70, HEIGHT - 250),
+        (100, HEIGHT - 220),
+        (134, HEIGHT - 120),
+        (190, HEIGHT - 240),
+        (234, HEIGHT - 170),
+        (250, HEIGHT - 85),
+        (210, HEIGHT)
+    ])
+
+    polygon(screen, FIOL, [
+        (WIDTH - 190, HEIGHT),
+        (WIDTH - 160, HEIGHT - 60),
+        (WIDTH - 130, HEIGHT - 110),
+        (WIDTH - 120, HEIGHT - 300),
+        (WIDTH - 100, HEIGHT - 270),
+        (WIDTH, HEIGHT-212),
+        (WIDTH, HEIGHT)
+    ])
+
+clock = pygame.time.Clock()
+running = True
+while running:
+    for event in pygame.event.get():
+        if event.type == pygame.QUIT:
+            running = False
+    
+    draw_landscape()
+    pygame.display.flip()
+    clock.tick(30)
+
+pygame.quit()